@sequenceholdings/orm 2.8.3 → 2.8.4

package/dist/index.d.cts

@@ -578,6 +578,12 @@ interface SyncedBacking {
      */
     readonly readGuard?: 'crm-serving-v2';
 }
+/**
+ * Atlas reassigns every relation in `orm_<ns>` to this role after apply.
+ * Synced views resolve backing access as their owner. Grant this role narrow
+ * SELECT before CREATE VIEW, or preserve a separately verified publisher grant.
+ */
+declare const SYNCED_VIEW_EXECUTION_OWNER_ROLE = "orm_exec";
 /**
  * Emit CREATE OR REPLACE VIEW + SELECT-only grants for synced tables that have
  * a registered backing. Synced tables cannot use table-level RLS (they may be
@@ -586,12 +592,6 @@ interface SyncedBacking {
  * Each view lives in `orm_<ns>` alongside regular tables, named identically to
  * the synced table definition so read routing is transparent.
  */
-/**
- * Atlas reassigns every relation in `orm_<ns>` to this role after apply.
- * Synced views resolve backing access as their owner. Grant this role narrow
- * SELECT before CREATE VIEW, or preserve a separately verified publisher grant.
- */
-declare const SYNCED_VIEW_EXECUTION_OWNER_ROLE = "orm_exec";
 declare function syncedViewStatements({ definition, backings, readPolicyIrByTable, policyTables, columnNamesByTable, columnTypesByTable, executionOwnerRole, backingPrivileges, viewPrivileges, statementClaimChecks, }: {
     definition: NamespaceDefinition;
     backings: readonly SyncedBacking[];
@@ -747,9 +747,7 @@ declare function planCommittedMigrationV2({ canonical, previousSnapshot, reprodu
  * and types the live view from the SELECT itself. Assert the live catalog in
  * the same transaction so a stale alias/type or an incomplete dependency
  * declaration can never be persisted as a successful schema version.
- */
-/**
- * Assert live view columns/types/dependencies match the canonical contract.
+ *
  * Used by planMigrationV2 and by CASCADE recovery recreates (same transaction).
  */
 declare function validateViewCatalogStatement({ canonical, view, schema, }: {

package/dist/index.d.ts

@@ -578,6 +578,12 @@ interface SyncedBacking {
      */
     readonly readGuard?: 'crm-serving-v2';
 }
+/**
+ * Atlas reassigns every relation in `orm_<ns>` to this role after apply.
+ * Synced views resolve backing access as their owner. Grant this role narrow
+ * SELECT before CREATE VIEW, or preserve a separately verified publisher grant.
+ */
+declare const SYNCED_VIEW_EXECUTION_OWNER_ROLE = "orm_exec";
 /**
  * Emit CREATE OR REPLACE VIEW + SELECT-only grants for synced tables that have
  * a registered backing. Synced tables cannot use table-level RLS (they may be
@@ -586,12 +592,6 @@ interface SyncedBacking {
  * Each view lives in `orm_<ns>` alongside regular tables, named identically to
  * the synced table definition so read routing is transparent.
  */
-/**
- * Atlas reassigns every relation in `orm_<ns>` to this role after apply.
- * Synced views resolve backing access as their owner. Grant this role narrow
- * SELECT before CREATE VIEW, or preserve a separately verified publisher grant.
- */
-declare const SYNCED_VIEW_EXECUTION_OWNER_ROLE = "orm_exec";
 declare function syncedViewStatements({ definition, backings, readPolicyIrByTable, policyTables, columnNamesByTable, columnTypesByTable, executionOwnerRole, backingPrivileges, viewPrivileges, statementClaimChecks, }: {
     definition: NamespaceDefinition;
     backings: readonly SyncedBacking[];
@@ -747,9 +747,7 @@ declare function planCommittedMigrationV2({ canonical, previousSnapshot, reprodu
  * and types the live view from the SELECT itself. Assert the live catalog in
  * the same transaction so a stale alias/type or an incomplete dependency
  * declaration can never be persisted as a successful schema version.
- */
-/**
- * Assert live view columns/types/dependencies match the canonical contract.
+ *
  * Used by planMigrationV2 and by CASCADE recovery recreates (same transaction).
  */
 declare function validateViewCatalogStatement({ canonical, view, schema, }: {

package/dist/index.js

@@ -1759,7 +1759,7 @@ var canonicalTableSchema = z.object({
   table: identifier2,
   displayName: z.string().trim().min(1).max(120).optional(),
   description: z.string().max(2e3).optional(),
-  /** Table-level rename hint (new in v2). */
+  /** Table-level rename hint. */
   renamedFrom: identifier2.optional(),
   /** Synced/reflected read-only tables (`source: schema.table`) — v1 semantics. */
   source: z.string().regex(QUALIFIED_TABLE_PATTERN).optional(),
@@ -2423,6 +2423,12 @@ function builtinCell({ comparator, candidates }) {
     }
   };
 }
+function existsInCell(candidate) {
+  return {
+    value: candidate.value,
+    parts: { source: literal(candidate.source), at: candidate.at, by: candidate.by, conflicts: "CAST(NULL AS jsonb)" }
+  };
+}
 function customCell({ candidates, orderBy, index: index3 }) {
   const w = ident(`w_${index3}`);
   const rows = candidates.map((c, ord) => `(${literal(c.source)}, ${c.has}, ${c.value}, ${c.at}, ${c.by}, ${ord})`);
@@ -2446,26 +2452,29 @@ function buildResolvedQuery({ context, plan }) {
   const tombstoned2 = RESOLVED_SOURCE_SYSTEM_COLUMNS.tombstoned.columnName;
   const sourceByName = new Map(plan.plans.map((source) => [source.name, source]));
   const schema = getTableConfig(relation(plan.plans[0].table)).schema;
+  const keySource = plan.existsIn === void 0 ? void 0 : sourceByName.get(plan.existsIn);
+  const keyRef = keySource ? `${alias(keySource.name)}.${ident(physical({ source: keySource, property: plan.pk }))}` : `"k".${ident(pkColumn)}`;
   const keyBranches = plan.plans.map((source) => {
     const where = source.kind === "prefetch" ? sql.raw(` WHERE NOT ${ident(tombstoned2)}`) : sql.raw("");
     const sourcePk = ident(physical({ source, property: plan.pk }));
     const selectedPk = sourcePk === ident(pkColumn) ? sourcePk : `${sourcePk} AS ${ident(pkColumn)}`;
     return sql`SELECT ${sql.raw(selectedPk)} FROM ${relation(source.table)}${where}`;
   });
-  const joins = plan.plans.map(
-    (source) => sql` LEFT JOIN ${relation(source.table)} AS ${sql.raw(alias(source.name))} ON ${sql.raw(`${alias(source.name)}.${ident(physical({ source, property: plan.pk }))} = "k".${ident(pkColumn)}`)}`
+  const base2 = keySource ? sql`${relation(keySource.table)} AS ${sql.raw(alias(keySource.name))}` : sql`(${sql.join(keyBranches, sql.raw(" UNION "))}) AS "k"`;
+  const joins = plan.plans.filter((source) => source !== keySource).map(
+    (source) => sql` LEFT JOIN ${relation(source.table)} AS ${sql.raw(alias(source.name))} ON ${sql.raw(`${alias(source.name)}.${ident(physical({ source, property: plan.pk }))} = ${keyRef}`)}`
   );
   const cells = /* @__PURE__ */ new Map();
   plan.rules.forEach((rule, index3) => {
     const canonical = plan.columns[rule.column].toCanonicalColumn(rule.column);
     const pgType = typeof canonical.type === "string" ? PG_TYPE[canonical.type] : `${schema === void 0 ? "" : `${ident(schema)}.`}${ident(canonical.type.enum)}`;
     const candidates = rule.candidates.map((name2) => candidateSql({ source: sourceByName.get(name2), column: rule.column, pk: plan.pk, pgType }));
-    cells.set(rule.column, rule.comparator === "custom" ? customCell({ candidates, orderBy: rule.orderBy, index: index3 }) : builtinCell({ comparator: rule.comparator, candidates }));
+    cells.set(rule.column, keySource && rule.candidates.length === 1 && rule.candidates[0] === keySource.name ? existsInCell(candidates[0]) : rule.comparator === "custom" ? customCell({ candidates, orderBy: rule.orderBy, index: index3 }) : builtinCell({ comparator: rule.comparator, candidates }));
   });
   const laterals = [...cells.values()].flatMap((cell) => cell.lateral ? [sql.raw(cell.lateral)] : []);
-  const from = sql.join([sql`(${sql.join(keyBranches, sql.raw(" UNION "))}) AS "k"`, ...joins, ...laterals], sql.raw(""));
+  const from = sql.join([base2, ...joins, ...laterals], sql.raw(""));
   const selected = {
-    [plan.pk]: sql.raw(`"k".${ident(pkColumn)}`).as(pkColumn)
+    [plan.pk]: sql.raw(keyRef).as(pkColumn)
   };
   for (const [property, builder] of Object.entries(plan.columns)) {
     if (property === plan.pk) continue;
@@ -2537,10 +2546,12 @@ function defineResolvedTable(name2, columns, config) {
   for (const source of deletedBy) {
     if (plans.find((plan) => plan.name === source)?.kind !== "manual") fail3(`rows.deletedBy "${source}" must be the manual source`);
   }
+  const existsIn = planExistsIn({ config, plans, fail: fail3 });
+  const notNullColumns = existsIn ? inheritedNotNullColumns({ existsIn, rules }) : /* @__PURE__ */ new Set();
   const partType = { source: t.text, at: t.timestamptz, by: t.text, conflicts: t.jsonb };
   const viewColumns = {};
   for (const [property, builder] of Object.entries(columns)) {
-    viewColumns[property] = cloneColumn({ builder, property, notNull: property === pk, primaryKey: property === pk });
+    viewColumns[property] = cloneColumn({ builder, property, notNull: property === pk || notNullColumns.has(property), primaryKey: property === pk });
     if (property === pk) continue;
     const columnName = builder.columnNameFor(property);
     for (const part of RESOLVED_VIEW_CELL_PARTS) {
@@ -2556,7 +2567,7 @@ function defineResolvedTable(name2, columns, config) {
     deletedBy,
     policies: writePolicies
   };
-  const queryPlan = { columns, pk, plans, rules, deletedBy };
+  const queryPlan = { columns, pk, plans, rules, deletedBy, ...existsIn ? { existsIn: existsIn.name } : {} };
   const typedColumns = viewColumns;
   const surface = {
     ...config.description !== void 0 ? { description: config.description } : {},
@@ -2598,6 +2609,18 @@ function defineResolvedTable(name2, columns, config) {
     }
   });
 }
+function planExistsIn({ config, plans, fail: fail3 }) {
+  const names = config.rows?.existsIn;
+  if (names === void 0) return void 0;
+  if (names.length !== 1) fail3("rows.existsIn names exactly one etl source");
+  const source = plans.find((plan) => plan.name === names[0]);
+  if (source?.kind !== "etl") fail3(`rows.existsIn "${names[0]}" must be an etl source`);
+  if (config.policies.insert !== void 0 || config.policies.write !== void 0) fail3("rows.existsIn allows only an update policy: rows come from the etl source");
+  return source;
+}
+function inheritedNotNullColumns({ existsIn, rules }) {
+  return new Set(rules.filter((rule) => rule.candidates.length === 1 && rule.candidates[0] === existsIn.name).map((rule) => rule.column).filter((column) => existsIn.table.columns[column]?.toCanonicalColumn(column).nullable === false));
+}
 function planRules({ config, plans, dataColumns, fail: fail3 }) {
   const kindOrder = { manual: 0, prefetch: 1, etl: 2 };
   const fallback = config.default ?? priority([...plans].sort((a, b) => kindOrder[a.kind] - kindOrder[b.kind]).map((plan) => plan.name));