@memberjunction/core-entities-server 6.2.0-edge.6 → 6.2.0-edge.8

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

@@ -0,0 +1,40 @@
+import type { DatabasePlatform, IRunViewProvider, QueryDependencySpec, UserInfo } from "@memberjunction/core";
+import type { MJQueryDependencyEntity, MJQueryParameterEntity, MJSQLDialectEntity } from "@memberjunction/core-entities";
+/** A composed query's parameter, as extraction reads it. */
+export type CompositionCandidateParameter = Pick<MJQueryParameterEntity, 'Name' | 'Type' | 'IsRequired' | 'IsServerSet' | 'SampleValue' | 'Description' | 'Query'>;
+/**
+ * A query a composition may name, as extraction reads it: identity and path, whether it may be
+ * composed, its parameters and the queries it composes in turn. A cached `MJQueryEntityExtended`
+ * is one; so is a query read from the database during a save.
+ */
+export interface CompositionCandidate {
+    readonly ID: string;
+    readonly Name: string;
+    readonly CategoryPath: string;
+    readonly Reusable: boolean;
+    readonly QueryParameters: readonly CompositionCandidateParameter[];
+    readonly QueryDependencies: readonly Pick<MJQueryDependencyEntity, 'DependsOnQueryID'>[];
+}
+/** The composed queries a save read from its own provider. */
+export interface CompositionTargetRead {
+    /** Every query named by a composition in the SQL, as stored now (in the save's transaction). */
+    readonly Candidates: readonly CompositionCandidate[];
+    /**
+     * Render specs for the candidates the given cache does not hold yet (saved earlier in the same
+     * transaction), so the describe renders can compose them before the cache hears of them.
+     */
+    readonly InlineDependencies: readonly QueryDependencySpec[];
+}
+/**
+ * Reads the queries the compositions in `sql` name from `provider`, bypassing every cache, so a
+ * query saved earlier in the same transaction (a metadata push that creates a query and one that
+ * composes it) is found. Queries are matched by name; the caller matches category paths.
+ * @param cachedIDs - IDs of the queries the shared cache already holds; the others get render specs.
+ */
+export declare function ReadCompositionTargetsAsync(sql: string, platform: DatabasePlatform, provider: Pick<IRunViewProvider, 'RunViews'>, user: UserInfo, cachedIDs: ReadonlySet<string>, dialects: readonly MJSQLDialectEntity[]): Promise<CompositionTargetRead>;
+/**
+ * The candidates extraction resolves against: the ones read from the database, then every cached
+ * query the read did not return (a query read from the database replaces its cached copy).
+ */
+export declare function MergeCompositionCandidates(read: readonly CompositionCandidate[], cached: readonly CompositionCandidate[]): CompositionCandidate[];
+//# sourceMappingURL=compositionTargets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compositionTargets.d.ts","sourceRoot":"","sources":["../../../src/custom/query-extraction/compositionTargets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAiB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7H,OAAO,KAAK,EAER,uBAAuB,EAEvB,sBAAsB,EAEtB,kBAAkB,EACrB,MAAM,+BAA+B,CAAC;AAKvC,4DAA4D;AAC5D,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC;AAEnK;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACnE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,IAAI,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,EAAE,CAAC;CAC5F;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IAClC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACrD;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC/D;AAaD;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,EAC5C,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAWhC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,oBAAoB,EAAE,EAAE,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CAGjJ"}

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

