@vkenliu/adit-cloud 0.2.0

package/dist/transcript/auto-upload.js

@@ -0,0 +1,75 @@
+/**
+ * Auto-upload trigger — fire-and-forget transcript upload after hook events.
+ *
+ * Called from the hooks system via dynamic import. Fully fail-open:
+ * any error is swallowed so it never blocks the AI agent.
+ *
+ * Designed to be called on every hook event. Internally deduplicates
+ * by checking if there's actually new data to upload before doing work.
+ */
+import { loadCloudConfig } from "../config.js";
+import { loadCredentials, isTokenExpired } from "../auth/credentials.js";
+import { CloudClient } from "../http/client.js";
+import { CloudNetworkError, CloudAuthError } from "../http/errors.js";
+import { registerTranscript, processTranscriptUploads } from "./manager.js";
+/**
+ * Register a transcript and trigger pending uploads.
+ *
+ * Call this from hook handlers whenever a transcript_path is seen.
+ * The function is idempotent — calling it multiple times with the
+ * same path is safe and cheap.
+ *
+ * @param db - Open database connection
+ * @param sessionId - Current session ID
+ * @param transcriptPath - Absolute path to the transcript JSONL file
+ * @param type - Upload type (default: "transcript")
+ */
+export async function triggerTranscriptUpload(db, sessionId, transcriptPath, type = "transcript") {
+    const cloudConfig = loadCloudConfig();
+    // 1. Check transcript upload is not explicitly disabled
+    if (!cloudConfig.transcriptUpload.enabled)
+        return;
+    if (process.env.ADIT_CLOUD_ENABLED === "false")
+        return;
+    // 2. Check credentials exist — credentials are the implicit opt-in
+    //    (same pattern as auto-sync: stored credentials enable the feature)
+    const credentials = loadCredentials();
+    if (!credentials)
+        return;
+    // 3. Resolve server URL: env var takes priority, fall back to credentials
+    //    (same resolution strategy as triggerAutoSync)
+    const serverUrl = cloudConfig.serverUrl ?? credentials.serverUrl;
+    if (!serverUrl)
+        return;
+    // 3a. If env var specifies a different server than credentials, skip
+    if (cloudConfig.serverUrl && credentials.serverUrl !== cloudConfig.serverUrl)
+        return;
+    // 4. Register the transcript (idempotent)
+    registerTranscript(db, sessionId, transcriptPath, serverUrl);
+    // 5. Process any pending uploads
+    if (isTokenExpired(credentials)) {
+        // Let CloudClient try to refresh
+    }
+    try {
+        const client = new CloudClient(serverUrl, credentials);
+        await processTranscriptUploads({
+            db,
+            client,
+            config: cloudConfig.transcriptUpload,
+            serverUrl,
+            type,
+        });
+    }
+    catch (error) {
+        // Fail silently — this is fire-and-forget
+        if (process.env.ADIT_DEBUG) {
+            const msg = error instanceof CloudNetworkError
+                ? `[adit-transcript] upload skipped: server unreachable — ${error.message}`
+                : error instanceof CloudAuthError
+                    ? `[adit-transcript] upload skipped: auth failed — ${error.message}`
+                    : `[adit-transcript] upload failed: ${error instanceof Error ? error.message : String(error)}`;
+            process.stderr.write(msg + "\n");
+        }
+    }
+}
+//# sourceMappingURL=auto-upload.js.map

