@ai-matrx/records 0.92.0 → 0.92.1

package/dist/react/index.d.cts

@@ -6184,7 +6184,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).
      */
@@ -13094,6 +13094,8 @@ interface RecordsClient {
     recordRead(args: {
         record_id: Uuid;
         withComputed?: boolean;
+        /** Also answer `version` (read in the same round, so the read takes as long as the slower of the two). */
+        withVersion?: boolean;
         organization_id?: Uuid | null;
     }): Promise<RecordsResult<RecordRead>>;
     /**

package/dist/react/index.d.ts

@@ -6184,7 +6184,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).
      */
@@ -13094,6 +13094,8 @@ interface RecordsClient {
     recordRead(args: {
         record_id: Uuid;
         withComputed?: boolean;
+        /** Also answer `version` (read in the same round, so the read takes as long as the slower of the two). */
+        withVersion?: boolean;
         organization_id?: Uuid | null;
     }): Promise<RecordsResult<RecordRead>>;
     /**

package/dist/react/index.js

@@ -4782,24 +4782,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;
@@ -4815,7 +4815,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([]);