@executor-js/plugin-openapi 1.4.28 → 1.4.30

package/dist/sdk/plugin.d.ts

@@ -1,27 +1,32 @@
-import { Effect, Option } from "effect";
+import { Effect, Option, Schema } from "effect";
 import type { Layer } from "effect";
 import { HttpClient } from "effect/unstable/http";
-import { type StorageFailure } from "@executor-js/sdk/core";
+import { CredentialBindingRef, type StorageFailure } from "@executor-js/sdk/core";
 import { type ConfigFileSink } from "@executor-js/config";
 import { OpenApiExtractionError, OpenApiOAuthError, OpenApiParseError } from "./errors";
-import { SpecPreview } from "./preview";
+import { type SpecPreview } from "./preview";
 import { type OpenapiStore, type SourceConfig, type StoredSource } from "./store";
-import { OAuth2SourceConfig, OpenApiSourceBindingInput, OpenApiSourceBindingRef, type OpenApiCredentialInput as OpenApiCredentialInputValue, type ConfiguredHeaderValue as ConfiguredHeaderValueValue, type HeaderValue as HeaderValueValue } from "./types";
+import { OAuth2SourceConfig, type ConfiguredHeaderValue as ConfiguredHeaderValueValue, type HeaderValue as HeaderValueValue } from "./types";
 export type HeaderValue = HeaderValueValue;
 export type ConfiguredHeaderValue = ConfiguredHeaderValueValue;
-export type OpenApiHeaderInput = HeaderValue | ConfiguredHeaderValue;
-export type OpenApiCredentialInput = OpenApiCredentialInputValue;
 export type OpenApiOAuthInput = OAuth2SourceConfig;
+export type OpenApiSpecInput = typeof OpenApiSpecInputSchema.Type;
+export type OpenApiSecretShapeInput = typeof OpenApiSecretShapeInputSchema.Type;
+export type OpenApiConfiguredValueInput = string | OpenApiSecretShapeInput | ConfiguredHeaderValueValue;
 export interface OpenApiSpecFetchCredentialsInput {
+    readonly headers?: Record<string, OpenApiConfiguredValueInput>;
+    readonly queryParams?: Record<string, OpenApiConfiguredValueInput>;
+}
+export interface OpenApiPreviewSpecFetchCredentialsInput {
     readonly headers?: Record<string, HeaderValue>;
     readonly queryParams?: Record<string, HeaderValue>;
 }
 export interface OpenApiPreviewInput {
     readonly spec: string;
-    readonly specFetchCredentials?: OpenApiSpecFetchCredentialsInput;
+    readonly specFetchCredentials?: OpenApiPreviewSpecFetchCredentialsInput;
 }
 export interface OpenApiSpecConfig {
-    readonly spec: string;
+    readonly spec: OpenApiSpecInput;
     readonly specFetchCredentials?: OpenApiSpecFetchCredentialsInput;
     /**
      * Executor scope id that owns this source row. Must be one of the
@@ -30,24 +35,30 @@ export interface OpenApiSpecConfig {
      * every inner (per-user) scope via fall-through reads.
      */
     readonly scope: string;
-    readonly name?: string;
-    readonly baseUrl?: string;
-    readonly namespace?: string;
-    readonly headers?: Record<string, OpenApiCredentialInput>;
-    readonly queryParams?: Record<string, OpenApiCredentialInput>;
+    readonly name: string;
+    readonly baseUrl: string;
+    readonly namespace: string;
+    readonly headers?: Record<string, OpenApiConfiguredValueInput>;
+    readonly queryParams?: Record<string, OpenApiConfiguredValueInput>;
     readonly oauth2?: OpenApiOAuthInput;
-    readonly credentialTargetScope?: string;
 }
