@sdk-it/spec 0.20.0 → 0.22.0

package/dist/lib/operation.d.ts

@@ -1,9 +1,16 @@
-import type { OpenAPIObject, OperationObject, ParameterObject, ReferenceObject, ResponseObject } from 'openapi3-ts/oas31';
+import type { ComponentsObject, MediaTypeObject, OpenAPIObject, OperationObject, ParameterObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, SchemaObject, SecurityRequirementObject, SecuritySchemeObject } from 'openapi3-ts/oas31';
+import { type PaginationGuess } from './pagination/pagination.ts';
+export declare function augmentSpec(config: GenerateSdkConfig, verbose?: boolean): OurOpenAPIObject;
+export type OperationPagination = PaginationGuess & {
+    items: string;
+};
 export declare const defaults: Partial<GenerateSdkConfig> & Required<Pick<GenerateSdkConfig, 'operationId' | 'tag'>>;
-export type TunedOperationObject = Omit<OperationObject, 'operationId' | 'parameters' | 'responses'> & {
+export type TunedOperationObject = Omit<OperationObject, 'operationId' | 'tags' | 'parameters' | 'responses' | 'requestBody'> & {
+    tags: string[];
     operationId: string;
-    parameters: (ParameterObject | ReferenceObject)[];
+    parameters: ParameterObject[];
     responses: Record<string, ResponseObject>;
+    requestBody: OurRequestBodyObject;
 };
 export interface OperationEntry {
     name?: string;
@@ -16,12 +23,25 @@ export type Operation = {
     entry: OperationEntry;
     operation: TunedOperationObject;
 };
-export declare function forEachOperation<T>(config: GenerateSdkConfig, callback: (entry: OperationEntry, operation: TunedOperationObject) => T): T[];
+export declare function forEachOperation<T>(spec: OurOpenAPIObject, callback: (entry: OperationEntry, operation: TunedOperationObject) => T): T[];
+interface ResponsesConfig {
+    flattenErrorResponses?: boolean;
+}
 export interface GenerateSdkConfig {
     spec: OpenAPIObject;
+    responses?: ResponsesConfig;
     operationId?: (operation: OperationObject, path: string, method: string) => string;
     tag?: (operation: OperationObject, path: string) => string;
 }
+/**
+ * Sanitizes a potential tag name (assumed to be already camelCased)
+ * to avoid conflicts with reserved keywords or invalid starting characters (numbers).
+ * Appends an underscore if the tag matches a reserved keyword.
+ * Prepends an underscore if the tag starts with a number.
+ * @param tag The potential tag name, already camelCased.
+ * @returns The sanitized tag name.
+ */
+export declare function sanitizeTag(tag: string): string;
 /**
  * Attempts to determine a generic tag for an OpenAPI operation based on path and operationId.
  * Rules and fallbacks are documented within the code.
@@ -31,6 +51,7 @@ export interface GenerateSdkConfig {
  */
 export declare function determineGenericTag(pathString: string, operation: OperationObject): string;
 export declare function parseJsonContentType(contentType: string | null | undefined): string | null;
+export declare function isTextContentType(contentType: string | null | undefined): boolean;
 /**
  * Checks if a given content type string represents Server-Sent Events (SSE).
  * Handles case-insensitivity, parameters (like charset), and leading/trailing whitespace.
@@ -41,4 +62,45 @@ export declare function parseJsonContentType(contentType: string | null | undefi
 export declare function isSseContentType(contentType: string | null | undefined): boolean;
 export declare function isStreamingContentType(contentType: string | null | undefined): boolean;
 export declare function isSuccessStatusCode(statusCode: number | string): boolean;
+export declare function isErrorStatusCode(statusCode: number | string): boolean;
+export declare function patchParameters(spec: OurOpenAPIObject, schema: SchemaObject, parameters: ParameterObject[], security: SecurityRequirementObject[]): void;
+export declare function createOperation(options: {
+    name: string;
+    group: string;
+    security?: string[];
+    parameters?: {
+        query?: Record<string, {
+            schema: SchemaObject;
+            required?: boolean;
+        }>;
+        path?: Record<string, {
+            schema: SchemaObject;
+            required?: boolean;
+        }>;
+        header?: Record<string, {
+            schema: SchemaObject;
+            required?: boolean;
+        }>;
+        cookie?: Record<string, {
+            schema: SchemaObject;
+            required?: boolean;
+        }>;
+    };
+    response: Record<string, SchemaObject | Record<string, SchemaObject>>;
+    request?: Record<string, ReferenceObject>;
+}): TunedOperationObject;
+export interface OurOpenAPIObject extends OpenAPIObject {
+    'x-sdk-augmented'?: boolean;
+    components: Omit<ComponentsObject, 'schemas'> & {
+        schemas: Record<string, SchemaObject | ReferenceObject>;
+        securitySchemes: Record<string, SecuritySchemeObject | ReferenceObject>;
+    };
+    paths: PathsObject;
+}
+export interface OurRequestBodyObject extends RequestBodyObject {
+    content: Record<string, Omit<MediaTypeObject, 'schema'> & {
+        schema: ReferenceObject;
+    }>;
+}
+export {};
 //# sourceMappingURL=operation.d.ts.map

package/dist/lib/operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/lib/operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AAK3B,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAC/C,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,KAAK,CAAC,CAqBxD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,eAAe,EACf,aAAa,GAAG,YAAY,GAAG,WAAW,CAC3C,GAAG;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,eAAe,GAAG,eAAe,CAAC,EAAE,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AACD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAcF,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,oBAAoB,KAAK,CAAC,OAuCxE;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,CAAC,EAAE,CACZ,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,KACX,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5D;AA6ED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,eAAe,GACzB,MAAM,CAoLR;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,iBAuB1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAoBT;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAET;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAGxE"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/lib/operation.ts"],"names":[],"mappings":"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"}

package/dist/lib/pagination/pagination-result.d.ts

@@ -0,0 +1,20 @@
+import type { SchemaObject, SchemasObject } from 'openapi3-ts/oas31';
+/**
+ * Tries to guess the name of the property that holds the main list of items
+ * within an object schema using a series of heuristics.
+ *
+ * @param schema The OpenAPI SchemaObject, expected to be of type 'object'.
+ * @returns The name of the most likely property containing the items array,
+ *          or null if no array properties are found in the schema.
+ */
+export declare function getItemsName(properties: Record<string, SchemaObject>): string | null;
+/**
+ * Tries to guess the name of a boolean property that indicates if there are more items
+ * to fetch (e.g., for pagination).
+ *
+ * @param schema The OpenAPI SchemaObject, expected to be of type 'object'.
+ * @returns The name of the most likely boolean property indicating "has more",
+ *          or null if no suitable boolean property is found.
+ */
+export declare function getHasMoreName(properties: SchemasObject): string | null;
+//# sourceMappingURL=pagination-result.d.ts.map

package/dist/lib/pagination/pagination-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-result.d.ts","sourceRoot":"","sources":["../../../src/lib/pagination/pagination-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAoHrE;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,MAAM,GAAG,IAAI,CAmFf;AAmFD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAevE"}

package/dist/lib/pagination/pagination-result.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pagination-result.test.d.ts.map

package/dist/lib/pagination/pagination-result.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-result.test.d.ts","sourceRoot":"","sources":["../../../src/lib/pagination/pagination-result.test.ts"],"names":[],"mappings":""}

package/dist/lib/pagination/pagination.d.ts

@@ -0,0 +1,50 @@
+import type { SchemaObject } from 'openapi3-ts/oas31';
+import type { TunedOperationObject } from '../operation.ts';
+interface PaginationResultBase {
+    type: 'offset' | 'page' | 'cursor' | 'none';
+}
+export interface OffsetPaginationResult extends PaginationResultBase {
+    type: 'offset';
+    offsetParamName: string;
+    offsetKeyword: string;
+    limitParamName: string;
+    limitKeyword: string;
+}
+export interface PagePaginationResult extends PaginationResultBase {
+    type: 'page';
+    pageNumberParamName: string;
+    pageNumberKeyword: string;
+    pageSizeParamName: string;
+    pageSizeKeyword: string;
+}
+export interface CursorPaginationResult extends PaginationResultBase {
+    type: 'cursor';
+    cursorParamName: string;
+    cursorKeyword: string;
+    limitParamName: string;
+    limitKeyword: string;
+}
+export interface NoPaginationResult extends PaginationResultBase {
+    type: 'none';
+    reason: string;
+}
+export type PaginationGuess = ((OffsetPaginationResult | PagePaginationResult | CursorPaginationResult) & {
+    items: string;
+    hasMore: string;
+}) | NoPaginationResult;
+export declare const OFFSET_PARAM_REGEXES: RegExp[];
+export declare const GENERIC_LIMIT_PARAM_REGEXES: RegExp[];
+export declare const PAGE_NUMBER_REGEXES: RegExp[];
+export declare const PAGE_SIZE_REGEXES: RegExp[];
+export declare const CURSOR_REGEXES: RegExp[];
+export declare const CURSOR_LIMIT_REGEXES: RegExp[];
+/**
+ * Guesses the pagination strategy of an OpenAPI operation based on its query parameters.
+ * It checks for offset, page-based, and cursor-based pagination in that order.
+ *
+ * @param operation The OpenAPI operation object.
+ * @returns A PaginationGuess object indicating the detected type and relevant parameters.
+ */
+export declare function guessPagination(operation: TunedOperationObject, body?: SchemaObject, response?: SchemaObject): PaginationGuess;
+export {};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/lib/pagination/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/lib/pagination/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG5D,UAAU,oBAAoB;IAC5B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,IAAI,EAAE,QAAQ,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,IAAI,EAAE,QAAQ,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GACvB,CAAC,CACG,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,CACzB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACvC,kBAAkB,CAAC;AAIvB,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAKxC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAU/C,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,EAMvC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAUrC,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,MAAM,EAWlC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAUxC,CAAC;AA4IF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,oBAAoB,EAC/B,IAAI,CAAC,EAAE,YAAY,EACnB,QAAQ,CAAC,EAAE,YAAY,GACtB,eAAe,CAqCjB"}

package/dist/lib/pagination/pagination.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pagination.test.d.ts.map

package/dist/lib/pagination/pagination.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.test.d.ts","sourceRoot":"","sources":["../../../src/lib/pagination/pagination.test.ts"],"names":[],"mappings":""}

package/dist/lib/security.d.ts

@@ -0,0 +1,10 @@
+import type { OpenAPIObject, ParameterLocation, ParameterObject, ReferenceObject, SecurityRequirementObject, SecuritySchemeObject } from 'openapi3-ts/oas31';
+import type { OurOpenAPIObject } from './operation.ts';
+type OIn = ParameterLocation | 'input';
+type OurParameter = Omit<ParameterObject, 'in'> & {
+    in: OIn;
+};
+export declare function securityToOptions(spec: OpenAPIObject, security: SecurityRequirementObject[], securitySchemes: Record<string, SecuritySchemeObject | ReferenceObject>, staticIn?: OIn): OurParameter[];
+export declare function security(spec: OurOpenAPIObject): OurParameter[];
+export {};
+//# sourceMappingURL=security.d.ts.map

package/dist/lib/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/lib/security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,KAAK,GAAG,GAAG,iBAAiB,GAAG,OAAO,CAAC;AACvC,KAAK,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG;IAChD,EAAE,EAAE,GAAG,CAAC;CACT,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,yBAAyB,EAAE,EACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAAC,EACvE,QAAQ,CAAC,EAAE,GAAG,kBA2Cf;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,kBA4B9C"}

package/dist/lib/sidebar.d.ts

@@ -1,26 +1,23 @@
-import type { OpenAPIObject } from 'openapi3-ts/oas31';
+import { type OurOpenAPIObject } from './operation.js';
 export type ChildNavItem = {
     id: string;
     title: string;
     url: string;
-    isActive?: boolean;
 };
 export type NavItem = {
     id: string;
     title: string;
     description?: string;
     url: string;
-    isActive?: boolean;
     items?: ChildNavItem[];
 };
 export type CategoryItem = {
     category: string;
     description?: string;
     items: NavItem[];
-    isActive?: boolean;
 };
 export type SidebarData = CategoryItem[];
-export declare function toSidebar(spec: OpenAPIObject, route: string): SidebarData;
+export declare function toSidebar(spec: OurOpenAPIObject): SidebarData;
 export interface XOaiMeta {
     navigationGroups: NavigationGroup[];
     groups: Group[];
@@ -28,9 +25,9 @@ export interface XOaiMeta {
 export interface Group {
     id: string;
     title: string;
-    description: string;
+    description?: string;
     navigationGroup: string;
-    sections?: Section[];
+    sections: Section[];
     beta?: boolean;
     legacy?: boolean;
 }

package/dist/lib/sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/lib/sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC;AAGzC,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,eA6B3D;AAED,MAAM,WAAW,QAAQ;IACvB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/lib/sidebar.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC;AAyCzC,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,eAuC/C;AAED,MAAM,WAAW,QAAQ;IACvB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/lib/tune.d.ts

@@ -0,0 +1,11 @@
+import type { ReferenceObject, SchemaObject, SchemaObjectType } from 'openapi3-ts/oas31';
+import type { OurOpenAPIObject } from './operation.ts';
+export declare function fixSpec(spec: OurOpenAPIObject, schemas: (SchemaObject | ReferenceObject)[], visited?: Set<string>): void;
+type Refs = {
+    name: string;
+    value: SchemaObject;
+}[];
+export declare function expandSpec(spec: OurOpenAPIObject, schemas: Record<string, SchemaObject | ReferenceObject>, refs: Refs): void;
+export declare function coerceTypes(schema: SchemaObject, excludeNull?: boolean): SchemaObjectType[];
+export {};
+//# sourceMappingURL=tune.d.ts.map

package/dist/lib/tune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tune.d.ts","sourceRoot":"","sources":["../../src/lib/tune.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAe3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,wBAAgB,OAAO,CACrB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,CAAC,YAAY,GAAG,eAAe,CAAC,EAAE,EAC3C,OAAO,cAAoB,QA6J5B;AAED,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,EAAE,CAAC;AAEpD,wBAAgB,UAAU,CACxB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAAC,EACvD,IAAI,EAAE,IAAI,QAoJX;AA0CD,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,WAAW,UAAO,GACjB,gBAAgB,EAAE,CAUpB"}

package/dist/lib/tune.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tune.test.d.ts.map

package/dist/lib/tune.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tune.test.d.ts","sourceRoot":"","sources":["../../src/lib/tune.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdk-it/spec",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -26,9 +26,14 @@
     "!**/*.tsbuildinfo"
   ],
   "dependencies": {
+    "@sdk-it/core": "0.22.0",
     "openapi3-ts": "4.4.0",
-    "yaml": "^2.7.0",
+    "pluralize": "^8.0.0",
     "stringcase": "^4.3.1",
-    "@sdk-it/core": "0.20.0"
+    "yaml": "^2.7.0",
+    "fast-content-type-parse": "^3.0.0",
+    "lodash-es": "^4.17.21",
+    "debug": "^4.4.1",
+    "micromatch": "4.0.8"
   }
 }

package/dist/lib/loaders/load-spec.js

@@ -1,25 +0,0 @@
-import { loadLocal } from "./local-loader.js";
-import { convertPostmanToOpenAPI } from "./postman/postman-converter.js";
-import { loadRemote } from "./remote-loader.js";
-function isPostman(content) {
-  return typeof content === "object" && content !== null && "info" in content && typeof content.info === "object" && content.info !== null && "item" in content && Array.isArray(content.item) && "schema" in content.info && typeof content.info.schema === "string" && content.info.schema.includes("//schema.getpostman.com/");
-}
-async function loadSpec(location) {
-  const content = await loadFile(location);
-  if (isPostman(content)) {
-    return convertPostmanToOpenAPI(content);
-  }
-  return content;
-}
-function loadFile(location) {
-  const [protocol] = location.split(":");
-  if (protocol === "http" || protocol === "https") {
-    return loadRemote(location);
-  }
-  return loadLocal(location);
-}
-export {
-  loadFile,
-  loadSpec
-};
-//# sourceMappingURL=load-spec.js.map

package/dist/lib/loaders/load-spec.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/lib/loaders/load-spec.ts"],
-  "sourcesContent": ["import type { OpenAPIObject } from 'openapi3-ts/oas31';\n\nimport { loadLocal } from './local-loader.js';\nimport { convertPostmanToOpenAPI } from './postman/postman-converter.js';\nimport type { PostmanCollection } from './postman/spec-types.js';\nimport { loadRemote } from './remote-loader.js';\n\nfunction isPostman(content: unknown): content is PostmanCollection {\n  return (\n    typeof content === 'object' &&\n    content !== null &&\n    'info' in content &&\n    typeof content.info === 'object' &&\n    content.info !== null &&\n    'item' in content &&\n    Array.isArray(content.item) &&\n    'schema' in content.info &&\n    typeof content.info.schema === 'string' &&\n    content.info.schema.includes('//schema.getpostman.com/')\n  );\n}\nexport async function loadSpec(location: string): Promise<OpenAPIObject> {\n  const content = await loadFile(location);\n  if (isPostman(content)) {\n    return convertPostmanToOpenAPI(content);\n  }\n  return content as OpenAPIObject;\n}\n\nexport function loadFile<T>(location: string): Promise<T> {\n  const [protocol] = location.split(':');\n  if (protocol === 'http' || protocol === 'https') {\n    return loadRemote(location);\n  }\n  return loadLocal(location);\n}\n"],
-  "mappings": "AAEA,SAAS,iBAAiB;AAC1B,SAAS,+BAA+B;AAExC,SAAS,kBAAkB;AAE3B,SAAS,UAAU,SAAgD;AACjE,SACE,OAAO,YAAY,YACnB,YAAY,QACZ,UAAU,WACV,OAAO,QAAQ,SAAS,YACxB,QAAQ,SAAS,QACjB,UAAU,WACV,MAAM,QAAQ,QAAQ,IAAI,KAC1B,YAAY,QAAQ,QACpB,OAAO,QAAQ,KAAK,WAAW,YAC/B,QAAQ,KAAK,OAAO,SAAS,0BAA0B;AAE3D;AACA,eAAsB,SAAS,UAA0C;AACvE,QAAM,UAAU,MAAM,SAAS,QAAQ;AACvC,MAAI,UAAU,OAAO,GAAG;AACtB,WAAO,wBAAwB,OAAO;AAAA,EACxC;AACA,SAAO;AACT;AAEO,SAAS,SAAY,UAA8B;AACxD,QAAM,CAAC,QAAQ,IAAI,SAAS,MAAM,GAAG;AACrC,MAAI,aAAa,UAAU,aAAa,SAAS;AAC/C,WAAO,WAAW,QAAQ;AAAA,EAC5B;AACA,SAAO,UAAU,QAAQ;AAC3B;",
-  "names": []
-}

package/dist/lib/loaders/local-loader.js

@@ -1,20 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { extname } from "node:path";
-import { parse } from "yaml";
-async function loadLocal(location) {
-  const extName = extname(location);
-  const text = await readFile(location, "utf-8");
-  switch (extName) {
-    case ".json":
-      return JSON.parse(text);
-    case ".yaml":
-    case ".yml":
-      return parse(text);
-    default:
-      throw new Error(`Unsupported file extension: ${extName}`);
-  }
-}
-export {
-  loadLocal
-};
-//# sourceMappingURL=local-loader.js.map

package/dist/lib/loaders/local-loader.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/lib/loaders/local-loader.ts"],
-  "sourcesContent": ["import { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport { parse } from 'yaml';\n\nexport async function loadLocal(location: string) {\n  const extName = extname(location);\n  const text = await readFile(location, 'utf-8');\n  switch (extName) {\n    case '.json':\n      return JSON.parse(text);\n    case '.yaml':\n    case '.yml':\n      return parse(text);\n    default:\n      throw new Error(`Unsupported file extension: ${extName}`);\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,aAAa;AAEtB,eAAsB,UAAU,UAAkB;AAChD,QAAM,UAAU,QAAQ,QAAQ;AAChC,QAAM,OAAO,MAAM,SAAS,UAAU,OAAO;AAC7C,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO,KAAK,MAAM,IAAI;AAAA,IACxB,KAAK;AAAA,IACL,KAAK;AACH,aAAO,MAAM,IAAI;AAAA,IACnB;AACE,YAAM,IAAI,MAAM,+BAA+B,OAAO,EAAE;AAAA,EAC5D;AACF;",
-  "names": []
-}