npm - @ikeboy003/cart - Versions diffs - 0.1.0 → 0.3.0 - Mend

@ikeboy003/cart 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/engine.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAEZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAuBpB,qBAAa,UAAU,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,8EAA8E;IAC9E,OAAO,CAAC,WAAW,CAAe;gBAEtB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;~~IAyB1C~~,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,YAAY;IAMpB,SAAS,GAAI,IAAI,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGxC;IAEF,2EAA2E;IAC3E,WAAW,QAAO,KAAK,EAAE,CAAqB;IAE9C,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,MAAM;IAOd,2EAA2E;IAC3E,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IActB,sDAAsD;IACtD,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYlD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,KAAK,IAAI,IAAI;IAMb,IAAI,KAAK,IAAI,KAAK,EAAE,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC;IAW/B,+EAA+E;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B,OAAO,CAAC,YAAY;YASN,IAAI;IASlB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,sEAAsE;IACtE,OAAO,IAAI,IAAI;CAQhB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ,EAC1D,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAC7B,UAAU,CAAC,KAAK,CAAC,CAEnB"}
1	+ {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAEZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAuBpB,qBAAa,UAAU,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,8EAA8E;IAC9E,OAAO,CAAC,WAAW,CAAe;gBAEtB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;IAgC1C,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,YAAY;IAMpB,SAAS,GAAI,IAAI,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGxC;IAEF,2EAA2E;IAC3E,WAAW,QAAO,KAAK,EAAE,CAAqB;IAE9C,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,MAAM;IAOd,2EAA2E;IAC3E,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IActB,sDAAsD;IACtD,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYlD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,KAAK,IAAI,IAAI;IAMb,IAAI,KAAK,IAAI,KAAK,EAAE,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC;IAW/B,+EAA+E;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B,OAAO,CAAC,YAAY;YASN,IAAI;IASlB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,sEAAsE;IACtE,OAAO,IAAI,IAAI;CAQhB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ,EAC1D,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAC7B,UAAU,CAAC,KAAK,CAAC,CAEnB"}

package/dist/engine.js CHANGED Viewed

@@ -38,6 +38,11 @@ export class CartEngine {
         };
         /** Stable identity between mutations — safe for `useSyncExternalStore`. */
         this.getSnapshot = () => this.snapshotRef;
+        // Production must persist: refuse to silently run as a local-only cart that
+        // drops every order. Local dev can omit sync (sqlite / no backend wired).
+        if (opts.env === "production" && !opts.sync) {
+            throw new Error('[cart] env "production" requires a `sync` adapter — without it the cart never persists. Pass sync, or use env "local".');
+        }
         this.namespace = opts.namespace;
         this.storage = opts.storage === undefined ? safeLocalStorage() : opts.storage;
         this.sync = opts.sync;

package/dist/engine.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,yEAAyE;AACzE,oEAAoE;AACpE,sDAAsD;AAStD,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;AACpD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;AAE9C,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,OAAO,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU;YAAE,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,OAAO,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,MAAM,OAAO,UAAU;IAcrB,YAAY,IAA8B;QAXlC,UAAK,GAAY,EAAE,CAAC;QAEX,cAAS,GAAG,IAAI,GAAG,EAAc,CAAC;QAI3C,eAAU,GAAyC,IAAI,CAAC;QAEhE,8EAA8E;QACtE,gBAAW,GAAY,EAAE,CAAC;~~QAsDlC~~,2EAA2E;QAE3E,cAAS,GAAG,CAAC,EAAc,EAAgB,EAAE;YAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC;QAEF,2EAA2E;QAC3E,gBAAW,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;~~QA3D5C~~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"}
1	+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts ADDED Viewed

@@ -0,0 +1,86 @@
+import type { CartItem, CartSnapshot } from "./types.js";
+/** The durable store the cart route talks to. Two methods, both per (id, namespace). */
+export interface DurableCartStore<TItem extends CartItem = CartItem> {
+    read(id: string, namespace: string): Promise<TItem[] | null>;
+    write(snapshot: CartSnapshot<TItem>): Promise<void>;
+}
+/** Minimal structural shape of a D1 binding — your `env.CART_DB` satisfies it. */
+export interface D1Like {
+    prepare(query: string): D1StmtLike;
+}
+export interface D1StmtLike {
+    bind(...values: unknown[]): D1StmtLike;
+    run(): Promise<unknown>;
+    first<T = unknown>(colName?: string): Promise<T | null>;
+}
+export type CartStoreEnv = "local" | "production";
+/** Carts table DDL — apply once (D1 migration, or auto on the SQLite fallback). */
+export declare const CARTS_TABLE_SQL = "CREATE TABLE IF NOT EXISTS carts (\n  id           TEXT PRIMARY KEY,\n  namespace    TEXT NOT NULL,\n  items        TEXT NOT NULL DEFAULT '[]',\n  customer_ref TEXT,\n  status       TEXT NOT NULL DEFAULT 'active',\n  created_at   INTEGER,\n  updated_at   INTEGER\n)";
+export interface CreateCartStoreOptions {
+    /** The D1 binding (e.g. `env.CART_DB`). Present → used. Absent in production → throws. */
+    d1?: D1Like | null;
+    /** "local" (D1 optional, SQLite fallback) vs "production" (D1 required). Default "local". */
+    env?: CartStoreEnv;
+    /** Local SQLite file when no binding (default "cart.sqlite"; ":memory:" for ephemeral). */
+    sqlitePath?: string;
+    /** Table name (default "carts"). */
+    table?: string;
+}
+/**
+ * Build the durable cart store. Resolves a `DurableCartStore` — pass it to
+ * {@link cartHandlers}. The promise lets the local path lazy-load `node:sqlite`
+ * without forcing it into a Workers bundle.
+ */
+export declare function createCartStore<TItem extends CartItem = CartItem>(opts?: CreateCartStoreOptions): Promise<DurableCartStore<TItem>>;
+/** `order_intents` DDL — the immutable per-checkout order snapshot. `createOrderStore`
+ *  self-applies it (idempotent), so no separate migration step. */
+export declare const ORDER_INTENTS_SQL = "CREATE TABLE IF NOT EXISTS order_intents (\n  cart_id        TEXT PRIMARY KEY,\n  site           TEXT NOT NULL,\n  items          TEXT NOT NULL DEFAULT '[]',\n  subtotal_cents INTEGER NOT NULL DEFAULT 0,\n  customer_name  TEXT,\n  customer_email TEXT,\n  customer_phone TEXT,\n  created_at     INTEGER\n)";
+/** A checkout snapshot: the cart's lines + the guest customer, frozen at PaymentIntent
+ *  time. The payment webhook reads this (not the mutable cart) to build the order. */
+export interface OrderSnapshot<TItem extends CartItem = CartItem> {
+    /** Cart id — the PaymentIntent carries it in metadata; the webhook joins on it. */
+    cartId: string;
+    /** Owning site / namespace (becomes the order's `site`). */
+    site: string;
+    /** Cart lines, stored VERBATIM — the order pipeline projects them to its own shape. */
+    items: TItem[];
+    /** Guest contact — only known at checkout, never on the cart. */
+    customer?: {
+        name?: string;
+        email?: string;
+        phone?: string;
+    };
+}
+/** Writes {@link OrderSnapshot}s. One method — the snapshot is write-once-per-checkout. */
+export interface OrderSnapshotStore<TItem extends CartItem = CartItem> {
+    save(snapshot: OrderSnapshot<TItem>): Promise<void>;
+}
+/**
+ * Build the order-snapshot store. Same env gating as {@link createCartStore}: a D1 binding
+ * is used when present (and self-applies the `order_intents` DDL); production without one
+ * throws; local without one falls back to `node:sqlite`.
+ *
+ * ```ts
+ * const orders = await createOrderStore({ d1: env.CART_DB, env: "production" });
+ * await orders.save({ cartId, site: "fourth-street", items, customer });
+ * ```
+ */
+export declare function createOrderStore<TItem extends CartItem = CartItem>(opts?: CreateCartStoreOptions): Promise<OrderSnapshotStore<TItem>>;
+/**
+ * Web-standard `GET`/`PUT` handlers for `/api/cart`, matching the `httpSync`
+ * wire contract. Framework-agnostic (Request → Response) — re-export them from a
+ * Next route handler, a Hono route, a raw Worker, etc. Accepts the store or a
+ * promise of it (what {@link createCartStore} returns).
+ *
+ * ```ts
+ * import { env } from "cloudflare:workers";
+ * import { createCartStore, cartHandlers } from "@ikeboy003/cart/server";
+ * const store = createCartStore({ d1: env.CART_DB, env: env.APP_ENV });
+ * export const { GET, PUT } = cartHandlers(store);
+ * ```
+ */
+export declare function cartHandlers<TItem extends CartItem = CartItem>(store: DurableCartStore<TItem> | Promise<DurableCartStore<TItem>>): {
+    GET: (req: Request) => Promise<Response>;
+    PUT: (req: Request) => Promise<Response>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,wFAAwF;AACxF,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IACjE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,kFAAkF;AAClF,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;CACpC;AACD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;IACvC,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,eAAe,8QAQ1B,CAAC;AAEH,MAAM,WAAW,sBAAsB;IACrC,0FAA0F;IAC1F,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,6FAA6F;IAC7F,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4ED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACrE,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAUlC;AAUD;mEACmE;AACnE,eAAO,MAAM,iBAAiB,qTAS5B,CAAC;AAEH;sFACsF;AACtF,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAC9D,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,iEAAiE;IACjE,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IACnE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AA+ED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACtE,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAQpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ,EAC5D,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAChE;IACD,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC1C,CA0BA"}

package/dist/server.js ADDED Viewed

@@ -0,0 +1,227 @@
+// Server half (separate entry `@ikeboy003/cart/server`) — the durable cart
+// store the app's `/api/cart` route reads/writes, plus ready-made web-standard
+// route handlers. Env-gated so D1 keys aren't required to set up locally, but
+// are required once deployed:
+//
+//   env "local"      → uses the D1 binding if present (wrangler/workerd local D1
+//                      IS sqlite, no keys); otherwise falls back to a local
+//                      SQLite file via Node's built-in `node:sqlite`.
+//   env "production" → REQUIRES the D1 binding; throws if it's missing, so you
+//                      can't deploy a cart that drops orders.
+//
+// Imports no Cloudflare types — `D1Like` is a structural shape your real binding
+// satisfies. `node:sqlite` is lazy-imported only on the local fallback path, so
+// a Workers build never pulls it in.
+/** Carts table DDL — apply once (D1 migration, or auto on the SQLite fallback). */
+export const CARTS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS carts (
+  id           TEXT PRIMARY KEY,
+  namespace    TEXT NOT NULL,
+  items        TEXT NOT NULL DEFAULT '[]',
+  customer_ref TEXT,
+  status       TEXT NOT NULL DEFAULT 'active',
+  created_at   INTEGER,
+  updated_at   INTEGER
+)`;
+function d1Store(d1, table) {
+    return {
+        async read(id, namespace) {
+            const items = await d1
+                .prepare(`SELECT items FROM ${table} WHERE id = ?1 AND namespace = ?2`)
+                .bind(id, namespace)
+                .first("items");
+            if (items == null)
+                return null;
+            try {
+                return JSON.parse(items);
+            }
+            catch {
+                return null;
+            }
+        },
+        async write(s) {
+            await d1
+                .prepare(`INSERT INTO ${table} (id, namespace, items, status, created_at, updated_at)
+           VALUES (?1, ?2, ?3, 'active', ?4, ?4)
+           ON CONFLICT(id) DO UPDATE SET items = ?3, updated_at = ?4`)
+                .bind(s.id, s.namespace, JSON.stringify(s.items), s.updatedAt)
+                .run();
+        },
+    };
+}
+async function sqliteStore(path, table) {
+    let DatabaseSync;
+    try {
+        // Non-literal specifier: `node:sqlite` is experimental and absent from
+        // @types/node, so a literal import fails type resolution. Resolved at
+        // runtime on Node >= 22.5 (stable in 24).
+        const spec = "node:sqlite";
+        const mod = (await import(spec));
+        DatabaseSync = mod.DatabaseSync;
+    }
+    catch {
+        throw new Error("[cart] local SQLite store needs Node's built-in node:sqlite (Node >= 22.5; stable in 24). Upgrade Node, or pass a d1 binding.");
+    }
+    const db = new DatabaseSync(path);
+    db.exec(CARTS_TABLE_SQL.replace("carts", table));
+    const ins = db.prepare(`INSERT INTO ${table} (id, namespace, items, status, created_at, updated_at)
+     VALUES (?, ?, ?, 'active', ?, ?)
+     ON CONFLICT(id) DO UPDATE SET items = excluded.items, updated_at = excluded.updated_at`);
+    const sel = db.prepare(`SELECT items FROM ${table} WHERE id = ? AND namespace = ?`);
+    return {
+        async read(id, namespace) {
+            const row = sel.get(id, namespace);
+            if (!row?.items)
+                return null;
+            try {
+                return JSON.parse(row.items);
+            }
+            catch {
+                return null;
+            }
+        },
+        async write(s) {
+            ins.run(s.id, s.namespace, JSON.stringify(s.items), s.updatedAt, s.updatedAt);
+        },
+    };
+}
+/**
+ * Build the durable cart store. Resolves a `DurableCartStore` — pass it to
+ * {@link cartHandlers}. The promise lets the local path lazy-load `node:sqlite`
+ * without forcing it into a Workers bundle.
+ */
+export async function createCartStore(opts = {}) {
+    const env = opts.env ?? "local";
+    const table = opts.table ?? "carts";
+    if (opts.d1)
+        return d1Store(opts.d1, table);
+    if (env === "production") {
+        throw new Error("[cart] production requires a D1 binding (pass `d1: env.CART_DB`). Local dev can omit it and uses SQLite.");
+    }
+    return sqliteStore(opts.sqlitePath ?? "cart.sqlite", table);
+}
+// ── order snapshot ─────────────────────────────────────────────────────────────
+//
+// The live cart is MUTABLE — it's emptied on checkout success. A payment webhook that
+// rebuilt the order by reading the cart therefore raced the clear and got empty/0 orders.
+// So at PaymentIntent time the checkout freezes an IMMUTABLE snapshot of the cart's lines
+// (+ the guest customer, which only exists at checkout, never on the cart) into its own
+// `order_intents` table, keyed by cart_id. The order pipeline reads THIS; carts stay carts.
+/** `order_intents` DDL — the immutable per-checkout order snapshot. `createOrderStore`
+ *  self-applies it (idempotent), so no separate migration step. */
+export const ORDER_INTENTS_SQL = `CREATE TABLE IF NOT EXISTS order_intents (
+  cart_id        TEXT PRIMARY KEY,
+  site           TEXT NOT NULL,
+  items          TEXT NOT NULL DEFAULT '[]',
+  subtotal_cents INTEGER NOT NULL DEFAULT 0,
+  customer_name  TEXT,
+  customer_email TEXT,
+  customer_phone TEXT,
+  created_at     INTEGER
+)`;
+/** Σ priceCents × quantity over the cart lines — the order subtotal, frozen here so the
+ *  webhook never has to recompute it off a cart that may already be gone. */
+function lineSubtotalCents(items) {
+    return items.reduce((n, i) => n + Math.round(i.priceCents) * i.quantity, 0);
+}
+function d1OrderStore(d1) {
+    const ready = d1.prepare(ORDER_INTENTS_SQL).run(); // self-bootstrap; idempotent
+    return {
+        async save(s) {
+            await ready;
+            await d1
+                .prepare(`INSERT INTO order_intents
+             (cart_id, site, items, subtotal_cents, customer_name, customer_email, customer_phone, created_at)
+           VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8)
+           ON CONFLICT(cart_id) DO UPDATE SET
+             items=?3, subtotal_cents=?4, customer_name=?5, customer_email=?6, customer_phone=?7`)
+                .bind(s.cartId, s.site, JSON.stringify(s.items), lineSubtotalCents(s.items), s.customer?.name ?? "", s.customer?.email ?? "", s.customer?.phone ?? "", Date.now())
+                .run();
+        },
+    };
+}
+async function sqliteOrderStore(path) {
+    let DatabaseSync;
+    try {
+        const spec = "node:sqlite";
+        const mod = (await import(spec));
+        DatabaseSync = mod.DatabaseSync;
+    }
+    catch {
+        throw new Error("[cart] local order store needs Node's built-in node:sqlite (Node >= 22.5; stable in 24). Upgrade Node, or pass a d1 binding.");
+    }
+    const db = new DatabaseSync(path);
+    db.exec(ORDER_INTENTS_SQL);
+    const ins = db.prepare(`INSERT INTO order_intents
+       (cart_id, site, items, subtotal_cents, customer_name, customer_email, customer_phone, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+     ON CONFLICT(cart_id) DO UPDATE SET
+       items=excluded.items, subtotal_cents=excluded.subtotal_cents, customer_name=excluded.customer_name,
+       customer_email=excluded.customer_email, customer_phone=excluded.customer_phone`);
+    return {
+        async save(s) {
+            ins.run(s.cartId, s.site, JSON.stringify(s.items), lineSubtotalCents(s.items), s.customer?.name ?? "", s.customer?.email ?? "", s.customer?.phone ?? "", Date.now());
+        },
+    };
+}
+/**
+ * Build the order-snapshot store. Same env gating as {@link createCartStore}: a D1 binding
+ * is used when present (and self-applies the `order_intents` DDL); production without one
+ * throws; local without one falls back to `node:sqlite`.
+ *
+ * ```ts
+ * const orders = await createOrderStore({ d1: env.CART_DB, env: "production" });
+ * await orders.save({ cartId, site: "fourth-street", items, customer });
+ * ```
+ */
+export async function createOrderStore(opts = {}) {
+    if (opts.d1)
+        return d1OrderStore(opts.d1);
+    if ((opts.env ?? "local") === "production") {
+        throw new Error("[cart] production order store requires a D1 binding (pass `d1: env.CART_DB`).");
+    }
+    return sqliteOrderStore(opts.sqlitePath ?? "cart.sqlite");
+}
+/**
+ * Web-standard `GET`/`PUT` handlers for `/api/cart`, matching the `httpSync`
+ * wire contract. Framework-agnostic (Request → Response) — re-export them from a
+ * Next route handler, a Hono route, a raw Worker, etc. Accepts the store or a
+ * promise of it (what {@link createCartStore} returns).
+ *
+ * ```ts
+ * import { env } from "cloudflare:workers";
+ * import { createCartStore, cartHandlers } from "@ikeboy003/cart/server";
+ * const store = createCartStore({ d1: env.CART_DB, env: env.APP_ENV });
+ * export const { GET, PUT } = cartHandlers(store);
+ * ```
+ */
+export function cartHandlers(store) {
+    const resolved = Promise.resolve(store);
+    return {
+        async GET(req) {
+            const url = new URL(req.url);
+            const id = url.searchParams.get("id");
+            const namespace = url.searchParams.get("namespace") ?? "";
+            if (!id)
+                return new Response("missing id", { status: 400 });
+            const items = await (await resolved).read(id, namespace);
+            if (!items)
+                return new Response(null, { status: 404 });
+            return Response.json({ items });
+        },
+        async PUT(req) {
+            let snap;
+            try {
+                snap = (await req.json());
+            }
+            catch {
+                return new Response("invalid json", { status: 400 });
+            }
+            if (!snap?.id || !Array.isArray(snap.items)) {
+                return new Response("invalid snapshot", { status: 400 });
+            }
+            await (await resolved).write(snap);
+            return new Response(null, { status: 204 });
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/types.d.ts CHANGED Viewed

@@ -35,13 +35,22 @@ export interface CartSyncAdapter<TItem extends CartItem = CartItem> {
     push(snapshot: CartSnapshot<TItem>): Promise<void>;
     pull(id: string, namespace: string): Promise<TItem[] | null>;
 }
+/**
+ * Deployment env. `"local"` makes the durable mirror optional — a site sets up
+ * and develops with NO sync/D1 wired (the cart runs on localStorage alone).
+ * `"production"` REQUIRES `sync` (throws at init if missing) so you can't ship a
+ * cart that silently never persists. Default `"local"`.
+ */
+export type CartEnv = "local" | "production";
 /** Config passed at import — nothing brand-specific is baked in. */
 export interface CreateCartOptions<TItem extends CartItem = CartItem> {
     /** Scopes the storage keys + cart id, and is carried in the snapshot. */
     namespace: string;
+    /** local (sync optional) vs production (sync required). Default "local". */
+    env?: CartEnv;
     /** Persistence. Defaults to localStorage; pass `null` for in-memory only. */
     storage?: Storage | null;
-    /** Durable mirror. Omit for local-only. */
+    /** Durable mirror. Omit for local-only (allowed in "local", not "production"). */
     sync?: CartSyncAdapter<TItem>;
     /** Coalesce window for durable pushes (ms). Default 400. */
     debounceMs?: number;

package/dist/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAC7D,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAChE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;CAC9D;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAClE,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,~~2CAA2C~~;~~IAC3C~~,IAAI,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAC7D,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAChE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;CAC9D;AAED;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,YAAY,CAAC;AAE7C,oEAAoE;AACpE,MAAM,WAAW,iBAAiB,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ;IAClE,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,kFAAkF;IAClF,IAAI,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ikeboy003/cart",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Headless cart primitive: local-first state + a configurable durable sync path. Framework-agnostic core, optional React binding. No POS/payment/store logic baked in.",
   "type": "module",
   "exports": {
@@ -11,26 +11,47 @@
     "./react": {
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
     }
   },
-  "files": ["dist", "src"],
+  "files": [
+    "dist",
+    "src"
+  ],
   "sideEffects": false,
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -p tsconfig.json --watch",
     "test": "node --test test/*.test.mjs"
   },
-  "keywords": ["cart", "ecommerce", "headless", "local-first"],
+  "keywords": [
+    "cart",
+    "ecommerce",
+    "headless",
+    "local-first"
+  ],
   "license": "MIT",
-  "publishConfig": { "access": "public" },
+  "publishConfig": {
+    "access": "public"
+  },
   "peerDependencies": {
     "react": ">=18"
   },
   "peerDependenciesMeta": {
-    "react": { "optional": true }
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/react": "^19",
     "typescript": "^5.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ikeboy003/ikeboy-npm-packages.git",
+    "directory": "packages/cart"
   }
 }

package/src/engine.ts CHANGED Viewed

@@ -47,6 +47,13 @@ export class CartEngine<TItem extends CartItem = CartItem> {
   private snapshotRef: TItem[] = [];
   constructor(opts: CreateCartOptions<TItem>) {
+    // Production must persist: refuse to silently run as a local-only cart that
+    // drops every order. Local dev can omit sync (sqlite / no backend wired).
+    if (opts.env === "production" && !opts.sync) {
+      throw new Error(
+        '[cart] env "production" requires a `sync` adapter — without it the cart never persists. Pass sync, or use env "local".',
+      );
+    }
     this.namespace = opts.namespace;
     this.storage = opts.storage === undefined ? safeLocalStorage() : opts.storage;
     this.sync = opts.sync;

package/src/server.ts ADDED Viewed

@@ -0,0 +1,333 @@
+// Server half (separate entry `@ikeboy003/cart/server`) — the durable cart
+// store the app's `/api/cart` route reads/writes, plus ready-made web-standard
+// route handlers. Env-gated so D1 keys aren't required to set up locally, but
+// are required once deployed:
+//
+//   env "local"      → uses the D1 binding if present (wrangler/workerd local D1
+//                      IS sqlite, no keys); otherwise falls back to a local
+//                      SQLite file via Node's built-in `node:sqlite`.
+//   env "production" → REQUIRES the D1 binding; throws if it's missing, so you
+//                      can't deploy a cart that drops orders.
+//
+// Imports no Cloudflare types — `D1Like` is a structural shape your real binding
+// satisfies. `node:sqlite` is lazy-imported only on the local fallback path, so
+// a Workers build never pulls it in.
+import type { CartItem, CartSnapshot } from "./types.js";
+/** The durable store the cart route talks to. Two methods, both per (id, namespace). */
+export interface DurableCartStore<TItem extends CartItem = CartItem> {
+  read(id: string, namespace: string): Promise<TItem[] | null>;
+  write(snapshot: CartSnapshot<TItem>): Promise<void>;
+}
+/** Minimal structural shape of a D1 binding — your `env.CART_DB` satisfies it. */
+export interface D1Like {
+  prepare(query: string): D1StmtLike;
+}
+export interface D1StmtLike {
+  bind(...values: unknown[]): D1StmtLike;
+  run(): Promise<unknown>;
+  first<T = unknown>(colName?: string): Promise<T | null>;
+}
+export type CartStoreEnv = "local" | "production";
+/** Carts table DDL — apply once (D1 migration, or auto on the SQLite fallback). */
+export const CARTS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS carts (
+  id           TEXT PRIMARY KEY,
+  namespace    TEXT NOT NULL,
+  items        TEXT NOT NULL DEFAULT '[]',
+  customer_ref TEXT,
+  status       TEXT NOT NULL DEFAULT 'active',
+  created_at   INTEGER,
+  updated_at   INTEGER
+)`;
+export interface CreateCartStoreOptions {
+  /** The D1 binding (e.g. `env.CART_DB`). Present → used. Absent in production → throws. */
+  d1?: D1Like | null;
+  /** "local" (D1 optional, SQLite fallback) vs "production" (D1 required). Default "local". */
+  env?: CartStoreEnv;
+  /** Local SQLite file when no binding (default "cart.sqlite"; ":memory:" for ephemeral). */
+  sqlitePath?: string;
+  /** Table name (default "carts"). */
+  table?: string;
+}
+function d1Store<TItem extends CartItem>(d1: D1Like, table: string): DurableCartStore<TItem> {
+  return {
+    async read(id, namespace) {
+      const items = await d1
+        .prepare(`SELECT items FROM ${table} WHERE id = ?1 AND namespace = ?2`)
+        .bind(id, namespace)
+        .first<string>("items");
+      if (items == null) return null;
+      try {
+        return JSON.parse(items) as TItem[];
+      } catch {
+        return null;
+      }
+    },
+    async write(s) {
+      await d1
+        .prepare(
+          `INSERT INTO ${table} (id, namespace, items, status, created_at, updated_at)
+           VALUES (?1, ?2, ?3, 'active', ?4, ?4)
+           ON CONFLICT(id) DO UPDATE SET items = ?3, updated_at = ?4`,
+        )
+        .bind(s.id, s.namespace, JSON.stringify(s.items), s.updatedAt)
+        .run();
+    },
+  };
+}
+async function sqliteStore<TItem extends CartItem>(
+  path: string,
+  table: string,
+): Promise<DurableCartStore<TItem>> {
+  type SqliteDb = {
+    exec(sql: string): void;
+    prepare(sql: string): { run(...a: unknown[]): unknown; get(...a: unknown[]): unknown };
+  };
+  let DatabaseSync: new (p: string) => SqliteDb;
+  try {
+    // Non-literal specifier: `node:sqlite` is experimental and absent from
+    // @types/node, so a literal import fails type resolution. Resolved at
+    // runtime on Node >= 22.5 (stable in 24).
+    const spec = "node:sqlite";
+    const mod = (await import(spec)) as unknown as {
+      DatabaseSync: new (p: string) => SqliteDb;
+    };
+    DatabaseSync = mod.DatabaseSync;
+  } catch {
+    throw new Error(
+      "[cart] local SQLite store needs Node's built-in node:sqlite (Node >= 22.5; stable in 24). Upgrade Node, or pass a d1 binding.",
+    );
+  }
+  const db = new DatabaseSync(path);
+  db.exec(CARTS_TABLE_SQL.replace("carts", table));
+  const ins = db.prepare(
+    `INSERT INTO ${table} (id, namespace, items, status, created_at, updated_at)
+     VALUES (?, ?, ?, 'active', ?, ?)
+     ON CONFLICT(id) DO UPDATE SET items = excluded.items, updated_at = excluded.updated_at`,
+  );
+  const sel = db.prepare(`SELECT items FROM ${table} WHERE id = ? AND namespace = ?`);
+  return {
+    async read(id, namespace) {
+      const row = sel.get(id, namespace) as { items?: string } | undefined;
+      if (!row?.items) return null;
+      try {
+        return JSON.parse(row.items) as TItem[];
+      } catch {
+        return null;
+      }
+    },
+    async write(s) {
+      ins.run(s.id, s.namespace, JSON.stringify(s.items), s.updatedAt, s.updatedAt);
+    },
+  };
+}
+/**
+ * Build the durable cart store. Resolves a `DurableCartStore` — pass it to
+ * {@link cartHandlers}. The promise lets the local path lazy-load `node:sqlite`
+ * without forcing it into a Workers bundle.
+ */
+export async function createCartStore<TItem extends CartItem = CartItem>(
+  opts: CreateCartStoreOptions = {},
+): Promise<DurableCartStore<TItem>> {
+  const env = opts.env ?? "local";
+  const table = opts.table ?? "carts";
+  if (opts.d1) return d1Store<TItem>(opts.d1, table);
+  if (env === "production") {
+    throw new Error(
+      "[cart] production requires a D1 binding (pass `d1: env.CART_DB`). Local dev can omit it and uses SQLite.",
+    );
+  }
+  return sqliteStore<TItem>(opts.sqlitePath ?? "cart.sqlite", table);
+}
+// ── order snapshot ─────────────────────────────────────────────────────────────
+//
+// The live cart is MUTABLE — it's emptied on checkout success. A payment webhook that
+// rebuilt the order by reading the cart therefore raced the clear and got empty/0 orders.
+// So at PaymentIntent time the checkout freezes an IMMUTABLE snapshot of the cart's lines
+// (+ the guest customer, which only exists at checkout, never on the cart) into its own
+// `order_intents` table, keyed by cart_id. The order pipeline reads THIS; carts stay carts.
+/** `order_intents` DDL — the immutable per-checkout order snapshot. `createOrderStore`
+ *  self-applies it (idempotent), so no separate migration step. */
+export const ORDER_INTENTS_SQL = `CREATE TABLE IF NOT EXISTS order_intents (
+  cart_id        TEXT PRIMARY KEY,
+  site           TEXT NOT NULL,
+  items          TEXT NOT NULL DEFAULT '[]',
+  subtotal_cents INTEGER NOT NULL DEFAULT 0,
+  customer_name  TEXT,
+  customer_email TEXT,
+  customer_phone TEXT,
+  created_at     INTEGER
+)`;
+/** A checkout snapshot: the cart's lines + the guest customer, frozen at PaymentIntent
+ *  time. The payment webhook reads this (not the mutable cart) to build the order. */
+export interface OrderSnapshot<TItem extends CartItem = CartItem> {
+  /** Cart id — the PaymentIntent carries it in metadata; the webhook joins on it. */
+  cartId: string;
+  /** Owning site / namespace (becomes the order's `site`). */
+  site: string;
+  /** Cart lines, stored VERBATIM — the order pipeline projects them to its own shape. */
+  items: TItem[];
+  /** Guest contact — only known at checkout, never on the cart. */
+  customer?: { name?: string; email?: string; phone?: string };
+}
+/** Writes {@link OrderSnapshot}s. One method — the snapshot is write-once-per-checkout. */
+export interface OrderSnapshotStore<TItem extends CartItem = CartItem> {
+  save(snapshot: OrderSnapshot<TItem>): Promise<void>;
+}
+/** Σ priceCents × quantity over the cart lines — the order subtotal, frozen here so the
+ *  webhook never has to recompute it off a cart that may already be gone. */
+function lineSubtotalCents<TItem extends CartItem>(items: TItem[]): number {
+  return items.reduce((n, i) => n + Math.round(i.priceCents) * i.quantity, 0);
+}
+function d1OrderStore<TItem extends CartItem>(d1: D1Like): OrderSnapshotStore<TItem> {
+  const ready = d1.prepare(ORDER_INTENTS_SQL).run(); // self-bootstrap; idempotent
+  return {
+    async save(s) {
+      await ready;
+      await d1
+        .prepare(
+          `INSERT INTO order_intents
+             (cart_id, site, items, subtotal_cents, customer_name, customer_email, customer_phone, created_at)
+           VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8)
+           ON CONFLICT(cart_id) DO UPDATE SET
+             items=?3, subtotal_cents=?4, customer_name=?5, customer_email=?6, customer_phone=?7`,
+        )
+        .bind(
+          s.cartId,
+          s.site,
+          JSON.stringify(s.items),
+          lineSubtotalCents(s.items),
+          s.customer?.name ?? "",
+          s.customer?.email ?? "",
+          s.customer?.phone ?? "",
+          Date.now(),
+        )
+        .run();
+    },
+  };
+}
+async function sqliteOrderStore<TItem extends CartItem>(
+  path: string,
+): Promise<OrderSnapshotStore<TItem>> {
+  type SqliteDb = {
+    exec(sql: string): void;
+    prepare(sql: string): { run(...a: unknown[]): unknown };
+  };
+  let DatabaseSync: new (p: string) => SqliteDb;
+  try {
+    const spec = "node:sqlite";
+    const mod = (await import(spec)) as unknown as { DatabaseSync: new (p: string) => SqliteDb };
+    DatabaseSync = mod.DatabaseSync;
+  } catch {
+    throw new Error(
+      "[cart] local order store needs Node's built-in node:sqlite (Node >= 22.5; stable in 24). Upgrade Node, or pass a d1 binding.",
+    );
+  }
+  const db = new DatabaseSync(path);
+  db.exec(ORDER_INTENTS_SQL);
+  const ins = db.prepare(
+    `INSERT INTO order_intents
+       (cart_id, site, items, subtotal_cents, customer_name, customer_email, customer_phone, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+     ON CONFLICT(cart_id) DO UPDATE SET
+       items=excluded.items, subtotal_cents=excluded.subtotal_cents, customer_name=excluded.customer_name,
+       customer_email=excluded.customer_email, customer_phone=excluded.customer_phone`,
+  );
+  return {
+    async save(s) {
+      ins.run(
+        s.cartId,
+        s.site,
+        JSON.stringify(s.items),
+        lineSubtotalCents(s.items),
+        s.customer?.name ?? "",
+        s.customer?.email ?? "",
+        s.customer?.phone ?? "",
+        Date.now(),
+      );
+    },
+  };
+}
+/**
+ * Build the order-snapshot store. Same env gating as {@link createCartStore}: a D1 binding
+ * is used when present (and self-applies the `order_intents` DDL); production without one
+ * throws; local without one falls back to `node:sqlite`.
+ *
+ * ```ts
+ * const orders = await createOrderStore({ d1: env.CART_DB, env: "production" });
+ * await orders.save({ cartId, site: "fourth-street", items, customer });
+ * ```
+ */
+export async function createOrderStore<TItem extends CartItem = CartItem>(
+  opts: CreateCartStoreOptions = {},
+): Promise<OrderSnapshotStore<TItem>> {
+  if (opts.d1) return d1OrderStore<TItem>(opts.d1);
+  if ((opts.env ?? "local") === "production") {
+    throw new Error(
+      "[cart] production order store requires a D1 binding (pass `d1: env.CART_DB`).",
+    );
+  }
+  return sqliteOrderStore<TItem>(opts.sqlitePath ?? "cart.sqlite");
+}
+/**
+ * Web-standard `GET`/`PUT` handlers for `/api/cart`, matching the `httpSync`
+ * wire contract. Framework-agnostic (Request → Response) — re-export them from a
+ * Next route handler, a Hono route, a raw Worker, etc. Accepts the store or a
+ * promise of it (what {@link createCartStore} returns).
+ *
+ * ```ts
+ * import { env } from "cloudflare:workers";
+ * import { createCartStore, cartHandlers } from "@ikeboy003/cart/server";
+ * const store = createCartStore({ d1: env.CART_DB, env: env.APP_ENV });
+ * export const { GET, PUT } = cartHandlers(store);
+ * ```
+ */
+export function cartHandlers<TItem extends CartItem = CartItem>(
+  store: DurableCartStore<TItem> | Promise<DurableCartStore<TItem>>,
+): {
+  GET: (req: Request) => Promise<Response>;
+  PUT: (req: Request) => Promise<Response>;
+} {
+  const resolved = Promise.resolve(store);
+  return {
+    async GET(req) {
+      const url = new URL(req.url);
+      const id = url.searchParams.get("id");
+      const namespace = url.searchParams.get("namespace") ?? "";
+      if (!id) return new Response("missing id", { status: 400 });
+      const items = await (await resolved).read(id, namespace);
+      if (!items) return new Response(null, { status: 404 });
+      return Response.json({ items });
+    },
+    async PUT(req) {
+      let snap: CartSnapshot<TItem>;
+      try {
+        snap = (await req.json()) as CartSnapshot<TItem>;
+      } catch {
+        return new Response("invalid json", { status: 400 });
+      }
+      if (!snap?.id || !Array.isArray(snap.items)) {
+        return new Response("invalid snapshot", { status: 400 });
+      }
+      await (await resolved).write(snap);
+      return new Response(null, { status: 204 });
+    },
+  };
+}

package/src/types.ts CHANGED Viewed

@@ -55,13 +55,23 @@ export interface CartSyncAdapter<TItem extends CartItem = CartItem> {
   pull(id: string, namespace: string): Promise<TItem[] | null>;
 }
+/**
+ * Deployment env. `"local"` makes the durable mirror optional — a site sets up
+ * and develops with NO sync/D1 wired (the cart runs on localStorage alone).
+ * `"production"` REQUIRES `sync` (throws at init if missing) so you can't ship a
+ * cart that silently never persists. Default `"local"`.
+ */
+export type CartEnv = "local" | "production";
 /** Config passed at import — nothing brand-specific is baked in. */
 export interface CreateCartOptions<TItem extends CartItem = CartItem> {
   /** Scopes the storage keys + cart id, and is carried in the snapshot. */
   namespace: string;
+  /** local (sync optional) vs production (sync required). Default "local". */
+  env?: CartEnv;
   /** Persistence. Defaults to localStorage; pass `null` for in-memory only. */
   storage?: Storage | null;
-  /** Durable mirror. Omit for local-only. */
+  /** Durable mirror. Omit for local-only (allowed in "local", not "production"). */
   sync?: CartSyncAdapter<TItem>;
   /** Coalesce window for durable pushes (ms). Default 400. */
   debounceMs?: number;