@skmtc/core 0.0.24

package/esm/oas/parameter/Parameter.d.ts

@@ -0,0 +1,56 @@
+import { OasBase } from '../../oas-elements/OasBase.js';
+import type { OasParameterLocation, OasParameterStyle } from './parameter-types.js';
+import type { Trail } from '../../context/Trail.js';
+import type { CoreContext } from '../../context/CoreContext.js';
+import type { OasMediaType } from '../mediaType/MediaType.js';
+import type { OasRef } from '../ref/Ref.js';
+import type { OasExample } from '../example/Example.js';
+import type { OasSchema } from '../schema/Schema.js';
+export type ParameterFields = {
+    name: string;
+    location: OasParameterLocation;
+    description: string | undefined;
+    required: boolean | undefined;
+    deprecated: boolean | undefined;
+    allowEmptyValue: boolean | undefined;
+    allowReserved: boolean | undefined;
+    schema: OasSchema | OasRef<'schema'> | undefined;
+    examples: Record<string, OasExample | OasRef<'example'>> | undefined;
+    content: Record<string, OasMediaType> | undefined;
+    style: OasParameterStyle;
+    explode: boolean;
+};
+type ToParameterV3Args = {
+    fields: ParameterFields;
+    trail: Trail;
+    skipped: Record<string, unknown>;
+    context: CoreContext;
+};
+export declare class OasParameter extends OasBase {
+    oasType: 'parameter';
+    fields: ParameterFields;
+    private constructor();
+    static create({ fields, trail, context, skipped }: ToParameterV3Args): OasParameter;
+    get name(): string;
+    get location(): OasParameterLocation;
+    get description(): string | undefined;
+    get required(): boolean | undefined;
+    get deprecated(): boolean | undefined;
+    get allowEmptyValue(): boolean | undefined;
+    get schema(): OasSchema | OasRef<'schema'> | undefined;
+    get examples(): Record<string, OasExample | OasRef<'example'>> | undefined;
+    get content(): Record<string, OasMediaType> | undefined;
+    get style(): OasParameterStyle;
+    get explode(): boolean;
+    get allowReserved(): boolean | undefined;
+    isRef(): this is OasRef<'parameter'>;
+    resolve(): OasParameter;
+    toSchema(mediaType?: string): OasSchema | OasRef<'schema'> | undefined;
+    toSerialiseOptions(): {
+        style: OasParameterStyle;
+        explode: boolean;
+        allowReserved: boolean | undefined;
+    };
+}
+export {};
+//# sourceMappingURL=Parameter.d.ts.map

package/esm/oas/parameter/Parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Parameter.d.ts","sourceRoot":"","sources":["../../../src/oas/parameter/Parameter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AACvD,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAKpD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,UAAU,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B,eAAe,EAAE,OAAO,GAAG,SAAS,CAAA;IACpC,aAAa,EAAE,OAAO,GAAG,SAAS,CAAA;IAClC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IACpE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAAA;IACjD,KAAK,EAAE,iBAAiB,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,qBAAa,YAAa,SAAQ,OAAO;IACvC,OAAO,EAAE,WAAW,CAAc;IAClC,MAAM,EAAE,eAAe,CAAA;IAEvB,OAAO;IAMP,MAAM,CAAC,MAAM,CAAC,EACZ,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,EACR,EAAE,iBAAiB,GAAG,YAAY;IAInC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,oBAAoB,CAEnC;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;IAED,IAAI,UAAU,IAAI,OAAO,GAAG,SAAS,CAEpC;IAED,IAAI,eAAe,IAAI,OAAO,GAAG,SAAS,CAEzC;IAED,IAAI,MAAM,IAAI,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAErD;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAEzE;IAED,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAEtD;IAED,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,aAAa,IAAI,OAAO,GAAG,SAAS,CAEvC;IAED,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC;IAIpC,OAAO,IAAI,YAAY;IAIvB,QAAQ,CACN,SAAS,GAAE,MAA2B,GACrC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAQ3C,kBAAkB;;;;;CAOnB"}

