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

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

@@ -0,0 +1,229 @@
+import { GetQueryDialect } from "@memberjunction/sql-dialect";
+import { CompositionFullPath, CompositionPathSegments, MatchCompositionPath, QueryTemplate, SqlTokens, TemplateSqlViews, } from "@memberjunction/sql-parser";
+import { IndexByUUID } from "@memberjunction/global";
+import { FormatQueryDiagnostic, QueryTextPosition } from "@memberjunction/core-entities";
+import { ExtractAliasFromSQL } from "./resolve.js";
+import { BindTableReferences, EntityObjectIndex } from "./sourceBinding.js";
+/**
+ * Reads the query with MJ's parser: whether it is a template, its parameters (with composition
+ * pass-throughs), its compositions, the entities it reads, duplicate output names, doc comments
+ * and the save-time rules. Never touches the database.
+ */
+export function AnalyzeQueryTemplate(input) {
+    const dialect = GetQueryDialect(input.Platform);
+    const template = QueryTemplate.Parse(input.SQL, dialect);
+    const validation = template.Validate({
+        Mode: input.Mode,
+        DeclaredParameters: DeclaredTemplateParameters(input.KnownParameters),
+        KnownParameterTypes: DetectedTemplateParameterTypes(input.KnownParameters),
+        QueryPath: input.QueryPath,
+        ResolveComposition: path => resolveTarget(path, input.Queries),
+    });
+    const docs = template.DocComments();
+    const resolved = resolveReferences(template.CompositionReferences().Value, input.Queries);
+    const structure = readStructure(input.SQL, dialect, input);
+    const diagnostics = [...validation.Diagnostics, ...docs.Diagnostics];
+    return {
+        Template: template,
+        UsesTemplate: template.Tokens.HasTemplate,
+        Parameters: parameterFacts(template, resolved.References, input.ParameterHints),
+        Dependencies: resolved.Complete ? resolved.References.map(r => dependencyFact(r, input.SQL)) : null,
+        Entities: structure.Entities,
+        DuplicateOutputNames: structure.DuplicateOutputNames,
+        ReadsParameterNamedSource: structure.ReadsParameterNamedSource,
+        FieldDocs: new Map(docs.Value.Fields.map(f => [f.Name.toLowerCase(), f.Description])),
+        Errors: diagnostics.filter(d => d.Severity === 'Error'),
+        Warnings: diagnostics.filter(d => d.Severity === 'Warning'),
+        Notes: [...resolved.Notes, ...structure.Notes],
+    };
+}
+/**
+ * The parameter rows that declare a type to the save-time rules: the rows a person wrote
+ * (`DetectionMethod` `Manual`), and the server-set rows, whose flag only a person sets. A row
+ * extraction detected records what the previous SQL implied, so it declares nothing: the SQL may
+ * change that parameter's filter, and the row then follows the new type.
+ */
+export function DeclaredTemplateParameters(known) {
+    return known.filter(p => p.IsAuthored || p.IsServerSet).map(p => ({ Name: p.Name, Type: p.Type, IsServerSet: p.IsServerSet }));
+}
+/**
+ * The types the detected parameter rows record (the rows {@link DeclaredTemplateParameters} leaves
+ * out). They are not authoritative, so they never decide whether a filter fits. They only type a
+ * value written without a filter when the SQL gives no type. Without them, a string written
+ * unfiltered into a query whose rows were all detected would only be warned about, not refused.
+ */
+export function DetectedTemplateParameterTypes(known) {
+    return known.filter(p => !p.IsAuthored && !p.IsServerSet).map(p => ({ Name: p.Name, Type: p.Type }));
+}
+/**
+ * Whether `sql` holds any MJ template tag (`{{ }}`, `{% %}`, `{# #}`, a composition) outside SQL
+ * comments, read by the lexer of `platform`'s dialect. This is what `UsesTemplate` records: a
+ * lexical fact, whatever extraction finds.
+ */
+export function SQLUsesTemplate(sql, platform) {
+    return SqlTokens.Lex(sql, GetQueryDialect(platform)).HasTemplate;
+}
+/**
+ * A diagnostic as one line of `ExtractionMessage` or a refusal: code, location, message and fix,
+ * in the shared format clients read back with `ParseQueryDiagnostic`. The location is the line and
+ * column of the diagnostic's start in `sql`, the text it was found in; without `sql` it is left out.
+ */
+export function DescribeDiagnostic(diagnostic, sql) {
+    const at = sql !== undefined ? QueryTextPosition(sql, diagnostic.Span.Start) : null;
+    return FormatQueryDiagnostic({
+        Code: diagnostic.Code,
+        Message: diagnostic.Message,
+        FixHint: diagnostic.FixHint,
+        Line: at?.Line ?? null,
+        Column: at?.Column ?? null,
+    });
+}
+// ─── Compositions ───────────────────────────────────────────────────────────
+/** The composed query at a reference's full path, as `QueryTemplate.Validate` asks for it. */
+function resolveTarget(fullPath, queries) {
+    const segments = CompositionPathSegments(fullPath);
+    const name = segments.pop() ?? '';
+    const match = MatchCompositionPath(segments, name, queries);
+    if (match.Kind !== 'Exact' && match.Kind !== 'PartialPath')
+        return null;
+    const query = match.Target;
+    return {
+        Exists: true,
+        Reusable: query.Reusable,
+        FullPath: match.Kind === 'PartialPath' ? match.FullPath : undefined,
+        // A server-set parameter is filled by the server on every run, never by an argument.
+        Parameters: query.QueryParameters.map(p => ({ Name: p.Name, IsRequired: p.IsRequired === true && !p.IsServerSet })),
+        Compositions: composedPaths(query, queries),
+    };
+}
+/** The full paths of the queries `query` composes, from its stored dependency rows. */
+function composedPaths(query, queries) {
+    const byID = IndexByUUID(queries);
+    return (query.QueryDependencies ?? [])
+        .map(d => byID.Get(d.DependsOnQueryID))
+        .filter((q) => q !== undefined)
+        .map(q => CompositionFullPath(q));
+}
+/** Each composition with the query it names (exact path, or a unique partial path). */
+function resolveReferences(references, queries) {
+    const resolved = [];
+    const notes = [];
+    for (const reference of references) {
+        const match = MatchCompositionPath(reference.CategoryPath, reference.Name, queries);
+        if (match.Kind === 'Exact' || match.Kind === 'PartialPath') {
+            resolved.push({ Reference: reference, Target: match.Target });
+        }
+        else {
+            notes.push(`The composition "${reference.FullPath}" names no single query; its dependency rows were left as they are.`);
+        }
+    }
+    return { References: resolved, Complete: notes.length === 0, Notes: notes };
+}
+function dependencyFact(resolved, sql) {
+    const reference = resolved.Reference;
+    const mapping = {};
+    for (const argument of reference.Arguments)
+        mapping[argument.Name] = argumentText(argument, sql);
+    return {
+        DependsOnQueryID: resolved.Target.ID,
+        ReferencePath: reference.FullPath,
+        Alias: ExtractAliasFromSQL(sql, sql.slice(reference.Span.Start, reference.Span.End)),
+        ParameterMapping: reference.Arguments.length > 0 ? JSON.stringify(mapping) : null,
+    };
+}
+/** An argument as the dependency row records it: a literal's value, `@Name` for a pass-through, else the expression text. */
+function argumentText(argument, sql) {
+    const expression = argument.Expression;
+    if (expression.Kind === 'Literal')
+        return String(expression.Value);
+    if (expression.Kind === 'Name')
+        return `@${expression.Name}`;
+    return `@{${sql.slice(expression.Span.Start, expression.Span.End)}}`;
+}
+// ─── Parameters ─────────────────────────────────────────────────────────────
+/** The template's parameters, typed and described from the composed query a pass-through argument feeds. */
+function parameterFacts(template, references, hints) {
+    const docs = new Map(template.DocComments().Value.Parameters.map(p => [p.Name.toLowerCase(), p.Description]));
+    return template.Parameters().Value.map(p => {
+        const fed = passThroughTarget(p.Name, references);
+        return {
+            Name: p.Name,
+            Type: inferredType(p) ?? (fed ? fed.Type : arithmeticTargetType(p.Name, references)),
+            IsRequired: p.IsRequired,
+            DefaultValue: p.DefaultValue === null ? null : String(p.DefaultValue),
+            SampleValue: hintFor(p.Name, hints) ?? fed?.SampleValue ?? null,
+            DocDescription: docs.get(p.Name.toLowerCase()) ?? null,
+            InheritedDescription: fed ? inheritedDescription(fed) : null,
+        };
+    });
+}
+function inferredType(parameter) {
+    return parameter.InferredType === 'unknown' ? null : parameter.InferredType;
+}
+function hintFor(name, hints) {
+    return hints?.get(name) ?? hints?.get(name.toLowerCase()) ?? null;
+}
+/** The composed query's parameter an explicit `(Arg=Name)` argument passes `name` to; the first one wins. */
+function passThroughTarget(name, references) {
+    const wanted = name.toLowerCase();
+    for (const { Reference, Target } of references) {
+        const argument = Reference.Arguments.find(a => a.Expression.Kind === 'Name' && a.Expression.Name.toLowerCase() === wanted);
+        const parameter = argument ? Target.QueryParameters.find(tp => tp.Name.toLowerCase() === argument.Name.toLowerCase()) : undefined;
+        if (parameter)
+            return parameter;
+    }
+    return undefined;
+}
+const ARITHMETIC_OPERATORS = new Set(['+', '-', '*', '/', '%']);
+/**
+ * `number` when `name` is read by an arithmetic composition argument (`Lo=Floor + 4`) that feeds a
+ * number parameter of the composed query: the outer value must be a number for the arithmetic to
+ * mean what it says (a string value would be concatenated by `+`). Otherwise no type.
+ */
+function arithmeticTargetType(name, references) {
+    const wanted = name.toLowerCase();
+    for (const { Reference, Target } of references) {
+        for (const argument of Reference.Arguments) {
+            const expression = argument.Expression;
+            if (expression.Kind !== 'Binary' || !ARITHMETIC_OPERATORS.has(expression.Operator))
+                continue;
+            if (!argument.ReferencedNames.some(n => n.toLowerCase() === wanted))
+                continue;
+            const parameter = Target.QueryParameters.find(tp => tp.Name.toLowerCase() === argument.Name.toLowerCase());
+            if (parameter?.Type === 'number')
+                return 'number';
+        }
+    }
+    return null;
+}
+function inheritedDescription(parameter) {
+    return parameter.Description ? `${parameter.Description} (passed through to "${parameter.Query}" as "${parameter.Name}")` : null;
+}
+// ─── Structure: entities read, duplicate output names ───────────────────────
+/** The table references and duplicate output names of every SQL reading of the template (one per branch variant). */
+function readStructure(sql, dialect, input) {
+    const views = TemplateSqlViews(sql, dialect);
+    const references = views.flatMap(v => [...v.Document.TableReferences().Value]);
+    const duplicates = new Map();
+    for (const view of views) {
+        for (const d of view.Document.DuplicateOutputNames().Value)
+            duplicates.set(d.Name.toLowerCase(), d.Name);
+    }
+    const complete = views.every(v => v.Complete);
+    const entities = BindTableReferences(references, new EntityObjectIndex(input.Entities), dialect.Grammar.DefaultSchema);
+    return {
+        Entities: complete ? entities : null,
+        DuplicateOutputNames: [...duplicates.values()],
+        ReadsParameterNamedSource: references.some(isParameterNamedReference),
+        Notes: complete ? [] : ['The SQL could not be read completely, so its Query Entities were left as they are.'],
+    };
+}
+/** The placeholder a template view writes for a `{{ }}` hole that stands where a name goes. */
+const IDENTIFIER_PLACEHOLDER = /^__MJI_\w+__$/;
+/** Whether a table reference's name (any part of it) is a template hole, not a name written in the SQL. */
+function isParameterNamedReference(reference) {
+    if (reference.CTE !== null || reference.Kind !== 'Table')
+        return false;
+    return reference.Name.Parts.some(part => IDENTIFIER_PLACEHOLDER.test(part.Value));
+}
+//# sourceMappingURL=templateFacts.js.map

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

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

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

