@sequenceholdings/orm 2.6.1 → 2.6.2

package/README.md

@@ -131,7 +131,7 @@ Execute uses the `/_data/v2` endpoint by default. Set
 `SEQUENCE_ORM_ATLAS_EXECUTE_V2=1` to opt into Atlas's `/api/data/v2` endpoint.
 This client rollout switch does not bypass server feature flags or authorization.
 
-## Default read-only SQL (planned 2.6.0)
+## Default read-only SQL (introduced in 2.6.0)
 
 With the matching SDK and Atlas rollout, every active v2 namespace supports
 runtime-supplied SQL without an authored operation or Function:
@@ -154,6 +154,37 @@ Separate protected execution targets cannot be joined. Existing registered
 operations remain supported; supply a manifest when executing them by name.
 Source versions alone do not prove package publication or server availability.
 
+## Source-publication read receipts (planned 2.6.2)
+
+The upcoming `@sequenceholdings/orm/client` factories add
+`executeWithReadReceipt()` for reads enrolled in a host publication guard.
+Confirm package publication and the matching host rollout before using it.
+The method accepts only queries classified by the supplied manifest or the
+built-in SQL read. Known mutations, conflicting classifications and unclassified
+raw or typed selectors fail locally with `OrmClientError` before dispatch.
+
+```ts
+const first = await db.executeWithReadReceipt('ReadSourcePage', { after: null })
+const next = await db.executeWithReadReceipt('ReadSourcePage', { after: cursor }, {
+  expectedSourceGeneration: first.sourceGeneration,
+})
+```
+
+The result is `{ data, sourceGeneration }`. Treat the lowercase 64-character
+hexadecimal receipt as opaque. The host binds it to the authenticated actor,
+database and validated publication, and checks continuation inside the same
+locked read-only repeatable-read transaction as the query. Current permissions
+and row policies are checked again on every request. A receipt can cross
+admitted operations for the same publication, but it does not preserve a row
+snapshot: mutable data can change between reads without a new publication.
+
+Missing, malformed or mismatched acknowledgements fail with
+`OrmOperationError` / `OBJECT_UNAVAILABLE`. Unsupported scopes, explain and
+mutations cannot use continuation. Do not retry without the expectation when
+that would combine different source publications. Plain `execute()` still
+returns only data; supplying `expectedSourceGeneration` also requires a valid
+matching acknowledgement. Existing calls without that option are unchanged.
+
 ## Public exports
 
 - `@sequenceholdings/orm/authoring` — namespace, table, policy, and view DSL

package/dist/authoring.d.cts

@@ -3,7 +3,7 @@ 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-B99BsOAO.cjs';
+export { S as SqlOperationDefinition, d as defineOperation } from './definition-DjfC7Lll.cjs';
 import 'zod';
 import './policy-1iZbGnZZ.cjs';
 

package/dist/authoring.d.ts

@@ -3,7 +3,7 @@ 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-B99BsOAO.js';
+export { S as SqlOperationDefinition, d as defineOperation } from './definition-DjfC7Lll.js';
 import 'zod';
 import './policy-1iZbGnZZ.js';
 

package/dist/canonical.d.cts

@@ -102,8 +102,8 @@ type CanonicalFetchShape = z.infer<typeof canonicalFetchShapeSchema>;
 declare const canonicalResolvedSourceSchema: z.ZodObject<{
     name: z.ZodString;
     kind: z.ZodEnum<{
-        prefetch: "prefetch";
         manual: "manual";
+        prefetch: "prefetch";
         etl: "etl";
     }>;
     table: z.ZodString;
@@ -160,8 +160,8 @@ declare const canonicalResolvedSchema: z.ZodObject<{
     sources: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         kind: z.ZodEnum<{
-            prefetch: "prefetch";
             manual: "manual";
+            prefetch: "prefetch";
             etl: "etl";
         }>;
         table: z.ZodString;
@@ -325,13 +325,13 @@ declare const canonicalColumnSchema: z.ZodObject<{
         bigint: "bigint";
         boolean: "boolean";
         date: "date";
-        uuid: "uuid";
         text: "text";
+        timestamptz: "timestamptz";
+        jsonb: "jsonb";
+        uuid: "uuid";
         integer: "integer";
         numeric: "numeric";
         double: "double";
-        timestamptz: "timestamptz";
-        jsonb: "jsonb";
     }>, z.ZodObject<{
         enum: z.ZodString;
     }, z.core.$strip>]>;
@@ -353,10 +353,10 @@ declare const canonicalColumnSchema: z.ZodObject<{
         of: z.ZodString;
         part: z.ZodEnum<{
             at: "at";
-            source: "source";
             by: "by";
-            conflicts: "conflicts";
             rev: "rev";
+            source: "source";
+            conflicts: "conflicts";
         }>;
     }, z.core.$strict>>;
 }, z.core.$strip>;