package/esm/oas/parameter/Parameter.js

@@ -0,0 +1,77 @@
+import { OasBase } from '../../oas-elements/OasBase.js';
+export class OasParameter extends OasBase {
+    constructor({ fields, trail, skipped, context }) {
+        super({ trail, skipped, context });
+        Object.defineProperty(this, "oasType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'parameter'
+        });
+        Object.defineProperty(this, "fields", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.fields = fields;
+    }
+    static create({ fields, trail, context, skipped }) {
+        return new OasParameter({ fields, trail, context, skipped });
+    }
+    get name() {
+        return this.fields.name;
+    }
+    get location() {
+        return this.fields.location;
+    }
+    get description() {
+        return this.fields.description;
+    }
+    get required() {
+        return this.fields.required;
+    }
+    get deprecated() {
+        return this.fields.deprecated;
+    }
+    get allowEmptyValue() {
+        return this.fields.allowEmptyValue;
+    }
+    get schema() {
+        return this.fields.schema;
+    }
+    get examples() {
+        return this.fields.examples;
+    }
+    get content() {
+        return this.fields.content;
+    }
+    get style() {
+        return this.fields.style;
+    }
+    get explode() {
+        return this.fields.explode;
+    }
+    get allowReserved() {
+        return this.fields.allowReserved;
+    }
+    isRef() {
+        return false;
+    }
+    resolve() {
+        return this;
+    }
+    toSchema(mediaType = 'application/json') {
+        if (this.schema) {
+            return this.schema;
+        }
+        return this.fields.content?.[mediaType]?.schema;
+    }
+    toSerialiseOptions() {
+        return {
+            style: this.style,
+            explode: this.explode,
+            allowReserved: this.allowReserved
+        };
+    }
+}

package/esm/oas/parameter/parameter-types.d.ts

@@ -0,0 +1,26 @@
+import { type OasExampleData } from '../example/example-types.js';
+import { type OasMediaTypeData } from '../mediaType/mediaType-types.js';
+import { type OasExampleRefData, type OasSchemaRefData } from '../ref/ref-types.js';
+import { type OasSchemaData } from '../schema/schema-types.js';
+import { z } from 'zod';
+export type OasParameterLocation = 'query' | 'header' | 'path' | 'cookie';
+export declare const oasParameterLocation: z.ZodType<OasParameterLocation>;
+export type OasParameterStyle = 'matrix' | 'label' | 'form' | 'simple' | 'spaceDelimited' | 'pipeDelimited' | 'deepObject';
+export declare const oasParameterStyle: z.ZodType<OasParameterStyle>;
+export type OasParameterData = {
+    oasType: 'parameter';
+    allowEmptyValue?: boolean;
+    allowReserved?: boolean;
+    content?: Record<string, OasMediaTypeData>;
+    deprecated?: boolean;
+    description?: string;
+    examples?: Record<string, OasExampleData | OasExampleRefData>;
+    explode: boolean;
+    location: OasParameterLocation;
+    name: string;
+    required?: boolean;
+    schema?: OasSchemaData | OasSchemaRefData;
+    style: OasParameterStyle;
+};
+export declare const oasParameterData: z.ZodType<OasParameterData>;
+//# sourceMappingURL=parameter-types.d.ts.map

package/esm/oas/parameter/parameter-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-types.d.ts","sourceRoot":"","sources":["../../../src/oas/parameter/parameter-types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEzE,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAK/D,CAAA;AAEF,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,gBAAgB,GAChB,eAAe,GACf,YAAY,CAAA;AAEhB,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAQzD,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,WAAW,CAAA;IACpB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAA;IAC7D,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAA;IACzC,KAAK,EAAE,iBAAiB,CAAA;CACzB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAgBvD,CAAA"}

package/esm/oas/parameter/parameter-types.js

