@ontrails/config 1.0.0-beta.14 → 1.0.0-beta.16

package/dist/zod-utils.js

@@ -1,41 +0,0 @@
-/**
- * Shared Zod introspection helpers used by config resolution, doctor,
- * describe, explain, and collect modules.
- */
-/** Extract the Zod def record from any ZodType. */
-export const zodDef = (schema) => schema.def;
-/** Wrapper types that should be peeled before checking the base type. */
-const WRAPPER_TYPES = new Set(['optional', 'default', 'nullable']);
-/** Unwrap through optional/default/nullable wrappers to find the base schema. */
-export const unwrapToBase = (schema) => {
-    let current = schema;
-    for (let depth = 0; depth < 10; depth += 1) {
-        const def = zodDef(current);
-        if (!WRAPPER_TYPES.has(def['type'])) {
-            return current;
-        }
-        const inner = def['innerType'];
-        if (!inner) {
-            return current;
-        }
-        current = inner;
-    }
-    return current;
-};
-/** Check if a schema is (or wraps) a ZodObject by inspecting its def. */
-export const isZodObject = (schema) => {
-    const def = zodDef(unwrapToBase(schema));
-    return def['type'] === 'object' && 'shape' in def;
-};
-/** Read a value at a dot-separated path from a plain object. */
-export const getAtPath = (obj, path) => {
-    let current = obj;
-    for (const part of path.split('.')) {
-        if (typeof current !== 'object' || current === null) {
-            return undefined;
-        }
-        current = current[part];
-    }
-    return current;
-};
-//# sourceMappingURL=zod-utils.js.map

package/dist/zod-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod-utils.js","sourceRoot":"","sources":["../src/zod-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,mDAAmD;AACnD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAiB,EAA2B,EAAE,CACnE,MAAM,CAAC,GAAyC,CAAC;AAEnD,yEAAyE;AACzE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnE,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAiB,EAAa,EAAE;IAC3D,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAW,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAA0B,CAAC;QACxD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,MAAiB,EACiC,EAAE;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAI,GAAG,CAAC;AACpD,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,GAA4B,EAC5B,IAAY,EACH,EAAE;IACX,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/src/__tests__/app-config.test.ts

