@nonstrict/recordkit 0.87.2 → 0.97.0

package/out/Recorder.js

@@ -41,6 +41,21 @@ function convertRPCParamsToAudioStreamBuffer(params) {
         return null;
     }
 }
+/**
+ * Registers the per-segment callback of a {@link JSONOutputOptions} (if any) as an RPC closure,
+ * replacing the function with the closure target so the options object can be serialized.
+ * @internal
+ */
+function registerJSONOutputSegmentCallback(output, rpc, object, prefix) {
+    if (output && output.output == 'segmented' && output.segmentCallback) {
+        const segmentHandler = output.segmentCallback;
+        output.segmentCallback = rpc.registerClosure({
+            handler: (params) => { segmentHandler(params.path); },
+            prefix,
+            lifecycle: object
+        });
+    }
+}
 /**
  * @group Recording
  */
@@ -80,6 +95,7 @@ export class Recorder extends EventEmitter {
                         lifecycle: object
                     });
                 }
+                registerJSONOutputSegmentCallback(item.inputEventsOutput, rpc, object, 'Display.onInputEventsSegment');
             }
             if (item.type == 'windowBasedCrop') {
                 if (typeof item.window != 'number') {
@@ -93,6 +109,21 @@ export class Recorder extends EventEmitter {
                         lifecycle: object
                     });
                 }
