@signstack/cli 0.1.1

package/dist/libs/signstack/base/src/lib/validation/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getResourceSchemaValidator = exports.validateResourceTree = exports.parseYamlsToDocuments = exports.parseYamlToDocument = exports.validateTemplateInputs = exports.validateDependencies = exports.extractReferences = exports.DependencyGraph = exports.SchemaValidator = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./schema-validation.types"), exports);
+var schema_validator_1 = require("./schema-validator");
+Object.defineProperty(exports, "SchemaValidator", { enumerable: true, get: function () { return schema_validator_1.SchemaValidator; } });
+tslib_1.__exportStar(require("./graph.types"), exports);
+var dependency_graph_1 = require("./dependency-graph");
+Object.defineProperty(exports, "DependencyGraph", { enumerable: true, get: function () { return dependency_graph_1.DependencyGraph; } });
+Object.defineProperty(exports, "extractReferences", { enumerable: true, get: function () { return dependency_graph_1.extractReferences; } });
+var validate_dependencies_1 = require("./validate-dependencies");
+Object.defineProperty(exports, "validateDependencies", { enumerable: true, get: function () { return validate_dependencies_1.validateDependencies; } });
+var validate_template_inputs_1 = require("./validate-template-inputs");
+Object.defineProperty(exports, "validateTemplateInputs", { enumerable: true, get: function () { return validate_template_inputs_1.validateTemplateInputs; } });
+var yaml_document_utils_1 = require("./yaml-document-utils");
+Object.defineProperty(exports, "parseYamlToDocument", { enumerable: true, get: function () { return yaml_document_utils_1.parseYamlToDocument; } });
+Object.defineProperty(exports, "parseYamlsToDocuments", { enumerable: true, get: function () { return yaml_document_utils_1.parseYamlsToDocuments; } });
+var validate_resource_tree_1 = require("./validate-resource-tree");
+Object.defineProperty(exports, "validateResourceTree", { enumerable: true, get: function () { return validate_resource_tree_1.validateResourceTree; } });
+var resource_schemas_1 = require("./resource-schemas");
+Object.defineProperty(exports, "getResourceSchemaValidator", { enumerable: true, get: function () { return resource_schemas_1.getResourceSchemaValidator; } });
+//# sourceMappingURL=index.js.map

package/dist/libs/signstack/base/src/lib/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/validation/index.ts"],"names":[],"mappings":";;;;AAAA,oEAA0C;AAC1C,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,wDAA8B;AAC9B,uDAAwE;AAA/D,mHAAA,eAAe,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAC3C,iEAIiC;AAH/B,6HAAA,oBAAoB,OAAA;AAItB,uEAIoC;AAHlC,kIAAA,sBAAsB,OAAA;AAIxB,6DAAmF;AAA1E,0HAAA,mBAAmB,OAAA;AAAE,4HAAA,qBAAqB,OAAA;AACnD,mEAKkC;AAJhC,8HAAA,oBAAoB,OAAA;AAKtB,uDAAgE;AAAvD,8HAAA,0BAA0B,OAAA"}

package/dist/libs/signstack/base/src/lib/validation/resource-schemas.d.ts

@@ -0,0 +1,3 @@
+import { SchemaValidator } from './schema-validator';
+/** Get a shared SchemaValidator pre-loaded with all resource schemas. */
+export declare function getResourceSchemaValidator(): SchemaValidator;