package/dist/transcript/auto-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-upload.js","sourceRoot":"","sources":["../../src/transcript/auto-upload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG5E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,EAAqB,EACrB,SAAiB,EACjB,cAAsB,EACtB,OAAuB,YAAY;IAEnC,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IAEtC,wDAAwD;IACxD,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO;QAAE,OAAO;IAClD,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,OAAO;QAAE,OAAO;IAEvD,mEAAmE;IACnE,wEAAwE;IACxE,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,0EAA0E;IAC1E,mDAAmD;IACnD,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS,CAAC;IACjE,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,qEAAqE;IACrE,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS,KAAK,WAAW,CAAC,SAAS;QAAE,OAAO;IAErF,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IAE7D,iCAAiC;IACjC,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,iCAAiC;IACnC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACvD,MAAM,wBAAwB,CAAC;YAC7B,EAAE;YACF,MAAM;YACN,MAAM,EAAE,WAAW,CAAC,gBAAgB;YACpC,SAAS;YACT,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0CAA0C;QAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;YAC3B,MAAM,GAAG,GACP,KAAK,YAAY,iBAAiB;gBAChC,CAAC,CAAC,0DAA0D,KAAK,CAAC,OAAO,EAAE;gBAC3E,CAAC,CAAC,KAAK,YAAY,cAAc;oBAC/B,CAAC,CAAC,mDAAmD,KAAK,CAAC,OAAO,EAAE;oBACpE,CAAC,CAAC,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACrG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/transcript/index.d.ts

@@ -0,0 +1,4 @@
+export { registerTranscript, processTranscriptUploads, type TranscriptManagerOptions, type TranscriptProcessResult, } from "./manager.js";
+export { triggerTranscriptUpload, } from "./auto-upload.js";
+export { uploadChunk, uploadFull, readIncrement, compressGzip, getFileSize, checkUploadStatus, lookupUploadByPath, type SyncUploadType, type SyncUploadResponse, type SyncUploadStatus, type UploadChunkParams, } from "./uploader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transcript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transcript/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC"}

package/dist/transcript/index.js

@@ -0,0 +1,4 @@
+export { registerTranscript, processTranscriptUploads, } from "./manager.js";
+export { triggerTranscriptUpload, } from "./auto-upload.js";
+export { uploadChunk, uploadFull, readIncrement, compressGzip, getFileSize, checkUploadStatus, lookupUploadByPath, } from "./uploader.js";
+//# sourceMappingURL=index.js.map

package/dist/transcript/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transcript/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GAKnB,MAAM,eAAe,CAAC"}

package/dist/transcript/manager.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Transcript upload manager.
+ *
+ * Orchestrates the lifecycle of transcript uploads:
+ * 1. Discovers transcripts from hook events (via registerTranscript)
+ * 2. Periodically checks tracked transcripts for new data
+ * 3. Uploads increments with compression
+ * 4. Handles server resync requests (full re-upload)
+ * 5. Respects max retry limits (3 per file)
+ *
+ * The manager is designed to be triggered from hook events
+ * (fire-and-forget) rather than running as a persistent daemon.
+ * Each invocation processes all pending uploads then exits.
+ */
+import type Database from "better-sqlite3";
+import type { CloudClient } from "../http/client.js";
+import type { TranscriptUploadConfig } from "../config.js";
+import { type SyncUploadType } from "./uploader.js";
+export interface TranscriptManagerOptions {
+    db: Database.Database;
+    client: CloudClient;
+    config: TranscriptUploadConfig;
+    serverUrl: string;
+    /** Upload type discriminator (default: "transcript") */
+    type?: SyncUploadType;
+}
+export interface TranscriptProcessResult {
+    /** Number of transcripts processed */
+    processed: number;
+    /** Number of successful uploads */
+    uploaded: number;
+    /** Number of transcripts skipped (no new data) */
+    skipped: number;
+    /** Number of failed uploads */
+    failed: number;
+    /** Number of transcripts that triggered a full resync */
+    resynced: number;
+    /** Total bytes uploaded (before compression) */
+    totalRawBytes: number;
+    /** Total bytes uploaded (after compression) */
+    totalCompressedBytes: number;
+}
+/**
+ * Register a transcript path for tracking.
+ *
+ * Called from hook handlers when they see a transcript_path
+ * in the hook event input. If the transcript is already tracked,
+ * this is a no-op.
+ */
+export declare function registerTranscript(db: Database.Database, sessionId: string, transcriptPath: string, serverUrl: string): void;
+/**
+ * Process all pending transcript uploads.
+ *
+ * Iterates through tracked transcripts, checks for new data,
+ * and uploads increments. Respects maxConcurrent and maxRetries
+ * from config.
+ *
+ * This function is safe to call concurrently — SQLite's WAL mode
+ * and the upsert pattern prevent double-processing. However,
+ * the caller should avoid redundant invocations for efficiency.
+ */
+export declare function processTranscriptUploads(opts: TranscriptManagerOptions): Promise<TranscriptProcessResult>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/transcript/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/transcript/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAW3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,IAAI,CAUN;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAsIlC"}

