@relkit/invocation 0.0.0

package/dist/dispatcher-types.d.ts

@@ -0,0 +1,80 @@
+import type { MaybePromise } from "@relkit/contracts";
+import type { InvocationCompletion, InvocationContext, InvocationContextOptions, InvocationIdSource, InvocationParent, InvocationRecord, InvocationRunner, InvocationTarget, InvocationSource, PublicClock, PublicLogger } from "./contracts.js";
+import type { InvocationCallStack } from "./recursion.js";
+import type { ServicePolicySource } from "./service-policy.js";
+export declare const MANAGED_DEPENDENCY_CATEGORIES: readonly ["jobs", "events", "buckets", "cache", "agents"];
+export type ManagedDependencyCategory = (typeof MANAGED_DEPENDENCY_CATEGORIES)[number];
+export type ManagedDependencySources = Partial<{
+    readonly [Category in ManagedDependencyCategory]: Readonly<Record<string, unknown>>;
+}>;
+export type InvocationContextFactory<Context extends {
+    readonly signal: AbortSignal;
+}> = (options: InvocationContextOptions) => MaybePromise<Context>;
+export interface StructuredLogRecord {
+    readonly level: "trace" | "debug" | "info" | "warn" | "error";
+    readonly message: string;
+    readonly fields: Readonly<Record<string, unknown>>;
+    readonly timestamp: string;
+    readonly invocationId: string;
+    readonly traceId: string;
+    readonly functionId: string;
+    readonly source: InvocationSource;
+    readonly serviceId?: string;
+}
+export interface LocalStructuredLogger extends PublicLogger {
+    readonly records: readonly StructuredLogRecord[];
+}
+export interface InvocationDispatchOptions<Context extends {
+    readonly signal: AbortSignal;
+} = InvocationContext> {
+    readonly source?: InvocationSource;
+    readonly parent?: InvocationParent;
+    readonly correlationId?: string;
+    readonly traceId?: string;
+    readonly deadlineMs?: number;
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+    readonly toolHooks?: InvocationValueHooks<Context>;
+    readonly env?: Readonly<Record<string, unknown>>;
+    readonly now?: () => number;
+    readonly time?: PublicClock;
+    readonly logger?: PublicLogger;
+    readonly clients?: ManagedDependencySources;
+    readonly servicePolicies?: ServicePolicySource;
+    readonly context?: InvocationContextFactory<Context>;
+    readonly effectRunner?: InvocationRunner;
+    readonly idSource?: InvocationIdSource;
+    readonly onInvocationStart?: (record: InvocationRecord) => MaybePromise<void>;
+    readonly onCompletion?: (completion: InvocationCompletion) => MaybePromise<void>;
+    readonly onRelease?: (release: {
+        readonly record: InvocationRecord;
+        readonly admitted: boolean;
+    }) => MaybePromise<void>;
+}
+export interface InvocationValueHooks<Context extends {
+    readonly signal: AbortSignal;
+}> {
+    readonly onBefore?: (input: unknown, context: Context) => MaybePromise<unknown>;
+    readonly onAfter?: (output: unknown, context: Context) => MaybePromise<unknown>;
+}
+export type StandaloneDispatcherOptions<Context extends {
+    readonly signal: AbortSignal;
+} = InvocationContext> = Omit<InvocationDispatchOptions<Context>, "source" | "parent">;
+export interface InvocationDispatchRequest<Input = unknown, Output = unknown, Context extends {
+    readonly signal: AbortSignal;
+} = InvocationContext> {
+    readonly target: InvocationTarget<Input, Output, Context>;
+    readonly input: unknown;
+    readonly options?: InvocationDispatchOptions<Context>;
+}
+export interface InvocationDispatcher {
+    readonly dispatch: <Input = unknown, Output = unknown, Context extends {
+        readonly signal: AbortSignal;
+    } = InvocationContext>(request: InvocationDispatchRequest<Input, Output, Context>) => Promise<Output>;
+}
+export interface InvocationDispatchScope {
+    readonly dispatcher: InvocationDispatcher;
+    readonly parent?: InvocationParent;
+    readonly chain?: InvocationCallStack;
+}
+//# sourceMappingURL=dispatcher-types.d.ts.map

package/dist/dispatcher-types.d.ts.map

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

package/dist/dispatcher-types.js

@@ -0,0 +1,8 @@
+export const MANAGED_DEPENDENCY_CATEGORIES = [
+    "jobs",
+    "events",
+    "buckets",
+    "cache",
+    "agents",
+];
+//# sourceMappingURL=dispatcher-types.js.map

