@stardeck-customer-apps/testing 0.24.0 → 0.25.1

package/SKILL.md

@@ -565,7 +565,11 @@ cursor, limit })`; `list()` intentionally keeps its previous array shape.
   in `app.storage` against the simulated `STORAGE_URL` host.
 - `client.slack` / `client.line` / `client.facebook` send endpoints — captured
   in `app.messages`.
-- `createEdgeClient()` (print, pair/unpair, list devices/peripherals, show/clear
+- `createEdgeClient()` (print, `enqueueReceipt()`/`getPrintJob()` durable receipts: idempotent per key,
+  conflicts and refused options mirrored, `app.edge.durablePrints`, and
+  `app.edge.settleNextDurableJob({ status: "needs_attention", reason, outcome })` to drive the
+  uncertain/not-printed UI, or `{ status: "sent_to_printer", simulated: true }` to mirror a
+  virtual-printer job (the status then carries `simulated: true`); pair/unpair, list devices/peripherals, show/clear
   display, test print, `getCapabilities()`) — captured in `app.edge`; seed
   devices/peripherals for pairing pickers via `app.edge.seedDevices()` /
   `seedPeripherals()`.

package/dist/index.d.mts

@@ -542,6 +542,29 @@ interface CapturedPrint {
     logo?: boolean;
     copies: number;
 }
+/** One `edge.enqueueReceipt()` the app made, as the simulator accepted it. */
+interface CapturedDurablePrint {
+    jobId: string;
+    idempotencyKey: string;
+    alias?: string;
+    deviceId?: string;
+    peripheralId?: string;
+    receipt: ReceiptPayload;
+    logo?: boolean;
+}
+/** How a simulated durable job settles. Mirrors the platform's status contract. */
+type SimulatedDurableOutcome = {
+    status: "sent_to_printer";
+    simulated?: boolean;
+} | {
+    status: "queued";
+    simulated?: boolean;
+} | {
+    status: "needs_attention";
+    reason: string;
+    outcome: "not_printed" | "uncertain";
+    message?: string;
+};
 interface CapturedDisplay {
     action: "show" | "clear";
     alias?: string;
@@ -557,6 +580,15 @@ interface TestEdge {
     get prints(): CapturedPrint[];
     get displays(): CapturedDisplay[];
     get testPrints(): CapturedTestPrint[];
+    /** Durable receipts accepted by `edge.enqueueReceipt()` (one per distinct idempotency key). */
+    get durablePrints(): CapturedDurablePrint[];
+    /**
+     * Decide how the NEXT accepted durable job settles when the app reads it with
+     * `edge.getPrintJob()`. Without this every job reads `sent_to_printer`. Queue
+     * several to model a run of jobs; use `needs_attention` with `uncertain` to
+     * test the "check the printer before reprinting" path.
+     */
+    settleNextDurableJob(outcome: SimulatedDurableOutcome): void;
     latestPrint(): CapturedPrint | undefined;
     latestDisplay(): CapturedDisplay | undefined;
     get bindings(): BindingInfo[];
@@ -742,4 +774,4 @@ declare const TEST_ENV_DEFAULTS: {
 /** Default location of the DDL snapshot written by `generate-types`. */
 declare const DEFAULT_SCHEMA_PATH = "./src/generated/data-store-schema.sql";
 
-export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedStarlensCall, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PaymentSimulatorFailure, type PaymentSimulatorOperation, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, type StarlensReply, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStarlens, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };
+export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedDurablePrint, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedStarlensCall, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PaymentSimulatorFailure, type PaymentSimulatorOperation, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, type SimulatedDurableOutcome, type StarlensReply, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStarlens, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.d.ts

@@ -542,6 +542,29 @@ interface CapturedPrint {
     logo?: boolean;
     copies: number;
 }
+/** One `edge.enqueueReceipt()` the app made, as the simulator accepted it. */
+interface CapturedDurablePrint {
+    jobId: string;
+    idempotencyKey: string;
+    alias?: string;
+    deviceId?: string;
+    peripheralId?: string;
+    receipt: ReceiptPayload;
+    logo?: boolean;
+}
+/** How a simulated durable job settles. Mirrors the platform's status contract. */
+type SimulatedDurableOutcome = {
+    status: "sent_to_printer";
+    simulated?: boolean;
+} | {
+    status: "queued";
+    simulated?: boolean;
+} | {
+    status: "needs_attention";
+    reason: string;
+    outcome: "not_printed" | "uncertain";
+    message?: string;
+};
 interface CapturedDisplay {
     action: "show" | "clear";
     alias?: string;
@@ -557,6 +580,15 @@ interface TestEdge {
     get prints(): CapturedPrint[];
     get displays(): CapturedDisplay[];
     get testPrints(): CapturedTestPrint[];
+    /** Durable receipts accepted by `edge.enqueueReceipt()` (one per distinct idempotency key). */
+    get durablePrints(): CapturedDurablePrint[];
+    /**
+     * Decide how the NEXT accepted durable job settles when the app reads it with
+     * `edge.getPrintJob()`. Without this every job reads `sent_to_printer`. Queue
+     * several to model a run of jobs; use `needs_attention` with `uncertain` to
+     * test the "check the printer before reprinting" path.
+     */
+    settleNextDurableJob(outcome: SimulatedDurableOutcome): void;
     latestPrint(): CapturedPrint | undefined;
     latestDisplay(): CapturedDisplay | undefined;
     get bindings(): BindingInfo[];
@@ -742,4 +774,4 @@ declare const TEST_ENV_DEFAULTS: {
 /** Default location of the DDL snapshot written by `generate-types`. */
 declare const DEFAULT_SCHEMA_PATH = "./src/generated/data-store-schema.sql";
 
-export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedStarlensCall, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PaymentSimulatorFailure, type PaymentSimulatorOperation, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, type StarlensReply, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStarlens, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };
+export { type BindingInfo, CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedDisplay, type CapturedDurablePrint, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedStarlensCall, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DATA_STORE_TEST_URL, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PaymentSimulatorFailure, type PaymentSimulatorOperation, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, type SimBoltCharge, type SimBoltConnection, type SimBoltIntentRecord, type SimBoltIntentStatus, type SimulatedDurableOutcome, type StarlensReply, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, TestDataStoreInput, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStarlens, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.js

@@ -365,6 +365,8 @@ var state = globalSingleton("state", () => ({
   edgeDisplays: [],
   edgeTestPrints: [],
   edgePrintCounter: 0,
+  edgeDurableJobs: /* @__PURE__ */ new Map(),
+  edgeDurableOutcomes: [],
   edgeDevices: [],
   edgePeripherals: [],
   edgeBindings: /* @__PURE__ */ new Map(),
@@ -3382,6 +3384,95 @@ async function handlePrint(request) {
     status: "completed"
   });
 }
+var IDEMPOTENCY_KEY = /^[A-Za-z0-9_.:-]{1,128}$/;
+async function handleEnqueue(request) {
+  const body = await readJsonBody(request);
+  const key = typeof body.idempotencyKey === "string" ? body.idempotencyKey : "";
+  if (!IDEMPOTENCY_KEY.test(key)) {
+    return edgeFailure("idempotencyKey must be 1-128 characters of A-Z a-z 0-9 _ . : -");
+  }
+  if (body.openDrawer === true) {
+    return edgeFailure("Durable receipts cannot open the cash drawer; a retry would kick it again");
+  }
+  if (body.copies !== void 0 && body.copies !== 1) {
+    return edgeFailure(
+      "Durable receipts print exactly one copy; submit a second job for another copy"
+    );
+  }
+  const receipt = body.receipt ?? {};
+  if (receipt.rawEscPos !== void 0) {
+    return edgeFailure("rawEscPos is not supported for durable receipts");
+  }
+  const requestHash = JSON.stringify([
+    body.alias,
+    body.deviceId,
+    body.peripheralId,
+    receipt,
+    body.logo
+  ]);
+  const existing = [...state.edgeDurableJobs.values()].find(
+    (j) => j.captured.idempotencyKey === key
+  );
+  if (existing) {
+    if (existing.requestHash !== requestHash) {
+      return edgeFailure(
+        "This idempotencyKey was already used for a different receipt, target or options.",
+        409,
+        "IDEMPOTENCY_KEY_CONFLICT"
+      );
+    }
+    return json({ success: true, data: durableView(existing.captured.jobId, "queued") }, 200);
+  }
+  const jobId = nextJobId();
+  const captured = {
+    jobId,
+    idempotencyKey: key,
+    alias: body.alias ? String(body.alias) : void 0,
+    deviceId: body.deviceId ? String(body.deviceId) : void 0,
+    peripheralId: body.peripheralId ? String(body.peripheralId) : void 0,
+    receipt,
+    logo: body.logo === true ? true : body.logo === false ? false : void 0
+  };
+  const outcome = state.edgeDurableOutcomes.shift() ?? { status: "sent_to_printer" };
+  state.edgeDurableJobs.set(jobId, { requestHash, captured, outcome });
+  return json({ success: true, data: durableView(jobId, "queued") }, 202);
+}
+function durableView(jobId, as) {
+  const job = state.edgeDurableJobs.get(jobId);
+  const createdAt = now2();
+  const simulated = job.outcome.status !== "needs_attention" && job.outcome.simulated ? { simulated: true } : {};
+  const base = {
+    ...simulated,
+    jobId,
+    attempts: as === "queued" ? 0 : 1,
+    createdAt,
+    expiresAt: new Date(Date.parse(createdAt) + 10 * 6e4).toISOString(),
+    target: {
+      deviceId: job.captured.deviceId ?? "sim-device",
+      peripheralId: job.captured.peripheralId ?? "sim-peripheral"
+    }
+  };
+  const outcome = as === "queued" ? { status: "queued" } : job.outcome;
+  if (outcome.status === "needs_attention") {
+    return {
+      ...base,
+      status: "needs_attention",
+      attention: {
+        reason: outcome.reason,
+        outcome: outcome.outcome,
+        message: outcome.message ?? "Delivery stopped."
+      }
+    };
+  }
+  if (outcome.status === "sent_to_printer") {
+    return { ...base, status: "sent_to_printer", sentToPrinterAt: createdAt };
+  }
+  return { ...base, status: "queued" };
+}
+function handleGetDurable(jobId) {
+  if (!state.edgeDurableJobs.has(jobId)) return edgeFailure("Print job not found", 404);
+  return success(durableView(jobId));
+}
 async function handleShowDisplay(request) {
   const body = await readJsonBody(request);
   const captured = {
@@ -3431,6 +3522,13 @@ async function handleEdgeRequest(request, subPath) {
   if (subPath === "/print" && method === "POST") {
     return handlePrint(request);
   }
+  if (subPath === "/print-jobs" && method === "POST") {
+    return handleEnqueue(request);
+  }
+  const durableMatch = subPath.match(/^\/print-jobs\/([^/]+)$/);
+  if (durableMatch && method === "GET") {
+    return handleGetDurable(decodeURIComponent(durableMatch[1]));
+  }
   if (subPath === "/capabilities" && method === "GET") {
     return handleCapabilities(request);
   }
@@ -3474,6 +3572,12 @@ function createEdge() {
     get testPrints() {
       return [...state.edgeTestPrints];
     },
+    get durablePrints() {
+      return [...state.edgeDurableJobs.values()].map((j) => j.captured);
+    },
+    settleNextDurableJob(outcome) {
+      state.edgeDurableOutcomes.push(outcome);
+    },
     latestPrint() {
       return state.edgePrints[state.edgePrints.length - 1];
     },
@@ -3510,12 +3614,14 @@ function createEdge() {
       state.edgeDisplays = [];
       state.edgeTestPrints = [];
       state.edgePrintCounter = 0;
+      state.edgeDurableJobs.clear();
+      state.edgeDurableOutcomes = [];
       state.edgeDevices = [];
       state.edgePeripherals = [];
       state.edgeBindings.clear();
     },
     get count() {
-      return state.edgePrints.length + state.edgeDisplays.length + state.edgeTestPrints.length;
+      return state.edgePrints.length + state.edgeDisplays.length + state.edgeTestPrints.length + state.edgeDurableJobs.size;
     }
   };
 }

package/dist/index.mjs

@@ -326,6 +326,8 @@ var state = globalSingleton("state", () => ({
   edgeDisplays: [],
   edgeTestPrints: [],
   edgePrintCounter: 0,
+  edgeDurableJobs: /* @__PURE__ */ new Map(),
+  edgeDurableOutcomes: [],
   edgeDevices: [],
   edgePeripherals: [],
   edgeBindings: /* @__PURE__ */ new Map(),
@@ -3343,6 +3345,95 @@ async function handlePrint(request) {
     status: "completed"
   });
 }
+var IDEMPOTENCY_KEY = /^[A-Za-z0-9_.:-]{1,128}$/;
+async function handleEnqueue(request) {
+  const body = await readJsonBody(request);
+  const key = typeof body.idempotencyKey === "string" ? body.idempotencyKey : "";
+  if (!IDEMPOTENCY_KEY.test(key)) {
+    return edgeFailure("idempotencyKey must be 1-128 characters of A-Z a-z 0-9 _ . : -");
+  }
+  if (body.openDrawer === true) {
+    return edgeFailure("Durable receipts cannot open the cash drawer; a retry would kick it again");
+  }
+  if (body.copies !== void 0 && body.copies !== 1) {
+    return edgeFailure(
+      "Durable receipts print exactly one copy; submit a second job for another copy"
+    );
+  }
+  const receipt = body.receipt ?? {};
+  if (receipt.rawEscPos !== void 0) {
+    return edgeFailure("rawEscPos is not supported for durable receipts");
+  }
+  const requestHash = JSON.stringify([
+    body.alias,
+    body.deviceId,
+    body.peripheralId,
+    receipt,
+    body.logo
+  ]);
+  const existing = [...state.edgeDurableJobs.values()].find(
+    (j) => j.captured.idempotencyKey === key
+  );
+  if (existing) {
+    if (existing.requestHash !== requestHash) {
+      return edgeFailure(
+        "This idempotencyKey was already used for a different receipt, target or options.",
+        409,
+        "IDEMPOTENCY_KEY_CONFLICT"
+      );
+    }
+    return json({ success: true, data: durableView(existing.captured.jobId, "queued") }, 200);
+  }
+  const jobId = nextJobId();
+  const captured = {
+    jobId,
+    idempotencyKey: key,
+    alias: body.alias ? String(body.alias) : void 0,
+    deviceId: body.deviceId ? String(body.deviceId) : void 0,
+    peripheralId: body.peripheralId ? String(body.peripheralId) : void 0,
+    receipt,
+    logo: body.logo === true ? true : body.logo === false ? false : void 0
+  };
+  const outcome = state.edgeDurableOutcomes.shift() ?? { status: "sent_to_printer" };
+  state.edgeDurableJobs.set(jobId, { requestHash, captured, outcome });
+  return json({ success: true, data: durableView(jobId, "queued") }, 202);
+}
+function durableView(jobId, as) {
+  const job = state.edgeDurableJobs.get(jobId);
+  const createdAt = now2();
+  const simulated = job.outcome.status !== "needs_attention" && job.outcome.simulated ? { simulated: true } : {};
+  const base = {
+    ...simulated,
+    jobId,
+    attempts: as === "queued" ? 0 : 1,
+    createdAt,
+    expiresAt: new Date(Date.parse(createdAt) + 10 * 6e4).toISOString(),
+    target: {
+      deviceId: job.captured.deviceId ?? "sim-device",
+      peripheralId: job.captured.peripheralId ?? "sim-peripheral"
+    }
+  };
+  const outcome = as === "queued" ? { status: "queued" } : job.outcome;
+  if (outcome.status === "needs_attention") {
+    return {
+      ...base,
+      status: "needs_attention",
+      attention: {
+        reason: outcome.reason,
+        outcome: outcome.outcome,
+        message: outcome.message ?? "Delivery stopped."
+      }
+    };
+  }
+  if (outcome.status === "sent_to_printer") {
+    return { ...base, status: "sent_to_printer", sentToPrinterAt: createdAt };
+  }
+  return { ...base, status: "queued" };
+}
+function handleGetDurable(jobId) {
+  if (!state.edgeDurableJobs.has(jobId)) return edgeFailure("Print job not found", 404);
+  return success(durableView(jobId));
+}
 async function handleShowDisplay(request) {
   const body = await readJsonBody(request);
   const captured = {
@@ -3392,6 +3483,13 @@ async function handleEdgeRequest(request, subPath) {
   if (subPath === "/print" && method === "POST") {
     return handlePrint(request);
   }
+  if (subPath === "/print-jobs" && method === "POST") {
+    return handleEnqueue(request);
+  }
+  const durableMatch = subPath.match(/^\/print-jobs\/([^/]+)$/);
+  if (durableMatch && method === "GET") {
+    return handleGetDurable(decodeURIComponent(durableMatch[1]));
+  }
   if (subPath === "/capabilities" && method === "GET") {
     return handleCapabilities(request);
   }
@@ -3435,6 +3533,12 @@ function createEdge() {
     get testPrints() {
       return [...state.edgeTestPrints];
     },
+    get durablePrints() {
+      return [...state.edgeDurableJobs.values()].map((j) => j.captured);
+    },
+    settleNextDurableJob(outcome) {
+      state.edgeDurableOutcomes.push(outcome);
+    },
     latestPrint() {
       return state.edgePrints[state.edgePrints.length - 1];
     },
@@ -3471,12 +3575,14 @@ function createEdge() {
       state.edgeDisplays = [];
       state.edgeTestPrints = [];
       state.edgePrintCounter = 0;
+      state.edgeDurableJobs.clear();
+      state.edgeDurableOutcomes = [];
       state.edgeDevices = [];
       state.edgePeripherals = [];
       state.edgeBindings.clear();
     },
     get count() {
-      return state.edgePrints.length + state.edgeDisplays.length + state.edgeTestPrints.length;
+      return state.edgePrints.length + state.edgeDisplays.length + state.edgeTestPrints.length + state.edgeDurableJobs.size;
     }
   };
 }

package/dist/next/headers-shim.js

@@ -87,6 +87,8 @@ var state = globalSingleton("state", () => ({
   edgeDisplays: [],
   edgeTestPrints: [],
   edgePrintCounter: 0,
+  edgeDurableJobs: /* @__PURE__ */ new Map(),
+  edgeDurableOutcomes: [],
   edgeDevices: [],
   edgePeripherals: [],
   edgeBindings: /* @__PURE__ */ new Map(),

package/dist/next/headers-shim.mjs

@@ -60,6 +60,8 @@ var state = globalSingleton("state", () => ({
   edgeDisplays: [],
   edgeTestPrints: [],
   edgePrintCounter: 0,
+  edgeDurableJobs: /* @__PURE__ */ new Map(),
+  edgeDurableOutcomes: [],
   edgeDevices: [],
   edgePeripherals: [],
   edgeBindings: /* @__PURE__ */ new Map(),

package/dist/setup.js

@@ -92,6 +92,8 @@ var state = globalSingleton("state", () => ({
   edgeDisplays: [],
   edgeTestPrints: [],
   edgePrintCounter: 0,
+  edgeDurableJobs: /* @__PURE__ */ new Map(),
+  edgeDurableOutcomes: [],
   edgeDevices: [],
   edgePeripherals: [],
   edgeBindings: /* @__PURE__ */ new Map(),
@@ -2527,6 +2529,95 @@ async function handlePrint(request) {
     status: "completed"
   });
 }
+var IDEMPOTENCY_KEY = /^[A-Za-z0-9_.:-]{1,128}$/;
+async function handleEnqueue(request) {
+  const body = await readJsonBody(request);
+  const key = typeof body.idempotencyKey === "string" ? body.idempotencyKey : "";
+  if (!IDEMPOTENCY_KEY.test(key)) {
+    return edgeFailure("idempotencyKey must be 1-128 characters of A-Z a-z 0-9 _ . : -");
+  }
+  if (body.openDrawer === true) {
+    return edgeFailure("Durable receipts cannot open the cash drawer; a retry would kick it again");
+  }
+  if (body.copies !== void 0 && body.copies !== 1) {
+    return edgeFailure(
+      "Durable receipts print exactly one copy; submit a second job for another copy"
+    );
+  }
+  const receipt = body.receipt ?? {};
+  if (receipt.rawEscPos !== void 0) {
+    return edgeFailure("rawEscPos is not supported for durable receipts");
+  }
+  const requestHash = JSON.stringify([
+    body.alias,
+    body.deviceId,
+    body.peripheralId,
+    receipt,
+    body.logo
+  ]);
+  const existing = [...state.edgeDurableJobs.values()].find(
+    (j) => j.captured.idempotencyKey === key
+  );
+  if (existing) {
+    if (existing.requestHash !== requestHash) {
+      return edgeFailure(
+        "This idempotencyKey was already used for a different receipt, target or options.",
+        409,
+        "IDEMPOTENCY_KEY_CONFLICT"
+      );
+    }
+    return json({ success: true, data: durableView(existing.captured.jobId, "queued") }, 200);
+  }
+  const jobId = nextJobId();
+  const captured = {
+    jobId,
+    idempotencyKey: key,
+    alias: body.alias ? String(body.alias) : void 0,
+    deviceId: body.deviceId ? String(body.deviceId) : void 0,
+    peripheralId: body.peripheralId ? String(body.peripheralId) : void 0,
+    receipt,
+    logo: body.logo === true ? true : body.logo === false ? false : void 0
+  };
+  const outcome = state.edgeDurableOutcomes.shift() ?? { status: "sent_to_printer" };
+  state.edgeDurableJobs.set(jobId, { requestHash, captured, outcome });
+  return json({ success: true, data: durableView(jobId, "queued") }, 202);
+}
+function durableView(jobId, as) {
+  const job = state.edgeDurableJobs.get(jobId);
+  const createdAt = now2();
+  const simulated = job.outcome.status !== "needs_attention" && job.outcome.simulated ? { simulated: true } : {};
+  const base = {
+    ...simulated,
+    jobId,
+    attempts: as === "queued" ? 0 : 1,
+    createdAt,
+    expiresAt: new Date(Date.parse(createdAt) + 10 * 6e4).toISOString(),
+    target: {
+      deviceId: job.captured.deviceId ?? "sim-device",
+      peripheralId: job.captured.peripheralId ?? "sim-peripheral"
+    }
+  };
+  const outcome = as === "queued" ? { status: "queued" } : job.outcome;
+  if (outcome.status === "needs_attention") {
+    return {
+      ...base,
+      status: "needs_attention",
+      attention: {
+        reason: outcome.reason,
+        outcome: outcome.outcome,
+        message: outcome.message ?? "Delivery stopped."
+      }
+    };
+  }
+  if (outcome.status === "sent_to_printer") {
+    return { ...base, status: "sent_to_printer", sentToPrinterAt: createdAt };
+  }
+  return { ...base, status: "queued" };
+}
+function handleGetDurable(jobId) {
+  if (!state.edgeDurableJobs.has(jobId)) return edgeFailure("Print job not found", 404);
+  return success(durableView(jobId));
+}
 async function handleShowDisplay(request) {
   const body = await readJsonBody(request);
   const captured = {
@@ -2576,6 +2667,13 @@ async function handleEdgeRequest(request, subPath) {
   if (subPath === "/print" && method === "POST") {
     return handlePrint(request);
   }
+  if (subPath === "/print-jobs" && method === "POST") {
+    return handleEnqueue(request);
+  }
+  const durableMatch = subPath.match(/^\/print-jobs\/([^/]+)$/);
+  if (durableMatch && method === "GET") {
+    return handleGetDurable(decodeURIComponent(durableMatch[1]));
+  }
   if (subPath === "/capabilities" && method === "GET") {
     return handleCapabilities(request);
   }

package/dist/setup.mjs

@@ -68,6 +68,8 @@ var state = globalSingleton("state", () => ({
   edgeDisplays: [],
   edgeTestPrints: [],
   edgePrintCounter: 0,
+  edgeDurableJobs: /* @__PURE__ */ new Map(),
+  edgeDurableOutcomes: [],
   edgeDevices: [],
   edgePeripherals: [],
   edgeBindings: /* @__PURE__ */ new Map(),
@@ -2503,6 +2505,95 @@ async function handlePrint(request) {
     status: "completed"
   });
 }
+var IDEMPOTENCY_KEY = /^[A-Za-z0-9_.:-]{1,128}$/;
+async function handleEnqueue(request) {
+  const body = await readJsonBody(request);
+  const key = typeof body.idempotencyKey === "string" ? body.idempotencyKey : "";
+  if (!IDEMPOTENCY_KEY.test(key)) {
+    return edgeFailure("idempotencyKey must be 1-128 characters of A-Z a-z 0-9 _ . : -");
+  }
+  if (body.openDrawer === true) {
+    return edgeFailure("Durable receipts cannot open the cash drawer; a retry would kick it again");
+  }
+  if (body.copies !== void 0 && body.copies !== 1) {
+    return edgeFailure(
+      "Durable receipts print exactly one copy; submit a second job for another copy"
+    );
+  }
+  const receipt = body.receipt ?? {};
+  if (receipt.rawEscPos !== void 0) {
+    return edgeFailure("rawEscPos is not supported for durable receipts");
+  }
+  const requestHash = JSON.stringify([
+    body.alias,
+    body.deviceId,
+    body.peripheralId,
+    receipt,
+    body.logo
+  ]);
+  const existing = [...state.edgeDurableJobs.values()].find(
+    (j) => j.captured.idempotencyKey === key
+  );
+  if (existing) {
+    if (existing.requestHash !== requestHash) {
+      return edgeFailure(
+        "This idempotencyKey was already used for a different receipt, target or options.",
+        409,
+        "IDEMPOTENCY_KEY_CONFLICT"
+      );
+    }
+    return json({ success: true, data: durableView(existing.captured.jobId, "queued") }, 200);
+  }
+  const jobId = nextJobId();
+  const captured = {
+    jobId,
+    idempotencyKey: key,
+    alias: body.alias ? String(body.alias) : void 0,
+    deviceId: body.deviceId ? String(body.deviceId) : void 0,
+    peripheralId: body.peripheralId ? String(body.peripheralId) : void 0,
+    receipt,
+    logo: body.logo === true ? true : body.logo === false ? false : void 0
+  };
+  const outcome = state.edgeDurableOutcomes.shift() ?? { status: "sent_to_printer" };
+  state.edgeDurableJobs.set(jobId, { requestHash, captured, outcome });
+  return json({ success: true, data: durableView(jobId, "queued") }, 202);
+}
+function durableView(jobId, as) {
+  const job = state.edgeDurableJobs.get(jobId);
+  const createdAt = now2();
+  const simulated = job.outcome.status !== "needs_attention" && job.outcome.simulated ? { simulated: true } : {};
+  const base = {
+    ...simulated,
+    jobId,
+    attempts: as === "queued" ? 0 : 1,
+    createdAt,
+    expiresAt: new Date(Date.parse(createdAt) + 10 * 6e4).toISOString(),
+    target: {
+      deviceId: job.captured.deviceId ?? "sim-device",
+      peripheralId: job.captured.peripheralId ?? "sim-peripheral"
+    }
+  };
+  const outcome = as === "queued" ? { status: "queued" } : job.outcome;
+  if (outcome.status === "needs_attention") {
+    return {
+      ...base,
+      status: "needs_attention",
+      attention: {
+        reason: outcome.reason,
+        outcome: outcome.outcome,
+        message: outcome.message ?? "Delivery stopped."
+      }
+    };
+  }
+  if (outcome.status === "sent_to_printer") {
+    return { ...base, status: "sent_to_printer", sentToPrinterAt: createdAt };
+  }
+  return { ...base, status: "queued" };
+}
+function handleGetDurable(jobId) {
+  if (!state.edgeDurableJobs.has(jobId)) return edgeFailure("Print job not found", 404);
+  return success(durableView(jobId));
+}
 async function handleShowDisplay(request) {
   const body = await readJsonBody(request);
   const captured = {
@@ -2552,6 +2643,13 @@ async function handleEdgeRequest(request, subPath) {
   if (subPath === "/print" && method === "POST") {
     return handlePrint(request);
   }
+  if (subPath === "/print-jobs" && method === "POST") {
+    return handleEnqueue(request);
+  }
+  const durableMatch = subPath.match(/^\/print-jobs\/([^/]+)$/);
+  if (durableMatch && method === "GET") {
+    return handleGetDurable(decodeURIComponent(durableMatch[1]));
+  }
   if (subPath === "/capabilities" && method === "GET") {
     return handleCapabilities(request);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/testing",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "description": "Vitest test harness for Stardeck customer apps — in-process Postgres (PGlite) plus a control-plane simulator so the real Stardeck SDKs run unmodified in tests",
   "main": "dist/index.js",
   "module": "dist/index.mjs",