@@ -460,21 +460,21 @@ declare const canonicalActionSchema: z.ZodObject<{
             bigint: "bigint";
             boolean: "boolean";
             date: "date";
-            uuid: "uuid";
             text: "text";
+            timestamptz: "timestamptz";
+            jsonb: "jsonb";
+            uuid: "uuid";
             integer: "integer";
             numeric: "numeric";
             double: "double";
-            timestamptz: "timestamptz";
-            jsonb: "jsonb";
         }>;
         nullable: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>>;
     executes: z.ZodString;
     returns: z.ZodDefault<z.ZodEnum<{
         rows: "rows";
-        scalar: "scalar";
         rowsAffected: "rowsAffected";
+        scalar: "scalar";
     }>>;
     audit: z.ZodOptional<z.ZodObject<{
         action: z.ZodString;
@@ -540,13 +540,13 @@ declare const canonicalTableSchema: z.ZodObject<{
             bigint: "bigint";
             boolean: "boolean";
             date: "date";
-            uuid: "uuid";
             text: "text";
+            timestamptz: "timestamptz";
+            jsonb: "jsonb";
+            uuid: "uuid";
             integer: "integer";
             numeric: "numeric";
             double: "double";
-            timestamptz: "timestamptz";
-            jsonb: "jsonb";
         }>, z.ZodObject<{
             enum: z.ZodString;
         }, z.core.$strip>]>;
@@ -568,10 +568,10 @@ declare const canonicalTableSchema: z.ZodObject<{
             of: z.ZodString;
             part: z.ZodEnum<{
                 at: "at";
-                source: "source";
                 by: "by";
-                conflicts: "conflicts";
                 rev: "rev";
+                source: "source";
+                conflicts: "conflicts";
             }>;
         }, z.core.$strict>>;
     }, z.core.$strip>>>;
@@ -655,21 +655,21 @@ declare const canonicalTableSchema: z.ZodObject<{
                 bigint: "bigint";
                 boolean: "boolean";
                 date: "date";
-                uuid: "uuid";
                 text: "text";
+                timestamptz: "timestamptz";
+                jsonb: "jsonb";
+                uuid: "uuid";
                 integer: "integer";
                 numeric: "numeric";
                 double: "double";
-                timestamptz: "timestamptz";
-                jsonb: "jsonb";
             }>;
             nullable: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>>;
         executes: z.ZodString;
         returns: z.ZodDefault<z.ZodEnum<{
             rows: "rows";
-            scalar: "scalar";
             rowsAffected: "rowsAffected";
+            scalar: "scalar";
         }>>;
         audit: z.ZodOptional<z.ZodObject<{
             action: z.ZodString;
@@ -726,13 +726,13 @@ declare const canonicalViewSchema: z.ZodObject<{
             bigint: "bigint";
             boolean: "boolean";
             date: "date";
-            uuid: "uuid";
             text: "text";
+            timestamptz: "timestamptz";
+            jsonb: "jsonb";
+            uuid: "uuid";
             integer: "integer";
             numeric: "numeric";
             double: "double";
-            timestamptz: "timestamptz";
-            jsonb: "jsonb";
         }>, z.ZodObject<{
             enum: z.ZodString;
         }, z.core.$strip>]>;
@@ -754,10 +754,10 @@ declare const canonicalViewSchema: z.ZodObject<{
             of: z.ZodString;
             part: z.ZodEnum<{
                 at: "at";
-                source: "source";
                 by: "by";
-                conflicts: "conflicts";
                 rev: "rev";
+                source: "source";
+                conflicts: "conflicts";
             }>;
         }, z.core.$strict>>;
     }, z.core.$strip>>;
@@ -806,8 +806,8 @@ declare const canonicalViewSchema: z.ZodObject<{
         sources: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             kind: z.ZodEnum<{
-                prefetch: "prefetch";
                 manual: "manual";
+                prefetch: "prefetch";
                 etl: "etl";
             }>;
             table: z.ZodString;
@@ -947,13 +947,13 @@ declare const localDefinitionSchema: z.ZodObject<{
                 bigint: "bigint";
                 boolean: "boolean";
                 date: "date";
-                uuid: "uuid";
                 text: "text";
+                timestamptz: "timestamptz";
+                jsonb: "jsonb";
+                uuid: "uuid";
                 integer: "integer";
                 numeric: "numeric";
                 double: "double";
-                timestamptz: "timestamptz";
-                jsonb: "jsonb";
             }>, z.ZodObject<{
                 enum: z.ZodString;
             }, z.core.$strip>]>;
