@shopify/ui-extensions-server-kit 0.0.0-experimental-20260902222805

package/dist/state/actions/actions.d.ts

@@ -0,0 +1,6 @@
+import type { ConnectedAction, UpdateAction, RefreshAction, FocusAction, UnfocusAction } from './types';
+export declare function createConnectedAction(payload: ConnectedAction['payload']): ConnectedAction;
+export declare function createUpdateAction(payload: UpdateAction['payload']): UpdateAction;
+export declare function createRefreshAction(payload: RefreshAction['payload']): RefreshAction;
+export declare function createFocusAction(payload: FocusAction['payload']): FocusAction;
+export declare function createUnfocusAction(payload: UnfocusAction['payload']): UnfocusAction;

package/dist/state/actions/index.d.ts

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

package/dist/state/actions/types.d.ts

@@ -0,0 +1,21 @@
+export interface ConnectedAction {
+    type: 'connected';
+    payload: ExtensionServer.InboundEvents['connected'];
+}
+export interface UpdateAction {
+    type: 'update';
+    payload: ExtensionServer.InboundEvents['update'];
+}
+export interface RefreshAction {
+    type: 'refresh';
+    payload: ExtensionServer.InboundEvents['refresh'];
+}
+export interface FocusAction {
+    type: 'focus';
+    payload: ExtensionServer.InboundEvents['focus'];
+}
+export interface UnfocusAction {
+    type: 'unfocus';
+    payload: ExtensionServer.InboundEvents['unfocus'];
+}
+export type ExtensionServerActions = ConnectedAction | UpdateAction | RefreshAction | FocusAction | UnfocusAction;

package/dist/state/index.d.ts

@@ -0,0 +1,2 @@
+export * from './actions';
+export * from './reducers';

package/dist/state/reducers/constants.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionServerState } from './types';
+export declare const INITIAL_STATE: ExtensionServerState;

package/dist/state/reducers/extensionServerReducer.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionServerActions } from '../actions';
+import type { ExtensionServerState } from './types';
+export declare function extensionServerReducer(state: ExtensionServerState, action: ExtensionServerActions): ExtensionServerState;

package/dist/state/reducers/extensionServerReducer.test.d.ts

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

package/dist/state/reducers/index.d.ts

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

package/dist/state/reducers/types.d.ts

@@ -0,0 +1,6 @@
+import type { App, ExtensionPayload } from '../../types';
+export interface ExtensionServerState {
+    app?: App;
+    extensions: ExtensionPayload[];
+    store: string;
+}

package/dist/testing/MockExtensionServerProvider.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { ExtensionServerProviderProps, ExtensionServerContext } from '../context';
+interface InternalProviderProps extends Partial<ExtensionServerContext> {
+    children?: ExtensionServerProviderProps['children'];
+}
+type MockExtensionServerProviderProps = Partial<ExtensionServerProviderProps> & InternalProviderProps;
+export declare function MockExtensionServerProvider({ children, options, ...props }: MockExtensionServerProviderProps): React.JSX.Element;
+export {};

package/dist/testing/app.d.ts

@@ -0,0 +1,2 @@
+import { App } from '../types';
+export declare function mockApp(): App;

package/dist/testing/extensions.d.ts

@@ -0,0 +1,6 @@
+import { ExtensionPayload } from '../types';
+type DeepPartial<T> = {
+    [P in keyof T]?: DeepPartial<T[P]>;
+};
+export declare function mockExtension(obj?: DeepPartial<ExtensionPayload>): ExtensionPayload;
+export {};

package/dist/testing/index.d.ts

@@ -0,0 +1,3 @@
+export * from './MockExtensionServerProvider';
+export * from './app';
+export * from './extensions';

package/dist/types.d.ts

