@scarn/sdk 0.0.0-stage → 0.8.0

package/dist/devcontainer-config-path.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+/**
+ * Wire schema for a step's selected devcontainer config
+ * (`devcontainerConfigPath`): the full repo-relative path to the file the worker
+ * launches instead of searching for one.
+ *
+ * - Repo-relative: no leading `/`, no drive letter, no backslash, no `..`
+ *   segment. A leading `./` is normalized away (`normalizeDevcontainerConfigPath`).
+ * - The basename is `devcontainer.json` or `.devcontainer.json`, the
+ *   devcontainer CLI's own rule for `--config`.
+ * - At most 255 characters.
+ *
+ * Containment against symlinks is a runtime concern the worker re-checks with
+ * `realpath`; this schema is purely lexical.
+ */
+export declare const MAX_DEVCONTAINER_CONFIG_PATH_LENGTH = 255;
+export declare const DEVCONTAINER_CONFIG_BASENAMES: readonly string[];
+/** Strips any leading `./` segments. Leaves every other character untouched. */
+export declare function normalizeDevcontainerConfigPath(path: string): string;
+export declare const devcontainerConfigPathSchema: z.ZodString;
+export type DevcontainerConfigPath = z.output<typeof devcontainerConfigPathSchema>;

package/dist/devcontainer-config-path.js

@@ -0,0 +1,15 @@
+// @bun
+import {
+  DEVCONTAINER_CONFIG_BASENAMES,
+  MAX_DEVCONTAINER_CONFIG_PATH_LENGTH,
+  devcontainerConfigPathSchema,
+  normalizeDevcontainerConfigPath
+} from "./chunk-4ggr8af6.js";
+import"./chunk-skzxcba3.js";
+import"./chunk-y64skrwp.js";
+export {
+  DEVCONTAINER_CONFIG_BASENAMES,
+  MAX_DEVCONTAINER_CONFIG_PATH_LENGTH,
+  devcontainerConfigPathSchema,
+  normalizeDevcontainerConfigPath
+};

package/dist/env-vars.d.ts

