@stardeck-customer-apps/testing 0.25.0 → 0.26.0

package/SKILL.md

@@ -568,7 +568,8 @@ cursor, limit })`; `list()` intentionally keeps its previous array shape.
 - `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; pair/unpair, list devices/peripherals, show/clear
+  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()`.
@@ -585,6 +586,12 @@ cursor, limit })`; `list()` intentionally keeps its previous array shape.
   high request with no image input answers `effort: "low"` as production does;
   pass `effort: "low"` in `app.starlens.mock(...)` to simulate an image production
   could not decode.
+- `wakeSchedule(key, at)` from the scheduling SDK — there is no scheduler in tests: each
+  wake is recorded in `app.schedules`. After a write that creates work for an adaptive job,
+  assert the job was asked for in time:
+  `expect(app.schedules.earliestWake("booking-janitor")!.getTime()).toBeLessThanOrEqual(dueAt.getTime())`.
+  `app.schedules.wakesFor(key)` lists them; `reset()` clears them. Run the job's handler
+  yourself to test what it does and the `nextRun()` it returns.
 
 ### Receipt layout and printer capabilities
 

package/dist/index.d.mts

@@ -555,8 +555,10 @@ interface CapturedDurablePrint {
 /** 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;
@@ -650,6 +652,20 @@ interface TestStarlens {
     clear(): void;
     get count(): number;
 }
+/** A wake the app asked for: run `scheduleKey` by `at` (scheduling-sdk `wakeSchedule`). */
+interface CapturedScheduleWake {
+    scheduleKey: string;
+    at: Date;
+    requestedAt: Date;
+}
+interface TestSchedules {
+    /** Every wake the app asked for, oldest first. */
+    get wakes(): CapturedScheduleWake[];
+    wakesFor(scheduleKey: string): CapturedScheduleWake[];
+    /** The earliest `at` any wake asked of `scheduleKey`, or undefined if none did. */
+    earliestWake(scheduleKey: string): Date | undefined;
+    clear(): void;
+}
 interface TestAppOptions {
     /**
      * The LIFF ID the platform forwards to the app for a LINE MINI App shop. It is
@@ -702,6 +718,8 @@ interface TestApp {
     edge: TestEdge;
     /** Scripted replies and captured calls for the Starlens SDK. */
     starlens: TestStarlens;
+    /** Wakes the app asked of its adaptive schedules (`wakeSchedule`). */
+    schedules: TestSchedules;
     /** Convenience for raw SQL: `app.query("SELECT ...", [param])`. */
     query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
     /**
@@ -772,4 +790,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 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 };
+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 CapturedScheduleWake, 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 TestSchedules, type TestStarlens, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.d.ts

@@ -555,8 +555,10 @@ interface CapturedDurablePrint {
 /** 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;
@@ -650,6 +652,20 @@ interface TestStarlens {
     clear(): void;
     get count(): number;
 }
+/** A wake the app asked for: run `scheduleKey` by `at` (scheduling-sdk `wakeSchedule`). */
+interface CapturedScheduleWake {
+    scheduleKey: string;
+    at: Date;
+    requestedAt: Date;
+}
+interface TestSchedules {
+    /** Every wake the app asked for, oldest first. */
+    get wakes(): CapturedScheduleWake[];
+    wakesFor(scheduleKey: string): CapturedScheduleWake[];
+    /** The earliest `at` any wake asked of `scheduleKey`, or undefined if none did. */
+    earliestWake(scheduleKey: string): Date | undefined;
+    clear(): void;
+}
 interface TestAppOptions {
     /**
      * The LIFF ID the platform forwards to the app for a LINE MINI App shop. It is
@@ -702,6 +718,8 @@ interface TestApp {
     edge: TestEdge;
     /** Scripted replies and captured calls for the Starlens SDK. */
     starlens: TestStarlens;
+    /** Wakes the app asked of its adaptive schedules (`wakeSchedule`). */
+    schedules: TestSchedules;
     /** Convenience for raw SQL: `app.query("SELECT ...", [param])`. */
     query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
     /**
@@ -772,4 +790,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 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 };
+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 CapturedScheduleWake, 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 TestSchedules, type TestStarlens, type TestStorage, type TestUser, WORKFLOW_NAME_PREFIX, callRoute, createTestApp, describeWorkflow, parseWorkflowName };

package/dist/index.js

@@ -338,6 +338,7 @@ var state = globalSingleton("state", () => ({
   identitySuppressClaimDelivery: false,
   identityAllowedReturnOrigins: /* @__PURE__ */ new Set([APP_TEST_ORIGIN]),
   checkouts: [],
+  scheduleWakes: [],
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   idempotentCheckouts: /* @__PURE__ */ new Map(),
@@ -3440,7 +3441,9 @@ async function handleEnqueue(request) {
 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,
@@ -3624,6 +3627,32 @@ function createEdge() {
   };
 }
 
+// src/simulator/schedules.ts
+async function handleScheduleWake(request, scheduleKey) {
+  if (request.method !== "POST") return failure(`Method ${request.method} not allowed`, 405);
+  const body = await readJsonBody(request);
+  const at = typeof body.at === "string" ? new Date(body.at) : null;
+  if (!at || Number.isNaN(at.getTime())) return failure("`at` must be an ISO date-time", 400);
+  state.scheduleWakes.push({ scheduleKey, at, requestedAt: /* @__PURE__ */ new Date() });
+  return success({ woken: true });
+}
+function createSchedules() {
+  return {
+    get wakes() {
+      return state.scheduleWakes;
+    },
+    wakesFor(scheduleKey) {
+      return state.scheduleWakes.filter((wake) => wake.scheduleKey === scheduleKey);
+    },
+    earliestWake(scheduleKey) {
+      return this.wakesFor(scheduleKey).map((wake) => wake.at).sort((a, b) => a.getTime() - b.getTime())[0];
+    },
+    clear() {
+      state.scheduleWakes = [];
+    }
+  };
+}
+
 // src/simulator/starlens.ts
 var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
@@ -3788,8 +3817,10 @@ function requiresDeploymentHmac(request, url) {
   );
   const edgeMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/edge(\/.*)?$/);
   const isStarlens = url.pathname === "/api/starlens/extract";
-  return !!(isStarlens || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  return !!(isStarlens || scheduleWakeMatch || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
 }
+var SCHEDULE_WAKE_PATH = /^\/api\/deployments\/[^/]+\/schedules\/([^/]+)\/wake$/;
 function deploymentIdFromPath(url) {
   const match = url.pathname.match(/\/api\/deployments\/([^/]+)(?:\/|$)/);
   if (!match) return null;
@@ -3854,6 +3885,10 @@ async function handleSimulatedRequest(request, url) {
   if (edgeMatch) {
     return handleEdgeRequest(request, edgeMatch[1] ?? "");
   }
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  if (scheduleWakeMatch) {
+    return handleScheduleWake(request, decodeURIComponent(scheduleWakeMatch[1]));
+  }
   if (url.pathname === "/api/starlens/extract" && request.method === "POST") {
     return handleStarlensExtract(request, signedDeploymentId);
   }
@@ -3878,7 +3913,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, edge print/display/bindings, starlens extract, 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, starlens extract, schedule wakes, auth verify/refresh, Neon /sql.`,
     404
   );
 }
@@ -4057,6 +4092,7 @@ async function createTestApp(options = {}) {
   const messages = createMessages();
   const edge = createEdge();
   const starlens = createStarlens();
+  const schedules = createSchedules();
   const app = {
     db,
     inbox,
@@ -4066,6 +4102,7 @@ async function createTestApp(options = {}) {
     messages,
     edge,
     starlens,
+    schedules,
     async query(sql, params = []) {
       const result = await db.query(sql, params);
       return result.rows;
@@ -4114,6 +4151,7 @@ async function createTestApp(options = {}) {
       messages.clear();
       edge.clear();
       starlens.clear();
+      schedules.clear();
     },
     async close() {
       state.db = null;
@@ -4129,6 +4167,7 @@ async function createTestApp(options = {}) {
       messages.clear();
       edge.clear();
       starlens.clear();
+      schedules.clear();
       uninstallFetchRouter();
       await db.close();
     }

package/dist/index.mjs

@@ -299,6 +299,7 @@ var state = globalSingleton("state", () => ({
   identitySuppressClaimDelivery: false,
   identityAllowedReturnOrigins: /* @__PURE__ */ new Set([APP_TEST_ORIGIN]),
   checkouts: [],
+  scheduleWakes: [],
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   idempotentCheckouts: /* @__PURE__ */ new Map(),
@@ -3401,7 +3402,9 @@ async function handleEnqueue(request) {
 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,
@@ -3585,6 +3588,32 @@ function createEdge() {
   };
 }
 
+// src/simulator/schedules.ts
+async function handleScheduleWake(request, scheduleKey) {
+  if (request.method !== "POST") return failure(`Method ${request.method} not allowed`, 405);
+  const body = await readJsonBody(request);
+  const at = typeof body.at === "string" ? new Date(body.at) : null;
+  if (!at || Number.isNaN(at.getTime())) return failure("`at` must be an ISO date-time", 400);
+  state.scheduleWakes.push({ scheduleKey, at, requestedAt: /* @__PURE__ */ new Date() });
+  return success({ woken: true });
+}
+function createSchedules() {
+  return {
+    get wakes() {
+      return state.scheduleWakes;
+    },
+    wakesFor(scheduleKey) {
+      return state.scheduleWakes.filter((wake) => wake.scheduleKey === scheduleKey);
+    },
+    earliestWake(scheduleKey) {
+      return this.wakesFor(scheduleKey).map((wake) => wake.at).sort((a, b) => a.getTime() - b.getTime())[0];
+    },
+    clear() {
+      state.scheduleWakes = [];
+    }
+  };
+}
+
 // src/simulator/starlens.ts
 var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
@@ -3749,8 +3778,10 @@ function requiresDeploymentHmac(request, url) {
   );
   const edgeMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/edge(\/.*)?$/);
   const isStarlens = url.pathname === "/api/starlens/extract";
-  return !!(isStarlens || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  return !!(isStarlens || scheduleWakeMatch || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
 }
+var SCHEDULE_WAKE_PATH = /^\/api\/deployments\/[^/]+\/schedules\/([^/]+)\/wake$/;
 function deploymentIdFromPath(url) {
   const match = url.pathname.match(/\/api\/deployments\/([^/]+)(?:\/|$)/);
   if (!match) return null;
@@ -3815,6 +3846,10 @@ async function handleSimulatedRequest(request, url) {
   if (edgeMatch) {
     return handleEdgeRequest(request, edgeMatch[1] ?? "");
   }
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  if (scheduleWakeMatch) {
+    return handleScheduleWake(request, decodeURIComponent(scheduleWakeMatch[1]));
+  }
   if (url.pathname === "/api/starlens/extract" && request.method === "POST") {
     return handleStarlensExtract(request, signedDeploymentId);
   }
@@ -3839,7 +3874,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, edge print/display/bindings, starlens extract, 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, starlens extract, schedule wakes, auth verify/refresh, Neon /sql.`,
     404
   );
 }
@@ -4018,6 +4053,7 @@ async function createTestApp(options = {}) {
   const messages = createMessages();
   const edge = createEdge();
   const starlens = createStarlens();
+  const schedules = createSchedules();
   const app = {
     db,
     inbox,
@@ -4027,6 +4063,7 @@ async function createTestApp(options = {}) {
     messages,
     edge,
     starlens,
+    schedules,
     async query(sql, params = []) {
       const result = await db.query(sql, params);
       return result.rows;
@@ -4075,6 +4112,7 @@ async function createTestApp(options = {}) {
       messages.clear();
       edge.clear();
       starlens.clear();
+      schedules.clear();
     },
     async close() {
       state.db = null;
@@ -4090,6 +4128,7 @@ async function createTestApp(options = {}) {
       messages.clear();
       edge.clear();
       starlens.clear();
+      schedules.clear();
       uninstallFetchRouter();
       await db.close();
     }

package/dist/next/headers-shim.js

@@ -60,6 +60,7 @@ var state = globalSingleton("state", () => ({
   identitySuppressClaimDelivery: false,
   identityAllowedReturnOrigins: /* @__PURE__ */ new Set([APP_TEST_ORIGIN]),
   checkouts: [],
+  scheduleWakes: [],
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   idempotentCheckouts: /* @__PURE__ */ new Map(),

package/dist/next/headers-shim.mjs

@@ -33,6 +33,7 @@ var state = globalSingleton("state", () => ({
   identitySuppressClaimDelivery: false,
   identityAllowedReturnOrigins: /* @__PURE__ */ new Set([APP_TEST_ORIGIN]),
   checkouts: [],
+  scheduleWakes: [],
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   idempotentCheckouts: /* @__PURE__ */ new Map(),

package/dist/setup.js

@@ -65,6 +65,7 @@ var state = globalSingleton("state", () => ({
   identitySuppressClaimDelivery: false,
   identityAllowedReturnOrigins: /* @__PURE__ */ new Set([APP_TEST_ORIGIN]),
   checkouts: [],
+  scheduleWakes: [],
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   idempotentCheckouts: /* @__PURE__ */ new Map(),
@@ -2585,7 +2586,9 @@ async function handleEnqueue(request) {
 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,
@@ -2705,6 +2708,16 @@ async function handleEdgeRequest(request, subPath) {
   return edgeFailure(`No edge simulator for ${method} .../edge${subPath}`, 404);
 }
 
+// src/simulator/schedules.ts
+async function handleScheduleWake(request, scheduleKey) {
+  if (request.method !== "POST") return failure(`Method ${request.method} not allowed`, 405);
+  const body = await readJsonBody(request);
+  const at = typeof body.at === "string" ? new Date(body.at) : null;
+  if (!at || Number.isNaN(at.getTime())) return failure("`at` must be an ISO date-time", 400);
+  state.scheduleWakes.push({ scheduleKey, at, requestedAt: /* @__PURE__ */ new Date() });
+  return success({ woken: true });
+}
+
 // src/simulator/starlens.ts
 var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
@@ -2842,8 +2855,10 @@ function requiresDeploymentHmac(request, url) {
   );
   const edgeMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/edge(\/.*)?$/);
   const isStarlens = url.pathname === "/api/starlens/extract";
-  return !!(isStarlens || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  return !!(isStarlens || scheduleWakeMatch || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
 }
+var SCHEDULE_WAKE_PATH = /^\/api\/deployments\/[^/]+\/schedules\/([^/]+)\/wake$/;
 function deploymentIdFromPath(url) {
   const match = url.pathname.match(/\/api\/deployments\/([^/]+)(?:\/|$)/);
   if (!match) return null;
@@ -2908,6 +2923,10 @@ async function handleSimulatedRequest(request, url) {
   if (edgeMatch) {
     return handleEdgeRequest(request, edgeMatch[1] ?? "");
   }
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  if (scheduleWakeMatch) {
+    return handleScheduleWake(request, decodeURIComponent(scheduleWakeMatch[1]));
+  }
   if (url.pathname === "/api/starlens/extract" && request.method === "POST") {
     return handleStarlensExtract(request, signedDeploymentId);
   }
@@ -2932,7 +2951,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, edge print/display/bindings, starlens extract, 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, starlens extract, schedule wakes, auth verify/refresh, Neon /sql.`,
     404
   );
 }

package/dist/setup.mjs

@@ -41,6 +41,7 @@ var state = globalSingleton("state", () => ({
   identitySuppressClaimDelivery: false,
   identityAllowedReturnOrigins: /* @__PURE__ */ new Set([APP_TEST_ORIGIN]),
   checkouts: [],
+  scheduleWakes: [],
   checkoutCounter: 0,
   sessionStatuses: /* @__PURE__ */ new Map(),
   idempotentCheckouts: /* @__PURE__ */ new Map(),
@@ -2561,7 +2562,9 @@ async function handleEnqueue(request) {
 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,
@@ -2681,6 +2684,16 @@ async function handleEdgeRequest(request, subPath) {
   return edgeFailure(`No edge simulator for ${method} .../edge${subPath}`, 404);
 }
 
+// src/simulator/schedules.ts
+async function handleScheduleWake(request, scheduleKey) {
+  if (request.method !== "POST") return failure(`Method ${request.method} not allowed`, 405);
+  const body = await readJsonBody(request);
+  const at = typeof body.at === "string" ? new Date(body.at) : null;
+  if (!at || Number.isNaN(at.getTime())) return failure("`at` must be an ISO date-time", 400);
+  state.scheduleWakes.push({ scheduleKey, at, requestedAt: /* @__PURE__ */ new Date() });
+  return success({ woken: true });
+}
+
 // src/simulator/starlens.ts
 var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
@@ -2818,8 +2831,10 @@ function requiresDeploymentHmac(request, url) {
   );
   const edgeMatch = url.pathname.match(/^\/api\/deployments\/[^/]+\/edge(\/.*)?$/);
   const isStarlens = url.pathname === "/api/starlens/extract";
-  return !!(isStarlens || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  return !!(isStarlens || scheduleWakeMatch || dataStoreMatch || isEmail || identitiesMatch || storeMatch || messagingMatch || edgeMatch);
 }
+var SCHEDULE_WAKE_PATH = /^\/api\/deployments\/[^/]+\/schedules\/([^/]+)\/wake$/;
 function deploymentIdFromPath(url) {
   const match = url.pathname.match(/\/api\/deployments\/([^/]+)(?:\/|$)/);
   if (!match) return null;
@@ -2884,6 +2899,10 @@ async function handleSimulatedRequest(request, url) {
   if (edgeMatch) {
     return handleEdgeRequest(request, edgeMatch[1] ?? "");
   }
+  const scheduleWakeMatch = url.pathname.match(SCHEDULE_WAKE_PATH);
+  if (scheduleWakeMatch) {
+    return handleScheduleWake(request, decodeURIComponent(scheduleWakeMatch[1]));
+  }
   if (url.pathname === "/api/starlens/extract" && request.method === "POST") {
     return handleStarlensExtract(request, signedDeploymentId);
   }
@@ -2908,7 +2927,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, edge print/display/bindings, starlens extract, 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, starlens extract, schedule wakes, auth verify/refresh, Neon /sql.`,
     404
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/testing",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "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",
@@ -100,6 +100,7 @@
     "@stardeck-customer-apps/email-sdk": "*",
     "@stardeck-customer-apps/integrations-sdk": "*",
     "@stardeck-customer-apps/payments-sdk": "*",
+    "@stardeck-customer-apps/scheduling-sdk": "*",
     "@stardeck-customer-apps/storage-sdk": "*",
     "@stardeck-customer-apps/tsconfig": "*",
     "@types/node": "^24.10.1",