@beyondplusmm/doehpos-sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to `@beyondplusmm/doehpos-sdk` are documented here. This project adheres to
+[Semantic Versioning](https://semver.org/). The stable surface is `delivery`;
+`@experimental` modules may change in a minor release until they graduate.
+
+## 0.1.0
+
+Initial release — a typed port of the validated golden client.
+
+### Added
+
+- `DoehClient` with `environment: "sandbox" | "production"` (cutover is config
+  only; no shop concept — scope is derived from the key).
+- **delivery** module (stable): `create`, `get`.
+- **kitchen / loyalty / marketplace / rider** modules (`@experimental`,
+  schema-derived, not yet reference-app-exercised).
+- Typed error ABI: `ApiKeyInvalidError`, `ApiKeyExpiredError`,
+  `ApiKeyRevokedError`, `EnvMismatchError`, `ScopeDeniedError`,
+  `TransportDisabledError`, `OrderNotFoundError`, `ReplayError`,
+  `InvalidAmountError`, `UnsupportedCurrencyError`, `BadBodyError`,
+  `RateLimitedError`, plus `DoehTransportError`.
+- `OfflineQueue` with pluggable `QueueStorage` — mints one idempotency key per
+  mutation and reuses it on every attempt; dead-letters terminal failures.
+- Retry policy limited to transport failures and HTTP 429 (linear backoff).
+- Mandatory `User-Agent`; `Idempotency-Key` and `Trace-Id` headers.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bplusmyanmar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# @beyondplusmm/doehpos-sdk
+
+Official TypeScript SDK for the **Doeh POS public API**. A typed port of the
+validated [golden client](../../README.md#provenance) — the SDK exists so the
+public integration surface can never drift from the contract that was proven
+live (14/14) against the sandbox.
+
+```ts
+import { DoehClient } from "@beyondplusmm/doehpos-sdk";
+
+const client = new DoehClient({ apiKey: "sk_test_…", environment: "sandbox" });
+
+const { order } = await client.delivery.create({ currency: "MMK", amount_minor: 1500 });
+const { order: same } = await client.delivery.get(order.id);
+```
+
+## Design invariants
+
+1. **No shop concept.** Scope (shop/branch) is derived from the key server-side.
+   One key == one shop. There is no `shopId` argument anywhere — to act as a
+   different shop, use a different key.
+2. **Money is integer minor units.** `1500` == `15.00`. Never a decimal.
+3. **Idempotency is owned by the create.** Pass `idempotencyKey` to make a create
+   safely retryable. For offline-safe retries, mint the key **once** and reuse it
+   on every attempt — `OfflineQueue` does this for you.
+4. **Retries are narrow.** Only transport failures and HTTP `429` (the fleet rate
+   limiter) are retried, with linear backoff. Every other status — including 4xx
+   validation and 5xx — is terminal and surfaces immediately.
+5. **Typed error ABI.** Catch classes, never parse `code` strings:
+   `ApiKeyInvalidError`, `ApiKeyRevokedError`, `EnvMismatchError`,
+   `ScopeDeniedError`, `TransportDisabledError`, `OrderNotFoundError`,
+   `ReplayError`, `InvalidAmountError`, `UnsupportedCurrencyError`,
+   `BadBodyError`, `RateLimitedError`, plus `DoehTransportError`.
+6. **Mandatory User-Agent.** The edge/WAF rejects default library agents; the SDK
+   always sends one. Pass `userAgent` to identify your app in server logs.
+
+## Offline queue
+
+```ts
+import { OfflineQueue, MemoryStorage } from "@beyondplusmm/doehpos-sdk";
+
+// On React Native, back this with an AsyncStorage-backed QueueStorage.
+const queue = new OfflineQueue(client.delivery, new MemoryStorage());
+
+await queue.enqueue({ currency: "MMK", amount_minor: 1500 }); // mints + persists the key
+// ...later, when connectivity returns:
+const result = await queue.flush(); // reuses the same key — exactly one order
+```
+
+- `succeeded` — accepted this flush.
+- `remaining` — still pending (offline / rate-limited); retried next flush.
+- `deadLettered` — terminal failures (e.g. validation); removed, never looped.
+
+## Stability
+
+`delivery` is the **stable** surface. `kitchen`, `loyalty`, `marketplace`, and
+`rider` are **`@experimental`** — generated from their OpenAPI specs and the
+golden client, but not yet exercised by the reference app. They graduate
+experimental → reference-app-exercised → stable. Evidence promotes an API;
+a schema only permits it.
+
+## Sandbox boundary
+
+Against the sandbox, create + read-back + idempotency are fully real. Downstream
+fulfillment propagation is intentionally absent, so an order's `status` does not
+transition there. Cutover to production is `environment: "production"` + a
+`sk_live_` key — no code change.
+
+## Scripts
+
+| command | what |
+| --- | --- |
+| `pnpm build` | compile `src` → `dist` (ESM + types) |
+| `pnpm test` | offline unit tests (fake fetch; no network) |
+| `pnpm test:integration` | live delivery matrix against the sandbox (needs `DOEH_API_KEY`) |

package/dist/client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * DoehClient — the public entry point.
+ *
+ *     const client = new DoehClient({ apiKey: "sk_test_…", environment: "sandbox" });
+ *     const { order } = await client.delivery.create({ currency: "MMK", amount_minor: 1500 });
+ *
+ * There is intentionally NO shop concept: scope is derived from the key. To act
+ * as a different shop, construct a client with a different key. Cutover from
+ * sandbox to production is `environment: "production"` + a `sk_live_` key — no
+ * code change.
+ */
+import { type Environment } from "./config.js";
+import { Transport, type FetchLike } from "./transport.js";
+import { DeliveryModule } from "./modules/delivery.js";
+import { KitchenModule } from "./modules/experimental/kitchen.js";
+import { LoyaltyModule } from "./modules/experimental/loyalty.js";
+import { MarketplaceModule } from "./modules/experimental/marketplace.js";
+import { RiderModule } from "./modules/experimental/rider.js";
+export interface DoehClientOptions {
+    apiKey: string;
+    /** "sandbox" (default) or "production". Ignored if baseUrl is given. */
+    environment?: Environment;
+    /** Override the base URL entirely (advanced / self-host / tests). */
+    baseUrl?: string;
+    /**
+     * Override the (mandatory) User-Agent. The SDK always sends one; supplying
+     * your own is encouraged so your app is identifiable in server logs, e.g.
+     * "MyMerchantApp/2.1". The SDK token is appended automatically.
+     */
+    userAgent?: string;
+    /** Inject a fetch implementation (RN / undici / mock). Defaults to global. */
+    fetch?: FetchLike;
+    timeoutMs?: number;
+    maxRetries?: number;
+    /** Test hook to make backoff instant. */
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare class DoehClient {
+    readonly delivery: DeliveryModule;
+    /** @experimental Not yet exercised by the reference app. */
+    readonly kitchen: KitchenModule;
+    /** @experimental Not yet exercised by the reference app. */
+    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;
+    private readonly transport;
+    constructor(opts: DoehClientOptions);
+    /** Internal: the configured transport (used by OfflineQueue wiring/tests). */
+    get _transport(): Transport;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +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,mCAAmC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,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;IAElC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,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"}

package/dist/client.js

@@ -0,0 +1,54 @@
+/**
+ * DoehClient — the public entry point.
+ *
+ *     const client = new DoehClient({ apiKey: "sk_test_…", environment: "sandbox" });
+ *     const { order } = await client.delivery.create({ currency: "MMK", amount_minor: 1500 });
+ *
+ * There is intentionally NO shop concept: scope is derived from the key. To act
+ * as a different shop, construct a client with a different key. Cutover from
+ * sandbox to production is `environment: "production"` + a `sk_live_` key — no
+ * code change.
+ */
+import { BASE_URLS, DEFAULTS, SDK_VERSION } from "./config.js";
+import { Transport } from "./transport.js";
+import { DeliveryModule } from "./modules/delivery.js";
+import { KitchenModule } from "./modules/experimental/kitchen.js";
+import { LoyaltyModule } from "./modules/experimental/loyalty.js";
+import { MarketplaceModule } from "./modules/experimental/marketplace.js";
+import { RiderModule } from "./modules/experimental/rider.js";
+export class DoehClient {
+    constructor(opts) {
+        if (!opts.apiKey)
+            throw new Error("DoehClient requires an apiKey");
+        const env = opts.environment ?? "sandbox";
+        const baseUrl = opts.baseUrl ?? BASE_URLS[env];
+        const userAgent = opts.userAgent
+            ? `${opts.userAgent} doeh-sdk/${SDK_VERSION}`
+            : `doeh-sdk/${SDK_VERSION}`;
+        const fetchImpl = opts.fetch ?? globalThis.fetch;
+        if (typeof fetchImpl !== "function") {
+            throw new Error("No fetch implementation available. Pass `fetch` in DoehClientOptions " +
+                "(e.g. from undici on older Node, or the RN global).");
+        }
+        this.transport = new Transport({
+            baseUrl,
+            apiKey: opts.apiKey,
+            userAgent,
+            fetch: fetchImpl,
+            timeoutMs: opts.timeoutMs ?? DEFAULTS.timeoutMs,
+            maxRetries: opts.maxRetries ?? DEFAULTS.maxRetries,
+            backoffBaseMs: DEFAULTS.backoffBaseMs,
+            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);
+    }
+    /** Internal: the configured transport (used by OfflineQueue wiring/tests). */
+    get _transport() {
+        return this.transport;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +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,mCAAmC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,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"}

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Environment configuration.
+ *
+ * "single shop" is NOT a config concept here. The shop/branch scope is derived
+ * from the API key server-side — the client never sends scope. One key == one
+ * shop. To act as a different shop, use a different key.
+ */
+export type Environment = "sandbox" | "production";
+/** Base URLs per environment, taken verbatim from the validated golden client. */
+export declare const BASE_URLS: Record<Environment, string>;
+/** Default SDK version string surfaced in the (mandatory) User-Agent. */
+export declare const SDK_VERSION = "0.1.0";
+export declare const DEFAULTS: {
+    /** Per-request timeout. */
+    readonly timeoutMs: 15000;
+    /**
+     * Max retry attempts. Retries apply ONLY to transport failures and HTTP 429
+     * (the fleet rate limiter is a deliberately tight shared token bucket).
+     * No other status is ever retried.
+     */
+    readonly maxRetries: 4;
+    /** Linear backoff base; attempt N waits roughly backoffBaseMs * N. */
+    readonly backoffBaseMs: 1000;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;AAEnD,kFAAkF;AAClF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAGjD,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,QAAQ;IACnB,2BAA2B;;IAE3B;;;;OAIG;;IAEH,sEAAsE;;CAE9D,CAAC"}

package/dist/config.js

@@ -0,0 +1,20 @@
+/** Base URLs per environment, taken verbatim from the validated golden client. */
+export const BASE_URLS = {
+    sandbox: "https://sandbox-api.doehpos.com",
+    production: "https://api.doehpos.com",
+};
+/** Default SDK version string surfaced in the (mandatory) User-Agent. */
+export const SDK_VERSION = "0.1.0";
+export const DEFAULTS = {
+    /** Per-request timeout. */
+    timeoutMs: 15_000,
+    /**
+     * Max retry attempts. Retries apply ONLY to transport failures and HTTP 429
+     * (the fleet rate limiter is a deliberately tight shared token bucket).
+     * No other status is ever retried.
+     */
+    maxRetries: 4,
+    /** Linear backoff base; attempt N waits roughly backoffBaseMs * N. */
+    backoffBaseMs: 1_000,
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO,EAAE,iCAAiC;IAC1C,UAAU,EAAE,yBAAyB;CACtC,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,2BAA2B;IAC3B,SAAS,EAAE,MAAM;IACjB;;;;OAIG;IACH,UAAU,EAAE,CAAC;IACb,sEAAsE;IACtE,aAAa,EAAE,KAAK;CACZ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,63 @@
+/** Base for everything thrown by the SDK. */
+export declare class DoehError extends Error {
+    constructor(message: string);
+}
+/**
+ * The request never produced an HTTP response (network down, DNS, TLS, timeout,
+ * aborted). These are the failures the SDK retries.
+ */
+export declare class DoehTransportError extends DoehError {
+    readonly cause?: unknown;
+    /** True if the failure was a timeout/abort. */
+    readonly timeout: boolean;
+    constructor(message: string, opts?: {
+        cause?: unknown;
+        timeout?: boolean;
+    });
+}
+/** Any non-2xx HTTP response, carrying the stable `code` and correlation ids. */
+export declare class DoehApiError extends DoehError {
+    readonly status: number;
+    readonly code: string;
+    readonly step?: string;
+    readonly traceId?: string;
+    readonly body: unknown;
+    constructor(status: number, code: string, opts?: {
+        step?: string;
+        traceId?: string;
+        body?: unknown;
+    });
+}
+export declare class ApiKeyInvalidError extends DoehApiError {
+}
+export declare class ApiKeyExpiredError extends DoehApiError {
+}
+export declare class ApiKeyRevokedError extends DoehApiError {
+}
+export declare class EnvMismatchError extends DoehApiError {
+}
+export declare class ScopeDeniedError extends DoehApiError {
+}
+export declare class TransportDisabledError extends DoehApiError {
+}
+export declare class OrderNotFoundError extends DoehApiError {
+}
+export declare class ReplayError extends DoehApiError {
+}
+export declare class InvalidAmountError extends DoehApiError {
+}
+export declare class UnsupportedCurrencyError extends DoehApiError {
+}
+export declare class BadBodyError extends DoehApiError {
+}
+export declare class RateLimitedError extends DoehApiError {
+}
+/** Build the right typed error from an HTTP status + parsed body. */
+export declare function mapApiError(status: number, body: unknown, traceId?: string): DoehApiError;
+/**
+ * The retry predicate, faithful to the golden client: retry ONLY transport
+ * failures and HTTP 429. Every other status (incl. 4xx validation and 5xx) is
+ * terminal and surfaces immediately.
+ */
+export declare function isRetryable(err: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +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"}

package/dist/errors.js

@@ -0,0 +1,96 @@
+/** Base for everything thrown by the SDK. */
+export class DoehError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+        // Restore prototype chain for transpiled-to-ES5 consumers.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * The request never produced an HTTP response (network down, DNS, TLS, timeout,
+ * aborted). These are the failures the SDK retries.
+ */
+export class DoehTransportError extends DoehError {
+    constructor(message, opts = {}) {
+        super(message);
+        this.cause = opts.cause;
+        this.timeout = opts.timeout ?? false;
+    }
+}
+/** Any non-2xx HTTP response, carrying the stable `code` and correlation ids. */
+export class DoehApiError extends DoehError {
+    constructor(status, code, opts = {}) {
+        super(`HTTP ${status} ${code}`);
+        this.status = status;
+        this.code = code;
+        this.step = opts.step;
+        this.traceId = opts.traceId;
+        this.body = opts.body;
+    }
+}
+// ── 401 — authentication (API_KEY_* ABI) ─────────────────────────────────────
+export class ApiKeyInvalidError extends DoehApiError {
+}
+export class ApiKeyExpiredError extends DoehApiError {
+}
+export class ApiKeyRevokedError extends DoehApiError {
+}
+export class EnvMismatchError extends DoehApiError {
+} // API_KEY_ENV_MISMATCH
+// ── 403 — authenticated but not permitted ────────────────────────────────────
+export class ScopeDeniedError extends DoehApiError {
+} // API_KEY_SCOPE_DENIED
+export class TransportDisabledError extends DoehApiError {
+} // EDGE_TRANSPORT_DISABLED
+// ── 404 / 409 / 422 / 400 ────────────────────────────────────────────────────
+export class OrderNotFoundError extends DoehApiError {
+} // EDGE_ORDER_NOT_FOUND
+export class ReplayError extends DoehApiError {
+} // EDGE_REPLAYED
+export class InvalidAmountError extends DoehApiError {
+} // EDGE_INVALID_AMOUNT
+export class UnsupportedCurrencyError extends DoehApiError {
+} // EDGE_UNSUPPORTED_CURRENCY
+export class BadBodyError extends DoehApiError {
+} // EDGE_BAD_BODY
+// ── 429 — rate limited (retried internally; only surfaced when retries exhaust)
+export class RateLimitedError extends DoehApiError {
+}
+/** Map a stable error code to its typed class. Unknown codes -> DoehApiError. */
+const CODE_TO_CLASS = {
+    API_KEY_INVALID: ApiKeyInvalidError,
+    API_KEY_EXPIRED: ApiKeyExpiredError,
+    API_KEY_REVOKED: ApiKeyRevokedError,
+    API_KEY_ENV_MISMATCH: EnvMismatchError,
+    API_KEY_SCOPE_DENIED: ScopeDeniedError,
+    EDGE_TRANSPORT_DISABLED: TransportDisabledError,
+    EDGE_ORDER_NOT_FOUND: OrderNotFoundError,
+    EDGE_REPLAYED: ReplayError,
+    EDGE_INVALID_AMOUNT: InvalidAmountError,
+    EDGE_UNSUPPORTED_CURRENCY: UnsupportedCurrencyError,
+    EDGE_BAD_BODY: BadBodyError,
+};
+/** Build the right typed error from an HTTP status + parsed body. */
+export function mapApiError(status, body, traceId) {
+    const envelope = (body ?? {});
+    const code = typeof envelope.code === "string" ? envelope.code : `HTTP_${status}`;
+    const opts = { step: envelope.step, traceId, body };
+    if (status === 429)
+        return new RateLimitedError(status, code, opts);
+    const Cls = CODE_TO_CLASS[code] ?? DoehApiError;
+    return new Cls(status, code, opts);
+}
+/**
+ * The retry predicate, faithful to the golden client: retry ONLY transport
+ * failures and HTTP 429. Every other status (incl. 4xx validation and 5xx) is
+ * terminal and surfaces immediately.
+ */
+export function isRetryable(err) {
+    if (err instanceof DoehTransportError)
+        return true;
+    if (err instanceof RateLimitedError)
+        return true;
+    return false;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/idempotency.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Idempotency keys.
+ *
+ * The single most important mobile invariant: a create's idempotency key is
+ * minted ONCE — when the mutation is first created — and reused on every
+ * attempt, across process restarts and network boundaries. Regenerating a key
+ * per attempt produces duplicate orders the instant a retry happens. The
+ * OfflineQueue enforces this; callers doing manual retries must do the same.
+ */
+/** A UUID source. Defaults to the platform crypto; injectable for RN/tests. */
+export type UuidFn = () => string;
+/**
+ * Generate an idempotency key. The optional prefix makes server logs readable
+ * (e.g. "delivery"). Stays within the 200-char header limit.
+ */
+export declare function generateIdempotencyKey(prefix?: string, uuid?: UuidFn): string;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;AAclC;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAqB,GAAG,MAAM,CAG3F"}

package/dist/idempotency.js

@@ -0,0 +1,30 @@
+/**
+ * Idempotency keys.
+ *
+ * The single most important mobile invariant: a create's idempotency key is
+ * minted ONCE — when the mutation is first created — and reused on every
+ * attempt, across process restarts and network boundaries. Regenerating a key
+ * per attempt produces duplicate orders the instant a retry happens. The
+ * OfflineQueue enforces this; callers doing manual retries must do the same.
+ */
+function platformUuid() {
+    const c = globalThis.crypto;
+    if (c?.randomUUID)
+        return c.randomUUID();
+    // Last-resort fallback (e.g. older RN without a crypto polyfill). Not
+    // cryptographically strong, but collision-safe enough for an idempotency key.
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (ch) => {
+        const r = (Math.random() * 16) | 0;
+        const v = ch === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Generate an idempotency key. The optional prefix makes server logs readable
+ * (e.g. "delivery"). Stays within the 200-char header limit.
+ */
+export function generateIdempotencyKey(prefix, uuid = platformUuid) {
+    const id = uuid();
+    return prefix ? `${prefix}-${id}` : id;
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,SAAS,YAAY;IACnB,MAAM,CAAC,GAAI,UAAyD,CAAC,MAAM,CAAC;IAC5E,IAAI,CAAC,EAAE,UAAU;QAAE,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;IACzC,sEAAsE;IACtE,8EAA8E;IAC9E,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE;QACpE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC3C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAe,EAAE,OAAe,YAAY;IACjF,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +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/loyalty/marketplace/rider are @experimental until exercised by the
+ * reference app.
+ */
+export { DoehClient } from "./client.js";
+export type { DoehClientOptions } from "./client.js";
+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 { DeliveryModule } from "./modules/delivery.js";
+export { KitchenModule, type TicketCreate, type TicketResponse } from "./modules/experimental/kitchen.js";
+export { LoyaltyModule, type EarnInput, type AccountResponse } from "./modules/experimental/loyalty.js";
+export { MarketplaceModule, type ListingCreate, type ListingResponse, } from "./modules/experimental/marketplace.js";
+export { RiderModule, type JobCreate, type JobResponse } from "./modules/experimental/rider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,mCAAmC,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACxG,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"}

package/dist/index.js

@@ -0,0 +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/loyalty/marketplace/rider are @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";
+// Module classes + their types (handy for typing app code).
+export { DeliveryModule } from "./modules/delivery.js";
+export { KitchenModule } from "./modules/experimental/kitchen.js";
+export { LoyaltyModule } from "./modules/experimental/loyalty.js";
+export { MarketplaceModule, } from "./modules/experimental/marketplace.js";
+export { RiderModule } from "./modules/experimental/rider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,mCAAmC,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAwC,MAAM,mCAAmC,CAAC;AACxG,OAAO,EACL,iBAAiB,GAGlB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAoC,MAAM,iCAAiC,CAAC"}

package/dist/modules/delivery.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Delivery — the stable, reference-app-exercised vertical.
+ *
+ *   POST /v1/delivery/orders        create (idempotent with an Idempotency-Key)
+ *   GET  /v1/delivery/orders/{id}   read back
+ *
+ * Scope is derived from the key server-side; there is no shop/branch argument.
+ */
+import type { Transport } from "../transport.js";
+import type { CallOptions, OrderCreate, OrderResponse } from "../types.js";
+export declare class DeliveryModule {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Create a delivery order. Returns 201 on first write, or 200 with
+     * `idempotent: true` when an Idempotency-Key replays an existing order.
+     *
+     * If you do not pass `idempotencyKey`, the SDK mints one for THIS call only —
+     * which is not retry-safe across a process restart. For offline-safe creates,
+     * mint and persist the key yourself (or use OfflineQueue).
+     */
+    create(input: OrderCreate, opts?: CallOptions): Promise<OrderResponse>;
+    /** Read a delivery order by id. */
+    get(id: string, opts?: CallOptions): Promise<OrderResponse>;
+}
+//# sourceMappingURL=delivery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/modules/delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM3E,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBhF,mCAAmC;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CAYtE"}