@tenonhq/sincronia-core 0.0.76 → 0.0.77

package/dist/Watcher.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startWatching = startWatching;
+exports.stopWatching = stopWatching;
+const chokidar_1 = __importDefault(require("chokidar"));
+const logMessages_1 = require("./logMessages");
+const Logger_1 = require("./Logger");
+const lodash_1 = require("lodash");
+const FileUtils_1 = require("./FileUtils");
+const appUtils_1 = require("./appUtils");
+const recentEdits_1 = require("./recentEdits");
+const DEBOUNCE_MS = 300;
+let pushQueue = [];
+let watcher = undefined;
+const processQueue = (0, lodash_1.debounce)(async () => {
+    if (pushQueue.length > 0) {
+        //dedupe pushes
+        const toProcess = Array.from(new Set([...pushQueue]));
+        pushQueue = [];
+        const fileContexts = toProcess
+            .map(FileUtils_1.getFileContextFromPath)
+            .filter((ctx) => !!ctx);
+        const buildables = (0, appUtils_1.groupAppFiles)(fileContexts);
+        const updateResults = await (0, appUtils_1.pushFiles)(buildables);
+        updateResults.forEach((res, index) => {
+            (0, logMessages_1.logFilePush)(fileContexts[index], res);
+            if (res.success) {
+                (0, recentEdits_1.writeRecentEdit)(fileContexts[index]);
+            }
+        });
+    }
+}, DEBOUNCE_MS);
+function startWatching(directory) {
+    watcher = chokidar_1.default.watch(directory);
+    watcher.on("change", fileChanged);
+    watcher.on("error", (error) => {
+        Logger_1.logger.error(`Watcher error: ${error.message}`);
+    });
+}
+async function fileChanged(path) {
+    pushQueue.push(path);
+    processQueue();
+}
+function stopWatching() {
+    if (watcher) {
+        watcher.close();
+    }
+}

package/dist/allScopesCommands.js

@@ -36,6 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.processScope = processScope;
 exports.initScopesCommand = initScopesCommand;
 exports.watchAllScopesCommand = watchAllScopesCommand;
 const Logger_1 = require("./Logger");

package/dist/config.js

@@ -52,6 +52,7 @@ exports.getDiffPath = getDiffPath;
 exports.getDiffFile = getDiffFile;
 exports.getRefresh = getRefresh;
 exports.getDefaultConfigFile = getDefaultConfigFile;
+exports.generateConfigFile = generateConfigFile;
 exports.loadScopeManifest = loadScopeManifest;
 exports.updateManifest = updateManifest;
 exports.isMultiScopeManifest = isMultiScopeManifest;
