@ahoo-wang/fetcher-openapi 1.9.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [2025] [ahoo wang <ahoowang@qq.com>]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,92 @@
+# @ahoo-wang/fetcher-openapi
+
+[![npm version](https://img.shields.io/npm/v/@ahoo-wang/fetcher-openapi.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher-openapi)
+[![Build Status](https://github.com/Ahoo-Wang/fetcher/actions/workflows/ci.yml/badge.svg)](https://github.com/Ahoo-Wang/fetcher/actions)
+[![codecov](https://codecov.io/gh/Ahoo-Wang/fetcher/graph/badge.svg?token=JGiWZ52CvJ)](https://codecov.io/gh/Ahoo-Wang/fetcher)
+[![License](https://img.shields.io/npm/l/@ahoo-wang/fetcher-openapi.svg)](https://github.com/Ahoo-Wang/fetcher/blob/main/LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/@ahoo-wang/fetcher-openapi.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher-openapi)
+[![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40ahoo-wang%2Ffetcher-openapi)](https://www.npmjs.com/package/@ahoo-wang/fetcher-openapi)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Ahoo-Wang/fetcher)
+
+OpenAPI Specification TypeScript types and utilities for [Fetcher](https://github.com/Ahoo-Wang/fetcher) - A modern,
+ultra-lightweight HTTP client.
+
+## Features
+
+- 📦 **Ultra-lightweight** - Minimal overhead TypeScript types only
+- 🦺 **Full TypeScript Support** - Complete type definitions for OpenAPI 3.x specification
+- 🧩 **Modular Design** - Import only what you need
+- 🎯 **Framework Agnostic** - Works with any OpenAPI-compatible tooling
+
+## Installation
+
+```bash
+npm install @ahoo-wang/fetcher-openapi
+```
+
+## Usage
+
+### Basic Types
+
+Import OpenAPI specification types:
+
+```typescript
+import type { OpenAPI, Schema, Operation } from '@ahoo-wang/fetcher-openapi';
+
+const openAPI: OpenAPI = {
+  openapi: '3.0.1',
+  info: {
+    title: 'My API',
+    version: '1.0.0'
+  },
+  paths: {
+    '/users': {
+      get: {
+        summary: 'Get users',
+        responses: {
+          '200': {
+            description: 'A list of users',
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'array',
+                  items: {
+                    $ref: '#/components/schemas/User'
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+};
+```
+
+## API Reference
+
+### Core Types
+
+- `OpenAPI` - Root document object
+- `Info` - API metadata
+- `Server` - Server configuration
+- `Paths` - API paths and operations
+- `Operation` - Single API operation
+- `Schema` - Data schema definition
+- `Parameter` - Operation parameter
+- `RequestBody` - Request body definition
+- `Response` - Response definition
+- `Components` - Reusable components
+- `SecurityScheme` - Security scheme definition
+
+### Utility Types
+
+- `ExtractSchemaType<S>` - Extract TypeScript type from OpenAPI Schema
+- `ExtractRequestBodyType<Op, Components>` - Extract request body type from Operation
+- `ExtractOkResponseBodyType<Op, Components>` - Extract successful response body type from Operation
+- `ResolveReference<R, Components>` - Resolve $ref references to actual types
+
+## License
+
+[Apache 2.0](https://github.com/Ahoo-Wang/fetcher/blob/master/LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,91 @@
+# @ahoo-wang/fetcher-openapi
+
+[![npm version](https://img.shields.io/npm/v/@ahoo-wang/fetcher-openapi.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher-openapi)
+[![Build Status](https://github.com/Ahoo-Wang/fetcher/actions/workflows/ci.yml/badge.svg)](https://github.com/Ahoo-Wang/fetcher/actions)
+[![codecov](https://codecov.io/gh/Ahoo-Wang/fetcher/graph/badge.svg?token=JGiWZ52CvJ)](https://codecov.io/gh/Ahoo-Wang/fetcher)
+[![License](https://img.shields.io/npm/l/@ahoo-wang/fetcher-openapi.svg)](https://github.com/Ahoo-Wang/fetcher/blob/main/LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/@ahoo-wang/fetcher-openapi.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher-openapi)
+[![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40ahoo-wang%2Ffetcher-openapi)](https://www.npmjs.com/package/@ahoo-wang/fetcher-openapi)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Ahoo-Wang/fetcher)
+
+[Fetcher](https://github.com/Ahoo-Wang/fetcher) 的 OpenAPI 规范 TypeScript 类型和工具 - 一个现代、超轻量级的 HTTP 客户端。
+
+## 功能特性
+
+- 📦 **超轻量级** - 最小化开销的 TypeScript 类型定义
+- 🦺 **完整 TypeScript 支持** - OpenAPI 3.x 规范的完整类型定义
+- 🧩 **模块化设计** - 按需导入所需功能
+- 🎯 **框架无关** - 适用于任何与 OpenAPI 兼容的工具
+
+## 安装
+
+```bash
+npm install @ahoo-wang/fetcher-openapi
+```
+
+## 使用方法
+
+### 基础类型
+
+导入 OpenAPI 规范类型：
+
+```typescript
+import type { OpenAPI, Schema, Operation } from '@ahoo-wang/fetcher-openapi';
+
+const openAPI: OpenAPI = {
+  openapi: '3.0.1',
+  info: {
+    title: '我的 API',
+    version: '1.0.0'
+  },
+  paths: {
+    '/users': {
+      get: {
+        summary: '获取用户列表',
+        responses: {
+          '200': {
+            description: '用户列表',
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'array',
+                  items: {
+                    $ref: '#/components/schemas/User'
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+};
+```
+
+## API 参考
+
+### 核心类型
+
+- `OpenAPI` - 根文档对象
+- `Info` - API 元数据
+- `Server` - 服务器配置
+- `Paths` - API 路径和操作
+- `Operation` - 单个 API 操作
+- `Schema` - 数据模式定义
+- `Parameter` - 操作参数
+- `RequestBody` - 请求体定义
+- `Response` - 响应定义
+- `Components` - 可复用组件
+- `SecurityScheme` - 安全方案定义
+
+### 工具类型
+
+- `ExtractSchemaType<S>` - 从 OpenAPI Schema 中提取 TypeScript 类型
+- `ExtractRequestBodyType<Op, Components>` - 从 Operation 中提取请求体类型
+- `ExtractOkResponseBodyType<Op, Components>` - 从 Operation 中提取成功响应体类型
+- `ResolveReference<R, Components>` - 解析 $ref 引用为实际类型
+
+## 许可证
+
+[Apache 2.0](https://github.com/Ahoo-Wang/fetcher/blob/master/LICENSE)

package/dist/base-types.d.ts

@@ -0,0 +1,56 @@
+import { Schema } from './schema';
+import { Reference } from './reference';
+import { MediaType } from './parameters';
+/**
+ * HTTP methods as defined in the OpenAPI specification
+ */
+export type HTTPMethod = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
+/**
+ * Supported parameter locations in HTTP requests
+ */
+export type ParameterLocation = 'query' | 'header' | 'path' | 'cookie';
+/**
+ * Primitive data types supported by JSON Schema
+ */
+export type SchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'null';
+/**
+ * Additional external documentation
+ *
+ * @property description - A description of the target documentation
+ * @property url - The URL for the target documentation
+ */
+export interface ExternalDocumentation {
+    description?: string;
+    url: string;
+}
+/**
+ * Example object
+ *
+ * @property summary - Short description for the example
+ * @property description - Long description for the example
+ * @property value - Embedded literal example
+ * @property externalValue - A URL that points to the literal example
+ */
+export interface Example {
+    summary?: string;
+    description?: string;
+    value?: any;
+    externalValue?: string;
+}
+/**
+ * The Header Object follows the structure of the Parameter Object
+ */
+export interface Header {
+    description?: string;
+    required?: boolean;
+    deprecated?: boolean;
+    allowEmptyValue?: boolean;
+    style?: string;
+    explode?: boolean;
+    allowReserved?: boolean;
+    schema?: Schema | Reference;
+    example?: any;
+    examples?: Record<string, Example | Reference>;
+    content?: Record<string, MediaType>;
+}
+//# sourceMappingURL=base-types.d.ts.map

package/dist/base-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.d.ts","sourceRoot":"","sources":["../src/base-types.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpG;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnG;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC"}

package/dist/components.d.ts

@@ -0,0 +1,45 @@
+import { Reference } from './reference';
+import { Schema } from './schema';
+import { Response, Link, Callback } from './responses';
+import { Parameter, RequestBody } from './parameters';
+import { SecurityScheme } from './security';
+import { Example, Header } from './base-types';
+/**
+ * Holds a set of reusable objects for different aspects of the OAS
+ *
+ * @property schemas - An object to hold reusable Schema Objects
+ * @property responses - An object to hold reusable Response Objects
+ * @property parameters - An object to hold reusable Parameter Objects
+ * @property examples - An object to hold reusable Example Objects
+ * @property requestBodies - An object to hold reusable Request Body Objects
+ * @property headers - An object to hold reusable Header Objects
+ * @property securitySchemes - An object to hold reusable Security Scheme Objects
+ * @property links - An object to hold reusable Link Objects
+ * @property callbacks - An object to hold reusable Callback Objects
+ */
+export interface Components {
+    schemas?: Record<string, Schema | Reference>;
+    responses?: Record<string, Response | Reference>;
+    parameters?: Record<string, Parameter | Reference>;
+    examples?: Record<string, Example | Reference>;
+    requestBodies?: Record<string, RequestBody | Reference>;
+    headers?: Record<string, Header | Reference>;
+    securitySchemes?: Record<string, SecurityScheme | Reference>;
+    links?: Record<string, Link | Reference>;
+    callbacks?: Record<string, Callback | Reference>;
+}
+/**
+ * Mapping of component types to their respective interfaces
+ */
+export type ComponentTypeMap = {
+    schemas: Schema;
+    responses: Response;
+    parameters: Parameter;
+    examples: Example;
+    requestBodies: RequestBody;
+    headers: Header;
+    securitySchemes: SecurityScheme;
+    links: Link;
+    callbacks: Callback;
+};
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,cAAc,CAAC;IAChC,KAAK,EAAE,IAAI,CAAC;IACZ,SAAS,EAAE,QAAQ,CAAC;CACrB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Main entry point for OpenAPI TypeScript type definitions
+ */
+export * from './base-types';
+export * from './reference';
+export * from './info';
+export * from './server';
+export * from './paths';
+export * from './parameters';
+export * from './responses';
+export * from './components';
+export * from './security';
+export * from './schema';
+export * from './tags';
+export * from './openAPI';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA;;GAEG;AAGH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

package/dist/index.es.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/index.umd.js

@@ -0,0 +1,2 @@
+(function(n){typeof define=="function"&&define.amd?define(n):n()})((function(){"use strict"}));
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/info.d.ts

@@ -0,0 +1,44 @@
+/**
+ * API metadata type definitions for OpenAPI Specification
+ */
+/**
+ * Contact information for the exposed API
+ *
+ * @property name - The identifying name of the contact person/organization
+ * @property url - The URL pointing to the contact information
+ * @property email - The email address of the contact person/organization
+ */
+export interface Contact {
+    name?: string;
+    url?: string;
+    email?: string;
+}
+/**
+ * License information for the exposed API
+ *
+ * @property name - The license name used for the API
+ * @property url - A URL to the license used for the API
+ */
+export interface License {
+    name: string;
+    url?: string;
+}
+/**
+ * Metadata about the API
+ *
+ * @property title - The title of the API
+ * @property description - A short description of the API
+ * @property termsOfService - A URL to the Terms of Service for the API
+ * @property contact - The contact information for the exposed API
+ * @property license - The license information for the exposed API
+ * @property version - The version of the OpenAPI document
+ */
+export interface Info {
+    title?: string;
+    description?: string;
+    termsOfService?: string;
+    contact?: Contact;
+    license?: License;
+    version?: string;
+}
+//# sourceMappingURL=info.d.ts.map

package/dist/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../src/info.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/openAPI.d.ts

@@ -0,0 +1,30 @@
+import { Info } from './info';
+import { Server } from './server';
+import { Paths } from './paths';
+import { Components } from './components';
+import { SecurityRequirement } from './security';
+import { Tag } from './tags';
+import { ExternalDocumentation } from './base-types';
+/**
+ * Root document object for the OpenAPI specification
+ *
+ * @property openapi - This string must be the version number of the OpenAPI Specification
+ * @property info - Provides metadata about the API
+ * @property servers - An array of Server Objects which provide connectivity information
+ * @property paths - The available paths and operations for the API
+ * @property components - An element to hold various schemas for the specification
+ * @property security - A declaration of which security mechanisms can be used across the API
+ * @property tags - A list of tags used by the specification with additional metadata
+ * @property externalDocs - Additional external documentation
+ */
+export interface OpenAPI {
+    openapi: string;
+    info: Info;
+    servers?: Server[];
+    paths: Paths;
+    components?: Components;
+    security?: SecurityRequirement[];
+    tags?: Tag[];
+    externalDocs?: ExternalDocumentation;
+}
+//# sourceMappingURL=openAPI.d.ts.map

package/dist/openAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openAPI.d.ts","sourceRoot":"","sources":["../src/openAPI.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC"}

package/dist/parameters.d.ts

@@ -0,0 +1,78 @@
+import { Example, Header, ParameterLocation } from './base-types';
+import { Reference } from './reference';
+import { Schema } from './schema';
+/**
+ * Describes a single operation parameter
+ *
+ * @property name - The name of the parameter
+ * @property in - The location of the parameter
+ * @property description - A brief description of the parameter
+ * @property required - Determines whether this parameter is mandatory
+ * @property deprecated - Specifies that a parameter is deprecated
+ * @property allowEmptyValue - Sets the ability to pass empty-valued parameters
+ * @property style - Describes how the parameter value will be serialized
+ * @property explode - When true, parameter values of type array or object generate separate parameters
+ * @property allowReserved - Determines whether the parameter value should allow reserved characters
+ * @property schema - The schema defining the type used for the parameter
+ * @property example - Example of the parameter's potential value
+ * @property examples - Examples of the parameter's potential value
+ * @property content - A map containing the representations for the parameter
+ */
+export interface Parameter {
+    name: string;
+    in: ParameterLocation;
+    description?: string;
+    required?: boolean;
+    deprecated?: boolean;
+    allowEmptyValue?: boolean;
+    style?: string;
+    explode?: boolean;
+    allowReserved?: boolean;
+    schema?: Schema | Reference;
+    example?: any;
+    examples?: Record<string, Example | Reference>;
+    content?: Record<string, MediaType>;
+}
+/**
+ * Describes a single request body
+ *
+ * @property description - A brief description of the request body
+ * @property content - The content of the request body
+ * @property required - Determines if the request body is required in the request
+ */
+export interface RequestBody {
+    description?: string;
+    content: Record<string, MediaType>;
+    required?: boolean;
+}
+/**
+ * Each Media Type Object provides schema and examples for the media type identified by its key
+ *
+ * @property schema - The schema defining the content of the request, response, or parameter
+ * @property example - Example of the media type
+ * @property examples - Examples of the media type
+ * @property encoding - A map between a property name and its encoding information
+ */
+export interface MediaType {
+    schema?: Schema | Reference;
+    example?: any;
+    examples?: Record<string, Example | Reference>;
+    encoding?: Record<string, Encoding>;
+}
+/**
+ * A single encoding definition applied to a single schema property
+ *
+ * @property contentType - The Content-Type for encoding a specific property
+ * @property headers - A map allowing additional information to be provided as headers
+ * @property style - Describes how a specific property value will be serialized
+ * @property explode - When true, property values of type array or object generate separate parameters
+ * @property allowReserved - Determines whether the parameter value should allow reserved characters
+ */
+export interface Encoding {
+    contentType?: string;
+    headers?: Record<string, Header | Reference>;
+    style?: string;
+    explode?: boolean;
+    allowReserved?: boolean;
+}
+//# sourceMappingURL=parameters.d.ts.map

package/dist/parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../src/parameters.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,iBAAiB,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/paths.d.ts

@@ -0,0 +1,75 @@
+import { Reference } from './reference';
+import { Server } from './server';
+import { Parameter, RequestBody } from './parameters';
+import { Responses, Callback } from './responses';
+import { SecurityRequirement } from './security';
+import { ExternalDocumentation } from './base-types';
+/**
+ * Describes a single API operation on a path
+ *
+ * @property tags - A list of tags for API documentation control
+ * @property summary - A short summary of what the operation does
+ * @property description - A verbose explanation of the operation behavior
+ * @property externalDocs - Additional external documentation for this operation
+ * @property operationId - Unique string used to identify the operation
+ * @property parameters - List of parameters that are applicable for this operation
+ * @property requestBody - The request body applicable for this operation
+ * @property responses - The list of possible responses as they are returned from executing this operation
+ * @property callbacks - A map of possible out-of band callbacks related to the parent operation
+ * @property deprecated - Declares this operation to be deprecated
+ * @property security - Declaration of which security mechanisms can be used for this operation
+ * @property servers - Alternative server array to service this operation
+ */
+export interface Operation {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    externalDocs?: ExternalDocumentation;
+    operationId?: string;
+    parameters?: (Parameter | Reference)[];
+    requestBody?: RequestBody | Reference;
+    responses: Responses;
+    callbacks?: Record<string, Callback | Reference>;
+    deprecated?: boolean;
+    security?: SecurityRequirement[];
+    servers?: Server[];
+}
+/**
+ * Describes the operations available on a single path
+ *
+ * @property $ref - A reference to another path item
+ * @property summary - An optional summary of the path item
+ * @property description - An optional description of the path item
+ * @property get - Definition of a GET operation on this path
+ * @property put - Definition of a PUT operation on this path
+ * @property post - Definition of a POST operation on this path
+ * @property delete - Definition of a DELETE operation on this path
+ * @property options - Definition of an OPTIONS operation on this path
+ * @property head - Definition of a HEAD operation on this path
+ * @property patch - Definition of a PATCH operation on this path
+ * @property trace - Definition of a TRACE operation on this path
+ * @property servers - Alternative server array to service all operations in this path
+ * @property parameters - List of parameters that are applicable for all operations in this path
+ */
+export interface PathItem {
+    $ref?: string;
+    summary?: string;
+    description?: string;
+    get?: Operation;
+    put?: Operation;
+    post?: Operation;
+    delete?: Operation;
+    options?: Operation;
+    head?: Operation;
+    patch?: Operation;
+    trace?: Operation;
+    servers?: Server[];
+    parameters?: (Parameter | Reference)[];
+}
+/**
+ * Holds the relative paths to the individual endpoints and their operations
+ */
+export interface Paths {
+    [path: string]: PathItem;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC1B"}

package/dist/reference.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Reference object definitions for OpenAPI Specification
+ */
+/**
+ * Reference object to allow referencing components in the document
+ *
+ * @property $ref - JSON Pointer to the target component
+ */
+export interface Reference {
+    $ref: string;
+}
+/**
+ * Utility type to check if an object is a reference
+ */
+export type IsReference<T> = T extends {
+    $ref: string;
+} ? T : never;
+//# sourceMappingURL=reference.d.ts.map

package/dist/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/responses.d.ts

@@ -0,0 +1,51 @@
+import { Reference } from './reference';
+import { MediaType } from './parameters';
+import { Server } from './server';
+import { PathItem } from './paths';
+import { Header } from './base-types';
+/**
+ * The Link object represents a possible design-time link for a response
+ *
+ * @property operationRef - A relative or absolute reference to an OAS operation
+ * @property operationId - The name of an existing, resolvable OAS operation
+ * @property parameters - A map representing parameters to pass to an operation
+ * @property requestBody - A literal value or expression to use as a request body
+ * @property description - A description of the link
+ * @property server - A server object to be used by the target operation
+ */
+export interface Link {
+    operationRef?: string;
+    operationId?: string;
+    parameters?: Record<string, any>;
+    requestBody?: any;
+    description?: string;
+    server?: Server;
+}
+/**
+ * Describes a single response from an API Operation
+ *
+ * @property description - A description of the response
+ * @property headers - Maps a header name to its definition
+ * @property content - A map containing descriptions of potential response payloads
+ * @property links - A map of operations links that can be followed from the response
+ */
+export interface Response {
+    description?: string;
+    headers?: Record<string, Header | Reference>;
+    content?: Record<string, MediaType>;
+    links?: Record<string, Link | Reference>;
+}
+/**
+ * A container for the expected responses of an operation
+ */
+export interface Responses {
+    default?: Response | Reference;
+    [httpCode: string]: Response | Reference | undefined;
+}
+/**
+ * A map of possible out-of-band callbacks related to the parent operation
+ */
+export interface Callback {
+    [expression: string]: PathItem;
+}
+//# sourceMappingURL=responses.d.ts.map

package/dist/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../src/responses.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE/B,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;CAChC"}

package/dist/schema.d.ts

@@ -0,0 +1,109 @@
+import { ExternalDocumentation, SchemaType } from './base-types';
+import { Reference } from './reference';
+/**
+ * Adds support for polymorphism using discriminator
+ *
+ * @property propertyName - The name of the property in the payload that will hold the discriminator value
+ * @property mapping - An object to hold mappings between payload values and schema names or references
+ */
+export interface Discriminator {
+    propertyName: string;
+    mapping?: Record<string, string>;
+}
+/**
+ * A metadata object that allows for more fine-tuned XML model definitions
+ *
+ * @property name - Replaces the name of the element/attribute used for the described schema property
+ * @property namespace - The URI of the namespace definition
+ * @property prefix - The prefix to be used for the name
+ * @property attribute - Declares whether the property definition translates to an attribute instead of an element
+ * @property wrapped - MAY be used only for an array definition and signifies whether the array is wrapped
+ */
+export interface XML {
+    name?: string;
+    namespace?: string;
+    prefix?: string;
+    attribute?: boolean;
+    wrapped?: boolean;
+}
+/**
+ * The Schema Object allows the definition of input and output data types
+ *
+ * @property $schema - The URI of the JSON Schema dialect used for validation
+ * @property title - The title of the schema
+ * @property description - A description of the schema
+ * @property type - The data type of the schema
+ * @property format - The extending format for the previously mentioned type
+ * @property nullable - Allows sending a null value for the defined schema
+ * @property readOnly - Relevant only for Schema "properties" definitions
+ * @property writeOnly - Relevant only for Schema "properties" definitions
+ * @property deprecated - Specifies that a schema is deprecated
+ * @property example - A free-form property to include an example of an instance for this schema
+ * @property const - A value that the schema must exactly match
+ * @property default - The default value for this schema
+ * @property minimum - The minimum value of the range (for numeric types)
+ * @property maximum - The maximum value of the range (for numeric types)
+ * @property exclusiveMinimum - Whether the minimum value is excluded from the range
+ * @property exclusiveMaximum - Whether the maximum value is excluded from the range
+ * @property multipleOf - A number that must be a multiple of this value
+ * @property minLength - The minimum length of a string value
+ * @property maxLength - The maximum length of a string value
+ * @property pattern - The regular expression pattern that a string value must match
+ * @property items - The type definition for array items
+ * @property minItems - The minimum number of items in an array
+ * @property maxItems - The maximum number of items in an array
+ * @property uniqueItems - Whether all items in an array must be unique
+ * @property properties - The property definitions for an object type
+ * @property required - The list of required properties for an object type
+ * @property minProperties - The minimum number of properties for an object type
+ * @property maxProperties - The maximum number of properties for an object type
+ * @property additionalProperties - Defines whether additional properties are allowed
+ * @property allOf - Must be valid against all of the subschemas
+ * @property anyOf - Must be valid against any of the subschemas
+ * @property oneOf - Must be valid against exactly one of the subschemas
+ * @property not - Must not be valid against the supplied schema
+ * @property enum - The enumeration of possible values
+ * @property discriminator - Adds support for polymorphism
+ * @property xml - Additional metadata for XML formatting
+ * @property externalDocs - Additional external documentation for this schema
+ */
+export interface Schema {
+    $schema?: string;
+    title?: string;
+    description?: string;
+    type?: SchemaType | SchemaType[];
+    format?: string;
+    nullable?: boolean;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    deprecated?: boolean;
+    example?: any;
+    const?: any;
+    default?: any;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: boolean | number;
+    exclusiveMaximum?: boolean | number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    items?: Schema | Reference;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    properties?: Record<string, Schema | Reference>;
+    required?: string[];
+    minProperties?: number;
+    maxProperties?: number;
+    additionalProperties?: boolean | Schema | Reference;
+    allOf?: Array<Schema | Reference>;
+    anyOf?: Array<Schema | Reference>;
+    oneOf?: Array<Schema | Reference>;
+    not?: Schema | Reference;
+    enum?: any[];
+    discriminator?: Discriminator;
+    xml?: XML;
+    externalDocs?: ExternalDocumentation;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,GAAG;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,GAAG,CAAC;IAGd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAGpD,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAGzB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IAGb,aAAa,CAAC,EAAE,aAAa,CAAC;IAG9B,GAAG,CAAC,EAAE,GAAG,CAAC;IAGV,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC"}

package/dist/security.d.ts

@@ -0,0 +1,58 @@
+import { ParameterLocation } from './base-types';
+/**
+ * Configuration details for a supported OAuth Flow
+ *
+ * @property authorizationUrl - The authorization URL to be used for this flow
+ * @property tokenUrl - The token URL to be used for this flow
+ * @property refreshUrl - The URL to be used for obtaining refresh tokens
+ * @property scopes - The available scopes for the OAuth2 security scheme
+ */
+export interface OAuthFlow {
+    authorizationUrl?: string;
+    tokenUrl?: string;
+    refreshUrl?: string;
+    scopes: Record<string, string>;
+}
+/**
+ * Allows configuration of the supported OAuth Flows
+ *
+ * @property implicit - Configuration for the OAuth Implicit flow
+ * @property password - Configuration for the OAuth Resource Owner Password flow
+ * @property clientCredentials - Configuration for the OAuth Client Credentials flow
+ * @property authorizationCode - Configuration for the OAuth Authorization Code flow
+ */
+export interface OAuthFlows {
+    implicit?: OAuthFlow;
+    password?: OAuthFlow;
+    clientCredentials?: OAuthFlow;
+    authorizationCode?: OAuthFlow;
+}
+/**
+ * Defines a security scheme that can be used by the operations
+ *
+ * @property type - The type of the security scheme
+ * @property description - A short description for security scheme
+ * @property name - The name of the header, query or cookie parameter to be used
+ * @property in - The location of the API key
+ * @property scheme - The name of the HTTP Authorization scheme
+ * @property bearerFormat - A hint to the client to identify how the bearer token is formatted
+ * @property flows - An object containing configuration information for the flow types supported
+ * @property openIdConnectUrl - OpenId Connect URL to discover OAuth2 configuration values
+ */
+export interface SecurityScheme {
+    type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+    description?: string;
+    name?: string;
+    in?: ParameterLocation;
+    scheme?: string;
+    bearerFormat?: string;
+    flows?: OAuthFlows;
+    openIdConnectUrl?: string;
+}
+/**
+ * Lists the required security schemes to execute this operation
+ */
+export interface SecurityRequirement {
+    [name: string]: string[];
+}
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,iBAAiB,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,iBAAiB,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC1B"}

package/dist/server.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Server configuration type definitions for OpenAPI Specification
+ */
+/**
+ * Server variable for URL template substitution
+ *
+ * @property enum - An enumeration of string values to be used if the substitution options are from a limited set
+ * @property default - The default value to use for substitution
+ * @property description - An optional description for the server variable
+ */
+export interface ServerVariable {
+    enum?: string[];
+    default: string;
+    description?: string;
+}
+/**
+ * Server configuration details
+ *
+ * @property url - A URL to the target host
+ * @property description - An optional string describing the host designated by the URL
+ * @property variables - A map between a variable name and its value
+ */
+export interface Server {
+    url: string;
+    description?: string;
+    variables?: Record<string, ServerVariable>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAaA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C"}

package/dist/tags.d.ts

@@ -0,0 +1,14 @@
+import { ExternalDocumentation } from './base-types';
+/**
+ * Adds metadata to a single tag that is used by the Operation Object
+ *
+ * @property name - The name of the tag
+ * @property description - A description for the tag
+ * @property externalDocs - Additional external documentation for this tag
+ */
+export interface Tag {
+    name: string;
+    description?: string;
+    externalDocs?: ExternalDocumentation;
+}
+//# sourceMappingURL=tags.d.ts.map

package/dist/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@ahoo-wang/fetcher-openapi",
+  "version": "1.9.1",
+  "description": "OpenAPI Specification TypeScript types for Fetcher - A modern, ultra-lightweight HTTP client for browsers and Node.js. Provides complete TypeScript support with type inference for OpenAPI 3.x schemas.",
+  "keywords": [
+    "fetch",
+    "http",
+    "client",
+    "axios",
+    "ultra-lightweight",
+    "modular",
+    "typescript",
+    "interceptor",
+    "llm",
+    "streaming",
+    "sse",
+    "server-sent-events",
+    "openapi",
+    "openapi3",
+    "swagger",
+    "types",
+    "type-inference",
+    "schema",
+    "api",
+    "rest"
+  ],
+  "author": "Ahoo-Wang",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/Ahoo-Wang/fetcher/tree/master/packages/openapi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Ahoo-Wang/fetcher.git",
+    "directory": "packages/openapi"
+  },
+  "bugs": {
+    "url": "https://github.com/Ahoo-Wang/fetcher/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.umd.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.umd.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^9.35.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^9.35.0",
+    "globals": "^16.4.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.0",
+    "unplugin-dts": "1.0.0-beta.6",
+    "vite": "^7.1.6",
+    "vite-bundle-analyzer": "^1.2.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "vite build",
+    "test:ui": "vitest --ui",
+    "test": "vitest run --coverage",
+    "lint": "eslint . --fix",
+    "clean": "rm -rf dist",
+    "analyze": "npx vite-bundle-analyzer -p auto"
+  }
+}