@ai-matrx/records 0.92.0 → 0.92.1

package/dist/realtime/index.d.cts

@@ -1,7 +1,7 @@
 import * as _ai_matrx_realtime from '@ai-matrx/realtime';
 import { RealtimeManager, ChannelSpec } from '@ai-matrx/realtime';
-import { R as RecordsRealtimePort } from '../ports-DSU2RsR6.cjs';
-import '../record-BQi92d4-.cjs';
+import { R as RecordsRealtimePort } from '../ports-s0D2jvqn.cjs';
+import '../record-BwCf9wKW.cjs';
 
 /**
  * The topic is a CONTRACT WITH THE DATABASE (a Postgres trigger writes it, an RLS policy parses it),

package/dist/realtime/index.d.ts

@@ -1,7 +1,7 @@
 import * as _ai_matrx_realtime from '@ai-matrx/realtime';
 import { RealtimeManager, ChannelSpec } from '@ai-matrx/realtime';
-import { R as RecordsRealtimePort } from '../ports-BWtxAnXh.js';
-import '../record-BQi92d4-.js';
+import { R as RecordsRealtimePort } from '../ports-BeOgjwYl.js';
+import '../record-BwCf9wKW.js';
 
 /**
  * The topic is a CONTRACT WITH THE DATABASE (a Postgres trigger writes it, an RLS policy parses it),

package/dist/{record-BQi92d4-.d.cts → record-BwCf9wKW.d.cts}

@@ -6181,7 +6181,7 @@ interface RecordRead {
      */
     computedUnavailable?: RecordsError | null;
     /**
-     * The version this read saw, so a safe edit (`recordUpdate` with `expected_version`) needs no
+     * Asked with `withVersion: true`: the version this read saw, so a safe edit (`recordUpdate` with `expected_version`) needs no
      * second call. Read beside the document in the same round of requests; `null` when the store
      * could not answer it (a write then refuses as "version unread", never as last-write-wins).
      */

package/dist/{record-BQi92d4-.d.ts → record-BwCf9wKW.d.ts}

