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

package/src/webhook.ts

@@ -0,0 +1,276 @@
+import type {
+  ActivationSource,
+  ActivationSourceMeta,
+  ActivationSourceParse,
+} from './activation-source.js';
+import { InternalError, ValidationError } from './errors.js';
+import { Result } from './result.js';
+
+export const webhookMethods = Object.freeze([
+  'DELETE',
+  'GET',
+  'PATCH',
+  'POST',
+  'PUT',
+] as const);
+
+export type WebhookMethod = (typeof webhookMethods)[number];
+export type WebhookMethodInput = WebhookMethod | Lowercase<WebhookMethod>;
+
+export type WebhookVerifyHeaders = Readonly<
+  Record<string, readonly string[] | string | undefined>
+>;
+
+export interface WebhookVerifyRequest {
+  readonly body: ArrayBuffer | Uint8Array | string;
+  readonly headers: WebhookVerifyHeaders;
+  readonly method: string;
+  readonly path: string;
+}
+
+export type WebhookVerify = (
+  request: WebhookVerifyRequest
+) => Promise<Result<void, Error>> | Result<void, Error>;
+
+export interface WebhookSpec<TOutput = unknown> {
+  readonly meta?: ActivationSourceMeta | undefined;
+  readonly method?: WebhookMethodInput | undefined;
+  readonly parse: ActivationSourceParse<TOutput>;
+  readonly path: string;
+  readonly payload?: ActivationSource['payload'] | undefined;
+  readonly verify?: WebhookVerify | undefined;
+}
+
+export interface WebhookSource<TOutput = unknown> extends ActivationSource {
+  readonly kind: 'webhook';
+  readonly meta?: ActivationSourceMeta | undefined;
+  readonly method: WebhookMethod;
+  readonly parse: ActivationSourceParse<TOutput>;
+  readonly path: string;
+  readonly payload?: ActivationSource['payload'] | undefined;
+  readonly verify?: WebhookVerify | undefined;
+}
+
+export interface WebhookValidationIssue {
+  readonly field: 'method' | 'parse' | 'path' | 'verify';
+  readonly message: string;
+}
+
+const DEFAULT_WEBHOOK_METHOD = 'POST' as const;
+
+const normalizeMethod = (
+  method: WebhookMethodInput | string | undefined
+): string => (method ?? DEFAULT_WEBHOOK_METHOD).trim().toUpperCase();
+
+const normalizePath = (path: string): string => path.trim();
+
+const isWebhookMethod = (method: string): method is WebhookMethod =>
+  (webhookMethods as readonly string[]).includes(method);
+
+const isObjectRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === 'object' && value !== null && !Array.isArray(value);
+
+const isZodSchema = (value: unknown): boolean =>
+  isObjectRecord(value) && typeof value['safeParse'] === 'function';
+
+const validateMethod = (
+  method: WebhookMethodInput | string | undefined
+): WebhookValidationIssue[] => {
+  const normalized = normalizeMethod(method);
+  return isWebhookMethod(normalized)
+    ? []
+    : [
+        {
+          field: 'method',
+          message: `Webhook method must be one of ${webhookMethods.join(', ')}`,
+        },
+      ];
+};
+
+const validatePath = (path: unknown): WebhookValidationIssue[] => {
+  if (typeof path !== 'string' || path.trim().length === 0) {
+    return [
+      {
+        field: 'path',
+        message: 'Webhook path must be a non-empty absolute path',
+      },
+    ];
+  }
+
+  const normalized = normalizePath(path);
+  return normalized.startsWith('/')
+    ? []
+    : [
+        {
+          field: 'path',
+          message: 'Webhook path must start with "/"',
+        },
+      ];
+};
+
+const validateRequiredParse = (parse: unknown): WebhookValidationIssue[] =>
+  parse === undefined
+    ? [
+        {
+          field: 'parse',
+          message: 'Webhook sources must define parse',
+        },
+      ]
+    : [];
+
+const validateParseShape = (parse: unknown): WebhookValidationIssue[] => {
+  if (parse === undefined || isZodSchema(parse)) {
+    return [];
+  }
+  if (isObjectRecord(parse) && isZodSchema(parse['output'])) {
+    return [];
+  }
+  return [
+    {
+      field: 'parse',
+      message: 'Webhook parse must be a Zod schema or define parse.output',
+    },
+  ];
+};
+
+const validateVerify = (verify: unknown): WebhookValidationIssue[] =>
+  verify === undefined || typeof verify === 'function'
+    ? []
+    : [
+        {
+          field: 'verify',
+          message: 'Webhook verify must be a function when provided',
+        },
+      ];
+
+const webhookIssuesMessage = (
+  id: string,
+  issues: readonly WebhookValidationIssue[]
+): string =>
+  `webhook("${id}") is invalid: ${issues.map((issue) => `${issue.field}: ${issue.message}`).join('; ')}`;
+
+const assertWebhookSpec = <TOutput>(
+  id: string,
+  spec: WebhookSpec<TOutput>
+): {
+  readonly method: WebhookMethod;
+  readonly path: string;
+} => {
+  const issues = [
+    ...validateMethod(spec.method),
+    ...validatePath(spec.path),
+    ...validateRequiredParse(spec.parse),
+    ...validateParseShape(spec.parse),
+    ...validateVerify(spec.verify),
+  ];
+
+  if (issues.length > 0) {
+    throw new ValidationError(webhookIssuesMessage(id, issues), {
+      context: { issues },
+    });
+  }
+
+  return {
+    method: normalizeMethod(spec.method) as WebhookMethod,
+    path: normalizePath(spec.path),
+  };
+};
+
+export const validateWebhookSource = (
+  source: ActivationSource
+): readonly WebhookValidationIssue[] => {
+  if (source.kind !== 'webhook') {
+    return [];
+  }
+
+  return [
+    ...validateMethod(source.method),
+    ...validatePath(source.path),
+    ...validateRequiredParse(source.parse),
+    ...validateParseShape(source.parse),
+    ...validateVerify(source.verify),
+  ];
+};
+
+const errorFromUnknown = (error: unknown): Error =>
+  error instanceof Error ? error : new Error(String(error));
+
+export const getWebhookHeaders = (
+  request: Pick<WebhookVerifyRequest, 'headers'>,
+  name: string
+): readonly string[] => {
+  const normalized = name.toLowerCase();
+  const matches: string[] = [];
+  for (const [headerName, value] of Object.entries(request.headers)) {
+    if (headerName.toLowerCase() !== normalized) {
+      continue;
+    }
+    if (value === undefined) {
+      continue;
+    }
+    if (typeof value === 'string') {
+      matches.push(value);
+    } else {
+      matches.push(...value);
+    }
+  }
+  return matches;
+};
+
+export const getWebhookHeader = (
+  request: Pick<WebhookVerifyRequest, 'headers'>,
+  name: string
+): string | undefined => {
+  const [first] = getWebhookHeaders(request, name);
+  return first;
+};
+
+export const verifyWebhookRequest = async (
+  source: Pick<WebhookSource, 'id' | 'verify'>,
+  request: WebhookVerifyRequest
+): Promise<Result<void, Error>> => {
+  if (source.verify === undefined) {
+    return Result.ok();
+  }
+
+  try {
+    return await source.verify(request);
+  } catch (error) {
+    const cause = errorFromUnknown(error);
+    return Result.err(
+      new InternalError(`Webhook source "${source.id}" verification threw`, {
+        cause,
+      })
+    );
+  }
+};
+
+export function webhook<TOutput>(
+  id: string,
+  spec: WebhookSpec<TOutput>
+): WebhookSource<TOutput>;
+export function webhook<TOutput>(
+  spec: WebhookSpec<TOutput> & { readonly id: string }
+): WebhookSource<TOutput>;
+export function webhook<TOutput>(
+  idOrSpec: string | (WebhookSpec<TOutput> & { readonly id: string }),
+  maybeSpec?: WebhookSpec<TOutput>
+): WebhookSource<TOutput> {
+  const id = typeof idOrSpec === 'string' ? idOrSpec : idOrSpec.id;
+  // oxlint-disable-next-line no-non-null-assertion -- overload guarantees maybeSpec when idOrSpec is string
+  const spec = typeof idOrSpec === 'string' ? maybeSpec! : idOrSpec;
+  const normalized = assertWebhookSpec(id, spec);
+
+  return Object.freeze({
+    id,
+    kind: 'webhook' as const,
+    method: normalized.method,
+    parse: spec.parse,
+    path: normalized.path,
+    ...(spec.meta === undefined
+      ? {}
+      : { meta: Object.freeze({ ...spec.meta }) }),
+    ...(spec.payload === undefined ? {} : { payload: spec.payload }),
+    ...(spec.verify === undefined ? {} : { verify: spec.verify }),
+  });
+}

package/src/workspace.ts

@@ -71,7 +71,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 60ms on 76 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"}