@brytdesigns/shopify-utils 1.2.22 → 3.1.0

package/dist/effect/Actions/bridge.js

@@ -0,0 +1,71 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+//#region src/effect/Actions/bridge.ts
+var bridge_exports = /* @__PURE__ */ __exportAll({
+	fromPromiseThunk: () => fromPromiseThunk,
+	toAsyncCallback: () => toAsyncCallback,
+	toSyncCallback: () => toSyncCallback
+});
+/**
+* Discharges Effects across a callback boundary owned by foreign code.
+*
+* Shopify's `configure()` stores plain callbacks and invokes them later, at
+* which point there is no fiber and no services. A `Context` captured while the
+* caller's services were still in scope is the only thing that can carry them
+* across that gap, so every helper here takes one.
+*
+* These helpers are deliberately free of Shopify specifics — they apply to any
+* register-a-callback API.
+*
+* Note that a captured `Context` freezes references as well as services, so the
+* log level, spans, and annotations in force at capture time are the ones the
+* callbacks run under — changing them afterwards does not reach back into an
+* already-registered callback.
+*/
+/**
+* Turn an Effect-returning function into the Promise-returning callback a
+* foreign API expects.
+*
+* A failed Effect becomes a rejected Promise, which is the correct signal for
+* an action handler: Shopify treats rejection as handler failure.
+*/
+var toAsyncCallback = (services, f) => (...args) => Effect.runPromiseWith(services)(f(...args));
+/**
+* Turn an Effect-returning function into a *synchronous* callback.
+*
+* `Effect<A, E, R>` does not track sync-vs-async at the type level, so nothing
+* stops a caller handing us an Effect that suspends. When that happens there is
+* no value to return and no error channel to use — the foreign API demands a
+* value right now. `onAbnormal` supplies it.
+*
+* Both failure shapes are covered: `runSyncExit` reports an async effect as a
+* failed `Exit` in some paths and throws in others depending on where the
+* suspension occurs, so we handle the thrown case too rather than letting a
+* defect escape into third-party code.
+*/
+var toSyncCallback = (services, f, onAbnormal) => (...args) => {
+	let exit;
+	try {
+		exit = Effect.runSyncExitWith(services)(f(...args));
+	} catch (defect) {
+		return onAbnormal(Cause.die(defect));
+	}
+	return Exit.isSuccess(exit) ? exit.value : onAbnormal(exit.cause);
+};
+/**
+* Lift a foreign Promise thunk back into Effect-land.
+*
+* This is the opposite crossing from {@link toAsyncCallback}: Shopify hands our
+* handler a `defaultHandler(): Promise<A>`, and the caller's handler is written
+* in Effect, so the thunk has to become an Effect before it can be composed.
+*/
+var fromPromiseThunk = (thunk, onReject) => Effect.tryPromise({
+	try: () => thunk(),
+	catch: onReject
+});
+//#endregion
+export { bridge_exports, fromPromiseThunk, toAsyncCallback, toSyncCallback };
+
+//# sourceMappingURL=bridge.js.map

package/dist/effect/Actions/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","names":[],"sources":["../../../src/effect/Actions/bridge.ts"],"sourcesContent":["import * as Cause from \"effect/Cause\";\nimport type * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Exit from \"effect/Exit\";\n\n/**\n * Discharges Effects across a callback boundary owned by foreign code.\n *\n * Shopify's `configure()` stores plain callbacks and invokes them later, at\n * which point there is no fiber and no services. A `Context` captured while the\n * caller's services were still in scope is the only thing that can carry them\n * across that gap, so every helper here takes one.\n *\n * These helpers are deliberately free of Shopify specifics — they apply to any\n * register-a-callback API.\n *\n * Note that a captured `Context` freezes references as well as services, so the\n * log level, spans, and annotations in force at capture time are the ones the\n * callbacks run under — changing them afterwards does not reach back into an\n * already-registered callback.\n */\n\n/**\n * Turn an Effect-returning function into the Promise-returning callback a\n * foreign API expects.\n *\n * A failed Effect becomes a rejected Promise, which is the correct signal for\n * an action handler: Shopify treats rejection as handler failure.\n */\nexport const toAsyncCallback =\n\t<Args extends ReadonlyArray<unknown>, A, E, R>(\n\t\tservices: Context.Context<R>,\n\t\tf: (...args: Args) => Effect.Effect<A, E, R>,\n\t) =>\n\t(...args: Args): Promise<A> =>\n\t\tEffect.runPromiseWith(services)(f(...args));\n\n/**\n * Turn an Effect-returning function into a *synchronous* callback.\n *\n * `Effect<A, E, R>` does not track sync-vs-async at the type level, so nothing\n * stops a caller handing us an Effect that suspends. When that happens there is\n * no value to return and no error channel to use — the foreign API demands a\n * value right now. `onAbnormal` supplies it.\n *\n * Both failure shapes are covered: `runSyncExit` reports an async effect as a\n * failed `Exit` in some paths and throws in others depending on where the\n * suspension occurs, so we handle the thrown case too rather than letting a\n * defect escape into third-party code.\n */\nexport const toSyncCallback =\n\t<Args extends ReadonlyArray<unknown>, A, R>(\n\t\tservices: Context.Context<R>,\n\t\tf: (...args: Args) => Effect.Effect<A, never, R>,\n\t\tonAbnormal: (cause: Cause.Cause<never>) => A,\n\t) =>\n\t(...args: Args): A => {\n\t\tlet exit: Exit.Exit<A, never>;\n\n\t\ttry {\n\t\t\texit = Effect.runSyncExitWith(services)(f(...args));\n\t\t} catch (defect) {\n\t\t\treturn onAbnormal(Cause.die(defect));\n\t\t}\n\n\t\treturn Exit.isSuccess(exit) ? exit.value : onAbnormal(exit.cause);\n\t};\n\n/**\n * Lift a foreign Promise thunk back into Effect-land.\n *\n * This is the opposite crossing from {@link toAsyncCallback}: Shopify hands our\n * handler a `defaultHandler(): Promise<A>`, and the caller's handler is written\n * in Effect, so the thunk has to become an Effect before it can be composed.\n */\nexport const fromPromiseThunk = <A, E>(\n\tthunk: () => Promise<A>,\n\tonReject: (cause: unknown) => E,\n): Effect.Effect<A, E> =>\n\tEffect.tryPromise({ try: () => thunk(), catch: onReject });\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,mBAEX,UACA,OAEA,GAAG,SACH,OAAO,eAAe,QAAQ,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;;;;;;;;;;;;;;AAe5C,IAAa,kBAEX,UACA,GACA,gBAEA,GAAG,SAAkB;CACrB,IAAI;CAEJ,IAAI;EACH,OAAO,OAAO,gBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;CACnD,SAAS,QAAQ;EAChB,OAAO,WAAW,MAAM,IAAI,MAAM,CAAC;CACpC;CAEA,OAAO,KAAK,UAAU,IAAI,IAAI,KAAK,QAAQ,WAAW,KAAK,KAAK;AACjE;;;;;;;;AASD,IAAa,oBACZ,OACA,aAEA,OAAO,WAAW;CAAE,WAAW,MAAM;CAAG,OAAO;AAAS,CAAC"}

package/dist/effect/Actions/errors.js