@@ -0,0 +1,99 @@
+import { QueryParameterInfo } from "@memberjunction/core";
+import { GetQueryDialect } from "@memberjunction/sql-dialect";
+import { QueryTemplate } from "@memberjunction/sql-parser";
+import { EscapeSQLString, IndexByUUID, UUIDsEqual } from "@memberjunction/global";
+const EMPTY_READ = { Candidates: [], InlineDependencies: [] };
+/**
+ * Reads the queries the compositions in `sql` name from `provider`, bypassing every cache, so a
+ * query saved earlier in the same transaction (a metadata push that creates a query and one that
+ * composes it) is found. Queries are matched by name; the caller matches category paths.
+ * @param cachedIDs - IDs of the queries the shared cache already holds; the others get render specs.
+ */
+export async function ReadCompositionTargetsAsync(sql, platform, provider, user, cachedIDs, dialects) {
+    const names = [...new Set(QueryTemplate.Parse(sql, GetQueryDialect(platform)).CompositionReferences().Value.map(r => r.Name.trim().toLowerCase()))];
+    if (names.length === 0)
+        return EMPTY_READ;
+    const rows = await readTargetRows(names, provider, user);
+    if (!rows)
+        return EMPTY_READ;
+    const candidates = rows.Queries.map(q => candidateOf(q, rows));
+    const dialectID = dialects.find(d => d.PlatformKey === platform)?.ID ?? null;
+    const inline = rows.Queries
+        .filter(q => !cachedIDs.has(q.ID.toLowerCase()))
+        .map(q => inlineSpecOf(q, rows, dialectID));
+    return { Candidates: candidates, InlineDependencies: inline };
+}
+/**
+ * The candidates extraction resolves against: the ones read from the database, then every cached
+ * query the read did not return (a query read from the database replaces its cached copy).
+ */
+export function MergeCompositionCandidates(read, cached) {
+    const readIDs = new Set(read.map(q => q.ID.toLowerCase()));
+    return [...read, ...cached.filter(q => !readIDs.has(q.ID.toLowerCase()))];
+}
+async function readTargetRows(names, provider, user) {
+    const nameList = names.map(n => `'${EscapeSQLString(n)}'`).join(', ');
+    const [queries, categories] = await provider.RunViews([
+        bypassing('MJ: Queries', `LOWER(Name) IN (${nameList})`),
+        bypassing('MJ: Query Categories', ''),
+    ], user);
+    if (!queries.Success || !categories.Success || queries.Results.length === 0)
+        return null;
+    const queryRows = queries.Results;
+    const idList = queryRows.map(q => `'${EscapeSQLString(q.ID)}'`).join(', ');
+    const [parameters, dependencies, sqls] = await provider.RunViews([
+        bypassing('MJ: Query Parameters', `QueryID IN (${idList})`),
+        bypassing('MJ: Query Dependencies', `QueryID IN (${idList})`),
+        bypassing('MJ: Query SQLs', `QueryID IN (${idList})`),
+    ], user);
+    if (!parameters.Success || !dependencies.Success || !sqls.Success)
+        return null;
+    return {
+        Queries: queryRows,
+        Categories: categories.Results,
+        Parameters: parameters.Results,
+        Dependencies: dependencies.Results,
+        SQLs: sqls.Results,
+    };
+}
+function bypassing(entityName, filter) {
+    return { EntityName: entityName, ExtraFilter: filter, ResultType: 'entity_object', BypassCache: true, IgnoreMaxRows: true };
+}
+function candidateOf(query, rows) {
+    return {
+        ID: query.ID,
+        Name: query.Name,
+        CategoryPath: categoryPathOf(query.CategoryID, rows.Categories),
+        Reusable: query.Reusable,
+        QueryParameters: rows.Parameters.filter(p => UUIDsEqual(p.QueryID, query.ID)),
+        QueryDependencies: rows.Dependencies.filter(d => UUIDsEqual(d.QueryID, query.ID)),
+    };
+}
+/** The `/`-joined names from the root category down to `categoryID`; `''` for no category. */
+function categoryPathOf(categoryID, categories) {
+    const byID = IndexByUUID(categories);
+    const segments = [];
+    const seen = new Set();
+    let current = categoryID;
+    while (current && !seen.has(current.toLowerCase())) {
+        seen.add(current.toLowerCase());
+        const category = byID.Get(current);
+        if (!category)
+            break;
+        segments.unshift(category.Name);
+        current = category.ParentID;
+    }
+    return segments.join('/');
+}
+/** A render spec for a query the cache does not hold: its SQL for the platform and its parameter definitions. */
+function inlineSpecOf(query, rows, dialectID) {
+    const variant = dialectID ? rows.SQLs.find(s => UUIDsEqual(s.QueryID, query.ID) && UUIDsEqual(s.SQLDialectID, dialectID)) : undefined;
+    return {
+        Name: query.Name,
+        CategoryPath: categoryPathOf(query.CategoryID, rows.Categories),
+        SQL: variant?.SQL ?? query.SQL ?? '',
+        UsesTemplate: query.UsesTemplate,
+        ParameterDefinitions: rows.Parameters.filter(p => UUIDsEqual(p.QueryID, query.ID)).map(p => new QueryParameterInfo(p.GetAll())),
+    };
+}
+//# sourceMappingURL=compositionTargets.js.map

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

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

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

