visionclaw 0.1.193 → 0.1.194-dev.feat-backup-progress-reporting.1

package/dist/agent/backup-uploader.d.ts

@@ -0,0 +1,44 @@
+import type { VisionClawConfig } from "../config/types.js";
+export type BackupProvider = "gdrive" | "tos";
+export interface BackupUploadProgress {
+    uploadedBytes: number;
+}
+export interface BackupUploadBaseOptions {
+    localPath: string;
+    name: string;
+    contentType: string;
+    onProgress?: (progress: BackupUploadProgress) => void;
+}
+export interface GdriveBackupUploadOptions extends BackupUploadBaseOptions {
+    provider: "gdrive";
+    config: VisionClawConfig;
+    ownerEmail: string;
+}
+export interface TosBackupUploadOptions extends BackupUploadBaseOptions {
+    provider: "tos";
+    tos: {
+        accessKeyId: string;
+        accessKeySecret: string;
+        bucket: string;
+        region: string;
+        endpoint: string;
+        publicEndpoint: string;
+        signedUrlExpiresSeconds: number;
+        key: string;
+    };
+}
+export type BackupUploadOptions = GdriveBackupUploadOptions | TosBackupUploadOptions;
+export interface BackupUploadResult {
+    provider: BackupProvider;
+    location: string;
+    signedUrl?: string;
+    key?: string;
+    bucket?: string;
+    sizeBytes?: number;
+    expiresAt?: string;
+}
+export declare function buildBackupTosKey(config: VisionClawConfig, zipName: string): string;
+export declare function uploadBackup(options: BackupUploadOptions): Promise<BackupUploadResult>;
+export declare function uploadBackupToGoogleDrive(options: GdriveBackupUploadOptions): Promise<BackupUploadResult>;
+export declare function uploadBackupToTos(options: TosBackupUploadOptions): Promise<BackupUploadResult>;
+//# sourceMappingURL=backup-uploader.d.ts.map

package/dist/agent/backup-uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-uploader.d.ts","sourceRoot":"","sources":["../../src/agent/backup-uploader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,QAAQ,EAAE,KAAK,CAAC;IAChB,GAAG,EAAE;QACH,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,uBAAuB,EAAE,MAAM,CAAC;QAChC,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,GAAG,sBAAsB,CAAC;AAErF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAK5F;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAuB7B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAuC7B"}

package/dist/agent/backup-uploader.js

@@ -0,0 +1,83 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { getProfile } from "../config/index.js";
+import { GoogleDriveClient } from "../drive/google-drive.js";
+import { createTosSignedUrl, formatTosUri, uploadTosObject } from "../tos-storage.js";
+function slugify(value) {
+    const slug = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "unknown";
+}
+export function buildBackupTosKey(config, zipName) {
+    return `backups/${slugify(config.agentName)}/${slugify(getProfile())}/${zipName}`;
+}
+export async function uploadBackup(options) {
+    if (options.provider === "gdrive") {
+        return uploadBackupToGoogleDrive(options);
+    }
+    return uploadBackupToTos(options);
+}
+export async function uploadBackupToGoogleDrive(options) {
+    const drive = new GoogleDriveClient(options.config);
+    const uploaded = await drive.uploadFile({
+        localPath: options.localPath,
+        name: options.name,
+        mimeType: options.contentType,
+        onProgress: (uploadedBytes) => {
+            options.onProgress?.({ uploadedBytes });
+        },
+    });
+    await drive.shareFile({
+        fileId: uploaded.id,
+        email: options.ownerEmail,
+        role: "reader",
+        sendNotification: false,
+    });
+    return {
+        provider: "gdrive",
+        location: uploaded.webViewLink ?? `https://drive.google.com/file/d/${uploaded.id}/view`,
+        sizeBytes: fs.statSync(options.localPath).size,
+    };
+}
+export async function uploadBackupToTos(options) {
+    const sizeBytes = fs.statSync(options.localPath).size;
+    const credentials = {
+        accessKeyId: options.tos.accessKeyId,
+        accessKeySecret: options.tos.accessKeySecret,
+        region: options.tos.region,
+        endpoint: options.tos.endpoint,
+    };
+    await uploadTosObject({
+        filePath: options.localPath,
+        bucket: options.tos.bucket,
+        key: options.tos.key,
+        credentials,
+        contentType: options.contentType,
+        checkpointDir: path.join(os.tmpdir(), ".tos-backup-checkpoints"),
+        onProgress: (progress) => {
+            options.onProgress?.({ uploadedBytes: progress.uploadedBytes });
+        },
+    });
+    const signedUrl = createTosSignedUrl({
+        bucket: options.tos.bucket,
+        key: options.tos.key,
+        credentials,
+        expiresSeconds: options.tos.signedUrlExpiresSeconds,
+        publicEndpoint: options.tos.publicEndpoint,
+    });
+    const expiresAt = new Date(Date.now() + options.tos.signedUrlExpiresSeconds * 1000).toISOString();
+    return {
+        provider: "tos",
+        location: formatTosUri(options.tos.bucket, options.tos.key),
+        signedUrl,
+        key: options.tos.key,
+        bucket: options.tos.bucket,
+        sizeBytes,
+        expiresAt,
+    };
+}
+//# sourceMappingURL=backup-uploader.js.map

package/dist/agent/backup-uploader.js.map

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

package/dist/agent/backup.d.ts

@@ -1,3 +1,4 @@
+import { type BackupProvider, type BackupUploadResult } from "./backup-uploader.js";
 import type { VisionClawConfig } from "../config/types.js";
 /**
  * Create a ZIP backup of VisionClaw profile data and upload it to Google Drive.
@@ -8,5 +9,10 @@ import type { VisionClawConfig } from "../config/types.js";
  *
  * @returns Shareable Google Drive link for the uploaded ZIP.
  */
-export declare function runBackup(config: VisionClawConfig, ownerEmail: string): Promise<string>;
+export interface BackupRunOptions {
+    provider?: BackupProvider;
+    signedUrlExpiresSeconds?: number;
+}
+export type BackupResult = BackupUploadResult;
+export declare function runBackup(config: VisionClawConfig, ownerEmail: string, options?: BackupRunOptions): Promise<BackupResult>;
 //# sourceMappingURL=backup.d.ts.map

package/dist/agent/backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/agent/backup.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AA6L3D;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAoHjB"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/agent/backup.ts"],"names":[],"mappings":"AAOA,OAAO,EAAmC,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AA+a3D;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAE9C,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC,CA2OvB"}