@egen-civitas/esm-platform 0.0.0-stage → 1.2.0

package/dist/register-capabilities.test.js

@@ -0,0 +1,188 @@
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+import { afterEach, describe, expect, it } from 'vitest';
+import { hasCapability, setCapabilityResolver } from '@egen-civitas/esm-globals';
+import { PlatformError } from './errors';
+import { registerPlatformCapabilities } from './platform';
+describe('registerPlatformCapabilities (F2)', function() {
+    afterEach(function() {
+        setCapabilityResolver(null);
+        delete window.egenTarget;
+        delete window.egenHostBridge;
+    });
+    it('web : expose les capacités du navigateur au reste du framework et se résout', function() {
+        return _async_to_generator(function() {
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        return [
+                            4,
+                            expect(registerPlatformCapabilities()).resolves.toBeUndefined()
+                        ];
+                    case 1:
+                        _state.sent();
+                        expect(hasCapability('openExternal')).toBe(true);
+                        expect(hasCapability('secureStorage')).toBe(false); // jamais simulé en Web
+                        expect(hasCapability('biometric')).toBe(false);
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    it("natif sans Host : rejette INCOMPATIBLE mais n'expose AUCUNE capacité", function() {
+        return _async_to_generator(function() {
+            var error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        window.egenTarget = 'android';
+                        return [
+                            4,
+                            registerPlatformCapabilities().then(function() {
+                                return null;
+                            }, function(e) {
+                                return e;
+                            })
+                        ];
+                    case 1:
+                        error = _state.sent();
+                        expect(error).toBeInstanceOf(PlatformError);
+                        expect(error.code).toBe('INCOMPATIBLE');
+                        expect(hasCapability('openExternal')).toBe(false);
+                        expect(hasCapability('session')).toBe(false);
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+});

package/dist/registry.d.ts

@@ -0,0 +1,52 @@
+import type { BridgeClient } from './bridge/client.js';
+import type { CapabilityInterfaces } from './types.js';
+/**
+ * Registre des capacités : POINT UNIQUE qui décrit chacune d'elles (tâche C6). Tout ce qui énumère des capacités
+ * (gabarit « indisponible », handshake avec le Host, adaptateurs Web et natif, mocks) le lit ici au lieu de tenir sa
+ * propre liste. Voir la procédure « ajouter une capacité » dans le README du package.
+ */
+/**
+ * `async` : méthode qui retourne une `Promise` (absente ⇒ rejette `UNAVAILABLE`).
+ * `subscribe` : abonnement synchrone qui retourne une fonction de désabonnement (absent ⇒ lève `UNAVAILABLE`,
+ * faute de pouvoir rejeter).
+ */
+export type MethodKind = 'async' | 'subscribe';
+export interface CapabilityDefinition<T = Record<string, unknown>> {
+    /**
+     * Version de la capacité implémentée par ce framework. Le Host annonce la sienne au handshake (`{ v }`) : une
+     * capacité n'est disponible que si `v` du Host ≥ cette version.
+     */
+    version: number;
+    /** Toutes les méthodes publiques de la capacité. Exhaustif à la compilation : un oubli ne compile pas. */
+    methods: {
+        [M in keyof T]: MethodKind;
+    };
+    /**
+     * Adaptateur Web : fabrique appelée à chaque `getPlatform()`. Retourne `undefined` si le navigateur ne la supporte
+     * pas (la capacité reste alors absente). Ne retourne jamais de simulation de sécurité.
+     */
+    web?: () => Partial<T> | undefined;
+    /** Adaptateur natif : simple APPELANT du pont (aucune logique métier), branché sur le client du Host. */
+    native?: (client: BridgeClient) => Partial<T> | undefined;
+}
+/**
+ * Enregistre (ou remplace) une capacité. Les 9 capacités de la v1 sont enregistrées plus bas ; une capacité ajoutée
+ * ensuite passe par ici, depuis son propre fichier.
+ */
+export declare function registerCapability<K extends keyof CapabilityInterfaces>(name: K, definition: CapabilityDefinition<CapabilityInterfaces[K]>): void;
+/** Retire une capacité du registre (réservé aux tests qui en ajoutent une fictive). */
+export declare function unregisterCapability(name: string): boolean;
+export declare function getCapabilityDefinition(name: string): CapabilityDefinition | undefined;
+export declare function listCapabilityNames(): string[];
+/** Le nom est-il celui d'une capacité connue de ce framework ? (un Host peut en annoncer d'autres : elles sont ignorées) */
+export declare function isKnownCapability(name: string): boolean;
+/** Le Host annonce-t-il une version suffisante de cette capacité ? */
+export declare function isHostVersionSufficient(name: string, hostVersion: number | undefined): boolean;
+/** Adaptateurs Web de toutes les capacités du registre dont le navigateur est capable. */
+export declare function createWebCapabilities(): Partial<{
+    [K in keyof CapabilityInterfaces]: Partial<CapabilityInterfaces[K]>;
+}>;
+/** Adaptateurs natifs de toutes les capacités du registre, branchés sur le client de pont. */
+export declare function createNativeCapabilitiesFromRegistry(client: BridgeClient): Partial<{
+    [K in keyof CapabilityInterfaces]: Partial<CapabilityInterfaces[K]>;
+}>;

package/dist/registry.js

@@ -0,0 +1,101 @@
+import { createWebCamera } from './adapters/web/camera.js';
+import { createWebFiles } from './adapters/web/files.js';
+import { createWebLifecycle } from './adapters/web/lifecycle.js';
+import { createWebOpenExternal } from './adapters/web/open-external.js';
+import { createWebPermissions, isWebPermissionsAvailable } from './adapters/web/permissions.js';
+import { createWebSession } from './adapters/web/session.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const definitions = new Map();
+/**
+ * Enregistre (ou remplace) une capacité. Les 9 capacités de la v1 sont enregistrées plus bas ; une capacité ajoutée
+ * ensuite passe par ici, depuis son propre fichier.
+ */
+export function registerCapability(name, definition) {
+    definitions.set(name, definition);
+}
+/** Retire une capacité du registre (réservé aux tests qui en ajoutent une fictive). */
+export function unregisterCapability(name) {
+    return definitions.delete(name);
+}
+export function getCapabilityDefinition(name) {
+    return definitions.get(name);
+}
+export function listCapabilityNames() {
+    return [...definitions.keys()];
+}
+/** Le nom est-il celui d'une capacité connue de ce framework ? (un Host peut en annoncer d'autres : elles sont ignorées) */
+export function isKnownCapability(name) {
+    return definitions.has(name);
+}
+/** Le Host annonce-t-il une version suffisante de cette capacité ? */
+export function isHostVersionSufficient(name, hostVersion) {
+    const definition = definitions.get(name);
+    return definition !== undefined && hostVersion !== undefined && hostVersion >= definition.version;
+}
+/** Adaptateurs Web de toutes les capacités du registre dont le navigateur est capable. */
+export function createWebCapabilities() {
+    const capabilities = {};
+    for (const [name, definition] of definitions) {
+        const adapter = definition.web?.();
+        if (adapter) {
+            capabilities[name] = adapter;
+        }
+    }
+    return capabilities;
+}
+/** Adaptateurs natifs de toutes les capacités du registre, branchés sur le client de pont. */
+export function createNativeCapabilitiesFromRegistry(client) {
+    const capabilities = {};
+    for (const [name, definition] of definitions) {
+        const adapter = definition.native?.(client);
+        if (adapter) {
+            capabilities[name] = adapter;
+        }
+    }
+    return capabilities;
+}
+// ── Capacités v1 ─────────────────────────────────────────────────────────────────────────────
+// Les adaptateurs natifs (`native`) sont l'objet de la tâche C7 (une capacité à la fois, quand une app l'utilise, N9).
+registerCapability('session', {
+    version: 1,
+    methods: { getAuthorization: 'async', setTokens: 'async', refresh: 'async', clear: 'async' },
+    web: createWebSession,
+});
+registerCapability('secureStorage', {
+    version: 1,
+    methods: { get: 'async', set: 'async', remove: 'async' },
+    // Pas d'adaptateur Web : jamais de faux coffre dans le navigateur.
+});
+registerCapability('openExternal', {
+    version: 1,
+    methods: { open: 'async' },
+    web: createWebOpenExternal,
+});
+registerCapability('lifecycle', {
+    version: 1,
+    methods: { onResume: 'subscribe', onPause: 'subscribe' },
+    web: createWebLifecycle,
+});
+registerCapability('permissions', {
+    version: 1,
+    methods: { check: 'async', request: 'async' },
+    web: () => (isWebPermissionsAvailable() ? createWebPermissions() : undefined),
+});
+registerCapability('files', {
+    version: 1,
+    methods: { select: 'async', download: 'async' },
+    web: createWebFiles,
+});
+registerCapability('camera', {
+    version: 1,
+    methods: { capture: 'async' },
+    web: createWebCamera,
+});
+registerCapability('push', {
+    version: 1,
+    methods: { register: 'async', onMessage: 'subscribe' },
+});
+registerCapability('biometric', {
+    version: 1,
+    methods: { isAvailable: 'async', authenticate: 'async' },
+});