@@ -975,10 +975,10 @@ declare const localDefinitionSchema: z.ZodObject<{
                 of: z.ZodString;
                 part: z.ZodEnum<{
                     at: "at";
-                    source: "source";
                     by: "by";
-                    conflicts: "conflicts";
                     rev: "rev";
+                    source: "source";
+                    conflicts: "conflicts";
                 }>;
             }, z.core.$strict>>;
         }, z.core.$strip>>>;
@@ -1062,21 +1062,21 @@ declare const localDefinitionSchema: z.ZodObject<{
                     bigint: "bigint";
                     boolean: "boolean";
                     date: "date";
-                    uuid: "uuid";
                     text: "text";
+                    timestamptz: "timestamptz";
+                    jsonb: "jsonb";
+                    uuid: "uuid";
                     integer: "integer";
                     numeric: "numeric";
                     double: "double";
-                    timestamptz: "timestamptz";
-                    jsonb: "jsonb";
                 }>;
                 nullable: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>>;
             executes: z.ZodString;
             returns: z.ZodDefault<z.ZodEnum<{
                 rows: "rows";
-                scalar: "scalar";
                 rowsAffected: "rowsAffected";
+                scalar: "scalar";
             }>>;
             audit: z.ZodOptional<z.ZodObject<{
                 action: z.ZodString;
@@ -1132,13 +1132,13 @@ declare const localDefinitionSchema: z.ZodObject<{
                 bigint: "bigint";
                 boolean: "boolean";
                 date: "date";
-                uuid: "uuid";
                 text: "text";
+                timestamptz: "timestamptz";
+                jsonb: "jsonb";
+                uuid: "uuid";
                 integer: "integer";
                 numeric: "numeric";
                 double: "double";
-                timestamptz: "timestamptz";
-                jsonb: "jsonb";
             }>, z.ZodObject<{
                 enum: z.ZodString;
             }, z.core.$strip>]>;
@@ -1160,10 +1160,10 @@ declare const localDefinitionSchema: z.ZodObject<{
                 of: z.ZodString;
                 part: z.ZodEnum<{
                     at: "at";
-                    source: "source";
                     by: "by";
-                    conflicts: "conflicts";
                     rev: "rev";
+                    source: "source";
+                    conflicts: "conflicts";
                 }>;
             }, z.core.$strict>>;
         }, z.core.$strip>>;
@@ -1212,8 +1212,8 @@ declare const localDefinitionSchema: z.ZodObject<{
             sources: z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 kind: z.ZodEnum<{
-                    prefetch: "prefetch";
                     manual: "manual";
+                    prefetch: "prefetch";
                     etl: "etl";
                 }>;
                 table: z.ZodString;
@@ -1336,13 +1336,13 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                 bigint: "bigint";
                 boolean: "boolean";
                 date: "date";
-                uuid: "uuid";
                 text: "text";
+                timestamptz: "timestamptz";
+                jsonb: "jsonb";
+                uuid: "uuid";
                 integer: "integer";
                 numeric: "numeric";
                 double: "double";
-                timestamptz: "timestamptz";
-                jsonb: "jsonb";
             }>, z.ZodObject<{
                 enum: z.ZodString;
             }, z.core.$strip>]>;
@@ -1364,10 +1364,10 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                 of: z.ZodString;
                 part: z.ZodEnum<{
                     at: "at";
-                    source: "source";
                     by: "by";
-                    conflicts: "conflicts";
                     rev: "rev";
+                    source: "source";
+                    conflicts: "conflicts";
                 }>;
             }, z.core.$strict>>;
         }, z.core.$strip>>>;
@@ -1451,21 +1451,21 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                     bigint: "bigint";
                     boolean: "boolean";
                     date: "date";
-                    uuid: "uuid";
                     text: "text";
+                    timestamptz: "timestamptz";
+                    jsonb: "jsonb";
+                    uuid: "uuid";
                     integer: "integer";
                     numeric: "numeric";
                     double: "double";
