@ontrails/core 1.0.0-beta.3 → 1.0.0-beta.32

package/src/workspace.ts

@@ -5,11 +5,46 @@
  * helpers for working with paths relative to a workspace.
  */
 
+import { existsSync, readFileSync, readdirSync, realpathSync } from 'node:fs';
 import { resolve, relative, dirname, join, isAbsolute } from 'node:path';
 
 import { NotFoundError } from './errors.js';
 import { Result } from './result.js';
 
+export interface WorkspaceRootManifest {
+  readonly workspaces?: unknown;
+}
+
+export interface WorkspacePackage<
+  Manifest extends object = Record<string, unknown>,
+> {
+  readonly manifest: Manifest;
+  readonly packageJsonPath: string;
+  readonly packageRoot: string;
+  readonly workspacePath: string;
+}
+
+const isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>
+  typeof value === 'object' && value !== null && !Array.isArray(value);
+
+const normalizePath = (path: string): string => path.replaceAll('\\', '/');
+
+const normalizeRealPath = (path: string): string => {
+  try {
+    return normalizePath(realpathSync(path));
+  } catch {
+    return normalizePath(resolve(path));
+  }
+};
+
+const readJsonSync = <T>(path: string): T | undefined => {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8')) as T;
+  } catch {
+    return undefined;
+  }
+};
+
 /** Check if a directory has a package.json with a `workspaces` field. */
 const hasWorkspacesField = async (dir: string): Promise<boolean> => {
   const pkgPath = join(dir, 'package.json');
@@ -25,6 +60,132 @@ const hasWorkspacesField = async (dir: string): Promise<boolean> => {
   }
 };
 
+/**
+ * List workspace patterns from a root package manifest.
+ *
+ * Supports npm/Bun's array form and Yarn-style `{ packages: [] }` form.
+ *
+ * @example
+ * ```ts
+ * listWorkspacePatterns({ workspaces: ['packages/*'] });
+ * ```
+ */
+export const listWorkspacePatterns = (
+  manifest: WorkspaceRootManifest | undefined
+): readonly string[] => {
+  const { workspaces } = manifest ?? {};
+  if (Array.isArray(workspaces)) {
+    return workspaces.filter(
+      (pattern): pattern is string => typeof pattern === 'string'
+    );
+  }
+
+  const packages = isRecord(workspaces) ? workspaces['packages'] : undefined;
+  return Array.isArray(packages)
+    ? packages.filter(
+        (pattern): pattern is string => typeof pattern === 'string'
+      )
+    : [];
+};
+
+const workspaceDirsForPattern = (
+  rootDir: string,
+  pattern: string
+): readonly string[] => {
+  if (!pattern.endsWith('/*')) {
+    const workspaceDir = join(rootDir, pattern);
+    return existsSync(join(workspaceDir, 'package.json')) ? [workspaceDir] : [];
+  }
+
+  const groupDir = join(rootDir, pattern.slice(0, -2));
+  if (!existsSync(groupDir)) {
+    return [];
+  }
+
+  return readdirSync(groupDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => join(groupDir, entry.name))
+    .filter((workspaceDir) => existsSync(join(workspaceDir, 'package.json')))
+    .toSorted();
+};
+
+/**
+ * List package directories matched by workspace patterns.
+ *
+ * Only directories containing `package.json` are returned.
+ *
+ * @example
+ * ```ts
+ * listWorkspacePackageDirs('/repo', ['packages/*']);
+ * ```
+ */
+export const listWorkspacePackageDirs = (
+  rootDir: string,
+  patterns: readonly string[]
+): readonly string[] =>
+  patterns.flatMap((pattern) => workspaceDirsForPattern(rootDir, pattern));
+
+/**
+ * List workspace package manifests from a workspace root.
+ *
+ * @example
+ * ```ts
+ * const packages = listWorkspacePackages('/repo');
+ * ```
+ */
+export const listWorkspacePackages = <
+  Manifest extends { readonly name?: unknown } = { readonly name?: unknown },
+>(
+  rootDir: string
+): readonly WorkspacePackage<Manifest>[] => {
+  const normalizedRoot = normalizeRealPath(rootDir);
+  const rootManifest = readJsonSync<WorkspaceRootManifest>(
+    join(normalizedRoot, 'package.json')
+  );
+  const packages: WorkspacePackage<Manifest>[] = [];
+
+  for (const workspaceDir of listWorkspacePackageDirs(
+    normalizedRoot,
+    listWorkspacePatterns(rootManifest)
+  )) {
+    const packageJsonPath = join(workspaceDir, 'package.json');
+    const manifest = readJsonSync<Manifest>(packageJsonPath);
+    if (!manifest || typeof manifest.name !== 'string') {
+      continue;
+    }
+
+    const packageRoot = normalizeRealPath(dirname(packageJsonPath));
+    packages.push({
+      manifest,
+      packageJsonPath: normalizeRealPath(packageJsonPath),
+      packageRoot,
+      workspacePath: normalizePath(relative(normalizedRoot, packageRoot)),
+    });
+  }
+
+  return packages.toSorted((left, right) =>
+    left.workspacePath.localeCompare(right.workspacePath)
+  );
+};
+
+/**
+ * Find a workspace package by its package name.
+ *
+ * @example
+ * ```ts
+ * const workspace = findWorkspacePackage('/repo', '@ontrails/core');
+ * ```
+ */
+export const findWorkspacePackage = <
+  Manifest extends { readonly name?: unknown } = { readonly name?: unknown },
+>(
+  rootDir: string,
+  packageName: string
+): WorkspacePackage<Manifest> | undefined =>
+  listWorkspacePackages<Manifest>(rootDir).find(
+    (workspacePackage) => workspacePackage.manifest.name === packageName
+  );
+
 /**
  * Walks up from `startDir` (defaults to `process.cwd()`) looking for a
  * `package.json` that contains a `"workspaces"` field.
@@ -71,7 +232,7 @@ export const isInsideWorkspace = (
 /**
  * Returns the relative path from `workspaceRoot` to `filePath`.
  */
