@sonatel-os/openapi-runtime 0.1.1 → 0.2.1

package/dist/react/index.cjs

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const react = require("react");
+const index = require("../index.cjs");
+function useOpenAPI(name, options = {}) {
+  const { throwOnError = false } = options;
+  const handleError = react.useCallback((error) => {
+    if (throwOnError) throw error;
+    console.error(`[useOpenAPI:${name}]`, error);
+    return { error };
+  }, [name, throwOnError]);
+  const api = react.useMemo(() => ({
+    /**
+     * Registers the spec (call once on mount).
+     */
+    save: async (specName, opts = {}) => {
+      try {
+        return await index.save({ name, specName, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Lists all operations for this spec.
+     */
+    listAPIs: () => {
+      try {
+        return index.listAPIs({ name });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets the contract for an operation.
+     */
+    showContract: (operationId) => {
+      try {
+        return index.showContract({ name, api: operationId });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets a sample response.
+     */
+    showResponseSample: (operationId, status) => {
+      try {
+        return index.showResponseSample({ name, api: operationId, status });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets a sample request body.
+     */
+    showRequestSample: (operationId) => {
+      try {
+        return index.showRequestSample({ name, api: operationId });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Executes an API operation.
+     */
+    executeAPI: async (operationId, opts = {}) => {
+      try {
+        return await index.executeAPI({ name, api: operationId, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Validates a response.
+     */
+    validateResponse: (operationId, opts) => {
+      try {
+        return index.validateResponseData({ name, api: operationId, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Validates a request body.
+     */
+    validateRequest: (operationId, opts) => {
+      try {
+        return index.validateRequestData({ name, api: operationId, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets a mock response.
+     */
+    mockAPI: (operationId, status) => {
+      try {
+        return index.mockAPI({ name, api: operationId, status });
+      } catch (error) {
+        return handleError(error);
+      }
+    }
+  }), [name, handleError]);
+  return api;
+}
+function useOpenAPIWithState(name) {
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const api = useOpenAPI(name, { throwOnError: true });
+  const execute = react.useCallback(async (operation, onSuccess) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await operation();
+      if (onSuccess) onSuccess(result);
+      return result;
+    } catch (err) {
+      setError(err);
+      return null;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  return { api, loading, error, execute };
+}
+exports.default = useOpenAPI;
+exports.useOpenAPI = useOpenAPI;
+exports.useOpenAPIWithState = useOpenAPIWithState;
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/react/useOpenAPI.js"],"sourcesContent":["'use client'\n\n/**\n * @module react/useOpenAPI\n * @description React hook for OpenAPI runtime integration.\n */\n\nimport { useMemo, useCallback, useState } from 'react'\nimport {\n  save,\n  listAPIs,\n  showContract,\n  showResponseSample,\n  showRequestSample,\n  executeAPI,\n  validateResponseData,\n  validateRequestData,\n  mockAPI\n} from '../index.js'\n\n// ============================================================================\n// TYPE DEFINITIONS\n// ============================================================================\n\n/**\n * Hook return type.\n * @typedef {Object} UseOpenAPIReturn\n * @property {(specName: string | object, options?: { autoAuth?: boolean }) => Promise<object>} save - Register a spec\n * @property {() => import('../core/registry.js').OperationInfo[]} listAPIs - List operations\n * @property {(api: string) => object} showContract - Get operation details\n * @property {(api: string, status?: string | number) => any} showResponseSample - Get response sample\n * @property {(api: string) => any} showRequestSample - Get request sample\n * @property {(api: string, options?: { params?: object, body?: any, headers?: object, qs?: object }) => Promise<object>} executeAPI - Execute an operation\n * @property {(api: string, options: { status: string | number, data: any, contentType?: string }) => object} validateResponse - Validate response\n * @property {(api: string, options: { body: any, contentType?: string }) => object} validateRequest - Validate request\n * @property {(api: string, status?: string | number) => any} mockAPI - Get mock response\n */\n\n/**\n * Hook options.\n * @typedef {Object} UseOpenAPIOptions\n * @property {boolean} [throwOnError=false] - Throw errors instead of returning them\n */\n\n// ============================================================================\n// HOOK IMPLEMENTATION\n// ============================================================================\n\n/**\n * React hook for OpenAPI runtime operations.\n * Binds all operations to a specific spec name for convenience.\n *\n * @param {string} name - Registered spec name\n * @param {UseOpenAPIOptions} [options] - Hook options\n * @returns {UseOpenAPIReturn} Bound API operations\n *\n * @example\n * function ProductList() {\n *   const api = useOpenAPI('products')\n *\n *   useEffect(() => {\n *     api.executeAPI('getProducts')\n *       .then(res => setProducts(res.body))\n *   }, [])\n *\n *   return <div>...</div>\n * }\n */\nexport function useOpenAPI(name, options = {}) {\n  const { throwOnError = false } = options\n\n  /**\n   * Error handler wrapper.\n   */\n  const handleError = useCallback((error) => {\n    if (throwOnError) throw error\n    console.error(`[useOpenAPI:${name}]`, error)\n    return { error }\n  }, [name, throwOnError])\n\n  /**\n   * Memoized API bindings.\n   */\n  const api = useMemo(() => ({\n    /**\n     * Registers the spec (call once on mount).\n     */\n    save: async (specName, opts = {}) => {\n      try {\n        return await save({ name, specName, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Lists all operations for this spec.\n     */\n    listAPIs: () => {\n      try {\n        return listAPIs({ name })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets the contract for an operation.\n     */\n    showContract: (operationId) => {\n      try {\n        return showContract({ name, api: operationId })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets a sample response.\n     */\n    showResponseSample: (operationId, status) => {\n      try {\n        return showResponseSample({ name, api: operationId, status })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets a sample request body.\n     */\n    showRequestSample: (operationId) => {\n      try {\n        return showRequestSample({ name, api: operationId })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Executes an API operation.\n     */\n    executeAPI: async (operationId, opts = {}) => {\n      try {\n        return await executeAPI({ name, api: operationId, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Validates a response.\n     */\n    validateResponse: (operationId, opts) => {\n      try {\n        return validateResponseData({ name, api: operationId, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Validates a request body.\n     */\n    validateRequest: (operationId, opts) => {\n      try {\n        return validateRequestData({ name, api: operationId, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets a mock response.\n     */\n    mockAPI: (operationId, status) => {\n      try {\n        return mockAPI({ name, api: operationId, status })\n      } catch (error) {\n        return handleError(error)\n      }\n    }\n  }), [name, handleError])\n\n  return api\n}\n\n// ============================================================================\n// ASYNC HOOK WITH STATE\n// ============================================================================\n\n/**\n * React hook for OpenAPI with loading/error state management.\n *\n * @param {string} name - Registered spec name\n * @returns {{ api: UseOpenAPIReturn, loading: boolean, error: Error | null, execute: Function }}\n *\n * @example\n * function ProductList() {\n *   const { api, loading, error, execute } = useOpenAPIWithState('products')\n *\n *   const loadProducts = () => execute(\n *     () => api.executeAPI('getProducts'),\n *     (res) => setProducts(res.body)\n *   )\n *\n *   if (loading) return <Spinner />\n *   if (error) return <Error message={error.message} />\n *   return <div>...</div>\n * }\n */\nexport function useOpenAPIWithState(name) {\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState(null)\n\n  const api = useOpenAPI(name, { throwOnError: true })\n\n  const execute = useCallback(async (operation, onSuccess) => {\n    setLoading(true)\n    setError(null)\n\n    try {\n      const result = await operation()\n      if (onSuccess) onSuccess(result)\n      return result\n    } catch (err) {\n      setError(err)\n      return null\n    } finally {\n      setLoading(false)\n    }\n  }, [])\n\n  return { api, loading, error, execute }\n}\n\nexport default useOpenAPI\n"],"names":["useCallback","useMemo","save","listAPIs","showContract","showResponseSample","showRequestSample","executeAPI","validateResponseData","validateRequestData","mockAPI","useState"],"mappings":"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"}

package/dist/react/index.esm.js

@@ -0,0 +1,129 @@
+import { useCallback, useMemo, useState } from "react";
+import { mockAPI, validateRequestData, validateResponseData, executeAPI, showRequestSample, showResponseSample, showContract, listAPIs, save } from "../index.esm.js";
+function useOpenAPI(name, options = {}) {
+  const { throwOnError = false } = options;
+  const handleError = useCallback((error) => {
+    if (throwOnError) throw error;
+    console.error(`[useOpenAPI:${name}]`, error);
+    return { error };
+  }, [name, throwOnError]);
+  const api = useMemo(() => ({
+    /**
+     * Registers the spec (call once on mount).
+     */
+    save: async (specName, opts = {}) => {
+      try {
+        return await save({ name, specName, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Lists all operations for this spec.
+     */
+    listAPIs: () => {
+      try {
+        return listAPIs({ name });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets the contract for an operation.
+     */
+    showContract: (operationId) => {
+      try {
+        return showContract({ name, api: operationId });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets a sample response.
+     */
+    showResponseSample: (operationId, status) => {
+      try {
+        return showResponseSample({ name, api: operationId, status });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets a sample request body.
+     */
+    showRequestSample: (operationId) => {
+      try {
+        return showRequestSample({ name, api: operationId });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Executes an API operation.
+     */
+    executeAPI: async (operationId, opts = {}) => {
+      try {
+        return await executeAPI({ name, api: operationId, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Validates a response.
+     */
+    validateResponse: (operationId, opts) => {
+      try {
+        return validateResponseData({ name, api: operationId, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Validates a request body.
+     */
+    validateRequest: (operationId, opts) => {
+      try {
+        return validateRequestData({ name, api: operationId, ...opts });
+      } catch (error) {
+        return handleError(error);
+      }
+    },
+    /**
+     * Gets a mock response.
+     */
+    mockAPI: (operationId, status) => {
+      try {
+        return mockAPI({ name, api: operationId, status });
+      } catch (error) {
+        return handleError(error);
+      }
+    }
+  }), [name, handleError]);
+  return api;
+}
+function useOpenAPIWithState(name) {
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const api = useOpenAPI(name, { throwOnError: true });
+  const execute = useCallback(async (operation, onSuccess) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await operation();
+      if (onSuccess) onSuccess(result);
+      return result;
+    } catch (err) {
+      setError(err);
+      return null;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+  return { api, loading, error, execute };
+}
+export {
+  useOpenAPI as default,
+  useOpenAPI,
+  useOpenAPIWithState
+};
+//# sourceMappingURL=index.esm.js.map

package/dist/react/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../src/react/useOpenAPI.js"],"sourcesContent":["'use client'\n\n/**\n * @module react/useOpenAPI\n * @description React hook for OpenAPI runtime integration.\n */\n\nimport { useMemo, useCallback, useState } from 'react'\nimport {\n  save,\n  listAPIs,\n  showContract,\n  showResponseSample,\n  showRequestSample,\n  executeAPI,\n  validateResponseData,\n  validateRequestData,\n  mockAPI\n} from '../index.js'\n\n// ============================================================================\n// TYPE DEFINITIONS\n// ============================================================================\n\n/**\n * Hook return type.\n * @typedef {Object} UseOpenAPIReturn\n * @property {(specName: string | object, options?: { autoAuth?: boolean }) => Promise<object>} save - Register a spec\n * @property {() => import('../core/registry.js').OperationInfo[]} listAPIs - List operations\n * @property {(api: string) => object} showContract - Get operation details\n * @property {(api: string, status?: string | number) => any} showResponseSample - Get response sample\n * @property {(api: string) => any} showRequestSample - Get request sample\n * @property {(api: string, options?: { params?: object, body?: any, headers?: object, qs?: object }) => Promise<object>} executeAPI - Execute an operation\n * @property {(api: string, options: { status: string | number, data: any, contentType?: string }) => object} validateResponse - Validate response\n * @property {(api: string, options: { body: any, contentType?: string }) => object} validateRequest - Validate request\n * @property {(api: string, status?: string | number) => any} mockAPI - Get mock response\n */\n\n/**\n * Hook options.\n * @typedef {Object} UseOpenAPIOptions\n * @property {boolean} [throwOnError=false] - Throw errors instead of returning them\n */\n\n// ============================================================================\n// HOOK IMPLEMENTATION\n// ============================================================================\n\n/**\n * React hook for OpenAPI runtime operations.\n * Binds all operations to a specific spec name for convenience.\n *\n * @param {string} name - Registered spec name\n * @param {UseOpenAPIOptions} [options] - Hook options\n * @returns {UseOpenAPIReturn} Bound API operations\n *\n * @example\n * function ProductList() {\n *   const api = useOpenAPI('products')\n *\n *   useEffect(() => {\n *     api.executeAPI('getProducts')\n *       .then(res => setProducts(res.body))\n *   }, [])\n *\n *   return <div>...</div>\n * }\n */\nexport function useOpenAPI(name, options = {}) {\n  const { throwOnError = false } = options\n\n  /**\n   * Error handler wrapper.\n   */\n  const handleError = useCallback((error) => {\n    if (throwOnError) throw error\n    console.error(`[useOpenAPI:${name}]`, error)\n    return { error }\n  }, [name, throwOnError])\n\n  /**\n   * Memoized API bindings.\n   */\n  const api = useMemo(() => ({\n    /**\n     * Registers the spec (call once on mount).\n     */\n    save: async (specName, opts = {}) => {\n      try {\n        return await save({ name, specName, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Lists all operations for this spec.\n     */\n    listAPIs: () => {\n      try {\n        return listAPIs({ name })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets the contract for an operation.\n     */\n    showContract: (operationId) => {\n      try {\n        return showContract({ name, api: operationId })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets a sample response.\n     */\n    showResponseSample: (operationId, status) => {\n      try {\n        return showResponseSample({ name, api: operationId, status })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets a sample request body.\n     */\n    showRequestSample: (operationId) => {\n      try {\n        return showRequestSample({ name, api: operationId })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Executes an API operation.\n     */\n    executeAPI: async (operationId, opts = {}) => {\n      try {\n        return await executeAPI({ name, api: operationId, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Validates a response.\n     */\n    validateResponse: (operationId, opts) => {\n      try {\n        return validateResponseData({ name, api: operationId, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Validates a request body.\n     */\n    validateRequest: (operationId, opts) => {\n      try {\n        return validateRequestData({ name, api: operationId, ...opts })\n      } catch (error) {\n        return handleError(error)\n      }\n    },\n\n    /**\n     * Gets a mock response.\n     */\n    mockAPI: (operationId, status) => {\n      try {\n        return mockAPI({ name, api: operationId, status })\n      } catch (error) {\n        return handleError(error)\n      }\n    }\n  }), [name, handleError])\n\n  return api\n}\n\n// ============================================================================\n// ASYNC HOOK WITH STATE\n// ============================================================================\n\n/**\n * React hook for OpenAPI with loading/error state management.\n *\n * @param {string} name - Registered spec name\n * @returns {{ api: UseOpenAPIReturn, loading: boolean, error: Error | null, execute: Function }}\n *\n * @example\n * function ProductList() {\n *   const { api, loading, error, execute } = useOpenAPIWithState('products')\n *\n *   const loadProducts = () => execute(\n *     () => api.executeAPI('getProducts'),\n *     (res) => setProducts(res.body)\n *   )\n *\n *   if (loading) return <Spinner />\n *   if (error) return <Error message={error.message} />\n *   return <div>...</div>\n * }\n */\nexport function useOpenAPIWithState(name) {\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState(null)\n\n  const api = useOpenAPI(name, { throwOnError: true })\n\n  const execute = useCallback(async (operation, onSuccess) => {\n    setLoading(true)\n    setError(null)\n\n    try {\n      const result = await operation()\n      if (onSuccess) onSuccess(result)\n      return result\n    } catch (err) {\n      setError(err)\n      return null\n    } finally {\n      setLoading(false)\n    }\n  }, [])\n\n  return { api, loading, error, execute }\n}\n\nexport default useOpenAPI\n"],"names":[],"mappings":"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"}

package/dist/src/auth/config.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Auth config structure from YAML.
+ * @typedef {Object} AuthConfig
+ * @property {Record<string, SpecAuthConfig>} [auth] - Per-spec auth config
+ */
+/**
+ * Per-spec auth configuration.
+ * @typedef {Object} SpecAuthConfig
+ * @property {Record<string, SchemeConfig>} schemes - Auth scheme configs
+ */
+/**
+ * Individual scheme configuration.
+ * @typedef {Object} SchemeConfig
+ * @property {'apiKey' | 'http' | 'oauth2'} type - Scheme type
+ * @property {string} [scheme] - For http: 'basic' or 'bearer'
+ * @property {string} [in] - For apiKey: 'header' or 'query'
+ * @property {string} [name] - For apiKey: header/param name
+ * @property {string} [value] - Direct value
+ * @property {string} [valueFromEnv] - Env var name for value
+ * @property {string} [token] - Bearer token
+ * @property {string} [tokenFromEnv] - Env var for bearer token
+ * @property {string} [username] - Basic auth username
+ * @property {string} [usernameFromEnv] - Env var for username
+ * @property {string} [password] - Basic auth password
+ * @property {string} [passwordFromEnv] - Env var for password
+ * @property {string} [flow] - OAuth2 flow type
+ * @property {string} [tokenUrl] - OAuth2 token endpoint
+ * @property {string} [clientId] - OAuth2 client ID
+ * @property {string} [clientIdFromEnv] - Env var for client ID
+ * @property {string} [clientSecret] - OAuth2 client secret
+ * @property {string} [clientSecretFromEnv] - Env var for client secret
+ * @property {string} [scope] - OAuth2 scopes
+ * @property {string} [audience] - OAuth2 audience
+ * @property {Record<string, string>} [extraParams] - Extra OAuth2 params
+ */
+/**
+ * Loads auth configuration from YAML file.
+ *
+ * Location: `./openapi.auth.yml` in project root.
+ * Supports `${ENV_VAR}` interpolation.
+ *
+ * @returns {AuthConfig | null} Parsed config or null if not found
+ *
+ * @example
+ * const config = loadAuthConfig()
+ * const productAuth = config?.auth?.products
+ */
+export function loadAuthConfig(): AuthConfig | null;
+/**
+ * Creates auth providers from YAML configuration.
+ *
+ * @param {string} _specName - Spec name (for context)
+ * @param {object} _spec - OpenAPI spec (for reference)
+ * @param {SpecAuthConfig} config - Per-spec auth config
+ * @returns {Record<string, import('./providers.js').AuthProvider>} Provider map
+ *
+ * @example
+ * const providers = providersFromConfig('products', spec, config.auth.products)
+ * setAuth('products', providers)
+ */
+export function providersFromConfig(_specName: string, _spec: object, config: SpecAuthConfig): Record<string, import("./providers.js").AuthProvider>;
+export { getEnv };
+/**
+ * Auth config structure from YAML.
+ */
+export type AuthConfig = {
+    /**
+     * - Per-spec auth config
+     */
+    auth?: Record<string, SpecAuthConfig> | undefined;
+};
+/**
+ * Per-spec auth configuration.
+ */
+export type SpecAuthConfig = {
+    /**
+     * - Auth scheme configs
+     */
+    schemes: Record<string, SchemeConfig>;
+};
+/**
+ * Individual scheme configuration.
+ */
+export type SchemeConfig = {
+    /**
+     * - Scheme type
+     */
+    type: "apiKey" | "http" | "oauth2";
+    /**
+     * - For http: 'basic' or 'bearer'
+     */
+    scheme?: string | undefined;
+    /**
+     * - For apiKey: 'header' or 'query'
+     */
+    in?: string | undefined;
+    /**
+     * - For apiKey: header/param name
+     */
+    name?: string | undefined;
+    /**
+     * - Direct value
+     */
+    value?: string | undefined;
+    /**
+     * - Env var name for value
+     */
+    valueFromEnv?: string | undefined;
+    /**
+     * - Bearer token
+     */
+    token?: string | undefined;
+    /**
+     * - Env var for bearer token
+     */
+    tokenFromEnv?: string | undefined;
+    /**
+     * - Basic auth username
+     */
+    username?: string | undefined;
+    /**
+     * - Env var for username
+     */
+    usernameFromEnv?: string | undefined;
+    /**
+     * - Basic auth password
+     */
+    password?: string | undefined;
+    /**
+     * - Env var for password
+     */
+    passwordFromEnv?: string | undefined;
+    /**
+     * - OAuth2 flow type
+     */
+    flow?: string | undefined;
+    /**
+     * - OAuth2 token endpoint
+     */
+    tokenUrl?: string | undefined;
+    /**
+     * - OAuth2 client ID
+     */
+    clientId?: string | undefined;
+    /**
+     * - Env var for client ID
+     */
+    clientIdFromEnv?: string | undefined;
+    /**
+     * - OAuth2 client secret
+     */
+    clientSecret?: string | undefined;
+    /**
+     * - Env var for client secret
+     */
+    clientSecretFromEnv?: string | undefined;
+    /**
+     * - OAuth2 scopes
+     */
+    scope?: string | undefined;
+    /**
+     * - OAuth2 audience
+     */
+    audience?: string | undefined;
+    /**
+     * - Extra OAuth2 params
+     */
+    extraParams?: Record<string, string> | undefined;
+};
+import { getEnv } from '../utils.js';

package/dist/src/auth/index.d.ts

@@ -0,0 +1,3 @@
+export { apiKey, basic, bearer, clientCredentials } from "./providers.js";
+export { setAuth, getAuth, clearAuth, applyAuth } from "./manager.js";
+export { loadAuthConfig, providersFromConfig, getEnv } from "./config.js";

package/dist/src/auth/manager.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Registers authentication providers for a spec.
+ *
+ * @param {string} name - Spec name
+ * @param {Record<string, import('./providers.js').AuthProvider>} providers - Provider map
+ *
+ * @example
+ * setAuth('products', {
+ *   bearerAuth: bearer({ token: 'xxx' }),
+ *   apiKeyAuth: apiKey({ in: 'header', name: 'X-Key', getValue: () => 'key' })
+ * })
+ */
+export function setAuth(name: string, providers: Record<string, import("./providers.js").AuthProvider>): void;
+/**
+ * Gets the auth providers for a spec.
+ *
+ * @param {string} name - Spec name
+ * @returns {AuthRegistryEntry | undefined} Auth registry entry
+ */
+export function getAuth(name: string): AuthRegistryEntry | undefined;
+/**
+ * Clears auth configuration for a spec or all specs.
+ *
+ * @param {string} [name] - Spec name (omit to clear all)
+ */
+export function clearAuth(name?: string): void;
+/**
+ * Applies authentication to a request based on operation security requirements.
+ *
+ * Security resolution order:
+ * 1. Operation-level security (if defined and non-empty)
+ * 2. Spec-level security (fallback)
+ *
+ * For each security requirement, ALL schemes must be satisfied.
+ * Multiple requirements are OR'd - first successful one wins.
+ *
+ * @param {import('../core/registry.js').SpecEntry} entry - Spec entry
+ * @param {string} operationId - Operation being called
+ * @param {object} req - Request object to mutate
+ * @throws {AuthenticationError} If auth is required but all providers fail
+ *
+ * @example
+ * await applyAuth(entry, 'createUser', requestObject)
+ */
+export function applyAuth(entry: import("../core/registry.js").SpecEntry, operationId: string, req: object): Promise<void>;
+/**
+ * Auth registry entry for a spec.
+ */
+export type AuthRegistryEntry = {
+    providers: Record<string, import("./providers.js").AuthProvider>;
+};