@ontrails/core 1.0.0-beta.13 → 1.0.0-beta.15

package/dist/trails/derive-trail.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import type { AnyContour } from '../contour.js';
+import type { AnyResource } from '../resource.js';
+import type { Trail, TrailSpec } from '../trail.js';
+import type { Implementation } from '../types.js';
+/**
+ * CRUD-shaped operations the base trail derivation helper understands.
+ */
+export type DeriveTrailOperation = 'create' | 'read' | 'update' | 'delete' | 'list';
+type ContourInput<TContour extends AnyContour> = z.input<TContour>;
+type ContourOutput<TContour extends AnyContour> = z.output<TContour>;
+type ContourFieldKey<TContour extends AnyContour> = Extract<keyof ContourOutput<TContour>, string>;
+type IdentityKey<TContour extends AnyContour> = Extract<TContour['identity'], keyof ContourInput<TContour> & string>;
+type GeneratedKey<TContour extends AnyContour, TGenerated extends readonly ContourFieldKey<TContour>[] | undefined> = TGenerated extends readonly ContourFieldKey<TContour>[] ? TGenerated[number] : never;
+type CreateInputOf<TContour extends AnyContour, TGenerated extends readonly ContourFieldKey<TContour>[] | undefined> = Omit<ContourInput<TContour>, Extract<GeneratedKey<TContour, TGenerated>, keyof ContourInput<TContour>>>;
+type ReadInputOf<TContour extends AnyContour> = Pick<ContourInput<TContour>, IdentityKey<TContour>>;
+type UpdateInputOf<TContour extends AnyContour, TGenerated extends readonly ContourFieldKey<TContour>[] | undefined> = ReadInputOf<TContour> & Partial<Omit<CreateInputOf<TContour, TGenerated>, IdentityKey<TContour>>>;
+type ListInputOf<TContour extends AnyContour> = Partial<ContourInput<TContour>>;
+/**
+ * Input shape derived for one operation against one contour.
+ */
+export type DeriveTrailInput<TContour extends AnyContour, TOperation extends DeriveTrailOperation, TGenerated extends readonly ContourFieldKey<TContour>[] | undefined = readonly ContourFieldKey<TContour>[] | undefined> = TOperation extends 'create' ? CreateInputOf<TContour, TGenerated> : TOperation extends 'read' | 'delete' ? ReadInputOf<TContour> : TOperation extends 'update' ? UpdateInputOf<TContour, TGenerated> : ListInputOf<TContour>;
+/**
+ * Output shape derived for one operation against one contour.
+ */
+export type DeriveTrailOutput<TContour extends AnyContour, TOperation extends DeriveTrailOperation> = TOperation extends 'delete' ? undefined : TOperation extends 'list' ? ContourOutput<TContour>[] : ContourOutput<TContour>;
+/**
+ * Extra authored data accepted by `deriveTrail()` in addition to the
+ * operation-derived contract pieces.
+ *
+ * `blaze` is optional for single-resource calls: when omitted, the helper
+ * synthesizes a default blaze that delegates to the resource's accessor via
+ * the structural {@link StoreAccessorProtocol}. When multiple resources are
+ * declared, an explicit `blaze` is required.
+ */
+export interface DeriveTrailSpec<TContour extends AnyContour, TOperation extends DeriveTrailOperation, TGenerated extends readonly ContourFieldKey<TContour>[] | undefined = readonly ContourFieldKey<TContour>[] | undefined> extends Omit<TrailSpec<DeriveTrailInput<TContour, TOperation, TGenerated>, DeriveTrailOutput<TContour, TOperation>>, 'blaze' | 'contours' | 'examples' | 'input' | 'intent' | 'output' | 'resources'> {
+    /**
+     * Implementation of the trail. Optional for single-resource calls: when
+     * omitted, the helper derives a default blaze from the resource accessor
+     * for standard CRUD operations.
+     */
+    readonly blaze?: Implementation<DeriveTrailInput<TContour, TOperation, TGenerated>, DeriveTrailOutput<TContour, TOperation>>;
+    /**
+     * Server-managed fields that should not be writable through derived create
+     * and update inputs.
+     */
+    readonly generated?: TGenerated;
+    /**
+     * Resource dependency declared on the derived trail. Pass a single
+     * resource for default-blaze synthesis, or an array for multi-resource
+     * trails that must provide an explicit `blaze`.
+     */
+    readonly resource: AnyResource | readonly AnyResource[];
+}
+/**
+ * Mechanically project one CRUD-shaped trail from a contour declaration.
+ *
+ * When `spec.blaze` is omitted and the call declares a single resource, the
+ * helper derives a default blaze that dispatches to the resource accessor
+ * through the structural {@link StoreAccessorProtocol}. Multi-resource calls
+ * must supply an explicit blaze and are rejected with {@link DerivationError}
+ * at construction time when they do not.
+ */
+export declare const deriveTrail: <TContour extends AnyContour, TOperation extends DeriveTrailOperation, TGenerated extends readonly ContourFieldKey<TContour>[] | undefined = readonly ContourFieldKey<TContour>[] | undefined>(contour: TContour, operation: TOperation, spec: DeriveTrailSpec<TContour, TOperation, TGenerated>) => Trail<DeriveTrailInput<TContour, TOperation, TGenerated>, DeriveTrailOutput<TContour, TOperation>>;
+export {};
+//# sourceMappingURL=derive-trail.d.ts.map

