@dynamic-labs/client 0.0.0-exp20240808.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Dynamic Labs, Inc.
+
+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,3 @@
+# Dynamic Client
+
+Welcome to Dynamic's client!

package/_virtual/_tslib.cjs

@@ -0,0 +1,36 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+exports.__awaiter = __awaiter;

package/_virtual/_tslib.js

@@ -0,0 +1,32 @@
+'use client'
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+export { __awaiter };

package/package.cjs

@@ -0,0 +1,8 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var version = "0.0.0-exp20240808.0";
+
+exports.version = version;

package/package.js

@@ -0,0 +1,4 @@
+'use client'
+var version = "0.0.0-exp20240808.0";
+
+export { version };

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@dynamic-labs/client",
+  "version": "0.0.0-exp20240808.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dynamic-labs/dynamic-auth.git",
+    "directory": "packages/client"
+  },
+  "description": "Core package for utilizing Dynamic's sdk",
+  "bugs": {
+    "url": "https://github.com/dynamic-labs/DynamicAuth/issues"
+  },
+  "homepage": "https://github.com/dynamic-labs/DynamicAuth/main/packages/client#readme",
+  "author": "Dynamic Labs, Inc.",
+  "license": "MIT",
+  "main": "./src/index.cjs",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./src/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@dynamic-labs/message-transport": "0.0.0-exp20240808.0",
+    "@vue/reactivity": "3.4.21"
+  },
+  "peerDependencies": {
+    "@dynamic-labs/logger": "0.0.0-exp20240808.0",
+    "@dynamic-labs/types": "0.0.0-exp20240808.0",
+    "eventemitter3": "5.0.1"
+  }
+}

package/src/client/client.cjs

@@ -0,0 +1,43 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var authModule = require('../modules/authModule/authModule.cjs');
+var networksModule = require('../modules/networksModule/networksModule.cjs');
+var sdkModule = require('../modules/sdkModule/sdkModule.cjs');
+var userInterfaceModule = require('../modules/userInterfaceModule/userInterfaceModule.cjs');
+var walletsModule = require('../modules/walletsModule/walletsModule.cjs');
+var Extendable = require('../utils/Extendable/Extendable.cjs');
+var core = require('./core/core.cjs');
+
+const baseClientExtensionName = 'base';
+/**
+ * Generates a basic client that allows interacting with Dynamic's SDK, which
+ * will be rendered inside a webview.
+ *
+ * It must be extended with the necessary Extensions that implement the services
+ * it will be used for.
+ */
+const createClient = (props) => {
+    const core$1 = core.createCore(props);
+    const baseExtendable = new Extendable.Extendable(core$1);
+    return baseExtendable.extend(() => {
+        core$1.declaredExtensionNames.push(baseClientExtensionName);
+        return {
+            /** Module that gives access over authentication state, such as the auth token and user */
+            auth: authModule.createAuthModule(core$1),
+            /** Module that provides all the networks configured */
+            networks: networksModule.createNetworksModule(core$1),
+            /** Module that gives insight over the state of the SDK */
+            sdk: sdkModule.createSdkModule(core$1),
+            /** Module that provide access to UI features */
+            ui: userInterfaceModule.createUserInterfaceModule(core$1),
+            /** Module that provides access to user's wallets */
+            wallets: walletsModule.createWalletsModule(core$1),
+        };
+    });
+};
+
+exports.baseClientExtensionName = baseClientExtensionName;
+exports.createClient = createClient;

package/src/client/client.d.ts

@@ -0,0 +1,29 @@
+import { Extendable } from '../utils/Extendable';
+export declare const baseClientExtensionName = "base";
+export type BaseClient = ReturnType<typeof createClient>;
+export type ClientProps = {
+    environmentId: string;
+    apiBaseUrl?: string;
+    appName?: string;
+    appLogoUrl?: string;
+    cssOverrides?: string;
+};
+/**
+ * Generates a basic client that allows interacting with Dynamic's SDK, which
+ * will be rendered inside a webview.
+ *
+ * It must be extended with the necessary Extensions that implement the services
+ * it will be used for.
+ */
+export declare const createClient: (props: ClientProps) => {
+    /** Module that gives access over authentication state, such as the auth token and user */
+    auth: import("../modules/authModule").AuthModule;
+    /** Module that provides all the networks configured */
+    networks: import("dist/packages/message-transport/src").StoreStateGetters<import("dist/packages/message-transport/src").NetworksModuleState> & Pick<import("eventemitter3").EventEmitter<import("dist/packages/message-transport/src").StoreStateEvents<import("dist/packages/message-transport/src").NetworksModuleState>, any>, "on" | "off" | "once">;
+    /** Module that gives insight over the state of the SDK */
+    sdk: import("../modules/sdkModule").SdkModule;
+    /** Module that provide access to UI features */
+    ui: import("../modules/userInterfaceModule/userInterfaceModule").UserInterfaceModule;
+    /** Module that provides access to user's wallets */
+    wallets: import("../modules/walletsModule").WalletsModule;
+} & Extendable;

