@ontrails/core 1.0.0-beta.0

package/dist/health.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Health check types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E"}

package/dist/hike.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Hike — a composition that follows trails.
+ */
+import type { Trail, TrailSpec } from './trail.js';
+export interface HikeSpec<I, O> extends TrailSpec<I, O> {
+    readonly follows: readonly string[];
+}
+export interface Hike<I, O> extends Omit<Trail<I, O>, 'kind'> {
+    readonly kind: 'hike';
+    readonly follows: readonly string[];
+}
+/**
+ * Create a hike definition.
+ *
+ * A hike is a composition that declares which trails it follows.
+ * Returns a frozen object with `kind: "hike"` and all spec fields.
+ *
+ * @example
+ * ```typescript
+ * // ID as first argument
+ * const onboard = hike("entity.onboard", {
+ *   follows: ["entity.add", "entity.relate"],
+ *   input: z.object({ name: z.string() }),
+ *   implementation: (input, ctx) => Result.ok(...),
+ * });
+ *
+ * // Full spec object (programmatic)
+ * const onboard = hike({ id: "entity.onboard", follows: [...], ... });
+ * ```
+ */
+export declare function hike<I, O>(id: string, spec: HikeSpec<I, O>): Hike<I, O>;
+export declare function hike<I, O>(spec: HikeSpec<I, O> & {
+    readonly id: string;
+}): Hike<I, O>;
+export type AnyHike = Hike<any, any>;
+//# sourceMappingURL=hike.d.ts.map

package/dist/hike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hike.d.ts","sourceRoot":"","sources":["../src/hike.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOnD,MAAM,WAAW,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAMD,MAAM,WAAW,IAAI,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzE,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EACvB,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7C,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AA0Bd,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC"}

package/dist/hike.js

@@ -0,0 +1,20 @@
+/**
+ * Hike — a composition that follows trails.
+ */
+export function hike(idOrSpec, maybeSpec) {
+    const resolved = typeof idOrSpec === 'string'
+        ? { id: idOrSpec, spec: maybeSpec }
+        : { id: idOrSpec.id, spec: idOrSpec };
+    if (!resolved.spec) {
+        throw new TypeError('hike() requires a spec when an id is provided');
+    }
+    const { follows, implementation, ...rest } = resolved.spec;
+    return Object.freeze({
+        ...rest,
+        follows: Object.freeze([...follows]),
+        id: resolved.id,
+        implementation: async (input, ctx) => await implementation(input, ctx),
+        kind: 'hike',
+    });
+}
+//# sourceMappingURL=hike.js.map

