@poe-platform/safe-bash 0.1.840 → 0.1.841

package/dist/audio-ast/binary.d.ts

@@ -0,0 +1,19 @@
+export declare class Reader {
+    readonly bytes: Uint8Array;
+    readonly view: DataView;
+    constructor(bytes: Uint8Array);
+    check(offset: number, size: number): void;
+    slice(offset: number, size: number): Uint8Array;
+    text(offset: number, size: number): string;
+    u8(offset: number): number;
+    u16(offset: number, little?: boolean): number;
+    u24(offset: number, little?: boolean): number;
+    u32(offset: number, little?: boolean): number;
+    u64(offset: number, little?: boolean): bigint;
+    safe64(offset: number, little?: boolean): number;
+}
+export declare function join(parts: Uint8Array[]): Uint8Array;
+export declare function ascii(text: string): Uint8Array;
+export declare function uint32(value: number, little?: boolean): Uint8Array;
+export declare function cleanText(text: string): string;
+export declare function duration(samples: number, sampleRate: number): number;

package/dist/audio-ast/index.d.ts

@@ -1,3 +1,4 @@
+export { mpegFrame } from "./mpeg.js";
 export { probeOggStreamSource, type OggCommentSpan } from "./ogg-stream-source.js";
 export { scanOggPages, type OggPageSpan } from "./ogg-source.js";
 export { probeMp3Source, type Mp3Tag } from "./mp3-source.js";

package/dist/audio-ast/index.js

@@ -74,6 +74,97 @@ function duration(samples, sampleRate) {
   return samples / sampleRate;
 }
 
