aios-core 4.2.13 → 4.2.15

package/pro/license/index.js

@@ -1,181 +1,181 @@
-/**
- * License Module - Public API
- *
- * This module provides the public interface for license management
- * and feature gating in AIOS Pro.
- *
- * Usage:
- *   const { featureGate, licenseApi } = require('@aios-fullstack/pro/license');
- *
- *   // Check feature availability
- *   if (featureGate.isAvailable('pro.squads.premium')) {
- *     // Feature is licensed
- *   }
- *
- *   // Require feature (throws if not available)
- *   featureGate.require('pro.squads.premium', 'Premium Squads');
- *
- *   // Activate license
- *   await licenseApi.activate(key, machineId, version);
- *
- * @module pro/license
- * @see ADR-PRO-003 - Feature Gating & Licensing
- * @see Story PRO-6 - License Key & Feature Gating System
- */
-
-'use strict';
-
-// Feature gating
-const { FeatureGate, featureGate } = require('./feature-gate');
-
-// License cache operations
-const {
-  writeLicenseCache,
-  readLicenseCache,
-  deleteLicenseCache,
-  isExpired,
-  isInGracePeriod,
-  getDaysRemaining,
-  getExpiryDate,
-  getLicenseState,
-  setPendingDeactivation,
-  hasPendingDeactivation,
-  markPendingDeactivationSynced,
-  clearPendingDeactivation,
-} = require('./license-cache');
-
-// License API client
-const { LicenseApiClient, licenseApi } = require('./license-api');
-
-// Crypto utilities
-const {
-  generateMachineId,
-  maskKey,
-  validateKeyFormat,
-} = require('./license-crypto');
-
-// Error classes
-const {
-  ProFeatureError,
-  LicenseActivationError,
-  LicenseValidationError,
-} = require('./errors');
-
-// Graceful degradation utilities
-const {
-  withGracefulDegradation,
-  ifProAvailable,
-  getFeatureFriendlyName,
-  logDegradationMessage,
-  createDegradationWrapper,
-  isInDegradedMode,
-  getDegradationStatus,
-} = require('./degradation');
-
-/**
- * Convenience function to check if a feature is available.
- *
- * @param {string} featureId - Feature ID to check
- * @returns {boolean} true if feature is licensed
- */
-function isFeatureAvailable(featureId) {
-  return featureGate.isAvailable(featureId);
-}
-
-/**
- * Convenience function to require a feature.
- *
- * @param {string} featureId - Feature ID to require
- * @param {string} [friendlyName] - Human-friendly name for error message
- * @throws {ProFeatureError} If feature is not licensed
- */
-function requireFeature(featureId, friendlyName) {
-  featureGate.require(featureId, friendlyName);
-}
-
-/**
- * Convenience function to get the current license state.
- *
- * @returns {'Active'|'Expired'|'Grace'|'Not Activated'} License state
- */
-function getCurrentLicenseState() {
-  return featureGate.getLicenseState();
-}
-
-/**
- * Convenience function to get license info.
- *
- * @returns {{ state: string, features: string[], inGrace: boolean } | null}
- */
-function getLicenseInfo() {
-  return featureGate.getLicenseInfo();
-}
-
-/**
- * Convenience function to list available features.
- *
- * @returns {string[]} Array of available feature IDs
- */
-function listAvailableFeatures() {
-  return featureGate.listAvailable();
-}
-
-/**
- * Reload license cache (after activation/deactivation).
- */
-function reloadLicense() {
-  featureGate.reload();
-}
-
-module.exports = {
-  // Primary exports - Feature Gate
-  FeatureGate,
-  featureGate,
-
-  // Primary exports - API Client
-  LicenseApiClient,
-  licenseApi,
-
-  // Error classes
-  ProFeatureError,
-  LicenseActivationError,
-  LicenseValidationError,
-
-  // Cache operations
-  writeLicenseCache,
-  readLicenseCache,
-  deleteLicenseCache,
-  isExpired,
-  isInGracePeriod,
-  getDaysRemaining,
-  getExpiryDate,
-  getLicenseState,
-
-  // Pending deactivation
-  setPendingDeactivation,
-  hasPendingDeactivation,
-  markPendingDeactivationSynced,
-  clearPendingDeactivation,
-
-  // Crypto utilities
-  generateMachineId,
-  maskKey,
-  validateKeyFormat,
-
-  // Convenience functions
-  isFeatureAvailable,
-  requireFeature,
-  getCurrentLicenseState,
-  getLicenseInfo,
-  listAvailableFeatures,
-  reloadLicense,
-
-  // Graceful degradation (AC-8)
-  withGracefulDegradation,
-  ifProAvailable,
-  getFeatureFriendlyName,
-  logDegradationMessage,
-  createDegradationWrapper,
-  isInDegradedMode,
-  getDegradationStatus,
-};
+/**
+ * License Module - Public API
+ *
+ * This module provides the public interface for license management
+ * and feature gating in AIOS Pro.
+ *
+ * Usage:
+ *   const { featureGate, licenseApi } = require('@aios-fullstack/pro/license');
+ *
+ *   // Check feature availability
+ *   if (featureGate.isAvailable('pro.squads.premium')) {
+ *     // Feature is licensed
+ *   }
+ *
+ *   // Require feature (throws if not available)
+ *   featureGate.require('pro.squads.premium', 'Premium Squads');
+ *
+ *   // Activate license
+ *   await licenseApi.activate(key, machineId, version);
+ *
+ * @module pro/license
+ * @see ADR-PRO-003 - Feature Gating & Licensing
+ * @see Story PRO-6 - License Key & Feature Gating System
+ */
+
+'use strict';
+
+// Feature gating
+const { FeatureGate, featureGate } = require('./feature-gate');
+
+// License cache operations
+const {
+  writeLicenseCache,
+  readLicenseCache,
+  deleteLicenseCache,
+  isExpired,
+  isInGracePeriod,
+  getDaysRemaining,
+  getExpiryDate,
+  getLicenseState,
+  setPendingDeactivation,
+  hasPendingDeactivation,
+  markPendingDeactivationSynced,
+  clearPendingDeactivation,
+} = require('./license-cache');
+
+// License API client
+const { LicenseApiClient, licenseApi } = require('./license-api');
+
+// Crypto utilities
+const {
+  generateMachineId,
+  maskKey,
+  validateKeyFormat,
+} = require('./license-crypto');
+
+// Error classes
+const {
+  ProFeatureError,
+  LicenseActivationError,
+  LicenseValidationError,
+} = require('./errors');
+
+// Graceful degradation utilities
+const {
+  withGracefulDegradation,
+  ifProAvailable,
+  getFeatureFriendlyName,
+  logDegradationMessage,
+  createDegradationWrapper,
+  isInDegradedMode,
+  getDegradationStatus,
+} = require('./degradation');
+
+/**
+ * Convenience function to check if a feature is available.
+ *
+ * @param {string} featureId - Feature ID to check
+ * @returns {boolean} true if feature is licensed
+ */
+function isFeatureAvailable(featureId) {
+  return featureGate.isAvailable(featureId);
+}
+
+/**
+ * Convenience function to require a feature.
+ *
+ * @param {string} featureId - Feature ID to require
+ * @param {string} [friendlyName] - Human-friendly name for error message
+ * @throws {ProFeatureError} If feature is not licensed
+ */
+function requireFeature(featureId, friendlyName) {
+  featureGate.require(featureId, friendlyName);
+}
+
+/**
+ * Convenience function to get the current license state.
+ *
+ * @returns {'Active'|'Expired'|'Grace'|'Not Activated'} License state
+ */
+function getCurrentLicenseState() {
+  return featureGate.getLicenseState();
+}
+
+/**
+ * Convenience function to get license info.
+ *
+ * @returns {{ state: string, features: string[], inGrace: boolean } | null}
+ */
+function getLicenseInfo() {
+  return featureGate.getLicenseInfo();
+}
+
+/**
+ * Convenience function to list available features.
+ *
+ * @returns {string[]} Array of available feature IDs
+ */
+function listAvailableFeatures() {
+  return featureGate.listAvailable();
+}
+
+/**
+ * Reload license cache (after activation/deactivation).
+ */
+function reloadLicense() {
+  featureGate.reload();
+}
+
+module.exports = {
+  // Primary exports - Feature Gate
+  FeatureGate,
+  featureGate,
+
+  // Primary exports - API Client
+  LicenseApiClient,
+  licenseApi,
+
+  // Error classes
+  ProFeatureError,
+  LicenseActivationError,
+  LicenseValidationError,
+
+  // Cache operations
+  writeLicenseCache,
+  readLicenseCache,
+  deleteLicenseCache,
+  isExpired,
+  isInGracePeriod,
+  getDaysRemaining,
+  getExpiryDate,
+  getLicenseState,
+
+  // Pending deactivation
+  setPendingDeactivation,
+  hasPendingDeactivation,
+  markPendingDeactivationSynced,
+  clearPendingDeactivation,
+
+  // Crypto utilities
+  generateMachineId,
+  maskKey,
+  validateKeyFormat,
+
+  // Convenience functions
+  isFeatureAvailable,
+  requireFeature,
+  getCurrentLicenseState,
+  getLicenseInfo,
+  listAvailableFeatures,
+  reloadLicense,
+
+  // Graceful degradation (AC-8)
+  withGracefulDegradation,
+  ifProAvailable,
+  getFeatureFriendlyName,
+  logDegradationMessage,
+  createDegradationWrapper,
+  isInDegradedMode,
+  getDegradationStatus,
+};