truflag-react-sdk 0.1.4

package/README.md

@@ -0,0 +1,37 @@
+# React Truflag SDK
+
+```bash
+npm install truflag-react-sdk
+```
+
+```tsx
+import { useEffect } from 'react';
+import Flags, { useFlag, useFlagsReady } from 'truflag-react-sdk';
+
+export function App() {
+  useEffect(() => {
+    void Flags.configure({ apiKey: 'pk_live_xxx' });
+  }, []);
+
+  const ready = useFlagsReady();
+  const enabled = useFlag('new-checkout', false);
+
+  if (!ready) return <div>Loading...</div>;
+  return enabled ? <CheckoutV2 /> : <CheckoutV1 />;
+}
+```
+
+## Identity Updates
+
+```ts
+await Flags.login({
+  id: 'user-123',
+  attributes: { plan: 'pro' },
+});
+
+// Merges attributes for the current logged-in user.
+// Unspecified keys are preserved.
+await Flags.setAttributes({
+  country: 'US',
+});
+```

package/dist/client.d.ts

@@ -0,0 +1,71 @@
+import { TruflagUser, UserAttributes } from './internal/core.js';
+import { ConfigureOptions, ExposeOptions, FlagsInternalState, TrackOptions } from './types.js';
+export declare class ReactFlagsClient {
+    private readonly store;
+    private readonly sdkSource;
+    private pollTimer;
+    private telemetryTimer;
+    private config?;
+    private requestSequence;
+    private anonymousDeviceId;
+    private readonly attributesByUserId;
+    private offlineFallbackFlags;
+    private telemetryQueue;
+    private readonly exposureKeys;
+    private readonly assignmentKeys;
+    private readonly readEvaluationKeys;
+    private streamSocket;
+    private streamReconnectTimer;
+    private latestConfigVersion;
+    private configureSignature;
+    private configureInFlight;
+    subscribe: (callback: () => void) => () => void;
+    getState: () => FlagsInternalState;
+    configure(options: ConfigureOptions): Promise<void>;
+    private configureInternal;
+    login(user: TruflagUser): Promise<void>;
+    setAttributes(attributes: UserAttributes): Promise<void>;
+    identify(user: TruflagUser): Promise<void>;
+    logout(): Promise<void>;
+    refresh(): Promise<void>;
+    track(eventName: string, properties?: Record<string, unknown>, options?: TrackOptions): Promise<void>;
+    expose(flagKey: string, options?: ExposeOptions): Promise<void>;
+    notifyFlagRead(flagKey: string): void;
+    getFlag(key: string, defaultValue?: boolean): boolean;
+    getFeatureFlagValue<T>(key: string, defaultValue: T): T;
+    getFeatureFlagPayload(key: string): Record<string, unknown> | null;
+    getAllFlags(): Record<string, unknown>;
+    isReady(): boolean;
+    private getStorage;
+    private getUser;
+    private getTransport;
+    private getFlagOrThrow;
+    private enqueueTelemetryEvent;
+    private buildConfigureSignature;
+    private requireConfigured;
+    private resolveAnonymousUser;
+    private ensureAnonymousDeviceId;
+    private loadCachedUser;
+    private persistCachedUser;
+    private loadPersistedAssignmentKeys;
+    private persistAssignmentKeys;
+    private normalizeUser;
+    private normalizeAttributes;
+    private mergeUser;
+    private startPolling;
+    private stopPolling;
+    private startStreamOrPolling;
+    private startStreaming;
+    private stopStreaming;
+    private scheduleStreamReconnect;
+    private handleStreamMessage;
+    private resolveStreamUrl;
+    private startTelemetryFlush;
+    private flushTelemetry;
+    private enqueueReadEvaluationEvents;
+    private enqueueAssignmentEvents;
+    private enqueueExposure;
+    private clearError;
+    private extractOfflineFallbackFlags;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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