@baseplate-dev/project-builder-server 0.1.1

package/dist/sync/conflict-file-monitor.js

@@ -0,0 +1,125 @@
+import { differenceSet } from '@baseplate-dev/utils';
+import { fileExists, handleFileNotFoundError } from '@baseplate-dev/utils/node';
+import { watch } from 'chokidar';
+import { produce } from 'immer';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getPackageSyncStatusFromResult } from './utils.js';
+const FS_WATCHER_OPTIONS = {
+    awaitWriteFinish: {
+        stabilityThreshold: 1000,
+    },
+    ignoreInitial: true,
+    // we use polling since fs events has some glitchiness with regards to deleting
+    // the parent directory of a file that is being deleted
+    usePolling: true,
+    interval: 500,
+};
+/**
+ * This class is responsible for monitoring the conflict files and the files that are pending deletion.
+ *
+ * It will update the metadata when the files are resolved.
+ */
+export class ConflictFileMonitor {
+    syncMetadataController;
+    logger;
+    // Start with an empty watched‑set; paths are added via `handleMetadataChange`
+    conflictFileWatcher = watch([], FS_WATCHER_OPTIONS);
+    conflictFiles = new Set();
+    unsubscribers = [];
+    constructor(syncMetadataController, logger) {
+        this.syncMetadataController = syncMetadataController;
+        this.logger = logger;
+    }
+    handleMetadataChange(metadata) {
+        const newConflictFiles = new Set();
+        for (const packageInfo of Object.values(metadata.packages)) {
+            const { result } = packageInfo;
+            if (!result)
+                continue;
+            for (const f of result.filesWithConflicts ?? []) {
+                newConflictFiles.add(path.join(packageInfo.path, f.generatedConflictRelativePath ?? f.relativePath));
+            }
+        }
+        const conflictFilesToWatch = differenceSet(newConflictFiles, this.conflictFiles);
+        this.conflictFileWatcher.add([...conflictFilesToWatch]);
+        // trigger the change event for each file on first load since
+        // chokidar won't trigger the event for files that do not exist
+        for (const filePath of conflictFilesToWatch) {
+            this.handleFileChange(filePath).catch((err) => {
+                this.logger.error(`Error handling conflict file change: ${String(err)}`);
+            });
+        }
+        const conflictFilesToUnwatch = differenceSet(this.conflictFiles, newConflictFiles);
+        this.conflictFileWatcher.unwatch([...conflictFilesToUnwatch]);
+        this.conflictFiles = newConflictFiles;
+    }
+    async checkFileForConflicts(filePath) {
+        try {
+            if (filePath.endsWith('.conflict'))
+                return false;
+            const contents = await readFile(filePath, 'utf8').catch(handleFileNotFoundError);
+            return !contents?.includes('>>>>>>>');
+        }
+        catch (err) {
+            this.logger.error(`Error reading file ${filePath}: ${String(err)}`);
+            return false;
+        }
+    }
+    async handleFileChange(filePath) {
+        const doesFileExist = await fileExists(filePath);
+        const isResolved = !doesFileExist || (await this.checkFileForConflicts(filePath));
+        if (isResolved) {
+            await this.syncMetadataController.updateMetadata(produce((draft) => {
+                for (const packageInfo of Object.values(draft.packages)) {
+                    const relativePath = path.relative(packageInfo.path, filePath);
+                    const filesWithConflicts = packageInfo.result?.filesWithConflicts ?? [];
+                    // strip the file from the list of conflicts
+                    for (let i = filesWithConflicts.length - 1; i >= 0; i--) {
+                        const conflictFile = filesWithConflicts[i];
+                        // if the file is a generated-deleted or working-deleted conflict and it exists, consider it still unresolved
+                        if ((conflictFile.conflictType === 'generated-deleted' ||
+                            conflictFile.conflictType === 'working-deleted') &&
+                            doesFileExist) {
+                            continue;
+                        }
+                        if (conflictFile.generatedConflictRelativePath === relativePath ||
+                            conflictFile.relativePath === relativePath) {
+                            filesWithConflicts.splice(i, 1);
+                        }
+                    }
+                    packageInfo.status = getPackageSyncStatusFromResult(packageInfo.result);
+                }
+            }));
+        }
+    }
+    /**
+     * This method will start the monitor and watch for changes in the metadata.
+     */
+    async start() {
+        const handleConflictFileChange = (event, filePath) => {
+            this.handleFileChange(filePath).catch((err) => {
+                this.logger.error(`Error handling conflict file change: ${String(err)}`);
+            });
+        };
+        this.conflictFileWatcher.on('all', handleConflictFileChange);
+        try {
+            const metadata = await this.syncMetadataController.getMetadata();
+            this.handleMetadataChange(metadata);
+        }
+        catch (err) {
+            this.logger.error(`Error getting initial metadata for conflict file monitor: ${String(err)}`);
+        }
+        this.unsubscribers.push(this.syncMetadataController.on('sync-metadata-changed', this.handleMetadataChange.bind(this)));
+    }
+    /**
+     * This method will stop the monitor and close the watchers.
+     */
+    async stop() {
+        for (const unsubscriber of this.unsubscribers) {
+            unsubscriber();
+        }
+        await this.conflictFileWatcher.close();
+    }
+}
+//# sourceMappingURL=conflict-file-monitor.js.map

