@pixels-online/pixels-client-js-sdk 1.15.0 → 1.16.0

package/dist/core/OfferwallClient.d.ts

@@ -5,6 +5,7 @@ import { OfferwallConfig } from '../types/index';
 import { IClientOffer } from '../types/offer';
 import { ConnectionState } from '../types/connection';
 import { IClientPlayer } from '../types/player';
+import { StackedLinkResult } from '../types/linking';
 export declare const mapEnvToOfferClientUrl: (env: "test" | "live" | (string & {})) => "https://offers.pixels.xyz" | "https://offers.sandbox.pixels.xyz" | "https://offers.staging.pixels.xyz" | "https://offers.preview.pixels.xyz" | "https://offers.dev.pixels.xyz";
 export declare class OfferwallClient {
     private config;
@@ -17,7 +18,9 @@ export declare class OfferwallClient {
     private hooks;
     private logger;
     private isInitializing;
+    private pendingStackedToken;
     constructor(config: OfferwallConfig);
+    private setupStackedLinkDetection;
     /**
      * Get the offer store instance
      */
@@ -67,5 +70,30 @@ export declare class OfferwallClient {
     getAuthLinkToken(): Promise<string>;
     getGameId(): string | null;
     getDashboardRedirectUrl(): Promise<string | null>;
+    /**
+     * Detect if there's a Stacked link token in the current URL
+     * @returns The token string if found, null otherwise
+     */
+    detectStackedLinkToken(): string | null;
+    /**
+     * Clear the stackedToken from the URL without page reload
+     */
+    private clearStackedTokenFromUrl;
+    /**
+     * Consume a Stacked link token to link the current game player
+     * to a Stacked unified user account.
+     *
+     * IMPORTANT: The player must be authenticated (have a valid JWT from tokenProvider)
+     * before calling this method.
+     *
+     * @param token The Stacked link token from the URL
+     * @returns Promise resolving to the link result
+     */
+    consumeStackedLinkToken(token: string): Promise<StackedLinkResult>;
+    /**
+     * Detects the token from URL, consumes it if player is authenticated.
+     * @returns Promise resolving to the link result, or null if no token found
+     */
+    processStackedLinkToken(): Promise<StackedLinkResult | null>;
     private handleError;
 }

package/dist/index.d.ts

@@ -10,3 +10,4 @@ export * from './types/reward';
 export * from './types/events';
 export * from './types/hooks';
 export * from './types/player';
+export * from './types/linking';

package/dist/index.esm.js

@@ -890,6 +890,7 @@ const mapEnvToOfferClientUrl = (env) => {
 class OfferwallClient {
     constructor(config) {
         this.isInitializing = false;
+        this.pendingStackedToken = null;
         this.config = {
             autoConnect: config.autoConnect ?? false,
             reconnect: config.reconnect ?? true,
@@ -907,12 +908,24 @@ class OfferwallClient {
         this.assetHelper = new AssetHelper(this.config);
         this.sseConnection = new SSEConnection(this.config, this.eventEmitter, this.tokenManager);
         this.setupInternalListeners();
+        this.setupStackedLinkDetection();
         if (this.config.autoConnect) {
             this.initialize().catch((err) => {
                 this.logger.error('Auto-initialization failed:', err);
             });
         }
     }
+    setupStackedLinkDetection() {
+        if (!this.config.stackedLink?.autoConsume) {
+            return;
+        }
+        const token = this.detectStackedLinkToken();
+        if (token) {
+            this.logger.log('Detected stackedToken in URL');
+            this.pendingStackedToken = token;
+            this.clearStackedTokenFromUrl();
+        }
+    }
     /**
      * Get the offer store instance
      */
@@ -943,9 +956,19 @@ class OfferwallClient {
             this.isInitializing = true;
             await this.refreshOffersAndPlayer();
             await this.connect();
+            // Process pending Stacked link token if exists and autoConsume is enabled
+            if (this.pendingStackedToken && this.config.stackedLink?.autoConsume) {
+                this.logger.log('Processing pending Stacked link token');
+                const result = await this.consumeStackedLinkToken(this.pendingStackedToken);
+                this.pendingStackedToken = null;
+                if (this.config.stackedLink?.onComplete) {
+                    this.config.stackedLink.onComplete(result);
+                }
+            }
             this.isInitializing = false;
         }
         catch (error) {
+            this.isInitializing = false;
             this.handleError(error, 'initialize');
             throw error;
         }
@@ -1161,6 +1184,91 @@ class OfferwallClient {
             return null;
         return `${dashboardBaseUrl}/auth/enter?token=${token}&gameId=${gameId}`;
     }
+    // ==================== Stacked Link Methods ====================
+    /**
+     * Detect if there's a Stacked link token in the current URL
+     * @returns The token string if found, null otherwise
+     */
+    detectStackedLinkToken() {
+        if (typeof window === 'undefined')
+            return null;
+        try {
+            const params = new URLSearchParams(window.location.search);
+            const token = params.get('stackedToken');
+            if (token && token.length > 0) {
+                return token;
+            }
+            // for SPA routers that use hash routing
+            if (window.location.hash) {
+                const hashQuery = window.location.hash.split('?')[1];
+                if (hashQuery) {
+                    const hashParams = new URLSearchParams(hashQuery);
+                    const hashToken = hashParams.get('stackedToken');
+                    if (hashToken && hashToken.length > 0) {
+                        return hashToken;
+                    }
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            this.logger.error('Error detecting stacked token:', error);
+            return null;
+        }
+    }
+    /**
+     * Clear the stackedToken from the URL without page reload
+     */
+    clearStackedTokenFromUrl() {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            const url = new URL(window.location.href);
+            url.searchParams.delete('stackedToken');
+            window.history.replaceState({}, '', url.toString());
+            this.logger.log('Cleared stackedToken from URL');
+        }
+        catch (error) {
+            this.logger.error('Error clearing stacked token from URL:', error);
+        }
+    }
+    /**
+     * Consume a Stacked link token to link the current game player
+     * to a Stacked unified user account.
+     *
+     * IMPORTANT: The player must be authenticated (have a valid JWT from tokenProvider)
+     * before calling this method.
+     *
+     * @param token The Stacked link token from the URL
+     * @returns Promise resolving to the link result
+     */
+    async consumeStackedLinkToken(token) {
+        try {
+            const data = await this.postWithAuth('/v1/auth/stacked_link/exchange', { stackedToken: token });
+            return {
+                linked: data.linked,
+                alreadyLinked: data.alreadyLinked,
+            };
+        }
+        catch (error) {
+            this.logger.error('Error consuming stacked link token:', error);
+            return {
+                linked: false,
+            };
+        }
+    }
+    /**
+     * Detects the token from URL, consumes it if player is authenticated.
+     * @returns Promise resolving to the link result, or null if no token found
+     */
+    async processStackedLinkToken() {
+        const token = this.detectStackedLinkToken();
+        if (!token) {
+            return null;
+        }
+        this.clearStackedTokenFromUrl();
+        return this.consumeStackedLinkToken(token);
+    }
     handleError(error, context) {
         this.logger.error(`Error in ${context}:`, error);
         if (this.hooks.onError) {
@@ -1508,7 +1616,7 @@ const meetsBaseConditions = ({ conditions, playerSnap, addDetails, }) => {
         }
     }
     // Validate link count conditions
-    if (conditions?.links) {
+    if (conditions?.links && 'entityLinks' in playerSnap) {
         for (const [linkType, constraint] of Object.entries(conditions.links)) {
             const linkCount = playerSnap.entityLinks?.filter((link) => link.kind === linkType).length || 0;
             if (constraint.min !== undefined) {
@@ -1565,7 +1673,7 @@ const meetsBaseConditions = ({ conditions, playerSnap, addDetails, }) => {
                 return { isValid: false };
         }
     }
-    if (conditions?.identifiers?.platforms?.length) {
+    if (conditions?.identifiers?.platforms?.length && 'identifiers' in playerSnap) {
         const playerPlatforms = new Set(playerSnap.identifiers?.map((i) => i.platform.toLowerCase()) || []);
         const isAndBehaviour = conditions.identifiers.behaviour === 'AND';
         const platformsToCheck = conditions.identifiers.platforms;
@@ -1602,7 +1710,7 @@ const meetsSurfacingConditions = ({ surfacingConditions, playerSnap, context, pl
         return { isValid: false };
     }
     if (surfacingConditions?.targetEntityTypes?.length) {
-        const playerTarget = playerSnap.target || 'default';
+        const playerTarget = playerSnap.entityKind || 'default';
         // check if entity type is allowed
         if (!surfacingConditions.targetEntityTypes.includes(playerTarget)) {
             return { isValid: false };
@@ -1727,6 +1835,8 @@ const hasConditions = (conditions) => {
         return true;
     if (compCond.linkedCompletions)
         return true;
+    if (compCond.dynamicTracker?.conditions?.length)
+        return true;
     return false;
 };
 const meetsCompletionConditions = ({ completionConditions, completionTrackers, playerSnap, addDetails = false, }) => {
@@ -1950,6 +2060,22 @@ const meetsCompletionConditions = ({ completionConditions, completionTrackers, p
                     return { isValid: false };
             }
         }
+        if (conditions?.dynamicTracker?.conditions?.length) {
+            const dynamicResult = meetsDynamicConditions(completionTrackers?.dynamicTracker || {}, conditions.dynamicTracker);
+            if (addDetails) {
+                conditionData.push({
+                    isMet: dynamicResult,
+                    kind: 'dynamic',
+                    text: renderTemplate(conditions.dynamicTracker.template, completionTrackers?.dynamicTracker) || 'Dynamic conditions',
+                });
+                if (!dynamicResult)
+                    isValid = false;
+            }
+            else {
+                if (!dynamicResult)
+                    return { isValid: false };
+            }
+        }
         const r = meetsBaseConditions({
             conditions,
             playerSnap,
@@ -2104,38 +2230,35 @@ function evaluateDynamicCondition(dynamicObj, cond) {
     const val = dynamicObj[cond.key];
     if (val === undefined)
         return false;
+    const isNumber = typeof val === 'number';
+    const compareTo = isNumber ? Number(cond.compareTo) : String(cond.compareTo);
     switch (cond.operator) {
         case '==':
-            return val === cond.compareTo;
+            return val === compareTo;
         case '!=':
-            return val !== cond.compareTo;
-        case '>':
-            return (typeof val === 'number' &&
-                typeof cond.compareTo === 'number' &&
-                val > cond.compareTo);
-        case '>=':
-            return (typeof val === 'number' &&
-                typeof cond.compareTo === 'number' &&
-                val >= cond.compareTo);
-        case '<':
-            return (typeof val === 'number' &&
-                typeof cond.compareTo === 'number' &&
-                val < cond.compareTo);
-        case '<=':
-            return (typeof val === 'number' &&
-                typeof cond.compareTo === 'number' &&
-                val <= cond.compareTo);
-        case 'has':
-            return (typeof val === 'string' &&
-                typeof cond.compareTo === 'string' &&
-                val.includes(cond.compareTo));
-        case 'not_has':
-            return (typeof val === 'string' &&
-                typeof cond.compareTo === 'string' &&
-                !val.includes(cond.compareTo));
-        default:
-            return false;
+            return val !== compareTo;
+    }
+    if (isNumber && typeof compareTo === 'number') {
+        switch (cond.operator) {
+            case '>':
+                return val > compareTo;
+            case '>=':
+                return val >= compareTo;
+            case '<':
+                return val < compareTo;
+            case '<=':
+                return val <= compareTo;
+        }
+    }
+    else if (!isNumber && typeof compareTo === 'string') {
+        switch (cond.operator) {
+            case 'has':
+                return val.includes(compareTo);
+            case 'not_has':
+                return !val.includes(compareTo);
+        }
     }
+    return false;
 }
 /**
  * Evaluates a group of dynamic conditions with logical links (AND, OR, AND NOT).
@@ -2168,12 +2291,34 @@ function meetsDynamicConditions(dynamicObj, dynamicGroup) {
     }
     return result;
 }
+/**
+ * Checks if a PlayerOffer meets its claimable conditions (completed -> claimable transition).
+ * @param claimableConditions - The offer's claimableConditions (from IOffer)
+ * @param claimableTrackers - The player offer's claimableTrackers
+ */
+function meetsClaimableConditions({ claimableConditions, playerOfferTrackers, claimableTrackers, }) {
+    if (!claimableConditions) {
+        return { isValid: true };
+    }
+    if (claimableConditions.siblingCompletions) {
+        const siblingCount = playerOfferTrackers?.siblingPlayerOffer_ids?.length ?? 0;
+        let completedCount = claimableTrackers?.siblingCompletions ?? 0;
+        if (completedCount == -1)
+            completedCount = siblingCount; // treat -1 as all completed
+        // if siblings exist but not all are completed, return false
+        if (siblingCount > 0 && completedCount < siblingCount) {
+            return { isValid: false };
+        }
+    }
+    return { isValid: true };
+}
 
 const offerListenerEvents = ['claim_offer'];
 const PlayerOfferStatuses = [
     // 'inQueue', // fuck this shit. just don't surface offers if their offer plate is full.
     'surfaced',
     'viewed',
+    'completed', // Individual completionConditions met, waiting for claimableConditions (e.g., siblings)
     'claimable',
     'claimed',
     'expired',
@@ -2214,5 +2359,5 @@ const rewardSchema = {
     image: String,
 };
 
-export { AssetHelper, ConnectionState, EventEmitter, OfferEvent, OfferStore, OfferwallClient, PlayerOfferStatuses, SSEConnection, hasConditions, meetsBaseConditions, meetsCompletionConditions, meetsCompletionConditionsBeforeExpiry, meetsDynamicConditions, meetsSurfacingConditions, offerListenerEvents, rewardKinds, rewardSchema };
+export { AssetHelper, ConnectionState, EventEmitter, OfferEvent, OfferStore, OfferwallClient, PlayerOfferStatuses, SSEConnection, hasConditions, meetsBaseConditions, meetsClaimableConditions, meetsCompletionConditions, meetsCompletionConditionsBeforeExpiry, meetsDynamicConditions, meetsSurfacingConditions, offerListenerEvents, rewardKinds, rewardSchema };
 //# sourceMappingURL=index.esm.js.map