@open-mova/core 0.2.0 → 0.2.2

package/README.md

@@ -57,25 +57,6 @@ npm run build
 El paquete se identifica como `@open-mova/core`. Cuando se añada una pieza
 pública, debe exportarse desde `src/index.ts`.
 
-La shell proporciona el token `NATIVE_CAPABILITIES` y el MF accede a él por DI:
-
-```ts
-import { injectNativeCapabilities } from '@open-mova/core';
-
-const native = injectNativeCapabilities(); // Dentro de un contexto de inyección Angular.
-const device = await native.device.getInfo();
-const photo = await native.camera.takePhoto();
-const selected = await native.camera.choosePhoto();
-```
-
-`photo.webPath` sirve para mostrar la imagen; `photo.uri` puede existir en
-móvil. `choosePhoto()` devuelve `undefined` si la galería devuelve una lista
-vacía; cancelar el diálogo puede rechazar la promesa según la plataforma.
-Angular muestra un error de provider ausente si la shell no ofrece el contrato.
-Los MF que usan capacidades nativas dependen de `@open-mova/core` desde npm.
-Shell y MF deben compartir una sola instancia de core mediante Native
-Federation.
-
 ## Capacidades nativas
 
 Cada plugin oficial se representa como una capacidad con tres operaciones
@@ -83,28 +64,25 @@ comunes:
 
 - `isAvailable()` comprueba si el plugin está disponible en la plataforma.
 - `invoke(nombre, opciones)` ejecuta una operación del plugin.
-- `subscribe(evento, listener)` registra un evento y devuelve un handle con
+- `subscribe(evento, listener, contexto?)` registra un evento y devuelve un handle con
   `remove()` para cancelarlo.
 
-Los nombres de capacidad están en camelCase y no dependen del nombre del
-paquete npm. Por ejemplo, un MF puede consultar conectividad así:
-
-```ts
-const native = injectNativeCapabilities();
-
-if (native.network.isAvailable()) {
-  const status = await native.network.invoke('getStatus');
-}
-```
+`NATIVE_CAPABILITY_API` contiene la lista completa y versionada de operaciones
+y eventos soportados. El microfrontal de demostración la reutiliza para que su
+referencia interactiva no pueda quedarse desactualizada respecto al contrato.
+El tercer argumento de `subscribe()` solo es necesario en capacidades con
+instancias, como Google Maps, donde se pasa `{ id: 'mapa-principal' }`.
 
-El contrato expone: `actionSheet`, `app`, `appLauncher`, `backgroundRunner`,
+El contrato expone una capacidad por cada plugin oficial soportado:
+`actionSheet`, `app`, `appLauncher`, `backgroundRunner`,
 `barcodeScanner`, `browser`, `calendar`, `camera`, `clipboard`, `contacts`,
 `cookies`, `device`, `dialog`, `fileTransfer`, `fileViewer`, `filesystem`,
 `geolocation`, `googleMaps`, `haptics`, `healthFitness`, `http`,
 `inAppBrowser`, `keyboard`, `localLlm`, `localNotifications`, `motion`,
 `network`, `preferences`, `privacyScreen`, `pushNotifications`,
 `screenOrientation`, `screenReader`, `share`, `splashScreen`, `statusBar`,
-`systemBars`, `textZoom` y `toast`.
+`systemBars`, `textZoom` y `toast`. La lista completa de métodos y eventos de
+cada capacidad se encuentra en `NATIVE_CAPABILITY_API`.
 
 Las opciones y el resultado no exponen tipos de Capacitor. Esto evita que el MF
 se acople a su versión; algunas operaciones avanzadas pueden requerir valores

package/dist/compatibility.d.ts

@@ -0,0 +1,23 @@
+/** Versión del paquete que implementa este contrato en tiempo de ejecución. */
+export declare const OPEN_MOVA_CORE_VERSION = "0.2.1";
+/** Versión del formato del manifiesto publicado por cada microfrontal. */
+export declare const MICROFRONTEND_MANIFEST_SCHEMA_VERSION = 1;
+export interface OpenMovaMicrofrontendManifest {
+    readonly schemaVersion: typeof MICROFRONTEND_MANIFEST_SCHEMA_VERSION;
+    readonly name: string;
+    readonly remoteName: string;
+    readonly core: {
+        readonly requiredVersion: string;
+    };
+}
+export interface CompatibilityResult {
+    readonly compatible: boolean;
+    readonly reason?: string;
+}
+/**
+ * Comprueba los rangos que genera Open Mova: versión exacta, caret y tilde.
+ * Mantener el formato acotado permite usarlo también en el navegador sin
+ * incorporar un segundo motor completo de semver al runtime compartido.
+ */
+export declare function checkCoreCompatibility(requiredVersion: string, availableVersion?: string): CompatibilityResult;
+export declare function parseMicrofrontendManifest(value: unknown): OpenMovaMicrofrontendManifest;

package/dist/compatibility.js