@@ -0,0 +1,136 @@
+import { z } from "zod";
+/**
+ * Wire schema for a step's declared environment variables (`envJson`).
+ *
+ * A step declares each variable one of two ways, discriminated on `source`:
+ *
+ * - `value`: a literal or `{{input.…}}` template, stored in the definition
+ *   and rendered per run. `secret` only controls log masking.
+ * - `inherit`: read from the **worker** host at run time (`.scarn/.env`,
+ *   then `process.env`). Only the variable *name* is stored. `mcp`, when set,
+ *   is the step's `opencodeMcpJson` key of the ref'd MCP server the variable
+ *   belongs to; absent means a plain step variable.
+ *
+ * `applies` says which process a variable reaches (default `agent`):
+ *
+ * - `agent`: the agent (or code step) process, as `docker exec -e` argv on a
+ *   container run, hence the entry count and value length caps.
+ * - `setup`: only the `devcontainer up` process, so `initializeCommand` sees
+ *   it. It overrides the worker's own variable of the same name. Scarn never
+ *   adds it to `containerEnv`; the repo forwards it with
+ *   `${localEnv:NAME:default}` if it wants it inside the container.
+ * - `both`: both of the above.
+ *
+ * `setup` and `both` need a container to set up, so they are rejected on a
+ * host (`no_workspace`) step, and on an MCP variable, since MCP servers run
+ * inside the agent.
+ */
+export declare const ENV_VAR_NAME_PATTERN: RegExp;
+/** Names Scarn manages itself; a step may not declare them. */
+export declare const RESERVED_ENV_VAR_NAMES: readonly string[];
+export declare const RESERVED_ENV_VAR_PREFIX = "SCARN_";
+export declare const MAX_ENV_VARS = 64;
+export declare const MAX_ENV_VAR_NAME_LENGTH = 128;
+export declare const MAX_ENV_VAR_VALUE_LENGTH = 4096;
+/** True when `value` interpolates at least one `{{input.…}}` token. */
+export declare function containsInputToken(value: string): boolean;
+export declare function isReservedEnvVarName(name: string): boolean;
+export declare const envVarAppliesValues: readonly ["agent", "setup", "both"];
+export type EnvVarApplies = (typeof envVarAppliesValues)[number];
+/** True when the variable reaches the agent (or code step) process. */
+export declare function appliesToAgent(applies: EnvVarApplies): boolean;
+/** True when the variable reaches the `devcontainer up` process. */
+export declare function appliesToSetup(applies: EnvVarApplies): boolean;
+/**
+ * True when `name` is a worker-side variable an `inherit` entry may not read:
+ * `SCARN_*` carries the worker's own credentials and configuration, which
+ * must never be copied into a step's agent container.
+ */
+export declare function isUninheritableWorkerEnvVarName(name: string): boolean;
+export declare const envVarSpecSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodLiteral<"value">;
+    value: z.ZodString;
+    secret: z.ZodBoolean;
+    applies: z.ZodDefault<z.ZodEnum<{
+        agent: "agent";
+        setup: "setup";
+        both: "both";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodLiteral<"inherit">;
+    from: z.ZodString;
+    secret: z.ZodBoolean;
+    optional: z.ZodBoolean;
+    default: z.ZodOptional<z.ZodString>;
+    mcp: z.ZodOptional<z.ZodString>;
+    applies: z.ZodDefault<z.ZodEnum<{
+        agent: "agent";
+        setup: "setup";
+        both: "both";
+    }>>;
+}, z.core.$strict>], "source">;
+/**
+ * The full value of a step's `envJson`: a bounded list of uniquely named
+ * entries.
+ */
+export declare const envVarsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodLiteral<"value">;
+    value: z.ZodString;
+    secret: z.ZodBoolean;
+    applies: z.ZodDefault<z.ZodEnum<{
+        agent: "agent";
+        setup: "setup";
+        both: "both";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodLiteral<"inherit">;
+    from: z.ZodString;
+    secret: z.ZodBoolean;
+    optional: z.ZodBoolean;
+    default: z.ZodOptional<z.ZodString>;
+    mcp: z.ZodOptional<z.ZodString>;
+    applies: z.ZodDefault<z.ZodEnum<{
+        agent: "agent";
+        setup: "setup";
+        both: "both";
+    }>>;
+}, z.core.$strict>], "source">>;
+/**
+ * Read-side schema for `envJson` as persisted and served. Structural only:
+ * unknown keys are stripped and the write-time refinements (reserved names,
+ * caps, secret rules) are not re-applied, so tightening those rules can never
+ * make an already-stored row unreadable. Only a change to the stored shape
+ * itself can break it, and `test/env-vars-stored-compat.test.ts` pins that.
+ * `applies` reads as `agent` when absent, the behavior before it existed.
+ */
+export declare const storedEnvVarsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodLiteral<"value">;
+    value: z.ZodString;
+    secret: z.ZodBoolean;
+    applies: z.ZodDefault<z.ZodEnum<{
+        agent: "agent";
+        setup: "setup";
+        both: "both";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodLiteral<"inherit">;
+    from: z.ZodString;
+    secret: z.ZodBoolean;
+    optional: z.ZodBoolean;
+    default: z.ZodOptional<z.ZodString>;
+    mcp: z.ZodOptional<z.ZodString>;
+    applies: z.ZodDefault<z.ZodEnum<{
+        agent: "agent";
+        setup: "setup";
+        both: "both";
+    }>>;
+}, z.core.$strip>], "source">>;
+export type EnvVarSpec = z.output<typeof envVarSpecSchema>;
+export type EnvVarSpecInput = z.input<typeof envVarSpecSchema>;
+export type EnvVarsInput = z.input<typeof envVarsSchema>;

package/dist/env-vars.js

@@ -0,0 +1,37 @@
+// @bun
+import {
+  ENV_VAR_NAME_PATTERN,
+  MAX_ENV_VARS,
+  MAX_ENV_VAR_NAME_LENGTH,
+  MAX_ENV_VAR_VALUE_LENGTH,
+  RESERVED_ENV_VAR_NAMES,
+  RESERVED_ENV_VAR_PREFIX,
+  appliesToAgent,
+  appliesToSetup,
+  containsInputToken,
+  envVarAppliesValues,
+  envVarSpecSchema,
+  envVarsSchema,
+  isReservedEnvVarName,
+  isUninheritableWorkerEnvVarName,
+  storedEnvVarsSchema
+} from "./chunk-5zsavw98.js";
+import"./chunk-skzxcba3.js";
+import"./chunk-y64skrwp.js";
+export {
+  ENV_VAR_NAME_PATTERN,
+  MAX_ENV_VARS,
+  MAX_ENV_VAR_NAME_LENGTH,
+  MAX_ENV_VAR_VALUE_LENGTH,
+  RESERVED_ENV_VAR_NAMES,
+  RESERVED_ENV_VAR_PREFIX,
+  appliesToAgent,
+  appliesToSetup,
+  containsInputToken,
+  envVarAppliesValues,
+  envVarSpecSchema,
+  envVarsSchema,
+  isReservedEnvVarName,
+  isUninheritableWorkerEnvVarName,
+  storedEnvVarsSchema
+};

