@baseplate-dev/project-builder-server 0.2.5 → 0.3.0

package/dist/diff/snapshot/snapshot-management.js

@@ -0,0 +1,154 @@
+import { enhanceErrorWithContext } from '@baseplate-dev/utils';
+import { handleFileNotFoundError } from '@baseplate-dev/utils/node';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { compileApplications } from '#src/compiler/index.js';
+import { getSingleAppDirectoryForProject } from '#src/project-definition/get-single-app-directory-for-project.js';
+import { loadProjectDefinition } from '#src/project-definition/index.js';
+import { createTemplateMetadataOptions } from '#src/sync/template-metadata-utils.js';
+import { DEFAULT_GENERATOR_OPERATIONS } from '#src/sync/types.js';
+import { removeSnapshotDiffFile, saveSnapshotDiffFile, } from './snapshot-diff-utils.js';
+import { initializeSnapshotManifest, loadSnapshotManifest, saveSnapshotManifest, snapshotManifestUtils, } from './snapshot-manifest.js';
+import { resolveSnapshotDirectory } from './snapshot-utils.js';
+/**
+ * Adds files to snapshot
+ */
+export async function addFilesToSnapshot(relativePaths, isDeleted, { projectDirectory, snapshotDirectory, appName, context, logger, generatorOperations = DEFAULT_GENERATOR_OPERATIONS, }) {
+    try {
+        const { definition } = await loadProjectDefinition(projectDirectory, context);
+        const compiledApps = compileApplications(definition, context);
+        const compiledApp = compiledApps.find((a) => a.name === appName);
+        if (!compiledApp) {
+            throw new Error(`App ${appName} not found`);
+        }
+        const appDirectory = path.join(projectDirectory, compiledApp.appDirectory);
+        const snapshotDirectories = resolveSnapshotDirectory(appDirectory, {
+            snapshotDir: snapshotDirectory,
+        });
+        logger.info(`Generating project to create snapshot...`);
+        const appEntry = await generatorOperations.buildGeneratorEntry(compiledApp.generatorBundle);
+        const { files: generatedFiles } = await generatorOperations.executeGeneratorEntry(appEntry, {
+            templateMetadataOptions: createTemplateMetadataOptions(definition),
+        });
+        // Load existing manifest
+        let manifest = (await loadSnapshotManifest(snapshotDirectories)) ??
+            initializeSnapshotManifest();
+        for (const relativePath of relativePaths) {
+            const absolutePath = path.join(appDirectory, relativePath);
+            if (isDeleted) {
+                if (!generatedFiles.get(relativePath)) {
+                    throw new Error(`File not found in generated output: ${relativePath}`);
+                }
+                // Mark file as intentionally deleted
+                logger.info(`Adding deleted file to snapshot: ${relativePath}`);
+                manifest = snapshotManifestUtils.addDeletedFile(manifest, relativePath);
+            }
+            else {
+                // Add existing file with diff
+                const workingContent = await readFile(absolutePath, 'utf8').catch(handleFileNotFoundError);
+                if (!workingContent) {
+                    throw new Error(`File not found: ${absolutePath}. Use --deleted flag for deleted files.`);
+                }
+                const generatedContent = generatedFiles.get(relativePath)?.contents;
+                if (generatedContent) {
+                    if (Buffer.isBuffer(generatedContent)) {
+                        throw new TypeError(`Diffing binary contents is not currently supported.`);
+                    }
+                    if (generatedContent === workingContent) {
+                        logger.warn(`File ${relativePath} is unchanged. Skipping snapshot generation.`);
+                        continue;
+                    }
+                    const diffFileName = await saveSnapshotDiffFile(snapshotDirectories, relativePath, generatedContent, workingContent);
+                    manifest = snapshotManifestUtils.addModifiedFile(manifest, relativePath, diffFileName);
+                }
+                else {
+                    // Mark file as added
+                    manifest = snapshotManifestUtils.addAddedFile(manifest, relativePath);
+                }
+                logger.info(`Adding file to snapshot: ${relativePath}`);
+            }
+        }
+        // Save updated manifest
+        await saveSnapshotManifest(snapshotDirectories, manifest);
+        logger.info(`✓ Added ${relativePaths.length} file(s) to snapshot`);
+    }
+    catch (error) {
+        throw enhanceErrorWithContext(error, `Failed to add files to snapshot`);
+    }
+}
+/**
+ * Removes files from snapshot
+ */
+export async function removeFilesFromSnapshot(relativePaths, { projectDirectory, appName, snapshotDirectory, context, logger, }) {
+    try {
+        const { definition } = await loadProjectDefinition(projectDirectory, context);
+        const appDirectory = getSingleAppDirectoryForProject(projectDirectory, definition, appName);
+        const snapshotDir = resolveSnapshotDirectory(appDirectory, {
+            snapshotDir: snapshotDirectory,
+        });
+        // Load existing manifest
+        let manifest = await loadSnapshotManifest(snapshotDir);
+        if (!manifest) {
+            throw new Error(`Snapshot not found at ${snapshotDir.path}`);
+        }
+        for (const relativePath of relativePaths) {
+            const modifiedFile = manifest.files.modified.find((entry) => entry.path === relativePath);
+            if (modifiedFile?.diffFile) {
+                await removeSnapshotDiffFile(snapshotDir, modifiedFile.diffFile);
+            }
+            manifest = snapshotManifestUtils.removeFile(manifest, relativePath);
+        }
+        // Save updated manifest
+        await saveSnapshotManifest(snapshotDir, manifest);
+        logger.info(`✓ Removed ${relativePaths.length} file(s) from snapshot`);
+    }
+    catch (error) {
+        logger.error(`Failed to remove files from snapshot: ${error.message}`);
+        throw error;
+    }
+}
+/**
+ * Lists snapshot contents
+ */
+export async function listSnapshotContents({ projectDirectory, snapshotDirectory, appName, context, logger, }) {
+    try {
+        const { definition } = await loadProjectDefinition(projectDirectory, context);
+        const appDirectory = getSingleAppDirectoryForProject(projectDirectory, definition, appName);
+        const snapshotDir = resolveSnapshotDirectory(appDirectory, {
+            snapshotDir: snapshotDirectory,
+        });
+        // Load manifest
+        const manifest = await loadSnapshotManifest(snapshotDir);
+        if (!manifest) {
+            throw new Error(`Snapshot not found at ${snapshotDir.path}`);
+        }
+        logger.info(`Snapshot contents (${snapshotDir.path}):`);
+        if (manifest.files.modified.length > 0) {
+            logger.info(`\\nModified files (${manifest.files.modified.length}):`);
+            for (const entry of manifest.files.modified) {
+                logger.info(`  ${entry.path}`);
+            }
+        }
+        if (manifest.files.added.length > 0) {
+            logger.info(`\\nAdded files (${manifest.files.added.length}):`);
+            for (const file of manifest.files.added) {
+                logger.info(`  ${file}`);
+            }
+        }
+        if (manifest.files.deleted.length > 0) {
+            logger.info(`\\nDeleted files (${manifest.files.deleted.length}):`);
+            for (const file of manifest.files.deleted) {
+                logger.info(`  ${file}`);
+            }
+        }
+        if (manifest.files.modified.length === 0 &&
+            manifest.files.added.length === 0 &&
+            manifest.files.deleted.length === 0) {
+            logger.info('  (empty)');
+        }
+    }
+    catch (error) {
+        throw enhanceErrorWithContext(error, `Failed to list snapshot contents`);
+    }
+}
+//# sourceMappingURL=snapshot-management.js.map

