crowdypy 0.14.1.dev1__tar.gz → 0.14.2.dev1__tar.gz

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/MIGRATION.md

@@ -3,6 +3,15 @@
 CrowdyPy is pre-1.0. Within a minor line, patch releases keep source compatibility; each
 new minor may change the API. Read the section for every minor you skip.
 
+## 0.14.2
+
+CrowdyJS 18.14.0 and CrowdyCPP 0.67.3. No breaking change. `PlayerWalletAPI.charges()` is
+deprecated and warns (`DeprecationWarning`), as the `playerUsageCharges` field it wraps is: it
+reads the cents-era hourly rows, which the lossless ledger does not write. Read
+`transactions()`: each `usage_debit` entry is one usage charge. The schema's billing
+descriptions are 18.14.0's. The vendored native core moves from CrowdyCPP 0.66.0 to 0.67.3;
+the replication client it binds is unchanged.
+
 ## 0.14.1
 
 CrowdyJS 18.13.0 and CrowdyCPP 0.66.0. Additive. A paused app, an app switched off, and a type switched off used to arrive as a bare denial. They are now `AppPaused`, `AppDisabled`, and `TypeDisabled`.

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdypy
-Version: 0.14.1.dev1
+Version: 0.14.2.dev1
 Summary: Official Python SDK for Crowded Kingdoms: typed GraphQL clients and a native UDP replication core
 Keywords: crowded-kingdoms,multiplayer,replication,graphql,sdk,udp
 Author: Crowded Kingdoms
