clodds 1.1.0

package/dist/farcaster/client.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Farcaster Client (via Neynar API)
+ *
+ * Full Farcaster interaction: read feeds, search, post casts, follow users.
+ * API Docs: https://docs.neynar.com
+ */
+export interface NeynarConfig {
+    apiKey: string;
+    signerUuid?: string;
+    baseUrl?: string;
+}
+export interface FarcasterUser {
+    fid: number;
+    username: string;
+    displayName: string;
+    pfpUrl?: string;
+    bio?: string;
+    followerCount: number;
+    followingCount: number;
+    verifiedAddresses?: {
+        ethAddresses: string[];
+        solAddresses: string[];
+    };
+    activeStatus?: string;
+}
+export interface Cast {
+    hash: string;
+    text: string;
+    author: FarcasterUser;
+    timestamp: string;
+    replies: {
+        count: number;
+    };
+    reactions: {
+        likes: number;
+        recasts: number;
+    };
+    embeds?: Array<{
+        url?: string;
+    }>;
+    parentHash?: string;
+    parentUrl?: string;
+    channel?: {
+        id: string;
+        name: string;
+    };
+}
+export interface Channel {
+    id: string;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    followerCount: number;
+    leadFid?: number;
+}
+export interface FeedOptions {
+    limit?: number;
+    cursor?: string;
+    channel?: string;
+    fid?: number;
+}
+export interface SearchOptions {
+    limit?: number;
+    cursor?: string;
+}
+export interface PostOptions {
+    parentHash?: string;
+    channelId?: string;
+    embeds?: Array<{
+        url: string;
+    }>;
+}
+export declare class NeynarClient {
+    private apiKey;
+    private signerUuid?;
+    private baseUrl;
+    constructor(config: NeynarConfig);
+    getUserByUsername(username: string): Promise<FarcasterUser>;
+    getUserByFid(fid: number): Promise<FarcasterUser>;
+    searchUsers(query: string, limit?: number): Promise<FarcasterUser[]>;
+    getCast(hash: string): Promise<Cast>;
+    getCastsByFid(fid: number, options?: FeedOptions): Promise<Cast[]>;
+    searchCasts(query: string, options?: SearchOptions): Promise<Cast[]>;
+    getHomeFeed(fid: number, options?: FeedOptions): Promise<Cast[]>;
+    getChannelFeed(channelId: string, options?: FeedOptions): Promise<Cast[]>;
+    getTrendingCasts(options?: FeedOptions): Promise<Cast[]>;
+    getChannel(channelId: string): Promise<Channel>;
+    searchChannels(query: string, limit?: number): Promise<Channel[]>;
+    getTrendingChannels(limit?: number): Promise<Channel[]>;
+    postCast(text: string, options?: PostOptions): Promise<Cast>;
+    deleteCast(hash: string): Promise<void>;
+    likeCast(hash: string): Promise<void>;
+    recastCast(hash: string): Promise<void>;
+    followUser(targetFid: number): Promise<void>;
+    unfollowUser(targetFid: number): Promise<void>;
+    private request;
+    private mapUser;
+    private mapCast;
+    private mapChannel;
+}
+export declare function getNeynarClient(config?: NeynarConfig): NeynarClient;

