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

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

@@ -0,0 +1,106 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseRemotableOperation, Metadata } from "@memberjunction/core";
+import { QueryRefreshExtractionOperation } from "@memberjunction/core-entities";
+import { RegisterClass } from "@memberjunction/global";
+import { QueryExtractionService } from "./QueryExtractionService.js";
+import { UserCanRefreshQueries } from "./refreshAuthorization.js";
+import { FormatQueryRefreshSummary } from "./refreshFormat.js";
+import { IsQueryRefreshProvider } 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.
+ */
+let QueryRefreshExtractionServerOperation = class QueryRefreshExtractionServerOperation extends QueryRefreshExtractionOperation {
+    async Authorize(_input, user) {
+        return UserCanRefreshQueries(user, Metadata.Provider.Entities); // global-provider-ok: Authorize receives no provider; entity permissions are process-global metadata
+    }
+    async InternalExecute(input, provider, user, context) {
+        if (!IsQueryRefreshProvider(provider))
+            throw new Error('Query.RefreshExtraction needs a database provider');
+        const filter = RefreshFilterOf(input);
+        if (!HasRefreshSelector(filter))
+            throw new Error('Give at least one selector: queryIDs, queryNames, categoryPath, entityNames or all.');
+        const service = new QueryExtractionService({ Provider: provider, User: user });
+        const options = {
+            DryRun: input.dryRun === true,
+            WithAI: input.withAI === true,
+            OnProgress: p => context.emitProgress({
+                OperationKey: this.OperationKey, Processed: p.Processed, Total: p.Total, Status: 'Running',
+                Message: `${p.Report.Outcome}: ${p.Report.QueryName || p.Report.QueryID}`,
+                Payload: { queryID: p.Report.QueryID, outcome: p.Report.Outcome },
+            }),
+        };
+        const single = filter.QueryIDs?.length === 1 && Object.keys(filter).length === 1 ? filter.QueryIDs[0] : null;
+        const run = single
+            ? { DryRun: options.DryRun === true, Reports: [await service.RefreshQuery(single, options)], Cycles: [] }
+            : await service.RefreshQueries(filter, options);
+        return RefreshOutputOf(run);
+    }
+};
+QueryRefreshExtractionServerOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Query.RefreshExtraction')
+], QueryRefreshExtractionServerOperation);
+export { QueryRefreshExtractionServerOperation };
+/** The service filter for an operation input; only the selectors the input gives. */
+export function RefreshFilterOf(input) {
+    const filter = {};
+    if (input.queryIDs?.length)
+        filter.QueryIDs = input.queryIDs;
+    if (input.queryNames?.length)
+        filter.QueryNames = input.queryNames;
+    if (input.categoryPath?.trim())
+        filter.CategoryPath = input.categoryPath;
+    if (input.entityNames?.length)
+        filter.EntityNames = input.entityNames;
+    if (input.all === true)
+        filter.All = true;
+    return filter;
+}
+/** Whether a filter selects anything at all. */
+export function HasRefreshSelector(filter) {
+    return filter.All === true || !!filter.QueryIDs?.length || !!filter.QueryNames?.length || !!filter.CategoryPath
+        || !!filter.EntityNames?.length || !!filter.EntityIDs?.length;
+}
+/** A service run as the operation's output. */
+export function RefreshOutputOf(run) {
+    return {
+        dryRun: run.DryRun,
+        reports: run.Reports.map(reportOutputOf),
+        cycles: run.Cycles.map(c => [...c]),
+        summary: FormatQueryRefreshSummary(run),
+    };
+}
+function reportOutputOf(report) {
+    return {
+        queryID: report.QueryID,
+        queryName: report.QueryName,
+        outcome: report.Outcome,
+        ...(report.ExtractionStatus ? { extractionStatus: report.ExtractionStatus } : {}),
+        queryColumns: [...report.QueryColumns],
+        added: report.Added.map(changeOutputOf),
+        updated: report.Updated.map(changeOutputOf),
+        removed: report.Removed.map(changeOutputOf),
+        flagged: [...report.Flagged],
+        diagnostics: [...report.Diagnostics],
+    };
+}
+function changeOutputOf(change) {
+    return { collection: change.Collection, name: change.Name, changedColumns: [...change.ChangedColumns] };
+}
+/** Keeps the operation in the bundle: import and call it where the class must be registered. */
+export function LoadQueryRefreshExtractionServerOperation() {
+    // The import is what registers the class.
+}
+//# sourceMappingURL=QueryRefreshExtractionServerOperation.js.map

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

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

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

