threeu-sdk 0.1.0

package/README.md

@@ -0,0 +1,176 @@
+# threeu-sdk
+
+Official ThreeU developer SDK — a typed, tree-shakeable, fetch-based layer over the
+ThreeU platform for **admin**, **POS**, **storefront**, **theme**, **plugin**, and
+**developer** integrations.
+
+> Status: **v0.1.0 (pre-release).** Built against ThreeU's live API. Backend-dependent
+> features (developer manifest writes, telemetry ingestion, plugin health/delivery logs)
+> are typed but ship as clearly-marked planned/experimental stubs that throw
+> `ThreeuNotImplementedError` until the backend lands them — see
+> [`docs/M8_BACKEND_PROPOSAL.md`](docs/M8_BACKEND_PROPOSAL.md). The original product brief
+> is preserved in [`docs/BRIEF.md`](docs/BRIEF.md); build progress in
+> [`docs/BUILD_LEDGER.md`](docs/BUILD_LEDGER.md); backend recon in
+> [`docs/ARCHITECTURE_MAP.md`](docs/ARCHITECTURE_MAP.md).
+
+## Install
+
+```bash
+npm install threeu-sdk
+```
+
+ESM-only, zero runtime dependencies. Node 18+, modern browsers, and edge runtimes.
+`react` is an optional peer (only needed for `threeu-sdk/theme` and `/react`).
+
+## Entry points
+
+| Import | Use |
+| --- | --- |
+| `threeu-sdk` | core `Threeu` client + transport, errors, telemetry |
+| `threeu-sdk/admin` | `ThreeuAdmin` — secret-token admin (server-side) |
+| `threeu-sdk/pos` | `ThreeuPOS` — POS sessions/carts/checkout |
+| `threeu-sdk/storefront` | `ThreeuStorefront` — public-token, browser-safe |
+| `threeu-sdk/developer` | `ThreeuDeveloper` — developer.threeu.app API |
+| `threeu-sdk/theme` | `createTheme`, `T*` components, hooks |
+| `threeu-sdk/react` | React providers & hooks (no components) |
+| `threeu-sdk/plugin` | `definePlugin`, `defineApp`, manifest types |
+| `threeu-sdk/plugin/server` | remote plugin server helper (experimental) |
+| `threeu-sdk/webhooks` | sign/verify webhook signatures |
+| `threeu-sdk/errors` | typed error classes |
+| `threeu-sdk/testing` | mock fetch + fixtures |
+
+## Core usage
+
+```ts
+import { Threeu } from "threeu-sdk";
+
+const threeu = new Threeu(process.env.THREEU_SECRET_KEY!);
+const brand = threeu.brand("my-store");
+
+await brand.products.create({ name: "Black Abaya", price: 350, currency: "QAR" });
+const orders = await brand.orders.list({ status: "pending" });
+```
+
+`brand(...)` returns a scoped object with `products`, `orders`, `customers`, `inventory`,
+`collections`, `discounts`, `payments`, `shipping`, `locations`, `analytics`, `marketing`,
+`theme`, and `pos`. Every call is scoped to the brand via the `platform-id` header.
+
+### Admin / POS / storefront
+
+```ts
+import { ThreeuAdmin } from "threeu-sdk/admin";
+import { ThreeuPOS } from "threeu-sdk/pos";
+import { ThreeuStorefront } from "threeu-sdk/storefront";
+
+const admin = new ThreeuAdmin(process.env.THREEU_SECRET_KEY!);
+const pos = new ThreeuPOS(process.env.THREEU_POS_TOKEN!, { brand: "my-store" });
+const storefront = new ThreeuStorefront({ publicToken: PUBLIC_KEY, brand: "my-store" });
+```
+
+See [`examples/`](examples) for end-to-end snippets of each.
+
+## Themes (React)
+
+```tsx
+import { createTheme, TSection, THeading, TColor } from "threeu-sdk/theme";
+
+function HomePage() {
+  return (
+    <TSection name="home.hero">
+      <THeading name="home.hero.title">Welcome to our store</THeading>
+      <button style={{ backgroundColor: TColor("home.hero.buttonColor", "#000") }}>Shop now</button>
+    </TSection>
+  );
+}
+export default createTheme({ name: "Modern Luxury", slug: "modern-luxury", pages: { home: HomePage } });
+```
+
+Data/customization hooks (`useProducts`, `useCart`, `useTheme`, ...) require a
+`<ThreeuThemeProvider>` / `<ThemeProvider>` ancestor.
+
+## Plugins
+
+```ts
+import { definePlugin } from "threeu-sdk/plugin";
+
+export default definePlugin({
+  name: "FastShip",
+  slug: "fastship",
+  category: "shipping",
+  permissions: ["orders:read", "shipping:write"],
+  provider: {
+    type: "remote_http",
+    baseUrl: "https://api.fastship.com/threeu",
+    healthPath: "/health",
+    actions: { "shipping.get_rates": { method: "POST", path: "/rates" } },
+  },
+});
+```
+
+`definePlugin` validates the definition and emits the normalized manifest JSON
+(`.manifest`). Community developers declare `provider.type` only — the SDK never sets
+the internal `provider_class`. Implement the hosted side with
+`createThreeuPluginServer` (see `examples/plugin-server-fastship.ts`).
+
+## Webhook verification
+
+```ts
+import { verifyWebhookSignature, verifyLegacyWebhook } from "threeu-sdk/webhooks";
+
+// Target scheme: raw body + X-Plugin-Timestamp, with replay protection.
+const ok = await verifyWebhookSignature({ secret, rawBody, timestamp, signature, toleranceSeconds: 300 });
+// Compatible with the backend's current json_encode signing:
+const okLegacy = await verifyLegacyWebhook(secret, JSON.parse(rawBody), signature);
+```
+
+Always verify against the **raw** request body.
+
+## Logging & telemetry
+
+Pass a `logger` and/or `telemetry` config. The SDK redacts tokens, secrets, credentials,
+signatures, and PII before any event is logged or transmitted, and templatizes ids out of
+paths.
+
+```ts
+const threeu = new Threeu(token, {
+  logger: { error: (e) => console.error(e.type, e.errorCode) },
+  telemetry: { enabled: true, endpoint: "https://api.threeu.app/api/sdk/events", sampleRate: 1 },
+});
+```
+
+## Browser safety
+
+- Never construct `ThreeuAdmin` / a secret-token client in browser code — the SDK warns
+  in development when it detects this.
+- Use `ThreeuStorefront` (public token, `platform-id` only) in the browser.
+
+## Errors
+
+All failures normalize to typed errors with `code`, `status`, `requestId`, `details`,
+`cause`, and `retryable`: `ThreeuApiError`, `ThreeuAuthError`, `ThreeuPermissionError`,
+`ThreeuValidationError` (with `.fields`), `ThreeuNotFoundError`, `ThreeuConflictError`,
+`ThreeuRateLimitError`, `ThreeuTimeoutError`, `ThreeuNetworkError`,
+`ThreeuWebhookSignatureError`, `ThreeuManifestError`, `ThreeuProviderError`,
+`ThreeuNotImplementedError`.
+
+## Scripts
+
+```bash
+npm run build       # tsup → ESM + .d.ts + sourcemaps for every entry
+npm run typecheck   # tsc --noEmit
+npm test            # vitest
+```
+
+## Publishing
+
+Published to npm as the unscoped package **`threeu-sdk`** (MIT). Release flow:
+
+```bash
+npm login                  # any npm account
+npm version patch|minor    # bump version + git tag
+# update src/version.ts SDK_VERSION to match
+npm publish                # prepublishOnly runs typecheck + tests + build first
+```
+
+Standalone in `local-code/threeu_npm_sdk`, designed to migrate into a
+`packages/threeu-sdk` workspace later without import changes.

