@adcp/sdk 17.0.0-beta.29 → 17.0.0-beta.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/lib/reporting/ledger/handler.d.mts +4 -4
- package/dist/lib/reporting/ledger/handler.d.ts +4 -4
- package/dist/lib/reporting/ledger/handler.js +22 -5
- package/dist/lib/reporting/ledger/handler.mjs +22 -5
- package/dist/lib/reporting/ledger/producer.js +85 -10
- package/dist/lib/reporting/ledger/producer.mjs +85 -10
- package/dist/lib/reporting/ledger/types.d.mts +12 -1
- package/dist/lib/reporting/ledger/types.d.ts +12 -1
- package/dist/lib/reporting/service/index.d.mts +2 -1
- package/dist/lib/reporting/service/index.d.ts +2 -1
- package/dist/lib/reporting/service/index.js +37 -5
- package/dist/lib/reporting/service/index.mjs +37 -5
- package/dist/lib/reporting/source/fixtures.d.mts +4 -0
- package/dist/lib/reporting/source/fixtures.d.ts +4 -0
- package/dist/lib/reporting/source/inline.d.mts +5 -0
- package/dist/lib/reporting/source/inline.d.ts +5 -0
- package/dist/lib/reporting/source/inline.js +93 -13
- package/dist/lib/reporting/source/inline.mjs +93 -13
- package/dist/lib/reporting/source/schemas/reporting-source-slice-request-v1.json +24 -0
- package/dist/lib/reporting/source/source.d.mts +8 -0
- package/dist/lib/reporting/source/source.d.ts +8 -0
- package/dist/lib/reporting/source/source.js +18 -0
- package/dist/lib/reporting/source/source.mjs +18 -0
- package/dist/lib/testing/storyboard/validations.d.mts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +1 -1
- package/dist/lib/version.d.mts +3 -3
- package/dist/lib/version.d.ts +3 -3
- package/dist/lib/version.js +3 -3
- package/dist/lib/version.mjs +3 -3
- package/docs/TYPE-SUMMARY.md +5 -3
- package/docs/guides/REPORTING-SOURCE-EXECUTOR.md +9 -1
- package/docs/llms.txt +1 -1
- package/docs/migration-14.x-rc-worksheet.md +4 -4
- package/package.json +1 -1
|
@@ -148,7 +148,12 @@ function createInlineExecutorWithCapacities(deliveryFetch, offeringInput, execut
|
|
|
148
148
|
}
|
|
149
149
|
const offering = ReportingSourceOfferingV1Schema.parse({
|
|
150
150
|
...parsedOffering,
|
|
151
|
-
applicability: {
|
|
151
|
+
applicability: {
|
|
152
|
+
...parsedOffering.applicability,
|
|
153
|
+
constituentKinds: parsedOffering.applicability.constituentKinds.filter(
|
|
154
|
+
(kind) => kind === "media_buy" || kind === "package_item"
|
|
155
|
+
)
|
|
156
|
+
},
|
|
152
157
|
formats: [format],
|
|
153
158
|
sourceExecution: {
|
|
154
159
|
...parsedOffering.sourceExecution,
|
|
@@ -191,6 +196,13 @@ function createInlineExecutorWithCapacities(deliveryFetch, offeringInput, execut
|
|
|
191
196
|
if (request.sourceRequest.groupIds.length > 0) {
|
|
192
197
|
return failure("UNSUPPORTED_OFFERING", "terminal", "Inline reporting does not support source group reads");
|
|
193
198
|
}
|
|
199
|
+
if (request.coverage.constituents.some((constituent) => constituent.constituentKind === "package_item") && (request.coverage.packageBindings === void 0 || !request.requestedDimensions.includes("package_id"))) {
|
|
200
|
+
return failure(
|
|
201
|
+
"UNSUPPORTED_OFFERING",
|
|
202
|
+
"terminal",
|
|
203
|
+
"Inline package reporting requires bound package items and package_id"
|
|
204
|
+
);
|
|
205
|
+
}
|
|
194
206
|
let deliveryDates;
|
|
195
207
|
try {
|
|
196
208
|
deliveryDates = inlineDeliveryDates(request);
|
|
@@ -313,16 +325,22 @@ function createInlineExecutorWithCapacities(deliveryFetch, offeringInput, execut
|
|
|
313
325
|
return executor;
|
|
314
326
|
}
|
|
315
327
|
async function executeAndSeal(deliveryFetch, offering, format, request, deliveryDates, deadlineAt, signal, storage, executionNamespace, scopeKey, capacities, reclaimer, observer, clock) {
|
|
328
|
+
const packageMediaBuyByConstituentId = new Map(
|
|
329
|
+
(request.coverage.packageBindings ?? []).map((binding) => [binding.constituentId, binding.mediaBuyId])
|
|
330
|
+
);
|
|
316
331
|
let fetched;
|
|
317
332
|
try {
|
|
318
333
|
fetched = await deliveryFetch(
|
|
319
334
|
{
|
|
320
335
|
account: structuredClone(request.account),
|
|
321
336
|
media_buy_ids: [...request.coverage.mediaBuyIds],
|
|
322
|
-
constituents: request.coverage.constituents.map(
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
337
|
+
constituents: request.coverage.constituents.map(
|
|
338
|
+
(constituent) => constituent.constituentKind === "package_item" ? {
|
|
339
|
+
constituent_id: constituent.constituentId,
|
|
340
|
+
media_buy_id: packageMediaBuyByConstituentId.get(constituent.constituentId),
|
|
341
|
+
package_id: constituent.packageId
|
|
342
|
+
} : { constituent_id: constituent.constituentId, media_buy_id: constituent.mediaBuyId }
|
|
343
|
+
),
|
|
326
344
|
start_date: deliveryDates.start,
|
|
327
345
|
end_date: deliveryDates.end,
|
|
328
346
|
source_read_cutoff_at: request.period.sourceReadCutoffAt,
|
|
@@ -475,6 +493,13 @@ async function executeAndSeal(deliveryFetch, offering, format, request, delivery
|
|
|
475
493
|
return failure("INTEGRITY_FAILED", "terminal", "Inline delivery availability evidence is invalid");
|
|
476
494
|
}
|
|
477
495
|
}
|
|
496
|
+
if (request.coverage.packageIds.length > 0 && availabilityEvidence === void 0) {
|
|
497
|
+
return failure(
|
|
498
|
+
"UNSUPPORTED_OFFERING",
|
|
499
|
+
"terminal",
|
|
500
|
+
"Package reporting requires an object response with availability_evidence"
|
|
501
|
+
);
|
|
502
|
+
}
|
|
478
503
|
const captureLayout = captureLayoutFor(request);
|
|
479
504
|
const claimBearingRowCount = sourceRowInputs.length + (availabilityEvidenceSlot.kind === "data" ? auxiliaryRowInputs.length : 0);
|
|
480
505
|
if (workUnitsExceedCap(
|
|
@@ -547,13 +572,26 @@ async function executeAndSeal(deliveryFetch, offering, format, request, delivery
|
|
|
547
572
|
);
|
|
548
573
|
const sourceSnapshotsByMediaBuyId = groupSnapshotsByMediaBuyId(sourceSnapshots, admittedMediaBuyIds);
|
|
549
574
|
const auxiliarySnapshotsByMediaBuyId = groupSnapshotsByMediaBuyId(auxiliarySnapshots, admittedMediaBuyIds);
|
|
575
|
+
const admittedPackagePairs = new Set(
|
|
576
|
+
request.coverage.constituents.filter((constituent) => constituent.constituentKind === "package_item").map((constituent) => packagePairForConstituent(constituent, packageMediaBuyByConstituentId))
|
|
577
|
+
);
|
|
578
|
+
const sourceSnapshotsByPackagePair = groupSnapshotsByPackagePair(sourceSnapshots, admittedPackagePairs);
|
|
579
|
+
const auxiliarySnapshotsByPackagePair = groupSnapshotsByPackagePair(auxiliarySnapshots, admittedPackagePairs);
|
|
550
580
|
if (sourceSnapshots.length > 0) {
|
|
551
581
|
if (allSnapshots.some((snapshot) => !admittedMediaBuyIds.has(snapshot?.mediaBuyId ?? ""))) {
|
|
552
582
|
return failure("INTEGRITY_FAILED", "terminal", "Inline delivery fetch returned an out-of-scope row");
|
|
553
583
|
}
|
|
584
|
+
if (captureLayout.indexOf.has("package_id") && allSnapshots.some((snapshot) => {
|
|
585
|
+
if (!snapshot) return false;
|
|
586
|
+
const packageId = snapshotFieldValue(snapshot, "package_id");
|
|
587
|
+
return packageId !== void 0 && (typeof packageId !== "string" || snapshot.mediaBuyId === void 0 || !admittedPackagePairs.has(packagePairKey(snapshot.mediaBuyId, packageId)));
|
|
588
|
+
})) {
|
|
589
|
+
return failure("INTEGRITY_FAILED", "terminal", "Inline delivery fetch returned an out-of-scope package row");
|
|
590
|
+
}
|
|
554
591
|
if (request.coverage.constituents.some((constituent) => {
|
|
555
|
-
|
|
556
|
-
|
|
592
|
+
const constituentRows = constituent.constituentKind === "package_item" ? sourceSnapshotsByPackagePair.get(
|
|
593
|
+
packagePairForConstituent(constituent, packageMediaBuyByConstituentId)
|
|
594
|
+
) ?? NO_SNAPSHOTS : constituent.mediaBuyId ? sourceSnapshotsByMediaBuyId.get(constituent.mediaBuyId) ?? NO_SNAPSHOTS : NO_SNAPSHOTS;
|
|
557
595
|
return constituentRows.some(
|
|
558
596
|
(snapshot) => request.requestedDimensions.some((dimension) => !snapshotHasDimension(snapshot, dimension))
|
|
559
597
|
) || availabilityEvidence === void 0 && (constituentRows.length === 0 || constituentRows.some(
|
|
@@ -571,7 +609,10 @@ async function executeAndSeal(deliveryFetch, offering, format, request, delivery
|
|
|
571
609
|
const rowEvidenceFailure = validateSnapshotsAgainstAvailabilityEvidence(
|
|
572
610
|
sourceSnapshotsByMediaBuyId,
|
|
573
611
|
auxiliarySnapshotsByMediaBuyId,
|
|
612
|
+
sourceSnapshotsByPackagePair,
|
|
613
|
+
auxiliarySnapshotsByPackagePair,
|
|
574
614
|
request,
|
|
615
|
+
packageMediaBuyByConstituentId,
|
|
575
616
|
availabilityEvidence.cells
|
|
576
617
|
);
|
|
577
618
|
if (rowEvidenceFailure === "partial") {
|
|
@@ -611,7 +652,9 @@ async function executeAndSeal(deliveryFetch, offering, format, request, delivery
|
|
|
611
652
|
}
|
|
612
653
|
const declaredMetrics = new Map(offering.metrics.map((metric) => [metric.name, metric]));
|
|
613
654
|
const constituentIdsWithRows = new Set(
|
|
614
|
-
request.coverage.constituents.filter(
|
|
655
|
+
request.coverage.constituents.filter(
|
|
656
|
+
(constituent) => constituent.constituentKind === "package_item" ? sourceSnapshotsByPackagePair.has(packagePairForConstituent(constituent, packageMediaBuyByConstituentId)) : constituent.mediaBuyId && sourceSnapshotsByMediaBuyId.has(constituent.mediaBuyId)
|
|
657
|
+
).map((constituent) => constituent.constituentId)
|
|
615
658
|
);
|
|
616
659
|
let projectedAvailability;
|
|
617
660
|
if (availabilityEvidence) {
|
|
@@ -1009,10 +1052,14 @@ function validationWorkExceedsCap(sourceSnapshots, auxiliarySnapshots, request,
|
|
|
1009
1052
|
const perConstituentCap = Math.floor(cap / unitsPerVisit);
|
|
1010
1053
|
const sourceCounts = countSnapshotsByMediaBuyId(sourceSnapshots);
|
|
1011
1054
|
const auxiliaryCounts = includeAuxiliary ? countSnapshotsByMediaBuyId(auxiliarySnapshots) : void 0;
|
|
1055
|
+
const sourcePackageCounts = countSnapshotsByPackagePair(sourceSnapshots);
|
|
1056
|
+
const auxiliaryPackageCounts = includeAuxiliary ? countSnapshotsByPackagePair(auxiliarySnapshots) : void 0;
|
|
1057
|
+
const packageMediaBuyByConstituentId = new Map(
|
|
1058
|
+
(request.coverage.packageBindings ?? []).map((binding) => [binding.constituentId, binding.mediaBuyId])
|
|
1059
|
+
);
|
|
1012
1060
|
let work = 0;
|
|
1013
1061
|
for (const constituent of request.coverage.constituents) {
|
|
1014
|
-
|
|
1015
|
-
const visits = (sourceCounts.get(constituent.mediaBuyId) ?? 0) + (auxiliaryCounts?.get(constituent.mediaBuyId) ?? 0);
|
|
1062
|
+
const visits = constituent.constituentKind === "package_item" ? (sourcePackageCounts.get(packagePairForConstituent(constituent, packageMediaBuyByConstituentId)) ?? 0) + (auxiliaryPackageCounts?.get(packagePairForConstituent(constituent, packageMediaBuyByConstituentId)) ?? 0) : constituent.mediaBuyId ? (sourceCounts.get(constituent.mediaBuyId) ?? 0) + (auxiliaryCounts?.get(constituent.mediaBuyId) ?? 0) : 0;
|
|
1016
1063
|
if (visits > perConstituentCap) return true;
|
|
1017
1064
|
work += visits * unitsPerVisit;
|
|
1018
1065
|
if (work > cap) return true;
|
|
@@ -1027,6 +1074,37 @@ function countSnapshotsByMediaBuyId(snapshots) {
|
|
|
1027
1074
|
}
|
|
1028
1075
|
return counts;
|
|
1029
1076
|
}
|
|
1077
|
+
function packagePairKey(mediaBuyId, packageId) {
|
|
1078
|
+
return JSON.stringify([mediaBuyId, packageId]);
|
|
1079
|
+
}
|
|
1080
|
+
function packagePairForConstituent(constituent, mediaBuyByConstituentId) {
|
|
1081
|
+
return packagePairKey(mediaBuyByConstituentId.get(constituent.constituentId), constituent.packageId);
|
|
1082
|
+
}
|
|
1083
|
+
function groupSnapshotsByPackagePair(snapshots, admittedPackagePairs) {
|
|
1084
|
+
const grouped = /* @__PURE__ */ new Map();
|
|
1085
|
+
for (const snapshot of snapshots) {
|
|
1086
|
+
if (!snapshot) continue;
|
|
1087
|
+
const packageId = snapshotFieldValue(snapshot, "package_id");
|
|
1088
|
+
if (typeof packageId !== "string" || snapshot.mediaBuyId === void 0) continue;
|
|
1089
|
+
const pair = packagePairKey(snapshot.mediaBuyId, packageId);
|
|
1090
|
+
if (!admittedPackagePairs.has(pair)) continue;
|
|
1091
|
+
const rows = grouped.get(pair);
|
|
1092
|
+
if (rows) rows.push(snapshot);
|
|
1093
|
+
else grouped.set(pair, [snapshot]);
|
|
1094
|
+
}
|
|
1095
|
+
return grouped;
|
|
1096
|
+
}
|
|
1097
|
+
function countSnapshotsByPackagePair(snapshots) {
|
|
1098
|
+
const counts = /* @__PURE__ */ new Map();
|
|
1099
|
+
for (const snapshot of snapshots) {
|
|
1100
|
+
if (!snapshot) continue;
|
|
1101
|
+
const packageId = snapshotFieldValue(snapshot, "package_id");
|
|
1102
|
+
if (typeof packageId !== "string" || snapshot.mediaBuyId === void 0) continue;
|
|
1103
|
+
const pair = packagePairKey(snapshot.mediaBuyId, packageId);
|
|
1104
|
+
counts.set(pair, (counts.get(pair) ?? 0) + 1);
|
|
1105
|
+
}
|
|
1106
|
+
return counts;
|
|
1107
|
+
}
|
|
1030
1108
|
function groupSnapshotsByMediaBuyId(snapshots, admittedMediaBuyIds) {
|
|
1031
1109
|
const grouped = /* @__PURE__ */ new Map();
|
|
1032
1110
|
for (const snapshot of snapshots) {
|
|
@@ -1042,14 +1120,16 @@ function groupSnapshotsByMediaBuyId(snapshots, admittedMediaBuyIds) {
|
|
|
1042
1120
|
function snapshotHasDimension(snapshot, dimension) {
|
|
1043
1121
|
return dimension === "media_buy_id" ? snapshot.mediaBuyId !== void 0 : snapshotFieldValue(snapshot, dimension) !== void 0;
|
|
1044
1122
|
}
|
|
1045
|
-
function validateSnapshotsAgainstAvailabilityEvidence(sourceSnapshotsByMediaBuyId, auxiliarySnapshotsByMediaBuyId, request, cells) {
|
|
1123
|
+
function validateSnapshotsAgainstAvailabilityEvidence(sourceSnapshotsByMediaBuyId, auxiliarySnapshotsByMediaBuyId, sourceSnapshotsByPackagePair, auxiliarySnapshotsByPackagePair, request, packageMediaBuyByConstituentId, cells) {
|
|
1046
1124
|
const cellsByConstituent = /* @__PURE__ */ new Map();
|
|
1047
1125
|
for (const constituent of request.coverage.constituents) cellsByConstituent.set(constituent.constituentId, []);
|
|
1048
1126
|
for (const cell of cells) cellsByConstituent.get(cell.constituent_id)?.push(cell);
|
|
1049
1127
|
let integrity = false;
|
|
1050
1128
|
for (const constituent of request.coverage.constituents) {
|
|
1051
|
-
const sourceRows = constituent.mediaBuyId ? sourceSnapshotsByMediaBuyId.get(constituent.mediaBuyId) ?? NO_SNAPSHOTS : NO_SNAPSHOTS;
|
|
1052
|
-
const auxiliaryRows = constituent.
|
|
1129
|
+
const sourceRows = constituent.constituentKind === "package_item" ? sourceSnapshotsByPackagePair.get(packagePairForConstituent(constituent, packageMediaBuyByConstituentId)) ?? NO_SNAPSHOTS : constituent.mediaBuyId ? sourceSnapshotsByMediaBuyId.get(constituent.mediaBuyId) ?? NO_SNAPSHOTS : NO_SNAPSHOTS;
|
|
1130
|
+
const auxiliaryRows = constituent.constituentKind === "package_item" ? auxiliarySnapshotsByPackagePair.get(
|
|
1131
|
+
packagePairForConstituent(constituent, packageMediaBuyByConstituentId)
|
|
1132
|
+
) ?? NO_SNAPSHOTS : constituent.mediaBuyId ? auxiliarySnapshotsByMediaBuyId.get(constituent.mediaBuyId) ?? NO_SNAPSHOTS : NO_SNAPSHOTS;
|
|
1053
1133
|
for (const cell of cellsByConstituent.get(constituent.constituentId) ?? []) {
|
|
1054
1134
|
if (cell.status === "present" && sourceRows.length === 0) return "partial";
|
|
1055
1135
|
for (const snapshot of sourceRows) {
|
|
@@ -665,6 +665,30 @@
|
|
|
665
665
|
"maxLength": 255
|
|
666
666
|
}
|
|
667
667
|
},
|
|
668
|
+
"packageBindings": {
|
|
669
|
+
"maxItems": 1000,
|
|
670
|
+
"type": "array",
|
|
671
|
+
"items": {
|
|
672
|
+
"type": "object",
|
|
673
|
+
"properties": {
|
|
674
|
+
"constituentId": {
|
|
675
|
+
"type": "string",
|
|
676
|
+
"minLength": 1,
|
|
677
|
+
"maxLength": 255
|
|
678
|
+
},
|
|
679
|
+
"mediaBuyId": {
|
|
680
|
+
"type": "string",
|
|
681
|
+
"minLength": 1,
|
|
682
|
+
"maxLength": 255
|
|
683
|
+
}
|
|
684
|
+
},
|
|
685
|
+
"required": [
|
|
686
|
+
"constituentId",
|
|
687
|
+
"mediaBuyId"
|
|
688
|
+
],
|
|
689
|
+
"additionalProperties": false
|
|
690
|
+
}
|
|
691
|
+
},
|
|
668
692
|
"denominatorFingerprint": {
|
|
669
693
|
"type": "string",
|
|
670
694
|
"pattern": "^sha256:[a-f0-9]{64}$"
|
|
@@ -724,6 +724,10 @@ export declare const ReportingSourceSliceRequestV1Schema: z.ZodObject<{
|
|
|
724
724
|
productIds: z.ZodArray<z.ZodString>;
|
|
725
725
|
mediaBuyIds: z.ZodArray<z.ZodString>;
|
|
726
726
|
packageIds: z.ZodArray<z.ZodString>;
|
|
727
|
+
packageBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
728
|
+
constituentId: z.ZodString;
|
|
729
|
+
mediaBuyId: z.ZodString;
|
|
730
|
+
}, z.core.$strict>>>;
|
|
727
731
|
denominatorFingerprint: z.ZodString;
|
|
728
732
|
}, z.core.$strict>;
|
|
729
733
|
requestedMetrics: z.ZodArray<z.ZodString>;
|
|
@@ -1553,6 +1557,10 @@ export declare const ReportingSourceSliceRequestV1JsonSchema: z.core.ZodStandard
|
|
|
1553
1557
|
productIds: z.ZodArray<z.ZodString>;
|
|
1554
1558
|
mediaBuyIds: z.ZodArray<z.ZodString>;
|
|
1555
1559
|
packageIds: z.ZodArray<z.ZodString>;
|
|
1560
|
+
packageBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1561
|
+
constituentId: z.ZodString;
|
|
1562
|
+
mediaBuyId: z.ZodString;
|
|
1563
|
+
}, z.core.$strict>>>;
|
|
1556
1564
|
denominatorFingerprint: z.ZodString;
|
|
1557
1565
|
}, z.core.$strict>;
|
|
1558
1566
|
requestedMetrics: z.ZodArray<z.ZodString>;
|
|
@@ -724,6 +724,10 @@ export declare const ReportingSourceSliceRequestV1Schema: z.ZodObject<{
|
|
|
724
724
|
productIds: z.ZodArray<z.ZodString>;
|
|
725
725
|
mediaBuyIds: z.ZodArray<z.ZodString>;
|
|
726
726
|
packageIds: z.ZodArray<z.ZodString>;
|
|
727
|
+
packageBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
728
|
+
constituentId: z.ZodString;
|
|
729
|
+
mediaBuyId: z.ZodString;
|
|
730
|
+
}, z.core.$strict>>>;
|
|
727
731
|
denominatorFingerprint: z.ZodString;
|
|
728
732
|
}, z.core.$strict>;
|
|
729
733
|
requestedMetrics: z.ZodArray<z.ZodString>;
|
|
@@ -1553,6 +1557,10 @@ export declare const ReportingSourceSliceRequestV1JsonSchema: z.core.ZodStandard
|
|
|
1553
1557
|
productIds: z.ZodArray<z.ZodString>;
|
|
1554
1558
|
mediaBuyIds: z.ZodArray<z.ZodString>;
|
|
1555
1559
|
packageIds: z.ZodArray<z.ZodString>;
|
|
1560
|
+
packageBindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1561
|
+
constituentId: z.ZodString;
|
|
1562
|
+
mediaBuyId: z.ZodString;
|
|
1563
|
+
}, z.core.$strict>>>;
|
|
1556
1564
|
denominatorFingerprint: z.ZodString;
|
|
1557
1565
|
}, z.core.$strict>;
|
|
1558
1566
|
requestedMetrics: z.ZodArray<z.ZodString>;
|
|
@@ -312,6 +312,12 @@ const ReportingSourceSliceRequestV1Schema = import_zod.z.strictObject({
|
|
|
312
312
|
productIds: import_zod.z.array(import_manifest.ReportingExternalIdV1Schema).min(1).max(1e4),
|
|
313
313
|
mediaBuyIds: import_zod.z.array(import_manifest.ReportingExternalIdV1Schema).max(1e4),
|
|
314
314
|
packageIds: import_zod.z.array(import_manifest.ReportingExternalIdV1Schema).max(1e5),
|
|
315
|
+
packageBindings: import_zod.z.array(
|
|
316
|
+
import_zod.z.strictObject({
|
|
317
|
+
constituentId: import_manifest.ReportingExternalIdV1Schema,
|
|
318
|
+
mediaBuyId: import_manifest.ReportingExternalIdV1Schema
|
|
319
|
+
})
|
|
320
|
+
).max(import_manifest.SOURCE_BATCH_MANIFEST_MAX_METRIC_AVAILABILITY_V1).optional(),
|
|
315
321
|
denominatorFingerprint: import_manifest.ReportingFingerprintV1Schema
|
|
316
322
|
}),
|
|
317
323
|
requestedMetrics: import_zod.z.array(ReportingMetricOrDimensionNameV1Schema).min(1).max(1e3),
|
|
@@ -400,6 +406,18 @@ const ReportingSourceSliceRequestV1Schema = import_zod.z.strictObject({
|
|
|
400
406
|
path: ["coverage"],
|
|
401
407
|
message: "Coverage summary IDs must exactly project the constituent denominator"
|
|
402
408
|
});
|
|
409
|
+
const packageBindings = value.coverage.packageBindings;
|
|
410
|
+
if (packageBindings !== void 0) {
|
|
411
|
+
const packageConstituents = value.coverage.constituents.filter((item) => item.constituentKind === "package_item");
|
|
412
|
+
const packageConstituentIds = new Set(packageConstituents.map((item) => item.constituentId));
|
|
413
|
+
if (packageBindings.length !== packageConstituents.length || new Set(packageBindings.map((item) => item.constituentId)).size !== packageBindings.length || packageBindings.some((item) => !packageConstituentIds.has(item.constituentId) || !buys.includes(item.mediaBuyId))) {
|
|
414
|
+
context.addIssue({
|
|
415
|
+
code: "custom",
|
|
416
|
+
path: ["coverage", "packageBindings"],
|
|
417
|
+
message: "Package bindings must map each package constituent to one covered media buy"
|
|
418
|
+
});
|
|
419
|
+
}
|
|
420
|
+
}
|
|
403
421
|
for (const [index, constituent] of value.coverage.constituents.entries()) {
|
|
404
422
|
if (constituent.constituentKind === "package_item" && (constituent.productBinding.productId !== constituent.productId || constituent.productBinding.packageId !== constituent.packageId))
|
|
405
423
|
context.addIssue({
|
|
@@ -283,6 +283,12 @@ const ReportingSourceSliceRequestV1Schema = z.strictObject({
|
|
|
283
283
|
productIds: z.array(ReportingExternalIdV1Schema).min(1).max(1e4),
|
|
284
284
|
mediaBuyIds: z.array(ReportingExternalIdV1Schema).max(1e4),
|
|
285
285
|
packageIds: z.array(ReportingExternalIdV1Schema).max(1e5),
|
|
286
|
+
packageBindings: z.array(
|
|
287
|
+
z.strictObject({
|
|
288
|
+
constituentId: ReportingExternalIdV1Schema,
|
|
289
|
+
mediaBuyId: ReportingExternalIdV1Schema
|
|
290
|
+
})
|
|
291
|
+
).max(SOURCE_BATCH_MANIFEST_MAX_METRIC_AVAILABILITY_V1).optional(),
|
|
286
292
|
denominatorFingerprint: ReportingFingerprintV1Schema
|
|
287
293
|
}),
|
|
288
294
|
requestedMetrics: z.array(ReportingMetricOrDimensionNameV1Schema).min(1).max(1e3),
|
|
@@ -371,6 +377,18 @@ const ReportingSourceSliceRequestV1Schema = z.strictObject({
|
|
|
371
377
|
path: ["coverage"],
|
|
372
378
|
message: "Coverage summary IDs must exactly project the constituent denominator"
|
|
373
379
|
});
|
|
380
|
+
const packageBindings = value.coverage.packageBindings;
|
|
381
|
+
if (packageBindings !== void 0) {
|
|
382
|
+
const packageConstituents = value.coverage.constituents.filter((item) => item.constituentKind === "package_item");
|
|
383
|
+
const packageConstituentIds = new Set(packageConstituents.map((item) => item.constituentId));
|
|
384
|
+
if (packageBindings.length !== packageConstituents.length || new Set(packageBindings.map((item) => item.constituentId)).size !== packageBindings.length || packageBindings.some((item) => !packageConstituentIds.has(item.constituentId) || !buys.includes(item.mediaBuyId))) {
|
|
385
|
+
context.addIssue({
|
|
386
|
+
code: "custom",
|
|
387
|
+
path: ["coverage", "packageBindings"],
|
|
388
|
+
message: "Package bindings must map each package constituent to one covered media buy"
|
|
389
|
+
});
|
|
390
|
+
}
|
|
391
|
+
}
|
|
374
392
|
for (const [index, constituent] of value.coverage.constituents.entries()) {
|
|
375
393
|
if (constituent.constituentKind === "package_item" && (constituent.productBinding.productId !== constituent.productId || constituent.productBinding.packageId !== constituent.packageId))
|
|
376
394
|
context.addIssue({
|
|
@@ -200,7 +200,7 @@ export interface UpstreamTrafficQueryResult {
|
|
|
200
200
|
*/
|
|
201
201
|
export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
|
|
202
202
|
/** Capability semver emitted in run summaries and used for advisory expiry. */
|
|
203
|
-
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.
|
|
203
|
+
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.30";
|
|
204
204
|
/** True when a failed validation contributes to the owning step's grade. */
|
|
205
205
|
export declare function validationFailsStep(result: ValidationResult): boolean;
|
|
206
206
|
/**
|
|
@@ -200,7 +200,7 @@ export interface UpstreamTrafficQueryResult {
|
|
|
200
200
|
*/
|
|
201
201
|
export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
|
|
202
202
|
/** Capability semver emitted in run summaries and used for advisory expiry. */
|
|
203
|
-
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.
|
|
203
|
+
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.30";
|
|
204
204
|
/** True when a failed validation contributes to the owning step's grade. */
|
|
205
205
|
export declare function validationFailsStep(result: ValidationResult): boolean;
|
|
206
206
|
/**
|
package/dist/lib/version.d.mts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* AdCP SDK library version
|
|
3
3
|
*/
|
|
4
|
-
export declare const LIBRARY_VERSION = "17.0.0-beta.
|
|
4
|
+
export declare const LIBRARY_VERSION = "17.0.0-beta.30";
|
|
5
5
|
/**
|
|
6
6
|
* AdCP specification version this library is built for
|
|
7
7
|
*/
|
|
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
|
|
|
33
33
|
* Full version information
|
|
34
34
|
*/
|
|
35
35
|
export declare const VERSION_INFO: {
|
|
36
|
-
readonly library: "17.0.0-beta.
|
|
36
|
+
readonly library: "17.0.0-beta.30";
|
|
37
37
|
readonly adcp: "3.3.0-rc.0";
|
|
38
38
|
readonly compatibleVersions: readonly ["v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.1.25", "3.1.26", "3.1.27", "3.1.28", "3.1.29", "3.1.30", "3.1.31", "3.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6", "3.2.7", "3.2.8", "3.3.0-rc.0", "3.3-rc.0"];
|
|
39
|
-
readonly generatedAt: "2026-11-
|
|
39
|
+
readonly generatedAt: "2026-11-17T12:40:59.658Z";
|
|
40
40
|
};
|
|
41
41
|
/**
|
|
42
42
|
* Get the AdCP specification version this library is built for
|
package/dist/lib/version.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* AdCP SDK library version
|
|
3
3
|
*/
|
|
4
|
-
export declare const LIBRARY_VERSION = "17.0.0-beta.
|
|
4
|
+
export declare const LIBRARY_VERSION = "17.0.0-beta.30";
|
|
5
5
|
/**
|
|
6
6
|
* AdCP specification version this library is built for
|
|
7
7
|
*/
|
|
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
|
|
|
33
33
|
* Full version information
|
|
34
34
|
*/
|
|
35
35
|
export declare const VERSION_INFO: {
|
|
36
|
-
readonly library: "17.0.0-beta.
|
|
36
|
+
readonly library: "17.0.0-beta.30";
|
|
37
37
|
readonly adcp: "3.3.0-rc.0";
|
|
38
38
|
readonly compatibleVersions: readonly ["v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.1.25", "3.1.26", "3.1.27", "3.1.28", "3.1.29", "3.1.30", "3.1.31", "3.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6", "3.2.7", "3.2.8", "3.3.0-rc.0", "3.3-rc.0"];
|
|
39
|
-
readonly generatedAt: "2026-11-
|
|
39
|
+
readonly generatedAt: "2026-11-17T12:40:59.658Z";
|
|
40
40
|
};
|
|
41
41
|
/**
|
|
42
42
|
* Get the AdCP specification version this library is built for
|
package/dist/lib/version.js
CHANGED
|
@@ -31,7 +31,7 @@ __export(version_exports, {
|
|
|
31
31
|
toReleasePrecisionVersion: () => toReleasePrecisionVersion
|
|
32
32
|
});
|
|
33
33
|
module.exports = __toCommonJS(version_exports);
|
|
34
|
-
const LIBRARY_VERSION = "17.0.0-beta.
|
|
34
|
+
const LIBRARY_VERSION = "17.0.0-beta.30";
|
|
35
35
|
const ADCP_VERSION = "3.3.0-rc.0";
|
|
36
36
|
const ADCP_MAJOR_VERSION = 3;
|
|
37
37
|
const COMPATIBLE_ADCP_VERSIONS = [
|
|
@@ -109,10 +109,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
|
|
|
109
109
|
"3.3-rc.0"
|
|
110
110
|
];
|
|
111
111
|
const VERSION_INFO = {
|
|
112
|
-
library: "17.0.0-beta.
|
|
112
|
+
library: "17.0.0-beta.30",
|
|
113
113
|
adcp: "3.3.0-rc.0",
|
|
114
114
|
compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
|
|
115
|
-
generatedAt: "2026-11-
|
|
115
|
+
generatedAt: "2026-11-17T12:40:59.658Z"
|
|
116
116
|
};
|
|
117
117
|
function getAdcpVersion() {
|
|
118
118
|
return ADCP_VERSION;
|
package/dist/lib/version.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
const LIBRARY_VERSION = "17.0.0-beta.
|
|
1
|
+
const LIBRARY_VERSION = "17.0.0-beta.30";
|
|
2
2
|
const ADCP_VERSION = "3.3.0-rc.0";
|
|
3
3
|
const ADCP_MAJOR_VERSION = 3;
|
|
4
4
|
const COMPATIBLE_ADCP_VERSIONS = [
|
|
@@ -76,10 +76,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
|
|
|
76
76
|
"3.3-rc.0"
|
|
77
77
|
];
|
|
78
78
|
const VERSION_INFO = {
|
|
79
|
-
library: "17.0.0-beta.
|
|
79
|
+
library: "17.0.0-beta.30",
|
|
80
80
|
adcp: "3.3.0-rc.0",
|
|
81
81
|
compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
|
|
82
|
-
generatedAt: "2026-11-
|
|
82
|
+
generatedAt: "2026-11-17T12:40:59.658Z"
|
|
83
83
|
};
|
|
84
84
|
function getAdcpVersion() {
|
|
85
85
|
return ADCP_VERSION;
|
package/docs/TYPE-SUMMARY.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# AdCP Type Summary
|
|
2
2
|
|
|
3
3
|
> Generated at: 2026-11-17
|
|
4
|
-
> @adcp/sdk v17.0.0-beta.
|
|
4
|
+
> @adcp/sdk v17.0.0-beta.30
|
|
5
5
|
|
|
6
6
|
Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
|
|
7
7
|
|
|
@@ -3073,7 +3073,9 @@ interface InlineReportingAvailabilityEvidenceV1 {
|
|
|
3073
3073
|
version: '1.0';
|
|
3074
3074
|
cells: readonly InlineReportingMetricEvidenceV1[];
|
|
3075
3075
|
}
|
|
3076
|
-
// Inline callback
|
|
3076
|
+
// Inline callback constituents carry { constituent_id, media_buy_id } for media buys or
|
|
3077
|
+
// { constituent_id, media_buy_id, package_id } for package items. Trusted resolveCoverage also supplies
|
|
3078
|
+
// packageBindings: { constituentId, mediaBuyId }[] for package items.
|
|
3077
3079
|
// validateReportingSourceExecutionV1({ level, capabilities, request, result, objectReader })
|
|
3078
3080
|
// runReportingSourceReplayConformanceV1({ level, executor, request, objectReader })
|
|
3079
3081
|
// validateReportingRevisionSequenceV1(manifests, { crossFinalityBridge })
|
|
@@ -3186,7 +3188,7 @@ const reporting = createReliableReportingService({
|
|
|
3186
3188
|
statusRetentionDays, // enforce this commitment in the ledger database
|
|
3187
3189
|
resolveSource: account => ({ adapterId, sourceScope, sourceTimezone }),
|
|
3188
3190
|
resolveCurrency: account => currency,
|
|
3189
|
-
resolveCoverage: account => ({ constituents }), // authorized
|
|
3191
|
+
resolveCoverage: account => ({ constituents, packageBindings }), // authorized denominator and package-to-buy bindings
|
|
3190
3192
|
resolveConsumerId, // optional; controls consumer-status handler/capability
|
|
3191
3193
|
maintenance: reportingLedgerMaintenance({ retention: { enabled: true } }), // optional factory from @adcp/reporting-storage
|
|
3192
3194
|
});
|
|
@@ -69,6 +69,14 @@ Return `null` while the report is not ready, `[]` for a real observed zero-row p
|
|
|
69
69
|
|
|
70
70
|
When availability differs by metric, add the versioned `availability_evidence` envelope to the existing response object. The callback request supplies the frozen `constituents` mapping; use its `constituent_id` values rather than deriving manifest identities from media-buy IDs. Cells cover the exact requested constituent/metric matrix once each. The adapter supplies semantic-contract IDs and checksums from the offering.
|
|
71
71
|
|
|
72
|
+
For package-grain reporting, the trusted host's `resolveCoverage` must return each `package_item` constituent and a `packageBindings` entry `{ constituentId, mediaBuyId }` for that constituent. The media buy must also be in the authorized denominator. The service freezes these bindings in the configuration and each obligation. The inline callback receives `{ constituent_id, media_buy_id }` for media-buy constituents and `{ constituent_id, media_buy_id, package_id }` for package constituents. Include `package_id` in the requested dimensions and return exact `availability_evidence` for every constituent-metric cell. A package response without evidence fails terminally. The inline adapter matches rows by the frozen `(media_buy_id, package_id)` pair, including when the same package ID appears under different media buys.
|
|
73
|
+
|
|
74
|
+
Every published row in a package-grain slice must carry `package_id` and match a frozen covered buy/package pair. Core revision rows, row count, control totals, and digest cover only `coverage.covered_package_ids`. A media buy without package constituents may remain in the denominator, but its rows cannot publish at this grain. Freeze its packages and bindings in a new configuration generation before publishing those rows. The inline adapter checks the requested dimension and pair; the Core producer checks staged rows from inline and custom executors before committing a revision or adjustment. A custom executor must also attest the constituent coverage it declares. Direct source conformance can accept a package-only request without `packageBindings`, but Core producer installation requires bindings for trusted package coverage.
|
|
75
|
+
|
|
76
|
+
The wire status names packages by `package_id` alone. If the same ID occurs under two buys and their coverage states disagree, the summary reports that ID in `unknown_package_ids`.
|
|
77
|
+
|
|
78
|
+
The denominator fingerprint identifies constituents, while the configuration and obligation fingerprints include the frozen package-to-buy bindings. Changing a binding requires a new configuration version.
|
|
79
|
+
|
|
72
80
|
```ts
|
|
73
81
|
const source = createInlineReportingSourceExecutor(async input => ({
|
|
74
82
|
reporting_period: { start: input.start_date, end: input.end_date },
|
|
@@ -108,7 +116,7 @@ Malformed versions or cells, duplicates, missing cells, unrequested constituent/
|
|
|
108
116
|
|
|
109
117
|
`reporting_rows` and `media_buy_deliveries` are read through the ordinary property channel, so a class instance, a prototype-inherited value, and an accessor-backed slot are all accepted as before; each is read once and the collection that is validated is the collection that is staged. Each row inside them is likewise observed once: its `media_buy_id`, `currency`, `status`, and the direct and `totals` claim for every requested metric and dimension are captured in a single pass, and budgeting, validation, projection and the staged bytes all read that capture. A `totals` that aliases its own row addresses the same slot twice and is read once. Without `availability_evidence` a valid direct value settles its metric, and where every requested metric is settled that way the `totals` slot is not observed at all -- not the property, and not the object behind it. It is observed once, for the whole row, the first time a fallback or a reconciliation actually needs it. With evidence both claims are always read, because a duplicate claim must be reconciled rather than silently preferred. A requested metric or dimension named after one of the adapter's own row fields -- `media_buy_id`, `currency`, `status`, `partial_data`, `totals` -- resolves to that same single observation rather than taking a second one. A row's own `status` is settled before any other field of that row is observed -- `partial_data` included -- so a row its status already settles costs nothing beyond that one read. The same holds for the response envelope itself: `status` is read once and every verdict it decides -- reported failure, unavailable data, and the not-ready states -- is settled before anything else is touched at all, so a response that reports one of them beside a field or collection that throws on access keeps its retryable verdict. Each remaining response field is read at most once and only when a check actually needs it, so a field no check reaches is never observed: `notification_type` goes unread when `is_final` already proves finality. A `status` that is present but is not a string is an unreadable response rather than an absent status. `is_final`, `notification_type`, `partial_data`, `unavailable_count`, `errors`, `pagination`, `reporting_period`, `currency`, `data_through` and `observed_at` are then each read once, each period boundary included, so a period cannot be proven from one object and a currency from another. A control field that is present but malformed -- `unavailable_count: '5'`, `errors: 'boom'`, a non-string watermark -- is treated as the partial or invalid evidence it is, never narrowed into an absent one. Row collections are copied by index against the length they declare, never by spreading, and that length is observed once: a collection whose iterator or second answer disagrees with it cannot materialize more rows than the cap admits, nor have rows it delivered dropped from the staged object. A row whose fields answer differently when read again cannot be priced as one shape and processed as another -- the first answer is the only answer. Only `availability_evidence` is restricted to a plain own data property, because an evidence slot that reads as omitted changes which availability rules apply, whereas a row collection that reads as omitted is simply a failure.
|
|
110
118
|
|
|
111
|
-
The inline adapter narrows the supplied offering to `basic`, non-paginated
|
|
119
|
+
The inline adapter narrows the supplied offering to `basic`, non-paginated media-buy and bound package-item execution. Every nonzero row must identify an admitted `media_buy_id` and contain each requested dimension; a package row must identify its bound `package_id`. `media_buy_id` may also be requested as a metric, and the row identity proves it. Without `availability_evidence`, each row must also contain every requested metric (directly or under `totals`); extra or unidentified rows are rejected. Only availability verification reads the auxiliary collection's claims, so without evidence its rows are observed for their `media_buy_id` alone -- enough to scope-check them -- and their metric and dimension fields are neither read nor billed. The auxiliary collection is never projected or staged either way: it is validated from its captured claims, so its size does not spend the staging budget the source rows need. Only the identifier and requested evidence fields are retained. `[]` is the only implicit proof of an all-zero period for media-buy-only requests. For package requests, return an object with `reporting_rows: []` and `availability_evidence` cells marked `explicit_zero`. A response that omits both row collections is a failure, and unfinished pagination is partial. Authoritative publication additionally requires `is_final: true` or a `final`/`adjusted` notification. The fetch context carries the frozen source settings and semantic contract; group reads are rejected because this compatibility adapter cannot prove them. Each inline executor instance admits at most 100 retained executions and 32 MiB per caller scope, 1,000 executions and 256 MiB total, 16 concurrent fetches, 64 MiB per object, and 5,000,000 validation work units per response. One unit is one requested metric or one requested dimension checked against one row for one constituent, so the budget prices metric breadth, dimension breadth and constituent fanout together -- a row is checked against every constituent naming its `media_buy_id` or bound `(media_buy_id, package_id)` pair. A second budget caps the characters validation may scan while measuring and canonicalizing claims at one staged object's worth (64 MiB), counted per occurrence and per pass, so a long value reused across rows or restated under `totals` cannot buy an unbounded number of scans; a claim is scanned for its byte width, for the zero test and for the canonical decimal form behind a duplicate comparison, and each pass is charged and computed at most once. A number is charged the width it canonicalizes to, not one character, because exponent notation expands when the decimal point is shifted into plain form. A third bound holds the captured claims themselves to the per-object staging ceiling (64 MiB). Claims live in one value array and one flag array shared by every row, so what is held stays proportionate to what is written: with rows capped at 100,000 and the work budget capped at 5,000,000 units the widest admissible request holds about 48 MB, which makes this ceiling an assertion of that arithmetic rather than a limit adopters meet. It is deliberately not the per-scope limit, because the estimate is an upper bound on held bytes while that limit governs written bytes -- held against it, reports the staging cap admits were refused. All three are settled from counts before the work is attempted, so an over-budget request is refused rather than performed. Row status and row currency are decided in their own streaming passes ahead of that capture, so a response whose first row already settles the outcome does not pay to read the rest, and a status too long to be one the adapter recognizes is never case-folded. Capacity exhaustion is terminal for that instance; replace it with a durable executor when those bounded compatibility limits are too small.
|
|
112
120
|
|
|
113
121
|
The object reader MUST authorize and confine every `objectRef` to the supplied `sourceScope`, account, delivery configuration, report definition, and obligation tuple. The harness supplies scope from the frozen request, never from the manifest. Its default pre-read budget is 512 MiB per object and 2 GiB per slice; pass `objectReadLimits` to conformance when a declared adapter format legitimately needs different bounds.
|
|
114
122
|
|
package/docs/llms.txt
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Ad Context Protocol (AdCP)
|
|
2
2
|
|
|
3
3
|
> Generated at: 2026-11-17
|
|
4
|
-
> Library: @adcp/sdk v17.0.0-beta.
|
|
4
|
+
> Library: @adcp/sdk v17.0.0-beta.30
|
|
5
5
|
> AdCP major version: 3
|
|
6
6
|
> Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
|
|
7
7
|
> Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag.
|
|
@@ -16,8 +16,8 @@ pin using `ADCP_VERSION` inside that tarball.
|
|
|
16
16
|
|
|
17
17
|
| Fact | Value |
|
|
18
18
|
| --- | --- |
|
|
19
|
-
| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.
|
|
20
|
-
| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.
|
|
19
|
+
| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.30` |
|
|
20
|
+
| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.30 dist.integrity` |
|
|
21
21
|
| Node.js runtime | `^20.19.0 || >=22.12.0` |
|
|
22
22
|
| Default AdCP wire release | `3.3.0-rc.0` |
|
|
23
23
|
| Maintained wire releases | `v3`, `3.0.0`, `3.0`, `3.0.1`, `3.0.2`, `3.0.3`, `3.0.4`, `3.0.5`, `3.0.6`, `3.0.7`, `3.0.8`, `3.0.9`, `3.0.10`, `3.0.11`, `3.0.12`, `3.0.13`, `3.0.14`, `3.0.15`, `3.0.16`, `3.0.17`, `3.0.18`, `3.0.19`, `3.0.20`, `3.0.21`, `3.0.22`, `3.0.23`, `3.0.24`, `3.0.25`, `3.1.0`, `3.1`, `3.1.1`, `3.1.2`, `3.1.3`, `3.1.4`, `3.1.5`, `3.1.6`, `3.1.7`, `3.1.8`, `3.1.9`, `3.1.10`, `3.1.11`, `3.1.12`, `3.1.13`, `3.1.14`, `3.1.15`, `3.1.16`, `3.1.17`, `3.1.18`, `3.1.19`, `3.1.20`, `3.1.21`, `3.1.22`, `3.1.23`, `3.1.24`, `3.1.25`, `3.1.26`, `3.1.27`, `3.1.28`, `3.1.29`, `3.1.30`, `3.1.31`, `3.2.1`, `3.2`, `3.2.2`, `3.2.3`, `3.2.4`, `3.2.5`, `3.2.6`, `3.2.7`, `3.2.8`, `3.3.0-rc.0`, `3.3-rc.0` |
|
|
@@ -26,8 +26,8 @@ pin using `ADCP_VERSION` inside that tarball.
|
|
|
26
26
|
For a checkout at the published release commit, install the exact package version:
|
|
27
27
|
|
|
28
28
|
```bash
|
|
29
|
-
npm install --save-exact '@adcp/sdk@17.0.0-beta.
|
|
30
|
-
npm view '@adcp/sdk@17.0.0-beta.
|
|
29
|
+
npm install --save-exact '@adcp/sdk@17.0.0-beta.30'
|
|
30
|
+
npm view '@adcp/sdk@17.0.0-beta.30' dist.integrity
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
### Required and optional peers
|