@decaf-ts/integrations 0.8.0 → 0.9.0

package/lib/esm/blob/s3/S3CompatibleBlobStoreService.js

@@ -0,0 +1,322 @@
+/**
+ * @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.
+ */
+import { CopyObjectCommand, CreateBucketCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client, } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+import { AuthorizationError, ConnectionError, ForbiddenError, UnsupportedError, } from "@decaf-ts/core";
+import { ConflictError, InternalError, NotFoundError, ValidationError, } from "@decaf-ts/db-decorators";
+import { BlobStoreService } from "./../core/BlobStoreService.js";
+import { collectToBuffer, computeSha256, toAsyncIterable } from "./../core/BlobValue.js";
+export class S3CompatibleBlobStoreService extends 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 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 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 ConflictError(`Blob already exists: ${key}`);
+            }
+        }
+        const body = await collectToBuffer(value);
+        if (options.expectedSha256) {
+            const sha256 = await computeSha256(body);
+            if (options.expectedSha256 !== sha256) {
+                throw new ValidationError(`Checksum mismatch for ${key}`);
+            }
+        }
+        try {
+            const response = await this.client.send(new 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 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: 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 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 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 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 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 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 PutObjectCommand({
+                    Bucket: this.config.bucket,
+                    Key: objectKey,
+                    ContentType: options.contentType,
+                    Metadata: options.metadata,
+                })
+                : new GetObjectCommand({
+                    Bucket: this.config.bucket,
+                    Key: objectKey,
+                });
+            const url = await 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 NotFoundError ||
+            err instanceof ConflictError ||
+            err instanceof AuthorizationError ||
+            err instanceof ForbiddenError ||
+            err instanceof ValidationError ||
+            err instanceof ConnectionError ||
+            err instanceof UnsupportedError ||
+            err instanceof 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 NotFoundError(err);
+        }
+        if (name === "BucketAlreadyExists" ||
+            name === "BucketAlreadyOwnedByYou" ||
+            statusCode === 409 ||
+            lower.includes("already exists") ||
+            lower.includes("conflict")) {
+            return new ConflictError(err);
+        }
+        if (statusCode === 401 || lower.includes("unauthorized")) {
+            return new AuthorizationError(err);
+        }
+        if (statusCode === 403 || lower.includes("permission") || lower.includes("forbidden")) {
+            return new ForbiddenError(err);
+        }
+        if (statusCode === 429 || lower.includes("rate limit")) {
+            return new ConflictError(err);
+        }
+        if (statusCode === 503 || lower.includes("timeout") || lower.includes("unavailable") || lower.includes("connection")) {
+            return new ConnectionError(err);
+        }
+        return new InternalError(err);
+    }
+    async ensureBucket(log) {
+        try {
+            await this.client.send(new 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);
+        }
+    }
+}
+//# sourceMappingURL=S3CompatibleBlobStoreService.js.map

package/lib/esm/blob/s3/S3CompatibleBlobStoreService.js.map

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

package/lib/esm/blob/s3/index.js

@@ -3,7 +3,11 @@
  * @summary S3-compatible blob store exports.
  * @description Re-exports the S3, MinIO, and R2 blob store services.
  */
+export * from "./S3CompatibleBlobStoreService.js";
 export * from "./S3BlobStoreService.js";
+export * from "./S3BlobEnvironment.js";
 export * from "./MinioBlobStoreService.js";
+export * from "./MinioBlobEnvironment.js";
 export * from "./R2BlobStoreService.js";
+export * from "./R2BlobEnvironment.js";
 //# sourceMappingURL=index.js.map

package/lib/esm/blob/s3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/blob/s3/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wCAAqC;AACrC,2CAAwC;AACxC,wCAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/blob/s3/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,kDAA+C;AAC/C,wCAAqC;AACrC,uCAAoC;AACpC,2CAAwC;AACxC,0CAAuC;AACvC,wCAAqC;AACrC,uCAAoC"}

