@skillsmith/core 0.4.0 → 0.4.2

package/dist/src/config/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Shared Configuration Module
+ * @module @skillsmith/core/config
+ *
+ * SMI-1851: Shared Config Module
+ *
+ * Provides cross-platform configuration loading from:
+ * - Environment variables (highest precedence)
+ * - ~/.skillsmith/config.json
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig, getApiKey, saveConfig } from '@skillsmith/core/config'
+ *
+ * // Load full config
+ * const config = loadConfig()
+ *
+ * // Get API key (env var takes precedence)
+ * const apiKey = getApiKey()
+ *
+ * // Save config (creates file with 0600 permissions)
+ * saveConfig({ apiKey: 'sk_live_...' })
+ * ```
+ */
+/**
+ * Skillsmith configuration schema
+ */
+export interface SkillsmithConfig {
+    /** API key for authenticated requests (sk_live_...) */
+    apiKey?: string;
+    /** API base URL override */
+    apiBaseUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Telemetry settings */
+    telemetry?: {
+        /** Enable telemetry (default: false, opt-in) */
+        enabled?: boolean;
+    };
+    /** Sync settings */
+    sync?: {
+        /** Enable background sync */
+        enabled?: boolean;
+        /** Sync interval in milliseconds */
+        intervalMs?: number;
+    };
+}
+/**
+ * Get the config directory path
+ * Cross-platform: uses os.homedir()
+ *
+ * @returns Absolute path to ~/.skillsmith/
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the config file path
+ *
+ * @returns Absolute path to ~/.skillsmith/config.json
+ */
+export declare function getConfigPath(): string;
+/**
+ * Ensure config directory exists with secure permissions
+ * Creates ~/.skillsmith/ if it doesn't exist
+ */
+export declare function ensureConfigDir(): void;
+/**
+ * Load configuration from ~/.skillsmith/config.json
+ *
+ * @returns Parsed config or empty object if file doesn't exist
+ */
+export declare function loadConfig(): SkillsmithConfig;
+/**
+ * Save configuration to ~/.skillsmith/config.json
+ * Creates the file with 0600 permissions (owner read/write only)
+ *
+ * @param config - Configuration to save (merged with existing)
+ * @param options - Save options
+ */
+export declare function saveConfig(config: Partial<SkillsmithConfig>, options?: {
+    merge?: boolean;
+}): void;
+/**
+ * Get API key with precedence: env var > config file
+ *
+ * Checks in order:
+ * 1. SKILLSMITH_API_KEY environment variable
+ * 2. ~/.skillsmith/config.json apiKey field
+ *
+ * @returns API key or undefined if not configured
+ */
+export declare function getApiKey(): string | undefined;
+/**
+ * Get API base URL with precedence: env var > config file > default
+ *
+ * @param defaultUrl - Default URL if not configured
+ * @returns API base URL
+ */
+export declare function getApiBaseUrl(defaultUrl?: string): string;
+/**
+ * Check if debug mode is enabled
+ *
+ * @returns true if debug is enabled via env var or config
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Check if telemetry is enabled (opt-in, default false)
+ *
+ * @returns true if telemetry is explicitly enabled
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Validate API key format
+ *
+ * @param key - API key to validate
+ * @returns true if key has valid format (sk_live_...)
+ */
+export declare function isValidApiKeyFormat(key: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE;QACV,gDAAgD;QAChD,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAA;IACD,oBAAoB;IACpB,IAAI,CAAC,EAAE;QACL,6BAA6B;QAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,oCAAoC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAQD;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CAc7C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACjC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAoB,GAC7C,IAAI,CAqBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAU9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,SAA+B,GAAG,MAAM,CAQ/E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAOxC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/src/config/index.js

@@ -0,0 +1,172 @@
+/**
+ * Shared Configuration Module
+ * @module @skillsmith/core/config
+ *
+ * SMI-1851: Shared Config Module
+ *
+ * Provides cross-platform configuration loading from:
+ * - Environment variables (highest precedence)
+ * - ~/.skillsmith/config.json
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig, getApiKey, saveConfig } from '@skillsmith/core/config'
+ *
+ * // Load full config
+ * const config = loadConfig()
+ *
+ * // Get API key (env var takes precedence)
+ * const apiKey = getApiKey()
+ *
+ * // Save config (creates file with 0600 permissions)
+ * saveConfig({ apiKey: 'sk_live_...' })
+ * ```
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync } from 'fs';
+/** Default config directory name */
+const CONFIG_DIR = '.skillsmith';
+/** Default config file name */
+const CONFIG_FILE = 'config.json';
+/**
+ * Get the config directory path
+ * Cross-platform: uses os.homedir()
+ *
+ * @returns Absolute path to ~/.skillsmith/
+ */
+export function getConfigDir() {
+    return join(homedir(), CONFIG_DIR);
+}
+/**
+ * Get the config file path
+ *
+ * @returns Absolute path to ~/.skillsmith/config.json
+ */
+export function getConfigPath() {
+    return join(getConfigDir(), CONFIG_FILE);
+}
+/**
+ * Ensure config directory exists with secure permissions
+ * Creates ~/.skillsmith/ if it doesn't exist
+ */
+export function ensureConfigDir() {
+    const configDir = getConfigDir();
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Load configuration from ~/.skillsmith/config.json
+ *
+ * @returns Parsed config or empty object if file doesn't exist
+ */
+export function loadConfig() {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const configData = readFileSync(configPath, 'utf-8');
+        return JSON.parse(configData);
+    }
+    catch {
+        // Silently ignore parse errors, return empty config
+        return {};
+    }
+}
+/**
+ * Save configuration to ~/.skillsmith/config.json
+ * Creates the file with 0600 permissions (owner read/write only)
+ *
+ * @param config - Configuration to save (merged with existing)
+ * @param options - Save options
+ */
+export function saveConfig(config, options = { merge: true }) {
+    ensureConfigDir();
+    const configPath = getConfigPath();
+    let existingConfig = {};
+    if (options.merge && existsSync(configPath)) {
+        existingConfig = loadConfig();
+    }
+    const mergedConfig = { ...existingConfig, ...config };
+    const configJson = JSON.stringify(mergedConfig, null, 2);
+    writeFileSync(configPath, configJson, { encoding: 'utf-8', mode: 0o600 });
+    // Ensure permissions are set correctly (in case file existed)
+    try {
+        chmodSync(configPath, 0o600);
+    }
+    catch {
+        // Ignore chmod errors on Windows
+    }
+}
+/**
+ * Get API key with precedence: env var > config file
+ *
+ * Checks in order:
+ * 1. SKILLSMITH_API_KEY environment variable
+ * 2. ~/.skillsmith/config.json apiKey field
+ *
+ * @returns API key or undefined if not configured
+ */
+export function getApiKey() {
+    // Environment variable takes precedence
+    const envKey = process.env.SKILLSMITH_API_KEY;
+    if (envKey) {
+        return envKey;
+    }
+    // Fall back to config file
+    const config = loadConfig();
+    return config.apiKey;
+}
+/**
+ * Get API base URL with precedence: env var > config file > default
+ *
+ * @param defaultUrl - Default URL if not configured
+ * @returns API base URL
+ */
+export function getApiBaseUrl(defaultUrl = 'https://api.skillsmith.app') {
+    const envUrl = process.env.SKILLSMITH_API_URL;
+    if (envUrl) {
+        return envUrl;
+    }
+    const config = loadConfig();
+    return config.apiBaseUrl || defaultUrl;
+}
+/**
+ * Check if debug mode is enabled
+ *
+ * @returns true if debug is enabled via env var or config
+ */
+export function isDebugEnabled() {
+    if (process.env.SKILLSMITH_DEBUG === 'true' || process.env.SKILLSMITH_DEBUG === '1') {
+        return true;
+    }
+    const config = loadConfig();
+    return config.debug === true;
+}
+/**
+ * Check if telemetry is enabled (opt-in, default false)
+ *
+ * @returns true if telemetry is explicitly enabled
+ */
+export function isTelemetryEnabled() {
+    if (process.env.SKILLSMITH_TELEMETRY_ENABLED === 'true') {
+        return true;
+    }
+    if (process.env.SKILLSMITH_TELEMETRY_ENABLED === 'false') {
+        return false;
+    }
+    const config = loadConfig();
+    return config.telemetry?.enabled === true;
+}
+/**
+ * Validate API key format
+ *
+ * @param key - API key to validate
+ * @returns true if key has valid format (sk_live_...)
+ */
+export function isValidApiKeyFormat(key) {
+    return /^sk_live_[A-Za-z0-9_-]{32,}$/.test(key);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/config/index.js.map

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

package/dist/src/db/migration-types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Type definitions for Database Migration Utilities
+ * @module @skillsmith/core/db/migration-types
+ */
+/**
+ * Schema compatibility status
+ */
+export interface SchemaCompatibility {
+    isCompatible: boolean;
+    currentVersion: number;
+    expectedVersion: number;
+    action: 'none' | 'upgrade' | 'downgrade_warning' | 'incompatible';
+    message: string;
+}
+/**
+ * Merge result statistics
+ */
+export interface MergeResult {
+    skillsAdded: number;
+    skillsUpdated: number;
+    skillsSkipped: number;
+    conflicts: MergeConflict[];
+    duration: number;
+}
+/**
+ * Merge conflict information
+ */
+export interface MergeConflict {
+    skillId: string;
+    reason: 'duplicate_id' | 'schema_mismatch' | 'validation_error';
+    sourceValue?: unknown;
+    targetValue?: unknown;
+    resolution?: 'kept_target' | 'updated' | 'skipped';
+}
+/**
+ * Merge strategy options
+ */
+export type MergeStrategy = 'keep_target' | 'keep_source' | 'keep_newer' | 'merge_fields';
+/**
+ * Merge options configuration
+ */
+export interface MergeOptions {
+    strategy: MergeStrategy;
+    dryRun?: boolean;
+    onConflict?: (conflict: MergeConflict) => MergeStrategy;
+    skipInvalid?: boolean;
+}
+/**
+ * Sync status for Supabase integration
+ */
+export interface SyncStatus {
+    connected: boolean;
+    lastSyncAt: string | null;
+    nextSyncAt: string | null;
+    skillsInLocal: number;
+    skillsInRemote: number;
+    pendingUploads: number;
+    pendingDownloads: number;
+}
+/**
+ * Supabase sync configuration
+ */
+export interface SupabaseSyncConfig {
+    url: string;
+    anonKey: string;
+    table?: string;
+    batchSize?: number;
+    conflictStrategy?: MergeStrategy;
+}
+/**
+ * Skill row from database
+ */
+export interface SkillRow {
+    id: string;
+    name: string;
+    description: string | null;
+    author: string | null;
+    repo_url: string | null;
+    quality_score: number | null;
+    trust_tier: string;
+    tags: string;
+    created_at: string;
+    updated_at: string;
+    source: string | null;
+    stars: number | null;
+}
+/**
+ * Sync history entry
+ */
+export interface SyncHistoryEntry {
+    id: string;
+    started_at: string;
+    completed_at: string | null;
+    status: string;
+    skills_added: number;
+    skills_updated: number;
+    skills_unchanged: number;
+    error_message: string | null;
+    duration_ms: number | null;
+}
+//# sourceMappingURL=migration-types.d.ts.map

package/dist/src/db/migration-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-types.d.ts","sourceRoot":"","sources":["../../../src/db/migration-types.ts"],"names":[],"mappings":"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"}

package/dist/src/db/migration-types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Database Migration Utilities
+ * @module @skillsmith/core/db/migration-types
+ */
+export {};
+//# sourceMappingURL=migration-types.js.map

package/dist/src/db/migration-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-types.js","sourceRoot":"","sources":["../../../src/db/migration-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/db/migration.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Database Migration Utilities
+ *
+ * SMI-1446: Handle schema version mismatch during imports
+ * SMI-1448: Database merge tooling for combining skill databases
+ * SMI-1452: Sync utilities for local-to-Supabase synchronization
+ *
+ * @see migration-types.ts for type definitions
+ */
+import type { Database as DatabaseType } from 'better-sqlite3';
+export type { SchemaCompatibility, MergeResult, MergeConflict, MergeStrategy, MergeOptions, SyncStatus, SupabaseSyncConfig, SkillRow, SyncHistoryEntry, } from './migration-types.js';
+import type { SchemaCompatibility, MergeResult, MergeOptions, SyncHistoryEntry } from './migration-types.js';
+export declare function checkSchemaCompatibility(db: DatabaseType): SchemaCompatibility;
+export declare function ensureSchemaCompatibility(db: DatabaseType): void;
+export declare function mergeSkillDatabases(target: DatabaseType, source: DatabaseType, options?: MergeOptions): MergeResult;
+export declare function getSyncStatus(db: DatabaseType): Omit<{
+    connected: boolean;
+    lastSyncAt: string | null;
+    nextSyncAt: string | null;
+    skillsInLocal: number;
+    skillsInRemote: number;
+    pendingUploads: number;
+    pendingDownloads: number;
+}, 'connected' | 'skillsInRemote'>;
+export declare function updateSyncStatus(db: DatabaseType, result: {
+    skillsAdded: number;
+    skillsUpdated: number;
+    error?: string;
+}): void;
+export declare function recordSyncRun(db: DatabaseType, status: 'running' | 'success' | 'failed' | 'partial', result?: MergeResult, error?: string): string;
+export declare function getSyncHistory(db: DatabaseType, limit?: number): SyncHistoryEntry[];
+//# sourceMappingURL=migration.d.ts.map

package/dist/src/db/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../../src/db/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAI9D,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EAEX,YAAY,EACZ,gBAAgB,EACjB,MAAM,sBAAsB,CAAA;AAM7B,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,GAAG,mBAAmB,CAuD9E;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAmBhE;AAqBD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,YAAyC,GACjD,WAAW,CAiLb;AAMD,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CACnD;IACE,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;CACzB,EACD,WAAW,GAAG,gBAAgB,CAC/B,CAcA;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE,IAAI,CAkBN;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,EACpD,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAuBR;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,SAAK,GAAG,gBAAgB,EAAE,CAI/E"}