posthog-js-lite 2.1.0 → 2.2.1

package/lib/posthog-core/src/index.d.ts

@@ -1,44 +1,86 @@
-import { PostHogFetchOptions, PostHogFetchResponse, PostHogAutocaptureElement, PostHogDecideResponse, PosthogCoreOptions, PostHogEventProperties, PostHogPersistedProperty, JsonType } from './types';
+import { PostHogFetchOptions, PostHogFetchResponse, PostHogAutocaptureElement, PostHogDecideResponse, PosthogCoreOptions, PostHogEventProperties, PostHogPersistedProperty, PosthogCaptureOptions, JsonType } from './types';
 import { RetriableOptions } from './utils';
 export * as utils from './utils';
 import { LZString } from './lz-string';
 import { SimpleEventEmitter } from './eventemitter';
-export declare abstract class PostHogCore {
+export declare abstract class PostHogCoreStateless {
     private apiKey;
     host: string;
     private flushAt;
     private flushInterval;
     private requestTimeout;
     private captureMode;
-    private sendFeatureFlagEvent;
-    private flagCallReported;
     private removeDebugCallback?;
+    private _optoutOverride;
     protected _events: SimpleEventEmitter;
     protected _flushTimer?: any;
-    protected _decideResponsePromise?: Promise<PostHogDecideResponse>;
     protected _retryOptions: RetriableOptions;
-    protected _sessionExpirationTimeSeconds: number;
     abstract fetch(url: string, options: PostHogFetchOptions): Promise<PostHogFetchResponse>;
     abstract getLibraryId(): string;
     abstract getLibraryVersion(): string;
     abstract getCustomUserAgent(): string | void;
     abstract getPersistedProperty<T>(key: PostHogPersistedProperty): T | undefined;
     abstract setPersistedProperty<T>(key: PostHogPersistedProperty, value: T | null): void;
-    private _optoutOverride;
     constructor(apiKey: string, options?: PosthogCoreOptions);
     protected getCommonEventProperties(): any;
+    get optedOut(): boolean;
+    optIn(): void;
+    optOut(): void;
+    on(event: string, cb: (...args: any[]) => void): () => void;
+    debug(enabled?: boolean): void;
+    private buildPayload;
+    /***
+     *** TRACKING
+     ***/
+    protected identifyStateless(distinctId: string, properties?: PostHogEventProperties, options?: PosthogCaptureOptions): this;
+    protected captureStateless(distinctId: string, event: string, properties?: {
+        [key: string]: any;
+    }, options?: PosthogCaptureOptions): this;
+    protected aliasStateless(alias: string, distinctId: string, properties?: {
+        [key: string]: any;
+    }): this;
+    /***
+     *** GROUPS
+     ***/
+    protected groupIdentifyStateless(groupType: string, groupKey: string | number, groupProperties?: PostHogEventProperties, options?: PosthogCaptureOptions, distinctId?: string, eventProperties?: PostHogEventProperties): this;
+    /***
+     *** FEATURE FLAGS
+     ***/
+    protected getDecide(distinctId: string, groups?: Record<string, string | number>, personProperties?: Record<string, string>, groupProperties?: Record<string, Record<string, string>>, extraPayload?: Record<string, any>): Promise<PostHogDecideResponse | undefined>;
+    protected getFeatureFlagStateless(key: string, distinctId: string, groups?: Record<string, string>, personProperties?: Record<string, string>, groupProperties?: Record<string, Record<string, string>>): Promise<boolean | string | undefined>;
+    protected getFeatureFlagPayloadStateless(key: string, distinctId: string, groups?: Record<string, string>, personProperties?: Record<string, string>, groupProperties?: Record<string, Record<string, string>>): Promise<JsonType | undefined>;
+    protected getFeatureFlagPayloadsStateless(distinctId: string, groups?: Record<string, string>, personProperties?: Record<string, string>, groupProperties?: Record<string, Record<string, string>>): Promise<PostHogDecideResponse['featureFlagPayloads'] | undefined>;
+    protected _parsePayload(response: any): any;
+    protected getFeatureFlagsStateless(distinctId: string, groups?: Record<string, string | number>, personProperties?: Record<string, string>, groupProperties?: Record<string, Record<string, string>>): Promise<PostHogDecideResponse['featureFlags'] | undefined>;
+    protected getFeatureFlagsAndPayloadsStateless(distinctId: string, groups?: Record<string, string | number>, personProperties?: Record<string, string>, groupProperties?: Record<string, Record<string, string>>): Promise<{
+        flags: PostHogDecideResponse['featureFlags'] | undefined;
+        payloads: PostHogDecideResponse['featureFlagPayloads'] | undefined;
+    }>;
+    /***
+     *** QUEUEING AND FLUSHING
+     ***/
+    protected enqueue(type: string, _message: any, options?: PosthogCaptureOptions): void;
+    flushAsync(): Promise<any>;
+    flush(callback?: (err?: any, data?: any) => void): void;
+    private fetchWithRetry;
+    shutdownAsync(): Promise<void>;
+    shutdown(): void;
+}
+export declare abstract class PostHogCore extends PostHogCoreStateless {
+    private sendFeatureFlagEvent;
+    private flagCallReported;
+    protected _decideResponsePromise?: Promise<PostHogDecideResponse | undefined>;
+    protected _sessionExpirationTimeSeconds: number;
+    constructor(apiKey: string, options?: PosthogCoreOptions);
     protected setupBootstrap(options?: Partial<PosthogCoreOptions>): void;
     private get props();
     private set props(value);
     private clearProps;
     private _props;
-    get optedOut(): boolean;
-    optIn(): void;
-    optOut(): void;
     on(event: string, cb: (...args: any[]) => void): () => void;
     reset(propertiesToKeep?: PostHogPersistedProperty[]): void;
-    debug(enabled?: boolean): void;
-    private buildPayload;
+    protected getCommonEventProperties(): any;
+    private enrichProperties;
     getSessionId(): string | undefined;
     resetSessionId(): void;
     getAnonymousId(): string;
@@ -50,20 +92,20 @@ export declare abstract class PostHogCore {
     /***
      *** TRACKING
      ***/
-    identify(distinctId?: string, properties?: PostHogEventProperties): this;
+    identify(distinctId?: string, properties?: PostHogEventProperties, options?: PosthogCaptureOptions): this;
     capture(event: string, properties?: {
         [key: string]: any;
-    }, forceSendFeatureFlags?: boolean): this;
+    }, options?: PosthogCaptureOptions): this;
     alias(alias: string): this;
-    autocapture(eventType: string, elements: PostHogAutocaptureElement[], properties?: PostHogEventProperties): this;
+    autocapture(eventType: string, elements: PostHogAutocaptureElement[], properties?: PostHogEventProperties, options?: PosthogCaptureOptions): this;
     /***
      *** GROUPS
      ***/
     groups(groups: {
         [type: string]: string | number;
     }): this;
-    group(groupType: string, groupKey: string | number, groupProperties?: PostHogEventProperties): this;
-    groupIdentify(groupType: string, groupKey: string | number, groupProperties?: PostHogEventProperties): this;
+    group(groupType: string, groupKey: string | number, groupProperties?: PostHogEventProperties, options?: PosthogCaptureOptions): this;
+    groupIdentify(groupType: string, groupKey: string | number, groupProperties?: PostHogEventProperties, options?: PosthogCaptureOptions): this;
     /***
      * PROPERTIES
      ***/
@@ -83,29 +125,17 @@ export declare abstract class PostHogCore {
     getFeatureFlag(key: string): boolean | string | undefined;
     getFeatureFlagPayload(key: string): JsonType | undefined;
     getFeatureFlagPayloads(): PostHogDecideResponse['featureFlagPayloads'] | undefined;
-    _parsePayload(response: any): any;
     getFeatureFlags(): PostHogDecideResponse['featureFlags'] | undefined;
     getFeatureFlagsAndPayloads(): {
         flags: PostHogDecideResponse['featureFlags'] | undefined;
         payloads: PostHogDecideResponse['featureFlagPayloads'] | undefined;
     };
     isFeatureEnabled(key: string): boolean | undefined;
-    reloadFeatureFlagsAsync(sendAnonDistinctId?: boolean): Promise<PostHogDecideResponse['featureFlags']>;
+    reloadFeatureFlags(cb?: (err?: Error, flags?: PostHogDecideResponse['featureFlags']) => void): void;
+    reloadFeatureFlagsAsync(sendAnonDistinctId?: boolean): Promise<PostHogDecideResponse['featureFlags'] | undefined>;
     onFeatureFlags(cb: (flags: PostHogDecideResponse['featureFlags']) => void): () => void;
     onFeatureFlag(key: string, cb: (value: string | boolean) => void): () => void;
     overrideFeatureFlag(flags: PostHogDecideResponse['featureFlags'] | null): void;
-    _sendFeatureFlags(event: string, properties?: {
-        [key: string]: any;
-    }): void;
-    /***
-     *** QUEUEING AND FLUSHING
-     ***/
-    private enqueue;
-    flushAsync(): Promise<any>;
-    flush(callback?: (err?: any, data?: any) => void): void;
-    private fetchWithRetry;
-    shutdownAsync(): Promise<void>;
-    shutdown(): void;
 }
 export * from './types';
 export { LZString };

package/lib/posthog-core/src/types.d.ts

@@ -41,6 +41,9 @@ export declare type PostHogFetchOptions = {
     body?: string;
     signal?: AbortSignal;
 };
+export declare type PosthogCaptureOptions = {
+    timestamp?: Date;
+};
 export declare type PostHogFetchResponse = {
     status: number;
     text: () => Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posthog-js-lite",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "main": "lib/index.cjs.js",
   "module": "lib/index.esm.js",
   "types": "lib/index.d.ts",

package/lib/node_modules/tslib/tslib.es6.d.ts

@@ -1,35 +0,0 @@
-export function __extends(d: any, b: any): void;
-export function __rest(s: any, e: any): {};
-export function __decorate(decorators: any, target: any, key: any, desc: any, ...args: any[]): any;
-export function __param(paramIndex: any, decorator: any): (target: any, key: any) => void;
-export function __metadata(metadataKey: any, metadataValue: any): any;
-export function __awaiter(thisArg: any, _arguments: any, P: any, generator: any): any;
-export function __generator(thisArg: any, body: any): {
-    next: (v: any) => any;
-    throw: (v: any) => any;
-    return: (v: any) => any;
-};
-export function __exportStar(m: any, o: any): void;
-export function __values(o: any): any;
-export function __read(o: any, n: any): any;
-/** @deprecated */
-export function __spread(...args: any[]): any[];
-/** @deprecated */
-export function __spreadArrays(...args: any[]): any[];
-export function __spreadArray(to: any, from: any, pack: any, ...args: any[]): any;
-export function __await(v: any): __await;
-export class __await {
-    constructor(v: any);
-    v: any;
-}
-export function __asyncGenerator(thisArg: any, _arguments: any, generator: any): {};
-export function __asyncDelegator(o: any): {};
-export function __asyncValues(o: any): any;
-export function __makeTemplateObject(cooked: any, raw: any): any;
-export function __importStar(mod: any): any;
-export function __importDefault(mod: any): any;
-export function __classPrivateFieldGet(receiver: any, state: any, kind: any, f: any): any;
-export function __classPrivateFieldSet(receiver: any, state: any, value: any, kind: any, f: any): any;
-export function __classPrivateFieldIn(state: any, receiver: any): any;
-export function __assign(...args: any[]): any;
-export function __createBinding(o: any, m: any, k: any, k2: any): void;