@sonordev/contracts 2.22.0 → 2.23.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/CHANGELOG.md +5 -0
- package/README.md +42 -0
- package/dist/resonance.d.ts +320 -6
- package/dist/resonance.js +74 -4
- package/dist/resonance.mjs +70 -5
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.23.0
|
|
4
|
+
|
|
5
|
+
- Add optional per-channel `providerReporting.metaQueries` to the existing report selector and resolved grant. Each explicit query fixes its attribution window and conversion report time. Original UUID text, list order and omitted legacy fields stay unchanged; actual provider membership, original review and admission remain native checks.
|
|
6
|
+
- Add the closed `ResonanceMetaRetargetingReadiness` response parser, type and JSON schema. It keeps saved configuration facts separate from an observed audience check, preserves unknown size and size freshness, and carries no launch authority. The API classifier and consumers share one exported verdict and reason vocabulary.
|
|
7
|
+
|
|
3
8
|
## 2.22.0
|
|
4
9
|
|
|
5
10
|
- Add one additive set of rules for retargeting several properties from one campaign. A Meta channel can now carry an optional `channelGroup`, `property`, `tier`, `primaryText` and `convertersAcknowledged`. Channels in one group must share their site, account, dataset, Page, categories, countries, objective and optimization, each property keeps its own destination, and tiers of one property can't overlap in time. A grouped campaign's allocations can't exceed its total less its reserve, and a special category in a group requires provider-managed age. A definition that uses none of these fields parses and serializes exactly as before.
|
package/README.md
CHANGED
|
@@ -1719,3 +1719,45 @@ An audience reference can carry `minDaysSinceVisit` (1 to 179), a recency band t
|
|
|
1719
1719
|
|
|
1720
1720
|
Provider metrics gain `reach` (unique people, counting unit `provider_unique_reach`) and `results`. Reach is never added across channels or windows. `deriveProviderRatios(items)` is the one place the ratios are computed, from provider-sourced, observed items that share one observation, channel and window. Frequency is impressions over reach, and cost per result is spend over results rounded half to even at one micro. Zero reach, zero results, a missing input or mixed inputs give an unknown result with a reason, never zero and never a guess.
|
|
1721
1721
|
|
|
1722
|
+
|
|
1723
|
+
|
|
1724
|
+
### Explicit Meta reporting queries
|
|
1725
|
+
|
|
1726
|
+
The existing report selector and resolved grant accept optional `metaQueries`.
|
|
1727
|
+
Each row contains exactly `channelId`, `attributionWindow` (`1d_click`,
|
|
1728
|
+
`7d_click` or `1d_view`), `actionReportTime: 'conversion'` and
|
|
1729
|
+
`basis: 'explicit_query'`. A present list contains 1–100 rows, has unique
|
|
1730
|
+
channel identities and stays within the selected `channelIds`. UUID identity
|
|
1731
|
+
comparisons ignore case; parsers preserve the supplied text and order. The
|
|
1732
|
+
exported `RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS` is the shared window list.
|
|
1733
|
+
|
|
1734
|
+
Omitting the field preserves legacy payloads and digest material. It doesn't
|
|
1735
|
+
upgrade a historical grant to permission for fresh automatic Meta reporting.
|
|
1736
|
+
The native owner checks actual Meta channel coverage, account/site/version
|
|
1737
|
+
membership and original human review. Human manual reporting and passive
|
|
1738
|
+
history keep their existing authorization rules. These are requested report
|
|
1739
|
+
queries; they don't describe configured attribution or claim parity with Ads
|
|
1740
|
+
Manager. Review and adopt the same contracts version across producers and
|
|
1741
|
+
consumers before sending the extended shape to an older strict parser.
|
|
1742
|
+
|
|
1743
|
+
### Explicit audience readiness checks
|
|
1744
|
+
|
|
1745
|
+
`parseResonanceMetaRetargetingReadiness`, its matching type and
|
|
1746
|
+
`RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA` describe one scoped public
|
|
1747
|
+
response. It contains the current campaign/channel/account identity, the
|
|
1748
|
+
existing configuration view and per-rule inclusion/exclusion page references.
|
|
1749
|
+
An audience check is either `not_checked` with a bounded reason, or `observed`
|
|
1750
|
+
with the existing classifier verdict/reasons, actual native audience ID and
|
|
1751
|
+
nullable estimated bounds. `RESONANCE_META_AUDIENCE_VERDICTS` and
|
|
1752
|
+
`RESONANCE_META_AUDIENCE_REASONS` define the shared public vocabulary; provider
|
|
1753
|
+
classification stays with the API owner.
|
|
1754
|
+
|
|
1755
|
+
An observed check's `observedAt` identifies the actual completed owner check.
|
|
1756
|
+
It doesn't date an estimated audience sample. `sizeObservedAt` and
|
|
1757
|
+
`sizeExpiresAt` are explicitly `null` in this version, and the current producer
|
|
1758
|
+
has no audience expiry to supply. Missing size stays `null`, independently of
|
|
1759
|
+
an observed status. Consumers mustn't add bounds across rules or infer fresh
|
|
1760
|
+
sample data from configuration expiry. A source/revision drift, denied scope
|
|
1761
|
+
or provider failure is a transport error, not a fabricated readiness result.
|
|
1762
|
+
The parser checks the closed response and its public scope relationships;
|
|
1763
|
+
actual native ownership, provider checks, launch and delivery remain separate.
|
package/dist/resonance.d.ts
CHANGED
|
@@ -1419,10 +1419,26 @@ declare const websiteVisitFeed: Field<{
|
|
|
1419
1419
|
} & {}>;
|
|
1420
1420
|
export type ResonanceWebsiteVisitFeed = Value<typeof websiteVisitFeed>;
|
|
1421
1421
|
export declare const RESONANCE_WEBSITE_VISIT_FEED_JSON_SCHEMA: import("./wire-schema").JsonSchema;
|
|
1422
|
+
/** Explicit report-query choices, not configured attribution or Ads Manager equivalence. */
|
|
1423
|
+
export declare const RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS: readonly ['1d_click', '7d_click', '1d_view'];
|
|
1424
|
+
export type ResonanceMetaQueryAttributionWindow = typeof RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS[number];
|
|
1425
|
+
declare const metaReportingQuery: Field<{
|
|
1426
|
+
channelId: string;
|
|
1427
|
+
attributionWindow: "1d_click" | "1d_view" | "7d_click";
|
|
1428
|
+
actionReportTime: "conversion";
|
|
1429
|
+
basis: "explicit_query";
|
|
1430
|
+
} & {}>;
|
|
1422
1431
|
declare const providerReportingSelection: Field<{
|
|
1423
1432
|
agentContactId: string;
|
|
1424
1433
|
channelIds: string[];
|
|
1425
|
-
} & {
|
|
1434
|
+
} & {
|
|
1435
|
+
metaQueries?: ({
|
|
1436
|
+
channelId: string;
|
|
1437
|
+
attributionWindow: "1d_click" | "1d_view" | "7d_click";
|
|
1438
|
+
actionReportTime: "conversion";
|
|
1439
|
+
basis: "explicit_query";
|
|
1440
|
+
} & {})[] | undefined;
|
|
1441
|
+
}>;
|
|
1426
1442
|
declare const providerReportingGrant: Field<{
|
|
1427
1443
|
purpose: "provider_reporting_refresh";
|
|
1428
1444
|
orgId: string;
|
|
@@ -1430,7 +1446,15 @@ declare const providerReportingGrant: Field<{
|
|
|
1430
1446
|
agentContactId: string;
|
|
1431
1447
|
principalContactId: string;
|
|
1432
1448
|
channelIds: string[];
|
|
1433
|
-
} & {
|
|
1449
|
+
} & {
|
|
1450
|
+
metaQueries?: ({
|
|
1451
|
+
channelId: string;
|
|
1452
|
+
attributionWindow: "1d_click" | "1d_view" | "7d_click";
|
|
1453
|
+
actionReportTime: "conversion";
|
|
1454
|
+
basis: "explicit_query";
|
|
1455
|
+
} & {})[] | undefined;
|
|
1456
|
+
}>;
|
|
1457
|
+
export type ResonanceMetaReportingQuery = Value<typeof metaReportingQuery>;
|
|
1434
1458
|
export type ResonanceProviderReportingSelection = Value<typeof providerReportingSelection>;
|
|
1435
1459
|
export type ResonanceProviderReportingGrant = Value<typeof providerReportingGrant>;
|
|
1436
1460
|
export declare const parseResonanceProviderReportingSelection: (v: unknown) => ResonanceProviderReportingSelection;
|
|
@@ -1571,7 +1595,14 @@ declare const mandateScope: Field<{
|
|
|
1571
1595
|
agentContactId: string;
|
|
1572
1596
|
principalContactId: string;
|
|
1573
1597
|
channelIds: string[];
|
|
1574
|
-
} & {
|
|
1598
|
+
} & {
|
|
1599
|
+
metaQueries?: ({
|
|
1600
|
+
channelId: string;
|
|
1601
|
+
attributionWindow: "1d_click" | "1d_view" | "7d_click";
|
|
1602
|
+
actionReportTime: "conversion";
|
|
1603
|
+
basis: "explicit_query";
|
|
1604
|
+
} & {})[] | undefined;
|
|
1605
|
+
}) | undefined;
|
|
1575
1606
|
}>;
|
|
1576
1607
|
export type ResonanceMandateScope = Value<typeof mandateScope>;
|
|
1577
1608
|
export declare function parseResonanceMandateScope(v: unknown, preparedPlan?: unknown): ResonanceMandateScope;
|
|
@@ -3871,7 +3902,14 @@ declare const mandateApproval: Field<{
|
|
|
3871
3902
|
agentContactId: string;
|
|
3872
3903
|
principalContactId: string;
|
|
3873
3904
|
channelIds: string[];
|
|
3874
|
-
} & {
|
|
3905
|
+
} & {
|
|
3906
|
+
metaQueries?: ({
|
|
3907
|
+
channelId: string;
|
|
3908
|
+
attributionWindow: "1d_click" | "1d_view" | "7d_click";
|
|
3909
|
+
actionReportTime: "conversion";
|
|
3910
|
+
basis: "explicit_query";
|
|
3911
|
+
} & {})[] | undefined;
|
|
3912
|
+
}) | undefined;
|
|
3875
3913
|
};
|
|
3876
3914
|
} & {}>;
|
|
3877
3915
|
export type ResonanceMandateApprovalPayload = Value<typeof mandateApproval>;
|
|
@@ -7107,6 +7145,268 @@ declare const metaView: Field<({
|
|
|
7107
7145
|
} & {})>;
|
|
7108
7146
|
export type ResonanceMetaConfigurationView = Value<typeof metaView>;
|
|
7109
7147
|
export declare const parseResonanceMetaConfigurationView: (v: unknown) => ResonanceMetaConfigurationView;
|
|
7148
|
+
/** Public vocabulary shared with the API classifier; classification remains provider-owned. */
|
|
7149
|
+
export declare const RESONANCE_META_AUDIENCE_VERDICTS: readonly ['ready', 'too_small', 'blocked', 'unknown'];
|
|
7150
|
+
export type ResonanceMetaAudienceVerdict = typeof RESONANCE_META_AUDIENCE_VERDICTS[number];
|
|
7151
|
+
export declare const RESONANCE_META_AUDIENCE_REASONS: readonly ['meta_audience_status_unreadable', 'meta_audience_status_unrecognized', 'meta_audience_integrity_flagged', 'meta_audience_account_inactive', 'meta_audience_pixel_problem', 'meta_audience_error', 'meta_audience_out_of_date', 'meta_audience_too_small', 'meta_audience_not_usable', 'meta_audience_prefill_failed', 'meta_audience_filling', 'meta_audience_category_unknown', 'meta_url_audience_unverified', 'meta_core_setup_suspected', 'meta_audience_fill_mismatch', 'meta_core_setup_attestation_missing', 'meta_flight_too_short_after_wait', 'meta_terms_nondiscrimination_pending', 'meta_terms_custom_audience_unconfirmed', 'meta_terms_business_tools_pending', 'meta_special_category_age_must_be_provider_managed', 'meta_special_category_genders_not_allowed', 'meta_audience_name_sensitive'];
|
|
7152
|
+
export type ResonanceMetaAudienceReason = typeof RESONANCE_META_AUDIENCE_REASONS[number];
|
|
7153
|
+
declare const metaRetargetingReadiness: Field<{
|
|
7154
|
+
schemaVersion: 1;
|
|
7155
|
+
projectId: string;
|
|
7156
|
+
campaignId: string;
|
|
7157
|
+
channelId: string;
|
|
7158
|
+
site: string;
|
|
7159
|
+
campaignRevision: number;
|
|
7160
|
+
accountBindingId: string;
|
|
7161
|
+
configuration: ({
|
|
7162
|
+
schemaVersion: 1;
|
|
7163
|
+
kind: "unconfigured";
|
|
7164
|
+
projectId: string;
|
|
7165
|
+
campaignId: string;
|
|
7166
|
+
channelId: string;
|
|
7167
|
+
configurationRevision: 0;
|
|
7168
|
+
} & {}) | ({
|
|
7169
|
+
schemaVersion: 1;
|
|
7170
|
+
kind: "configured";
|
|
7171
|
+
projectId: string;
|
|
7172
|
+
campaignId: string;
|
|
7173
|
+
channelId: string;
|
|
7174
|
+
configurationRevision: number;
|
|
7175
|
+
snapshot: {
|
|
7176
|
+
schemaVersion: 1;
|
|
7177
|
+
projectId: string;
|
|
7178
|
+
campaignId: string;
|
|
7179
|
+
channelId: string;
|
|
7180
|
+
site: string;
|
|
7181
|
+
campaignRevision: number;
|
|
7182
|
+
reviewedDefinitionDigest: string;
|
|
7183
|
+
configurationRevision: number;
|
|
7184
|
+
saveOperationId: string;
|
|
7185
|
+
channel: {
|
|
7186
|
+
projectId: string;
|
|
7187
|
+
site: string;
|
|
7188
|
+
id: string;
|
|
7189
|
+
destinationId: string;
|
|
7190
|
+
creativeIds: string[];
|
|
7191
|
+
localCampaignKey: string;
|
|
7192
|
+
kind: "meta_retargeting";
|
|
7193
|
+
provider: "meta_ads";
|
|
7194
|
+
accountBindingId: string;
|
|
7195
|
+
capabilityRevision: string;
|
|
7196
|
+
allocation: {
|
|
7197
|
+
currency: "AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHF" | "CLP" | "CNY" | "COP" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "UYU" | "UZS" | "VES" | "VND" | "VUV" | "WST" | "XAF" | "XCD" | "XCG" | "XDR" | "XOF" | "XPF" | "XSU" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL";
|
|
7198
|
+
amountMicros: string;
|
|
7199
|
+
} & {};
|
|
7200
|
+
budgetMode: "daily" | "lifetime";
|
|
7201
|
+
audienceRuleRefs: ({
|
|
7202
|
+
projectId: string;
|
|
7203
|
+
site: string;
|
|
7204
|
+
id: string;
|
|
7205
|
+
revision: string;
|
|
7206
|
+
policyRevision: string;
|
|
7207
|
+
retentionDays: number;
|
|
7208
|
+
exclusionRuleIds: string[];
|
|
7209
|
+
consentPurpose: "ad_personalization";
|
|
7210
|
+
} & {
|
|
7211
|
+
minDaysSinceVisit?: number | undefined;
|
|
7212
|
+
})[];
|
|
7213
|
+
objective: "OUTCOME_LEADS" | "OUTCOME_SALES" | "OUTCOME_TRAFFIC";
|
|
7214
|
+
pageRef: {
|
|
7215
|
+
connectionId: string;
|
|
7216
|
+
externalId: string;
|
|
7217
|
+
revision: string;
|
|
7218
|
+
} & {};
|
|
7219
|
+
instagramRef: ({
|
|
7220
|
+
connectionId: string;
|
|
7221
|
+
externalId: string;
|
|
7222
|
+
revision: string;
|
|
7223
|
+
} & {}) | null;
|
|
7224
|
+
datasetRef: {
|
|
7225
|
+
id: string;
|
|
7226
|
+
revision: string;
|
|
7227
|
+
} & {};
|
|
7228
|
+
conversionGoalRef: {
|
|
7229
|
+
projectId: string;
|
|
7230
|
+
site: string;
|
|
7231
|
+
module: "booking" | "broadcast" | "business_brain" | "commerce" | "crm" | "experiment" | "files" | "forms" | "funnel" | "outreach" | "prepared_plan" | "publication";
|
|
7232
|
+
id: string;
|
|
7233
|
+
revision: string;
|
|
7234
|
+
digest: string;
|
|
7235
|
+
} & {};
|
|
7236
|
+
optimization: "landing_page_views" | "lead" | "purchase";
|
|
7237
|
+
billing: "impressions";
|
|
7238
|
+
bid: ({
|
|
7239
|
+
strategy: "lowest_cost";
|
|
7240
|
+
} & {}) | ({
|
|
7241
|
+
strategy: "cost_cap";
|
|
7242
|
+
cap: {
|
|
7243
|
+
currency: "AED" | "AFN" | "ALL" | "AMD" | "ANG" | "AOA" | "ARS" | "AUD" | "AWG" | "AZN" | "BAM" | "BBD" | "BDT" | "BGN" | "BHD" | "BIF" | "BMD" | "BND" | "BOB" | "BRL" | "BSD" | "BTN" | "BWP" | "BYN" | "BZD" | "CAD" | "CDF" | "CHF" | "CLP" | "CNY" | "COP" | "CRC" | "CUC" | "CUP" | "CVE" | "CZK" | "DJF" | "DKK" | "DOP" | "DZD" | "EGP" | "ERN" | "ETB" | "EUR" | "FJD" | "FKP" | "GBP" | "GEL" | "GHS" | "GIP" | "GMD" | "GNF" | "GTQ" | "GYD" | "HKD" | "HNL" | "HRK" | "HTG" | "HUF" | "IDR" | "ILS" | "INR" | "IQD" | "IRR" | "ISK" | "JMD" | "JOD" | "JPY" | "KES" | "KGS" | "KHR" | "KMF" | "KPW" | "KRW" | "KWD" | "KYD" | "KZT" | "LAK" | "LBP" | "LKR" | "LRD" | "LSL" | "LYD" | "MAD" | "MDL" | "MGA" | "MKD" | "MMK" | "MNT" | "MOP" | "MRU" | "MUR" | "MVR" | "MWK" | "MXN" | "MYR" | "MZN" | "NAD" | "NGN" | "NIO" | "NOK" | "NPR" | "NZD" | "OMR" | "PAB" | "PEN" | "PGK" | "PHP" | "PKR" | "PLN" | "PYG" | "QAR" | "RON" | "RSD" | "RUB" | "RWF" | "SAR" | "SBD" | "SCR" | "SDG" | "SEK" | "SGD" | "SHP" | "SLE" | "SLL" | "SOS" | "SRD" | "SSP" | "STN" | "SVC" | "SYP" | "SZL" | "THB" | "TJS" | "TMT" | "TND" | "TOP" | "TRY" | "TTD" | "TWD" | "TZS" | "UAH" | "UGX" | "USD" | "UYU" | "UZS" | "VES" | "VND" | "VUV" | "WST" | "XAF" | "XCD" | "XCG" | "XDR" | "XOF" | "XPF" | "XSU" | "YER" | "ZAR" | "ZMW" | "ZWG" | "ZWL";
|
|
7244
|
+
amountMicros: string;
|
|
7245
|
+
} & {};
|
|
7246
|
+
} & {});
|
|
7247
|
+
localAdSetKey: string;
|
|
7248
|
+
localAdKey: string;
|
|
7249
|
+
budgetOwner: "adset" | "campaign";
|
|
7250
|
+
specialCategories: ("employment" | "financial_products_services" | "housing")[];
|
|
7251
|
+
countryCodes: string[];
|
|
7252
|
+
placement: "automatic";
|
|
7253
|
+
} & {
|
|
7254
|
+
ageConstraint?: ({
|
|
7255
|
+
mode: "bounded";
|
|
7256
|
+
min: number;
|
|
7257
|
+
max: number;
|
|
7258
|
+
} & {}) | ({
|
|
7259
|
+
mode: "omitted";
|
|
7260
|
+
} & {}) | ({
|
|
7261
|
+
mode: "provider_managed";
|
|
7262
|
+
} & {}) | undefined;
|
|
7263
|
+
channelGroup?: ({
|
|
7264
|
+
key: string;
|
|
7265
|
+
label: string;
|
|
7266
|
+
} & {}) | undefined;
|
|
7267
|
+
property?: ({
|
|
7268
|
+
key: string;
|
|
7269
|
+
label: string;
|
|
7270
|
+
} & {}) | undefined;
|
|
7271
|
+
tier?: ({
|
|
7272
|
+
label: string;
|
|
7273
|
+
} & {}) | undefined;
|
|
7274
|
+
primaryText?: string | undefined;
|
|
7275
|
+
convertersAcknowledged?: true | undefined;
|
|
7276
|
+
};
|
|
7277
|
+
account: {
|
|
7278
|
+
id: string;
|
|
7279
|
+
externalId: string;
|
|
7280
|
+
name: string | null;
|
|
7281
|
+
} & {};
|
|
7282
|
+
datasetName: string | null;
|
|
7283
|
+
pageName: string | null;
|
|
7284
|
+
instagramName: string | null;
|
|
7285
|
+
measurementConfigRef: {
|
|
7286
|
+
configRevision: string;
|
|
7287
|
+
policyRevision: string;
|
|
7288
|
+
digest: string;
|
|
7289
|
+
} & {};
|
|
7290
|
+
matchingProfileRef: {
|
|
7291
|
+
id: string;
|
|
7292
|
+
revision: number;
|
|
7293
|
+
digest: string;
|
|
7294
|
+
} & {};
|
|
7295
|
+
rules: ({
|
|
7296
|
+
id: string;
|
|
7297
|
+
revision: string;
|
|
7298
|
+
resource: {
|
|
7299
|
+
projectId: string;
|
|
7300
|
+
site: string;
|
|
7301
|
+
type: "article" | "listing" | "page" | "product";
|
|
7302
|
+
id: string;
|
|
7303
|
+
revision: string;
|
|
7304
|
+
} & {};
|
|
7305
|
+
path: string;
|
|
7306
|
+
label: string;
|
|
7307
|
+
} & {})[];
|
|
7308
|
+
audiences: ({
|
|
7309
|
+
audienceRuleRef: {
|
|
7310
|
+
projectId: string;
|
|
7311
|
+
site: string;
|
|
7312
|
+
id: string;
|
|
7313
|
+
revision: string;
|
|
7314
|
+
policyRevision: string;
|
|
7315
|
+
retentionDays: number;
|
|
7316
|
+
exclusionRuleIds: string[];
|
|
7317
|
+
consentPurpose: "ad_personalization";
|
|
7318
|
+
} & {
|
|
7319
|
+
minDaysSinceVisit?: number | undefined;
|
|
7320
|
+
};
|
|
7321
|
+
name: string;
|
|
7322
|
+
resourceRuleRef: {
|
|
7323
|
+
id: string;
|
|
7324
|
+
revision: string;
|
|
7325
|
+
} & {};
|
|
7326
|
+
excludedResourceRuleRefs: ({
|
|
7327
|
+
id: string;
|
|
7328
|
+
revision: string;
|
|
7329
|
+
} & {})[];
|
|
7330
|
+
selection: ({
|
|
7331
|
+
mode: "existing";
|
|
7332
|
+
nativeAudienceRef: {
|
|
7333
|
+
externalId: string;
|
|
7334
|
+
revision: string;
|
|
7335
|
+
} & {};
|
|
7336
|
+
nativeAudienceName: string | null;
|
|
7337
|
+
} & {}) | ({
|
|
7338
|
+
mode: "admitted_setup";
|
|
7339
|
+
setup: {
|
|
7340
|
+
kind: "meta_website_audience_v1";
|
|
7341
|
+
localOutputKey: string;
|
|
7342
|
+
specDigest: string;
|
|
7343
|
+
} & {};
|
|
7344
|
+
} & {});
|
|
7345
|
+
} & {})[];
|
|
7346
|
+
configurationDigest: string;
|
|
7347
|
+
} & {};
|
|
7348
|
+
currentCampaignRevision: number;
|
|
7349
|
+
currentDefinitionDigest: string;
|
|
7350
|
+
observedAt: string;
|
|
7351
|
+
expiresAt: string | null;
|
|
7352
|
+
readyForReview: boolean;
|
|
7353
|
+
reasonCodes: string[];
|
|
7354
|
+
pendingRequirements: string[];
|
|
7355
|
+
} & {});
|
|
7356
|
+
audiences: ({
|
|
7357
|
+
audienceRuleRef: {
|
|
7358
|
+
projectId: string;
|
|
7359
|
+
site: string;
|
|
7360
|
+
id: string;
|
|
7361
|
+
revision: string;
|
|
7362
|
+
policyRevision: string;
|
|
7363
|
+
retentionDays: number;
|
|
7364
|
+
exclusionRuleIds: string[];
|
|
7365
|
+
consentPurpose: "ad_personalization";
|
|
7366
|
+
} & {
|
|
7367
|
+
minDaysSinceVisit?: number | undefined;
|
|
7368
|
+
};
|
|
7369
|
+
name: string;
|
|
7370
|
+
includedPage: {
|
|
7371
|
+
resourceRuleRef: {
|
|
7372
|
+
id: string;
|
|
7373
|
+
revision: string;
|
|
7374
|
+
} & {};
|
|
7375
|
+
path: string;
|
|
7376
|
+
label: string | null;
|
|
7377
|
+
} & {};
|
|
7378
|
+
excludedPages: ({
|
|
7379
|
+
resourceRuleRef: {
|
|
7380
|
+
id: string;
|
|
7381
|
+
revision: string;
|
|
7382
|
+
} & {};
|
|
7383
|
+
path: string;
|
|
7384
|
+
label: string | null;
|
|
7385
|
+
} & {})[];
|
|
7386
|
+
nativeAudienceId: string | null;
|
|
7387
|
+
check: ({
|
|
7388
|
+
state: "not_checked";
|
|
7389
|
+
reasonCode: "configuration_unavailable" | "native_mapping_unavailable";
|
|
7390
|
+
} & {}) | ({
|
|
7391
|
+
state: "observed";
|
|
7392
|
+
mappingSource: "current_materialized_audience" | "selected_external_audience";
|
|
7393
|
+
verdict: "blocked" | "ready" | "too_small" | "unknown";
|
|
7394
|
+
reasonCodes: ("meta_audience_account_inactive" | "meta_audience_category_unknown" | "meta_audience_error" | "meta_audience_fill_mismatch" | "meta_audience_filling" | "meta_audience_integrity_flagged" | "meta_audience_name_sensitive" | "meta_audience_not_usable" | "meta_audience_out_of_date" | "meta_audience_pixel_problem" | "meta_audience_prefill_failed" | "meta_audience_status_unreadable" | "meta_audience_status_unrecognized" | "meta_audience_too_small" | "meta_core_setup_attestation_missing" | "meta_core_setup_suspected" | "meta_flight_too_short_after_wait" | "meta_special_category_age_must_be_provider_managed" | "meta_special_category_genders_not_allowed" | "meta_terms_business_tools_pending" | "meta_terms_custom_audience_unconfirmed" | "meta_terms_nondiscrimination_pending" | "meta_url_audience_unverified")[];
|
|
7395
|
+
size: ({
|
|
7396
|
+
lower: number;
|
|
7397
|
+
upper: number;
|
|
7398
|
+
} & {}) | null;
|
|
7399
|
+
observedAt: string;
|
|
7400
|
+
expiresAt: string | null;
|
|
7401
|
+
sizeObservedAt: null;
|
|
7402
|
+
sizeExpiresAt: null;
|
|
7403
|
+
} & {});
|
|
7404
|
+
} & {})[];
|
|
7405
|
+
} & {}>;
|
|
7406
|
+
export type ResonanceMetaRetargetingReadiness = Value<typeof metaRetargetingReadiness>;
|
|
7407
|
+
/** Public shape/scope only; never provider freshness, native authority, or launch permission. */
|
|
7408
|
+
export declare const parseResonanceMetaRetargetingReadiness: (v: unknown) => ResonanceMetaRetargetingReadiness;
|
|
7409
|
+
export declare const RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA: import("./wire-schema").JsonSchema;
|
|
7110
7410
|
declare const metaSaveResponse: Field<{
|
|
7111
7411
|
schemaVersion: 1;
|
|
7112
7412
|
snapshot: {
|
|
@@ -7679,7 +7979,14 @@ declare const mandateDraftRequest: Field<{
|
|
|
7679
7979
|
providerReporting?: ({
|
|
7680
7980
|
agentContactId: string;
|
|
7681
7981
|
channelIds: string[];
|
|
7682
|
-
} & {
|
|
7982
|
+
} & {
|
|
7983
|
+
metaQueries?: ({
|
|
7984
|
+
channelId: string;
|
|
7985
|
+
attributionWindow: "1d_click" | "1d_view" | "7d_click";
|
|
7986
|
+
actionReportTime: "conversion";
|
|
7987
|
+
basis: "explicit_query";
|
|
7988
|
+
} & {})[] | undefined;
|
|
7989
|
+
}) | undefined;
|
|
7683
7990
|
}>;
|
|
7684
7991
|
export type ResonanceMandateDraftRequest = Value<typeof mandateDraftRequest>;
|
|
7685
7992
|
export declare const parseResonanceMandateDraftRequest: (v: unknown) => ResonanceMandateDraftRequest;
|
|
@@ -7826,7 +8133,14 @@ declare const feedReview: Field<{
|
|
|
7826
8133
|
agentContactId: string;
|
|
7827
8134
|
principalContactId: string;
|
|
7828
8135
|
channelIds: string[];
|
|
7829
|
-
} & {
|
|
8136
|
+
} & {
|
|
8137
|
+
metaQueries?: ({
|
|
8138
|
+
channelId: string;
|
|
8139
|
+
attributionWindow: "1d_click" | "1d_view" | "7d_click";
|
|
8140
|
+
actionReportTime: "conversion";
|
|
8141
|
+
basis: "explicit_query";
|
|
8142
|
+
} & {})[] | undefined;
|
|
8143
|
+
}) | undefined;
|
|
7830
8144
|
};
|
|
7831
8145
|
} & {};
|
|
7832
8146
|
mandateRef: {
|
package/dist/resonance.js
CHANGED
|
@@ -614,9 +614,16 @@ var websiteVisitFeed = object2({ profile: literal2(RESONANCE_WEBSITE_VISIT_PROFI
|
|
|
614
614
|
}), 100, 1) });
|
|
615
615
|
var RESONANCE_WEBSITE_VISIT_FEED_JSON_SCHEMA = websiteVisitFeed.schema;
|
|
616
616
|
var providerReportingChannelIds = refine2(uniqueList(uuid, 100, 1), (ids, p) => unique(ids.map((id) => id.toLowerCase()), p));
|
|
617
|
-
var
|
|
618
|
-
var
|
|
617
|
+
var RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS = ["1d_click", "7d_click", "1d_view"];
|
|
618
|
+
var metaReportingQuery = object2({ channelId: uuid, attributionWindow: choice2(...RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS), actionReportTime: literal2("conversion"), basis: literal2("explicit_query") });
|
|
619
|
+
var providerReportingMetaQueries = refine2(list2(metaReportingQuery, 100, 1), (queries, p) => unique(queries.map((query) => query.channelId.toLowerCase()), p));
|
|
620
|
+
function checkReportingQuerySubset(v, p) {
|
|
621
|
+
if (v.metaQueries?.some((query) => !v.channelIds.some((id) => id.toLowerCase() === query.channelId.toLowerCase()))) fail2(p + ".metaQueries", "query channel must be selected");
|
|
622
|
+
}
|
|
623
|
+
var providerReportingSelection = refine2(object2({ agentContactId: uuid, channelIds: providerReportingChannelIds, metaQueries: optional2(providerReportingMetaQueries) }), checkReportingQuerySubset);
|
|
624
|
+
var providerReportingGrant = refine2(object2({ purpose: literal2("provider_reporting_refresh"), orgId: uuid, projectId: uuid, agentContactId: uuid, principalContactId: uuid, channelIds: providerReportingChannelIds, metaQueries: optional2(providerReportingMetaQueries) }), (v, p) => {
|
|
619
625
|
if (v.agentContactId.toLowerCase() === v.principalContactId.toLowerCase()) fail2(p + ".principalContactId", "agent and human principal must remain distinct");
|
|
626
|
+
checkReportingQuerySubset(v, p);
|
|
620
627
|
});
|
|
621
628
|
var parseResonanceProviderReportingSelection = (v) => providerReportingSelection.read(v, "providerReportingSelection");
|
|
622
629
|
var parseResonanceProviderReportingGrant = (v) => providerReportingGrant.read(v, "providerReportingGrant");
|
|
@@ -639,7 +646,7 @@ function parseResonanceMandateScope(v, preparedPlan) {
|
|
|
639
646
|
if (r.projectId !== plan.projectId || r.campaignId !== plan.campaignId || r.preparedPlanId !== plan.id || r.reviewDigest !== plan.reviewDigest || canonical(r.goal) !== canonical(plan.definition.objective) || canonical(r.budget) !== canonical(plan.definition.budget)) fail2(p, "requires the exact original plan, review, goal and flight");
|
|
640
647
|
if (r.sites.some((site2) => !plan.definition.sites.includes(site2)) || r.accountBindingIds.some((id) => !plan.accounts.some((account) => account.id === id))) fail2(p, "mandate sites and accounts must stay inside the original plan");
|
|
641
648
|
for (const id of grant.channelIds) {
|
|
642
|
-
const channel2 = plan.definition.channels.find((c) => c.id === id);
|
|
649
|
+
const channel2 = plan.definition.channels.find((c) => c.id.toLowerCase() === id.toLowerCase());
|
|
643
650
|
if (!channel2 || !("provider" in channel2) || !r.sites.includes(channel2.site) || !r.accountBindingIds.includes(channel2.accountBindingId)) fail2(p + ".channelIds", "requires an explicit original paid channel inside mandate sites and accounts");
|
|
644
651
|
}
|
|
645
652
|
}
|
|
@@ -1666,7 +1673,8 @@ var RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA = measurementSa
|
|
|
1666
1673
|
var RESONANCE_MEASUREMENT_CONFIGURATION_CURRENT_JSON_SCHEMA = measurementCurrent.schema;
|
|
1667
1674
|
var RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA = measurementSnapshot.schema;
|
|
1668
1675
|
var RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA = measurementSaveResponse.schema;
|
|
1669
|
-
var
|
|
1676
|
+
var nativeAudienceId = text2(160, /^[0-9]+(?![\s\S])/);
|
|
1677
|
+
var nativeAudienceRef = object2({ externalId: nativeAudienceId, revision: digest });
|
|
1670
1678
|
var metaSave = refine2(object2({
|
|
1671
1679
|
schemaVersion: literal2(1),
|
|
1672
1680
|
expectedCampaignRevision: integer2(1),
|
|
@@ -1755,6 +1763,63 @@ var metaView = refine2(union2(
|
|
|
1755
1763
|
if (v.readyForReview !== metaReviewable(s, v)) fail2(p + ".readyForReview", "must reflect current review prerequisites only");
|
|
1756
1764
|
});
|
|
1757
1765
|
var parseResonanceMetaConfigurationView = (v) => metaView.read(v, "metaConfigurationView");
|
|
1766
|
+
var RESONANCE_META_AUDIENCE_VERDICTS = ["ready", "too_small", "blocked", "unknown"];
|
|
1767
|
+
var RESONANCE_META_AUDIENCE_REASONS = [
|
|
1768
|
+
"meta_audience_status_unreadable",
|
|
1769
|
+
"meta_audience_status_unrecognized",
|
|
1770
|
+
"meta_audience_integrity_flagged",
|
|
1771
|
+
"meta_audience_account_inactive",
|
|
1772
|
+
"meta_audience_pixel_problem",
|
|
1773
|
+
"meta_audience_error",
|
|
1774
|
+
"meta_audience_out_of_date",
|
|
1775
|
+
"meta_audience_too_small",
|
|
1776
|
+
"meta_audience_not_usable",
|
|
1777
|
+
"meta_audience_prefill_failed",
|
|
1778
|
+
"meta_audience_filling",
|
|
1779
|
+
"meta_audience_category_unknown",
|
|
1780
|
+
"meta_url_audience_unverified",
|
|
1781
|
+
"meta_core_setup_suspected",
|
|
1782
|
+
"meta_audience_fill_mismatch",
|
|
1783
|
+
"meta_core_setup_attestation_missing",
|
|
1784
|
+
"meta_flight_too_short_after_wait",
|
|
1785
|
+
"meta_terms_nondiscrimination_pending",
|
|
1786
|
+
"meta_terms_custom_audience_unconfirmed",
|
|
1787
|
+
"meta_terms_business_tools_pending",
|
|
1788
|
+
"meta_special_category_age_must_be_provider_managed",
|
|
1789
|
+
"meta_special_category_genders_not_allowed",
|
|
1790
|
+
"meta_audience_name_sensitive"
|
|
1791
|
+
];
|
|
1792
|
+
var metaReadinessPage = object2({ resourceRuleRef: measurementRuleRef, path: observedPagePath, label: nullable2(friendlyName) });
|
|
1793
|
+
var metaAudienceSize = refine2(object2({ lower: integer2(0), upper: integer2(0) }), (v, p) => {
|
|
1794
|
+
if (v.upper < v.lower) fail2(p, "size bounds must be ordered");
|
|
1795
|
+
});
|
|
1796
|
+
var metaReadinessCheck = union2(
|
|
1797
|
+
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) })
|
|
1799
|
+
);
|
|
1800
|
+
var metaReadinessAudience = object2({ audienceRuleRef: audience, name: friendlyName, includedPage: metaReadinessPage, excludedPages: list2(metaReadinessPage, 50), nativeAudienceId: nullable2(nativeAudienceId), check: metaReadinessCheck });
|
|
1801
|
+
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) => {
|
|
1802
|
+
const sameId = (a, b) => a.toLowerCase() === b.toLowerCase();
|
|
1803
|
+
const config = v.configuration;
|
|
1804
|
+
if (!sameId(config.projectId, v.projectId) || !sameId(config.campaignId, v.campaignId) || !sameId(config.channelId, v.channelId)) fail2(p + ".configuration", "configuration scope mismatch");
|
|
1805
|
+
if (config.kind === "configured" && (config.currentCampaignRevision !== v.campaignRevision || config.snapshot.site !== v.site || !sameId(config.snapshot.account.id, v.accountBindingId))) fail2(p + ".configuration", "current configuration revision, site or account mismatch");
|
|
1806
|
+
unique(v.audiences.map((row) => row.audienceRuleRef.id.toLowerCase()), p + ".audiences");
|
|
1807
|
+
for (const row of v.audiences) {
|
|
1808
|
+
if (!sameId(row.audienceRuleRef.projectId, v.projectId) || row.audienceRuleRef.site !== v.site) fail2(p + ".audiences", "audience scope mismatch");
|
|
1809
|
+
const excluded = row.excludedPages.map((page2) => page2.resourceRuleRef.id.toLowerCase());
|
|
1810
|
+
unique(excluded, p + ".audiences.excludedPages");
|
|
1811
|
+
const expected = row.audienceRuleRef.exclusionRuleIds.map((id) => id.toLowerCase());
|
|
1812
|
+
unique(expected, p + ".audiences.audienceRuleRef.exclusionRuleIds");
|
|
1813
|
+
if (excluded.includes(row.includedPage.resourceRuleRef.id.toLowerCase()) || excluded.length !== expected.length || expected.some((id) => !excluded.includes(id))) fail2(p + ".audiences.excludedPages", "exclusion rule scope mismatch");
|
|
1814
|
+
if (row.check.state === "observed" && (row.nativeAudienceId === null || config.kind !== "configured")) fail2(p + ".audiences.check", "observed check requires configured scope and actual native audience identity");
|
|
1815
|
+
if (config.kind === "configured" && config.currentDefinitionDigest === config.snapshot.reviewedDefinitionDigest) {
|
|
1816
|
+
const original = config.snapshot.audiences.find((a) => sameId(a.audienceRuleRef.id, row.audienceRuleRef.id));
|
|
1817
|
+
if (!original || canonical(original.audienceRuleRef) !== canonical(row.audienceRuleRef) || canonical(original.resourceRuleRef) !== canonical(row.includedPage.resourceRuleRef) || original.excludedResourceRuleRefs.length !== row.excludedPages.length || original.excludedResourceRuleRefs.some((ref) => !row.excludedPages.some((page2) => canonical(page2.resourceRuleRef) === canonical(ref)))) fail2(p + ".audiences", "original audience and page rule versions must match");
|
|
1818
|
+
}
|
|
1819
|
+
}
|
|
1820
|
+
});
|
|
1821
|
+
var parseResonanceMetaRetargetingReadiness = (v) => metaRetargetingReadiness.read(v, "metaRetargetingReadiness");
|
|
1822
|
+
var RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA = metaRetargetingReadiness.schema;
|
|
1758
1823
|
var metaSaveResponse = object2({ schemaVersion: literal2(1), snapshot: metaSnapshot, replayed: bool });
|
|
1759
1824
|
var parseResonanceMetaConfigurationSaveResponse = (v) => metaSaveResponse.read(v, "metaConfigurationSaveResponse");
|
|
1760
1825
|
function projectResonanceMetaConfiguration(v, currentMetadata) {
|
|
@@ -2135,10 +2200,14 @@ exports.RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA = RESONANC
|
|
|
2135
2200
|
exports.RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA = RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA;
|
|
2136
2201
|
exports.RESONANCE_MEASUREMENT_CONFIG_JSON_SCHEMA = RESONANCE_MEASUREMENT_CONFIG_JSON_SCHEMA;
|
|
2137
2202
|
exports.RESONANCE_MEASUREMENT_OCCURRENCE_JSON_SCHEMA = RESONANCE_MEASUREMENT_OCCURRENCE_JSON_SCHEMA;
|
|
2203
|
+
exports.RESONANCE_META_AUDIENCE_REASONS = RESONANCE_META_AUDIENCE_REASONS;
|
|
2204
|
+
exports.RESONANCE_META_AUDIENCE_VERDICTS = RESONANCE_META_AUDIENCE_VERDICTS;
|
|
2138
2205
|
exports.RESONANCE_META_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA;
|
|
2139
2206
|
exports.RESONANCE_META_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA;
|
|
2140
2207
|
exports.RESONANCE_META_CONFIGURATION_SNAPSHOT_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_SNAPSHOT_JSON_SCHEMA;
|
|
2141
2208
|
exports.RESONANCE_META_CONFIGURATION_VIEW_JSON_SCHEMA = RESONANCE_META_CONFIGURATION_VIEW_JSON_SCHEMA;
|
|
2209
|
+
exports.RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS = RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS;
|
|
2210
|
+
exports.RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA = RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA;
|
|
2142
2211
|
exports.RESONANCE_METRIC_JSON_SCHEMA = RESONANCE_METRIC_JSON_SCHEMA;
|
|
2143
2212
|
exports.RESONANCE_OBSERVATIONS_PAGE_JSON_SCHEMA = RESONANCE_OBSERVATIONS_PAGE_JSON_SCHEMA;
|
|
2144
2213
|
exports.RESONANCE_OBSERVATION_SUPPORT_JSON_SCHEMA = RESONANCE_OBSERVATION_SUPPORT_JSON_SCHEMA;
|
|
@@ -2224,6 +2293,7 @@ exports.parseResonanceMetaConfigurationSaveCommand = parseResonanceMetaConfigura
|
|
|
2224
2293
|
exports.parseResonanceMetaConfigurationSaveResponse = parseResonanceMetaConfigurationSaveResponse;
|
|
2225
2294
|
exports.parseResonanceMetaConfigurationSnapshot = parseResonanceMetaConfigurationSnapshot;
|
|
2226
2295
|
exports.parseResonanceMetaConfigurationView = parseResonanceMetaConfigurationView;
|
|
2296
|
+
exports.parseResonanceMetaRetargetingReadiness = parseResonanceMetaRetargetingReadiness;
|
|
2227
2297
|
exports.parseResonanceMetricObservation = parseResonanceMetricObservation;
|
|
2228
2298
|
exports.parseResonanceObservationSupport = parseResonanceObservationSupport;
|
|
2229
2299
|
exports.parseResonanceObservationsPage = parseResonanceObservationsPage;
|
package/dist/resonance.mjs
CHANGED
|
@@ -612,9 +612,16 @@ var websiteVisitFeed = object2({ profile: literal2(RESONANCE_WEBSITE_VISIT_PROFI
|
|
|
612
612
|
}), 100, 1) });
|
|
613
613
|
var RESONANCE_WEBSITE_VISIT_FEED_JSON_SCHEMA = websiteVisitFeed.schema;
|
|
614
614
|
var providerReportingChannelIds = refine2(uniqueList(uuid, 100, 1), (ids, p) => unique(ids.map((id) => id.toLowerCase()), p));
|
|
615
|
-
var
|
|
616
|
-
var
|
|
615
|
+
var RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS = ["1d_click", "7d_click", "1d_view"];
|
|
616
|
+
var metaReportingQuery = object2({ channelId: uuid, attributionWindow: choice2(...RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS), actionReportTime: literal2("conversion"), basis: literal2("explicit_query") });
|
|
617
|
+
var providerReportingMetaQueries = refine2(list2(metaReportingQuery, 100, 1), (queries, p) => unique(queries.map((query) => query.channelId.toLowerCase()), p));
|
|
618
|
+
function checkReportingQuerySubset(v, p) {
|
|
619
|
+
if (v.metaQueries?.some((query) => !v.channelIds.some((id) => id.toLowerCase() === query.channelId.toLowerCase()))) fail2(p + ".metaQueries", "query channel must be selected");
|
|
620
|
+
}
|
|
621
|
+
var providerReportingSelection = refine2(object2({ agentContactId: uuid, channelIds: providerReportingChannelIds, metaQueries: optional2(providerReportingMetaQueries) }), checkReportingQuerySubset);
|
|
622
|
+
var providerReportingGrant = refine2(object2({ purpose: literal2("provider_reporting_refresh"), orgId: uuid, projectId: uuid, agentContactId: uuid, principalContactId: uuid, channelIds: providerReportingChannelIds, metaQueries: optional2(providerReportingMetaQueries) }), (v, p) => {
|
|
617
623
|
if (v.agentContactId.toLowerCase() === v.principalContactId.toLowerCase()) fail2(p + ".principalContactId", "agent and human principal must remain distinct");
|
|
624
|
+
checkReportingQuerySubset(v, p);
|
|
618
625
|
});
|
|
619
626
|
var parseResonanceProviderReportingSelection = (v) => providerReportingSelection.read(v, "providerReportingSelection");
|
|
620
627
|
var parseResonanceProviderReportingGrant = (v) => providerReportingGrant.read(v, "providerReportingGrant");
|
|
@@ -637,7 +644,7 @@ function parseResonanceMandateScope(v, preparedPlan) {
|
|
|
637
644
|
if (r.projectId !== plan.projectId || r.campaignId !== plan.campaignId || r.preparedPlanId !== plan.id || r.reviewDigest !== plan.reviewDigest || canonical(r.goal) !== canonical(plan.definition.objective) || canonical(r.budget) !== canonical(plan.definition.budget)) fail2(p, "requires the exact original plan, review, goal and flight");
|
|
638
645
|
if (r.sites.some((site2) => !plan.definition.sites.includes(site2)) || r.accountBindingIds.some((id) => !plan.accounts.some((account) => account.id === id))) fail2(p, "mandate sites and accounts must stay inside the original plan");
|
|
639
646
|
for (const id of grant.channelIds) {
|
|
640
|
-
const channel2 = plan.definition.channels.find((c) => c.id === id);
|
|
647
|
+
const channel2 = plan.definition.channels.find((c) => c.id.toLowerCase() === id.toLowerCase());
|
|
641
648
|
if (!channel2 || !("provider" in channel2) || !r.sites.includes(channel2.site) || !r.accountBindingIds.includes(channel2.accountBindingId)) fail2(p + ".channelIds", "requires an explicit original paid channel inside mandate sites and accounts");
|
|
642
649
|
}
|
|
643
650
|
}
|
|
@@ -1664,7 +1671,8 @@ var RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA = measurementSa
|
|
|
1664
1671
|
var RESONANCE_MEASUREMENT_CONFIGURATION_CURRENT_JSON_SCHEMA = measurementCurrent.schema;
|
|
1665
1672
|
var RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA = measurementSnapshot.schema;
|
|
1666
1673
|
var RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA = measurementSaveResponse.schema;
|
|
1667
|
-
var
|
|
1674
|
+
var nativeAudienceId = text2(160, /^[0-9]+(?![\s\S])/);
|
|
1675
|
+
var nativeAudienceRef = object2({ externalId: nativeAudienceId, revision: digest });
|
|
1668
1676
|
var metaSave = refine2(object2({
|
|
1669
1677
|
schemaVersion: literal2(1),
|
|
1670
1678
|
expectedCampaignRevision: integer2(1),
|
|
@@ -1753,6 +1761,63 @@ var metaView = refine2(union2(
|
|
|
1753
1761
|
if (v.readyForReview !== metaReviewable(s, v)) fail2(p + ".readyForReview", "must reflect current review prerequisites only");
|
|
1754
1762
|
});
|
|
1755
1763
|
var parseResonanceMetaConfigurationView = (v) => metaView.read(v, "metaConfigurationView");
|
|
1764
|
+
var RESONANCE_META_AUDIENCE_VERDICTS = ["ready", "too_small", "blocked", "unknown"];
|
|
1765
|
+
var RESONANCE_META_AUDIENCE_REASONS = [
|
|
1766
|
+
"meta_audience_status_unreadable",
|
|
1767
|
+
"meta_audience_status_unrecognized",
|
|
1768
|
+
"meta_audience_integrity_flagged",
|
|
1769
|
+
"meta_audience_account_inactive",
|
|
1770
|
+
"meta_audience_pixel_problem",
|
|
1771
|
+
"meta_audience_error",
|
|
1772
|
+
"meta_audience_out_of_date",
|
|
1773
|
+
"meta_audience_too_small",
|
|
1774
|
+
"meta_audience_not_usable",
|
|
1775
|
+
"meta_audience_prefill_failed",
|
|
1776
|
+
"meta_audience_filling",
|
|
1777
|
+
"meta_audience_category_unknown",
|
|
1778
|
+
"meta_url_audience_unverified",
|
|
1779
|
+
"meta_core_setup_suspected",
|
|
1780
|
+
"meta_audience_fill_mismatch",
|
|
1781
|
+
"meta_core_setup_attestation_missing",
|
|
1782
|
+
"meta_flight_too_short_after_wait",
|
|
1783
|
+
"meta_terms_nondiscrimination_pending",
|
|
1784
|
+
"meta_terms_custom_audience_unconfirmed",
|
|
1785
|
+
"meta_terms_business_tools_pending",
|
|
1786
|
+
"meta_special_category_age_must_be_provider_managed",
|
|
1787
|
+
"meta_special_category_genders_not_allowed",
|
|
1788
|
+
"meta_audience_name_sensitive"
|
|
1789
|
+
];
|
|
1790
|
+
var metaReadinessPage = object2({ resourceRuleRef: measurementRuleRef, path: observedPagePath, label: nullable2(friendlyName) });
|
|
1791
|
+
var metaAudienceSize = refine2(object2({ lower: integer2(0), upper: integer2(0) }), (v, p) => {
|
|
1792
|
+
if (v.upper < v.lower) fail2(p, "size bounds must be ordered");
|
|
1793
|
+
});
|
|
1794
|
+
var metaReadinessCheck = union2(
|
|
1795
|
+
object2({ state: literal2("not_checked"), reasonCode: choice2("configuration_unavailable", "native_mapping_unavailable") }),
|
|
1796
|
+
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) })
|
|
1797
|
+
);
|
|
1798
|
+
var metaReadinessAudience = object2({ audienceRuleRef: audience, name: friendlyName, includedPage: metaReadinessPage, excludedPages: list2(metaReadinessPage, 50), nativeAudienceId: nullable2(nativeAudienceId), check: metaReadinessCheck });
|
|
1799
|
+
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) => {
|
|
1800
|
+
const sameId = (a, b) => a.toLowerCase() === b.toLowerCase();
|
|
1801
|
+
const config = v.configuration;
|
|
1802
|
+
if (!sameId(config.projectId, v.projectId) || !sameId(config.campaignId, v.campaignId) || !sameId(config.channelId, v.channelId)) fail2(p + ".configuration", "configuration scope mismatch");
|
|
1803
|
+
if (config.kind === "configured" && (config.currentCampaignRevision !== v.campaignRevision || config.snapshot.site !== v.site || !sameId(config.snapshot.account.id, v.accountBindingId))) fail2(p + ".configuration", "current configuration revision, site or account mismatch");
|
|
1804
|
+
unique(v.audiences.map((row) => row.audienceRuleRef.id.toLowerCase()), p + ".audiences");
|
|
1805
|
+
for (const row of v.audiences) {
|
|
1806
|
+
if (!sameId(row.audienceRuleRef.projectId, v.projectId) || row.audienceRuleRef.site !== v.site) fail2(p + ".audiences", "audience scope mismatch");
|
|
1807
|
+
const excluded = row.excludedPages.map((page2) => page2.resourceRuleRef.id.toLowerCase());
|
|
1808
|
+
unique(excluded, p + ".audiences.excludedPages");
|
|
1809
|
+
const expected = row.audienceRuleRef.exclusionRuleIds.map((id) => id.toLowerCase());
|
|
1810
|
+
unique(expected, p + ".audiences.audienceRuleRef.exclusionRuleIds");
|
|
1811
|
+
if (excluded.includes(row.includedPage.resourceRuleRef.id.toLowerCase()) || excluded.length !== expected.length || expected.some((id) => !excluded.includes(id))) fail2(p + ".audiences.excludedPages", "exclusion rule scope mismatch");
|
|
1812
|
+
if (row.check.state === "observed" && (row.nativeAudienceId === null || config.kind !== "configured")) fail2(p + ".audiences.check", "observed check requires configured scope and actual native audience identity");
|
|
1813
|
+
if (config.kind === "configured" && config.currentDefinitionDigest === config.snapshot.reviewedDefinitionDigest) {
|
|
1814
|
+
const original = config.snapshot.audiences.find((a) => sameId(a.audienceRuleRef.id, row.audienceRuleRef.id));
|
|
1815
|
+
if (!original || canonical(original.audienceRuleRef) !== canonical(row.audienceRuleRef) || canonical(original.resourceRuleRef) !== canonical(row.includedPage.resourceRuleRef) || original.excludedResourceRuleRefs.length !== row.excludedPages.length || original.excludedResourceRuleRefs.some((ref) => !row.excludedPages.some((page2) => canonical(page2.resourceRuleRef) === canonical(ref)))) fail2(p + ".audiences", "original audience and page rule versions must match");
|
|
1816
|
+
}
|
|
1817
|
+
}
|
|
1818
|
+
});
|
|
1819
|
+
var parseResonanceMetaRetargetingReadiness = (v) => metaRetargetingReadiness.read(v, "metaRetargetingReadiness");
|
|
1820
|
+
var RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA = metaRetargetingReadiness.schema;
|
|
1756
1821
|
var metaSaveResponse = object2({ schemaVersion: literal2(1), snapshot: metaSnapshot, replayed: bool });
|
|
1757
1822
|
var parseResonanceMetaConfigurationSaveResponse = (v) => metaSaveResponse.read(v, "metaConfigurationSaveResponse");
|
|
1758
1823
|
function projectResonanceMetaConfiguration(v, currentMetadata) {
|
|
@@ -2080,4 +2145,4 @@ function deriveProviderRatios(items) {
|
|
|
2080
2145
|
return { frequency, costPerResult, reasonCodes: reasons };
|
|
2081
2146
|
}
|
|
2082
2147
|
|
|
2083
|
-
export { MAX_MONEY_MICROS, META_AUDIENCE_RULE_LIMIT, META_CALL_TO_ACTIONS, META_SAC_CUSTOM_AUDIENCE_EXCLUSION_VERIFIED, META_WEBSITE_AUDIENCE_MAX_RETENTION_DAYS, MONEY_EXPONENT, MONEY_JSON_SCHEMA, RESONANCE_ACCEPT_COMMAND_JSON_SCHEMA, RESONANCE_ACCOUNT_CAPABILITY_JSON_SCHEMA, RESONANCE_ATTRIBUTION_MODEL, RESONANCE_AUDIENCE_DRAFT_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_AUDIENCE_RULE_REF_JSON_SCHEMA, RESONANCE_BINDING_COMMAND_JSON_SCHEMA, RESONANCE_CAMPAIGN_DEFINITION_JSON_SCHEMA, RESONANCE_CAMPAIGN_DRAFT_JSON_SCHEMA, RESONANCE_CAMPAIGN_VIEW_JSON_SCHEMA, RESONANCE_CLICK_IDENTIFIERS_JSON_SCHEMA, RESONANCE_COMMAND_JSON_SCHEMA, RESONANCE_COMMAND_PREPARE_REQUEST_JSON_SCHEMA, RESONANCE_COMMAND_PREPARE_RESPONSE_JSON_SCHEMA, RESONANCE_CONSENT_JSON_SCHEMA, RESONANCE_CONSENT_RESPONSE_JSON_SCHEMA, RESONANCE_CONSENT_UPDATE_JSON_SCHEMA, RESONANCE_CONVERSION_JSON_SCHEMA, RESONANCE_CPQL_UNCERTAINTY_METHOD, RESONANCE_CURRENCIES, RESONANCE_EXPERIMENT_COMPLETE_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_CREATE_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_LIFECYCLE_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_LINK_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_REF_JSON_SCHEMA, RESONANCE_EXPERIMENT_UPDATE_COMMAND_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_REVIEW_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_SNAPSHOT_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_VIEW_JSON_SCHEMA, RESONANCE_GOOGLE_SETUP_SPEC_JSON_SCHEMA, RESONANCE_GOOGLE_SIGNAL_SEMANTICS, RESONANCE_GOOGLE_SOURCE_CATEGORIES, RESONANCE_MANDATE_ACTION_KIND, RESONANCE_MANDATE_APPROVAL_JSON_SCHEMA, RESONANCE_MANDATE_DRAFT_REQUEST_JSON_SCHEMA, RESONANCE_MANDATE_REF_JSON_SCHEMA, RESONANCE_MANDATE_SCOPE_JSON_SCHEMA, RESONANCE_MANDATE_TARGET_JSON_SCHEMA, RESONANCE_MAX_CHANNELS_PER_GROUP, RESONANCE_MEASUREMENT_CONFIGURATION_CURRENT_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIG_JSON_SCHEMA, RESONANCE_MEASUREMENT_OCCURRENCE_JSON_SCHEMA, RESONANCE_META_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_META_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA, RESONANCE_META_CONFIGURATION_SNAPSHOT_JSON_SCHEMA, RESONANCE_META_CONFIGURATION_VIEW_JSON_SCHEMA, RESONANCE_METRIC_JSON_SCHEMA, RESONANCE_OBSERVATIONS_PAGE_JSON_SCHEMA, RESONANCE_OBSERVATION_SUPPORT_JSON_SCHEMA, RESONANCE_OCCURRENCE_RESPONSE_JSON_SCHEMA, RESONANCE_OPTIMIZATION_DECISION_JSON_SCHEMA, RESONANCE_OPTIMIZATION_EVIDENCE_JSON_SCHEMA, RESONANCE_OPTIMIZATION_POLICY_JSON_SCHEMA, RESONANCE_PREPARED_PLAN_JSON_SCHEMA, RESONANCE_PROVIDER_METRIC_NAMES, RESONANCE_PROVIDER_REPORTING_GRANT_JSON_SCHEMA, RESONANCE_PROVIDER_REPORTING_SELECTION_JSON_SCHEMA, RESONANCE_PUBLIC_OBSERVATION_METRIC_JSON_SCHEMA, RESONANCE_QUALIFICATION_RULE_JSON_SCHEMA, RESONANCE_RECEIPT_JSON_SCHEMA, RESONANCE_RESOLVED_QUALIFICATION_RULE_JSON_SCHEMA, RESONANCE_RESOURCE_REF_JSON_SCHEMA, RESONANCE_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_SCHEMA_VERSION, RESONANCE_SOURCE_MARKER_JSON_SCHEMA, RESONANCE_SOURCE_MARKER_PARAMETER, RESONANCE_SUBJECT_HEADER, RESONANCE_SUBJECT_RENEW_COMMAND_JSON_SCHEMA, RESONANCE_WEBSITE_VISIT_FEED_JSON_SCHEMA, RESONANCE_WEBSITE_VISIT_FEED_REVIEW_JSON_SCHEMA, RESONANCE_WEBSITE_VISIT_PROFILE, ResonanceValidationError, addMoney, checkAudienceBand, checkChannelGroups, compareMoney, cpqlMissingOutcomeBound, deriveProviderRatios, expandPropertyChannels, formatMoney, googleConversionActionSemantics, googleUploadClicksSetupSemantics, metaExclusionPolicy, moneyFromProviderUnits, moneyToProviderUnits, parseMoney, parseResonanceAcceptCommand, parseResonanceAccountCapability, parseResonanceAudienceDraftSaveCommand, parseResonanceAudienceRuleRef, parseResonanceBindingCommand, parseResonanceCampaignDefinition, parseResonanceCampaignDraft, parseResonanceCampaignSaveCommand, parseResonanceCampaignView, parseResonanceClickIdentifiers, parseResonanceCommand, parseResonanceCommandPrepareRequest, parseResonanceCommandPrepareResponse, parseResonanceConsentResponse, parseResonanceConsentSnapshot, parseResonanceConsentUpdate, parseResonanceConversionEnvelope, parseResonanceExperimentCompleteCommand, parseResonanceExperimentCreateCommand, parseResonanceExperimentExposure, parseResonanceExperimentLifecycleCommand, parseResonanceExperimentLinkCommand, parseResonanceExperimentRef, parseResonanceExperimentUpdateCommand, parseResonanceGoogleConfigurationReview, parseResonanceGoogleConfigurationSaveCommand, parseResonanceGoogleConfigurationSaveResponse, parseResonanceGoogleConfigurationSnapshot, parseResonanceGoogleConfigurationView, parseResonanceGoogleUploadClicksCustomGoalSpec, parseResonanceMandateApprovalPayload, parseResonanceMandateDraftRequest, parseResonanceMandateRef, parseResonanceMandateScope, parseResonanceMandateTarget, parseResonanceMeasurementConfig, parseResonanceMeasurementConfigurationCurrent, parseResonanceMeasurementConfigurationSaveCommand, parseResonanceMeasurementConfigurationSaveResponse, parseResonanceMeasurementConfigurationSnapshot, parseResonanceMeasurementOccurrence, parseResonanceMetaConfigurationSaveCommand, parseResonanceMetaConfigurationSaveResponse, parseResonanceMetaConfigurationSnapshot, parseResonanceMetaConfigurationView, parseResonanceMetricObservation, parseResonanceObservationSupport, parseResonanceObservationsPage, parseResonanceOccurrenceResponse, parseResonanceOptimizationDecision, parseResonanceOptimizationEvidence, parseResonanceOptimizationPolicy, parseResonancePrepareCommand, parseResonancePreparedPlan, parseResonanceProviderReportingGrant, parseResonanceProviderReportingSelection, parseResonancePublicObservationMetric, parseResonanceQualificationRule, parseResonanceReceipt, parseResonanceResolvedQualificationRule, parseResonanceResourceRef, parseResonanceSourceMarker, parseResonanceSubjectRenewCommand, parseResonanceWebsiteVisitFeedReview, projectResonanceGoogleConfiguration, projectResonanceMeasurementConfiguration, projectResonanceMetaConfiguration, reportedCpqlMissingOutcomeBound, resonanceCommandDigestInput, resonanceGoogleConfigurationDigestInput, resonanceGoogleSetupDigestInput, resonanceMandateDigestInput, resonanceMeasurementConfigDigestInput, resonanceMeasurementConfigurationSaveDigestInput, resonanceMetaConfigurationDigestInput, resonanceMetaConfigurationSaveDigestInput, resonanceOptimizationDecisionDigestInput, resonanceOptimizationEvidenceDigestInput, resonanceOptimizationPolicyDigestInput, resonancePlanIssues, resonanceWebsiteVisitEventTime, resonanceWebsiteVisitProfileDigestInput, splitBudget, subtractMoney, suggestPropertyWeights };
|
|
2148
|
+
export { MAX_MONEY_MICROS, META_AUDIENCE_RULE_LIMIT, META_CALL_TO_ACTIONS, META_SAC_CUSTOM_AUDIENCE_EXCLUSION_VERIFIED, META_WEBSITE_AUDIENCE_MAX_RETENTION_DAYS, MONEY_EXPONENT, MONEY_JSON_SCHEMA, RESONANCE_ACCEPT_COMMAND_JSON_SCHEMA, RESONANCE_ACCOUNT_CAPABILITY_JSON_SCHEMA, RESONANCE_ATTRIBUTION_MODEL, RESONANCE_AUDIENCE_DRAFT_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_AUDIENCE_RULE_REF_JSON_SCHEMA, RESONANCE_BINDING_COMMAND_JSON_SCHEMA, RESONANCE_CAMPAIGN_DEFINITION_JSON_SCHEMA, RESONANCE_CAMPAIGN_DRAFT_JSON_SCHEMA, RESONANCE_CAMPAIGN_VIEW_JSON_SCHEMA, RESONANCE_CLICK_IDENTIFIERS_JSON_SCHEMA, RESONANCE_COMMAND_JSON_SCHEMA, RESONANCE_COMMAND_PREPARE_REQUEST_JSON_SCHEMA, RESONANCE_COMMAND_PREPARE_RESPONSE_JSON_SCHEMA, RESONANCE_CONSENT_JSON_SCHEMA, RESONANCE_CONSENT_RESPONSE_JSON_SCHEMA, RESONANCE_CONSENT_UPDATE_JSON_SCHEMA, RESONANCE_CONVERSION_JSON_SCHEMA, RESONANCE_CPQL_UNCERTAINTY_METHOD, RESONANCE_CURRENCIES, RESONANCE_EXPERIMENT_COMPLETE_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_CREATE_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_LIFECYCLE_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_LINK_COMMAND_JSON_SCHEMA, RESONANCE_EXPERIMENT_REF_JSON_SCHEMA, RESONANCE_EXPERIMENT_UPDATE_COMMAND_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_REVIEW_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_SNAPSHOT_JSON_SCHEMA, RESONANCE_GOOGLE_CONFIGURATION_VIEW_JSON_SCHEMA, RESONANCE_GOOGLE_SETUP_SPEC_JSON_SCHEMA, RESONANCE_GOOGLE_SIGNAL_SEMANTICS, RESONANCE_GOOGLE_SOURCE_CATEGORIES, RESONANCE_MANDATE_ACTION_KIND, RESONANCE_MANDATE_APPROVAL_JSON_SCHEMA, RESONANCE_MANDATE_DRAFT_REQUEST_JSON_SCHEMA, RESONANCE_MANDATE_REF_JSON_SCHEMA, RESONANCE_MANDATE_SCOPE_JSON_SCHEMA, RESONANCE_MANDATE_TARGET_JSON_SCHEMA, RESONANCE_MAX_CHANNELS_PER_GROUP, RESONANCE_MEASUREMENT_CONFIGURATION_CURRENT_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIGURATION_SNAPSHOT_JSON_SCHEMA, RESONANCE_MEASUREMENT_CONFIG_JSON_SCHEMA, RESONANCE_MEASUREMENT_OCCURRENCE_JSON_SCHEMA, RESONANCE_META_AUDIENCE_REASONS, RESONANCE_META_AUDIENCE_VERDICTS, RESONANCE_META_CONFIGURATION_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_META_CONFIGURATION_SAVE_RESPONSE_JSON_SCHEMA, RESONANCE_META_CONFIGURATION_SNAPSHOT_JSON_SCHEMA, RESONANCE_META_CONFIGURATION_VIEW_JSON_SCHEMA, RESONANCE_META_QUERY_ATTRIBUTION_WINDOWS, RESONANCE_META_RETARGETING_READINESS_JSON_SCHEMA, RESONANCE_METRIC_JSON_SCHEMA, RESONANCE_OBSERVATIONS_PAGE_JSON_SCHEMA, RESONANCE_OBSERVATION_SUPPORT_JSON_SCHEMA, RESONANCE_OCCURRENCE_RESPONSE_JSON_SCHEMA, RESONANCE_OPTIMIZATION_DECISION_JSON_SCHEMA, RESONANCE_OPTIMIZATION_EVIDENCE_JSON_SCHEMA, RESONANCE_OPTIMIZATION_POLICY_JSON_SCHEMA, RESONANCE_PREPARED_PLAN_JSON_SCHEMA, RESONANCE_PROVIDER_METRIC_NAMES, RESONANCE_PROVIDER_REPORTING_GRANT_JSON_SCHEMA, RESONANCE_PROVIDER_REPORTING_SELECTION_JSON_SCHEMA, RESONANCE_PUBLIC_OBSERVATION_METRIC_JSON_SCHEMA, RESONANCE_QUALIFICATION_RULE_JSON_SCHEMA, RESONANCE_RECEIPT_JSON_SCHEMA, RESONANCE_RESOLVED_QUALIFICATION_RULE_JSON_SCHEMA, RESONANCE_RESOURCE_REF_JSON_SCHEMA, RESONANCE_SAVE_COMMAND_JSON_SCHEMA, RESONANCE_SCHEMA_VERSION, RESONANCE_SOURCE_MARKER_JSON_SCHEMA, RESONANCE_SOURCE_MARKER_PARAMETER, RESONANCE_SUBJECT_HEADER, RESONANCE_SUBJECT_RENEW_COMMAND_JSON_SCHEMA, RESONANCE_WEBSITE_VISIT_FEED_JSON_SCHEMA, RESONANCE_WEBSITE_VISIT_FEED_REVIEW_JSON_SCHEMA, RESONANCE_WEBSITE_VISIT_PROFILE, ResonanceValidationError, addMoney, checkAudienceBand, checkChannelGroups, compareMoney, cpqlMissingOutcomeBound, deriveProviderRatios, expandPropertyChannels, formatMoney, googleConversionActionSemantics, googleUploadClicksSetupSemantics, metaExclusionPolicy, moneyFromProviderUnits, moneyToProviderUnits, parseMoney, parseResonanceAcceptCommand, parseResonanceAccountCapability, parseResonanceAudienceDraftSaveCommand, parseResonanceAudienceRuleRef, parseResonanceBindingCommand, parseResonanceCampaignDefinition, parseResonanceCampaignDraft, parseResonanceCampaignSaveCommand, parseResonanceCampaignView, parseResonanceClickIdentifiers, parseResonanceCommand, parseResonanceCommandPrepareRequest, parseResonanceCommandPrepareResponse, parseResonanceConsentResponse, parseResonanceConsentSnapshot, parseResonanceConsentUpdate, parseResonanceConversionEnvelope, parseResonanceExperimentCompleteCommand, parseResonanceExperimentCreateCommand, parseResonanceExperimentExposure, parseResonanceExperimentLifecycleCommand, parseResonanceExperimentLinkCommand, parseResonanceExperimentRef, parseResonanceExperimentUpdateCommand, parseResonanceGoogleConfigurationReview, parseResonanceGoogleConfigurationSaveCommand, parseResonanceGoogleConfigurationSaveResponse, parseResonanceGoogleConfigurationSnapshot, parseResonanceGoogleConfigurationView, parseResonanceGoogleUploadClicksCustomGoalSpec, parseResonanceMandateApprovalPayload, parseResonanceMandateDraftRequest, parseResonanceMandateRef, parseResonanceMandateScope, parseResonanceMandateTarget, parseResonanceMeasurementConfig, parseResonanceMeasurementConfigurationCurrent, parseResonanceMeasurementConfigurationSaveCommand, parseResonanceMeasurementConfigurationSaveResponse, parseResonanceMeasurementConfigurationSnapshot, parseResonanceMeasurementOccurrence, parseResonanceMetaConfigurationSaveCommand, parseResonanceMetaConfigurationSaveResponse, parseResonanceMetaConfigurationSnapshot, parseResonanceMetaConfigurationView, parseResonanceMetaRetargetingReadiness, parseResonanceMetricObservation, parseResonanceObservationSupport, parseResonanceObservationsPage, parseResonanceOccurrenceResponse, parseResonanceOptimizationDecision, parseResonanceOptimizationEvidence, parseResonanceOptimizationPolicy, parseResonancePrepareCommand, parseResonancePreparedPlan, parseResonanceProviderReportingGrant, parseResonanceProviderReportingSelection, parseResonancePublicObservationMetric, parseResonanceQualificationRule, parseResonanceReceipt, parseResonanceResolvedQualificationRule, parseResonanceResourceRef, parseResonanceSourceMarker, parseResonanceSubjectRenewCommand, parseResonanceWebsiteVisitFeedReview, projectResonanceGoogleConfiguration, projectResonanceMeasurementConfiguration, projectResonanceMetaConfiguration, reportedCpqlMissingOutcomeBound, resonanceCommandDigestInput, resonanceGoogleConfigurationDigestInput, resonanceGoogleSetupDigestInput, resonanceMandateDigestInput, resonanceMeasurementConfigDigestInput, resonanceMeasurementConfigurationSaveDigestInput, resonanceMetaConfigurationDigestInput, resonanceMetaConfigurationSaveDigestInput, resonanceOptimizationDecisionDigestInput, resonanceOptimizationEvidenceDigestInput, resonanceOptimizationPolicyDigestInput, resonancePlanIssues, resonanceWebsiteVisitEventTime, resonanceWebsiteVisitProfileDigestInput, splitBudget, subtractMoney, suggestPropertyWeights };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sonordev/contracts",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.23.0",
|
|
4
4
|
"description": "The rules Sonor's sites, APIs and dashboard share: popup blocks and site design tokens, site hosts, SEO page identity, title quality, llms.txt sanitizers, shared form validation, fleet heartbeats, slot content and signing, site cache tags, portfolio metrics, the house voice's contraction rule, how a proposal's site plan counts its pages, what separates an error page from a page's content, which stored JSON-LD is a template's unfilled placeholder, where prose splits into sentences, which Sonor records Signal reads into a project's knowledge and the address each one is stored under, what outbound email and text may claim about a business and whether a sent email arrived intact, what a segment of outreach is and who may turn one on, a page's own name taken from its title or its slug, which Broadcast card layouts and review compositions are drawn and what a retired one draws as, what a publication's branding may hold, which literal hosts are refused as public fetch destinations, which inbox cards are decisions a bulk action leaves alone, what a rep's call outcome (positive, negative or left voicemail) changes on a prospect, and which buying role a job title says (owner, decision maker, influencer or gatekeeper). Pure functions, no dependencies.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|