@pegasusheavy/threads-mcp 1.0.0

package/dist/types/threads.d.ts

@@ -0,0 +1,298 @@
+import { z } from 'zod';
+export declare const ThreadsUserSchema: z.ZodObject<{
+    id: z.ZodString;
+    username: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    threads_profile_picture_url: z.ZodOptional<z.ZodString>;
+    threads_biography: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    username: string;
+    name?: string | undefined;
+    threads_profile_picture_url?: string | undefined;
+    threads_biography?: string | undefined;
+}, {
+    id: string;
+    username: string;
+    name?: string | undefined;
+    threads_profile_picture_url?: string | undefined;
+    threads_biography?: string | undefined;
+}>;
+export declare const ThreadsMediaSchema: z.ZodObject<{
+    id: z.ZodString;
+    media_product_type: z.ZodString;
+    media_type: z.ZodEnum<["TEXT", "IMAGE", "VIDEO", "CAROUSEL_ALBUM"]>;
+    media_url: z.ZodOptional<z.ZodString>;
+    permalink: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    shortcode: z.ZodOptional<z.ZodString>;
+    thumbnail_url: z.ZodOptional<z.ZodString>;
+    children: z.ZodOptional<z.ZodObject<{
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        data: {
+            id: string;
+        }[];
+    }, {
+        data: {
+            id: string;
+        }[];
+    }>>;
+    is_quote_post: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    media_product_type: string;
+    media_type: "TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL_ALBUM";
+    permalink: string;
+    timestamp: string;
+    username?: string | undefined;
+    media_url?: string | undefined;
+    text?: string | undefined;
+    shortcode?: string | undefined;
+    thumbnail_url?: string | undefined;
+    children?: {
+        data: {
+            id: string;
+        }[];
+    } | undefined;
+    is_quote_post?: boolean | undefined;
+}, {
+    id: string;
+    media_product_type: string;
+    media_type: "TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL_ALBUM";
+    permalink: string;
+    timestamp: string;
+    username?: string | undefined;
+    media_url?: string | undefined;
+    text?: string | undefined;
+    shortcode?: string | undefined;
+    thumbnail_url?: string | undefined;
+    children?: {
+        data: {
+            id: string;
+        }[];
+    } | undefined;
+    is_quote_post?: boolean | undefined;
+}>;
+export declare const ThreadsInsightsSchema: z.ZodObject<{
+    name: z.ZodString;
+    period: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+        value: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+    }, {
+        value: number;
+    }>, "many">;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    values: {
+        value: number;
+    }[];
+    period: string;
+    id?: string | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+}, {
+    name: string;
+    values: {
+        value: number;
+    }[];
+    period: string;
+    id?: string | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+}>;
+export declare const ThreadsRepliesSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        permalink: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }, {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }>, "many">;
+    paging: z.ZodOptional<z.ZodObject<{
+        cursors: z.ZodObject<{
+            before: z.ZodOptional<z.ZodString>;
+            after: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            before?: string | undefined;
+            after?: string | undefined;
+        }, {
+            before?: string | undefined;
+            after?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    }, {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }[];
+    paging?: {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    } | undefined;
+}, {
+    data: {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }[];
+    paging?: {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    } | undefined;
+}>;
+export declare const ThreadsConversationSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        permalink: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }, {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }>, "many">;
+    paging: z.ZodOptional<z.ZodObject<{
+        cursors: z.ZodObject<{
+            before: z.ZodOptional<z.ZodString>;
+            after: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            before?: string | undefined;
+            after?: string | undefined;
+        }, {
+            before?: string | undefined;
+            after?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    }, {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }[];
+    paging?: {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    } | undefined;
+}, {
+    data: {
+        id: string;
+        username?: string | undefined;
+        permalink?: string | undefined;
+        text?: string | undefined;
+        timestamp?: string | undefined;
+    }[];
+    paging?: {
+        cursors: {
+            before?: string | undefined;
+            after?: string | undefined;
+        };
+    } | undefined;
+}>;
+export declare const CreateThreadResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type ThreadsUser = z.infer<typeof ThreadsUserSchema>;
+export type ThreadsMedia = z.infer<typeof ThreadsMediaSchema>;
+export type ThreadsInsights = z.infer<typeof ThreadsInsightsSchema>;
+export type ThreadsReplies = z.infer<typeof ThreadsRepliesSchema>;
+export type ThreadsConversation = z.infer<typeof ThreadsConversationSchema>;
+export type CreateThreadResponse = z.infer<typeof CreateThreadResponseSchema>;
+export interface ThreadsConfig {
+    accessToken: string;
+    userId: string;
+    apiVersion?: string;
+}
+export type { ThreadsConfig as ThreadsClientConfig };
+export interface CreateThreadParams {
+    text?: string;
+    imageUrl?: string;
+    videoUrl?: string;
+    replyToId?: string;
+    replyControl?: 'everyone' | 'accounts_you_follow' | 'mentioned_only';
+}
+export interface GetMediaParams {
+    fields?: string[];
+    limit?: number;
+}
+export interface GetInsightsParams {
+    metric: string[];
+    since?: number;
+    until?: number;
+}
+export interface GetRepliesParams {
+    fields?: string[];
+    reverse?: boolean;
+}
+//# sourceMappingURL=threads.d.ts.map