+// packages/audio-ast/src/mpeg.ts
+function mpegFrame(header, offset, end) {
+  const versionBits = header >>> 19 & 3, layer = header >>> 17 & 3, bitrateIndex = header >>> 12 & 15, rateIndex = header >>> 10 & 3;
+  if (header >>> 21 !== 2047 || versionBits === 1 || layer !== 1 || !bitrateIndex || bitrateIndex === 15 || rateIndex === 3)
+    throw new Error(`Invalid MPEG Layer III frame at ${offset}`);
+  const version = versionBits === 3 ? 1 : versionBits === 2 ? 2 : 2.5;
+  const rate = [44100, 48e3, 32e3][rateIndex] / (version === 1 ? 1 : version === 2 ? 2 : 4);
+  const bitrate = (version === 1 ? [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])[bitrateIndex] * 1e3;
+  const count = version === 1 ? 1152 : 576, frameSize = Math.floor((version === 1 ? 144 : 72) * bitrate / rate) + (header >>> 9 & 1), ch = header >>> 6 & 3;
+  if (frameSize > end - offset) throw new Error("Truncated MPEG frame");
+  const channels = ch === 3 ? 1 : 2;
+  const fields = {
+    version,
+    layer: 3,
+    bitrate,
+    sampleRate: rate,
+    channels,
+    samples: count,
+    padding: header >>> 9 & 1
+  };
+  return { version, rate, count, frameSize, channels, fields };
+}
+function mpegVbr(r, offset, frameSize, header, fields) {
+  const version = Number(fields.version), channels = Number(fields.channels);
+  const side = version === 1 ? channels === 1 ? 17 : 32 : channels === 1 ? 9 : 17, crc = header & 65536 ? 0 : 2;
+  const xing = offset + 4 + crc + side;
+  if (xing + 8 <= offset + frameSize && ["Xing", "Info"].includes(r.text(xing, 4))) {
+    const flags = r.u32(xing + 4);
+    let pos = xing + 8;
+    const vbr = { type: r.text(xing, 4), flags };
+    if (flags & 1) {
+      vbr.frames = r.u32(pos);
+      pos += 4;
+    }
+    if (flags & 2) {
+      vbr.bytes = r.u32(pos);
+      pos += 4;
+    }
+    if (flags & 4) {
+      vbr.toc = r.slice(pos, 100);
+      pos += 100;
+    }
+    if (flags & 8) {
+      vbr.quality = r.u32(pos);
+      pos += 4;
+    }
+    if (pos > offset + frameSize) throw new Error("Xing header exceeds frame");
+    fields.vbr = vbr;
+    if (pos + 24 <= offset + frameSize && ["LAME", "Lavc", "Lavf"].includes(r.text(pos, 4))) {
+      const packed = r.u24(pos + 21);
+      fields.encoderDelay = packed >>> 12;
+      fields.encoderPadding = packed & 4095;
+    }
+  }
+  const vbri = offset + 36;
+  if (vbri + 26 <= offset + frameSize && r.text(vbri, 4) === "VBRI")
+    fields.vbr = {
+      type: "VBRI",
+      version: r.u16(vbri + 4),
+      delay: r.u16(vbri + 6),
+      quality: r.u16(vbri + 8),
+      bytes: r.u32(vbri + 10),
+      frames: r.u32(vbri + 14),
+      entries: r.u16(vbri + 18),
+      scale: r.u16(vbri + 20),
+      entryBytes: r.u16(vbri + 22),
+      framesPerEntry: r.u16(vbri + 24)
+    };
+}
+function mpegStream(state, first) {
+  let { samples, seconds: seconds2, audioBytes } = state;
+  const { sampleRate, channels, frames } = state;
+  if (!frames) throw new Error("MP3 contains no MPEG frames");
+  const vbr = first.fields?.vbr;
+  const declared = vbr?.frames;
+  if (typeof declared === "number" && declared > 0) {
+    if (declared !== frames && declared !== frames - 1)
+      throw new Error("MPEG VBR frame count mismatch");
+    const encodedSamples = declared * (sampleRate >= 32e3 ? 1152 : 576);
+    const delay = Number(first.fields?.encoderDelay ?? 0), padding = Number(first.fields?.encoderPadding ?? 0);
+    if (delay + padding > encodedSamples) throw new Error("Invalid MPEG encoder delay/padding");
+    samples = encodedSamples - delay - padding;
+    seconds2 = duration(samples, sampleRate);
+    if (declared === frames - 1) audioBytes -= first.size;
+    first.fields.encodedSamples = encodedSamples;
+  }
+  const encodedSeconds = duration(Number(first.fields?.encodedSamples ?? samples), sampleRate);
+  const bitrate = encodedSeconds ? audioBytes * 8 / encodedSeconds : 0;
+  return { codec: "mp3", sampleRate, channels, samples, duration: seconds2, bitrate };
+}
+
 // packages/audio-ast/src/ogg-stream.ts
 function oggIdentification(head, size = head.length) {
   const r = new Reader(head);
@@ -883,97 +974,6 @@ async function probeId3Source(source, options = {}) {
   return { size, version, tags };
 }
 
-// packages/audio-ast/src/mpeg.ts
-function mpegFrame(header, offset, end) {
-  const versionBits = header >>> 19 & 3, layer = header >>> 17 & 3, bitrateIndex = header >>> 12 & 15, rateIndex = header >>> 10 & 3;
-  if (header >>> 21 !== 2047 || versionBits === 1 || layer !== 1 || !bitrateIndex || bitrateIndex === 15 || rateIndex === 3)
-    throw new Error(`Invalid MPEG Layer III frame at ${offset}`);
-  const version = versionBits === 3 ? 1 : versionBits === 2 ? 2 : 2.5;
-  const rate = [44100, 48e3, 32e3][rateIndex] / (version === 1 ? 1 : version === 2 ? 2 : 4);
-  const bitrate = (version === 1 ? [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])[bitrateIndex] * 1e3;
-  const count = version === 1 ? 1152 : 576, frameSize = Math.floor((version === 1 ? 144 : 72) * bitrate / rate) + (header >>> 9 & 1), ch = header >>> 6 & 3;
-  if (frameSize > end - offset) throw new Error("Truncated MPEG frame");
-  const channels = ch === 3 ? 1 : 2;
-  const fields = {
-    version,
-    layer: 3,
-    bitrate,
-    sampleRate: rate,
-    channels,
-    samples: count,
-    padding: header >>> 9 & 1
-  };
-  return { version, rate, count, frameSize, channels, fields };
-}
-function mpegVbr(r, offset, frameSize, header, fields) {
-  const version = Number(fields.version), channels = Number(fields.channels);
-  const side = version === 1 ? channels === 1 ? 17 : 32 : channels === 1 ? 9 : 17, crc = header & 65536 ? 0 : 2;
-  const xing = offset + 4 + crc + side;
-  if (xing + 8 <= offset + frameSize && ["Xing", "Info"].includes(r.text(xing, 4))) {
-    const flags = r.u32(xing + 4);
-    let pos = xing + 8;
-    const vbr = { type: r.text(xing, 4), flags };
-    if (flags & 1) {
-      vbr.frames = r.u32(pos);
-      pos += 4;
-    }
-    if (flags & 2) {
-      vbr.bytes = r.u32(pos);
-      pos += 4;
-    }
-    if (flags & 4) {
-      vbr.toc = r.slice(pos, 100);
-      pos += 100;
-    }
-    if (flags & 8) {
-      vbr.quality = r.u32(pos);
-      pos += 4;
-    }
-    if (pos > offset + frameSize) throw new Error("Xing header exceeds frame");
-    fields.vbr = vbr;
-    if (pos + 24 <= offset + frameSize && ["LAME", "Lavc", "Lavf"].includes(r.text(pos, 4))) {
-      const packed = r.u24(pos + 21);
-      fields.encoderDelay = packed >>> 12;
-      fields.encoderPadding = packed & 4095;
-    }
-  }
-  const vbri = offset + 36;
-  if (vbri + 26 <= offset + frameSize && r.text(vbri, 4) === "VBRI")
-    fields.vbr = {
-      type: "VBRI",
-      version: r.u16(vbri + 4),
-      delay: r.u16(vbri + 6),
-      quality: r.u16(vbri + 8),
-      bytes: r.u32(vbri + 10),
-      frames: r.u32(vbri + 14),
-      entries: r.u16(vbri + 18),
-      scale: r.u16(vbri + 20),
-      entryBytes: r.u16(vbri + 22),
-      framesPerEntry: r.u16(vbri + 24)
-    };
-}
-function mpegStream(state, first) {
-  let { samples, seconds: seconds2, audioBytes } = state;
-  const { sampleRate, channels, frames } = state;
-  if (!frames) throw new Error("MP3 contains no MPEG frames");
-  const vbr = first.fields?.vbr;
-  const declared = vbr?.frames;
-  if (typeof declared === "number" && declared > 0) {
-    if (declared !== frames && declared !== frames - 1)
-      throw new Error("MPEG VBR frame count mismatch");
-    const encodedSamples = declared * (sampleRate >= 32e3 ? 1152 : 576);
-    const delay = Number(first.fields?.encoderDelay ?? 0), padding = Number(first.fields?.encoderPadding ?? 0);
-    if (delay + padding > encodedSamples) throw new Error("Invalid MPEG encoder delay/padding");
-    samples = encodedSamples - delay - padding;
-    seconds2 = duration(samples, sampleRate);
-    if (declared === frames - 1) audioBytes -= first.size;
-    first.fields.encodedSamples = encodedSamples;
-  }
-  const encodedSeconds = duration(Number(first.fields?.encodedSamples ?? samples), sampleRate);
-  const bitrate = encodedSeconds ? audioBytes * 8 / encodedSeconds : 0;
-  return { codec: "mp3", sampleRate, channels, samples, duration: seconds2, bitrate };
-}
-
 // packages/audio-ast/src/mp3-source.ts
 async function probeMp3Source(source, options = {}) {
   const read = async (offset2, length) => {
@@ -2092,6 +2092,7 @@ export {
   encodeWav,
   extractChannels,
   fade,
+  mpegFrame,
   normalize,
   normalizeVorbisCommentKey,
   pad,

package/dist/audio-ast/mpeg.d.ts

@@ -0,0 +1,23 @@
+import { Reader } from "./binary.js";
+import type { AudioStream } from "./types.js";
+/** Shared strict frame validation for resident parsing and bounded source probing. */
+export declare function mpegFrame(header: number, offset: number, end: number): {
+    version: number;
+    rate: number;
+    count: number;
+    frameSize: number;
+    channels: number;
+    fields: Record<string, unknown>;
+};
+export declare function mpegVbr(r: Reader, offset: number, frameSize: number, header: number, fields: Record<string, unknown>): void;
+export declare function mpegStream(state: {
+    samples: number;
+    seconds: number;
+    audioBytes: number;
+    sampleRate: number;
+    channels: number;
+    frames: number;
+}, first: {
+    size: number;
+    fields: Record<string, unknown>;
+}): AudioStream;

package/dist/mp4-ast/containers/adapters.d.ts

@@ -9,6 +9,7 @@ export declare function parseAacAdts(bytes: Uint8Array): MediaDocument;
 export declare function serializeAacAdts(doc: MediaDocument): Uint8Array;
 export declare function aacAst(): MediaAstPlugin;
 export declare function isWavSignature(bytes: Uint8Array): boolean;
+export declare function wavPacketFrames(sampleRate: number, block: number): number;
 export declare function parseWav(bytes: Uint8Array, options?: ParseMediaOptions): MediaDocument;
 export declare function serializeWav(doc: MediaDocument): Uint8Array;
 type WavMetadataOnlyOptions = MediaSourceProbeOptions & {

package/dist/mp4-ast/types.d.ts

@@ -84,6 +84,8 @@ export interface MediaAudioData {
     readonly startSeconds?: number | undefined;
 }
 export interface MediaSample {
+    /** Absolute source file offset when the sample was parsed from a container. */
+    readonly offset?: number;
     readonly data: Uint8Array;
     readonly dts: number;
     readonly pts: number;
@@ -305,6 +307,8 @@ export interface MediaProbeStream {
     readonly duration: string;
     readonly bit_rate?: string | undefined;
     readonly nb_frames?: string | undefined;
+    readonly nb_read_packets?: string | undefined;
+    readonly nb_read_frames?: string | undefined;
     readonly disposition: Readonly<Record<string, number>>;
     readonly tags?: Readonly<Record<string, string>> | undefined;
     readonly side_data_list?: readonly Readonly<Record<string, unknown>>[] | undefined;

package/dist/safe-bash/audio-ast.browser.js

@@ -1,11 +1,12 @@
 // packages/safe-bash/src/audio-ast.ts
-import { concat, decodePcm, encodeWav, extractChannels, fade, normalize, normalizeVorbisCommentKey, pad, parseAudio, probeAudio, probeFlacSource, probeId3Source, probeMp3Source, probeOggStreamSource, probeWavSource, readId3Text, remix, resample, scanOggPages, stats, transformAudio, trim, writeAudioMetadata } from "../audio-ast/index.js";
+import { concat, decodePcm, encodeWav, extractChannels, fade, mpegFrame, normalize, normalizeVorbisCommentKey, pad, parseAudio, probeAudio, probeFlacSource, probeId3Source, probeMp3Source, probeOggStreamSource, probeWavSource, readId3Text, remix, resample, scanOggPages, stats, transformAudio, trim, writeAudioMetadata } from "../audio-ast/index.js";
 export {
   concat,
   decodePcm,
   encodeWav,
   extractChannels,
   fade,
+  mpegFrame,
   normalize,
   normalizeVorbisCommentKey,
   pad,

package/dist/safe-bash/audio-ast.js

@@ -1,2 +1,2 @@
-export { "concat", "decodePcm", "encodeWav", "extractChannels", "fade", "normalize", "normalizeVorbisCommentKey", "pad", "parseAudio", "probeAudio", "probeFlacSource", "probeId3Source", "probeMp3Source", "probeOggStreamSource", "probeWavSource", "readId3Text", "remix", "resample", "scanOggPages", "stats", "transformAudio", "trim", "writeAudioMetadata" } from "../audio-ast/index.js";
+export { "concat", "decodePcm", "encodeWav", "extractChannels", "fade", "mpegFrame", "normalize", "normalizeVorbisCommentKey", "pad", "parseAudio", "probeAudio", "probeFlacSource", "probeId3Source", "probeMp3Source", "probeOggStreamSource", "probeWavSource", "readId3Text", "remix", "resample", "scanOggPages", "stats", "transformAudio", "trim", "writeAudioMetadata" } from "../audio-ast/index.js";
 //# sourceMappingURL=audio-ast.js.map