@sequenceholdings/orm 2.3.0 → 2.5.0

package/dist/authoring.d.cts

@@ -1,9 +1,9 @@
 import { ColumnType, CanonicalColumn, ComparatorKind, CanonicalFunctionRef, CanonicalFetchShape, CanonicalDefinition, CanonicalTable } from './canonical.cjs';
-import { b as CellPart } from './constants-C6EG6Wq7.cjs';
+import { b as CellPart } from './constants-Dou1RkTo.cjs';
 import { ColumnsSelection } from 'drizzle-orm';
 import { TypedQueryBuilder } from 'drizzle-orm/query-builders/query-builder';
 import { QueryBuilder, PgView, PgTable, AnyPgColumn } from 'drizzle-orm/pg-core';
-export { S as SqlOperationDefinition, d as defineOperation } from './definition-DjfC7Lll.cjs';
+export { S as SqlOperationDefinition, d as defineOperation } from './definition-B99BsOAO.cjs';
 import 'zod';
 import './policy-1iZbGnZZ.cjs';
 
@@ -611,7 +611,10 @@ interface SyncedTableConfig {
     /** Reflected read-only source as a safe qualified identifier: `<schema>.<table>`. */
     source: string;
     description?: string;
-    /** Composite primary key: property names (or column names). Mutually exclusive with column-level `.primaryKey()`. */
+    /**
+     * Primary-key property/column names, mutually exclusive with column-level
+     * `.primaryKey()`. Explicit `[]` declares a read-only bag with no row identity.
+     */
     primaryKey?: readonly string[];
     links?: Record<string, SeqLink>;
     policies?: SyncedTablePoliciesInput;
@@ -726,11 +729,12 @@ declare function syncedContractSurface({ namespace, table, columns, primary_key,
 }): Record<string, unknown>;
 declare function computeSyncedContractHash(surface: Record<string, unknown>): string;
 /**
- * Extract the Managed Pipelines contract from a typed canonical synced table.
+ * Extract the source contract from a typed canonical synced table.
  *
- * Requires non-empty columns and a primary key (the typed `defineSyncedTable`
- * authoring rules). Enum columns are rejected — they have no pipeline-type
- * preimage in the ORM↔pipeline bijection.
+ * Requires non-empty columns and an explicit key contract. An empty primary
+ * key describes an unkeyed read-only source; Managed Pipelines additionally
+ * requires a non-empty key. Enum columns are rejected — they have no
+ * pipeline-type preimage in the shared type bijection.
  */
 declare function extractOrmSyncedTableContract({ namespace, table, }: {
     namespace: string;

package/dist/authoring.d.ts

@@ -1,9 +1,9 @@
 import { ColumnType, CanonicalColumn, ComparatorKind, CanonicalFunctionRef, CanonicalFetchShape, CanonicalDefinition, CanonicalTable } from './canonical.js';
-import { b as CellPart } from './constants-C6EG6Wq7.js';
+import { b as CellPart } from './constants-Dou1RkTo.js';
 import { ColumnsSelection } from 'drizzle-orm';
 import { TypedQueryBuilder } from 'drizzle-orm/query-builders/query-builder';
 import { QueryBuilder, PgView, PgTable, AnyPgColumn } from 'drizzle-orm/pg-core';
-export { S as SqlOperationDefinition, d as defineOperation } from './definition-DjfC7Lll.js';
+export { S as SqlOperationDefinition, d as defineOperation } from './definition-B99BsOAO.js';
 import 'zod';
 import './policy-1iZbGnZZ.js';
 
@@ -611,7 +611,10 @@ interface SyncedTableConfig {
     /** Reflected read-only source as a safe qualified identifier: `<schema>.<table>`. */
     source: string;
     description?: string;
-    /** Composite primary key: property names (or column names). Mutually exclusive with column-level `.primaryKey()`. */
+    /**
+     * Primary-key property/column names, mutually exclusive with column-level
+     * `.primaryKey()`. Explicit `[]` declares a read-only bag with no row identity.
+     */
     primaryKey?: readonly string[];
     links?: Record<string, SeqLink>;
     policies?: SyncedTablePoliciesInput;
@@ -726,11 +729,12 @@ declare function syncedContractSurface({ namespace, table, columns, primary_key,
 }): Record<string, unknown>;
 declare function computeSyncedContractHash(surface: Record<string, unknown>): string;
 /**
- * Extract the Managed Pipelines contract from a typed canonical synced table.
+ * Extract the source contract from a typed canonical synced table.
  *
- * Requires non-empty columns and a primary key (the typed `defineSyncedTable`
- * authoring rules). Enum columns are rejected — they have no pipeline-type
- * preimage in the ORM↔pipeline bijection.
+ * Requires non-empty columns and an explicit key contract. An empty primary
+ * key describes an unkeyed read-only source; Managed Pipelines additionally
+ * requires a non-empty key. Enum columns are rejected — they have no
+ * pipeline-type preimage in the shared type bijection.
  */
 declare function extractOrmSyncedTableContract({ namespace, table, }: {
     namespace: string;

package/dist/authoring.js

@@ -151,7 +151,7 @@ var t = {
 };
 
 // src/constants.ts
-var NAMESPACE_PATTERN = /^[a-z][a-z0-9_]{0,40}$/;
+var NAMESPACE_PATTERN = /^(?!(?:events|native_sources)$)[a-z][a-z0-9_]{0,40}$/;
 var IDENTIFIER_PATTERN = /^[a-z][a-z0-9_]*$/;
 var COLUMN_IDENTIFIER_PATTERN = /^_?[a-z][a-z0-9_]*$/;
 var MAX_IDENTIFIER_LENGTH = 63;
@@ -365,10 +365,10 @@ function defineSyncedTable(name2, columnsOrConfig, maybeConfig) {
     if (builder.isPrimaryKey) columnLevelPk.push(propertyName);
   }
   if (entries.length > 0) {
-    const hasConfigPk = config.primaryKey !== void 0 && config.primaryKey.length > 0;
+    const hasConfigPk = config.primaryKey !== void 0;
     if (columnLevelPk.length === 0 && !hasConfigPk) {
       throw new OrmDefinitionError(
-        `synced table "${name2}" declares columns but no primary key \u2014 use .primaryKey() or config.primaryKey`,
+        `synced table "${name2}" declares columns but no primary key \u2014 use .primaryKey(), config.primaryKey, or explicit primaryKey: [] for an unkeyed read-only source`,
         file
       );
     }
@@ -1229,6 +1229,7 @@ function validateResolvedView({ view, tables, views = [] }) {
 function validateSource({ scope, source, table }) {
   const { fail } = scope;
   if (source.kind === "etl" && table.source === void 0) fail(`etl source '${source.name}' must reference a synced table`);
+  if (source.kind === "etl" && table.primaryKey?.length === 0) fail(`etl source '${source.name}' cannot use an unkeyed synced table for resolved row identity`);
   if (source.kind !== "etl" && (table.internal !== true || table.cellMetadata !== true)) {
     fail(`${source.kind} source '${source.name}' must reference an internal table with cell metadata`);
   }
@@ -1677,7 +1678,7 @@ var canonicalTableSchema = z.object({
   /** Synced/reflected read-only tables (`source: schema.table`) — v1 semantics. */
   source: z.string().regex(QUALIFIED_TABLE_PATTERN).optional(),
   columns: z.array(canonicalColumnSchema).default([]),
-  primaryKey: z.array(columnIdentifier).min(1).max(8).optional(),
+  primaryKey: z.array(columnIdentifier).max(8).optional(),
   links: z.array(canonicalLinkSchema).default([]),
   indexes: z.array(canonicalIndexSchema).default([]),
   /** Omitted by old definitions, preserving their existing content hashes. */
@@ -1713,6 +1714,29 @@ var canonicalTableSchema = z.object({
    * data plane. Omitted otherwise.
    */
   materializes: identifier2.optional()
+}).superRefine((table, ctx) => {
+  if (table.primaryKey?.length !== 0) return;
+  const fail = (message, path = ["primaryKey"]) => ctx.addIssue({ code: "custom", path, message: `unkeyed table '${table.table}' ${message}` });
+  if (table.source === void 0 || table.columns.length === 0) {
+    fail("requires a typed synced source");
+  }
+  if ([table.policies.write, table.policies.insert, table.policies.update].some((policy) => policy !== void 0)) {
+    fail("is read-only and cannot declare write policies", ["policies"]);
+  }
+  const ownedCollections = [table.indexes, table.actions, table.checks, table.foreignKeys, table.cowMutations];
+  const ownedMetadata = [table.cellMetadata, table.internal, table.materializes, table.renamedFrom];
+  if (ownedCollections.some((items) => items !== void 0 && items.length > 0) || ownedMetadata.some((value) => value !== void 0)) {
+    fail("cannot declare owned storage, constraints or identity operations");
+  }
+  for (const [index, column] of table.columns.entries()) {
+    const ownedColumnMetadata = [column.default, column.defaultFn, column.onUpdateFn, column.renamedFrom, column.cast, column.cell];
+    if (column.unique || ownedColumnMetadata.some((value) => value !== void 0)) {
+      fail("cannot declare column uniqueness, mutation defaults or migration metadata", ["columns", index]);
+    }
+  }
+  for (const [index, link] of table.links.entries()) {
+    if (link.enforce || link.kind === "toMany") fail("cannot provide an identity for this link", ["links", index]);
+  }
 });
 var MAX_VIEW_QUERY = 1e5;
 var MAX_RESOLVED_VIEW_QUERY = 5e6;
@@ -1769,6 +1793,26 @@ var canonicalViewSchema = z.object({
     }
   }
 });
+function validateUnkeyedLinkIdentities({ definition, ctx }) {
+  const tables = new Map(definition.tables.map((table) => [table.table, table]));
+  const relations = [
+    ...definition.tables.map((table, index) => ({ kind: "tables", index, links: table.links })),
+    ...(definition.views ?? []).map((view, index) => ({ kind: "views", index, links: view.links }))
+  ];
+  for (const relation of relations) {
+    for (const [linkIndex, link] of relation.links.entries()) {
+      if (link.kind !== "toOne" || link.namespace !== void 0 && link.namespace !== definition.namespace) continue;
+      const target = link.target === void 0 ? void 0 : tables.get(link.target);
+      if (target?.source !== void 0 && target.primaryKey?.length === 0) {
+        ctx.addIssue({
+          code: "custom",
+          path: [relation.kind, relation.index, "links", linkIndex],
+          message: `link '${link.name}' cannot use unkeyed table '${target.table}' as a to-one identity`
+        });
+      }
+    }
+  }
+}
 var CELL_PART_TYPES = {
   at: "timestamptz",
   by: "text",
@@ -1832,7 +1876,7 @@ var exportGateSchema = z.union([z.literal(true), z.object({ capability: z.string
 var relationExportSchema = z.object({ read: exportGateSchema, write: exportGateSchema.optional() }).strict();
 var localDefinitionSchema = z.object({
   definition_format: z.literal(CANONICAL_FORMAT),
-  namespace: identifier2.max(41),
+  namespace: identifier2.max(41).regex(NAMESPACE_PATTERN, "invalid or reserved ORM namespace"),
   description: z.string().max(2e3).optional(),
   enums: z.array(canonicalEnumSchema).default([]),
   tables: z.array(canonicalTableSchema).min(0).max(500),
@@ -1866,6 +1910,7 @@ var localDefinitionSchema = z.object({
     }
   }
   const fkTables = new Map(definition.tables.map((table) => [table.table, table]));
+  validateUnkeyedLinkIdentities({ definition, ctx });
   const relations = /* @__PURE__ */ new Set([...fkTables.keys(), ...(definition.views ?? []).map((view) => view.view)]);
   for (const name2 of Object.keys(definition.exports ?? {})) {
     if (!relations.has(name2)) ctx.addIssue({ code: "custom", path: ["exports", name2], message: `export '${name2}' is not a local object` });
@@ -2155,6 +2200,7 @@ function planEtl(input, source) {
   const table = typeof source.table === "function" ? source.table() : source.table;
   if (!isSeqTable(table) || table.source === void 0) fail(`etl source "${sourceName}" must reference a defineSyncedTable`);
   const synced = table;
+  if (synced.config.primaryKey?.length === 0) fail(`etl source "${sourceName}" cannot use an unkeyed synced table for resolved row identity`);
   if (!(pk in synced.columns)) fail(`etl source "${sourceName}" table "${synced.tableName}" has no "${pk}" column`);
   const supplied = source.columns ? [...source.columns] : dataColumns.filter((column) => column in synced.columns);
   assertColumns(input, supplied, `etl source "${sourceName}"`);
@@ -3164,9 +3210,9 @@ function extractOrmSyncedTableContract({
     );
   }
   const primaryKey = table.primaryKey;
-  if (primaryKey === void 0 || primaryKey.length === 0) {
+  if (primaryKey === void 0) {
     throw new OrmDefinitionError(
-      `synced table "${table.table}" has no primary key \u2014 typed synced contracts require a primary key`
+      `synced table "${table.table}" has no primary key contract \u2014 declare a key or explicit primaryKey: []`
     );
   }
   const pkSet = new Set(primaryKey);