@@ -201,6 +202,164 @@ function getDefaultConfigFile() {
     };
     `.trim();
 }
+/**
+ * @description Generates a full sinc.config.js with multi-scope support, table whitelist,
+ * field type overrides, and plugin rules. Used by sinc init when creating a new config.
+ * @param {Object} params - Configuration parameters
+ * @param {Array<{scope: string, sourceDirectory: string}>} params.scopes - Selected scopes with source directories
+ * @returns {string} Complete sinc.config.js file content
+ */
+function generateConfigFile(params) {
+    var scopeEntries = params.scopes.map(function (s) {
+        return "\t\t" + s.scope + ": {\n\t\t\tsourceDirectory: \"" + s.sourceDirectory + "\",\n\t\t},";
+    }).join("\n");
+    return "module.exports = {\n" +
+        "\tsourceDirectory: \"src\",\n" +
+        "\tbuildDirectory: \"build\",\n" +
+        "\n" +
+        "\t// Plugin Rules Configuration\n" +
+        "\trules: [\n" +
+        "\t\t{\n" +
+        "\t\t\tmatch: /sys_script_include.*\\.ts$/,\n" +
+        "\t\t\tplugins: [\n" +
+        "\t\t\t\t{\n" +
+        "\t\t\t\t\tname: \"@sincronia/typescript-plugin\",\n" +
+        "\t\t\t\t\toptions: {\n" +
+        "\t\t\t\t\t\ttranspile: true,\n" +
+        "\t\t\t\t\t\ttypeCheck: true,\n" +
+        "\t\t\t\t\t\ttsconfig: \"./tsconfig.servicenow.json\",\n" +
+        "\t\t\t\t\t},\n" +
+        "\t\t\t\t},\n" +
+        "\t\t\t\t{\n" +
+        "\t\t\t\t\tname: \"@sincronia/eslint-plugin\",\n" +
+        "\t\t\t\t\toptions: {\n" +
+        "\t\t\t\t\t\tconfigFile: \"./.eslintrc.js\",\n" +
+        "\t\t\t\t\t\tfix: false,\n" +
+        "\t\t\t\t\t\tcache: true,\n" +
+        "\t\t\t\t\t},\n" +
+        "\t\t\t\t},\n" +
+        "\t\t\t\t{\n" +
+        "\t\t\t\t\tname: \"@sincronia/babel-plugin\",\n" +
+        "\t\t\t\t\toptions: {\n" +
+        "\t\t\t\t\t\tconfigFile: \"./.babelrc\",\n" +
+        "\t\t\t\t\t},\n" +
+        "\t\t\t\t},\n" +
+        "\t\t\t\t{\n" +
+        "\t\t\t\t\tname: \"@sincronia/prettier-plugin\",\n" +
+        "\t\t\t\t\toptions: {\n" +
+        "\t\t\t\t\t\tconfigFile: \"./.prettierrc.js\",\n" +
+        "\t\t\t\t\t},\n" +
+        "\t\t\t\t},\n" +
+        "\t\t\t],\n" +
+        "\t\t},\n" +
+        "\t],\n" +
+        "\n" +
+        "\tincludes: {\n" +
+        "\t\t_tables: [\n" +
+        "\t\t\t\"sys_script_include\",\n" +
+        "\t\t\t\"sys_script\",\n" +
+        "\t\t\t\"sys_ui_script\",\n" +
+        "\t\t\t\"sys_ui_page\",\n" +
+        "\t\t\t\"sys_ux_client_script\",\n" +
+        "\t\t\t\"sys_processor\",\n" +
+        "\t\t\t\"sys_ws_operation\",\n" +
+        "\t\t\t\"sys_rest_message_fn\",\n" +
+        "\t\t\t\"sys_ui_action\",\n" +
+        "\t\t\t\"sys_security_acl\",\n" +
+        "\t\t\t\"sysevent_script_action\",\n" +
+        "\t\t\t\"sys_ux_macroponent\",\n" +
+        "\t\t\t\"sys_ux_event\",\n" +
+        "\t\t\t\"sys_ux_client_script_include\",\n" +
+        "\t\t\t\"sys_ux_screen\",\n" +
+        "\t\t\t\"sys_script_fix\",\n" +
+        "\t\t],\n" +
+        "\t\tsys_script_include: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_script: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ui_script: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ui_page: {\n" +
+        "\t\t\tprocessing_script: { type: \"js\" },\n" +
+        "\t\t\tclient_script: { type: \"js\" },\n" +
+        "\t\t\thtml: { type: \"html\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_processor: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ws_operation: {\n" +
+        "\t\t\toperation_script: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_rest_message_fn: {\n" +
+        "\t\t\tcontent: { type: \"txt\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ui_action: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t\tclient_script_v2: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_security_acl: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsysevent_script_action: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_script_fix: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ux_macroponent: {\n" +
+        "\t\t\tcomposition: { type: \"json\" },\n" +
+        "\t\t\tprops: { type: \"json\" },\n" +
+        "\t\t\tdata: { type: \"json\" },\n" +
+        "\t\t\trequired_translations: { type: \"json\" },\n" +
+        "\t\t\troot_component_definition: { type: \"json\" },\n" +
+        "\t\t\tstate_properties: { type: \"json\" },\n" +
+        "\t\t\troot_component_config: { type: \"json\" },\n" +
+        "\t\t\tinternal_event_mappings: { type: \"json\" },\n" +
+        "\t\t\tstate_persistence_config: { type: \"json\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ux_event: {\n" +
+        "\t\t\tdescription: { type: \"txt\" },\n" +
+        "\t\t\tevent_name: { type: \"txt\" },\n" +
+        "\t\t\tlabel: { type: \"txt\" },\n" +
+        "\t\t\tprops: { type: \"json\" },\n" +
+        "\t\t\trequired_translations: { type: \"json\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ux_client_script: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t\tname: { type: \"txt\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ux_client_script_include: {\n" +
+        "\t\t\tscript: { type: \"js\" },\n" +
+        "\t\t\tname: { type: \"txt\" },\n" +
+        "\t\t},\n" +
+        "\t\tsys_ux_screen: {\n" +
+        "\t\t\tmacroponent_config: { type: \"json\" },\n" +
+        "\t\t\tevent_mappings: { type: \"json\" },\n" +
+        "\t\t},\n" +
+        "\t\t_scopes: {},\n" +
+        "\t},\n" +
+        "\n" +
+        "\texcludes: {\n" +
+        "\t\t_tables: [],\n" +
+        "\t},\n" +
+        "\n" +
+        "\tmanifestOptions: {\n" +
+        "\t\tupdateFields: true,\n" +
+        "\t\tupdateDependencies: true,\n" +
+        "\t},\n" +
+        "\n" +
+        "\tserver: {\n" +
+        "\t\twatchPath: \"./src\",\n" +
+        "\t},\n" +
+        "\n" +
+        "\tscopes: {\n" +
+        scopeEntries + "\n" +
+        "\t},\n" +
+        "};\n";
+}
 async function loadConfig(skipConfigPath = false) {
     if (skipConfigPath) {
         Logger_1.logger.warn("Couldn't find config file. Loading default...");

package/dist/initSystem/corePlugin.js

@@ -42,7 +42,7 @@ exports.normalizeInstance = normalizeInstance;
 const snClient_1 = require("../snClient");
 const Logger_1 = require("../Logger");
 const ConfigManager = __importStar(require("../config"));
-const AppUtils = __importStar(require("../appUtils"));
+const allScopesCommands_1 = require("../allScopesCommands");
 const inquirer_1 = __importDefault(require("inquirer"));
 const chalk_1 = __importDefault(require("chalk"));
 const fs_1 = __importDefault(require("fs"));
@@ -84,44 +84,109 @@ exports.corePlugin = {
     ],
     configure: [
         {
-            key: "app",
-            label: "Selecting ServiceNow application",
+            key: "apps",
+            label: "Selecting ServiceNow applications",
             run: async (context) => {
-                const baseUrl = instanceBaseUrl(context.env.SN_INSTANCE);
-                const client = (0, snClient_1.snClient)(baseUrl, context.env.SN_USER, context.env.SN_PASSWORD);
+                var baseUrl = instanceBaseUrl(context.env.SN_INSTANCE);
+                var client = (0, snClient_1.snClient)(baseUrl, context.env.SN_USER, context.env.SN_PASSWORD);
                 Logger_1.logger.info("Fetching application list...");
-                const apps = await (0, snClient_1.unwrapSNResponse)(client.getAppList());
+                var apps = await (0, snClient_1.unwrapSNResponse)(client.getAppList());
                 if (apps.length === 0) {
                     Logger_1.logger.warn("No applications found on this instance.");
                     return null;
                 }
-                const choices = apps.map((app) => ({
-                    name: app.displayName + " (" + app.scope + ")",
-                    value: app.scope,
-                    short: app.displayName,
-                }));
-                const answer = await inquirer_1.default.prompt([{
-                        type: "list",
-                        name: "app",
-                        message: "Which app would you like to work with?",
-                        choices,
+                // Pre-check scopes that exist in the current config
+                var existingScopes = new Set();
+                if (context.hasConfig) {
+                    try {
+                        var existingConfig = require(path_1.default.join(context.rootDir, "sinc.config.js"));
+                        if (existingConfig.scopes) {
+                            Object.keys(existingConfig.scopes).forEach(function (s) {
+                                existingScopes.add(s);
+                            });
+                        }
+                    }
+                    catch (e) {
+                        // ignore — no existing config or malformed
+                    }
+                }
+                var choices = apps.map(function (app) {
+                    return {
+                        name: app.displayName + " (" + app.scope + ")",
+                        value: app.scope,
+                        short: app.displayName,
+                        checked: existingScopes.has(app.scope),
+                    };
+                });
+                var answer = await inquirer_1.default.prompt([{
+                        type: "checkbox",
+                        name: "apps",
+                        message: "Which apps would you like to work with? (space to select, enter to confirm)",
+                        choices: choices,
+                        validate: function (input) {
+                            if (input.length === 0)
+                                return "Select at least one application.";
+                            return true;
+                        },
                     }]);
-                context.answers.selectedScope = answer.app;
+                var selectedScopes = answer.apps;
+                context.answers.selectedScopes = selectedScopes;
+                context.answers.selectedScope = selectedScopes[0]; // backward compat
                 context.answers.apps = apps;
-                return answer.app;
+                // Prompt for source directory per selected scope
+                var scopeDirectories = {};
+                Logger_1.logger.info("");
+                Logger_1.logger.info(chalk_1.default.bold("  Source directories:"));
+                for (var i = 0; i < selectedScopes.length; i++) {
+                    var scope = selectedScopes[i];
+                    var app = apps.find(function (a) { return a.scope === scope; });
+                    var displayName = app ? app.displayName : scope;
+                    // Check if existing config already has a sourceDirectory for this scope
+                    var existingDir = "";
+                    if (existingScopes.has(scope)) {
+                        try {
+                            var cfgScopes = require(path_1.default.join(context.rootDir, "sinc.config.js")).scopes;
+                            if (cfgScopes && cfgScopes[scope] && cfgScopes[scope].sourceDirectory) {
+                                existingDir = cfgScopes[scope].sourceDirectory;
+                            }
+                        }
+                        catch (e) {
+                            // ignore
+                        }
+                    }
+                    // Suggest a friendly name from displayName, or use existing
+                    var suggestedDir = existingDir || ("src/" + displayName.replace(/\s+/g, ""));
+                    var dirAnswer = await inquirer_1.default.prompt([{
+                            type: "input",
+                            name: "dir",
+                            message: scope + ":",
+                            default: suggestedDir,
+                        }]);
+                    scopeDirectories[scope] = dirAnswer.dir;
+                }
+                context.answers.scopeDirectories = scopeDirectories;
+                return selectedScopes;
             },
         },
     ],
     initialize: async (context) => {
-        const scope = context.answers.selectedScope;
-        if (!scope) {
-            Logger_1.logger.warn("No application selected — skipping initialization.");
-            return;
+        var selectedScopes = context.answers.selectedScopes || [];
+        if (selectedScopes.length === 0) {
+            // Backward compat: single scope from old flow
+            if (context.answers.selectedScope) {
+                selectedScopes = [context.answers.selectedScope];
+            }
+            else {
+                Logger_1.logger.warn("No applications selected — skipping initialization.");
+                return;
+            }
         }
-        const rootDir = context.rootDir;
-        const configPath = path_1.default.join(rootDir, "sinc.config.js");
-        // Write or merge sinc.config.js
-        let hasExistingConfig = false;
+        var rootDir = context.rootDir;
+        var configPath = path_1.default.join(rootDir, "sinc.config.js");
+        var scopeDirectories = context.answers.scopeDirectories || {};
+        // Write or preserve sinc.config.js
+        var configAction = context.answers.configAction || "keep";
+        var hasExistingConfig = false;
         try {
             fs_1.default.accessSync(configPath, fs_1.default.constants.F_OK);
             hasExistingConfig = true;
@@ -129,9 +194,16 @@ exports.corePlugin = {
         catch (e) {
             // No existing config
         }
-        if (!hasExistingConfig) {
+        if (!hasExistingConfig || configAction === "replace") {
             Logger_1.logger.info("Generating sinc.config.js...");
-            fs_1.default.writeFileSync(configPath, ConfigManager.getDefaultConfigFile(), "utf8");
+            var scopeEntries = selectedScopes.map(function (scope) {
+                return {
+                    scope: scope,
+                    sourceDirectory: scopeDirectories[scope] || ("src/" + scope),
+                };
+            });
+            fs_1.default.writeFileSync(configPath, ConfigManager.generateConfigFile({ scopes: scopeEntries }), "utf8");
+            Logger_1.logger.success(chalk_1.default.green("✓ Generated sinc.config.js with " + selectedScopes.length + " scope(s)"));
         }
         else {
             Logger_1.logger.info("sinc.config.js already exists — preserving configuration.");
@@ -143,40 +215,79 @@ exports.corePlugin = {
         catch (e) {
             Logger_1.logger.warn("Config reload incomplete — this is expected during first-time init.");
         }
-        // Check if manifest already exists for this scope
-        const manifestPath = path_1.default.join(rootDir, "sinc.manifest." + scope + ".json");
-        let hasManifest = false;
-        try {
-            fs_1.default.accessSync(manifestPath, fs_1.default.constants.F_OK);
-            hasManifest = true;
-        }
-        catch (e) {
-            // No existing manifest
+        // Check which scopes already have manifests
+        var scopesWithManifests = [];
+        var scopesToDownload = [];
+        for (var i = 0; i < selectedScopes.length; i++) {
+            var scope = selectedScopes[i];
+            var manifestPath = path_1.default.join(rootDir, "sinc.manifest." + scope + ".json");
+            var hasManifest = false;
+            try {
+                fs_1.default.accessSync(manifestPath, fs_1.default.constants.F_OK);
+                hasManifest = true;
+            }
+            catch (e) {
+                // No manifest
+            }
+            if (hasManifest) {
+                scopesWithManifests.push(scope);
+            }
+            else {
+                scopesToDownload.push(scope);
+            }
         }
-        if (hasManifest) {
-            const redownload = await inquirer_1.default.prompt([{
+        // Batch prompt for scopes that already have manifests
+        if (scopesWithManifests.length > 0) {
+            var redownload = await inquirer_1.default.prompt([{
                     type: "confirm",
                     name: "confirmed",
-                    message: "Manifest for " + scope + " already exists. Re-download?",
+                    message: scopesWithManifests.length + " scope(s) already have manifests (" + scopesWithManifests.join(", ") + "). Re-download?",
                     default: false,
                 }]);
-            if (!redownload.confirmed) {
-                Logger_1.logger.info("Skipping download for " + scope);
-                return;
+            if (redownload.confirmed) {
+                scopesToDownload = scopesToDownload.concat(scopesWithManifests);
             }
         }
-        // Download application files — errors propagate to orchestrator
-        Logger_1.logger.info("Downloading " + scope + "...");
-        const baseUrl = instanceBaseUrl(context.env.SN_INSTANCE);
-        const client = (0, snClient_1.snClient)(baseUrl, context.env.SN_USER, context.env.SN_PASSWORD);
-        const config = ConfigManager.getConfig();
-        const man = await (0, snClient_1.unwrapSNResponse)(client.getManifest(scope, config, true));
-        await AppUtils.processManifest(man);
-        const tableNames = Object.keys(man.tables || {});
-        const recordCount = tableNames.reduce((sum, t) => {
-            return sum + Object.keys(man.tables[t].records || {}).length;
-        }, 0);
-        Logger_1.logger.success(chalk_1.default.green("✓ ServiceNow configured — " + tableNames.length + " tables, " + recordCount + " records"));
+        if (scopesToDownload.length === 0) {
+            Logger_1.logger.info("No scopes to download — all manifests up to date.");
+            return;
+        }
+        // Download all scopes using the battle-tested processScope pipeline
+        Logger_1.logger.info("Downloading " + scopesToDownload.length + " scope(s)...");
+        var config = ConfigManager.getConfig();
+        var scopePromises = scopesToDownload.map(function (scopeName) {
+            var scopeConfig = (config.scopes && config.scopes[scopeName]) || {};
+            return (0, allScopesCommands_1.processScope)(scopeName, scopeConfig, 0);
+        });
+        var results = await Promise.allSettled(scopePromises);
+        // Write per-scope manifest files and tally results
+        var successCount = 0;
+        var failCount = 0;
+        for (var r = 0; r < results.length; r++) {
+            var result = results[r];
+            var scopeName = scopesToDownload[r];
+            if (result.status === "fulfilled" && result.value.success) {
+                successCount++;
+                // Write per-scope manifest
+                if (result.value.manifest) {
+                    var scopeManifestPath = ConfigManager.getScopeManifestPath(scopeName);
+                    fs_1.default.writeFileSync(scopeManifestPath, JSON.stringify(result.value.manifest, null, 2), "utf8");
+                }
+            }
+            else {
+                failCount++;
+                var error = result.status === "rejected" ? result.reason : (result.value && result.value.error);
+                Logger_1.logger.error("Failed to initialize " + scopeName + ": " + (error && error.message ? error.message : "Unknown error"));
+            }
+        }
+        // Summary
+        Logger_1.logger.info("");
+        if (failCount === 0) {
+            Logger_1.logger.success(chalk_1.default.green("✓ ServiceNow configured — " + successCount + " scope(s) initialized"));
+        }
+        else {
+            Logger_1.logger.warn(successCount + "/" + scopesToDownload.length + " scopes initialized, " + failCount + " failed");
+        }
     },
 };
 /**

package/dist/initSystem/orchestrator.js

@@ -203,28 +203,20 @@ async function runConfigPhase(context) {
         var answer = await inquirer_1.default.prompt([{
                 type: "list",
                 name: "configAction",
-                message: "Existing config found. Would you like to update it or use the current one?",
+                message: "Existing sinc.config.js found:",
                 choices: [
                     { name: "Use current config", value: "keep" },
-                    { name: "Update config", value: "update" },
+                    { name: "Replace config (regenerate after scope selection)", value: "replace" },
                 ],
             }]);
+        context.answers.configAction = answer.configAction;
         if (answer.configAction === "keep") {
             Logger_1.logger.info(chalk_1.default.green("  ✓ Using existing sinc.config.js"));
-            return;
         }
+        return;
     }
-    // TODO: Future config wizard steps:
-    // 1. Scopes — multi-select from available scopes
-    // 2. Tables — multi-select with search (inquirer-autocomplete)
-    // 3. Fields for selected tables
-    // 4. Special scope tables
-    // 5. Special scope fields for tables
-    Logger_1.logger.info("");
-    Logger_1.logger.info(chalk_1.default.magenta("  🎬 Coming soon to a terminal near you!"));
-    Logger_1.logger.info(chalk_1.default.dim("  The config wizard is still in development — stay tuned."));
-    Logger_1.logger.info(chalk_1.default.dim("  For now, " + (context.hasConfig ? "we'll keep your current config." : "we'll set you up with the defaults.")));
-    Logger_1.logger.info("");
+    // No config — will be generated in initialize phase after scopes are selected
+    context.answers.configAction = "generate";
 }
 async function runConfigurePhase(plugin, context) {
     const hooks = plugin.configure;

package/dist/tests/watcher.test.js

@@ -0,0 +1,228 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+function createMockWatcher() {
+    const handlers = {};
+    const mock = {
+        _handlers: handlers,
+        on: jest.fn((event, handler) => {
+            if (!handlers[event])
+                handlers[event] = [];
+            handlers[event].push(handler);
+            return mock;
+        }),
+        close: jest.fn(),
+        _emit: (event, ...args) => {
+            (handlers[event] || []).forEach((h) => h(...args));
+        },
+    };
+    return mock;
+}
+let latestMockWatcher;
+jest.mock("chokidar", () => ({
+    watch: jest.fn(() => {
+        latestMockWatcher = createMockWatcher();
+        return latestMockWatcher;
+    }),
+}));
+// Controllable debounce — captures fn, tests trigger manually
+let capturedProcessQueue;
+jest.mock("lodash", () => {
+    const actual = jest.requireActual("lodash");
+    return {
+        ...actual,
+        debounce: jest.fn((fn) => {
+            capturedProcessQueue = fn;
+            const wrapper = jest.fn((...args) => {
+                // Don't call automatically — tests call capturedProcessQueue()
+            });
+            wrapper.cancel = jest.fn();
+            wrapper.flush = jest.fn(() => fn());
+            return wrapper;
+        }),
+    };
+});
+jest.mock("../FileUtils", () => ({
+    getFileContextFromPath: jest.fn(),
+}));
+jest.mock("../appUtils", () => ({
+    groupAppFiles: jest.fn(),
+    pushFiles: jest.fn(),
+}));
+jest.mock("../logMessages", () => ({
+    logFilePush: jest.fn(),
+}));
+jest.mock("../Logger", () => ({
+    logger: {
+        info: jest.fn(),
+        error: jest.fn(),
+        warn: jest.fn(),
+        debug: jest.fn(),
+        success: jest.fn(),
+    },
+}));
+// --- Imports (after mocks) ---
+const chokidar_1 = __importDefault(require("chokidar"));
+const Watcher_1 = require("../Watcher");
+const FileUtils_1 = require("../FileUtils");
+const appUtils_1 = require("../appUtils");
+const logMessages_1 = require("../logMessages");
+const Logger_1 = require("../Logger");
+// --- Test Fixtures ---
+const MOCK_FILE_PATH = "/project/src/sys_script_include/TestScript/script.js";
+const MOCK_FILE_PATH_2 = "/project/src/sys_script_include/OtherScript/script.js";
+const makeFileContext = (overrides = {}) => ({
+    filePath: MOCK_FILE_PATH,
+    ext: ".js",
+    sys_id: "abc123",
+    name: "TestScript",
+    scope: "x_test",
+    tableName: "sys_script_include",
+    targetField: "script",
+    ...overrides,
+});
+const MOCK_BUILDABLE = {
+    table: "sys_script_include",
+    sysId: "abc123",
+    fields: {},
+};
+const MOCK_PUSH_SUCCESS = {
+    success: true,
+    message: "Pushed successfully",
+};
+// --- Tests ---
+describe("Watcher", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    afterEach(() => {
+        (0, Watcher_1.stopWatching)();
+    });
+    describe("startWatching", () => {
+        it("calls chokidar.watch with the given directory", () => {
+            (0, Watcher_1.startWatching)("/project/src");
+            expect(chokidar_1.default.watch).toHaveBeenCalledWith("/project/src");
+        });
+        it("registers change event handler", () => {
+            (0, Watcher_1.startWatching)("/project/src");
+            expect(latestMockWatcher.on).toHaveBeenCalledWith("change", expect.any(Function));
+        });
+        it("registers error event handler", () => {
+            (0, Watcher_1.startWatching)("/project/src");
+            expect(latestMockWatcher.on).toHaveBeenCalledWith("error", expect.any(Function));
+        });
+    });
+    describe("file change processing", () => {
+        it("processes a changed file through the full pipeline", async () => {
+            const ctx = makeFileContext();
+            FileUtils_1.getFileContextFromPath.mockReturnValue(ctx);
+            appUtils_1.groupAppFiles.mockReturnValue([MOCK_BUILDABLE]);
+            appUtils_1.pushFiles.mockResolvedValue([MOCK_PUSH_SUCCESS]);
+            (0, Watcher_1.startWatching)("/project/src");
+            latestMockWatcher._emit("change", MOCK_FILE_PATH);
+            // Manually trigger the debounced processQueue
+            await capturedProcessQueue();
+            expect(FileUtils_1.getFileContextFromPath).toHaveBeenCalledWith(MOCK_FILE_PATH, 0, [MOCK_FILE_PATH]);
+            expect(appUtils_1.groupAppFiles).toHaveBeenCalledWith([ctx]);
+            expect(appUtils_1.pushFiles).toHaveBeenCalledWith([MOCK_BUILDABLE]);
+            expect(logMessages_1.logFilePush).toHaveBeenCalledWith(ctx, MOCK_PUSH_SUCCESS);
+        });
+        it("deduplicates multiple changes to the same file", async () => {
+            const ctx = makeFileContext();
+            FileUtils_1.getFileContextFromPath.mockReturnValue(ctx);
+            appUtils_1.groupAppFiles.mockReturnValue([MOCK_BUILDABLE]);
+            appUtils_1.pushFiles.mockResolvedValue([MOCK_PUSH_SUCCESS]);
+            (0, Watcher_1.startWatching)("/project/src");
+            // Emit the same file path three times before processing
+            latestMockWatcher._emit("change", MOCK_FILE_PATH);
+            latestMockWatcher._emit("change", MOCK_FILE_PATH);
+            latestMockWatcher._emit("change", MOCK_FILE_PATH);
+            await capturedProcessQueue();
+            // Should only process the file once due to Set dedup
+            expect(FileUtils_1.getFileContextFromPath).toHaveBeenCalledTimes(1);
+        });
+        it("batches changes to multiple files", async () => {
+            const ctx1 = makeFileContext();
+            const ctx2 = makeFileContext({
+                filePath: MOCK_FILE_PATH_2,
+                sys_id: "def456",
+                name: "OtherScript",
+            });
+            FileUtils_1.getFileContextFromPath
+                .mockReturnValueOnce(ctx1)
+                .mockReturnValueOnce(ctx2);
+            appUtils_1.groupAppFiles.mockReturnValue([MOCK_BUILDABLE]);
+            appUtils_1.pushFiles.mockResolvedValue([MOCK_PUSH_SUCCESS]);
+            (0, Watcher_1.startWatching)("/project/src");
+            latestMockWatcher._emit("change", MOCK_FILE_PATH);
+            latestMockWatcher._emit("change", MOCK_FILE_PATH_2);
+            await capturedProcessQueue();
+            expect(FileUtils_1.getFileContextFromPath).toHaveBeenCalledTimes(2);
+            expect(appUtils_1.groupAppFiles).toHaveBeenCalledWith([ctx1, ctx2]);
+        });
+        it("filters out files where getFileContextFromPath returns undefined", async () => {
+            const ctx = makeFileContext();
+            FileUtils_1.getFileContextFromPath
+                .mockReturnValueOnce(undefined)
+                .mockReturnValueOnce(ctx);
+            appUtils_1.groupAppFiles.mockReturnValue([MOCK_BUILDABLE]);
+            appUtils_1.pushFiles.mockResolvedValue([MOCK_PUSH_SUCCESS]);
+            (0, Watcher_1.startWatching)("/project/src");
+            latestMockWatcher._emit("change", "/project/src/unknown/file.txt");
+            latestMockWatcher._emit("change", MOCK_FILE_PATH);
+            await capturedProcessQueue();
+            // groupAppFiles should only receive the valid context
+            expect(appUtils_1.groupAppFiles).toHaveBeenCalledWith([ctx]);
+        });
+        it("does not process when queue is empty", async () => {
+            (0, Watcher_1.startWatching)("/project/src");
+            // Trigger processQueue without emitting any events
+            await capturedProcessQueue();
+            expect(FileUtils_1.getFileContextFromPath).not.toHaveBeenCalled();
+            expect(appUtils_1.groupAppFiles).not.toHaveBeenCalled();
+            expect(appUtils_1.pushFiles).not.toHaveBeenCalled();
+        });
+        it("calls logFilePush for each result paired with its file context", async () => {
+            const ctx1 = makeFileContext();
+            const ctx2 = makeFileContext({
+                filePath: MOCK_FILE_PATH_2,
+                sys_id: "def456",
+                name: "OtherScript",
+            });
+            const result1 = { success: true, message: "ok" };
+            const result2 = { success: false, message: "failed" };
+            FileUtils_1.getFileContextFromPath
+                .mockReturnValueOnce(ctx1)
+                .mockReturnValueOnce(ctx2);
+            appUtils_1.groupAppFiles.mockReturnValue([MOCK_BUILDABLE, MOCK_BUILDABLE]);
+            appUtils_1.pushFiles.mockResolvedValue([result1, result2]);
+            (0, Watcher_1.startWatching)("/project/src");
+            latestMockWatcher._emit("change", MOCK_FILE_PATH);
+            latestMockWatcher._emit("change", MOCK_FILE_PATH_2);
+            await capturedProcessQueue();
+            expect(logMessages_1.logFilePush).toHaveBeenCalledTimes(2);
+            expect(logMessages_1.logFilePush).toHaveBeenCalledWith(ctx1, result1);
+            expect(logMessages_1.logFilePush).toHaveBeenCalledWith(ctx2, result2);
+        });
+    });
+    describe("error handling", () => {
+        it("logs error when chokidar emits error event", () => {
+            (0, Watcher_1.startWatching)("/project/src");
+            const error = new Error("Watch failed");
+            latestMockWatcher._emit("error", error);
+            expect(Logger_1.logger.error).toHaveBeenCalledWith("Watcher error: Watch failed");
+        });
+    });
+    describe("stopWatching", () => {
+        it("calls watcher.close() when watcher exists", () => {
+            (0, Watcher_1.startWatching)("/project/src");
+            (0, Watcher_1.stopWatching)();
+            expect(latestMockWatcher.close).toHaveBeenCalled();
+        });
+        it("does not throw when called before startWatching", () => {
+            expect(() => (0, Watcher_1.stopWatching)()).not.toThrow();
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenonhq/sincronia-core",
-  "version": "0.0.76",
+  "version": "0.0.77",
   "description": "Next-gen file syncer",
   "license": "GPL-3.0",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "node": ">=20.0.0"
   },
   "devDependencies": {
-    "@tenonhq/sincronia-types": "^0.0.10",
+    "@tenonhq/sincronia-types": "^0.0.13",
     "@types/dotenv": "^6.1.1",
     "@types/inquirer": "^8.2.10",
     "@types/jest": "^29.5.5",