@wirecat/zoom-cli 0.3.2 → 0.4.0

package/dist/recording-schedule-systemd.d.ts

@@ -0,0 +1,14 @@
+import { type RecordingScheduleBackend } from "./recording-schedule.js";
+export type RecordingScheduleExecutor = (executable: string, args: readonly string[], options: {
+    shell: false;
+    signal?: AbortSignal;
+}) => Promise<{
+    exitCode: number;
+}>;
+export declare const createSystemdRecordingArchiveScheduler: (options: {
+    unitDirectory: string;
+    platform?: NodeJS.Platform;
+    execute?: RecordingScheduleExecutor;
+    systemctl?: string;
+}) => RecordingScheduleBackend;
+//# sourceMappingURL=recording-schedule-systemd.d.ts.map

package/dist/recording-schedule-systemd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-schedule-systemd.d.ts","sourceRoot":"","sources":["../src/recording-schedule-systemd.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,wBAAwB,EAG9B,MAAM,yBAAyB,CAAA;AAGhC,MAAM,MAAM,yBAAyB,GAAG,CACtC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC5C,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAqGlC,eAAO,MAAM,sCAAsC,YAAa;IAC9D,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,OAAO,CAAC,EAAE,yBAAyB,CAAA;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KAAG,wBA2EH,CAAA"}

package/dist/recording-schedule-systemd.js

