@sudobility/subscription_service 1.0.5 → 1.0.7

package/CLAUDE.md

@@ -1,54 +1,76 @@
-# Subscription Service
+# Subscription Service - AI Development Guide
 
-Shared backend library for subscription management using RevenueCat.
+## Overview
 
-**npm**: `@sudobility/subscription_service` (public)
+Shared backend library for subscription management using RevenueCat. Provides a `SubscriptionHelper` class that calls the RevenueCat REST API v1 to fetch user entitlements and subscription information. Designed for server-side use only (requires a secret API key).
 
-## Tech Stack
-
-- **Language**: TypeScript (strict mode)
-- **Runtime**: Bun
+- **Package**: `@sudobility/subscription_service`
+- **Version**: 1.0.5
+- **License**: BUSL-1.1
 - **Package Manager**: Bun (do not use npm/yarn/pnpm for installing dependencies)
-- **Build**: TypeScript compiler (ESM)
-- **Test**: vitest
+- **Registry**: npm (public, `@sudobility` scope)
 
 ## Project Structure
 
 ```
 src/
-├── index.ts                    # Main exports
+├── index.ts                    # Main barrel exports
 ├── types/
 │   ├── index.ts                # Type re-exports
-│   ├── entitlements.ts         # RevenueCat API types
+│   ├── entitlements.ts         # RevenueCat API response types
 │   └── subscription.ts         # SubscriptionInfo type
 └── helpers/
     ├── index.ts                # Helper re-exports
-    └── SubscriptionHelper.ts   # RevenueCat API client
+    └── SubscriptionHelper.ts   # RevenueCat API client class
 tests/
-└── *.test.ts
+└── SubscriptionHelper.test.ts  # Vitest tests (mocked fetch)
 ```
 
-## Commands
+## Key Exports
+
+| Export | Type | Description |
+|---|---|---|
+| `SubscriptionHelper` | class | Main API client for RevenueCat entitlements |
+| `SubscriptionHelperConfig` | interface | Config with `revenueCatApiKey` and optional `baseUrl` |
+| `SubscriptionInfo` | interface | Return type with `entitlements` and `subscriptionStartedAt` |
+| `RevenueCatEntitlement` | interface | Raw entitlement from RevenueCat API |
+| `RevenueCatSubscription` | interface | Raw subscription from RevenueCat API |
+| `RevenueCatSubscriberResponse` | interface | Full subscriber response shape |
+
+## Development Commands
 
 ```bash
-bun run build        # Build ESM
+bun run build        # Build ESM (tsc -p tsconfig.esm.json)
 bun run clean        # Remove dist/
-bun run dev          # Watch mode
-bun test             # Run tests
-bun run lint         # Run ESLint
-bun run typecheck    # TypeScript check
-bun run verify       # All checks + build (use before commit)
+bun run dev          # Watch mode (tsc --watch)
+bun test             # Run tests (vitest run)
+bun run test:watch   # Watch mode tests (vitest)
+bun run lint         # Run ESLint (eslint src/)
+bun run lint:fix     # ESLint auto-fix
+bun run typecheck    # TypeScript check (tsc --noEmit)
+bun run format       # Prettier format
+bun run format:check # Prettier check
+bun run verify       # All checks + build (typecheck -> lint -> test -> build)
+npm publish          # Publish to npm (public @sudobility scope)
 ```
 
 ## Key Concepts
 
 ### SubscriptionHelper
 
-Fetches user entitlements from RevenueCat API v1.
+Fetches user entitlements from RevenueCat API v1 (`GET /subscribers/{user_id}`).
 
 - Uses RevenueCat secret API key (server-side only)