package/dist/sync/conflict-file-monitor.js.map

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

package/dist/sync/generate-for-directory.d.ts

@@ -0,0 +1,29 @@
+import type { AppEntry } from '@baseplate-dev/project-builder-lib';
+import type { GeneratorEntry, GeneratorOutput, Logger, PreviousGeneratedPayload, TemplateMetadataOptions } from '@baseplate-dev/sync';
+import { buildGeneratorEntry, executeGeneratorEntry, writeGeneratorOutput } from '@baseplate-dev/sync';
+import type { BaseplateUserConfig } from '#src/user-config/user-config-schema.js';
+import type { PackageSyncResult } from './sync-metadata.js';
+import { writeGeneratorSteps } from './generator-steps-writer.js';
+interface GenerateForDirectoryOptions {
+    baseDirectory: string;
+    appEntry: AppEntry;
+    logger: Logger;
+    writeTemplateMetadataOptions?: TemplateMetadataOptions;
+    userConfig: BaseplateUserConfig;
+    previousPackageSyncResult: PackageSyncResult | undefined;
+    operations?: GeneratorOperations;
+    abortSignal?: AbortSignal;
+    skipCommands?: boolean;
+}
+export interface GeneratorOperations {
+    buildGeneratorEntry: typeof buildGeneratorEntry;
+    executeGeneratorEntry: typeof executeGeneratorEntry;
+    getPreviousGeneratedPayload: typeof getPreviousGeneratedPayload;
+    writeGeneratorOutput: typeof writeGeneratorOutput;
+    writeMetadata: (project: GeneratorEntry, output: GeneratorOutput, projectDirectory: string) => Promise<void>;
+    writeGeneratorSteps: typeof writeGeneratorSteps;
+}
+declare function getPreviousGeneratedPayload(projectDirectory: string): Promise<PreviousGeneratedPayload | undefined>;
+export declare function generateForDirectory({ baseDirectory, appEntry, logger, writeTemplateMetadataOptions, userConfig, previousPackageSyncResult, operations, abortSignal, skipCommands, }: GenerateForDirectoryOptions): Promise<PackageSyncResult>;
+export {};
+//# sourceMappingURL=generate-for-directory.d.ts.map

package/dist/sync/generate-for-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-for-directory.d.ts","sourceRoot":"","sources":["../../src/sync/generate-for-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAEV,cAAc,EACd,eAAe,EACf,MAAM,EACN,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EAInB,qBAAqB,EACrB,oBAAoB,EAGrB,MAAM,qBAAqB,CAAC;AAa7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,UAAU,2BAA2B;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B,CAAC,EAAE,uBAAuB,CAAC;IACvD,UAAU,EAAE,mBAAmB,CAAC;IAChC,yBAAyB,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACzD,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,qBAAqB,EAAE,OAAO,qBAAqB,CAAC;IACpD,2BAA2B,EAAE,OAAO,2BAA2B,CAAC;IAChE,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,aAAa,EAAE,CACb,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,eAAe,EACvB,gBAAgB,EAAE,MAAM,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;CACjD;AAyCD,iBAAe,2BAA2B,CACxC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAe/C;AAED,wBAAsB,oBAAoB,CAAC,EACzC,aAAa,EACb,QAAQ,EACR,MAAM,EACN,4BAA4B,EAC5B,UAAU,EACV,yBAAyB,EACzB,UAAuC,EACvC,WAAW,EACX,YAAY,GACb,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+H1D"}

