fresh-squeezy 1.0.20 → 1.0.47

package/README.md

@@ -1,114 +1,182 @@
-# Project Refactoring Summary
-
-## Overview
-
-Successfully completed the refactoring of the `src/wizard.ts` file and reorganized the project structure to enable better modularity and maintainability.
-
-## Changes Made
-
-### 1. Created Skills Folder Structure
-
-- **Root Skills Directory**: `/skills/`
-- **Wizard Skill**: `/skills/wizard/` - Interactive setup wizard functionality
-  - `components/` - Reusable UI components (banner, loading animations)
-  - `steps/` - Individual wizard steps (API key, store selection, etc.)
-  - `utils/` - Wizard-specific utilities (validation, file generation)
-  - `types.ts` - Wizard-specific type definitions
-- **CLI Skill**: `/skills/cli/` - Command-line interface functionality
-  - `commands/` - Individual CLI command implementations
-  - `utils/` - CLI utilities and helpers
-- **Validation Skill**: `/skills/validation/` - Testing and validation functionality
-  - `tests/` - Validation test implementations
-  - `utils/` - Validation utilities and helpers
-
-### 2. Reorganized Source Code Structure
-
-- **Core Directory**: `/src/core/` - Core billing functionality
-  - Moved all core billing logic from root src/ directory
-  - Updated all import paths to use new structure
-- **CLI Directory**: `/src/cli/` - CLI-related files
-  - `cli.ts` - Main CLI entry point
-  - `cli-validate.ts` - Validation functionality
-- **Types Directory**: `/src/types/` - Type definitions
-  - `types.ts` - Main types export
-  - Existing type subdirectories preserved
-- **Utils Directory**: `/src/utils/` - Utility files (created but empty for now)
-
-### 3. Split Wizard.ts into Modular Components
-
-The original monolithic `wizard.ts` (~1000 lines) was split into:
-
-- **Main Wizard Class**: `/skills/wizard/main.ts`
-- **Type Definitions**: `/skills/wizard/types.ts`
-- **UI Components**: 
-  - `/skills/wizard/components/banner.ts`
-  - `/skills/wizard/components/loading.ts`
-- **Wizard Steps**:
-  - `/skills/wizard/steps/api-key.ts`
-  - `/skills/wizard/steps/store-selection.ts`
-  - `/skills/wizard/steps/product-selection.ts`
-  - `/skills/wizard/steps/webhook-setup.ts`
-  - `/skills/wizard/steps/configuration.ts`
-  - `/skills/wizard/steps/generate-files.ts`
-- **Utilities**:
-  - `/skills/wizard/utils/file-generation.ts`
-  - `/skills/wizard/utils/validation.ts`
-  - `/skills/wizard/utils/real-cycle.ts`
-
-### 4. Updated Import Paths
-
-- Updated all import statements throughout the project to use the new directory structure
-- Fixed TypeScript compilation issues
-- Ensured all modules can find their dependencies
-
-### 5. Created Comprehensive Documentation
-
-- **Root README**: This summary document
-- **Skills README**: Architecture overview and usage instructions
-- **Wizard README**: Detailed wizard functionality documentation
-- **CLI README**: CLI command documentation
-- **Validation README**: Testing and validation documentation
-
-## Benefits Achieved
-
-1. **Improved Modularity**: Each wizard step is now a separate, testable module
-2. **Better Maintainability**: Clear separation of concerns makes code easier to understand and modify
-3. **Enhanced Reusability**: Components can be reused across different parts of the system
-4. **Cleaner Architecture**: Logical grouping of related functionality
-5. **Easier Testing**: Individual modules can be tested independently
-6. **Better Developer Experience**: Clear documentation and organized structure
-
-## Project Structure
+# fresh-squeezy
 
