@open-mova/core 0.1.9 → 0.2.2

package/README.md

@@ -8,8 +8,9 @@
 contratos, tipos y utilidades transversales que puedan utilizar la shell y los
 microfrontales.
 
-Actualmente define el contrato `NativeCapabilities` v1 para Device y Camera,
-el token de DI Angular y `injectNativeCapabilities()`. No depende de Capacitor.
+Define el contrato `NativeCapabilities` v1, el token de DI Angular y
+`injectNativeCapabilities()`. No depende de Capacitor: los plugins reales solo
+se instalan y se ejecutan dentro de la shell.
 
 ## Instalación
 
@@ -56,21 +57,35 @@ 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`; en el
-monorepo se instala por ruta local tras compilar la librería. 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
+comunes:
+
+- `isAvailable()` comprueba si el plugin está disponible en la plataforma.
+- `invoke(nombre, opciones)` ejecuta una operación del plugin.
+- `subscribe(evento, listener, contexto?)` registra un evento y devuelve un handle con
+  `remove()` para cancelarlo.
+
+`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 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`. 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
+propios de plataforma, como `Date` o `Blob`. Las operaciones más estables y
+habituales conservan métodos explícitos: `device.getInfo()`,
+`camera.takePhoto()` y `camera.choosePhoto()`.

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 { CameraCapability, DeviceCapability, DeviceDetails, NativeCapabilities, PhotoResult, } 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,24 +1,312 @@
 import { InjectionToken } 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 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>;
+}
+/** 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, options?: NativeOptions): Promise<NativeSubscription>;
+}
+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 {
+export interface DeviceCapability extends Capability<'device'> {
     getInfo(): Promise<DeviceDetails>;
 }
 export interface PhotoResult {
     readonly webPath?: string;
     readonly uri?: string;
 }
-export interface CameraCapability {
+export interface CameraCapability extends Capability<'camera'> {
     takePhoto(): Promise<PhotoResult>;
     choosePhoto(): Promise<PhotoResult | undefined>;
 }
+export interface ActionSheetCapability extends Capability<'actionSheet'> {
+}
+export interface AppCapability extends Capability<'app'> {
+}
+export interface AppLauncherCapability extends Capability<'appLauncher'> {
+}
+export interface BackgroundRunnerCapability extends Capability<'backgroundRunner'> {
+}
+export interface BarcodeScannerCapability extends Capability<'barcodeScanner'> {
+}
+export interface BrowserCapability extends Capability<'browser'> {
+}
+export interface CalendarCapability extends Capability<'calendar'> {
+}
+export interface ClipboardCapability extends Capability<'clipboard'> {
+}
+export interface ContactsCapability extends Capability<'contacts'> {
+}
+/** Cookies is bundled in @capacitor/core. */
+export interface CookiesCapability extends Capability<'cookies'> {
+}
+export interface DialogCapability extends Capability<'dialog'> {
+}
+export interface FileTransferCapability extends Capability<'fileTransfer'> {
+}
+export interface FileViewerCapability extends Capability<'fileViewer'> {
+}
+export interface FilesystemCapability extends Capability<'filesystem'> {
+}
+export interface GeolocationCapability extends Capability<'geolocation'> {
+}
+/** Google Maps keeps stateful map instances inside the shell. */
+export interface GoogleMapsCapability extends Capability<'googleMaps'> {
+}
+export interface HapticsCapability extends Capability<'haptics'> {
+}
+export interface HealthFitnessCapability extends Capability<'healthFitness'> {
+}
+/** HTTP is bundled in @capacitor/core. */
+export interface HttpCapability extends Capability<'http'> {
+}
+export interface InAppBrowserCapability extends Capability<'inAppBrowser'> {
+}
+export interface KeyboardCapability extends Capability<'keyboard'> {
+}
+/** Experimental Capacitor plugin. Always call isAvailable before invoking it. */
+export interface LocalLlmCapability extends Capability<'localLlm'> {
+}
+export interface LocalNotificationsCapability extends Capability<'localNotifications'> {
+}
+export interface MotionCapability extends Capability<'motion'> {
+}
+export interface NetworkCapability extends Capability<'network'> {
+}
+export interface PreferencesCapability extends Capability<'preferences'> {
+}
+export interface PrivacyScreenCapability extends Capability<'privacyScreen'> {
+}
+export interface PushNotificationsCapability extends Capability<'pushNotifications'> {
+}
+export interface ScreenOrientationCapability extends Capability<'screenOrientation'> {
+}
+export interface ScreenReaderCapability extends Capability<'screenReader'> {
+}
+export interface ShareCapability extends Capability<'share'> {
+}
+export interface SplashScreenCapability extends Capability<'splashScreen'> {
+}
+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 Capability<'systemBars'> {
+}
+export interface TextZoomCapability extends Capability<'textZoom'> {
+}
+export interface ToastCapability extends Capability<'toast'> {
+}
 export interface NativeCapabilities {
+    /** Version 1 remains compatible with the original Device and Camera contract. */
     readonly version: 1;
-    readonly device: DeviceCapability;
+    readonly actionSheet: ActionSheetCapability;
+    readonly app: AppCapability;
+    readonly appLauncher: AppLauncherCapability;
+    readonly backgroundRunner: BackgroundRunnerCapability;
+    readonly barcodeScanner: BarcodeScannerCapability;
+    readonly browser: BrowserCapability;
+    readonly calendar: CalendarCapability;
     readonly camera: CameraCapability;
+    readonly clipboard: ClipboardCapability;
+    readonly contacts: ContactsCapability;
+    readonly cookies: CookiesCapability;
+    readonly device: DeviceCapability;
+    readonly dialog: DialogCapability;
+    readonly fileTransfer: FileTransferCapability;
+    readonly fileViewer: FileViewerCapability;
+    readonly filesystem: FilesystemCapability;
+    readonly geolocation: GeolocationCapability;
+    readonly googleMaps: GoogleMapsCapability;
+    readonly haptics: HapticsCapability;
+    readonly healthFitness: HealthFitnessCapability;
+    readonly http: HttpCapability;
+    readonly inAppBrowser: InAppBrowserCapability;
+    readonly keyboard: KeyboardCapability;
+    readonly localLlm: LocalLlmCapability;
+    readonly localNotifications: LocalNotificationsCapability;
+    readonly motion: MotionCapability;
+    readonly network: NetworkCapability;
+    readonly preferences: PreferencesCapability;
+    readonly privacyScreen: PrivacyScreenCapability;
+    readonly pushNotifications: PushNotificationsCapability;
+    readonly screenOrientation: ScreenOrientationCapability;
+    readonly screenReader: ScreenReaderCapability;
+    readonly share: ShareCapability;
+    readonly splashScreen: SplashScreenCapability;
+    readonly statusBar: StatusBarCapability;
+    readonly systemBars: SystemBarsCapability;
+    readonly textZoom: TextZoomCapability;
+    readonly toast: ToastCapability;
 }
 export declare const NATIVE_CAPABILITIES: InjectionToken<NativeCapabilities>;
 export declare function injectNativeCapabilities(): NativeCapabilities;
+export {};

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.1.9",
+  "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"