@ontrails/config 1.0.0-beta.12

package/src/workspace.ts

@@ -0,0 +1,51 @@
+/**
+ * Ensure the `.trails/` workspace directory exists with proper structure.
+ *
+ * Auto-creates on first framework operation. The workspace holds local
+ * config overrides, development state, and generated artifacts that
+ * should not be committed to source control.
+ */
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+
+const WORKSPACE_DIRS = ['config', 'dev', 'generated'] as const;
+
+const GITIGNORE_CONTENT = [
+  '# Local config overrides',
+  'config/',
+  '',
+  '# Development state',
+  'dev/',
+  '',
+  '# Generated artifacts',
+  'generated/',
+  '',
+].join('\n');
+
+/**
+ * Write `.gitignore` inside the workspace directory if it does not already exist.
+ */
+const writeGitignoreIfMissing = async (trailsDir: string): Promise<void> => {
+  const gitignorePath = join(trailsDir, '.gitignore');
+  const file = Bun.file(gitignorePath);
+  if (!(await file.exists())) {
+    await Bun.write(gitignorePath, GITIGNORE_CONTENT);
+  }
+};
+
+/**
+ * Ensure the `.trails/` workspace directory exists with proper structure.
+ *
+ * Creates `config/`, `dev/`, and `generated/` subdirectories plus a
+ * `.gitignore` that excludes local-only files. Safe to call repeatedly —
+ * existing files are never overwritten.
+ */
+export const ensureWorkspace = async (root: string): Promise<void> => {
+  const trailsDir = join(root, '.trails');
+
+  await Promise.all(
+    WORKSPACE_DIRS.map((d) => mkdir(join(trailsDir, d), { recursive: true }))
+  );
+
+  await writeGitignoreIfMissing(trailsDir);
+};

package/src/zod-utils.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared Zod introspection helpers used by config resolution, doctor,
+ * describe, explain, and collect modules.
+ */
+
+import type { z } from 'zod';
+
+/** Extract the Zod def record from any ZodType. */
+export const zodDef = (schema: z.ZodType): Record<string, unknown> =>
+  schema.def as unknown as Record<string, unknown>;
+
+/** 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: z.ZodType): z.ZodType => {
+  let current = schema;
+  for (let depth = 0; depth < 10; depth += 1) {
+    const def = zodDef(current);
+    if (!WRAPPER_TYPES.has(def['type'] as string)) {
+      return current;
+    }
+    const inner = def['innerType'] as z.ZodType | undefined;
+    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: z.ZodType
+): schema is z.ZodObject<Record<string, z.ZodType>> => {
+  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: Record<string, unknown>,
+  path: string
+): unknown => {
+  let current: unknown = obj;
+  for (const part of path.split('.')) {
+    if (typeof current !== 'object' || current === null) {
+      return undefined;
+    }
+    current = (current as Record<string, unknown>)[part];
+  }
+  return current;
+};

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["**/__tests__/**", "**/*.test.ts", "dist"]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/app-config.ts","./src/collect.ts","./src/compose.ts","./src/config-layer.ts","./src/config-service.ts","./src/define-config.ts","./src/describe.ts","./src/doctor.ts","./src/explain.ts","./src/extensions.ts","./src/index.ts","./src/merge.ts","./src/ref.ts","./src/registry.ts","./src/resolve.ts","./src/secret-heuristics.ts","./src/workspace.ts","./src/zod-utils.ts","./src/generate/env.ts","./src/generate/example.ts","./src/generate/helpers.ts","./src/generate/index.ts","./src/generate/json-schema.ts","./src/trails/config-check.ts","./src/trails/config-describe.ts","./src/trails/config-explain.ts","./src/trails/config-init.ts"],"version":"5.9.3"}