package/dist/types/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/types/threads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;EAErC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,YAAY,EAAE,aAAa,IAAI,mBAAmB,EAAE,CAAC;AAGrD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,UAAU,GAAG,qBAAqB,GAAG,gBAAgB,CAAC;CACtE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/threads.js

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export const ThreadsUserSchema = z.object({
+    id: z.string(),
+    username: z.string(),
+    name: z.string().optional(),
+    threads_profile_picture_url: z.string().optional(),
+    threads_biography: z.string().optional(),
+});
+export const ThreadsMediaSchema = z.object({
+    id: z.string(),
+    media_product_type: z.string(),
+    media_type: z.enum(['TEXT', 'IMAGE', 'VIDEO', 'CAROUSEL_ALBUM']),
+    media_url: z.string().optional(),
+    permalink: z.string(),
+    username: z.string().optional(),
+    text: z.string().optional(),
+    timestamp: z.string(),
+    shortcode: z.string().optional(),
+    thumbnail_url: z.string().optional(),
+    children: z
+        .object({
+        data: z.array(z.object({
+            id: z.string(),
+        })),
+    })
+        .optional(),
+    is_quote_post: z.boolean().optional(),
+});
+export const ThreadsInsightsSchema = z.object({
+    name: z.string(),
+    period: z.string(),
+    values: z.array(z.object({
+        value: z.number(),
+    })),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    id: z.string().optional(),
+});
+export const ThreadsRepliesSchema = z.object({
+    data: z.array(z.object({
+        id: z.string(),
+        text: z.string().optional(),
+        username: z.string().optional(),
+        permalink: z.string().optional(),
+        timestamp: z.string().optional(),
+    })),
+    paging: z
+        .object({
+        cursors: z.object({
+            before: z.string().optional(),
+            after: z.string().optional(),
+        }),
+    })
+        .optional(),
+});
+export const ThreadsConversationSchema = z.object({
+    data: z.array(z.object({
+        id: z.string(),
+        text: z.string().optional(),
+        username: z.string().optional(),
+        permalink: z.string().optional(),
+        timestamp: z.string().optional(),
+    })),
+    paging: z
+        .object({
+        cursors: z.object({
+            before: z.string().optional(),
+            after: z.string().optional(),
+        }),
+    })
+        .optional(),
+});
+export const CreateThreadResponseSchema = z.object({
+    id: z.string(),
+});
+//# sourceMappingURL=threads.js.map

