donobu 2.16.0 → 2.17.0

package/dist/esm/persistence/env/EnvPersistenceFactoryImpl.d.ts

@@ -0,0 +1,45 @@
+import { EnvPersistence } from './EnvPersistence';
+import { RequestContextHolder } from '../../managers/RequestContextHolder';
+import { DonobuDeploymentEnvironment } from '../../models/DonobuDeploymentEnvironment';
+import { EnvPersistenceFactory } from './EnvPersistenceFactory';
+import { EnvPersistenceVolatile } from './EnvPersistenceVolatile';
+/**
+ * A factory class for creating new EnvPersistence instances. The type of persistence
+ * objects created varies depending on this factory's constructor arguments and the current API
+ * request context.
+ */
+export declare class EnvPersistenceFactoryImpl implements EnvPersistenceFactory {
+    private readonly deploymentEnvironment;
+    private readonly awsS3Bucket;
+    private readonly awsS3Region;
+    private readonly googleCloudStorageBucket;
+    private readonly supabaseJwtSecretKey;
+    private readonly requestContextHolder;
+    private readonly envPersistenceVolatile;
+    /**
+     * 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 requestContextHolder The object used to get the current API request context.
+     */
+    constructor(deploymentEnvironment: DonobuDeploymentEnvironment, awsS3Bucket: string | null, awsS3Region: string | null, googleCloudStorageBucket: string | null, supabaseJwtSecretKey: string | null, requestContextHolder: RequestContextHolder, envPersistenceVolatile: EnvPersistenceVolatile | null);
+    /**
+     * Creates an instance.
+     */
+    static fromEnvironment(deploymentEnvironment: DonobuDeploymentEnvironment, requestContextHolder: RequestContextHolder, envPersistenceVolatile: EnvPersistenceVolatile | null): Promise<EnvPersistenceFactoryImpl>;
+    /** Returns a list of all valid persistence layers. Note that the returned list may be empty! */
+    createPersistenceLayers(): Promise<EnvPersistence[]>;
+}
+//# sourceMappingURL=EnvPersistenceFactoryImpl.d.ts.map

package/dist/esm/persistence/env/EnvPersistenceFactoryImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvPersistenceFactoryImpl.d.ts","sourceRoot":"","sources":["../../../../src/persistence/env/EnvPersistenceFactoryImpl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;IAoBnE,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,wBAAwB;IACzC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAzBzC;;;;;;;;;;;;;;;;;OAiBG;gBAEgB,qBAAqB,EAAE,2BAA2B,EAClD,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,wBAAwB,EAAE,MAAM,GAAG,IAAI,EACvC,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,oBAAoB,EAAE,oBAAoB,EAC1C,sBAAsB,EAAE,sBAAsB,GAAG,IAAI;IAaxE;;OAEG;WACiB,eAAe,CACjC,qBAAqB,EAAE,2BAA2B,EAClD,oBAAoB,EAAE,oBAAoB,EAC1C,sBAAsB,EAAE,sBAAsB,GAAG,IAAI,GACpD,OAAO,CAAC,yBAAyB,CAAC;IAmBrC,gGAAgG;IACnF,uBAAuB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CA0ClE"}

