@skillsmith/core 0.1.0

package/dist/src/sources/RawUrlSourceAdapter.js

@@ -0,0 +1,282 @@
+/**
+ * Raw URL Source Adapter (SMI-591)
+ *
+ * Fetches skills from arbitrary HTTP/HTTPS URLs.
+ * Useful for custom registries or standalone skill files.
+ */
+import { BaseSourceAdapter } from './BaseSourceAdapter.js';
+import { createHash } from 'crypto';
+import { createLogger } from '../utils/logger.js';
+import { validateUrl } from '../validation/index.js';
+import { ApiError, wrapError } from '../errors/SkillsmithError.js';
+const log = createLogger('RawUrlAdapter');
+/**
+ * Raw URL Source Adapter
+ *
+ * Fetches skill files from arbitrary HTTP/HTTPS URLs.
+ * Can work with:
+ * - A predefined list of skill URLs
+ * - A JSON registry file containing skill entries
+ * - Direct URL locations
+ *
+ * @example
+ * ```typescript
+ * const adapter = new RawUrlSourceAdapter({
+ *   id: 'custom-registry',
+ *   name: 'Custom Registry',
+ *   type: 'raw-url',
+ *   baseUrl: 'https://example.com',
+ *   enabled: true,
+ *   skillUrls: [
+ *     { id: '1', name: 'My Skill', url: 'https://example.com/skill.md' }
+ *   ]
+ * })
+ *
+ * await adapter.initialize()
+ * const content = await adapter.fetchSkillContent({
+ *   owner: 'example.com',
+ *   repo: 'my-skill',
+ *   path: 'https://example.com/skill.md'
+ * })
+ * ```
+ */
+export class RawUrlSourceAdapter extends BaseSourceAdapter {
+    skillUrls = [];
+    timeout;
+    constructor(config) {
+        super(config);
+        this.skillUrls = config.skillUrls ?? [];
+        this.timeout = config.timeout ?? 30000;
+    }
+    /**
+     * Initialize adapter - load registry if configured
+     */
+    async doInitialize() {
+        const config = this.config;
+        if (config.registryUrl) {
+            await this.loadRegistry(config.registryUrl);
+        }
+    }
+    /**
+     * Load skill entries from a remote JSON registry
+     */
+    async loadRegistry(registryUrl) {
+        try {
+            validateUrl(registryUrl);
+            const response = await this.fetchWithTimeout(registryUrl);
+            if (!response.ok) {
+                throw new ApiError(`Failed to load registry: ${response.status}`, {
+                    statusCode: response.status,
+                    url: registryUrl,
+                });
+            }
+            const data = (await response.json());
+            if (data.skills && Array.isArray(data.skills)) {
+                this.skillUrls = [...this.skillUrls, ...data.skills];
+            }
+        }
+        catch (error) {
+            // Registry load is optional - log but don't fail (SMI-881: preserve error context)
+            const wrappedError = wrapError(error, `Failed to load registry from ${registryUrl}`);
+            log.warn(wrappedError.message);
+        }
+    }
+    /**
+     * Check if the source is reachable
+     */
+    async doHealthCheck() {
+        // Try to reach the base URL
+        try {
+            validateUrl(this.config.baseUrl);
+            const response = await this.fetchWithTimeout(this.config.baseUrl, { method: 'HEAD' });
+            return {
+                healthy: response.ok || response.status === 405, // 405 = Method Not Allowed is ok for HEAD
+            };
+        }
+        catch {
+            return {
+                healthy: false,
+                error: 'Base URL unreachable',
+            };
+        }
+    }
+    /**
+     * Search for skills in the configured registry
+     */
+    async search(options = {}) {
+        await this.waitForRateLimit();
+        let filtered = [...this.skillUrls];
+        // Filter by query (search in name, description, tags)
+        if (options.query) {
+            const query = options.query.toLowerCase();
+            filtered = filtered.filter((entry) => entry.name.toLowerCase().includes(query) ||
+                entry.description?.toLowerCase().includes(query) ||
+                entry.tags?.some((tag) => tag.toLowerCase().includes(query)));
+        }
+        // Filter by topics (match against tags)
+        if (options.topics?.length) {
+            filtered = filtered.filter((entry) => options.topics.some((topic) => entry.tags?.includes(topic)));
+        }
+        // Apply limit
+        const limit = options.limit ?? 100;
+        const limitedResults = filtered.slice(0, limit);
+        // Convert to SourceRepository format
+        const repositories = limitedResults.map((entry) => this.entryToRepository(entry));
+        return {
+            repositories,
+            totalCount: filtered.length,
+            hasMore: filtered.length > limit,
+        };
+    }
+    /**
+     * Get repository (skill entry) by location
+     */
+    async getRepository(location) {
+        await this.waitForRateLimit();
+        // Find by URL or ID
+        const url = location.path ?? `${this.config.baseUrl}/${location.owner}/${location.repo}`;
+        const entry = this.skillUrls.find((e) => e.url === url || e.id === location.repo);
+        if (entry) {
+            return this.entryToRepository(entry);
+        }
+        // Create a synthetic entry for the URL
+        return {
+            id: this.generateId(url),
+            name: location.repo ?? 'Unknown Skill',
+            url,
+            description: null,
+            owner: location.owner ?? new URL(url).hostname,
+            defaultBranch: 'main',
+            stars: 0,
+            forks: 0,
+            topics: [],
+            updatedAt: new Date().toISOString(),
+            createdAt: new Date().toISOString(),
+            license: null,
+            metadata: { sourceType: 'raw-url' },
+        };
+    }
+    /**
+     * Fetch skill content from a URL
+     */
+    async fetchSkillContent(location) {
+        // Determine the URL to fetch
+        let url;
+        if (location.path?.startsWith('http')) {
+            url = location.path;
+        }
+        else {
+            // Try to find in registry
+            const entry = this.skillUrls.find((e) => e.id === location.repo || e.name === location.repo);
+            if (entry) {
+                url = entry.url;
+            }
+            else {
+                // Construct URL from base
+                url = `${this.config.baseUrl}/${location.owner}/${location.repo}/SKILL.md`;
+            }
+        }
+        // Validate URL to prevent SSRF attacks (SMI-721, SMI-726, SMI-729)
+        validateUrl(url);
+        // Note: Rate limiting is handled by fetchWithTimeout -> fetchWithRateLimit
+        const response = await this.fetchWithTimeout(url);
+        if (!response.ok) {
+            throw new ApiError(`Failed to fetch skill content: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const rawContent = await response.text();
+        const sha = this.generateSha(rawContent);
+        return {
+            rawContent,
+            sha,
+            location,
+            filePath: new URL(url).pathname,
+            encoding: 'utf-8',
+        };
+    }
+    /**
+     * Add a skill URL to the registry
+     */
+    addSkillUrl(entry) {
+        this.skillUrls.push(entry);
+    }
+    /**
+     * Remove a skill URL from the registry
+     */
+    removeSkillUrl(id) {
+        const index = this.skillUrls.findIndex((e) => e.id === id);
+        if (index >= 0) {
+            this.skillUrls.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get all registered skill URLs
+     */
+    getSkillUrls() {
+        return [...this.skillUrls];
+    }
+    /**
+     * Convert a registry entry to SourceRepository
+     */
+    entryToRepository(entry) {
+        const urlObj = new URL(entry.url);
+        return {
+            id: entry.id,
+            name: entry.name,
+            url: entry.url,
+            description: entry.description ?? null,
+            owner: entry.author ?? urlObj.hostname,
+            defaultBranch: 'main',
+            stars: 0,
+            forks: 0,
+            topics: entry.tags ?? [],
+            updatedAt: new Date().toISOString(),
+            createdAt: new Date().toISOString(),
+            license: null,
+            metadata: { sourceType: 'raw-url' },
+        };
+    }
+    /**
+     * Fetch with timeout
+     */
+    async fetchWithTimeout(url, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await this.fetchWithRateLimit(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Generate a deterministic ID from a URL
+     */
+    generateId(url) {
+        return createHash('sha256').update(url).digest('hex').slice(0, 16);
+    }
+    /**
+     * Generate SHA hash for content
+     */
+    generateSha(content) {
+        return createHash('sha256').update(content).digest('hex');
+    }
+}
+/**
+ * Factory function for creating Raw URL adapters
+ */
+export function createRawUrlAdapter(config) {
+    return new RawUrlSourceAdapter({
+        ...config,
+        type: 'raw-url',
+    });
+}
+//# sourceMappingURL=RawUrlSourceAdapter.js.map

package/dist/src/sources/RawUrlSourceAdapter.js.map

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

package/dist/src/sources/SourceAdapterRegistry.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Source Adapter Registry
+ * Manages registration and lifecycle of source adapters
+ */
+import type { ISourceAdapter } from './ISourceAdapter.js';
+import type { SourceConfig, SourceHealth, SourceType } from './types.js';
+/**
+ * Factory function type for creating source adapters
+ */
+export type SourceAdapterFactory = (config: SourceConfig) => ISourceAdapter;
+/**
+ * Registry for managing source adapters
+ *
+ * Features:
+ * - Register adapter factories by type
+ * - Create adapter instances from configuration
+ * - Manage adapter lifecycle (initialize, dispose)
+ * - Query adapters by type or ID
+ *
+ * @example
+ * ```typescript
+ * const registry = new SourceAdapterRegistry()
+ *
+ * // Register factory for GitHub adapters
+ * registry.registerFactory('github', (config) => new GitHubSourceAdapter(config))
+ *
+ * // Create an adapter instance
+ * const adapter = await registry.create({
+ *   id: 'github-main',
+ *   name: 'GitHub Main',
+ *   type: 'github',
+ *   baseUrl: 'https://api.github.com',
+ *   enabled: true
+ * })
+ *
+ * // Use the adapter
+ * const results = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export declare class SourceAdapterRegistry {
+    private factories;
+    private adapters;
+    /**
+     * Register a factory for creating adapters of a specific type
+     *
+     * @param type - Source type identifier
+     * @param factory - Factory function to create adapters
+     */
+    registerFactory(type: SourceType | string, factory: SourceAdapterFactory): void;
+    /**
+     * Unregister a factory
+     *
+     * @param type - Source type to unregister
+     */
+    unregisterFactory(type: SourceType | string): void;
+    /**
+     * Check if a factory is registered for a type
+     *
+     * @param type - Source type to check
+     */
+    hasFactory(type: SourceType | string): boolean;
+    /**
+     * Get all registered factory types
+     */
+    getRegisteredTypes(): string[];
+    /**
+     * Create and register an adapter instance
+     *
+     * @param config - Adapter configuration
+     * @param autoInitialize - Whether to initialize immediately (default: true)
+     * @returns The created adapter
+     */
+    create(config: SourceConfig, autoInitialize?: boolean): Promise<ISourceAdapter>;
+    /**
+     * Get an adapter by ID
+     *
+     * @param id - Adapter ID
+     * @returns The adapter, or undefined if not found
+     */
+    get(id: string): ISourceAdapter | undefined;
+    /**
+     * Get an adapter by ID, throwing if not found
+     *
+     * @param id - Adapter ID
+     * @returns The adapter
+     * @throws Error if adapter not found
+     */
+    getOrThrow(id: string): ISourceAdapter;
+    /**
+     * Get all adapters of a specific type
+     *
+     * @param type - Source type to filter by
+     * @returns Array of matching adapters
+     */
+    getByType(type: SourceType | string): ISourceAdapter[];
+    /**
+     * Get all enabled adapters
+     */
+    getEnabled(): ISourceAdapter[];
+    /**
+     * Get all registered adapters
+     */
+    getAll(): ISourceAdapter[];
+    /**
+     * Check if an adapter exists
+     *
+     * @param id - Adapter ID to check
+     */
+    has(id: string): boolean;
+    /**
+     * Initialize an adapter if not already initialized
+     *
+     * @param id - Adapter ID
+     */
+    initialize(id: string): Promise<void>;
+    /**
+     * Initialize all registered adapters
+     */
+    initializeAll(): Promise<void>;
+    /**
+     * Remove and dispose an adapter
+     *
+     * @param id - Adapter ID to remove
+     */
+    remove(id: string): Promise<void>;
+    /**
+     * Remove and dispose all adapters
+     */
+    removeAll(): Promise<void>;
+    /**
+     * Check health of all enabled adapters
+     *
+     * @returns Map of adapter ID to health status
+     */
+    checkHealthAll(): Promise<Map<string, SourceHealth>>;
+    /**
+     * Get registry statistics
+     */
+    getStats(): RegistryStats;
+    private countByType;
+}
+/**
+ * Registry statistics
+ */
+export interface RegistryStats {
+    totalFactories: number;
+    totalAdapters: number;
+    enabledAdapters: number;
+    initializedAdapters: number;
+    adaptersByType: Record<string, number>;
+}
+/**
+ * Default global registry instance
+ */
+export declare const defaultRegistry: SourceAdapterRegistry;
+//# sourceMappingURL=SourceAdapterRegistry.d.ts.map

package/dist/src/sources/SourceAdapterRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceAdapterRegistry.d.ts","sourceRoot":"","sources":["../../../src/sources/SourceAdapterRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAExE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,cAAc,CAAA;AAW3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,SAAS,CAAuD;IACxE,OAAO,CAAC,QAAQ,CAAmC;IAEnD;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAO/E;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAIlD;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,UAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IA2BlF;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc;IAQtC;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,cAAc,EAAE;IAMtD;;OAEG;IACH,UAAU,IAAI,cAAc,EAAE;IAM9B;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;OAIG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAY1D;;OAEG;IACH,QAAQ,IAAI,aAAa;IAWzB,OAAO,CAAC,WAAW;CAQpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,uBAA8B,CAAA"}

package/dist/src/sources/SourceAdapterRegistry.js

@@ -0,0 +1,242 @@
+/**
+ * Source Adapter Registry
+ * Manages registration and lifecycle of source adapters
+ */
+/**
+ * Registry for managing source adapters
+ *
+ * Features:
+ * - Register adapter factories by type
+ * - Create adapter instances from configuration
+ * - Manage adapter lifecycle (initialize, dispose)
+ * - Query adapters by type or ID
+ *
+ * @example
+ * ```typescript
+ * const registry = new SourceAdapterRegistry()
+ *
+ * // Register factory for GitHub adapters
+ * registry.registerFactory('github', (config) => new GitHubSourceAdapter(config))
+ *
+ * // Create an adapter instance
+ * const adapter = await registry.create({
+ *   id: 'github-main',
+ *   name: 'GitHub Main',
+ *   type: 'github',
+ *   baseUrl: 'https://api.github.com',
+ *   enabled: true
+ * })
+ *
+ * // Use the adapter
+ * const results = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export class SourceAdapterRegistry {
+    factories = new Map();
+    adapters = new Map();
+    /**
+     * Register a factory for creating adapters of a specific type
+     *
+     * @param type - Source type identifier
+     * @param factory - Factory function to create adapters
+     */
+    registerFactory(type, factory) {
+        if (this.factories.has(type)) {
+            throw new Error(`Factory already registered for type: ${type}`);
+        }
+        this.factories.set(type, factory);
+    }
+    /**
+     * Unregister a factory
+     *
+     * @param type - Source type to unregister
+     */
+    unregisterFactory(type) {
+        this.factories.delete(type);
+    }
+    /**
+     * Check if a factory is registered for a type
+     *
+     * @param type - Source type to check
+     */
+    hasFactory(type) {
+        return this.factories.has(type);
+    }
+    /**
+     * Get all registered factory types
+     */
+    getRegisteredTypes() {
+        return Array.from(this.factories.keys());
+    }
+    /**
+     * Create and register an adapter instance
+     *
+     * @param config - Adapter configuration
+     * @param autoInitialize - Whether to initialize immediately (default: true)
+     * @returns The created adapter
+     */
+    async create(config, autoInitialize = true) {
+        if (this.adapters.has(config.id)) {
+            throw new Error(`Adapter already exists with id: ${config.id}`);
+        }
+        const factory = this.factories.get(config.type);
+        if (!factory) {
+            throw new Error(`No factory registered for type: ${config.type}`);
+        }
+        const adapter = factory(config);
+        const entry = {
+            adapter,
+            factory,
+            initialized: false,
+        };
+        this.adapters.set(config.id, entry);
+        if (autoInitialize) {
+            await adapter.initialize();
+            entry.initialized = true;
+        }
+        return adapter;
+    }
+    /**
+     * Get an adapter by ID
+     *
+     * @param id - Adapter ID
+     * @returns The adapter, or undefined if not found
+     */
+    get(id) {
+        return this.adapters.get(id)?.adapter;
+    }
+    /**
+     * Get an adapter by ID, throwing if not found
+     *
+     * @param id - Adapter ID
+     * @returns The adapter
+     * @throws Error if adapter not found
+     */
+    getOrThrow(id) {
+        const adapter = this.get(id);
+        if (!adapter) {
+            throw new Error(`Adapter not found: ${id}`);
+        }
+        return adapter;
+    }
+    /**
+     * Get all adapters of a specific type
+     *
+     * @param type - Source type to filter by
+     * @returns Array of matching adapters
+     */
+    getByType(type) {
+        return Array.from(this.adapters.values())
+            .filter((entry) => entry.adapter.type === type)
+            .map((entry) => entry.adapter);
+    }
+    /**
+     * Get all enabled adapters
+     */
+    getEnabled() {
+        return Array.from(this.adapters.values())
+            .filter((entry) => entry.adapter.config.enabled)
+            .map((entry) => entry.adapter);
+    }
+    /**
+     * Get all registered adapters
+     */
+    getAll() {
+        return Array.from(this.adapters.values()).map((entry) => entry.adapter);
+    }
+    /**
+     * Check if an adapter exists
+     *
+     * @param id - Adapter ID to check
+     */
+    has(id) {
+        return this.adapters.has(id);
+    }
+    /**
+     * Initialize an adapter if not already initialized
+     *
+     * @param id - Adapter ID
+     */
+    async initialize(id) {
+        const entry = this.adapters.get(id);
+        if (!entry) {
+            throw new Error(`Adapter not found: ${id}`);
+        }
+        if (!entry.initialized) {
+            await entry.adapter.initialize();
+            entry.initialized = true;
+        }
+    }
+    /**
+     * Initialize all registered adapters
+     */
+    async initializeAll() {
+        const promises = Array.from(this.adapters.entries()).map(async ([id, entry]) => {
+            if (!entry.initialized) {
+                await entry.adapter.initialize();
+                entry.initialized = true;
+            }
+        });
+        await Promise.all(promises);
+    }
+    /**
+     * Remove and dispose an adapter
+     *
+     * @param id - Adapter ID to remove
+     */
+    async remove(id) {
+        const entry = this.adapters.get(id);
+        if (entry) {
+            await entry.adapter.dispose();
+            this.adapters.delete(id);
+        }
+    }
+    /**
+     * Remove and dispose all adapters
+     */
+    async removeAll() {
+        const promises = Array.from(this.adapters.values()).map((entry) => entry.adapter.dispose());
+        await Promise.all(promises);
+        this.adapters.clear();
+    }
+    /**
+     * Check health of all enabled adapters
+     *
+     * @returns Map of adapter ID to health status
+     */
+    async checkHealthAll() {
+        const results = new Map();
+        const promises = this.getEnabled().map(async (adapter) => {
+            const health = await adapter.checkHealth();
+            results.set(adapter.id, health);
+        });
+        await Promise.all(promises);
+        return results;
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        const adapters = Array.from(this.adapters.values());
+        return {
+            totalFactories: this.factories.size,
+            totalAdapters: adapters.length,
+            enabledAdapters: adapters.filter((e) => e.adapter.config.enabled).length,
+            initializedAdapters: adapters.filter((e) => e.initialized).length,
+            adaptersByType: this.countByType(),
+        };
+    }
+    countByType() {
+        const counts = {};
+        for (const entry of this.adapters.values()) {
+            const type = entry.adapter.type;
+            counts[type] = (counts[type] ?? 0) + 1;
+        }
+        return counts;
+    }
+}
+/**
+ * Default global registry instance
+ */
+export const defaultRegistry = new SourceAdapterRegistry();
+//# sourceMappingURL=SourceAdapterRegistry.js.map