@adcp/sdk 15.3.0 → 15.4.0

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

@@ -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.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,7 @@ 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_schedule = require('./schedule.js');
 var import_types = require('./types.js');
 function createReportingStatusHandler(store, options) {
@@ -248,9 +250,22 @@ 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);
             throw error;
@@ -278,7 +293,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 +406,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 +427,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 +435,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 +448,20 @@ function createReportingDeliveryHandler(store) {
           throw new Error("Reporting delivery cursor is invalid");
         }
       }
-      const reportingRows = revision.rows.slice(offset, offset + maxResults);
+      let reportingRows = [];
+      if (totalCount > 0) {
+        const 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 } : {}
+        });
+        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 +481,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 +994,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,7 @@ import {
   projectReportingObligationHealthV1
 } from "./health.mjs";
 import { compareReportingInstants } from "./instant.mjs";
+import { getRevisionMetadataFromStore, readRevisionRowsFromStore } from "./revision-metadata.mjs";
 import { reportingPeriodSchedule } from "./schedule.mjs";
 import { ReportingLedgerSnapshotUnavailableError } from "./types.mjs";
 function createReportingStatusHandler(store, options) {
@@ -232,9 +233,22 @@ 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);
             throw error;
@@ -262,7 +276,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 +389,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 +410,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 +418,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 +431,20 @@ function createReportingDeliveryHandler(store) {
           throw new Error("Reporting delivery cursor is invalid");
         }
       }
-      const reportingRows = revision.rows.slice(offset, offset + maxResults);
+      let reportingRows = [];
+      if (totalCount > 0) {
+        const page = await readRevisionRowsFromStore(store, {
+          reporting_revision_id: revision.reporting_revision_id,
+          account_id: accountId,
+          offset,
+          limit: maxResults,
+          ...context.signal ? { signal: context.signal } : {}
+        });
+        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 +464,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 +976,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,4 @@ export * from './managed.mjs';
 export * from './managed-postgres.mjs';
 export * from './object-writes.mjs';
 export * from './notification-activity.mjs';
+export * from './row-encoding.mjs';

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

@@ -11,3 +11,4 @@ export * from './managed';
 export * from './managed-postgres';
 export * from './object-writes';
 export * from './notification-activity';
+export * from './row-encoding';

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

@@ -28,6 +28,7 @@ __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);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require('./types.js'),
@@ -42,5 +43,6 @@ __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')
 });

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

@@ -11,3 +11,4 @@ export * from "./managed.mjs";
 export * from "./managed-postgres.mjs";
 export * from "./object-writes.mjs";
 export * from "./notification-activity.mjs";
+export * from "./row-encoding.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.js

@@ -987,7 +987,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 +1007,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 +1022,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 +1049,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,

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

@@ -972,7 +972,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 +992,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 +1007,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 +1034,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,

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

@@ -1,5 +1,5 @@
 import { REPORTING_LEDGER_AUTHORITY } from './types.mjs';
-import type { ReportingLedgerConfigurationV1, ReportingLedgerAdjustmentV1, ReportingLedgerConsumerStatusV1, ReportingLedgerIssueV1, ReportingLedgerLeaseV1, ReportingLedgerObligationV1, ReportingLedgerPageV1, ReportingLedgerRevisionV1, ReportingLedgerSnapshotQueryV1, ReportingLedgerSnapshotV1, ReportingLedgerStatusTransitionV1, ReportingLedgerNotificationActivityPortV1, ReportingLedgerTransactionV1, ReportingObservedFinalityV1, ReportingLedgerStore, ReportingConsumerStatusBatchInputV1, ReportingConsumerStatusBatchResultV1, ReportingConsumerStatusReplayInputV1, ReportingLedgerRevisionMetadataV1, ReportingManagedLifecycleProjectionV1, ReportingLedgerAuthorityV1 } from './types.mjs';
+import type { ReportingLedgerConfigurationV1, ReportingLedgerAdjustmentMetadataV1, ReportingLedgerAdjustmentV1, ReportingLedgerConsumerStatusV1, ReportingLedgerIssueV1, ReportingLedgerLeaseV1, ReportingLedgerObligationV1, ReportingLedgerPageV1, ReportingLedgerRevisionV1, ReportingLedgerSnapshotQueryV1, ReportingLedgerSnapshotV1, ReportingLedgerStatusTransitionV1, ReportingLedgerNotificationActivityPortV1, ReportingLedgerTransactionV1, ReportingObservedFinalityV1, ReportingLedgerStore, ReportingConsumerStatusBatchInputV1, ReportingConsumerStatusBatchResultV1, ReportingConsumerStatusReplayInputV1, ReportingLedgerRevisionMetadataV1, ReportingRevisionRowsPageV1, ReportingRevisionRowsReadV1, ReportingManagedLifecycleProjectionV1, ReportingLedgerAuthorityV1 } from './types.mjs';
 import type { ReportingConsumerMismatchEscalationV1 } from './types.mjs';
 type QueryResultRow = Record<string, unknown>;
 interface ReportingPgResult<Row extends QueryResultRow> {
@@ -144,12 +144,15 @@ export declare class PostgresReportingLedgerStore implements ReportingLedgerStor
     }>;
     getRevision(id: string, accountId: string): Promise<ReportingLedgerRevisionV1 | null>;
     getRevisionMetadata(id: string, accountId: string): Promise<ReportingLedgerRevisionMetadataV1 | null>;