@@ -0,0 +1,14 @@
+export { QueryExtractionService } from "./QueryExtractionService.js";
+export { UserCanRefreshQueries, UserCanSeeQuerySources, EntityIDsOfExtraction, QueryRefreshUnavailableMessage, QUERY_REFRESH_CHILD_ENTITIES, } from "./refreshAuthorization.js";
+export { OrderForRefresh } from "./refreshOrder.js";
+export type { OrderableQuery, CompositionEdge, RefreshOrder } from "./refreshOrder.js";
+export { SelectQueriesForRefresh } from "./refreshSelection.js";
+export type { RefreshSelection } from "./refreshSelection.js";
+export type { QueryRefreshProvider, QueryRefreshFilter, QueryRefreshOptions, QueryRefreshProgress, QueryRefreshOutcome, QueryRefreshReport, QueryRefreshRunReport, QueryRefreshContext, } from "./refreshTypes.js";
+export { RebindQueriesForChangedEntities, DefinerRightsDriftMessage } from "./queryRebind.js";
+export type { QueryRebindResult, QueryDefinerRightsDrift } from "./queryRebind.js";
+export { FormatQueryRefreshRun, FormatQueryRefreshReport, FormatQueryRefreshSummary, QueryRefreshTotalsOf } from "./refreshFormat.js";
+export type { QueryRefreshTotals } from "./refreshFormat.js";
+export { IsQueryRefreshProvider } from "./refreshTypes.js";
+export { QueryRefreshExtractionServerOperation, LoadQueryRefreshExtractionServerOperation, RefreshFilterOf, HasRefreshSelector, RefreshOutputOf, } from "./QueryRefreshExtractionServerOperation.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EACR,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC3F,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACnI,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACH,qCAAqC,EACrC,yCAAyC,EACzC,eAAe,EACf,kBAAkB,EAClB,eAAe,GAClB,MAAM,yCAAyC,CAAC"}

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

@@ -0,0 +1,10 @@
+// Query refresh — re-establishing saved queries' facts on demand, and its authorization
+export { QueryExtractionService } from "./QueryExtractionService.js";
+export { UserCanRefreshQueries, UserCanSeeQuerySources, EntityIDsOfExtraction, QueryRefreshUnavailableMessage, QUERY_REFRESH_CHILD_ENTITIES, } from "./refreshAuthorization.js";
+export { OrderForRefresh } from "./refreshOrder.js";
+export { SelectQueriesForRefresh } from "./refreshSelection.js";
+export { RebindQueriesForChangedEntities, DefinerRightsDriftMessage } from "./queryRebind.js";
+export { FormatQueryRefreshRun, FormatQueryRefreshReport, FormatQueryRefreshSummary, QueryRefreshTotalsOf } from "./refreshFormat.js";
+export { IsQueryRefreshProvider } from "./refreshTypes.js";
+export { QueryRefreshExtractionServerOperation, LoadQueryRefreshExtractionServerOperation, RefreshFilterOf, HasRefreshSelector, RefreshOutputOf, } from "./QueryRefreshExtractionServerOperation.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/custom/query-refresh/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAY7D,OAAO,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEnI,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACH,qCAAqC,EACrC,yCAAyC,EACzC,eAAe,EACf,kBAAkB,EAClB,eAAe,GAClB,MAAM,yCAAyC,CAAC"}

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

