@aalis/util-media-signature 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ace Nyan <ace@acenyan.com>
+
+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/dist/index.d.ts

@@ -0,0 +1,20 @@
+/** 可发送的附件类型。 */
+export type MediaKind = 'image' | 'audio' | 'video';
+/** 文件头认出的媒体格式：所属类型与格式名（如 PNG、M4A、MKV）。 */
+export interface MediaFormat {
+    kind: MediaKind;
+    format: string;
+}
+/**
+ * 认定格式要读的文件头长度：与 file(1) 在前 4 KiB 里找 Matroska DocType 的范围一致，也容得下 ftyp 盒的
+ * 兼容品牌表；其余签名都在前 20 字节内。
+ */
+export declare const MEDIA_HEAD_BYTES = 4096;
+/** 按文件头认定媒体格式；不是签名表里任何一种格式时返回 null。 */
+export declare function detectMediaFormat(head: Uint8Array): MediaFormat | null;
+/**
+ * 核对文件头是否为所请求 kind 的受支持格式。相符返回 null；不符返回给模型的拒发说明：
+ * 不是任何受支持的媒体格式时说明不能按该类型发送，是别类媒体时说出检测到的格式与该用的 kind。
+ */
+export declare function checkMediaHead(head: Uint8Array, kind: MediaKind): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAoDrC,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAGtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAY/E"}

package/dist/index.js

