@carbonenginejs/runtime-resource 0.8.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/NOTICE +31 -29
- package/README.md +67 -548
- package/dist/CjsMotherLode.js +1271 -1271
- package/dist/CjsResMan.js +3005 -3005
- package/dist/CjsResManQueue.js +214 -214
- package/dist/CjsResource.js +566 -566
- package/dist/CjsResourceSource.js +68 -59
- package/dist/CjsResourceSource.js.map +1 -1
- package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
- package/dist/format/CjsBlueReader.js +269 -269
- package/dist/format/CjsFormat.js +197 -192
- package/dist/format/CjsFormat.js.map +1 -1
- package/dist/format/CjsReader.js +18 -18
- package/dist/format/CjsResourceProbe.js +277 -277
- package/dist/format/payloadContract.js +173 -173
- package/dist/formats/black/CjsBlackFormat.js +278 -278
- package/dist/formats/black/core/CjsBlackBinaryReader.js +157 -153
- package/dist/formats/black/core/CjsBlackBinaryReader.js.map +1 -1
- package/dist/formats/black/core/CjsBlackPropertyReaders.js +387 -382
- package/dist/formats/black/core/CjsBlackPropertyReaders.js.map +1 -1
- package/dist/formats/black/core/CjsBlackReader.js +639 -639
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js +437 -433
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js.map +1 -1
- package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -0
- package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js.map +1 -0
- package/dist/formats/black/core/blackConstants.js +7 -7
- package/dist/formats/black/core/blackDefinitions.js +10 -10
- package/dist/formats/black/core/blackDefinitions.js.map +1 -1
- package/dist/formats/black/core/blackEnums.js +6 -6
- package/dist/formats/black/core/blackSchema.js +3 -3
- package/dist/formats/black/core/blackVersion.js +22 -22
- package/dist/formats/black/core/helpers.js +182 -182
- package/dist/formats/black/core/schema.js +4 -4
- package/dist/formats/black/index.js +2 -2
- package/dist/formats/bnk/CjsBnkFormat.js +125 -125
- package/dist/formats/bnk/core/graph.js +140 -140
- package/dist/formats/bnk/core/helpers.js +409 -409
- package/dist/formats/bnk/core/musicNodes.js +493 -489
- package/dist/formats/bnk/core/musicNodes.js.map +1 -1
- package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
- package/dist/formats/bnk/index.js +2 -2
- package/dist/formats/cmf/CjsCmfFormat.js +497 -497
- package/dist/formats/cmf/core/binary.js +123 -118
- package/dist/formats/cmf/core/binary.js.map +1 -1
- package/dist/formats/cmf/core/buffers.js +233 -233
- package/dist/formats/cmf/core/constants.js +47 -47
- package/dist/formats/cmf/core/gr2Anim.js +453 -453
- package/dist/formats/cmf/core/helpers.js +287 -287
- package/dist/formats/cmf/core/pack.js +276 -276
- package/dist/formats/cmf/core/schema.js +364 -364
- package/dist/formats/cmf/core/shared.js +268 -268
- package/dist/formats/cmf/core/writer.js +517 -517
- package/dist/formats/cmf/index.js +2 -2
- package/dist/formats/dds/CjsDdsFormat.js +200 -193
- package/dist/formats/dds/CjsDdsFormat.js.map +1 -1
- package/dist/formats/dds/core/bc6h.js +288 -288
- package/dist/formats/dds/core/bc7.js +256 -251
- package/dist/formats/dds/core/bc7.js.map +1 -1
- package/dist/formats/dds/core/helpers.js +815 -815
- package/dist/formats/dds/index.js +2 -2
- package/dist/formats/fbx/CjsFbxFormat.js +266 -266
- package/dist/formats/fbx/core/helpers.js +3911 -3901
- package/dist/formats/fbx/core/helpers.js.map +1 -1
- package/dist/formats/fbx/index.js +2 -2
- package/dist/formats/flac/CjsFlacFormat.js +93 -87
- package/dist/formats/flac/CjsFlacFormat.js.map +1 -1
- package/dist/formats/flac/core/helpers.js +295 -295
- package/dist/formats/flac/index.js +2 -2
- package/dist/formats/gif/CjsGifFormat.js +92 -87
- package/dist/formats/gif/CjsGifFormat.js.map +1 -1
- package/dist/formats/gif/core/helpers.js +360 -360
- package/dist/formats/gif/index.js +2 -2
- package/dist/formats/gltf/CjsGltfFormat.js +290 -290
- package/dist/formats/gltf/core/helpers.js +292 -292
- package/dist/formats/gltf/core/json.js +79 -79
- package/dist/formats/gltf/core/parser.js +666 -666
- package/dist/formats/gltf/core/targets.js +163 -163
- package/dist/formats/gltf/index.js +2 -2
- package/dist/formats/gr2/CjsGr2Format.js +46 -0
- package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
- package/dist/formats/gr2/core/bitknit2.js +280 -0
- package/dist/formats/gr2/core/bitknit2.js.map +1 -0
- package/dist/formats/gr2/core/curves.js +1047 -0
- package/dist/formats/gr2/core/curves.js.map +1 -0
- package/dist/formats/gr2/core/gsf.js +72 -0
- package/dist/formats/gr2/core/gsf.js.map +1 -0
- package/dist/formats/gr2/core/helpers.js +332 -0
- package/dist/formats/gr2/core/helpers.js.map +1 -0
- package/dist/formats/gr2/core/json.js +622 -0
- package/dist/formats/gr2/core/json.js.map +1 -0
- package/dist/formats/gr2/core/oodle1.js +388 -0
- package/dist/formats/gr2/core/oodle1.js.map +1 -0
- package/dist/formats/gr2/core/reader.js +617 -0
- package/dist/formats/gr2/core/reader.js.map +1 -0
- package/dist/formats/gr2/core/tangents.js +48 -0
- package/dist/formats/gr2/core/tangents.js.map +1 -0
- package/dist/formats/gr2/core/targets.js +351 -0
- package/dist/formats/gr2/core/targets.js.map +1 -0
- package/dist/formats/gr2/index.js +3 -0
- package/dist/formats/gr2/index.js.map +1 -0
- package/dist/formats/index.js +30 -23
- package/dist/formats/index.js.map +1 -1
- package/dist/formats/jpeg/CjsJpegFormat.js +212 -206
- package/dist/formats/jpeg/CjsJpegFormat.js.map +1 -1
- package/dist/formats/jpeg/core/helpers.js +350 -350
- package/dist/formats/jpeg/core/jpeg.js +387 -377
- package/dist/formats/jpeg/core/jpeg.js.map +1 -1
- package/dist/formats/jpeg/index.js +2 -2
- package/dist/formats/mp3/CjsMp3Format.js +197 -192
- package/dist/formats/mp3/CjsMp3Format.js.map +1 -1
- package/dist/formats/mp3/core/helpers.js +338 -338
- package/dist/formats/mp3/index.js +2 -2
- package/dist/formats/mp4/CjsMp4Format.js +197 -191
- package/dist/formats/mp4/CjsMp4Format.js.map +1 -1
- package/dist/formats/mp4/core/helpers.js +449 -449
- package/dist/formats/mp4/index.js +2 -2
- package/dist/formats/obj/CjsObjFormat.js +253 -253
- package/dist/formats/obj/core/helpers.js +573 -573
- package/dist/formats/obj/core/json.js +64 -64
- package/dist/formats/obj/core/parser.js +321 -321
- package/dist/formats/obj/index.js +2 -2
- package/dist/formats/ogg/CjsOggFormat.js +94 -88
- package/dist/formats/ogg/CjsOggFormat.js.map +1 -1
- package/dist/formats/ogg/core/helpers.js +387 -387
- package/dist/formats/ogg/core/imdct.js +178 -178
- package/dist/formats/ogg/core/vorbis.js +1004 -999
- package/dist/formats/ogg/core/vorbis.js.map +1 -1
- package/dist/formats/ogg/index.js +2 -2
- package/dist/formats/png/CjsPngFormat.js +201 -195
- package/dist/formats/png/CjsPngFormat.js.map +1 -1
- package/dist/formats/png/core/helpers.js +583 -583
- package/dist/formats/png/index.js +2 -2
- package/dist/formats/red/CjsRedFormat.js +261 -261
- package/dist/formats/red/core/CjsRedReader.js +194 -194
- package/dist/formats/red/core/blackDefinitions.js +3 -3
- package/dist/formats/red/core/helpers.js +139 -139
- package/dist/formats/red/core/redGraph.js +68 -68
- package/dist/formats/red/core/schema.js +4 -4
- package/dist/formats/red/index.js +2 -2
- package/dist/formats/stl/CjsStlFormat.js +365 -365
- package/dist/formats/stl/core/helpers.js +261 -261
- package/dist/formats/stl/core/json.js +51 -51
- package/dist/formats/stl/core/stl.js +634 -629
- package/dist/formats/stl/core/stl.js.map +1 -1
- package/dist/formats/stl/core/targets.js +163 -163
- package/dist/formats/stl/index.js +2 -2
- package/dist/formats/tga/CjsTgaFormat.js +197 -192
- package/dist/formats/tga/CjsTgaFormat.js.map +1 -1
- package/dist/formats/tga/core/helpers.js +446 -446
- package/dist/formats/tga/index.js +2 -2
- package/dist/formats/wav/CjsWavFormat.js +198 -192
- package/dist/formats/wav/CjsWavFormat.js.map +1 -1
- package/dist/formats/wav/core/helpers.js +328 -328
- package/dist/formats/wav/index.js +2 -2
- package/dist/formats/webm/CjsWebmFormat.js +197 -191
- package/dist/formats/webm/CjsWebmFormat.js.map +1 -1
- package/dist/formats/webm/core/helpers.js +537 -537
- package/dist/formats/webm/index.js +2 -2
- package/dist/formats/webp/CjsWebpFormat.js +91 -86
- package/dist/formats/webp/CjsWebpFormat.js.map +1 -1
- package/dist/formats/webp/core/helpers.js +214 -214
- package/dist/formats/webp/index.js +2 -2
- package/dist/formats/wem/CjsWemFormat.js +242 -241
- package/dist/formats/wem/CjsWemFormat.js.map +1 -1
- package/dist/formats/wem/core/bitStream.js +259 -259
- package/dist/formats/wem/core/codebookLibrary.js +164 -164
- package/dist/formats/wem/core/helpers.js +417 -417
- package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
- package/dist/formats/wem/core/ptadpcm.js +77 -77
- package/dist/formats/wem/core/resolve.js +121 -121
- package/dist/formats/wem/core/wemToOgg.js +485 -485
- package/dist/formats/wem/index.js +2 -2
- package/dist/formats/yaml/CjsYamlFormat.js +89 -83
- package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
- package/dist/formats/yaml/core/CjsYamlReader.js +311 -305
- package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
- package/dist/formats/yaml/core/helpers.js +160 -160
- package/dist/formats/yaml/index.js +2 -2
- package/dist/index.js +49 -48
- package/dist/index.js.map +1 -1
- package/dist/resourcePath.js +18 -18
- package/dist/resourceStates.js +9 -9
- package/dist/resources/AudioGeometryResData.js +47 -47
- package/dist/resources/GStateBindingCallbackData.js +31 -31
- package/dist/resources/MeshDecalData.js +37 -37
- package/dist/resources/MeshDecalLodData.js +34 -34
- package/dist/resources/Tr2EffectRes.js +71 -71
- package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
- package/dist/resources/Tr2GrannyStateRes.js +44 -44
- package/dist/resources/Tr2ImageRes.js +114 -114
- package/dist/resources/Tr2LightProfileRes.js +40 -40
- package/dist/resources/Tr2MaterialArea.js +34 -34
- package/dist/resources/Tr2MaterialMesh.js +31 -31
- package/dist/resources/Tr2MaterialRes.js +34 -34
- package/dist/resources/Tr2ShaderPermutation.js +43 -43
- package/dist/resources/Tr2TextureLodManager.js +80 -80
- package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
- package/dist/resources/Tr2TexturePackChannel.js +37 -37
- package/dist/resources/Tr2TexturePipeline.js +52 -52
- package/dist/resources/Tr2TexturePipelineParams.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
- package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
- package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
- package/dist/resources/TriGeometryRes.js +239 -239
- package/dist/resources/TriGeometryResAreaData.js +59 -59
- package/dist/resources/TriGeometryResJointData.js +38 -38
- package/dist/resources/TriGeometryResLodData.js +88 -88
- package/dist/resources/TriGeometryResMeshData.js +63 -63
- package/dist/resources/TriGeometryResSkeletonData.js +34 -34
- package/dist/resources/TriGrannyRes.js +43 -43
- package/dist/resources/TriJointBinding.js +38 -38
- package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
- package/dist/resources/TriRtGeometryConstants.js +88 -88
- package/dist/resources/TriTextureRes.js +304 -304
- package/dist/resources/enums.js +18 -18
- package/dist/resources/resourceBoundary.js +47 -47
- package/dist/resources/texturePipelineBehavior.js +308 -308
- package/dist/texture/CjsTextureArrayRes.js +406 -406
- package/dist/texture/CjsTextureParameterProxy.js +133 -133
- package/docs/README.md +73 -0
- package/docs/architecture.md +86 -0
- package/docs/concepts/resource-lifecycle.md +217 -0
- package/docs/formats/README.md +105 -0
- package/docs/formats/gr2.md +161 -0
- package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
- package/docs/formats/stl.md +37 -0
- package/docs/formats/wwise.md +44 -0
- package/docs/reference/classes/README.md +33 -0
- package/docs/reference/classes/core.md +106 -0
- package/docs/reference/classes/dropped.md +46 -0
- package/docs/reference/classes/formats.md +522 -0
- package/docs/reference/classes/resources.md +346 -0
- package/docs/reference/classes/texture.md +26 -0
- package/docs/reference/events.md +92 -0
- package/docs/reference/motherlode-cache.md +244 -0
- package/docs/reference/queues.md +102 -0
- package/docs/reference/reload.md +107 -0
- package/docs/reference/texture-arrays.md +113 -0
- package/docs/reference/texture-pipeline.md +53 -0
- package/docs/roadmap.md +104 -0
- package/format-notices/black/LICENSE +21 -21
- package/format-notices/black/NOTICE +47 -47
- package/format-notices/bnk/LICENSE +21 -21
- package/format-notices/bnk/NOTICE +20 -20
- package/format-notices/cmf/LICENSE +21 -21
- package/format-notices/cmf/NOTICE +36 -36
- package/format-notices/dds/LICENSE +21 -21
- package/format-notices/dds/NOTICE +14 -14
- package/format-notices/fbx/LICENSE +21 -21
- package/format-notices/fbx/NOTICE +14 -14
- package/format-notices/flac/LICENSE +21 -21
- package/format-notices/flac/NOTICE +14 -14
- package/format-notices/gif/LICENSE +21 -21
- package/format-notices/gif/NOTICE +14 -14
- package/format-notices/gltf/LICENSE +21 -21
- package/format-notices/gltf/NOTICE +27 -27
- package/format-notices/gr2/LICENSE +21 -0
- package/format-notices/gr2/NOTICE +60 -0
- package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
- package/format-notices/jpeg/LICENSE +21 -21
- package/format-notices/jpeg/NOTICE +14 -14
- package/format-notices/mp3/LICENSE +21 -21
- package/format-notices/mp3/NOTICE +14 -14
- package/format-notices/mp4/LICENSE +21 -21
- package/format-notices/mp4/NOTICE +14 -14
- package/format-notices/obj/LICENSE +21 -21
- package/format-notices/obj/NOTICE +26 -26
- package/format-notices/ogg/LICENSE +21 -21
- package/format-notices/ogg/NOTICE +28 -28
- package/format-notices/png/LICENSE +21 -21
- package/format-notices/png/NOTICE +14 -14
- package/format-notices/red/LICENSE +21 -21
- package/format-notices/red/NOTICE +31 -31
- package/format-notices/stl/LICENSE +21 -21
- package/format-notices/stl/NOTICE +21 -21
- package/format-notices/tga/LICENSE +21 -21
- package/format-notices/tga/NOTICE +14 -14
- package/format-notices/wav/LICENSE +21 -21
- package/format-notices/wav/NOTICE +14 -14
- package/format-notices/webm/LICENSE +21 -21
- package/format-notices/webm/NOTICE +14 -14
- package/format-notices/webp/LICENSE +21 -21
- package/format-notices/webp/NOTICE +14 -14
- package/format-notices/wem/LICENSE +57 -57
- package/format-notices/wem/NOTICE +33 -33
- package/format-notices/yaml/LICENSE +21 -21
- package/format-notices/yaml/NOTICE +44 -44
- package/package.json +52 -51
- package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +0 -4
- package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js.map +0 -1
- package/resource-lifecycle.md +0 -679
|
@@ -1,338 +1,338 @@
|
|
|
1
|
-
const OUTPUT_AUDIO = "audio";
|
|
2
|
-
const OUTPUT_PCM = "pcm";
|
|
3
|
-
const OUTPUT_RAW = "raw";
|
|
4
|
-
const OUTPUT_JSON = "json";
|
|
5
|
-
const DEFAULT_VALUES = Object.freeze({
|
|
6
|
-
emit: OUTPUT_RAW,
|
|
7
|
-
inputType: "",
|
|
8
|
-
source: ""
|
|
9
|
-
});
|
|
10
|
-
const DEBUG_OUTPUTS = Object.freeze({
|
|
11
|
-
wav: "wavJson",
|
|
12
|
-
mp3: "mp3Json"
|
|
13
|
-
});
|
|
14
|
-
function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsAudioFormat") {
|
|
15
|
-
const values = {
|
|
16
|
-
...DEFAULT_VALUES,
|
|
17
|
-
...(base || {}),
|
|
18
|
-
...(options || {})
|
|
19
|
-
};
|
|
20
|
-
values.inputType = normalizeInputType(values.inputType);
|
|
21
|
-
values.emit = normalizeEmit(values.emit, values.inputType, readerName);
|
|
22
|
-
return values;
|
|
23
|
-
}
|
|
24
|
-
function normalizeInputType(inputType) {
|
|
25
|
-
return inputType ? String(inputType).replace(/^\./u, "").toLowerCase() : "";
|
|
26
|
-
}
|
|
27
|
-
function normalizeEmit(emit, inputType, readerName) {
|
|
28
|
-
if (emit === undefined || emit === null) return OUTPUT_RAW;
|
|
29
|
-
if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
|
|
30
|
-
if ([OUTPUT_AUDIO, OUTPUT_PCM, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
|
|
31
|
-
if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
|
|
32
|
-
throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
|
|
33
|
-
}
|
|
34
|
-
function toBytes(input) {
|
|
35
|
-
if (input instanceof Uint8Array) return input;
|
|
36
|
-
if (input instanceof ArrayBuffer) return new Uint8Array(input);
|
|
37
|
-
if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
|
|
38
|
-
throw new TypeError("Audio input must be Uint8Array, ArrayBuffer, or DataView");
|
|
39
|
-
}
|
|
40
|
-
function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
|
|
41
|
-
const bytes = toBytes(input);
|
|
42
|
-
const metadata = inspectBytes(bytes);
|
|
43
|
-
if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
|
|
44
|
-
throw new TypeError(`CjsAudioFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
|
|
45
|
-
}
|
|
46
|
-
return {
|
|
47
|
-
payloadType: "audio",
|
|
48
|
-
mediaTypes: ["audio"],
|
|
49
|
-
byteLength: bytes.byteLength,
|
|
50
|
-
sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
|
|
51
|
-
...metadata
|
|
52
|
-
};
|
|
53
|
-
}
|
|
54
|
-
function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
|
|
55
|
-
try {
|
|
56
|
-
const metadata = inspectWithValues(input, values, expectedType);
|
|
57
|
-
const mimeType = getAudioMimeType(metadata);
|
|
58
|
-
const variants = [{
|
|
59
|
-
kind: "raw",
|
|
60
|
-
payloadType: "raw",
|
|
61
|
-
codec: metadata.audioFormat || metadata.sourceFormat,
|
|
62
|
-
mimeType,
|
|
63
|
-
supported: true,
|
|
64
|
-
containerOnly: true,
|
|
65
|
-
isDecoded: false,
|
|
66
|
-
pcmDecodeSupported: false
|
|
67
|
-
}, {
|
|
68
|
-
kind: "pcm",
|
|
69
|
-
payloadType: "pcm",
|
|
70
|
-
codec: "pcm",
|
|
71
|
-
supported: false,
|
|
72
|
-
reason: "MP3 PCM decode/output is not implemented yet."
|
|
73
|
-
}];
|
|
74
|
-
return {
|
|
75
|
-
format: metadata.sourceFormat,
|
|
76
|
-
source: values.source || "buffer",
|
|
77
|
-
supported: metadata.sourceFormat ? "partial" : "none",
|
|
78
|
-
confidence: metadata.sourceFormat ? 1 : 0,
|
|
79
|
-
preferred: variants.find(variant => variant.supported)?.codec || "",
|
|
80
|
-
reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized audio format.",
|
|
81
|
-
metadata,
|
|
82
|
-
variants,
|
|
83
|
-
warnings: [],
|
|
84
|
-
errors: []
|
|
85
|
-
};
|
|
86
|
-
} catch (error) {
|
|
87
|
-
return {
|
|
88
|
-
format: expectedType || values.inputType || "",
|
|
89
|
-
source: values.source || "buffer",
|
|
90
|
-
supported: "none",
|
|
91
|
-
confidence: 0,
|
|
92
|
-
preferred: "",
|
|
93
|
-
reason: error.message,
|
|
94
|
-
metadata: null,
|
|
95
|
-
variants: [],
|
|
96
|
-
warnings: [],
|
|
97
|
-
errors: [error.message]
|
|
98
|
-
};
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
|
|
102
|
-
const bytes = toBytes(input);
|
|
103
|
-
const metadata = inspectWithValues(bytes, values, expectedType);
|
|
104
|
-
if (values.emit === OUTPUT_RAW) {
|
|
105
|
-
return {
|
|
106
|
-
payloadType: "raw",
|
|
107
|
-
sourceFormat: metadata.sourceFormat,
|
|
108
|
-
mimeType: getAudioMimeType(metadata),
|
|
109
|
-
containerOnly: true,
|
|
110
|
-
isDecoded: false,
|
|
111
|
-
pcmDecodeSupported: false,
|
|
112
|
-
metadata,
|
|
113
|
-
bytes
|
|
114
|
-
};
|
|
115
|
-
}
|
|
116
|
-
if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
|
|
117
|
-
const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
|
|
118
|
-
error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
|
|
119
|
-
error.sourceFormat = metadata.sourceFormat;
|
|
120
|
-
error.emit = values.emit;
|
|
121
|
-
throw error;
|
|
122
|
-
}
|
|
123
|
-
function getAudioMimeType(metadata) {
|
|
124
|
-
if (metadata.sourceFormat === "wav") return "audio/wav";
|
|
125
|
-
return "audio/mpeg";
|
|
126
|
-
}
|
|
127
|
-
function toJsonValue(value) {
|
|
128
|
-
if (value instanceof Uint8Array) return {
|
|
129
|
-
byteLength: value.byteLength
|
|
130
|
-
};
|
|
131
|
-
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
132
|
-
if (value && typeof value === "object") {
|
|
133
|
-
const output = {};
|
|
134
|
-
for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
|
|
135
|
-
return output;
|
|
136
|
-
}
|
|
137
|
-
return value;
|
|
138
|
-
}
|
|
139
|
-
function inspectBytes(bytes) {
|
|
140
|
-
if (isWAV(bytes)) return inspectWAV(bytes);
|
|
141
|
-
if (isMP3(bytes)) return inspectMP3(bytes);
|
|
142
|
-
return {
|
|
143
|
-
sourceFormat: "",
|
|
144
|
-
audioFormat: ""
|
|
145
|
-
};
|
|
146
|
-
}
|
|
147
|
-
function isWAV(bytes) {
|
|
148
|
-
return bytes.byteLength >= 12 && fourCc(bytes, 0) === "RIFF" && fourCc(bytes, 8) === "WAVE";
|
|
149
|
-
}
|
|
150
|
-
function isMP3(bytes) {
|
|
151
|
-
return bytes.byteLength >= 3 && (fourCc(bytes, 0, 3) === "ID3" || bytes[0] === 0xff && (bytes[1] & 0xe0) === 0xe0);
|
|
152
|
-
}
|
|
153
|
-
function inspectWAV(bytes) {
|
|
154
|
-
let offset = 12;
|
|
155
|
-
const info = {
|
|
156
|
-
sourceFormat: "wav",
|
|
157
|
-
audioFormat: "wav",
|
|
158
|
-
sampleRate: 0,
|
|
159
|
-
channels: 0,
|
|
160
|
-
bitsPerSample: 0,
|
|
161
|
-
dataBytes: 0
|
|
162
|
-
};
|
|
163
|
-
while (offset + 8 <= bytes.byteLength) {
|
|
164
|
-
const id = fourCc(bytes, offset),
|
|
165
|
-
size = readU32LE(bytes, offset + 4),
|
|
166
|
-
dataOffset = offset + 8;
|
|
167
|
-
if (id === "fmt " && dataOffset + 16 <= bytes.byteLength) {
|
|
168
|
-
info.formatTag = readU16LE(bytes, dataOffset);
|
|
169
|
-
info.channels = readU16LE(bytes, dataOffset + 2);
|
|
170
|
-
info.sampleRate = readU32LE(bytes, dataOffset + 4);
|
|
171
|
-
info.bitsPerSample = readU16LE(bytes, dataOffset + 14);
|
|
172
|
-
}
|
|
173
|
-
if (id === "data") info.dataBytes = size;
|
|
174
|
-
offset = dataOffset + size + (size & 1);
|
|
175
|
-
}
|
|
176
|
-
return info;
|
|
177
|
-
}
|
|
178
|
-
function inspectMP3(bytes) {
|
|
179
|
-
const frame = readMp3FrameHeader(bytes, findMp3FrameOffset(bytes));
|
|
180
|
-
const id3 = readId3Header(bytes);
|
|
181
|
-
const info = {
|
|
182
|
-
sourceFormat: "mp3",
|
|
183
|
-
audioFormat: "mp3",
|
|
184
|
-
hasId3: !!id3,
|
|
185
|
-
id3Version: id3?.version || 0,
|
|
186
|
-
id3Revision: id3?.revision || 0,
|
|
187
|
-
id3Flags: id3?.flags || 0,
|
|
188
|
-
id3Size: id3?.size || 0,
|
|
189
|
-
firstFrameOffset: frame?.offset || 0,
|
|
190
|
-
version: frame?.version || "",
|
|
191
|
-
layer: frame?.layer || "",
|
|
192
|
-
bitrateKbps: frame?.bitrateKbps || 0,
|
|
193
|
-
sampleRate: frame?.sampleRate || 0,
|
|
194
|
-
channels: frame?.channels || 0,
|
|
195
|
-
samplesPerFrame: frame?.samplesPerFrame || 0,
|
|
196
|
-
frameLength: frame?.frameLength || 0,
|
|
197
|
-
frameCount: 0,
|
|
198
|
-
durationSeconds: 0,
|
|
199
|
-
declaredFrameCount: 0,
|
|
200
|
-
declaredByteCount: 0,
|
|
201
|
-
vbrHeader: "",
|
|
202
|
-
encoderDelay: 0,
|
|
203
|
-
encoderPadding: 0
|
|
204
|
-
};
|
|
205
|
-
if (frame) {
|
|
206
|
-
const vbr = readVbrHeader(bytes, frame);
|
|
207
|
-
if (vbr) {
|
|
208
|
-
info.declaredFrameCount = vbr.frameCount;
|
|
209
|
-
info.declaredByteCount = vbr.byteCount;
|
|
210
|
-
info.vbrHeader = vbr.kind;
|
|
211
|
-
info.encoderDelay = vbr.encoderDelay;
|
|
212
|
-
info.encoderPadding = vbr.encoderPadding;
|
|
213
|
-
}
|
|
214
|
-
let offset = frame.offset;
|
|
215
|
-
while (offset + 4 <= bytes.byteLength && info.frameCount < 1000000) {
|
|
216
|
-
const next = readMp3FrameHeader(bytes, offset);
|
|
217
|
-
if (!next || next.frameLength <= 0) break;
|
|
218
|
-
info.frameCount++;
|
|
219
|
-
offset += next.frameLength;
|
|
220
|
-
}
|
|
221
|
-
const frameCount = info.declaredFrameCount || info.frameCount;
|
|
222
|
-
const trimmedSamples = Math.max(0, frameCount * info.samplesPerFrame - info.encoderDelay - info.encoderPadding);
|
|
223
|
-
info.durationSeconds = info.sampleRate ? trimmedSamples / info.sampleRate : 0;
|
|
224
|
-
}
|
|
225
|
-
return info;
|
|
226
|
-
}
|
|
227
|
-
function readId3Header(bytes) {
|
|
228
|
-
if (bytes.byteLength < 10 || fourCc(bytes, 0, 3) !== "ID3") return null;
|
|
229
|
-
return {
|
|
230
|
-
version: bytes[3],
|
|
231
|
-
revision: bytes[4],
|
|
232
|
-
flags: bytes[5],
|
|
233
|
-
size: bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9]
|
|
234
|
-
};
|
|
235
|
-
}
|
|
236
|
-
function readVbrHeader(bytes, frame) {
|
|
237
|
-
const sideInfoLength = frame.version === "mpeg1" ? frame.channels === 1 ? 17 : 32 : frame.channels === 1 ? 9 : 17;
|
|
238
|
-
const xingOffset = frame.offset + 4 + sideInfoLength;
|
|
239
|
-
for (const kind of ["Xing", "Info"]) {
|
|
240
|
-
if (fourCc(bytes, xingOffset, 4) !== kind) continue;
|
|
241
|
-
const flags = readU32BE(bytes, xingOffset + 4);
|
|
242
|
-
const frameCount = (flags & 1) !== 0 ? readU32BE(bytes, xingOffset + 8) : 0;
|
|
243
|
-
const byteCount = (flags & 2) !== 0 ? readU32BE(bytes, xingOffset + 12) : 0;
|
|
244
|
-
const gapless = readLameGapless(bytes, xingOffset + 8 + ((flags & 1) !== 0 ? 4 : 0) + ((flags & 2) !== 0 ? 4 : 0) + ((flags & 4) !== 0 ? 100 : 0));
|
|
245
|
-
return {
|
|
246
|
-
kind,
|
|
247
|
-
frameCount,
|
|
248
|
-
byteCount,
|
|
249
|
-
...gapless
|
|
250
|
-
};
|
|
251
|
-
}
|
|
252
|
-
const vbriOffset = frame.offset + 36;
|
|
253
|
-
if (fourCc(bytes, vbriOffset, 4) === "VBRI") {
|
|
254
|
-
return {
|
|
255
|
-
kind: "VBRI",
|
|
256
|
-
frameCount: readU32BE(bytes, vbriOffset + 14),
|
|
257
|
-
byteCount: readU32BE(bytes, vbriOffset + 10),
|
|
258
|
-
encoderDelay: 0,
|
|
259
|
-
encoderPadding: 0
|
|
260
|
-
};
|
|
261
|
-
}
|
|
262
|
-
return null;
|
|
263
|
-
}
|
|
264
|
-
function readLameGapless(bytes, searchStart) {
|
|
265
|
-
const end = Math.min(bytes.byteLength - 3, searchStart + 160);
|
|
266
|
-
for (let offset = searchStart; offset < end; offset++) {
|
|
267
|
-
if (fourCc(bytes, offset, 4) !== "LAME") continue;
|
|
268
|
-
const value = bytes[offset + 0x15] << 16 | bytes[offset + 0x16] << 8 | bytes[offset + 0x17];
|
|
269
|
-
return {
|
|
270
|
-
encoderDelay: value >>> 12 & 0xfff,
|
|
271
|
-
encoderPadding: value & 0xfff
|
|
272
|
-
};
|
|
273
|
-
}
|
|
274
|
-
return {
|
|
275
|
-
encoderDelay: 0,
|
|
276
|
-
encoderPadding: 0
|
|
277
|
-
};
|
|
278
|
-
}
|
|
279
|
-
function findMp3FrameOffset(bytes) {
|
|
280
|
-
let offset = 0;
|
|
281
|
-
if (fourCc(bytes, 0, 3) === "ID3" && bytes.byteLength >= 10) {
|
|
282
|
-
const size = bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9];
|
|
283
|
-
offset = 10 + size + (bytes[5] & 0x10 ? 10 : 0);
|
|
284
|
-
}
|
|
285
|
-
for (; offset + 4 <= bytes.byteLength; offset++) {
|
|
286
|
-
if (readMp3FrameHeader(bytes, offset)) return offset;
|
|
287
|
-
}
|
|
288
|
-
return -1;
|
|
289
|
-
}
|
|
290
|
-
function readMp3FrameHeader(bytes, offset) {
|
|
291
|
-
if (offset < 0 || offset + 4 > bytes.byteLength) return null;
|
|
292
|
-
const header = (bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
|
|
293
|
-
if ((header & 0xffe00000) >>> 0 !== 0xffe00000) return null;
|
|
294
|
-
const versionBits = header >>> 19 & 3;
|
|
295
|
-
const layerBits = header >>> 17 & 3;
|
|
296
|
-
const bitrateIndex = header >>> 12 & 0xf;
|
|
297
|
-
const sampleRateIndex = header >>> 10 & 3;
|
|
298
|
-
const padding = header >>> 9 & 1;
|
|
299
|
-
const channelMode = header >>> 6 & 3;
|
|
300
|
-
if (versionBits === 1 || layerBits !== 1 || bitrateIndex === 0 || bitrateIndex === 15 || sampleRateIndex === 3) {
|
|
301
|
-
return null;
|
|
302
|
-
}
|
|
303
|
-
const version = versionBits === 3 ? "mpeg1" : versionBits === 2 ? "mpeg2" : "mpeg2.5";
|
|
304
|
-
const bitrateTable = version === "mpeg1" ? [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320] : [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160];
|
|
305
|
-
const sampleRateTable = version === "mpeg1" ? [44100, 48000, 32000] : version === "mpeg2" ? [22050, 24000, 16000] : [11025, 12000, 8000];
|
|
306
|
-
const bitrateKbps = bitrateTable[bitrateIndex];
|
|
307
|
-
const sampleRate = sampleRateTable[sampleRateIndex];
|
|
308
|
-
const samplesPerFrame = version === "mpeg1" ? 1152 : 576;
|
|
309
|
-
const frameLength = Math.floor((version === "mpeg1" ? 144000 : 72000) * bitrateKbps / sampleRate) + padding;
|
|
310
|
-
if (offset + frameLength > bytes.byteLength) return null;
|
|
311
|
-
return {
|
|
312
|
-
offset,
|
|
313
|
-
version,
|
|
314
|
-
layer: "layer3",
|
|
315
|
-
bitrateKbps,
|
|
316
|
-
sampleRate,
|
|
317
|
-
channels: channelMode === 3 ? 1 : 2,
|
|
318
|
-
samplesPerFrame,
|
|
319
|
-
frameLength
|
|
320
|
-
};
|
|
321
|
-
}
|
|
322
|
-
function fourCc(bytes, offset, length = 4) {
|
|
323
|
-
let value = "";
|
|
324
|
-
for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);
|
|
325
|
-
return value;
|
|
326
|
-
}
|
|
327
|
-
function readU16LE(bytes, offset) {
|
|
328
|
-
return bytes[offset] | bytes[offset + 1] << 8;
|
|
329
|
-
}
|
|
330
|
-
function readU32LE(bytes, offset) {
|
|
331
|
-
return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] * 0x1000000) >>> 0;
|
|
332
|
-
}
|
|
333
|
-
function readU32BE(bytes, offset) {
|
|
334
|
-
return bytes[offset] * 0x1000000 + (bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
|
|
335
|
-
}
|
|
336
|
-
|
|
337
|
-
export { DEFAULT_VALUES, OUTPUT_AUDIO, OUTPUT_JSON, OUTPUT_PCM, OUTPUT_RAW, inspectBytes, inspectWithValues, isMP3, isSupportedWithValues, isWAV, normalizeEmit, normalizeInputType, normalizeValues, readWithValues, toBytes, toJsonValue };
|
|
338
|
-
//# sourceMappingURL=helpers.js.map
|
|
1
|
+
const OUTPUT_AUDIO = "audio";
|
|
2
|
+
const OUTPUT_PCM = "pcm";
|
|
3
|
+
const OUTPUT_RAW = "raw";
|
|
4
|
+
const OUTPUT_JSON = "json";
|
|
5
|
+
const DEFAULT_VALUES = Object.freeze({
|
|
6
|
+
emit: OUTPUT_RAW,
|
|
7
|
+
inputType: "",
|
|
8
|
+
source: ""
|
|
9
|
+
});
|
|
10
|
+
const DEBUG_OUTPUTS = Object.freeze({
|
|
11
|
+
wav: "wavJson",
|
|
12
|
+
mp3: "mp3Json"
|
|
13
|
+
});
|
|
14
|
+
function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsAudioFormat") {
|
|
15
|
+
const values = {
|
|
16
|
+
...DEFAULT_VALUES,
|
|
17
|
+
...(base || {}),
|
|
18
|
+
...(options || {})
|
|
19
|
+
};
|
|
20
|
+
values.inputType = normalizeInputType(values.inputType);
|
|
21
|
+
values.emit = normalizeEmit(values.emit, values.inputType, readerName);
|
|
22
|
+
return values;
|
|
23
|
+
}
|
|
24
|
+
function normalizeInputType(inputType) {
|
|
25
|
+
return inputType ? String(inputType).replace(/^\./u, "").toLowerCase() : "";
|
|
26
|
+
}
|
|
27
|
+
function normalizeEmit(emit, inputType, readerName) {
|
|
28
|
+
if (emit === undefined || emit === null) return OUTPUT_RAW;
|
|
29
|
+
if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
|
|
30
|
+
if ([OUTPUT_AUDIO, OUTPUT_PCM, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
|
|
31
|
+
if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
|
|
32
|
+
throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
|
|
33
|
+
}
|
|
34
|
+
function toBytes(input) {
|
|
35
|
+
if (input instanceof Uint8Array) return input;
|
|
36
|
+
if (input instanceof ArrayBuffer) return new Uint8Array(input);
|
|
37
|
+
if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
|
|
38
|
+
throw new TypeError("Audio input must be Uint8Array, ArrayBuffer, or DataView");
|
|
39
|
+
}
|
|
40
|
+
function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
|
|
41
|
+
const bytes = toBytes(input);
|
|
42
|
+
const metadata = inspectBytes(bytes);
|
|
43
|
+
if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
|
|
44
|
+
throw new TypeError(`CjsAudioFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
|
|
45
|
+
}
|
|
46
|
+
return {
|
|
47
|
+
payloadType: "audio",
|
|
48
|
+
mediaTypes: ["audio"],
|
|
49
|
+
byteLength: bytes.byteLength,
|
|
50
|
+
sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
|
|
51
|
+
...metadata
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
|
|
55
|
+
try {
|
|
56
|
+
const metadata = inspectWithValues(input, values, expectedType);
|
|
57
|
+
const mimeType = getAudioMimeType(metadata);
|
|
58
|
+
const variants = [{
|
|
59
|
+
kind: "raw",
|
|
60
|
+
payloadType: "raw",
|
|
61
|
+
codec: metadata.audioFormat || metadata.sourceFormat,
|
|
62
|
+
mimeType,
|
|
63
|
+
supported: true,
|
|
64
|
+
containerOnly: true,
|
|
65
|
+
isDecoded: false,
|
|
66
|
+
pcmDecodeSupported: false
|
|
67
|
+
}, {
|
|
68
|
+
kind: "pcm",
|
|
69
|
+
payloadType: "pcm",
|
|
70
|
+
codec: "pcm",
|
|
71
|
+
supported: false,
|
|
72
|
+
reason: "MP3 PCM decode/output is not implemented yet."
|
|
73
|
+
}];
|
|
74
|
+
return {
|
|
75
|
+
format: metadata.sourceFormat,
|
|
76
|
+
source: values.source || "buffer",
|
|
77
|
+
supported: metadata.sourceFormat ? "partial" : "none",
|
|
78
|
+
confidence: metadata.sourceFormat ? 1 : 0,
|
|
79
|
+
preferred: variants.find(variant => variant.supported)?.codec || "",
|
|
80
|
+
reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized audio format.",
|
|
81
|
+
metadata,
|
|
82
|
+
variants,
|
|
83
|
+
warnings: [],
|
|
84
|
+
errors: []
|
|
85
|
+
};
|
|
86
|
+
} catch (error) {
|
|
87
|
+
return {
|
|
88
|
+
format: expectedType || values.inputType || "",
|
|
89
|
+
source: values.source || "buffer",
|
|
90
|
+
supported: "none",
|
|
91
|
+
confidence: 0,
|
|
92
|
+
preferred: "",
|
|
93
|
+
reason: error.message,
|
|
94
|
+
metadata: null,
|
|
95
|
+
variants: [],
|
|
96
|
+
warnings: [],
|
|
97
|
+
errors: [error.message]
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
|
|
102
|
+
const bytes = toBytes(input);
|
|
103
|
+
const metadata = inspectWithValues(bytes, values, expectedType);
|
|
104
|
+
if (values.emit === OUTPUT_RAW) {
|
|
105
|
+
return {
|
|
106
|
+
payloadType: "raw",
|
|
107
|
+
sourceFormat: metadata.sourceFormat,
|
|
108
|
+
mimeType: getAudioMimeType(metadata),
|
|
109
|
+
containerOnly: true,
|
|
110
|
+
isDecoded: false,
|
|
111
|
+
pcmDecodeSupported: false,
|
|
112
|
+
metadata,
|
|
113
|
+
bytes
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
|
|
117
|
+
const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
|
|
118
|
+
error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
|
|
119
|
+
error.sourceFormat = metadata.sourceFormat;
|
|
120
|
+
error.emit = values.emit;
|
|
121
|
+
throw error;
|
|
122
|
+
}
|
|
123
|
+
function getAudioMimeType(metadata) {
|
|
124
|
+
if (metadata.sourceFormat === "wav") return "audio/wav";
|
|
125
|
+
return "audio/mpeg";
|
|
126
|
+
}
|
|
127
|
+
function toJsonValue(value) {
|
|
128
|
+
if (value instanceof Uint8Array) return {
|
|
129
|
+
byteLength: value.byteLength
|
|
130
|
+
};
|
|
131
|
+
if (Array.isArray(value)) return value.map(toJsonValue);
|
|
132
|
+
if (value && typeof value === "object") {
|
|
133
|
+
const output = {};
|
|
134
|
+
for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
|
|
135
|
+
return output;
|
|
136
|
+
}
|
|
137
|
+
return value;
|
|
138
|
+
}
|
|
139
|
+
function inspectBytes(bytes) {
|
|
140
|
+
if (isWAV(bytes)) return inspectWAV(bytes);
|
|
141
|
+
if (isMP3(bytes)) return inspectMP3(bytes);
|
|
142
|
+
return {
|
|
143
|
+
sourceFormat: "",
|
|
144
|
+
audioFormat: ""
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
function isWAV(bytes) {
|
|
148
|
+
return bytes.byteLength >= 12 && fourCc(bytes, 0) === "RIFF" && fourCc(bytes, 8) === "WAVE";
|
|
149
|
+
}
|
|
150
|
+
function isMP3(bytes) {
|
|
151
|
+
return bytes.byteLength >= 3 && (fourCc(bytes, 0, 3) === "ID3" || bytes[0] === 0xff && (bytes[1] & 0xe0) === 0xe0);
|
|
152
|
+
}
|
|
153
|
+
function inspectWAV(bytes) {
|
|
154
|
+
let offset = 12;
|
|
155
|
+
const info = {
|
|
156
|
+
sourceFormat: "wav",
|
|
157
|
+
audioFormat: "wav",
|
|
158
|
+
sampleRate: 0,
|
|
159
|
+
channels: 0,
|
|
160
|
+
bitsPerSample: 0,
|
|
161
|
+
dataBytes: 0
|
|
162
|
+
};
|
|
163
|
+
while (offset + 8 <= bytes.byteLength) {
|
|
164
|
+
const id = fourCc(bytes, offset),
|
|
165
|
+
size = readU32LE(bytes, offset + 4),
|
|
166
|
+
dataOffset = offset + 8;
|
|
167
|
+
if (id === "fmt " && dataOffset + 16 <= bytes.byteLength) {
|
|
168
|
+
info.formatTag = readU16LE(bytes, dataOffset);
|
|
169
|
+
info.channels = readU16LE(bytes, dataOffset + 2);
|
|
170
|
+
info.sampleRate = readU32LE(bytes, dataOffset + 4);
|
|
171
|
+
info.bitsPerSample = readU16LE(bytes, dataOffset + 14);
|
|
172
|
+
}
|
|
173
|
+
if (id === "data") info.dataBytes = size;
|
|
174
|
+
offset = dataOffset + size + (size & 1);
|
|
175
|
+
}
|
|
176
|
+
return info;
|
|
177
|
+
}
|
|
178
|
+
function inspectMP3(bytes) {
|
|
179
|
+
const frame = readMp3FrameHeader(bytes, findMp3FrameOffset(bytes));
|
|
180
|
+
const id3 = readId3Header(bytes);
|
|
181
|
+
const info = {
|
|
182
|
+
sourceFormat: "mp3",
|
|
183
|
+
audioFormat: "mp3",
|
|
184
|
+
hasId3: !!id3,
|
|
185
|
+
id3Version: id3?.version || 0,
|
|
186
|
+
id3Revision: id3?.revision || 0,
|
|
187
|
+
id3Flags: id3?.flags || 0,
|
|
188
|
+
id3Size: id3?.size || 0,
|
|
189
|
+
firstFrameOffset: frame?.offset || 0,
|
|
190
|
+
version: frame?.version || "",
|
|
191
|
+
layer: frame?.layer || "",
|
|
192
|
+
bitrateKbps: frame?.bitrateKbps || 0,
|
|
193
|
+
sampleRate: frame?.sampleRate || 0,
|
|
194
|
+
channels: frame?.channels || 0,
|
|
195
|
+
samplesPerFrame: frame?.samplesPerFrame || 0,
|
|
196
|
+
frameLength: frame?.frameLength || 0,
|
|
197
|
+
frameCount: 0,
|
|
198
|
+
durationSeconds: 0,
|
|
199
|
+
declaredFrameCount: 0,
|
|
200
|
+
declaredByteCount: 0,
|
|
201
|
+
vbrHeader: "",
|
|
202
|
+
encoderDelay: 0,
|
|
203
|
+
encoderPadding: 0
|
|
204
|
+
};
|
|
205
|
+
if (frame) {
|
|
206
|
+
const vbr = readVbrHeader(bytes, frame);
|
|
207
|
+
if (vbr) {
|
|
208
|
+
info.declaredFrameCount = vbr.frameCount;
|
|
209
|
+
info.declaredByteCount = vbr.byteCount;
|
|
210
|
+
info.vbrHeader = vbr.kind;
|
|
211
|
+
info.encoderDelay = vbr.encoderDelay;
|
|
212
|
+
info.encoderPadding = vbr.encoderPadding;
|
|
213
|
+
}
|
|
214
|
+
let offset = frame.offset;
|
|
215
|
+
while (offset + 4 <= bytes.byteLength && info.frameCount < 1000000) {
|
|
216
|
+
const next = readMp3FrameHeader(bytes, offset);
|
|
217
|
+
if (!next || next.frameLength <= 0) break;
|
|
218
|
+
info.frameCount++;
|
|
219
|
+
offset += next.frameLength;
|
|
220
|
+
}
|
|
221
|
+
const frameCount = info.declaredFrameCount || info.frameCount;
|
|
222
|
+
const trimmedSamples = Math.max(0, frameCount * info.samplesPerFrame - info.encoderDelay - info.encoderPadding);
|
|
223
|
+
info.durationSeconds = info.sampleRate ? trimmedSamples / info.sampleRate : 0;
|
|
224
|
+
}
|
|
225
|
+
return info;
|
|
226
|
+
}
|
|
227
|
+
function readId3Header(bytes) {
|
|
228
|
+
if (bytes.byteLength < 10 || fourCc(bytes, 0, 3) !== "ID3") return null;
|
|
229
|
+
return {
|
|
230
|
+
version: bytes[3],
|
|
231
|
+
revision: bytes[4],
|
|
232
|
+
flags: bytes[5],
|
|
233
|
+
size: bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9]
|
|
234
|
+
};
|
|
235
|
+
}
|
|
236
|
+
function readVbrHeader(bytes, frame) {
|
|
237
|
+
const sideInfoLength = frame.version === "mpeg1" ? frame.channels === 1 ? 17 : 32 : frame.channels === 1 ? 9 : 17;
|
|
238
|
+
const xingOffset = frame.offset + 4 + sideInfoLength;
|
|
239
|
+
for (const kind of ["Xing", "Info"]) {
|
|
240
|
+
if (fourCc(bytes, xingOffset, 4) !== kind) continue;
|
|
241
|
+
const flags = readU32BE(bytes, xingOffset + 4);
|
|
242
|
+
const frameCount = (flags & 1) !== 0 ? readU32BE(bytes, xingOffset + 8) : 0;
|
|
243
|
+
const byteCount = (flags & 2) !== 0 ? readU32BE(bytes, xingOffset + 12) : 0;
|
|
244
|
+
const gapless = readLameGapless(bytes, xingOffset + 8 + ((flags & 1) !== 0 ? 4 : 0) + ((flags & 2) !== 0 ? 4 : 0) + ((flags & 4) !== 0 ? 100 : 0));
|
|
245
|
+
return {
|
|
246
|
+
kind,
|
|
247
|
+
frameCount,
|
|
248
|
+
byteCount,
|
|
249
|
+
...gapless
|
|
250
|
+
};
|
|
251
|
+
}
|
|
252
|
+
const vbriOffset = frame.offset + 36;
|
|
253
|
+
if (fourCc(bytes, vbriOffset, 4) === "VBRI") {
|
|
254
|
+
return {
|
|
255
|
+
kind: "VBRI",
|
|
256
|
+
frameCount: readU32BE(bytes, vbriOffset + 14),
|
|
257
|
+
byteCount: readU32BE(bytes, vbriOffset + 10),
|
|
258
|
+
encoderDelay: 0,
|
|
259
|
+
encoderPadding: 0
|
|
260
|
+
};
|
|
261
|
+
}
|
|
262
|
+
return null;
|
|
263
|
+
}
|
|
264
|
+
function readLameGapless(bytes, searchStart) {
|
|
265
|
+
const end = Math.min(bytes.byteLength - 3, searchStart + 160);
|
|
266
|
+
for (let offset = searchStart; offset < end; offset++) {
|
|
267
|
+
if (fourCc(bytes, offset, 4) !== "LAME") continue;
|
|
268
|
+
const value = bytes[offset + 0x15] << 16 | bytes[offset + 0x16] << 8 | bytes[offset + 0x17];
|
|
269
|
+
return {
|
|
270
|
+
encoderDelay: value >>> 12 & 0xfff,
|
|
271
|
+
encoderPadding: value & 0xfff
|
|
272
|
+
};
|
|
273
|
+
}
|
|
274
|
+
return {
|
|
275
|
+
encoderDelay: 0,
|
|
276
|
+
encoderPadding: 0
|
|
277
|
+
};
|
|
278
|
+
}
|
|
279
|
+
function findMp3FrameOffset(bytes) {
|
|
280
|
+
let offset = 0;
|
|
281
|
+
if (fourCc(bytes, 0, 3) === "ID3" && bytes.byteLength >= 10) {
|
|
282
|
+
const size = bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9];
|
|
283
|
+
offset = 10 + size + (bytes[5] & 0x10 ? 10 : 0);
|
|
284
|
+
}
|
|
285
|
+
for (; offset + 4 <= bytes.byteLength; offset++) {
|
|
286
|
+
if (readMp3FrameHeader(bytes, offset)) return offset;
|
|
287
|
+
}
|
|
288
|
+
return -1;
|
|
289
|
+
}
|
|
290
|
+
function readMp3FrameHeader(bytes, offset) {
|
|
291
|
+
if (offset < 0 || offset + 4 > bytes.byteLength) return null;
|
|
292
|
+
const header = (bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
|
|
293
|
+
if ((header & 0xffe00000) >>> 0 !== 0xffe00000) return null;
|
|
294
|
+
const versionBits = header >>> 19 & 3;
|
|
295
|
+
const layerBits = header >>> 17 & 3;
|
|
296
|
+
const bitrateIndex = header >>> 12 & 0xf;
|
|
297
|
+
const sampleRateIndex = header >>> 10 & 3;
|
|
298
|
+
const padding = header >>> 9 & 1;
|
|
299
|
+
const channelMode = header >>> 6 & 3;
|
|
300
|
+
if (versionBits === 1 || layerBits !== 1 || bitrateIndex === 0 || bitrateIndex === 15 || sampleRateIndex === 3) {
|
|
301
|
+
return null;
|
|
302
|
+
}
|
|
303
|
+
const version = versionBits === 3 ? "mpeg1" : versionBits === 2 ? "mpeg2" : "mpeg2.5";
|
|
304
|
+
const bitrateTable = version === "mpeg1" ? [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320] : [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160];
|
|
305
|
+
const sampleRateTable = version === "mpeg1" ? [44100, 48000, 32000] : version === "mpeg2" ? [22050, 24000, 16000] : [11025, 12000, 8000];
|
|
306
|
+
const bitrateKbps = bitrateTable[bitrateIndex];
|
|
307
|
+
const sampleRate = sampleRateTable[sampleRateIndex];
|
|
308
|
+
const samplesPerFrame = version === "mpeg1" ? 1152 : 576;
|
|
309
|
+
const frameLength = Math.floor((version === "mpeg1" ? 144000 : 72000) * bitrateKbps / sampleRate) + padding;
|
|
310
|
+
if (offset + frameLength > bytes.byteLength) return null;
|
|
311
|
+
return {
|
|
312
|
+
offset,
|
|
313
|
+
version,
|
|
314
|
+
layer: "layer3",
|
|
315
|
+
bitrateKbps,
|
|
316
|
+
sampleRate,
|
|
317
|
+
channels: channelMode === 3 ? 1 : 2,
|
|
318
|
+
samplesPerFrame,
|
|
319
|
+
frameLength
|
|
320
|
+
};
|
|
321
|
+
}
|
|
322
|
+
function fourCc(bytes, offset, length = 4) {
|
|
323
|
+
let value = "";
|
|
324
|
+
for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);
|
|
325
|
+
return value;
|
|
326
|
+
}
|
|
327
|
+
function readU16LE(bytes, offset) {
|
|
328
|
+
return bytes[offset] | bytes[offset + 1] << 8;
|
|
329
|
+
}
|
|
330
|
+
function readU32LE(bytes, offset) {
|
|
331
|
+
return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] * 0x1000000) >>> 0;
|
|
332
|
+
}
|
|
333
|
+
function readU32BE(bytes, offset) {
|
|
334
|
+
return bytes[offset] * 0x1000000 + (bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
export { DEFAULT_VALUES, OUTPUT_AUDIO, OUTPUT_JSON, OUTPUT_PCM, OUTPUT_RAW, inspectBytes, inspectWithValues, isMP3, isSupportedWithValues, isWAV, normalizeEmit, normalizeInputType, normalizeValues, readWithValues, toBytes, toJsonValue };
|
|
338
|
+
//# sourceMappingURL=helpers.js.map
|