@intentius/chant-lexicon-sql 0.124.46 → 0.124.49

package/dist/change-set.d.ts

@@ -25,7 +25,7 @@
  * dialects' `CHANGE_CLASSES` and `PG_CHANGE_CLASSES` price them:
  *
  * - a `drop` class is a `delete` (`destroy`); a `create` class a `create`;
- * - a `rebuild` or `expand` class, or a step a migration Op makes, is a
+ * - a `rebuild`, `replace` or `expand` class, or a step a migration Op makes, is a
  *   `replace` (`replace`): the object, or a column of it, is built again;
  * - anything else is an `update`, its disruption the worst class's
  *   (`metadata` in-place; `validate`, `concurrently` and `rewrite` rolling).

package/dist/change-set.d.ts.map

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

package/dist/change-set.js

@@ -25,7 +25,7 @@
  * dialects' `CHANGE_CLASSES` and `PG_CHANGE_CLASSES` price them:
  *
  * - a `drop` class is a `delete` (`destroy`); a `create` class a `create`;
- * - a `rebuild` or `expand` class, or a step a migration Op makes, is a
+ * - a `rebuild`, `replace` or `expand` class, or a step a migration Op makes, is a
  *   `replace` (`replace`): the object, or a column of it, is built again;
  * - anything else is an `update`, its disruption the worst class's
  *   (`metadata` in-place; `validate`, `concurrently` and `rewrite` rolling).
@@ -55,6 +55,7 @@ export const SQL_CLASS_DISRUPTION = {
     validate: "rolling",
     concurrently: "rolling",
     rewrite: "rolling",
+    replace: "replace",
     rebuild: "replace",
     expand: "replace",
     drop: "destroy",

package/dist/clickhouse/apply/statements.d.ts

@@ -190,4 +190,13 @@ export interface StatementPlan {
 export declare function planStatements(input: StatementPlanInput): StatementPlan;
 /** The entity types of access control (`../access.ts`): no comment, no marker, never dropped. */
 export declare const ACCESS_TYPES: ReadonlySet<string>;
+/**
+ * The statements that replace a stream table (#4396), in the order they run:
+ * detach each materialized view that reads it (`readers`, as the server has
+ * them), drop the table, create it as declared, attach the views. The table
+ * holds no rows, so nothing is copied; a view that stays detached for the
+ * length of the replacement reads nothing, and the messages wait in the
+ * broker (or the files in the bucket) for the new table.
+ */
+export declare function replaceStreamSteps(obj: DeclaredObject, live: CanonicalObject, readers: readonly CanonicalObject[], marker: OwnershipMarker | undefined): Step[];
 //# sourceMappingURL=statements.d.ts.map

package/dist/clickhouse/apply/statements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statements.d.ts","sourceRoot":"","sources":["../../../src/clickhouse/apply/statements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE1F,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvD,+BAA+B;AAC/B,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAA2C,CAAC;AAEjF,6DAA6D;AAC7D,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MACA,CAAC;AAE7E,sCAAsC;AACtC,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAAkE,CAAC;AAE7G,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGhF;AAED,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,gGAAgG;IAChG,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,eAAe,CAAC;IAC3B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,yGAAyG;AACzG,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,IAAI,EAAE,gBAAgB,CAAC;IACvB,yBAAyB;IACzB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,6GAA6G;AAC7G,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAGjE;AA4BD,+CAA+C;AAC/C,eAAO,MAAM,WAAW,GAAI,KAAK,cAAc,KAAG,MAAoE,CAAC;AAYvH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAO,GAC7E,MAAM,CAwBR;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAKjG;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9F;AAED,0FAA0F;AAC1F,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,OAAgC,CAAC;AAEvE,8GAA8G;AAC9G,eAAO,MAAM,kBAAkB,GAAI,GAAG,MAAM,KAAG,OAAgC,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAa7F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,SAAY,GAAG,cAAc,CAejH;AA2KD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CAAO,GAAG,IAAI,EAAE,CAqBnJ;AAED,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAMxF;AAID;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,GAAG,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,GACtF;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjG;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,0EAA0E;IAC1E,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,iEAAiE;IACjE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC9C,iIAAiI;IACjI,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,CAAC;IACxC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yIAAyI;IACzI,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kHAAkH;IAClH,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAKD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CASvE;AAID,iGAAiG;AACjG,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAO3C,CAAC"}
+{"version":3,"file":"statements.d.ts","sourceRoot":"","sources":["../../../src/clickhouse/apply/statements.ts"],"names":[],"mappings":"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"}

package/dist/clickhouse/apply/statements.js

@@ -21,6 +21,7 @@ import { CLASSIFIER_RULES } from "../plan/rules.js";
 import { stampedComment } from "../ownership.js";
 import { CLICKHOUSE_ENTITY_TYPES } from "../entities.js";
 import { renderFor } from "../topology.js";
+import { readsTable } from "../plan/stream.js";
 import { accessClauseText, alterAccessField, alterQuotaOrProfileField, grantStatement, revokeStatement, SECRETLESS } from "../access.js";
 /** A backquoted identifier. */
 export const ident = (name) => `\`${name.replace(/`/g, "``")}\``;
