mythik 0.0.1 → 0.1.0

package/dist/validation/validators.js

@@ -0,0 +1,138 @@
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const URL_REGEX = /^https?:\/\/.+/;
+/** Built-in validators. Each returns true if valid. */
+const BUILTIN_VALIDATORS = {
+    required: (value) => {
+        if (value === null || value === undefined)
+            return false;
+        if (typeof value === 'string')
+            return value.trim().length > 0;
+        return true;
+    },
+    email: (value) => {
+        if (!value || typeof value !== 'string')
+            return true; // Only validate if there's a value
+        return EMAIL_REGEX.test(value);
+    },
+    minLength: (value, args) => {
+        if (!value || typeof value !== 'string')
+            return true;
+        const min = args?.min ?? 0;
+        return value.length >= min;
+    },
+    maxLength: (value, args) => {
+        if (!value || typeof value !== 'string')
+            return true;
+        const max = args?.max ?? Infinity;
+        return value.length <= max;
+    },
+    pattern: (value, args) => {
+        if (!value || typeof value !== 'string')
+            return true;
+        const pat = args?.pattern;
+        if (!pat)
+            return true;
+        return new RegExp(pat).test(value);
+    },
+    min: (value, args) => {
+        if (value === null || value === undefined)
+            return true;
+        const num = Number(value);
+        if (Number.isNaN(num))
+            return true;
+        return num >= (args?.min ?? -Infinity);
+    },
+    max: (value, args) => {
+        if (value === null || value === undefined)
+            return true;
+        const num = Number(value);
+        if (Number.isNaN(num))
+            return true;
+        return num <= (args?.max ?? Infinity);
+    },
+    numeric: (value) => {
+        if (value === null || value === undefined || value === '')
+            return true;
+        return !Number.isNaN(Number(value));
+    },
+    url: (value) => {
+        if (!value || typeof value !== 'string')
+            return true;
+        return URL_REGEX.test(value);
+    },
+    matches: (value, args) => {
+        if (value === null || value === undefined)
+            return true;
+        return value === args?.other;
+    },
+    equalTo: (value, args) => {
+        if (value === null || value === undefined)
+            return true;
+        return value === args?.other;
+    },
+    lessThan: (value, args) => {
+        if (value === null || value === undefined)
+            return true;
+        return Number(value) < Number(args?.other);
+    },
+    greaterThan: (value, args) => {
+        if (value === null || value === undefined)
+            return true;
+        return Number(value) > Number(args?.other);
+    },
+    requiredIf: (value, args) => {
+        const conditionField = args?.field;
+        // If the condition field is truthy, then this field is required
+        if (conditionField) {
+            return BUILTIN_VALIDATORS.required(value);
+        }
+        return true; // Condition not met, skip validation
+    },
+};
+const DEFAULT_MESSAGES = {
+    required: 'This field is required',
+    email: 'Invalid email address',
+    minLength: 'Too short',
+    maxLength: 'Too long',
+    pattern: 'Invalid format',
+    min: 'Value is too small',
+    max: 'Value is too large',
+    numeric: 'Must be a number',
+    url: 'Invalid URL',
+    matches: 'Fields do not match',
+    equalTo: 'Fields do not match',
+    lessThan: 'Must be less than the other field',
+    greaterThan: 'Must be greater than the other field',
+    requiredIf: 'This field is required',
+};
+/** Custom validators can be added at runtime */
+const customValidators = new Map();
+export function registerValidator(name, fn) {
+    customValidators.set(name, fn);
+}
+export function getValidator(name) {
+    return BUILTIN_VALIDATORS[name] ?? customValidators.get(name);
+}
+/**
+ * Run a list of validation checks against a value.
+ * Each check specifies a validator type, optional args, and optional message.
+ */
+export function validate(value, checks) {
+    const errors = [];
+    for (const check of checks) {
+        // Skip disabled checks (enabled is resolved externally before calling)
+        if (check.enabled === false)
+            continue;
+        const fn = getValidator(check.type);
+        if (!fn) {
+            errors.push(`Unknown validator: "${check.type}"`);
+            continue;
+        }
+        const isValid = fn(value, check.args);
+        if (!isValid) {
+            errors.push(check.message ?? DEFAULT_MESSAGES[check.type] ?? `Validation failed: ${check.type}`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validators.js.map

package/dist/validation/validators.js.map

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

package/dist/versioning/compute-patches.d.ts

@@ -0,0 +1,7 @@
+import type { JsonPatch } from '../streaming/patch.js';
+/**
+ * Generate RFC 6902 JSON Patch operations that transform `before` into `after`.
+ * Arrays are treated as atomic values (replaced whole, not diffed element-by-element).
+ */
+export declare function computePatches(before: unknown, after: unknown): JsonPatch[];
+//# sourceMappingURL=compute-patches.d.ts.map

package/dist/versioning/compute-patches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-patches.d.ts","sourceRoot":"","sources":["../../src/versioning/compute-patches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,EAAE,CAI3E"}

package/dist/versioning/compute-patches.js

@@ -0,0 +1,62 @@
+/**
+ * Generate RFC 6902 JSON Patch operations that transform `before` into `after`.
+ * Arrays are treated as atomic values (replaced whole, not diffed element-by-element).
+ */
+export function computePatches(before, after) {
+    const patches = [];
+    diffObjects(before, after, '', patches);
+    return patches;
+}
+function diffObjects(before, after, basePath, patches) {
+    if (before === after)
+        return;
+    if (JSON.stringify(before) === JSON.stringify(after))
+        return;
+    if (!isPlainObject(before) || !isPlainObject(after)) {
+        if (basePath === '')
+            return;
+        patches.push({ op: 'replace', path: basePath, value: after });
+        return;
+    }
+    const beforeObj = before;
+    const afterObj = after;
+    const beforeKeys = Object.keys(beforeObj);
+    const afterKeys = Object.keys(afterObj);
+    const afterKeySet = new Set(afterKeys);
+    const beforeKeySet = new Set(beforeKeys);
+    // Removed keys
+    for (const key of beforeKeys) {
+        if (!afterKeySet.has(key)) {
+            patches.push({ op: 'remove', path: `${basePath}/${escapeJsonPointer(key)}` });
+        }
+    }
+    // Added keys
+    for (const key of afterKeys) {
+        if (!beforeKeySet.has(key)) {
+            patches.push({ op: 'add', path: `${basePath}/${escapeJsonPointer(key)}`, value: afterObj[key] });
+        }
+    }
+    // Changed keys — recurse for objects, replace for primitives/arrays
+    for (const key of beforeKeys) {
+        if (!afterKeySet.has(key))
+            continue;
+        const bVal = beforeObj[key];
+        const aVal = afterObj[key];
+        const childPath = `${basePath}/${escapeJsonPointer(key)}`;
+        if (bVal === aVal)
+            continue;
+        if (isPlainObject(bVal) && isPlainObject(aVal)) {
+            diffObjects(bVal, aVal, childPath, patches);
+        }
+        else {
+            patches.push({ op: 'replace', path: childPath, value: aVal });
+        }
+    }
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function escapeJsonPointer(segment) {
+    return segment.replace(/~/g, '~0').replace(/\//g, '~1');
+}
+//# sourceMappingURL=compute-patches.js.map

package/dist/versioning/compute-patches.js.map

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

package/dist/versioning/index.d.ts

@@ -0,0 +1,12 @@
+export type { VersionMeta, VersionEntry, VersionRecord, EnvironmentPointer, StructuralChangeKind, StructuralChange, StructuralDiff, PromoteResult, RollbackImpact, RollbackResult, VersionedSpecStore, EnvironmentStore, } from './types.js';
+export { computePatches } from './compute-patches.js';
+export { computeStructuralDiff } from './structural-diff.js';
+export { runPromoteGate } from './promote-gate.js';
+export type { PromoteGateInput } from './promote-gate.js';
+export { computeRollbackImpact, executeRollback } from './rollback.js';
+export type { RollbackImpactInput, ExecuteRollbackInput } from './rollback.js';
+export { MemoryVersionedSpecStore, MemoryEnvironmentStore } from '../spec-stores/memory-versioned.js';
+export type { MemoryVersionedSpecStoreConfig } from '../spec-stores/memory-versioned.js';
+export { SupabaseVersionedSpecStore, SupabaseEnvironmentStore } from '../spec-stores/supabase-versioned.js';
+export type { SupabaseVersionedSpecStoreConfig, SupabaseEnvironmentStoreConfig } from '../spec-stores/supabase-versioned.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACtG,YAAY,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAC5G,YAAY,EAAE,gCAAgC,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/versioning/index.js

@@ -0,0 +1,7 @@
+export { computePatches } from './compute-patches.js';
+export { computeStructuralDiff } from './structural-diff.js';
+export { runPromoteGate } from './promote-gate.js';
+export { computeRollbackImpact, executeRollback } from './rollback.js';
+export { MemoryVersionedSpecStore, MemoryEnvironmentStore } from '../spec-stores/memory-versioned.js';
+export { SupabaseVersionedSpecStore, SupabaseEnvironmentStore } from '../spec-stores/supabase-versioned.js';
+//# sourceMappingURL=index.js.map

package/dist/versioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEtG,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/versioning/promote-gate.d.ts

@@ -0,0 +1,12 @@
+import type { VersionedSpecStore, EnvironmentStore, PromoteResult } from './types.js';
+export interface PromoteGateInput {
+    specIds: string[];
+    fromEnv: string;
+    toEnv: string;
+    store: VersionedSpecStore;
+    envStore: EnvironmentStore;
+    apiIds?: string[];
+    author?: string;
+}
+export declare function runPromoteGate(input: PromoteGateInput): Promise<PromoteResult>;
+//# sourceMappingURL=promote-gate.d.ts.map

package/dist/versioning/promote-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote-gate.d.ts","sourceRoot":"","sources":["../../src/versioning/promote-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKtF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmIpF"}

package/dist/versioning/promote-gate.js

@@ -0,0 +1,166 @@
+import { computeStructuralDiff } from './structural-diff.js';
+import { runContract } from '../contract/index.js';
+export async function runPromoteGate(input) {
+    const { specIds, fromEnv, toEnv, store, envStore, apiIds } = input;
+    const errors = [];
+    const warnings = [];
+    let specValid = true;
+    let crossScreenValid = true;
+    let contractValid;
+    let contractSkipped;
+    // 1. Load specs at source environment versions + destination specs for diff
+    const specsToPromote = [];
+    for (const id of specIds) {
+        const envPointer = await envStore.getEnvironment(id, fromEnv);
+        if (!envPointer) {
+            errors.push({ message: `Spec "${id}" has no version in environment "${fromEnv}"`, path: id });
+            specValid = false;
+            continue;
+        }
+        const spec = await store.loadVersion(id, envPointer.version);
+        const destPointer = await envStore.getEnvironment(id, toEnv);
+        const destVersion = destPointer?.version ?? 0;
+        let destSpec = {};
+        if (destVersion > 0) {
+            try {
+                destSpec = await store.loadVersion(id, destVersion);
+            }
+            catch { /* new in dest */ }
+        }
+        specsToPromote.push({ id, spec, destSpec, fromVersion: destVersion, toVersion: envPointer.version });
+    }
+    if (!specValid) {
+        return buildResult(false, specsToPromote, toEnv, { specValid, crossScreenValid, errors, warnings });
+    }
+    // 2. Layer 1 — Spec validation (structural)
+    for (const { id, spec } of specsToPromote) {
+        if (!spec || typeof spec !== 'object') {
+            errors.push({ message: `Spec "${id}" is not a valid object`, path: id });
+            specValid = false;
+        }
+    }
+    // 3. Layer 2 — Cross-screen consistency
+    const batchIds = new Set(specIds);
+    const screenRefs = extractScreenReferences(specsToPromote.map(s => s.spec));
+    for (const ref of screenRefs) {
+        if (batchIds.has(ref))
+            continue;
+        const destPointer = await envStore.getEnvironment(ref, toEnv);
+        if (!destPointer) {
+            try {
+                await store.load(ref);
+                warnings.push({ message: `Referenced screen "${ref}" exists but has no version in "${toEnv}"`, path: ref });
+            }
+            catch {
+                warnings.push({ message: `Referenced screen "${ref}" does not exist in "${toEnv}"`, path: ref });
+            }
+            crossScreenValid = false;
+        }
+    }
+    // 4. Layer 3 — Contract validation (optional)
+    if (apiIds && apiIds.length > 0) {
+        contractSkipped = false;
+        const apis = [];
+        for (const apiId of apiIds) {
+            let apiSpec;
+            if (batchIds.has(apiId)) {
+                // Api-spec in batch → use source env version
+                const envPointer = await envStore.getEnvironment(apiId, fromEnv);
+                if (envPointer) {
+                    apiSpec = await store.loadVersion(apiId, envPointer.version);
+                }
+            }
+            else {
+                // Api-spec not in batch → use destination env version
+                const envPointer = await envStore.getEnvironment(apiId, toEnv);
+                if (envPointer) {
+                    apiSpec = await store.loadVersion(apiId, envPointer.version);
+                }
+            }
+            if (apiSpec && typeof apiSpec === 'object') {
+                apis.push({ id: apiId, spec: apiSpec });
+            }
+        }
+        if (apis.length > 0) {
+            const screens = {};
+            for (const { id, spec } of specsToPromote) {
+                const s = spec;
+                if (s.type !== 'api') {
+                    screens[id] = s;
+                }
+            }
+            if (Object.keys(screens).length > 0) {
+                const contractResult = runContract({ screens, apis });
+                const contractErrors = contractResult.findings.filter(f => f.level === 'error');
+                const contractWarnings = contractResult.findings.filter(f => f.level === 'warning');
+                contractValid = contractErrors.length === 0;
+                for (const f of contractErrors) {
+                    errors.push({ message: `[${f.rule}] ${f.message}`, path: f.screen ?? f.endpoint ?? '' });
+                }
+                for (const f of contractWarnings) {
+                    warnings.push({ message: `[${f.rule}] ${f.message}`, path: f.screen ?? f.endpoint ?? '' });
+                }
+            }
+            else {
+                contractValid = true;
+            }
+        }
+        else {
+            contractSkipped = true;
+        }
+    }
+    else {
+        contractSkipped = true;
+    }
+    const success = specValid && (contractValid !== false);
+    return buildResult(success, specsToPromote, toEnv, {
+        specValid,
+        crossScreenValid,
+        contractValid,
+        contractSkipped,
+        errors,
+        warnings,
+    });
+}
+function buildResult(success, specs, environment, validation) {
+    return {
+        success,
+        specs: specs.map(s => ({
+            id: s.id,
+            fromVersion: s.fromVersion,
+            toVersion: s.toVersion,
+            diff: computeStructuralDiff(s.destSpec, s.spec, s.fromVersion, s.toVersion),
+        })),
+        environment,
+        validation,
+    };
+}
+function extractScreenReferences(specs) {
+    const refs = new Set();
+    for (const spec of specs) {
+        if (!spec || typeof spec !== 'object')
+            continue;
+        findNavigateRefs(spec, refs);
+    }
+    return Array.from(refs);
+}
+function findNavigateRefs(obj, refs) {
+    if (!obj || typeof obj !== 'object')
+        return;
+    if (Array.isArray(obj)) {
+        for (const item of obj)
+            findNavigateRefs(item, refs);
+        return;
+    }
+    const record = obj;
+    if (record.action === 'navigate' && record.params) {
+        const params = record.params;
+        if (typeof params.screen === 'string') {
+            refs.add(params.screen);
+        }
+    }
+    for (const value of Object.values(record)) {
+        findNavigateRefs(value, refs);
+    }
+}
+//# sourceMappingURL=promote-gate.js.map

package/dist/versioning/promote-gate.js.map

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

package/dist/versioning/rollback.d.ts

@@ -0,0 +1,26 @@
+import type { VersionedSpecStore, EnvironmentStore, RollbackImpact, RollbackResult } from './types.js';
+export interface RollbackImpactInput {
+    specId: string;
+    fromVersion: number;
+    toVersion: number;
+    store: VersionedSpecStore;
+    envStore: EnvironmentStore;
+}
+export interface ExecuteRollbackInput {
+    specId: string;
+    toVersion: number;
+    store: VersionedSpecStore;
+    envStore: EnvironmentStore;
+    author: string;
+    description?: string;
+}
+/**
+ * Compute what would be lost by rolling back from fromVersion to toVersion.
+ */
+export declare function computeRollbackImpact(input: RollbackImpactInput): Promise<RollbackImpact>;
+/**
+ * Execute a rollback: create a new version with the content of the target version.
+ * History is preserved — forward-only, never destructive.
+ */
+export declare function executeRollback(input: ExecuteRollbackInput): Promise<RollbackResult>;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/versioning/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../src/versioning/rollback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGvG,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B/F;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsC1F"}

package/dist/versioning/rollback.js

@@ -0,0 +1,67 @@
+import { computeStructuralDiff } from './structural-diff.js';
+/**
+ * Compute what would be lost by rolling back from fromVersion to toVersion.
+ */
+export async function computeRollbackImpact(input) {
+    const { specId, fromVersion, toVersion, store, envStore } = input;
+    // Diff: what exists in current that doesn't exist in target = what we lose
+    const targetSpec = await store.loadVersion(specId, toVersion);
+    const currentSpec = await store.loadVersion(specId, fromVersion);
+    const diff = computeStructuralDiff(targetSpec, currentSpec, toVersion, fromVersion);
+    // Collect authors from all lost versions for attribution
+    const versions = await store.listVersions(specId);
+    const lostVersions = versions.filter(v => v.version > toVersion && v.version <= fromVersion);
+    const uniqueAuthors = [...new Set(lostVersions.map(v => v.author))];
+    const lostChanges = diff.changes.map(change => ({
+        change,
+        version: fromVersion, // Most recent version (the "current" being rolled back)
+        author: uniqueAuthors.length === 1 ? uniqueAuthors[0] : uniqueAuthors.join(', '),
+    }));
+    // Check which environments are affected
+    const envs = await envStore.getEnvironments(specId);
+    const affectedEnvironments = envs.map(env => ({
+        name: env.name,
+        currentVersion: env.version,
+        affected: env.version > toVersion,
+    }));
+    return { lostChanges, affectedEnvironments };
+}
+/**
+ * Execute a rollback: create a new version with the content of the target version.
+ * History is preserved — forward-only, never destructive.
+ */
+export async function executeRollback(input) {
+    const { specId, toVersion, store, envStore, author, description } = input;
+    const currentVersion = await store.currentVersion(specId);
+    if (currentVersion === 0) {
+        return {
+            success: false,
+            fromVersion: 0,
+            toVersion,
+            newVersion: 0,
+            impact: { lostChanges: [], affectedEnvironments: [] },
+            errors: [{ message: `No version history for "${specId}"`, path: specId }],
+        };
+    }
+    const impact = await computeRollbackImpact({
+        specId,
+        fromVersion: currentVersion,
+        toVersion,
+        store,
+        envStore,
+    });
+    const targetSpec = await store.loadVersion(specId, toVersion);
+    const newVersion = await store.saveVersion(specId, targetSpec, {
+        author,
+        source: 'rollback',
+        description: description ?? `Rollback to v${toVersion}`,
+    });
+    return {
+        success: true,
+        fromVersion: currentVersion,
+        toVersion,
+        newVersion,
+        impact,
+    };
+}
+//# sourceMappingURL=rollback.js.map

package/dist/versioning/rollback.js.map

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

package/dist/versioning/structural-diff.d.ts

@@ -0,0 +1,8 @@
+import type { StructuralDiff } from './types.js';
+/**
+ * Compute a semantic structural diff between two specs.
+ * Type-aware: understands elements (screen/app), endpoints (api), navigation (app).
+ * Shows before/after values for all changes.
+ */
+export declare function computeStructuralDiff(before: unknown, after: unknown, fromVersion: number, toVersion: number): StructuralDiff;
+//# sourceMappingURL=structural-diff.d.ts.map

package/dist/versioning/structural-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-diff.d.ts","sourceRoot":"","sources":["../../src/versioning/structural-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,cAAc,CAwChB"}