@sudobility/ratelimit_service 1.0.1

package/dist/helpers/RateLimitRouteHandler.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitRouteHandler = void 0;
+const RevenueCatHelper_1 = require("./RevenueCatHelper");
+const EntitlementHelper_1 = require("./EntitlementHelper");
+const RateLimitChecker_1 = require("./RateLimitChecker");
+const types_1 = require("../types");
+/**
+ * Default display names for common entitlements.
+ */
+const DEFAULT_DISPLAY_NAMES = {
+    none: "Free",
+    starter: "Starter",
+    pro: "Pro",
+    enterprise: "Enterprise",
+};
+/**
+ * Helper for rate limit API endpoints.
+ * Provides data for /ratelimits and /ratelimits/history endpoints.
+ */
+class RateLimitRouteHandler {
+    constructor(config) {
+        this.rcHelper = new RevenueCatHelper_1.RevenueCatHelper({ apiKey: config.revenueCatApiKey });
+        this.entitlementHelper = new EntitlementHelper_1.EntitlementHelper(config.rateLimitsConfig);
+        this.rateLimitChecker = new RateLimitChecker_1.RateLimitChecker({
+            db: config.db,
+            table: config.rateLimitsTable,
+        });
+        this.rateLimitsConfig = config.rateLimitsConfig;
+        this.displayNames = {
+            ...DEFAULT_DISPLAY_NAMES,
+            ...config.entitlementDisplayNames,
+        };
+    }
+    /**
+     * Get rate limits configuration data for /ratelimits endpoint.
+     *
+     * @param userId - The user's ID (e.g., Firebase UID)
+     * @returns RateLimitsConfigData for API response
+     */
+    async getRateLimitsConfigData(userId) {
+        // Get all tiers from config
+        const tiers = Object.entries(this.rateLimitsConfig).map(([entitlement, limits]) => ({
+            entitlement,
+            displayName: this.getDisplayName(entitlement),
+            limits: this.convertLimits(limits),
+        }));
+        // Get user's subscription info from RevenueCat
+        let entitlements;
+        let subscriptionStartedAt = null;
+        try {
+            const subscriptionInfo = await this.rcHelper.getSubscriptionInfo(userId);
+            entitlements = subscriptionInfo.entitlements;
+            subscriptionStartedAt = subscriptionInfo.subscriptionStartedAt;
+        }
+        catch (error) {
+            console.error("RevenueCat error, using 'none' entitlement:", error);
+            entitlements = [types_1.NONE_ENTITLEMENT];
+        }
+        // Get the primary entitlement (first one that has limits configured)
+        const currentEntitlement = this.getPrimaryEntitlement(entitlements);
+        // Get rate limits for user's entitlements
+        const internalLimits = this.entitlementHelper.getRateLimits(entitlements);
+        const currentLimits = this.convertLimits(internalLimits);
+        // Get current usage
+        const checkResult = await this.rateLimitChecker.checkOnly(userId, internalLimits, subscriptionStartedAt);
+        const currentUsage = {
+            hourly: internalLimits.hourly !== undefined
+                ? internalLimits.hourly - (checkResult.remaining.hourly ?? 0)
+                : 0,
+            daily: internalLimits.daily !== undefined
+                ? internalLimits.daily - (checkResult.remaining.daily ?? 0)
+                : 0,
+            monthly: internalLimits.monthly !== undefined
+                ? internalLimits.monthly - (checkResult.remaining.monthly ?? 0)
+                : 0,
+        };
+        return {
+            tiers,
+            currentEntitlement,
+            currentLimits,
+            currentUsage,
+        };
+    }
+    /**
+     * Get rate limit history data for /ratelimits/history/{periodType} endpoint.
+     *
+     * @param userId - The user's ID (e.g., Firebase UID)
+     * @param periodType - The period type (hour, day, month)
+     * @param limit - Maximum number of entries to return (default: 100)
+     * @returns RateLimitHistoryData for API response
+     */
+    async getRateLimitHistoryData(userId, periodType, limit = 100) {
+        // Convert API period type to internal period type
+        const internalPeriodType = this.convertPeriodType(periodType);
+        // Get user's subscription info for subscription month calculation
+        let subscriptionStartedAt = null;
+        let entitlements = [types_1.NONE_ENTITLEMENT];
+        try {
+            const subscriptionInfo = await this.rcHelper.getSubscriptionInfo(userId);
+            subscriptionStartedAt = subscriptionInfo.subscriptionStartedAt;
+            entitlements = subscriptionInfo.entitlements;
+        }
+        catch (error) {
+            console.error("RevenueCat error:", error);
+        }
+        // Get the limit for this period type
+        const internalLimits = this.entitlementHelper.getRateLimits(entitlements);
+        const periodLimit = this.getLimitForPeriod(internalLimits, periodType);
+        // Get history from database
+        const history = await this.rateLimitChecker.getHistory(userId, internalPeriodType, subscriptionStartedAt, limit);
+        // Convert to API format
+        const entries = history.entries.map(entry => ({
+            periodStart: entry.period_start.toISOString(),
+            periodEnd: entry.period_end.toISOString(),
+            requestCount: entry.request_count,
+            limit: periodLimit,
+        }));
+        return {
+            periodType,
+            entries,
+            totalEntries: entries.length,
+        };
+    }
+    /**
+     * Get display name for an entitlement.
+     */
+    getDisplayName(entitlement) {
+        if (this.displayNames[entitlement]) {
+            return this.displayNames[entitlement];
+        }
+        // Capitalize first letter as fallback
+        return entitlement.charAt(0).toUpperCase() + entitlement.slice(1);
+    }
+    /**
+     * Get the primary entitlement from a list.
+     * Returns the first entitlement that has configured limits, or "none".
+     */
+    getPrimaryEntitlement(entitlements) {
+        for (const entitlement of entitlements) {
+            if (entitlement !== types_1.NONE_ENTITLEMENT &&
+                this.rateLimitsConfig[entitlement]) {
+                return entitlement;
+            }
+        }
+        return types_1.NONE_ENTITLEMENT;
+    }
+    /**
+     * Convert internal RateLimits to API RateLimits.
+     * Internal uses undefined for unlimited, API uses null.
+     */
+    convertLimits(limits) {
+        return {
+            hourly: limits.hourly ?? null,
+            daily: limits.daily ?? null,
+            monthly: limits.monthly ?? null,
+        };
+    }
+    /**
+     * Convert API period type to internal period type.
+     */
+    convertPeriodType(periodType) {
+        switch (periodType) {
+            case "hour":
+                return types_1.PeriodType.HOURLY;
+            case "day":
+                return types_1.PeriodType.DAILY;
+            case "month":
+                return types_1.PeriodType.MONTHLY;
+            default:
+                throw new Error(`Invalid period type: ${periodType}`);
+        }
+    }
+    /**
+     * Get the limit for a specific period type.
+     */
+    getLimitForPeriod(limits, periodType) {
+        switch (periodType) {
+            case "hour":
+                return limits.hourly ?? null;
+            case "day":
+                return limits.daily ?? null;
+            case "month":
+                return limits.monthly ?? null;
+            default:
+                return null;
+        }
+    }
+}
+exports.RateLimitRouteHandler = RateLimitRouteHandler;
+//# sourceMappingURL=RateLimitRouteHandler.js.map

