@kodelyth/line 2026.5.42 → 2026.6.2

package/src/reply-chunks.test.ts

@@ -1,180 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { sendLineReplyChunks } from "./reply-chunks.js";
-
-const LINE_TEST_CFG = { channels: { line: { channelAccessToken: "line-token" } } };
-
-function createReplyChunksHarness() {
-  const replyMessageLine = vi.fn(async () => ({}));
-  const pushMessageLine = vi.fn(async () => ({}));
-  const pushTextMessageWithQuickReplies = vi.fn(async () => ({}));
-  const createTextMessageWithQuickReplies = vi.fn((text: string, _quickReplies: string[]) => ({
-    type: "text" as const,
-    text,
-  }));
-
-  return {
-    replyMessageLine,
-    pushMessageLine,
-    pushTextMessageWithQuickReplies,
-    createTextMessageWithQuickReplies,
-  };
-}
-
-describe("sendLineReplyChunks", () => {
-  it("uses reply token for all chunks when possible", async () => {
-    const {
-      replyMessageLine,
-      pushMessageLine,
-      pushTextMessageWithQuickReplies,
-      createTextMessageWithQuickReplies,
-    } = createReplyChunksHarness();
-
-    const result = await sendLineReplyChunks({
-      to: "line:group:1",
-      chunks: ["one", "two", "three"],
-      quickReplies: ["A", "B"],
-      replyToken: "token",
-      replyTokenUsed: false,
-      cfg: LINE_TEST_CFG,
-      accountId: "default",
-      replyMessageLine,
-      pushMessageLine,
-      pushTextMessageWithQuickReplies,
-      createTextMessageWithQuickReplies,
-    });
-
-    expect(result.replyTokenUsed).toBe(true);
-    expect(replyMessageLine).toHaveBeenCalledTimes(1);
-    expect(createTextMessageWithQuickReplies).toHaveBeenCalledWith("three", ["A", "B"]);
-    expect(replyMessageLine).toHaveBeenCalledWith(
-      "token",
-      [
-        { type: "text", text: "one" },
-        { type: "text", text: "two" },
-        { type: "text", text: "three" },
-      ],
-      { cfg: LINE_TEST_CFG, accountId: "default" },
-    );
-    expect(pushMessageLine).not.toHaveBeenCalled();
-    expect(pushTextMessageWithQuickReplies).not.toHaveBeenCalled();
-  });
-
-  it("attaches quick replies to a single reply chunk", async () => {
-    const { replyMessageLine, pushMessageLine, pushTextMessageWithQuickReplies } =
-      createReplyChunksHarness();
-    const createTextMessageWithQuickReplies = vi.fn((text: string, _quickReplies: string[]) => ({
-      type: "text" as const,
-      text,
-      quickReply: { items: [] },
-    }));
-
-    const result = await sendLineReplyChunks({
-      to: "line:user:1",
-      chunks: ["only"],
-      quickReplies: ["A"],
-      replyToken: "token",
-      replyTokenUsed: false,
-      cfg: LINE_TEST_CFG,
-      replyMessageLine,
-      pushMessageLine,
-      pushTextMessageWithQuickReplies,
-      createTextMessageWithQuickReplies,
-    });
-
-    expect(result.replyTokenUsed).toBe(true);
-    expect(createTextMessageWithQuickReplies).toHaveBeenCalledWith("only", ["A"]);
-    expect(replyMessageLine).toHaveBeenCalledTimes(1);
-    expect(pushMessageLine).not.toHaveBeenCalled();
-    expect(pushTextMessageWithQuickReplies).not.toHaveBeenCalled();
-  });
-
-  it("replies with up to five chunks before pushing the rest", async () => {
-    const {
-      replyMessageLine,
-      pushMessageLine,
-      pushTextMessageWithQuickReplies,
-      createTextMessageWithQuickReplies,
-    } = createReplyChunksHarness();
-
-    const chunks = ["1", "2", "3", "4", "5", "6", "7"];
-    const result = await sendLineReplyChunks({
-      to: "line:group:1",
-      chunks,
-      quickReplies: ["A"],
-      replyToken: "token",
-      replyTokenUsed: false,
-      cfg: LINE_TEST_CFG,
-      replyMessageLine,
-      pushMessageLine,
-      pushTextMessageWithQuickReplies,
-      createTextMessageWithQuickReplies,
-    });
-
-    expect(result.replyTokenUsed).toBe(true);
-    expect(replyMessageLine).toHaveBeenCalledTimes(1);
-    expect(replyMessageLine).toHaveBeenCalledWith(
-      "token",
-      [
-        { type: "text", text: "1" },
-        { type: "text", text: "2" },
-        { type: "text", text: "3" },
-        { type: "text", text: "4" },
-        { type: "text", text: "5" },
-      ],
-      { cfg: LINE_TEST_CFG, accountId: undefined },
-    );
-    expect(pushMessageLine).toHaveBeenCalledTimes(1);
-    expect(pushMessageLine).toHaveBeenCalledWith("line:group:1", "6", {
-      cfg: LINE_TEST_CFG,
-      accountId: undefined,
-    });
-    expect(pushTextMessageWithQuickReplies).toHaveBeenCalledTimes(1);
-    expect(pushTextMessageWithQuickReplies).toHaveBeenCalledWith("line:group:1", "7", ["A"], {
-      cfg: LINE_TEST_CFG,
-      accountId: undefined,
-    });
-    expect(createTextMessageWithQuickReplies).not.toHaveBeenCalled();
-  });
-
-  it("falls back to push flow when replying fails", async () => {
-    const {
-      replyMessageLine,
-      pushMessageLine,
-      pushTextMessageWithQuickReplies,
-      createTextMessageWithQuickReplies,
-    } = createReplyChunksHarness();
-    const onReplyError = vi.fn();
-    const replyError = new Error("reply failed");
-    replyMessageLine.mockRejectedValueOnce(replyError);
-
-    const result = await sendLineReplyChunks({
-      to: "line:group:1",
-      chunks: ["1", "2", "3"],
-      quickReplies: ["A"],
-      replyToken: "token",
-      replyTokenUsed: false,
-      cfg: LINE_TEST_CFG,
-      accountId: "default",
-      replyMessageLine,
-      pushMessageLine,
-      pushTextMessageWithQuickReplies,
-      createTextMessageWithQuickReplies,
-      onReplyError,
-    });
-
-    expect(result.replyTokenUsed).toBe(true);
-    expect(onReplyError).toHaveBeenCalledWith(replyError);
-    expect(pushMessageLine).toHaveBeenNthCalledWith(1, "line:group:1", "1", {
-      cfg: LINE_TEST_CFG,
-      accountId: "default",
-    });
-    expect(pushMessageLine).toHaveBeenNthCalledWith(2, "line:group:1", "2", {
-      cfg: LINE_TEST_CFG,
-      accountId: "default",
-    });
-    expect(pushTextMessageWithQuickReplies).toHaveBeenCalledWith("line:group:1", "3", ["A"], {
-      cfg: LINE_TEST_CFG,
-      accountId: "default",
-    });
-  });
-});

