zubbl-sdk 1.1.15 → 1.1.18

package/dist/types/client.d.ts

@@ -0,0 +1,28 @@
+export type ZubblConfig = {
+    apiKey: string;
+    tenantId: string;
+    appId: string;
+    baseUrl?: string;
+    injectWorkerHeaders?: boolean;
+    workerSecret?: string | null;
+};
+export declare function createZubblClient(cfg: ZubblConfig): {
+    init: () => Promise<void>;
+    identifyUser: ({ email, name }: {
+        email: string;
+        name?: string;
+    }) => Promise<any>;
+    getTiles: ({ external_user_id, app_id }: {
+        external_user_id: string;
+        app_id?: string | null;
+    }) => Promise<any>;
+    enforce: ({ external_user_id, app_id }: {
+        external_user_id: string;
+        app_id?: string | null;
+    }) => Promise<{
+        decision: string;
+        status: number;
+        data: any;
+    }>;
+    storage: import("./core/storage.js").IStorage;
+};

package/dist/types/core/config.d.ts

@@ -0,0 +1,14 @@
+export declare const isBrowser: boolean;
+export declare const isNode: boolean;
+export declare const isWorker: boolean;
+export interface ZubblConfig {
+    apiKey: string | null;
+    tenantId: string | null;
+    appId: string | null;
+    baseUrl: string;
+    injectWorkerHeaders?: boolean;
+    workerSecret?: string | null;
+}
+export declare function init(partial: Partial<ZubblConfig>): void;
+export declare function getConfig(): Readonly<ZubblConfig>;
+export declare function buildHeaders(extra?: Record<string, string>): Record<string, string>;

package/dist/types/core/context.d.ts

@@ -0,0 +1,4 @@
+export declare function detectGeo(): string;
+export declare function updateGeo(geoHint?: string): void;
+export declare function recordContextSample(path: string, method: string, status: number, latency: number): void;
+export declare function getAdaptiveHeaders(): Record<string, string>;

package/dist/types/core/geo.d.ts

@@ -0,0 +1,13 @@
+export interface GeoPrivacy {
+    vpn: boolean;
+    hosting: boolean;
+}
+export interface GeoInfo {
+    ip: string | null;
+    country: string;
+    asn: string | null;
+    privacy: GeoPrivacy;
+}
+export declare function getGeoInfo(): Promise<GeoInfo>;
+export declare function clearGeoCache(): void;
+export declare function getGeoHeaders(): Promise<Record<string, string>>;

package/dist/types/core/http.d.ts

@@ -0,0 +1,4 @@
+export interface HttpOptions extends RequestInit {
+    timeoutMs?: number;
+}
+export declare function httpRequest(url: string, options?: HttpOptions): Promise<Response | null>;

package/dist/types/core/signing.d.ts

@@ -0,0 +1,3 @@
+export declare function generateNonce(): string;
+export declare function signPayload(payload: string, secret: string): Promise<string>;
+export declare function attachSigningHeaders(method: string, url: string, body: string | null, secretKey?: string | null): Promise<Record<string, string>>;

package/dist/types/core/storage.d.ts

@@ -0,0 +1,6 @@
+export interface IStorage {
+    get<T>(key: string): T | null;
+    set<T>(key: string, value: T, ttlSeconds?: number): void;
+    remove(key: string): void;
+}
+export declare function createStorage(): IStorage;

package/dist/types/core/telemetry.d.ts

@@ -0,0 +1,4 @@
+export declare function setSamplingRatio(ratio: number): void;
+export declare function emitEndpoint(payload: Record<string, any>): void;
+export declare function recordRequestTelemetry(url: string, method: string, status: number, latency: number, extra?: Record<string, any>): Promise<void>;
+export declare function logRuntimeDiscovery(url: string): void;

package/dist/types/features/getTiles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Fetch effective tiles with caching, ETag and background refresh.
+ */
+export declare function getTiles({ external_user_id, app_id, ttlSeconds, }: {
+    external_user_id: string;
+    app_id?: string | null;
+    ttlSeconds?: number;
+}): Promise<{
+    data: any;
+    fromCache: boolean;
+    status?: undefined;
+    error?: undefined;
+} | {
+    data: any;
+    fromCache: boolean;
+    status: number;
+    error?: undefined;
+} | {
+    data: any;
+    fromCache: boolean;
+    error: string;
+    status?: undefined;
+}>;

package/dist/types/features/identifyUser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Identify or auto-create a user by email/name.
+ * Idempotent: returns cached UUID if available.
+ */
+export declare function identifyUser({ email, name }: {
+    email: string;
+    name?: string;
+}): Promise<{
+    external_user_id: any;
+    cached: boolean;
+}>;

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+import { createZubblClient, ZubblConfig } from "./client.js";
+export declare function init(config: ZubblConfig): Promise<void>;
+export declare function identifyUser(...args: Parameters<ReturnType<typeof createZubblClient>["identifyUser"]>): Promise<any>;
+export declare function getTiles(...args: Parameters<ReturnType<typeof createZubblClient>["getTiles"]>): Promise<any>;
+export declare function enforce(...args: Parameters<ReturnType<typeof createZubblClient>["enforce"]>): Promise<{
+    decision: string;
+    status: number;
+    data: any;
+}>;
+export { createZubblClient };