package/dist/diff/snapshot/snapshot-management.js.map

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

package/dist/diff/snapshot/snapshot-manifest.d.ts

@@ -0,0 +1,40 @@
+import type { SnapshotDirectory, SnapshotManifest } from './snapshot-types.js';
+/**
+ * Creates a new snapshot manifest
+ */
+export declare function initializeSnapshotManifest(): SnapshotManifest;
+/**
+ * Saves a manifest to the snapshot directory
+ */
+export declare function saveSnapshotManifest(snapshotDirectory: SnapshotDirectory, manifest: SnapshotManifest): Promise<void>;
+/**
+ * Loads a manifest from the snapshot directory
+ */
+export declare function loadSnapshotManifest(snapshotDirectory: SnapshotDirectory): Promise<SnapshotManifest | undefined>;
+/**
+ * Adds a modified file entry to the manifest
+ */
+declare function addModifiedFile(manifest: SnapshotManifest, filePath: string, diffFile: string): SnapshotManifest;
+/**
+ * Adds an added file to the manifest
+ */
+declare function addAddedFile(manifest: SnapshotManifest, filePath: string): SnapshotManifest;
+/**
+ * Adds a deleted file to the manifest
+ */
+declare function addDeletedFile(manifest: SnapshotManifest, filePath: string): SnapshotManifest;
+/**
+ * Removes a file from the manifest
+ */
+declare function removeFile(manifest: SnapshotManifest, filePath: string): SnapshotManifest;
+/**
+ * Utilities for working with snapshot manifests
+ */
+export declare const snapshotManifestUtils: {
+    addModifiedFile: typeof addModifiedFile;
+    addAddedFile: typeof addAddedFile;
+    addDeletedFile: typeof addDeletedFile;
+    removeFile: typeof removeFile;
+};
+export {};
+//# sourceMappingURL=snapshot-manifest.d.ts.map

