@stackedapp/utils 2.39.2 → 2.40.1

package/dist/conditions/handlers.d.ts

@@ -33,7 +33,7 @@ export declare function evaluateCompletionContext(cond: ICompletionContextCondit
 export declare function evaluateBuyItem(cond: IBuyItemCondition, ctx: EvalContext): EvalResult;
 export declare function evaluateSpendCurrency(cond: ISpendCurrencyCondition, ctx: EvalContext): EvalResult;
 export declare function evaluateDepositCurrency(cond: IDepositCurrencyCondition, ctx: EvalContext): EvalResult;
-export declare function evaluateLogin(_cond: ILoginCondition, ctx: EvalContext): EvalResult;
+export declare function evaluateLogin(cond: ILoginCondition, ctx: EvalContext): EvalResult;
 export declare function evaluateSocial(cond: ISocialCondition, ctx: EvalContext): EvalResult;
 export declare function evaluateLinkedCompletions(cond: ILinkedCompletionsCondition, ctx: EvalContext): EvalResult;
 export declare function evaluateDynamicTracker(cond: IDynamicTrackerCondition, ctx: EvalContext): EvalResult;

package/dist/conditions/handlers.js

@@ -31,6 +31,9 @@ const template_1 = require("../template");
 const dynamic_1 = require("../dynamic");
 const helpers_1 = require("./helpers");
 const blockchain_utils_1 = require("../blockchain_utils");
+function templateText(cond, vars, fallback) {
+    return cond.template ? (0, template_1.renderTemplate)(cond.template, vars) || fallback : fallback;
+}
 // ─── Base Condition Handlers ─────────────────────────────────────────────────
 function evaluateDaysInGame(cond, ctx) {
     const details = [];
@@ -47,7 +50,7 @@ function evaluateDaysInGame(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `More than ${trackerGoal} Days in Game`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal }, `More than ${trackerGoal} Days in Game`),
         });
     }
     if (cond.max) {
@@ -61,7 +64,7 @@ function evaluateDaysInGame(cond, ctx) {
             trackerAmount,
             trackerGoal: cond.max,
             percentCompleted: met ? 100 : 0,
-            text: `Less than ${cond.max} Days in Game`,
+            text: templateText(cond, { current: trackerAmount, goal: cond.max }, `Less than ${cond.max} Days in Game`),
         });
     }
     return { isMet, details };
@@ -81,7 +84,7 @@ function evaluateTrustScore(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `More than ${trackerGoal} Rep`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal }, `More than ${trackerGoal} Rep`),
         });
     }
     if (cond.max) {
@@ -95,7 +98,7 @@ function evaluateTrustScore(cond, ctx) {
             trackerAmount,
             trackerGoal: cond.max,
             percentCompleted: met ? 100 : 0,
-            text: `Less than ${cond.max} Rep`,
+            text: templateText(cond, { current: trackerAmount, goal: cond.max }, `Less than ${cond.max} Rep`),
         });
     }
     return { isMet, details };
@@ -116,7 +119,7 @@ function evaluateLevel(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `Be above level ${trackerGoal} ${cond.name}`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, `Be above level ${trackerGoal} ${cond.name}`),
         });
     }
     if (cond.max) {
@@ -130,7 +133,7 @@ function evaluateLevel(cond, ctx) {
             trackerAmount,
             trackerGoal: cond.max,
             percentCompleted: met ? 100 : 0,
-            text: `Be under level ${cond.max} ${cond.name}`,
+            text: templateText(cond, { current: trackerAmount, goal: cond.max, name: cond.name }, `Be under level ${cond.max} ${cond.name}`),
         });
     }
     return { isMet, details };
@@ -151,7 +154,7 @@ function evaluateCurrency(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `Have more than ${trackerGoal} ${cond.name}`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, `Have more than ${trackerGoal} ${cond.name}`),
         });
     }
     if (cond.max) {
@@ -165,7 +168,7 @@ function evaluateCurrency(cond, ctx) {
             trackerAmount,
             trackerGoal: cond.max,
             percentCompleted: met ? 100 : 0,
-            text: `Have less than ${cond.max} ${cond.name}`,
+            text: templateText(cond, { current: trackerAmount, goal: cond.max, name: cond.name }, `Have less than ${cond.max} ${cond.name}`),
         });
     }
     if (cond.in) {
@@ -180,7 +183,7 @@ function evaluateCurrency(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `Deposit at least ${trackerGoal} ${cond.name}`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, `Deposit at least ${trackerGoal} ${cond.name}`),
         });
     }
     if (cond.out) {
@@ -195,7 +198,7 @@ function evaluateCurrency(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `Withdraw at least ${trackerGoal} ${cond.name}`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, `Withdraw at least ${trackerGoal} ${cond.name}`),
         });
     }
     return { isMet, details };