package/dist/sync/generate-for-directory.js

@@ -0,0 +1,132 @@
+import { buildGeneratorEntry, CancelledSyncError, createCodebaseFileReaderFromDirectory, deleteMetadataFiles, executeGeneratorEntry, writeGeneratorOutput, writeGeneratorsMetadata, writeTemplateMetadata, } from '@baseplate-dev/sync';
+import { enhanceErrorWithContext, randomUid } from '@baseplate-dev/utils';
+import { dirExists, handleFileNotFoundError, readJsonWithSchema, writeJson, } from '@baseplate-dev/utils/node';
+import chalk from 'chalk';
+import { mkdir, rename, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { writeGeneratorSteps } from './generator-steps-writer.js';
+const defaultGeneratorOperations = {
+    buildGeneratorEntry,
+    executeGeneratorEntry,
+    getPreviousGeneratedPayload,
+    writeGeneratorOutput,
+    writeMetadata: async (project, output, projectDirectory) => {
+        await deleteMetadataFiles(projectDirectory);
+        await writeGeneratorsMetadata(project, projectDirectory);
+        await writeTemplateMetadata(output.files, projectDirectory);
+    },
+    writeGeneratorSteps,
+};
+const GENERATED_DIRECTORY = 'baseplate/.clean';
+const FILE_ID_MAP_PATH = 'baseplate/file-id-map.json';
+async function getPreviousGeneratedFileIdMap(projectDirectory) {
+    const generatedFileIdMapPath = path.join(projectDirectory, FILE_ID_MAP_PATH);
+    try {
+        const fileIdMap = await readJsonWithSchema(generatedFileIdMapPath, z.record(z.string(), z.string())).catch(handleFileNotFoundError);
+        if (!fileIdMap) {
+            return new Map();
+        }
+        return new Map(Object.entries(fileIdMap));
+    }
+    catch (err) {
+        throw enhanceErrorWithContext(err, `Failed to get previous generated file id map (${generatedFileIdMapPath})`);
+    }
+}
+async function getPreviousGeneratedPayload(projectDirectory) {
+    const generatedDirectory = path.join(projectDirectory, GENERATED_DIRECTORY);
+    const previousDirectoryExists = await dirExists(generatedDirectory);
+    if (!previousDirectoryExists) {
+        return undefined;
+    }
+    const fileIdMap = await getPreviousGeneratedFileIdMap(projectDirectory);
+    return {
+        fileReader: createCodebaseFileReaderFromDirectory(generatedDirectory),
+        fileIdToRelativePathMap: fileIdMap,
+    };
+}
+export async function generateForDirectory({ baseDirectory, appEntry, logger, writeTemplateMetadataOptions, userConfig, previousPackageSyncResult, operations = defaultGeneratorOperations, abortSignal, skipCommands, }) {
+    const { appDirectory, name, generatorBundle } = appEntry;
+    const projectDirectory = path.join(baseDirectory, appDirectory);
+    logger.info(`Generating project ${name} in ${projectDirectory}...`);
+    const project = await operations.buildGeneratorEntry(generatorBundle);
+    const output = await operations.executeGeneratorEntry(project, {
+        templateMetadataOptions: writeTemplateMetadataOptions,
+    });
+    if (abortSignal?.aborted)
+        throw new CancelledSyncError();
+    logger.info('Project built! Writing output....');
+    // load clean directory contents
+    const previousGeneratedPayload = await operations.getPreviousGeneratedPayload(projectDirectory);
+    if (previousGeneratedPayload) {
+        logger.debug('Detected generated folder. Attempting 3-way merge...');
+    }
+    const generatedTemporaryDirectory = path.join(projectDirectory, 'baseplate/build/generated_tmp');
+    await mkdir(generatedTemporaryDirectory, { recursive: true });
+    try {
+        const { failedCommands, filesWithConflicts, fileIdToRelativePathMap } = await operations.writeGeneratorOutput(output, projectDirectory, {
+            previousGeneratedPayload,
+            generatedContentsDirectory: generatedTemporaryDirectory,
+            rerunCommands: previousPackageSyncResult?.failedCommands?.map((c) => c.command),
+            logger,
+            mergeDriver: userConfig.sync?.customMergeDriver
+                ? {
+                    name: 'baseplate-custom-merge-driver',
+                    driver: userConfig.sync.customMergeDriver,
+                }
+                : undefined,
+            abortSignal,
+            skipCommands,
+        });
+        // write metadata to the generated directory
+        if (writeTemplateMetadataOptions?.includeTemplateMetadata) {
+            await operations.writeMetadata(project, output, projectDirectory);
+        }
+        // swap out generated directory with generated_tmp
+        const generatedDirectory = path.join(projectDirectory, GENERATED_DIRECTORY);
+        if (previousGeneratedPayload) {
+            await rm(generatedDirectory, { recursive: true });
+        }
+        await rename(generatedTemporaryDirectory, generatedDirectory);
+        // Write file ID map
+        const fileIdMap = Object.fromEntries([...fileIdToRelativePathMap.entries()].sort(([a], [b]) => a.localeCompare(b)));
+        await writeJson(path.join(projectDirectory, FILE_ID_MAP_PATH), fileIdMap);
+        // Write generator steps
+        if (userConfig.sync?.writeGeneratorStepsJson && output.metadata) {
+            await operations.writeGeneratorSteps(output.metadata, projectDirectory);
+        }
+        // List out conflicts
+        function warnAboutConflicts(conflicts, message) {
+            if (conflicts.length === 0) {
+                return;
+            }
+            logger.warn(chalk.red(`${message}\n${conflicts.map((f) => f.relativePath).join('\n')}`));
+        }
+        warnAboutConflicts(filesWithConflicts.filter((f) => f.conflictType === 'merge-conflict'), 'Merge conflicts occurred while writing files:');
+        warnAboutConflicts(filesWithConflicts.filter((f) => f.conflictType === 'generated-deleted'), 'Files were deleted in the new generation but were modified by user so could not be automatically deleted:');
+        warnAboutConflicts(filesWithConflicts.filter((f) => f.conflictType === 'working-deleted'), 'Files were deleted by user but were added back in the new generation so should be reviewed:');
+        if (failedCommands.length > 0) {
+            logger.error(`Project successfully written but with failed commands! Please check logs for more info.`);
+        }
+        else {
+            logger.info('Project successfully generated!');
+        }
+        return {
+            filesWithConflicts,
+            failedCommands: failedCommands.map((c) => ({
+                id: randomUid(),
+                command: c.command,
+                workingDir: c.workingDir,
+                output: c.output,
+            })),
+            completedAt: new Date().toISOString(),
+        };
+    }
+    finally {
+        // attempt to remove any temporary directory
+        await rm(generatedTemporaryDirectory, { recursive: true }).catch(() => {
+            /* ignore errors */
+        });
+    }
+}
+//# sourceMappingURL=generate-for-directory.js.map

package/dist/sync/generate-for-directory.js.map

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

package/dist/sync/generator-steps-writer.d.ts

@@ -0,0 +1,3 @@
+import type { GeneratorOutputMetadata } from '@baseplate-dev/sync';
+export declare function writeGeneratorSteps(metadata: GeneratorOutputMetadata, outputDirectory: string): Promise<void>;
+//# sourceMappingURL=generator-steps-writer.d.ts.map

package/dist/sync/generator-steps-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-steps-writer.d.ts","sourceRoot":"","sources":["../../src/sync/generator-steps-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAKnE,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,uBAAuB,EACjC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/sync/generator-steps-writer.js

@@ -0,0 +1,6 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export async function writeGeneratorSteps(metadata, outputDirectory) {
+    await fs.writeFile(path.join(outputDirectory, 'baseplate/build/generator-steps.json'), JSON.stringify(metadata, null, 2));
+}
+//# sourceMappingURL=generator-steps-writer.js.map

package/dist/sync/generator-steps-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-steps-writer.js","sourceRoot":"","sources":["../../src/sync/generator-steps-writer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAiC,EACjC,eAAuB;IAEvB,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,sCAAsC,CAAC,EAClE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAClC,CAAC;AACJ,CAAC"}

package/dist/sync/index.d.ts

@@ -0,0 +1,4 @@
+export * from './build-project.js';
+export * from './generate-for-directory.js';
+export * from './sync-metadata.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,4 @@
+export * from './build-project.js';
+export * from './generate-for-directory.js';
+export * from './sync-metadata.js';
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}