package/dist/libs/signstack/base/src/lib/validation/resource-schemas.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getResourceSchemaValidator = getResourceSchemaValidator;
+const tslib_1 = require("tslib");
+const schema_validation_types_1 = require("./schema-validation.types");
+const schema_validator_1 = require("./schema-validator");
+const blueprint_schema_json_1 = tslib_1.__importDefault(require("../../../schemas/blueprint.schema.json"));
+const template_schema_json_1 = tslib_1.__importDefault(require("../../../schemas/template.schema.json"));
+const schema_schema_json_1 = tslib_1.__importDefault(require("../../../schemas/schema.schema.json"));
+const asset_schema_json_1 = tslib_1.__importDefault(require("../../../schemas/asset.schema.json"));
+const jsonata_function_schema_json_1 = tslib_1.__importDefault(require("../../../schemas/jsonata-function.schema.json"));
+const SCHEMAS = new Map([
+    [schema_validation_types_1.SchemaKind.Blueprint, blueprint_schema_json_1.default],
+    [schema_validation_types_1.SchemaKind.Template, template_schema_json_1.default],
+    [schema_validation_types_1.SchemaKind.Schema, schema_schema_json_1.default],
+    [schema_validation_types_1.SchemaKind.Asset, asset_schema_json_1.default],
+    [schema_validation_types_1.SchemaKind.JsonataFunction, jsonata_function_schema_json_1.default],
+]);
+let _validator = null;
+/** Get a shared SchemaValidator pre-loaded with all resource schemas. */
+function getResourceSchemaValidator() {
+    if (!_validator) {
+        _validator = new schema_validator_1.SchemaValidator(SCHEMAS);
+    }
+    return _validator;
+}
+//# sourceMappingURL=resource-schemas.js.map

package/dist/libs/signstack/base/src/lib/validation/resource-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-schemas.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/validation/resource-schemas.ts"],"names":[],"mappings":";;AAoBA,gEAKC;;AAzBD,uEAAuD;AACvD,yDAAqD;AAErD,2GAAqE;AACrE,yGAAmE;AACnE,qGAA+D;AAC/D,mGAA6D;AAC7D,yHAAkF;AAElF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAqB;IAC1C,CAAC,oCAAU,CAAC,SAAS,EAAE,+BAAe,CAAC;IACvC,CAAC,oCAAU,CAAC,QAAQ,EAAE,8BAAc,CAAC;IACrC,CAAC,oCAAU,CAAC,MAAM,EAAE,4BAAY,CAAC;IACjC,CAAC,oCAAU,CAAC,KAAK,EAAE,2BAAW,CAAC;IAC/B,CAAC,oCAAU,CAAC,eAAe,EAAE,sCAAqB,CAAC;CACpD,CAAC,CAAC;AAEH,IAAI,UAAU,GAA2B,IAAI,CAAC;AAE9C,yEAAyE;AACzE,SAAgB,0BAA0B;IACxC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,IAAI,kCAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/libs/signstack/base/src/lib/validation/schema-validation.types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared SignStack YAML validation types.
+ * Used by both the CLI and the backend API for schema validation.
+ */
+/** Resource kinds that have corresponding JSON schemas */
+export declare enum SchemaKind {
+    Blueprint = "Blueprint",
+    Template = "Template",
+    Schema = "Schema",
+    Asset = "Asset",
+    JsonataFunction = "JsonataFunction"
+}
+/** Maps each SchemaKind to its JSON schema filename */
+export declare const SCHEMA_FILE_MAP: Record<SchemaKind, string>;
+/** Check if a string is a valid SchemaKind */
+export declare function isSchemaKind(kind: string): kind is SchemaKind;
+/** Get all available SchemaKind values */
+export declare function getAvailableSchemaKinds(): SchemaKind[];
+/** Categories of validation errors */
+export declare enum ValidationErrorKeyword {
+    KindDetection = "kind-detection",
+    SchemaLoad = "schema-load",
+    FileRead = "file-read",
+    YamlParse = "yaml-parse",
+    EmptyFile = "empty-file",
+    Type = "type",
+    DependencyMissing = "dependency-missing",
+    CircularDependency = "circular-dependency",
+    FileReferenceMissing = "file-reference-missing",
+    DraftDependency = "draft-dependency",
+    Enum = "enum",
+    AdditionalProperties = "additionalProperties",
+    Pattern = "pattern",
+    PropertyNames = "propertyNames",
+    Required = "required"
+}
+/** A single validation error */
+export interface ValidationError {
+    path: string;
+    message: string;
+    keyword: string;
+    params?: Record<string, unknown>;
+}
+/** Result of validating a single resource */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    schemaKind: SchemaKind | 'unknown';
+    /** File path — set by CLI, empty string for backend usage */
+    filePath: string;
+    /** Document index for multi-document YAML files */
+    documentIndex?: number;
+    /** Resource metadata.key for display */
+    resourceKey?: string;
+    /** Resource metadata.version for display */
+    resourceVersion?: string;
+}