package/dist/hike.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hike.js","sourceRoot":"","sources":["../src/hike.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiDH,MAAM,UAAU,IAAI,CAClB,QAA6D,EAC7D,SAA0B;IAE1B,MAAM,QAAQ,GACZ,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;QACnC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAE1C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,IAAI;QACP,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QACpC,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,cAAc,EAAE,KAAK,EAAE,KAAQ,EAAE,GAAiB,EAAE,EAAE,CACpD,MAAM,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;QAClC,IAAI,EAAE,MAAe;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export { Result } from './result.js';
+export { TrailsError, ValidationError, AmbiguousError, AssertionError, NotFoundError, AlreadyExistsError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, AuthError, CancelledError, exitCodeMap, statusCodeMap, jsonRpcCodeMap, retryableMap, isRetryable, isTrailsError, } from './errors.js';
+export type { ErrorCategory } from './errors.js';
+export type { Implementation, TrailContext, FollowFn, ProgressCallback, ProgressEvent, Logger, Surface, } from './types.js';
+export { createTrailContext } from './context.js';
+export { trail } from './trail.js';
+export type { AnyTrail, Trail, TrailSpec, TrailExample } from './trail.js';
+export { hike } from './hike.js';
+export type { AnyHike, Hike, HikeSpec } from './hike.js';
+export { event } from './event.js';
+export type { AnyEvent, Event, EventSpec } from './event.js';
+export { topo } from './topo.js';
+export type { Topo } from './topo.js';
+export { validateTopo } from './validate-topo.js';
+export type { TopoIssue } from './validate-topo.js';
+export { composeLayers } from './layer.js';
+export type { Layer } from './layer.js';
+export type { HealthStatus, HealthResult } from './health.js';
+export type { IndexAdapter, StorageAdapter, CacheAdapter, SearchOptions, SearchResult, StorageOptions, } from './adapters.js';
+export { deriveFields } from './derive.js';
+export type { Field, FieldOverride } from './derive.js';
+export { validateInput, validateOutput, formatZodIssues, zodToJsonSchema, } from './validation.js';
+export { serializeError, deserializeError } from './serialization.js';
+export type { SerializedError } from './serialization.js';
+export { retry, withTimeout, shouldRetry, getBackoffDelay, } from './resilience.js';
+export type { RetryOptions } from './resilience.js';
+export { brand, unbrand, uuid, email, nonEmptyString, positiveInt, shortId, hashId, } from './branded.js';
+export type { Branded, UUID, Email, NonEmptyString, PositiveInt, } from './branded.js';
+export { securePath, isPathSafe, resolveSafePath } from './path-security.js';
+export { findWorkspaceRoot, isInsideWorkspace, getRelativePath, } from './workspace.js';
+export { isDefined, isNonEmptyString, isPlainObject, hasProperty, assertNever, } from './guards.js';
+export { chunk, dedupe, groupBy, sortBy, isNonEmptyArray, } from './collections.js';
+export type { NonEmptyArray, DeepPartial, Prettify, AtLeastOne, } from './collections.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,38 @@
+// Result
+export { Result } from './result.js';
+// Errors
+export { TrailsError, ValidationError, AmbiguousError, AssertionError, NotFoundError, AlreadyExistsError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, AuthError, CancelledError, exitCodeMap, statusCodeMap, jsonRpcCodeMap, retryableMap, isRetryable, isTrailsError, } from './errors.js';
+// Context factory
+export { createTrailContext } from './context.js';
+// Trail
+export { trail } from './trail.js';
+// Hike
+export { hike } from './hike.js';
+// Event
+export { event } from './event.js';
+// Topo
+export { topo } from './topo.js';
+// Topo validation
+export { validateTopo } from './validate-topo.js';
+// Layer
+export { composeLayers } from './layer.js';
+// Derive
+export { deriveFields } from './derive.js';
+// Validation
+export { validateInput, validateOutput, formatZodIssues, zodToJsonSchema, } from './validation.js';
+// Serialization
+export { serializeError, deserializeError } from './serialization.js';
+// Resilience
+export { retry, withTimeout, shouldRetry, getBackoffDelay, } from './resilience.js';
+// Fetch — fromFetch is available as Result.fromFetch()
+// Branded types
+export { brand, unbrand, uuid, email, nonEmptyString, positiveInt, shortId, hashId, } from './branded.js';
+// Path Security
+export { securePath, isPathSafe, resolveSafePath } from './path-security.js';
+// Workspace
+export { findWorkspaceRoot, isInsideWorkspace, getRelativePath, } from './workspace.js';
+// Guards
+export { isDefined, isNonEmptyString, isPlainObject, hasProperty, assertNever, } from './guards.js';
+// Collections
+export { chunk, dedupe, groupBy, sortBy, isNonEmptyArray, } from './collections.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,SAAS;AACT,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAcrB,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO;AACP,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO;AACP,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgB3C,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,aAAa;AACb,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtE,aAAa;AACb,OAAO,EACL,KAAK,EACL,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,uDAAuD;AAEvD,gBAAgB;AAChB,OAAO,EACL,KAAK,EACL,OAAO,EACP,IAAI,EACJ,KAAK,EACL,cAAc,EACd,WAAW,EACX,OAAO,EACP,MAAM,GACP,MAAM,cAAc,CAAC;AAStB,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE7E,YAAY;AACZ,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,SAAS;AACT,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EACL,KAAK,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/job.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * Proof: job-style output schema composes from existing pattern helpers.
+ * No dedicated `kind: "job"` needed — regular trails with status+progress output work.
+ */
+export declare const jobOutputSchema: z.ZodObject<{
+    completedAt: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    jobId: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    current: z.ZodNumber;
+    percentage: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type JobOutput = z.infer<typeof jobOutputSchema>;
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;iBAQ1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/job.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { progressFields } from './patterns/progress.js';
+import { statusFields } from './patterns/status.js';
+/**
+ * Proof: job-style output schema composes from existing pattern helpers.
+ * No dedicated `kind: "job"` needed — regular trails with status+progress output work.
+ */
+export const jobOutputSchema = z.object({
+    ...progressFields().shape,
+    ...statusFields().shape,
+    completedAt: z.string().optional(),
+    error: z.string().optional(),
+    jobId: z.string(),
+    result: z.unknown().optional(),
+    startedAt: z.string().optional(),
+});
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,cAAc,EAAE,CAAC,KAAK;IACzB,GAAG,YAAY,EAAE,CAAC,KAAK;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/layer.d.ts

@@ -0,0 +1,17 @@
+import type { Trail } from './trail.js';
+import type { Implementation } from './types.js';
+/** A composable middleware that wraps trail implementations */
+export interface Layer {
+    readonly name: string;
+    readonly description?: string | undefined;
+    /** Wrap a trail's implementation, returning a new implementation */
+    wrap<I, O>(trail: Trail<I, O>, implementation: Implementation<I, O>): Implementation<I, O>;
+}
+/**
+ * Apply layers outermost-first: layers[0] wraps layers[1] wraps ... wraps
+ * the base implementation.
+ *
+ * An empty layers array returns the implementation unchanged.
+ */
+export declare const composeLayers: <I, O>(layers: readonly Layer[], trail: Trail<I, O>, implementation: Implementation<I, O>) => Implementation<I, O>;
+//# sourceMappingURL=layer.d.ts.map

package/dist/layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,+DAA+D;AAC/D,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1C,oEAAoE;IACpE,IAAI,CAAC,CAAC,EAAE,CAAC,EACP,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,cAAc,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GACnC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACzB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAChC,QAAQ,SAAS,KAAK,EAAE,EACxB,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,gBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KACnC,cAAc,CAAC,CAAC,EAAE,CAAC,CAUrB,CAAC"}

package/dist/layer.js

@@ -0,0 +1,21 @@
+// ---------------------------------------------------------------------------
+// Composition
+// ---------------------------------------------------------------------------
+/**
+ * Apply layers outermost-first: layers[0] wraps layers[1] wraps ... wraps
+ * the base implementation.
+ *
+ * An empty layers array returns the implementation unchanged.
+ */
+export const composeLayers = (layers, trail, implementation) => {
+    // Fold right so layers[0] is the outermost wrapper
+    let result = implementation;
+    for (let i = layers.length - 1; i >= 0; i -= 1) {
+        const layer = layers[i];
+        if (layer) {
+            result = layer.wrap(trail, result);
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=layer.js.map

package/dist/layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.js","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAmBA,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAwB,EACxB,KAAkB,EAClB,cAAoC,EACd,EAAE;IACxB,mDAAmD;IACnD,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/path-security.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Path security utilities for preventing path traversal attacks.
+ *
+ * All functions are runtime-agnostic (Node / Bun compatible).
+ */
+import { PermissionError } from './errors.js';
+import { Result } from './result.js';
+/**
+ * Resolves `userPath` relative to `basePath` and ensures it stays within
+ * the base directory. Returns the resolved absolute path on success, or a
+ * `PermissionError` if the path escapes.
+ *
+ * Uses lexical path comparison (not `realpath`). Does not follow symlinks —
+ * if an attacker can create symlinks inside `basePath`, those could point
+ * outside the base. Use `realpath` before calling in symlink-sensitive environments.
+ */
+export declare const securePath: (basePath: string, userPath: string) => Result<string, PermissionError>;
+/**
+ * Returns `true` if `userPath` (resolved against `basePath`) stays within
+ * `basePath`.
+ */
+export declare const isPathSafe: (basePath: string, userPath: string) => boolean;
+/**
+ * Joins multiple path segments, resolves them against `basePath`, and
+ * validates the result stays within the base directory.
+ */
+export declare const resolveSafePath: (basePath: string, ...segments: string[]) => Result<string, PermissionError>;
+//# sourceMappingURL=path-security.d.ts.map

package/dist/path-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,EAAE,eAAe,CAgBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,OAI/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,GAAG,UAAU,MAAM,EAAE,KACpB,MAAM,CAAC,MAAM,EAAE,eAAe,CAchC,CAAC"}

package/dist/path-security.js

@@ -0,0 +1,63 @@
+/**
+ * Path security utilities for preventing path traversal attacks.
+ *
+ * All functions are runtime-agnostic (Node / Bun compatible).
+ */
+import { resolve, relative, normalize, isAbsolute } from 'node:path';
+import { PermissionError } from './errors.js';
+import { Result } from './result.js';
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+/** Returns true when `target` is equal to or a descendant of `base`. */
+const isWithin = (base, target) => {
+    const rel = relative(base, target);
+    // Empty string means they are the same directory.
+    // A relative path starting with ".." means it escapes.
+    // An absolute path means a completely different tree.
+    return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolves `userPath` relative to `basePath` and ensures it stays within
+ * the base directory. Returns the resolved absolute path on success, or a
+ * `PermissionError` if the path escapes.
+ *
+ * Uses lexical path comparison (not `realpath`). Does not follow symlinks —
+ * if an attacker can create symlinks inside `basePath`, those could point
+ * outside the base. Use `realpath` before calling in symlink-sensitive environments.
+ */
+export const securePath = (basePath, userPath) => {
+    const base = resolve(basePath);
+    const resolved = resolve(base, userPath);
+    if (!isWithin(base, resolved)) {
+        return Result.err(new PermissionError(`Path traversal detected: "${userPath}" escapes "${basePath}"`, {
+            context: { basePath: base, resolved, userPath },
+        }));
+    }
+    return Result.ok(resolved);
+};
+/**
+ * Returns `true` if `userPath` (resolved against `basePath`) stays within
+ * `basePath`.
+ */
+export const isPathSafe = (basePath, userPath) => {
+    const base = resolve(basePath);
+    const resolved = resolve(base, userPath);
+    return isWithin(base, resolved);
+};
+/**
+ * Joins multiple path segments, resolves them against `basePath`, and
+ * validates the result stays within the base directory.
+ */
+export const resolveSafePath = (basePath, ...segments) => {
+    const base = resolve(basePath);
+    const joined = resolve(base, ...segments.map((s) => normalize(s)));
+    if (!isWithin(base, joined)) {
+        return Result.err(new PermissionError(`Path traversal detected: segments escape "${basePath}"`, { context: { basePath: base, resolved: joined, segments } }));
+    }
+    return Result.ok(joined);
+};
+//# sourceMappingURL=path-security.js.map

package/dist/path-security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-security.js","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,wEAAwE;AACxE,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAc,EAAW,EAAE;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,kDAAkD;IAClD,uDAAuD;IACvD,sDAAsD;IACtD,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,QAAgB,EACiB,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6BAA6B,QAAQ,cAAc,QAAQ,GAAG,EAC9D;YACE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAChD,CACF,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAW,EAAE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAgB,EAChB,GAAG,QAAkB,EACY,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6CAA6C,QAAQ,GAAG,EACxD,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAC5D,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/patterns/bulk.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bulk operation schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Bulk operation output wrapper for a given item schema. */
+export declare const bulkOutput: <T>(itemSchema: z.ZodType<T>) => z.ZodObject<{
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+    failed: z.ZodNumber;
+    items: z.ZodArray<z.ZodType<T, unknown, z.core.$ZodTypeInternals<T, unknown>>>;
+    succeeded: z.ZodNumber;
+}, z.core.$strip>;
+//# sourceMappingURL=bulk.d.ts.map

package/dist/patterns/bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../src/patterns/bulk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6DAA6D;AAC7D,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;iBAQlD,CAAC"}

package/dist/patterns/bulk.js

@@ -0,0 +1,14 @@
+/**
+ * Bulk operation schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Bulk operation output wrapper for a given item schema. */
+export const bulkOutput = (itemSchema) => z.object({
+    errors: z
+        .array(z.object({ index: z.number(), message: z.string() }))
+        .optional(),
+    failed: z.number(),
+    items: z.array(itemSchema),
+    succeeded: z.number(),
+});
+//# sourceMappingURL=bulk.js.map

package/dist/patterns/bulk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.js","sourceRoot":"","sources":["../../src/patterns/bulk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,UAAwB,EAAE,EAAE,CACxD,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SAC3D,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}

package/dist/patterns/change.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Change-tracking schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Before/after change output for a given schema. */
+export declare const changeOutput: <T>(schema: z.ZodType<T>) => z.ZodObject<{
+    after: z.ZodType<T, unknown, z.core.$ZodTypeInternals<T, unknown>>;
+    before: z.ZodOptional<z.ZodType<T, unknown, z.core.$ZodTypeInternals<T, unknown>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=change.d.ts.map

package/dist/patterns/change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../src/patterns/change.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qDAAqD;AACrD,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;;;iBAIhD,CAAC"}

package/dist/patterns/change.js

@@ -0,0 +1,10 @@
+/**
+ * Change-tracking schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Before/after change output for a given schema. */
+export const changeOutput = (schema) => z.object({
+    after: schema,
+    before: schema.optional(),
+});
+//# sourceMappingURL=change.js.map

package/dist/patterns/change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.js","sourceRoot":"","sources":["../../src/patterns/change.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAI,MAAoB,EAAE,EAAE,CACtD,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;CAC1B,CAAC,CAAC"}

package/dist/patterns/date-range.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Date-range schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Optional since/until date-range fields. */
+export declare const dateRangeFields: () => z.ZodObject<{
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=date-range.d.ts.map

package/dist/patterns/date-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range.d.ts","sourceRoot":"","sources":["../../src/patterns/date-range.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8CAA8C;AAC9C,eAAO,MAAM,eAAe;;;iBAIxB,CAAC"}

package/dist/patterns/date-range.js

@@ -0,0 +1,10 @@
+/**
+ * Date-range schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Optional since/until date-range fields. */
+export const dateRangeFields = () => z.object({
+    since: z.string().optional(),
+    until: z.string().optional(),
+});
+//# sourceMappingURL=date-range.js.map

package/dist/patterns/date-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range.js","sourceRoot":"","sources":["../../src/patterns/date-range.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAClC,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/dist/patterns/index.d.ts

@@ -0,0 +1,9 @@
+export { paginationFields, paginatedOutput } from './pagination.js';
+export { bulkOutput } from './bulk.js';
+export { timestampFields } from './timestamps.js';
+export { dateRangeFields } from './date-range.js';
+export { sortFields } from './sorting.js';
+export { statusFields } from './status.js';
+export { changeOutput } from './change.js';
+export { progressFields } from './progress.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/patterns/index.js

@@ -0,0 +1,9 @@
+export { paginationFields, paginatedOutput } from './pagination.js';
+export { bulkOutput } from './bulk.js';
+export { timestampFields } from './timestamps.js';
+export { dateRangeFields } from './date-range.js';
+export { sortFields } from './sorting.js';
+export { statusFields } from './status.js';
+export { changeOutput } from './change.js';
+export { progressFields } from './progress.js';
+//# sourceMappingURL=index.js.map

package/dist/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/patterns/pagination.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pagination schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Common pagination input fields. */
+export declare const paginationFields: () => z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/** Paginated output wrapper for a given item schema. */
+export declare const paginatedOutput: <T>(itemSchema: z.ZodType<T>) => z.ZodObject<{
+    hasMore: z.ZodBoolean;
+    items: z.ZodArray<z.ZodType<T, unknown, z.core.$ZodTypeInternals<T, unknown>>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/patterns/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/patterns/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;iBAKzB,CAAC;AAEL,wDAAwD;AACxD,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;iBAMvD,CAAC"}

package/dist/patterns/pagination.js

@@ -0,0 +1,18 @@
+/**
+ * Pagination schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Common pagination input fields. */
+export const paginationFields = () => z.object({
+    cursor: z.string().optional(),
+    limit: z.number().optional().default(20),
+    offset: z.number().optional().default(0),
+});
+/** Paginated output wrapper for a given item schema. */
+export const paginatedOutput = (itemSchema) => z.object({
+    hasMore: z.boolean(),
+    items: z.array(itemSchema),
+    nextCursor: z.string().optional(),
+    total: z.number(),
+});
+//# sourceMappingURL=pagination.js.map

package/dist/patterns/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/patterns/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CACnC,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CACzC,CAAC,CAAC;AAEL,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,UAAwB,EAAE,EAAE,CAC7D,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC"}

package/dist/patterns/progress.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Progress schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Progress tracking fields. */
+export declare const progressFields: () => z.ZodObject<{
+    current: z.ZodNumber;
+    percentage: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/patterns/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/patterns/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gCAAgC;AAChC,eAAO,MAAM,cAAc;;;;iBAKvB,CAAC"}

package/dist/patterns/progress.js

@@ -0,0 +1,11 @@
+/**
+ * Progress schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Progress tracking fields. */
+export const progressFields = () => z.object({
+    current: z.number(),
+    percentage: z.number().optional(),
+    total: z.number(),
+});
+//# sourceMappingURL=progress.js.map

package/dist/patterns/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/patterns/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gCAAgC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CACjC,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC"}

package/dist/patterns/sorting.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sorting schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Sort fields constrained to a set of allowed column names. */
+export declare const sortFields: <const T extends string>(allowedFields: [T, ...T[]]) => z.ZodObject<{
+    sortBy: z.ZodOptional<z.ZodEnum<{ [k_1 in T]: k_1; } extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never>>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=sorting.d.ts.map

package/dist/patterns/sorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../../src/patterns/sorting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gEAAgE;AAChE,eAAO,MAAM,UAAU,GAAI,KAAK,CAAC,CAAC,SAAS,MAAM,EAC/C,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;;;;;;iBAKxB,CAAC"}

package/dist/patterns/sorting.js

@@ -0,0 +1,10 @@
+/**
+ * Sorting schema helpers for @ontrails/core/patterns
+ */
+import { z } from 'zod';
+/** Sort fields constrained to a set of allowed column names. */
+export const sortFields = (allowedFields) => z.object({
+    sortBy: z.enum(allowedFields).optional(),
+    sortOrder: z.enum(['asc', 'desc']).optional().default('asc'),
+});
+//# sourceMappingURL=sorting.js.map

package/dist/patterns/sorting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorting.js","sourceRoot":"","sources":["../../src/patterns/sorting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,aAA0B,EAC1B,EAAE,CACF,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7D,CAAC,CAAC"}