@@ -0,0 +1,38 @@
+import { oasExampleData } from '../example/example-types.js';
+import { markdown } from '../markdown/markdown-types.js';
+import { oasMediaTypeData } from '../mediaType/mediaType-types.js';
+import { oasExampleRefData, oasSchemaRefData } from '../ref/ref-types.js';
+import { oasSchemaData } from '../schema/schema-types.js';
+import { z } from 'zod';
+export const oasParameterLocation = z.enum([
+    'query',
+    'header',
+    'path',
+    'cookie'
+]);
+export const oasParameterStyle = z.enum([
+    'matrix',
+    'label',
+    'form',
+    'simple',
+    'spaceDelimited',
+    'pipeDelimited',
+    'deepObject'
+]);
+export const oasParameterData = z.object({
+    oasType: z.literal('parameter'),
+    // Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
+    // example: z.any().optional(),
+    allowReserved: z.boolean().optional(),
+    allowEmptyValue: z.boolean().optional(),
+    content: z.record(oasMediaTypeData).optional(),
+    deprecated: z.boolean().optional(),
+    description: markdown.optional(),
+    examples: z.record(z.union([oasExampleData, oasExampleRefData])).optional(),
+    explode: z.boolean(),
+    location: oasParameterLocation,
+    name: z.string(),
+    required: z.boolean().optional(),
+    schema: z.union([oasSchemaData, oasSchemaRefData]).optional(),
+    style: oasParameterStyle
+});

package/esm/oas/parameter/toParameterV3.d.ts

@@ -0,0 +1,25 @@
+import type { CoreContext } from '../../context/CoreContext.js';
+import type { OpenAPIV3 } from 'openapi-types';
+import type { Trail } from '../../context/Trail.js';
+import { OasParameter } from './Parameter.js';
+import type { OasRef } from '../ref/Ref.js';
+type ToParameterListV3Args = {
+    parameters: (OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject)[] | undefined;
+    trail: Trail;
+    context: CoreContext;
+};
+export declare const toParameterListV3: ({ parameters, trail, context }: ToParameterListV3Args) => (OasParameter | OasRef<'parameter'>)[] | undefined;
+type ToParametersV3Args = {
+    parameters: Record<string, OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject>;
+    trail: Trail;
+    context: CoreContext;
+};
+export declare const toParametersV3: ({ parameters, trail, context }: ToParametersV3Args) => Record<string, OasParameter | OasRef<'parameter'>>;
+type ToOptionalParametersV3Args = {
+    parameters: Record<string, OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject> | undefined;
+    trail: Trail;
+    context: CoreContext;
+};
+export declare const toOptionalParametersV3: ({ parameters, trail, context }: ToOptionalParametersV3Args) => Record<string, OasParameter | OasRef<'parameter'>> | undefined;
+export {};
+//# sourceMappingURL=toParameterV3.d.ts.map

package/esm/oas/parameter/toParameterV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toParameterV3.d.ts","sourceRoot":"","sources":["../../../src/oas/parameter/toParameterV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAQ/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAI9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAG3C,KAAK,qBAAqB,GAAG;IAC3B,UAAU,EACN,CAAC,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC,EAAE,GACzD,SAAS,CAAA;IACb,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,iBAAiB,mCAI3B,qBAAqB,KACpB,CAAC,YAAY,GAAG,OAAO,WAAW,CAAC,CAAC,EAAE,GACtC,SAQH,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,MAAM,CAChB,MAAM,EACN,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CACtD,CAAA;IACD,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,cAAc,mCAIxB,kBAAkB,KAAG,OAAO,MAAM,EAAE,YAAY,GAAG,OAAO,WAAW,CAAC,CASxE,CAAA;AAED,KAAK,0BAA0B,GAAG;IAChC,UAAU,EACN,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC,GACrE,SAAS,CAAA;IACb,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,sBAAsB,mCAIhC,0BAA0B,KACzB,OAAO,MAAM,EAAE,YAAY,GAAG,OAAO,WAAW,CAAC,CAAC,GAClD,SAMH,CAAA"}

