@open-mova/core 0.1.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Open Mova contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/rgarciadelongoria/open-mova/main/assets/brand/open-mova-logo-title-rectangle.png" alt="Open Mova" width="720">
+</p>
+
+# Open Mova Core
+
+`open-mova-core` es la librería base del framework. Su objetivo es contener
+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.
+
+## Instalación
+
+El microfrontal y la shell deben usar una versión compatible de Angular.
+
+```bash
+npm install @open-mova/core
+```
+
+## Qué debe contener
+
+Puede contener, por ejemplo:
+
+- Contratos para servicios comunes.
+- Tipos de configuración compartidos.
+- Interfaces para capacidades nativas.
+- Utilidades que no pertenezcan a una aplicación concreta.
+
+## Qué no debe contener
+
+El core no debe incluir:
+
+- Componentes ni lógica de interfaz de una aplicación.
+- Dependencias de Capacitor.
+- Lógica de negocio de un proveedor.
+- Configuración de la shell.
+- Código específico de un microfrontal.
+
+La separación permite definir un contrato en el core y dejar que la shell
+aporte su implementación. Por ejemplo, el core podría definir una interfaz de
+almacenamiento y la shell implementarla más adelante con una API web o nativa.
+
+## Desarrollo
+
+Este proyecto es autónomo y tiene sus propias dependencias:
+
+```bash
+cd open-mova-core
+npm install
+npm run typecheck
+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.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { CameraCapability, DeviceCapability, DeviceDetails, NativeCapabilities, PhotoResult, } from './native.js';
+export { NATIVE_CAPABILITIES, injectNativeCapabilities } from './native.js';

package/dist/index.js

@@ -0,0 +1 @@
+export { NATIVE_CAPABILITIES, injectNativeCapabilities } from './native.js';

package/dist/native.d.ts

@@ -0,0 +1,24 @@
+import { InjectionToken } from '@angular/core';
+export interface DeviceDetails {
+    readonly model: string;
+    readonly platform: 'ios' | 'android' | 'web';
+    readonly osVersion: string;
+}
+export interface DeviceCapability {
+    getInfo(): Promise<DeviceDetails>;
+}
+export interface PhotoResult {
+    readonly webPath?: string;
+    readonly uri?: string;
+}
+export interface CameraCapability {
+    takePhoto(): Promise<PhotoResult>;
+    choosePhoto(): Promise<PhotoResult | undefined>;
+}
+export interface NativeCapabilities {
+    readonly version: 1;
+    readonly device: DeviceCapability;
+    readonly camera: CameraCapability;
+}
+export declare const NATIVE_CAPABILITIES: InjectionToken<NativeCapabilities>;
+export declare function injectNativeCapabilities(): NativeCapabilities;

package/dist/native.js

@@ -0,0 +1,10 @@
+import { InjectionToken, inject } from '@angular/core';
+// Shell y remotos deben compartir una sola instancia de este token.
+export const NATIVE_CAPABILITIES = new InjectionToken('Open Mova native capabilities');
+export function injectNativeCapabilities() {
+    const capabilities = inject(NATIVE_CAPABILITIES);
+    if (capabilities.version !== 1) {
+        throw new Error('La shell no ofrece el contrato nativo Open Mova v1.');
+    }
+    return capabilities;
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@open-mova/core",
+  "version": "0.1.9",
+  "description": "Contratos y utilidades Angular compartidas de Open Mova",
+  "license": "MIT",
+  "author": "Open Mova contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rgarciadelongoria/open-mova.git",
+    "directory": "open-mova-core"
+  },
+  "bugs": {
+    "url": "https://github.com/rgarciadelongoria/open-mova/issues"
+  },
+  "homepage": "https://github.com/rgarciadelongoria/open-mova#readme",
+  "keywords": [
+    "angular",
+    "capacitor",
+    "dependency-injection",
+    "microfrontends",
+    "open-mova"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "peerDependencies": {
+    "@angular/core": "^21.2.23"
+  },
+  "devDependencies": {
+    "@angular/core": "^21.2.23",
+    "typescript": "^5.9.3"
+  }
+}