@@ -0,0 +1,196 @@
+import { FlattenedLocalization, Localization } from './i18n';
+import './ExtensionServerClient/types';
+import type { Surface } from './ExtensionServerClient/types';
+declare global {
+    namespace ExtensionServer {
+        type ServerEvents = {
+            event: 'dispatch';
+            data: InboundEvents['dispatch'];
+        } | {
+            event: 'connected';
+            data: InboundEvents['connected'];
+        } | {
+            event: 'update';
+            data: InboundEvents['update'];
+        };
+        interface InboundEvents extends DispatchEvents {
+            dispatch: {
+                type: keyof DispatchEvents;
+                payload: DispatchEvents[keyof DispatchEvents];
+            };
+            connected: {
+                extensions: ExtensionPayload[];
+                app?: App;
+                store: string;
+            };
+            update: {
+                extensions?: ExtensionPayload[];
+                app?: App;
+            };
+        }
+        interface OutboundPersistEvents {
+            update: {
+                extensions?: ({
+                    uuid: string;
+                } & DeepPartial<ExtensionPayload>)[];
+                app?: DeepPartial<App>;
+            };
+        }
+        interface DispatchEvents {
+            refresh: {
+                uuid: string;
+            }[];
+            focus: {
+                uuid: string;
+            }[];
+            unfocus: void;
+            navigate: {
+                url: string;
+            };
+        }
+        namespace API {
+            interface BaseResponse {
+                app: App;
+                root: ResourceURL;
+                socket: ResourceURL;
+                devConsole: ResourceURL;
+                store: string;
+                version: string;
+            }
+            interface ExtensionsResponse extends BaseResponse {
+                extensions: ExtensionPayload[];
+            }
+            interface ExtensionResponse extends BaseResponse {
+                extension: ExtensionPayload;
+            }
+        }
+        interface UIExtension extends ExtensionPayload {
+            extensionPoints: ExtensionPoint[];
+            apiVersion: string;
+        }
+    }
+}
+export type DeepPartial<T> = {
+    [P in keyof T]?: DeepPartial<T[P]>;
+};
+interface ResourceURL {
+    url: string;
+}
+export interface Asset extends ResourceURL {
+    name: string;
+    lastUpdated: number;
+}
+interface Metafield {
+    namespace: string;
+    key: string;
+}
+export interface ExtensionPointIntercept {
+    event: string;
+    blocking: boolean;
+    applies_to?: string[];
+}
+export interface ExtensionPointCapabilities {
+    allow_direct_linking?: boolean;
+    intercepts?: ExtensionPointIntercept[];
+}
+export interface ExtensionPoint {
+    target: string;
+    surface: Surface;
+    metafields?: Metafield[];
+    resource: ResourceURL;
+    root: ResourceURL;
+    localization?: FlattenedLocalization | Localization | null;
+    name: string;
+    description?: string;
+    assets?: Record<string, Asset>;
+    capabilities?: ExtensionPointCapabilities;
+}
+type ExtensionPoints = string[] | ExtensionPoint[] | null;
+interface CollectBuyerConsentCapabilities {
+    smsMarketing: boolean;
+    customerPrivacy: boolean;
+}
+interface IframeCapabilities {
+    sources: string[];
+}
+interface Capabilities {
+    apiAccess: boolean;
+    blockProgress: boolean;
+    networkAccess: boolean;
+    collectBuyerConsent: CollectBuyerConsentCapabilities;
+    iframe: IframeCapabilities;
+}
+export interface ExtensionPayload {
+    type: string;
+    externalType: string;
+    assets: Record<string, Asset>;
+    development: {
+        hidden: boolean;
+        status: Status;
+        focused?: boolean;
+        resource: ResourceURL;
+        root: ResourceURL;
+        renderer: {
+            name: string;
+            version: string;
+        };
+        error?: {
+            message: string;
+            file?: string;
+        };
+    };
+    uuid: string;
+    version: string;
+    surface: Surface;
+    name: string;
+    description?: string;
+    handle: string;
+    extensionPoints: ExtensionPoints;
+    capabilities?: Capabilities;
+    supportedFeatures: ExtensionSupportedFeatures;
+    authenticatedRedirectStartUrl?: string;
+    authenticatedRedirectRedirectUrls?: string[];
+    localization?: FlattenedLocalization | Localization | null;
+    settings?: {
+        fields?: {
+            type: string;
+            key?: string;
+            name?: string;
+            description?: string;
+            required?: boolean;
+            validations?: unknown[];
+        }[];
+    };
+}
+export interface ExtensionSupportedFeatures {
+    runsOffline: boolean;
+}
+export declare enum Status {
+    Success = "success"
+}
+export interface App {
+    id: string;
+    apiKey: string;
+    url: string;
+    mobileUrl: string;
+    applicationUrl: string;
+    handle?: string | null;
+    title: string;
+    developerName?: string;
+    icon: {
+        transformedSrc: string;
+    };
+    installation?: {
+        launchUrl: string;
+    };
+    supportEmail?: string;
+    supportLocales?: string[];
+    allowedDomains?: string[];
+    assets?: {
+        [key: string]: {
+            url: string;
+            lastUpdated: number;
+        };
+    };
+}
+export {};

package/dist/utilities/assetToString.d.ts

@@ -0,0 +1,2 @@
+import type { Asset } from '../types';
+export declare function assetToString(asset: Asset): string;

package/dist/utilities/assetToString.test.d.ts

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

package/dist/utilities/index.d.ts

@@ -0,0 +1,6 @@
+export * from './noop';
+export * from './replaceUpdated';
+export * from './set';
+export * from './assetToString';
+export * from './isValidSurface';
+export * from './isUIExtension';

package/dist/utilities/isUIExtension.d.ts

@@ -0,0 +1 @@
+export declare function isUIExtension(extension: unknown): extension is ExtensionServer.UIExtension;

package/dist/utilities/isValidSurface.d.ts

@@ -0,0 +1,2 @@
+import type { Surface } from '../ExtensionServerClient/types';
+export declare function isValidSurface(surface: unknown): surface is Surface;

package/dist/utilities/noop.d.ts

@@ -0,0 +1 @@
+export declare const noop: () => void;

package/dist/utilities/replaceUpdated.d.ts

@@ -0,0 +1 @@
+export declare function replaceUpdated<T>(arr: T[], updates: T[], cb: (v: T) => unknown): T[];

package/dist/utilities/replaceUpdated.test.d.ts

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

package/dist/utilities/set.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Deep sets an object in a type-safe way
+ */
+export declare function set<TObject extends object, TValue>(obj: TObject, pathFn: (o: TObject) => TValue, value: TValue): TObject;

package/dist/utilities/set.test.d.ts

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

package/index.d.ts

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

package/index.js

@@ -0,0 +1 @@
+module.exports = require('./dist/index.cjs');

package/index.mjs

@@ -0,0 +1 @@
+export * from './dist/index.es.js';

package/node_modules/@testing-library/react/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) 2017-Present Kent C. Dodds
+
+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.