package/esm/oas/parameter/toParameterV3.js

@@ -0,0 +1,88 @@
+import { isRef } from '../../helpers/refFns.js';
+import { oasParameterLocation, oasParameterStyle } from './parameter-types.js';
+import { toExamplesV3 } from '../example/toExamplesV3.js';
+import { toRefV31 } from '../ref/toRefV31.js';
+import { toOptionalSchemaV3 } from '../schema/toSchemasV3.js';
+import { toOptionalMediaTypeItemsV3 } from '../mediaType/toMediaTypeItemV3.js';
+import { OasParameter } from './Parameter.js';
+import { match } from 'ts-pattern';
+export const toParameterListV3 = ({ parameters, trail, context }) => {
+    if (!parameters) {
+        return undefined;
+    }
+    return parameters.map((parameter, index) => toParameterV3({ parameter, trail: trail.add(`${index}`), context }));
+};
+export const toParametersV3 = ({ parameters, trail, context }) => {
+    return Object.fromEntries(Object.entries(parameters).map(([key, value]) => {
+        return [
+            key,
+            toParameterV3({ parameter: value, trail: trail.add(key), context })
+        ];
+    }));
+};
+export const toOptionalParametersV3 = ({ parameters, trail, context }) => {
+    if (!parameters) {
+        return undefined;
+    }
+    return toParametersV3({ parameters, trail, context });
+};
+const toParameterV3 = ({ parameter, trail, context }) => {
+    if (isRef(parameter)) {
+        return toRefV31({ ref: parameter, refType: 'parameter', trail, context });
+    }
+    const { name, in: location, description, required, deprecated, allowEmptyValue, allowReserved, schema, example, examples, content, style, explode, ...skipped } = parameter;
+    const parsedLocation = oasParameterLocation.parse(location);
+    if (parsedLocation === 'path' && !required) {
+        context.warn({
+            message: `Path parameters must be required`,
+            trail
+        });
+    }
+    // Set missing 'required' to true for path parameters and false for others
+    const defaultRequired = typeof required === 'undefined'
+        ? parsedLocation === 'path'
+            ? true
+            : false
+        : required;
+    const fields = {
+        name,
+        location: parsedLocation,
+        description,
+        required: defaultRequired,
+        deprecated,
+        style: toStyle({ style, location: parsedLocation }),
+        explode: toExplode({ explode, style }),
+        allowEmptyValue,
+        allowReserved,
+        schema: toOptionalSchemaV3({ schema, trail: trail.add('schema'), context }),
+        examples: toExamplesV3({
+            examples,
+            example,
+            exampleKey: `${name}-${parsedLocation}`,
+            trail: trail.add('examples'),
+            context
+        }),
+        content: toOptionalMediaTypeItemsV3({
+            content,
+            trail: trail.add('content'),
+            context
+        })
+    };
+    return OasParameter.create({ fields, trail, skipped, context });
+};
+const toStyle = ({ style, location }) => {
+    const parsed = oasParameterStyle.optional().parse(style);
+    return (parsed ??
+        match(location)
+            .with('path', () => 'simple')
+            .with('header', () => 'simple')
+            .with('query', () => 'form')
+            .with('cookie', () => 'form')
+            .exhaustive());
+};
+const toExplode = ({ explode, style }) => {
+    return (explode ??
+        match(style)
+            .with('form', () => true)
+            .otherwise(() => false));
+};

package/esm/oas/pathItem/PathItem.d.ts