@@ -0,0 +1,33 @@
+import type { QueryRefreshContext, QueryRefreshRunReport } from "./refreshTypes.js";
+/** A query that runs with definer's rights and gained a column field-level security restricts. */
+export interface QueryDefinerRightsDrift {
+    readonly QueryID: string;
+    readonly QueryName: string;
+    /** The added output columns, each sourced from a field that has field permissions. */
+    readonly Fields: readonly string[];
+}
+/** What a re-bind pass did. */
+export interface QueryRebindResult {
+    /** The changed entities the pass was given. */
+    readonly EntityCount: number;
+    readonly Run: QueryRefreshRunReport;
+    readonly Drift: readonly QueryDefinerRightsDrift[];
+}
+/**
+ * Re-binds the saved queries that read entities whose fields changed (a column added, dropped, or
+ * changed in type or nullability): each query that reads one of them (its `MJ: Query Entities`
+ * rows) is refreshed, with no description pass, so its fields follow the schema again. The SQL is
+ * never edited: a query the change broke is recorded with status `Error` and the database
+ * server's message.
+ *
+ * A query with `MJ: Query Permissions` rows runs with definer's rights: its role list alone
+ * authorizes a run, whatever the SQL reads. When such a query gains an output column (a `*` over
+ * a view that gained one) sourced from a field that has field permissions, the column now reaches
+ * every role on the list. The pass records that on the query as a `Warning` and returns it.
+ *
+ * @param entityIDs - The entities whose fields changed.
+ */
+export declare function RebindQueriesForChangedEntities(context: QueryRefreshContext, entityIDs: readonly string[]): Promise<QueryRebindResult>;
+/** The `ExtractionMessage` line for a definer's-rights query that gained restricted columns. */
+export declare function DefinerRightsDriftMessage(fields: readonly string[]): string;
+//# sourceMappingURL=queryRebind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryRebind.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/queryRebind.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAErG,kGAAkG;AAClG,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACtD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,+BAA+B,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAO5I;AAkDD,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI3E"}

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

