donobu 1.0.0

package/dist/managers/FlowsPersistenceFactoryImpl.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowsPersistenceFactoryImpl = void 0;
+const NoApiAccessTokenPresentException_1 = require("../exceptions/NoApiAccessTokenPresentException");
+const FlowsPersistenceGoogleCloudStorage_1 = require("./FlowsPersistenceGoogleCloudStorage");
+const FlowsPersistenceFilesystem_1 = require("./FlowsPersistenceFilesystem");
+const FlowsPersistenceSupabase_1 = require("./FlowsPersistenceSupabase");
+const SupabaseClient_1 = require("../clients/SupabaseClient");
+const DonobuDeploymentEnvironment_1 = require("../models/DonobuDeploymentEnvironment");
+const FlowsPersistenceAwsS3_1 = require("./FlowsPersistenceAwsS3");
+/**
+ * A factory class for creating new FlowsPersistence instances. The type of persistence
+ * objects created varies depending on this factory's constructor arguments and the current API
+ * request context.
+ */
+class FlowsPersistenceFactoryImpl {
+    deploymentEnvironment;
+    awsS3Bucket;
+    awsS3Region;
+    googleCloudStorageBucket;
+    supabaseJwtSecretKey;
+    baseOutputDir;
+    requestContextHolder;
+    static AWS_S3_BUCKET_KEY = 'AWS_S3_BUCKET';
+    static AWS_S3_REGION_KEY = 'AWS_S3_REGION';
+    static GOOGLE_CLOUD_STORAGE_BUCKET_ENV = 'GOOGLE_CLOUD_STORAGE_BUCKET';
+    static SUPABASE_JWT_SECRET_KEY_ENV = 'SUPABASE_JWT_SECRET_KEY';
+    /**
+     * Creates an instance.
+     *
+     * @param deploymentEnvironment The deployment environment for this application. If this is set to
+     *     a value of DonobuDeploymentEnvironment.DONOBU_HOSTED_MULTI_TENANT, then the
+     *     supabaseJwtSecretKey must also be specified.
+     * @param awsS3Bucket The name of the AWS S3 bucket to use for persistence.
+     * @param awsS3Region The region of the AWS S3 bucket.
+     * @param googleCloudStorageBucket The name of the Google Cloud storage bucket to use for
+     *     persistence. Note that no special authentication is performed, so the current environment
+     *     must be able to reach said bucket. If deployed in Google Cloud, this may be done
+     *     automatically. If running locally, this may mean you have to log in to Google Cloud using
+     *     the Google Cloud CLI before running this application.
+     * @param supabaseJwtSecretKey The Supabase JWT secret key used to generate new JWTs for the
+     *     purposes of authentication. This key is extremely sensitive! This parameter MUST be
+     *     specified if deploymentEnvironment is set to DonobuDeploymentEnvironment.DONOBU_HOSTED_MULTI_TENANT.
+     * @param baseOutputDir The local directory to store files.
+     * @param requestContextHolder The object used to get the current API request context.
+     */
+    constructor(deploymentEnvironment, awsS3Bucket, awsS3Region, googleCloudStorageBucket, supabaseJwtSecretKey, baseOutputDir, requestContextHolder) {
+        this.deploymentEnvironment = deploymentEnvironment;
+        this.awsS3Bucket = awsS3Bucket;
+        this.awsS3Region = awsS3Region;
+        this.googleCloudStorageBucket = googleCloudStorageBucket;
+        this.supabaseJwtSecretKey = supabaseJwtSecretKey;
+        this.baseOutputDir = baseOutputDir;
+        this.requestContextHolder = requestContextHolder;
+        if (deploymentEnvironment ===
+            DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.DONOBU_HOSTED_MULTI_TENANT &&
+            !supabaseJwtSecretKey) {
+            throw new Error('supabaseJwtSecretKey cannot be null if deploymentEnvironment is set to DONOBU_HOSTED_MULTI_TENANT.');
+        }
+    }
+    /**
+     * Creates an instance, fetching the values for googleCloudStorageBucket and
+     * supabaseJwtSecretKey from the environment variables.
+     */
+    static fromEnvironment(deploymentEnvironment, baseOutputDir, requestContextHolder) {
+        const awsS3Bucket = process.env[FlowsPersistenceFactoryImpl.AWS_S3_BUCKET_KEY];
+        const awsS3Region = process.env[FlowsPersistenceFactoryImpl.AWS_S3_REGION_KEY];
+        const googleCloudStorageBucket = process.env[FlowsPersistenceFactoryImpl.GOOGLE_CLOUD_STORAGE_BUCKET_ENV];
+        const supabaseJwtSecretKey = process.env[FlowsPersistenceFactoryImpl.SUPABASE_JWT_SECRET_KEY_ENV];
+        return new FlowsPersistenceFactoryImpl(deploymentEnvironment, awsS3Bucket ? awsS3Bucket : null, awsS3Region ? awsS3Region : null, googleCloudStorageBucket ? googleCloudStorageBucket : null, supabaseJwtSecretKey ? supabaseJwtSecretKey : null, baseOutputDir, requestContextHolder);
+    }
+    /**
+     * Creates a new FlowsPersistence instance.
+     *
+     * @throws NoApiAccessTokenPresentException If the deploymentEnvironment has a value of
+     *     DonobuDeploymentEnvironment.DONOBU_HOSTED_MULTI_TENANT, and the current RequestContext
+     *     accessToken is null or invalid.
+     */
+    async createPersistenceLayer() {
+        const requestContext = this.requestContextHolder.get();
+        if (this.awsS3Bucket && this.awsS3Region) {
+            return new FlowsPersistenceAwsS3_1.FlowsPersistenceAwsS3(this.awsS3Bucket, this.awsS3Region);
+        }
+        else if (this.googleCloudStorageBucket) {
+            return FlowsPersistenceGoogleCloudStorage_1.FlowsPersistenceGoogleCloudStorage.create(this.googleCloudStorageBucket);
+        }
+        else if (this.deploymentEnvironment === DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.LOCAL) {
+            return new FlowsPersistenceFilesystem_1.FlowsPersistenceFilesystem(this.baseOutputDir);
+        }
+        else if (this.deploymentEnvironment ===
+            DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.DONOBU_HOSTED_MULTI_TENANT) {
+            if (!requestContext.accessToken) {
+                throw new NoApiAccessTokenPresentException_1.NoApiAccessTokenPresentException();
+            }
+            return new FlowsPersistenceSupabase_1.FlowsPersistenceSupabase(SupabaseClient_1.SupabaseClient.createClient(requestContext.accessToken, this.supabaseJwtSecretKey));
+        }
+        throw new Error('No valid flow persistence implementation available!');
+    }
+    /** Returns a list of all valid persistence layers. Note that the returned list may be empty! */
+    async createPersistenceLayers() {
+        const flowsPersistences = [];
+        const requestContext = this.requestContextHolder.get();
+        if (this.googleCloudStorageBucket) {
+            flowsPersistences.push(await FlowsPersistenceGoogleCloudStorage_1.FlowsPersistenceGoogleCloudStorage.create(this.googleCloudStorageBucket));
+        }
+        if (this.deploymentEnvironment ===
+            DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.DONOBU_HOSTED_MULTI_TENANT &&
+            requestContext.accessToken &&
+            this.supabaseJwtSecretKey) {
+            flowsPersistences.push(new FlowsPersistenceSupabase_1.FlowsPersistenceSupabase(SupabaseClient_1.SupabaseClient.createClient(requestContext.accessToken, this.supabaseJwtSecretKey)));
+        }
+        else if (this.deploymentEnvironment === DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.LOCAL) {
+            flowsPersistences.push(new FlowsPersistenceFilesystem_1.FlowsPersistenceFilesystem(this.baseOutputDir));
+        }
+        return flowsPersistences;
+    }
+}
+exports.FlowsPersistenceFactoryImpl = FlowsPersistenceFactoryImpl;
+//# sourceMappingURL=FlowsPersistenceFactoryImpl.js.map