@@ -0,0 +1,27 @@
+import { OasBase } from '../../oas-elements/OasBase.js';
+import type { Trail } from '../../context/Trail.js';
+import type { CoreContext } from '../../context/CoreContext.js';
+import type { OasParameter } from '../parameter/Parameter.js';
+import type { OasRef } from '../ref/Ref.js';
+export type PathItemFields = {
+    summary: string | undefined;
+    description: string | undefined;
+    parameters: (OasParameter | OasRef<'parameter'>)[] | undefined;
+};
+type ToPathItemV3Args = {
+    fields: PathItemFields;
+    trail: Trail;
+    skipped: Record<string, unknown>;
+    context: CoreContext;
+};
+export declare class OasPathItem extends OasBase {
+    oasType: 'pathItem';
+    fields: PathItemFields;
+    private constructor();
+    static create({ fields, trail, context, skipped }: ToPathItemV3Args): OasPathItem;
+    get summary(): string | undefined;
+    get description(): string | undefined;
+    get parameters(): (OasParameter | OasRef<'parameter'>)[] | undefined;
+}
+export {};
+//# sourceMappingURL=PathItem.d.ts.map

package/esm/oas/pathItem/PathItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathItem.d.ts","sourceRoot":"","sources":["../../../src/oas/pathItem/PathItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,UAAU,EAAE,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,SAAS,CAAA;CAC/D,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,qBAAa,WAAY,SAAQ,OAAO;IACtC,OAAO,EAAE,UAAU,CAAa;IAChC,MAAM,EAAE,cAAc,CAAA;IAEtB,OAAO;IAMP,MAAM,CAAC,MAAM,CAAC,EACZ,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,EACR,EAAE,gBAAgB,GAAG,WAAW;IAIjC,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,UAAU,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,SAAS,CAEnE;CACF"}

package/esm/oas/pathItem/PathItem.js

@@ -0,0 +1,31 @@
+import { OasBase } from '../../oas-elements/OasBase.js';
+export class OasPathItem extends OasBase {
+    constructor({ fields, trail, skipped, context }) {
+        super({ trail, skipped, context });
+        Object.defineProperty(this, "oasType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'pathItem'
+        });
+        Object.defineProperty(this, "fields", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.fields = fields;
+    }
+    static create({ fields, trail, context, skipped }) {
+        return new OasPathItem({ fields, trail, context, skipped });
+    }
+    get summary() {
+        return this.fields.summary;
+    }
+    get description() {
+        return this.fields.description;
+    }
+    get parameters() {
+        return this.fields.parameters;
+    }
+}

package/esm/oas/pathItem/toPathItemV3.d.ts

@@ -0,0 +1,12 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { CoreContext } from '../../context/CoreContext.js';
+import type { Trail } from '../../context/Trail.js';
+import { OasPathItem } from './PathItem.js';
+type ToPathItemV3Args = {
+    pathItem: OpenAPIV3.PathItemObject;
+    trail: Trail;
+    context: CoreContext;
+};
+export declare const toPathItemV3: ({ pathItem, trail, context }: ToPathItemV3Args) => OasPathItem;
+export {};
+//# sourceMappingURL=toPathItemV3.d.ts.map

package/esm/oas/pathItem/toPathItemV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toPathItemV3.d.ts","sourceRoot":"","sources":["../../../src/oas/pathItem/toPathItemV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,SAAS,CAAC,cAAc,CAAA;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,YAAY,iCAItB,gBAAgB,KAAG,WAcrB,CAAA"}

package/esm/oas/pathItem/toPathItemV3.js

@@ -0,0 +1,15 @@
+import { toParameterListV3 } from '../parameter/toParameterV3.js';
+import { OasPathItem } from './PathItem.js';
+export const toPathItemV3 = ({ pathItem, trail, context }) => {
+    const { summary, description, parameters, ...skipped } = pathItem;
+    const fields = {
+        summary,
+        description,
+        parameters: toParameterListV3({
+            parameters,
+            trail: trail.add('parameters'),
+            context
+        })
+    };
+    return OasPathItem.create({ fields, trail, context, skipped });
+};

package/esm/oas/ref/Ref.d.ts

