@memberjunction/metadata-sync 3.3.0 → 4.0.0

package/dist/config.d.ts

@@ -348,3 +348,4 @@ export declare function loadEntityConfig(dir: string): Promise<EntityConfig | nu
  * ```
  */
 export declare function loadFolderConfig(dir: string): Promise<FolderConfig | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iCAAiC;IACjC,IAAI,CAAC,EAAE;QACL,6DAA6D;QAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,uDAAuD;QACvD,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B;;;WAGG;QACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC;;;;;WAKG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF,qGAAqG;IACrG,UAAU,CAAC,EAAE;QACX,2DAA2D;QAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,+GAA+G;QAC/G,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,qFAAqF;QACrF,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B;;;;;;WAMG;QACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B;;;;WAIG;QACH,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;QACnC,8EAA8E;QAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,0DAA0D;QAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,2CAA2C;QAC3C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,yCAAyC;IACzC,kBAAkB,CAAC,EAAE;QACnB,+DAA+D;QAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,uEAAuE;QACvE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,mEAAmE;QACnE,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC,CAAC;IACF;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG;QAC7B,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,2DAA2D;YAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAA;KACF,GAAG,KAAK,CAAC;QACR,gCAAgC;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,yEAAyE;QACzE,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,kFAAkF;IAClF,YAAY,CAAC,EAAE;QACb,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IACF,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACvD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,IAAI,CAAC,EAAE;QACL,kFAAkF;QAClF,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gEAAgE;QAChE,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,oEAAoE;QACpE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,8DAA8D;QAC9D,2BAA2B,CAAC,EAAE,OAAO,CAAC;QACtC,8DAA8D;QAC9D,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,gEAAgE;QAChE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,mEAAmE;QACnE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;QAC/C,yDAAyD;QACzD,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,+DAA+D;QAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,6DAA6D;QAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iDAAiD;QACjD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACtD,0EAA0E;QAC1E,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG;YAC7B,CAAC,SAAS,EAAE,MAAM,GAAG;gBACnB,2DAA2D;gBAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;aACpB,CAAA;SACF,GAAG,KAAK,CAAC;YACR,gCAAgC;YAChC,KAAK,EAAE,MAAM,CAAC;YACd;;;;;;eAMG;YACH,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC,CAAC;QACH,oEAAoE;QACpE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,0DAA0D;QAC1D,YAAY,CAAC,EAAE;YACb,qDAAqD;YACrD,CAAC,SAAS,EAAE,MAAM,GAAG;gBACnB,wDAAwD;gBACxD,MAAM,EAAE,MAAM,CAAC;gBACf,8DAA8D;gBAC9D,KAAK,EAAE,MAAM,CAAC;aACf,CAAC;SACH,CAAC;QACF,0EAA0E;QAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,uEAAuE;QACvE,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,IAAI,QAAQ,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa5E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAehF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAahF"}

package/dist/config.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * @fileoverview Configuration types and loaders for MetadataSync
  * @module config
@@ -10,14 +9,9 @@
  * - Entity-specific configuration (.mj-sync.json with entity field)
  * - Folder-level defaults (.mj-folder.json)
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadFolderConfig = exports.loadEntityConfig = exports.loadSyncConfig = exports.loadMJConfig = void 0;
-const path_1 = __importDefault(require("path"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const config_manager_1 = require("./lib/config-manager");
+import path from 'path';
+import fs from 'fs-extra';
+import { configManager } from './lib/config-manager.js';
 /**
  * Load MemberJunction configuration from the filesystem
  *
@@ -34,10 +28,9 @@ const config_manager_1 = require("./lib/config-manager");
  * }
  * ```
  */