@@ -216,7 +219,7 @@ function evaluateStakedTokens(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `Have at least ${trackerGoal} ${cond.name} staked`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, `Have at least ${trackerGoal} ${cond.name} staked`),
         });
     }
     return { isMet, details };
@@ -242,7 +245,7 @@ function evaluateLoginStreak(cond, ctx) {
                 trackerAmount,
                 trackerGoal,
                 percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, isMet),
-                text: `Login streak of ${trackerGoal || 0} days`,
+                text: templateText(cond, { current: trackerAmount, goal: trackerGoal }, `Login streak of ${trackerGoal || 0} days`),
             },
         ],
     };
@@ -259,7 +262,7 @@ function evaluateAchievement(cond, ctx) {
             trackerAmount: 0,
             trackerGoal: 1,
             percentCompleted: 0,
-            text: `Have the achievement ${cond.name}`,
+            text: templateText(cond, { current: 0, goal: 1, name: cond.name }, `Have the achievement ${cond.name}`),
         });
     }
     if (cond.minCount) {
@@ -274,7 +277,7 @@ function evaluateAchievement(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `Have the achievement ${cond.name} more than ${trackerGoal} times`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, `Have the achievement ${cond.name} more than ${trackerGoal} times`),
         });
     }
     return { isMet, details };
@@ -295,7 +298,7 @@ function evaluateMembership(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: trackerGoal > 1 ? `Have at least ${trackerGoal} ${cond.name} memberships` : `Have a ${cond.name} membership`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, trackerGoal > 1 ? `Have at least ${trackerGoal} ${cond.name} memberships` : `Have a ${cond.name} membership`),
         });
     }
     if (cond.maxCount) {
@@ -309,7 +312,7 @@ function evaluateMembership(cond, ctx) {
             trackerAmount,
             trackerGoal: cond.maxCount,
             percentCompleted: met ? 100 : 0,
-            text: `Have less than ${cond.maxCount} ${cond.name} memberships`,
+            text: templateText(cond, { current: trackerAmount, goal: cond.maxCount, name: cond.name }, `Have less than ${cond.maxCount} ${cond.name} memberships`),
         });
     }
     const timeOwned = (playerData?.expiresAt || 0) - Date.now();
@@ -325,7 +328,7 @@ function evaluateMembership(cond, ctx) {
             trackerAmount,
             trackerGoal,
             percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, met),
-            text: `Own ${cond.name} membership for at least ${trackerGoal} days`,
+            text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, `Own ${cond.name} membership for at least ${trackerGoal} days`),
         });
     }
     if (cond.maxMs) {
@@ -339,7 +342,7 @@ function evaluateMembership(cond, ctx) {
             trackerAmount,
             trackerGoal: Number((cond.maxMs / (1000 * 60 * 60 * 24)).toFixed(1)),
             percentCompleted: met ? 100 : 0,
-            text: `Own ${cond.name} membership for less than ${(cond.maxMs / (1000 * 60 * 60 * 24)).toFixed(1)} days`,
+            text: templateText(cond, { current: trackerAmount, goal: Number((cond.maxMs / (1000 * 60 * 60 * 24)).toFixed(1)), name: cond.name }, `Own ${cond.name} membership for less than ${(cond.maxMs / (1000 * 60 * 60 * 24)).toFixed(1)} days`),
         });
     }
     return { isMet, details };
@@ -358,11 +361,11 @@ function evaluateQuest(cond, ctx) {
                 trackerAmount,
                 trackerGoal,
                 percentCompleted: (0, helpers_1.calculatePercent)(trackerAmount, trackerGoal, isMet),
-                text: cond.completions === 1
+                text: templateText(cond, { current: trackerAmount, goal: trackerGoal, name: cond.name }, cond.completions === 1
                     ? `Complete the quest ${cond.name}`
                     : (cond.completions || 0) < 1
                         ? `Start the quest ${cond.name}`
-                        : `Complete the quest ${cond.name} ${cond.completions} times`,
+                        : `Complete the quest ${cond.name} ${cond.completions} times`),
             },
         ],
     };