package/dist/farcaster/client.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * Farcaster Client (via Neynar API)
+ *
+ * Full Farcaster interaction: read feeds, search, post casts, follow users.
+ * API Docs: https://docs.neynar.com
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NeynarClient = void 0;
+exports.getNeynarClient = getNeynarClient;
+// =============================================================================
+// Client Implementation
+// =============================================================================
+class NeynarClient {
+    apiKey;
+    signerUuid;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.signerUuid = config.signerUuid;
+        this.baseUrl = config.baseUrl || 'https://api.neynar.com/v2';
+    }
+    // ===========================================================================
+    // Users
+    // ===========================================================================
+    async getUserByUsername(username) {
+        const response = await this.request(`/farcaster/user/by_username?username=${encodeURIComponent(username)}`);
+        return this.mapUser(response.user);
+    }
+    async getUserByFid(fid) {
+        const response = await this.request(`/farcaster/user/bulk?fids=${fid}`);
+        if (!response.users || response.users.length === 0) {
+            throw new Error(`User not found: ${fid}`);
+        }
+        return this.mapUser(response.users[0]);
+    }
+    async searchUsers(query, limit = 10) {
+        const response = await this.request(`/farcaster/user/search?q=${encodeURIComponent(query)}&limit=${limit}`);
+        return (response.result?.users || []).map(this.mapUser);
+    }
+    // ===========================================================================
+    // Casts
+    // ===========================================================================
+    async getCast(hash) {
+        const response = await this.request(`/farcaster/cast?identifier=${hash}&type=hash`);
+        return this.mapCast(response.cast);
+    }
+    async getCastsByFid(fid, options = {}) {
+        const params = new URLSearchParams();
+        params.set('fid', fid.toString());
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        if (options.cursor)
+            params.set('cursor', options.cursor);
+        const response = await this.request(`/farcaster/feed/user/casts?${params}`);
+        return (response.casts || []).map(this.mapCast);
+    }
+    async searchCasts(query, options = {}) {
+        const params = new URLSearchParams();
+        params.set('q', query);
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        if (options.cursor)
+            params.set('cursor', options.cursor);
+        const response = await this.request(`/farcaster/cast/search?${params}`);
+        return (response.result?.casts || []).map(this.mapCast);
+    }
+    // ===========================================================================
+    // Feeds
+    // ===========================================================================
+    async getHomeFeed(fid, options = {}) {
+        const params = new URLSearchParams();
+        params.set('fid', fid.toString());
+        params.set('feed_type', 'following');
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        if (options.cursor)
+            params.set('cursor', options.cursor);
+        const response = await this.request(`/farcaster/feed?${params}`);
+        return (response.casts || []).map(this.mapCast);
+    }
+    async getChannelFeed(channelId, options = {}) {
+        const params = new URLSearchParams();
+        params.set('channel_id', channelId);
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        if (options.cursor)
+            params.set('cursor', options.cursor);
+        const response = await this.request(`/farcaster/feed/channel?${params}`);
+        return (response.casts || []).map(this.mapCast);
+    }
+    async getTrendingCasts(options = {}) {
+        const params = new URLSearchParams();
+        params.set('feed_type', 'filter');
+        params.set('filter_type', 'global_trending');
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        if (options.cursor)
+            params.set('cursor', options.cursor);
+        const response = await this.request(`/farcaster/feed?${params}`);
+        return (response.casts || []).map(this.mapCast);
+    }
+    // ===========================================================================
+    // Channels
+    // ===========================================================================
+    async getChannel(channelId) {
+        const response = await this.request(`/farcaster/channel?id=${encodeURIComponent(channelId)}`);
+        return this.mapChannel(response.channel);
+    }
+    async searchChannels(query, limit = 10) {
+        const response = await this.request(`/farcaster/channel/search?q=${encodeURIComponent(query)}&limit=${limit}`);
+        return (response.channels || []).map(this.mapChannel);
+    }
+    async getTrendingChannels(limit = 10) {
+        const response = await this.request(`/farcaster/channel/trending?limit=${limit}`);
+        return (response.channels || []).map(this.mapChannel);
+    }
+    // ===========================================================================
+    // Write Operations (require signer)
+    // ===========================================================================
+    async postCast(text, options = {}) {
+        if (!this.signerUuid) {
+            throw new Error('Signer UUID required for posting. Set NEYNAR_SIGNER_UUID.');
+        }
+        const body = {
+            signer_uuid: this.signerUuid,
+            text,
+        };
+        if (options.parentHash) {
+            body.parent = options.parentHash;
+        }
+        if (options.channelId) {
+            body.channel_id = options.channelId;
+        }
+        if (options.embeds && options.embeds.length > 0) {
+            body.embeds = options.embeds;
+        }
+        const response = await this.request('/farcaster/cast', {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+        return this.mapCast(response.cast);
+    }
+    async deleteCast(hash) {
+        if (!this.signerUuid) {
+            throw new Error('Signer UUID required for deleting.');
+        }
+        await this.request('/farcaster/cast', {
+            method: 'DELETE',
+            body: JSON.stringify({
+                signer_uuid: this.signerUuid,
+                target_hash: hash,
+            }),
+        });
+    }
+    async likeCast(hash) {
+        if (!this.signerUuid) {
+            throw new Error('Signer UUID required for reactions.');
+        }
+        await this.request('/farcaster/reaction', {
+            method: 'POST',
+            body: JSON.stringify({
+                signer_uuid: this.signerUuid,
+                reaction_type: 'like',
+                target: hash,
+            }),
+        });
+    }
+    async recastCast(hash) {
+        if (!this.signerUuid) {
+            throw new Error('Signer UUID required for reactions.');
+        }
+        await this.request('/farcaster/reaction', {
+            method: 'POST',
+            body: JSON.stringify({
+                signer_uuid: this.signerUuid,
+                reaction_type: 'recast',
+                target: hash,
+            }),
+        });
+    }
+    async followUser(targetFid) {
+        if (!this.signerUuid) {
+            throw new Error('Signer UUID required for following.');
+        }
+        await this.request('/farcaster/user/follow', {
+            method: 'POST',
+            body: JSON.stringify({
+                signer_uuid: this.signerUuid,
+                target_fids: [targetFid],
+            }),
+        });
+    }
+    async unfollowUser(targetFid) {
+        if (!this.signerUuid) {
+            throw new Error('Signer UUID required for unfollowing.');
+        }
+        await this.request('/farcaster/user/follow', {
+            method: 'DELETE',
+            body: JSON.stringify({
+                signer_uuid: this.signerUuid,
+                target_fids: [targetFid],
+            }),
+        });
+    }
+    // ===========================================================================
+    // Internal
+    // ===========================================================================
+    async request(path, options = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                accept: 'application/json',
+                api_key: this.apiKey,
+                'Content-Type': 'application/json',
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({}));
+            throw new Error(error.message || `Neynar API error: ${response.status}`);
+        }
+        return response.json();
+    }
+    mapUser = (u) => ({
+        fid: u.fid,
+        username: u.username,
+        displayName: u.display_name || u.username,
+        pfpUrl: u.pfp_url,
+        bio: u.profile?.bio?.text,
+        followerCount: u.follower_count || 0,
+        followingCount: u.following_count || 0,
+        verifiedAddresses: u.verified_addresses,
+        activeStatus: u.active_status,
+    });
+    mapCast = (c) => ({
+        hash: c.hash,
+        text: c.text,
+        author: this.mapUser(c.author),
+        timestamp: c.timestamp,
+        replies: { count: c.replies?.count || 0 },
+        reactions: {
+            likes: c.reactions?.likes_count || 0,
+            recasts: c.reactions?.recasts_count || 0,
+        },
+        embeds: c.embeds,
+        parentHash: c.parent_hash,
+        parentUrl: c.parent_url,
+        channel: c.channel ? { id: c.channel.id, name: c.channel.name } : undefined,
+    });
+    mapChannel = (ch) => ({
+        id: ch.id,
+        name: ch.name,
+        description: ch.description,
+        imageUrl: ch.image_url,
+        followerCount: ch.follower_count || 0,
+        leadFid: ch.lead?.fid,
+    });
+}
+exports.NeynarClient = NeynarClient;
+// =============================================================================
+// Factory
+// =============================================================================
+let defaultClient = null;
+function getNeynarClient(config) {
+    if (config) {
+        return new NeynarClient(config);
+    }
+    if (!defaultClient) {
+        const apiKey = process.env.NEYNAR_API_KEY;
+        if (!apiKey) {
+            throw new Error('NEYNAR_API_KEY environment variable not set');
+        }
+        defaultClient = new NeynarClient({
+            apiKey,
+            signerUuid: process.env.NEYNAR_SIGNER_UUID,
+        });
+    }
+    return defaultClient;
+}
+//# sourceMappingURL=client.js.map