@@ -0,0 +1,173 @@
+import { execFile } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { link, open, unlink } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+import { checkCancelled, ZoomError } from "./errors.js";
+import { openOrdinaryFile, syncDirectory } from "./ordinary-file.js";
+import { parseRecordingScheduleJob, } from "./recording-schedule.js";
+import { recordingScheduleDirectory } from "./recording-schedule-store.js";
+const execute = (executable, args, options) => new Promise((resolve, reject) => {
+    execFile(executable, [...args], { shell: false, signal: options.signal, timeout: 30000, maxBuffer: 65536, encoding: "utf8" }, (error) => {
+        if (!error)
+            return resolve({ exitCode: 0 });
+        if (typeof error.code === "number")
+            return resolve({ exitCode: error.code });
+        if (error.code === "ENOENT")
+            return reject(new ZoomError("configuration_error", "systemctl is unavailable"));
+        reject(new ZoomError("outcome_unknown", "archive timer command was interrupted; inspect its saved pending job and systemctl status"));
+    });
+});
+const missing = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+const quote = (value, expandDollar) => `"${value
+    .replaceAll("\\", "\\\\")
+    .replaceAll('"', '\\"')
+    .replaceAll("%", "%%")
+    .replaceAll("$", () => (expandDollar ? "$$" : "$"))
+    .replaceAll("\t", "\\t")}"`;
+const unitPlan = (value) => {
+    const job = parseRecordingScheduleJob(value);
+    const name = `zm-archive-${job.schedule.id}`;
+    const serviceName = `${name}.service`;
+    const timerName = `${name}.timer`;
+    const owner = `# WireCat Zoom archive ${job.schedule.id}`;
+    const args = [
+        job.capture.runtime,
+        job.capture.cliPath,
+        "recordings",
+        "schedule",
+        "run",
+        job.schedule.id,
+        "--jsonl",
+        "--timeout",
+        "6h",
+        "--no-input",
+    ];
+    const timeZone = new Intl.DateTimeFormat("en", { timeZone: job.schedule.timeZone }).resolvedOptions().timeZone;
+    return {
+        serviceName,
+        timerName,
+        service: `${owner}\n[Unit]\nDescription=WireCat Zoom recording archive\n\n[Service]\nType=oneshot\nUMask=0077\nTimeoutStartSec=6h\nEnvironment=${quote(`ZM_CONFIG_DIR=${job.capture.configDir}`, false)}\nExecStart=${args.map((value) => quote(value, true)).join(" ")}\n`,
+        timer: `${owner}\n[Unit]\nDescription=WireCat Zoom recording archive timer\n\n[Timer]\nOnCalendar=*-*-* ${job.schedule.dailyAt}:00 ${timeZone}\nPersistent=true\nUnit=${serviceName}\n\n[Install]\nWantedBy=timers.target\n`,
+    };
+};
+const maximumUnitBytes = 64 * 1024;
+const existingUnit = async (path) => {
+    let handle;
+    try {
+        handle = await openOrdinaryFile(path);
+    }
+    catch (error) {
+        if (missing(error))
+            return null;
+        throw error;
+    }
+    try {
+        const bytes = Buffer.alloc(maximumUnitBytes + 1);
+        const size = (await handle.read(bytes, 0, bytes.length, 0)).bytesRead;
+        if (size > maximumUnitBytes)
+            throw new ZoomError("validation_error", "archive timer unit exceeds its byte limit");
+        return bytes.subarray(0, size).toString("utf8");
+    }
+    finally {
+        await handle.close();
+    }
+};
+const writeUnit = async (directory, name, content, signal) => {
+    if (Buffer.byteLength(content) > maximumUnitBytes)
+        throw new ZoomError("validation_error", "archive timer unit exceeds its byte limit");
+    const path = join(directory, name);
+    const current = await existingUnit(path);
+    if (current !== null) {
+        if (current !== content)
+            throw new ZoomError("validation_error", "archive timer unit is foreign or was edited; it was preserved");
+        await syncDirectory(directory);
+        return;
+    }
+    checkCancelled(signal);
+    const temp = join(directory, `.zoom-schedule-unit-${randomUUID()}.tmp`);
+    const handle = await open(temp, "wx", 0o600);
+    try {
+        try {
+            await handle.writeFile(content);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        checkCancelled(signal);
+        await link(temp, path);
+        await syncDirectory(directory);
+    }
+    finally {
+        await unlink(temp).catch(() => undefined);
+    }
+};
+export const createSystemdRecordingArchiveScheduler = (options) => {
+    const directory = options.unitDirectory;
+    const executable = options.systemctl ?? "/usr/bin/systemctl";
+    const platform = options.platform ?? process.platform;
+    const executor = options.execute ?? execute;
+    if (!isAbsolute(directory) || !isAbsolute(executable) || /[\0\r\n]/.test(directory + executable))
+        throw new ZoomError("validation_error", "systemd archive paths must be absolute");
+    const assertSupported = () => {
+        if (platform !== "linux")
+            throw new ZoomError("configuration_error", "automatic archive scheduling currently supports Linux user systemd only");
+    };
+    const checked = async (args, expected, signal) => {
+        checkCancelled(signal);
+        let result;
+        try {
+            result = await executor(executable, ["--user", ...args], { shell: false, signal });
+        }
+        catch (error) {
+            if (error instanceof ZoomError)
+                throw error;
+            throw new ZoomError("outcome_unknown", "archive timer command did not acknowledge completion; inspect its saved job and systemctl status");
+        }
+        if (result.exitCode !== expected)
+            throw new ZoomError("outcome_unknown", "archive timer state was not verified; inspect its saved job and systemctl status");
+    };
+    return {
+        backend: "systemd-user",
+        plan: unitPlan,
+        assertSupported,
+        async install(value, active) {
+            assertSupported();
+            const job = parseRecordingScheduleJob(value);
+            const units = unitPlan(job);
+            checkCancelled(active.signal);
+            for (const path of [job.capture.runtime, job.capture.cliPath]) {
+                const handle = await openOrdinaryFile(path);
+                try {
+                    const stat = await handle.stat();
+                    if (path === job.capture.runtime && (stat.mode & 0o111) === 0)
+                        throw new ZoomError("validation_error", "scheduled runtime must be executable");
+                }
+                finally {
+                    await handle.close();
+                }
+            }
+            await recordingScheduleDirectory(directory, true);
+            await writeUnit(directory, units.serviceName, units.service, active.signal);
+            await writeUnit(directory, units.timerName, units.timer, active.signal);
+            await checked(["daemon-reload"], 0, active.signal);
+            await checked(["enable", "--now", units.timerName], 0, active.signal);
+            await checked(["is-enabled", "--quiet", units.timerName], 0, active.signal);
+            await checked(["is-active", "--quiet", units.timerName], 0, active.signal);
+        },
+        async disable(value, active) {
+            assertSupported();
+            const units = unitPlan(value);
+            checkCancelled(active.signal);
+            if (!(await recordingScheduleDirectory(directory, false)))
+                throw new ZoomError("not_found", "archive timer units were not found");
+            if ((await existingUnit(join(directory, units.serviceName))) !== units.service ||
+                (await existingUnit(join(directory, units.timerName))) !== units.timer)
+                throw new ZoomError("validation_error", "archive timer units are foreign or were edited; they were preserved");
+            await checked(["disable", "--now", units.timerName], 0, active.signal);
+            await checked(["is-enabled", "--quiet", units.timerName], 1, active.signal);
+            await checked(["is-active", "--quiet", units.timerName], 3, active.signal);
+        },
+    };
+};
+//# sourceMappingURL=recording-schedule-systemd.js.map

package/dist/recording-schedule-systemd.js.map

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

package/dist/recording-schedule.d.ts

@@ -0,0 +1,93 @@
+import { type RecordingArchiveSchedule } from "@wirecat/cli-meetings";
+import { type ArchiveSyncReceipt } from "./recording-sync.js";
+import type { ZoomRecordings } from "./recordings.js";
+export interface RecordingScheduleCapture {
+    profile: string;
+    clientId: string;
+    configDir: string;
+    runtime: string;
+    cliPath: string;
+}
+export interface RecordingScheduleJob {
+    version: 1;
+    schedule: RecordingArchiveSchedule;
+    capture: RecordingScheduleCapture;
+    state: "pending" | "enabled" | "disabled";
+}
+export interface RecordingScheduleStore {
+    list(options: {
+        signal?: AbortSignal;
+    }): Promise<RecordingScheduleJob[]>;
+    load(id: string, options: {
+        signal?: AbortSignal;
+    }): Promise<RecordingScheduleJob | null>;
+    save(job: RecordingScheduleJob, options: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
+export interface RecordingScheduleUnits {
+    serviceName: string;
+    timerName: string;
+    service: string;
+    timer: string;
+}
+export interface RecordingScheduleBackend {
+    readonly backend: string;
+    plan(job: RecordingScheduleJob): RecordingScheduleUnits;
+    assertSupported(): void;
+    install(job: RecordingScheduleJob, options: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    disable(job: RecordingScheduleJob, options: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
+export interface RecordingScheduleCreateInput {
+    name: string;
+    destination: string;
+    from: string;
+    dailyAt: string;
+    timeZone: string;
+    lookbackDays?: number;
+    maxBytes?: number;
+}
+export interface RecordingScheduleReceipt {
+    applied: boolean;
+    backend: string;
+    job: RecordingScheduleJob;
+    units?: RecordingScheduleUnits;
+    timerState: "not_checked" | "verified_enabled" | "verified_disabled";
+}
+export interface RecordingScheduleService {
+    create(input: RecordingScheduleCreateInput, capture: RecordingScheduleCapture, options?: {
+        apply?: boolean;
+        dryRun?: boolean;
+        offline?: boolean;
+        signal?: AbortSignal;
+    }): Promise<RecordingScheduleReceipt>;
+    list(options?: {
+        signal?: AbortSignal;
+    }): Promise<RecordingScheduleJob[]>;
+    show(id: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<RecordingScheduleJob>;
+    run(id: string, options?: {
+        offline?: boolean;
+        signal?: AbortSignal;
+    }): AsyncIterable<ArchiveSyncReceipt>;
+    disable(id: string, options?: {
+        apply?: boolean;
+        dryRun?: boolean;
+        signal?: AbortSignal;
+    }): Promise<RecordingScheduleReceipt>;
+}
+export declare const validateRecordingScheduleId: (id: string) => string;
+export declare const snapshotRecordingScheduleCapture: (value: RecordingScheduleCapture) => Readonly<RecordingScheduleCapture>;
+export declare const parseRecordingScheduleJob: (value: unknown) => RecordingScheduleJob;
+export declare const createRecordingScheduleService: (deps: {
+    store: RecordingScheduleStore;
+    backend: RecordingScheduleBackend;
+    recordings: (job: RecordingScheduleJob) => Pick<ZoomRecordings, "list" | "download"> & Partial<Pick<ZoomRecordings, "catalog">>;
+    now?: () => number;
+}) => RecordingScheduleService;
+//# sourceMappingURL=recording-schedule.d.ts.map

package/dist/recording-schedule.d.ts.map

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

package/dist/recording-schedule.js

@@ -0,0 +1,121 @@
+import { isAbsolute } from "node:path";
+import { installRecordingArchiveSchedule, parseRecordingArchiveSchedule, planRecordingArchiveSchedule, recordingArchiveScheduleWindow, } from "@wirecat/cli-meetings";
+import { profileAccountKey } from "./config.js";
+import { checkCancelled, ZoomError } from "./errors.js";
+import { syncRecordingArchive } from "./recording-sync.js";
+const text = (value, limit) => typeof value === "string" && !!value.trim() && value.length <= limit && !/[\0\r\n]/.test(value);
+const absolute = (value) => text(value, 4096) && isAbsolute(value);
+export const validateRecordingScheduleId = (id) => {
+    if (typeof id !== "string" || !/^[a-f0-9]{64}$/.test(id))
+        throw new ZoomError("validation_error", "archive schedule id must be 64 lowercase hexadecimal characters");
+    return id;
+};
+export const snapshotRecordingScheduleCapture = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new ZoomError("validation_error", "archive schedule capture is invalid");
+    const { profile, clientId, configDir, runtime, cliPath } = value;
+    if (!text(profile, 64) ||
+        !/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(profile) ||
+        !text(clientId, 200) ||
+        /\s/.test(clientId) ||
+        !absolute(configDir) ||
+        !absolute(runtime) ||
+        !absolute(cliPath))
+        throw new ZoomError("validation_error", "archive schedule requires a profile, public client id and absolute config/runtime/CLI paths");
+    return Object.freeze({ profile, clientId, configDir, runtime, cliPath });
+};
+export const parseRecordingScheduleJob = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new ZoomError("validation_error", "archive schedule job is invalid");
+    const row = value;
+    if (row.version !== 1 ||
+        Object.keys(row).some((key) => !["version", "schedule", "capture", "state"].includes(key)) ||
+        !["pending", "enabled", "disabled"].includes(row.state))
+        throw new ZoomError("validation_error", "archive schedule job is invalid");
+    const capture = snapshotRecordingScheduleCapture(row.capture);
+    if (Object.keys(row.capture).some((key) => !["profile", "clientId", "configDir", "runtime", "cliPath"].includes(key)))
+        throw new ZoomError("validation_error", "archive schedule capture is invalid");
+    const schedule = parseRecordingArchiveSchedule(row.schedule);
+    if (schedule.scope.provider !== "zoom" ||
+        schedule.scope.account !== profileAccountKey(capture.profile) ||
+        !absolute(schedule.destination))
+        throw new ZoomError("validation_error", "archive schedule capture does not match its provider scope");
+    const job = Object.freeze({ version: 1, schedule, capture, state: row.state });
+    if (Buffer.byteLength(JSON.stringify(job)) > 32 * 1024)
+        throw new ZoomError("validation_error", "archive schedule metadata exceeds its byte limit");
+    return job;
+};
+export const createRecordingScheduleService = (deps) => {
+    const show = async (id, options = {}) => {
+        validateRecordingScheduleId(id);
+        checkCancelled(options.signal);
+        const found = await deps.store.load(id, options);
+        if (!found)
+            throw new ZoomError("not_found", "archive schedule was not found");
+        const job = parseRecordingScheduleJob(found);
+        if (job.schedule.id !== id)
+            throw new ZoomError("validation_error", "archive schedule storage returned a different job");
+        return job;
+    };
+    return {
+        async create(input, context, options = {}) {
+            options = { ...options };
+            checkCancelled(options.signal);
+            const capture = snapshotRecordingScheduleCapture(context);
+            const schedule = planRecordingArchiveSchedule({ ...input, scope: { provider: "zoom", account: profileAccountKey(capture.profile) } }, { now: deps.now?.() ?? Date.now() });
+            const job = parseRecordingScheduleJob({ version: 1, schedule, capture, state: "pending" });
+            const backend = deps.backend.backend;
+            const units = deps.backend.plan(job);
+            if (options.apply !== true || options.dryRun === true)
+                return { applied: false, backend, job, units, timerState: "not_checked" };
+            if (options.offline)
+                throw new ZoomError("configuration_error", "archive schedule installation requires online mode");
+            deps.backend.assertSupported();
+            const existing = await deps.store.load(schedule.id, { signal: options.signal });
+            if (existing && JSON.stringify(parseRecordingScheduleJob(existing).capture) !== JSON.stringify(capture))
+                throw new ZoomError("validation_error", "archive schedule id belongs to a different captured runtime or client; choose a new name");
+            await deps.store.save(job, { signal: options.signal });
+            await installRecordingArchiveSchedule({ backend, install: async (_, active) => deps.backend.install(job, active) }, schedule, { apply: true, signal: options.signal });
+            const enabled = parseRecordingScheduleJob({ ...job, state: "enabled" });
+            await deps.store.save(enabled, {});
+            return { applied: true, backend, job: enabled, units, timerState: "verified_enabled" };
+        },
+        async list(options = {}) {
+            checkCancelled(options.signal);
+            return (await deps.store.list(options)).map(parseRecordingScheduleJob);
+        },
+        show,
+        async *run(id, options = {}) {
+            options = { ...options };
+            if (options.offline)
+                throw new ZoomError("configuration_error", "archive schedule run requires online mode");
+            const job = await show(id, { signal: options.signal });
+            const window = recordingArchiveScheduleWindow(job.schedule, { now: deps.now?.() ?? Date.now() });
+            if (!window)
+                return;
+            const recordings = deps.recordings(job);
+            yield* syncRecordingArchive(recordings, {
+                ...window,
+                destination: job.schedule.destination,
+                maxBytes: job.schedule.maxBytes,
+                account: job.schedule.scope.account,
+                resume: true,
+                signal: options.signal,
+                now: deps.now,
+            });
+        },
+        async disable(id, options = {}) {
+            options = { ...options };
+            const job = await show(id, { signal: options.signal });
+            const backend = deps.backend.backend;
+            if (options.apply !== true || options.dryRun === true)
+                return { applied: false, backend, job, timerState: "not_checked" };
+            deps.backend.assertSupported();
+            await deps.backend.disable(job, { signal: options.signal });
+            const disabled = parseRecordingScheduleJob({ ...job, state: "disabled" });
+            await deps.store.save(disabled, {});
+            return { applied: true, backend, job: disabled, timerState: "verified_disabled" };
+        },
+    };
+};
+//# sourceMappingURL=recording-schedule.js.map

package/dist/recording-schedule.js.map

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

package/dist/recording-sync-store.d.ts

@@ -0,0 +1,3 @@
+import { type RecordingSyncCheckpointStore } from "@wirecat/cli-meetings";
+export declare function fileRecordingSyncCheckpointStore(path: string): RecordingSyncCheckpointStore;
+//# sourceMappingURL=recording-sync-store.d.ts.map

package/dist/recording-sync-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-sync-store.d.ts","sourceRoot":"","sources":["../src/recording-sync-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,4BAA4B,EAElC,MAAM,uBAAuB,CAAA;AA6D9B,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,4BAA4B,CAiH3F"}

package/dist/recording-sync-store.js

@@ -0,0 +1,187 @@
+import { randomUUID } from "node:crypto";
+import { lstat, mkdir, open, rename, rmdir, unlink } from "node:fs/promises";
+import { hostname } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { parseRecordingSyncCheckpoint, } from "@wirecat/cli-meetings";
+import { ZoomError } from "./errors.js";
+import { openOrdinaryFile } from "./ordinary-file.js";
+const maxBytes = 8 * 1024 ** 2;
+const ownerByteLimit = 32 * 1024;
+const code = (error) => error?.code;
+const conflict = (message) => {
+    throw new ZoomError("configuration_error", message);
+};
+const boundedJson = async (path, limit) => {
+    const file = await openOrdinaryFile(path);
+    try {
+        const size = (await file.stat()).size;
+        if (size > limit)
+            throw new ZoomError("validation_error", "archive checkpoint exceeds its byte limit");
+        const content = Buffer.alloc(size + 1);
+        const { bytesRead } = await file.read(content, 0, content.length, 0);
+        if (bytesRead !== size || bytesRead > limit)
+            throw new ZoomError("validation_error", "archive checkpoint changed while reading");
+        try {
+            return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(content.subarray(0, bytesRead)));
+        }
+        catch {
+            throw new ZoomError("validation_error", "archive checkpoint contains invalid JSON");
+        }
+    }
+    finally {
+        await file.close();
+    }
+};
+const ownerOf = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return conflict("archive checkpoint lock is unrecognized");
+    const row = value;
+    if (row.version !== 1 ||
+        !Number.isSafeInteger(row.pid) ||
+        Number(row.pid) <= 0 ||
+        typeof row.host !== "string" ||
+        !row.host ||
+        typeof row.token !== "string" ||
+        !/^[a-f0-9-]{36}$/.test(row.token) ||
+        typeof row.jobId !== "string" ||
+        !row.jobId)
+        return conflict("archive checkpoint lock is unrecognized");
+    return row;
+};
+const alive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return code(error) !== "ESRCH";
+    }
+};
+export function fileRecordingSyncCheckpointStore(path) {
+    if (typeof path !== "string" || !path.trim())
+        throw new ZoomError("validation_error", "archive checkpoint path is required");
+    const checkpointPath = resolve(path);
+    const lockPath = `${checkpointPath}.lock`;
+    const marker = join(lockPath, "owner.json");
+    const recoveryPath = `${lockPath}.recovery`;
+    const owners = new Map();
+    const readOwner = async () => {
+        try {
+            return ownerOf(await boundedJson(marker, ownerByteLimit));
+        }
+        catch {
+            return conflict("archive checkpoint lock is missing, incomplete or unrecognized");
+        }
+    };
+    const own = async (jobId, token) => {
+        const held = owners.get(token);
+        if (!held || held.jobId !== jobId)
+            return conflict("archive checkpoint lease is not owned");
+        const actual = await readOwner();
+        if (actual.token !== token || actual.jobId !== jobId || actual.host !== held.host || actual.pid !== held.pid)
+            return conflict("archive checkpoint lease changed");
+    };
+    const read = async () => {
+        try {
+            return parseRecordingSyncCheckpoint(await boundedJson(checkpointPath, maxBytes));
+        }
+        catch (error) {
+            if (code(error) === "ENOENT")
+                return null;
+            throw error;
+        }
+    };
+    return {
+        async acquire(jobId) {
+            if (typeof jobId !== "string" || !jobId.trim() || jobId.length > 4096)
+                throw new ZoomError("validation_error", "archive checkpoint job id is required");
+            await mkdir(dirname(checkpointPath), { recursive: true, mode: 0o700 });
+            try {
+                await mkdir(lockPath, { mode: 0o700 });
+            }
+            catch (error) {
+                if (code(error) !== "EEXIST")
+                    throw error;
+                const folder = await lstat(lockPath);
+                if (!folder.isDirectory() || folder.isSymbolicLink())
+                    return conflict("archive checkpoint lock must be an ordinary directory");
+                try {
+                    await mkdir(recoveryPath, { mode: 0o700 });
+                }
+                catch (error) {
+                    if (code(error) === "EEXIST")
+                        return conflict("archive checkpoint recovery is already active");
+                    throw error;
+                }
+                try {
+                    const prior = await readOwner();
+                    if (prior.host !== hostname() || alive(prior.pid))
+                        return conflict("archive checkpoint job is already active or owned by another host");
+                    const verified = await readOwner();
+                    if (verified.token !== prior.token)
+                        return conflict("archive checkpoint lock changed during stale recovery");
+                    await unlink(marker);
+                    await rmdir(lockPath);
+                    await mkdir(lockPath, { mode: 0o700 });
+                }
+                finally {
+                    await rmdir(recoveryPath);
+                }
+            }
+            const owner = { version: 1, pid: process.pid, host: hostname(), token: randomUUID(), jobId };
+            const file = await open(marker, "wx", 0o600);
+            try {
+                await file.writeFile(JSON.stringify(owner));
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
+            owners.set(owner.token, owner);
+            return {
+                token: owner.token,
+                async release() {
+                    await own(jobId, owner.token);
+                    await unlink(marker);
+                    await rmdir(lockPath);
+                    owners.delete(owner.token);
+                },
+            };
+        },
+        async read(jobId, token) {
+            await own(jobId, token);
+            return read();
+        },
+        async save(jobId, token, expectedRevision, value) {
+            await own(jobId, token);
+            const state = parseRecordingSyncCheckpoint(value);
+            const current = await read();
+            if ((current?.revision ?? null) !== expectedRevision || state.revision !== (expectedRevision ?? 0) + 1)
+                return conflict("archive checkpoint revision changed");
+            const content = JSON.stringify(state);
+            if (Buffer.byteLength(content) > maxBytes)
+                throw new ZoomError("validation_error", "archive checkpoint exceeds its byte limit");
+            const temporary = `${checkpointPath}.${token}.tmp`;
+            const file = await open(temporary, "wx", 0o600);
+            try {
+                await file.writeFile(content);
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
+            await own(jobId, token);
+            await rename(temporary, checkpointPath);
+            if (process.platform !== "win32") {
+                const directory = await open(dirname(checkpointPath), "r");
+                try {
+                    await directory.sync();
+                }
+                finally {
+                    await directory.close();
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=recording-sync-store.js.map