package/dist/libs/signstack/base/src/lib/validation/schema-validation.types.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Shared SignStack YAML validation types.
+ * Used by both the CLI and the backend API for schema validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationErrorKeyword = exports.SCHEMA_FILE_MAP = exports.SchemaKind = void 0;
+exports.isSchemaKind = isSchemaKind;
+exports.getAvailableSchemaKinds = getAvailableSchemaKinds;
+/** Resource kinds that have corresponding JSON schemas */
+var SchemaKind;
+(function (SchemaKind) {
+    SchemaKind["Blueprint"] = "Blueprint";
+    SchemaKind["Template"] = "Template";
+    SchemaKind["Schema"] = "Schema";
+    SchemaKind["Asset"] = "Asset";
+    SchemaKind["JsonataFunction"] = "JsonataFunction";
+})(SchemaKind || (exports.SchemaKind = SchemaKind = {}));
+/** Maps each SchemaKind to its JSON schema filename */
+exports.SCHEMA_FILE_MAP = {
+    [SchemaKind.Blueprint]: 'blueprint.schema.json',
+    [SchemaKind.Template]: 'template.schema.json',
+    [SchemaKind.Schema]: 'schema.schema.json',
+    [SchemaKind.Asset]: 'asset.schema.json',
+    [SchemaKind.JsonataFunction]: 'jsonata-function.schema.json',
+};
+/** Check if a string is a valid SchemaKind */
+function isSchemaKind(kind) {
+    return Object.values(SchemaKind).includes(kind);
+}
+/** Get all available SchemaKind values */
+function getAvailableSchemaKinds() {
+    return Object.values(SchemaKind);
+}
+/** Categories of validation errors */
+var ValidationErrorKeyword;
+(function (ValidationErrorKeyword) {
+    // Custom SignStack keywords
+    ValidationErrorKeyword["KindDetection"] = "kind-detection";
+    ValidationErrorKeyword["SchemaLoad"] = "schema-load";
+    ValidationErrorKeyword["FileRead"] = "file-read";
+    ValidationErrorKeyword["YamlParse"] = "yaml-parse";
+    ValidationErrorKeyword["EmptyFile"] = "empty-file";
+    ValidationErrorKeyword["Type"] = "type";
+    // Dependency graph validation
+    ValidationErrorKeyword["DependencyMissing"] = "dependency-missing";
+    ValidationErrorKeyword["CircularDependency"] = "circular-dependency";
+    ValidationErrorKeyword["FileReferenceMissing"] = "file-reference-missing";
+    ValidationErrorKeyword["DraftDependency"] = "draft-dependency";
+    // AJV schema validation keywords (used for error message enhancement)
+    ValidationErrorKeyword["Enum"] = "enum";
+    ValidationErrorKeyword["AdditionalProperties"] = "additionalProperties";
+    ValidationErrorKeyword["Pattern"] = "pattern";
+    ValidationErrorKeyword["PropertyNames"] = "propertyNames";
+    ValidationErrorKeyword["Required"] = "required";
+})(ValidationErrorKeyword || (exports.ValidationErrorKeyword = ValidationErrorKeyword = {}));
+//# sourceMappingURL=schema-validation.types.js.map

