@payloadcms/drizzle 3.81.0-internal-debug.1a0f4d0 → 3.81.0

package/dist/utilities/getTransaction.js

@@ -1,10 +1,17 @@
+import { shouldReadFromPrimary } from './readAfterWrite.js';
 /**
  * Returns current db transaction instance from req or adapter.drizzle itself
  *
  * If a transaction session doesn't exist (e.g., it was already committed/rolled back),
  * falls back to the default adapter.drizzle instance to prevent errors.
+ *
+ * When read replicas are configured and a write happened recently, returns the
+ * unwrapped primary to avoid replication-lag stale reads.
  */ export const getTransaction = async (adapter, req)=>{
     if (!req?.transactionID) {
+        if (shouldReadFromPrimary(adapter)) {
+            return adapter.primaryDrizzle;
+        }
         return adapter.drizzle;
     }
     return adapter.sessions[await req.transactionID]?.db || adapter.drizzle;

package/dist/utilities/getTransaction.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getTransaction.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport type { DrizzleAdapter } from '../types.js'\n\n/**\n * Returns current db transaction instance from req or adapter.drizzle itself\n *\n * If a transaction session doesn't exist (e.g., it was already committed/rolled back),\n * falls back to the default adapter.drizzle instance to prevent errors.\n */\nexport const getTransaction = async <T extends DrizzleAdapter = DrizzleAdapter>(\n  adapter: T,\n  req?: Partial<PayloadRequest>,\n): Promise<T['drizzle']> => {\n  if (!req?.transactionID) {\n    return adapter.drizzle\n  }\n\n  return (adapter.sessions[await req.transactionID]?.db as T['drizzle']) || adapter.drizzle\n}\n"],"names":["getTransaction","adapter","req","transactionID","drizzle","sessions","db"],"mappings":"AAIA;;;;;CAKC,GACD,OAAO,MAAMA,iBAAiB,OAC5BC,SACAC;IAEA,IAAI,CAACA,KAAKC,eAAe;QACvB,OAAOF,QAAQG,OAAO;IACxB;IAEA,OAAO,AAACH,QAAQI,QAAQ,CAAC,MAAMH,IAAIC,aAAa,CAAC,EAAEG,MAAuBL,QAAQG,OAAO;AAC3F,EAAC"}
+{"version":3,"sources":["../../src/utilities/getTransaction.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport type { DrizzleAdapter } from '../types.js'\n\nimport { shouldReadFromPrimary } from './readAfterWrite.js'\n\n/**\n * Returns current db transaction instance from req or adapter.drizzle itself\n *\n * If a transaction session doesn't exist (e.g., it was already committed/rolled back),\n * falls back to the default adapter.drizzle instance to prevent errors.\n *\n * When read replicas are configured and a write happened recently, returns the\n * unwrapped primary to avoid replication-lag stale reads.\n */\nexport const getTransaction = async <T extends DrizzleAdapter = DrizzleAdapter>(\n  adapter: T,\n  req?: Partial<PayloadRequest>,\n): Promise<T['drizzle']> => {\n  if (!req?.transactionID) {\n    if (shouldReadFromPrimary(adapter)) {\n      return adapter.primaryDrizzle as T['drizzle']\n    }\n    return adapter.drizzle\n  }\n\n  return (adapter.sessions[await req.transactionID]?.db as T['drizzle']) || adapter.drizzle\n}\n"],"names":["shouldReadFromPrimary","getTransaction","adapter","req","transactionID","primaryDrizzle","drizzle","sessions","db"],"mappings":"AAIA,SAASA,qBAAqB,QAAQ,sBAAqB;AAE3D;;;;;;;;CAQC,GACD,OAAO,MAAMC,iBAAiB,OAC5BC,SACAC;IAEA,IAAI,CAACA,KAAKC,eAAe;QACvB,IAAIJ,sBAAsBE,UAAU;YAClC,OAAOA,QAAQG,cAAc;QAC/B;QACA,OAAOH,QAAQI,OAAO;IACxB;IAEA,OAAO,AAACJ,QAAQK,QAAQ,CAAC,MAAMJ,IAAIC,aAAa,CAAC,EAAEI,MAAuBN,QAAQI,OAAO;AAC3F,EAAC"}

package/dist/utilities/readAfterWrite.d.ts

@@ -0,0 +1,17 @@
+import type { DrizzleAdapter } from '../types.js';
+/**
+ * Tracks the last write timestamp on the adapter so that reads within a
+ * configurable window after a write are routed to the primary instead of a
+ * read replica.
+ *
+ * This avoids stale-read issues caused by replication lag when application
+ * code writes then immediately reads (e.g. create → findByID).
+ */
+/** Call after any successful write to mark the adapter. */
+export declare function markWrite(adapter: DrizzleAdapter): void;
+/**
+ * Returns true when a recent write happened and reads should be routed to the
+ * primary to guarantee read-after-write consistency.
+ */
+export declare function shouldReadFromPrimary(adapter: DrizzleAdapter): boolean;
+//# sourceMappingURL=readAfterWrite.d.ts.map

package/dist/utilities/readAfterWrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readAfterWrite.d.ts","sourceRoot":"","sources":["../../src/utilities/readAfterWrite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;GAOG;AAEH,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAKtE"}

package/dist/utilities/readAfterWrite.js

@@ -0,0 +1,21 @@
+/**
+ * Tracks the last write timestamp on the adapter so that reads within a
+ * configurable window after a write are routed to the primary instead of a
+ * read replica.
+ *
+ * This avoids stale-read issues caused by replication lag when application
+ * code writes then immediately reads (e.g. create → findByID).
+ */ /** Call after any successful write to mark the adapter. */ export function markWrite(adapter) {
+    adapter.lastWriteTimestamp = Date.now();
+}
+/**
+ * Returns true when a recent write happened and reads should be routed to the
+ * primary to guarantee read-after-write consistency.
+ */ export function shouldReadFromPrimary(adapter) {
+    if (!adapter.primaryDrizzle || !adapter.lastWriteTimestamp) {
+        return false;
+    }
+    return Date.now() - adapter.lastWriteTimestamp < adapter.readReplicasAfterWriteInterval;
+}
+
+//# sourceMappingURL=readAfterWrite.js.map

package/dist/utilities/readAfterWrite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/readAfterWrite.ts"],"sourcesContent":["import type { DrizzleAdapter } from '../types.js'\n\n/**\n * Tracks the last write timestamp on the adapter so that reads within a\n * configurable window after a write are routed to the primary instead of a\n * read replica.\n *\n * This avoids stale-read issues caused by replication lag when application\n * code writes then immediately reads (e.g. create → findByID).\n */\n\n/** Call after any successful write to mark the adapter. */\nexport function markWrite(adapter: DrizzleAdapter): void {\n  adapter.lastWriteTimestamp = Date.now()\n}\n\n/**\n * Returns true when a recent write happened and reads should be routed to the\n * primary to guarantee read-after-write consistency.\n */\nexport function shouldReadFromPrimary(adapter: DrizzleAdapter): boolean {\n  if (!adapter.primaryDrizzle || !adapter.lastWriteTimestamp) {\n    return false\n  }\n  return Date.now() - adapter.lastWriteTimestamp < adapter.readReplicasAfterWriteInterval\n}\n"],"names":["markWrite","adapter","lastWriteTimestamp","Date","now","shouldReadFromPrimary","primaryDrizzle","readReplicasAfterWriteInterval"],"mappings":"AAEA;;;;;;;CAOC,GAED,yDAAyD,GACzD,OAAO,SAASA,UAAUC,OAAuB;IAC/CA,QAAQC,kBAAkB,GAAGC,KAAKC,GAAG;AACvC;AAEA;;;CAGC,GACD,OAAO,SAASC,sBAAsBJ,OAAuB;IAC3D,IAAI,CAACA,QAAQK,cAAc,IAAI,CAACL,QAAQC,kBAAkB,EAAE;QAC1D,OAAO;IACT;IACA,OAAOC,KAAKC,GAAG,KAAKH,QAAQC,kBAAkB,GAAGD,QAAQM,8BAA8B;AACzF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/drizzle",
-  "version": "3.81.0-internal-debug.1a0f4d0",
+  "version": "3.81.0",
   "description": "A library of shared functions used by different payload database adapters",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -60,10 +60,10 @@
     "@types/pg": "8.10.2",
     "@types/to-snake-case": "1.0.0",
     "@payloadcms/eslint-config": "3.28.0",
-    "payload": "3.81.0-internal-debug.1a0f4d0"
+    "payload": "3.81.0"
   },
   "peerDependencies": {
-    "payload": "3.81.0-internal-debug.1a0f4d0"
+    "payload": "3.81.0"
   },
   "scripts": {
     "build": "pnpm build:swc && pnpm build:types",