@skmtc/core 0.0.926 → 0.0.930

package/esm/oas/number/toNumber.js

@@ -1,89 +1,29 @@
 import { OasNumber } from './Number.js';
 import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
-import * as v from 'valibot';
 import { oasNumberData, numberFormat } from './number-types.js';
 import { parseNullable } from '../_helpers/parseNullable.js';
-import { parseExample } from '../_helpers/parseExample.js';
 import { parseEnum } from '../_helpers/parseEnum.js';
-import { parseFormat } from '../_helpers/parseFormat.js';
-/**
- * Transforms an OpenAPI v3 number schema object into an internal OAS number representation.
- *
- * This function processes OpenAPI number schemas by extracting and parsing nullable values,
- * examples, enumerations, and default values. It handles the complete transformation from
- * raw OpenAPI JSON to the SKMTC internal number representation with proper validation
- * of number formats and constraints.
- *
- * The transformation follows a pipeline approach:
- * 1. Parse nullable flag and extract base value
- * 2. Parse example values with nullable support
- * 3. Parse enumeration constraints
- * 4. Parse default values
- * 5. Create final OasNumber instance with format validation
- *
- * @param args - Transformation arguments
- * @param args.context - Parse context providing utilities and tracing
- * @param args.value - The OpenAPI v3 number schema object to transform
- * @returns Transformed OAS number object with parsed properties
- *
- * @example Basic number transformation
- * ```typescript
- * import { toNumber } from '@skmtc/core';
- *
- * const openApiNumber = {
- *   type: 'number',
- *   format: 'double',
- *   minimum: 0,
- *   maximum: 100
- * };
- *
- * const oasNumber = toNumber({
- *   context: parseContext,
- *   value: openApiNumber
- * });
- *
- * console.log(oasNumber.format); // 'double'
- * console.log(oasNumber.minimum); // 0
- * ```
- *
- * @example Number with nullable and constraints
- * ```typescript
- * const priceNumber = {
- *   type: 'number',
- *   format: 'float',
- *   nullable: true,
- *   minimum: 0.01,
- *   maximum: 9999.99,
- *   exclusiveMaximum: true,
- *   default: null,
- *   example: 19.99
- * };
- *
- * const oasNumber = toNumber({
- *   context: parseContext,
- *   value: priceNumber
- * });
- *
- * console.log(oasNumber.nullable); // true
- * console.log(oasNumber.exclusiveMaximum); // true
- * ```
- */
+import * as v from 'valibot';
 export const toNumber = ({ context, value }) => {
     const { nullable, value: valueWithoutNullable } = parseNullable({
         value,
         context
     });
-    const { example, value: valueWithoutExample } = parseExample({
-        value: valueWithoutNullable,
-        nullable,
-        valibotSchema: v.number(),
-        context
+    const { example: unparsedExample, ...valueWithoutExample } = valueWithoutNullable;
+    const example = parseExample({
+        example: unparsedExample,
+        context,
+        parent: valueWithoutNullable,
+        nullable
     });
-    const { enum: enums, value: valueWithoutEnums } = parseEnum({
-        value: valueWithoutExample,
+    const { enum: unparsedEnums, ...valueWithoutEnums } = valueWithoutExample;
+    const enums = parseEnum({
+        value: unparsedEnums,
         nullable,
-        valibotSchema: v.number(),
-        context
+        parent: valueWithoutExample,
+        context,
+        check: isNumber,
+        toMessage: item => `Removed invalid enum. Expected "number", got: ${item}`
     });
     return toParsedNumber({
         context,
@@ -94,15 +34,19 @@ export const toNumber = ({ context, value }) => {
     });
 };
 const toParsedNumber = ({ context, nullable, example, enums, value: valueWithoutEnums }) => {
-    const { format, value: valueWithoutFormat } = parseFormat({
-        value: valueWithoutEnums,
-        valibotSchema: numberFormat,
-        context
+    const { format: unparsedFormat, ...valueWithoutFormat } = valueWithoutEnums;
+    const format = parseNumberFormat({
+        format: unparsedFormat,
+        context,
+        parent: valueWithoutEnums
     });
-    const { type: _type, title, description, multipleOf, maximum, exclusiveMaximum, minimum, exclusiveMinimum, default: defaultValue, ...skipped } = v.parse(oasNumberData, valueWithoutFormat);
+    if (!v.is(oasNumberData, valueWithoutFormat)) {
+        v.parse(oasNumberData, valueWithoutFormat);
+    }
+    const { type: _type, title, description, multipleOf, maximum, exclusiveMaximum, minimum, exclusiveMinimum, default: defaultValue, readOnly, writeOnly, deprecated, ...skipped } = valueWithoutFormat;
     const extensionFields = toSpecificationExtensionsV3({
         skipped,
-        parent: valueWithoutEnums,
+        parent: valueWithoutFormat,
         context,
         parentType: 'schema:number'
     });
@@ -119,6 +63,47 @@ const toParsedNumber = ({ context, nullable, example, enums, value: valueWithout
         maximum,
         exclusiveMaximum,
         minimum,
-        exclusiveMinimum
+        readOnly,
+        writeOnly,
+        exclusiveMinimum,
+        deprecated
     });
 };
+const parseNumberFormat = ({ format, context, parent }) => {
+    if (format === undefined) {
+        return undefined;
+    }
+    if (!v.is(numberFormat, format)) {
+        context.logIssue({
+            key: 'format',
+            level: 'warning',
+            message: `Invalid format: ${format}`,
+            parent,
+            type: 'INVALID_FORMAT'
+        });
+        return undefined;
+    }
+    return format;
+};
+const parseExample = ({ example, context, parent, nullable }) => {
+    if (example === undefined) {
+        return undefined;
+    }
+    if (nullable && example === null) {
+        return example;
+    }
+    if (!isNumber(example)) {
+        context.logIssue({
+            key: 'example',
+            level: 'warning',
+            message: `Removed invalid example. Expected "number", got: ${example}`,
+            parent,
+            type: 'INVALID_EXAMPLE'
+        });
+        return undefined;
+    }
+    return example;
+};
+const isNumber = (value) => {
+    return typeof value === 'number';
+};

package/esm/oas/object/Object.d.ts

@@ -1,4 +1,3 @@
-import "../../_dnt.polyfills.js";
 import type { OasRef } from '../ref/Ref.js';
 import type { OasSchema, ToJsonSchemaOptions } from '../schema/Schema.js';
 import type { CustomValue } from '../../types/CustomValue.js';

package/esm/oas/object/Object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Object.d.ts","sourceRoot":"","sources":["../../../src/oas/object/Object.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAClE,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAAG,SAAS,CAAA;IACnF,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/B,sEAAsE;IACtE,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACvC,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IACzE,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gDAAgD;IAChD,KAAK,CAAC,EAAE,QAAQ,SAAS,IAAI,GACzB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,CAAA;IACzC,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,sEAAsE;IACtE,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACvC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,GAAG,SAAS,CAAA;IAC9D,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,qBAAa,SAAS,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS;IAC/E;;;OAGG;IACH,OAAO,EAAG,QAAQ,CAAS;IAC3B;;OAEG;IACH,IAAI,EAAG,QAAQ,CAAS;IACxB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC9B;;OAEG;IACH,UAAU,EAAE,QAAQ,SAAS,IAAI,GAC7B,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7E,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAAG,SAAS,CAAA;IAC1E;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B;;;;OAIG;IACH,oBAAoB,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IAExE,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACpD;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACvC;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACvC,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,QAAQ,SAAS,IAAI,GACzB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,CAAA;IACzC;;;;;;;;;;;;;;;;;OAiBG;gBACS,MAAM,GAAE,eAAe,CAAC,QAAQ,CAAM;IAiBlD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC;IAQhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,SAAS;IAmBnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAkBvC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,SAAS;IAIpB,WAAW,IAAI,SAAS;IAIxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAC,oBAAoB;CA8B3E"}
+{"version":3,"file":"Object.d.ts","sourceRoot":"","sources":["../../../src/oas/object/Object.ts"],"names":[],"mappings":"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"}

package/esm/oas/object/Object.js

@@ -1,4 +1,3 @@
-import "../../_dnt.polyfills.js";
 import { match, P } from 'ts-pattern';
 /**
  * Represents an object schema in the OpenAPI Specification.

package/esm/oas/object/toObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toObject.d.ts","sourceRoot":"","sources":["../../../src/oas/object/toObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AASvC,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,SAAS,CAAC,YAAY,CAAA;IAC7B,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,oBAAoB,YAAY,KAAG,SA2B3D,CAAA"}
+{"version":3,"file":"toObject.d.ts","sourceRoot":"","sources":["../../../src/oas/object/toObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAQvC,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,SAAS,CAAC,YAAY,CAAA;IAC7B,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,oBAAoB,YAAY,KAAG,SAiC3D,CAAA"}

package/esm/oas/object/toObject.js

@@ -3,25 +3,28 @@ import { toOptionalSchemasV3 } from '../schema/toSchemasV3.js';
 import { toAdditionalPropertiesV3 } from './toAdditionalPropertiesV3.js';
 import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
 import { parseNullable } from '../_helpers/parseNullable.js';
-import { parseExample } from '../_helpers/parseExample.js';
 import { parseEnum } from '../_helpers/parseEnum.js';
-import * as v from 'valibot';
+import { tracer } from '../../helpers/tracer.js';
 export const toObject = ({ value, context }) => {
     const { nullable, value: valueWithoutNullable } = parseNullable({
         value,
         context
     });
-    const { example, value: valueWithoutExample } = parseExample({
-        value: valueWithoutNullable,
-        nullable,
-        valibotSchema: v.record(v.string(), v.any()),
-        context
+    const { example: unparsedExample, ...valueWithoutExample } = valueWithoutNullable;
+    const example = parseExample({
+        example: unparsedExample,
+        context,
+        parent: valueWithoutNullable,
+        nullable
     });
-    const { enum: enums, value: valueWithoutEnums } = parseEnum({
-        value: valueWithoutExample,
+    const { enum: unparsedEnums, ...valueWithoutEnums } = valueWithoutExample;
+    const enums = parseEnum({
+        value: unparsedEnums,
         nullable,
-        valibotSchema: v.record(v.string(), v.any()),
-        context
+        parent: valueWithoutExample,
+        context,
+        check: isObject,
+        toMessage: item => `Removed invalid enum. Expected "object", got: ${item}`
     });
     return toParsedObject({
         context,
@@ -45,14 +48,14 @@ const toParsedObject = ({ context, nullable, example, enums, value }) => {
         nullable,
         example,
         enums,
-        properties: context.trace('properties', () => toOptionalSchemasV3({
+        properties: tracer(context.stackTrail, 'properties', () => toOptionalSchemasV3({
             schemas: properties,
             context
         })),
         required,
         maxProperties,
         minProperties,
-        additionalProperties: context.trace('additionalProperties', () => toAdditionalPropertiesV3({ additionalProperties, context })),
+        additionalProperties: tracer(context.stackTrail, 'additionalProperties', () => toAdditionalPropertiesV3({ additionalProperties, context })),
         extensionFields,
         default: defaultValue,
         deprecated,
@@ -60,3 +63,25 @@ const toParsedObject = ({ context, nullable, example, enums, value }) => {
         writeOnly
     });
 };
+const parseExample = ({ example, context, parent, nullable }) => {
+    if (example === undefined) {
+        return undefined;
+    }
+    if (nullable && example === null) {
+        return example;
+    }
+    if (!isObject(example)) {
+        context.logIssue({
+            key: 'example',
+            level: 'warning',
+            message: `Invalid example: ${example}`,
+            parent,
+            type: 'INVALID_EXAMPLE'
+        });
+        return undefined;
+    }
+    return example;
+};
+const isObject = (value) => {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};

package/esm/oas/operation/Operation.d.ts

@@ -1,4 +1,3 @@
-import "../../_dnt.polyfills.js";
 import type { Method } from '../../types/Method.js';
 import type { OasPathItem } from '../pathItem/PathItem.js';
 import type { OasParameter } from '../parameter/Parameter.js';
@@ -11,6 +10,8 @@ import { OasObject } from '../object/Object.js';
 import type { ToJsonSchemaOptions } from '../schema/Schema.js';
 import type { OpenAPIV3 } from 'openapi-types';
 import type { OasSecurityRequirement } from '../securityRequirement/SecurityRequirement.js';
+import type { OasExternalDocs } from '../externalDocs/ExternalDocs.js';
+import type { OasServer } from '../server/Server.js';
 /**
  * Fields for configuring an OpenAPI operation object.
  *
@@ -43,8 +44,11 @@ export type OperationFields = {
     security?: OasSecurityRequirement[] | undefined;
     /** Whether this operation is deprecated */
     deprecated?: boolean | undefined;
+    /** External documentation for this operation */
+    externalDocs?: OasExternalDocs | undefined;
     /** OpenAPI specification extensions */
     extensionFields?: Record<string, unknown>;
+    servers?: OasServer[] | undefined;
 };
 /**
  * Arguments passed to request body mapping functions.
@@ -53,113 +57,6 @@ export type ToRequestBodyMapArgs = {
     schema: OasSchema | OasRef<'schema'>;
     requestBody: OasRequestBody;
 };
-/**
- * Represents an OpenAPI Operation Object in the SKMTC OAS processing system.
- *
- * The `OasOperation` class encapsulates a single API operation (path + method combination)
- * with all its associated metadata, parameters, request/response specifications, and
- * security requirements. It provides utilities for extracting common operation data
- * like success responses and request bodies.
- *
- * ## Key Features
- *
- * - **Path and Method**: Unique combination identifying the operation
- * - **Metadata Access**: Operation ID, summary, description, tags, and deprecation status
- * - **Parameter Handling**: Query, path, header, and cookie parameters
- * - **Request/Response Specs**: Type-safe access to request body and response definitions
- * - **Security Context**: Operation-specific security requirements
- * - **Success Response Utils**: Helper methods to identify and extract successful responses
- *
- * @example Basic operation properties
- * ```typescript
- * import { OasOperation } from '@skmtc/core';
- *
- * // Typically created during document parsing
- * const getUserOp = new OasOperation({
- *   path: '/users/{id}',
- *   method: 'get',
- *   operationId: 'getUserById',
- *   summary: 'Get user by ID',
- *   description: 'Retrieves a single user by their unique identifier',
- *   parameters: [
- *     // Path parameter for user ID
- *     { name: 'id', in: 'path', required: true, schema: { type: 'string' } }
- *   ],
- *   responses: {
- *     '200': { description: 'User found', content: { ... } },
- *     '404': { description: 'User not found' }
- *   }
- * });
- *
- * console.log(getUserOp.path);        // '/users/{id}'
- * console.log(getUserOp.method);      // 'get'
- * console.log(getUserOp.operationId); // 'getUserById'
- * ```
- *
- * @example Working with success responses
- * ```typescript
- * // Find the primary success response
- * const successResponse = operation.toSuccessResponse();
- * if (successResponse) {
- *   const resolved = successResponse.resolve();
- *   console.log('Success response:', resolved.description);
- * }
- *
- * // Get the HTTP status code for success
- * const successCode = operation.toSuccessResponseCode();
- * console.log('Success status:', successCode); // '200', '201', 'default', etc.
- * ```
- *
- * @example Extracting request body data
- * ```typescript
- * // Extract request body with custom transformation
- * const requestData = operation.toRequestBody(({ schema, requestBody }) => {
- *   return {
- *     schema: schema,
- *     contentType: 'application/json',
- *     required: requestBody.required ?? false,
- *     description: requestBody.description
- *   };
- * });
- *
- * if (requestData) {
- *   console.log('Request schema:', requestData.schema);
- *   console.log('Required:', requestData.required);
- * }
- * ```
- *
- * @example Parameter processing
- * ```typescript
- * // Process operation parameters by location
- * const pathParams = operation.parameters?.filter(param => {
- *   const resolved = param.resolve();
- *   return resolved.in === 'path';
- * });
- *
- * const queryParams = operation.parameters?.filter(param => {
- *   const resolved = param.resolve();
- *   return resolved.in === 'query';
- * });
- *
- * console.log('Path parameters:', pathParams?.length);
- * console.log('Query parameters:', queryParams?.length);
- * ```
- *
- * @example Security requirements
- * ```typescript
- * if (operation.security) {
- *   console.log('Operation has specific security requirements');
- *   for (const requirement of operation.security) {
- *     // Process security schemes for this operation
- *     Object.keys(requirement.schemes).forEach(scheme => {
- *       console.log(`Security scheme: ${scheme}`);
- *     });
- *   }
- * } else {
- *   console.log('Operation uses default document security');
- * }
- * ```
- */
 export declare class OasOperation {
     /** Type identifier for OAS operation objects */
     oasType: 'operation';
@@ -187,8 +84,12 @@ export declare class OasOperation {
     security: OasSecurityRequirement[] | undefined;
     /** Whether this operation is deprecated */
     deprecated: boolean | undefined;
+    /** External documentation for this operation */
+    externalDocs: OasExternalDocs | undefined;
     /** OpenAPI specification extensions */
     extensionFields: Record<string, unknown> | undefined;
+    /** Servers for this operation */
+    servers: OasServer[] | undefined;
     /**
      * Creates a new OasOperation instance from operation field data.
      *

package/esm/oas/operation/Operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/oas/operation/Operation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/oas/operation/Operation.ts"],"names":[],"mappings":"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"}

package/esm/oas/operation/Operation.js

@@ -1,112 +1,4 @@
-import "../../_dnt.polyfills.js";
 import { OasObject } from '../object/Object.js';
-/**
- * Represents an OpenAPI Operation Object in the SKMTC OAS processing system.
- *
- * The `OasOperation` class encapsulates a single API operation (path + method combination)
- * with all its associated metadata, parameters, request/response specifications, and
- * security requirements. It provides utilities for extracting common operation data
- * like success responses and request bodies.
- *
- * ## Key Features
- *
- * - **Path and Method**: Unique combination identifying the operation
- * - **Metadata Access**: Operation ID, summary, description, tags, and deprecation status
- * - **Parameter Handling**: Query, path, header, and cookie parameters
- * - **Request/Response Specs**: Type-safe access to request body and response definitions
- * - **Security Context**: Operation-specific security requirements
- * - **Success Response Utils**: Helper methods to identify and extract successful responses
- *
- * @example Basic operation properties
- * ```typescript
- * import { OasOperation } from '@skmtc/core';
- *
- * // Typically created during document parsing
- * const getUserOp = new OasOperation({
- *   path: '/users/{id}',
- *   method: 'get',
- *   operationId: 'getUserById',
- *   summary: 'Get user by ID',
- *   description: 'Retrieves a single user by their unique identifier',
- *   parameters: [
- *     // Path parameter for user ID
- *     { name: 'id', in: 'path', required: true, schema: { type: 'string' } }
- *   ],
- *   responses: {
- *     '200': { description: 'User found', content: { ... } },
- *     '404': { description: 'User not found' }
- *   }
- * });
- *
- * console.log(getUserOp.path);        // '/users/{id}'
- * console.log(getUserOp.method);      // 'get'
- * console.log(getUserOp.operationId); // 'getUserById'
- * ```
- *
- * @example Working with success responses
- * ```typescript
- * // Find the primary success response
- * const successResponse = operation.toSuccessResponse();
- * if (successResponse) {
- *   const resolved = successResponse.resolve();
- *   console.log('Success response:', resolved.description);
- * }
- *
- * // Get the HTTP status code for success
- * const successCode = operation.toSuccessResponseCode();
- * console.log('Success status:', successCode); // '200', '201', 'default', etc.
- * ```
- *
- * @example Extracting request body data
- * ```typescript
- * // Extract request body with custom transformation
- * const requestData = operation.toRequestBody(({ schema, requestBody }) => {
- *   return {
- *     schema: schema,
- *     contentType: 'application/json',
- *     required: requestBody.required ?? false,
- *     description: requestBody.description
- *   };
- * });
- *
- * if (requestData) {
- *   console.log('Request schema:', requestData.schema);
- *   console.log('Required:', requestData.required);
- * }
- * ```
- *
- * @example Parameter processing
- * ```typescript
- * // Process operation parameters by location
- * const pathParams = operation.parameters?.filter(param => {
- *   const resolved = param.resolve();
- *   return resolved.in === 'path';
- * });
- *
- * const queryParams = operation.parameters?.filter(param => {
- *   const resolved = param.resolve();
- *   return resolved.in === 'query';
- * });
- *
- * console.log('Path parameters:', pathParams?.length);
- * console.log('Query parameters:', queryParams?.length);
- * ```
- *
- * @example Security requirements
- * ```typescript
- * if (operation.security) {
- *   console.log('Operation has specific security requirements');
- *   for (const requirement of operation.security) {
- *     // Process security schemes for this operation
- *     Object.keys(requirement.schemes).forEach(scheme => {
- *       console.log(`Security scheme: ${scheme}`);
- *     });
- *   }
- * } else {
- *   console.log('Operation uses default document security');
- * }
- * ```
- */
 export class OasOperation {
     /**
      * Creates a new OasOperation instance from operation field data.
@@ -205,6 +97,13 @@ export class OasOperation {
             writable: true,
             value: void 0
         });
+        /** External documentation for this operation */
+        Object.defineProperty(this, "externalDocs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         /** OpenAPI specification extensions */
         Object.defineProperty(this, "extensionFields", {
             enumerable: true,
@@ -212,6 +111,13 @@ export class OasOperation {
             writable: true,
             value: void 0
         });
+        /** Servers for this operation */
+        Object.defineProperty(this, "servers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.path = fields.path;
         this.method = fields.method;
         this.pathItem = fields.pathItem;
@@ -224,7 +130,9 @@ export class OasOperation {
         this.responses = fields.responses;
         this.security = fields.security;
         this.deprecated = fields.deprecated;
+        this.externalDocs = fields.externalDocs;
         this.extensionFields = fields.extensionFields;
+        this.servers = fields.servers;
     }
     /**
      * Returns the successful response definition for this operation.

package/esm/oas/operation/toOperationsV3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toOperationsV3.d.ts","sourceRoot":"","sources":["../../../src/oas/operation/toOperationsV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAIjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAO1D,KAAK,aAAa,GAAG;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAA;CAClC,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,SAAS,CAAC,eAAe,CAAA;IACpC,aAAa,EAAE,aAAa,CAAA;IAC5B,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAOD,eAAO,MAAM,aAAa,GAAI,uCAI3B,iBAAiB,KAAG,YAsCtB,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,SAAS,CAAC,WAAW,CAAA;IAC5B,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,oBAAoB,kBAAkB,KAAG,YAAY,EAsEnF,CAAA"}
+{"version":3,"file":"toOperationsV3.d.ts","sourceRoot":"","sources":["../../../src/oas/operation/toOperationsV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAIjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAU1D,KAAK,aAAa,GAAG;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAA;CAClC,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,SAAS,CAAC,eAAe,CAAA;IACpC,aAAa,EAAE,aAAa,CAAA;IAC5B,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAOD,eAAO,MAAM,aAAa,GAAI,uCAI3B,iBAAiB,KAAG,YAkDtB,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,SAAS,CAAC,WAAW,CAAA;IAC5B,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,oBAAoB,kBAAkB,KAAG,YAAY,EAsEnF,CAAA"}