# Subscrio

> Open-source entitlement engine for .NET and TypeScript. Subscrio stores products, features, plans, billing cycles, customers, and subscriptions in your database, then resolves feature access from plans, add-ons, overrides, and configured cross-subscription rules. Metered usage and credit wallets account for consumption.

These pages are the library reference and implementation guides. Use the TypeScript package `subscrio` or the .NET package `Subscrio.Core`. Subscrio does not process payments, run feature-flag rollouts, replace RBAC, or activate device licenses.

## Start here

- [Welcome](https://docs.subscrio.com/): What Subscrio is, how the entitlement model fits together, and where to start
- [Getting Started](https://docs.subscrio.com/reference/getting-started/): Install the library, define a small catalog, assign a subscription, and resolve feature access

## Guides

- [How Subscrio Works](https://docs.subscrio.com/reference/entitlements-guide/): Products, features, plans, customers, subscriptions and runtime access checks; choosing overrides, subscription add-ons, metering or shared credits, with links to complete TypeScript and .NET workflows.
- [Subscription Lifecycle](https://docs.subscrio.com/reference/subscription-lifecycle/): How status is computed from dates (`pending`, `trial`, `active`, `cancellation_pending`, `cancelled`, `expired`)
- [How Feature Values Are Calculated](https://docs.subscrio.com/reference/feature-resolution/): Configure how plan and add-on values combine, resolve multiple subscriptions, and apply overrides until a specified expiration.

- [Add-ons and Overrides](https://docs.subscrio.com/reference/addons-and-overrides/): Reusable packages, quantities, and individual exceptions.
- [Metered Usage Workflows](https://docs.subscrio.com/reference/metered-usage-workflows/): Scopes, periods, enforcement, and idempotent usage reports.
- [Credit Wallet Workflows](https://docs.subscrio.com/reference/credit-wallet-workflows/): Shared wallets, spending, scheduled grants, and corrections.
- [Managing Configuration](https://docs.subscrio.com/reference/managing-configuration/): Import/export, replacement rules, and partial failures.

## Library Reference

- [Subscrio](https://docs.subscrio.com/reference/core-overview/): Subscrio class, configuration, and public object catalog
- [Features](https://docs.subscrio.com/reference/features/): Global feature definitions (`toggle`, `numeric`, `text`, `metered`) and catalog methods
- [Add-ons](https://docs.subscrio.com/reference/addons/): Optional subscription packages such as extra seats or usage capacity, distinct from integration extensions. Metering, credits and timed overrides work without add-ons.
- [Products](https://docs.subscrio.com/reference/products/): Product lifecycle, archival, deletion guards, and feature associations
- [Plans](https://docs.subscrio.com/reference/plans/): Plan lifecycle, feature values, and expiration transitions
- [Billing Cycles](https://docs.subscrio.com/reference/billing-cycles/): Renewal duration, cadence, forever cycles, and Stripe price IDs
- [Customers](https://docs.subscrio.com/reference/customers/): Customer keys, archival, and `externalBillingId`
- [Subscriptions](https://docs.subscrio.com/reference/subscriptions/): Subscription writes, lifecycle dates, and feature overrides
- [Feature Checker](https://docs.subscrio.com/reference/feature-checker/): Runtime feature resolution at subscription and customer scope
- [Metered Usage](https://docs.subscrio.com/reference/metering/): Configuration, quota checks, reporting, retries and history.
- [Credits](https://docs.subscrio.com/reference/credits/): Currencies, rules, grant scheduling, balances, consumption, adjustments and ledger.
- [Hooks](https://docs.subscrio.com/reference/hooks/): Before/after events for customer, subscription, Stripe, add-on attachment, usage and credit writes
- [Configuration Sync](https://docs.subscrio.com/reference/config-sync/): Sync the entitlement catalog from JSON or `ConfigSyncDto`
- [Stripe Integration](https://docs.subscrio.com/reference/stripe-integration/): `processStripeEvent`, checkout sessions, and webhook handlers

## Extensions & Integrations

- [Extending Subscrio](https://docs.subscrio.com/reference/how-to-extend/): Inline hooks, first-party packages, and custom extensions
- [Stripe Setup](https://docs.subscrio.com/reference/how-to-integrate-with-stripe/): Map Stripe IDs and forward verified webhook events

## Database

- [Relationships](https://docs.subscrio.com/reference/relationships/): How products, features, plans, billing cycles, customers, and subscriptions relate
- [Schema Upgrade](https://docs.subscrio.com/reference/upgrading-entitlements/): Schema 1.4.0, preserved resolution defaults and coordinated deployment.

All 14 Library Reference pages use the header language selector for TypeScript and .NET signatures, examples, and property definitions. Each page includes a method catalog, method details, linked data types, and related guides. Initialization is documented on the Subscrio page; shared update conventions are in Getting Started.