@@ -0,0 +1,46 @@
+import * as Data from "effect/Data";
+//#region src/effect/Actions/errors.ts
+/**
+* The storefront actions runtime was not present on `window`.
+*
+* Shopify injects it on Liquid storefronts only, so this is the expected
+* failure in tests, in checkout extensions, and during SSR — not a defect.
+*/
+var ActionsUnavailableError = class extends Data.TaggedError("@brytdesigns/shopify-utils/ActionsUnavailableError") {
+	constructor(options) {
+		super({
+			action: options.action,
+			message: `window.Shopify.actions.${options.action} is unavailable. The storefront standard actions runtime is only injected on Liquid storefronts.`
+		});
+	}
+};
+/**
+* `configure()` returned `false`, meaning the action refused the registration
+* (most commonly because something else already claimed it).
+*
+* Surfacing this as a typed failure is deliberate: a silently discarded
+* `false` leaves the caller believing their handler is installed when it is
+* not.
+*/
+var ActionConfigurationRejectedError = class extends Data.TaggedError("@brytdesigns/shopify-utils/ActionConfigurationRejectedError") {
+	constructor(options) {
+		super({
+			action: options.action,
+			message: `window.Shopify.actions.${options.action}.configure() returned false. The action already has a configuration installed.`
+		});
+	}
+};
+/** The underlying action promise rejected. */
+var ActionInvocationError = class extends Data.TaggedError("@brytdesigns/shopify-utils/ActionInvocationError") {
+	constructor(options) {
+		super({
+			action: options.action,
+			cause: options.cause,
+			message: `window.Shopify.actions.${options.action} rejected.`
+		});
+	}
+};
+//#endregion
+export { ActionConfigurationRejectedError, ActionInvocationError, ActionsUnavailableError };
+
+//# sourceMappingURL=errors.js.map

package/dist/effect/Actions/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../../src/effect/Actions/errors.ts"],"sourcesContent":["import * as Data from \"effect/Data\";\n\n/** Every action exposed on `window.Shopify.actions`. */\nexport type ActionName = \"getCart\" | \"updateCart\" | \"openCart\";\n\n/**\n * Only `updateCart` and `openCart` are `ActionFunction`s — `getCart` is a bare\n * callable with no `configure()` / `isDefault()`.\n */\nexport type ConfigurableActionName = Exclude<ActionName, \"getCart\">;\n\n/**\n * The storefront actions runtime was not present on `window`.\n *\n * Shopify injects it on Liquid storefronts only, so this is the expected\n * failure in tests, in checkout extensions, and during SSR — not a defect.\n */\nexport class ActionsUnavailableError extends Data.TaggedError(\n\t\"@brytdesigns/shopify-utils/ActionsUnavailableError\",\n)<{\n\treadonly action: ActionName;\n\treadonly message: string;\n}> {\n\tconstructor(options: { readonly action: ActionName }) {\n\t\tsuper({\n\t\t\taction: options.action,\n\t\t\tmessage: `window.Shopify.actions.${options.action} is unavailable. The storefront standard actions runtime is only injected on Liquid storefronts.`,\n\t\t});\n\t}\n}\n\n/**\n * `configure()` returned `false`, meaning the action refused the registration\n * (most commonly because something else already claimed it).\n *\n * Surfacing this as a typed failure is deliberate: a silently discarded\n * `false` leaves the caller believing their handler is installed when it is\n * not.\n */\nexport class ActionConfigurationRejectedError extends Data.TaggedError(\n\t\"@brytdesigns/shopify-utils/ActionConfigurationRejectedError\",\n)<{\n\treadonly action: ConfigurableActionName;\n\treadonly message: string;\n}> {\n\tconstructor(options: { readonly action: ConfigurableActionName }) {\n\t\tsuper({\n\t\t\taction: options.action,\n\t\t\tmessage: `window.Shopify.actions.${options.action}.configure() returned false. The action already has a configuration installed.`,\n\t\t});\n\t}\n}\n\n/** The underlying action promise rejected. */\nexport class ActionInvocationError extends Data.TaggedError(\n\t\"@brytdesigns/shopify-utils/ActionInvocationError\",\n)<{\n\treadonly action: ActionName;\n\treadonly cause: unknown;\n\treadonly message: string;\n}> {\n\tconstructor(options: {\n\t\treadonly action: ActionName;\n\t\treadonly cause: unknown;\n\t}) {\n\t\tsuper({\n\t\t\taction: options.action,\n\t\t\tcause: options.cause,\n\t\t\tmessage: `window.Shopify.actions.${options.action} rejected.`,\n\t\t});\n\t}\n}\n"],"mappings":";;;;;;;;AAiBA,IAAa,0BAAb,cAA6C,KAAK,YACjD,oDACD,CAAC,CAGE;CACF,YAAY,SAA0C;EACrD,MAAM;GACL,QAAQ,QAAQ;GAChB,SAAS,0BAA0B,QAAQ,OAAO;EACnD,CAAC;CACF;AACD;;;;;;;;;AAUA,IAAa,mCAAb,cAAsD,KAAK,YAC1D,6DACD,CAAC,CAGE;CACF,YAAY,SAAsD;EACjE,MAAM;GACL,QAAQ,QAAQ;GAChB,SAAS,0BAA0B,QAAQ,OAAO;EACnD,CAAC;CACF;AACD;;AAGA,IAAa,wBAAb,cAA2C,KAAK,YAC/C,kDACD,CAAC,CAIE;CACF,YAAY,SAGT;EACF,MAAM;GACL,QAAQ,QAAQ;GAChB,OAAO,QAAQ;GACf,SAAS,0BAA0B,QAAQ,OAAO;EACnD,CAAC;CACF;AACD"}

package/dist/effect/Actions/index.js

@@ -0,0 +1,23 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { bridge_exports } from "./bridge.js";
+import { ActionConfigurationRejectedError, ActionInvocationError, ActionsUnavailableError } from "./errors.js";
+import { ShopifyStorefrontActions, configureOpenCart, configureUpdateCart, getCart, isDefault, layer, openCart, updateCart } from "./service.js";
+//#region src/effect/Actions/index.ts
+var Actions_exports = /* @__PURE__ */ __exportAll({
+	ActionConfigurationRejectedError: () => ActionConfigurationRejectedError,
+	ActionInvocationError: () => ActionInvocationError,
+	ActionsUnavailableError: () => ActionsUnavailableError,
+	Bridge: () => bridge_exports,
+	ShopifyStorefrontActions: () => ShopifyStorefrontActions,
+	configureOpenCart: () => configureOpenCart,
+	configureUpdateCart: () => configureUpdateCart,
+	getCart: () => getCart,
+	isDefault: () => isDefault,
+	layer: () => layer,
+	openCart: () => openCart,
+	updateCart: () => updateCart
+});
+//#endregion
+export { ActionConfigurationRejectedError, ActionInvocationError, ActionsUnavailableError, Actions_exports, bridge_exports as Bridge, ShopifyStorefrontActions, configureOpenCart, configureUpdateCart, getCart, isDefault, layer, openCart, updateCart };
+
+//# sourceMappingURL=index.js.map

package/dist/effect/Actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/effect/Actions/index.ts"],"sourcesContent":["export * as Bridge from \"./bridge.js\";\nexport * from \"./errors.js\";\nexport * from \"./service.js\";\nexport * from \"./types.js\";\n"],"mappings":""}

package/dist/effect/Actions/service.js