package/dist/dispatcher-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-types.js","sourceRoot":"","sources":["../src/dispatcher-types.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,MAAM;IACN,QAAQ;IACR,SAAS;IACT,OAAO;IACP,QAAQ;CACA,CAAC"}

package/dist/dispatcher.d.ts

@@ -0,0 +1,11 @@
+import { currentInvocationScope, runInInvocationScope } from "./dispatcher-scope.js";
+import type { InvocationDispatchRequest, InvocationDispatcher } from "./dispatcher-types.js";
+export declare function currentInvocationDispatcher(): InvocationDispatcher | undefined;
+export declare function dispatchInvocation<Input, Output, Context extends {
+    readonly signal: AbortSignal;
+}>(request: InvocationDispatchRequest<Input, Output, Context>): Promise<Output>;
+export { currentInvocationScope, runInInvocationScope };
+export { createStandaloneDispatcher } from "./standalone-dispatcher.js";
+export type { InvocationDispatchRequest, InvocationDispatcher, InvocationDispatchOptions, InvocationDispatchScope, InvocationValueHooks, LocalStructuredLogger, ManagedDependencyCategory, ManagedDependencySources, StandaloneDispatcherOptions, StructuredLogRecord, } from "./dispatcher-types.js";
+export { MANAGED_DEPENDENCY_CATEGORIES } from "./dispatcher-types.js";
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,KAAK,EACV,yBAAyB,EACzB,oBAAoB,EAGrB,MAAM,uBAAuB,CAAC;AAE/B,wBAAgB,2BAA2B,IAAI,oBAAoB,GAAG,SAAS,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,EAChG,OAAO,EAAE,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GACzD,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EACV,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/dispatcher.js

@@ -0,0 +1,12 @@
+import { createStandaloneDispatcher } from "./standalone-dispatcher.js";
+import { currentInvocationScope, runInInvocationScope } from "./dispatcher-scope.js";
+export function currentInvocationDispatcher() {
+    return currentInvocationScope()?.dispatcher;
+}
+export function dispatchInvocation(request) {
+    return (currentInvocationDispatcher() ?? createStandaloneDispatcher()).dispatch(request);
+}
+export { currentInvocationScope, runInInvocationScope };
+export { createStandaloneDispatcher } from "./standalone-dispatcher.js";
+export { MANAGED_DEPENDENCY_CATEGORIES } from "./dispatcher-types.js";
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQrF,MAAM,UAAU,2BAA2B;IACzC,OAAO,sBAAsB,EAAE,EAAE,UAAU,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAA0D;IAE1D,OAAO,CAAC,2BAA2B,EAAE,IAAI,0BAA0B,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3F,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAaxE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/error-retry.d.ts

@@ -0,0 +1,12 @@
+export type ErrorRetry = "never" | "later";
+export interface ErrorRetryLater {
+    readonly kind: "later";
+    readonly afterMs?: number;
+}
+export type ErrorRetryInput = ErrorRetry | ErrorRetryLater;
+export interface NormalizedErrorRetry {
+    readonly retry: ErrorRetry;
+    readonly afterMs?: number;
+}
+export declare function normalizeErrorRetry(value: unknown, afterMs?: unknown): NormalizedErrorRetry;
+//# sourceMappingURL=error-retry.d.ts.map

package/dist/error-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-retry.d.ts","sourceRoot":"","sources":["../src/error-retry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,eAAe,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAY3F"}

package/dist/error-retry.js

