@scayle/storefront-devtools 0.2.0-alpha.1

package/dist/resource-center/plugin.d.ts

@@ -0,0 +1,12 @@
+import { Plugin } from 'vite';
+/**
+ * Creates the Vite plugin that registers the "Resource Center" dock entry: an
+ * iframe linking to the SCAYLE Storefront documentation, attached to the
+ * "SCAYLE Storefront" dock group via `groupId`. Its companion client script,
+ * which gives the iframe a white background, is injected into the host entry
+ * alongside the other panels' clients; see `src/index.ts`. The dock paints
+ * its iframe container transparent over the dark chrome and exposes no
+ * per-entry background option.
+ */
+export declare function createResourceCenterPlugin(): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/resource-center/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/resource-center/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAWlC;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAgBnD"}

package/dist/shared/clipboard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Writes text to the clipboard when running in the browser. No-op during SSR
+ * or when the Clipboard API is unavailable. Matches the SSR-guard idiom used
+ * in `core/history-capture.ts` and `resource-center/client.ts`.
+ *
+ * @param text - The text to copy.
+ */
+export declare function copyText(text: string): void;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/shared/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/shared/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI3C"}

package/dist/shared/redact.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Checks whether a key's value carries a credential and must not be stored.
+ *
+ * Passed to `safeClone` as its `redactKey` option, so redaction happens during
+ * the copy rather than in a second pass over the result.
+ *
+ * @param key - Object key or header name to test.
+ * @returns True when the value must be replaced.
+ */
+export declare function isSensitiveKey(key: string): boolean;
+/**
+ * Builds the `redactKey` predicate for one procedure's captured input,
+ * combining the procedure-agnostic pattern with that procedure's own
+ * sensitive keys (see {@link SENSITIVE_INPUT_BY_PROCEDURE}).
+ *
+ * @param procedure - Dot-separated procedure name the input belongs to.
+ * @returns A predicate suitable for `safeClone`'s `redactKey` option.
+ */
+export declare function isSensitiveInputKey(procedure: string): (key: string) => boolean;
+/**
+ * Removes credential-bearing request headers from a captured record.
+ *
+ * @param headers - Lowercased header record read off the request.
+ * @returns A copy without the sensitive headers.
+ */
+export declare function redactHeaders(headers: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=redact.d.ts.map

package/dist/shared/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/shared/redact.ts"],"names":[],"mappings":"AA2CA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAChB,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAI1B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB"}

package/dist/shared/safe-clone.d.ts

@@ -0,0 +1,46 @@
+/** Maximum object depth traversed before a subtree is replaced with a marker. */
+export declare const MAX_CLONE_DEPTH = 10;
+/** Placeholder written in place of a value whose key was redacted. */
+export declare const REDACTED = "[redacted]";
+/** Options controlling how a value is copied. */
+export interface SafeCloneOptions {
+    /**
+     * Called with each object key; return true to store {@link REDACTED} in place
+     * of that key's value. Used to keep credentials out of captured payloads.
+     */
+    redactKey?: (key: string) => boolean;
+}
+/**
+ * Copies a captured value into a plain, serializable structure.
+ *
+ * Captured payloads come from a live application: Inertia event details carry
+ * `AbortController`s and functions, and oRPC responses come back from
+ * `decodeRpcPayload` holding `Date`, `Map`, `Set`, `URL`, and `RegExp`
+ * instances. `structuredClone` throws on functions and `URL`, and a bare
+ * `Object.entries` walk flattens every structured type to `{}`, so the panel
+ * would show empty objects where the decoded values should be. This converts
+ * each of those to a readable form instead.
+ *
+ * Cyclic references are replaced with a marker, and traversal stops at
+ * {@link MAX_CLONE_DEPTH}, so a self-referential or deeply nested graph can
+ * neither recurse forever nor expand into an unbounded copy.
+ *
+ * @param value - The captured value to copy.
+ * @param options - Copy options, notably `redactKey` for credential removal.
+ * @param depth - Remaining depth budget; defaults to {@link MAX_CLONE_DEPTH}.
+ * @param seen - Ancestor objects on the current path, used to detect cycles.
+ * @returns A structure safe to store, diff, and serialize to JSON.
+ */
+export declare function safeClone(value: unknown, options?: SafeCloneOptions, depth?: number, seen?: Set<object>): unknown;
+/**
+ * Copies a `CustomEvent.detail` into a plain record for storage.
+ *
+ * Normalizes the two shapes a detail can take: a non-object payload is wrapped
+ * under a `value` key so the stored shape stays consistent, and an object
+ * payload has each of its properties copied through {@link safeClone}.
+ *
+ * @param detail - The event detail to copy; may be null or a primitive.
+ * @returns A record safe to store; empty when the detail is absent or unreadable.
+ */
+export declare function safeSerializeDetail(detail: unknown): Record<string, unknown>;
+//# sourceMappingURL=safe-clone.d.ts.map

package/dist/shared/safe-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-clone.d.ts","sourceRoot":"","sources":["../../src/shared/safe-clone.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC,sEAAsE;AACtE,eAAO,MAAM,QAAQ,eAAe,CAAA;AAKpC,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACrC;AAwDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gBAAqB,EAC9B,KAAK,GAAE,MAAwB,EAC/B,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,OAAO,CAsBT;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkB5E"}

package/dist/shared/session-storage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Creates `sessionStorage` save/load/clear functions scoped to one key.
+ * Backs the Inertia and oRPC panels' `saveSession`/`loadSession`/`clearSession`,
+ * which persist a compact summary of the previous page-load's captures so the
+ * panel can show them after a full reload wipes the in-memory store.
+ *
+ * @param key - The `sessionStorage` key to persist under.
+ * @returns `save`, `load`, and `clear` functions scoped to that key. `load`
+ *   returns null when nothing is stored or the stored snapshot has expired.
+ */
+export declare function createSessionStorage<TSnapshot extends {
+    savedAt: number;
+}>(key: string): {
+    save(snapshot: TSnapshot): void;
+    load(): TSnapshot | null;
+    clear(): void;
+};
+//# sourceMappingURL=session-storage.d.ts.map

package/dist/shared/session-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage.d.ts","sourceRoot":"","sources":["../../src/shared/session-storage.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACxE,GAAG,EAAE,MAAM;mBAGM,SAAS,GAAG,IAAI;YAWvB,SAAS,GAAG,IAAI;aAoBf,IAAI;EAOhB"}

package/dist/shared/use-window-store.d.ts

@@ -0,0 +1,18 @@
+import { Ref } from 'vue';
+/** A devtools capture store, as read off `window` by {@link useWindowStore}. */
+export interface WindowStore<TState> {
+    getState: () => TState;
+    subscribe: (fn: (state: TState) => void) => () => void;
+}
+/**
+ * Resolves an in-page devtools store (set by an injected client on `window`)
+ * and mirrors its state into a reactive `shallowRef`. The custom-render panel
+ * runs in the same page context as the capture client, so it reads the store
+ * directly off `window` with no cross-frame crossing. Polls briefly when the
+ * panel opens before the first capture creates the store.
+ *
+ * @param readStore - Reads the store off `window`, or `undefined` if the client hasn't created it yet.
+ * @returns A reactive ref holding the latest state, or null until the store appears.
+ */
+export declare function useWindowStore<TState>(readStore: () => WindowStore<TState> | undefined): Ref<TState | null>;
+//# sourceMappingURL=use-window-store.d.ts.map

package/dist/shared/use-window-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-window-store.d.ts","sourceRoot":"","sources":["../../src/shared/use-window-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAG9B,gFAAgF;AAChF,MAAM,WAAW,WAAW,CAAC,MAAM;IACjC,QAAQ,EAAE,MAAM,MAAM,CAAA;IACtB,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CACvD;AAKD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EACnC,SAAS,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,GAC/C,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAkCpB"}

package/dist/storefront/plugin.d.ts

@@ -0,0 +1,9 @@
+import { Plugin } from 'vite';
+/**
+ * Creates the Vite plugin that registers the Storefront context devtools
+ * panel: a custom-render dock entry whose renderer mounts the Vue panel into
+ * the dock panel DOM. The panel has no capture client of its own; it reads
+ * the live Inertia page from the Inertia panel's capture store.
+ */
+export declare function createStorefrontPlugin(): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/storefront/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/storefront/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AASlC;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAO/C"}

package/dist/storefront/renderer/index.d.mts

@@ -0,0 +1,16 @@
+import type { DockClientScriptContext } from '@vitejs/devtools-kit/client'
+
+/**
+ * Custom-render entry that mounts a devtools panel's Vue app into the dock
+ * panel DOM via `mountPanel` (see `src/shared/mount-panel.ts`). The Vite
+ * DevTools dock imports this by module specifier at runtime. This
+ * hand-authored declaration is the typed contract shared by the `./inertia/renderer`,
+ * `./orpc/renderer`, and `./storefront/renderer` exports. The Vue UI each
+ * renderer mounts has no emittable types and is excluded from declaration
+ * generation.
+ *
+ * @param ctx - The dock client-script context provided by the Vite DevTools dock.
+ */
+declare function setupRenderer(ctx: DockClientScriptContext): void
+
+export default setupRenderer

package/dist/storefront/renderer/index.mjs

@@ -0,0 +1,124 @@
+import { r as e, t } from "../../_chunks/panel-uV5ITqhY.mjs";
+import { n } from "../../_chunks/useStore-Db8RZW8T.mjs";
+import { computed as r, createElementBlock as i, createElementVNode as a, defineComponent as o, openBlock as s, toDisplayString as c } from "vue";
+//#region src/storefront/panel/context-view.ts
+function l(e) {
+	return typeof e == "object" && e && !Array.isArray(e) ? e : void 0;
+}
+function u(e) {
+	return typeof e == "string" ? e : void 0;
+}
+function d(e) {
+	return typeof e == "number" ? e : void 0;
+}
+function f(e) {
+	return typeof e == "boolean" ? e : void 0;
+}
+function p(e) {
+	let t = l(e);
+	return t ? Object.keys(t) : [];
+}
+function m(e) {
+	let t = l(e), n = l(t?.props), r = l(n?.storefront), i = l(r?.config), a = l(r?.country), o = l(i?.oauth), s = l(n?.user), c = l(a?.publicFields), m = Object.keys(c ?? {}).filter((e) => e !== "consentManagementRequired"), h = n?.availableCountries, g = n?.availableLanguages, _ = Array.isArray(s?.groups) ? s.groups.filter((e) => typeof e == "string") : [];
+	return {
+		tenantSpace: u(i?.tenantSpace),
+		shopKey: u(i?.shopKey),
+		domain: u(i?.domain),
+		oauthClientId: u(o?.clientId),
+		countryCode: u(a?.countryCode),
+		locale: u(a?.locale),
+		currency: u(a?.currency),
+		shopCountryId: d(a?.shopCountryId),
+		isDefault: f(a?.isDefault),
+		countrySelectorMode: u(i?.countrySelector),
+		availableCountriesCount: Array.isArray(h) ? h.length : void 0,
+		availableLanguagesCount: Array.isArray(g) ? g.length : void 0,
+		consentManagementRequired: f(c?.consentManagementRequired),
+		isLoggedIn: s !== void 0,
+		isGuest: f(s?.isGuest),
+		groups: _,
+		configPublicFieldKeys: p(i?.publicFields),
+		countryPublicFieldKeys: m,
+		pageVersion: u(t?.version),
+		currentUrl: u(t?.url)
+	};
+}
+//#endregion
+//#region src/storefront/panel/App.vue?vue&type=script&setup=true&lang.ts
+var h = { class: "sf-devtools" }, g = {
+	key: 0,
+	class: "sf-dt-empty"
+}, _ = {
+	key: 1,
+	class: "sf-dt-context"
+}, v = { class: "sf-dt-section" }, y = { class: "sf-dt-dl" }, b = { class: "sf-dt-col" }, x = { class: "sf-dt-section" }, S = { class: "sf-dt-dl" }, C = { class: "sf-dt-section" }, w = { class: "sf-dt-dl" }, T = "https://scayle.dev/documentation/storefront/storefront-application/getting-started/what-is-storefront", E = /*#__PURE__*/ t(/* @__PURE__ */ o({
+	__name: "App",
+	setup(e) {
+		let t = n(), o = r(() => t.value !== null), l = r(() => m(t.value?.currentPage ?? null));
+		function u(e) {
+			return e === void 0 ? "—" : e ? "yes" : "no";
+		}
+		function d(e) {
+			return e === void 0 ? "—" : String(e);
+		}
+		function f(e) {
+			return e.length ? e.join(", ") : "none";
+		}
+		return (e, t) => (s(), i("div", h, [a("nav", { class: "sf-dt-tabs" }, [t[0] ||= a("span", { class: "sf-dt-tab is-active" }, "Context", -1), a("a", {
+			class: "sf-dt-tab sf-dt-doclink",
+			href: T,
+			target: "_blank",
+			rel: "noreferrer"
+		}, " Storefront docs ")]), o.value ? (s(), i("div", _, [a("section", v, [t[14] ||= a("h4", { class: "sf-dt-heading" }, "Shop & Locale", -1), a("dl", y, [
+			t[1] ||= a("dt", null, "Tenant space", -1),
+			a("dd", null, c(d(l.value.tenantSpace)), 1),
+			t[2] ||= a("dt", null, "Shop key", -1),
+			a("dd", null, c(d(l.value.shopKey)), 1),
+			t[3] ||= a("dt", null, "Domain", -1),
+			a("dd", null, c(d(l.value.domain)), 1),
+			t[4] ||= a("dt", null, "Country", -1),
+			a("dd", null, c(d(l.value.countryCode)), 1),
+			t[5] ||= a("dt", null, "Locale", -1),
+			a("dd", null, c(d(l.value.locale)), 1),
+			t[6] ||= a("dt", null, "Currency", -1),
+			a("dd", null, c(d(l.value.currency)), 1),
+			t[7] ||= a("dt", null, "Shop-country ID", -1),
+			a("dd", null, c(d(l.value.shopCountryId)), 1),
+			t[8] ||= a("dt", null, "Default country", -1),
+			a("dd", null, c(u(l.value.isDefault)), 1),
+			t[9] ||= a("dt", null, "Country selector", -1),
+			a("dd", null, c(d(l.value.countrySelectorMode)), 1),
+			t[10] ||= a("dt", null, "Available countries", -1),
+			a("dd", null, c(d(l.value.availableCountriesCount)), 1),
+			t[11] ||= a("dt", null, "Available languages", -1),
+			a("dd", null, c(d(l.value.availableLanguagesCount)), 1),
+			t[12] ||= a("dt", null, "Consent required", -1),
+			a("dd", null, c(u(l.value.consentManagementRequired)), 1),
+			t[13] ||= a("dt", null, "OAuth client ID", -1),
+			a("dd", null, c(d(l.value.oauthClientId)), 1)
+		])]), a("div", b, [a("section", x, [t[18] ||= a("h4", { class: "sf-dt-heading" }, "Session", -1), a("dl", S, [
+			t[15] ||= a("dt", null, "Logged in", -1),
+			a("dd", null, c(u(l.value.isLoggedIn)), 1),
+			t[16] ||= a("dt", null, "Guest", -1),
+			a("dd", null, c(u(l.value.isGuest)), 1),
+			t[17] ||= a("dt", null, "Groups", -1),
+			a("dd", null, c(f(l.value.groups)), 1)
+		])]), a("section", C, [t[23] ||= a("h4", { class: "sf-dt-heading" }, "Page", -1), a("dl", w, [
+			t[19] ||= a("dt", null, "Current URL", -1),
+			a("dd", null, c(d(l.value.currentUrl)), 1),
+			t[20] ||= a("dt", null, "Page version", -1),
+			a("dd", null, c(d(l.value.pageVersion)), 1),
+			t[21] ||= a("dt", null, "Config public fields", -1),
+			a("dd", null, c(f(l.value.configPublicFieldKeys)), 1),
+			t[22] ||= a("dt", null, "Country public fields", -1),
+			a("dd", null, c(f(l.value.countryPublicFieldKeys)), 1)
+		])])])])) : (s(), i("div", g, " Enable the Inertia panel to inspect Storefront context. "))]));
+	}
+}), [["__scopeId", "data-v-1afb26c2"]]);
+//#endregion
+//#region src/storefront/panel/renderer.ts
+function D(t) {
+	e(t, E);
+}
+//#endregion
+export { D as default };