reveclicat 0.1.0

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "reveclicat",
+  "version": "0.1.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",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "rcc": "dist/cli.js",
+    "purr": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "scenarios",
+    "examples",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run typecheck && npm run lint && npm test",
+    "prepublishOnly": "npm run check && npm run build"
+  },
+  "keywords": [
+    "revenuecat",
+    "webhooks",
+    "cli",
+    "subscriptions",
+    "testing",
+    "ci"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RadW2020/ReveCliCat.git"
+  },
+  "dependencies": {
+    "commander": "15.0.0",
+    "yaml": "2.9.0",
+    "zod": "4.5.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@types/express": "5.0.6",
+    "@types/node": "26.4.0",
+    "eslint": "10.9.1",
+    "express": "5.2.1",
+    "tsup": "8.5.1",
+    "tsx": "4.23.12",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.68.0",
+    "vitest": "4.1.11"
+  },
+  "homepage": "https://github.com/RadW2020/ReveCliCat#readme",
+  "bugs": {
+    "url": "https://github.com/RadW2020/ReveCliCat/issues"
+  },
+  "author": "RadW2020"
+}

package/scenarios/billing-issue-churns.yaml

@@ -0,0 +1,18 @@
+name: billing-issue-churns
+description: Trial converts, the first renewal charge fails, and the grace period ends without recovery
+subscriber:
+  app_user_id: auto
+  product_id: com.example.premium.monthly
+  period: P1M
+  trial: P1W
+  grace_period: P16D
+steps:
+  - event: INITIAL_PURCHASE      # trial starts
+  - advance: P1W
+  - event: RENEWAL               # trial → paid
+  - advance: P1M
+  - event: BILLING_ISSUE         # charge failed; grace period opens
+  - advance: P16D
+  - event: EXPIRATION            # expiration_reason: BILLING_ERROR — revoke access
+expect:
+  all_responses_status: 200

package/scenarios/billing-issue-recovers.yaml

@@ -0,0 +1,20 @@
+name: billing-issue-recovers
+description: Trial converts, the first renewal charge fails, and payment recovers within the grace period
+subscriber:
+  app_user_id: auto
+  product_id: com.example.premium.monthly
+  period: P1M
+  trial: P1W
+  grace_period: P16D
+steps:
+  - event: INITIAL_PURCHASE      # trial starts
+  - advance: P1W
+  - event: RENEWAL               # trial → paid
+  - advance: P1M
+  - event: BILLING_ISSUE         # charge failed; grace period opens (grace_period_expiration_at_ms)
+  - advance: P3D
+  - event: RENEWAL               # payment recovered; access never lapsed
+    expect:
+      response_status: 200
+expect:
+  all_responses_status: 200

package/scenarios/cancel-then-uncancel.yaml

@@ -0,0 +1,16 @@
+name: cancel-then-uncancel
+description: A paying subscriber cancels, changes their mind before expiry, and the subscription renews normally
+subscriber:
+  app_user_id: auto
+  product_id: com.example.premium.monthly
+  period: P1M
+steps:
+  - event: INITIAL_PURCHASE      # no trial: goes straight to active
+  - advance: P10D
+  - event: CANCELLATION          # auto-renew off
+  - advance: P5D
+  - event: UNCANCELLATION        # auto-renew back on; entitlements never lost
+  - advance: P15D
+  - event: RENEWAL               # renews at the end of the period as if nothing happened
+expect:
+  all_responses_status: 200

package/scenarios/happy-year.yaml

@@ -0,0 +1,35 @@
+name: happy-year
+description: A loyal monthly subscriber with no trial renews every month for a full year (13 events, one virtual year)
+subscriber:
+  app_user_id: auto
+  product_id: com.example.premium.monthly
+  period: P1M
+steps:
+  - event: INITIAL_PURCHASE
+  - advance: P1M
+  - event: RENEWAL               # renewal 1
+  - advance: P1M
+  - event: RENEWAL               # renewal 2
+  - advance: P1M
+  - event: RENEWAL               # renewal 3
+  - advance: P1M
+  - event: RENEWAL               # renewal 4
+  - advance: P1M
+  - event: RENEWAL               # renewal 5
+  - advance: P1M
+  - event: RENEWAL               # renewal 6
+  - advance: P1M
+  - event: RENEWAL               # renewal 7
+  - advance: P1M
+  - event: RENEWAL               # renewal 8
+  - advance: P1M
+  - event: RENEWAL               # renewal 9
+  - advance: P1M
+  - event: RENEWAL               # renewal 10
+  - advance: P1M
+  - event: RENEWAL               # renewal 11
+  - advance: P1M
+  - event: RENEWAL               # renewal 12
+expect:
+  all_responses_status: 200
+  max_response_ms: 2000

package/scenarios/trial-churns.yaml

@@ -0,0 +1,15 @@
+name: trial-churns
+description: A one-week free trial is cancelled on day 2; access ends when the trial expires
+subscriber:
+  app_user_id: auto
+  product_id: com.example.premium.monthly
+  period: P1M
+  trial: P1W
+steps:
+  - event: INITIAL_PURCHASE      # trial starts
+  - advance: P2D
+  - event: CANCELLATION          # auto-renew off; access continues until expiry
+  - advance: P5D
+  - event: EXPIRATION            # expiration_reason: UNSUBSCRIBE
+expect:
+  all_responses_status: 200

package/scenarios/trial-converts.yaml

@@ -0,0 +1,15 @@
+name: trial-converts
+description: A one-week free trial converts to a paid monthly subscription and renews once more
+subscriber:
+  app_user_id: auto
+  product_id: com.example.premium.monthly
+  period: P1M
+  trial: P1W
+steps:
+  - event: INITIAL_PURCHASE      # trial starts (period_type: TRIAL, price 0)
+  - advance: P1W
+  - event: RENEWAL               # trial → paid (is_trial_conversion: true)
+  - advance: P1M
+  - event: RENEWAL               # first regular renewal
+expect:
+  all_responses_status: 200