package/src/client/client.js

@@ -0,0 +1,38 @@
+'use client'
+import { createAuthModule } from '../modules/authModule/authModule.js';
+import { createNetworksModule } from '../modules/networksModule/networksModule.js';
+import { createSdkModule } from '../modules/sdkModule/sdkModule.js';
+import { createUserInterfaceModule } from '../modules/userInterfaceModule/userInterfaceModule.js';
+import { createWalletsModule } from '../modules/walletsModule/walletsModule.js';
+import { Extendable } from '../utils/Extendable/Extendable.js';
+import { createCore } from './core/core.js';
+
+const baseClientExtensionName = 'base';
+/**
+ * Generates a basic client that allows interacting with Dynamic's SDK, which
+ * will be rendered inside a webview.
+ *
+ * It must be extended with the necessary Extensions that implement the services
+ * it will be used for.
+ */
+const createClient = (props) => {
+    const core = createCore(props);
+    const baseExtendable = new Extendable(core);
+    return baseExtendable.extend(() => {
+        core.declaredExtensionNames.push(baseClientExtensionName);
+        return {
+            /** Module that gives access over authentication state, such as the auth token and user */
+            auth: createAuthModule(core),
+            /** Module that provides all the networks configured */
+            networks: createNetworksModule(core),
+            /** Module that gives insight over the state of the SDK */
+            sdk: createSdkModule(core),
+            /** Module that provide access to UI features */
+            ui: createUserInterfaceModule(core),
+            /** Module that provides access to user's wallets */
+            wallets: createWalletsModule(core),
+        };
+    });
+};
+
+export { baseClientExtensionName, createClient };

package/src/client/core/core.cjs

@@ -0,0 +1,50 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var messageTransport$1 = require('@dynamic-labs/message-transport');
+var initializationModule = require('./modules/initializationModule/initializationModule.cjs');
+var manifestModule = require('./modules/manifestModule/manifestModule.cjs');
+
+const messageTransport = messageTransport$1.applyDefaultMessageOrigin({
+    defaultOrigin: 'host',
+    messageTransport: messageTransport$1.makeWaitForInitEvent({
+        bypassBlockIf: (message) => message.origin === 'webview',
+        initializeMessageType: messageTransport$1.sdkHasLoadedEventName,
+        messageTransport: messageTransport$1.createMessageTransport(),
+    }),
+});
+// Uncomment this to easily debug incoming/outgoing messages to webview
+// messageTransport.on((message) =>
+//   console.log('message', JSON.stringify(message, null, 2)),
+// );
+const initialization = initializationModule.createInitializationModule(messageTransport);
+const createCore = (props) => ({
+    /**
+     * Allows an extension to add its name to the list, such that
+     * other extensions are able to detect if it is present.
+     *
+     * Ex: ViemExtension adds "viem" to the list, and WagmiExtension later
+     * checks this list and throws an error if it doesn't find "viem" there.
+     */
+    declaredExtensionNames: [],
+    /**
+     * SDK initialization module handles the initialization error
+     */
+    initialization,
+    /**
+     * Manages the manifest of the host
+     */
+    manifest: manifestModule.createManifestModule(props, messageTransport, initialization),
+    /**
+     * Message transport that will be used to send and receive messages to the webview.
+     * Should preferably be used with createRequestChannel, rather than used directly.
+     *
+     * Note: Doesn't implement forwarding messages to/from webview yet.
+     * The user is expected to extend the client with an Extension that implements that.
+     */
+    messageTransport,
+});
+
+exports.createCore = createCore;

package/src/client/core/core.d.ts

