@memberjunction/core-entities-server 5.16.0 → 5.18.0

package/dist/custom/MJQueryEntityServer.server.d.ts

@@ -11,8 +11,6 @@ export declare class MJQueryEntityServer extends MJQueryEntity {
     get QueryPermissions(): QueryPermissionInfo[];
     /**
      * Simple proxy to local helper method for embeddings. Needed for BaseEntity sub-classes that want to use embeddings built into BaseEntity
-     * @param textToEmbed
-     * @returns
      */
     protected EmbedTextLocal(textToEmbed: string): Promise<SimpleEmbeddingResult>;
     /**
@@ -24,106 +22,31 @@ export declare class MJQueryEntityServer extends MJQueryEntity {
     Delete(options?: EntitySaveOptions): Promise<boolean>;
     /**
      * Builds a category path string from a CategoryID by walking up the category hierarchy.
-     * Returns a path like "Golden-Queries/Sales" or "Golden-Queries".
+     * Returns a slash-delimited path like "Ground-Truth-Queries/Sales" or "Ground-Truth-Queries".
      */
-    private buildCategoryPathFromID;
+    BuildCategoryPathFromID(categoryID: string): string;
     /**
-     * Asynchronous version of extractAndSyncData that runs outside the main save operation
-     * to prevent connection pool exhaustion
+     * Builds the QuerySyncContext from this entity instance for use by the extraction pipeline.
      */
-    private extractAndSyncDataAsync;
-    /**
-     * Asynchronous cleanup for empty queries
-     */
-    private cleanupEmptyQueryAsync;
-    private extractAndSyncData;
-    /**
-     * Runs the LLM enrichment prompt to get descriptions and sample values.
-     * Returns null if the LLM is unavailable or fails (non-fatal).
-     */
-    private runLLMEnrichment;
-    /**
-     * Merges deterministic parameter extraction (SQLParser) with LLM enrichment.
-     *
-     * SQLParser is the authority for: name, type, isRequired, defaultValue
-     * LLM provides: description, sampleValue (with heuristic fallbacks if LLM unavailable)
-     */
-    private mergeParametersWithLLM;
-    /**
-     * Generates a deterministic description for a parameter when LLM is unavailable.
-     * Uses the parameter name, type, and filter information to create a meaningful description.
-     */
-    private generateParameterDescription;
-    /**
-     * Generates a deterministic sample value based on the parameter type.
-     */
-    private generateSampleValue;
-    /**
-     * Extracts entity metadata from the SQL to provide context to the LLM for parameter type inference.
-     * Uses SQLParser for robust SQL parsing with MJ template support.
-     */
-    private extractEntityMetadataFromSQL;
-    private syncQueryParameters;
-    private removeAllQueryParameters;
-    /**
-     * Detects if the SQL uses SELECT * and if so, builds the complete field list deterministically
-     * from entity metadata without relying on the AI (which can't enumerate * columns).
-     * Returns null if the SQL doesn't use SELECT * or if entities can't be resolved.
-     */
-    private buildFieldsForSelectStar;
-    /**
-     * Finds an entity by name, checking both Name (which may have "MJ: " prefix) and DisplayName.
-     * The AI often returns entity names without the "MJ: " prefix, so we need to match both.
-     */
-    private findEntityByName;
-    /**
-     * Expands wildcard (*) entries in the extracted fields list.
-     * When AI returns a field with name="*" or sourceFieldName="*", we expand it into
-     * individual field entries by looking up the source from metadata.
-     * If the AI didn't provide a sourceEntity, we parse the SQL's FROM clause to find it.
-     */
-    private expandWildcardFields;
-    private syncQueryFields;
-    private syncQueryEntities;
-    private removeAllQueryFields;
-    private removeAllQueryEntities;
-    /**
-     * Deterministically extracts {{query:"..."}} composition references from this query's SQL
-     * and syncs the QueryDependency records accordingly. No LLM needed — uses regex parsing.
-     */
-    private extractAndSyncQueryDependencies;
+    private buildSyncContext;
     /**
-     * Resolves parsed composition tokens to dependency records with QueryIDs.
+     * Runs the extraction pipeline and saves the UsesTemplate flag.
+     * On error, sets UsesTemplate=false and attempts to save so the query remains usable.
      */
-    private resolveTokensToQueryDependencies;
-    /**
-     * Extracts the SQL alias following a {{query:"..."}} token from this query's SQL.
-     */
-    private extractAliasFromSQL;
-    /**
-     * Detects circular dependencies by walking the dependency graph.
-     * Returns a descriptive error string if a cycle is found, or null if clean.
-     */
-    private detectDependencyCycles;
-    /**
-     * Syncs extracted query dependencies against existing QueryDependency records.
-     * Follows the same add/update/delete pattern as syncQueryParameters/Fields/Entities.
-     */
-    private syncQueryDependencies;
+    private extractAndSyncDataAsync;
     /**
-     * Removes all QueryDependency records for this query.
+     * Cleans up all extraction data when SQL is empty, then saves the updated UsesTemplate flag.
      */
-    private removeAllQueryDependencies;
+    private cleanupEmptyQueryAsync;
     /**
      * Auto-converts the query's SQL to other dialects based on the queryDialects
      * configuration stored in GlobalObjectStore. Best-effort: failures never block the save.
      */
     private autoConvertDialectsAsync;
     /**
-     * Converts T-SQL to PostgreSQL using SQLConverter ExpressionHelper transforms.
-     * Applies the standard transform pipeline for statement-level conversions.
+     * Converts and persists SQL for a single target dialect. Logs warnings on skip/failure.
      */
-    private convertTSQLToPostgreSQL;
+    private convertToTargetDialect;
     /**
      * Creates or updates a QuerySQL record for the given dialect.
      */
@@ -137,9 +60,7 @@ export declare class MJQueryEntityServer extends MJQueryEntity {
     LoadFromData(data: any, _replaceOldValues?: boolean): Promise<boolean>;
     /**
      * Refreshes this record's related metadata from the provider, refreshing
-     * all the way up from the database if refreshFromDB is true, otherwise from
-     * cache.
-     * @param refreshFromDB
+     * all the way up from the database if refreshFromDB is true, otherwise from cache.
      */
     RefreshRelatedMetadata(refreshFromDB: boolean): Promise<void>;
 }

package/dist/custom/MJQueryEntityServer.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MJQueryEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJQueryEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,iBAAiB,EAAyC,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAW,qBAAqB,EAA6C,MAAM,sBAAsB,CAAC;AAE/Q,OAAO,EAAE,aAAa,EAA8G,MAAM,+BAA+B,CAAC;AAqD1K,qBACa,mBAAoB,SAAQ,aAAa;IAClD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,iBAAiB,CAA6B;IAEtD,IAAW,aAAa,IAAI,eAAe,EAAE,CAE5C;IAED,IAAW,WAAW,IAAI,cAAc,EAAE,CAEzC;IAED,IAAW,eAAe,IAAI,kBAAkB,EAAE,CAEjD;IAED,IAAW,gBAAgB,IAAI,mBAAmB,EAAE,CAEnD;IAED;;;;OAIG;cACsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5F;;;OAGG;cACa,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5C,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyDnD,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBpE;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;;OAGG;YACW,uBAAuB;IAuBrC;;OAEG;YACW,sBAAsB;YAmBtB,kBAAkB;IAwDhC;;;OAGG;YACW,gBAAgB;IAoC9B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;YACW,4BAA4B;YAsE5B,mBAAmB;YA+JnB,wBAAwB;IA8BtC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAwEhC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;YAiEd,eAAe;YAsKf,iBAAiB;YAsFjB,oBAAoB;YA4BpB,sBAAsB;IA4BpC;;;OAGG;YACW,+BAA+B;IA8B7C;;OAEG;IACH,OAAO,CAAC,gCAAgC;IA4ExC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;OAGG;YACW,sBAAsB;IA+DpC;;;OAGG;YACW,qBAAqB;IAqGnC;;OAEG;YACW,0BAA0B;IA2BxC;;;OAGG;YACW,wBAAwB;IA6DtC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;YACW,oBAAoB;IAsClC;;OAEG;YACW,6BAA6B;IAyB5B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,yBAAyB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxE,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,yBAAyB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAM7F,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAMrF;;;;;OAKG;IACU,sBAAsB,CAAC,aAAa,EAAE,OAAO;CAgB7D"}
+{"version":3,"file":"MJQueryEntityServer.server.d.ts","sourceRoot":"","sources":["../../src/custom/MJQueryEntityServer.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,YAAY,EACZ,iBAAiB,EAIjB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EAExB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAoB,MAAM,+BAA+B,CAAC;AAUhF,qBACa,mBAAoB,SAAQ,aAAa;IAClD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,iBAAiB,CAA6B;IAEtD,IAAW,aAAa,IAAI,eAAe,EAAE,CAE5C;IAED,IAAW,WAAW,IAAI,cAAc,EAAE,CAEzC;IAED,IAAW,eAAe,IAAI,kBAAkB,EAAE,CAEjD;IAED,IAAW,gBAAgB,IAAI,mBAAmB,EAAE,CAEnD;IAID;;OAEG;cACsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5F;;;OAGG;cACa,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5C,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IA0CnD,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBpE;;;OAGG;IACI,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAe1D;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;OAGG;YACW,uBAAuB;IAsBrC;;OAEG;YACW,sBAAsB;IAmBpC;;;OAGG;YACW,wBAAwB;IAiCtC;;OAEG;YACW,sBAAsB;IA6BpC;;OAEG;YACW,oBAAoB;IAmClC;;OAEG;YACW,6BAA6B;IA2B5B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,yBAAyB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxE,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,yBAAyB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAO7F,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrF;;;OAGG;IACU,sBAAsB,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAc7E"}