@@ -472,7 +475,8 @@ function evaluateIdentifiers(cond, ctx) {
     }
     else {
         isMet = platformsToCheck.some((p) => playerPlatforms.has(p.toLowerCase()));
-        displayText = `Link any of your ${(0, helpers_1.formatList)(platforms)} accounts`;
+        displayText =
+            platformsToCheck.length > 1 ? `Link any of your ${(0, helpers_1.formatList)(platforms)} accounts` : `Link your ${platforms[0]} account`;
         percentCompleted = isMet ? 100 : 0;
     }
     return {
@@ -484,7 +488,7 @@ function evaluateIdentifiers(cond, ctx) {
                 trackerAmount: isMet ? 1 : 0,
                 trackerGoal: 1,
                 percentCompleted,
-                text: displayText,
+                text: templateText(cond, { current: metPlatforms.length, goal: platformsToCheck.length }, displayText),
             },
         ],
     };
@@ -509,7 +513,7 @@ function evaluateTokenBalance(cond, ctx) {
             trackerAmount: totalBalance,
             trackerGoal: cond.min,
             percentCompleted: (0, helpers_1.calculatePercent)(totalBalance, cond.min, met),
-            text: `Have at least ${cond.min} ${cond.name || 'tokens'}`,
+            text: templateText(cond, { current: totalBalance, goal: cond.min, name: cond.name || 'tokens' }, `Have at least ${cond.min} ${cond.name || 'tokens'}`),
         });
     }
     if (cond.max !== undefined) {
@@ -522,7 +526,7 @@ function evaluateTokenBalance(cond, ctx) {
             trackerAmount: totalBalance,
             trackerGoal: cond.max,
             percentCompleted: met ? 100 : 0,
-            text: `Have at most ${cond.max} ${cond.name || 'tokens'}`,
+            text: templateText(cond, { current: totalBalance, goal: cond.max, name: cond.name || 'tokens' }, `Have at most ${cond.max} ${cond.name || 'tokens'}`),
         });
     }
     return { isMet, details };
@@ -541,7 +545,7 @@ function evaluateStackedAccount(cond, ctx) {
             trackerAmount: playerHasAccount ? 1 : 0,
             trackerGoal: 1,
             percentCompleted: met ? 100 : 0,
-            text: cond.hasLinkedAccount ? 'Link a Stacked account' : 'Must not have Stacked account linked',
+            text: templateText(cond, { current: playerHasAccount ? 1 : 0, goal: 1 }, cond.hasLinkedAccount ? 'Link a Stacked account' : 'Must not have Stacked account linked'),
         });
     }
     if (cond.cryptoWallets) {
@@ -556,7 +560,7 @@ function evaluateStackedAccount(cond, ctx) {
                 trackerAmount: walletCount,
                 trackerGoal: cond.cryptoWallets.min,
                 percentCompleted: (0, helpers_1.calculatePercent)(walletCount, cond.cryptoWallets.min, met),
-                text: `Link at least ${cond.cryptoWallets.min} crypto wallet${cond.cryptoWallets.min === 1 ? '' : 's'}`,
+                text: templateText(cond, { current: walletCount, goal: cond.cryptoWallets.min }, `Link at least ${cond.cryptoWallets.min} crypto wallet${cond.cryptoWallets.min === 1 ? '' : 's'}`),
             });
         }
         if (cond.cryptoWallets.max !== undefined) {
@@ -569,7 +573,7 @@ function evaluateStackedAccount(cond, ctx) {
                 trackerAmount: walletCount,
                 trackerGoal: cond.cryptoWallets.max,
                 percentCompleted: met ? 100 : 0,
-                text: `Have at most ${cond.cryptoWallets.max} crypto wallet${cond.cryptoWallets.max === 1 ? '' : 's'}`,
+                text: templateText(cond, { current: walletCount, goal: cond.cryptoWallets.max }, `Have at most ${cond.cryptoWallets.max} crypto wallet${cond.cryptoWallets.max === 1 ? '' : 's'}`),
             });
         }
     }