package/dist/trails/derive-trail.d.ts.map

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

package/dist/trails/derive-trail.js

@@ -0,0 +1,378 @@
+import { z } from 'zod';
+import { DerivationError, InternalError, isTrailsError, NotFoundError, } from '../errors.js';
+import { stripDefaultsFromShape } from '../internal/zod-wrappers.js';
+import { Result } from '../result.js';
+import { trail } from '../trail.js';
+const operationIntent = {
+    create: 'write',
+    delete: 'destroy',
+    list: 'read',
+    read: 'read',
+    update: 'write',
+};
+const describeDeriveTrailResourceDeclaration = (resourceCount) => resourceCount === 0
+    ? 'no resources are declared'
+    : 'multiple resources are declared';
+const titleCase = (value) => value.length === 0 ? value : value.slice(0, 1).toUpperCase() + value.slice(1);
+const uniqueStrings = (values) => Object.freeze([...(values === undefined ? [] : new Set(values))]);
+const buildFieldMask = (fields) => Object.fromEntries(fields.map((field) => [field, true]));
+const asObjectSchema = (schema) => schema;
+const unsupportedOperation = (operation) => {
+    throw new DerivationError(`Unsupported deriveTrail() operation: ${String(operation)}`);
+};
+const omitFields = (schema, fields) => {
+    const objectSchema = asObjectSchema(schema);
+    return fields.length === 0
+        ? objectSchema
+        : objectSchema.omit(buildFieldMask(fields));
+};
+const pickFields = (schema, fields) => asObjectSchema(schema).pick(buildFieldMask(fields));
+const toPartialSchema = (schema) => asObjectSchema(schema)
+    .extend(stripDefaultsFromShape(schema))
+    .partial();
+const normalizeResources = (resource) => Object.freeze(Array.isArray(resource) ? [...resource] : [resource]);
+const identityInputSchema = (contour) => pickFields(contour, [contour.identity]);
+const createInputSchema = (contour, generated) => omitFields(contour, generated);
+const updateInputSchema = (contour, generated) => {
+    const mutableSchema = omitFields(contour, [...generated, contour.identity]);
+    const identitySchema = asObjectSchema(identityInputSchema(contour));
+    return identitySchema.extend(toPartialSchema(mutableSchema).shape);
+};
+const listInputSchema = (contour) => toPartialSchema(contour);
+const deriveInputSchema = (contour, operation, generated) => {
+    switch (operation) {
+        case 'create': {
+            return createInputSchema(contour, generated);
+        }
+        case 'read':
+        case 'delete': {
+            return identityInputSchema(contour);
+        }
+        case 'update': {
+            return updateInputSchema(contour, generated);
+        }
+        case 'list': {
+            return listInputSchema(contour);
+        }
+        default: {
+            return unsupportedOperation(operation);
+        }
+    }
+};
+const deriveOutputSchema = (contour, operation) => {
+    switch (operation) {
+        case 'delete': {
+            return z.void();
+        }
+        case 'list': {
+            return contour.array();
+        }
+        case 'create':
+        case 'read':
+        case 'update': {
+            return contour;
+        }
+        default: {
+            return unsupportedOperation(operation);
+        }
+    }
+};
+const pickValueFields = (example, fields) => Object.fromEntries(fields.flatMap((field) => Object.hasOwn(example, field) ? [[field, example[field]]] : []));
+const omitValueFields = (example, fields) => {
+    const omitted = new Set(fields);
+    return Object.fromEntries(Object.entries(example).filter(([field]) => !omitted.has(field)));
+};
+const formatExampleName = (contour, operation, example, index) => {
+    const identifier = example[contour.identity];
+    const suffix = identifier === undefined ? String(index + 1) : String(identifier);
+    return `${titleCase(operation)} ${contour.name} ${suffix}`;
+};
+/**
+ * Derive a single trail example from a contour fixture.
+ *
+ * @remarks
+ * For `list` operations, each derived example wraps a single fixture in an
+ * array (`expected: [example]`) and uses the fixture's identity as input
+ * filters. This means the expected output is always a one-element array,
+ * which may not match the real accessor behavior when multiple fixtures
+ * share the same filter. A custom `blaze` with hand-authored examples is
+ * required for multi-result list assertions.
+ */
+const deriveExample = (contour, operation, example, index, generated) => {
+    const name = formatExampleName(contour, operation, example, index);
+    const identity = pickValueFields(example, [contour.identity]);
+    switch (operation) {
+        case 'create': {
+            return {
+                expected: example,
+                input: omitValueFields(example, generated),
+                name,
+            };
+        }
+        case 'read': {
+            return {
+                expected: example,
+                input: identity,
+                name,
+            };
+        }
+        case 'update': {
+            return {
+                expected: example,
+                input: {
+                    ...omitValueFields(example, [...generated, contour.identity]),
+                    ...identity,
+                },
+                name,
+            };
+        }
+        case 'delete': {
+            return {
+                input: identity,
+                name,
+            };
+        }
+        case 'list': {
+            return {
+                expected: [example],
+                input: {},
+                name,
+            };
+        }
+        default: {
+            return unsupportedOperation(operation);
+        }
+    }
+};
+const deriveExamples = (contour, operation, generated) => {
+    if (contour.examples === undefined || contour.examples.length === 0) {
+        return undefined;
+    }
+    // List examples use a single example with all fixtures in expected,
+    // since input: {} returns the full set from a seeded mock. Expected
+    // values keep generated fields (createdAt, etc.) because the mock
+    // populates them — stripping them would fail output schema validation.
+    if (operation === 'list') {
+        return Object.freeze([
+            {
+                expected: contour.examples,
+                input: {},
+                name: `${contour.name} list example`,
+            },
+        ]);
+    }
+    return Object.freeze(contour.examples.map((example, index) => deriveExample(contour, operation, example, index, generated)));
+};
+const wrapUnexpected = (contourName, operation, error) => {
+    if (isTrailsError(error)) {
+        return error;
+    }
+    const cause = error instanceof Error ? error : new Error(String(error));
+    return new InternalError(`deriveTrail("${contourName}.${operation}") synthesized blaze failed: ${cause.message}`, { cause });
+};
+const notFoundError = (contourName, id) => new NotFoundError(`deriveTrail("${contourName}"): entity "${String(id)}" not found`);
+const resolveAccessor = (contour, operation, resource, ctx) => {
+    try {
+        const connection = resource.from(ctx);
+        if (connection === undefined || connection === null) {
+            return new InternalError(`deriveTrail("${contour.name}.${operation}"): resource "${resource.id}" produced no connection`);
+        }
+        const accessor = connection[contour.name];
+        if (accessor === undefined) {
+            return new InternalError(`deriveTrail("${contour.name}.${operation}"): resource "${resource.id}" does not expose an accessor for "${contour.name}"`);
+        }
+        return accessor;
+    }
+    catch (error) {
+        return wrapUnexpected(contour.name, operation, error);
+    }
+};
+const extractIdentity = (contour, input) => {
+    const record = input;
+    return record[contour.identity];
+};
+const callRead = async (contour, accessor, input) => {
+    if (typeof accessor.get !== 'function') {
+        return Result.err(new InternalError(`deriveTrail("${contour.name}.read"): accessor is missing a \`get\` method`));
+    }
+    try {
+        const id = extractIdentity(contour, input);
+        const entity = await accessor.get(id);
+        if (entity === null || entity === undefined) {
+            return Result.err(notFoundError(contour.name, id));
+        }
+        return Result.ok(entity);
+    }
+    catch (error) {
+        return Result.err(wrapUnexpected(contour.name, 'read', error));
+    }
+};
+const callCreate = async (contour, accessor, input, ctx) => {
+    try {
+        if (typeof accessor.insert === 'function') {
+            const created = await accessor.insert(input);
+            return Result.ok(created);
+        }
+        // Fallback: tabular contract allows `upsert` when `insert` is absent.
+        // The warden flags this at build time via a pattern rule (trl-251).
+        if (typeof accessor.upsert !== 'function') {
+            return Result.err(new InternalError(`deriveTrail("${contour.name}.create"): accessor is missing both \`insert\` and \`upsert\``));
+        }
+        ctx.logger?.debug(`deriveTrail("${contour.name}.create"): accessor has no \`insert\`; falling back to \`upsert\``);
+        const created = await accessor.upsert(input);
+        return Result.ok(created);
+    }
+    catch (error) {
+        return Result.err(wrapUnexpected(contour.name, 'create', error));
+    }
+};
+/**
+ * Strip framework-managed generated fields from a merged payload so that
+ * the update-via-upsert fallback doesn't carry stale managed values.
+ *
+ * Only strips fields that appear in the `generated` array — user-defined
+ * fields with the same name (e.g. an API `version` string) are preserved.
+ */
+const stripGeneratedFields = (payload, generated, identity) => {
+    if (generated.length === 0) {
+        return payload;
+    }
+    const managedKeys = new Set(generated);
+    return Object.fromEntries(Object.entries(payload).filter(([key]) => key === identity || !managedKeys.has(key)));
+};
+/**
+ * Fallback for accessors that lack a native `update`: read the current
+ * entity, merge the patch, strip any `version` field so versioned tables
+ * keep `update`'s "does not participate in optimistic concurrency" semantic,
+ * then `upsert`.
+ */
+const updateViaReadAndUpsert = async (contour, accessor, id, patch, generated) => {
+    if (typeof accessor.get !== 'function') {
+        return Result.err(new InternalError(`deriveTrail("${contour.name}.update"): accessor is missing both \`update\` and \`get\``));
+    }
+    if (typeof accessor.upsert !== 'function') {
+        return Result.err(new InternalError(`deriveTrail("${contour.name}.update"): accessor is missing both \`update\` and \`upsert\``));
+    }
+    const current = await accessor.get(id);
+    if (current === null || current === undefined) {
+        return Result.err(notFoundError(contour.name, id));
+    }
+    const merged = stripGeneratedFields({ ...current, ...patch }, generated, contour.identity);
+    const updated = await accessor.upsert(merged);
+    return Result.ok(updated);
+};
+const callUpdate = async (contour, accessor, input, generated) => {
+    const id = extractIdentity(contour, input);
+    const patch = Object.fromEntries(Object.entries(input).filter(([field]) => field !== contour.identity));
+    try {
+        if (typeof accessor.update === 'function') {
+            const updated = await accessor.update(id, patch);
+            if (updated === null || updated === undefined) {
+                return Result.err(notFoundError(contour.name, id));
+            }
+            return Result.ok(updated);
+        }
+        return await updateViaReadAndUpsert(contour, accessor, id, patch, generated);
+    }
+    catch (error) {
+        return Result.err(wrapUnexpected(contour.name, 'update', error));
+    }
+};
+const callDelete = async (contour, accessor, input) => {
+    if (typeof accessor.remove !== 'function') {
+        return Result.err(new InternalError(`deriveTrail("${contour.name}.delete"): accessor is missing a \`remove\` method`));
+    }
+    try {
+        const id = extractIdentity(contour, input);
+        await accessor.remove(id);
+        // `{ deleted: false }` is a no-op on an absent row, not an error —
+        // matches the accessor's documented semantic.
+        return Result.ok();
+    }
+    catch (error) {
+        return Result.err(wrapUnexpected(contour.name, 'delete', error));
+    }
+};
+/**
+ * Default `list` synthesis passes the entire input as the filter bag. The
+ * derived input type is `Partial<ContourInput>` which matches the accessor's
+ * filter shape field-for-field. Pagination controls are not derived — callers
+ * that need pagination must provide an explicit blaze.
+ */
+const callList = async (contour, accessor, input) => {
+    if (typeof accessor.list !== 'function') {
+        return Result.err(new InternalError(`deriveTrail("${contour.name}.list"): accessor is missing a \`list\` method`));
+    }
+    try {
+        const listed = await accessor.list(input);
+        return Result.ok([...listed]);
+    }
+    catch (error) {
+        return Result.err(wrapUnexpected(contour.name, 'list', error));
+    }
+};
+const synthesizeDefaultBlaze = (contour, operation, resource, generated) => {
+    const impl = (input, ctx) => {
+        const accessor = resolveAccessor(contour, operation, resource, ctx);
+        if (accessor instanceof Error) {
+            return Promise.resolve(Result.err(accessor));
+        }
+        switch (operation) {
+            case 'create': {
+                return callCreate(contour, accessor, input, ctx);
+            }
+            case 'read': {
+                return callRead(contour, accessor, input);
+            }
+            case 'update': {
+                return callUpdate(contour, accessor, input, generated);
+            }
+            case 'delete': {
+                return callDelete(contour, accessor, input);
+            }
+            case 'list': {
+                return callList(contour, accessor, input);
+            }
+            default: {
+                return unsupportedOperation(operation);
+            }
+        }
+    };
+    return impl;
+};
+/**
+ * Mechanically project one CRUD-shaped trail from a contour declaration.
+ *
+ * When `spec.blaze` is omitted and the call declares a single resource, the
+ * helper derives a default blaze that dispatches to the resource accessor
+ * through the structural {@link StoreAccessorProtocol}. Multi-resource calls
+ * must supply an explicit blaze and are rejected with {@link DerivationError}
+ * at construction time when they do not.
+ */
+export const deriveTrail = (contour, operation, spec) => {
+    const resources = normalizeResources(spec.resource);
+    const generated = uniqueStrings(spec.generated);
+    let blaze;
+    if (typeof spec.blaze === 'function') {
+        ({ blaze } = spec);
+    }
+    else if (resources.length === 1) {
+        blaze = synthesizeDefaultBlaze(contour, operation, resources[0], generated);
+    }
+    else {
+        throw new DerivationError(`deriveTrail("${contour.name}.${operation}") requires an explicit \`blaze\` when ${describeDeriveTrailResourceDeclaration(resources.length)} — default synthesis is single-resource only`);
+    }
+    const { blaze: _blaze, resource: _resource, generated: _generated, ...trailSpec } = spec;
+    const derivedSpec = {
+        ...trailSpec,
+        blaze,
+        contours: [contour],
+        examples: deriveExamples(contour, operation, generated),
+        input: deriveInputSchema(contour, operation, generated),
+        intent: operationIntent[operation],
+        output: deriveOutputSchema(contour, operation),
+        resources,
+    };
+    return trail(`${contour.name}.${operation}`, derivedSpec);
+};
+//# sourceMappingURL=derive-trail.js.map