@@ -1,6 +1,7 @@
 import type { IMetadataProvider, IRunViewProvider, UserInfo, DatabasePlatform } from "@memberjunction/core";
 import type { MJQueryEntityExtended } from "@memberjunction/core-entities";
 import type { MJParameterInfo, MJParseResult, SQLSelectColumn, SQLTableReference } from "@memberjunction/sql-parser";
+import type { DeclaredQueryChildren } from "./declared.js";
 /**
  * A parameter extracted from a query's SQL — the final merged result
  * combining deterministic parsing, dependency metadata, and LLM enrichment.
@@ -125,5 +126,8 @@ export interface QuerySyncContext {
     /** Skip the LLM enrichment stage, so the deterministic extraction alone decides parameters
      *  and fields (with heuristic descriptions). Set from the save's `SkipEntityAIActions`. */
     SkipAIEnrichment?: boolean;
+    /** Child rows the same save declared through the query's collections. Extraction leaves them
+     *  as the caller wrote them (see {@link DeclaredQueryChildren}). Absent means none. */
+    DeclaredChildren?: DeclaredQueryChildren;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/custom/query-refresh/QueryExtractionService.d.ts

@@ -0,0 +1,54 @@
+import type { QueryRefreshContext, QueryRefreshFilter, QueryRefreshOptions, QueryRefreshReport, QueryRefreshRunReport } from "./refreshTypes.js";
+/**
+ * Re-establishes saved queries' facts from their SQL and the database server, on demand: the
+ * same extraction a save of a changed query runs, without changing the SQL. Every entry point
+ * (the `Query.RefreshExtraction` remote operation, `mj query refresh`, CodeGen's re-bind pass)
+ * goes through this service, so the same authorization applies to all of them:
+ *
+ * - the caller needs Update on `MJ: Queries` and Create, Update and Delete on its derived child
+ *   entities, for a dry run too;
+ * - the caller must be able to read every entity the query reads, with no field denied on any of
+ *   them, because the report and the written rows expose their columns;
+ * - a refusal of a single query reads exactly like "not found"; a bulk run reports such a query
+ *   as `NotPermitted`, with no reason.
+ *
+ * Each query is refreshed in its own transaction on the caller's provider, and the child rows are
+ * written as the caller, so each write's own permission check also applies. A bulk run refreshes
+ * the queries a composition depends on before the queries that compose them.
+ */
+export declare class QueryExtractionService {
+    private readonly context;
+    constructor(context: QueryRefreshContext);
+    /**
+     * Refreshes one saved query.
+     *
+     * @param queryID - The query's ID; echoed, and nothing else, when the query is unavailable.
+     */
+    RefreshQuery(queryID: string, options?: QueryRefreshOptions): Promise<QueryRefreshReport>;
+    /**
+     * Refreshes every query `filter` selects that the caller can read, dependencies first. An ID
+     * or name that selects nothing is reported as `Unavailable`; a selected query the caller may
+     * not refresh is reported as `NotPermitted`.
+     */
+    RefreshQueries(filter: QueryRefreshFilter, options?: QueryRefreshOptions): Promise<QueryRefreshRunReport>;
+    /**
+     * The queries `filter` selects; `null` when a caller who may not refresh queries cannot read
+     * them either, so the selection cannot be made (a caller who may refresh and still cannot read
+     * them meets the read's error).
+     */
+    private select;
+    private get userCanRefresh();
+    private refreshSelected;
+    /** The query as the caller can load it; `null` when it does not exist or the caller cannot read it. */
+    private loadQuery;
+    private refreshLoaded;
+    /** Writes the refresh in its own transaction on the caller's provider; any failure rolls it back. */
+    private applyInTransaction;
+    /**
+     * The non-disclosure guard: whether the caller can see every entity the query reads, by its
+     * stored links and field sources and by the facts the refresh found.
+     */
+    private userCanSeeSources;
+    private entityName;
+}
+//# sourceMappingURL=QueryExtractionService.d.ts.map