-- Supports testMode to include/exclude sandbox purchases
-- Returns `["none"]` if user has no active entitlements
+- Supports `testMode` to include/exclude sandbox purchases
+- Returns `["none"]` (the `NONE_ENTITLEMENT` constant from `@sudobility/types`) if user has no active entitlements
+- Tracks the earliest `purchase_date` across all active entitlements as `subscriptionStartedAt`
+
+### Methods
+
+| Method | Signature | Description |
+|---|---|---|
+| `getEntitlements` | `(userId, testMode?) => Promise<string[]>` | Get active entitlement names |
+| `getSubscriptionInfo` | `(userId, testMode?) => Promise<SubscriptionInfo>` | Get entitlements + subscription start date |
 
 ### testMode Parameter
 
@@ -60,7 +82,8 @@ The helper checks each subscription's `sandbox` flag and filters accordingly.
 ## Usage
 
 ```typescript
-import { SubscriptionHelper, NONE_ENTITLEMENT } from "@sudobility/subscription_service";
+import { SubscriptionHelper } from "@sudobility/subscription_service";
+import { NONE_ENTITLEMENT } from "@sudobility/types";
 
 const helper = new SubscriptionHelper({
   revenueCatApiKey: process.env.REVENUECAT_API_KEY!,
@@ -71,7 +94,7 @@ const entitlements = await helper.getEntitlements(userId);
 // Returns: ["pro"] or ["none"]
 
 // Get entitlements (test mode - includes sandbox)
-const entitlements = await helper.getEntitlements(userId, true);
+const testEntitlements = await helper.getEntitlements(userId, true);
 
 // Get full subscription info
 const info = await helper.getSubscriptionInfo(userId, testMode);
@@ -85,12 +108,29 @@ if (!info.entitlements.includes(NONE_ENTITLEMENT)) {
 
 ## Architecture
 
+### TypeScript Configuration
+
+- Base `tsconfig.json`: strict mode, ES2020 target, bundler module resolution, `noEmit: true`
+- `tsconfig.esm.json`: extends base, adds ESNext module output to `./dist`, declaration + declarationMap + sourceMap
+- `tsconfig.cjs.json`: exists but build script uses ESM config only
+
+### Build Output
+
+- ESM-only output to `./dist/`
+- Declaration files (`.d.ts`) and declaration maps (`.d.ts.map`) included
+- Source maps enabled
+- Published files: `dist/**/*` and `CLAUDE.md`
+
+### Dependency Graph
+
 ```
+@sudobility/types (peer dependency - provides NONE_ENTITLEMENT)
+    |
 subscription_service (this package)
-    ↑
+    ^
 ratelimit_service (depends on this)
-    ↑
-shapeshyft_api, sudojo_api, etc.
+    ^
+shapeshyft_api, sudojo_api, whisperly_api
 ```
 
 ## Consuming APIs
@@ -101,35 +141,27 @@ APIs using this library:
 - whisperly_api
 - ratelimit_service
 
+## Testing
+
+- Framework: Vitest (vitest run)
+- Tests located in `tests/` directory (not alongside source)
+- Uses `vi.fn()` and `vi.stubGlobal("fetch", ...)` to mock HTTP calls
+- Tests cover: 404 handling, API errors, active entitlements, expired entitlements, sandbox filtering, test mode, multiple entitlements with earliest date
+
 ## Publishing
 
 ```bash
-bun run verify       # All checks
+bun run verify       # All checks (typecheck -> lint -> test -> build)
 npm publish          # Publish to npm
 ```
 
-## Workspace Context
-
-This project is part of the **ShapeShyft** multi-project workspace at the parent directory. See `../CLAUDE.md` for the full architecture, dependency graph, and build order.
-
-## Downstream Impact
-
-| Downstream Consumer | Relationship |
-|---------------------|-------------|
-| `shapeshyft_api` | Direct dependency - uses SubscriptionHelper for entitlement checks |
-
-After making changes:
-1. `bun run verify` in this project (includes tests)
-2. `npm publish`
-3. In `shapeshyft_api`: `bun update @sudobility/subscription_service` then rebuild
-
 ## Local Dev Workflow
 
 ```bash
 # In this project:
 bun link
 
