azul-sync 1.3.0

package/dist/fs/treeManager.js

@@ -0,0 +1,365 @@
+import { log } from "../util/log.js";
+/**
+ * Manages the in-memory representation of Studio's DataModel
+ */
+export class TreeManager {
+    nodes = new Map();
+    pathIndex = new Map(); // pathKey → TreeNodes (same name siblings supported)
+    root = null;
+    pathKey(path) {
+        return path.join("\u0000");
+    }
+    addToPathIndex(node) {
+        const key = this.pathKey(node.path);
+        const bucket = this.pathIndex.get(key) ?? new Set();
+        bucket.add(node);
+        this.pathIndex.set(key, bucket);
+    }
+    removeFromPathIndex(node) {
+        const key = this.pathKey(node.path);
+        const bucket = this.pathIndex.get(key);
+        if (!bucket)
+            return;
+        bucket.delete(node);
+        if (bucket.size === 0) {
+            this.pathIndex.delete(key);
+        }
+    }
+    registerSubtree(node) {
+        const stack = [node];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            this.addToPathIndex(current);
+            for (const child of current.children.values()) {
+                stack.push(child);
+            }
+        }
+    }
+    unregisterSubtree(node) {
+        const stack = [node];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            this.removeFromPathIndex(current);
+            for (const child of current.children.values()) {
+                stack.push(child);
+            }
+        }
+    }
+    updateInstance(instance) {
+        const existing = this.nodes.get(instance.guid);
+        const hasParentHint = instance.parentGuid !== undefined;
+        const incomingParentGuid = hasParentHint
+            ? (instance.parentGuid ?? null)
+            : null;
+        if (existing) {
+            const prevPath = [...existing.path];
+            const prevName = existing.name;
+            const pathChanged = !this.pathsEqual(existing.path, instance.path);
+            const nameChanged = existing.name !== instance.name;
+            const currentParentGuid = existing.parent?.guid ?? existing.parentGuid ?? null;
+            const nextParentGuid = hasParentHint
+                ? incomingParentGuid
+                : currentParentGuid;
+            const parentChanged = hasParentHint && nextParentGuid !== currentParentGuid;
+            const nextSource = instance.source !== undefined ? instance.source : existing.source;
+            if (pathChanged) {
+                this.unregisterSubtree(existing);
+            }
+            existing.className = instance.className;
+            existing.name = instance.name;
+            existing.path = instance.path;
+            existing.parentGuid = nextParentGuid;
+            existing.source = nextSource;
+            if (pathChanged || nameChanged || parentChanged) {
+                this.reparentNode(existing, instance.path, nextParentGuid);
+                this.recalculateChildPaths(existing);
+                this.registerSubtree(existing);
+            }
+            log.script(`Updated instance: ${instance.path.join("/")}`, "updated");
+            return {
+                node: existing,
+                pathChanged,
+                nameChanged,
+                parentChanged,
+                isNew: false,
+                prevPath,
+                prevName,
+            };
+        }
+        const node = {
+            guid: instance.guid,
+            className: instance.className,
+            name: instance.name,
+            path: instance.path,
+            parentGuid: incomingParentGuid,
+            source: instance.source,
+            children: new Map(),
+        };
+        this.nodes.set(instance.guid, node);
+        this.reparentNode(node, instance.path, incomingParentGuid);
+        this.recalculateChildPaths(node);
+        this.registerSubtree(node);
+        log.script(`Created instance: ${instance.path.join("/")}`, "created");
+        return {
+            node,
+            pathChanged: false,
+            nameChanged: false,
+            parentChanged: false,
+            isNew: true,
+        };
+    }
+    /**
+     * Process a full snapshot from Studio
+     */
+    applyFullSnapshot(instances) {
+        log.info(`Processing full snapshot: ${instances.length} instances`);
+        // Clear existing tree
+        this.nodes.clear();
+        this.pathIndex.clear();
+        this.root = null;
+        // First pass: create all nodes
+        for (const instance of instances) {
+            const node = {
+                guid: instance.guid,
+                className: instance.className,
+                name: instance.name,
+                path: instance.path,
+                parentGuid: instance.parentGuid ?? null,
+                source: instance.source,
+                children: new Map(),
+            };
+            this.nodes.set(instance.guid, node);
+            this.addToPathIndex(node);
+            log.debug(`Created node: ${instance.path.join("/")}`);
+        }
+        // Second pass: build hierarchy
+        for (const instance of instances) {
+            const node = this.nodes.get(instance.guid);
+            if (!node)
+                continue;
+            if (instance.path.length === 1) {
+                // This is a root service
+                if (!this.root) {
+                    this.root = {
+                        guid: "root",
+                        className: "DataModel",
+                        name: "game",
+                        path: [],
+                        parentGuid: null,
+                        children: new Map(),
+                    };
+                    this.nodes.set("root", this.root);
+                    this.addToPathIndex(this.root);
+                }
+                this.root.children.set(node.guid, node);
+                node.parent = this.root;
+                node.parentGuid = this.root.guid;
+                log.debug(`Assigned root parent for: ${instance.path.join("/")}`);
+            }
+            else {
+                // Find parent by matching path
+                const parentPath = instance.path.slice(0, -1);
+                const explicitParentGuid = instance.parentGuid ?? null;
+                let parent;
+                if (explicitParentGuid) {
+                    parent = this.nodes.get(explicitParentGuid);
+                }
+                if (!parent) {
+                    parent = this.findNodeByPath(parentPath);
+                }
+                if (parent) {
+                    parent.children.set(node.guid, node);
+                    node.parent = parent;
+                    node.parentGuid = parent.guid;
+                    log.debug(`Assigned parent for: ${instance.path.join("/")}`);
+                }
+                else {
+                    log.warn(`Parent not found for ${instance.path.join("/")}`);
+                }
+            }
+        }
+        log.success(`Tree built: ${this.nodes.size} nodes`);
+    }
+    /**
+     * Update child paths iteratively
+     */
+    recalculateChildPaths(node) {
+        const queue = [...node.children.values()];
+        while (queue.length > 0) {
+            const child = queue.shift();
+            child.path = [...child.parent.path, child.name];
+            for (const grandchild of child.children.values()) {
+                queue.push(grandchild);
+            }
+        }
+    }
+    getDescendantScripts(guid) {
+        const start = this.nodes.get(guid);
+        if (!start) {
+            return [];
+        }
+        const scripts = [];
+        const stack = [...start.children.values()];
+        while (stack.length > 0) {
+            const node = stack.pop();
+            if (this.isScriptNode(node)) {
+                scripts.push(node);
+            }
+            for (const child of node.children.values()) {
+                stack.push(child);
+            }
+        }
+        return scripts;
+    }
+    isScriptNode(node) {
+        return (node.className === "Script" ||
+            node.className === "LocalScript" ||
+            node.className === "ModuleScript");
+    }
+    pathsEqual(a, b) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((segment, idx) => segment === b[idx]);
+    }
+    /**
+     * Delete an instance by GUID
+     */
+    deleteInstance(guid) {
+        const node = this.nodes.get(guid);
+        if (!node) {
+            log.debug(`Delete ignored for missing node: ${guid}`);
+            return null;
+        }
+        // Detach from parent first so no one references this subtree
+        if (node.parent) {
+            node.parent.children.delete(guid);
+        }
+        // Iterative delete to avoid repeated recursion work on large subtrees
+        const stack = [node];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            for (const child of current.children.values()) {
+                stack.push(child);
+            }
+            this.removeFromPathIndex(current);
+            this.nodes.delete(current.guid);
+            // Break references to help GC and prevent accidental reuse
+            current.children.clear();
+            current.parent = undefined;
+        }
+        log.script(`Deleted instance: ${node.path.join("/")}`, "deleted");
+        return node;
+    }
+    /**
+     * Update script source only
+     */
+    updateScriptSource(guid, source) {
+        const node = this.nodes.get(guid);
+        if (node) {
+            node.source = source;
+            log.debug(`Updated script source: ${node.path.join("/")}`);
+        }
+        else {
+            log.warn(`Script not found for GUID: ${guid}`);
+        }
+    }
+    /**
+     * Get a node by GUID
+     */
+    getNode(guid) {
+        return this.nodes.get(guid);
+    }
+    /**
+     * Get all nodes
+     */
+    getAllNodes() {
+        return this.nodes;
+    }
+    /**
+     * Get all script nodes
+     */
+    getScriptNodes() {
+        return Array.from(this.nodes.values()).filter((node) => this.isScriptNode(node));
+    }
+    /**
+     * Find a node by its path
+     */
+    findNodeByPath(path) {
+        const bucket = this.pathIndex.get(this.pathKey(path));
+        if (!bucket || bucket.size === 0) {
+            return undefined;
+        }
+        if (bucket.size === 1) {
+            return bucket.values().next().value;
+        }
+        // Ambiguous path (same-name siblings); caller should use parent GUIDs instead
+        log.debug(`Multiple nodes share path ${path.join("/")}, skipping path lookup`);
+        return undefined;
+    }
+    /**
+     * Re-parent a node based on its path
+     */
+    reparentNode(node, path, parentGuid) {
+        // Remove from old parent
+        if (node.parent) {
+            node.parent.children.delete(node.guid);
+        }
+        // Find new parent (prefer explicit parent GUID when present)
+        let parent;
+        if (parentGuid) {
+            parent = this.nodes.get(parentGuid);
+        }
+        if (!parent) {
+            if (path.length === 1) {
+                // Root service
+                if (!this.root) {
+                    this.root = {
+                        guid: "root",
+                        className: "DataModel",
+                        name: "game",
+                        path: [],
+                        parentGuid: null,
+                        children: new Map(),
+                    };
+                    this.nodes.set("root", this.root);
+                    this.addToPathIndex(this.root);
+                }
+                parent = this.root;
+            }
+            else {
+                const parentPath = path.slice(0, -1);
+                parent = this.findNodeByPath(parentPath);
+            }
+        }
+        if (parent) {
+            parent.children.set(node.guid, node);
+            node.parent = parent;
+            node.parentGuid = parent.guid;
+        }
+        else {
+            log.debug(`Parent not found for re-parenting: ${path.join("/")}`);
+        }
+    }
+    /**
+     * Get tree statistics
+     */
+    getStats() {
+        let scriptCount = 0;
+        let maxDepth = 0;
+        for (const node of this.nodes.values()) {
+            if (this.isScriptNode(node)) {
+                scriptCount += 1;
+            }
+            const depth = node.path.length;
+            if (depth > maxDepth) {
+                maxDepth = depth;
+            }
+        }
+        return {
+            totalNodes: this.nodes.size,
+            scriptNodes: scriptCount,
+            maxDepth,
+        };
+    }
+}
+//# sourceMappingURL=treeManager.js.map