@@ -1,329 +0,0 @@
-import { describe, expect, test, beforeEach, afterEach } from 'bun:test';
-import { mkdir, mkdtemp, rm } from 'node:fs/promises';
-import { join } from 'node:path';
-import { tmpdir } from 'node:os';
-import { z } from 'zod';
-
-import type { AppConfig } from '../app-config.js';
-import { appConfig } from '../app-config.js';
-import { describeConfig } from '../describe.js';
-import { checkConfig } from '../doctor.js';
-import { configRef } from '../ref.js';
-
-const testSchema = z.object({
-  output: z.string().describe('Output directory').default('./output'),
-  verbose: z.boolean().default(false),
-});
-
-const createJsonConfig = () =>
-  appConfig('myapp', {
-    formats: ['json'],
-    schema: testSchema,
-  });
-
-const writeJsonConfig = (filePath: string, output: string) =>
-  Bun.write(filePath, JSON.stringify({ output }));
-
-const resolveOutput = async (
-  config: AppConfig<typeof testSchema>,
-  filePath: string
-): Promise<string> => {
-  const result = await config.resolve({ path: filePath });
-  expect(result.isOk()).toBe(true);
-  return result.unwrap().output;
-};
-
-describe('appConfig()', () => {
-  describe('creation', () => {
-    test('returns an object with the provided name', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      expect(config.name).toBe('myapp');
-    });
-
-    test('returns the provided schema', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      expect(config.schema).toBe(testSchema);
-    });
-
-    test('defaults formats to toml, json, yaml when not specified', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      expect(config.formats).toEqual(['toml', 'json', 'yaml']);
-    });
-
-    test('uses provided formats', () => {
-      const config = appConfig('myapp', {
-        formats: ['json', 'jsonc'],
-        schema: testSchema,
-      });
-      expect(config.formats).toEqual(['json', 'jsonc']);
-    });
-
-    test('defaults dotfile to false when not specified', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      expect(config.dotfile).toBe(false);
-    });
-
-    test('uses provided dotfile value', () => {
-      const config = appConfig('myapp', {
-        dotfile: true,
-        schema: testSchema,
-      });
-      expect(config.dotfile).toBe(true);
-    });
-  });
-
-  describe('resolve() with explicit path', () => {
-    let tempDir: string;
-
-    beforeEach(async () => {
-      tempDir = await mkdtemp(join(tmpdir(), 'trails-config-'));
-    });
-
-    afterEach(async () => {
-      await rm(tempDir, { force: true, recursive: true });
-    });
-
-    test('reads and validates a JSON config file', async () => {
-      const filePath = join(tempDir, 'myapp.config.json');
-      await Bun.write(
-        filePath,
-        JSON.stringify({ output: './dist', verbose: true })
-      );
-
-      const config = createJsonConfig();
-      const result = await config.resolve({ path: filePath });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap()).toEqual({ output: './dist', verbose: true });
-    });
-
-    test('reads and validates a TOML config file', async () => {
-      const filePath = join(tempDir, 'myapp.config.toml');
-      await Bun.write(filePath, 'output = "./build"\nverbose = true\n');
-
-      const config = appConfig('myapp', {
-        formats: ['toml'],
-        schema: testSchema,
-      });
-      const result = await config.resolve({ path: filePath });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap()).toEqual({ output: './build', verbose: true });
-    });
-
-    test('applies schema defaults for missing fields', async () => {
-      const filePath = join(tempDir, 'myapp.config.json');
-      await Bun.write(filePath, JSON.stringify({}));
-
-      const config = createJsonConfig();
-      const result = await config.resolve({ path: filePath });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap()).toEqual({ output: './output', verbose: false });
-    });
-
-    test('re-reads config files after they change on disk', async () => {
-      const filePath = join(tempDir, 'myapp.config.json');
-      await writeJsonConfig(filePath, './first');
-
-      const config = createJsonConfig();
-
-      expect(await resolveOutput(config, filePath)).toBe('./first');
-
-      await Bun.sleep(10);
-      await writeJsonConfig(filePath, './second');
-
-      expect(await resolveOutput(config, filePath)).toBe('./second');
-    });
-
-    test('returns Result.err when file does not exist', async () => {
-      const filePath = join(tempDir, 'nonexistent.json');
-
-      const config = createJsonConfig();
-      const result = await config.resolve({ path: filePath });
-
-      expect(result.isErr()).toBe(true);
-    });
-
-    test('returns Result.err when file has invalid content', async () => {
-      const filePath = join(tempDir, 'myapp.config.json');
-      await Bun.write(
-        filePath,
-        JSON.stringify({ output: 42, verbose: 'not-a-bool' })
-      );
-
-      const config = createJsonConfig();
-      const result = await config.resolve({ path: filePath });
-
-      expect(result.isErr()).toBe(true);
-    });
-  });
-
-  describe('resolve() with discovery', () => {
-    let tempDir: string;
-
-    beforeEach(async () => {
-      tempDir = await mkdtemp(join(tmpdir(), 'trails-config-'));
-    });
-
-    afterEach(async () => {
-      await rm(tempDir, { force: true, recursive: true });
-    });
-
-    test('discovers config file in cwd', async () => {
-      const filePath = join(tempDir, 'myapp.config.json');
-      await writeJsonConfig(filePath, './found');
-
-      const config = createJsonConfig();
-      const result = await config.resolve({ cwd: tempDir });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap().output).toBe('./found');
-    });
-
-    test('discovers config file by walking up directories', async () => {
-      const nested = join(tempDir, 'a', 'b', 'c');
-      await mkdir(nested, { recursive: true });
-
-      const filePath = join(tempDir, 'myapp.config.json');
-      await Bun.write(filePath, JSON.stringify({ output: './parent' }));
-
-      const config = appConfig('myapp', {
-        formats: ['json'],
-        schema: testSchema,
-      });
-      const result = await config.resolve({ cwd: nested });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap().output).toBe('./parent');
-    });
-
-    test('tries formats in order', async () => {
-      await Bun.write(
-        join(tempDir, 'myapp.config.toml'),
-        'output = "./from-toml"\n'
-      );
-      await Bun.write(
-        join(tempDir, 'myapp.config.json'),
-        JSON.stringify({ output: './from-json' })
-      );
-
-      const config = appConfig('myapp', {
-        formats: ['toml', 'json'],
-        schema: testSchema,
-      });
-      const result = await config.resolve({ cwd: tempDir });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap().output).toBe('./from-toml');
-    });
-
-    test('returns Result.err when no config file found', async () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      const result = await config.resolve({ cwd: tempDir });
-
-      expect(result.isErr()).toBe(true);
-    });
-  });
-
-  describe('file naming conventions', () => {
-    let tempDir: string;
-
-    beforeEach(async () => {
-      tempDir = await mkdtemp(join(tmpdir(), 'trails-config-'));
-    });
-
-    afterEach(async () => {
-      await rm(tempDir, { force: true, recursive: true });
-    });
-
-    test('dotfile: true searches for .myapprc.* files', async () => {
-      await Bun.write(
-        join(tempDir, '.myapprc.json'),
-        JSON.stringify({ output: './dotfile' })
-      );
-
-      const config = appConfig('myapp', {
-        dotfile: true,
-        formats: ['json'],
-        schema: testSchema,
-      });
-      const result = await config.resolve({ cwd: tempDir });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap().output).toBe('./dotfile');
-    });
-
-    test('dotfile: false searches for myapp.config.* files', async () => {
-      await Bun.write(
-        join(tempDir, 'myapp.config.json'),
-        JSON.stringify({ output: './standard' })
-      );
-
-      const config = appConfig('myapp', {
-        dotfile: false,
-        formats: ['json'],
-        schema: testSchema,
-      });
-      const result = await config.resolve({ cwd: tempDir });
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap().output).toBe('./standard');
-    });
-
-    test('dotfile: true does NOT find myapp.config.* files', async () => {
-      await Bun.write(
-        join(tempDir, 'myapp.config.json'),
-        JSON.stringify({ output: './nope' })
-      );
-
-      const config = appConfig('myapp', {
-        dotfile: true,
-        formats: ['json'],
-        schema: testSchema,
-      });
-      const result = await config.resolve({ cwd: tempDir });
-
-      expect(result.isErr()).toBe(true);
-    });
-  });
-
-  describe('method delegations', () => {
-    test('describe() returns same result as describeConfig(schema)', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      const methodResult = config.describe();
-      const standaloneResult = describeConfig(testSchema);
-
-      expect(methodResult).toEqual(standaloneResult);
-    });
-
-    test('check() returns same result as checkConfig(schema, values)', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      const values = { output: './dist', verbose: true };
-
-      const methodResult = config.check(values);
-      const standaloneResult = checkConfig(testSchema, values);
-
-      expect(methodResult).toEqual(standaloneResult);
-    });
-
-    test('ref() returns same result as configRef(path)', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      const methodResult = config.ref('output');
-      const standaloneResult = configRef('output');
-
-      expect(methodResult).toEqual(standaloneResult);
-    });
-
-    test('explain() delegates to explainConfig with bound schema', () => {
-      const config = appConfig('myapp', { schema: testSchema });
-      const resolved = { output: './dist', verbose: true };
-
-      const result = config.explain({ resolved });
-
-      expect(result.length).toBeGreaterThan(0);
-      expect(result[0]?.path).toBeDefined();
-      expect(result[0]?.source).toBeDefined();
-    });
-  });
-});

