@expandai/sdk 0.16.0 → 0.17.1

package/build/dts/Generated.d.ts.map

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

package/build/dts/HttpClientHelpers.d.ts

@@ -0,0 +1,5 @@
+import { HttpClientError, HttpClientRequest, HttpClientResponse } from '@effect/platform';
+import { Effect, Schema } from 'effect';
+export declare function unexpectedStatus(request: HttpClientRequest.HttpClientRequest, response: HttpClientResponse.HttpClientResponse): Effect.Effect<never, HttpClientError.ResponseError, never>;
+export declare function decodeError<A, I, R>(response: HttpClientResponse.HttpClientResponse, schema: Schema.Schema<A, I, R>): Effect.Effect<never, HttpClientError.ResponseError | import("effect/ParseResult").ParseError | A, R>;
+//# sourceMappingURL=HttpClientHelpers.d.ts.map

package/build/dts/HttpClientHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClientHelpers.d.ts","sourceRoot":"","sources":["../../src/HttpClientHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvC,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,EAC5C,QAAQ,EAAE,kBAAkB,CAAC,kBAAkB,8DAc/C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,wGAEnH"}

package/build/dts/Internal.d.ts

@@ -0,0 +1,49 @@
+import { Cause, Effect, Layer } from 'effect';
+import { ExpandClientError, type ExpandError, ExpandSdkError } from './Error.js';
+import { type BatchedParams, type BatchedResponse, ExpandService, type ExpandServiceOptions, type FetchJsonParams, type FetchJsonResponse, type FetchParams, type FetchResponse, type FetchSearchParams, type FetchSearchResponse, type GetBatchedParams, type GetBatchedResponse, type RequestOptions } from './Service.js';
+/**
+ * Lift a raw failure (HTTP error, parse error, codegen-typed error class, or unrelated throwable)
+ * into the typed `ExpandError` union surfaced by the SDK. Used by `ExpandService` to construct
+ * its public error channel.
+ */
+export declare function toExpandError(error: unknown, timeoutMs: number): ExpandError;
+/**
+ * Decide whether a failure should trigger a retry. Timeouts and connection errors are always
+ * retryable; API errors are retryable only for the standard transient status codes (408/409/429/5xx).
+ */
+export declare function isRetryable(error: unknown, timeoutMs: number): boolean;
+declare const InternalClient_base: Effect.Service.Class<InternalClient, "@expandai/sdk/InternalClient", {
+    readonly effect: Effect.Effect<{
+        readonly fetch: (params: FetchParams, options?: RequestOptions) => Effect.Effect<FetchResponse, ExpandClientError>;
+        readonly fetchJson: (params: FetchJsonParams, options?: RequestOptions) => Effect.Effect<FetchJsonResponse, ExpandClientError>;
+        readonly fetchSearch: (params: FetchSearchParams, options?: RequestOptions) => Effect.Effect<FetchSearchResponse, ExpandClientError>;
+        readonly batched: (params: BatchedParams, options?: RequestOptions) => Effect.Effect<BatchedResponse, ExpandClientError>;
+        readonly getBatched: (id: string, options?: GetBatchedParams & RequestOptions) => Effect.Effect<GetBatchedResponse, ExpandClientError>;
+    }, never, ExpandService>;
+}>;
+/**
+ * Effect-side bridge between {@link ExpandService} and the Promise-based {@link ExpandClient}.
+ *
+ * Exposes the same fetch/batched/getBatched methods as `ExpandService` but with the typed `ExpandError`
+ * channel mapped to the `ExpandClientError` hierarchy that async/await consumers expect. Not exported
+ * from the package — Effect consumers depend on `ExpandService` directly and receive the typed
+ * `ExpandError` unions as-is.
+ */
+export declare class InternalClient extends InternalClient_base {
+    /**
+     * Build a Layer providing `InternalClient` (and its `ExpandService` dependency) from the given
+     * options. The layer can fail at acquisition with `ExpandSdkError` (propagated from
+     * `ExpandService.layer`'s validation); callers running this for a Promise wrapper should pipe
+     * through `translateCause`, which converts via `toPublicError` to the public `ExpandClientError`.
+     */
+    static layer(options?: ExpandServiceOptions): Layer.Layer<InternalClient, ExpandSdkError>;
+    /**
+     * Flatten an Effect failure cause into the value to throw from a Promise wrapper. Typed errors
+     * (`ExpandClientError`, `ExpandSdkError`) pass through `toPublicError` if available; non-failure
+     * causes (defects, interruption) get wrapped in a generic `ExpandClientError`.
+     */
+    static translateCause(cause: Cause.Cause<unknown>): unknown;
+    private static hasPublicErrorTranslator;
+}
+export {};
+//# sourceMappingURL=Internal.d.ts.map