+                registerJSONOutputSegmentCallback(item.inputEventsOutput, rpc, object, 'WindowBasedCrop.onInputEventsSegment');
+            }
+            if (item.type == 'desktopIndependentWindow') {
+                if (typeof item.window != 'number') {
+                    item.window = item.window.id;
+                }
+                if (item.output == 'segmented' && item.segmentCallback) {
+                    const segmentHandler = item.segmentCallback;
+                    item.segmentCallback = rpc.registerClosure({
+                        handler: (params) => { segmentHandler(params.path); },
+                        prefix: 'DesktopIndependentWindow.onSegment',
+                        lifecycle: object
+                    });
+                }
+                registerJSONOutputSegmentCallback(item.inputEventsOutput, rpc, object, 'DesktopIndependentWindow.onInputEventsSegment');
             }
             if (item.type == 'appleDeviceStaticOrientation') {
                 if (typeof item.device != 'string') {
@@ -183,10 +214,15 @@ export class Recorder extends EventEmitter {
             prefix: 'Recorder.onAbort',
             lifecycle: object
         });
+        const onSignalsChangedInstance = rpc.registerClosure({
+            handler: (params) => { weakRefObject.deref()?.emit('signals', params.signals); },
+            prefix: 'Recorder.onSignalsChanged',
+            lifecycle: object
+        });
         await rpc.initialize({
             target,
             type: 'Recorder',
-            params: { schema, onAbortInstance },
+            params: { schema, onAbortInstance, onSignalsChangedInstance },
             lifecycle: object
         });
         return object;
@@ -197,15 +233,57 @@ export class Recorder extends EventEmitter {
         this.rpc = rpc;
         this.target = target;
     }
+    /**
+     * Prepares the recording session for instant recording, allocating resources and validating the
+     * configuration.
+     *
+     * Preparing ahead of time lets {@link start} begin recording instantly; without it, starting incurs
+     * a setup delay.
+     *
+     * @returns The expected {@link BundleInfo} describing the file assets that will be produced by this
+     * recording, allowing you to inspect the planned output (filenames, asset types, sizes) before
+     * recording starts.
+     */
     async prepare() {
-        await this.rpc.perform({ target: this.target, action: 'prepare' });
+        return await this.rpc.perform({ target: this.target, action: 'prepare' });
     }
+    /**
+     * Starts recording. If the session was not already {@link prepare}d this performs setup first,
+     * incurring a short delay; call {@link prepare} ahead of time to start instantly.
+     */
     async start() {
         await this.rpc.perform({ target: this.target, action: 'start' });
     }
+    /**
+     * Pauses the recording. The capture hardware remains active so recording can be resumed quickly.
+     *
+     * Call {@link resume} to continue recording, or {@link stop} to finish.
+     */
+    async pause() {
+        await this.rpc.perform({ target: this.target, action: 'pause' });
+    }
+    /**
+     * Resumes a recording that was previously paused with {@link pause}.
+     */
+    async resume() {
+        await this.rpc.perform({ target: this.target, action: 'resume' });
+    }
+    /**
+     * Stops the recording, finalizes the output files, and returns the {@link RecordingResult}
+     * describing the completed bundle. The recorder cannot be reused after stopping.
+     *
+     * @remarks Known limitation: when the recording failed, the returned promise rejects with the
+     * failure but the partial recording result is not available over the RPC bridge (the Swift API
+     * surfaces it as `PartialResultError`). Any partially-written files do remain on disk in the
+     * bundle inside the schema's `output_directory`.
+     */
     async stop() {
         return await this.rpc.perform({ target: this.target, action: 'stop' });
     }
+    /**
+     * Cancels the recording and releases its resources without finalizing output. Use this to discard
+     * an in-progress or prepared recording; call {@link stop} instead to keep the result.
+     */
     async cancel() {
         await this.rpc.manualRelease(this.target);
     }

package/out/Recorder.js.map

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

package/out/RecordingMetadata.d.ts

@@ -0,0 +1,96 @@
+import type { EventTime } from './InputEvents.js';
+/**
+ * Presence of a window at a point in time within a recording.
+ *
+ * Encoded as a flat object discriminated by `type`. Mirrors the Swift
+ * `RKWindowPresence` enum.
+ *
+ * @remarks
+ * The `present` member ({@link WindowInfo}) carries the window's position,
+ * size and identifying metadata at that moment; the `absent` member
+ * ({@link WindowAbsence}) marks a time at which the tracked window was not
+ * present (e.g. closed, minimized, or moved to another Space).
+ *
+ * @group Recording
+ */
+export type WindowPresence = WindowInfo | WindowAbsence;
+/**
+ * Information about a window that is present at a point in time within a recording.
+ *
+ * Mirrors the Swift `RKWindowInfo` struct (the `present` case of
+ * `RKWindowPresence`).
+ *
+ * @group Recording
+ */
+export interface WindowInfo {
+    type: 'present';
+    /** Time the event occurred in the recording. */
+    time: EventTime;
+    /** ID of the window. */
+    windowID: number;
+    /** Title of the window. */
+    windowTitle?: string;
+    /**
+     * ID of the macOS Space where this window lives (can be used to detect space changes).
+     *
+     * @remarks Mirrors a Swift `UInt64`; for very large Space IDs this can exceed JavaScript's
+     * `Number.MAX_SAFE_INTEGER`. ({@link WindowInfo.windowID} and {@link WindowInfo.applicationID}
+     * are 32-bit and not affected.)
+     */
+    spaceID?: number;
+    /** ID of the application the window belongs to. */
+    applicationID?: number;
+    /** Title of the application the window belongs to. */
+    applicationName?: string;
+    /** X-axis position of the window relative to the top left of recorded area, ranging from 0 to 1. */
+    x: number;
+    /** Y-axis position of the window relative to the top left of recorded area, ranging from 0 to 1. */
+    y: number;
+    /** Width of the window relative to the top left of recorded area, ranging from 0 to 1. */
+    width: number;
+    /** Height of the window relative to the top left of recorded area, ranging from 0 to 1. */
+    height: number;
+}
+/**
+ * Marks the absence of a window at a point in time within a recording.
+ *
+ * Mirrors the Swift `RKWindowAbsence` struct (the `absent` case of
+ * `RKWindowPresence`).
+ *
+ * @group Recording
+ */
+export interface WindowAbsence {
+    type: 'absent';
+    /** Time the event occurred in the recording. */
+    time: EventTime;
+}
+/**
+ * An event representing a video dimension change during recording.
+ * This can be caused by device rotation or other content size changes.
+ *
+ * Mirrors the Swift `RKVideoDimensionChange` struct.
+ *
+ * @group Recording
+ */
+export interface VideoDimensionChange {
+    /** Time the dimension change occurred in the recording. */
+    time: EventTime;
+    /** The original (pre-rotation) dimensions of the content, in pixels. */
+    dimensions: {
+        /** Content width in pixels. */
+        width: number;
+        /** Content height in pixels. */
+        height: number;
+    };
+    /**
+     * The rotation in degrees (0, 90, 180, or -90) that a player should apply to display
+     * this segment correctly. Positive values are clockwise, negative are counterclockwise.
+     */
+    rotation: number;
+    /**
+     * Whether the player should animate the transition to this rotation.
+     * `true` when device rotated during continuous recording.
+     * `false` at recording start or after pause/resume (instant change).
+     */
+    animated: boolean;
+}

package/out/RecordingMetadata.js

@@ -0,0 +1,12 @@
+// TypeScript mirrors of the Swift `Codable` types whose JSON is written to sidecar files inside a
+// RecordKit recording bundle. Consumers parse those JSON files and rely on these types to describe
+// their shape: property names are verbatim camelCase, Swift optionals become optional properties,
+// and Swift tagged-union enums encode as flat objects discriminated by a `type` field at the same
+// level as the payload.
+//
+// Keep this file in sync with the corresponding Swift sources:
+// - `RKWindowPresence.swift`
+// - `RKVideoDimensionChange.swift`
+// (The `RKBundleInfo` mirror, `BundleInfo`, lives in `Recorder.ts`.)
+export {};
+//# sourceMappingURL=RecordingMetadata.js.map

package/out/RecordingMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingMetadata.js","sourceRoot":"","sources":["../src/RecordingMetadata.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,mGAAmG;AACnG,kGAAkG;AAClG,kGAAkG;AAClG,wBAAwB;AACxB,EAAE;AACF,+DAA+D;AAC/D,6BAA6B;AAC7B,mCAAmC;AACnC,qEAAqE"}

package/out/WebAudioUtils.d.ts

@@ -29,3 +29,38 @@ import { AudioStreamBuffer } from './Recorder.js';
  * ```
  */
 export declare function createWebAudioBuffer(audioStreamBuffer: AudioStreamBuffer, audioContext: AudioContext): AudioBuffer | null;
+/**
+ * An audio level measurement, as returned by {@link computeAudioLevel}.
+ *
+ * @group Recording
+ */
+export interface AudioLevel {
+    /** Root-mean-square (average) amplitude across all channels. Usually in `[0, 1]`, but can exceed `1` for hot or clipped signals. */
+    rms: number;
+    /** Peak absolute amplitude across all channels. Usually in `[0, 1]`, but can exceed `1` for hot or clipped signals. */
+    peak: number;
+    /** {@link AudioLevel.rms} in decibels relative to full scale (0 dBFS). `-Infinity` for silence; can exceed `0` for clipped signals. */
+    rmsDb: number;
+    /** {@link AudioLevel.peak} in decibels relative to full scale (0 dBFS). `-Infinity` for silence; can exceed `0` for clipped signals. */
+    peakDb: number;
+}
+/**
+ * Computes RMS and peak audio levels from an {@link AudioStreamBuffer}, for rendering a microphone (or
+ * system-audio) level meter.
+ *
+ * Electron has no dedicated microphone-preview component; the supported way to render a live level meter
+ * is to use a microphone/system-audio `stream` output and call this helper in your `streamCallback`.
+ *
+ * @example
+ * ```typescript
+ * import { computeAudioLevel } from '@nonstrict/recordkit';
+ *
+ * const streamCallback = (audioBuffer) => {
+ *   const { peakDb } = computeAudioLevel(audioBuffer);
+ *   meterElement.style.height = `${Math.max(0, 100 + peakDb)}%`; // -100 dB..0 dB -> 0%..100%
+ * };
+ * ```
+ *
+ * @group Recording
+ */
+export declare function computeAudioLevel(audioStreamBuffer: AudioStreamBuffer): AudioLevel;

package/out/WebAudioUtils.js

@@ -92,4 +92,41 @@ export function createWebAudioBuffer(audioStreamBuffer, audioContext) {
         return null;
     }
 }
+/**
+ * Computes RMS and peak audio levels from an {@link AudioStreamBuffer}, for rendering a microphone (or
+ * system-audio) level meter.
+ *
+ * Electron has no dedicated microphone-preview component; the supported way to render a live level meter
+ * is to use a microphone/system-audio `stream` output and call this helper in your `streamCallback`.
+ *
+ * @example
+ * ```typescript
+ * import { computeAudioLevel } from '@nonstrict/recordkit';
+ *
+ * const streamCallback = (audioBuffer) => {
+ *   const { peakDb } = computeAudioLevel(audioBuffer);
+ *   meterElement.style.height = `${Math.max(0, 100 + peakDb)}%`; // -100 dB..0 dB -> 0%..100%
+ * };
+ * ```
+ *
+ * @group Recording
+ */
+export function computeAudioLevel(audioStreamBuffer) {
+    let sumSquares = 0;
+    let peak = 0;
+    let count = 0;
+    for (const channel of audioStreamBuffer.channelData) {
+        for (let i = 0; i < channel.length; i++) {
+            const sample = channel[i];
+            sumSquares += sample * sample;
+            const abs = Math.abs(sample);
+            if (abs > peak)
+                peak = abs;
+            count++;
+        }
+    }
+    const rms = count > 0 ? Math.sqrt(sumSquares / count) : 0;
+    const toDb = (value) => value > 0 ? 20 * Math.log10(value) : -Infinity;
+    return { rms, peak, rmsDb: toDb(rms), peakDb: toDb(peak) };
+}
 //# sourceMappingURL=WebAudioUtils.js.map

package/out/WebAudioUtils.js.map

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

package/out/WindowLevels.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Named macOS window levels, mirroring RecordKit's `RKWindow.Level` Swift type.
+ *
+ * A {@link Window}'s `level` is a raw integer. macOS assigns windows to a small set of well-known
+ * levels; this map lets you compare a window's level against those named values, e.g.
+ *
+ * ```ts
+ * if (window.level === WINDOW_LEVELS.floating) { ... }
+ * if (window.level >= WINDOW_LEVELS.mainMenu) { ... } // at or above the menu bar
+ * ```
+ *
+ * Levels are `Comparable` in Swift: a higher number is drawn in front of a lower one. Some names
+ * share the same numeric value (e.g. `floating`, `submenu`, `tornOffMenu` are all `3`).
+ *
+ * @group Discovery
+ */
+export declare const WINDOW_LEVELS: {
+    readonly baseWindow: -2147483648;
+    readonly minimumWindow: -2147483643;
+    readonly desktopWindow: -2147483623;
+    readonly desktopIconWindow: -2147483603;
+    readonly backstopMenu: -20;
+    readonly normal: 0;
+    readonly floating: 3;
+    readonly submenu: 3;
+    readonly tornOffMenu: 3;
+    readonly modalPanel: 8;
+    readonly utilityWindow: 19;
+    readonly mainMenu: 24;
+    readonly statusBar: 25;
+    readonly popUpMenu: 101;
+    readonly overlayWindow: 102;
+    readonly helpWindow: 200;
+    readonly draggingWindow: 500;
+    readonly screenSaver: 1000;
+    readonly screenSaverWindow: 1000;
+    readonly assistiveTechHighWindow: 1500;
+    readonly cursorWindow: 2147483630;
+    readonly maximumWindow: 2147483631;
+};
+/**
+ * The name of a well-known macOS window level. See {@link WINDOW_LEVELS}.
+ *
+ * @group Discovery
+ */
+export type WindowLevelName = keyof typeof WINDOW_LEVELS;

package/out/WindowLevels.js

@@ -0,0 +1,41 @@
+/**
+ * Named macOS window levels, mirroring RecordKit's `RKWindow.Level` Swift type.
+ *
+ * A {@link Window}'s `level` is a raw integer. macOS assigns windows to a small set of well-known
+ * levels; this map lets you compare a window's level against those named values, e.g.
+ *
+ * ```ts
+ * if (window.level === WINDOW_LEVELS.floating) { ... }
+ * if (window.level >= WINDOW_LEVELS.mainMenu) { ... } // at or above the menu bar
+ * ```
+ *
+ * Levels are `Comparable` in Swift: a higher number is drawn in front of a lower one. Some names
+ * share the same numeric value (e.g. `floating`, `submenu`, `tornOffMenu` are all `3`).
+ *
+ * @group Discovery
+ */
+export const WINDOW_LEVELS = {
+    baseWindow: -2147483648,
+    minimumWindow: -2147483643,
+    desktopWindow: -2147483623,
+    desktopIconWindow: -2147483603,
+    backstopMenu: -20,
+    normal: 0,
+    floating: 3,
+    submenu: 3,
+    tornOffMenu: 3,
+    modalPanel: 8,
+    utilityWindow: 19,
+    mainMenu: 24,
+    statusBar: 25,
+    popUpMenu: 101,
+    overlayWindow: 102,
+    helpWindow: 200,
+    draggingWindow: 500,
+    screenSaver: 1000,
+    screenSaverWindow: 1000,
+    assistiveTechHighWindow: 1500,
+    cursorWindow: 2147483630,
+    maximumWindow: 2147483631,
+};
+//# sourceMappingURL=WindowLevels.js.map

package/out/WindowLevels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowLevels.js","sourceRoot":"","sources":["../src/WindowLevels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,CAAC,UAAU;IACvB,aAAa,EAAE,CAAC,UAAU;IAC1B,aAAa,EAAE,CAAC,UAAU;IAC1B,iBAAiB,EAAE,CAAC,UAAU;IAC9B,YAAY,EAAE,CAAC,EAAE;IACjB,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,EAAE;IACjB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,GAAG;IACd,aAAa,EAAE,GAAG;IAClB,UAAU,EAAE,GAAG;IACf,cAAc,EAAE,GAAG;IACnB,WAAW,EAAE,IAAI;IACjB,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,IAAI;IAC7B,YAAY,EAAE,UAAU;IACxB,aAAa,EAAE,UAAU;CACjB,CAAC"}

package/out/browser.d.ts

@@ -1,2 +1,9 @@
-export { createWebAudioBuffer } from './WebAudioUtils.js';
+export { createWebAudioBuffer, computeAudioLevel } from './WebAudioUtils.js';
 export type { AudioStreamBuffer } from './Recorder.js';
+export type { AudioLevel } from './WebAudioUtils.js';
+export type * from './InputEvents.js';
+export type * from './RecordingMetadata.js';
+export type * from './Errors.js';
+export type * from './WindowLevels.js';
+export { RECORDKIT_ERROR_CODE_NUMBERS } from './Errors.js';
+export { WINDOW_LEVELS } from './WindowLevels.js';

package/out/browser.js

@@ -1,4 +1,6 @@
 // Browser-only exports - safe for use in browser environments
 // This entry point excludes Node.js-specific functionality like EventEmitter, crypto, etc.
-export { createWebAudioBuffer } from './WebAudioUtils.js';
+export { createWebAudioBuffer, computeAudioLevel } from './WebAudioUtils.js';
+export { RECORDKIT_ERROR_CODE_NUMBERS } from './Errors.js';
+export { WINDOW_LEVELS } from './WindowLevels.js';
 //# sourceMappingURL=browser.js.map

package/out/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2FAA2F;AAE3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2FAA2F;AAE3F,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAY7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}