-# In shapeshyft_api:
+# In consuming API:
 bun link @sudobility/subscription_service
 
 # Rebuild after changes:
@@ -139,6 +171,32 @@ bun run build
 bun unlink @sudobility/subscription_service && bun install
 ```
 
+## Peer / Key Dependencies
+
+### Peer Dependencies
+
+| Package | Version | Purpose |
+|---|---|---|
+| `@sudobility/types` | `^1.9.53` | Provides `NONE_ENTITLEMENT` constant |
+
+### Dev Dependencies
+
+| Package | Version | Purpose |
+|---|---|---|
+| `typescript` | ^5.9.0 | Compiler |
+| `vitest` | ^4.0.4 | Test runner |
+| `eslint` | ^9.39.0 | Linter |
+| `prettier` | ^3.7.0 | Formatter |
+| `@typescript-eslint/eslint-plugin` | ^8.50.0 | TS-aware ESLint rules |
+| `@typescript-eslint/parser` | ^8.50.0 | TS ESLint parser |
+| `eslint-plugin-import` | ^2.32.0 | Import order/validation rules |
+| `@types/bun` | latest | Bun runtime types |
+| `@types/node` | ^24.0.0 | Node.js type definitions |
+
+## Workspace Context
+
+This project is part of the Sudobility multi-project workspace at the parent directory. See `../CLAUDE.md` for the full architecture, dependency graph, and build order.
+
 ## Pre-Commit Checklist
 
 ```bash
@@ -147,8 +205,11 @@ bun run verify    # Runs: typecheck -> lint -> test -> build
 
 ## Gotchas
 
-- **No peer dependencies** -- this package is fully self-contained (`"peerDependencies": {}`).
+- **No runtime dependencies** -- Only `@sudobility/types` as a peer dependency (for `NONE_ENTITLEMENT`). All HTTP calls use native `fetch`.
 - **RevenueCat API key is a server-side secret** -- never expose it to the client.
 - **`testMode` controls sandbox filtering** -- in production, always pass `false`. Passing `true` includes sandbox purchases with fake entitlements.
-- **`NONE_ENTITLEMENT` is the string `"none"`** -- it is a constant, not null/undefined. Always compare with `NONE_ENTITLEMENT`.
-- **ESM-only output** -- no CJS build.
+- **`NONE_ENTITLEMENT` is the string `"none"`** -- it is a constant imported from `@sudobility/types`, not null/undefined. Always compare with `NONE_ENTITLEMENT`.
+- **ESM-only output** -- no CJS build. The `tsconfig.cjs.json` exists but is unused by the build script.
+- **404 from RevenueCat returns `["none"]`** -- Not an error; it means the user has never been seen by RevenueCat.
+- **`baseUrl` defaults to `https://api.revenuecat.com/v1`** -- Override for testing with a mock server.
+- **User ID is URL-encoded** -- `encodeURIComponent(userId)` is applied before constructing the API URL.

package/dist/helpers/SubscriptionHelper.d.ts

@@ -1,3 +1,10 @@
+/**
+ * @fileoverview RevenueCat API client for server-side subscription management.
+ *
+ * Provides the `SubscriptionHelper` class that calls the RevenueCat REST API v1
+ * to fetch user entitlements and subscription information. Handles sandbox
+ * filtering via the `testMode` parameter.
+ */
 import type { SubscriptionInfo } from "../types/subscription";
 /**
  * Configuration for SubscriptionHelper.
@@ -7,21 +14,48 @@ export interface SubscriptionHelperConfig {
     revenueCatApiKey: string;
     /** Base URL for RevenueCat API. Defaults to https://api.revenuecat.com/v1 */
     baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 10000 (10 seconds). */