package/dist/helpers/RateLimitRouteHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimitRouteHandler.js","sourceRoot":"","sources":["../../src/helpers/RateLimitRouteHandler.ts"],"names":[],"mappings":"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"}

package/dist/helpers/RevenueCatHelper.cjs

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RevenueCatHelper = void 0;
+const entitlements_1 = require("../types/entitlements");
+/**
+ * Helper class for interacting with RevenueCat API to get user entitlements
+ * and subscription information.
+ *
+ * @example
+ * ```typescript
+ * const rcHelper = new RevenueCatHelper({
+ *   apiKey: process.env.REVENUECAT_API_KEY!,
+ * });
+ *
+ * // Get just entitlements (for backward compatibility)
+ * const entitlements = await rcHelper.getEntitlements(userId);
+ * // Returns: ["pro"] or ["none"] if no subscription
+ *
+ * // Get full subscription info including start date
+ * const info = await rcHelper.getSubscriptionInfo(userId);
+ * // Returns: { entitlements: ["pro"], subscriptionStartedAt: Date }
+ * ```
+ */
+class RevenueCatHelper {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? "https://api.revenuecat.com/v1";
+    }
+    /**
+     * Get active entitlement names for a user.
+     *
+     * @param userId - The RevenueCat app_user_id (usually Firebase UID)
+     * @returns Array of active entitlement names, or ["none"] if no active entitlements
+     * @throws Error if RevenueCat API returns an error (other than 404)
+     */
+    async getEntitlements(userId) {
+        const info = await this.getSubscriptionInfo(userId);
+        return info.entitlements;
+    }
+    /**
+     * Get full subscription info including entitlements and subscription start date.
+     *
+     * @param userId - The RevenueCat app_user_id (usually Firebase UID)
+     * @returns SubscriptionInfo with entitlements and subscriptionStartedAt
+     * @throws Error if RevenueCat API returns an error (other than 404)
+     */
+    async getSubscriptionInfo(userId) {
+        const response = await fetch(`${this.baseUrl}/subscribers/${encodeURIComponent(userId)}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        // User not found in RevenueCat - treat as no subscription
+        if (response.status === 404) {
+            return {
+                entitlements: [entitlements_1.NONE_ENTITLEMENT],
+                subscriptionStartedAt: null,
+            };
+        }
+        if (!response.ok) {
+            throw new Error(`RevenueCat API error: ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        const entitlements = data.subscriber?.entitlements ?? {};
+        const now = new Date();
+        const activeEntitlements = [];
+        let earliestPurchaseDate = null;
+        for (const [name, entitlement] of Object.entries(entitlements)) {
+            // Check if entitlement is active (no expiry or not expired)
+            const isActive = !entitlement.expires_date || new Date(entitlement.expires_date) > now;
+            if (isActive) {
+                activeEntitlements.push(name);
+                // Track earliest purchase date for subscription month calculation
+                const purchaseDate = new Date(entitlement.purchase_date);
+                if (!earliestPurchaseDate || purchaseDate < earliestPurchaseDate) {
+                    earliestPurchaseDate = purchaseDate;
+                }
+            }
+        }
+        // If no active entitlements, return "none"
+        if (activeEntitlements.length === 0) {
+            return {
+                entitlements: [entitlements_1.NONE_ENTITLEMENT],
+                subscriptionStartedAt: null,
+            };
+        }
+        return {
+            entitlements: activeEntitlements,
+            subscriptionStartedAt: earliestPurchaseDate,
+        };
+    }
+}
+exports.RevenueCatHelper = RevenueCatHelper;
+//# sourceMappingURL=RevenueCatHelper.js.map

