@skillsmith/core 0.5.6 → 0.5.8

package/dist/telemetry/metrics.js.map

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

package/dist/telemetry/posthog.d.ts

@@ -1,147 +0,0 @@
-/**
- * SMI-1246: PostHog Telemetry Integration
- *
- * Provides product analytics and event tracking via PostHog:
- * - Skill searches and views
- * - Installation events
- * - User engagement metrics
- * - Feature usage tracking
- *
- * Privacy-first: All user IDs are anonymized, no PII collected.
- */
-import { PostHog } from 'posthog-node';
-/**
- * PostHog configuration options
- */
-export interface PostHogConfig {
-    /** PostHog API key (starts with phc_) */
-    apiKey: string;
-    /** PostHog host URL (default: https://app.posthog.com) */
-    host?: string;
-    /** Flush interval in milliseconds (default: 10000) */
-    flushInterval?: number;
-    /** Enable debug logging (default: false) */
-    debug?: boolean;
-    /** Disable telemetry entirely (default: false) */
-    disabled?: boolean;
-}
-/**
- * Event types for Skillsmith analytics
- */
-export type SkillsmithEventType = 'skill_search' | 'skill_view' | 'skill_install' | 'skill_uninstall' | 'skill_compare' | 'skill_recommend' | 'api_error' | 'feature_flag_evaluated';
-/**
- * Event properties for skill-related events
- */
-export interface SkillEventProperties {
-    /** Skill ID (author/name format) */
-    skill_id?: string;
-    /** Search query */
-    query?: string;
-    /** Number of results returned */
-    result_count?: number;
-    /** Trust tier filter applied */
-    trust_tier?: string;
-    /** Category filter applied */
-    category?: string;
-    /** Response time in milliseconds */
-    duration_ms?: number;
-    /** Error code if applicable */
-    error_code?: string;
-    /** Source of the event (cli, mcp, api) */
-    source?: 'cli' | 'mcp' | 'api';
-    /** Additional custom properties */
-    [key: string]: unknown;
-}
-/**
- * Initialize PostHog client
- * Call this at application startup
- *
- * @param config - PostHog configuration
- */
-export declare function initializePostHog(config: PostHogConfig): void;
-/**
- * Get the PostHog client instance
- * Returns null if not initialized or disabled
- */
-export declare function getPostHog(): PostHog | null;
-/**
- * Check if PostHog is enabled and initialized
- */
-export declare function isPostHogEnabled(): boolean;
-/**
- * Track an event with PostHog
- * Silently no-ops if PostHog is disabled or not initialized
- *
- * @param distinctId - Anonymous user identifier
- * @param event - Event name
- * @param properties - Event properties
- */
-export declare function trackEvent(distinctId: string, event: SkillsmithEventType | string, properties?: SkillEventProperties): void;
-/**
- * Allowed trait keys for user identification.
- * Only non-PII properties are permitted to prevent data leakage.
- */
-export declare const ALLOWED_TRAITS: readonly ["tier", "version", "platform", "sdk_version"];
-/**
- * Type for allowed user traits - restricted to prevent PII leakage.
- * Only safe, non-identifying properties are permitted.
- */
-export type AllowedUserTraits = {
-    /** User tier (e.g., 'free', 'pro', 'enterprise') */
-    tier?: string;
-    /** Application version */
-    version?: string;
-    /** Platform identifier (e.g., 'darwin', 'linux', 'win32') */
-    platform?: string;
-    /** SDK version used */
-    sdk_version?: string;
-};
-/**
- * Identify a user with restricted traits.
- *
- * @warning DO NOT pass PII (email, name, IP, etc.) to this function.
- * Only the following safe traits are allowed: tier, version, platform, sdk_version.
- * Any other properties will be silently filtered out to prevent data leakage.
- *
- * @param distinctId - Anonymous user identifier (should be a hash, not an email)
- * @param traits - User properties (restricted to AllowedUserTraits)
- */
-export declare function identifyUser(distinctId: string, traits: AllowedUserTraits): void;
-/**
- * Check if a feature flag is enabled for a user
- *
- * @param distinctId - Anonymous user identifier
- * @param flagKey - Feature flag key
- * @returns true if enabled, false otherwise
- */
-export declare function isFeatureFlagEnabled(distinctId: string, flagKey: string): Promise<boolean>;
-/**
- * Flush all pending events immediately
- * Call this before application shutdown
- */
-export declare function flushPostHog(): Promise<void>;
-/**
- * Shutdown PostHog client
- * Call this at application shutdown
- */
-export declare function shutdownPostHog(): Promise<void>;
-/**
- * Convenience function to track skill search events
- */
-export declare function trackSkillSearch(distinctId: string, query: string, resultCount: number, durationMs: number, filters?: {
-    trustTier?: string;
-    category?: string;
-}): void;
-/**
- * Convenience function to track skill view events
- */
-export declare function trackSkillView(distinctId: string, skillId: string, source: 'cli' | 'mcp' | 'api'): void;
-/**
- * Convenience function to track skill install events
- */
-export declare function trackSkillInstall(distinctId: string, skillId: string, source: 'cli' | 'mcp' | 'api'): void;
-/**
- * Convenience function to track API errors
- */
-export declare function trackApiError(distinctId: string, errorCode: string, endpoint: string, durationMs?: number): void;
-//# sourceMappingURL=posthog.d.ts.map