+    timeoutMs?: number;
 }
 /**
  * Helper class for interacting with RevenueCat API to get user entitlements
  * and subscription information.
+ *
+ * Uses the RevenueCat REST API v1 endpoint `GET /subscribers/{user_id}` to
+ * fetch subscriber data, then filters entitlements by expiration and sandbox status.
  */
 export declare class SubscriptionHelper {
     private readonly apiKey;
     private readonly baseUrl;
+    private readonly timeoutMs;
+    /**
+     * Creates a new SubscriptionHelper instance.
+     *
+     * @param config - Configuration containing the RevenueCat API key and optional base URL.
+     */
     constructor(config: SubscriptionHelperConfig);
     /**
      * Get active entitlement names for a user.
+     *
+     * This is a convenience wrapper around `getSubscriptionInfo()` that returns
+     * only the entitlements array.
+     *
+     * @param userId - The RevenueCat user identifier.
+     * @param testMode - When true, includes sandbox purchases. Defaults to false.
+     * @returns Array of active entitlement names, or `["none"]` if no active entitlements.
      */
     getEntitlements(userId: string, testMode?: boolean): Promise<string[]>;
     /**
      * Get full subscription info including entitlements and subscription start date.
+     *
+     * Fetches the subscriber data from RevenueCat, filters out expired entitlements
+     * and (optionally) sandbox purchases, and returns the active entitlement names
+     * along with the earliest purchase date.
+     *
+     * @param userId - The RevenueCat user identifier.
+     * @param testMode - When true, includes sandbox purchases. Defaults to false.
+     * @returns Subscription info with active entitlements and earliest purchase date.
+     * @throws Error if the RevenueCat API returns a non-404, non-OK response.
      */
     getSubscriptionInfo(userId: string, testMode?: boolean): Promise<SubscriptionInfo>;
 }

