@skillsmith/core 0.4.17 → 0.5.1

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

@@ -0,0 +1,98 @@
+/**
+ * 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
+ */
+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;
+}
+/**
+ * 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;
+    /** 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/src/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":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAA;IACP,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,SAAS,EAAE,OAAO;aAClB,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,SAAS,GAAE,OAAe,EAC1B,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,SAAS,CAAA;IACrB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EACD,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,SAAS,GACT,UAAU,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B"}

package/dist/src/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/src/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/src/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/src/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/src/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/src/api/event-batcher.js.map

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

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

@@ -7,6 +7,7 @@
  * SMI-1300: API types matching OpenAPI spec
  */
 export { SkillsmithApiClient, createApiClient, generateAnonymousId, 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/src/api/index.d.ts.map

@@ -1 +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,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AAMpB,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"}
+{"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,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/src/api/index.js

@@ -10,6 +10,8 @@
 // API Client
 // ============================================================================
 export { SkillsmithApiClient, createApiClient, generateAnonymousId, } from './client.js';
+// SMI-4119: Event batching
+export { EventBatcher, createEventBatcher, } from './event-batcher.js';
 // ============================================================================
 // API Cache
 // ============================================================================

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

@@ -1 +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,GAOpB,MAAM,aAAa,CAAA;AAEpB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,WAAW,GAGZ,MAAM,YAAY,CAAA"}
+{"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,GAOpB,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"}

package/dist/src/api/schemas.d.ts

@@ -37,6 +37,7 @@ export declare const ApiSearchResultSchema: z.ZodObject<{
     tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
     stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     installable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodOptional<z.ZodString>;
     updated_at: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -56,6 +57,61 @@ export declare const TelemetryResponseSchema: z.ZodObject<{
     }, z.core.$strip>;
     meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
+/**
+ * Schema for a single telemetry event payload.
+ * Used to validate batch entries client-side before POST.
+ */
+export declare const TelemetryEventSchema: z.ZodObject<{
+    event: z.ZodEnum<{
+        skill_install: "skill_install";
+        skill_uninstall: "skill_uninstall";
+        search: "search";
+        recommend: "recommend";
+        skill_view: "skill_view";
+        skill_rate: "skill_rate";
+        compare: "compare";
+        validate: "validate";
+    }>;
+    skill_id: z.ZodOptional<z.ZodString>;
+    anonymous_id: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Request schema for batched telemetry: `{ events: [...] }` (1..=20).
+ */
+export declare const TelemetryEventBatchSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        event: z.ZodEnum<{
+            skill_install: "skill_install";
+            skill_uninstall: "skill_uninstall";
+            search: "search";
+            recommend: "recommend";
+            skill_view: "skill_view";
+            skill_rate: "skill_rate";
+            compare: "compare";
+            validate: "validate";
+        }>;
+        skill_id: z.ZodOptional<z.ZodString>;
+        anonymous_id: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Response schema for batched telemetry POST.
+ * Returned ONLY for the array-body path; single-event POST still returns `{ ok: true }`.
+ */
+export declare const TelemetryBatchResponseSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    accepted: z.ZodNumber;
+    rejected: z.ZodNumber;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type TelemetryEventPayload = z.infer<typeof TelemetryEventSchema>;
+export type TelemetryEventBatch = z.infer<typeof TelemetryEventBatchSchema>;
+export type TelemetryBatchResponse = z.infer<typeof TelemetryBatchResponseSchema>;
 /**
  * Search response schema with array of results
  */
@@ -78,6 +134,7 @@ export declare const SearchResponseSchema: z.ZodObject<{
         tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
         stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         installable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         created_at: z.ZodOptional<z.ZodString>;
         updated_at: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
@@ -105,6 +162,7 @@ export declare const SingleSkillResponseSchema: z.ZodObject<{
         tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
         stars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         installable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         created_at: z.ZodOptional<z.ZodString>;
         updated_at: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;

package/dist/src/api/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/api/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAA;AAMF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;iBAchC,CAAA;AAMF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;;;kBAK5E;AAMD;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAA;AAMF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;iBAA0D,CAAA;AAE3F;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;iBAAiD,CAAA;AAMvF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE1E;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEpF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/api/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAA;AAMF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;iBAgBhC,CAAA;AAMF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;;;kBAK5E;AAMD;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAA;AAMF;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;iBAc/B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;iBAEpC,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;iBAYvC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAMjF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;iBAA0D,CAAA;AAE3F;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;iBAAiD,CAAA;AAMvF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE1E;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEpF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA"}

package/dist/src/api/schemas.js

@@ -37,6 +37,8 @@ export const ApiSearchResultSchema = z.object({
     tags: z.array(z.string()).default([]),
     stars: z.number().nullable().optional(),
     installable: z.boolean().nullable().optional(),
+    /** SMI-3672: Raw SKILL.md content (only present when include_content=true) */
+    content: z.string().nullable().optional(),
     created_at: z.string().optional(),
     updated_at: z.string().optional(),
 });
@@ -65,6 +67,49 @@ export const TelemetryResponseSchema = z.object({
     meta: z.record(z.string(), z.unknown()).optional(),
 });
 // ============================================================================
+// Telemetry Batch Schemas (SMI-4119)
+// ============================================================================
+/**
+ * Schema for a single telemetry event payload.
+ * Used to validate batch entries client-side before POST.
+ */
+export const TelemetryEventSchema = z.object({
+    event: z.enum([
+        'skill_view',
+        'skill_install',
+        'skill_uninstall',
+        'skill_rate',
+        'search',
+        'recommend',
+        'compare',
+        'validate',
+    ]),
+    skill_id: z.string().optional(),
+    anonymous_id: z.string(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Request schema for batched telemetry: `{ events: [...] }` (1..=20).
+ */
+export const TelemetryEventBatchSchema = z.object({
+    events: z.array(TelemetryEventSchema).min(1).max(20),
+});
+/**
+ * Response schema for batched telemetry POST.
+ * Returned ONLY for the array-body path; single-event POST still returns `{ ok: true }`.
+ */
+export const TelemetryBatchResponseSchema = z.object({
+    ok: z.boolean(),
+    accepted: z.number().int().min(0),
+    rejected: z.number().int().min(0),
+    errors: z
+        .array(z.object({
+        index: z.number().int(),
+        reason: z.string(),
+    }))
+        .optional(),
+});
+// ============================================================================
 // Pre-built Response Schemas
 // ============================================================================
 /**

package/dist/src/api/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/api/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,UAAU;IACV,SAAS;IACT,WAAW;IACX,cAAc;IACd,SAAS;CACV,CAAC,CAAA;AAEF,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAA;AAEF,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAyB,UAAa;IAC3E,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACnD,CAAC,CAAA;AACJ,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;KAChB,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAA;AAEF,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAA;AAE3F;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/api/schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/audit/remote-audit.d.ts

@@ -0,0 +1,28 @@
+export interface InstallEventPayload {
+    skillId: string;
+    source: 'mcp' | 'cli' | 'vscode';
+    success: boolean;
+    durationMs?: number;
+    trustTier?: string;
+    errorCode?: string;
+}
+/**
+ * Emit a skill-install event to Skillsmith's remote telemetry endpoint.
+ *
+ * Best-effort: never throws, never blocks the caller. Silently skips in these cases:
+ * - No API key available (CLI offline / unauthenticated)
+ * - SKILLSMITH_TELEMETRY=0 (opt-out)
+ * - Network / endpoint failure
+ *
+ * The API key is mapped to a namespaced, non-reversible telemetry actor ID
+ * (HMAC-SHA-256 keyed by `skillsmith-telemetry-actor:v1`) before transmission.
+ * The server stores that digest as `actor` — never the raw key, never an
+ * email, never a user ID.
+ *
+ * Event shape when emitted:
+ *   event_type: "telemetry:skill_install"
+ *   actor:      hmac_sha256("skillsmith-telemetry-actor:v1", apiKey) hex
+ *   metadata:   { skill_id, source, success, duration_ms?, trust_tier?, error_code? }
+ */
+export declare function emitInstallEvent(payload: InstallEventPayload): Promise<void>;
+//# sourceMappingURL=remote-audit.d.ts.map

package/dist/src/audit/remote-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-audit.d.ts","sourceRoot":"","sources":["../../../src/audit/remote-audit.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAA;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAyCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgClF"}