+    readRevisionRows(input: ReportingRevisionRowsReadV1): Promise<ReportingRevisionRowsPageV1 | null>;
     listRevisions(obligationId: string): Promise<ReportingLedgerRevisionV1[]>;
+    listRevisionMetadata(obligationId: string, accountId?: string): Promise<ReportingLedgerRevisionMetadataV1[]>;
     commitAdjustment(adjustment: ReportingLedgerAdjustmentV1, lease: ReportingLedgerLeaseV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerAdjustmentV1;
     }>;
     listAdjustments(obligationId: string): Promise<ReportingLedgerAdjustmentV1[]>;
+    listAdjustmentMetadata(obligationId: string): Promise<ReportingLedgerAdjustmentMetadataV1[]>;
     putConsumerStatus(status: ReportingLedgerConsumerStatusV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerConsumerStatusV1;

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

@@ -1,5 +1,5 @@
 import { REPORTING_LEDGER_AUTHORITY } from './types';
-import type { ReportingLedgerConfigurationV1, ReportingLedgerAdjustmentV1, ReportingLedgerConsumerStatusV1, ReportingLedgerIssueV1, ReportingLedgerLeaseV1, ReportingLedgerObligationV1, ReportingLedgerPageV1, ReportingLedgerRevisionV1, ReportingLedgerSnapshotQueryV1, ReportingLedgerSnapshotV1, ReportingLedgerStatusTransitionV1, ReportingLedgerNotificationActivityPortV1, ReportingLedgerTransactionV1, ReportingObservedFinalityV1, ReportingLedgerStore, ReportingConsumerStatusBatchInputV1, ReportingConsumerStatusBatchResultV1, ReportingConsumerStatusReplayInputV1, ReportingLedgerRevisionMetadataV1, ReportingManagedLifecycleProjectionV1, ReportingLedgerAuthorityV1 } from './types';
+import type { ReportingLedgerConfigurationV1, ReportingLedgerAdjustmentMetadataV1, ReportingLedgerAdjustmentV1, ReportingLedgerConsumerStatusV1, ReportingLedgerIssueV1, ReportingLedgerLeaseV1, ReportingLedgerObligationV1, ReportingLedgerPageV1, ReportingLedgerRevisionV1, ReportingLedgerSnapshotQueryV1, ReportingLedgerSnapshotV1, ReportingLedgerStatusTransitionV1, ReportingLedgerNotificationActivityPortV1, ReportingLedgerTransactionV1, ReportingObservedFinalityV1, ReportingLedgerStore, ReportingConsumerStatusBatchInputV1, ReportingConsumerStatusBatchResultV1, ReportingConsumerStatusReplayInputV1, ReportingLedgerRevisionMetadataV1, ReportingRevisionRowsPageV1, ReportingRevisionRowsReadV1, ReportingManagedLifecycleProjectionV1, ReportingLedgerAuthorityV1 } from './types';
 import type { ReportingConsumerMismatchEscalationV1 } from './types';
 type QueryResultRow = Record<string, unknown>;
 interface ReportingPgResult<Row extends QueryResultRow> {
@@ -144,12 +144,15 @@ export declare class PostgresReportingLedgerStore implements ReportingLedgerStor
     }>;
     getRevision(id: string, accountId: string): Promise<ReportingLedgerRevisionV1 | null>;
     getRevisionMetadata(id: string, accountId: string): Promise<ReportingLedgerRevisionMetadataV1 | null>;
+    readRevisionRows(input: ReportingRevisionRowsReadV1): Promise<ReportingRevisionRowsPageV1 | null>;
     listRevisions(obligationId: string): Promise<ReportingLedgerRevisionV1[]>;
+    listRevisionMetadata(obligationId: string, accountId?: string): Promise<ReportingLedgerRevisionMetadataV1[]>;
     commitAdjustment(adjustment: ReportingLedgerAdjustmentV1, lease: ReportingLedgerLeaseV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerAdjustmentV1;
     }>;
     listAdjustments(obligationId: string): Promise<ReportingLedgerAdjustmentV1[]>;
+    listAdjustmentMetadata(obligationId: string): Promise<ReportingLedgerAdjustmentMetadataV1[]>;
     putConsumerStatus(status: ReportingLedgerConsumerStatusV1): Promise<{
         inserted: boolean;
         value: ReportingLedgerConsumerStatusV1;

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

@@ -695,6 +695,26 @@ ${managedDueArm}       )
       [id, accountId]
     );
   }
