@stardeck-customer-apps/testing 0.20.0 → 0.21.0

package/SKILL.md

@@ -530,8 +530,13 @@ cursor, limit })`; `list()` intentionally keeps its previous array shape.
   production) or `app.starlens.reject("not a receipt")` (the 422 the SDK maps to
   `UnsupportedDocumentError`). An unregistered call fails with a descriptive 502 so a
   test never passes on an invented extraction. `app.starlens.calls` records each
-  request's version, input names/media types (never bytes), schema and
-  instructions — assert your `.describe()` aliases reached the wire there.
+  request's version, effort, input names/media types (never bytes), schema and
+  instructions — assert your `.describe()` aliases and `effort: "high"` retries
+  reached the wire there. `version: "v1"` with `effort: "high"` is refused with the
+  same 400 `unsupported_effort` as production (the SDK throws `ValidationError`). A
+  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.
 
 ### Receipt layout and printer capabilities
 

package/dist/index.d.mts

@@ -536,7 +536,10 @@ interface TestEdge {
 }
 /** One Starlens request the app made, as the simulator saw it (names only, never bytes). */
 interface CapturedStarlensCall {
+    /** As sent (`latest` stays `latest`). */
     version: string;
+    /** As requested; `"low"` when the app did not set one. The reply says what ran. */
+    effort: "low" | "high";
     inputs: {
         name: string;
         mediaType: string | null;
@@ -557,6 +560,12 @@ type StarlensReply = {
         path: string;
         reason: string;
     }[];
+    /**
+     * The effort the reply says ran. Defaults to the requested effort, or `"low"` for a
+     * high request with no image input (production cannot crop a PDF, audio or video).
+     * Set `"low"` to simulate a high request on an image production could not decode.
+     */
+    effort?: "low" | "high";
 } | {
     reject: string;
 };

package/dist/index.d.ts

@@ -536,7 +536,10 @@ interface TestEdge {
 }
 /** One Starlens request the app made, as the simulator saw it (names only, never bytes). */
 interface CapturedStarlensCall {
+    /** As sent (`latest` stays `latest`). */
     version: string;
+    /** As requested; `"low"` when the app did not set one. The reply says what ran. */
+    effort: "low" | "high";
     inputs: {
         name: string;
         mediaType: string | null;
@@ -557,6 +560,12 @@ type StarlensReply = {
         path: string;
         reason: string;
     }[];
+    /**
+     * The effort the reply says ran. Defaults to the requested effort, or `"low"` for a
+     * high request with no image input (production cannot crop a PDF, audio or video).
+     * Set `"low"` to simulate a high request on an image production could not decode.
+     */
+    effort?: "low" | "high";
 } | {
     reject: string;
 };

package/dist/index.js

@@ -3102,6 +3102,7 @@ function createEdge() {
 }
 
 // src/simulator/starlens.ts
+var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
   return json({ success: false, error, code }, status);
 }
@@ -3120,11 +3121,18 @@ function nullFlagged(output, issues) {
   }
   return copy;
 }
-async function handleStarlensExtract(request, signedDeploymentId) {
-  const body = await readJsonBody(request);
-  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
-    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
-  }
+function isInputShape(input) {
+  if (!input || typeof input !== "object") return false;
+  const i = input;
+  return typeof i.url === "string" || typeof i.data === "string" && i.data.length > 0 && typeof i.mediaType === "string";
+}
+var NON_IMAGE_EXTENSION = /\.(pdf|mp3|m4a|wav|ogg|aac|flac|mp4|mov|webm|mkv)(\?|#|$)/i;
+function isCroppable(input) {
+  if (typeof input.mediaType === "string") return input.mediaType.startsWith("image/");
+  const name = typeof input.filename === "string" ? input.filename : input.url;
+  return !(typeof name === "string" && NON_IMAGE_EXTENSION.test(name));
+}
+function validateStarlensBody(body) {
   const inputs = Array.isArray(body.inputs) ? body.inputs : [];
   if (inputs.length === 0) {
     return starlensFailure(
@@ -3133,6 +3141,13 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  if (!inputs.every(isInputShape)) {
+    return starlensFailure(
+      "Validation failed \u2014 inputs: each input needs a url, or data with a mediaType",
+      400,
+      "VALIDATION_ERROR"
+    );
+  }
   const schema = body.schema;
   if (!schema || schema.type !== "object" || typeof schema.properties !== "object") {
     return starlensFailure(
@@ -3141,8 +3156,35 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  const version = body.version ?? "latest";
+  if (version !== "v1" && version !== "v2" && version !== "latest") {
+    return starlensFailure("Validation failed \u2014 version: unknown version", 400, "VALIDATION_ERROR");
+  }
+  const effort = body.effort ?? "low";
+  if (effort !== "low" && effort !== "high") {
+    return starlensFailure("Validation failed \u2014 effort: low or high", 400, "VALIDATION_ERROR");
+  }
+  const resolved = version === "latest" ? LATEST_VERSION : version;
+  if (effort === "high" && resolved === "v1") {
+    return starlensFailure(
+      `Starlens v1 does not support effort "high"; use version "v2"`,
+      400,
+      "unsupported_effort"
+    );
+  }
+  return { version, resolved, effort, inputs, schema };
+}
+async function handleStarlensExtract(request, signedDeploymentId) {
+  const body = await readJsonBody(request);
+  const valid = validateStarlensBody(body);
+  if (valid instanceof Response) return valid;
+  const { version, resolved, effort, inputs, schema } = valid;
+  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
+    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
+  }
   const call = {
-    version: typeof body.version === "string" ? body.version : "latest",
+    version,
+    effort,
     inputs: inputs.map((i) => ({
       name: typeof i.filename === "string" ? i.filename : typeof i.url === "string" ? i.url : "upload",
       mediaType: typeof i.mediaType === "string" ? i.mediaType : null,
@@ -3164,8 +3206,10 @@ async function handleStarlensExtract(request, signedDeploymentId) {
     return starlensFailure(reply.reject, 422, "unsupported_document");
   }
   const issues = reply.issues ?? [];
+  const ran = reply.effort ?? (effort === "high" && !inputs.some(isCroppable) ? "low" : effort);
   return success({
-    version: call.version === "latest" ? "v1" : call.version,
+    version: resolved,
+    effort: ran,
     output: nullFlagged(reply.output, issues),
     issues,
     usage: { inputTokens: 0, outputTokens: 0, cost: 0 }

package/dist/index.mjs

@@ -3063,6 +3063,7 @@ function createEdge() {
 }
 
 // src/simulator/starlens.ts
+var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
   return json({ success: false, error, code }, status);
 }
@@ -3081,11 +3082,18 @@ function nullFlagged(output, issues) {
   }
   return copy;
 }
-async function handleStarlensExtract(request, signedDeploymentId) {
-  const body = await readJsonBody(request);
-  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
-    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
-  }
+function isInputShape(input) {
+  if (!input || typeof input !== "object") return false;
+  const i = input;
+  return typeof i.url === "string" || typeof i.data === "string" && i.data.length > 0 && typeof i.mediaType === "string";
+}
+var NON_IMAGE_EXTENSION = /\.(pdf|mp3|m4a|wav|ogg|aac|flac|mp4|mov|webm|mkv)(\?|#|$)/i;
+function isCroppable(input) {
+  if (typeof input.mediaType === "string") return input.mediaType.startsWith("image/");
+  const name = typeof input.filename === "string" ? input.filename : input.url;
+  return !(typeof name === "string" && NON_IMAGE_EXTENSION.test(name));
+}
+function validateStarlensBody(body) {
   const inputs = Array.isArray(body.inputs) ? body.inputs : [];
   if (inputs.length === 0) {
     return starlensFailure(
@@ -3094,6 +3102,13 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  if (!inputs.every(isInputShape)) {
+    return starlensFailure(
+      "Validation failed \u2014 inputs: each input needs a url, or data with a mediaType",
+      400,
+      "VALIDATION_ERROR"
+    );
+  }
   const schema = body.schema;
   if (!schema || schema.type !== "object" || typeof schema.properties !== "object") {
     return starlensFailure(
@@ -3102,8 +3117,35 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  const version = body.version ?? "latest";
+  if (version !== "v1" && version !== "v2" && version !== "latest") {
+    return starlensFailure("Validation failed \u2014 version: unknown version", 400, "VALIDATION_ERROR");
+  }
+  const effort = body.effort ?? "low";
+  if (effort !== "low" && effort !== "high") {
+    return starlensFailure("Validation failed \u2014 effort: low or high", 400, "VALIDATION_ERROR");
+  }
+  const resolved = version === "latest" ? LATEST_VERSION : version;
+  if (effort === "high" && resolved === "v1") {
+    return starlensFailure(
+      `Starlens v1 does not support effort "high"; use version "v2"`,
+      400,
+      "unsupported_effort"
+    );
+  }
+  return { version, resolved, effort, inputs, schema };
+}
+async function handleStarlensExtract(request, signedDeploymentId) {
+  const body = await readJsonBody(request);
+  const valid = validateStarlensBody(body);
+  if (valid instanceof Response) return valid;
+  const { version, resolved, effort, inputs, schema } = valid;
+  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
+    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
+  }
   const call = {
-    version: typeof body.version === "string" ? body.version : "latest",
+    version,
+    effort,
     inputs: inputs.map((i) => ({
       name: typeof i.filename === "string" ? i.filename : typeof i.url === "string" ? i.url : "upload",
       mediaType: typeof i.mediaType === "string" ? i.mediaType : null,
@@ -3125,8 +3167,10 @@ async function handleStarlensExtract(request, signedDeploymentId) {
     return starlensFailure(reply.reject, 422, "unsupported_document");
   }
   const issues = reply.issues ?? [];
+  const ran = reply.effort ?? (effort === "high" && !inputs.some(isCroppable) ? "low" : effort);
   return success({
-    version: call.version === "latest" ? "v1" : call.version,
+    version: resolved,
+    effort: ran,
     output: nullFlagged(reply.output, issues),
     issues,
     usage: { inputTokens: 0, outputTokens: 0, cost: 0 }

package/dist/setup.js

@@ -2247,6 +2247,7 @@ async function handleEdgeRequest(request, subPath) {
 }
 
 // src/simulator/starlens.ts
+var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
   return json({ success: false, error, code }, status);
 }
@@ -2265,11 +2266,18 @@ function nullFlagged(output, issues) {
   }
   return copy;
 }
-async function handleStarlensExtract(request, signedDeploymentId) {
-  const body = await readJsonBody(request);
-  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
-    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
-  }
+function isInputShape(input) {
+  if (!input || typeof input !== "object") return false;
+  const i = input;
+  return typeof i.url === "string" || typeof i.data === "string" && i.data.length > 0 && typeof i.mediaType === "string";
+}
+var NON_IMAGE_EXTENSION = /\.(pdf|mp3|m4a|wav|ogg|aac|flac|mp4|mov|webm|mkv)(\?|#|$)/i;
+function isCroppable(input) {
+  if (typeof input.mediaType === "string") return input.mediaType.startsWith("image/");
+  const name = typeof input.filename === "string" ? input.filename : input.url;
+  return !(typeof name === "string" && NON_IMAGE_EXTENSION.test(name));
+}
+function validateStarlensBody(body) {
   const inputs = Array.isArray(body.inputs) ? body.inputs : [];
   if (inputs.length === 0) {
     return starlensFailure(
@@ -2278,6 +2286,13 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  if (!inputs.every(isInputShape)) {
+    return starlensFailure(
+      "Validation failed \u2014 inputs: each input needs a url, or data with a mediaType",
+      400,
+      "VALIDATION_ERROR"
+    );
+  }
   const schema = body.schema;
   if (!schema || schema.type !== "object" || typeof schema.properties !== "object") {
     return starlensFailure(
@@ -2286,8 +2301,35 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  const version = body.version ?? "latest";
+  if (version !== "v1" && version !== "v2" && version !== "latest") {
+    return starlensFailure("Validation failed \u2014 version: unknown version", 400, "VALIDATION_ERROR");
+  }
+  const effort = body.effort ?? "low";
+  if (effort !== "low" && effort !== "high") {
+    return starlensFailure("Validation failed \u2014 effort: low or high", 400, "VALIDATION_ERROR");
+  }
+  const resolved = version === "latest" ? LATEST_VERSION : version;
+  if (effort === "high" && resolved === "v1") {
+    return starlensFailure(
+      `Starlens v1 does not support effort "high"; use version "v2"`,
+      400,
+      "unsupported_effort"
+    );
+  }
+  return { version, resolved, effort, inputs, schema };
+}
+async function handleStarlensExtract(request, signedDeploymentId) {
+  const body = await readJsonBody(request);
+  const valid = validateStarlensBody(body);
+  if (valid instanceof Response) return valid;
+  const { version, resolved, effort, inputs, schema } = valid;
+  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
+    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
+  }
   const call = {
-    version: typeof body.version === "string" ? body.version : "latest",
+    version,
+    effort,
     inputs: inputs.map((i) => ({
       name: typeof i.filename === "string" ? i.filename : typeof i.url === "string" ? i.url : "upload",
       mediaType: typeof i.mediaType === "string" ? i.mediaType : null,
@@ -2309,8 +2351,10 @@ async function handleStarlensExtract(request, signedDeploymentId) {
     return starlensFailure(reply.reject, 422, "unsupported_document");
   }
   const issues = reply.issues ?? [];
+  const ran = reply.effort ?? (effort === "high" && !inputs.some(isCroppable) ? "low" : effort);
   return success({
-    version: call.version === "latest" ? "v1" : call.version,
+    version: resolved,
+    effort: ran,
     output: nullFlagged(reply.output, issues),
     issues,
     usage: { inputTokens: 0, outputTokens: 0, cost: 0 }

package/dist/setup.mjs

@@ -2223,6 +2223,7 @@ async function handleEdgeRequest(request, subPath) {
 }
 
 // src/simulator/starlens.ts
+var LATEST_VERSION = "v2";
 function starlensFailure(error, status, code) {
   return json({ success: false, error, code }, status);
 }
@@ -2241,11 +2242,18 @@ function nullFlagged(output, issues) {
   }
   return copy;
 }
-async function handleStarlensExtract(request, signedDeploymentId) {
-  const body = await readJsonBody(request);
-  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
-    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
-  }
+function isInputShape(input) {
+  if (!input || typeof input !== "object") return false;
+  const i = input;
+  return typeof i.url === "string" || typeof i.data === "string" && i.data.length > 0 && typeof i.mediaType === "string";
+}
+var NON_IMAGE_EXTENSION = /\.(pdf|mp3|m4a|wav|ogg|aac|flac|mp4|mov|webm|mkv)(\?|#|$)/i;
+function isCroppable(input) {
+  if (typeof input.mediaType === "string") return input.mediaType.startsWith("image/");
+  const name = typeof input.filename === "string" ? input.filename : input.url;
+  return !(typeof name === "string" && NON_IMAGE_EXTENSION.test(name));
+}
+function validateStarlensBody(body) {
   const inputs = Array.isArray(body.inputs) ? body.inputs : [];
   if (inputs.length === 0) {
     return starlensFailure(
@@ -2254,6 +2262,13 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  if (!inputs.every(isInputShape)) {
+    return starlensFailure(
+      "Validation failed \u2014 inputs: each input needs a url, or data with a mediaType",
+      400,
+      "VALIDATION_ERROR"
+    );
+  }
   const schema = body.schema;
   if (!schema || schema.type !== "object" || typeof schema.properties !== "object") {
     return starlensFailure(
@@ -2262,8 +2277,35 @@ async function handleStarlensExtract(request, signedDeploymentId) {
       "VALIDATION_ERROR"
     );
   }
+  const version = body.version ?? "latest";
+  if (version !== "v1" && version !== "v2" && version !== "latest") {
+    return starlensFailure("Validation failed \u2014 version: unknown version", 400, "VALIDATION_ERROR");
+  }
+  const effort = body.effort ?? "low";
+  if (effort !== "low" && effort !== "high") {
+    return starlensFailure("Validation failed \u2014 effort: low or high", 400, "VALIDATION_ERROR");
+  }
+  const resolved = version === "latest" ? LATEST_VERSION : version;
+  if (effort === "high" && resolved === "v1") {
+    return starlensFailure(
+      `Starlens v1 does not support effort "high"; use version "v2"`,
+      400,
+      "unsupported_effort"
+    );
+  }
+  return { version, resolved, effort, inputs, schema };
+}
+async function handleStarlensExtract(request, signedDeploymentId) {
+  const body = await readJsonBody(request);
+  const valid = validateStarlensBody(body);
+  if (valid instanceof Response) return valid;
+  const { version, resolved, effort, inputs, schema } = valid;
+  if (signedDeploymentId !== null && body.deploymentId !== signedDeploymentId) {
+    return starlensFailure("Deployment ID mismatch", 401, "AUTHENTICATION_ERROR");
+  }
   const call = {
-    version: typeof body.version === "string" ? body.version : "latest",
+    version,
+    effort,
     inputs: inputs.map((i) => ({
       name: typeof i.filename === "string" ? i.filename : typeof i.url === "string" ? i.url : "upload",
       mediaType: typeof i.mediaType === "string" ? i.mediaType : null,
@@ -2285,8 +2327,10 @@ async function handleStarlensExtract(request, signedDeploymentId) {
     return starlensFailure(reply.reject, 422, "unsupported_document");
   }
   const issues = reply.issues ?? [];
+  const ran = reply.effort ?? (effort === "high" && !inputs.some(isCroppable) ? "low" : effort);
   return success({
-    version: call.version === "latest" ? "v1" : call.version,
+    version: resolved,
+    effort: ran,
     output: nullFlagged(reply.output, issues),
     issues,
     usage: { inputTokens: 0, outputTokens: 0, cost: 0 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/testing",
-  "version": "0.20.0",
+  "version": "0.21.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",