@sonordev/contracts 2.18.0 → 2.21.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 CHANGED
@@ -1,5 +1,51 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.21.0
4
+
5
+ - Add optional, closed `page.experiment` authoring to managed Funnel drafts and definitions, with shared headline/body bounds and variant checks. Keep authored selection separate from the existing native-derived publication manifest. Plain documents stay compatible; older strict parsers reject extended documents, so consumers must adopt together before exposing authoring.
6
+
7
+ - Refuse observed provider metrics paired with unestablished support while retaining unknown per-metric values on complete query snapshots.
8
+
9
+ - Add an optional original read-only provider-reporting grant and a separate closed draft selector. Bind server-resolved scope, agent, principal and paid channels into the existing mandate review/digest while preserving old absent-field bytes. Native identity, original review and current admission remain separate authority checks.
10
+
11
+ - Add closed public observation item, support and page parsers with explicit native identity alignment, mandatory nonfinal provider flags and truthful first-party/unknown metrics. Preserve native-row pagination and the generic metric and optimizer contracts.
12
+
13
+ - Add one explicit SQL pre-read clock policy and evidence branch for conditional reported-cost allocation. Preserve immutable report provenance and independent outcome maturity without cross-clock freshness assumptions. Existing mature, finite and default profiles stay compatible; original native authority, expiry and funding remain separate requirements.
14
+
15
+ ## 2.20.0
16
+
17
+ - Publish the `resonance`, `resonance-constants` and `signal-experiments` entries with matching CommonJS, ESM and TypeScript surfaces. Add the documentation manifest used by sonor.dev. These validation contracts grant no campaign approval or spending authority.
18
+
19
+ - Bind current Meta configuration review to the existing semantic definition digest plus a nondecreasing audit revision. Add required native `currentDefinitionDigest` metadata so metadata-only saves can preserve multiple unchanged channel configurations. Original snapshots stay immutable; exact prepared-plan, approval and native root fences remain unchanged.
20
+
21
+ - Add pure native measurement bootstrap save/current/snapshot/response contracts and one deterministic page projection using existing semantic digest bytes. Native page resources retain UTC millisecond revisions; rule revisions use full existing evidence digests. Project/site CAS, actual protected writer and one read-only native freshness resolver remain separate adoption requirements.
22
+ - Add pure Meta configuration save/snapshot/view/response contracts, exact existing-audience or admitted-setup mappings, immutable friendly review material, shared digest/projection helpers, minimal optional mandate feed selection and post-acceptance original feed review. Preserve the raw existing mandate-draft response and no-feed request bytes. Saved profile references require actual persisted operation IDs and integer configuration revisions; parsing grants no native capability or approval.
23
+ - Add closed explicit `provider_managed` Meta age intent alongside unchanged absent, omitted and bounded behavior. Actual first same-root PAUSED creator observation and unchanged activation comparison remain native owner work; existing consumers must explicitly support the new branch before adoption.
24
+
25
+ - Add an optional original Meta website-visit feed grant and a closed internal `deliver_website_visit` command through the existing Resonance parser and digests. Preserve omitted legacy fields and require explicit native feed authority; parsing doesn't authenticate a producer or permit manual origination.
26
+ - Add same-occurrence reported path and Meta cookie observation shapes, one fixed SDK observation policy and canonical semantic configuration/profile digest helpers. Add original-time checks with an inclusive five-minute local freshness bound and zero future allowance. These are Sonor rules, not Meta acceptance guarantees; native capture, consent, admission and delivery remain separate.
27
+ - Represent explicit omitted or bounded original Meta age selection. Absent fields retain legacy bytes and don't choose defaults. Actual policy, compiler and normalized readback support remain adapter responsibilities.
28
+
29
+ - Add a closed Google qualified-conversion delivery command and explicit original mandate operation. Reference one original Google channel and a persisted conversion ID. Optional plan, mandate and time context checks public grant consistency and the original prepared definition revision; private facts, native receipts, current consent and final admission remain server-owned. Existing launch grants never expand automatically.
30
+
31
+ - Add closed finite Meta candidate policy, lifecycle evidence and one-action decision variants through the existing Resonance entry. Reference original candidate channel IDs, preserve mature allocation, and bind later graph evidence without a digest cycle. Fixed exploration explicitly has no performance-decision policy. Optional actual evidence/plan arguments check cross-object scope and action consistency; native funding and admission remain server-owned.
32
+
33
+ - Add optional, closed `clickIdentifiers` to page-view measurement occurrences. Accept exactly one bounded `gclid`, `gbraid` or `wbraid`; other occurrence kinds reject it. Export its parser, type and JSON Schema. Identifiers describe observed lineage and grant no conversion or provider authority.
34
+
35
+ - Add strict Google configuration draft, snapshot, view and review contracts, one canonical projection and a digest-input helper. Prepared Google Search previews require either actual existing-goal evidence or bounded one-action setup intent for creation after the same mandate; other channels use explicit `null`. Require the explicit historical `qualified_at_observation_v1` provider signal profile, distinct from current Sonor outcome counts. Draft declarations stay bound to their campaign and creative scope; parsing grants no provider or approval authority.
36
+
37
+ - Add strict command-preparation request and response parsers. Preparation reports existing mandate or current owner approval requirements and never grants authority. Add `@sonordev/contracts/resonance-constants` for browser wire literals without campaign schemas.
38
+
39
+ - Add canonical Signal experiment create/update parsers and bounded Resonance audience/experiment management commands. Add reviewed public source-marker fields and the explicit first-party last-touch attribution model. These parsers validate wire data and grant no approval or provider authority.
40
+
41
+ - Add `@sonordev/contracts/resonance`: strict campaign, account capability, prepared-plan, mandate lookup, command, receipt, measurement and consent boundaries for connected campaign operations. Money uses exact decimal-string micros with checked provider-unit conversion. Parsing validates data and scope; it never grants advertising or spending authority.
42
+ - Retain the 2.19 review-photo presentation exports and all existing contracts.
43
+
44
+ ## 2.19.0
45
+
46
+ - Add an optional per-review photo presentation to `@sonordev/contracts/broadcast-layouts`: `REVIEW_PHOTO_PRESENTATIONS`, `ReviewPhotoPresentation` and `isReviewPhotoPresentation` support the explicit `background` choice. Input consumers handle an omitted choice by preserving the saved value and `null` by clearing it to automatic. Existing automatic layouts, composition seeds and variation draws are unchanged.
47
+ - Keep the decision-role entry and all other published contracts behavior unchanged.
48
+
3
49
  ## 2.18.0
4
50
 
5
51
  A minor release: one new entry, `@sonordev/contracts/decision-roles`. Every other entry is unchanged.