@skmtc/core 0.0.926 → 0.0.930

package/script/context/ParseContext.d.ts

@@ -1,10 +1,9 @@
-import "../_dnt.polyfills.js";
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasDocument } from '../oas/document/Document.js';
 import type { Logger } from '../types/Logger.js';
 import type { StackTrail } from './StackTrail.js';
-import * as v from 'valibot';
 import type { IssueType } from './types.js';
+import type * as v from 'valibot';
 /**
  * Constructor arguments for {@link ParseContext}.
  */
@@ -131,114 +130,6 @@ export type ParseWarning = {
  * Union type for all parsing issues.
  */
 export type ParseIssue = ParseError | ParseWarning;
-/**
- * The parsing context for the first phase of the SKMTC transformation pipeline.
- *
- * `ParseContext` is responsible for converting OpenAPI v3 JSON documents into
- * the internal OAS (OpenAPI Schema) object representation used by SKMTC. It
- * provides comprehensive error handling, validation, and issue tracking during
- * the parsing process.
- *
- * This context handles the complex task of transforming external OpenAPI
- * specifications into type-safe internal representations while maintaining
- * detailed information about any parsing issues or inconsistencies found.
- *
- * ## Key Features
- *
- * - **JSON to OAS Conversion**: Transforms OpenAPI JSON into typed OAS objects
- * - **Validation & Error Handling**: Comprehensive validation with detailed error reporting
- * - **Issue Tracking**: Collects warnings and errors with precise location information
- * - **Reference Management**: Handles complex reference resolution and tracking
- * - **Logging Integration**: Provides detailed logging and tracing capabilities
- * - **Silent Mode**: Can suppress console output while maintaining error collection
- *
- * @example Basic parsing usage
- * ```typescript
- * import { ParseContext } from '@skmtc/core';
- *
- * const parseContext = new ParseContext({
- *   documentObject: openApiJsonDocument,
- *   logger: myLogger,
- *   stackTrail: traceStack,
- *   silent: false
- * });
- *
- * const oasDocument = parseContext.parse();
- *
- * // Check for parsing issues
- * if (parseContext.issues.length > 0) {
- *   console.log('Parsing issues found:');
- *   parseContext.issues.forEach(issue => {
- *     console.log(`${issue.level}: ${issue.location} - ${issue.message || issue.error?.message}`);
- *   });
- * }
- *
- * // Use the parsed document
- * console.log('Parsed schemas:', Object.keys(oasDocument.components?.schemas || {}));
- * ```
- *
- * @example Error handling during parsing
- * ```typescript
- * const parseContext = new ParseContext({
- *   documentObject: malformedOpenApiDoc,
- *   logger: logger,
- *   stackTrail: stack,
- *   silent: true
- * });
- *
- * try {
- *   const parsed = parseContext.parse();
- *
- *   // Separate errors from warnings
- *   const errors = parseContext.issues.filter(issue => issue.level === 'error');
- *   const warnings = parseContext.issues.filter(issue => issue.level === 'warning');
- *
- *   if (errors.length > 0) {
- *     console.error(`${errors.length} parsing errors found`);
- *     errors.forEach(error => {
- *       console.error(`Error at ${error.location}: ${error.error.message}`);
- *     });
- *   }
- *
- *   if (warnings.length > 0) {
- *     console.warn(`${warnings.length} parsing warnings found`);
- *     warnings.forEach(warning => {
- *       console.warn(`Warning at ${warning.location}: ${warning.message}`);
- *     });
- *   }
- * } catch (error) {
- *   console.error('Critical parsing failure:', error);
- * }
- * ```
- *
- * @example Integration with CoreContext
- * ```typescript
- * // Typically used within CoreContext.parse()
- * class CustomCoreContext extends CoreContext {
- *   parseWithCustomValidation(document: OpenAPIV3.Document) {
- *     const parseContext = new ParseContext({
- *       documentObject: document,
- *       logger: this.logger,
- *       stackTrail: this.stackTrail,
- *       silent: this.silent
- *     });
- *
- *     const parsed = parseContext.parse();
- *
- *     // Custom post-processing based on issues
- *     const criticalErrors = parseContext.issues.filter(issue =>
- *       issue.level === 'error' && issue.type === 'schema-validation'
- *     );
- *
- *     if (criticalErrors.length > 0) {
- *       throw new Error(`Schema validation failed: ${criticalErrors.length} critical errors`);
- *     }
- *
- *     return parsed;
- *   }
- * }
- * ```
- */
 export declare class ParseContext {
     #private;
     /** The original OpenAPI v3 document being parsed */
@@ -283,27 +174,12 @@ export declare class ParseContext {
      * @param $ref - Reference string that caused the error (if available)
      */
     registerRefError(error: Error, $ref: string | undefined): void;
-    /**
-     * Executes a function within a traced context for debugging and monitoring.
-     *
-     * @param token - Trace identifier or path segments
-     * @param fn - Function to execute within the trace context
-     * @returns The result of the traced function execution
-     */
-    trace<T>(token: string | string[], fn: () => T): T;
     /**
      * Logs warnings for fields that were skipped during parsing.
      *
      * @param args - Arguments containing skipped fields and parent context
      */
     logSkippedFields({ skipped, parent, parentType }: LogSkippedValuesArgs): void;
-    /**
-     * Attempts to parse a value with optional error handling and logging.
-     *
-     * @param args - Parsing arguments including schema and error handling
-     * @returns Parsed value or undefined if parsing fails
-     */
-    provisionalParse<T>({ key, value, parent, schema, toMessage, type }: ProvisionalParseArgs<T>): T | undefined;
     /**
      * Logs a parsing issue with associated key context.
      *
@@ -317,14 +193,5 @@ export declare class ParseContext {
      */
     logIssueNoKey({ parent, type, ...issue }: LogIssueNoKeyArgs): void;
 }
-/**
- * Parses an OpenAPI v3 schema from string format (JSON or YAML).
- *
- * Automatically detects the format based on content and parses accordingly.
- *
- * @param schema - Schema string in JSON or YAML format
- * @returns Parsed OpenAPI v3 document object
- */
-export declare const parseSchema: (schema: string) => OpenAPIV3.Document;
 export {};
 //# sourceMappingURL=ParseContext.d.ts.map

package/script/context/ParseContext.d.ts.map

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

package/script/context/ParseContext.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -45,121 +12,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _ParseContext_refStackTrails, _ParseContext_refErrors;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseSchema = exports.ParseContext = void 0;
-require("../_dnt.polyfills.js");
-const parse_js_1 = require("../deps/jsr.io/@std/yaml/1.0.10/parse.js");
+exports.ParseContext = void 0;
 const toDocumentFieldsV3_js_1 = require("../oas/document/toDocumentFieldsV3.js");
 const Document_js_1 = require("../oas/document/Document.js");
 const tracer_js_1 = require("../helpers/tracer.js");
-const v = __importStar(require("valibot"));
-/**
- * The parsing context for the first phase of the SKMTC transformation pipeline.
- *
- * `ParseContext` is responsible for converting OpenAPI v3 JSON documents into
- * the internal OAS (OpenAPI Schema) object representation used by SKMTC. It
- * provides comprehensive error handling, validation, and issue tracking during
- * the parsing process.
- *
- * This context handles the complex task of transforming external OpenAPI
- * specifications into type-safe internal representations while maintaining
- * detailed information about any parsing issues or inconsistencies found.
- *
- * ## Key Features
- *
- * - **JSON to OAS Conversion**: Transforms OpenAPI JSON into typed OAS objects
- * - **Validation & Error Handling**: Comprehensive validation with detailed error reporting
- * - **Issue Tracking**: Collects warnings and errors with precise location information
- * - **Reference Management**: Handles complex reference resolution and tracking
- * - **Logging Integration**: Provides detailed logging and tracing capabilities
- * - **Silent Mode**: Can suppress console output while maintaining error collection
- *
- * @example Basic parsing usage
- * ```typescript
- * import { ParseContext } from '@skmtc/core';
- *
- * const parseContext = new ParseContext({
- *   documentObject: openApiJsonDocument,
- *   logger: myLogger,
- *   stackTrail: traceStack,
- *   silent: false
- * });
- *
- * const oasDocument = parseContext.parse();
- *
- * // Check for parsing issues
- * if (parseContext.issues.length > 0) {
- *   console.log('Parsing issues found:');
- *   parseContext.issues.forEach(issue => {
- *     console.log(`${issue.level}: ${issue.location} - ${issue.message || issue.error?.message}`);
- *   });
- * }
- *
- * // Use the parsed document
- * console.log('Parsed schemas:', Object.keys(oasDocument.components?.schemas || {}));
- * ```
- *
- * @example Error handling during parsing
- * ```typescript
- * const parseContext = new ParseContext({
- *   documentObject: malformedOpenApiDoc,
- *   logger: logger,
- *   stackTrail: stack,
- *   silent: true
- * });
- *
- * try {
- *   const parsed = parseContext.parse();
- *
- *   // Separate errors from warnings
- *   const errors = parseContext.issues.filter(issue => issue.level === 'error');
- *   const warnings = parseContext.issues.filter(issue => issue.level === 'warning');
- *
- *   if (errors.length > 0) {
- *     console.error(`${errors.length} parsing errors found`);
- *     errors.forEach(error => {
- *       console.error(`Error at ${error.location}: ${error.error.message}`);
- *     });
- *   }
- *
- *   if (warnings.length > 0) {
- *     console.warn(`${warnings.length} parsing warnings found`);
- *     warnings.forEach(warning => {
- *       console.warn(`Warning at ${warning.location}: ${warning.message}`);
- *     });
- *   }
- * } catch (error) {
- *   console.error('Critical parsing failure:', error);
- * }
- * ```
- *
- * @example Integration with CoreContext
- * ```typescript
- * // Typically used within CoreContext.parse()
- * class CustomCoreContext extends CoreContext {
- *   parseWithCustomValidation(document: OpenAPIV3.Document) {
- *     const parseContext = new ParseContext({
- *       documentObject: document,
- *       logger: this.logger,
- *       stackTrail: this.stackTrail,
- *       silent: this.silent
- *     });
- *
- *     const parsed = parseContext.parse();
- *
- *     // Custom post-processing based on issues
- *     const criticalErrors = parseContext.issues.filter(issue =>
- *       issue.level === 'error' && issue.type === 'schema-validation'
- *     );
- *
- *     if (criticalErrors.length > 0) {
- *       throw new Error(`Schema validation failed: ${criticalErrors.length} critical errors`);
- *     }
- *
- *     return parsed;
- *   }
- * }
- * ```
- */
 class ParseContext {
     /**
      * Creates a new ParseContext instance for the parsing phase.
@@ -276,16 +132,6 @@ class ParseContext {
             refErrors ? refErrors.push(error) : (__classPrivateFieldGet(this, _ParseContext_refErrors, "f")[$ref] = [error]);
         }
     }
-    /**
-     * Executes a function within a traced context for debugging and monitoring.
-     *
-     * @param token - Trace identifier or path segments
-     * @param fn - Function to execute within the trace context
-     * @returns The result of the traced function execution
-     */
-    trace(token, fn) {
-        return (0, tracer_js_1.tracer)(this.stackTrail, token, fn, this.logger);
-    }
     /**
      * Logs warnings for fields that were skipped during parsing.
      *
@@ -302,32 +148,23 @@ class ParseContext {
             });
         });
     }
-    /**
-     * Attempts to parse a value with optional error handling and logging.
-     *
-     * @param args - Parsing arguments including schema and error handling
-     * @returns Parsed value or undefined if parsing fails
-     */
-    provisionalParse({ key, value, parent, schema, toMessage, type }) {
-        const parsed = v.safeParse(v.optional(schema), value);
-        if (parsed.success) {
-            return parsed.output;
-        }
-        this.logIssue({
-            key,
-            parent,
-            level: 'warning',
-            message: toMessage(value),
-            type
-        });
-    }
+    // /**
+    //  * Executes a function within a traced context for debugging and monitoring.
+    //  *
+    //  * @param token - Trace identifier or path segments
+    //  * @param fn - Function to execute within the trace context
+    //  * @returns The result of the traced function execution
+    //  */
+    // trace<T>(token: string, fn: () => T): T {
+    //   return tracer(this.stackTrail, token, fn, this.logger)
+    // }
     /**
      * Logs a parsing issue with associated key context.
      *
      * @param args - Issue arguments including key, parent object, and issue details
      */
     logIssue({ key, parent, type, ...issue }) {
-        this.trace(key, () => this.logIssueNoKey({ parent, type, ...issue }));
+        (0, tracer_js_1.tracer)(this.stackTrail, key, () => this.logIssueNoKey({ parent, type, ...issue }));
     }
     /**
      * Logs a parsing issue without specific key context.
@@ -356,20 +193,3 @@ class ParseContext {
 }
 exports.ParseContext = ParseContext;
 _ParseContext_refStackTrails = new WeakMap(), _ParseContext_refErrors = new WeakMap();
-/**
- * Parses an OpenAPI v3 schema from string format (JSON or YAML).
- *
- * Automatically detects the format based on content and parses accordingly.
- *
- * @param schema - Schema string in JSON or YAML format
- * @returns Parsed OpenAPI v3 document object
- */
-const parseSchema = (schema) => {
-    if (schema.trimStart().startsWith('{')) {
-        return JSON.parse(schema);
-    }
-    else {
-        return (0, parse_js_1.parse)(schema);
-    }
-};
-exports.parseSchema = parseSchema;

package/script/context/RenderContext.d.ts

@@ -47,7 +47,6 @@ type ConstructorArgs = {
  * - **Path Resolution**: Intelligent path resolution with base path support
  * - **Content Collation**: Combines all generated content into organized file structures
  * - **Metadata Generation**: Tracks file statistics (lines, characters) and relationships
- * - **Error Tracking**: Comprehensive error handling with Sentry integration
  * - **Performance Monitoring**: Built-in tracing and performance measurement
  *
  * @example Basic rendering usage
@@ -204,7 +203,6 @@ type ConstructorArgs = {
  *
  * } catch (error) {
  *   console.error('Render operation failed:', error);
- *   // Sentry automatically captures the error
  * }
  * ```
  */
@@ -239,9 +237,6 @@ export declare class RenderContext {
      * formatting (if configured), resolves paths, and produces the final
      * artifacts ready for writing to the filesystem.
      *
-     * The method is wrapped in Sentry tracing spans for performance monitoring
-     * and includes both collation and artifact preparation phases.
-     *
      * @returns Promise resolving to render result containing artifacts, file metadata, previews, and mappings
      *
      * @example
@@ -318,7 +313,7 @@ export declare class RenderContext {
      * });
      * ```
      */
-    trace<T>(token: string | string[], fn: () => T): T;
+    trace<T>(token: string, fn: () => T): T;
     /**
      * Retrieves a file from the context by its normalized path.
      *

package/script/context/RenderContext.d.ts.map

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

package/script/context/RenderContext.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -49,7 +16,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 var _RenderContext_prettierConfig, _RenderContext_stackTrail;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RenderContext = void 0;
-const Sentry = __importStar(require("@sentry/node"));
 const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
 const normalize_js_1 = require("../deps/jsr.io/@std/path/1.1.2/normalize.js");
 const toResolvedArtifactPath_js_1 = require("../helpers/toResolvedArtifactPath.js");
@@ -72,7 +38,6 @@ const File_js_1 = require("../dsl/File.js");
  * - **Path Resolution**: Intelligent path resolution with base path support
  * - **Content Collation**: Combines all generated content into organized file structures
  * - **Metadata Generation**: Tracks file statistics (lines, characters) and relationships
- * - **Error Tracking**: Comprehensive error handling with Sentry integration
  * - **Performance Monitoring**: Built-in tracing and performance measurement
  *
  * @example Basic rendering usage
@@ -229,7 +194,6 @@ const File_js_1 = require("../dsl/File.js");
  *
  * } catch (error) {
  *   console.error('Render operation failed:', error);
- *   // Sentry automatically captures the error
  * }
  * ```
  */
@@ -306,9 +270,6 @@ class RenderContext {
      * formatting (if configured), resolves paths, and produces the final
      * artifacts ready for writing to the filesystem.
      *
-     * The method is wrapped in Sentry tracing spans for performance monitoring
-     * and includes both collation and artifact preparation phases.
-     *
      * @returns Promise resolving to render result containing artifacts, file metadata, previews, and mappings
      *
      * @example
@@ -333,18 +294,14 @@ class RenderContext {
      * ```
      */
     render() {
-        return Sentry.startSpan({ name: 'Render artifacts' }, () => {
-            const result = Sentry.startSpan({ name: 'Collate content' }, () => {
-                return this.collate();
-            });
-            const rendered = {
-                artifacts: result.artifacts,
-                files: result.files,
-                previews: this.previews,
-                mappings: this.mappings
-            };
-            return rendered;
-        });
+        const result = this.collate();
+        const rendered = {
+            artifacts: result.artifacts,
+            files: result.files,
+            previews: this.previews,
+            mappings: this.mappings
+        };
+        return rendered;
     }
     /**
      * Collates all files in the context into a unified render result.
@@ -428,7 +385,7 @@ class RenderContext {
      * ```
      */
     trace(token, fn) {
-        return (0, tracer_js_1.tracer)(__classPrivateFieldGet(this, _RenderContext_stackTrail, "f"), token, fn, this.logger);
+        return (0, tracer_js_1.tracer)(__classPrivateFieldGet(this, _RenderContext_stackTrail, "f"), token, fn);
     }
     /**
      * Retrieves a file from the context by its normalized path.