@sonordev/contracts 2.23.0 → 2.25.0

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/resonance.js CHANGED
@@ -1,5 +1,8 @@
1
1
  'use strict';
2
2
 
3
+ // src/contracts/wire-uuid.ts
4
+ var UUID_V1_TO_V8_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$/;
5
+
3
6
  // src/contracts/resonance-constants.ts
4
7
  var RESONANCE_ATTRIBUTION_MODEL = "first_party_last_touch_marker_v1";
5
8
  var RESONANCE_SOURCE_MARKER_PARAMETER = "sonor_source";
@@ -149,7 +152,7 @@ var parseSignalExperimentCreate = (v) => create.read(v, "experimentCreate");
149
152
  var parseSignalExperimentUpdate = (v) => update.read(v, "experimentUpdate");
150
153
  var SIGNAL_EXPERIMENT_CREATE_JSON_SCHEMA = create.schema;
151
154
  var SIGNAL_EXPERIMENT_UPDATE_JSON_SCHEMA = update.schema;
152
- var measurementUuid = text(36, /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
155
+ var measurementUuid = text(36, UUID_V1_TO_V8_PATTERN);
153
156
  var measurementRevision = text(128, /^[a-zA-Z0-9._:-]+$/);
154
157
  var measurementInstant = refine(text(30, /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/), (v, p) => {
155
158
  if (!Number.isFinite(Date.parse(v)) || new Date(v).toISOString().replace(".000Z", "Z") !== v.replace(".000Z", "Z")) fail(p, "invalid UTC instant");
@@ -299,7 +302,7 @@ var fail2 = (path2, reason) => {
299
302
  throw new ResonanceValidationError(path2, reason);
300
303
  };
301
304
  var { field: field2, text: text2, choice: choice2, literal: literal2, integer: integer2, bool, optional: optional2, nullable: nullable2, list: list2, object: object2, union: union2, refine: refine2 } = createWireSchema(fail2, (error) => error instanceof ResonanceValidationError);
302
- var uuid = text2(36, /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
305
+ var uuid = text2(36, UUID_V1_TO_V8_PATTERN);
303
306
  var digest = text2(64, /^[a-f0-9]{64}$/);
304
307
  var revision = text2(128, /^[a-zA-Z0-9._:-]+$/);
305
308
  var instant = refine2(text2(30, /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/), (v, p) => {
@@ -659,10 +662,14 @@ function resonanceWebsiteVisitEventTime(value, context) {
659
662
  const actual = object2({ mandate: mandateScope, approvedAt: instant, now: instant }).read(context, "websiteVisitTime.context");
660
663
  const grant = parseResonanceMandateScope(actual.mandate);
661
664
  if (!grant.websiteVisitFeed) fail2("websiteVisitTime.context.mandate.websiteVisitFeed", "requires an explicit original feed selection");
662
- const occurred = Date.parse(input.occurredAt), received = Date.parse(input.receivedAt), now = Date.parse(actual.now);
665
+ const start = Math.max(Date.parse(grant.budget.startAt), Date.parse(actual.approvedAt));
666
+ const end = Math.min(Date.parse(grant.budget.endAt), Date.parse(grant.expiresAt));
667
+ return websiteVisitEventTime(input, start, end, Date.parse(actual.now));
668
+ }
669
+ function websiteVisitEventTime(input, start, end, now) {
670
+ const occurred = Date.parse(input.occurredAt), received = Date.parse(input.receivedAt);
663
671
  const policy = RESONANCE_WEBSITE_VISIT_PROFILE;
664
672
  if (received < occurred - policy.maxFutureSkewMs || received - occurred > policy.maxCaptureAgeMs || now < received || now < occurred - policy.maxFutureSkewMs || now - occurred > policy.maxDispatchAgeMs) fail2("websiteVisitTime", "outside the local original observation freshness profile");
665
- const start = Math.max(Date.parse(grant.budget.startAt), Date.parse(actual.approvedAt)), end = Math.min(Date.parse(grant.budget.endAt), Date.parse(grant.expiresAt));
666
673
  if (occurred < start || received < start || occurred >= end || received >= end || now >= end) fail2("websiteVisitTime", "outside the original approval and dispatch window");
667
674
  return Math.floor(occurred / 1e3);
668
675
  }
@@ -1674,6 +1681,282 @@ var RESONANCE_MEASUREMENT_CONFIGURATION_CURRENT_JSON_SCHEMA = measurementCurrent
1674
1681
  var RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA = measurementSnapshot.schema;
1675
1682
  var RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA = measurementSaveResponse.schema;
1676
1683
  var nativeAudienceId = text2(160, /^[0-9]+(?![\s\S])/);
1684
+ var RESONANCE_META_DATASET_NAME_MAX_LENGTH = 160;
1685
+ var metaDatasetName = refine2(text2(RESONANCE_META_DATASET_NAME_MAX_LENGTH), (value, at) => {
1686
+ if (!value.trim() || value !== value.trim() || /[\x00-\x1f\x7f]/.test(value)) fail2(at, "requires a trimmed dataset name without control characters");
1687
+ });
1688
+ var parseResonanceMetaDatasetName = (value) => metaDatasetName.read(value, "metaDatasetName");
1689
+ var metaDatasetExistingSelection = object2({ kind: literal2("existing"), externalId: nativeAudienceId });
1690
+ var metaDatasetSetupSelection = union2(
1691
+ metaDatasetExistingSelection,
1692
+ object2({ kind: literal2("create_if_none"), name: metaDatasetName })
1693
+ );
1694
+ var metaDatasetSetupPrepareFields = {
1695
+ schemaVersion: literal2(1),
1696
+ site,
1697
+ accountBindingId: uuid,
1698
+ expectedDraftRevision: integer2(1),
1699
+ idempotencyKey: operationKey,
1700
+ selection: metaDatasetSetupSelection
1701
+ };
1702
+ var metaDatasetSetupPrepare = object2(metaDatasetSetupPrepareFields);
1703
+ var parseResonanceMetaDatasetSetupPrepareRequest = (value) => metaDatasetSetupPrepare.read(value, "metaDatasetSetupPrepare");
1704
+ var RESONANCE_META_DATASET_SETUP_PREPARE_REQUEST_JSON_SCHEMA = metaDatasetSetupPrepare.schema;
1705
+ var metaDatasetSelectionRequest = object2({ ...metaDatasetSetupPrepareFields, selection: metaDatasetExistingSelection });
1706
+ var metaDatasetSelectionWitness = object2({ externalId: nativeAudienceId, resourceRevision: revision, observedAt: instant });
1707
+ var parseResonanceMetaDatasetSelectionRequest = (value) => metaDatasetSelectionRequest.read(value, "metaDatasetSelectionRequest");
1708
+ var parseResonanceMetaDatasetSelectionWitness = (value) => metaDatasetSelectionWitness.read(value, "metaDatasetSelectionWitness");
1709
+ var RESONANCE_META_DATASET_SELECTION_REQUEST_JSON_SCHEMA = metaDatasetSelectionRequest.schema;
1710
+ var RESONANCE_META_DATASET_SELECTION_WITNESS_JSON_SCHEMA = metaDatasetSelectionWitness.schema;
1711
+ var metaSetupOwnerFields = {
1712
+ orgId: uuid,
1713
+ projectId: uuid,
1714
+ campaignId: uuid,
1715
+ connectionId: uuid,
1716
+ accountBindingRevision: integer2(1),
1717
+ connectionRevision: revision,
1718
+ capabilityRevision: revision,
1719
+ expectedKillRevision: integer2(0),
1720
+ externalAccountId: nativeAudienceId,
1721
+ businessId: nativeAudienceId
1722
+ };
1723
+ var metaDatasetSetupIntent = object2({ ...metaDatasetSetupPrepareFields, ...metaSetupOwnerFields });
1724
+ var metaDatasetSetupReview = object2({ intent: metaDatasetSetupIntent, requestDigest: digest });
1725
+ var parseResonanceMetaDatasetSetupIntent = (value) => metaDatasetSetupIntent.read(value, "metaDatasetSetupIntent");
1726
+ var parseResonanceMetaDatasetSetupReview = (value) => metaDatasetSetupReview.read(value, "metaDatasetSetupReview");
1727
+ var resonanceMetaDatasetSetupDigestInput = (value) => canonical(parseResonanceMetaDatasetSetupIntent(value));
1728
+ var RESONANCE_META_DATASET_SETUP_REVIEW_JSON_SCHEMA = metaDatasetSetupReview.schema;
1729
+ var metaDatasetSetupFirstOutcome = object2({
1730
+ admission: choice2("accepted", "rejected", "unknown"),
1731
+ externalId: nullable2(nativeAudienceId),
1732
+ providerRequestId: nullable2(text2(200)),
1733
+ providerRequestDigest: digest
1734
+ });
1735
+ var metaSetupVerificationFields = {
1736
+ externalId: nativeAudienceId,
1737
+ externalAccountId: nativeAudienceId,
1738
+ businessId: nativeAudienceId,
1739
+ resourceRevision: revision,
1740
+ observedAt: instant
1741
+ };
1742
+ var metaDatasetSetupVerification = object2(metaSetupVerificationFields);
1743
+ var metaSetupReceiptFields = {
1744
+ schemaVersion: literal2(1),
1745
+ operationId: uuid,
1746
+ projectId: uuid,
1747
+ campaignId: uuid,
1748
+ site,
1749
+ accountBindingId: uuid,
1750
+ requestDigest: digest,
1751
+ status: choice2("pending", "selected", "created_unverified", "verified", "rejected", "uncertain", "cancelled"),
1752
+ firstOutcome: nullable2(metaDatasetSetupFirstOutcome),
1753
+ reasonCodes: uniqueList(text2(80, /^[a-z][a-z0-9_]*$/), 30)
1754
+ };
1755
+ function checkMetaSetupReceipt(value, at, resource2) {
1756
+ const { status, firstOutcome, currentVerification } = value;
1757
+ if (firstOutcome && firstOutcome.admission === "accepted" !== (firstOutcome.externalId !== null)) {
1758
+ fail2(at + ".firstOutcome", "requires the original provider ID exactly when creation was accepted");
1759
+ }
1760
+ switch (status) {
1761
+ case "pending":
1762
+ case "cancelled":
1763
+ if (firstOutcome || currentVerification) fail2(at, "cannot carry a creation outcome or verification");
1764
+ break;
1765
+ case "selected":
1766
+ if (firstOutcome || !currentVerification) fail2(at, "requires verified existing selection without a creation outcome");
1767
+ break;
1768
+ case "created_unverified":
1769
+ if (firstOutcome?.admission !== "accepted" || currentVerification) fail2(at, "requires accepted creation and no verified readback");
1770
+ break;
1771
+ case "verified":
1772
+ if (firstOutcome?.admission !== "accepted" || !currentVerification || firstOutcome.externalId !== currentVerification.externalId) {
1773
+ fail2(at, `requires verified readback of the exact created ${resource2}`);
1774
+ }
1775
+ break;
1776
+ case "rejected":
1777
+ if (firstOutcome?.admission !== "rejected") fail2(at, "requires the original rejection");
1778
+ break;
1779
+ case "uncertain":
1780
+ if (firstOutcome?.admission !== "unknown" || currentVerification) fail2(at, `requires an unknown outcome without an attributable ${resource2}`);
1781
+ break;
1782
+ }
1783
+ }
1784
+ var metaSetupReceiptState = object2({ ...metaSetupReceiptFields, currentVerification: nullable2(metaDatasetSetupVerification) });
1785
+ var metaDatasetSetupReceipt = refine2(metaSetupReceiptState, (value, at) => checkMetaSetupReceipt(value, at, "dataset"));
1786
+ var parseResonanceMetaDatasetSetupReceipt = (value) => metaDatasetSetupReceipt.read(value, "metaDatasetSetupReceipt");
1787
+ var RESONANCE_META_DATASET_SETUP_RECEIPT_JSON_SCHEMA = metaDatasetSetupReceipt.schema;
1788
+ var metaAudienceSetupResource = object2({ externalId: nativeAudienceId, resourceRevision: revision });
1789
+ var metaAudienceSetupSelection = union2(
1790
+ object2({ kind: literal2("existing"), externalId: nativeAudienceId, resourceRevision: revision }),
1791
+ object2({ kind: literal2("create_if_none") })
1792
+ );
1793
+ var websiteVisitSetupChoice = union2(
1794
+ object2({ kind: literal2("off") }),
1795
+ object2({ kind: literal2("enable"), expiresAt: instant })
1796
+ );
1797
+ var metaAudienceSetupPrepareFields = {
1798
+ schemaVersion: literal2(1),
1799
+ site,
1800
+ accountBindingId: uuid,
1801
+ expectedDraftRevision: integer2(1),
1802
+ idempotencyKey: operationKey,
1803
+ dataset: metaAudienceSetupResource,
1804
+ audienceRule: measurementRuleRef,
1805
+ selection: metaAudienceSetupSelection,
1806
+ feed: websiteVisitSetupChoice
1807
+ };
1808
+ var metaAudienceSetupPrepare = object2(metaAudienceSetupPrepareFields);
1809
+ var parseResonanceMetaAudienceSetupPrepareRequest = (value) => metaAudienceSetupPrepare.read(value, "metaAudienceSetupPrepare");
1810
+ var RESONANCE_META_AUDIENCE_SETUP_PREPARE_REQUEST_JSON_SCHEMA = metaAudienceSetupPrepare.schema;
1811
+ var metaAudienceSetupIntent = refine2(object2({
1812
+ ...metaAudienceSetupPrepareFields,
1813
+ ...metaSetupOwnerFields,
1814
+ audienceRuleRef: audience,
1815
+ resourceRuleRef: measurementRuleRef,
1816
+ excludedResourceRuleRefs: list2(measurementRuleRef, 50),
1817
+ measurementConfigRef,
1818
+ matchingProfileRef,
1819
+ audienceSpecDigest: digest,
1820
+ name: friendlyName,
1821
+ expiresAt: instant
1822
+ }), (value, at) => {
1823
+ const { audienceRule, audienceRuleRef, resourceRuleRef, excludedResourceRuleRefs, measurementConfigRef: measurementConfigRef2 } = value;
1824
+ if (audienceRuleRef.projectId !== value.projectId || audienceRuleRef.site !== value.site || audienceRuleRef.id !== audienceRule.id || audienceRuleRef.revision !== audienceRule.revision || audienceRuleRef.policyRevision !== measurementConfigRef2.policyRevision) fail2(at + ".audienceRuleRef", "requires the exact scoped audience and policy revision");
1825
+ const excludedIds = excludedResourceRuleRefs.map((ref) => ref.id);
1826
+ unique(excludedIds, at + ".excludedResourceRuleRefs");
1827
+ if (excludedIds.includes(resourceRuleRef.id) || canonical([...audienceRuleRef.exclusionRuleIds].sort()) !== canonical(excludedIds.sort())) {
1828
+ fail2(at + ".excludedResourceRuleRefs", "requires the exact exclusions disjoint from the positive rule");
1829
+ }
1830
+ checkAudienceBand(audienceRuleRef, "meta_ads", at + ".audienceRuleRef");
1831
+ });
1832
+ var metaAudienceSetupReview = object2({ intent: metaAudienceSetupIntent, requestDigest: digest });
1833
+ var parseResonanceMetaAudienceSetupIntent = (value) => metaAudienceSetupIntent.read(value, "metaAudienceSetupIntent");
1834
+ var parseResonanceMetaAudienceSetupReview = (value) => metaAudienceSetupReview.read(value, "metaAudienceSetupReview");
1835
+ var resonanceMetaAudienceSetupDigestInput = (value) => canonical(parseResonanceMetaAudienceSetupIntent(value));
1836
+ var RESONANCE_META_AUDIENCE_SETUP_REVIEW_JSON_SCHEMA = metaAudienceSetupReview.schema;
1837
+ var META_WEBSITE_AUDIENCE_MAX_RETENTION_DAYS = 180;
1838
+ var metaAudienceSetupVerification = object2({
1839
+ ...metaSetupVerificationFields,
1840
+ datasetExternalId: nativeAudienceId,
1841
+ datasetResourceRevision: revision,
1842
+ audienceSpecDigest: digest,
1843
+ retentionDays: integer2(1, META_WEBSITE_AUDIENCE_MAX_RETENTION_DAYS)
1844
+ });
1845
+ var metaAudienceSetupReceipt = refine2(object2({
1846
+ ...metaSetupReceiptFields,
1847
+ currentVerification: nullable2(metaAudienceSetupVerification)
1848
+ }), (value, at) => checkMetaSetupReceipt(value, at, "audience"));
1849
+ var parseResonanceMetaAudienceSetupReceipt = (value) => metaAudienceSetupReceipt.read(value, "metaAudienceSetupReceipt");
1850
+ var resonanceMetaAudienceSetupReceiptDigestInput = (value) => canonical(parseResonanceMetaAudienceSetupReceipt(value));
1851
+ var RESONANCE_META_AUDIENCE_SETUP_RECEIPT_JSON_SCHEMA = metaAudienceSetupReceipt.schema;
1852
+ var websiteVisitSetupGrantProof = refine2(object2({
1853
+ schemaVersion: literal2(1),
1854
+ grantOperationId: uuid,
1855
+ audienceOperationId: uuid,
1856
+ approvalActionId: uuid,
1857
+ requestDigest: digest,
1858
+ audienceReceiptDigest: digest,
1859
+ generation: integer2(1),
1860
+ activatedAt: instant,
1861
+ expiresAt: instant,
1862
+ projectId: uuid,
1863
+ campaignId: uuid,
1864
+ site,
1865
+ accountBindingId: uuid,
1866
+ audience: metaAudienceSetupVerification
1867
+ }), (value, at) => {
1868
+ if (value.grantOperationId.toLowerCase() === value.audienceOperationId.toLowerCase()) fail2(at + ".grantOperationId", "requires a distinct native grant operation");
1869
+ if (Date.parse(value.audience.observedAt) > Date.parse(value.activatedAt) || Date.parse(value.activatedAt) >= Date.parse(value.expiresAt)) fail2(at, "requires verification by activation and a nonempty grant window");
1870
+ });
1871
+ var websiteVisitSetupGrantStatus = refine2(object2({
1872
+ proof: websiteVisitSetupGrantProof,
1873
+ status: choice2("active", "revoked", "expired", "invalidated"),
1874
+ checkedAt: instant,
1875
+ revokedAt: nullable2(instant),
1876
+ reasonCodes: metaSetupReceiptFields.reasonCodes
1877
+ }), (value, at) => {
1878
+ const checked = Date.parse(value.checkedAt), activated = Date.parse(value.proof.activatedAt), expires = Date.parse(value.proof.expiresAt);
1879
+ if (checked < activated) fail2(at + ".checkedAt", "cannot predate activation");
1880
+ if (value.status === "revoked") {
1881
+ if (!value.revokedAt || Date.parse(value.revokedAt) < activated || Date.parse(value.revokedAt) > checked) {
1882
+ fail2(at + ".revokedAt", "requires the recorded revocation between activation and observation");
1883
+ }
1884
+ } else if (value.revokedAt) fail2(at + ".revokedAt", "requires revoked status");
1885
+ if (value.status === "active" && checked >= expires || value.status === "expired" && checked < expires) {
1886
+ fail2(at + ".status", "must agree with the original expiry");
1887
+ }
1888
+ });
1889
+ var parseResonanceWebsiteVisitSetupGrantProof = (value) => websiteVisitSetupGrantProof.read(value, "websiteVisitSetupGrantProof");
1890
+ var parseResonanceWebsiteVisitSetupGrantStatus = (value) => websiteVisitSetupGrantStatus.read(value, "websiteVisitSetupGrantStatus");
1891
+ var RESONANCE_WEBSITE_VISIT_SETUP_GRANT_PROOF_JSON_SCHEMA = websiteVisitSetupGrantProof.schema;
1892
+ var RESONANCE_WEBSITE_VISIT_SETUP_GRANT_STATUS_JSON_SCHEMA = websiteVisitSetupGrantStatus.schema;
1893
+ var metaAudienceSetupStatusFields = { receipt: metaAudienceSetupReceipt, grant: nullable2(websiteVisitSetupGrantStatus) };
1894
+ function checkMetaAudienceSetupStatus({ receipt: receipt2, grant }, at) {
1895
+ if (!grant) return;
1896
+ const { proof } = grant;
1897
+ if (receipt2.status !== "selected" && receipt2.status !== "verified" || !receipt2.currentVerification || canonical(receipt2.currentVerification) !== canonical(proof.audience)) {
1898
+ fail2(at + ".grant", "requires the same verified audience witness as the setup receipt");
1899
+ }
1900
+ if (proof.audienceOperationId !== receipt2.operationId || proof.requestDigest !== receipt2.requestDigest || proof.projectId !== receipt2.projectId || proof.campaignId !== receipt2.campaignId || proof.site !== receipt2.site || proof.accountBindingId !== receipt2.accountBindingId) {
1901
+ fail2(at + ".grant", "requires the grant linked to this exact setup operation");
1902
+ }
1903
+ }
1904
+ var metaAudienceSetupStatusShape = object2(metaAudienceSetupStatusFields);
1905
+ var metaAudienceSetupStatus = refine2(metaAudienceSetupStatusShape, checkMetaAudienceSetupStatus);
1906
+ var parseResonanceMetaAudienceSetupStatus = (value) => metaAudienceSetupStatus.read(value, "metaAudienceSetupStatus");
1907
+ var RESONANCE_META_AUDIENCE_SETUP_STATUS_JSON_SCHEMA = metaAudienceSetupStatus.schema;
1908
+ var metaAudienceSetupListItem = refine2(object2({ ledgerActionId: uuid, ...metaAudienceSetupStatusFields }), (item, at) => {
1909
+ checkMetaAudienceSetupStatus(item, at);
1910
+ if (item.grant && item.grant.proof.approvalActionId.toLowerCase() !== item.ledgerActionId.toLowerCase()) {
1911
+ fail2(at + ".ledgerActionId", "requires the original approval linked to this grant");
1912
+ }
1913
+ });
1914
+ var metaAudienceSetupList = refine2(object2({
1915
+ items: list2(metaAudienceSetupListItem, 25),
1916
+ nextCursor: nullable2(uuid)
1917
+ }), ({ items }, at) => {
1918
+ unique(items.map((item) => item.receipt.operationId.toLowerCase()), at + ".items");
1919
+ });
1920
+ var parseResonanceMetaAudienceSetupList = (value) => metaAudienceSetupList.read(value, "metaAudienceSetupList");
1921
+ var RESONANCE_META_AUDIENCE_SETUP_LIST_JSON_SCHEMA = metaAudienceSetupList.schema;
1922
+ var websiteVisitSetupGrant = refine2(object2({
1923
+ proof: websiteVisitSetupGrantProof,
1924
+ intent: metaAudienceSetupIntent
1925
+ }), (value, at) => {
1926
+ const { proof, intent } = value;
1927
+ const { audience: witness } = proof;
1928
+ if (intent.feed.kind !== "enable" || Date.parse(intent.feed.expiresAt) !== Date.parse(proof.expiresAt) || Date.parse(proof.activatedAt) >= Date.parse(intent.expiresAt)) fail2(at, "requires the explicit original opt-in and an unexpired setup approval");
1929
+ if (proof.projectId !== intent.projectId || proof.campaignId !== intent.campaignId || proof.site !== intent.site || proof.accountBindingId !== intent.accountBindingId || witness.externalAccountId !== intent.externalAccountId || witness.businessId !== intent.businessId || witness.datasetExternalId !== intent.dataset.externalId || witness.datasetResourceRevision !== intent.dataset.resourceRevision || witness.audienceSpecDigest !== intent.audienceSpecDigest || witness.retentionDays !== intent.audienceRuleRef.retentionDays) {
1930
+ fail2(at, "requires the exact original scope and verified destination");
1931
+ }
1932
+ if (intent.selection.kind === "existing" && (witness.externalId !== intent.selection.externalId || witness.resourceRevision !== intent.selection.resourceRevision)) {
1933
+ fail2(at, "requires verification of the exact existing audience");
1934
+ }
1935
+ });
1936
+ var parseResonanceWebsiteVisitSetupGrant = (value) => websiteVisitSetupGrant.read(value, "websiteVisitSetupGrant");
1937
+ var websiteVisitSetupOrigin = object2({ kind: literal2("setup"), grantOperationId: uuid, generation: integer2(1) });
1938
+ var websiteVisitSetupAcceptedVisitFields = { acceptedVisits: integer2(0), checkedAt: instant };
1939
+ var websiteVisitSetupGrantAcceptedVisits = object2({ grantOperationId: uuid, ...websiteVisitSetupAcceptedVisitFields });
1940
+ var parseResonanceWebsiteVisitSetupGrantAcceptedVisits = (value) => websiteVisitSetupGrantAcceptedVisits.read(value, "websiteVisitSetupGrantAcceptedVisits");
1941
+ var RESONANCE_WEBSITE_VISIT_SETUP_GRANT_ACCEPTED_VISITS_JSON_SCHEMA = websiteVisitSetupGrantAcceptedVisits.schema;
1942
+ var websiteVisitSetupDeliveryCommand = object2({
1943
+ schemaVersion: literal2(1),
1944
+ operation: literal2("deliver_website_visit"),
1945
+ campaignId: uuid,
1946
+ occurrenceId: uuid,
1947
+ idempotencyKey: operationKey,
1948
+ setupOrigin: websiteVisitSetupOrigin
1949
+ });
1950
+ var parseResonanceWebsiteVisitSetupOrigin = (value) => websiteVisitSetupOrigin.read(value, "websiteVisitSetupOrigin");
1951
+ var parseResonanceWebsiteVisitSetupDeliveryCommand = (value) => websiteVisitSetupDeliveryCommand.read(value, "websiteVisitSetupDeliveryCommand");
1952
+ var resonanceWebsiteVisitSetupDeliveryDigestInput = (value) => canonical(parseResonanceWebsiteVisitSetupDeliveryCommand(value));
1953
+ var RESONANCE_WEBSITE_VISIT_SETUP_DELIVERY_COMMAND_JSON_SCHEMA = websiteVisitSetupDeliveryCommand.schema;
1954
+ var websiteVisitSetupTimeContext = object2({ activatedAt: instant, expiresAt: instant, now: instant });
1955
+ function resonanceWebsiteVisitSetupEventTime(value, context) {
1956
+ const input = websiteVisitTimes.read(value, "websiteVisitTime");
1957
+ const actual = websiteVisitSetupTimeContext.read(context, "websiteVisitTime.context");
1958
+ return websiteVisitEventTime(input, Date.parse(actual.activatedAt), Date.parse(actual.expiresAt), Date.parse(actual.now));
1959
+ }
1677
1960
  var nativeAudienceRef = object2({ externalId: nativeAudienceId, revision: digest });
1678
1961
  var metaSave = refine2(object2({
1679
1962
  schemaVersion: literal2(1),
@@ -1793,9 +2076,28 @@ var metaReadinessPage = object2({ resourceRuleRef: measurementRuleRef, path: obs
1793
2076
  var metaAudienceSize = refine2(object2({ lower: integer2(0), upper: integer2(0) }), (v, p) => {
1794
2077
  if (v.upper < v.lower) fail2(p, "size bounds must be ordered");
1795
2078
  });
2079
+ var metaAudienceReadinessFields = {
2080
+ verdict: choice2(...RESONANCE_META_AUDIENCE_VERDICTS),
2081
+ reasonCodes: uniqueList(choice2(...RESONANCE_META_AUDIENCE_REASONS), 50),
2082
+ size: nullable2(metaAudienceSize)
2083
+ };
2084
+ var metaAudienceSetupReadiness = refine2(object2({
2085
+ status: metaAudienceSetupStatus,
2086
+ delivery: nullable2(object2(websiteVisitSetupAcceptedVisitFields)),
2087
+ providerAudience: nullable2(object2({ externalId: nativeAudienceId, observedAt: instant, readiness: object2(metaAudienceReadinessFields) }))
2088
+ }), ({ status, delivery, providerAudience }, at) => {
2089
+ if (delivery && (!status.grant || Date.parse(delivery.checkedAt) < Date.parse(status.grant.proof.activatedAt))) {
2090
+ fail2(at + ".delivery", "requires the grant and an observation at or after activation");
2091
+ }
2092
+ if (providerAudience && (status.receipt.status !== "selected" && status.receipt.status !== "verified" || status.receipt.currentVerification?.externalId !== providerAudience.externalId)) {
2093
+ fail2(at + ".providerAudience", "requires observation of the exact verified audience");
2094
+ }
2095
+ });
2096
+ var parseResonanceMetaAudienceSetupReadiness = (value) => metaAudienceSetupReadiness.read(value, "metaAudienceSetupReadiness");
2097
+ var RESONANCE_META_AUDIENCE_SETUP_READINESS_JSON_SCHEMA = metaAudienceSetupReadiness.schema;
1796
2098
  var metaReadinessCheck = union2(
1797
2099
  object2({ state: literal2("not_checked"), reasonCode: choice2("configuration_unavailable", "native_mapping_unavailable") }),
1798
- object2({ state: literal2("observed"), mappingSource: choice2("selected_external_audience", "current_materialized_audience"), verdict: choice2(...RESONANCE_META_AUDIENCE_VERDICTS), reasonCodes: uniqueList(choice2(...RESONANCE_META_AUDIENCE_REASONS), 50), size: nullable2(metaAudienceSize), observedAt: instant, expiresAt: nullable2(instant), sizeObservedAt: literal2(null), sizeExpiresAt: literal2(null) })
2100
+ object2({ state: literal2("observed"), mappingSource: choice2("selected_external_audience", "current_materialized_audience"), ...metaAudienceReadinessFields, observedAt: instant, expiresAt: nullable2(instant), sizeObservedAt: literal2(null), sizeExpiresAt: literal2(null) })
1799
2101
  );
1800
2102
  var metaReadinessAudience = object2({ audienceRuleRef: audience, name: friendlyName, includedPage: metaReadinessPage, excludedPages: list2(metaReadinessPage, 50), nativeAudienceId: nullable2(nativeAudienceId), check: metaReadinessCheck });
1801
2103
  var metaRetargetingReadiness = refine2(object2({ schemaVersion: literal2(1), projectId: uuid, campaignId: uuid, channelId: uuid, site, campaignRevision: integer2(1), accountBindingId: uuid, configuration: metaView, audiences: list2(metaReadinessAudience, 50) }), (v, p) => {
@@ -1948,7 +2250,6 @@ function parseResonanceObservationsPage(v) {
1948
2250
  var RESONANCE_PUBLIC_OBSERVATION_METRIC_JSON_SCHEMA = publicObservationMetric.schema;
1949
2251
  var RESONANCE_OBSERVATION_SUPPORT_JSON_SCHEMA = observationSupport.schema;
1950
2252
  var RESONANCE_OBSERVATIONS_PAGE_JSON_SCHEMA = observationsPage.schema;
1951
- var META_WEBSITE_AUDIENCE_MAX_RETENTION_DAYS = 180;
1952
2253
  var META_AUDIENCE_RULE_LIMIT = 10;
1953
2254
  var META_SAC_CUSTOM_AUDIENCE_EXCLUSION_VERIFIED = false;
1954
2255
  var META_CALL_TO_ACTIONS = ["LEARN_MORE", "SIGN_UP", "SHOP_NOW", "APPLY_NOW", "BOOK_TRAVEL", "CONTACT_US", "GET_QUOTE"];
@@ -2201,11 +2502,23 @@ exports.RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA = RESONANCE_MEA
2201
2502
  exports.RESONANCE_MEASUREMENT_CONFIG_JSON_SCHEMA = RESONANCE_MEASUREMENT_CONFIG_JSON_SCHEMA;
2202
2503
  exports.RESONANCE_MEASUREMENT_OCCURRENCE_JSON_SCHEMA = RESONANCE_MEASUREMENT_OCCURRENCE_JSON_SCHEMA;
2203
2504
  exports.RESONANCE_META_AUDIENCE_REASONS = RESONANCE_META_AUDIENCE_REASONS;
2505
+ exports.RESONANCE_META_AUDIENCE_SETUP_LIST_JSON_SCHEMA = RESONANCE_META_AUDIENCE_SETUP_LIST_JSON_SCHEMA;
2506
+ exports.RESONANCE_META_AUDIENCE_SETUP_PREPARE_REQUEST_JSON_SCHEMA = RESONANCE_META_AUDIENCE_SETUP_PREPARE_REQUEST_JSON_SCHEMA;
2507
+ exports.RESONANCE_META_AUDIENCE_SETUP_READINESS_JSON_SCHEMA = RESONANCE_META_AUDIENCE_SETUP_READINESS_JSON_SCHEMA;
2508
+ exports.RESONANCE_META_AUDIENCE_SETUP_RECEIPT_JSON_SCHEMA = RESONANCE_META_AUDIENCE_SETUP_RECEIPT_JSON_SCHEMA;
2509
+ exports.RESONANCE_META_AUDIENCE_SETUP_REVIEW_JSON_SCHEMA = RESONANCE_META_AUDIENCE_SETUP_REVIEW_JSON_SCHEMA;
2510
+ exports.RESONANCE_META_AUDIENCE_SETUP_STATUS_JSON_SCHEMA = RESONANCE_META_AUDIENCE_SETUP_STATUS_JSON_SCHEMA;
2204
2511
  exports.RESONANCE_META_AUDIENCE_VERDICTS = RESONANCE_META_AUDIENCE_VERDICTS;
2205
2512
  exports.RESONANCE_META_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA;
2206
2513
  exports.RESONANCE_META_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA;
2207
2514
  exports.RESONANCE_META_CONFIGURATION_SNAPSHOT_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_SNAPSHOT_JSON_SCHEMA;
2208
2515
  exports.RESONANCE_META_CONFIGURATION_VIEW_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_VIEW_JSON_SCHEMA;
2516
+ exports.RESONANCE_META_DATASET_NAME_MAX_LENGTH = RESONANCE_META_DATASET_NAME_MAX_LENGTH;
2517
+ exports.RESONANCE_META_DATASET_SELECTION_REQUEST_JSON_SCHEMA = RESONANCE_META_DATASET_SELECTION_REQUEST_JSON_SCHEMA;
2518
+ exports.RESONANCE_META_DATASET_SELECTION_WITNESS_JSON_SCHEMA = RESONANCE_META_DATASET_SELECTION_WITNESS_JSON_SCHEMA;
2519
+ exports.RESONANCE_META_DATASET_SETUP_PREPARE_REQUEST_JSON_SCHEMA = RESONANCE_META_DATASET_SETUP_PREPARE_REQUEST_JSON_SCHEMA;
2520
+ exports.RESONANCE_META_DATASET_SETUP_RECEIPT_JSON_SCHEMA = RESONANCE_META_DATASET_SETUP_RECEIPT_JSON_SCHEMA;
2521
+ exports.RESONANCE_META_DATASET_SETUP_REVIEW_JSON_SCHEMA = RESONANCE_META_DATASET_SETUP_REVIEW_JSON_SCHEMA;
2209
2522
  exports.RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS = RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS;
2210
2523
  exports.RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA = RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA;
2211
2524
  exports.RESONANCE_METRIC_JSON_SCHEMA = RESONANCE_METRIC_JSON_SCHEMA;
@@ -2233,6 +2546,10 @@ exports.RESONANCE_SUBJECT_RENEW_COMMAND_JSON_SCHEMA = RESONANCE_SUBJECT_RENEW_CO
2233
2546
  exports.RESONANCE_WEBSITE_VISIT_FEED_JSON_SCHEMA = RESONANCE_WEBSITE_VISIT_FEED_JSON_SCHEMA;
2234
2547
  exports.RESONANCE_WEBSITE_VISIT_FEED_REVIEW_JSON_SCHEMA = RESONANCE_WEBSITE_VISIT_FEED_REVIEW_JSON_SCHEMA;
2235
2548
  exports.RESONANCE_WEBSITE_VISIT_PROFILE = RESONANCE_WEBSITE_VISIT_PROFILE;
2549
+ exports.RESONANCE_WEBSITE_VISIT_SETUP_DELIVERY_COMMAND_JSON_SCHEMA = RESONANCE_WEBSITE_VISIT_SETUP_DELIVERY_COMMAND_JSON_SCHEMA;
2550
+ exports.RESONANCE_WEBSITE_VISIT_SETUP_GRANT_ACCEPTED_VISITS_JSON_SCHEMA = RESONANCE_WEBSITE_VISIT_SETUP_GRANT_ACCEPTED_VISITS_JSON_SCHEMA;
2551
+ exports.RESONANCE_WEBSITE_VISIT_SETUP_GRANT_PROOF_JSON_SCHEMA = RESONANCE_WEBSITE_VISIT_SETUP_GRANT_PROOF_JSON_SCHEMA;
2552
+ exports.RESONANCE_WEBSITE_VISIT_SETUP_GRANT_STATUS_JSON_SCHEMA = RESONANCE_WEBSITE_VISIT_SETUP_GRANT_STATUS_JSON_SCHEMA;
2236
2553
  exports.ResonanceValidationError = ResonanceValidationError;
2237
2554
  exports.addMoney = addMoney;
2238
2555
  exports.checkAudienceBand = checkAudienceBand;
@@ -2289,10 +2606,24 @@ exports.parseResonanceMeasurementConfigurationSaveCommand = parseResonanceMeasur
2289
2606
  exports.parseResonanceMeasurementConfigurationSaveResponse = parseResonanceMeasurementConfigurationSaveResponse;
2290
2607
  exports.parseResonanceMeasurementConfigurationSnapshot = parseResonanceMeasurementConfigurationSnapshot;
2291
2608
  exports.parseResonanceMeasurementOccurrence = parseResonanceMeasurementOccurrence;
2609
+ exports.parseResonanceMetaAudienceSetupIntent = parseResonanceMetaAudienceSetupIntent;
2610
+ exports.parseResonanceMetaAudienceSetupList = parseResonanceMetaAudienceSetupList;
2611
+ exports.parseResonanceMetaAudienceSetupPrepareRequest = parseResonanceMetaAudienceSetupPrepareRequest;
2612
+ exports.parseResonanceMetaAudienceSetupReadiness = parseResonanceMetaAudienceSetupReadiness;
2613
+ exports.parseResonanceMetaAudienceSetupReceipt = parseResonanceMetaAudienceSetupReceipt;
2614
+ exports.parseResonanceMetaAudienceSetupReview = parseResonanceMetaAudienceSetupReview;
2615
+ exports.parseResonanceMetaAudienceSetupStatus = parseResonanceMetaAudienceSetupStatus;
2292
2616
  exports.parseResonanceMetaConfigurationSaveCommand = parseResonanceMetaConfigurationSaveCommand;
2293
2617
  exports.parseResonanceMetaConfigurationSaveResponse = parseResonanceMetaConfigurationSaveResponse;
2294
2618
  exports.parseResonanceMetaConfigurationSnapshot = parseResonanceMetaConfigurationSnapshot;
2295
2619
  exports.parseResonanceMetaConfigurationView = parseResonanceMetaConfigurationView;
2620
+ exports.parseResonanceMetaDatasetName = parseResonanceMetaDatasetName;
2621
+ exports.parseResonanceMetaDatasetSelectionRequest = parseResonanceMetaDatasetSelectionRequest;
2622
+ exports.parseResonanceMetaDatasetSelectionWitness = parseResonanceMetaDatasetSelectionWitness;
2623
+ exports.parseResonanceMetaDatasetSetupIntent = parseResonanceMetaDatasetSetupIntent;
2624
+ exports.parseResonanceMetaDatasetSetupPrepareRequest = parseResonanceMetaDatasetSetupPrepareRequest;
2625
+ exports.parseResonanceMetaDatasetSetupReceipt = parseResonanceMetaDatasetSetupReceipt;
2626
+ exports.parseResonanceMetaDatasetSetupReview = parseResonanceMetaDatasetSetupReview;
2296
2627
  exports.parseResonanceMetaRetargetingReadiness = parseResonanceMetaRetargetingReadiness;
2297
2628
  exports.parseResonanceMetricObservation = parseResonanceMetricObservation;
2298
2629
  exports.parseResonanceObservationSupport = parseResonanceObservationSupport;
@@ -2313,6 +2644,12 @@ exports.parseResonanceResourceRef = parseResonanceResourceRef;
2313
2644
  exports.parseResonanceSourceMarker = parseResonanceSourceMarker;
2314
2645
  exports.parseResonanceSubjectRenewCommand = parseResonanceSubjectRenewCommand;
2315
2646
  exports.parseResonanceWebsiteVisitFeedReview = parseResonanceWebsiteVisitFeedReview;
2647
+ exports.parseResonanceWebsiteVisitSetupDeliveryCommand = parseResonanceWebsiteVisitSetupDeliveryCommand;
2648
+ exports.parseResonanceWebsiteVisitSetupGrant = parseResonanceWebsiteVisitSetupGrant;
2649
+ exports.parseResonanceWebsiteVisitSetupGrantAcceptedVisits = parseResonanceWebsiteVisitSetupGrantAcceptedVisits;
2650
+ exports.parseResonanceWebsiteVisitSetupGrantProof = parseResonanceWebsiteVisitSetupGrantProof;
2651
+ exports.parseResonanceWebsiteVisitSetupGrantStatus = parseResonanceWebsiteVisitSetupGrantStatus;
2652
+ exports.parseResonanceWebsiteVisitSetupOrigin = parseResonanceWebsiteVisitSetupOrigin;
2316
2653
  exports.projectResonanceGoogleConfiguration = projectResonanceGoogleConfiguration;
2317
2654
  exports.projectResonanceMeasurementConfiguration = projectResonanceMeasurementConfiguration;
2318
2655
  exports.projectResonanceMetaConfiguration = projectResonanceMetaConfiguration;
@@ -2323,14 +2660,19 @@ exports.resonanceGoogleSetupDigestInput = resonanceGoogleSetupDigestInput;
2323
2660
  exports.resonanceMandateDigestInput = resonanceMandateDigestInput;
2324
2661
  exports.resonanceMeasurementConfigDigestInput = resonanceMeasurementConfigDigestInput;
2325
2662
  exports.resonanceMeasurementConfigurationSaveDigestInput = resonanceMeasurementConfigurationSaveDigestInput;
2663
+ exports.resonanceMetaAudienceSetupDigestInput = resonanceMetaAudienceSetupDigestInput;
2664
+ exports.resonanceMetaAudienceSetupReceiptDigestInput = resonanceMetaAudienceSetupReceiptDigestInput;
2326
2665
  exports.resonanceMetaConfigurationDigestInput = resonanceMetaConfigurationDigestInput;
2327
2666
  exports.resonanceMetaConfigurationSaveDigestInput = resonanceMetaConfigurationSaveDigestInput;
2667
+ exports.resonanceMetaDatasetSetupDigestInput = resonanceMetaDatasetSetupDigestInput;
2328
2668
  exports.resonanceOptimizationDecisionDigestInput = resonanceOptimizationDecisionDigestInput;
2329
2669
  exports.resonanceOptimizationEvidenceDigestInput = resonanceOptimizationEvidenceDigestInput;
2330
2670
  exports.resonanceOptimizationPolicyDigestInput = resonanceOptimizationPolicyDigestInput;
2331
2671
  exports.resonancePlanIssues = resonancePlanIssues;
2332
2672
  exports.resonanceWebsiteVisitEventTime = resonanceWebsiteVisitEventTime;
2333
2673
  exports.resonanceWebsiteVisitProfileDigestInput = resonanceWebsiteVisitProfileDigestInput;
2674
+ exports.resonanceWebsiteVisitSetupDeliveryDigestInput = resonanceWebsiteVisitSetupDeliveryDigestInput;
2675
+ exports.resonanceWebsiteVisitSetupEventTime = resonanceWebsiteVisitSetupEventTime;
2334
2676
  exports.splitBudget = splitBudget;
2335
2677
  exports.subtractMoney = subtractMoney;
2336
2678
  exports.suggestPropertyWeights = suggestPropertyWeights;