+  async readRevisionRows(input) {
+    if (!Number.isSafeInteger(input.offset) || input.offset < 0 || !Number.isSafeInteger(input.limit) || input.limit < 1) {
+      throw new RangeError("Reporting row page bounds are invalid");
+    }
+    const result = await this.query(
+      `SELECT jsonb_array_length(revision.data->'rows') AS total,
+              jsonb_path_query_array(
+                revision.data->'rows',
+                '$[$from to $to]',
+                jsonb_build_object('from', $3::bigint, 'to', $3::bigint + $4::bigint - 1)
+              ) AS rows
+         FROM adcp_reporting_revisions revision
+         JOIN adcp_reporting_obligations obligation ON obligation.obligation_id = revision.obligation_id
+        WHERE revision.revision_id = $1 AND obligation.account_id = $2`,
+      [input.reporting_revision_id, input.account_id, input.offset, input.limit]
+    );
+    const row = result.rows[0];
+    if (!row) return null;
+    return { rows: clone(row.rows), total: Number(row.total) };
+  }
   async listRevisions(obligationId) {
     const result = await this.query(
       `SELECT data FROM adcp_reporting_revisions WHERE obligation_id = $1
@@ -703,6 +723,16 @@ ${managedDueArm}       )
     );
     return result.rows.map((row) => clone(row.data));
   }
+  async listRevisionMetadata(obligationId, accountId) {
+    const result = await this.query(
+      `SELECT revision.data - 'rows' AS data FROM adcp_reporting_revisions revision
+         JOIN adcp_reporting_obligations obligation ON obligation.obligation_id = revision.obligation_id
+        WHERE revision.obligation_id = $1 AND ($2::text IS NULL OR obligation.account_id = $2)
+        ORDER BY revision.revision_number, revision.revision_id`,
+      [obligationId, accountId ?? null]
+    );
+    return result.rows.map((row) => clone(row.data));
+  }
   async commitAdjustment(adjustment, lease) {
     assertLeaseTarget(adjustment.reporting_obligation_id, lease);
     validateBoundRows(adjustment);
@@ -766,6 +796,14 @@ ${managedDueArm}       )
     );
     return result.rows.map((row) => clone(row.data));
   }
+  async listAdjustmentMetadata(obligationId) {
+    const result = await this.query(
+      `SELECT data - 'rows' AS data FROM adcp_reporting_adjustments WHERE obligation_id = $1
+        ORDER BY adjustment_number, adjustment_id`,
+      [obligationId]
+    );
+    return result.rows.map((row) => clone(row.data));
+  }
   async putConsumerStatus(status) {
     const obligation = await this.getObligation(status.reporting_obligation_id);
     if (!obligation) throw new Error("Reporting consumer status obligation is unavailable");

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

@@ -686,6 +686,26 @@ ${managedDueArm}       )
       [id, accountId]
     );
   }
+  async readRevisionRows(input) {
+    if (!Number.isSafeInteger(input.offset) || input.offset < 0 || !Number.isSafeInteger(input.limit) || input.limit < 1) {
+      throw new RangeError("Reporting row page bounds are invalid");
+    }
+    const result = await this.query(
+      `SELECT jsonb_array_length(revision.data->'rows') AS total,
+              jsonb_path_query_array(
+                revision.data->'rows',
+                '$[$from to $to]',
+                jsonb_build_object('from', $3::bigint, 'to', $3::bigint + $4::bigint - 1)
+              ) AS rows
+         FROM adcp_reporting_revisions revision
+         JOIN adcp_reporting_obligations obligation ON obligation.obligation_id = revision.obligation_id
+        WHERE revision.revision_id = $1 AND obligation.account_id = $2`,
+      [input.reporting_revision_id, input.account_id, input.offset, input.limit]
+    );
+    const row = result.rows[0];
+    if (!row) return null;
+    return { rows: clone(row.rows), total: Number(row.total) };
+  }
   async listRevisions(obligationId) {
     const result = await this.query(
       `SELECT data FROM adcp_reporting_revisions WHERE obligation_id = $1
@@ -694,6 +714,16 @@ ${managedDueArm}       )
     );
     return result.rows.map((row) => clone(row.data));
   }