@@ -488,6 +489,23 @@ function deferredDefaultRoles(declared, byObject, keyOf, environmentCreatesUsers
     }
     return out;
 }
+/**
+ * The statements that replace a stream table (#4396), in the order they run:
+ * detach each materialized view that reads it (`readers`, as the server has
+ * them), drop the table, create it as declared, attach the views. The table
+ * holds no rows, so nothing is copied; a view that stays detached for the
+ * length of the replacement reads nothing, and the messages wait in the
+ * broker (or the files in the bucket) for the new table.
+ */
+export function replaceStreamSteps(obj, live, readers, marker) {
+    const view = (r) => qualifiedIdent(r.database, r.name);
+    return [
+        ...readers.map((r) => stepFor(`DETACH TABLE ${view(r)}`, "SQLCH225")),
+        stepFor(`DROP TABLE ${qualifiedIdent(live.database, live.name)} SYNC`, "SQLCH225"),
+        stepFor(createStatement(obj, marker), "SQLCH225"),
+        ...readers.map((r) => stepFor(`ATTACH TABLE ${view(r)}`, "SQLCH225")),
+    ];
+}
 function planDeclared(input) {
     const keyOf = input.keyOf ?? ((o) => o.key);
     const byObject = new Map();
@@ -517,6 +535,12 @@ function planDeclared(input) {
         const renamedFrom = mine.find((c) => c.rule === "SQLCH230" || c.rule === "SQLCH231")?.before;
         const currentKey = renamedFrom !== undefined && input.current.has(renamedFrom) ? renamedFrom : key;
         const live = input.current.get(currentKey);
+        // A stream table (#4396): the views that read it are detached, it is dropped and created, and they are attached again.
+        if (live && mine.some((c) => c.rule === "SQLCH225")) {
+            const dropped = new Set(input.changes.filter((c) => c.rule === "SQLCH250").map((c) => c.object));
+            const readers = [...input.current].filter(([k, o]) => !dropped.has(k) && readsTable(o, live)).map(([, o]) => o);
+            return { verdict: "alter", obj, changes: mine, steps: replaceStreamSteps(obj, live, readers, input.marker) };
+        }
         // A function has no comment, so nothing to restamp: it never carries the marker.
         const restamp = obj.type !== CLICKHOUSE_ENTITY_TYPES.function && !stepsSetComment(obj, mine) && (mine.some((c) => c.field === "comment") || !(input.carriesMarker?.(currentKey) ?? true));
         const steps = [

package/dist/clickhouse/import/live-export.d.ts

@@ -23,12 +23,16 @@
  *   (#3745), so a use is found by that body (`./inlined.ts`) as well as by
  *   the name. A function carries no comment, so `owned` does
  *   not apply to it.
- * - An object of a kind no declaration holds (a window view, a quota, a
- *   settings profile, a named collection, ...; `../live/undeclarable.ts`)
- *   fails the import, which names every one of them (#3911).
+ * - An object of a kind no declaration holds (a window view, a workload,
+ *   an HTTP handler, ...; `../live/undeclarable.ts`) fails the import, which
+ *   names every one of them (#3911).
  *   `skipUndeclarable` (`--skip-undeclarable`) imports the rest and lists
  *   them as warnings. A selector or `owned` import asks for objects chant can
  *   hold, so it does not look.
+ * - A SQL-defined named collection is the environment's (#4395): the import
+ *   reads its name only, never its values, and lists it as a prerequisite
+ *   (a warning, and `metadata.prerequisites` with the imported objects that
+ *   name it) instead of refusing the server.
  */
 import type { ExportedTemplate, ResourceSelector } from "@intentius/chant/lexicon";
 import { type BindOptions } from "../live/bind.js";

package/dist/clickhouse/import/live-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-export.d.ts","sourceRoot":"","sources":["../../../src/clickhouse/import/live-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKlD,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAWjF;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,SAAS,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgBhL;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8HAA8H;IAC9H,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2CvF"}
+{"version":3,"file":"live-export.d.ts","sourceRoot":"","sources":["../../../src/clickhouse/import/live-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMlD,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAWjF;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,SAAS,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgBhL;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8HAA8H;IAC9H,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqDvF"}

package/dist/clickhouse/import/live-export.js

@@ -23,12 +23,16 @@
  *   (#3745), so a use is found by that body (`./inlined.ts`) as well as by
  *   the name. A function carries no comment, so `owned` does
  *   not apply to it.
- * - An object of a kind no declaration holds (a window view, a quota, a
- *   settings profile, a named collection, ...; `../live/undeclarable.ts`)
- *   fails the import, which names every one of them (#3911).
+ * - An object of a kind no declaration holds (a window view, a workload,
+ *   an HTTP handler, ...; `../live/undeclarable.ts`) fails the import, which
+ *   names every one of them (#3911).
  *   `skipUndeclarable` (`--skip-undeclarable`) imports the rest and lists
  *   them as warnings. A selector or `owned` import asks for objects chant can
  *   hold, so it does not look.
+ * - A SQL-defined named collection is the environment's (#4395): the import
+ *   reads its name only, never its values, and lists it as a prerequisite
+ *   (a warning, and `metadata.prerequisites` with the imported objects that
+ *   name it) instead of refusing the server.
  */
 import { bindClickHouse } from "../live/bind.js";
 import { readLiveSchema } from "../live/catalog.js";
@@ -38,8 +42,9 @@ import { CLICKHOUSE_ENTITY_TYPES } from "../entities.js";
 import { isTrivia, tokenizeText } from "../tokens.js";
 import { unquote } from "../parser.js";
 import { inlinedFunctions } from "./inlined.js";
-import { readUndeclarable } from "../live/undeclarable.js";
+import { readReferenced, readUndeclarable } from "../live/undeclarable.js";
 import { refuseUndeclarable } from "../../core/undeclarable.js";
+import { namedCollectionPrerequisites } from "../named-collections.js";
 /** The functions among `names` a statement calls: a name followed by `(`. */
 export function calledFunctions(ddl, names) {
     const tokens = tokenizeText(ddl, 0).filter((t) => !isTrivia(t));
@@ -127,5 +132,16 @@ export async function exportResources(options) {
         name: o.name,
         ddl: options.verbatim ? o.statement : stripServerDefaults(o.statement),
     }));
-    return objectsToIR(objects, warnings);
+    // Named collections are the environment's (#4395): listed as prerequisites, never imported.
+    const referenced = await readReferenced(target);
+    for (const u of referenced.unread)
+        warnings.push(`the server's named collections were not read, so the import cannot list them as prerequisites: ${u}`);
+    const { prerequisites, warnings: prereq } = namedCollectionPrerequisites(referenced.objects, objects, {
+        of: options.environment,
+        found: "the server holds it",
+        unseen: "the reader did not see it on the server (it needs SHOW NAMED COLLECTIONS)",
+    });
+    warnings.push(...prereq);
+    const ir = objectsToIR(objects, warnings);
+    return (prerequisites.length > 0 ? { ...ir, metadata: { ...ir.metadata, prerequisites } } : ir);
 }

package/dist/clickhouse/live/named-collections.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The plan's existence check for the named collections a build references
+ * (#4395): by name, in `system.named_collections`, never the `collection`
+ * or `create_query` columns, which hold the values.
+ *
+ * Checked against the pinned server (26.8.15.10): the table's columns are
+ * `name`, `collection` (a `Map(String, String)`), `source` (`SQL` or
+ * `Config`) and `create_query`. A user with `SHOW NAMED COLLECTIONS` and
+ * without `SHOW NAMED COLLECTIONS SECRETS` sees every key, with each value as
+ * `'[HIDDEN]'`, so keys could be compared without the secrets grant. A user
+ * without `SHOW NAMED COLLECTIONS` reads the table without an error and sees
+ * no rows; a collection that user cannot see is reported missing, with the
+ * grant named.
+ */
+import { type ClickHouseEndpoint } from "../http.js";
+import type { NamedCollectionCheck } from "../plan/diff.js";
+/** The named collections a build output references (its document's `namedCollections`). */
+export declare function referencedCollections(buildJson: string): string[];
+/** {@link referencedCollections} of a build output file. */
+export declare const referencedCollectionsOf: (buildFile: string) => string[];
+/** Which of `names` the server has, by name. Undefined when nothing is referenced. */
+export declare function checkNamedCollections(endpoint: ClickHouseEndpoint, names: readonly string[]): Promise<NamedCollectionCheck | undefined>;
+/** Whether the check fails the plan. */
+export declare const namedCollectionsFail: (c: NamedCollectionCheck | undefined) => boolean;
+/** The report's lines for a failed check; none when it passed. */
+export declare function renderNamedCollections(c: NamedCollectionCheck | undefined): string[];
+//# sourceMappingURL=named-collections.d.ts.map

package/dist/clickhouse/live/named-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-collections.d.ts","sourceRoot":"","sources":["../../../src/clickhouse/live/named-collections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAGjE;AAED,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB,GAAI,WAAW,MAAM,KAAG,MAAM,EAA6D,CAAC;AAEhI,sFAAsF;AACtF,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAa7I;AAED,wCAAwC;AACxC,eAAO,MAAM,oBAAoB,GAAI,GAAG,oBAAoB,GAAG,SAAS,KAAG,OAAkD,CAAC;AAE9H,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,EAAE,CAUpF"}

package/dist/clickhouse/live/named-collections.js

@@ -0,0 +1,53 @@
+/**
+ * The plan's existence check for the named collections a build references
+ * (#4395): by name, in `system.named_collections`, never the `collection`
+ * or `create_query` columns, which hold the values.
+ *
+ * Checked against the pinned server (26.8.15.10): the table's columns are
+ * `name`, `collection` (a `Map(String, String)`), `source` (`SQL` or
+ * `Config`) and `create_query`. A user with `SHOW NAMED COLLECTIONS` and
+ * without `SHOW NAMED COLLECTIONS SECRETS` sees every key, with each value as
+ * `'[HIDDEN]'`, so keys could be compared without the secrets grant. A user
+ * without `SHOW NAMED COLLECTIONS` reads the table without an error and sees
+ * no rows; a collection that user cannot see is reported missing, with the
+ * grant named.
+ */
+import { readFileSync } from "node:fs";
+import { clickhouseQuery } from "../http.js";
+const quote = (s) => `'${s.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+/** The named collections a build output references (its document's `namedCollections`). */
+export function referencedCollections(buildJson) {
+    const doc = JSON.parse(buildJson);
+    return Array.isArray(doc.namedCollections) ? doc.namedCollections.filter((n) => typeof n === "string") : [];
+}
+/** {@link referencedCollections} of a build output file. */
+export const referencedCollectionsOf = (buildFile) => referencedCollections(readFileSync(buildFile, "utf-8"));
+/** Which of `names` the server has, by name. Undefined when nothing is referenced. */
+export async function checkNamedCollections(endpoint, names) {
+    if (names.length === 0)
+        return undefined;
+    const referenced = [...new Set(names)].sort();
+    try {
+        const rows = await clickhouseQuery(endpoint, `/* chant plan: named collections */ SELECT name FROM system.named_collections WHERE name IN (${referenced.map(quote).join(", ")})`);
+        const have = new Set(rows.map((r) => r.name));
+        return { referenced, missing: referenced.filter((n) => !have.has(n)) };
+    }
+    catch (err) {
+        return { referenced, missing: referenced, unread: err instanceof Error ? err.message.split("\n")[0] : String(err) };
+    }
+}
+/** Whether the check fails the plan. */
+export const namedCollectionsFail = (c) => c !== undefined && c.missing.length > 0;
+/** The report's lines for a failed check; none when it passed. */
+export function renderNamedCollections(c) {
+    if (!c || c.missing.length === 0)
+        return [];
+    if (c.unread !== undefined) {
+        return ["", `Refused: the build references named collection(s) ${c.missing.join(", ")}, and the server's could not be read to check them: ${c.unread}`];
+    }
+    return [
+        "",
+        `Refused: the build references ${c.missing.length === 1 ? "a named collection" : "named collections"} the server does not have: ${c.missing.join(", ")}. ` +
+            "Create each on the server (chant never declares one), or grant the plan's user SHOW NAMED COLLECTIONS if it is there and hidden from that user.",
+    ];
+}

package/dist/clickhouse/live/undeclarable.d.ts

@@ -3,9 +3,11 @@
  * (#3911), found so import can refuse them by name instead of leaving them
  * out (`../../core/undeclarable.ts`).
  *
- * One `system.*` query per kind the coverage table marks refused
- * (`../../coverage/clickhouse.json`), keyed by the row's `kind`. A kind whose
- * row is flipped to declared is no longer asked about.
+ * One `system.*` query per kind the coverage table marks refused or
+ * referenced (`../../coverage/clickhouse.json`), keyed by the row's `kind`. A
+ * kind whose row is flipped to declared is no longer asked about. A
+ * referenced kind (a named collection, #4395) is read by name only, as a
+ * prerequisite the import lists, never as a refusal.
  *
  * What the server's configuration files define (`storage = 'users_xml'`, a
  * named collection whose source is the config, an executable function) is
@@ -28,5 +30,15 @@ export declare function readUndeclarable(target: ClickHouseTarget): Promise<{
     objects: UndeclarableObject[];
     unread: string[];
 }>;
+/**
+ * Every object of a kind the coverage table marks referenced (#4395): the
+ * server's SQL-defined named collections, by name. Their values are never
+ * read. A reader without `SHOW NAMED COLLECTIONS` sees none, and the server
+ * says nothing about that, so an empty list is not proof there are none.
+ */
+export declare function readReferenced(target: ClickHouseTarget): Promise<{
+    objects: UndeclarableObject[];
+    unread: string[];
+}>;
 export {};
 //# sourceMappingURL=undeclarable.d.ts.map

package/dist/clickhouse/live/undeclarable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"undeclarable.d.ts","sourceRoot":"","sources":["../../../src/clickhouse/live/undeclarable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,+HAA+H;AAC/H,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC;AAK3D,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAU7D,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiB7H"}
+{"version":3,"file":"undeclarable.d.ts","sourceRoot":"","sources":["../../../src/clickhouse/live/undeclarable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,+HAA+H;AAC/H,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC;AAK3D,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAU7D,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAE7H;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAE3H"}

package/dist/clickhouse/live/undeclarable.js

@@ -3,9 +3,11 @@
  * (#3911), found so import can refuse them by name instead of leaving them
  * out (`../../core/undeclarable.ts`).
  *
- * One `system.*` query per kind the coverage table marks refused
- * (`../../coverage/clickhouse.json`), keyed by the row's `kind`. A kind whose
- * row is flipped to declared is no longer asked about.
+ * One `system.*` query per kind the coverage table marks refused or
+ * referenced (`../../coverage/clickhouse.json`), keyed by the row's `kind`. A
+ * kind whose row is flipped to declared is no longer asked about. A
+ * referenced kind (a named collection, #4395) is read by name only, as a
+ * prerequisite the import lists, never as a refusal.
  *
  * What the server's configuration files define (`storage = 'users_xml'`, a
  * named collection whose source is the config, an executable function) is
@@ -37,11 +39,23 @@ export const CLICKHOUSE_PROBES = {
  * pass.
  */
 export async function readUndeclarable(target) {
+    return readKinds(target, "refused");
+}
+/**
+ * Every object of a kind the coverage table marks referenced (#4395): the
+ * server's SQL-defined named collections, by name. Their values are never
+ * read. A reader without `SHOW NAMED COLLECTIONS` sees none, and the server
+ * says nothing about that, so an empty list is not proof there are none.
+ */
+export async function readReferenced(target) {
+    return readKinds(target, "referenced");
+}
+async function readKinds(target, status) {
     const scope = (column) => target.databases ? `${column} IN (${target.databases.map(quote).join(", ")})` : `${column} NOT IN (${[...SYSTEM_DATABASES].map(quote).join(", ")})`;
     const objects = [];
     const unread = [];
     for (const row of KIND_COVERAGE.clickhouse) {
-        if (row.status !== "refused")
+        if (row.status !== status)
             continue;
         const probe = CLICKHOUSE_PROBES[row.kind];
         if (!probe)

package/dist/clickhouse/named-collections.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Named collections, referenced by name (#4395).
+ *
+ * A named collection holds an integration's connection settings and its
+ * credentials. Those are the environment's, so chant never declares one and
+ * never reads its values (the coverage table's `referenced` status,
+ * `../coverage/clickhouse.json`). A declaration may name one where the server
+ * takes a collection in place of inline arguments:
+ *
+ * - an integration engine's first argument: `ENGINE = S3(lake_creds, format = 'Parquet')`,
+ *   `ENGINE = Kafka(kafka_creds)`, a database's `ENGINE = PostgreSQL(pg_creds)`;
+ * - a table function's first argument: `AS s3(lake_creds)`, `SELECT ... FROM mysql(mysql_creds, table = 't')`;
+ * - a dictionary source's `NAME`: `SOURCE(MYSQL(NAME mysql_creds))`.
+ *
+ * The build records each reference (`namedCollections` on the object and on
+ * the document, `../serializer.ts`), and `chant sql plan` checks that every
+ * one exists on the server by name (`./plan/commands.ts`).
+ */
+/** The engines a named collection may be the first argument of. */
+export declare const COLLECTION_ENGINES: ReadonlySet<string>;
+/**
+ * The table functions a named collection may be the first argument of, lower
+ * case. A `...Cluster` function's first argument is the cluster, so those are
+ * left out.
+ */
+export declare const COLLECTION_FUNCTIONS: ReadonlySet<string>;
+/** The collection an engine names in its first argument, when it is one of the engines that take one. */
+export declare function engineCollection(engine: {
+    name: string;
+    args?: readonly string[];
+} | undefined): string | undefined;
+/** The collections a SQL text's table function calls name: `s3(lake_creds, ...)`, `mysql(mysql_creds)`. */
+export declare function functionCollections(text: string): string[];
+/** The collection a dictionary source names: `MYSQL(NAME mysql_creds)`. */
+export declare function sourceCollections(dataSource: string): string[];
+/** What a declaration's props hold that can name a collection. */
+export interface CollectionReferrer {
+    engine?: {
+        name: string;
+        args?: readonly string[];
+    };
+    asFunction?: string;
+    select?: string;
+    dataSource?: string;
+}
+/** Every named collection an object names, once each, in the order written. */
+export declare function namedCollectionReferences(o: CollectionReferrer): string[];
+/** `CREATE NAMED COLLECTION [IF NOT EXISTS] name ...`: the name, or undefined for another statement. */
+export declare function createdCollectionName(sql: string): string | undefined;
+/**
+ * The collections a whole statement names, read off its tokens: what
+ * {@link namedCollectionReferences} reads from a parsed declaration, for a
+ * statement import has only as text (`SHOW CREATE`).
+ */
+export declare function statementCollections(ddl: string): string[];
+/** One environment prerequisite an import found: a named collection (#4395). */
+export interface Prerequisite {
+    kind: "named collection";
+    name: string;
+    /** The imported objects that name it, `database.name`. */
+    referencedBy: string[];
+}
+/**
+ * The named collections an import found as prerequisites (#4395), each with
+ * the imported objects that name it, and a warning for each. A collection an
+ * imported object names that was not found is listed too: a live reader
+ * without `SHOW NAMED COLLECTIONS` sees none.
+ */
+export declare function namedCollectionPrerequisites(found: ReadonlyArray<{
+    name: string;
+}>, objects: ReadonlyArray<{
+    database?: string;
+    name: string;
+    ddl: string;
+}>, wording: {
+    of?: string;
+    found: string;
+    unseen: string;
+}): {
+    prerequisites: Prerequisite[];
+    warnings: string[];
+};
+//# sourceMappingURL=named-collections.d.ts.map

package/dist/clickhouse/named-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-collections.d.ts","sourceRoot":"","sources":["../../src/clickhouse/named-collections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0CH,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAgE,CAAC;AAEpH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAIpD,CAAC;AAUF,yGAAyG;AACzG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGnH;AAUD,2GAA2G;AAC3G,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1D;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAU9D;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAQzE;AAED,wGAAwG;AACxG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B1D;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACtC,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EACxE,OAAO,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,aAAa,EAAE,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBvD"}