@brytdesigns/shopify-utils 1.2.21 → 3.0.0

package/dist/effect/index.d.ts

@@ -1,13 +1,363 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import * as Cause from 'effect/Cause';
+import * as Context from 'effect/Context';
 import * as Data from 'effect/Data';
 import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
 import * as LogLevel from 'effect/LogLevel';
-import { ParseError } from 'effect/ParseResult';
 import * as Schema from 'effect/Schema';
+import * as Scope from 'effect/Scope';
 
+declare const toAsyncCallback: <Args extends ReadonlyArray<unknown>, A, E, R>(services: Context.Context<R>, f: (...args: Args) => Effect.Effect<A, E, R>) => (...args: Args) => Promise<A>;
+declare const toSyncCallback: <Args extends ReadonlyArray<unknown>, A, R>(services: Context.Context<R>, f: (...args: Args) => Effect.Effect<A, never, R>, onAbnormal: (cause: Cause.Cause<never>) => A) => (...args: Args) => A;
+declare const fromPromiseThunk: <A, E>(thunk: () => Promise<A>, onReject: (cause: unknown) => E) => Effect.Effect<A, E>;
+/** Every action exposed on `window.Shopify.actions`. */
+export type ActionName = "getCart" | "updateCart" | "openCart";
+/**
+ * Only `updateCart` and `openCart` are `ActionFunction`s — `getCart` is a bare
+ * callable with no `configure()` / `isDefault()`.
+ */
+export type ConfigurableActionName = Exclude<ActionName, "getCart">;
+declare const ActionsUnavailableError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{
+	readonly [P in keyof A as P extends "_tag" ? never : P]: A[P];
+}>) => import("effect/Cause").YieldableError & {
+	readonly _tag: "@brytdesigns/shopify-utils/ActionsUnavailableError";
+} & Readonly<A>;
+declare class ActionsUnavailableError extends ActionsUnavailableError_base<{
+	readonly action: ActionName;
+	readonly message: string;
+}> {
+	constructor(options: {
+		readonly action: ActionName;
+	});
+}
+declare const ActionConfigurationRejectedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{
+	readonly [P in keyof A as P extends "_tag" ? never : P]: A[P];
+}>) => import("effect/Cause").YieldableError & {
+	readonly _tag: "@brytdesigns/shopify-utils/ActionConfigurationRejectedError";
+} & Readonly<A>;
+declare class ActionConfigurationRejectedError extends ActionConfigurationRejectedError_base<{
+	readonly action: ConfigurableActionName;
+	readonly message: string;
+}> {
+	constructor(options: {
+		readonly action: ConfigurableActionName;
+	});
+}
+declare const ActionInvocationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{
+	readonly [P in keyof A as P extends "_tag" ? never : P]: A[P];
+}>) => import("effect/Cause").YieldableError & {
+	readonly _tag: "@brytdesigns/shopify-utils/ActionInvocationError";
+} & Readonly<A>;
+declare class ActionInvocationError extends ActionInvocationError_base<{
+	readonly action: ActionName;
+	readonly cause: unknown;
+	readonly message: string;
+}> {
+	constructor(options: {
+		readonly action: ActionName;
+		readonly cause: unknown;
+	});
+}
+// -----------------------------------------------------------------------------
+// VENDORED FILE — DO NOT EDIT BY HAND.
+//
+// Source:    https://cdn.shopify.com/storefront/standard-actions.d.ts
+// Vendored:  2026-08-13
+// Upstream version (see `// version:` line below): 977e4f914dd2b3eca85ad01dee81c2c96eb1b2e5
+// sha256 (upstream body only, i.e. everything below this header):
+//            2f0fc044f35999cd09550b8b68620077601d1409817edae16745e600417788e7
+//
+// Everything below this header is the upstream file byte-for-byte. To diff
+// against a future revision:
+//
+//   curl -sSL https://cdn.shopify.com/storefront/standard-actions.d.ts \
+//     | diff - <(tail -n +25 shopify/utils/src/types/standard-actions.d.ts)
+//
+// There is NO npm package for this. Shopify injects the runtime on every Liquid
+// storefront as `window.Shopify.actions`; a module build for import maps lives
+// at https://cdn.shopify.com/storefront/standard-actions.js. Do not add a
+// dependency — import types via the `@theme/standard-actions` alias
+// (see tsconfig.json `paths`), which is marked `external` in tsup.config.ts.
+//
+// This file is excluded from Biome in the root biome.json so formatting/lint
+// never rewrites upstream content and pollutes the diff.
+// -----------------------------------------------------------------------------
+// version: 977e4f914dd2b3eca85ad01dee81c2c96eb1b2e5
+export interface Price {
+	amount: string;
+	currencyCode: string;
+}
+export interface CartDiscountCode {
+	applicable: boolean;
+	code: string;
+}
+export interface CartCost {
+	totalAmount: Price;
+}
+export interface CartLine {
+	id: string;
+	quantity: number;
+	cost: CartCost;
+}
+export interface CartMutationUserError {
+	code?: string;
+	field?: string[];
+	message: string;
+}
+export interface CartMutationWarning {
+	code?: string;
+	message: string;
+	target?: string;
+}
+declare const CART_UPDATE_CONTEXTS: readonly [
+	"product",
+	"cart",
+	"dialog",
+	"standard-action"
+];
+export type CartUpdateContext = (typeof CART_UPDATE_CONTEXTS)[number];
+declare const CART_UPDATE_ACTIONS: readonly [
+	"add",
+	"remove",
+	"update"
+];
+export type CartUpdateAction = (typeof CART_UPDATE_ACTIONS)[number];
+export type ActionArgs<P, O = void> = [
+	P
+] extends [
+	void
+] ? [
+	options?: O
+] : [
+	Extract<P, void>
+] extends [
+	never
+] ? [
+	payload: P,
+	options?: O
+] : [
+	payload?: Exclude<P, void>,
+	options?: O
+];
+export type UpdateCartUserError = CartMutationUserError;
+export type UpdateCartWarning = CartMutationWarning;
+export interface CartAttributeInput {
+	key: string;
+	value: string;
+}
+export interface StorefrontCartLinesConnection {
+	nodes: CartLine[];
+}
+export interface StorefrontCartSummary {
+	id: string;
+	totalQuantity: number;
+	cost: CartCost;
+	lines: StorefrontCartLinesConnection;
+	discountCodes: CartDiscountCode[];
+}
+export type UpdateCartEventTargetMeta = {
+	type: "shopify:cart:lines-update";
+	action: CartUpdateAction;
+} | {
+	type: "shopify:cart:note-update" | "shopify:cart:attributes-update" | "shopify:cart:discount-update" | "shopify:cart:error";
+};
+export interface CartLineInput {
+	/**
+	 * Existing-line id from SFAPI or the AJAX cart API.
+	 * CartLine GIDs keep or receive a `?cart=` suffix automatically when the cart id is known.
+	 * Present = update/remove; absent = add.
+	 */
+	id?: string;
+	/** ProductVariant GID or raw variant id. Required for add. */
+	merchandiseId?: string;
+	/** Set to 0 to remove. */
+	quantity: number;
+	/** Line item-level custom attributes */
+	attributes?: CartAttributeInput[];
+	/** Selling plan GID or raw selling plan id. */
+	sellingPlanId?: string;
+}
+export interface UpdateCartPayload {
+	/** Cart GID or raw cart token. If omitted, discovered from the cart cookie. */
+	cartId?: string;
+	lines?: CartLineInput[];
+	note?: string;
+	discountCodes?: string[];
+	/** Cart-level custom attributes */
+	attributes?: CartAttributeInput[];
+}
+export interface UpdateCartResult {
+	cart: StorefrontCartSummary;
+	userErrors?: UpdateCartUserError[];
+	warnings?: UpdateCartWarning[];
+	detail?: Record<string, any>;
+}
+export interface UpdateCartOptions {
+	signal?: AbortSignal;
+	event?: {
+		detail?: Record<string, any>;
+		context?: CartUpdateContext;
+	};
+}
+export interface GetCartPayload {
+	/** Cart GID or raw cart token. If omitted, discovered from the browser cookie. */
+	cartId?: string;
+}
+export interface GetCartResult {
+	cart: StorefrontCartSummary | null;
+	detail?: Record<string, any>;
+}
+export interface GetCartOptions {
+	signal?: AbortSignal;
+}
+/**
+ * The default handler, lifted into Effect-land.
+ *
+ * Handlers receive this rather than a pre-computed result so they keep the full
+ * range of the upstream contract: run the default, wrap it, retry it, race it,
+ * or skip it entirely and synthesise a result.
+ */
+export type DefaultHandler<A> = Effect.Effect<A, ActionInvocationError>;
+/**
+ * An action handler written in Effect.
+ *
+ * The returned Effect's success value is what the action resolves with, and its
+ * failure becomes a rejected promise for Shopify.
+ *
+ * Note that `E` is checked but never surfaces to the fiber that called
+ * `configure` — the handler runs long afterwards, when a shopper triggers the
+ * action, so its failure has nowhere to go but the promise Shopify awaits. If
+ * you want handler failures observed, observe them inside the handler.
+ */
+export type Handler<P, A, O, E, R> = (defaultHandler: DefaultHandler<A>, ...args: ActionArgs<P, O>) => Effect.Effect<A, E, R>;
+/**
+ * Resolves the element that `shopify:cart:*` events are dispatched from.
+ *
+ * The error channel is `never` on purpose. Shopify calls this synchronously and
+ * uses the return value immediately, so there is nowhere for a failure to go —
+ * handle errors inside the Effect and fall back to an element or `null`.
+ *
+ * For the same reason this Effect must complete synchronously. Anything that
+ * suspends (`Effect.sleep`, an HTTP call, an async service) cannot produce a
+ * value in time and is reported as `null` with a logged defect, which makes
+ * Shopify dispatch on `document`. If you need async work, resolve it ahead of
+ * time into a `Ref` and read the `Ref` here.
+ */
+export type EventTargetResolver<R> = (meta: UpdateCartEventTargetMeta) => Effect.Effect<EventTarget | null, never, R>;
+export interface UpdateCartConfiguration<E, R> {
+	readonly eventTarget: EventTargetResolver<R>;
+	/** Optional: routing events without changing cart behaviour is valid. */
+	readonly handler?: Handler<UpdateCartPayload, UpdateCartResult, UpdateCartOptions, E, R>;
+}
+export interface OpenCartConfiguration<E, R> {
+	/**
+	 * Required, unlike `updateCart`'s. `openCart` has no event target, so a
+	 * configuration without a handler would claim the one-shot upstream slot
+	 * while contributing nothing — locking everyone else out for the life of
+	 * the page in exchange for default behaviour.
+	 */
+	readonly handler: Handler<void, void, void, E, R>;
+}
+export interface ShopifyStorefrontActionsImpl {
+	/**
+	 * Read the current cart. `getCart` is a bare callable upstream — it has no
+	 * `configure()`, so there is no `configureGetCart`.
+	 */
+	readonly getCart: (payload?: GetCartPayload, options?: GetCartOptions) => Effect.Effect<GetCartResult, ActionsUnavailableError | ActionInvocationError>;
+	readonly updateCart: (payload: UpdateCartPayload, options?: UpdateCartOptions) => Effect.Effect<UpdateCartResult, ActionsUnavailableError | ActionInvocationError>;
+	readonly openCart: Effect.Effect<void, ActionsUnavailableError | ActionInvocationError>;
+	/**
+	 * Install an Effect-based `updateCart` configuration for the lifetime of the
+	 * enclosing `Scope`.
+	 *
+	 * The `R` of the supplied Effects flows out into the returned Effect's
+	 * requirements, so the services your handler needs stay explicit and must be
+	 * provided before this runs — they are captured, not smuggled.
+	 *
+	 * Calling this more than once rebinds rather than failing: we claim the
+	 * upstream slot once and swap our own configuration behind it. A
+	 * `ActionConfigurationRejectedError` therefore means one specific thing —
+	 * something outside this library claimed the action first.
+	 *
+	 * For page-lifetime registration, build it into a layer with
+	 * `Layer.effectDiscard(Actions.configureUpdateCart({ ... }))` so the
+	 * registration lives exactly as long as the runtime does.
+	 */
+	readonly configureUpdateCart: <E, R>(config: UpdateCartConfiguration<E, R>) => Effect.Effect<void, ActionsUnavailableError | ActionConfigurationRejectedError, R | Scope.Scope>;
+	readonly configureOpenCart: <E, R>(config: OpenCartConfiguration<E, R>) => Effect.Effect<void, ActionsUnavailableError | ActionConfigurationRejectedError, R | Scope.Scope>;
+	/**
+	 * Upstream's own notion: `true` until the action's slot is claimed.
+	 *
+	 * Because the slot can never be released, this stays `false` once we have
+	 * claimed it, even after every configuration has been deactivated.
+	 */
+	readonly isDefault: (action: ConfigurableActionName) => Effect.Effect<boolean, ActionsUnavailableError>;
+}
+declare const ShopifyStorefrontActions_base: Context.ServiceClass<ShopifyStorefrontActions, "@brytdesigns/shopify-utils/ShopifyStorefrontActions", ShopifyStorefrontActionsImpl>;
+declare class ShopifyStorefrontActions extends ShopifyStorefrontActions_base {
+}
+declare const layer: Layer.Layer<ShopifyStorefrontActions, never, never>;
+declare const getCart: (payload?: GetCartPayload, options?: GetCartOptions) => Effect.Effect<GetCartResult, ActionsUnavailableError | ActionInvocationError, ShopifyStorefrontActions>;
+declare const updateCart: (payload: UpdateCartPayload, options?: UpdateCartOptions) => Effect.Effect<UpdateCartResult, ActionsUnavailableError | ActionInvocationError, ShopifyStorefrontActions>;
+declare const openCart: Effect.Effect<void, ActionsUnavailableError | ActionInvocationError, ShopifyStorefrontActions>;
+declare const configureUpdateCart: <E, R>(config: UpdateCartConfiguration<E, R>) => Effect.Effect<void, ActionsUnavailableError | ActionConfigurationRejectedError, Scope.Scope | ShopifyStorefrontActions | R>;
+declare const configureOpenCart: <E, R>(config: OpenCartConfiguration<E, R>) => Effect.Effect<void, ActionsUnavailableError | ActionConfigurationRejectedError, Scope.Scope | ShopifyStorefrontActions | R>;
+declare const isDefault: (action: ConfigurableActionName) => Effect.Effect<boolean, ActionsUnavailableError, ShopifyStorefrontActions>;
+export type Input = typeof Input;
+declare const Input: Schema.Struct<{
+	readonly sections: Schema.optional<Schema.decodeTo<Schema.String, Schema.$Array<Schema.String>, never, never>>;
+	readonly sections_url: Schema.optional<Schema.String>;
+}>;
+export type UniqueKeys<T extends string> = T extends `${infer K},${infer Rest}` ? K | UniqueKeys<Rest> : T;
+declare function makeResponseSchema<const T extends string>(input: T): Schema.$Record<Schema.Literals<UniqueKeys<T>[]>, Schema.NullOr<Schema.decodeTo<Schema.instanceOf<Element, Element>, Schema.String, never, never>>>;
+declare const Origins: Context.Reference<readonly string[]>;
+declare const layer$1: (origins: readonly string[]) => Layer.Layer<never>;
+export interface IShopifyRoutes {
+	readonly account_addresses_url: string;
+	readonly account_login_url: string;
+	readonly account_logout_url: string;
+	readonly account_recover_url: string;
+	readonly account_register_url: string;
+	readonly account_url: string;
+	readonly all_products_collection_url: string;
+	readonly product_url: string;
+	readonly products_url: string;
+	readonly cart_add_url: string;
+	readonly cart_change_url: string;
+	readonly cart_clear_url: string;
+	readonly cart_update_url: string;
+	readonly cart_url: string;
+	readonly collections_url: string;
+	readonly predictive_search_url: string;
+	readonly product_recommendations_url: string;
+	readonly root_url: string;
+	readonly search_url: string;
+	readonly storefront_login_url: string;
+}
+export interface IStorefrontClientConfig {
+	readonly accessToken: string;
+	readonly shopName: string;
+	apiVersion: string;
+}
+declare const Defaults: IShopifyRoutes;
+declare class ShopifyRoutes extends Data.Class<IShopifyRoutes> {
+	constructor();
+}
+declare const make: () => ShopifyRoutes;
+declare const Routes: Context.Reference<IShopifyRoutes>;
+declare const layer$2: (routes: IShopifyRoutes) => Layer.Layer<never>;
+declare class StorefrontClientConfig extends Data.Class<IStorefrontClientConfig> {
+	constructor();
+}
+declare const make$1: () => StorefrontClientConfig;
+declare const Origin: Context.Reference<string>;
+declare const layer$3: (origin: string) => Layer.Layer<never>;
+declare const filterLevelOrNever: <A, E, R>(level: LogLevel.LogLevel, effect: Effect.Effect<A, E, R>) => Effect.Effect<A | undefined, E, R>;
+declare const makeNamespacedLogSpan: (prefix: string) => (label: string) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 export type Type = Schema.Schema.Type<typeof Type>;
-declare const Type: Schema.Literal<[
+declare const Type: Schema.Literals<readonly [
 	"Cart",
 	"Collection",
 	"Customer",
@@ -42,89 +392,57 @@ declare const Type: Schema.Literal<[
 	"StaffMember",
 	"Theme"
 ]>;
-export type GID = Schema.Schema.Encoded<typeof GID>;
-declare const GID: Schema.filter<typeof Schema.String>;
-export type ID = Schema.Schema.Encoded<typeof ID>;
-declare const ID: Schema.Union<[
-	typeof Schema.Number,
-	typeof Schema.NumberFromString,
-	typeof Schema.String
+export type GID = Schema.Codec.Encoded<typeof GID>;
+declare const GID: Schema.String;
+export type ID = Schema.Codec.Encoded<typeof ID>;
+declare const ID: Schema.Union<readonly [
+	Schema.Number,
+	Schema.NumberFromString,
+	Schema.String
 ]>;
 export type FormatOptions<T extends ID, R extends Type> = {
 	id: T;
 	type: R;
 };
-declare const format: <const T extends ID, const R extends Type>({ id, type, }: FormatOptions<T, R>) => Effect.Effect<`gid://shopify/${R}/${T}`, ParseError, never>;
-declare const parse: (input: string) => Effect.Effect<string | number, ParseError, never>;
-export interface IShopifyRoutes {
-	readonly account_addresses_url: string;
-	readonly account_login_url: string;
-	readonly account_logout_url: string;
-	readonly account_recover_url: string;
-	readonly account_register_url: string;
-	readonly account_url: string;
-	readonly all_products_collection_url: string;
-	readonly product_url: string;
-	readonly products_url: string;
-	readonly cart_add_url: string;
-	readonly cart_change_url: string;
-	readonly cart_clear_url: string;
-	readonly cart_update_url: string;
-	readonly cart_url: string;
-	readonly collections_url: string;
-	readonly predictive_search_url: string;
-	readonly product_recommendations_url: string;
-	readonly root_url: string;
-	readonly search_url: string;
-	readonly storefront_login_url: string;
+declare const format: <const T extends ID, const R extends Type>({ id, type, }: FormatOptions<T, R>) => Effect.Effect<`gid://shopify/${R}/${T}`, Schema.SchemaError, never>;
+declare const parse: (input: string) => Effect.Effect<string | number, Schema.SchemaError, never>;
+
+declare namespace Bridge {
+	export { fromPromiseThunk, toAsyncCallback, toSyncCallback };
 }
-export interface IStorefrontClientConfig {
-	readonly accessToken: string;
-	readonly shopName: string;
-	apiVersion: string;
+declare namespace Resource {
+	export { GID, ID, Type, format, parse };
 }
-declare const Defaults: IShopifyRoutes;
-declare class ShopifyRoutes extends Data.Class<IShopifyRoutes> {
-	constructor();
+declare namespace Sections {
+	export { Input, makeResponseSchema };
 }
-declare const make: () => ShopifyRoutes;
-declare class StorefrontClientConfig extends Data.Class<IStorefrontClientConfig> {
-	constructor();
+declare namespace StorefrontOrigin {
+	export { Origin, layer$3 as layer };
 }
-declare const make$1: () => StorefrontClientConfig;
-export type Input = typeof Input;
-declare const Input: Schema.Struct<{
-	sections: Schema.optional<Schema.transform<Schema.Array$<typeof Schema.String>, typeof Schema.String>>;
-	sections_url: Schema.optional<typeof Schema.String>;
-}>;
-export type UniqueKeys<T extends string> = T extends `${infer K},${infer Rest}` ? K | UniqueKeys<Rest> : T;
-declare function makeResponseSchema<const T extends string>(input: T): Schema.Record$<Schema.SchemaClass<UniqueKeys<T>, UniqueKeys<T>, never>, Schema.NullOr<Schema.transformOrFail<typeof Schema.String, Schema.instanceOf<Element>, never>>>;
-declare const filterLevelOrNever: <A, E, R>(level: LogLevel.LogLevel, effect: Effect.Effect<A, E, R>) => Effect.Effect<A | undefined, E, R>;
-declare const makeNamespacedLogSpan: (prefix: string) => (label: string) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
-
-declare namespace StorefrontClientConfig$1 {
-	export { StorefrontClientConfig, make$1 as make };
+declare namespace AllowedRouteOrigins {
+	export { Origins, layer$1 as layer };
 }
 declare namespace ShopifyRoutes$1 {
-	export { Defaults, ShopifyRoutes, make };
-}
-declare namespace Window$1 {
-	export { ShopifyRoutes$1 as ShopifyRoutes, StorefrontClientConfig$1 as StorefrontClientConfig };
+	export { Defaults, Routes, ShopifyRoutes, layer$2 as layer, make };
 }
-declare namespace Sections {
-	export { Input, makeResponseSchema };
+declare namespace StorefrontClientConfig$1 {
+	export { StorefrontClientConfig, make$1 as make };
 }
-declare namespace Logging {
-	export { filterLevelOrNever, makeNamespacedLogSpan };
+declare namespace Window$1 {
+	export { AllowedRouteOrigins, ShopifyRoutes$1 as ShopifyRoutes, StorefrontClientConfig$1 as StorefrontClientConfig, StorefrontOrigin };
 }
-declare namespace Resource {
-	export { GID, ID, Type, format, parse };
+declare namespace Actions {
+	export { ActionConfigurationRejectedError, ActionInvocationError, ActionName, ActionsUnavailableError, Bridge, CartAttributeInput, CartCost, CartDiscountCode, CartLine, CartLineInput, CartMutationUserError, CartMutationWarning, CartUpdateAction, CartUpdateContext, ConfigurableActionName, DefaultHandler, EventTargetResolver, GetCartOptions, GetCartPayload, GetCartResult, Handler, OpenCartConfiguration, Price, ShopifyStorefrontActions, ShopifyStorefrontActionsImpl, StorefrontCartLinesConnection, StorefrontCartSummary, UpdateCartConfiguration, UpdateCartEventTargetMeta, UpdateCartOptions, UpdateCartPayload, UpdateCartResult, UpdateCartUserError, UpdateCartWarning, configureOpenCart, configureUpdateCart, getCart, isDefault, layer, openCart, updateCart };
 }
 declare namespace Ajax {
 	export { Sections, Window$1 as Window };
 }
+declare namespace Logging {
+	export { filterLevelOrNever, makeNamespacedLogSpan };
+}
 
 export {
+	Actions,
 	Ajax,
 	Logging,
 	Resource,

package/dist/effect/index.js

@@ -1,8 +1,5 @@
-import * as index_js$2 from './Resource/index.js';
-export { index_js$2 as Resource };
-import * as index_js from './Ajax/index.js';
-export { index_js as Ajax };
-import * as index_js$1 from './Logging/index.js';
-export { index_js$1 as Logging };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { Actions_exports } from "./Actions/index.js";
+import { Ajax_exports } from "./Ajax/index.js";
+import { Logging_exports } from "./Logging/index.js";
+import { Resource_exports } from "./Resource/index.js";
+export { Actions_exports as Actions, Ajax_exports as Ajax, Logging_exports as Logging, Resource_exports as Resource };

package/dist/main/_virtual/_rolldown/runtime.js

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll };

package/dist/main/actions.js

@@ -0,0 +1,78 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { ActionConfigurationRejectedError, ActionInvocationError, ActionsUnavailableError } from "./effect/Actions/errors.js";
+import { configureOpenCart as configureOpenCart$1, configureUpdateCart as configureUpdateCart$1, getCart as getCart$1, isDefault as isDefault$1, layer, openCart as openCart$1, updateCart as updateCart$1 } from "./effect/Actions/service.js";
+import "./effect/index.js";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Scope from "effect/Scope";
+//#region src/actions.ts
+var actions_exports = /* @__PURE__ */ __exportAll({
+	ActionConfigurationRejectedError: () => ActionConfigurationRejectedError,
+	ActionInvocationError: () => ActionInvocationError,
+	ActionsUnavailableError: () => ActionsUnavailableError,
+	configureOpenCart: () => configureOpenCart,
+	configureUpdateCart: () => configureUpdateCart,
+	getCart: () => getCart,
+	isDefault: () => isDefault,
+	openCart: () => openCart,
+	updateCart: () => updateCart
+});
+/**
+* Run to a promise that rejects with the failure itself.
+*
+* `Effect.runPromise` rejects with a `FiberFailure` wrapping the error, which
+* would force a plain-JS caller to understand Effect internals to get at their
+* own tagged error. Squashing the cause means `catch (e)` sees the
+* `ActionsUnavailableError` directly and `instanceof` behaves as expected.
+*/
+var settle = async (effect) => {
+	const exit = await Effect.runPromiseExit(Effect.provide(effect, layer));
+	if (Exit.isSuccess(exit)) return exit.value;
+	throw Cause.squash(exit.cause);
+};
+/**
+* Run a scoped configuration and hand back its teardown.
+*
+* The scope is deliberately not closed on success — the configuration must
+* outlive this call. It is closed if configuring fails, so a failed attempt
+* leaves nothing registered.
+*/
+var runScoped = async (effect) => {
+	const scope = Effect.runSync(Scope.make());
+	const dispose = () => Effect.runPromise(Scope.close(scope, Exit.void));
+	const exit = await Effect.runPromiseExit(effect.pipe(Scope.provide(scope), Effect.provide(layer)));
+	if (Exit.isFailure(exit)) {
+		await dispose();
+		throw Cause.squash(exit.cause);
+	}
+	return dispose;
+};
+/** Read the current cart. */
+var getCart = (payload, options) => settle(getCart$1(payload, options));
+/** Mutate the cart through Shopify's action, honouring any configuration. */
+var updateCart = (payload, options) => settle(updateCart$1(payload, options));
+/** Open the cart through Shopify's action. */
+var openCart = () => settle(openCart$1);
+/** Upstream's own notion: `true` until the action's slot is claimed. */
+var isDefault = (action) => settle(isDefault$1(action));
+/**
+* Install an `updateCart` configuration, resolving to its teardown.
+*
+* Calling this again rebinds rather than failing. A rejection with
+* `ActionConfigurationRejectedError` means something outside this library
+* claimed the action first.
+*/
+var configureUpdateCart = (config = {}) => {
+	const { eventTarget, handler } = config;
+	return runScoped(configureUpdateCart$1({
+		eventTarget: (meta) => Effect.sync(() => eventTarget?.(meta) ?? null),
+		...handler === void 0 ? {} : { handler: (defaultAction, payload, options) => Effect.promise(() => handler(() => Effect.runPromise(defaultAction), payload, options)) }
+	}));
+};
+/** Install an `openCart` configuration, resolving to its teardown. */
+var configureOpenCart = (config) => runScoped(configureOpenCart$1({ handler: (defaultAction) => Effect.promise(() => config.handler(() => Effect.runPromise(defaultAction))) }));
+//#endregion
+export { ActionConfigurationRejectedError, ActionInvocationError, ActionsUnavailableError, actions_exports, configureOpenCart, configureUpdateCart, getCart, isDefault, openCart, updateCart };
+
+//# sourceMappingURL=actions.js.map

package/dist/main/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","names":[],"sources":["../../src/actions.ts"],"sourcesContent":["import * as Cause from \"effect/Cause\";\nimport * as Effect from \"effect/Effect\";\nimport * as Exit from \"effect/Exit\";\nimport * as Scope from \"effect/Scope\";\n\nimport { Actions } from \"./effect/index.js\";\n\n/**\n * Promise-based access to Shopify's storefront cart actions, for consumers that\n * are not written in Effect.\n *\n * This is a facade over `./effect`'s `Actions`, not a reimplementation, so it\n * inherits the behaviour that matters: the one-shot upstream `configure()` slot\n * is claimed once and rebound thereafter, a missing runtime is distinguishable\n * from a refused configuration, and a configuration can be torn down.\n *\n * Errors arrive as rejections carrying the same tagged error instances the\n * Effect API fails with, so `instanceof ActionsUnavailableError` still works.\n */\n\nexport type Dispose = () => Promise<void>;\n\nexport type UpdateCartHandler = (\n\tdefaultHandler: () => Promise<Actions.UpdateCartResult>,\n\tpayload: Actions.UpdateCartPayload,\n\toptions?: Actions.UpdateCartOptions,\n) => Promise<Actions.UpdateCartResult>;\n\nexport type OpenCartHandler = (\n\tdefaultHandler: () => Promise<void>,\n) => Promise<void>;\n\nexport interface UpdateCartConfiguration {\n\t/**\n\t * Chooses the element `shopify:cart:*` events dispatch from. Returning\n\t * `null` — the default — leaves Shopify dispatching on `document`.\n\t *\n\t * Must be synchronous: Shopify uses the return value immediately.\n\t */\n\treadonly eventTarget?: (\n\t\tmeta: Actions.UpdateCartEventTargetMeta,\n\t) => EventTarget | null;\n\treadonly handler?: UpdateCartHandler;\n}\n\nexport interface OpenCartConfiguration {\n\treadonly handler: OpenCartHandler;\n}\n\n/**\n * Run to a promise that rejects with the failure itself.\n *\n * `Effect.runPromise` rejects with a `FiberFailure` wrapping the error, which\n * would force a plain-JS caller to understand Effect internals to get at their\n * own tagged error. Squashing the cause means `catch (e)` sees the\n * `ActionsUnavailableError` directly and `instanceof` behaves as expected.\n */\nconst settle = async <A, E>(\n\teffect: Effect.Effect<A, E, Actions.ShopifyStorefrontActions>,\n): Promise<A> => {\n\tconst exit = await Effect.runPromiseExit(\n\t\tEffect.provide(effect, Actions.layer),\n\t);\n\n\tif (Exit.isSuccess(exit)) return exit.value;\n\n\tthrow Cause.squash(exit.cause);\n};\n\n/**\n * Run a scoped configuration and hand back its teardown.\n *\n * The scope is deliberately not closed on success — the configuration must\n * outlive this call. It is closed if configuring fails, so a failed attempt\n * leaves nothing registered.\n */\nconst runScoped = async <E>(\n\teffect: Effect.Effect<\n\t\tvoid,\n\t\tE,\n\t\tActions.ShopifyStorefrontActions | Scope.Scope\n\t>,\n): Promise<Dispose> => {\n\tconst scope = Effect.runSync(Scope.make());\n\tconst dispose = () => Effect.runPromise(Scope.close(scope, Exit.void));\n\n\tconst exit = await Effect.runPromiseExit(\n\t\teffect.pipe(Scope.provide(scope), Effect.provide(Actions.layer)),\n\t);\n\n\tif (Exit.isFailure(exit)) {\n\t\tawait dispose();\n\t\tthrow Cause.squash(exit.cause);\n\t}\n\n\treturn dispose;\n};\n\n/** Read the current cart. */\nexport const getCart = (\n\tpayload?: Actions.GetCartPayload,\n\toptions?: Actions.GetCartOptions,\n): Promise<Actions.GetCartResult> => settle(Actions.getCart(payload, options));\n\n/** Mutate the cart through Shopify's action, honouring any configuration. */\nexport const updateCart = (\n\tpayload: Actions.UpdateCartPayload,\n\toptions?: Actions.UpdateCartOptions,\n): Promise<Actions.UpdateCartResult> =>\n\tsettle(Actions.updateCart(payload, options));\n\n/** Open the cart through Shopify's action. */\nexport const openCart = (): Promise<void> => settle(Actions.openCart);\n\n/** Upstream's own notion: `true` until the action's slot is claimed. */\nexport const isDefault = (\n\taction: Actions.ConfigurableActionName,\n): Promise<boolean> => settle(Actions.isDefault(action));\n\n/**\n * Install an `updateCart` configuration, resolving to its teardown.\n *\n * Calling this again rebinds rather than failing. A rejection with\n * `ActionConfigurationRejectedError` means something outside this library\n * claimed the action first.\n */\nexport const configureUpdateCart = (\n\tconfig: UpdateCartConfiguration = {},\n): Promise<Dispose> => {\n\tconst { eventTarget, handler } = config;\n\n\treturn runScoped(\n\t\tActions.configureUpdateCart({\n\t\t\t// A plain function cannot suspend, so wrapping it here makes the\n\t\t\t// synchronous-only contract impossible to violate from this surface.\n\t\t\teventTarget: (meta) => Effect.sync(() => eventTarget?.(meta) ?? null),\n\t\t\t...(handler === undefined\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\thandler: (defaultAction, payload, options) =>\n\t\t\t\t\t\t\tEffect.promise(() =>\n\t\t\t\t\t\t\t\thandler(\n\t\t\t\t\t\t\t\t\t() => Effect.runPromise(defaultAction),\n\t\t\t\t\t\t\t\t\tpayload,\n\t\t\t\t\t\t\t\t\toptions,\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t}),\n\t\t}),\n\t);\n};\n\n/** Install an `openCart` configuration, resolving to its teardown. */\nexport const configureOpenCart = (\n\tconfig: OpenCartConfiguration,\n): Promise<Dispose> =>\n\trunScoped(\n\t\tActions.configureOpenCart({\n\t\t\thandler: (defaultAction) =>\n\t\t\t\tEffect.promise(() =>\n\t\t\t\t\tconfig.handler(() => Effect.runPromise(defaultAction)),\n\t\t\t\t),\n\t\t}),\n\t);\n\nexport type {\n\tActionName,\n\tConfigurableActionName,\n} from \"./effect/Actions/errors.js\";\nexport {\n\tActionConfigurationRejectedError,\n\tActionInvocationError,\n\tActionsUnavailableError,\n} from \"./effect/Actions/errors.js\";\n\nexport type {\n\tGetCartOptions,\n\tGetCartPayload,\n\tGetCartResult,\n\tUpdateCartEventTargetMeta,\n\tUpdateCartOptions,\n\tUpdateCartPayload,\n\tUpdateCartResult,\n} from \"./effect/Actions/types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,IAAM,SAAS,OACd,WACgB;CAChB,MAAM,OAAO,MAAM,OAAO,eACzB,OAAO,QAAQ,QAAQ,KAAa,CACrC;CAEA,IAAI,KAAK,UAAU,IAAI,GAAG,OAAO,KAAK;CAEtC,MAAM,MAAM,OAAO,KAAK,KAAK;AAC9B;;;;;;;;AASA,IAAM,YAAY,OACjB,WAKsB;CACtB,MAAM,QAAQ,OAAO,QAAQ,MAAM,KAAK,CAAC;CACzC,MAAM,gBAAgB,OAAO,WAAW,MAAM,MAAM,OAAO,KAAK,IAAI,CAAC;CAErE,MAAM,OAAO,MAAM,OAAO,eACzB,OAAO,KAAK,MAAM,QAAQ,KAAK,GAAG,OAAO,QAAQ,KAAa,CAAC,CAChE;CAEA,IAAI,KAAK,UAAU,IAAI,GAAG;EACzB,MAAM,QAAQ;EACd,MAAM,MAAM,OAAO,KAAK,KAAK;CAC9B;CAEA,OAAO;AACR;;AAGA,IAAa,WACZ,SACA,YACoC,OAAO,UAAgB,SAAS,OAAO,CAAC;;AAG7E,IAAa,cACZ,SACA,YAEA,OAAO,aAAmB,SAAS,OAAO,CAAC;;AAG5C,IAAa,iBAAgC,OAAO,UAAgB;;AAGpE,IAAa,aACZ,WACsB,OAAO,YAAkB,MAAM,CAAC;;;;;;;;AASvD,IAAa,uBACZ,SAAkC,CAAC,MACb;CACtB,MAAM,EAAE,aAAa,YAAY;CAEjC,OAAO,UACN,sBAA4B;EAG3B,cAAc,SAAS,OAAO,WAAW,cAAc,IAAI,KAAK,IAAI;EACpE,GAAI,YAAY,KAAA,IACb,CAAC,IACD,EACA,UAAU,eAAe,SAAS,YACjC,OAAO,cACN,cACO,OAAO,WAAW,aAAa,GACrC,SACA,OACD,CACD,EACF;CACH,CAAC,CACF;AACD;;AAGA,IAAa,qBACZ,WAEA,UACC,oBAA0B,EACzB,UAAU,kBACT,OAAO,cACN,OAAO,cAAc,OAAO,WAAW,aAAa,CAAC,CACtD,EACF,CAAC,CACF"}