@@ -0,0 +1,44 @@
+import { ClientProps } from '../client';
+/**
+ * Holds properties and methods used by client extensions, but that we don't
+ * want users to have access to.
+ */
+export type Core = ReturnType<typeof createCore>;
+export declare const createCore: (props: ClientProps) => {
+    /**
+     * Allows an extension to add its name to the list, such that
+     * other extensions are able to detect if it is present.
+     *
+     * Ex: ViemExtension adds "viem" to the list, and WagmiExtension later
+     * checks this list and throws an error if it doesn't find "viem" there.
+     */
+    declaredExtensionNames: string[];
+    /**
+     * SDK initialization module handles the initialization error
+     */
+    initialization: import("./modules/initializationModule/initializationModule").InitializationModule;
+    /**
+     * Manages the manifest of the host
+     */
+    manifest: {
+        setAppOrigin: (appOrigin: string) => string;
+        setPlatform: (platform: "browser" | "react-native" | "flutter") => "browser" | "react-native" | "flutter";
+        setRedirectUrl: (redirectUrl: string) => string;
+    };
+    /**
+     * Message transport that will be used to send and receive messages to the webview.
+     * Should preferably be used with createRequestChannel, rather than used directly.
+     *
+     * Note: Doesn't implement forwarding messages to/from webview yet.
+     * The user is expected to extend the client with an Extension that implements that.
+     */
+    messageTransport: {
+        unblock: () => void;
+        emit: (message: import("@dynamic-labs/message-transport").MessageTransportData) => void;
+        off: (callback: import("@dynamic-labs/message-transport").MessageTransportCallback) => void;
+        on: (callback: import("@dynamic-labs/message-transport").MessageTransportCallback) => void;
+    } & {
+        defaultOrigin: "webview" | "host";
+        emit: (message: import("@dynamic-labs/message-transport").MessageTransportDataOptionalOrigin) => void;
+    };
+};

package/src/client/core/core.js

@@ -0,0 +1,46 @@
+'use client'
+import { applyDefaultMessageOrigin, makeWaitForInitEvent, sdkHasLoadedEventName, createMessageTransport } from '@dynamic-labs/message-transport';
+import { createInitializationModule } from './modules/initializationModule/initializationModule.js';
+import { createManifestModule } from './modules/manifestModule/manifestModule.js';
+
+const messageTransport = applyDefaultMessageOrigin({
+    defaultOrigin: 'host',
+    messageTransport: makeWaitForInitEvent({
+        bypassBlockIf: (message) => message.origin === 'webview',
+        initializeMessageType: sdkHasLoadedEventName,
+        messageTransport: createMessageTransport(),
+    }),
+});
+// Uncomment this to easily debug incoming/outgoing messages to webview
+// messageTransport.on((message) =>
+//   console.log('message', JSON.stringify(message, null, 2)),
+// );
+const initialization = createInitializationModule(messageTransport);
+const createCore = (props) => ({
+    /**
+     * Allows an extension to add its name to the list, such that
+     * other extensions are able to detect if it is present.
+     *
+     * Ex: ViemExtension adds "viem" to the list, and WagmiExtension later
+     * checks this list and throws an error if it doesn't find "viem" there.
+     */
+    declaredExtensionNames: [],
+    /**
+     * SDK initialization module handles the initialization error
+     */
+    initialization,
+    /**
+     * Manages the manifest of the host
+     */
+    manifest: createManifestModule(props, messageTransport, initialization),
+    /**
+     * Message transport that will be used to send and receive messages to the webview.
+     * Should preferably be used with createRequestChannel, rather than used directly.
+     *
+     * Note: Doesn't implement forwarding messages to/from webview yet.
+     * The user is expected to extend the client with an Extension that implements that.
+     */
+    messageTransport,
+});
+
+export { createCore };

package/src/client/core/index.d.ts

@@ -0,0 +1 @@
+export * from './core';

package/src/client/core/modules/initializationModule/index.d.ts

@@ -0,0 +1 @@
+export { createInitializationModule } from './initializationModule';

package/src/client/core/modules/initializationModule/initializationModule.cjs