package/dist/sync/sync-metadata-controller.d.ts

@@ -0,0 +1,29 @@
+import type { Logger } from '@baseplate-dev/sync';
+import { TypedEventEmitter } from '@baseplate-dev/utils';
+import { type PackageSyncInfo, type SyncMetadata } from './sync-metadata.js';
+/**
+ * Controller for getting updates about the latest sync metadata.
+ * Uses throttling to coalesce multiple write calls into a single save.
+ */
+export declare class SyncMetadataController extends TypedEventEmitter<{
+    ['sync-metadata-changed']: SyncMetadata;
+}> {
+    protected readonly projectDirectory: string;
+    protected logger: Logger;
+    protected options: {
+        disableThrottling?: boolean;
+    };
+    protected syncMetadata: SyncMetadata | undefined;
+    private readonly throttledWrite;
+    constructor(projectDirectory: string, logger: Logger, options?: {
+        disableThrottling?: boolean;
+    });
+    private getMetadataPath;
+    readSyncMetadata(): Promise<SyncMetadata>;
+    watchMetadata(): () => void;
+    getMetadata(): Promise<SyncMetadata>;
+    writeMetadata(syncMetadata: SyncMetadata): void;
+    updateMetadataForPackage(packageId: string, update: (metadata: PackageSyncInfo) => PackageSyncInfo): Promise<void>;
+    updateMetadata(update: (metadata: SyncMetadata) => SyncMetadata): Promise<void>;
+}
+//# sourceMappingURL=sync-metadata-controller.d.ts.map

