@adminiumjs/manifest 0.3.48 → 0.3.49

package/dist/table-names.d.ts

@@ -0,0 +1,82 @@
+/**
+ * A TABLE'S REAL NAME, AND THE SCHEMA IT LIVES IN.
+ *
+ * A table's `ref` is the app's own short name for it, lower snake_case. Its
+ * real name is the ref, or `<prefix><ref>` for a prefixed app. A self-made app
+ * (`publisher: local`) is saved from tables a person made by hand, so it may
+ * give a table its real `name` beside the ref (`Order Lines`), and on Postgres
+ * the `schema` it is in (`sales`).
+ *
+ * Everywhere the server speaks of a real table it uses one string: the bare
+ * name, or `<schema>.<name>` when the manifest names a schema — the id the
+ * engine's snapshot gives the table, so a page bound to it finds it. Neither
+ * part may hold a dot, which is what keeps that string read one way only.
+ */
+/** The longest table or schema name, in bytes: Postgres cuts anything longer short. */
+export declare const TABLE_NAME_MAX_BYTES = 63;
+/** What is wrong with a table's real name, or null. */
+export declare function tableNameIssue(name: string): string | null;
+/** What is wrong with a column's own name, or null: the same rules as a table's. */
+export declare function columnNameIssue(name: string): string | null;
+/**
+ * The schemas a Supabase project keeps for its own services: sign-in
+ * (`auth`), files, realtime, the GraphQL layer, secrets, extensions, edge
+ * functions, its migrations, HTTP calls and scheduled jobs. A table an app
+ * names in one of them would be the platform's (`auth.users`), never the
+ * app's, so "use the existing tables" must not take one over.
+ */
+export declare const SUPABASE_SCHEMAS: readonly string[];
+/**
+ * What is wrong with a table's schema, or null: the database's own schemas
+ * (`pg_catalog`, `information_schema`, `pg_toast`, any temporary one —
+ * Postgres keeps every `pg_` name for itself), Supabase's own and Adminium's
+ * are never an app's. Which engine may have a schema at all is the planner's
+ * to say.
+ */
+export declare function tableSchemaIssue(schema: string): string | null;
+/** `<schema>.<name>`, or the bare name without a schema. */
+export declare function qualifyTableName(schema: string | null | undefined, name: string): string;
+/** A real table string read back into its schema (null without one) and its name. */
+export declare function splitTableName(real: string): {
+    schema: string | null;
+    name: string;
+};
+/**
+ * The real table a declared table is made under: its own name (in its
+ * schema), else the prefixed or plain ref. A table that gives either is never
+ * prefixed: the manifest refuses the two together.
+ */
+export declare function realTableName(table: {
+    ref: string;
+    name?: string | undefined;
+    schema?: string | undefined;
+}, prefix: string | null): string;
+/** Whether a declared table gives its own real name or schema. */
+export declare function namesItsTable(table: {
+    name?: string | undefined;
+    schema?: string | undefined;
+}): boolean;
+/**
+ * The schema a table is in when none is named: Postgres's `public`. Postgres
+ * is the only engine an app's table names a schema on (MySQL's and SQLite's
+ * are refused by the planner), so a file that names it says nothing more than
+ * a file that does not.
+ */
+export declare const DEFAULT_TABLE_SCHEMA = "public";
+/**
+ * A manifest with `schema: "public"` taken off each table, as it is read in:
+ * the default schema named or not is one table, never two identities of it.
+ * The table keeps its real name (its `name`, else its ref), so naming the
+ * schema still keeps the table off the app's prefix. Unchanged when no table
+ * names it.
+ */
+export declare function withoutDefaultSchema<M extends {
+    requiredSchema?: {
+        tables?: readonly {
+            ref: string;
+            name?: string | undefined;
+            schema?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+}>(manifest: M): M;
+//# sourceMappingURL=table-names.d.ts.map

package/dist/table-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-names.d.ts","sourceRoot":"","sources":["../src/table-names.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAEH,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAqBvC,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAiB7C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9D;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGpF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAG3I;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,OAAO,CAExG;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,SAAS;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,EAAE,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAA;CAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAc3M"}

package/dist/table-names.js

@@ -0,0 +1,145 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * A TABLE'S REAL NAME, AND THE SCHEMA IT LIVES IN.
+ *
+ * A table's `ref` is the app's own short name for it, lower snake_case. Its
+ * real name is the ref, or `<prefix><ref>` for a prefixed app. A self-made app
+ * (`publisher: local`) is saved from tables a person made by hand, so it may
+ * give a table its real `name` beside the ref (`Order Lines`), and on Postgres
+ * the `schema` it is in (`sales`).
+ *
+ * Everywhere the server speaks of a real table it uses one string: the bare
+ * name, or `<schema>.<name>` when the manifest names a schema — the id the
+ * engine's snapshot gives the table, so a page bound to it finds it. Neither
+ * part may hold a dot, which is what keeps that string read one way only.
+ */
+/** The longest table or schema name, in bytes: Postgres cuts anything longer short. */
+export const TABLE_NAME_MAX_BYTES = 63;
+/** Adminium's own namespace: no table or schema of an app is named into it. */
+const RESERVED_PREFIX = 'adminium_';
+function byteLength(text) {
+    return new TextEncoder().encode(text).length;
+}
+/** What is wrong with a name shared by tables and schemas, or null. */
+function identifierIssue(what, name) {
+    if (name.length === 0 || byteLength(name) > TABLE_NAME_MAX_BYTES)
+        return `a ${what} name is 1 to ${String(TABLE_NAME_MAX_BYTES)} bytes`;
+    if (name.includes('\u0000'))
+        return `a ${what} name holds no NUL character`;
+    if (name.trim() !== name)
+        return `a ${what} name neither starts nor ends with a space`;
+    // A dot would read as `<schema>.<name>`, and " as " as an alias, wherever a table is named by one string.
+    if (name.includes('.'))
+        return `a ${what} name holds no dot`;
+    if (/ as /i.test(name))
+        return `a ${what} name holds no " as " between words`;
+    if (name.toLowerCase().startsWith(RESERVED_PREFIX))
+        return `"${name}" is in Adminium's own namespace ("${RESERVED_PREFIX}")`;
+    return null;
+}
+/** What is wrong with a table's real name, or null. */
+export function tableNameIssue(name) {
+    return identifierIssue('table', name);
+}
+/** What is wrong with a column's own name, or null: the same rules as a table's. */
+export function columnNameIssue(name) {
+    return identifierIssue('column', name);
+}
+/**
+ * The schemas a Supabase project keeps for its own services: sign-in
+ * (`auth`), files, realtime, the GraphQL layer, secrets, extensions, edge
+ * functions, its migrations, HTTP calls and scheduled jobs. A table an app
+ * names in one of them would be the platform's (`auth.users`), never the
+ * app's, so "use the existing tables" must not take one over.
+ */
+export const SUPABASE_SCHEMAS = [
+    'auth',
+    'storage',
+    'realtime',
+    '_realtime',
+    'graphql',
+    'graphql_public',
+    'vault',
+    'pgsodium',
+    'pgsodium_masks',
+    'extensions',
+    'supabase_functions',
+    'supabase_migrations',
+    'net',
+    'cron',
+    'pgbouncer',
+    '_analytics',
+];
+/**
+ * What is wrong with a table's schema, or null: the database's own schemas
+ * (`pg_catalog`, `information_schema`, `pg_toast`, any temporary one —
+ * Postgres keeps every `pg_` name for itself), Supabase's own and Adminium's
+ * are never an app's. Which engine may have a schema at all is the planner's
+ * to say.
+ */
+export function tableSchemaIssue(schema) {
+    const issue = identifierIssue('schema', schema);
+    if (issue !== null)
+        return issue;
+    const lower = schema.toLowerCase();
+    if (lower === 'information_schema' || lower.startsWith('pg_'))
+        return `"${schema}" is the database's own schema`;
+    if (SUPABASE_SCHEMAS.includes(lower) || lower.startsWith('supabase_'))
+        return `"${schema}" is a schema Supabase keeps for its own services`;
+    return null;
+}
+/** `<schema>.<name>`, or the bare name without a schema. */
+export function qualifyTableName(schema, name) {
+    return schema === null || schema === undefined ? name : `${schema}.${name}`;
+}
+/** A real table string read back into its schema (null without one) and its name. */
+export function splitTableName(real) {
+    const dot = real.indexOf('.');
+    return dot < 0 ? { schema: null, name: real } : { schema: real.slice(0, dot), name: real.slice(dot + 1) };
+}
+/**
+ * The real table a declared table is made under: its own name (in its
+ * schema), else the prefixed or plain ref. A table that gives either is never
+ * prefixed: the manifest refuses the two together.
+ */
+export function realTableName(table, prefix) {
+    if (table.name !== undefined || table.schema !== undefined)
+        return qualifyTableName(table.schema, table.name ?? table.ref);
+    return prefix === null ? table.ref : `${prefix}${table.ref}`;
+}
+/** Whether a declared table gives its own real name or schema. */
+export function namesItsTable(table) {
+    return table.name !== undefined || table.schema !== undefined;
+}
+/**
+ * The schema a table is in when none is named: Postgres's `public`. Postgres
+ * is the only engine an app's table names a schema on (MySQL's and SQLite's
+ * are refused by the planner), so a file that names it says nothing more than
+ * a file that does not.
+ */
+export const DEFAULT_TABLE_SCHEMA = 'public';
+/**
+ * A manifest with `schema: "public"` taken off each table, as it is read in:
+ * the default schema named or not is one table, never two identities of it.
+ * The table keeps its real name (its `name`, else its ref), so naming the
+ * schema still keeps the table off the app's prefix. Unchanged when no table
+ * names it.
+ */
+export function withoutDefaultSchema(manifest) {
+    const tables = manifest.requiredSchema?.tables;
+    if (tables === undefined || !tables.some((table) => table.schema === DEFAULT_TABLE_SCHEMA))
+        return manifest;
+    return {
+        ...manifest,
+        requiredSchema: {
+            ...manifest.requiredSchema,
+            tables: tables.map((table) => {
+                if (table.schema !== DEFAULT_TABLE_SCHEMA)
+                    return table;
+                const { schema: _schema, ...rest } = table;
+                return { ...rest, name: table.name ?? table.ref };
+            }),
+        },
+    };
+}
+//# sourceMappingURL=table-names.js.map

package/dist/table-names.js.map

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

package/dist/words.d.ts

@@ -14,7 +14,7 @@ export declare const ADD_ON_INSTALL_BLOCKS: readonly ["pages", "roles", "optionL
  * runs the word, or it refuses a manifest that uses it — and its tests read
  * this list to see that none is left without one.
  */
-export declare const INSTALL_FLOOR_WORD_NAMES: readonly ["pages", "roles", "optionLists", "emailTemplates", "outbox", "documents", "sampleData", "publicAccess", "publicKeys", "navGroups", "seeds", "automations", "addOns", "requiredSchema.prefixed", "addOn.settingsTable", "addOn.ledgers", "addOn.adjuster", "addOn.words", "addOn.recordTabs", "addOn.hostApi.2", "addOn.lookUp", "ledger.decides", "table.indexes", "table.postings", "table.adjust", "states.actions", "states.planned", "column.addOnLink", "column.addOnLink.default", "column.tableRef", "column.announce", "column.plainText", "column.customerKey", "column.codeLast4", "code.givenByLedger", "rollup.capUnless", "rollup.latest", "roles.tables", "roles.writableFrom", "toolbar.links", "config.tabs", "config.bulk", "sampleData.addOns", "sampleData.people", "app.seeds", "table.occupies", "sequence.sample", "email.onlyWith", "email.onlyWithout", "outbox.pages.app", "rows.pair", "unlockBy.self", "availability.words", "addOn.steps", "addOn.assistant", "automations.addOnStep", "email.showWhen", "placeholder.backup", "frontend.mobile", "column.staff", "table.belongs", "table.private", "belongs.throughPrivate", "shape.create", "table.appGrants", "roles.rows", "rows.several", "listing.while", "states.handOver", "app.modules", "roles.names", "app.maps", "automations.staffRecipient", "automations.perSpell", "automations.urgent", "automations.digest", "digest.reach", "digest.sum", "digest.by", "digest.target", "digest.within", "automations.stepName", "automations.many", "automations.replyTo", "automations.lead", "automations.leadAlone", "automations.listed", "automations.staffName", "automations.recordUrl", "automations.was", "automations.settingAmount", "automations.settingValue", "automations.daysAfter", "automations.settingElse", "outbox.replyTo", "outbox.onDelete", "column.mentions", "column.place", "column.area", "column.linkable", "linkable.same", "column.file", "config.board", "board.toolbar", "board.secondAmount", "board.daysLabel", "states.notPast", "states.moveOnCreate", "publicAccess.requiresWhen", "frontend.records", "nav.offRail", "navLinks", "outbox.staffName", "card.module", "card.columnLabels", "link.staffPath", "column.changes", "rows.notBy", "rows.via", "rows.notThrough", "states.carries", "table.removal", "column.history", "bounds.other", "bounds.now", "stamp.strict", "requiredWhen.stamp", "outbox.classes", "automations.emailClass", "people", "table.keep", "publicAccess.consent", "automations.more", "addOn.forms", "publicAccess.forms", "outbox.purposes", "outbox.surveyLinks", "publicAccess.forms.source", "step.person", "step.recordBy", "step.recordWhere", "step.help", "step.recordTokens", "publicAccess.appColumn", "people.addOnCopies", "table.expire", "column.band", "stamp.addWorkingDays", "formula.ceilFloor", "table.check", "addOn.checker", "addOn.panels", "publicAccess.uploads", "file.upload", "file.tiff", "file.large", "file.assetKinds", "publicAccess.assets", "publicAccess.ownLink", "publicAccess.sessionRead", "people.copyDetails", "publicAccess.ownDelete", "roles.addOnPages", "agrees.length", "people.addOnCopyFrom", "email.rowPicture", "roles.addOnActions", "appGrants.more", "roles.privacyPeople", "config.columns"];
+export declare const INSTALL_FLOOR_WORD_NAMES: readonly ["pages", "roles", "optionLists", "emailTemplates", "outbox", "documents", "sampleData", "publicAccess", "publicKeys", "navGroups", "seeds", "automations", "addOns", "requiredSchema.prefixed", "addOn.settingsTable", "addOn.ledgers", "addOn.adjuster", "addOn.words", "addOn.recordTabs", "addOn.hostApi.2", "addOn.lookUp", "ledger.decides", "table.indexes", "table.postings", "table.adjust", "states.actions", "states.planned", "column.addOnLink", "column.addOnLink.default", "column.tableRef", "column.announce", "column.plainText", "column.customerKey", "column.codeLast4", "code.givenByLedger", "rollup.capUnless", "rollup.latest", "roles.tables", "roles.writableFrom", "toolbar.links", "config.tabs", "config.bulk", "sampleData.addOns", "sampleData.people", "app.seeds", "table.occupies", "sequence.sample", "email.onlyWith", "email.onlyWithout", "outbox.pages.app", "rows.pair", "unlockBy.self", "availability.words", "addOn.steps", "addOn.assistant", "automations.addOnStep", "email.showWhen", "placeholder.backup", "frontend.mobile", "column.staff", "table.belongs", "table.private", "belongs.throughPrivate", "shape.create", "table.appGrants", "roles.rows", "rows.several", "listing.while", "states.handOver", "app.modules", "roles.names", "app.maps", "automations.staffRecipient", "automations.perSpell", "automations.urgent", "automations.digest", "digest.reach", "digest.sum", "digest.by", "digest.target", "digest.within", "automations.stepName", "automations.many", "automations.replyTo", "automations.lead", "automations.leadAlone", "automations.listed", "automations.staffName", "automations.recordUrl", "automations.was", "automations.settingAmount", "automations.settingValue", "automations.daysAfter", "automations.settingElse", "outbox.replyTo", "outbox.onDelete", "column.mentions", "column.place", "column.area", "column.linkable", "linkable.same", "column.file", "config.board", "board.toolbar", "board.secondAmount", "board.daysLabel", "states.notPast", "states.moveOnCreate", "publicAccess.requiresWhen", "frontend.records", "nav.offRail", "navLinks", "outbox.staffName", "card.module", "card.columnLabels", "link.staffPath", "column.changes", "rows.notBy", "rows.via", "rows.notThrough", "states.carries", "table.removal", "column.history", "bounds.other", "bounds.now", "stamp.strict", "requiredWhen.stamp", "outbox.classes", "automations.emailClass", "people", "table.keep", "publicAccess.consent", "automations.more", "addOn.forms", "publicAccess.forms", "outbox.purposes", "outbox.surveyLinks", "publicAccess.forms.source", "step.person", "step.recordBy", "step.recordWhere", "step.help", "step.recordTokens", "publicAccess.appColumn", "people.addOnCopies", "table.expire", "column.band", "stamp.addWorkingDays", "formula.ceilFloor", "table.check", "addOn.checker", "addOn.panels", "publicAccess.uploads", "file.upload", "file.tiff", "file.large", "file.assetKinds", "publicAccess.assets", "publicAccess.ownLink", "publicAccess.sessionRead", "people.copyDetails", "publicAccess.ownDelete", "roles.addOnPages", "agrees.length", "people.addOnCopyFrom", "email.rowPicture", "roles.addOnActions", "appGrants.more", "roles.privacyPeople", "config.columns", "addOn.scope", "frontend.instances", "page.envelope", "page.views", "app.provenance", "app.icon", "apps.requires", "instance", "column.time", "column.precision", "column.hidden", "column.yesNo", "column.name", "relation.label", "relation.remove", "relation.noConstraint", "table.exclude", "table.existingCustomers", "table.switchedOff", "table.name", "table.schema", "optionList.description", "email.kind", "email.category", "email.brand", "email.attachments", "automations.webhook", "automations.documentRender", "automations.fixedAddress", "automations.purpose", "automations.watch", "documents.options", "documents.trigger", "documents.deliver", "reports", "invoiceLayouts", "scheduledReports", "payments", "publicAccess.put", "publicAccess.delete", "publicAccess.batch", "publicAccess.path", "publicAccess.pagination", "publicAccess.rateLimit", "publicAccess.response"];
 export type ManifestWordName = (typeof INSTALL_FLOOR_WORD_NAMES)[number];
 /**
  * The words that came after the install floor, each with the first Adminium

package/dist/words.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../src/words.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,IAAI,EAAE,gBAAgB,CAAC;IACvB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,2HAA2H;AAC3H,eAAO,MAAM,6BAA6B,QAAmB,CAAC;AAE9D,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,gLAcxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,qnGAkM3B,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAyN3E,CAAC;AAYF,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,EAAE,CAiZnE"}
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../src/words.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,IAAI,EAAE,gBAAgB,CAAC;IACvB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,2HAA2H;AAC3H,eAAO,MAAM,6BAA6B,QAAmB,CAAC;AAE9D,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,gLAcxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,+9HAgQ3B,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CA2Q3E,CAAC;AAYF,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,EAAE,CAidnE"}

package/dist/words.js

@@ -234,6 +234,68 @@ export const INSTALL_FLOOR_WORD_NAMES = [
     'roles.privacyPeople',
     // The columns a records page's list opens on, in order (`config.columns`).
     'config.columns',
+    // An add-on kept once per server rather than installed per database.
+    'addOn.scope',
+    // A side that serves every install of its app (it sends the install it is).
+    'frontend.instances',
+    // A self-made app's page as a person arranged it, its shared views, and where the file was saved.
+    'page.envelope',
+    'page.views',
+    'app.provenance',
+    // A self-made app's icon.
+    'app.icon',
+    // The other apps a self-made app needs on its database, and its part that is the whole deployment's.
+    'apps.requires',
+    'instance',
+    // A time of day, a decimal's places in all, a column kept off forms, an int read as a yes or a no.
+    'column.time',
+    'column.precision',
+    'column.hidden',
+    'column.yesNo',
+    // A self-made app's column under the name it has in its own database (`orderDate`), not snake_case.
+    'column.name',
+    // A link's own name, a link Adminium does not show, a link no foreign key keeps.
+    'relation.label',
+    'relation.remove',
+    'relation.noConstraint',
+    // A table left out of Adminium, a people table whose existing customers were mailed, a posting kept switched off.
+    'table.exclude',
+    'table.existingCustomers',
+    'table.switchedOff',
+    // A self-made app's table under the real name a person gave it, and in its own Postgres schema.
+    'table.name',
+    'table.schema',
+    // An answer's line under it.
+    'optionList.description',
+    // A mail's kind, what it is for, its own brand, and the package's files it carries.
+    'email.kind',
+    'email.category',
+    'email.brand',
+    'email.attachments',
+    // A rule's call to a web address, its drawing of a document, its mail to addresses the owner types, a marketing
+    // mail's purpose, and a record rule that also notices rows written around Adminium.
+    'automations.webhook',
+    'automations.documentRender',
+    'automations.fixedAddress',
+    'automations.purpose',
+    'automations.watch',
+    // A document's own options, the change that draws it, and where it goes once drawn.
+    'documents.options',
+    'documents.trigger',
+    'documents.deliver',
+    // What only a file made on an Adminium carries: its report documents, invoice layouts, scheduled reports and payments.
+    'reports',
+    'invoiceLayouts',
+    'scheduledReports',
+    'payments',
+    // A public entry of such a file: a row replaced, removed or written many at a time, and its own address, pages, rate and reply.
+    'publicAccess.put',
+    'publicAccess.delete',
+    'publicAccess.batch',
+    'publicAccess.path',
+    'publicAccess.pagination',
+    'publicAccess.rateLimit',
+    'publicAccess.response',
 ];
 /**
  * The words that came after the install floor, each with the first Adminium
@@ -458,6 +520,56 @@ export const WORD_FLOORS = {
     'roles.privacyPeople': '0.3.47',
     // A release before ignores the key, and the list opens on the columns Adminium picks.
     'config.columns': '0.3.47',
+    'addOn.scope': '0.3.49',
+    'frontend.instances': '0.3.49',
+    // What a file saved from a dashboard carries, and the fields its tables and mails need: a release before refuses each key.
+    'page.envelope': '0.3.49',
+    'page.views': '0.3.49',
+    'app.provenance': '0.3.49',
+    'app.icon': '0.3.49',
+    'apps.requires': '0.3.49',
+    'instance': '0.3.49',
+    'column.time': '0.3.49',
+    'column.precision': '0.3.49',
+    'column.hidden': '0.3.49',
+    'column.yesNo': '0.3.49',
+    'column.name': '0.3.49',
+    'relation.label': '0.3.49',
+    'relation.remove': '0.3.49',
+    'relation.noConstraint': '0.3.49',
+    'table.exclude': '0.3.49',
+    'table.existingCustomers': '0.3.49',
+    'table.switchedOff': '0.3.49',
+    'table.name': '0.3.49',
+    'table.schema': '0.3.49',
+    'optionList.description': '0.3.49',
+    'email.kind': '0.3.49',
+    'email.category': '0.3.49',
+    'email.brand': '0.3.49',
+    'email.attachments': '0.3.49',
+    // A rule's webhook, document, typed addresses, purpose and watch: a release before refuses the keys.
+    'automations.webhook': '0.3.49',
+    'automations.documentRender': '0.3.49',
+    'automations.fixedAddress': '0.3.49',
+    'automations.purpose': '0.3.49',
+    'automations.watch': '0.3.49',
+    // A document's options, trigger and delivery: a release before refuses the keys.
+    'documents.options': '0.3.49',
+    'documents.trigger': '0.3.49',
+    'documents.deliver': '0.3.49',
+    // A file's reports, invoice layouts, scheduled reports and payments: a release before refuses the blocks.
+    'reports': '0.3.49',
+    'invoiceLayouts': '0.3.49',
+    'scheduledReports': '0.3.49',
+    'payments': '0.3.49',
+    // A public entry's wider methods and its own address, pages, rate and reply: a release before refuses them.
+    'publicAccess.put': '0.3.49',
+    'publicAccess.delete': '0.3.49',
+    'publicAccess.batch': '0.3.49',
+    'publicAccess.path': '0.3.49',
+    'publicAccess.pagination': '0.3.49',
+    'publicAccess.rateLimit': '0.3.49',
+    'publicAccess.response': '0.3.49',
 };
 /** The kinds of file a column takes from the release that cleans SVG and reads models and fonts whole (`ASSET_FILE_KINDS`). */
 const ASSET_KINDS = new Set(['svg', 'glb', 'stl', '3mf', 'woff2']);
@@ -509,6 +621,8 @@ export function installFloorWords(document) {
             out.push({ word: 'addOn.assistant', path: 'addOn.assistant' });
         if (block['forms'] !== undefined)
             out.push({ word: 'addOn.forms', path: 'addOn.forms' });
+        if (block['scope'] !== undefined)
+            out.push({ word: 'addOn.scope', path: 'addOn.scope' });
         // A step's person, its record named by a column and filtered, a choice's help line, and the record's own table and key.
         list(block['steps']).forEach((step, s) => {
             if (!isDoc(step))
@@ -580,6 +694,9 @@ export function installFloorWords(document) {
             // Where a record opens on the side: a release before the floor refuses the key.
             if (isDoc(frontend) && frontend['records'] !== undefined)
                 out.push({ word: 'frontend.records', path: `frontends.${String(f)}.records` });
+            // A side that serves every install of its app.
+            if (isDoc(frontend) && frontend['instances'] !== undefined)
+                out.push({ word: 'frontend.instances', path: `frontends.${String(f)}.instances` });
         });
         // An entry of the app's section that is not a page.
         if (document['navLinks'] !== undefined)
@@ -595,6 +712,16 @@ export function installFloorWords(document) {
                     out.push({ word: 'roles.privacyPeople', path: `roles.${String(r)}.permissions.${String(g)}` });
             });
         });
+        // What only a file made on an Adminium carries.
+        for (const block of ['reports', 'invoiceLayouts', 'scheduledReports', 'payments']) {
+            if (document[block] !== undefined)
+                out.push({ word: block, path: block });
+        }
+        // A row removed through a public entry of an app (an add-on's own link says `publicAccess.ownDelete`).
+        list(document['publicAccess']).forEach((entry, e) => {
+            if (isDoc(entry) && Array.isArray(entry['methods']) && entry['methods'].includes('DELETE'))
+                out.push({ word: 'publicAccess.delete', path: `publicAccess.${String(e)}.methods` });
+        });
         // The app's people tables.
         if (document['people'] !== undefined)
             out.push({ word: 'people', path: 'people' });
@@ -816,8 +943,62 @@ export function installFloorWords(document) {
             }
         });
     });
