@stackedapp/utils 0.26.1

package/dist/blockchain_utils.d.ts

@@ -0,0 +1,6 @@
+export declare const addressNetworkId: (contractAddress: string, network: string) => string;
+export declare const deconstructAddressNetworkId: (addressNetwork: string) => {
+    address: string;
+    network: string;
+};
+//# sourceMappingURL=blockchain_utils.d.ts.map

package/dist/blockchain_utils.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deconstructAddressNetworkId = exports.addressNetworkId = void 0;
+const addressNetworkId = (contractAddress, network) => {
+    return `${contractAddress.toLowerCase()}:${network.toUpperCase()}`;
+};
+exports.addressNetworkId = addressNetworkId;
+const deconstructAddressNetworkId = (addressNetwork) => {
+    const [address, network] = addressNetwork.split(':');
+    return { address, network };
+};
+exports.deconstructAddressNetworkId = deconstructAddressNetworkId;
+//# sourceMappingURL=blockchain_utils.js.map

package/dist/conditions.d.ts

@@ -0,0 +1,133 @@
+import { StackedCompletionConditions, StackedOffer, StackedSnapshot, StackedBaseUserExtra, StackedBaseConditions, StackedClaimableConditions, StackedClaimableTrackers, StackedCompletionTrackers, StackedDynamicCondition, StackedDynamicGroup, StackedOfferTrackers } from '@stackedapp/types';
+export declare const DEFAULT_ENTITY_KIND = "_default";
+export declare const meetsBaseConditions: ({ conditions, playerSnap, addDetails, playerOffer, additionalData, }: {
+    conditions: StackedBaseConditions;
+    playerSnap: StackedSnapshot;
+    addDetails?: boolean;
+    playerOffer?: {
+        createdAt?: Date | number;
+        claimedCount?: number;
+        trackers?: Record<string, any>;
+    };
+    additionalData?: StackedBaseUserExtra;
+}) => {
+    isValid: boolean;
+    conditionData?: undefined;
+} | {
+    isValid: boolean;
+    conditionData: {
+        isMet: boolean;
+        kind?: keyof StackedBaseConditions;
+        trackerAmount?: number;
+        trackerGoal?: number;
+        text: string;
+    }[] | undefined;
+};
+export declare const hasCompletionConditions: (conditions: StackedCompletionConditions) => boolean;
+export declare const meetsLinkedEntityOffersCondition: ({ linkedEntityOffers, matchingLinks, linkedPOfferMap, }: {
+    linkedEntityOffers: {
+        kind?: string;
+        offer_id?: string;
+        link?: boolean;
+    };
+    matchingLinks: Array<{
+        playerId: string;
+        kind?: string;
+    }>;
+    linkedPOfferMap: Map<string, StackedOffer>;
+}) => {
+    isValid: boolean;
+    linkedPlayerOffer_ids?: string[];
+};
+export declare const offerMeetsCompletionConditions: (offer: StackedOffer, snapshot: StackedSnapshot, additionalData?: StackedBaseUserExtra) => {
+    isValid: boolean;
+    availableClaimsNow: number;
+    conditionData?: undefined;
+} | {
+    isValid: boolean;
+    conditionData: {
+        isMet: boolean;
+        kind?: keyof StackedCompletionConditions | "context";
+        trackerAmount?: number;
+        trackerGoal?: number;
+        text: string;
+    }[];
+    availableClaimsNow: number;
+};
+export declare const meetsCompletionConditions: ({ completionConditions, completionTrackers, playerSnap, playerOffer, addDetails, maxClaimCount, additionalData, }: {
+    completionConditions: StackedCompletionConditions;
+    completionTrackers?: StackedCompletionTrackers;
+    playerSnap: StackedSnapshot;
+    playerOffer: {
+        createdAt?: Date | number;
+        trackers?: StackedOfferTrackers;
+    };
+    addDetails?: boolean;
+    maxClaimCount?: number;
+    additionalData?: StackedBaseUserExtra;
+}) => {
+    isValid: boolean;
+    availableClaimsNow: number;
+    conditionData?: undefined;
+} | {
+    isValid: boolean;
+    conditionData: {
+        isMet: boolean;
+        kind?: keyof StackedCompletionConditions | "context";
+        trackerAmount?: number;
+        trackerGoal?: number;
+        text: string;
+    }[];
+    availableClaimsNow: number;
+};
+/**
+ * Checks if completion conditions were met before a specific expiry time.
+ * Returns true if all relevant condition fields were updated before expiryTime.
+ *
+ * @param completionConditions - The completion conditions to check
+ * @param completionTrackers - The completion trackers (for buyItem, spendCurrency, etc.)
+ * @param playerSnap - The player snapshot with field timestamps
+ * @returns true if all conditions were met before expiry, false otherwise
+ */
+export declare const meetsCompletionConditionsBeforeExpiry: ({ completionConditions, completionTrackers, playerSnap, playerOffer, maxClaimCount, }: {
+    completionConditions: StackedCompletionConditions;
+    completionTrackers?: StackedCompletionTrackers;
+    playerSnap: StackedSnapshot;
+    playerOffer: {
+        createdAt?: Date | number;
+        claimedCount?: number;
+        trackers?: Record<string, any>;
+        expiresAt?: Date | number | string;
+    };
+    maxClaimCount?: number;
+}) => boolean;
+/**
+ * Calculates the maximum number of claims supported by a single dynamic condition.
+ */
+export declare function getMaxClaimsForDynamicCondition(dynamicObj: Record<string, string | number | boolean>, cond: StackedDynamicCondition): number;
+/**
+ * Calculates the maximum number of claims supported by a group of dynamic conditions.
+ */
+export declare function getMaxClaimsForDynamicGroup(dynamicObj: Record<string, string | number | boolean>, dynamicGroup: StackedDynamicGroup, currentClaimCount?: number): number;
+/**
+ * Evaluates a group of dynamic conditions with logical links (AND, OR, AND NOT).
+ * @param dynamicObj - The player's dynamic object with any key and string or number value.
+ * @param dynamicGroup - The group of conditions and links to check.
+ * @param claimMultiplier - Multiplier to scale conditions (used for numeric comparisons).
+ * @returns true if the group evaluates to true, false otherwise.
+ */
+export declare function meetsDynamicConditions(dynamicObj: Record<string, string | number | boolean> | undefined | null, dynamicGroup: StackedDynamicGroup, claimMultiplier?: number): boolean;
+/**
+ * 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
+ */
+export declare function meetsClaimableConditions({ claimableConditions, playerOfferTrackers, claimableTrackers, }: {
+    claimableConditions?: StackedClaimableConditions;
+    playerOfferTrackers?: StackedOfferTrackers;
+    claimableTrackers?: StackedClaimableTrackers;
+}): {
+    isValid: boolean;
+};
+export declare function aggregateTokenBalances(data?: StackedBaseUserExtra): Record<string, number>;
+//# sourceMappingURL=conditions.d.ts.map