package/build/dts/Internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Internal.d.ts","sourceRoot":"","sources":["../../src/Internal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAW,KAAK,EAA8B,MAAM,QAAQ,CAAA;AAClF,OAAO,EAEN,iBAAiB,EAEjB,KAAK,WAAW,EAChB,cAAc,EAEd,MAAM,YAAY,CAAA;AAEnB,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,MAAM,cAAc,CAAA;AAoBrB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAuF5E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAwBtE;;;iCAeU,WAAW,YACV,cAAc,KACrB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC;qCAIzC,eAAe,YACd,cAAc,KACrB,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;uCAI7C,iBAAiB,YAChB,cAAc,KACrB,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;mCAI/C,aAAa,YACZ,cAAc,KACrB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC;kCAI/C,MAAM,YACD,gBAAgB,GAAG,cAAc,KACxC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,CAAC;;;AAvCzD;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,mBAoClC;IACD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,GAAE,oBAAyB,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,cAAc,CAAC;IAI7F;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO;IAQ3D,OAAO,CAAC,MAAM,CAAC,wBAAwB;CAQvC"}

package/build/dts/Playground.d.ts

@@ -0,0 +1,24 @@
+export declare const DEFAULT_PLAYGROUND_HOST = "https://expand.land";
+export type CitationSource = 'markdown' | 'appendix' | 'statejson';
+/** Snippet location subset needed to build a deep link. Tolerates `null` and `undefined`. */
+export interface CitationLocation {
+    readonly nodeIds?: ReadonlyArray<number> | null;
+    readonly stateJsonSourceId?: number | null;
+}
+/** Whole-snapshot URL: `${host}/s/${snapshotId}`. */
+export declare function playgroundBase(snapshotId: string, host?: string): string;
+/** Origin of a server-provided `meta.playground` URL, for reuse as the host (staging-safe). */
+export declare function playgroundOrigin(metaPlayground: string): string;
+/**
+ * Host to build citation links against: the origin of a server-provided `meta.playground`
+ * (authoritative, staging-safe) when present and parseable, else the caller's fallback.
+ */
+export declare function resolvePlaygroundHost(metaPlayground: string | null | undefined, fallback: string): string;
+/**
+ * Deep link auditing a single snippet:
+ * - `statejson` with a source id → `?id=<stateJsonSourceId>` (opens the JSON evidence object).
+ * - `markdown`/`appendix` with a node id → `/playground#focus=<nodeIds[0]>` (highlights the block).
+ * - otherwise → the whole-snapshot base URL.
+ */
+export declare function citationUrl(snapshotId: string, source: CitationSource, location: CitationLocation | null | undefined, host?: string): string;
+//# sourceMappingURL=Playground.d.ts.map

package/build/dts/Playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Playground.d.ts","sourceRoot":"","sources":["../../src/Playground.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAE5D,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;AAElE,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC/C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1C;AAMD,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAgC,GAAG,MAAM,CAEjG;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUzG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC7C,IAAI,GAAE,MAAgC,GACpC,MAAM,CAYR"}

package/build/dts/Service.d.ts