package/dist/libs/signstack/base/src/lib/validation/schema-validation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.types.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/validation/schema-validation.types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAqBH,oCAEC;AAGD,0DAEC;AA1BD,0DAA0D;AAC1D,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,qCAAuB,CAAA;IACvB,mCAAqB,CAAA;IACrB,+BAAiB,CAAA;IACjB,6BAAe,CAAA;IACf,iDAAmC,CAAA;AACrC,CAAC,EANW,UAAU,0BAAV,UAAU,QAMrB;AAED,uDAAuD;AAC1C,QAAA,eAAe,GAA+B;IACzD,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,uBAAuB;IAC/C,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,sBAAsB;IAC7C,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,oBAAoB;IACzC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,mBAAmB;IACvC,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,8BAA8B;CAC7D,CAAC;AAEF,8CAA8C;AAC9C,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAkB,CAAC,CAAC;AAChE,CAAC;AAED,0CAA0C;AAC1C,SAAgB,uBAAuB;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,sCAAsC;AACtC,IAAY,sBAmBX;AAnBD,WAAY,sBAAsB;IAChC,4BAA4B;IAC5B,0DAAgC,CAAA;IAChC,oDAA0B,CAAA;IAC1B,gDAAsB,CAAA;IACtB,kDAAwB,CAAA;IACxB,kDAAwB,CAAA;IACxB,uCAAa,CAAA;IACb,8BAA8B;IAC9B,kEAAwC,CAAA;IACxC,oEAA0C,CAAA;IAC1C,yEAA+C,CAAA;IAC/C,8DAAoC,CAAA;IACpC,sEAAsE;IACtE,uCAAa,CAAA;IACb,uEAA6C,CAAA;IAC7C,6CAAmB,CAAA;IACnB,yDAA+B,CAAA;IAC/B,+CAAqB,CAAA;AACvB,CAAC,EAnBW,sBAAsB,sCAAtB,sBAAsB,QAmBjC"}

package/dist/libs/signstack/base/src/lib/validation/schema-validator.d.ts

@@ -0,0 +1,38 @@
+import { SchemaKind, type ValidationResult } from './schema-validation.types';
+/**
+ * Framework-agnostic schema validator for SignStack YAML resources.
+ * Accepts pre-loaded JSON schema objects and validates parsed content against them.
+ *
+ * File I/O is the caller's responsibility — this class is pure validation logic
+ * with no Node.js built-in dependencies, so it can be used in any environment.
+ *
+ * Used by:
+ * - CLI: loads schema files from disk, passes them here
+ * - Backend: loads schema files from disk, passes them here
+ */
+export declare class SchemaValidator {
+    private readonly ajv;
+    private readonly schemas;
+    constructor(schemas?: Map<SchemaKind, object> | Record<SchemaKind, object>);
+    /**
+     * Register a JSON schema for a given resource kind.
+     * Can be called after construction to lazily add schemas.
+     */
+    addSchema(kind: SchemaKind, schema: object): void;
+    /**
+     * Detect the schema kind from parsed content by reading the 'kind' field.
+     */
+    detectSchemaKind(content: Record<string, unknown>): SchemaKind | null;
+    /**
+     * Validate parsed content against the appropriate JSON schema.
+     *
+     * @param content  Parsed YAML/JSON object to validate
+     * @param filePath File path for error reporting (use '' for non-file contexts)
+     * @param schemaKind Optional override — skips auto-detection
+     * @param documentIndex Optional index for multi-document YAML
+     */
+    validate(content: Record<string, unknown>, filePath?: string, schemaKind?: SchemaKind, documentIndex?: number): ValidationResult;
+    private formatErrors;
+    private formatSingleError;
+    private createErrorResult;
+}

