@konker.dev/config-o-tron 0.0.1

package/dist/providers/MockProvider.test.js

@@ -0,0 +1,166 @@
+/**
+ * MockProvider Tests
+ */
+import * as Effect from 'effect/Effect';
+import { beforeEach, describe, expect, it } from 'vitest';
+import { createMockProvider, mockProvider } from './MockProvider.js';
+describe('MockProvider', () => {
+    const ctx = {
+        prefix: '/config-o-tron',
+        service: 'test-service',
+        env: 'dev',
+    };
+    describe('mockProvider (default instance)', () => {
+        it('should have expected capabilities', () => {
+            expect(mockProvider.capabilities.secureWrite).toBe(true);
+            expect(mockProvider.capabilities.encryptionVerification).toBe(true);
+        });
+        it('should have name mock', () => {
+            expect(mockProvider.name).toBe('mock');
+        });
+    });
+    describe('createMockProvider', () => {
+        it('should create provider with empty storage', async () => {
+            const provider = createMockProvider();
+            const result = await Effect.runPromise(provider.fetch(ctx));
+            expect(result).toEqual({});
+        });
+        it('should create provider with initial data', async () => {
+            const storageKey = `${ctx.prefix}/${ctx.env}/${ctx.service}`;
+            const provider = createMockProvider({
+                [storageKey]: {
+                    'database.host': 'localhost',
+                    'database.port': '5432',
+                },
+            });
+            const result = await Effect.runPromise(provider.fetch(ctx));
+            expect(result).toEqual({
+                'database.host': 'localhost',
+                'database.port': '5432',
+            });
+        });
+        it('should expose storage for inspection', () => {
+            const provider = createMockProvider();
+            expect(provider.storage).toBeDefined();
+            expect(provider.storage.size).toBe(0);
+        });
+    });
+    describe('fetch', () => {
+        let provider;
+        beforeEach(() => {
+            provider = createMockProvider();
+        });
+        it('should fetch empty object when no data', async () => {
+            const result = await Effect.runPromise(provider.fetch(ctx));
+            expect(result).toEqual({});
+        });
+        it('should fetch service-specific data', async () => {
+            const ctx1 = { ...ctx, service: 'service-1' };
+            const ctx2 = { ...ctx, service: 'service-2' };
+            await Effect.runPromise(provider.upsert(ctx1, 'key1', 'value1'));
+            await Effect.runPromise(provider.upsert(ctx2, 'key2', 'value2'));
+            const result1 = await Effect.runPromise(provider.fetch(ctx1));
+            const result2 = await Effect.runPromise(provider.fetch(ctx2));
+            expect(result1).toEqual({ key1: 'value1' });
+            expect(result2).toEqual({ key2: 'value2' });
+        });
+        it('should fetch env-specific data', async () => {
+            const devCtx = { ...ctx, env: 'dev' };
+            const prodCtx = { ...ctx, env: 'prod' };
+            await Effect.runPromise(provider.upsert(devCtx, 'url', 'http://dev.local'));
+            await Effect.runPromise(provider.upsert(prodCtx, 'url', 'https://prod.example.com'));
+            const devResult = await Effect.runPromise(provider.fetch(devCtx));
+            const prodResult = await Effect.runPromise(provider.fetch(prodCtx));
+            expect(devResult).toEqual({ url: 'http://dev.local' });
+            expect(prodResult).toEqual({ url: 'https://prod.example.com' });
+        });
+    });
+    describe('upsert', () => {
+        let provider;
+        beforeEach(() => {
+            provider = createMockProvider();
+        });
+        it('should add new key', async () => {
+            await Effect.runPromise(provider.upsert(ctx, 'new.key', 'new-value'));
+            const result = await Effect.runPromise(provider.fetch(ctx));
+            expect(result['new.key']).toBe('new-value');
+        });
+        it('should update existing key', async () => {
+            await Effect.runPromise(provider.upsert(ctx, 'existing.key', 'old-value'));
+            await Effect.runPromise(provider.upsert(ctx, 'existing.key', 'new-value'));
+            const result = await Effect.runPromise(provider.fetch(ctx));
+            expect(result['existing.key']).toBe('new-value');
+        });
+        it('should preserve other keys when upserting', async () => {
+            await Effect.runPromise(provider.upsert(ctx, 'key1', 'value1'));
+            await Effect.runPromise(provider.upsert(ctx, 'key2', 'value2'));
+            await Effect.runPromise(provider.upsert(ctx, 'key1', 'updated'));
+            const result = await Effect.runPromise(provider.fetch(ctx));
+            expect(result).toEqual({
+                key1: 'updated',
+                key2: 'value2',
+            });
+        });
+    });
+    describe('delete', () => {
+        let provider;
+        beforeEach(() => {
+            provider = createMockProvider();
+        });
+        it('should delete existing key', async () => {
+            await Effect.runPromise(provider.upsert(ctx, 'key1', 'value1'));
+            await Effect.runPromise(provider.upsert(ctx, 'key2', 'value2'));
+            await Effect.runPromise(provider.delete(ctx, 'key1'));
+            const result = await Effect.runPromise(provider.fetch(ctx));
+            expect(result).toEqual({ key2: 'value2' });
+        });
+        it('should fail when deleting non-existent key', async () => {
+            await expect(Effect.runPromise(provider.delete(ctx, 'nonexistent'))).rejects.toThrow();
+        });
+    });
+    describe('verifyEncryption', () => {
+        it('should return SecureString by default', async () => {
+            const provider = createMockProvider();
+            await Effect.runPromise(provider.upsert(ctx, 'secret.key', 'secret-value'));
+            const result = await Effect.runPromise(provider.verifyEncryption(ctx, 'secret.key'));
+            expect(result).toBe('SecureString');
+        });
+    });
+    describe('checkGuards', () => {
+        it('should no-op when guards are empty', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, {}))).resolves.toBeUndefined();
+        });
+        it('should no-op when guards are undefined', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, undefined))).resolves.toBeUndefined();
+        });
+        it('should fail when guards are not an object', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, 'not-an-object'))).rejects.toThrowError();
+        });
+        it('should fail when guard values have invalid types', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, { prefix: 123 }))).rejects.toThrowError();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, { service: 456 }))).rejects.toThrowError();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, { env: 789 }))).rejects.toThrowError();
+        });
+        it('should fail when guard values do not match context', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, { env: 'prod' }))).rejects.toThrowError();
+        });
+        it('should fail when prefix does not match', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, { prefix: '/other' }))).rejects.toThrowError();
+        });
+        it('should fail when service does not match', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, { service: 'other-service' }))).rejects.toThrowError();
+        });
+        it('should pass when guard values match context', async () => {
+            const provider = createMockProvider();
+            await expect(Effect.runPromise(provider.checkGuards(ctx, { env: 'dev', service: ctx.service }))).resolves.toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=MockProvider.test.js.map

package/dist/providers/MockProvider.test.js.map

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

package/dist/providers/Provider.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Provider Interface
+ *
+ * Defines the contract for configuration providers (AWS SSM, AWS Secrets Manager, Vault, etc.)
+ */
+import type { Effect } from 'effect';
+import type { ProviderError } from '../errors.js';
+/**
+ * Context for provider operations
+ */
+export type ProviderContext = {
+    readonly prefix: string;
+    readonly service: string;
+    readonly env: string;
+};
+/**
+ * Key-value map using canonical key paths (dot notation) to raw provider strings
+ * Example: { "database.url": "postgres://...", "api.timeoutMs": "6500" }
+ */
+export type ProviderKV = Record<string, string>;
+/**
+ * Encryption type for stored values
+ */
+export declare const EncryptionType: {
+    readonly SECURE_STRING: "SecureString";
+    readonly STRING: "String";
+    readonly UNKNOWN: "Unknown";
+};
+export type EncryptionTypeValue = (typeof EncryptionType)[keyof typeof EncryptionType];
+/**
+ * Provider capabilities
+ */
+export type ProviderCapabilities = {
+    readonly secureWrite?: boolean;
+    readonly encryptionVerification?: boolean;
+    readonly transactions?: boolean;
+};
+/**
+ * Provider interface
+ *
+ * All providers must implement fetch, upsert, and delete.
+ * Optional: verifyEncryption if capabilities.encryptionVerification is true.
+ */
+export type Provider = {
+    readonly name: string;
+    readonly capabilities: ProviderCapabilities;
+    /**
+     * Optional provider-specific guard check
+     */
+    readonly checkGuards?: (ctx: ProviderContext, guards?: unknown) => Effect.Effect<void, ProviderError>;
+    /**
+     * Fetch all key-value pairs for the given context
+     * Returns canonical key paths (dot notation) mapped to string values
+     */
+    readonly fetch: (ctx: ProviderContext) => Effect.Effect<ProviderKV, ProviderError>;
+    /**
+     * Upsert a single key-value pair
+     * keyPath is in canonical dot notation (e.g., "database.url")
+     * value is the string-encoded value
+     */
+    readonly upsert: (ctx: ProviderContext, keyPath: string, value: string) => Effect.Effect<void, ProviderError>;
+    /**
+     * Delete a single key
+     * keyPath is in canonical dot notation
+     */
+    readonly delete: (ctx: ProviderContext, keyPath: string) => Effect.Effect<void, ProviderError>;
+    /**
+     * Verify encryption type for a key (optional)
+     * Only available if capabilities.encryptionVerification is true
+     */
+    readonly verifyEncryption?: (ctx: ProviderContext, keyPath: string) => Effect.Effect<EncryptionTypeValue, ProviderError>;
+};
+/**
+ * Convert canonical dot path to SSM slash path
+ * Example: "database.url" -> "database/url"
+ */
+export declare function dotToSlashPath(dotPath: string): string;
+/**
+ * Convert SSM slash path to canonical dot path
+ * Example: "database/url" -> "database.url"
+ */
+export declare function slashToDotPath(slashPath: string): string;
+/**
+ * Build the full SSM parameter path
+ * Example: buildFullPath({ prefix: "/config-o-tron", service: "api", env: "prod" }, "database.url")
+ *          -> "/config-o-tron/prod/api/database/url"
+ */
+export declare function buildFullPath(ctx: ProviderContext, keyPath: string): string;
+/**
+ * Extract the key path from a full SSM parameter path
+ * Example: extractKeyPath("/config-o-tron/prod/api/database/url", { prefix: "/config-o-tron", service: "api", env: "prod" })
+ *          -> "database.url"
+ */
+export declare function extractKeyPath(fullPath: string, ctx: ProviderContext): string;
+//# sourceMappingURL=Provider.d.ts.map

package/dist/providers/Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../src/providers/Provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAEtG;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAEnF;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAE9G;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAE/F;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAC1B,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;CACxD,CAAC;AAMF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAO7E"}

package/dist/providers/Provider.js

@@ -0,0 +1,49 @@
+/**
+ * Encryption type for stored values
+ */
+export const EncryptionType = {
+    SECURE_STRING: 'SecureString',
+    STRING: 'String',
+    UNKNOWN: 'Unknown',
+};
+// --------------------------------------------------------------------------
+// Utility Functions
+// --------------------------------------------------------------------------
+/**
+ * Convert canonical dot path to SSM slash path
+ * Example: "database.url" -> "database/url"
+ */
+export function dotToSlashPath(dotPath) {
+    return dotPath.replace(/\./g, '/');
+}
+/**
+ * Convert SSM slash path to canonical dot path
+ * Example: "database/url" -> "database.url"
+ */
+export function slashToDotPath(slashPath) {
+    return slashPath.replace(/\//g, '.');
+}
+/**
+ * Build the full SSM parameter path
+ * Example: buildFullPath({ prefix: "/config-o-tron", service: "api", env: "prod" }, "database.url")
+ *          -> "/config-o-tron/prod/api/database/url"
+ */
+export function buildFullPath(ctx, keyPath) {
+    const prefix = ctx.prefix.endsWith('/') ? ctx.prefix.slice(0, -1) : ctx.prefix;
+    const slashKeyPath = dotToSlashPath(keyPath);
+    return `${prefix}/${ctx.env}/${ctx.service}/${slashKeyPath}`;
+}
+/**
+ * Extract the key path from a full SSM parameter path
+ * Example: extractKeyPath("/config-o-tron/prod/api/database/url", { prefix: "/config-o-tron", service: "api", env: "prod" })
+ *          -> "database.url"
+ */
+export function extractKeyPath(fullPath, ctx) {
+    const prefix = ctx.prefix.endsWith('/') ? ctx.prefix.slice(0, -1) : ctx.prefix;
+    const basePrefix = `${prefix}/${ctx.env}/${ctx.service}/`;
+    if (fullPath.startsWith(basePrefix)) {
+        return slashToDotPath(fullPath.slice(basePrefix.length));
+    }
+    return slashToDotPath(fullPath);
+}
+//# sourceMappingURL=Provider.js.map

package/dist/providers/Provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../../src/providers/Provider.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,aAAa,EAAE,cAAc;IAC7B,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC;AAyDX,6EAA6E;AAC7E,oBAAoB;AACpB,6EAA6E;AAE7E;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoB,EAAE,OAAe;IACjE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IAC/E,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,GAAG,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,YAAY,EAAE,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,GAAoB;IACnE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IAC/E,MAAM,UAAU,GAAG,GAAG,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC;IAC1D,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/providers/Provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Provider.test.d.ts.map

package/dist/providers/Provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.test.d.ts","sourceRoot":"","sources":["../../src/providers/Provider.test.ts"],"names":[],"mappings":""}

package/dist/providers/Provider.test.js

@@ -0,0 +1,136 @@
+/**
+ * Provider Utility Tests
+ */
+import { describe, expect, it } from 'vitest';
+import { buildFullPath, dotToSlashPath, EncryptionType, extractKeyPath, slashToDotPath, } from './Provider.js';
+describe('Provider', () => {
+    describe('EncryptionType', () => {
+        it('should have correct values', () => {
+            expect(EncryptionType.SECURE_STRING).toBe('SecureString');
+            expect(EncryptionType.STRING).toBe('String');
+            expect(EncryptionType.UNKNOWN).toBe('Unknown');
+        });
+    });
+    describe('dotToSlashPath', () => {
+        it('should convert single dot to slash', () => {
+            expect(dotToSlashPath('database.url')).toBe('database/url');
+        });
+        it('should convert multiple dots to slashes', () => {
+            expect(dotToSlashPath('database.connection.url')).toBe('database/connection/url');
+        });
+        it('should handle single segment (no dots)', () => {
+            expect(dotToSlashPath('database')).toBe('database');
+        });
+        it('should handle empty string', () => {
+            expect(dotToSlashPath('')).toBe('');
+        });
+        it('should handle deep nesting', () => {
+            expect(dotToSlashPath('a.b.c.d.e.f')).toBe('a/b/c/d/e/f');
+        });
+    });
+    describe('slashToDotPath', () => {
+        it('should convert single slash to dot', () => {
+            expect(slashToDotPath('database/url')).toBe('database.url');
+        });
+        it('should convert multiple slashes to dots', () => {
+            expect(slashToDotPath('database/connection/url')).toBe('database.connection.url');
+        });
+        it('should handle single segment (no slashes)', () => {
+            expect(slashToDotPath('database')).toBe('database');
+        });
+        it('should handle empty string', () => {
+            expect(slashToDotPath('')).toBe('');
+        });
+        it('should handle deep nesting', () => {
+            expect(slashToDotPath('a/b/c/d/e/f')).toBe('a.b.c.d.e.f');
+        });
+    });
+    describe('buildFullPath', () => {
+        const ctx = {
+            prefix: '/config-o-tron',
+            service: 'api',
+            env: 'prod',
+        };
+        it('should build full path for simple key', () => {
+            expect(buildFullPath(ctx, 'database.url')).toBe('/config-o-tron/prod/api/database/url');
+        });
+        it('should build full path for nested key', () => {
+            expect(buildFullPath(ctx, 'database.connection.url')).toBe('/config-o-tron/prod/api/database/connection/url');
+        });
+        it('should build full path for single segment key', () => {
+            expect(buildFullPath(ctx, 'timeout')).toBe('/config-o-tron/prod/api/timeout');
+        });
+        it('should handle different context values', () => {
+            const customCtx = {
+                prefix: '/custom',
+                service: 'myapp',
+                env: 'staging',
+            };
+            expect(buildFullPath(customCtx, 'api.key')).toBe('/custom/staging/myapp/api/key');
+        });
+        it('should handle context with empty prefix', () => {
+            const ctxNoPrefix = {
+                prefix: '',
+                service: 'api',
+                env: 'prod',
+            };
+            expect(buildFullPath(ctxNoPrefix, 'database.url')).toBe('/prod/api/database/url');
+        });
+        it('should trim trailing slashes in prefix', () => {
+            const ctxWithSlash = {
+                prefix: '/config-o-tron/',
+                service: 'api',
+                env: 'prod',
+            };
+            expect(buildFullPath(ctxWithSlash, 'database.url')).toBe('/config-o-tron/prod/api/database/url');
+        });
+    });
+    describe('extractKeyPath', () => {
+        const ctx = {
+            prefix: '/config-o-tron',
+            service: 'api',
+            env: 'prod',
+        };
+        it('should extract key path from full path', () => {
+            expect(extractKeyPath('/config-o-tron/prod/api/database/url', ctx)).toBe('database.url');
+        });
+        it('should extract nested key path', () => {
+            expect(extractKeyPath('/config-o-tron/prod/api/database/connection/url', ctx)).toBe('database.connection.url');
+        });
+        it('should extract single segment key path', () => {
+            expect(extractKeyPath('/config-o-tron/prod/api/timeout', ctx)).toBe('timeout');
+        });
+        it('should handle path that does not match prefix', () => {
+            // When path doesn't start with the expected prefix, it just converts slashes to dots
+            expect(extractKeyPath('/other/path/value', ctx)).toBe('.other.path.value');
+        });
+        it('should handle different context values', () => {
+            const customCtx = {
+                prefix: '/custom',
+                service: 'myapp',
+                env: 'staging',
+            };
+            expect(extractKeyPath('/custom/staging/myapp/api/key', customCtx)).toBe('api.key');
+        });
+        it('should trim trailing slashes in prefix when extracting', () => {
+            const ctxWithSlash = {
+                prefix: '/config-o-tron/',
+                service: 'api',
+                env: 'prod',
+            };
+            expect(extractKeyPath('/config-o-tron/prod/api/database/url', ctxWithSlash)).toBe('database.url');
+        });
+        it('should handle non-matching paths with trailing slash prefix', () => {
+            const ctxWithSlash = {
+                prefix: '/config-o-tron/',
+                service: 'api',
+                env: 'prod',
+            };
+            expect(extractKeyPath('/other/path/value', ctxWithSlash)).toBe('.other.path.value');
+        });
+        it('should handle empty key path', () => {
+            expect(extractKeyPath('/config-o-tron/prod/api/', ctx)).toBe('');
+        });
+    });
+});
+//# sourceMappingURL=Provider.test.js.map

package/dist/providers/Provider.test.js.map

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

package/dist/providers/guards.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider Guards
+ *
+ * Utilities for resolving and invoking provider guard checks.
+ */
+import * as Effect from 'effect/Effect';
+import { type ProviderGuardsConfig } from '../config.js';
+import { type ProviderError } from '../errors.js';
+import { type Provider, type ProviderContext } from './Provider.js';
+export declare function getProviderGuardConfig(providerName: string, providerGuards: ProviderGuardsConfig): unknown | undefined;
+export declare function shouldIgnoreProviderGuards(): boolean;
+export declare function checkProviderGuards(provider: Provider, ctx: ProviderContext, providerGuards: ProviderGuardsConfig): Effect.Effect<void, ProviderError>;
+//# sourceMappingURL=guards.d.ts.map

package/dist/providers/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/providers/guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAoBpE,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,oBAAoB,GACnC,OAAO,GAAG,SAAS,CAkBrB;AAMD,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,eAAe,EACpB,cAAc,EAAE,oBAAoB,GACnC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAepC"}

package/dist/providers/guards.js

@@ -0,0 +1,60 @@
+/**
+ * Provider Guards
+ *
+ * Utilities for resolving and invoking provider guard checks.
+ */
+import * as Effect from 'effect/Effect';
+import {} from '../config.js';
+import {} from '../errors.js';
+import {} from './Provider.js';
+// --------------------------------------------------------------------------
+// Helpers
+// --------------------------------------------------------------------------
+function normalizeProviderName(name) {
+    return name.toLowerCase();
+}
+function isGuardOverrideEnabled(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true';
+}
+// --------------------------------------------------------------------------
+// Guard Resolution
+// --------------------------------------------------------------------------
+export function getProviderGuardConfig(providerName, providerGuards) {
+    const direct = providerGuards[providerName];
+    if (direct !== undefined) {
+        return direct;
+    }
+    const normalized = normalizeProviderName(providerName);
+    const normalizedDirect = providerGuards[normalized];
+    if (normalizedDirect !== undefined) {
+        return normalizedDirect;
+    }
+    const matchedKey = Object.keys(providerGuards).find((key) => normalizeProviderName(key) === normalized);
+    if (matchedKey) {
+        return providerGuards[matchedKey];
+    }
+    return undefined;
+}
+// --------------------------------------------------------------------------
+// Guard Invocation
+// --------------------------------------------------------------------------
+export function shouldIgnoreProviderGuards() {
+    return isGuardOverrideEnabled(process.env.CONFIG_O_TRON_IGNORE_PROVIDER_GUARDS);
+}
+export function checkProviderGuards(provider, ctx, providerGuards) {
+    if (!provider.checkGuards) {
+        return Effect.void;
+    }
+    if (shouldIgnoreProviderGuards()) {
+        return Effect.void;
+    }
+    const guardConfig = getProviderGuardConfig(provider.name, providerGuards);
+    if (guardConfig === undefined) {
+        return Effect.void;
+    }
+    return provider.checkGuards(ctx, guardConfig);
+}
+//# sourceMappingURL=guards.js.map

package/dist/providers/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/providers/guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAA6B,MAAM,cAAc,CAAC;AACzD,OAAO,EAAsB,MAAM,cAAc,CAAC;AAClD,OAAO,EAAuC,MAAM,eAAe,CAAC;AAEpE,6EAA6E;AAC7E,UAAU;AACV,6EAA6E;AAE7E,SAAS,qBAAqB,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAyB;IACvD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,CAAC;AACrD,CAAC;AAED,6EAA6E;AAC7E,mBAAmB;AACnB,6EAA6E;AAE7E,MAAM,UAAU,sBAAsB,CACpC,YAAoB,EACpB,cAAoC;IAEpC,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,CAAC;IACxG,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,6EAA6E;AAC7E,mBAAmB;AACnB,6EAA6E;AAE7E,MAAM,UAAU,0BAA0B;IACxC,OAAO,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,GAAoB,EACpB,cAAoC;IAEpC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,0BAA0B,EAAE,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC1E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC"}

package/dist/providers/guards.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guards.test.d.ts.map

package/dist/providers/guards.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.test.d.ts","sourceRoot":"","sources":["../../src/providers/guards.test.ts"],"names":[],"mappings":""}