package/src/__tests__/compose.test.ts

@@ -1,59 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import { z } from 'zod';
-
-import { collectProvisionConfigs } from '../compose.js';
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('collectProvisionConfigs', () => {
-  test('extracts config schemas from provisions that declare them', () => {
-    const dbSchema = z.object({ url: z.string().url() });
-    const cacheSchema = z.object({ ttl: z.number() });
-
-    const provisions = [
-      { config: dbSchema, id: 'db.main' },
-      { config: cacheSchema, id: 'cache.main' },
-    ];
-
-    const entries = collectProvisionConfigs(provisions);
-
-    expect(entries).toHaveLength(2);
-    expect(entries[0]).toEqual({ provisionId: 'db.main', schema: dbSchema });
-    expect(entries[1]).toEqual({
-      provisionId: 'cache.main',
-      schema: cacheSchema,
-    });
-  });
-
-  test('excludes provisions without config', () => {
-    const schema = z.object({ url: z.string() });
-
-    const provisions = [
-      { config: schema, id: 'db.main' },
-      { id: 'counter.main' },
-      { config: undefined, id: 'logger.main' },
-    ];
-
-    const entries = collectProvisionConfigs(provisions);
-
-    expect(entries).toHaveLength(1);
-    expect(entries[0]?.provisionId).toBe('db.main');
-  });
-
-  test('returns empty array when no provisions have config', () => {
-    const provisions = [{ id: 'counter.main' }, { id: 'logger.main' }];
-
-    const entries = collectProvisionConfigs(provisions);
-
-    expect(entries).toEqual([]);
-  });
-
-  test('returns empty array for empty input', () => {
-    const entries = collectProvisionConfigs([]);
-
-    expect(entries).toEqual([]);
-  });
-});

package/src/__tests__/config-check.test.ts