package/dist/admin/index.d.ts

@@ -0,0 +1,22 @@
+import { T as Threeu, a as ThreeuOptions } from '../threeu-BesFjXdw.js';
+export { B as BrandClient } from '../threeu-BesFjXdw.js';
+export { B as BaseRecord, C as Collection, a as Customer, D as Discount, I as Id, b as InventoryItem, L as ListParams, c as Location, M as Money, O as Order, P as Payment, d as Product, e as ProductInput, S as ShippingRate } from '../types-DfyYnoLn.js';
+import '../session-BFDRm-KJ.js';
+
+/**
+ * @threeu/threeu/admin — secret-token admin client.
+ *
+ *   const threeu = new ThreeuAdmin(process.env.THREEU_SECRET_KEY!);
+ *   const brand = await threeu.brand("brand-slug");
+ *   await brand.products.create({ name: "Black Abaya", price: 350, currency: "QAR", stock: 20 });
+ *   const orders = await brand.orders.list({ status: "pending" });
+ *
+ * Identical capability to the root `Threeu` client; named export for clarity in
+ * server-side admin code. Never instantiate with a secret token in a browser.
+ */
+
+declare class ThreeuAdmin extends Threeu {
+    constructor(token: string, options?: ThreeuOptions);
+}
+
+export { Threeu, ThreeuAdmin, ThreeuOptions };

package/dist/admin/index.js

