overleaf-codex 0.1.0-rc.1

package/dist/diagnostics/doctor.js

@@ -0,0 +1,209 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createOlcliOverleafBackend } from "../backend/index.js";
+import { redactForStatus } from "../auth/redact.js";
+import { EXIT_CODES } from "../errors.js";
+import { collectProjectStatus } from "./status.js";
+const REQUIRED_SECRET_IGNORE_ENTRIES = [
+    ".olcx/auth.local.json",
+    ".olcx/*.local.json",
+    ".olcx/*.secret.json",
+];
+const INIT_NEXT = "olcx init --project <overleaf-project-url-or-id>";
+const AUTH_NEXT = "olcx auth --from-env OLCX_OVERLEAF_SESSION";
+const GITIGNORE_NEXT = "add .olcx/auth.local.json, .olcx/*.local.json, and .olcx/*.secret.json to .gitignore";
+const RUNTIME_NEXT = "npm run typecheck";
+export async function runDoctorDiagnostics(options) {
+    const status = await collectProjectStatus({ cwd: options.cwd });
+    const checks = [
+        createNodeCheck(options.nodeVersion ?? process.versions.node),
+        {
+            level: "pass",
+            name: "Project root",
+            message: status.projectRoot,
+        },
+        createConfigCheck(status.config),
+        createEndpointCheck(status.config),
+        createAuthCheck(status.auth),
+        createBackendCheck(options.backendAvailable ?? typeof createOlcliOverleafBackend === "function"),
+        await createGitignoreCheck(status.projectRoot),
+        createPdfOutputCheck(status.config),
+        {
+            level: "warn",
+            name: "Auth validity",
+            message: "not checked by offline doctor; Overleaf may reject expired sessions later",
+        },
+    ];
+    return {
+        checks,
+        ...selectDoctorOutcome(checks, status),
+    };
+}
+export function formatDoctorReport(report) {
+    const lines = [
+        "olcx doctor",
+        ...report.checks.map((check) => `[${check.level}] ${redactForStatus(check.name)}: ${redactForStatus(check.message)}`),
+    ];
+    if (report.exitCode !== EXIT_CODES.SUCCESS) {
+        lines.push(`Error: ${redactForStatus(report.errorMessage ?? "olcx doctor found problems.")}`);
+        if (report.next !== undefined) {
+            lines.push(`Next: ${redactForStatus(report.next)}`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+function createNodeCheck(version) {
+    if (nodeMajor(version) >= 20) {
+        return {
+            level: "pass",
+            name: "Node.js",
+            message: `${version} satisfies >=20`,
+        };
+    }
+    return {
+        level: "fail",
+        name: "Node.js",
+        message: `${version} does not satisfy >=20`,
+        next: RUNTIME_NEXT,
+    };
+}
+function createConfigCheck(config) {
+    if (config.state === "configured") {
+        return {
+            level: "pass",
+            name: "Config",
+            message: ".olcx/config.json is valid",
+        };
+    }
+    return {
+        level: "fail",
+        name: "Config",
+        message: config.state === "missing" ? "missing .olcx/config.json" : "invalid .olcx/config.json",
+        next: INIT_NEXT,
+    };
+}
+function createAuthCheck(auth) {
+    if (auth.state === "present") {
+        return {
+            level: "pass",
+            name: "Auth file",
+            message: ".olcx/auth.local.json is valid",
+        };
+    }
+    return {
+        level: "fail",
+        name: "Auth file",
+        message: auth.state === "missing" ? "missing .olcx/auth.local.json" : "invalid .olcx/auth.local.json",
+        next: AUTH_NEXT,
+    };
+}
+function createEndpointCheck(config) {
+    if (config.state === "configured") {
+        return {
+            level: "pass",
+            name: "Overleaf endpoint",
+            message: config.overleafBaseUrl ?? "unknown",
+        };
+    }
+    return {
+        level: "warn",
+        name: "Overleaf endpoint",
+        message: "unknown until project config is valid",
+    };
+}
+function createBackendCheck(backendAvailable) {
+    if (backendAvailable) {
+        return {
+            level: "pass",
+            name: "Backend module",
+            message: "olcli adapter available",
+        };
+    }
+    return {
+        level: "fail",
+        name: "Backend module",
+        message: "olcli adapter unavailable",
+        next: RUNTIME_NEXT,
+    };
+}
+async function createGitignoreCheck(projectRoot) {
+    const missing = await missingSecretIgnoreEntries(projectRoot);
+    if (missing.length === 0) {
+        return {
+            level: "pass",
+            name: "Git ignore",
+            message: "local auth patterns are ignored",
+        };
+    }
+    return {
+        level: "fail",
+        name: "Git ignore",
+        message: `missing ${missing.join(", ")}`,
+        next: GITIGNORE_NEXT,
+    };
+}
+function createPdfOutputCheck(config) {
+    if (config.state === "configured") {
+        return {
+            level: "pass",
+            name: "PDF output",
+            message: `configured ${config.pdfPath}`,
+        };
+    }
+    return {
+        level: "warn",
+        name: "PDF output",
+        message: "unknown until project config is valid",
+    };
+}
+function selectDoctorOutcome(checks, status) {
+    const runtimeFailure = checks.find((check) => check.level === "fail" && (check.name === "Node.js" || check.name === "Backend module"));
+    if (runtimeFailure !== undefined) {
+        return {
+            exitCode: EXIT_CODES.INTERNAL_ERROR,
+            errorMessage: "olcx doctor found local runtime problems.",
+            next: runtimeFailure.next ?? RUNTIME_NEXT,
+        };
+    }
+    const configFailure = checks.find((check) => check.level === "fail" && (check.name === "Config" || check.name === "Git ignore"));
+    if (configFailure !== undefined) {
+        return {
+            exitCode: EXIT_CODES.CONFIG_ERROR,
+            errorMessage: "olcx doctor found project configuration problems.",
+            next: status.config.state === "configured" ? configFailure.next ?? GITIGNORE_NEXT : INIT_NEXT,
+        };
+    }
+    const authFailure = checks.find((check) => check.level === "fail" && check.name === "Auth file");
+    if (authFailure !== undefined) {
+        return {
+            exitCode: EXIT_CODES.AUTH_ERROR,
+            errorMessage: "olcx doctor found auth problems.",
+            next: authFailure.next ?? AUTH_NEXT,
+        };
+    }
+    return { exitCode: EXIT_CODES.SUCCESS };
+}
+async function missingSecretIgnoreEntries(projectRoot) {
+    let content = "";
+    try {
+        content = await readFile(join(projectRoot, ".gitignore"), "utf8");
+    }
+    catch (error) {
+        if (!isNodeError(error, "ENOENT")) {
+            throw error;
+        }
+    }
+    const entries = new Set(content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0));
+    return REQUIRED_SECRET_IGNORE_ENTRIES.filter((entry) => !entries.has(entry));
+}
+function nodeMajor(version) {
+    const major = Number.parseInt(version.split(".")[0] ?? "", 10);
+    return Number.isFinite(major) ? major : 0;
+}
+function isNodeError(error, code) {
+    return typeof error === "object" && error !== null && error.code === code;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/diagnostics/doctor.js.map

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

package/dist/diagnostics/status.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectStatusReport } from "./types.js";
+export interface CollectProjectStatusOptions {
+    cwd: string;
+}
+export declare function collectProjectStatus(options: CollectProjectStatusOptions): Promise<ProjectStatusReport>;
+export declare function formatProjectStatus(report: ProjectStatusReport): string;

package/dist/diagnostics/status.js

@@ -0,0 +1,110 @@
+import { readProjectAuth, summarizeProjectAuth } from "../auth/projectAuth.js";
+import { redactForStatus } from "../auth/redact.js";
+import { readProjectConfig, summarizeProjectConfig } from "../config/projectConfig.js";
+import { findProjectRoot } from "../config/projectRoot.js";
+import { isOlcxError } from "../errors.js";
+const INIT_NEXT = "olcx init --project <overleaf-project-url-or-id>";
+const AUTH_NEXT = "olcx auth --from-env OLCX_OVERLEAF_SESSION";
+export async function collectProjectStatus(options) {
+    const projectRoot = await findProjectRoot(options.cwd);
+    const config = await collectConfigStatus(projectRoot);
+    const auth = await collectAuthStatus(projectRoot);
+    const next = unique([
+        config.state === "configured" ? undefined : INIT_NEXT,
+        auth.state === "present" ? undefined : AUTH_NEXT,
+    ]);
+    return {
+        projectRoot,
+        config,
+        auth,
+        next,
+    };
+}
+export function formatProjectStatus(report) {
+    const lines = [
+        "olcx status",
+        `Project root: ${redactForStatus(report.projectRoot)}`,
+        `Project binding: ${report.config.state}`,
+        `Project id: ${report.config.hasProjectId ? "present" : "missing"}`,
+        ...(report.config.state === "configured" && report.config.overleafBaseUrl !== undefined
+            ? [`Overleaf endpoint: ${redactForStatus(report.config.overleafBaseUrl)}`]
+            : []),
+        `PDF output: ${redactForStatus(report.config.pdfPath)}`,
+        `Auth: ${report.auth.state}`,
+        `Account: ${redactForStatus(report.auth.accountLabel)}`,
+    ];
+    if (report.auth.state === "present" && report.auth.source !== undefined) {
+        lines.push(`Auth source: ${redactForStatus(report.auth.source)}`);
+    }
+    if (report.auth.state === "present" && report.auth.updatedAt !== undefined) {
+        lines.push(`Auth updated: ${redactForStatus(report.auth.updatedAt)}`);
+    }
+    for (const next of report.next) {
+        lines.push(`Next: ${redactForStatus(next)}`);
+    }
+    return lines.join("\n") + "\n";
+}
+async function collectConfigStatus(projectRoot) {
+    try {
+        const config = await readProjectConfig(projectRoot);
+        const summary = summarizeProjectConfig(config);
+        return {
+            state: "configured",
+            hasProjectId: summary.hasProjectId === true,
+            overleafBaseUrl: String(summary.overleaf?.baseUrl ?? "unknown"),
+            pdfPath: String(summary.pdfPath ?? "unknown"),
+        };
+    }
+    catch (error) {
+        if (isOlcxError(error) && error.code === "PROJECT_CONFIG_NOT_FOUND") {
+            return {
+                state: "missing",
+                hasProjectId: false,
+                pdfPath: "unknown",
+                reason: redactForStatus(error.message),
+            };
+        }
+        if (isOlcxError(error) && error.code === "PROJECT_CONFIG_INVALID") {
+            return {
+                state: "invalid",
+                hasProjectId: false,
+                pdfPath: "unknown",
+                reason: redactForStatus(error.message),
+            };
+        }
+        throw error;
+    }
+}
+async function collectAuthStatus(projectRoot) {
+    try {
+        const auth = await readProjectAuth(projectRoot);
+        const summary = summarizeProjectAuth(auth);
+        return {
+            state: "present",
+            accountLabel: summary.accountLabel,
+            source: summary.source,
+            updatedAt: summary.updatedAt,
+        };
+    }
+    catch (error) {
+        if (isOlcxError(error) && error.code === "PROJECT_AUTH_NOT_FOUND") {
+            return {
+                state: "missing",
+                accountLabel: "unknown",
+                reason: redactForStatus(error.message),
+            };
+        }
+        if (isOlcxError(error) && error.code === "PROJECT_AUTH_INVALID") {
+            return {
+                state: "invalid",
+                accountLabel: "unknown",
+                reason: redactForStatus(error.message),
+            };
+        }
+        throw error;
+    }
+}
+function unique(values) {
+    return [...new Set(values.filter((value) => value !== undefined))];
+}
+//# sourceMappingURL=status.js.map

package/dist/diagnostics/status.js.map

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

package/dist/diagnostics/types.d.ts

@@ -0,0 +1,33 @@
+import type { ExitCode } from "../errors.js";
+export type DiagnosticState = "configured" | "present" | "missing" | "invalid" | "not-checked";
+export type DiagnosticLevel = "pass" | "warn" | "fail";
+export interface ProjectStatusReport {
+    projectRoot: string;
+    config: {
+        state: "configured" | "missing" | "invalid";
+        hasProjectId: boolean;
+        overleafBaseUrl?: string;
+        pdfPath: string;
+        reason?: string;
+    };
+    auth: {
+        state: "present" | "missing" | "invalid";
+        accountLabel: string;
+        source?: string;
+        updatedAt?: string;
+        reason?: string;
+    };
+    next: string[];
+}
+export interface DiagnosticCheck {
+    level: DiagnosticLevel;
+    name: string;
+    message: string;
+    next?: string;
+}
+export interface DoctorReport {
+    checks: DiagnosticCheck[];
+    exitCode: ExitCode;
+    errorMessage?: string;
+    next?: string;
+}

package/dist/diagnostics/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diagnostics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diagnostics/types.ts"],"names":[],"mappings":""}

package/dist/endpoint/overleafEndpoint.d.ts

@@ -0,0 +1,36 @@
+import type { OverleafBaseUrl } from "../config/types.js";
+export type OverleafEndpointAlias = "www" | "cn";
+export interface OverleafEndpointDefinition {
+    alias: OverleafEndpointAlias;
+    baseUrl: OverleafBaseUrl;
+    probeUrl: `${OverleafBaseUrl}/project`;
+}
+export interface EndpointProbeResult {
+    alias: OverleafEndpointAlias;
+    baseUrl: OverleafBaseUrl;
+    available: boolean;
+    latencyMs: number;
+    status?: number;
+    failureReason?: string;
+}
+export type FetchLike = (url: string, init?: RequestInit) => Promise<{
+    status: number;
+    ok: boolean;
+}>;
+export declare const OVERLEAF_ENDPOINTS: readonly OverleafEndpointDefinition[];
+export declare function normalizeOverleafBaseUrl(value: string): OverleafBaseUrl;
+export declare function endpointAliasFromBaseUrl(baseUrl: OverleafBaseUrl): OverleafEndpointAlias;
+export declare function resolveEndpointInput(value: string): OverleafEndpointDefinition;
+export declare function probeOverleafEndpoint(input: {
+    endpoint: OverleafEndpointDefinition;
+    timeoutMs: number;
+    fetchImpl?: FetchLike;
+    now?: () => number;
+}): Promise<EndpointProbeResult>;
+export declare function testOverleafEndpoints(input?: {
+    timeoutMs?: number;
+    fetchImpl?: FetchLike;
+    now?: () => number;
+}): Promise<EndpointProbeResult[]>;
+export declare function selectFastestAvailableEndpoint(results: EndpointProbeResult[]): EndpointProbeResult | undefined;
+export declare function formatEndpointProbeResult(result: EndpointProbeResult): string;

package/dist/endpoint/overleafEndpoint.js

@@ -0,0 +1,105 @@
+import { createOlcxError, redactSensitive } from "../cli-behavior.js";
+export const OVERLEAF_ENDPOINTS = [
+    { alias: "www", baseUrl: "https://www.overleaf.com", probeUrl: "https://www.overleaf.com/project" },
+    { alias: "cn", baseUrl: "https://cn.overleaf.com", probeUrl: "https://cn.overleaf.com/project" },
+];
+export function normalizeOverleafBaseUrl(value) {
+    const normalized = value.trim().replace(/\/+$/, "");
+    if (normalized === "https://www.overleaf.com" || normalized === "https://cn.overleaf.com") {
+        return normalized;
+    }
+    throw createOlcxError({
+        code: "USER_INPUT_ERROR",
+        message: "Unsupported Overleaf endpoint.",
+        hint: "Use endpoint alias www or cn.",
+        details: { value },
+    });
+}
+export function endpointAliasFromBaseUrl(baseUrl) {
+    return baseUrl === "https://cn.overleaf.com" ? "cn" : "www";
+}
+export function resolveEndpointInput(value) {
+    const normalized = value.trim().toLowerCase();
+    const endpoint = OVERLEAF_ENDPOINTS.find((candidate) => candidate.alias === normalized || candidate.baseUrl === normalized);
+    if (endpoint === undefined) {
+        throw createOlcxError({
+            code: "USER_INPUT_ERROR",
+            message: "Unsupported Overleaf endpoint.",
+            hint: "Use endpoint alias www or cn.",
+            details: { accepted: ["www", "cn"], value },
+        });
+    }
+    return endpoint;
+}
+export async function probeOverleafEndpoint(input) {
+    const fetchImpl = input.fetchImpl ?? ((url, init) => fetch(url, init));
+    const now = input.now ?? Date.now;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), input.timeoutMs);
+    const started = now();
+    try {
+        const response = await fetchImpl(input.endpoint.probeUrl, {
+            method: "GET",
+            redirect: "manual",
+            signal: controller.signal,
+            headers: { "User-Agent": "olcx-endpoint-probe" },
+        });
+        const latencyMs = Math.max(0, Math.round(now() - started));
+        if (response.status < 500) {
+            return {
+                alias: input.endpoint.alias,
+                baseUrl: input.endpoint.baseUrl,
+                available: true,
+                latencyMs,
+                status: response.status,
+            };
+        }
+        return {
+            alias: input.endpoint.alias,
+            baseUrl: input.endpoint.baseUrl,
+            available: false,
+            latencyMs,
+            status: response.status,
+            failureReason: `http ${response.status}`,
+        };
+    }
+    catch (error) {
+        const latencyMs = Math.max(0, Math.round(now() - started));
+        const failureReason = error instanceof Error && error.name === "AbortError"
+            ? `timeout after ${input.timeoutMs}ms`
+            : redactEndpointFailureReason(error instanceof Error ? error.message : String(error));
+        return {
+            alias: input.endpoint.alias,
+            baseUrl: input.endpoint.baseUrl,
+            available: false,
+            latencyMs,
+            failureReason,
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function redactEndpointFailureReason(value) {
+    return redactSensitive(value).replace(/<redacted-secret>/g, "<redacted-value>").slice(0, 200);
+}
+export async function testOverleafEndpoints(input = {}) {
+    const timeoutMs = input.timeoutMs ?? 5000;
+    return Promise.all(OVERLEAF_ENDPOINTS.map((endpoint) => probeOverleafEndpoint({
+        endpoint,
+        timeoutMs,
+        fetchImpl: input.fetchImpl,
+        now: input.now,
+    })));
+}
+export function selectFastestAvailableEndpoint(results) {
+    return results
+        .filter((result) => result.available)
+        .sort((left, right) => left.latencyMs - right.latencyMs)[0];
+}
+export function formatEndpointProbeResult(result) {
+    const status = result.status === undefined ? "" : ` status ${result.status}`;
+    const failure = result.failureReason === undefined ? "" : ` ${result.failureReason}`;
+    return `- ${result.alias} ${result.baseUrl} ${result.available ? "available" : "unavailable"} ${result.latencyMs}ms${status}${failure}`;
+}
+//# sourceMappingURL=overleafEndpoint.js.map

package/dist/endpoint/overleafEndpoint.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,32 @@
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly INTERNAL_ERROR: 1;
+    readonly USER_INPUT_ERROR: 2;
+    readonly CONFIG_ERROR: 3;
+    readonly AUTH_ERROR: 4;
+    readonly NETWORK_ERROR: 5;
+    readonly SYNC_CONFLICT: 6;
+    readonly COMPILE_FAILED: 7;
+};
+export type ExitCodeName = keyof typeof EXIT_CODES;
+export type ExitCode = (typeof EXIT_CODES)[ExitCodeName];
+export type OlcxErrorCode = "USER_INPUT_ERROR" | "PROJECT_CONFIG_NOT_FOUND" | "PROJECT_CONFIG_INVALID" | "PROJECT_AUTH_NOT_FOUND" | "PROJECT_AUTH_INVALID" | "BACKEND_AUTH_FAILED" | "BACKEND_NETWORK_ERROR" | "BACKEND_PROTOCOL_ERROR" | "SYNC_CONFLICT" | "SYNC_UNSAFE_OPERATION" | "COMPILE_FAILED" | "COMPILE_TIMEOUT" | "IO_ERROR" | "INTERNAL_ERROR";
+export declare const ERROR_CODE_EXIT_CODES: Record<OlcxErrorCode, ExitCode>;
+export interface OlcxError extends Error {
+    name: "OlcxError";
+    code: OlcxErrorCode;
+    exitCode: ExitCode;
+    hint?: string;
+    details?: Record<string, unknown>;
+    cause?: unknown;
+}
+export interface CreateOlcxErrorInput {
+    code: OlcxErrorCode;
+    message: string;
+    hint?: string;
+    details?: Record<string, unknown>;
+    cause?: unknown;
+}
+export declare function mapErrorCodeToExitCode(code: OlcxErrorCode): ExitCode;
+export declare function createOlcxError(input: CreateOlcxErrorInput): OlcxError;
+export declare function isOlcxError(error: unknown): error is OlcxError;

package/dist/errors.js

@@ -0,0 +1,53 @@
+export const EXIT_CODES = {
+    SUCCESS: 0,
+    INTERNAL_ERROR: 1,
+    USER_INPUT_ERROR: 2,
+    CONFIG_ERROR: 3,
+    AUTH_ERROR: 4,
+    NETWORK_ERROR: 5,
+    SYNC_CONFLICT: 6,
+    COMPILE_FAILED: 7,
+};
+export const ERROR_CODE_EXIT_CODES = {
+    USER_INPUT_ERROR: EXIT_CODES.USER_INPUT_ERROR,
+    PROJECT_CONFIG_NOT_FOUND: EXIT_CODES.CONFIG_ERROR,
+    PROJECT_CONFIG_INVALID: EXIT_CODES.CONFIG_ERROR,
+    PROJECT_AUTH_NOT_FOUND: EXIT_CODES.AUTH_ERROR,
+    PROJECT_AUTH_INVALID: EXIT_CODES.AUTH_ERROR,
+    BACKEND_AUTH_FAILED: EXIT_CODES.AUTH_ERROR,
+    BACKEND_NETWORK_ERROR: EXIT_CODES.NETWORK_ERROR,
+    BACKEND_PROTOCOL_ERROR: EXIT_CODES.NETWORK_ERROR,
+    SYNC_CONFLICT: EXIT_CODES.SYNC_CONFLICT,
+    SYNC_UNSAFE_OPERATION: EXIT_CODES.SYNC_CONFLICT,
+    COMPILE_FAILED: EXIT_CODES.COMPILE_FAILED,
+    COMPILE_TIMEOUT: EXIT_CODES.COMPILE_FAILED,
+    IO_ERROR: EXIT_CODES.INTERNAL_ERROR,
+    INTERNAL_ERROR: EXIT_CODES.INTERNAL_ERROR,
+};
+export function mapErrorCodeToExitCode(code) {
+    return ERROR_CODE_EXIT_CODES[code];
+}
+export function createOlcxError(input) {
+    const error = new Error(input.message);
+    error.name = "OlcxError";
+    error.code = input.code;
+    error.exitCode = mapErrorCodeToExitCode(input.code);
+    if (input.hint !== undefined) {
+        error.hint = input.hint;
+    }
+    if (input.details !== undefined) {
+        error.details = input.details;
+    }
+    if (input.cause !== undefined) {
+        error.cause = input.cause;
+    }
+    return error;
+}
+export function isOlcxError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        error.name === "OlcxError" &&
+        typeof error.code === "string" &&
+        typeof error.exitCode === "number");
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;IACV,cAAc,EAAE,CAAC;IACjB,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,CAAC;CACT,CAAC;AAqBX,MAAM,CAAC,MAAM,qBAAqB,GAAoC;IACpE,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;IAC7C,wBAAwB,EAAE,UAAU,CAAC,YAAY;IACjD,sBAAsB,EAAE,UAAU,CAAC,YAAY;IAC/C,sBAAsB,EAAE,UAAU,CAAC,UAAU;IAC7C,oBAAoB,EAAE,UAAU,CAAC,UAAU;IAC3C,mBAAmB,EAAE,UAAU,CAAC,UAAU;IAC1C,qBAAqB,EAAE,UAAU,CAAC,aAAa;IAC/C,sBAAsB,EAAE,UAAU,CAAC,aAAa;IAChD,aAAa,EAAE,UAAU,CAAC,aAAa;IACvC,qBAAqB,EAAE,UAAU,CAAC,aAAa;IAC/C,cAAc,EAAE,UAAU,CAAC,cAAc;IACzC,eAAe,EAAE,UAAU,CAAC,cAAc;IAC1C,QAAQ,EAAE,UAAU,CAAC,cAAc;IACnC,cAAc,EAAE,UAAU,CAAC,cAAc;CAC1C,CAAC;AAmBF,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACxD,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;IACpD,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;IACzB,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,KAAK,CAAC,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEpD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAA4B,CAAC,IAAI,KAAK,WAAW;QAClD,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;QACtD,OAAQ,KAAgC,CAAC,QAAQ,KAAK,QAAQ,CAC/D,CAAC;AACJ,CAAC"}

package/dist/sync/apply.d.ts

@@ -0,0 +1,14 @@
+import { type ProjectAuth } from "../auth/types.js";
+import { type OverleafBackend } from "../backend/types.js";
+import { type RemoteFileSnapshot, type SyncPlan } from "./types.js";
+export interface ApplySyncPlanResult {
+    uploaded: Map<string, RemoteFileSnapshot>;
+    downloaded: string[];
+}
+export declare function applySyncPlan(input: {
+    projectRoot: string;
+    backend: OverleafBackend;
+    projectId: string;
+    auth: ProjectAuth;
+    plan: SyncPlan;
+}): Promise<ApplySyncPlanResult>;