package/dist/diff/snapshot/snapshot-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-manifest.d.ts","sourceRoot":"","sources":["../../../src/diff/snapshot/snapshot-manifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI/E;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAS7D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAOvC;AAED;;GAEG;AACH,iBAAS,eAAe,CACtB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAWlB;AAED;;GAEG;AACH,iBAAS,YAAY,CACnB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAYlB;AAED;;GAEG;AACH,iBAAS,cAAc,CACrB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAYlB;AAED;;GAEG;AACH,iBAAS,UAAU,CACjB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAYlB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;CAMjC,CAAC"}

package/dist/diff/snapshot/snapshot-manifest.js

@@ -0,0 +1,113 @@
+import { stringifyPrettyStable } from '@baseplate-dev/utils';
+import { handleFileNotFoundError, readJsonWithSchema, } from '@baseplate-dev/utils/node';
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { SNAPSHOT_VERSION, snapshotManifestSchema } from './snapshot-types.js';
+/**
+ * Creates a new snapshot manifest
+ */
+export function initializeSnapshotManifest() {
+    return {
+        version: SNAPSHOT_VERSION,
+        files: {
+            modified: [],
+            added: [],
+            deleted: [],
+        },
+    };
+}
+/**
+ * Saves a manifest to the snapshot directory
+ */
+export async function saveSnapshotManifest(snapshotDirectory, manifest) {
+    const sortedManifest = {
+        version: manifest.version,
+        files: {
+            added: manifest.files.added.toSorted(),
+            deleted: manifest.files.deleted.toSorted(),
+            modified: manifest.files.modified.toSorted((a, b) => a.path.localeCompare(b.path)),
+        },
+    };
+    const manifestContent = stringifyPrettyStable(sortedManifest);
+    await mkdir(path.dirname(snapshotDirectory.manifestPath), {
+        recursive: true,
+    });
+    await writeFile(snapshotDirectory.manifestPath, manifestContent, 'utf8');
+}
+/**
+ * Loads a manifest from the snapshot directory
+ */
+export async function loadSnapshotManifest(snapshotDirectory) {
+    const manifestData = await readJsonWithSchema(snapshotDirectory.manifestPath, snapshotManifestSchema).catch(handleFileNotFoundError);
+    return manifestData;
+}
+/**
+ * Adds a modified file entry to the manifest
+ */
+function addModifiedFile(manifest, filePath, diffFile) {
+    return {
+        ...manifest,
+        files: {
+            ...manifest.files,
+            modified: [
+                ...manifest.files.modified.filter((entry) => entry.path !== filePath),
+                { path: filePath, diffFile },
+            ],
+        },
+    };
+}
+/**
+ * Adds an added file to the manifest
+ */
+function addAddedFile(manifest, filePath) {
+    if (manifest.files.added.includes(filePath)) {
+        return manifest;
+    }
+    return {
+        ...manifest,
+        files: {
+            ...manifest.files,
+            added: [...manifest.files.added, filePath],
+        },
+    };
+}
+/**
+ * Adds a deleted file to the manifest
+ */
+function addDeletedFile(manifest, filePath) {
+    if (manifest.files.deleted.includes(filePath)) {
+        return manifest;
+    }
+    return {
+        ...manifest,
+        files: {
+            ...manifest.files,
+            deleted: [...manifest.files.deleted, filePath],
+        },
+    };
+}
+/**
+ * Removes a file from the manifest
+ */
+function removeFile(manifest, filePath) {
+    return {
+        ...manifest,
+        files: {
+            ...manifest.files,
+            modified: manifest.files.modified.filter((entry) => entry.path !== filePath),
+            added: manifest.files.added.filter((path) => path !== filePath),
+            deleted: manifest.files.deleted.filter((path) => path !== filePath),
+        },
+    };
+}
+/**
+ * Utilities for working with snapshot manifests
+ */
+export const snapshotManifestUtils = {
+    // Immutable file operations (return new manifest)
+    addModifiedFile,
+    addAddedFile,
+    addDeletedFile,
+    removeFile,
+};
+//# sourceMappingURL=snapshot-manifest.js.map

