@decaf-ts/integrations 0.8.0 → 0.9.0

package/lib/cjs/blob/s3/S3CompatibleBlobStoreService.cjs

@@ -0,0 +1,327 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3CompatibleBlobStoreService = void 0;
+/**
+ * @module integrations/blob/s3/base-service
+ * @summary S3-compatible blob store base implementation.
+ * @description Shared CRUD implementation backed by the AWS SDK v3 S3Client, used by
+ * the S3, MinIO, and Cloudflare R2 provider services. Deliberately left undecorated:
+ * `@service(...)` on a class whose parent is itself `@service(...)`-decorated breaks
+ * that subclass's inherited field initializers (e.g. `Context` ends up `undefined`).
+ * Each concrete provider below extends this class directly and carries its own
+ * `@service("blob-<provider>")` decorator instead of stacking on top of one another.
+ */
+const client_s3_1 = require("@aws-sdk/client-s3");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const BlobStoreService_js_1 = require("./../core/BlobStoreService.cjs");
+const BlobValue_js_1 = require("./../core/BlobValue.cjs");
+class S3CompatibleBlobStoreService extends BlobStoreService_js_1.BlobStoreService {
+    async initialize(...args) {
+        const { log } = (await this.logCtx(args, "initialize", true)).for(this.initialize);
+        const config = this.getConfigFromArgs(...args);
+        if (!config.bucket) {
+            throw new db_decorators_1.InternalError("S3BlobStoreService requires a bucket");
+        }
+        const clientConfig = {
+            region: config.region,
+            endpoint: config.endpoint,
+            forcePathStyle: config.forcePathStyle,
+            maxAttempts: config.maxRetries,
+        };
+        if (config.credentials) {
+            clientConfig.credentials = {
+                accessKeyId: config.credentials.accessKeyId,
+                secretAccessKey: config.credentials.secretAccessKey,
+                sessionToken: config.credentials.sessionToken,
+            };
+        }
+        const client = new client_s3_1.S3Client(clientConfig);
+        this._config = config;
+        this._client = client;
+        if (config.autoCreateBucket) {
+            await this.ensureBucket(log);
+        }
+        log.verbose(`Initialized S3 blob store ${config.sourceId}`);
+        return { config, client };
+    }
+    async put(key, value, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "put", true)).for(this.put);
+        log.verbose(`Putting blob ${key}`);
+        const objectKey = this.physicalKey(key);
+        if (options.ifNotExists) {
+            if (await this.has(key)) {
+                throw new db_decorators_1.ConflictError(`Blob already exists: ${key}`);
+            }
+        }
+        const body = await (0, BlobValue_js_1.collectToBuffer)(value);
+        if (options.expectedSha256) {
+            const sha256 = await (0, BlobValue_js_1.computeSha256)(body);
+            if (options.expectedSha256 !== sha256) {
+                throw new db_decorators_1.ValidationError(`Checksum mismatch for ${key}`);
+            }
+        }
+        try {
+            const response = await this.client.send(new client_s3_1.PutObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+                Body: body,
+                ContentType: options.contentType,
+                Metadata: options.metadata,
+            }));
+            const metadata = {
+                contentType: options.contentType,
+                contentLength: body.length,
+                etag: response.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+                custom: options.metadata,
+            };
+            return {
+                key,
+                uri: this.uri(key, "s3", response.VersionId ? `versionId=${response.VersionId}` : undefined),
+                provider: this.provider,
+                sourceId: this.sourceId,
+                metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async get(key, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "get", true)).for(this.get);
+        log.verbose(`Getting blob ${key}`);
+        const objectKey = this.physicalKey(key);
+        try {
+            const response = await this.client.send(new client_s3_1.GetObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+                Range: options.range
+                    ? `bytes=${options.range.start}-${options.range.end ?? ""}`
+                    : undefined,
+                VersionId: options.versionId,
+            }));
+            const body = response.Body;
+            const metadata = {
+                contentType: response.ContentType,
+                contentLength: response.ContentLength,
+                etag: response.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+            };
+            return {
+                key,
+                value: (0, BlobValue_js_1.toAsyncIterable)(body),
+                uri: this.uri(key, "s3", response.VersionId ? `versionId=${response.VersionId}` : undefined),
+                provider: this.provider,
+                sourceId: this.sourceId,
+                metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async has(key, ...args) {
+        const { log } = (await this.logCtx(args, "has", true)).for(this.has);
+        log.verbose(`Checking blob ${key}`);
+        try {
+            await this.stat(key);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof db_decorators_1.NotFoundError) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async stat(key, ...args) {
+        const { log } = (await this.logCtx(args, "stat", true)).for(this.stat);
+        log.verbose(`Statting blob ${key}`);
+        const objectKey = this.physicalKey(key);
+        try {
+            const response = await this.client.send(new client_s3_1.HeadObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+            }));
+            return {
+                contentType: response.ContentType,
+                contentLength: response.ContentLength,
+                etag: response.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+                custom: response.Metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async delete(key, ...args) {
+        const { log } = (await this.logCtx(args, "delete", true)).for(this.delete);
+        log.verbose(`Deleting blob ${key}`);
+        const objectKey = this.physicalKey(key);
+        try {
+            await this.client.send(new client_s3_1.DeleteObjectCommand({
+                Bucket: this.config.bucket,
+                Key: objectKey,
+            }));
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async copy(fromKey, toKey, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "copy", true)).for(this.copy);
+        log.verbose(`Copying blob ${fromKey} to ${toKey}`);
+        const from = this.physicalKey(fromKey);
+        const to = this.physicalKey(toKey);
+        try {
+            const response = await this.client.send(new client_s3_1.CopyObjectCommand({
+                Bucket: this.config.bucket,
+                CopySource: `${this.config.bucket}/${from}`,
+                Key: to,
+                ContentType: options.contentType,
+                Metadata: options.metadata,
+            }));
+            const metadata = {
+                contentType: options.contentType,
+                etag: response.CopyObjectResult?.ETag?.replace(/"/g, ""),
+                versionId: response.VersionId,
+                custom: options.metadata,
+            };
+            return {
+                key: toKey,
+                uri: this.uri(toKey, "s3"),
+                provider: this.provider,
+                sourceId: this.sourceId,
+                metadata,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async list(options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "list", true)).for(this.list);
+        log.verbose("Listing blobs");
+        const prefix = this.physicalKey(options.prefix ?? "");
+        try {
+            const response = await this.client.send(new client_s3_1.ListObjectsV2Command({
+                Bucket: this.config.bucket,
+                Prefix: prefix || undefined,
+                MaxKeys: options.limit,
+                ContinuationToken: options.cursor,
+            }));
+            const items = (response.Contents ?? []).map((obj) => ({
+                key: obj.Key,
+                metadata: {
+                    contentLength: obj.Size,
+                    etag: obj.ETag?.replace(/"/g, ""),
+                },
+            }));
+            return {
+                items,
+                cursor: response.IsTruncated ? response.NextContinuationToken : undefined,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async url(key, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "url", true)).for(this.url);
+        log.verbose(`Building url for blob ${key}`);
+        const objectKey = this.physicalKey(key);
+        const operation = options.operation ?? "get";
+        const expiresIn = options.expiresInSeconds ?? 300;
+        try {
+            const command = operation === "put"
+                ? new client_s3_1.PutObjectCommand({
+                    Bucket: this.config.bucket,
+                    Key: objectKey,
+                    ContentType: options.contentType,
+                    Metadata: options.metadata,
+                })
+                : new client_s3_1.GetObjectCommand({
+                    Bucket: this.config.bucket,
+                    Key: objectKey,
+                });
+            const url = await (0, s3_request_presigner_1.getSignedUrl)(this.client, command, { expiresIn });
+            return {
+                url,
+                method: operation === "put" ? "PUT" : "GET",
+                expiresAt: new Date(Date.now() + expiresIn * 1000),
+                headers: options.contentType
+                    ? { "Content-Type": options.contentType }
+                    : undefined,
+            };
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    parseError(error) {
+        const err = error;
+        if (err instanceof db_decorators_1.NotFoundError ||
+            err instanceof db_decorators_1.ConflictError ||
+            err instanceof core_1.AuthorizationError ||
+            err instanceof core_1.ForbiddenError ||
+            err instanceof db_decorators_1.ValidationError ||
+            err instanceof core_1.ConnectionError ||
+            err instanceof core_1.UnsupportedError ||
+            err instanceof db_decorators_1.InternalError) {
+            return err;
+        }
+        const message = err.message || err.name || "Unknown error";
+        const lower = message.toLowerCase();
+        const name = err.name || "";
+        const statusCode = err?.$metadata?.httpStatusCode;
+        if (name === "NotFound" ||
+            name === "NoSuchKey" ||
+            statusCode === 404 ||
+            lower.includes("not found") ||
+            lower.includes("nosuchkey")) {
+            return new db_decorators_1.NotFoundError(err);
+        }
+        if (name === "BucketAlreadyExists" ||
+            name === "BucketAlreadyOwnedByYou" ||
+            statusCode === 409 ||
+            lower.includes("already exists") ||
+            lower.includes("conflict")) {
+            return new db_decorators_1.ConflictError(err);
+        }
+        if (statusCode === 401 || lower.includes("unauthorized")) {
+            return new core_1.AuthorizationError(err);
+        }
+        if (statusCode === 403 || lower.includes("permission") || lower.includes("forbidden")) {
+            return new core_1.ForbiddenError(err);
+        }
+        if (statusCode === 429 || lower.includes("rate limit")) {
+            return new db_decorators_1.ConflictError(err);
+        }
+        if (statusCode === 503 || lower.includes("timeout") || lower.includes("unavailable") || lower.includes("connection")) {
+            return new core_1.ConnectionError(err);
+        }
+        return new db_decorators_1.InternalError(err);
+    }
+    async ensureBucket(log) {
+        try {
+            await this.client.send(new client_s3_1.CreateBucketCommand({ Bucket: this.config.bucket }));
+            log.verbose(`Created bucket ${this.config.bucket}`);
+        }
+        catch (error) {
+            const name = error?.name || "";
+            if (name === "BucketAlreadyExists" ||
+                name === "BucketAlreadyOwnedByYou" ||
+                error?.$metadata?.httpStatusCode === 409) {
+                log.verbose(`Bucket ${this.config.bucket} already exists`);
+                return;
+            }
+            throw this.parseError(error);
+        }
+    }
+}
+exports.S3CompatibleBlobStoreService = S3CompatibleBlobStoreService;
+//# sourceMappingURL=S3CompatibleBlobStoreService.js.map
+//# sourceMappingURL=S3CompatibleBlobStoreService.cjs.map

package/lib/cjs/blob/s3/S3CompatibleBlobStoreService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob/s3/S3CompatibleBlobStoreService.cjs","sourceRoot":"","sources":["blob/s3/S3CompatibleBlobStoreService.js"],"names":[],"mappings":"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"}

package/lib/cjs/blob/s3/index.cjs

@@ -19,8 +19,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @summary S3-compatible blob store exports.
  * @description Re-exports the S3, MinIO, and R2 blob store services.
  */
+__exportStar(require("./S3CompatibleBlobStoreService.cjs"), exports);
 __exportStar(require("./S3BlobStoreService.cjs"), exports);
+__exportStar(require("./S3BlobEnvironment.cjs"), exports);
 __exportStar(require("./MinioBlobStoreService.cjs"), exports);
+__exportStar(require("./MinioBlobEnvironment.cjs"), exports);
 __exportStar(require("./R2BlobStoreService.cjs"), exports);
+__exportStar(require("./R2BlobEnvironment.cjs"), exports);
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.cjs.map

package/lib/cjs/blob/s3/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"blob/s3/index.cjs","sourceRoot":"","sources":["blob/s3/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,0DAAwC;AACxC,6DAA2C;AAC3C,0DAAwC;AACxC,iCAAiC"}
+{"version":3,"file":"blob/s3/index.cjs","sourceRoot":"","sources":["blob/s3/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,oEAAkD;AAClD,0DAAwC;AACxC,yDAAuC;AACvC,6DAA2C;AAC3C,4DAA0C;AAC1C,0DAAwC;AACxC,yDAAuC;AACvC,iCAAiC"}

package/lib/cjs/graph/engine/catalog/GraphBuiltInRegistrations.cjs

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtInGraphNodeRegistrations = builtInGraphNodeRegistrations;
+exports.registerBuiltInGraphNodes = registerBuiltInGraphNodes;
+const index_js_1 = require("./../execution/index.cjs");
+const index_js_2 = require("./../loops/index.cjs");
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
+const GraphNodeRegistration_js_1 = require("./GraphNodeRegistration.cjs");
+function executorOf(fn) {
+    return { execute: fn };
+}
+function forwardOutput(outputKey, inputKey = "value") {
+    return executorOf((request) => ({
+        [outputKey]: request.inputs[inputKey] ?? request.inputs,
+    }));
+}
+function triggerPayloadExecutor() {
+    return executorOf((request) => ({ payload: request.inputs["payload"] ?? null }));
+}
+function defaultFlowExecutors() {
+    return {
+        "core.flow.map": executorOf((request) => ({
+            result: { mapped: request.inputs["value"] ?? request.inputs },
+        })),
+        "core.flow.delay": forwardOutput("valueOut"),
+        "core.flow.return": forwardOutput("result"),
+        "core.flow.merge": forwardOutput("merged", "values"),
+        "core.flow.if": forwardOutput("then"),
+        "core.flow.parallel": executorOf((request) => ({
+            branches: [request.inputs["value"] ?? request.inputs],
+        })),
+        "core.flow.errorBoundary": forwardOutput("result"),
+        "core.flow.humanApproval": forwardOutput("approved"),
+        "core.flow.break": new index_js_1.BreakGraphNodeExecutor(),
+        "core.agent": executorOf((request) => ({
+            response: `[Agent response] ${String(request.inputs["prompt"] ?? "")}`,
+            actions: [],
+        })),
+    };
+}
+function defaultTriggerExecutors() {
+    return {
+        "core.trigger.manual": triggerPayloadExecutor(),
+        "core.trigger.webhook": triggerPayloadExecutor(),
+        "core.trigger.schedule": triggerPayloadExecutor(),
+        "core.trigger.event": triggerPayloadExecutor(),
+        "core.trigger.form": triggerPayloadExecutor(),
+        "core.trigger.chat": executorOf((request) => ({
+            message: request.inputs["message"] ?? null,
+            sessionId: request.inputs["sessionId"] ?? null,
+            userId: request.inputs["userId"] ?? null,
+        })),
+    };
+}
+function engineBoundExecutors(engine) {
+    return {
+        "core.flow.code": new index_js_1.CodeGraphNodeExecutor(engine),
+        "core.flow.log": new index_js_1.LogGraphNodeExecutor(),
+        "core.utility.log": new index_js_1.LogGraphNodeExecutor(),
+        "core.flow.switch": new index_js_1.SwitchGraphNodeExecutor(engine),
+        "core.loop.foreach": new index_js_2.ForeachGraphNodeExecutor(engine),
+        "core.loop.while": new index_js_2.WhileGraphNodeExecutor(engine),
+        "core.loop.until": new index_js_2.UntilGraphNodeExecutor(engine),
+    };
+}
+/**
+ * Builds the built-in node registrations (DECAF-50 §4.12): every built-in
+ * manifest from {@link GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND} that has a
+ * default executor, paired with that executor as a
+ * {@link GraphNodeRegistration}. Engine-bound executors (loops, switch) are
+ * only included when an `engine` is provided.
+ */
+function builtInGraphNodeRegistrations(engine) {
+    const executors = {
+        ...defaultTriggerExecutors(),
+        ...defaultFlowExecutors(),
+        ...(engine ? engineBoundExecutors(engine) : {}),
+    };
+    const registrations = [];
+    for (const [kind, manifest] of Object.entries(graph_1.GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND)) {
+        const executor = executors[kind];
+        if (!executor)
+            continue;
+        registrations.push((0, GraphNodeRegistration_js_1.defineGraphNode)({ manifest, executor }));
+    }
+    return registrations;
+}
+/**
+ * Registers all built-in graph nodes (see
+ * {@link builtInGraphNodeRegistrations}) into the given
+ * {@link GraphNodeCatalogue} and returns it for chaining.
+ */
+function registerBuiltInGraphNodes(catalogue, engine) {
+    for (const registration of builtInGraphNodeRegistrations(engine)) {
+        catalogue.register(registration);
+    }
+    return catalogue;
+}
+//# sourceMappingURL=GraphBuiltInRegistrations.js.map
+//# sourceMappingURL=GraphBuiltInRegistrations.cjs.map

package/lib/cjs/graph/engine/catalog/GraphBuiltInRegistrations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphBuiltInRegistrations.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphBuiltInRegistrations.js"],"names":[],"mappings":"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"}

package/lib/cjs/graph/engine/catalog/GraphCatalogueErrors.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphNodeMethodNotFoundError = exports.GraphNodeNotFoundError = exports.GraphNodeRegistrationError = void 0;
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+/** Thrown when a node registration or its manifest fails catalogue validation (e.g. invalid ports, unsafe ids, duplicate kinds). */
+class GraphNodeRegistrationError extends db_decorators_1.InternalError {
+    constructor(msg) {
+        super(msg, GraphNodeRegistrationError.name, 500);
+    }
+}
+exports.GraphNodeRegistrationError = GraphNodeRegistrationError;
+/** Thrown when a node kind is not registered in the backend catalogue. */
+class GraphNodeNotFoundError extends db_decorators_1.NotFoundError {
+    constructor(msg) {
+        super(msg);
+        this.name = GraphNodeNotFoundError.name;
+    }
+}
+exports.GraphNodeNotFoundError = GraphNodeNotFoundError;
+/** Thrown when a declared node method is not registered for a node kind. */
+class GraphNodeMethodNotFoundError extends db_decorators_1.NotFoundError {
+    constructor(msg) {
+        super(msg);
+        this.name = GraphNodeMethodNotFoundError.name;
+    }
+}
+exports.GraphNodeMethodNotFoundError = GraphNodeMethodNotFoundError;
+//# sourceMappingURL=GraphCatalogueErrors.js.map
+//# sourceMappingURL=GraphCatalogueErrors.cjs.map

package/lib/cjs/graph/engine/catalog/GraphCatalogueErrors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphCatalogueErrors.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphCatalogueErrors.js"],"names":[],"mappings":";;;AAAA,2DAAuE;AACvE,oIAAoI;AACpI,MAAa,0BAA2B,SAAQ,6BAAa;IACzD,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,EAAE,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;CACJ;AAJD,gEAIC;AACD,0EAA0E;AAC1E,MAAa,sBAAuB,SAAQ,6BAAa;IACrD,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC5C,CAAC;CACJ;AALD,wDAKC;AACD,4EAA4E;AAC5E,MAAa,4BAA6B,SAAQ,6BAAa;IAC3D,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC;IAClD,CAAC;CACJ;AALD,oEAKC;AACD,gDAAgD"}