@@ -0,0 +1,277 @@
+import { HttpClient } from '@effect/platform';
+import { Context, Effect, Layer, Schema } from 'effect';
+import { ExpandSdkError } from './Error.js';
+import { type FetchObjectModeResultWithJson, type FetchSnapshotSearchResultWithJson } from './FetchJson.js';
+import * as Generated from './Generated.js';
+declare const ExpandServiceOptions_base: Schema.Class<ExpandServiceOptions, {
+    /** API key. Falls back to the `EXPAND_API_KEY` environment variable. */
+    apiKey: Schema.optional<typeof Schema.String>;
+    /** API base URL. Defaults to `https://api.expand.ai`. */
+    baseUrl: Schema.optional<typeof Schema.String>;
+    /**
+     * Total wall-clock budget in milliseconds for the operation, including retries and backoff.
+     * Each attempt gets `timeoutMs / (maxRetries + 1)`. Defaults to 60_000.
+     */
+    timeoutMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Number of retry attempts for retryable failures (timeouts, connection errors, 408/409/429/5xx).
+     * Defaults to 2. Note: `batched()` defaults to 0 regardless of this setting; pass `{ maxRetries: N }`
+     * per-call to opt in.
+     */
+    maxRetries: Schema.optional<typeof Schema.Number>;
+}, Schema.Struct.Encoded<{
+    /** API key. Falls back to the `EXPAND_API_KEY` environment variable. */
+    apiKey: Schema.optional<typeof Schema.String>;
+    /** API base URL. Defaults to `https://api.expand.ai`. */
+    baseUrl: Schema.optional<typeof Schema.String>;
+    /**
+     * Total wall-clock budget in milliseconds for the operation, including retries and backoff.
+     * Each attempt gets `timeoutMs / (maxRetries + 1)`. Defaults to 60_000.
+     */
+    timeoutMs: Schema.optional<typeof Schema.Number>;
+    /**
+     * Number of retry attempts for retryable failures (timeouts, connection errors, 408/409/429/5xx).
+     * Defaults to 2. Note: `batched()` defaults to 0 regardless of this setting; pass `{ maxRetries: N }`
+     * per-call to opt in.
+     */
+    maxRetries: Schema.optional<typeof Schema.Number>;
+}>, never, {
+    readonly timeoutMs?: number | undefined;
+} & {
+    readonly apiKey?: string | undefined;
+} & {
+    readonly baseUrl?: string | undefined;
+} & {
+    readonly maxRetries?: number | undefined;
+}, {}, {}>;
+/**
+ * Options accepted by `ExpandService.layer`. All fields are optional; defaults match `ExpandClient`.
+ */
+export declare class ExpandServiceOptions extends ExpandServiceOptions_base {
+}
+declare const RequestOptions_base: Schema.Class<RequestOptions, {
+    /** Override the configured `timeoutMs` for this request. Total wall-clock budget across all attempts. */
+    timeoutMs: Schema.optional<typeof Schema.Number>;
+    /** Override the configured `maxRetries` for this request. */
+    maxRetries: Schema.optional<typeof Schema.Number>;
+}, Schema.Struct.Encoded<{
+    /** Override the configured `timeoutMs` for this request. Total wall-clock budget across all attempts. */
+    timeoutMs: Schema.optional<typeof Schema.Number>;
+    /** Override the configured `maxRetries` for this request. */
+    maxRetries: Schema.optional<typeof Schema.Number>;
+}>, never, {
+    readonly timeoutMs?: number | undefined;
+} & {
+    readonly maxRetries?: number | undefined;
+}, {}, {}>;
+/**
+ * Per-request overrides accepted by `ExpandService.fetch`/`batched`/`getBatched` (and, transitively,
+ * by `ExpandClient`'s methods).
+ */
+export declare class RequestOptions extends RequestOptions_base {
+}
+export type FetchParams = typeof Generated.FetchFetchRequest.Encoded;
+export type FetchResponse = string;
+export type FetchRequestOptions = RequestOptions & typeof Generated.FetchFetchParams.Encoded;
+export type FetchJsonParams = typeof Generated.FetchFetchJsonRequest.Encoded;
+export type FetchJsonResponse = FetchObjectModeResultWithJson;
+export type FetchJsonRequestOptions = RequestOptions & typeof Generated.FetchFetchJsonParams.Encoded;
+export type FetchSearchParams = typeof Generated.FetchFetchSearchRequest.Encoded;
+export type FetchSearchResponse = FetchSnapshotSearchResultWithJson;
+export type BatchedParams = typeof Generated.FetchBatchedRequest.Encoded;
+export type BatchedResponse = typeof Generated.BatchedRun.Type;
+export type GetBatchedParams = typeof Generated.FetchGetBatchedParams.Encoded;
+export type GetBatchedResponse = typeof Generated.BatchedStatus.Type;
+declare const ServiceConfig_base: Schema.Class<ServiceConfig, {
+    apiKey: typeof Schema.NonEmptyString;
+    baseUrl: typeof Schema.NonEmptyString;
+    timeoutMs: typeof Schema.Number;
+    maxRetries: typeof Schema.Number;
+}, Schema.Struct.Encoded<{
+    apiKey: typeof Schema.NonEmptyString;
+    baseUrl: typeof Schema.NonEmptyString;
+    timeoutMs: typeof Schema.Number;
+    maxRetries: typeof Schema.Number;
+}>, never, {
+    readonly timeoutMs: number;
+} & {
+    readonly apiKey: string;
+} & {
+    readonly baseUrl: string;
+} & {
+    readonly maxRetries: number;
+}, {}, {}>;
+declare class ServiceConfig extends ServiceConfig_base {
+}
+declare const ServiceConfigTag_base: Context.TagClass<ServiceConfigTag, "@expandai/sdk/ExpandServiceConfig", ServiceConfig>;
+declare class ServiceConfigTag extends ServiceConfigTag_base {
+}
+/**
+ * Validate user-supplied options into a fully-defaulted `ServiceConfig`. Reads
+ * `EXPAND_API_KEY` from `process.env` when `options.apiKey` is missing. Used by
+ * `ExpandService.layer` (Effect-typed Layer error channel) and by `ExpandClient`
+ * (eagerly via `Effect.runSync` to preserve sync-throw constructor semantics).
+ */
+export declare const buildServiceConfig: (options: ExpandServiceOptions) => Effect.Effect<ServiceConfig, ExpandSdkError, never>;
+declare const ExpandService_base: Effect.Service.Class<ExpandService, "@expandai/sdk/ExpandService", {
+    readonly dependencies: readonly [Layer.Layer<HttpClient.HttpClient, never, never>];
+    readonly effect: Effect.Effect<{
+        readonly fetch: (params: {
+            readonly url: string;
+            readonly include?: {
+                readonly html?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly markdown?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly screenshot?: boolean | {
+                    readonly fullPage?: boolean | null | undefined;
+                } | null | undefined;
+                readonly summary?: boolean | {
+                    readonly prompt?: string | null | undefined;
+                } | null | undefined;
+                readonly links?: boolean | {
+                    readonly skipEmptyText?: boolean | null | undefined;
+                    readonly includeNavigation?: boolean | null | undefined;
+                } | null | undefined;
+                readonly meta?: boolean | null | undefined;
+                readonly response?: boolean | null | undefined;
+                readonly json?: boolean | null | undefined;
+                readonly appendix?: boolean | null | undefined;
+            } | null | undefined;
+            readonly search?: {
+                readonly query: string;
+                readonly maxResults?: number | null | undefined;
+                readonly minScore?: number | null | undefined;
+            } | null | undefined;
+            readonly browserConfig?: {
+                readonly scrollFullPage?: boolean | null | undefined;
+            } | null | undefined;
+        }, requestOptions?: FetchRequestOptions | undefined) => Effect.Effect<string, import("./Error.js").ExpandError, never>;
+        readonly fetchJson: (params: {
+            readonly url: string;
+            readonly include?: {
+                readonly html?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly markdown?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly screenshot?: boolean | {
+                    readonly fullPage?: boolean | null | undefined;
+                } | null | undefined;
+                readonly summary?: boolean | {
+                    readonly prompt?: string | null | undefined;
+                } | null | undefined;
+                readonly links?: boolean | {
+                    readonly skipEmptyText?: boolean | null | undefined;
+                    readonly includeNavigation?: boolean | null | undefined;
+                } | null | undefined;
+                readonly meta?: boolean | null | undefined;
+                readonly response?: boolean | null | undefined;
+                readonly json?: boolean | null | undefined;
+                readonly appendix?: boolean | null | undefined;
+            } | null | undefined;
+            readonly search?: {
+                readonly query: string;
+                readonly maxResults?: number | null | undefined;
+                readonly minScore?: number | null | undefined;
+            } | null | undefined;
+            readonly browserConfig?: {
+                readonly scrollFullPage?: boolean | null | undefined;
+            } | null | undefined;
+        }, requestOptions?: FetchJsonRequestOptions | undefined) => Effect.Effect<FetchObjectModeResultWithJson, import("./Error.js").ExpandError, never>;
+        readonly fetchSearch: (params: {
+            readonly search: {
+                readonly query: string;
+                readonly maxResults?: number | null | undefined;
+                readonly minScore?: number | null | undefined;
+            };
+            readonly snapshotId: string;
+            readonly include?: {
+                readonly html?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly markdown?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly screenshot?: boolean | {
+                    readonly fullPage?: boolean | null | undefined;
+                } | null | undefined;
+                readonly summary?: boolean | {
+                    readonly prompt?: string | null | undefined;
+                } | null | undefined;
+                readonly links?: boolean | {
+                    readonly sameDomainOnly?: boolean | null | undefined;
+                    readonly includePatterns?: readonly string[] | null | undefined;
+                    readonly excludePatterns?: readonly string[] | null | undefined;
+                } | null | undefined;
+                readonly meta?: boolean | null | undefined;
+                readonly response?: {
+                    readonly includeHeaders?: boolean | null | undefined;
+                } | null | undefined;
+                readonly json?: boolean | null | undefined;
+                readonly appendix?: boolean | null | undefined;
+            } | null | undefined;
+        }, requestOptions?: RequestOptions | undefined) => Effect.Effect<FetchSnapshotSearchResultWithJson, import("./Error.js").ExpandError, never>;
+        readonly batched: (params: {
+            readonly urls: readonly [string, ...string[]];
+            readonly include?: {
+                readonly html?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly markdown?: boolean | {
+                    readonly [x: string]: unknown;
+                } | null | undefined;
+                readonly screenshot?: boolean | {
+                    readonly fullPage?: boolean | null | undefined;
+                } | null | undefined;
+                readonly summary?: boolean | {
+                    readonly prompt?: string | null | undefined;
+                } | null | undefined;
+                readonly links?: boolean | {
+                    readonly sameDomainOnly?: boolean | null | undefined;
+                    readonly includePatterns?: readonly string[] | null | undefined;
+                    readonly excludePatterns?: readonly string[] | null | undefined;
+                } | null | undefined;
+                readonly meta?: boolean | null | undefined;
+                readonly response?: {
+                    readonly includeHeaders?: boolean | null | undefined;
+                } | null | undefined;
+                readonly json?: boolean | null | undefined;
+                readonly appendix?: boolean | null | undefined;
+            } | null | undefined;
+            readonly browserConfig?: {
+                readonly scrollFullPage?: boolean | null | undefined;
+            } | null | undefined;
+        }, requestOptions?: RequestOptions | undefined) => Effect.Effect<Generated.BatchedRun, import("./Error.js").ExpandError, never>;
+        readonly getBatched: (id: string, options?: ({
+            readonly include?: string | null | undefined;
+            readonly limit?: string | null | undefined;
+            readonly offset?: string | null | undefined;
+        } & RequestOptions) | undefined) => Effect.Effect<Generated.BatchedStatus, import("./Error.js").ExpandError, never>;
+    }, never, HttpClient.HttpClient | ServiceConfigTag>;
+}>;
+/**
+ * Effect-native client for the Expand API. Mirrors the {@link ExpandClient} Promise interface —
+ * methods accept the same `RequestOptions` per-call overrides and return Effects with the typed
+ * `ExpandError` channel (`ExpandApiError | ExpandConnectionError | ExpandTimeoutError | ExpandSdkError`).
+ *
+ * @example
+ * ```ts
+ * const program = Effect.gen(function* () {
+ *   const expand = yield* ExpandService
+ *   return yield* expand.fetch({ url: 'https://example.com' })
+ * }).pipe(Effect.provide(ExpandService.layer({ apiKey: 'sk_...' })))
+ * ```
+ */
+export declare class ExpandService extends ExpandService_base {
+    /**
+     * Build a Layer providing `ExpandService` with the given options. Validation (missing apiKey,
+     * Schema-rejected config) surfaces via the Layer's error channel as `ExpandSdkError`.
+     */
+    static layer(options?: ExpandServiceOptions): Layer.Layer<ExpandService, ExpandSdkError, never>;
+}
+export {};
+//# sourceMappingURL=Service.d.ts.map