@@ -0,0 +1,17 @@
+import { Threeu } from '../chunk-2TGBSV6L.js';
+export { BrandClient, Threeu } from '../chunk-2TGBSV6L.js';
+import '../chunk-BCUODRZW.js';
+import '../chunk-HYSJ6YPN.js';
+import '../chunk-H3XILKGI.js';
+import '../chunk-LFF5LPWT.js';
+
+// src/admin/index.ts
+var ThreeuAdmin = class extends Threeu {
+  constructor(token, options = {}) {
+    super(token, options, "secret_admin");
+  }
+};
+
+export { ThreeuAdmin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/index.ts"],"names":[],"mappings":";;;;;;;;AAaO,IAAM,WAAA,GAAN,cAA0B,MAAA,CAAO;AAAA,EACtC,WAAA,CAAY,KAAA,EAAe,OAAA,GAAyB,EAAC,EAAG;AACtD,IAAA,KAAA,CAAM,KAAA,EAAO,SAAS,cAAc,CAAA;AAAA,EACtC;AACF","file":"index.js","sourcesContent":["/**\n * @threeu/threeu/admin — secret-token admin client.\n *\n *   const threeu = new ThreeuAdmin(process.env.THREEU_SECRET_KEY!);\n *   const brand = await threeu.brand(\"brand-slug\");\n *   await brand.products.create({ name: \"Black Abaya\", price: 350, currency: \"QAR\", stock: 20 });\n *   const orders = await brand.orders.list({ status: \"pending\" });\n *\n * Identical capability to the root `Threeu` client; named export for clarity in\n * server-side admin code. Never instantiate with a secret token in a browser.\n */\nimport { Threeu, type ThreeuOptions } from \"../clients/threeu\";\n\nexport class ThreeuAdmin extends Threeu {\n  constructor(token: string, options: ThreeuOptions = {}) {\n    super(token, options, \"secret_admin\");\n  }\n}\n\nexport { Threeu } from \"../clients/threeu\";\nexport { BrandClient } from \"../clients/brand\";\nexport type { ThreeuOptions } from \"../clients/threeu\";\nexport * from \"../resources/types\";\n"]}

package/dist/chunk-2TGBSV6L.js

