composable.env 0.1.0

package/dist/src/contracts.js

@@ -0,0 +1,154 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export class ContractManager {
+    constructor(configDir) {
+        this.contracts = new Map();
+        this.contractsDir = path.join(configDir, 'env', 'contracts');
+    }
+    async initialize() {
+        await this.loadContracts();
+    }
+    async loadContracts() {
+        if (!fs.existsSync(this.contractsDir)) {
+            // No contracts directory — contracts are optional
+            return;
+        }
+        const files = fs
+            .readdirSync(this.contractsDir)
+            .filter(f => f.endsWith('.contract.ts') || f.endsWith('.contract.js'));
+        for (const file of files) {
+            try {
+                const filePath = path.join(this.contractsDir, file);
+                const serviceName = file.replace(/\.contract\.(ts|js)$/, '');
+                const module = await import(filePath);
+                // Expects export named: PascalCaseContract (e.g., ApiContract, DatabaseContract)
+                const pascalCaseName = serviceName
+                    .split('-')
+                    .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+                    .join('');
+                const exportName = `${pascalCaseName}Contract`;
+                const contract = module[exportName];
+                if (contract) {
+                    this.contracts.set(serviceName, contract);
+                }
+                else {
+                    console.warn(`Contract file ${file} does not export '${exportName}'. Skipping.`);
+                }
+            }
+            catch (err) {
+                console.warn(`Failed to load contract ${file}:`, err instanceof Error ? err.message : String(err));
+            }
+        }
+    }
+    /**
+     * Validate that all required variables for a service are present in the pool.
+     */
+    validateContract(serviceName, systemVars) {
+        const contract = this.contracts.get(serviceName);
+        if (!contract) {
+            return {
+                valid: true,
+                missing: [],
+                warnings: [`No contract found for service: ${serviceName}`],
+            };
+        }
+        const missing = [];
+        const warnings = [];
+        for (const [appVar, systemVar] of Object.entries(contract.required)) {
+            const resolved = this.resolveMapping(systemVar, systemVars);
+            if (resolved === undefined) {
+                missing.push(`${systemVar} (needed for ${appVar})`);
+            }
+        }
+        if (contract.secret) {
+            for (const [appVar, systemVar] of Object.entries(contract.secret)) {
+                const resolved = this.resolveMapping(systemVar, systemVars);
+                if (resolved === undefined) {
+                    missing.push(`${systemVar} (needed for secret ${appVar})`);
+                }
+            }
+        }
+        if (contract.optional) {
+            for (const [appVar, systemVar] of Object.entries(contract.optional)) {
+                if (!(systemVar in systemVars) && contract.defaults?.[appVar]) {
+                    warnings.push(`${systemVar} not set, using default for ${appVar}: ${contract.defaults[appVar]}`);
+                }
+            }
+        }
+        return { valid: missing.length === 0, missing, warnings };
+    }
+    /**
+     * Map the resolved variable pool to a service's own variable names.
+     * Supports direct mapping and template strings: "${HOST}:${PORT}"
+     */
+    mapContractVariables(serviceName, systemVars) {
+        const contract = this.contracts.get(serviceName);
+        if (!contract)
+            return {};
+        const serviceVars = {};
+        for (const [appVar, systemVar] of Object.entries(contract.required)) {
+            const value = this.resolveMapping(systemVar, systemVars);
+            if (value !== undefined)
+                serviceVars[appVar] = value;
+        }
+        if (contract.optional) {
+            for (const [appVar, systemVar] of Object.entries(contract.optional)) {
+                const value = this.resolveMapping(systemVar, systemVars);
+                if (value !== undefined) {
+                    serviceVars[appVar] = value;
+                }
+                else if (contract.defaults?.[appVar]) {
+                    serviceVars[appVar] = contract.defaults[appVar];
+                }
+            }
+        }
+        if (contract.secret) {
+            for (const [appVar, systemVar] of Object.entries(contract.secret)) {
+                const value = this.resolveMapping(systemVar, systemVars);
+                if (value !== undefined)
+                    serviceVars[appVar] = value;
+            }
+        }
+        if (contract.defaults) {
+            for (const [appVar, defaultValue] of Object.entries(contract.defaults)) {
+                if (serviceVars[appVar] === undefined) {
+                    serviceVars[appVar] = defaultValue;
+                }
+            }
+        }
+        return serviceVars;
+    }
+    /**
+     * Resolve a single var name, supporting fallback chains: "VAR1 : VAR2 : VAR3"
+     */
+    resolveVariable(varName, systemVars) {
+        if (varName.includes(':')) {
+            const candidates = varName.split(':').map(v => v.trim());
+            for (const candidate of candidates) {
+                const value = candidate in systemVars ? systemVars[candidate] : process.env[candidate];
+                if (value !== undefined && value !== '')
+                    return value;
+            }
+            return undefined;
+        }
+        return varName in systemVars ? systemVars[varName] : process.env[varName];
+    }
+    /**
+     * Resolve a mapping — direct variable name or template "${HOST}:${PORT}"
+     */
+    resolveMapping(mapping, systemVars) {
+        if (/\$\{([^}]+)\}/.test(mapping)) {
+            const resolved = mapping.replace(/\$\{([^}]+)\}/g, (match, varName) => {
+                const value = this.resolveVariable(varName, systemVars);
+                return value !== undefined ? value : match;
+            });
+            // Only return if fully resolved
+            return /\$\{([^}]+)\}/.test(resolved) ? undefined : resolved;
+        }
+        return systemVars[mapping];
+    }
+    getContracts() {
+        return this.contracts;
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/dist/src/contracts.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export { EnvironmentBuilder } from './builder.js';
+export { ContractManager } from './contracts.js';
+export type { ServiceContract } from './contracts.js';
+export type { Components, Profile, EnvironmentConfig, BuildResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+export { EnvironmentBuilder } from './builder.js';
+export { ContractManager } from './contracts.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}