package/dist/helpers/RevenueCatHelper.d.ts

@@ -0,0 +1,51 @@
+import type { SubscriptionInfo } from "../types/responses";
+/**
+ * Configuration for RevenueCatHelper.
+ */
+export interface RevenueCatHelperConfig {
+    /** RevenueCat API key (secret key for server-side use) */
+    apiKey: string;
+    /** Base URL for RevenueCat API. Defaults to https://api.revenuecat.com/v1 */
+    baseUrl?: string;
+}
+/**
+ * Helper class for interacting with RevenueCat API to get user entitlements
+ * and subscription information.
+ *
+ * @example
+ * ```typescript
+ * const rcHelper = new RevenueCatHelper({
+ *   apiKey: process.env.REVENUECAT_API_KEY!,
+ * });
+ *
+ * // Get just entitlements (for backward compatibility)
+ * const entitlements = await rcHelper.getEntitlements(userId);
+ * // Returns: ["pro"] or ["none"] if no subscription
+ *
+ * // Get full subscription info including start date
+ * const info = await rcHelper.getSubscriptionInfo(userId);
+ * // Returns: { entitlements: ["pro"], subscriptionStartedAt: Date }
+ * ```
+ */
+export declare class RevenueCatHelper {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(config: RevenueCatHelperConfig);
+    /**
+     * Get active entitlement names for a user.
+     *
+     * @param userId - The RevenueCat app_user_id (usually Firebase UID)
+     * @returns Array of active entitlement names, or ["none"] if no active entitlements
+     * @throws Error if RevenueCat API returns an error (other than 404)
+     */
+    getEntitlements(userId: string): Promise<string[]>;
+    /**
+     * Get full subscription info including entitlements and subscription start date.
+     *
+     * @param userId - The RevenueCat app_user_id (usually Firebase UID)
+     * @returns SubscriptionInfo with entitlements and subscriptionStartedAt
+     * @throws Error if RevenueCat API returns an error (other than 404)
+     */
+    getSubscriptionInfo(userId: string): Promise<SubscriptionInfo>;
+}
+//# sourceMappingURL=RevenueCatHelper.d.ts.map

