line-bot-sdk-rs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 N-API for Rust
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+# line-bot-sdk
+
+High-performance [LINE Messaging API](https://developers.line.biz/en/reference/messaging-api/) SDK for **Node.js / TypeScript**, powered by **Rust** native bindings via [napi-rs](https://napi.rs).
+
+> **Disclaimer:** This is a community SDK and is **not** affiliated with or endorsed by LINE Corporation. For the official SDK, see [@line/bot-sdk](https://www.npmjs.com/package/@line/bot-sdk).
+
+## Features
+
+- **Native performance** — core HTTP client and crypto run in Rust
+- **Full TypeScript support** — auto-generated types + ergonomic wrapper
+- **Messaging** — push, reply, multicast, broadcast, quota, content download
+- **Profile & followers** — user profile, follower IDs
+- **Group & room** — member profiles, member IDs, leave group/room
+- **Rich menu** — create, upload image, link/unlink, bulk operations
+- **Insight** — message delivery overview, followers statistics
+- **Webhook** — signature verification and typed event parsing
+
+## Requirements
+
+- Node.js `>= 18.17.0` (or 20+, 21+)
+- [Rust](https://rustup.rs/) (for building from source)
+
+## Installation
+
+```bash
+npm install @panudetingai/line-bot-sdk
+# or
+yarn add @panudetingai/line-bot-sdk
+```
+
+## Quick Start
+
+### 1. Create a client
+
+Get your **Channel Access Token** from [LINE Developers Console](https://developers.line.biz/console/).
+
+```typescript
+import { LineClient } from '@panudetingai/line-bot-sdk'
+
+const client = new LineClient(process.env.LINE_CHANNEL_ACCESS_TOKEN!)
+
+const bot = await client.getBotInfo()
+console.log(bot.displayName)
+```
+
+### 2. Send messages
+
+```typescript
+await client.pushText('Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Hello from line-bot-sdk!')
+
+await client.pushMessages('Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', [
+  { type: 'text', text: 'Hello!' },
+  { type: 'sticker', packageId: '446', stickerId: '1988' },
+])
+
+await client.replyText(replyToken, 'Got your message!')
+```
+
+### 3. Get user profile
+
+```typescript
+const profile = await client.getProfile('Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx')
+console.log(profile.displayName, profile.pictureUrl)
+```
+
+### 4. Webhook handler (Next.js / Express)
+
+```typescript
+import { verifySignature, parseWebhook, LineClient } from '@panudetingai/line-bot-sdk'
+
+const CHANNEL_SECRET = process.env.LINE_CHANNEL_SECRET!
+const client = new LineClient(process.env.LINE_CHANNEL_ACCESS_TOKEN!)
+
+export async function POST(req: Request) {
+  const rawBody = await req.text()
+  const signature = req.headers.get('x-line-signature') ?? ''
+
+  if (!verifySignature(rawBody, signature, CHANNEL_SECRET)) {
+    return new Response('Invalid signature', { status: 401 })
+  }
+
+  const { events } = parseWebhook(rawBody)
+
+  for (const event of events) {
+    if (event.type === 'message' && event.message?.type === 'text') {
+      await client.replyText(event.replyToken!, `You said: ${event.message.text}`)
+    }
+  }
+
+  return new Response('OK')
+}
+```
+
+## API Overview
+
+### `LineClient`
+
+| Category | Methods |
+|----------|---------|
+| **Bot** | `getBotInfo()` |
+| **Messaging** | `pushText`, `pushMessages`, `replyText`, `replyMessages`, `multicast`, `broadcast` |
+| **Quota** | `getMessageQuota()`, `getMessageQuotaConsumption()` |
+| **Content** | `getMessageContent(messageId)` |
+| **Profile** | `getProfile(userId)`, `getFollowerIds(next?)` |
+| **Group** | `getGroupSummary`, `getGroupMemberProfile`, `getGroupMemberIds`, `leaveGroup` |
+| **Room** | `getRoomMemberProfile`, `getRoomMemberIds`, `leaveRoom` |
+| **Rich Menu** | `createRichMenu`, `uploadRichMenuImage`, `setDefaultRichMenu`, `linkRichMenuToUser`, ... |
+| **Insight** | `getMessageDeliveryOverview(date)`, `getFollowersInsight(date)` |
+
+### Webhook helpers
+
+| Function | Description |
+|----------|-------------|
+| `verifySignature(body, signature, channelSecret)` | Validate `X-Line-Signature` header |
+| `parseWebhook(body)` | Parse webhook JSON into typed `WebhookBody` |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `LINE_CHANNEL_ACCESS_TOKEN` | Channel access token for API calls |
+| `LINE_CHANNEL_SECRET` | Channel secret for webhook signature verification |
+
+Never commit tokens to git. Use `.env` locally and secrets in CI/production.
+
+## Development
+
+```bash
+yarn install
+yarn build:debug
+yarn test
+
+# Integration test with a real token
+LINE_CHANNEL_ACCESS_TOKEN=xxx yarn test
+```
+
+### Project structure
+
+```
+src/
+├── client.rs          # HTTP client & auth
+├── api/endpoints.rs   # LINE API URL paths
+├── services/          # API methods (messaging, profile, group, ...)
+├── types/             # Request/response types
+└── webhook.rs         # Signature verify & event parsing
+
+typescript/
+├── line-client.ts     # Ergonomic TypeScript wrapper
+└── types.ts           # Shared TypeScript types
+```
+
+## Low-level API
+
+Call the native binding directly if you prefer:
+
+```typescript
+import { LineClient } from './index'
+
+const client = new LineClient(token)
+await client.pushMessage('Uxxx', 'hello')
+await client.getProfile('Uxxx')
+```
+
+The TypeScript wrapper in `typescript/line-client.ts` provides a cleaner API (objects instead of JSON strings).
+
+## Platform Support
+
+Prebuilt binaries for:
+
+- macOS (x64, arm64)
+- Linux (x64 gnu)
+- Windows (x64)
+
+Built with [napi-rs](https://napi.rs) — no `node-gyp` or C++ toolchain required for end users.
+
+## Related Projects
+
+- [@line/bot-sdk](https://github.com/line/line-bot-sdk-nodejs) — Official LINE Bot SDK for Node.js
+- [line-bot-sdk-rust](https://crates.io/crates/line-bot-sdk-rust) — LINE SDK for pure Rust applications
+
+## License
+
+MIT © [Panudetingai](https://github.com/Panudetingai)

package/index.d.ts

@@ -0,0 +1,327 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare class LineClient {
+  constructor(accessToken: string)
+  verify(): Promise<BotInfo>
+  getGroupSummary(groupId: string): Promise<GroupSummary>
+  getGroupMemberProfile(groupId: string, userId: string): Promise<GroupMemberProfile>
+  getGroupMemberIds(groupId: string, next?: string | undefined | null): Promise<MemberIds>
+  leaveGroup(groupId: string): Promise<string>
+  getRoomMemberProfile(roomId: string, userId: string): Promise<GroupMemberProfile>
+  getRoomMemberIds(roomId: string, next?: string | undefined | null): Promise<MemberIds>
+  leaveRoom(roomId: string): Promise<string>
+  /** `date` format: YYYYMMDD (e.g. "20240101") */
+  getMessageDeliveryOverview(date: string): Promise<MessageDeliveryOverview>
+  /** `date` format: YYYYMMDD */
+  getFollowersInsight(date: string): Promise<FollowersInsight>
+  pushMessage(to: string, text: string): Promise<string>
+  replyMessage(replyToken: string, text: string): Promise<string>
+  /**
+   * Send any message types. `messages_json` = JSON array string.
+   * e.g. '[{"type":"text","text":"Hi"},{"type":"image",...}]'
+   */
+  pushMessages(to: string, messagesJson: string): Promise<string>
+  /** Reply with any message types. `messages_json` = JSON array string. */
+  replyMessages(replyToken: string, messagesJson: string): Promise<string>
+  /** Multicast to multiple users. `user_ids_json` = JSON string array. */
+  multicast(userIdsJson: string, messagesJson: string): Promise<string>
+  /** Broadcast to all followers. `messages_json` = JSON array string. */
+  broadcast(messagesJson: string): Promise<string>
+  getMessageQuota(): Promise<MessageQuota>
+  getMessageQuotaConsumption(): Promise<MessageQuotaConsumption>
+  getMessageContent(messageId: string): Promise<Buffer>
+  getProfile(userId: string): Promise<Profile>
+  /** Returns follower user IDs. Pass `next` cursor for pagination (empty string for first page). */
+  getFollowerIds(next?: string | undefined | null): Promise<FollowerIds>
+  createRichMenu(richMenu: RichMenu): Promise<string>
+  getRichMenu(richMenuId: string): Promise<RichMenuResponse>
+  deleteRichMenu(richMenuId: string): Promise<string>
+  getRichMenuList(): Promise<RichMenuList>
+  /** Upload rich menu image. `content_type` is e.g. "image/jpeg" or "image/png". */
+  uploadRichMenuImage(richMenuId: string, imageData: Buffer, contentType: string): Promise<string>
+  /** Download rich menu image. Returns raw bytes as Buffer. */
+  downloadRichMenuImage(richMenuId: string): Promise<Buffer>
+  setDefaultRichMenu(richMenuId: string): Promise<string>
+  cancelDefaultRichMenu(): Promise<string>
+  getUserRichMenu(userId: string): Promise<RichMenuIdResponse>
+  linkRichMenuToUser(userId: string, richMenuId: string): Promise<string>
+  unlinkRichMenuFromUser(userId: string): Promise<string>
+  /** Bulk link rich menu to multiple users. `user_ids_json` = JSON array string. */
+  bulkLinkRichMenu(richMenuId: string, userIdsJson: string): Promise<string>
+  /** Bulk unlink rich menu from multiple users. `user_ids_json` = JSON array string. */
+  bulkUnlinkRichMenu(userIdsJson: string): Promise<string>
+}
+
+export interface AudioMessage {
+  messageType: string
+  originalContentUrl: string
+  duration: number
+  quickReply?: QuickReply
+}
+
+export interface BeaconContent {
+  hwid: string
+  beaconType: string
+  dm?: string
+}
+
+export interface BotInfo {
+  userId: string
+  basicId: string
+  displayName: string
+  pictureUrl: string
+  chatMode: string
+  markAsReadMode: string
+}
+
+export interface ContentProvider {
+  providerType: string
+  originalContentUrl?: string
+  previewImageUrl?: string
+}
+
+export interface DeliveryContext {
+  isRedelivery: boolean
+}
+
+export interface EventMessage {
+  id: string
+  messageType: string
+  text?: string
+  contentProvider?: ContentProvider
+  duration?: number
+  fileName?: string
+  fileSize?: number
+  title?: string
+  address?: string
+  latitude?: number
+  longitude?: number
+  packageId?: string
+  stickerId?: string
+  stickerResourceType?: string
+}
+
+export interface EventSource {
+  sourceType: string
+  userId?: string
+  groupId?: string
+  roomId?: string
+}
+
+export interface FollowerIds {
+  userIds: Array<string>
+  next?: string
+}
+
+export interface FollowersInsight {
+  status: string
+  followers?: number
+  targetedReaches?: number
+  blocks?: number
+}
+
+export interface GroupMemberProfile {
+  displayName: string
+  userId: string
+  pictureUrl?: string
+}
+
+export interface GroupSummary {
+  groupId: string
+  groupName: string
+  pictureUrl?: string
+}
+
+export interface ImageMessage {
+  messageType: string
+  originalContentUrl: string
+  previewImageUrl: string
+  quickReply?: QuickReply
+}
+
+export interface LinkContent {
+  result: string
+  nonce: string
+}
+
+export interface LocationMessage {
+  messageType: string
+  title: string
+  address: string
+  latitude: number
+  longitude: number
+  quickReply?: QuickReply
+}
+
+export interface MemberIds {
+  memberIds: Array<string>
+  next?: string
+}
+
+export interface MessageDeliveryOverview {
+  status: string
+  broadcast?: number
+  targeting?: number
+}
+
+export interface MessageQuota {
+  quotaType: string
+  value?: number
+}
+
+export interface MessageQuotaConsumption {
+  totalUsage: number
+}
+
+/**
+ * Parse a webhook body JSON string into typed events.
+ * Throws if the JSON is invalid.
+ */
+export declare function parseWebhookBody(body: string): WebhookBody
+
+export interface PostbackContent {
+  data: string
+  params?: PostbackParams
+}
+
+export interface PostbackParams {
+  date?: string
+  time?: string
+  datetime?: string
+}
+
+export interface Profile {
+  displayName: string
+  userId: string
+  pictureUrl?: string
+  statusMessage?: string
+}
+
+export interface PushMessageRequest {
+  to: string
+  messages: Array<TextMessage>
+}
+
+export interface QuickReply {
+  items: Array<QuickReplyItem>
+}
+
+export interface QuickReplyAction {
+  actionType: string
+  label: string
+  text?: string
+  data?: string
+  uri?: string
+}
+
+export interface QuickReplyItem {
+  itemType: string
+  action: QuickReplyAction
+  imageUrl?: string
+}
+
+export interface ReplyMessageRequest {
+  replyToken: string
+  messages: Array<TextMessage>
+}
+
+export interface RichMenu {
+  size: RichMenuSize
+  selected: boolean
+  name: string
+  chatBarText: string
+  areas: Array<RichMenuArea>
+}
+
+export interface RichMenuAction {
+  actionType: string
+  label?: string
+  text?: string
+  uri?: string
+  data?: string
+}
+
+export interface RichMenuArea {
+  bounds: RichMenuBounds
+  action: RichMenuAction
+}
+
+export interface RichMenuBounds {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
+export interface RichMenuIdResponse {
+  richMenuId: string
+}
+
+export interface RichMenuList {
+  richmenus: Array<RichMenuResponse>
+}
+
+export interface RichMenuResponse {
+  richMenuId: string
+  size: RichMenuSize
+  selected: boolean
+  name: string
+  chatBarText: string
+  areas: Array<RichMenuArea>
+}
+
+export interface RichMenuSize {
+  width: number
+  height: number
+}
+
+export interface Sender {
+  name?: string
+  iconUrl?: string
+}
+
+export interface StickerMessage {
+  messageType: string
+  packageId: string
+  stickerId: string
+  quickReply?: QuickReply
+}
+
+export interface TextMessage {
+  messageType: string
+  text: string
+  quickReply?: QuickReply
+  sender?: Sender
+}
+
+/**
+ * Verify the X-Line-Signature header against the raw request body.
+ * Returns true if the signature is valid.
+ */
+export declare function verifyWebhookSignature(body: string, signature: string, channelSecret: string): boolean
+
+export interface VideoMessage {
+  messageType: string
+  originalContentUrl: string
+  previewImageUrl: string
+  trackingId?: string
+  quickReply?: QuickReply
+}
+
+export interface WebhookBody {
+  destination: string
+  events: Array<WebhookEvent>
+}
+
+export interface WebhookEvent {
+  eventType: string
+  timestamp: number
+  source: EventSource
+  webhookEventId?: string
+  deliveryContext?: DeliveryContext
+  replyToken?: string
+  message?: EventMessage
+  postback?: PostbackContent
+  beacon?: BeaconContent
+  link?: LinkContent
+}

package/index.js

@@ -0,0 +1,591 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./line-bot-sdk-rs.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-android-arm64')
+        const bindingPackageVersion = require('line-bot-sdk-rs-android-arm64/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./line-bot-sdk-rs.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-android-arm-eabi')
+        const bindingPackageVersion = require('line-bot-sdk-rs-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./line-bot-sdk-rs.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-win32-x64-gnu')
+        const bindingPackageVersion = require('line-bot-sdk-rs-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./line-bot-sdk-rs.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-win32-x64-msvc')
+        const bindingPackageVersion = require('line-bot-sdk-rs-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./line-bot-sdk-rs.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-win32-ia32-msvc')
+        const bindingPackageVersion = require('line-bot-sdk-rs-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./line-bot-sdk-rs.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-win32-arm64-msvc')
+        const bindingPackageVersion = require('line-bot-sdk-rs-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./line-bot-sdk-rs.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('line-bot-sdk-rs-darwin-universal')
+      const bindingPackageVersion = require('line-bot-sdk-rs-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./line-bot-sdk-rs.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-darwin-x64')
+        const bindingPackageVersion = require('line-bot-sdk-rs-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./line-bot-sdk-rs.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-darwin-arm64')
+        const bindingPackageVersion = require('line-bot-sdk-rs-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./line-bot-sdk-rs.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-freebsd-x64')
+        const bindingPackageVersion = require('line-bot-sdk-rs-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./line-bot-sdk-rs.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-freebsd-arm64')
+        const bindingPackageVersion = require('line-bot-sdk-rs-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./line-bot-sdk-rs.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-x64-musl')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./line-bot-sdk-rs.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-x64-gnu')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./line-bot-sdk-rs.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-arm64-musl')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./line-bot-sdk-rs.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-arm64-gnu')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./line-bot-sdk-rs.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-arm-musleabihf')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./line-bot-sdk-rs.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./line-bot-sdk-rs.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-loong64-musl')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./line-bot-sdk-rs.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-loong64-gnu')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./line-bot-sdk-rs.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-riscv64-musl')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./line-bot-sdk-rs.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('line-bot-sdk-rs-linux-riscv64-gnu')
+          const bindingPackageVersion = require('line-bot-sdk-rs-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./line-bot-sdk-rs.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-linux-ppc64-gnu')
+        const bindingPackageVersion = require('line-bot-sdk-rs-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./line-bot-sdk-rs.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-linux-s390x-gnu')
+        const bindingPackageVersion = require('line-bot-sdk-rs-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./line-bot-sdk-rs.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-openharmony-arm64')
+        const bindingPackageVersion = require('line-bot-sdk-rs-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./line-bot-sdk-rs.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-openharmony-x64')
+        const bindingPackageVersion = require('line-bot-sdk-rs-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./line-bot-sdk-rs.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('line-bot-sdk-rs-openharmony-arm')
+        const bindingPackageVersion = require('line-bot-sdk-rs-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '1.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → force WASI fallback even if native loaded
+//   'error'                  → force WASI and throw if no WASI binding is found
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error'
+
+if (!nativeBinding || forceWasi) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./line-bot-sdk-rs.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (forceWasi) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || forceWasi) {
+    try {
+      wasiBinding = require('line-bot-sdk-rs-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (forceWasi) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.LineClient = nativeBinding.LineClient
+module.exports.parseWebhookBody = nativeBinding.parseWebhookBody
+module.exports.verifyWebhookSignature = nativeBinding.verifyWebhookSignature

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "line-bot-sdk-rs",
+  "version": "1.0.0",
+  "description": "High-performance LINE Messaging API SDK built with Rust and NAPI-RS",
+  "main": "index.js",
+  "license": "MIT",
+  "keywords": [
+    "line",
+    "line-bot",
+    "line-messaging-api",
+    "line-sdk",
+    "napi-rs",
+    "rust"
+  ],
+  "files": [
+    "index.d.ts",
+    "index.js"
+  ],
+  "napi": {
+    "binaryName": "line-bot-sdk-rs",
+    "targets": [
+      "x86_64-pc-windows-msvc",
+      "x86_64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-apple-darwin"
+    ]
+  },
+  "engines": {
+    "node": ">= 18.17.0 < 19 || >= 20.3.0 < 21 || >= 21.1.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "bench": "node --import @oxc-node/core/register benchmark/bench.ts",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "format": "run-p format:prettier format:rs format:toml",
+    "format:prettier": "prettier . -w",
+    "format:toml": "taplo format",
+    "format:rs": "cargo fmt",
+    "lint": "oxlint .",
+    "prepublishOnly": "napi prepublish -t npm",
+    "test": "ava",
+    "preversion": "napi build --platform && git add .",
+    "version": "napi version",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@emnapi/core": "^1.5.0",
+    "@emnapi/runtime": "^1.5.0",
+    "@napi-rs/cli": "^3.2.0",
+    "@oxc-node/core": "^0.1.0",
+    "@taplo/cli": "^0.7.0",
+    "@tybys/wasm-util": "^0.10.0",
+    "@types/node": "^25.9.3",
+    "ava": "^8.0.0",
+    "chalk": "^5.6.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.0",
+    "npm-run-all2": "^8.0.4",
+    "oxlint": "^1.14.0",
+    "prettier": "^3.6.2",
+    "tinybench": "^6.0.0",
+    "typescript": "^6.0.0"
+  },
+  "lint-staged": {
+    "*.@(js|ts|tsx)": [
+      "oxlint --fix"
+    ],
+    "*.@(js|ts|tsx|yml|yaml|md|json)": [
+      "prettier --write"
+    ],
+    "*.toml": [
+      "taplo format"
+    ]
+  },
+  "ava": {
+    "extensions": [
+      "ts"
+    ],
+    "timeout": "2m",
+    "workerThreads": false,
+    "environmentVariables": {
+      "OXC_TSCONFIG_PATH": "./__test__/tsconfig.json"
+    },
+    "nodeArguments": [
+      "--import",
+      "@oxc-node/core/register"
+    ]
+  },
+  "prettier": {
+    "printWidth": 120,
+    "semi": false,
+    "trailingComma": "all",
+    "singleQuote": true,
+    "arrowParens": "always"
+  },
+  "packageManager": "yarn@4.14.1",
+  "optionalDependencies": {
+    "line-bot-sdk-rs-win32-x64-msvc": "1.0.0",
+    "line-bot-sdk-rs-darwin-x64": "1.0.0",
+    "line-bot-sdk-rs-linux-x64-gnu": "1.0.0",
+    "line-bot-sdk-rs-darwin-arm64": "1.0.0"
+  }
+}