@greyworld/code-check-core 1.0.0

package/dist/facade/code-checker.d.ts

@@ -0,0 +1,14 @@
+import { Workflow } from "../workflow/workflow";
+import { CodeCheckerConfig, CheckOptions, CheckReport, WorkflowInfo } from "./types";
+export declare class CodeChecker {
+    private workflows;
+    private config;
+    private initialized;
+    constructor(config?: CodeCheckerConfig);
+    initialize(): Promise<void>;
+    registerWorkflow(workflow: Workflow): void;
+    listWorkflows(): WorkflowInfo[];
+    check(options: CheckOptions): Promise<CheckReport>;
+    private ensureInitialized;
+}
+//# sourceMappingURL=code-checker.d.ts.map

package/dist/facade/code-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-checker.d.ts","sourceRoot":"","sources":["../../src/facade/code-checker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,iBAAsB;IAI7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAO1C,aAAa,IAAI,YAAY,EAAE;IAWzB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB/D,OAAO,CAAC,iBAAiB;CAO1B"}

package/dist/facade/code-checker.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeChecker = void 0;
+const resource_check_workflow_1 = require("../workflow/implement/resource-check/resource-check-workflow");
+class CodeChecker {
+    constructor(config = {}) {
+        this.workflows = new Map();
+        this.initialized = false;
+        this.config = config;
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.config.llm) {
+            if (this.config.llm.apiKey) {
+                process.env.DASHSCOPE_API_KEY = this.config.llm.apiKey;
+            }
+            if (this.config.llm.baseUrl) {
+                process.env.DASHSCOPE_BASE_URL = this.config.llm.baseUrl;
+            }
+            if (this.config.llm.model) {
+                process.env.QWEN_MODEL = this.config.llm.model;
+            }
+        }
+        // Register built-in workflows (public behavior, internal implementation).
+        this.registerWorkflow(new resource_check_workflow_1.ResourceCheckWorkflow());
+        this.initialized = true;
+    }
+    // ── Workflow management ──
+    registerWorkflow(workflow) {
+        if (this.workflows.has(workflow.id)) {
+            throw new Error(`Workflow "${workflow.id}" is already registered`);
+        }
+        this.workflows.set(workflow.id, workflow);
+    }
+    listWorkflows() {
+        return Array.from(this.workflows.values()).map((wf) => ({
+            id: wf.id,
+            description: wf.description,
+            ruleCount: wf.getRules().length,
+            ruleNames: wf.getRules().map((r) => r.name),
+        }));
+    }
+    // ── Check ──
+    async check(options) {
+        this.ensureInitialized();
+        const { code, workflowId } = options;
+        const workflow = this.workflows.get(workflowId);
+        if (!workflow) {
+            throw new Error(`Workflow "${workflowId}" not found. ` +
+                `Available: ${Array.from(this.workflows.keys()).join(", ")}`);
+        }
+        const results = await workflow.run(code);
+        return { workflowId, results };
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error("CodeChecker is not initialized. Call initialize() first.");
+        }
+    }
+}
+exports.CodeChecker = CodeChecker;
+//# sourceMappingURL=code-checker.js.map

package/dist/facade/code-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-checker.js","sourceRoot":"","sources":["../../src/facade/code-checker.ts"],"names":[],"mappings":"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"}

package/dist/facade/index.d.ts