@@ -0,0 +1,33 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var reactivity = require('@vue/reactivity');
+var messageTransport = require('@dynamic-labs/message-transport');
+var logger = require('../../../../utils/logger/logger.cjs');
+
+const createInitializationModule = (messageTransport$1) => {
+    const consoleRequestChannel = messageTransport.createRequestChannel(messageTransport$1);
+    const state = reactivity.reactive({
+        error: null,
+    });
+    consoleRequestChannel.handle('error', (serializedError, { severity }) => {
+        const error = messageTransport.parseErrorFromTransport(serializedError);
+        if (severity === 'fatal') {
+            state.error = error;
+        }
+        logger.logger.error(error);
+    });
+    return {
+        get error() {
+            return state.error;
+        },
+        set error(error) {
+            state.error = error;
+            logger.logger.error(state.error);
+        },
+    };
+};
+
+exports.createInitializationModule = createInitializationModule;

package/src/client/core/modules/initializationModule/initializationModule.d.ts

@@ -0,0 +1,6 @@
+import { MessageTransportWithDefaultOrigin } from '@dynamic-labs/message-transport';
+export type InitializationModule = {
+    get error(): Error | null;
+    set error(error: Error);
+};
+export declare const createInitializationModule: (messageTransport: MessageTransportWithDefaultOrigin) => InitializationModule;

package/src/client/core/modules/initializationModule/initializationModule.js

@@ -0,0 +1,29 @@
+'use client'
+import { reactive } from '@vue/reactivity';
+import { createRequestChannel, parseErrorFromTransport } from '@dynamic-labs/message-transport';
+import { logger } from '../../../../utils/logger/logger.js';
+
+const createInitializationModule = (messageTransport) => {
+    const consoleRequestChannel = createRequestChannel(messageTransport);
+    const state = reactive({
+        error: null,
+    });
+    consoleRequestChannel.handle('error', (serializedError, { severity }) => {
+        const error = parseErrorFromTransport(serializedError);
+        if (severity === 'fatal') {
+            state.error = error;
+        }
+        logger.error(error);
+    });
+    return {
+        get error() {
+            return state.error;
+        },
+        set error(error) {
+            state.error = error;
+            logger.error(state.error);
+        },
+    };
+};
+
+export { createInitializationModule };

package/src/client/core/modules/manifestModule/createPartialManifest/createPartialManifest.cjs

@@ -0,0 +1,17 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _package = require('../../../../../../package.cjs');
+
+const createPartialManifest = ({ apiBaseUrl, environmentId, appLogoUrl, appName, cssOverrides, }) => ({
+    apiBaseUrl,
+    appLogoUrl,
+    appName,
+    clientVersion: _package.version,
+    cssOverrides,
+    environmentId,
+});
+
+exports.createPartialManifest = createPartialManifest;

package/src/client/core/modules/manifestModule/createPartialManifest/createPartialManifest.d.ts

@@ -0,0 +1,3 @@
+import type { ClientManifest } from '@dynamic-labs/message-transport';
+import { ClientProps } from '../../../../client';
+export declare const createPartialManifest: ({ apiBaseUrl, environmentId, appLogoUrl, appName, cssOverrides, }: ClientProps) => Partial<ClientManifest>;

package/src/client/core/modules/manifestModule/createPartialManifest/createPartialManifest.js

@@ -0,0 +1,13 @@
+'use client'
+import { version } from '../../../../../../package.js';
+
+const createPartialManifest = ({ apiBaseUrl, environmentId, appLogoUrl, appName, cssOverrides, }) => ({
+    apiBaseUrl,
+    appLogoUrl,
+    appName,
+    clientVersion: version,
+    cssOverrides,
+    environmentId,
+});
+
+export { createPartialManifest };

package/src/client/core/modules/manifestModule/createPartialManifest/index.d.ts

@@ -0,0 +1 @@
+export * from './createPartialManifest';

package/src/client/core/modules/manifestModule/index.d.ts

@@ -0,0 +1 @@
+export { createManifestModule } from './manifestModule';

package/src/client/core/modules/manifestModule/manifestModule.cjs

