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

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":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAqBvD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAkC,EAAE,KAAiC;IACjG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAsB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC,CAAC,CAAC;IACvF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACxF,IAAI,IAAI,KAAK,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACxD,OAAO;QACH,KAAK,EAAE,CAAC,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAuB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;QACxG,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;KACtE,CAAC;AACN,CAAC;AAED,4FAA4F;AAC5F,SAAS,gBAAgB,CAAC,GAAsB,EAAE,SAAmD;IACjG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,OAAO,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YACpD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjB,UAAU,GAAG,IAAI,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,iHAAiH;AACjH,SAAS,UAAU,CAAC,GAAsB,EAAE,SAAmD;IAC3F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,KAAK,GAAG,CAAC,EAAU,EAAQ,EAAE;QAC/B,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,KAAK,CAAC,GAAG,CAAC,CAAC;gBACX,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;QACL,CAAC;QACD,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QAC1C,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,IAAI,MAA0B,CAAC;QAC/B,GAAG,CAAC;YACA,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YACrB,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM;YAChC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC,QAAQ,MAAM,KAAK,EAAE,EAAE;QACxB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC,CAAC;IACF,KAAK,MAAM,EAAE,IAAI,GAAG;QAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { CompositionEdge, OrderableQuery } from "./refreshOrder.js";
+import type { QueryRefreshContext, QueryRefreshFilter } from "./refreshTypes.js";
+/** The queries a filter selects, the selectors that matched nothing, and the composition edges among them. */
+export interface RefreshSelection {
+    readonly Queries: readonly OrderableQuery[];
+    /** Each ID or name the filter gave that matched no query the caller can read, as given. */
+    readonly Unmatched: readonly string[];
+    readonly Edges: readonly CompositionEdge[];
+}
+/**
+ * The queries `filter` selects, read as the caller from the database (never a cache), so a
+ * caller only ever selects queries it can read. Selectors combine as a union.
+ */
+export declare function SelectQueriesForRefresh(context: QueryRefreshContext, filter: QueryRefreshFilter): Promise<RefreshSelection>;
+//# sourceMappingURL=refreshSelection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refreshSelection.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/refreshSelection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAoB9E,8GAA8G;AAC9G,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBjI"}

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