package/dist/trails/derive-trail.js.map

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

package/dist/trails/index.d.ts

@@ -0,0 +1,5 @@
+export { deriveTrail } from './derive-trail.js';
+export type { DeriveTrailInput, DeriveTrailOperation, DeriveTrailOutput, DeriveTrailSpec, } from './derive-trail.js';
+export { ingest } from './ingest.js';
+export type { IngestOptions, IngestTransform } from './ingest.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trails/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/trails/index.js

@@ -0,0 +1,3 @@
+export { deriveTrail } from './derive-trail.js';
+export { ingest } from './ingest.js';
+//# sourceMappingURL=index.js.map

package/dist/trails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trails/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/trails/ingest.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { Layer } from '../layer.js';
+import type { Signal } from '../signal.js';
+import type { Trail, TrailSpec } from '../trail.js';
+import type { TrailContext } from '../types.js';
+type SchemaValue<TSchema extends z.ZodType> = z.output<TSchema>;
+type SignalRef<TSignal> = string | Signal<TSignal>;
+interface IngestBaseOptions<TSchema extends z.ZodType, TSignal> extends Omit<TrailSpec<SchemaValue<TSchema>, void>, 'blaze' | 'examples' | 'fires' | 'input' | 'intent' | 'output' | 'pattern'> {
+    /** Override the derived trail id. Defaults to `${signal}.ingest`. */
+    readonly id?: string | undefined;
+    /** Validated external payload shape. */
+    readonly schema: TSchema;
+    /** Signal to emit after verification and optional transformation. */
+    readonly signal: SignalRef<TSignal>;
+    /** Optional per-trail verification layer, e.g. HMAC signature checks. */
+    readonly verify?: Layer | undefined;
+}
+export type IngestTransform<TInput, TSignal> = (payload: TInput, ctx: TrailContext) => TSignal | Promise<TSignal>;
+export interface IngestOptions<TSchema extends z.ZodType, TSignal> extends IngestBaseOptions<TSchema, TSignal> {
+    readonly transform?: IngestTransform<SchemaValue<TSchema>, TSignal> | undefined;
+}
+export declare const ingest: <TSchema extends z.ZodType, TSignal = SchemaValue<TSchema>>(options: IngestOptions<TSchema, TSignal>) => Trail<SchemaValue<TSchema>, void>;
+export {};
+//# sourceMappingURL=ingest.d.ts.map