package/src/reply-chunks.ts

@@ -1,110 +0,0 @@
-import type { messagingApi } from "@line/bot-sdk";
-import type { KlawConfig } from "klaw/plugin-sdk/config-contracts";
-
-type LineReplyMessage = messagingApi.TextMessage;
-
-export type SendLineReplyChunksParams = {
-  to: string;
-  chunks: string[];
-  quickReplies?: string[];
-  replyToken?: string | null;
-  replyTokenUsed?: boolean;
-  cfg: KlawConfig;
-  accountId?: string;
-  replyMessageLine: (
-    replyToken: string,
-    messages: messagingApi.Message[],
-    opts: { cfg: KlawConfig; accountId?: string },
-  ) => Promise<unknown>;
-  pushMessageLine: (
-    to: string,
-    text: string,
-    opts: { cfg: KlawConfig; accountId?: string },
-  ) => Promise<unknown>;
-  pushTextMessageWithQuickReplies: (
-    to: string,
-    text: string,
-    quickReplies: string[],
-    opts: { cfg: KlawConfig; accountId?: string },
-  ) => Promise<unknown>;
-  createTextMessageWithQuickReplies: (text: string, quickReplies: string[]) => LineReplyMessage;
-  onReplyError?: (err: unknown) => void;
-};
-
-export async function sendLineReplyChunks(
-  params: SendLineReplyChunksParams,
-): Promise<{ replyTokenUsed: boolean }> {
-  const hasQuickReplies = Boolean(params.quickReplies?.length);
-  let replyTokenUsed = Boolean(params.replyTokenUsed);
-
-  if (params.chunks.length === 0) {
-    return { replyTokenUsed };
-  }
-
-  if (params.replyToken && !replyTokenUsed) {
-    try {
-      const replyBatch = params.chunks.slice(0, 5);
-      const remaining = params.chunks.slice(replyBatch.length);
-
-      const replyMessages: LineReplyMessage[] = replyBatch.map((chunk) => ({
-        type: "text",
-        text: chunk,
-      }));
-
-      if (hasQuickReplies && remaining.length === 0 && replyMessages.length > 0) {
-        const lastIndex = replyMessages.length - 1;
-        replyMessages[lastIndex] = params.createTextMessageWithQuickReplies(
-          replyBatch[lastIndex],
-          params.quickReplies!,
-        );
-      }
-
-      await params.replyMessageLine(params.replyToken, replyMessages, {
-        cfg: params.cfg,
-        accountId: params.accountId,
-      });
-      replyTokenUsed = true;
-
-      for (let i = 0; i < remaining.length; i += 1) {
-        const isLastChunk = i === remaining.length - 1;
-        if (isLastChunk && hasQuickReplies) {
-          await params.pushTextMessageWithQuickReplies(
-            params.to,
-            remaining[i],
-            params.quickReplies!,
-            { cfg: params.cfg, accountId: params.accountId },
-          );
-        } else {
-          await params.pushMessageLine(params.to, remaining[i], {
-            cfg: params.cfg,
-            accountId: params.accountId,
-          });
-        }
-      }
-
-      return { replyTokenUsed };
-    } catch (err) {
-      params.onReplyError?.(err);
-      replyTokenUsed = true;
-    }
-  }
-
-  for (let i = 0; i < params.chunks.length; i += 1) {
-    const isLastChunk = i === params.chunks.length - 1;
-    if (isLastChunk && hasQuickReplies) {
-      await params.pushTextMessageWithQuickReplies(
-        params.to,
-        params.chunks[i],
-        params.quickReplies!,
-        { cfg: params.cfg, accountId: params.accountId },
-      );
-    } else {
-      await params.pushMessageLine(params.to, params.chunks[i], {
-        cfg: params.cfg,
-        accountId: params.accountId,
-      });
-    }
-  }
-
-  return { replyTokenUsed };
-}