-                    timestamptz: "timestamptz";
-                    jsonb: "jsonb";
                 }>;
                 nullable: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>>;
             executes: z.ZodString;
             returns: z.ZodDefault<z.ZodEnum<{
                 rows: "rows";
-                scalar: "scalar";
                 rowsAffected: "rowsAffected";
+                scalar: "scalar";
             }>>;
             audit: z.ZodOptional<z.ZodObject<{
                 action: z.ZodString;
@@ -1521,13 +1521,13 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                 bigint: "bigint";
                 boolean: "boolean";
                 date: "date";
-                uuid: "uuid";
                 text: "text";
+                timestamptz: "timestamptz";
+                jsonb: "jsonb";
+                uuid: "uuid";
                 integer: "integer";
                 numeric: "numeric";
                 double: "double";
-                timestamptz: "timestamptz";
-                jsonb: "jsonb";
             }>, z.ZodObject<{
                 enum: z.ZodString;
             }, z.core.$strip>]>;
@@ -1549,10 +1549,10 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                 of: z.ZodString;
                 part: z.ZodEnum<{
                     at: "at";
-                    source: "source";
                     by: "by";
-                    conflicts: "conflicts";
                     rev: "rev";
+                    source: "source";
+                    conflicts: "conflicts";
                 }>;
             }, z.core.$strict>>;
         }, z.core.$strip>>;
@@ -1601,8 +1601,8 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
             sources: z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 kind: z.ZodEnum<{
-                    prefetch: "prefetch";
                     manual: "manual";
+                    prefetch: "prefetch";
                     etl: "etl";
                 }>;
                 table: z.ZodString;
@@ -1724,13 +1724,13 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                     bigint: "bigint";
                     boolean: "boolean";
                     date: "date";
-                    uuid: "uuid";
                     text: "text";
+                    timestamptz: "timestamptz";
+                    jsonb: "jsonb";
+                    uuid: "uuid";
                     integer: "integer";
                     numeric: "numeric";
                     double: "double";
-                    timestamptz: "timestamptz";
-                    jsonb: "jsonb";
                 }>, z.ZodObject<{
                     enum: z.ZodString;
                 }, z.core.$strip>]>;
@@ -1752,10 +1752,10 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                     of: z.ZodString;
                     part: z.ZodEnum<{
                         at: "at";
-                        source: "source";
                         by: "by";
-                        conflicts: "conflicts";
                         rev: "rev";
+                        source: "source";
+                        conflicts: "conflicts";
                     }>;
                 }, z.core.$strict>>;
             }, z.core.$strip>>>;
@@ -1839,21 +1839,21 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                         bigint: "bigint";
                         boolean: "boolean";
                         date: "date";
-                        uuid: "uuid";
                         text: "text";
+                        timestamptz: "timestamptz";
+                        jsonb: "jsonb";
+                        uuid: "uuid";
                         integer: "integer";
                         numeric: "numeric";
                         double: "double";
-                        timestamptz: "timestamptz";
-                        jsonb: "jsonb";
                     }>;
                     nullable: z.ZodDefault<z.ZodBoolean>;
                 }, z.core.$strip>>>;
                 executes: z.ZodString;
                 returns: z.ZodDefault<z.ZodEnum<{
                     rows: "rows";
-                    scalar: "scalar";
                     rowsAffected: "rowsAffected";
+                    scalar: "scalar";
                 }>>;
                 audit: z.ZodOptional<z.ZodObject<{
                     action: z.ZodString;
@@ -1909,13 +1909,13 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                     bigint: "bigint";
                     boolean: "boolean";
                     date: "date";
-                    uuid: "uuid";
                     text: "text";
+                    timestamptz: "timestamptz";
+                    jsonb: "jsonb";
+                    uuid: "uuid";
                     integer: "integer";
                     numeric: "numeric";
                     double: "double";
-                    timestamptz: "timestamptz";
-                    jsonb: "jsonb";
                 }>, z.ZodObject<{
                     enum: z.ZodString;
                 }, z.core.$strip>]>;
@@ -1937,10 +1937,10 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                     of: z.ZodString;
                     part: z.ZodEnum<{
                         at: "at";
-                        source: "source";
                         by: "by";
-                        conflicts: "conflicts";
                         rev: "rev";
+                        source: "source";
+                        conflicts: "conflicts";
                     }>;
                 }, z.core.$strict>>;
             }, z.core.$strip>>;
@@ -1989,8 +1989,8 @@ declare const canonicalDefinitionSchema: z.ZodObject<{
                 sources: z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
                     kind: z.ZodEnum<{
-                        prefetch: "prefetch";
                         manual: "manual";
+                        prefetch: "prefetch";
                         etl: "etl";
                     }>;
                     table: z.ZodString;