@@ -0,0 +1,127 @@
+import { fromPromiseThunk, toAsyncCallback, toSyncCallback } from "./bridge.js";
+import { ActionConfigurationRejectedError, ActionInvocationError, ActionsUnavailableError } from "./errors.js";
+import { makeRegistry } from "./trampoline.js";
+import * as Effect from "effect/Effect";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+//#region src/effect/Actions/service.ts
+var updateCartRegistry = makeRegistry();
+var openCartRegistry = makeRegistry();
+var ShopifyStorefrontActions = class extends Context.Service()("@brytdesigns/shopify-utils/ShopifyStorefrontActions") {};
+/**
+* Resolve one action off `window` at call time.
+*
+* Deliberately not hoisted to layer construction: Shopify injects the runtime
+* during page load, so a snapshot taken when the layer is built can be stale.
+*/
+var requireAction = (action) => Effect.suspend(() => {
+	const target = globalThis.window?.Shopify?.actions?.[action];
+	return target === void 0 ? Effect.fail(new ActionsUnavailableError({ action })) : Effect.succeed(target);
+});
+/**
+* Bind `bridged` for the lifetime of the enclosing scope.
+*
+* The finalizer only clears the cell if it still holds *our* configuration. A
+* later `configure` supersedes an earlier one, and when the earlier one's scope
+* closes it must not clobber the newer binding.
+*/
+var bindForScope = (registration, bridged) => Effect.acquireRelease(Effect.sync(() => {
+	registration.active = bridged;
+}), () => Effect.sync(() => {
+	if (registration.active === bridged) registration.active = null;
+}));
+var make = () => ({
+	getCart: (payload, options) => Effect.flatMap(requireAction("getCart"), (getCart) => Effect.tryPromise({
+		try: (signal) => getCart(payload, {
+			...options,
+			signal: options?.signal ?? signal
+		}),
+		catch: (cause) => new ActionInvocationError({
+			action: "getCart",
+			cause
+		})
+	})),
+	updateCart: (payload, options) => Effect.flatMap(requireAction("updateCart"), (updateCart) => Effect.tryPromise({
+		try: (signal) => updateCart(payload, {
+			...options,
+			signal: options?.signal ?? signal
+		}),
+		catch: (cause) => new ActionInvocationError({
+			action: "updateCart",
+			cause
+		})
+	})),
+	openCart: Effect.flatMap(requireAction("openCart"), (openCart) => Effect.tryPromise({
+		try: () => openCart(),
+		catch: (cause) => new ActionInvocationError({
+			action: "openCart",
+			cause
+		})
+	})),
+	configureUpdateCart: (config) => Effect.gen(function* () {
+		const action = yield* requireAction("updateCart");
+		const services = yield* Effect.context();
+		const registration = updateCartRegistry(action);
+		if (!registration.claimed) {
+			if (!action.configure({
+				eventTarget: (meta) => registration.active?.eventTarget(meta) ?? null,
+				handler: (defaultHandler, ...args) => {
+					const handler = registration.active?.handler;
+					return handler ? handler(defaultHandler, ...args) : defaultHandler();
+				}
+			})) return yield* new ActionConfigurationRejectedError({ action: "updateCart" });
+			registration.claimed = true;
+		}
+		const handler = config.handler;
+		yield* bindForScope(registration, {
+			eventTarget: toSyncCallback(services, config.eventTarget, (cause) => {
+				Effect.runSyncWith(services)(Effect.logError("updateCart eventTarget did not resolve synchronously; dispatching on document instead", cause));
+				return null;
+			}),
+			handler: handler === void 0 ? null : toAsyncCallback(services, (defaultHandler, ...args) => handler(fromPromiseThunk(defaultHandler, (cause) => new ActionInvocationError({
+				action: "updateCart",
+				cause
+			})), ...args))
+		});
+	}),
+	configureOpenCart: (config) => Effect.gen(function* () {
+		const action = yield* requireAction("openCart");
+		const services = yield* Effect.context();
+		const registration = openCartRegistry(action);
+		if (!registration.claimed) {
+			if (!action.configure({ handler: (defaultHandler, ...args) => {
+				const handler = registration.active?.handler;
+				return handler ? handler(defaultHandler, ...args) : defaultHandler();
+			} })) return yield* new ActionConfigurationRejectedError({ action: "openCart" });
+			registration.claimed = true;
+		}
+		const handler = config.handler;
+		yield* bindForScope(registration, { handler: toAsyncCallback(services, (defaultHandler, ...args) => handler(fromPromiseThunk(defaultHandler, (cause) => new ActionInvocationError({
+			action: "openCart",
+			cause
+		})), ...args)) });
+	}),
+	isDefault: (action) => Effect.map(requireAction(action), (target) => target.isDefault())
+});
+/**
+* Live layer, backed by `window.Shopify.actions`.
+*
+* Named `layer` per the v4 convention, which replaces v3's `Default`/`Live`.
+*/
+var layer = Layer.succeed(ShopifyStorefrontActions, make());
+/**
+* Accessors so consumers can compose without pulling the service out by hand.
+*
+* `yield* Actions.configureUpdateCart({ ... })` reads better than
+* `yield* (yield* Actions.ShopifyStorefrontActions).configureUpdateCart({ ... })`.
+*/
+var getCart = (payload, options) => Effect.flatMap(ShopifyStorefrontActions, (actions) => actions.getCart(payload, options));
+var updateCart = (payload, options) => Effect.flatMap(ShopifyStorefrontActions, (actions) => actions.updateCart(payload, options));
+var openCart = Effect.flatMap(ShopifyStorefrontActions, (actions) => actions.openCart);
+var configureUpdateCart = (config) => Effect.flatMap(ShopifyStorefrontActions, (actions) => actions.configureUpdateCart(config));
+var configureOpenCart = (config) => Effect.flatMap(ShopifyStorefrontActions, (actions) => actions.configureOpenCart(config));
+var isDefault = (action) => Effect.flatMap(ShopifyStorefrontActions, (actions) => actions.isDefault(action));
+//#endregion
+export { ShopifyStorefrontActions, configureOpenCart, configureUpdateCart, getCart, isDefault, layer, openCart, updateCart };
+
+//# sourceMappingURL=service.js.map