@@ -0,0 +1,33 @@
+export function normalizeErrorRetry(value, afterMs) {
+    if (value === undefined || value === "never") {
+        if (afterMs !== undefined)
+            throw invalidRetry();
+        return Object.freeze({ retry: "never" });
+    }
+    if (value === "later")
+        return later(afterMs);
+    if (!isRecord(value) || value.kind !== "later")
+        throw invalidRetry();
+    const nestedAfterMs = value.afterMs;
+    if (afterMs !== undefined && nestedAfterMs !== undefined && afterMs !== nestedAfterMs) {
+        throw invalidRetry();
+    }
+    return later(nestedAfterMs === undefined ? afterMs : nestedAfterMs);
+}
+function later(afterMs) {
+    if (afterMs === undefined)
+        return Object.freeze({ retry: "later" });
+    if (typeof afterMs !== "number" || !Number.isSafeInteger(afterMs) || afterMs < 0)
+        throw invalidAfterMs();
+    return Object.freeze({ retry: "later", afterMs });
+}
+function invalidRetry() {
+    return new TypeError('Declared error retry must be "never", "later", or { kind: "later" }.');
+}
+function invalidAfterMs() {
+    return new TypeError("Declared error retry.afterMs must be a finite non-negative integer.");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=error-retry.js.map

package/dist/error-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-retry.js","sourceRoot":"","sources":["../src/error-retry.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,OAAiB;IACnE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,YAAY,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,MAAM,YAAY,EAAE,CAAC;IACrE,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QACtF,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,KAAK,CAAC,OAAgB;IAC7B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACpE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAC9E,MAAM,cAAc,EAAE,CAAC;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,IAAI,SAAS,CAAC,sEAAsE,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,IAAI,SAAS,CAAC,qEAAqE,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/failure-dependency.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderFailure } from "./failure-types.js";
+export declare function dependencyNotConfiguredFailure(cause: {
+    readonly category: string;
+    readonly dependencyName: string;
+}): ProviderFailure;
+//# sourceMappingURL=failure-dependency.d.ts.map

package/dist/failure-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-dependency.d.ts","sourceRoot":"","sources":["../src/failure-dependency.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,eAAe,CAalB"}

package/dist/failure-dependency.js

@@ -0,0 +1,13 @@
+import { makeFailure } from "./failure-runtime.js";
+export function dependencyNotConfiguredFailure(cause) {
+    return makeFailure({
+        _tag: "ProviderFailure",
+        kind: "provider",
+        outcome: "provider-failure",
+        code: "RELKIT_DEPENDENCY_NOT_CONFIGURED",
+        message: `Managed dependency "${cause.category}.${cause.dependencyName}" is not configured`,
+        capability: cause.category,
+        profile: cause.dependencyName,
+    }, cause);
+}
+//# sourceMappingURL=failure-dependency.js.map

package/dist/failure-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-dependency.js","sourceRoot":"","sources":["../src/failure-dependency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,UAAU,8BAA8B,CAAC,KAG9C;IACC,OAAO,WAAW,CAChB;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,uBAAuB,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,cAAc,qBAAqB;QAC3F,UAAU,EAAE,KAAK,CAAC,QAAQ;QAC1B,OAAO,EAAE,KAAK,CAAC,cAAc;KAC9B,EACD,KAAK,CACa,CAAC;AACvB,CAAC"}

package/dist/failure-guards.d.ts

@@ -0,0 +1,30 @@
+import { type ErrorRetryInput } from "./error-retry.js";
+export type DeclaredErrorLike = Error & {
+    readonly id: string;
+    readonly data: unknown;
+    readonly retry?: ErrorRetryInput;
+    readonly afterMs?: number;
+    readonly http?: {
+        readonly status: number;
+    };
+    readonly ref: {
+        readonly kind: unknown;
+        readonly id: string;
+    };
+};
+export type FunctionFailureLike = {
+    readonly _tag: "FunctionFailure";
+    readonly error: unknown;
+};
+export declare function isFunctionFailure(value: unknown): value is FunctionFailureLike;
+export declare function isDeclaredError(value: unknown): value is DeclaredErrorLike;
+export declare function isProviderError(value: unknown): boolean;
+export declare function isDependencyNotConfigured(value: unknown): value is {
+    readonly name: "DependencyNotConfiguredError";
+    readonly category: string;
+    readonly dependencyName: string;
+};
+export declare function isCancellation(value: unknown): boolean;
+export declare function isTimeout(value: unknown): boolean;
+export declare function requiredText(value: string, label: string): string;
+//# sourceMappingURL=failure-guards.d.ts.map

package/dist/failure-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-guards.d.ts","sourceRoot":"","sources":["../src/failure-guards.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAE9E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAW1E;AAWD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAClE,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,CAOA;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAStD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjE"}

package/dist/failure-guards.js

