@saasicat/core 1.0.0-rc.2 → 1.0.0-rc.21

package/README.md

@@ -1,5 +1,7 @@
 # @saasicat/core
 
+## What this is
+
 The shared core of the SaaS platform: the wire-format types — AdminManifest,
 PlanCatalog, PromoCode, AuditEvent, Subscription, PlanVersion, the adapter
 ports — **and the pure domain logic both sides run**: the error-code catalogues
@@ -15,6 +17,18 @@ types are generated from the schemas via `pnpm gen:types`
 (`json-schema-to-typescript`); a drift test keeps schemas and snapshots in
 sync.
 
+## What this is not
+
+Not a types-only package, despite what its predecessor's name promised. It
+carries 45 runtime exports — `classifyPlanDiff`, `applyPromo`,
+`resolveErrorMessage`, the error-code catalogues, the feature-requires rules —
+because backend and admin UI must reach the same verdict, and two
+implementations of the same rule reach two.
+
+Not the source of truth for the wire formats either. That is `@saasicat/spec`;
+the types under `src/generated/` are produced from its JSON Schemas, and a
+drift test rejects an edit made here.
+
 ## Contents
 
 | File                      | Contents                                                                                             |
@@ -56,3 +70,10 @@ Produces `dist/index.{js,cjs,d.ts,d.cts}` via `tsup`.
   there bumps this package's version as well.
 - **Required fields mirror the schemas.** Anything non-optional here must be
   non-optional in the schema too — otherwise it drifts.
+
+## Next
+
+- [The vocabulary](../../docs/explanation/concepts.md) — capability, feature, quota, plan, contract
+- [Codegen](../../docs/explanation/adr/0006-spec-to-types-codegen.md) — what is generated, and what
+  is not
+- [`@saasicat/spec`](../spec/README.md) — the schemas these types come from

package/dist/.build-stamp

@@ -1 +1 @@
-ee8d0e90b8c2c587712de31e1f611169c9bfa706ee51ca3a57cbf16586a7d998
+369e8bc186ed4a646394a1f9b7c7dcc8605204b4bae0e8c40edc4f3b5dd5e378