@usequeek/app-sdk 0.5.0 → 0.6.0

package/dist/react.js

@@ -0,0 +1,262 @@
+"use client";
+/**
+ * Optional React bindings for `@usequeek/app-sdk` (U2).
+ *
+ * Import from `@usequeek/app-sdk/react` (requires the optional `react`
+ * peer) — a thin layer built ONLY on the framework-free core (`frame.js` /
+ * `theme.js`): `<QueekProvider>` owns one bridge subscription, and
+ * `useQueek()` exposes `{ toast, saveBar, title, navigate, pickResource,
+ * theme }` over it.
+ *
+ * No JSX in this file (the build stays plain `tsc`, no `jsx` flag).
+ */
+import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import { listenToDashboard, sendNavigated, sendOpen, sendPickResource, sendReady, sendSaveBar, sendTitle, sendToast, } from "./frame.js";
+import { applyTheme, getThemeModeFromUrl, rememberThemeMode, syncThemeUrl } from "./theme.js";
+/** A pick with no dashboard answer settles after this long (never deadlocks). */
+export const PICK_TIMEOUT_MS = 5 * 60 * 1000;
+/**
+ * How long after `ready` the provider waits for the dashboard's capability
+ * handshake (on its `theme` message) before treating the dashboard as legacy.
+ */
+export const HANDSHAKE_TIMEOUT_MS = 1500;
+const QueekBridgeContext = createContext(null);
+function globalWindow() {
+    const win = globalThis.window;
+    return win?.location !== undefined ? (win ?? null) : null;
+}
+function resolveConfig(props, win) {
+    return {
+        postTarget: props.postTarget ?? win?.parent,
+        listenTarget: props.listenTarget ?? win ?? undefined,
+        getHref: props.getHref ?? (() => win?.location.href ?? ""),
+        expectSource: props.expectSource !== undefined ? props.expectSource : (win?.parent ?? undefined),
+    };
+}
+export function QueekProvider(props) {
+    const { dashboardOrigin, children, sdkVersion } = props;
+    const win = useMemo(() => globalWindow(), []);
+    // Capabilities keyed by content: a new inline array with the same entries
+    // keeps the subscription (and the single ready) stable.
+    const capKey = JSON.stringify(props.capabilities ?? []);
+    const capabilities = useMemo(() => JSON.parse(capKey), [capKey]);
+    // Latest wiring lives in a ref: parent re-renders (inline arrays, fresh
+    // closures) must NOT resubscribe the bridge or re-announce ready.
+    const configRef = useRef(resolveConfig(props, win));
+    configRef.current = resolveConfig(props, win);
+    // "light" until the mount effect reads the URL — the first render must
+    // match SSR to avoid a hydration mismatch.
+    const modeRef = useRef("light");
+    const themeHandlers = useRef(new Set());
+    const titleHandlers = useRef(new Set());
+    const saveBarHandlers = useRef(new Set());
+    const navigateHandlers = useRef(new Set());
+    const pendingPick = useRef(null);
+    const pickCounter = useRef(0);
+    // The dashboard's own capabilities, learned from its `theme` handshake.
+    // undefined = unknown; `legacy` flips when the handshake never arrives.
+    const dashboardCaps = useRef(undefined);
+    const handshakeLegacy = useRef(false);
+    const handshakeWaiters = useRef(new Set());
+    const flushHandshake = useCallback(() => {
+        const waiters = [...handshakeWaiters.current];
+        handshakeWaiters.current.clear();
+        for (const waiter of waiters) {
+            waiter(dashboardCaps.current);
+        }
+    }, []);
+    const settlePick = useCallback((value, requestId) => {
+        const pending = pendingPick.current;
+        // Stale answers (an earlier, timed-out pick) never settle the current one.
+        if (pending === null || requestId !== pending.requestId) {
+            return;
+        }
+        pendingPick.current = null;
+        clearTimeout(pending.timer);
+        pending.resolve(value);
+    }, []);
+    const failPick = useCallback((error) => {
+        const pending = pendingPick.current;
+        pendingPick.current = null;
+        if (pending !== null) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+    }, []);
+    useEffect(() => {
+        const config = configRef.current;
+        dashboardCaps.current = undefined;
+        handshakeLegacy.current = false;
+        sendReady(dashboardOrigin, config.postTarget, { capabilities, sdkVersion });
+        const handshakeTimer = setTimeout(() => {
+            if (dashboardCaps.current === undefined) {
+                handshakeLegacy.current = true;
+                flushHandshake();
+            }
+        }, HANDSHAKE_TIMEOUT_MS);
+        handshakeTimer.unref?.();
+        // Sync the URL theme after mount (render stayed SSR-safe "light").
+        const initial = getThemeModeFromUrl(config.getHref());
+        rememberThemeMode(initial);
+        if (initial !== modeRef.current) {
+            modeRef.current = initial;
+            applyTheme(initial);
+            for (const handler of themeHandlers.current) {
+                handler(initial);
+            }
+        }
+        const stop = listenToDashboard({
+            dashboardOrigin,
+            target: config.listenTarget,
+            expectSource: config.expectSource ?? undefined,
+            onTheme: (theme) => {
+                modeRef.current = theme.mode;
+                applyTheme(theme.mode);
+                rememberThemeMode(theme.mode);
+                syncThemeUrl(theme.mode, { getHref: config.getHref });
+                for (const handler of themeHandlers.current) {
+                    handler(theme.mode);
+                }
+                if (theme.capabilities !== undefined) {
+                    clearTimeout(handshakeTimer);
+                    dashboardCaps.current = theme.capabilities;
+                    flushHandshake();
+                }
+            },
+            onTitleAction: (id) => {
+                for (const handler of titleHandlers.current) {
+                    handler(id);
+                }
+            },
+            onSaveBarAction: (action) => {
+                for (const handler of saveBarHandlers.current) {
+                    handler(action);
+                }
+            },
+            onNavigate: (path) => {
+                for (const handler of navigateHandlers.current) {
+                    handler(path);
+                }
+            },
+            onResourcePicked: (items, requestId) => settlePick(items, requestId),
+            onResourcePickCancelled: (requestId) => settlePick(null, requestId),
+        });
+        return () => {
+            clearTimeout(handshakeTimer);
+            handshakeWaiters.current.clear();
+            failPick(new Error("QueekProvider unmounted"));
+            stop();
+        };
+    }, [dashboardOrigin, capabilities, sdkVersion, flushHandshake, settlePick, failPick]);
+    const state = useMemo(() => ({
+        dashboardOrigin,
+        post: (send) => send(dashboardOrigin, configRef.current.postTarget),
+        subscribeTheme: (handler) => {
+            themeHandlers.current.add(handler);
+            return () => {
+                themeHandlers.current.delete(handler);
+            };
+        },
+        subscribeTitleAction: (handler) => {
+            titleHandlers.current.add(handler);
+            return () => {
+                titleHandlers.current.delete(handler);
+            };
+        },
+        subscribeSaveBarAction: (handler) => {
+            saveBarHandlers.current.add(handler);
+            return () => {
+                saveBarHandlers.current.delete(handler);
+            };
+        },
+        subscribeNavigate: (handler) => {
+            navigateHandlers.current.add(handler);
+            return () => {
+                navigateHandlers.current.delete(handler);
+            };
+        },
+        requestPick: (request) => {
+            // Validate BEFORE registering: an invalid request rejects at once
+            // and can never deadlock a later pick.
+            if (typeof request !== "object" ||
+                request === null ||
+                request.resourceType !== "product") {
+                return Promise.reject(new Error("pickResource supports product resources only"));
+            }
+            if (pendingPick.current !== null) {
+                return Promise.reject(new Error("pickResource already in progress"));
+            }
+            pickCounter.current += 1;
+            const requestId = `pick-${pickCounter.current}`;
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    failPick(new Error("pickResource timed out"));
+                }, PICK_TIMEOUT_MS);
+                timer.unref?.();
+                // Registered before the capability check so a second pick during the
+                // handshake wait is rejected as "in progress".
+                pendingPick.current = { requestId, resolve, reject, timer };
+                const dispatch = (caps) => {
+                    if (pendingPick.current?.requestId !== requestId) {
+                        return;
+                    }
+                    if (caps === undefined || !caps.includes("pick-resource")) {
+                        failPick(new Error("dashboard does not support pick-resource"));
+                        return;
+                    }
+                    sendPickResource(dashboardOrigin, configRef.current.postTarget, { ...request, requestId });
+                };
+                if (dashboardCaps.current !== undefined) {
+                    dispatch(dashboardCaps.current);
+                }
+                else if (handshakeLegacy.current) {
+                    dispatch(undefined);
+                }
+                else {
+                    handshakeWaiters.current.add(dispatch);
+                }
+            });
+        },
+        currentMode: () => modeRef.current,
+    }), [dashboardOrigin, failPick]);
+    return createElement(QueekBridgeContext.Provider, { value: state }, children);
+}
+function useBridge() {
+    const bridge = useContext(QueekBridgeContext);
+    if (bridge === null) {
+        throw new Error("useQueek must be used inside <QueekProvider>");
+    }
+    return bridge;
+}
+/** Bridge actions + live theme over the framework-free core. */
+export function useQueek() {
+    const bridge = useBridge();
+    const { post } = bridge;
+    // "light" first (matches SSR); the effect below syncs the live mode, so a
+    // dark URL theme never causes a hydration mismatch.
+    const [mode, setMode] = useState("light");
+    useEffect(() => {
+        setMode(bridge.currentMode());
+        return bridge.subscribeTheme(setMode);
+    }, [bridge]);
+    const toast = useCallback((message, options) => {
+        post((origin, target) => sendToast(origin, target, message, options));
+    }, [post]);
+    const saveBar = useMemo(() => ({
+        dirty: () => post((origin, target) => sendSaveBar(origin, target, "dirty")),
+        clean: () => post((origin, target) => sendSaveBar(origin, target, "clean")),
+        onAction: (handler) => bridge.subscribeSaveBarAction(handler),
+    }), [bridge, post]);
+    const title = useMemo(() => ({
+        set: (heading, actions) => post((origin, target) => sendTitle(origin, target, heading, actions)),
+        onAction: (handler) => bridge.subscribeTitleAction(handler),
+    }), [bridge, post]);
+    const navigate = useMemo(() => ({
+        report: (path) => post((origin, target) => sendNavigated(origin, target, path)),
+        onNavigate: (handler) => bridge.subscribeNavigate(handler),
+        open: (openTarget) => post((origin, target) => sendOpen(origin, target, openTarget)),
+    }), [bridge, post]);
+    const pickResource = useCallback((request) => bridge.requestPick(request), [bridge]);
+    return useMemo(() => ({ toast, saveBar, title, navigate, pickResource, theme: { mode } }), [toast, saveBar, title, navigate, pickResource, mode]);
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/dist/scopes.d.ts

@@ -0,0 +1,174 @@
+import { QueekApiError } from "./client.js";
+import type { InstallationStore } from "./store.js";
+/**
+ * Optional scopes (plan item 6, Shopify `scopes.query / request / revoke`
+ * parity — symbol names cited only).
+ *
+ * - `queryScopes`: the cached effective grant split against the app's own
+ *   declared-optional list. Store-read only, never a fetch: the app-credential
+ *   surface exposes the effective grant but no declared-optional list, so
+ *   the split needs the app's manifest knowledge (passed at client
+ *   construction). No network, no guessing.
+ * - `requestScopes`: builds the dashboard deep link that opens the
+ *   merchant's consent screen in the dashboard. The SDK never renders
+ *   consent — it hands the app a link shaped like the bridge
+ *   `open`/`navigate` targets (dashboard-relative path, or an absolute URL
+ *   under a given dashboard origin) for the app to open via `sendOpen` or
+ *   redirect to. The consent screen itself ships with the dashboard (plan
+ *   item 8), which honours this link shape.
+ * - `revokeScopes`: `POST
+ *   /api/v1/apps/installations/{installation}/scopes/revoke` with the app
+ *   JWT (same credential as mint/resync — never auth:sanctum, never the
+ *   installation token). Body `{scopes[]}` (1–50, backend
+ *   `RevokeAppScopesRequest`); an `Idempotency-Key` rides the write for
+ *   discipline (generated when the caller does not supply one — the client
+ *   write discipline), though the route is naturally idempotent: revoking
+ *   a never-granted optional scope is 200 with no change. Required scopes
+ *   refuse 422 `app_scope_required` (surfaced as `AppScopeRequiredError`).
+ *   On 200 the cached grant is refreshed from the response and the cached
+ *   token dropped only when the grant moved (same compare-and-clear as the
+ *   scopes_update handler — the backend rewrites live token rows in place,
+ *   so the drop is backstop, not mechanism).
+ *
+ * Types here are hand-written: the revoke endpoint and the scopes_update
+ * handoff live on the app-credential surface, which the frozen
+ * `openapi/merchant.json` does not cover (types are generated app-side by
+ * `queek app codegen`; the merchant spec file is never hand-edited).
+ */
+/** 422 on the revoke endpoint: required scopes are never revocable (uninstall is the remedy). */
+export declare const APP_SCOPE_REQUIRED_CODE = "app_scope_required";
+/** 422 on the approve path: the scope is not declared by the live manifest version. */
+export declare const APP_SCOPE_UNDECLARED_CODE = "app_scope_undeclared";
+/** True for a required-scope refusal on the revoke endpoint (422 `app_scope_required`). */
+export declare function isAppScopeRequired(status: number, code: string | undefined): boolean;
+/**
+ * A required-scope refusal, typed so callers switch on the class (or
+ * `code`), never on `message`. Carries the offending scopes when the
+ * backend named them.
+ */
+export declare class AppScopeRequiredError extends QueekApiError {
+    readonly scopes: string[];
+    constructor(status: number, message: string, scopes: string[]);
+}
+/** Build an `AppScopeRequiredError` from a parsed 422, tolerantly reading the named scopes. */
+export declare function appScopeRequiredFromError(error: QueekApiError): AppScopeRequiredError;
+/** Thrown when a scope list fails client-side validation — before any fetch. */
+export declare class InvalidScopesError extends Error {
+    readonly code = "invalid_scopes";
+    constructor(message: string);
+}
+/** Backend `RevokeAppScopesRequest` bounds, mirrored client-side. */
+export declare const MAX_SCOPE_LIST = 50;
+export declare const MAX_SCOPE_LENGTH = 120;
+/**
+ * Validate + normalise a scope list (trim, drop empties, dedupe keeping
+ * first order). Mirrors the backend contract (`required array min:1
+ * max:50`, string items) so a malformed call fails before any fetch.
+ */
+export declare function normaliseScopeList(scopes: unknown): string[];
+/** The cached-grant split `queryScopes` returns. */
+export interface InstallationScopes {
+    /** The cached effective grant (grant ∩ tracked manifest), as stored. */
+    granted: string[];
+    /** The granted scopes that are app-declared optional (granted ∩ declared list, granted order). */
+    optional: string[];
+}
+/**
+ * Split a cached grant against the app's declared-optional list (the app's
+ * own manifest knowledge). Pure — no store, no network.
+ */
+export declare function splitInstallationScopes(granted: string[], declaredOptional?: string[]): InstallationScopes;
+/** App-API path of the revoke endpoint below the app base (sibling of the mint path). */
+export declare function revokeScopesPath(installationId: string): string;
+export interface ScopeRequestLinkOptions {
+    /** The app's dashboard slug (addresses the consent screen). */
+    appSlug: string;
+    /** Optional scopes to request (validated + normalised). */
+    scopes: string[];
+    /**
+     * Exact dashboard origin (e.g. from the embed query). When given, the
+     * link is absolute under it; otherwise dashboard-relative (the bridge
+     * `open` convention — resolves under the dashboard origin).
+     */
+    dashboardOrigin?: string;
+}
+/**
+ * Build the dashboard deep link that opens the merchant's consent screen
+ * in the dashboard. Pure — no store, no network. Shaped like the bridge
+ * `open` targets: a dashboard-relative path, or an absolute https URL
+ * under `dashboardOrigin` (refused exactly like `sendOpen` refuses a bad
+ * target).
+ *
+ * Link shape (the SDK↔dashboard contract the consent screen honours —
+ * the only query route the dashboard `AppsPage` serves):
+ * `/apps?app={slug}&view=scopes&scopes={a},{b}` (each scope
+ * URL-encoded, comma-separated). The link carries the slug + the scope
+ * list only: the dashboard resolves the installation from the signed-in
+ * store.
+ */
+export declare function buildScopeRequestLink(options: ScopeRequestLinkOptions): string;
+/** Options for the cached-grant read. */
+export interface QueryScopesOptions {
+    /** Per-call declared-optional list (wins over the client option). */
+    optionalScopes?: string[];
+}
+/** Options for the scope-request link. */
+export interface RequestScopesLinkOptions {
+    /** Per-call app slug (wins over the client option). */
+    appSlug?: string;
+    /** Per-call dashboard origin (wins over the client option). */
+    dashboardOrigin?: string;
+}
+/** Options for the app-initiated revoke. */
+export interface RevokeScopesOptions {
+    /** Write idempotency (generated when omitted — the client write discipline). */
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+}
+export interface InstallationScopesClientOptions {
+    /** The installation UUID (addresses the revoke endpoint). */
+    installationId: string;
+    /** The installation row cache: query reads it, revoke refreshes it. */
+    store: InstallationStore;
+    /**
+     * A fresh app JWT per call — e.g. `() => provider.signJwt()`. The revoke
+     * endpoint takes the same app credential as mint/resync (never
+     * auth:sanctum, never the installation token).
+     */
+    signJwt: () => string;
+    fetchImpl?: typeof fetch;
+    /** Sent as User-Agent. Defaults to `queek-app/1.0`. */
+    userAgent?: string;
+    /** Extra allowed `apiBase` hosts (test/local backends). */
+    allowedApiHosts?: string[];
+    /** The app's dashboard slug (addresses the scope-request consent screen); per-call override wins. */
+    appSlug?: string;
+    /**
+     * The app's manifest-declared optional scopes — the app's own knowledge
+     * (the app-credential surface exposes the effective grant but no
+     * declared list). Feeds the `queryScopes` split; per-call override wins.
+     */
+    optionalScopes?: string[];
+    /** Exact dashboard origin for absolute scope-request links; per-call override wins. */
+    dashboardOrigin?: string;
+}
+/**
+ * The per-installation scopes session (Shopify `scopes.query / request /
+ * revoke` parity — symbol names cited only). A sibling of the installation
+ * client, not a method on it: the installation client's exact type is a
+ * committed contract (the generics compat guard), so the scopes surface
+ * lives here, wired to the same store + token provider.
+ *
+ * - `queryScopes` reads the cached grant (no network).
+ * - `requestScopes` builds the dashboard deep link the merchant approves
+ *   at (pure — the SDK never renders consent).
+ * - `revokeScopes` calls the app-authenticated revoke endpoint and
+ *   refreshes the cache.
+ */
+export interface InstallationScopesClient {
+    queryScopes(options?: QueryScopesOptions): Promise<InstallationScopes>;
+    requestScopes(scopes: string[], options?: RequestScopesLinkOptions): string;
+    revokeScopes(scopes: string[], options?: RevokeScopesOptions): Promise<string[]>;
+}
+export declare function createInstallationScopesClient(options: InstallationScopesClientOptions): InstallationScopesClient;
+//# sourceMappingURL=scopes.d.ts.map

package/dist/scopes.d.ts.map

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