node-av 5.2.4 → 6.0.0-beta.10

package/dist/api/scaler.js

@@ -0,0 +1,620 @@
+import { AV_CODEC_FLAG_QSCALE, AV_HWDEVICE_TYPE_OPENCL, AV_PIX_FMT_GRAY8, AV_PIX_FMT_NONE, AV_PIX_FMT_NV12, AV_PIX_FMT_RGB24, AV_PIX_FMT_RGBA, AV_PIX_FMT_YUV420P, AVCOL_RANGE_JPEG, FF_QP2LAMBDA, SWS_BILINEAR, } from '../constants/constants.js';
+import { FF_ENCODER_MJPEG, FF_ENCODER_PNG } from '../constants/encoders.js';
+import { bindings } from '../lib/binding.js';
+import { FFmpegError } from '../lib/error.js';
+import { Frame } from '../lib/frame.js';
+import { EncoderPool } from './encoder-pool.js';
+import { FilterPreset } from './filter-presets.js';
+import { FilterAPI } from './filter.js';
+const FORMAT_TO_PIXFMT = {
+    rgb: AV_PIX_FMT_RGB24,
+    rgba: AV_PIX_FMT_RGBA,
+    gray: AV_PIX_FMT_GRAY8,
+    nv12: AV_PIX_FMT_NV12,
+    yuv420p: AV_PIX_FMT_YUV420P,
+};
+/**
+ * High-level image scaler, cropper, and pixel-format converter.
+ *
+ * Scales, crops, and converts decoded frames to raw pixel buffers or encoded
+ * JPEG/PNG images. Built for the detection/thumbnail/snapshot workload: one
+ * instance pools its swscale contexts, GPU filter graphs, and encoders, so
+ * reusing it for every frame and every crop avoids per-frame allocation.
+ * Software frames are scaled with swscale; hardware frames are cropped, scaled,
+ * and converted on the GPU with only the small result downloaded.
+ *
+ * @example
+ * ```typescript
+ * import { Scaler } from 'node-av/api';
+ *
+ * using scaler = new Scaler({ hardware });
+ *
+ * // Scale + convert to RGB (on the GPU for hardware frames)
+ * const rgb = await scaler.toBuffer(frame, { resize: { width: 640, height: 360 }, format: 'rgb' });
+ *
+ * // Crop a detected region and encode a snapshot
+ * const jpeg = await scaler.toJpeg(frame, { crop: { x, y, width: w, height: h }, quality: 85 });
+ * ```
+ *
+ * @see {@link EncoderPool} For pooled image encoders
+ * @see {@link FilterAPI} For streaming filtergraphs
+ */
+export class Scaler {
+    native;
+    hardware;
+    flags;
+    maxCacheSize;
+    graphs = new Map();
+    jpegPool;
+    pngPool;
+    downloadFrame;
+    disposed = false;
+    /**
+     * Create a new scaler.
+     *
+     * @param options - Scaler options
+     *
+     * @example
+     * ```typescript
+     * using scaler = new Scaler({ hardware: HardwareContext.auto() });
+     * ```
+     */
+    constructor(options = {}) {
+        this.flags = options.flags ?? SWS_BILINEAR;
+        this.hardware = options.hardware;
+        this.maxCacheSize = options.maxCacheSize ?? 16;
+        this.native = new bindings.Scaler(this.flags);
+    }
+    /**
+     * Scale, crop, and/or convert a frame and return the raw pixel data.
+     *
+     * The returned buffer is tightly packed (no row padding). For planar formats
+     * (`nv12`, `yuv420p`) planes are concatenated.
+     *
+     * @param frame - Source frame (software or hardware; hardware frames are processed on the GPU and downloaded)
+     *
+     * @param options - Crop, resize, and format options
+     *
+     * @returns Tightly packed pixel data
+     *
+     * @throws {FFmpegError} If scaling fails
+     *
+     * @example
+     * ```typescript
+     * const gray = await scaler.toBuffer(frame, { resize: { width: 320, height: 180 }, format: 'gray' });
+     * ```
+     *
+     * @see {@link toBufferSync} For synchronous version
+     */
+    async toBuffer(frame, options = {}) {
+        if (this.disposed) {
+            throw new Error('Scaler has been disposed');
+        }
+        if (frame.isHwFrame()) {
+            // With a hardware context, crop/scale/convert on the GPU and download only
+            // the small result. Without one, fall back to downloading the full frame
+            // and processing it in software.
+            if (this.hardware) {
+                const out = await this.toFrame(frame, options.crop, options.resize, options.format ?? 'nv12');
+                try {
+                    return out.toBuffer();
+                }
+                finally {
+                    out.free();
+                }
+            }
+            return await this.native.process((await this.downloadToSoftware(frame)).getNative(), options);
+        }
+        return await this.native.process(frame.getNative(), options);
+    }
+    /**
+     * Scale, crop, and/or convert a frame and return the raw pixel data.
+     * Synchronous version of toBuffer.
+     *
+     * @param frame - Source frame (software or hardware; hardware frames are processed on the GPU and downloaded)
+     *
+     * @param options - Crop, resize, and format options
+     *
+     * @returns Tightly packed pixel data
+     *
+     * @throws {FFmpegError} If scaling fails
+     *
+     * @example
+     * ```typescript
+     * const gray = scaler.toBufferSync(frame, { resize: { width: 320, height: 180 }, format: 'gray' });
+     * ```
+     *
+     * @see {@link toBuffer} For async version
+     */
+    toBufferSync(frame, options = {}) {
+        if (this.disposed) {
+            throw new Error('Scaler has been disposed');
+        }
+        if (frame.isHwFrame()) {
+            if (this.hardware) {
+                const out = this.toFrameSync(frame, options.crop, options.resize, options.format ?? 'nv12');
+                try {
+                    return out.toBuffer();
+                }
+                finally {
+                    out.free();
+                }
+            }
+            return this.native.processSync(this.downloadToSoftwareSync(frame).getNative(), options);
+        }
+        return this.native.processSync(frame.getNative(), options);
+    }
+    /**
+     * Scale/crop a frame and encode it to a JPEG image.
+     *
+     * The encoder is pooled per output size and reused across calls - no encoder is
+     * rebuilt per snapshot. Hardware frames are scaled on the GPU and downloaded;
+     * software frames are scaled with swscale.
+     *
+     * @param frame - Source frame (software or hardware)
+     *
+     * @param options - Crop, resize, and quality options
+     *
+     * @returns Encoded JPEG bytes
+     *
+     * @throws {FFmpegError} If scaling or encoding fails
+     *
+     * @example
+     * ```typescript
+     * const jpeg = await scaler.toJpeg(frame, { resize: { width: 1280, height: 720 }, quality: 85 });
+     * await writeFile('snapshot.jpg', jpeg);
+     * ```
+     *
+     * @see {@link toJpegSync} For synchronous version
+     */
+    async toJpeg(frame, options = {}) {
+        if (this.disposed) {
+            throw new Error('Scaler has been disposed');
+        }
+        const quality = options.quality ?? 90;
+        const src = frame.isHwFrame() && !this.hardware ? await this.downloadToSoftware(frame) : frame;
+        // mjpeg wants planar YUV; tag it full-range so colors are correct without the
+        // deprecated yuvj* formats.
+        const out = await this.toFrame(src, options.crop, options.resize, 'yuv420p');
+        try {
+            this.prepareJpegFrame(out, quality);
+            return await this.getJpegPool().encode(out);
+        }
+        finally {
+            out.free();
+        }
+    }
+    /**
+     * Scale/crop a frame and encode it to a JPEG image.
+     * Synchronous version of toJpeg.
+     *
+     * @param frame - Source frame (software or hardware)
+     *
+     * @param options - Crop, resize, and quality options
+     *
+     * @returns Encoded JPEG bytes
+     *
+     * @throws {FFmpegError} If scaling or encoding fails
+     *
+     * @example
+     * ```typescript
+     * const jpeg = scaler.toJpegSync(frame, { resize: { width: 1280, height: 720 }, quality: 85 });
+     * ```
+     *
+     * @see {@link toJpeg} For async version
+     */
+    toJpegSync(frame, options = {}) {
+        if (this.disposed) {
+            throw new Error('Scaler has been disposed');
+        }
+        const quality = options.quality ?? 90;
+        const src = frame.isHwFrame() && !this.hardware ? this.downloadToSoftwareSync(frame) : frame;
+        const out = this.toFrameSync(src, options.crop, options.resize, 'yuv420p');
+        try {
+            this.prepareJpegFrame(out, quality);
+            return this.getJpegPool().encodeSync(out);
+        }
+        finally {
+            out.free();
+        }
+    }
+    /**
+     * Scale/crop a frame and encode it to a PNG image.
+     *
+     * The encoder is pooled per output size/format and reused across calls. Hardware
+     * frames are scaled on the GPU and downloaded; software frames use swscale.
+     *
+     * @param frame - Source frame (software or hardware)
+     *
+     * @param options - Crop, resize, and color-format options
+     *
+     * @returns Encoded PNG bytes
+     *
+     * @throws {FFmpegError} If scaling or encoding fails
+     *
+     * @example
+     * ```typescript
+     * const png = await scaler.toPng(frame, { crop: { x, y, width: w, height: h } });
+     * await writeFile('region.png', png);
+     * ```
+     *
+     * @see {@link toPngSync} For synchronous version
+     */
+    async toPng(frame, options = {}) {
+        if (this.disposed) {
+            throw new Error('Scaler has been disposed');
+        }
+        const format = options.format ?? 'rgb';
+        const src = frame.isHwFrame() && !this.hardware ? await this.downloadToSoftware(frame) : frame;
+        const out = await this.toFrame(src, options.crop, options.resize, format);
+        try {
+            return await this.getPngPool().encode(out);
+        }
+        finally {
+            out.free();
+        }
+    }
+    /**
+     * Scale/crop a frame and encode it to a PNG image.
+     * Synchronous version of toPng.
+     *
+     * @param frame - Source frame (software or hardware)
+     *
+     * @param options - Crop, resize, and color-format options
+     *
+     * @returns Encoded PNG bytes
+     *
+     * @throws {FFmpegError} If scaling or encoding fails
+     *
+     * @example
+     * ```typescript
+     * const png = scaler.toPngSync(frame, { crop: { x, y, width: w, height: h } });
+     * ```
+     *
+     * @see {@link toPng} For async version
+     */
+    toPngSync(frame, options = {}) {
+        if (this.disposed) {
+            throw new Error('Scaler has been disposed');
+        }
+        const format = options.format ?? 'rgb';
+        const src = frame.isHwFrame() && !this.hardware ? this.downloadToSoftwareSync(frame) : frame;
+        const out = this.toFrameSync(src, options.crop, options.resize, format);
+        try {
+            return this.getPngPool().encodeSync(out);
+        }
+        finally {
+            out.free();
+        }
+    }
+    /**
+     * Release all pooled scaling contexts, graphs, and frames.
+     *
+     * @example
+     * ```typescript
+     * scaler.close();
+     * ```
+     */
+    close() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.native.close();
+        for (const entry of this.graphs.values()) {
+            entry.filter[Symbol.dispose]();
+        }
+        this.graphs.clear();
+        this.jpegPool?.close();
+        this.jpegPool = undefined;
+        this.pngPool?.close();
+        this.pngPool = undefined;
+        this.downloadFrame?.free();
+        this.downloadFrame = undefined;
+    }
+    /**
+     * Download a hardware frame to system memory (no hardware context available).
+     *
+     * Reuses a single target frame across calls. The frame's own hwframe context
+     * selects a supported software format.
+     *
+     * @param frame - Hardware source frame
+     *
+     * @returns Software frame
+     *
+     * @throws {FFmpegError} If the transfer fails
+     *
+     * @internal
+     */
+    async downloadToSoftware(frame) {
+        const dst = this.prepareDownloadTarget();
+        const ret = await frame.hwframeTransferData(dst, 0);
+        FFmpegError.throwIfError(ret, 'Failed to download hardware frame');
+        dst.copyProps(frame);
+        return dst;
+    }
+    /**
+     * Synchronous version of downloadToSoftware.
+     *
+     * @param frame - Hardware source frame
+     *
+     * @returns Software frame
+     *
+     * @throws {FFmpegError} If the transfer fails
+     *
+     * @internal
+     */
+    downloadToSoftwareSync(frame) {
+        const dst = this.prepareDownloadTarget();
+        const ret = frame.hwframeTransferDataSync(dst, 0);
+        FFmpegError.throwIfError(ret, 'Failed to download hardware frame');
+        dst.copyProps(frame);
+        return dst;
+    }
+    /**
+     * Lazily allocate and reset the reused download target frame.
+     *
+     * @returns The cleared download frame
+     *
+     * @internal
+     */
+    prepareDownloadTarget() {
+        if (!this.downloadFrame) {
+            this.downloadFrame = new Frame();
+            this.downloadFrame.alloc();
+        }
+        const dst = this.downloadFrame;
+        dst.unref();
+        dst.format = AV_PIX_FMT_NONE;
+        return dst;
+    }
+    /**
+     * Scale/crop/convert a frame through a cached filter graph and return the
+     * resulting frame (caller must free it).
+     *
+     * Software frames are scaled with swscale filters; hardware frames are
+     * cropped/scaled/converted on the GPU and downloaded. The crop region is
+     * reconfigured per frame via a runtime command on a graph shared per output
+     * size (except OpenCL, where the crop is baked in).
+     *
+     * @param frame - Source frame (software, or hardware with a hardware context)
+     *
+     * @param crop - Crop region, or undefined for the full frame
+     *
+     * @param resize - Target dimensions, or undefined to keep the cropped size
+     *
+     * @param format - Output pixel format
+     *
+     * @returns The scaled output frame (caller frees)
+     *
+     * @throws {Error} If the crop is out of bounds or the graph produces no frame
+     *
+     * @internal
+     */
+    async toFrame(frame, crop, resize, format) {
+        const entry = this.resolveGraph(frame, crop, resize, format);
+        await entry.filter.process(frame);
+        const out = await entry.filter.receive();
+        if (out == null) {
+            throw new Error('Scaler: filter produced no frame');
+        }
+        return out;
+    }
+    /**
+     * Synchronous version of toFrame.
+     *
+     * @param frame - Source frame (software, or hardware with a hardware context)
+     *
+     * @param crop - Crop region, or undefined for the full frame
+     *
+     * @param resize - Target dimensions, or undefined to keep the cropped size
+     *
+     * @param format - Output pixel format
+     *
+     * @returns The scaled output frame (caller frees)
+     *
+     * @internal
+     */
+    toFrameSync(frame, crop, resize, format) {
+        const entry = this.resolveGraph(frame, crop, resize, format);
+        entry.filter.processSync(frame);
+        const out = entry.filter.receiveSync();
+        if (out == null) {
+            throw new Error('Scaler: filter produced no frame');
+        }
+        return out;
+    }
+    /**
+     * Resolve (and, on demand, build) the cached filter graph for a frame, applying
+     * the crop reconfiguration. Shared by the sync and async scaling paths; all of
+     * this work (parse, config, sendCommand) is synchronous.
+     *
+     * @param frame - Source frame (software, or hardware with a hardware context)
+     *
+     * @param crop - Crop region, or undefined for the full frame
+     *
+     * @param resize - Target dimensions, or undefined to keep the cropped size
+     *
+     * @param format - Output pixel format
+     *
+     * @returns The cached graph entry, ready to process the frame
+     *
+     * @throws {Error} If the crop is out of bounds
+     *
+     * @internal
+     */
+    resolveGraph(frame, crop, resize, format) {
+        const isHw = frame.isHwFrame();
+        if (isHw && !this.hardware) {
+            throw new Error('Scaler received a hardware frame but was created without a HardwareContext');
+        }
+        const cropW = crop?.width ?? frame.width;
+        const cropH = crop?.height ?? frame.height;
+        const cropX = crop?.x ?? 0;
+        const cropY = crop?.y ?? 0;
+        if (cropX < 0 || cropY < 0 || cropW <= 0 || cropH <= 0 || cropX + cropW > frame.width || cropY + cropH > frame.height) {
+            throw new Error(`Scaler: crop region {x:${cropX}, y:${cropY}, width:${cropW}, height:${cropH}} is out of bounds for ${frame.width}x${frame.height} frame`);
+        }
+        const outW = resize?.width ?? cropW;
+        const outH = resize?.height ?? cropH;
+        // The standard `crop` filter is runtime-commandable for software frames and on
+        // every hardware backend except OpenCL (where crop is folded into scale_opencl).
+        // When commandable we share one graph per output size and re-aim the crop per
+        // frame; otherwise the crop is baked in and the key must include it.
+        const commandable = !isHw || this.hardware.deviceType !== AV_HWDEVICE_TYPE_OPENCL;
+        const prefix = isHw ? 'hw' : 'sw';
+        const key = commandable ? `${prefix}_${outW}x${outH}_${format}` : `${prefix}_${cropX},${cropY},${cropW},${cropH}->${outW}x${outH}_${format}`;
+        const cropRegion = { x: cropX, y: cropY, width: cropW, height: cropH };
+        let entry = this.graphs.get(key);
+        if (!entry) {
+            // Bake the first crop in as the graph default: the graph initializes lazily
+            // on the first processed frame, before any command can be sent, so the
+            // initial crop must already be in place. Later crops use sendCommand.
+            const filter = FilterAPI.create(this.buildGraph(isHw, outW, outH, format, cropRegion, commandable), isHw ? { hardware: this.hardware } : {});
+            entry = { filter, lastCrop: commandable ? { x: cropX, y: cropY, w: cropW, h: cropH } : null };
+            this.cacheSet(key, entry);
+        }
+        else {
+            // Bump LRU recency.
+            this.graphs.delete(key);
+            this.graphs.set(key, entry);
+        }
+        if (commandable) {
+            // Reconfigure the crop only when it actually changed - identical crops reuse
+            // the graph untouched (no config_input/config_output re-run).
+            const c = entry.lastCrop;
+            if (c?.x !== cropX || c?.y !== cropY || c?.w !== cropW || c?.h !== cropH) {
+                // w/h are validated against the input dims (above); x/y are clamped per
+                // frame by the crop filter, so this order never produces a transient error.
+                entry.filter.sendCommand('crop@sc', 'w', String(cropW));
+                entry.filter.sendCommand('crop@sc', 'h', String(cropH));
+                entry.filter.sendCommand('crop@sc', 'x', String(cropX));
+                entry.filter.sendCommand('crop@sc', 'y', String(cropY));
+                entry.lastCrop = { x: cropX, y: cropY, w: cropW, h: cropH };
+            }
+        }
+        return entry;
+    }
+    /**
+     * Tag a frame for MJPEG encoding: full color range and a per-frame quality.
+     *
+     * MJPEG quality is carried on the frame (the encoder pool sets the QSCALE flag),
+     * so one pooled encoder serves every quality for a given output size.
+     *
+     * @param frame - Frame about to be JPEG-encoded
+     *
+     * @param quality - Quality from 1 (worst) to 100 (best)
+     *
+     * @internal
+     */
+    prepareJpegFrame(frame, quality) {
+        frame.colorRange = AVCOL_RANGE_JPEG;
+        const q = Math.max(1, Math.min(100, quality));
+        const qscale = Math.max(2, Math.min(31, Math.round(2 + ((100 - q) / 99) * 29)));
+        frame.quality = qscale * FF_QP2LAMBDA;
+    }
+    /**
+     * The lazily created MJPEG encoder pool (QSCALE flag set for per-frame quality).
+     *
+     * @returns The JPEG encoder pool
+     *
+     * @internal
+     */
+    getJpegPool() {
+        this.jpegPool ??= new EncoderPool(FF_ENCODER_MJPEG, { maxSize: this.maxCacheSize, flags: AV_CODEC_FLAG_QSCALE });
+        return this.jpegPool;
+    }
+    /**
+     * The lazily created PNG encoder pool.
+     *
+     * @returns The PNG encoder pool
+     *
+     * @internal
+     */
+    getPngPool() {
+        this.pngPool ??= new EncoderPool(FF_ENCODER_PNG, { maxSize: this.maxCacheSize });
+        return this.pngPool;
+    }
+    /**
+     * Build a crop+scale+convert graph.
+     *
+     * For software frames this is `crop,scale,format`. For hardware frames the crop
+     * filter sets crop metadata that the hardware scaler (scale_vt/scale_cuda/
+     * scale_vaapi) applies on the GPU; the result is kept in NV12, downloaded, and
+     * converted on the CPU. When `commandable` the crop is a labeled instance
+     * (`crop@sc`) whose initial region is `crop` but which is re-aimed per frame via
+     * `sendCommand`. Otherwise (OpenCL) the crop is fixed in the graph.
+     *
+     * @param isHw - Whether the input is a hardware frame
+     *
+     * @param outW - Output width
+     *
+     * @param outH - Output height
+     *
+     * @param format - Output pixel format
+     *
+     * @param crop - Initial crop region
+     *
+     * @param commandable - Whether the crop can be reconfigured at runtime
+     *
+     * @returns Filtergraph description
+     *
+     * @internal
+     */
+    buildGraph(isHw, outW, outH, format, crop, commandable) {
+        let chain = FilterPreset.chain(isHw ? this.hardware : undefined);
+        if (commandable) {
+            // Labeled crop so sendCommand('crop@sc', ...) can re-aim it per frame.
+            chain = chain.custom(`crop@sc=${crop.width}:${crop.height}:${crop.x}:${crop.y}`);
+        }
+        else {
+            chain = chain.crop(crop.width, crop.height, crop.x, crop.y);
+        }
+        chain = chain.scale(outW, outH);
+        if (isHw) {
+            // Keep the GPU result in NV12, download the small frame, then convert on CPU.
+            chain = chain.scaleFormat(AV_PIX_FMT_NV12).hwdownload().format(AV_PIX_FMT_NV12);
+            if (format !== 'nv12') {
+                chain = chain.format(FORMAT_TO_PIXFMT[format]);
+            }
+        }
+        else {
+            chain = chain.format(FORMAT_TO_PIXFMT[format]);
+        }
+        return chain.build();
+    }
+    /**
+     * Insert a graph, evicting the least-recently-used entry if over capacity.
+     *
+     * @param key - Operation-configuration key
+     *
+     * @param entry - Graph entry to cache
+     *
+     * @internal
+     */
+    cacheSet(key, entry) {
+        this.graphs.set(key, entry);
+        while (this.graphs.size > this.maxCacheSize) {
+            const oldest = this.graphs.keys().next().value;
+            if (oldest === undefined) {
+                break;
+            }
+            this.graphs.get(oldest)?.filter[Symbol.dispose]();
+            this.graphs.delete(oldest);
+        }
+    }
+    /**
+     * Dispose of the scaler (for `using` statements).
+     *
+     * @example
+     * ```typescript
+     * using scaler = new Scaler();
+     * // ... use scaler ...
+     * // automatically disposed at end of scope
+     * ```
+     */
+    [Symbol.dispose]() {
+        this.close();
+    }
+}
+//# sourceMappingURL=scaler.js.map

