Справочник стандартных плагинов

Полное API официальных плагинов Aurobore: методы, типы, события и коды ошибок.

Онлайн: aurobore-platform.github.io/aurora/plugins/
Обзор и приоритеты: standard-plugins.md. Контракт плагина: plugin-api.md.

Каталог

Плагин	Пакет	Разрешения	Reference
Echo	@aurobore/echo	—	echo.md
Device	@aurobore/device	—	device.md
Storage	@aurobore/storage	—	storage.md
FileSystem	@aurobore/filesystem	— (scope: appData)	filesystem.md
Clipboard	@aurobore/clipboard	—	clipboard.md
Network	@aurobore/network	Internet	network.md
Camera	@aurobore/camera	Camera	camera.md
Geolocation	@aurobore/geolocation	Location	geolocation.md
Notifications	@aurobore/notifications	Notifications	notifications.md
Share	@aurobore/share	—	share.md
Sensors	@aurobore/sensors	—	sensors.md

Все пакеты публикуются в npm и подключаются через aurobore plugin add <name>. Демо: examples/camera-demo/, geo-demo, notifications-demo, share-demo, sensors-demo.

Импорт

import { Echo } from "@aurobore/echo";
import { FileSystem } from "@aurobore/filesystem";
import { Camera } from "@aurobore/camera";

Типы и методы генерируются из plugin.manifest. Коды ошибок объявлены в манифесте как single source of truth.

Обработка ошибок

Вызов метода плагина возвращает Promise. При ошибке Promise reject с объектом BridgeError:

interface BridgeError {
  code: string;    // например FILESYSTEM_INVALID_PATH
  message: string;
  data?: unknown;
}

В SDK используйте wrapBridgeError() и isAuroboreError() из @aurobore/core:

import { isAuroboreError, wrapBridgeError } from "@aurobore/core";
import { FileSystem } from "@aurobore/filesystem";

try {
  await FileSystem.readText({ path: "../secret" });
} catch (err) {
  const error = isAuroboreError(err)
    ? err
    : wrapBridgeError(err as { code: string; message: string });
  if (error.code === "FILESYSTEM_INVALID_PATH") {
    // путь вне песочницы или содержит ..
  }
}

Уровни кодов

Префикс	Источник	Примеры
BRIDGE_*	Мост / Plugin Manager	BRIDGE_TIMEOUT, BRIDGE_PERMISSION_DENIED, BRIDGE_METHOD_NOT_FOUND
<PLUGIN>_*	Конкретный плагин	FILESYSTEM_INVALID_PATH, CAMERA_UNAVAILABLE

Коды плагина перечислены на странице каждого reference. Общие коды моста — в api/README.md.

Примеры

• examples/hello-world/ — Echo, Device, lifecycle
• examples/camera-demo/ — Camera
• examples/geo-demo/ — Geolocation
• examples/sensors-demo/ — Sensors
• examples/notifications-demo/ — Notifications
• examples/share-demo/ — Share
• docs/tutorials/using-plugins.md — добавление плагинов в проект