package/build/dts/Service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Service.d.ts","sourceRoot":"","sources":["../../src/Service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,MAAM,kBAAkB,CAAA;AAEpF,OAAO,EAAE,OAAO,EAAY,MAAM,EAAQ,KAAK,EAAY,MAAM,EAAE,MAAM,QAAQ,CAAA;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACN,KAAK,6BAA6B,EAClC,KAAK,iCAAiC,EAGtC,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;;IAazC,wEAAwE;;IAIxE,yDAAyD;;IAIzD;;;OAGG;;IAMH;;;;OAIG;;;IArBH,wEAAwE;;IAIxE,yDAAyD;;IAIzD;;;OAGG;;IAMH;;;;OAIG;;;;;;;;;;;AA1BL;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,yBA+BzC;CAAG;;IAQF,yGAAyG;;IAIzG,6DAA6D;;;IAJ7D,yGAAyG;;IAIzG,6DAA6D;;;;;;;AAV/D;;;GAGG;AACH,qBAAa,cAAe,SAAQ,mBAYnC;CAAG;AAEJ,MAAM,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC,iBAAiB,CAAC,OAAO,CAAA;AACpE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAA;AAClC,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,OAAO,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAA;AAC5F,MAAM,MAAM,eAAe,GAAG,OAAO,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAA;AAG5E,MAAM,MAAM,iBAAiB,GAAG,6BAA6B,CAAA;AAC7D,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG,OAAO,SAAS,CAAC,oBAAoB,CAAC,OAAO,CAAA;AACpG,MAAM,MAAM,iBAAiB,GAAG,OAAO,SAAS,CAAC,uBAAuB,CAAC,OAAO,CAAA;AAChF,MAAM,MAAM,mBAAmB,GAAG,iCAAiC,CAAA;AACnE,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAA;AACxE,MAAM,MAAM,eAAe,GAAG,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,CAAA;AAC9D,MAAM,MAAM,gBAAgB,GAAG,OAAO,SAAS,CAAC,qBAAqB,CAAC,OAAO,CAAA;AAC7E,MAAM,MAAM,kBAAkB,GAAG,OAAO,SAAS,CAAC,aAAa,CAAC,IAAI,CAAA;;;;;;;;;;;;;;;;;;;;AAEpE,cAAM,aAAc,SAAQ,kBAK1B;CAAG;;AAEL,cAAM,gBAAiB,SAAQ,qBAG5B;CAAG;AAEN;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,wFAW7B,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,kBAwHjC;IACD;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,GAAE,oBAAyB;CAO/C"}