@@ -0,0 +1,79 @@
+import type { BaseEntity, RelatedRecordCollection } from "@memberjunction/core";
+import type { MJQueryEntityEntity, MJQueryFieldEntity, MJQueryParameterEntity } from "@memberjunction/core-entities";
+/**
+ * The child rows a query save declares, as the keys extraction matches rows by.
+ *
+ * A row is *declared* when the save writes it from one of the query's declared collections
+ * (`Parameters`, `Fields`, `Entities` on `MJQueryEntityExtended`): it is new, or it was edited.
+ * Keys are lower-cased so they compare the way the database does.
+ *
+ * Extraction treats a declared row as the caller's decision and leaves it alone: it does not add a
+ * row with the same key, update it, or delete it, even when the SQL no longer mentions it. That is
+ * how a declared row "wins" over what extraction would have written for the same key in the same
+ * save. Any later extraction (an extraction service, a refresh) that replaces the current one must
+ * honour these sets the same way; the facts it would compute for a declared row can be reported, but
+ * not written.
+ */
+export interface DeclaredQueryChildren {
+    /** Declared parameter names. */
+    ParameterNames: ReadonlySet<string>;
+    /** Declared output field names. */
+    FieldNames: ReadonlySet<string>;
+    /** Declared entity links, keyed by {@link QueryEntityKey} (the entity ID). */
+    EntityKeys: ReadonlySet<string>;
+}
+/** A declared set with nothing in it, for saves that declare no children. */
+export declare const NO_DECLARED_QUERY_CHILDREN: DeclaredQueryChildren;
+/** The three declared collections of a query, as `MJQueryEntityExtended` exposes them. */
+export interface DeclaredQueryCollections {
+    Parameters: RelatedRecordCollection<MJQueryParameterEntity>;
+    Fields: RelatedRecordCollection<MJQueryFieldEntity>;
+    Entities: RelatedRecordCollection<MJQueryEntityEntity>;
+}
+/**
+ * The key a Query Entity row is matched by: the entity it links. Extraction keeps at most one row
+ * per entity (it updates the alternate base view on that row), so a declared row for an entity
+ * stands for every link to it.
+ */
+export declare function QueryEntityKey(row: Pick<MJQueryEntityEntity, 'EntityID'>): string;
+/** The key a parameter or field row is matched by: its name, trimmed and lower-cased. */
+export declare function QueryChildNameKey(name: string | null | undefined): string;
+/**
+ * The child rows a save of the query declares, read from its declared collections before the save.
+ *
+ * @param collections - The query's declared collections.
+ * @returns The declared keys; empty sets when the collections hold nothing to write.
+ */
+export declare function CollectDeclaredQueryChildren(collections: DeclaredQueryCollections): DeclaredQueryChildren;
+/** True when the declared set holds at least one row. */
+export declare function HasDeclaredQueryChildren(declared: DeclaredQueryChildren): boolean;
+/** A stored row and its detection method, as conflict detection reads it. */
+type DetectedRow = BaseEntity & {
+    ID: string;
+    DetectionMethod: string;
+};
+/**
+ * The stored rows a declared collection item replaces: rows with the same key as a NEW item but a
+ * different ID, that extraction (not a person) created. A row whose `DetectionMethod` is `Manual`
+ * was authored and is never selected, so authored rows are never touched.
+ *
+ * @param newItems - The collection's unsaved items.
+ * @param stored - The rows stored for the query, read from the database.
+ * @param key - How rows are matched.
+ * @returns The stored rows to delete in the same save, before the new items are inserted.
+ */
+export declare function FindReplacedRows<T extends DetectedRow>(newItems: readonly T[], stored: readonly T[], key: (row: T) => string): T[];
+/**
+ * Queues a stored row for deletion through the collection, so the delete runs inside the query's
+ * graph save, before the collection's inserts (a collection's removals run first). The row is
+ * removed from the collection when the collection already holds it; otherwise it is attached and
+ * removed, which queues the same delete.
+ *
+ * @param collection - The declared collection.
+ * @param row - The stored row to delete.
+ */
+export declare function QueueReplacedRowDeletion<T extends BaseEntity & {
+    ID: string;
+}>(collection: RelatedRecordCollection<T>, row: T): void;
+export {};
+//# sourceMappingURL=declared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"declared.d.ts","sourceRoot":"","sources":["../../../src/custom/query-extraction/declared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGrH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IAClC,gCAAgC;IAChC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,mCAAmC;IACnC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,8EAA8E;IAC9E,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,EAAE,qBAIxC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,WAAW,wBAAwB;IACrC,UAAU,EAAE,uBAAuB,CAAC,sBAAsB,CAAC,CAAC;IAC5D,MAAM,EAAE,uBAAuB,CAAC,kBAAkB,CAAC,CAAC;IACpD,QAAQ,EAAE,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;CAC1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,GAAG,MAAM,CAEjF;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEzE;AAkBD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,wBAAwB,GAAG,qBAAqB,CAMzG;AAED,yDAAyD;AACzD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAEjF;AAED,6EAA6E;AAC7E,KAAK,WAAW,GAAG,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,EAAE,CAWlI;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAQpI"}

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

