@ultrst-armada/kloks 1.7.0 → 1.7.1

package/packages/backend/dist/services/index.js

@@ -14,8 +14,8 @@ import {
 } from "../chunk-RBF2OGMC.js";
 import {
   workspaceGraphService
-} from "../chunk-KSZ67VZJ.js";
-import "../chunk-J2J24JVC.js";
+} from "../chunk-F6IDQLC2.js";
+import "../chunk-R45CEV46.js";
 import "../chunk-6K75XXFD.js";
 import "../chunk-VAFCR2MS.js";
 import "../chunk-TY32TUNI.js";

package/packages/backend/dist/srkl/index.d.ts

@@ -80,7 +80,7 @@ interface AppServiceDeclaration {
 }
 interface AdaptedStorageConnection {
     id: string;
-    provider: 'backblaze_b2' | 'aws_s3' | 'local_fs';
+    provider: 'backblaze_b2' | 'aws_s3' | 'google_drive' | 'local_fs';
     label: string;
     role?: 'primary' | 'redundant_clone';
     enabled?: boolean;
@@ -95,6 +95,12 @@ interface AdaptedStorageConnection {
     s3BucketName?: string;
     s3Region?: string;
     s3Endpoint?: string;
+    googleEmail?: string;
+    googleRootFolderId?: string;
+    googleRootFolderName?: string;
+    googleAccessToken?: string;
+    googleAccessTokenExpiresAt?: number;
+    googleRefreshToken?: string;
 }
 interface KeyMaterial {
     secretHex: string;

package/packages/backend/dist/srkl/index.js

@@ -10,12 +10,12 @@ import {
   srklService,
   syncSrklAccounts,
   useSrklServices
-} from "../chunk-BI5RDDB4.js";
+} from "../chunk-3IUA66RS.js";
 import {
   getPrimarySrklDeploymentUrl,
   getSrklAccounts,
   srklListBackblazeBuckets
-} from "../chunk-N4Z57FVR.js";
+} from "../chunk-XHADDA75.js";
 import "../chunk-4QEMALXF.js";
 import "../chunk-VAFCR2MS.js";
 export {

package/packages/backend/dist/storage/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BaseStorageAdapter, S as StorageConfig, F as FileInfo, D as DeleteFolderResult, R as RenameFolderResult, C as ConnectionTestResult } from '../BaseStorageAdapter-tosOoSUg.js';
-export { a as StorageMode, b as StorageProviderType, U as UploadResult } from '../BaseStorageAdapter-tosOoSUg.js';
+import { B as BaseStorageAdapter, S as StorageConfig, F as FileInfo, D as DeleteFolderResult, R as RenameFolderResult, C as ConnectionTestResult } from '../BaseStorageAdapter-6x_BQiB3.js';
+export { a as StorageMode, b as StorageProviderType, U as UploadResult } from '../BaseStorageAdapter-6x_BQiB3.js';
 import '@ultrst-armada/kloks/functions';
 
 declare class LocalFSAdapter extends BaseStorageAdapter {
@@ -59,6 +59,22 @@ declare class BackblazeB2Adapter extends BaseStorageAdapter {
     testConnection(): Promise<ConnectionTestResult>;
 }
 
+declare class GoogleDriveAdapter extends BaseStorageAdapter {
+    private token;
+    private request;
+    private findChild;
+    private resolveParent;
+    private split;
+    read(pathStr: string): Promise<Uint8Array>;
+    write(pathStr: string, data: Uint8Array | string, contentType?: string): Promise<void>;
+    delete(pathStr: string): Promise<void>;
+    exists(pathStr: string): Promise<boolean>;
+    list(pathStr?: string): Promise<FileInfo[]>;
+    stat(pathStr: string): Promise<FileInfo>;
+    mkdir(pathStr: string): Promise<void>;
+    testConnection(): Promise<ConnectionTestResult>;
+}
+
 /**
  * Backblaze B2 Endpoint & Credential Normalizer
  */
@@ -121,4 +137,20 @@ declare function b2ListFileNames(keyId: string, applicationKey: string, bucketNa
 declare function b2UploadFile(keyId: string, applicationKey: string, bucketName: string, fileName: string, content: Uint8Array | string, contentType?: string): Promise<any>;
 declare function b2DownloadFile(keyId: string, applicationKey: string, bucketName: string, fileName: string): Promise<Uint8Array | null>;
 
-export { type B2AuthToken, BackblazeB2Adapter, BaseStorageAdapter, ConnectionTestResult, DeleteFolderResult, FileInfo, LocalFSAdapter, RenameFolderResult, S3Adapter, StorageAdapterFactory, StorageConfig, SupabaseStorageAdapter, authorizeB2, b2DownloadFile, b2ListBuckets, b2ListFileNames, b2UploadFile, ensureS3DirectoryMarker, isSecretMasked, normalizeBackblazeCredentials, permanentDeleteS3Folder, permanentDeleteS3Object, renameS3Folder, resolveBackblazeEndpoint };
+interface GoogleDriveOAuthConfig {
+    clientId: string;
+    clientSecret?: string;
+    redirectUri: string;
+    scopes?: string[];
+}
+interface GoogleDriveTokenSet {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    tokenType?: string;
+}
+declare function createGoogleDriveAuthorizationUrl(config: GoogleDriveOAuthConfig, state: string, codeChallenge?: string): string;
+declare function exchangeGoogleDriveCode(config: GoogleDriveOAuthConfig, code: string, codeVerifier?: string): Promise<GoogleDriveTokenSet>;
+declare function refreshGoogleDriveAccessToken(clientId: string, refreshToken: string): Promise<GoogleDriveTokenSet>;
+
+export { type B2AuthToken, BackblazeB2Adapter, BaseStorageAdapter, ConnectionTestResult, DeleteFolderResult, FileInfo, GoogleDriveAdapter, type GoogleDriveOAuthConfig, type GoogleDriveTokenSet, LocalFSAdapter, RenameFolderResult, S3Adapter, StorageAdapterFactory, StorageConfig, SupabaseStorageAdapter, authorizeB2, b2DownloadFile, b2ListBuckets, b2ListFileNames, b2UploadFile, createGoogleDriveAuthorizationUrl, ensureS3DirectoryMarker, exchangeGoogleDriveCode, isSecretMasked, normalizeBackblazeCredentials, permanentDeleteS3Folder, permanentDeleteS3Object, refreshGoogleDriveAccessToken, renameS3Folder, resolveBackblazeEndpoint };

package/packages/backend/dist/storage/index.js

@@ -1,19 +1,24 @@
-import "../chunk-LS3HWJBX.js";
+import {
+  S3Adapter
+} from "../chunk-JUPWFW7V.js";
 import {
   BackblazeB2Adapter,
   BaseStorageAdapter,
+  GoogleDriveAdapter,
   LocalFSAdapter,
-  S3Adapter,
   StorageAdapterFactory,
   SupabaseStorageAdapter,
+  createGoogleDriveAuthorizationUrl,
   ensureS3DirectoryMarker,
+  exchangeGoogleDriveCode,
   isSecretMasked,
   normalizeBackblazeCredentials,
   permanentDeleteS3Folder,
   permanentDeleteS3Object,
+  refreshGoogleDriveAccessToken,
   renameS3Folder,
   resolveBackblazeEndpoint
-} from "../chunk-J2J24JVC.js";
+} from "../chunk-R45CEV46.js";
 import {
   authorizeB2,
   b2DownloadFile,
@@ -24,6 +29,7 @@ import {
 export {
   BackblazeB2Adapter,
   BaseStorageAdapter,
+  GoogleDriveAdapter,
   LocalFSAdapter,
   S3Adapter,
   StorageAdapterFactory,
@@ -33,11 +39,14 @@ export {
   b2ListBuckets,
   b2ListFileNames,
   b2UploadFile,
+  createGoogleDriveAuthorizationUrl,
   ensureS3DirectoryMarker,
+  exchangeGoogleDriveCode,
   isSecretMasked,
   normalizeBackblazeCredentials,
   permanentDeleteS3Folder,
   permanentDeleteS3Object,
+  refreshGoogleDriveAccessToken,
   renameS3Folder,
   resolveBackblazeEndpoint
 };

package/packages/backend/dist/workspace/index.d.ts

@@ -1,4 +1,4 @@
-import { B as BaseStorageAdapter, F as FileInfo } from '../BaseStorageAdapter-tosOoSUg.js';
+import { B as BaseStorageAdapter, F as FileInfo } from '../BaseStorageAdapter-6x_BQiB3.js';
 import { SkipoBase } from '@ultrst-armada/kloks/functions';
 
 interface WorkspaceDescriptor {
@@ -139,7 +139,7 @@ interface WorkspaceMutationResult {
     workspaces?: any[];
 }
 interface WorkspaceService {
-    readonly type: 'remote' | 'working';
+    readonly type: 'working';
     findWorkspace(workspaceId: string, env?: Record<string, unknown>): Promise<WorkspaceLookupResult>;
     listWorkspaces(userId?: string, env?: Record<string, unknown>): Promise<WorkspaceListResult>;
     createWorkspace(userId: string, data: any, env?: Record<string, unknown>): Promise<WorkspaceMutationResult>;
@@ -162,14 +162,18 @@ interface WorkspaceService {
 }
 
 /**
- * @file RemoteWorkspaceService.ts
- * @description Remote-first WorkspaceService implementation for Kloks.
- * Directly mediates with authoritative remote storage (Backblaze B2/S3/DB) without requiring local working files.
- * Canonical choice for DEPM. Conforms to Skipo Governance (< 200 lines).
+ * @file WorkingWorkspaceService.ts
+ * @description Local Working-Workspace implementation for Kloks.
+ * Operates on a local working directory for fast low-latency I/O and explicitly
+ * synchronizes with authoritative remote storage (Backblaze B2/S3/DB).
+ * Canonical choice for QWNSR. Conforms to Skipo Governance (< 200 lines).
  */
 
-declare class RemoteWorkspaceService implements WorkspaceService {
-    readonly type: "remote";
+declare class WorkingWorkspaceService implements WorkspaceService {
+    private workingDirResolver?;
+    readonly type: "working";
+    constructor(workingDirResolver?: (workspaceId?: string) => string);
+    getWorkingDir(workspaceId?: string): string;
     findWorkspace(workspaceId: string, env?: Record<string, unknown>): Promise<WorkspaceLookupResult>;
     listWorkspaces(userId?: string, env?: Record<string, unknown>): Promise<WorkspaceListResult>;
     createWorkspace(userId: string, data: any, env?: Record<string, unknown>): Promise<WorkspaceMutationResult>;
@@ -178,52 +182,42 @@ declare class RemoteWorkspaceService implements WorkspaceService {
         success: boolean;
         workspaces?: any[];
     }>;
-    readFile(workspaceId: string, filePath: string, env?: Record<string, unknown>): Promise<Uint8Array | string>;
-    writeFile(workspaceId: string, filePath: string, content: Uint8Array | string, env?: Record<string, unknown>): Promise<{
+    readFile(_workspaceId: string, filePath: string): Promise<Uint8Array | string>;
+    writeFile(_workspaceId: string, filePath: string, content: Uint8Array | string): Promise<{
         success: boolean;
         path: string;
         sizeBytes?: number;
     }>;
-    deleteFile(workspaceId: string, filePath: string, env?: Record<string, unknown>): Promise<{
+    deleteFile(_workspaceId: string, filePath: string): Promise<{
         success: boolean;
     }>;
-    listFiles(workspaceId: string, subfolder?: string, env?: Record<string, unknown>): Promise<WorkspaceFileEntry[]>;
+    listFiles(_workspaceId: string, subfolder?: string): Promise<WorkspaceFileEntry[]>;
+    sync(workspaceId: string, _options?: any, _env?: Record<string, unknown>): Promise<WorkspaceSyncSummary>;
 }
-declare const remoteWorkspaceService: RemoteWorkspaceService;
-
-/**
- * @file WorkingWorkspaceService.ts
- * @description Local Working-Workspace implementation for Kloks.
- * Operates on a local working directory for fast low-latency I/O and explicitly
- * synchronizes with authoritative remote storage (Backblaze B2/S3/DB).
- * Canonical choice for QWNSR. Conforms to Skipo Governance (< 200 lines).
- */
+declare const workingWorkspaceService: WorkingWorkspaceService;
 
-declare class WorkingWorkspaceService implements WorkspaceService {
-    private workingDirResolver?;
+declare class RemoteWorkspaceService implements WorkspaceService {
     readonly type: "working";
-    constructor(workingDirResolver?: () => string);
-    getWorkingDir(): string;
-    findWorkspace(workspaceId: string, env?: Record<string, unknown>): Promise<WorkspaceLookupResult>;
+    findWorkspace(id: string, env?: Record<string, unknown>): Promise<WorkspaceLookupResult>;
     listWorkspaces(userId?: string, env?: Record<string, unknown>): Promise<WorkspaceListResult>;
     createWorkspace(userId: string, data: any, env?: Record<string, unknown>): Promise<WorkspaceMutationResult>;
     updateWorkspace(userId: string, params: any, env?: Record<string, unknown>): Promise<WorkspaceMutationResult>;
-    deleteWorkspace(userId: string, workspaceId: string, env?: Record<string, unknown>): Promise<{
+    deleteWorkspace(userId: string, id: string, env?: Record<string, unknown>): Promise<{
         success: boolean;
         workspaces?: any[];
     }>;
-    readFile(_workspaceId: string, filePath: string): Promise<Uint8Array | string>;
-    writeFile(_workspaceId: string, filePath: string, content: Uint8Array | string): Promise<{
+    readFile(id: string, path: string, env?: Record<string, unknown>): Promise<Uint8Array | string>;
+    writeFile(id: string, path: string, content: Uint8Array | string, env?: Record<string, unknown>): Promise<{
         success: boolean;
         path: string;
         sizeBytes?: number;
     }>;
-    deleteFile(_workspaceId: string, filePath: string): Promise<{
+    deleteFile(id: string, path: string, env?: Record<string, unknown>): Promise<{
         success: boolean;
     }>;
-    listFiles(_workspaceId: string, subfolder?: string): Promise<WorkspaceFileEntry[]>;
-    sync(workspaceId: string, _options?: any, _env?: Record<string, unknown>): Promise<WorkspaceSyncSummary>;
+    listFiles(id: string, subfolder?: string, env?: Record<string, unknown>): Promise<WorkspaceFileEntry[]>;
+    sync(id: string, options?: any, env?: Record<string, unknown>): Promise<WorkspaceSyncSummary>;
 }
-declare const workingWorkspaceService: WorkingWorkspaceService;
+declare const remoteWorkspaceService: WorkingWorkspaceService;
 
 export { type CloneReplicationResult, type ConflictPolicy, RemoteWorkspaceService, SyncEngine, type SyncState, WorkingWorkspaceService, WorkspaceCloneSyncEngine, type WorkspaceConfig, type WorkspaceDescriptor, WorkspaceFS, type WorkspaceFileEntry, type WorkspaceListResult, type WorkspaceLookupResult, type WorkspaceMutationResult, type WorkspaceSecondaryClone, type WorkspaceService, type WorkspaceSyncSummary, formatCanonicalWorkspaceFolderName, remoteWorkspaceService, sanitizeWorkspaceName, workingWorkspaceService };

package/packages/backend/dist/workspace/index.js

@@ -6,7 +6,7 @@ import {
   WorkspaceFS,
   remoteWorkspaceService,
   workingWorkspaceService
-} from "../chunk-6QTNNZSE.js";
+} from "../chunk-6W7OAGNV.js";
 import {
   formatCanonicalWorkspaceFolderName,
   sanitizeWorkspaceName

package/packages/client/dist/index.d.ts

@@ -151,4 +151,37 @@ declare class BrowserExecutionClient implements QueueGatewayContract {
 }
 declare function createBrowserExecutionClient(options?: QueueTransportOptions): BrowserExecutionClient;
 
-export { type BackendCommand, BrowserExecutionClient, type CorrelationMetadata, type ExecutionJob, type JobPriority, type JobStatus, type NormalizedResult, type QueueGatewayContract, type QueueTransportOptions, type RetryPolicy, type WorkspaceDescriptor, type WorkspaceFileEntry, type WorkspaceListResult, type WorkspaceLookupResult, type WorkspaceMutationResult, type WorkspaceServiceContract, type WorkspaceSyncSummary, createBrowserExecutionClient };
+interface WorkspaceAutosaveOptions {
+    intervalMs?: number;
+    enabled?: boolean;
+    save: () => Promise<void>;
+}
+declare class WorkspaceAutosaveController {
+    private readonly intervalMs;
+    private readonly save;
+    private timer?;
+    private saving;
+    private enabled;
+    constructor(options: WorkspaceAutosaveOptions);
+    start(): void;
+    stop(): void;
+    setEnabled(enabled: boolean): void;
+    saveNow(): Promise<void>;
+    private handleLifecycle;
+    private saveOnce;
+}
+
+declare class OPFSWorkspaceStorage {
+    private readonly rootName;
+    constructor(rootName?: string);
+    private root;
+    private directory;
+    private parent;
+    read(workspaceId: string, filePath: string): Promise<Uint8Array>;
+    write(workspaceId: string, filePath: string, data: Uint8Array | string): Promise<void>;
+    delete(workspaceId: string, filePath: string): Promise<void>;
+    exists(workspaceId: string, filePath: string): Promise<boolean>;
+    list(workspaceId: string, folderPath?: string): Promise<string[]>;
+}
+
+export { type BackendCommand, BrowserExecutionClient, type CorrelationMetadata, type ExecutionJob, type JobPriority, type JobStatus, type NormalizedResult, OPFSWorkspaceStorage, type QueueGatewayContract, type QueueTransportOptions, type RetryPolicy, WorkspaceAutosaveController, type WorkspaceAutosaveOptions, type WorkspaceDescriptor, type WorkspaceFileEntry, type WorkspaceListResult, type WorkspaceLookupResult, type WorkspaceMutationResult, type WorkspaceServiceContract, type WorkspaceSyncSummary, createBrowserExecutionClient };

package/packages/client/dist/index.js

@@ -56,7 +56,123 @@ var BrowserExecutionClient = class {
 function createBrowserExecutionClient(options) {
   return new BrowserExecutionClient(options);
 }
+
+// src/WorkspaceAutosaveController.ts
+var WorkspaceAutosaveController = class {
+  intervalMs;
+  save;
+  timer;
+  saving = false;
+  enabled;
+  constructor(options) {
+    this.intervalMs = Math.max(options.intervalMs ?? 6e4, 5e3);
+    this.save = options.save;
+    this.enabled = options.enabled ?? true;
+  }
+  start() {
+    this.stop();
+    if (!this.enabled || typeof window === "undefined") return;
+    this.timer = setInterval(() => {
+      void this.saveOnce();
+    }, this.intervalMs);
+    window.addEventListener("visibilitychange", this.handleLifecycle);
+    window.addEventListener("pagehide", this.handleLifecycle);
+    window.addEventListener("blur", this.handleLifecycle);
+  }
+  stop() {
+    if (this.timer) clearInterval(this.timer);
+    this.timer = void 0;
+    if (typeof window !== "undefined") {
+      window.removeEventListener("visibilitychange", this.handleLifecycle);
+      window.removeEventListener("pagehide", this.handleLifecycle);
+      window.removeEventListener("blur", this.handleLifecycle);
+    }
+  }
+  setEnabled(enabled) {
+    this.enabled = enabled;
+    if (enabled) this.start();
+    else this.stop();
+  }
+  async saveNow() {
+    if (!this.enabled) return;
+    await this.saveOnce();
+  }
+  handleLifecycle = () => {
+    if (typeof document !== "undefined" && document.visibilityState === "visible") return;
+    void this.saveOnce();
+  };
+  async saveOnce() {
+    if (!this.enabled || this.saving) return;
+    this.saving = true;
+    try {
+      await this.save();
+    } finally {
+      this.saving = false;
+    }
+  }
+};
+
+// src/OPFSWorkspaceStorage.ts
+var OPFSWorkspaceStorage = class {
+  rootName;
+  constructor(rootName = "skipo-workspaces") {
+    this.rootName = rootName;
+  }
+  async root() {
+    const storage = navigator.storage;
+    if (!storage?.getDirectory) throw new Error("OPFS is not available in this browser.");
+    const root = await storage.getDirectory();
+    return root.getDirectoryHandle(this.rootName, { create: true });
+  }
+  async directory(workspaceId, create = true) {
+    const root = await this.root();
+    return root.getDirectoryHandle(workspaceId, { create });
+  }
+  async parent(workspaceId, filePath, create = true) {
+    const parts = filePath.replace(/^\/+/, "").split("/").filter(Boolean);
+    const name = parts.pop();
+    if (!name) throw new Error("Workspace file path is required.");
+    let dir = await this.directory(workspaceId, create);
+    for (const part of parts) dir = await dir.getDirectoryHandle(part, { create });
+    return { dir, name };
+  }
+  async read(workspaceId, filePath) {
+    const { dir, name } = await this.parent(workspaceId, filePath, false);
+    const handle = await dir.getFileHandle(name);
+    return new Uint8Array(await (await handle.getFile()).arrayBuffer());
+  }
+  async write(workspaceId, filePath, data) {
+    const { dir, name } = await this.parent(workspaceId, filePath, true);
+    const handle = await dir.getFileHandle(name, { create: true });
+    const writable = await handle.createWritable();
+    await writable.write(typeof data === "string" ? data : data);
+    await writable.close();
+  }
+  async delete(workspaceId, filePath) {
+    const { dir, name } = await this.parent(workspaceId, filePath, false);
+    await dir.removeEntry(name);
+  }
+  async exists(workspaceId, filePath) {
+    try {
+      await this.parent(workspaceId, filePath, false).then(async ({ dir, name }) => dir.getFileHandle(name));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async list(workspaceId, folderPath = "") {
+    let dir = await this.directory(workspaceId, false);
+    for (const part of folderPath.replace(/^\/+|\/+$/g, "").split("/").filter(Boolean)) {
+      dir = await dir.getDirectoryHandle(part);
+    }
+    const result = [];
+    for await (const [name, handle] of dir.entries()) result.push(handle.kind === "directory" ? `${name}/` : name);
+    return result;
+  }
+};
 export {
   BrowserExecutionClient,
+  OPFSWorkspaceStorage,
+  WorkspaceAutosaveController,
   createBrowserExecutionClient
 };