@@ -6181,7 +6181,7 @@ interface RecordRead {
      */
     computedUnavailable?: RecordsError | null;
     /**
-     * The version this read saw, so a safe edit (`recordUpdate` with `expected_version`) needs no
+     * Asked with `withVersion: true`: the version this read saw, so a safe edit (`recordUpdate` with `expected_version`) needs no
      * second call. Read beside the document in the same round of requests; `null` when the store
      * could not answer it (a write then refuses as "version unread", never as last-write-wins).
      */

package/dist/{relation-DMwkmzgN.d.cts → relation-8vAWCa67.d.cts}

@@ -1,5 +1,5 @@
-import { U as Uuid, b as RelationFlavor, O as OnDelete, c as RelationBinding, d as RelationCardinality, T as Timestamp, R as RecordsResult } from './record-BQi92d4-.cjs';
-import { c as RecordsDataSource } from './ports-DSU2RsR6.cjs';
+import { U as Uuid, b as RelationFlavor, O as OnDelete, c as RelationBinding, d as RelationCardinality, T as Timestamp, R as RecordsResult } from './record-BwCf9wKW.cjs';
+import { c as RecordsDataSource } from './ports-s0D2jvqn.cjs';
 
 /**
  * REL-6. Whether Visibility flows along this relation and the MAXIMUM access

package/dist/{relation-DlcqV_W5.d.ts → relation-eLMgv_dV.d.ts}

@@ -1,5 +1,5 @@
-import { U as Uuid, b as RelationFlavor, O as OnDelete, c as RelationBinding, d as RelationCardinality, T as Timestamp, R as RecordsResult } from './record-BQi92d4-.js';
-import { c as RecordsDataSource } from './ports-BWtxAnXh.js';
+import { U as Uuid, b as RelationFlavor, O as OnDelete, c as RelationBinding, d as RelationCardinality, T as Timestamp, R as RecordsResult } from './record-BwCf9wKW.js';
+import { c as RecordsDataSource } from './ports-BeOgjwYl.js';
 
 /**
  * REL-6. Whether Visibility flows along this relation and the MAXIMUM access

package/dist/{rule-B8kR0l01.d.ts → rule-D9yNiorf.d.ts}

@@ -1,4 +1,4 @@
-import { U as Uuid, e as RuleNodeKind, f as RuleUse, T as Timestamp } from './record-BQi92d4-.js';
+import { U as Uuid, e as RuleNodeKind, f as RuleUse, T as Timestamp } from './record-BwCf9wKW.js';
 
 /**
  * A rule expression as `custom.rule_eval` ACTUALLY evaluates it — read off the

package/dist/{rule-BMViCLmW.d.cts → rule-wHI5B0Ka.d.cts}

@@ -1,4 +1,4 @@
-import { U as Uuid, e as RuleNodeKind, f as RuleUse, T as Timestamp } from './record-BQi92d4-.cjs';
+import { U as Uuid, e as RuleNodeKind, f as RuleUse, T as Timestamp } from './record-BwCf9wKW.cjs';
 
 /**
  * A rule expression as `custom.rule_eval` ACTUALLY evaluates it — read off the

package/dist/search/index.d.cts

@@ -1,4 +1,4 @@
-import { U as Uuid, R as RecordsResult } from '../record-BQi92d4-.cjs';
+import { U as Uuid, R as RecordsResult } from '../record-BwCf9wKW.cjs';
 
 declare const STORE_RECORD_SEARCH_MIN_CHARS = 2;
 /** One record the search door found. */

package/dist/search/index.d.ts

@@ -1,4 +1,4 @@
-import { U as Uuid, R as RecordsResult } from '../record-BQi92d4-.js';
+import { U as Uuid, R as RecordsResult } from '../record-BwCf9wKW.js';
 
 declare const STORE_RECORD_SEARCH_MIN_CHARS = 2;
 /** One record the search door found. */

package/dist/setup/index.cjs

@@ -3071,24 +3071,24 @@ function createRecordsClient(given) {
       if (!pass.ok) return pass;
       return carryOnCopy(pass.data, onProgress);
     },
-    async recordRead({ record_id, withComputed = false, organization_id }) {
+    async recordRead({ record_id, withComputed = false, withVersion = false, organization_id }) {
       if (organization_id && organization_id !== org) {
-        return clientFor(organization_id).recordRead({ record_id, withComputed, organization_id });
+        return clientFor(organization_id).recordRead({ record_id, withComputed, withVersion, organization_id });
       }
       if (readOrgs(organization_id).length > 1) {
         return openInOwnOrg(
           record_id,
           organization_id,
-          (sub) => sub.recordRead({ record_id, withComputed, organization_id: sub.config.organizationId }),
+          (sub) => sub.recordRead({ record_id, withComputed, withVersion, organization_id: sub.config.organizationId }),
           () => true
         );
       }
       const [door, header] = await Promise.all([
         callDoor(DOORS.readRecord, { p_organization_id: org, p_record_id: record_id }, "recordRead"),
         // A version that cannot be read never takes the record away: it comes back as null.
-        callDoor(DOORS.recordHeaders, { p_organization_id: org, p_ids: [record_id] }, "recordRead.version").catch(
+        withVersion ? callDoor(DOORS.recordHeaders, { p_organization_id: org, p_ids: [record_id] }, "recordRead.version").catch(
           () => null
-        )
+        ) : Promise.resolve(null)
       ]);
       if (!door.ok) return err(door.error);
       const version = header && header.ok ? header.data?.find((h) => h.id === record_id)?.version ?? null : null;
@@ -3104,7 +3104,7 @@ function createRecordsClient(given) {
         if (provenance.ok) computed = provenance.data ?? [];
         else computedUnavailable = provenance.error;
       }
-      return ok({ record_id, document, hidden, computed, computedUnavailable, version });
+      return ok({ record_id, document, hidden, computed, computedUnavailable, ...withVersion ? { version } : {} });
     },
     async listByIds({ table_id, ids }) {
       if (ids.length === 0) return ok([]);