package/dist/custom/query-refresh/QueryExtractionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryExtractionService.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/QueryExtractionService.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACR,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACxB,MAAM,gBAAgB,CAAC;AAKxB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAsB;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAEzD;;;;OAIG;IACU,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAO1G;;;;OAIG;IACU,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAe1H;;;;OAIG;YACW,MAAM;IASpB,OAAO,KAAK,cAAc,GAEzB;YAEa,eAAe;IAO7B,uGAAuG;YACzF,SAAS;YAUT,aAAa;IAuB3B,qGAAqG;YACvF,kBAAkB;IAMhC;;;OAGG;YACW,iBAAiB;IAY/B,OAAO,CAAC,UAAU;CAIrB"}

package/dist/custom/query-refresh/QueryExtractionService.js

@@ -0,0 +1,207 @@
+import { DatabaseProviderBase, LogError, RunInEntityTransaction } from "@memberjunction/core";
+import { EscapeSQLString, NormalizeUUID } from "@memberjunction/global";
+import { EntityIDsOfExtraction, QueryRefreshUnavailableMessage, UserCanRefreshQueries, UserCanSeeQuerySources, } from "./refreshAuthorization.js";
+import { OrderForRefresh } from "./refreshOrder.js";
+import { SelectQueriesForRefresh } from "./refreshSelection.js";
+/**
+ * Re-establishes saved queries' facts from their SQL and the database server, on demand: the
+ * same extraction a save of a changed query runs, without changing the SQL. Every entry point
+ * (the `Query.RefreshExtraction` remote operation, `mj query refresh`, CodeGen's re-bind pass)
+ * goes through this service, so the same authorization applies to all of them:
+ *
+ * - the caller needs Update on `MJ: Queries` and Create, Update and Delete on its derived child
+ *   entities, for a dry run too;
+ * - the caller must be able to read every entity the query reads, with no field denied on any of
+ *   them, because the report and the written rows expose their columns;
+ * - a refusal of a single query reads exactly like "not found"; a bulk run reports such a query
+ *   as `NotPermitted`, with no reason.
+ *
+ * Each query is refreshed in its own transaction on the caller's provider, and the child rows are
+ * written as the caller, so each write's own permission check also applies. A bulk run refreshes
+ * the queries a composition depends on before the queries that compose them.
+ */
+export class QueryExtractionService {
+    constructor(context) {
+        this.context = context;
+    }
+    /**
+     * Refreshes one saved query.
+     *
+     * @param queryID - The query's ID; echoed, and nothing else, when the query is unavailable.
+     */
+    async RefreshQuery(queryID, options = {}) {
+        if (!this.userCanRefresh)
+            return unavailableReport(queryID, options);
+        const query = await this.loadQuery(queryID);
+        if (!query)
+            return unavailableReport(queryID, options);
+        return this.refreshLoaded(query, options, 'Unavailable', queryID);
+    }
+    /**
+     * Refreshes every query `filter` selects that the caller can read, dependencies first. An ID
+     * or name that selects nothing is reported as `Unavailable`; a selected query the caller may
+     * not refresh is reported as `NotPermitted`.
+     */
+    async RefreshQueries(filter, options = {}) {
+        const dryRun = options.DryRun === true;
+        const selection = await this.select(filter);
+        if (!selection)
+            return unselectableRun(filter, options);
+        const order = OrderForRefresh(selection.Queries, selection.Edges);
+        const reports = selection.Unmatched.map(label => unavailableReport(label, options));
+        const total = order.Order.length;
+        for (const [index, query] of order.Order.entries()) {
+            const report = await this.refreshSelected(query, options);
+            reports.push(report);
+            options.OnProgress?.({ Processed: index + 1, Total: total, Report: report });
+        }
+        return { DryRun: dryRun, Reports: reports, Cycles: order.Cycles };
+    }
+    /**
+     * The queries `filter` selects; `null` when a caller who may not refresh queries cannot read
+     * them either, so the selection cannot be made (a caller who may refresh and still cannot read
+     * them meets the read's error).
+     */
+    async select(filter) {
+        try {
+            return await SelectQueriesForRefresh(this.context, filter);
+        }
+        catch (e) {
+            if (this.userCanRefresh)
+                throw e;
+            return null;
+        }
+    }
+    get userCanRefresh() {
+        return UserCanRefreshQueries(this.context.User, this.context.Provider.Entities);
+    }
+    async refreshSelected(selected, options) {
+        if (!this.userCanRefresh)
+            return notPermittedReport(selected.ID, selected.Name, options);
+        const query = await this.loadQuery(selected.ID);
+        if (!query)
+            return notPermittedReport(selected.ID, selected.Name, options);
+        return this.refreshLoaded(query, options, 'NotPermitted', selected.ID);
+    }
+    /** The query as the caller can load it; `null` when it does not exist or the caller cannot read it. */
+    async loadQuery(queryID) {
+        try {
+            const query = await this.context.Provider.GetEntityObject('MJ: Queries', this.context.User);
+            return await query.Load(queryID) ? query : null;
+        }
+        catch (e) {
+            LogError(`[QueryExtractionService] query ${queryID} could not be loaded: ${e instanceof Error ? e.message : String(e)}`);
+            return null;
+        }
+    }
+    async refreshLoaded(query, options, refusal, label) {
+        const dryRun = options.DryRun === true;
+        try {
+            if (!query.SQL || query.SQL.trim().length === 0) {
+                return { ...emptyReport(query.ID, query.Name, 'Unchanged', dryRun), Diagnostics: ['The query has no SQL, so there is nothing to refresh.'] };
+            }
+            const extraction = await query.ComputeRefreshExtractionAsync();
+            if (!await this.userCanSeeSources(query.ID, extraction)) {
+                return refusal === 'Unavailable' ? unavailableReport(label, options) : notPermittedReport(query.ID, query.Name, options);
+            }
+            const rowChanges = queryRowChanges(query, extraction);
+            const preview = await query.PreviewRefreshAsync(extraction, id => this.entityName(id));
+            const summary = dryRun || !needsWrite(preview, rowChanges, options)
+                ? preview
+                : await this.applyInTransaction(query, extraction, options.WithAI === true);
+            return reportOf(query, extraction, summary, rowChanges, dryRun);
+        }
+        catch (e) {
+            const reason = e instanceof Error ? e.message : String(e);
+            LogError(`[QueryExtractionService] refresh of query "${query.Name}" failed: ${reason}`);
+            return { ...emptyReport(query.ID, query.Name, 'Failed', dryRun), Diagnostics: [`The refresh was not completed and nothing was written: ${reason}`] };
+        }
+    }
+    /** Writes the refresh in its own transaction on the caller's provider; any failure rolls it back. */
+    async applyInTransaction(query, extraction, withAI) {
+        const provider = this.context.Provider;
+        const work = () => query.ApplyRefreshAsync(extraction, withAI);
+        return provider instanceof DatabaseProviderBase ? RunInEntityTransaction(provider, work) : work();
+    }
+    /**
+     * The non-disclosure guard: whether the caller can see every entity the query reads, by its
+     * stored links and field sources and by the facts the refresh found.
+     */
+    async userCanSeeSources(queryID, extraction) {
+        const filter = `QueryID='${EscapeSQLString(queryID)}'`;
+        const [links, fields] = await this.context.Provider.RunViews([
+            { EntityName: 'MJ: Query Entities', ExtraFilter: filter, Fields: ['EntityID'], ResultType: 'simple', BypassCache: true, IgnoreMaxRows: true },
+            { EntityName: 'MJ: Query Fields', ExtraFilter: filter, Fields: ['SourceEntityID'], ResultType: 'simple', BypassCache: true, IgnoreMaxRows: true },
+        ], this.context.User);
+        if (!links?.Success || !fields?.Success)
+            return false;
+        const stored = [...links.Results.map(r => r.EntityID), ...fields.Results.map(r => r.SourceEntityID)]
+            .filter((id) => typeof id === 'string' && id.length > 0);
+        return UserCanSeeQuerySources(this.context.User, [...stored, ...EntityIDsOfExtraction(extraction)], this.context.Provider.Entities);
+    }
+    entityName(entityID) {
+        const wanted = NormalizeUUID(entityID);
+        return this.context.Provider.Entities.find(e => NormalizeUUID(e.ID) === wanted)?.Name ?? entityID;
+    }
+}
+/**
+ * Whether a refresh has anything to write: a child row or a query-row column changes, or the
+ * description pass was asked for and some row has no description. An unchanged query is not saved
+ * at all, so its timestamps and embedding stay as they are.
+ */
+function needsWrite(preview, rowChanges, options) {
+    if (preview.Changes.length > 0 || rowChanges.length > 0)
+        return true;
+    return options.WithAI === true && preview.FieldsWithoutDescription.length + preview.ParametersWithoutDescription.length > 0;
+}
+/**
+ * The run for a caller who may neither refresh nor read queries:
+ * each ID or name it gave is reported unavailable, and nothing else is selected or disclosed.
+ */
+function unselectableRun(filter, options) {
+    const labels = [...(filter.QueryIDs ?? []), ...(filter.QueryNames ?? [])];
+    return { DryRun: options.DryRun === true, Reports: labels.map(label => unavailableReport(label, options)), Cycles: [] };
+}
+/** The columns of the query row the refresh changes (`UsesTemplate` and the Extraction columns). */
+function queryRowChanges(query, extraction) {
+    const message = extraction.Messages.length > 0 ? extraction.Messages.join('\n') : null;
+    const changes = [];
+    if (query.UsesTemplate !== extraction.UsesTemplate)
+        changes.push('UsesTemplate');
+    if (query.ExtractedSQLHash !== extraction.Hash)
+        changes.push('ExtractedSQLHash');
+    if (query.ExtractionStatus !== extraction.Status)
+        changes.push('ExtractionStatus');
+    if ((query.ExtractionMessage ?? null) !== message)
+        changes.push('ExtractionMessage');
+    return changes;
+}
+function reportOf(query, extraction, summary, rowChanges, dryRun) {
+    const changes = summary?.Changes ?? [];
+    const pick = (action) => changes.filter(c => c.Action === action);
+    return {
+        QueryID: query.ID,
+        QueryName: query.Name,
+        Outcome: changes.length > 0 || rowChanges.length > 0 ? 'Refreshed' : 'Unchanged',
+        DryRun: dryRun,
+        ExtractionStatus: extraction.Status,
+        QueryColumns: [...rowChanges],
+        Added: pick('Added'),
+        Updated: pick('Updated'),
+        Removed: pick('Removed'),
+        Flagged: summary?.FlaggedParameters ?? [],
+        Diagnostics: [...extraction.Messages],
+    };
+}
+function emptyReport(queryID, queryName, outcome, dryRun) {
+    return { QueryID: queryID, QueryName: queryName, Outcome: outcome, DryRun: dryRun, ExtractionStatus: null, QueryColumns: [], Added: [], Updated: [], Removed: [], Flagged: [], Diagnostics: [] };
+}
+/** A query that does not exist or that the caller may not refresh: the two read alike, echoing only `label`. */
+function unavailableReport(label, options) {
+    return { ...emptyReport(label, '', 'Unavailable', options.DryRun === true), Diagnostics: [QueryRefreshUnavailableMessage(label)] };
+}
+/** A selected query a bulk run skips because the caller may not refresh it; no reason is given. */
+function notPermittedReport(queryID, queryName, options) {
+    return { ...emptyReport(queryID, queryName, 'NotPermitted', options.DryRun === true), Diagnostics: ['Skipped: not permitted.'] };
+}
+//# sourceMappingURL=QueryExtractionService.js.map

