@memberjunction/core-entities-server 5.15.0 → 5.17.0

package/dist/custom/query-extraction/types.d.ts

@@ -0,0 +1,114 @@
+import type { IMetadataProvider, IRunViewProvider, QueryInfo, UserInfo } from "@memberjunction/core";
+import type { MJParameterInfo, MJParseResult, SQLSelectColumn, SQLTableReference } from "@memberjunction/sql-parser";
+/**
+ * A parameter extracted from a query's SQL — the final merged result
+ * combining deterministic parsing, dependency metadata, and LLM enrichment.
+ */
+export interface ExtractedParameter {
+    name: string;
+    type: 'string' | 'number' | 'date' | 'boolean' | 'array' | 'object';
+    isRequired: boolean;
+    description: string;
+    usage: string[];
+    defaultValue: string | null;
+    sampleValue: string | null;
+}
+/**
+ * A field extracted from a query's SELECT clause.
+ * May be enriched with deterministic SQL types from dependency query fields or entity metadata.
+ */
+export interface ExtractedField {
+    name: string;
+    dynamicName?: boolean;
+    description: string;
+    type: 'number' | 'string' | 'date' | 'boolean';
+    optional: boolean;
+    sourceEntity?: string | null;
+    sourceFieldName?: string | null;
+    isComputed?: boolean;
+    isSummary?: boolean;
+    computationDescription?: string;
+    /** Deterministic SQL base type (e.g., "nvarchar", "int", "decimal") — takes priority over generic type mapping */
+    sqlBaseType?: string | null;
+    /** Deterministic SQL full type (e.g., "nvarchar(100)", "decimal(18,2)") — takes priority over generic type mapping */
+    sqlFullType?: string | null;
+}
+/**
+ * Result from LLM enrichment prompt.
+ */
+export interface ParameterExtractionResult {
+    parameters: ExtractedParameter[];
+    selectClause?: ExtractedField[];
+}
+/**
+ * Metadata inherited from a dependency query's parameter for passthrough parameters.
+ * Used as a fallback source for description and sampleValue when LLM enrichment is unavailable.
+ */
+export interface PassthroughParamContext {
+    description: string | null;
+    sampleValue: string | null;
+    depQueryName: string;
+    depParamName: string;
+}
+/**
+ * A fully resolved composition reference. Produced once by the resolve stage,
+ * then consumed by both dependency sync and passthrough parameter extraction.
+ */
+export interface ResolvedCompositionReference {
+    depQuery: QueryInfo;
+    referencePath: string;
+    alias: string | null;
+    parameterMapping: Record<string, string> | null;
+    passthroughMappings: Array<{
+        parentParamName: string;
+        depParamName: string;
+    }>;
+}
+/**
+ * Typed entity metadata entry extracted from SQL table references.
+ */
+export interface EntityMetadataEntry {
+    name: string;
+    schemaName: string;
+    baseView: string;
+    fields: Array<{
+        name: string;
+        type: string;
+        isPrimaryKey: boolean;
+    }>;
+}
+/**
+ * Result of the parse stage — computed once from the SQL, consumed by all downstream stages.
+ */
+export interface ParseResult {
+    analysis: MJParseResult;
+    deterministicParams: MJParameterInfo[];
+    tableRefs: SQLTableReference[];
+    selectColumns: SQLSelectColumn[];
+}
+/**
+ * Result of the resolve stage — deterministic resolution of composition refs,
+ * parameters, fields, and entity metadata.
+ */
+export interface ResolveResult {
+    resolvedCompositionRefs: ResolvedCompositionReference[];
+    allDeterministicParams: MJParameterInfo[];
+    passthroughContext: Map<string, PassthroughParamContext>;
+    entityMetadata: EntityMetadataEntry[];
+    /** Non-null if SELECT * was detected and fields were expanded deterministically */
+    selectStarFields: ExtractedField[] | null;
+}
+/**
+ * Everything the pipeline stages need from the entity instance.
+ * Decouples helpers from BaseEntity so they are stateless and testable.
+ */
+export interface QuerySyncContext {
+    queryID: string;
+    queryName: string;
+    sql: string;
+    isSaved: boolean;
+    contextUser: UserInfo;
+    metadataProvider: IMetadataProvider;
+    runViewProvider: IRunViewProvider;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/custom/query-extraction/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/custom/query-extraction/types.ts"],"names":[],"mappings":"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"}

package/dist/custom/query-extraction/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/custom/query-extraction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/custom/query-extraction/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/core-entities-server",
   "type": "module",
-  "version": "5.15.0",
+  "version": "5.17.0",
   "description": "Entity subclasses for the metadata layer of MemberJunction that are only used on server side applications like MJAPI, distributed as part of each release of MemberJunction",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,24 +21,24 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@memberjunction/actions-base": "5.15.0",
-    "@memberjunction/ai": "5.15.0",
-    "@memberjunction/ai-core-plus": "5.15.0",
-    "@memberjunction/ai-engine-base": "5.15.0",
-    "@memberjunction/ai-prompts": "5.15.0",
-    "@memberjunction/ai-provider-bundle": "5.15.0",
-    "@memberjunction/ai-vector-dupe": "5.15.0",
-    "@memberjunction/ai-vectors-memory": "5.15.0",
-    "@memberjunction/aiengine": "5.15.0",
-    "@memberjunction/core": "5.15.0",
-    "@memberjunction/core-entities": "5.15.0",
-    "@memberjunction/generic-database-provider": "5.15.0",
-    "@memberjunction/doc-utils": "5.15.0",
-    "@memberjunction/global": "5.15.0",
-    "@memberjunction/skip-types": "5.15.0",
-    "@memberjunction/sql-converter": "5.15.0",
-    "@memberjunction/sql-parser": "5.15.0",
-    "@memberjunction/sqlserver-dataprovider": "5.15.0",
+    "@memberjunction/actions-base": "5.17.0",
+    "@memberjunction/ai": "5.17.0",
+    "@memberjunction/ai-core-plus": "5.17.0",
+    "@memberjunction/ai-engine-base": "5.17.0",
+    "@memberjunction/ai-prompts": "5.17.0",
+    "@memberjunction/ai-provider-bundle": "5.17.0",
+    "@memberjunction/ai-vector-dupe": "5.17.0",
+    "@memberjunction/ai-vectors-memory": "5.17.0",
+    "@memberjunction/aiengine": "5.17.0",
+    "@memberjunction/core": "5.17.0",
+    "@memberjunction/core-entities": "5.17.0",
+    "@memberjunction/generic-database-provider": "5.17.0",
+    "@memberjunction/doc-utils": "5.17.0",
+    "@memberjunction/global": "5.17.0",
+    "@memberjunction/skip-types": "5.17.0",
+    "@memberjunction/sql-converter": "5.17.0",
+    "@memberjunction/sql-parser": "5.17.0",
+    "@memberjunction/sqlserver-dataprovider": "5.17.0",
     "rxjs": "~7.8.1",
     "zod": "~3.24.4"
   },