-function loadMJConfig() {
-    return config_manager_1.configManager.loadMJConfig();
+export function loadMJConfig() {
+    return configManager.loadMJConfig();
 }
-exports.loadMJConfig = loadMJConfig;
 /**
  * Load sync configuration from a directory
  *
@@ -56,11 +49,11 @@ exports.loadMJConfig = loadMJConfig;
  * }
  * ```
  */
-async function loadSyncConfig(dir) {
-    const configPath = path_1.default.join(dir, '.mj-sync.json');
-    if (await fs_extra_1.default.pathExists(configPath)) {
+export async function loadSyncConfig(dir) {
+    const configPath = path.join(dir, '.mj-sync.json');
+    if (await fs.pathExists(configPath)) {
         try {
-            return await fs_extra_1.default.readJson(configPath);
+            return await fs.readJson(configPath);
         }
         catch (error) {
             console.error('Error loading sync config:', error);
@@ -69,7 +62,6 @@ async function loadSyncConfig(dir) {
     }
     return null;
 }
-exports.loadSyncConfig = loadSyncConfig;
 /**
  * Load entity-specific configuration from a directory
  *
@@ -88,11 +80,11 @@ exports.loadSyncConfig = loadSyncConfig;
  * }
  * ```
  */
-async function loadEntityConfig(dir) {
-    const configPath = path_1.default.join(dir, '.mj-sync.json');
-    if (await fs_extra_1.default.pathExists(configPath)) {
+export async function loadEntityConfig(dir) {
+    const configPath = path.join(dir, '.mj-sync.json');
+    if (await fs.pathExists(configPath)) {
         try {
-            const config = await fs_extra_1.default.readJson(configPath);
+            const config = await fs.readJson(configPath);
             if (config.entity) {
                 return config;
             }
@@ -103,7 +95,6 @@ async function loadEntityConfig(dir) {
     }
     return null;
 }
-exports.loadEntityConfig = loadEntityConfig;
 /**
  * Load folder-level configuration
  *
@@ -122,11 +113,11 @@ exports.loadEntityConfig = loadEntityConfig;
  * }
  * ```
  */
-async function loadFolderConfig(dir) {
-    const configPath = path_1.default.join(dir, '.mj-folder.json');
-    if (await fs_extra_1.default.pathExists(configPath)) {
+export async function loadFolderConfig(dir) {
+    const configPath = path.join(dir, '.mj-folder.json');
+    if (await fs.pathExists(configPath)) {
         try {
-            return await fs_extra_1.default.readJson(configPath);
+            return await fs.readJson(configPath);
         }
         catch (error) {
             console.error('Error loading folder config:', error);
@@ -135,5 +126,4 @@ async function loadFolderConfig(dir) {
     }
     return null;
 }
-exports.loadFolderConfig = loadFolderConfig;
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;AAGH,gDAAwB;AACxB,wDAA0B;AAC1B,yDAAqD;AAgRrD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY;IAC1B,OAAO,8BAAa,CAAC,YAAY,EAAE,CAAC;AACtC,CAAC;AAFD,oCAEC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,wCAaC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAfD,4CAeC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAErD,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAbD,4CAaC","sourcesContent":["/**\n * @fileoverview Configuration types and loaders for MetadataSync\n * @module config\n * \n * This module defines configuration interfaces and provides utilities for loading\n * various configuration files used by the MetadataSync tool. It supports:\n * - MemberJunction database configuration (mj.config.cjs)\n * - Sync configuration (.mj-sync.json)\n * - Entity-specific configuration (.mj-sync.json with entity field)\n * - Folder-level defaults (.mj-folder.json)\n */\n\nimport { cosmiconfigSync } from 'cosmiconfig';\nimport path from 'path';\nimport fs from 'fs-extra';\nimport { configManager } from './lib/config-manager';\n\n/**\n * MemberJunction database configuration\n * \n * Defines connection parameters and settings for connecting to the MemberJunction\n * database. Typically loaded from mj.config.cjs in the project root.\n */\nexport interface MJConfig {\n  /** Database server hostname or IP address */\n  dbHost: string;\n  /** Database server port (defaults to 1433 for SQL Server) */\n  dbPort?: number;\n  /** Database name to connect to */\n  dbDatabase: string;\n  /** Database authentication username */\n  dbUsername: string;\n  /** Database authentication password */\n  dbPassword: string;\n  /** Whether to trust the server certificate (Y/N) */\n  dbTrustServerCertificate?: string;\n  /** Whether to encrypt the connection (Y/N, auto-detected for Azure SQL) */\n  dbEncrypt?: string;\n  /** SQL Server instance name (for named instances) */\n  dbInstanceName?: string;\n  /** Schema name for MemberJunction core tables (defaults to __mj) */\n  mjCoreSchema?: string;\n  /** Allow additional properties for extensibility */\n  [key: string]: any;\n}\n\n/**\n * Global sync configuration\n * \n * Defines settings that apply to the entire sync process, including push/pull\n * behaviors and watch mode configuration. Stored in .mj-sync.json at the root.\n */\nexport interface SyncConfig {\n  /** Version of the sync configuration format */\n  version: string;\n  /** Glob pattern for finding data files (defaults to \"*.json\") */\n  filePattern?: string;\n  /** \n   * Directory processing order (only applies to root-level config, not inherited by subdirectories)\n   * Specifies the order in which subdirectories should be processed to handle dependencies.\n   * Directories not listed in this array will be processed after the ordered ones in alphabetical order.\n   */\n  directoryOrder?: string[];\n  /** \n   * Directories to ignore during processing\n   * Can be directory names or glob patterns relative to the location of the .mj-sync.json file\n   * Cumulative: subdirectories inherit and add to parent ignoreDirectories\n   * Examples: [\"output\", \"examples\", \"temp\"]\n   */\n  ignoreDirectories?: string[];\n  /** Push command configuration */\n  push?: {\n    /** Whether to validate records before pushing to database */\n    validateBeforePush?: boolean;\n    /** Whether to require user confirmation before push */\n    requireConfirmation?: boolean;\n    /** \n     * Whether to automatically create new records when a primaryKey exists but record is not found\n     * Defaults to false - will warn instead of creating\n     */\n    autoCreateMissingRecords?: boolean;\n    /** \n     * When true, forces all records to be saved to database regardless of dirty state.\n     * This bypasses dirty checking and always performs database updates.\n     * Useful for ensuring complete synchronization or when dirty detection may miss changes.\n     * Defaults to false.\n     */\n    alwaysPush?: boolean;\n  };\n  /** SQL logging configuration (only applies to root-level config, not inherited by subdirectories) */\n  sqlLogging?: {\n    /** Whether to enable SQL logging during push operations */\n    enabled?: boolean;\n    /** Directory to output SQL log files (relative to command execution directory, defaults to './sql_logging') */\n    outputDirectory?: string;\n    /** Whether to format SQL as migration-ready files with Flyway schema placeholders */\n    formatAsMigration?: boolean;\n    /**\n     * Array of patterns to filter SQL statements.\n     * Supports both regex strings and simple wildcard patterns:\n     * - Regex: \"/spCreate.*Run/i\" (must start with \"/\" and optionally end with flags)\n     * - Simple: \"*spCreateAIPromptRun*\" (uses * as wildcard, case-insensitive by default)\n     * Examples: [\"*AIPrompt*\", \"/^EXEC sp_/i\", \"*EntityFieldValue*\"]\n     */\n    filterPatterns?: string[];\n    /**\n     * Determines how filterPatterns are applied:\n     * - 'exclude': If ANY pattern matches, the SQL is NOT logged (default)\n     * - 'include': If ANY pattern matches, the SQL IS logged\n     */\n    filterType?: 'exclude' | 'include';\n    /** Whether to output verbose debug information to console (default: false) */\n    verboseOutput?: boolean;\n  };\n  /** Watch command configuration */\n  watch?: {\n    /** Milliseconds to wait before processing file changes */\n    debounceMs?: number;\n    /** File patterns to ignore during watch */\n    ignorePatterns?: string[];\n  };\n  /** User role validation configuration */\n  userRoleValidation?: {\n    /** Whether to enable user role validation for UserID fields */\n    enabled?: boolean;\n    /** List of role names that are allowed to be referenced in metadata */\n    allowedRoles?: string[];\n    /** Whether to allow users without any roles (defaults to false) */\n    allowUsersWithoutRoles?: boolean;\n  };\n  /**\n   * Whether to emit __mj_sync_notes in record files during push operations.\n   * When enabled, resolution information for @lookup and @parent references is written to files.\n   * Defaults to false. Entity-level .mj-sync.json files can override this setting.\n   */\n  emitSyncNotes?: boolean;\n}\n\n/**\n * Configuration for related entity synchronization\n * \n * Defines how to pull and push related entities that have foreign key relationships\n * with a parent entity. Supports nested relationships for deep object graphs.\n * NEW: Supports automatic recursive patterns for self-referencing entities.\n */\nexport interface RelatedEntityConfig {\n  /** Name of the related entity to sync */\n  entity: string;\n  /** Field name that contains the foreign key reference to parent (e.g., \"PromptID\") */\n  foreignKey: string;\n  /** Optional SQL filter to apply when pulling related records */\n  filter?: string;\n  /** \n   * Enable recursive fetching for self-referencing entities\n   * When true, automatically fetches all levels of the hierarchy until no more children found\n   */\n  recursive?: boolean;\n  /** \n   * Maximum depth for recursive fetching (optional, defaults to 10)\n   * Prevents infinite loops and controls memory usage\n   * Only applies when recursive is true\n   */\n  maxDepth?: number;\n  /** Fields to externalize to separate files for this related entity */\n  externalizeFields?: string[] | {\n    [fieldName: string]: {\n      /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n      extension?: string;\n    }\n  } | Array<{\n    /** Field name to externalize */\n    field: string;\n    /** Pattern for the output file. Supports placeholders from the entity */\n    pattern: string;\n  }>;\n  /** Fields to exclude from the pulled data for this related entity */\n  excludeFields?: string[];\n  /** Foreign key fields to convert to @lookup references for this related entity */\n  lookupFields?: {\n    [fieldName: string]: {\n      entity: string;\n      field: string;\n    };\n  };\n  /** Nested related entities for deep object graphs */\n  relatedEntities?: Record<string, RelatedEntityConfig>;\n}\n\n/**\n * Entity-specific configuration\n * \n * Defines settings for a specific entity type within a directory. Stored in\n * .mj-sync.json files that contain an \"entity\" field. Supports defaults,\n * file patterns, and related entity configuration.\n */\nexport interface EntityConfig {\n  /** Name of the entity this directory contains */\n  entity: string;\n  /** Glob pattern for finding data files (defaults to \"*.json\") */\n  filePattern?: string;\n  /** Default field values applied to all records in this directory */\n  defaults?: Record<string, any>;\n  /** \n   * Directories to ignore during processing\n   * Can be directory names or glob patterns relative to the location of the .mj-sync.json file\n   * Cumulative: subdirectories inherit and add to parent ignoreDirectories\n   * Examples: [\"output\", \"examples\", \"temp\"]\n   */\n  ignoreDirectories?: string[];\n  /** Pull command specific configuration */\n  pull?: {\n    /** Glob pattern for finding existing files to update (defaults to filePattern) */\n    filePattern?: string;\n    /** Whether to create new files for records not found locally */\n    createNewFileIfNotFound?: boolean;\n    /** Filename for new records when createNewFileIfNotFound is true */\n    newFileName?: string;\n    /** Whether to append multiple new records to a single file */\n    appendRecordsToExistingFile?: boolean;\n    /** Whether to update existing records found in local files */\n    updateExistingRecords?: boolean;\n    /** Fields to preserve during updates (never overwrite these) */\n    preserveFields?: string[];\n    /** Strategy for merging updates: \"overwrite\" | \"merge\" | \"skip\" */\n    mergeStrategy?: 'overwrite' | 'merge' | 'skip';\n    /** Create backup files before updating existing files */\n    backupBeforeUpdate?: boolean;\n    /** Directory name for backup files (defaults to \".backups\") */\n    backupDirectory?: string;\n    /** SQL filter to apply when pulling records from database */\n    filter?: string;\n    /** Configuration for pulling related entities */\n    relatedEntities?: Record<string, RelatedEntityConfig>;\n    /** Fields to externalize to separate files with optional configuration */\n    externalizeFields?: string[] | {\n      [fieldName: string]: {\n        /** File extension to use (e.g., \".md\", \".txt\", \".html\") */\n        extension?: string;\n      }\n    } | Array<{\n      /** Field name to externalize */\n      field: string;\n      /** Pattern for the output file. Supports placeholders:\n       * - {Name}: Entity's name field value\n       * - {ID}: Entity's ID\n       * - {FieldName}: The field being externalized\n       * - Any other {FieldName} from the entity\n       * Example: \"@file:templates/{Name}.template.md\"\n       */\n      pattern: string;\n    }>;\n    /** Fields to exclude from the pulled data (e.g., [\"TemplateID\"]) */\n    excludeFields?: string[];\n    /** Foreign key fields to convert to @lookup references */\n    lookupFields?: {\n      /** Field name in this entity (e.g., \"CategoryID\") */\n      [fieldName: string]: {\n        /** Target entity name (e.g., \"AI Prompt Categories\") */\n        entity: string;\n        /** Field in target entity to use for lookup (e.g., \"Name\") */\n        field: string;\n      };\n    };\n    /** Whether to ignore null field values during pull (defaults to false) */\n    ignoreNullFields?: boolean;\n    /** Whether to ignore virtual fields during pull (defaults to false) */\n    ignoreVirtualFields?: boolean;\n  };\n  /**\n   * Whether to emit __mj_sync_notes in record files during push operations.\n   * When enabled, resolution information for @lookup and @parent references is written to files.\n   * If not specified, inherits from root .mj-sync.json. Defaults to false if not set anywhere.\n   */\n  emitSyncNotes?: boolean;\n}\n\n/**\n * Folder-level configuration\n * \n * Defines default values that cascade down to all subdirectories. Stored in\n * .mj-folder.json files. Child folders can override parent defaults.\n */\nexport interface FolderConfig {\n  /** Default field values that apply to all entities in this folder and subfolders */\n  defaults: Record<string, any>;\n}\n\n/**\n * Load MemberJunction configuration from the filesystem\n * \n * Searches for mj.config.cjs starting from the current directory and walking up\n * the directory tree. Uses cosmiconfig for flexible configuration loading.\n * \n * @returns MJConfig object if found, null if not found or invalid\n * \n * @example\n * ```typescript\n * const config = loadMJConfig();\n * if (config) {\n *   console.log(`Connecting to ${config.dbHost}:${config.dbPort || 1433}`);\n * }\n * ```\n */\nexport function loadMJConfig(): MJConfig | null {\n  return configManager.loadMJConfig();\n}\n\n/**\n * Load sync configuration from a directory\n * \n * Loads .mj-sync.json file from the specified directory. This file can contain\n * either global sync configuration (no entity field) or entity-specific\n * configuration (with entity field).\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to SyncConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const syncConfig = await loadSyncConfig('/path/to/project');\n * if (syncConfig?.push?.requireConfirmation) {\n *   // Show confirmation prompt\n * }\n * ```\n */\nexport async function loadSyncConfig(dir: string): Promise<SyncConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading sync config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load entity-specific configuration from a directory\n * \n * Loads .mj-sync.json file that contains an \"entity\" field, indicating this\n * directory contains data for a specific entity type. Returns null if the\n * file doesn't exist or doesn't contain an entity field.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to EntityConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const entityConfig = await loadEntityConfig('./ai-prompts');\n * if (entityConfig) {\n *   console.log(`Directory contains ${entityConfig.entity} records`);\n * }\n * ```\n */\nexport async function loadEntityConfig(dir: string): Promise<EntityConfig | null> {\n  const configPath = path.join(dir, '.mj-sync.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      const config = await fs.readJson(configPath);\n      if (config.entity) {\n        return config;\n      }\n    } catch (error) {\n      console.error('Error loading entity config:', error);\n    }\n  }\n  \n  return null;\n}\n\n/**\n * Load folder-level configuration\n * \n * Loads .mj-folder.json file that contains default values to be applied to\n * all entities in this folder and its subfolders. Used for cascading defaults\n * in deep directory structures.\n * \n * @param dir - Directory path to load configuration from\n * @returns Promise resolving to FolderConfig if found and valid, null otherwise\n * \n * @example\n * ```typescript\n * const folderConfig = await loadFolderConfig('./templates');\n * if (folderConfig?.defaults) {\n *   // Apply folder defaults to records\n * }\n * ```\n */\nexport async function loadFolderConfig(dir: string): Promise<FolderConfig | null> {\n  const configPath = path.join(dir, '.mj-folder.json');\n  \n  if (await fs.pathExists(configPath)) {\n    try {\n      return await fs.readJson(configPath);\n    } catch (error) {\n      console.error('Error loading folder config:', error);\n      return null;\n    }\n  }\n  \n  return null;\n}"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAgRrD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,CAAC,YAAY,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAErD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/constants/metadata-keywords.d.ts

@@ -280,3 +280,4 @@ export declare function isExternalReferenceKeyword(keyword: string): boolean;
  * createKeywordReference('parent', 'ID')  // '@parent:ID'
  */
 export declare function createKeywordReference(type: MetadataKeywordType, value: string): string;
+//# sourceMappingURL=metadata-keywords.d.ts.map

package/dist/constants/metadata-keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-keywords.d.ts","sourceRoot":"","sources":["../../src/constants/metadata-keywords.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;;;;;;;;OAUG;;IAGH;;;;;;;;;;;OAWG;;IAGH;;;;;;;;;;OAUG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;;OAUG;;CAEK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,aAAa,CAAC,MAAM,CAAoC,CAAC;AAEjG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAoBhF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAElE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BhE;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,iCAG7B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,2BAA2B,4CAI9B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,uBAElB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,oBAEnB,CAAC;AAEX;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAavF"}

package/dist/constants/metadata-keywords.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Centralized metadata keyword constants for MemberJunction MetadataSync package.
  *
@@ -25,13 +24,11 @@
  *   "PromptID": "@parent:ID"
  * }
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createKeywordReference = exports.isExternalReferenceKeyword = exports.isContextDependentKeyword = exports.RUNTIME_KEYWORDS = exports.LOOKUP_KEYWORDS = exports.EXTERNAL_REFERENCE_KEYWORDS = exports.CONTEXT_DEPENDENT_KEYWORDS = exports.extractKeywordValue = exports.isNonKeywordAtSymbol = exports.hasMetadataKeyword = exports.getMetadataKeywordType = exports.isMetadataKeyword = exports.METADATA_KEYWORD_PREFIXES = exports.METADATA_KEYWORDS = void 0;
 /**
  * Metadata keyword constants.
  * These are the special @ prefixes recognized by MetadataSync for field value processing.
  */
-exports.METADATA_KEYWORDS = {
+export const METADATA_KEYWORDS = {
     /**
      * @file: - Loads content from an external file
      *
@@ -129,7 +126,7 @@ exports.METADATA_KEYWORDS = {
  * Array of all metadata keyword prefixes for iteration.
  * This array maintains the order of keywords for consistent processing.
  */
-exports.METADATA_KEYWORD_PREFIXES = Object.values(exports.METADATA_KEYWORDS);
+export const METADATA_KEYWORD_PREFIXES = Object.values(METADATA_KEYWORDS);
 /**
  * Checks if a value is a string that starts with any recognized metadata keyword.
  *
@@ -148,13 +145,12 @@ exports.METADATA_KEYWORD_PREFIXES = Object.values(exports.METADATA_KEYWORDS);
  * isMetadataKeyword(null)  // false
  * isMetadataKeyword('@unknown:value')  // false
  */
-function isMetadataKeyword(value) {
+export function isMetadataKeyword(value) {
     if (typeof value !== 'string') {
         return false;
     }
-    return exports.METADATA_KEYWORD_PREFIXES.some(prefix => value.startsWith(prefix));
+    return METADATA_KEYWORD_PREFIXES.some(prefix => value.startsWith(prefix));
 }
-exports.isMetadataKeyword = isMetadataKeyword;
 /**
  * Determines which metadata keyword type a string value uses.
  *
@@ -172,16 +168,16 @@ exports.isMetadataKeyword = isMetadataKeyword;
  * getMetadataKeywordType('regular string')  // null
  * getMetadataKeywordType('@unknown:value')  // null
  */
-function getMetadataKeywordType(value) {
+export function getMetadataKeywordType(value) {
     if (typeof value !== 'string') {
         return null;
     }
     // Special handling for @include which doesn't require a colon
-    if (value === exports.METADATA_KEYWORDS.INCLUDE || value.startsWith(`${exports.METADATA_KEYWORDS.INCLUDE}.`)) {
+    if (value === METADATA_KEYWORDS.INCLUDE || value.startsWith(`${METADATA_KEYWORDS.INCLUDE}.`)) {
         return 'include';
     }
     // Check all other keywords
-    for (const [key, prefix] of Object.entries(exports.METADATA_KEYWORDS)) {
+    for (const [key, prefix] of Object.entries(METADATA_KEYWORDS)) {
         if (key === 'INCLUDE')
             continue; // Already handled above
         if (value.startsWith(prefix)) {
@@ -190,7 +186,6 @@ function getMetadataKeywordType(value) {
     }
     return null;
 }
-exports.getMetadataKeywordType = getMetadataKeywordType;
 /**
  * Type-safe check for metadata keywords that handles any value type.
  *
@@ -207,10 +202,9 @@ exports.getMetadataKeywordType = getMetadataKeywordType;
  *   const type = getMetadataKeywordType(fieldValue);
  * }
  */
-function hasMetadataKeyword(value) {
+export function hasMetadataKeyword(value) {
     return isMetadataKeyword(value);
 }
-exports.hasMetadataKeyword = hasMetadataKeyword;
 /**
  * Checks if a string starts with @ but is NOT a metadata keyword.
  *
@@ -226,12 +220,11 @@ exports.hasMetadataKeyword = hasMetadataKeyword;
  * isNonKeywordAtSymbol('@file:template.md')  // false
  * isNonKeywordAtSymbol('regular string')  // false
  */
-function isNonKeywordAtSymbol(value) {
+export function isNonKeywordAtSymbol(value) {
     return typeof value === 'string' &&
         value.startsWith('@') &&
         !isMetadataKeyword(value);
 }
-exports.isNonKeywordAtSymbol = isNonKeywordAtSymbol;
 /**
  * Extracts the value portion after a metadata keyword prefix.
  *
@@ -247,7 +240,7 @@ exports.isNonKeywordAtSymbol = isNonKeywordAtSymbol;
  * extractKeywordValue('@parent:ID')  // 'ID'
  * extractKeywordValue('regular string')  // null
  */
-function extractKeywordValue(value) {
+export function extractKeywordValue(value) {
     if (typeof value !== 'string') {
         return null;
     }
@@ -257,52 +250,51 @@ function extractKeywordValue(value) {
     }
     // Special handling for @include
     if (keywordType === 'include') {
-        if (value === exports.METADATA_KEYWORDS.INCLUDE) {
+        if (value === METADATA_KEYWORDS.INCLUDE) {
             return ''; // Just '@include' with no suffix
         }
-        if (value.startsWith(`${exports.METADATA_KEYWORDS.INCLUDE}.`)) {
-            return value.substring(exports.METADATA_KEYWORDS.INCLUDE.length + 1); // Remove '@include.'
+        if (value.startsWith(`${METADATA_KEYWORDS.INCLUDE}.`)) {
+            return value.substring(METADATA_KEYWORDS.INCLUDE.length + 1); // Remove '@include.'
         }
         return null;
     }
     // For all other keywords, find the matching prefix and remove it
-    for (const prefix of exports.METADATA_KEYWORD_PREFIXES) {
+    for (const prefix of METADATA_KEYWORD_PREFIXES) {
         if (value.startsWith(prefix)) {
             return value.substring(prefix.length);
         }
     }
     return null;
 }
-exports.extractKeywordValue = extractKeywordValue;
 /**
  * List of metadata keywords that require a parent context to function.
  * These keywords cannot be used at the top level of metadata - they only work
  * in nested/related entities where a parent record exists.
  */
-exports.CONTEXT_DEPENDENT_KEYWORDS = [
-    exports.METADATA_KEYWORDS.PARENT,
-    exports.METADATA_KEYWORDS.ROOT,
+export const CONTEXT_DEPENDENT_KEYWORDS = [
+    METADATA_KEYWORDS.PARENT,
+    METADATA_KEYWORDS.ROOT,
 ];
 /**
  * List of metadata keywords that reference external resources.
  * These keywords load content from files, URLs, or other external sources.
  */
-exports.EXTERNAL_REFERENCE_KEYWORDS = [
-    exports.METADATA_KEYWORDS.FILE,
-    exports.METADATA_KEYWORDS.URL,
-    exports.METADATA_KEYWORDS.TEMPLATE,
+export const EXTERNAL_REFERENCE_KEYWORDS = [
+    METADATA_KEYWORDS.FILE,
+    METADATA_KEYWORDS.URL,
+    METADATA_KEYWORDS.TEMPLATE,
 ];
 /**
  * List of metadata keywords that perform database lookups.
  */
-exports.LOOKUP_KEYWORDS = [
-    exports.METADATA_KEYWORDS.LOOKUP,
+export const LOOKUP_KEYWORDS = [
+    METADATA_KEYWORDS.LOOKUP,
 ];
 /**
  * List of metadata keywords that access runtime configuration.
  */
-exports.RUNTIME_KEYWORDS = [
-    exports.METADATA_KEYWORDS.ENV,
+export const RUNTIME_KEYWORDS = [
+    METADATA_KEYWORDS.ENV,
 ];
 /**
  * Checks if a keyword requires a parent/root context.
@@ -315,10 +307,9 @@ exports.RUNTIME_KEYWORDS = [
  * isContextDependentKeyword('@root:')  // true
  * isContextDependentKeyword('@file:')  // false
  */
-function isContextDependentKeyword(keyword) {
-    return exports.CONTEXT_DEPENDENT_KEYWORDS.some(k => keyword.startsWith(k));
+export function isContextDependentKeyword(keyword) {
+    return CONTEXT_DEPENDENT_KEYWORDS.some(k => keyword.startsWith(k));
 }
-exports.isContextDependentKeyword = isContextDependentKeyword;
 /**
  * Checks if a keyword references an external resource.
  *
@@ -330,10 +321,9 @@ exports.isContextDependentKeyword = isContextDependentKeyword;
  * isExternalReferenceKeyword('@url:')  // true
  * isExternalReferenceKeyword('@lookup:')  // false
  */
-function isExternalReferenceKeyword(keyword) {
-    return exports.EXTERNAL_REFERENCE_KEYWORDS.some(k => keyword.startsWith(k));
+export function isExternalReferenceKeyword(keyword) {
+    return EXTERNAL_REFERENCE_KEYWORDS.some(k => keyword.startsWith(k));
 }
-exports.isExternalReferenceKeyword = isExternalReferenceKeyword;
 /**
  * Creates a metadata keyword reference string.
  *
@@ -349,8 +339,8 @@ exports.isExternalReferenceKeyword = isExternalReferenceKeyword;
  * createKeywordReference('lookup', 'Users.Email=test@example.com')  // '@lookup:Users.Email=test@example.com'
  * createKeywordReference('parent', 'ID')  // '@parent:ID'
  */
-function createKeywordReference(type, value) {
-    const keyword = exports.METADATA_KEYWORDS[type.toUpperCase()];
+export function createKeywordReference(type, value) {
+    const keyword = METADATA_KEYWORDS[type.toUpperCase()];
     if (!keyword) {
         throw new Error(`Unknown metadata keyword type: ${type}`);
     }
@@ -360,5 +350,4 @@ function createKeywordReference(type, value) {
     }
     return `${keyword}${value}`;
 }
-exports.createKeywordReference = createKeywordReference;
 //# sourceMappingURL=metadata-keywords.js.map

package/dist/constants/metadata-keywords.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-keywords.js","sourceRoot":"","sources":["../../src/constants/metadata-keywords.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Centralized metadata keyword constants for MemberJunction MetadataSync package.\n *\n * These keywords are special prefixes used in metadata JSON files to reference external\n * content, perform lookups, access environment variables, and establish hierarchical relationships.\n *\n * @module metadata-keywords\n *\n * @example\n * // Using @file: to reference external content\n * {\n *   \"Prompt\": \"@file:greeting.prompt.md\"\n * }\n *\n * @example\n * // Using @lookup: to find an entity by field value\n * {\n *   \"CategoryID\": \"@lookup:AI Prompt Categories.Name=Examples\"\n * }\n *\n * @example\n * // Using @parent: to reference parent entity fields\n * {\n *   \"PromptID\": \"@parent:ID\"\n * }\n */\n\n/**\n * Metadata keyword constants.\n * These are the special @ prefixes recognized by MetadataSync for field value processing.\n */\nexport const METADATA_KEYWORDS = {\n  /**\n   * @file: - Loads content from an external file\n   *\n   * Reads the contents of a file (relative to the JSON metadata file) and uses it as the field value.\n   * Supports text files, markdown, JSON, and other formats.\n   *\n   * @example\n   * \"@file:greeting.prompt.md\"\n   * \"@file:./shared/common-prompt.md\"\n   * \"@file:../templates/standard-header.md\"\n   */\n  FILE: '@file:',\n\n  /**\n   * @lookup: - Looks up an entity record by field value(s)\n   *\n   * Finds an entity record matching the specified criteria and uses its ID.\n   * Supports single-field and multi-field lookups, with optional auto-creation.\n   *\n   * @example\n   * \"@lookup:AI Prompt Types.Name=Chat\"\n   * \"@lookup:Users.Email=john@example.com&Department=Sales\"\n   * \"@lookup:Categories.Name=Examples?create\"\n   * \"@lookup:Categories.Name=Examples?create&Description=Example prompts\"\n   */\n  LOOKUP: '@lookup:',\n\n  /**\n   * @parent: - References a field from the parent entity\n   *\n   * In nested/related entity structures, accesses a field value from the immediate parent record.\n   * Only valid when processing nested entities that have a parent context.\n   *\n   * @example\n   * \"@parent:ID\"\n   * \"@parent:Name\"\n   * \"@parent:CategoryID\"\n   */\n  PARENT: '@parent:',\n\n  /**\n   * @root: - References a field from the root entity\n   *\n   * In nested/related entity structures, accesses a field value from the top-level root record.\n   * Only valid when processing nested entities that have a root context.\n   *\n   * @example\n   * \"@root:ID\"\n   * \"@root:Name\"\n   */\n  ROOT: '@root:',\n\n  /**\n   * @env: - Reads an environment variable\n   *\n   * Gets the value of an environment variable at runtime.\n   * Useful for configuration values that differ between environments.\n   *\n   * @example\n   * \"@env:VARIABLE_NAME\"\n   * \"@env:NODE_ENV\"\n   */\n  ENV: '@env:',\n\n  /**\n   * @url: - Fetches content from a URL\n   *\n   * Downloads content from a remote URL and uses it as the field value.\n   * Supports HTTP/HTTPS URLs and file:// URLs.\n   *\n   * @example\n   * \"@url:https://example.com/prompts/greeting.md\"\n   * \"@url:https://raw.githubusercontent.com/company/prompts/main/customer.md\"\n   */\n  URL: '@url:',\n\n  /**\n   * @template: - Loads a template JSON file\n   *\n   * Loads a JSON template file and uses its contents, replacing any template variables.\n   * Useful for standardizing common configurations across multiple records.\n   *\n   * @example\n   * \"@template:templates/standard-ai-models.json\"\n   */\n  TEMPLATE: '@template:',\n\n  /**\n   * @include or @include.* - Includes content from another file\n   *\n   * Special directive (not a field value) that merges content from external files.\n   * Can be used in both objects and arrays. Supports spread and property modes.\n   *\n   * @example\n   * { \"@include\": \"common-fields.json\" }\n   * [ \"@include:items.json\" ]\n   * { \"@include.models\": { \"file\": \"models.json\", \"mode\": \"property\" } }\n   */\n  INCLUDE: '@include',\n} as const;\n\n/**\n * Type representing all metadata keyword values.\n */\nexport type MetadataKeyword = typeof METADATA_KEYWORDS[keyof typeof METADATA_KEYWORDS];\n\n/**\n * Type representing metadata keyword types (without the colon for keywords that have it).\n */\nexport type MetadataKeywordType = 'file' | 'lookup' | 'parent' | 'root' | 'env' | 'url' | 'template' | 'include';\n\n/**\n * Array of all metadata keyword prefixes for iteration.\n * This array maintains the order of keywords for consistent processing.\n */\nexport const METADATA_KEYWORD_PREFIXES: ReadonlyArray<string> = Object.values(METADATA_KEYWORDS);\n\n/**\n * Checks if a value is a string that starts with any recognized metadata keyword.\n *\n * This is a type-safe check that handles non-string values gracefully.\n * Returns false for null, undefined, objects, numbers, etc.\n *\n * @param value - The value to check (can be any type)\n * @returns true if value is a string starting with a metadata keyword, false otherwise\n *\n * @example\n * isMetadataKeyword('@file:template.md')  // true\n * isMetadataKeyword('@lookup:Users.Email=test@example.com')  // true\n * isMetadataKeyword('@parent:ID')  // true\n * isMetadataKeyword('regular string')  // false\n * isMetadataKeyword(123)  // false\n * isMetadataKeyword(null)  // false\n * isMetadataKeyword('@unknown:value')  // false\n */\nexport function isMetadataKeyword(value: unknown): value is string {\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return METADATA_KEYWORD_PREFIXES.some(prefix => value.startsWith(prefix));\n}\n\n/**\n * Determines which metadata keyword type a string value uses.\n *\n * Examines the prefix of a string and returns the corresponding keyword type.\n * Returns null if the value doesn't use any recognized metadata keyword.\n *\n * @param value - The string value to analyze\n * @returns The keyword type ('file', 'lookup', etc.) or null if no keyword is found\n *\n * @example\n * getMetadataKeywordType('@file:template.md')  // 'file'\n * getMetadataKeywordType('@lookup:Users.Name=John')  // 'lookup'\n * getMetadataKeywordType('@parent:ID')  // 'parent'\n * getMetadataKeywordType('@include')  // 'include'\n * getMetadataKeywordType('regular string')  // null\n * getMetadataKeywordType('@unknown:value')  // null\n */\nexport function getMetadataKeywordType(value: string): MetadataKeywordType | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n\n  // Special handling for @include which doesn't require a colon\n  if (value === METADATA_KEYWORDS.INCLUDE || value.startsWith(`${METADATA_KEYWORDS.INCLUDE}.`)) {\n    return 'include';\n  }\n\n  // Check all other keywords\n  for (const [key, prefix] of Object.entries(METADATA_KEYWORDS)) {\n    if (key === 'INCLUDE') continue; // Already handled above\n\n    if (value.startsWith(prefix)) {\n      return key.toLowerCase() as MetadataKeywordType;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Type-safe check for metadata keywords that handles any value type.\n *\n * This is an alias for isMetadataKeyword() provided for semantic clarity\n * when you want to explicitly check if a value has a metadata keyword.\n *\n * @param value - Any value to check\n * @returns true if value is a string with a metadata keyword, false otherwise\n *\n * @example\n * const fieldValue = record.Get('SomeField');\n * if (hasMetadataKeyword(fieldValue)) {\n *   // fieldValue is guaranteed to be a string with a metadata keyword\n *   const type = getMetadataKeywordType(fieldValue);\n * }\n */\nexport function hasMetadataKeyword(value: unknown): value is string {\n  return isMetadataKeyword(value);\n}\n\n/**\n * Checks if a string starts with @ but is NOT a metadata keyword.\n *\n * This is useful for filtering out @ strings that are not metadata keywords,\n * such as npm package names (@mui/material, @angular/core) or email addresses.\n *\n * @param value - The value to check\n * @returns true if value starts with @ but is not a metadata keyword\n *\n * @example\n * isNonKeywordAtSymbol('@mui/material')  // true\n * isNonKeywordAtSymbol('@angular/core')  // true\n * isNonKeywordAtSymbol('@file:template.md')  // false\n * isNonKeywordAtSymbol('regular string')  // false\n */\nexport function isNonKeywordAtSymbol(value: unknown): boolean {\n  return typeof value === 'string' &&\n         value.startsWith('@') &&\n         !isMetadataKeyword(value);\n}\n\n/**\n * Extracts the value portion after a metadata keyword prefix.\n *\n * Removes the keyword prefix from a string and returns the remaining value.\n * Returns null if the string doesn't use a metadata keyword.\n *\n * @param value - The string containing a metadata keyword\n * @returns The value after the keyword prefix, or null if no keyword found\n *\n * @example\n * extractKeywordValue('@file:template.md')  // 'template.md'\n * extractKeywordValue('@lookup:Users.Email=test@example.com')  // 'Users.Email=test@example.com'\n * extractKeywordValue('@parent:ID')  // 'ID'\n * extractKeywordValue('regular string')  // null\n */\nexport function extractKeywordValue(value: string): string | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n\n  const keywordType = getMetadataKeywordType(value);\n  if (!keywordType) {\n    return null;\n  }\n\n  // Special handling for @include\n  if (keywordType === 'include') {\n    if (value === METADATA_KEYWORDS.INCLUDE) {\n      return '';  // Just '@include' with no suffix\n    }\n    if (value.startsWith(`${METADATA_KEYWORDS.INCLUDE}.`)) {\n      return value.substring(METADATA_KEYWORDS.INCLUDE.length + 1);  // Remove '@include.'\n    }\n    return null;\n  }\n\n  // For all other keywords, find the matching prefix and remove it\n  for (const prefix of METADATA_KEYWORD_PREFIXES) {\n    if (value.startsWith(prefix)) {\n      return value.substring(prefix.length);\n    }\n  }\n\n  return null;\n}\n\n/**\n * List of metadata keywords that require a parent context to function.\n * These keywords cannot be used at the top level of metadata - they only work\n * in nested/related entities where a parent record exists.\n */\nexport const CONTEXT_DEPENDENT_KEYWORDS = [\n  METADATA_KEYWORDS.PARENT,\n  METADATA_KEYWORDS.ROOT,\n] as const;\n\n/**\n * List of metadata keywords that reference external resources.\n * These keywords load content from files, URLs, or other external sources.\n */\nexport const EXTERNAL_REFERENCE_KEYWORDS = [\n  METADATA_KEYWORDS.FILE,\n  METADATA_KEYWORDS.URL,\n  METADATA_KEYWORDS.TEMPLATE,\n] as const;\n\n/**\n * List of metadata keywords that perform database lookups.\n */\nexport const LOOKUP_KEYWORDS = [\n  METADATA_KEYWORDS.LOOKUP,\n] as const;\n\n/**\n * List of metadata keywords that access runtime configuration.\n */\nexport const RUNTIME_KEYWORDS = [\n  METADATA_KEYWORDS.ENV,\n] as const;\n\n/**\n * Checks if a keyword requires a parent/root context.\n *\n * @param keyword - The keyword to check\n * @returns true if the keyword requires context (parent or root)\n *\n * @example\n * isContextDependentKeyword('@parent:')  // true\n * isContextDependentKeyword('@root:')  // true\n * isContextDependentKeyword('@file:')  // false\n */\nexport function isContextDependentKeyword(keyword: string): boolean {\n  return CONTEXT_DEPENDENT_KEYWORDS.some(k => keyword.startsWith(k));\n}\n\n/**\n * Checks if a keyword references an external resource.\n *\n * @param keyword - The keyword to check\n * @returns true if the keyword loads external content\n *\n * @example\n * isExternalReferenceKeyword('@file:')  // true\n * isExternalReferenceKeyword('@url:')  // true\n * isExternalReferenceKeyword('@lookup:')  // false\n */\nexport function isExternalReferenceKeyword(keyword: string): boolean {\n  return EXTERNAL_REFERENCE_KEYWORDS.some(k => keyword.startsWith(k));\n}\n\n/**\n * Creates a metadata keyword reference string.\n *\n * Helper function to construct properly formatted keyword references.\n * This ensures consistent formatting across the codebase.\n *\n * @param type - The keyword type\n * @param value - The value after the keyword\n * @returns Formatted keyword reference string\n *\n * @example\n * createKeywordReference('file', 'template.md')  // '@file:template.md'\n * createKeywordReference('lookup', 'Users.Email=test@example.com')  // '@lookup:Users.Email=test@example.com'\n * createKeywordReference('parent', 'ID')  // '@parent:ID'\n */\nexport function createKeywordReference(type: MetadataKeywordType, value: string): string {\n  const keyword = METADATA_KEYWORDS[type.toUpperCase() as keyof typeof METADATA_KEYWORDS];\n\n  if (!keyword) {\n    throw new Error(`Unknown metadata keyword type: ${type}`);\n  }\n\n  // Special handling for @include\n  if (type === 'include') {\n    return value ? `${keyword}.${value}` : keyword;\n  }\n\n  return `${keyword}${value}`;\n}\n"]}
+{"version":3,"file":"metadata-keywords.js","sourceRoot":"","sources":["../../src/constants/metadata-keywords.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,37 +1,39 @@
-export { FileBackupManager } from './lib/file-backup-manager';
-export { SyncEngine, DeferrableLookupError } from './lib/sync-engine';
-export type { RecordData } from './lib/sync-engine';
-export { ConfigManager, configManager } from './lib/config-manager';
-export { getSyncEngine, resetSyncEngine } from './lib/singleton-manager';
-export { SQLLogger } from './lib/sql-logger';
-export { TransactionManager } from './lib/transaction-manager';
-export { JsonWriteHelper } from './lib/json-write-helper';
-export { FileWriteBatch } from './lib/file-write-batch';
-export { JsonPreprocessor } from './lib/json-preprocessor';
-export type { IncludeDirective } from './lib/json-preprocessor';
-export { RecordDependencyAnalyzer } from './lib/record-dependency-analyzer';
-export type { FlattenedRecord, ReverseDependency, DependencyAnalysisResult } from './lib/record-dependency-analyzer';
-export { EntityForeignKeyHelper } from './lib/entity-foreign-key-helper';
-export type { ReverseFKInfo } from './lib/entity-foreign-key-helper';
-export { DatabaseReferenceScanner } from './lib/database-reference-scanner';
-export type { DatabaseReference } from './lib/database-reference-scanner';
-export { DeletionAuditor } from './lib/deletion-auditor';
-export type { DeletionAudit } from './lib/deletion-auditor';
-export { DeletionReportGenerator } from './lib/deletion-report-generator';
-export { InitService } from './services/InitService';
-export type { InitOptions, InitCallbacks } from './services/InitService';
-export { PullService } from './services/PullService';
-export type { PullOptions, PullCallbacks, PullResult } from './services/PullService';
-export { PushService } from './services/PushService';
-export type { PushOptions, PushCallbacks, PushResult } from './services/PushService';
-export { StatusService } from './services/StatusService';
-export type { StatusOptions, StatusCallbacks, StatusResult } from './services/StatusService';
-export { FileResetService } from './services/FileResetService';
-export type { FileResetOptions, FileResetCallbacks, FileResetResult } from './services/FileResetService';
-export { WatchService } from './services/WatchService';
-export type { WatchOptions, WatchCallbacks, WatchResult } from './services/WatchService';
-export { ValidationService } from './services/ValidationService';
-export { FormattingService } from './services/FormattingService';
-export { loadMJConfig, loadSyncConfig, loadEntityConfig, loadFolderConfig, type EntityConfig, type FolderConfig, type RelatedEntityConfig } from './config';
-export { initializeProvider, getSystemUser, findEntityDirectories, getDataProvider } from './lib/provider-utils';
-export type { ValidationResult, ValidationError, ValidationWarning, EntityDependency, FileValidationResult, ValidationOptions, ReferenceType, ParsedReference } from './types/validation';
+import '@memberjunction/server-bootstrap-lite/mj-class-registrations';
+export { FileBackupManager } from './lib/file-backup-manager.js';
+export { SyncEngine, DeferrableLookupError } from './lib/sync-engine.js';
+export type { RecordData } from './lib/sync-engine.js';
+export { ConfigManager, configManager } from './lib/config-manager.js';
+export { getSyncEngine, resetSyncEngine } from './lib/singleton-manager.js';
+export { SQLLogger } from './lib/sql-logger.js';
+export { TransactionManager } from './lib/transaction-manager.js';
+export { JsonWriteHelper } from './lib/json-write-helper.js';
+export { FileWriteBatch } from './lib/file-write-batch.js';
+export { JsonPreprocessor } from './lib/json-preprocessor.js';
+export type { IncludeDirective } from './lib/json-preprocessor.js';
+export { RecordDependencyAnalyzer } from './lib/record-dependency-analyzer.js';
+export type { FlattenedRecord, ReverseDependency, DependencyAnalysisResult } from './lib/record-dependency-analyzer.js';
+export { EntityForeignKeyHelper } from './lib/entity-foreign-key-helper.js';
+export type { ReverseFKInfo } from './lib/entity-foreign-key-helper.js';
+export { DatabaseReferenceScanner } from './lib/database-reference-scanner.js';
+export type { DatabaseReference } from './lib/database-reference-scanner.js';
+export { DeletionAuditor } from './lib/deletion-auditor.js';
+export type { DeletionAudit } from './lib/deletion-auditor.js';
+export { DeletionReportGenerator } from './lib/deletion-report-generator.js';
+export { InitService } from './services/InitService.js';
+export type { InitOptions, InitCallbacks } from './services/InitService.js';
+export { PullService } from './services/PullService.js';
+export type { PullOptions, PullCallbacks, PullResult } from './services/PullService.js';
+export { PushService } from './services/PushService.js';
+export type { PushOptions, PushCallbacks, PushResult } from './services/PushService.js';
+export { StatusService } from './services/StatusService.js';
+export type { StatusOptions, StatusCallbacks, StatusResult } from './services/StatusService.js';
+export { FileResetService } from './services/FileResetService.js';
+export type { FileResetOptions, FileResetCallbacks, FileResetResult } from './services/FileResetService.js';
+export { WatchService } from './services/WatchService.js';
+export type { WatchOptions, WatchCallbacks, WatchResult } from './services/WatchService.js';
+export { ValidationService } from './services/ValidationService.js';
+export { FormattingService } from './services/FormattingService.js';
+export { loadMJConfig, loadSyncConfig, loadEntityConfig, loadFolderConfig, type EntityConfig, type FolderConfig, type RelatedEntityConfig } from './config.js';
+export { initializeProvider, getSystemUser, findEntityDirectories, getDataProvider } from './lib/provider-utils.js';
+export type { ValidationResult, ValidationError, ValidationWarning, EntityDependency, FileValidationResult, ValidationOptions, ReferenceType, ParsedReference } from './types/validation.js';
+//# 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":"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"}