@@ -0,0 +1,42 @@
+import { OasBase } from '../../oas-elements/OasBase.js';
+import type { OasRefData } from './ref-types.js';
+import type { CoreContext } from '../../context/CoreContext.js';
+import type { Trail } from '../../context/Trail.js';
+import type { OasSchema } from '../schema/Schema.js';
+import type { OasResponse } from '../response/Response.js';
+import type { OasParameter } from '../parameter/Parameter.js';
+import type { OasExample } from '../example/Example.js';
+import type { OasRequestBody } from '../requestBody/RequestBody.js';
+import type { OasHeader } from '../header/Header.js';
+export type RefFields<T extends OasRefData['refType']> = {
+    refType: T;
+    $ref: string;
+    summary?: string;
+    description?: string;
+};
+type ToRefV3Args<T extends OasRefData['refType']> = {
+    fields: RefFields<T>;
+    trail: Trail;
+    context: CoreContext;
+    skipped: Record<string, unknown>;
+};
+export declare class OasRef<T extends OasRefData['refType']> extends OasBase {
+    oasType: 'ref';
+    type: 'ref';
+    fields: RefFields<T>;
+    private constructor();
+    static create<T extends OasRefData['refType']>({ fields, trail, context, skipped }: ToRefV3Args<T>): OasRef<T>;
+    resolve(lookupsPerformed?: number): ResolvedRef<T>;
+    isRef(): this is OasRef<T>;
+    resolveOnce(): OasRef<T> | ResolvedRef<T>;
+    get $ref(): string;
+    get refType(): OasRefData['refType'];
+    get summary(): string | undefined;
+    get description(): string | undefined;
+}
+export type OasComponentType = OasSchema | OasResponse | OasParameter | OasExample | OasRequestBody | OasHeader;
+export type ResolvedRef<T extends OasRefData['refType']> = Extract<OasComponentType, {
+    oasType: T;
+}>;
+export {};
+//# sourceMappingURL=Ref.d.ts.map

package/esm/oas/ref/Ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../../../src/oas/ref/Ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAIpD,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,IAAI;IACvD,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,WAAW,CAAC,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,IAAI;IAClD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACpB,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,CAAA;AAED,qBAAa,MAAM,CAAC,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,CAAE,SAAQ,OAAO;IAClE,OAAO,EAAE,KAAK,CAAQ;IACtB,IAAI,EAAE,KAAK,CAAQ;IACnB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAEpB,OAAO;IAMP,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,EAAE,EAC7C,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,EACR,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAI7B,OAAO,CAAC,gBAAgB,GAAE,MAAU,GAAG,WAAW,CAAC,CAAC,CAAC;IAUrD,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC;IAI1B,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IA0CzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAEnC;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;CACF;AAED,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,UAAU,GACV,cAAc,GACd,SAAS,CAAA;AAEb,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAChE,gBAAgB,EAChB;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CACf,CAAA"}

package/esm/oas/ref/Ref.js

