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

package/dist/platform.test.js

@@ -0,0 +1,696 @@
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+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 _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+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 { getPlatform, hasHostBridge, isPlatformError, PlatformError } from './index';
+import { createMockHost, createMockPlatform } from './testing';
+/** Toutes les capacités v1 avec leurs méthodes (annexe 2). Ajouter une capacité oblige à compléter ce tableau. */ var ASYNC_METHODS = [
+    [
+        'session',
+        'getAuthorization'
+    ],
+    [
+        'session',
+        'setTokens'
+    ],
+    [
+        'session',
+        'refresh'
+    ],
+    [
+        'session',
+        'clear'
+    ],
+    [
+        'secureStorage',
+        'get'
+    ],
+    [
+        'secureStorage',
+        'set'
+    ],
+    [
+        'secureStorage',
+        'remove'
+    ],
+    [
+        'openExternal',
+        'open'
+    ],
+    [
+        'permissions',
+        'check'
+    ],
+    [
+        'permissions',
+        'request'
+    ],
+    [
+        'files',
+        'select'
+    ],
+    [
+        'files',
+        'download'
+    ],
+    [
+        'camera',
+        'capture'
+    ],
+    [
+        'push',
+        'register'
+    ],
+    [
+        'biometric',
+        'isAvailable'
+    ],
+    [
+        'biometric',
+        'authenticate'
+    ]
+];
+/** Abonnements : leur signature n'est pas une Promise, ils ne peuvent donc pas « rejeter » : ils lèvent. */ var SYNC_METHODS = [
+    [
+        'lifecycle',
+        'onResume'
+    ],
+    [
+        'lifecycle',
+        'onPause'
+    ],
+    [
+        'push',
+        'onMessage'
+    ]
+];
+var CAPABILITIES = [
+    'session',
+    'secureStorage',
+    'openExternal',
+    'lifecycle',
+    'permissions',
+    'files',
+    'camera',
+    'push',
+    'biometric'
+];
+var call = function call(platform, capability, method) {
+    return platform[capability][method]('x', 'y');
+};
+afterEach(function() {
+    var w = window;
+    delete w.egenTarget;
+    delete w.egenHostBridge;
+    delete w.Capacitor;
+});
+/**
+ * Le mock est testé contre LES MÊMES tests de contrat que l'implémentation (règle C9) : il ne peut pas diverger.
+ */ describe.each([
+    [
+        'getPlatform() (natif sans adaptateur)',
+        function() {
+            window.egenTarget = 'android';
+            return getPlatform();
+        }
+    ],
+    [
+        'createMockPlatform()',
+        function() {
+            return createMockPlatform();
+        }
+    ]
+])('contrat de capacités indisponibles — %s', function(_label, make) {
+    it('expose exactement les capacités v1 comme objets, et aucune autre', function() {
+        var platform = make();
+        var exposed = Object.keys(platform).filter(function(key) {
+            return ![
+                'environment',
+                'ready',
+                'has'
+            ].includes(key);
+        });
+        expect(exposed.sort()).toEqual(_to_consumable_array(CAPABILITIES).sort());
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = CAPABILITIES[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var name = _step.value;
+                expect(_type_of(platform[name])).toBe('object');
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    });
+    it('le tableau de méthodes couvre toutes les méthodes de chaque capacité', function() {
+        var platform = make();
+        var covered = _to_consumable_array(ASYNC_METHODS).concat(_to_consumable_array(SYNC_METHODS));
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            var _loop = function() {
+                var name = _step.value;
+                var methods = Object.keys(platform[name]).sort();
+                expect(covered.filter(function(param) {
+                    var _param = _sliced_to_array(param, 1), cap = _param[0];
+                    return cap === name;
+                }).map(function(param) {
+                    var _param = _sliced_to_array(param, 2), m = _param[1];
+                    return m;
+                }).sort()).toEqual(methods);
+            };
+            for(var _iterator = CAPABILITIES[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    });
+    it.each(CAPABILITIES)('has("%s") est faux : rien n’est simulé', function(name) {
+        expect(make().has(name)).toBe(false);
+    });
+    it.each(ASYNC_METHODS)('%s.%s rejette PlatformError UNAVAILABLE (jamais null, jamais Error générique)', function(cap, method) {
+        return _async_to_generator(function() {
+            var promise, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        promise = call(make(), cap, method);
+                        expect(promise).toBeInstanceOf(Promise);
+                        return [
+                            4,
+                            promise.then(function() {
+                                throw new Error('devait rejeter');
+                            }, function(e) {
+                                return e;
+                            })
+                        ];
+                    case 1:
+                        error = _state.sent();
+                        expect(isPlatformError(error)).toBe(true);
+                        expect(error).toMatchObject({
+                            name: 'PlatformError',
+                            code: 'UNAVAILABLE',
+                            capability: cap,
+                            method: method,
+                            retryable: false
+                        });
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    it.each(SYNC_METHODS)('%s.%s (abonnement) lève PlatformError UNAVAILABLE', function(cap, method) {
+        var platform = make();
+        expect(function() {
+            return call(platform, cap, method);
+        }).toThrow(PlatformError);
+        try {
+            call(platform, cap, method);
+        } catch (error) {
+            expect(error).toMatchObject({
+                code: 'UNAVAILABLE',
+                capability: cap,
+                method: method
+            });
+        }
+    });
+    it('les messages d’erreur ne contiennent pas les arguments (aucune fuite de jeton ou de clé)', function() {
+        return _async_to_generator(function() {
+            var error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        return [
+                            4,
+                            make().session.setTokens({
+                                access: 'SECRET-TOKEN-123'
+                            }).catch(function(e) {
+                                return e;
+                            })
+                        ];
+                    case 1:
+                        error = _state.sent();
+                        expect(error.message).not.toContain('SECRET-TOKEN-123');
+                        expect(String(error.stack)).not.toContain('SECRET-TOKEN-123');
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+});
+describe('getPlatform() — environnement et handshake', function() {
+    it('web par défaut : ready se résout immédiatement', function() {
+        return _async_to_generator(function() {
+            var platform;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        platform = getPlatform();
+                        expect(platform.environment).toBe('web');
+                        return [
+                            4,
+                            expect(platform.ready).resolves.toBeUndefined()
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    it.each([
+        'android',
+        'ios'
+    ])('%s sans Host : ready rejette INCOMPATIBLE « Host manquant »', function(target) {
+        return _async_to_generator(function() {
+            var platform, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        window.egenTarget = target;
+                        platform = getPlatform();
+                        expect(platform.environment).toBe(target);
+                        return [
+                            4,
+                            platform.ready.then(function() {
+                                throw new Error('devait rejeter');
+                            }, function(e) {
+                                return e;
+                            })
+                        ];
+                    case 1:
+                        error = _state.sent();
+                        expect(error).toBeInstanceOf(PlatformError);
+                        expect(error).toMatchObject({
+                            code: 'INCOMPATIBLE'
+                        });
+                        expect(error.message).toContain('Host manquant');
+                        expect(error.message).toContain(target);
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    it('natif avec un Host conforme : ready se résout après le handshake', function() {
+        return _async_to_generator(function() {
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        window.egenTarget = 'android';
+                        createMockHost().install();
+                        return [
+                            4,
+                            expect(getPlatform().ready).resolves.toBeUndefined()
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    it.each([
+        [
+            'sans subscribe',
+            {
+                send: function send() {}
+            }
+        ],
+        [
+            'sans send',
+            {
+                subscribe: function subscribe() {}
+            }
+        ],
+        [
+            'send non fonction',
+            {
+                send: 'x',
+                subscribe: function subscribe() {}
+            }
+        ],
+        [
+            'null',
+            null
+        ],
+        [
+            'chaîne',
+            'bridge'
+        ]
+    ])('natif avec un pont non conforme (%s) : ready rejette INCOMPATIBLE', function(_label, bridge) {
+        return _async_to_generator(function() {
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        window.egenTarget = 'ios';
+                        window.egenHostBridge = bridge;
+                        expect(hasHostBridge()).toBe(false);
+                        return [
+                            4,
+                            expect(getPlatform().ready).rejects.toMatchObject({
+                                code: 'INCOMPATIBLE'
+                            })
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    it('en Web, un pont présent ne change rien (la cible vient du build, pas de la détection)', function() {
+        return _async_to_generator(function() {
+            return _ts_generator(this, function(_state) {
+                window.egenHostBridge = {
+                    send: function send() {},
+                    subscribe: function subscribe() {}
+                };
+                expect(getPlatform().environment).toBe('web');
+                return [
+                    2
+                ];
+            });
+        })();
+    });
+    it('ne détecte ni Capacitor ni le User-Agent (N2, N4)', function() {
+        window.Capacitor = {
+            isNativePlatform: function isNativePlatform() {
+                return true;
+            }
+        };
+        Object.defineProperty(navigator, 'userAgent', {
+            value: 'Mozilla/5.0 (Linux; Android 14)',
+            configurable: true
+        });
+        expect(getPlatform().environment).toBe('web');
+    });
+    it('lire ready ne crée aucun rejet tant que personne ne l’attend', function() {
+        window.egenTarget = 'android';
+        // Aucune lecture de `ready` : construire la plateforme native sans Host ne doit rien rejeter.
+        expect(function() {
+            return getPlatform();
+        }).not.toThrow();
+    });
+});
+describe('createMockPlatform()', function() {
+    it('fournit seulement les capacités demandées ; le reste reste UNAVAILABLE', function() {
+        return _async_to_generator(function() {
+            var platform;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        platform = createMockPlatform({
+                            environment: 'android',
+                            capabilities: {
+                                secureStorage: {
+                                    get: function get(key) {
+                                        return _async_to_generator(function() {
+                                            return _ts_generator(this, function(_state) {
+                                                return [
+                                                    2,
+                                                    "valeur-de-".concat(key)
+                                                ];
+                                            });
+                                        })();
+                                    }
+                                }
+                            }
+                        });
+                        expect(platform.environment).toBe('android');
+                        expect(platform.has('secureStorage')).toBe(true);
+                        expect(platform.has('session')).toBe(false);
+                        return [
+                            4,
+                            expect(platform.secureStorage.get('k')).resolves.toBe('valeur-de-k')
+                        ];
+                    case 1:
+                        _state.sent();
+                        // Même dans une capacité fournie, une méthode non simulée reste UNAVAILABLE (pas de faux succès).
+                        return [
+                            4,
+                            expect(platform.secureStorage.set('k', 'v')).rejects.toMatchObject({
+                                code: 'UNAVAILABLE',
+                                method: 'set'
+                            })
+                        ];
+                    case 2:
+                        _state.sent();
+                        return [
+                            4,
+                            expect(platform.session.getAuthorization()).rejects.toMatchObject({
+                                code: 'UNAVAILABLE'
+                            })
+                        ];
+                    case 3:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    it('ready peut être contrôlé par le test', function() {
+        return _async_to_generator(function() {
+            var failing;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        failing = createMockPlatform({
+                            environment: 'ios',
+                            ready: Promise.reject(new PlatformError('TIMEOUT', 'x'))
+                        });
+                        return [
+                            4,
+                            expect(failing.ready).rejects.toMatchObject({
+                                code: 'TIMEOUT'
+                            })
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+});