package/dist/sync/sync-metadata-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-metadata-controller.d.ts","sourceRoot":"","sources":["../../src/sync/sync-metadata-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAEL,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB,CAAC;IAC5D,CAAC,uBAAuB,CAAC,EAAE,YAAY,CAAC;CACzC,CAAC;IAME,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IAC3C,SAAS,CAAC,MAAM,EAAE,MAAM;IACxB,SAAS,CAAC,OAAO,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE;IAPpD,SAAS,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;gBAG7C,gBAAgB,EAAE,MAAM,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAO;IAiBzD,OAAO,CAAC,eAAe;IAIjB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC;IAgB/C,aAAa,IAAI,MAAM,IAAI;IAyBrB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAM1C,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAKzC,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,eAAe,GACrD,OAAO,CAAC,IAAI,CAAC;IAiBV,cAAc,CAClB,MAAM,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,YAAY,GAC/C,OAAO,CAAC,IAAI,CAAC;CAKjB"}

package/dist/sync/sync-metadata-controller.js

@@ -0,0 +1,95 @@
+import { enhanceErrorWithContext, TypedEventEmitter, } from '@baseplate-dev/utils';
+import { watch } from 'chokidar';
+import { isEqual, throttle } from 'es-toolkit';
+import path from 'node:path';
+import { readSyncMetadata, SYNC_METADATA_PATH, writeSyncMetadata, } from './sync-metadata-service.js';
+import { INITIAL_SYNC_METADATA, } from './sync-metadata.js';
+/**
+ * Controller for getting updates about the latest sync metadata.
+ * Uses throttling to coalesce multiple write calls into a single save.
+ */
+export class SyncMetadataController extends TypedEventEmitter {
+    projectDirectory;
+    logger;
+    options;
+    syncMetadata;
+    throttledWrite;
+    constructor(projectDirectory, logger, options = {}) {
+        super();
+        this.projectDirectory = projectDirectory;
+        this.logger = logger;
+        this.options = options;
+        const writeCallback = (metadata) => {
+            // we emit the event before writing since we cache the metadata in memory
+            this.emit('sync-metadata-changed', metadata);
+            writeSyncMetadata(this.projectDirectory, metadata).catch((err) => {
+                this.logger.error(`Failed to write metadata: ${String(err)}`);
+            });
+        };
+        this.throttledWrite = options.disableThrottling
+            ? writeCallback
+            : throttle(writeCallback, 100);
+    }
+    getMetadataPath() {
+        return path.resolve(this.projectDirectory, SYNC_METADATA_PATH);
+    }
+    async readSyncMetadata() {
+        return readSyncMetadata(this.projectDirectory).catch((err) => {
+            if (err instanceof TypeError) {
+                this.logger.warn(`Invalid sync metadata found in ${this.getMetadataPath()}. Will use default metadata instead.`);
+                this.logger.warn(err.message);
+                return structuredClone(INITIAL_SYNC_METADATA);
+            }
+            throw enhanceErrorWithContext(err, `Failed to read sync metadata from ${this.getMetadataPath()}`);
+        });
+    }
+    watchMetadata() {
+        const watcher = watch(this.getMetadataPath(), { awaitWriteFinish: true });
+        const handleMetadataChange = () => {
+            this.readSyncMetadata()
+                .then((metadata) => {
+                if (!isEqual(metadata, this.syncMetadata)) {
+                    this.syncMetadata = metadata;
+                    this.emit('sync-metadata-changed', metadata);
+                }
+            })
+                .catch((err) => {
+                this.logger.error(`Failed to update sync metadata: ${String(err)}`);
+            });
+        };
+        watcher.on('all', handleMetadataChange);
+        return () => {
+            watcher.close().catch((err) => {
+                this.logger.error(`Failed to close metadata watcher: ${String(err)}`);
+            });
+        };
+    }
+    async getMetadata() {
+        this.syncMetadata ??= await this.readSyncMetadata();
+        return this.syncMetadata;
+    }
+    writeMetadata(syncMetadata) {
+        this.syncMetadata = syncMetadata;
+        this.throttledWrite(syncMetadata);
+    }
+    async updateMetadataForPackage(packageId, update) {
+        const metadata = await this.getMetadata();
+        if (!(packageId in metadata.packages)) {
+            throw new Error(`No package metadata found for ${packageId}`);
+        }
+        const updatedMetadata = {
+            ...metadata,
+            packages: {
+                ...metadata.packages,
+                [packageId]: update(metadata.packages[packageId]),
+            },
+        };
+        this.writeMetadata(updatedMetadata);
+    }
+    async updateMetadata(update) {
+        const metadata = await this.getMetadata();
+        const updatedMetadata = update(metadata);
+        this.writeMetadata(updatedMetadata);
+    }
+}
+//# sourceMappingURL=sync-metadata-controller.js.map