-export interface OpenApiUpdateSourceInput {
-    readonly name?: string;
-    readonly baseUrl?: string;
-    readonly headers?: Record<string, OpenApiCredentialInput>;
-    readonly queryParams?: Record<string, OpenApiCredentialInput>;
-    readonly credentialTargetScope?: string;
-    /** Refresh the source's stored OAuth2 metadata after a successful
-     *  re-authenticate. */
-    readonly oauth2?: OpenApiOAuthInput;
+export interface OpenApiSourceRef {
+    readonly id: string;
+    readonly scope: string;
 }
+export type OpenApiConfigureCredentialInput = string | {
+    readonly kind: "text";
+    readonly text: string;
+    readonly prefix?: string;
+} | {
+    readonly kind: "secret";
+    readonly secretId: string;
+    readonly secretScope?: string;
+    readonly prefix?: string;
+} | {
+    readonly kind: "connection";
+    readonly connectionId: string;
+};
 /**
  * Errors any OpenAPI extension method may surface. The first three are
  * plugin-domain tagged errors that flow directly to clients (4xx, each
@@ -67,11 +78,132 @@ export interface OpenApiPluginExtension {
     }, OpenApiParseError | OpenApiExtractionError | OpenApiOAuthError | StorageFailure>;
     readonly removeSpec: (namespace: string, scope: string) => Effect.Effect<void, StorageFailure>;
     readonly getSource: (namespace: string, scope: string) => Effect.Effect<StoredSource | null, StorageFailure>;
-    readonly updateSource: (namespace: string, scope: string, input: OpenApiUpdateSourceInput) => Effect.Effect<void, StorageFailure>;
-    readonly listSourceBindings: (sourceId: string, sourceScope: string) => Effect.Effect<readonly OpenApiSourceBindingRef[], StorageFailure>;
-    readonly setSourceBinding: (input: OpenApiSourceBindingInput) => Effect.Effect<OpenApiSourceBindingRef, StorageFailure>;
-    readonly removeSourceBinding: (sourceId: string, sourceScope: string, slot: string, scope: string) => Effect.Effect<void, StorageFailure>;
+    readonly configure: (source: OpenApiSourceRef, input: OpenApiConfigureInput) => Effect.Effect<readonly CredentialBindingRef[], StorageFailure>;
 }
+declare const OpenApiSpecInputSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"url">;
+    readonly url: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"blob">;
+    readonly value: Schema.String;
+}>]>;
+declare const OpenApiSecretShapeInputSchema: Schema.Struct<{
+    readonly kind: Schema.Literal<"secret">;
+    readonly prefix: Schema.optional<Schema.String>;
+}>;
+declare const OpenApiConfigureInputSchema: Schema.Struct<{
+    readonly scope: Schema.String;
+    readonly name: Schema.optional<Schema.String>;
+    readonly baseUrl: Schema.optional<Schema.String>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly kind: Schema.Literal<"text">;
+        readonly text: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"secret">;
+        readonly secretId: Schema.String;
+        readonly secretScope: Schema.optional<Schema.String>;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"connection">;
+        readonly connectionId: Schema.String;
+    }>]>>>;
+    readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly kind: Schema.Literal<"text">;
+        readonly text: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"secret">;
+        readonly secretId: Schema.String;
+        readonly secretScope: Schema.optional<Schema.String>;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"connection">;
+        readonly connectionId: Schema.String;
+    }>]>>>;
+    readonly specFetchCredentials: Schema.optional<Schema.Struct<{
+        readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literal<"text">;
+            readonly text: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"secret">;
+            readonly secretId: Schema.String;
+            readonly secretScope: Schema.optional<Schema.String>;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"connection">;
+            readonly connectionId: Schema.String;
+        }>]>>>;
+        readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literal<"text">;
+            readonly text: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"secret">;
+            readonly secretId: Schema.String;
+            readonly secretScope: Schema.optional<Schema.String>;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"connection">;
+            readonly connectionId: Schema.String;
+        }>]>>>;
+    }>>;
+    readonly oauth2: Schema.optional<Schema.Struct<{
+        readonly clientId: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literal<"text">;
+            readonly text: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"secret">;
+            readonly secretId: Schema.String;
+            readonly secretScope: Schema.optional<Schema.String>;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"connection">;
+            readonly connectionId: Schema.String;
+        }>]>>;
+        readonly clientSecret: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literal<"text">;
+            readonly text: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"secret">;
+            readonly secretId: Schema.String;
+            readonly secretScope: Schema.optional<Schema.String>;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"connection">;
+            readonly connectionId: Schema.String;
+        }>]>>;
+        readonly connection: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literal<"text">;
+            readonly text: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"secret">;
+            readonly secretId: Schema.String;
+            readonly secretScope: Schema.optional<Schema.String>;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"connection">;
+            readonly connectionId: Schema.String;
+        }>]>>;
+    }>>;
+    readonly oauth2Source: Schema.optional<Schema.Struct<{
+        readonly kind: Schema.Literal<"oauth2">;
+        readonly securitySchemeName: Schema.String;
+        readonly flow: Schema.Literals<readonly ["authorizationCode", "clientCredentials"]>;
+        readonly tokenUrl: Schema.String;
+        readonly authorizationUrl: Schema.withDecodingDefault<Schema.optional<Schema.NullOr<Schema.String>>>;
+        readonly issuerUrl: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly clientIdSlot: Schema.String;
+        readonly clientSecretSlot: Schema.NullOr<Schema.String>;
+        readonly connectionSlot: Schema.String;
+        readonly scopes: Schema.$Array<Schema.String>;
+    }>>;
+}>;
+export type OpenApiConfigureInput = typeof OpenApiConfigureInputSchema.Type;
 export interface OpenApiPluginOptions {
     readonly httpClientLayer?: Layer.Layer<HttpClient.HttpClient, never, never>;
     /** If provided, source add/remove is mirrored to executor.jsonc
@@ -80,28 +212,36 @@ export interface OpenApiPluginOptions {
 }
 export declare const openApiPlugin: import("@executor-js/sdk/core").ConfiguredPlugin<"openapi", {
     previewSpec: (input: string | OpenApiPreviewInput) => Effect.Effect<{
+        readonly version: Option.Option<string>;
+        readonly operations: readonly {
+            readonly summary: Option.Option<string>;
+            readonly method: "post" | "options" | "delete" | "get" | "put" | "head" | "patch" | "trace";
+            readonly deprecated: boolean;
+            readonly path: string;
+            readonly tags: readonly string[];
+            readonly operationId: string;
+        }[];
         readonly title: Option.Option<string>;
         readonly servers: readonly {
             readonly url: string;
             readonly description: Option.Option<string>;
             readonly variables: Option.Option<{
                 readonly [x: string]: {
-                    readonly description: Option.Option<string>;
                     readonly default: string;
+                    readonly description: Option.Option<string>;
                     readonly enum: Option.Option<readonly string[]>;
                 };
             }>;
         }[];
         readonly tags: readonly string[];
-        readonly version: Option.Option<string>;
         readonly securitySchemes: readonly {
+            readonly name: string;
             readonly type: "oauth2" | "http" | "apiKey" | "openIdConnect";
             readonly in: Option.Option<"query" | "header" | "cookie">;
-            readonly name: string;
             readonly description: Option.Option<string>;
+            readonly headerName: Option.Option<string>;
             readonly scheme: Option.Option<string>;
             readonly bearerFormat: Option.Option<string>;
-            readonly headerName: Option.Option<string>;
             readonly flows: Option.Option<{
                 readonly authorizationCode: Option.Option<{
                     readonly scopes: {
@@ -121,14 +261,6 @@ export declare const openApiPlugin: import("@executor-js/sdk/core").ConfiguredPl
             }>;
             readonly openIdConnectUrl: Option.Option<string>;
         }[];
-        readonly operations: readonly {
-            readonly method: "delete" | "options" | "get" | "put" | "post" | "head" | "patch" | "trace";
-            readonly tags: readonly string[];
-            readonly summary: Option.Option<string>;
-            readonly operationId: string;
-            readonly deprecated: boolean;
-            readonly path: string;
-        }[];
         readonly authStrategies: readonly {
             readonly schemes: readonly string[];
         }[];
@@ -163,252 +295,26 @@ export declare const openApiPlugin: import("@executor-js/sdk/core").ConfiguredPl
         scope: string;
         name: string;
     } | null, StorageFailure, never>;
-    updateSource: (namespace: string, scope: string, input: OpenApiUpdateSourceInput) => Effect.Effect<undefined, StorageFailure | OpenApiOAuthError, never>;
-    listSourceBindings: (sourceId: string, sourceScope: string) => Effect.Effect<readonly {
+    configure: (source: OpenApiSourceRef, input: OpenApiConfigureInput) => Effect.Effect<readonly {
         readonly value: {
-            readonly secretId: string & import("effect/Brand").Brand<"SecretId">;
-            readonly kind: "secret";
-            readonly secretScopeId?: (string & import("effect/Brand").Brand<"ScopeId">) | undefined;
-        } | {
-            readonly connectionId: string & import("effect/Brand").Brand<"ConnectionId">;
-            readonly kind: "connection";
-        } | {
             readonly text: string;
             readonly kind: "text";
-        };
-        readonly createdAt: Date;
-        readonly sourceId: string;
-        readonly scopeId: string & import("effect/Brand").Brand<"ScopeId">;
-        readonly updatedAt: Date;
-        readonly slot: string;
-        readonly sourceScopeId: string & import("effect/Brand").Brand<"ScopeId">;
-    }[], StorageFailure, never>;
-    setSourceBinding: (input: OpenApiSourceBindingInput) => Effect.Effect<{
-        readonly value: {
+        } | {
             readonly secretId: string & import("effect/Brand").Brand<"SecretId">;
             readonly kind: "secret";
             readonly secretScopeId?: (string & import("effect/Brand").Brand<"ScopeId">) | undefined;
         } | {
             readonly connectionId: string & import("effect/Brand").Brand<"ConnectionId">;
             readonly kind: "connection";
-        } | {
-            readonly text: string;
-            readonly kind: "text";
         };
-        readonly createdAt: Date;
-        readonly sourceId: string;
+        readonly id: string & import("effect/Brand").Brand<"CredentialBindingId">;
         readonly scopeId: string & import("effect/Brand").Brand<"ScopeId">;
+        readonly createdAt: Date;
         readonly updatedAt: Date;
-        readonly slot: string;
+        readonly pluginId: string;
+        readonly sourceId: string;
         readonly sourceScopeId: string & import("effect/Brand").Brand<"ScopeId">;
-    }, StorageFailure, never>;
-    removeSourceBinding: (sourceId: string, sourceScope: string, slot: string, scope: string) => Effect.Effect<void, StorageFailure, never>;
-}, OpenapiStore, OpenApiPluginOptions, {
-    readonly openapi_source: {
-        readonly fields: {
-            readonly id: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly scope_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly name: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly spec: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly source_url: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly base_url: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly oauth2: {
-                readonly type: "json";
-                readonly required: false;
-            };
-        };
-    };
-    readonly openapi_operation: {
-        readonly fields: {
-            readonly id: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly scope_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly source_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly binding: {
-                readonly type: "json";
-                readonly required: true;
-            };
-        };
-    };
-    readonly openapi_source_header: {
-        readonly fields: {
-            readonly id: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly scope_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly source_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly name: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly kind: {
-                readonly type: ["text", "binding"];
-                readonly required: true;
-            };
-            readonly text_value: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly slot_key: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly prefix: {
-                readonly type: "string";
-                readonly required: false;
-            };
-        };
-    };
-    readonly openapi_source_query_param: {
-        readonly fields: {
-            readonly id: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly scope_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly source_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly name: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly kind: {
-                readonly type: ["text", "binding"];
-                readonly required: true;
-            };
-            readonly text_value: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly slot_key: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly prefix: {
-                readonly type: "string";
-                readonly required: false;
-            };
-        };
-    };
-    readonly openapi_source_spec_fetch_header: {
-        readonly fields: {
-            readonly id: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly scope_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly source_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly name: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly kind: {
-                readonly type: ["text", "binding"];
-                readonly required: true;
-            };
-            readonly text_value: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly slot_key: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly prefix: {
-                readonly type: "string";
-                readonly required: false;
-            };
-        };
-    };
-    readonly openapi_source_spec_fetch_query_param: {
-        readonly fields: {
-            readonly id: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly scope_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly source_id: {
-                readonly type: "string";
-                readonly required: true;
-                readonly index: true;
-            };
-            readonly name: {
-                readonly type: "string";
-                readonly required: true;
-            };
-            readonly kind: {
-                readonly type: ["text", "binding"];
-                readonly required: true;
-            };
-            readonly text_value: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly slot_key: {
-                readonly type: "string";
-                readonly required: false;
-            };
-            readonly prefix: {
-                readonly type: "string";
-                readonly required: false;
-            };
-        };
-    };
-}, undefined, Layer.Layer<unknown, never, never>, import("effect/unstable/httpapi/HttpApiGroup").Any>;
+        readonly slotKey: string;
+    }[], StorageFailure, never>;
+}, OpenapiStore, OpenApiPluginOptions, {}, undefined, Layer.Layer<unknown, never, never>, import("effect/unstable/httpapi/HttpApiGroup").Any>;
+export {};

package/dist/sdk/preview.d.ts

@@ -190,28 +190,36 @@ export type SpecPreview = typeof SpecPreview.Type;
 /** Preview an OpenAPI spec — extract metadata without registering anything.
  *  Accepts either a URL or raw JSON/YAML text. */
 export declare const previewSpec: (input: string) => Effect.Effect<{
+    readonly version: Option.Option<string>;
+    readonly operations: readonly {
+        readonly summary: Option.Option<string>;
+        readonly method: "post" | "options" | "delete" | "get" | "put" | "head" | "patch" | "trace";
+        readonly deprecated: boolean;
+        readonly path: string;
+        readonly tags: readonly string[];
+        readonly operationId: string;
+    }[];
     readonly title: Option.Option<string>;
     readonly servers: readonly {
         readonly url: string;
         readonly description: Option.Option<string>;
         readonly variables: Option.Option<{
             readonly [x: string]: {
-                readonly description: Option.Option<string>;
                 readonly default: string;
+                readonly description: Option.Option<string>;
                 readonly enum: Option.Option<readonly string[]>;
             };
         }>;
     }[];
     readonly tags: readonly string[];
-    readonly version: Option.Option<string>;
     readonly securitySchemes: readonly {
+        readonly name: string;
         readonly type: "oauth2" | "http" | "apiKey" | "openIdConnect";
         readonly in: Option.Option<"query" | "header" | "cookie">;
-        readonly name: string;
         readonly description: Option.Option<string>;
+        readonly headerName: Option.Option<string>;
         readonly scheme: Option.Option<string>;
         readonly bearerFormat: Option.Option<string>;
-        readonly headerName: Option.Option<string>;
         readonly flows: Option.Option<{
             readonly authorizationCode: Option.Option<{
                 readonly scopes: {
@@ -231,14 +239,6 @@ export declare const previewSpec: (input: string) => Effect.Effect<{
         }>;
         readonly openIdConnectUrl: Option.Option<string>;
     }[];
-    readonly operations: readonly {
-        readonly method: "delete" | "options" | "get" | "put" | "post" | "head" | "patch" | "trace";
-        readonly tags: readonly string[];
-        readonly summary: Option.Option<string>;
-        readonly operationId: string;
-        readonly deprecated: boolean;
-        readonly path: string;
-    }[];
     readonly authStrategies: readonly {
         readonly schemes: readonly string[];
     }[];

package/dist/sdk/source-contracts.d.ts

@@ -0,0 +1,55 @@
+import { Schema } from "effect";
+export declare const StoredSourceSchema: Schema.Struct<{
+    readonly namespace: Schema.String;
+    readonly scope: Schema.String;
+    readonly name: Schema.String;
+    readonly config: Schema.Struct<{
+        readonly spec: Schema.optional<Schema.String>;
+        readonly sourceUrl: Schema.optional<Schema.String>;
+        readonly baseUrl: Schema.optional<Schema.String>;
+        readonly namespace: Schema.optional<Schema.String>;
+        readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literal<"binding">;
+            readonly slot: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>]>>>;
+        readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+            readonly kind: Schema.Literal<"binding">;
+            readonly slot: Schema.String;
+            readonly prefix: Schema.optional<Schema.String>;
+        }>]>>>;
+        readonly specFetchCredentials: Schema.optional<Schema.Struct<{
+            readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+                readonly kind: Schema.Literal<"binding">;
+                readonly slot: Schema.String;
+                readonly prefix: Schema.optional<Schema.String>;
+            }>]>>>;
+            readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+                readonly kind: Schema.Literal<"binding">;
+                readonly slot: Schema.String;
+                readonly prefix: Schema.optional<Schema.String>;
+            }>]>>>;
+        }>>;
+        readonly oauth2: Schema.optional<Schema.Struct<{
+            readonly kind: Schema.Literal<"oauth2">;
+            readonly securitySchemeName: Schema.String;
+            readonly flow: Schema.Literals<readonly ["authorizationCode", "clientCredentials"]>;
+            readonly tokenUrl: Schema.String;
+            readonly authorizationUrl: Schema.withDecodingDefault<Schema.optional<Schema.NullOr<Schema.String>>>;
+            readonly issuerUrl: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly clientIdSlot: Schema.String;
+            readonly clientSecretSlot: Schema.NullOr<Schema.String>;
+            readonly connectionSlot: Schema.String;
+            readonly scopes: Schema.$Array<Schema.String>;
+        }>>;
+    }>;
+}>;
+export type StoredSourceSchema = typeof StoredSourceSchema.Type;
+export type StoredSourceSchemaType = typeof StoredSourceSchema.Type;
+export declare const headerBindingSlot: (headerName: string) => string;
+export declare const queryParamBindingSlot: (name: string) => string;
+export declare const specFetchHeaderBindingSlot: (headerName: string) => string;
+export declare const specFetchQueryParamBindingSlot: (name: string) => string;
+export declare const oauth2ClientIdSlot: (securitySchemeName: string) => string;
+export declare const oauth2ClientSecretSlot: (securitySchemeName: string) => string;
+export declare const oauth2ConnectionSlot: (securitySchemeName: string) => string;