@@ -0,0 +1,197 @@
+import { PosNamespace } from './chunk-BCUODRZW.js';
+import { ThreeuHttpClient } from './chunk-HYSJ6YPN.js';
+
+// src/resources/resource.ts
+var CrudResource = class {
+  constructor(ctx, path) {
+    this.ctx = ctx;
+    this.path = path;
+  }
+  opts(extra) {
+    return this.ctx.brand !== void 0 ? { brand: this.ctx.brand, ...extra } : { ...extra };
+  }
+  list(params) {
+    return this.ctx.http.list(this.path, this.opts({ query: params }));
+  }
+  iterate(params) {
+    return this.ctx.http.iterate(this.path, this.opts({ query: params }));
+  }
+  get(id) {
+    return this.ctx.http.get(`${this.path}/${id}`, this.opts());
+  }
+  create(input, options) {
+    return this.ctx.http.post(
+      this.path,
+      this.opts({ body: input, idempotent: true, idempotencyKey: options?.idempotencyKey })
+    );
+  }
+  update(id, input) {
+    return this.ctx.http.put(`${this.path}/${id}`, this.opts({ body: input }));
+  }
+  delete(id) {
+    return this.ctx.http.delete(`${this.path}/${id}`, this.opts());
+  }
+  /** POST a custom sub-action, e.g. `action(id, "fulfill", {...})`. */
+  action(id, verb, body) {
+    return this.ctx.http.post(`${this.path}/${id}/${verb}`, this.opts({ body, idempotent: true }));
+  }
+};
+
+// src/resources/index.ts
+var ProductsResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "products");
+  }
+};
+var OrdersResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "orders");
+  }
+  fulfill(id, body) {
+    return this.action(id, "fulfill", body);
+  }
+  cancel(id, body) {
+    return this.action(id, "cancel", body);
+  }
+};
+var CustomersResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "customers");
+  }
+};
+var CollectionsResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "collections");
+  }
+};
+var DiscountsResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "discounts");
+  }
+};
+var LocationsResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "locations");
+  }
+};
+var InventoryResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "inventory");
+  }
+  adjust(body) {
+    return this.ctx.http.post("inventory/adjust", this.opts({ body, idempotent: true }));
+  }
+  transfer(body) {
+    return this.ctx.http.post("inventory/transfer", this.opts({ body, idempotent: true }));
+  }
+};
+var PaymentsResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "payments");
+  }
+  refund(id, body) {
+    return this.action(id, "refund", body);
+  }
+};
+var ShippingResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  opts(extra) {
+    return this.ctx.brand !== void 0 ? { brand: this.ctx.brand, ...extra } : { ...extra };
+  }
+  rates(body) {
+    return this.ctx.http.post("shipping/rates", this.opts({ body }));
+  }
+  createShipment(body) {
+    return this.ctx.http.post("shipping/shipments", { ...this.opts({ body }), idempotent: true });
+  }
+  trackShipment(trackingNumber) {
+    return this.ctx.http.get(`shipping/shipments/${trackingNumber}/track`, this.opts());
+  }
+};
+var AnalyticsResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  opts(query) {
+    return this.ctx.brand !== void 0 ? { brand: this.ctx.brand, query } : { query };
+  }
+  summary(params) {
+    return this.ctx.http.get("analytics/summary", this.opts(params));
+  }
+  sales(params) {
+    return this.ctx.http.get("analytics/sales", this.opts(params));
+  }
+  products(params) {
+    return this.ctx.http.get("analytics/products", this.opts(params));
+  }
+};
+var CampaignsResource = class extends CrudResource {
+  constructor(ctx) {
+    super(ctx, "marketing/campaigns");
+  }
+};
+var MarketingResource = class {
+  constructor(ctx) {
+    this.campaigns = new CampaignsResource(ctx);
+  }
+};
+var ThemeResource = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  opts(extra) {
+    return this.ctx.brand !== void 0 ? { brand: this.ctx.brand, ...extra } : { ...extra };
+  }
+  get() {
+    return this.ctx.http.get("theme", this.opts());
+  }
+  update(body) {
+    return this.ctx.http.put("theme", this.opts({ body }));
+  }
+};
+
+// src/clients/brand.ts
+var BrandClient = class {
+  constructor(http, brand) {
+    this.id = brand;
+    const ctx = { http, brand };
+    this.products = new ProductsResource(ctx);
+    this.orders = new OrdersResource(ctx);
+    this.customers = new CustomersResource(ctx);
+    this.inventory = new InventoryResource(ctx);
+    this.collections = new CollectionsResource(ctx);
+    this.discounts = new DiscountsResource(ctx);
+    this.payments = new PaymentsResource(ctx);
+    this.shipping = new ShippingResource(ctx);
+    this.locations = new LocationsResource(ctx);
+    this.analytics = new AnalyticsResource(ctx);
+    this.marketing = new MarketingResource(ctx);
+    this.theme = new ThemeResource(ctx);
+    this.pos = new PosNamespace(ctx);
+  }
+};
+
+// src/clients/threeu.ts
+var Threeu = class {
+  constructor(token, options = {}, tokenType = "secret_admin") {
+    this.tokenType = tokenType;
+    this.http = new ThreeuHttpClient({ ...options, token, tokenType });
+  }
+  /**
+   * Return a brand-scoped client. Synchronous, but returns a value safe to
+   * `await` so both `threeu.brand(x)` and `await threeu.brand(x)` work.
+   */
+  brand(brand) {
+    return new BrandClient(this.http, brand);
+  }
+  /** Flush telemetry and release timers. */
+  close() {
+    return this.http.close();
+  }
+};
+
+export { BrandClient, Threeu };
+//# sourceMappingURL=chunk-2TGBSV6L.js.map
+//# sourceMappingURL=chunk-2TGBSV6L.js.map