package/dist/libs/signstack/base/src/lib/validation/schema-validator.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaValidator = void 0;
+const tslib_1 = require("tslib");
+const _2020_1 = tslib_1.__importDefault(require("ajv/dist/2020"));
+const ajv_formats_1 = tslib_1.__importDefault(require("ajv-formats"));
+const schema_validation_types_1 = require("./schema-validation.types");
+/** Default error message when validation fails without a specific message */
+const DEFAULT_ERROR_MESSAGE = 'Unknown validation error';
+/** AJV configuration — shared across CLI and backend */
+const AJV_OPTIONS = {
+    allErrors: true,
+    strict: true,
+    strictRequired: false,
+    strictTypes: false,
+    verbose: true,
+};
+/**
+ * Framework-agnostic schema validator for SignStack YAML resources.
+ * Accepts pre-loaded JSON schema objects and validates parsed content against them.
+ *
+ * File I/O is the caller's responsibility — this class is pure validation logic
+ * with no Node.js built-in dependencies, so it can be used in any environment.
+ *
+ * Used by:
+ * - CLI: loads schema files from disk, passes them here
+ * - Backend: loads schema files from disk, passes them here
+ */
+class SchemaValidator {
+    ajv;
+    schemas = new Map();
+    constructor(schemas) {
+        this.ajv = new _2020_1.default(AJV_OPTIONS);
+        (0, ajv_formats_1.default)(this.ajv);
+        if (schemas) {
+            if (schemas instanceof Map) {
+                schemas.forEach((schema, kind) => this.schemas.set(kind, schema));
+            }
+            else {
+                for (const [kind, schema] of Object.entries(schemas)) {
+                    this.schemas.set(kind, schema);
+                }
+            }
+        }
+    }
+    /**
+     * Register a JSON schema for a given resource kind.
+     * Can be called after construction to lazily add schemas.
+     */
+    addSchema(kind, schema) {
+        this.schemas.set(kind, schema);
+    }
+    /**
+     * Detect the schema kind from parsed content by reading the 'kind' field.
+     */
+    detectSchemaKind(content) {
+        const kind = content['kind'];
+        if (typeof kind !== 'string')
+            return null;
+        return (0, schema_validation_types_1.isSchemaKind)(kind) ? kind : null;
+    }
+    /**
+     * Validate parsed content against the appropriate JSON schema.
+     *
+     * @param content  Parsed YAML/JSON object to validate
+     * @param filePath File path for error reporting (use '' for non-file contexts)
+     * @param schemaKind Optional override — skips auto-detection
+     * @param documentIndex Optional index for multi-document YAML
+     */
+    validate(content, filePath = '', schemaKind, documentIndex) {
+        // 1. Detect or use provided schema kind
+        const detectedKind = schemaKind ?? this.detectSchemaKind(content);
+        if (!detectedKind) {
+            const availableKinds = (0, schema_validation_types_1.getAvailableSchemaKinds)().join(', ');
+            return this.createErrorResult(filePath, `Unable to detect schema kind. The 'kind' field is missing or invalid. Available kinds: ${availableKinds}`, schema_validation_types_1.ValidationErrorKeyword.KindDetection, 'unknown', documentIndex);
+        }
+        // 2. Look up the pre-loaded JSON schema
+        const schema = this.schemas.get(detectedKind);
+        if (!schema) {
+            return this.createErrorResult(filePath, `No schema registered for kind '${detectedKind}'. Register it with addSchema() or pass it in the constructor.`, schema_validation_types_1.ValidationErrorKeyword.SchemaLoad, detectedKind, documentIndex);
+        }
+        // 3. Compile and validate
+        const validateFn = this.ajv.compile(schema);
+        const valid = validateFn(content) === true;
+        // 4. Extract metadata for display
+        const metadata = content['metadata'];
+        const resourceKey = metadata?.['key'];
+        const resourceVersion = metadata?.['version'];
+        return {
+            valid,
+            errors: valid ? [] : this.formatErrors(validateFn.errors),
+            schemaKind: detectedKind,
+            filePath,
+            documentIndex,
+            resourceKey,
+            resourceVersion,
+        };
+    }
+    // ─── Private helpers ───────────────────────────────────────────────
+    formatErrors(errors) {
+        if (!errors?.length)
+            return [];
+        return errors.map((error) => this.formatSingleError(error));
+    }
+    formatSingleError(error) {
+        let message = error.message ?? DEFAULT_ERROR_MESSAGE;
+        const params = error.params;
+        // Enhance messages for common AJV validation keywords
+        if (error.keyword === schema_validation_types_1.ValidationErrorKeyword.Enum && params?.['allowedValues']) {
+            const allowed = params['allowedValues']
+                .map((v) => JSON.stringify(v))
+                .join(', ');
+            message = `${message}. Allowed values: ${allowed}`;
+        }
+        else if (error.keyword === schema_validation_types_1.ValidationErrorKeyword.AdditionalProperties && params?.['additionalProperty']) {
+            message = `Unknown property '${params['additionalProperty']}'. ${message}`;
+        }
+        else if (error.keyword === schema_validation_types_1.ValidationErrorKeyword.Pattern && params?.['pattern']) {
+            const value = error.data;
+            const valuePart = value != null ? ` (got '${value}')` : '';
+            message = `${message}${valuePart}. Expected pattern: ${params['pattern']}`;
+        }
+        else if (error.keyword === schema_validation_types_1.ValidationErrorKeyword.PropertyNames && params?.['propertyName']) {
+            const name = params['propertyName'];
+            message = `Invalid property name '${name}' at ${error.instancePath || '/'}. Property names must be snake_case (e.g., my_key)`;
+        }
+        const instancePath = error.instancePath;
+        return {
+            path: instancePath || '/',
+            message,
+            keyword: error.keyword,
+            params,
+        };
+    }
+    createErrorResult(filePath, message, keyword, schemaKind, documentIndex) {
+        return {
+            valid: false,
+            errors: [{ path: '/', message, keyword }],
+            schemaKind,
+            filePath,
+            documentIndex,
+        };
+    }
+}
+exports.SchemaValidator = SchemaValidator;
+//# sourceMappingURL=schema-validator.js.map

