@gkoos/caracal 0.1.1 → 0.2.0

package/dist/chunk-5CXDW7W6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/runtime.ts","../src/core/operation.ts"],"names":[],"mappings":"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","file":"chunk-5CXDW7W6.js","sourcesContent":["import type {\n  Classification,\n  EventSink,\n  ExecutionContext,\n  OperationEvent,\n  Outcome,\n  OutcomeClassifier,\n} from \"./types.js\"\n\nconst eventSinks = Symbol(\"caracal.eventSinks\")\nconst admissionSignals = new WeakMap<ExecutionContext, AbortSignal>()\nexport function admissionSignal(\n  context: ExecutionContext,\n): AbortSignal | undefined {\n  const admission = admissionSignals.get(context)\n  return admission && context.signal\n    ? AbortSignal.any([admission, context.signal])\n    : (admission ?? context.signal)\n}\nexport function withAdmissionSignal(\n  context: ExecutionContext,\n  signal: AbortSignal,\n): ExecutionContext {\n  const derived = attachRuntime(\n    { ...context },\n    runtimeContext(context)[eventSinks] ?? [],\n  )\n  const previous = admissionSignal(context)\n  admissionSignals.set(\n    derived,\n    previous ? AbortSignal.any([previous, signal]) : signal,\n  )\n  return derived\n}\nfunction inheritAdmission(\n  source: ExecutionContext,\n  target: ExecutionContext,\n): ExecutionContext {\n  const signal = admissionSignals.get(source)\n  if (signal) admissionSignals.set(target, signal)\n  return target\n}\n\ntype EventWithoutRuntimeFields = OperationEvent extends infer Event\n  ? Event extends OperationEvent\n    ? Omit<Event, \"at\" | \"context\">\n    : never\n  : never\n\ntype RuntimeExecutionContext = ExecutionContext & {\n  readonly [eventSinks]: readonly EventSink[]\n}\n\nfunction runtimeContext(context: ExecutionContext): RuntimeExecutionContext {\n  return context as RuntimeExecutionContext\n}\n\nfunction attachRuntime(\n  values: ExecutionContext,\n  sinks: readonly EventSink[],\n): ExecutionContext {\n  const context = values as RuntimeExecutionContext\n  Object.defineProperty(context, eventSinks, { value: sinks })\n  return Object.freeze(context)\n}\n\nexport function createExecutionContext(\n  values: Omit<ExecutionContext, \"attempt\">,\n  sinks: readonly EventSink[],\n): ExecutionContext {\n  return attachRuntime({ attempt: 1, ...values }, sinks)\n}\n\nexport function nextAttempt(context: ExecutionContext): ExecutionContext {\n  return inheritAdmission(\n    context,\n    attachRuntime(\n      { ...context, attempt: context.attempt + 1 },\n      runtimeContext(context)[eventSinks] ?? [],\n    ),\n  )\n}\n\nexport function withSignal(\n  context: ExecutionContext,\n  signal: AbortSignal | undefined,\n): ExecutionContext {\n  return inheritAdmission(\n    context,\n    attachRuntime(\n      { ...context, signal },\n      runtimeContext(context)[eventSinks] ?? [],\n    ),\n  )\n}\n\nexport function emitRuntimeEvent(\n  context: ExecutionContext,\n  event: EventWithoutRuntimeFields,\n): void {\n  const sinks = runtimeContext(context)[eventSinks] ?? []\n  const fullEvent = { ...event, at: Date.now(), context } as OperationEvent\n\n  for (const sink of sinks) {\n    try {\n      sink.emit(fullEvent)\n    } catch {\n      // Observability must not modify resilience execution.\n    }\n  }\n}\n\nexport function createClassifier<Result>(\n  classify: ((outcome: Outcome<Result>) => Classification) | undefined,\n): OutcomeClassifier {\n  return (outcome) => {\n    if (classify === undefined) {\n      return outcome.status === \"success\" ? \"success\" : \"failure\"\n    }\n\n    return classify(outcome as Outcome<Result>)\n  }\n}\n","import { randomUUID } from \"node:crypto\"\n\nimport {\n  admissionSignal,\n  createClassifier,\n  createExecutionContext,\n} from \"./runtime.js\"\nimport type {\n  Adapter,\n  EventSink,\n  EventSinks,\n  ExecutionMetadata,\n  Next,\n  Operation,\n  OperationCapabilities,\n  OperationEvent,\n  OperationExecuteOptions,\n  OperationOptions,\n  Outcome,\n  Policy,\n} from \"./types.js\"\n\nconst summarizeSuccess = (): Outcome<undefined> => ({\n  status: \"success\",\n  value: undefined,\n})\nconst summarizeFailure = (error: unknown): Outcome<undefined> => ({\n  status: \"failure\",\n  error,\n})\n\nfunction immutableCapabilities(\n  capabilities: OperationCapabilities,\n): OperationCapabilities {\n  return Object.freeze({ ...capabilities })\n}\n\nfunction immutableMetadata(\n  metadata: Readonly<Record<string, unknown>> | undefined,\n): ExecutionMetadata {\n  return Object.freeze({ ...(metadata ?? {}) })\n}\n\nfunction normalizeSinks(events: EventSinks | undefined): readonly EventSink[] {\n  if (events === undefined) {\n    return []\n  }\n\n  return \"emit\" in events ? [events] : events\n}\n\nfunction emit(sinks: readonly EventSink[], event: OperationEvent): void {\n  for (const sink of sinks) {\n    try {\n      sink.emit(event)\n    } catch {\n      // Observability must not modify resilience execution.\n    }\n  }\n}\n\nfunction validateName(name: string, kind: \"operation\" | \"policy\"): void {\n  if (name.trim().length === 0) {\n    throw new Error(`${kind} name must not be empty`)\n  }\n}\n\nfunction createPipeline<Result>(\n  policies: readonly Policy[],\n  adapter: Next<Result>,\n): Next<Result> {\n  return policies.reduceRight<Next<Result>>(\n    (next, policy) => async (context) => policy.execute(context, next),\n    adapter,\n  )\n}\n\nfunction invokeAdapter<Args, Result>(\n  adapter: Adapter<Args, Result>,\n  args: Args,\n  sinks: readonly EventSink[],\n): Next<Result> {\n  return async (context) => {\n    admissionSignal(context)?.throwIfAborted()\n    emit(sinks, { type: \"attempt.started\", at: Date.now(), context })\n\n    try {\n      const value = await adapter.execute(args, context)\n      const outcome: Outcome<Result> = { status: \"success\", value }\n      const classification = context.classify(outcome)\n      emit(sinks, {\n        type: \"attempt.settled\",\n        at: Date.now(),\n        context,\n        outcome: summarizeSuccess(),\n        classification,\n      })\n      return value\n    } catch (error) {\n      const outcome: Outcome<Result> = { status: \"failure\", error }\n      const classification = context.classify(outcome)\n      emit(sinks, {\n        type: \"attempt.settled\",\n        at: Date.now(),\n        context,\n        outcome: summarizeFailure(error),\n        classification,\n      })\n      throw error\n    }\n  }\n}\n\n/** Creates a named, protocol-agnostic operation. */\nexport function operation<Args, Result>(\n  options: OperationOptions<Args, Result>,\n): Operation<Args, Result> {\n  validateName(options.name, \"operation\")\n  for (const policy of options.policies ?? []) {\n    validateName(policy.name, \"policy\")\n  }\n\n  const policies = Object.freeze([...(options.policies ?? [])])\n  const sinks = Object.freeze(normalizeSinks(options.events))\n\n  return Object.freeze({\n    name: options.name,\n    async execute(\n      args: Args,\n      executeOptions: OperationExecuteOptions = {},\n    ): Promise<Result> {\n      const capabilities = options.adapter.capabilities(args)\n      const context = createExecutionContext(\n        {\n          operationName: options.name,\n          executionId: executeOptions.executionId ?? randomUUID(),\n          signal: executeOptions.signal,\n          metadata: immutableMetadata(executeOptions.metadata),\n          capabilities: immutableCapabilities(capabilities),\n          classify: createClassifier(options.adapter.classify),\n        },\n        sinks,\n      )\n      const adapter = createPipeline(\n        policies.filter((policy) => policy.phase === \"attempt\"),\n        invokeAdapter(options.adapter, args, sinks),\n      )\n      const pipeline = createPipeline(\n        policies.filter((policy) => policy.phase !== \"attempt\"),\n        adapter,\n      )\n\n      emit(sinks, { type: \"execution.started\", at: Date.now(), context })\n      try {\n        const value = await pipeline(context)\n        emit(sinks, {\n          type: \"execution.settled\",\n          at: Date.now(),\n          context,\n          outcome: summarizeSuccess(),\n        })\n        return value\n      } catch (error) {\n        emit(sinks, {\n          type: \"execution.settled\",\n          at: Date.now(),\n          context,\n          outcome: summarizeFailure(error),\n        })\n        throw error\n      }\n    },\n  })\n}\n"]}