@skillsmith/core 0.5.4 → 0.5.6

package/dist/api/client.types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * API client types & error class
+ * @module api/client.types
+ *
+ * SMI-4120: Extracted from client.ts to keep the client under the 500-line
+ * pre-commit gate (scripts/check-file-length.mjs).
+ */
+import type { TrustTier } from '../types/skill.js';
+import type { ClientCacheSetting } from './client.cache.js';
+/**
+ * API response wrapper
+ */
+export interface ApiResponse<T> {
+    data: T;
+    meta?: Record<string, unknown>;
+}
+/**
+ * API error response
+ */
+export interface ApiErrorResponse {
+    error: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Custom error class for API client errors with retry control
+ * SMI-1257: Replace string-based retry skip with custom error class
+ */
+export declare class ApiClientError extends Error {
+    readonly retryable: boolean;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, retryable?: boolean, statusCode?: number | undefined);
+}
+/**
+ * Search result from API
+ * SMI-1577: Made repo_url, created_at, updated_at optional to match schema
+ * SMI-4240: Added categories, security_score, last_scanned_at, security_findings
+ *   to match the full `...skill` spread returned by skills-get (present on
+ *   get-skill responses, omitted on skills-search responses).
+ */
+export interface ApiSearchResult {
+    id: string;
+    name: string;
+    description: string | null;
+    author: string | null;
+    repo_url?: string | null;
+    quality_score: number | null;
+    trust_tier: TrustTier;
+    tags: string[];
+    stars?: number | null;
+    installable?: boolean | null;
+    quarantined?: boolean;
+    /** SHA-256 hash of SKILL.md content at index time */
+    content_hash?: string | null;
+    /** SMI-3672: Raw SKILL.md content (only when include_content=true) */
+    content?: string | null;
+    created_at?: string;
+    updated_at?: string;
+    /** SMI-4240: Category display names joined from skill_categories */
+    categories?: string[];
+    /** SMI-4240: Security score 0-100 (lower is safer); null until first scan */
+    security_score?: number | null;
+    /** SMI-4240: ISO 8601 timestamp of last security scan; null until first scan */
+    last_scanned_at?: string | null;
+    /** SMI-4240: Security findings array (jsonb); length drives findingsCount */
+    security_findings?: unknown[] | null;
+}
+/**
+ * Recommendation request
+ */
+export interface RecommendationRequest {
+    stack: string[];
+    project_type?: string;
+    limit?: number;
+}
+/**
+ * Telemetry event
+ */
+export interface TelemetryEvent {
+    event: 'skill_view' | 'skill_install' | 'skill_uninstall' | 'skill_rate' | 'search' | 'recommend' | 'compare' | 'validate';
+    skill_id?: string;
+    anonymous_id: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * API client configuration
+ */
+export interface ApiClientConfig {
+    /** Base URL for the API (defaults to production Supabase) */
+    baseUrl?: string;
+    /** Supabase anon key for authentication */
+    anonKey?: string;
+    /** API key for authenticated requests (X-API-Key header) */
+    apiKey?: string;
+    /** SMI-4402: JWT Bearer token from device-code flow (takes precedence over apiKey) */
+    jwtToken?: string;
+    /** Request timeout in ms (default 30000) */
+    timeout?: number;
+    /** Max retry attempts (default 3) */
+    maxRetries?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Enable offline mode (disables API calls) */
+    offlineMode?: boolean;
+    /**
+     * SMI-4120: Response cache config. Provide a pre-built ApiCache, a config
+     * object, or `false` to disable. `SKILLSMITH_DISABLE_CLIENT_CACHE=1` also
+     * disables (takes precedence).
+     */
+    cache?: ClientCacheSetting;
+}
+//# sourceMappingURL=client.types.d.ts.map

package/dist/api/client.types.d.ts.map

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

package/dist/api/client.types.js

@@ -0,0 +1,22 @@
+/**
+ * API client types & error class
+ * @module api/client.types
+ *
+ * SMI-4120: Extracted from client.ts to keep the client under the 500-line
+ * pre-commit gate (scripts/check-file-length.mjs).
+ */
+/**
+ * Custom error class for API client errors with retry control
+ * SMI-1257: Replace string-based retry skip with custom error class
+ */
+export class ApiClientError extends Error {
+    retryable;
+    statusCode;
+    constructor(message, retryable = false, statusCode) {
+        super(message);
+        this.retryable = retryable;
+        this.statusCode = statusCode;
+        this.name = 'ApiClientError';
+    }
+}
+//# sourceMappingURL=client.types.js.map

package/dist/api/client.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.types.js","sourceRoot":"","sources":["../../src/api/client.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IAHlB,YACE,OAAe,EACC,YAAqB,KAAK,EAC1B,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,cAAS,GAAT,SAAS,CAAiB;QAC1B,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF"}

package/dist/api/event-batcher.d.ts

@@ -0,0 +1,81 @@
+/**
+ * EventBatcher — client-side telemetry batcher
+ * @module api/event-batcher
+ *
+ * SMI-4119: Batch telemetry events to reduce Supabase edge function invocations.
+ *
+ * Flushes on:
+ *  - size   : queue reaches `maxBatchSize` (default 20)
+ *  - time   : `maxWaitMs` elapsed since first enqueue in the current batch (default 10s)
+ *  - exit   : `beforeExit` / `SIGINT` / `SIGTERM` (drain with `drainTimeoutMs`, default 2s)
+ *
+ * POSTs to `/events` with `{events: [...]}` and `X-Skillsmith-Batched: true` header.
+ * On failure: retry once after `retryDelayMs` (default 2s); on second failure, drop silently
+ * (matches the existing "fail silently" contract on telemetry).
+ */
+import type { TelemetryEvent } from './client.js';
+/**
+ * Flush function signature. Returns a resolved promise on success, rejects on failure.
+ * Must throw / reject on non-2xx responses so the batcher can retry.
+ */
+export type BatchFlushFn = (events: TelemetryEvent[]) => Promise<void>;
+/**
+ * Construction options for EventBatcher (all optional; defaults documented inline).
+ */
+export interface EventBatcherOptions {
+    /** Max events per batch before forced flush. Default: 20 (aligns with edge function max). */
+    maxBatchSize?: number;
+    /** Max ms to wait after first enqueue before flushing. Default: 10_000. */
+    maxWaitMs?: number;
+    /** Delay before retry on first flush failure. Default: 2_000. */
+    retryDelayMs?: number;
+    /** Max time to wait during process-exit drain. Default: 2_000. */
+    drainTimeoutMs?: number;
+    /** Attach process-exit listeners. Default: true. Disable in tests to avoid handler leaks. */
+    registerExitHandlers?: boolean;
+}
+/**
+ * In-memory batcher. Single-process, fire-and-forget.
+ */
+export declare class EventBatcher {
+    private queue;
+    private timer;
+    private activeFlush;
+    private readonly maxBatchSize;
+    private readonly maxWaitMs;
+    private readonly retryDelayMs;
+    private readonly drainTimeoutMs;
+    private readonly flushFn;
+    private exitHandlersAttached;
+    private disposed;
+    constructor(flushFn: BatchFlushFn, options?: EventBatcherOptions);
+    /**
+     * Enqueue an event. Flushes immediately if the batch reaches `maxBatchSize`.
+     * Fire-and-forget — errors are swallowed.
+     */
+    enqueue(event: TelemetryEvent): void;
+    /**
+     * Force a flush of any queued events. Resolves when the in-flight POST completes.
+     * Used by shutdown paths and tests.
+     */
+    flush(): Promise<void>;
+    /**
+     * Current queue depth (observability / tests).
+     */
+    size(): number;
+    /**
+     * Detach exit handlers and clear timers. Call when disposing short-lived clients.
+     */
+    dispose(): void;
+    private clearTimer;
+    private flushNow;
+    private doFlushWithRetry;
+    private attachExitHandlers;
+    private detachExitHandlers;
+    private drainHandler;
+}
+/**
+ * Factory for an EventBatcher bound to a POST function.
+ */
+export declare function createEventBatcher(flushFn: BatchFlushFn, options?: EventBatcherOptions): EventBatcher;
+//# sourceMappingURL=event-batcher.d.ts.map

package/dist/api/event-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-batcher.d.ts","sourceRoot":"","sources":["../../src/api/event-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAOD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,oBAAoB,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,mBAAwB;IAYpE;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAuBpC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,UAAU;YAOJ,QAAQ;YA+BR,gBAAgB;IAoB9B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,YAAY,CAWnB;CACF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAEd"}

package/dist/api/event-batcher.js

@@ -0,0 +1,191 @@
+/**
+ * EventBatcher — client-side telemetry batcher
+ * @module api/event-batcher
+ *
+ * SMI-4119: Batch telemetry events to reduce Supabase edge function invocations.
+ *
+ * Flushes on:
+ *  - size   : queue reaches `maxBatchSize` (default 20)
+ *  - time   : `maxWaitMs` elapsed since first enqueue in the current batch (default 10s)
+ *  - exit   : `beforeExit` / `SIGINT` / `SIGTERM` (drain with `drainTimeoutMs`, default 2s)
+ *
+ * POSTs to `/events` with `{events: [...]}` and `X-Skillsmith-Batched: true` header.
+ * On failure: retry once after `retryDelayMs` (default 2s); on second failure, drop silently
+ * (matches the existing "fail silently" contract on telemetry).
+ */
+const DEFAULT_MAX_BATCH_SIZE = 20;
+const DEFAULT_MAX_WAIT_MS = 10_000;
+const DEFAULT_RETRY_DELAY_MS = 2_000;
+const DEFAULT_DRAIN_TIMEOUT_MS = 2_000;
+/**
+ * In-memory batcher. Single-process, fire-and-forget.
+ */
+export class EventBatcher {
+    queue = [];
+    timer = null;
+    activeFlush = null;
+    maxBatchSize;
+    maxWaitMs;
+    retryDelayMs;
+    drainTimeoutMs;
+    flushFn;
+    exitHandlersAttached = false;
+    disposed = false;
+    constructor(flushFn, options = {}) {
+        this.flushFn = flushFn;
+        this.maxBatchSize = options.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+        this.maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
+        this.retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+        this.drainTimeoutMs = options.drainTimeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS;
+        if (options.registerExitHandlers !== false) {
+            this.attachExitHandlers();
+        }
+    }
+    /**
+     * Enqueue an event. Flushes immediately if the batch reaches `maxBatchSize`.
+     * Fire-and-forget — errors are swallowed.
+     */
+    enqueue(event) {
+        if (this.disposed)
+            return;
+        this.queue.push(event);
+        if (this.queue.length >= this.maxBatchSize) {
+            // Size-based flush: cancel pending timer, fire immediately.
+            this.clearTimer();
+            void this.flushNow();
+            return;
+        }
+        if (this.timer === null) {
+            this.timer = setTimeout(() => {
+                this.timer = null;
+                void this.flushNow();
+            }, this.maxWaitMs);
+            // Unref so the timer does not keep the event loop alive.
+            if (typeof this.timer.unref === 'function') {
+                ;
+                this.timer.unref();
+            }
+        }
+    }
+    /**
+     * Force a flush of any queued events. Resolves when the in-flight POST completes.
+     * Used by shutdown paths and tests.
+     */
+    async flush() {
+        this.clearTimer();
+        await this.flushNow();
+    }
+    /**
+     * Current queue depth (observability / tests).
+     */
+    size() {
+        return this.queue.length;
+    }
+    /**
+     * Detach exit handlers and clear timers. Call when disposing short-lived clients.
+     */
+    dispose() {
+        this.disposed = true;
+        this.clearTimer();
+        this.detachExitHandlers();
+    }
+    clearTimer() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    async flushNow() {
+        // Serialize flushes: if one is in flight, chain.
+        if (this.activeFlush) {
+            await this.activeFlush.catch(() => undefined);
+        }
+        if (this.queue.length === 0)
+            return;
+        const batch = this.queue.splice(0, this.maxBatchSize);
+        this.activeFlush = this.doFlushWithRetry(batch).finally(() => {
+            this.activeFlush = null;
+        });
+        await this.activeFlush.catch(() => undefined);
+        // SMI-4119: If a burst enqueued more than `maxBatchSize` events while we
+        // were splicing, the leftover tail has no timer scheduled (size-triggered
+        // flush cleared it) and would otherwise stall until the next enqueue or
+        // process exit. Re-arm the timer or flush immediately if we're still at
+        // capacity.
+        if (this.queue.length >= this.maxBatchSize) {
+            void this.flushNow();
+        }
+        else if (this.queue.length > 0 && this.timer === null && !this.disposed) {
+            this.timer = setTimeout(() => {
+                this.timer = null;
+                void this.flushNow();
+            }, this.maxWaitMs);
+            if (typeof this.timer.unref === 'function') {
+                ;
+                this.timer.unref();
+            }
+        }
+    }
+    async doFlushWithRetry(batch) {
+        try {
+            await this.flushFn(batch);
+            return;
+        }
+        catch {
+            // swallow; retry below
+        }
+        await new Promise((resolve) => {
+            const t = setTimeout(resolve, this.retryDelayMs);
+            if (typeof t.unref === 'function') {
+                ;
+                t.unref();
+            }
+        });
+        try {
+            await this.flushFn(batch);
+        }
+        catch {
+            // Second failure: drop silently to match telemetry contract.
+        }
+    }
+    attachExitHandlers() {
+        if (this.exitHandlersAttached)
+            return;
+        if (typeof process === 'undefined' || typeof process.on !== 'function')
+            return;
+        this.exitHandlersAttached = true;
+        process.on('beforeExit', this.drainHandler);
+        process.on('SIGINT', this.drainHandler);
+        process.on('SIGTERM', this.drainHandler);
+    }
+    detachExitHandlers() {
+        if (!this.exitHandlersAttached)
+            return;
+        if (typeof process === 'undefined' || typeof process.off !== 'function')
+            return;
+        this.exitHandlersAttached = false;
+        process.off('beforeExit', this.drainHandler);
+        process.off('SIGINT', this.drainHandler);
+        process.off('SIGTERM', this.drainHandler);
+    }
+    drainHandler = () => {
+        // Best-effort drain with timeout. Fire-and-forget — callers of beforeExit
+        // cannot await async handlers reliably, but attaching starts the work.
+        const drain = this.flush();
+        const timeout = new Promise((resolve) => {
+            const t = setTimeout(resolve, this.drainTimeoutMs);
+            if (typeof t.unref === 'function') {
+                ;
+                t.unref();
+            }
+        });
+        void Promise.race([drain, timeout]).catch(() => undefined);
+    };
+}
+/**
+ * Factory for an EventBatcher bound to a POST function.
+ */
+export function createEventBatcher(flushFn, options) {
+    return new EventBatcher(flushFn, options);
+}
+//# sourceMappingURL=event-batcher.js.map

package/dist/api/event-batcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-batcher.js","sourceRoot":"","sources":["../../src/api/event-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0BH,MAAM,sBAAsB,GAAG,EAAE,CAAA;AACjC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAClC,MAAM,sBAAsB,GAAG,KAAK,CAAA;AACpC,MAAM,wBAAwB,GAAG,KAAK,CAAA;AAEtC;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAqB,EAAE,CAAA;IAC5B,KAAK,GAAyC,IAAI,CAAA;IAClD,WAAW,GAAyB,IAAI,CAAA;IAC/B,YAAY,CAAQ;IACpB,SAAS,CAAQ;IACjB,YAAY,CAAQ;IACpB,cAAc,CAAQ;IACtB,OAAO,CAAc;IAC9B,oBAAoB,GAAG,KAAK,CAAA;IAC5B,QAAQ,GAAG,KAAK,CAAA;IAExB,YAAY,OAAqB,EAAE,UAA+B,EAAE;QAClE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAA;QAClE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,mBAAmB,CAAA;QACzD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAA;QAClE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAA;QAExE,IAAI,OAAO,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,kBAAkB,EAAE,CAAA;QAC3B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAqB;QAC3B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAEtB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3C,4DAA4D;YAC5D,IAAI,CAAC,UAAU,EAAE,CAAA;YACjB,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;YACpB,OAAM;QACR,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;gBACjB,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;YACtB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YAClB,yDAAyD;YACzD,IAAI,OAAQ,IAAI,CAAC,KAAgC,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACvE,CAAC;gBAAC,IAAI,CAAC,KAA+B,CAAC,KAAK,EAAE,CAAA;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;IACvB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,CAAC,kBAAkB,EAAE,CAAA;IAC3B,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,iDAAiD;QACjD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC/C,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QACrD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC3D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACzB,CAAC,CAAC,CAAA;QACF,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAE7C,yEAAyE;QACzE,0EAA0E;QAC1E,wEAAwE;QACxE,wEAAwE;QACxE,YAAY;QACZ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3C,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;QACtB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1E,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;gBACjB,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAA;YACtB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YAClB,IAAI,OAAQ,IAAI,CAAC,KAAgC,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACvE,CAAC;gBAAC,IAAI,CAAC,KAA+B,CAAC,KAAK,EAAE,CAAA;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,KAAuB;QACpD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACzB,OAAM;QACR,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;YAChD,IAAI,OAAQ,CAA4B,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC9D,CAAC;gBAAC,CAA2B,CAAC,KAAK,EAAE,CAAA;YACvC,CAAC;QACH,CAAC,CAAC,CAAA;QACF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,IAAI,IAAI,CAAC,oBAAoB;YAAE,OAAM;QACrC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,UAAU;YAAE,OAAM;QAC9E,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAA;QAChC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAC3C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QACvC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IAC1C,CAAC;IAEO,kBAAkB;QACxB,IAAI,CAAC,IAAI,CAAC,oBAAoB;YAAE,OAAM;QACtC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU;YAAE,OAAM;QAC/E,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAA;QACjC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAC5C,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QACxC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IAC3C,CAAC;IAEO,YAAY,GAAG,GAAS,EAAE;QAChC,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;YAClD,IAAI,OAAQ,CAA4B,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC9D,CAAC;gBAAC,CAA2B,CAAC,KAAK,EAAE,CAAA;YACvC,CAAC;QACH,CAAC,CAAC,CAAA;QACF,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC5D,CAAC,CAAA;CACF;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,OAA6B;IAE7B,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC3C,CAAC"}

package/dist/api/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * API module exports
+ * @module api
+ *
+ * SMI-1244: API client for Skillsmith
+ * SMI-1245: API response caching
+ * SMI-1300: API types matching OpenAPI spec
+ */
+export { SkillsmithApiClient, createApiClient, generateAnonymousId, ApiClientError, type ApiClientConfig, type ApiResponse, type ApiErrorResponse, type ApiSearchResult, type RecommendationRequest, type TelemetryEvent, } from './client.js';
+export { EventBatcher, createEventBatcher, type EventBatcherOptions, type BatchFlushFn, } from './event-batcher.js';
+export { ApiCache, createCache, getGlobalCache, DEFAULT_TTL, type CacheConfig, type CacheStats, } from './cache.js';
+export type { ApiTrustTier, ApiCategory, ApiProjectType, ApiSkill, ApiSearchResult as OpenApiSearchResult, RecommendedSkill, SearchParams, SearchResponse, SearchResponseMeta, RecommendParams, RecommendResponse, RecommendResponseMeta, SkillResponse, HealthStatus, TelemetryEventType, TelemetryMetadata, TelemetryEventPayload, TelemetryResponse, ApiErrorResponse as OpenApiErrorResponse, RateLimitInfo, ApiClientOptions, ApiResponse as OpenApiResponse, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAA;AAM3B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA;AAMnB,YAAY,EAEV,YAAY,EACZ,WAAW,EACX,cAAc,EAEd,QAAQ,EACR,eAAe,IAAI,mBAAmB,EACtC,gBAAgB,EAEhB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAElB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EAErB,aAAa,EAEb,YAAY,EAEZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAEjB,gBAAgB,IAAI,oBAAoB,EAExC,aAAa,EAEb,gBAAgB,EAEhB,WAAW,IAAI,eAAe,GAC/B,MAAM,YAAY,CAAA"}

package/dist/api/index.js

@@ -0,0 +1,19 @@
+/**
+ * API module exports
+ * @module api
+ *
+ * SMI-1244: API client for Skillsmith
+ * SMI-1245: API response caching
+ * SMI-1300: API types matching OpenAPI spec
+ */
+// ============================================================================
+// API Client
+// ============================================================================
+export { SkillsmithApiClient, createApiClient, generateAnonymousId, ApiClientError, } from './client.js';
+// SMI-4119: Event batching
+export { EventBatcher, createEventBatcher, } from './event-batcher.js';
+// ============================================================================
+// API Cache
+// ============================================================================
+export { ApiCache, createCache, getGlobalCache, DEFAULT_TTL, } from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,cAAc,GAOf,MAAM,aAAa,CAAA;AAEpB,2BAA2B;AAC3B,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,oBAAoB,CAAA;AAE3B,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,WAAW,GAGZ,MAAM,YAAY,CAAA"}