package/dist/farcaster/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/farcaster/client.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA2WH,0CAiBC;AAvTD,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,MAAa,YAAY;IACf,MAAM,CAAS;IACf,UAAU,CAAU;IACpB,OAAO,CAAS;IAExB,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,2BAA2B,CAAC;IAC/D,CAAC;IAED,8EAA8E;IAC9E,QAAQ;IACR,8EAA8E;IAE9E,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,wCAAwC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5G,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,QAAgB,EAAE;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,4BAA4B,kBAAkB,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;QAC5G,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,8EAA8E;IAC9E,QAAQ;IACR,8EAA8E;IAE9E,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,8BAA8B,IAAI,YAAY,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,UAAuB,EAAE;QACxD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClC,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,UAAyB,EAAE;QAC1D,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,8EAA8E;IAC9E,QAAQ;IACR,8EAA8E;IAE9E,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,UAAuB,EAAE;QACtD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,UAAuB,EAAE;QAC/D,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACpC,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAuB,EAAE;QAC9C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,8EAA8E;IAC9E,WAAW;IACX,8EAA8E;IAE9E,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,QAAgB,EAAE;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,kBAAkB,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;QAC/G,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,QAAgB,EAAE;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,8EAA8E;IAC9E,oCAAoC;IACpC,8EAA8E;IAE9E,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,UAAuB,EAAE;QACpD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,IAAI,GAAQ;YAChB,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,IAAI;SACL,CAAC;QAEF,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;QACnC,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACtC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;YACpC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,WAAW,EAAE,IAAI,CAAC,UAAU;gBAC5B,WAAW,EAAE,IAAI;aAClB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,WAAW,EAAE,IAAI,CAAC,UAAU;gBAC5B,aAAa,EAAE,MAAM;gBACrB,MAAM,EAAE,IAAI;aACb,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,WAAW,EAAE,IAAI,CAAC,UAAU;gBAC5B,aAAa,EAAE,QAAQ;gBACvB,MAAM,EAAE,IAAI;aACb,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE;YAC3C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,WAAW,EAAE,IAAI,CAAC,UAAU;gBAC5B,WAAW,EAAE,CAAC,SAAS,CAAC;aACzB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE;YAC3C,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,WAAW,EAAE,IAAI,CAAC,UAAU;gBAC5B,WAAW,EAAE,CAAC,SAAS,CAAC;aACzB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,WAAW;IACX,8EAA8E;IAEtE,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,UAAuB,EAAE;QAC3D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAErC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,OAAO,EAAE,IAAI,CAAC,MAAM;gBACpB,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,CAAC,OAAO;aACnB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAyB,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,qBAAqB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAEO,OAAO,GAAG,CAAC,CAAM,EAAiB,EAAE,CAAC,CAAC;QAC5C,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,WAAW,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,QAAQ;QACzC,MAAM,EAAE,CAAC,CAAC,OAAO;QACjB,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI;QACzB,aAAa,EAAE,CAAC,CAAC,cAAc,IAAI,CAAC;QACpC,cAAc,EAAE,CAAC,CAAC,eAAe,IAAI,CAAC;QACtC,iBAAiB,EAAE,CAAC,CAAC,kBAAkB;QACvC,YAAY,EAAE,CAAC,CAAC,aAAa;KAC9B,CAAC,CAAC;IAEK,OAAO,GAAG,CAAC,CAAM,EAAQ,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,EAAE;QACzC,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,IAAI,CAAC;YACpC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,aAAa,IAAI,CAAC;SACzC;QACD,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,WAAW;QACzB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC,CAAC;IAEK,UAAU,GAAG,CAAC,EAAO,EAAW,EAAE,CAAC,CAAC;QAC1C,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,QAAQ,EAAE,EAAE,CAAC,SAAS;QACtB,aAAa,EAAE,EAAE,CAAC,cAAc,IAAI,CAAC;QACrC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG;KACtB,CAAC,CAAC;CACJ;AA1RD,oCA0RC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,IAAI,aAAa,GAAwB,IAAI,CAAC;AAE9C,SAAgB,eAAe,CAAC,MAAqB;IACnD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,aAAa,GAAG,IAAI,YAAY,CAAC;YAC/B,MAAM;YACN,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/farcaster/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Farcaster Module (via Neynar API)
+ */
+export * from './client';

