@plasius/economy 0.9.0 → 0.11.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/README.md CHANGED
@@ -50,7 +50,7 @@ outside signed PostgreSQL `bigint` range are rejected. Runtime validators also
50
50
  reject non-string JSON values rather than coercing numbers into wire amounts.
51
51
 
52
52
  `ActivityEntryV1` contains both a stable `source` (`shopify`, `ayet`, `bitlabs`,
53
- `subscription`, `event`, `competition`, or `adjustment`) and a bounded
53
+ `google-ad-manager`, `subscription`, `event`, `competition`, or `adjustment`) and a bounded
54
54
  display-oriented `sourceLabel`. Filters and reconciliation must use `source`;
55
55
  localized UI must use `sourceLabel`.
56
56
 
@@ -78,6 +78,32 @@ The default server ceilings are £50 per order and £100 per payer and household
78
78
  over 30 days. A consuming service may apply a lower household control but must
79
79
  not raise these defaults without a separately versioned policy decision.
80
80
 
81
+ ## Google rewarded web
82
+
83
+ `GoogleRewardedWebGrantClaimV1` deliberately labels GPT browser completion as
84
+ `client-claimed`; Google rewarded web has no server-side verification contract.
85
+ `GoogleRewardedWebReconciliationV1` separately proves final paid-impression,
86
+ eligible-net-revenue, nominal-liability, and reserve coverage.
87
+
88
+ The audited authority treats `google-ad-manager` as a provider command source.
89
+ Final reports use `authenticated-retrieval` evidence with a bounded retrieval
90
+ scheme and verification time; they cannot be represented as signed callbacks.
91
+ Legacy Shopify, ayeT, and BitLabs signed-evidence canonical bytes remain
92
+ unchanged. Google reward credits consequently require the provider-acceptance
93
+ and provider-result authority boundaries and produce `rewarded-ad` activity.
94
+
95
+ `createGoogleRewardedWebQuote()` uses exact integer GBP micros and issues one
96
+ whole Token only when conservative eligible net is at least 125,000 micros for
97
+ the 100,000-micro nominal liability. The completion bundle has no package
98
+ default. `google-ad-manager` source lots must be `same-user-only` and retain an
99
+ opaque internal claim identifier; the package exposes no Token transfer to a
100
+ linked account.
101
+
102
+ A parent-owned household service may eventually provide dependent family
103
+ access without moving Tokens or assigning the entitlement. That journey is
104
+ outside this V1 contract and must stay separately flagged off until Google has
105
+ approved its exact policy treatment in writing.
106
+
81
107
  ## Balanced journal transactions
82
108
 
83
109
  ```ts