@ai-matrx/data 0.18.35 → 0.18.37

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.18.37
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/data/v0.18.36..npm/data/v0.18.37 -- apps/shared/data`).
+No source changes intended and no consumer action required.
+
+## 0.18.36
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/data/v0.18.35..npm/data/v0.18.36 -- apps/shared/data`).
+No source changes intended and no consumer action required.
+
 ## 0.18.35
 ### Unreleased
 
@@ -9,6 +21,8 @@
   matrx-frontend so `@ai-matrx/chat` stops reaching into the app for them.
 - `@supabase/supabase-js` is now a peer dependency (external, never bundled) so `PostgrestError`
   is the consumer's own class and `instanceof` checks hold.
+- `/db` gains `RecordUnavailableError`, `recordUnavailableMessage`, `isRecordUnavailableError`
+  (the zero-row single-record read shape), moved from matrx-frontend `lib/records/recordUnavailable.ts`.
 - **Consumer action:** none required; matrx-frontend's old modules re-export these.
 
 ## 0.18.34

package/README.md

@@ -146,7 +146,7 @@ expired or healed and the superseded key was not cleared. **Read it before treat
 that bounce when the flag is set, or a 2.5s network blink signs people out mid-session.
 A call site needing `created_at`, `identities`, `last_sign_in_at`, `factors` or
 `*_confirmed_at` must keep `getUser()` elsewhere: the JWT carries none of them.
-Full contract: `common-docs/systems/platform/proxy-identity/FEATURE.md`.
+Full contract: `common-docs/systems/platform/auth/proxy-identity/FEATURE.md`.
 
 **No `next/*` import lives in the package.** `cookies()` and `NextResponse` arrive through
 structural seams (`createResponse: () => NextResponse.next({ request })`), so `/next`

package/dist/db.cjs

@@ -25,6 +25,7 @@ __export(db_exports, {
   DEFAULT_ACTIVE_ORG_COOKIE_NAME: () => DEFAULT_ACTIVE_ORG_COOKIE_NAME,
   DEFAULT_AUTH_COOKIE_NAME: () => DEFAULT_AUTH_COOKIE_NAME,
   IncompleteReadError: () => IncompleteReadError,
+  RecordUnavailableError: () => RecordUnavailableError,
   SessionUnavailableError: () => SessionUnavailableError,
   WriteDidNotLandError: () => WriteDidNotLandError,
   WriteRefusedError: () => WriteRefusedError,
@@ -40,11 +41,13 @@ __export(db_exports, {
   encodeActiveOrgSelection: () => encodeActiveOrgSelection,
   guardedUpdate: () => guardedUpdate,
   isMissingSessionError: () => isMissingSessionError,
+  isRecordUnavailableError: () => isRecordUnavailableError,
   mergeJsonColumn: () => mergeJsonColumn,
   parseCookieHeader: () => parseCookieHeader,
   personSentence: () => personSentence,
   readAllRows: () => readAllRows,
   readAllRowsRest: () => readAllRowsRest,
+  recordUnavailableMessage: () => recordUnavailableMessage,
   serverMessageFromBody: () => serverMessageFromBody,
   tryReadAllRows: () => tryReadAllRows,
   tryReadAllRowsRest: () => tryReadAllRowsRest,
@@ -913,4 +916,40 @@ async function writeOneRow(write, options) {
     })
   };
 }
+
+// src/db/record-unavailable.ts
+var RecordUnavailableError = class extends Error {
+  entity;
+  reason;
+  recordId;
+  /**
+   * Canonical entity token, when the read site knows it. With a token AND a
+   * recordId the renderer stops describing the ambiguity and ASKS the platform
+   * instead — an access gate resolves which of the four it really is.
+   * Without one, honest ambiguity is still the best available answer.
+   */
+  token;
+  /** Diagnostics identity for reconciling this exact capture in place. */
+  captureId;
+  /** Last truth written to diagnostics; avoids duplicate reconciliation. */
+  captureResolution;
+  constructor(input) {
+    super(recordUnavailableMessage(input.entity, input.reason));
+    this.name = "RecordUnavailableError";
+    this.entity = input.entity;
+    this.reason = input.reason;
+    this.recordId = input.recordId;
+    this.token = input.token;
+    this.captureResolution = input.reason;
+  }
+};
+function recordUnavailableMessage(entity, reason) {
+  if (reason === "deleted") {
+    return `This ${entity} was deleted, so it can no longer be opened.`;
+  }
+  return `We couldn't open this ${entity}. It may have been deleted, or it may belong to an organization you don't have access to.`;
+}
+function isRecordUnavailableError(value) {
+  return value instanceof RecordUnavailableError;
+}
 //# sourceMappingURL=db.cjs.map