package/dist/helpers/SubscriptionHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubscriptionHelper.d.ts","sourceRoot":"","sources":["../../src/helpers/SubscriptionHelper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,wBAAwB;IAK5C;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpB;;OAEG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC;CAgE7B"}
+{"version":3,"file":"SubscriptionHelper.d.ts","sourceRoot":"","sources":["../../src/helpers/SubscriptionHelper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;OAIG;gBACS,MAAM,EAAE,wBAAwB;IAM5C;;;;;;;;;OASG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC;IASpB;;;;;;;;;;;OAWG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC;CA6E7B"}

package/dist/helpers/SubscriptionHelper.js

@@ -1,32 +1,79 @@
+/**
+ * @fileoverview RevenueCat API client for server-side subscription management.
+ *
+ * Provides the `SubscriptionHelper` class that calls the RevenueCat REST API v1
+ * to fetch user entitlements and subscription information. Handles sandbox
+ * filtering via the `testMode` parameter.
+ */
 import { NONE_ENTITLEMENT } from "@sudobility/types";
 /**
  * Helper class for interacting with RevenueCat API to get user entitlements
  * and subscription information.
+ *
+ * Uses the RevenueCat REST API v1 endpoint `GET /subscribers/{user_id}` to
+ * fetch subscriber data, then filters entitlements by expiration and sandbox status.
  */
 export class SubscriptionHelper {
+    /**
+     * Creates a new SubscriptionHelper instance.
+     *
+     * @param config - Configuration containing the RevenueCat API key and optional base URL.
+     */
     constructor(config) {
         this.apiKey = config.revenueCatApiKey;
         this.baseUrl = config.baseUrl ?? "https://api.revenuecat.com/v1";
+        this.timeoutMs = config.timeoutMs ?? 10000;
     }
     /**
      * Get active entitlement names for a user.
+     *
+     * This is a convenience wrapper around `getSubscriptionInfo()` that returns
+     * only the entitlements array.
+     *
+     * @param userId - The RevenueCat user identifier.
+     * @param testMode - When true, includes sandbox purchases. Defaults to false.
+     * @returns Array of active entitlement names, or `["none"]` if no active entitlements.
      */
     async getEntitlements(userId, testMode = false) {
+        if (!userId || typeof userId !== "string") {
+            throw new Error("userId must be a non-empty string");
+        }
         const info = await this.getSubscriptionInfo(userId, testMode);
         return info.entitlements;
     }
     /**
      * Get full subscription info including entitlements and subscription start date.
+     *
+     * Fetches the subscriber data from RevenueCat, filters out expired entitlements
+     * and (optionally) sandbox purchases, and returns the active entitlement names
+     * along with the earliest purchase date.
+     *
+     * @param userId - The RevenueCat user identifier.
+     * @param testMode - When true, includes sandbox purchases. Defaults to false.
+     * @returns Subscription info with active entitlements and earliest purchase date.
+     * @throws Error if the RevenueCat API returns a non-404, non-OK response.
      */
     async getSubscriptionInfo(userId, testMode = false) {
+        if (!userId || typeof userId !== "string") {
+            throw new Error("userId must be a non-empty string");
+        }
         const url = `${this.baseUrl}/subscribers/${encodeURIComponent(userId)}`;
-        const response = await fetch(url, {
-            method: "GET",
-            headers: {
-                Authorization: `Bearer ${this.apiKey}`,
-                "Content-Type": "application/json",
-            },
-        });
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
         if (response.status === 404) {
             return {
                 entitlements: [NONE_ENTITLEMENT],

package/dist/helpers/SubscriptionHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubscriptionHelper.js","sourceRoot":"","sources":["../../src/helpers/SubscriptionHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAcrD;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAI7B,YAAY,MAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,+BAA+B,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,WAAoB,KAAK;QAEzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,MAAc,EACd,WAAoB,KAAK;QAEzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,YAAY,EAAE,CAAC,gBAAgB,CAAC;gBAChC,qBAAqB,EAAE,IAAI;aAC5B,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiC,CAAC;QACrE,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,IAAI,EAAE,CAAC;QACzD,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,IAAI,EAAE,CAAC;QAE3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,kBAAkB,GAAa,EAAE,CAAC;QACxC,IAAI,oBAAoB,GAAgB,IAAI,CAAC;QAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/D,MAAM,QAAQ,GACZ,CAAC,WAAW,CAAC,YAAY,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC;YAExE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,MAAM,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;YACnE,IAAI,CAAC,QAAQ,IAAI,YAAY,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;gBAChD,SAAS;YACX,CAAC;YAED,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE9B,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;YACzD,IAAI,CAAC,oBAAoB,IAAI,YAAY,GAAG,oBAAoB,EAAE,CAAC;gBACjE,oBAAoB,GAAG,YAAY,CAAC;YACtC,CAAC;QACH,CAAC;QAED,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,YAAY,EAAE,CAAC,gBAAgB,CAAC;gBAChC,qBAAqB,EAAE,IAAI;aAC5B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,YAAY,EAAE,kBAAkB;YAChC,qBAAqB,EAAE,oBAAoB;SAC5C,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"SubscriptionHelper.js","sourceRoot":"","sources":["../../src/helpers/SubscriptionHelper.ts"],"names":[],"mappings":"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"}

package/dist/helpers/index.d.ts

@@ -1,2 +1,5 @@
+/**
+ * @fileoverview Helper re-exports for subscription_service.
+ */
 export { SubscriptionHelper, type SubscriptionHelperConfig, } from "./SubscriptionHelper";
 //# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC"}

package/dist/helpers/index.js

@@ -1,2 +1,5 @@
+/**
+ * @fileoverview Helper re-exports for subscription_service.
+ */
 export { SubscriptionHelper, } from "./SubscriptionHelper";
 //# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,10 @@
+/**
+ * @fileoverview Public API for @sudobility/subscription_service.
+ *
+ * Re-exports all types and the SubscriptionHelper class for server-side
+ * subscription management via RevenueCat.
+ */
 export { type RevenueCatEntitlement, type RevenueCatSubscription, type RevenueCatSubscriberResponse, type SubscriptionInfo, } from "./types";
+export { NONE_ENTITLEMENT } from "@sudobility/types";
 export { SubscriptionHelper, type SubscriptionHelperConfig, } from "./helpers";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,3 +1,11 @@
+/**
+ * @fileoverview Public API for @sudobility/subscription_service.
+ *
+ * Re-exports all types and the SubscriptionHelper class for server-side
+ * subscription management via RevenueCat.
+ */
+// Constants (convenience re-export)
+export { NONE_ENTITLEMENT } from "@sudobility/types";
 // Helpers
 export { SubscriptionHelper, } from "./helpers";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,UAAU;AACV,OAAO,EACL,kBAAkB,GAEnB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,oCAAoC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,UAAU;AACV,OAAO,EACL,kBAAkB,GAEnB,MAAM,WAAW,CAAC"}

package/dist/types/entitlements.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @fileoverview RevenueCat API response types for the subscriber endpoint.
+ *
+ * These interfaces model the JSON response from RevenueCat's
+ * `GET /v1/subscribers/{user_id}` endpoint.
+ */
 /**
  * RevenueCat entitlement information from the subscriber API.
  */

package/dist/types/entitlements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../../src/types/entitlements.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mCAAmC;IACnC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE;QACV,YAAY,EAAE;YACZ,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAC;SACtC,CAAC;QACF,aAAa,EAAE;YACb,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAAC;SACvC,CAAC;KACH,CAAC;CACH"}
+{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../../src/types/entitlements.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mCAAmC;IACnC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE;QACV,YAAY,EAAE;YACZ,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAC;SACtC,CAAC;QACF,aAAa,EAAE;YACb,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAAC;SACvC,CAAC;KACH,CAAC;CACH"}

package/dist/types/entitlements.js

@@ -1,2 +1,8 @@
+/**
+ * @fileoverview RevenueCat API response types for the subscriber endpoint.
+ *
+ * These interfaces model the JSON response from RevenueCat's
+ * `GET /v1/subscribers/{user_id}` endpoint.
+ */
 export {};
 //# sourceMappingURL=entitlements.js.map

package/dist/types/entitlements.js.map

@@ -1 +1 @@
-{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../src/types/entitlements.ts"],"names":[],"mappings":""}
+{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../src/types/entitlements.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/index.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @fileoverview Type re-exports for subscription_service.
+ */
 export { type RevenueCatEntitlement, type RevenueCatSubscription, type RevenueCatSubscriberResponse, } from "./entitlements";
 export { type SubscriptionInfo } from "./subscription";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,GAClC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,GAClC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -1,2 +1,5 @@
+/**
+ * @fileoverview Type re-exports for subscription_service.
+ */
 export {};
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/subscription.d.ts

@@ -1,8 +1,11 @@
+/**
+ * @fileoverview Domain types for subscription information returned by SubscriptionHelper.
+ */
 /**
  * Subscription information returned by SubscriptionHelper.
  */
 export interface SubscriptionInfo {
-    /** Array of active entitlement names */
+    /** Array of active entitlement names, or ["none"] if no active entitlements */
     entitlements: string[];
     /** When the subscription started (earliest purchase date), or null if no subscription */
     subscriptionStartedAt: Date | null;

package/dist/types/subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yFAAyF;IACzF,qBAAqB,EAAE,IAAI,GAAG,IAAI,CAAC;CACpC"}
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yFAAyF;IACzF,qBAAqB,EAAE,IAAI,GAAG,IAAI,CAAC;CACpC"}

package/dist/types/subscription.js

@@ -1,2 +1,5 @@
+/**
+ * @fileoverview Domain types for subscription information returned by SubscriptionHelper.
+ */
 export {};
 //# sourceMappingURL=subscription.js.map

package/dist/types/subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":""}
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/types/subscription.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/subscription_service",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Shared subscription management library using RevenueCat for entitlements",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
   "author": "Sudobility",
   "license": "BUSL-1.1",
   "peerDependencies": {
-    "@sudobility/types": "^1.9.53"
+    "@sudobility/types": "^1.9.54"
   },
   "devDependencies": {
     "vitest": "^4.0.4",