@signstack/cli 0.1.1

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

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateResourceTree = validateResourceTree;
+const base_1 = require("../models/base");
+const resource_edge_1 = require("../models/resource-edge");
+const template_1 = require("../models/template");
+const util_1 = require("../util");
+const yaml_1 = require("yaml");
+const yaml_spec_converter_1 = require("../yaml-spec-converter");
+// ── YAML Parsing ──
+function parseYamlToResource(yaml, index) {
+    let content;
+    try {
+        content = (0, yaml_1.parse)(yaml);
+    }
+    catch (e) {
+        return {
+            error: {
+                resourceKey: `yaml[${index}]`,
+                resourceKind: 'unknown',
+                errors: [{ path: '/', message: `YAML parse error: ${e.message}`, keyword: 'yaml-parse' }],
+            },
+        };
+    }
+    if (!content || typeof content !== 'object') {
+        return {
+            error: {
+                resourceKey: `yaml[${index}]`,
+                resourceKind: 'unknown',
+                errors: [{ path: '/', message: 'YAML content is not an object', keyword: 'yaml-parse' }],
+            },
+        };
+    }
+    const rawKind = typeof content['kind'] === 'string' ? content['kind'] : '';
+    const kind = (0, yaml_spec_converter_1.displayNameToResourceKind)(rawKind);
+    if (!kind) {
+        return {
+            error: {
+                resourceKey: `yaml[${index}]`,
+                resourceKind: rawKind || 'unknown',
+                errors: [{ path: '/kind', message: `Unknown resource kind: ${rawKind}`, keyword: 'yaml-parse' }],
+            },
+        };
+    }
+    const rawMeta = (content['metadata'] ?? {});
+    const spec = (content['spec'] ?? {});
+    return {
+        resource: {
+            kind,
+            metadata: {
+                key: rawMeta['key'] ?? '',
+                version: rawMeta['version'] ?? '',
+                name: rawMeta['name'] ?? '',
+                description: rawMeta['description'],
+                labels: rawMeta['labels'],
+            },
+            spec: (0, yaml_spec_converter_1.convertYamlSpec)(kind, spec),
+        },
+    };
+}
+// ── Main function ──
+/**
+ * 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
+ */
+function validateResourceTree(yamlStrings, opts) {
+    const allErrors = [];
+    const schemaValidator = opts?.schemaValidator;
+    // Layer 0: Parse all YAML strings into ResourceInput objects
+    const resources = [];
+    const rawYamls = [];
+    for (let i = 0; i < yamlStrings.length; i++) {
+        const parsed = parseYamlToResource(yamlStrings[i], i);
+        if ('error' in parsed) {
+            allErrors.push(parsed.error);
+            continue;
+        }
+        resources.push(parsed.resource);
+        rawYamls.push(yamlStrings[i]);
+    }
+    // Build a lookup set of resource IDs for dependency existence checks
+    const resourceIdSet = new Set();
+    for (const res of resources) {
+        resourceIdSet.add((0, resource_edge_1.toResourceId)(res.kind, res.metadata.key, res.metadata.version));
+    }
+    // Build a lookup map for cross-resource checks
+    const resourceMap = new Map();
+    for (const res of resources) {
+        const id = (0, resource_edge_1.toResourceId)(res.kind, res.metadata.key, res.metadata.version);
+        resourceMap.set(id, res);
+    }
+    for (let i = 0; i < resources.length; i++) {
+        const res = resources[i];
+        const errors = [];
+        // Layer 1: Basic metadata validation
+        if (!res.metadata?.key?.trim()) {
+            errors.push({
+                path: 'metadata.key',
+                message: 'Resource key is required',
+                keyword: 'required',
+            });
+        }
+        if (!res.metadata?.name?.trim() &&
+            (res.kind === resource_edge_1.ResourceKind.Blueprint || res.kind === resource_edge_1.ResourceKind.Schema)) {
+            errors.push({
+                path: 'metadata.name',
+                message: 'Resource name is required',
+                keyword: 'required',
+            });
+        }
+        // Layer 2: JSON schema validation via raw YAML
+        if (schemaValidator) {
+            try {
+                const parsed = (0, yaml_1.parse)(rawYamls[i]);
+                if (parsed && typeof parsed === 'object') {
+                    const result = schemaValidator.validate(parsed);
+                    if (!result.valid) {
+                        errors.push(...result.errors);
+                    }
+                }
+            }
+            catch {
+                // Parse errors already caught in Layer 0
+            }
+        }
+        // Layer 3: Dependency existence
+        const deps = getResourceDeps(res.kind, res.spec);
+        for (const dep of deps) {
+            const depId = (0, resource_edge_1.toResourceId)(dep.kind, dep.key, dep.version);
+            if (!resourceIdSet.has(depId)) {
+                errors.push({
+                    path: '/',
+                    message: `Referenced ${dep.kind} '${dep.key}@${dep.version}' not found`,
+                    keyword: 'dependency-missing',
+                });
+            }
+        }
+        // Layer 4: Cross-resource rules
+        const crossErrors = validateCrossResourceRules(res, resourceMap);
+        errors.push(...crossErrors);
+        if (errors.length > 0) {
+            allErrors.push({
+                resourceKey: res.metadata.key,
+                resourceKind: res.kind,
+                errors,
+            });
+        }
+    }
+    return {
+        valid: allErrors.length === 0,
+        errors: allErrors,
+    };
+}
+// ── Helpers ──
+function getResourceDeps(kind, spec) {
+    switch (kind) {
+        case resource_edge_1.ResourceKind.Blueprint:
+            return (0, resource_edge_1.getBlueprintDeps)(spec);
+        case resource_edge_1.ResourceKind.Template:
+            return (0, resource_edge_1.getTemplateDeps)(spec);
+        case resource_edge_1.ResourceKind.Asset:
+            return (0, resource_edge_1.getAssetDeps)(spec);
+        case resource_edge_1.ResourceKind.JsonataFunction:
+            return (0, resource_edge_1.getFunctionDeps)(spec);
+        default:
+            return [];
+    }
+}
+function validateCrossResourceRules(res, resourceMap) {
+    const errors = [];
+    if (res.kind === resource_edge_1.ResourceKind.Template) {
+        const spec = res.spec;
+        const templateType = spec?.type ?? template_1.TemplateType.PDF;
+        if (templateType === template_1.TemplateType.HTML) {
+            const key = spec?.contentKey;
+            const version = spec?.contentVersion;
+            if (key && version) {
+                const assetId = (0, resource_edge_1.toResourceId)(resource_edge_1.ResourceKind.Asset, key, version);
+                const asset = resourceMap.get(assetId);
+                if (asset && !asset.spec?.content) {
+                    errors.push({
+                        path: 'spec.contentKey',
+                        message: 'HTML template content asset has no content',
+                        keyword: 'content-missing',
+                    });
+                }
+            }
+            else {
+                errors.push({
+                    path: 'spec.contentKey',
+                    message: 'HTML template requires a content asset',
+                    keyword: 'content-missing',
+                });
+            }
+        }
+        else if (templateType === template_1.TemplateType.PDF) {
+            const key = spec?.contentKey;
+            const version = spec?.contentVersion;
+            if (key && version) {
+                const assetId = (0, resource_edge_1.toResourceId)(resource_edge_1.ResourceKind.Asset, key, version);
+                const asset = resourceMap.get(assetId);
+                const fileId = asset?.spec?.fileId;
+                if (!fileId || !util_1.Util.isLiteral(fileId)) {
+                    errors.push({
+                        path: 'spec.contentKey',
+                        message: 'PDF template requires an uploaded PDF file',
+                        keyword: 'content-missing',
+                    });
+                }
+            }
+        }
+    }
+    if (res.kind === resource_edge_1.ResourceKind.Asset) {
+        const spec = res.spec;
+        const assetType = spec?.type ?? base_1.AssetType.Html;
+        if (assetType === base_1.AssetType.Image || assetType === base_1.AssetType.Pdf) {
+            if (!spec?.fileId) {
+                errors.push({
+                    path: 'spec.fileId',
+                    message: `${assetType} asset requires an uploaded file`,
+                    keyword: 'content-missing',
+                });
+            }
+        }
+        else {
+            if (!(spec?.content ?? '').trim()) {
+                errors.push({
+                    path: 'spec.content',
+                    message: `${assetType} asset requires content`,
+                    keyword: 'content-missing',
+                });
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-resource-tree.js.map

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

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

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

@@ -0,0 +1,24 @@
+export interface TemplateInputValidationError {
+    blueprintId: string;
+    documentKey: string;
+    templateKey: string;
+    templateVersion: string;
+    templateInputKey: string;
+    message: string;
+}
+export interface TemplateInputValidationResult {
+    valid: boolean;
+    errors: TemplateInputValidationError[];
+}
+/**
+ * Validate that all required template inputs are properly provided in blueprint documents.
+ *
+ * A required template input is considered valid if ANY of the following is true:
+ * 1) There is an explicit inputMap for the template input
+ * 2) There is an implicit match (template input key === blueprint input key)
+ *
+ * Notes:
+ * - inputMap is optional if keys match directly
+ * - If explicit mapping is provided, the referenced blueprint input must exist
+ */
+export declare function validateTemplateInputs(yamls: string[]): TemplateInputValidationResult;

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

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTemplateInputs = validateTemplateInputs;
+const dependency_graph_1 = require("./dependency-graph");
+const yaml_document_utils_1 = require("./yaml-document-utils");
+const schema_validation_types_1 = require("./schema-validation.types");
+/**
+ * Validate that all required template inputs are properly provided in blueprint documents.
+ *
+ * A required template input is considered valid if ANY of the following is true:
+ * 1) There is an explicit inputMap for the template input
+ * 2) There is an implicit match (template input key === blueprint input key)
+ *
+ * Notes:
+ * - inputMap is optional if keys match directly
+ * - If explicit mapping is provided, the referenced blueprint input must exist
+ */
+function validateTemplateInputs(yamls) {
+    const errors = [];
+    // Parse and deduplicate by ResourceId
+    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: [] };
+    }
+    // Find all blueprints
+    const blueprints = docs.filter((doc) => doc.kind === schema_validation_types_1.SchemaKind.Blueprint);
+    for (const blueprint of blueprints) {
+        const blueprintSpec = blueprint.content
+            .spec;
+        if (!blueprintSpec)
+            continue;
+        const blueprintInputs = blueprintSpec.inputs ?? [];
+        const blueprintInputKeys = new Set(blueprintInputs.map((input) => input.key));
+        const envelopes = blueprintSpec.envelopes || [];
+        for (const envelope of envelopes) {
+            const documents = envelope.documents || [];
+            for (const document of documents) {
+                if (!document.templateKey || !document.templateVersion)
+                    continue;
+                // Find the corresponding template
+                const templateId = dependency_graph_1.DependencyGraph.createId(schema_validation_types_1.SchemaKind.Template, document.templateKey, document.templateVersion);
+                const template = docMap.get(templateId);
+                if (!template)
+                    continue;
+                const templateSpec = template.content.spec;
+                if (!templateSpec)
+                    continue;
+                const templateInputs = templateSpec.inputs || [];
+                const requiredTemplateInputs = templateInputs.filter((input) => input.required === true);
+                const inputMap = document.inputMap || [];
+                // Validate each required template input
+                for (const templateInput of requiredTemplateInputs) {
+                    const templateInputKey = templateInput.key;
+                    const mapping = inputMap.find((m) => m.templateInputKey === templateInputKey);
+                    const hasExplicitMapping = !!mapping;
+                    const hasImplicitMatch = blueprintInputKeys.has(templateInputKey);
+                    // ❌ Fail only if neither mapping nor implicit match exists
+                    if (!hasExplicitMapping && !hasImplicitMatch) {
+                        errors.push({
+                            blueprintId: blueprint.id,
+                            documentKey: document.key,
+                            templateKey: document.templateKey,
+                            templateVersion: document.templateVersion,
+                            templateInputKey,
+                            message: `Required template input "${templateInputKey}" is not provided. No mapping found and no matching blueprint input exists.`,
+                        });
+                        continue;
+                    }
+                    // ❌ If explicit mapping exists, validate blueprint input key
+                    if (hasExplicitMapping &&
+                        mapping.blueprintInputKey &&
+                        !blueprintInputKeys.has(mapping.blueprintInputKey)) {
+                        errors.push({
+                            blueprintId: blueprint.id,
+                            documentKey: document.key,
+                            templateKey: document.templateKey,
+                            templateVersion: document.templateVersion,
+                            templateInputKey,
+                            message: `Template input "${templateInputKey}" is mapped to blueprint input "${mapping.blueprintInputKey}" which does not exist in blueprint inputs`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=validate-template-inputs.js.map

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

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

package/dist/libs/signstack/base/src/lib/validation/yaml-document-utils.d.ts

@@ -0,0 +1,12 @@
+import type { ParsedDocument } from './graph.types';
+/**
+ * Parse a single YAML string into a ParsedDocument.
+ * Returns null if the YAML is invalid or not a SignStack resource.
+ * filePath defaults to '' for non-file-based usage (e.g., AI chat).
+ */
+export declare function parseYamlToDocument(yamlString: string, filePath?: string): ParsedDocument | null;
+/**
+ * Parse multiple YAML strings into ParsedDocuments.
+ * Silently skips invalid/unparseable strings.
+ */
+export declare function parseYamlsToDocuments(yamlStrings: string[], filePath?: string): ParsedDocument[];

package/dist/libs/signstack/base/src/lib/validation/yaml-document-utils.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseYamlToDocument = parseYamlToDocument;
+exports.parseYamlsToDocuments = parseYamlsToDocuments;
+const yaml_1 = require("yaml");
+const schema_validation_types_1 = require("./schema-validation.types");
+const dependency_graph_1 = require("./dependency-graph");
+const dependency_graph_2 = require("./dependency-graph");
+/**
+ * Parse a single YAML string into a ParsedDocument.
+ * Returns null if the YAML is invalid or not a SignStack resource.
+ * filePath defaults to '' for non-file-based usage (e.g., AI chat).
+ */
+function parseYamlToDocument(yamlString, filePath = '') {
+    let content;
+    try {
+        content = (0, yaml_1.parse)(yamlString);
+    }
+    catch {
+        return null;
+    }
+    if (!content || typeof content !== 'object')
+        return null;
+    const kind = content['kind'];
+    if (!kind || !(0, schema_validation_types_1.isSchemaKind)(kind))
+        return null;
+    const metadata = content['metadata'];
+    const key = metadata?.['key'];
+    const version = metadata?.['version'];
+    if (!key || !version)
+        return null;
+    const schemaKind = kind;
+    const id = dependency_graph_1.DependencyGraph.createId(schemaKind, key, version);
+    const references = (0, dependency_graph_2.extractReferences)(content, schemaKind);
+    return { id, kind: schemaKind, key, version, filePath, content, references };
+}
+/**
+ * Parse multiple YAML strings into ParsedDocuments.
+ * Silently skips invalid/unparseable strings.
+ */
+function parseYamlsToDocuments(yamlStrings, filePath = '') {
+    const docs = [];
+    for (const yaml of yamlStrings) {
+        const doc = parseYamlToDocument(yaml, filePath);
+        if (doc)
+            docs.push(doc);
+    }
+    return docs;
+}
+//# sourceMappingURL=yaml-document-utils.js.map

package/dist/libs/signstack/base/src/lib/validation/yaml-document-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-document-utils.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/validation/yaml-document-utils.ts"],"names":[],"mappings":";;AAWA,kDA0BC;AAMD,sDAUC;AArDD,+BAA0C;AAC1C,uEAAqE;AACrE,yDAAqD;AACrD,yDAAuD;AAGvD;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,UAAkB,EAClB,QAAQ,GAAG,EAAE;IAEb,IAAI,OAAgC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,GAAG,IAAA,YAAS,EAAC,UAAU,CAA4B,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAW,CAAC;IACvC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAA,sCAAY,EAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAwC,CAAC;IAC5E,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC,KAAK,CAAW,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC,SAAS,CAAW,CAAC;IAChD,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,UAAU,GAAG,IAAkB,CAAC;IACtC,MAAM,EAAE,GAAG,kCAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAA,oCAAiB,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE1D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,WAAqB,EACrB,QAAQ,GAAG,EAAE;IAEb,MAAM,IAAI,GAAqB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/libs/signstack/base/src/lib/yaml-spec-converter.d.ts

@@ -0,0 +1,101 @@
+import { type LiteralOrExpression } from './models/base';
+import type { AssetHtmlConfigRefs } from './models/asset';
+import type { BlueprintStep } from './models/blueprint';
+import { JsonataFunctionItemType, JsonataFunctionParamType } from './models/jsonata-function';
+import { ResourceKind } from './models/resource-edge';
+import type { Input, TemplateFieldInfo, TemplateRole } from './models/template';
+export declare function splitKeyVersion(ref: string): {
+    key: string;
+    version: string;
+};
+export declare function normalizeExpression(value: any): LiteralOrExpression<string> | undefined;
+export declare function extractExpressionString(value: any): string | undefined;
+export declare function extractBlueprintInputKey(value: string): string;
+export declare function resolveRequired(required: LiteralOrExpression<boolean> | undefined): boolean | {
+    expression: string;
+};
+export declare function transformInputs(yamlInputs: any[]): Input[];
+/**
+ * Like transformInputs but supports expression-based required fields.
+ * Used for template inputs where required can be `{ expression: "..." }`.
+ * @deprecated Use transformInputs instead — both now support expressions.
+ */
+export declare function transformExpressionInputs(yamlInputs: any[]): Input[];
+export declare function transformRole(role: any): TemplateRole;
+export declare function transformField(field: any): TemplateFieldInfo;
+/**
+ * Transforms a map of named asset references (alias → "key@version") into
+ * an array of `{ key, version, alias }`. Used for image references, which
+ * are always plain string refs in YAML.
+ */
+export declare function transformAssetObjectRefs(yamlRefs: Record<string, any> | undefined): {
+    key: string;
+    version: string;
+    alias: string;
+}[] | undefined;
+/**
+ * Transforms a map of partial references into an array of
+ * `{ key, version, alias, roleMap? }`. Partials support an object form in
+ * YAML that carries an optional `roleMap` alongside the asset reference:
+ *
+ *     partials:
+ *       buyer_sig:
+ *         asset: signature_block@1.0.0
+ *         roleMap: { signer: buyer }
+ */
+export declare function transformPartialObjectRefs(yamlRefs: Record<string, any> | undefined): {
+    key: string;
+    version: string;
+    alias: string;
+    roleMap?: Record<string, string>;
+}[] | undefined;
+export declare function transformEnvelopes(yamlEnvelopes: any[]): any[];
+export declare function transformParticipants(yamlParticipants: any[]): any[];
+export declare function transformCustomFields(yamlCustomFields: any[]): any[];
+export declare function transformOrchestrationToTree(node: any): BlueprintStep;
+export declare function transformAction(action: any): any;
+export declare function transformJsonataParams(yamlParams: any[]): {
+    name: string;
+    type: JsonataFunctionParamType;
+    itemType?: JsonataFunctionItemType;
+    schemaKey?: string;
+    schemaVersion?: string;
+}[];
+export declare function transformJsonataReturnType(yamlReturnType: any): {
+    type: JsonataFunctionParamType;
+    itemType?: JsonataFunctionItemType;
+    schemaKey?: string;
+    schemaVersion?: string;
+};
+export declare function buildHtmlConfigRefs(spec: any): AssetHtmlConfigRefs | undefined;
+/**
+ * Normalize a YAML `functions` block (object map or array form) into the API
+ * shape `{ alias, functionKey, functionVersion }[]`.
+ *
+ * Supported shapes:
+ * - Object map: `{ money: "format_currency@1.0.0" }` (key is alias)
+ * - Array of strings: `["format_currency@1.0.0"]` (alias = functionKey)
+ */
+export declare function normalizeYamlFunctionsBlock(fns: unknown): {
+    alias?: string;
+    functionKey: string;
+    functionVersion: string;
+}[] | undefined;
+/**
+ * Convert a YAML spec to API format based on resource kind.
+ * If the spec is already in API format, returns it as-is.
+ */
+export declare function convertYamlSpec(kind: ResourceKind, spec: any): any;
+export declare function displayNameToResourceKind(display: string): ResourceKind | null;
+export declare function resourceKindToDisplayName(kind: ResourceKind): string;
+/**
+ * Convert an API-format resource into a YAML-friendly plain object.
+ * For resource kinds without special formatting (Template, Blueprint),
+ * returns a generic `{ kind, metadata, spec }` structure.
+ */
+export declare function convertResourceToYamlObject(kind: ResourceKind, metadata: any, spec: any): any;
+/**
+ * Convert an API-format resource into a YAML string.
+ * Convenience wrapper around convertResourceToYamlObject + yamlStringify.
+ */
+export declare function resourceToYaml(kind: ResourceKind, metadata: any, spec: any): string;