package/dist/trails/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/trails/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,KAAK,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,KAAK,WAAW,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChE,KAAK,SAAS,CAAC,OAAO,IAAI,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAMnD,UAAU,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,CAAE,SAAQ,IAAI,CAC1E,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,EACrC,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAC3E;IACC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,IAAI,CAC7C,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,YAAY,KACd,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,aAAa,CAC5B,OAAO,SAAS,CAAC,CAAC,OAAO,EACzB,OAAO,CACP,SAAQ,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EACf,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAC9C,SAAS,CAAC;CACf;AAiED,eAAO,MAAM,MAAM,GACjB,OAAO,SAAS,CAAC,CAAC,OAAO,EACzB,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAE9B,SAAS,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,KACvC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,CA+BlC,CAAC"}

package/dist/trails/ingest.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { InternalError } from '../errors.js';
+import { composeLayers } from '../layer.js';
+import { Result } from '../result.js';
+import { trail } from '../trail.js';
+const resolveSignalId = (signalRef) => typeof signalRef === 'string' ? signalRef : signalRef.id;
+const deriveExampleName = (signalId, index) => `Ingest ${signalId} ${index + 1}`;
+const deriveExamples = (schema, signalId) => {
+    const { examples } = schema;
+    if (examples === undefined || examples.length === 0) {
+        return undefined;
+    }
+    return Object.freeze(examples.map((example, index) => ({
+        input: example,
+        name: deriveExampleName(signalId, index),
+    })));
+};
+const createIngestBlaze = (signalRef, signalId, trailId, transform) => async (input, ctx) => {
+    if (ctx.fire === undefined) {
+        return Result.err(new InternalError(`ingest("${trailId}") requires topo-backed execution to emit "${signalId}"`));
+    }
+    try {
+        const payload = transform === undefined
+            ? input
+            : await transform(input, ctx);
+        const fired = typeof signalRef === 'string'
+            ? await ctx.fire(signalRef, payload)
+            : await ctx.fire(signalRef, payload);
+        return fired.isErr() ? Result.err(fired.error) : Result.ok();
+    }
+    catch (error) {
+        const message = `ingest("${trailId}"): ${error instanceof Error ? error.message : String(error)}`;
+        return Result.err(error instanceof Error
+            ? new InternalError(message, { cause: error })
+            : new InternalError(message));
+    }
+};
+export const ingest = (options) => {
+    const signalId = resolveSignalId(options.signal);
+    const id = options.id ?? `${signalId}.ingest`;
+    const { id: _id, schema, signal, transform, verify, ...trailSpec } = options;
+    const baseBlaze = createIngestBlaze(signal, signalId, id, transform);
+    const baseTrail = trail(id, {
+        ...trailSpec,
+        blaze: baseBlaze,
+        examples: deriveExamples(schema, signalId),
+        fires: [signal],
+        input: schema,
+        intent: 'write',
+        output: z.void(),
+        pattern: 'ingest',
+    });
+    if (verify === undefined) {
+        return baseTrail;
+    }
+    // Verification is a per-factory concern, so compose it locally instead of
+    // mutating runner-wide layer configuration.
+    return Object.freeze({
+        ...baseTrail,
+        blaze: composeLayers([verify], baseTrail, baseTrail.blaze),
+    });
+};
+//# sourceMappingURL=ingest.js.map

package/dist/trails/ingest.js.map

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