package/lib/esm/graph/engine/catalog/GraphBuiltInRegistrations.js

@@ -0,0 +1,95 @@
+import { BreakGraphNodeExecutor, CodeGraphNodeExecutor, LogGraphNodeExecutor, SwitchGraphNodeExecutor, } from "./../execution/index.js";
+import { ForeachGraphNodeExecutor, UntilGraphNodeExecutor, WhileGraphNodeExecutor, } from "./../loops/index.js";
+import { GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND } from "@decaf-ts/ui-decorators/graph";
+import { defineGraphNode, } from "./GraphNodeRegistration.js";
+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 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 CodeGraphNodeExecutor(engine),
+        "core.flow.log": new LogGraphNodeExecutor(),
+        "core.utility.log": new LogGraphNodeExecutor(),
+        "core.flow.switch": new SwitchGraphNodeExecutor(engine),
+        "core.loop.foreach": new ForeachGraphNodeExecutor(engine),
+        "core.loop.while": new WhileGraphNodeExecutor(engine),
+        "core.loop.until": new 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.
+ */
+export function builtInGraphNodeRegistrations(engine) {
+    const executors = {
+        ...defaultTriggerExecutors(),
+        ...defaultFlowExecutors(),
+        ...(engine ? engineBoundExecutors(engine) : {}),
+    };
+    const registrations = [];
+    for (const [kind, manifest] of Object.entries(GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND)) {
+        const executor = executors[kind];
+        if (!executor)
+            continue;
+        registrations.push(defineGraphNode({ manifest, executor }));
+    }
+    return registrations;
+}
+/**
+ * Registers all built-in graph nodes (see
+ * {@link builtInGraphNodeRegistrations}) into the given
+ * {@link GraphNodeCatalogue} and returns it for chaining.
+ */
+export function registerBuiltInGraphNodes(catalogue, engine) {
+    for (const registration of builtInGraphNodeRegistrations(engine)) {
+        catalogue.register(registration);
+    }
+    return catalogue;
+}
+//# sourceMappingURL=GraphBuiltInRegistrations.js.map

package/lib/esm/graph/engine/catalog/GraphBuiltInRegistrations.js.map

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

package/lib/esm/graph/engine/catalog/GraphCatalogueErrors.js

@@ -0,0 +1,22 @@
+import { InternalError, NotFoundError } from "@decaf-ts/db-decorators";
+/** Thrown when a node registration or its manifest fails catalogue validation (e.g. invalid ports, unsafe ids, duplicate kinds). */
+export class GraphNodeRegistrationError extends InternalError {
+    constructor(msg) {
+        super(msg, GraphNodeRegistrationError.name, 500);
+    }
+}
+/** Thrown when a node kind is not registered in the backend catalogue. */
+export class GraphNodeNotFoundError extends NotFoundError {
+    constructor(msg) {
+        super(msg);
+        this.name = GraphNodeNotFoundError.name;
+    }
+}
+/** Thrown when a declared node method is not registered for a node kind. */
+export class GraphNodeMethodNotFoundError extends NotFoundError {
+    constructor(msg) {
+        super(msg);
+        this.name = GraphNodeMethodNotFoundError.name;
+    }
+}
+//# sourceMappingURL=GraphCatalogueErrors.js.map

package/lib/esm/graph/engine/catalog/GraphCatalogueErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphCatalogueErrors.js","sourceRoot":"","sources":["../../../../../src/graph/engine/catalog/GraphCatalogueErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEvE,oIAAoI;AACpI,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAY,GAA6B;QACvC,KAAK,CAAC,GAAG,EAAE,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,YAAY,GAA6B;QACvC,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC1C,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,OAAO,4BAA6B,SAAQ,aAAa;IAC7D,YAAY,GAA6B;QACvC,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC;IAChD,CAAC;CACF"}