@@ -0,0 +1,3 @@
+export { CodeChecker } from "./code-checker";
+export type { CodeCheckerConfig, LlmConfig, CheckOptions, CheckReport, WorkflowInfo, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/facade/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/facade/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/facade/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeChecker = void 0;
+var code_checker_1 = require("./code-checker");
+Object.defineProperty(exports, "CodeChecker", { enumerable: true, get: function () { return code_checker_1.CodeChecker; } });
+//# sourceMappingURL=index.js.map

package/dist/facade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/facade/index.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAApC,2GAAA,WAAW,OAAA"}

package/dist/facade/types.d.ts

@@ -0,0 +1,24 @@
+import type { RuleResult } from "../workflow/workflow";
+export interface LlmConfig {
+    apiKey?: string;
+    model?: string;
+    baseUrl?: string;
+}
+export interface CodeCheckerConfig {
+    llm?: LlmConfig;
+}
+export interface CheckOptions {
+    code: string;
+    workflowId: string;
+}
+export interface CheckReport {
+    workflowId: string;
+    results: RuleResult[];
+}
+export interface WorkflowInfo {
+    id: string;
+    description: string;
+    ruleCount: number;
+    ruleNames: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/facade/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/facade/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/facade/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/facade/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/facade/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { CodeChecker } from "./facade";
+export type { CodeCheckerConfig, LlmConfig, CheckOptions, CheckReport, WorkflowInfo, } from "./facade";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,YAAY,EACR,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,GACf,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeChecker = void 0;
+// ── Facade (public API) ──
+var facade_1 = require("./facade");
+Object.defineProperty(exports, "CodeChecker", { enumerable: true, get: function () { return facade_1.CodeChecker; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAA4B;AAC5B,mCAAuC;AAA9B,qGAAA,WAAW,OAAA"}

package/dist/tools/ast-parser/go/index.d.ts

@@ -0,0 +1,3 @@
+export { GoParser } from "./parser";
+export type { SyntaxNode, Tree, QueryMatch, QueryCapture } from "./parser";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/ast-parser/go/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/ast-parser/go/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/tools/ast-parser/go/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoParser = void 0;
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "GoParser", { enumerable: true, get: function () { return parser_1.GoParser; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/ast-parser/go/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/ast-parser/go/index.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAA3B,kGAAA,QAAQ,OAAA"}

package/dist/tools/ast-parser/go/parser.d.ts

@@ -0,0 +1,56 @@
+import { Language, Query, Node as TreeSitterNode, Tree } from "web-tree-sitter";
+import type { QueryMatch, QueryCapture } from "web-tree-sitter";
+type SyntaxNode = TreeSitterNode;
+/**
+ * GoParser wraps web-tree-sitter to parse Go source code into a full AST.
+ *
+ * Because WASM loading is async, instances must be created via the static
+ * factory method {@link GoParser.create}.
+ *
+ * @example
+ * ```typescript
+ * const parser = await GoParser.create();
+ * const tree = parser.parse(goSource);
+ * const root = tree.rootNode;
+ * ```
+ */
+export declare class GoParser {
+    private parser;
+    private language;
+    private constructor();
+    /**
+     * Create a new GoParser instance.
+     * Loads the WASM runtime and Go grammar on first call;
+     * subsequent calls reuse the cached language.
+     */
+    static create(): Promise<GoParser>;
+    /**
+     * Parse Go source code into a tree-sitter Tree.
+     */
+    parse(source: string): Tree;
+    /**
+     * Run a tree-sitter S-expression query against a syntax node.
+     *
+     * @returns All matches for the query patterns.
+     */
+    query(node: SyntaxNode, pattern: string): QueryMatch[];
+    /**
+     * Run a tree-sitter S-expression query and return flat captures.
+     */
+    captures(node: SyntaxNode, pattern: string): QueryCapture[];
+    /**
+     * Find all descendant nodes of a given type.
+     */
+    findByType(node: SyntaxNode, type: string): SyntaxNode[];
+    /**
+     * Depth-first walk over the subtree rooted at `node`.
+     */
+    walk(node: SyntaxNode, visitor: (n: SyntaxNode) => void): void;
+    /**
+     * Clean up the underlying parser resources.
+     * Call this when the parser is no longer needed.
+     */
+    dispose(): void;
+}
+export type { SyntaxNode, Tree, Language, Query, QueryMatch, QueryCapture };
+//# sourceMappingURL=parser.d.ts.map

package/dist/tools/ast-parser/go/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/tools/ast-parser/go/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,QAAQ,EACR,KAAK,EACL,IAAI,IAAI,cAAc,EACtB,IAAI,EACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGhE,KAAK,UAAU,GAAG,cAAc,CAAC;AAyBjC;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAW;IAE3B,OAAO;IAKP;;;;OAIG;WACiB,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC;IAO/C;;OAEG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQlC;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAS7D;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IASlE;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE;IAM/D;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAUrE;;;OAGG;IACI,OAAO,IAAI,IAAI;CAGzB;AAED,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC"}

package/dist/tools/ast-parser/go/parser.js

@@ -0,0 +1,147 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoParser = void 0;
+const web_tree_sitter_1 = require("web-tree-sitter");
+const path = __importStar(require("path"));
+let cachedLanguage = null;
+let initPromise = null;
+async function ensureParserInit() {
+    if (initPromise)
+        return initPromise;
+    initPromise = web_tree_sitter_1.Parser.init();
+    return initPromise;
+}
+async function loadGoLanguage() {
+    if (cachedLanguage)
+        return cachedLanguage;
+    await ensureParserInit();
+    const wasmPath = path.join(path.dirname(require.resolve("tree-sitter-wasms/package.json")), "out", "tree-sitter-go.wasm");
+    cachedLanguage = await web_tree_sitter_1.Language.load(wasmPath);
+    return cachedLanguage;
+}
+/**
+ * GoParser wraps web-tree-sitter to parse Go source code into a full AST.
+ *
+ * Because WASM loading is async, instances must be created via the static
+ * factory method {@link GoParser.create}.
+ *
+ * @example
+ * ```typescript
+ * const parser = await GoParser.create();
+ * const tree = parser.parse(goSource);
+ * const root = tree.rootNode;
+ * ```
+ */
+class GoParser {
+    constructor(parser, language) {
+        this.parser = parser;
+        this.language = language;
+    }
+    /**
+     * Create a new GoParser instance.
+     * Loads the WASM runtime and Go grammar on first call;
+     * subsequent calls reuse the cached language.
+     */
+    static async create() {
+        const language = await loadGoLanguage();
+        const parser = new web_tree_sitter_1.Parser();
+        parser.setLanguage(language);
+        return new GoParser(parser, language);
+    }
+    /**
+     * Parse Go source code into a tree-sitter Tree.
+     */
+    parse(source) {
+        const tree = this.parser.parse(source);
+        if (!tree) {
+            throw new Error("Failed to parse Go source");
+        }
+        return tree;
+    }
+    /**
+     * Run a tree-sitter S-expression query against a syntax node.
+     *
+     * @returns All matches for the query patterns.
+     */
+    query(node, pattern) {
+        const q = new web_tree_sitter_1.Query(this.language, pattern);
+        try {
+            return q.matches(node);
+        }
+        finally {
+            q.delete();
+        }
+    }
+    /**
+     * Run a tree-sitter S-expression query and return flat captures.
+     */
+    captures(node, pattern) {
+        const q = new web_tree_sitter_1.Query(this.language, pattern);
+        try {
+            return q.captures(node);
+        }
+        finally {
+            q.delete();
+        }
+    }
+    /**
+     * Find all descendant nodes of a given type.
+     */
+    findByType(node, type) {
+        return node.descendantsOfType(type).filter((n) => n !== null);
+    }
+    /**
+     * Depth-first walk over the subtree rooted at `node`.
+     */
+    walk(node, visitor) {
+        visitor(node);
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child) {
+                this.walk(child, visitor);
+            }
+        }
+    }
+    /**
+     * Clean up the underlying parser resources.
+     * Call this when the parser is no longer needed.
+     */
+    dispose() {
+        this.parser.delete();
+    }
+}
+exports.GoParser = GoParser;
+//# sourceMappingURL=parser.js.map

package/dist/tools/ast-parser/go/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/tools/ast-parser/go/parser.ts"],"names":[],"mappings":"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"}

package/dist/tools/ast-parser/go/schema-extractor.d.ts

@@ -0,0 +1,103 @@
+import { GoParser } from "./parser";
+import type { ResourceSchema } from "./types";
+/**
+ * Extracts Terraform resource schemas from Go source files.
+ *
+ * Targets the common Terraform Plugin SDK pattern:
+ * ```go
+ * func resourceXxx() *schema.Resource {
+ *     return &schema.Resource{
+ *         Schema: map[string]*schema.Schema{
+ *             "field": { Type: schema.TypeString, ... },
+ *         },
+ *     }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const parser = await GoParser.create();
+ * const extractor = new TerraformSchemaExtractor(parser);
+ * const schemas = extractor.extract(goSourceCode);
+ * ```
+ */
+export declare class TerraformSchemaExtractor {
+    private parser;
+    private currentRoot;
+    constructor(parser: GoParser);
+    /**
+     * Extract all resource schemas from a Go source string.
+     */
+    extract(goSource: string): ResourceSchema[];
+    private extractFromFunction;
+    /**
+     * Locate the returned `&schema.Resource{ ... }` composite literal
+     * in a function body.
+     */
+    private findResourceLiteral;
+    /**
+     * Locate the `Schema: map[string]*schema.Schema{ ... }` value from
+     * a resource composite literal.
+     */
+    private findSchemaMap;
+    private isResourceCompositeLiteral;
+    /**
+     * Find a top-level keyed value from a composite literal body by key.
+     */
+    private findTopLevelValueByKey;
+    /**
+     * Check if a node is a composite_literal of type
+     * `map[string]*schema.Schema{ ... }`.
+     */
+    private isSchemaMapLiteral;
+    /**
+     * Extract all schema fields from a map literal
+     * `map[string]*schema.Schema{ ... }`.
+     */
+    private extractFieldsFromMap;
+    /**
+     * Parse a single schema field from a keyed_element like:
+     * `"field_name": { Type: schema.TypeString, Required: true, ... }`
+     *
+     * keyed_element -> literal_element(key) + literal_element(value)
+     *   key unwraps to: interpreted_string_literal
+     *   value unwraps to: literal_value (shorthand for the struct literal)
+     */
+    private parseSchemaField;
+    /**
+     * Parse the properties (Type, Required, Optional, etc.) from
+     * a literal_value or composite_literal node containing the field's
+     * key-value pairs.
+     */
+    private parseFieldProperties;
+    /**
+     * Parse the `Elem` property which can be:
+     * - `&schema.Schema{ Type: schema.TypeString }` (simple element type)
+     * - `&schema.Resource{ Schema: map[string]*schema.Schema{ ... } }` (nested block)
+     * - `someSchemaFunc()` (function call returning *schema.Resource)
+     */
+    private parseElem;
+    /**
+     * Resolve an `Elem: someFunc()` call expression by locating the
+     * function definition in the same file and extracting its returned
+     * schema fields.
+     */
+    private resolveSchemaFuncCall;
+    private extractResourceOptions;
+    private extractImporterStateContext;
+    private extractTimeouts;
+    /**
+     * Extract the content of a Go interpreted string literal,
+     * stripping the surrounding double quotes.
+     */
+    private extractStringLiteral;
+    /**
+     * Infer a Terraform resource name from a Go function name.
+     *
+     * `resourceAwsInstance`     -> `aws_instance`
+     * `dataSourceAwsAmi`       -> `aws_ami`
+     * `ResourceAwsVpcSubnet`   -> `aws_vpc_subnet`
+     */
+    private inferResourceName;
+}
+//# sourceMappingURL=schema-extractor.d.ts.map

package/dist/tools/ast-parser/go/schema-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extractor.d.ts","sourceRoot":"","sources":["../../../../src/tools/ast-parser/go/schema-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,KAAK,EAER,cAAc,EAIjB,MAAM,SAAS,CAAC;AAgCjB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,wBAAwB;IAGrB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,WAAW,CAA2B;gBAE1B,MAAM,EAAE,QAAQ;IAEpC;;OAEG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAsBlD,OAAO,CAAC,mBAAmB;IAyB3B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,0BAA0B;IAOlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IA6D5B;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IA4CjB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,sBAAsB;IAmC9B,OAAO,CAAC,2BAA2B;IAyBnC,OAAO,CAAC,eAAe;IA0CvB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;CAkB5B"}