package/dist/managers/FlowsPersistenceFactoryImpl.js.map

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

package/dist/managers/FlowsPersistenceFactoryPreset.d.ts

@@ -0,0 +1,12 @@
+import { FlowsPersistence } from './FlowsPersistence';
+import { FlowsPersistenceFactory } from './FlowsPersistenceFactory';
+/**
+ * An implementation of FlowsPersistenceFactory that always returns the same
+ * persistence layers given at construction time.
+ */
+export declare class FlowsPersistenceFactoryPreset implements FlowsPersistenceFactory {
+    private readonly persistenceLayers;
+    constructor(persistenceLayers: FlowsPersistence[]);
+    createPersistenceLayer(): Promise<FlowsPersistence>;
+    createPersistenceLayers(): Promise<FlowsPersistence[]>;
+}

package/dist/managers/FlowsPersistenceFactoryPreset.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowsPersistenceFactoryPreset = void 0;
+/**
+ * An implementation of FlowsPersistenceFactory that always returns the same
+ * persistence layers given at construction time.
+ */
+class FlowsPersistenceFactoryPreset {
+    persistenceLayers;
+    constructor(persistenceLayers) {
+        this.persistenceLayers = persistenceLayers;
+    }
+    async createPersistenceLayer() {
+        const persistenceLayer = this.persistenceLayers[0];
+        if (!persistenceLayer) {
+            throw new Error('No persistence layer available');
+        }
+        return persistenceLayer;
+    }
+    async createPersistenceLayers() {
+        return this.persistenceLayers;
+    }
+}
+exports.FlowsPersistenceFactoryPreset = FlowsPersistenceFactoryPreset;
+//# sourceMappingURL=FlowsPersistenceFactoryPreset.js.map

