@memberjunction/query-gen 0.0.1 → 2.126.1

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * QueryGen package main entry point
+ *
+ * @memberjunction/query-gen
+ *
+ * AI-powered generation of domain-specific SQL query templates with
+ * automatic testing, refinement, and metadata export.
+ */
+export { EntityGrouper } from './core/EntityGrouper';
+export { QuestionGenerator } from './core/QuestionGenerator';
+export { QueryWriter } from './core/QueryWriter';
+export { QueryTester } from './core/QueryTester';
+export { QueryFixer } from './core/QueryFixer';
+export { QueryRefiner } from './core/QueryRefiner';
+export { MetadataExporter } from './core/MetadataExporter';
+export { QueryDatabaseWriter } from './core/QueryDatabaseWriter';
+export { SimilaritySearch } from './vectors/SimilaritySearch';
+export { EmbeddingService } from './vectors/EmbeddingService';
+export * from './data/schema';
+export * from './prompts/PromptNames';
+export { QueryGenConfig, loadConfig } from './cli/config';
+export { generateCommand } from './cli/commands/generate';
+export { validateCommand } from './cli/commands/validate';
+export { exportCommand } from './cli/commands/export';
+export { extractErrorMessage, requireValue, getPropertyOrDefault } from './utils/error-handlers';
+export { formatEntityMetadataForPrompt, formatEntityGroupForPrompt, findEntityById, getPrimaryKeyFields, getForeignKeyFields, hasRelationships, getRelationshipCount } from './utils/entity-helpers';
+export { generateQueryName } from './utils/query-helpers';
+//# 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":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,cAAc,eAAe,CAAC;AAG9B,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * QueryGen package main entry point
+ *
+ * @memberjunction/query-gen
+ *
+ * AI-powered generation of domain-specific SQL query templates with
+ * automatic testing, refinement, and metadata export.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateQueryName = exports.getRelationshipCount = exports.hasRelationships = exports.getForeignKeyFields = exports.getPrimaryKeyFields = exports.findEntityById = exports.formatEntityGroupForPrompt = exports.formatEntityMetadataForPrompt = exports.getPropertyOrDefault = exports.requireValue = exports.extractErrorMessage = exports.exportCommand = exports.validateCommand = exports.generateCommand = exports.loadConfig = exports.EmbeddingService = exports.SimilaritySearch = exports.QueryDatabaseWriter = exports.MetadataExporter = exports.QueryRefiner = exports.QueryFixer = exports.QueryTester = exports.QueryWriter = exports.QuestionGenerator = exports.EntityGrouper = void 0;
+// Export core classes
+var EntityGrouper_1 = require("./core/EntityGrouper");
+Object.defineProperty(exports, "EntityGrouper", { enumerable: true, get: function () { return EntityGrouper_1.EntityGrouper; } });
+var QuestionGenerator_1 = require("./core/QuestionGenerator");
+Object.defineProperty(exports, "QuestionGenerator", { enumerable: true, get: function () { return QuestionGenerator_1.QuestionGenerator; } });
+var QueryWriter_1 = require("./core/QueryWriter");
+Object.defineProperty(exports, "QueryWriter", { enumerable: true, get: function () { return QueryWriter_1.QueryWriter; } });
+var QueryTester_1 = require("./core/QueryTester");
+Object.defineProperty(exports, "QueryTester", { enumerable: true, get: function () { return QueryTester_1.QueryTester; } });
+var QueryFixer_1 = require("./core/QueryFixer");
+Object.defineProperty(exports, "QueryFixer", { enumerable: true, get: function () { return QueryFixer_1.QueryFixer; } });
+var QueryRefiner_1 = require("./core/QueryRefiner");
+Object.defineProperty(exports, "QueryRefiner", { enumerable: true, get: function () { return QueryRefiner_1.QueryRefiner; } });
+var MetadataExporter_1 = require("./core/MetadataExporter");
+Object.defineProperty(exports, "MetadataExporter", { enumerable: true, get: function () { return MetadataExporter_1.MetadataExporter; } });
+var QueryDatabaseWriter_1 = require("./core/QueryDatabaseWriter");
+Object.defineProperty(exports, "QueryDatabaseWriter", { enumerable: true, get: function () { return QueryDatabaseWriter_1.QueryDatabaseWriter; } });
+// Export utility classes
+var SimilaritySearch_1 = require("./vectors/SimilaritySearch");
+Object.defineProperty(exports, "SimilaritySearch", { enumerable: true, get: function () { return SimilaritySearch_1.SimilaritySearch; } });
+var EmbeddingService_1 = require("./vectors/EmbeddingService");
+Object.defineProperty(exports, "EmbeddingService", { enumerable: true, get: function () { return EmbeddingService_1.EmbeddingService; } });
+// Export types
+__exportStar(require("./data/schema"), exports);
+// Export prompt names
+__exportStar(require("./prompts/PromptNames"), exports);
+// Export configuration
+var config_1 = require("./cli/config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+// Export CLI commands
+var generate_1 = require("./cli/commands/generate");
+Object.defineProperty(exports, "generateCommand", { enumerable: true, get: function () { return generate_1.generateCommand; } });
+var validate_1 = require("./cli/commands/validate");
+Object.defineProperty(exports, "validateCommand", { enumerable: true, get: function () { return validate_1.validateCommand; } });
+var export_1 = require("./cli/commands/export");
+Object.defineProperty(exports, "exportCommand", { enumerable: true, get: function () { return export_1.exportCommand; } });
+// Export utilities
+var error_handlers_1 = require("./utils/error-handlers");
+Object.defineProperty(exports, "extractErrorMessage", { enumerable: true, get: function () { return error_handlers_1.extractErrorMessage; } });
+Object.defineProperty(exports, "requireValue", { enumerable: true, get: function () { return error_handlers_1.requireValue; } });
+Object.defineProperty(exports, "getPropertyOrDefault", { enumerable: true, get: function () { return error_handlers_1.getPropertyOrDefault; } });
+var entity_helpers_1 = require("./utils/entity-helpers");
+Object.defineProperty(exports, "formatEntityMetadataForPrompt", { enumerable: true, get: function () { return entity_helpers_1.formatEntityMetadataForPrompt; } });
+Object.defineProperty(exports, "formatEntityGroupForPrompt", { enumerable: true, get: function () { return entity_helpers_1.formatEntityGroupForPrompt; } });
+Object.defineProperty(exports, "findEntityById", { enumerable: true, get: function () { return entity_helpers_1.findEntityById; } });
+Object.defineProperty(exports, "getPrimaryKeyFields", { enumerable: true, get: function () { return entity_helpers_1.getPrimaryKeyFields; } });
+Object.defineProperty(exports, "getForeignKeyFields", { enumerable: true, get: function () { return entity_helpers_1.getForeignKeyFields; } });
+Object.defineProperty(exports, "hasRelationships", { enumerable: true, get: function () { return entity_helpers_1.hasRelationships; } });
+Object.defineProperty(exports, "getRelationshipCount", { enumerable: true, get: function () { return entity_helpers_1.getRelationshipCount; } });
+var query_helpers_1 = require("./utils/query-helpers");
+Object.defineProperty(exports, "generateQueryName", { enumerable: true, get: function () { return query_helpers_1.generateQueryName; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;AAEH,sBAAsB;AACtB,sDAAqD;AAA5C,8GAAA,aAAa,OAAA;AACtB,8DAA6D;AAApD,sHAAA,iBAAiB,OAAA;AAC1B,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AACpB,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AACpB,gDAA+C;AAAtC,wGAAA,UAAU,OAAA;AACnB,oDAAmD;AAA1C,4GAAA,YAAY,OAAA;AACrB,4DAA2D;AAAlD,oHAAA,gBAAgB,OAAA;AACzB,kEAAiE;AAAxD,0HAAA,mBAAmB,OAAA;AAE5B,yBAAyB;AACzB,+DAA8D;AAArD,oHAAA,gBAAgB,OAAA;AACzB,+DAA8D;AAArD,oHAAA,gBAAgB,OAAA;AAEzB,eAAe;AACf,gDAA8B;AAE9B,sBAAsB;AACtB,wDAAsC;AAEtC,uBAAuB;AACvB,uCAA0D;AAAjC,oGAAA,UAAU,OAAA;AAEnC,sBAAsB;AACtB,oDAA0D;AAAjD,2GAAA,eAAe,OAAA;AACxB,oDAA0D;AAAjD,2GAAA,eAAe,OAAA;AACxB,gDAAsD;AAA7C,uGAAA,aAAa,OAAA;AAEtB,mBAAmB;AACnB,yDAAiG;AAAxF,qHAAA,mBAAmB,OAAA;AAAE,8GAAA,YAAY,OAAA;AAAE,sHAAA,oBAAoB,OAAA;AAChE,yDAQgC;AAP9B,+HAAA,6BAA6B,OAAA;AAC7B,4HAAA,0BAA0B,OAAA;AAC1B,gHAAA,cAAc,OAAA;AACd,qHAAA,mBAAmB,OAAA;AACnB,qHAAA,mBAAmB,OAAA;AACnB,kHAAA,gBAAgB,OAAA;AAChB,sHAAA,oBAAoB,OAAA;AAEtB,uDAA0D;AAAjD,kHAAA,iBAAiB,OAAA"}

package/dist/prompts/PromptNames.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Static prompt name constants for QueryGen
+ *
+ * All AI prompts used by QueryGen system with their exact names
+ * as defined in the AI Prompt metadata.
+ */
+/**
+ * Business Question Generator prompt
+ * Generates 1-2 business questions per entity group
+ */
+export declare const PROMPT_BUSINESS_QUESTION_GENERATOR = "Business Question Generator";
+/**
+ * SQL Query Writer prompt
+ * Generates Nunjucks SQL templates from business questions
+ */
+export declare const PROMPT_SQL_QUERY_WRITER = "SQL Query Writer";
+/**
+ * SQL Query Fixer prompt
+ * Fixes SQL syntax and logic errors in generated queries
+ */
+export declare const PROMPT_SQL_QUERY_FIXER = "SQL Query Fixer";
+/**
+ * Query Result Evaluator prompt
+ * Evaluates if a query correctly answers the business question
+ */
+export declare const PROMPT_QUERY_EVALUATOR = "Query Result Evaluator";
+/**
+ * Query Refiner prompt
+ * Refines queries based on evaluation feedback
+ */
+export declare const PROMPT_QUERY_REFINER = "Query Refiner";
+//# sourceMappingURL=PromptNames.d.ts.map

package/dist/prompts/PromptNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptNames.d.ts","sourceRoot":"","sources":["../../src/prompts/PromptNames.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,kCAAkC,gCAAgC,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC"}

package/dist/prompts/PromptNames.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Static prompt name constants for QueryGen
+ *
+ * All AI prompts used by QueryGen system with their exact names
+ * as defined in the AI Prompt metadata.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_QUERY_REFINER = exports.PROMPT_QUERY_EVALUATOR = exports.PROMPT_SQL_QUERY_FIXER = exports.PROMPT_SQL_QUERY_WRITER = exports.PROMPT_BUSINESS_QUESTION_GENERATOR = void 0;
+/**
+ * Business Question Generator prompt
+ * Generates 1-2 business questions per entity group
+ */
+exports.PROMPT_BUSINESS_QUESTION_GENERATOR = 'Business Question Generator';
+/**
+ * SQL Query Writer prompt
+ * Generates Nunjucks SQL templates from business questions
+ */
+exports.PROMPT_SQL_QUERY_WRITER = 'SQL Query Writer';
+/**
+ * SQL Query Fixer prompt
+ * Fixes SQL syntax and logic errors in generated queries
+ */
+exports.PROMPT_SQL_QUERY_FIXER = 'SQL Query Fixer';
+/**
+ * Query Result Evaluator prompt
+ * Evaluates if a query correctly answers the business question
+ */
+exports.PROMPT_QUERY_EVALUATOR = 'Query Result Evaluator';
+/**
+ * Query Refiner prompt
+ * Refines queries based on evaluation feedback
+ */
+exports.PROMPT_QUERY_REFINER = 'Query Refiner';
+//# sourceMappingURL=PromptNames.js.map

package/dist/prompts/PromptNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptNames.js","sourceRoot":"","sources":["../../src/prompts/PromptNames.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;GAGG;AACU,QAAA,kCAAkC,GAAG,6BAA6B,CAAC;AAEhF;;;GAGG;AACU,QAAA,uBAAuB,GAAG,kBAAkB,CAAC;AAE1D;;;GAGG;AACU,QAAA,sBAAsB,GAAG,iBAAiB,CAAC;AAExD;;;GAGG;AACU,QAAA,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D;;;GAGG;AACU,QAAA,oBAAoB,GAAG,eAAe,CAAC"}

package/dist/utils/category-builder.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CategoryBuilder - Builds QueryCategoryInfo from configuration and entity groups
+ *
+ * Centralizes the logic for determining what categories should be created
+ * for queries based on the QueryGen configuration.
+ */
+import { QueryCategoryInfo, EntityGroup } from '../data/schema';
+import { QueryGenConfig } from '../cli/config';
+/**
+ * Build category information for a query based on configuration
+ *
+ * @param config - QueryGen configuration
+ * @param entityGroup - Entity group for the query
+ * @returns QueryCategoryInfo with full category details
+ */
+export declare function buildQueryCategory(config: QueryGenConfig, entityGroup: EntityGroup): QueryCategoryInfo;
+/**
+ * Extract all unique categories from validated queries
+ * Returns categories in hierarchical order (root first, then children)
+ *
+ * IMPORTANT: Also creates parent categories for any child categories
+ * (e.g., if "Golden-Queries/Members" is provided, also creates "Golden-Queries")
+ *
+ * @param categories - Array of QueryCategoryInfo from validated queries
+ * @returns Unique categories sorted hierarchically (includes auto-generated parents)
+ */
+export declare function extractUniqueCategories(categories: QueryCategoryInfo[]): QueryCategoryInfo[];
+//# sourceMappingURL=category-builder.d.ts.map

package/dist/utils/category-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-builder.d.ts","sourceRoot":"","sources":["../../src/utils/category-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,WAAW,GACvB,iBAAiB,CAgCnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAgC5F"}

package/dist/utils/category-builder.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * CategoryBuilder - Builds QueryCategoryInfo from configuration and entity groups
+ *
+ * Centralizes the logic for determining what categories should be created
+ * for queries based on the QueryGen configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractUniqueCategories = exports.buildQueryCategory = void 0;
+/**
+ * Build category information for a query based on configuration
+ *
+ * @param config - QueryGen configuration
+ * @param entityGroup - Entity group for the query
+ * @returns QueryCategoryInfo with full category details
+ */
+function buildQueryCategory(config, entityGroup) {
+    const rootCategoryName = config.rootQueryCategory || 'Auto-Generated';
+    if (config.autoCreateEntityQueryCategories) {
+        // Create entity-specific category under root
+        const entityName = entityGroup?.primaryEntity?.Name;
+        if (!entityName) {
+            console.warn('buildQueryCategory: primaryEntity.Name is undefined, falling back to root category');
+            return {
+                name: rootCategoryName,
+                parentName: null,
+                description: 'Automatically generated queries from query-gen tool',
+                path: rootCategoryName
+            };
+        }
+        return {
+            name: entityName,
+            parentName: rootCategoryName,
+            description: `Queries for the ${entityName} entity`,
+            path: `${rootCategoryName}/${entityName}`
+        };
+    }
+    else {
+        // Use root category only
+        return {
+            name: rootCategoryName,
+            parentName: null,
+            description: 'Automatically generated queries from query-gen tool',
+            path: rootCategoryName
+        };
+    }
+}
+exports.buildQueryCategory = buildQueryCategory;
+/**
+ * Extract all unique categories from validated queries
+ * Returns categories in hierarchical order (root first, then children)
+ *
+ * IMPORTANT: Also creates parent categories for any child categories
+ * (e.g., if "Golden-Queries/Members" is provided, also creates "Golden-Queries")
+ *
+ * @param categories - Array of QueryCategoryInfo from validated queries
+ * @returns Unique categories sorted hierarchically (includes auto-generated parents)
+ */
+function extractUniqueCategories(categories) {
+    const uniqueMap = new Map();
+    // Collect all unique categories (by path)
+    for (const cat of categories) {
+        if (!uniqueMap.has(cat.path)) {
+            uniqueMap.set(cat.path, cat);
+        }
+        // If this is a child category, ensure parent category exists
+        if (cat.parentName && !uniqueMap.has(cat.parentName)) {
+            uniqueMap.set(cat.parentName, {
+                name: cat.parentName,
+                parentName: null,
+                description: 'Automatically generated queries from query-gen tool',
+                path: cat.parentName
+            });
+        }
+    }
+    // Convert to array and sort: root categories first, then children
+    const result = Array.from(uniqueMap.values());
+    result.sort((a, b) => {
+        // Root categories (no parent) come first
+        if (a.parentName === null && b.parentName !== null)
+            return -1;
+        if (a.parentName !== null && b.parentName === null)
+            return 1;
+        // Then sort alphabetically by path
+        return a.path.localeCompare(b.path);
+    });
+    return result;
+}
+exports.extractUniqueCategories = extractUniqueCategories;
+//# sourceMappingURL=category-builder.js.map

package/dist/utils/category-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-builder.js","sourceRoot":"","sources":["../../src/utils/category-builder.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAKH;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,MAAsB,EACtB,WAAwB;IAExB,MAAM,gBAAgB,GAAG,MAAM,CAAC,iBAAiB,IAAI,gBAAgB,CAAC;IAEtE,IAAI,MAAM,CAAC,+BAA+B,EAAE,CAAC;QAC3C,6CAA6C;QAC7C,MAAM,UAAU,GAAG,WAAW,EAAE,aAAa,EAAE,IAAI,CAAC;QAEpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;YACnG,OAAO;gBACL,IAAI,EAAE,gBAAgB;gBACtB,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,qDAAqD;gBAClE,IAAI,EAAE,gBAAgB;aACvB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,gBAAgB;YAC5B,WAAW,EAAE,mBAAmB,UAAU,SAAS;YACnD,IAAI,EAAE,GAAG,gBAAgB,IAAI,UAAU,EAAE;SAC1C,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,qDAAqD;YAClE,IAAI,EAAE,gBAAgB;SACvB,CAAC;IACJ,CAAC;AACH,CAAC;AAnCD,gDAmCC;AAED;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CAAC,UAA+B;IACrE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEvD,0CAA0C;IAC1C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,6DAA6D;QAC7D,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE;gBAC5B,IAAI,EAAE,GAAG,CAAC,UAAU;gBACpB,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,qDAAqD;gBAClE,IAAI,EAAE,GAAG,CAAC,UAAU;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnB,yCAAyC;QACzC,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QAE7D,mCAAmC;QACnC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAhCD,0DAgCC"}

package/dist/utils/entity-helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Entity helper utilities
+ *
+ * Helper functions for working with entity metadata and formatting for AI prompts
+ */
+import { EntityInfo, EntityFieldInfo } from '@memberjunction/core';
+import { EntityMetadataForPrompt, EntityGroup } from '../data/schema';
+/**
+ * Format entity metadata for AI prompt consumption
+ * Includes schema name, base view, fields, and relationships
+ *
+ * CRITICAL: Must include schemaName and baseView for functional SQL generation
+ *
+ * @param entity - Entity to format
+ * @param allEntities - All available entities for relationship lookups
+ * @returns Formatted entity metadata ready for AI prompts
+ */
+export declare function formatEntityMetadataForPrompt(entity: EntityInfo, allEntities: EntityInfo[]): EntityMetadataForPrompt;
+/**
+ * Find entity by ID in array
+ */
+export declare function findEntityById(id: string, entities: EntityInfo[]): EntityInfo | undefined;
+/**
+ * Get primary key field(s) for an entity
+ */
+export declare function getPrimaryKeyFields(entity: EntityInfo): EntityFieldInfo[];
+/**
+ * Get foreign key fields for an entity
+ */
+export declare function getForeignKeyFields(entity: EntityInfo): EntityFieldInfo[];
+/**
+ * Check if an entity has any relationships
+ * Uses EntityInfo.RelatedEntities getter
+ */
+export declare function hasRelationships(entity: EntityInfo, allEntities: EntityInfo[]): boolean;
+/**
+ * Get count of relationships for an entity
+ * Uses EntityInfo.RelatedEntities getter
+ */
+export declare function getRelationshipCount(entity: EntityInfo, allEntities: EntityInfo[]): number;
+/**
+ * Format an entire entity group for AI prompt consumption
+ * Converts all entities in the group to structured metadata
+ *
+ * @param entityGroup - Entity group to format
+ * @returns Array of formatted entity metadata for Nunjucks template
+ */
+export declare function formatEntityGroupForPrompt(entityGroup: EntityGroup): EntityMetadataForPrompt[];
+//# sourceMappingURL=entity-helpers.d.ts.map

package/dist/utils/entity-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/entity-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,uBAAuB,EAGvB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,uBAAuB,CAUpH;AAwHD;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,EAAE,CAEzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAEvF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAE1F;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,GAAG,uBAAuB,EAAE,CAI9F"}

package/dist/utils/entity-helpers.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Entity helper utilities
+ *
+ * Helper functions for working with entity metadata and formatting for AI prompts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatEntityGroupForPrompt = exports.getRelationshipCount = exports.hasRelationships = exports.getForeignKeyFields = exports.getPrimaryKeyFields = exports.findEntityById = exports.formatEntityMetadataForPrompt = void 0;
+/**
+ * Format entity metadata for AI prompt consumption
+ * Includes schema name, base view, fields, and relationships
+ *
+ * CRITICAL: Must include schemaName and baseView for functional SQL generation
+ *
+ * @param entity - Entity to format
+ * @param allEntities - All available entities for relationship lookups
+ * @returns Formatted entity metadata ready for AI prompts
+ */
+function formatEntityMetadataForPrompt(entity, allEntities) {
+    return {
+        entityName: entity.Name,
+        description: entity.Description || '',
+        schemaName: entity.SchemaName || 'dbo',
+        baseTable: entity.BaseTable || entity.Name,
+        baseView: entity.BaseView || `vw${entity.Name}`,
+        fields: formatEntityFields(entity),
+        relationships: formatEntityRelationships(entity, allEntities),
+    };
+}
+exports.formatEntityMetadataForPrompt = formatEntityMetadataForPrompt;
+/**
+ * Format entity fields for AI prompt
+ * Includes field metadata with types, descriptions, and relationship info
+ * Labels internal (__mj_*) and virtual fields appropriately
+ */
+function formatEntityFields(entity) {
+    return entity.Fields.map((field) => {
+        const isInternalField = field.Name.startsWith('__mj_');
+        const isVirtualField = field.IsVirtual || false;
+        let description = field.Description || '';
+        // Add labels for special fields
+        if (isInternalField) {
+            description = `[INTERNAL] ${description}`;
+        }
+        else if (isVirtualField) {
+            description = `[VIRTUAL] ${description}`;
+        }
+        // Extract possible values from EntityFieldValues if available
+        const possibleValues = field.EntityFieldValues && field.EntityFieldValues.length > 0
+            ? field.EntityFieldValues.map(efv => efv.Value)
+            : undefined;
+        return {
+            name: field.Name,
+            displayName: field.DisplayName || field.Name,
+            type: field.Type,
+            sqlFullType: field.SQLFullType,
+            description,
+            isPrimaryKey: field.IsPrimaryKey || false,
+            isForeignKey: field.RelatedEntityID != null && field.RelatedEntityID.trim().length > 0,
+            isVirtual: isVirtualField,
+            allowsNull: field.AllowsNull,
+            relatedEntity: field.RelatedEntity || undefined,
+            isRequired: !field.AllowsNull,
+            defaultValue: field.DefaultValue || undefined,
+            possibleValues,
+        };
+    });
+}
+/**
+ * Format entity relationships for AI prompt
+ * Includes schema and view names for proper JOIN generation
+ * Only includes relationships to entities in the current entity group
+ * Uses EntityInfo.RelatedEntities getter for pre-computed relationships
+ */
+function formatEntityRelationships(entity, allEntities) {
+    // Create set of entity names in the group for filtering
+    const entityNamesInGroup = new Set(allEntities.map(e => e.Name));
+    // Use entity.RelatedEntities getter which returns EntityRelationshipInfo[]
+    return entity.RelatedEntities
+        .filter(rel => entityNamesInGroup.has(rel.RelatedEntity)) // Only include relationships within the group
+        .map(rel => {
+        const relatedEntity = findEntityById(rel.RelatedEntityID, allEntities);
+        // Determine the foreign key field based on relationship type and available fields
+        let foreignKeyField;
+        let joinDescription;
+        const currentSchema = entity.SchemaName || 'dbo';
+        const currentView = entity.BaseView || `vw${entity.Name}`;
+        const relatedSchema = relatedEntity?.SchemaName || 'dbo';
+        const relatedView = relatedEntity?.BaseView || `vw${rel.RelatedEntity}`;
+        if (rel.EntityKeyField && rel.EntityKeyField.trim() !== '') {
+            // Current entity has the foreign key
+            foreignKeyField = rel.EntityKeyField;
+            const relatedJoinField = rel.RelatedEntityJoinField || 'ID';
+            joinDescription = `${currentSchema}.${currentView}.${foreignKeyField} = ${relatedSchema}.${relatedView}.${relatedJoinField}`;
+        }
+        else if (rel.RelatedEntityJoinField && rel.RelatedEntityJoinField.trim() !== '') {
+            // Related entity has the foreign key pointing back to this entity
+            foreignKeyField = rel.RelatedEntityJoinField;
+            joinDescription = `${relatedSchema}.${relatedView}.${foreignKeyField} = ${currentSchema}.${currentView}.ID`;
+        }
+        else {
+            // No foreign key field specified (possibly many-to-many through join table)
+            foreignKeyField = '';
+            joinDescription = `Related via ${rel.JoinView || 'join table'}`;
+        }
+        return {
+            type: mapRelationshipType(rel.Type),
+            relatedEntity: rel.RelatedEntity,
+            relatedEntityView: relatedEntity?.BaseView || `vw${rel.RelatedEntity}`,
+            relatedEntitySchema: relatedEntity?.SchemaName || 'dbo',
+            foreignKeyField,
+            description: joinDescription,
+        };
+    });
+}
+/**
+ * Map MJ relationship types to QueryGen types
+ */
+function mapRelationshipType(mjType) {
+    const normalized = mjType.toLowerCase().replace(/\s+/g, '-');
+    if (normalized === 'many-to-one')
+        return 'many-to-one';
+    if (normalized === 'one-to-many')
+        return 'one-to-many';
+    if (normalized === 'many-to-many')
+        return 'many-to-many';
+    return 'many-to-one'; // Default fallback
+}
+/**
+ * Check if a field is a foreign key field
+ */
+function isForeignKeyField(field) {
+    return field.RelatedEntityID != null && field.RelatedEntityID.trim().length > 0;
+}
+/**
+ * Find entity by name in array
+ */
+function findEntityByName(name, entities) {
+    return entities.find((e) => e.Name === name);
+}
+/**
+ * Find entity by ID in array
+ */
+function findEntityById(id, entities) {
+    return entities.find((e) => e.ID === id);
+}
+exports.findEntityById = findEntityById;
+/**
+ * Get primary key field(s) for an entity
+ */
+function getPrimaryKeyFields(entity) {
+    return entity.Fields.filter((f) => f.IsPrimaryKey);
+}
+exports.getPrimaryKeyFields = getPrimaryKeyFields;
+/**
+ * Get foreign key fields for an entity
+ */
+function getForeignKeyFields(entity) {
+    return entity.Fields.filter((f) => isForeignKeyField(f));
+}
+exports.getForeignKeyFields = getForeignKeyFields;
+/**
+ * Check if an entity has any relationships
+ * Uses EntityInfo.RelatedEntities getter
+ */
+function hasRelationships(entity, allEntities) {
+    return entity.RelatedEntities.length > 0;
+}
+exports.hasRelationships = hasRelationships;
+/**
+ * Get count of relationships for an entity
+ * Uses EntityInfo.RelatedEntities getter
+ */
+function getRelationshipCount(entity, allEntities) {
+    return entity.RelatedEntities.length;
+}
+exports.getRelationshipCount = getRelationshipCount;
+/**
+ * Format an entire entity group for AI prompt consumption
+ * Converts all entities in the group to structured metadata
+ *
+ * @param entityGroup - Entity group to format
+ * @returns Array of formatted entity metadata for Nunjucks template
+ */
+function formatEntityGroupForPrompt(entityGroup) {
+    return entityGroup.entities.map((entity) => formatEntityMetadataForPrompt(entity, entityGroup.entities));
+}
+exports.formatEntityGroupForPrompt = formatEntityGroupForPrompt;
+//# sourceMappingURL=entity-helpers.js.map

package/dist/utils/entity-helpers.js.map

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

package/dist/utils/error-handlers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error handling utilities
+ *
+ * Standardized error handling functions following MJ patterns
+ */
+/**
+ * Extract error message from unknown error type
+ * Uses MJ's extractErrorMessage pattern
+ */
+export declare function extractErrorMessage(error: unknown, context: string): string;
+/**
+ * Validate required value is not null/undefined
+ */
+export declare function requireValue<T>(value: T | null | undefined, fieldName: string): T;
+/**
+ * Get property with fallback value
+ */
+export declare function getPropertyOrDefault<T>(obj: Record<string, unknown>, key: string, defaultValue: T): T;
+//# sourceMappingURL=error-handlers.d.ts.map

package/dist/utils/error-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handlers.d.ts","sourceRoot":"","sources":["../../src/utils/error-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC,CAGH"}

package/dist/utils/error-handlers.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Error handling utilities
+ *
+ * Standardized error handling functions following MJ patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPropertyOrDefault = exports.requireValue = exports.extractErrorMessage = void 0;
+/**
+ * Extract error message from unknown error type
+ * Uses MJ's extractErrorMessage pattern
+ */
+function extractErrorMessage(error, context) {
+    if (error instanceof Error) {
+        return `${context}: ${error.message}`;
+    }
+    if (typeof error === 'string') {
+        return `${context}: ${error}`;
+    }
+    return `${context}: Unknown error occurred`;
+}
+exports.extractErrorMessage = extractErrorMessage;
+/**
+ * Validate required value is not null/undefined
+ */
+function requireValue(value, fieldName) {
+    if (value === null || value === undefined) {
+        throw new Error(`Required value '${fieldName}' is missing`);
+    }
+    return value;
+}
+exports.requireValue = requireValue;
+/**
+ * Get property with fallback value
+ */
+function getPropertyOrDefault(obj, key, defaultValue) {
+    const value = obj[key];
+    return value !== undefined ? value : defaultValue;
+}
+exports.getPropertyOrDefault = getPropertyOrDefault;
+//# sourceMappingURL=error-handlers.js.map

package/dist/utils/error-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handlers.js","sourceRoot":"","sources":["../../src/utils/error-handlers.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,KAAc,EAAE,OAAe;IACjE,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,GAAG,OAAO,KAAK,KAAK,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,OAAO,0BAA0B,CAAC;AAC9C,CAAC;AARD,kDAQC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAI,KAA2B,EAAE,SAAiB;IAC5E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,cAAc,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AALD,oCAKC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAClC,GAA4B,EAC5B,GAAW,EACX,YAAe;IAEf,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAE,KAAW,CAAC,CAAC,CAAC,YAAY,CAAC;AAC3D,CAAC;AAPD,oDAOC"}