@@ -0,0 +1,85 @@
+import { LogError } from "@memberjunction/core";
+import { EscapeSQLString, NormalizeUUID } from "@memberjunction/global";
+import { QueryExtractionService } from "./QueryExtractionService.js";
+/**
+ * Re-binds the saved queries that read entities whose fields changed (a column added, dropped, or
+ * changed in type or nullability): each query that reads one of them (its `MJ: Query Entities`
+ * rows) is refreshed, with no description pass, so its fields follow the schema again. The SQL is
+ * never edited: a query the change broke is recorded with status `Error` and the database
+ * server's message.
+ *
+ * A query with `MJ: Query Permissions` rows runs with definer's rights: its role list alone
+ * authorizes a run, whatever the SQL reads. When such a query gains an output column (a `*` over
+ * a view that gained one) sourced from a field that has field permissions, the column now reaches
+ * every role on the list. The pass records that on the query as a `Warning` and returns it.
+ *
+ * @param entityIDs - The entities whose fields changed.
+ */
+export async function RebindQueriesForChangedEntities(context, entityIDs) {
+    const unique = [...new Set(entityIDs.map(NormalizeUUID))];
+    if (unique.length === 0)
+        return { EntityCount: 0, Run: { DryRun: false, Reports: [], Cycles: [] }, Drift: [] };
+    const run = await new QueryExtractionService(context).RefreshQueries({ EntityIDs: unique }, { WithAI: false });
+    const drift = await findDefinerRightsDrift(context, run.Reports);
+    for (const item of drift)
+        await recordDrift(context, item);
+    return { EntityCount: unique.length, Run: run, Drift: drift };
+}
+/** The refreshed queries that run with definer's rights and gained a column sourced from a field with field permissions. */
+async function findDefinerRightsDrift(context, reports) {
+    const restricted = restrictedFieldIDs(context.Provider.Entities);
+    const candidates = reports
+        .map(r => ({ Report: r, Fields: r.Added.filter(c => c.Collection === 'Fields' && c.SourceEntityFieldID && restricted.has(NormalizeUUID(c.SourceEntityFieldID))) }))
+        .filter(c => c.Fields.length > 0);
+    if (candidates.length === 0)
+        return [];
+    const definerRights = await queriesWithPermissions(context, candidates.map(c => c.Report.QueryID));
+    return candidates
+        .filter(c => definerRights.has(NormalizeUUID(c.Report.QueryID)))
+        .map(c => ({ QueryID: c.Report.QueryID, QueryName: c.Report.QueryName, Fields: c.Fields.map(f => f.Name) }));
+}
+/** The IDs of fields that have field permissions, or that belong to an entity field-level security applies to. */
+function restrictedFieldIDs(entities) {
+    const ids = new Set();
+    for (const entity of entities) {
+        for (const field of entity.Fields) {
+            if (field.HasFieldPermissions || entity.FieldLevelSecurityApplies)
+                ids.add(NormalizeUUID(field.ID));
+        }
+    }
+    return ids;
+}
+async function queriesWithPermissions(context, queryIDs) {
+    const list = queryIDs.map(id => `'${EscapeSQLString(id)}'`).join(',');
+    const result = await context.Provider.RunView({
+        EntityName: 'MJ: Query Permissions', ExtraFilter: `QueryID IN (${list})`, Fields: ['QueryID'], ResultType: 'simple', BypassCache: true, IgnoreMaxRows: true,
+    }, context.User);
+    if (!result.Success)
+        throw new Error(`the query permissions could not be read: ${result.ErrorMessage}`);
+    return new Set(result.Results.map(r => NormalizeUUID(r.QueryID)));
+}
+/** Records the drift on the query: status `Warning` (unless it is already `Error`) and a message line. */
+async function recordDrift(context, drift) {
+    const message = DefinerRightsDriftMessage(drift.Fields);
+    try {
+        const query = await context.Provider.GetEntityObject('MJ: Queries', context.User);
+        if (!await query.Load(drift.QueryID))
+            throw new Error('the query could not be loaded');
+        if (query.ExtractionStatus !== 'Error')
+            query.ExtractionStatus = 'Warning';
+        query.ExtractionMessage = query.ExtractionMessage ? `${query.ExtractionMessage}\n${message}` : message;
+        query.ExtractionOverride = 'Skip';
+        if (!await query.Save())
+            throw new Error(query.LatestResult?.CompleteMessage ?? 'the save failed');
+    }
+    catch (e) {
+        LogError(`[RebindQueriesForChangedEntities] the definer's-rights warning for query "${drift.QueryName}" could not be recorded: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/** The `ExtractionMessage` line for a definer's-rights query that gained restricted columns. */
+export function DefinerRightsDriftMessage(fields) {
+    return `The query's output gained ${fields.map(f => `"${f}"`).join(', ')}, sourced from fields restricted by field-level security. ` +
+        'The query is authorized by its Query Permissions role list alone, so every role on that list can now read these columns. ' +
+        'Review the role list, or name the columns the query returns instead of using *.';
+}
+//# sourceMappingURL=queryRebind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryRebind.js","sourceRoot":"","sources":["../../../src/custom/query-refresh/queryRebind.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAmBlE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAA4B,EAAE,SAA4B;IAC5G,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC/G,MAAM,GAAG,GAAG,MAAM,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/G,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACjE,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAClE,CAAC;AAED,4HAA4H;AAC5H,KAAK,UAAU,sBAAsB,CAAC,OAA4B,EAAE,OAAsC;IACtG,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,OAAO;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,mBAAmB,IAAI,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAClK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACnG,OAAO,UAAU;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACrH,CAAC;AAED,kHAAkH;AAClH,SAAS,kBAAkB,CAAC,QAA+B;IACvD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,mBAAmB,IAAI,MAAM,CAAC,yBAAyB;gBAAE,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACxG,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,OAA4B,EAAE,QAA2B;IAC3F,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;QAC/D,UAAU,EAAE,uBAAuB,EAAE,WAAW,EAAE,eAAe,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI;KAC9J,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IACxG,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,0GAA0G;AAC1G,KAAK,UAAU,WAAW,CAAC,OAA4B,EAAE,KAA8B;IACnF,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACvG,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACvF,IAAI,KAAK,CAAC,gBAAgB,KAAK,OAAO;YAAE,KAAK,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAC3E,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,iBAAiB,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACvG,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC;QAClC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,eAAe,IAAI,iBAAiB,CAAC,CAAC;IACvG,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,QAAQ,CAAC,6EAA6E,KAAK,CAAC,SAAS,4BAA4B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnL,CAAC;AACL,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,yBAAyB,CAAC,MAAyB;IAC/D,OAAO,6BAA6B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,4DAA4D;QAChI,2HAA2H;QAC3H,iFAAiF,CAAC;AAC1F,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { EntityInfo, UserInfo } from "@memberjunction/core";
+import type { QueryExtractionResult } from "../query-extraction/index.js";
+/** The child entities a refresh creates, updates and deletes rows of. */
+export declare const QUERY_REFRESH_CHILD_ENTITIES: readonly string[];
+/**
+ * Whether `user` may refresh queries at all: Update on `MJ: Queries`, and Create, Update and
+ * Delete on each of its derived child entities. A dry run needs the same, since its report
+ * discloses the same metadata. Run permissions (`MJ: Query Permissions`) play no part: refreshing
+ * is an authoring act.
+ */
+export declare function UserCanRefreshQueries(user: UserInfo, entities: readonly EntityInfo[]): boolean;
+/**
+ * Whether `user` may see what a refresh of one query reveals: the column names, types and
+ * sources of every entity the query reads. True only when the user can read every one of those
+ * entities and is denied no field on any of them.
+ *
+ * @param entityIDs - The entities the query reads: its stored links and field sources, and the ones
+ *   the refresh found ({@link EntityIDsOfExtraction}).
+ */
+export declare function UserCanSeeQuerySources(user: UserInfo, entityIDs: Iterable<string>, entities: readonly EntityInfo[]): boolean;
+/** The entities a refresh's facts link the query to: the entities it reads and its fields' sources. */
+export declare function EntityIDsOfExtraction(extraction: QueryExtractionResult): string[];
+/**
+ * The message for a refresh of a query that does not exist or that the caller may not refresh.
+ * The two are worded identically, so a refusal does not confirm that the query, or anything it
+ * reads, exists. It echoes only the identifier the caller supplied.
+ */
+export declare function QueryRefreshUnavailableMessage(label: string): string;
+//# sourceMappingURL=refreshAuthorization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refreshAuthorization.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/refreshAuthorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAKzD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAU9F;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAS5H;AAED,uGAAuG;AACvG,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAMjF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE"}

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

@@ -0,0 +1,66 @@
+import { NormalizeUUID } from "@memberjunction/global";
+/** The child entities a refresh creates, updates and deletes rows of. */
+export const QUERY_REFRESH_CHILD_ENTITIES = [
+    'MJ: Query Fields',
+    'MJ: Query Parameters',
+    'MJ: Query Entities',
+    'MJ: Query Dependencies',
+];
+/**
+ * Whether `user` may refresh queries at all: Update on `MJ: Queries`, and Create, Update and
+ * Delete on each of its derived child entities. A dry run needs the same, since its report
+ * discloses the same metadata. Run permissions (`MJ: Query Permissions`) play no part: refreshing
+ * is an authoring act.
+ */
+export function UserCanRefreshQueries(user, entities) {
+    const byName = new Map(entities.map(e => [e.Name.toLowerCase(), e]));
+    const query = byName.get('mj: queries');
+    if (!query || !query.GetUserPermisions(user)?.CanUpdate)
+        return false;
+    return QUERY_REFRESH_CHILD_ENTITIES.every(name => {
+        const entity = byName.get(name.toLowerCase());
+        if (!entity)
+            return false;
+        const permissions = entity.GetUserPermisions(user);
+        return !!permissions && permissions.CanCreate && permissions.CanUpdate && permissions.CanDelete;
+    });
+}
+/**
+ * Whether `user` may see what a refresh of one query reveals: the column names, types and
+ * sources of every entity the query reads. True only when the user can read every one of those
+ * entities and is denied no field on any of them.
+ *
+ * @param entityIDs - The entities the query reads: its stored links and field sources, and the ones
+ *   the refresh found ({@link EntityIDsOfExtraction}).
+ */
+export function UserCanSeeQuerySources(user, entityIDs, entities) {
+    const byID = new Map(entities.map(e => [NormalizeUUID(e.ID), e]));
+    for (const id of entityIDs) {
+        const entity = byID.get(NormalizeUUID(id));
+        if (!entity)
+            return false;
+        if (!entity.GetUserPermisions(user)?.CanRead)
+            return false;
+        if (entity.FieldLevelSecurityApplies && entity.GetDeniedReadFields(user).size > 0)
+            return false;
+    }
+    return true;
+}
+/** The entities a refresh's facts link the query to: the entities it reads and its fields' sources. */
+export function EntityIDsOfExtraction(extraction) {
+    const ids = (extraction.Entities ?? []).map(e => e.EntityID);
+    for (const field of extraction.Fields ?? []) {
+        if (field.SourceEntityID)
+            ids.push(field.SourceEntityID);
+    }
+    return ids;
+}
+/**
+ * The message for a refresh of a query that does not exist or that the caller may not refresh.
+ * The two are worded identically, so a refusal does not confirm that the query, or anything it
+ * reads, exists. It echoes only the identifier the caller supplied.
+ */
+export function QueryRefreshUnavailableMessage(label) {
+    return `Query '${label}' does not exist or you do not have permission to refresh it.`;
+}
+//# sourceMappingURL=refreshAuthorization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refreshAuthorization.js","sourceRoot":"","sources":["../../../src/custom/query-refresh/refreshAuthorization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,yEAAyE;AACzE,MAAM,CAAC,MAAM,4BAA4B,GAAsB;IAC3D,kBAAkB;IAClB,sBAAsB;IACtB,oBAAoB;IACpB,wBAAwB;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAc,EAAE,QAA+B;IACjF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,SAAS;QAAE,OAAO,KAAK,CAAC;IACtE,OAAO,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS,CAAC;IACpG,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAc,EAAE,SAA2B,EAAE,QAA+B;IAC/G,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3D,IAAI,MAAM,CAAC,yBAAyB,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IACpG,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,qBAAqB,CAAC,UAAiC;IACnE,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,cAAc;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAAa;IACxD,OAAO,UAAU,KAAK,+DAA+D,CAAC;AAC1F,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { QueryRefreshOutcome, QueryRefreshReport, QueryRefreshRunReport } from "./refreshTypes.js";
+/** How many queries of a run ended in each outcome. */
+export type QueryRefreshTotals = Record<QueryRefreshOutcome, number>;
+/** The number of reports per outcome. */
+export declare function QueryRefreshTotalsOf(run: QueryRefreshRunReport): QueryRefreshTotals;
+/** One line summing a run up: `12 refreshed, 19 unchanged, 0 failed (dry run)`. */
+export declare function FormatQueryRefreshSummary(run: QueryRefreshRunReport): string;
+/**
+ * The lines of a run's report: one heading per query, then its row changes, flagged parameters
+ * and diagnostics, then any composition cycles and the summary. With `changedOnly`, unchanged
+ * queries with no diagnostics are left out.
+ */
+export declare function FormatQueryRefreshRun(run: QueryRefreshRunReport, changedOnly?: boolean): string[];
+/** The lines of one query's report. */
+export declare function FormatQueryRefreshReport(report: QueryRefreshReport): string[];
+//# sourceMappingURL=refreshFormat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refreshFormat.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/refreshFormat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAErG,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAErE,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,qBAAqB,GAAG,kBAAkB,CAInF;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAS5E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,EAAE,WAAW,UAAQ,GAAG,MAAM,EAAE,CAS/F;AAED,uCAAuC;AACvC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAW7E"}

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

@@ -0,0 +1,67 @@
+/** The number of reports per outcome. */
+export function QueryRefreshTotalsOf(run) {
+    const totals = { Refreshed: 0, Unchanged: 0, NotPermitted: 0, Unavailable: 0, Failed: 0 };
+    for (const report of run.Reports)
+        totals[report.Outcome]++;
+    return totals;
+}
+/** One line summing a run up: `12 refreshed, 19 unchanged, 0 failed (dry run)`. */
+export function FormatQueryRefreshSummary(run) {
+    const t = QueryRefreshTotalsOf(run);
+    const verb = run.DryRun ? 'would be refreshed' : 'refreshed';
+    const parts = [`${t.Refreshed} ${verb}`, `${t.Unchanged} unchanged`, `${t.Failed} failed`];
+    if (t.NotPermitted > 0)
+        parts.push(`${t.NotPermitted} skipped (not permitted)`);
+    if (t.Unavailable > 0)
+        parts.push(`${t.Unavailable} unavailable`);
+    const withErrors = run.Reports.filter(r => r.ExtractionStatus === 'Error').length;
+    if (withErrors > 0)
+        parts.push(`${withErrors} with extraction errors`);
+    return `${run.Reports.length} queries: ${parts.join(', ')}${run.DryRun ? ' (dry run: nothing was written)' : ''}.`;
+}
+/**
+ * The lines of a run's report: one heading per query, then its row changes, flagged parameters
+ * and diagnostics, then any composition cycles and the summary. With `changedOnly`, unchanged
+ * queries with no diagnostics are left out.
+ */
+export function FormatQueryRefreshRun(run, changedOnly = false) {
+    const lines = [];
+    for (const report of run.Reports) {
+        if (changedOnly && report.Outcome === 'Unchanged' && report.Diagnostics.length === 0)
+            continue;
+        lines.push(...FormatQueryRefreshReport(report));
+    }
+    for (const cycle of run.Cycles)
+        lines.push(`Composition cycle (each refreshed once): ${cycle.join(' -> ')}`);
+    lines.push(FormatQueryRefreshSummary(run));
+    return lines;
+}
+/** The lines of one query's report. */
+export function FormatQueryRefreshReport(report) {
+    const name = report.QueryName ? `"${report.QueryName}" (${report.QueryID})` : report.QueryID;
+    const status = report.ExtractionStatus ? ` [${report.ExtractionStatus}]` : '';
+    const lines = [`${outcomeLabel(report)} ${name}${status}`];
+    if (report.QueryColumns.length > 0)
+        lines.push(`    ~ query (${report.QueryColumns.join(', ')})`);
+    for (const change of report.Added)
+        lines.push(`    + ${changeLabel(change)}`);
+    for (const change of report.Updated)
+        lines.push(`    ~ ${changeLabel(change)}${change.ChangedColumns.length > 0 ? ` (${change.ChangedColumns.join(', ')})` : ''}`);
+    for (const change of report.Removed)
+        lines.push(`    - ${changeLabel(change)}`);
+    for (const name of report.Flagged)
+        lines.push(`    ! parameter ${name}: authored, no longer used by the SQL (kept)`);
+    for (const line of report.Diagnostics)
+        lines.push(`    ${line}`);
+    return lines;
+}
+function outcomeLabel(report) {
+    if (report.Outcome === 'Refreshed')
+        return report.DryRun ? 'WOULD REFRESH' : 'REFRESHED';
+    return report.Outcome.toUpperCase();
+}
+function changeLabel(change) {
+    const kind = { Fields: 'field', Parameters: 'parameter', Entities: 'entity', Dependencies: 'dependency' }[change.Collection];
+    return `${kind} ${change.Name}`;
+}
+//# sourceMappingURL=refreshFormat.js.map

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

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

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

@@ -0,0 +1,25 @@
+/** A query to order, by ID, with a name for reporting. */
+export interface OrderableQuery {
+    readonly ID: string;
+    readonly Name: string;
+}
+/** A composition edge: `QueryID` composes `DependsOnQueryID`. */
+export interface CompositionEdge {
+    readonly QueryID: string;
+    readonly DependsOnQueryID: string;
+}
+/** The order to refresh in, and the composition cycles found. */
+export interface RefreshOrder {
+    readonly Order: readonly OrderableQuery[];
+    /** Each cycle's members, by name. */
+    readonly Cycles: readonly (readonly string[])[];
+}
+/**
+ * Orders `queries` so each comes after every selected query it composes (dependencies first),
+ * keeping the given order among queries that do not depend on each other. Queries in a
+ * composition cycle (stored by an older version that allowed one), and those that depend on
+ * them, come last in their given order; each is listed once, so a cycle is never followed round.
+ * Edges to queries outside the selection are ignored.
+ */
+export declare function OrderForRefresh(queries: readonly OrderableQuery[], edges: readonly CompositionEdge[]): RefreshOrder;
+//# sourceMappingURL=refreshOrder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refreshOrder.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/refreshOrder.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACrC;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,YAAY,CAmBnH"}

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

@@ -0,0 +1,95 @@
+import { NormalizeUUID } from "@memberjunction/global";
+/**
+ * Orders `queries` so each comes after every selected query it composes (dependencies first),
+ * keeping the given order among queries that do not depend on each other. Queries in a
+ * composition cycle (stored by an older version that allowed one), and those that depend on
+ * them, come last in their given order; each is listed once, so a cycle is never followed round.
+ * Edges to queries outside the selection are ignored.
+ */
+export function OrderForRefresh(queries, edges) {
+    const ids = queries.map(q => NormalizeUUID(q.ID));
+    const selected = new Set(ids);
+    const dependsOn = new Map(ids.map(id => [id, new Set()]));
+    for (const edge of edges) {
+        const from = NormalizeUUID(edge.QueryID);
+        const to = NormalizeUUID(edge.DependsOnQueryID);
+        if (selected.has(from) && selected.has(to) && from !== to)
+            dependsOn.get(from)?.add(to);
+        if (from === to && selected.has(from))
+            dependsOn.get(from)?.add(to);
+    }
+    const ordered = topologicalOrder(ids, dependsOn);
+    const placed = new Set(ordered);
+    const rest = ids.filter(id => !placed.has(id));
+    const byID = new Map(queries.map(q => [NormalizeUUID(q.ID), q]));
+    const nameOf = (id) => byID.get(id)?.Name ?? id;
+    return {
+        Order: [...ordered, ...rest].map(id => byID.get(id)).filter((q) => q !== undefined),
+        Cycles: findCycles(rest, dependsOn).map(cycle => cycle.map(nameOf)),
+    };
+}
+/** Kahn's algorithm, stable in the given order; nodes on or behind a cycle are left out. */
+function topologicalOrder(ids, dependsOn) {
+    const done = new Set();
+    const ordered = [];
+    let progressed = true;
+    while (progressed) {
+        progressed = false;
+        for (const id of ids) {
+            if (done.has(id))
+                continue;
+            const deps = dependsOn.get(id) ?? new Set();
+            if ([...deps].every(d => done.has(d))) {
+                done.add(id);
+                ordered.push(id);
+                progressed = true;
+            }
+        }
+    }
+    return ordered;
+}
+/** The strongly connected components among `ids` that are cycles (more than one member, or a self-reference). */
+function findCycles(ids, dependsOn) {
+    const within = new Set(ids);
+    const index = new Map();
+    const low = new Map();
+    const stack = [];
+    const onStack = new Set();
+    const cycles = [];
+    let counter = 0;
+    const visit = (id) => {
+        index.set(id, counter);
+        low.set(id, counter++);
+        stack.push(id);
+        onStack.add(id);
+        for (const dep of dependsOn.get(id) ?? []) {
+            if (!within.has(dep))
+                continue;
+            if (!index.has(dep)) {
+                visit(dep);
+                low.set(id, Math.min(low.get(id) ?? 0, low.get(dep) ?? 0));
+            }
+            else if (onStack.has(dep)) {
+                low.set(id, Math.min(low.get(id) ?? 0, index.get(dep) ?? 0));
+            }
+        }
+        if (low.get(id) !== index.get(id))
+            return;
+        const component = [];
+        let member;
+        do {
+            member = stack.pop();
+            if (member === undefined)
+                break;
+            onStack.delete(member);
+            component.push(member);
+        } while (member !== id);
+        if (component.length > 1 || dependsOn.get(id)?.has(id))
+            cycles.push(component.reverse());
+    };
+    for (const id of ids)
+        if (!index.has(id))
+            visit(id);
+    return cycles;
+}
+//# sourceMappingURL=refreshOrder.js.map

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

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