package/build/dts/index.d.ts

@@ -0,0 +1,6 @@
+export type { BatchedParams, BatchedResponse, ExpandClientOptions, FetchJsonParams, FetchJsonRequestOptions, FetchJsonResponse, FetchParams, FetchRequestOptions, FetchResponse, FetchSearchParams, FetchSearchResponse, GetBatchedParams, GetBatchedResponse, } from './Client.js';
+export { ExpandClient } from './Client.js';
+export type { ExpandError } from './Error.js';
+export { ExpandApiError, ExpandClientApiError, ExpandClientConnectionError, ExpandClientError, ExpandClientTimeoutError, ExpandConnectionError, ExpandSdkError, ExpandTimeoutError, } from './Error.js';
+export { ExpandService, ExpandServiceOptions, RequestOptions } from './Service.js';
+//# sourceMappingURL=index.d.ts.map

package/build/dts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EACN,cAAc,EACd,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/build/esm/Client.js

@@ -0,0 +1,87 @@
+import { Effect, Either, Exit, Layer } from 'effect';
+import { InternalClient } from './Internal.js';
+import { buildServiceConfig, } from './Service.js';
+/**
+ * Promise-based client for the Expand API. Holds an {@link InternalClient} layer and runs Effects
+ * against it, translating typed failures into the `ExpandClient*Error` hierarchy that async/await
+ * consumers expect.
+ *
+ * @example
+ * ```ts
+ * const client = new ExpandClient({ apiKey: 'sk_...' })
+ * const result = await client.fetch({ url: 'https://example.com' })
+ * ```
+ */
+export class ExpandClient {
+    layer;
+    constructor(options = {}) {
+        // Eagerly validate so the Promise constructor matches the documented sync-throw contract.
+        // `buildServiceConfig` is a pure-sync Effect (env-var read + Schema.decode), so runSync is safe.
+        const result = Effect.runSync(buildServiceConfig(options).pipe(Effect.either));
+        if (Either.isLeft(result)) {
+            throw result.left.toPublicError();
+        }
+        // Validation passed; the layer's acquisition Effect re-runs the same logic, so it cannot fail.
+        // Layer.orDie narrows the error channel to `never` while keeping a die fallback as a defensive
+        // net (translateCause picks up dies via Cause.dieOption and converts via toPublicError).
+        this.layer = InternalClient.layer(options).pipe(Layer.orDie);
+    }
+    /**
+     * Fetch a URL through the Expand API.
+     *
+     * @throws {ExpandClientApiError} on 4xx/5xx responses
+     * @throws {ExpandClientTimeoutError} when the request exceeds `timeoutMs`
+     * @throws {ExpandClientConnectionError} on network failures
+     * @throws {ExpandClientError} for any other failure
+     */
+    async fetch(params, options = {}) {
+        return this.run((client) => client.fetch(params, options));
+    }
+    /**
+     * Fetch a URL through the object-mode endpoint.
+     *
+     * Returns `{ meta, markdown, json }`; use {@link fetch} for the raw markdown document.
+     */
+    async fetchJson(params, options = {}) {
+        return this.run((client) => client.fetchJson(params, options));
+    }
+    /**
+     * Search a previous Fetch response by `snapshotId` without starting a new capture.
+     */
+    async fetchSearch(params, options = {}) {
+        return this.run((client) => client.fetchSearch(params, options));
+    }
+    /**
+     * Kick off an asynchronous batched fetch over one or more URLs. Returns a batched-run ID that can
+     * be polled via {@link getBatched}.
+     *
+     * Retries are disabled by default. Pass `{ maxRetries: N }` to opt in.
+     *
+     * @throws {ExpandClientApiError} on 4xx/5xx responses
+     * @throws {ExpandClientTimeoutError} when the request exceeds `timeoutMs`
+     * @throws {ExpandClientConnectionError} on network failures
+     * @throws {ExpandClientError} for any other failure
+     */
+    async batched(params, options = {}) {
+        return this.run((client) => client.batched(params, options));
+    }
+    /**
+     * Fetch the status and accumulated results for a batched run previously started by {@link batched}.
+     *
+     * @throws {ExpandClientApiError} on 4xx/5xx responses
+     * @throws {ExpandClientTimeoutError} when the request exceeds `timeoutMs`
+     * @throws {ExpandClientConnectionError} on network failures
+     * @throws {ExpandClientError} for any other failure
+     */
+    async getBatched(id, options = {}) {
+        return this.run((client) => client.getBatched(id, options));
+    }
+    async run(body) {
+        const exit = await Effect.runPromiseExit(InternalClient.use(body).pipe(Effect.provide(this.layer)));
+        if (Exit.isSuccess(exit)) {
+            return exit.value;
+        }
+        throw InternalClient.translateCause(exit.cause);
+    }
+}
+//# sourceMappingURL=Client.js.map