@@ -0,0 +1,89 @@
+import { OasBase } from '../../oas-elements/OasBase.js';
+import { toRefName } from '../../helpers/refFns.js';
+import { match } from 'ts-pattern';
+const MAX_LOOKUPS = 10;
+export class OasRef extends OasBase {
+    constructor({ fields, trail, skipped, context }) {
+        super({ trail, skipped, context });
+        Object.defineProperty(this, "oasType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'ref'
+        });
+        Object.defineProperty(this, "type", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'ref'
+        });
+        Object.defineProperty(this, "fields", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.fields = fields;
+    }
+    static create({ fields, trail, context, skipped }) {
+        return new OasRef({ fields, trail, context, skipped });
+    }
+    resolve(lookupsPerformed = 0) {
+        if (lookupsPerformed >= MAX_LOOKUPS) {
+            throw new Error('Max lookups reached');
+        }
+        const resolved = this.resolveOnce();
+        return resolved.isRef() ? resolved.resolve(lookupsPerformed + 1) : resolved;
+    }
+    isRef() {
+        return true;
+    }
+    resolveOnce() {
+        const c = this.context.schemaModel.components;
+        const refName = toRefName(this.$ref);
+        const refType = this.refType;
+        const resolved = match(refType)
+            .with('schema', () => c?.schemas?.[refName])
+            .with('requestBody', () => c?.requestBodies?.[refName])
+            .with('parameter', () => c?.parameters?.[refName])
+            .with('response', () => c?.responses?.[refName])
+            .with('example', () => c?.examples?.[refName])
+            .with('header', () => c?.headers?.[refName])
+            .exhaustive();
+        if (!resolved) {
+            this.context.error({
+                trail: this.trail,
+                message: `Ref "${this.fields.$ref}" not found`
+            });
+        }
+        if (resolved.isRef()) {
+            if (resolved.refType !== this.refType) {
+                this.context.error({
+                    trail: this.trail,
+                    message: `Ref type mismatch for "${this.$ref}". Expected "${this.refType}" but got "${resolved.refType}"`
+                });
+            }
+        }
+        else {
+            if (resolved.oasType !== this.refType) {
+                this.context.error({
+                    trail: this.trail,
+                    message: `Type mismatch for "${this.$ref}". Expected "${this.refType}" but got "${resolved.oasType}"`
+                });
+            }
+        }
+        return resolved;
+    }
+    get $ref() {
+        return this.fields.$ref;
+    }
+    get refType() {
+        return this.fields.refType;
+    }
+    get summary() {
+        return this.fields.summary;
+    }
+    get description() {
+        return this.fields.description;
+    }
+}

package/esm/oas/ref/ref-types.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export type OasSchemaRefData = {
+    oasType: 'ref';
+    refType: 'schema';
+    $ref: string;
+    summary?: string;
+    description?: string;
+};
+export declare const oasSchemaRefData: z.ZodType<OasSchemaRefData>;
+export type OasResponseRefData = {
+    oasType: 'ref';
+    refType: 'response';
+    $ref: string;
+    summary?: string;
+    description?: string;
+};
+export declare const oasResponseRefData: z.ZodType<OasResponseRefData>;
+export type OasParameterRefData = {
+    oasType: 'ref';
+    refType: 'parameter';
+    $ref: string;
+    summary?: string;
+    description?: string;
+};
+export declare const oasParameterRefData: z.ZodType<OasParameterRefData>;
+export type OasExampleRefData = {
+    oasType: 'ref';
+    refType: 'example';
+    $ref: string;
+    summary?: string;
+    description?: string;
+};
+export declare const oasExampleRefData: z.ZodType<OasExampleRefData>;
+export type OasRequestBodyRefData = {
+    oasType: 'ref';
+    refType: 'requestBody';
+    $ref: string;
+    summary?: string;
+    description?: string;
+};
+export declare const oasRequestBodyRefData: z.ZodType<OasRequestBodyRefData>;
+export type OasHeaderRefData = {
+    oasType: 'ref';
+    refType: 'header';
+    $ref: string;
+    summary?: string;
+    description?: string;
+};
+export declare const oasHeaderRefData: z.ZodType<OasHeaderRefData>;
+export type OasRefData = OasSchemaRefData | OasResponseRefData | OasParameterRefData | OasExampleRefData | OasRequestBodyRefData | OasHeaderRefData;
+export declare const oasRefData: z.ZodType<OasRefData>;
+//# sourceMappingURL=ref-types.d.ts.map

package/esm/oas/ref/ref-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-types.d.ts","sourceRoot":"","sources":["../../../src/oas/ref/ref-types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,QAAQ,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAMvD,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,UAAU,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAM3D,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,WAAW,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAM7D,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,SAAS,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAMzD,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAQlE,CAAA;AACD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,QAAQ,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAMvD,CAAA;AAUF,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,gBAAgB,CAAA;AAGpB,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAQ3C,CAAA"}