@camstack/system 1.0.2

package/dist/builtins/platform-probe/hardware-decode-accel-probe.d.ts

@@ -0,0 +1,37 @@
+import { HardwareDecodeAccels, IScopedLogger } from '@camstack/types';
+/**
+ * Injectable runner for `ffmpeg -hwaccels`. Defaults to a real `execFile`;
+ * tests pass a fake to assert behaviour without spawning ffmpeg.
+ */
+export type HwAccelExecFn = (ffmpegPath: string, args: readonly string[]) => Promise<{
+    stdout: string;
+}>;
+/**
+ * Parse the output of `ffmpeg -hwaccels`. The listing looks like:
+ *
+ *   Hardware acceleration methods:
+ *   videotoolbox
+ *
+ * The header line is dropped; remaining non-empty trimmed lines are the
+ * method names, lowercased and de-duplicated (order preserved).
+ */
+export declare function parseHwAccelsOutput(stdout: string): string[];
+/**
+ * Probes which `-hwaccel` decode backends the configured ffmpeg binary
+ * supports. Mirrors {@link HardwareEncoderProber} (configured binary, cached,
+ * single-flight, forceable). Never throws: a probe failure yields an empty
+ * method list so callers fall back to software decode.
+ */
+export declare class HardwareDecodeAccelProber {
+    private cached;
+    private inflight;
+    private readonly logger;
+    private readonly ffmpegPath;
+    private readonly execFn;
+    constructor(logger: IScopedLogger, ffmpegPath?: string, execFn?: HwAccelExecFn);
+    getCached(): HardwareDecodeAccels | null;
+    probe(options?: {
+        readonly force?: boolean;
+    }): Promise<HardwareDecodeAccels>;
+    private runProbe;
+}

package/dist/builtins/platform-probe/hardware-encoder-probe.d.ts

@@ -0,0 +1,13 @@
+import { HardwareInfo, HardwareEncoders, IScopedLogger } from '@camstack/types';
+export declare class HardwareEncoderProber {
+    private cached;
+    private inflight;
+    private readonly logger;
+    private readonly ffmpegPath;
+    constructor(logger: IScopedLogger, ffmpegPath?: string);
+    getCached(): HardwareEncoders | null;
+    probe(hardware: HardwareInfo, options?: {
+        readonly force?: boolean;
+    }): Promise<HardwareEncoders>;
+    private runProbe;
+}

package/dist/builtins/platform-probe/index.d.ts

@@ -0,0 +1,22 @@
+import { ProviderRegistration, BaseAddon } from '@camstack/types';
+export { PlatformScorer } from './platform-scorer.js';
+export { InferenceConfigResolver } from './inference-config-resolver.js';
+export { HardwareEncoderProber } from './hardware-encoder-probe.js';
+export { HardwareDecodeAccelProber } from './hardware-decode-accel-probe.js';
+export declare class PlatformProbeNativeAddon extends BaseAddon {
+    private scorer;
+    private encoderProber;
+    private decodeAccelProber;
+    private cachedCaps;
+    constructor();
+    /**
+     * Resolve the ffmpeg binary the encoder probe should test, from the cluster
+     * `ffmpeg` config section (`binaryPath`). The probe MUST exercise the same
+     * binary the broker/recorder spawn, or it may report encoders for a different
+     * ffmpeg. Defaults to PATH `ffmpeg` on any miss.
+     */
+    private resolveFfmpegBinaryPath;
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    protected onShutdown(): Promise<void>;
+}
+export default PlatformProbeNativeAddon;