package/dist/esm/persistence/env/EnvPersistenceFactoryImpl.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvPersistenceFactoryImpl = void 0;
+const EnvPersistenceGoogleCloudStorage_1 = require("./EnvPersistenceGoogleCloudStorage");
+const EnvPersistenceSupabase_1 = require("./EnvPersistenceSupabase");
+const SupabaseClient_1 = require("../../clients/SupabaseClient");
+const DonobuDeploymentEnvironment_1 = require("../../models/DonobuDeploymentEnvironment");
+const EnvPersistenceAwsS3_1 = require("./EnvPersistenceAwsS3");
+const EnvPersistenceSqlite_1 = require("./EnvPersistenceSqlite");
+const DonobuSqliteDb_1 = require("../DonobuSqliteDb");
+const envVars_1 = require("../../envVars");
+/**
+ * A factory class for creating new EnvPersistence instances. The type of persistence
+ * objects created varies depending on this factory's constructor arguments and the current API
+ * request context.
+ */
+class EnvPersistenceFactoryImpl {
+    /**
+     * 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 requestContextHolder The object used to get the current API request context.
+     */
+    constructor(deploymentEnvironment, awsS3Bucket, awsS3Region, googleCloudStorageBucket, supabaseJwtSecretKey, requestContextHolder, envPersistenceVolatile) {
+        this.deploymentEnvironment = deploymentEnvironment;
+        this.awsS3Bucket = awsS3Bucket;
+        this.awsS3Region = awsS3Region;
+        this.googleCloudStorageBucket = googleCloudStorageBucket;
+        this.supabaseJwtSecretKey = supabaseJwtSecretKey;
+        this.requestContextHolder = requestContextHolder;
+        this.envPersistenceVolatile = envPersistenceVolatile;
+        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.
+     */
+    static async fromEnvironment(deploymentEnvironment, requestContextHolder, envPersistenceVolatile) {
+        const awsS3Bucket = process.env[envVars_1.ENV_VAR_NAMES.AWS_S3_BUCKET];
+        const awsS3Region = process.env[envVars_1.ENV_VAR_NAMES.AWS_S3_REGION || envVars_1.ENV_VAR_NAMES.AWS_REGION];
+        const googleCloudStorageBucket = process.env[envVars_1.ENV_VAR_NAMES.GOOGLE_CLOUD_STORAGE_BUCKET];
+        const supabaseJwtSecretKey = process.env[envVars_1.ENV_VAR_NAMES.SUPABASE_JWT_SECRET_KEY];
+        return new EnvPersistenceFactoryImpl(deploymentEnvironment, awsS3Bucket ?? null, awsS3Region ?? null, googleCloudStorageBucket ?? null, supabaseJwtSecretKey ?? null, requestContextHolder, envPersistenceVolatile ?? null);
+    }
+    /** Returns a list of all valid persistence layers. Note that the returned list may be empty! */
+    async createPersistenceLayers() {
+        const layers = [];
+        const requestContext = this.requestContextHolder.get();
+        if (this.awsS3Bucket && this.awsS3Region) {
+            layers.push(new EnvPersistenceAwsS3_1.EnvPersistenceAwsS3(this.awsS3Bucket, this.awsS3Region));
+        }
+        if (this.googleCloudStorageBucket) {
+            layers.push(await EnvPersistenceGoogleCloudStorage_1.EnvPersistenceGoogleCloudStorage.create(this.googleCloudStorageBucket));
+        }
+        if (this.deploymentEnvironment ===
+            DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.DONOBU_HOSTED_MULTI_TENANT &&
+            requestContext.accessToken &&
+            this.supabaseJwtSecretKey) {
+            layers.push(new EnvPersistenceSupabase_1.EnvPersistenceSupabase(SupabaseClient_1.SupabaseClient.createClient(requestContext.accessToken, this.supabaseJwtSecretKey)));
+        }
+        else if (this.deploymentEnvironment === DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.LOCAL) {
+            layers.push(await EnvPersistenceSqlite_1.EnvPersistenceSqlite.create((0, DonobuSqliteDb_1.getDonobuSqliteDatabase)()));
+        }
+        if (this.envPersistenceVolatile) {
+            layers.push(this.envPersistenceVolatile);
+        }
+        return layers;
+    }
+}
+exports.EnvPersistenceFactoryImpl = EnvPersistenceFactoryImpl;
+//# sourceMappingURL=EnvPersistenceFactoryImpl.js.map

package/dist/esm/persistence/env/EnvPersistenceFactoryImpl.js.map

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

package/dist/esm/persistence/env/EnvPersistenceFactoryPreset.d.ts

@@ -0,0 +1,12 @@
+import { EnvPersistence } from './EnvPersistence';
+import { EnvPersistenceFactory } from './EnvPersistenceFactory';
+/**
+ * An implementation of EnvPersistenceFactory that always returns the same
+ * persistence layers given at construction time.
+ */
+export declare class EnvPersistenceFactoryPreset implements EnvPersistenceFactory {
+    private readonly persistenceLayers;
+    constructor(persistenceLayers: EnvPersistence[]);
+    createPersistenceLayers(): Promise<EnvPersistence[]>;
+}
+//# sourceMappingURL=EnvPersistenceFactoryPreset.d.ts.map

package/dist/esm/persistence/env/EnvPersistenceFactoryPreset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvPersistenceFactoryPreset.d.ts","sourceRoot":"","sources":["../../../../src/persistence/env/EnvPersistenceFactoryPreset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,qBAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,cAAc,EAAE;IAE1D,uBAAuB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAGlE"}

package/dist/esm/persistence/env/EnvPersistenceFactoryPreset.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvPersistenceFactoryPreset = void 0;
+/**
+ * An implementation of EnvPersistenceFactory that always returns the same
+ * persistence layers given at construction time.
+ */
+class EnvPersistenceFactoryPreset {
+    constructor(persistenceLayers) {
+        this.persistenceLayers = persistenceLayers;
+    }
+    async createPersistenceLayers() {
+        return this.persistenceLayers;
+    }
+}
+exports.EnvPersistenceFactoryPreset = EnvPersistenceFactoryPreset;
+//# sourceMappingURL=EnvPersistenceFactoryPreset.js.map

package/dist/esm/persistence/env/EnvPersistenceFactoryPreset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvPersistenceFactoryPreset.js","sourceRoot":"","sources":["../../../../src/persistence/env/EnvPersistenceFactoryPreset.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,2BAA2B;IACtC,YAAoC,iBAAmC;QAAnC,sBAAiB,GAAjB,iBAAiB,CAAkB;IAAG,CAAC;IAEpE,KAAK,CAAC,uBAAuB;QAClC,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;CACF;AAND,kEAMC"}

package/dist/esm/persistence/env/EnvPersistenceFilesystem.d.ts

@@ -0,0 +1,36 @@
+import { EnvPersistence } from './EnvPersistence';
+/**
+ * A persistence implementation that uses the filesystem.
+ */
+export declare class EnvPersistenceFilesystem implements EnvPersistence {
+    readonly environmentDirectory: string;
+    private constructor();
+    static create(storageDirectory: string): Promise<EnvPersistenceFilesystem>;
+    /**
+     * Set a piece of environment data that is available across all flows.
+     */
+    setEnvironmentDatum(key: string, value: string): Promise<void>;
+    /**
+     * Delete a piece of environment data by its key.
+     * No-op if the data does not exist.
+     */
+    deleteEnvironmentDatum(key: string): Promise<void>;
+    /**
+     * Retrieve a piece of environment data by its key.
+     */
+    getEnvironmentDatum(key: string): Promise<string | undefined>;
+    /**
+     * Get all environment data.
+     */
+    getEnvironmentData(): Promise<Record<string, string>>;
+    /**
+     * Encode a key to be used as a filename.
+     * This ensures special characters in keys don't cause filesystem issues.
+     */
+    private encodeKey;
+    /**
+     * Decode a filename back to the original key.
+     */
+    private decodeKey;
+}
+//# sourceMappingURL=EnvPersistenceFilesystem.d.ts.map

package/dist/esm/persistence/env/EnvPersistenceFilesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvPersistenceFilesystem.d.ts","sourceRoot":"","sources":["../../../../src/persistence/env/EnvPersistenceFilesystem.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,qBAAa,wBAAyB,YAAW,cAAc;aACzB,oBAAoB,EAAE,MAAM;IAAhE,OAAO;WAGa,MAAM,CACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,wBAAwB,CAAC;IAWpC;;OAEG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3E;;;OAGG;IACU,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/D;;OAEG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAsB1E;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAuClE;;;OAGG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,SAAS;CAGlB"}

package/dist/esm/persistence/env/EnvPersistenceFilesystem.js

@@ -0,0 +1,132 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvPersistenceFilesystem = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const Logger_1 = require("../../utils/Logger");
+/**
+ * A persistence implementation that uses the filesystem.
+ */
+class EnvPersistenceFilesystem {
+    constructor(environmentDirectory) {
+        this.environmentDirectory = environmentDirectory;
+    }
+    // Update the create method to also create the environment directory
+    static async create(storageDirectory) {
+        const environmentDirectory = path_1.default.join(storageDirectory, 'environment');
+        // Ensure directory exists
+        await promises_1.default.mkdir(environmentDirectory, { recursive: true }).catch((err) => {
+            Logger_1.appLogger.error('Failed to create environment directory', err);
+        });
+        return new EnvPersistenceFilesystem(environmentDirectory);
+    }
+    /**
+     * Set a piece of environment data that is available across all flows.
+     */
+    async setEnvironmentDatum(key, value) {
+        if (!key) {
+            throw new Error('Key cannot be empty');
+        }
+        // Create the environment directory if it doesn't exist
+        await promises_1.default.mkdir(this.environmentDirectory, { recursive: true });
+        // Create a file with the key as the filename (properly encoded)
+        const filePath = path_1.default.join(this.environmentDirectory, this.encodeKey(key));
+        await promises_1.default.writeFile(filePath, value, 'utf-8');
+    }
+    /**
+     * Delete a piece of environment data by its key.
+     * No-op if the data does not exist.
+     */
+    async deleteEnvironmentDatum(key) {
+        if (!key) {
+            return; // No-op if key is empty
+        }
+        const filePath = path_1.default.join(this.environmentDirectory, this.encodeKey(key));
+        try {
+            // Check if file exists before attempting to delete
+            await promises_1.default.access(filePath);
+            await promises_1.default.unlink(filePath);
+        }
+        catch (error) {
+            // Ignore file not found errors
+            if (error.code !== 'ENOENT') {
+                Logger_1.appLogger.warn(`Failed to delete environment data for key: ${key}`, error);
+            }
+        }
+    }
+    /**
+     * Retrieve a piece of environment data by its key.
+     */
+    async getEnvironmentDatum(key) {
+        if (!key) {
+            return undefined;
+        }
+        const filePath = path_1.default.join(this.environmentDirectory, this.encodeKey(key));
+        try {
+            const content = await promises_1.default.readFile(filePath, 'utf-8');
+            return content;
+        }
+        catch (error) {
+            // Return undefined if the file doesn't exist
+            if (error.code === 'ENOENT') {
+                return undefined;
+            }
+            // Log other errors but still return undefined
+            Logger_1.appLogger.warn(`Failed to read environment data for key: ${key}`, error);
+            return undefined;
+        }
+    }
+    /**
+     * Get all environment data.
+     */
+    async getEnvironmentData() {
+        const result = {};
+        try {
+            // Create the directory if it doesn't exist
+            await promises_1.default.mkdir(this.environmentDirectory, { recursive: true });
+            // Get all files in the environment directory
+            const files = await promises_1.default.readdir(this.environmentDirectory);
+            // Process each file
+            for (const encodedKey of files) {
+                try {
+                    const filePath = path_1.default.join(this.environmentDirectory, encodedKey);
+                    // Skip directories and non-files
+                    const stats = await promises_1.default.stat(filePath);
+                    if (!stats.isFile()) {
+                        continue;
+                    }
+                    // Read file content and add to result
+                    const content = await promises_1.default.readFile(filePath, 'utf-8');
+                    const key = this.decodeKey(encodedKey);
+                    result[key] = content;
+                }
+                catch (error) {
+                    Logger_1.appLogger.warn(`Failed to read environment data file: ${encodedKey}`, error);
+                }
+            }
+        }
+        catch (error) {
+            Logger_1.appLogger.error('Failed to read environment directory', error);
+        }
+        return result;
+    }
+    /**
+     * Encode a key to be used as a filename.
+     * This ensures special characters in keys don't cause filesystem issues.
+     */
+    encodeKey(key) {
+        // Base64 encode to handle any special characters
+        return Buffer.from(key).toString('base64');
+    }
+    /**
+     * Decode a filename back to the original key.
+     */
+    decodeKey(encodedKey) {
+        return Buffer.from(encodedKey, 'base64').toString('utf-8');
+    }
+}
+exports.EnvPersistenceFilesystem = EnvPersistenceFilesystem;
+//# sourceMappingURL=EnvPersistenceFilesystem.js.map

package/dist/esm/persistence/env/EnvPersistenceFilesystem.js.map

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

package/dist/esm/persistence/env/EnvPersistenceGoogleCloudStorage.d.ts

@@ -0,0 +1,30 @@
+import { EnvPersistence } from './EnvPersistence';
+/**
+ * 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 application-default login`
+ * 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 EnvPersistenceGoogleCloudStorage implements EnvPersistence {
+    private readonly bucket;
+    private static readonly ENVIRONMENT_DATA_PREFIX;
+    /**
+     * Dynamically imports the Google Cloud Storage library.
+     * This helps to delay loading the library until it's actually needed.
+     */
+    private static importGoogleCloudStorage;
+    static create(bucketName: string): Promise<EnvPersistenceGoogleCloudStorage>;
+    private constructor();
+    setEnvironmentDatum(key: string, value: string): Promise<void>;
+    deleteEnvironmentDatum(key: string): Promise<void>;
+    getEnvironmentDatum(key: string): Promise<string | undefined>;
+    getEnvironmentData(): Promise<Record<string, string>>;
+    private uploadString;
+    private downloadString;
+}
+//# sourceMappingURL=EnvPersistenceGoogleCloudStorage.d.ts.map