package/dist/effect/Actions/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/effect/Actions/service.ts"],"sourcesContent":["import type {\n\tActionArgs,\n\tDefaultActionHandler,\n\tGetCartOptions,\n\tGetCartPayload,\n\tGetCartResult,\n\tUpdateCartEventTargetMeta,\n\tUpdateCartOptions,\n\tUpdateCartPayload,\n\tUpdateCartResult,\n} from \"@theme/standard-actions\";\n\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport type * as Scope from \"effect/Scope\";\n\nimport { fromPromiseThunk, toAsyncCallback, toSyncCallback } from \"./bridge.js\";\nimport {\n\tActionConfigurationRejectedError,\n\tActionInvocationError,\n\ttype ActionName,\n\tActionsUnavailableError,\n\ttype ConfigurableActionName,\n} from \"./errors.js\";\nimport { makeRegistry } from \"./trampoline.js\";\n\n/** The runtime object Shopify injects, as described by the vendored types. */\ntype StandardActions = NonNullable<Window[\"Shopify\"][\"actions\"]>;\n\n/**\n * The default handler, lifted into Effect-land.\n *\n * Handlers receive this rather than a pre-computed result so they keep the full\n * range of the upstream contract: run the default, wrap it, retry it, race it,\n * or skip it entirely and synthesise a result.\n */\nexport type DefaultHandler<A> = Effect.Effect<A, ActionInvocationError>;\n\n/**\n * An action handler written in Effect.\n *\n * The returned Effect's success value is what the action resolves with, and its\n * failure becomes a rejected promise for Shopify.\n *\n * Note that `E` is checked but never surfaces to the fiber that called\n * `configure` — the handler runs long afterwards, when a shopper triggers the\n * action, so its failure has nowhere to go but the promise Shopify awaits. If\n * you want handler failures observed, observe them inside the handler.\n */\nexport type Handler<P, A, O, E, R> = (\n\tdefaultHandler: DefaultHandler<A>,\n\t...args: ActionArgs<P, O>\n) => Effect.Effect<A, E, R>;\n\n/**\n * Resolves the element that `shopify:cart:*` events are dispatched from.\n *\n * The error channel is `never` on purpose. Shopify calls this synchronously and\n * uses the return value immediately, so there is nowhere for a failure to go —\n * handle errors inside the Effect and fall back to an element or `null`.\n *\n * For the same reason this Effect must complete synchronously. Anything that\n * suspends (`Effect.sleep`, an HTTP call, an async service) cannot produce a\n * value in time and is reported as `null` with a logged defect, which makes\n * Shopify dispatch on `document`. If you need async work, resolve it ahead of\n * time into a `Ref` and read the `Ref` here.\n */\nexport type EventTargetResolver<R> = (\n\tmeta: UpdateCartEventTargetMeta,\n) => Effect.Effect<EventTarget | null, never, R>;\n\nexport interface UpdateCartConfiguration<E, R> {\n\treadonly eventTarget: EventTargetResolver<R>;\n\t/** Optional: routing events without changing cart behaviour is valid. */\n\treadonly handler?: Handler<\n\t\tUpdateCartPayload,\n\t\tUpdateCartResult,\n\t\tUpdateCartOptions,\n\t\tE,\n\t\tR\n\t>;\n}\n\nexport interface OpenCartConfiguration<E, R> {\n\t/**\n\t * Required, unlike `updateCart`'s. `openCart` has no event target, so a\n\t * configuration without a handler would claim the one-shot upstream slot\n\t * while contributing nothing — locking everyone else out for the life of\n\t * the page in exchange for default behaviour.\n\t */\n\treadonly handler: Handler<void, void, void, E, R>;\n}\n\n/** The bridged (plain-callback) shape our trampoline reads. */\ninterface BridgedUpdateCart {\n\treadonly eventTarget: (meta: UpdateCartEventTargetMeta) => EventTarget | null;\n\treadonly handler:\n\t\t| ((\n\t\t\t\tdefaultHandler: DefaultActionHandler<UpdateCartResult>,\n\t\t\t\t...args: ActionArgs<UpdateCartPayload, UpdateCartOptions>\n\t\t  ) => Promise<UpdateCartResult>)\n\t\t| null;\n}\n\ninterface BridgedOpenCart {\n\treadonly handler: (\n\t\tdefaultHandler: DefaultActionHandler<void>,\n\t\t...args: ActionArgs<void, void>\n\t) => Promise<void>;\n}\n\nconst updateCartRegistry = makeRegistry<BridgedUpdateCart>();\nconst openCartRegistry = makeRegistry<BridgedOpenCart>();\n\nexport interface ShopifyStorefrontActionsImpl {\n\t/**\n\t * Read the current cart. `getCart` is a bare callable upstream — it has no\n\t * `configure()`, so there is no `configureGetCart`.\n\t */\n\treadonly getCart: (\n\t\tpayload?: GetCartPayload,\n\t\toptions?: GetCartOptions,\n\t) => Effect.Effect<\n\t\tGetCartResult,\n\t\tActionsUnavailableError | ActionInvocationError\n\t>;\n\n\treadonly updateCart: (\n\t\tpayload: UpdateCartPayload,\n\t\toptions?: UpdateCartOptions,\n\t) => Effect.Effect<\n\t\tUpdateCartResult,\n\t\tActionsUnavailableError | ActionInvocationError\n\t>;\n\n\treadonly openCart: Effect.Effect<\n\t\tvoid,\n\t\tActionsUnavailableError | ActionInvocationError\n\t>;\n\n\t/**\n\t * Install an Effect-based `updateCart` configuration for the lifetime of the\n\t * enclosing `Scope`.\n\t *\n\t * The `R` of the supplied Effects flows out into the returned Effect's\n\t * requirements, so the services your handler needs stay explicit and must be\n\t * provided before this runs — they are captured, not smuggled.\n\t *\n\t * Calling this more than once rebinds rather than failing: we claim the\n\t * upstream slot once and swap our own configuration behind it. A\n\t * `ActionConfigurationRejectedError` therefore means one specific thing —\n\t * something outside this library claimed the action first.\n\t *\n\t * For page-lifetime registration, build it into a layer with\n\t * `Layer.effectDiscard(Actions.configureUpdateCart({ ... }))` so the\n\t * registration lives exactly as long as the runtime does.\n\t */\n\treadonly configureUpdateCart: <E, R>(\n\t\tconfig: UpdateCartConfiguration<E, R>,\n\t) => Effect.Effect<\n\t\tvoid,\n\t\tActionsUnavailableError | ActionConfigurationRejectedError,\n\t\tR | Scope.Scope\n\t>;\n\n\treadonly configureOpenCart: <E, R>(\n\t\tconfig: OpenCartConfiguration<E, R>,\n\t) => Effect.Effect<\n\t\tvoid,\n\t\tActionsUnavailableError | ActionConfigurationRejectedError,\n\t\tR | Scope.Scope\n\t>;\n\n\t/**\n\t * Upstream's own notion: `true` until the action's slot is claimed.\n\t *\n\t * Because the slot can never be released, this stays `false` once we have\n\t * claimed it, even after every configuration has been deactivated.\n\t */\n\treadonly isDefault: (\n\t\taction: ConfigurableActionName,\n\t) => Effect.Effect<boolean, ActionsUnavailableError>;\n}\n\nexport class ShopifyStorefrontActions extends Context.Service<\n\tShopifyStorefrontActions,\n\tShopifyStorefrontActionsImpl\n>()(\"@brytdesigns/shopify-utils/ShopifyStorefrontActions\") {}\n\n/**\n * Resolve one action off `window` at call time.\n *\n * Deliberately not hoisted to layer construction: Shopify injects the runtime\n * during page load, so a snapshot taken when the layer is built can be stale.\n */\nconst requireAction = <K extends ActionName>(\n\taction: K,\n): Effect.Effect<StandardActions[K], ActionsUnavailableError> =>\n\tEffect.suspend(() => {\n\t\tconst target = globalThis.window?.Shopify?.actions?.[action];\n\n\t\treturn target === undefined\n\t\t\t? Effect.fail(new ActionsUnavailableError({ action }))\n\t\t\t: Effect.succeed(target);\n\t});\n\n/**\n * Bind `bridged` for the lifetime of the enclosing scope.\n *\n * The finalizer only clears the cell if it still holds *our* configuration. A\n * later `configure` supersedes an earlier one, and when the earlier one's scope\n * closes it must not clobber the newer binding.\n */\nconst bindForScope = <Config>(\n\tregistration: { active: Config | null },\n\tbridged: Config,\n) =>\n\tEffect.acquireRelease(\n\t\tEffect.sync(() => {\n\t\t\tregistration.active = bridged;\n\t\t}),\n\t\t() =>\n\t\t\tEffect.sync(() => {\n\t\t\t\tif (registration.active === bridged) registration.active = null;\n\t\t\t}),\n\t);\n\nconst make = (): ShopifyStorefrontActionsImpl => ({\n\tgetCart: (payload, options) =>\n\t\tEffect.flatMap(requireAction(\"getCart\"), (getCart) =>\n\t\t\tEffect.tryPromise({\n\t\t\t\t// Effect's interruption signal is forwarded when the caller has not\n\t\t\t\t// supplied one, so an interrupted fiber aborts the in-flight request.\n\t\t\t\ttry: (signal) =>\n\t\t\t\t\tgetCart(payload, { ...options, signal: options?.signal ?? signal }),\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tnew ActionInvocationError({ action: \"getCart\", cause }),\n\t\t\t}),\n\t\t),\n\n\tupdateCart: (payload, options) =>\n\t\tEffect.flatMap(requireAction(\"updateCart\"), (updateCart) =>\n\t\t\tEffect.tryPromise({\n\t\t\t\ttry: (signal) =>\n\t\t\t\t\tupdateCart(payload, {\n\t\t\t\t\t\t...options,\n\t\t\t\t\t\tsignal: options?.signal ?? signal,\n\t\t\t\t\t}),\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tnew ActionInvocationError({ action: \"updateCart\", cause }),\n\t\t\t}),\n\t\t),\n\n\topenCart: Effect.flatMap(requireAction(\"openCart\"), (openCart) =>\n\t\tEffect.tryPromise({\n\t\t\ttry: () => openCart(),\n\t\t\tcatch: (cause) =>\n\t\t\t\tnew ActionInvocationError({ action: \"openCart\", cause }),\n\t\t}),\n\t),\n\n\tconfigureUpdateCart: <E, R>(config: UpdateCartConfiguration<E, R>) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst action = yield* requireAction(\"updateCart\");\n\t\t\tconst services = yield* Effect.context<R>();\n\t\t\tconst registration = updateCartRegistry(action);\n\n\t\t\tif (!registration.claimed) {\n\t\t\t\t// One stable trampoline, installed once. Everything after this\n\t\t\t\t// rebinds `registration.active` instead of calling configure again.\n\t\t\t\tconst accepted = action.configure({\n\t\t\t\t\teventTarget: (meta) => registration.active?.eventTarget(meta) ?? null,\n\t\t\t\t\thandler: (defaultHandler, ...args) => {\n\t\t\t\t\t\tconst handler = registration.active?.handler;\n\n\t\t\t\t\t\treturn handler\n\t\t\t\t\t\t\t? handler(defaultHandler, ...args)\n\t\t\t\t\t\t\t: defaultHandler();\n\t\t\t\t\t},\n\t\t\t\t});\n\n\t\t\t\tif (!accepted) {\n\t\t\t\t\treturn yield* new ActionConfigurationRejectedError({\n\t\t\t\t\t\taction: \"updateCart\",\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tregistration.claimed = true;\n\t\t\t}\n\n\t\t\tconst handler = config.handler;\n\n\t\t\tconst bridged: BridgedUpdateCart = {\n\t\t\t\teventTarget: toSyncCallback(services, config.eventTarget, (cause) => {\n\t\t\t\t\tEffect.runSyncWith(services)(\n\t\t\t\t\t\tEffect.logError(\n\t\t\t\t\t\t\t\"updateCart eventTarget did not resolve synchronously; dispatching on document instead\",\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t\treturn null;\n\t\t\t\t}),\n\t\t\t\thandler:\n\t\t\t\t\thandler === undefined\n\t\t\t\t\t\t? null\n\t\t\t\t\t\t: toAsyncCallback(\n\t\t\t\t\t\t\t\tservices,\n\t\t\t\t\t\t\t\t(\n\t\t\t\t\t\t\t\t\tdefaultHandler: DefaultActionHandler<UpdateCartResult>,\n\t\t\t\t\t\t\t\t\t...args: ActionArgs<UpdateCartPayload, UpdateCartOptions>\n\t\t\t\t\t\t\t\t) =>\n\t\t\t\t\t\t\t\t\thandler(\n\t\t\t\t\t\t\t\t\t\tfromPromiseThunk(\n\t\t\t\t\t\t\t\t\t\t\tdefaultHandler,\n\t\t\t\t\t\t\t\t\t\t\t(cause) =>\n\t\t\t\t\t\t\t\t\t\t\t\tnew ActionInvocationError({\n\t\t\t\t\t\t\t\t\t\t\t\t\taction: \"updateCart\",\n\t\t\t\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t\t\t...args,\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t),\n\t\t\t};\n\n\t\t\tyield* bindForScope(registration, bridged);\n\t\t}),\n\n\tconfigureOpenCart: <E, R>(config: OpenCartConfiguration<E, R>) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst action = yield* requireAction(\"openCart\");\n\t\t\tconst services = yield* Effect.context<R>();\n\t\t\tconst registration = openCartRegistry(action);\n\n\t\t\tif (!registration.claimed) {\n\t\t\t\tconst accepted = action.configure({\n\t\t\t\t\thandler: (defaultHandler, ...args) => {\n\t\t\t\t\t\tconst handler = registration.active?.handler;\n\n\t\t\t\t\t\treturn handler\n\t\t\t\t\t\t\t? handler(defaultHandler, ...args)\n\t\t\t\t\t\t\t: defaultHandler();\n\t\t\t\t\t},\n\t\t\t\t});\n\n\t\t\t\tif (!accepted) {\n\t\t\t\t\treturn yield* new ActionConfigurationRejectedError({\n\t\t\t\t\t\taction: \"openCart\",\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tregistration.claimed = true;\n\t\t\t}\n\n\t\t\tconst handler = config.handler;\n\n\t\t\tconst bridged: BridgedOpenCart = {\n\t\t\t\thandler: toAsyncCallback(\n\t\t\t\t\tservices,\n\t\t\t\t\t(\n\t\t\t\t\t\tdefaultHandler: DefaultActionHandler<void>,\n\t\t\t\t\t\t...args: ActionArgs<void, void>\n\t\t\t\t\t) =>\n\t\t\t\t\t\thandler(\n\t\t\t\t\t\t\tfromPromiseThunk(\n\t\t\t\t\t\t\t\tdefaultHandler,\n\t\t\t\t\t\t\t\t(cause) =>\n\t\t\t\t\t\t\t\t\tnew ActionInvocationError({ action: \"openCart\", cause }),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t...args,\n\t\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t};\n\n\t\t\tyield* bindForScope(registration, bridged);\n\t\t}),\n\n\tisDefault: (action) =>\n\t\tEffect.map(requireAction(action), (target) => target.isDefault()),\n});\n\n/**\n * Live layer, backed by `window.Shopify.actions`.\n *\n * Named `layer` per the v4 convention, which replaces v3's `Default`/`Live`.\n */\nexport const layer = Layer.succeed(ShopifyStorefrontActions, make());\n\n/**\n * Accessors so consumers can compose without pulling the service out by hand.\n *\n * `yield* Actions.configureUpdateCart({ ... })` reads better than\n * `yield* (yield* Actions.ShopifyStorefrontActions).configureUpdateCart({ ... })`.\n */\n\nexport const getCart = (payload?: GetCartPayload, options?: GetCartOptions) =>\n\tEffect.flatMap(ShopifyStorefrontActions, (actions) =>\n\t\tactions.getCart(payload, options),\n\t);\n\nexport const updateCart = (\n\tpayload: UpdateCartPayload,\n\toptions?: UpdateCartOptions,\n) =>\n\tEffect.flatMap(ShopifyStorefrontActions, (actions) =>\n\t\tactions.updateCart(payload, options),\n\t);\n\nexport const openCart = Effect.flatMap(\n\tShopifyStorefrontActions,\n\t(actions) => actions.openCart,\n);\n\nexport const configureUpdateCart = <E, R>(\n\tconfig: UpdateCartConfiguration<E, R>,\n) =>\n\tEffect.flatMap(ShopifyStorefrontActions, (actions) =>\n\t\tactions.configureUpdateCart(config),\n\t);\n\nexport const configureOpenCart = <E, R>(config: OpenCartConfiguration<E, R>) =>\n\tEffect.flatMap(ShopifyStorefrontActions, (actions) =>\n\t\tactions.configureOpenCart(config),\n\t);\n\nexport const isDefault = (action: ConfigurableActionName) =>\n\tEffect.flatMap(ShopifyStorefrontActions, (actions) =>\n\t\tactions.isDefault(action),\n\t);\n"],"mappings":"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"}

