@panorama-ai/gateway 2.30.211 → 2.31.9

package/dist/database.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.types.js","sourceRoot":"","sources":["../src/database.types.ts"],"names":[],"mappings":"AA6wVA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE;QACN,KAAK,EAAE,EAAE;KACV;CACO,CAAA"}
+{"version":3,"file":"database.types.js","sourceRoot":"","sources":["../src/database.types.ts"],"names":[],"mappings":"AAksXA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE;QACN,KAAK,EAAE,EAAE;KACV;CACO,CAAA"}

package/dist/drive-sync/config.d.ts

@@ -0,0 +1,14 @@
+export type GatewayDriveSyncConfig = {
+    enabled: boolean;
+    rootDir: string;
+    stateDir: string;
+    clientKey: string | null;
+    changeLimit: number;
+    maxBatchesPerTick: number;
+    debounceMs: number;
+    pollIntervalMs: number;
+    localAuditIntervalMs: number;
+    networkTimeoutMs?: number;
+};
+export declare function resolveGatewayDriveSyncConfig(env?: NodeJS.ProcessEnv): GatewayDriveSyncConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/drive-sync/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/drive-sync/config.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CAqCxB"}

package/dist/drive-sync/config.js

@@ -0,0 +1,45 @@
+import { DRIVE_TRANSFER_POLICY } from '@panorama/shared/drive-transfer-policy';
+import process from 'node:process';
+const DEFAULT_DRIVE_SYNC_ROOT = '/panorama/drives';
+const DEFAULT_DRIVE_SYNC_STATE_DIR = '/var/lib/panorama/drive-sync';
+const DEFAULT_DRIVE_SYNC_CHANGE_LIMIT = 50;
+const DEFAULT_DRIVE_SYNC_MAX_BATCHES_PER_TICK = 25;
+const DEFAULT_DRIVE_SYNC_DEBOUNCE_MS = 1_000;
+const DEFAULT_DRIVE_SYNC_POLL_INTERVAL_MS = 5_000;
+const DEFAULT_DRIVE_SYNC_LOCAL_AUDIT_INTERVAL_MS = 300_000;
+const DEFAULT_DRIVE_SYNC_NETWORK_TIMEOUT_MS = DRIVE_TRANSFER_POLICY.networkRequestTimeoutMs;
+export function resolveGatewayDriveSyncConfig(env = process.env) {
+    return {
+        enabled: readBoolean('PANORAMA_DRIVE_SYNC_ENABLED', false, env),
+        rootDir: env.PANORAMA_DRIVE_SYNC_ROOT?.trim() || DEFAULT_DRIVE_SYNC_ROOT,
+        stateDir: env.PANORAMA_DRIVE_SYNC_STATE_DIR?.trim() || DEFAULT_DRIVE_SYNC_STATE_DIR,
+        clientKey: env.PANORAMA_DRIVE_SYNC_CLIENT_KEY?.trim() || null,
+        changeLimit: readPositiveInt('PANORAMA_DRIVE_SYNC_CHANGE_LIMIT', DEFAULT_DRIVE_SYNC_CHANGE_LIMIT, env),
+        maxBatchesPerTick: readPositiveInt('PANORAMA_DRIVE_SYNC_MAX_BATCHES_PER_TICK', DEFAULT_DRIVE_SYNC_MAX_BATCHES_PER_TICK, env),
+        debounceMs: readPositiveInt('PANORAMA_DRIVE_SYNC_DEBOUNCE_MS', DEFAULT_DRIVE_SYNC_DEBOUNCE_MS, env),
+        pollIntervalMs: readPositiveInt('PANORAMA_DRIVE_SYNC_POLL_INTERVAL_MS', DEFAULT_DRIVE_SYNC_POLL_INTERVAL_MS, env),
+        localAuditIntervalMs: readPositiveInt('PANORAMA_DRIVE_SYNC_LOCAL_AUDIT_INTERVAL_MS', DEFAULT_DRIVE_SYNC_LOCAL_AUDIT_INTERVAL_MS, env),
+        networkTimeoutMs: readPositiveInt('PANORAMA_DRIVE_SYNC_NETWORK_TIMEOUT_MS', DEFAULT_DRIVE_SYNC_NETWORK_TIMEOUT_MS, env),
+    };
+}
+function readPositiveInt(name, fallback, env = process.env) {
+    const raw = env[name]?.trim();
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${name} must be a positive number`);
+    }
+    return Math.floor(parsed);
+}
+function readBoolean(name, fallback, env = process.env) {
+    const raw = env[name]?.trim().toLowerCase();
+    if (!raw)
+        return fallback;
+    if (['1', 'true', 'yes', 'on'].includes(raw))
+        return true;
+    if (['0', 'false', 'no', 'off'].includes(raw))
+        return false;
+    throw new Error(`${name} must be a boolean`);
+}
+//# sourceMappingURL=config.js.map

package/dist/drive-sync/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/drive-sync/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,MAAM,uBAAuB,GAAG,kBAAkB,CAAA;AAClD,MAAM,4BAA4B,GAAG,8BAA8B,CAAA;AACnE,MAAM,+BAA+B,GAAG,EAAE,CAAA;AAC1C,MAAM,uCAAuC,GAAG,EAAE,CAAA;AAClD,MAAM,8BAA8B,GAAG,KAAK,CAAA;AAC5C,MAAM,mCAAmC,GAAG,KAAK,CAAA;AACjD,MAAM,0CAA0C,GAAG,OAAO,CAAA;AAC1D,MAAM,qCAAqC,GAAG,qBAAqB,CAAC,uBAAuB,CAAA;AAe3F,MAAM,UAAU,6BAA6B,CAC3C,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO;QACL,OAAO,EAAE,WAAW,CAAC,6BAA6B,EAAE,KAAK,EAAE,GAAG,CAAC;QAC/D,OAAO,EAAE,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE,IAAI,uBAAuB;QACxE,QAAQ,EAAE,GAAG,CAAC,6BAA6B,EAAE,IAAI,EAAE,IAAI,4BAA4B;QACnF,SAAS,EAAE,GAAG,CAAC,8BAA8B,EAAE,IAAI,EAAE,IAAI,IAAI;QAC7D,WAAW,EAAE,eAAe,CAC1B,kCAAkC,EAClC,+BAA+B,EAC/B,GAAG,CACJ;QACD,iBAAiB,EAAE,eAAe,CAChC,0CAA0C,EAC1C,uCAAuC,EACvC,GAAG,CACJ;QACD,UAAU,EAAE,eAAe,CACzB,iCAAiC,EACjC,8BAA8B,EAC9B,GAAG,CACJ;QACD,cAAc,EAAE,eAAe,CAC7B,sCAAsC,EACtC,mCAAmC,EACnC,GAAG,CACJ;QACD,oBAAoB,EAAE,eAAe,CACnC,6CAA6C,EAC7C,0CAA0C,EAC1C,GAAG,CACJ;QACD,gBAAgB,EAAE,eAAe,CAC/B,wCAAwC,EACxC,qCAAqC,EACrC,GAAG,CACJ;KACF,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CACtB,IAAY,EACZ,QAAgB,EAChB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAA;IACzB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,4BAA4B,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC;AAED,SAAS,WAAW,CAClB,IAAY,EACZ,QAAiB,EACjB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAA;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACzD,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAA;AAC9C,CAAC"}

package/dist/drive-sync/drive-sync-filesystem.d.ts

@@ -0,0 +1,39 @@
+import { type LocalDriveScanEntry } from './drive-sync-planner.js';
+export declare const DRIVE_SYNC_MAX_LOCAL_FILE_BYTES: number;
+export type LocalDriveScanResult = {
+    entries: Map<string, LocalDriveScanEntry>;
+    deferredPaths: Set<string>;
+    deferredFileCount: number;
+};
+export declare function resolveDriveLocalRoot(rootDir: string, driveId: string): string;
+export declare function parkStaleDriveLocalFolder(rootDir: string, driveId: string): Promise<string | null>;
+export declare function resolveDriveLocalPath(driveRoot: string, drivePath: string): string;
+export declare function resolveDirtyDrivePathsForDrive(driveRoot: string, dirtyLocalPaths: string[] | undefined): Set<string> | null;
+export declare function readLocalDriveEntryAtPath(params: {
+    driveId: string;
+    driveRoot: string;
+    drivePath: string;
+}): Promise<LocalDriveScanEntry | null>;
+export declare function scanLocalDriveEntries(params: {
+    driveId: string;
+    driveRoot: string;
+    rootDrivePaths?: Set<string>;
+}): Promise<LocalDriveScanResult>;
+export declare function writeLocalConflictCopy(params: {
+    driveRoot: string;
+    source: LocalDriveScanEntry;
+    sourceRootPath: string;
+    conflictRootPath: string;
+}): Promise<string>;
+export declare function resolveAvailableConflictDrivePath(params: {
+    driveRoot: string;
+    sourcePath: string;
+    sourceRootPath: string;
+    conflictRootPath: string;
+}): Promise<string>;
+export declare function buildSubtreeConflictRootPath(deletedSubtreePath: string): string;
+export declare function assertPathExists(filePath: string, errorMessage: string): Promise<void>;
+export declare function assertLocalPathIsNotSymlink(filePath: string, errorMessage: string): Promise<void>;
+export declare function assertNoSymlinkInExistingPath(driveRoot: string, targetPath: string): Promise<void>;
+export declare function normalizeDrivePath(input: string): string;
+//# sourceMappingURL=drive-sync-filesystem.d.ts.map

package/dist/drive-sync/drive-sync-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-sync-filesystem.d.ts","sourceRoot":"","sources":["../../src/drive-sync/drive-sync-filesystem.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAElE,eAAO,MAAM,+BAA+B,QAA2C,CAAA;AAEvF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IACzC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AASD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBxB;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAYlF;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS,GACpC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAoBpB;AAED,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAyDtC;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC7B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoKhC;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlB;AAED,wBAAsB,iCAAiC,CAAC,MAAM,EAAE;IAC9D,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB;AAED,wBAAgB,4BAA4B,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAK/E;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5F;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,6BAA6B,CACjD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWxD"}

package/dist/drive-sync/drive-sync-filesystem.js

@@ -0,0 +1,434 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { copyFile, lstat, mkdir, readdir, readlink, rename, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { DRIVE_TRANSFER_POLICY } from '@panorama/shared/drive-transfer-policy';
+export const DRIVE_SYNC_MAX_LOCAL_FILE_BYTES = DRIVE_TRANSFER_POLICY.objectFileMaxBytes;
+class UnstableLocalFileError extends Error {
+    drivePath;
+    constructor(drivePath) {
+        super(`Local drive file changed while it was being read; deferring sync for ${drivePath}`);
+        this.drivePath = drivePath;
+        this.name = 'UnstableLocalFileError';
+    }
+}
+export function resolveDriveLocalRoot(rootDir, driveId) {
+    if (!/^[0-9a-f-]{36}$/i.test(driveId)) {
+        throw new Error(`Invalid drive id "${driveId}"`);
+    }
+    return path.join(rootDir, driveId);
+}
+export async function parkStaleDriveLocalFolder(rootDir, driveId) {
+    const sourcePath = resolveDriveLocalRoot(rootDir, driveId);
+    try {
+        await lstat(sourcePath);
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+    const staleRoot = path.join(path.resolve(rootDir), '.stale');
+    await mkdir(staleRoot, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const targetPath = path.join(staleRoot, `${driveId}-${timestamp}-${randomUUID()}`);
+    await rename(sourcePath, targetPath);
+    return targetPath;
+}
+export function resolveDriveLocalPath(driveRoot, drivePath) {
+    const normalizedDrivePath = normalizeDrivePath(drivePath);
+    const resolvedRoot = path.resolve(driveRoot);
+    if (normalizedDrivePath === '/') {
+        return resolvedRoot;
+    }
+    const resolvedPath = path.resolve(resolvedRoot, normalizedDrivePath.slice(1));
+    if (resolvedPath !== resolvedRoot && !resolvedPath.startsWith(`${resolvedRoot}${path.sep}`)) {
+        throw new Error(`Drive path escapes drive root: ${drivePath}`);
+    }
+    return resolvedPath;
+}
+export function resolveDirtyDrivePathsForDrive(driveRoot, dirtyLocalPaths) {
+    if (!dirtyLocalPaths) {
+        return null;
+    }
+    const resolvedRoot = path.resolve(driveRoot);
+    const dirtyDrivePaths = new Set();
+    for (const dirtyLocalPath of dirtyLocalPaths) {
+        const resolvedDirtyPath = path.resolve(dirtyLocalPath);
+        const relativePath = path.relative(resolvedRoot, resolvedDirtyPath);
+        if (!relativePath) {
+            return null;
+        }
+        if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
+            continue;
+        }
+        dirtyDrivePaths.add(normalizeDrivePath(`/${relativePath.split(path.sep).join('/')}`));
+    }
+    return dirtyDrivePaths;
+}
+export async function readLocalDriveEntryAtPath(params) {
+    const absolutePath = resolveDriveLocalPath(params.driveRoot, params.drivePath);
+    let localStat;
+    try {
+        localStat = await lstat(absolutePath);
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+    if (localStat.isDirectory()) {
+        return {
+            driveId: params.driveId,
+            path: normalizeDrivePath(params.drivePath),
+            entryType: 'directory',
+            contentSha256: null,
+            sizeBytes: null,
+            mimeType: null,
+            absolutePath,
+        };
+    }
+    if (localStat.isFile()) {
+        return await readStableLocalFileEntry({
+            driveId: params.driveId,
+            drivePath: normalizeDrivePath(params.drivePath),
+            absolutePath,
+            initialStat: localStat,
+        });
+    }
+    if (localStat.isSymbolicLink()) {
+        const linkTarget = await readlink(absolutePath).catch(() => '');
+        return {
+            driveId: params.driveId,
+            path: normalizeDrivePath(params.drivePath),
+            entryType: 'symlink',
+            contentSha256: sha256Hex(Buffer.from(linkTarget)),
+            sizeBytes: Buffer.byteLength(linkTarget),
+            mimeType: null,
+            absolutePath,
+            unsupportedReason: 'symlink_entry_unsupported',
+        };
+    }
+    return {
+        driveId: params.driveId,
+        path: normalizeDrivePath(params.drivePath),
+        entryType: 'unsupported',
+        contentSha256: null,
+        sizeBytes: null,
+        mimeType: null,
+        absolutePath,
+        unsupportedReason: describeUnsupportedLocalEntry(localStat),
+    };
+}
+export async function scanLocalDriveEntries(params) {
+    const entries = new Map();
+    const deferredPaths = new Set();
+    const visitedDirectories = new Set();
+    let deferredFileCount = 0;
+    async function addAncestorDirectories(drivePath) {
+        const normalizedPath = normalizeDrivePath(drivePath);
+        const segments = normalizedPath.split('/').filter(Boolean);
+        for (let index = 1; index < segments.length; index += 1) {
+            const ancestorPath = normalizeDrivePath(`/${segments.slice(0, index).join('/')}`);
+            if (entries.has(ancestorPath)) {
+                continue;
+            }
+            const absolutePath = resolveDriveLocalPath(params.driveRoot, ancestorPath);
+            try {
+                const ancestorStat = await lstat(absolutePath);
+                if (ancestorStat.isDirectory()) {
+                    entries.set(ancestorPath, {
+                        driveId: params.driveId,
+                        path: ancestorPath,
+                        entryType: 'directory',
+                        contentSha256: null,
+                        sizeBytes: null,
+                        mimeType: null,
+                        absolutePath,
+                    });
+                }
+            }
+            catch (error) {
+                if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                    return;
+                }
+                throw error;
+            }
+        }
+    }
+    async function addPathEntry(absolutePath, drivePath, childStat) {
+        await addAncestorDirectories(drivePath);
+        if (childStat.isDirectory()) {
+            entries.set(drivePath, {
+                driveId: params.driveId,
+                path: drivePath,
+                entryType: 'directory',
+                contentSha256: null,
+                sizeBytes: null,
+                mimeType: null,
+                absolutePath,
+            });
+            await visitDirectory(absolutePath, drivePath);
+            return;
+        }
+        if (childStat.isFile()) {
+            try {
+                entries.set(drivePath, await readStableLocalFileEntry({
+                    driveId: params.driveId,
+                    drivePath,
+                    absolutePath,
+                    initialStat: childStat,
+                }));
+            }
+            catch (error) {
+                if (error instanceof UnstableLocalFileError) {
+                    deferredPaths.add(drivePath);
+                    deferredFileCount += 1;
+                    return;
+                }
+                throw error;
+            }
+            return;
+        }
+        if (childStat.isSymbolicLink()) {
+            const linkTarget = await readlink(absolutePath).catch(() => '');
+            entries.set(drivePath, {
+                driveId: params.driveId,
+                path: drivePath,
+                entryType: 'symlink',
+                contentSha256: sha256Hex(Buffer.from(linkTarget)),
+                sizeBytes: Buffer.byteLength(linkTarget),
+                mimeType: null,
+                absolutePath,
+                unsupportedReason: 'symlink_entry_unsupported',
+            });
+            return;
+        }
+        entries.set(drivePath, {
+            driveId: params.driveId,
+            path: drivePath,
+            entryType: 'unsupported',
+            contentSha256: null,
+            sizeBytes: null,
+            mimeType: null,
+            absolutePath,
+            unsupportedReason: describeUnsupportedLocalEntry(childStat),
+        });
+    }
+    async function visitDirectory(absoluteDirectoryPath, driveDirectoryPath) {
+        const resolvedDirectoryPath = path.resolve(absoluteDirectoryPath);
+        if (visitedDirectories.has(resolvedDirectoryPath)) {
+            return;
+        }
+        visitedDirectories.add(resolvedDirectoryPath);
+        const children = await readdir(absoluteDirectoryPath, { withFileTypes: true });
+        for (const child of children) {
+            const childAbsolutePath = path.join(absoluteDirectoryPath, child.name);
+            const childDrivePath = normalizeDrivePath(driveDirectoryPath === '/' ? `/${child.name}` : `${driveDirectoryPath}/${child.name}`);
+            let childStat;
+            try {
+                childStat = await lstat(childAbsolutePath);
+            }
+            catch (error) {
+                if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                    continue;
+                }
+                throw error;
+            }
+            await addPathEntry(childAbsolutePath, childDrivePath, childStat);
+        }
+    }
+    const rootDrivePaths = params.rootDrivePaths;
+    if (!rootDrivePaths) {
+        await visitDirectory(path.resolve(params.driveRoot), '/');
+        return { entries, deferredPaths, deferredFileCount };
+    }
+    for (const dirtyPath of rootDrivePaths) {
+        const normalizedDirtyPath = normalizeDrivePath(dirtyPath);
+        if (normalizedDirtyPath === '/') {
+            await visitDirectory(path.resolve(params.driveRoot), '/');
+            return { entries, deferredPaths, deferredFileCount };
+        }
+        const absolutePath = resolveDriveLocalPath(params.driveRoot, normalizedDirtyPath);
+        try {
+            const childStat = await lstat(absolutePath);
+            await addPathEntry(absolutePath, normalizedDirtyPath, childStat);
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                await addAncestorDirectories(normalizedDirtyPath);
+                continue;
+            }
+            throw error;
+        }
+    }
+    return { entries, deferredPaths, deferredFileCount };
+}
+export async function writeLocalConflictCopy(params) {
+    if (params.source.entryType !== 'file') {
+        throw new Error(`Cannot preserve non-file local conflict candidate: ${params.source.path}`);
+    }
+    const conflictDrivePath = await resolveAvailableConflictDrivePath({
+        driveRoot: params.driveRoot,
+        sourcePath: params.source.path,
+        sourceRootPath: params.sourceRootPath,
+        conflictRootPath: params.conflictRootPath,
+    });
+    const conflictLocalPath = resolveDriveLocalPath(params.driveRoot, conflictDrivePath);
+    await assertNoSymlinkInExistingPath(params.driveRoot, path.dirname(conflictLocalPath));
+    await mkdir(path.dirname(conflictLocalPath), { recursive: true });
+    await copyFile(params.source.absolutePath, conflictLocalPath);
+    return conflictDrivePath;
+}
+export async function resolveAvailableConflictDrivePath(params) {
+    const parsed = path.posix.parse(normalizeDrivePath(params.sourcePath));
+    const conflictRoot = normalizeDrivePath(params.conflictRootPath);
+    const sourceRoot = normalizeDrivePath(params.sourceRootPath);
+    const timestamp = new Date()
+        .toISOString()
+        .replace(/[-:]/g, '')
+        .replace(/\.\d{3}Z$/, 'Z');
+    const baseName = `${parsed.name} (Panorama conflict ${timestamp})`;
+    const targetDirectory = sourceRoot === params.sourcePath
+        ? parsed.dir || '/'
+        : path.posix.join(conflictRoot, path.posix.relative(sourceRoot, parsed.dir || '/'));
+    for (let attempt = 0; attempt < 100; attempt += 1) {
+        const suffix = attempt === 0 ? '' : ` ${attempt + 1}`;
+        const candidate = normalizeDrivePath(path.posix.join(targetDirectory, `${baseName}${suffix}${parsed.ext}`));
+        try {
+            await lstat(resolveDriveLocalPath(params.driveRoot, candidate));
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                return candidate;
+            }
+            throw error;
+        }
+    }
+    throw new Error(`Could not allocate a local conflict path for ${params.sourcePath}`);
+}
+export function buildSubtreeConflictRootPath(deletedSubtreePath) {
+    const parsed = path.posix.parse(normalizeDrivePath(deletedSubtreePath));
+    return normalizeDrivePath(path.posix.join(parsed.dir || '/', `${parsed.base} (Panorama conflicts)`));
+}
+export async function assertPathExists(filePath, errorMessage) {
+    try {
+        await stat(filePath);
+    }
+    catch {
+        throw new Error(errorMessage);
+    }
+}
+export async function assertLocalPathIsNotSymlink(filePath, errorMessage) {
+    try {
+        const current = await lstat(filePath);
+        if (current.isSymbolicLink()) {
+            throw new Error(errorMessage);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return;
+        }
+        throw error;
+    }
+}
+export async function assertNoSymlinkInExistingPath(driveRoot, targetPath) {
+    const resolvedRoot = path.resolve(driveRoot);
+    const resolvedTarget = path.resolve(targetPath);
+    const relativePath = path.relative(resolvedRoot, resolvedTarget);
+    if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
+        throw new Error(`Local drive path escapes drive root: ${targetPath}`);
+    }
+    if (!relativePath) {
+        return;
+    }
+    let currentPath = resolvedRoot;
+    for (const segment of relativePath.split(path.sep).filter(Boolean)) {
+        currentPath = path.join(currentPath, segment);
+        try {
+            const current = await lstat(currentPath);
+            if (current.isSymbolicLink()) {
+                throw new Error(`Local drive path contains a symlink: ${currentPath}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                return;
+            }
+            throw error;
+        }
+    }
+}
+export function normalizeDrivePath(input) {
+    if (!input.startsWith('/')) {
+        throw new Error(`Drive path must be absolute: ${input}`);
+    }
+    const segments = input.split('/').filter(Boolean);
+    if (segments.some((segment) => segment === '.' || segment === '..')) {
+        throw new Error(`Drive path must not contain traversal segments: ${input}`);
+    }
+    return input === '/' ? '/' : `/${segments.join('/')}`;
+}
+async function readStableLocalFileEntry(params) {
+    const initialSizeBytes = Number(params.initialStat.size);
+    const initialMtimeMs = Number(params.initialStat.mtimeMs);
+    const initialCtimeMs = Number(params.initialStat.ctimeMs);
+    if (initialSizeBytes > DRIVE_SYNC_MAX_LOCAL_FILE_BYTES) {
+        return {
+            driveId: params.driveId,
+            path: params.drivePath,
+            entryType: 'unsupported',
+            contentSha256: null,
+            sizeBytes: initialSizeBytes,
+            mimeType: null,
+            absolutePath: params.absolutePath,
+            mtimeMs: initialMtimeMs,
+            ctimeMs: initialCtimeMs,
+            unsupportedReason: `file_size_${initialSizeBytes}_exceeds_${DRIVE_SYNC_MAX_LOCAL_FILE_BYTES}_byte_limit`,
+        };
+    }
+    const contentSha256 = await sha256File(params.absolutePath);
+    const finalStat = await lstat(params.absolutePath);
+    if (!finalStat.isFile() ||
+        Number(finalStat.size) !== initialSizeBytes ||
+        Number(finalStat.mtimeMs) !== initialMtimeMs ||
+        Number(finalStat.ctimeMs) !== initialCtimeMs) {
+        throw new UnstableLocalFileError(params.drivePath);
+    }
+    return {
+        driveId: params.driveId,
+        path: params.drivePath,
+        entryType: 'file',
+        contentSha256,
+        sizeBytes: Number(finalStat.size),
+        mimeType: null,
+        absolutePath: params.absolutePath,
+        mtimeMs: Number(finalStat.mtimeMs),
+        ctimeMs: Number(finalStat.ctimeMs),
+    };
+}
+async function sha256File(filePath) {
+    const hash = createHash('sha256');
+    for await (const chunk of createReadStream(filePath)) {
+        hash.update(chunk);
+    }
+    return hash.digest('hex');
+}
+function describeUnsupportedLocalEntry(entry) {
+    if (entry.isBlockDevice())
+        return 'block_device_unsupported';
+    if (entry.isCharacterDevice())
+        return 'character_device_unsupported';
+    if (entry.isFIFO())
+        return 'fifo_unsupported';
+    if (entry.isSocket())
+        return 'socket_unsupported';
+    return 'unsupported_entry_type';
+}
+function sha256Hex(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+//# sourceMappingURL=drive-sync-filesystem.js.map

package/dist/drive-sync/drive-sync-filesystem.js.map

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

package/dist/drive-sync/drive-sync-planner.d.ts

@@ -0,0 +1,76 @@
+export type DriveSyncStateEntryType = 'file' | 'directory' | 'symlink' | 'unsupported';
+export type DriveSyncStateEntry = {
+    driveId: string;
+    path: string;
+    entryType: DriveSyncStateEntryType;
+    versionId: string | null;
+    contentSha256: string | null;
+    sizeBytes: number | null;
+    mimeType: string | null;
+};
+export type DriveSyncConflictRecord = {
+    driveId: string;
+    path: string;
+    conflictType: 'local_upload' | 'remote_apply';
+    reason: string | null;
+    localContentSha256: string | null;
+    localSizeBytes: number | null;
+    localVersionId: string | null;
+    conflictId: string | null;
+    conflictPath: string | null;
+    remoteBatchId: string | null;
+    remoteSequence: number | null;
+};
+export type LocalDriveScanEntry = {
+    driveId: string;
+    path: string;
+    entryType: DriveSyncStateEntryType;
+    contentSha256: string | null;
+    sizeBytes: number | null;
+    mimeType: string | null;
+    absolutePath: string;
+    mtimeMs?: number;
+    ctimeMs?: number;
+    unsupportedReason?: string;
+};
+export type LocalDriveMutation = {
+    request: Record<string, unknown>;
+    stateEntry?: DriveSyncStateEntry;
+    uploadBytes: number;
+    localFilePath?: string;
+    localFingerprint?: {
+        sizeBytes: number;
+        mtimeMs: number;
+        ctimeMs: number;
+    };
+};
+export type LocalDriveConflictAction = {
+    type: 'clear_conflict';
+    driveId: string;
+    path: string;
+    reason: 'candidate_preserved' | 'candidate_removed';
+} | {
+    type: 'update_conflict_path';
+    driveId: string;
+    path: string;
+    conflictPath: string;
+    reason: 'candidate_moved';
+};
+export type LocalDrivePlan = {
+    mutations: LocalDriveMutation[];
+    conflictActions: LocalDriveConflictAction[];
+};
+export type SyncedTree = Map<string, DriveSyncStateEntry>;
+export type LocalTree = Map<string, LocalDriveScanEntry>;
+export type ConflictSet = Map<string, DriveSyncConflictRecord>;
+export type LocalDrivePlannerInput = {
+    baseline: SyncedTree;
+    local: LocalTree;
+    deferredPaths: Set<string>;
+    conflicts: ConflictSet;
+};
+export declare function buildLocalDriveMutations(params: LocalDrivePlannerInput): LocalDriveMutation[];
+export declare function planLocalDriveSync(params: LocalDrivePlannerInput): LocalDrivePlan;
+export declare function localEntryMatchesBaseline(localEntry: LocalDriveScanEntry, baselineEntry: DriveSyncStateEntry): boolean;
+export declare function drivePathIsInSubtree(drivePath: string, subtreeRoot: string): boolean;
+//# sourceMappingURL=drive-sync-planner.d.ts.map