package/dist/telemetry/posthog.d.ts.map

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

package/dist/telemetry/posthog.js

@@ -1,213 +0,0 @@
-/**
- * SMI-1246: PostHog Telemetry Integration
- *
- * Provides product analytics and event tracking via PostHog:
- * - Skill searches and views
- * - Installation events
- * - User engagement metrics
- * - Feature usage tracking
- *
- * Privacy-first: All user IDs are anonymized, no PII collected.
- */
-import { PostHog } from 'posthog-node';
-// Singleton instance
-let posthogInstance = null;
-let isDisabled = false;
-/**
- * Initialize PostHog client
- * Call this at application startup
- *
- * @param config - PostHog configuration
- */
-export function initializePostHog(config) {
-    if (config.disabled) {
-        isDisabled = true;
-        return;
-    }
-    if (!config.apiKey) {
-        console.warn('[PostHog] No API key provided, telemetry disabled');
-        isDisabled = true;
-        return;
-    }
-    posthogInstance = new PostHog(config.apiKey, {
-        host: config.host || 'https://app.posthog.com',
-        flushInterval: config.flushInterval || 10000,
-    });
-    if (config.debug) {
-        posthogInstance.debug();
-    }
-}
-/**
- * Get the PostHog client instance
- * Returns null if not initialized or disabled
- */
-export function getPostHog() {
-    return posthogInstance;
-}
-/**
- * Check if PostHog is enabled and initialized
- */
-export function isPostHogEnabled() {
-    return !isDisabled && posthogInstance !== null;
-}
-/**
- * Track an event with PostHog
- * Silently no-ops if PostHog is disabled or not initialized
- *
- * @param distinctId - Anonymous user identifier
- * @param event - Event name
- * @param properties - Event properties
- */
-export function trackEvent(distinctId, event, properties) {
-    if (!isPostHogEnabled() || !posthogInstance) {
-        return;
-    }
-    try {
-        posthogInstance.capture({
-            distinctId,
-            event,
-            properties: {
-                ...properties,
-                $lib: 'skillsmith',
-                $lib_version: process.env.npm_package_version || 'unknown',
-            },
-        });
-    }
-    catch (error) {
-        // Silently fail - telemetry should never break the app
-        console.debug('[PostHog] Failed to track event:', error);
-    }
-}
-/**
- * Allowed trait keys for user identification.
- * Only non-PII properties are permitted to prevent data leakage.
- */
-export const ALLOWED_TRAITS = ['tier', 'version', 'platform', 'sdk_version'];
-/**
- * Identify a user with restricted traits.
- *
- * @warning DO NOT pass PII (email, name, IP, etc.) to this function.
- * Only the following safe traits are allowed: tier, version, platform, sdk_version.
- * Any other properties will be silently filtered out to prevent data leakage.
- *
- * @param distinctId - Anonymous user identifier (should be a hash, not an email)
- * @param traits - User properties (restricted to AllowedUserTraits)
- */
-export function identifyUser(distinctId, traits) {
-    if (!isPostHogEnabled() || !posthogInstance) {
-        return;
-    }
-    // Filter traits to only include allowed keys (defense in depth)
-    const safeTraits = {};
-    for (const key of ALLOWED_TRAITS) {
-        if (traits[key] !== undefined) {
-            safeTraits[key] = traits[key];
-        }
-    }
-    try {
-        posthogInstance.identify({
-            distinctId,
-            properties: safeTraits,
-        });
-    }
-    catch (error) {
-        console.debug('[PostHog] Failed to identify user:', error);
-    }
-}
-/**
- * Check if a feature flag is enabled for a user
- *
- * @param distinctId - Anonymous user identifier
- * @param flagKey - Feature flag key
- * @returns true if enabled, false otherwise
- */
-export async function isFeatureFlagEnabled(distinctId, flagKey) {
-    if (!isPostHogEnabled() || !posthogInstance) {
-        return false;
-    }
-    try {
-        const result = await posthogInstance.isFeatureEnabled(flagKey, distinctId);
-        trackEvent(distinctId, 'feature_flag_evaluated', {
-            flag_key: flagKey,
-            flag_value: result,
-        });
-        return result ?? false;
-    }
-    catch (error) {
-        console.debug('[PostHog] Failed to check feature flag:', error);
-        return false;
-    }
-}
-/**
- * Flush all pending events immediately
- * Call this before application shutdown
- */
-export async function flushPostHog() {
-    if (!posthogInstance) {
-        return;
-    }
-    try {
-        await posthogInstance.flush();
-    }
-    catch (error) {
-        console.debug('[PostHog] Failed to flush events:', error);
-    }
-}
-/**
- * Shutdown PostHog client
- * Call this at application shutdown
- */
-export async function shutdownPostHog() {
-    if (!posthogInstance) {
-        return;
-    }
-    try {
-        await posthogInstance.shutdown();
-        posthogInstance = null;
-        isDisabled = false;
-    }
-    catch (error) {
-        console.debug('[PostHog] Failed to shutdown:', error);
-    }
-}
-/**
- * Convenience function to track skill search events
- */
-export function trackSkillSearch(distinctId, query, resultCount, durationMs, filters) {
-    trackEvent(distinctId, 'skill_search', {
-        query,
-        result_count: resultCount,
-        duration_ms: durationMs,
-        trust_tier: filters?.trustTier,
-        category: filters?.category,
-    });
-}
-/**
- * Convenience function to track skill view events
- */
-export function trackSkillView(distinctId, skillId, source) {
-    trackEvent(distinctId, 'skill_view', {
-        skill_id: skillId,
-        source,
-    });
-}
-/**
- * Convenience function to track skill install events
- */
-export function trackSkillInstall(distinctId, skillId, source) {
-    trackEvent(distinctId, 'skill_install', {
-        skill_id: skillId,
-        source,
-    });
-}
-/**
- * Convenience function to track API errors
- */
-export function trackApiError(distinctId, errorCode, endpoint, durationMs) {
-    trackEvent(distinctId, 'api_error', {
-        error_code: errorCode,
-        endpoint,
-        duration_ms: durationMs,
-    });
-}
-//# sourceMappingURL=posthog.js.map