package/dist/api/scaler.js.map

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

package/dist/api/utilities/async-queue.d.ts

@@ -25,12 +25,17 @@ export declare class AsyncQueue<T> {
     private maxSize;
     private closed;
     private error;
+    private disposeItem?;
     /**
      * Creates a new AsyncQueue.
      *
      * @param maxSize Maximum number of items in queue before send() blocks
+     *
+     * @param disposeItem Optional disposer for items still buffered at teardown
+     *   (see {@link clear}). Pass `(item) => item.free()` for queues of owned
+     *   native resources (Frame/Packet) so aborted pipelines don't leak them.
      */
-    constructor(maxSize: number);
+    constructor(maxSize: number, disposeItem?: (item: T) => void);
     /**
      * Current number of items in the queue.
      */
@@ -117,4 +122,25 @@ export declare class AsyncQueue<T> {
      * ```
      */
     closeWithError(error: Error): void;
+    /**
+     * Drop and dispose any items still buffered in the queue.
+     *
+     * Call during final teardown (a component's `close()`, after the worker and
+     * consumer tasks have settled) to deterministically free items that were
+     * produced but never consumed - e.g. when a pipeline is aborted before
+     * draining. Without this they are only reclaimed by GC, which for hardware
+     * frames pins GPU/hwframe memory in the meantime.
+     *
+     * Items are owned by the queue (the consumer frees what it receives), so
+     * disposing buffered items here cannot double-free. Do NOT call this while a
+     * consumer may still drain the queue after `close()` (the flush path relies on
+     * that) - only at final teardown.
+     *
+     * @example
+     * ```typescript
+     * this.outputQueue.close();
+     * this.outputQueue.clear(); // free anything left behind on abort
+     * ```
+     */
+    clear(): void;
 }