package/dist/helpers/RevenueCatHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RevenueCatHelper.d.ts","sourceRoot":"","sources":["../../src/helpers/RevenueCatHelper.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,sBAAsB;IAK1C;;;;;;OAMG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxD;;;;;;OAMG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA8DrE"}

package/dist/helpers/RevenueCatHelper.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RevenueCatHelper = void 0;
+const entitlements_1 = require("../types/entitlements");
+/**
+ * Helper class for interacting with RevenueCat API to get user entitlements
+ * and subscription information.
+ *
+ * @example
+ * ```typescript
+ * const rcHelper = new RevenueCatHelper({
+ *   apiKey: process.env.REVENUECAT_API_KEY!,
+ * });
+ *
+ * // Get just entitlements (for backward compatibility)
+ * const entitlements = await rcHelper.getEntitlements(userId);
+ * // Returns: ["pro"] or ["none"] if no subscription
+ *
+ * // Get full subscription info including start date
+ * const info = await rcHelper.getSubscriptionInfo(userId);
+ * // Returns: { entitlements: ["pro"], subscriptionStartedAt: Date }
+ * ```
+ */
+class RevenueCatHelper {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? "https://api.revenuecat.com/v1";
+    }
+    /**
+     * Get active entitlement names for a user.
+     *
+     * @param userId - The RevenueCat app_user_id (usually Firebase UID)
+     * @returns Array of active entitlement names, or ["none"] if no active entitlements
+     * @throws Error if RevenueCat API returns an error (other than 404)
+     */
+    async getEntitlements(userId) {
+        const info = await this.getSubscriptionInfo(userId);
+        return info.entitlements;
+    }
+    /**
+     * Get full subscription info including entitlements and subscription start date.
+     *
+     * @param userId - The RevenueCat app_user_id (usually Firebase UID)
+     * @returns SubscriptionInfo with entitlements and subscriptionStartedAt
+     * @throws Error if RevenueCat API returns an error (other than 404)
+     */
+    async getSubscriptionInfo(userId) {
+        const response = await fetch(`${this.baseUrl}/subscribers/${encodeURIComponent(userId)}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        // User not found in RevenueCat - treat as no subscription
+        if (response.status === 404) {
+            return {
+                entitlements: [entitlements_1.NONE_ENTITLEMENT],
+                subscriptionStartedAt: null,
+            };
+        }
+        if (!response.ok) {
+            throw new Error(`RevenueCat API error: ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        const entitlements = data.subscriber?.entitlements ?? {};
+        const now = new Date();
+        const activeEntitlements = [];
+        let earliestPurchaseDate = null;
+        for (const [name, entitlement] of Object.entries(entitlements)) {
+            // Check if entitlement is active (no expiry or not expired)
+            const isActive = !entitlement.expires_date || new Date(entitlement.expires_date) > now;
+            if (isActive) {
+                activeEntitlements.push(name);
+                // Track earliest purchase date for subscription month calculation
+                const purchaseDate = new Date(entitlement.purchase_date);
+                if (!earliestPurchaseDate || purchaseDate < earliestPurchaseDate) {
+                    earliestPurchaseDate = purchaseDate;
+                }
+            }
+        }
+        // If no active entitlements, return "none"
+        if (activeEntitlements.length === 0) {
+            return {
+                entitlements: [entitlements_1.NONE_ENTITLEMENT],
+                subscriptionStartedAt: null,
+            };
+        }
+        return {
+            entitlements: activeEntitlements,
+            subscriptionStartedAt: earliestPurchaseDate,
+        };
+    }
+}
+exports.RevenueCatHelper = RevenueCatHelper;
+//# sourceMappingURL=RevenueCatHelper.js.map