@@ -0,0 +1,58 @@
+import { Cause } from "effect";
+import { normalizeErrorRetry } from "./error-retry.js";
+export function isFunctionFailure(value) {
+    return isRecord(value) && value._tag === "FunctionFailure" && "error" in value;
+}
+export function isDeclaredError(value) {
+    if (!(value instanceof Error) || value.name !== "DeclaredError" || !isRecord(value))
+        return false;
+    const ref = value.ref;
+    return (typeof value.id === "string" &&
+        typeof value.message === "string" &&
+        isValidRetry(value.retry, value.afterMs) &&
+        isRecord(ref) &&
+        ref.kind === "error" &&
+        ref.id === value.id);
+}
+function isValidRetry(value, afterMs) {
+    try {
+        normalizeErrorRetry(value, afterMs);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isProviderError(value) {
+    return isRecord(value) && (value._tag === "ProviderError" || value.name === "ProviderError");
+}
+export function isDependencyNotConfigured(value) {
+    return (isRecord(value) &&
+        value.name === "DependencyNotConfiguredError" &&
+        typeof value.category === "string" &&
+        typeof value.dependencyName === "string");
+}
+export function isCancellation(value) {
+    return (isRecord(value) &&
+        (value.name === "AbortError" ||
+            value.name === "CanceledError" ||
+            value.code === "ABORT_ERR" ||
+            value.code === "ERR_ABORTED" ||
+            value._tag === "Abort"));
+}
+export function isTimeout(value) {
+    return (Cause.isTimeoutError(value) ||
+        (isRecord(value) &&
+            (value.name === "TimeoutError" ||
+                value._tag === "TimeoutError" ||
+                value.code === "ETIMEDOUT")));
+}
+export function requiredText(value, label) {
+    if (value.trim().length === 0)
+        throw new TypeError(`${label} must be non-empty`);
+    return value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object";
+}
+//# sourceMappingURL=failure-guards.js.map

package/dist/failure-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-guards.js","sourceRoot":"","sources":["../src/failure-guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAwB,MAAM,kBAAkB,CAAC;AAgB7E,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,OAAO,IAAI,KAAK,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClG,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,OAAO,CACL,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;QACxC,QAAQ,CAAC,GAAG,CAAC;QACb,GAAG,CAAC,IAAI,KAAK,OAAO;QACpB,GAAG,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CACpB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,OAAgB;IACpD,IAAI,CAAC;QACH,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc;IAKtD,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,IAAI,KAAK,8BAA8B;QAC7C,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,CACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY;YAC1B,KAAK,CAAC,IAAI,KAAK,eAAe;YAC9B,KAAK,CAAC,IAAI,KAAK,WAAW;YAC1B,KAAK,CAAC,IAAI,KAAK,aAAa;YAC5B,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CACL,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;QAC3B,CAAC,QAAQ,CAAC,KAAK,CAAC;YACd,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc;gBAC5B,KAAK,CAAC,IAAI,KAAK,cAAc;gBAC7B,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAa;IACvD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC"}

package/dist/failure-internals.d.ts

@@ -0,0 +1,8 @@
+interface FailureDetail {
+    readonly cause?: unknown;
+    readonly stack?: string;
+}
+export declare function rememberFailure(target: object, cause: unknown, fallbackStack: string | undefined): void;
+export declare function readFailureDetail(target: object): FailureDetail | undefined;
+export {};
+//# sourceMappingURL=failure-internals.d.ts.map

package/dist/failure-internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-internals.d.ts","sourceRoot":"","sources":["../src/failure-internals.ts"],"names":[],"mappings":"AAAA,UAAU,aAAa;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,IAAI,CAMN;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE3E"}

package/dist/failure-internals.js

@@ -0,0 +1,20 @@
+const details = new WeakMap();
+export function rememberFailure(target, cause, fallbackStack) {
+    const stack = readStack(cause) ?? fallbackStack;
+    details.set(target, {
+        ...(cause === undefined ? {} : { cause }),
+        ...(stack === undefined ? {} : { stack }),
+    });
+}
+export function readFailureDetail(target) {
+    return details.get(target);
+}
+function readStack(value) {
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const property = Object.getOwnPropertyDescriptor(value, "stack");
+    return property && "value" in property && typeof property.value === "string"
+        ? property.value
+        : undefined;
+}
+//# sourceMappingURL=failure-internals.js.map

package/dist/failure-internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-internals.js","sourceRoot":"","sources":["../src/failure-internals.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,GAAG,IAAI,OAAO,EAAyB,CAAC;AAErD,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,KAAc,EACd,aAAiC;IAEjC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAClB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjE,OAAO,QAAQ,IAAI,OAAO,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;QAC1E,CAAC,CAAC,QAAQ,CAAC,KAAK;QAChB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/dist/failure-runtime.d.ts

@@ -0,0 +1,30 @@
+import type { ErrorRetry, FailureBase, FailureKind, FailureOutcome, FailureTag } from "./failure-types.js";
+interface FailureSpec extends FailureBase {
+    readonly id?: string;
+    readonly data?: unknown;
+    readonly retry?: ErrorRetry;
+    readonly afterMs?: number;
+    readonly status?: number;
+    readonly capability?: string;
+    readonly profile?: string;
+    readonly operation?: string;
+}
+export declare class RuntimeFailure {
+    readonly message: string;
+    readonly _tag: FailureTag;
+    readonly kind: FailureKind;
+    readonly outcome: FailureOutcome;
+    readonly code: string;
+    readonly id?: string;
+    readonly data?: unknown;
+    readonly retry?: ErrorRetry;
+    readonly afterMs?: number;
+    readonly status?: number;
+    readonly capability?: string;
+    readonly profile?: string;
+    readonly operation?: string;
+    constructor(spec: FailureSpec, cause: unknown);
+}
+export declare function makeFailure(spec: FailureSpec, cause: unknown): RuntimeFailure;
+export {};
+//# sourceMappingURL=failure-runtime.d.ts.map

package/dist/failure-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-runtime.d.ts","sourceRoot":"","sources":["../src/failure-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACX,MAAM,oBAAoB,CAAC;AAE5B,UAAU,WAAY,SAAQ,WAAW;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAG,cAAc,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO;CAK9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAE7E"}

package/dist/failure-runtime.js

@@ -0,0 +1,25 @@
+import { rememberFailure } from "./failure-internals.js";
+export class RuntimeFailure {
+    message;
+    _tag;
+    kind;
+    outcome;
+    code;
+    id;
+    data;
+    retry;
+    afterMs;
+    status;
+    capability;
+    profile;
+    operation;
+    constructor(spec, cause) {
+        Object.assign(this, spec);
+        rememberFailure(this, cause, undefined);
+        Object.freeze(this);
+    }
+}
+export function makeFailure(spec, cause) {
+    return new RuntimeFailure(spec, cause);
+}
+//# sourceMappingURL=failure-runtime.js.map

package/dist/failure-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-runtime.js","sourceRoot":"","sources":["../src/failure-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAoBzD,MAAM,OAAO,cAAc;IAChB,OAAO,CAAU;IACjB,IAAI,CAAc;IAClB,IAAI,CAAe;IACnB,OAAO,CAAkB;IACzB,IAAI,CAAU;IACd,EAAE,CAAU;IACZ,IAAI,CAAW;IACf,KAAK,CAAc;IACnB,OAAO,CAAU;IACjB,MAAM,CAAU;IAChB,UAAU,CAAU;IACpB,OAAO,CAAU;IACjB,SAAS,CAAU;IAE5B,YAAY,IAAiB,EAAE,KAAc;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1B,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,IAAiB,EAAE,KAAc;IAC3D,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/failure-types.d.ts

@@ -0,0 +1,89 @@
+import type { ErrorRetry, ErrorRetryInput } from "./error-retry.js";
+export type { ErrorRetry, ErrorRetryInput } from "./error-retry.js";
+export type FailureKind = "application" | "provider" | "cancellation" | "timeout" | "defect";
+export type FailureOutcome = "declared-error" | "provider-failure" | "cancelled" | "timeout" | "defect";
+export type FailureTag = "ApplicationFailure" | "ProviderFailure" | "Cancellation" | "Timeout" | "UnexpectedDefect";
+export interface ApplicationFailureOptions {
+    readonly id: string;
+    readonly message: string;
+    readonly data: unknown;
+    readonly retry?: ErrorRetryInput;
+    readonly afterMs?: number;
+    readonly status?: number;
+    readonly cause?: unknown;
+}
+export interface ProviderFailureOptions {
+    readonly cause?: unknown;
+    readonly capability?: string;
+    readonly profile?: string;
+    readonly operation?: string;
+}
+export interface FailureBase {
+    readonly _tag: FailureTag;
+    readonly kind: FailureKind;
+    readonly outcome: FailureOutcome;
+    readonly code: string;
+    readonly message: string;
+}
+export interface ApplicationFailure extends FailureBase {
+    readonly _tag: "ApplicationFailure";
+    readonly kind: "application";
+    readonly outcome: "declared-error";
+    readonly id: string;
+    readonly data: unknown;
+    readonly retry: ErrorRetry;
+    readonly afterMs?: number;
+    readonly status?: number;
+}
+export interface ProviderFailure extends FailureBase {
+    readonly _tag: "ProviderFailure";
+    readonly kind: "provider";
+    readonly outcome: "provider-failure";
+    readonly capability?: string;
+    readonly profile?: string;
+    readonly operation?: string;
+}
+export interface CancellationFailure extends FailureBase {
+    readonly _tag: "Cancellation";
+    readonly kind: "cancellation";
+    readonly outcome: "cancelled";
+}
+export interface TimeoutFailure extends FailureBase {
+    readonly _tag: "Timeout";
+    readonly kind: "timeout";
+    readonly outcome: "timeout";
+}
+export interface UnexpectedDefect extends FailureBase {
+    readonly _tag: "UnexpectedDefect";
+    readonly kind: "defect";
+    readonly outcome: "defect";
+}
+export type InvocationFailure = ApplicationFailure | ProviderFailure | CancellationFailure | TimeoutFailure | UnexpectedDefect;
+export interface NormalizeFailureOptions {
+    readonly signal?: AbortSignal;
+    readonly timedOut?: boolean;
+    readonly source?: "application" | "provider";
+    readonly provider?: Omit<ProviderFailureOptions, "cause">;
+}
+export interface PublicFailureEnvelope {
+    readonly kind: FailureKind;
+    readonly outcome: FailureOutcome;
+    readonly code: string;
+    readonly message: string;
+    readonly data?: import("@relkit/contracts").JsonValue;
+    readonly status?: number;
+    readonly retry?: ErrorRetry;
+    readonly afterMs?: number;
+}
+export interface RedactedFailureDetail {
+    readonly cause?: import("@relkit/contracts").JsonValue;
+    readonly stack?: string;
+}
+export interface FailureTelemetry extends PublicFailureEnvelope {
+    readonly internal?: RedactedFailureDetail;
+}
+export interface FailureTelemetryOptions {
+    readonly mode?: "development" | "test" | "production";
+    readonly redact?: (value: unknown) => import("@relkit/contracts").JsonValue;
+}
+//# sourceMappingURL=failure-types.d.ts.map

package/dist/failure-types.d.ts.map

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

package/dist/failure-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=failure-types.js.map

package/dist/failure-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-types.js","sourceRoot":"","sources":["../src/failure-types.ts"],"names":[],"mappings":""}

package/dist/failure.d.ts

@@ -0,0 +1,18 @@
+import type { ApplicationFailure, ApplicationFailureOptions, CancellationFailure, InvocationFailure, NormalizeFailureOptions, ProviderFailure, ProviderFailureOptions, PublicFailureEnvelope, TimeoutFailure, UnexpectedDefect } from "./failure-types.js";
+export type * from "./failure-types.js";
+export declare function applicationFailure(options: ApplicationFailureOptions): ApplicationFailure;
+export declare function providerFailure(cause: unknown, options?: Omit<ProviderFailureOptions, "cause">): ProviderFailure;
+export declare const cancellationFailure: (cause?: unknown) => CancellationFailure;
+export declare const timeoutFailure: (cause?: unknown) => TimeoutFailure;
+export declare const unexpectedDefect: (cause?: unknown, options?: {
+    readonly code?: string;
+    readonly message?: string;
+}) => UnexpectedDefect;
+export declare const defectFailure: (cause?: unknown, options?: {
+    readonly code?: string;
+    readonly message?: string;
+}) => UnexpectedDefect;
+export declare function normalizeFailure(value: unknown, options?: NormalizeFailureOptions): InvocationFailure;
+export declare function isInvocationFailure(value: unknown): value is InvocationFailure;
+export declare function toPublicEnvelope(value: unknown): PublicFailureEnvelope;
+//# sourceMappingURL=failure.d.ts.map

package/dist/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EAQnB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EAErB,cAAc,EACd,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,mBAAmB,oBAAoB,CAAC;AACxC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAiBzF;AACD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAM,GAClD,eAAe,CAYjB;AACD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,OAAO,KAAG,mBAU5B,CAAC;AAE3B,eAAO,MAAM,cAAc,GAAI,QAAQ,OAAO,KAAG,cAU5B,CAAC;AAEtB,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,OAAO,EACf,UAAU;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC9D,gBAUoB,CAAC;AAExB,eAAO,MAAM,aAAa,WAdhB,OAAO,YACL;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC9D,gBAY0C,CAAC;AAE9C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,uBAA4B,GACpC,iBAAiB,CAgBnB;AAkCD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAiBtE"}