+    // The fields a dashboard's tables are described with: on a column, on a link, on a table.
+    if (document['provenance'] !== undefined)
+        out.push({ word: 'app.provenance', path: 'provenance' });
+    if (document['icon'] !== undefined)
+        out.push({ word: 'app.icon', path: 'icon' });
+    if (isDoc(document['apps']) && document['apps']['requires'] !== undefined)
+        out.push({ word: 'apps.requires', path: 'apps.requires' });
+    if (document['instance'] !== undefined)
+        out.push({ word: 'instance', path: 'instance' });
+    list(schema['tables']).forEach((table, t) => {
+        if (!isDoc(table))
+            return;
+        const at = `requiredSchema.tables.${String(t)}`;
+        for (const key of ['exclude', 'existingCustomers', 'switchedOff', 'name', 'schema']) {
+            if (table[key] !== undefined)
+                out.push({ word: `table.${key}`, path: `${at}.${key}` });
+        }
+        list(table['columns']).forEach((column, c) => {
+            if (!isDoc(column))
+                return;
+            const here = `${at}.columns.${String(c)}`;
+            if (column['type'] === 'time')
+                out.push({ word: 'column.time', path: `${here}.type` });
+            if (typeof column['ref'] === 'string' && !/^[a-z][a-z0-9_]*$/.test(column['ref']))
+                out.push({ word: 'column.name', path: `${here}.ref` });
+            for (const key of ['precision', 'hidden', 'yesNo']) {
+                if (column[key] !== undefined)
+                    out.push({ word: `column.${key}`, path: `${here}.${key}` });
+            }
+            const relation = isDoc(column['relation']) ? column['relation'] : {};
+            if (relation['label'] !== undefined)
+                out.push({ word: 'relation.label', path: `${here}.relation.label` });
+            if (relation['remove'] !== undefined)
+                out.push({ word: 'relation.remove', path: `${here}.relation.remove` });
+            if (relation['constraint'] !== undefined)
+                out.push({ word: 'relation.noConstraint', path: `${here}.relation.constraint` });
+        });
+    });
+    for (const [name, optionList] of Object.entries(isDoc(document['optionLists']) ? document['optionLists'] : {})) {
+        list(isDoc(optionList) ? optionList['values'] : undefined).forEach((value, v) => {
+            if (isDoc(value) && value['description'] !== undefined)
+                out.push({ word: 'optionList.description', path: `optionLists.${name}.values.${String(v)}.description` });
+        });
+    }
+    list(document['emailTemplates']).forEach((template, t) => {
+        for (const key of ['kind', 'category', 'brand', 'attachments']) {
+            if (isDoc(template) && template[key] !== undefined)
+                out.push({ word: `email.${key}`, path: `emailTemplates.${String(t)}.${key}` });
+        }
+    });
     // A dashboard's second toolbar link, a ranking's named pair, a record page's tab words, a list's bulk action, a board's columns.
     list(document['pages']).forEach((page, p) => {
+        if (isDoc(page) && page['envelope'] !== undefined)
+            out.push({ word: 'page.envelope', path: `pages.${String(p)}.envelope` });
+        if (isDoc(page) && page['views'] !== undefined)
+            out.push({ word: 'page.views', path: `pages.${String(p)}.views` });
         const config = isDoc(page) && isDoc(page['config']) ? page['config'] : {};
         const here = `pages.${String(p)}.config`;
         // A page kept off the sidebar.
@@ -966,6 +1147,14 @@ export function installFloorWords(document) {
                 }
                 if (action['kind'] === 'record.create' && action['name'] !== undefined)
                     out.push({ word: 'automations.stepName', path: `${at}.${String(n)}.action.name` });
+                if (action['kind'] === 'webhook')
+                    out.push({ word: 'automations.webhook', path: `${at}.${String(n)}.action` });
+                if (action['kind'] === 'document.render')
+                    out.push({ word: 'automations.documentRender', path: `${at}.${String(n)}.action` });
+                if (action['kind'] === 'email' && to['kind'] === 'fixed')
+                    out.push({ word: 'automations.fixedAddress', path: `${at}.${String(n)}.action.to` });
+                if (action['kind'] === 'email' && action['purpose'] !== undefined)
+                    out.push({ word: 'automations.purpose', path: `${at}.${String(n)}.action.purpose` });
                 // A value read from the settings row, a day so many days on.
                 for (const [ref, value] of Object.entries(isDoc(action['values']) ? action['values'] : {})) {
                     if (isDoc(value) && value['setting'] !== undefined)
@@ -993,6 +1182,8 @@ export function installFloorWords(document) {
         const forEach = isDoc(rule) && isDoc(rule['trigger']) && isDoc(rule['trigger']['forEach']) ? rule['trigger']['forEach'] : {};
         if (forEach['once'] === 'per-spell')
             out.push({ word: 'automations.perSpell', path: `automations.${String(r)}.trigger.forEach.once` });
+        if (isDoc(rule) && isDoc(rule['trigger']) && rule['trigger']['watch'] !== undefined)
+            out.push({ word: 'automations.watch', path: `automations.${String(r)}.trigger.watch` });
     });
     // An app's e-mail that names the person a staff column names: a template the outbox sends reading `<…>.<staff column>.name`.
     const outboxTemplates = new Set(Object.values(isDoc(outbox['kinds']) ? outbox['kinds'] : {}).filter((key) => typeof key === 'string'));
@@ -1004,6 +1195,10 @@ export function installFloorWords(document) {
             out.push({ word: 'outbox.staffName', path: `emailTemplates.${String(t)}` });
     });
     list(document['documents']).forEach((entry, d) => {
+        for (const key of ['options', 'trigger', 'deliver']) {
+            if (isDoc(entry) && entry[key] !== undefined)
+                out.push({ word: `documents.${key}`, path: `documents.${String(d)}.${key}` });
+        }
         for (const [slot, source] of Object.entries(isDoc(entry) && isDoc(entry['mapping']) ? entry['mapping'] : {})) {
             const sources = isDoc(source) ? [...(isDoc(source['collection']) ? [source['collection']] : []), ...list(source['collections'])] : [];
             if (sources.some((one) => isDoc(one) && one['addOn'] !== undefined))
@@ -1038,6 +1233,17 @@ export function installFloorWords(document) {
         uploadsIn(entry, `publicAccess.${String(e)}`);
         if (isDoc(entry) && entry['assets'] !== undefined)
             out.push({ word: 'publicAccess.assets', path: `publicAccess.${String(e)}.assets` });
+        // The wider methods and the endpoint's own address, pages, rate and reply.
+        if (isDoc(entry) && Array.isArray(entry['methods'])) {
+            if (entry['methods'].includes('PUT'))
+                out.push({ word: 'publicAccess.put', path: `publicAccess.${String(e)}.methods` });
+            if (entry['methods'].includes('BATCH'))
+                out.push({ word: 'publicAccess.batch', path: `publicAccess.${String(e)}.methods` });
+        }
+        for (const [key, word] of [['path', 'publicAccess.path'], ['pagination', 'publicAccess.pagination'], ['rateLimit', 'publicAccess.rateLimit'], ['response', 'publicAccess.response']]) {
+            if (isDoc(entry) && entry[key] !== undefined)
+                out.push({ word, path: `publicAccess.${String(e)}.${key}` });
+        }
     });
     return out;
 }