package/dist/managers/FlowsPersistenceFactoryPreset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowsPersistenceFactoryPreset.js","sourceRoot":"","sources":["../../src/managers/FlowsPersistenceFactoryPreset.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,6BAA6B;IACJ;IAApC,YAAoC,iBAAqC;QAArC,sBAAiB,GAAjB,iBAAiB,CAAoB;IAAG,CAAC;IAE7E,KAAK,CAAC,sBAAsB;QAC1B,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAEnD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,uBAAuB;QAC3B,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;CACF;AAhBD,sEAgBC"}

package/dist/managers/FlowsPersistenceFilesystem.d.ts

@@ -0,0 +1,33 @@
+import { FlowMetadata } from '../models/FlowMetadata';
+import { ToolCall } from '../models/ToolCall';
+import { VideoSegment } from '../models/VideoSegment';
+import { FlowsPersistence } from './FlowsPersistence';
+import { BrowserStorageState } from '../models/BrowserState';
+/**
+ * A persistence implementation that uses the filesystem.
+ */
+export declare class FlowsPersistenceFilesystem implements FlowsPersistence {
+    private static readonly METADATA_FILENAME;
+    private static readonly BROWSER_STATE_FILENAME;
+    private static readonly SCREENSHOT_FILENAME_SUFFIX;
+    private static readonly TOOL_CALL_FILENAME_SUFFIX;
+    private static readonly VIDEO_FILENAME;
+    private readonly flowsDirectory;
+    constructor(baseFlowsDirectory: string);
+    saveMetadata(flowMetadata: FlowMetadata): Promise<void>;
+    getMetadataByFlowId(flowId: string): Promise<FlowMetadata>;
+    getMetadataByFlowName(flowName: string): Promise<FlowMetadata>;
+    savePngScreenShot(flowId: string, bytes: Buffer): Promise<string>;
+    saveToolCall(flowId: string, toolCall: ToolCall): Promise<void>;
+    getToolCalls(flowId: string): Promise<ToolCall[]>;
+    getFlows(): Promise<FlowMetadata[]>;
+    setVideo(flowId: string, bytes: Buffer): Promise<void>;
+    getVideoSegment(flowId: string, startOffset: number, length: number): Promise<VideoSegment | null>;
+    getFlowFile(flowId: string, fileId: string): Promise<Buffer | null>;
+    setFlowFile(flowId: string, fileId: string, fileBytes: Buffer): Promise<void>;
+    setBrowserState(flowId: string, browserState: BrowserStorageState): Promise<void>;
+    getBrowserState(flowId: string): Promise<BrowserStorageState | null>;
+    deleteFlow(flowId: string): Promise<void>;
+    private getFlowDirectory;
+    private getAllFlowDirectories;
+}

