@de./sdk 1.0.5 → 2.1.0

package/dist/allend/MSI/index.js

@@ -0,0 +1,191 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const events_1 = require("events");
+const iframe_io_1 = __importDefault(require("iframe.io"));
+const Handles_1 = __importDefault(require("./Handles"));
+const Controls_1 = __importDefault(require("./Controls"));
+const Plugins_1 = __importDefault(require("./Plugins"));
+const token_1 = __importDefault(require("./token"));
+const SANDBOX_RULES = ['allow-scripts', 'allow-same-origin'], REQUIRED_FEATURES = ['geolocation'], REGISTERED_PLUGINS = {}, 
+// How long to wait for the gateway to embed, connect and bind
+LOAD_TIMEOUT = 30000, 
+/**
+ * Events the gateway is allowed to send us. Anything else is dropped by the
+ * transport before it reaches a listener.
+ */
+ALLOWED_INCOMING_EVENTS = [
+    'error',
+    'ready',
+    'pick:location',
+    'current:location',
+    'current:location:error',
+    'live:location:start',
+    'live:location:update',
+    'live:location:end',
+    'route',
+    'navigation:direction'
+];
+class MSI extends events_1.EventEmitter {
+    /**
+     * Mapbox control Client
+     *
+     * @param options - Initial options
+     */
+    constructor(options) {
+        super();
+        this.options = options;
+        /**
+         * `element` is optional on MapOptions because the React Native entry
+         * renders a component instead, but the web entry cannot mount without it.
+         */
+        if (!this.options.element)
+            throw new Error('Undefined HTML Element Container');
+        this.element = this.options.element;
+        // Throws when neither `accessToken` nor `getAccessToken` yields a token
+        (0, token_1.default)(this.options);
+        this.isDev = this.options.env == 'dev' || false;
+        this.baseURL = this.isDev
+            ? `http://${this.options.devHostname || 'localhost'}:4800`
+            : 'https://msi.dedot.io';
+        this.isConnected = false;
+    }
+    /**
+     * Listen to embedded iframe load
+     *
+     * @param e - DOM EventTarget object
+     */
+    onload(e) {
+        const iframe = e.target;
+        // Remove all previous listeners when iframe reloaded
+        this.chn && this.chn.removeListeners();
+        this.chn = new iframe_io_1.default({
+            type: 'WINDOW',
+            allowedIncomingEvents: ALLOWED_INCOMING_EVENTS,
+            maxMessagesPerSecond: 100,
+            connectionTimeout: 10000
+        });
+        this.chn.initiate(iframe.contentWindow, this.baseURL);
+        this.chn
+            .once('connect', () => {
+            var _a;
+            /**
+             * Resolve the token at bind time rather than reusing the one captured at
+             * construction, so a host supplying `getAccessToken` reconnects with a
+             * fresh token after a reload.
+             */
+            const { getAccessToken, ...config } = this.options;
+            (_a = this.chn) === null || _a === void 0 ? void 0 : _a.emit('bind', {
+                ...config,
+                accessToken: (0, token_1.default)(this.options),
+                origin: window.origin
+            }, (error) => {
+                if (error)
+                    return this.emit('error', new Error(error));
+                this.isConnected = true;
+            });
+        })
+            .on('error', (error) => this.emit('error', typeof error == 'object' ? error : new Error(error)))
+            .on('ready', () => {
+            this.emit('ready');
+            this.emit('loaded', this.chn);
+        });
+        // .on('event', ( _event: string, ...args: any[] ) => this.emit( _event, ...args ) )
+    }
+    /**
+     * Embed the gateway into a web UI using
+     * an iframe.
+     */
+    render() {
+        const container = document.getElementById(this.element);
+        if (!container)
+            throw new Error(`HTML Element Container <#${this.element}> Not Found`);
+        container.innerHTML = `<iframe id="de-sdk:map"
+                                    src="${this.baseURL}"
+                                    style="width:100%;height:100%;border:none;"
+                                    title="De.MSI Gateway"
+                                    importance="high"
+                                    referrerpolicy="origin"
+                                    allow="${REQUIRED_FEATURES.join()}"
+                                    sandbox="${SANDBOX_RULES.join(' ')}"></iframe>`;
+        const element = document.getElementById('de-sdk:map');
+        if (!element)
+            throw new Error('Unexpected Error Occured. Check HTML Element selector');
+        element.onload = this.onload.bind(this);
+    }
+    /**
+     * Surface a failure that happened while embedding the gateway
+     */
+    embedError(error) {
+        this.isConnected = false;
+        this.emit('error', error);
+    }
+    /**
+     * Initiate embedding of gateway into current UI by
+     * check network and remote gateway availability.
+     */
+    load(timeout = LOAD_TIMEOUT) {
+        return new Promise((resolve, reject) => {
+            /**
+             * Without this the promise stays pending forever whenever the iframe
+             * never loads or the host never completes `bind`.
+             */
+            const timer = setTimeout(() => {
+                this.isConnected = false;
+                reject(new Error('MSI gateway load timeout'));
+            }, timeout);
+            const initializeAPI = (chn) => {
+                clearTimeout(timer);
+                const 
+                /**
+                 * Manual controls of the map remotely
+                 */
+                controls = new Controls_1.default(chn, this.options), 
+                /**
+                 * Initialize handles
+                 */
+                handles = new Handles_1.default(chn, controls, this.options), 
+                /**
+                 * Initialize plugins & mount preloaded ones
+                 */
+                plugins = new Plugins_1.default(chn, handles, controls, this.options);
+                plugins.mount(REGISTERED_PLUGINS);
+                resolve({ controls, handles, plugins });
+            };
+            this
+                .once('loaded', initializeAPI)
+                .once('error', (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+            window
+                .fetch(this.baseURL, { mode: 'no-cors' })
+                // Only a genuine reachability failure is a network problem
+                .catch(() => { throw new Error('Internet network problem'); })
+                /**
+                 * Kept in a separate step so a `render` failure (Eg. a missing container
+                 * element) reports itself rather than being relabelled a network error.
+                 */
+                .then(() => this.render())
+                .catch(this.embedError.bind(this));
+        });
+    }
+    /**
+     * @return - Boolean that tells whether the gateway is
+     * loaded and ready for interaction
+     */
+    isReady() { return this.chn && this.isConnected; }
+    /**
+     * Extend the kit's functionalities
+     *
+     * @param name - Name of the plugin that will be later used to access the plugin object interface
+     * @param fn - Function containing the logic of the plugin
+     */
+    plugin(name, fn) {
+        REGISTERED_PLUGINS[name] = fn;
+    }
+}
+exports.default = MSI;
+//# sourceMappingURL=index.js.map

package/dist/allend/MSI/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/allend/MSI/index.ts"],"names":[],"mappings":"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"}

package/dist/allend/MSI/native.d.ts

@@ -0,0 +1,32 @@
+import type { MapOptions } from '../../types';
+import React from 'react';
+import Handles from './Handles';
+import Controls from './Controls';
+import Plugins, { type Plugin } from './Plugins';
+export interface MSIInterface {
+    controls: Controls;
+    handles: Handles;
+    plugins: Plugins;
+}
+export interface MSIProps extends MapOptions {
+    onReady?: () => void;
+    onError?: (error: Error) => void;
+    onLoaded?: (msi: MSIInterface) => void;
+    style?: any;
+}
+export interface MSIRef extends Partial<MSIInterface> {
+    isReady: () => boolean;
+    retry: () => void;
+}
+/**
+ * MSI gateway for React Native.
+ *
+ * Mirrors the web entry: same Controls/Handles/Plugins surface, same protocol,
+ * same event allowlist -- only the transport and the mounting differ.
+ */
+declare const _default: React.ForwardRefExoticComponent<MSIProps & React.RefAttributes<MSIRef>>;
+export default _default;
+/**
+ * Register a plugin to be mounted on every MSI instance.
+ */
+export declare function plugin<T>(name: string, fn: Plugin<T>): void;

package/dist/allend/MSI/native.js

@@ -0,0 +1,246 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin = plugin;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const react_native_webview_1 = require("react-native-webview");
+const webview_io_1 = __importDefault(require("webview.io"));
+const Handles_1 = __importDefault(require("./Handles"));
+const Controls_1 = __importDefault(require("./Controls"));
+const Plugins_1 = __importDefault(require("./Plugins"));
+const token_1 = __importDefault(require("./token"));
+const REGISTERED_PLUGINS = {}, 
+// Time allowed for the gateway to acknowledge `bind`
+BIND_TIMEOUT = 10000, 
+/**
+ * Events the gateway is allowed to send us. Anything else is dropped by the
+ * transport before it reaches a listener.
+ *
+ * Kept identical to the web entry: the gateway speaks one protocol, and the
+ * two entries differ only in transport.
+ */
+ALLOWED_INCOMING_EVENTS = [
+    'error',
+    'ready',
+    'pick:location',
+    'current:location',
+    'current:location:error',
+    'live:location:start',
+    'live:location:update',
+    'live:location:end',
+    'route',
+    'navigation:direction'
+];
+/**
+ * Forward the WebView's console into the React Native log.
+ *
+ * Injected only in dev: in production it turns every gateway log into a bridge
+ * message, which is pure overhead on the very traffic the map depends on.
+ */
+function injectedConsole() {
+    return `
+    (function(){
+      var forward = function( level ){
+        var original = console[ level ]
+        console[ level ] = function(){
+          var args = Array.prototype.slice.call( arguments )
+          try {
+            window.ReactNativeWebView.postMessage( JSON.stringify({
+              type: '__console',
+              level: level,
+              message: args.map( String ).join(' ')
+            }) )
+          }
+          catch( error ){}
+
+          original.apply( console, args )
+        }
+      }
+
+      forward('log')
+      forward('warn')
+      forward('error')
+    })();
+  `;
+}
+/**
+ * Resolve the gateway host for the running platform.
+ *
+ * A native app cannot reach the developer's machine on `localhost`: the Android
+ * emulator maps the host to 10.0.2.2, and a physical device needs the LAN
+ * address, supplied as `devHostname`.
+ */
+function gatewayURL({ env, devHostname }) {
+    if (env !== 'dev')
+        return 'https://msi.dedot.io';
+    const host = devHostname
+        || react_native_1.Platform.select({ android: '10.0.2.2', default: 'localhost' });
+    return `http://${host}:4800`;
+}
+/**
+ * MSI gateway for React Native.
+ *
+ * Mirrors the web entry: same Controls/Handles/Plugins surface, same protocol,
+ * same event allowlist -- only the transport and the mounting differ.
+ */
+exports.default = (0, react_1.forwardRef)((props, ref) => {
+    const webViewRef = (0, react_1.useRef)(null), wioRef = (0, react_1.useRef)(null), apiRef = (0, react_1.useRef)(null), isInitializedRef = (0, react_1.useRef)(false), [isConnected, setIsConnected] = (0, react_1.useState)(false), [isReady, setIsReady] = (0, react_1.useState)(false), baseURL = gatewayURL(props), 
+    /**
+     * Report an error once, in Error form, whatever shape the transport used.
+     */
+    reportError = (0, react_1.useCallback)((error) => {
+        var _a;
+        const normalized = error instanceof Error
+            ? error
+            : new Error(typeof error === 'string' ? error : (error === null || error === void 0 ? void 0 : error.error) || 'Unknown MSI error');
+        (_a = props.onError) === null || _a === void 0 ? void 0 : _a.call(props, normalized);
+    }, [props.onError]), initializeConnection = (0, react_1.useCallback)(() => {
+        if (!wioRef.current || !webViewRef.current)
+            return;
+        wioRef.current.initiate(webViewRef, baseURL);
+    }, [baseURL]);
+    // Expose the control surface to the host
+    (0, react_1.useImperativeHandle)(ref, () => ({
+        get controls() { var _a; return (_a = apiRef.current) === null || _a === void 0 ? void 0 : _a.controls; },
+        get handles() { var _a; return (_a = apiRef.current) === null || _a === void 0 ? void 0 : _a.handles; },
+        get plugins() { var _a; return (_a = apiRef.current) === null || _a === void 0 ? void 0 : _a.plugins; },
+        isReady: () => isConnected && isReady,
+        retry: () => {
+            isInitializedRef.current = false;
+            initializeConnection();
+        }
+    }), [isConnected, isReady, initializeConnection]);
+    (0, react_1.useEffect)(() => {
+        const wio = wioRef.current = new webview_io_1.default({
+            type: 'WEBVIEW',
+            debug: props.env === 'dev',
+            allowedIncomingEvents: ALLOWED_INCOMING_EVENTS,
+            maxMessagesPerSecond: 100,
+            connectionTimeout: 15000,
+            connectionPingInterval: 2000,
+            maxConnectionAttempts: 5,
+            autoReconnect: true,
+            heartbeatInterval: 30000
+        });
+        wio
+            .on('connect', async () => {
+            try {
+                /**
+                 * Resolve the token here rather than at mount, so a reconnect after a
+                 * backgrounded app or a dropped bridge binds with a current token.
+                 */
+                const { getAccessToken, onReady, onError, onLoaded, style, ...config } = props;
+                await wio.emitAsync('bind', {
+                    ...config,
+                    accessToken: (0, token_1.default)(props),
+                    origin: 'react-native'
+                }, BIND_TIMEOUT);
+                setIsConnected(true);
+            }
+            catch (error) {
+                reportError(error);
+            }
+        })
+            .on('ready', () => {
+            var _a;
+            setIsReady(true);
+            (_a = props.onReady) === null || _a === void 0 ? void 0 : _a.call(props);
+        })
+            .on('disconnect', () => {
+            setIsConnected(false);
+            setIsReady(false);
+        })
+            .on('reconnecting', () => {
+            setIsConnected(false);
+            setIsReady(false);
+        })
+            .on('connect_timeout', ({ attempts }) => reportError(new Error(`Failed to connect after ${attempts} attempts`)))
+            .on('reconnection_failed', ({ attempts }) => reportError(new Error(`Reconnection failed after ${attempts} attempts`)))
+            .on('error', (error) => {
+            // Rate limiting is throttling, not a failure of the map
+            if ((error === null || error === void 0 ? void 0 : error.type) === 'RATE_LIMIT_EXCEEDED')
+                return;
+            reportError(error);
+        });
+        /**
+         * Pause gateway work while backgrounded, and re-establish the bridge on
+         * resume -- iOS in particular tears down the WebView's socket.
+         */
+        const subscription = react_native_1.AppState.addEventListener('change', (state) => {
+            if (state === 'background') {
+                wio.emit('app:background');
+                return;
+            }
+            if (state === 'active') {
+                wio.emit('app:foreground');
+                !wio.isConnected() && initializeConnection();
+            }
+        });
+        return () => {
+            subscription.remove();
+            wio.disconnect();
+            apiRef.current = null;
+            isInitializedRef.current = false;
+        };
+    }, []);
+    // Build the control surface once the bridge is both connected and ready
+    (0, react_1.useEffect)(() => {
+        var _a;
+        if (isInitializedRef.current || !wioRef.current || !isConnected || !isReady)
+            return;
+        const chn = wioRef.current, controls = new Controls_1.default(chn, props), handles = new Handles_1.default(chn, controls, props), plugins = new Plugins_1.default(chn, handles, controls, props);
+        plugins.mount(REGISTERED_PLUGINS);
+        apiRef.current = { controls, handles, plugins };
+        isInitializedRef.current = true;
+        (_a = props.onLoaded) === null || _a === void 0 ? void 0 : _a.call(props, apiRef.current);
+    }, [isConnected, isReady]);
+    const onMessage = (event) => {
+        var _a;
+        // Console forwarding rides the same bridge; peel it off before WIO sees it
+        try {
+            const data = JSON.parse(event.nativeEvent.data);
+            if ((data === null || data === void 0 ? void 0 : data.type) === '__console') {
+                const message = `[MSI gateway] ${data.message}`;
+                switch (data.level) {
+                    case 'error':
+                        console.error(message);
+                        break;
+                    case 'warn':
+                        console.warn(message);
+                        break;
+                    default: console.debug(message);
+                }
+                return;
+            }
+        }
+        catch (error) {
+            // Not console traffic -- fall through to the transport
+        }
+        (_a = wioRef.current) === null || _a === void 0 ? void 0 : _a.handleMessage(event);
+    };
+    return ((0, jsx_runtime_1.jsx)(react_native_1.View, { style: [styles.container, props.style], children: (0, jsx_runtime_1.jsx)(react_native_webview_1.WebView, { ref: webViewRef, source: { uri: baseURL }, style: styles.webview, injectedJavaScript: `
+          ${props.env === 'dev' ? injectedConsole() : ''}
+          ${new webview_io_1.default({ type: 'WEBVIEW' }).getInjectedJavaScript()}
+        `, javaScriptEnabled: true, domStorageEnabled: true, geolocationEnabled: true, allowsInlineMediaPlayback: true, cacheEnabled: props.env !== 'dev', incognito: props.env === 'dev', androidLayerType: "hardware", allowsBackForwardNavigationGestures: false, bounces: false, scrollEnabled: false, originWhitelist: [baseURL], onMessage: onMessage, onLoadEnd: initializeConnection, onError: ({ nativeEvent }) => reportError(new Error((nativeEvent === null || nativeEvent === void 0 ? void 0 : nativeEvent.description) || 'WebView error')) }) }));
+});
+/**
+ * Register a plugin to be mounted on every MSI instance.
+ */
+function plugin(name, fn) {
+    REGISTERED_PLUGINS[name] = fn;
+}
+const styles = react_native_1.StyleSheet.create({
+    container: {
+        flex: 1,
+        backgroundColor: '#f0f0f0'
+    },
+    webview: {
+        flex: 1,
+        backgroundColor: 'transparent'
+    }
+});
+//# sourceMappingURL=native.js.map

package/dist/allend/MSI/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../src/allend/MSI/native.tsx"],"names":[],"mappings":"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"}

package/dist/allend/MSI/token.d.ts

@@ -0,0 +1,12 @@
+import type { MapOptions } from '../../types';
+/**
+ * Resolve the access token to bind the gateway with.
+ *
+ * `getAccessToken` wins when supplied, and is deliberately called at every bind
+ * rather than read once: a host that rotates tokens can hand back a fresh one
+ * on reconnect without the caller having to drive `controls.refreshToken()`.
+ *
+ * @param options - Map options carrying either form of the token
+ * @return - A non-empty access token
+ */
+export default function resolveAccessToken(options: MapOptions): string;

package/dist/allend/MSI/token.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = resolveAccessToken;
+/**
+ * Resolve the access token to bind the gateway with.
+ *
+ * `getAccessToken` wins when supplied, and is deliberately called at every bind
+ * rather than read once: a host that rotates tokens can hand back a fresh one
+ * on reconnect without the caller having to drive `controls.refreshToken()`.
+ *
+ * @param options - Map options carrying either form of the token
+ * @return - A non-empty access token
+ */
+function resolveAccessToken(options) {
+    var _a;
+    const token = ((_a = options.getAccessToken) === null || _a === void 0 ? void 0 : _a.call(options)) || options.accessToken;
+    if (!token)
+        throw new Error('Invalid Access Token');
+    return token;
+}
+//# sourceMappingURL=token.js.map

package/dist/allend/MSI/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../../src/allend/MSI/token.ts"],"names":[],"mappings":";;AAYA,qCAOC;AAjBD;;;;;;;;;GASG;AACH,SAAwB,kBAAkB,CAAE,OAAmB;;IAC7D,MAAM,KAAK,GAAG,CAAA,MAAA,OAAO,CAAC,cAAc,uDAAI,KAAI,OAAO,CAAC,WAAW,CAAA;IAE/D,IAAI,CAAC,KAAK;QACR,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IAEzC,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/allend/OTPAuth/index.d.ts

@@ -0,0 +1,77 @@
+import type { AccessOptions, UserSession } from '../../types/access';
+import AccessManager from '../Access';
+import { type Res } from '../../utils';
+export type SigninBody = {
+    phone: string;
+    /** Device fingerprint — an object or its JSON string. */
+    device: string | Record<string, any>;
+    /** ISO 3166-1 alpha-2. */
+    country?: string;
+};
+export type SigninResult = {
+    /** What the caller must do next — verification, or account creation first. */
+    next: string;
+    /**
+     * The OTP itself, returned only when de.auth runs with
+     * NODE_ENV=development. In every other environment the code arrives by SMS
+     * and this is absent, which is what makes unattended sign-in a dev-only
+     * capability rather than a hole.
+     */
+    testVCode?: number;
+};
+export type CreateAccountBody = {
+    phone: string;
+    agreeTerms: boolean | string;
+    firstName?: string;
+    lastName?: string;
+    photo?: string;
+    type?: string;
+    country?: string;
+    newsletters?: boolean | string;
+};
+export type VerifyResult = {
+    ctoken?: string;
+    deviceId?: string;
+    [key: string]: any;
+};
+export default class OTPAuth extends AccessManager {
+    constructor(access: AccessOptions);
+    /** Step 1 — sends the code. */
+    signin(body: SigninBody): Promise<Res<SigninResult>>;
+    /** Step 2 — exchanges the code for a session. */
+    verify(body: {
+        phone: string;
+        pvc: number;
+        new_phone?: string;
+    }): Promise<Res<VerifyResult>>;
+    /** Step 1a — for a phone de.auth has never seen. */
+    setAccount(body: CreateAccountBody): Promise<Res<{
+        next: string;
+    }>>;
+    resendSms(body: {
+        phone: string;
+    }): Promise<Res<void>>;
+    /** GET, with the scope in the querystring — not a POST. */
+    signout(querystring?: {
+        allDevices?: boolean | string;
+    }): Promise<Res<void>>;
+    /**
+     * Resolve the session to a user, and to a uid.
+     *
+     * `scope` is not optional in practice: without it de.auth falls back to the
+     * calling service's configured scope and then fails its own response
+     * validation. This is the same scope de.arch asks for.
+     */
+    active(session: UserSession, scope?: string): Promise<Res<{
+        uid: string;
+    }>>;
+    retrieve(querystring?: {
+        type?: string;
+    }): Promise<Res<{
+        user: any;
+    }>>;
+    search(querystring: Record<string, any>): Promise<Res<any>>;
+    updateProfile(body: Record<string, any>): Promise<Res<any>>;
+    updateSettings(body: Record<string, any>): Promise<Res<any>>;
+    remove(body: Record<string, any>): Promise<Res<void>>;
+}