package/dist/helpers/RevenueCatHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RevenueCatHelper.js","sourceRoot":"","sources":["../../src/helpers/RevenueCatHelper.ts"],"names":[],"mappings":";;;AAAA,wDAG+B;AAa/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,gBAAgB;IAI3B,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,+BAA+B,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CAAC,MAAc;QACtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAC3D;YACE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,cAAc,EAAE,kBAAkB;aACnC;SACF,CACF,CAAC;QAEF,0DAA0D;QAC1D,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO;gBACL,YAAY,EAAE,CAAC,+BAAgB,CAAC;gBAChC,qBAAqB,EAAE,IAAI;aAC5B,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiC,CAAC;QACrE,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,IAAI,EAAE,CAAC;QAEzD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,kBAAkB,GAAa,EAAE,CAAC;QACxC,IAAI,oBAAoB,GAAgB,IAAI,CAAC;QAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/D,4DAA4D;YAC5D,MAAM,QAAQ,GACZ,CAAC,WAAW,CAAC,YAAY,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC;YAExE,IAAI,QAAQ,EAAE,CAAC;gBACb,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAE9B,kEAAkE;gBAClE,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;gBACzD,IAAI,CAAC,oBAAoB,IAAI,YAAY,GAAG,oBAAoB,EAAE,CAAC;oBACjE,oBAAoB,GAAG,YAAY,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,YAAY,EAAE,CAAC,+BAAgB,CAAC;gBAChC,qBAAqB,EAAE,IAAI;aAC5B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,YAAY,EAAE,kBAAkB;YAChC,qBAAqB,EAAE,oBAAoB;SAC5C,CAAC;IACJ,CAAC;CACF;AA1FD,4CA0FC"}

package/dist/helpers/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitChecker = exports.EntitlementHelper = exports.RevenueCatHelper = void 0;
+var RevenueCatHelper_1 = require("./RevenueCatHelper");
+Object.defineProperty(exports, "RevenueCatHelper", { enumerable: true, get: function () { return RevenueCatHelper_1.RevenueCatHelper; } });
+var EntitlementHelper_1 = require("./EntitlementHelper");
+Object.defineProperty(exports, "EntitlementHelper", { enumerable: true, get: function () { return EntitlementHelper_1.EntitlementHelper; } });
+var RateLimitChecker_1 = require("./RateLimitChecker");
+Object.defineProperty(exports, "RateLimitChecker", { enumerable: true, get: function () { return RateLimitChecker_1.RateLimitChecker; } });
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.d.ts

@@ -0,0 +1,4 @@
+export { RevenueCatHelper, type RevenueCatHelperConfig, } from "./RevenueCatHelper";
+export { EntitlementHelper } from "./EntitlementHelper";
+export { RateLimitChecker, type RateLimitCheckerConfig, } from "./RateLimitChecker";
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitChecker = exports.EntitlementHelper = exports.RevenueCatHelper = void 0;
+var RevenueCatHelper_1 = require("./RevenueCatHelper");
+Object.defineProperty(exports, "RevenueCatHelper", { enumerable: true, get: function () { return RevenueCatHelper_1.RevenueCatHelper; } });
+var EntitlementHelper_1 = require("./EntitlementHelper");
+Object.defineProperty(exports, "EntitlementHelper", { enumerable: true, get: function () { return EntitlementHelper_1.EntitlementHelper; } });
+var RateLimitChecker_1 = require("./RateLimitChecker");
+Object.defineProperty(exports, "RateLimitChecker", { enumerable: true, get: function () { return RateLimitChecker_1.RateLimitChecker; } });
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;AAAA,uDAG4B;AAF1B,oHAAA,gBAAgB,OAAA;AAGlB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,uDAG4B;AAF1B,oHAAA,gBAAgB,OAAA"}