@@ -0,0 +1,99 @@
+import { NormalizeUUID } from "@memberjunction/global";
+/**
+ * The queries `filter` selects, read as the caller from the database (never a cache), so a
+ * caller only ever selects queries it can read. Selectors combine as a union.
+ */
+export async function SelectQueriesForRefresh(context, filter) {
+    const entityIDs = entityIDsOf(context, filter);
+    const [queries, categories, links, edges] = await readAll(context, entityIDs.length > 0);
+    const paths = categoryPaths(categories);
+    const selected = new Map();
+    const unmatched = [];
+    const add = (rows) => rows.forEach(r => selected.set(NormalizeUUID(r.ID), r));
+    if (filter.All)
+        add(queries);
+    for (const id of filter.QueryIDs ?? [])
+        collect(queries.filter(q => NormalizeUUID(q.ID) === NormalizeUUID(id)), id, add, unmatched);
+    for (const name of filter.QueryNames ?? [])
+        collect(queries.filter(q => nameMatches(q, name, paths)), name, add, unmatched);
+    if (filter.CategoryPath)
+        add(queries.filter(q => inCategory(q, filter.CategoryPath ?? '', paths)));
+    if (entityIDs.length > 0) {
+        const wanted = new Set(entityIDs.map(NormalizeUUID));
+        const reading = new Set(links.filter(l => wanted.has(NormalizeUUID(l.EntityID))).map(l => NormalizeUUID(l.QueryID)));
+        add(queries.filter(q => reading.has(NormalizeUUID(q.ID))));
+    }
+    return { Queries: [...selected.values()].map(q => ({ ID: q.ID, Name: q.Name })), Unmatched: unmatched, Edges: edges };
+}
+function collect(rows, given, add, unmatched) {
+    if (rows.length === 0)
+        unmatched.push(given);
+    else
+        add(rows);
+}
+/** The entity IDs the filter names, by ID or by name (names the catalog does not hold select nothing). */
+function entityIDsOf(context, filter) {
+    const ids = [...(filter.EntityIDs ?? [])];
+    for (const name of filter.EntityNames ?? []) {
+        const entity = context.Provider.Entities.find(e => e.Name.trim().toLowerCase() === name.trim().toLowerCase());
+        if (entity)
+            ids.push(entity.ID);
+    }
+    return ids;
+}
+async function readAll(context, withLinks) {
+    const views = [
+        { EntityName: 'MJ: Queries', Fields: ['ID', 'Name', 'CategoryID'], OrderBy: 'Name', ResultType: 'simple', BypassCache: true, IgnoreMaxRows: true },
+        { EntityName: 'MJ: Query Categories', Fields: ['ID', 'Name', 'ParentID'], ResultType: 'simple', BypassCache: true, IgnoreMaxRows: true },
+        { EntityName: 'MJ: Query Dependencies', Fields: ['QueryID', 'DependsOnQueryID'], ResultType: 'simple', BypassCache: true, IgnoreMaxRows: true },
+    ];
+    if (withLinks)
+        views.push({ EntityName: 'MJ: Query Entities', Fields: ['QueryID', 'EntityID'], ResultType: 'simple', BypassCache: true, IgnoreMaxRows: true });
+    const results = await context.Provider.RunViews(views, context.User);
+    const failed = results.find(r => !r?.Success);
+    if (failed)
+        throw new Error(`the queries to refresh could not be read: ${failed.ErrorMessage}`);
+    const rows = (i) => (results[i]?.Results ?? []);
+    return [rows(0), rows(1), withLinks ? rows(3) : [], rows(2)];
+}
+/** Each category's full path (`Parent/Child`), lower-cased, by normalized ID. */
+function categoryPaths(categories) {
+    const byID = new Map(categories.map(c => [NormalizeUUID(c.ID), c]));
+    const paths = new Map();
+    const pathOf = (id, depth) => {
+        const known = paths.get(id);
+        if (known !== undefined)
+            return known;
+        const category = byID.get(id);
+        if (!category)
+            return '';
+        const parent = category.ParentID && depth < 64 ? pathOf(NormalizeUUID(category.ParentID), depth + 1) : '';
+        const path = (parent ? `${parent}/${category.Name.trim()}` : category.Name.trim()).toLowerCase();
+        paths.set(id, path);
+        return path;
+    };
+    for (const id of byID.keys())
+        pathOf(id, 0);
+    return paths;
+}
+function normalizePath(path) {
+    return path.split('/').map(s => s.trim()).filter(s => s.length > 0).join('/').toLowerCase();
+}
+function pathOfQuery(query, paths) {
+    return query.CategoryID ? paths.get(NormalizeUUID(query.CategoryID)) ?? '' : '';
+}
+/** A bare name matches every query with that name; a path matches the query at that full path. */
+function nameMatches(query, given, paths) {
+    const wanted = normalizePath(given);
+    const name = query.Name.trim().toLowerCase();
+    if (!given.includes('/'))
+        return name === wanted;
+    const category = pathOfQuery(query, paths);
+    return (category ? `${category}/${name}` : name) === wanted;
+}
+function inCategory(query, categoryPath, paths) {
+    const wanted = normalizePath(categoryPath);
+    const category = pathOfQuery(query, paths);
+    return wanted.length > 0 && (category === wanted || category.startsWith(`${wanted}/`));
+}
+//# sourceMappingURL=refreshSelection.js.map

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

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

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