package/dist/diff/snapshot/snapshot-manifest.js.map

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

package/dist/diff/snapshot/snapshot-types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Types and interfaces for the structured directory snapshot system
+ */
+import { z } from 'zod';
+import type { FileDiff } from '../types.js';
+export interface SnapshotManifest {
+    /** Version of the snapshot format */
+    version: string;
+    /** Categorized list of files in the snapshot */
+    files: SnapshotFiles;
+}
+export interface SnapshotFiles {
+    /** Files that were modified (have diffs stored) */
+    modified: ModifiedFileEntry[];
+    /** Files that were added (exist in generated but not working) */
+    added: string[];
+    /** Files that were deleted (exist in working but not generated) */
+    deleted: string[];
+}
+export interface ModifiedFileEntry {
+    /** Relative path to the file */
+    path: string;
+    /** Name of the diff file in the diffs/ directory */
+    diffFile: string;
+}
+export interface SnapshotDirectory {
+    /** Path to the snapshot directory */
+    path: string;
+    /** Path to the manifest.json file */
+    manifestPath: string;
+    /** Path to the diffs/ subdirectory */
+    diffsPath: string;
+}
+export interface SnapshotOptions {
+    /** Custom name for the snapshot directory (default: .baseplate-snapshot) */
+    snapshotDir?: string;
+    /** Whether to use strict comparison mode */
+    strict?: boolean;
+}
+export interface SnapshotComparison {
+    /** Files that have new differences not in the snapshot */
+    newDifferences: FileDiff[];
+    /** Files that match the expected snapshot */
+    expectedDifferences: FileDiff[];
+    /** Files that were expected in snapshot but are missing */
+    missingExpected: string[];
+}
+export interface CompareSnapshotResult {
+    /** Comparison results */
+    comparison: SnapshotComparison;
+    /** Whether the comparison passed (no new differences) */
+    passed: boolean;
+    /** Summary message describing the results */
+    summary: string;
+}
+export interface ApplySnapshotResult {
+    /** Number of patches successfully applied */
+    appliedPatches: number;
+    /** Number of patches that failed */
+    failedPatches: number;
+    /** Details of any failures */
+    failures: PatchFailure[];
+}
+export interface PatchFailure {
+    /** Path to the file that failed to patch */
+    filePath: string;
+    /** Error message describing the failure */
+    error: string;
+    /** The diff content that failed to apply */
+    diffContent: string;
+}
+export declare const SNAPSHOT_VERSION = "1";
+export declare const DEFAULT_SNAPSHOT_DIR = ".baseplate-snapshot";
+export declare const MANIFEST_FILENAME = "manifest.json";
+export declare const DIFFS_DIRNAME = "diffs";
+export declare const modifiedFileEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    diffFile: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    diffFile: string;
+}, {
+    path: string;
+    diffFile: string;
+}>;
+export declare const snapshotFilesSchema: z.ZodObject<{
+    modified: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        diffFile: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        diffFile: string;
+    }, {
+        path: string;
+        diffFile: string;
+    }>, "many">;
+    added: z.ZodArray<z.ZodString, "many">;
+    deleted: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    added: string[];
+    modified: {
+        path: string;
+        diffFile: string;
+    }[];
+    deleted: string[];
+}, {
+    added: string[];
+    modified: {
+        path: string;
+        diffFile: string;
+    }[];
+    deleted: string[];
+}>;
+export declare const snapshotManifestSchema: z.ZodObject<{
+    version: z.ZodString;
+    files: z.ZodObject<{
+        modified: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            diffFile: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            diffFile: string;
+        }, {
+            path: string;
+            diffFile: string;
+        }>, "many">;
+        added: z.ZodArray<z.ZodString, "many">;
+        deleted: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        added: string[];
+        modified: {
+            path: string;
+            diffFile: string;
+        }[];
+        deleted: string[];
+    }, {
+        added: string[];
+        modified: {
+            path: string;
+            diffFile: string;
+        }[];
+        deleted: string[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    files: {
+        added: string[];
+        modified: {
+            path: string;
+            diffFile: string;
+        }[];
+        deleted: string[];
+    };
+}, {
+    version: string;
+    files: {
+        added: string[];
+        modified: {
+            path: string;
+            diffFile: string;
+        }[];
+        deleted: string[];
+    };
+}>;
+//# sourceMappingURL=snapshot-types.d.ts.map

package/dist/diff/snapshot/snapshot-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-types.d.ts","sourceRoot":"","sources":["../../../src/diff/snapshot/snapshot-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,iEAAiE;IACjE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,mBAAmB,EAAE,QAAQ,EAAE,CAAC;IAChC,2DAA2D;IAC3D,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAC1D,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,eAAO,MAAM,aAAa,UAAU,CAAC;AAGrC,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI9B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjC,CAAC"}

package/dist/diff/snapshot/snapshot-types.js

@@ -0,0 +1,23 @@
+/**
+ * Types and interfaces for the structured directory snapshot system
+ */
+import { z } from 'zod';
+export const SNAPSHOT_VERSION = '1';
+export const DEFAULT_SNAPSHOT_DIR = '.baseplate-snapshot';
+export const MANIFEST_FILENAME = 'manifest.json';
+export const DIFFS_DIRNAME = 'diffs';
+// Zod schemas for validation
+export const modifiedFileEntrySchema = z.object({
+    path: z.string(),
+    diffFile: z.string(),
+});
+export const snapshotFilesSchema = z.object({
+    modified: z.array(modifiedFileEntrySchema),
+    added: z.array(z.string()),
+    deleted: z.array(z.string()),
+});
+export const snapshotManifestSchema = z.object({
+    version: z.string(),
+    files: snapshotFilesSchema,
+});
+//# sourceMappingURL=snapshot-types.js.map

package/dist/diff/snapshot/snapshot-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-types.js","sourceRoot":"","sources":["../../../src/diff/snapshot/snapshot-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+ExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,mBAAmB;CAC3B,CAAC,CAAC"}

package/dist/diff/snapshot/snapshot-utils.d.ts

@@ -0,0 +1,20 @@
+import type { SnapshotDirectory, SnapshotOptions } from './snapshot-types.js';
+/**
+ * Converts a file path to a safe filename for storing diffs
+ * Example: "src/components/button.tsx" -> "src_components_button.tsx.diff"
+ */
+export declare function pathToSafeDiffFilename(filePath: string): string;
+/**
+ * Converts a safe diff filename back to the original file path
+ * Example: "src_components_button.tsx.diff" -> "src/components/button.tsx"
+ */
+export declare function safeDiffFilenameToPath(diffFilename: string): string;
+/**
+ * Creates the snapshot directory structure
+ */
+export declare function createSnapshotDirectory(baseDirectory: string, snapshotDir?: string): Promise<SnapshotDirectory>;
+/**
+ * Resolves the snapshot directory paths without creating them
+ */
+export declare function resolveSnapshotDirectory(baseDirectory: string, options?: SnapshotOptions): SnapshotDirectory;
+//# sourceMappingURL=snapshot-utils.d.ts.map

package/dist/diff/snapshot/snapshot-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-utils.d.ts","sourceRoot":"","sources":["../../../src/diff/snapshot/snapshot-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAQ9E;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,eAAoB,GAC5B,iBAAiB,CAWnB"}

package/dist/diff/snapshot/snapshot-utils.js

@@ -0,0 +1,51 @@
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_SNAPSHOT_DIR, DIFFS_DIRNAME, MANIFEST_FILENAME, } from './snapshot-types.js';
+/**
+ * Converts a file path to a safe filename for storing diffs
+ * Example: "src/components/button.tsx" -> "src_components_button.tsx.diff"
+ */
+export function pathToSafeDiffFilename(filePath) {
+    return `${filePath.replaceAll(/[/\\]/g, '_')}.diff`;
+}
+/**
+ * Converts a safe diff filename back to the original file path
+ * Example: "src_components_button.tsx.diff" -> "src/components/button.tsx"
+ */
+export function safeDiffFilenameToPath(diffFilename) {
+    if (!diffFilename.endsWith('.diff')) {
+        throw new Error(`Invalid diff filename: ${diffFilename}`);
+    }
+    return diffFilename.slice(0, -5).replaceAll('_', '/');
+}
+/**
+ * Creates the snapshot directory structure
+ */
+export async function createSnapshotDirectory(baseDirectory, snapshotDir = DEFAULT_SNAPSHOT_DIR) {
+    const snapshotPath = path.resolve(baseDirectory, snapshotDir);
+    const manifestPath = path.join(snapshotPath, MANIFEST_FILENAME);
+    const diffsPath = path.join(snapshotPath, DIFFS_DIRNAME);
+    // Create the directories
+    await mkdir(snapshotPath, { recursive: true });
+    await mkdir(diffsPath, { recursive: true });
+    return {
+        path: snapshotPath,
+        manifestPath,
+        diffsPath,
+    };
+}
+/**
+ * Resolves the snapshot directory paths without creating them
+ */
+export function resolveSnapshotDirectory(baseDirectory, options = {}) {
+    const snapshotDirName = options.snapshotDir ?? DEFAULT_SNAPSHOT_DIR;
+    const snapshotPath = path.resolve(baseDirectory, snapshotDirName);
+    const manifestPath = path.join(snapshotPath, MANIFEST_FILENAME);
+    const diffsPath = path.join(snapshotPath, DIFFS_DIRNAME);
+    return {
+        path: snapshotPath,
+        manifestPath,
+        diffsPath,
+    };
+}
+//# sourceMappingURL=snapshot-utils.js.map

