@walkhi/code-relax 0.1.0-beta.50 → 0.1.0-beta.51

package/dist/shared/file-mentions.cjs

@@ -1,92 +1,92 @@
-(function (root, factory) {
-  const api = factory();
-  if (typeof module === 'object' && module.exports) module.exports = api;
-  else root.CodexFileMentions = api;
-})(globalThis, function () {
-  const heading = '# Files mentioned by the user:';
-  const pastedHeading = '# Files pasted by the user:';
-  const request = '## My request:';
-
-  function stripBrowserContext(value) {
-    const context = /^\s*<in-app-browser-context\b[^>]*>[\s\S]*?<\/in-app-browser-context>\s*/;
-    if (!context.test(value)) return value;
-    return value.replace(context, '').replace(/^## My request:[ \t]*(?:\r?\n|$)/, '').trim();
-  }
-
-  function parse(value) {
-    const source = stripBrowserContext(typeof value === 'string' ? value : '');
-    const firstHeading = [heading, pastedHeading].find(value => source.startsWith(value));
-    if (!firstHeading) return { text: source, files: [] };
-    const marker = source.indexOf(`\n${request}`, firstHeading.length);
-    if (marker < 0) return { text: source, files: [] };
-    const files = [];
-    let pasted = firstHeading === pastedHeading;
-    for (const line of source.slice(firstHeading.length, marker).split(/\r?\n/)) {
-      if (line === heading || line === pastedHeading) { pasted = line === pastedHeading; continue; }
-      if (line.startsWith('Uploaded file: ')) {
-        try {
-          const value = JSON.parse(line.slice('Uploaded file: '.length));
-          const fileId = /^sediment:\/\/([A-Za-z0-9_-]{1,256})$/.exec(value.pointer)?.[1];
-          if (fileId && typeof value.fileName === 'string' && value.fileName) files.push({ type: 'file', name: value.fileName, fileId });
-        } catch { /* Leave unrecognized text untouched when no attachment was parsed. */ }
-        continue;
-      }
-      const media = /^<!-- code-relax-media:(.+) -->$/.exec(line);
-      if (media && files.length) {
-        try { Object.assign(files.at(-1), mediaMetadata(JSON.parse(media[1]))); } catch {}
-        continue;
-      }
-      if (!pasted && line.trim() === 'Image attachment: true' && files.length) {
-        files.at(-1).isImageAttachment = true;
-        continue;
-      }
-      const match = /^## (.+): ((?:[A-Za-z]:[\\/]|\/)[^\r\n]+)$/.exec(line);
-      if (!match) continue;
-      let name = match[1];
-      if (name.startsWith('"')) {
-        try { name = JSON.parse(name); } catch { continue; }
-      }
-      if (typeof name !== 'string' || !name) continue;
-      files.push({ type: 'file', name: pasted ? match[2].split(/[\\/]/).at(-1) : name, path: match[2] });
-    }
-    if (!files.length) return { text: source, files: [] };
-    return { text: stripBrowserContext(source.slice(marker + request.length + 1).trim()), files };
-  }
-
-  function wrap(prompt, files) {
-    if (!files?.length) return prompt;
-    return `${heading}\n${files.map(file => {
-      const media = mediaMetadata(file);
-      return `\n## ${JSON.stringify(file.name)}: ${file.path}\n${media.mediaKind ? `<!-- code-relax-media:${JSON.stringify(media).replace(/</g, '\\u003c').replace(/>/g, '\\u003e')} -->\n` : ''}`;
-    }).join('')}\n${request}\n${prompt || '请查看上述文件。'}`;
-  }
-
-  function mediaMetadata(value) {
-    if (!value || !['image', 'video'].includes(value.mediaKind)) return {};
-    const result = { mediaKind: value.mediaKind };
-    for (const field of ['sha256', 'previewSha256']) if (/^[a-f0-9]{64}$/.test(value[field] || '')) result[field] = value[field];
-    if (typeof value.previewPath === 'string' && /^(?:[A-Za-z]:[\\/]|\/(?!\/))[^\r\n]+$/.test(value.previewPath)) result.previewPath = value.previewPath;
-    if (/^(?:image|video)\/[a-z0-9.+-]+$/i.test(value.mimeType || '')) result.mimeType = value.mimeType;
-    for (const field of ['size', 'duration']) if (Number.isFinite(value[field]) && value[field] > 0) result[field] = value[field];
-    return result;
-  }
-
-  // Formats accepted as native Codex image inputs; other files remain file references.
-  function isNativeImage(file) {
-    return file?.mediaKind === 'image' && /\.(png|jpe?g|webp|gif)$/i.test(file.name || file.path || '');
-  }
-  function attachment(file) {
-    return isNativeImage(file) ? { type: 'image', name: file.name, remotePath: file.path,
-      originalUpload: true, localImageId: file.sha256, localThumbnailId: file.previewSha256 }
-      : { ...file, type: 'file' };
-  }
-  function originalInputs(body) {
-    const paths = body.originalImages || [];
-    if (!Array.isArray(paths) || paths.length + (body.images || []).length > 4
-      || paths.some(value => typeof value !== 'string' || !/^(?:[A-Za-z]:[\\/]|\/(?!\/))[^\r\n]+\.(png|jpe?g|webp|gif)$/i.test(value))) {
-      throw new Error('原图路径无效或每条消息图片超过 4 张');
-    }
-    return paths.map(path => ({ type: 'localImage', path }));
-  }
-  return Object.freeze({ parse, wrap, mediaMetadata, isNativeImage, attachment, originalInputs });
-});
+(function (root, factory) {
+  const api = factory();
+  if (typeof module === 'object' && module.exports) module.exports = api;
+  else root.CodexFileMentions = api;
+})(globalThis, function () {
+  const heading = '# Files mentioned by the user:';
+  const pastedHeading = '# Files pasted by the user:';
+  const request = '## My request:';
+
+  function stripBrowserContext(value) {
+    const context = /^\s*<in-app-browser-context\b[^>]*>[\s\S]*?<\/in-app-browser-context>\s*/;
+    if (!context.test(value)) return value;
+    return value.replace(context, '').replace(/^## My request:[ \t]*(?:\r?\n|$)/, '').trim();
+  }
+
+  function parse(value) {
+    const source = stripBrowserContext(typeof value === 'string' ? value : '');
+    const firstHeading = [heading, pastedHeading].find(value => source.startsWith(value));
+    if (!firstHeading) return { text: source, files: [] };
+    const marker = source.indexOf(`\n${request}`, firstHeading.length);
+    if (marker < 0) return { text: source, files: [] };
+    const files = [];
+    let pasted = firstHeading === pastedHeading;
+    for (const line of source.slice(firstHeading.length, marker).split(/\r?\n/)) {
+      if (line === heading || line === pastedHeading) { pasted = line === pastedHeading; continue; }
+      if (line.startsWith('Uploaded file: ')) {
+        try {
+          const value = JSON.parse(line.slice('Uploaded file: '.length));
+          const fileId = /^sediment:\/\/([A-Za-z0-9_-]{1,256})$/.exec(value.pointer)?.[1];
+          if (fileId && typeof value.fileName === 'string' && value.fileName) files.push({ type: 'file', name: value.fileName, fileId });
+        } catch { /* Leave unrecognized text untouched when no attachment was parsed. */ }
+        continue;
+      }
+      const media = /^<!-- code-relax-media:(.+) -->$/.exec(line);
+      if (media && files.length) {
+        try { Object.assign(files.at(-1), mediaMetadata(JSON.parse(media[1]))); } catch {}
+        continue;
+      }
+      if (!pasted && line.trim() === 'Image attachment: true' && files.length) {
+        files.at(-1).isImageAttachment = true;
+        continue;
+      }
+      const match = /^## (.+): ((?:[A-Za-z]:[\\/]|\/)[^\r\n]+)$/.exec(line);
+      if (!match) continue;
+      let name = match[1];
+      if (name.startsWith('"')) {
+        try { name = JSON.parse(name); } catch { continue; }
+      }
+      if (typeof name !== 'string' || !name) continue;
+      files.push({ type: 'file', name: pasted ? match[2].split(/[\\/]/).at(-1) : name, path: match[2] });
+    }
+    if (!files.length) return { text: source, files: [] };
+    return { text: stripBrowserContext(source.slice(marker + request.length + 1).trim()), files };
+  }
+
+  function wrap(prompt, files) {
+    if (!files?.length) return prompt;
+    return `${heading}\n${files.map(file => {
+      const media = mediaMetadata(file);
+      return `\n## ${JSON.stringify(file.name)}: ${file.path}\n${media.mediaKind ? `<!-- code-relax-media:${JSON.stringify(media).replace(/</g, '\\u003c').replace(/>/g, '\\u003e')} -->\n` : ''}`;
+    }).join('')}\n${request}\n${prompt || '请查看上述文件。'}`;
+  }
+
+  function mediaMetadata(value) {
+    if (!value || !['image', 'video'].includes(value.mediaKind)) return {};
+    const result = { mediaKind: value.mediaKind };
+    for (const field of ['sha256', 'previewSha256']) if (/^[a-f0-9]{64}$/.test(value[field] || '')) result[field] = value[field];
+    if (typeof value.previewPath === 'string' && /^(?:[A-Za-z]:[\\/]|\/(?!\/))[^\r\n]+$/.test(value.previewPath)) result.previewPath = value.previewPath;
+    if (/^(?:image|video)\/[a-z0-9.+-]+$/i.test(value.mimeType || '')) result.mimeType = value.mimeType;
+    for (const field of ['size', 'duration']) if (Number.isFinite(value[field]) && value[field] > 0) result[field] = value[field];
+    return result;
+  }
+
+  // Formats accepted as native Codex image inputs; other files remain file references.
+  function isNativeImage(file) {
+    return file?.mediaKind === 'image' && /\.(png|jpe?g|webp|gif)$/i.test(file.name || file.path || '');
+  }
+  function attachment(file) {
+    return isNativeImage(file) ? { type: 'image', name: file.name, remotePath: file.path,
+      originalUpload: true, localImageId: file.sha256, localThumbnailId: file.previewSha256 }
+      : { ...file, type: 'file' };
+  }
+  function originalInputs(body) {
+    const paths = body.originalImages || [];
+    if (!Array.isArray(paths) || paths.length + (body.images || []).length > 4
+      || paths.some(value => typeof value !== 'string' || !/^(?:[A-Za-z]:[\\/]|\/(?!\/))[^\r\n]+\.(png|jpe?g|webp|gif)$/i.test(value))) {
+      throw new Error('原图路径无效或每条消息图片超过 4 张');
+    }
+    return paths.map(path => ({ type: 'localImage', path }));
+  }
+  return Object.freeze({ parse, wrap, mediaMetadata, isNativeImage, attachment, originalInputs });
+});

package/dist/shared/message-delivery.cjs

@@ -1,115 +1,115 @@
-(function (root, factory) {
-  const value = factory();
-  if (typeof module === 'object' && module.exports) module.exports = value;
-  else root.CodexMessageDelivery = value;
-})(globalThis, function () {
-  function rejectedBeforeSubmission(error) {
-    return error?.rpcCode === -32602 || error?.rpcCode === -32600
-      || error?.rpcCode != null && /^(no active turn to steer|expected active turn id `)/i.test(error.message || '');
-  }
-
-  // A UI/request deadline must not discard a later authoritative write receipt.
-  function retainLateResult(pending, error) {
-    const reject = pending.reject;
-    error.deliveryResult = new Promise((resolve, reject) => {
-      pending.resolve = resolve; pending.reject = reject;
-    });
-    error.deliveryResult.catch(() => {});
-    reject(error);
-  }
-
-  class Store {
-    constructor() { this.entries = new Map(); }
-    key(scope, clientId) { return JSON.stringify([scope, clientId]); }
-    beginCreation(scope, clientId) {
-      const entry = this.entries.get(this.key(scope, clientId));
-      let finish;
-      entry.creationReady = new Promise(resolve => { finish = resolve; });
-      return threadId => {
-        if (threadId) entry.createdThreadId = threadId;
-        finish();
-      };
-    }
-    async creationBindings() {
-      await Promise.all([...this.entries.values()].map(entry => entry.creationReady));
-      return new Map([...this.entries].filter(([, entry]) => entry.createdThreadId)
-        .map(([key, entry]) => [entry.createdThreadId, JSON.parse(key)[1]]));
-    }
-    status(scope, clientId) {
-      const entry = this.entries.get(this.key(scope, clientId));
-      return entry ? { state: entry.state, ...(entry.result ? { result: entry.result } : {}),
-        ...(entry.createdThreadId ? { createdThreadId: entry.createdThreadId } : {}),
-        ...(entry.error ? { error: entry.error.message } : {}) } : { state: 'unknown' };
-    }
-    async reconcile(scope, clientId, inspect) {
-      const key = this.key(scope, clientId);
-      let entry = this.entries.get(key);
-      if (entry?.state === 'accepted' || entry?.state === 'not_sent') return this.status(scope, clientId);
-      if (entry?.checking) return entry.checking;
-      if (!entry) {
-        // Fence a request which never arrived before checking history. A delayed
-        // transport frame with this admission must not execute after a replacement.
-        entry = { state: 'unknown', fenced: true };
-        this.entries.set(key, entry);
-      }
-      const target = entry;
-      target.checking = (async () => {
-        if (target.work) await target.work.catch(() => {});
-        if (target.lateWork) await target.lateWork;
-        if (target.state === 'accepted' || target.state === 'not_sent') return this.status(scope, clientId);
-        const result = await inspect();
-        target.state = result ? 'accepted' : 'not_sent';
-        target.fenced = true;
-        if (result) target.result = result;
-        delete target.error;
-        return this.status(scope, clientId);
-      })().finally(() => { delete target.checking; });
-      return target.checking;
-    }
-    submit(scope, clientId, operation) {
-      if (!/^[a-f0-9]{32}$/i.test(clientId || '')) return Promise.reject(Object.assign(new Error('消息确认标识无效'), { deliveryUnknown: false }));
-      const key = this.key(scope, clientId), previous = this.entries.get(key);
-      if (previous?.state === 'accepted') return Promise.resolve(previous.result);
-      if (previous?.fenced) return Promise.reject(Object.assign(new Error('原发送请求已结束，请使用新的发送标识'), { deliveryUnknown: false }));
-      if (previous?.state === 'sending') return previous.work;
-      if (previous?.state === 'unknown') return Promise.reject(Object.assign(new Error(previous.error?.message || '原发送结果仍未确认'), { deliveryUnknown: true }));
-      const entry = { state: 'sending' };
-      this.entries.set(key, entry);
-      entry.work = Promise.resolve().then(operation).then(result => {
-        entry.state = 'accepted'; entry.result = result; return result;
-      }, error => {
-        entry.state = error.deliveryUnknown === false || error.details?.deliveryUnknown === false ? 'not_sent' : 'unknown';
-        error.deliveryUnknown = entry.state !== 'not_sent';
-        if (error.deliveryResult) entry.lateWork = error.deliveryResult.then(result => {
-          entry.state = 'accepted'; entry.result = result; delete entry.error;
-        }, lateError => {
-          entry.state = rejectedBeforeSubmission(lateError) || lateError.deliveryUnknown === false ? 'not_sent' : 'unknown';
-          entry.error = lateError;
-        });
-        entry.error = error; throw error;
-      }).finally(() => { delete entry.work; });
-      return entry.work;
-    }
-  }
-  const normalizeId = value => String(value || '').replace(/-/g, '').toLowerCase();
-  async function findMessage(request, threadId, clientId, anchorItemId = '') {
-    let cursor;
-    const seen = new Set();
-    do {
-      const page = await request('thread/items/list', { threadId, limit: 100, sortDirection: 'desc', ...(cursor ? { cursor } : {}) });
-      if (!Array.isArray(page?.data)) throw new Error('发送核对失败：未取得权威历史');
-      for (const entry of page.data) {
-        const item = entry.item;
-        if (item?.type === 'userMessage' && normalizeId(item.clientId) === normalizeId(clientId)) {
-          return { data: { messageId: item.id, turnId: entry.turnId } };
-        }
-        if (anchorItemId && item?.id === anchorItemId) return null;
-      }
-      cursor = page.nextCursor;
-      if (cursor && seen.has(cursor)) throw new Error('发送核对失败：历史游标未推进');
-      if (cursor) seen.add(cursor);
-    } while (cursor);
-    return null;
-  }
-  return Object.freeze({ Store, rejectedBeforeSubmission, retainLateResult, findMessage, normalizeId });
-});
+(function (root, factory) {
+  const value = factory();
+  if (typeof module === 'object' && module.exports) module.exports = value;
+  else root.CodexMessageDelivery = value;
+})(globalThis, function () {
+  function rejectedBeforeSubmission(error) {
+    return error?.rpcCode === -32602 || error?.rpcCode === -32600
+      || error?.rpcCode != null && /^(no active turn to steer|expected active turn id `)/i.test(error.message || '');
+  }
+
+  // A UI/request deadline must not discard a later authoritative write receipt.
+  function retainLateResult(pending, error) {
+    const reject = pending.reject;
+    error.deliveryResult = new Promise((resolve, reject) => {
+      pending.resolve = resolve; pending.reject = reject;
+    });
+    error.deliveryResult.catch(() => {});
+    reject(error);
+  }
+
+  class Store {
+    constructor() { this.entries = new Map(); }
+    key(scope, clientId) { return JSON.stringify([scope, clientId]); }
+    beginCreation(scope, clientId) {
+      const entry = this.entries.get(this.key(scope, clientId));
+      let finish;
+      entry.creationReady = new Promise(resolve => { finish = resolve; });
+      return threadId => {
+        if (threadId) entry.createdThreadId = threadId;
+        finish();
+      };
+    }
+    async creationBindings() {
+      await Promise.all([...this.entries.values()].map(entry => entry.creationReady));
+      return new Map([...this.entries].filter(([, entry]) => entry.createdThreadId)
+        .map(([key, entry]) => [entry.createdThreadId, JSON.parse(key)[1]]));
+    }
+    status(scope, clientId) {
+      const entry = this.entries.get(this.key(scope, clientId));
+      return entry ? { state: entry.state, ...(entry.result ? { result: entry.result } : {}),
+        ...(entry.createdThreadId ? { createdThreadId: entry.createdThreadId } : {}),
+        ...(entry.error ? { error: entry.error.message } : {}) } : { state: 'unknown' };
+    }
+    async reconcile(scope, clientId, inspect) {
+      const key = this.key(scope, clientId);
+      let entry = this.entries.get(key);
+      if (entry?.state === 'accepted' || entry?.state === 'not_sent') return this.status(scope, clientId);
+      if (entry?.checking) return entry.checking;
+      if (!entry) {
+        // Fence a request which never arrived before checking history. A delayed
+        // transport frame with this admission must not execute after a replacement.
+        entry = { state: 'unknown', fenced: true };
+        this.entries.set(key, entry);
+      }
+      const target = entry;
+      target.checking = (async () => {
+        if (target.work) await target.work.catch(() => {});
+        if (target.lateWork) await target.lateWork;
+        if (target.state === 'accepted' || target.state === 'not_sent') return this.status(scope, clientId);
+        const result = await inspect();
+        target.state = result ? 'accepted' : 'not_sent';
+        target.fenced = true;
+        if (result) target.result = result;
+        delete target.error;
+        return this.status(scope, clientId);
+      })().finally(() => { delete target.checking; });
+      return target.checking;
+    }
+    submit(scope, clientId, operation) {
+      if (!/^[a-f0-9]{32}$/i.test(clientId || '')) return Promise.reject(Object.assign(new Error('消息确认标识无效'), { deliveryUnknown: false }));
+      const key = this.key(scope, clientId), previous = this.entries.get(key);
+      if (previous?.state === 'accepted') return Promise.resolve(previous.result);
+      if (previous?.fenced) return Promise.reject(Object.assign(new Error('原发送请求已结束，请使用新的发送标识'), { deliveryUnknown: false }));
+      if (previous?.state === 'sending') return previous.work;
+      if (previous?.state === 'unknown') return Promise.reject(Object.assign(new Error(previous.error?.message || '原发送结果仍未确认'), { deliveryUnknown: true }));
+      const entry = { state: 'sending' };
+      this.entries.set(key, entry);
+      entry.work = Promise.resolve().then(operation).then(result => {
+        entry.state = 'accepted'; entry.result = result; return result;
+      }, error => {
+        entry.state = error.deliveryUnknown === false || error.details?.deliveryUnknown === false ? 'not_sent' : 'unknown';
+        error.deliveryUnknown = entry.state !== 'not_sent';
+        if (error.deliveryResult) entry.lateWork = error.deliveryResult.then(result => {
+          entry.state = 'accepted'; entry.result = result; delete entry.error;
+        }, lateError => {
+          entry.state = rejectedBeforeSubmission(lateError) || lateError.deliveryUnknown === false ? 'not_sent' : 'unknown';
+          entry.error = lateError;
+        });
+        entry.error = error; throw error;
+      }).finally(() => { delete entry.work; });
+      return entry.work;
+    }
+  }
+  const normalizeId = value => String(value || '').replace(/-/g, '').toLowerCase();
+  async function findMessage(request, threadId, clientId, anchorItemId = '') {
+    let cursor;
+    const seen = new Set();
+    do {
+      const page = await request('thread/items/list', { threadId, limit: 100, sortDirection: 'desc', ...(cursor ? { cursor } : {}) });
+      if (!Array.isArray(page?.data)) throw new Error('发送核对失败：未取得权威历史');
+      for (const entry of page.data) {
+        const item = entry.item;
+        if (item?.type === 'userMessage' && normalizeId(item.clientId) === normalizeId(clientId)) {
+          return { data: { messageId: item.id, turnId: entry.turnId } };
+        }
+        if (anchorItemId && item?.id === anchorItemId) return null;
+      }
+      cursor = page.nextCursor;
+      if (cursor && seen.has(cursor)) throw new Error('发送核对失败：历史游标未推进');
+      if (cursor) seen.add(cursor);
+    } while (cursor);
+    return null;
+  }
+  return Object.freeze({ Store, rejectedBeforeSubmission, retainLateResult, findMessage, normalizeId });
+});

package/dist/shared/p2p-file-channel.cjs

@@ -1,87 +1,87 @@
-(function (root, factory) {
-  if (typeof module === 'object' && module.exports) module.exports = factory();
-  else root.CodeRelaxFileChannel = factory();
-})(globalThis, function () {
-  const PART = 16 * 1024, MAX = 256 * 1024, LIMIT = 1024 * 1024;
-  // Socket-shaped adapter; one ordered RTC stream owns one file transaction.
-  return class FileChannel {
-    constructor(io) {
-      this.io = io; this.readyState = 0; this.listeners = new Map();
-      this.outbound = []; this.queued = 0; this.partial = null; this.timer = null;
-    }
-    get bufferedAmount() { return this.queued + this.io.buffered(); }
-    addEventListener(type, callback, options = {}) {
-      const list = this.listeners.get(type) || []; list.push({ callback, once: options.once }); this.listeners.set(type, list);
-    }
-    removeEventListener(type, callback) { this.listeners.set(type, (this.listeners.get(type) || []).filter(item => item.callback !== callback)); }
-    emit(type, details = {}) {
-      const event = { type, ...details };
-      this['on' + type]?.(event);
-      for (const item of [...(this.listeners.get(type) || [])]) {
-        if (item.once) this.removeEventListener(type, item.callback);
-        item.callback(event);
-      }
-    }
-    opened() { if (this.readyState !== 0) return; this.readyState = 1; this.emit('open'); this.pump(); }
-    send(value) {
-      if (this.readyState !== 1) throw new Error('文件直连已断开');
-      const binary = typeof value !== 'string';
-      const data = binary ? (value instanceof Uint8Array ? value : new Uint8Array(value)) : value;
-      const size = binary ? data.byteLength : new TextEncoder().encode(data).length;
-      if (!size || size > (binary ? MAX : PART) || this.bufferedAmount + size > LIMIT) throw new Error('文件直连分片或队列超限');
-      const negotiated = this.io.maxMessageSize?.();
-      const frameBytes = Number.isFinite(negotiated) && negotiated > 0 ? Math.min(PART, Math.max(1, Math.floor(negotiated))) : PART;
-      const frames = binary ? [JSON.stringify({ type: 'rtc-file-bytes', length: size })] : [];
-      if (binary) for (let i = 0; i < size; i += frameBytes) frames.push(data.slice(i, i + frameBytes));
-      else frames.push(data);
-      const sizes = frames.map(frame => typeof frame === 'string' ? new TextEncoder().encode(frame).length : frame.byteLength);
-      if (sizes.some(length => length > frameBytes)) throw new Error('文件传输消息超过协商上限');
-      const framedSize = sizes.reduce((total, length) => total + length, 0);
-      if (this.bufferedAmount + framedSize > LIMIT) throw new Error('文件直连队列超限');
-      this.outbound.push({ frames, sizes, index: 0 }); this.queued += framedSize; this.pump();
-    }
-    pump() {
-      if (this.readyState !== 1) return;
-      try {
-        while (this.outbound.length && this.io.buffered() < MAX) {
-          const item = this.outbound[0];
-          // libdatachannel returns false when it accepted the frame into its buffer.
-          // Only an exception rejects a send; replaying a buffered frame duplicates bytes.
-          this.io.send(item.frames[item.index]);
-          this.queued -= item.sizes[item.index];
-          if (++item.index === item.frames.length) this.outbound.shift();
-        }
-      } catch (error) { this.close(1011, `send-failed:${String(error?.name || 'Error').slice(0, 40)}`); }
-    }
-    waitForPartial() {
-      clearTimeout(this.timer);
-      this.timer = setTimeout(() => this.close(1008, 'partial-idle-timeout'), 30000);
-    }
-    receive(value) {
-      if (this.readyState !== 1) return;
-      try {
-        if (typeof value === 'string') {
-          if (this.partial || new TextEncoder().encode(value).length > PART) throw new Error();
-          const frame = JSON.parse(value);
-          if (frame.type !== 'rtc-file-bytes') { this.io.received?.(); this.emit('message', { data: value }); return; }
-          if (!Number.isSafeInteger(frame.length) || frame.length < 1 || frame.length > MAX) throw new Error();
-          this.io.received?.(); this.partial = { data: new Uint8Array(frame.length), offset: 0 };
-          this.waitForPartial(); return;
-        }
-        const bytes = value instanceof Uint8Array ? value : new Uint8Array(value), part = this.partial;
-        if (!part || bytes.length < 1 || bytes.length > Math.min(PART, part.data.length - part.offset)) throw new Error();
-        this.waitForPartial(); this.io.received?.(); part.data.set(bytes, part.offset); part.offset += bytes.length;
-        if (part.offset === part.data.length) {
-          this.partial = null; clearTimeout(this.timer); this.timer = null;
-          this.emit('message', { data: part.data.buffer });
-        }
-      } catch { this.close(1008, 'invalid-frame'); }
-    }
-    close(code = 1000, reason = '') {
-      if (this.readyState === 3) return;
-      this.readyState = 3; clearTimeout(this.timer); this.timer = null;
-      this.partial = null; this.outbound = []; this.queued = 0;
-      this.io.close(); this.emit('close', { code, reason });
-    }
-  };
-});
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) module.exports = factory();
+  else root.CodeRelaxFileChannel = factory();
+})(globalThis, function () {
+  const PART = 16 * 1024, MAX = 256 * 1024, LIMIT = 1024 * 1024;
+  // Socket-shaped adapter; one ordered RTC stream owns one file transaction.
+  return class FileChannel {
+    constructor(io) {
+      this.io = io; this.readyState = 0; this.listeners = new Map();
+      this.outbound = []; this.queued = 0; this.partial = null; this.timer = null;
+    }
+    get bufferedAmount() { return this.queued + this.io.buffered(); }
+    addEventListener(type, callback, options = {}) {
+      const list = this.listeners.get(type) || []; list.push({ callback, once: options.once }); this.listeners.set(type, list);
+    }
+    removeEventListener(type, callback) { this.listeners.set(type, (this.listeners.get(type) || []).filter(item => item.callback !== callback)); }
+    emit(type, details = {}) {
+      const event = { type, ...details };
+      this['on' + type]?.(event);
+      for (const item of [...(this.listeners.get(type) || [])]) {
+        if (item.once) this.removeEventListener(type, item.callback);
+        item.callback(event);
+      }
+    }
+    opened() { if (this.readyState !== 0) return; this.readyState = 1; this.emit('open'); this.pump(); }
+    send(value) {
+      if (this.readyState !== 1) throw new Error('文件直连已断开');
+      const binary = typeof value !== 'string';
+      const data = binary ? (value instanceof Uint8Array ? value : new Uint8Array(value)) : value;
+      const size = binary ? data.byteLength : new TextEncoder().encode(data).length;
+      if (!size || size > (binary ? MAX : PART) || this.bufferedAmount + size > LIMIT) throw new Error('文件直连分片或队列超限');
+      const negotiated = this.io.maxMessageSize?.();
+      const frameBytes = Number.isFinite(negotiated) && negotiated > 0 ? Math.min(PART, Math.max(1, Math.floor(negotiated))) : PART;
+      const frames = binary ? [JSON.stringify({ type: 'rtc-file-bytes', length: size })] : [];
+      if (binary) for (let i = 0; i < size; i += frameBytes) frames.push(data.slice(i, i + frameBytes));
+      else frames.push(data);
+      const sizes = frames.map(frame => typeof frame === 'string' ? new TextEncoder().encode(frame).length : frame.byteLength);
+      if (sizes.some(length => length > frameBytes)) throw new Error('文件传输消息超过协商上限');
+      const framedSize = sizes.reduce((total, length) => total + length, 0);
+      if (this.bufferedAmount + framedSize > LIMIT) throw new Error('文件直连队列超限');
+      this.outbound.push({ frames, sizes, index: 0 }); this.queued += framedSize; this.pump();
+    }
+    pump() {
+      if (this.readyState !== 1) return;
+      try {
+        while (this.outbound.length && this.io.buffered() < MAX) {
+          const item = this.outbound[0];
+          // libdatachannel returns false when it accepted the frame into its buffer.
+          // Only an exception rejects a send; replaying a buffered frame duplicates bytes.
+          this.io.send(item.frames[item.index]);
+          this.queued -= item.sizes[item.index];
+          if (++item.index === item.frames.length) this.outbound.shift();
+        }
+      } catch (error) { this.close(1011, `send-failed:${String(error?.name || 'Error').slice(0, 40)}`); }
+    }
+    waitForPartial() {
+      clearTimeout(this.timer);
+      this.timer = setTimeout(() => this.close(1008, 'partial-idle-timeout'), 30000);
+    }
+    receive(value) {
+      if (this.readyState !== 1) return;
+      try {
+        if (typeof value === 'string') {
+          if (this.partial || new TextEncoder().encode(value).length > PART) throw new Error();
+          const frame = JSON.parse(value);
+          if (frame.type !== 'rtc-file-bytes') { this.io.received?.(); this.emit('message', { data: value }); return; }
+          if (!Number.isSafeInteger(frame.length) || frame.length < 1 || frame.length > MAX) throw new Error();
+          this.io.received?.(); this.partial = { data: new Uint8Array(frame.length), offset: 0 };
+          this.waitForPartial(); return;
+        }
+        const bytes = value instanceof Uint8Array ? value : new Uint8Array(value), part = this.partial;
+        if (!part || bytes.length < 1 || bytes.length > Math.min(PART, part.data.length - part.offset)) throw new Error();
+        this.waitForPartial(); this.io.received?.(); part.data.set(bytes, part.offset); part.offset += bytes.length;
+        if (part.offset === part.data.length) {
+          this.partial = null; clearTimeout(this.timer); this.timer = null;
+          this.emit('message', { data: part.data.buffer });
+        }
+      } catch { this.close(1008, 'invalid-frame'); }
+    }
+    close(code = 1000, reason = '') {
+      if (this.readyState === 3) return;
+      this.readyState = 3; clearTimeout(this.timer); this.timer = null;
+      this.partial = null; this.outbound = []; this.queued = 0;
+      this.io.close(); this.emit('close', { code, reason });
+    }
+  };
+});