@pixels-online/pixels-client-js-sdk 1.0.2

package/dist/core/CustomEventSource.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Custom EventSource implementation that supports headers
+ * This is needed because the native EventSource API doesn't support custom headers
+ */
+export declare enum ReadyState {
+    CONNECTING = 0,
+    OPEN = 1,
+    CLOSED = 2
+}
+export interface CustomEventSourceInit {
+    headers?: Record<string, string>;
+}
+export declare class CustomEventSource {
+    private url;
+    private headers;
+    private readyState;
+    private eventListeners;
+    onopen: ((event: Event) => void) | null;
+    onerror: ((event: Event) => void) | null;
+    onmessage: ((event: MessageEvent) => void) | null;
+    private reader;
+    private decoder;
+    private eventBuffer;
+    private abortController;
+    private lastEventId;
+    private reconnectTime;
+    onRetryUpdate: ((time: number) => void) | null;
+    constructor(url: string, init?: CustomEventSourceInit);
+    private connect;
+    private readStream;
+    private processBuffer;
+    private dispatchEvent;
+    private handleError;
+    addEventListener(type: string, listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: string, listener: (event: MessageEvent) => void): void;
+    close(): void;
+    get CONNECTING(): number;
+    get OPEN(): number;
+    get CLOSED(): number;
+    getReadyState(): ReadyState;
+    getReconnectTime(): number;
+}

package/dist/core/OfferStore.d.ts

@@ -0,0 +1,55 @@
+import { OfferwallConfig } from '../types';
+import { IClientOffer, PlayerOfferStatus } from '../types/offer';
+import { IClientPlayerSnapshot } from '../types/player';
+export declare class OfferStore {
+    private offers;
+    private playerSnapshot;
+    private logger;
+    constructor(config: OfferwallConfig);
+    getSnapshot(): IClientPlayerSnapshot | null;
+    setSnapshot(snapshot: IClientPlayerSnapshot): void;
+    /**
+     * Set all offers (replaces existing)
+     */
+    setOffers(offers: IClientOffer[]): void;
+    /**
+     * Add or update a single offer
+     */
+    upsertOffer(offer: IClientOffer): IClientOffer | undefined;
+    /**
+     * Remove an offer
+     */
+    removeOffer(offerId: string): boolean;
+    /**
+     * Get a single offer
+     */
+    getOffer(offerId: string): IClientOffer | undefined;
+    /**
+     * Get all offers
+     */
+    getAllOffers(): IClientOffer[];
+    /**
+     * Get offers filtered by status
+     */
+    getOffersByStatus(status: PlayerOfferStatus): IClientOffer[];
+    /**
+     * Get active offers (not expired, not claimed)
+     */
+    getActiveOffers(): IClientOffer[];
+    /**
+     * Get claimable offers
+     */
+    getClaimableOffers(): IClientOffer[];
+    /**
+     * Check if an offer has expired
+     */
+    isOfferExpired(offerId: string): boolean;
+    /**
+     * Clear all offers
+     */
+    clear(): void;
+    /**
+     * Get offer count
+     */
+    get size(): number;
+}

package/dist/core/OfferwallClient.d.ts