package/dist/effect/Actions/trampoline.js

@@ -0,0 +1,26 @@
+//#region src/effect/Actions/trampoline.ts
+/**
+* A registry keyed on the action object itself rather than on the layer.
+*
+* Action identity is the correct key: the upstream slot belongs to that object,
+* so two independently built layers on one page must share a registration,
+* while a freshly stubbed action in a test must get a clean one. Keying on the
+* layer would get both of those backwards.
+*/
+var makeRegistry = () => {
+	const registrations = /* @__PURE__ */ new WeakMap();
+	return (action) => {
+		const existing = registrations.get(action);
+		if (existing !== void 0) return existing;
+		const created = {
+			claimed: false,
+			active: null
+		};
+		registrations.set(action, created);
+		return created;
+	};
+};
+//#endregion
+export { makeRegistry };
+
+//# sourceMappingURL=trampoline.js.map

package/dist/effect/Actions/trampoline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trampoline.js","names":[],"sources":["../../../src/effect/Actions/trampoline.ts"],"sourcesContent":["/**\n * Registration bookkeeping that turns Shopify's one-shot `configure()` into\n * something re-bindable.\n *\n * The shipped runtime stores the configuration in a closure variable and\n * refuses every later call:\n *\n * ```js\n * configure(e) { return t || !e || typeof e !== \"object\" ? false : (t = e, true) }\n * ```\n *\n * There is no reset path, so the slot can never be released. What we *can* do\n * is claim it once with a stable trampoline that reads a mutable cell, then\n * rebind that cell as often as we like. Deactivating restores the runtime's\n * default behaviour exactly — the trampoline falls through to the default\n * handler, and a `null` event target makes Shopify dispatch on `document`,\n * which is what it does when unconfigured.\n *\n * The one residue we cannot undo is `isDefault()`, which reports `false` from\n * the moment we claim the slot, whether or not a configuration is active.\n */\nexport interface Registration<Config> {\n\t/** Whether our trampoline currently occupies the upstream slot. */\n\tclaimed: boolean;\n\t/** The live bridged configuration, or `null` when deactivated. */\n\tactive: Config | null;\n}\n\n/**\n * A registry keyed on the action object itself rather than on the layer.\n *\n * Action identity is the correct key: the upstream slot belongs to that object,\n * so two independently built layers on one page must share a registration,\n * while a freshly stubbed action in a test must get a clean one. Keying on the\n * layer would get both of those backwards.\n */\nexport const makeRegistry = <Config>() => {\n\tconst registrations = new WeakMap<object, Registration<Config>>();\n\n\treturn (action: object): Registration<Config> => {\n\t\tconst existing = registrations.get(action);\n\n\t\tif (existing !== undefined) return existing;\n\n\t\tconst created: Registration<Config> = { claimed: false, active: null };\n\t\tregistrations.set(action, created);\n\n\t\treturn created;\n\t};\n};\n"],"mappings":";;;;;;;;;AAoCA,IAAa,qBAA6B;CACzC,MAAM,gCAAgB,IAAI,QAAsC;CAEhE,QAAQ,WAAyC;EAChD,MAAM,WAAW,cAAc,IAAI,MAAM;EAEzC,IAAI,aAAa,KAAA,GAAW,OAAO;EAEnC,MAAM,UAAgC;GAAE,SAAS;GAAO,QAAQ;EAAK;EACrE,cAAc,IAAI,QAAQ,OAAO;EAEjC,OAAO;CACR;AACD"}

