reveclicat 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented here. Format based on [Keep a
 
 ## [Unreleased]
 
+## [0.2.0] — 2026-08-29
+
+### Added
+- Google Play in the generator: `--store play_store` / `subscriber.store: play_store` emit `store: PLAY_STORE`, `GPA.dddd-dddd-dddd-ddddd` order ids with `..N` renewal suffixes (Google's `Purchase.getOrderId` convention), a new order on resubscription, and the `<subscription_id>:<base_plan_id>` default product id. New example `scenarios/play-trial-converts.yaml` (`rcc init` now copies 7 scenarios). (T-071, T-072)
+
+### Changed
+- `product_id` no longer has a default in the scenario schema / `--product`; the per-store default is applied by the generator. Explicit values are unchanged. (T-071)
+
 ## [0.1.1] — 2026-08-29
 
 ### Fixed
@@ -41,6 +49,7 @@ First release. Unofficial project — not affiliated with RevenueCat, Inc.
 - Consistent error output: every error prints `✖ message` + `→ hint`; usage errors (unknown command/option, missing argument) exit with code 2, other failures with 1; `RCC_DEBUG=1` shows stack traces; `NO_COLOR` honoured. (T-052)
 - Programmatic API (`reveclicat` package): schemas, `Subscriber`, `runScenario`, `loadScenario`, `VirtualClock`, `createRng`.
 
-[Unreleased]: https://github.com/RadW2020/ReveCliCat/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/RadW2020/ReveCliCat/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/RadW2020/ReveCliCat/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/RadW2020/ReveCliCat/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/RadW2020/ReveCliCat/releases/tag/v0.1.0

package/README.md

@@ -94,7 +94,7 @@ subscriber:                          # all optional
   period: P1M                        # ISO-8601 duration
   trial: P1W                         # omit → no trial
   grace_period: P16D                 # billing-retry window after BILLING_ISSUE
-  store: app_store                   # v0.1: app_store only
+  store: app_store                   # app_store | play_store (Google-shaped ids and product_id format)
   environment: SANDBOX               # SANDBOX | PRODUCTION
 steps:
   - event: INITIAL_PURCHASE          # starts the trial (period_type: TRIAL, price 0)
@@ -115,7 +115,7 @@ expect:
 
 Rules: a step is exactly one of `event` or `advance`; unknown keys are errors; validation errors point at `file:line:column`. Illegal transitions stop the run with the step number and the list of legal events. `EXPIRATION` is only allowed once the virtual clock has reached `expiration_at_ms` (or the end of the grace period) — the error tells you exactly how much to `advance`.
 
-Shipped examples (`rcc init` copies them): `trial-converts`, `trial-churns`, `billing-issue-recovers`, `billing-issue-churns`, `cancel-then-uncancel`, `happy-year` (12 renewals).
+Shipped examples (`rcc init` copies them): `trial-converts`, `trial-churns`, `billing-issue-recovers`, `billing-issue-churns`, `cancel-then-uncancel`, `happy-year` (12 renewals), `play-trial-converts` (Google Play ids).
 
 ## CI
 
@@ -174,7 +174,7 @@ none ──INITIAL_PURCHASE──▶ trial ──RENEWAL (conversion)──▶ a
 ## Fidelity & scope
 
 - Schemas, enums and inclusion rules come from the official docs (fetched 2026-08-29) and the official sample payloads are used as test fixtures. The `TEST` event has no published sample, so its schema is marked *provisional* — a captured real one is very welcome (see `docs/BACKLOG.md`, T-004).
-- v0.1 models the **App Store** only. Google Play, Stripe, Amazon and Roku stores, a built-in tunnel, a web UI and hosted mode are intentionally out of scope (see the Icebox in `docs/BACKLOG.md`).
+- The generator models **App Store** (`--store app_store`, 16-digit transaction ids, original kept across resubscriptions) and **Google Play** (`--store play_store`, `GPA.…` order ids with `..N` renewal suffixes, `<subscription_id>:<base_plan_id>` product ids, new order on resubscription). Stripe, Amazon and Roku, a built-in tunnel, a web UI and hosted mode are intentionally out of scope (see the Icebox in `docs/BACKLOG.md`). Receivers accept events from every store.
 - Programmatic use: `import { runScenario, Subscriber, WebhookEnvelopeSchema } from "reveclicat"`.
 
 ## How this was built

package/dist/cli.js

@@ -9,7 +9,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "reveclicat",
-  version: "0.1.1",
+  version: "0.2.0",
   description: "Unofficial CLI to simulate RevenueCat subscription lifecycles and test webhooks locally and in CI. Not affiliated with RevenueCat, Inc.",
   type: "module",
   license: "MIT",
@@ -165,8 +165,9 @@ var CANCEL_REASONS = [
   "UNKNOWN"
 ];
 var EXPIRATION_REASONS = [...CANCEL_REASONS, "SUBSCRIPTION_PAUSED"];
-var CLI_STORES = ["app_store"];
-var CLI_STORE_TO_STORE = { app_store: "APP_STORE" };
+var CLI_STORES = ["app_store", "play_store"];
+var CLI_STORE_TO_STORE = { app_store: "APP_STORE", play_store: "PLAY_STORE" };
+var DEFAULT_PRODUCT_ID = { app_store: "com.example.premium.monthly", play_store: "com.example.premium:monthly" };
 
 // src/core/config.ts
 var CONFIG_FILE = "reveclicat.config.json";
@@ -609,13 +610,14 @@ var Subscriber = class {
     this.period = asDuration(opts.period);
     this.trial = opts.trial === void 0 ? void 0 : asDuration(opts.trial);
     this.grace = asDuration(opts.gracePeriod ?? "P16D");
-    this.store = CLI_STORE_TO_STORE[opts.store ?? "app_store"];
+    this.cliStore = opts.store ?? "app_store";
+    this.store = CLI_STORE_TO_STORE[this.cliStore];
     this.environment = opts.environment ?? "SANDBOX";
     this.price = opts.price ?? 9.99;
     this.currency = opts.currency ?? "USD";
     this.countryCode = opts.countryCode ?? "US";
     this.entitlementIds = opts.entitlementIds ?? ["premium"];
-    this.productId = opts.productId;
+    this.productId = opts.productId ?? DEFAULT_PRODUCT_ID[this.cliStore];
     this.appUserId = opts.appUserId === void 0 || opts.appUserId === "auto" ? `$RCAnonymousID:${deps.rng.hex(32)}` : opts.appUserId;
     this.appId = opts.appId ?? `app${deps.rng.hex(12)}`;
   }
@@ -627,6 +629,9 @@ var Subscriber = class {
   trial;
   grace;
   store;
+  cliStore;
+  /** Play: number of renewals on the current order (drives the `..N` suffix). */
+  renewalIndex = 0;
   environment;
   price;
   currency;
@@ -673,6 +678,7 @@ var Subscriber = class {
       this.expirationAtMs = draft.expirationAtMs;
       this.periodType = draft.periodType;
       this.gracePeriodExpirationAtMs = draft.gracePeriodExpirationAtMs;
+      this.renewalIndex = draft.renewalIndex;
       if (type === "CANCELLATION") this.resumeState = from === "trial" ? "trial" : "active";
       this._state = next;
     }
@@ -681,11 +687,23 @@ var Subscriber = class {
     return event;
   }
   /* ----------------------------------------------------------- internals */
-  newTransactionId() {
-    let s = String(1 + this.deps.rng.int(9));
-    for (let i = 0; i < 15; i++) s += String(this.deps.rng.int(10));
+  digits(n) {
+    let s = "";
+    for (let i = 0; i < n; i++) s += String(this.deps.rng.int(10));
     return s;
   }
+  /** A brand-new order/transaction id in the store's format (see specs/F7-google-play.md). */
+  newTransactionId() {
+    if (this.cliStore === "play_store") {
+      return `GPA.${this.digits(4)}-${this.digits(4)}-${this.digits(4)}-${this.digits(5)}`;
+    }
+    return String(1 + this.deps.rng.int(9)) + this.digits(15);
+  }
+  /** Renewal id: Play appends `..N` to the original order id; App Store issues a fresh transaction id. */
+  renewalTransactionId(originalId, index) {
+    if (this.cliStore === "play_store" && originalId !== void 0) return `${originalId}..${index}`;
+    return this.newTransactionId();
+  }
   draftFor(type, from, now) {
     const d = {
       originalTransactionId: this.originalTransactionId,
@@ -693,13 +711,16 @@ var Subscriber = class {
       purchasedAtMs: this.purchasedAtMs,
       expirationAtMs: this.expirationAtMs,
       periodType: this.periodType,
-      gracePeriodExpirationAtMs: this.gracePeriodExpirationAtMs
+      gracePeriodExpirationAtMs: this.gracePeriodExpirationAtMs,
+      renewalIndex: this.renewalIndex
     };
     switch (type) {
       case "INITIAL_PURCHASE": {
         const startsTrial = from === "none" && this.trial !== void 0;
         d.transactionId = this.newTransactionId();
-        d.originalTransactionId ??= d.transactionId;
+        if (this.cliStore === "play_store") d.originalTransactionId = d.transactionId;
+        else d.originalTransactionId ??= d.transactionId;
+        d.renewalIndex = 0;
         d.purchasedAtMs = now;
         d.expirationAtMs = addDuration(now, startsTrial ? this.trial : this.period);
         d.periodType = startsTrial ? "TRIAL" : "NORMAL";
@@ -708,7 +729,8 @@ var Subscriber = class {
       }
       case "RENEWAL": {
         const start = d.expirationAtMs ?? now;
-        d.transactionId = this.newTransactionId();
+        d.transactionId = this.renewalTransactionId(d.originalTransactionId, d.renewalIndex);
+        d.renewalIndex += 1;
         d.purchasedAtMs = start;
         d.expirationAtMs = addDuration(start, this.period);
         d.periodType = "NORMAL";
@@ -974,8 +996,8 @@ function parseEnvironment(input) {
 }
 function parseStore(input) {
   if (CLI_STORES.includes(input)) return input;
-  throw new RccError(`Unsupported --store "${input}". v0.1 supports: ${CLI_STORES.join(", ")}.`, {
-    hint: "Other stores are on the roadmap (see docs/BACKLOG.md \u2192 Icebox)."
+  throw new RccError(`Unsupported --store "${input}". The generator supports: ${CLI_STORES.join(", ")}.`, {
+    hint: "Receivers (listen/tail/inbox) accept events from every store; only generation is limited. Others are in the Icebox."
   });
 }
 function parseSeed(input) {
@@ -999,7 +1021,7 @@ function buildSingleEvent(type, opts) {
   return { api_version: "1.0", event };
 }
 function registerSend(program, io) {
-  program.command("send").argument("<EVENT_TYPE>", `event to send: ${EVENT_TYPES.join(" | ")}`).description("Send a single, schema-valid RevenueCat webhook event to your endpoint.").option("--to <url>", `target URL (default: ${DEFAULT_TARGET}, or "to" in ${CONFIG_FILE})`).option("--store <store>", `store: ${CLI_STORES.join(" | ")} (default: app_store, or "store" in ${CONFIG_FILE})`).option("--user <app_user_id>", "app_user_id (default: generated $RCAnonymousID)").option("--product <product_id>", "product_id", "com.example.premium.monthly").option("--auth-header <value>", `value sent as the Authorization header (default: "authHeader" in ${CONFIG_FILE})`).option("--environment <env>", `${ENVIRONMENTS.join(" | ")} (default: SANDBOX, or "environment" in ${CONFIG_FILE})`).option("--set <key=value>", "override a payload field (repeatable, dot paths allowed)", (v, acc) => [...acc ?? [], v]).option("--seed <seed>", "deterministic ids and timestamps").option("--dry-run", "print the payload instead of sending it").addHelpText("after", `
+  program.command("send").argument("<EVENT_TYPE>", `event to send: ${EVENT_TYPES.join(" | ")}`).description("Send a single, schema-valid RevenueCat webhook event to your endpoint.").option("--to <url>", `target URL (default: ${DEFAULT_TARGET}, or "to" in ${CONFIG_FILE})`).option("--store <store>", `store to simulate: ${CLI_STORES.join(" | ")} (default: app_store, or "store" in ${CONFIG_FILE})`).option("--user <app_user_id>", "app_user_id (default: generated $RCAnonymousID)").option("--product <product_id>", "product_id (default: com.example.premium.monthly, or com.example.premium:monthly for play_store)").option("--auth-header <value>", `value sent as the Authorization header (default: "authHeader" in ${CONFIG_FILE})`).option("--environment <env>", `${ENVIRONMENTS.join(" | ")} (default: SANDBOX, or "environment" in ${CONFIG_FILE})`).option("--set <key=value>", "override a payload field (repeatable, dot paths allowed)", (v, acc) => [...acc ?? [], v]).option("--seed <seed>", "deterministic ids and timestamps").option("--dry-run", "print the payload instead of sending it").addHelpText("after", `
 Examples:
   $ rcc send INITIAL_PURCHASE
   $ rcc send RENEWAL --to http://localhost:8787/webhook --auth-header "Bearer dev"
@@ -1211,12 +1233,13 @@ var eventType = z3.enum(EVENT_TYPES, {
 var httpStatus = z3.int({ error: "response_status must be an integer HTTP status (e.g. 200)." }).min(100).max(599);
 var SubscriberConfigSchema = z3.strictObject({
   app_user_id: z3.string().min(1).default("auto"),
-  product_id: z3.string().min(1).default("com.example.premium.monthly"),
+  /** No default here: the Subscriber picks a per-store default (see specs/F7-google-play.md). */
+  product_id: z3.string().min(1).optional(),
   period: duration.default("P1M"),
   trial: duration.optional(),
   grace_period: duration.default("P16D"),
   store: z3.enum(CLI_STORES, {
-    error: (iss) => `Unsupported store "${String(iss.input)}". v0.1 supports: ${list(CLI_STORES)}.`
+    error: (iss) => `Unsupported store "${String(iss.input)}". Supported: ${list(CLI_STORES)}.`
   }).default("app_store"),
   environment: z3.enum(ENVIRONMENTS, {
     error: (iss) => `Invalid environment "${String(iss.input)}". Use one of: ${list(ENVIRONMENTS)}.`
@@ -1253,7 +1276,6 @@ var ScenarioSchema = z3.strictObject({
   description: z3.string().optional(),
   subscriber: SubscriberConfigSchema.default({
     app_user_id: "auto",
-    product_id: "com.example.premium.monthly",
     period: "P1M",
     grace_period: "P16D",
     store: "app_store",