@stardeck-customer-apps/testing 0.10.0 → 0.11.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({
@@ -288,7 +308,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

@@ -252,6 +252,7 @@ interface CapturedMessage {
     channel: "slack" | "line" | "facebook";
     recipient: string;
     body: {
+        type?: string;
         text?: string;
         blocks?: unknown[];
         threadTs?: string;
@@ -261,6 +262,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

@@ -252,6 +252,7 @@ interface CapturedMessage {
     channel: "slack" | "line" | "facebook";
     recipient: string;
     body: {
+        type?: string;
         text?: string;
         blocks?: unknown[];
         threadTs?: string;
@@ -261,6 +262,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

@@ -2072,6 +2072,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 +2086,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 +2125,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 +2137,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 +2148,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

@@ -2023,6 +2023,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 +2037,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 +2076,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 +2088,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 +2099,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

@@ -1622,6 +1622,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 +1636,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 +1675,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 +1687,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 +1698,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

@@ -1598,6 +1598,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 +1612,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 +1651,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 +1663,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 +1674,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.11.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",