@@ -0,0 +1,36 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var messageTransport = require('@dynamic-labs/message-transport');
+var logger = require('../../../../utils/logger/logger.cjs');
+var createPartialManifest = require('./createPartialManifest/createPartialManifest.cjs');
+var validateManifest = require('./validateManifest/validateManifest.cjs');
+
+/**
+ * Manifest module handles the client manifest that will be requested by the webview
+ */
+const createManifestModule = (props, messageTransport$1, initializationModule) => {
+    const requestChannel = messageTransport.createRequestChannel(messageTransport$1);
+    const manifest = createPartialManifest.createPartialManifest(props);
+    requestChannel.handle('manifest', () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        try {
+            return validateManifest.validateManifest(manifest);
+        }
+        catch (error) {
+            logger.logger.error(error);
+            if (error instanceof Error)
+                initializationModule.error = error;
+            throw error;
+        }
+    }));
+    return {
+        setAppOrigin: (appOrigin) => (manifest.appOrigin = appOrigin),
+        setPlatform: (platform) => (manifest.platform = platform),
+        setRedirectUrl: (redirectUrl) => (manifest.redirectUrl = redirectUrl),
+    };
+};
+
+exports.createManifestModule = createManifestModule;

package/src/client/core/modules/manifestModule/manifestModule.d.ts

@@ -0,0 +1,11 @@
+import { ClientManifest, MessageTransportWithDefaultOrigin } from '@dynamic-labs/message-transport';
+import { ClientProps } from '../../../client';
+import { InitializationModule } from '../initializationModule/initializationModule';
+/**
+ * Manifest module handles the client manifest that will be requested by the webview
+ */
+export declare const createManifestModule: (props: ClientProps, messageTransport: MessageTransportWithDefaultOrigin, initializationModule: InitializationModule) => {
+    setAppOrigin: (appOrigin: string) => string;
+    setPlatform: (platform: ClientManifest['platform']) => "browser" | "react-native" | "flutter";
+    setRedirectUrl: (redirectUrl: string) => string;
+};

package/src/client/core/modules/manifestModule/manifestModule.js

@@ -0,0 +1,32 @@
+'use client'
+import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { createRequestChannel } from '@dynamic-labs/message-transport';
+import { logger } from '../../../../utils/logger/logger.js';
+import { createPartialManifest } from './createPartialManifest/createPartialManifest.js';
+import { validateManifest } from './validateManifest/validateManifest.js';
+
+/**
+ * Manifest module handles the client manifest that will be requested by the webview
+ */
+const createManifestModule = (props, messageTransport, initializationModule) => {
+    const requestChannel = createRequestChannel(messageTransport);
+    const manifest = createPartialManifest(props);
+    requestChannel.handle('manifest', () => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            return validateManifest(manifest);
+        }
+        catch (error) {
+            logger.error(error);
+            if (error instanceof Error)
+                initializationModule.error = error;
+            throw error;
+        }
+    }));
+    return {
+        setAppOrigin: (appOrigin) => (manifest.appOrigin = appOrigin),
+        setPlatform: (platform) => (manifest.platform = platform),
+        setRedirectUrl: (redirectUrl) => (manifest.redirectUrl = redirectUrl),
+    };
+};
+
+export { createManifestModule };

package/src/client/core/modules/manifestModule/validateManifest/index.d.ts

@@ -0,0 +1 @@
+export * from './validateManifest';

package/src/client/core/modules/manifestModule/validateManifest/validateManifest.cjs

@@ -0,0 +1,31 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Maps each required field of the client manifest to an error message that explains
+ * what the customer can do if his app runs into the issue where this field is missing from his manifest.
+ */
+const mandatoryFields = {
+    clientVersion: "We were unable to retrieve the Dynamic Client's version from your app. Please contact us about this.",
+    environmentId: 'You must provide an environment id to the Dynamic Client.',
+    platform: 'Missing platform specific extension, like BrowserExtension or ReactNativeExtension. See how to setup Dynamic Client in our docs for help.',
+    redirectUrl: 'Missing platform specific extension, like BrowserExtension or ReactNativeExtension. See how to setup Dynamic Client in our docs for help.',
+};
+const validateManifest = (partialManifest) => {
+    /**
+     * If any of these fields are missing, we show the user an error message.
+     * You should map to each required field a description of what the user can do to fix this issue.
+     *
+     * And if you add a new required field to DynamicClient, TS will automatically force you to
+     * also include a description here :)
+     */
+    for (const [field, description] of Object.entries(mandatoryFields))
+        if (partialManifest[field] === undefined)
+            throw new Error(`Missing client manifest field "${field}": ${description}`);
+    return partialManifest;
+};
+
+exports.mandatoryFields = mandatoryFields;
+exports.validateManifest = validateManifest;