@skillsmith/cli 0.7.2 → 0.7.3

package/dist/src/utils/errors.js

@@ -1,58 +0,0 @@
-/**
- * SMI-4314: Typed CLI error classes.
- *
- * Library-style command implementations (e.g. `initSkill`) must not call
- * `process.exit` directly. Instead, they throw a typed error carrying the
- * user-facing message and intended exit code. The command-action wrapper
- * catches the typed error, prints the message exactly once, and exits with
- * the requested code. Any other thrown `Error` is treated as an unexpected
- * bug and routed through `sanitizeError` with exit code 1.
- *
- * Keeping the process.exit layer inside the wrapper — rather than inside the
- * library function — prevents the "double-error-print" hazard that
- * `init.helpers.ts` previously had to work around, and lets tests assert on
- * `rejects.toBeInstanceOf(InitSkillError)` instead of monkey-patching
- * `process.exit`.
- */
-/**
- * Error thrown by `initSkill` (and related author-init helpers) when an
- * expected user-facing failure occurs — e.g. invalid skill name, invalid
- * category, or filesystem setup failure.
- *
- * The `message` is intended to be user-facing: it is printed to stderr by
- * the command-action wrapper and already carries any ANSI styling from the
- * call site (e.g. `chalk.red(...)`). Callers should therefore not re-wrap
- * the message with another `chalk.red`/"Error:" prefix.
- *
- * @example
- *   throw new InitSkillError(chalk.red(`Invalid skill name: ${name}`))
- *
- * @example
- *   try {
- *     await initSkill(name, targetPath, opts)
- *   } catch (err) {
- *     if (err instanceof InitSkillError) {
- *       console.error(err.message)
- *       process.exit(err.exitCode)
- *     }
- *     // fall through to generic handling
- *   }
- */
-export class InitSkillError extends Error {
-    /**
-     * Process exit code to use when this error reaches the command wrapper.
-     * Defaults to 1 (generic failure). Use other codes only when the caller
-     * needs to distinguish failure modes in scripted contexts.
-     */
-    exitCode;
-    constructor(message, exitCode = 1, options) {
-        super(message, options);
-        this.name = 'InitSkillError';
-        this.exitCode = exitCode;
-        // Preserve `instanceof` across the transpiled class boundary. Without
-        // this, `err instanceof InitSkillError` can be false in some CJS/ESM
-        // interop scenarios.
-        Object.setPrototypeOf(this, InitSkillError.prototype);
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;;;;OAIG;IACa,QAAQ,CAAQ;IAEhC,YAAY,OAAe,EAAE,WAAmB,CAAC,EAAE,OAA6B;QAC9E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAExB,sEAAsE;QACtE,qEAAqE;QACrE,qBAAqB;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IACvD,CAAC;CACF"}

package/dist/src/utils/formatters.d.ts

@@ -1,39 +0,0 @@
-/**
- * Formatting Utilities
- *
- * Common formatting functions for CLI output including durations,
- * dates, and time intervals.
- */
-/**
- * Format a duration in milliseconds to a human-readable string.
- *
- * @param ms - Duration in milliseconds
- * @returns Formatted string (e.g., "500ms", "2.5s", "1.5m")
- * @example
- * formatDuration(500)    // "500ms"
- * formatDuration(2500)   // "2.5s"
- * formatDuration(90000)  // "1.5m"
- */
-export declare function formatDuration(ms: number): string;
-/**
- * Format an ISO date string for display.
- *
- * @param isoString - ISO 8601 date string or null
- * @returns Formatted locale string or "Never" if null
- * @example
- * formatDate("2024-01-15T10:30:00Z")  // "1/15/2024, 10:30:00 AM"
- * formatDate(null)                     // "Never" (dimmed)
- */
-export declare function formatDate(isoString: string | null): string;
-/**
- * Format the time remaining until a target date.
- *
- * @param isoString - ISO 8601 target date string or null
- * @returns Human-readable time remaining (e.g., "2h 30m", "1d 5h")
- * @example
- * formatTimeUntil("2024-01-15T12:00:00Z")  // "2h 30m" (if ~2.5h away)
- * formatTimeUntil(null)                     // "N/A" (dimmed)
- * formatTimeUntil(pastDate)                 // "Due now" (yellow)
- */
-export declare function formatTimeUntil(isoString: string | null): string;
-//# sourceMappingURL=formatters.d.ts.map

package/dist/src/utils/formatters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAmBhE"}

package/dist/src/utils/formatters.js

@@ -1,69 +0,0 @@
-/**
- * Formatting Utilities
- *
- * Common formatting functions for CLI output including durations,
- * dates, and time intervals.
- */
-import chalk from 'chalk';
-/**
- * Format a duration in milliseconds to a human-readable string.
- *
- * @param ms - Duration in milliseconds
- * @returns Formatted string (e.g., "500ms", "2.5s", "1.5m")
- * @example
- * formatDuration(500)    // "500ms"
- * formatDuration(2500)   // "2.5s"
- * formatDuration(90000)  // "1.5m"
- */
-export function formatDuration(ms) {
-    if (ms < 1000)
-        return `${ms}ms`;
-    if (ms < 60000)
-        return `${(ms / 1000).toFixed(1)}s`;
-    return `${(ms / 60000).toFixed(1)}m`;
-}
-/**
- * Format an ISO date string for display.
- *
- * @param isoString - ISO 8601 date string or null
- * @returns Formatted locale string or "Never" if null
- * @example
- * formatDate("2024-01-15T10:30:00Z")  // "1/15/2024, 10:30:00 AM"
- * formatDate(null)                     // "Never" (dimmed)
- */
-export function formatDate(isoString) {
-    if (!isoString)
-        return chalk.dim('Never');
-    const date = new Date(isoString);
-    return date.toLocaleString();
-}
-/**
- * Format the time remaining until a target date.
- *
- * @param isoString - ISO 8601 target date string or null
- * @returns Human-readable time remaining (e.g., "2h 30m", "1d 5h")
- * @example
- * formatTimeUntil("2024-01-15T12:00:00Z")  // "2h 30m" (if ~2.5h away)
- * formatTimeUntil(null)                     // "N/A" (dimmed)
- * formatTimeUntil(pastDate)                 // "Due now" (yellow)
- */
-export function formatTimeUntil(isoString) {
-    if (!isoString)
-        return chalk.dim('N/A');
-    const target = new Date(isoString);
-    const now = new Date();
-    const diffMs = target.getTime() - now.getTime();
-    if (diffMs <= 0)
-        return chalk.yellow('Due now');
-    const hours = Math.floor(diffMs / 3600000);
-    const minutes = Math.floor((diffMs % 3600000) / 60000);
-    if (hours > 24) {
-        const days = Math.floor(hours / 24);
-        return `${days}d ${hours % 24}h`;
-    }
-    if (hours > 0) {
-        return `${hours}h ${minutes}m`;
-    }
-    return `${minutes}m`;
-}
-//# sourceMappingURL=formatters.js.map

package/dist/src/utils/formatters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAA;IAC/B,IAAI,EAAE,GAAG,KAAK;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IACnD,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACtC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,SAAwB;IACjD,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACzC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAA;IAChC,OAAO,IAAI,CAAC,cAAc,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,SAAwB;IACtD,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAA;IAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAA;IAE/C,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,KAAK,CAAC,CAAA;IAEtD,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAA;QACnC,OAAO,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,GAAG,CAAA;IAClC,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,CAAA;IAChC,CAAC;IACD,OAAO,GAAG,OAAO,GAAG,CAAA;AACtB,CAAC"}

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

@@ -1,88 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,60 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,61 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,198 +0,0 @@
-/**
- * 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 || !['individual', '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

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

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

@@ -1,56 +0,0 @@
-/**
- * License status utilities for Skillsmith CLI
- *
- * Handles license validation, status display, and tier formatting.
- * Supports community (free), team, and enterprise license tiers.
- *
- * When @skillsmith/enterprise is available, uses proper RS256 JWT validation.
- * Otherwise, falls back to community tier (no error).
- *
- * Environment variable: SKILLSMITH_LICENSE_KEY
- *
- * @see SMI-1090: CLI should use enterprise LicenseValidator when available
- */
-export type { LicenseTier, QuotaInfo, LicenseStatus, LicensePayload } from './license-types.js';
-export { TIER_FEATURES, TIER_QUOTAS } from './license-types.js';
-export { tryLoadEnterpriseValidator, _resetEnterpriseValidatorCache, decodeLicenseKey, isExpired, getLicenseStatus, getLicenseStatusLegacy, } from './license-validation.js';
-import type { LicenseTier, QuotaInfo, LicenseStatus } from './license-types.js';
-/**
- * Format a tier badge with color
- *
- * @param tier - License tier
- * @returns Formatted tier badge string
- */
-export declare function formatTierBadge(tier: LicenseTier): string;
-/**
- * Display a progress bar for quota usage
- *
- * @param used - API calls used
- * @param limit - API call limit
- * @returns Formatted progress bar string
- */
-export declare function displayQuotaProgressBar(used: number, limit: number): string;
-/**
- * Display a quota warning box
- *
- * @param quota - Quota information
- * @param tier - Current tier for upgrade suggestions
- */
-export declare function displayQuotaWarning(quota: QuotaInfo, tier: LicenseTier): void;
-/**
- * Display license status on CLI startup
- *
- * Shows license tier, expiration (if applicable), features for paid tiers,
- * and quota usage information.
- * Uses colored output: green for valid, yellow for community, red for expired/invalid.
- *
- * @param status - License status to display
- */
-export declare function displayLicenseStatus(status: LicenseStatus): void;
-/**
- * Display the full CLI header with version and license info
- *
- * @param version - CLI version string
- */
-export declare function displayStartupHeader(version: string): Promise<void>;
-//# sourceMappingURL=license.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../../src/utils/license.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAG/D,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAO/E;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAYzD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAa3E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAyC7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAuDhE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE"}