package/dist/effect/Ajax/Sections/index.js

@@ -1,4 +1,2 @@
-import * as schema_js from './schema.js';
-export { schema_js as Sections };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { schema_exports } from "./schema.js";
+export { schema_exports as Sections };

package/dist/effect/Ajax/Sections/schema.js

@@ -1,44 +1,33 @@
-import * as Schema from 'effect/Schema';
-import * as ParseResult from 'effect/ParseResult';
-import 'effect/Function';
-
-const Input = Schema.Struct({
-  sections: Schema.optional(
-    Schema.transform(Schema.Array(Schema.String), Schema.String, {
-      decode: (sections) => sections.join(","),
-      encode: (str) => str.split(",")
-    })
-  ),
-  sections_url: Schema.optional(Schema.String)
+import { __exportAll } from "../../_virtual/_rolldown/runtime.js";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as SchemaGetter from "effect/SchemaGetter";
+import * as SchemaIssue from "effect/SchemaIssue";
+//#region src/effect/Ajax/Sections/schema.ts
+var schema_exports = /* @__PURE__ */ __exportAll({
+	Input: () => Input,
+	makeResponseSchema: () => makeResponseSchema
+});
+var Input = Schema.Struct({
+	sections: Schema.optional(Schema.Array(Schema.String).pipe(Schema.decodeTo(Schema.String, {
+		decode: SchemaGetter.transform((sections) => sections.join(",")),
+		encode: SchemaGetter.transform((str) => str.split(","))
+	}))),
+	sections_url: Schema.optional(Schema.String)
 });
-const parseKeys = (keys) => Array.from(
-  new Set(keys.split(",").map((key) => key.trim()))
-);
+var parseKeys = (keys) => Array.from(new Set(keys.split(",").map((key) => key.trim())));
 function makeResponseSchema(input) {
-  const keys = parseKeys(input);
-  return Schema.Record({
-    key: Schema.Literal(...keys),
-    value: Schema.transformOrFail(Schema.String, Schema.instanceOf(Element), {
-      decode: (htmlString, _, ast) => {
-        const parser = new DOMParser();
-        const doc = parser.parseFromString(htmlString, "text/html");
-        const root = doc.body.firstElementChild;
-        if (!root) {
-          return ParseResult.fail(
-            new ParseResult.Type(
-              ast,
-              htmlString,
-              "Failed to convert HTML string to Element"
-            )
-          );
-        }
-        return ParseResult.succeed(root);
-      },
-      encode: (element, options, ast) => ParseResult.succeed(element.outerHTML)
-    }).pipe(Schema.NullOr)
-  });
+	const keys = parseKeys(input);
+	return Schema.Record(Schema.Literals(keys), Schema.String.pipe(Schema.decodeTo(Schema.instanceOf(Element), {
+		decode: SchemaGetter.transformEffect((htmlString) => {
+			const root = new DOMParser().parseFromString(htmlString, "text/html").body.firstElementChild;
+			if (!root) return Effect.fail(new SchemaIssue.InvalidValue({ message: "Failed to convert HTML string to Element" }, htmlString));
+			return Effect.succeed(root);
+		}),
+		encode: SchemaGetter.transform((element) => element.outerHTML)
+	}), Schema.NullOr));
 }
+//#endregion
+export { Input, makeResponseSchema, schema_exports };
 
-export { Input, makeResponseSchema };
-//# sourceMappingURL=schema.js.map
 //# sourceMappingURL=schema.js.map

package/dist/effect/Ajax/Sections/schema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/effect/Ajax/Sections/schema.ts"],"names":[],"mappings":";;;;AAKa,MAAA,KAAA,GAAQ,OAAO,MAAO,CAAA;AAAA,EACjC,UAAU,MAAO,CAAA,QAAA;AAAA,IACf,MAAA,CAAO,UAAU,MAAO,CAAA,KAAA,CAAM,OAAO,MAAM,CAAA,EAAG,OAAO,MAAQ,EAAA;AAAA,MAC3D,MAAQ,EAAA,CAAC,QAAa,KAAA,QAAA,CAAS,KAAK,GAAG,CAAA;AAAA,MACvC,MAAQ,EAAA,CAAC,GAAQ,KAAA,GAAA,CAAI,MAAM,GAAG;AAAA,KAC/B;AAAA,GACH;AAAA,EACA,YAAc,EAAA,MAAA,CAAO,QAAS,CAAA,MAAA,CAAO,MAAM;AAC7C,CAAC;AAOD,MAAM,SAAA,GAAY,CAAyB,IAAA,KACzC,KAAM,CAAA,IAAA;AAAA,EACJ,IAAI,GAAA,CAAI,IAAK,CAAA,KAAA,CAAM,GAAG,CAAA,CAAE,GAAI,CAAA,CAAC,GAAQ,KAAA,GAAA,CAAI,IAAK,EAAC,CAAC;AAClD,CAAA;AAEK,SAAS,mBAA2C,KAAU,EAAA;AACnE,EAAM,MAAA,IAAA,GAAO,UAAU,KAAK,CAAA;AAC5B,EAAA,OAAO,OAAO,MAAO,CAAA;AAAA,IACnB,GAAK,EAAA,MAAA,CAAO,OAAQ,CAAA,GAAG,IAAI,CAAA;AAAA,IAC3B,KAAA,EAAO,OAAO,eAAgB,CAAA,MAAA,CAAO,QAAQ,MAAO,CAAA,UAAA,CAAW,OAAO,CAAG,EAAA;AAAA,MACvE,MAAQ,EAAA,CAAC,UAAY,EAAA,CAAA,EAAG,GAAQ,KAAA;AAC9B,QAAM,MAAA,MAAA,GAAS,IAAI,SAAU,EAAA;AAC7B,QAAA,MAAM,GAAM,GAAA,MAAA,CAAO,eAAgB,CAAA,UAAA,EAAY,WAAW,CAAA;AAC1D,QAAM,MAAA,IAAA,GAAO,IAAI,IAAK,CAAA,iBAAA;AACtB,QAAA,IAAI,CAAC,IAAM,EAAA;AACT,UAAA,OAAO,WAAY,CAAA,IAAA;AAAA,YACjB,IAAI,WAAY,CAAA,IAAA;AAAA,cACd,GAAA;AAAA,cACA,UAAA;AAAA,cACA;AAAA;AACF,WACF;AAAA;AAEF,QAAO,OAAA,WAAA,CAAY,QAAQ,IAAI,CAAA;AAAA,OACjC;AAAA,MACA,MAAA,EAAQ,CAAC,OAAS,EAAA,OAAA,EAAS,QAAQ,WAAY,CAAA,OAAA,CAAQ,QAAQ,SAAS;AAAA,KACzE,CAAA,CAAE,IAAK,CAAA,MAAA,CAAO,MAAM;AAAA,GACtB,CAAA;AACH","file":"schema.js","sourcesContent":["import * as Schema from \"effect/Schema\";\nimport * as ParseResult from \"effect/ParseResult\";\nimport * as Function from \"effect/Function\";\n\nexport type Input = typeof Input;\nexport const Input = Schema.Struct({\n  sections: Schema.optional(\n    Schema.transform(Schema.Array(Schema.String), Schema.String, {\n      decode: (sections) => sections.join(\",\"),\n      encode: (str) => str.split(\",\"),\n    }),\n  ),\n  sections_url: Schema.optional(Schema.String),\n});\n\n// Helper type to convert a string to a tuple of unique literals\ntype UniqueKeys<T extends string> = T extends `${infer K},${infer Rest}`\n  ? K | UniqueKeys<Rest>\n  : T;\n\nconst parseKeys = <const T extends string>(keys: T) =>\n  Array.from(\n    new Set(keys.split(\",\").map((key) => key.trim())),\n  ) as UniqueKeys<T>[];\n\nexport function makeResponseSchema<const T extends string>(input: T) {\n  const keys = parseKeys(input);\n  return Schema.Record({\n    key: Schema.Literal(...keys),\n    value: Schema.transformOrFail(Schema.String, Schema.instanceOf(Element), {\n      decode: (htmlString, _, ast) => {\n        const parser = new DOMParser();\n        const doc = parser.parseFromString(htmlString, \"text/html\");\n        const root = doc.body.firstElementChild;\n        if (!root) {\n          return ParseResult.fail(\n            new ParseResult.Type(\n              ast,\n              htmlString,\n              \"Failed to convert HTML string to Element\",\n            ),\n          );\n        }\n        return ParseResult.succeed(root);\n      },\n      encode: (element, options, ast) => ParseResult.succeed(element.outerHTML),\n    }).pipe(Schema.NullOr),\n  });\n}\n"]}
+{"version":3,"file":"schema.js","names":[],"sources":["../../../../src/effect/Ajax/Sections/schema.ts"],"sourcesContent":["import * as Effect from \"effect/Effect\";\nimport * as Schema from \"effect/Schema\";\nimport * as SchemaGetter from \"effect/SchemaGetter\";\nimport * as SchemaIssue from \"effect/SchemaIssue\";\n\nexport type Input = typeof Input;\nexport const Input = Schema.Struct({\n\tsections: Schema.optional(\n\t\tSchema.Array(Schema.String).pipe(\n\t\t\tSchema.decodeTo(Schema.String, {\n\t\t\t\tdecode: SchemaGetter.transform((sections: ReadonlyArray<string>) =>\n\t\t\t\t\tsections.join(\",\"),\n\t\t\t\t),\n\t\t\t\tencode: SchemaGetter.transform((str: string) => str.split(\",\")),\n\t\t\t}),\n\t\t),\n\t),\n\tsections_url: Schema.optional(Schema.String),\n});\n\n// Helper type to convert a string to a tuple of unique literals\ntype UniqueKeys<T extends string> = T extends `${infer K},${infer Rest}`\n\t? K | UniqueKeys<Rest>\n\t: T;\n\nconst parseKeys = <const T extends string>(keys: T) =>\n\tArray.from(\n\t\tnew Set(keys.split(\",\").map((key) => key.trim())),\n\t) as UniqueKeys<T>[];\n\nexport function makeResponseSchema<const T extends string>(input: T) {\n\tconst keys = parseKeys(input);\n\treturn Schema.Record(\n\t\tSchema.Literals(keys),\n\t\tSchema.String.pipe(\n\t\t\tSchema.decodeTo(Schema.instanceOf(Element), {\n\t\t\t\tdecode: SchemaGetter.transformEffect((htmlString: string) => {\n\t\t\t\t\tconst parser = new DOMParser();\n\t\t\t\t\tconst doc = parser.parseFromString(htmlString, \"text/html\");\n\t\t\t\t\tconst root = doc.body.firstElementChild;\n\n\t\t\t\t\tif (!root) {\n\t\t\t\t\t\t// InvalidValue rather than InvalidType: the input really is a\n\t\t\t\t\t\t// string, it just does not parse to an Element. The v3 code used\n\t\t\t\t\t\t// the type-mismatch issue for this.\n\t\t\t\t\t\treturn Effect.fail(\n\t\t\t\t\t\t\tnew SchemaIssue.InvalidValue(\n\t\t\t\t\t\t\t\t{ message: \"Failed to convert HTML string to Element\" },\n\t\t\t\t\t\t\t\thtmlString,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\treturn Effect.succeed(root);\n\t\t\t\t}),\n\t\t\t\tencode: SchemaGetter.transform((element: Element) => element.outerHTML),\n\t\t\t}),\n\t\t\tSchema.NullOr,\n\t\t),\n\t);\n}\n"],"mappings":";;;;;;;;;;AAMA,IAAa,QAAQ,OAAO,OAAO;CAClC,UAAU,OAAO,SAChB,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,KAC3B,OAAO,SAAS,OAAO,QAAQ;EAC9B,QAAQ,aAAa,WAAW,aAC/B,SAAS,KAAK,GAAG,CAClB;EACA,QAAQ,aAAa,WAAW,QAAgB,IAAI,MAAM,GAAG,CAAC;CAC/D,CAAC,CACF,CACD;CACA,cAAc,OAAO,SAAS,OAAO,MAAM;AAC5C,CAAC;AAOD,IAAM,aAAqC,SAC1C,MAAM,KACL,IAAI,IAAI,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CACjD;AAED,SAAgB,mBAA2C,OAAU;CACpE,MAAM,OAAO,UAAU,KAAK;CAC5B,OAAO,OAAO,OACb,OAAO,SAAS,IAAI,GACpB,OAAO,OAAO,KACb,OAAO,SAAS,OAAO,WAAW,OAAO,GAAG;EAC3C,QAAQ,aAAa,iBAAiB,eAAuB;GAG5D,MAAM,OADM,IADO,UACP,CAAA,CAAO,gBAAgB,YAAY,WAClC,CAAA,CAAI,KAAK;GAEtB,IAAI,CAAC,MAIJ,OAAO,OAAO,KACb,IAAI,YAAY,aACf,EAAE,SAAS,2CAA2C,GACtD,UACD,CACD;GAGD,OAAO,OAAO,QAAQ,IAAI;EAC3B,CAAC;EACD,QAAQ,aAAa,WAAW,YAAqB,QAAQ,SAAS;CACvE,CAAC,GACD,OAAO,MACR,CACD;AACD"}

