qrcode-transmitter 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-03-03
+
+### Added
+
+- Added `encodeBytesToQRCodes` to split `Uint8Array` payloads into protocol frames and generate QR SVG output
+- Added `startVideoQRReceiver` to scan QR frames from camera input and reconstruct complete data automatically
+- Added chunk protocol and aggregation logic (frame parsing, deduplication, and out-of-order reassembly)
+- Added example app and tests covering protocol and main flow

package/README.md

@@ -0,0 +1,107 @@
+# qrcode-transmitter
+
+[![npm downloads](https://img.shields.io/npm/dm/qrcode-transmitter?logo=npm)](https://www.npmjs.com/package/qrcode-transmitter)
+
+A lightweight browser-oriented library for splitting arbitrary binary data into multiple QR frames and reassembling it on scan.
+
+## Features
+
+- Splits `Uint8Array` payloads into protocol frames and encodes each frame as QR SVG
+- Scans QR codes from camera input and reassembles payloads automatically
+- Handles duplicate frames and out-of-order frame delivery (`msgId + frameIndex` aggregation)
+- Includes a runnable example app for local testing and demos
+
+## Installation
+
+```bash
+pnpm add qrcode-transmitter
+```
+
+You can also install it with `npm` or `yarn`.
+
+## Quick Start
+
+```ts
+import { encodeBytesToQRCodes, startVideoQRReceiver } from "qrcode-transmitter";
+
+// 1) Sender: encode data into multiple QR frames
+const bytes = new TextEncoder().encode("Hello QR");
+const frames = encodeBytesToQRCodes(bytes);
+// frames[i].svg can be injected into the DOM directly
+
+// 2) Receiver: scan with a video element and reassemble
+const video = document.querySelector("video") as HTMLVideoElement;
+const receiver = startVideoQRReceiver(video, {
+  onFrame: (progress) => {
+    console.log(progress.frameIndex + 1, "/", progress.totalFrames);
+  },
+  onComplete: (data) => {
+    console.log(new TextDecoder().decode(data));
+  },
+});
+
+// Stop scanning when needed
+receiver.stop();
+```
+
+## API
+
+### `encodeBytesToQRCodes(bytes: Uint8Array): EncodedFrame[]`
+
+Encodes a raw byte array and returns QR frame objects:
+
+- `frameIndex`: frame index (starting from 0)
+- `totalFrames`: total number of frames
+- `svg`: QR code SVG string for this frame
+- `payload`: base64 payload of this frame
+
+Encoding settings are fixed to:
+
+- QR `TypeNumber = 15`
+- error correction level `L`
+- `Byte` mode for writing payload data
+
+### `startVideoQRReceiver(video, options): { stop(): void }`
+
+Starts scanning and reassembles data by protocol:
+
+- `video`: `HTMLVideoElement`
+- `options.onFrame`: called when each new (non-duplicate) frame is parsed
+- `options.onComplete`: called when all frames are received, with the complete `Uint8Array`
+
+Returns an object with `stop()` to stop and destroy the scanner.
+
+## Protocol
+
+Frame text format:
+
+`msgId|idx/total|payloadBase64`
+
+- `msgId`: 8-character random hexadecimal string
+- `idx`: current chunk index
+- `total`: total chunk count
+- `payloadBase64`: base64 payload of the chunk
+
+## Local Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+pnpm example
+```
+
+Common scripts:
+
+- `pnpm build`: build to `dist/` with `tsup`
+- `pnpm dev`: watch build
+- `pnpm typecheck`: run TypeScript type checks
+- `pnpm test`: run Vitest
+- `pnpm example`: start the example app (Vite)
+
+## Run the Example
+
+After running `pnpm example`:
+
+- In the "Encode" section, enter text or select a file to render QR frames at 5fps
+- In the "Decode" section, allow camera permission and scan to see reconstructed output

package/dist/index.d.mts

@@ -0,0 +1,36 @@
+interface EncodedFrame {
+    frameIndex: number;
+    totalFrames: number;
+    svg: string;
+    payload: string;
+}
+/**
+ * Encode byte array to QR codes with TypeNumber=15 and L error correction
+ * @param bytes Raw byte array
+ * @returns Array of encoded results with frame indices
+ */
+declare function encodeBytesToQRCodes(bytes: Uint8Array): EncodedFrame[];
+interface FrameProgress {
+    frameIndex: number;
+    totalFrames: number;
+    msgId: string;
+    receivedCount: number;
+}
+interface VideoQRReceiverOptions {
+    /** Fired when each frame is parsed */
+    onFrame?: (progress: FrameProgress) => void;
+    /** Fired when the complete message is received */
+    onComplete?: (data: Uint8Array) => void;
+}
+interface VideoQRReceiver {
+    stop(): void;
+}
+/**
+ * Start video stream QR code parsing, automatically reassemble complete message per protocol
+ * @param video Video element for camera rendering
+ * @param options Callbacks and configuration
+ * @returns Returns { stop } to stop scanning
+ */
+declare function startVideoQRReceiver(video: HTMLVideoElement, options: VideoQRReceiverOptions): VideoQRReceiver;
+
+export { type EncodedFrame, type FrameProgress, type VideoQRReceiver, type VideoQRReceiverOptions, encodeBytesToQRCodes, startVideoQRReceiver };

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+interface EncodedFrame {
+    frameIndex: number;
+    totalFrames: number;
+    svg: string;
+    payload: string;
+}
+/**
+ * Encode byte array to QR codes with TypeNumber=15 and L error correction
+ * @param bytes Raw byte array
+ * @returns Array of encoded results with frame indices
+ */
+declare function encodeBytesToQRCodes(bytes: Uint8Array): EncodedFrame[];
+interface FrameProgress {
+    frameIndex: number;
+    totalFrames: number;
+    msgId: string;
+    receivedCount: number;
+}
+interface VideoQRReceiverOptions {
+    /** Fired when each frame is parsed */
+    onFrame?: (progress: FrameProgress) => void;
+    /** Fired when the complete message is received */
+    onComplete?: (data: Uint8Array) => void;
+}
+interface VideoQRReceiver {
+    stop(): void;
+}
+/**
+ * Start video stream QR code parsing, automatically reassemble complete message per protocol
+ * @param video Video element for camera rendering
+ * @param options Callbacks and configuration
+ * @returns Returns { stop } to stop scanning
+ */
+declare function startVideoQRReceiver(video: HTMLVideoElement, options: VideoQRReceiverOptions): VideoQRReceiver;
+
+export { type EncodedFrame, type FrameProgress, type VideoQRReceiver, type VideoQRReceiverOptions, encodeBytesToQRCodes, startVideoQRReceiver };

package/dist/index.js

@@ -0,0 +1,226 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  encodeBytesToQRCodes: () => encodeBytesToQRCodes,
+  startVideoQRReceiver: () => startVideoQRReceiver
+});
+module.exports = __toCommonJS(index_exports);
+var import_qrcode_generator = __toESM(require("qrcode-generator"));
+var import_qr_scanner = __toESM(require("qr-scanner"));
+
+// src/protocol.ts
+var TYPE15_BYTE_CAPACITY = 520;
+function randomMsgId() {
+  return Math.random().toString(16).slice(2, 10);
+}
+function estimateHeaderLength(total) {
+  const idxDigits = String(Math.max(0, total - 1)).length;
+  const totalDigits = String(total).length;
+  return 8 + 1 + idxDigits + 1 + totalDigits + 1;
+}
+function splitIntoFrames(bytes) {
+  if (bytes.length === 0) {
+    return [{ frameIndex: 0, totalFrames: 1, frame: encodeFrame(randomMsgId(), 0, 1, ""), payloadBase64: "" }];
+  }
+  const msgId = randomMsgId();
+  const headerOverhead = estimateHeaderLength(1) + 4;
+  const maxPayloadChars = TYPE15_BYTE_CAPACITY - headerOverhead;
+  const maxPayloadBytes = Math.floor(maxPayloadChars * 3 / 4);
+  if (maxPayloadBytes <= 0) {
+    throw new Error("Protocol header too large for Type 15 QR capacity");
+  }
+  const total = Math.ceil(bytes.length / maxPayloadBytes);
+  const headerLen = estimateHeaderLength(total) + 4;
+  const maxPayloadCharsActual = TYPE15_BYTE_CAPACITY - headerLen;
+  const maxPayloadBytesActual = Math.floor(maxPayloadCharsActual * 3 / 4);
+  const frames = [];
+  let offset = 0;
+  while (offset < bytes.length) {
+    const chunk = bytes.subarray(offset, Math.min(offset + maxPayloadBytesActual, bytes.length));
+    const chunkBase64 = btoa(String.fromCharCode.apply(null, Array.from(chunk)));
+    const frame = encodeFrame(msgId, frames.length, total, chunkBase64);
+    frames.push({ frameIndex: frames.length, totalFrames: total, frame, payloadBase64: chunkBase64 });
+    offset += chunk.length;
+  }
+  return frames;
+}
+function encodeFrame(msgId, idx, total, payloadBase64) {
+  return `${msgId}|${idx}/${total}|${payloadBase64}`;
+}
+function parseFrame(text) {
+  const pipe1 = text.indexOf("|");
+  if (pipe1 < 0) return null;
+  const msgId = text.slice(0, pipe1);
+  const rest2 = text.slice(pipe1 + 1);
+  const slash = rest2.indexOf("/");
+  const pipe2 = rest2.indexOf("|");
+  if (slash < 0 || pipe2 < 0 || slash > pipe2) return null;
+  const idx = parseInt(rest2.slice(0, slash), 10);
+  const total = parseInt(rest2.slice(slash + 1, pipe2), 10);
+  const payloadBase64 = rest2.slice(pipe2 + 1);
+  if (isNaN(idx) || isNaN(total) || idx < 0 || total < 1 || idx >= total) return null;
+  return { msgId, idx, total, payloadBase64 };
+}
+function base64ToBytes(base64) {
+  const binary = atob(base64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+var FrameAggregator = class {
+  constructor() {
+    this.chunks = /* @__PURE__ */ new Map();
+  }
+  add(parsed) {
+    const { msgId, idx, total, payloadBase64 } = parsed;
+    let map = this.chunks.get(msgId);
+    if (!map) {
+      map = /* @__PURE__ */ new Map();
+      this.chunks.set(msgId, map);
+    }
+    const isNew = !map.has(idx);
+    if (isNew) map.set(idx, payloadBase64);
+    const receivedCount = map.size;
+    if (receivedCount !== total) {
+      return {
+        isNew,
+        frameIndex: idx,
+        totalFrames: total,
+        msgId,
+        receivedCount,
+        complete: false
+      };
+    }
+    const parts = [];
+    for (let i = 0; i < total; i++) {
+      const b64 = map.get(i);
+      if (!b64) {
+        return { isNew, frameIndex: idx, totalFrames: total, msgId, receivedCount, complete: false };
+      }
+      parts.push(base64ToBytes(b64));
+    }
+    this.chunks.delete(msgId);
+    const totalLen = parts.reduce((s, p) => s + p.length, 0);
+    const data = new Uint8Array(totalLen);
+    let off = 0;
+    for (const p of parts) {
+      data.set(p, off);
+      off += p.length;
+    }
+    return {
+      isNew,
+      frameIndex: idx,
+      totalFrames: total,
+      msgId,
+      receivedCount,
+      complete: true,
+      data
+    };
+  }
+};
+
+// src/index.ts
+var TYPE_NUMBER = 15;
+var ERROR_CORRECTION = "L";
+function encodeBytesToQRCodes(bytes) {
+  const frames = splitIntoFrames(bytes);
+  const result = [];
+  for (const { frameIndex, totalFrames, frame, payloadBase64 } of frames) {
+    const qr = (0, import_qrcode_generator.default)(TYPE_NUMBER, ERROR_CORRECTION);
+    qr.addData(frame, "Byte");
+    qr.make();
+    result.push({
+      frameIndex,
+      totalFrames,
+      svg: qr.createSvgTag(),
+      payload: payloadBase64
+    });
+  }
+  return result;
+}
+function startVideoQRReceiver(video, options) {
+  const { onFrame, onComplete } = options;
+  const aggregator = new FrameAggregator();
+  const qrScanner = new import_qr_scanner.default(
+    video,
+    (result) => {
+      const text = typeof result === "string" ? result : result.data;
+      const parsed = parseFrame(text);
+      if (!parsed) return;
+      const res = aggregator.add(parsed);
+      if (res.isNew && onFrame) {
+        onFrame({
+          frameIndex: res.frameIndex,
+          totalFrames: res.totalFrames,
+          msgId: res.msgId,
+          receivedCount: res.receivedCount
+        });
+      }
+      if (res.complete && res.data && onComplete) {
+        onComplete(res.data);
+      }
+    },
+    {
+      returnDetailedScanResult: true,
+      maxScansPerSecond: 20,
+      calculateScanRegion: (v) => {
+        const w = v.videoWidth;
+        const h = v.videoHeight;
+        const target = 1e3;
+        const scale = w >= h ? target / w : target / h;
+        return {
+          x: 0,
+          y: 0,
+          width: w,
+          height: h,
+          downScaledWidth: Math.round(w * scale),
+          downScaledHeight: Math.round(h * scale)
+        };
+      }
+    }
+  );
+  qrScanner.start();
+  return {
+    stop() {
+      qrScanner.stop();
+      qrScanner.destroy();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  encodeBytesToQRCodes,
+  startVideoQRReceiver
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/protocol.ts"],"sourcesContent":["import qrcode from \"qrcode-generator\";\nimport QrScanner from \"qr-scanner\";\nimport { splitIntoFrames, parseFrame, FrameAggregator } from \"./protocol\";\n\nconst TYPE_NUMBER = 15;\nconst ERROR_CORRECTION = \"L\";\n\nexport interface EncodedFrame {\n  frameIndex: number;\n  totalFrames: number;\n  svg: string;\n  payload: string;\n}\n\n/**\n * Encode byte array to QR codes with TypeNumber=15 and L error correction\n * @param bytes Raw byte array\n * @returns Array of encoded results with frame indices\n */\nexport function encodeBytesToQRCodes(bytes: Uint8Array): EncodedFrame[] {\n  const frames = splitIntoFrames(bytes);\n  const result: EncodedFrame[] = [];\n\n  for (const { frameIndex, totalFrames, frame, payloadBase64 } of frames) {\n    const qr = qrcode(TYPE_NUMBER, ERROR_CORRECTION);\n    qr.addData(frame, \"Byte\");\n    qr.make();\n    result.push({\n      frameIndex,\n      totalFrames,\n      svg: qr.createSvgTag(),\n      payload: payloadBase64,\n    });\n  }\n\n  return result;\n}\n\nexport interface FrameProgress {\n  frameIndex: number;\n  totalFrames: number;\n  msgId: string;\n  receivedCount: number;\n}\n\nexport interface VideoQRReceiverOptions {\n  /** Fired when each frame is parsed */\n  onFrame?: (progress: FrameProgress) => void;\n  /** Fired when the complete message is received */\n  onComplete?: (data: Uint8Array) => void;\n}\n\nexport interface VideoQRReceiver {\n  stop(): void;\n}\n\n/**\n * Start video stream QR code parsing, automatically reassemble complete message per protocol\n * @param video Video element for camera rendering\n * @param options Callbacks and configuration\n * @returns Returns { stop } to stop scanning\n */\nexport function startVideoQRReceiver(\n  video: HTMLVideoElement,\n  options: VideoQRReceiverOptions\n): VideoQRReceiver {\n  const { onFrame, onComplete } = options;\n  const aggregator = new FrameAggregator();\n\n  const qrScanner = new QrScanner(\n    video,\n    (result) => {\n      const text = typeof result === \"string\" ? result : result.data;\n      const parsed = parseFrame(text);\n      if (!parsed) return;\n      const res = aggregator.add(parsed);\n      if (res.isNew && onFrame) {\n        onFrame({\n          frameIndex: res.frameIndex,\n          totalFrames: res.totalFrames,\n          msgId: res.msgId,\n          receivedCount: res.receivedCount,\n        });\n      }\n      if (res.complete && res.data && onComplete) {\n        onComplete(res.data);\n      }\n    },\n    {\n      returnDetailedScanResult: true,\n      maxScansPerSecond: 20,\n      calculateScanRegion: (v: HTMLVideoElement) => {\n        const w = v.videoWidth;\n        const h = v.videoHeight;\n        const target = 1000;\n        const scale = w >= h ? target / w : target / h;\n        return {\n          x: 0,\n          y: 0,\n          width: w,\n          height: h,\n          downScaledWidth: Math.round(w * scale),\n          downScaledHeight: Math.round(h * scale),\n        };\n      },\n    }\n  );\n\n  qrScanner.start();\n\n  return {\n    stop() {\n      qrScanner.stop();\n      qrScanner.destroy();\n    },\n  };\n}\n","/**\n * Chunking protocol\n * Frame format: msgId|idx/total|payloadBase64\n */\n\nconst TYPE15_BYTE_CAPACITY = 520; // TypeNumber 15, L error correction\n\nfunction randomMsgId(): string {\n  return Math.random().toString(16).slice(2, 10);\n}\n\nfunction estimateHeaderLength(total: number): number {\n  const idxDigits = String(Math.max(0, total - 1)).length;\n  const totalDigits = String(total).length;\n  return 8 + 1 + idxDigits + 1 + totalDigits + 1;\n}\n\nexport interface FrameInfo {\n  frameIndex: number;\n  totalFrames: number;\n  frame: string;\n  payloadBase64: string;\n}\n\n/**\n * Split byte array into chunks, each encoded as a protocol frame\n */\nexport function splitIntoFrames(bytes: Uint8Array): FrameInfo[] {\n  if (bytes.length === 0) {\n    return [{ frameIndex: 0, totalFrames: 1, frame: encodeFrame(randomMsgId(), 0, 1, \"\"), payloadBase64: \"\" }];\n  }\n\n  const msgId = randomMsgId();\n  const headerOverhead = estimateHeaderLength(1) + 4;\n  const maxPayloadChars = TYPE15_BYTE_CAPACITY - headerOverhead;\n  const maxPayloadBytes = Math.floor((maxPayloadChars * 3) / 4);\n\n  if (maxPayloadBytes <= 0) {\n    throw new Error(\"Protocol header too large for Type 15 QR capacity\");\n  }\n\n  const total = Math.ceil(bytes.length / maxPayloadBytes);\n  const headerLen = estimateHeaderLength(total) + 4;\n  const maxPayloadCharsActual = TYPE15_BYTE_CAPACITY - headerLen;\n  const maxPayloadBytesActual = Math.floor((maxPayloadCharsActual * 3) / 4);\n\n  const frames: FrameInfo[] = [];\n  let offset = 0;\n\n  while (offset < bytes.length) {\n    const chunk = bytes.subarray(offset, Math.min(offset + maxPayloadBytesActual, bytes.length));\n    const chunkBase64 = btoa(String.fromCharCode.apply(null, Array.from(chunk)));\n    const frame = encodeFrame(msgId, frames.length, total, chunkBase64);\n    frames.push({ frameIndex: frames.length, totalFrames: total, frame, payloadBase64: chunkBase64 });\n    offset += chunk.length;\n  }\n\n  return frames;\n}\n\nfunction encodeFrame(msgId: string, idx: number, total: number, payloadBase64: string): string {\n  return `${msgId}|${idx}/${total}|${payloadBase64}`;\n}\n\nexport interface ParsedFrame {\n  msgId: string;\n  idx: number;\n  total: number;\n  payloadBase64: string;\n}\n\n/**\n * Parse protocol frame, returns null for invalid format\n */\nexport function parseFrame(text: string): ParsedFrame | null {\n  const pipe1 = text.indexOf(\"|\");\n  if (pipe1 < 0) return null;\n  const msgId = text.slice(0, pipe1);\n  const rest2 = text.slice(pipe1 + 1);\n  const slash = rest2.indexOf(\"/\");\n  const pipe2 = rest2.indexOf(\"|\");\n  if (slash < 0 || pipe2 < 0 || slash > pipe2) return null;\n  const idx = parseInt(rest2.slice(0, slash), 10);\n  const total = parseInt(rest2.slice(slash + 1, pipe2), 10);\n  const payloadBase64 = rest2.slice(pipe2 + 1);\n  if (isNaN(idx) || isNaN(total) || idx < 0 || total < 1 || idx >= total) return null;\n  return { msgId, idx, total, payloadBase64 };\n}\n\n/**\n * Decode base64 to Uint8Array\n */\nexport function base64ToBytes(base64: string): Uint8Array {\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n}\n\nexport interface AddFrameResult {\n  isNew: boolean;\n  frameIndex: number;\n  totalFrames: number;\n  msgId: string;\n  receivedCount: number;\n  complete: boolean;\n  data?: Uint8Array;\n}\n\n/**\n * Message aggregation state: collect frames by msgId, reassemble when complete\n */\nexport class FrameAggregator {\n  private chunks = new Map<string, Map<number, string>>();\n\n  add(parsed: ParsedFrame): AddFrameResult {\n    const { msgId, idx, total, payloadBase64 } = parsed;\n    let map = this.chunks.get(msgId);\n    if (!map) {\n      map = new Map();\n      this.chunks.set(msgId, map);\n    }\n    const isNew = !map.has(idx);\n    if (isNew) map.set(idx, payloadBase64);\n    const receivedCount = map.size;\n\n    if (receivedCount !== total) {\n      return {\n        isNew,\n        frameIndex: idx,\n        totalFrames: total,\n        msgId,\n        receivedCount,\n        complete: false,\n      };\n    }\n\n    const parts: Uint8Array[] = [];\n    for (let i = 0; i < total; i++) {\n      const b64 = map.get(i);\n      if (!b64) {\n        return { isNew, frameIndex: idx, totalFrames: total, msgId, receivedCount, complete: false };\n      }\n      parts.push(base64ToBytes(b64));\n    }\n    this.chunks.delete(msgId);\n    const totalLen = parts.reduce((s, p) => s + p.length, 0);\n    const data = new Uint8Array(totalLen);\n    let off = 0;\n    for (const p of parts) {\n      data.set(p, off);\n      off += p.length;\n    }\n    return {\n      isNew,\n      frameIndex: idx,\n      totalFrames: total,\n      msgId,\n      receivedCount,\n      complete: true,\n      data,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8BAAmB;AACnB,wBAAsB;;;ACItB,IAAM,uBAAuB;AAE7B,SAAS,cAAsB;AAC7B,SAAO,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE;AAC/C;AAEA,SAAS,qBAAqB,OAAuB;AACnD,QAAM,YAAY,OAAO,KAAK,IAAI,GAAG,QAAQ,CAAC,CAAC,EAAE;AACjD,QAAM,cAAc,OAAO,KAAK,EAAE;AAClC,SAAO,IAAI,IAAI,YAAY,IAAI,cAAc;AAC/C;AAYO,SAAS,gBAAgB,OAAgC;AAC9D,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,OAAO,YAAY,YAAY,GAAG,GAAG,GAAG,EAAE,GAAG,eAAe,GAAG,CAAC;AAAA,EAC3G;AAEA,QAAM,QAAQ,YAAY;AAC1B,QAAM,iBAAiB,qBAAqB,CAAC,IAAI;AACjD,QAAM,kBAAkB,uBAAuB;AAC/C,QAAM,kBAAkB,KAAK,MAAO,kBAAkB,IAAK,CAAC;AAE5D,MAAI,mBAAmB,GAAG;AACxB,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AAEA,QAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,eAAe;AACtD,QAAM,YAAY,qBAAqB,KAAK,IAAI;AAChD,QAAM,wBAAwB,uBAAuB;AACrD,QAAM,wBAAwB,KAAK,MAAO,wBAAwB,IAAK,CAAC;AAExE,QAAM,SAAsB,CAAC;AAC7B,MAAI,SAAS;AAEb,SAAO,SAAS,MAAM,QAAQ;AAC5B,UAAM,QAAQ,MAAM,SAAS,QAAQ,KAAK,IAAI,SAAS,uBAAuB,MAAM,MAAM,CAAC;AAC3F,UAAM,cAAc,KAAK,OAAO,aAAa,MAAM,MAAM,MAAM,KAAK,KAAK,CAAC,CAAC;AAC3E,UAAM,QAAQ,YAAY,OAAO,OAAO,QAAQ,OAAO,WAAW;AAClE,WAAO,KAAK,EAAE,YAAY,OAAO,QAAQ,aAAa,OAAO,OAAO,eAAe,YAAY,CAAC;AAChG,cAAU,MAAM;AAAA,EAClB;AAEA,SAAO;AACT;AAEA,SAAS,YAAY,OAAe,KAAa,OAAe,eAA+B;AAC7F,SAAO,GAAG,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,aAAa;AAClD;AAYO,SAAS,WAAW,MAAkC;AAC3D,QAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,MAAI,QAAQ,EAAG,QAAO;AACtB,QAAM,QAAQ,KAAK,MAAM,GAAG,KAAK;AACjC,QAAM,QAAQ,KAAK,MAAM,QAAQ,CAAC;AAClC,QAAM,QAAQ,MAAM,QAAQ,GAAG;AAC/B,QAAM,QAAQ,MAAM,QAAQ,GAAG;AAC/B,MAAI,QAAQ,KAAK,QAAQ,KAAK,QAAQ,MAAO,QAAO;AACpD,QAAM,MAAM,SAAS,MAAM,MAAM,GAAG,KAAK,GAAG,EAAE;AAC9C,QAAM,QAAQ,SAAS,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,EAAE;AACxD,QAAM,gBAAgB,MAAM,MAAM,QAAQ,CAAC;AAC3C,MAAI,MAAM,GAAG,KAAK,MAAM,KAAK,KAAK,MAAM,KAAK,QAAQ,KAAK,OAAO,MAAO,QAAO;AAC/E,SAAO,EAAE,OAAO,KAAK,OAAO,cAAc;AAC5C;AAKO,SAAS,cAAc,QAA4B;AACxD,QAAM,SAAS,KAAK,MAAM;AAC1B,QAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;AAC1C,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,UAAM,CAAC,IAAI,OAAO,WAAW,CAAC;AAAA,EAChC;AACA,SAAO;AACT;AAeO,IAAM,kBAAN,MAAsB;AAAA,EAAtB;AACL,SAAQ,SAAS,oBAAI,IAAiC;AAAA;AAAA,EAEtD,IAAI,QAAqC;AACvC,UAAM,EAAE,OAAO,KAAK,OAAO,cAAc,IAAI;AAC7C,QAAI,MAAM,KAAK,OAAO,IAAI,KAAK;AAC/B,QAAI,CAAC,KAAK;AACR,YAAM,oBAAI,IAAI;AACd,WAAK,OAAO,IAAI,OAAO,GAAG;AAAA,IAC5B;AACA,UAAM,QAAQ,CAAC,IAAI,IAAI,GAAG;AAC1B,QAAI,MAAO,KAAI,IAAI,KAAK,aAAa;AACrC,UAAM,gBAAgB,IAAI;AAE1B,QAAI,kBAAkB,OAAO;AAC3B,aAAO;AAAA,QACL;AAAA,QACA,YAAY;AAAA,QACZ,aAAa;AAAA,QACb;AAAA,QACA;AAAA,QACA,UAAU;AAAA,MACZ;AAAA,IACF;AAEA,UAAM,QAAsB,CAAC;AAC7B,aAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AAC9B,YAAM,MAAM,IAAI,IAAI,CAAC;AACrB,UAAI,CAAC,KAAK;AACR,eAAO,EAAE,OAAO,YAAY,KAAK,aAAa,OAAO,OAAO,eAAe,UAAU,MAAM;AAAA,MAC7F;AACA,YAAM,KAAK,cAAc,GAAG,CAAC;AAAA,IAC/B;AACA,SAAK,OAAO,OAAO,KAAK;AACxB,UAAM,WAAW,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,QAAQ,CAAC;AACvD,UAAM,OAAO,IAAI,WAAW,QAAQ;AACpC,QAAI,MAAM;AACV,eAAW,KAAK,OAAO;AACrB,WAAK,IAAI,GAAG,GAAG;AACf,aAAO,EAAE;AAAA,IACX;AACA,WAAO;AAAA,MACL;AAAA,MACA,YAAY;AAAA,MACZ,aAAa;AAAA,MACb;AAAA,MACA;AAAA,MACA,UAAU;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACF;;;ADjKA,IAAM,cAAc;AACpB,IAAM,mBAAmB;AAclB,SAAS,qBAAqB,OAAmC;AACtE,QAAM,SAAS,gBAAgB,KAAK;AACpC,QAAM,SAAyB,CAAC;AAEhC,aAAW,EAAE,YAAY,aAAa,OAAO,cAAc,KAAK,QAAQ;AACtE,UAAM,SAAK,wBAAAA,SAAO,aAAa,gBAAgB;AAC/C,OAAG,QAAQ,OAAO,MAAM;AACxB,OAAG,KAAK;AACR,WAAO,KAAK;AAAA,MACV;AAAA,MACA;AAAA,MACA,KAAK,GAAG,aAAa;AAAA,MACrB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AA0BO,SAAS,qBACd,OACA,SACiB;AACjB,QAAM,EAAE,SAAS,WAAW,IAAI;AAChC,QAAM,aAAa,IAAI,gBAAgB;AAEvC,QAAM,YAAY,IAAI,kBAAAC;AAAA,IACpB;AAAA,IACA,CAAC,WAAW;AACV,YAAM,OAAO,OAAO,WAAW,WAAW,SAAS,OAAO;AAC1D,YAAM,SAAS,WAAW,IAAI;AAC9B,UAAI,CAAC,OAAQ;AACb,YAAM,MAAM,WAAW,IAAI,MAAM;AACjC,UAAI,IAAI,SAAS,SAAS;AACxB,gBAAQ;AAAA,UACN,YAAY,IAAI;AAAA,UAChB,aAAa,IAAI;AAAA,UACjB,OAAO,IAAI;AAAA,UACX,eAAe,IAAI;AAAA,QACrB,CAAC;AAAA,MACH;AACA,UAAI,IAAI,YAAY,IAAI,QAAQ,YAAY;AAC1C,mBAAW,IAAI,IAAI;AAAA,MACrB;AAAA,IACF;AAAA,IACA;AAAA,MACE,0BAA0B;AAAA,MAC1B,mBAAmB;AAAA,MACnB,qBAAqB,CAAC,MAAwB;AAC5C,cAAM,IAAI,EAAE;AACZ,cAAM,IAAI,EAAE;AACZ,cAAM,SAAS;AACf,cAAM,QAAQ,KAAK,IAAI,SAAS,IAAI,SAAS;AAC7C,eAAO;AAAA,UACL,GAAG;AAAA,UACH,GAAG;AAAA,UACH,OAAO;AAAA,UACP,QAAQ;AAAA,UACR,iBAAiB,KAAK,MAAM,IAAI,KAAK;AAAA,UACrC,kBAAkB,KAAK,MAAM,IAAI,KAAK;AAAA,QACxC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,YAAU,MAAM;AAEhB,SAAO;AAAA,IACL,OAAO;AACL,gBAAU,KAAK;AACf,gBAAU,QAAQ;AAAA,IACpB;AAAA,EACF;AACF;","names":["qrcode","QrScanner"]}

package/dist/index.mjs

@@ -0,0 +1,190 @@
+// src/index.ts
+import qrcode from "qrcode-generator";
+import QrScanner from "qr-scanner";
+
+// src/protocol.ts
+var TYPE15_BYTE_CAPACITY = 520;
+function randomMsgId() {
+  return Math.random().toString(16).slice(2, 10);
+}
+function estimateHeaderLength(total) {
+  const idxDigits = String(Math.max(0, total - 1)).length;
+  const totalDigits = String(total).length;
+  return 8 + 1 + idxDigits + 1 + totalDigits + 1;
+}
+function splitIntoFrames(bytes) {
+  if (bytes.length === 0) {
+    return [{ frameIndex: 0, totalFrames: 1, frame: encodeFrame(randomMsgId(), 0, 1, ""), payloadBase64: "" }];
+  }
+  const msgId = randomMsgId();
+  const headerOverhead = estimateHeaderLength(1) + 4;
+  const maxPayloadChars = TYPE15_BYTE_CAPACITY - headerOverhead;
+  const maxPayloadBytes = Math.floor(maxPayloadChars * 3 / 4);
+  if (maxPayloadBytes <= 0) {
+    throw new Error("Protocol header too large for Type 15 QR capacity");
+  }
+  const total = Math.ceil(bytes.length / maxPayloadBytes);
+  const headerLen = estimateHeaderLength(total) + 4;
+  const maxPayloadCharsActual = TYPE15_BYTE_CAPACITY - headerLen;
+  const maxPayloadBytesActual = Math.floor(maxPayloadCharsActual * 3 / 4);
+  const frames = [];
+  let offset = 0;
+  while (offset < bytes.length) {
+    const chunk = bytes.subarray(offset, Math.min(offset + maxPayloadBytesActual, bytes.length));
+    const chunkBase64 = btoa(String.fromCharCode.apply(null, Array.from(chunk)));
+    const frame = encodeFrame(msgId, frames.length, total, chunkBase64);
+    frames.push({ frameIndex: frames.length, totalFrames: total, frame, payloadBase64: chunkBase64 });
+    offset += chunk.length;
+  }
+  return frames;
+}
+function encodeFrame(msgId, idx, total, payloadBase64) {
+  return `${msgId}|${idx}/${total}|${payloadBase64}`;
+}
+function parseFrame(text) {
+  const pipe1 = text.indexOf("|");
+  if (pipe1 < 0) return null;
+  const msgId = text.slice(0, pipe1);
+  const rest2 = text.slice(pipe1 + 1);
+  const slash = rest2.indexOf("/");
+  const pipe2 = rest2.indexOf("|");
+  if (slash < 0 || pipe2 < 0 || slash > pipe2) return null;
+  const idx = parseInt(rest2.slice(0, slash), 10);
+  const total = parseInt(rest2.slice(slash + 1, pipe2), 10);
+  const payloadBase64 = rest2.slice(pipe2 + 1);
+  if (isNaN(idx) || isNaN(total) || idx < 0 || total < 1 || idx >= total) return null;
+  return { msgId, idx, total, payloadBase64 };
+}
+function base64ToBytes(base64) {
+  const binary = atob(base64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+var FrameAggregator = class {
+  constructor() {
+    this.chunks = /* @__PURE__ */ new Map();
+  }
+  add(parsed) {
+    const { msgId, idx, total, payloadBase64 } = parsed;
+    let map = this.chunks.get(msgId);
+    if (!map) {
+      map = /* @__PURE__ */ new Map();
+      this.chunks.set(msgId, map);
+    }
+    const isNew = !map.has(idx);
+    if (isNew) map.set(idx, payloadBase64);
+    const receivedCount = map.size;
+    if (receivedCount !== total) {
+      return {
+        isNew,
+        frameIndex: idx,
+        totalFrames: total,
+        msgId,
+        receivedCount,
+        complete: false
+      };
+    }
+    const parts = [];
+    for (let i = 0; i < total; i++) {
+      const b64 = map.get(i);
+      if (!b64) {
+        return { isNew, frameIndex: idx, totalFrames: total, msgId, receivedCount, complete: false };
+      }
+      parts.push(base64ToBytes(b64));
+    }
+    this.chunks.delete(msgId);
+    const totalLen = parts.reduce((s, p) => s + p.length, 0);
+    const data = new Uint8Array(totalLen);
+    let off = 0;
+    for (const p of parts) {
+      data.set(p, off);
+      off += p.length;
+    }
+    return {
+      isNew,
+      frameIndex: idx,
+      totalFrames: total,
+      msgId,
+      receivedCount,
+      complete: true,
+      data
+    };
+  }
+};
+
+// src/index.ts
+var TYPE_NUMBER = 15;
+var ERROR_CORRECTION = "L";
+function encodeBytesToQRCodes(bytes) {
+  const frames = splitIntoFrames(bytes);
+  const result = [];
+  for (const { frameIndex, totalFrames, frame, payloadBase64 } of frames) {
+    const qr = qrcode(TYPE_NUMBER, ERROR_CORRECTION);
+    qr.addData(frame, "Byte");
+    qr.make();
+    result.push({
+      frameIndex,
+      totalFrames,
+      svg: qr.createSvgTag(),
+      payload: payloadBase64
+    });
+  }
+  return result;
+}
+function startVideoQRReceiver(video, options) {
+  const { onFrame, onComplete } = options;
+  const aggregator = new FrameAggregator();
+  const qrScanner = new QrScanner(
+    video,
+    (result) => {
+      const text = typeof result === "string" ? result : result.data;
+      const parsed = parseFrame(text);
+      if (!parsed) return;
+      const res = aggregator.add(parsed);
+      if (res.isNew && onFrame) {
+        onFrame({
+          frameIndex: res.frameIndex,
+          totalFrames: res.totalFrames,
+          msgId: res.msgId,
+          receivedCount: res.receivedCount
+        });
+      }
+      if (res.complete && res.data && onComplete) {
+        onComplete(res.data);
+      }
+    },
+    {
+      returnDetailedScanResult: true,
+      maxScansPerSecond: 20,
+      calculateScanRegion: (v) => {
+        const w = v.videoWidth;
+        const h = v.videoHeight;
+        const target = 1e3;
+        const scale = w >= h ? target / w : target / h;
+        return {
+          x: 0,
+          y: 0,
+          width: w,
+          height: h,
+          downScaledWidth: Math.round(w * scale),
+          downScaledHeight: Math.round(h * scale)
+        };
+      }
+    }
+  );
+  qrScanner.start();
+  return {
+    stop() {
+      qrScanner.stop();
+      qrScanner.destroy();
+    }
+  };
+}
+export {
+  encodeBytesToQRCodes,
+  startVideoQRReceiver
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/protocol.ts"],"sourcesContent":["import qrcode from \"qrcode-generator\";\nimport QrScanner from \"qr-scanner\";\nimport { splitIntoFrames, parseFrame, FrameAggregator } from \"./protocol\";\n\nconst TYPE_NUMBER = 15;\nconst ERROR_CORRECTION = \"L\";\n\nexport interface EncodedFrame {\n  frameIndex: number;\n  totalFrames: number;\n  svg: string;\n  payload: string;\n}\n\n/**\n * Encode byte array to QR codes with TypeNumber=15 and L error correction\n * @param bytes Raw byte array\n * @returns Array of encoded results with frame indices\n */\nexport function encodeBytesToQRCodes(bytes: Uint8Array): EncodedFrame[] {\n  const frames = splitIntoFrames(bytes);\n  const result: EncodedFrame[] = [];\n\n  for (const { frameIndex, totalFrames, frame, payloadBase64 } of frames) {\n    const qr = qrcode(TYPE_NUMBER, ERROR_CORRECTION);\n    qr.addData(frame, \"Byte\");\n    qr.make();\n    result.push({\n      frameIndex,\n      totalFrames,\n      svg: qr.createSvgTag(),\n      payload: payloadBase64,\n    });\n  }\n\n  return result;\n}\n\nexport interface FrameProgress {\n  frameIndex: number;\n  totalFrames: number;\n  msgId: string;\n  receivedCount: number;\n}\n\nexport interface VideoQRReceiverOptions {\n  /** Fired when each frame is parsed */\n  onFrame?: (progress: FrameProgress) => void;\n  /** Fired when the complete message is received */\n  onComplete?: (data: Uint8Array) => void;\n}\n\nexport interface VideoQRReceiver {\n  stop(): void;\n}\n\n/**\n * Start video stream QR code parsing, automatically reassemble complete message per protocol\n * @param video Video element for camera rendering\n * @param options Callbacks and configuration\n * @returns Returns { stop } to stop scanning\n */\nexport function startVideoQRReceiver(\n  video: HTMLVideoElement,\n  options: VideoQRReceiverOptions\n): VideoQRReceiver {\n  const { onFrame, onComplete } = options;\n  const aggregator = new FrameAggregator();\n\n  const qrScanner = new QrScanner(\n    video,\n    (result) => {\n      const text = typeof result === \"string\" ? result : result.data;\n      const parsed = parseFrame(text);\n      if (!parsed) return;\n      const res = aggregator.add(parsed);\n      if (res.isNew && onFrame) {\n        onFrame({\n          frameIndex: res.frameIndex,\n          totalFrames: res.totalFrames,\n          msgId: res.msgId,\n          receivedCount: res.receivedCount,\n        });\n      }\n      if (res.complete && res.data && onComplete) {\n        onComplete(res.data);\n      }\n    },\n    {\n      returnDetailedScanResult: true,\n      maxScansPerSecond: 20,\n      calculateScanRegion: (v: HTMLVideoElement) => {\n        const w = v.videoWidth;\n        const h = v.videoHeight;\n        const target = 1000;\n        const scale = w >= h ? target / w : target / h;\n        return {\n          x: 0,\n          y: 0,\n          width: w,\n          height: h,\n          downScaledWidth: Math.round(w * scale),\n          downScaledHeight: Math.round(h * scale),\n        };\n      },\n    }\n  );\n\n  qrScanner.start();\n\n  return {\n    stop() {\n      qrScanner.stop();\n      qrScanner.destroy();\n    },\n  };\n}\n","/**\n * Chunking protocol\n * Frame format: msgId|idx/total|payloadBase64\n */\n\nconst TYPE15_BYTE_CAPACITY = 520; // TypeNumber 15, L error correction\n\nfunction randomMsgId(): string {\n  return Math.random().toString(16).slice(2, 10);\n}\n\nfunction estimateHeaderLength(total: number): number {\n  const idxDigits = String(Math.max(0, total - 1)).length;\n  const totalDigits = String(total).length;\n  return 8 + 1 + idxDigits + 1 + totalDigits + 1;\n}\n\nexport interface FrameInfo {\n  frameIndex: number;\n  totalFrames: number;\n  frame: string;\n  payloadBase64: string;\n}\n\n/**\n * Split byte array into chunks, each encoded as a protocol frame\n */\nexport function splitIntoFrames(bytes: Uint8Array): FrameInfo[] {\n  if (bytes.length === 0) {\n    return [{ frameIndex: 0, totalFrames: 1, frame: encodeFrame(randomMsgId(), 0, 1, \"\"), payloadBase64: \"\" }];\n  }\n\n  const msgId = randomMsgId();\n  const headerOverhead = estimateHeaderLength(1) + 4;\n  const maxPayloadChars = TYPE15_BYTE_CAPACITY - headerOverhead;\n  const maxPayloadBytes = Math.floor((maxPayloadChars * 3) / 4);\n\n  if (maxPayloadBytes <= 0) {\n    throw new Error(\"Protocol header too large for Type 15 QR capacity\");\n  }\n\n  const total = Math.ceil(bytes.length / maxPayloadBytes);\n  const headerLen = estimateHeaderLength(total) + 4;\n  const maxPayloadCharsActual = TYPE15_BYTE_CAPACITY - headerLen;\n  const maxPayloadBytesActual = Math.floor((maxPayloadCharsActual * 3) / 4);\n\n  const frames: FrameInfo[] = [];\n  let offset = 0;\n\n  while (offset < bytes.length) {\n    const chunk = bytes.subarray(offset, Math.min(offset + maxPayloadBytesActual, bytes.length));\n    const chunkBase64 = btoa(String.fromCharCode.apply(null, Array.from(chunk)));\n    const frame = encodeFrame(msgId, frames.length, total, chunkBase64);\n    frames.push({ frameIndex: frames.length, totalFrames: total, frame, payloadBase64: chunkBase64 });\n    offset += chunk.length;\n  }\n\n  return frames;\n}\n\nfunction encodeFrame(msgId: string, idx: number, total: number, payloadBase64: string): string {\n  return `${msgId}|${idx}/${total}|${payloadBase64}`;\n}\n\nexport interface ParsedFrame {\n  msgId: string;\n  idx: number;\n  total: number;\n  payloadBase64: string;\n}\n\n/**\n * Parse protocol frame, returns null for invalid format\n */\nexport function parseFrame(text: string): ParsedFrame | null {\n  const pipe1 = text.indexOf(\"|\");\n  if (pipe1 < 0) return null;\n  const msgId = text.slice(0, pipe1);\n  const rest2 = text.slice(pipe1 + 1);\n  const slash = rest2.indexOf(\"/\");\n  const pipe2 = rest2.indexOf(\"|\");\n  if (slash < 0 || pipe2 < 0 || slash > pipe2) return null;\n  const idx = parseInt(rest2.slice(0, slash), 10);\n  const total = parseInt(rest2.slice(slash + 1, pipe2), 10);\n  const payloadBase64 = rest2.slice(pipe2 + 1);\n  if (isNaN(idx) || isNaN(total) || idx < 0 || total < 1 || idx >= total) return null;\n  return { msgId, idx, total, payloadBase64 };\n}\n\n/**\n * Decode base64 to Uint8Array\n */\nexport function base64ToBytes(base64: string): Uint8Array {\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n}\n\nexport interface AddFrameResult {\n  isNew: boolean;\n  frameIndex: number;\n  totalFrames: number;\n  msgId: string;\n  receivedCount: number;\n  complete: boolean;\n  data?: Uint8Array;\n}\n\n/**\n * Message aggregation state: collect frames by msgId, reassemble when complete\n */\nexport class FrameAggregator {\n  private chunks = new Map<string, Map<number, string>>();\n\n  add(parsed: ParsedFrame): AddFrameResult {\n    const { msgId, idx, total, payloadBase64 } = parsed;\n    let map = this.chunks.get(msgId);\n    if (!map) {\n      map = new Map();\n      this.chunks.set(msgId, map);\n    }\n    const isNew = !map.has(idx);\n    if (isNew) map.set(idx, payloadBase64);\n    const receivedCount = map.size;\n\n    if (receivedCount !== total) {\n      return {\n        isNew,\n        frameIndex: idx,\n        totalFrames: total,\n        msgId,\n        receivedCount,\n        complete: false,\n      };\n    }\n\n    const parts: Uint8Array[] = [];\n    for (let i = 0; i < total; i++) {\n      const b64 = map.get(i);\n      if (!b64) {\n        return { isNew, frameIndex: idx, totalFrames: total, msgId, receivedCount, complete: false };\n      }\n      parts.push(base64ToBytes(b64));\n    }\n    this.chunks.delete(msgId);\n    const totalLen = parts.reduce((s, p) => s + p.length, 0);\n    const data = new Uint8Array(totalLen);\n    let off = 0;\n    for (const p of parts) {\n      data.set(p, off);\n      off += p.length;\n    }\n    return {\n      isNew,\n      frameIndex: idx,\n      totalFrames: total,\n      msgId,\n      receivedCount,\n      complete: true,\n      data,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "qrcode-transmitter",
+  "version": "1.0.0",
+  "description": "A lightweight browser library for transmitting binary data across multi-frame QR codes.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "example": "vite --config example/vite.config.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "qr-scanner": "^1.4.2",
+    "qrcode-generator": "^2.0.4"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vite": "^6.0.0",
+    "vitest": "^2.0.0"
+  }
+}