package/dist/eslint.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ESLint plugin for pipeline files written with `@scarn/sdk/pipelines`.
+ *
+ * Pipeline callbacks (`when`, `to` and `otherwise` in `.next(...)`, `.catch`
+ * and `each`'s start) run once, at build time, with references in place of
+ * values. `.partial(args)` takes no callback; its args are checked as part of
+ * the `.next(...)` callback that builds them. JavaScript logic on a reference doesn't branch at run time, so
+ * `no-logic-in-pipeline-callbacks` reports `?:`, `&&`, `||`, `??`, `!`,
+ * comparisons and `if` statements written directly in such a callback.
+ *
+ * Scope:
+ * - Only the callback's own body is checked. Functions nested inside it, such
+ *   as the item callbacks of `some`, `every` and `none`, are not.
+ * - `.catch` is only treated as a pipeline call with two arguments (`on`,
+ *   `target`), so a Promise's one-argument `.catch(handler)` isn't reported.
+ * - `.next` is only treated as a pipeline call with one argument: a function,
+ *   or an object literal with `routes` / `otherwise`. An iterator's
+ *   `.next()` or `.next(value)` isn't reported.
+ * - `each` must be called as a plain identifier with an array reference and a
+ *   start callback; a method named `each` isn't reported.
+ *
+ * Usage (flat config):
+ * ```js
+ * import scarn from "@scarn/sdk/eslint";
+ * export default [scarn.configs.recommended];
+ * ```
+ *
+ * The plugin has no runtime dependencies; `eslint` is only a type import.
+ */
+import type { Linter, Rule } from "eslint";
+declare const rule: Rule.RuleModule;
+declare const plugin: {
+    meta: {
+        name: string;
+    };
+    rules: {
+        "no-logic-in-pipeline-callbacks": Rule.RuleModule;
+    };
+    configs: Record<"recommended", Linter.Config>;
+};
+export { rule as noLogicInPipelineCallbacks };
+export default plugin;

package/dist/eslint.js

@@ -0,0 +1,127 @@
+// @bun
+import"./chunk-y64skrwp.js";
+
+// src/eslint.ts
+var comparisonOperators = new Set([
+  "<",
+  ">",
+  "<=",
+  ">=",
+  "==",
+  "===",
+  "!=",
+  "!=="
+]);
+function isFunction(node) {
+  return node?.type === "ArrowFunctionExpression" || node?.type === "FunctionExpression";
+}
+function propertyNamed(object, name) {
+  if (object?.type !== "ObjectExpression") {
+    return;
+  }
+  for (const property of object.properties) {
+    if (property.type === "Property" && !property.computed && (property.key.type === "Identifier" && property.key.name === name || property.key.type === "Literal" && property.key.value === name)) {
+      return property.value;
+    }
+  }
+  return;
+}
+function nextCallbacks(arg) {
+  if (isFunction(arg)) {
+    return [arg];
+  }
+  const routes = propertyNamed(arg, "routes");
+  const otherwise = propertyNamed(arg, "otherwise");
+  if (routes === undefined && otherwise === undefined) {
+    return [];
+  }
+  const fromRoutes = routes?.type === "ArrayExpression" ? routes.elements.flatMap((route) => route === null || route.type === "SpreadElement" ? [] : [propertyNamed(route, "when"), propertyNamed(route, "to")]) : [];
+  return [...fromRoutes, otherwise].filter((node) => isFunction(node));
+}
+function pipelineCallbacks(call) {
+  const { callee } = call;
+  const args = call.arguments;
+  if (callee.type === "Identifier" && callee.name === "each") {
+    const start = args.at(-1);
+    return args.length >= 2 && isFunction(start) ? [start] : [];
+  }
+  if (callee.type !== "MemberExpression" || callee.computed || callee.property.type !== "Identifier") {
+    return [];
+  }
+  const method = callee.property.name;
+  if (method === "next" && args.length === 1) {
+    return nextCallbacks(args[0]);
+  }
+  if (method === "catch" && args.length === 2) {
+    return isFunction(args[1]) ? [args[1]] : [];
+  }
+  return [];
+}
+var rule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow JavaScript logic inside pipeline callbacks, which run once at build time on references"
+    },
+    schema: [],
+    messages: {
+      logic: "{{kind}} in a pipeline callback runs once at build time on a reference, not at run time. Branch with `.next({ routes: [{ when, to }] })` and a condition helper (`equal`, `all`, `not`, ...) instead."
+    }
+  },
+  create(context) {
+    const callbacks = new WeakSet;
+    function report(node, kind) {
+      let current = node.parent;
+      while (current !== null) {
+        if (current.type === "ArrowFunctionExpression" || current.type === "FunctionExpression" || current.type === "FunctionDeclaration") {
+          if (callbacks.has(current)) {
+            context.report({ node, messageId: "logic", data: { kind } });
+          }
+          return;
+        }
+        current = current.parent;
+      }
+    }
+    return {
+      CallExpression(node) {
+        for (const callback of pipelineCallbacks(node)) {
+          callbacks.add(callback);
+        }
+      },
+      ConditionalExpression(node) {
+        report(node, "A conditional (`?:`)");
+      },
+      LogicalExpression(node) {
+        report(node, `\`${node.operator}\``);
+      },
+      BinaryExpression(node) {
+        if (comparisonOperators.has(node.operator)) {
+          report(node, `A comparison (\`${node.operator}\`)`);
+        }
+      },
+      UnaryExpression(node) {
+        if (node.operator === "!") {
+          report(node, "`!`");
+        }
+      },
+      IfStatement(node) {
+        report(node, "An `if` statement");
+      }
+    };
+  }
+};
+var plugin = {
+  meta: { name: "@scarn/sdk/eslint" },
+  rules: { "no-logic-in-pipeline-callbacks": rule },
+  configs: {}
+};
+plugin.configs.recommended = {
+  name: "@scarn/sdk/eslint/recommended",
+  plugins: { scarn: plugin },
+  rules: { "scarn/no-logic-in-pipeline-callbacks": "error" }
+};
+var eslint_default = plugin;
+export {
+  eslint_default as default,
+  rule as noLogicInPipelineCallbacks
+};