package/dist/farcaster/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Farcaster Module (via Neynar API)
+ */
+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 });
+__exportStar(require("./client"), exports);
+//# sourceMappingURL=index.js.map

package/dist/farcaster/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/farcaster/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,2CAAyB"}

package/dist/feeds/acled/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * ACLED (Armed Conflict Location & Event Data) Feed
+ *
+ * Real-time conflict, protest, and political violence event tracking worldwide.
+ * Requires API key (free for researchers/journalists).
+ *
+ * API docs: https://apidocs.acleddata.com
+ */
+import { EventEmitter } from 'events';
+export interface ACLEDEvent {
+    eventId: string;
+    eventDate: Date;
+    year: number;
+    eventType: ACLEDEventType;
+    subEventType: string;
+    actor1: string;
+    actor2: string;
+    interaction: number;
+    region: string;
+    country: string;
+    admin1: string;
+    admin2: string;
+    admin3: string;
+    location: string;
+    latitude: number;
+    longitude: number;
+    source: string;
+    sourceScale: string;
+    notes: string;
+    fatalities: number;
+    timestamp: Date;
+    tags?: string[];
+}
+export type ACLEDEventType = 'Battles' | 'Explosions/Remote violence' | 'Violence against civilians' | 'Protests' | 'Riots' | 'Strategic developments';
+export interface ACLEDQuery {
+    /** ISO country code or country name */
+    country?: string;
+    /** Region name (e.g. 'Middle East', 'Eastern Africa') */
+    region?: string;
+    /** Filter by event type */
+    eventType?: ACLEDEventType;
+    /** Start date (YYYY-MM-DD) */
+    startDate?: string;
+    /** End date (YYYY-MM-DD) */
+    endDate?: string;
+    /** Minimum fatalities */
+    minFatalities?: number;
+    /** Full-text search in notes */
+    keyword?: string;
+    /** Max results (default 500, max 5000) */
+    limit?: number;
+}
+export interface ACLEDSummary {
+    country: string;
+    totalEvents: number;
+    totalFatalities: number;
+    byType: Record<string, {
+        count: number;
+        fatalities: number;
+    }>;
+    period: {
+        start: string;
+        end: string;
+    };
+}
+export interface ACLEDFeed extends EventEmitter {
+    start(): Promise<void>;
+    stop(): void;
+    /** Query conflict events with filters */
+    getEvents(query: ACLEDQuery): Promise<ACLEDEvent[]>;
+    /** Get a summary of events for a country/region in a date range */
+    getSummary(country: string, startDate: string, endDate: string): Promise<ACLEDSummary>;
+    /** Get the latest events worldwide (last 7 days) */
+    getLatest(limit?: number): Promise<ACLEDEvent[]>;
+    /** Get events near a lat/lon within a radius (km) */
+    getNearby(lat: number, lon: number, radiusKm: number, limit?: number): Promise<ACLEDEvent[]>;
+    /** List available countries */
+    getCountries(): Promise<string[]>;
+    /** Get fatality trends for a country (monthly aggregates) */
+    getTrends(country: string, months?: number): Promise<Array<{
+        month: string;
+        events: number;
+        fatalities: number;
+    }>>;
+}
+export declare function createACLEDFeed(): Promise<ACLEDFeed>;