@decaf-ts/integrations 0.1.1

package/lib/cjs/secrets/vault/VaultSecretService.cjs

@@ -0,0 +1,318 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VaultSecretService = exports.VaultKvV2Client = void 0;
+const index_js_1 = require("./../core/index.cjs");
+const index_js_2 = require("./../core/index.cjs");
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+class VaultKvV2Client {
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.token = config.token;
+        this.mountPath = config.mountPath.replace(/^\/+/, "").replace(/\/+$/, "");
+        this.namespace = config.namespace;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}/v1/${path}`;
+        const headers = {
+            "X-Vault-Token": this.token,
+            "Content-Type": "application/json",
+        };
+        if (this.namespace) {
+            headers["X-Vault-Namespace"] = this.namespace;
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorData = (await response
+                .json()
+                .catch(() => ({ errors: [] })));
+            const message = errorData.errors?.join(", ") || response.statusText;
+            const err = new Error(message);
+            err.name = `VaultError`;
+            throw err;
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        const text = await response.text();
+        if (!text) {
+            return undefined;
+        }
+        const data = JSON.parse(text);
+        return data.data;
+    }
+    async read(path) {
+        return this.request("GET", `${this.mountPath}/data/${path}`);
+    }
+    async write(path, data) {
+        await this.request("POST", `${this.mountPath}/data/${path}`, {
+            data,
+        });
+    }
+    async delete(path) {
+        await this.request("DELETE", `${this.mountPath}/data/${path}`);
+    }
+    async list(path) {
+        const result = await this.request("LIST", `${this.mountPath}/metadata/${path}`);
+        return result.keys || [];
+    }
+    async metadata(path) {
+        return this.request("GET", `${this.mountPath}/metadata/${path}`);
+    }
+}
+exports.VaultKvV2Client = VaultKvV2Client;
+class VaultSecretService extends core_1.ClientBasedService {
+    constructor() {
+        super(...arguments);
+        this.provider = "hashicorp-vault";
+    }
+    async initialize(...args) {
+        const { ctxArgs } = (await this.logCtx(args, "initialize", true)).for(this.initialize);
+        const config = ctxArgs[0];
+        const client = new VaultKvV2Client({
+            baseUrl: config.address,
+            token: config.token,
+            mountPath: config.path,
+            namespace: config.namespace,
+        });
+        this._config = config;
+        this._client = client;
+        return { config, client };
+    }
+    async store(name, value, options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "store", true)).for(this.store);
+        log.verbose(`Storing secret ${name}`);
+        try {
+            (0, index_js_1.validateSecretName)(name);
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+        const normalizedName = (0, index_js_1.normalizeSecretName)(name);
+        const serialized = (0, index_js_2.serializeSecretPayload)(value);
+        try {
+            await this.client.write(normalizedName, {
+                value: serialized.value,
+                encoding: serialized.encoding,
+                contentType: options.contentType,
+                tags: options.tags,
+            });
+            return {
+                provider: this.provider,
+                name: normalizedName,
+                version: options.version,
+            };
+        }
+        catch (error) {
+            if (error?.name?.toLowerCase().includes("already") ||
+                error?.message?.toLowerCase()?.includes("already")) {
+                throw new db_decorators_1.ConflictError(`Secret "${normalizedName}" already exists`);
+            }
+            throw this.parseError(error);
+        }
+    }
+    async retrieve(nameOrRef, ...args) {
+        const { log } = (await this.logCtx(args, "retrieve", true)).for(this.retrieve);
+        const nameStr = typeof nameOrRef === "string" ? nameOrRef : nameOrRef.name;
+        log.verbose(`Retrieving secret ${nameStr}`);
+        let name;
+        if (typeof nameOrRef === "string") {
+            name = nameOrRef;
+        }
+        else {
+            name = nameOrRef.name;
+        }
+        try {
+            (0, index_js_1.validateSecretName)(name);
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+        const normalizedName = (0, index_js_1.normalizeSecretName)(name);
+        try {
+            const response = await this.client.read(normalizedName);
+            if (!response?.data?.value) {
+                throw new db_decorators_1.NotFoundError(`Secret "${normalizedName}" has no value`);
+            }
+            const payload = {
+                encoding: response.data.encoding ?? "utf8",
+                value: response.data.value,
+            };
+            return (0, index_js_2.deserializeSecretPayload)(payload);
+        }
+        catch (error) {
+            if (error?.name?.toLowerCase().includes("not found") ||
+                error?.message?.toLowerCase()?.includes("not found")) {
+                throw new db_decorators_1.NotFoundError(`Secret "${normalizedName}" not found`);
+            }
+            throw this.parseError(error);
+        }
+    }
+    async delete(nameOrRef, ...args) {
+        const { log } = (await this.logCtx(args, "delete", true)).for(this.delete);
+        const nameStr = typeof nameOrRef === "string" ? nameOrRef : nameOrRef.name;
+        log.verbose(`Deleting secret ${nameStr}`);
+        let name;
+        if (typeof nameOrRef === "string") {
+            name = nameOrRef;
+        }
+        else {
+            name = nameOrRef.name;
+        }
+        try {
+            (0, index_js_1.validateSecretName)(name);
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+        const normalizedName = (0, index_js_1.normalizeSecretName)(name);
+        try {
+            await this.client.delete(normalizedName);
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+    }
+    async exists(nameOrRef, ...args) {
+        const { log } = (await this.logCtx(args, "exists", true)).for(this.exists);
+        const nameStr = typeof nameOrRef === "string" ? nameOrRef : nameOrRef.name;
+        log.verbose(`Checking if secret ${nameStr} exists`);
+        let name;
+        if (typeof nameOrRef === "string") {
+            name = nameOrRef;
+        }
+        else {
+            name = nameOrRef.name;
+        }
+        try {
+            (0, index_js_1.validateSecretName)(name);
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+        const normalizedName = (0, index_js_1.normalizeSecretName)(name);
+        try {
+            await this.client.read(normalizedName);
+            return true;
+        }
+        catch (error) {
+            if (error?.name?.toLowerCase().includes("not found") ||
+                error?.message?.toLowerCase()?.includes("not found")) {
+                return false;
+            }
+            throw this.parseError(error);
+        }
+    }
+    async list(options = {}, ...args) {
+        const { log } = (await this.logCtx(args, "list", true)).for(this.list);
+        log.verbose("Listing secrets");
+        const result = [];
+        try {
+            const keys = await this.client.list("");
+            for (const key of keys) {
+                if (options.limit && result.length >= options.limit) {
+                    break;
+                }
+                const meta = await this.client.metadata(key);
+                if (meta) {
+                    result.push({
+                        provider: this.provider,
+                        name: key,
+                        createdAt: meta.created_time
+                            ? new Date(meta.created_time)
+                            : undefined,
+                        updatedAt: meta.updated_time
+                            ? new Date(meta.updated_time)
+                            : undefined,
+                        enabled: true,
+                        tags: meta.custom_metadata ?? undefined,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+        return result;
+    }
+    async metadata(nameOrRef, ...args) {
+        const { log } = (await this.logCtx(args, "metadata", true)).for(this.metadata);
+        const nameStr = typeof nameOrRef === "string" ? nameOrRef : nameOrRef.name;
+        log.verbose(`Getting metadata for secret ${nameStr}`);
+        let name;
+        if (typeof nameOrRef === "string") {
+            name = nameOrRef;
+        }
+        else {
+            name = nameOrRef.name;
+        }
+        try {
+            (0, index_js_1.validateSecretName)(name);
+        }
+        catch (error) {
+            throw this.parseError(error);
+        }
+        const normalizedName = (0, index_js_1.normalizeSecretName)(name);
+        try {
+            const meta = await this.client.metadata(normalizedName);
+            if (!meta) {
+                return undefined;
+            }
+            const result = {
+                provider: this.provider,
+                name: normalizedName,
+                createdAt: meta.created_time ? new Date(meta.created_time) : undefined,
+                updatedAt: meta.updated_time ? new Date(meta.updated_time) : undefined,
+                enabled: true,
+                tags: meta.custom_metadata ?? undefined,
+            };
+            return result;
+        }
+        catch (error) {
+            if (error?.name?.toLowerCase().includes("not found") ||
+                error?.message?.toLowerCase()?.includes("not found")) {
+                return undefined;
+            }
+            throw this.parseError(error);
+        }
+    }
+    parseError(error) {
+        const err = error;
+        const message = err.message || err.name || "Unknown error";
+        const lowerMessage = message.toLowerCase();
+        if (lowerMessage.includes("not found") || lowerMessage.includes("404")) {
+            return new db_decorators_1.NotFoundError(message);
+        }
+        if (lowerMessage.includes("already exists") ||
+            lowerMessage.includes("conflict") ||
+            lowerMessage.includes("409")) {
+            return new db_decorators_1.ConflictError(message);
+        }
+        if (lowerMessage.includes("disabled") || lowerMessage.includes("403")) {
+            return new db_decorators_1.NotFoundError(message);
+        }
+        if (lowerMessage.includes("unauthorized") || lowerMessage.includes("401")) {
+            return new db_decorators_1.NotFoundError(message);
+        }
+        if (lowerMessage.includes("permission") || lowerMessage.includes("403")) {
+            return new db_decorators_1.NotFoundError(message);
+        }
+        if (lowerMessage.includes("rate limit") || lowerMessage.includes("429")) {
+            return new db_decorators_1.BadRequestError(message);
+        }
+        if (lowerMessage.includes("provider") ||
+            lowerMessage.includes("unavailable") ||
+            lowerMessage.includes("connection") ||
+            lowerMessage.includes("timeout")) {
+            return new db_decorators_1.InternalError(message);
+        }
+        return new db_decorators_1.InternalError(message);
+    }
+}
+exports.VaultSecretService = VaultSecretService;
+//# sourceMappingURL=VaultSecretService.js.map
+//# sourceMappingURL=VaultSecretService.js.map

package/lib/cjs/secrets/vault/VaultSecretService.cjs.map

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

package/lib/cjs/secrets/vault/VaultSecretServiceConfig.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=VaultSecretServiceConfig.js.map
+//# sourceMappingURL=VaultSecretServiceConfig.js.map

package/lib/cjs/secrets/vault/VaultSecretServiceConfig.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"VaultSecretServiceConfig.js","sourceRoot":"","sources":["VaultSecretServiceConfig.js"],"names":[],"mappings":";;AACA,oDAAoD"}

package/lib/cjs/secrets/vault/index.cjs

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/secrets/vault
+ * @summary HashiCorp Vault secret service exports.
+ * @description Re-exports the Vault KV v2 service and its configuration.
+ */
+__exportStar(require("./VaultSecretService.cjs"), exports);
+__exportStar(require("./VaultSecretServiceConfig.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/lib/cjs/secrets/vault/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,0DAAwC;AACxC,gEAA8C;AAC9C,iCAAiC"}

package/lib/cjs/utils.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execWithLogging = execWithLogging;
+/**
+ * @module integrations/utils
+ * @summary Shared integration utilities.
+ * @description Utility helpers used across the integrations package.
+ */
+const child_process_1 = require("child_process");
+const logging_1 = require("@decaf-ts/logging");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+async function execWithLogging(command, options, log, level = logging_1.LogLevel.info) {
+    log.debug(`Executing: ${command}`);
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.exec)(command, options);
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (data) => {
+            stdout += data;
+            log[level](data.trim());
+        });
+        child.stderr?.on("data", (data) => {
+            stderr += data;
+            log.error(data.trim());
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                log.silly(`Command completed successfully`);
+                resolve({ stdout, stderr });
+            }
+            else {
+                log.critical(`Command failed with code ${code}`, stderr);
+                reject(new db_decorators_1.InternalError(`Command failed with code ${code}: ${stderr}`));
+            }
+        });
+        child.on("error", (err) => {
+            log.critical(`Command execution error`, err);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/lib/cjs/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["utils.js"],"names":[],"mappings":";;AAQA,0CA6BC;AArCD;;;;GAIG;AACH,iDAAqC;AACrC,+CAA6C;AAC7C,2DAAwD;AACjD,KAAK,UAAU,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,kBAAQ,CAAC,IAAI;IAC9E,GAAG,CAAC,KAAK,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,IAAA,oBAAI,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,IAAI,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,IAAI,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACvB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;gBAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAChC,CAAC;iBACI,CAAC;gBACF,GAAG,CAAC,QAAQ,CAAC,4BAA4B,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,6BAAa,CAAC,4BAA4B,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;YAC7E,CAAC;QACL,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACtB,GAAG,CAAC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;AACD,iCAAiC"}

package/lib/esm/docker/DockerComposeService.js

@@ -0,0 +1,140 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { description } from "@decaf-ts/decoration";
+import { ClientBasedService, PersistenceKeys, } from "@decaf-ts/core";
+import path from "path";
+import fs from "fs";
+import { execWithLogging } from "./../utils.js";
+import { InternalError } from "@decaf-ts/db-decorators";
+let DockerComposeService = class DockerComposeService extends ClientBasedService {
+    constructor() {
+        super();
+    }
+    async initialize(...args) {
+        const { log, ctxArgs } = (await this.logCtx(args, PersistenceKeys.INITIALIZATION, true)).for(this.initialize);
+        const config = ctxArgs[0];
+        if (!config.composeFile) {
+            throw new InternalError("DockerComposeService requires a composeFile path");
+        }
+        // Validate compose file exists
+        if (!fs.existsSync(config.composeFile)) {
+            throw new InternalError(`Docker compose file not found: ${config.composeFile}`);
+        }
+        log.info(`Initialized with compose file: ${config.composeFile}`);
+        this._config = config; // double assignment but allows tests to be cleaner
+        return { config, client: undefined };
+    }
+    /**
+     * Get the working directory for docker compose commands
+     */
+    get workingDir() {
+        return this.config.workingDir || path.dirname(this.config.composeFile);
+    }
+    /**
+     * Get the basename of the compose file
+     */
+    get composeFileName() {
+        return path.basename(this.config.composeFile);
+    }
+    /**
+     * Start Docker Compose services
+     */
+    async up(detached = true, ...args) {
+        const { log } = await this.logCtx(args, this.up, true);
+        const command = `docker compose -f ${this.composeFileName} up ${detached ? "-d" : ""}`;
+        await execWithLogging(command, { cwd: this.workingDir }, log);
+        log.info(`Docker compose services started`);
+    }
+    /**
+     * Stop Docker Compose services
+     */
+    async down(...args) {
+        const { log } = await this.logCtx(args, this.down, true);
+        const command = `docker compose -f ${this.composeFileName} down --volumes`;
+        await execWithLogging(command, { cwd: this.workingDir }, log);
+        log.info(`Docker compose services stopped`);
+    }
+    /**
+     * Restart Docker Compose services
+     */
+    async restart(...args) {
+        const { log } = await this.logCtx(args, this.restart, true);
+        const command = `docker compose -f ${this.composeFileName} restart`;
+        await execWithLogging(command, { cwd: this.workingDir }, log);
+        log.info(`Docker compose services restarted`);
+    }
+    /**
+     * Wait for service health check
+     */
+    async waitForHealth(url, options = {}, ...args) {
+        const { log } = await this.logCtx(args, this.waitForHealth, true);
+        const { maxAttempts = 60, interval = 2000 } = options;
+        log.info(`Waiting for health check at ${url}`);
+        for (let i = 0; i < maxAttempts; i++) {
+            try {
+                const response = await fetch(url);
+                if (response.ok) {
+                    log.info(`Health check passed after ${i + 1} attempts`);
+                    return true;
+                }
+            }
+            catch (error) {
+                log.silly(`Health check attempt ${i + 1} failed`, error);
+            }
+            await new Promise((resolve) => setTimeout(resolve, interval));
+        }
+        log.error(`Health check failed for ${url} after ${maxAttempts} attempts`);
+        throw new InternalError(`Health check failed for ${url} after ${maxAttempts} attempts`);
+    }
+    /**
+     * Execute a command in a specific container
+     */
+    async execInContainer(containerName, command, ...args) {
+        const { log } = await this.logCtx(args, this.execInContainer, true);
+        const fullCommand = `docker compose -f ${this.composeFileName} exec ${containerName} ${command}`;
+        const { stdout } = await execWithLogging(fullCommand, { cwd: this.workingDir }, log);
+        log.info(`Executed command in container ${containerName}`);
+        return stdout;
+    }
+    /**
+     * Get container logs
+     */
+    async getLogs(containerName, tail = 100, ...args) {
+        const { log } = await this.logCtx(args, this.getLogs, true);
+        const containerArg = containerName ? containerName : "";
+        const command = `docker compose -f ${this.composeFileName} logs ${containerArg} --tail=${tail}`;
+        const { stdout } = await execWithLogging(command, { cwd: this.workingDir }, log);
+        log.info(`Retrieved logs for ${containerName || "all containers"}`);
+        return stdout;
+    }
+    /**
+     * Check if a container is running
+     */
+    async isRunning(containerName, ...args) {
+        const { log } = await this.logCtx(args, this.isRunning, true);
+        try {
+            const command = `docker compose -f ${this.composeFileName} ps ${containerName} --format "{{.Status}}"`;
+            const { stdout } = await execWithLogging(command, { cwd: this.workingDir }, log);
+            const isRunning = stdout.trim().toLowerCase().includes("running");
+            log.silly(`Container ${containerName} is ${isRunning ? "running" : "not running"}`);
+            return isRunning;
+        }
+        catch {
+            log.silly(`Container ${containerName} is not running`);
+            return false;
+        }
+    }
+};
+DockerComposeService = __decorate([
+    description("Docker Compose service for managing containerized environments"),
+    __metadata("design:paramtypes", [])
+], DockerComposeService);
+export { DockerComposeService };
+//# sourceMappingURL=DockerComposeService.js.map

package/lib/esm/docker/DockerComposeService.js.map

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

package/lib/esm/docker/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/docker
+ * @summary Docker Compose service helpers.
+ * @description Re-exports the Docker Compose orchestration service for local containerized environments.
+ */
+export * from "./DockerComposeService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/docker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/docker/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,0CAAuC"}

package/lib/esm/index.js

@@ -0,0 +1,11 @@
+/**
+ * @module integrations
+ * @summary Package entry point for shared integration helpers.
+ * @description Exposes the package utilities and build-time version metadata for `@decaf-ts/integrations`.
+ */
+export * from "./utils.js";
+export const VERSION = "0.1.0";
+export const COMMIT = "9134d75";
+export const FULL_VERSION = "0.1.0-9134d75";
+export const PACKAGE_NAME = "@decaf-ts/integrations";
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,2BAAwB;AAExB,MAAM,CAAC,MAAM,OAAO,GAAW,aAAa,CAAC;AAE7C,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAW,aAAa,CAAC"}

package/lib/esm/keycloak/index.js

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./services/index.js";
+/**
+ * @summary Keycloak integrations.
+ * @description Helpers for provisioning and managing Keycloak tenants.
+ * @namespace keycloak
+ * @memberOf module:integrations
+ */
+//# sourceMappingURL=index.js.map

package/lib/esm/keycloak/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/keycloak/index.ts"],"names":[],"mappings":"AAAA,2BAAwB;AACxB,oCAA2B;AAE3B;;;;;GAKG"}