@thejob/schema 2.1.9 → 2.2.0

package/CLAUDE.md

@@ -76,6 +76,23 @@ keys, its `.default()`, and that union.
 
 Full picture: `thejob-notification-service/NOTIFICATIONS.md`.
 
+## Billing money is in MINOR units
+
+`src/billing/` is the one module where an amount is **not** what the rest of this
+package means by an amount. Salary fields (`salaryRange.min`, `minSalary`) are
+bare integers in the currency's **major** unit. Paddle works in **minor** units,
+so `MoneySchema.amountMinor` is cents: `999` is $9.99.
+
+The field is named `amountMinor` rather than `amount` precisely so it cannot be
+copied next to a `currency` field and read like the salary pair. Do not "tidy" it
+to `amount`, and do not convert on ingest — we store what Paddle sent.
+
+Two other things in that module are deliberate: Paddle status enums keep their
+underscores (`past_due`) because those are wire values compared as literals, and
+`FeatureKey` is informational only. Never constrain a stored field with
+`.oneOf(SupportedFeatureKeys)` — feature keys are data owned by billing-service,
+and validating them here would make every new paywall a release of this package.
+
 ## Conventions
 
 - One module per domain (`user/`, `job/`, `group/`, …), each exporting its schema and