@idosgames/core 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -14,6 +14,78 @@ and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.ht
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-08-10
+
+Real-money payment support. Every configured price becomes a **`PriceOptions` dictionary**, a
+store SKU becomes one of the ways to pay, and the client now tells the server which platform it
+runs on. Breaking — see below.
+
+### Added
+
+- **`PriceOption` / `PriceOptions` (`zPriceOption`, `zPriceOptions`)** — the platform-wide price
+  standard. A `ResourceConsume` is charged as a whole ("and"); a price across platforms is a
+  choice ("or") — a store SKU on mobile, a token on web. The dictionary key is the `OptionID`,
+  and the server substitutes it when the field is empty.
+- **`ResourceEntryType.Purchase` + `ResourceEntry.ProductID`** — an entry that means "paid in a
+  store". `ProductID` addresses `Purchase.Products`, our stable id, not a per-store SKU.
+- **`PaymentProof` (`zPaymentProof`)** — the receipt attached to a request. Required exactly when
+  the chosen option holds a `Purchase` entry: the server never takes money itself, it verifies
+  what the store issued to this client.
+- **`client.purchase` (`PurchaseService`)** — `getDefinitions`, `getUserState`,
+  `validatePurchase`, `validatePurchasesBatch`. `Resources` is applied only when `Granted` is
+  true: `AlreadyProcessed` and `Restored` carry the same block, and crediting it would pay the
+  reward twice for one payment — which is exactly what a store's re-delivered receipt looks like.
+- **`client.checkout` (`CheckoutService`)** — `availableOptions`, `isAvailable`, `requirementOf`,
+  `storeProductOf`, `cryptoShortfallOf`. It deliberately buys nothing: the purchase belongs to the
+  module that owns the entity (`client.store.purchase`, `client.lootbox.open`, …), which is the
+  only place that knows count, target ids and the idempotency key.
+- **`ClientPlatform`** (`Unknown | Web | Android | Ios`) and `IDosGamesClientConfig.clientPlatform`.
+  Auto-detected by `detectClientPlatform()` and sent as **`X-IG-Platform`** on every request —
+  once, in the transport, because a service that forgot to pass it would silently get a different
+  price list. Detection is conservative: a browser is `Web` even on a phone, only a real native
+  wrapper (Capacitor / Cordova) counts as `Android`/`Ios`, and no `navigator` at all is `Unknown`
+  rather than `Web`.
+- `SegmentGate.Platforms` — gate any definition on the client platform.
+- Optional **`selectedOptionID`** on every call that charges a configured price —
+  `store.purchase`, `lootbox.open`, `craft.craft`, `premium.purchaseItemOrCurrency`,
+  `character.unlockCharacter`, `collection.openPack`, `dealOffer.executeNode`,
+  `timedBoost.activate`, `item.upgradeLevel`, `coopEvent.spin`, `gameLoop.boardSpecialChoose`,
+  `match.createMatch`, `marketplace.createListing` / `createAuction`. Omitting it keeps
+  single-price entities working with no client change: the server takes the first option
+  available on this platform.
+- Optional **`payment`** (a `PaymentProof`) on the calls the server can settle against a store
+  receipt: `store.purchase`, `lootbox.open`, `character.unlockCharacter`, `collection.openPack`,
+  `dealOffer.executeNode`, `timedBoost.activate`. The rest deliberately have none — an upgrade
+  priced by a level formula, a per-fact coop spin, a refundable listing fee and a P2P match stake
+  cannot be one store SKU, and the server rejects a `Purchase` entry in those places.
+
+### Changed
+
+- **Every price field is now `PriceOptions`.** `StoreOfferDefinition.Cost`,
+  `CraftDefinition.RequiredResources`, `LootboxDefinition.PriceOptions` (was a list of
+  `LootboxPriceOption`), `PremiumDefinition.PriceOptions`, `CollectionPackDefinition.Cost`,
+  `CharacterDefinition.Unlock.Cost` / stat & level `BaseCostResource` / `UpgradeCost`,
+  `ItemUpgrade.BaseCostResource`, `TimedBoostDefinition.ActivationCost`,
+  `CoopEventBuildObjects.SpinCost`, `GameLoop` special-mode choice `EntryCost`,
+  `DealOfferPurchaseAction.DirectCost`, `MatchCreationSettings.Cost`,
+  `MarketplaceListingSettings.ListingFee` — all replaced by a `PriceOptions` dictionary.
+- `lootbox.open`'s `selectedOptionID` is a **string** (was `number`) and is now optional.
+- Prices come back **already filtered by the request's platform**, and the charge re-checks it.
+  The client renders what the server gave; a hidden option cannot be paid anyway.
+
+### Removed
+
+- **`ResourceEntryType.UsdCent`** — it was declared but never worked (any operation with it
+  failed inside the inventory layer), so a price in real money looked configurable while the
+  entity was impossible to buy. `Purchase` replaces it.
+
+### Migration
+
+Read a price through `client.checkout.availableOptions(entity.PriceOptions)` instead of the old
+single cost field, and pass the chosen `OptionID` to the module's buying call. A price paid in a
+store additionally needs a `PaymentProof` — buy in the store first, then hand the receipt to the
+same call. Nothing else changes for entities that keep a single price.
+
 ## [0.6.0] - 2026-08-09
 
 ### Added