@@ -0,0 +1,63 @@
+import { EventEmitter } from '../events/EventEmitter';
+import { OfferStore } from './OfferStore';
+import { AssetHelper } from '../utils/assets';
+import { OfferwallConfig } from '../types';
+import { ConnectionState } from '../types/connection';
+export declare class OfferwallClient {
+    private config;
+    private eventEmitter;
+    private sseConnection;
+    private offerStore;
+    private tokenManager;
+    private assetHelper;
+    private hooks;
+    private logger;
+    private isInitializing;
+    constructor(config: OfferwallConfig);
+    /**
+     * Get the offer store instance
+     */
+    get store(): OfferStore;
+    /**
+     * Get the event emitter instance for event handling
+     */
+    get events(): EventEmitter;
+    /**
+     * Get asset helper for resolving offer/reward content
+     */
+    get assets(): AssetHelper;
+    /**
+     * Initialize the offerwall client and connect
+     */
+    initialize(): Promise<void>;
+    /**
+     * Connect to the offerwall SSE endpoint
+     */
+    private connect;
+    /**
+     * Disconnect from the offerwall
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Claim rewards for an offer
+     */
+    claimReward(instanceId: string): Promise<void>;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get current connection state
+     */
+    getConnectionState(): ConnectionState;
+    private setupInternalListeners;
+    /**
+     * Helper to POST to an endpoint with JWT and handle token expiry/retry logic
+     */
+    private postWithAuth;
+    private claimOfferAPI;
+    refreshOffersAndSnapshot(): Promise<void>;
+    private getOffersAndSnapshot;
+    getAuthLinkToken(): Promise<string>;
+    private handleError;
+}

package/dist/core/SSEConnection.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from '../events/EventEmitter';
+import { OfferwallConfig } from '../types';
+import { ConnectionState } from '../types/connection';
+import { TokenManager } from './TokenManager';
+export declare class SSEConnection {
+    private config;
+    private eventEmitter;
+    private tokenManager;
+    private eventSource;
+    private reconnectAttempts;
+    private reconnectTimeout;
+    private isConnecting;
+    private connectionState;
+    private logger;
+    private serverSuggestedRetryTime;
+    constructor(config: OfferwallConfig, eventEmitter: EventEmitter, tokenManager: TokenManager);
+    /**
+     * Get current connection state
+     */
+    getConnectionState(): ConnectionState;
+    /**
+     * Set connection state and emit change event
+     */
+    private setConnectionState;
+    connect(): Promise<void>;
+    private handleMessage;
+    private handleReconnect;
+    disconnect(): void;
+    isConnected(): boolean;
+}

package/dist/core/TokenManager.d.ts

@@ -0,0 +1,33 @@
+import { OfferwallConfig } from "../types";
+type JWTPayload = {
+    sub: string;
+    iss: string;
+    exp: number;
+    iat: number;
+};
+/**
+ * Manages JWT tokens for the offerwall client
+ * Handles token storage, validation, and refresh logic
+ */
+export declare class TokenManager {
+    private config;
+    private currentToken;
+    private logger;
+    constructor(config: OfferwallConfig);
+    /**
+     * Get the current stored token
+     */
+    getCurrentToken(): string | null;
+    /**
+     * Clear the stored token
+     */
+    clearToken(): void;
+    /**
+     * Get current token or fetch a new one if needed
+     */
+    getTokenForConnection(): Promise<string>;
+    private fetchToken;
+    private validateToken;
+    parseJWT(token: string): JWTPayload;
+}
+export {};

package/dist/events/EventEmitter.d.ts

@@ -0,0 +1,13 @@
+import { OfferwallConfig } from '../types';
+import { OfferEvent, OfferEventMap, OfferEventHandler } from '../types/events';
+export declare class EventEmitter {
+    private events;
+    private logger;
+    constructor(config: OfferwallConfig);
+    on<T extends OfferEvent>(event: T, handler: OfferEventHandler<T>): void;
+    off<T extends OfferEvent>(event: T, handler: OfferEventHandler<T>): void;
+    emit<T extends OfferEvent>(event: T, data: OfferEventMap[T]): void;
+    once<T extends OfferEvent>(event: T, handler: OfferEventHandler<T>): void;
+    removeAllListeners(event?: OfferEvent): void;
+    listenerCount(event: OfferEvent): number;
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { OfferwallClient } from './core/OfferwallClient';
+export { EventEmitter } from './events/EventEmitter';
+export { SSEConnection } from './core/SSEConnection';
+export { OfferStore } from './core/OfferStore';
+export { AssetHelper } from './utils/assets';
+export * from './utils/conditions';
+export * from './types';
+export * from './types/offer';
+export * from './types/reward';
+export * from './types/events';
+export * from './types/hooks';
+export * from './types/player';