+> The missing billing layer for Lemon Squeezy — auto-discover, checkout, webhooks, subscriptions, and licenses in one function call.
+
+[![npm](https://img.shields.io/npm/v/fresh-squeezy)](https://www.npmjs.com/package/fresh-squeezy)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## Install
+
+```bash
+npm install fresh-squeezy
+# peer deps
+npm install @lemonsqueezy/lemonsqueezy.js
+```
+
+## Quick Start
+
+```ts
+import { createBilling } from "fresh-squeezy";
+
+const billing = await createBilling({
+  apiKey: process.env.LS_API_KEY!,
+  webhookSecret: process.env.LS_WEBHOOK_SECRET!,
+  callbacks: {
+    onPurchase: async ({ userId, email, orderId, productName, price }) => {
+      await db.grantAccess(userId);
+    },
+    onSubscription: async (event, method) => {
+      if (method === "cancelled") await db.revokeAccess(event.userId);
+    },
+    onSubscriptionPayment: async (event, method) => {
+      if (method === "success") await db.extendAccess(event.userId);
+    },
+  },
+});
+
+// Create a checkout URL
+const url = await billing.createCheckout({
+  variantId: "123456",
+  email: "user@example.com",
+  userId: "user_abc",
+});
+
+// Verify + handle a webhook (Express example)
+app.post("/webhook", express.raw({ type: "application/json" }), async (req, res) => {
+  const sig = req.headers["x-signature"] as string;
+  if (!billing.verifyWebhook(req.body.toString(), sig)) return res.sendStatus(401);
+  await billing.handleWebhook(JSON.parse(req.body.toString()));
+  res.json({ ok: true });
+});
+```
+
+## Setup Wizard
+
+Run the interactive wizard to generate a `billing-config.ts` for your project:
+
+```bash
+pnpm wizard
+# or after installing the package globally:
+npx fresh-squeezy-billing wizard
+```
+
+The wizard:
+- Validates your API key against Lemon Squeezy
+- Lets you select stores, products, and webhook events
+- Generates `billing-config.ts` and `example.ts` in your project root
+- Optionally runs all 6 API lifecycle test phases (setup → customer → order → subscription → license → cleanup)
+
+## Configuration
+
+```ts
+interface BillingConfig {
+  apiKey: string;
+  storeId?: string;
+  webhookSecret?: string;
+  cachePath?: string;        // default: "./billing-cache.json"
+  cacheTtlMs?: number;       // default: 3 600 000 (1 hour)
+  checkoutExpiresInMs?: number | null;
+  logger?: { filePath: string } | { custom: BillingLogger };
+  callbacks: BillingCallbacks;
+  dedup?: DedupConfig;
+}
 ```
-fresh-squeezy/
-├── skills/                    # Modular skills system
-│   ├── wizard/               # Interactive setup wizard
-│   │   ├── components/       # UI components
-│   │   ├── steps/           # Wizard steps
-│   │   ├── utils/           # Wizard utilities
-│   │   ├── types.ts         # Wizard types
-│   │   └── main.ts          # Main wizard class
-│   ├── cli/                 # CLI functionality
-│   │   ├── commands/        # CLI commands
-│   │   └── utils/           # CLI utilities
-│   └── validation/          # Testing and validation
-│       ├── tests/           # Validation tests
-│       └── utils/           # Validation utilities
-├── src/                     # Source code
-│   ├── core/               # Core billing functionality
-│   ├── cli/                # CLI-related files
-│   ├── types/              # Type definitions
-│   └── utils/              # Utility files
-└── README.md               # This documentation
+
+## Callbacks
+
+```ts
+interface BillingCallbacks {
+  onPurchase: (event: PurchaseEvent) => Promise<void>;
+  onRefund?: (event: RefundEvent) => Promise<void>;
+  onSubscription?: (event: AnySubscriptionEvent, method: SubscriptionMethod) => Promise<void>;
+  // method: 'created' | 'updated' | 'cancelled' | 'expired' | 'paused' | 'resumed'
+  onSubscriptionPayment?: (event: SubscriptionPaymentSuccessEvent | SubscriptionPaymentRecoveredEvent, method: 'success' | 'recovered') => Promise<void>;
+  onPaymentFailed?: (event: PaymentFailedEvent) => Promise<void>;
+  onLicenseKey?: (method: 'created' | 'updated', event: LicenseKeyEvent) => Promise<void>;
+  onWebhook?: (eventType: string, event: unknown) => Promise<void>;
+}
+```
+
+## Billing API
+
+```ts
+billing.stores                              // StoreInfo[]
+billing.plans                               // Plan[]  (auto-refreshed from cache)
+billing.createCheckout(params)              // Promise<string>  — checkout URL
+billing.verifyWebhook(rawBody, sig)         // boolean
+billing.handleWebhook(payload)              // Promise<void>
+billing.refreshPlans()                      // Promise<void>
+billing.getCustomerPortal(customerId)       // Promise<string>  — portal URL
+billing.getExpressRouter(options)           // Express Router
+
+// Subscriptions
+billing.pauseSubscription(id, reason?)
+billing.resumeSubscription(id)
+billing.cancelSubscription(id, immediately?)
+billing.changeSubscriptionVariant(id, variantId)
+billing.resumeCancelledSubscription(id)
+
+// Licenses
+billing.validateLicense(key)               // Promise<{ valid: boolean; details? }>
+billing.getLicenseDetails(key)             // Promise<LicenseKeyEvent | null>
+billing.activateLicense(key, instanceName) // Promise<{ activated: boolean; instanceId? }>
+billing.deactivateLicense(key, instanceId) // Promise<boolean>
+
+// Customers
+billing.getCustomerByEmail(email)
+billing.getSubscriptionsForUser(userId)
+
+// Webhooks
+billing.createWebhook(url, events, secret?)
+billing.deleteWebhook(webhookId)
+
+// Other
+billing.healthCheck()
+billing.dedupBackend
 ```
 
-## Testing Status
+## Express Router
+
+```ts
+import express from "express";
+
+const app = express();
+app.use("/billing", billing.getExpressRouter({
+  webhookPath: "/webhook",
+  checkoutPath: "/checkout",
+}));
+```
+
+## Deduplication
+
+By default, webhook deduplication is in-memory and process-local. Swap in Redis or a database backend:
+
+```ts
+import { RedisDedupBackend } from "fresh-squeezy";
+
+const billing = await createBilling({
+  // ...
+  dedup: {
+    backend: new RedisDedupBackend(redisClient),
+    ttlMs: 86_400_000,
+  },
+});
+```
+
+## CLI
+
+```bash
+npx fresh-squeezy-billing wizard     # interactive setup
+npx fresh-squeezy-billing validate   # run validation suite
+npx fresh-squeezy-billing help
+```
+
+## Requirements
+
+- Node.js ≥ 20
+- `@lemonsqueezy/lemonsqueezy.js` ≥ 3.2.0
+- Express ≥ 4.18 (optional, only if using `getExpressRouter`)
 
-- ✅ TypeScript compilation passes
-- ✅ Build process completes successfully
-- ✅ All import paths updated and working
-- ✅ Modular structure implemented
-- ✅ Documentation created
+## License
 
-The refactoring is complete and the project is ready for continued development with the new modular structure.
+MIT

package/dist/src/cli/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { runWizard } from "../wizard.js";
+import { runWizard } from "../wizard/index.js";
 import { runValidate } from "./cli-validate.js";
 function printHelp() {
     console.log(`

package/dist/src/cli/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;CAab,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAa,IAAI,CAAC,CAAC,CAAa,IAAI,MAAM,CAAC;IAExD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,MAAM,SAAS,EAAE,CAAC;YAClB,MAAM;QACR,KAAK,UAAU;YACb,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ;YACE,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;CAab,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAa,IAAI,CAAC,CAAC,CAAa,IAAI,MAAM,CAAC;IAExD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,MAAM,SAAS,EAAE,CAAC;YAClB,MAAM;QACR,KAAK,UAAU;YACb,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ;YACE,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/cli/paths.d.ts

@@ -0,0 +1,4 @@
+export declare const VALIDATE_CACHE_PATH: string;
+export declare const VALIDATE_LOG_PATH: string;
+export declare const VALIDATE_LIVE_CACHE_PATH: string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/cli/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/cli/paths.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,QAAkD,CAAC;AACnF,eAAO,MAAM,iBAAiB,QAA2C,CAAC;AAC1E,eAAO,MAAM,wBAAwB,QAA8C,CAAC"}

package/dist/src/cli/paths.js

@@ -0,0 +1,7 @@
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const PREFIX = "lemonsqueezy-billing";
+export const VALIDATE_CACHE_PATH = join(tmpdir(), `${PREFIX}-validate-cache.json`);
+export const VALIDATE_LOG_PATH = join(tmpdir(), `${PREFIX}-validate.log`);
+export const VALIDATE_LIVE_CACHE_PATH = join(tmpdir(), `${PREFIX}-live-cache.json`);
+//# sourceMappingURL=paths.js.map

package/dist/src/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/cli/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,MAAM,GAAG,sBAAsB,CAAC;AAEtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,sBAAsB,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,eAAe,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,kBAAkB,CAAC,CAAC"}

package/dist/src/core/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/core/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAQtE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAKrF"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/core/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAQtE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAKrF"}

package/dist/src/core/cache.js

@@ -1,6 +1,6 @@
 import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
-const DEFAULT_CACHE_PATH = "./billing-cache.json";
+import { DEFAULT_CACHE_PATH } from "./paths.js";
 const DEFAULT_TTL_MS = 3_600_000;
 export function readCache(cachePath) {
     const path = cachePath ?? DEFAULT_CACHE_PATH;

package/dist/src/core/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/core/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAClD,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,MAAM,UAAU,SAAS,CAAC,SAAkB;IAC1C,MAAM,IAAI,GAAG,SAAS,IAAI,kBAAkB,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAmB,EAAE,SAAkB;IAChE,MAAM,IAAI,GAAG,SAAS,IAAI,kBAAkB,CAAC;IAC7C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA+B,EAAE,KAAc;IAC1E,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,KAAK,IAAI,cAAc,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1D,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,GAAG,CAAC;AACxC,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/core/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,MAAM,UAAU,SAAS,CAAC,SAAkB;IAC1C,MAAM,IAAI,GAAG,SAAS,IAAI,kBAAkB,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAmB,EAAE,SAAkB;IAChE,MAAM,IAAI,GAAG,SAAS,IAAI,kBAAkB,CAAC;IAC7C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA+B,EAAE,KAAc;IAC1E,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,KAAK,IAAI,cAAc,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1D,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,GAAG,CAAC;AACxC,CAAC"}

package/dist/src/core/licenses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"licenses.d.ts","sourceRoot":"","sources":["../../../src/core/licenses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAqD,MAAM,mBAAmB,CAAC;AAqBjH,wBAAgB,0BAA0B,IAAI,oBAAoB,CAiFjE"}
+{"version":3,"file":"licenses.d.ts","sourceRoot":"","sources":["../../../src/core/licenses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EAKrB,MAAM,mBAAmB,CAAC;AAuB3B,wBAAgB,0BAA0B,IAAI,oBAAoB,CAiHjE"}

package/dist/src/core/licenses.js

@@ -1,5 +1,6 @@
 import { getLicenseKey } from "@lemonsqueezy/lemonsqueezy.js";
 import { withRetry } from "./retry.js";
+const LS_LICENSE_API_BASE = "https://api.lemonsqueezy.com/v1/licenses";
 function mapAttributesToLicenseKeyEvent(attrs, licenseKeyId, key) {
     return {
         userId: attrs.user_email,
@@ -26,7 +27,7 @@ export function createLicenseKeyManagement() {
             const attrs = response.data.data.attributes;
             const details = mapAttributesToLicenseKeyEvent(attrs, response.data.data.id, attrs.key);
             const valid = details.status === "active" &&
-                details.activationCount < details.maxActivations;
+                (details.maxActivations === null || details.activationCount <= details.maxActivations);
             return { valid, details };
         }
         catch {
@@ -34,31 +35,64 @@ export function createLicenseKeyManagement() {
         }
     };
     const getLicenseDetails = async (key) => {
-        const response = await withRetry(() => getLicenseKey(key), "getLicenseKey");
-        if (response.error || !response.data?.data) {
+        try {
+            const response = await withRetry(() => getLicenseKey(key), "getLicenseKey");
+            if (response.error || !response.data?.data) {
+                return null;
+            }
+            const attrs = response.data.data.attributes;
+            return mapAttributesToLicenseKeyEvent(attrs, response.data.data.id, attrs.key);
+        }
+        catch {
             return null;
         }
-        const attrs = response.data.data.attributes;
-        return mapAttributesToLicenseKeyEvent(attrs, response.data.data.id, attrs.key);
     };
-    const activateLicense = async (key, _instanceId) => {
-        // Note: Lemon Squeezy doesn't have a direct activation API
-        // This would typically be handled by your application logic
-        // based on the license key details and activation limits
-        const validation = await validateLicense(key);
-        if (!validation.valid || !validation.details) {
-            return false;
+    // Note: License API is a direct HTTP call; retries are intentionally omitted (callers should retry at the application level)
+    const activateLicense = async (key, instanceName) => {
+        const resolvedName = instanceName ?? "default";
+        const body = new URLSearchParams({ license_key: key, instance_name: resolvedName });
+        try {
+            const response = await fetch(`${LS_LICENSE_API_BASE}/activate`, {
+                method: "POST",
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/x-www-form-urlencoded",
+                },
+                body: body.toString(),
+            });
+            if (!response.ok) {
+                return { activated: false };
+            }
+            const data = (await response.json());
+            return { activated: data.activated === true, instanceId: data.instance?.id };
+        }
+        catch {
+            return { activated: false };
         }
-        // Here you would typically:
-        // 1. Check if this instanceId is already activated
-        // 2. Increment activation count in your database
-        // 3. Return success/failure based on your business logic
-        return true; // Placeholder - implement based on your needs
     };
-    const deactivateLicense = async (_key, _instanceId) => {
-        // Similar to activateLicense, this would be handled by your application logic
-        // based on your activation tracking system
-        return true; // Placeholder - implement based on your needs
+    const deactivateLicense = async (key, instanceId) => {
+        if (!instanceId) {
+            return false;
+        }
+        const body = new URLSearchParams({ license_key: key, instance_id: instanceId });
+        try {
+            const response = await fetch(`${LS_LICENSE_API_BASE}/deactivate`, {
+                method: "POST",
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/x-www-form-urlencoded",
+                },
+                body: body.toString(),
+            });
+            if (!response.ok) {
+                return false;
+            }
+            const data = (await response.json());
+            return data.deactivated === true;
+        }
+        catch {
+            return false;
+        }
     };
     return {
         validateLicense,

package/dist/src/core/licenses.js.map

@@ -1 +1 @@
-{"version":3,"file":"licenses.js","sourceRoot":"","sources":["../../../src/core/licenses.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"licenses.js","sourceRoot":"","sources":["../../../src/core/licenses.ts"],"names":[],"mappings":"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"}

package/dist/src/core/paths.d.ts

@@ -0,0 +1,6 @@
+export declare const BILLING_DIR = ".billing";
+export declare const DEFAULT_CACHE_PATH = ".billing/cache.json";
+export declare const DEFAULT_LOG_PATH = ".billing/billing.log";
+export declare const WIZARD_CONFIG_FILE = ".billing/billing-config.ts";
+export declare const WIZARD_EXAMPLE_FILE = ".billing/example.ts";
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/core/paths.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,eAAO,MAAM,kBAAkB,wBAA8B,CAAC;AAC9D,eAAO,MAAM,gBAAgB,yBAA+B,CAAC;AAE7D,eAAO,MAAM,kBAAkB,+BAAqC,CAAC;AACrE,eAAO,MAAM,mBAAmB,wBAA8B,CAAC"}

package/dist/src/core/paths.js

@@ -0,0 +1,6 @@
+export const BILLING_DIR = ".billing";
+export const DEFAULT_CACHE_PATH = `${BILLING_DIR}/cache.json`;
+export const DEFAULT_LOG_PATH = `${BILLING_DIR}/billing.log`;
+export const WIZARD_CONFIG_FILE = `${BILLING_DIR}/billing-config.ts`;
+export const WIZARD_EXAMPLE_FILE = `${BILLING_DIR}/example.ts`;
+//# sourceMappingURL=paths.js.map

package/dist/src/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/paths.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAEtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,WAAW,aAAa,CAAC;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,WAAW,cAAc,CAAC;AAE7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,WAAW,oBAAoB,CAAC;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,WAAW,aAAa,CAAC"}

package/dist/src/core/webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/core/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAaf,MAAM,mBAAmB,CAAC;AAI3B,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,IAC1C,SAAS,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAQrD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,IAyBrE,SAAS,cAAc,KAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAgMjG"}
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/core/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAef,MAAM,mBAAmB,CAAC;AAI3B,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,IAC1C,SAAS,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAQrD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,IAyBrE,SAAS,cAAc,KAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAyKjG"}

package/dist/src/core/webhook.js

@@ -66,37 +66,17 @@ export function createWebhookHandler(callbacks, dedupTtlMs) {
                 await dispatchWebhook(eventName, event);
                 return { dispatched: callbacks.onRefund ? "onRefund" : null, skipped: false };
             }
-            case "subscription_created": {
-                const event = buildSubscriptionEvent(userId, email, dataId, attrs);
-                if (callbacks.onSubscriptionCreated) {
-                    await callbacks.onSubscriptionCreated(event);
-                }
-                await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionCreated ? "onSubscriptionCreated" : null, skipped: false };
-            }
-            case "subscription_updated": {
-                const event = buildSubscriptionEvent(userId, email, dataId, attrs);
-                if (callbacks.onSubscriptionUpdated) {
-                    await callbacks.onSubscriptionUpdated(event);
-                }
-                await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionUpdated ? "onSubscriptionUpdated" : null, skipped: false };
-            }
-            case "subscription_cancelled": {
-                const event = buildSubscriptionEvent(userId, email, dataId, attrs);
-                if (callbacks.onSubscriptionCancelled) {
-                    await callbacks.onSubscriptionCancelled(event);
-                }
-                await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionCancelled ? "onSubscriptionCancelled" : null, skipped: false };
-            }
+            case "subscription_created":
+            case "subscription_updated":
+            case "subscription_cancelled":
             case "subscription_expired": {
+                const method = eventName.replace("subscription_", "");
                 const event = buildSubscriptionEvent(userId, email, dataId, attrs);
-                if (callbacks.onSubscriptionExpired) {
-                    await callbacks.onSubscriptionExpired(event);
+                if (callbacks.onSubscription) {
+                    await callbacks.onSubscription(event, method);
                 }
                 await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionExpired ? "onSubscriptionExpired" : null, skipped: false };
+                return { dispatched: callbacks.onSubscription ? `onSubscription:${method}` : null, skipped: false };
             }
             case "subscription_payment_failed": {
                 const event = {
@@ -120,11 +100,11 @@ export function createWebhookHandler(callbacks, dedupTtlMs) {
                     customerId: String(attrs.customer_id ?? ""),
                     reason: String(attrs.pause_reason ?? ""),
                 };
-                if (callbacks.onSubscriptionPaused) {
-                    await callbacks.onSubscriptionPaused(event);
+                if (callbacks.onSubscription) {
+                    await callbacks.onSubscription(event, "paused");
                 }
                 await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionPaused ? "onSubscriptionPaused" : null, skipped: false };
+                return { dispatched: callbacks.onSubscription ? "onSubscription:paused" : null, skipped: false };
             }
             case "subscription_resumed":
             case "subscription_unpaused": {
@@ -134,11 +114,11 @@ export function createWebhookHandler(callbacks, dedupTtlMs) {
                     subscriptionId: dataId,
                     customerId: String(attrs.customer_id ?? ""),
                 };
-                if (callbacks.onSubscriptionResumed) {
-                    await callbacks.onSubscriptionResumed(event);
+                if (callbacks.onSubscription) {
+                    await callbacks.onSubscription(event, "resumed");
                 }
                 await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionResumed ? "onSubscriptionResumed" : null, skipped: false };
+                return { dispatched: callbacks.onSubscription ? "onSubscription:resumed" : null, skipped: false };
             }
             case "subscription_payment_success": {
                 const event = {
@@ -149,11 +129,11 @@ export function createWebhookHandler(callbacks, dedupTtlMs) {
                     orderId: String(attrs.order_id ?? ""),
                     amount: Number(attrs.total ?? 0),
                 };
-                if (callbacks.onSubscriptionPaymentSuccess) {
-                    await callbacks.onSubscriptionPaymentSuccess(event);
+                if (callbacks.onSubscriptionPayment) {
+                    await callbacks.onSubscriptionPayment(event, "success");
                 }
                 await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionPaymentSuccess ? "onSubscriptionPaymentSuccess" : null, skipped: false };
+                return { dispatched: callbacks.onSubscriptionPayment ? "onSubscriptionPayment:success" : null, skipped: false };
             }
             case "subscription_payment_recovered": {
                 const event = {
@@ -164,11 +144,11 @@ export function createWebhookHandler(callbacks, dedupTtlMs) {
                     orderId: String(attrs.order_id ?? ""),
                     amount: Number(attrs.total ?? 0),
                 };
-                if (callbacks.onSubscriptionPaymentRecovered) {
-                    await callbacks.onSubscriptionPaymentRecovered(event);
+                if (callbacks.onSubscriptionPayment) {
+                    await callbacks.onSubscriptionPayment(event, "recovered");
                 }
                 await dispatchWebhook(eventName, event);
-                return { dispatched: callbacks.onSubscriptionPaymentRecovered ? "onSubscriptionPaymentRecovered" : null, skipped: false };
+                return { dispatched: callbacks.onSubscriptionPayment ? "onSubscriptionPayment:recovered" : null, skipped: false };
             }
             case "license_key_created": {
                 const event = {