@@ -0,0 +1,91 @@
+import { NormalizeUUID, UUIDsEqual } from "@memberjunction/global";
+/** A declared set with nothing in it, for saves that declare no children. */
+export const NO_DECLARED_QUERY_CHILDREN = {
+    ParameterNames: new Set(),
+    FieldNames: new Set(),
+    EntityKeys: new Set(),
+};
+/**
+ * The key a Query Entity row is matched by: the entity it links. Extraction keeps at most one row
+ * per entity (it updates the alternate base view on that row), so a declared row for an entity
+ * stands for every link to it.
+ */
+export function QueryEntityKey(row) {
+    return row.EntityID ? NormalizeUUID(row.EntityID) : '';
+}
+/** The key a parameter or field row is matched by: its name, trimmed and lower-cased. */
+export function QueryChildNameKey(name) {
+    return (name ?? '').trim().toLowerCase();
+}
+/** True when the save will write this collection item: it is new, or it has unsaved edits. */
+function isWrittenBySave(item) {
+    return !item.IsSaved || item.Dirty;
+}
+/** The keys of the items a save writes from one collection. */
+function writtenKeys(items, key) {
+    const keys = new Set();
+    for (const item of items) {
+        if (isWrittenBySave(item)) {
+            keys.add(key(item));
+        }
+    }
+    return keys;
+}
+/**
+ * The child rows a save of the query declares, read from its declared collections before the save.
+ *
+ * @param collections - The query's declared collections.
+ * @returns The declared keys; empty sets when the collections hold nothing to write.
+ */
+export function CollectDeclaredQueryChildren(collections) {
+    return {
+        ParameterNames: writtenKeys(collections.Parameters.Items, p => QueryChildNameKey(p.Name)),
+        FieldNames: writtenKeys(collections.Fields.Items, f => QueryChildNameKey(f.Name)),
+        EntityKeys: writtenKeys(collections.Entities.Items, QueryEntityKey),
+    };
+}
+/** True when the declared set holds at least one row. */
+export function HasDeclaredQueryChildren(declared) {
+    return declared.ParameterNames.size > 0 || declared.FieldNames.size > 0 || declared.EntityKeys.size > 0;
+}
+/**
+ * The stored rows a declared collection item replaces: rows with the same key as a NEW item but a
+ * different ID, that extraction (not a person) created. A row whose `DetectionMethod` is `Manual`
+ * was authored and is never selected, so authored rows are never touched.
+ *
+ * @param newItems - The collection's unsaved items.
+ * @param stored - The rows stored for the query, read from the database.
+ * @param key - How rows are matched.
+ * @returns The stored rows to delete in the same save, before the new items are inserted.
+ */
+export function FindReplacedRows(newItems, stored, key) {
+    const newByKey = new Map();
+    for (const item of newItems) {
+        newByKey.set(key(item), item);
+    }
+    return stored.filter(row => {
+        const declared = newByKey.get(key(row));
+        return declared !== undefined
+            && !UUIDsEqual(row.ID, declared.ID)
+            && row.DetectionMethod !== 'Manual';
+    });
+}
+/**
+ * Queues a stored row for deletion through the collection, so the delete runs inside the query's
+ * graph save, before the collection's inserts (a collection's removals run first). The row is
+ * removed from the collection when the collection already holds it; otherwise it is attached and
+ * removed, which queues the same delete.
+ *
+ * @param collection - The declared collection.
+ * @param row - The stored row to delete.
+ */
+export function QueueReplacedRowDeletion(collection, row) {
+    const held = collection.Items.find(item => item.IsSaved && UUIDsEqual(item.ID, row.ID));
+    if (held) {
+        collection.Remove(held);
+        return;
+    }
+    collection.Add(row);
+    collection.Remove(row);
+}
+//# sourceMappingURL=declared.js.map

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

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

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