package/build/esm/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../../src/Client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAGN,kBAAkB,GAalB,MAAM,cAAc,CAAA;AAoBrB;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IACP,KAAK,CAA6B;IAEnD,YAAY,UAA+B,EAAE;QAC5C,0FAA0F;QAC1F,iGAAiG;QACjG,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;QAC9E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,CAAA;QAClC,CAAC;QACD,+FAA+F;QAC/F,+FAA+F;QAC/F,yFAAyF;QACzF,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,MAAmB,EAAE,UAA+B,EAAE;QACjE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,MAAuB,EAAE,UAAmC,EAAE;QAC7E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB,EAAE,UAA0B,EAAE;QACxE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjE,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CAAC,MAAqB,EAAE,UAA0B,EAAE;QAChE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,UAA6C,EAAE;QAC3E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5D,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,IAAqD;QACzE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACnG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAA;QAClB,CAAC;QACD,MAAM,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChD,CAAC;CACD"}

package/build/esm/Error.js

@@ -0,0 +1,91 @@
+import { Schema } from 'effect';
+/**
+ * Effect-side base error. Schema.TaggedError; Effect consumers receive these in the error channel.
+ */
+export class ExpandSdkError extends Schema.TaggedError()('ExpandSdkError', {
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect),
+}) {
+    toPublicError() {
+        return new ExpandClientError(this.message, { cause: this.cause });
+    }
+}
+/**
+ * Effect-side error for non-2xx API responses. Inspect `status` and `body` for details.
+ */
+export class ExpandApiError extends Schema.TaggedError()('ExpandApiError', {
+    message: Schema.String,
+    status: Schema.Number,
+    body: Schema.optional(Schema.Unknown),
+    cause: Schema.optional(Schema.Defect),
+}) {
+    toPublicError() {
+        return new ExpandClientApiError(this.message, { status: this.status, body: this.body, cause: this.cause });
+    }
+}
+/**
+ * Effect-side error when the SDK cannot reach the API (DNS, connection refused, socket reset, etc.).
+ */
+export class ExpandConnectionError extends Schema.TaggedError()('ExpandConnectionError', {
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect),
+}) {
+    toPublicError() {
+        return new ExpandClientConnectionError(this.message, { cause: this.cause });
+    }
+}
+/**
+ * Effect-side error when a request exceeds its configured `timeoutMs`.
+ */
+export class ExpandTimeoutError extends Schema.TaggedError()('ExpandTimeoutError', {
+    message: Schema.String,
+    timeoutMs: Schema.Number,
+    cause: Schema.optional(Schema.Defect),
+}) {
+    toPublicError() {
+        return new ExpandClientTimeoutError(this.message, { timeoutMs: this.timeoutMs, cause: this.cause });
+    }
+}
+/**
+ * Promise-side base class. Catch this to handle any failure thrown by `ExpandClient`.
+ */
+export class ExpandClientError extends Error {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = 'ExpandClientError';
+    }
+}
+/**
+ * Promise-side error for non-2xx API responses. Inspect `status` and `body` for details.
+ */
+export class ExpandClientApiError extends ExpandClientError {
+    status;
+    body;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ExpandClientApiError';
+        this.status = options.status;
+        this.body = options.body;
+    }
+}
+/**
+ * Promise-side error when the SDK cannot reach the API (DNS, connection refused, socket reset, etc.).
+ */
+export class ExpandClientConnectionError extends ExpandClientError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = 'ExpandClientConnectionError';
+    }
+}
+/**
+ * Promise-side error when a request exceeds its configured `timeoutMs`.
+ */
+export class ExpandClientTimeoutError extends ExpandClientConnectionError {
+    timeoutMs;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ExpandClientTimeoutError';
+        this.timeoutMs = options.timeoutMs;
+    }
+}
+//# sourceMappingURL=Error.js.map

package/build/esm/Error.js.map

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