@theokit/gateway-line 0.1.0

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 ADDED
@@ -0,0 +1,35 @@
1
+ # Changelog
2
+
3
+ ## 2.0.0
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies
8
+ - @theokit/sdk@1.3.0
9
+ - @theokit/gateway@2.0.0
10
+
11
+ ## 1.0.0
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies
16
+ - @theokit/sdk@1.2.0
17
+ - @theokit/gateway@1.0.0
18
+
19
+ ## [Unreleased]
20
+
21
+ ### Added — `@theokit/gateway-line@0.1.0` (ADRs D405-D412)
22
+
23
+ - Initial release of the LINE Messaging API adapter for `@theokit/gateway`.
24
+ - `@line/bot-sdk@^9.0.0` peer-dep (lazy import + signature support).
25
+ - Webhook-only transport (D406) — `createWebhookServer({ adapter, path, port })` with raw-body capture, HMAC-SHA256 signature middleware (D408), and 401 BEFORE handler dispatch.
26
+ - LineAdapter extends BasePlatformAdapter:
27
+ - `connect()` validates channel secret + channel access token (D414 mirror).
28
+ - `sendMessage()` uses **reply token first**, falls back to push API after token expiry (D407). Per-userId LRU cache (1000 entries, 60s TTL, one-shot consume).
29
+ - `splitForLine()` 5000-char surrogate-safe split (D411, EC-7 pattern).
30
+ - `onInbound()` replace semantics (EC-H).
31
+ - Mentionee handling (D409, EC-2 absorbed): `event.message.mentionees[]` extracted to `event.line.mentionees` (userId list, never inline `@text` confusion).
32
+ - Source-type mapping (D410): `user` → `dm`, `group`/`room` → `group`. No threads in v0.1.
33
+ - EC-4 absorbed: webhook delivers 9 event types (`message`, `follow`, `unfollow`, `join`, `leave`, `postback`, `beacon`, `accountLink`, `things`). `normalize.ts` filters `event.type !== "message"` AND `event.message.type !== "text"` at the top — no TypeErrors on non-text events.
34
+ - Signature middleware uses `crypto.timingSafeEqual` (D408).
35
+ - Flex Message + Carousel deferred to v0.2 (D412) — caller can drive via `adapter.getClient().pushMessage(...)` escape hatch.
package/README.md ADDED
@@ -0,0 +1,113 @@
1
+ # @theokit/gateway-line
2
+
3
+ LINE Messaging API platform adapter for [`@theokit/gateway`](../gateway).
4
+
5
+ APAC consumer dominant — Japan (~85M MAU), Taiwan, Thailand. Webhook-only inbound (LINE doesn't offer a WebSocket gateway). HMAC-SHA256 signature validation on every POST.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ pnpm add @theokit/sdk @theokit/gateway @theokit/gateway-line
11
+ pnpm add @line/bot-sdk express
12
+ ```
13
+
14
+ ## Quick start
15
+
16
+ ```ts
17
+ import { Agent } from "@theokit/sdk";
18
+ import { GatewayRunner } from "@theokit/gateway";
19
+ import { LineAdapter, createWebhookServer } from "@theokit/gateway-line";
20
+
21
+ const adapter = new LineAdapter({
22
+ channelSecret: process.env.LINE_CHANNEL_SECRET!,
23
+ channelAccessToken: process.env.LINE_CHANNEL_ACCESS_TOKEN!,
24
+ // botUserId optional — used for mentionee-based mention guard (D409).
25
+ // requireMention: true, // default
26
+ });
27
+
28
+ const runner = new GatewayRunner({
29
+ adapters: [adapter],
30
+ handler: async (event, ctx) => {
31
+ if (event.platform !== "line") return;
32
+ await ctx.reply(`Echo: ${event.text}`);
33
+ },
34
+ });
35
+
36
+ await runner.start();
37
+ const server = await createWebhookServer({ adapter, port: 3000 });
38
+ await server.start();
39
+ ```
40
+
41
+ ### LINE Developers Console
42
+
43
+ 1. Sign in at [developers.line.biz/console](https://developers.line.biz/console).
44
+ 2. Create a Provider, then a Messaging API channel.
45
+ 3. Copy **Channel secret** → `LINE_CHANNEL_SECRET`.
46
+ 4. Issue a **Channel access token** (long-lived) → `LINE_CHANNEL_ACCESS_TOKEN`.
47
+ 5. Webhook URL: `https://${PUBLIC_URL}/line` — paste the public URL.
48
+ 6. Enable "Use webhook". Disable "Auto-reply messages" + "Greeting messages" (otherwise LINE replies first).
49
+ 7. Optional: configure bot username and add the bot as a friend (LINE Officlal Account Manager) — required for DMs to flow.
50
+
51
+ For local dev: `ngrok http 3000` and use the https URL.
52
+
53
+ ## Reply token vs Push (D407)
54
+
55
+ LINE distinguishes two outbound APIs:
56
+
57
+ - **Reply API** (free, unlimited): use within 1 minute of the inbound event. Requires the one-shot `replyToken` that came with the event.
58
+ - **Push API** (free up to 500/month then $$$): use any time, by `userId`.
59
+
60
+ The adapter handles this automatically:
61
+
62
+ 1. Inbound event has `event.line.replyToken` → cached `(userId → token, 60s TTL)`.
63
+ 2. First outbound to that user consumes the token (Reply API).
64
+ 3. Subsequent outbound to that user (token expired) auto-falls-back to Push API (warn stderr).
65
+
66
+ Cap: 1000 entries (LRU eviction).
67
+
68
+ ## Mention guard (D409)
69
+
70
+ LINE mentions are out-of-band — not inline `@text`. The webhook delivers them as `event.message.mentionees: [{ index, length, userId }]`. Adapter normalizes to `event.line.mentionees: string[]` (userId list). When `requireMention: true` (default) AND `botUserId` is configured, the adapter checks whether `botUserId in mentionees` before dispatching.
71
+
72
+ ```ts
73
+ const adapter = new LineAdapter({
74
+ channelSecret: ...,
75
+ channelAccessToken: ...,
76
+ botUserId: "Uxxxxxx", // your bot's LINE user ID
77
+ requireMention: true,
78
+ });
79
+ ```
80
+
81
+ If `botUserId` is unset, the mention guard is disabled (all messages dispatch).
82
+
83
+ ## Event-type filter (EC-4 absorbed)
84
+
85
+ LINE webhook delivers 9 event types: `message`, `follow`, `unfollow`, `join`, `leave`, `postback`, `beacon`, `accountLink`, `things`. The adapter dispatches **only `message` events of type `text`**. Other event types — including image/audio/video/sticker/location/postback — are filtered before reaching your handler in v0.1. No TypeErrors on unexpected events.
86
+
87
+ ## Channel-type mapping (D410)
88
+
89
+ | LINE source.type | Adapter `channel.type` |
90
+ |---|---|
91
+ | `user` (1:1) | `"dm"` |
92
+ | `group` | `"group"` |
93
+ | `room` (ad-hoc multi-user) | `"group"` |
94
+
95
+ `event.line.sourceType` preserves the original.
96
+
97
+ ## Multipart split (D411)
98
+
99
+ LINE caps text messages at 5000 chars. The adapter splits longer text into surrogate-safe chunks (grapheme-cluster boundaries via `Intl.Segmenter`), each ≤5000 chars. Each chunk is one billable message (Push API after free tier).
100
+
101
+ ## What's NOT supported in v0.1
102
+
103
+ | Feature | Status | Workaround |
104
+ |---|---|---|
105
+ | Flex Message | Deferred to v0.2 (D412) | `adapter.getClient().pushMessage(userId, flexMessage)` |
106
+ | Carousel template | Deferred to v0.2 (D412) | Same |
107
+ | Image/audio/video/sticker inbound | Filtered (EC-4) | Read via `event.line.raw` if needed |
108
+ | Quick replies | Deferred to v0.2 | — |
109
+ | Rich menu | Deferred to v0.2 | — |
110
+
111
+ ## ADRs
112
+
113
+ D405 – D412 in `.claude/knowledge-base/adrs/`.
package/dist/index.cjs ADDED
@@ -0,0 +1,417 @@
1
+ 'use strict';
2
+
3
+ var gateway = require('@theokit/gateway');
4
+ var crypto = require('crypto');
5
+
6
+ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
7
+
8
+ var crypto__default = /*#__PURE__*/_interopDefault(crypto);
9
+
10
+ // src/adapter.ts
11
+
12
+ // src/errors.ts
13
+ var ConfigurationError = class extends Error {
14
+ name = "ConfigurationError";
15
+ code;
16
+ detail;
17
+ constructor(opts) {
18
+ super(opts.message ?? `gateway-line: ${opts.code}`);
19
+ this.code = opts.code;
20
+ this.detail = opts.detail;
21
+ }
22
+ };
23
+ var SDKNotInstalledError = class extends ConfigurationError {
24
+ constructor(pkgName) {
25
+ super({
26
+ code: "sdk_not_installed",
27
+ message: `gateway-line: peer-dep "${pkgName}" not installed. Run: pnpm add ${pkgName}`,
28
+ detail: pkgName
29
+ });
30
+ }
31
+ };
32
+
33
+ // src/client.ts
34
+ async function loadLineSdk() {
35
+ try {
36
+ const mod = await import('@line/bot-sdk');
37
+ return mod;
38
+ } catch {
39
+ throw new SDKNotInstalledError("@line/bot-sdk");
40
+ }
41
+ }
42
+ function makeClient(mod, cfg) {
43
+ if (mod.messagingApi?.MessagingApiClient !== void 0) {
44
+ return new mod.messagingApi.MessagingApiClient({ channelAccessToken: cfg.channelAccessToken });
45
+ }
46
+ return new mod.Client(cfg);
47
+ }
48
+
49
+ // src/normalize.ts
50
+ function mapSourceType(sourceType) {
51
+ if (sourceType === "user") return "dm";
52
+ return "group";
53
+ }
54
+ function lineEventToMessageEvent(event) {
55
+ if (event.type !== "message") return void 0;
56
+ if (event.message === void 0) return void 0;
57
+ if (event.message.type !== "text") return void 0;
58
+ const source = event.source;
59
+ if (source === void 0) return void 0;
60
+ const sourceId = source.userId ?? source.groupId ?? source.roomId;
61
+ const sourceType = source.type;
62
+ if (sourceId === void 0 || sourceId.length === 0) return void 0;
63
+ const channelId = source.groupId ?? source.roomId ?? source.userId ?? sourceId;
64
+ const channelType = mapSourceType(sourceType);
65
+ const mentionees = [];
66
+ for (const m of event.message.mentionees ?? []) {
67
+ if (m.userId !== void 0 && m.userId.length > 0) mentionees.push(m.userId);
68
+ }
69
+ return {
70
+ id: event.message.id ?? `line-${event.timestamp ?? Date.now()}`,
71
+ platform: "line",
72
+ sender: source.userId !== void 0 ? { id: source.userId } : { id: sourceId },
73
+ channel: { id: channelId, type: channelType },
74
+ text: event.message.text ?? "",
75
+ receivedAt: event.timestamp ?? Date.now(),
76
+ line: {
77
+ sourceType,
78
+ sourceId,
79
+ messageId: event.message.id ?? "",
80
+ mentionees,
81
+ ...event.replyToken !== void 0 ? { replyToken: event.replyToken } : {},
82
+ raw: event
83
+ }
84
+ };
85
+ }
86
+
87
+ // src/reply-cache.ts
88
+ var DEFAULT_TTL_MS = 6e4;
89
+ var DEFAULT_CAPACITY = 1e3;
90
+ var ReplyTokenCache = class {
91
+ cache = /* @__PURE__ */ new Map();
92
+ ttlMs;
93
+ capacity;
94
+ constructor(opts) {
95
+ this.ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;
96
+ this.capacity = opts?.capacity ?? DEFAULT_CAPACITY;
97
+ }
98
+ put(userId, token) {
99
+ if (this.cache.size >= this.capacity) this.evictOldest();
100
+ this.cache.set(userId, { token, expiresAt: Date.now() + this.ttlMs });
101
+ }
102
+ take(userId) {
103
+ const entry = this.cache.get(userId);
104
+ if (entry === void 0) return void 0;
105
+ this.cache.delete(userId);
106
+ if (Date.now() >= entry.expiresAt) return void 0;
107
+ return entry.token;
108
+ }
109
+ size() {
110
+ return this.cache.size;
111
+ }
112
+ clear() {
113
+ this.cache.clear();
114
+ }
115
+ evictOldest() {
116
+ const firstKey = this.cache.keys().next().value;
117
+ if (firstKey !== void 0) this.cache.delete(firstKey);
118
+ }
119
+ };
120
+
121
+ // src/split.ts
122
+ function splitForLine(text, limit = 5e3) {
123
+ if (text.length === 0) return [""];
124
+ if (text.length <= limit) return [text];
125
+ const segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
126
+ const segments = Array.from(segmenter.segment(text), (s) => s.segment);
127
+ const parts = [];
128
+ let buf = "";
129
+ for (const seg of segments) {
130
+ if (buf.length + seg.length > limit) {
131
+ if (buf.length > 0) parts.push(buf);
132
+ buf = "";
133
+ }
134
+ buf += seg;
135
+ }
136
+ if (buf.length > 0) parts.push(buf);
137
+ return parts;
138
+ }
139
+
140
+ // src/adapter.ts
141
+ var LineAdapter = class extends gateway.BasePlatformAdapter {
142
+ platform = "line";
143
+ opts;
144
+ replyCache = new ReplyTokenCache();
145
+ client;
146
+ inboundHandler;
147
+ connected = false;
148
+ constructor(opts) {
149
+ super();
150
+ if (opts.channelSecret.length === 0) {
151
+ throw new ConfigurationError({
152
+ code: "channel_secret_required",
153
+ message: "gateway-line: opts.channelSecret is empty (D408 requires signing \u2014 no insecure mode)"
154
+ });
155
+ }
156
+ if (opts.channelAccessToken.length === 0) {
157
+ throw new ConfigurationError({
158
+ code: "access_token_required",
159
+ message: "gateway-line: opts.channelAccessToken is empty"
160
+ });
161
+ }
162
+ this.opts = opts;
163
+ }
164
+ async connect() {
165
+ if (this.connected) return true;
166
+ try {
167
+ const mod = await loadLineSdk();
168
+ this.client = makeClient(mod, {
169
+ channelAccessToken: this.opts.channelAccessToken,
170
+ channelSecret: this.opts.channelSecret
171
+ });
172
+ this.connected = true;
173
+ return true;
174
+ } catch (err) {
175
+ const msg = err instanceof Error ? err.message : String(err);
176
+ process.stderr.write(`[gateway-line] connect failed: ${msg}
177
+ `);
178
+ return false;
179
+ }
180
+ }
181
+ async disconnect() {
182
+ this.connected = false;
183
+ this.client = void 0;
184
+ this.inboundHandler = void 0;
185
+ this.replyCache.clear();
186
+ }
187
+ // 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.
188
+ async sendMessage(out) {
189
+ if (out.text.length === 0) {
190
+ return { ok: false, error: { code: "empty_text", message: "outbound text is empty" } };
191
+ }
192
+ if (this.client === void 0) {
193
+ return {
194
+ ok: false,
195
+ error: { code: "not_connected", message: "LineAdapter.connect() not called" }
196
+ };
197
+ }
198
+ const targetId = out.channel.id;
199
+ const parts = splitForLine(out.text);
200
+ const token = this.replyCache.take(targetId);
201
+ let lastErr;
202
+ let messageId;
203
+ for (let i = 0; i < parts.length; i++) {
204
+ const messages = [{ type: "text", text: parts[i] ?? "" }];
205
+ const isFirst = i === 0;
206
+ try {
207
+ if (isFirst && token !== void 0) {
208
+ await this.client.replyMessage(token, messages);
209
+ } else {
210
+ if (isFirst && token === void 0) {
211
+ process.stderr.write(
212
+ `[gateway-line] no reply token for ${targetId} \u2014 using push API
213
+ `
214
+ );
215
+ }
216
+ await this.client.pushMessage(targetId, messages);
217
+ }
218
+ messageId = `line-${Date.now()}-${i}`;
219
+ } catch (err) {
220
+ lastErr = mapLineError(err);
221
+ break;
222
+ }
223
+ }
224
+ if (lastErr !== void 0) return lastErr;
225
+ return { ok: true, ...messageId !== void 0 ? { messageId } : {} };
226
+ }
227
+ onInbound(handler) {
228
+ this.inboundHandler = handler;
229
+ return () => {
230
+ if (this.inboundHandler === handler) this.inboundHandler = void 0;
231
+ };
232
+ }
233
+ /** Escape hatch: caller drives Flex/Carousel/etc directly. */
234
+ getClient() {
235
+ return this.client;
236
+ }
237
+ /**
238
+ * Webhook entrypoint — called by `createWebhookServer` AFTER signature
239
+ * validation. Iterates LINE's batch envelope and dispatches each event.
240
+ */
241
+ async dispatchWebhookBody(envelope) {
242
+ for (const ev of envelope.events) {
243
+ await this.dispatchSingleEvent(ev);
244
+ }
245
+ }
246
+ async dispatchSingleEvent(ev) {
247
+ const normalized = lineEventToMessageEvent(ev);
248
+ if (normalized === void 0) return;
249
+ if (ev.replyToken !== void 0 && normalized.sender.id.length > 0) {
250
+ this.replyCache.put(normalized.sender.id, ev.replyToken);
251
+ }
252
+ if (!this.passesMentionGuard(normalized)) return;
253
+ if (this.inboundHandler === void 0) return;
254
+ try {
255
+ await this.inboundHandler(normalized);
256
+ } catch (err) {
257
+ const msg = err instanceof Error ? err.message : String(err);
258
+ process.stderr.write(`[gateway-line] handler threw: ${msg}
259
+ `);
260
+ }
261
+ }
262
+ passesMentionGuard(event) {
263
+ if (event.platform !== "line") return true;
264
+ const requireMention = this.opts.requireMention ?? true;
265
+ if (!requireMention) return true;
266
+ if (event.channel.type === "dm") return true;
267
+ if (this.opts.botUserId === void 0) return true;
268
+ return event.line.mentionees.includes(this.opts.botUserId);
269
+ }
270
+ /** Expose channel secret for the webhook server (signature middleware). */
271
+ getChannelSecret() {
272
+ return this.opts.channelSecret;
273
+ }
274
+ /** Used by tests to seed the reply cache (no other path exposes raw cache). */
275
+ _cacheReplyToken(userId, token) {
276
+ this.replyCache.put(userId, token);
277
+ }
278
+ };
279
+ function mapLineError(err) {
280
+ const e = err;
281
+ const status = e.statusCode ?? e.status ?? e.originalError?.response?.status ?? 0;
282
+ if (status === 429) {
283
+ return { ok: false, error: { code: "rate_limit", message: e.message ?? "LINE rate limit" } };
284
+ }
285
+ if (status === 401 || status === 403) {
286
+ return {
287
+ ok: false,
288
+ error: { code: "permission_denied", message: e.message ?? "LINE auth error" }
289
+ };
290
+ }
291
+ if (status === 400) {
292
+ return {
293
+ ok: false,
294
+ error: { code: "invalid_request", message: e.message ?? "LINE rejected request" }
295
+ };
296
+ }
297
+ return {
298
+ ok: false,
299
+ error: {
300
+ code: "send_failed",
301
+ message: e.message ?? (err instanceof Error ? err.message : String(err))
302
+ }
303
+ };
304
+ }
305
+ function computeLineSignature(channelSecret, rawBody) {
306
+ return crypto__default.default.createHmac("sha256", channelSecret).update(rawBody, "utf8").digest("base64");
307
+ }
308
+ function verifyLineSignature(channelSecret, rawBody, signatureHeader) {
309
+ if (signatureHeader === void 0 || signatureHeader.length === 0) return false;
310
+ const expected = computeLineSignature(channelSecret, rawBody);
311
+ const a = Buffer.from(expected);
312
+ const b = Buffer.from(signatureHeader);
313
+ if (a.length !== b.length) return false;
314
+ try {
315
+ return crypto__default.default.timingSafeEqual(a, b);
316
+ } catch {
317
+ return false;
318
+ }
319
+ }
320
+
321
+ // src/webhook-server.ts
322
+ async function loadExpress() {
323
+ try {
324
+ const mod = await import('express');
325
+ const fn = mod.default ?? mod;
326
+ return { default: fn };
327
+ } catch {
328
+ throw new ConfigurationError({
329
+ code: "express_not_installed",
330
+ message: 'gateway-line: peer-dep "express" not installed. Run: pnpm add express'
331
+ });
332
+ }
333
+ }
334
+ function rawCapture(req, _res, next) {
335
+ let buf = "";
336
+ req.setEncoding("utf8");
337
+ req.on("data", (chunk) => {
338
+ buf += chunk;
339
+ });
340
+ req.on("end", () => {
341
+ req.rawBody = buf;
342
+ next();
343
+ });
344
+ req.on("error", (err) => next(err));
345
+ }
346
+ function handlerFactory(adapter) {
347
+ return (req, res) => {
348
+ const rawBody = req.rawBody ?? "";
349
+ const signature = headerOf(req, "x-line-signature");
350
+ if (!verifyLineSignature(adapter.getChannelSecret(), rawBody, signature)) {
351
+ res.status(401).type("text/plain").send("invalid signature");
352
+ return;
353
+ }
354
+ let envelope;
355
+ try {
356
+ envelope = JSON.parse(rawBody);
357
+ } catch {
358
+ res.status(400).type("text/plain").send("invalid JSON body");
359
+ return;
360
+ }
361
+ if (!Array.isArray(envelope.events)) {
362
+ res.status(400).type("text/plain").send("missing 'events' array");
363
+ return;
364
+ }
365
+ void adapter.dispatchWebhookBody(envelope);
366
+ res.status(200).end();
367
+ };
368
+ }
369
+ function headerOf(req, name) {
370
+ const v = req.headers[name.toLowerCase()];
371
+ if (v === void 0) return void 0;
372
+ return Array.isArray(v) ? v.join(",") : v;
373
+ }
374
+ async function createWebhookServer(opts) {
375
+ const expressMod = await loadExpress();
376
+ const app = opts.app ?? expressMod.default();
377
+ const path = opts.path ?? "/line";
378
+ app.post(path, rawCapture, handlerFactory(opts.adapter));
379
+ let server;
380
+ let started = false;
381
+ let stopped = false;
382
+ return {
383
+ async start() {
384
+ if (started || opts.app !== void 0) {
385
+ started = true;
386
+ return;
387
+ }
388
+ const port = opts.port ?? 3e3;
389
+ await new Promise((resolve) => {
390
+ server = app.listen(port, () => resolve());
391
+ });
392
+ started = true;
393
+ },
394
+ async stop() {
395
+ if (stopped) return;
396
+ stopped = true;
397
+ if (server === void 0) return;
398
+ await new Promise((resolve) => {
399
+ server?.close(() => resolve());
400
+ });
401
+ server = void 0;
402
+ }
403
+ };
404
+ }
405
+
406
+ exports.ConfigurationError = ConfigurationError;
407
+ exports.LineAdapter = LineAdapter;
408
+ exports.ReplyTokenCache = ReplyTokenCache;
409
+ exports.SDKNotInstalledError = SDKNotInstalledError;
410
+ exports.computeLineSignature = computeLineSignature;
411
+ exports.createWebhookServer = createWebhookServer;
412
+ exports.lineEventToMessageEvent = lineEventToMessageEvent;
413
+ exports.mapSourceType = mapSourceType;
414
+ exports.splitForLine = splitForLine;
415
+ exports.verifyLineSignature = verifyLineSignature;
416
+ //# sourceMappingURL=index.cjs.map
417
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +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":["BasePlatformAdapter","crypto"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-line`.\n */\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport interface ConfigurationErrorOptions {\n readonly code: string;\n readonly message?: string;\n readonly detail?: string;\n}\n\nexport class ConfigurationError extends Error {\n override readonly name = \"ConfigurationError\";\n readonly code: string;\n readonly detail: string | undefined;\n constructor(opts: ConfigurationErrorOptions) {\n super(opts.message ?? `gateway-line: ${opts.code}`);\n this.code = opts.code;\n this.detail = opts.detail;\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\ninterface LineSdkModule {\n Client: new (cfg: { channelAccessToken: string; channelSecret?: string }) => LineSdkClient;\n messagingApi?: {\n MessagingApiClient: new (cfg: { channelAccessToken: string }) => LineSdkClient;\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 compatible with both legacy (`Client`) and v9 (`messagingApi.MessagingApiClient`).\n * We return the legacy shape (`replyMessage` / `pushMessage`) — v9 SDK exposes both styles.\n */\nexport function makeClient(\n mod: LineSdkModule,\n cfg: { channelAccessToken: string; channelSecret: string },\n): LineSdkClient {\n if (mod.messagingApi?.MessagingApiClient !== undefined) {\n return new mod.messagingApi.MessagingApiClient({ channelAccessToken: cfg.channelAccessToken });\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. We segment with `Intl.Segmenter`\n * so emoji, regional indicators, and combining sequences are never\n * severed.\n */\n\nexport function splitForLine(text: string, limit = 5000): string[] {\n if (text.length === 0) return [\"\"];\n if (text.length <= limit) return [text];\n\n const segmenter = new Intl.Segmenter(undefined, { granularity: \"grapheme\" });\n const segments = Array.from(segmenter.segment(text), (s) => s.segment);\n const parts: string[] = [];\n let buf = \"\";\n for (const seg of segments) {\n if (buf.length + seg.length > limit) {\n if (buf.length > 0) parts.push(buf);\n buf = \"\";\n }\n buf += seg;\n }\n if (buf.length > 0) parts.push(buf);\n return parts;\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 mod = await loadLineSdk();\n this.client = makeClient(mod, {\n channelAccessToken: this.opts.channelAccessToken,\n channelSecret: this.opts.channelSecret,\n });\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 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"]}