package/dist/esm/persistence/env/EnvPersistenceGoogleCloudStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvPersistenceGoogleCloudStorage.d.ts","sourceRoot":"","sources":["../../../../src/persistence/env/EnvPersistenceGoogleCloudStorage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASlD;;;;;;;;;;GAUG;AACH,qBAAa,gCAAiC,YAAW,cAAc;IA6CjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IA5C3C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAkB;IAEjE;;;OAGG;mBACkB,wBAAwB;WAezB,MAAM,CACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gCAAgC,CAAC;IAqB5C,OAAO;IAEM,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9D,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlD,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAS7D,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YA+BpD,YAAY;YAYZ,cAAc;CAW7B"}

package/dist/esm/persistence/env/EnvPersistenceGoogleCloudStorage.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvPersistenceGoogleCloudStorage = void 0;
+const Logger_1 = require("../../utils/Logger");
+/**
+ * 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 application-default login`
+ * 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 EnvPersistenceGoogleCloudStorage {
+    /**
+     * Dynamically imports the Google Cloud Storage library.
+     * This helps to delay loading the library until it's actually needed.
+     */
+    static async importGoogleCloudStorage() {
+        try {
+            // Dynamic import to delay loading until needed
+            const module = await import('@google-cloud/storage');
+            return {
+                Storage: module.Storage,
+            };
+        }
+        catch (error) {
+            Logger_1.appLogger.error('Failed to import Google Cloud Storage', error);
+            throw new Error('Failed to import Google Cloud Storage library');
+        }
+    }
+    static async create(bucketName) {
+        // Only import the Google Cloud Storage library when creating an instance
+        const { Storage } = await EnvPersistenceGoogleCloudStorage.importGoogleCloudStorage();
+        const storage = new 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 EnvPersistenceGoogleCloudStorage(bucket);
+        });
+    }
+    constructor(bucket) {
+        this.bucket = bucket;
+    }
+    async setEnvironmentDatum(key, value) {
+        if (!key) {
+            throw new Error('Key cannot be empty');
+        }
+        const objectName = `${EnvPersistenceGoogleCloudStorage.ENVIRONMENT_DATA_PREFIX}${encodeURIComponent(key)}`;
+        await this.uploadString(objectName, value, 'text/plain');
+    }
+    async deleteEnvironmentDatum(key) {
+        if (!key) {
+            return; // No-op if key is empty
+        }
+        const objectName = `${EnvPersistenceGoogleCloudStorage.ENVIRONMENT_DATA_PREFIX}${encodeURIComponent(key)}`;
+        const file = this.bucket.file(objectName);
+        try {
+            const [exists] = await file.exists();
+            if (exists) {
+                await file.delete();
+            }
+        }
+        catch (error) {
+            // Ignore errors if the object doesn't exist
+            Logger_1.appLogger.warn(`Failed to delete environment data for key: ${key}`, error);
+        }
+    }
+    async getEnvironmentDatum(key) {
+        if (!key) {
+            return undefined;
+        }
+        const objectName = `${EnvPersistenceGoogleCloudStorage.ENVIRONMENT_DATA_PREFIX}${encodeURIComponent(key)}`;
+        return (await this.downloadString(objectName)) ?? undefined;
+    }
+    async getEnvironmentData() {
+        const result = {};
+        try {
+            const prefix = EnvPersistenceGoogleCloudStorage.ENVIRONMENT_DATA_PREFIX;
+            const [files] = await this.bucket.getFiles({ prefix });
+            // Process each file
+            for (const file of files) {
+                try {
+                    // Extract the key from the file path
+                    const encodedKey = file.name.substring(prefix.length);
+                    const key = decodeURIComponent(encodedKey);
+                    // Get the file content
+                    const [content] = await file.download();
+                    result[key] = content.toString('utf-8');
+                }
+                catch (error) {
+                    Logger_1.appLogger.warn(`Failed to get environment data for key: ${file.name}`, error);
+                }
+            }
+        }
+        catch (error) {
+            Logger_1.appLogger.error('Failed to list environment data files', error);
+        }
+        return result;
+    }
+    async uploadString(objectName, data, contentType) {
+        const file = this.bucket.file(objectName);
+        await file.save(data, {
+            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.EnvPersistenceGoogleCloudStorage = EnvPersistenceGoogleCloudStorage;
+EnvPersistenceGoogleCloudStorage.ENVIRONMENT_DATA_PREFIX = 'environment/';
+//# sourceMappingURL=EnvPersistenceGoogleCloudStorage.js.map

package/dist/esm/persistence/env/EnvPersistenceGoogleCloudStorage.js.map

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

package/dist/esm/persistence/env/EnvPersistenceSqlite.d.ts

@@ -0,0 +1,19 @@
+import Database from 'better-sqlite3';
+import { EnvPersistence } from './EnvPersistence';
+/**
+ * A persistence implementation that uses SQLite for storage.
+ */
+export declare class EnvPersistenceSqlite implements EnvPersistence {
+    private readonly db;
+    private constructor();
+    static create(db: Database.Database): Promise<EnvPersistenceSqlite>;
+    setEnvironmentDatum(key: string, value: string): Promise<void>;
+    deleteEnvironmentDatum(key: string): Promise<void>;
+    getEnvironmentDatum(key: string): Promise<string | undefined>;
+    /**
+     * Get all environment data.
+     */
+    getEnvironmentData(): Promise<Record<string, string>>;
+    close(): void;
+}
+//# sourceMappingURL=EnvPersistenceSqlite.d.ts.map

package/dist/esm/persistence/env/EnvPersistenceSqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvPersistenceSqlite.d.ts","sourceRoot":"","sources":["../../../../src/persistence/env/EnvPersistenceSqlite.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAvC,OAAO;WAEa,MAAM,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,OAAO,CAAC,oBAAoB,CAAC;IAInB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9D,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAa1E;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAc3D,KAAK,IAAI,IAAI;CAGrB"}

package/dist/esm/persistence/env/EnvPersistenceSqlite.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvPersistenceSqlite = void 0;
+/**
+ * A persistence implementation that uses SQLite for storage.
+ */
+class EnvPersistenceSqlite {
+    constructor(db) {
+        this.db = db;
+    }
+    static async create(db) {
+        return new EnvPersistenceSqlite(db);
+    }
+    async setEnvironmentDatum(key, value) {
+        if (!key) {
+            throw new Error('Key cannot be empty');
+        }
+        const stmt = this.db.prepare('INSERT OR REPLACE INTO environment_data (name, value) VALUES (?, ?)');
+        stmt.run(key, value);
+    }
+    async deleteEnvironmentDatum(key) {
+        if (!key) {
+            return; // No-op if key is empty
+        }
+        const stmt = this.db.prepare('DELETE FROM environment_data WHERE name = ?');
+        stmt.run(key);
+    }
+    async getEnvironmentDatum(key) {
+        if (!key) {
+            return undefined;
+        }
+        const stmt = this.db.prepare('SELECT value FROM environment_data WHERE name = ?');
+        const row = stmt.get(key);
+        return row ? row.value : undefined;
+    }
+    /**
+     * Get all environment data.
+     */
+    async getEnvironmentData() {
+        const result = {};
+        const stmt = this.db.prepare('SELECT name, value FROM environment_data');
+        const rows = stmt.all();
+        for (const row of rows) {
+            result[row.name] = row.value;
+        }
+        return result;
+    }
+    // Database management
+    close() {
+        this.db.close();
+    }
+}
+exports.EnvPersistenceSqlite = EnvPersistenceSqlite;
+//# sourceMappingURL=EnvPersistenceSqlite.js.map

package/dist/esm/persistence/env/EnvPersistenceSqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvPersistenceSqlite.js","sourceRoot":"","sources":["../../../../src/persistence/env/EnvPersistenceSqlite.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,MAAa,oBAAoB;IAC/B,YAAqC,EAAqB;QAArB,OAAE,GAAF,EAAE,CAAmB;IAAG,CAAC;IAEvD,MAAM,CAAC,KAAK,CAAC,MAAM,CACxB,EAAqB;QAErB,OAAO,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,GAAW,EAAE,KAAa;QACzD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,qEAAqE,CACtE,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvB,CAAC;IAEM,KAAK,CAAC,sBAAsB,CAAC,GAAW;QAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,wBAAwB;QAClC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;QAC5E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,GAAW;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,mDAAmD,CACpD,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAkC,CAAC;QAC3D,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,kBAAkB;QAC7B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAuC,CAAC;QAE7D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QAC/B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sBAAsB;IACf,KAAK;QACV,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AA/DD,oDA+DC"}

package/dist/esm/persistence/env/EnvPersistenceSupabase.d.ts

@@ -0,0 +1,17 @@
+import { SupabaseClient } from '../../clients/SupabaseClient';
+import { EnvPersistence } from './EnvPersistence';
+/**
+ * A persistence implementation that uses Supabase for storage via
+ * its PostgREST endpoints. This implementation assumes that row-Level Security (RLS) is enabled and
+ * enforced by Supabase.
+ */
+export declare class EnvPersistenceSupabase implements EnvPersistence {
+    private readonly supabaseHttpClient;
+    private static readonly ENVIRONMENT_DATA_TABLE;
+    constructor(supabaseHttpClient: SupabaseClient);
+    setEnvironmentDatum(key: string, value: string): Promise<void>;
+    deleteEnvironmentDatum(key: string): Promise<void>;
+    getEnvironmentDatum(key: string): Promise<string | undefined>;
+    getEnvironmentData(): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=EnvPersistenceSupabase.d.ts.map