package/dist/generated/client/client.gen.d.ts

@@ -0,0 +1,2 @@
+import type { Client, Config } from './types.gen';
+export declare const createClient: (config?: Config) => Client;

package/dist/generated/client/index.d.ts

@@ -0,0 +1,8 @@
+export type { Auth } from '../core/auth.gen';
+export type { QuerySerializerOptions } from '../core/bodySerializer.gen';
+export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen';
+export { buildClientParams } from '../core/params.gen';
+export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen';
+export { createClient } from './client.gen';
+export type { Client, ClientOptions, Config, CreateClientConfig, Options, RequestOptions, RequestResult, ResolvedRequestOptions, ResponseStyle, TDataShape, } from './types.gen';
+export { createConfig, mergeHeaders } from './utils.gen';

package/dist/generated/client/types.gen.d.ts

@@ -0,0 +1,117 @@
+import type { Auth } from '../core/auth.gen';
+import type { ServerSentEventsOptions, ServerSentEventsResult } from '../core/serverSentEvents.gen';
+import type { Client as CoreClient, Config as CoreConfig } from '../core/types.gen';
+import type { Middleware } from './utils.gen';
+export type ResponseStyle = 'data' | 'fields';
+export interface Config<T extends ClientOptions = ClientOptions> extends Omit<RequestInit, 'body' | 'headers' | 'method'>, CoreConfig {
+    /**
+     * Base URL for all requests made by this client.
+     */
+    baseUrl?: T['baseUrl'];
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Please don't use the Fetch client for Next.js applications. The `next`
+     * options won't have any effect.
+     *
+     * Install {@link https://www.npmjs.com/package/@hey-api/client-next `@hey-api/client-next`} instead.
+     */
+    next?: never;
+    /**
+     * Return the response data parsed in a specified format. By default, `auto`
+     * will infer the appropriate method from the `Content-Type` response header.
+     * You can override this behavior with any of the {@link Body} methods.
+     * Select `stream` if you don't want to parse response data at all.
+     *
+     * @default 'auto'
+     */
+    parseAs?: 'arrayBuffer' | 'auto' | 'blob' | 'formData' | 'json' | 'stream' | 'text';
+    /**
+     * Should we return only data or multiple fields (data, error, response, etc.)?
+     *
+     * @default 'fields'
+     */
+    responseStyle?: ResponseStyle;
+    /**
+     * Throw an error instead of returning it in the response?
+     *
+     * @default false
+     */
+    throwOnError?: T['throwOnError'];
+}
+export interface RequestOptions<TData = unknown, TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config<{
+    responseStyle: TResponseStyle;
+    throwOnError: ThrowOnError;
+}>, Pick<ServerSentEventsOptions<TData>, 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+    /**
+     * Any body that you want to add to your request.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#body}
+     */
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    /**
+     * Security mechanism(s) to use for the request.
+     */
+    security?: ReadonlyArray<Auth>;
+    url: Url;
+}
+export interface ResolvedRequestOptions<TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends RequestOptions<unknown, TResponseStyle, ThrowOnError, Url> {
+    serializedBody?: string;
+}
+export type RequestResult<TData = unknown, TError = unknown, ThrowOnError extends boolean = boolean, TResponseStyle extends ResponseStyle = 'fields'> = ThrowOnError extends true ? Promise<TResponseStyle extends 'data' ? TData extends Record<string, unknown> ? TData[keyof TData] : TData : {
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    request: Request;
+    response: Response;
+}> : Promise<TResponseStyle extends 'data' ? (TData extends Record<string, unknown> ? TData[keyof TData] : TData) | undefined : ({
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    error: undefined;
+} | {
+    data: undefined;
+    error: TError extends Record<string, unknown> ? TError[keyof TError] : TError;
+}) & {
+    request: Request;
+    response: Response;
+}>;
+export interface ClientOptions {
+    baseUrl?: string;
+    responseStyle?: ResponseStyle;
+    throwOnError?: boolean;
+}
+type MethodFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type SseFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'>) => Promise<ServerSentEventsResult<TData, TError>>;
+type RequestFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'> & Pick<Required<RequestOptions<TData, TResponseStyle, ThrowOnError>>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type BuildUrlFn = <TData extends {
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    url: string;
+}>(options: TData & Options<TData>) => string;
+export type Client = CoreClient<RequestFn, Config, MethodFn, BuildUrlFn, SseFn> & {
+    interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
+};
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends ClientOptions = ClientOptions> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
+export interface TDataShape {
+    body?: unknown;
+    headers?: unknown;
+    path?: unknown;
+    query?: unknown;
+    url: string;
+}
+type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
+export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
+export {};