-export const getRelativePath = (
+export const deriveRelativePath = (
   filePath: string,
   workspaceRoot: string
 ): string => relative(resolve(workspaceRoot), resolve(filePath));

package/src/zod-wrappers.ts

@@ -0,0 +1,72 @@
+/**
+ * Shared Zod wrapper helpers.
+ *
+ * These helpers walk the wrapper layers of a Zod schema (default, optional,
+ * nullable) and rebuild the schema without any default wrappers so that
+ * downstream `.partial()` calls do not silently re-materialize defaults during
+ * validation. Both `@ontrails/core/trails/derive-trail.ts` and
+ * `@ontrails/store/src/store.ts` previously shipped near-identical copies of
+ * this walk — extracting them here keeps the wrapper semantics authored in one
+ * place so the two call sites cannot drift.
+ *
+ * Canonical behavior: `optional` wrappers are intentionally dropped. Every
+ * current call site applies `.partial()` to the stripped schema, which
+ * re-introduces `optional` across the whole shape. Preserving `optional` here
+ * would be redundant at best and would produce an `OptionalOptional<T>` shape
+ * in edge cases at worst. `nullable` wrappers are preserved because nullability
+ * is a semantic constraint that `.partial()` does not reintroduce.
+ */
+
+import type { z } from 'zod';
+
+const isWrapperType = (
+  type: string
+): type is 'default' | 'nullable' | 'optional' =>
+  type === 'default' || type === 'nullable' || type === 'optional';
+
+const readInnerType = (schema: z.ZodType): z.ZodType =>
+  (schema.def as unknown as { innerType: z.ZodType }).innerType;
+
+/**
+ * Strip `default` wrappers from a Zod type so that partial update schemas do
+ * not silently re-materialize defaults. Walks through all wrapper layers
+ * (`default`, `optional`, `nullable`), drops defaults, drops `optional` (the
+ * downstream `.partial()` reintroduces it across the whole shape), and
+ * preserves `nullable` so explicit nullability survives.
+ */
+export const stripDefaultWrappers = (schema: z.ZodType): z.ZodType => {
+  let current = schema;
+  let isNullable = false;
+
+  while (isWrapperType(current.def.type)) {
+    if (current.def.type === 'nullable') {
+      isNullable = true;
+    }
+    current = readInnerType(current);
+  }
+
+  return isNullable ? current.nullable() : current;
+};
+
+type AnyObjectSchema = z.ZodObject<Record<string, z.ZodType>>;
+
+const asObjectSchema = (schema: z.ZodType): AnyObjectSchema =>
+  schema as unknown as AnyObjectSchema;
+
+/**
+ * Apply {@link stripDefaultWrappers} to every field in a Zod object shape and
+ * return the resulting shape record. Callers typically feed the result to
+ * `.extend()` + `.partial()`.
+ */
+export const stripDefaultsFromShape = (
+  schema: z.ZodType
+): Record<string, z.ZodType> => {
+  const stripped: Record<string, z.ZodType> = {};
+  const objectSchema = asObjectSchema(schema);
+
+  for (const [field, value] of Object.entries(objectSchema.shape)) {
+    stripped[field] = stripDefaultWrappers(value);
+  }
+
+  return stripped;
+};

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc -b

package/.turbo/turbo-lint.log

@@ -1,3 +0,0 @@
-$ oxlint ./src
-Found 0 warnings and 0 errors.
-Finished in 30ms on 60 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -1 +0,0 @@
-$ tsc --noEmit

package/dist/adapters.d.ts

@@ -1,39 +0,0 @@
-import type { Result } from './result.js';
-/** Options for search queries */
-export interface SearchOptions {
-    readonly limit?: number | undefined;
-    readonly offset?: number | undefined;
-    readonly filters?: Readonly<Record<string, unknown>> | undefined;
-}
-/** A single search hit */
-export interface SearchResult {
-    readonly id: string;
-    readonly score: number;
-    readonly document: Readonly<Record<string, unknown>>;
-}
-/** Options for storage writes */
-export interface StorageOptions {
-    /** Time-to-live in milliseconds */
-    readonly ttl?: number | undefined;
-}
-/** Full-text / vector index adapter */
-export interface IndexAdapter {
-    index(id: string, document: Readonly<Record<string, unknown>>): Promise<Result<void, Error>>;
-    search(query: string, options?: SearchOptions): Promise<Result<readonly SearchResult[], Error>>;
-    remove(id: string): Promise<Result<void, Error>>;
-}
-/** Key-value storage adapter */
-export interface StorageAdapter {
-    get(key: string): Promise<Result<unknown, Error>>;
-    set(key: string, value: unknown, options?: StorageOptions): Promise<Result<void, Error>>;
-    delete(key: string): Promise<Result<void, Error>>;
-    has(key: string): Promise<Result<boolean, Error>>;
-}
-/** Cache adapter with typed get/set and bulk clear */
-export interface CacheAdapter {
-    get<T>(key: string): Promise<Result<T | undefined, Error>>;
-    set<T>(key: string, value: T, options?: StorageOptions): Promise<Result<void, Error>>;
-    delete(key: string): Promise<Result<void, Error>>;
-    clear(): Promise<Result<void, Error>>;
-}
-//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAClE;AAED,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAMD,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,KAAK,CACH,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAEhC,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;CAClD;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;CACnD;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;CACvC"}

package/dist/adapters.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":""}

package/dist/blob-ref.d.ts

@@ -1,20 +0,0 @@
-/**
- * BlobRef — a frozen reference to binary data for @ontrails/core.
- */
-/** Immutable reference to a blob of binary data. */
-export interface BlobRef {
-    readonly name: string;
-    readonly mimeType: string;
-    readonly size: number;
-    readonly data: Uint8Array | ReadableStream<Uint8Array>;
-}
-/** Creates a frozen BlobRef. */
-export declare const createBlobRef: (options: {
-    name: string;
-    mimeType: string;
-    size: number;
-    data: Uint8Array | ReadableStream<Uint8Array>;
-}) => BlobRef;
-/** Type guard for BlobRef-shaped values. */
-export declare const isBlobRef: (value: unknown) => value is BlobRef;
-//# sourceMappingURL=blob-ref.d.ts.map

package/dist/blob-ref.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"blob-ref.d.ts","sourceRoot":"","sources":["../src/blob-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;CACxD;AAED,gCAAgC;AAChC,eAAO,MAAM,aAAa,GAAI,SAAS;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;CAC/C,KAAG,OAMA,CAAC;AAEL,4CAA4C;AAC5C,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAWnD,CAAC"}

package/dist/blob-ref.js

@@ -1,22 +0,0 @@
-/**
- * BlobRef — a frozen reference to binary data for @ontrails/core.
- */
-/** Creates a frozen BlobRef. */
-export const createBlobRef = (options) => Object.freeze({
-    data: options.data,
-    mimeType: options.mimeType,
-    name: options.name,
-    size: options.size,
-});
-/** Type guard for BlobRef-shaped values. */
-export const isBlobRef = (value) => {
-    if (typeof value !== 'object' || value === null) {
-        return false;
-    }
-    const obj = value;
-    return (typeof obj['name'] === 'string' &&
-        typeof obj['mimeType'] === 'string' &&
-        typeof obj['size'] === 'number' &&
-        (obj['data'] instanceof Uint8Array || obj['data'] instanceof ReadableStream));
-};
-//# sourceMappingURL=blob-ref.js.map

package/dist/blob-ref.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"blob-ref.js","sourceRoot":"","sources":["../src/blob-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,gCAAgC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAK7B,EAAW,EAAE,CACZ,MAAM,CAAC,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,IAAI,EAAE,OAAO,CAAC,IAAI;CACnB,CAAC,CAAC;AAEL,4CAA4C;AAC5C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;QACnC,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC/B,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,cAAc,CAAC,CAC7E,CAAC;AACJ,CAAC,CAAC"}

package/dist/branded.d.ts

@@ -1,36 +0,0 @@
-/**
- * Branded types and validated constructors for @ontrails/core.
- *
- * Branded types enforce domain constraints at the type level while remaining
- * plain primitives at runtime. Factory functions return Result so callers
- * handle validation failures explicitly.
- */
-import { ValidationError } from './errors.js';
-import type { Result } from './result.js';
-/** Attach a phantom tag to a base type. */
-export type Branded<T, Tag extends string> = T & {
-    readonly __brand: Tag;
-};
-/** Brand a value. No validation — use factory functions for safe construction. */
-export declare const brand: <T, Tag extends string>(_tag: Tag, value: T) => Branded<T, Tag>;
-/** Strip the brand and recover the underlying value. */
-export declare const unbrand: <T>(value: Branded<T, string>) => T;
-export type UUID = Branded<string, 'UUID'>;
-export type Email = Branded<string, 'Email'>;
-export type NonEmptyString = Branded<string, 'NonEmptyString'>;
-export type PositiveInt = Branded<number, 'PositiveInt'>;
-export declare const uuid: (value: string) => Result<UUID, ValidationError>;
-export declare const email: (value: string) => Result<Email, ValidationError>;
-export declare const nonEmptyString: (value: string) => Result<NonEmptyString, ValidationError>;
-export declare const positiveInt: (value: number) => Result<PositiveInt, ValidationError>;
-/**
- * Generate a random alphanumeric ID.
- * Runtime-agnostic: uses `crypto.getRandomValues`.
- */
-export declare const shortId: (length?: number) => string;
-/**
- * Produce a deterministic hex hash from an input string.
- * Uses a simple FNV-1a 32-bit hash — good enough for non-cryptographic IDs.
- */
-export declare const hashId: (input: string) => string;
-//# sourceMappingURL=branded.d.ts.map

package/dist/branded.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../src/branded.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,2CAA2C;AAC3C,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC;AAE3E,kFAAkF;AAClF,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,GAAG,SAAS,MAAM,EACzC,MAAM,GAAG,EACT,OAAO,CAAC,KACP,OAAO,CAAC,CAAC,EAAE,GAAG,CAA6B,CAAC;AAE/C,wDAAwD;AACxD,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,KAAG,CAAe,CAAC;AAMvE,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAezD,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,IAAI,EAAE,eAAe,CAShE,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,KAAK,EAAE,eAAe,CASlE,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,KACZ,MAAM,CAAC,cAAc,EAAE,eAAe,CAKxC,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,KACZ,MAAM,CAAC,WAAW,EAAE,eAAe,CASrC,CAAC;AASF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,eAAU,KAAG,MAWpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,KAAG,MAYtC,CAAC"}

package/dist/branded.js

@@ -1,89 +0,0 @@
-/**
- * Branded types and validated constructors for @ontrails/core.
- *
- * Branded types enforce domain constraints at the type level while remaining
- * plain primitives at runtime. Factory functions return Result so callers
- * handle validation failures explicitly.
- */
-import { ValidationError } from './errors.js';
-import { Result as R } from './result.js';
-/** Brand a value. No validation — use factory functions for safe construction. */
-export const brand = (_tag, value) => value;
-/** Strip the brand and recover the underlying value. */
-export const unbrand = (value) => value;
-// ---------------------------------------------------------------------------
-// Validation patterns
-// ---------------------------------------------------------------------------
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-// ---------------------------------------------------------------------------
-// Factory functions — each returns Result<BrandedType, ValidationError>
-// ---------------------------------------------------------------------------
-export const uuid = (value) => {
-    if (!UUID_RE.test(value)) {
-        return R.err(new ValidationError(`Invalid UUID: "${value}"`, {
-            context: { value },
-        }));
-    }
-    return R.ok(value);
-};
-export const email = (value) => {
-    if (!EMAIL_RE.test(value)) {
-        return R.err(new ValidationError(`Invalid email: "${value}"`, {
-            context: { value },
-        }));
-    }
-    return R.ok(value);
-};
-export const nonEmptyString = (value) => {
-    if (value.length === 0) {
-        return R.err(new ValidationError('String must not be empty'));
-    }
-    return R.ok(value);
-};
-export const positiveInt = (value) => {
-    if (!Number.isInteger(value) || value <= 0) {
-        return R.err(new ValidationError(`Expected positive integer, got ${value}`, {
-            context: { value },
-        }));
-    }
-    return R.ok(value);
-};
-// ---------------------------------------------------------------------------
-// ID utilities
-// ---------------------------------------------------------------------------
-const ALPHANUMERIC = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-/**
- * Generate a random alphanumeric ID.
- * Runtime-agnostic: uses `crypto.getRandomValues`.
- */
-export const shortId = (length = 8) => {
-    const bytes = new Uint8Array(length);
-    crypto.getRandomValues(bytes);
-    let id = '';
-    for (let i = 0; i < length; i += 1) {
-        const byte = bytes[i];
-        if (byte !== undefined) {
-            id += ALPHANUMERIC[byte % ALPHANUMERIC.length];
-        }
-    }
-    return id;
-};
-/**
- * Produce a deterministic hex hash from an input string.
- * Uses a simple FNV-1a 32-bit hash — good enough for non-cryptographic IDs.
- */
-export const hashId = (input) => {
-    // FNV offset basis
-    let hash = 2_166_136_261;
-    for (let i = 0; i < input.length; i += 1) {
-        // oxlint-disable-next-line no-bitwise -- FNV-1a hash requires XOR
-        hash ^= input.codePointAt(i) ?? 0;
-        // FNV prime
-        hash = Math.imul(hash, 0x01_00_01_93);
-    }
-    // Convert to unsigned 32-bit then hex
-    // oxlint-disable-next-line no-bitwise, prefer-math-trunc -- unsigned right shift needed for u32 conversion (Math.trunc differs semantically)
-    return (hash >>> 0).toString(16).padStart(8, '0');
-};
-//# sourceMappingURL=branded.js.map

package/dist/branded.js.map

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

package/dist/collections.d.ts

@@ -1,31 +0,0 @@
-/**
- * Collection utilities and type helpers for @ontrails/core.
- */
-/** Recursively make every property optional. */
-export type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-/** Flatten an intersection into a single object type for better IDE display. */
-export type Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-/** Require at least one property from T. */
-export type AtLeastOne<T> = {
-    [K in keyof T]-?: Pick<T, K> & Partial<Omit<T, K>>;
-}[keyof T];
-/** A tuple with at least one element. */
-export type NonEmptyArray<T> = [T, ...T[]];
-/** Narrows a readonly array to a NonEmptyArray. */
-export declare const isNonEmptyArray: <T>(array: readonly T[]) => array is NonEmptyArray<T>;
-/** Split an array into chunks of at most `size` elements. */
-export declare const chunk: <T>(array: readonly T[], size: number) => T[][];
-/**
- * Remove duplicate items. When `key` is provided, uniqueness is determined
- * by the return value of the key function; otherwise strict equality is used.
- */
-export declare const dedupe: <T>(array: readonly T[], key?: (item: T) => unknown) => T[];
-/** Group items by a string key. */
-export declare const groupBy: <T>(array: readonly T[], key: (item: T) => string) => Record<string, T[]>;
-/** Return a new sorted array based on a key function (ascending). */
-export declare const sortBy: <T>(array: readonly T[], key: (item: T) => string | number) => T[];
-//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,gFAAgF;AAEhF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,4CAA4C;AAC5C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACnD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,yCAAyC;AACzC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAM3C,mDAAmD;AACnD,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,OAAO,SAAS,CAAC,EAAE,KAClB,KAAK,IAAI,aAAa,CAAC,CAAC,CAAqB,CAAC;AAMjD,6DAA6D;AAC7D,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,SAAS,CAAC,EAAE,EAAE,MAAM,MAAM,KAAG,CAAC,EAAE,EAS/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,OAAO,SAAS,CAAC,EAAE,EACnB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,KACzB,CAAC,EAcH,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,OAAO,SAAS,CAAC,EAAE,EACnB,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,KACvB,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAOpB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,OAAO,SAAS,CAAC,EAAE,EACnB,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,KAChC,CAAC,EAQA,CAAC"}

package/dist/collections.js

@@ -1,60 +0,0 @@
-/**
- * Collection utilities and type helpers for @ontrails/core.
- */
-// ---------------------------------------------------------------------------
-// Guards
-// ---------------------------------------------------------------------------
-/** Narrows a readonly array to a NonEmptyArray. */
-export const isNonEmptyArray = (array) => array.length > 0;
-// ---------------------------------------------------------------------------
-// Collection functions
-// ---------------------------------------------------------------------------
-/** Split an array into chunks of at most `size` elements. */
-export const chunk = (array, size) => {
-    if (size < 1) {
-        throw new RangeError('chunk size must be >= 1');
-    }
-    const result = [];
-    for (let i = 0; i < array.length; i += size) {
-        result.push(array.slice(i, i + size));
-    }
-    return result;
-};
-/**
- * Remove duplicate items. When `key` is provided, uniqueness is determined
- * by the return value of the key function; otherwise strict equality is used.
- */
-export const dedupe = (array, key) => {
-    if (!key) {
-        return [...new Set(array)];
-    }
-    const seen = new Set();
-    const result = [];
-    for (const item of array) {
-        const k = key(item);
-        if (!seen.has(k)) {
-            seen.add(k);
-            result.push(item);
-        }
-    }
-    return result;
-};
-/** Group items by a string key. */
-export const groupBy = (array, key) => {
-    const groups = {};
-    for (const item of array) {
-        const k = key(item);
-        (groups[k] ??= []).push(item);
-    }
-    return groups;
-};
-/** Return a new sorted array based on a key function (ascending). */
-export const sortBy = (array, key) => [...array].toSorted((a, b) => {
-    const ka = key(a);
-    const kb = key(b);
-    if (typeof ka === 'number' && typeof kb === 'number') {
-        return ka - kb;
-    }
-    return String(ka).localeCompare(String(kb));
-});
-//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collections.js","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAmB,EACQ,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAEjD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,KAAmB,EAAE,IAAY,EAAS,EAAE;IACnE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,KAAmB,EACnB,GAA0B,EACrB,EAAE;IACP,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,KAAmB,EACnB,GAAwB,EACH,EAAE;IACvB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,KAAmB,EACnB,GAAiC,EAC5B,EAAE,CACP,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;IAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC"}

package/dist/context.d.ts

@@ -1,10 +0,0 @@
-import type { TrailContext } from './types.js';
-/**
- * Create a TrailContext with sensible defaults.
- *
- * - `requestId` defaults to `Bun.randomUUIDv7()` (sortable v7 UUID)
- * - `signal` defaults to a fresh, non-aborted `AbortSignal`
- * - All other fields come from `overrides`
- */
-export declare const createTrailContext: (overrides?: Partial<TrailContext>) => TrailContext;
-//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,OAAO,CAAC,YAAY,CAAC,KAChC,YAMD,CAAC"}

package/dist/context.js

@@ -1,15 +0,0 @@
-/**
- * Create a TrailContext with sensible defaults.
- *
- * - `requestId` defaults to `Bun.randomUUIDv7()` (sortable v7 UUID)
- * - `signal` defaults to a fresh, non-aborted `AbortSignal`
- * - All other fields come from `overrides`
- */
-export const createTrailContext = (overrides) => ({
-    cwd: process.cwd(),
-    env: process.env,
-    requestId: Bun.randomUUIDv7(),
-    signal: new AbortController().signal,
-    ...overrides,
-});
-//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAiC,EACnB,EAAE,CAAC,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,EAAE,OAAO,CAAC,GAAyC;IACtD,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE;IAC7B,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;IACpC,GAAG,SAAS;CACb,CAAC,CAAC"}