@@ -584,7 +588,7 @@ function evaluateStackedAccount(cond, ctx) {
             trackerAmount: hasCustomUsername ? 1 : 0,
             trackerGoal: 1,
             percentCompleted: met ? 100 : 0,
-            text: cond.hasUsername ? 'Set a custom username' : 'Must not have a custom username',
+            text: templateText(cond, { current: hasCustomUsername ? 1 : 0, goal: 1 }, cond.hasUsername ? 'Set a custom username' : 'Must not have a custom username'),
         });
     }
     if (cond.hasProfilePic !== undefined) {
@@ -598,7 +602,7 @@ function evaluateStackedAccount(cond, ctx) {
             trackerAmount: hasCustomPic ? 1 : 0,
             trackerGoal: 1,
             percentCompleted: met ? 100 : 0,
-            text: cond.hasProfilePic ? 'Set a custom profile picture' : 'Must not have a custom profile picture',
+            text: templateText(cond, { current: hasCustomPic ? 1 : 0, goal: 1 }, cond.hasProfilePic ? 'Set a custom profile picture' : 'Must not have a custom profile picture'),
         });
     }
     if (cond.authPlatforms && cond.authPlatforms.platforms.length > 0) {
@@ -624,7 +628,10 @@ function evaluateStackedAccount(cond, ctx) {
         }
         else {
             met = platformsToCheck.some((p) => playerPlatforms.has(p.toLowerCase()));
-            displayText = `Link any of your ${(0, helpers_1.formatList)(platforms)} accounts in Stacked`;
+            displayText =
+                platformsToCheck.length > 1
+                    ? `Link any of your ${(0, helpers_1.formatList)(platforms)} accounts in Stacked`
+                    : `Link your ${platforms[0]} account in Stacked`;
             percentCompleted = met ? 100 : 0;
         }
         if (!met)
@@ -635,7 +642,7 @@ function evaluateStackedAccount(cond, ctx) {
             trackerAmount: met ? 1 : 0,
             trackerGoal: 1,
             percentCompleted,
-            text: displayText,
+            text: templateText(cond, { current: met ? 1 : 0, goal: 1 }, displayText),
         });
     }
     return { isMet, details };
@@ -654,7 +661,7 @@ function evaluateUserSettings(cond, ctx) {
             trackerAmount: playerHasNewsletter ? 1 : 0,
             trackerGoal: 1,
             percentCompleted: met ? 100 : 0,
-            text: cond.emailNewsletter ? 'Subscribe to email newsletter' : 'Must not be subscribed to email newsletter',
+            text: templateText(cond, { current: playerHasNewsletter ? 1 : 0, goal: 1 }, cond.emailNewsletter ? 'Subscribe to email newsletter' : 'Must not be subscribed to email newsletter'),
         });
     }
     return { isMet, details };
@@ -672,7 +679,7 @@ function evaluateCompletionContext(cond, ctx) {
                 trackerAmount: isMet ? 1 : 0,
                 trackerGoal: 1,
                 percentCompleted: isMet ? 100 : 0,
-                text: cond.name,
+                text: templateText(cond, { current: isMet ? 1 : 0, goal: 1, name: cond.name }, cond.name),
             },
         ],
     };
@@ -691,7 +698,7 @@ function evaluateBuyItem(cond, ctx) {
                 trackerAmount: trackerValue,
                 trackerGoal: scaledAmount,
                 percentCompleted: (0, helpers_1.calculatePercent)(trackerValue, scaledAmount, isMet),
-                text: `Buy ${scaledAmount} ${cond.name}`,
+                text: templateText(cond, { current: trackerValue, goal: scaledAmount, name: cond.name }, `Buy ${scaledAmount} ${cond.name}`),
             },
         ],
         maxClaims: ctx.shouldScale && baseAmount > 0 ? Math.floor(trackerValue / baseAmount) : undefined,
@@ -711,7 +718,7 @@ function evaluateSpendCurrency(cond, ctx) {
                 trackerAmount: trackerValue,
                 trackerGoal: scaledAmount,
                 percentCompleted: (0, helpers_1.calculatePercent)(trackerValue, scaledAmount, isMet),
-                text: `Spend ${scaledAmount} ${cond.name}`,
+                text: templateText(cond, { current: trackerValue, goal: scaledAmount, name: cond.name }, `Spend ${scaledAmount} ${cond.name}`),
             },
         ],
         maxClaims: ctx.shouldScale && baseAmount > 0 ? Math.floor(trackerValue / baseAmount) : undefined,
@@ -731,13 +738,13 @@ function evaluateDepositCurrency(cond, ctx) {
                 trackerAmount: trackerValue,
                 trackerGoal: scaledAmount,
                 percentCompleted: (0, helpers_1.calculatePercent)(trackerValue, scaledAmount, isMet),
-                text: `Deposit ${scaledAmount} ${cond.name}`,
+                text: templateText(cond, { current: trackerValue, goal: scaledAmount, name: cond.name }, `Deposit ${scaledAmount} ${cond.name}`),
             },
         ],
         maxClaims: ctx.shouldScale && baseAmount > 0 ? Math.floor(trackerValue / baseAmount) : undefined,
     };
 }
