@keak/sdk 1.0.9 → 2.0.0

package/dist/index.d.ts

@@ -11,8 +11,9 @@ export type ExperimentProps = {
     active?: boolean;
 };
 export interface KeakConfig {
-    apiKey: string;
-    apiUrl?: string;
+    projectRoot?: string;
+    editor?: 'vscode' | 'cursor' | 'webstorm' | 'intellij' | 'atom' | 'sublime' | 'windsurf';
+    showToolbar?: boolean;
     userId?: string;
     sessionId?: string;
     debug?: boolean;
@@ -56,30 +57,62 @@ export interface ConversionSnapshot {
     visitorMetadata: VisitorMetadata;
     additionalData: Record<string, any>;
 }
-export declare function KeakProvider({ config, children, showToolbar, // Changed to false - users should add <KeakToolbar /> manually
-toolbarConfig }: {
-    config?: Partial<KeakConfig>;
-    children: ReactNode;
-    showToolbar?: boolean;
-    toolbarConfig?: {
-        position?: 'top-center' | 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
-        theme?: 'light' | 'dark' | 'auto';
-    };
-}): import("react/jsx-runtime").JSX.Element;
-export declare function useKeak(): {
-    config?: KeakConfig;
+declare class KeakSDK {
+    config: KeakConfig;
     assignments: Record<string, string>;
-    trackEvent: (eventName: string, properties?: EventProperties) => void;
-};
-export declare function useExperiment(experimentKey: string): {
-    variant: string;
-    track: (eventName: string, properties?: EventProperties) => void;
-    isInExperiment: boolean;
-};
+    private eventQueue;
+    private initialized;
+    private userId;
+    private sessionId;
+    private deviceId;
+    private liveExperiments;
+    private impressions;
+    constructor(config: KeakConfig);
+    init(): Promise<void>;
+    getVariant(experimentKey: string, availableVariants?: string[]): string;
+    trackEvent(eventName: string, properties?: EventProperties): void;
+    trackClick(elementId: string, text?: string): void;
+    trackConversion(conversionName: string, value?: number, additionalData?: Record<string, any>): void;
+    private takeVariantSnapshot;
+    private storeConversionLocally;
+    private setupAutoTracking;
+    private flushEvents;
+    private generateUserId;
+    private generateSessionId;
+    private generateDeviceId;
+    private captureVisitorMetadata;
+    private simpleHash;
+    private assignVariant;
+    private loadImpressions;
+    private saveImpressions;
+    trackImpression(experimentId: string, variantName: string): void;
+    private storeImpressionWithMetadata;
+    getImpressions(experimentId: string): Record<string, number>;
+    getAllImpressions(): Record<string, Record<string, number>>;
+    registerLiveExperiment(experimentData: any): void;
+    getAllLiveExperiments(): any[];
+    setExperimentVariant(experimentId: string, variant: string): void;
+}
+/**
+ * Main Keak hook - initializes the SDK with minimal configuration
+ * Similar to react-source-lens's useReactSourceLens() hook
+ *
+ * @example
+ * // Minimal usage (no config needed)
+ * useKeak();
+ *
+ * @example
+ * // With IDE integration
+ * useKeak({
+ *   projectRoot: '/absolute/path/to/project',
+ *   editor: 'vscode'
+ * });
+ */
+export declare function useKeak(config?: KeakConfig): KeakSDK | null;
 export declare const Variant: ({ children }: VariantProps) => import("react/jsx-runtime").JSX.Element;
 export declare const Experiment: ({ name, children, active }: ExperimentProps) => import("react/jsx-runtime").JSX.Element | null;
 export declare const keak: {
-    init: (config: KeakConfig) => Promise<void>;
+    init: (config?: KeakConfig) => Promise<void>;
     getVariant: (experimentKey: string, availableVariants?: string[]) => string;
     track: (eventName: string, properties?: EventProperties) => void;
     trackClick: (elementId: string, text?: string) => void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,cAAc,CAAC;AACtB,OAAO,0BAA0B,CAAC;AAClC,OAAc,EAGZ,SAAS,EAGV,MAAM,OAAO,CAAC;AAGf,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IACzF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAMD,cAAM,OAAO;IACJ,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAChD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,WAAW,CAA+C;gBAEtD,MAAM,EAAE,UAAU;IAQxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAWvE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,eAAoB,GAAG,IAAI;IAOrE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAOlD,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAanG,OAAO,CAAC,mBAAmB;IAwC3B,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,sBAAsB;IA0D9B,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,eAAe;IAcvB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAehE,OAAO,CAAC,2BAA2B;IA8BnC,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAK5D,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAS3D,sBAAsB,CAAC,cAAc,EAAE,GAAG,GAAG,IAAI;IAiBjD,qBAAqB,IAAI,GAAG,EAAE;IAK9B,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAoBlE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,MAAM,GAAE,UAAe,kBAwJ9C;AAGD,eAAO,MAAM,OAAO,GAAI,cAAc,YAAY,4CAEjD,CAAC;AAwDF,eAAO,MAAM,UAAU,GAAI,4BAAmC,eAAe,mDAkM5E,CAAC;AAGF,eAAO,MAAM,IAAI;oBACA,UAAU;gCAaG,MAAM,sBAAsB,MAAM,EAAE;uBAQ7C,MAAM,eAAe,eAAe;4BAO/B,MAAM,SAAS,MAAM;sCAOX,MAAM,UAAU,MAAM,mBAAmB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;yCAiBzD,MAAM,WAAW,MAAM;oCAK5B,MAAM,eAAe,MAAM;mCAI5B,MAAM;;CAetC,CAAC;AAGF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE;IACzC,QAAQ,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,CAAC;IACpF,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACnC,QA4CA;AAED,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC"}