@@ -0,0 +1,40 @@
+import type { DescribedColumn } from "@memberjunction/generic-database-provider";
+import type { QueryTemplate } from "@memberjunction/sql-parser";
+import type { QueryExtractionInput, QueryParameterFact, QueryParameterType } from "./extractionTypes.js";
+/** The output of every render of the query, as the database server described it. */
+export interface DescribedOutput {
+    /** The union of the renders' columns by name (case-insensitive): the base render's first, in order. */
+    readonly Columns: readonly DescribedColumn[];
+    /** Columns only some renders produce: the render that first produced each, or one that did not return it. */
+    readonly BranchOnlyColumns: readonly string[];
+    /** Output names a single render returns more than once (case-insensitive). */
+    readonly DuplicateNames: readonly string[];
+    /** Why the output could not be described (a render or the server failed); `null` on success. */
+    readonly Failure: string | null;
+}
+/**
+ * Renders the query with sample values, once for the base assignment and once per `{% if %}`
+ * toggled on its own (`QueryTemplate.BranchVariants`), and describes each render on the database
+ * server. Renders whose SQL repeats an earlier one are not described again. Plain SQL is
+ * described once, as written.
+ */
+export declare function DescribeQueryOutput(input: QueryExtractionInput, template: QueryTemplate, parameters: readonly QueryParameterFact[]): Promise<DescribedOutput>;
+/**
+ * The statement without the semicolons before and after it (`;SELECT …;`): a statement described on
+ * its own (PostgreSQL prepares it) cannot carry them, though the query runs with them.
+ */
+export declare function WithoutStatementSemicolons(sql: string, input: Pick<QueryExtractionInput, 'Platform'>): string;
+/**
+ * Why a render of the query may not run, as the run would refuse it: the first render (the base,
+ * then each `{% if %}` toggled) that is not a single read query or calls a function a query may not
+ * call. `null` when every render passes; a render that fails for another reason is left to
+ * {@link DescribeQueryOutput}, which reports it.
+ */
+export declare function FindUnsafeRender(input: QueryExtractionInput, template: QueryTemplate, parameters: readonly QueryParameterFact[]): string | null;
+/**
+ * A truthy sample value of `type`, as a render takes it: the row's sample when it fits the type,
+ * otherwise a fixed value (`Sample`, `1`, `2024-01-01`, `true`, `["1"]`). An array's fixed element is
+ * a numeric string, so a loop over it can feed a string hole or a number argument alike.
+ */
+export declare function SampleValueFor(type: QueryParameterType, sample: string | null): string;
+//# sourceMappingURL=describeFacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describeFacts.d.ts","sourceRoot":"","sources":["../../../src/custom/query-extraction/describeFacts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,KAAK,EAAuB,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE3H,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC5B,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,6GAA6G;IAC7G,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAYD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAoBnK;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,GAAG,MAAM,CAS7G;AA6DD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,GAAG,IAAI,CAQ/I;AAyFD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAStF"}

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

