@theokit/gateway-line 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,45 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.3
4
+
5
+ ### Patch Changes
6
+
7
+ - 8cbf136: **Every published export now carries documentation.** Forty-seven public symbols shipped with no docblock at all, so a consumer hovering `DiscordAdapter`, `SlackAdapter`, `WhatsAppCloudBackend`, `ThreadStore` or any of the error classes got an empty tooltip. Coverage across the eleven packages went from 71.2% to 100% (163/163), measured over the published declarations rather than the source, because a docblock is not documentation until it survives the build.
8
+
9
+ The text says what each symbol is for and what constrains it, not what its name already says. `TelegramAdapter` records that a bot cannot enumerate its chats nor speak into one that has not spoken first. `DiscordAdapter` records that reading message content needs a privileged intent enabled in the developer portal, without which every `event.text` arrives empty and nothing says why. `WhatsAppWebBackend` records that it is unofficial and can get a number banned. `shouldDispatchSyncEvent` records that Matrix replays history on sync, which is why a freshly started bot would otherwise answer every message it can still see.
10
+
11
+ **`gateway-slack`'s README documented a type that does not exist.** Its usage example imported `GatewayMessageEvent` from `@theokit/gateway`. That name is an internal alias inside the Discord and Telegram adapters (`MessageEvent as GatewayMessageEvent`), never an export. A reader who copied the example got code that did not compile. It now imports `MessageEvent`, which is what `onInbound` actually hands the handler.
12
+
13
+ Two docblocks that attached to nothing were reattached: `acquirePidLock` in `gateway-whatsapp` had its documentation stranded thirty lines above, over a different function, and shipped undocumented as a result.
14
+
15
+ - 82a5099: **A webhook dispatch that rejects no longer ends the process.** Both servers answer the provider before running the handler — deliberately, because LINE and the SMS providers retry a webhook they did not see a 200 for, and waiting on a slow handler turns latency into a duplicate delivery. The cost of answering early is that the dispatch is floated, and a floated rejection is an unhandled one, which terminates Node. It is now caught and written to stderr.
16
+
17
+ This is the same defect that was fixed across the other adapters in #41; these two were missed because the gate that catches it only recognised the shape `void this.…`, and both float through a local (`void adapter.dispatch…`). The gate now matches any floated call, which is how these two surfaced.
18
+
19
+ - b8ef098: **Every package now ships the licence it declares.** All twelve manifests in this repository declare `Apache-2.0`, and the repository had no `LICENSE` file at all — not at the root, and not in any package directory except `gateway-email`. So each published tarball asserted a licence while carrying none of its terms, and §4(a) of that licence requires a copy to travel with the distribution. Worse than a missing file: with no licence text anywhere, everything outside the manifests fell back to default copyright, which grants a recipient nothing.
20
+
21
+ The text is now at the repository root and inside every publishable package, byte-identical to the canonical Apache License 2.0 with the appendix filled in (`Copyright 2026 usetheo.dev`). The one pre-existing copy, in `gateway-email`, was replaced along with the rest: it carried the same truncated paragraph 4(d) found across the ecosystem, dropping "reasonable and customary use" from the NOTICE clause — a modified body under an unmodified SPDX identifier.
22
+
23
+ **The repository moved to the official `usetheokit` organization.** Existing clones and published URLs keep working through GitHub's permanent redirect; the root manifest now declares `Apache-2.0` explicitly rather than leaving the workspace root silent.
24
+
25
+ - 5bae032: Six defects that broke real conversations, found by testing the adapters against the live platforms instead of against fakes.
26
+
27
+ **LINE — no outbound message was ever delivered.** The adapter called the v9 SDK client with positional arguments while that client takes a single request object, so LINE received an empty request and rejected every send with a 400. Upgrade if you use this adapter at all: nothing it sent reached anyone.
28
+
29
+ **Telegram — the bot froze on long replies.** Any message over 4096 characters that began with an unclosed code span (a stray backtick) put the splitter into an infinite loop, hanging the process until it ran out of memory. Long agent answers now split correctly whatever markdown they contain.
30
+
31
+ **Mattermost — long messages silently vanished.** The adapter never split anything, so any reply over 16,383 characters was rejected by the server and the user simply saw nothing. Long replies are now split into parts Mattermost accepts.
32
+
33
+ **SMS — long messages were rejected from the hundredth part onward.** The `(i/N)` prefix outgrew the space reserved for it, pushing every later part past the provider's limit.
34
+
35
+ **Matrix and LINE — `connect()` reported success with an invalid token.** Both now verify the credential with the server before returning `true`, so a wrong token fails at startup instead of silently receiving nothing forever.
36
+
37
+ **Email and Teams — the bot could go permanently deaf.** Replacing an inbound handler and then disposing of the previous one removed the new handler as well, and the gateway stopped receiving messages with nothing logged.
38
+
39
+ Also: a `pre_inbound` hook that threw put its raw error text into the user's chat, which could expose internal details such as connection strings or tokens. Users now see only which hook failed; the detail goes to the server log, redacted.
40
+
41
+ WhatsApp additionally stops opening a second session when `connect()` is called twice, and its group mention filter no longer treats unrelated digits scattered through a message as a mention of the bot.
42
+
3
43
  ## 0.1.2
4
44
 
5
45
  ### Patch Changes
package/dist/index.cjs CHANGED
@@ -366,7 +366,11 @@ function handlerFactory(adapter) {
366
366
  res.status(400).type("text/plain").send("missing 'events' array");
367
367
  return;
368
368
  }
369
- void adapter.dispatchWebhookBody(envelope);
369
+ void adapter.dispatchWebhookBody(envelope).catch((err) => {
370
+ const message = err instanceof Error ? err.message : String(err);
371
+ process.stderr.write(`[gateway-line] webhook dispatch failed: ${message}
372
+ `);
373
+ });
370
374
  res.status(200).end();
371
375
  };
