@stardeck-customer-apps/testing 0.10.0 → 0.12.0

package/SKILL.md

@@ -203,6 +203,26 @@ 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);
 
+// LINE Flex card — the simulator preserves the complete LINE-native container.
+const card = {
+  type: "bubble" as const,
+  body: {
+    type: "box",
+    layout: "vertical",
+    contents: [{ type: "text", text: "Order shipped" }],
+  },
+};
+await integrations.line.push("U123", {
+  type: "flex",
+  altText: "Your order shipped",
+  contents: card,
+});
+expect(app.messages.channel("line").to("U123")[1].body).toEqual({
+  type: "flex",
+  altText: "Your order shipped",
+  contents: card,
+});
+
 // Guest/counter identity resolution. `provenance` is selected by this trusted
 // server route; never copy it from a browser form or request body.
 const identity = await integrations.identities.resolveOrCreate({
@@ -265,7 +285,14 @@ expect(app.edge.latestDisplay()?.action).toBe("show");
 - `app.issueSession(partial?)` — mint access/refresh tokens for cookie-based
   auth flows (`__stardeck:sess`).
 - `app.inbox` — emails sent through the email-sdk: `.latest(addr?)`,
-  `.to(addr)`, `.all()`, `.count`, `.clear()`.
+  `.to(addr)`, `.all()`, `.count`, `.clear()`. Each captured email carries
+  `headers` (`{}` when none were set), so a reply that should thread onto an
+  inbound conversation can be asserted:
+
+  ```ts
+  expect(app.inbox.latest()?.headers["In-Reply-To"]).toBe("<original@mail.example>");
+  ```
+
 - `app.identities` — the platform-identity directory created through
   integrations-sdk `client.identities`: `.get(id)`, `.links(id)`, `.all()`,
   `.count`, `.clear()`. The test-only `.seedVerifiedLink(id, { kind,
@@ -288,7 +315,10 @@ externalId })` helper models a trusted platform/channel link, and
   list `limit` 1–100, status filter values).
 - `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()`.
+  `.all()`, `.latest()`, `.to(recipient)`, `.channel("line")`, `.count`, `.clear()`. LINE Flex
+  captures expose `body.type`, `body.altText`, and the complete `body.contents` bubble/carousel.
+  The simulator validates the Flex envelope like production; LINE itself remains responsible for
+  validating nested component layout.
 - `app.edge` — edge print/display/bindings from edge-sdk: `.prints`, `.displays`,
   `.testPrints`, `.latestPrint()`, `.latestDisplay()`, `.bindings`,
   `.seedDevices()`, `.seedPeripherals()`, `.seedBindings()`,

package/dist/index.d.mts

@@ -53,6 +53,11 @@ interface CapturedEmail {
     html?: string;
     text?: string;
     replyTo?: string;
+    /**
+     * Raw headers the sender attached, e.g. the `In-Reply-To` / `References` pair
+     * that threads a reply onto an inbound conversation. Empty when none were set.
+     */
+    headers: Record<string, string>;
     attachments: Array<{
         filename: string;
         contentType?: string;
@@ -252,6 +257,7 @@ interface CapturedMessage {
     channel: "slack" | "line" | "facebook";
     recipient: string;
     body: {
+        type?: string;
         text?: string;
         blocks?: unknown[];
         threadTs?: string;
@@ -261,6 +267,10 @@ interface CapturedMessage {
         originalContentUrl?: string;
         /** LINE image push — HTTPS URL of the preview; may be omitted when not sent. */
         previewImageUrl?: string;
+        /** LINE Flex fallback text shown when the rich card cannot be rendered. */
+        altText?: string;
+        /** Complete LINE Flex bubble or carousel payload. */
+        contents?: Record<string, unknown>;
     };
     connectionId?: string;
     sentAt: Date;

package/dist/index.d.ts

@@ -53,6 +53,11 @@ interface CapturedEmail {
     html?: string;
     text?: string;
     replyTo?: string;
+    /**
+     * Raw headers the sender attached, e.g. the `In-Reply-To` / `References` pair
+     * that threads a reply onto an inbound conversation. Empty when none were set.
+     */
+    headers: Record<string, string>;
     attachments: Array<{
         filename: string;
         contentType?: string;
@@ -252,6 +257,7 @@ interface CapturedMessage {
     channel: "slack" | "line" | "facebook";
     recipient: string;
     body: {
+        type?: string;
         text?: string;
         blocks?: unknown[];
         threadTs?: string;
@@ -261,6 +267,10 @@ interface CapturedMessage {
         originalContentUrl?: string;
         /** LINE image push — HTTPS URL of the preview; may be omitted when not sent. */
         previewImageUrl?: string;
+        /** LINE Flex fallback text shown when the rich card cannot be rendered. */
+        altText?: string;
+        /** Complete LINE Flex bubble or carousel payload. */
+        contents?: Record<string, unknown>;
     };
     connectionId?: string;
     sentAt: Date;

package/dist/index.js

@@ -660,6 +660,7 @@ async function handleEmailSend(request) {
     html: body.html ? String(body.html) : void 0,
     text: body.text ? String(body.text) : void 0,
     replyTo: body.replyTo ? String(body.replyTo) : void 0,
+    headers: { ...body.headers ?? {} },
     attachments: (body.attachments ?? []).map((a) => ({
       filename: String(a.filename ?? ""),
       contentType: a.contentType ? String(a.contentType) : void 0
@@ -2072,6 +2073,9 @@ function isValidLineImageUrl(url) {
     return false;
   }
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function captureMessage(channel, recipient, body, connectionId) {
   const message = {
     channel,
@@ -2083,7 +2087,8 @@ function captureMessage(channel, recipient, body, connectionId) {
       messagingType: body.messagingType ? String(body.messagingType) : void 0,
       tag: body.tag ? String(body.tag) : void 0,
       originalContentUrl: body.originalContentUrl ? String(body.originalContentUrl) : void 0,
-      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0
+      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0,
+      ...body.type === "flex" && isObject(body.contents) ? { type: "flex", altText: String(body.altText), contents: body.contents } : {}
     },
     connectionId,
     sentAt: /* @__PURE__ */ new Date()
@@ -2121,8 +2126,8 @@ async function handleMessagingRequest(request, channel, subPath) {
     const userId = String(body.userId ?? "");
     const message = body.message;
     if (!userId) return failure("userId is required");
-    if (!message || message.type !== "text" && message.type !== "image") {
-      return failure("message must be { type: 'text' | 'image', ... }");
+    if (!message || message.type !== "text" && message.type !== "image" && message.type !== "flex") {
+      return failure("message must be { type: 'text' | 'image' | 'flex', ... }");
     }
     const connectionId = body.connectionId ? String(body.connectionId) : void 0;
     if (message.type === "text") {
@@ -2133,7 +2138,7 @@ async function handleMessagingRequest(request, channel, subPath) {
         return failure("message text exceeds maximum length");
       }
       captureMessage("line", userId, { text: message.text }, connectionId);
-    } else {
+    } else if (message.type === "image") {
       const originalContentUrl = message.originalContentUrl;
       if (!originalContentUrl || !isValidLineImageUrl(originalContentUrl)) {
         return failure("originalContentUrl must be a valid HTTPS URL (max 2000 chars)");
@@ -2144,7 +2149,23 @@ async function handleMessagingRequest(request, channel, subPath) {
       captureMessage(
         "line",
         userId,
-        { originalContentUrl, previewImageUrl: message.previewImageUrl ?? originalContentUrl },
+        {
+          originalContentUrl,
+          previewImageUrl: message.previewImageUrl ?? originalContentUrl
+        },
+        connectionId
+      );
+    } else {
+      if (typeof message.altText !== "string" || !message.altText || message.altText.length > 400) {
+        return failure("altText must be between 1 and 400 characters");
+      }
+      if (!isObject(message.contents) || message.contents.type !== "bubble" && message.contents.type !== "carousel") {
+        return failure("contents.type must be 'bubble' or 'carousel'");
+      }
+      captureMessage(
+        "line",
+        userId,
+        { type: "flex", altText: message.altText, contents: message.contents },
         connectionId
       );
     }

package/dist/index.mjs

@@ -611,6 +611,7 @@ async function handleEmailSend(request) {
     html: body.html ? String(body.html) : void 0,
     text: body.text ? String(body.text) : void 0,
     replyTo: body.replyTo ? String(body.replyTo) : void 0,
+    headers: { ...body.headers ?? {} },
     attachments: (body.attachments ?? []).map((a) => ({
       filename: String(a.filename ?? ""),
       contentType: a.contentType ? String(a.contentType) : void 0
@@ -2023,6 +2024,9 @@ function isValidLineImageUrl(url) {
     return false;
   }
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function captureMessage(channel, recipient, body, connectionId) {
   const message = {
     channel,
@@ -2034,7 +2038,8 @@ function captureMessage(channel, recipient, body, connectionId) {
       messagingType: body.messagingType ? String(body.messagingType) : void 0,
       tag: body.tag ? String(body.tag) : void 0,
       originalContentUrl: body.originalContentUrl ? String(body.originalContentUrl) : void 0,
-      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0
+      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0,
+      ...body.type === "flex" && isObject(body.contents) ? { type: "flex", altText: String(body.altText), contents: body.contents } : {}
     },
     connectionId,
     sentAt: /* @__PURE__ */ new Date()
@@ -2072,8 +2077,8 @@ async function handleMessagingRequest(request, channel, subPath) {
     const userId = String(body.userId ?? "");
     const message = body.message;
     if (!userId) return failure("userId is required");
-    if (!message || message.type !== "text" && message.type !== "image") {
-      return failure("message must be { type: 'text' | 'image', ... }");
+    if (!message || message.type !== "text" && message.type !== "image" && message.type !== "flex") {
+      return failure("message must be { type: 'text' | 'image' | 'flex', ... }");
     }
     const connectionId = body.connectionId ? String(body.connectionId) : void 0;
     if (message.type === "text") {
@@ -2084,7 +2089,7 @@ async function handleMessagingRequest(request, channel, subPath) {
         return failure("message text exceeds maximum length");
       }
       captureMessage("line", userId, { text: message.text }, connectionId);
-    } else {
+    } else if (message.type === "image") {
       const originalContentUrl = message.originalContentUrl;
       if (!originalContentUrl || !isValidLineImageUrl(originalContentUrl)) {
         return failure("originalContentUrl must be a valid HTTPS URL (max 2000 chars)");
@@ -2095,7 +2100,23 @@ async function handleMessagingRequest(request, channel, subPath) {
       captureMessage(
         "line",
         userId,
-        { originalContentUrl, previewImageUrl: message.previewImageUrl ?? originalContentUrl },
+        {
+          originalContentUrl,
+          previewImageUrl: message.previewImageUrl ?? originalContentUrl
+        },
+        connectionId
+      );
+    } else {
+      if (typeof message.altText !== "string" || !message.altText || message.altText.length > 400) {
+        return failure("altText must be between 1 and 400 characters");
+      }
+      if (!isObject(message.contents) || message.contents.type !== "bubble" && message.contents.type !== "carousel") {
+        return failure("contents.type must be 'bubble' or 'carousel'");
+      }
+      captureMessage(
+        "line",
+        userId,
+        { type: "flex", altText: message.altText, contents: message.contents },
         connectionId
       );
     }

package/dist/setup.js

@@ -607,6 +607,7 @@ async function handleEmailSend(request) {
     html: body.html ? String(body.html) : void 0,
     text: body.text ? String(body.text) : void 0,
     replyTo: body.replyTo ? String(body.replyTo) : void 0,
+    headers: { ...body.headers ?? {} },
     attachments: (body.attachments ?? []).map((a) => ({
       filename: String(a.filename ?? ""),
       contentType: a.contentType ? String(a.contentType) : void 0
@@ -1622,6 +1623,9 @@ function isValidLineImageUrl(url) {
     return false;
   }
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function captureMessage(channel, recipient, body, connectionId) {
   const message = {
     channel,
@@ -1633,7 +1637,8 @@ function captureMessage(channel, recipient, body, connectionId) {
       messagingType: body.messagingType ? String(body.messagingType) : void 0,
       tag: body.tag ? String(body.tag) : void 0,
       originalContentUrl: body.originalContentUrl ? String(body.originalContentUrl) : void 0,
-      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0
+      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0,
+      ...body.type === "flex" && isObject(body.contents) ? { type: "flex", altText: String(body.altText), contents: body.contents } : {}
     },
     connectionId,
     sentAt: /* @__PURE__ */ new Date()
@@ -1671,8 +1676,8 @@ async function handleMessagingRequest(request, channel, subPath) {
     const userId = String(body.userId ?? "");
     const message = body.message;
     if (!userId) return failure("userId is required");
-    if (!message || message.type !== "text" && message.type !== "image") {
-      return failure("message must be { type: 'text' | 'image', ... }");
+    if (!message || message.type !== "text" && message.type !== "image" && message.type !== "flex") {
+      return failure("message must be { type: 'text' | 'image' | 'flex', ... }");
     }
     const connectionId = body.connectionId ? String(body.connectionId) : void 0;
     if (message.type === "text") {
@@ -1683,7 +1688,7 @@ async function handleMessagingRequest(request, channel, subPath) {
         return failure("message text exceeds maximum length");
       }
       captureMessage("line", userId, { text: message.text }, connectionId);
-    } else {
+    } else if (message.type === "image") {
       const originalContentUrl = message.originalContentUrl;
       if (!originalContentUrl || !isValidLineImageUrl(originalContentUrl)) {
         return failure("originalContentUrl must be a valid HTTPS URL (max 2000 chars)");
@@ -1694,7 +1699,23 @@ async function handleMessagingRequest(request, channel, subPath) {
       captureMessage(
         "line",
         userId,
-        { originalContentUrl, previewImageUrl: message.previewImageUrl ?? originalContentUrl },
+        {
+          originalContentUrl,
+          previewImageUrl: message.previewImageUrl ?? originalContentUrl
+        },
+        connectionId
+      );
+    } else {
+      if (typeof message.altText !== "string" || !message.altText || message.altText.length > 400) {
+        return failure("altText must be between 1 and 400 characters");
+      }
+      if (!isObject(message.contents) || message.contents.type !== "bubble" && message.contents.type !== "carousel") {
+        return failure("contents.type must be 'bubble' or 'carousel'");
+      }
+      captureMessage(
+        "line",
+        userId,
+        { type: "flex", altText: message.altText, contents: message.contents },
         connectionId
       );
     }

package/dist/setup.mjs

@@ -583,6 +583,7 @@ async function handleEmailSend(request) {
     html: body.html ? String(body.html) : void 0,
     text: body.text ? String(body.text) : void 0,
     replyTo: body.replyTo ? String(body.replyTo) : void 0,
+    headers: { ...body.headers ?? {} },
     attachments: (body.attachments ?? []).map((a) => ({
       filename: String(a.filename ?? ""),
       contentType: a.contentType ? String(a.contentType) : void 0
@@ -1598,6 +1599,9 @@ function isValidLineImageUrl(url) {
     return false;
   }
 }
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function captureMessage(channel, recipient, body, connectionId) {
   const message = {
     channel,
@@ -1609,7 +1613,8 @@ function captureMessage(channel, recipient, body, connectionId) {
       messagingType: body.messagingType ? String(body.messagingType) : void 0,
       tag: body.tag ? String(body.tag) : void 0,
       originalContentUrl: body.originalContentUrl ? String(body.originalContentUrl) : void 0,
-      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0
+      previewImageUrl: body.previewImageUrl ? String(body.previewImageUrl) : void 0,
+      ...body.type === "flex" && isObject(body.contents) ? { type: "flex", altText: String(body.altText), contents: body.contents } : {}
     },
     connectionId,
     sentAt: /* @__PURE__ */ new Date()
@@ -1647,8 +1652,8 @@ async function handleMessagingRequest(request, channel, subPath) {
     const userId = String(body.userId ?? "");
     const message = body.message;
     if (!userId) return failure("userId is required");
-    if (!message || message.type !== "text" && message.type !== "image") {
-      return failure("message must be { type: 'text' | 'image', ... }");
+    if (!message || message.type !== "text" && message.type !== "image" && message.type !== "flex") {
+      return failure("message must be { type: 'text' | 'image' | 'flex', ... }");
     }
     const connectionId = body.connectionId ? String(body.connectionId) : void 0;
     if (message.type === "text") {
@@ -1659,7 +1664,7 @@ async function handleMessagingRequest(request, channel, subPath) {
         return failure("message text exceeds maximum length");
       }
       captureMessage("line", userId, { text: message.text }, connectionId);
-    } else {
+    } else if (message.type === "image") {
       const originalContentUrl = message.originalContentUrl;
       if (!originalContentUrl || !isValidLineImageUrl(originalContentUrl)) {
         return failure("originalContentUrl must be a valid HTTPS URL (max 2000 chars)");
@@ -1670,7 +1675,23 @@ async function handleMessagingRequest(request, channel, subPath) {
       captureMessage(
         "line",
         userId,
-        { originalContentUrl, previewImageUrl: message.previewImageUrl ?? originalContentUrl },
+        {
+          originalContentUrl,
+          previewImageUrl: message.previewImageUrl ?? originalContentUrl
+        },
+        connectionId
+      );
+    } else {
+      if (typeof message.altText !== "string" || !message.altText || message.altText.length > 400) {
+        return failure("altText must be between 1 and 400 characters");
+      }
+      if (!isObject(message.contents) || message.contents.type !== "bubble" && message.contents.type !== "carousel") {
+        return failure("contents.type must be 'bubble' or 'carousel'");
+      }
+      captureMessage(
+        "line",
+        userId,
+        { type: "flex", altText: message.altText, contents: message.contents },
         connectionId
       );
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/testing",
-  "version": "0.10.0",
+  "version": "0.12.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",
@@ -66,7 +66,7 @@
   },
   "peerDependencies": {
     "@stardeck-customer-apps/edge-sdk": ">=1.4.0",
-    "@stardeck-customer-apps/integrations-sdk": ">=1.6.0",
+    "@stardeck-customer-apps/integrations-sdk": ">=1.13.0",
     "@stardeck-customer-apps/payments-sdk": ">=0.1.0",
     "@stardeck-customer-apps/storage-sdk": ">=0.1.0",
     "next": "^14.0.0 || ^15.0.0 || ^16.0.0",