package/dist/effect/Ajax/Window/data/AllowedRouteOrigins.js

@@ -0,0 +1,75 @@
+import { __exportAll } from "../../../_virtual/_rolldown/runtime.js";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+//#region src/effect/Ajax/Window/data/AllowedRouteOrigins.ts
+var AllowedRouteOrigins_exports = /* @__PURE__ */ __exportAll({
+	Origins: () => Origins,
+	layer: () => layer
+});
+/**
+* Origins, besides the storefront's own, that a route in the table may point
+* at.
+*
+* ## Why this exists
+*
+* The route table is `{ ...Defaults, ...window.BrytDesigns.routes }`, and the
+* URL used to be built by concatenating it onto the origin. A route of
+* `"@evil.com/collect"` therefore produced
+* `https://shop.myshopify.com@evil.com/collect`, which parses the storefront
+* as *userinfo* and `evil.com` as the host — every cart request, with the
+* shopper's session cookies, sent off-origin. Routes are resolved with `new
+* URL` now and checked against the storefront origin.
+*
+* That check would otherwise make a *deliberate* off-origin route impossible,
+* which is a real thing to want: a storefront fronting its cart endpoints
+* through a proxy or an edge worker on another host. This reference is the
+* seam for it.
+*
+* ## What it is and is not
+*
+* It is not a privilege boundary. Whoever can write `window.BrytDesigns` can
+* write both the routes and this list — and could patch `fetch` besides. What
+* the pair buys is that going off-origin has to be **stated**: a typo
+* (`"cart.js"` without its leading slash) and a smuggled host both fail
+* loudly, while the supported case is one explicit line that shows up in a
+* code review and in the page source.
+*
+* Empty by default, so the storefront origin is the only one accepted.
+*
+* @example
+* ```html
+* <!-- In the theme, before the modules load. -->
+* <script>
+*   window.BrytDesigns = window.BrytDesigns || {};
+*   window.BrytDesigns.allowedRouteOrigins = ["https://cart-proxy.example"];
+*   window.BrytDesigns.routes = { cart_url: "https://cart-proxy.example/cart.js" };
+* <\/script>
+* ```
+*
+* @example
+* ```ts
+* // From Effect, without a DOM.
+* Effect.provideService(effect, Ajax.Window.AllowedRouteOrigins.Origins, [
+*   "https://cart-proxy.example",
+* ]);
+* ```
+*/
+var Origins = Context.Reference("@brytdesigns/shopify-utils/AllowedRouteOrigins", { defaultValue: () => {
+	if (typeof window === "undefined") return [];
+	const configured = window?.BrytDesigns?.allowedRouteOrigins;
+	if (!Array.isArray(configured)) return [];
+	return configured.flatMap((value) => {
+		try {
+			return [new URL(String(value)).origin];
+		} catch {
+			console.warn(`[brytdesigns] ignoring unparseable entry in window.BrytDesigns.allowedRouteOrigins: ${String(value)}`);
+			return [];
+		}
+	});
+} });
+/** Pins the allow-list for a whole program. */
+var layer = (origins) => Layer.succeed(Origins, origins);
+//#endregion
+export { AllowedRouteOrigins_exports, Origins, layer };
+
+//# sourceMappingURL=AllowedRouteOrigins.js.map