package/dist/diff/snapshot/snapshot-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-utils.js","sourceRoot":"","sources":["../../../src/diff/snapshot/snapshot-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAoB;IACzD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAqB,EACrB,cAAsB,oBAAoB;IAE1C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAEzD,yBAAyB;IACzB,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY;QACZ,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAqB,EACrB,UAA2B,EAAE;IAE7B,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAEzD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY;QACZ,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/diff/types.d.ts

@@ -1,11 +1,42 @@
-export interface FileDiff {
+interface BaseFileDiff {
     path: string;
-    type: 'added' | 'modified' | 'deleted';
-    generatedContent?: string | Buffer;
-    workingContent?: string | Buffer;
-    isBinary: boolean;
-    unifiedDiff?: string;
 }
+interface AddedFileDiff extends BaseFileDiff {
+    type: 'added';
+    isBinary: false;
+    workingContent: string;
+    unifiedDiff: string;
+}
+interface AddedFileBinaryDiff extends BaseFileDiff {
+    type: 'added';
+    isBinary: true;
+    workingContent: Buffer;
+}
+interface ModifiedFileDiff extends BaseFileDiff {
+    type: 'modified';
+    isBinary: false;
+    generatedContent: string;
+    workingContent: string;
+    unifiedDiff: string;
+}
+interface ModifiedFileBinaryDiff extends BaseFileDiff {
+    type: 'modified';
+    isBinary: true;
+    generatedContent: Buffer;
+    workingContent: Buffer;
+}
+interface DeletedFileDiff extends BaseFileDiff {
+    type: 'deleted';
+    isBinary: false;
+    generatedContent: string;
+    unifiedDiff: string;
+}
+interface DeletedFileBinaryDiff extends BaseFileDiff {
+    type: 'deleted';
+    isBinary: true;
+    generatedContent: Buffer;
+}
+export type FileDiff = AddedFileDiff | AddedFileBinaryDiff | ModifiedFileDiff | ModifiedFileBinaryDiff | DeletedFileDiff | DeletedFileBinaryDiff;
 export interface DiffSummary {
     totalFiles: number;
     addedFiles: number;
@@ -19,4 +50,5 @@ export interface DiffOptions {
     globPatterns?: string[];
     useIgnoreFile?: boolean;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map