@beyondplusmm/doehpos-sdk 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,30 @@ All notable changes to `@beyondplusmm/doehpos-sdk` are documented here. This pro
 [Semantic Versioning](https://semver.org/). The stable surface is `delivery`;
 `@experimental` modules may change in a minor release until they graduate.
 
+## 0.3.0
+
+### Removed (breaking)
+
+- **kitchen** capability — `client.kitchen`, `KitchenModule`, and the
+  `TicketCreate` / `TicketResponse` types are removed. Kitchen is an
+  operator-facing subsystem (KDS, printers, prep queues, staff workflows), not a
+  third-party developer capability, so it no longer ships in the developer SDK or
+  the Merchant API docs. Pre-1.0 breaking change per SemVer (a `0.x` minor may
+  break). Apps that used `client.kitchen` must remove those calls; `0.2.0`
+  remains available on npm with kitchen if needed during migration. The stable
+  surface is now `delivery` and `loyalty`.
+
+### Added (experimental)
+
+- **orders** capability (`client.orders.submit` / `.get`, `POST /v1/orders`) —
+  `@experimental`. A server-priced **sales submission**: the client sends a
+  basket of `{ sku, qty }`; the server resolves prices/tax/inventory/totals.
+  Clients never send prices, a grand total, or a currency. Additive to and
+  independent of the legacy money-total `delivery.create`. New typed errors:
+  `EmptyOrderError`, `UnknownSkuError`, `UnpricedSkuError`,
+  `InsufficientStockError`. **Not live** until the edge façade over the POS sale
+  aggregate exists — stays `@experimental` until exercised end to end.
+
 ## 0.2.0
 
 ### Changed

package/README.md

@@ -69,12 +69,19 @@ const result = await queue.flush(); // reuses the same key — exactly one order
 
 ## Stability
 
-`delivery`, `kitchen`, and `loyalty` are the **stable** surface — all exercised
-by the Expo reference app (`kitchen`/`loyalty` graduated in 0.2.0). `marketplace`
+`delivery` and `loyalty` are the **stable** surface — both exercised by the Expo
+reference app (`loyalty` graduated in 0.2.0). `marketplace`
 and `rider` remain **`@experimental`** — generated from their OpenAPI specs and
-the golden client, but not yet exercised by the reference app. Modules graduate
-experimental → reference-app-exercised → stable. Evidence promotes an API;
-a schema only permits it.
+the golden client, but not yet exercised by the reference app. The **`orders`**
+capability (server-priced sales submission, `POST /v1/orders`) is also
+**`@experimental`** and **not yet live** — its edge façade over the POS sale
+aggregate is not built; the typed surface ships ahead of the backend.
+
+**Promotion rule.** A module graduates to stable when its contract has been
+**observed live in sandbox by at least one authoritative client** (the golden
+client and/or the Phase G synthetic probe) **and** is **exercised by the
+reference app**. The phone is not the verifier — it is another consumer of an
+already-proven contract. Evidence promotes an API; a schema only permits it.
 
 ## Sandbox boundary
 

package/dist/client.d.ts

@@ -12,10 +12,10 @@
 import { type Environment } from "./config.js";
 import { Transport, type FetchLike } from "./transport.js";
 import { DeliveryModule } from "./modules/delivery.js";
-import { KitchenModule } from "./modules/kitchen.js";
 import { LoyaltyModule } from "./modules/loyalty.js";
 import { MarketplaceModule } from "./modules/experimental/marketplace.js";
 import { RiderModule } from "./modules/experimental/rider.js";
+import { OrdersModule } from "./modules/experimental/orders.js";
 export interface DoehClientOptions {
     apiKey: string;
     /** "sandbox" (default) or "production". Ignored if baseUrl is given. */
@@ -38,13 +38,17 @@ export interface DoehClientOptions {
 export declare class DoehClient {
     readonly delivery: DeliveryModule;
     /** Stable since 0.2.0 (reference-app exercised). */
-    readonly kitchen: KitchenModule;
-    /** Stable since 0.2.0 (reference-app exercised). */
     readonly loyalty: LoyaltyModule;
     /** @experimental Not yet exercised by the reference app. */
     readonly marketplace: MarketplaceModule;
     /** @experimental Not yet exercised by the reference app. */
     readonly rider: RiderModule;
+    /**
+     * @experimental Server-priced sales submission (`POST /v1/orders`). Additive
+     * to `delivery`; the edge façade over the POS sale aggregate is not yet built,
+     * so this is not live. See openapi/orders.yaml.
+     */
+    readonly orders: OrdersModule;
     private readonly transport;
     constructor(opts: DoehClientOptions);
     /** Internal: the configured transport (used by OfflineQueue wiring/tests). */

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,IAAI,EAAE,iBAAiB;IAkCnC,8EAA8E;IAC9E,IAAI,UAAU,IAAI,SAAS,CAE1B;CACF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,IAAI,EAAE,iBAAiB;IAkCnC,8EAA8E;IAC9E,IAAI,UAAU,IAAI,SAAS,CAE1B;CACF"}

package/dist/client.js

@@ -12,10 +12,10 @@
 import { BASE_URLS, DEFAULTS, SDK_VERSION } from "./config.js";
 import { Transport } from "./transport.js";
 import { DeliveryModule } from "./modules/delivery.js";
-import { KitchenModule } from "./modules/kitchen.js";
 import { LoyaltyModule } from "./modules/loyalty.js";
 import { MarketplaceModule } from "./modules/experimental/marketplace.js";
 import { RiderModule } from "./modules/experimental/rider.js";
+import { OrdersModule } from "./modules/experimental/orders.js";
 export class DoehClient {
     constructor(opts) {
         if (!opts.apiKey)
@@ -41,10 +41,10 @@ export class DoehClient {
             sleep: opts.sleep,
         });
         this.delivery = new DeliveryModule(this.transport);
-        this.kitchen = new KitchenModule(this.transport);
         this.loyalty = new LoyaltyModule(this.transport);
         this.marketplace = new MarketplaceModule(this.transport);
         this.rider = new RiderModule(this.transport);
+        this.orders = new OrdersModule(this.transport);
     }
     /** Internal: the configured transport (used by OfflineQueue wiring/tests). */
     get _transport() {

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAoB,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAsB9D,MAAM,OAAO,UAAU;IAcrB,YAAY,IAAuB;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS;YAC9B,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,aAAa,WAAW,EAAE;YAC7C,CAAC,CAAC,YAAY,WAAW,EAAE,CAAC;QAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAK,UAAU,CAAC,KAA+B,CAAC;QAC5E,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,uEAAuE;gBACrE,qDAAqD,CACxD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC;YAC7B,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS;YACT,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS;YAC/C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;YAClD,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,8EAA8E;IAC9E,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAoB,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAsBhE,MAAM,OAAO,UAAU;IAkBrB,YAAY,IAAuB;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS;YAC9B,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,aAAa,WAAW,EAAE;YAC7C,CAAC,CAAC,YAAY,WAAW,EAAE,CAAC;QAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAK,UAAU,CAAC,KAA+B,CAAC;QAC5E,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,uEAAuE;gBACrE,qDAAqD,CACxD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC;YAC7B,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS;YACT,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS;YAC/C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;YAClD,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,8EAA8E;IAC9E,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -50,6 +50,16 @@ export declare class UnsupportedCurrencyError extends DoehApiError {
 }
 export declare class BadBodyError extends DoehApiError {
 }
+export declare class EmptyOrderError extends DoehApiError {
+}
+export declare class UnknownSkuError extends DoehApiError {
+}
+export declare class UnpricedSkuError extends DoehApiError {
+}
+export declare class InsufficientStockError extends DoehApiError {
+}
+export declare class FulfillmentNotAvailableError extends DoehApiError {
+}
 export declare class RateLimitedError extends DoehApiError {
 }
 /** Build the right typed error from an HTTP status + parsed body. */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAcA,6CAA6C;AAC7C,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAM5B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;CAK/E;AAED,iFAAiF;AACjF,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAErB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAO;CASjE;AAGD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AAGrD,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AACrD,qBAAa,sBAAuB,SAAQ,YAAY;CAAG;AAG3D,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,WAAY,SAAQ,YAAY;CAAG;AAChD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,wBAAyB,SAAQ,YAAY;CAAG;AAC7D,qBAAa,YAAa,SAAQ,YAAY;CAAG;AAGjD,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AAiBrD,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,GACf,YAAY,CAOd;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIjD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAcA,6CAA6C;AAC7C,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAM5B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO;CAK/E;AAED,iFAAiF;AACjF,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAErB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAO;CASjE;AAGD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AAGrD,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AACrD,qBAAa,sBAAuB,SAAQ,YAAY;CAAG;AAG3D,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,WAAY,SAAQ,YAAY;CAAG;AAChD,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,qBAAa,wBAAyB,SAAQ,YAAY;CAAG;AAC7D,qBAAa,YAAa,SAAQ,YAAY;CAAG;AAGjD,qBAAa,eAAgB,SAAQ,YAAY;CAAG;AACpD,qBAAa,eAAgB,SAAQ,YAAY;CAAG;AACpD,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AACrD,qBAAa,sBAAuB,SAAQ,YAAY;CAAG;AAC3D,qBAAa,4BAA6B,SAAQ,YAAY;CAAG;AAGjE,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AAsBrD,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,GACf,YAAY,CAOd;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIjD"}

package/dist/errors.js

@@ -54,6 +54,17 @@ export class UnsupportedCurrencyError extends DoehApiError {
 } // EDGE_UNSUPPORTED_CURRENCY
 export class BadBodyError extends DoehApiError {
 } // EDGE_BAD_BODY
+// ── 422 — sales submission / catalog (Orders capability, @experimental) ───────
+export class EmptyOrderError extends DoehApiError {
+} // EDGE_EMPTY_ORDER
+export class UnknownSkuError extends DoehApiError {
+} // EDGE_UNKNOWN_SKU
+export class UnpricedSkuError extends DoehApiError {
+} // EDGE_UNPRICED_SKU
+export class InsufficientStockError extends DoehApiError {
+} // EDGE_INSUFFICIENT_STOCK
+export class FulfillmentNotAvailableError extends DoehApiError {
+} // EDGE_FULFILLMENT_NOT_AVAILABLE (V1: delivery not yet served)
 // ── 429 — rate limited (retried internally; only surfaced when retries exhaust)
 export class RateLimitedError extends DoehApiError {
 }
@@ -70,6 +81,11 @@ const CODE_TO_CLASS = {
     EDGE_INVALID_AMOUNT: InvalidAmountError,
     EDGE_UNSUPPORTED_CURRENCY: UnsupportedCurrencyError,
     EDGE_BAD_BODY: BadBodyError,
+    EDGE_EMPTY_ORDER: EmptyOrderError,
+    EDGE_UNKNOWN_SKU: UnknownSkuError,
+    EDGE_UNPRICED_SKU: UnpricedSkuError,
+    EDGE_INSUFFICIENT_STOCK: InsufficientStockError,
+    EDGE_FULFILLMENT_NOT_AVAILABLE: FulfillmentNotAvailableError,
 };
 /** Build the right typed error from an HTTP status + parsed body. */
 export function mapApiError(status, body, traceId) {

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * @beyondplusmm/doehpos-sdk — official TypeScript SDK for the Doeh POS public API.
  *
- * A typed port of the validated golden client. The stable surface is `delivery`,
- * `kitchen`, and `loyalty` (all reference-app exercised); `marketplace`/`rider`
- * remain @experimental until exercised by the reference app.
+ * A typed port of the validated golden client. The stable surface is `delivery`
+ * and `loyalty` (reference-app exercised); `marketplace`/`rider` remain
+ * @experimental until exercised by the reference app.
  */
 export { DoehClient } from "./client.js";
 export type { DoehClientOptions } from "./client.js";
@@ -11,10 +11,11 @@ export { BASE_URLS, SDK_VERSION, type Environment } from "./config.js";
 export { generateIdempotencyKey, type UuidFn } from "./idempotency.js";
 export { OfflineQueue, MemoryStorage, type QueueStorage, type QueuedMutation, type DeadLetter, type FlushResult, } from "./queue.js";
 export type { Currency, OrderStatus, OrderCreate, Order, OrderResponse, ErrorBody, CallOptions, } from "./types.js";
-export { DoehError, DoehTransportError, DoehApiError, ApiKeyInvalidError, ApiKeyExpiredError, ApiKeyRevokedError, EnvMismatchError, ScopeDeniedError, TransportDisabledError, OrderNotFoundError, ReplayError, InvalidAmountError, UnsupportedCurrencyError, BadBodyError, RateLimitedError, isRetryable, mapApiError, } from "./errors.js";
+export type { FulfillmentType, PaymentStatus, OrderLineInput, Customer, Fulfillment, SalesSubmission, OrderLine, OrderTotals, SubmittedOrder, SubmissionResponse, } from "./types.js";
+export { DoehError, DoehTransportError, DoehApiError, ApiKeyInvalidError, ApiKeyExpiredError, ApiKeyRevokedError, EnvMismatchError, ScopeDeniedError, TransportDisabledError, OrderNotFoundError, ReplayError, InvalidAmountError, UnsupportedCurrencyError, BadBodyError, EmptyOrderError, UnknownSkuError, UnpricedSkuError, InsufficientStockError, FulfillmentNotAvailableError, RateLimitedError, isRetryable, mapApiError, } from "./errors.js";
 export { DeliveryModule } from "./modules/delivery.js";
-export { KitchenModule, type TicketCreate, type TicketResponse } from "./modules/kitchen.js";
 export { LoyaltyModule, type EarnInput, type AccountResponse } from "./modules/loyalty.js";
 export { MarketplaceModule, type ListingCreate, type ListingResponse, } from "./modules/experimental/marketplace.js";
 export { RiderModule, type JobCreate, type JobResponse } from "./modules/experimental/rider.js";
+export { OrdersModule } from "./modules/experimental/orders.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EACL,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,KAAK,EACL,aAAa,EACb,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EACL,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,KAAK,EACL,aAAa,EACb,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,EACR,WAAW,EACX,eAAe,EACf,SAAS,EACT,WAAW,EACX,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -1,20 +1,20 @@
 /**
  * @beyondplusmm/doehpos-sdk — official TypeScript SDK for the Doeh POS public API.
  *
- * A typed port of the validated golden client. The stable surface is `delivery`,
- * `kitchen`, and `loyalty` (all reference-app exercised); `marketplace`/`rider`
- * remain @experimental until exercised by the reference app.
+ * A typed port of the validated golden client. The stable surface is `delivery`
+ * and `loyalty` (reference-app exercised); `marketplace`/`rider` remain
+ * @experimental until exercised by the reference app.
  */
 export { DoehClient } from "./client.js";
 export { BASE_URLS, SDK_VERSION } from "./config.js";
 export { generateIdempotencyKey } from "./idempotency.js";
 export { OfflineQueue, MemoryStorage, } from "./queue.js";
 // Error ABI — consumers catch these classes, never parse `code` strings.
-export { DoehError, DoehTransportError, DoehApiError, ApiKeyInvalidError, ApiKeyExpiredError, ApiKeyRevokedError, EnvMismatchError, ScopeDeniedError, TransportDisabledError, OrderNotFoundError, ReplayError, InvalidAmountError, UnsupportedCurrencyError, BadBodyError, RateLimitedError, isRetryable, mapApiError, } from "./errors.js";
+export { DoehError, DoehTransportError, DoehApiError, ApiKeyInvalidError, ApiKeyExpiredError, ApiKeyRevokedError, EnvMismatchError, ScopeDeniedError, TransportDisabledError, OrderNotFoundError, ReplayError, InvalidAmountError, UnsupportedCurrencyError, BadBodyError, EmptyOrderError, UnknownSkuError, UnpricedSkuError, InsufficientStockError, FulfillmentNotAvailableError, RateLimitedError, isRetryable, mapApiError, } from "./errors.js";
 // Module classes + their types (handy for typing app code).
 export { DeliveryModule } from "./modules/delivery.js";
-export { KitchenModule } from "./modules/kitchen.js";
 export { LoyaltyModule } from "./modules/loyalty.js";
 export { MarketplaceModule, } from "./modules/experimental/marketplace.js";
 export { RiderModule } from "./modules/experimental/rider.js";
+export { OrdersModule } from "./modules/experimental/orders.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAoB,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAe,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EACL,YAAY,EACZ,aAAa,GAKd,MAAM,YAAY,CAAC;AAYpB,yEAAyE;AACzE,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAA0C,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAwC,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EACL,iBAAiB,GAGlB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAoC,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAoB,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,sBAAsB,EAAe,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EACL,YAAY,EACZ,aAAa,GAKd,MAAM,YAAY,CAAC;AA0BpB,yEAAyE;AACzE,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAwC,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EACL,iBAAiB,GAGlB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAoC,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/modules/experimental/orders.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Orders (Sales Submission) — EXPERIMENTAL.
+ *
+ * @experimental The server-priced sales-submission capability. A submission is a
+ * basket of {sku, qty}; the server resolves prices from the catalog, applies
+ * tax/discounts/promotions/loyalty, deducts inventory, records COGS, and computes
+ * all totals. Clients NEVER send prices or a grand total, and never a currency
+ * (it is branch-native, derived from the token). This is the typed surface for
+ * `POST /v1/orders` (see openapi/orders.yaml).
+ *
+ * Additive to and independent of the legacy money-total `delivery.create`. Stays
+ * @experimental until the edge façade over the POS sale aggregate exists and the
+ * capability is exercised live (promotion rule: observed-live + reference-app).
+ */
+import type { Transport } from "../../transport.js";
+import type { CallOptions, SalesSubmission, SubmissionResponse } from "../../types.js";
+export declare class OrdersModule {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Submit a sale by line items. Returns 201 on first write, or 200 with
+     * `idempotent: true` when an Idempotency-Key replays an existing order.
+     *
+     * Client-side validation is intentionally minimal — it mirrors only the
+     * obvious structural rules (non-empty basket, positive integer quantities)
+     * so mistakes fail without burning a request. The server remains the source
+     * of truth for SKUs, pricing, stock, and totals.
+     */
+    submit(input: SalesSubmission, opts?: CallOptions): Promise<SubmissionResponse>;
+    /** Read a submitted order (resolved lines + totals) by id. */
+    get(id: string, opts?: CallOptions): Promise<SubmissionResponse>;
+}
+//# sourceMappingURL=orders.d.ts.map

package/dist/modules/experimental/orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../../src/modules/experimental/orders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMvF,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuBzF,8DAA8D;IACxD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAY3E"}

package/dist/modules/experimental/orders.js

@@ -0,0 +1,53 @@
+import { generateIdempotencyKey } from "../../idempotency.js";
+/** Path ids must match this server-side pattern; we fail fast client-side. */
+const PATH_ID = /^[A-Za-z0-9_]+$/;
+export class OrdersModule {
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /**
+     * Submit a sale by line items. Returns 201 on first write, or 200 with
+     * `idempotent: true` when an Idempotency-Key replays an existing order.
+     *
+     * Client-side validation is intentionally minimal — it mirrors only the
+     * obvious structural rules (non-empty basket, positive integer quantities)
+     * so mistakes fail without burning a request. The server remains the source
+     * of truth for SKUs, pricing, stock, and totals.
+     */
+    async submit(input, opts = {}) {
+        if (!Array.isArray(input.lines) || input.lines.length === 0) {
+            throw new RangeError("a submission requires at least one line");
+        }
+        for (const line of input.lines) {
+            if (!line || typeof line.sku !== "string" || line.sku.length === 0) {
+                throw new RangeError("each line requires a non-empty sku");
+            }
+            if (!Number.isInteger(line.qty) || line.qty < 1) {
+                throw new RangeError(`line ${JSON.stringify(line.sku)} qty must be an integer >= 1`);
+            }
+        }
+        const { body } = await this.transport.request({
+            method: "POST",
+            path: "/v1/orders",
+            body: input,
+            idempotencyKey: opts.idempotencyKey ?? generateIdempotencyKey("orders"),
+            traceId: opts.traceId,
+            signal: opts.signal,
+        });
+        return body;
+    }
+    /** Read a submitted order (resolved lines + totals) by id. */
+    async get(id, opts = {}) {
+        if (!PATH_ID.test(id)) {
+            throw new RangeError(`invalid order id ${JSON.stringify(id)} (must match ${PATH_ID})`);
+        }
+        const { body } = await this.transport.request({
+            method: "GET",
+            path: `/v1/orders/${id}`,
+            traceId: opts.traceId,
+            signal: opts.signal,
+        });
+        return body;
+    }
+}
+//# sourceMappingURL=orders.js.map

package/dist/modules/experimental/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../../src/modules/experimental/orders.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,8EAA8E;AAC9E,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAElC,MAAM,OAAO,YAAY;IACvB,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,KAAsB,EAAE,OAAoB,EAAE;QACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,UAAU,CAAC,oCAAoC,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,UAAU,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAqB;YAChE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,KAAK;YACX,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,sBAAsB,CAAC,QAAQ,CAAC;YACvE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,OAAoB,EAAE;QAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,UAAU,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,gBAAgB,OAAO,GAAG,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAqB;YAChE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,EAAE,EAAE;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/types.d.ts

@@ -37,6 +37,68 @@ export interface ErrorBody {
     /** Internal verification step (diagnostic only). */
     step?: string;
 }
+export type FulfillmentType = "pickup" | "delivery" | "dine_in";
+/** One requested line: WHAT and HOW MANY only — never a price, name, or station. */
+export interface OrderLineInput {
+    sku: string;
+    /** Integer >= 1. */
+    qty: number;
+    /** Optional catalog modifier ids; priced server-side. */
+    modifier_ids?: string[];
+}
+export interface Customer {
+    /** E.164, e.g. +95912345678. */
+    phone?: string;
+}
+export interface Fulfillment {
+    type?: FulfillmentType;
+}
+/** Request body for POST /v1/orders. No currency, no prices, no total. */
+export interface SalesSubmission {
+    lines: OrderLineInput[];
+    customer?: Customer;
+    fulfillment?: Fulfillment;
+}
+/** A line as resolved and priced by the server. */
+export interface OrderLine {
+    sku: string;
+    name?: string;
+    qty: number;
+    unit_price_minor: number;
+    line_total_minor: number;
+    tax_minor?: number;
+}
+export interface OrderTotals {
+    currency: Currency;
+    subtotal_minor: number;
+    discount_minor: number;
+    tax_minor: number;
+    grand_total_minor: number;
+}
+/** Settlement state of a submitted order. V1 is always "unpaid" (pay_later). */
+export type PaymentStatus = "unpaid" | "paid";
+export interface SubmittedOrder {
+    id: string;
+    status: OrderStatus;
+    /** V1: always "unpaid" — a submission is purchase intent, not settlement. */
+    payment_status: PaymentStatus;
+    shop_id: number;
+    branch_id: number;
+    lines: OrderLine[];
+    totals: OrderTotals;
+    customer?: Customer;
+    fulfillment?: Fulfillment;
+    created_at_utc: string;
+    /** created_at rendered in the branch's native timezone. */
+    created_at_local: string;
+    idempotency_key?: string;
+}
+export interface SubmissionResponse {
+    ok: boolean;
+    /** true if this was an idempotent replay (HTTP 200 instead of 201). */
+    idempotent?: boolean;
+    order: SubmittedOrder;
+}
 /** Per-call options that map onto request headers. */
 export interface CallOptions {
     /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErE,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEhB,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErE,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEhB,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhE,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,6EAA6E;IAC7E,cAAc,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beyondplusmm/doehpos-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official TypeScript SDK for the Doeh POS public API — a typed port of the validated golden client.",
   "type": "module",
   "main": "./dist/index.js",

package/src/client.ts

@@ -12,10 +12,10 @@
 import { BASE_URLS, DEFAULTS, SDK_VERSION, type Environment } from "./config.js";
 import { Transport, type FetchLike } from "./transport.js";
 import { DeliveryModule } from "./modules/delivery.js";
-import { KitchenModule } from "./modules/kitchen.js";
 import { LoyaltyModule } from "./modules/loyalty.js";
 import { MarketplaceModule } from "./modules/experimental/marketplace.js";
 import { RiderModule } from "./modules/experimental/rider.js";
+import { OrdersModule } from "./modules/experimental/orders.js";
 
 export interface DoehClientOptions {
   apiKey: string;
@@ -40,14 +40,18 @@ export interface DoehClientOptions {
 export class DoehClient {
   readonly delivery: DeliveryModule;
   /** Stable since 0.2.0 (reference-app exercised). */
-  readonly kitchen: KitchenModule;
-  /** Stable since 0.2.0 (reference-app exercised). */
   readonly loyalty: LoyaltyModule;
 
   /** @experimental Not yet exercised by the reference app. */
   readonly marketplace: MarketplaceModule;
   /** @experimental Not yet exercised by the reference app. */
   readonly rider: RiderModule;
+  /**
+   * @experimental Server-priced sales submission (`POST /v1/orders`). Additive
+   * to `delivery`; the edge façade over the POS sale aggregate is not yet built,
+   * so this is not live. See openapi/orders.yaml.
+   */
+  readonly orders: OrdersModule;
 
   private readonly transport: Transport;
 
@@ -79,10 +83,10 @@ export class DoehClient {
     });
 
     this.delivery = new DeliveryModule(this.transport);
-    this.kitchen = new KitchenModule(this.transport);
     this.loyalty = new LoyaltyModule(this.transport);
     this.marketplace = new MarketplaceModule(this.transport);
     this.rider = new RiderModule(this.transport);
+    this.orders = new OrdersModule(this.transport);
   }
 
   /** Internal: the configured transport (used by OfflineQueue wiring/tests). */

package/src/errors.ts

@@ -75,6 +75,13 @@ export class InvalidAmountError extends DoehApiError {} // EDGE_INVALID_AMOUNT
 export class UnsupportedCurrencyError extends DoehApiError {} // EDGE_UNSUPPORTED_CURRENCY
 export class BadBodyError extends DoehApiError {} // EDGE_BAD_BODY
 
+// ── 422 — sales submission / catalog (Orders capability, @experimental) ───────
+export class EmptyOrderError extends DoehApiError {} // EDGE_EMPTY_ORDER
+export class UnknownSkuError extends DoehApiError {} // EDGE_UNKNOWN_SKU
+export class UnpricedSkuError extends DoehApiError {} // EDGE_UNPRICED_SKU
+export class InsufficientStockError extends DoehApiError {} // EDGE_INSUFFICIENT_STOCK
+export class FulfillmentNotAvailableError extends DoehApiError {} // EDGE_FULFILLMENT_NOT_AVAILABLE (V1: delivery not yet served)
+
 // ── 429 — rate limited (retried internally; only surfaced when retries exhaust)
 export class RateLimitedError extends DoehApiError {}
 
@@ -91,6 +98,11 @@ const CODE_TO_CLASS: Record<string, typeof DoehApiError> = {
   EDGE_INVALID_AMOUNT: InvalidAmountError,
   EDGE_UNSUPPORTED_CURRENCY: UnsupportedCurrencyError,
   EDGE_BAD_BODY: BadBodyError,
+  EDGE_EMPTY_ORDER: EmptyOrderError,
+  EDGE_UNKNOWN_SKU: UnknownSkuError,
+  EDGE_UNPRICED_SKU: UnpricedSkuError,
+  EDGE_INSUFFICIENT_STOCK: InsufficientStockError,
+  EDGE_FULFILLMENT_NOT_AVAILABLE: FulfillmentNotAvailableError,
 };
 
 /** Build the right typed error from an HTTP status + parsed body. */

package/src/index.ts

@@ -1,9 +1,9 @@
 /**
  * @beyondplusmm/doehpos-sdk — official TypeScript SDK for the Doeh POS public API.
  *
- * A typed port of the validated golden client. The stable surface is `delivery`,
- * `kitchen`, and `loyalty` (all reference-app exercised); `marketplace`/`rider`
- * remain @experimental until exercised by the reference app.
+ * A typed port of the validated golden client. The stable surface is `delivery`
+ * and `loyalty` (reference-app exercised); `marketplace`/`rider` remain
+ * @experimental until exercised by the reference app.
  */
 export { DoehClient } from "./client.js";
 export type { DoehClientOptions } from "./client.js";
@@ -31,6 +31,20 @@ export type {
   CallOptions,
 } from "./types.js";
 
+// Orders (Sales Submission) capability types — @experimental.
+export type {
+  FulfillmentType,
+  PaymentStatus,
+  OrderLineInput,
+  Customer,
+  Fulfillment,
+  SalesSubmission,
+  OrderLine,
+  OrderTotals,
+  SubmittedOrder,
+  SubmissionResponse,
+} from "./types.js";
+
 // Error ABI — consumers catch these classes, never parse `code` strings.
 export {
   DoehError,
@@ -47,6 +61,11 @@ export {
   InvalidAmountError,
   UnsupportedCurrencyError,
   BadBodyError,
+  EmptyOrderError,
+  UnknownSkuError,
+  UnpricedSkuError,
+  InsufficientStockError,
+  FulfillmentNotAvailableError,
   RateLimitedError,
   isRetryable,
   mapApiError,
@@ -54,7 +73,6 @@ export {
 
 // Module classes + their types (handy for typing app code).
 export { DeliveryModule } from "./modules/delivery.js";
-export { KitchenModule, type TicketCreate, type TicketResponse } from "./modules/kitchen.js";
 export { LoyaltyModule, type EarnInput, type AccountResponse } from "./modules/loyalty.js";
 export {
   MarketplaceModule,
@@ -62,3 +80,4 @@ export {
   type ListingResponse,
 } from "./modules/experimental/marketplace.js";
 export { RiderModule, type JobCreate, type JobResponse } from "./modules/experimental/rider.js";
+export { OrdersModule } from "./modules/experimental/orders.js";

package/src/modules/experimental/orders.ts

@@ -0,0 +1,70 @@
+/**
+ * Orders (Sales Submission) — EXPERIMENTAL.
+ *
+ * @experimental The server-priced sales-submission capability. A submission is a
+ * basket of {sku, qty}; the server resolves prices from the catalog, applies
+ * tax/discounts/promotions/loyalty, deducts inventory, records COGS, and computes
+ * all totals. Clients NEVER send prices or a grand total, and never a currency
+ * (it is branch-native, derived from the token). This is the typed surface for
+ * `POST /v1/orders` (see openapi/orders.yaml).
+ *
+ * Additive to and independent of the legacy money-total `delivery.create`. Stays
+ * @experimental until the edge façade over the POS sale aggregate exists and the
+ * capability is exercised live (promotion rule: observed-live + reference-app).
+ */
+import type { Transport } from "../../transport.js";
+import type { CallOptions, SalesSubmission, SubmissionResponse } from "../../types.js";
+import { generateIdempotencyKey } from "../../idempotency.js";
+
+/** Path ids must match this server-side pattern; we fail fast client-side. */
+const PATH_ID = /^[A-Za-z0-9_]+$/;
+
+export class OrdersModule {
+  constructor(private readonly transport: Transport) {}
+
+  /**
+   * Submit a sale by line items. Returns 201 on first write, or 200 with
+   * `idempotent: true` when an Idempotency-Key replays an existing order.
+   *
+   * Client-side validation is intentionally minimal — it mirrors only the
+   * obvious structural rules (non-empty basket, positive integer quantities)
+   * so mistakes fail without burning a request. The server remains the source
+   * of truth for SKUs, pricing, stock, and totals.
+   */
+  async submit(input: SalesSubmission, opts: CallOptions = {}): Promise<SubmissionResponse> {
+    if (!Array.isArray(input.lines) || input.lines.length === 0) {
+      throw new RangeError("a submission requires at least one line");
+    }
+    for (const line of input.lines) {
+      if (!line || typeof line.sku !== "string" || line.sku.length === 0) {
+        throw new RangeError("each line requires a non-empty sku");
+      }
+      if (!Number.isInteger(line.qty) || line.qty < 1) {
+        throw new RangeError(`line ${JSON.stringify(line.sku)} qty must be an integer >= 1`);
+      }
+    }
+    const { body } = await this.transport.request<SubmissionResponse>({
+      method: "POST",
+      path: "/v1/orders",
+      body: input,
+      idempotencyKey: opts.idempotencyKey ?? generateIdempotencyKey("orders"),
+      traceId: opts.traceId,
+      signal: opts.signal,
+    });
+    return body;
+  }
+
+  /** Read a submitted order (resolved lines + totals) by id. */
+  async get(id: string, opts: CallOptions = {}): Promise<SubmissionResponse> {
+    if (!PATH_ID.test(id)) {
+      throw new RangeError(`invalid order id ${JSON.stringify(id)} (must match ${PATH_ID})`);
+    }
+    const { body } = await this.transport.request<SubmissionResponse>({
+      method: "GET",
+      path: `/v1/orders/${id}`,
+      traceId: opts.traceId,
+      signal: opts.signal,
+    });
+    return body;
+  }
+}

package/src/types.ts

@@ -49,6 +49,83 @@ export interface ErrorBody {
   step?: string;
 }
 
+// ── Orders (Sales Submission) capability — @experimental ─────────────────────
+// A submission is a basket of {sku, qty}; the server owns pricing/tax/inventory/
+// totals. Clients NEVER send prices or a grand total. Currency is branch-native
+// (token-derived) and returned in the response. See openapi/orders.yaml.
+
+export type FulfillmentType = "pickup" | "delivery" | "dine_in";
+
+/** One requested line: WHAT and HOW MANY only — never a price, name, or station. */
+export interface OrderLineInput {
+  sku: string;
+  /** Integer >= 1. */
+  qty: number;
+  /** Optional catalog modifier ids; priced server-side. */
+  modifier_ids?: string[];
+}
+
+export interface Customer {
+  /** E.164, e.g. +95912345678. */
+  phone?: string;
+}
+
+export interface Fulfillment {
+  type?: FulfillmentType;
+}
+
+/** Request body for POST /v1/orders. No currency, no prices, no total. */
+export interface SalesSubmission {
+  lines: OrderLineInput[];
+  customer?: Customer;
+  fulfillment?: Fulfillment;
+}
+
+/** A line as resolved and priced by the server. */
+export interface OrderLine {
+  sku: string;
+  name?: string;
+  qty: number;
+  unit_price_minor: number;
+  line_total_minor: number;
+  tax_minor?: number;
+}
+
+export interface OrderTotals {
+  currency: Currency;
+  subtotal_minor: number;
+  discount_minor: number;
+  tax_minor: number;
+  grand_total_minor: number;
+}
+
+/** Settlement state of a submitted order. V1 is always "unpaid" (pay_later). */
+export type PaymentStatus = "unpaid" | "paid";
+
+export interface SubmittedOrder {
+  id: string;
+  status: OrderStatus;
+  /** V1: always "unpaid" — a submission is purchase intent, not settlement. */
+  payment_status: PaymentStatus;
+  shop_id: number;
+  branch_id: number;
+  lines: OrderLine[];
+  totals: OrderTotals;
+  customer?: Customer;
+  fulfillment?: Fulfillment;
+  created_at_utc: string;
+  /** created_at rendered in the branch's native timezone. */
+  created_at_local: string;
+  idempotency_key?: string;
+}
+
+export interface SubmissionResponse {
+  ok: boolean;
+  /** true if this was an idempotent replay (HTTP 200 instead of 201). */
+  idempotent?: boolean;
+  order: SubmittedOrder;
+}
+
 /** Per-call options that map onto request headers. */
 export interface CallOptions {
   /**

package/dist/modules/kitchen.d.ts

@@ -1,32 +0,0 @@
-/**
- * Kitchen — stable.
- *
- *   POST /v1/kitchen/tickets        create a ticket (idempotent with an Idempotency-Key)
- *   GET  /v1/kitchen/tickets/{id}   read back
- *
- * Scope is derived from the key server-side; there is no shop/branch argument.
- * Graduated from @experimental in 0.2.0 once exercised by the Expo reference app.
- */
-import type { Transport } from "../transport.js";
-import type { CallOptions } from "../types.js";
-export interface TicketCreate {
-    station: string;
-    items: string[];
-}
-export interface TicketResponse {
-    ok: boolean;
-    idempotent?: boolean;
-    ticket: {
-        id: string;
-        [k: string]: unknown;
-    };
-}
-export declare class KitchenModule {
-    private readonly transport;
-    constructor(transport: Transport);
-    /** Create a kitchen ticket. Idempotent with an Idempotency-Key. */
-    createTicket(input: TicketCreate, opts?: CallOptions): Promise<TicketResponse>;
-    /** Read a kitchen ticket back by id. */
-    getTicket(id: string, opts?: CallOptions): Promise<TicketResponse>;
-}
-//# sourceMappingURL=kitchen.d.ts.map

package/dist/modules/kitchen.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kitchen.d.ts","sourceRoot":"","sources":["../../src/modules/kitchen.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AACD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAC9C;AAID,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD,mEAAmE;IAC7D,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAYxF,wCAAwC;IAClC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;CAU7E"}

package/dist/modules/kitchen.js

@@ -1,32 +0,0 @@
-import { generateIdempotencyKey } from "../idempotency.js";
-const PATH_ID = /^[A-Za-z0-9_]+$/;
-export class KitchenModule {
-    constructor(transport) {
-        this.transport = transport;
-    }
-    /** Create a kitchen ticket. Idempotent with an Idempotency-Key. */
-    async createTicket(input, opts = {}) {
-        const { body } = await this.transport.request({
-            method: "POST",
-            path: "/v1/kitchen/tickets",
-            body: input,
-            idempotencyKey: opts.idempotencyKey ?? generateIdempotencyKey("kitchen"),
-            traceId: opts.traceId,
-            signal: opts.signal,
-        });
-        return body;
-    }
-    /** Read a kitchen ticket back by id. */
-    async getTicket(id, opts = {}) {
-        if (!PATH_ID.test(id))
-            throw new RangeError(`invalid ticket id ${JSON.stringify(id)}`);
-        const { body } = await this.transport.request({
-            method: "GET",
-            path: `/v1/kitchen/tickets/${id}`,
-            traceId: opts.traceId,
-            signal: opts.signal,
-        });
-        return body;
-    }
-}
-//# sourceMappingURL=kitchen.js.map

package/dist/modules/kitchen.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kitchen.js","sourceRoot":"","sources":["../../src/modules/kitchen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAY3D,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAElC,MAAM,OAAO,aAAa;IACxB,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,mEAAmE;IACnE,KAAK,CAAC,YAAY,CAAC,KAAmB,EAAE,OAAoB,EAAE;QAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAiB;YAC5D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,KAAK;YACX,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,sBAAsB,CAAC,SAAS,CAAC;YACxE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,OAAoB,EAAE;QAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAiB;YAC5D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,uBAAuB,EAAE,EAAE;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/src/modules/kitchen.ts

@@ -1,53 +0,0 @@
-/**
- * Kitchen — stable.
- *
- *   POST /v1/kitchen/tickets        create a ticket (idempotent with an Idempotency-Key)
- *   GET  /v1/kitchen/tickets/{id}   read back
- *
- * Scope is derived from the key server-side; there is no shop/branch argument.
- * Graduated from @experimental in 0.2.0 once exercised by the Expo reference app.
- */
-import type { Transport } from "../transport.js";
-import type { CallOptions } from "../types.js";
-import { generateIdempotencyKey } from "../idempotency.js";
-
-export interface TicketCreate {
-  station: string;
-  items: string[];
-}
-export interface TicketResponse {
-  ok: boolean;
-  idempotent?: boolean;
-  ticket: { id: string; [k: string]: unknown };
-}
-
-const PATH_ID = /^[A-Za-z0-9_]+$/;
-
-export class KitchenModule {
-  constructor(private readonly transport: Transport) {}
-
-  /** Create a kitchen ticket. Idempotent with an Idempotency-Key. */
-  async createTicket(input: TicketCreate, opts: CallOptions = {}): Promise<TicketResponse> {
-    const { body } = await this.transport.request<TicketResponse>({
-      method: "POST",
-      path: "/v1/kitchen/tickets",
-      body: input,
-      idempotencyKey: opts.idempotencyKey ?? generateIdempotencyKey("kitchen"),
-      traceId: opts.traceId,
-      signal: opts.signal,
-    });
-    return body;
-  }
-
-  /** Read a kitchen ticket back by id. */
-  async getTicket(id: string, opts: CallOptions = {}): Promise<TicketResponse> {
-    if (!PATH_ID.test(id)) throw new RangeError(`invalid ticket id ${JSON.stringify(id)}`);
-    const { body } = await this.transport.request<TicketResponse>({
-      method: "GET",
-      path: `/v1/kitchen/tickets/${id}`,
-      traceId: opts.traceId,
-      signal: opts.signal,
-    });
-    return body;
-  }
-}