@dual-os/sdk 0.0.0-stage → 0.8.0-next.1

package/LICENSE

@@ -0,0 +1,4 @@
+All rights reserved.
+
+This package is proprietary and is not licensed for public use or redistribution.
+Use and distribution require permission from the rights holder under a separate agreement.

package/README.md

@@ -1,3 +1,8 @@
-# Temporary Holding Version
+# @dual-os/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Runtime-neutral integration definitions and execution. Importing the SDK starts no services.
+
+- **Start.** [SDK guide](../docs/content/sdk/index.mdx) and [checked examples](../docs/examples/).
+- **Public API.** The installed package's `exports` and declarations; shipped implementation modules are not supported entrypoints.
+- **Hosting.** [Runtime guide](../docs/content/sdk/runtime.mdx); the SDK does not provision a product deployment.
+- **Distribution.** Private registry access; [release procedure](../../docs/releasing.md).

package/dist/Action.d.ts

@@ -0,0 +1,200 @@
+import { Any as Any$1 } from "./AuthMethod.js";
+import { ContextForMethods } from "./internal/auth-context.js";
+import { Context, Effect, Pipeable, Schema } from "effect";
+import { Headers, HttpClientError } from "effect/http";
+declare namespace Action_d_exports {
+  export { Action, ActionExample, ActionHandlerError, ActionHandlerFailure, ActionOptions, Any, ContractOptions, DeclaredResponseFailure, Handler, HandlerContext, HttpClientFailure, Input, InputSchema, Output, OutputSchema, RetryableActionHandlerError, TypeId, fromHttpClientFailure, handlerKey, isAction, make, orHttpClientFailure };
+}
+/**
+ * @since 0.0.0
+ * @category type ids
+ */
+export declare const TypeId: "@dual-os/sdk/Action";
+/**
+ * @since 0.0.0
+ * @category type ids
+ */
+export type TypeId = typeof TypeId;
+/**
+ * Constraint type for working with any {@link Action}.
+ *
+ * @since 0.0.0
+ * @category type-level
+ */
+export interface Any extends Pipeable.Pipeable {
+  readonly [TypeId]: TypeId;
+  readonly identifier: string;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly input: Schema.Top;
+  readonly output: Schema.Top;
+  readonly examples: readonly ActionExample<unknown>[];
+  readonly requireAuth: boolean;
+}
+/**
+ * Stable action metadata.
+ *
+ * @since 0.0.0
+ * @category models
+ */
+export interface ActionOptions {
+  readonly name?: string | undefined;
+  readonly description?: string | undefined;
+}
+/**
+ * Example input shown alongside an action definition.
+ *
+ * @since 0.0.0
+ * @category models
+ */
+export interface ActionExample<Input> {
+  readonly title?: string;
+  readonly input: Input;
+}
+/**
+ * Handler context exposed to an action implementation.
+ *
+ * @since 0.0.0
+ * @category models
+ */
+export type HandlerContext<EffectiveAuthMethods extends readonly Any$1[]> = ContextForMethods<EffectiveAuthMethods>;
+declare const ActionHandlerError_base: Schema.Class<ActionHandlerError, Schema.TaggedStruct<"ActionHandlerError", {
+  readonly cause: Schema.optional<Schema.Defect>;
+  readonly details: Schema.optional<Schema.Unknown>;
+  readonly message: Schema.String;
+  readonly status: Schema.optional<Schema.Number>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Non-retryable failure reported by a trusted action handler.
+ *
+ * The invoke boundary owns action/provider/version metadata, so handler errors
+ * intentionally describe only the failed operation itself.
+ *
+ * @since 0.0.0
+ * @category errors
+ */
+export declare class ActionHandlerError extends ActionHandlerError_base {}
+declare const RetryableActionHandlerError_base: Schema.Class<RetryableActionHandlerError, Schema.TaggedStruct<"RetryableActionHandlerError", {
+  readonly cause: Schema.optional<Schema.Defect>;
+  readonly details: Schema.optional<Schema.Unknown>;
+  readonly message: Schema.String;
+  readonly retryAfterSeconds: Schema.optional<Schema.Number>;
+  readonly status: Schema.optional<Schema.Number>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Retryable failure reported by a trusted action handler.
+ *
+ * @since 0.0.0
+ * @category errors
+ */
+export declare class RetryableActionHandlerError extends RetryableActionHandlerError_base {}
+/** @since 0.0.0 @category errors */
+export type ActionHandlerFailure = ActionHandlerError | RetryableActionHandlerError;
+/**
+ * Failures produced while an Effect HTTP client executes or decodes a request.
+ *
+ * @since 0.0.0
+ * @category errors
+ */
+export type HttpClientFailure = HttpClientError.HttpClientError | Schema.SchemaError;
+/**
+ * A response the provider declared as an error, as a generated client raises it:
+ * the received response plus its decoded body.
+ *
+ * @since 0.0.0
+ * @category errors
+ */
+export interface DeclaredResponseFailure {
+  readonly response: {
+    readonly status: number;
+    readonly headers: Headers.Headers;
+  };
+  readonly cause: unknown;
+}
+/**
+ * Map an Effect HTTP client failure to the action failure contract.
+ *
+ * Transport failures, rate limits, and server errors can be retried, carrying
+ * the provider's Retry-After delay (at most an hour) when the response sent
+ * one. Request construction, response decoding, declared client errors, and
+ * other client errors are terminal.
+ *
+ * @since 0.0.0
+ * @category errors
+ */
+export declare const fromHttpClientFailure: (error: HttpClientFailure | DeclaredResponseFailure) => ActionHandlerFailure;
+/**
+ * Map an Effect HTTP client effect onto the action failure contract.
+ *
+ * @since 0.0.0
+ * @category errors
+ */
+export declare const orHttpClientFailure: <A, R>(effect: Effect.Effect<A, HttpClientFailure | DeclaredResponseFailure, R>) => Effect.Effect<A, ActionHandlerFailure, R>;
+/**
+ * A runtime handler service for one canonical action id.
+ *
+ * @since 0.0.0
+ * @category models
+ */
+export interface Handler<ActionId extends string = string> {
+  readonly _: unique symbol;
+  readonly actionId: ActionId;
+  readonly context: Context.Context<never>;
+  readonly handler: (input: unknown, context: unknown) => Effect.Effect<unknown, ActionHandlerFailure, unknown>;
+}
+/**
+ * Context key used for the action handler with the supplied canonical id.
+ *
+ * @since 0.0.0
+ * @category handlers
+ */
+export declare const handlerKey: (actionId: string) => string;
+/**
+ * Options used to declare an action contract.
+ *
+ * @since 0.6.0
+ * @category models
+ */
+export interface ContractOptions<Input extends Schema.Top, Output extends Schema.Top, RequireAuth extends boolean> extends ActionOptions {
+  readonly input: Input;
+  readonly output: Output;
+  readonly examples?: readonly ActionExample<Schema.Schema.Type<Input>>[];
+  /** Set to `false` to make a connection optional for this action. */
+  readonly requireAuth?: RequireAuth;
+}
+/**
+ * A typed action declaration.
+ *
+ * @since 0.0.0
+ * @category models
+ */
+export interface Action<out Identifier extends string = string, out Input extends Schema.Top = Schema.Top, out Output extends Schema.Top = Schema.Top, out RequireAuth extends boolean = boolean> extends Pipeable.Pipeable {
+  readonly [TypeId]: TypeId;
+  readonly identifier: Identifier;
+  readonly name: string | undefined;
+  readonly description: string | undefined;
+  readonly input: Input;
+  readonly output: Output;
+  readonly examples: readonly ActionExample<Schema.Schema.Type<Input>>[];
+  readonly requireAuth: RequireAuth;
+}
+export type InputSchema<ActionDef extends Any> = ActionDef["input"];
+export type OutputSchema<ActionDef extends Any> = ActionDef["output"];
+export type Input<ActionDef extends Any> = Schema.Schema.Type<InputSchema<ActionDef>>;
+export type Output<ActionDef extends Any> = Schema.Schema.Type<OutputSchema<ActionDef>>;
+/**
+ * Create an {@link Action} from its contract.
+ *
+ * @since 0.0.0
+ * @category constructors
+ */
+export declare const make: <const Identifier extends string, Input extends Schema.Top, Output extends Schema.Top, const RequireAuth extends boolean = true>(identifier: Identifier, options: ContractOptions<Input, Output, RequireAuth>) => Action<Identifier, Input, Output, RequireAuth>;
+/**
+ * Check if a value is an {@link Action}.
+ *
+ * @since 0.0.0
+ * @category guards
+ */
+export declare const isAction: (u: unknown) => u is Any;
+export { Action_d_exports };
+//# sourceMappingURL=Action.d.ts.map

package/dist/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","names":["AuthMethod.Any"],"sources":["../src/Action.ts"],"mappings":";;;;;;;;;;;qBA8Ba;;;;;YAMD,gBAAgB;;;;;;;iBAQX,YAAY,SAAS;YAC1B,SAAS;WACV;WACA;WACA;WACA,OAAO,OAAO;WACd,QAAQ,OAAO;WACf,mBAAmB;WACnB;;;;;;;;iBASM;WACN;WACA;;;;;;;;iBASM,cAAc;WACpB;WACA,OAAO;;;;;;;;YASN,eAAe,sCAAsCA,WAC/D,kBAAkB;;;;;;;;;;;;;;;;qBAWP,2BAA2B;;;;;;;;;;;;;;qBAgB3B,oCAAoC;;YAYrC,uBAAuB,qBAAqB;;;;;;;YAQ5C,oBAAoB,gBAAgB,kBAAkB,OAAO;;;;;;;;iBASxD;WACN;aAAqB;aAAyB,SAAS,QAAQ;;WAC/D;;;;;;;;;;;;;qBAiEE,wBAAqB,OACzB,oBAAoB,4BAC1B;;;;;;;qBAgDU,sBAAuB,GAAG,GAAC,QAC9B,OAAO,OAAO,GAAG,oBAAoB,yBAAyB,OACrE,OAAO,OAAO,GAAG,sBAAsB;;;;;;;iBAQzB,QAAQ;WACd;WACA,UAAU;WACV,SAAS,QAAQ;WACjB,UACP,gBACA,qBACG,OAAO,gBAAgB;;;;;;;;qBASjB,aAAU;;;;;;;iBAQN,gBACf,cAAc,OAAO,KACrB,eAAe,OAAO,KACtB,qCACQ;WACC,OAAO;WACP,QAAQ;WACR,oBAAoB,cAAc,OAAO,OAAO,KAAK;;WAErD,cAAc;;;;;;;;iBASR,WACX,wCACA,cAAc,OAAO,MAAM,OAAO,SAClC,eAAe,OAAO,MAAM,OAAO,SACnC,+CAEI,SAAS;YACP,SAAS;WACV,YAAY;WACZ;WACA;WACA,OAAO;WACP,QAAQ;WACR,mBAAmB,cAAc,OAAO,OAAO,KAAK;WACpD,aAAa;;YAGZ,YAAY,kBAAkB,OAAO;YAErC,aAAa,kBAAkB,OAAO;YAEtC,MAAM,kBAAkB,OAAO,OAAO,OAAO,KAAK,YAAY;YAE9D,OAAO,kBAAkB,OAAO,OAAO,OAAO,KAAK,aAAa;;;;;;;qBAU/D,aACL,2BACN,cAAc,OAAO,KACrB,eAAe,OAAO,WAChB,oCAAkC,YAE5B,YAAU,SACb,gBAAgB,OAAO,QAAQ,iBACvC,OAAO,YAAY,OAAO,QAAQ;;;;;;;qBAmBxB,WAAQ,eAAiB,KAAK"}

package/dist/Action.js

@@ -0,0 +1,171 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { validateIdentifier } from "./internal/identifier.js";
+import { PipeableProto } from "./internal/proto.js";
+import { Array, DateTime, Duration, Effect, Match, Number, Option, Predicate, Schema, pipe } from "effect";
+import { Headers, HttpClientError } from "effect/http";
+// src/Action.ts
+var Action_exports = /* @__PURE__ */ __exportAll({
+	ActionHandlerError: () => ActionHandlerError,
+	RetryableActionHandlerError: () => RetryableActionHandlerError,
+	TypeId: () => TypeId,
+	fromHttpClientFailure: () => fromHttpClientFailure,
+	handlerKey: () => handlerKey,
+	isAction: () => isAction,
+	make: () => make,
+	orHttpClientFailure: () => orHttpClientFailure
+});
+/**
+* @since 0.0.0
+* @category type ids
+*/
+const TypeId = "@dual-os/sdk/Action";
+/**
+* Non-retryable failure reported by a trusted action handler.
+*
+* The invoke boundary owns action/provider/version metadata, so handler errors
+* intentionally describe only the failed operation itself.
+*
+* @since 0.0.0
+* @category errors
+*/
+var ActionHandlerError = class extends Schema.TaggedError()("ActionHandlerError", {
+	cause: Schema.optional(Schema.Defect()),
+	details: Schema.optional(Schema.Unknown),
+	message: Schema.String,
+	status: Schema.optional(Schema.Number)
+}) {};
+/**
+* Retryable failure reported by a trusted action handler.
+*
+* @since 0.0.0
+* @category errors
+*/
+var RetryableActionHandlerError = class extends Schema.TaggedError()("RetryableActionHandlerError", {
+	cause: Schema.optional(Schema.Defect()),
+	details: Schema.optional(Schema.Unknown),
+	message: Schema.String,
+	retryAfterSeconds: Schema.optional(Schema.Number),
+	status: Schema.optional(Schema.Number)
+}) {};
+function retryAfterSeconds(headers) {
+	return pipe(Option.fromNullishOr(headers), Option.flatMap(Headers.get("retry-after")), Option.flatMap((value) => Option.orElse(Number.parse(value), () => Option.map(DateTime.make(value), (date) => Duration.toSeconds(DateTime.distance(DateTime.nowUnsafe(), date))))), Option.map(Number.clamp({
+		maximum: 3600,
+		minimum: 0
+	})), Option.getOrUndefined);
+}
+function schemaIssuesAt(issue, path) {
+	return pipe(Match.value(issue), Match.tags({
+		AnyOf: (anyOf) => Array.match(anyOf.issues, {
+			onEmpty: () => [{
+				kind: anyOf._tag,
+				path
+			}],
+			onNonEmpty: (issues) => Array.flatMap(issues, (inner) => schemaIssuesAt(inner, path))
+		}),
+		Composite: (composite) => Array.flatMap(composite.issues, (inner) => schemaIssuesAt(inner, path)),
+		Encoding: (encoding) => schemaIssuesAt(encoding.issue, path),
+		Pointer: (pointer) => schemaIssuesAt(pointer.issue, [...path, ...pointer.path])
+	}), Match.orElse((leaf) => [{
+		kind: leaf._tag,
+		path
+	}]));
+}
+function schemaIssues(issue) {
+	return Array.map(schemaIssuesAt(issue, []), (located) => ({
+		kind: located.kind,
+		path: Array.filter(located.path, Predicate.or(Predicate.isString, Predicate.isNumber))
+	}));
+}
+/**
+* Map an Effect HTTP client failure to the action failure contract.
+*
+* Transport failures, rate limits, and server errors can be retried, carrying
+* the provider's Retry-After delay (at most an hour) when the response sent
+* one. Request construction, response decoding, declared client errors, and
+* other client errors are terminal.
+*
+* @since 0.0.0
+* @category errors
+*/
+const fromHttpClientFailure = (error) => {
+	if (Schema.isSchemaError(error)) return new ActionHandlerError({
+		cause: error,
+		details: {
+			issues: schemaIssues(error.issue),
+			reason: "SchemaError"
+		},
+		message: "HTTP response did not match the expected schema"
+	});
+	if (!HttpClientError.isHttpClientError(error)) {
+		const status = error.response.status;
+		const fields = {
+			details: error.cause,
+			message: `HTTP request failed with status ${status}`,
+			status
+		};
+		return status === 429 || status >= 500 ? RetryableActionHandlerError.make({
+			...fields,
+			retryAfterSeconds: retryAfterSeconds(error.response.headers)
+		}) : new ActionHandlerError(fields);
+	}
+	const status = error.response?.status;
+	const fields = {
+		message: status === void 0 ? "HTTP request failed" : `HTTP request failed with status ${status}`,
+		...status === void 0 ? {} : { status },
+		details: {
+			method: error.request.method,
+			reason: error.reason._tag
+		},
+		cause: error
+	};
+	return error.reason._tag === "TransportError" || status === 429 || status !== void 0 && status >= 500 ? RetryableActionHandlerError.make({
+		...fields,
+		retryAfterSeconds: retryAfterSeconds(error.response?.headers)
+	}) : new ActionHandlerError(fields);
+};
+/**
+* Map an Effect HTTP client effect onto the action failure contract.
+*
+* @since 0.0.0
+* @category errors
+*/
+const orHttpClientFailure = (effect) => Effect.mapError(effect, fromHttpClientFailure);
+/**
+* Context key used for the action handler with the supplied canonical id.
+*
+* @since 0.0.0
+* @category handlers
+*/
+const handlerKey = (actionId) => `@dual-os/sdk/Action/Handler/${actionId}`;
+const Proto = {
+	...PipeableProto,
+	[TypeId]: TypeId
+};
+/**
+* Create an {@link Action} from its contract.
+*
+* @since 0.0.0
+* @category constructors
+*/
+const make = (identifier, options) => {
+	validateIdentifier("action", identifier);
+	return Object.assign(Object.create(Proto), {
+		description: options.description,
+		examples: options.examples ?? [],
+		identifier,
+		input: options.input,
+		name: options.name,
+		output: options.output,
+		requireAuth: options.requireAuth ?? true
+	});
+};
+/**
+* Check if a value is an {@link Action}.
+*
+* @since 0.0.0
+* @category guards
+*/
+const isAction = (u) => Predicate.hasProperty(u, TypeId);
+export { ActionHandlerError, Action_exports, RetryableActionHandlerError, TypeId, fromHttpClientFailure, handlerKey, isAction, make, orHttpClientFailure };
+
+//# sourceMappingURL=Action.js.map

package/dist/Action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.js","names":[],"sources":["../src/Action.ts"],"sourcesContent":["/**\n * Canonical action definition builders and types for the Dual SDK.\n *\n * @since 0.0.0\n */\nimport type { Context, Pipeable, SchemaIssue } from \"effect\";\nimport {\n  Array,\n  DateTime,\n  Duration,\n  Effect,\n  Match,\n  Number,\n  Option,\n  pipe,\n  Predicate,\n  Schema,\n} from \"effect\";\n\nimport { Headers, HttpClientError } from \"effect/http\";\n\nimport type * as AuthMethod from \"./AuthMethod.ts\";\nimport type { ContextForMethods } from \"./internal/auth-context.ts\";\nimport { validateIdentifier } from \"./internal/identifier.ts\";\nimport { PipeableProto } from \"./internal/proto.ts\";\n\n/**\n * @since 0.0.0\n * @category type ids\n */\nexport const TypeId = \"@dual-os/sdk/Action\" as const;\n\n/**\n * @since 0.0.0\n * @category type ids\n */\nexport type TypeId = typeof TypeId;\n\n/**\n * Constraint type for working with any {@link Action}.\n *\n * @since 0.0.0\n * @category type-level\n */\nexport interface Any extends Pipeable.Pipeable {\n  readonly [TypeId]: TypeId;\n  readonly identifier: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly input: Schema.Top;\n  readonly output: Schema.Top;\n  readonly examples: readonly ActionExample<unknown>[];\n  readonly requireAuth: boolean;\n}\n\n/**\n * Stable action metadata.\n *\n * @since 0.0.0\n * @category models\n */\nexport interface ActionOptions {\n  readonly name?: string | undefined;\n  readonly description?: string | undefined;\n}\n\n/**\n * Example input shown alongside an action definition.\n *\n * @since 0.0.0\n * @category models\n */\nexport interface ActionExample<Input> {\n  readonly title?: string;\n  readonly input: Input;\n}\n\n/**\n * Handler context exposed to an action implementation.\n *\n * @since 0.0.0\n * @category models\n */\nexport type HandlerContext<EffectiveAuthMethods extends readonly AuthMethod.Any[]> =\n  ContextForMethods<EffectiveAuthMethods>;\n\n/**\n * Non-retryable failure reported by a trusted action handler.\n *\n * The invoke boundary owns action/provider/version metadata, so handler errors\n * intentionally describe only the failed operation itself.\n *\n * @since 0.0.0\n * @category errors\n */\nexport class ActionHandlerError extends Schema.TaggedError<ActionHandlerError>()(\n  \"ActionHandlerError\",\n  {\n    cause: Schema.optional(Schema.Defect()),\n    details: Schema.optional(Schema.Unknown),\n    message: Schema.String,\n    status: Schema.optional(Schema.Number),\n  },\n) {}\n\n/**\n * Retryable failure reported by a trusted action handler.\n *\n * @since 0.0.0\n * @category errors\n */\nexport class RetryableActionHandlerError extends Schema.TaggedError<RetryableActionHandlerError>()(\n  \"RetryableActionHandlerError\",\n  {\n    cause: Schema.optional(Schema.Defect()),\n    details: Schema.optional(Schema.Unknown),\n    message: Schema.String,\n    retryAfterSeconds: Schema.optional(Schema.Number),\n    status: Schema.optional(Schema.Number),\n  },\n) {}\n\n/** @since 0.0.0 @category errors */\nexport type ActionHandlerFailure = ActionHandlerError | RetryableActionHandlerError;\n\n/**\n * Failures produced while an Effect HTTP client executes or decodes a request.\n *\n * @since 0.0.0\n * @category errors\n */\nexport type HttpClientFailure = HttpClientError.HttpClientError | Schema.SchemaError;\n\n/**\n * A response the provider declared as an error, as a generated client raises it:\n * the received response plus its decoded body.\n *\n * @since 0.0.0\n * @category errors\n */\nexport interface DeclaredResponseFailure {\n  readonly response: { readonly status: number; readonly headers: Headers.Headers };\n  readonly cause: unknown;\n}\n\nfunction retryAfterSeconds(headers?: Headers.Headers) {\n  return pipe(\n    Option.fromNullishOr(headers),\n    Option.flatMap(Headers.get(\"retry-after\")),\n    Option.flatMap(value =>\n      Option.orElse(Number.parse(value), () =>\n        Option.map(DateTime.make(value), date =>\n          Duration.toSeconds(DateTime.distance(DateTime.nowUnsafe(), date)),\n        ),\n      ),\n    ),\n    Option.map(Number.clamp({ maximum: 3600, minimum: 0 })),\n    Option.getOrUndefined,\n  );\n}\n\ninterface SchemaIssueAt {\n  readonly kind: string;\n  readonly path: ReadonlyArray<PropertyKey>;\n}\n\n// Where a response broke its schema and how, as issue tags only. Effect's formatters can quote\n// the received value, such as an unmatched union member, and failure details are stored with\n// the run, so the provider's data stays out of them.\nfunction schemaIssuesAt(\n  issue: SchemaIssue.Issue,\n  path: ReadonlyArray<PropertyKey>,\n): Array<SchemaIssueAt> {\n  return pipe(\n    Match.value(issue),\n    Match.tags({\n      AnyOf: anyOf =>\n        Array.match(anyOf.issues, {\n          onEmpty: () => [{ kind: anyOf._tag, path }],\n          onNonEmpty: issues => Array.flatMap(issues, inner => schemaIssuesAt(inner, path)),\n        }),\n      Composite: composite => Array.flatMap(composite.issues, inner => schemaIssuesAt(inner, path)),\n      Encoding: encoding => schemaIssuesAt(encoding.issue, path),\n      Pointer: pointer => schemaIssuesAt(pointer.issue, [...path, ...pointer.path]),\n    }),\n    Match.orElse(leaf => [{ kind: leaf._tag, path }]),\n  );\n}\n\nfunction schemaIssues(issue: SchemaIssue.Issue) {\n  return Array.map(schemaIssuesAt(issue, []), located => ({\n    kind: located.kind,\n    path: Array.filter(located.path, Predicate.or(Predicate.isString, Predicate.isNumber)),\n  }));\n}\n\n/**\n * Map an Effect HTTP client failure to the action failure contract.\n *\n * Transport failures, rate limits, and server errors can be retried, carrying\n * the provider's Retry-After delay (at most an hour) when the response sent\n * one. Request construction, response decoding, declared client errors, and\n * other client errors are terminal.\n *\n * @since 0.0.0\n * @category errors\n */\nexport const fromHttpClientFailure = (\n  error: HttpClientFailure | DeclaredResponseFailure,\n): ActionHandlerFailure => {\n  if (Schema.isSchemaError(error)) {\n    return new ActionHandlerError({\n      cause: error,\n      details: { issues: schemaIssues(error.issue), reason: \"SchemaError\" },\n      message: \"HTTP response did not match the expected schema\",\n    });\n  }\n  if (!HttpClientError.isHttpClientError(error)) {\n    const status = error.response.status;\n    const fields = {\n      details: error.cause,\n      message: `HTTP request failed with status ${status}`,\n      status,\n    };\n    return status === 429 || status >= 500\n      ? RetryableActionHandlerError.make({\n          ...fields,\n          retryAfterSeconds: retryAfterSeconds(error.response.headers),\n        })\n      : new ActionHandlerError(fields);\n  }\n\n  const status = error.response?.status;\n  const fields = {\n    message:\n      status === undefined ? \"HTTP request failed\" : `HTTP request failed with status ${status}`,\n    ...(status === undefined ? {} : { status }),\n    details: { method: error.request.method, reason: error.reason._tag },\n    cause: error,\n  };\n\n  return error.reason._tag === \"TransportError\" ||\n    status === 429 ||\n    (status !== undefined && status >= 500)\n    ? RetryableActionHandlerError.make({\n        ...fields,\n        retryAfterSeconds: retryAfterSeconds(error.response?.headers),\n      })\n    : new ActionHandlerError(fields);\n};\n\n/**\n * Map an Effect HTTP client effect onto the action failure contract.\n *\n * @since 0.0.0\n * @category errors\n */\nexport const orHttpClientFailure = <A, R>(\n  effect: Effect.Effect<A, HttpClientFailure | DeclaredResponseFailure, R>,\n): Effect.Effect<A, ActionHandlerFailure, R> => Effect.mapError(effect, fromHttpClientFailure);\n\n/**\n * A runtime handler service for one canonical action id.\n *\n * @since 0.0.0\n * @category models\n */\nexport interface Handler<ActionId extends string = string> {\n  readonly _: unique symbol;\n  readonly actionId: ActionId;\n  readonly context: Context.Context<never>;\n  readonly handler: (\n    input: unknown,\n    context: unknown,\n  ) => Effect.Effect<unknown, ActionHandlerFailure, unknown>;\n}\n\n/**\n * Context key used for the action handler with the supplied canonical id.\n *\n * @since 0.0.0\n * @category handlers\n */\nexport const handlerKey = (actionId: string): string => `@dual-os/sdk/Action/Handler/${actionId}`;\n\n/**\n * Options used to declare an action contract.\n *\n * @since 0.6.0\n * @category models\n */\nexport interface ContractOptions<\n  Input extends Schema.Top,\n  Output extends Schema.Top,\n  RequireAuth extends boolean,\n> extends ActionOptions {\n  readonly input: Input;\n  readonly output: Output;\n  readonly examples?: readonly ActionExample<Schema.Schema.Type<Input>>[];\n  /** Set to `false` to make a connection optional for this action. */\n  readonly requireAuth?: RequireAuth;\n}\n\n/**\n * A typed action declaration.\n *\n * @since 0.0.0\n * @category models\n */\nexport interface Action<\n  out Identifier extends string = string,\n  out Input extends Schema.Top = Schema.Top,\n  out Output extends Schema.Top = Schema.Top,\n  out RequireAuth extends boolean = boolean,\n>\n  extends Pipeable.Pipeable {\n  readonly [TypeId]: TypeId;\n  readonly identifier: Identifier;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly input: Input;\n  readonly output: Output;\n  readonly examples: readonly ActionExample<Schema.Schema.Type<Input>>[];\n  readonly requireAuth: RequireAuth;\n}\n\nexport type InputSchema<ActionDef extends Any> = ActionDef[\"input\"];\n\nexport type OutputSchema<ActionDef extends Any> = ActionDef[\"output\"];\n\nexport type Input<ActionDef extends Any> = Schema.Schema.Type<InputSchema<ActionDef>>;\n\nexport type Output<ActionDef extends Any> = Schema.Schema.Type<OutputSchema<ActionDef>>;\n\nconst Proto = { ...PipeableProto, [TypeId]: TypeId };\n\n/**\n * Create an {@link Action} from its contract.\n *\n * @since 0.0.0\n * @category constructors\n */\nexport const make = <\n  const Identifier extends string,\n  Input extends Schema.Top,\n  Output extends Schema.Top,\n  const RequireAuth extends boolean = true,\n>(\n  identifier: Identifier,\n  options: ContractOptions<Input, Output, RequireAuth>,\n): Action<Identifier, Input, Output, RequireAuth> => {\n  validateIdentifier(\"action\", identifier);\n  return Object.assign(Object.create(Proto), {\n    description: options.description,\n    examples: options.examples ?? [],\n    identifier,\n    input: options.input,\n    name: options.name,\n    output: options.output,\n    requireAuth: options.requireAuth ?? true,\n  });\n};\n\n/**\n * Check if a value is an {@link Action}.\n *\n * @since 0.0.0\n * @category guards\n */\nexport const isAction = (u: unknown): u is Any => Predicate.hasProperty(u, TypeId);\n"],"mappings":"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"}