@skillsmith/cli 0.3.2 → 0.3.3

package/dist/src/templates/mcp-template-handlers.js

@@ -0,0 +1,106 @@
+/**
+ * SMI-1433: MCP Server Template Handlers
+ *
+ * Code generation helpers for MCP server scaffolding.
+ *
+ * @module mcp-template-handlers
+ */
+/**
+ * Escape single quotes in strings for safe template interpolation
+ */
+export function escapeQuotes(str) {
+    return str.replace(/'/g, "\\'");
+}
+/**
+ * Generate tool definition code for a single tool
+ */
+export function generateToolDefinition(tool, indent = '  ') {
+    const properties = [];
+    const required = [];
+    for (const param of tool.parameters || []) {
+        properties.push(`${indent}      ${param.name}: {
+${indent}        type: '${param.type}',
+${indent}        description: '${escapeQuotes(param.description)}',
+${indent}      },`);
+        if (param.required) {
+            required.push(`'${param.name}'`);
+        }
+    }
+    const propertiesStr = properties.length > 0 ? properties.join('\n') : '';
+    const requiredStr = required.length > 0 ? `\n${indent}    required: [${required.join(', ')}],` : '';
+    return `${indent}{
+${indent}  name: '${escapeQuotes(tool.name)}',
+${indent}  description: '${escapeQuotes(tool.description)}',
+${indent}  inputSchema: {
+${indent}    type: 'object',
+${indent}    properties: {
+${propertiesStr}
+${indent}    },${requiredStr}
+${indent}  },
+${indent}},`;
+}
+/**
+ * Generate tool handler case for switch statement
+ */
+export function generateToolCase(tool) {
+    const handlerName = `handle${tool.name.charAt(0).toUpperCase()}${tool.name.slice(1).replace(/-/g, '')}Tool`;
+    const argsType = `${tool.name.charAt(0).toUpperCase()}${tool.name.slice(1).replace(/-/g, '')}ToolArgs`;
+    return `    case '${tool.name}':
+      return ${handlerName}(args as unknown as ${argsType})`;
+}
+/**
+ * Generate tool import statement
+ */
+export function generateToolImport(tool) {
+    const baseName = tool.name.charAt(0).toUpperCase() + tool.name.slice(1).replace(/-/g, '');
+    return `import { handle${baseName}Tool, type ${baseName}ToolArgs } from './${tool.name}.js'`;
+}
+/**
+ * Generate a stub implementation file for a custom tool
+ */
+export function generateToolImplementation(tool) {
+    const baseName = tool.name.charAt(0).toUpperCase() + tool.name.slice(1).replace(/-/g, '');
+    const params = tool.parameters || [];
+    // Generate TypeScript interface properties
+    const interfaceProps = params
+        .map((p) => {
+        const tsType = p.type === 'array' ? 'unknown[]' : p.type === 'object' ? 'Record<string, unknown>' : p.type;
+        return `  ${p.name}${p.required ? '' : '?'}: ${tsType}`;
+    })
+        .join('\n');
+    // Generate implementation placeholder
+    const returnPlaceholder = params.length > 0
+        ? `\`${tool.name} called with: \${JSON.stringify({ ${params.map((p) => `${p.name}: args.${p.name}`).join(', ')} })}\``
+        : `'${tool.name} called'`;
+    return `/**
+ * ${baseName} Tool Implementation
+ *
+ * ${escapeQuotes(tool.description)}
+ * TODO: Implement your tool logic here.
+ */
+
+export interface ${baseName}ToolArgs {
+${interfaceProps || '  // No parameters'}
+}
+
+export async function handle${baseName}Tool(args: ${baseName}ToolArgs): Promise<string> {
+  // TODO: Implement ${tool.name} logic
+  return ${returnPlaceholder}
+}
+`;
+}
+/**
+ * Generate tool documentation for README
+ */
+export function generateToolDocs(tools) {
+    if (tools.length === 0) {
+        return '- `example` - An example tool that echoes input';
+    }
+    return tools
+        .map((tool) => {
+        const params = tool.parameters?.map((p) => `\`${p.name}\``).join(', ') || 'none';
+        return `- \`${tool.name}\` - ${tool.description}\n  - Parameters: ${params}`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=mcp-template-handlers.js.map

package/dist/src/templates/mcp-template-handlers.js.map

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

package/dist/src/templates/mcp-template-types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * SMI-1433: MCP Server Template Types
+ *
+ * Type definitions for MCP server scaffolding.
+ *
+ * @module mcp-template-types
+ */
+/**
+ * Input data for rendering MCP server templates
+ */
+export interface McpServerTemplateData {
+    name: string;
+    description: string;
+    tools: McpToolDefinition[];
+    author: string;
+}
+/**
+ * Tool definition for MCP server
+ */
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    parameters?: McpParameterDefinition[];
+}
+/**
+ * Parameter definition for MCP tool
+ */
+export interface McpParameterDefinition {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+    required?: boolean;
+}
+/**
+ * Dependency version constants for easier maintenance
+ */
+export declare const VERSIONS: {
+    readonly MCP_SDK: "^1.0.0";
+    readonly TYPES_NODE: "^20.0.0";
+    readonly TSX: "^4.0.0";
+    readonly TYPESCRIPT: "^5.0.0";
+    readonly NODE_ENGINE: ">=18.0.0";
+};
+/**
+ * Type for version keys
+ */
+export type VersionKey = keyof typeof VERSIONS;
+//# sourceMappingURL=mcp-template-types.d.ts.map

package/dist/src/templates/mcp-template-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-template-types.d.ts","sourceRoot":"","sources":["../../../src/templates/mcp-template-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,sBAAsB,EAAE,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC1D,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,QAAQ,CAAA"}

package/dist/src/templates/mcp-template-types.js

@@ -0,0 +1,18 @@
+/**
+ * SMI-1433: MCP Server Template Types
+ *
+ * Type definitions for MCP server scaffolding.
+ *
+ * @module mcp-template-types
+ */
+/**
+ * Dependency version constants for easier maintenance
+ */
+export const VERSIONS = {
+    MCP_SDK: '^1.0.0',
+    TYPES_NODE: '^20.0.0',
+    TSX: '^4.0.0',
+    TYPESCRIPT: '^5.0.0',
+    NODE_ENGINE: '>=18.0.0',
+};
+//# sourceMappingURL=mcp-template-types.js.map

package/dist/src/templates/mcp-template-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-template-types.js","sourceRoot":"","sources":["../../../src/templates/mcp-template-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,QAAQ;IACjB,UAAU,EAAE,SAAS;IACrB,GAAG,EAAE,QAAQ;IACb,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,UAAU;CACf,CAAA"}

package/dist/src/utils/license-types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * License Types for Skillsmith CLI
+ *
+ * Type definitions for license validation and display.
+ *
+ * @module @skillsmith/cli/utils/license-types
+ */
+/**
+ * Available license tiers
+ * - community: Free tier (1,000 API calls/month)
+ * - individual: Solo developers ($9.99/mo, 10,000 API calls/month)
+ * - team: Teams ($25/user/mo, 100,000 API calls/month)
+ * - enterprise: Full enterprise ($55/user/mo, unlimited)
+ */
+export type LicenseTier = 'community' | 'individual' | 'team' | 'enterprise';
+/**
+ * Quota information for display
+ */
+export interface QuotaInfo {
+    /** API calls used this period */
+    used: number;
+    /** API call limit (-1 for unlimited) */
+    limit: number;
+    /** Percentage used */
+    percentUsed: number;
+    /** When the quota resets */
+    resetAt: Date;
+}
+/**
+ * License status information returned by license check
+ */
+export interface LicenseStatus {
+    /** Whether the license is valid */
+    valid: boolean;
+    /** License tier level */
+    tier: LicenseTier;
+    /** Expiration date for paid tiers */
+    expiresAt?: Date;
+    /** List of enabled features for this tier */
+    features: string[];
+    /** Error message if license validation failed */
+    error?: string;
+    /** Optional quota information */
+    quota?: QuotaInfo;
+}
+/**
+ * License key payload structure (decoded from license key)
+ * @deprecated Used only for fallback when enterprise package unavailable
+ */
+export interface LicensePayload {
+    tier: LicenseTier;
+    expiresAt: string;
+    features: string[];
+}
+/**
+ * Interface for enterprise LicenseValidator
+ * @see packages/enterprise/src/license/LicenseValidator.ts
+ */
+export interface EnterpriseLicenseValidator {
+    validate(key: string): Promise<{
+        valid: boolean;
+        license?: {
+            tier: LicenseTier;
+            features: string[];
+            expiresAt: Date;
+        };
+        error?: {
+            code: string;
+            message: string;
+        };
+    }>;
+}
+/**
+ * Default features by tier
+ *
+ * Note: Community tier uses CLI-specific display names for UI purposes.
+ * Individual, Team and Enterprise tiers use canonical feature names from @skillsmith/enterprise.
+ *
+ * @see packages/enterprise/src/license/types.ts for canonical feature definitions
+ */
+export declare const TIER_FEATURES: Record<LicenseTier, string[]>;
+/**
+ * API call limits per tier (per month)
+ * Note: These are reference values matching the enterprise package quotas.
+ * Actual quota enforcement happens in the MCP server via QuotaEnforcementService.
+ */
+export declare const TIER_QUOTAS: Record<LicenseTier, number>;
+//# sourceMappingURL=license-types.d.ts.map

package/dist/src/utils/license-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-types.d.ts","sourceRoot":"","sources":["../../../src/utils/license-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,YAAY,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,4BAA4B;IAC5B,OAAO,EAAE,IAAI,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAA;IACd,yBAAyB;IACzB,IAAI,EAAE,WAAW,CAAA;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAA;QACd,OAAO,CAAC,EAAE;YACR,IAAI,EAAE,WAAW,CAAA;YACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;YAClB,SAAS,EAAE,IAAI,CAAA;SAChB,CAAA;QACD,KAAK,CAAC,EAAE;YACN,IAAI,EAAE,MAAM,CAAA;YACZ,OAAO,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,CAAC,CAAA;CACH;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAgCvD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAKnD,CAAA"}

package/dist/src/utils/license-types.js

@@ -0,0 +1,60 @@
+/**
+ * License Types for Skillsmith CLI
+ *
+ * Type definitions for license validation and display.
+ *
+ * @module @skillsmith/cli/utils/license-types
+ */
+/**
+ * Default features by tier
+ *
+ * Note: Community tier uses CLI-specific display names for UI purposes.
+ * Individual, Team and Enterprise tiers use canonical feature names from @skillsmith/enterprise.
+ *
+ * @see packages/enterprise/src/license/types.ts for canonical feature definitions
+ */
+export const TIER_FEATURES = {
+    community: ['basic_search', 'skill_install', 'local_validation'],
+    individual: ['basic_analytics', 'email_support'],
+    team: [
+        // Individual features (inherited)
+        'basic_analytics',
+        'email_support',
+        // Team features
+        'team_workspaces',
+        'private_skills',
+        'usage_analytics',
+        'priority_support',
+    ],
+    enterprise: [
+        // Individual features (inherited)
+        'basic_analytics',
+        'email_support',
+        // Team features (inherited)
+        'team_workspaces',
+        'private_skills',
+        'usage_analytics',
+        'priority_support',
+        // Enterprise-only features (canonical names from enterprise package)
+        'sso_saml',
+        'rbac',
+        'audit_logging',
+        'siem_export',
+        'compliance_reports',
+        'private_registry',
+        'custom_integrations',
+        'advanced_analytics',
+    ],
+};
+/**
+ * API call limits per tier (per month)
+ * Note: These are reference values matching the enterprise package quotas.
+ * Actual quota enforcement happens in the MCP server via QuotaEnforcementService.
+ */
+export const TIER_QUOTAS = {
+    community: 1_000,
+    individual: 10_000,
+    team: 100_000,
+    enterprise: -1, // Unlimited
+};
+//# sourceMappingURL=license-types.js.map

package/dist/src/utils/license-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-types.js","sourceRoot":"","sources":["../../../src/utils/license-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,SAAS,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,kBAAkB,CAAC;IAChE,UAAU,EAAE,CAAC,iBAAiB,EAAE,eAAe,CAAC;IAChD,IAAI,EAAE;QACJ,kCAAkC;QAClC,iBAAiB;QACjB,eAAe;QACf,gBAAgB;QAChB,iBAAiB;QACjB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;KACnB;IACD,UAAU,EAAE;QACV,kCAAkC;QAClC,iBAAiB;QACjB,eAAe;QACf,4BAA4B;QAC5B,iBAAiB;QACjB,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,qEAAqE;QACrE,UAAU;QACV,MAAM;QACN,eAAe;QACf,aAAa;QACb,oBAAoB;QACpB,kBAAkB;QAClB,qBAAqB;QACrB,oBAAoB;KACrB;CACF,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgC;IACtD,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,MAAM;IAClB,IAAI,EAAE,OAAO;IACb,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY;CAC7B,CAAA"}

package/dist/src/utils/license-validation.d.ts

@@ -0,0 +1,61 @@
+/**
+ * License Validation Helpers for Skillsmith CLI
+ *
+ * Handles license key decoding, validation, and enterprise package loading.
+ *
+ * @module @skillsmith/cli/utils/license-validation
+ */
+import type { LicensePayload, LicenseStatus, EnterpriseLicenseValidator } from './license-types.js';
+/**
+ * Attempt to load the enterprise license validator
+ * Returns null if the package is not installed (expected for community users)
+ *
+ * @returns Enterprise validator or null if not available
+ */
+export declare function tryLoadEnterpriseValidator(): Promise<EnterpriseLicenseValidator | null>;
+/**
+ * Reset the enterprise validator cache (for testing purposes)
+ * @internal
+ */
+export declare function _resetEnterpriseValidatorCache(): void;
+/**
+ * Decode and validate a license key using simple base64 JSON decoding
+ *
+ * @deprecated This function is used only when @skillsmith/enterprise is not available.
+ * For paid tiers, enterprise package with proper RS256 JWT validation should be used.
+ * Community users without a license key don't need validation.
+ *
+ * @param licenseKey - The license key to decode
+ * @returns Decoded payload or null if invalid
+ */
+export declare function decodeLicenseKey(licenseKey: string): LicensePayload | null;
+/**
+ * Check if a license has expired
+ *
+ * @param expiresAt - Expiration date
+ * @returns True if expired
+ */
+export declare function isExpired(expiresAt: Date): boolean;
+/**
+ * Get the current license status using legacy base64 decoding
+ *
+ * @deprecated Use getLicenseStatus() which properly uses enterprise JWT validation.
+ * This function is preserved only for backwards compatibility in tests.
+ *
+ * @returns Promise resolving to license status
+ */
+export declare function getLicenseStatusLegacy(): Promise<LicenseStatus>;
+/**
+ * Get the current license status
+ *
+ * Reads the license key from SKILLSMITH_LICENSE_KEY environment variable.
+ * If no key is set, returns community tier (not an error).
+ * If key is invalid or expired, returns status with error but continues.
+ *
+ * When @skillsmith/enterprise is available, uses proper RS256 JWT validation.
+ * Otherwise, falls back to simple base64 JSON decoding (for development/testing only).
+ *
+ * @returns Promise resolving to license status
+ */
+export declare function getLicenseStatus(): Promise<LicenseStatus>;
+//# sourceMappingURL=license-validation.d.ts.map

package/dist/src/utils/license-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/license-validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAMnG;;;;;GAKG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CA4B7F;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAoB1E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAElD;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,aAAa,CAAC,CA4CrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CA0D/D"}

package/dist/src/utils/license-validation.js

@@ -0,0 +1,198 @@
+/**
+ * License Validation Helpers for Skillsmith CLI
+ *
+ * Handles license key decoding, validation, and enterprise package loading.
+ *
+ * @module @skillsmith/cli/utils/license-validation
+ */
+import { TIER_FEATURES } from './license-types.js';
+// Cache for the enterprise validator to avoid repeated dynamic imports
+let enterpriseValidatorCache = undefined;
+/**
+ * Attempt to load the enterprise license validator
+ * Returns null if the package is not installed (expected for community users)
+ *
+ * @returns Enterprise validator or null if not available
+ */
+export async function tryLoadEnterpriseValidator() {
+    // Return cached result if already loaded
+    if (enterpriseValidatorCache !== undefined) {
+        return enterpriseValidatorCache;
+    }
+    try {
+        // Dynamic import with variable to prevent TypeScript from resolving at compile time
+        // This is an optional peer dependency that may not be installed
+        const packageName = '@skillsmith/enterprise';
+        const enterprise = (await import(/* webpackIgnore: true */ packageName));
+        if (enterprise['LicenseValidator']) {
+            const ValidatorClass = enterprise['LicenseValidator'];
+            enterpriseValidatorCache = new ValidatorClass();
+            return enterpriseValidatorCache;
+        }
+        enterpriseValidatorCache = null;
+        return null;
+    }
+    catch {
+        // Enterprise package not installed - this is expected for community users
+        enterpriseValidatorCache = null;
+        return null;
+    }
+}
+/**
+ * Reset the enterprise validator cache (for testing purposes)
+ * @internal
+ */
+export function _resetEnterpriseValidatorCache() {
+    enterpriseValidatorCache = undefined;
+}
+/**
+ * Decode and validate a license key using simple base64 JSON decoding
+ *
+ * @deprecated This function is used only when @skillsmith/enterprise is not available.
+ * For paid tiers, enterprise package with proper RS256 JWT validation should be used.
+ * Community users without a license key don't need validation.
+ *
+ * @param licenseKey - The license key to decode
+ * @returns Decoded payload or null if invalid
+ */
+export function decodeLicenseKey(licenseKey) {
+    try {
+        // License key format: base64 encoded JSON
+        // In production, this would include cryptographic signature verification
+        const decoded = Buffer.from(licenseKey, 'base64').toString('utf-8');
+        const payload = JSON.parse(decoded);
+        // Validate required fields
+        if (!payload.tier || !['team', 'enterprise'].includes(payload.tier)) {
+            return null;
+        }
+        if (!payload.expiresAt || isNaN(Date.parse(payload.expiresAt))) {
+            return null;
+        }
+        return payload;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a license has expired
+ *
+ * @param expiresAt - Expiration date
+ * @returns True if expired
+ */
+export function isExpired(expiresAt) {
+    return expiresAt < new Date();
+}
+/**
+ * Get the current license status using legacy base64 decoding
+ *
+ * @deprecated Use getLicenseStatus() which properly uses enterprise JWT validation.
+ * This function is preserved only for backwards compatibility in tests.
+ *
+ * @returns Promise resolving to license status
+ */
+export async function getLicenseStatusLegacy() {
+    const licenseKey = process.env['SKILLSMITH_LICENSE_KEY'];
+    // No license key = community tier (free, not an error)
+    if (!licenseKey) {
+        return {
+            valid: true,
+            tier: 'community',
+            features: TIER_FEATURES.community,
+        };
+    }
+    // Decode the license key
+    const payload = decodeLicenseKey(licenseKey);
+    if (!payload) {
+        return {
+            valid: false,
+            tier: 'community',
+            features: TIER_FEATURES.community,
+            error: 'Invalid license key format',
+        };
+    }
+    const expiresAt = new Date(payload.expiresAt);
+    // Check expiration
+    if (isExpired(expiresAt)) {
+        return {
+            valid: false,
+            tier: 'community',
+            expiresAt,
+            features: TIER_FEATURES.community,
+            error: `License expired on ${expiresAt.toISOString().split('T')[0]}`,
+        };
+    }
+    // Valid paid license
+    return {
+        valid: true,
+        tier: payload.tier,
+        expiresAt,
+        features: payload.features || TIER_FEATURES[payload.tier],
+    };
+}
+/**
+ * Get the current license status
+ *
+ * Reads the license key from SKILLSMITH_LICENSE_KEY environment variable.
+ * If no key is set, returns community tier (not an error).
+ * If key is invalid or expired, returns status with error but continues.
+ *
+ * When @skillsmith/enterprise is available, uses proper RS256 JWT validation.
+ * Otherwise, falls back to simple base64 JSON decoding (for development/testing only).
+ *
+ * @returns Promise resolving to license status
+ */
+export async function getLicenseStatus() {
+    const licenseKey = process.env['SKILLSMITH_LICENSE_KEY'];
+    // No license key = community tier (free, not an error)
+    if (!licenseKey) {
+        return {
+            valid: true,
+            tier: 'community',
+            features: TIER_FEATURES.community,
+        };
+    }
+    // Try to use enterprise validator for proper JWT verification
+    const validator = await tryLoadEnterpriseValidator();
+    if (validator) {
+        // Enterprise package available - use proper RS256 JWT validation
+        try {
+            const result = await validator.validate(licenseKey);
+            if (result.valid && result.license) {
+                return {
+                    valid: true,
+                    tier: result.license.tier,
+                    expiresAt: result.license.expiresAt,
+                    features: result.license.features.length > 0
+                        ? result.license.features
+                        : TIER_FEATURES[result.license.tier],
+                };
+            }
+            // Invalid license - return error with community fallback
+            return {
+                valid: false,
+                tier: 'community',
+                features: TIER_FEATURES.community,
+                error: result.error?.message || 'Invalid license key',
+            };
+        }
+        catch {
+            // Validation threw an error - treat as invalid
+            return {
+                valid: false,
+                tier: 'community',
+                features: TIER_FEATURES.community,
+                error: 'License validation failed',
+            };
+        }
+    }
+    // Enterprise package not available - fall back to community tier
+    // Note: We don't attempt base64 decoding for paid tiers without proper validation
+    // This ensures security by requiring the enterprise package for paid features
+    return {
+        valid: true,
+        tier: 'community',
+        features: TIER_FEATURES.community,
+    };
+}
+//# sourceMappingURL=license-validation.js.map

package/dist/src/utils/license-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-validation.js","sourceRoot":"","sources":["../../../src/utils/license-validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,uEAAuE;AACvE,IAAI,wBAAwB,GAAkD,SAAS,CAAA;AAEvF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC9C,yCAAyC;IACzC,IAAI,wBAAwB,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,wBAAwB,CAAA;IACjC,CAAC;IAED,IAAI,CAAC;QACH,oFAAoF;QACpF,gEAAgE;QAChE,MAAM,WAAW,GAAG,wBAAwB,CAAA;QAC5C,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAGtE,CAAA;QAED,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAyC,CAAA;YAC7F,wBAAwB,GAAG,IAAI,cAAc,EAAE,CAAA;YAC/C,OAAO,wBAAwB,CAAA;QACjC,CAAC;QAED,wBAAwB,GAAG,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,wBAAwB,GAAG,IAAI,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B;IAC5C,wBAAwB,GAAG,SAAS,CAAA;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,CAAC;QACH,0CAA0C;QAC1C,yEAAyE;QACzE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAA;QAErD,2BAA2B;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAC/D,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAe;IACvC,OAAO,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;IAExD,uDAAuD;IACvD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,aAAa,CAAC,SAAS;SAClC,CAAA;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;IAE5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,aAAa,CAAC,SAAS;YACjC,KAAK,EAAE,4BAA4B;SACpC,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAE7C,mBAAmB;IACnB,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,WAAW;YACjB,SAAS;YACT,QAAQ,EAAE,aAAa,CAAC,SAAS;YACjC,KAAK,EAAE,sBAAsB,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;SACrE,CAAA;IACH,CAAC;IAED,qBAAqB;IACrB,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS;QACT,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;KAC1D,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;IAExD,uDAAuD;IACvD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,aAAa,CAAC,SAAS;SAClC,CAAA;IACH,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,GAAG,MAAM,0BAA0B,EAAE,CAAA;IAEpD,IAAI,SAAS,EAAE,CAAC;QACd,iEAAiE;QACjE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;YAEnD,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnC,OAAO;oBACL,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;oBACzB,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;oBACnC,QAAQ,EACN,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;wBAChC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ;wBACzB,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;iBACzC,CAAA;YACH,CAAC;YAED,yDAAyD;YACzD,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,aAAa,CAAC,SAAS;gBACjC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,qBAAqB;aACtD,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;YAC/C,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,aAAa,CAAC,SAAS;gBACjC,KAAK,EAAE,2BAA2B;aACnC,CAAA;QACH,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,kFAAkF;IAClF,8EAA8E;IAC9E,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,aAAa,CAAC,SAAS;KAClC,CAAA;AACH,CAAC"}