package/dist/custom/query-refresh/QueryExtractionService.js.map

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

package/dist/custom/query-refresh/QueryRefreshExtractionServerOperation.d.ts

@@ -0,0 +1,28 @@
+import type { IMetadataProvider, RemoteOpServerContext, UserInfo } from "@memberjunction/core";
+import { QueryRefreshExtractionOperation } from "@memberjunction/core-entities";
+import type { QueryRefreshExtractionInput, QueryRefreshExtractionOutput } from "@memberjunction/core-entities";
+import type { QueryRefreshFilter, QueryRefreshRunReport } from "./refreshTypes.js";
+/**
+ * Server implementation of the `Query.RefreshExtraction` remote operation: refreshes one saved
+ * query, or a selection, through {@link QueryExtractionService}, reporting each query as a
+ * progress event as it finishes.
+ *
+ * `Authorize` refuses a caller without Update on `MJ: Queries` and Create, Update and Delete on
+ * its child entities; the service applies the same check and the per-query non-disclosure guard
+ * for every entry point. An API-key caller also needs the operation's `query:refresh` scope.
+ * A request for exactly one query ID, and nothing else, reports a query that does not exist and
+ * one the caller may not refresh with the same message.
+ */
+export declare class QueryRefreshExtractionServerOperation extends QueryRefreshExtractionOperation {
+    protected Authorize(_input: QueryRefreshExtractionInput, user: UserInfo): Promise<boolean>;
+    protected InternalExecute(input: QueryRefreshExtractionInput, provider: IMetadataProvider, user: UserInfo, context: RemoteOpServerContext): Promise<QueryRefreshExtractionOutput>;
+}
+/** The service filter for an operation input; only the selectors the input gives. */
+export declare function RefreshFilterOf(input: QueryRefreshExtractionInput): QueryRefreshFilter;
+/** Whether a filter selects anything at all. */
+export declare function HasRefreshSelector(filter: QueryRefreshFilter): boolean;
+/** A service run as the operation's output. */
+export declare function RefreshOutputOf(run: QueryRefreshRunReport): QueryRefreshExtractionOutput;
+/** Keeps the operation in the bundle: import and call it where the class must be registered. */
+export declare function LoadQueryRefreshExtractionServerOperation(): void;
+//# sourceMappingURL=QueryRefreshExtractionServerOperation.d.ts.map

package/dist/custom/query-refresh/QueryRefreshExtractionServerOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryRefreshExtractionServerOperation.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/QueryRefreshExtractionServerOperation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EACR,2BAA2B,EAC3B,4BAA4B,EAG/B,MAAM,+BAA+B,CAAC;AAOvC,OAAO,KAAK,EAAE,kBAAkB,EAA2C,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEzH;;;;;;;;;;GAUG;AACH,qBACa,qCAAsC,SAAQ,+BAA+B;cAC7D,SAAS,CAAC,MAAM,EAAE,2BAA2B,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;cAIzF,eAAe,CAAC,KAAK,EAAE,2BAA2B,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,4BAA4B,CAAC;CAoB1L;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,KAAK,EAAE,2BAA2B,GAAG,kBAAkB,CAQtF;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAGtE;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,4BAA4B,CAOxF;AAqBD,gGAAgG;AAChG,wBAAgB,yCAAyC,IAAI,IAAI,CAEhE"}