@@ -51,6 +51,8 @@ CrowdyPy follows the [CrowdyJS](https://github.com/CrowdedKingdoms/CrowdyJS) API
 client, bound with [nanobind](https://github.com/wjakob/nanobind) and shipped inside the
 wheel. Python never touches a datagram.
 
+**v0.14.2: CrowdyJS 18.14.0 and CrowdyCPP 0.67.3.** `player_wallet.charges()` is deprecated: read `transactions()`, whose `usage_debit` entries are the usage charges.
+
 **v0.14.1: the exec socket names a paused app and a switched-off app or type.** `AppPaused`, `AppDisabled`, and `TypeDisabled`. Still CrowdyJS 18.13.0 and CrowdyCPP 0.66.0.
 
 **v0.14.0: the economy (CrowdyJS 18.13.0, CrowdyCPP 0.66.0).** `kit.player`, the caller's own

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/README.md

@@ -11,6 +11,8 @@ CrowdyPy follows the [CrowdyJS](https://github.com/CrowdedKingdoms/CrowdyJS) API
 client, bound with [nanobind](https://github.com/wjakob/nanobind) and shipped inside the
 wheel. Python never touches a datagram.
 
+**v0.14.2: CrowdyJS 18.14.0 and CrowdyCPP 0.67.3.** `player_wallet.charges()` is deprecated: read `transactions()`, whose `usage_debit` entries are the usage charges.
+
 **v0.14.1: the exec socket names a paused app and a switched-off app or type.** `AppPaused`, `AppDisabled`, and `TypeDisabled`. Still CrowdyJS 18.13.0 and CrowdyCPP 0.66.0.
 
 **v0.14.0: the economy (CrowdyJS 18.13.0, CrowdyCPP 0.66.0).** `kit.player`, the caller's own

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/docs/compatibility.md

@@ -5,7 +5,7 @@ are in `pyproject.toml` (`[project].version`, `[tool.crowdypy.crowdyjs]`,
 `[tool.crowdypy.crowdycpp]`); `tests/unit/test_release_versions.py` refuses this page when
 its version disagrees.
 
-- CrowdyPy `0.14.1`
+- CrowdyPy `0.14.2`
 - API surface: CrowdyJS (the pinned version and commit in `pyproject.toml`); the generated
   `docs/parity-matrix.md` lists every covered method, every native equivalent and every
   browser exclusion with its reason. The gate is strict: there are no portable gaps, and a

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/docs/parity-matrix.md

@@ -4,8 +4,8 @@ Generated by `tools/parity/parity.py`; do not edit by hand. Classifications live
 
 ## Target
 
-- CrowdyJS: `18.13.0` at `7aeee709ad661c836a045f2d396c9a867f1d278a`
-- CrowdyCPP (native core): `0.66.0` at `d57cafe80c48c45fdf9ae14309d59b80d466d308`
+- CrowdyJS: `18.14.0` at `9abcdf86c2b0440f113c8b7f15bd38fb23f51117`
+- CrowdyCPP (native core): `0.67.3` at `f09fc0b174b90e739f7128400792d5679e621b9b`
 - schema.gql identical to CrowdyJS's: yes
 - Gate mode: strict portable parity (every portable gap is release-blocking)
 

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "crowdypy"
-version = "0.14.1.dev1"
+version = "0.14.2.dev1"
 description = "Official Python SDK for Crowded Kingdoms: typed GraphQL clients and a native UDP replication core"
 readme = "README.md"
 license = "MIT AND Apache-2.0"
@@ -119,19 +119,19 @@ environment = { OPENSSL_ROOT_DIR = "C:/vcpkg/installed/x64-windows-static-md" }
 # --------------------------------------------------------------------------------------
 
 [tool.crowdypy.crowdyjs]
-version = "18.13.0"
-commit = "7aeee709ad661c836a045f2d396c9a867f1d278a"
+version = "18.14.0"
+commit = "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
 
 [tool.crowdypy.crowdycpp]
-version = "0.66.0"
-tag = "dev/v0.66.0"
-commit = "d57cafe80c48c45fdf9ae14309d59b80d466d308"
-tree-sha256 = "e92629e7d769516bdb126b9ad39f489b6d98d6c2f5f03743437127d370a689cf"
+version = "0.67.3"
+tag = "dev/v0.67.3"
+commit = "f09fc0b174b90e739f7128400792d5679e621b9b"
+tree-sha256 = "f0456195cc0948d96f8d7d987f2742722218c35ce60bbe9a34dfa3b9e6303541"
 
 # schema.gql and operations/ are CrowdyJS's, copied from the commit pinned above by
 # scripts/schema_sync.py, which records these hashes and re-derives them in CI.
 [tool.crowdypy.graphql]
-schema-sha256 = "b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0"
+schema-sha256 = "90d407b44d95416f23384023451b54edf73e18881dcad9ad9f06b20d8bd3fdfd"
 operations-sha256 = "37b1e06dc4e997bb42506968c50698a184934581a6d94d9471a29d2ce74ff3d3"
 
 # The SDL the docs site publishes. scripts/schema_drift.py compares the snapshot against it

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/schema.gql

@@ -1748,7 +1748,7 @@ type WalletTransaction {
   """DEPRECATED. balanceAfterMicrousd / 10,000 truncated toward zero."""
   balanceAfter: BigInt! @deprecated(reason: "Derived from balanceAfterMicrousd (truncated toward zero). Read balanceAfterMicrousd.")
   """
-  What produced this transaction. The complete set of values this API writes: "topup" (wallet credit from a completed checkout, positive), "admin_credit" (operator credit applied without a payment provider, positive), "auto_recharge" (off-session automatic wallet recharge, positive), "shared_usage" (hourly shared-environment metered charge for one closed clock hour, negative), "agent_usage" (Crowdy Studio agent run charged at provider cost, negative), "reserved_throughput" (monthly or prorated reserved capacity -- realtime bytes/s or GraphQL operations/s -- charged in addition to metered usage rather than including any of it, negative), "markup_payout" (the app developer's markup on a player's compute bill, credited to the org in the same transaction as the player debit that produced it, positive), "refund" (a payment-provider refund of a top-up, the credited amount leaving the wallet again, negative), "chargeback" (a card dispute on an org top-up, clawed back from the org wallet, negative). No other value is written; earlier versions of this description also listed "usage" and "environment_usage", neither of which was ever produced.
+  What produced this transaction. The complete set of values this API writes: "topup" (wallet credit from a completed checkout, positive), "admin_credit" (operator credit applied without a payment provider, positive), "auto_recharge" (off-session automatic wallet recharge, positive), "shared_usage" (metered shared-environment usage: the increase in what one dimension's period total costs since the last charge for it, negative), "agent_usage" (Crowdy Studio agent run charged at provider cost, negative), "reserved_throughput" (monthly or prorated reserved capacity -- realtime bytes/s or GraphQL operations/s -- charged in addition to metered usage rather than including any of it, negative), "markup_payout" (the app developer's markup on a player's metered usage, credited to the org in the same transaction as the player debit that produced it, positive), "refund" (a payment-provider refund of a top-up, the credited amount leaving the wallet again, negative), "chargeback" (a card dispute on an org top-up, clawed back from the org wallet, negative). No other value is written; earlier versions of this description also listed "usage" and "environment_usage", neither of which was ever produced.
   """
   transactionType: String!
   """
@@ -1888,7 +1888,7 @@ enum CheckoutPurpose {
   """
   @deprecated Legacy recurring subscription for a paid shared app slot. No longer purchasable via createCheckout; retained for historical checkouts and webhook reconciliation.
   """
-  SHARED_APP_SUBSCRIPTION @deprecated(reason: "Shared apps use org wallet hourly usage billing. Publish via publishAppToShared and top up with ORG_WALLET_TOPUP.")
+  SHARED_APP_SUBSCRIPTION @deprecated(reason: "Shared apps are billed for metered usage from the org wallet. Publish via publishAppToShared and top up with ORG_WALLET_TOPUP.")
 }
 
 """
@@ -2144,7 +2144,7 @@ type RateCardBandType {
 }
 
 """
-One priced dimension: its rate and, where it has one, its hourly free allowance. A dimension with a price of 0 is metered but not charged.
+One priced dimension: its rate and, where it has one, its free allowance and the period that allowance resets on. A dimension with a price of 0 is metered but not charged.
 """
 type RateCardEntryType {
   """Which card this row is on."""
@@ -2192,7 +2192,7 @@ type RateCardEntryType {
 }
 
 """
-Which rate card. SHARED prices organization metered usage for shared-environment apps (billed hourly to the org wallet as "shared_usage"). PLAYER prices player compute (billed hourly to the player wallet as "usage_debit").
+Which rate card. SHARED prices an organization's metered usage in shared-environment apps, charged to the org wallet as "shared_usage" entries. PLAYER prices a player's own metered usage (mod compute, egress, model storage and player-paid model tokens), charged to the player wallet as "usage_debit" entries with the app's markup added. Both settle about once a minute: each (payer, dimension, period) is charged what its running total now costs beyond what was already charged for it.
 """
 enum RateScope {
   SHARED
@@ -2506,7 +2506,7 @@ type PlayerWallet {
 }
 
 """
-One player-wallet ledger entry: top-ups, hourly usage debits, auto-recharges, refunds, and adjustments. Usage debits carry the app and reference the hour's charge row, whose snapshot splits platform vs studio-markup components.
+One player-wallet ledger entry: top-ups, usage debits, auto-recharges, refunds, purchases, payouts and adjustments. A usage debit carries the app and charges what one dimension's running total for its period now costs beyond what was already charged, the app's markup included, so a period can bring several debits as its usage arrives; its description names the dimension and the period.
 """
 type PlayerWalletTransaction {
   """Transaction id."""
@@ -2524,12 +2524,14 @@ type PlayerWalletTransaction {
   """DEPRECATED. balanceAfterMicrousd / 10,000 truncated toward zero."""
   balanceAfter: BigInt! @deprecated(reason: "Derived from balanceAfterMicrousd. Read balanceAfterMicrousd.")
   """
-  What produced this entry. The complete set of values this API writes: "topup" (credit from a completed checkout, positive), "auto_recharge" (off-session automatic recharge, positive), "payout_credit" (marketplace seller payout, positive), "refund" (marketplace refund returned to the buyer, positive), "usage_debit" (hourly player-compute metered charge for one closed clock hour, negative), "purchase" (marketplace purchase, negative), "adjustment" (operator or dispute-clawback correction, signed).
+  What produced this entry. The complete set of values this API writes: "topup" (credit from a completed checkout, positive), "auto_recharge" (off-session automatic recharge, positive), "payout_credit" (marketplace seller payout, positive), "refund" (marketplace refund returned to the buyer, positive), "usage_debit" (metered player usage in one app: the increase in what one dimension's period total costs since the last debit for it, markup included, negative), "purchase" (marketplace purchase, negative), "adjustment" (operator or dispute-clawback correction, signed).
   """
   transactionType: String!
   """Human description."""
   description: String
-  """External reference (checkout/PaymentIntent id)."""
+  """
+  External reference: the checkout or PaymentIntent id of a top-up, or for a usage debit the ledger charge it settles ("charge:<chargeId>:<n>", the n-th debit of that charge).
+  """
   referenceId: String
   """The app a usage debit covers; null for wallet-level entries."""
   appId: BigInt
@@ -2592,7 +2594,7 @@ type PlayerAutoBilling {
 }
 
 """
-One posted player usage charge: a (player, app, closed clock hour) row. amountCents = platformCents + markupCents — players see what the platform charges and what the studio adds (06 §4). The UNIQUE hour key makes the billing tick idempotent.
+One player usage charge from the hourly cents-era billing: a (player, app, closed clock hour) row. The lossless ledger, on by default, replaced that billing and writes no rows here, so the list ends where the ledger took over; usage since is in playerWalletTransactions as "usage_debit" entries. amountCents = platformCents + markupCents: what the platform charged and what the studio added.
 """
 type PlayerUsageCharge {
   """Charge id."""
@@ -7102,7 +7104,7 @@ type Query {
     scope: RateScope!
   ): [PublicRateCardEntryType!]!
   """
-  OPERATOR ONLY. The metered rate card for a scope: every priced dimension with its unit, price and hourly free allowance. SHARED is organization usage billed to the org wallet as "shared_usage"; PLAYER is player compute billed to the player wallet as "usage_debit". A dimension priced at 0 is metered but not charged. Read-only. Customers read the same rates through `meteredRateCard`, which is public and omits the operator note.
+  OPERATOR ONLY. The metered rate card for a scope: every priced dimension with its unit, price, free allowance and the period that allowance resets on. SHARED is organization usage charged to the org wallet as "shared_usage"; PLAYER is a player's own metered usage charged to the player wallet as "usage_debit". A dimension priced at 0 is metered but not charged. Read-only. Customers read the same rates through `meteredRateCard`, which is public and omits the operator note.
   """
   billingRateCard(
     """Which card to read."""
@@ -7287,7 +7289,7 @@ type Query {
   """
   playerWalletBalance: PlayerWallet!
   """
-  The caller's player-wallet ledger, newest first: top-ups, hourly usage debits (per app), auto-recharges, refunds, and adjustments. Usage-debit hours are broken down by playerUsageCharges, whose snapshot splits the platform and studio-markup components.
+  The caller's player-wallet ledger, newest first: top-ups, usage debits (per app, the app's markup included), auto-recharges, refunds, purchases, payouts and adjustments. Each usage debit names its dimension and period, and an over-charge credited back appears as an adjustment.
   """
   playerWalletTransactions(
     """Max entries (default 50, max 200)."""
@@ -7296,7 +7298,7 @@ type Query {
     offset: Int
   ): [PlayerWalletTransaction!]!
   """
-  The caller's posted hourly player-usage charges, newest first, optionally filtered by app. Each charge splits platformCents (base rate card) from markupCents (the studio's configured markup) with a per-metric snapshot — players always see what the platform charges and what the studio adds.
+  The caller's hourly player-usage charges from the cents-era billing, newest first, optionally filtered by app. Nothing has been added since the lossless ledger took over; current usage charges are the "usage_debit" entries in playerWalletTransactions.
   """
   playerUsageCharges(
     """Optional: only charges for this app."""
@@ -7305,7 +7307,7 @@ type Query {
     Maximum number of charges to return, 1 to 200 (a value outside is clamped). Defaults to 50 when omitted.
     """
     limit: Int
-  ): [PlayerUsageCharge!]!
+  ): [PlayerUsageCharge!]! @deprecated(reason: "Reads the hourly cents-era charge rows, which the lossless ledger does not write. Read playerWalletTransactions: each \"usage_debit\" entry is one charge, per app, markup included.")
   """
   The caller's self-set spend caps (global and per-app) with running counters. The effective runtime limit is min(developer policy, self-cap, wallet balance).
   """
@@ -9079,11 +9081,11 @@ type Mutation {
     referenceId: String
   ): WalletTransaction! @requiresPermission(scope: "operator", permission: "is_operator")
   """
-  OPERATOR ONLY. Runs the shared-usage billing tick once. It still bills only the last CLOSED clock hour — it will not charge an open hour. Use this to prove a closed-hour debit without waiting for the ~60s cron. Backdating usage rows is a local-test fixture, not something this mutation does on a live tier.
+  OPERATOR ONLY. Runs the shared-usage tick once instead of waiting for the ~60s cron: reserved-throughput billing, the itemised statement of the last closed clock hour, and the usage-gate evaluation of every shared app. Metered usage is priced and charged by the ledger's settlement, about once a minute, not by this tick. Backdating usage rows is a local-test fixture, not something this mutation does on a live tier.
   """
   runSharedUsageBillingTick: Boolean! @requiresPermission(scope: "operator", permission: "is_operator")
   """
-  OPERATOR ONLY. Sets a metered dimension's price, the UNIT that price is quoted in, its free allowances, or any combination, and returns the new row alongside the values that moved. THIS IS THE ONLY SANCTIONED WAY TO CHANGE A PRICE OR A UNIT: the schema seeds use ON CONFLICT DO NOTHING, so a rate reaches a tier once at install and a unit corrected in the declaration never reaches a tier that already exists. Refuses an unknown or unmetered metric (a rate for a dimension nothing meters bills nobody while appearing configured), refuses a negative price, refuses unitLabel without unitQuantity (which would restate the rate card while the arithmetic kept the old divisor), and refuses a call that would change nothing. A unit change that also moves the money needs acknowledgeRepricing: true, so restating a price and cutting it cannot be confused. priceBands sets a graduated schedule (SHARED aggregate_data_volume only; band 1 becomes priceCents) and clearPriceBands returns the dimension to one flat price; while a dimension is banded a bare priceCents or a unit change is refused. NOT RETROACTIVE: charges already written are history and the tick is idempotent per closed hour, so a new rate applies to hours billed from now on. Takes effect within about a minute — both billing ticks reload the card on every run, so no restart is needed.
+  OPERATOR ONLY. Sets a metered dimension's price, the UNIT that price is quoted in, its free allowances, or any combination, and returns the new row alongside the values that moved. THIS IS THE ONLY SANCTIONED WAY TO CHANGE A PRICE OR A UNIT: the schema seeds use ON CONFLICT DO NOTHING, so a rate reaches a tier once at install and a unit corrected in the declaration never reaches a tier that already exists. Refuses an unknown or unmetered metric (a rate for a dimension nothing meters bills nobody while appearing configured), refuses a negative price, refuses unitLabel without unitQuantity (which would restate the rate card while the arithmetic kept the old divisor), and refuses a call that would change nothing. A unit change that also moves the money needs acknowledgeRepricing: true, so restating a price and cutting it cannot be confused. priceBands sets a graduated schedule (SHARED aggregate_data_volume only; band 1 becomes priceCents) and clearPriceBands returns the dimension to one flat price; while a dimension is banded a bare priceCents or a unit change is refused. NOT RETROACTIVE: the ledger keeps the rate and allowance in force when a (payer, dimension, period) is first charged, so a change applies from each dimension's next period and nothing already charged is repriced. Takes effect within about a minute — the settlement reloads the card on every run, so no restart is needed.
   """
   setBillingRate(
     """Which dimension to reprice, the new price and/or allowance, and why."""
@@ -9105,7 +9107,7 @@ type Mutation {
     reason: String!
   ): BillingExemptOrgType! @requiresPermission(scope: "operator", permission: "is_operator")
   """
-  Publishes an app to the shared game-api environment. Free under the org's app-slot quota (result.free = true); beyond the quota, publish still succeeds and hourly usage is debited from the org wallet. Requires the 'manage_apps' permission on the app's org. Blocked when SHARED_GAME_API_URL is not configured.
+  Publishes an app to the shared game-api environment. Free under the org's app-slot quota (result.free = true); beyond the quota, publish still succeeds and metered usage is charged to the org wallet. Requires the 'manage_apps' permission on the app's org. Blocked when SHARED_GAME_API_URL is not configured.
   """
   publishAppToShared(
     """App id (BigInt) to publish to the shared environment."""
@@ -9287,7 +9289,7 @@ type Mutation {
     markupBps: Int!
   ): Int! @requiresPermission(scope: "app", permission: "manage_billing", scopeArg: "appId")
   """
-  Operator only. Credit the payer of an over-billed charge (an I3 finding: an allowance or rate was raised after the charge landed) the difference, and close the charge row. Idempotent per charge state. SIDE EFFECT: a wallet credit and a CREDIT event.
+  Operator only. Close an over-billed charge (an I3 finding: its priced total fell below what was billed and written off). The billed part of the difference is credited to the payer (a wallet credit and a CREDIT event); a written-off part (an exempt org) was never paid, so no money moves and a WRITE_OFF event of the opposite sign (reason OVERBILL_REVERSAL) offsets it. creditedMicrousd is the wallet credit only. Idempotent per charge state.
   """
   cpBillingCreditOverbill(
     """App the charge was billed under."""
@@ -10987,11 +10989,11 @@ input SetRateCardInput {
   """
   acknowledgeRepricing: Boolean
   """
-  New hourly free allowance in raw metric units, as a BigInt decimal string. Must be >= 0. Omit to leave the allowance unchanged.
+  New hourly free allowance in raw metric units, as a BigInt decimal string. Must be >= 0. Omit to leave the allowance unchanged. Like a price, it applies from a dimension's next period where a period has already been charged.
   """
   freePerHour: BigInt
   """
-  New free allowance in raw metric units per freePeriod, as a BigInt decimal string. Must be >= 0. Leaves the period as it is unless freePeriod is also given. Not combinable with freePerHour, which is the older spelling of freeUnits with freePeriod HOUR.
+  New free allowance in raw metric units per freePeriod, as a BigInt decimal string. Must be >= 0. Leaves the period as it is unless freePeriod is also given. Not combinable with freePerHour, which is the older spelling of freeUnits with freePeriod HOUR. Like a price, it applies from a dimension's next period where a period has already been charged.
   """
   freeUnits: BigInt
   """
@@ -10999,7 +11001,7 @@ input SetRateCardInput {
   """
   freePeriod: AllowancePeriod
   """
-  New monthly free allowance in raw metric units, as a BigInt decimal string. Must be >= 0. On the PLAYER card with metric player_wasm_compute_units this is the pooled monthly TRIAL BUDGET per (player, app) — the only sanctioned way to change it on a live tier. Omit to leave it unchanged.
+  New monthly free allowance in raw metric units, as a BigInt decimal string. Must be >= 0. On the PLAYER card with metric player_wasm_compute_units this is the pooled monthly TRIAL BUDGET per (player, app) — the only sanctioned way to change it on a live tier. Omit to leave it unchanged. Like a price, it applies from a dimension's next period where a period has already been charged.
   """
   freePerMonth: BigInt
   """

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/src/crowdypy/_generated/enums.py

@@ -1,6 +1,6 @@
 """GENERATED by scripts/codegen.py from schema.gql. Do not edit.
 
-schema.gql sha256: b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0
+schema.gql sha256: 90d407b44d95416f23384023451b54edf73e18881dcad9ad9f06b20d8bd3fdfd
 """
 
 from enum import StrEnum
@@ -364,7 +364,7 @@ class PlayerCodeOwnerKind(StrEnum):
 
 
 class RateScope(StrEnum):
-    'Which rate card. SHARED prices organization metered usage for shared-environment apps (billed hourly to the org wallet as "shared_usage"). PLAYER prices player compute (billed hourly to the player wallet as "usage_debit").'
+    'Which rate card. SHARED prices an organization\'s metered usage in shared-environment apps, charged to the org wallet as "shared_usage" entries. PLAYER prices a player\'s own metered usage (mod compute, egress, model storage and player-paid model tokens), charged to the player wallet as "usage_debit" entries with the app\'s markup added. Both settle about once a minute: each (payer, dimension, period) is charged what its running total now costs beyond what was already charged for it.'
     SHARED = 'SHARED'
     PLAYER = 'PLAYER'
 

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/src/crowdypy/_generated/inputs.py

@@ -4,7 +4,7 @@ Every GraphQL input object as a msgspec Struct. Attributes are snake_case and en
 under their GraphQL names; an attribute left at UNSET is omitted from the request,
 which is how the API tells 'not provided' from an explicit null.
 
-schema.gql sha256: b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0
+schema.gql sha256: 90d407b44d95416f23384023451b54edf73e18881dcad9ad9f06b20d8bd3fdfd
 """
 
 from __future__ import annotations

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/src/crowdypy/_generated/operations.py

@@ -1,6 +1,6 @@
 """GENERATED by scripts/codegen.py from schema.gql and operations/. Do not edit.
 
-schema.gql sha256: b8d487684433c99556979ed20283a9abc6b16bb02b9f6508f07600a662265ca0
+schema.gql sha256: 90d407b44d95416f23384023451b54edf73e18881dcad9ad9f06b20d8bd3fdfd
 operations/ sha256: 37b1e06dc4e997bb42506968c50698a184934581a6d94d9471a29d2ce74ff3d3
 """
 

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/src/crowdypy/_sync/domains/player_wallet.py

@@ -59,11 +59,18 @@ class PlayerWalletAPI(Domain):
     def charges(
         self, app_id: str | int | None = None, limit: int | None = None
     ) -> list[dict[str, Any]]:
-        """The caller's posted hourly usage charges, newest first, optionally for one app.
+        """Deprecated: the cents-era charges, which nothing adds to any more. Use
+        :meth:`transactions`: its ``usage_debit`` entries are the usage charges.
 
-        Each splits ``platformCents`` (the platform's rate card) from ``markupCents`` (the
-        studio's markup) with a per-metric snapshot. ``limit`` defaults to 50, at most 200.
+        The caller's hourly usage charges from before the lossless ledger, newest first,
+        optionally for one app. ``limit`` defaults to 50, at most 200.
         """
+        warnings.warn(
+            "PlayerWalletAPI.charges is deprecated: nothing is added to it any more; "
+            "the usage_debit entries of transactions are the usage charges",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         result: list[dict[str, Any]] = self._request(
             ops.PLAYER_USAGE_CHARGES, omit_none({"appId": _optional_bigint(app_id), "limit": limit})
         )

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/src/crowdypy/_version.py

@@ -1,3 +1,3 @@
 """The CrowdyPy release this source tree builds."""
 
-__version__ = "0.14.1"
+__version__ = "0.14.2"

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/src/crowdypy/domains/player_wallet.py

@@ -58,11 +58,18 @@ class PlayerWalletAPI(Domain):
     async def charges(
         self, app_id: str | int | None = None, limit: int | None = None
     ) -> list[dict[str, Any]]:
-        """The caller's posted hourly usage charges, newest first, optionally for one app.
+        """Deprecated: the cents-era charges, which nothing adds to any more. Use
+        :meth:`transactions`: its ``usage_debit`` entries are the usage charges.
 
-        Each splits ``platformCents`` (the platform's rate card) from ``markupCents`` (the
-        studio's markup) with a per-metric snapshot. ``limit`` defaults to 50, at most 200.
+        The caller's hourly usage charges from before the lossless ledger, newest first,
+        optionally for one app. ``limit`` defaults to 50, at most 200.
         """
+        warnings.warn(
+            "PlayerWalletAPI.charges is deprecated: nothing is added to it any more; "
+            "the usage_debit entries of transactions are the usage charges",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         result: list[dict[str, Any]] = await self._request(
             ops.PLAYER_USAGE_CHARGES, omit_none({"appId": _optional_bigint(app_id), "limit": limit})
         )

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/src/crowdypy/player_host/schemas.v1.json

@@ -1,7 +1,7 @@
 {
   "crowdyJs": {
-    "version": "18.13.0",
-    "commit": "7aeee709ad661c836a045f2d396c9a867f1d278a"
+    "version": "18.14.0",
+    "commit": "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
   },
   "schemas": {
     "GAME_COMMAND_RESULT_SCHEMA_V1": {

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/tests/fixtures/player-host.v1.json

@@ -1,8 +1,8 @@
 {
   "fixtureVersion": 1,
   "crowdyJs": {
-    "version": "18.13.0",
-    "commit": "7aeee709ad661c836a045f2d396c9a867f1d278a"
+    "version": "18.14.0",
+    "commit": "9abcdf86c2b0440f113c8b7f15bd38fb23f51117"
   },
   "errorCodes": [
     "AGENT_DISABLED",

{crowdypy-0.14.1.dev1 → crowdypy-0.14.2.dev1}/tests/unit/domains/test_social_domains.py

@@ -5,7 +5,7 @@ no client-side checks), so the contract under test is the operation, the variabl
 arguments as decimal strings, omitted optionals, idempotency keys under the document's
 variable name) and the root field handed back untouched. On top of that: the one argument
 whose omission and explicit null differ (``set_auto_billing``'s ``limit_cents``) and the
-deprecated ``app_markup_accrued``.
+deprecated ``app_markup_accrued`` and ``charges``.
 """
 
 from __future__ import annotations
@@ -435,16 +435,6 @@ CASES: list[Case] = [
         {"limit": 20, "offset": 40},
         [ROW],
     ),
-    Case(PlayerWalletAPI, "charges", (), "PlayerUsageCharges", {}, [ROW]),
-    Case(
-        PlayerWalletAPI,
-        "charges",
-        (42,),
-        "PlayerUsageCharges",
-        {"appId": "42", "limit": 5},
-        [ROW],
-        {"limit": 5},
-    ),
     Case(PlayerWalletAPI, "spend_caps", (), "PlayerSpendCaps", {}, [ROW]),
     Case(
         PlayerWalletAPI,
@@ -546,6 +536,7 @@ def test_method_set_is_crowdyjs_snake_cased_and_every_method_is_covered(
     covered = {case.method for case in CASES if case.domain is domain}
     if domain is PlayerWalletAPI:
         covered.add("app_markup_accrued")  # test_app_markup_accrued_is_deprecated
+        covered.add("charges")  # test_charges_is_deprecated
     assert covered == ported
 
 
@@ -587,6 +578,19 @@ async def test_app_markup_accrued_is_deprecated(api: MockApi, graphql: AsyncGrap
     assert api.last.variables == {"appId": "42"}
 
 
+async def test_charges_is_deprecated(api: MockApi, graphql: AsyncGraphQLClient) -> None:
+    wallet = PlayerWalletAPI(graphql)
+    api.reply_with_root([ROW])
+    with pytest.warns(DeprecationWarning, match="usage_debit"):
+        assert await wallet.charges() == [ROW]
+    assert api.last.operation_name == "PlayerUsageCharges"
+    assert api.last.query == ops.PLAYER_USAGE_CHARGES.document
+    assert api.last.variables == {}
+    with pytest.warns(DeprecationWarning, match="usage_debit"):
+        await wallet.charges(42, limit=5)
+    assert api.last.variables == {"appId": "42", "limit": 5}
+
+
 async def test_a_bad_id_is_refused_before_anything_is_sent(
     api: MockApi, graphql: AsyncGraphQLClient
 ) -> None: