@schemashift/core 0.9.0 → 0.10.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { Project, CallExpression, Node, SourceFile } from 'ts-morph';
 
-type SchemaLibrary = 'zod' | 'zod-v3' | 'yup' | 'joi' | 'io-ts' | 'valibot' | 'v4' | 'unknown';
+type SchemaLibrary = 'zod' | 'zod-v3' | 'yup' | 'joi' | 'io-ts' | 'valibot' | 'arktype' | 'superstruct' | 'effect' | 'v4' | 'unknown';
 interface SchemaInfo {
     name: string;
     filePath: string;
@@ -143,6 +143,15 @@ declare function transformMethodChain(chain: CallChainInfo, newBase: string, fac
     args: string[];
 }[] | null | undefined): string;
 
+interface AuditEntryMetadata {
+    gitCommit?: string;
+    gitBranch?: string;
+    ciJobId?: string;
+    ciProvider?: string;
+    hostname?: string;
+    nodeVersion?: string;
+    schemashiftVersion?: string;
+}
 interface AuditEntry {
     timestamp: string;
     migrationId: string;
@@ -158,6 +167,7 @@ interface AuditEntry {
     riskScore?: number;
     user?: string;
     duration?: number;
+    metadata?: AuditEntryMetadata;
 }
 interface AuditLog {
     version: number;
@@ -186,6 +196,7 @@ declare class MigrationAuditLog {
         errorCount: number;
         riskScore?: number;
         duration?: number;
+        metadata?: AuditEntryMetadata;
     }): AuditEntry;
     /**
      * Read the current audit log.
@@ -205,10 +216,23 @@ declare class MigrationAuditLog {
         failureCount: number;
         migrationPaths: string[];
     };
+    /**
+     * Export audit log as JSON string.
+     */
+    exportJson(): string;
+    /**
+     * Export audit log as CSV string.
+     */
+    exportCsv(): string;
+    /**
+     * Get entries filtered by date range.
+     */
+    getByDateRange(start: Date, end: Date): AuditEntry[];
     /**
      * Clear the audit log.
      */
     clear(): void;
+    private collectMetadata;
     private write;
     private hashContent;
     private getCurrentUser;
@@ -558,6 +582,67 @@ interface FormLibraryDetection {
 }
 declare function detectFormLibraries(sourceFile: SourceFile): FormLibraryDetection[];
 
+interface SchemaSnapshot {
+    version: number;
+    timestamp: string;
+    projectPath: string;
+    schemas: SchemaFileSnapshot[];
+}
+interface SchemaFileSnapshot {
+    filePath: string;
+    library: string;
+    contentHash: string;
+    schemaCount: number;
+    schemaNames: string[];
+}
+interface DriftResult {
+    hasDrift: boolean;
+    added: SchemaFileSnapshot[];
+    removed: SchemaFileSnapshot[];
+    modified: DriftModification[];
+    unchanged: number;
+    totalFiles: number;
+    snapshotTimestamp: string;
+}
+interface DriftModification {
+    filePath: string;
+    library: string;
+    previousHash: string;
+    currentHash: string;
+    previousSchemaCount: number;
+    currentSchemaCount: number;
+    addedSchemas: string[];
+    removedSchemas: string[];
+}
+declare class DriftDetector {
+    private snapshotDir;
+    private snapshotPath;
+    constructor(projectPath: string);
+    /**
+     * Take a snapshot of the current schema state
+     */
+    snapshot(files: string[], projectPath: string): SchemaSnapshot;
+    /**
+     * Save a snapshot to disk
+     */
+    saveSnapshot(snapshot: SchemaSnapshot): void;
+    /**
+     * Load saved snapshot from disk
+     */
+    loadSnapshot(): SchemaSnapshot | null;
+    /**
+     * Compare current state against saved snapshot
+     */
+    detect(currentFiles: string[], projectPath: string): DriftResult;
+    /**
+     * Compare two snapshots and return drift results
+     */
+    compareSnapshots(baseline: SchemaSnapshot, current: SchemaSnapshot): DriftResult;
+    private extractSchemaNames;
+    private detectLibraryFromContent;
+    private hashContent;
+}
+
 interface FormResolverResult {
     success: boolean;
     transformedCode: string;
@@ -606,6 +691,41 @@ declare class GovernanceEngine {
     private isSchemaExpression;
 }
 
+/**
+ * Governance Rule Templates
+ *
+ * Pre-built governance rules for common enterprise policies.
+ * These can be registered into the GovernanceEngine for quick setup.
+ *
+ * Template categories:
+ * - Security: Prevent unsafe patterns (XSS, injection, DoS)
+ * - Quality: Enforce code quality standards
+ * - Compliance: Support SOX, HIPAA, GDPR requirements
+ * - Performance: Prevent known performance pitfalls
+ */
+interface GovernanceTemplate {
+    name: string;
+    description: string;
+    category: 'security' | 'quality' | 'compliance' | 'performance';
+    rule: GovernanceRuleFunction;
+}
+/**
+ * All available governance rule templates
+ */
+declare const GOVERNANCE_TEMPLATES: GovernanceTemplate[];
+/**
+ * Get a governance template by name
+ */
+declare function getGovernanceTemplate(name: string): GovernanceTemplate | undefined;
+/**
+ * Get all templates for a category
+ */
+declare function getGovernanceTemplatesByCategory(category: GovernanceTemplate['category']): GovernanceTemplate[];
+/**
+ * Get all available template names
+ */
+declare function getGovernanceTemplateNames(): string[];
+
 interface IncrementalState {
     migrationId: string;
     from: SchemaLibrary;
@@ -774,4 +894,4 @@ declare class TypeDedupDetector {
     private namesRelated;
 }
 
-export { type AnalysisResult, type AuditEntry, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, type DuplicateTypeCandidate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GovernanceEngine, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceViolation, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationReadiness, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VersionIssue, type WarningSuppressionRule, type WorkspaceManager, buildCallChain, computeParallelBatches, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, isInsideComment, isInsideStringLiteral, loadConfig, parseCallChain, shouldSuppressWarning, startsWithBase, transformMethodChain, validateConfig };
+export { type AnalysisResult, type AuditEntry, type AuditEntryMetadata, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, DriftDetector, type DriftModification, type DriftResult, type DuplicateTypeCandidate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GOVERNANCE_TEMPLATES, GovernanceEngine, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceTemplate, type GovernanceViolation, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationReadiness, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaFileSnapshot, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type SchemaSnapshot, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VersionIssue, type WarningSuppressionRule, type WorkspaceManager, buildCallChain, computeParallelBatches, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, getGovernanceTemplate, getGovernanceTemplateNames, getGovernanceTemplatesByCategory, isInsideComment, isInsideStringLiteral, loadConfig, parseCallChain, shouldSuppressWarning, startsWithBase, transformMethodChain, validateConfig };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Project, CallExpression, Node, SourceFile } from 'ts-morph';
 
-type SchemaLibrary = 'zod' | 'zod-v3' | 'yup' | 'joi' | 'io-ts' | 'valibot' | 'v4' | 'unknown';
+type SchemaLibrary = 'zod' | 'zod-v3' | 'yup' | 'joi' | 'io-ts' | 'valibot' | 'arktype' | 'superstruct' | 'effect' | 'v4' | 'unknown';
 interface SchemaInfo {
     name: string;
     filePath: string;
@@ -143,6 +143,15 @@ declare function transformMethodChain(chain: CallChainInfo, newBase: string, fac
     args: string[];
 }[] | null | undefined): string;
 
+interface AuditEntryMetadata {
+    gitCommit?: string;
+    gitBranch?: string;
+    ciJobId?: string;
+    ciProvider?: string;
+    hostname?: string;
+    nodeVersion?: string;
+    schemashiftVersion?: string;
+}
 interface AuditEntry {
     timestamp: string;
     migrationId: string;
@@ -158,6 +167,7 @@ interface AuditEntry {
     riskScore?: number;
     user?: string;
     duration?: number;
+    metadata?: AuditEntryMetadata;
 }
 interface AuditLog {
     version: number;
@@ -186,6 +196,7 @@ declare class MigrationAuditLog {
         errorCount: number;
         riskScore?: number;
         duration?: number;
+        metadata?: AuditEntryMetadata;
     }): AuditEntry;
     /**
      * Read the current audit log.
@@ -205,10 +216,23 @@ declare class MigrationAuditLog {
         failureCount: number;
         migrationPaths: string[];
     };
+    /**
+     * Export audit log as JSON string.
+     */
+    exportJson(): string;
+    /**
+     * Export audit log as CSV string.
+     */
+    exportCsv(): string;
+    /**
+     * Get entries filtered by date range.
+     */
+    getByDateRange(start: Date, end: Date): AuditEntry[];
     /**
      * Clear the audit log.
      */
     clear(): void;
+    private collectMetadata;
     private write;
     private hashContent;
     private getCurrentUser;
@@ -558,6 +582,67 @@ interface FormLibraryDetection {
 }
 declare function detectFormLibraries(sourceFile: SourceFile): FormLibraryDetection[];
 
+interface SchemaSnapshot {
+    version: number;
+    timestamp: string;
+    projectPath: string;
+    schemas: SchemaFileSnapshot[];
+}
+interface SchemaFileSnapshot {
+    filePath: string;
+    library: string;
+    contentHash: string;
+    schemaCount: number;
+    schemaNames: string[];
+}
+interface DriftResult {
+    hasDrift: boolean;
+    added: SchemaFileSnapshot[];
+    removed: SchemaFileSnapshot[];
+    modified: DriftModification[];
+    unchanged: number;
+    totalFiles: number;
+    snapshotTimestamp: string;
+}
+interface DriftModification {
+    filePath: string;
+    library: string;
+    previousHash: string;
+    currentHash: string;
+    previousSchemaCount: number;
+    currentSchemaCount: number;
+    addedSchemas: string[];
+    removedSchemas: string[];
+}
+declare class DriftDetector {
+    private snapshotDir;
+    private snapshotPath;
+    constructor(projectPath: string);
+    /**
+     * Take a snapshot of the current schema state
+     */
+    snapshot(files: string[], projectPath: string): SchemaSnapshot;
+    /**
+     * Save a snapshot to disk
+     */
+    saveSnapshot(snapshot: SchemaSnapshot): void;
+    /**
+     * Load saved snapshot from disk
+     */
+    loadSnapshot(): SchemaSnapshot | null;
+    /**
+     * Compare current state against saved snapshot
+     */
+    detect(currentFiles: string[], projectPath: string): DriftResult;
+    /**
+     * Compare two snapshots and return drift results
+     */
+    compareSnapshots(baseline: SchemaSnapshot, current: SchemaSnapshot): DriftResult;
+    private extractSchemaNames;
+    private detectLibraryFromContent;
+    private hashContent;
+}
+
 interface FormResolverResult {
     success: boolean;
     transformedCode: string;
@@ -606,6 +691,41 @@ declare class GovernanceEngine {
     private isSchemaExpression;
 }
 
+/**
+ * Governance Rule Templates
+ *
+ * Pre-built governance rules for common enterprise policies.
+ * These can be registered into the GovernanceEngine for quick setup.
+ *
+ * Template categories:
+ * - Security: Prevent unsafe patterns (XSS, injection, DoS)
+ * - Quality: Enforce code quality standards
+ * - Compliance: Support SOX, HIPAA, GDPR requirements
+ * - Performance: Prevent known performance pitfalls
+ */
+interface GovernanceTemplate {
+    name: string;
+    description: string;
+    category: 'security' | 'quality' | 'compliance' | 'performance';
+    rule: GovernanceRuleFunction;
+}
+/**
+ * All available governance rule templates
+ */
+declare const GOVERNANCE_TEMPLATES: GovernanceTemplate[];
+/**
+ * Get a governance template by name
+ */
+declare function getGovernanceTemplate(name: string): GovernanceTemplate | undefined;
+/**
+ * Get all templates for a category
+ */
+declare function getGovernanceTemplatesByCategory(category: GovernanceTemplate['category']): GovernanceTemplate[];
+/**
+ * Get all available template names
+ */
+declare function getGovernanceTemplateNames(): string[];
+
 interface IncrementalState {
     migrationId: string;
     from: SchemaLibrary;
@@ -774,4 +894,4 @@ declare class TypeDedupDetector {
     private namesRelated;
 }
 
-export { type AnalysisResult, type AuditEntry, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, type DuplicateTypeCandidate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GovernanceEngine, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceViolation, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationReadiness, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VersionIssue, type WarningSuppressionRule, type WorkspaceManager, buildCallChain, computeParallelBatches, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, isInsideComment, isInsideStringLiteral, loadConfig, parseCallChain, shouldSuppressWarning, startsWithBase, transformMethodChain, validateConfig };
+export { type AnalysisResult, type AuditEntry, type AuditEntryMetadata, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, DriftDetector, type DriftModification, type DriftResult, type DuplicateTypeCandidate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GOVERNANCE_TEMPLATES, GovernanceEngine, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceTemplate, type GovernanceViolation, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationReadiness, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaFileSnapshot, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type SchemaSnapshot, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VersionIssue, type WarningSuppressionRule, type WorkspaceManager, buildCallChain, computeParallelBatches, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, getGovernanceTemplate, getGovernanceTemplateNames, getGovernanceTemplatesByCategory, isInsideComment, isInsideStringLiteral, loadConfig, parseCallChain, shouldSuppressWarning, startsWithBase, transformMethodChain, validateConfig };