@shopify/ui-extensions-server-kit 0.0.0-snapshot-20240814205424

package/CHANGELOG.md

@@ -0,0 +1,127 @@
+# @shopify/ui-extensions-server-kit
+
+## 0.0.0-snapshot-20240814205424
+
+### Patch Changes
+
+- 40a7b1229: CLI now better handles 429 rate limiting for large projects
+
+## 5.2.0
+
+### Minor Changes
+
+- 1d6fe3475: Increase minimum Node version to 18
+- 0896e62b1: Versioned app config support
+
+## 5.1.0
+
+### Minor Changes
+
+- 84fddcf69: Added support for optional localizable description to UI extensions dev and deploy
+
+## 5.0.0
+
+### Major Changes
+
+- ec90885f4: Drop support for setting a translatable label at the extension point level.
+  The translatable merchant-facing string should be set at using the extension's name instead.
+
+### Minor Changes
+
+- b8e11a77d: @shopify/ui-extensions-server-kit enable subscribing to connection open/close events
+
+### Patch Changes
+
+- 8519a9701: Update helper for return the surface for each extension target to account for new target names
+
+## 4.2.1
+
+### Patch Changes
+
+- ae1e35d42: Add missing apiVersion prop to the UIExtension interface
+
+## 4.2.0
+
+### Minor Changes
+
+- 2c6e98652: Enable ui-extensions-server-kit to send translated strings for the requested locales
+
+## 4.1.0
+
+### Minor Changes
+
+- 335a96a24: Improved dev console with new UX & functionality. New functionality: Preview app link and QRCode, better post purchase extension instructions, copy button for all preview links, support for upcoming UI extension changes
+
+## 4.0.1
+
+### Patch Changes
+
+- 10b86c459: Expose missing API types
+
+## 4.0.0
+
+### Major Changes
+
+- feee9215: Remove APIClient from ui-extensions-server-kit. APIClient is not used by the package and although it's exposed externally, all its functionality is also handled by ExtensionServerClient
+
+## 3.25.0
+
+## 3.24.1
+
+## 3.24.0
+
+## 3.23.0
+
+## 3.22.1
+
+## 3.22.0
+
+## 3.21.0
+
+## 3.20.1
+
+## 3.20.0
+
+## 3.19.0
+
+## 3.18.0
+
+## 3.17.0
+
+## 3.16.3
+
+## 3.16.2
+
+## 3.16.1
+
+## 3.16.0
+
+## 3.15.0
+
+## 3.14.0
+
+## 3.13.1
+
+## 3.13.0
+
+## 3.12.0
+
+## 3.11.0
+
+### Patch Changes
+
+- 4fca2930: Fix prepack and private configurations
+
+## 3.10.1
+
+## 3.10.0
+
+## 3.9.2
+
+## 3.9.1
+
+## 3.9.0
+
+## 3.8.0
+
+## 3.7.1

package/README.md