package/dist/chunk-2TGBSV6L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/resource.ts","../src/resources/index.ts","../src/clients/brand.ts","../src/clients/threeu.ts"],"names":[],"mappings":"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","file":"chunk-2TGBSV6L.js","sourcesContent":["/**\n * Generic CRUD resource bound to a base path and a brand scope. Each high-level\n * resource (products, orders, ...) is a thin subclass that adds domain-specific\n * actions. Paths are centralized so they're trivial to adjust as backend routes\n * are confirmed.\n */\nimport type { ThreeuHttpClient } from \"../core/http-client\";\nimport type { Page } from \"../core/pagination\";\nimport type { RequestOptions } from \"../core/types\";\nimport type { BaseRecord, Id, ListParams } from \"./types\";\n\nexport interface ResourceContext {\n  http: ThreeuHttpClient;\n  /** Brand scope applied as `platform-id` on every call (undefined = client default). */\n  brand?: Id;\n}\n\nexport class CrudResource<T extends BaseRecord = BaseRecord, TInput = Partial<T>> {\n  constructor(\n    protected readonly ctx: ResourceContext,\n    protected readonly path: string,\n  ) {}\n\n  protected opts(extra?: RequestOptions): RequestOptions {\n    return this.ctx.brand !== undefined ? { brand: this.ctx.brand, ...extra } : { ...extra };\n  }\n\n  list(params?: ListParams): Promise<Page<T>> {\n    return this.ctx.http.list<T>(this.path, this.opts({ query: params }));\n  }\n\n  iterate(params?: ListParams): AsyncGenerator<T, void, void> {\n    return this.ctx.http.iterate<T>(this.path, this.opts({ query: params }));\n  }\n\n  get(id: Id): Promise<T> {\n    return this.ctx.http.get(`${this.path}/${id}`, this.opts()) as Promise<T>;\n  }\n\n  create(input: TInput, options?: { idempotencyKey?: string }): Promise<T> {\n    return this.ctx.http.post(\n      this.path,\n      this.opts({ body: input, idempotent: true, idempotencyKey: options?.idempotencyKey }),\n    ) as Promise<T>;\n  }\n\n  update(id: Id, input: Partial<TInput>): Promise<T> {\n    return this.ctx.http.put(`${this.path}/${id}`, this.opts({ body: input })) as Promise<T>;\n  }\n\n  delete(id: Id): Promise<void> {\n    return this.ctx.http.delete(`${this.path}/${id}`, this.opts()) as Promise<void>;\n  }\n\n  /** POST a custom sub-action, e.g. `action(id, \"fulfill\", {...})`. */\n  protected action<R = unknown>(id: Id, verb: string, body?: unknown): Promise<R> {\n    return this.ctx.http.post(`${this.path}/${id}/${verb}`, this.opts({ body, idempotent: true })) as Promise<R>;\n  }\n}\n","/**\n * Concrete brand resources. Each adds domain actions on top of `CrudResource`.\n * Resource path constants live here so backend route changes are a one-line edit.\n */\nimport type { Page } from \"../core/pagination\";\nimport { CrudResource, type ResourceContext } from \"./resource\";\nimport type {\n  Collection,\n  Customer,\n  Discount,\n  Id,\n  InventoryItem,\n  ListParams,\n  Location,\n  Order,\n  Payment,\n  Product,\n  ProductInput,\n  ShippingRate,\n} from \"./types\";\n\nexport class ProductsResource extends CrudResource<Product, ProductInput> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"products\");\n  }\n}\n\nexport class OrdersResource extends CrudResource<Order> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"orders\");\n  }\n  fulfill(id: Id, body?: Record<string, unknown>): Promise<Order> {\n    return this.action<Order>(id, \"fulfill\", body);\n  }\n  cancel(id: Id, body?: Record<string, unknown>): Promise<Order> {\n    return this.action<Order>(id, \"cancel\", body);\n  }\n}\n\nexport class CustomersResource extends CrudResource<Customer> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"customers\");\n  }\n}\n\nexport class CollectionsResource extends CrudResource<Collection> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"collections\");\n  }\n}\n\nexport class DiscountsResource extends CrudResource<Discount> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"discounts\");\n  }\n}\n\nexport class LocationsResource extends CrudResource<Location> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"locations\");\n  }\n}\n\nexport class InventoryResource extends CrudResource<InventoryItem> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"inventory\");\n  }\n  adjust(body: { product_id: Id; location_id?: Id; delta: number; reason?: string }): Promise<InventoryItem> {\n    return this.ctx.http.post(\"inventory/adjust\", this.opts({ body, idempotent: true })) as Promise<InventoryItem>;\n  }\n  transfer(body: { product_id: Id; from_location_id: Id; to_location_id: Id; quantity: number }): Promise<InventoryItem> {\n    return this.ctx.http.post(\"inventory/transfer\", this.opts({ body, idempotent: true })) as Promise<InventoryItem>;\n  }\n}\n\nexport class PaymentsResource extends CrudResource<Payment> {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"payments\");\n  }\n  refund(id: Id, body?: { amount?: number; reason?: string }): Promise<Payment> {\n    return this.action<Payment>(id, \"refund\", body);\n  }\n}\n\nexport class ShippingResource {\n  constructor(private readonly ctx: ResourceContext) {}\n  private opts(extra?: { body?: unknown; query?: Record<string, unknown> }) {\n    return this.ctx.brand !== undefined ? { brand: this.ctx.brand, ...extra } : { ...extra };\n  }\n  rates(body: { destination: string; items: unknown[] }): Promise<ShippingRate[]> {\n    return this.ctx.http.post(\"shipping/rates\", this.opts({ body })) as Promise<ShippingRate[]>;\n  }\n  createShipment(body: Record<string, unknown>): Promise<Record<string, unknown>> {\n    return this.ctx.http.post(\"shipping/shipments\", { ...this.opts({ body }), idempotent: true }) as Promise<\n      Record<string, unknown>\n    >;\n  }\n  trackShipment(trackingNumber: string): Promise<Record<string, unknown>> {\n    return this.ctx.http.get(`shipping/shipments/${trackingNumber}/track`, this.opts()) as Promise<\n      Record<string, unknown>\n    >;\n  }\n}\n\nexport class AnalyticsResource {\n  constructor(private readonly ctx: ResourceContext) {}\n  private opts(query?: Record<string, unknown>) {\n    return this.ctx.brand !== undefined ? { brand: this.ctx.brand, query } : { query };\n  }\n  summary(params?: { from?: string; to?: string }): Promise<Record<string, unknown>> {\n    return this.ctx.http.get(\"analytics/summary\", this.opts(params)) as Promise<Record<string, unknown>>;\n  }\n  sales(params?: { from?: string; to?: string; interval?: string }): Promise<Record<string, unknown>> {\n    return this.ctx.http.get(\"analytics/sales\", this.opts(params)) as Promise<Record<string, unknown>>;\n  }\n  products(params?: { from?: string; to?: string; limit?: number }): Promise<Record<string, unknown>> {\n    return this.ctx.http.get(\"analytics/products\", this.opts(params)) as Promise<Record<string, unknown>>;\n  }\n}\n\nexport class CampaignsResource extends CrudResource {\n  constructor(ctx: ResourceContext) {\n    super(ctx, \"marketing/campaigns\");\n  }\n}\n\nexport class MarketingResource {\n  readonly campaigns: CampaignsResource;\n  constructor(ctx: ResourceContext) {\n    this.campaigns = new CampaignsResource(ctx);\n  }\n}\n\nexport class ThemeResource {\n  constructor(private readonly ctx: ResourceContext) {}\n  private opts(extra?: { body?: unknown }) {\n    return this.ctx.brand !== undefined ? { brand: this.ctx.brand, ...extra } : { ...extra };\n  }\n  get(): Promise<Record<string, unknown>> {\n    return this.ctx.http.get(\"theme\", this.opts()) as Promise<Record<string, unknown>>;\n  }\n  update(body: Record<string, unknown>): Promise<Record<string, unknown>> {\n    return this.ctx.http.put(\"theme\", this.opts({ body })) as Promise<Record<string, unknown>>;\n  }\n}\n\nexport type { Page, ListParams };\n","/**\n * Scoped brand object returned by `client.brand(slug)`. Every resource call is\n * automatically scoped to this brand via the `platform-id` header. This is the\n * SDK object the brief's core DX revolves around (`brand.products.create(...)`).\n */\nimport type { ThreeuHttpClient } from \"../core/http-client\";\nimport type { Id } from \"../resources/types\";\nimport type { ResourceContext } from \"../resources/resource\";\nimport {\n  AnalyticsResource,\n  CollectionsResource,\n  CustomersResource,\n  DiscountsResource,\n  InventoryResource,\n  LocationsResource,\n  MarketingResource,\n  OrdersResource,\n  PaymentsResource,\n  ProductsResource,\n  ShippingResource,\n  ThemeResource,\n} from \"../resources\";\nimport { PosNamespace } from \"../pos/session\";\n\nexport class BrandClient {\n  readonly id: Id;\n  readonly products: ProductsResource;\n  readonly orders: OrdersResource;\n  readonly customers: CustomersResource;\n  readonly inventory: InventoryResource;\n  readonly collections: CollectionsResource;\n  readonly discounts: DiscountsResource;\n  readonly payments: PaymentsResource;\n  readonly shipping: ShippingResource;\n  readonly locations: LocationsResource;\n  readonly analytics: AnalyticsResource;\n  readonly marketing: MarketingResource;\n  readonly theme: ThemeResource;\n  readonly pos: PosNamespace;\n\n  constructor(http: ThreeuHttpClient, brand: Id) {\n    this.id = brand;\n    const ctx: ResourceContext = { http, brand };\n    this.products = new ProductsResource(ctx);\n    this.orders = new OrdersResource(ctx);\n    this.customers = new CustomersResource(ctx);\n    this.inventory = new InventoryResource(ctx);\n    this.collections = new CollectionsResource(ctx);\n    this.discounts = new DiscountsResource(ctx);\n    this.payments = new PaymentsResource(ctx);\n    this.shipping = new ShippingResource(ctx);\n    this.locations = new LocationsResource(ctx);\n    this.analytics = new AnalyticsResource(ctx);\n    this.marketing = new MarketingResource(ctx);\n    this.theme = new ThemeResource(ctx);\n    this.pos = new PosNamespace(ctx);\n  }\n}\n","/**\n * `Threeu` — the high-level entry client. Constructed with a secret key, it\n * yields brand-scoped objects:\n *\n *   const threeu = new Threeu(process.env.THREEU_SECRET_KEY!);\n *   const brand = await threeu.brand(\"my-store\");\n *   await brand.products.create({ name: \"Black Abaya\", price: 350, currency: \"QAR\" });\n */\nimport { ThreeuHttpClient } from \"../core/http-client\";\nimport type { ThreeuClientOptions, TokenType } from \"../core/types\";\nimport type { Id } from \"../resources/types\";\nimport { BrandClient } from \"./brand\";\n\nexport type ThreeuOptions = Omit<ThreeuClientOptions, \"token\" | \"tokenType\">;\n\nexport class Threeu {\n  readonly http: ThreeuHttpClient;\n  protected readonly tokenType: TokenType;\n\n  constructor(token: string, options: ThreeuOptions = {}, tokenType: TokenType = \"secret_admin\") {\n    this.tokenType = tokenType;\n    this.http = new ThreeuHttpClient({ ...options, token, tokenType });\n  }\n\n  /**\n   * Return a brand-scoped client. Synchronous, but returns a value safe to\n   * `await` so both `threeu.brand(x)` and `await threeu.brand(x)` work.\n   */\n  brand(brand: Id): BrandClient {\n    return new BrandClient(this.http, brand);\n  }\n\n  /** Flush telemetry and release timers. */\n  close(): Promise<void> {\n    return this.http.close();\n  }\n}\n"]}