-function evaluateLogin(_cond, ctx) {
+function evaluateLogin(cond, ctx) {
     const isMet = new Date(ctx.snap.snapshotLastUpdated || 0).getTime() > new Date(ctx.offerCreatedAt || 0).getTime();
     return {
         isMet,
@@ -748,7 +755,7 @@ function evaluateLogin(_cond, ctx) {
                 trackerAmount: isMet ? 1 : 0,
                 trackerGoal: 1,
                 percentCompleted: isMet ? 100 : 0,
-                text: 'Login to the game',
+                text: templateText(cond, { current: isMet ? 1 : 0, goal: 1 }, 'Login to the game'),
             },
         ],
     };
@@ -812,11 +819,11 @@ function evaluateSocial(cond, ctx) {
             trackerAmount: matchCount,
             trackerGoal: 1,
             percentCompleted: socialPercent,
-            text: hasContent
+            text: templateText(cond, { current: matchCount, goal: 1, likes, views, comments, minLikes, minViews, minComments }, hasContent
                 ? `Found ${matchCount} matching ${platformText} post${matchCount !== 1 ? 's' : ''}`
                 : requiredWords.length > 0
                     ? `Post ${platformText} content with ${requiredWords.map((w) => `"${w}"`).join(', ')}${afterText}`
-                    : `Post ${platformText} content${afterText}`,
+                    : `Post ${platformText} content${afterText}`),
         });
     }
     else {
@@ -827,11 +834,11 @@ function evaluateSocial(cond, ctx) {
             trackerAmount: hasContent ? 1 : 0,
             trackerGoal: 1,
             percentCompleted: socialPercent,
-            text: !hasContent
+            text: templateText(cond, { current: hasContent ? 1 : 0, goal: 1, likes, views, comments, minLikes, minViews, minComments }, !hasContent
                 ? requiredWords.length > 0
                     ? `Attach a ${platformText} post with ${requiredWords.map((w) => `"${w}"`).join(', ')} in the title${afterText}`
                     : `Attach a ${platformText} post${afterText}`
-                : `Attached: ${title}`,
+                : `Attached: ${title}`),
         });
     }
     if (minLikes > 0) {
@@ -841,7 +848,7 @@ function evaluateSocial(cond, ctx) {
             trackerAmount: likes,
             trackerGoal: minLikes,
             percentCompleted: (0, helpers_1.calculatePercent)(likes, minLikes, hasContent && likes >= minLikes),
-            text: mode === 'accumulate' ? `Combined ${minLikes} Likes` : `Reach ${minLikes} Likes`,
+            text: templateText(cond, { current: likes, goal: minLikes }, mode === 'accumulate' ? `Combined ${minLikes} Likes` : `Reach ${minLikes} Likes`),
         });
     }
     if (minViews > 0) {
@@ -851,7 +858,7 @@ function evaluateSocial(cond, ctx) {
             trackerAmount: views,
             trackerGoal: minViews,
             percentCompleted: (0, helpers_1.calculatePercent)(views, minViews, hasContent && views >= minViews),
-            text: mode === 'accumulate' ? `Combined ${minViews} Views` : `Reach ${minViews} Views`,
+            text: templateText(cond, { current: views, goal: minViews }, mode === 'accumulate' ? `Combined ${minViews} Views` : `Reach ${minViews} Views`),
         });
     }
     if (minComments > 0) {
@@ -861,7 +868,7 @@ function evaluateSocial(cond, ctx) {
             trackerAmount: comments,
             trackerGoal: minComments,
             percentCompleted: (0, helpers_1.calculatePercent)(comments, minComments, hasContent && comments >= minComments),
-            text: mode === 'accumulate' ? `Combined ${minComments} Comments` : `Reach ${minComments} Comments`,
+            text: templateText(cond, { current: comments, goal: minComments }, mode === 'accumulate' ? `Combined ${minComments} Comments` : `Reach ${minComments} Comments`),
         });
     }
     return { isMet, details, maxClaims };
@@ -1010,7 +1017,7 @@ function evaluateTwitterVerification(cond, ctx) {
                 trackerAmount: isMet ? 1 : 0,
                 trackerGoal: 1,
                 percentCompleted: isMet ? 100 : 0,
-                text: actionTextMap[cond.action] || 'Complete action on X',
+                text: templateText(cond, { current: isMet ? 1 : 0, goal: 1 }, actionTextMap[cond.action] || 'Complete action on X'),
             },
         ],
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackedapp/utils",
-  "version": "2.39.2",
+  "version": "2.40.1",
   "description": "Public utilities for Stacked platform SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",