@@ -0,0 +1,81 @@
+import type { IMetadataProvider, IRunViewProvider, UserInfo } from "@memberjunction/core";
+import type { ChildRowChange, QueryExtractionStatus } from "../query-extraction/index.js";
+/** The provider a refresh reads and writes through: the caller's, so its transaction and permissions apply. */
+export type QueryRefreshProvider = IMetadataProvider & IRunViewProvider;
+/**
+ * Which saved queries a bulk refresh covers. Selectors combine as a union; `All` selects every
+ * query the caller can read. A refresh with no selector refreshes nothing.
+ */
+export interface QueryRefreshFilter {
+    /** Query IDs. */
+    readonly QueryIDs?: readonly string[];
+    /** Query names, or full paths (`Category/Sub/Name`); a bare name selects every query with that name. */
+    readonly QueryNames?: readonly string[];
+    /** A category path (`Category/Sub`): the queries in that category and every category below it. */
+    readonly CategoryPath?: string;
+    /** Entity names: the queries that read any of these entities (their `MJ: Query Entities` rows). */
+    readonly EntityNames?: readonly string[];
+    /** Entity IDs, as {@link EntityNames}. */
+    readonly EntityIDs?: readonly string[];
+    /** Every query. */
+    readonly All?: boolean;
+}
+/** How a refresh runs. */
+export interface QueryRefreshOptions {
+    /** Work out and report the changes without writing anything. */
+    readonly DryRun?: boolean;
+    /** Queue the LLM description pass for rows still without a description (off by default). */
+    readonly WithAI?: boolean;
+    /** Called once per query as a bulk refresh finishes it. */
+    readonly OnProgress?: (progress: QueryRefreshProgress) => void;
+}
+/** A bulk refresh's progress after one query. */
+export interface QueryRefreshProgress {
+    readonly Processed: number;
+    readonly Total: number;
+    readonly Report: QueryRefreshReport;
+}
+/**
+ * What happened to one query:
+ * - `Refreshed`: the child rows or the query's extraction columns changed (with `DryRun`: would change);
+ * - `Unchanged`: the stored rows already match the SQL;
+ * - `NotPermitted`: a bulk refresh skipped a query the caller may not refresh (no reason is given);
+ * - `Unavailable`: the query does not exist or the caller may not refresh it (the two read alike);
+ * - `Failed`: the refresh could not be completed, and nothing was written.
+ */
+export type QueryRefreshOutcome = 'Refreshed' | 'Unchanged' | 'NotPermitted' | 'Unavailable' | 'Failed';
+/** One query's refresh. */
+export interface QueryRefreshReport {
+    /** The query's ID; for `Unavailable`, the identifier the caller supplied. */
+    readonly QueryID: string;
+    /** The query's name; empty for `Unavailable`. */
+    readonly QueryName: string;
+    readonly Outcome: QueryRefreshOutcome;
+    readonly DryRun: boolean;
+    /** The extraction status the run records (or, with `DryRun`, would record); `null` when it did not run. */
+    readonly ExtractionStatus: QueryExtractionStatus | null;
+    /** The columns of the query row itself the run changes (`UsesTemplate`, `ExtractedSQLHash`, `ExtractionStatus`, `ExtractionMessage`). */
+    readonly QueryColumns: readonly string[];
+    readonly Added: readonly ChildRowChange[];
+    readonly Updated: readonly ChildRowChange[];
+    readonly Removed: readonly ChildRowChange[];
+    /** Authored parameters the SQL no longer uses: kept, and flagged on the query. */
+    readonly Flagged: readonly string[];
+    /** The run's diagnostics (`ExtractionMessage` lines), or why it was not completed. */
+    readonly Diagnostics: readonly string[];
+}
+/** A bulk refresh: one report per query, in the order the queries were refreshed. */
+export interface QueryRefreshRunReport {
+    readonly DryRun: boolean;
+    readonly Reports: readonly QueryRefreshReport[];
+    /** Queries that compose each other in a cycle, by name; each was refreshed once, after the rest. */
+    readonly Cycles: readonly (readonly string[])[];
+}
+/** Who a refresh runs as and through which provider. */
+export interface QueryRefreshContext {
+    readonly Provider: QueryRefreshProvider;
+    readonly User: UserInfo;
+}
+/** Whether `provider` can read views and create entity objects, which is everything a refresh needs. */
+export declare function IsQueryRefreshProvider(provider: IMetadataProvider): provider is QueryRefreshProvider;
+//# sourceMappingURL=refreshTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refreshTypes.d.ts","sourceRoot":"","sources":["../../../src/custom/query-refresh/refreshTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,+GAA+G;AAC/G,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,wGAAwG;IACxG,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,kGAAkG;IAClG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,mBAAmB;IACnB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAClE;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,CAAC;AAExG,2BAA2B;AAC3B,MAAM,WAAW,kBAAkB;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,2GAA2G;IAC3G,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACxD,yIAAyI;IACzI,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD,oGAAoG;IACpG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CACnD;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CAC3B;AAED,wGAAwG;AACxG,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,QAAQ,IAAI,oBAAoB,CAEpG"}

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

@@ -0,0 +1,5 @@
+/** Whether `provider` can read views and create entity objects, which is everything a refresh needs. */
+export function IsQueryRefreshProvider(provider) {
+    return typeof Reflect.get(provider, 'RunViews') === 'function' && typeof Reflect.get(provider, 'RunView') === 'function';
+}
+//# sourceMappingURL=refreshTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refreshTypes.js","sourceRoot":"","sources":["../../../src/custom/query-refresh/refreshTypes.ts"],"names":[],"mappings":"AAuFA,wGAAwG;AACxG,MAAM,UAAU,sBAAsB,CAAC,QAA2B;IAC9D,OAAO,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAK,UAAU,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,UAAU,CAAC;AAC7H,CAAC"}