package/dist/telemetry/posthog.js.map

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

package/dist/telemetry/prometheus.d.ts

@@ -1,81 +0,0 @@
-/**
- * SMI-1018: Prometheus Metrics Exporter
- *
- * Exports Skillsmith metrics in Prometheus text exposition format.
- * Integrates with existing MetricsRegistry for monitoring dashboards.
- *
- * @see https://prometheus.io/docs/instrumenting/exposition_formats/
- */
-import type { MetricsSnapshot } from './metrics.js';
-/**
- * Prometheus export options
- */
-export interface PrometheusExportOptions {
-    /** Include TYPE and HELP comments (default: true) */
-    includeMetadata?: boolean;
-    /** Prefix for all metric names (default: none) */
-    prefix?: string;
-    /** Custom labels to add to all metrics */
-    globalLabels?: Record<string, string>;
-    /** Timestamp for all metrics (epoch ms, default: current time) */
-    timestamp?: number;
-}
-/**
- * Export metrics snapshot to Prometheus text format
- *
- * @param snapshot - Metrics snapshot from MetricsRegistry.getSnapshot()
- * @param options - Export options
- * @returns Prometheus text exposition format string
- *
- * @example
- * ```typescript
- * const metrics = getMetrics()
- * const snapshot = metrics.getSnapshot()
- * const prometheusText = exportToPrometheus(snapshot)
- * // Returns:
- * // # HELP skillsmith_mcp_request_total Total number of MCP tool requests
- * // # TYPE skillsmith_mcp_request_total counter
- * // skillsmith_mcp_request_total 42
- * ```
- */
-export declare function exportToPrometheus(snapshot: MetricsSnapshot, options?: PrometheusExportOptions): string;
-/**
- * Get current metrics in Prometheus format
- * Convenience function that combines getSnapshot() and exportToPrometheus()
- *
- * @param options - Export options
- * @returns Prometheus text exposition format string
- *
- * @example
- * ```typescript
- * // In an HTTP handler:
- * app.get('/metrics', (req, res) => {
- *   res.set('Content-Type', 'text/plain; version=0.0.4')
- *   res.send(getPrometheusMetrics())
- * })
- * ```
- */
-export declare function getPrometheusMetrics(options?: PrometheusExportOptions): string;
-/**
- * Prometheus HTTP endpoint handler
- *
- * Creates a handler function suitable for Express/Koa/etc.
- *
- * @param options - Export options
- * @returns Handler function (req, res) => void
- *
- * @example
- * ```typescript
- * // Express
- * import express from 'express'
- * import { createPrometheusHandler } from '@skillsmith/core'
- *
- * const app = express()
- * app.get('/metrics', createPrometheusHandler())
- * ```
- */
-export declare function createPrometheusHandler(options?: PrometheusExportOptions): (req: unknown, res: {
-    set: (k: string, v: string) => void;
-    send: (body: string) => void;
-}) => void;
-//# sourceMappingURL=prometheus.d.ts.map

package/dist/telemetry/prometheus.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prometheus.d.ts","sourceRoot":"","sources":["../../src/telemetry/prometheus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAiBnD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAoID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAgER;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAIlF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,uBAA4B,GACpC,CACD,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KACvE,IAAI,CAKR"}