package/dist/types/threads.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,42 @@
+export interface CacheOptions {
+    ttl?: number;
+    maxSize?: number;
+    onEvict?: (key: string, value: any) => void;
+}
+export declare class Cache<T = any> {
+    private cache;
+    private readonly ttl;
+    private readonly maxSize;
+    private readonly onEvict?;
+    constructor(options?: CacheOptions);
+    get(key: string): T | undefined;
+    set(key: string, value: T, ttl?: number): void;
+    delete(key: string): boolean;
+    has(key: string): boolean;
+    clear(): void;
+    size(): number;
+    private evictLRU;
+    cleanExpired(): void;
+    keys(): string[];
+    stats(): {
+        size: number;
+        maxSize: number;
+        ttl: number;
+        entries: {
+            key: string;
+            expiresIn: number;
+            lastAccessed: number;
+        }[];
+    };
+}
+export declare function Cached(cache: Cache, keyGenerator?: (...args: any[]) => string): (_target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare class AutoCleanCache<T = any> extends Cache<T> {
+    private cleanupInterval;
+    constructor(options?: CacheOptions & {
+        cleanupIntervalMs?: number;
+    });
+    private startCleanup;
+    stopCleanup(): void;
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CAC7C;AAQD,qBAAa,KAAK,CAAC,CAAC,GAAG,GAAG;IACxB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkC;gBAE/C,OAAO,GAAE,YAAiB;IAUtC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAqB/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAmB9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAiBzB,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,MAAM;IAOd,OAAO,CAAC,QAAQ;IAmBhB,YAAY,IAAI,IAAI;IAgBpB,IAAI,IAAI,MAAM,EAAE;IAOhB,KAAK,IAAI;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACrE;CAeF;AAKD,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,IAE1E,SAAS,GAAG,EACZ,aAAa,MAAM,EACnB,YAAY,kBAAkB,wBAuBjC;AAKD,qBAAa,cAAc,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,eAAe,CAA+B;gBAE1C,OAAO,GAAE,YAAY,GAAG;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO;IAUvE,OAAO,CAAC,YAAY;IASpB,WAAW,IAAI,IAAI;IAUV,KAAK,IAAI,IAAI;CAIvB"}

package/dist/utils/cache.js

@@ -0,0 +1,147 @@
+export class Cache {
+    cache;
+    ttl;
+    maxSize;
+    onEvict;
+    constructor(options = {}) {
+        this.cache = new Map();
+        this.ttl = options.ttl || 60000;
+        this.maxSize = options.maxSize || 1000;
+        this.onEvict = options.onEvict;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (Date.now() > entry.expires) {
+            this.delete(key);
+            return undefined;
+        }
+        entry.lastAccessed = Date.now();
+        return entry.value;
+    }
+    set(key, value, ttl) {
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            this.evictLRU();
+        }
+        const expiresIn = ttl || this.ttl;
+        const entry = {
+            value,
+            expires: Date.now() + expiresIn,
+            lastAccessed: Date.now(),
+        };
+        this.cache.set(key, entry);
+    }
+    delete(key) {
+        const entry = this.cache.get(key);
+        if (entry && this.onEvict) {
+            this.onEvict(key, entry.value);
+        }
+        return this.cache.delete(key);
+    }
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        if (Date.now() > entry.expires) {
+            this.delete(key);
+            return false;
+        }
+        return true;
+    }
+    clear() {
+        if (this.onEvict) {
+            this.cache.forEach((entry, key) => {
+                this.onEvict(key, entry.value);
+            });
+        }
+        this.cache.clear();
+    }
+    size() {
+        return this.cache.size;
+    }
+    evictLRU() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        this.cache.forEach((entry, key) => {
+            if (entry.lastAccessed < oldestTime) {
+                oldestTime = entry.lastAccessed;
+                oldestKey = key;
+            }
+        });
+        if (oldestKey) {
+            this.delete(oldestKey);
+        }
+    }
+    cleanExpired() {
+        const now = Date.now();
+        const keysToDelete = [];
+        this.cache.forEach((entry, key) => {
+            if (now > entry.expires) {
+                keysToDelete.push(key);
+            }
+        });
+        keysToDelete.forEach((key) => this.delete(key));
+    }
+    keys() {
+        return Array.from(this.cache.keys());
+    }
+    stats() {
+        const now = Date.now();
+        const entries = Array.from(this.cache.entries()).map(([key, entry]) => ({
+            key,
+            expiresIn: entry.expires - now,
+            lastAccessed: now - entry.lastAccessed,
+        }));
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            ttl: this.ttl,
+            entries,
+        };
+    }
+}
+export function Cached(cache, keyGenerator) {
+    return function (_target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const cacheKey = keyGenerator
+                ? keyGenerator(...args)
+                : `${propertyKey}:${JSON.stringify(args)}`;
+            const cached = cache.get(cacheKey);
+            if (cached !== undefined) {
+                return cached;
+            }
+            const result = await originalMethod.apply(this, args);
+            cache.set(cacheKey, result);
+            return result;
+        };
+        return descriptor;
+    };
+}
+export class AutoCleanCache extends Cache {
+    cleanupInterval = null;
+    constructor(options = {}) {
+        super(options);
+        const cleanupIntervalMs = options.cleanupIntervalMs || 60000;
+        this.startCleanup(cleanupIntervalMs);
+    }
+    startCleanup(intervalMs) {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanExpired();
+        }, intervalMs);
+    }
+    stopCleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+    clear() {
+        this.stopCleanup();
+        super.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,31 @@
+export interface RateLimiterOptions {
+    maxTokens: number;
+    refillRate: number;
+    refillInterval?: number;
+}
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private readonly refillInterval;
+    constructor(options: RateLimiterOptions);
+    private refill;
+    tryConsume(tokens?: number): boolean;
+    consume(tokens?: number): Promise<void>;
+    getWaitTime(tokens?: number): number;
+    getTokens(): number;
+    reset(): void;
+}
+export declare class RateLimiterManager {
+    private limiters;
+    constructor();
+    register(endpoint: string, options: RateLimiterOptions): void;
+    tryConsume(endpoint: string, tokens?: number): boolean;
+    consume(endpoint: string, tokens?: number): Promise<void>;
+    getWaitTime(endpoint: string, tokens?: number): number;
+    reset(endpoint: string): void;
+    resetAll(): void;
+}
+export declare function RateLimited(limiter: RateLimiter, tokens?: number): (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,EAAE,kBAAkB;IAWvC,OAAO,CAAC,MAAM;IAed,UAAU,CAAC,MAAM,GAAE,MAAU,GAAG,OAAO;IAejC,OAAO,CAAC,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhD,WAAW,CAAC,MAAM,GAAE,MAAU,GAAG,MAAM;IAevC,SAAS,IAAI,MAAM;IAQnB,KAAK,IAAI,IAAI;CAId;AAKD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA2B;;IAS3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAO7D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO;IAWnD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM;IAQzD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU7B,QAAQ,IAAI,IAAI;CAGjB;AAKD,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,MAAU,IAEhE,SAAS,GAAG,EACZ,cAAc,MAAM,EACpB,YAAY,kBAAkB,wBAWjC"}