package/dist/custom/systemUserGuardState.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview What the system-user field-access guards read from the DATABASE, and the rule that
+ * keeps two guarded writes out of one transaction group.
+ *
+ * The guards on `MJ: User Roles` and `MJ: Entity Field Permissions` judge one write against the
+ * state before it. Two cached inputs can make that state stale:
+ *
+ * - the system user's roles in `UserCache`, which refreshes on a debounce after a role save;
+ * - field rules on loaded metadata, which refreshes after the rule save.
+ *
+ * Two quick saves (assign a role to the system user, then put a `Deny` on that role) each passed
+ * against the cached state the other had not reached yet. So the guards read the system user's
+ * roles and the relevant rules here, straight from the database, with the cache bypassed. Inside a
+ * database transaction those reads see the transaction's own earlier writes.
+ *
+ * A transaction group is different: its items are checked when they enrol and written together at
+ * submit, so no read can see the group's other items. Two guarded writes in one group that concern
+ * the system user are therefore refused ({@link GuardedTransactionGroupRefusal}); each one saved on
+ * its own is checked against the state the other left.
+ */
+import { IMetadataProvider, IRunViewProvider, UserInfo } from '@memberjunction/core';
+import { SystemUserFieldAccessViolation } from '@memberjunction/generic-database-provider';
+/** The cached system user, or null when the cache is cold. */
+export declare function CachedSystemUser(): UserInfo | null;
+/** Whether `userID` names the system user. False on a cold cache or a missing ID. */
+export declare function IsSystemUserID(userID: string | null | undefined): boolean;
+/**
+ * The system user with its role set as stored in the database now, not as cached. Null when no
+ * system user resolves (a cold cache, where the guards stand down and the startup sweep is the
+ * backstop). Throws when the read fails, so a guard can refuse rather than permit unchecked.
+ */
+export declare function LoadStoredSystemUser(runViewProvider: IRunViewProvider | null | undefined): Promise<UserInfo | null>;
+/** Whether `user` holds `roleID`. False for a null user or a missing role. */
+export declare function UserHoldsRole(user: UserInfo | null, roleID: string | null | undefined): boolean;
+/**
+ * Every field the system user would lose by giving up `roleID`, judged on the role set and the
+ * rules as stored now. Empty when no system user resolves. Throws when a read fails.
+ */
+export declare function StoredRoleRemovalViolations(runViewProvider: IRunViewProvider | null | undefined, provider: IMetadataProvider, roleID: string): Promise<SystemUserFieldAccessViolation[]>;
+/**
+ * The `EntityFieldID`s on which `roleID` carries a restricting rule (a `Deny` on any verb, any
+ * spelling), as stored now. Throws when the read fails.
+ */
+export declare function StoredRestrictingFieldIDsForRole(runViewProvider: IRunViewProvider | null | undefined, roleID: string): Promise<string[]>;
+/** A guarded write's place in its transaction group, reserved when it passed the group check. */
+export type PendingGuardedGroupWrite = {
+    Group: object;
+    ConcernsSystemUser: boolean;
+};
+/**
+ * Why a guarded write may not enrol in `group`, or null. Refused when the group already holds a
+ * guarded write and this one or any earlier one concerns the system user: each is checked against
+ * the database before any is written, so none can see what the others change. A write outside a
+ * group is never refused here.
+ *
+ * Earlier writes are those holding a place reserved by {@link ReserveGuardedTransactionGroupWrite}.
+ * The place is taken when the check passes, not when the write enrols, so two guarded saves in
+ * flight at once (a `Promise.all`) cannot both pass; a write that is then refused, returns false
+ * or throws gives its place back ({@link ReleaseGuardedTransactionGroupWrite}), so a retry is not
+ * mistaken for a second write.
+ *
+ * @param group the write's transaction group, if any
+ * @param concernsSystemUser whether this write touches the system user's roles or a rule bound to one of them
+ */
+export declare function GuardedTransactionGroupRefusal(group: object | null | undefined, concernsSystemUser: boolean): string | null;
+/**
+ * Reserves a guarded write's place in `group` when it passes the group check, in the same
+ * synchronous step as the check. Null outside a group, where nothing is reserved.
+ */
+export declare function ReserveGuardedTransactionGroupWrite(group: object | null | undefined, concernsSystemUser: boolean): PendingGuardedGroupWrite | null;
+/** Gives back a reserved place for a write that did not enrol. A null `write` releases nothing. */
+export declare function ReleaseGuardedTransactionGroupWrite(write: PendingGuardedGroupWrite | null): void;
+//# sourceMappingURL=systemUserGuardState.d.ts.map

package/dist/custom/systemUserGuardState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemUserGuardState.d.ts","sourceRoot":"","sources":["../../src/custom/systemUserGuardState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAEH,iBAAiB,EACjB,gBAAgB,EAEhB,QAAQ,EAEX,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEH,8BAA8B,EAEjC,MAAM,2CAA2C,CAAC;AAMnD,8DAA8D;AAC9D,wBAAgB,gBAAgB,IAAI,QAAQ,GAAG,IAAI,CAElD;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGzE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,eAAe,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAYzH;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE/F;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC7C,eAAe,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EACpD,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAQ3C;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CAClD,eAAe,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EACpD,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB;AA2CD,iGAAiG;AACjG,MAAM,MAAM,wBAAwB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,kBAAkB,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAW3H;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,kBAAkB,EAAE,OAAO,GAAG,wBAAwB,GAAG,IAAI,CAOlJ;AAED,mGAAmG;AACnG,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAMhG"}