package/dist/index.cjs

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRateLimitMiddleware = exports.RateLimitRouteHandler = exports.RateLimitChecker = exports.EntitlementHelper = exports.RevenueCatHelper = void 0;
+// Types
+__exportStar(require("./types"), exports);
+// Schema template
+__exportStar(require("./schema/rate-limits"), exports);
+// Helpers
+var RevenueCatHelper_1 = require("./helpers/RevenueCatHelper");
+Object.defineProperty(exports, "RevenueCatHelper", { enumerable: true, get: function () { return RevenueCatHelper_1.RevenueCatHelper; } });
+var EntitlementHelper_1 = require("./helpers/EntitlementHelper");
+Object.defineProperty(exports, "EntitlementHelper", { enumerable: true, get: function () { return EntitlementHelper_1.EntitlementHelper; } });
+var RateLimitChecker_1 = require("./helpers/RateLimitChecker");
+Object.defineProperty(exports, "RateLimitChecker", { enumerable: true, get: function () { return RateLimitChecker_1.RateLimitChecker; } });
+var RateLimitRouteHandler_1 = require("./helpers/RateLimitRouteHandler");
+Object.defineProperty(exports, "RateLimitRouteHandler", { enumerable: true, get: function () { return RateLimitRouteHandler_1.RateLimitRouteHandler; } });
+// Middleware
+var hono_1 = require("./middleware/hono");
+Object.defineProperty(exports, "createRateLimitMiddleware", { enumerable: true, get: function () { return hono_1.createRateLimitMiddleware; } });
+// Utilities
+__exportStar(require("./utils/time"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./types";
+export * from "./schema/rate-limits";
+export { RevenueCatHelper, type RevenueCatHelperConfig, } from "./helpers/RevenueCatHelper";
+export { EntitlementHelper } from "./helpers/EntitlementHelper";
+export { RateLimitChecker, type RateLimitCheckerConfig, } from "./helpers/RateLimitChecker";
+export { RateLimitRouteHandler, type RateLimitRouteHandlerConfig, } from "./helpers/RateLimitRouteHandler";
+export { createRateLimitMiddleware, type RateLimitMiddlewareConfig, } from "./middleware/hono";
+export * from "./utils/time";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,GACjC,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,yBAAyB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAG3B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRateLimitMiddleware = exports.RateLimitRouteHandler = exports.RateLimitChecker = exports.EntitlementHelper = exports.RevenueCatHelper = void 0;
+// Types
+__exportStar(require("./types"), exports);
+// Schema template
+__exportStar(require("./schema/rate-limits"), exports);
+// Helpers
+var RevenueCatHelper_1 = require("./helpers/RevenueCatHelper");
+Object.defineProperty(exports, "RevenueCatHelper", { enumerable: true, get: function () { return RevenueCatHelper_1.RevenueCatHelper; } });
+var EntitlementHelper_1 = require("./helpers/EntitlementHelper");
+Object.defineProperty(exports, "EntitlementHelper", { enumerable: true, get: function () { return EntitlementHelper_1.EntitlementHelper; } });
+var RateLimitChecker_1 = require("./helpers/RateLimitChecker");
+Object.defineProperty(exports, "RateLimitChecker", { enumerable: true, get: function () { return RateLimitChecker_1.RateLimitChecker; } });
+var RateLimitRouteHandler_1 = require("./helpers/RateLimitRouteHandler");
+Object.defineProperty(exports, "RateLimitRouteHandler", { enumerable: true, get: function () { return RateLimitRouteHandler_1.RateLimitRouteHandler; } });
+// Middleware
+var hono_1 = require("./middleware/hono");
+Object.defineProperty(exports, "createRateLimitMiddleware", { enumerable: true, get: function () { return hono_1.createRateLimitMiddleware; } });
+// Utilities
+__exportStar(require("./utils/time"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,0CAAwB;AAExB,kBAAkB;AAClB,uDAAqC;AAErC,UAAU;AACV,+DAGoC;AAFlC,oHAAA,gBAAgB,OAAA;AAGlB,iEAAgE;AAAvD,sHAAA,iBAAiB,OAAA;AAC1B,+DAGoC;AAFlC,oHAAA,gBAAgB,OAAA;AAGlB,yEAGyC;AAFvC,8HAAA,qBAAqB,OAAA;AAIvB,aAAa;AACb,0CAG2B;AAFzB,iHAAA,yBAAyB,OAAA;AAI3B,YAAY;AACZ,+CAA6B"}