package/dist/generated/client/utils.gen.d.ts

@@ -0,0 +1,33 @@
+import type { QuerySerializerOptions } from '../core/bodySerializer.gen';
+import type { Client, ClientOptions, Config, RequestOptions } from './types.gen';
+export declare const createQuerySerializer: <T = unknown>({ parameters, ...args }?: QuerySerializerOptions) => (queryParams: T) => string;
+/**
+ * Infers parseAs value from provided Content-Type header.
+ */
+export declare const getParseAs: (contentType: string | null) => Exclude<Config["parseAs"], "auto">;
+export declare const setAuthParams: ({ security, ...options }: Pick<Required<RequestOptions>, "security"> & Pick<RequestOptions, "auth" | "query"> & {
+    headers: Headers;
+}) => Promise<void>;
+export declare const buildUrl: Client['buildUrl'];
+export declare const mergeConfigs: (a: Config, b: Config) => Config;
+export declare const mergeHeaders: (...headers: Array<Required<Config>["headers"] | undefined>) => Headers;
+type ErrInterceptor<Err, Res, Req, Options> = (error: Err, response: Res, request: Req, options: Options) => Err | Promise<Err>;
+type ReqInterceptor<Req, Options> = (request: Req, options: Options) => Req | Promise<Req>;
+type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, options: Options) => Res | Promise<Res>;
+declare class Interceptors<Interceptor> {
+    fns: Array<Interceptor | null>;
+    clear(): void;
+    eject(id: number | Interceptor): void;
+    exists(id: number | Interceptor): boolean;
+    getInterceptorIndex(id: number | Interceptor): number;
+    update(id: number | Interceptor, fn: Interceptor): number | Interceptor | false;
+    use(fn: Interceptor): number;
+}
+export interface Middleware<Req, Res, Err, Options> {
+    error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;
+    request: Interceptors<ReqInterceptor<Req, Options>>;
+    response: Interceptors<ResInterceptor<Res, Req, Options>>;
+}
+export declare const createInterceptors: <Req, Res, Err, Options>() => Middleware<Req, Res, Err, Options>;
+export declare const createConfig: <T extends ClientOptions = ClientOptions>(override?: Config<Omit<ClientOptions, keyof T> & T>) => Config<Omit<ClientOptions, keyof T> & T>;
+export {};

