meeting-record 0.0.0-stage → 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hoang Vo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# meeting-record for Node.js
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Full documentation](https://github.com/hoangvvo/meeting-record#readme)
+
+## Install
+
+```sh
+npm install meeting-record
+```
+
+## Usage
+
+```ts
+import * as MeetingRecord from "meeting-record";
+
+// Request system audio permission to record the whole system mix.
+await MeetingRecord.permissions.request("system-audio");
+// Request microphone permission to record the user voice.
+await MeetingRecord.permissions.request("microphone");
+// Request accessibility permission to read meeting titles and URLs for detection.
+await MeetingRecord.permissions.request("accessibility");
+
+// Watch for meetings starting, changing, and ending.
+MeetingRecord.meetings.on("started", (meeting) => {
+  console.log("meeting started", meeting);
+});
+MeetingRecord.meetings.on("updated", (meeting) => {
+  console.log("meeting updated", meeting);
+});
+MeetingRecord.meetings.on("ended", (meeting) => {
+  console.log("meeting ended", meeting);
+});
+MeetingRecord.meetings.watch();
+
+// Or scan for active meetings at any time.
+const meeting = MeetingRecord.meetings.scan().find((item) => item.shouldRecord);
+if (!meeting) throw new Error("no active meeting");
+
+// Start recording the meeting process and its audio helpers.
+// Use `{ type: "system" }` instead to record the whole system mix.
+const recording = await MeetingRecord.capture.start(
+  { type: "process", pid: meeting.pid },
+  { microphone: "default" },
+);
+
+recording.on("interrupted", () => console.warn("audio device changed; recovering"));
+recording.on("recovered", () => console.log("capture recovered"));
+recording.on("failed", (error) => console.error("capture failed", error));
+
+// Process captured application or system audio.
+recording.systemAudio.on("data", (chunk) => {
+  console.log(chunk.length, chunk.hostTimeNs, chunk.sampleRate, chunk.channels);
+});
+recording.systemAudio.on("drop", (samples) => console.warn("dropped", samples));
+recording.systemAudio.on("format", (format) => console.log("new format", format));
+
+// Process the microphone track if requested.
+recording.microphone?.on("data", (chunk) => {
+  console.log(chunk.length, chunk.hostTimeNs, chunk.sampleRate, chunk.channels);
+});
+
+await new Promise((resolve) => setTimeout(resolve, 10_000));
+await recording.stopRecording();
+
+// Stop watching for meetings when done.
+MeetingRecord.meetings.unwatch();
+```
+
+## Audio apps
+
+`meetings.audioApps()` lists owning applications for a source picker. Pass an entry's `pid` to `capture.start()`; no meeting scan or Accessibility grant is needed.
+
+Windows targets include future child processes. macOS targets include current audio helpers; restart capture if helpers are replaced.
+
+## Mixed output
+
+```ts
+const recording = await MeetingRecord.capture.start(
+  { type: "system" },
+  { microphone: "default", mix: { sampleRate: 24_000 } },
+);
+recording.mixedAudio.pipe(destination);
+recording.mixedAudio.on("level", (rms) => console.log(rms));
+recording.mixedAudio.setMicrophoneMuted(true);
+```
+
+`mixedAudio` is mono s16le. Pause/resume excludes paused time; await its `end` event after stopping to consume the final tail. Raw tracks remain float32. Mixing does not perform echo cancellation.
+
+Pass an `AbortSignal` to `capture.start()` to stop capture on cancellation, or to `permissions.request()` to cancel waiting for a grant.
+
+## License
+
+[MIT](./LICENSE.md) © Hoang Vo

package/dist/index.d.ts

@@ -0,0 +1,179 @@
+/**
+ * meeting-record — system-audio and microphone capture with meeting detection.
+ *
+ * Wraps the native addon so callers never see helper-process pids, status codes,
+ * or the realtime callback. The addon itself is not re-exported.
+ */
+import { EventEmitter } from "node:events";
+import { Readable } from "node:stream";
+import { type MixedAudio, type MixedAudioOptions } from "./mixed-audio.js";
+export type { MixedAudio, MixedAudioOptions } from "./mixed-audio.js";
+export type Permission = "system-audio" | "microphone" | "accessibility";
+export type PermissionStatus = "granted" | "denied" | "unknown" | "not-required";
+/**
+ * Stable platform identifier; the values never change. No display labels are
+ * provided — presentation and localisation belong to the caller.
+ */
+export type Platform = "zoom" | "teams" | "meet" | "webex" | "slack" | "discord"
+/** A browser tab on a recognised call URL. */
+ | "browser" | "unknown";
+export interface Meeting {
+    readonly platform: Platform;
+    /** The visible app. Use it in `CaptureTarget` when starting capture. */
+    readonly pid: number;
+    readonly appName: string;
+    /** Requires the accessibility permission; empty string otherwise. */
+    readonly title: string;
+    /** Requires the accessibility permission; empty string otherwise. */
+    readonly url: string;
+    readonly isUsingMic: boolean;
+    readonly isPlayingAudio: boolean;
+    readonly confidence: number;
+    /** Prefer this to comparing `confidence`; the weights may change. */
+    readonly shouldRecord: boolean;
+}
+export interface AudioProcess {
+    readonly pid: number;
+    readonly name: string;
+    readonly bundleId: string;
+    readonly isPlayingAudio: boolean;
+    readonly isUsingMic: boolean;
+}
+export type CaptureTarget = {
+    /** A detected meeting's app pid, or any audio-producing process pid. */
+    type: "process";
+    pid: number;
+} | {
+    /** All application output. */
+    type: "system";
+};
+export type MicrophoneSource = "default";
+export interface CaptureOptions {
+    /** Mono mixdown for system audio. Default true. */
+    mono?: boolean;
+    /** Capture the default microphone as a separate track. Default off. */
+    microphone?: MicrophoneSource;
+    /** Additional mono s16le output, aligned and resampled to the requested rate. */
+    mix?: MixedAudioOptions;
+    /** Aborting stops capture, including a pending start. */
+    signal?: AbortSignal;
+}
+export declare class MeetingRecordError extends Error {
+    readonly code: number;
+    constructor(message: string, code: number);
+}
+export declare class UnsupportedOsError extends MeetingRecordError {
+}
+export declare class PermissionError extends MeetingRecordError {
+}
+export declare class AlreadyRunningError extends MeetingRecordError {
+}
+export declare class CaptureError extends MeetingRecordError {
+}
+export declare class InternalError extends MeetingRecordError {
+}
+export declare const permissions: {
+    status(permission: Permission): PermissionStatus;
+    /**
+     * Show the permission prompt and resolve once the user answers.
+     *
+     * Accessibility opens System Settings and needs an app relaunch, so it resolves
+     * as soon as Settings is open.
+     */
+    request(permission: Permission, { timeoutMs, signal }?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<PermissionStatus>;
+};
+export interface MeetingEvents {
+    started: (meeting: Meeting) => void;
+    updated: (meeting: Meeting) => void;
+    ended: (meeting: Meeting) => void;
+}
+declare class Meetings extends EventEmitter {
+    /** Point-in-time scan, highest confidence first. */
+    scan(): Meeting[];
+    /** Begin emitting `started` / `updated` / `ended`. */
+    watch(): void;
+    unwatch(): void;
+    get watching(): boolean;
+    /** Every process doing audio IO. */
+    audioProcesses(): AudioProcess[];
+    /**
+     * Applications doing audio IO, grouped by owning PID, including helpers.
+     * Pass `pid` as a process target; no meeting scan or Accessibility grant is needed.
+     */
+    audioApps(): AudioProcess[];
+}
+export declare const meetings: Meetings & {
+    on<E extends keyof MeetingEvents>(event: E, listener: MeetingEvents[E]): Meetings;
+    once<E extends keyof MeetingEvents>(event: E, listener: MeetingEvents[E]): Meetings;
+    off<E extends keyof MeetingEvents>(event: E, listener: MeetingEvents[E]): Meetings;
+};
+/**
+ * Interleaved float32 PCM.
+ *
+ * The native callback never waits for a slow consumer. If this stream is not read,
+ * its preallocated ring buffer drops samples and emits `drop`.
+ */
+export type CaptureState = "recording" | "paused" | "stopped";
+export type CaptureHealth = "running" | "recovering" | "failed" | "stopped";
+export interface AudioFormat {
+    readonly sampleRate: number;
+    readonly channels: number;
+}
+/**
+ * A PCM buffer with the capture time of its first frame.
+ *
+ * `hostTimeNs` is monotonic (not Unix time) and uses the same host clock for the
+ * system and microphone tracks, so callers can align or echo-cancel them without
+ * relying on callback arrival order.
+ */
+export interface AudioChunk extends Buffer {
+    readonly hostTimeNs: bigint;
+    readonly frameCount: number;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly droppedSamples: number;
+}
+export interface AudioTrack extends Readable {
+    /** Current negotiated format; a `format` event announces changes. */
+    readonly sampleRate: number;
+    readonly channels: number;
+    /** Interleaved samples discarded because the bounded queue could not accept them. */
+    readonly droppedSamples: number;
+    on(event: "data", listener: (chunk: AudioChunk) => void): this;
+    on(event: "drop", listener: (droppedSamples: number) => void): this;
+    /** Emitted before the first chunk in a newly negotiated device format. */
+    on(event: "format", listener: (format: AudioFormat) => void): this;
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+export interface CaptureSession extends EventEmitter {
+    readonly systemAudio: AudioTrack;
+    readonly microphone?: AudioTrack;
+    readonly mixedAudio?: MixedAudio;
+    readonly state: CaptureState;
+    /** Native device health; independent of pause/resume state. */
+    readonly health: CaptureHealth;
+    /** Set when automatic recovery exhausts its retries. */
+    readonly failure?: CaptureError;
+    pauseRecording(): void;
+    resumeRecording(): void;
+    stopRecording(): Promise<void>;
+    on(event: "interrupted", listener: () => void): this;
+    on(event: "recovered", listener: () => void): this;
+    on(event: "failed", listener: (error: CaptureError) => void): this;
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+export interface MixedCaptureSession extends CaptureSession {
+    readonly mixedAudio: MixedAudio;
+}
+declare function startCapture(target: CaptureTarget, options: CaptureOptions & {
+    mix: MixedAudioOptions;
+}): Promise<MixedCaptureSession>;
+declare function startCapture(target: CaptureTarget, options?: CaptureOptions): Promise<CaptureSession>;
+export declare const capture: {
+    start: typeof startCapture;
+    readonly running: boolean;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOtE,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,eAAe,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,CAAC;AAEjF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,SAAS;AACX,8CAA8C;GAC5C,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GACrB;IACE,wEAAwE;IACxE,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE,8BAA8B;IAC9B,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,iFAAiF;IACjF,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,yDAAyD;IACzD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADrB,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,MAAM;CAKxB;AAED,qBAAa,kBAAmB,SAAQ,kBAAkB;CAAG;AAC7D,qBAAa,eAAgB,SAAQ,kBAAkB;CAAG;AAC1D,qBAAa,mBAAoB,SAAQ,kBAAkB;CAAG;AAC9D,qBAAa,YAAa,SAAQ,kBAAkB;CAAG;AACvD,qBAAa,aAAc,SAAQ,kBAAkB;CAAG;AA4BxD,eAAO,MAAM,WAAW;uBACH,UAAU,GAAG,gBAAgB;IAahD;;;;;OAKG;wBAEW,UAAU,0BACW;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC5E,OAAO,CAAC,gBAAgB,CAAC;CA4B7B,CAAC;AAMF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,cAAM,QAAS,SAAQ,YAAY;IACjC,oDAAoD;IACpD,IAAI,IAAI,OAAO,EAAE;IAIjB,sDAAsD;IACtD,KAAK,IAAI,IAAI;IAQb,OAAO,IAAI,IAAI;IAIf,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,oCAAoC;IACpC,cAAc,IAAI,YAAY,EAAE;IAIhC;;;OAGG;IACH,SAAS,IAAI,YAAY,EAAE;CAG5B;AAED,eAAO,MAAM,QAAQ,EAAqB,QAAQ,GAAG;IACnD,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;IAClF,IAAI,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;IACpF,GAAG,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;CACpF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACpE,0EAA0E;IAC1E,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;IACnE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,cAAc,IAAI,IAAI,CAAC;IACvB,eAAe,IAAI,IAAI,CAAC;IACxB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACrD,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnD,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACnE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAoMD,iBAAS,YAAY,CACnB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,iBAAiB,CAAA;CAAE,GACnD,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAChC,iBAAS,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAgGhG,eAAO,MAAM,OAAO;;sBAEH,OAAO;CAGvB,CAAC"}

package/dist/index.js

@@ -0,0 +1,395 @@
+/**
+ * meeting-record — system-audio and microphone capture with meeting detection.
+ *
+ * Wraps the native addon so callers never see helper-process pids, status codes,
+ * or the realtime callback. The addon itself is not re-exported.
+ */
+import { EventEmitter } from "node:events";
+import { Readable } from "node:stream";
+import { setTimeout as delay } from "node:timers/promises";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { MixedAudioImpl } from "./mixed-audio.js";
+// Native addons cannot be imported under ESM. node-gyp-build selects the
+// bundled binary for the current platform; local builds remain usable in-repo.
+const loadNative = createRequire(import.meta.url)("node-gyp-build");
+const native = loadNative(fileURLToPath(new URL("..", import.meta.url)));
+export class MeetingRecordError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = new.target.name;
+    }
+}
+export class UnsupportedOsError extends MeetingRecordError {
+}
+export class PermissionError extends MeetingRecordError {
+}
+export class AlreadyRunningError extends MeetingRecordError {
+}
+export class CaptureError extends MeetingRecordError {
+}
+export class InternalError extends MeetingRecordError {
+}
+function errorFromStatus(message, code) {
+    switch (code) {
+        case -1:
+            return new UnsupportedOsError(message, code);
+        case -2:
+            return new PermissionError(message, code);
+        case -3:
+            return new AlreadyRunningError(message, code);
+        case -4:
+        case -5:
+        case -6:
+        case -7:
+        case -8:
+            return new CaptureError(message, code);
+        default:
+            return new InternalError(message, code);
+    }
+}
+function asLibraryError(error) {
+    if (error instanceof TypeError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    const code = error?.code;
+    return typeof code === "number" ? errorFromStatus(message, code) : new InternalError(message, -9);
+}
+export const permissions = {
+    status(permission) {
+        if (permission !== "system-audio" &&
+            permission !== "microphone" &&
+            permission !== "accessibility") {
+            throw new TypeError(`unknown permission: ${String(permission)}`);
+        }
+        if (permission === "accessibility")
+            return native.accessibilityPermissionStatus();
+        if (permission === "microphone")
+            return native.microphonePermissionStatus();
+        return native.audioPermissionStatus();
+    },
+    /**
+     * Show the permission prompt and resolve once the user answers.
+     *
+     * Accessibility opens System Settings and needs an app relaunch, so it resolves
+     * as soon as Settings is open.
+     */
+    async request(permission, { timeoutMs = 120_000, signal } = {}) {
+        signal?.throwIfAborted();
+        const current = permissions.status(permission);
+        if (current === "granted" || current === "not-required")
+            return current;
+        if (permission === "accessibility") {
+            const status = native.requestAccessibilityPermission();
+            if (status !== 0)
+                throw errorFromStatus("failed to request accessibility permission", status);
+            return permissions.status(permission);
+        }
+        const requestStatus = permission === "microphone"
+            ? native.requestMicrophonePermission()
+            : native.requestAudioPermission();
+        if (requestStatus !== 0) {
+            throw errorFromStatus(`failed to request ${permission} permission`, requestStatus);
+        }
+        // The dialog is modal to the user, not to this process.
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            await delay(500, undefined, { signal });
+            const status = permissions.status(permission);
+            if (status === "granted" || status === "denied")
+                return status;
+        }
+        return permissions.status(permission);
+    },
+};
+function toMeeting(raw) {
+    return raw;
+}
+class Meetings extends EventEmitter {
+    /** Point-in-time scan, highest confidence first. */
+    scan() {
+        return native.scan().map(toMeeting);
+    }
+    /** Begin emitting `started` / `updated` / `ended`. */
+    watch() {
+        if (native.isWatching())
+            return;
+        const status = native.watchStart((event, raw) => {
+            this.emit(event, toMeeting(raw));
+        });
+        if (status !== 0)
+            throw errorFromStatus("failed to start watching", status);
+    }
+    unwatch() {
+        if (native.isWatching())
+            native.watchStop();
+    }
+    get watching() {
+        return native.isWatching();
+    }
+    /** Every process doing audio IO. */
+    audioProcesses() {
+        return native.listAudioProcesses();
+    }
+    /**
+     * Applications doing audio IO, grouped by owning PID, including helpers.
+     * Pass `pid` as a process target; no meeting scan or Accessibility grant is needed.
+     */
+    audioApps() {
+        return native.listAudioApps();
+    }
+}
+export const meetings = new Meetings();
+class AudioTrackImpl extends Readable {
+    #sampleRate;
+    #channels;
+    #microphone;
+    #droppedSamples = 0;
+    #consumerReady = true;
+    #mixReady = true;
+    #mixConsumer;
+    #finished = false;
+    constructor(sampleRate, channels, microphone) {
+        super({ objectMode: false, highWaterMark: 1 << 20 });
+        this.#sampleRate = sampleRate;
+        this.#channels = channels;
+        this.#microphone = microphone;
+    }
+    /** Required by Readable; data arrives from the native side, not on demand. */
+    _read() {
+        if (!this.#consumerReady && !this.#finished) {
+            this.#consumerReady = true;
+            native.captureSetConsumerReady(this.#microphone, this.#mixReady);
+        }
+    }
+    setMixConsumer(consumer) {
+        this.#mixConsumer = consumer;
+    }
+    setMixReady(ready) {
+        this.#mixReady = ready;
+        if (!this.#finished)
+            native.captureSetConsumerReady(this.#microphone, ready && this.#consumerReady);
+    }
+    get sampleRate() {
+        return this.#sampleRate;
+    }
+    get channels() {
+        return this.#channels;
+    }
+    get droppedSamples() {
+        return this.#droppedSamples;
+    }
+    pushAudio(chunk, info) {
+        if (info.dropped > 0) {
+            this.#droppedSamples += info.dropped;
+            this.emit("drop", info.dropped);
+        }
+        if (info.sampleRate !== this.#sampleRate || info.channels !== this.#channels) {
+            this.#sampleRate = info.sampleRate;
+            this.#channels = info.channels;
+            this.emit("format", { sampleRate: info.sampleRate, channels: info.channels });
+        }
+        Object.defineProperties(chunk, {
+            hostTimeNs: { value: info.hostTimeNs, enumerable: false },
+            frameCount: { value: info.frameCount, enumerable: false },
+            sampleRate: { value: info.sampleRate, enumerable: false },
+            channels: { value: info.channels, enumerable: false },
+            droppedSamples: { value: info.dropped, enumerable: false },
+        });
+        this.#mixConsumer?.(chunk);
+        if (!this.push(chunk) && this.#consumerReady) {
+            this.#consumerReady = false;
+            native.captureSetConsumerReady(this.#microphone, false);
+        }
+    }
+    finish() {
+        if (this.#finished)
+            return;
+        this.#finished = true;
+        this.push(null);
+    }
+}
+class CaptureSessionImpl extends EventEmitter {
+    #state = "recording";
+    #health = "running";
+    #failure;
+    #healthTimer;
+    #systemAudio;
+    #microphone;
+    mixedAudio;
+    #signal;
+    #onAbort = () => {
+        void this.stopRecording();
+    };
+    constructor(systemAudio, microphone, mix, signal) {
+        super();
+        this.#systemAudio = systemAudio;
+        this.#microphone = microphone;
+        this.#signal = signal;
+        signal?.addEventListener("abort", this.#onAbort, { once: true });
+        this.mixedAudio = mix ? new MixedAudioImpl(mix.sampleRate, systemAudio, microphone) : undefined;
+        this.#healthTimer = setInterval(() => this.#pollHealth(), 250);
+        this.#healthTimer.unref();
+    }
+    get systemAudio() {
+        return this.#systemAudio;
+    }
+    get microphone() {
+        return this.#microphone;
+    }
+    get state() {
+        return this.#state;
+    }
+    get health() {
+        return this.#health;
+    }
+    get failure() {
+        return this.#failure;
+    }
+    pauseRecording() {
+        if (this.#state === "stopped")
+            return;
+        if (this.#state !== "paused") {
+            native.capturePause();
+            this.#state = "paused";
+            this.mixedAudio?.pauseCapture();
+        }
+    }
+    resumeRecording() {
+        if (this.#state === "stopped")
+            return;
+        if (this.#state !== "recording") {
+            this.mixedAudio?.resumeCapture();
+            native.captureResume();
+            this.#state = "recording";
+        }
+    }
+    async stopRecording() {
+        if (this.#state === "stopped")
+            return;
+        clearInterval(this.#healthTimer);
+        native.captureStop();
+        this.#state = "stopped";
+        this.#health = "stopped";
+        this.#finishTracks();
+    }
+    #finishTracks() {
+        this.#signal?.removeEventListener("abort", this.#onAbort);
+        this.#systemAudio.finish();
+        this.#microphone?.finish();
+        this.mixedAudio?.finishCapture();
+    }
+    #pollHealth() {
+        if (this.#state === "stopped")
+            return;
+        const health = native.captureHealthStatus();
+        if (health === this.#health)
+            return;
+        const previous = this.#health;
+        this.#health = health;
+        if (health === "recovering") {
+            this.emit("interrupted");
+        }
+        else if (health === "running" && previous === "recovering") {
+            this.emit("recovered");
+        }
+        else if (health === "failed") {
+            const failure = new CaptureError(native.lastError(), -7);
+            this.#failure = failure;
+            clearInterval(this.#healthTimer);
+            native.captureStop();
+            this.#state = "stopped";
+            this.#finishTracks();
+            this.emit("failed", failure);
+        }
+    }
+}
+let captureStarting = false;
+async function startCapture(target, options = {}) {
+    options.signal?.throwIfAborted();
+    if (captureStarting || native.isRunning()) {
+        throw new AlreadyRunningError("capture already running", -3);
+    }
+    captureStarting = true;
+    let session;
+    const pendingSystemAudio = [];
+    const pendingMicrophone = [];
+    const receive = (track, pending, chunk, info) => {
+        if (!session) {
+            pending.push({ chunk, info });
+            return;
+        }
+        if (session.state !== "recording")
+            return;
+        session[track]?.pushAudio(chunk, info);
+    };
+    const onSystemAudio = (chunk, info) => {
+        receive("systemAudio", pendingSystemAudio, chunk, info);
+    };
+    const onMicrophone = (chunk, info) => {
+        receive("microphone", pendingMicrophone, chunk, info);
+    };
+    try {
+        let nativeTarget;
+        if (target.type === "process") {
+            if (!Number.isInteger(target.pid) || target.pid <= 0) {
+                throw new TypeError("process pid must be a positive integer");
+            }
+            nativeTarget = { pid: target.pid };
+        }
+        else if (target.type === "system") {
+            nativeTarget = { systemWide: true };
+        }
+        else {
+            throw new TypeError(`unknown capture target: ${target.type}`);
+        }
+        if (options.mono !== undefined && typeof options.mono !== "boolean") {
+            throw new TypeError("mono must be a boolean");
+        }
+        if (options.microphone !== undefined && options.microphone !== "default") {
+            throw new TypeError('microphone must be "default"');
+        }
+        if (options.mix !== undefined &&
+            (!Number.isInteger(options.mix.sampleRate) || options.mix.sampleRate <= 0)) {
+            throw new TypeError("mix sampleRate must be a positive integer");
+        }
+        const formats = await native.captureStart({
+            ...nativeTarget,
+            mono: options.mono ?? true,
+            microphone: options.microphone === "default",
+        }, onSystemAudio, onMicrophone);
+        if (options.signal?.aborted) {
+            native.captureStop();
+            options.signal.throwIfAborted();
+        }
+        const systemAudio = new AudioTrackImpl(formats.systemAudio.sampleRate, formats.systemAudio.channels, false);
+        const microphone = formats.microphone
+            ? new AudioTrackImpl(formats.microphone.sampleRate, formats.microphone.channels, true)
+            : undefined;
+        session = new CaptureSessionImpl(systemAudio, microphone, options.mix, options.signal);
+        for (const { chunk, info } of pendingSystemAudio) {
+            systemAudio.pushAudio(chunk, info);
+        }
+        for (const { chunk, info } of pendingMicrophone) {
+            microphone?.pushAudio(chunk, info);
+        }
+        return session;
+    }
+    catch (error) {
+        if (options.signal?.aborted)
+            throw error;
+        throw asLibraryError(error);
+    }
+    finally {
+        captureStarting = false;
+    }
+}
+export const capture = {
+    start: startCapture,
+    get running() {
+        return captureStarting || native.captureHealthStatus() !== "stopped";
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mixed-audio.d.ts

@@ -0,0 +1,33 @@
+import { Readable } from "node:stream";
+import type { AudioChunk } from "./index.js";
+export interface MixedAudioOptions {
+    sampleRate: number;
+}
+/** Mono signed 16-bit little-endian PCM. Await `end` to consume the final tail. */
+export interface MixedAudio extends Readable {
+    readonly sampleRate: number;
+    readonly channels: 1;
+    /** Affects the mixed output only; the raw microphone track stays available. */
+    setMicrophoneMuted(muted: boolean): void;
+    on(event: "level", listener: (level: number) => void): this;
+    on(event: "data", listener: (chunk: Buffer) => void): this;
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+export interface MixSource {
+    setMixConsumer(consumer: ((chunk: AudioChunk) => void) | undefined): void;
+    setMixReady(ready: boolean): void;
+    resume(): unknown;
+}
+export declare class MixedAudioImpl extends Readable implements MixedAudio {
+    #private;
+    readonly sampleRate: number;
+    readonly channels = 1;
+    constructor(sampleRate: number, systemAudio: MixSource, microphone?: MixSource);
+    _read(): void;
+    _destroy(error: Error | null, callback: (error?: Error | null) => void): void;
+    setMicrophoneMuted(muted: boolean): void;
+    pauseCapture(): void;
+    resumeCapture(): void;
+    finishCapture(): void;
+}
+//# sourceMappingURL=mixed-audio.d.ts.map

package/dist/mixed-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixed-audio.d.ts","sourceRoot":"","sources":["../src/mixed-audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,+EAA+E;IAC/E,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1E,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,qBAAa,cAAe,SAAQ,QAAS,YAAW,UAAU;;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,KAAK;gBAaV,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,SAAS;IAcrE,KAAK,IAAI,IAAI;IAQb,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAWtF,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIxC,YAAY,IAAI,IAAI;IAQpB,aAAa,IAAI,IAAI;IAOrB,aAAa,IAAI,IAAI;CAmEtB"}

package/dist/mixed-audio.js

@@ -0,0 +1,137 @@
+import { Readable } from "node:stream";
+import { getLevel, PcmMixer } from "./pcm-mixer.js";
+export class MixedAudioImpl extends Readable {
+    sampleRate;
+    channels = 1;
+    #sources;
+    #microphone;
+    #mixer;
+    #timer;
+    #startup = new Map();
+    #startupDeadline = 0;
+    #startupTimer;
+    #blocked = false;
+    #pumping = false;
+    #paused = false;
+    #finished = false;
+    constructor(sampleRate, systemAudio, microphone) {
+        super({ highWaterMark: sampleRate * 2 });
+        this.sampleRate = sampleRate;
+        this.#sources = microphone ? [systemAudio, microphone] : [systemAudio];
+        this.#microphone = microphone;
+        this.#mixer = new PcmMixer(sampleRate, this.#sources);
+        for (const source of this.#sources) {
+            source.setMixConsumer((chunk) => this.#write(source, chunk));
+            source.resume();
+        }
+        this.#timer = setInterval(() => this.#pump(), 100);
+        this.#timer.unref();
+    }
+    _read() {
+        this.#blocked = false;
+        this.#pump();
+        if (!this.#blocked && !this.#finished) {
+            for (const source of this.#sources)
+                source.setMixReady(true);
+        }
+    }
+    _destroy(error, callback) {
+        clearInterval(this.#timer);
+        clearTimeout(this.#startupTimer);
+        this.#startup?.clear();
+        for (const source of this.#sources) {
+            source.setMixConsumer(undefined);
+            source.setMixReady(true);
+        }
+        callback(error);
+    }
+    setMicrophoneMuted(muted) {
+        if (this.#microphone)
+            this.#mixer.setMuted(this.#microphone, muted);
+    }
+    pauseCapture() {
+        if (this.#paused || this.#finished || this.destroyed)
+            return;
+        this.#paused = true;
+        this.#flushStartup(true);
+        this.#mixer.finishSegment();
+        this.#pump();
+    }
+    resumeCapture() {
+        if (!this.#paused || this.#finished || this.destroyed)
+            return;
+        this.#paused = false;
+        this.#mixer.restart();
+        this.#startup = new Map();
+    }
+    finishCapture() {
+        if (this.#finished || this.destroyed)
+            return;
+        clearInterval(this.#timer);
+        this.#finished = true;
+        this.#flushStartup(true);
+        this.#mixer.finishSegment();
+        this.#pump();
+    }
+    #write(source, chunk) {
+        if (!this.#startup) {
+            this.#mixer.write(source, chunk);
+            return;
+        }
+        if (this.#startup.size === 0) {
+            this.#startupDeadline = performance.now() + 100;
+            this.#startupTimer = setTimeout(() => {
+                this.#flushStartup(true);
+                this.#pump();
+            }, 100);
+            this.#startupTimer.unref();
+        }
+        const pending = this.#startup.get(source) ?? [];
+        pending.push(chunk);
+        this.#startup.set(source, pending);
+        this.#flushStartup();
+    }
+    #flushStartup(force = false) {
+        if (!this.#startup?.size)
+            return;
+        if (!force &&
+            this.#startup.size < this.#sources.length &&
+            performance.now() < this.#startupDeadline) {
+            return;
+        }
+        clearTimeout(this.#startupTimer);
+        // Establish the earliest source timestamp while retaining each source's order.
+        const pending = [...this.#startup].sort(([, left], [, right]) => {
+            if (left[0].hostTimeNs < right[0].hostTimeNs)
+                return -1;
+            return left[0].hostTimeNs > right[0].hostTimeNs ? 1 : 0;
+        });
+        this.#startup = undefined;
+        for (const [source, chunks] of pending) {
+            for (const chunk of chunks)
+                this.#mixer.write(source, chunk);
+        }
+    }
+    #pump() {
+        if (this.#pumping || this.destroyed)
+            return;
+        this.#pumping = true;
+        this.#flushStartup();
+        while (!this.#blocked) {
+            const chunk = this.#mixer.read();
+            if (!chunk) {
+                if (this.#finished)
+                    this.push(null);
+                break;
+            }
+            if (!this.push(chunk)) {
+                this.#blocked = true;
+                for (const source of this.#sources)
+                    source.setMixReady(false);
+            }
+            this.emit("level", getLevel(chunk));
+        }
+        this.#pumping = false;
+    }
+}
+//# sourceMappingURL=mixed-audio.js.map

package/dist/mixed-audio.js.map

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

package/dist/mono-resampler.d.ts

@@ -0,0 +1,14 @@
+import type { AudioChunk } from "./index.js";
+/**
+ * Converts interleaved float32 at any rate and channel count into mono at
+ * `outputRate`, carrying fractional position across chunks.
+ * Downsampling averages each output's input span.
+ */
+export declare class MonoResampler {
+    #private;
+    constructor(outputRate: number);
+    resample(chunk: AudioChunk): Float32Array;
+    flush(): Float32Array;
+    reset(): void;
+}
+//# sourceMappingURL=mono-resampler.d.ts.map

package/dist/mono-resampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mono-resampler.d.ts","sourceRoot":"","sources":["../src/mono-resampler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,aAAa;;gBAYZ,UAAU,EAAE,MAAM;IAI9B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY;IAczC,KAAK,IAAI,YAAY;IAcrB,KAAK,IAAI,IAAI;CA+Cd"}

package/dist/mono-resampler.js

@@ -0,0 +1,108 @@
+/**
+ * Converts interleaved float32 at any rate and channel count into mono at
+ * `outputRate`, carrying fractional position across chunks.
+ * Downsampling averages each output's input span.
+ */
+export class MonoResampler {
+    #outputRate;
+    #sampleRate = 0;
+    #step = 1;
+    // Upsampling: the last input frame and the next output's input position,
+    // relative to the current chunk (-1 is `#previous`).
+    #previous = 0;
+    #position = 0;
+    // Downsampling: the weighted sum and input span gathered for the next output.
+    #sum = 0;
+    #covered = 0;
+    constructor(outputRate) {
+        this.#outputRate = outputRate;
+    }
+    resample(chunk) {
+        if (chunk.sampleRate !== this.#sampleRate) {
+            this.#sampleRate = chunk.sampleRate;
+            this.#step = chunk.sampleRate / this.#outputRate;
+            this.#previous = 0;
+            this.#position = 0;
+            this.#sum = 0;
+            this.#covered = 0;
+        }
+        const input = downmix(chunk);
+        if (this.#step === 1)
+            return input;
+        return this.#step > 1 ? this.#average(input) : this.#interpolate(input);
+    }
+    flush() {
+        if (this.#step > 1) {
+            const output = this.#covered > 0 ? Float32Array.of(this.#sum / this.#covered) : new Float32Array(0);
+            this.#sum = 0;
+            this.#covered = 0;
+            return output;
+        }
+        const output = new Float32Array(Math.max(0, Math.ceil(-this.#position / this.#step - 1e-9)));
+        output.fill(this.#previous);
+        this.#position = 0;
+        return output;
+    }
+    reset() {
+        this.#sampleRate = 0;
+        this.#sum = 0;
+        this.#covered = 0;
+        this.#position = 0;
+        this.#previous = 0;
+    }
+    #average(input) {
+        const step = this.#step;
+        const output = new Float32Array(Math.floor((this.#covered + input.length) / step) + 1);
+        let written = 0;
+        for (const sample of input) {
+            let remaining = 1;
+            while (remaining > 0) {
+                const taken = Math.min(step - this.#covered, remaining);
+                this.#sum += sample * taken;
+                this.#covered += taken;
+                remaining -= taken;
+                if (this.#covered >= step - 1e-9) {
+                    output[written++] = this.#sum / step;
+                    this.#sum = 0;
+                    this.#covered = 0;
+                }
+            }
+        }
+        return output.subarray(0, written);
+    }
+    #interpolate(input) {
+        const last = input.length - 1;
+        const output = new Float32Array(Math.max(0, Math.ceil((last - this.#position) / this.#step)));
+        let written = 0;
+        // Stops short of the final frame, which still needs its successor.
+        while (this.#position < last && written < output.length) {
+            const index = Math.floor(this.#position);
+            const from = index < 0 ? this.#previous : input[index];
+            const to = input[index + 1];
+            output[written++] = from + (to - from) * (this.#position - index);
+            this.#position += this.#step;
+        }
+        if (input.length > 0) {
+            this.#position -= input.length;
+            this.#previous = input[last];
+        }
+        return output.subarray(0, written);
+    }
+}
+function downmix(chunk) {
+    const samples = new Float32Array(chunk.buffer, chunk.byteOffset, chunk.byteLength / Float32Array.BYTES_PER_ELEMENT);
+    const { channels } = chunk;
+    if (channels === 1) {
+        return samples;
+    }
+    const mono = new Float32Array(Math.floor(samples.length / channels));
+    for (let frame = 0; frame < mono.length; frame++) {
+        let sum = 0;
+        for (let channel = 0; channel < channels; channel++) {
+            sum += samples[frame * channels + channel];
+        }
+        mono[frame] = sum / channels;
+    }
+    return mono;
+}
+//# sourceMappingURL=mono-resampler.js.map

package/dist/mono-resampler.js.map

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

package/dist/pcm-mixer.d.ts

@@ -0,0 +1,15 @@
+import type { AudioChunk } from "./index.js";
+/** Timestamp-aligned mono s16le, with sparse silence between capture packets. */
+export declare class PcmMixer {
+    #private;
+    constructor(sampleRate: number, sources: readonly object[]);
+    write(source: object, chunk: AudioChunk): void;
+    setMuted(source: object, muted: boolean): void;
+    /** Makes the remaining captured tail readable before pause or stop. */
+    finishSegment(): void;
+    /** Keeps unread audio, while removing paused time from the next segment. */
+    restart(): void;
+    read(): Buffer | null;
+}
+export declare function getLevel(pcm: Buffer): number;
+//# sourceMappingURL=pcm-mixer.d.ts.map

package/dist/pcm-mixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-mixer.d.ts","sourceRoot":"","sources":["../src/pcm-mixer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS7C,iFAAiF;AACjF,qBAAa,QAAQ;;gBAYP,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE;IAgB1D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAiC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9C,uEAAuE;IACvE,aAAa,IAAI,IAAI;IAOrB,4EAA4E;IAC5E,OAAO,IAAI,IAAI;IASf,IAAI,IAAI,MAAM,GAAG,IAAI;CAoCtB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO5C"}

package/dist/pcm-mixer.js

@@ -0,0 +1,119 @@
+import { MonoResampler } from "./mono-resampler.js";
+/** Timestamp-aligned mono s16le, with sparse silence between capture packets. */
+export class PcmMixer {
+    #sampleRate;
+    #blockFrames;
+    #inputs;
+    #gain;
+    #blocks = new Map();
+    #origin = null;
+    #originFrame = 0;
+    #emitted = 0;
+    #end = 0;
+    #committed = 0;
+    constructor(sampleRate, sources) {
+        this.#sampleRate = sampleRate;
+        this.#blockFrames = Math.max(1, Math.round(sampleRate / 10));
+        this.#inputs = new Map(sources.map((source) => [
+            source,
+            {
+                resampler: new MonoResampler(sampleRate),
+                cursor: null,
+                muted: false,
+            },
+        ]));
+        this.#gain = 1 / Math.sqrt(sources.length);
+    }
+    write(source, chunk) {
+        const input = this.#input(source);
+        const samples = input.resampler.resample(chunk);
+        this.#origin ??= chunk.hostTimeNs;
+        const position = this.#originFrame +
+            Math.round((Number(chunk.hostTimeNs - this.#origin) * this.#sampleRate) / 1e9);
+        // Absorb up to 20 ms of callback-clock jitter at packet joins.
+        if (input.cursor === null || Math.abs(position - input.cursor) > this.#sampleRate / 50) {
+            input.cursor = position;
+        }
+        this.#append(input, samples);
+    }
+    #append(input, samples) {
+        if (input.cursor === null)
+            return;
+        const start = input.cursor;
+        input.cursor += samples.length;
+        this.#end = Math.max(this.#end, input.cursor);
+        if (input.muted)
+            return;
+        for (let index = Math.max(0, this.#emitted - start); index < samples.length; index++) {
+            const frame = start + index;
+            const blockIndex = Math.floor(frame / this.#blockFrames);
+            let block = this.#blocks.get(blockIndex);
+            if (!block) {
+                block = new Float32Array(this.#blockFrames);
+                this.#blocks.set(blockIndex, block);
+            }
+            const offset = frame % this.#blockFrames;
+            block[offset] = block[offset] + samples[index] * this.#gain;
+        }
+    }
+    setMuted(source, muted) {
+        this.#input(source).muted = muted;
+    }
+    /** Makes the remaining captured tail readable before pause or stop. */
+    finishSegment() {
+        for (const input of this.#inputs.values()) {
+            this.#append(input, input.resampler.flush());
+        }
+        this.#committed = this.#end;
+    }
+    /** Keeps unread audio, while removing paused time from the next segment. */
+    restart() {
+        this.#origin = null;
+        this.#originFrame = this.#end;
+        for (const input of this.#inputs.values()) {
+            input.cursor = null;
+            input.resampler.reset();
+        }
+    }
+    read() {
+        const cursors = [...this.#inputs.values()]
+            .map((input) => input.cursor)
+            .filter((cursor) => cursor !== null);
+        let ready = this.#committed;
+        if (cursors.length > 0) {
+            const lead = Math.max(...cursors);
+            // A track more than half a second behind contributes silence.
+            ready = Math.max(ready, Math.min(...cursors.filter((cursor) => lead - cursor <= this.#sampleRate / 2)));
+        }
+        const end = Math.min(ready, this.#emitted + this.#blockFrames);
+        if (end <= this.#emitted)
+            return null;
+        const output = Buffer.allocUnsafe((end - this.#emitted) * 2);
+        for (let frame = this.#emitted; frame < end; frame++) {
+            const block = this.#blocks.get(Math.floor(frame / this.#blockFrames));
+            const sample = Math.max(-1, Math.min(1, block?.[frame % this.#blockFrames] ?? 0));
+            output.writeInt16LE(Math.round(sample < 0 ? sample * 0x8000 : sample * 0x7fff), (frame - this.#emitted) * 2);
+        }
+        for (const blockIndex of this.#blocks.keys()) {
+            if ((blockIndex + 1) * this.#blockFrames <= end)
+                this.#blocks.delete(blockIndex);
+        }
+        this.#emitted = end;
+        return output;
+    }
+    #input(source) {
+        const input = this.#inputs.get(source);
+        if (!input)
+            throw new Error("Not a source of this mixer");
+        return input;
+    }
+}
+export function getLevel(pcm) {
+    let sum = 0;
+    for (let offset = 0; offset < pcm.length; offset += 2) {
+        const sample = pcm.readInt16LE(offset) / 0x8000;
+        sum += sample * sample;
+    }
+    return Math.sqrt(sum / (pcm.length / 2));
+}
+//# sourceMappingURL=pcm-mixer.js.map

package/dist/pcm-mixer.js.map

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

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "meeting-record",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "System-audio and microphone capture with meeting detection for macOS and Windows",
+  "bugs": "https://github.com/hoangvvo/meeting-record/issues",
+  "license": "MIT",
+  "author": {
+    "name": "Hoang Vo",
+    "url": "https://hoangvvo.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hoangvvo/meeting-record.git",
+    "directory": "node"
+  },
+  "files": [
+    "dist",
+    "prebuilds"
+  ],
+  "os": [
+    "darwin",
+    "win32"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build:native": "node ../scripts/build-native.mjs",
+    "build:addon": "node-gyp rebuild",
+    "build:prebuild": "npm run build:native && prebuildify --napi",
+    "build:ts": "tsc -p tsconfig.json",
+    "build": "npm run build:native && npm run build:addon && npm run build:ts",
+    "prepack": "npm run build:ts",
+    "test": "node --test"
+  },
+  "dependencies": {
+    "node-gyp-build": "^4.8.4"
+  },
+  "engines": {
+    "node": ">=22.13.0 <23 || >=24"
+  },
+  "gypfile": false
+}