package/dist/sync/sync-metadata-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-metadata-controller.js","sourceRoot":"","sources":["../../src/sync/sync-metadata-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,GAGtB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,iBAE1C;IAMqB;IACT;IACA;IAPF,YAAY,CAA2B;IAEhC,cAAc,CAAmC;IAElE,YACqB,gBAAwB,EACjC,MAAc,EACd,UAA2C,EAAE;QAEvD,KAAK,EAAE,CAAC;QAJW,qBAAgB,GAAhB,gBAAgB,CAAQ;QACjC,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAsC;QAGvD,MAAM,aAAa,GAAG,CAAC,QAAsB,EAAQ,EAAE;YACrD,yEAAyE;YACzE,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;YAC7C,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,KAAK,CACtD,CAAC,GAAY,EAAE,EAAE;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC,CACF,CAAC;QACJ,CAAC,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,iBAAiB;YAC7C,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IAEO,eAAe;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACpE,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,kCAAkC,IAAI,CAAC,eAAe,EAAE,sCAAsC,CAC/F,CAAC;gBACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,OAAO,eAAe,CAAC,qBAAqB,CAAC,CAAC;YAChD,CAAC;YACD,MAAM,uBAAuB,CAC3B,GAAG,EACH,qCAAqC,IAAI,CAAC,eAAe,EAAE,EAAE,CAC9D,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,aAAa;QACX,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1E,MAAM,oBAAoB,GAAG,GAAS,EAAE;YACtC,IAAI,CAAC,gBAAgB,EAAE;iBACpB,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACjB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC1C,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;oBAC7B,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;QAExC,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACxE,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAEpD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,aAAa,CAAC,YAA0B;QACtC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC5B,SAAiB,EACjB,MAAsD;QAEtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,eAAe,GAAiB;YACpC,GAAG,QAAQ;YACX,QAAQ,EAAE;gBACR,GAAG,QAAQ,CAAC,QAAQ;gBACpB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;aAClD;SACF,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAAgD;QAEhD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/sync/sync-metadata-service.d.ts

