@stardeck-customer-apps/testing 0.4.0 → 0.5.0

package/SKILL.md

@@ -101,6 +101,15 @@ expect(app.storage.latest()?.filename).toBe("note.txt");
 const integrations = createIntegrationsClient();
 await integrations.line.push("U123", { type: "text", text: "Your order shipped" });
 expect(app.messages.channel("line").to("U123")[0].body.text).toMatch(/shipped/i);
+
+// Receipt print + display
+import { createEdgeClient } from "@stardeck-customer-apps/edge-sdk/server";
+
+const edge = createEdgeClient();
+await edge.print({ receipt: { total: 42 }, alias: "station-1", openDrawer: true });
+expect(app.edge.latestPrint()?.receipt.total).toBe(42);
+await edge.showDisplay({ alias: "customer-screen", url: "https://app.example.com/kiosk" });
+expect(app.edge.latestDisplay()?.action).toBe("show");
 ```
 
 ## API
@@ -131,6 +140,9 @@ expect(app.messages.channel("line").to("U123")[0].body.text).toMatch(/shipped/i)
 - `app.storage` — uploads through storage-sdk: `.uploads`, `.latest()`, `.count`, `.clear()`.
 - `app.messages` — outbound Slack/LINE/Facebook sends:
   `.all()`, `.latest()`, `.to(recipient)`, `.channel("line")`, `.count`, `.clear()`.
+- `app.edge` — edge print/display/bindings from edge-sdk: `.prints`, `.displays`,
+  `.testPrints`, `.latestPrint()`, `.latestDisplay()`, `.bindings`,
+  `.seedDevices()`, `.seedPeripherals()`, `.seedBindings()`, `.count`, `.clear()`.
 - `app.query(sql, params?)` / `app.db` — direct database access for
   assertions and seeding.
 - `callRoute(handler, opts)` — invoke an App Router route handler with a real
@@ -161,6 +173,9 @@ expect(app.messages.channel("line").to("U123")[0].body.text).toMatch(/shipped/i)
   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
+  display, test print) — captured in `app.edge`; seed devices/peripherals for
+  pairing pickers via `app.edge.seedDevices()` / `seedPeripherals()`.
 - `next/headers` (`headers()`/`cookies()`) inside handlers under `callRoute`.
 
 ## Rules

package/dist/index.d.mts

@@ -184,6 +184,106 @@ interface TestMessages {
     clear(): void;
     get count(): number;
 }
+interface ReceiptPayload {
+    header?: {
+        lines: string[];
+    };
+    items?: Array<{
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        total: number;
+        note?: string;
+    }>;
+    subtotal?: number;
+    tax?: number;
+    discount?: number;
+    total?: number;
+    payments?: Array<{
+        method: string;
+        amount: number;
+    }>;
+    footer?: {
+        lines: string[];
+    };
+    barcode?: {
+        type: "qr" | "code128";
+        data: string;
+    };
+    rawEscPos?: string;
+}
+interface DeviceInfo {
+    id: string;
+    displayName: string;
+    status: "pairing_pending" | "online" | "offline" | "decommissioned";
+    isDefault: boolean;
+    lastHeartbeatAt: string | null;
+}
+interface PeripheralInfo {
+    id: string;
+    displayName: string | null;
+    driver: string | null;
+    transport: "usb_lp" | "serial" | "tcp" | "usb_raw" | "display";
+    connected: boolean;
+    lastSeenAt: string | null;
+    device: {
+        id: string;
+        displayName: string;
+        status: DeviceInfo["status"];
+    };
+}
+type BindingState = "ok" | "peripheral_missing" | "grant_revoked";
+interface BindingInfo {
+    alias: string;
+    state: BindingState;
+    peripheral: {
+        id: string;
+        displayName: string | null;
+        driver: string | null;
+        connected: boolean;
+    } | null;
+    device: {
+        id: string;
+        displayName: string;
+        status: DeviceInfo["status"];
+    } | null;
+    updatedAt: string;
+}
+interface CapturedPrint {
+    jobId: string;
+    deploymentId: string;
+    alias?: string;
+    deviceId?: string;
+    peripheralId?: string;
+    receipt: ReceiptPayload;
+    openDrawer: boolean;
+    logo?: boolean;
+    copies: number;
+}
+interface CapturedDisplay {
+    action: "show" | "clear";
+    alias?: string;
+    peripheralId?: string;
+    url?: string;
+}
+interface CapturedTestPrint {
+    alias?: string;
+    deviceId?: string;
+    peripheralId?: string;
+}
+interface TestEdge {
+    get prints(): CapturedPrint[];
+    get displays(): CapturedDisplay[];
+    get testPrints(): CapturedTestPrint[];
+    latestPrint(): CapturedPrint | undefined;
+    latestDisplay(): CapturedDisplay | undefined;
+    get bindings(): BindingInfo[];
+    seedDevices(devices: DeviceInfo[]): void;
+    seedPeripherals(peripherals: PeripheralInfo[]): void;
+    seedBindings(bindings: BindingInfo[]): void;
+    clear(): void;
+    get count(): number;
+}
 interface TestAppOptions {
     /**
      * Path to the schema.sql snapshot generated by
@@ -219,6 +319,8 @@ interface TestApp {
     storage: TestStorage;
     /** Captured outbound messages from integrations-sdk messaging channels. */
     messages: TestMessages;
+    /** Captured edge print/display ops and peripheral bindings from edge-sdk. */
+    edge: TestEdge;
     /** Convenience for raw SQL: `app.query("SELECT ...", [param])`. */
     query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
     /**
@@ -273,4 +375,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 { CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedUpload, DATA_STORE_TEST_HOST, DEFAULT_SCHEMA_PATH, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, type TestDirectory, type TestInbox, type TestMessages, type TestPayments, 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 CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.d.ts

@@ -184,6 +184,106 @@ interface TestMessages {
     clear(): void;
     get count(): number;
 }
+interface ReceiptPayload {
+    header?: {
+        lines: string[];
+    };
+    items?: Array<{
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        total: number;
+        note?: string;
+    }>;
+    subtotal?: number;
+    tax?: number;
+    discount?: number;
+    total?: number;
+    payments?: Array<{
+        method: string;
+        amount: number;
+    }>;
+    footer?: {
+        lines: string[];
+    };
+    barcode?: {
+        type: "qr" | "code128";
+        data: string;
+    };
+    rawEscPos?: string;
+}
+interface DeviceInfo {
+    id: string;
+    displayName: string;
+    status: "pairing_pending" | "online" | "offline" | "decommissioned";
+    isDefault: boolean;
+    lastHeartbeatAt: string | null;
+}
+interface PeripheralInfo {
+    id: string;
+    displayName: string | null;
+    driver: string | null;
+    transport: "usb_lp" | "serial" | "tcp" | "usb_raw" | "display";
+    connected: boolean;
+    lastSeenAt: string | null;
+    device: {
+        id: string;
+        displayName: string;
+        status: DeviceInfo["status"];
+    };
+}
+type BindingState = "ok" | "peripheral_missing" | "grant_revoked";
+interface BindingInfo {
+    alias: string;
+    state: BindingState;
+    peripheral: {
+        id: string;
+        displayName: string | null;
+        driver: string | null;
+        connected: boolean;
+    } | null;
+    device: {
+        id: string;
+        displayName: string;
+        status: DeviceInfo["status"];
+    } | null;
+    updatedAt: string;
+}
+interface CapturedPrint {
+    jobId: string;
+    deploymentId: string;
+    alias?: string;
+    deviceId?: string;
+    peripheralId?: string;
+    receipt: ReceiptPayload;
+    openDrawer: boolean;
+    logo?: boolean;
+    copies: number;
+}
+interface CapturedDisplay {
+    action: "show" | "clear";
+    alias?: string;
+    peripheralId?: string;
+    url?: string;
+}
+interface CapturedTestPrint {
+    alias?: string;
+    deviceId?: string;
+    peripheralId?: string;
+}
+interface TestEdge {
+    get prints(): CapturedPrint[];
+    get displays(): CapturedDisplay[];
+    get testPrints(): CapturedTestPrint[];
+    latestPrint(): CapturedPrint | undefined;
+    latestDisplay(): CapturedDisplay | undefined;
+    get bindings(): BindingInfo[];
+    seedDevices(devices: DeviceInfo[]): void;
+    seedPeripherals(peripherals: PeripheralInfo[]): void;
+    seedBindings(bindings: BindingInfo[]): void;
+    clear(): void;
+    get count(): number;
+}
 interface TestAppOptions {
     /**
      * Path to the schema.sql snapshot generated by
@@ -219,6 +319,8 @@ interface TestApp {
     storage: TestStorage;
     /** Captured outbound messages from integrations-sdk messaging channels. */
     messages: TestMessages;
+    /** Captured edge print/display ops and peripheral bindings from edge-sdk. */
+    edge: TestEdge;
     /** Convenience for raw SQL: `app.query("SELECT ...", [param])`. */
     query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
     /**
@@ -273,4 +375,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 { CONTROL_PLANE_TEST_URL, type CallRouteOptions, type CapturedCheckout, type CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedUpload, DATA_STORE_TEST_HOST, DEFAULT_SCHEMA_PATH, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, type TestDirectory, type TestInbox, type TestMessages, type TestPayments, 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 CapturedEmail, type CapturedIdentity, type CapturedIdentityLink, type CapturedMessage, type CapturedPrint, type CapturedTestPrint, type CapturedUpload, DATA_STORE_TEST_HOST, DEFAULT_SCHEMA_PATH, type DeviceInfo, type PeripheralInfo, STORAGE_TEST_HOST, STORAGE_TEST_URL, type SessionTokens, TEST_ENV_DEFAULTS, type TestApp, type TestAppOptions, type TestDirectory, type TestEdge, type TestInbox, type TestMessages, type TestPayments, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.js

@@ -110,6 +110,13 @@ var state = globalSingleton("state", () => ({
   storageFiles: /* @__PURE__ */ new Map(),
   presignPending: /* @__PURE__ */ new Map(),
   messages: [],
+  edgePrints: [],
+  edgeDisplays: [],
+  edgeTestPrints: [],
+  edgePrintCounter: 0,
+  edgeDevices: [],
+  edgePeripherals: [],
+  edgeBindings: /* @__PURE__ */ new Map(),
   allowNetwork: false
 }));
 function requireDb() {
@@ -172,8 +179,8 @@ function verifyDeploymentAuthHeader(secret, header) {
     return null;
   }
   if (payload.type !== "deployment-request") return null;
-  const now2 = Math.floor(Date.now() / 1e3);
-  if (Math.abs(now2 - payload.timestamp) > TIMESTAMP_TOLERANCE_SECONDS) return null;
+  const now3 = Math.floor(Date.now() / 1e3);
+  if (Math.abs(now3 - payload.timestamp) > TIMESTAMP_TOLERANCE_SECONDS) return null;
   return payload;
 }
 
@@ -1475,6 +1482,224 @@ function createMessages() {
   };
 }
 
+// src/simulator/edge.ts
+function edgeFailure(error, status = 400, code) {
+  return json({ success: false, error, ...code ? { code } : {} }, status);
+}
+function bindingNotFound(alias) {
+  return edgeFailure(`No peripheral is paired to alias "${alias}"`, 404, "BINDING_NOT_FOUND");
+}
+function now2() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function nextJobId() {
+  state.edgePrintCounter += 1;
+  return `job_${state.edgePrintCounter}`;
+}
+function nextConfigVersion() {
+  return state.edgeDisplays.length + 1;
+}
+function findPeripheral(id) {
+  return state.edgePeripherals.find((p) => p.id === id);
+}
+function buildBinding(alias, peripheralId) {
+  const peripheral = findPeripheral(peripheralId);
+  return {
+    alias,
+    state: peripheral ? "ok" : "peripheral_missing",
+    peripheral: peripheral ? {
+      id: peripheral.id,
+      displayName: peripheral.displayName,
+      driver: peripheral.driver,
+      connected: peripheral.connected
+    } : null,
+    device: peripheral ? {
+      id: peripheral.device.id,
+      displayName: peripheral.device.displayName,
+      status: peripheral.device.status
+    } : null,
+    updatedAt: now2()
+  };
+}
+function handleListDevices() {
+  return success({ devices: [...state.edgeDevices] });
+}
+function handleListPeripherals(request) {
+  const deviceId = new URL(request.url).searchParams.get("deviceId");
+  const peripherals = deviceId ? state.edgePeripherals.filter((p) => p.device.id === deviceId) : [...state.edgePeripherals];
+  return success({ peripherals });
+}
+function handleListBindings() {
+  return success({ bindings: [...state.edgeBindings.values()] });
+}
+function handleGetBinding(alias) {
+  const binding = state.edgeBindings.get(alias);
+  if (!binding) return bindingNotFound(alias);
+  return success({ binding });
+}
+async function handlePair(request) {
+  const body = await readJsonBody(request);
+  const alias = String(body.alias ?? "");
+  const peripheralId = String(body.peripheralId ?? "");
+  if (!alias) return edgeFailure("alias is required");
+  if (!peripheralId) return edgeFailure("peripheralId is required");
+  if (!findPeripheral(peripheralId)) {
+    return edgeFailure("Peripheral not found or its device is not granted to this project", 404);
+  }
+  const binding = buildBinding(alias, peripheralId);
+  state.edgeBindings.set(alias, binding);
+  return success({ binding });
+}
+function handleUnpair(alias) {
+  const existed = state.edgeBindings.delete(alias);
+  if (!existed) return bindingNotFound(alias);
+  return success({ deleted: true });
+}
+async function handlePrint(request) {
+  const body = await readJsonBody(request);
+  const jobId = nextJobId();
+  const captured = {
+    jobId,
+    deploymentId: String(body.deploymentId ?? ""),
+    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: body.receipt ?? {},
+    openDrawer: body.openDrawer === true,
+    logo: body.logo === true ? true : body.logo === false ? false : void 0,
+    copies: typeof body.copies === "number" ? body.copies : 1
+  };
+  state.edgePrints.push(captured);
+  return success({
+    jobId,
+    status: "completed"
+  });
+}
+async function handleShowDisplay(request) {
+  const body = await readJsonBody(request);
+  const captured = {
+    action: "show",
+    alias: body.alias ? String(body.alias) : void 0,
+    peripheralId: body.peripheralId ? String(body.peripheralId) : void 0,
+    url: body.url ? String(body.url) : void 0
+  };
+  state.edgeDisplays.push(captured);
+  return success({
+    configVersion: nextConfigVersion(),
+    pushed: true,
+    state: "showing"
+  });
+}
+function handleClearDisplay(request) {
+  const url = new URL(request.url);
+  const alias = url.searchParams.get("alias");
+  const peripheralId = url.searchParams.get("peripheralId");
+  const captured = {
+    action: "clear",
+    alias: alias ?? void 0,
+    peripheralId: peripheralId ?? void 0
+  };
+  state.edgeDisplays.push(captured);
+  return success({
+    configVersion: nextConfigVersion(),
+    pushed: true,
+    state: "cleared"
+  });
+}
+async function handleTestPrint(request) {
+  const body = await readJsonBody(request);
+  const captured = {
+    alias: body.alias ? String(body.alias) : void 0,
+    deviceId: body.deviceId ? String(body.deviceId) : void 0,
+    peripheralId: body.peripheralId ? String(body.peripheralId) : void 0
+  };
+  state.edgeTestPrints.push(captured);
+  return success({
+    status: "ok",
+    peripheralId: captured.peripheralId ?? captured.alias ?? "default"
+  });
+}
+async function handleEdgeRequest(request, subPath) {
+  const method = request.method;
+  if (subPath === "/print" && method === "POST") {
+    return handlePrint(request);
+  }
+  if (subPath === "/devices" && method === "GET") {
+    return handleListDevices();
+  }
+  if (subPath === "/peripherals" && method === "GET") {
+    return handleListPeripherals(request);
+  }
+  if (subPath === "/bindings" && method === "GET") {
+    return handleListBindings();
+  }
+  if (subPath === "/bindings" && method === "PUT") {
+    return handlePair(request);
+  }
+  const bindingMatch = subPath.match(/^\/bindings\/([^/]+)$/);
+  if (bindingMatch) {
+    const alias = decodeURIComponent(bindingMatch[1]);
+    if (method === "GET") return handleGetBinding(alias);
+    if (method === "DELETE") return handleUnpair(alias);
+  }
+  if (subPath === "/display" && method === "POST") {
+    return handleShowDisplay(request);
+  }
+  if (subPath === "/display" && method === "DELETE") {
+    return handleClearDisplay(request);
+  }
+  if (subPath === "/test-print" && method === "POST") {
+    return handleTestPrint(request);
+  }
+  return edgeFailure(`No edge simulator for ${method} .../edge${subPath}`, 404);
+}
+function createEdge() {
+  return {
+    get prints() {
+      return [...state.edgePrints];
+    },
+    get displays() {
+      return [...state.edgeDisplays];
+    },
+    get testPrints() {
+      return [...state.edgeTestPrints];
+    },
+    latestPrint() {
+      return state.edgePrints[state.edgePrints.length - 1];
+    },
+    latestDisplay() {
+      return state.edgeDisplays[state.edgeDisplays.length - 1];
+    },
+    get bindings() {
+      return [...state.edgeBindings.values()];
+    },
+    seedDevices(devices) {
+      state.edgeDevices = [...devices];
+    },
+    seedPeripherals(peripherals) {
+      state.edgePeripherals = [...peripherals];
+    },
+    seedBindings(bindings) {
+      state.edgeBindings.clear();
+      for (const binding of bindings) {
+        state.edgeBindings.set(binding.alias, binding);
+      }
+    },
+    clear() {
+      state.edgePrints = [];
+      state.edgeDisplays = [];
+      state.edgeTestPrints = [];
+      state.edgePrintCounter = 0;
+      state.edgeDevices = [];
+      state.edgePeripherals = [];
+      state.edgeBindings.clear();
+    },
+    get count() {
+      return state.edgePrints.length + state.edgeDisplays.length + state.edgeTestPrints.length;
+    }
+  };
+}
+
 // src/simulator/router.ts
 var fetchHolder = globalSingleton("fetch-holder", () => ({
   originalFetch: null
@@ -1495,7 +1720,8 @@ function requiresDeploymentHmac(request, url) {
   const messagingMatch = url.pathname.match(
     /^\/api\/deployments\/[^/]+\/integrations\/(slack|line|facebook)(\/.*)?$/
   );
-  return !!(dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch);
+  const edgeMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/edge(\/.*)?$/);
+  return !!(dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
 }
 async function handleSimulatedRequest(request, url) {
   if (url.pathname === "/sql") {
@@ -1512,6 +1738,7 @@ async function handleSimulatedRequest(request, url) {
   const messagingMatch = url.pathname.match(
     /^\/api\/deployments\/[^/]+\/integrations\/(slack|line|facebook)(\/.*)?$/
   );
+  const edgeMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/edge(\/.*)?$/);
   const isStorageHost = url.hostname === STORAGE_TEST_HOST;
   if (requiresDeploymentHmac(request, url)) {
     const authHeader = request.headers.get("X-Stardeck-Auth");
@@ -1539,6 +1766,9 @@ async function handleSimulatedRequest(request, url) {
     const channel = messagingMatch[1];
     return handleMessagingRequest(request, channel, messagingMatch[2] ?? "");
   }
+  if (edgeMatch) {
+    return handleEdgeRequest(request, edgeMatch[1] ?? "");
+  }
   if (dataStoreMatch) {
     const subPath = dataStoreMatch[1] ?? "";
     const db = requireDb();
@@ -1560,7 +1790,7 @@ async function handleSimulatedRequest(request, url) {
     }
   }
   return failure(
-    `[stardeck-testing] No simulator for ${request.method} ${url.pathname}. Supported: data-store query/mutate/schema, email send, identities CRUD, payments store/checkout, storage upload/files, messaging send, auth verify/refresh, Neon /sql.`,
+    `[stardeck-testing] No simulator for ${request.method} ${url.pathname}. Supported: data-store query/mutate/schema, email send, identities CRUD, payments store/checkout, storage upload/files, messaging send, edge print/display/bindings, auth verify/refresh, Neon /sql.`,
     404
   );
 }
@@ -1649,6 +1879,7 @@ async function createTestApp(options = {}) {
   const payments = createPayments();
   const storage = createStorage();
   const messages = createMessages();
+  const edge = createEdge();
   const app = {
     db,
     inbox,
@@ -1656,6 +1887,7 @@ async function createTestApp(options = {}) {
     payments,
     storage,
     messages,
+    edge,
     async query(sql, params = []) {
       const result = await db.query(sql, params);
       return result.rows;
@@ -1691,6 +1923,7 @@ async function createTestApp(options = {}) {
       payments.clear();
       storage.clear();
       messages.clear();
+      edge.clear();
     },
     async close() {
       state.db = null;
@@ -1704,6 +1937,7 @@ async function createTestApp(options = {}) {
       payments.clear();
       storage.clear();
       messages.clear();
+      edge.clear();
       uninstallFetchRouter();
       await db.close();
     }