package/dist/libs/signstack/base/src/lib/validation/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/validation/schema-validator.ts"],"names":[],"mappings":"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"}

package/dist/libs/signstack/base/src/lib/validation/validate-dependencies.d.ts

@@ -0,0 +1,22 @@
+import { TemplateInputValidationError } from './validate-template-inputs';
+export interface DependencyValidationError {
+    resource: string;
+    dependency: string;
+    message: string;
+}
+export interface DependencyValidationResult {
+    valid: boolean;
+    errors: DependencyValidationError[];
+    templateInputErrors?: TemplateInputValidationError[];
+}
+/**
+ * Validate cross-resource dependencies from a list of YAML strings.
+ *
+ * Parses all YAMLs, builds a dependency graph, and checks for:
+ * - Missing dependencies
+ * - Circular dependencies
+ * - Draft dependency violations (versioned resources depending on drafts)
+ *
+ * When duplicate ResourceIds exist, the last occurrence wins.
+ */
+export declare function validateDependencies(yamls: string[]): DependencyValidationResult;

package/dist/libs/signstack/base/src/lib/validation/validate-dependencies.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDependencies = validateDependencies;
+const dependency_graph_1 = require("./dependency-graph");
+const yaml_document_utils_1 = require("./yaml-document-utils");
+const validate_template_inputs_1 = require("./validate-template-inputs");
+/**
+ * Validate cross-resource dependencies from a list of YAML strings.
+ *
+ * Parses all YAMLs, builds a dependency graph, and checks for:
+ * - Missing dependencies
+ * - Circular dependencies
+ * - Draft dependency violations (versioned resources depending on drafts)
+ *
+ * When duplicate ResourceIds exist, the last occurrence wins.
+ */
+function validateDependencies(yamls) {
+    const errors = [];
+    // Parse and deduplicate by ResourceId (last occurrence wins)
+    const docMap = new Map();
+    for (const yaml of yamls) {
+        const doc = (0, yaml_document_utils_1.parseYamlToDocument)(yaml);
+        if (doc) {
+            docMap.set(doc.id, doc);
+        }
+    }
+    const docs = Array.from(docMap.values());
+    if (docs.length === 0) {
+        return { valid: true, errors: [] };
+    }
+    const graph = dependency_graph_1.DependencyGraph.fromDocuments(docs);
+    // Check for missing dependencies
+    const missing = graph.getMissingDependencies();
+    for (const [resourceId, missingDeps] of missing) {
+        for (const depId of missingDeps) {
+            errors.push({
+                resource: resourceId,
+                dependency: depId,
+                message: `Resource "${resourceId}" references "${depId}" which does not exist in the provided resources.`,
+            });
+        }
+    }
+    // Check for circular dependencies
+    const cycles = graph.detectCycles();
+    for (const cycle of cycles) {
+        errors.push({
+            resource: cycle[0],
+            dependency: cycle[cycle.length - 1],
+            message: `Circular dependency detected: ${cycle.join(' → ')}`,
+        });
+    }
+    // Check for draft dependency violations
+    const draftErrors = graph.validateDraftDependencies();
+    for (const err of draftErrors) {
+        errors.push({
+            resource: err.sourceId,
+            dependency: err.dependencyId,
+            message: err.message,
+        });
+    }
+    // Check for template input validation
+    const templateInputValidation = (0, validate_template_inputs_1.validateTemplateInputs)(yamls);
+    return {
+        valid: errors.length === 0 && templateInputValidation.valid,
+        errors,
+        templateInputErrors: templateInputValidation.errors,
+    };
+}
+//# sourceMappingURL=validate-dependencies.js.map

