@nice2dev/licensing 1.0.10

package/README.md

@@ -0,0 +1,123 @@
+# @nice2dev/licensing
+
+Enterprise Licensing System for Nice2Dev UI components.
+
+## Features
+
+- **License Key Generation** — RSA-signed keys with checksum validation
+- **Hardware Fingerprinting** — Machine binding for license protection
+- **Online/Offline Validation** — Works with or without internet
+- **Seat Management** — Track concurrent users
+- **Floating Licenses** — Shared license pools
+- **Feature Gating** — Tier-based and feature-based access control
+- **React Components** — Ready-to-use UI components
+
+## Installation
+
+```bash
+npm install @nice2dev/licensing
+```
+
+## Quick Start
+
+### Basic Validation
+
+```typescript
+import { validateLicense, isFeatureLicensed } from '@nice2dev/licensing';
+
+// Validate a license key
+const result = await validateLicense('XXXX-XXXX-XXXX-XXXX-XXXX');
+if (result.valid) {
+  console.log('License tier:', result.license.tier);
+  console.log('Days remaining:', result.daysRemaining);
+}
+
+// Check feature access
+const hasAdvanced = await isFeatureLicensed(key, 'advanced-components');
+```
+
+### React Integration
+
+```tsx
+import { LicenseProvider, FeatureGate, LicenseStatus, LicenseActivator } from '@nice2dev/licensing/react';
+
+function App() {
+  return (
+    <LicenseProvider serverUrl="https://your-license-server.com">
+      <LicenseStatus detailed />
+
+      <FeatureGate feature="advanced-components" showUpgradePrompt>
+        <AdvancedDataGrid />
+      </FeatureGate>
+
+      <LicenseActivator onActivated={(license) => console.log('Activated:', license)} />
+    </LicenseProvider>
+  );
+}
+```
+
+### Generate License Keys (Server-side)
+
+```typescript
+import { generateLicenseInfo } from '@nice2dev/licensing';
+
+const license = generateLicenseInfo({
+  tier: 'team',
+  licensee: 'Acme Corp',
+  email: 'admin@acme.com',
+  durationDays: 365,
+  maxSeats: 10,
+  features: ['advanced-components', 'collaboration'],
+});
+
+console.log('License key:', license.key);
+```
+
+## License Tiers
+
+| Tier       | Seats | Machines | Features                         |
+| ---------- | ----- | -------- | -------------------------------- |
+| Trial      | 1     | 1        | Core + watermark                 |
+| Personal   | 1     | 2        | + Advanced, Theming, i18n        |
+| Team       | 10    | 20       | + Collaboration, Analytics       |
+| Enterprise | 50    | 100      | + White-label, SSO, API          |
+| Site       | ∞     | 1000     | + Source code, Dedicated support |
+| OEM        | ∞     | ∞        | + Redistribution rights          |
+
+## Components
+
+### LicenseProvider
+
+Context provider for license state management.
+
+### FeatureGate
+
+Conditionally render content based on license features.
+
+### LicenseStatus
+
+Display current license status badge.
+
+### LicenseActivator
+
+License key input form.
+
+### UpgradePrompt
+
+Upgrade call-to-action component.
+
+### LicenseComparison
+
+Plan comparison table.
+
+### TrialWatermark
+
+Watermark overlay for trial versions.
+
+## API Reference
+
+See full documentation at [docs.nice2dev.com/licensing](https://docs.nice2dev.com/licensing)
+
+## License
+
+MIT © NiceToDev