package/dist/effect/Ajax/Window/data/AllowedRouteOrigins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AllowedRouteOrigins.js","names":[],"sources":["../../../../../src/effect/Ajax/Window/data/AllowedRouteOrigins.ts"],"sourcesContent":["import * as Context from \"effect/Context\";\nimport * as Layer from \"effect/Layer\";\n\n/**\n * Origins, besides the storefront's own, that a route in the table may point\n * at.\n *\n * ## Why this exists\n *\n * The route table is `{ ...Defaults, ...window.BrytDesigns.routes }`, and the\n * URL used to be built by concatenating it onto the origin. A route of\n * `\"@evil.com/collect\"` therefore produced\n * `https://shop.myshopify.com@evil.com/collect`, which parses the storefront\n * as *userinfo* and `evil.com` as the host — every cart request, with the\n * shopper's session cookies, sent off-origin. Routes are resolved with `new\n * URL` now and checked against the storefront origin.\n *\n * That check would otherwise make a *deliberate* off-origin route impossible,\n * which is a real thing to want: a storefront fronting its cart endpoints\n * through a proxy or an edge worker on another host. This reference is the\n * seam for it.\n *\n * ## What it is and is not\n *\n * It is not a privilege boundary. Whoever can write `window.BrytDesigns` can\n * write both the routes and this list — and could patch `fetch` besides. What\n * the pair buys is that going off-origin has to be **stated**: a typo\n * (`\"cart.js\"` without its leading slash) and a smuggled host both fail\n * loudly, while the supported case is one explicit line that shows up in a\n * code review and in the page source.\n *\n * Empty by default, so the storefront origin is the only one accepted.\n *\n * @example\n * ```html\n * <!-- In the theme, before the modules load. -->\n * <script>\n *   window.BrytDesigns = window.BrytDesigns || {};\n *   window.BrytDesigns.allowedRouteOrigins = [\"https://cart-proxy.example\"];\n *   window.BrytDesigns.routes = { cart_url: \"https://cart-proxy.example/cart.js\" };\n * </script>\n * ```\n *\n * @example\n * ```ts\n * // From Effect, without a DOM.\n * Effect.provideService(effect, Ajax.Window.AllowedRouteOrigins.Origins, [\n *   \"https://cart-proxy.example\",\n * ]);\n * ```\n */\nexport const Origins: Context.Reference<readonly string[]> = Context.Reference<\n\treadonly string[]\n>(\"@brytdesigns/shopify-utils/AllowedRouteOrigins\", {\n\t// Read lazily and defensively, for the same reasons as the route table:\n\t// `window?.` does not protect against the identifier being undeclared, and\n\t// the default has to work from Node so `ajax-client`'s tests need no jsdom.\n\tdefaultValue: () => {\n\t\tif (typeof window === \"undefined\") return [];\n\t\tconst configured = window?.BrytDesigns?.allowedRouteOrigins;\n\t\tif (!Array.isArray(configured)) return [];\n\t\t// Normalised through `URL` so that a trailing slash or a different case\n\t\t// in the theme's string still matches what `URL.origin` reports.\n\t\treturn configured.flatMap((value) => {\n\t\t\ttry {\n\t\t\t\treturn [new URL(String(value)).origin];\n\t\t\t} catch {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[brytdesigns] ignoring unparseable entry in window.BrytDesigns.allowedRouteOrigins: ${String(value)}`,\n\t\t\t\t);\n\t\t\t\treturn [];\n\t\t\t}\n\t\t});\n\t},\n});\n\n/** Pins the allow-list for a whole program. */\nexport const layer = (origins: readonly string[]): Layer.Layer<never> =>\n\tLayer.succeed(Origins, origins);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,IAAa,UAAgD,QAAQ,UAEnE,kDAAkD,EAInD,oBAAoB;CACnB,IAAI,OAAO,WAAW,aAAa,OAAO,CAAC;CAC3C,MAAM,aAAa,QAAQ,aAAa;CACxC,IAAI,CAAC,MAAM,QAAQ,UAAU,GAAG,OAAO,CAAC;CAGxC,OAAO,WAAW,SAAS,UAAU;EACpC,IAAI;GACH,OAAO,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM;EACtC,QAAQ;GACP,QAAQ,KACP,uFAAuF,OAAO,KAAK,GACpG;GACA,OAAO,CAAC;EACT;CACD,CAAC;AACF,EACD,CAAC;;AAGD,IAAa,SAAS,YACrB,MAAM,QAAQ,SAAS,OAAO"}