@@ -0,0 +1,94 @@
+/** Versión del paquete que implementa este contrato en tiempo de ejecución. */
+export const OPEN_MOVA_CORE_VERSION = '0.2.1';
+/** Versión del formato del manifiesto publicado por cada microfrontal. */
+export const MICROFRONTEND_MANIFEST_SCHEMA_VERSION = 1;
+/**
+ * Comprueba los rangos que genera Open Mova: versión exacta, caret y tilde.
+ * Mantener el formato acotado permite usarlo también en el navegador sin
+ * incorporar un segundo motor completo de semver al runtime compartido.
+ */
+export function checkCoreCompatibility(requiredVersion, availableVersion = OPEN_MOVA_CORE_VERSION) {
+    const range = parseSupportedRange(requiredVersion);
+    const available = parseVersion(availableVersion);
+    if (!range || !available) {
+        return {
+            compatible: false,
+            reason: `No se puede interpretar el rango ${requiredVersion} o la versión ${availableVersion}.`,
+        };
+    }
+    const minimumComparison = compareVersions(available, range.minimum);
+    const compatible = minimumComparison >= 0 && isBelowUpperBound(available, range);
+    return compatible
+        ? { compatible: true }
+        : {
+            compatible: false,
+            reason: `Requiere @open-mova/core ${requiredVersion}, pero la shell proporciona ${availableVersion}.`,
+        };
+}
+export function parseMicrofrontendManifest(value) {
+    if (!isRecord(value) || value.schemaVersion !== MICROFRONTEND_MANIFEST_SCHEMA_VERSION) {
+        throw new Error('El manifiesto del microfrontal tiene una versión no compatible.');
+    }
+    if (typeof value.name !== 'string' ||
+        typeof value.remoteName !== 'string' ||
+        !isRecord(value.core) ||
+        typeof value.core.requiredVersion !== 'string') {
+        throw new Error('El manifiesto del microfrontal está incompleto.');
+    }
+    return {
+        schemaVersion: MICROFRONTEND_MANIFEST_SCHEMA_VERSION,
+        name: value.name,
+        remoteName: value.remoteName,
+        core: { requiredVersion: value.core.requiredVersion },
+    };
+}
+function parseSupportedRange(value) {
+    if (value.trim() === '*') {
+        return {
+            operator: 'caret',
+            minimum: { major: 0, minor: 0, patch: 0 },
+        };
+    }
+    const match = value.trim().match(/^(\^|~)?(\d+)\.(\d+)\.(\d+)$/);
+    if (!match)
+        return undefined;
+    return {
+        operator: match[1] === '^' ? 'caret' : match[1] === '~' ? 'tilde' : 'exact',
+        minimum: {
+            major: Number(match[2]),
+            minor: Number(match[3]),
+            patch: Number(match[4]),
+        },
+    };
+}
+function parseVersion(value) {
+    const match = value.trim().match(/^v?(\d+)\.(\d+)\.(\d+)$/);
+    return match
+        ? { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) }
+        : undefined;
+}
+function isBelowUpperBound(version, range) {
+    if (range.operator === 'caret' &&
+        range.minimum.major === 0 &&
+        range.minimum.minor === 0 &&
+        range.minimum.patch === 0) {
+        return true;
+    }
+    if (range.operator === 'exact')
+        return compareVersions(version, range.minimum) === 0;
+    if (range.operator === 'tilde') {
+        return version.major === range.minimum.major && version.minor === range.minimum.minor;
+    }
+    if (range.minimum.major > 0)
+        return version.major === range.minimum.major;
+    if (range.minimum.minor > 0) {
+        return version.major === 0 && version.minor === range.minimum.minor;
+    }
+    return compareVersions(version, range.minimum) === 0;
+}
+function compareVersions(first, second) {
+    return first.major - second.major || first.minor - second.minor || first.patch - second.patch;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-export type { ActionSheetCapability, AppCapability, AppLauncherCapability, BackgroundRunnerCapability, BarcodeScannerCapability, BrowserCapability, CameraCapability, CalendarCapability, ClipboardCapability, ContactsCapability, CookiesCapability, DeviceCapability, DeviceDetails, DialogCapability, FileTransferCapability, FileViewerCapability, FilesystemCapability, GeolocationCapability, GoogleMapsCapability, HapticsCapability, HealthFitnessCapability, HttpCapability, InAppBrowserCapability, KeyboardCapability, LocalLlmCapability, LocalNotificationsCapability, MotionCapability, NativeCapabilities, NativeOptions, NativePluginCapability, NativeSubscription, NetworkCapability, PhotoResult, PreferencesCapability, PrivacyScreenCapability, PushNotificationsCapability, ScreenOrientationCapability, ScreenReaderCapability, ShareCapability, SplashScreenCapability, StatusBarCapability, SystemBarsCapability, TextZoomCapability, ToastCapability, } from './native.js';
-export { NATIVE_CAPABILITIES, injectNativeCapabilities } from './native.js';
+export { checkCoreCompatibility, MICROFRONTEND_MANIFEST_SCHEMA_VERSION, OPEN_MOVA_CORE_VERSION, parseMicrofrontendManifest, } from './compatibility.js';
+export type { CompatibilityResult, OpenMovaMicrofrontendManifest } from './compatibility.js';
+export type { ActionSheetCapability, AppCapability, AppLauncherCapability, BackgroundRunnerCapability, BarcodeScannerCapability, BrowserCapability, CameraCapability, CalendarCapability, ClipboardCapability, ContactsCapability, CookiesCapability, DeviceCapability, DeviceDetails, DialogCapability, FileTransferCapability, FileViewerCapability, FilesystemCapability, GeolocationCapability, GoogleMapsCapability, HapticsCapability, HealthFitnessCapability, HttpCapability, InAppBrowserCapability, KeyboardCapability, LocalLlmCapability, LocalNotificationsCapability, MotionCapability, NativeCapabilities, NativeCapabilityName, NativeEvent, NativeOptions, NativeOperation, NativePluginCapability, NativeSubscription, NetworkCapability, PhotoResult, PreferencesCapability, PrivacyScreenCapability, PushNotificationsCapability, ScreenOrientationCapability, ScreenReaderCapability, ShareCapability, SplashScreenCapability, StatusBarCapability, SystemBarsCapability, TextZoomCapability, ToastCapability, } from './native.js';
+export { NATIVE_CAPABILITIES, NATIVE_CAPABILITY_API, injectNativeCapabilities } from './native.js';

package/dist/index.js

@@ -1 +1,2 @@
-export { NATIVE_CAPABILITIES, injectNativeCapabilities } from './native.js';
+export { checkCoreCompatibility, MICROFRONTEND_MANIFEST_SCHEMA_VERSION, OPEN_MOVA_CORE_VERSION, parseMicrofrontendManifest, } from './compatibility.js';
+export { NATIVE_CAPABILITIES, NATIVE_CAPABILITY_API, injectNativeCapabilities } from './native.js';

package/dist/native.d.ts

@@ -1,115 +1,269 @@
 import { InjectionToken } from '@angular/core';
 /**
- * Options passed across the framework boundary. Some official plugins need
- * platform values such as Date, Blob or an element reference, so this cannot
- * be restricted to JSON alone.
+ * Superficie oficial que Open Mova expone para cada plugin de Capacitor.
+ * La demo consume también este catálogo para no mantener una segunda lista.
  */
+export declare const NATIVE_CAPABILITY_API: {
+    readonly actionSheet: {
+        readonly operations: readonly ["showActions"];
+        readonly events: readonly [];
+    };
+    readonly app: {
+        readonly operations: readonly ["exitApp", "getInfo", "getState", "getLaunchUrl", "minimizeApp", "getAppLanguage", "toggleBackButtonHandler", "removeAllListeners"];
+        readonly events: readonly ["appStateChange", "pause", "resume", "appUrlOpen", "appRestoredResult", "backButton"];
+    };
+    readonly appLauncher: {
+        readonly operations: readonly ["canOpenUrl", "openUrl"];
+        readonly events: readonly [];
+    };
+    readonly backgroundRunner: {
+        readonly operations: readonly ["checkPermissions", "requestPermissions", "dispatchEvent", "removeNotificationListeners"];
+        readonly events: readonly ["backgroundRunnerNotificationReceived"];
+    };
+    readonly barcodeScanner: {
+        readonly operations: readonly ["scanBarcode"];
+        readonly events: readonly [];
+    };
+    readonly browser: {
+        readonly operations: readonly ["open", "close", "removeAllListeners"];
+        readonly events: readonly ["browserFinished", "browserPageLoaded"];
+    };
+    readonly calendar: {
+        readonly operations: readonly ["checkPermissions", "requestPermissions", "createEvent", "createEventInteractively", "modifyEvent", "findEvents", "deleteEvent", "listCalendars", "createCalendar", "deleteCalendar", "openCalendar"];
+        readonly events: readonly [];
+    };
+    readonly camera: {
+        readonly operations: readonly ["takePhoto", "recordVideo", "playVideo", "chooseFromGallery", "editPhoto", "editURIPhoto", "pickLimitedLibraryPhotos", "getLimitedLibraryPhotos", "checkPermissions", "requestPermissions", "getPhoto", "pickImages"];
+        readonly events: readonly [];
+    };
+    readonly clipboard: {
+        readonly operations: readonly ["write", "read"];
+        readonly events: readonly [];
+    };
+    readonly contacts: {
+        readonly operations: readonly ["find", "save", "remove", "pickContact"];
+        readonly events: readonly [];
+    };
+    readonly cookies: {
+        readonly operations: readonly ["getCookies", "setCookie", "deleteCookie", "clearCookies", "clearAllCookies"];
+        readonly events: readonly [];
+    };
+    readonly device: {
+        readonly operations: readonly ["getId", "getInfo", "getBatteryInfo", "getLanguageCode", "getLanguageTag"];
+        readonly events: readonly [];
+    };
+    readonly dialog: {
+        readonly operations: readonly ["alert", "prompt", "confirm"];
+        readonly events: readonly [];
+    };
+    readonly fileTransfer: {
+        readonly operations: readonly ["downloadFile", "uploadFile", "removeAllListeners"];
+        readonly events: readonly ["progress"];
+    };
+    readonly fileViewer: {
+        readonly operations: readonly ["openDocumentFromLocalPath", "openDocumentFromResources", "openDocumentFromUrl", "previewMediaContentFromLocalPath", "previewMediaContentFromResources", "previewMediaContentFromUrl"];
+        readonly events: readonly [];
+    };
+    readonly filesystem: {
+        readonly operations: readonly ["checkPermissions", "requestPermissions", "readFile", "readFileInChunks", "writeFile", "appendFile", "deleteFile", "mkdir", "rmdir", "readdir", "getUri", "stat", "rename", "copy", "downloadFile", "removeAllListeners"];
+        readonly events: readonly ["progress"];
+    };
+    readonly geolocation: {
+        readonly operations: readonly ["getCurrentPosition", "watchPosition", "clearWatch", "checkPermissions", "requestPermissions"];
+        readonly events: readonly [];
+    };
+    readonly googleMaps: {
+        readonly operations: readonly ["create", "enableTouch", "disableTouch", "enableClustering", "disableClustering", "addTileOverlay", "removeTileOverlay", "addMarker", "addMarkers", "removeMarker", "removeMarkers", "addPolygons", "removePolygons", "addCircles", "removeCircles", "addPolylines", "removePolylines", "destroy", "setCamera", "getMapType", "setMapType", "enableIndoorMaps", "enableTrafficLayer", "enableAccessibilityElements", "enableCurrentLocation", "setPadding", "getMapBounds", "fitBounds", "removeAllMapListeners"];
+        readonly events: readonly ["boundsChanged", "cameraIdle", "cameraMoveStarted", "clusterClick", "clusterInfoWindowClick", "infoWindowClick", "mapClick", "markerClick", "polygonClick", "circleClick", "polylineClick", "markerDragStart", "markerDrag", "markerDragEnd", "myLocationButtonClick", "myLocationClick"];
+    };
+    readonly haptics: {
+        readonly operations: readonly ["impact", "notification", "vibrate", "selectionStart", "selectionChanged", "selectionEnd"];
+        readonly events: readonly [];
+    };
+    readonly healthFitness: {
+        readonly operations: readonly ["requestHealthPermissions", "getData", "getWorkoutData", "writeData", "getLastRecord", "setBackgroundJob", "deleteBackgroundJob", "listBackgroundJobs", "updateBackgroundJob", "disconnectFromHealthConnect", "openHealthConnect"];
+        readonly events: readonly [];
+    };
+    readonly http: {
+        readonly operations: readonly ["request", "get", "post", "put", "patch", "delete"];
+        readonly events: readonly [];
+    };
+    readonly inAppBrowser: {
+        readonly operations: readonly ["openInWebView", "openInSystemBrowser", "openInExternalBrowser", "close", "removeAllListeners"];
+        readonly events: readonly ["browserPageLoaded", "browserPageNavigationCompleted", "browserClosed"];
+    };
+    readonly keyboard: {
+        readonly operations: readonly ["show", "hide", "setAccessoryBarVisible", "setScroll", "setStyle", "setResizeMode", "getResizeMode", "removeAllListeners"];
+        readonly events: readonly ["keyboardWillShow", "keyboardDidShow", "keyboardWillHide", "keyboardDidHide"];
+    };
+    readonly localLlm: {
+        readonly operations: readonly ["systemAvailability", "download", "prompt", "endSession", "generateImage", "warmup", "removeAllListeners"];
+        readonly events: readonly ["systemAvailabilityChange"];
+    };
+    readonly localNotifications: {
+        readonly operations: readonly ["schedule", "update", "getPending", "registerActionTypes", "cancel", "cancelAll", "areEnabled", "getDeliveredNotifications", "removeDeliveredNotifications", "removeDeliveredNotificationsById", "removeAllDeliveredNotifications", "getByIds", "getAll", "createChannel", "deleteChannel", "listChannels", "checkPermissions", "requestPermissions", "changeExactNotificationSetting", "checkExactNotificationSetting", "removeAllListeners"];
+        readonly events: readonly ["localNotificationReceived", "localNotificationActionPerformed"];
+    };
+    readonly motion: {
+        readonly operations: readonly ["removeAllListeners"];
+        readonly events: readonly ["accel", "orientation"];
+    };
+    readonly network: {
+        readonly operations: readonly ["getStatus", "removeAllListeners"];
+        readonly events: readonly ["networkStatusChange"];
+    };
+    readonly preferences: {
+        readonly operations: readonly ["configure", "get", "set", "remove", "clear", "keys", "migrate", "removeOld"];
+        readonly events: readonly [];
+    };
+    readonly privacyScreen: {
+        readonly operations: readonly ["enable", "disable", "isEnabled"];
+        readonly events: readonly [];
+    };
+    readonly pushNotifications: {
+        readonly operations: readonly ["register", "unregister", "getDeliveredNotifications", "removeDeliveredNotifications", "removeAllDeliveredNotifications", "createChannel", "deleteChannel", "listChannels", "checkPermissions", "requestPermissions", "removeAllListeners"];
+        readonly events: readonly ["registration", "registrationError", "pushNotificationReceived", "pushNotificationActionPerformed"];
+    };
+    readonly screenOrientation: {
+        readonly operations: readonly ["orientation", "lock", "unlock", "removeAllListeners"];
+        readonly events: readonly ["screenOrientationChange"];
+    };
+    readonly screenReader: {
+        readonly operations: readonly ["isEnabled", "speak", "removeAllListeners"];
+        readonly events: readonly ["stateChange"];
+    };
+    readonly share: {
+        readonly operations: readonly ["canShare", "share"];
+        readonly events: readonly [];
+    };
+    readonly splashScreen: {
+        readonly operations: readonly ["show", "hide"];
+        readonly events: readonly [];
+    };
+    readonly statusBar: {
+        readonly operations: readonly ["setStyle", "setBackgroundColor", "show", "hide", "getInfo", "setOverlaysWebView"];
+        readonly events: readonly ["statusBarVisibilityChanged", "statusBarOverlayChanged"];
+    };
+    readonly systemBars: {
+        readonly operations: readonly ["setStyle", "show", "hide", "setAnimation"];
+        readonly events: readonly [];
+    };
+    readonly textZoom: {
+        readonly operations: readonly ["get", "getPreferred", "set"];
+        readonly events: readonly [];
+    };
+    readonly toast: {
+        readonly operations: readonly ["show"];
+        readonly events: readonly [];
+    };
+};
+export type NativeCapabilityName = keyof typeof NATIVE_CAPABILITY_API;
+export type NativeOperation<TName extends NativeCapabilityName> = (typeof NATIVE_CAPABILITY_API)[TName]['operations'][number];
+export type NativeEvent<TName extends NativeCapabilityName> = (typeof NATIVE_CAPABILITY_API)[TName]['events'][number];
+/** Options passed across the shell boundary, including non-JSON native values. */
 export type NativeOptions = Readonly<Record<string, unknown>>;
 export interface NativeSubscription {
     remove(): Promise<void>;
 }
-/**
- * Base contract shared by every plugin capability. Capacitor stays private to
- * the shell, so this public API can be versioned independently.
- */
+/** Capacitor stays private to the shell behind this stable public contract. */
 export interface NativePluginCapability<TOperation extends string = string, TEvent extends string = never> {
     isAvailable(): boolean;
     invoke<TResult = unknown>(operation: TOperation, options?: NativeOptions): Promise<TResult>;
-    subscribe(event: TEvent, listener: (payload: unknown) => void): Promise<NativeSubscription>;
+    subscribe(event: TEvent, listener: (payload: unknown) => void, options?: NativeOptions): Promise<NativeSubscription>;
 }
-type ExtensibleOperation<TKnown extends string> = TKnown | (string & {});
+type Capability<TName extends NativeCapabilityName> = NativePluginCapability<NativeOperation<TName>, NativeEvent<TName>>;
 export interface DeviceDetails {
     readonly model: string;
     readonly platform: 'ios' | 'android' | 'web';
     readonly osVersion: string;
 }
-export interface DeviceCapability extends NativePluginCapability<ExtensibleOperation<'getId' | 'getInfo' | 'getBatteryInfo' | 'getLanguageCode' | 'getLanguageTag'>> {
+export interface DeviceCapability extends Capability<'device'> {
     getInfo(): Promise<DeviceDetails>;
 }
 export interface PhotoResult {
     readonly webPath?: string;
     readonly uri?: string;
 }
-export interface CameraCapability extends NativePluginCapability<ExtensibleOperation<'takePhoto' | 'recordVideo' | 'playVideo' | 'chooseFromGallery' | 'editPhoto' | 'editURIPhoto' | 'pickLimitedLibraryPhotos' | 'getLimitedLibraryPhotos' | 'checkPermissions' | 'requestPermissions' | 'getPhoto' | 'pickImages'>> {
+export interface CameraCapability extends Capability<'camera'> {
     takePhoto(): Promise<PhotoResult>;
     choosePhoto(): Promise<PhotoResult | undefined>;
 }
-export interface ActionSheetCapability extends NativePluginCapability<ExtensibleOperation<'showActions'>> {
+export interface ActionSheetCapability extends Capability<'actionSheet'> {
 }
-export interface AppLauncherCapability extends NativePluginCapability<ExtensibleOperation<'canOpenUrl' | 'openUrl'>> {
+export interface AppCapability extends Capability<'app'> {
 }
-export interface AppCapability extends NativePluginCapability<ExtensibleOperation<'exitApp' | 'getInfo' | 'getState' | 'getLaunchUrl' | 'minimizeApp' | 'getAppLanguage' | 'toggleBackButtonHandler' | 'removeAllListeners'>, 'appStateChange' | 'pause' | 'resume' | 'appUrlOpen' | 'appRestoredResult' | 'backButton'> {
+export interface AppLauncherCapability extends Capability<'appLauncher'> {
 }
-export interface BackgroundRunnerCapability extends NativePluginCapability<ExtensibleOperation<'checkPermissions' | 'requestPermissions' | 'removeNotificationListeners'>, 'backgroundRunnerNotificationReceived'> {
+export interface BackgroundRunnerCapability extends Capability<'backgroundRunner'> {
 }
-export interface BarcodeScannerCapability extends NativePluginCapability<ExtensibleOperation<'scanBarcode'>> {
+export interface BarcodeScannerCapability extends Capability<'barcodeScanner'> {
 }
-export interface BrowserCapability extends NativePluginCapability<ExtensibleOperation<'open' | 'close' | 'removeAllListeners'>, 'browserFinished' | 'browserPageLoaded'> {
+export interface BrowserCapability extends Capability<'browser'> {
 }
-export interface CalendarCapability extends NativePluginCapability<ExtensibleOperation<'checkPermissions' | 'requestPermissions' | 'createEvent' | 'createEventInteractively' | 'modifyEvent' | 'findEvents' | 'deleteEvent' | 'listCalendars' | 'createCalendar' | 'deleteCalendar' | 'openCalendar'>> {
+export interface CalendarCapability extends Capability<'calendar'> {
 }
-export interface ClipboardCapability extends NativePluginCapability<ExtensibleOperation<'write' | 'read'>> {
+export interface ClipboardCapability extends Capability<'clipboard'> {
 }
-export interface ContactsCapability extends NativePluginCapability<ExtensibleOperation<'find' | 'save' | 'remove' | 'pickContact'>> {
+export interface ContactsCapability extends Capability<'contacts'> {
 }
 /** Cookies is bundled in @capacitor/core. */
-export interface CookiesCapability extends NativePluginCapability<ExtensibleOperation<'getCookies' | 'setCookie' | 'deleteCookie' | 'clearCookies' | 'clearAllCookies'>> {
+export interface CookiesCapability extends Capability<'cookies'> {
 }
-export interface DialogCapability extends NativePluginCapability<ExtensibleOperation<'alert' | 'prompt' | 'confirm'>> {
+export interface DialogCapability extends Capability<'dialog'> {
 }
-export interface FileTransferCapability extends NativePluginCapability<ExtensibleOperation<'downloadFile' | 'uploadFile' | 'removeAllListeners'>, 'progress'> {
+export interface FileTransferCapability extends Capability<'fileTransfer'> {
 }
-export interface FileViewerCapability extends NativePluginCapability<ExtensibleOperation<'openDocumentFromLocalPath' | 'openDocumentFromResources' | 'openDocumentFromUrl' | 'previewMediaContentFromLocalPath' | 'previewMediaContentFromResources' | 'previewMediaContentFromUrl'>> {
+export interface FileViewerCapability extends Capability<'fileViewer'> {
 }
-export interface FilesystemCapability extends NativePluginCapability<ExtensibleOperation<'checkPermissions' | 'requestPermissions' | 'readFile' | 'writeFile' | 'appendFile' | 'deleteFile' | 'mkdir' | 'rmdir' | 'readdir' | 'getUri' | 'stat' | 'rename' | 'copy' | 'downloadFile'>, 'progress'> {
+export interface FilesystemCapability extends Capability<'filesystem'> {
 }
-export interface GeolocationCapability extends NativePluginCapability<ExtensibleOperation<'getCurrentPosition' | 'watchPosition' | 'clearWatch' | 'checkPermissions' | 'requestPermissions'>> {
+export interface GeolocationCapability extends Capability<'geolocation'> {
 }
-/** Google Maps creates stateful map instances behind this same capability boundary. */
-export interface GoogleMapsCapability extends NativePluginCapability<ExtensibleOperation<'create' | 'destroy' | 'setCamera' | 'addMarker' | 'addMarkers' | 'removeMarker' | 'removeMarkers'>> {
+/** Google Maps keeps stateful map instances inside the shell. */
+export interface GoogleMapsCapability extends Capability<'googleMaps'> {
 }
-export interface HapticsCapability extends NativePluginCapability<ExtensibleOperation<'impact' | 'notification' | 'vibrate' | 'selectionStart' | 'selectionChanged' | 'selectionEnd'>> {
+export interface HapticsCapability extends Capability<'haptics'> {
 }
-export interface HealthFitnessCapability extends NativePluginCapability<ExtensibleOperation<'isAvailable' | 'requestAuthorization' | 'checkAuthorization' | 'query' | 'save' | 'delete' | 'setBackgroundJob' | 'disableBackgroundJob'>> {
+export interface HealthFitnessCapability extends Capability<'healthFitness'> {
 }
 /** HTTP is bundled in @capacitor/core. */
-export interface HttpCapability extends NativePluginCapability<ExtensibleOperation<'request' | 'get' | 'post' | 'put' | 'patch' | 'delete' | 'setCookie' | 'clearCookies' | 'deleteCookie' | 'clearAllCookies'>> {
+export interface HttpCapability extends Capability<'http'> {
 }
-export interface InAppBrowserCapability extends NativePluginCapability<ExtensibleOperation<'openInWebView' | 'openInSystemBrowser' | 'openInExternalBrowser' | 'close' | 'removeAllListeners'>, 'browserPageLoaded' | 'browserPageNavigationCompleted' | 'browserClosed' | 'urlChange'> {
+export interface InAppBrowserCapability extends Capability<'inAppBrowser'> {
 }
-export interface KeyboardCapability extends NativePluginCapability<ExtensibleOperation<'show' | 'hide' | 'setAccessoryBarVisible' | 'setScroll' | 'setResizeMode' | 'getResizeMode' | 'removeAllListeners'>, 'keyboardWillShow' | 'keyboardDidShow' | 'keyboardWillHide' | 'keyboardDidHide'> {
+export interface KeyboardCapability extends Capability<'keyboard'> {
 }
 /** Experimental Capacitor plugin. Always call isAvailable before invoking it. */
-export interface LocalLlmCapability extends NativePluginCapability<ExtensibleOperation<'systemAvailability' | 'download' | 'prompt' | 'endSession' | 'generateImage' | 'warmup' | 'removeAllListeners'>, 'systemAvailabilityChange'> {
+export interface LocalLlmCapability extends Capability<'localLlm'> {
 }
-export interface LocalNotificationsCapability extends NativePluginCapability<ExtensibleOperation<'schedule' | 'update' | 'getPending' | 'registerActionTypes' | 'cancel' | 'cancelAll' | 'areEnabled' | 'getDeliveredNotifications' | 'removeDeliveredNotifications' | 'removeDeliveredNotificationsById' | 'removeAllDeliveredNotifications' | 'getByIds' | 'getAll' | 'createChannel' | 'deleteChannel' | 'listChannels' | 'checkPermissions' | 'requestPermissions' | 'changeExactNotificationSetting' | 'checkExactNotificationSetting' | 'removeAllListeners'>, 'localNotificationReceived' | 'localNotificationActionPerformed'> {
+export interface LocalNotificationsCapability extends Capability<'localNotifications'> {
 }
-export interface MotionCapability extends NativePluginCapability<ExtensibleOperation<'removeAllListeners'>, 'accel' | 'orientation'> {
+export interface MotionCapability extends Capability<'motion'> {
 }
-export interface NetworkCapability extends NativePluginCapability<ExtensibleOperation<'getStatus' | 'removeAllListeners'>, 'networkStatusChange'> {
+export interface NetworkCapability extends Capability<'network'> {
 }
-export interface PreferencesCapability extends NativePluginCapability<ExtensibleOperation<'configure' | 'get' | 'set' | 'remove' | 'clear' | 'keys' | 'migrate' | 'removeOld'>> {
+export interface PreferencesCapability extends Capability<'preferences'> {
 }
-export interface PrivacyScreenCapability extends NativePluginCapability<ExtensibleOperation<'enable' | 'disable' | 'isEnabled'>> {
+export interface PrivacyScreenCapability extends Capability<'privacyScreen'> {
 }
-export interface PushNotificationsCapability extends NativePluginCapability<ExtensibleOperation<'register' | 'unregister' | 'getDeliveredNotifications' | 'removeDeliveredNotifications' | 'removeAllDeliveredNotifications' | 'createChannel' | 'deleteChannel' | 'listChannels' | 'checkPermissions' | 'requestPermissions' | 'removeAllListeners'>, 'registration' | 'registrationError' | 'pushNotificationReceived' | 'pushNotificationActionPerformed'> {
+export interface PushNotificationsCapability extends Capability<'pushNotifications'> {
 }
-export interface ScreenOrientationCapability extends NativePluginCapability<ExtensibleOperation<'orientation' | 'lock' | 'unlock' | 'removeAllListeners'>, 'screenOrientationChange'> {
+export interface ScreenOrientationCapability extends Capability<'screenOrientation'> {
 }
-export interface ScreenReaderCapability extends NativePluginCapability<ExtensibleOperation<'isEnabled' | 'speak' | 'removeAllListeners'>, 'stateChange'> {
+export interface ScreenReaderCapability extends Capability<'screenReader'> {
 }
-export interface ShareCapability extends NativePluginCapability<ExtensibleOperation<'canShare' | 'share'>> {
+export interface ShareCapability extends Capability<'share'> {
 }
-export interface SplashScreenCapability extends NativePluginCapability<ExtensibleOperation<'show' | 'hide'>> {
+export interface SplashScreenCapability extends Capability<'splashScreen'> {
 }
-export interface StatusBarCapability extends NativePluginCapability<ExtensibleOperation<'setStyle' | 'setBackgroundColor' | 'show' | 'hide' | 'getInfo' | 'setOverlaysWebView'>, 'statusBarVisibilityChanged' | 'statusBarOverlayChanged'> {
+export interface StatusBarCapability extends Capability<'statusBar'> {
 }
 /** System Bars is bundled in @capacitor/core and supersedes Status Bar for edge-to-edge layouts. */
-export interface SystemBarsCapability extends NativePluginCapability<ExtensibleOperation<'setStyle' | 'show' | 'hide' | 'setAnimation'>> {
+export interface SystemBarsCapability extends Capability<'systemBars'> {
 }
-export interface TextZoomCapability extends NativePluginCapability<ExtensibleOperation<'get' | 'getPreferred' | 'set'>> {
+export interface TextZoomCapability extends Capability<'textZoom'> {
 }
-export interface ToastCapability extends NativePluginCapability<ExtensibleOperation<'show'>> {
+export interface ToastCapability extends Capability<'toast'> {
 }
 export interface NativeCapabilities {
     /** Version 1 remains compatible with the original Device and Camera contract. */

package/dist/native.js

@@ -1,4 +1,314 @@
 import { InjectionToken, inject } from '@angular/core';
+/**
+ * Superficie oficial que Open Mova expone para cada plugin de Capacitor.
+ * La demo consume también este catálogo para no mantener una segunda lista.
+ */
+export const NATIVE_CAPABILITY_API = {
+    actionSheet: { operations: ['showActions'], events: [] },
+    app: {
+        operations: [
+            'exitApp',
+            'getInfo',
+            'getState',
+            'getLaunchUrl',
+            'minimizeApp',
+            'getAppLanguage',
+            'toggleBackButtonHandler',
+            'removeAllListeners',
+        ],
+        events: ['appStateChange', 'pause', 'resume', 'appUrlOpen', 'appRestoredResult', 'backButton'],
+    },
+    appLauncher: { operations: ['canOpenUrl', 'openUrl'], events: [] },
+    backgroundRunner: {
+        operations: [
+            'checkPermissions',
+            'requestPermissions',
+            'dispatchEvent',
+            'removeNotificationListeners',
+        ],
+        events: ['backgroundRunnerNotificationReceived'],
+    },
+    barcodeScanner: { operations: ['scanBarcode'], events: [] },
+    browser: {
+        operations: ['open', 'close', 'removeAllListeners'],
+        events: ['browserFinished', 'browserPageLoaded'],
+    },
+    calendar: {
+        operations: [
+            'checkPermissions',
+            'requestPermissions',
+            'createEvent',
+            'createEventInteractively',
+            'modifyEvent',
+            'findEvents',
+            'deleteEvent',
+            'listCalendars',
+            'createCalendar',
+            'deleteCalendar',
+            'openCalendar',
+        ],
+        events: [],
+    },
+    camera: {
+        operations: [
+            'takePhoto',
+            'recordVideo',
+            'playVideo',
+            'chooseFromGallery',
+            'editPhoto',
+            'editURIPhoto',
+            'pickLimitedLibraryPhotos',
+            'getLimitedLibraryPhotos',
+            'checkPermissions',
+            'requestPermissions',
+            'getPhoto',
+            'pickImages',
+        ],
+        events: [],
+    },
+    clipboard: { operations: ['write', 'read'], events: [] },
+    contacts: { operations: ['find', 'save', 'remove', 'pickContact'], events: [] },
+    cookies: {
+        operations: ['getCookies', 'setCookie', 'deleteCookie', 'clearCookies', 'clearAllCookies'],
+        events: [],
+    },
+    device: {
+        operations: ['getId', 'getInfo', 'getBatteryInfo', 'getLanguageCode', 'getLanguageTag'],
+        events: [],
+    },
+    dialog: { operations: ['alert', 'prompt', 'confirm'], events: [] },
+    fileTransfer: {
+        operations: ['downloadFile', 'uploadFile', 'removeAllListeners'],
+        events: ['progress'],
+    },
+    fileViewer: {
+        operations: [
+            'openDocumentFromLocalPath',
+            'openDocumentFromResources',
+            'openDocumentFromUrl',
+            'previewMediaContentFromLocalPath',
+            'previewMediaContentFromResources',
+            'previewMediaContentFromUrl',
+        ],
+        events: [],
+    },
+    filesystem: {
+        operations: [
+            'checkPermissions',
+            'requestPermissions',
+            'readFile',
+            'readFileInChunks',
+            'writeFile',
+            'appendFile',
+            'deleteFile',
+            'mkdir',
+            'rmdir',
+            'readdir',
+            'getUri',
+            'stat',
+            'rename',
+            'copy',
+            'downloadFile',
+            'removeAllListeners',
+        ],
+        events: ['progress'],
+    },
+    geolocation: {
+        operations: [
+            'getCurrentPosition',
+            'watchPosition',
+            'clearWatch',
+            'checkPermissions',
+            'requestPermissions',
+        ],
+        events: [],
+    },
+    googleMaps: {
+        operations: [
+            'create',
+            'enableTouch',
+            'disableTouch',
+            'enableClustering',
+            'disableClustering',
+            'addTileOverlay',
+            'removeTileOverlay',
+            'addMarker',
+            'addMarkers',
+            'removeMarker',
+            'removeMarkers',
+            'addPolygons',
+            'removePolygons',
+            'addCircles',
+            'removeCircles',
+            'addPolylines',
+            'removePolylines',
+            'destroy',
+            'setCamera',
+            'getMapType',
+            'setMapType',
+            'enableIndoorMaps',
+            'enableTrafficLayer',
+            'enableAccessibilityElements',
+            'enableCurrentLocation',
+            'setPadding',
+            'getMapBounds',
+            'fitBounds',
+            'removeAllMapListeners',
+        ],
+        events: [
+            'boundsChanged',
+            'cameraIdle',
+            'cameraMoveStarted',
+            'clusterClick',
+            'clusterInfoWindowClick',
+            'infoWindowClick',
+            'mapClick',
+            'markerClick',
+            'polygonClick',
+            'circleClick',
+            'polylineClick',
+            'markerDragStart',
+            'markerDrag',
+            'markerDragEnd',
+            'myLocationButtonClick',
+            'myLocationClick',
+        ],
+    },
+    haptics: {
+        operations: [
+            'impact',
+            'notification',
+            'vibrate',
+            'selectionStart',
+            'selectionChanged',
+            'selectionEnd',
+        ],
+        events: [],
+    },
+    healthFitness: {
+        operations: [
+            'requestHealthPermissions',
+            'getData',
+            'getWorkoutData',
+            'writeData',
+            'getLastRecord',
+            'setBackgroundJob',
+            'deleteBackgroundJob',
+            'listBackgroundJobs',
+            'updateBackgroundJob',
+            'disconnectFromHealthConnect',
+            'openHealthConnect',
+        ],
+        events: [],
+    },
+    http: { operations: ['request', 'get', 'post', 'put', 'patch', 'delete'], events: [] },
+    inAppBrowser: {
+        operations: [
+            'openInWebView',
+            'openInSystemBrowser',
+            'openInExternalBrowser',
+            'close',
+            'removeAllListeners',
+        ],
+        events: ['browserPageLoaded', 'browserPageNavigationCompleted', 'browserClosed'],
+    },
+    keyboard: {
+        operations: [
+            'show',
+            'hide',
+            'setAccessoryBarVisible',
+            'setScroll',
+            'setStyle',
+            'setResizeMode',
+            'getResizeMode',
+            'removeAllListeners',
+        ],
+        events: ['keyboardWillShow', 'keyboardDidShow', 'keyboardWillHide', 'keyboardDidHide'],
+    },
+    localLlm: {
+        operations: [
+            'systemAvailability',
+            'download',
+            'prompt',
+            'endSession',
+            'generateImage',
+            'warmup',
+            'removeAllListeners',
+        ],
+        events: ['systemAvailabilityChange'],
+    },
+    localNotifications: {
+        operations: [
+            'schedule',
+            'update',
+            'getPending',
+            'registerActionTypes',
+            'cancel',
+            'cancelAll',
+            'areEnabled',
+            'getDeliveredNotifications',
+            'removeDeliveredNotifications',
+            'removeDeliveredNotificationsById',
+            'removeAllDeliveredNotifications',
+            'getByIds',
+            'getAll',
+            'createChannel',
+            'deleteChannel',
+            'listChannels',
+            'checkPermissions',
+            'requestPermissions',
+            'changeExactNotificationSetting',
+            'checkExactNotificationSetting',
+            'removeAllListeners',
+        ],
+        events: ['localNotificationReceived', 'localNotificationActionPerformed'],
+    },
+    motion: { operations: ['removeAllListeners'], events: ['accel', 'orientation'] },
+    network: { operations: ['getStatus', 'removeAllListeners'], events: ['networkStatusChange'] },
+    preferences: {
+        operations: ['configure', 'get', 'set', 'remove', 'clear', 'keys', 'migrate', 'removeOld'],
+        events: [],
+    },
+    privacyScreen: { operations: ['enable', 'disable', 'isEnabled'], events: [] },
+    pushNotifications: {
+        operations: [
+            'register',
+            'unregister',
+            'getDeliveredNotifications',
+            'removeDeliveredNotifications',
+            'removeAllDeliveredNotifications',
+            'createChannel',
+            'deleteChannel',
+            'listChannels',
+            'checkPermissions',
+            'requestPermissions',
+            'removeAllListeners',
+        ],
+        events: [
+            'registration',
+            'registrationError',
+            'pushNotificationReceived',
+            'pushNotificationActionPerformed',
+        ],
+    },
+    screenOrientation: {
+        operations: ['orientation', 'lock', 'unlock', 'removeAllListeners'],
+        events: ['screenOrientationChange'],
+    },
+    screenReader: {
+        operations: ['isEnabled', 'speak', 'removeAllListeners'],
+        events: ['stateChange'],
+    },
+    share: { operations: ['canShare', 'share'], events: [] },
+    splashScreen: { operations: ['show', 'hide'], events: [] },
+    statusBar: {
+        operations: ['setStyle', 'setBackgroundColor', 'show', 'hide', 'getInfo', 'setOverlaysWebView'],
+        events: ['statusBarVisibilityChanged', 'statusBarOverlayChanged'],
+    },
+    systemBars: { operations: ['setStyle', 'show', 'hide', 'setAnimation'], events: [] },
+    textZoom: { operations: ['get', 'getPreferred', 'set'], events: [] },
+    toast: { operations: ['show'], events: [] },
+};
 // Shell y remotos deben compartir una sola instancia de este token.
 export const NATIVE_CAPABILITIES = new InjectionToken('Open Mova native capabilities');
 export function injectNativeCapabilities() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mova/core",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Contratos y utilidades Angular compartidas de Open Mova",
   "license": "MIT",
   "author": "Open Mova contributors",
@@ -42,7 +42,9 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && npm run test:unit",
+    "test:unit": "node --test test/*.test.mjs"
   },
   "peerDependencies": {
     "@angular/core": "^21.2.23"