package/dist/chunk-6S7OFN23.js

@@ -0,0 +1,81 @@
+import { ThreeuHttpClient } from './chunk-HYSJ6YPN.js';
+
+// src/storefront/index.ts
+var STOREFRONT_BASE = "/api/marketplace/storefront";
+function normalizeStorefrontBase(baseUrl) {
+  if (!baseUrl) return STOREFRONT_BASE;
+  let base = baseUrl.replace(/\/+$/, "");
+  if (base.includes("/api/marketplace/storefront")) return base;
+  if (base.endsWith("/api/marketplace")) return `${base}/storefront`;
+  if (base.endsWith("/api")) return `${base}/marketplace/storefront`;
+  return `${base}${STOREFRONT_BASE}`;
+}
+var StorefrontProducts = class {
+  constructor(http, brand) {
+    this.http = http;
+    this.brand = brand;
+  }
+  list(params) {
+    return this.http.list("products", { brand: this.brand, query: params });
+  }
+  get(id) {
+    return this.http.get(`products/${id}`, { brand: this.brand });
+  }
+};
+var StorefrontCollections = class {
+  constructor(http, brand) {
+    this.http = http;
+    this.brand = brand;
+  }
+  list(params) {
+    return this.http.list("collections", { brand: this.brand, query: params });
+  }
+};
+var StorefrontCart = class {
+  constructor(http, brand) {
+    this.http = http;
+    this.brand = brand;
+  }
+  create() {
+    return this.http.post("cart", { brand: this.brand, idempotent: true });
+  }
+  get(id) {
+    return this.http.get(`cart/${id}`, { brand: this.brand });
+  }
+  addItem(id, item) {
+    return this.http.post(`cart/${id}/items`, {
+      brand: this.brand,
+      body: { product_id: item.productId, quantity: item.quantity },
+      idempotent: true
+    });
+  }
+};
+var ThreeuStorefront = class {
+  constructor(options) {
+    this.brand = options.brand;
+    this.http = new ThreeuHttpClient({
+      baseUrl: normalizeStorefrontBase(options.baseUrl),
+      token: options.publicToken,
+      tokenType: "public_storefront",
+      brand: options.brand,
+      fetch: options.fetch,
+      logger: options.logger,
+      telemetry: options.telemetry,
+      timeoutMs: options.timeoutMs
+    });
+    this.products = new StorefrontProducts(this.http, this.brand);
+    this.collections = new StorefrontCollections(this.http, this.brand);
+    this.cart = new StorefrontCart(this.http, this.brand);
+  }
+  /** Fetch the unified storefront config (delivery, payments, theme tokens). */
+  getConfig(params) {
+    return this.http.get("config", { brand: this.brand, query: params });
+  }
+  close() {
+    return this.http.close();
+  }
+};
+
+export { ThreeuStorefront };
+//# sourceMappingURL=chunk-6S7OFN23.js.map
+//# sourceMappingURL=chunk-6S7OFN23.js.map

