@ssheleg/sheleg-dev 0.6.0 → 0.7.0

package/plugins/sheleg-dev/skills/stripe-billing/fixtures/invoice-paid-subscription-cycle-next-period.json

@@ -0,0 +1,70 @@
+{
+  "id": "evt_PLACEHOLDER_cycle_feb",
+  "object": "event",
+  "api_version": "2026-07-29.dahlia",
+  "created": 1769904000,
+  "livemode": false,
+  "pending_webhooks": 1,
+  "request": {
+    "id": null,
+    "idempotency_key": null
+  },
+  "type": "invoice.paid",
+  "data": {
+    "object": {
+      "id": "in_PLACEHOLDER_feb",
+      "object": "invoice",
+      "status": "paid",
+      "billing_reason": "subscription_cycle",
+      "collection_method": "charge_automatically",
+      "currency": "usd",
+      "customer": "cus_PLACEHOLDER_alice",
+      "amount_due": 2900,
+      "amount_paid": 2900,
+      "amount_remaining": 0,
+      "attempt_count": 1,
+      "charge": "ch_PLACEHOLDER_feb",
+      "period_start": 1769904000,
+      "period_end": 1772323200,
+      "parent": {
+        "type": "subscription_details",
+        "subscription_details": {
+          "subscription": "sub_PLACEHOLDER_alice",
+          "metadata": {
+            "userId": "usr_PLACEHOLDER_alice",
+            "productId": "prod_PLACEHOLDER_pro",
+            "quantity": "1",
+            "conversionEventId": "evtid_PLACEHOLDER_purchase_feb"
+          }
+        }
+      },
+      "lines": {
+        "object": "list",
+        "has_more": false,
+        "total_count": 1,
+        "data": [
+          {
+            "id": "il_PLACEHOLDER_feb",
+            "object": "line_item",
+            "amount": 2900,
+            "currency": "usd",
+            "quantity": 1,
+            "proration": false,
+            "subscription_item": "si_PLACEHOLDER_alice",
+            "period": {
+              "start": 1769904000,
+              "end": 1772323200
+            },
+            "pricing": {
+              "type": "price_details",
+              "price_details": {
+                "price": "price_PLACEHOLDER_pro_monthly",
+                "product": "prod_PLACEHOLDER_pro"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}

package/plugins/sheleg-dev/skills/stripe-billing/fixtures/invoice-paid-subscription-cycle-redelivery.json

@@ -0,0 +1,70 @@
+{
+  "id": "evt_PLACEHOLDER_cycle_jan",
+  "object": "event",
+  "api_version": "2026-07-29.dahlia",
+  "created": 1767225600,
+  "livemode": false,
+  "pending_webhooks": 0,
+  "request": {
+    "id": null,
+    "idempotency_key": null
+  },
+  "type": "invoice.paid",
+  "data": {
+    "object": {
+      "id": "in_PLACEHOLDER_jan",
+      "object": "invoice",
+      "status": "paid",
+      "billing_reason": "subscription_cycle",
+      "collection_method": "charge_automatically",
+      "currency": "usd",
+      "customer": "cus_PLACEHOLDER_alice",
+      "amount_due": 2900,
+      "amount_paid": 2900,
+      "amount_remaining": 0,
+      "attempt_count": 1,
+      "charge": "ch_PLACEHOLDER_jan",
+      "period_start": 1767225600,
+      "period_end": 1769904000,
+      "parent": {
+        "type": "subscription_details",
+        "subscription_details": {
+          "subscription": "sub_PLACEHOLDER_alice",
+          "metadata": {
+            "userId": "usr_PLACEHOLDER_alice",
+            "productId": "prod_PLACEHOLDER_pro",
+            "quantity": "1",
+            "conversionEventId": "evtid_PLACEHOLDER_purchase_jan"
+          }
+        }
+      },
+      "lines": {
+        "object": "list",
+        "has_more": false,
+        "total_count": 1,
+        "data": [
+          {
+            "id": "il_PLACEHOLDER_jan",
+            "object": "line_item",
+            "amount": 2900,
+            "currency": "usd",
+            "quantity": 1,
+            "proration": false,
+            "subscription_item": "si_PLACEHOLDER_alice",
+            "period": {
+              "start": 1767225600,
+              "end": 1769904000
+            },
+            "pricing": {
+              "type": "price_details",
+              "price_details": {
+                "price": "price_PLACEHOLDER_pro_monthly",
+                "product": "prod_PLACEHOLDER_pro"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}

package/plugins/sheleg-dev/skills/stripe-billing/fixtures/invoice-paid-subscription-cycle.json

@@ -0,0 +1,61 @@
+{
+  "id": "evt_PLACEHOLDER_cycle_jan",
+  "object": "event",
+  "api_version": "2026-07-29.dahlia",
+  "created": 1767225600,
+  "livemode": false,
+  "pending_webhooks": 1,
+  "request": { "id": null, "idempotency_key": null },
+  "type": "invoice.paid",
+  "data": {
+    "object": {
+      "id": "in_PLACEHOLDER_jan",
+      "object": "invoice",
+      "status": "paid",
+      "billing_reason": "subscription_cycle",
+      "collection_method": "charge_automatically",
+      "currency": "usd",
+      "customer": "cus_PLACEHOLDER_alice",
+      "amount_due": 2900,
+      "amount_paid": 2900,
+      "amount_remaining": 0,
+      "attempt_count": 1,
+      "charge": "ch_PLACEHOLDER_jan",
+      "period_start": 1767225600,
+      "period_end": 1769904000,
+      "parent": {
+        "type": "subscription_details",
+        "subscription_details": {
+          "subscription": "sub_PLACEHOLDER_alice",
+          "metadata": {
+            "userId": "usr_PLACEHOLDER_alice",
+            "productId": "prod_PLACEHOLDER_pro",
+            "quantity": "1",
+            "conversionEventId": "evtid_PLACEHOLDER_purchase_jan"
+          }
+        }
+      },
+      "lines": {
+        "object": "list",
+        "has_more": false,
+        "total_count": 1,
+        "data": [
+          {
+            "id": "il_PLACEHOLDER_jan",
+            "object": "line_item",
+            "amount": 2900,
+            "currency": "usd",
+            "quantity": 1,
+            "proration": false,
+            "subscription_item": "si_PLACEHOLDER_alice",
+            "period": { "start": 1767225600, "end": 1769904000 },
+            "pricing": {
+              "type": "price_details",
+              "price_details": { "price": "price_PLACEHOLDER_pro_monthly", "product": "prod_PLACEHOLDER_pro" }
+            }
+          }
+        ]
+      }
+    }
+  }
+}

package/plugins/sheleg-dev/skills/stripe-billing/fixtures/invoice-paid-subscription-update-proration.json

@@ -0,0 +1,90 @@
+{
+  "id": "evt_PLACEHOLDER_proration_jan15",
+  "object": "event",
+  "api_version": "2026-07-29.dahlia",
+  "created": 1768435200,
+  "livemode": false,
+  "pending_webhooks": 1,
+  "request": {
+    "id": null,
+    "idempotency_key": null
+  },
+  "type": "invoice.paid",
+  "data": {
+    "object": {
+      "id": "in_PLACEHOLDER_proration",
+      "object": "invoice",
+      "status": "paid",
+      "billing_reason": "subscription_update",
+      "collection_method": "charge_automatically",
+      "currency": "usd",
+      "customer": "cus_PLACEHOLDER_alice",
+      "amount_due": 4000,
+      "amount_paid": 4000,
+      "amount_remaining": 0,
+      "attempt_count": 1,
+      "charge": "ch_PLACEHOLDER_proration",
+      "period_start": 1768435200,
+      "period_end": 1768435200,
+      "parent": {
+        "type": "subscription_details",
+        "subscription_details": {
+          "subscription": "sub_PLACEHOLDER_alice",
+          "metadata": {
+            "userId": "usr_PLACEHOLDER_alice",
+            "productId": "prod_PLACEHOLDER_pro",
+            "quantity": "2",
+            "conversionEventId": "evtid_PLACEHOLDER_proration_jan15"
+          }
+        }
+      },
+      "lines": {
+        "object": "list",
+        "has_more": false,
+        "total_count": 2,
+        "data": [
+          {
+            "id": "il_PLACEHOLDER_proration_credit",
+            "object": "line_item",
+            "amount": -1450,
+            "currency": "usd",
+            "quantity": 1,
+            "proration": true,
+            "subscription_item": "si_PLACEHOLDER_alice",
+            "period": {
+              "start": 1768435200,
+              "end": 1769904000
+            },
+            "pricing": {
+              "type": "price_details",
+              "price_details": {
+                "price": "price_PLACEHOLDER_pro_monthly",
+                "product": "prod_PLACEHOLDER_pro"
+              }
+            }
+          },
+          {
+            "id": "il_PLACEHOLDER_proration_charge",
+            "object": "line_item",
+            "amount": 5450,
+            "currency": "usd",
+            "quantity": 2,
+            "proration": true,
+            "subscription_item": "si_PLACEHOLDER_alice",
+            "period": {
+              "start": 1768435200,
+              "end": 1769904000
+            },
+            "pricing": {
+              "type": "price_details",
+              "price_details": {
+                "price": "price_PLACEHOLDER_pro_monthly",
+                "product": "prod_PLACEHOLDER_pro"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}

package/plugins/sheleg-dev/skills/stripe-billing/fixtures/manifest.json

@@ -0,0 +1,172 @@
+{
+  "skill": "stripe-billing",
+  "assertionPack": "assert-money-invariants.mjs",
+  "referenceHandler": "reference-handler.mjs",
+  "runbook": "README.md",
+  "note": "The single home of the invariant -> fixture -> document mapping. test/validate.py in this repository reads it: every fixture must be claimed by a row, every row's fixtures must exist, and every claiming document must still carry its phrase, name the invariant id, and name a path under fixtures/. A claim whose fixture is gone and a fixture nobody claims are both failures.",
+  "invariants": [
+    {
+      "id": "renewal-grants-exactly-once",
+      "isolates": "grant-on-renewal",
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "| `subscription_cycle` | the renewal | **yes** |"
+        }
+      ]
+    },
+    {
+      "id": "proration-invoice-grants-nothing",
+      "isolates": "billing-reason",
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json",
+        "invoice-paid-subscription-update-proration.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "mid-cycle proration (quantity or plan change)"
+        }
+      ]
+    },
+    {
+      "id": "sequential-redelivery-grants-once",
+      "isolates": "claim",
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json",
+        "invoice-paid-subscription-cycle-redelivery.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "- `claimEvent` = `INSERT`; unique violation means duplicate."
+        }
+      ]
+    },
+    {
+      "id": "concurrent-redelivery-grants-once",
+      "isolates": "claim",
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json",
+        "invoice-paid-subscription-cycle-redelivery.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "A failure to *claim* (database down) is a 503"
+        }
+      ]
+    },
+    {
+      "id": "sequential-redelivery-grants-once-by-count-alone",
+      "isolates": null,
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json",
+        "invoice-paid-subscription-cycle-redelivery.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/testing-and-local-dev.md",
+          "phrase": "two mechanisms cover each other"
+        }
+      ]
+    },
+    {
+      "id": "reconciliation-does-not-regrant",
+      "isolates": "grant-marker",
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "Guard the grant with a marker that survives a replay"
+        }
+      ]
+    },
+    {
+      "id": "out-of-order-pair-does-not-rewind-state",
+      "isolates": "ordering",
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json",
+        "invoice-paid-subscription-cycle-next-period.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "**Never derive state from arrival order.**"
+        }
+      ]
+    },
+    {
+      "id": "refund-total-is-cumulative",
+      "isolates": "cumulative-refund",
+      "fixtures": [
+        "charge-refunded-partial.json",
+        "charge-refunded-remainder.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "`amount_refunded` is **cumulative**."
+        }
+      ]
+    },
+    {
+      "id": "duplicate-refund-claws-back-once",
+      "isolates": null,
+      "fixtures": [
+        "charge-refunded-partial.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/testing-and-local-dev.md",
+          "phrase": "two mechanisms cover each other"
+        }
+      ]
+    },
+    {
+      "id": "unpaid-session-grants-nothing",
+      "isolates": "async-gate",
+      "fixtures": [
+        "checkout-session-completed-async-unpaid.json",
+        "checkout-session-async-payment-failed.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "grant belongs to `async_payment_succeeded`"
+        }
+      ]
+    },
+    {
+      "id": "paid-session-grants-once",
+      "isolates": "grant-on-checkout",
+      "fixtures": [
+        "checkout-session-completed-paid.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/webhook-events.md",
+          "phrase": "Uniqueness key: the subscription id for subscriptions, the payment intent id"
+        }
+      ]
+    },
+    {
+      "id": "conversion-id-survives-the-session",
+      "isolates": "conversion-id-from-metadata",
+      "fixtures": [
+        "invoice-paid-subscription-cycle.json"
+      ],
+      "claimedBy": [
+        {
+          "document": "references/testing-and-local-dev.md",
+          "phrase": "the id the browser will reuse"
+        }
+      ]
+    }
+  ]
+}