package/dist/generated/client.gen.d.ts

@@ -0,0 +1,12 @@
+import { type ClientOptions, type Config } from './client';
+import type { ClientOptions as ClientOptions2 } from './types.gen';
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
+export declare const client: import("./client").Client;

package/dist/generated/core/auth.gen.d.ts

@@ -0,0 +1,18 @@
+export type AuthToken = string | undefined;
+export interface Auth {
+    /**
+     * Which part of the request do we use to send the auth?
+     *
+     * @default 'header'
+     */
+    in?: 'header' | 'query' | 'cookie';
+    /**
+     * Header or query parameter name.
+     *
+     * @default 'Authorization'
+     */
+    name?: string;
+    scheme?: 'basic' | 'bearer';
+    type: 'apiKey' | 'http';
+}
+export declare const getAuthToken: (auth: Auth, callback: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken) => Promise<string | undefined>;

package/dist/generated/core/bodySerializer.gen.d.ts

@@ -0,0 +1,25 @@
+import type { ArrayStyle, ObjectStyle, SerializerOptions } from './pathSerializer.gen';
+export type QuerySerializer = (query: Record<string, unknown>) => string;
+export type BodySerializer = (body: any) => any;
+type QuerySerializerOptionsObject = {
+    allowReserved?: boolean;
+    array?: Partial<SerializerOptions<ArrayStyle>>;
+    object?: Partial<SerializerOptions<ObjectStyle>>;
+};
+export type QuerySerializerOptions = QuerySerializerOptionsObject & {
+    /**
+     * Per-parameter serialization overrides. When provided, these settings
+     * override the global array/object settings for specific parameter names.
+     */
+    parameters?: Record<string, QuerySerializerOptionsObject>;
+};
+export declare const formDataBodySerializer: {
+    bodySerializer: <T extends Record<string, any> | Array<Record<string, any>>>(body: T) => FormData;
+};
+export declare const jsonBodySerializer: {
+    bodySerializer: <T>(body: T) => string;
+};
+export declare const urlSearchParamsBodySerializer: {
+    bodySerializer: <T extends Record<string, any> | Array<Record<string, any>>>(body: T) => string;
+};
+export {};

package/dist/generated/core/params.gen.d.ts

@@ -0,0 +1,43 @@
+type Slot = 'body' | 'headers' | 'path' | 'query';
+export type Field = {
+    in: Exclude<Slot, 'body'>;
+    /**
+     * Field name. This is the name we want the user to see and use.
+     */
+    key: string;
+    /**
+     * Field mapped name. This is the name we want to use in the request.
+     * If omitted, we use the same value as `key`.
+     */
+    map?: string;
+} | {
+    in: Extract<Slot, 'body'>;
+    /**
+     * Key isn't required for bodies.
+     */
+    key?: string;
+    map?: string;
+} | {
+    /**
+     * Field name. This is the name we want the user to see and use.
+     */
+    key: string;
+    /**
+     * Field mapped name. This is the name we want to use in the request.
+     * If `in` is omitted, `map` aliases `key` to the transport layer.
+     */
+    map: Slot;
+};
+export interface Fields {
+    allowExtra?: Partial<Record<Slot, boolean>>;
+    args?: ReadonlyArray<Field>;
+}
+export type FieldsConfig = ReadonlyArray<Field | Fields>;
+interface Params {
+    body: unknown;
+    headers: Record<string, unknown>;
+    path: Record<string, unknown>;
+    query: Record<string, unknown>;
+}
+export declare const buildClientParams: (args: ReadonlyArray<unknown>, fields: FieldsConfig) => Params;
+export {};