@ontrails/core 1.0.0-beta.2 → 1.0.0-beta.21

package/src/adapters.ts

@@ -1,68 +0,0 @@
-import type { Result } from './result.js';
-
-// ---------------------------------------------------------------------------
-// Shared option types
-// ---------------------------------------------------------------------------
-
-/** 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;
-}
-
-// ---------------------------------------------------------------------------
-// Adapter port interfaces
-// ---------------------------------------------------------------------------
-
-/** 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>>;
-}

package/src/event.ts

@@ -1,77 +0,0 @@
-/**
- * Event — a named payload schema with optional provenance metadata.
- */
-
-import type { z } from 'zod';
-
-// ---------------------------------------------------------------------------
-// Spec (input to the factory)
-// ---------------------------------------------------------------------------
-
-export interface EventSpec<T> {
-  readonly payload: z.ZodType<T>;
-  readonly description?: string | undefined;
-  readonly markers?: Readonly<Record<string, unknown>> | undefined;
-  /** Trail IDs that produce this event (e.g. the trails it originates from). */
-  readonly from?: readonly string[] | undefined;
-}
-
-// ---------------------------------------------------------------------------
-// Shape (output of the factory)
-// ---------------------------------------------------------------------------
-
-export interface Event<T> {
-  readonly id: string;
-  readonly kind: 'event';
-  readonly payload: z.ZodType<T>;
-  readonly description?: string | undefined;
-  readonly markers?: Readonly<Record<string, unknown>> | undefined;
-  /** Trail IDs that produce this event (e.g. the trails it originates from). */
-  readonly from?: readonly string[] | undefined;
-}
-
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-
-/**
- * Create an event definition.
- *
- * An event is a named payload schema describing something that happened.
- * Returns a frozen object with `kind: "event"` and all spec fields.
- *
- * @example
- * ```typescript
- * // ID as first argument
- * const updated = event("entity.updated", {
- *   payload: EntityUpdatedSchema,
- *   from: ["entity.add", "entity.update"],
- * });
- *
- * // Full spec object (programmatic)
- * const updated = event({ id: "entity.updated", payload: ..., from: [...] });
- * ```
- */
-export function event<T>(id: string, spec: EventSpec<T>): Event<T>;
-export function event<T>(
-  spec: EventSpec<T> & { readonly id: string }
-): Event<T>;
-export function event<T>(
-  idOrSpec: string | (EventSpec<T> & { readonly id: string }),
-  maybeSpec?: EventSpec<T>
-): Event<T> {
-  const resolvedId = typeof idOrSpec === 'string' ? idOrSpec : idOrSpec.id;
-  // oxlint-disable-next-line no-non-null-assertion -- overload guarantees maybeSpec when idOrSpec is string
-  const resolvedSpec = typeof idOrSpec === 'string' ? maybeSpec! : idOrSpec;
-  return Object.freeze({
-    description: resolvedSpec.description,
-    from: resolvedSpec.from ? Object.freeze([...resolvedSpec.from]) : undefined,
-    id: resolvedId,
-    kind: 'event' as const,
-    markers: resolvedSpec.markers,
-    payload: resolvedSpec.payload,
-  });
-}
-
-/** Existential type for heterogeneous event collections */
-export type AnyEvent = Event<unknown>;

package/src/health.ts

@@ -1,23 +0,0 @@
-// ---------------------------------------------------------------------------
-// Health check types
-// ---------------------------------------------------------------------------
-
-/** Aggregate health status */
-export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy';
-
-/** Individual component check result */
-export interface HealthCheck {
-  readonly status: HealthStatus;
-  readonly message?: string | undefined;
-  /** Latency in milliseconds */
-  readonly latency?: number | undefined;
-}
-
-/** Full health report returned by a health endpoint */
-export interface HealthResult {
-  readonly status: HealthStatus;
-  readonly checks: Readonly<Record<string, HealthCheck>>;
-  readonly version?: string | undefined;
-  /** Uptime in seconds */
-  readonly uptime?: number | undefined;
-}

package/src/hike.ts

@@ -1,77 +0,0 @@
-/**
- * Hike — a composition that follows trails.
- */
-
-import type { Trail, TrailSpec } from './trail.js';
-import type { TrailContext } from './types.js';
-
-// ---------------------------------------------------------------------------
-// Spec (input to the factory)
-// ---------------------------------------------------------------------------
-
-export interface HikeSpec<I, O> extends TrailSpec<I, O> {
-  readonly follows: readonly string[];
-}
-
-// ---------------------------------------------------------------------------
-// Shape (output of the factory)
-// ---------------------------------------------------------------------------
-
-export interface Hike<I, O> extends Omit<Trail<I, O>, 'kind'> {
-  readonly kind: 'hike';
-  readonly follows: readonly string[];
-}
-
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-
-/**
- * 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 function hike<I, O>(id: string, spec: HikeSpec<I, O>): Hike<I, O>;
-export function hike<I, O>(
-  spec: HikeSpec<I, O> & { readonly id: string }
-): Hike<I, O>;
-export function hike<I, O>(
-  idOrSpec: string | (HikeSpec<I, O> & { readonly id: string }),
-  maybeSpec?: HikeSpec<I, O>
-): Hike<I, O> {
-  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: I, ctx: TrailContext) =>
-      await implementation(input, ctx),
-    kind: 'hike' as const,
-  });
-}
-
-// oxlint-disable-next-line no-explicit-any -- existential type; see AnyTrail
-export type AnyHike = Hike<any, any>;

package/src/job.ts

@@ -1,20 +0,0 @@
-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(),
-});
-
-export type JobOutput = z.infer<typeof jobOutputSchema>;

package/tsconfig.json

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

package/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["./src/adapters.ts","./src/blob-ref.ts","./src/branded.ts","./src/collections.ts","./src/context.ts","./src/derive.ts","./src/errors.ts","./src/event.ts","./src/fetch.ts","./src/guards.ts","./src/health.ts","./src/hike.ts","./src/index.ts","./src/job.ts","./src/layer.ts","./src/path-security.ts","./src/resilience.ts","./src/result.ts","./src/serialization.ts","./src/topo.ts","./src/trail.ts","./src/types.ts","./src/validate-topo.ts","./src/validation.ts","./src/workspace.ts","./src/patterns/bulk.ts","./src/patterns/change.ts","./src/patterns/date-range.ts","./src/patterns/index.ts","./src/patterns/pagination.ts","./src/patterns/progress.ts","./src/patterns/sorting.ts","./src/patterns/status.ts","./src/patterns/timestamps.ts","./src/redaction/index.ts","./src/redaction/patterns.ts","./src/redaction/redactor.ts"],"version":"5.9.3"}