@poe-platform/safe-bash 0.1.809 → 0.1.810

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

@@ -1,4 +1,4 @@
-export { probeWavSource, type AudioProbeSource } from "./wav-source.js";
+export { probeWavSource, type AudioProbeSource, type WavTagSpan } from "./wav-source.js";
 export * from "./types.js";
 export { decodePcm, encodeWav } from "./wav.js";
 export * from "./dsp.js";

package/dist/audio-ast/index.js

@@ -328,6 +328,12 @@ async function probeWavSource(source, options = {}) {
       for (let pos = start + 4; pos < start + size; ) {
         const info = await read(pos, 8), id = info.text(0, 4), length = info.u32(4, true);
         if (length > start + size - pos - 8) throw new Error("WAV INFO exceeds LIST bounds");
+        if (options.onTag) {
+          await options.onTag({ key: infoNames[id] ?? id, offset: pos + 8, length });
+          options.signal?.throwIfAborted();
+          pos += 8 + length + length % 2;
+          continue;
+        }
         const decoder = new TextDecoder();
         let text2 = "", ended = false;
         for (let index = 0; index < length; index += 16384) {

package/dist/audio-ast/wav-source.d.ts

@@ -4,7 +4,13 @@ export interface AudioProbeSource {
     readonly size: number;
     read(offset: number, length: number): Promise<Uint8Array>;
 }
-/** Skip sample/unknown payloads and AST nodes. Tag strings remain an explicit metadata model. */
+export interface WavTagSpan {
+    readonly key: string;
+    readonly offset: number;
+    readonly length: number;
+}
+/** Skip sample/unknown payloads and AST nodes. onTag exposes spans instead of materialized tag strings. */
 export declare function probeWavSource(source: AudioProbeSource, options?: {
     signal?: AbortSignal;
+    onTag?: (span: WavTagSpan) => Promise<void>;
 }): Promise<Omit<AudioAst, "data" | "nodes" | "pictures">>;

package/dist/image-ast/index.js

@@ -1762,7 +1762,7 @@ async function openPdfImage(source, fs, directory, signal, options, storage) {
     if (failure) throw failure.error;
   };
   try {
-    document = await PdfRetainedDocument.open(retained, { fs, directory }, { signal, recovery: "repair", chunkBytes: 16384, maxNodes: 1 / 0, maxTokenBytes: 1 / 0, maxRecursionDepth: 1 / 0, maxPageTreeDepth: 1 / 0, xref: { arrayStorage: values, storedArrayKeys: ["Index"] }, valueArrays: { stringStorage: values, storedStringKeys: ["ActualText"], arrayStorage: values, storedArrayKeys: ["Widths", "W", "Differences", "ON", "OFF", "OCGs"], storedArrayPaths: [["ExtGState", "*", "D"]] } });
+    document = await PdfRetainedDocument.open(retained, { fs, directory }, { signal, recovery: "repair", chunkBytes: 16384, maxNodes: 1 / 0, maxTokenBytes: 1 / 0, maxRecursionDepth: 1 / 0, maxPageTreeDepth: 1 / 0, xref: { arrayStorage: values, storedArrayKeys: ["Index"] }, valueArrays: { stringStorage: values, storedStringKeys: ["ActualText"], arrayStorage: values, storedArrayKeys: ["Contents", "Annots", "Kids", "Widths", "W", "Differences", "ON", "OFF", "OCGs"], storedArrayPaths: [["ExtGState", "*", "D"]] } });
     let pages = 0, selected;
     for await (let page of document.pages())
       pages++, page.index <= Math.max(0, settings.page ?? 0) && (selected = page);

package/dist/pdf-ast/cos/mutable-object-store.d.ts

@@ -42,6 +42,9 @@ export declare class PdfMutableObjectStore {
     private save;
     get(number: number): Promise<PdfRetainedOutputObject | undefined>;
     private load;
+    /** Borrow encoded stream bytes without parsing the object's dictionary. */
+    getStream(number: number): Promise<PdfRetainedOutputObject["stream"]>;
+    private streamSnapshot;
     /** Remember successful decoding only while this stream snapshot is current. */
     markDecoded(object: PdfRetainedOutputObject): Promise<void>;
     /** Enumerate live identities without parsing values or reading payloads. */

package/dist/pdf-ast/cos/qpdf-json-document.d.ts

@@ -0,0 +1,42 @@
+import { type PdfCosRef } from "../ast.js";
+import { PdfFileSource } from "../source.js";
+import type { PdfRetainedDocument } from "../retained-document.js";
+import type { PdfIndexStorage } from "./object-index.js";
+export interface ApplyQpdfJsonOptions {
+    /** The caller retains ownership of datafile handles. */
+    readonly dataFile?: (path: string) => Promise<PdfFileSource | undefined>;
+    readonly maxInputBytes?: number;
+    readonly syntaxError?: (offset: number, message: string, tokenOffset?: number) => never;
+}
+/** A mutable JSON-import document backed only by the caller filesystem. Apply
+ * updates sequentially and publish chunks only after all updates succeed.
+ * A failed update may have applied earlier objects; discard the owner on error. */
+export declare class QpdfJsonDocument {
+    private readonly storage;
+    rootRef: PdfCosRef | undefined;
+    infoRef: PdfCosRef | undefined;
+    private readonly store;
+    private readonly backing;
+    private readonly positions;
+    private readonly order;
+    private readonly catalogs;
+    private ordinal;
+    private readonly controller;
+    private readonly signal;
+    private pending;
+    private closing;
+    constructor(storage: PdfIndexStorage, options?: {
+        signal?: AbortSignal;
+    });
+    private remember;
+    static fromDocument(document: PdfRetainedDocument, source: PdfFileSource, storage: PdfIndexStorage, options?: {
+        signal?: AbortSignal;
+    }): Promise<QpdfJsonDocument>;
+    apply(input: AsyncIterable<Uint8Array> | Iterable<Uint8Array>, options?: ApplyQpdfJsonOptions): Promise<void>;
+    private update;
+    chunks(options?: {
+        maxOutputBytes?: number;
+        chunkBytes?: number;
+    }): AsyncGenerator<Uint8Array>;
+    close(): Promise<void>;
+}

package/dist/pdf-ast/cos/qpdf-json-values.d.ts

@@ -10,6 +10,7 @@ export declare class QpdfJsonValues {
     private readonly scratch;
     private readonly first;
     private readonly next;
+    private sourceOrder;
     private closed;
     private work;
     private constructor();
@@ -26,6 +27,12 @@ export declare class QpdfJsonValues {
     /** Match the legacy reference grammar without collecting long zero padding. */
     reference(position: number): Promise<PdfCosRef | undefined>;
     private scalar;
+    validate(root: number): Promise<void>;
+    /** Look up a converted PDF dictionary name, after prefix decoding/collisions. */
+    property(root: number, name: string): Promise<number | undefined>;
+    private keyEquals;
+    /** Stream an imported stream dictionary with legacy filter/length handling. */
+    streamDictionary(root: number | undefined, length: number): AsyncGenerator<Uint8Array>;
     chunks(root: number): AsyncGenerator<Uint8Array>;
     close(): Promise<void>;
 }

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

@@ -75,3 +75,4 @@ export { retainedObjectOrder } from "./cos/retained-object-order.js";
 export { encryptRetainedPdfChunks } from "./cos/retained-encryption.js";
 export { replaceRetainedPdfName } from "./edit/retained-name-replacement.js";
 export { QpdfJsonValues } from "./cos/qpdf-json-values.js";
+export { QpdfJsonDocument, type ApplyQpdfJsonOptions } from "./cos/qpdf-json-document.js";