+  async listRevisionMetadata(obligationId, accountId) {
+    const result = await this.query(
+      `SELECT revision.data - 'rows' AS data FROM adcp_reporting_revisions revision
+         JOIN adcp_reporting_obligations obligation ON obligation.obligation_id = revision.obligation_id
+        WHERE revision.obligation_id = $1 AND ($2::text IS NULL OR obligation.account_id = $2)
+        ORDER BY revision.revision_number, revision.revision_id`,
+      [obligationId, accountId ?? null]
+    );
+    return result.rows.map((row) => clone(row.data));
+  }
   async commitAdjustment(adjustment, lease) {
     assertLeaseTarget(adjustment.reporting_obligation_id, lease);
     validateBoundRows(adjustment);
@@ -757,6 +787,14 @@ ${managedDueArm}       )
     );
     return result.rows.map((row) => clone(row.data));
   }
+  async listAdjustmentMetadata(obligationId) {
+    const result = await this.query(
+      `SELECT data - 'rows' AS data FROM adcp_reporting_adjustments WHERE obligation_id = $1
+        ORDER BY adjustment_number, adjustment_id`,
+      [obligationId]
+    );
+    return result.rows.map((row) => clone(row.data));
+  }
   async putConsumerStatus(status) {
     const obligation = await this.getObligation(status.reporting_obligation_id);
     if (!obligation) throw new Error("Reporting consumer status obligation is unavailable");

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

@@ -32,6 +32,7 @@ var import_source = require('../source/index.js');
 var import_coverage = require('./coverage.js');
 var import_schedule = require('./schedule.js');
 var import_lifecycle = require('./lifecycle.js');
+var import_revision_metadata = require('./revision-metadata.js');
 const DEFAULT_LEASE_MS = 3e5;
 const EXECUTION_DEADLINE_MS = 24e4;
 const DEFAULT_SETTLEMENT_GRACE_MS = 1e4;
@@ -268,8 +269,8 @@ function createReportingProducer(options) {
               );
             }
           }
-          const previous = await options.store.listRevisions(obligation.reporting_obligation_id);
-          const adjustments = await options.store.listAdjustments(obligation.reporting_obligation_id);
+          const previous = await (0, import_revision_metadata.listRevisionMetadataFromStore)(options.store, obligation.reporting_obligation_id);
+          const adjustments = await (0, import_revision_metadata.listAdjustmentMetadataFromStore)(options.store, obligation.reporting_obligation_id);
           const publicationCount = previous.length + adjustments.length;
           if (publicationCount > 0) {
             const scheduledAt = nextPublicationAt(obligation, publicationCount);

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

@@ -28,6 +28,7 @@ import {
   reconcileReportingStatusLifecycleV1,
   retryReportingStatusNotificationsV1
 } from "./lifecycle.mjs";
+import { listAdjustmentMetadataFromStore, listRevisionMetadataFromStore } from "./revision-metadata.mjs";
 const DEFAULT_LEASE_MS = 3e5;
 const EXECUTION_DEADLINE_MS = 24e4;
 const DEFAULT_SETTLEMENT_GRACE_MS = 1e4;
@@ -264,8 +265,8 @@ function createReportingProducer(options) {
               );
             }
           }
-          const previous = await options.store.listRevisions(obligation.reporting_obligation_id);
-          const adjustments = await options.store.listAdjustments(obligation.reporting_obligation_id);
+          const previous = await listRevisionMetadataFromStore(options.store, obligation.reporting_obligation_id);
+          const adjustments = await listAdjustmentMetadataFromStore(options.store, obligation.reporting_obligation_id);
           const publicationCount = previous.length + adjustments.length;
           if (publicationCount > 0) {
             const scheduledAt = nextPublicationAt(obligation, publicationCount);