package/dist/libs/signstack/base/src/lib/validation/validate-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-dependencies.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/validation/validate-dependencies.ts"],"names":[],"mappings":";;AA2BA,oDA8DC;AAxFD,yDAAqD;AACrD,+DAA4D;AAC5D,yEAAkG;AAclG;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAClC,KAAe;IAEf,MAAM,MAAM,GAAgC,EAAE,CAAC;IAE/C,6DAA6D;IAC7D,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAA,yCAAmB,EAAC,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAG,kCAAe,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAElD,iCAAiC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,sBAAsB,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,OAAO,EAAE,CAAC;QAChD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE,KAAK;gBACjB,OAAO,EAAE,aAAa,UAAU,iBAAiB,KAAK,mDAAmD;aAC1G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;YAClB,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACnC,OAAO,EAAE,iCAAiC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,MAAM,WAAW,GAAG,KAAK,CAAC,yBAAyB,EAAE,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,GAAG,CAAC,YAAY;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;IAED,sCAAsC;IACtC,MAAM,uBAAuB,GAAG,IAAA,iDAAsB,EAAC,KAAK,CAAC,CAAC;IAE9D,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,uBAAuB,CAAC,KAAK;QAC3D,MAAM;QACN,mBAAmB,EAAE,uBAAuB,CAAC,MAAM;KACpD,CAAC;AACJ,CAAC"}

package/dist/libs/signstack/base/src/lib/validation/validate-resource-tree.d.ts

@@ -0,0 +1,37 @@
+import { ResourceMetadata } from '../models/base';
+import type { SchemaValidator } from './schema-validator';
+import type { ValidationError } from './schema-validation.types';
+export interface ResourceTreeValidationError {
+    resourceKey: string;
+    resourceKind: string;
+    errors: ValidationError[];
+}
+export interface ResourceTreeValidationResult {
+    valid: boolean;
+    errors: ResourceTreeValidationError[];
+}
+export interface ResourceInput {
+    kind: string;
+    metadata: ResourceMetadata;
+    spec: any;
+}
+/**
+ * Validates all resources in a dependency tree.
+ *
+ * Accepts raw YAML strings and handles parsing internally.
+ *
+ * Validation layers:
+ * 0. YAML parsing & kind resolution
+ * 1. Basic metadata validation
+ * 2. JSON schema validation (per resource, via raw YAML)
+ * 3. Dependency existence (cross-resource)
+ * 4. Cross-resource rules (template content, etc.)
+ *
+ * Collects ALL errors across all resources (no fail-fast).
+ *
+ * @param yamlStrings - Raw YAML strings, one per resource
+ * @param opts.schemaValidator - Optional SchemaValidator for JSON schema checks
+ */
+export declare function validateResourceTree(yamlStrings: string[], opts?: {
+    schemaValidator?: SchemaValidator;
+}): ResourceTreeValidationResult;