package/dist/chunk-6S7OFN23.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storefront/index.ts"],"names":[],"mappings":"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","file":"chunk-6S7OFN23.js","sourcesContent":["/**\n * @threeu/threeu/storefront — public-token storefront client.\n *\n *   const storefront = new ThreeuStorefront({\n *     publicToken: import.meta.env.VITE_THREEU_PUBLIC_KEY,\n *     brand: \"my-store\",\n *   });\n *   const products = await storefront.products.list({ collection: \"featured\", limit: 8 });\n *   const cart = await storefront.cart.create();\n *\n * Public surface lives under `/api/marketplace/storefront/*` and resolves the\n * brand purely from the `platform-id` header (docs/ARCHITECTURE_MAP.md §14).\n * Safe to use in the browser — it never carries a secret token.\n */\nimport { ThreeuHttpClient } from \"../core/http-client\";\nimport type { Page } from \"../core/pagination\";\nimport type { ThreeuLogger, ThreeuTelemetryOptions } from \"../core/types\";\nimport type { Collection, Id, Product } from \"../resources/types\";\n\nconst STOREFRONT_BASE = \"/api/marketplace/storefront\";\n\nexport interface ThreeuStorefrontOptions {\n  brand: Id;\n  publicToken?: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  logger?: ThreeuLogger;\n  telemetry?: ThreeuTelemetryOptions;\n  timeoutMs?: number;\n}\n\nexport interface StorefrontProductParams {\n  collection?: string;\n  limit?: number;\n  page?: number;\n  search?: string;\n  [key: string]: unknown;\n}\n\nfunction normalizeStorefrontBase(baseUrl?: string): string {\n  if (!baseUrl) return STOREFRONT_BASE;\n  let base = baseUrl.replace(/\\/+$/, \"\");\n  if (base.includes(\"/api/marketplace/storefront\")) return base;\n  if (base.endsWith(\"/api/marketplace\")) return `${base}/storefront`;\n  if (base.endsWith(\"/api\")) return `${base}/marketplace/storefront`;\n  return `${base}${STOREFRONT_BASE}`;\n}\n\nclass StorefrontProducts {\n  constructor(\n    private readonly http: ThreeuHttpClient,\n    private readonly brand: Id,\n  ) {}\n  list(params?: StorefrontProductParams): Promise<Page<Product>> {\n    return this.http.list<Product>(\"products\", { brand: this.brand, query: params });\n  }\n  get(id: Id): Promise<Product> {\n    return this.http.get(`products/${id}`, { brand: this.brand }) as Promise<Product>;\n  }\n}\n\nclass StorefrontCollections {\n  constructor(\n    private readonly http: ThreeuHttpClient,\n    private readonly brand: Id,\n  ) {}\n  list(params?: { limit?: number; page?: number }): Promise<Page<Collection>> {\n    return this.http.list<Collection>(\"collections\", { brand: this.brand, query: params });\n  }\n}\n\nclass StorefrontCart {\n  constructor(\n    private readonly http: ThreeuHttpClient,\n    private readonly brand: Id,\n  ) {}\n  create(): Promise<Record<string, unknown>> {\n    return this.http.post(\"cart\", { brand: this.brand, idempotent: true }) as Promise<Record<string, unknown>>;\n  }\n  get(id: Id): Promise<Record<string, unknown>> {\n    return this.http.get(`cart/${id}`, { brand: this.brand }) as Promise<Record<string, unknown>>;\n  }\n  addItem(id: Id, item: { productId: Id; quantity: number }): Promise<Record<string, unknown>> {\n    return this.http.post(`cart/${id}/items`, {\n      brand: this.brand,\n      body: { product_id: item.productId, quantity: item.quantity },\n      idempotent: true,\n    }) as Promise<Record<string, unknown>>;\n  }\n}\n\nexport class ThreeuStorefront {\n  readonly http: ThreeuHttpClient;\n  readonly products: StorefrontProducts;\n  readonly collections: StorefrontCollections;\n  readonly cart: StorefrontCart;\n  private readonly brand: Id;\n\n  constructor(options: ThreeuStorefrontOptions) {\n    this.brand = options.brand;\n    this.http = new ThreeuHttpClient({\n      baseUrl: normalizeStorefrontBase(options.baseUrl),\n      token: options.publicToken,\n      tokenType: \"public_storefront\",\n      brand: options.brand,\n      fetch: options.fetch,\n      logger: options.logger,\n      telemetry: options.telemetry,\n      timeoutMs: options.timeoutMs,\n    });\n    this.products = new StorefrontProducts(this.http, this.brand);\n    this.collections = new StorefrontCollections(this.http, this.brand);\n    this.cart = new StorefrontCart(this.http, this.brand);\n  }\n\n  /** Fetch the unified storefront config (delivery, payments, theme tokens). */\n  getConfig(params?: { website?: boolean; pos?: boolean }): Promise<Record<string, unknown>> {\n    return this.http.get(\"config\", { brand: this.brand, query: params }) as Promise<Record<string, unknown>>;\n  }\n\n  close(): Promise<void> {\n    return this.http.close();\n  }\n}\n"]}