package/dist/transcript/manager.js

@@ -0,0 +1,143 @@
+/**
+ * Transcript upload manager.
+ *
+ * Orchestrates the lifecycle of transcript uploads:
+ * 1. Discovers transcripts from hook events (via registerTranscript)
+ * 2. Periodically checks tracked transcripts for new data
+ * 3. Uploads increments with compression
+ * 4. Handles server resync requests (full re-upload)
+ * 5. Respects max retry limits (3 per file)
+ *
+ * The manager is designed to be triggered from hook events
+ * (fire-and-forget) rather than running as a persistent daemon.
+ * Each invocation processes all pending uploads then exits.
+ */
+import { generateId, getTranscriptUpload, getSessionById, upsertTranscriptUpload, listPendingTranscriptUploads, markTranscriptUploaded, markTranscriptUploadFailed, resetTranscriptUpload, } from "@vkenliu/adit-core";
+import { uploadChunk, getFileSize, } from "./uploader.js";
+/**
+ * Register a transcript path for tracking.
+ *
+ * Called from hook handlers when they see a transcript_path
+ * in the hook event input. If the transcript is already tracked,
+ * this is a no-op.
+ */
+export function registerTranscript(db, sessionId, transcriptPath, serverUrl) {
+    const existing = getTranscriptUpload(db, transcriptPath, serverUrl);
+    if (existing)
+        return; // Already tracked
+    upsertTranscriptUpload(db, {
+        id: generateId(),
+        sessionId,
+        transcriptPath,
+        serverUrl,
+    });
+}
+/**
+ * Process all pending transcript uploads.
+ *
+ * Iterates through tracked transcripts, checks for new data,
+ * and uploads increments. Respects maxConcurrent and maxRetries
+ * from config.
+ *
+ * This function is safe to call concurrently — SQLite's WAL mode
+ * and the upsert pattern prevent double-processing. However,
+ * the caller should avoid redundant invocations for efficiency.
+ */
+export async function processTranscriptUploads(opts) {
+    const { db, client, config, serverUrl, type = "transcript", } = opts;
+    const result = {
+        processed: 0,
+        uploaded: 0,
+        skipped: 0,
+        failed: 0,
+        resynced: 0,
+        totalRawBytes: 0,
+        totalCompressedBytes: 0,
+    };
+    if (!config.enabled)
+        return result;
+    // Get all transcripts that need processing
+    const pending = listPendingTranscriptUploads(db, serverUrl);
+    if (pending.length === 0)
+        return result;
+    // Process up to maxConcurrent at a time
+    // Use sequential processing to be kind to the network
+    // and avoid overwhelming the server
+    let activeCount = 0;
+    for (const upload of pending) {
+        if (activeCount >= config.maxConcurrent)
+            break;
+        result.processed++;
+        // Check if the file has new data
+        const currentSize = getFileSize(upload.transcriptPath);
+        if (currentSize === 0) {
+            result.skipped++;
+            continue;
+        }
+        // Skip if no new data and already up to date
+        const newDataBytes = currentSize - upload.uploadedBytes;
+        if (newDataBytes < config.minIncrementBytes && upload.status === "up_to_date") {
+            result.skipped++;
+            continue;
+        }
+        // Skip if already at current file size
+        if (upload.uploadedBytes >= currentSize) {
+            result.skipped++;
+            continue;
+        }
+        activeCount++;
+        // Derive cli from the session's platform (falls back to "other"
+        // if the session is missing — e.g. orphaned transcript_uploads row)
+        const session = getSessionById(db, upload.sessionId);
+        const cli = session?.platform ?? "other";
+        try {
+            const response = await uploadChunk(client, {
+                type,
+                cli,
+                sessionId: upload.sessionId,
+                filePath: upload.transcriptPath,
+                offsetBytes: upload.uploadedBytes,
+                fileSizeBytes: currentSize,
+                serverVersion: upload.serverVersion,
+            });
+            if (response.resyncRequired) {
+                // Server needs full re-upload
+                resetTranscriptUpload(db, upload.id);
+                result.resynced++;
+                // Immediately re-upload from offset 0
+                const fullResponse = await uploadChunk(client, {
+                    type,
+                    cli,
+                    sessionId: upload.sessionId,
+                    filePath: upload.transcriptPath,
+                    offsetBytes: 0,
+                    fileSizeBytes: currentSize,
+                    serverVersion: null,
+                });
+                if (fullResponse.resyncRequired) {
+                    // Still failing after full re-upload — mark as failed
+                    markTranscriptUploadFailed(db, upload.id, "Server requested resync but full re-upload also failed");
+                    result.failed++;
+                    continue;
+                }
+                markTranscriptUploaded(db, upload.id, fullResponse.confirmedOffset, currentSize, fullResponse.serverVersion);
+                result.uploaded++;
+            }
+            else {
+                // Normal incremental upload succeeded
+                markTranscriptUploaded(db, upload.id, response.confirmedOffset, currentSize, response.serverVersion);
+                result.uploaded++;
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            markTranscriptUploadFailed(db, upload.id, errorMsg);
+            result.failed++;
+            if (process.env.ADIT_DEBUG) {
+                process.stderr.write(`[adit-transcript] upload failed for ${upload.transcriptPath}: ${errorMsg}\n`);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=manager.js.map

package/dist/transcript/manager.js.map

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

package/dist/transcript/uploader.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Transcript incremental uploader.
+ *
+ * Reads a JSONL transcript file, detects new data since the last upload,
+ * compresses the increment with gzip, and uploads it to the server.
+ *
+ * Key design decisions:
+ * - Increments are split on newline boundaries to preserve JSONL format
+ * - Gzip compression reduces bandwidth for large transcripts
+ * - Server returns a version token for conflict detection
+ * - Server can signal "resync" to request a full re-upload
+ * - Max 3 consecutive failures per file before giving up
+ *
+ * The upload API is generic (/api/sync/upload) and uses `type` + `cli`
+ * fields so the server can handle different file types from different
+ * AI coding tools (Claude Code, Cursor, Windsurf, etc.).
+ */
+import type { CloudClient } from "../http/client.js";
+/** Upload type discriminator — extensible for future file types */
+export type SyncUploadType = "transcript" | "plan" | "log";
+/** Response from POST /api/sync/upload */
+export interface SyncUploadResponse {
+    /** Server-assigned upload ID (stable across increments) */
+    uploadId: string;
+    /** Byte offset the server has confirmed receiving up to */
+    confirmedOffset: number;
+    /** Opaque version token (pass back on next upload) */
+    serverVersion: string;
+    /** If true, server requests a full re-upload from offset 0 */
+    resyncRequired: boolean;
+}
+/**
+ * Upload status parsed from HEAD response headers.
+ *
+ * All status is conveyed via standard + custom HTTP headers,
+ * with no JSON body — keeping status checks as cheap as possible.
+ */
+export interface SyncUploadStatus {
+    uploadId: string;
+    confirmedOffset: number;
+    serverVersion: string;
+    type: string;
+    cli: string;
+    totalStoredBytes: number;
+    lastModified: string | null;
+}
+/** Parameters for uploading a chunk */
+export interface UploadChunkParams {
+    /** Upload type (e.g. "transcript") */
+    type: SyncUploadType;
+    /** CLI identifier (e.g. "claude-code") */
+    cli: string;
+    /** Session ID for this file */
+    sessionId: string;
+    /** Absolute path to the file on the client */
+    filePath: string;
+    /** Byte offset to start reading from */
+    offsetBytes: number;
+    /** Current total file size */
+    fileSizeBytes: number;
+    /** Server version token from previous upload (null for first upload) */
+    serverVersion: string | null;
+}
+/**
+ * Read the increment from a transcript file starting at the given
+ * byte offset, snapping to the nearest complete line boundary.
+ *
+ * Returns the raw bytes of complete JSONL lines after the offset.
+ * If no complete new lines exist, returns null.
+ */
+export declare function readIncrement(filePath: string, offsetBytes: number): {
+    data: Buffer;
+    newOffset: number;
+} | null;
+/**
+ * Compress a buffer with gzip.
+ */
+export declare function compressGzip(data: Buffer): Promise<Buffer>;
+/**
+ * Upload an incremental chunk to the server.
+ *
+ * Posts to `/api/sync/upload` with `type` and `cli` fields so the server
+ * can route to the correct handler regardless of which CLI/file-type
+ * produced the data.
+ *
+ * The chunk is gzip-compressed before sending. The server responds
+ * with the confirmed byte offset and a version token.
+ *
+ * If the server returns a 409 with resyncRequired=true, the caller
+ * should reset the upload state and re-upload from offset 0.
+ */
+export declare function uploadChunk(client: CloudClient, params: UploadChunkParams): Promise<SyncUploadResponse>;
+/**
+ * Upload the full file from offset 0.
+ * Used for initial upload or when server requests a resync.
+ */
+export declare function uploadFull(client: CloudClient, params: Omit<UploadChunkParams, "offsetBytes">): Promise<SyncUploadResponse>;
+/**
+ * Check upload status via HEAD /api/sync/upload/{uploadId}.
+ *
+ * All status is returned in standard HTTP headers — no JSON body.
+ * This is the only status check method; there is no GET-by-ID endpoint.
+ *
+ * Header mapping:
+ *   X-Upload-Id          → uploadId
+ *   X-Confirmed-Offset   → confirmedOffset
+ *   ETag                 → serverVersion
+ *   X-Upload-Type        → type
+ *   X-Upload-Cli         → cli
+ *   Content-Length        → totalStoredBytes
+ *   Last-Modified         → lastModified
+ *
+ * Returns null if the upload is not found (404).
+ */
+export declare function checkUploadStatus(client: CloudClient, uploadId: string): Promise<SyncUploadStatus | null>;
+/**
+ * Look up an upload by its original file path.
+ *
+ * Uses GET /api/sync/upload?lookup=by-path&type=...&cli=...&...
+ * The response has no JSON body — status comes from headers only,
+ * same as HEAD.
+ *
+ * Returns null if not found (404).
+ */
+export declare function lookupUploadByPath(client: CloudClient, params: {
+    type: SyncUploadType;
+    cli: string;
+    sessionId: string;
+    filePath: string;
+}): Promise<SyncUploadStatus | null>;
+/**
+ * Get the current file size, or 0 if the file doesn't exist.
+ */
+export declare function getFileSize(filePath: string): number;
+//# sourceMappingURL=uploader.d.ts.map

package/dist/transcript/uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../../src/transcript/uploader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3D,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAID;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkC5C;AAID;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYhE;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAqD7B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAC7C,OAAO,CAAC,kBAAkB,CAAC,CAM7B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAYlC;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE;IACN,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoBlC;AAmBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD"}