@iebh/tera-fy 2.0.21 → 2.2.0

package/dist/lib/terafy.bootstrapper.d.ts

@@ -0,0 +1,42 @@
+interface DeferredMethod {
+    method: string;
+    args: any[];
+}
+/**
+* Tera-Fy Bootstrapper Client
+* This class loads the "real" Tera-Fy from remote and mutates into it
+*
+* @class TeraFy
+*/
+export default class TeraFy {
+    settings: Record<string, any>;
+    /**
+    * Download the remote TERA-fy client, initalize it and mix it in with this class instance
+    *
+    * @param {Object} [options] Additional options to merge into `settings` via `set`
+    * @returns {Promise<TeraFy>} An eventual promise which will resovle with this terafy instance
+    */
+    init(options?: any): Promise<this>;
+    /**
+    * Methods to call post-init when the main TeraFyClient has loaded
+    * These are setup during construction
+    *
+    * @type {Array<Object>}
+    */
+    bootstrapperDeferredMethods: DeferredMethod[];
+    /**
+    * Go fetch a remote URL, inject it as a <script> element and resolve to the exported default
+    * This is a fix for the fact that regular import() can't accept URLs
+    *
+    * @param {String} url The URL to import
+    * @returns {*} The default, single export of the module
+    */
+    bootstrapperImport(url: string): Promise<any>;
+    /**
+    * TeraFyBootstrapper constructor
+    *
+    * @param {String} [options] Optional settings to merge
+    */
+    constructor(options?: any);
+}
+export {};

package/dist/lib/terafy.bootstrapper.js

@@ -0,0 +1,130 @@
+import { merge } from 'lodash-es';
+/**
+* Tera-Fy Bootstrapper Client
+* This class loads the "real" Tera-Fy from remote and mutates into it
+*
+* @class TeraFy
+*/
+export default class TeraFy {
+    /**
+    * Download the remote TERA-fy client, initalize it and mix it in with this class instance
+    *
+    * @param {Object} [options] Additional options to merge into `settings` via `set`
+    * @returns {Promise<TeraFy>} An eventual promise which will resovle with this terafy instance
+    */
+    init(options) {
+        // FIXME: Note this needs to point at the live site
+        let getUrl = (client) => `https://dev.tera-tools.com/api/tera-fy/${client}.js`;
+        return Promise.resolve()
+            .then(() => this.settings.clientType == 'esm' ?
+            this.bootstrapperImport(getUrl(this.settings.client))
+                .then(exported => typeof exported == 'function' ? exported : Promise.reject("Tera-fy import didn't return a class"))
+            : Promise.reject(`Unsupported TERA-fy clientType "${this.settings.clientType}"`))
+            .then((TeraClient) => {
+            let tc = new TeraClient();
+            if (!tc.mixin)
+                throw new Error('TERA-fy client doesnt expose a mixin() method');
+            tc.mixin(this, tc);
+            // Merge settings object
+            merge(this.settings, tc.settings, options || {}); // Use options passed to init here
+        })
+            .then(() => {
+            console.log('IAM', this);
+            if (!this.init || typeof this.init != 'function')
+                throw new Error('Newly mixed-in TERA-fy client doesnt expose a init() method');
+            if (!this.detectMode || typeof this.detectMode != 'function')
+                throw new Error('Newly mixed-in TERA-fy client doesnt expose a detectMode() method');
+        })
+            // Run all deferred methods as an sequencial promise chain
+            .then(() => this.bootstrapperDeferredMethods.reduce((chain, dm) => {
+            return chain.then(() => {
+                if (dm.method == 'use' && typeof dm.args[0] == 'string') { // Wrap `use(pluginClient:String,options:Object)` method to fetch plugin from remote
+                    console.log('TERA-FY DEFERRED-USE', dm.args[0]);
+                    return this.bootstrapperImport(getUrl(dm.args[0]))
+                        .then(exported => typeof exported == 'function' ? exported : Promise.reject("Tera-fy plugin import didn't return a class"))
+                        .then(mod => this.use(mod, ...dm.args.slice(1)));
+                }
+                else {
+                    console.log('TERA-FY DEFERRED-METHOD', dm);
+                    // Assuming the deferred method might return a promise or a value
+                    return Promise.resolve(this[dm.method].apply(this, dm.args));
+                }
+            });
+        }, Promise.resolve(undefined))) // Initialize reduce chain correctly
+            .then(() => { delete this.bootstrapperDeferredMethods; }) // Use type assertion for delete
+            .then(() => console.log('TYBS', 'Init'))
+            // Call the *actual* init method mixed in from the client
+            .then(() => this.init.call(this, options))
+            .then(() => this); // Ensure the promise chain resolves with `this`
+    }
+    /**
+    * Go fetch a remote URL, inject it as a <script> element and resolve to the exported default
+    * This is a fix for the fact that regular import() can't accept URLs
+    *
+    * @param {String} url The URL to import
+    * @returns {*} The default, single export of the module
+    */
+    bootstrapperImport(url) {
+        return new Promise((resolve, reject) => {
+            // Create a unique module ID
+            const moduleId = `installTFyBS${Math.random().toString(36).slice(2)}`;
+            // Add a wrapper module that will expose the class
+            const script = document.createElement('script');
+            script.type = 'module';
+            script.textContent = `
+				import mod from '${url}';
+				window['installMod${moduleId}'](mod);
+			`;
+            // Create cleanup function
+            let cleanup = () => {
+                // console.warn('CLEANUP', moduleId); // Keep console.warn commented out unless needed
+                delete window[`installMod${moduleId}`]; // Use type assertion for delete
+                if (script.parentNode) { // Check if script is still in DOM
+                    script.parentNode.removeChild(script);
+                }
+            };
+            // Create stub function to accept payload + quit
+            window[`installMod${moduleId}`] = (payload) => {
+                console.log('Accept module from', url, '=', payload);
+                resolve(payload);
+                cleanup();
+            };
+            // FIXME: Not sure if this is actually detecting errors? addEventListener instead maybe?
+            script.onerror = (event, source, lineno, colno, error) => {
+                reject(new Error(`Failed to load module from ${url} - ${error ? error.toString() : event}`));
+                cleanup();
+            };
+            // Append stub script element and quit
+            document.head.appendChild(script);
+        });
+    }
+    /**
+    * TeraFyBootstrapper constructor
+    *
+    * @param {String} [options] Optional settings to merge
+    */
+    constructor(options) {
+        this.settings = {
+            client: 'tera-fy', // Client name within https://tera-tools.com/api/tera-fy/<NAME>.js to load
+            clientType: 'esm',
+        };
+        /**
+        * Methods to call post-init when the main TeraFyClient has loaded
+        * These are setup during construction
+        *
+        * @type {Array<Object>}
+        */
+        this.bootstrapperDeferredMethods = [];
+        // Merge options if provided
+        if (options)
+            merge(this.settings, options);
+        // Map various methods to a deferred process so we execute these after init() has grabbed the actual TeraFyClient
+        ['set', 'setIfDev', 'use'].forEach(m => {
+            this[m] = (...args) => {
+                this.bootstrapperDeferredMethods.push({ method: m, args });
+                return this;
+            };
+        });
+    }
+}
+//# sourceMappingURL=terafy.bootstrapper.js.map

package/dist/lib/terafy.bootstrapper.js.map

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