package/dist/managers/FlowsPersistenceFilesystem.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowsPersistenceFilesystem = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const FlowNotFoundException_1 = require("../exceptions/FlowNotFoundException");
+const Logger_1 = require("../utils/Logger");
+const JsonUtils_1 = require("../utils/JsonUtils");
+/**
+ * A persistence implementation that uses the filesystem.
+ */
+class FlowsPersistenceFilesystem {
+    static METADATA_FILENAME = 'metadata.json';
+    static BROWSER_STATE_FILENAME = 'browserstate.json';
+    static SCREENSHOT_FILENAME_SUFFIX = '.screenshot.png';
+    static TOOL_CALL_FILENAME_SUFFIX = '.tool-call.json';
+    static VIDEO_FILENAME = 'video.webm';
+    flowsDirectory;
+    constructor(baseFlowsDirectory) {
+        this.flowsDirectory = path_1.default.join(baseFlowsDirectory, 'flows');
+        // Ensure directory exists
+        promises_1.default.mkdir(this.flowsDirectory, { recursive: true }).catch((err) => {
+            Logger_1.Logger.appLogger.error('Failed to create flows directory', err);
+        });
+    }
+    async saveMetadata(flowMetadata) {
+        const flowDir = this.getFlowDirectory(flowMetadata.id);
+        await promises_1.default.mkdir(flowDir, { recursive: true });
+        const filePath = path_1.default.join(flowDir, FlowsPersistenceFilesystem.METADATA_FILENAME);
+        await promises_1.default.writeFile(filePath, JSON.stringify(flowMetadata, null, 2));
+    }
+    async getMetadataByFlowId(flowId) {
+        const filePath = path_1.default.join(this.getFlowDirectory(flowId), FlowsPersistenceFilesystem.METADATA_FILENAME);
+        try {
+            const content = await promises_1.default.readFile(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (_e) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+    }
+    async getMetadataByFlowName(flowName) {
+        const flows = (await this.getFlows()).filter((flow) => flow.name === flowName);
+        if (flows.length > 0) {
+            return flows[0];
+        }
+        else {
+            throw FlowNotFoundException_1.FlowNotFoundException.forName(flowName);
+        }
+    }
+    async savePngScreenShot(flowId, bytes) {
+        const filename = `${new Date().toISOString()}${FlowsPersistenceFilesystem.SCREENSHOT_FILENAME_SUFFIX}`;
+        const screenShotPath = path_1.default.join(this.getFlowDirectory(flowId), filename);
+        await promises_1.default.writeFile(screenShotPath, bytes);
+        return filename;
+    }
+    async saveToolCall(flowId, toolCall) {
+        const filePath = path_1.default.join(this.getFlowDirectory(flowId), `${toolCall.startedAt}${FlowsPersistenceFilesystem.TOOL_CALL_FILENAME_SUFFIX}`);
+        await promises_1.default.writeFile(filePath, JSON.stringify(toolCall, null, 2));
+    }
+    async getToolCalls(flowId) {
+        const flowDir = this.getFlowDirectory(flowId);
+        try {
+            const files = await promises_1.default.readdir(flowDir);
+            const toolCallFiles = files.filter((file) => file.endsWith(FlowsPersistenceFilesystem.TOOL_CALL_FILENAME_SUFFIX));
+            const toolCalls = await Promise.all(toolCallFiles.sort().map(async (file) => {
+                const content = await promises_1.default.readFile(path_1.default.join(flowDir, file), 'utf-8');
+                return JSON.parse(content);
+            }));
+            return toolCalls.sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+        }
+        catch (_e) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+    }
+    async getFlows() {
+        const flowDirs = await this.getAllFlowDirectories();
+        const metadataFiles = await Promise.all(flowDirs.map(async (dir) => {
+            try {
+                const content = await promises_1.default.readFile(path_1.default.join(dir, FlowsPersistenceFilesystem.METADATA_FILENAME), 'utf-8');
+                return JSON.parse(content);
+            }
+            catch {
+                return null;
+            }
+        }));
+        return metadataFiles.filter((metadata) => metadata !== null);
+    }
+    async setVideo(flowId, bytes) {
+        const videoPath = path_1.default.join(this.getFlowDirectory(flowId), FlowsPersistenceFilesystem.VIDEO_FILENAME);
+        await promises_1.default.writeFile(videoPath, bytes);
+    }
+    async getVideoSegment(flowId, startOffset, length) {
+        try {
+            await this.getMetadataByFlowId(flowId);
+            const videoPath = path_1.default.join(this.getFlowDirectory(flowId), FlowsPersistenceFilesystem.VIDEO_FILENAME);
+            const stats = await promises_1.default.stat(videoPath);
+            const totalLength = stats.size;
+            const adjustedLength = Math.min(length, totalLength - startOffset);
+            const buffer = Buffer.alloc(adjustedLength);
+            const fileHandle = await promises_1.default.open(videoPath, 'r');
+            try {
+                await fileHandle.read(buffer, 0, adjustedLength, startOffset);
+                return {
+                    bytes: buffer,
+                    totalLength: totalLength,
+                    startOffset: startOffset,
+                };
+            }
+            finally {
+                await fileHandle.close();
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    async getFlowFile(flowId, fileId) {
+        try {
+            await this.getMetadataByFlowId(flowId);
+            const filePath = path_1.default.join(this.getFlowDirectory(flowId), fileId);
+            return await promises_1.default.readFile(filePath);
+        }
+        catch {
+            return null;
+        }
+    }
+    async setFlowFile(flowId, fileId, fileBytes) {
+        const filePath = path_1.default.join(this.getFlowDirectory(flowId), fileId);
+        await promises_1.default.writeFile(filePath, fileBytes);
+    }
+    async setBrowserState(flowId, browserState) {
+        const serializedBrowserState = Buffer.from(JSON.stringify(browserState), 'utf-8');
+        await this.setFlowFile(flowId, FlowsPersistenceFilesystem.BROWSER_STATE_FILENAME, serializedBrowserState);
+    }
+    async getBrowserState(flowId) {
+        const browserStateRaw = await this.getFlowFile(flowId, FlowsPersistenceFilesystem.BROWSER_STATE_FILENAME);
+        if (browserStateRaw) {
+            const browserState = JsonUtils_1.JsonUtils.jsonStringToJsonObject(browserStateRaw.toString('utf-8'));
+            if (browserState) {
+                return browserState;
+            }
+            else {
+                throw new Error(`Cannot load malformed browser state from flow ${flowId}`);
+            }
+        }
+        else {
+            return null;
+        }
+    }
+    async deleteFlow(flowId) {
+        const flowDirectory = this.getFlowDirectory(flowId);
+        await promises_1.default.rm(flowDirectory, { recursive: true, force: true });
+    }
+    getFlowDirectory(flowId) {
+        if (!flowId) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+        return path_1.default.join(this.flowsDirectory, flowId);
+    }
+    async getAllFlowDirectories() {
+        try {
+            const entries = await promises_1.default.readdir(this.flowsDirectory, {
+                withFileTypes: true,
+            });
+            return entries
+                .filter((entry) => entry.isDirectory())
+                .map((entry) => path_1.default.join(this.flowsDirectory, entry.name));
+        }
+        catch (error) {
+            Logger_1.Logger.appLogger.error('Failed to find flow root directory', error);
+            throw error;
+        }
+    }
+}
+exports.FlowsPersistenceFilesystem = FlowsPersistenceFilesystem;
+//# sourceMappingURL=FlowsPersistenceFilesystem.js.map

package/dist/managers/FlowsPersistenceFilesystem.js.map

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

package/dist/managers/FlowsPersistenceGoogleCloudStorage.d.ts

@@ -0,0 +1,40 @@
+import { FlowsPersistence } from './FlowsPersistence';
+import { FlowMetadata } from '../models/FlowMetadata';
+import { ToolCall } from '../models/ToolCall';
+import { VideoSegment } from '../models/VideoSegment';
+import { BrowserStorageState } from '../models/BrowserState';
+/**
+ * A persistence implementation that uses Google Cloud Storage.
+ * If you are running locally, be sure to have the Google Cloud CLI installed
+ * so that you can authenticate using `gcloud auth init` before running Donobu.
+ * If Donobu is being run in the Google cloud, be sure that the service account
+ * in which it is being run has permissions to read and write the Google Cloud
+ * Storage bucket specified as a constructor argument.
+ */
+export declare class FlowsPersistenceGoogleCloudStorage implements FlowsPersistence {
+    private readonly bucket;
+    private static readonly METADATA_FILENAME;
+    private static readonly BROWSER_STATE_FILENAME;
+    private static readonly SCREENSHOT_FILENAME_SUFFIX;
+    private static readonly TOOL_CALL_FILENAME_SUFFIX;
+    private static readonly VIDEO_FILENAME;
+    static create(bucketName: string): Promise<FlowsPersistenceGoogleCloudStorage>;
+    private constructor();
+    saveMetadata(flowMetadata: FlowMetadata): Promise<void>;
+    getMetadataByFlowId(flowId: string): Promise<FlowMetadata>;
+    getMetadataByFlowName(flowName: string): Promise<FlowMetadata>;
+    savePngScreenShot(flowId: string, bytes: Buffer): Promise<string>;
+    saveToolCall(flowId: string, toolCall: ToolCall): Promise<void>;
+    getToolCalls(flowId: string): Promise<ToolCall[]>;
+    getFlows(): Promise<FlowMetadata[]>;
+    setVideo(flowId: string, bytes: Buffer): Promise<void>;
+    getVideoSegment(flowId: string, startOffset: number, length: number): Promise<VideoSegment | null>;
+    getFlowFile(flowId: string, fileId: string): Promise<Buffer | null>;
+    setFlowFile(flowId: string, fileId: string, fileBytes: Buffer): Promise<void>;
+    setBrowserState(flowId: string, browserState: BrowserStorageState): Promise<void>;
+    getBrowserState(flowId: string): Promise<BrowserStorageState | null>;
+    deleteFlow(flowId: string): Promise<void>;
+    private uploadString;
+    private uploadBytes;
+    private downloadString;
+}

package/dist/managers/FlowsPersistenceGoogleCloudStorage.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowsPersistenceGoogleCloudStorage = void 0;
+const storage_1 = require("@google-cloud/storage");
+const FlowNotFoundException_1 = require("../exceptions/FlowNotFoundException");
+const Logger_1 = require("../utils/Logger");
+const JsonUtils_1 = require("../utils/JsonUtils");
+/**
+ * A persistence implementation that uses Google Cloud Storage.
+ * If you are running locally, be sure to have the Google Cloud CLI installed
+ * so that you can authenticate using `gcloud auth init` before running Donobu.
+ * If Donobu is being run in the Google cloud, be sure that the service account
+ * in which it is being run has permissions to read and write the Google Cloud
+ * Storage bucket specified as a constructor argument.
+ */
+class FlowsPersistenceGoogleCloudStorage {
+    bucket;
+    static METADATA_FILENAME = 'metadata.json';
+    static BROWSER_STATE_FILENAME = 'browserstate.json';
+    static SCREENSHOT_FILENAME_SUFFIX = '.screenshot.png';
+    static TOOL_CALL_FILENAME_SUFFIX = '.tool-call.json';
+    static VIDEO_FILENAME = 'video.webm';
+    static async create(bucketName) {
+        const storage = new storage_1.Storage();
+        const bucket = storage.bucket(bucketName);
+        return bucket
+            .exists()
+            .then(([exists]) => {
+            if (!exists) {
+                throw new Error(`Bucket ${bucketName} does not exist.`);
+            }
+            else {
+                return bucket;
+            }
+        })
+            .then((bucket) => {
+            return new FlowsPersistenceGoogleCloudStorage(bucket);
+        });
+    }
+    constructor(bucket) {
+        this.bucket = bucket;
+    }
+    async saveMetadata(flowMetadata) {
+        const objectName = `${flowMetadata.id}/${FlowsPersistenceGoogleCloudStorage.METADATA_FILENAME}`;
+        await this.uploadString(objectName, JSON.stringify(flowMetadata), 'application/json');
+    }
+    async getMetadataByFlowId(flowId) {
+        const objectName = `${flowId}/${FlowsPersistenceGoogleCloudStorage.METADATA_FILENAME}`;
+        const jsonData = await this.downloadString(objectName);
+        if (!jsonData) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+        return JSON.parse(jsonData);
+    }
+    async getMetadataByFlowName(flowName) {
+        const flows = (await this.getFlows()).filter((flow) => flow.name === flowName);
+        if (flows.length > 0) {
+            return flows[0];
+        }
+        else {
+            throw FlowNotFoundException_1.FlowNotFoundException.forName(flowName);
+        }
+    }
+    async savePngScreenShot(flowId, bytes) {
+        const filename = `${new Date().toISOString()}${FlowsPersistenceGoogleCloudStorage.SCREENSHOT_FILENAME_SUFFIX}`;
+        const objectName = `${flowId}/${filename}`;
+        await this.uploadBytes(objectName, bytes, 'image/png');
+        return filename;
+    }
+    async saveToolCall(flowId, toolCall) {
+        const filename = `${toolCall.startedAt}${FlowsPersistenceGoogleCloudStorage.TOOL_CALL_FILENAME_SUFFIX}`;
+        const objectName = `${flowId}/${filename}`;
+        await this.uploadString(objectName, JSON.stringify(toolCall), 'application/json');
+    }
+    async getToolCalls(flowId) {
+        const prefix = `${flowId}/`;
+        const [files] = await this.bucket.getFiles({ prefix });
+        const toolCalls = [];
+        for (const file of files) {
+            if (file.name.endsWith(FlowsPersistenceGoogleCloudStorage.TOOL_CALL_FILENAME_SUFFIX)) {
+                const [content] = await file.download();
+                const toolCall = JSON.parse(content.toString());
+                toolCalls.push(toolCall);
+            }
+        }
+        if (toolCalls.length === 0) {
+            throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+        }
+        return toolCalls.sort((a, b) => a.startedAt.localeCompare(b.startedAt));
+    }
+    async getFlows() {
+        const [files] = await this.bucket.getFiles();
+        const flowIds = new Set();
+        for (const file of files) {
+            if (file.name.endsWith(`/${FlowsPersistenceGoogleCloudStorage.METADATA_FILENAME}`)) {
+                const flowId = file.name.substring(0, file.name.indexOf('/'));
+                flowIds.add(flowId);
+            }
+        }
+        const flows = [];
+        for (const flowId of flowIds) {
+            try {
+                flows.push(await this.getMetadataByFlowId(flowId));
+            }
+            catch (e) {
+                Logger_1.Logger.appLogger.warn(`Flow not found: ${flowId}`, e);
+            }
+        }
+        return flows;
+    }
+    async setVideo(flowId, bytes) {
+        const objectName = `${flowId}/${FlowsPersistenceGoogleCloudStorage.VIDEO_FILENAME}`;
+        await this.uploadBytes(objectName, bytes, 'video/webm');
+    }
+    async getVideoSegment(flowId, startOffset, length) {
+        const objectName = `${flowId}/${FlowsPersistenceGoogleCloudStorage.VIDEO_FILENAME}`;
+        const file = this.bucket.file(objectName);
+        const [exists] = await file.exists();
+        if (!exists) {
+            return null;
+        }
+        const [metadata] = await file.getMetadata();
+        const totalLength = Number(metadata.size);
+        const adjustedLength = Math.min(length, totalLength - startOffset);
+        if (adjustedLength <= 0) {
+            return null;
+        }
+        try {
+            const [content] = await file.download({
+                start: startOffset,
+                end: startOffset + adjustedLength - 1,
+            });
+            return {
+                bytes: content,
+                totalLength: totalLength,
+                startOffset: startOffset,
+            };
+        }
+        catch (e) {
+            Logger_1.Logger.appLogger.error(`Error reading video segment for flowId ${flowId}: ${e}`);
+            return null;
+        }
+    }
+    async getFlowFile(flowId, fileId) {
+        const objectName = `${flowId}/${fileId}`;
+        const file = this.bucket.file(objectName);
+        const [exists] = await file.exists();
+        if (!exists) {
+            return null;
+        }
+        const [content] = await file.download();
+        return content;
+    }
+    async setFlowFile(flowId, fileId, fileBytes) {
+        const objectName = `${flowId}/${fileId}`;
+        await this.uploadBytes(objectName, fileBytes, 'application/octet-stream');
+    }
+    async setBrowserState(flowId, browserState) {
+        const serializedBrowserState = Buffer.from(JSON.stringify(browserState), 'utf-8');
+        await this.setFlowFile(flowId, FlowsPersistenceGoogleCloudStorage.BROWSER_STATE_FILENAME, serializedBrowserState);
+    }
+    async getBrowserState(flowId) {
+        const browserStateRaw = await this.getFlowFile(flowId, FlowsPersistenceGoogleCloudStorage.BROWSER_STATE_FILENAME);
+        if (browserStateRaw) {
+            const browserState = JsonUtils_1.JsonUtils.jsonStringToJsonObject(browserStateRaw.toString('utf-8'));
+            if (browserState) {
+                return browserState;
+            }
+            else {
+                throw new Error(`Cannot load malformed browser state from flow ${flowId}`);
+            }
+        }
+        else {
+            return null;
+        }
+    }
+    async deleteFlow(flowId) {
+        const prefix = `${flowId}/`;
+        const [files] = await this.bucket.getFiles({ prefix });
+        if (files.length > 0) {
+            await Promise.all(files.map((file) => file.delete()));
+        }
+    }
+    async uploadString(objectName, data, contentType) {
+        const file = this.bucket.file(objectName);
+        await file.save(data, {
+            contentType,
+            metadata: { contentType },
+        });
+    }
+    async uploadBytes(objectName, bytes, contentType) {
+        const file = this.bucket.file(objectName);
+        await file.save(bytes, {
+            contentType,
+            metadata: { contentType },
+        });
+    }
+    async downloadString(objectName) {
+        const file = this.bucket.file(objectName);
+        const [exists] = await file.exists();
+        if (!exists) {
+            return null;
+        }
+        const [content] = await file.download();
+        return content.toString();
+    }
+}
+exports.FlowsPersistenceGoogleCloudStorage = FlowsPersistenceGoogleCloudStorage;
+//# sourceMappingURL=FlowsPersistenceGoogleCloudStorage.js.map