@@ -0,0 +1,74 @@
+<img src="https://github.com/Shopify/cli/blob/main/assets/logo.png?raw=true" width="150"/>
+
+# Shopify CLI
+<a href="http://twitter.com/ShopifyDevs"><img src="https://img.shields.io/twitter/follow/ShopifyDevs?style=flat-square" alt="Twitter Followers"></a>
+<img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License">
+<a href="https://github.com/Shopify/cli/actions/workflows/shopify-cli.yml">![badge](https://github.com/Shopify/cli/actions/workflows/shopify-cli.yml/badge.svg)</a>
+
+With the Shopify command line interface (Shopify CLI 3.0), you can:
+- initialize, build, dev, and deploy Shopify apps, extensions, functions and themes
+- build custom storefronts and manage their hosting
+
+Learn more in the [commands docs](./packages/cli/README.md#commands).
+
+<p>&nbsp;</p>
+
+### Before you begin ###
+
+Install the latest version of  [Node.js](https://nodejs.org/en/download/) and [npm](https://docs.npmjs.com/getting-started) (or another package manager of your choice).
+
+<p>&nbsp;</p>
+
+## Developing apps with Shopify CLI
+
+When you’re building a Shopify app, you can initialize your project using your preferred package manager. A single command will install all the dependencies you need — including Shopify CLI itself.
+
+Initialize your project using one of the following commands:
+- `npm init @shopify/app@latest` (installed by default with Node)
+- `pnpm create @shopify/create-app@latest`
+- `yarn create @shopify/app`
+- `bun create @shopify/app@latest` (experimental)
+
+Learn more in the docs: [Create an app](https://shopify.dev/apps/getting-started/create)
+
+<p>&nbsp;</p>
+
+## Developing themes with Shopify CLI
+
+To work with themes, the CLI needs to be installed globally with:
+
+- `npm install -g @shopify/cli @shopify/theme`
+
+You can also use do it through Homebrew on macOS: `brew tap shopify/shopify && brew install shopify-cli`
+
+Learn more in the docs: [Shopify CLI for themes](https://shopify.dev/docs/themes/tools/cli)
+
+<p>&nbsp;</p>
+
+## Developing Hydrogen custom storefronts with Shopify CLI ##
+
+The Hydrogen code lives here: https://github.com/Shopify/hydrogen/tree/main/packages/cli
+
+Learn more in the docs: [Shopify CLI for Hydrogen storefronts](https://shopify.dev/docs/custom-storefronts/hydrogen/cli)
+
+<p>&nbsp;</p>
+
+## Help 🖐
+
+If you encounter issues using the CLI or have feedback you'd like to share with us, below are some options:
+
+- [Open a GitHub issue](https://github.com/Shopify/cli/issues) - To report bugs or request new features, open an issue in the Shopify CLI repository
+- [Shopify Community Forums](https://community.shopify.com/) - Visit our forums to connect with the community and learn more about Shopify CLI development
+- [CLI Documentation - Apps](https://shopify.dev/apps/tools/cli) - To view CLI documentation for app development
+- [CLI Documentation - Themes](https://shopify.dev/themes/tools/cli) - To view CLI documentation for theme development
+- [CLI Documentation - Hydrogen](https://shopify.dev/custom-storefronts/tools/cli) - To view CLI documentation for Hydrogen (custom storefront) development
+
+## Contribute 👩🏽‍💻
+
+If you'd like to contribute to the project, check out the [contributors docs](/docs) and the [steps to get started](/docs/cli/get-started.md).
+
+<p>&nbsp;</p>
+
+## References
+
+- [oclif](https://oclif.io/)

package/dist/ExtensionServerClient/ExtensionServerClient.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("../i18n.cjs.js"),E=require("../utilities/isValidSurface.cjs.js"),f=require("../utilities/isUIExtension.cjs.js");class g{constructor(n={}){this.EVENT_THAT_WILL_MUTATE_THE_SERVER=["update"],this.listeners={},this.connectionListeners={close:new Set,open:new Set},this.connected=!1,this.uiExtensionsByUuid={},this.id=(Math.random()+1).toString(36).substring(7),this.options=p({...n,connection:{automaticConnect:!0,protocols:[],...n.connection??{}}}),this.setupConnection(this.options.connection.automaticConnect)}connect(n={connection:{}}){const t=S(this.options,n);return JSON.stringify(t)!==JSON.stringify(this.options)&&(this.options=t,this.setupConnection(!0)),()=>{this.closeConnection()}}on(n,t){return this.listeners[n]||(this.listeners[n]=new Set),this.listeners[n].add(t),()=>this.listeners[n].delete(t)}persist(n,t){var s,e,i;if(this.EVENT_THAT_WILL_MUTATE_THE_SERVER.includes(n))return this.options.locales?((e=t.extensions)==null||e.forEach(o=>{h.TRANSLATED_KEYS.forEach(a=>{var c;f.isUIExtension(o)&&((c=o.extensionPoints)==null||c.forEach(l=>{delete l[a]})),delete o[a]})}),(i=this.connection)==null?void 0:i.send(JSON.stringify({event:n,data:t}))):(s=this.connection)==null?void 0:s.send(JSON.stringify({event:n,data:t}));console.warn('You tried to use "persist" with a dispatch event. Please use the "emit" method instead.')}emit(...n){var e;const[t,s]=n;if(this.EVENT_THAT_WILL_MUTATE_THE_SERVER.includes(t))return console.warn(`You tried to use "emit" with a the "${t}" event. Please use the "persist" method instead to persist changes to the server.`);(e=this.connection)==null||e.send(JSON.stringify({event:"dispatch",data:{type:t,payload:s}}))}onConnection(n,t){return this.connectionListeners[n].add(t),()=>this.connectionListeners[n].delete(t)}initializeConnection(){var n;this.connection&&(this.connection.addEventListener("open",t=>{this.connected=!0,this.connectionListeners.open.forEach(s=>s(t))}),this.connection.addEventListener("close",t=>{this.connected=!1,this.connectionListeners.close.forEach(s=>s(t))}),(n=this.connection)==null||n.addEventListener("message",t=>{var s,e;try{const{event:i,data:o}=JSON.parse(t.data);if(i==="dispatch"){const{type:c,payload:l}=o;(s=this.listeners[c])==null||s.forEach(u=>u(l));return}const a=o.extensions?T(o.extensions,this.options.surface):o.extensions;(e=this.listeners[i])==null||e.forEach(c=>{c({...o,extensions:this._getLocalizedExtensions(a)})})}catch(i){console.error("[ExtensionServer] Something went wrong while parsing a server message:",i instanceof Error?i.message:i)}}))}setupConnection(n=!0){this.options.connection.url&&n&&(this.closeConnection(),this.connection=new WebSocket(this.options.connection.url,this.options.connection.protocols),this.initializeConnection())}closeConnection(){var n;this.connected&&((n=this.connection)==null||n.close())}_getLocalizedExtensions(n){return n==null?void 0:n.map(t=>{var a,c,l,u,d;if(!this.options.locales||!f.isUIExtension(t))return t;const e=((c=(a=this.uiExtensionsByUuid[t.uuid])==null?void 0:a.localization)==null?void 0:c.lastUpdated)!==((l=t.localization)==null?void 0:l.lastUpdated)?h.getFlattenedLocalization(t.localization,this.options.locales):((u=this.uiExtensionsByUuid[t.uuid])==null?void 0:u.localization)||t.localization,i=e&&h.isFlattenedTranslations(e)?JSON.parse(e.translations):e,o={...t,localization:e,name:i&&t.name.startsWith("t:")?this._getLocalizedValue(i,t.name):t.name,...t.description&&{description:i&&((d=t.description)!=null&&d.startsWith("t:"))?this._getLocalizedValue(i,t.description):t.description}};return this.uiExtensionsByUuid[t.uuid]={...o,extensionPoints:this._getLocalizedExtensionPoints(e,o)},this.uiExtensionsByUuid[t.uuid]})}_getLocalizedExtensionPoints(n,{extensionPoints:t,name:s,description:e}){return!n||!h.isFlattenedTranslations(n)?t:t==null?void 0:t.map(i=>({...i,localization:n,name:s,...e&&{description:e}}))}_getLocalizedValue(n,t){const s=t.replace("t:","");return n[s]||t}}function S(r,n){return p({...r,...n,connection:{...r.connection,...n.connection}})}function p(r){return E.isValidSurface(r.surface)||delete r.surface,r}function T(r,n){return n?r.filter(t=>t.surface===n?!0:Array.isArray(t.extensionPoints)?t.extensionPoints.filter(i=>typeof i=="string"?!1:i.surface===n).length>0:!1):r}exports.ExtensionServerClient=g;

package/dist/ExtensionServerClient/ExtensionServerClient.d.ts

@@ -0,0 +1,28 @@
+import { DeepPartial } from '../types';
+export declare class ExtensionServerClient implements ExtensionServer.Client {
+    id: string;
+    connection: WebSocket;
+    options: ExtensionServer.Options;
+    protected EVENT_THAT_WILL_MUTATE_THE_SERVER: string[];
+    protected listeners: {
+        [key: string]: Set<any>;
+    };
+    protected connectionListeners: {
+        close: Set<any>;
+        open: Set<any>;
+    };
+    protected connected: boolean;
+    private uiExtensionsByUuid;
+    constructor(options?: DeepPartial<ExtensionServer.Options>);
+    connect(options?: ExtensionServer.Options): () => void;
+    on<TEvent extends keyof ExtensionServer.InboundEvents>(event: TEvent, listener: (payload: ExtensionServer.InboundEvents[TEvent]) => void): () => void;
+    persist<TEvent extends keyof ExtensionServer.OutboundPersistEvents>(event: TEvent, data: ExtensionServer.OutboundPersistEvents[TEvent]): void;
+    emit<TEvent extends keyof ExtensionServer.DispatchEvents>(...args: ExtensionServer.EmitArgs<TEvent>): void;
+    onConnection<TEvent extends keyof typeof this.connectionListeners>(event: TEvent, listener: (event: Event) => void): () => void;
+    protected initializeConnection(): void;
+    protected setupConnection(connectWebsocket?: boolean): void;
+    protected closeConnection(): void;
+    private _getLocalizedExtensions;
+    private _getLocalizedExtensionPoints;
+    private _getLocalizedValue;
+}

package/dist/ExtensionServerClient/ExtensionServerClient.es.js

@@ -0,0 +1,133 @@
+import { TRANSLATED_KEYS as E, getFlattenedLocalization as g, isFlattenedTranslations as d } from "../i18n.es.js";
+import { isValidSurface as m } from "../utilities/isValidSurface.es.js";
+import { isUIExtension as f } from "../utilities/isUIExtension.es.js";
+class z {
+  constructor(n = {}) {
+    this.EVENT_THAT_WILL_MUTATE_THE_SERVER = ["update"], this.listeners = {}, this.connectionListeners = { close: /* @__PURE__ */ new Set(), open: /* @__PURE__ */ new Set() }, this.connected = !1, this.uiExtensionsByUuid = {}, this.id = (Math.random() + 1).toString(36).substring(7), this.options = p({
+      ...n,
+      connection: {
+        automaticConnect: !0,
+        protocols: [],
+        ...n.connection ?? {}
+      }
+    }), this.setupConnection(this.options.connection.automaticConnect);
+  }
+  connect(n = { connection: {} }) {
+    const t = S(this.options, n);
+    return JSON.stringify(t) !== JSON.stringify(this.options) && (this.options = t, this.setupConnection(!0)), () => {
+      this.closeConnection();
+    };
+  }
+  on(n, t) {
+    return this.listeners[n] || (this.listeners[n] = /* @__PURE__ */ new Set()), this.listeners[n].add(t), () => this.listeners[n].delete(t);
+  }
+  persist(n, t) {
+    var s, e, i;
+    if (this.EVENT_THAT_WILL_MUTATE_THE_SERVER.includes(n))
+      return this.options.locales ? ((e = t.extensions) == null || e.forEach((o) => {
+        E.forEach((a) => {
+          var c;
+          f(o) && ((c = o.extensionPoints) == null || c.forEach((h) => {
+            delete h[a];
+          })), delete o[a];
+        });
+      }), (i = this.connection) == null ? void 0 : i.send(JSON.stringify({ event: n, data: t }))) : (s = this.connection) == null ? void 0 : s.send(JSON.stringify({ event: n, data: t }));
+    console.warn('You tried to use "persist" with a dispatch event. Please use the "emit" method instead.');
+  }
+  emit(...n) {
+    var e;
+    const [t, s] = n;
+    if (this.EVENT_THAT_WILL_MUTATE_THE_SERVER.includes(t))
+      return console.warn(
+        `You tried to use "emit" with a the "${t}" event. Please use the "persist" method instead to persist changes to the server.`
+      );
+    (e = this.connection) == null || e.send(JSON.stringify({ event: "dispatch", data: { type: t, payload: s } }));
+  }
+  onConnection(n, t) {
+    return this.connectionListeners[n].add(t), () => this.connectionListeners[n].delete(t);
+  }
+  initializeConnection() {
+    var n;
+    this.connection && (this.connection.addEventListener("open", (t) => {
+      this.connected = !0, this.connectionListeners.open.forEach((s) => s(t));
+    }), this.connection.addEventListener("close", (t) => {
+      this.connected = !1, this.connectionListeners.close.forEach((s) => s(t));
+    }), (n = this.connection) == null || n.addEventListener("message", (t) => {
+      var s, e;
+      try {
+        const { event: i, data: o } = JSON.parse(t.data);
+        if (i === "dispatch") {
+          const { type: c, payload: h } = o;
+          (s = this.listeners[c]) == null || s.forEach((l) => l(h));
+          return;
+        }
+        const a = o.extensions ? T(o.extensions, this.options.surface) : o.extensions;
+        (e = this.listeners[i]) == null || e.forEach((c) => {
+          c({ ...o, extensions: this._getLocalizedExtensions(a) });
+        });
+      } catch (i) {
+        console.error(
+          "[ExtensionServer] Something went wrong while parsing a server message:",
+          i instanceof Error ? i.message : i
+        );
+      }
+    }));
+  }
+  setupConnection(n = !0) {
+    this.options.connection.url && n && (this.closeConnection(), this.connection = new WebSocket(this.options.connection.url, this.options.connection.protocols), this.initializeConnection());
+  }
+  closeConnection() {
+    var n;
+    this.connected && ((n = this.connection) == null || n.close());
+  }
+  _getLocalizedExtensions(n) {
+    return n == null ? void 0 : n.map((t) => {
+      var a, c, h, l, u;
+      if (!this.options.locales || !f(t))
+        return t;
+      const e = ((c = (a = this.uiExtensionsByUuid[t.uuid]) == null ? void 0 : a.localization) == null ? void 0 : c.lastUpdated) !== ((h = t.localization) == null ? void 0 : h.lastUpdated) ? g(t.localization, this.options.locales) : ((l = this.uiExtensionsByUuid[t.uuid]) == null ? void 0 : l.localization) || t.localization, i = e && d(e) ? JSON.parse(e.translations) : e, o = {
+        ...t,
+        localization: e,
+        name: i && t.name.startsWith("t:") ? this._getLocalizedValue(i, t.name) : t.name,
+        ...t.description && {
+          description: i && ((u = t.description) != null && u.startsWith("t:")) ? this._getLocalizedValue(i, t.description) : t.description
+        }
+      };
+      return this.uiExtensionsByUuid[t.uuid] = {
+        ...o,
+        extensionPoints: this._getLocalizedExtensionPoints(e, o)
+      }, this.uiExtensionsByUuid[t.uuid];
+    });
+  }
+  _getLocalizedExtensionPoints(n, { extensionPoints: t, name: s, description: e }) {
+    return !n || !d(n) ? t : t == null ? void 0 : t.map((i) => ({
+      ...i,
+      localization: n,
+      name: s,
+      ...e && { description: e }
+    }));
+  }
+  _getLocalizedValue(n, t) {
+    const s = t.replace("t:", "");
+    return n[s] || t;
+  }
+}
+function S(r, n) {
+  return p({
+    ...r,
+    ...n,
+    connection: {
+      ...r.connection,
+      ...n.connection
+    }
+  });
+}
+function p(r) {
+  return m(r.surface) || delete r.surface, r;
+}
+function T(r, n) {
+  return n ? r.filter((t) => t.surface === n ? !0 : Array.isArray(t.extensionPoints) ? t.extensionPoints.filter((i) => typeof i == "string" ? !1 : i.surface === n).length > 0 : !1) : r;
+}
+export {
+  z as ExtensionServerClient
+};

package/dist/ExtensionServerClient/ExtensionServerClient.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ExtensionServerClient/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ExtensionServerClient';
+export * from './types';

package/dist/ExtensionServerClient/types.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=["admin","checkout","post_purchase","point_of_sale","customer-accounts"];exports.AVAILABLE_SURFACES=t;

package/dist/ExtensionServerClient/types.d.ts

@@ -0,0 +1,124 @@
+import type { LocalesOptions } from '../i18n';
+declare global {
+    namespace ExtensionServer {
+        /**
+         * Events being received by the extension server where the keys are the event names
+         * and the values are the payload of the given action. In case no payload is
+         * required, a value of void should be used.
+         */
+        interface InboundEvents {
+        }
+        /**
+         * Events being sent to the extension server where the keys are the event names
+         * and the values are the payload of the given action. In case no payload is
+         * required, a value of void should be used.
+         *
+         * Persist events are those that will generate changes on the server, like
+         * update and connected events. Dispatch events are those that will
+         * simply be proxied to the clients connected to the server.
+         */
+        interface OutboundPersistEvents {
+        }
+        interface DispatchEvents {
+        }
+        /**
+         * Extension server client class options. These are used to configure
+         * the client class.
+         */
+        interface Options {
+            connection: {
+                /**
+                 * The absolute URL of the WebSocket.
+                 */
+                url?: string;
+                /**
+                 * This defines if we should automatically attempt to connect when the
+                 * class is instantiated.
+                 *
+                 * @defaultValue true
+                 */
+                automaticConnect?: boolean;
+                /**
+                 * The sub-protocol selected by the server.
+                 *
+                 * @defaultValue []
+                 */
+                protocols?: string | string[];
+            };
+            /**
+             * If provided the extension server will only return extensions that matches the specified surface
+             */
+            surface?: Surface;
+            /**
+             * If provided the extension server will return a requested translations object with flattened
+             * translations for each extension matching the requested locales
+             */
+            locales?: LocalesOptions;
+        }
+        /**
+         * Extension server client class. This class will be used to connect and
+         * communicate with the extension server.
+         */
+        interface Client {
+            /**
+             * Connection options
+             */
+            options: Options;
+            /**
+             * Reconnecting WebSocket Client
+             */
+            connection: WebSocket;
+            /**
+             * Function to add an event listener to messages coming from
+             * the extension server connection.
+             */
+            on<TEvent extends keyof ExtensionServer.InboundEvents>(event: TEvent, cb: EventListener<TEvent>): EventUnsubscriber;
+            /**
+             * Function to emit an event that will persist changes to the extension server.
+             */
+            persist<TEvent extends keyof OutboundPersistEvents>(event: TEvent, payload: OutboundPersistEvents[TEvent]): void;
+            /**
+             * Function to emit an event to the extension server.
+             */
+            emit<TEvent extends keyof DispatchEvents>(...args: EmitArgs<TEvent>): void;
+            /**
+             * Function that opens a connection with the extensions server.
+             */
+            connect(options?: Options): () => void;
+        }
+        /**
+         * This defines how the ExtensionServer client's static class is defined and the constructor
+         * arguments it requires.
+         *
+         * @example
+         * ```
+         * const client = new ExtensionServer({ url: 'wss://localhost:1234' });
+         * ```
+         */
+        type StaticClient = Static<ExtensionServer.Client, [option?: ExtensionServer.Options]>;
+        /**
+         * This helper type allows us to account for nullish payloads on the emit function.
+         * In practice, this will allow TypeScript to type-check the event being emitted
+         * and, if the payload isn't required, the second argument won't be necessary.
+         */
+        type EmitArgs<TEvent extends keyof ExtensionServer.DispatchEvents> = ExtensionServer.DispatchEvents[TEvent] extends void ? [event: TEvent] : [event: TEvent, payload: ExtensionServer.DispatchEvents[TEvent]];
+        /**
+         * This is a helper interface that allows us to define the static methods of a given
+         * class. This is useful to define static methods, static properties
+         * and constructor variables.
+         */
+        interface Static<T = unknown, TArgs extends unknown[] = unknown[]> {
+            prototype: T;
+            new (...args: TArgs): T;
+        }
+        /**
+         * This helper creates a partial interface with exception to the defined key values.
+         */
+        type PartialExcept<TOject, TKey extends keyof TOject> = Partial<Omit<TOject, TKey>> & Pick<TOject, TKey>;
+        type EventListener<TEvent extends keyof ExtensionServer.InboundEvents> = (payload: ExtensionServer.InboundEvents[TEvent]) => void;
+        type EventUnsubscriber = () => void;
+    }
+}
+export declare const AVAILABLE_SURFACES: readonly ["admin", "checkout", "post_purchase", "point_of_sale", "customer-accounts"];
+export type Surface = (typeof AVAILABLE_SURFACES)[number];
+export {};

package/dist/ExtensionServerClient/types.es.js

@@ -0,0 +1,4 @@
+const o = ["admin", "checkout", "post_purchase", "point_of_sale", "customer-accounts"];
+export {
+  o as AVAILABLE_SURFACES
+};

package/dist/context/ExtensionServerProvider.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=require("./constants.cjs.js"),o=require("../state/actions/actions.cjs.js"),d=require("../ExtensionServerClient/ExtensionServerClient.cjs.js"),a=require("../hooks/useIsomorphicLayoutEffect.cjs.js"),p=require("../hooks/useExtensionServerState.cjs.js"),r=require("react");function x({children:f,options:S}){const[i,n]=p.useExtensionServerState(),[c,v]=r.useState(S),[t]=r.useState(()=>new d.ExtensionServerClient),u=r.useCallback((s=c)=>{v(s)},[c]);a.useIsomorphicLayoutEffect(()=>t.connect(c),[t,c]),a.useIsomorphicLayoutEffect(()=>{const s=[t.on("update",e=>n(o.createUpdateAction(e))),t.on("connected",e=>n(o.createConnectedAction(e))),t.on("refresh",e=>n(o.createRefreshAction(e))),t.on("focus",e=>n(o.createFocusAction(e))),t.on("unfocus",e=>n(o.createUnfocusAction(e)))];return()=>s.forEach(e=>e())},[n]);const l=r.useMemo(()=>({dispatch:n,state:i,connect:u,client:t}),[n,u,i,t]);return r.createElement(E.extensionServerContext.Provider,{value:l},f)}exports.ExtensionServerProvider=x;

package/dist/context/ExtensionServerProvider.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionServerProviderProps } from './types';
+export declare function ExtensionServerProvider({ children, options: defaultOptions }: ExtensionServerProviderProps): JSX.Element;

package/dist/context/ExtensionServerProvider.es.js

@@ -0,0 +1,29 @@
+import { extensionServerContext as d } from "./constants.es.js";
+import { createUpdateAction as l, createConnectedAction as v, createRefreshAction as x, createFocusAction as E, createUnfocusAction as S } from "../state/actions/actions.es.js";
+import { ExtensionServerClient as h } from "../ExtensionServerClient/ExtensionServerClient.es.js";
+import { useIsomorphicLayoutEffect as i } from "../hooks/useIsomorphicLayoutEffect.es.js";
+import { useExtensionServerState as A } from "../hooks/useExtensionServerState.es.js";
+import C, { useState as a, useCallback as P, useMemo as R } from "react";
+function I({ children: u, options: f }) {
+  const [c, o] = A(), [n, m] = a(f), [t] = a(() => new h()), s = P(
+    (r = n) => {
+      m(r);
+    },
+    [n]
+  );
+  i(() => t.connect(n), [t, n]), i(() => {
+    const r = [
+      t.on("update", (e) => o(l(e))),
+      t.on("connected", (e) => o(v(e))),
+      t.on("refresh", (e) => o(x(e))),
+      t.on("focus", (e) => o(E(e))),
+      t.on("unfocus", (e) => o(S(e)))
+    ];
+    return () => r.forEach((e) => e());
+  }, [o]);
+  const p = R(() => ({ dispatch: o, state: c, connect: s, client: t }), [o, s, c, t]);
+  return /* @__PURE__ */ C.createElement(d.Provider, { value: p }, u);
+}
+export {
+  I as ExtensionServerProvider
+};

package/dist/context/ExtensionServerProvider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/constants.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../ExtensionServerClient/ExtensionServerClient.cjs.js"),o=require("../state/reducers/constants.cjs.js"),e=require("../utilities/noop.cjs.js"),r=require("react"),t={connect:e.noop,dispatch:e.noop,state:o.INITIAL_STATE,client:new n.ExtensionServerClient},s=r.createContext(t);exports.DEFAULT_VALUE=t;exports.extensionServerContext=s;

package/dist/context/constants.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionServerContext } from './types';
+export declare const DEFAULT_VALUE: ExtensionServerContext;
+export declare const extensionServerContext: import("react").Context<ExtensionServerContext>;

package/dist/context/constants.es.js

@@ -0,0 +1,14 @@
+import { ExtensionServerClient as o } from "../ExtensionServerClient/ExtensionServerClient.es.js";
+import { INITIAL_STATE as e } from "../state/reducers/constants.es.js";
+import { noop as t } from "../utilities/noop.es.js";
+import { createContext as n } from "react";
+const r = {
+  connect: t,
+  dispatch: t,
+  state: e,
+  client: new o()
+}, s = n(r);
+export {
+  r as DEFAULT_VALUE,
+  s as extensionServerContext
+};

package/dist/context/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ExtensionServerProvider';
+export * from './constants';
+export * from './types';

package/dist/context/types.d.ts

@@ -0,0 +1,11 @@
+import type { ExtensionServerState, ExtensionServerActions } from '../state';
+export interface ExtensionServerContext {
+    client: ExtensionServer.Client;
+    state: ExtensionServerState;
+    connect(options?: ExtensionServer.Options): void;
+    dispatch(action: ExtensionServerActions): void;
+}
+export interface ExtensionServerProviderProps {
+    children?: React.ReactNode;
+    options: ExtensionServer.Options;
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export * from './useExtensionClient';
+export * from './useExtensionServerContext';
+export * from './useExtensionServerEvent';
+export * from './useExtensionServerState';
+export * from './useIsomorphicLayoutEffect';

package/dist/hooks/useExtensionClient.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./useExtensionServerContext.cjs.js");function n(){const{client:e}=t.useExtensionServerContext();return e}exports.useExtensionClient=n;

package/dist/hooks/useExtensionClient.d.ts

@@ -0,0 +1 @@
+export declare function useExtensionClient(): ExtensionServer.Client;

package/dist/hooks/useExtensionClient.es.js

@@ -0,0 +1,8 @@
+import { useExtensionServerContext as n } from "./useExtensionServerContext.es.js";
+function o() {
+  const { client: e } = n();
+  return e;
+}
+export {
+  o as useExtensionClient
+};

package/dist/hooks/useExtensionServerContext.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../context/constants.cjs.js"),t=require("react"),n=()=>t.useContext(e.extensionServerContext);exports.useExtensionServerContext=n;

package/dist/hooks/useExtensionServerContext.d.ts

@@ -0,0 +1 @@
+export declare const useExtensionServerContext: () => import("../context").ExtensionServerContext;

package/dist/hooks/useExtensionServerContext.es.js

@@ -0,0 +1,6 @@
+import { extensionServerContext as e } from "../context/constants.es.js";
+import { useContext as t } from "react";
+const n = () => t(e);
+export {
+  n as useExtensionServerContext
+};

package/dist/hooks/useExtensionServerEvent.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./useExtensionServerContext.cjs.js"),r=require("./useIsomorphicLayoutEffect.cjs.js");function s(e,t){const{client:o}=n.useExtensionServerContext();r.useIsomorphicLayoutEffect(()=>o.on(e,t),[o,e,t])}exports.useExtensionServerEvent=s;

package/dist/hooks/useExtensionServerEvent.d.ts

@@ -0,0 +1 @@
+export declare function useExtensionServerEvent<TEvent extends keyof ExtensionServer.InboundEvents>(event: TEvent, listener: ExtensionServer.EventListener<TEvent>): void;

package/dist/hooks/useExtensionServerEvent.es.js

@@ -0,0 +1,9 @@
+import { useExtensionServerContext as n } from "./useExtensionServerContext.es.js";
+import { useIsomorphicLayoutEffect as r } from "./useIsomorphicLayoutEffect.es.js";
+function c(o, t) {
+  const { client: e } = n();
+  r(() => e.on(o, t), [e, o, t]);
+}
+export {
+  c as useExtensionServerEvent
+};

package/dist/hooks/useExtensionServerState.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../state/reducers/constants.cjs.js"),r=require("../state/reducers/extensionServerReducer.cjs.js"),t=require("react");function n(){return t.useReducer(r.extensionServerReducer,e.INITIAL_STATE)}exports.useExtensionServerState=n;