@adcp/sdk 15.3.0 → 15.5.0

package/dist/lib/reporting/ledger/handler.d.ts

@@ -15,6 +15,12 @@ export interface ReportingStatusConsumerScopeOptionsV1<TContext = unknown> {
 }
 export declare function createReportingStatusHandler(store: ReportingLedgerStore): (request: Parameters<ReportingStatusHandlerV1>[0], context: Pick<Parameters<ReportingStatusHandlerV1>[1], 'account' | 'signal'>) => ReturnType<ReportingStatusHandlerV1>;
 export declare function createReportingStatusHandler<TContext = unknown>(store: ReportingLedgerStore, options?: ReportingStatusConsumerScopeOptionsV1<TContext>): ReportingStatusHandlerV1;
+/**
+ * Largest revision whose rows the `get_reporting_status` `revision` view
+ * returns inline. Larger revisions omit `reporting_rows` there; callers page
+ * them through the exact `get_media_buy_delivery` read.
+ */
+export declare const REPORTING_STATUS_REVISION_VIEW_MAX_ROWS = 10000;
 /** Exact revision reader for createAdcpServer's getMediaBuyDelivery slot. */
 export declare function createReportingDeliveryHandler(store: ReportingLedgerStore): ReportingDeliveryHandlerV1;
 export interface ProjectManagedDeliveryInputV1 {

package/dist/lib/reporting/ledger/handler.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var handler_exports = {};
 __export(handler_exports, {
+  REPORTING_STATUS_REVISION_VIEW_MAX_ROWS: () => REPORTING_STATUS_REVISION_VIEW_MAX_ROWS,
   ReportingReadCapacityError: () => ReportingReadCapacityError,
   acquireAccountReadSlot: () => acquireAccountReadSlot,
   aggregateReportingCoverageV1: () => aggregateReportingCoverageV1,
@@ -34,6 +35,8 @@ var import_source = require('../source/index.js');
 var import_coverage = require('./coverage.js');
 var import_health = require('./health.js');
 var import_instant = require('./instant.js');
+var import_revision_metadata = require('./revision-metadata.js');
+var import_row_storage = require('./row-storage.js');
 var import_schedule = require('./schedule.js');
 var import_types = require('./types.js');
 function createReportingStatusHandler(store, options) {
@@ -248,11 +251,26 @@ function createReportingStatusHandler(store, options) {
         const id = query.reporting_revision_id;
         const inSnapshot = id ? page.snapshot.revisions.some((value) => value.reporting_revision_id === id) : false;
         let revision = null;
+        let revisionRows;
         if (id && inSnapshot) {
           try {
-            revision = await store.getRevision(id, accountId);
+            revision = await (0, import_revision_metadata.getRevisionMetadataFromStore)(store, id, accountId);
+            const rowCount = revision?.binding.rowCount ?? 0;
+            if (revision && rowCount <= REPORTING_STATUS_REVISION_VIEW_MAX_ROWS) {
+              const page2 = rowCount === 0 ? { rows: [], total: 0 } : await (0, import_revision_metadata.readRevisionRowsFromStore)(store, {
+                reporting_revision_id: id,
+                account_id: accountId,
+                offset: 0,
+                limit: rowCount,
+                ...context.signal ? { signal: context.signal } : {}
+              });
+              if (!page2 || page2.total !== rowCount) revision = null;
+              else revisionRows = page2.rows;
+            }
           } catch (error) {
-            if (error instanceof ReportingReadCapacityError) return lookupUnavailable(view);
+            if (error instanceof ReportingReadCapacityError || (0, import_row_storage.isReportingRowStoreError)(error)) {
+              return lookupUnavailable(view);
+            }
             throw error;
           }
         }
@@ -278,7 +296,7 @@ function createReportingStatusHandler(store, options) {
             revision_content_sha256: revision.wireRevision.revision_content_sha256,
             row_count: revision.binding.rowCount
           },
-          reporting_rows: revision.rows,
+          ...revisionRows ? { reporting_rows: revisionRows } : {},
           adjustments: revisionAdjustments.map((value) => value.wireAdjustment),
           ...consumerId ? { consumer_statuses: (page.consumerStatuses ?? []).map(wireConsumerStatus) } : {},
           materializations: (page.materializations ?? []).filter(
@@ -391,6 +409,7 @@ function createReportingStatusHandler(store, options) {
     }
   };
 }
+const REPORTING_STATUS_REVISION_VIEW_MAX_ROWS = 1e4;
 function createReportingDeliveryHandler(store) {
   const activeReadsByAccount = /* @__PURE__ */ new Map();
   return async (request, context) => {
@@ -411,7 +430,7 @@ function createReportingDeliveryHandler(store) {
       if (typeof raw.reporting_revision_id !== "string" || !raw.reporting_revision_id) {
         throw new Error("Ledger delivery reads require reporting_revision_id");
       }
-      const revision = await store.getRevision(raw.reporting_revision_id, accountId);
+      const revision = await (0, import_revision_metadata.getRevisionMetadataFromStore)(store, raw.reporting_revision_id, accountId);
       if (!revision) throw new Error("Reporting revision is unavailable");
       const obligation = await store.getObligation(revision.reporting_obligation_id);
       if (!obligation || obligation.account.account_id !== accountId) {
@@ -419,11 +438,12 @@ function createReportingDeliveryHandler(store) {
       }
       const pagination = isRecord(raw.pagination) ? raw.pagination : {};
       const maxResults = typeof pagination.max_results === "number" && Number.isFinite(pagination.max_results) ? Math.max(1, Math.min(500, Math.trunc(pagination.max_results))) : 100;
+      const totalCount = revision.binding.rowCount;
       let offset = 0;
       if (typeof pagination.cursor === "string") {
         try {
           const cursor = JSON.parse(Buffer.from(pagination.cursor, "base64url").toString("utf8"));
-          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= revision.rows.length) {
+          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= totalCount) {
             throw new Error("invalid");
           }
           offset = cursor.offset;
@@ -431,9 +451,31 @@ function createReportingDeliveryHandler(store) {
           throw new Error("Reporting delivery cursor is invalid");
         }
       }
-      const reportingRows = revision.rows.slice(offset, offset + maxResults);
+      let reportingRows = [];
+      if (totalCount > 0) {
+        let page;
+        try {
+          page = await (0, import_revision_metadata.readRevisionRowsFromStore)(store, {
+            reporting_revision_id: revision.reporting_revision_id,
+            account_id: accountId,
+            offset,
+            limit: maxResults,
+            ...context.signal ? { signal: context.signal } : {}
+          });
+        } catch (error) {
+          if ((0, import_row_storage.isReportingRowStoreError)(error)) {
+            if (error.code === "ROWS_EXPIRED") throw new Error("Reporting revision is unavailable");
+            throw new import_async_outcome.AdcpError("SERVICE_UNAVAILABLE", {
+              message: "Reporting revision rows are temporarily unavailable"
+            });
+          }
+          throw error;
+        }
+        if (!page || page.total !== totalCount) throw new Error("Reporting revision is unavailable");
+        reportingRows = page.rows;
+      }
       const nextOffset = offset + reportingRows.length;
-      const hasMore = nextOffset < revision.rows.length;
+      const hasMore = nextOffset < totalCount;
       return {
         reporting_period: { start: obligation.period.start, end: obligation.period.end },
         media_buy_deliveries: [],
@@ -453,7 +495,7 @@ function createReportingDeliveryHandler(store) {
         errors: [],
         pagination: {
           has_more: hasMore,
-          total_count: revision.rows.length,
+          total_count: totalCount,
           ...hasMore ? {
             cursor: Buffer.from(
               JSON.stringify({ revisionId: revision.reporting_revision_id, offset: nextOffset }),
@@ -966,6 +1008,7 @@ function wireSchedule(obligation) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  REPORTING_STATUS_REVISION_VIEW_MAX_ROWS,
   ReportingReadCapacityError,
   acquireAccountReadSlot,
   aggregateReportingCoverageV1,

package/dist/lib/reporting/ledger/handler.mjs

@@ -18,6 +18,8 @@ import {
   projectReportingObligationHealthV1
 } from "./health.mjs";
 import { compareReportingInstants } from "./instant.mjs";
+import { getRevisionMetadataFromStore, readRevisionRowsFromStore } from "./revision-metadata.mjs";
+import { isReportingRowStoreError } from "./row-storage.mjs";
 import { reportingPeriodSchedule } from "./schedule.mjs";
 import { ReportingLedgerSnapshotUnavailableError } from "./types.mjs";
 function createReportingStatusHandler(store, options) {
@@ -232,11 +234,26 @@ function createReportingStatusHandler(store, options) {
         const id = query.reporting_revision_id;
         const inSnapshot = id ? page.snapshot.revisions.some((value) => value.reporting_revision_id === id) : false;
         let revision = null;
+        let revisionRows;
         if (id && inSnapshot) {
           try {
-            revision = await store.getRevision(id, accountId);
+            revision = await getRevisionMetadataFromStore(store, id, accountId);
+            const rowCount = revision?.binding.rowCount ?? 0;
+            if (revision && rowCount <= REPORTING_STATUS_REVISION_VIEW_MAX_ROWS) {
+              const page2 = rowCount === 0 ? { rows: [], total: 0 } : await readRevisionRowsFromStore(store, {
+                reporting_revision_id: id,
+                account_id: accountId,
+                offset: 0,
+                limit: rowCount,
+                ...context.signal ? { signal: context.signal } : {}
+              });
+              if (!page2 || page2.total !== rowCount) revision = null;
+              else revisionRows = page2.rows;
+            }
           } catch (error) {
-            if (error instanceof ReportingReadCapacityError) return lookupUnavailable(view);
+            if (error instanceof ReportingReadCapacityError || isReportingRowStoreError(error)) {
+              return lookupUnavailable(view);
+            }
             throw error;
           }
         }
@@ -262,7 +279,7 @@ function createReportingStatusHandler(store, options) {
             revision_content_sha256: revision.wireRevision.revision_content_sha256,
             row_count: revision.binding.rowCount
           },
-          reporting_rows: revision.rows,
+          ...revisionRows ? { reporting_rows: revisionRows } : {},
           adjustments: revisionAdjustments.map((value) => value.wireAdjustment),
           ...consumerId ? { consumer_statuses: (page.consumerStatuses ?? []).map(wireConsumerStatus) } : {},
           materializations: (page.materializations ?? []).filter(
@@ -375,6 +392,7 @@ function createReportingStatusHandler(store, options) {
     }
   };
 }
+const REPORTING_STATUS_REVISION_VIEW_MAX_ROWS = 1e4;
 function createReportingDeliveryHandler(store) {
   const activeReadsByAccount = /* @__PURE__ */ new Map();
   return async (request, context) => {
@@ -395,7 +413,7 @@ function createReportingDeliveryHandler(store) {
       if (typeof raw.reporting_revision_id !== "string" || !raw.reporting_revision_id) {
         throw new Error("Ledger delivery reads require reporting_revision_id");
       }
-      const revision = await store.getRevision(raw.reporting_revision_id, accountId);
+      const revision = await getRevisionMetadataFromStore(store, raw.reporting_revision_id, accountId);
       if (!revision) throw new Error("Reporting revision is unavailable");
       const obligation = await store.getObligation(revision.reporting_obligation_id);
       if (!obligation || obligation.account.account_id !== accountId) {
@@ -403,11 +421,12 @@ function createReportingDeliveryHandler(store) {
       }
       const pagination = isRecord(raw.pagination) ? raw.pagination : {};
       const maxResults = typeof pagination.max_results === "number" && Number.isFinite(pagination.max_results) ? Math.max(1, Math.min(500, Math.trunc(pagination.max_results))) : 100;
+      const totalCount = revision.binding.rowCount;
       let offset = 0;
       if (typeof pagination.cursor === "string") {
         try {
           const cursor = JSON.parse(Buffer.from(pagination.cursor, "base64url").toString("utf8"));
-          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= revision.rows.length) {
+          if (cursor.revisionId !== revision.reporting_revision_id || typeof cursor.offset !== "number" || !Number.isSafeInteger(cursor.offset) || cursor.offset < 0 || cursor.offset >= totalCount) {
             throw new Error("invalid");
           }
           offset = cursor.offset;
@@ -415,9 +434,31 @@ function createReportingDeliveryHandler(store) {
           throw new Error("Reporting delivery cursor is invalid");
         }
       }
-      const reportingRows = revision.rows.slice(offset, offset + maxResults);
+      let reportingRows = [];
+      if (totalCount > 0) {
+        let page;
+        try {
+          page = await readRevisionRowsFromStore(store, {
+            reporting_revision_id: revision.reporting_revision_id,
+            account_id: accountId,
+            offset,
+            limit: maxResults,
+            ...context.signal ? { signal: context.signal } : {}
+          });
+        } catch (error) {
+          if (isReportingRowStoreError(error)) {
+            if (error.code === "ROWS_EXPIRED") throw new Error("Reporting revision is unavailable");
+            throw new AdcpError("SERVICE_UNAVAILABLE", {
+              message: "Reporting revision rows are temporarily unavailable"
+            });
+          }
+          throw error;
+        }
+        if (!page || page.total !== totalCount) throw new Error("Reporting revision is unavailable");
+        reportingRows = page.rows;
+      }
       const nextOffset = offset + reportingRows.length;
-      const hasMore = nextOffset < revision.rows.length;
+      const hasMore = nextOffset < totalCount;
       return {
         reporting_period: { start: obligation.period.start, end: obligation.period.end },
         media_buy_deliveries: [],
@@ -437,7 +478,7 @@ function createReportingDeliveryHandler(store) {
         errors: [],
         pagination: {
           has_more: hasMore,
-          total_count: revision.rows.length,
+          total_count: totalCount,
           ...hasMore ? {
             cursor: Buffer.from(
               JSON.stringify({ revisionId: revision.reporting_revision_id, offset: nextOffset }),
@@ -949,6 +990,7 @@ function wireSchedule(obligation) {
   };
 }
 export {
+  REPORTING_STATUS_REVISION_VIEW_MAX_ROWS,
   ReportingReadCapacityError,
   acquireAccountReadSlot,
   aggregateReportingCoverageV1,

package/dist/lib/reporting/ledger/index.d.mts

@@ -11,3 +11,8 @@ export * from './managed.mjs';
 export * from './managed-postgres.mjs';
 export * from './object-writes.mjs';
 export * from './notification-activity.mjs';
+export * from './row-encoding.mjs';
+export * from './row-storage-migration.mjs';
+export * from './row-storage.mjs';
+export * from './row-storage-object.mjs';
+export * from './change-feed.mjs';

package/dist/lib/reporting/ledger/index.d.ts

@@ -11,3 +11,8 @@ export * from './managed';
 export * from './managed-postgres';
 export * from './object-writes';
 export * from './notification-activity';
+export * from './row-encoding';
+export * from './row-storage-migration';
+export * from './row-storage';
+export * from './row-storage-object';
+export * from './change-feed';

package/dist/lib/reporting/ledger/index.js

@@ -28,6 +28,11 @@ __reExport(ledger_exports, require('./managed.js'), module.exports);
 __reExport(ledger_exports, require('./managed-postgres.js'), module.exports);
 __reExport(ledger_exports, require('./object-writes.js'), module.exports);
 __reExport(ledger_exports, require('./notification-activity.js'), module.exports);
+__reExport(ledger_exports, require('./row-encoding.js'), module.exports);
+__reExport(ledger_exports, require('./row-storage-migration.js'), module.exports);
+__reExport(ledger_exports, require('./row-storage.js'), module.exports);
+__reExport(ledger_exports, require('./row-storage-object.js'), module.exports);
+__reExport(ledger_exports, require('./change-feed.js'), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require('./types.js'),
@@ -42,5 +47,10 @@ __reExport(ledger_exports, require('./notification-activity.js'), module.exports
   ...require('./managed.js'),
   ...require('./managed-postgres.js'),
   ...require('./object-writes.js'),
-  ...require('./notification-activity.js')
+  ...require('./notification-activity.js'),
+  ...require('./row-encoding.js'),
+  ...require('./row-storage-migration.js'),
+  ...require('./row-storage.js'),
+  ...require('./row-storage-object.js'),
+  ...require('./change-feed.js')
 });

package/dist/lib/reporting/ledger/index.mjs

@@ -11,3 +11,8 @@ export * from "./managed.mjs";
 export * from "./managed-postgres.mjs";
 export * from "./object-writes.mjs";
 export * from "./notification-activity.mjs";
+export * from "./row-encoding.mjs";
+export * from "./row-storage-migration.mjs";
+export * from "./row-storage.mjs";
+export * from "./row-storage-object.mjs";
+export * from "./change-feed.mjs";

package/dist/lib/reporting/ledger/lifecycle.js

@@ -28,6 +28,7 @@ var import_source = require('../source/index.js');
 var import_handler = require('./handler.js');
 var import_instant = require('./instant.js');
 var import_health = require('./health.js');
+var import_revision_metadata = require('./revision-metadata.js');
 async function resolveLedgerAsOf(input, attempt) {
   const resolved = await input.store.readLedgerInstant?.() ?? (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
   if (input.ledgerAsOf === void 0) return resolved;
@@ -78,7 +79,7 @@ async function reconcileReportingStatusLifecycleV1(input, attempt = 0) {
   const transactionalNotifications = input.store.transactionalNotificationActivity === true;
   assertNotificationModesCompatible(input.store, input.subscribers);
   let ledgerAsOf = await resolveLedgerAsOf(input, attempt);
-  const revisions = await input.store.listRevisions(obligation.reporting_obligation_id);
+  const revisions = await (0, import_revision_metadata.listRevisionMetadataFromStore)(input.store, obligation.reporting_obligation_id);
   let projected = revisions;
   const projectCore = (at) => (0, import_health.projectReportingObligationHealthV1)(
     obligation,
@@ -207,7 +208,7 @@ async function composeManagedLifecycleProjection(input, obligation, revisions, c
     ledgerAsOf: input.ledgerAsOf
   });
   if (!managed) return { projection: coreProjection };
-  const stored = await input.store.listAdjustments(obligation.reporting_obligation_id);
+  const stored = await (0, import_revision_metadata.listAdjustmentMetadataFromStore)(input.store, obligation.reporting_obligation_id);
   const visibleAdjustmentIds = managed.visibleAdjustmentIds;
   const adjustments = visibleAdjustmentIds ? stored.filter((value) => visibleAdjustmentIds.includes(value.reporting_adjustment_id)) : stored.filter((value) => (0, import_instant.compareReportingInstants)(value.createdAt, input.ledgerAsOf) <= 0);
   const rosterAuthoritative = managed.obligatedConsumerRosterComplete === true && managed.receiptEvidenceComplete !== false;

package/dist/lib/reporting/ledger/lifecycle.mjs

@@ -3,6 +3,7 @@ import { canonicalJsonV1 } from "../source/index.mjs";
 import { moreSevereReportingHealthV1, projectManagedDelivery } from "./handler.mjs";
 import { compareReportingInstants } from "./instant.mjs";
 import { projectReportingObligationHealthV1 } from "./health.mjs";
+import { listAdjustmentMetadataFromStore, listRevisionMetadataFromStore } from "./revision-metadata.mjs";
 async function resolveLedgerAsOf(input, attempt) {
   const resolved = await input.store.readLedgerInstant?.() ?? (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
   if (input.ledgerAsOf === void 0) return resolved;
@@ -53,7 +54,7 @@ async function reconcileReportingStatusLifecycleV1(input, attempt = 0) {
   const transactionalNotifications = input.store.transactionalNotificationActivity === true;
   assertNotificationModesCompatible(input.store, input.subscribers);
   let ledgerAsOf = await resolveLedgerAsOf(input, attempt);
-  const revisions = await input.store.listRevisions(obligation.reporting_obligation_id);
+  const revisions = await listRevisionMetadataFromStore(input.store, obligation.reporting_obligation_id);
   let projected = revisions;
   const projectCore = (at) => projectReportingObligationHealthV1(
     obligation,
@@ -182,7 +183,7 @@ async function composeManagedLifecycleProjection(input, obligation, revisions, c
     ledgerAsOf: input.ledgerAsOf
   });
   if (!managed) return { projection: coreProjection };
-  const stored = await input.store.listAdjustments(obligation.reporting_obligation_id);
+  const stored = await listAdjustmentMetadataFromStore(input.store, obligation.reporting_obligation_id);
   const visibleAdjustmentIds = managed.visibleAdjustmentIds;
   const adjustments = visibleAdjustmentIds ? stored.filter((value) => visibleAdjustmentIds.includes(value.reporting_adjustment_id)) : stored.filter((value) => compareReportingInstants(value.createdAt, input.ledgerAsOf) <= 0);
   const rosterAuthoritative = managed.obligatedConsumerRosterComplete === true && managed.receiptEvidenceComplete !== false;

package/dist/lib/reporting/ledger/managed-postgres.d.mts

@@ -94,6 +94,8 @@ export declare class PostgresReportingManagedDeliveryStore implements ReportingM
     private validateRecoveryWindow;
     private readPolicyRow;
     private readPolicy;
+    /** Read-only access to PostgreSQL row chunks for claim hydration. */
+    private readonly rowStorage;
     constructor(pool: ReportingPgPool, options?: PostgresReportingManagedDeliveryStoreOptions);
     /** SQL fragment scoping a count to the active retention window, if one is set. */
     private activeScope;

package/dist/lib/reporting/ledger/managed-postgres.d.ts

@@ -94,6 +94,8 @@ export declare class PostgresReportingManagedDeliveryStore implements ReportingM
     private validateRecoveryWindow;
     private readPolicyRow;
     private readPolicy;
+    /** Read-only access to PostgreSQL row chunks for claim hydration. */
+    private readonly rowStorage;
     constructor(pool: ReportingPgPool, options?: PostgresReportingManagedDeliveryStoreOptions);
     /** SQL fragment scoping a count to the active retention window, if one is set. */
     private activeScope;

package/dist/lib/reporting/ledger/managed-postgres.js

@@ -26,6 +26,7 @@ var import_node_crypto = require("node:crypto");
 var import_jcs = require('../../utils/jcs.js');
 var import_evidence = require('../evidence.js');
 var import_types = require('./types.js');
+var import_row_storage = require('./row-storage.js');
 var import_object_writes = require('./object-writes.js');
 var import_managed = require('./managed.js');
 const REPORTING_MANAGED_DELIVERY_MIGRATION = `
@@ -252,6 +253,7 @@ const MAX_RECEIPT_BATCH_RESULT_BYTES = 64 * 1024;
 class PostgresReportingManagedDeliveryStore {
   constructor(pool, options = {}) {
     this.pool = pool;
+    this.rowStorage = new import_row_storage.ReportingRowStorageV1(pool);
     if (options.statusRetentionDays !== void 0) positiveInteger(options.statusRetentionDays, "statusRetentionDays");
     if (options.evidenceRetentionDays !== void 0) {
       positiveInteger(options.evidenceRetentionDays, "evidenceRetentionDays");
@@ -466,6 +468,8 @@ class PostgresReportingManagedDeliveryStore {
       authorizationRevocationSeconds: policy.advertised_authorization_revocation_seconds
     };
   }
+  /** Read-only access to PostgreSQL row chunks for claim hydration. */
+  rowStorage;
   /** SQL fragment scoping a count to the active retention window, if one is set. */
   activeScope(column) {
     return this.evidenceRetentionDays === void 0 ? "" : ` AND ${column} >= clock_timestamp() - (${this.evidenceRetentionDays}::bigint * INTERVAL '1 day')`;
@@ -987,7 +991,7 @@ class PostgresReportingManagedDeliveryStore {
         ])
       );
       const candidates = await client.query(
-        `SELECT binding.data AS binding, obligation.data AS obligation, revision.data AS revision,
+        `SELECT binding.data AS binding, obligation.data AS obligation, revision.revision_id AS revision_id,
                 GREATEST(COALESCE(MAX(existing.attempt), 0), COALESCE(MAX(tomb.highest_attempt), 0))::integer + 1
                   AS attempt
            FROM adcp_reporting_managed_bindings binding
@@ -1007,7 +1011,7 @@ class PostgresReportingManagedDeliveryStore {
              ON tomb.configuration_id = binding.configuration_id AND tomb.revision_id = revision.revision_id
           WHERE ($1::text IS NULL OR binding.account_id = $1)
           GROUP BY binding.configuration_id, binding.data, obligation.obligation_id, obligation.data,
-                   revision.revision_id, revision.data
+                   revision.revision_id
          HAVING NOT COALESCE(BOOL_OR(existing.status IN ('pending','available','delivered')), false)
             AND NOT COALESCE(BOOL_OR(tomb.reached_success), false)
             AND GREATEST(COALESCE(MAX(existing.attempt), 0), COALESCE(MAX(tomb.highest_attempt), 0))
@@ -1022,11 +1026,11 @@ class PostgresReportingManagedDeliveryStore {
         const remaining = remainingByAccount.get(binding.account_id) ?? 0;
         if (remaining <= 0) continue;
         const obligation = candidate.obligation;
-        const revision = candidate.revision;
+        const revisionId = candidate.revision_id;
         const created_at = (/* @__PURE__ */ new Date()).toISOString();
         const materialization = {
           reporting_materialization_id: `rmat_${(0, import_node_crypto.randomUUID)()}`,
-          reporting_revision_id: revision.reporting_revision_id,
+          reporting_revision_id: revisionId,
           reporting_obligation_id: obligation.reporting_obligation_id,
           delivery_config_id: binding.delivery_config_id,
           delivery_config_version: binding.delivery_config_version,
@@ -1049,7 +1053,7 @@ class PostgresReportingManagedDeliveryStore {
             binding.account_id,
             binding.configurationId,
             obligation.reporting_obligation_id,
-            revision.reporting_revision_id,
+            revisionId,
             binding.destination_ref,
             binding.authorization_generation,
             candidate.attempt,
@@ -1171,7 +1175,7 @@ class PostgresReportingManagedDeliveryStore {
   }
   async claimMaterialization(input) {
     positiveInteger(input.lease_milliseconds, "lease_milliseconds");
-    return this.transaction(async (client) => {
+    const lease = await this.transaction(async (client) => {
       const selected = await client.query(
         `WITH candidate AS (
            SELECT materialization.materialization_id
@@ -1227,6 +1231,22 @@ class PostgresReportingManagedDeliveryStore {
         expires_at: row.expires_at.toISOString()
       };
     });
+    if (!lease || Array.isArray(lease.revision.rows)) return lease;
+    try {
+      const handle = await this.rowStorage.find(
+        lease.revision.reporting_revision_id,
+        lease.obligation.account.account_id
+      );
+      if (handle?.kind === "postgres") {
+        lease.revision = {
+          ...lease.revision,
+          rows: await this.rowStorage.readAll(handle, lease.revision.wireRevision.control_totals)
+        };
+      }
+    } catch (error) {
+      if (!(0, import_row_storage.isReportingRowStoreError)(error)) throw error;
+    }
+    return lease;
   }
   /**
    * Fails materializations that have used every delivery attempt.

package/dist/lib/reporting/ledger/managed-postgres.mjs

@@ -2,6 +2,7 @@ import { createHash, randomUUID } from "node:crypto";
 import { canonicalize } from "../../utils/jcs.mjs";
 import { isReportingAdjustmentReceiptEvidence, isReportingReceiptEvidence } from "../evidence.mjs";
 import { REPORTING_LEDGER_AUTHORITY } from "./types.mjs";
+import { ReportingRowStorageV1, isReportingRowStoreError } from "./row-storage.mjs";
 import {
   assertReportingObjectWriteScope,
   reportingObjectWritePlanFingerprint,
@@ -237,6 +238,7 @@ const MAX_RECEIPT_BATCH_RESULT_BYTES = 64 * 1024;
 class PostgresReportingManagedDeliveryStore {
   constructor(pool, options = {}) {
     this.pool = pool;
+    this.rowStorage = new ReportingRowStorageV1(pool);
     if (options.statusRetentionDays !== void 0) positiveInteger(options.statusRetentionDays, "statusRetentionDays");
     if (options.evidenceRetentionDays !== void 0) {
       positiveInteger(options.evidenceRetentionDays, "evidenceRetentionDays");
@@ -451,6 +453,8 @@ class PostgresReportingManagedDeliveryStore {
       authorizationRevocationSeconds: policy.advertised_authorization_revocation_seconds
     };
   }
+  /** Read-only access to PostgreSQL row chunks for claim hydration. */
+  rowStorage;
   /** SQL fragment scoping a count to the active retention window, if one is set. */
   activeScope(column) {
     return this.evidenceRetentionDays === void 0 ? "" : ` AND ${column} >= clock_timestamp() - (${this.evidenceRetentionDays}::bigint * INTERVAL '1 day')`;
@@ -972,7 +976,7 @@ class PostgresReportingManagedDeliveryStore {
         ])
       );
       const candidates = await client.query(
-        `SELECT binding.data AS binding, obligation.data AS obligation, revision.data AS revision,
+        `SELECT binding.data AS binding, obligation.data AS obligation, revision.revision_id AS revision_id,
                 GREATEST(COALESCE(MAX(existing.attempt), 0), COALESCE(MAX(tomb.highest_attempt), 0))::integer + 1
                   AS attempt
            FROM adcp_reporting_managed_bindings binding
@@ -992,7 +996,7 @@ class PostgresReportingManagedDeliveryStore {
              ON tomb.configuration_id = binding.configuration_id AND tomb.revision_id = revision.revision_id
           WHERE ($1::text IS NULL OR binding.account_id = $1)
           GROUP BY binding.configuration_id, binding.data, obligation.obligation_id, obligation.data,
-                   revision.revision_id, revision.data
+                   revision.revision_id
          HAVING NOT COALESCE(BOOL_OR(existing.status IN ('pending','available','delivered')), false)
             AND NOT COALESCE(BOOL_OR(tomb.reached_success), false)
             AND GREATEST(COALESCE(MAX(existing.attempt), 0), COALESCE(MAX(tomb.highest_attempt), 0))
@@ -1007,11 +1011,11 @@ class PostgresReportingManagedDeliveryStore {
         const remaining = remainingByAccount.get(binding.account_id) ?? 0;
         if (remaining <= 0) continue;
         const obligation = candidate.obligation;
-        const revision = candidate.revision;
+        const revisionId = candidate.revision_id;
         const created_at = (/* @__PURE__ */ new Date()).toISOString();
         const materialization = {
           reporting_materialization_id: `rmat_${randomUUID()}`,
-          reporting_revision_id: revision.reporting_revision_id,
+          reporting_revision_id: revisionId,
           reporting_obligation_id: obligation.reporting_obligation_id,
           delivery_config_id: binding.delivery_config_id,
           delivery_config_version: binding.delivery_config_version,
@@ -1034,7 +1038,7 @@ class PostgresReportingManagedDeliveryStore {
             binding.account_id,
             binding.configurationId,
             obligation.reporting_obligation_id,
-            revision.reporting_revision_id,
+            revisionId,
             binding.destination_ref,
             binding.authorization_generation,
             candidate.attempt,
@@ -1156,7 +1160,7 @@ class PostgresReportingManagedDeliveryStore {
   }
   async claimMaterialization(input) {
     positiveInteger(input.lease_milliseconds, "lease_milliseconds");
-    return this.transaction(async (client) => {
+    const lease = await this.transaction(async (client) => {
       const selected = await client.query(
         `WITH candidate AS (
            SELECT materialization.materialization_id
@@ -1212,6 +1216,22 @@ class PostgresReportingManagedDeliveryStore {
         expires_at: row.expires_at.toISOString()
       };
     });
+    if (!lease || Array.isArray(lease.revision.rows)) return lease;
+    try {
+      const handle = await this.rowStorage.find(
+        lease.revision.reporting_revision_id,
+        lease.obligation.account.account_id
+      );
+      if (handle?.kind === "postgres") {
+        lease.revision = {
+          ...lease.revision,
+          rows: await this.rowStorage.readAll(handle, lease.revision.wireRevision.control_totals)
+        };
+      }
+    } catch (error) {
+      if (!isReportingRowStoreError(error)) throw error;
+    }
+    return lease;
   }
   /**
    * Fails materializations that have used every delivery attempt.

package/dist/lib/reporting/ledger/managed.d.mts

@@ -258,6 +258,15 @@ export interface ReportingManagedDeliveryWorkerOptionsV1 {
      */
     authorizationRevocationSeconds?: number;
     account_id?: string;
+    /**
+     * Loads verified rows for a claimed revision whose rows live in row storage
+     * rather than in the ledger document. `createReportingManagedDeliveryRuntime`
+     * supplies one backed by its Core store. PostgreSQL-kind chunks are
+     * hydrated by the managed store's claim itself; a direct caller whose rows
+     * live in an external binding must supply this, or the adapter receives a
+     * revision without rows.
+     */
+    hydrateRevision?: (revision: ReportingManagedDeliveryLeaseV1['revision'], account_id: string, signal: AbortSignal | undefined) => Promise<ReportingManagedDeliveryLeaseV1['revision']>;
 }
 export interface CreateReportingManagedDeliveryRuntimeOptionsV1<TContext extends {
     account?: unknown;

package/dist/lib/reporting/ledger/managed.d.ts

@@ -258,6 +258,15 @@ export interface ReportingManagedDeliveryWorkerOptionsV1 {
      */
     authorizationRevocationSeconds?: number;
     account_id?: string;
+    /**
+     * Loads verified rows for a claimed revision whose rows live in row storage
+     * rather than in the ledger document. `createReportingManagedDeliveryRuntime`
+     * supplies one backed by its Core store. PostgreSQL-kind chunks are
+     * hydrated by the managed store's claim itself; a direct caller whose rows
+     * live in an external binding must supply this, or the adapter receives a
+     * revision without rows.
+     */
+    hydrateRevision?: (revision: ReportingManagedDeliveryLeaseV1['revision'], account_id: string, signal: AbortSignal | undefined) => Promise<ReportingManagedDeliveryLeaseV1['revision']>;
 }
 export interface CreateReportingManagedDeliveryRuntimeOptionsV1<TContext extends {
     account?: unknown;