@@ -0,0 +1,160 @@
+// ============================================================
+// @aalis/util-media-signature — 按文件头认定媒体格式
+//
+// 存储根里除了媒体，还有配置、令牌、记忆库、日志；只凭 kind 与路径发送，
+// 这些文件会被当成图片发出去。发送附件的一方先读文件开头的字节，按下表的
+// 格式签名认定格式，再决定放行、换一种方式发送还是拒发。
+// 签名依据各格式的规范，并与 file(1) 的 magic 库对照（SILK 不在该库里）。
+// 纯函数、无依赖，只用 Uint8Array。
+// ============================================================
+/**
+ * 认定格式要读的文件头长度：与 file(1) 在前 4 KiB 里找 Matroska DocType 的范围一致，也容得下 ftyp 盒的
+ * 兼容品牌表；其余签名都在前 20 字节内。
+ */
+export const MEDIA_HEAD_BYTES = 4096;
+const KIND_LABEL = { image: '图片', audio: '音频', video: '视频' };
+/** BMP 偏移 14 处 DIB 头长度的合法取值（file(1) 认的各版本）；只有 'BM' 两字节太弱，文本也可能以它开头。 */
+const BMP_DIB_HEADER_SIZES = new Set([12, 16, 24, 40, 48, 52, 56, 64, 108, 124]);
+/** AMR 文件存储格式的魔数：单声道窄带、宽带与各自的多声道版本（RFC 4867 §5）。 */
+const AMR_MAGICS = ['#!AMR\n', '#!AMR-WB\n', '#!AMR_MC1.0\n', '#!AMR-WB_MC1.0\n'];
+const AVIF_BRANDS = new Set(['avif', 'avis']);
+/** HEIF 的图片与图片序列品牌（ISO/IEC 23008-12）：HEVC 编码的 heic 系与通用的 mif1、msf1。 */
+const HEIF_BRANDS = new Set(['heic', 'heix', 'heim', 'heis', 'hevc', 'hevx', 'hevm', 'hevs', 'mif1', 'msf1']);
+const M4A_BRANDS = new Set(['M4A ', 'M4B ', 'M4P ']);
+const SIGNATURES = [
+    { kind: 'image', format: 'PNG', matches: h => hasBytes(h, 0, [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]) },
+    // SOI 标记 FFD8 之后紧跟下一个标记的 FF
+    { kind: 'image', format: 'JPEG', matches: h => hasBytes(h, 0, [0xff, 0xd8, 0xff]) },
+    { kind: 'image', format: 'GIF', matches: h => hasAscii(h, 0, 'GIF87a') || hasAscii(h, 0, 'GIF89a') },
+    { kind: 'image', format: 'WebP', matches: h => isRiff(h, 'WEBP') },
+    {
+        kind: 'image',
+        format: 'BMP',
+        matches: h => hasAscii(h, 0, 'BM') && h.length >= 18 && BMP_DIB_HEADER_SIZES.has(readUint32LE(h, 14)),
+    },
+    { kind: 'image', format: 'AVIF', matches: h => isoMediaFormat(h) === 'AVIF' },
+    { kind: 'image', format: 'HEIC', matches: h => isoMediaFormat(h) === 'HEIC' },
+    { kind: 'audio', format: 'MP3', matches: h => isId3v2(h) || isMp3Frame(h) },
+    { kind: 'audio', format: 'WAV', matches: h => isRiff(h, 'WAVE') },
+    // 页头捕获模式 'OggS' 加结构版本 0（RFC 3533）
+    { kind: 'audio', format: 'OGG', matches: h => hasBytes(h, 0, [0x4f, 0x67, 0x67, 0x53, 0x00]) },
+    { kind: 'audio', format: 'FLAC', matches: h => hasAscii(h, 0, 'fLaC') },
+    { kind: 'audio', format: 'AMR', matches: h => AMR_MAGICS.some(m => hasAscii(h, 0, m)) },
+    // QQ 语音的 SILK 前面可能多一个 0x02
+    {
+        kind: 'audio',
+        format: 'SILK',
+        matches: h => hasAscii(h, 0, '#!SILK_V3') || (h[0] === 0x02 && hasAscii(h, 1, '#!SILK_V3')),
+    },
+    { kind: 'audio', format: 'M4A', matches: h => isoMediaFormat(h) === 'M4A' },
+    { kind: 'video', format: 'MP4', matches: h => isoMediaFormat(h) === 'MP4' },
+    { kind: 'video', format: 'MOV', matches: h => isoMediaFormat(h) === 'MOV' },
+    { kind: 'video', format: 'WebM', matches: h => ebmlDocType(h) === 'webm' },
+    { kind: 'video', format: 'MKV', matches: h => ebmlDocType(h) === 'matroska' },
+    { kind: 'video', format: 'AVI', matches: h => isRiff(h, 'AVI ') },
+];
+/** 按文件头认定媒体格式；不是签名表里任何一种格式时返回 null。 */
+export function detectMediaFormat(head) {
+    const detected = SIGNATURES.find(s => s.matches(head));
+    return detected ? { kind: detected.kind, format: detected.format } : null;
+}
+/**
+ * 核对文件头是否为所请求 kind 的受支持格式。相符返回 null；不符返回给模型的拒发说明：
+ * 不是任何受支持的媒体格式时说明不能按该类型发送，是别类媒体时说出检测到的格式与该用的 kind。
+ */
+export function checkMediaHead(head, kind) {
+    const detected = detectMediaFormat(head);
+    if (!detected) {
+        const supported = SIGNATURES.filter(s => s.kind === kind)
+            .map(s => s.format)
+            .join('、');
+        return `文件不是受支持的${KIND_LABEL[kind]}格式（${supported}），不能按 ${kind} 发送`;
+    }
+    if (detected.kind !== kind) {
+        return `文件是 ${detected.format} ${KIND_LABEL[detected.kind]}，不能按 ${kind} 发送；请改用 kind=${detected.kind} 重新发送`;
+    }
+    return null;
+}
+/**
+ * ISO 基础媒体文件（ISO/IEC 14496-12）按 ftyp 盒的品牌分类。AVIF 与 HEIF 在主品牌与兼容品牌里都找：
+ * AVIF 文件的主品牌也可能写 mif1，avif 只列在兼容品牌里。M4A 与 MOV 只看主品牌：iTunes 的 M4V 视频
+ * 会把 'M4A ' 列进兼容品牌。其余品牌（isom、mp41、mp42、3gp 系等）都归 MP4 家族的视频容器。
+ */
+function isoMediaFormat(h) {
+    if (h.length < 12 || !hasAscii(h, 4, 'ftyp'))
+        return null;
+    const major = ascii(h, 8, 4);
+    const boxEnd = Math.min(readUint32BE(h, 0), h.length);
+    const brands = [major];
+    for (let offset = 16; offset + 4 <= boxEnd; offset += 4)
+        brands.push(ascii(h, offset, 4));
+    if (brands.some(b => AVIF_BRANDS.has(b)))
+        return 'AVIF';
+    if (brands.some(b => HEIF_BRANDS.has(b)))
+        return 'HEIC';
+    if (M4A_BRANDS.has(major))
+        return 'M4A';
+    if (major === 'qt  ')
+        return 'MOV';
+    return 'MP4';
+}
+/**
+ * Matroska 与 WebM 同为 EBML 容器（魔数 1A45DFA3），靠 DocType 元素（ID 0x4282）区分：
+ * 与 file(1) 一样在文件头里找到它，跳过一字节长度后比对。
+ */
+function ebmlDocType(h) {
+    if (!hasBytes(h, 0, [0x1a, 0x45, 0xdf, 0xa3]))
+        return null;
+    for (let i = 4; i + 1 < h.length; i++) {
+        if (h[i] !== 0x42 || h[i + 1] !== 0x82)
+            continue;
+        if (hasAscii(h, i + 3, 'webm'))
+            return 'webm';
+        if (hasAscii(h, i + 3, 'matroska'))
+            return 'matroska';
+        return null;
+    }
+    return null;
+}
+/** ID3v2 标签：'ID3' 后接主版本号（现有 2、3、4 三版）与不为 FF 的修订号。 */
+function isId3v2(h) {
+    return hasAscii(h, 0, 'ID3') && h.length >= 5 && h[3] >= 2 && h[3] <= 4 && h[4] !== 0xff;
+}
+/** MPEG 音频帧头：11 位同步，版本不为保留值 01，层为 Layer III（01），码率索引不为 1111，采样率索引不为 11。 */
+function isMp3Frame(h) {
+    if (h.length < 3 || h[0] !== 0xff || (h[1] & 0xe0) !== 0xe0)
+        return false;
+    const version = (h[1] >> 3) & 0x03;
+    const layer = (h[1] >> 1) & 0x03;
+    const bitrateIndex = h[2] >> 4;
+    const sampleRateIndex = (h[2] >> 2) & 0x03;
+    return version !== 0x01 && layer === 0x01 && bitrateIndex !== 0x0f && sampleRateIndex !== 0x03;
+}
+/** RIFF 容器：'RIFF' 加 4 字节长度，偏移 8 处是形式类型（WAVE、AVI 、WEBP）。 */
+function isRiff(h, formType) {
+    return hasAscii(h, 0, 'RIFF') && hasAscii(h, 8, formType);
+}
+function hasBytes(h, offset, bytes) {
+    if (h.length < offset + bytes.length)
+        return false;
+    return bytes.every((b, i) => h[offset + i] === b);
+}
+function hasAscii(h, offset, text) {
+    if (h.length < offset + text.length)
+        return false;
+    for (let i = 0; i < text.length; i++) {
+        if (h[offset + i] !== text.charCodeAt(i))
+            return false;
+    }
+    return true;
+}
+function ascii(h, offset, length) {
+    return String.fromCharCode(...h.subarray(offset, offset + length));
+}
+function readUint32BE(h, offset) {
+    return ((h[offset] << 24) | (h[offset + 1] << 16) | (h[offset + 2] << 8) | h[offset + 3]) >>> 0;
+}
+function readUint32LE(h, offset) {
+    return (h[offset] | (h[offset + 1] << 8) | (h[offset + 2] << 16) | (h[offset + 3] << 24)) >>> 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@aalis/util-media-signature",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AalisLabs/Aalis.git",
+    "directory": "packages/util-media-signature"
+  },
+  "author": "Ace Nyan <ace@acenyan.com>",
+  "bugs": {
+    "url": "https://github.com/AalisLabs/Aalis/issues"
+  },
+  "homepage": "https://github.com/AalisLabs/Aalis#readme",
+  "description": "媒体文件头签名：按文件开头的字节认定图片、音频、视频格式，纯函数无依赖",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "keywords": [
+    "aalis",
+    "aalis-util"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.