372
376
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/normalize.ts","../src/reply-cache.ts","../src/split.ts","../src/adapter.ts","../src/signature.ts","../src/webhook-server.ts"],"names":["GatewayConfigurationError","chunkByGrapheme","BasePlatformAdapter","crypto"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-line`.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2) — only the package prefix is package-specific. Name,\n * message shape, `code`/`detail` fields, and `instanceof` are byte-identical\n * to the previous hand-rolled class (pinned by `tests/errors.test.ts`).\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-line\", opts);\n }\n}\n\nexport class SDKNotInstalledError extends ConfigurationError {\n constructor(pkgName: string) {\n super({\n code: \"sdk_not_installed\",\n message: `gateway-line: peer-dep \"${pkgName}\" not installed. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * Lazy `@line/bot-sdk` loader + thin Client wrapper for sending.\n */\n\nimport { SDKNotInstalledError } from \"./errors.js\";\n\nexport interface LineSdkClient {\n replyMessage(\n replyToken: string,\n messages: Array<{ type: \"text\"; text: string }>,\n ): Promise<unknown>;\n pushMessage(to: string, messages: Array<{ type: \"text\"; text: string }>): Promise<unknown>;\n /**\n * `GET /v2/bot/info` — the cheapest call that makes LINE judge the token.\n *\n * `connect()` needs it because building a client performs no I/O at all: it\n * would otherwise report success for any string, and the operator would find\n * out at the first send. Telegram, Discord, Slack and Mattermost all surface a\n * bad credential from connect(); Matrix did not until 2026-08-17, and this was\n * the second adapter with the same gap.\n */\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n}\n\n/**\n * The v9 `MessagingApiClient` surface, as declared by the installed\n * `@line/bot-sdk` v9 `messagingApiClient.d.ts`. Both methods take ONE request\n * object — this is not the same shape as {@link LineSdkClient}, and conflating\n * the two is what broke every outbound message before 2026-08-17.\n */\ninterface LineV9Client {\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n replyMessage(request: {\n replyToken: string;\n messages: Array<{ type: \"text\"; text: string }>;\n }): Promise<unknown>;\n pushMessage(\n request: { to: string; messages: Array<{ type: \"text\"; text: string }> },\n xLineRetryKey?: string,\n ): Promise<unknown>;\n}\n\ninterface LineSdkModule {\n Client: new (cfg: { channelAccessToken: string; channelSecret?: string }) => LineSdkClient;\n messagingApi?: {\n MessagingApiClient: new (cfg: { channelAccessToken: string }) => LineV9Client;\n };\n}\n\nexport async function loadLineSdk(): Promise<LineSdkModule> {\n try {\n const mod = await import(\"@line/bot-sdk\");\n return mod as unknown as LineSdkModule;\n } catch {\n throw new SDKNotInstalledError(\"@line/bot-sdk\");\n }\n}\n\n/**\n * Build a client exposing the positional {@link LineSdkClient} shape the adapter\n * calls, from either the legacy (`Client`) or the v9\n * (`messagingApi.MessagingApiClient`) SDK.\n *\n * The v9 client is WRAPPED, not returned directly. An earlier version returned\n * it as-is on the claim that \"v9 SDK exposes both styles\" — it does not. v9\n * declares `replyMessage(request)` and `pushMessage(request, retryKey?)`, each\n * taking a single object, so the adapter's positional call arrived as\n * `{replyToken: undefined, messages: undefined}` and LINE rejected every send\n * with a 400. Since `@line/bot-sdk` is pinned at `^9.0.0`, this branch is the\n * one that always runs: the bug was total, not conditional.\n */\nexport function makeClient(\n mod: LineSdkModule,\n cfg: { channelAccessToken: string; channelSecret: string },\n): LineSdkClient {\n const v9 = mod.messagingApi?.MessagingApiClient;\n if (v9 !== undefined) {\n const client = new v9({ channelAccessToken: cfg.channelAccessToken });\n return {\n async replyMessage(replyToken, messages) {\n return client.replyMessage({ replyToken, messages });\n },\n async pushMessage(to, messages) {\n return client.pushMessage({ to, messages });\n },\n async getBotInfo() {\n return client.getBotInfo();\n },\n };\n }\n return new mod.Client(cfg);\n}\n","/**\n * Inbound normalization: LINE webhook event → LineMessageEvent.\n *\n * EC-4 absorbed: LINE webhook delivers 9 event types. Only `message`\n * events of `text` type are dispatched in v0.1; other types (`follow`,\n * `unfollow`, `postback`, image/audio/sticker messages, etc.) return\n * `undefined` so `adapter.dispatchEvent` skips them silently.\n *\n * D410: source.type mapping `user` → `dm`; `group`/`room` → `group`.\n */\n\nimport type { LineMessageEvent } from \"@theokit/gateway\";\n\nimport type { LineWebhookEvent } from \"./types.js\";\n\nexport function mapSourceType(sourceType: string): \"dm\" | \"group\" | \"thread\" {\n if (sourceType === \"user\") return \"dm\";\n return \"group\";\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: EC-4 event-type filter + source-shape narrowing + mentionee extraction are intentionally co-located so the dispatch contract stays linear.\nexport function lineEventToMessageEvent(event: LineWebhookEvent): LineMessageEvent | undefined {\n // EC-4: filter at the top — non-message events have undefined fields downstream.\n if (event.type !== \"message\") return undefined;\n if (event.message === undefined) return undefined;\n if (event.message.type !== \"text\") return undefined;\n\n const source = event.source;\n if (source === undefined) return undefined;\n\n const sourceId = source.userId ?? source.groupId ?? source.roomId;\n const sourceType = source.type as \"user\" | \"group\" | \"room\";\n if (sourceId === undefined || sourceId.length === 0) return undefined;\n\n const channelId = source.groupId ?? source.roomId ?? source.userId ?? sourceId;\n const channelType = mapSourceType(sourceType);\n\n const mentionees: string[] = [];\n for (const m of event.message.mentionees ?? []) {\n if (m.userId !== undefined && m.userId.length > 0) mentionees.push(m.userId);\n }\n\n return {\n id: event.message.id ?? `line-${event.timestamp ?? Date.now()}`,\n platform: \"line\",\n sender: source.userId !== undefined ? { id: source.userId } : { id: sourceId },\n channel: { id: channelId, type: channelType },\n text: event.message.text ?? \"\",\n receivedAt: event.timestamp ?? Date.now(),\n line: {\n sourceType,\n sourceId,\n messageId: event.message.id ?? \"\",\n mentionees,\n ...(event.replyToken !== undefined ? { replyToken: event.replyToken } : {}),\n raw: event,\n },\n };\n}\n","/**\n * Reply-token LRU cache (D407).\n *\n * `put(userId, token)` — store with 60s TTL.\n * `take(userId)` — atomic one-shot consume; second call returns undefined.\n * `evictExpired()` — periodic GC; called internally before each take.\n *\n * Capacity 1000; oldest dropped when full.\n */\n\nconst DEFAULT_TTL_MS = 60_000;\nconst DEFAULT_CAPACITY = 1000;\n\ninterface Entry {\n token: string;\n expiresAt: number;\n}\n\nexport class ReplyTokenCache {\n private readonly cache = new Map<string, Entry>();\n private readonly ttlMs: number;\n private readonly capacity: number;\n\n constructor(opts?: { ttlMs?: number; capacity?: number }) {\n this.ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;\n this.capacity = opts?.capacity ?? DEFAULT_CAPACITY;\n }\n\n put(userId: string, token: string): void {\n if (this.cache.size >= this.capacity) this.evictOldest();\n this.cache.set(userId, { token, expiresAt: Date.now() + this.ttlMs });\n }\n\n take(userId: string): string | undefined {\n const entry = this.cache.get(userId);\n if (entry === undefined) return undefined;\n this.cache.delete(userId);\n if (Date.now() >= entry.expiresAt) return undefined;\n return entry.token;\n }\n\n size(): number {\n return this.cache.size;\n }\n\n clear(): void {\n this.cache.clear();\n }\n\n private evictOldest(): void {\n const firstKey = this.cache.keys().next().value;\n if (firstKey !== undefined) this.cache.delete(firstKey);\n }\n}\n","/**\n * Grapheme-cluster-safe split for LINE outbound text (D411, EC-7).\n *\n * LINE limits text messages to 5000 chars. Thin wrapper over core\n * `chunkByGrapheme` (roadmap M1) — single-sources the `Intl.Segmenter` grapheme\n * walk so emoji, regional indicators, and combining sequences are never severed.\n * Output is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\nexport function splitForLine(text: string, limit = 5000): string[] {\n return chunkByGrapheme(text, { limit });\n}\n","/**\n * `LineAdapter` — implements BasePlatformAdapter over LINE Messaging API.\n * ADRs D405-D412.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\n\nimport { type LineSdkClient, loadLineSdk, makeClient } from \"./client.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { lineEventToMessageEvent } from \"./normalize.js\";\nimport { ReplyTokenCache } from \"./reply-cache.js\";\nimport { splitForLine } from \"./split.js\";\nimport type { LineAdapterOptions, LineWebhookEnvelope, LineWebhookEvent } from \"./types.js\";\n\nexport class LineAdapter extends BasePlatformAdapter {\n readonly platform = \"line\" as const;\n private readonly opts: LineAdapterOptions;\n private readonly replyCache = new ReplyTokenCache();\n private client: LineSdkClient | undefined;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n\n constructor(opts: LineAdapterOptions) {\n super();\n if (opts.channelSecret.length === 0) {\n throw new ConfigurationError({\n code: \"channel_secret_required\",\n message:\n \"gateway-line: opts.channelSecret is empty (D408 requires signing — no insecure mode)\",\n });\n }\n if (opts.channelAccessToken.length === 0) {\n throw new ConfigurationError({\n code: \"access_token_required\",\n message: \"gateway-line: opts.channelAccessToken is empty\",\n });\n }\n this.opts = opts;\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n const factory = this.opts.__clientFactory;\n if (factory === undefined) {\n const mod = await loadLineSdk();\n this.client = makeClient(mod, {\n channelAccessToken: this.opts.channelAccessToken,\n channelSecret: this.opts.channelSecret,\n });\n } else {\n this.client = factory() as LineSdkClient;\n }\n // Validate the credential before reporting success. Building the client\n // performs NO network I/O, so without this connect() answered true for any\n // string and the failure surfaced only at the first send — as a 401 that\n // looks like a send bug rather than a bad token.\n await this.client.getBotInfo();\n this.connected = true;\n return true;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] connect failed: ${msg}\\n`);\n return false;\n }\n }\n\n async disconnect(): Promise<void> {\n this.connected = false;\n this.client = undefined;\n this.inboundHandler = undefined;\n this.replyCache.clear();\n }\n\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: reply-token-vs-push selection + multipart loop + per-part error mapping is one cohesive send pipeline (D407 + D411); splitting hurts traceability.\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"LineAdapter.connect() not called\" },\n };\n }\n // For DMs: channel.id IS the userId. For groups/rooms: channel.id is groupId/roomId — push API still uses the channel id.\n const targetId = out.channel.id;\n const parts = splitForLine(out.text);\n // Reply API: only the FIRST batch can use the one-shot replyToken; subsequent calls fall back to push.\n const token = this.replyCache.take(targetId);\n let lastErr: SendResult | undefined;\n let messageId: string | undefined;\n for (let i = 0; i < parts.length; i++) {\n const messages = [{ type: \"text\" as const, text: parts[i] ?? \"\" }];\n const isFirst = i === 0;\n try {\n if (isFirst && token !== undefined) {\n await this.client.replyMessage(token, messages);\n } else {\n if (isFirst && token === undefined) {\n process.stderr.write(\n `[gateway-line] no reply token for ${targetId} — using push API\\n`,\n );\n }\n await this.client.pushMessage(targetId, messages);\n }\n messageId = `line-${Date.now()}-${i}`;\n } catch (err) {\n lastErr = mapLineError(err);\n break;\n }\n }\n if (lastErr !== undefined) return lastErr;\n return { ok: true, ...(messageId !== undefined ? { messageId } : {}) };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /** Escape hatch: caller drives Flex/Carousel/etc directly. */\n getClient(): LineSdkClient | undefined {\n return this.client;\n }\n\n /**\n * Webhook entrypoint — called by `createWebhookServer` AFTER signature\n * validation. Iterates LINE's batch envelope and dispatches each event.\n */\n async dispatchWebhookBody(envelope: LineWebhookEnvelope): Promise<void> {\n for (const ev of envelope.events) {\n await this.dispatchSingleEvent(ev);\n }\n }\n\n private async dispatchSingleEvent(ev: LineWebhookEvent): Promise<void> {\n const normalized = lineEventToMessageEvent(ev);\n if (normalized === undefined) return; // EC-4: silently skip non-message / non-text\n // Cache the reply token (one-shot, 60s TTL) keyed by SENDER userId (replies go to whoever spoke).\n if (ev.replyToken !== undefined && normalized.sender.id.length > 0) {\n this.replyCache.put(normalized.sender.id, ev.replyToken);\n }\n // Mention guard (D409).\n if (!this.passesMentionGuard(normalized)) return;\n if (this.inboundHandler === undefined) return;\n try {\n await this.inboundHandler(normalized);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] handler threw: ${msg}\\n`);\n }\n }\n\n private passesMentionGuard(event: GatewayMessageEvent): boolean {\n if (event.platform !== \"line\") return true;\n const requireMention = this.opts.requireMention ?? true;\n if (!requireMention) return true;\n if (event.channel.type === \"dm\") return true;\n if (this.opts.botUserId === undefined) return true; // guard disabled\n return event.line.mentionees.includes(this.opts.botUserId);\n }\n\n /** Expose channel secret for the webhook server (signature middleware). */\n getChannelSecret(): string {\n return this.opts.channelSecret;\n }\n\n /** Used by tests to seed the reply cache (no other path exposes raw cache). */\n _cacheReplyToken(userId: string, token: string): void {\n this.replyCache.put(userId, token);\n }\n}\n\ninterface LineRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n originalError?: { response?: { status?: number } };\n}\n\nfunction mapLineError(err: unknown): SendResult {\n const e = err as LineRestError;\n const status = e.statusCode ?? e.status ?? e.originalError?.response?.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"LINE rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"LINE auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"LINE rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n\n// `computeLineSignature` is already re-exported at the package root via `index.ts`;\n// no need to duplicate here.\n","/**\n * LINE HMAC-SHA256 signature verification (D408).\n *\n * Per LINE Developers docs:\n * signature = base64(hmac_sha256(channelSecret, rawBody))\n *\n * Carried in header `X-Line-Signature`.\n *\n * Always uses `crypto.timingSafeEqual` to prevent timing attacks.\n */\n\nimport crypto from \"node:crypto\";\n\nexport function computeLineSignature(channelSecret: string, rawBody: string): string {\n return crypto.createHmac(\"sha256\", channelSecret).update(rawBody, \"utf8\").digest(\"base64\");\n}\n\nexport function verifyLineSignature(\n channelSecret: string,\n rawBody: string,\n signatureHeader: string | undefined,\n): boolean {\n if (signatureHeader === undefined || signatureHeader.length === 0) return false;\n const expected = computeLineSignature(channelSecret, rawBody);\n const a = Buffer.from(expected);\n const b = Buffer.from(signatureHeader);\n if (a.length !== b.length) return false;\n try {\n return crypto.timingSafeEqual(a, b);\n } catch {\n return false;\n }\n}\n","/**\n * Express webhook server for LINE inbound.\n *\n * Validates `X-Line-Signature` (HMAC-SHA256 over raw body) BEFORE\n * parsing/dispatch — 401 on missing or invalid (D408).\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\n\nimport type { LineAdapter } from \"./adapter.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { verifyLineSignature } from \"./signature.js\";\nimport type { LineWebhookEnvelope } from \"./types.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: LineAdapter;\n /** Mount path; default `/line`. */\n readonly path?: string;\n /** Port to listen on when creating own Express app. Default 3000. */\n readonly port?: number;\n /** Inject an existing Express app. */\n readonly app?: Express;\n}\n\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-line: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction rawCapture(req: Request, _res: Response, next: NextFunction): void {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response at\n // all: the provider times out and retries, and no error is logged anywhere.\n // Failing loudly and continuing is strictly better — verification then\n // refuses the empty body with a 401, which is at least a visible symptom that\n // points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n}\n\nfunction handlerFactory(adapter: LineAdapter) {\n return (req: Request, res: Response): void => {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const signature = headerOf(req, \"x-line-signature\");\n if (!verifyLineSignature(adapter.getChannelSecret(), rawBody, signature)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let envelope: LineWebhookEnvelope;\n try {\n envelope = JSON.parse(rawBody) as LineWebhookEnvelope;\n } catch {\n res.status(400).type(\"text/plain\").send(\"invalid JSON body\");\n return;\n }\n if (!Array.isArray(envelope.events)) {\n res.status(400).type(\"text/plain\").send(\"missing 'events' array\");\n return;\n }\n void adapter.dispatchWebhookBody(envelope);\n // LINE expects a 200 OK quickly to ack the webhook.\n res.status(200).end();\n };\n}\n\nfunction headerOf(req: Request, name: string): string | undefined {\n const v = req.headers[name.toLowerCase()];\n if (v === undefined) return undefined;\n return Array.isArray(v) ? v.join(\",\") : v;\n}\n\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const path = opts.path ?? \"/line\";\n app.post(path, rawCapture, handlerFactory(opts.adapter));\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/normalize.ts","../src/reply-cache.ts","../src/split.ts","../src/adapter.ts","../src/signature.ts","../src/webhook-server.ts"],"names":["GatewayConfigurationError","chunkByGrapheme","BasePlatformAdapter","crypto"],"mappings":";;;;;;;;;;AAsBO,IAAM,kBAAA,GAAN,cAAiCA,iCAAA,CAA0B;AAAA,EAC9C,IAAA,GAAO,oBAAA;AAAA,EACzB,YAAY,IAAA,EAAiC;AAC3C,IAAA,KAAA,CAAM,gBAAgB,IAAI,CAAA;AAAA,EAC5B;AACF;AASO,IAAM,oBAAA,GAAN,cAAmC,kBAAA,CAAmB;AAAA,EAC3D,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM;AAAA,MACJ,IAAA,EAAM,mBAAA;AAAA,MACN,OAAA,EAAS,CAAA,wBAAA,EAA2B,OAAO,CAAA,+BAAA,EAAkC,OAAO,CAAA,CAAA;AAAA,MACpF,MAAA,EAAQ;AAAA,KACT,CAAA;AAAA,EACH;AACF;;;ACKA,eAAsB,WAAA,GAAsC;AAC1D,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,OAAO,eAAe,CAAA;AACxC,IAAA,OAAO,GAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,qBAAqB,eAAe,CAAA;AAAA,EAChD;AACF;AAeO,SAAS,UAAA,CACd,KACA,GAAA,EACe;AACf,EAAA,MAAM,EAAA,GAAK,IAAI,YAAA,EAAc,kBAAA;AAC7B,EAAA,IAAI,OAAO,MAAA,EAAW;AACpB,IAAA,MAAM,SAAS,IAAI,EAAA,CAAG,EAAE,kBAAA,EAAoB,GAAA,CAAI,oBAAoB,CAAA;AACpE,IAAA,OAAO;AAAA,MACL,MAAM,YAAA,CAAa,UAAA,EAAY,QAAA,EAAU;AACvC,QAAA,OAAO,MAAA,CAAO,YAAA,CAAa,EAAE,UAAA,EAAY,UAAU,CAAA;AAAA,MACrD,CAAA;AAAA,MACA,MAAM,WAAA,CAAY,EAAA,EAAI,QAAA,EAAU;AAC9B,QAAA,OAAO,MAAA,CAAO,WAAA,CAAY,EAAE,EAAA,EAAI,UAAU,CAAA;AAAA,MAC5C,CAAA;AAAA,MACA,MAAM,UAAA,GAAa;AACjB,QAAA,OAAO,OAAO,UAAA,EAAW;AAAA,MAC3B;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,IAAI,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA;AAC3B;;;AC5EO,SAAS,cAAc,UAAA,EAA+C;AAC3E,EAAA,IAAI,UAAA,KAAe,QAAQ,OAAO,IAAA;AAClC,EAAA,OAAO,OAAA;AACT;AAUO,SAAS,wBAAwB,KAAA,EAAuD;AAE7F,EAAA,IAAI,KAAA,CAAM,IAAA,KAAS,SAAA,EAAW,OAAO,MAAA;AACrC,EAAA,IAAI,KAAA,CAAM,OAAA,KAAY,MAAA,EAAW,OAAO,MAAA;AACxC,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAA,KAAS,MAAA,EAAQ,OAAO,MAAA;AAE1C,EAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,EAAA,IAAI,MAAA,KAAW,QAAW,OAAO,MAAA;AAEjC,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,MAAA,IAAU,MAAA,CAAO,WAAW,MAAA,CAAO,MAAA;AAC3D,EAAA,MAAM,aAAa,MAAA,CAAO,IAAA;AAC1B,EAAA,IAAI,QAAA,KAAa,MAAA,IAAa,QAAA,CAAS,MAAA,KAAW,GAAG,OAAO,MAAA;AAE5D,EAAA,MAAM,YAAY,MAAA,CAAO,OAAA,IAAW,MAAA,CAAO,MAAA,IAAU,OAAO,MAAA,IAAU,QAAA;AACtE,EAAA,MAAM,WAAA,GAAc,cAAc,UAAU,CAAA;AAE5C,EAAA,MAAM,aAAuB,EAAC;AAC9B,EAAA,KAAA,MAAW,CAAA,IAAK,KAAA,CAAM,OAAA,CAAQ,UAAA,IAAc,EAAC,EAAG;AAC9C,IAAA,IAAI,CAAA,CAAE,MAAA,KAAW,MAAA,IAAa,CAAA,CAAE,MAAA,CAAO,SAAS,CAAA,EAAG,UAAA,CAAW,IAAA,CAAK,CAAA,CAAE,MAAM,CAAA;AAAA,EAC7E;AAEA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,MAAM,OAAA,CAAQ,EAAA,IAAM,QAAQ,KAAA,CAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA;AAAA,IAC7D,QAAA,EAAU,MAAA;AAAA,IACV,MAAA,EAAQ,MAAA,CAAO,MAAA,KAAW,MAAA,GAAY,EAAE,EAAA,EAAI,MAAA,CAAO,MAAA,EAAO,GAAI,EAAE,EAAA,EAAI,QAAA,EAAS;AAAA,IAC7E,OAAA,EAAS,EAAE,EAAA,EAAI,SAAA,EAAW,MAAM,WAAA,EAAY;AAAA,IAC5C,IAAA,EAAM,KAAA,CAAM,OAAA,CAAQ,IAAA,IAAQ,EAAA;AAAA,IAC5B,UAAA,EAAY,KAAA,CAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI;AAAA,IACxC,IAAA,EAAM;AAAA,MACJ,UAAA;AAAA,MACA,QAAA;AAAA,MACA,SAAA,EAAW,KAAA,CAAM,OAAA,CAAQ,EAAA,IAAM,EAAA;AAAA,MAC/B,UAAA;AAAA,MACA,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI,EAAC;AAAA,MACzE,GAAA,EAAK;AAAA;AACP,GACF;AACF;;;ACvDA,IAAM,cAAA,GAAiB,GAAA;AACvB,IAAM,gBAAA,GAAmB,GAAA;AAOlB,IAAM,kBAAN,MAAsB;AAAA,EACV,KAAA,uBAAY,GAAA,EAAmB;AAAA,EAC/B,KAAA;AAAA,EACA,QAAA;AAAA,EAEjB,YAAY,IAAA,EAA8C;AACxD,IAAA,IAAA,CAAK,KAAA,GAAQ,MAAM,KAAA,IAAS,cAAA;AAC5B,IAAA,IAAA,CAAK,QAAA,GAAW,MAAM,QAAA,IAAY,gBAAA;AAAA,EACpC;AAAA,EAEA,GAAA,CAAI,QAAgB,KAAA,EAAqB;AACvC,IAAA,IAAI,KAAK,KAAA,CAAM,IAAA,IAAQ,IAAA,CAAK,QAAA,OAAe,WAAA,EAAY;AACvD,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,MAAA,EAAQ,EAAE,KAAA,EAAO,SAAA,EAAW,IAAA,CAAK,GAAA,EAAI,GAAI,IAAA,CAAK,KAAA,EAAO,CAAA;AAAA,EACtE;AAAA,EAEA,KAAK,MAAA,EAAoC;AACvC,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,MAAM,CAAA;AACnC,IAAA,IAAI,KAAA,KAAU,QAAW,OAAO,MAAA;AAChC,IAAA,IAAA,CAAK,KAAA,CAAM,OAAO,MAAM,CAAA;AACxB,IAAA,IAAI,IAAA,CAAK,GAAA,EAAI,IAAK,KAAA,CAAM,WAAW,OAAO,MAAA;AAC1C,IAAA,OAAO,KAAA,CAAM,KAAA;AAAA,EACf;AAAA,EAEA,IAAA,GAAe;AACb,IAAA,OAAO,KAAK,KAAA,CAAM,IAAA;AAAA,EACpB;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA,EAEQ,WAAA,GAAoB;AAC1B,IAAA,MAAM,WAAW,IAAA,CAAK,KAAA,CAAM,IAAA,EAAK,CAAE,MAAK,CAAE,KAAA;AAC1C,IAAA,IAAI,QAAA,KAAa,MAAA,EAAW,IAAA,CAAK,KAAA,CAAM,OAAO,QAAQ,CAAA;AAAA,EACxD;AACF;ACzCO,SAAS,YAAA,CAAa,IAAA,EAAc,KAAA,GAAQ,GAAA,EAAgB;AACjE,EAAA,OAAOC,uBAAA,CAAgB,IAAA,EAAM,EAAE,KAAA,EAAO,CAAA;AACxC;;;ACOO,IAAM,WAAA,GAAN,cAA0BC,2BAAA,CAAoB;AAAA,EAC1C,QAAA,GAAW,MAAA;AAAA,EACH,IAAA;AAAA,EACA,UAAA,GAAa,IAAI,eAAA,EAAgB;AAAA,EAC1C,MAAA;AAAA,EACA,cAAA;AAAA,EACA,SAAA,GAAY,KAAA;AAAA,EAEpB,YAAY,IAAA,EAA0B;AACpC,IAAA,KAAA,EAAM;AACN,IAAA,IAAI,IAAA,CAAK,aAAA,CAAc,MAAA,KAAW,CAAA,EAAG;AACnC,MAAA,MAAM,IAAI,kBAAA,CAAmB;AAAA,QAC3B,IAAA,EAAM,yBAAA;AAAA,QACN,OAAA,EACE;AAAA,OACH,CAAA;AAAA,IACH;AACA,IAAA,IAAI,IAAA,CAAK,kBAAA,CAAmB,MAAA,KAAW,CAAA,EAAG;AACxC,MAAA,MAAM,IAAI,kBAAA,CAAmB;AAAA,QAC3B,IAAA,EAAM,uBAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AACA,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA,EAEA,MAAM,OAAA,GAA4B;AAChC,IAAA,IAAI,IAAA,CAAK,WAAW,OAAO,IAAA;AAC3B,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,KAAK,IAAA,CAAK,eAAA;AAC1B,MAAA,IAAI,YAAY,KAAA,CAAA,EAAW;AACzB,QAAA,MAAM,GAAA,GAAM,MAAM,WAAA,EAAY;AAC9B,QAAA,IAAA,CAAK,MAAA,GAAS,WAAW,GAAA,EAAK;AAAA,UAC5B,kBAAA,EAAoB,KAAK,IAAA,CAAK,kBAAA;AAAA,UAC9B,aAAA,EAAe,KAAK,IAAA,CAAK;AAAA,SAC1B,CAAA;AAAA,MACH,CAAA,MAAO;AACL,QAAA,IAAA,CAAK,SAAS,OAAA,EAAQ;AAAA,MACxB;AAKA,MAAA,MAAM,IAAA,CAAK,OAAO,UAAA,EAAW;AAC7B,MAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,MAAA,OAAO,IAAA;AAAA,IACT,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,+BAAA,EAAkC,GAAG;AAAA,CAAI,CAAA;AAC9D,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,UAAA,GAA4B;AAChC,IAAA,IAAA,CAAK,SAAA,GAAY,KAAA;AACjB,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,cAAA,GAAiB,MAAA;AACtB,IAAA,IAAA,CAAK,WAAW,KAAA,EAAM;AAAA,EACxB;AAAA;AAAA,EAGA,MAAM,YAAY,GAAA,EAA2C;AAC3D,IAAA,IAAI,GAAA,CAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AACzB,MAAA,OAAO,EAAE,IAAI,KAAA,EAAO,KAAA,EAAO,EAAE,IAAA,EAAM,YAAA,EAAc,OAAA,EAAS,wBAAA,EAAyB,EAAE;AAAA,IACvF;AACA,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,SAAS,kCAAA;AAAmC,OAC9E;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,IAAI,OAAA,CAAQ,EAAA;AAC7B,IAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAEnC,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,QAAQ,CAAA;AAC3C,IAAA,IAAI,OAAA;AACJ,IAAA,IAAI,SAAA;AACJ,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,MAAA,MAAM,QAAA,GAAW,CAAC,EAAE,IAAA,EAAM,MAAA,EAAiB,MAAM,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA,EAAI,CAAA;AACjE,MAAA,MAAM,UAAU,CAAA,KAAM,CAAA;AACtB,MAAA,IAAI;AACF,QAAA,IAAI,OAAA,IAAW,UAAU,KAAA,CAAA,EAAW;AAClC,UAAA,MAAM,IAAA,CAAK,MAAA,CAAO,YAAA,CAAa,KAAA,EAAO,QAAQ,CAAA;AAAA,QAChD,CAAA,MAAO;AACL,UAAA,IAAI,OAAA,IAAW,UAAU,KAAA,CAAA,EAAW;AAClC,YAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,cACb,qCAAqC,QAAQ,CAAA;AAAA;AAAA,aAC/C;AAAA,UACF;AACA,UAAA,MAAM,IAAA,CAAK,MAAA,CAAO,WAAA,CAAY,QAAA,EAAU,QAAQ,CAAA;AAAA,QAClD;AACA,QAAA,SAAA,GAAY,CAAA,KAAA,EAAQ,IAAA,CAAK,GAAA,EAAK,IAAI,CAAC,CAAA,CAAA;AAAA,MACrC,SAAS,GAAA,EAAK;AACZ,QAAA,OAAA,GAAU,aAAa,GAAG,CAAA;AAC1B,QAAA;AAAA,MACF;AAAA,IACF;AACA,IAAA,IAAI,OAAA,KAAY,QAAW,OAAO,OAAA;AAClC,IAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,GAAI,SAAA,KAAc,SAAY,EAAE,SAAA,EAAU,GAAI,EAAC,EAAG;AAAA,EACvE;AAAA,EAEA,UAAU,OAAA,EAAoE;AAE5E,IAAA,IAAA,CAAK,cAAA,GAAiB,OAAA;AACtB,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,IAAA,CAAK,cAAA,KAAmB,OAAA,EAAS,IAAA,CAAK,cAAA,GAAiB,MAAA;AAAA,IAC7D,CAAA;AAAA,EACF;AAAA;AAAA,EAGA,SAAA,GAAuC;AACrC,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,oBAAoB,QAAA,EAA8C;AACtE,IAAA,KAAA,MAAW,EAAA,IAAM,SAAS,MAAA,EAAQ;AAChC,MAAA,MAAM,IAAA,CAAK,oBAAoB,EAAE,CAAA;AAAA,IACnC;AAAA,EACF;AAAA,EAEA,MAAc,oBAAoB,EAAA,EAAqC;AACrE,IAAA,MAAM,UAAA,GAAa,wBAAwB,EAAE,CAAA;AAC7C,IAAA,IAAI,eAAe,MAAA,EAAW;AAE9B,IAAA,IAAI,GAAG,UAAA,KAAe,MAAA,IAAa,WAAW,MAAA,CAAO,EAAA,CAAG,SAAS,CAAA,EAAG;AAClE,MAAA,IAAA,CAAK,WAAW,GAAA,CAAI,UAAA,CAAW,MAAA,CAAO,EAAA,EAAI,GAAG,UAAU,CAAA;AAAA,IACzD;AAEA,IAAA,IAAI,CAAC,IAAA,CAAK,kBAAA,CAAmB,UAAU,CAAA,EAAG;AAC1C,IAAA,IAAI,IAAA,CAAK,mBAAmB,MAAA,EAAW;AACvC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,eAAe,UAAU,CAAA;AAAA,IACtC,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,8BAAA,EAAiC,GAAG;AAAA,CAAI,CAAA;AAAA,IAC/D;AAAA,EACF;AAAA,EAEQ,mBAAmB,KAAA,EAAqC;AAC9D,IAAA,IAAI,KAAA,CAAM,QAAA,KAAa,MAAA,EAAQ,OAAO,IAAA;AACtC,IAAA,MAAM,cAAA,GAAiB,IAAA,CAAK,IAAA,CAAK,cAAA,IAAkB,IAAA;AACnD,IAAA,IAAI,CAAC,gBAAgB,OAAO,IAAA;AAC5B,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAA,KAAS,IAAA,EAAM,OAAO,IAAA;AACxC,IAAA,IAAI,IAAA,CAAK,IAAA,CAAK,SAAA,KAAc,MAAA,EAAW,OAAO,IAAA;AAC9C,IAAA,OAAO,MAAM,IAAA,CAAK,UAAA,CAAW,QAAA,CAAS,IAAA,CAAK,KAAK,SAAS,CAAA;AAAA,EAC3D;AAAA;AAAA,EAGA,gBAAA,GAA2B;AACzB,IAAA,OAAO,KAAK,IAAA,CAAK,aAAA;AAAA,EACnB;AAAA;AAAA,EAGA,gBAAA,CAAiB,QAAgB,KAAA,EAAqB;AACpD,IAAA,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,MAAA,EAAQ,KAAK,CAAA;AAAA,EACnC;AACF;AASA,SAAS,aAAa,GAAA,EAA0B;AAC9C,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,MAAM,MAAA,GAAS,EAAE,UAAA,IAAc,CAAA,CAAE,UAAU,CAAA,CAAE,aAAA,EAAe,UAAU,MAAA,IAAU,CAAA;AAChF,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,EAAE,IAAA,EAAM,YAAA,EAAc,OAAA,EAAS,CAAA,CAAE,OAAA,IAAW,iBAAA,EAAkB,EAAE;AAAA,EAC7F;AACA,EAAA,IAAI,MAAA,KAAW,GAAA,IAAO,MAAA,KAAW,GAAA,EAAK;AACpC,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,OAAO,EAAE,IAAA,EAAM,qBAAqB,OAAA,EAAS,CAAA,CAAE,WAAW,iBAAA;AAAkB,KAC9E;AAAA,EACF;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,OAAO,EAAE,IAAA,EAAM,mBAAmB,OAAA,EAAS,CAAA,CAAE,WAAW,uBAAA;AAAwB,KAClF;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,KAAA;AAAA,IACJ,KAAA,EAAO;AAAA,MACL,IAAA,EAAM,aAAA;AAAA,MACN,OAAA,EAAS,EAAE,OAAA,KAAY,GAAA,YAAe,QAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAAA;AACxE,GACF;AACF;AC3MO,SAAS,oBAAA,CAAqB,eAAuB,OAAA,EAAyB;AACnF,EAAA,OAAOC,uBAAA,CAAO,UAAA,CAAW,QAAA,EAAU,aAAa,CAAA,CAAE,OAAO,OAAA,EAAS,MAAM,CAAA,CAAE,MAAA,CAAO,QAAQ,CAAA;AAC3F;AASO,SAAS,mBAAA,CACd,aAAA,EACA,OAAA,EACA,eAAA,EACS;AACT,EAAA,IAAI,eAAA,KAAoB,MAAA,IAAa,eAAA,CAAgB,MAAA,KAAW,GAAG,OAAO,KAAA;AAC1E,EAAA,MAAM,QAAA,GAAW,oBAAA,CAAqB,aAAA,EAAe,OAAO,CAAA;AAC5D,EAAA,MAAM,CAAA,GAAI,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA;AAC9B,EAAA,MAAM,CAAA,GAAI,MAAA,CAAO,IAAA,CAAK,eAAe,CAAA;AACrC,EAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ,OAAO,KAAA;AAClC,EAAA,IAAI;AACF,IAAA,OAAOA,uBAAA,CAAO,eAAA,CAAgB,CAAA,EAAG,CAAC,CAAA;AAAA,EACpC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;;;ACPA,eAAe,WAAA,GAAmD;AAChE,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,OAAO,SAAS,CAAA;AAClC,IAAA,MAAM,EAAA,GAAM,IAAoC,OAAA,IAAY,GAAA;AAC5D,IAAA,OAAO,EAAE,SAAS,EAAA,EAAG;AAAA,EACvB,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,kBAAA,CAAmB;AAAA,MAC3B,IAAA,EAAM,uBAAA;AAAA,MACN,OAAA,EAAS;AAAA,KACV,CAAA;AAAA,EACH;AACF;AAEA,SAAS,UAAA,CAAW,GAAA,EAAc,IAAA,EAAgB,IAAA,EAA0B;AAS1E,EAAA,IAAI,GAAA,CAAI,aAAA,IAAiB,GAAA,CAAI,QAAA,EAAU;AACrC,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb;AAAA,KAGF;AACA,IAAC,IAAsC,OAAA,GAAU,EAAA;AACjD,IAAA,IAAA,EAAK;AACL,IAAA;AAAA,EACF;AACA,EAAA,IAAI,GAAA,GAAM,EAAA;AACV,EAAA,GAAA,CAAI,YAAY,MAAM,CAAA;AACtB,EAAA,GAAA,CAAI,EAAA,CAAG,MAAA,EAAQ,CAAC,KAAA,KAAkB;AAChC,IAAA,GAAA,IAAO,KAAA;AAAA,EACT,CAAC,CAAA;AACD,EAAA,GAAA,CAAI,EAAA,CAAG,OAAO,MAAM;AAClB,IAAC,IAAsC,OAAA,GAAU,GAAA;AACjD,IAAA,IAAA,EAAK;AAAA,EACP,CAAC,CAAA;AACD,EAAA,GAAA,CAAI,GAAG,OAAA,EAAS,CAAC,GAAA,KAAQ,IAAA,CAAK,GAAG,CAAC,CAAA;AACpC;AAEA,SAAS,eAAe,OAAA,EAAsB;AAC5C,EAAA,OAAO,CAAC,KAAc,GAAA,KAAwB;AAC5C,IAAA,MAAM,OAAA,GAAW,IAAuC,OAAA,IAAW,EAAA;AACnE,IAAA,MAAM,SAAA,GAAY,QAAA,CAAS,GAAA,EAAK,kBAAkB,CAAA;AAClD,IAAA,IAAI,CAAC,mBAAA,CAAoB,OAAA,CAAQ,kBAAiB,EAAG,OAAA,EAAS,SAAS,CAAA,EAAG;AACxE,MAAA,GAAA,CAAI,OAAO,GAAG,CAAA,CAAE,KAAK,YAAY,CAAA,CAAE,KAAK,mBAAmB,CAAA;AAC3D,MAAA;AAAA,IACF;AACA,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,IAC/B,CAAA,CAAA,MAAQ;AACN,MAAA,GAAA,CAAI,OAAO,GAAG,CAAA,CAAE,KAAK,YAAY,CAAA,CAAE,KAAK,mBAAmB,CAAA;AAC3D,MAAA;AAAA,IACF;AACA,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,QAAA,CAAS,MAAM,CAAA,EAAG;AACnC,MAAA,GAAA,CAAI,OAAO,GAAG,CAAA,CAAE,KAAK,YAAY,CAAA,CAAE,KAAK,wBAAwB,CAAA;AAChE,MAAA;AAAA,IACF;AAMA,IAAA,KAAK,QAAQ,mBAAA,CAAoB,QAAQ,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAiB;AACjE,MAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,wCAAA,EAA2C,OAAO;AAAA,CAAI,CAAA;AAAA,IAC7E,CAAC,CAAA;AAED,IAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,GAAA,EAAI;AAAA,EACtB,CAAA;AACF;AAEA,SAAS,QAAA,CAAS,KAAc,IAAA,EAAkC;AAChE,EAAA,MAAM,CAAA,GAAI,GAAA,CAAI,OAAA,CAAQ,IAAA,CAAK,aAAa,CAAA;AACxC,EAAA,IAAI,CAAA,KAAM,QAAW,OAAO,MAAA;AAC5B,EAAA,OAAO,MAAM,OAAA,CAAQ,CAAC,IAAI,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA,GAAI,CAAA;AAC1C;AASA,eAAsB,oBAAoB,IAAA,EAAoD;AAC5F,EAAA,MAAM,UAAA,GAAa,MAAM,WAAA,EAAY;AACrC,EAAA,MAAM,GAAA,GAAe,IAAA,CAAK,GAAA,IAAO,UAAA,CAAW,OAAA,EAAQ;AACpD,EAAA,MAAM,IAAA,GAAO,KAAK,IAAA,IAAQ,OAAA;AAC1B,EAAA,GAAA,CAAI,KAAK,IAAA,EAAM,UAAA,EAAY,cAAA,CAAe,IAAA,CAAK,OAAO,CAAC,CAAA;AAEvD,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,IAAI,OAAA,GAAU,KAAA;AAEd,EAAA,OAAO;AAAA,IACL,MAAM,KAAA,GAAuB;AAC3B,MAAA,IAAI,OAAA,IAAW,IAAA,CAAK,GAAA,KAAQ,MAAA,EAAW;AACrC,QAAA,OAAA,GAAU,IAAA;AACV,QAAA;AAAA,MACF;AACA,MAAA,MAAM,IAAA,GAAO,KAAK,IAAA,IAAQ,GAAA;AAC1B,MAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACnC,QAAA,MAAA,GAAS,GAAA,CAAI,MAAA,CAAO,IAAA,EAAM,MAAM,SAAS,CAAA;AAAA,MAC3C,CAAC,CAAA;AACD,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ,CAAA;AAAA,IACA,MAAM,IAAA,GAAsB;AAC1B,MAAA,IAAI,OAAA,EAAS;AACb,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,IAAI,WAAW,MAAA,EAAW;AAC1B,MAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACnC,QAAA,MAAA,EAAQ,KAAA,CAAM,MAAM,OAAA,EAAS,CAAA;AAAA,MAC/B,CAAC,CAAA;AACD,MAAA,MAAA,GAAS,MAAA;AAAA,IACX;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-line`.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2) — only the package prefix is package-specific. Name,\n * message shape, `code`/`detail` fields, and `instanceof` are byte-identical\n * to the previous hand-rolled class (pinned by `tests/errors.test.ts`).\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\n/**\n * Misconfiguration of this adapter, raised before any network call.\n *\n * Extends the shared core base so every gateway package reports configuration faults in one shape:\n * a structured `code` the caller can branch on, tagged with `\"gateway-line\"` as the origin. A\n * missing credential or an unsupported option is a programmer error, not a transient failure —\n * these are never retried.\n */\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-line\", opts);\n }\n}\n\n/**\n * The platform SDK this adapter needs is declared as a peer dependency and is not installed.\n *\n * Raised at connect time rather than at import, so a project that installs several gateway packages\n * only pays for the SDKs of the ones it actually starts. The message names the exact package and\n * the command that installs it.\n */\nexport class SDKNotInstalledError extends ConfigurationError {\n constructor(pkgName: string) {\n super({\n code: \"sdk_not_installed\",\n message: `gateway-line: peer-dep \"${pkgName}\" not installed. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * Lazy `@line/bot-sdk` loader + thin Client wrapper for sending.\n */\n\nimport { SDKNotInstalledError } from \"./errors.js\";\n\nexport interface LineSdkClient {\n replyMessage(\n replyToken: string,\n messages: Array<{ type: \"text\"; text: string }>,\n ): Promise<unknown>;\n pushMessage(to: string, messages: Array<{ type: \"text\"; text: string }>): Promise<unknown>;\n /**\n * `GET /v2/bot/info` — the cheapest call that makes LINE judge the token.\n *\n * `connect()` needs it because building a client performs no I/O at all: it\n * would otherwise report success for any string, and the operator would find\n * out at the first send. Telegram, Discord, Slack and Mattermost all surface a\n * bad credential from connect(); Matrix did not until 2026-08-17, and this was\n * the second adapter with the same gap.\n */\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n}\n\n/**\n * The v9 `MessagingApiClient` surface, as declared by the installed\n * `@line/bot-sdk` v9 `messagingApiClient.d.ts`. Both methods take ONE request\n * object — this is not the same shape as {@link LineSdkClient}, and conflating\n * the two is what broke every outbound message before 2026-08-17.\n */\ninterface LineV9Client {\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n replyMessage(request: {\n replyToken: string;\n messages: Array<{ type: \"text\"; text: string }>;\n }): Promise<unknown>;\n pushMessage(\n request: { to: string; messages: Array<{ type: \"text\"; text: string }> },\n xLineRetryKey?: string,\n ): Promise<unknown>;\n}\n\ninterface LineSdkModule {\n Client: new (cfg: { channelAccessToken: string; channelSecret?: string }) => LineSdkClient;\n messagingApi?: {\n MessagingApiClient: new (cfg: { channelAccessToken: string }) => LineV9Client;\n };\n}\n\nexport async function loadLineSdk(): Promise<LineSdkModule> {\n try {\n const mod = await import(\"@line/bot-sdk\");\n return mod as unknown as LineSdkModule;\n } catch {\n throw new SDKNotInstalledError(\"@line/bot-sdk\");\n }\n}\n\n/**\n * Build a client exposing the positional {@link LineSdkClient} shape the adapter\n * calls, from either the legacy (`Client`) or the v9\n * (`messagingApi.MessagingApiClient`) SDK.\n *\n * The v9 client is WRAPPED, not returned directly. An earlier version returned\n * it as-is on the claim that \"v9 SDK exposes both styles\" — it does not. v9\n * declares `replyMessage(request)` and `pushMessage(request, retryKey?)`, each\n * taking a single object, so the adapter's positional call arrived as\n * `{replyToken: undefined, messages: undefined}` and LINE rejected every send\n * with a 400. Since `@line/bot-sdk` is pinned at `^9.0.0`, this branch is the\n * one that always runs: the bug was total, not conditional.\n */\nexport function makeClient(\n mod: LineSdkModule,\n cfg: { channelAccessToken: string; channelSecret: string },\n): LineSdkClient {\n const v9 = mod.messagingApi?.MessagingApiClient;\n if (v9 !== undefined) {\n const client = new v9({ channelAccessToken: cfg.channelAccessToken });\n return {\n async replyMessage(replyToken, messages) {\n return client.replyMessage({ replyToken, messages });\n },\n async pushMessage(to, messages) {\n return client.pushMessage({ to, messages });\n },\n async getBotInfo() {\n return client.getBotInfo();\n },\n };\n }\n return new mod.Client(cfg);\n}\n","/**\n * Inbound normalization: LINE webhook event → LineMessageEvent.\n *\n * EC-4 absorbed: LINE webhook delivers 9 event types. Only `message`\n * events of `text` type are dispatched in v0.1; other types (`follow`,\n * `unfollow`, `postback`, image/audio/sticker messages, etc.) return\n * `undefined` so `adapter.dispatchEvent` skips them silently.\n *\n * D410: source.type mapping `user` → `dm`; `group`/`room` → `group`.\n */\n\nimport type { LineMessageEvent } from \"@theokit/gateway\";\n\nimport type { LineWebhookEvent } from \"./types.js\";\n\nexport function mapSourceType(sourceType: string): \"dm\" | \"group\" | \"thread\" {\n if (sourceType === \"user\") return \"dm\";\n return \"group\";\n}\n\n/**\n * Turn one LINE webhook event into a `LineMessageEvent`, or `undefined` when it is not a text\n * message.\n *\n * A LINE delivery carries a batch of heterogeneous events — follows, joins, stickers, images.\n * Returning `undefined` for the ones this adapter does not handle is the normal path, not an error.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: EC-4 event-type filter + source-shape narrowing + mentionee extraction are intentionally co-located so the dispatch contract stays linear.\nexport function lineEventToMessageEvent(event: LineWebhookEvent): LineMessageEvent | undefined {\n // EC-4: filter at the top — non-message events have undefined fields downstream.\n if (event.type !== \"message\") return undefined;\n if (event.message === undefined) return undefined;\n if (event.message.type !== \"text\") return undefined;\n\n const source = event.source;\n if (source === undefined) return undefined;\n\n const sourceId = source.userId ?? source.groupId ?? source.roomId;\n const sourceType = source.type as \"user\" | \"group\" | \"room\";\n if (sourceId === undefined || sourceId.length === 0) return undefined;\n\n const channelId = source.groupId ?? source.roomId ?? source.userId ?? sourceId;\n const channelType = mapSourceType(sourceType);\n\n const mentionees: string[] = [];\n for (const m of event.message.mentionees ?? []) {\n if (m.userId !== undefined && m.userId.length > 0) mentionees.push(m.userId);\n }\n\n return {\n id: event.message.id ?? `line-${event.timestamp ?? Date.now()}`,\n platform: \"line\",\n sender: source.userId !== undefined ? { id: source.userId } : { id: sourceId },\n channel: { id: channelId, type: channelType },\n text: event.message.text ?? \"\",\n receivedAt: event.timestamp ?? Date.now(),\n line: {\n sourceType,\n sourceId,\n messageId: event.message.id ?? \"\",\n mentionees,\n ...(event.replyToken !== undefined ? { replyToken: event.replyToken } : {}),\n raw: event,\n },\n };\n}\n","/**\n * Reply-token LRU cache (D407).\n *\n * `put(userId, token)` — store with 60s TTL.\n * `take(userId)` — atomic one-shot consume; second call returns undefined.\n * `evictExpired()` — periodic GC; called internally before each take.\n *\n * Capacity 1000; oldest dropped when full.\n */\n\nconst DEFAULT_TTL_MS = 60_000;\nconst DEFAULT_CAPACITY = 1000;\n\ninterface Entry {\n token: string;\n expiresAt: number;\n}\n\nexport class ReplyTokenCache {\n private readonly cache = new Map<string, Entry>();\n private readonly ttlMs: number;\n private readonly capacity: number;\n\n constructor(opts?: { ttlMs?: number; capacity?: number }) {\n this.ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;\n this.capacity = opts?.capacity ?? DEFAULT_CAPACITY;\n }\n\n put(userId: string, token: string): void {\n if (this.cache.size >= this.capacity) this.evictOldest();\n this.cache.set(userId, { token, expiresAt: Date.now() + this.ttlMs });\n }\n\n take(userId: string): string | undefined {\n const entry = this.cache.get(userId);\n if (entry === undefined) return undefined;\n this.cache.delete(userId);\n if (Date.now() >= entry.expiresAt) return undefined;\n return entry.token;\n }\n\n size(): number {\n return this.cache.size;\n }\n\n clear(): void {\n this.cache.clear();\n }\n\n private evictOldest(): void {\n const firstKey = this.cache.keys().next().value;\n if (firstKey !== undefined) this.cache.delete(firstKey);\n }\n}\n","/**\n * Grapheme-cluster-safe split for LINE outbound text (D411, EC-7).\n *\n * LINE limits text messages to 5000 chars. Thin wrapper over core\n * `chunkByGrapheme` (roadmap M1) — single-sources the `Intl.Segmenter` grapheme\n * walk so emoji, regional indicators, and combining sequences are never severed.\n * Output is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\nexport function splitForLine(text: string, limit = 5000): string[] {\n return chunkByGrapheme(text, { limit });\n}\n","/**\n * `LineAdapter` — implements BasePlatformAdapter over LINE Messaging API.\n * ADRs D405-D412.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\n\nimport { type LineSdkClient, loadLineSdk, makeClient } from \"./client.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { lineEventToMessageEvent } from \"./normalize.js\";\nimport { ReplyTokenCache } from \"./reply-cache.js\";\nimport { splitForLine } from \"./split.js\";\nimport type { LineAdapterOptions, LineWebhookEnvelope, LineWebhookEvent } from \"./types.js\";\n\nexport class LineAdapter extends BasePlatformAdapter {\n readonly platform = \"line\" as const;\n private readonly opts: LineAdapterOptions;\n private readonly replyCache = new ReplyTokenCache();\n private client: LineSdkClient | undefined;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n\n constructor(opts: LineAdapterOptions) {\n super();\n if (opts.channelSecret.length === 0) {\n throw new ConfigurationError({\n code: \"channel_secret_required\",\n message:\n \"gateway-line: opts.channelSecret is empty (D408 requires signing — no insecure mode)\",\n });\n }\n if (opts.channelAccessToken.length === 0) {\n throw new ConfigurationError({\n code: \"access_token_required\",\n message: \"gateway-line: opts.channelAccessToken is empty\",\n });\n }\n this.opts = opts;\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n const factory = this.opts.__clientFactory;\n if (factory === undefined) {\n const mod = await loadLineSdk();\n this.client = makeClient(mod, {\n channelAccessToken: this.opts.channelAccessToken,\n channelSecret: this.opts.channelSecret,\n });\n } else {\n this.client = factory() as LineSdkClient;\n }\n // Validate the credential before reporting success. Building the client\n // performs NO network I/O, so without this connect() answered true for any\n // string and the failure surfaced only at the first send — as a 401 that\n // looks like a send bug rather than a bad token.\n await this.client.getBotInfo();\n this.connected = true;\n return true;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] connect failed: ${msg}\\n`);\n return false;\n }\n }\n\n async disconnect(): Promise<void> {\n this.connected = false;\n this.client = undefined;\n this.inboundHandler = undefined;\n this.replyCache.clear();\n }\n\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: reply-token-vs-push selection + multipart loop + per-part error mapping is one cohesive send pipeline (D407 + D411); splitting hurts traceability.\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"LineAdapter.connect() not called\" },\n };\n }\n // For DMs: channel.id IS the userId. For groups/rooms: channel.id is groupId/roomId — push API still uses the channel id.\n const targetId = out.channel.id;\n const parts = splitForLine(out.text);\n // Reply API: only the FIRST batch can use the one-shot replyToken; subsequent calls fall back to push.\n const token = this.replyCache.take(targetId);\n let lastErr: SendResult | undefined;\n let messageId: string | undefined;\n for (let i = 0; i < parts.length; i++) {\n const messages = [{ type: \"text\" as const, text: parts[i] ?? \"\" }];\n const isFirst = i === 0;\n try {\n if (isFirst && token !== undefined) {\n await this.client.replyMessage(token, messages);\n } else {\n if (isFirst && token === undefined) {\n process.stderr.write(\n `[gateway-line] no reply token for ${targetId} — using push API\\n`,\n );\n }\n await this.client.pushMessage(targetId, messages);\n }\n messageId = `line-${Date.now()}-${i}`;\n } catch (err) {\n lastErr = mapLineError(err);\n break;\n }\n }\n if (lastErr !== undefined) return lastErr;\n return { ok: true, ...(messageId !== undefined ? { messageId } : {}) };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /** Escape hatch: caller drives Flex/Carousel/etc directly. */\n getClient(): LineSdkClient | undefined {\n return this.client;\n }\n\n /**\n * Webhook entrypoint — called by `createWebhookServer` AFTER signature\n * validation. Iterates LINE's batch envelope and dispatches each event.\n */\n async dispatchWebhookBody(envelope: LineWebhookEnvelope): Promise<void> {\n for (const ev of envelope.events) {\n await this.dispatchSingleEvent(ev);\n }\n }\n\n private async dispatchSingleEvent(ev: LineWebhookEvent): Promise<void> {\n const normalized = lineEventToMessageEvent(ev);\n if (normalized === undefined) return; // EC-4: silently skip non-message / non-text\n // Cache the reply token (one-shot, 60s TTL) keyed by SENDER userId (replies go to whoever spoke).\n if (ev.replyToken !== undefined && normalized.sender.id.length > 0) {\n this.replyCache.put(normalized.sender.id, ev.replyToken);\n }\n // Mention guard (D409).\n if (!this.passesMentionGuard(normalized)) return;\n if (this.inboundHandler === undefined) return;\n try {\n await this.inboundHandler(normalized);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] handler threw: ${msg}\\n`);\n }\n }\n\n private passesMentionGuard(event: GatewayMessageEvent): boolean {\n if (event.platform !== \"line\") return true;\n const requireMention = this.opts.requireMention ?? true;\n if (!requireMention) return true;\n if (event.channel.type === \"dm\") return true;\n if (this.opts.botUserId === undefined) return true; // guard disabled\n return event.line.mentionees.includes(this.opts.botUserId);\n }\n\n /** Expose channel secret for the webhook server (signature middleware). */\n getChannelSecret(): string {\n return this.opts.channelSecret;\n }\n\n /** Used by tests to seed the reply cache (no other path exposes raw cache). */\n _cacheReplyToken(userId: string, token: string): void {\n this.replyCache.put(userId, token);\n }\n}\n\ninterface LineRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n originalError?: { response?: { status?: number } };\n}\n\nfunction mapLineError(err: unknown): SendResult {\n const e = err as LineRestError;\n const status = e.statusCode ?? e.status ?? e.originalError?.response?.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"LINE rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"LINE auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"LINE rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n\n// `computeLineSignature` is already re-exported at the package root via `index.ts`;\n// no need to duplicate here.\n","/**\n * LINE HMAC-SHA256 signature verification (D408).\n *\n * Per LINE Developers docs:\n * signature = base64(hmac_sha256(channelSecret, rawBody))\n *\n * Carried in header `X-Line-Signature`.\n *\n * Always uses `crypto.timingSafeEqual` to prevent timing attacks.\n */\n\nimport crypto from \"node:crypto\";\n\nexport function computeLineSignature(channelSecret: string, rawBody: string): string {\n return crypto.createHmac(\"sha256\", channelSecret).update(rawBody, \"utf8\").digest(\"base64\");\n}\n\n/**\n * Verify LINE's `x-line-signature` header against the raw request body.\n *\n * Returns `false` for a missing, malformed or mismatched signature — never throws, so a hostile\n * header cannot become an unhandled error on the webhook path. Compare against the RAW body: any\n * re-serialisation of the parsed JSON changes the bytes and invalidates the signature.\n */\nexport function verifyLineSignature(\n channelSecret: string,\n rawBody: string,\n signatureHeader: string | undefined,\n): boolean {\n if (signatureHeader === undefined || signatureHeader.length === 0) return false;\n const expected = computeLineSignature(channelSecret, rawBody);\n const a = Buffer.from(expected);\n const b = Buffer.from(signatureHeader);\n if (a.length !== b.length) return false;\n try {\n return crypto.timingSafeEqual(a, b);\n } catch {\n return false;\n }\n}\n","/**\n * Express webhook server for LINE inbound.\n *\n * Validates `X-Line-Signature` (HMAC-SHA256 over raw body) BEFORE\n * parsing/dispatch — 401 on missing or invalid (D408).\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\n\nimport type { LineAdapter } from \"./adapter.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { verifyLineSignature } from \"./signature.js\";\nimport type { LineWebhookEnvelope } from \"./types.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: LineAdapter;\n /** Mount path; default `/line`. */\n readonly path?: string;\n /** Port to listen on when creating own Express app. Default 3000. */\n readonly port?: number;\n /** Inject an existing Express app. */\n readonly app?: Express;\n}\n\n/** A started HTTP listener, with the handle needed to shut it down again. */\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-line: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction rawCapture(req: Request, _res: Response, next: NextFunction): void {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response at\n // all: the provider times out and retries, and no error is logged anywhere.\n // Failing loudly and continuing is strictly better — verification then\n // refuses the empty body with a 401, which is at least a visible symptom that\n // points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n}\n\nfunction handlerFactory(adapter: LineAdapter) {\n return (req: Request, res: Response): void => {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const signature = headerOf(req, \"x-line-signature\");\n if (!verifyLineSignature(adapter.getChannelSecret(), rawBody, signature)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let envelope: LineWebhookEnvelope;\n try {\n envelope = JSON.parse(rawBody) as LineWebhookEnvelope;\n } catch {\n res.status(400).type(\"text/plain\").send(\"invalid JSON body\");\n return;\n }\n if (!Array.isArray(envelope.events)) {\n res.status(400).type(\"text/plain\").send(\"missing 'events' array\");\n return;\n }\n // Answered before dispatch, on purpose: LINE retries a webhook it did not see a 200 for,\n // and waiting on the handler turns a slow one into a duplicate delivery. What that costs is\n // that the dispatch is floated — and a floated rejection is an unhandled one, which ends the\n // process (the defect fixed across the other adapters in #41). The catch is what makes the\n // early answer safe rather than merely fast.\n void adapter.dispatchWebhookBody(envelope).catch((err: unknown) => {\n const message = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] webhook dispatch failed: ${message}\\n`);\n });\n // LINE expects a 200 OK quickly to ack the webhook.\n res.status(200).end();\n };\n}\n\nfunction headerOf(req: Request, name: string): string | undefined {\n const v = req.headers[name.toLowerCase()];\n if (v === undefined) return undefined;\n return Array.isArray(v) ? v.join(\",\") : v;\n}\n\n/**\n * Build the HTTP listener that receives LINE's webhook deliveries.\n *\n * LINE dials in, so this endpoint must be reachable over public HTTPS and registered in the LINE\n * console — unlike the connection-based adapters, inbound cannot work behind a firewall. `express`\n * is loaded lazily, so a project that only sends messages never pays for it.\n */\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const path = opts.path ?? \"/line\";\n app.post(path, rawCapture, handlerFactory(opts.adapter));\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
package/dist/index.d.cts CHANGED
@@ -144,10 +144,25 @@ declare class LineAdapter extends BasePlatformAdapter {
144
144
 
145
145
  /** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */
146
146
  type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;
147
+ /**
148
+ * Misconfiguration of this adapter, raised before any network call.
149
+ *
150
+ * Extends the shared core base so every gateway package reports configuration faults in one shape:
151
+ * a structured `code` the caller can branch on, tagged with `"gateway-line"` as the origin. A
152
+ * missing credential or an unsupported option is a programmer error, not a transient failure —
153
+ * these are never retried.
154
+ */
147
155
  declare class ConfigurationError extends GatewayConfigurationError {
148
156
  readonly name = "ConfigurationError";
149
157
  constructor(opts: ConfigurationErrorOptions);
150
158
  }
159
+ /**
160
+ * The platform SDK this adapter needs is declared as a peer dependency and is not installed.
161
+ *
162
+ * Raised at connect time rather than at import, so a project that installs several gateway packages
163
+ * only pays for the SDKs of the ones it actually starts. The message names the exact package and
164
+ * the command that installs it.
165
+ */
151
166
  declare class SDKNotInstalledError extends ConfigurationError {
152
167
  constructor(pkgName: string);
153
168
  }
@@ -164,6 +179,13 @@ declare class SDKNotInstalledError extends ConfigurationError {
164
179
  */
165
180
 
166
181
  declare function mapSourceType(sourceType: string): "dm" | "group" | "thread";
182
+ /**
183
+ * Turn one LINE webhook event into a `LineMessageEvent`, or `undefined` when it is not a text
184
+ * message.
185
+ *
186
+ * A LINE delivery carries a batch of heterogeneous events — follows, joins, stickers, images.
187
+ * Returning `undefined` for the ones this adapter does not handle is the normal path, not an error.
188
+ */
167
189
  declare function lineEventToMessageEvent(event: LineWebhookEvent): LineMessageEvent | undefined;
168
190
 
169
191
  /**
@@ -201,6 +223,13 @@ declare class ReplyTokenCache {
201
223
  * Always uses `crypto.timingSafeEqual` to prevent timing attacks.
202
224
  */
203
225
  declare function computeLineSignature(channelSecret: string, rawBody: string): string;
226
+ /**
227
+ * Verify LINE's `x-line-signature` header against the raw request body.
228
+ *
229
+ * Returns `false` for a missing, malformed or mismatched signature — never throws, so a hostile
230
+ * header cannot become an unhandled error on the webhook path. Compare against the RAW body: any
231
+ * re-serialisation of the parsed JSON changes the bytes and invalidates the signature.
232
+ */
204
233
  declare function verifyLineSignature(channelSecret: string, rawBody: string, signatureHeader: string | undefined): boolean;
205
234
 
206
235
  /**
@@ -232,10 +261,18 @@ interface WebhookServerOptions {
232
261
  /** Inject an existing Express app. */
233
262
  readonly app?: Express;
234
263
  }
264
+ /** A started HTTP listener, with the handle needed to shut it down again. */
235
265
  interface WebhookServer {
236
266
  start(): Promise<void>;
237
267
  stop(): Promise<void>;
238
268
  }
269
+ /**
270
+ * Build the HTTP listener that receives LINE's webhook deliveries.
271
+ *
272
+ * LINE dials in, so this endpoint must be reachable over public HTTPS and registered in the LINE
273
+ * console — unlike the connection-based adapters, inbound cannot work behind a firewall. `express`
274
+ * is loaded lazily, so a project that only sends messages never pays for it.
275
+ */
239
276
  declare function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer>;
240
277
 
241
278
  export { ConfigurationError, LineAdapter, type LineAdapterOptions, type LineMessage, type LineSource, type LineWebhookEnvelope, type LineWebhookEvent, ReplyTokenCache, SDKNotInstalledError, type WebhookServer, type WebhookServerOptions, computeLineSignature, createWebhookServer, lineEventToMessageEvent, mapSourceType, splitForLine, verifyLineSignature };
package/dist/index.d.ts CHANGED
@@ -144,10 +144,25 @@ declare class LineAdapter extends BasePlatformAdapter {
144
144
 
145
145
  /** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */
146
146
  type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;
147
+ /**
148
+ * Misconfiguration of this adapter, raised before any network call.
149
+ *
150
+ * Extends the shared core base so every gateway package reports configuration faults in one shape:
151
+ * a structured `code` the caller can branch on, tagged with `"gateway-line"` as the origin. A
152
+ * missing credential or an unsupported option is a programmer error, not a transient failure —
153
+ * these are never retried.
154
+ */
147
155
  declare class ConfigurationError extends GatewayConfigurationError {
148
156
  readonly name = "ConfigurationError";
149
157
  constructor(opts: ConfigurationErrorOptions);
150
158
  }
159
+ /**
160
+ * The platform SDK this adapter needs is declared as a peer dependency and is not installed.
161
+ *
162
+ * Raised at connect time rather than at import, so a project that installs several gateway packages
163
+ * only pays for the SDKs of the ones it actually starts. The message names the exact package and
164
+ * the command that installs it.
165
+ */
151
166
  declare class SDKNotInstalledError extends ConfigurationError {
152
167
  constructor(pkgName: string);
153
168
  }
@@ -164,6 +179,13 @@ declare class SDKNotInstalledError extends ConfigurationError {
164
179
  */
165
180
 
166
181
  declare function mapSourceType(sourceType: string): "dm" | "group" | "thread";
182
+ /**
183
+ * Turn one LINE webhook event into a `LineMessageEvent`, or `undefined` when it is not a text
184
+ * message.
185
+ *
186
+ * A LINE delivery carries a batch of heterogeneous events — follows, joins, stickers, images.
187
+ * Returning `undefined` for the ones this adapter does not handle is the normal path, not an error.
188
+ */
167
189
  declare function lineEventToMessageEvent(event: LineWebhookEvent): LineMessageEvent | undefined;
168
190
 
169
191
  /**
@@ -201,6 +223,13 @@ declare class ReplyTokenCache {
201
223
  * Always uses `crypto.timingSafeEqual` to prevent timing attacks.
202
224
  */
203
225
  declare function computeLineSignature(channelSecret: string, rawBody: string): string;
226
+ /**
227
+ * Verify LINE's `x-line-signature` header against the raw request body.
228
+ *
229
+ * Returns `false` for a missing, malformed or mismatched signature — never throws, so a hostile
230
+ * header cannot become an unhandled error on the webhook path. Compare against the RAW body: any
231
+ * re-serialisation of the parsed JSON changes the bytes and invalidates the signature.
232
+ */
204
233
  declare function verifyLineSignature(channelSecret: string, rawBody: string, signatureHeader: string | undefined): boolean;
205
234
 
206
235
  /**
@@ -232,10 +261,18 @@ interface WebhookServerOptions {
232
261
  /** Inject an existing Express app. */
233
262
  readonly app?: Express;
234
263
  }
264
+ /** A started HTTP listener, with the handle needed to shut it down again. */
235
265
  interface WebhookServer {
236
266
  start(): Promise<void>;
237
267
  stop(): Promise<void>;
238
268
  }
269
+ /**
270
+ * Build the HTTP listener that receives LINE's webhook deliveries.
271
+ *
272
+ * LINE dials in, so this endpoint must be reachable over public HTTPS and registered in the LINE
273
+ * console — unlike the connection-based adapters, inbound cannot work behind a firewall. `express`
274
+ * is loaded lazily, so a project that only sends messages never pays for it.
275
+ */
239
276
  declare function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer>;
240
277
 
241
278
  export { ConfigurationError, LineAdapter, type LineAdapterOptions, type LineMessage, type LineSource, type LineWebhookEnvelope, type LineWebhookEvent, ReplyTokenCache, SDKNotInstalledError, type WebhookServer, type WebhookServerOptions, computeLineSignature, createWebhookServer, lineEventToMessageEvent, mapSourceType, splitForLine, verifyLineSignature };
package/dist/index.js CHANGED
@@ -360,7 +360,11 @@ function handlerFactory(adapter) {
360
360
  res.status(400).type("text/plain").send("missing 'events' array");
361
361
  return;
362
362
  }
363
- void adapter.dispatchWebhookBody(envelope);
363
+ void adapter.dispatchWebhookBody(envelope).catch((err) => {
364
+ const message = err instanceof Error ? err.message : String(err);
365
+ process.stderr.write(`[gateway-line] webhook dispatch failed: ${message}
366
+ `);
367
+ });
364
368
  res.status(200).end();
365
369
  };
366
370
  }
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/normalize.ts","../src/reply-cache.ts","../src/split.ts","../src/adapter.ts","../src/signature.ts","../src/webhook-server.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-line`.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2) — only the package prefix is package-specific. Name,\n * message shape, `code`/`detail` fields, and `instanceof` are byte-identical\n * to the previous hand-rolled class (pinned by `tests/errors.test.ts`).\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-line\", opts);\n }\n}\n\nexport class SDKNotInstalledError extends ConfigurationError {\n constructor(pkgName: string) {\n super({\n code: \"sdk_not_installed\",\n message: `gateway-line: peer-dep \"${pkgName}\" not installed. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * Lazy `@line/bot-sdk` loader + thin Client wrapper for sending.\n */\n\nimport { SDKNotInstalledError } from \"./errors.js\";\n\nexport interface LineSdkClient {\n replyMessage(\n replyToken: string,\n messages: Array<{ type: \"text\"; text: string }>,\n ): Promise<unknown>;\n pushMessage(to: string, messages: Array<{ type: \"text\"; text: string }>): Promise<unknown>;\n /**\n * `GET /v2/bot/info` — the cheapest call that makes LINE judge the token.\n *\n * `connect()` needs it because building a client performs no I/O at all: it\n * would otherwise report success for any string, and the operator would find\n * out at the first send. Telegram, Discord, Slack and Mattermost all surface a\n * bad credential from connect(); Matrix did not until 2026-08-17, and this was\n * the second adapter with the same gap.\n */\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n}\n\n/**\n * The v9 `MessagingApiClient` surface, as declared by the installed\n * `@line/bot-sdk` v9 `messagingApiClient.d.ts`. Both methods take ONE request\n * object — this is not the same shape as {@link LineSdkClient}, and conflating\n * the two is what broke every outbound message before 2026-08-17.\n */\ninterface LineV9Client {\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n replyMessage(request: {\n replyToken: string;\n messages: Array<{ type: \"text\"; text: string }>;\n }): Promise<unknown>;\n pushMessage(\n request: { to: string; messages: Array<{ type: \"text\"; text: string }> },\n xLineRetryKey?: string,\n ): Promise<unknown>;\n}\n\ninterface LineSdkModule {\n Client: new (cfg: { channelAccessToken: string; channelSecret?: string }) => LineSdkClient;\n messagingApi?: {\n MessagingApiClient: new (cfg: { channelAccessToken: string }) => LineV9Client;\n };\n}\n\nexport async function loadLineSdk(): Promise<LineSdkModule> {\n try {\n const mod = await import(\"@line/bot-sdk\");\n return mod as unknown as LineSdkModule;\n } catch {\n throw new SDKNotInstalledError(\"@line/bot-sdk\");\n }\n}\n\n/**\n * Build a client exposing the positional {@link LineSdkClient} shape the adapter\n * calls, from either the legacy (`Client`) or the v9\n * (`messagingApi.MessagingApiClient`) SDK.\n *\n * The v9 client is WRAPPED, not returned directly. An earlier version returned\n * it as-is on the claim that \"v9 SDK exposes both styles\" — it does not. v9\n * declares `replyMessage(request)` and `pushMessage(request, retryKey?)`, each\n * taking a single object, so the adapter's positional call arrived as\n * `{replyToken: undefined, messages: undefined}` and LINE rejected every send\n * with a 400. Since `@line/bot-sdk` is pinned at `^9.0.0`, this branch is the\n * one that always runs: the bug was total, not conditional.\n */\nexport function makeClient(\n mod: LineSdkModule,\n cfg: { channelAccessToken: string; channelSecret: string },\n): LineSdkClient {\n const v9 = mod.messagingApi?.MessagingApiClient;\n if (v9 !== undefined) {\n const client = new v9({ channelAccessToken: cfg.channelAccessToken });\n return {\n async replyMessage(replyToken, messages) {\n return client.replyMessage({ replyToken, messages });\n },\n async pushMessage(to, messages) {\n return client.pushMessage({ to, messages });\n },\n async getBotInfo() {\n return client.getBotInfo();\n },\n };\n }\n return new mod.Client(cfg);\n}\n","/**\n * Inbound normalization: LINE webhook event → LineMessageEvent.\n *\n * EC-4 absorbed: LINE webhook delivers 9 event types. Only `message`\n * events of `text` type are dispatched in v0.1; other types (`follow`,\n * `unfollow`, `postback`, image/audio/sticker messages, etc.) return\n * `undefined` so `adapter.dispatchEvent` skips them silently.\n *\n * D410: source.type mapping `user` → `dm`; `group`/`room` → `group`.\n */\n\nimport type { LineMessageEvent } from \"@theokit/gateway\";\n\nimport type { LineWebhookEvent } from \"./types.js\";\n\nexport function mapSourceType(sourceType: string): \"dm\" | \"group\" | \"thread\" {\n if (sourceType === \"user\") return \"dm\";\n return \"group\";\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: EC-4 event-type filter + source-shape narrowing + mentionee extraction are intentionally co-located so the dispatch contract stays linear.\nexport function lineEventToMessageEvent(event: LineWebhookEvent): LineMessageEvent | undefined {\n // EC-4: filter at the top — non-message events have undefined fields downstream.\n if (event.type !== \"message\") return undefined;\n if (event.message === undefined) return undefined;\n if (event.message.type !== \"text\") return undefined;\n\n const source = event.source;\n if (source === undefined) return undefined;\n\n const sourceId = source.userId ?? source.groupId ?? source.roomId;\n const sourceType = source.type as \"user\" | \"group\" | \"room\";\n if (sourceId === undefined || sourceId.length === 0) return undefined;\n\n const channelId = source.groupId ?? source.roomId ?? source.userId ?? sourceId;\n const channelType = mapSourceType(sourceType);\n\n const mentionees: string[] = [];\n for (const m of event.message.mentionees ?? []) {\n if (m.userId !== undefined && m.userId.length > 0) mentionees.push(m.userId);\n }\n\n return {\n id: event.message.id ?? `line-${event.timestamp ?? Date.now()}`,\n platform: \"line\",\n sender: source.userId !== undefined ? { id: source.userId } : { id: sourceId },\n channel: { id: channelId, type: channelType },\n text: event.message.text ?? \"\",\n receivedAt: event.timestamp ?? Date.now(),\n line: {\n sourceType,\n sourceId,\n messageId: event.message.id ?? \"\",\n mentionees,\n ...(event.replyToken !== undefined ? { replyToken: event.replyToken } : {}),\n raw: event,\n },\n };\n}\n","/**\n * Reply-token LRU cache (D407).\n *\n * `put(userId, token)` — store with 60s TTL.\n * `take(userId)` — atomic one-shot consume; second call returns undefined.\n * `evictExpired()` — periodic GC; called internally before each take.\n *\n * Capacity 1000; oldest dropped when full.\n */\n\nconst DEFAULT_TTL_MS = 60_000;\nconst DEFAULT_CAPACITY = 1000;\n\ninterface Entry {\n token: string;\n expiresAt: number;\n}\n\nexport class ReplyTokenCache {\n private readonly cache = new Map<string, Entry>();\n private readonly ttlMs: number;\n private readonly capacity: number;\n\n constructor(opts?: { ttlMs?: number; capacity?: number }) {\n this.ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;\n this.capacity = opts?.capacity ?? DEFAULT_CAPACITY;\n }\n\n put(userId: string, token: string): void {\n if (this.cache.size >= this.capacity) this.evictOldest();\n this.cache.set(userId, { token, expiresAt: Date.now() + this.ttlMs });\n }\n\n take(userId: string): string | undefined {\n const entry = this.cache.get(userId);\n if (entry === undefined) return undefined;\n this.cache.delete(userId);\n if (Date.now() >= entry.expiresAt) return undefined;\n return entry.token;\n }\n\n size(): number {\n return this.cache.size;\n }\n\n clear(): void {\n this.cache.clear();\n }\n\n private evictOldest(): void {\n const firstKey = this.cache.keys().next().value;\n if (firstKey !== undefined) this.cache.delete(firstKey);\n }\n}\n","/**\n * Grapheme-cluster-safe split for LINE outbound text (D411, EC-7).\n *\n * LINE limits text messages to 5000 chars. Thin wrapper over core\n * `chunkByGrapheme` (roadmap M1) — single-sources the `Intl.Segmenter` grapheme\n * walk so emoji, regional indicators, and combining sequences are never severed.\n * Output is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\nexport function splitForLine(text: string, limit = 5000): string[] {\n return chunkByGrapheme(text, { limit });\n}\n","/**\n * `LineAdapter` — implements BasePlatformAdapter over LINE Messaging API.\n * ADRs D405-D412.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\n\nimport { type LineSdkClient, loadLineSdk, makeClient } from \"./client.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { lineEventToMessageEvent } from \"./normalize.js\";\nimport { ReplyTokenCache } from \"./reply-cache.js\";\nimport { splitForLine } from \"./split.js\";\nimport type { LineAdapterOptions, LineWebhookEnvelope, LineWebhookEvent } from \"./types.js\";\n\nexport class LineAdapter extends BasePlatformAdapter {\n readonly platform = \"line\" as const;\n private readonly opts: LineAdapterOptions;\n private readonly replyCache = new ReplyTokenCache();\n private client: LineSdkClient | undefined;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n\n constructor(opts: LineAdapterOptions) {\n super();\n if (opts.channelSecret.length === 0) {\n throw new ConfigurationError({\n code: \"channel_secret_required\",\n message:\n \"gateway-line: opts.channelSecret is empty (D408 requires signing — no insecure mode)\",\n });\n }\n if (opts.channelAccessToken.length === 0) {\n throw new ConfigurationError({\n code: \"access_token_required\",\n message: \"gateway-line: opts.channelAccessToken is empty\",\n });\n }\n this.opts = opts;\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n const factory = this.opts.__clientFactory;\n if (factory === undefined) {\n const mod = await loadLineSdk();\n this.client = makeClient(mod, {\n channelAccessToken: this.opts.channelAccessToken,\n channelSecret: this.opts.channelSecret,\n });\n } else {\n this.client = factory() as LineSdkClient;\n }\n // Validate the credential before reporting success. Building the client\n // performs NO network I/O, so without this connect() answered true for any\n // string and the failure surfaced only at the first send — as a 401 that\n // looks like a send bug rather than a bad token.\n await this.client.getBotInfo();\n this.connected = true;\n return true;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] connect failed: ${msg}\\n`);\n return false;\n }\n }\n\n async disconnect(): Promise<void> {\n this.connected = false;\n this.client = undefined;\n this.inboundHandler = undefined;\n this.replyCache.clear();\n }\n\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: reply-token-vs-push selection + multipart loop + per-part error mapping is one cohesive send pipeline (D407 + D411); splitting hurts traceability.\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"LineAdapter.connect() not called\" },\n };\n }\n // For DMs: channel.id IS the userId. For groups/rooms: channel.id is groupId/roomId — push API still uses the channel id.\n const targetId = out.channel.id;\n const parts = splitForLine(out.text);\n // Reply API: only the FIRST batch can use the one-shot replyToken; subsequent calls fall back to push.\n const token = this.replyCache.take(targetId);\n let lastErr: SendResult | undefined;\n let messageId: string | undefined;\n for (let i = 0; i < parts.length; i++) {\n const messages = [{ type: \"text\" as const, text: parts[i] ?? \"\" }];\n const isFirst = i === 0;\n try {\n if (isFirst && token !== undefined) {\n await this.client.replyMessage(token, messages);\n } else {\n if (isFirst && token === undefined) {\n process.stderr.write(\n `[gateway-line] no reply token for ${targetId} — using push API\\n`,\n );\n }\n await this.client.pushMessage(targetId, messages);\n }\n messageId = `line-${Date.now()}-${i}`;\n } catch (err) {\n lastErr = mapLineError(err);\n break;\n }\n }\n if (lastErr !== undefined) return lastErr;\n return { ok: true, ...(messageId !== undefined ? { messageId } : {}) };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /** Escape hatch: caller drives Flex/Carousel/etc directly. */\n getClient(): LineSdkClient | undefined {\n return this.client;\n }\n\n /**\n * Webhook entrypoint — called by `createWebhookServer` AFTER signature\n * validation. Iterates LINE's batch envelope and dispatches each event.\n */\n async dispatchWebhookBody(envelope: LineWebhookEnvelope): Promise<void> {\n for (const ev of envelope.events) {\n await this.dispatchSingleEvent(ev);\n }\n }\n\n private async dispatchSingleEvent(ev: LineWebhookEvent): Promise<void> {\n const normalized = lineEventToMessageEvent(ev);\n if (normalized === undefined) return; // EC-4: silently skip non-message / non-text\n // Cache the reply token (one-shot, 60s TTL) keyed by SENDER userId (replies go to whoever spoke).\n if (ev.replyToken !== undefined && normalized.sender.id.length > 0) {\n this.replyCache.put(normalized.sender.id, ev.replyToken);\n }\n // Mention guard (D409).\n if (!this.passesMentionGuard(normalized)) return;\n if (this.inboundHandler === undefined) return;\n try {\n await this.inboundHandler(normalized);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] handler threw: ${msg}\\n`);\n }\n }\n\n private passesMentionGuard(event: GatewayMessageEvent): boolean {\n if (event.platform !== \"line\") return true;\n const requireMention = this.opts.requireMention ?? true;\n if (!requireMention) return true;\n if (event.channel.type === \"dm\") return true;\n if (this.opts.botUserId === undefined) return true; // guard disabled\n return event.line.mentionees.includes(this.opts.botUserId);\n }\n\n /** Expose channel secret for the webhook server (signature middleware). */\n getChannelSecret(): string {\n return this.opts.channelSecret;\n }\n\n /** Used by tests to seed the reply cache (no other path exposes raw cache). */\n _cacheReplyToken(userId: string, token: string): void {\n this.replyCache.put(userId, token);\n }\n}\n\ninterface LineRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n originalError?: { response?: { status?: number } };\n}\n\nfunction mapLineError(err: unknown): SendResult {\n const e = err as LineRestError;\n const status = e.statusCode ?? e.status ?? e.originalError?.response?.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"LINE rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"LINE auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"LINE rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n\n// `computeLineSignature` is already re-exported at the package root via `index.ts`;\n// no need to duplicate here.\n","/**\n * LINE HMAC-SHA256 signature verification (D408).\n *\n * Per LINE Developers docs:\n * signature = base64(hmac_sha256(channelSecret, rawBody))\n *\n * Carried in header `X-Line-Signature`.\n *\n * Always uses `crypto.timingSafeEqual` to prevent timing attacks.\n */\n\nimport crypto from \"node:crypto\";\n\nexport function computeLineSignature(channelSecret: string, rawBody: string): string {\n return crypto.createHmac(\"sha256\", channelSecret).update(rawBody, \"utf8\").digest(\"base64\");\n}\n\nexport function verifyLineSignature(\n channelSecret: string,\n rawBody: string,\n signatureHeader: string | undefined,\n): boolean {\n if (signatureHeader === undefined || signatureHeader.length === 0) return false;\n const expected = computeLineSignature(channelSecret, rawBody);\n const a = Buffer.from(expected);\n const b = Buffer.from(signatureHeader);\n if (a.length !== b.length) return false;\n try {\n return crypto.timingSafeEqual(a, b);\n } catch {\n return false;\n }\n}\n","/**\n * Express webhook server for LINE inbound.\n *\n * Validates `X-Line-Signature` (HMAC-SHA256 over raw body) BEFORE\n * parsing/dispatch — 401 on missing or invalid (D408).\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\n\nimport type { LineAdapter } from \"./adapter.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { verifyLineSignature } from \"./signature.js\";\nimport type { LineWebhookEnvelope } from \"./types.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: LineAdapter;\n /** Mount path; default `/line`. */\n readonly path?: string;\n /** Port to listen on when creating own Express app. Default 3000. */\n readonly port?: number;\n /** Inject an existing Express app. */\n readonly app?: Express;\n}\n\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-line: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction rawCapture(req: Request, _res: Response, next: NextFunction): void {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response at\n // all: the provider times out and retries, and no error is logged anywhere.\n // Failing loudly and continuing is strictly better — verification then\n // refuses the empty body with a 401, which is at least a visible symptom that\n // points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n}\n\nfunction handlerFactory(adapter: LineAdapter) {\n return (req: Request, res: Response): void => {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const signature = headerOf(req, \"x-line-signature\");\n if (!verifyLineSignature(adapter.getChannelSecret(), rawBody, signature)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let envelope: LineWebhookEnvelope;\n try {\n envelope = JSON.parse(rawBody) as LineWebhookEnvelope;\n } catch {\n res.status(400).type(\"text/plain\").send(\"invalid JSON body\");\n return;\n }\n if (!Array.isArray(envelope.events)) {\n res.status(400).type(\"text/plain\").send(\"missing 'events' array\");\n return;\n }\n void adapter.dispatchWebhookBody(envelope);\n // LINE expects a 200 OK quickly to ack the webhook.\n res.status(200).end();\n };\n}\n\nfunction headerOf(req: Request, name: string): string | undefined {\n const v = req.headers[name.toLowerCase()];\n if (v === undefined) return undefined;\n return Array.isArray(v) ? v.join(\",\") : v;\n}\n\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const path = opts.path ?? \"/line\";\n app.post(path, rawCapture, handlerFactory(opts.adapter));\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/normalize.ts","../src/reply-cache.ts","../src/split.ts","../src/adapter.ts","../src/signature.ts","../src/webhook-server.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-line`.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2) — only the package prefix is package-specific. Name,\n * message shape, `code`/`detail` fields, and `instanceof` are byte-identical\n * to the previous hand-rolled class (pinned by `tests/errors.test.ts`).\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\n/**\n * Misconfiguration of this adapter, raised before any network call.\n *\n * Extends the shared core base so every gateway package reports configuration faults in one shape:\n * a structured `code` the caller can branch on, tagged with `\"gateway-line\"` as the origin. A\n * missing credential or an unsupported option is a programmer error, not a transient failure —\n * these are never retried.\n */\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-line\", opts);\n }\n}\n\n/**\n * The platform SDK this adapter needs is declared as a peer dependency and is not installed.\n *\n * Raised at connect time rather than at import, so a project that installs several gateway packages\n * only pays for the SDKs of the ones it actually starts. The message names the exact package and\n * the command that installs it.\n */\nexport class SDKNotInstalledError extends ConfigurationError {\n constructor(pkgName: string) {\n super({\n code: \"sdk_not_installed\",\n message: `gateway-line: peer-dep \"${pkgName}\" not installed. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * Lazy `@line/bot-sdk` loader + thin Client wrapper for sending.\n */\n\nimport { SDKNotInstalledError } from \"./errors.js\";\n\nexport interface LineSdkClient {\n replyMessage(\n replyToken: string,\n messages: Array<{ type: \"text\"; text: string }>,\n ): Promise<unknown>;\n pushMessage(to: string, messages: Array<{ type: \"text\"; text: string }>): Promise<unknown>;\n /**\n * `GET /v2/bot/info` — the cheapest call that makes LINE judge the token.\n *\n * `connect()` needs it because building a client performs no I/O at all: it\n * would otherwise report success for any string, and the operator would find\n * out at the first send. Telegram, Discord, Slack and Mattermost all surface a\n * bad credential from connect(); Matrix did not until 2026-08-17, and this was\n * the second adapter with the same gap.\n */\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n}\n\n/**\n * The v9 `MessagingApiClient` surface, as declared by the installed\n * `@line/bot-sdk` v9 `messagingApiClient.d.ts`. Both methods take ONE request\n * object — this is not the same shape as {@link LineSdkClient}, and conflating\n * the two is what broke every outbound message before 2026-08-17.\n */\ninterface LineV9Client {\n getBotInfo(): Promise<{ userId?: string; displayName?: string }>;\n replyMessage(request: {\n replyToken: string;\n messages: Array<{ type: \"text\"; text: string }>;\n }): Promise<unknown>;\n pushMessage(\n request: { to: string; messages: Array<{ type: \"text\"; text: string }> },\n xLineRetryKey?: string,\n ): Promise<unknown>;\n}\n\ninterface LineSdkModule {\n Client: new (cfg: { channelAccessToken: string; channelSecret?: string }) => LineSdkClient;\n messagingApi?: {\n MessagingApiClient: new (cfg: { channelAccessToken: string }) => LineV9Client;\n };\n}\n\nexport async function loadLineSdk(): Promise<LineSdkModule> {\n try {\n const mod = await import(\"@line/bot-sdk\");\n return mod as unknown as LineSdkModule;\n } catch {\n throw new SDKNotInstalledError(\"@line/bot-sdk\");\n }\n}\n\n/**\n * Build a client exposing the positional {@link LineSdkClient} shape the adapter\n * calls, from either the legacy (`Client`) or the v9\n * (`messagingApi.MessagingApiClient`) SDK.\n *\n * The v9 client is WRAPPED, not returned directly. An earlier version returned\n * it as-is on the claim that \"v9 SDK exposes both styles\" — it does not. v9\n * declares `replyMessage(request)` and `pushMessage(request, retryKey?)`, each\n * taking a single object, so the adapter's positional call arrived as\n * `{replyToken: undefined, messages: undefined}` and LINE rejected every send\n * with a 400. Since `@line/bot-sdk` is pinned at `^9.0.0`, this branch is the\n * one that always runs: the bug was total, not conditional.\n */\nexport function makeClient(\n mod: LineSdkModule,\n cfg: { channelAccessToken: string; channelSecret: string },\n): LineSdkClient {\n const v9 = mod.messagingApi?.MessagingApiClient;\n if (v9 !== undefined) {\n const client = new v9({ channelAccessToken: cfg.channelAccessToken });\n return {\n async replyMessage(replyToken, messages) {\n return client.replyMessage({ replyToken, messages });\n },\n async pushMessage(to, messages) {\n return client.pushMessage({ to, messages });\n },\n async getBotInfo() {\n return client.getBotInfo();\n },\n };\n }\n return new mod.Client(cfg);\n}\n","/**\n * Inbound normalization: LINE webhook event → LineMessageEvent.\n *\n * EC-4 absorbed: LINE webhook delivers 9 event types. Only `message`\n * events of `text` type are dispatched in v0.1; other types (`follow`,\n * `unfollow`, `postback`, image/audio/sticker messages, etc.) return\n * `undefined` so `adapter.dispatchEvent` skips them silently.\n *\n * D410: source.type mapping `user` → `dm`; `group`/`room` → `group`.\n */\n\nimport type { LineMessageEvent } from \"@theokit/gateway\";\n\nimport type { LineWebhookEvent } from \"./types.js\";\n\nexport function mapSourceType(sourceType: string): \"dm\" | \"group\" | \"thread\" {\n if (sourceType === \"user\") return \"dm\";\n return \"group\";\n}\n\n/**\n * Turn one LINE webhook event into a `LineMessageEvent`, or `undefined` when it is not a text\n * message.\n *\n * A LINE delivery carries a batch of heterogeneous events — follows, joins, stickers, images.\n * Returning `undefined` for the ones this adapter does not handle is the normal path, not an error.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: EC-4 event-type filter + source-shape narrowing + mentionee extraction are intentionally co-located so the dispatch contract stays linear.\nexport function lineEventToMessageEvent(event: LineWebhookEvent): LineMessageEvent | undefined {\n // EC-4: filter at the top — non-message events have undefined fields downstream.\n if (event.type !== \"message\") return undefined;\n if (event.message === undefined) return undefined;\n if (event.message.type !== \"text\") return undefined;\n\n const source = event.source;\n if (source === undefined) return undefined;\n\n const sourceId = source.userId ?? source.groupId ?? source.roomId;\n const sourceType = source.type as \"user\" | \"group\" | \"room\";\n if (sourceId === undefined || sourceId.length === 0) return undefined;\n\n const channelId = source.groupId ?? source.roomId ?? source.userId ?? sourceId;\n const channelType = mapSourceType(sourceType);\n\n const mentionees: string[] = [];\n for (const m of event.message.mentionees ?? []) {\n if (m.userId !== undefined && m.userId.length > 0) mentionees.push(m.userId);\n }\n\n return {\n id: event.message.id ?? `line-${event.timestamp ?? Date.now()}`,\n platform: \"line\",\n sender: source.userId !== undefined ? { id: source.userId } : { id: sourceId },\n channel: { id: channelId, type: channelType },\n text: event.message.text ?? \"\",\n receivedAt: event.timestamp ?? Date.now(),\n line: {\n sourceType,\n sourceId,\n messageId: event.message.id ?? \"\",\n mentionees,\n ...(event.replyToken !== undefined ? { replyToken: event.replyToken } : {}),\n raw: event,\n },\n };\n}\n","/**\n * Reply-token LRU cache (D407).\n *\n * `put(userId, token)` — store with 60s TTL.\n * `take(userId)` — atomic one-shot consume; second call returns undefined.\n * `evictExpired()` — periodic GC; called internally before each take.\n *\n * Capacity 1000; oldest dropped when full.\n */\n\nconst DEFAULT_TTL_MS = 60_000;\nconst DEFAULT_CAPACITY = 1000;\n\ninterface Entry {\n token: string;\n expiresAt: number;\n}\n\nexport class ReplyTokenCache {\n private readonly cache = new Map<string, Entry>();\n private readonly ttlMs: number;\n private readonly capacity: number;\n\n constructor(opts?: { ttlMs?: number; capacity?: number }) {\n this.ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;\n this.capacity = opts?.capacity ?? DEFAULT_CAPACITY;\n }\n\n put(userId: string, token: string): void {\n if (this.cache.size >= this.capacity) this.evictOldest();\n this.cache.set(userId, { token, expiresAt: Date.now() + this.ttlMs });\n }\n\n take(userId: string): string | undefined {\n const entry = this.cache.get(userId);\n if (entry === undefined) return undefined;\n this.cache.delete(userId);\n if (Date.now() >= entry.expiresAt) return undefined;\n return entry.token;\n }\n\n size(): number {\n return this.cache.size;\n }\n\n clear(): void {\n this.cache.clear();\n }\n\n private evictOldest(): void {\n const firstKey = this.cache.keys().next().value;\n if (firstKey !== undefined) this.cache.delete(firstKey);\n }\n}\n","/**\n * Grapheme-cluster-safe split for LINE outbound text (D411, EC-7).\n *\n * LINE limits text messages to 5000 chars. Thin wrapper over core\n * `chunkByGrapheme` (roadmap M1) — single-sources the `Intl.Segmenter` grapheme\n * walk so emoji, regional indicators, and combining sequences are never severed.\n * Output is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\nexport function splitForLine(text: string, limit = 5000): string[] {\n return chunkByGrapheme(text, { limit });\n}\n","/**\n * `LineAdapter` — implements BasePlatformAdapter over LINE Messaging API.\n * ADRs D405-D412.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\n\nimport { type LineSdkClient, loadLineSdk, makeClient } from \"./client.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { lineEventToMessageEvent } from \"./normalize.js\";\nimport { ReplyTokenCache } from \"./reply-cache.js\";\nimport { splitForLine } from \"./split.js\";\nimport type { LineAdapterOptions, LineWebhookEnvelope, LineWebhookEvent } from \"./types.js\";\n\nexport class LineAdapter extends BasePlatformAdapter {\n readonly platform = \"line\" as const;\n private readonly opts: LineAdapterOptions;\n private readonly replyCache = new ReplyTokenCache();\n private client: LineSdkClient | undefined;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n\n constructor(opts: LineAdapterOptions) {\n super();\n if (opts.channelSecret.length === 0) {\n throw new ConfigurationError({\n code: \"channel_secret_required\",\n message:\n \"gateway-line: opts.channelSecret is empty (D408 requires signing — no insecure mode)\",\n });\n }\n if (opts.channelAccessToken.length === 0) {\n throw new ConfigurationError({\n code: \"access_token_required\",\n message: \"gateway-line: opts.channelAccessToken is empty\",\n });\n }\n this.opts = opts;\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n const factory = this.opts.__clientFactory;\n if (factory === undefined) {\n const mod = await loadLineSdk();\n this.client = makeClient(mod, {\n channelAccessToken: this.opts.channelAccessToken,\n channelSecret: this.opts.channelSecret,\n });\n } else {\n this.client = factory() as LineSdkClient;\n }\n // Validate the credential before reporting success. Building the client\n // performs NO network I/O, so without this connect() answered true for any\n // string and the failure surfaced only at the first send — as a 401 that\n // looks like a send bug rather than a bad token.\n await this.client.getBotInfo();\n this.connected = true;\n return true;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] connect failed: ${msg}\\n`);\n return false;\n }\n }\n\n async disconnect(): Promise<void> {\n this.connected = false;\n this.client = undefined;\n this.inboundHandler = undefined;\n this.replyCache.clear();\n }\n\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: reply-token-vs-push selection + multipart loop + per-part error mapping is one cohesive send pipeline (D407 + D411); splitting hurts traceability.\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"LineAdapter.connect() not called\" },\n };\n }\n // For DMs: channel.id IS the userId. For groups/rooms: channel.id is groupId/roomId — push API still uses the channel id.\n const targetId = out.channel.id;\n const parts = splitForLine(out.text);\n // Reply API: only the FIRST batch can use the one-shot replyToken; subsequent calls fall back to push.\n const token = this.replyCache.take(targetId);\n let lastErr: SendResult | undefined;\n let messageId: string | undefined;\n for (let i = 0; i < parts.length; i++) {\n const messages = [{ type: \"text\" as const, text: parts[i] ?? \"\" }];\n const isFirst = i === 0;\n try {\n if (isFirst && token !== undefined) {\n await this.client.replyMessage(token, messages);\n } else {\n if (isFirst && token === undefined) {\n process.stderr.write(\n `[gateway-line] no reply token for ${targetId} — using push API\\n`,\n );\n }\n await this.client.pushMessage(targetId, messages);\n }\n messageId = `line-${Date.now()}-${i}`;\n } catch (err) {\n lastErr = mapLineError(err);\n break;\n }\n }\n if (lastErr !== undefined) return lastErr;\n return { ok: true, ...(messageId !== undefined ? { messageId } : {}) };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /** Escape hatch: caller drives Flex/Carousel/etc directly. */\n getClient(): LineSdkClient | undefined {\n return this.client;\n }\n\n /**\n * Webhook entrypoint — called by `createWebhookServer` AFTER signature\n * validation. Iterates LINE's batch envelope and dispatches each event.\n */\n async dispatchWebhookBody(envelope: LineWebhookEnvelope): Promise<void> {\n for (const ev of envelope.events) {\n await this.dispatchSingleEvent(ev);\n }\n }\n\n private async dispatchSingleEvent(ev: LineWebhookEvent): Promise<void> {\n const normalized = lineEventToMessageEvent(ev);\n if (normalized === undefined) return; // EC-4: silently skip non-message / non-text\n // Cache the reply token (one-shot, 60s TTL) keyed by SENDER userId (replies go to whoever spoke).\n if (ev.replyToken !== undefined && normalized.sender.id.length > 0) {\n this.replyCache.put(normalized.sender.id, ev.replyToken);\n }\n // Mention guard (D409).\n if (!this.passesMentionGuard(normalized)) return;\n if (this.inboundHandler === undefined) return;\n try {\n await this.inboundHandler(normalized);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] handler threw: ${msg}\\n`);\n }\n }\n\n private passesMentionGuard(event: GatewayMessageEvent): boolean {\n if (event.platform !== \"line\") return true;\n const requireMention = this.opts.requireMention ?? true;\n if (!requireMention) return true;\n if (event.channel.type === \"dm\") return true;\n if (this.opts.botUserId === undefined) return true; // guard disabled\n return event.line.mentionees.includes(this.opts.botUserId);\n }\n\n /** Expose channel secret for the webhook server (signature middleware). */\n getChannelSecret(): string {\n return this.opts.channelSecret;\n }\n\n /** Used by tests to seed the reply cache (no other path exposes raw cache). */\n _cacheReplyToken(userId: string, token: string): void {\n this.replyCache.put(userId, token);\n }\n}\n\ninterface LineRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n originalError?: { response?: { status?: number } };\n}\n\nfunction mapLineError(err: unknown): SendResult {\n const e = err as LineRestError;\n const status = e.statusCode ?? e.status ?? e.originalError?.response?.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"LINE rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"LINE auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"LINE rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n\n// `computeLineSignature` is already re-exported at the package root via `index.ts`;\n// no need to duplicate here.\n","/**\n * LINE HMAC-SHA256 signature verification (D408).\n *\n * Per LINE Developers docs:\n * signature = base64(hmac_sha256(channelSecret, rawBody))\n *\n * Carried in header `X-Line-Signature`.\n *\n * Always uses `crypto.timingSafeEqual` to prevent timing attacks.\n */\n\nimport crypto from \"node:crypto\";\n\nexport function computeLineSignature(channelSecret: string, rawBody: string): string {\n return crypto.createHmac(\"sha256\", channelSecret).update(rawBody, \"utf8\").digest(\"base64\");\n}\n\n/**\n * Verify LINE's `x-line-signature` header against the raw request body.\n *\n * Returns `false` for a missing, malformed or mismatched signature — never throws, so a hostile\n * header cannot become an unhandled error on the webhook path. Compare against the RAW body: any\n * re-serialisation of the parsed JSON changes the bytes and invalidates the signature.\n */\nexport function verifyLineSignature(\n channelSecret: string,\n rawBody: string,\n signatureHeader: string | undefined,\n): boolean {\n if (signatureHeader === undefined || signatureHeader.length === 0) return false;\n const expected = computeLineSignature(channelSecret, rawBody);\n const a = Buffer.from(expected);\n const b = Buffer.from(signatureHeader);\n if (a.length !== b.length) return false;\n try {\n return crypto.timingSafeEqual(a, b);\n } catch {\n return false;\n }\n}\n","/**\n * Express webhook server for LINE inbound.\n *\n * Validates `X-Line-Signature` (HMAC-SHA256 over raw body) BEFORE\n * parsing/dispatch — 401 on missing or invalid (D408).\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\n\nimport type { LineAdapter } from \"./adapter.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { verifyLineSignature } from \"./signature.js\";\nimport type { LineWebhookEnvelope } from \"./types.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: LineAdapter;\n /** Mount path; default `/line`. */\n readonly path?: string;\n /** Port to listen on when creating own Express app. Default 3000. */\n readonly port?: number;\n /** Inject an existing Express app. */\n readonly app?: Express;\n}\n\n/** A started HTTP listener, with the handle needed to shut it down again. */\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-line: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction rawCapture(req: Request, _res: Response, next: NextFunction): void {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response at\n // all: the provider times out and retries, and no error is logged anywhere.\n // Failing loudly and continuing is strictly better — verification then\n // refuses the empty body with a 401, which is at least a visible symptom that\n // points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n}\n\nfunction handlerFactory(adapter: LineAdapter) {\n return (req: Request, res: Response): void => {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const signature = headerOf(req, \"x-line-signature\");\n if (!verifyLineSignature(adapter.getChannelSecret(), rawBody, signature)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let envelope: LineWebhookEnvelope;\n try {\n envelope = JSON.parse(rawBody) as LineWebhookEnvelope;\n } catch {\n res.status(400).type(\"text/plain\").send(\"invalid JSON body\");\n return;\n }\n if (!Array.isArray(envelope.events)) {\n res.status(400).type(\"text/plain\").send(\"missing 'events' array\");\n return;\n }\n // Answered before dispatch, on purpose: LINE retries a webhook it did not see a 200 for,\n // and waiting on the handler turns a slow one into a duplicate delivery. What that costs is\n // that the dispatch is floated — and a floated rejection is an unhandled one, which ends the\n // process (the defect fixed across the other adapters in #41). The catch is what makes the\n // early answer safe rather than merely fast.\n void adapter.dispatchWebhookBody(envelope).catch((err: unknown) => {\n const message = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-line] webhook dispatch failed: ${message}\\n`);\n });\n // LINE expects a 200 OK quickly to ack the webhook.\n res.status(200).end();\n };\n}\n\nfunction headerOf(req: Request, name: string): string | undefined {\n const v = req.headers[name.toLowerCase()];\n if (v === undefined) return undefined;\n return Array.isArray(v) ? v.join(\",\") : v;\n}\n\n/**\n * Build the HTTP listener that receives LINE's webhook deliveries.\n *\n * LINE dials in, so this endpoint must be reachable over public HTTPS and registered in the LINE\n * console — unlike the connection-based adapters, inbound cannot work behind a firewall. `express`\n * is loaded lazily, so a project that only sends messages never pays for it.\n */\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const path = opts.path ?? \"/line\";\n app.post(path, rawCapture, handlerFactory(opts.adapter));\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
package/package.json CHANGED
@@ -1,8 +1,13 @@
1
1
  {
2
2
  "name": "@theokit/gateway-line",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "LINE Messaging API platform adapter for @theokit/gateway. ADRs D405-D412.",
5
5
  "license": "Apache-2.0",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/usetheokit/theokit-gateways.git",
9
+ "directory": "packages/gateway-line"
10
+ },
6
11
  "type": "module",
7
12
  "engines": {
8
13
  "node": ">=22.12.0"
@@ -31,9 +36,9 @@
31
36
  ],
32
37
  "peerDependencies": {
33
38
  "@line/bot-sdk": "^9.0.0",
39
+ "@theokit/gateway": ">=0.6.0 <1.0.0",
34
40
  "@theokit/sdk": "^2.18.0",
35
- "express": "^4.18.0",
36
- "@theokit/gateway": "^0.5.1"
41
+ "express": "^4.18.0"
37
42
  },
38
43
  "peerDependenciesMeta": {
39
44
  "@line/bot-sdk": {
@@ -51,7 +56,11 @@
51
56
  "typescript": "^5.8.0",
52
57
  "vitest": "^4.1.8",
53
58
  "zod": "^4.0.0",
54
- "@theokit/gateway": "0.5.1"
59
+ "@theokit/gateway": "0.6.0"
60
+ },
61
+ "publishConfig": {
62
+ "access": "public",
63
+ "provenance": true
55
64
  },
56
65
  "scripts": {
57
66
  "build": "tsup",