@@ -0,0 +1,225 @@
+import { IsQuerySafetyError, RenderPipeline, SafetyGate } from "@memberjunction/generic-database-provider";
+import { GetDialect } from "@memberjunction/sql-dialect";
+import { BranchVariantValues, LexSQL, SignificantTokens } from "@memberjunction/sql-parser";
+import { NormalizeDefaultForType } from "./enrich.js";
+/** The most branch renders described beyond the base, so a template with many blocks stays bounded. */
+const MAX_VARIANT_RENDERS = 32;
+/**
+ * Renders the query with sample values, once for the base assignment and once per `{% if %}`
+ * toggled on its own (`QueryTemplate.BranchVariants`), and describes each render on the database
+ * server. Renders whose SQL repeats an earlier one are not described again. Plain SQL is
+ * described once, as written.
+ */
+export async function DescribeQueryOutput(input, template, parameters) {
+    if (!input.Describe)
+        return failure('The database provider cannot describe a statement, so the output fields were not checked.');
+    const definitions = renderDefinitions(parameters, input.KnownParameters);
+    const renders = template.Tokens.HasTemplate ? renderAssignments(template) : [null];
+    const columns = [];
+    const branchOnly = [];
+    const duplicates = new Set();
+    const seenSQL = new Set();
+    for (const [index, values] of renders.entries()) {
+        const rendered = renderVariant(input, definitions, values);
+        if (rendered.Error !== null)
+            return failure(`Render ${index} could not be made: ${rendered.Error}`);
+        if (seenSQL.has(rendered.SQL))
+            continue;
+        seenSQL.add(rendered.SQL);
+        const described = await input.Describe(WithoutStatementSemicolons(rendered.SQL, input));
+        if (!described.Success)
+            return failure(`The database server could not describe the query: ${described.Diagnostics.join('; ') || 'no reason given'}`);
+        for (const name of duplicateNames(described.Columns))
+            duplicates.add(name);
+        if (index > 0)
+            noteMissingColumns(columns, described.Columns, index, branchOnly);
+        mergeColumns(columns, described.Columns, index, branchOnly);
+    }
+    return { Columns: columns, BranchOnlyColumns: branchOnly, DuplicateNames: [...duplicates], Failure: null };
+}
+/**
+ * The statement without the semicolons before and after it (`;SELECT …;`): a statement described on
+ * its own (PostgreSQL prepares it) cannot carry them, though the query runs with them.
+ */
+export function WithoutStatementSemicolons(sql, input) {
+    const tokens = SignificantTokens(LexSQL(sql, GetDialect(input.Platform)));
+    let first = 0;
+    while (first < tokens.length && tokens[first].Kind === 'semicolon')
+        first++;
+    let last = tokens.length - 1;
+    while (last >= first && tokens[last].Kind === 'semicolon')
+        last--;
+    if (first > last)
+        return sql;
+    if (first === 0 && last === tokens.length - 1)
+        return sql;
+    return sql.substring(0, tokens[0].Start) + sql.substring(tokens[first].Start, tokens[last].End);
+}
+function failure(message) {
+    return { Columns: [], BranchOnlyColumns: [], DuplicateNames: [], Failure: message };
+}
+/** Appends the columns of render `index` not yet in the union. */
+function mergeColumns(union, columns, index, branchOnly) {
+    const known = new Set(union.map(c => c.Name.toLowerCase()));
+    for (const column of columns) {
+        if (known.has(column.Name.toLowerCase()))
+            continue;
+        known.add(column.Name.toLowerCase());
+        union.push(column);
+        if (index > 0)
+            branchOnly.push(`${column.Name} (render ${index})`);
+    }
+}
+/** Notes the columns of the union so far that render `index` does not return (a column only the base branch returns). */
+function noteMissingColumns(union, columns, index, branchOnly) {
+    const returned = new Set(columns.map(c => c.Name.toLowerCase()));
+    for (const column of union) {
+        if (!returned.has(column.Name.toLowerCase()))
+            branchOnly.push(`${column.Name} (not in render ${index})`);
+    }
+}
+function duplicateNames(columns) {
+    const seen = new Set();
+    const repeated = new Set();
+    for (const column of columns) {
+        const key = column.Name.toLowerCase();
+        if (seen.has(key))
+            repeated.add(column.Name);
+        seen.add(key);
+    }
+    return [...repeated];
+}
+/** The base assignment, then one per `{% if %}` that parameter values can move to another branch. */
+function renderAssignments(template) {
+    const set = template.BranchVariants().Value;
+    const toggles = set.Variants.filter(v => v.Toggle !== null && v.Satisfiable && v.Toggle.ToBranch !== null);
+    return [set.Base, ...toggles.slice(0, MAX_VARIANT_RENDERS).map(v => BranchVariantValues(set, v))];
+}
+/** Every parameter a render may be given: the template's, typed from the known rows where they say more. */
+function renderDefinitions(parameters, known) {
+    const byName = new Map(known.map(k => [k.Name.toLowerCase(), k]));
+    const definitions = parameters.map(p => {
+        const row = byName.get(p.Name.toLowerCase());
+        return {
+            Name: p.Name,
+            Type: row?.Type ?? p.Type ?? 'string',
+            TypeKnown: row?.Type !== undefined || p.Type !== null,
+            IsRequired: p.IsRequired,
+            IsServerSet: row?.IsServerSet ?? false,
+            ValidationFilters: row?.ValidationFilters ?? null,
+            SampleValue: p.SampleValue ?? row?.SampleValue ?? null,
+        };
+    });
+    return definitions;
+}
+/**
+ * Why a render of the query may not run, as the run would refuse it: the first render (the base,
+ * then each `{% if %}` toggled) that is not a single read query or calls a function a query may not
+ * call. `null` when every render passes; a render that fails for another reason is left to
+ * {@link DescribeQueryOutput}, which reports it.
+ */
+export function FindUnsafeRender(input, template, parameters) {
+    const definitions = renderDefinitions(parameters, input.KnownParameters);
+    const renders = template.Tokens.HasTemplate ? renderAssignments(template) : [null];
+    for (const values of renders) {
+        const rendered = renderVariant(input, definitions, values);
+        if (rendered.Unsafe)
+            return rendered.Error;
+    }
+    return null;
+}
+/**
+ * A failed render. It is unsafe when the safety stage found a write or a forbidden call; SQL it
+ * refused only because it could not read it (a WITH clause written for another platform, whose own
+ * variant is saved later) is left to the describe and to the run-time gate, which fails closed.
+ */
+function renderFailure(e) {
+    return { SQL: '', Error: e instanceof Error ? e.message : String(e), Unsafe: IsQuerySafetyError(e) && !e.Unreadable };
+}
+/** Plain SQL, as written, once it passes the safety stage every rendered statement passes. */
+function plainVariant(input) {
+    try {
+        SafetyGate.AssertSafeToExecute(input.SQL, GetDialect(input.Platform), false);
+        return { SQL: input.SQL, Error: null, Unsafe: false };
+    }
+    catch (e) {
+        return renderFailure(e);
+    }
+}
+/** One render's SQL for `values` (`null`: plain SQL, rendered as written), or why it failed. */
+function renderVariant(input, definitions, values) {
+    if (values === null)
+        return plainVariant(input);
+    const callerValues = {};
+    const serverValues = {};
+    for (const definition of definitions) {
+        const value = renderValue(values[definition.Name], definition);
+        if (value === undefined)
+            continue;
+        (definition.IsServerSet ? serverValues : callerValues)[definition.Name] = value;
+    }
+    try {
+        const result = RenderPipeline.Run(input.SQL, {
+            Platform: input.Platform,
+            QueryID: input.QueryID ?? undefined,
+            ContextUser: input.ContextUser,
+            Parameters: callerValues,
+            ServerParameters: serverValues,
+            QueryInfo: { SQL: input.SQL, UsesTemplate: true, Parameters: definitions },
+            UsesTemplate: true,
+            OriginalSQL: input.SQL,
+            Dependencies: input.CompositionDependencies && input.CompositionDependencies.length > 0 ? [...input.CompositionDependencies] : undefined,
+        });
+        return { SQL: result.FinalSQL, Error: null, Unsafe: false };
+    }
+    catch (e) {
+        return renderFailure(e);
+    }
+}
+/**
+ * The value a branch value gives a parameter in a render; `undefined` leaves it out. A compared
+ * literal that is not a value of the parameter's known type (text compared with a date) would fail
+ * the parameter's validation, so the type's sample stands in for it.
+ */
+function renderValue(branch, definition) {
+    if (!branch || branch.Kind === 'Absent')
+        return undefined;
+    if (branch.Kind === 'Literal') {
+        if (branch.Value === null)
+            return undefined;
+        const text = String(branch.Value);
+        if (!definition.TypeKnown || literalFitsType(text, definition.Type))
+            return text;
+    }
+    return definition.TypeKnown ? SampleValueFor(definition.Type, definition.SampleValue) : definition.SampleValue?.trim() || UNTYPED_SAMPLE;
+}
+/** Whether a compared literal, as text, is a value of `type`: a number, a date or a boolean; any text for the other types. */
+function literalFitsType(text, type) {
+    switch (type) {
+        case 'number': return text.trim() !== '' && Number.isFinite(Number(text));
+        case 'date': return !isNaN(new Date(text).getTime());
+        case 'boolean': return text === 'true' || text === 'false';
+        default: return true;
+    }
+}
+/**
+ * The sample of a parameter whose type nothing establishes: a numeric string, valid wherever such
+ * a value can go (a string, a number in arithmetic or a comparison, a composed number argument).
+ */
+const UNTYPED_SAMPLE = '1';
+/**
+ * A truthy sample value of `type`, as a render takes it: the row's sample when it fits the type,
+ * otherwise a fixed value (`Sample`, `1`, `2024-01-01`, `true`, `["1"]`). An array's fixed element is
+ * a numeric string, so a loop over it can feed a string hole or a number argument alike.
+ */
+export function SampleValueFor(type, sample) {
+    const given = sample?.trim() ? sample : null;
+    switch (type) {
+        case 'number': return given !== null && !isNaN(Number(given)) && Number(given) !== 0 ? given : '1';
+        case 'date': return given !== null && !isNaN(new Date(given).getTime()) ? given : '2024-01-01';
+        case 'boolean': return 'true';
+        case 'array': return given !== null ? NormalizeDefaultForType(given, 'array') : '["1"]';
+        default: return given ?? 'Sample';
+    }
+}
+//# sourceMappingURL=describeFacts.js.map

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

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