package/src/reply-payload-transform.test.ts

@@ -1,392 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { hasLineDirectives, parseLineDirectives } from "./reply-payload-transform.js";
-
-const getLineData = (result: ReturnType<typeof parseLineDirectives>) =>
-  (result.channelData?.line as Record<string, unknown> | undefined) ?? {};
-
-type TestFlexMessage = {
-  altText?: string;
-  contents?: { footer?: { contents?: unknown[] }; body?: { contents?: unknown[] } };
-};
-
-function requireFlexMessage(value: unknown, label: string): TestFlexMessage {
-  if (!value || typeof value !== "object") {
-    throw new Error(`expected flex message for ${label}`);
-  }
-  return value as TestFlexMessage;
-}
-
-describe("hasLineDirectives", () => {
-  it("matches expected detection across directive patterns", () => {
-    const cases: Array<{ text: string; expected: boolean }> = [
-      { text: "Here are options [[quick_replies: A, B, C]]", expected: true },
-      { text: "[[location: Place | Address | 35.6 | 139.7]]", expected: true },
-      { text: "[[confirm: Continue? | Yes | No]]", expected: true },
-      { text: "[[buttons: Menu | Choose | Opt1:data1, Opt2:data2]]", expected: true },
-      { text: "Just regular text", expected: false },
-      { text: "[[not_a_directive: something]]", expected: false },
-      { text: "[[media_player: Song | Artist | Speaker]]", expected: true },
-      { text: "[[event: Meeting | Jan 24 | 2pm]]", expected: true },
-      { text: "[[agenda: Today | Meeting:9am, Lunch:12pm]]", expected: true },
-      { text: "[[device: TV | Room]]", expected: true },
-      { text: "[[appletv_remote: Apple TV | Playing]]", expected: true },
-    ];
-
-    for (const testCase of cases) {
-      expect(hasLineDirectives(testCase.text)).toBe(testCase.expected);
-    }
-  });
-});
-
-describe("parseLineDirectives", () => {
-  describe("quick_replies", () => {
-    it("parses quick replies variants", () => {
-      const cases: Array<{
-        text: string;
-        channelData?: { line: { quickReplies: string[] } };
-        quickReplies: string[];
-        outputText?: string;
-      }> = [
-        {
-          text: "Choose one:\n[[quick_replies: Option A, Option B, Option C]]",
-          quickReplies: ["Option A", "Option B", "Option C"],
-          outputText: "Choose one:",
-        },
-        {
-          text: "Before [[quick_replies: A, B]] After",
-          quickReplies: ["A", "B"],
-          outputText: "Before  After",
-        },
-        {
-          text: "Text [[quick_replies: C, D]]",
-          channelData: { line: { quickReplies: ["A", "B"] } },
-          quickReplies: ["A", "B", "C", "D"],
-          outputText: "Text",
-        },
-      ];
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({
-          text: testCase.text,
-          channelData: testCase.channelData,
-        });
-        expect(getLineData(result).quickReplies).toEqual(testCase.quickReplies);
-        if (testCase.outputText !== undefined) {
-          expect(result.text).toBe(testCase.outputText);
-        }
-      }
-    });
-  });
-
-  describe("location", () => {
-    it("parses location variants", () => {
-      const existing = { title: "Existing", address: "Addr", latitude: 1, longitude: 2 };
-      const cases: Array<{
-        text: string;
-        channelData?: { line: { location: typeof existing } };
-        location?: typeof existing;
-        outputText?: string;
-      }> = [
-        {
-          text: "Here's the location:\n[[location: Tokyo Station | Tokyo, Japan | 35.6812 | 139.7671]]",
-          location: {
-            title: "Tokyo Station",
-            address: "Tokyo, Japan",
-            latitude: 35.6812,
-            longitude: 139.7671,
-          },
-          outputText: "Here's the location:",
-        },
-        {
-          text: "[[location: Place | Address | invalid | 139.7]]",
-          location: undefined,
-        },
-        {
-          text: "[[location: New | New Addr | 35.6 | 139.7]]",
-          channelData: { line: { location: existing } },
-          location: existing,
-        },
-      ];
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({
-          text: testCase.text,
-          channelData: testCase.channelData,
-        });
-        expect(getLineData(result).location).toEqual(testCase.location);
-        if (testCase.outputText !== undefined) {
-          expect(result.text).toBe(testCase.outputText);
-        }
-      }
-    });
-  });
-
-  describe("confirm", () => {
-    it("parses confirm directives with default and custom action payloads", () => {
-      const cases = [
-        {
-          name: "default yes/no data",
-          text: "[[confirm: Delete this item? | Yes | No]]",
-          expectedTemplate: {
-            type: "confirm",
-            text: "Delete this item?",
-            confirmLabel: "Yes",
-            confirmData: "yes",
-            cancelLabel: "No",
-            cancelData: "no",
-            altText: "Delete this item?",
-          },
-          expectedText: undefined,
-        },
-        {
-          name: "custom action data",
-          text: "[[confirm: Proceed? | OK:action=confirm | Cancel:action=cancel]]",
-          expectedTemplate: {
-            type: "confirm",
-            text: "Proceed?",
-            confirmLabel: "OK",
-            confirmData: "action=confirm",
-            cancelLabel: "Cancel",
-            cancelData: "action=cancel",
-            altText: "Proceed?",
-          },
-          expectedText: undefined,
-        },
-      ] as const;
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({ text: testCase.text });
-        expect(getLineData(result).templateMessage, testCase.name).toEqual(
-          testCase.expectedTemplate,
-        );
-        expect(result.text, testCase.name).toBe(testCase.expectedText);
-      }
-    });
-  });
-
-  describe("buttons", () => {
-    it("parses message/uri/postback button actions and enforces action caps", () => {
-      const cases = [
-        {
-          name: "message actions",
-          text: "[[buttons: Menu | Select an option | Help:/help, Status:/status]]",
-          expectedTemplate: {
-            type: "buttons",
-            title: "Menu",
-            text: "Select an option",
-            actions: [
-              { type: "message", label: "Help", data: "/help" },
-              { type: "message", label: "Status", data: "/status" },
-            ],
-            altText: "Menu: Select an option",
-          },
-        },
-        {
-          name: "uri action",
-          text: "[[buttons: Links | Visit us | Site:https://example.com]]",
-          expectedFirstAction: {
-            type: "uri",
-            label: "Site",
-            uri: "https://example.com",
-          },
-        },
-        {
-          name: "postback action",
-          text: "[[buttons: Actions | Choose | Select:action=select&id=1]]",
-          expectedFirstAction: {
-            type: "postback",
-            label: "Select",
-            data: "action=select&id=1",
-          },
-        },
-        {
-          name: "action cap",
-          text: "[[buttons: Menu | Text | A:a, B:b, C:c, D:d, E:e, F:f]]",
-          expectedActionCount: 4,
-        },
-      ] as const;
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({ text: testCase.text });
-        const templateMessage = getLineData(result).templateMessage as {
-          type?: string;
-          actions?: Array<Record<string, unknown>>;
-        };
-        expect(templateMessage?.type, testCase.name).toBe("buttons");
-        if ("expectedTemplate" in testCase) {
-          expect(templateMessage, testCase.name).toEqual(testCase.expectedTemplate);
-        }
-        if ("expectedFirstAction" in testCase) {
-          expect(templateMessage?.actions?.[0], testCase.name).toEqual(
-            testCase.expectedFirstAction,
-          );
-        }
-        if ("expectedActionCount" in testCase) {
-          expect(templateMessage?.actions?.length, testCase.name).toBe(
-            testCase.expectedActionCount,
-          );
-        }
-      }
-    });
-  });
-
-  describe("media_player", () => {
-    it("parses media_player directives across full/minimal/paused variants", () => {
-      const cases = [
-        {
-          name: "all fields",
-          text: "Now playing:\n[[media_player: Bohemian Rhapsody | Queen | Speaker | https://example.com/album.jpg | playing]]",
-          expectedAltText: "🎵 Bohemian Rhapsody - Queen",
-          expectedText: "Now playing:",
-          expectFooter: true,
-          expectBodyContents: false,
-        },
-        {
-          name: "minimal",
-          text: "[[media_player: Unknown Track]]",
-          expectedAltText: "🎵 Unknown Track",
-          expectedText: undefined,
-          expectFooter: false,
-          expectBodyContents: false,
-        },
-        {
-          name: "paused status",
-          text: "[[media_player: Song | Artist | Player | | paused]]",
-          expectedAltText: undefined,
-          expectedText: undefined,
-          expectFooter: false,
-          expectBodyContents: true,
-        },
-      ] as const;
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({ text: testCase.text });
-        const flexMessage = requireFlexMessage(getLineData(result).flexMessage, testCase.name);
-        if (testCase.expectedAltText !== undefined) {
-          expect(flexMessage.altText, testCase.name).toBe(testCase.expectedAltText);
-        }
-        if (testCase.expectedText !== undefined) {
-          expect(result.text, testCase.name).toBe(testCase.expectedText);
-        }
-        if (testCase.expectFooter) {
-          expect(flexMessage.contents?.footer?.contents?.length, testCase.name).toBeGreaterThan(0);
-        }
-        if ("expectBodyContents" in testCase && testCase.expectBodyContents) {
-          expect(Array.isArray(flexMessage.contents?.body?.contents), testCase.name).toBe(true);
-          expect(flexMessage.contents?.body?.contents?.length, testCase.name).toBeGreaterThan(0);
-        }
-      }
-    });
-  });
-
-  describe("event", () => {
-    it("parses event variants", () => {
-      const cases = [
-        {
-          text: "[[event: Team Meeting | January 24, 2026 | 2:00 PM - 3:00 PM | Conference Room A | Discuss Q1 roadmap]]",
-          altText: "📅 Team Meeting - January 24, 2026 2:00 PM - 3:00 PM",
-        },
-        {
-          text: "[[event: Birthday Party | March 15]]",
-          altText: "📅 Birthday Party - March 15",
-        },
-      ];
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({ text: testCase.text });
-        const flexMessage = requireFlexMessage(getLineData(result).flexMessage, testCase.text);
-        expect(flexMessage.altText).toBe(testCase.altText);
-      }
-    });
-  });
-
-  describe("agenda", () => {
-    it("parses agenda variants", () => {
-      const cases = [
-        {
-          text: "[[agenda: Today's Schedule | Team Meeting:9:00 AM, Lunch:12:00 PM, Review:3:00 PM]]",
-          altText: "📋 Today's Schedule (3 events)",
-        },
-        {
-          text: "[[agenda: Tasks | Buy groceries, Call mom, Workout]]",
-          altText: "📋 Tasks (3 events)",
-        },
-      ];
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({ text: testCase.text });
-        const flexMessage = requireFlexMessage(getLineData(result).flexMessage, testCase.text);
-        expect(flexMessage.altText).toBe(testCase.altText);
-      }
-    });
-  });
-
-  describe("device", () => {
-    it("parses device variants", () => {
-      const cases = [
-        {
-          text: "[[device: TV | Streaming Box | Playing | Play/Pause:toggle, Menu:menu]]",
-          altText: "📱 TV: Playing",
-        },
-        {
-          text: "[[device: Speaker]]",
-          altText: "📱 Speaker",
-        },
-      ];
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({ text: testCase.text });
-        const flexMessage = requireFlexMessage(getLineData(result).flexMessage, testCase.text);
-        expect(flexMessage.altText).toBe(testCase.altText);
-      }
-    });
-  });
-
-  describe("appletv_remote", () => {
-    it("parses appletv remote variants", () => {
-      const cases = [
-        {
-          text: "[[appletv_remote: Apple TV | Playing]]",
-          contains: "Apple TV",
-        },
-        {
-          text: "[[appletv_remote: Apple TV]]",
-          contains: undefined,
-        },
-      ];
-
-      for (const testCase of cases) {
-        const result = parseLineDirectives({ text: testCase.text });
-        const flexMessage = requireFlexMessage(getLineData(result).flexMessage, testCase.text);
-        if (testCase.contains) {
-          expect(flexMessage.altText).toContain(testCase.contains);
-        }
-      }
-    });
-  });
-
-  describe("combined directives", () => {
-    it("handles text with no directives", () => {
-      const result = parseLineDirectives({
-        text: "Just plain text here",
-      });
-
-      expect(result.text).toBe("Just plain text here");
-      expect(getLineData(result).quickReplies).toBeUndefined();
-      expect(getLineData(result).location).toBeUndefined();
-      expect(getLineData(result).templateMessage).toBeUndefined();
-    });
-
-    it("preserves other payload fields", () => {
-      const result = parseLineDirectives({
-        text: "Hello [[quick_replies: A, B]]",
-        mediaUrl: "https://example.com/image.jpg",
-        replyToId: "msg123",
-      });
-
-      expect(result.mediaUrl).toBe("https://example.com/image.jpg");
-      expect(result.replyToId).toBe("msg123");
-      expect(getLineData(result).quickReplies).toEqual(["A", "B"]);
-    });
-  });
-});