@@ -0,0 +1,20 @@
+import type { SyncMetadata } from './sync-metadata.js';
+/**
+ * The path to the sync metadata file.
+ */
+export declare const SYNC_METADATA_PATH: string;
+/**
+ * Reads the sync metadata from the project directory.
+ *
+ * @param projectDirectory The directory of the project.
+ * @returns The sync metadata or a default object if the file does not exist.
+ */
+export declare function readSyncMetadata(projectDirectory: string): Promise<SyncMetadata>;
+/**
+ * Writes the sync metadata to the project directory.
+ *
+ * @param projectDirectory The directory of the project.
+ * @param syncMetadata The sync metadata to write.
+ */
+export declare function writeSyncMetadata(projectDirectory: string, syncMetadata: SyncMetadata): Promise<void>;
+//# sourceMappingURL=sync-metadata-service.d.ts.map

package/dist/sync/sync-metadata-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-metadata-service.d.ts","sourceRoot":"","sources":["../../src/sync/sync-metadata-service.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAI9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/sync/sync-metadata-service.js

@@ -0,0 +1,31 @@
+import { handleFileNotFoundError, readJsonWithSchema, writeStablePrettyJson, } from '@baseplate-dev/utils/node';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { INITIAL_SYNC_METADATA, syncMetadataSchema } from './sync-metadata.js';
+/**
+ * The path to the sync metadata file.
+ */
+export const SYNC_METADATA_PATH = path.join('baseplate', '.build', 'sync_result.json');
+/**
+ * Reads the sync metadata from the project directory.
+ *
+ * @param projectDirectory The directory of the project.
+ * @returns The sync metadata or a default object if the file does not exist.
+ */
+export async function readSyncMetadata(projectDirectory) {
+    const syncMetadataPath = path.join(projectDirectory, SYNC_METADATA_PATH);
+    const syncMetadata = await readJsonWithSchema(syncMetadataPath, syncMetadataSchema).catch(handleFileNotFoundError);
+    return syncMetadata ?? structuredClone(INITIAL_SYNC_METADATA);
+}
+/**
+ * Writes the sync metadata to the project directory.
+ *
+ * @param projectDirectory The directory of the project.
+ * @param syncMetadata The sync metadata to write.
+ */
+export async function writeSyncMetadata(projectDirectory, syncMetadata) {
+    const syncMetadataPath = path.join(projectDirectory, SYNC_METADATA_PATH);
+    await mkdir(path.dirname(syncMetadataPath), { recursive: true });
+    await writeStablePrettyJson(syncMetadataPath, syncMetadata);
+}
+//# sourceMappingURL=sync-metadata-service.js.map

package/dist/sync/sync-metadata-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-metadata-service.js","sourceRoot":"","sources":["../../src/sync/sync-metadata-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CACzC,WAAW,EACX,QAAQ,EACR,kBAAkB,CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,gBAAwB;IAExB,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAC3C,gBAAgB,EAChB,kBAAkB,CACnB,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAEjC,OAAO,YAAY,IAAI,eAAe,CAAC,qBAAqB,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,gBAAwB,EACxB,YAA0B;IAE1B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IACzE,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,qBAAqB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;AAC9D,CAAC"}