@@ -1,171 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-import { createProvisionLookup } from '@ontrails/core';
-import type { TrailContext } from '@ontrails/core';
-import { z } from 'zod';
-
-import { configCheck } from '../trails/config-check.js';
-import type { ConfigState } from '../registry.js';
-
-/**
- * Build a TrailContext with configProvision resolved in extensions.
- */
-const buildCtx = (state: ConfigState): TrailContext => {
-  const extensions = { config: state };
-  const ctx: TrailContext = {
-    abortSignal: AbortSignal.timeout(5000),
-    cwd: '/tmp',
-    env: {},
-    extensions,
-    provision: undefined as unknown as TrailContext['provision'],
-    requestId: 'test',
-    workspaceRoot: '/tmp',
-  };
-  const withLookup = {
-    ...ctx,
-    provision: createProvisionLookup(() => withLookup),
-  };
-  return withLookup;
-};
-
-describe('config.check trail', () => {
-  describe('identity', () => {
-    test('has id "config.check"', () => {
-      expect(configCheck.id).toBe('config.check');
-    });
-
-    test('has kind "trail"', () => {
-      expect(configCheck.kind).toBe('trail');
-    });
-
-    test('has intent "read"', () => {
-      expect(configCheck.intent).toBe('read');
-    });
-
-    test('has infrastructure meta', () => {
-      expect(configCheck.meta).toEqual({ category: 'infrastructure' });
-    });
-
-    test('has output schema', () => {
-      expect(configCheck.output).toBeDefined();
-    });
-
-    test('declares configProvision dependency', () => {
-      expect(configCheck.provisions).toBeDefined();
-      expect(configCheck.provisions?.length).toBe(1);
-    });
-  });
-
-  describe('examples', () => {
-    test('has at least one example', () => {
-      expect(configCheck.examples?.length).toBeGreaterThanOrEqual(1);
-    });
-  });
-
-  describe('wired behavior', () => {
-    test('reports valid when all required fields present', async () => {
-      const schema = z.object({
-        host: z.string().default('localhost'),
-        port: z.number().default(3000),
-      });
-      const state: ConfigState = {
-        resolved: { host: 'localhost', port: 3000 },
-        schema,
-      };
-      const ctx = buildCtx(state);
-      const result = await configCheck.blaze({ values: {} }, ctx);
-
-      expect(result.isOk()).toBe(true);
-      const value = result.unwrap();
-      expect(value.valid).toBe(true);
-      expect(value.diagnostics.length).toBeGreaterThan(0);
-    });
-
-    test('reports missing for required fields without values', async () => {
-      const schema = z.object({
-        host: z.string(),
-        port: z.number(),
-      });
-      const state: ConfigState = {
-        resolved: {},
-        schema,
-      };
-      const ctx = buildCtx(state);
-      const result = await configCheck.blaze({ values: {} }, ctx);
-
-      expect(result.isOk()).toBe(true);
-      const value = result.unwrap();
-      expect(value.valid).toBe(false);
-      const missing = value.diagnostics.filter((d) => d.status === 'missing');
-      expect(missing.length).toBe(2);
-    });
-
-    test('uses input values when provided to override resolved', async () => {
-      const schema = z.object({
-        port: z.number(),
-      });
-      const state: ConfigState = {
-        resolved: {},
-        schema,
-      };
-      const ctx = buildCtx(state);
-      const result = await configCheck.blaze({ values: { port: 8080 } }, ctx);
-
-      expect(result.isOk()).toBe(true);
-      const value = result.unwrap();
-      expect(value.valid).toBe(true);
-      expect(value.diagnostics.length).toBe(1);
-      expect(value.diagnostics[0]?.status).toBe('valid');
-    });
-
-    test('deep merges nested input overrides with resolved values', async () => {
-      const schema = z.object({
-        db: z.object({
-          host: z.string(),
-          port: z.number(),
-        }),
-      });
-      const state: ConfigState = {
-        resolved: { db: { host: 'localhost', port: 5432 } },
-        schema,
-      };
-      const ctx = buildCtx(state);
-      const result = await configCheck.blaze(
-        { values: { db: { port: 6543 } } },
-        ctx
-      );
-
-      expect(result.isOk()).toBe(true);
-      expect(result.unwrap().valid).toBe(true);
-      expect(result.unwrap().diagnostics).toEqual([
-        expect.objectContaining({
-          path: 'db.host',
-          status: 'valid',
-          value: 'localhost',
-        }),
-        expect.objectContaining({
-          path: 'db.port',
-          status: 'valid',
-          value: 6543,
-        }),
-      ]);
-    });
-
-    test('reports default status for fields using defaults', async () => {
-      const schema = z.object({
-        port: z.number().default(3000),
-      });
-      const state: ConfigState = {
-        resolved: {},
-        schema,
-      };
-      const ctx = buildCtx(state);
-      const result = await configCheck.blaze({ values: {} }, ctx);
-
-      expect(result.isOk()).toBe(true);
-      const defaults = result
-        .unwrap()
-        .diagnostics.filter((d) => d.status === 'default');
-      expect(defaults.length).toBe(1);
-    });
-  });
-});