package/dist/fs/treeManager.js.map

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

package/dist/fs/watcher.d.ts

@@ -0,0 +1,39 @@
+export type FileChangeHandler = (filePath: string, source: string) => void;
+/**
+ * Watches the filesystem for changes and notifies handlers
+ */
+export declare class FileWatcher {
+    private watcher;
+    private changeHandler;
+    private debounceTimers;
+    private suppressedUntil;
+    /**
+     * Start watching a directory
+     */
+    watch(directory: string): void;
+    /**
+     * Handle a file change with debouncing
+     */
+    private handleFileChange;
+    /**
+     * Process a file change after debouncing
+     */
+    private processFileChange;
+    /**
+     * Check if a file is a script file
+     */
+    private isScriptFile;
+    /**
+     * Register a handler for file changes
+     */
+    onChange(handler: FileChangeHandler): void;
+    /**
+     * Suppress the next change event for a specific file path (normalized)
+     */
+    suppressNextChange(filePath: string): void;
+    /**
+     * Stop watching
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/fs/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/fs/watcher.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3E;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,eAAe,CAAkC;IAEzD;;OAEG;IACI,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA8BrC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACI,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIjD;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMjD;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAanC"}

package/dist/fs/watcher.js

@@ -0,0 +1,120 @@
+import * as chokidar from "chokidar";
+import * as fs from "fs";
+import * as path from "path";
+import { log } from "../util/log.js";
+import { config } from "../config.js";
+/**
+ * Watches the filesystem for changes and notifies handlers
+ */
+export class FileWatcher {
+    watcher = null;
+    changeHandler = null;
+    debounceTimers = new Map();
+    suppressedUntil = new Map();
+    /**
+     * Start watching a directory
+     */
+    watch(directory) {
+        if (this.watcher) {
+            log.warn("Watcher already running, stopping it first");
+            this.stop();
+        }
+        log.info(`Starting file watcher on: ${directory}`);
+        this.watcher = chokidar.watch(directory, {
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 100,
+                pollInterval: 50,
+            },
+        });
+        this.watcher.on("change", (filePath) => {
+            this.handleFileChange(filePath);
+        });
+        this.watcher.on("error", (error) => {
+            log.error("File watcher error:", error);
+        });
+        this.watcher.on("ready", () => {
+            log.success("File watcher ready");
+        });
+    }
+    /**
+     * Handle a file change with debouncing
+     */
+    handleFileChange(filePath) {
+        // Clear existing timer for this file
+        const existingTimer = this.debounceTimers.get(filePath);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        // Set new debounced timer
+        const timer = setTimeout(() => {
+            this.processFileChange(filePath);
+            this.debounceTimers.delete(filePath);
+        }, config.fileWatchDebounce);
+        this.debounceTimers.set(filePath, timer);
+    }
+    /**
+     * Process a file change after debouncing
+     */
+    processFileChange(filePath) {
+        const normalizedPath = path.resolve(filePath);
+        // Skip if this change was produced by a Studio-originated write
+        const now = Date.now();
+        const suppressUntil = this.suppressedUntil.get(normalizedPath);
+        if (suppressUntil && suppressUntil > now) {
+            log.debug(`File change suppressed (Studio-originated): ${normalizedPath}`);
+            return;
+        }
+        // Only process script files
+        if (!this.isScriptFile(filePath)) {
+            return;
+        }
+        try {
+            const source = fs.readFileSync(filePath, "utf-8");
+            log.debug(`File changed: ${normalizedPath}`);
+            if (this.changeHandler) {
+                this.changeHandler(normalizedPath, source);
+            }
+        }
+        catch (error) {
+            log.error(`Failed to read changed file ${filePath}:`, error);
+        }
+    }
+    /**
+     * Check if a file is a script file
+     */
+    isScriptFile(filePath) {
+        return filePath.endsWith(".lua") || filePath.endsWith(".luau");
+    }
+    /**
+     * Register a handler for file changes
+     */
+    onChange(handler) {
+        this.changeHandler = handler;
+    }
+    /**
+     * Suppress the next change event for a specific file path (normalized)
+     */
+    suppressNextChange(filePath) {
+        const normalizedPath = path.resolve(filePath);
+        const until = Date.now() + 1000; // 1s window to absorb duplicate events
+        this.suppressedUntil.set(normalizedPath, until);
+    }
+    /**
+     * Stop watching
+     */
+    async stop() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+            log.info("File watcher stopped");
+        }
+        // Clear all pending timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/fs/watcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Main orchestrator for the Azul daemon
+ */
+export declare class SyncDaemon {
+    private ipc;
+    private httpPolling;
+    private httpServer;
+    private tree;
+    private fileWriter;
+    private fileWatcher;
+    private sourcemapGenerator;
+    private batchDepth;
+    private batchNeedsSourcemapRegen;
+    constructor();
+    /**
+     * Set up all event handlers
+     */
+    private setupHandlers;
+    /**
+     * Handle incoming messages from Studio
+     */
+    private handleStudioMessage;
+    /**
+     * Handle full snapshot from Studio
+     */
+    private handleFullSnapshot;
+    /**
+     * Handle script source change
+     */
+    private handleScriptChanged;
+    /**
+     * Handle instance update (rename, move, etc.)
+     */
+    private handleInstanceUpdated;
+    /**
+     * Handle instance deletion
+     */
+    private handleDeleted;
+    /**
+     * Handle file change from filesystem
+     */
+    private handleFileChange;
+    /**
+     * Regenerate the sourcemap
+     */
+    private regenerateSourcemap;
+    /**
+     * Start the daemon
+     */
+    start(): void;
+    /**
+     * Stop the daemon
+     */
+    stop(): Promise<void>;
+    private isScriptClass;
+    /**
+     * Delete files under syncDir that are not mapped to any instance (opt-in).
+     */
+    private cleanupOrphanFiles;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,wBAAwB,CAAS;;IAwBzC;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6C3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+C7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkErB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA0C3B"}