@auxiora/connector-social 1.0.0

package/dist/twitter.js

@@ -0,0 +1,245 @@
+import { defineConnector } from '@auxiora/connectors';
+async function twitterFetch(token, path, options) {
+    const res = await fetch(`https://api.twitter.com/2${path}`, {
+        method: options?.method ?? 'GET',
+        headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' },
+        body: options?.body ? JSON.stringify(options.body) : undefined,
+    });
+    if (!res.ok)
+        throw new Error(`Twitter API error: ${res.status} ${await res.text().catch(() => res.statusText)}`);
+    return res.json();
+}
+async function getMyUserId(token) {
+    const res = await twitterFetch(token, '/users/me');
+    const data = res.data;
+    return data.id;
+}
+export const twitterConnector = defineConnector({
+    id: 'twitter',
+    name: 'Twitter / X',
+    description: 'Integration with Twitter/X for tweets, mentions, and direct messages',
+    version: '1.0.0',
+    category: 'social',
+    icon: 'twitter',
+    auth: {
+        type: 'oauth2',
+        oauth2: {
+            authUrl: 'https://twitter.com/i/oauth2/authorize',
+            tokenUrl: 'https://api.twitter.com/2/oauth2/token',
+            scopes: ['tweet.read', 'tweet.write', 'users.read', 'dm.read', 'dm.write', 'offline.access'],
+        },
+    },
+    actions: [
+        {
+            id: 'timeline-read',
+            name: 'Read Timeline',
+            description: 'Read the authenticated user timeline',
+            trustMinimum: 1,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: false,
+            params: {},
+        },
+        {
+            id: 'mentions-list',
+            name: 'List Mentions',
+            description: 'List recent mentions of the authenticated user',
+            trustMinimum: 1,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: false,
+            params: {},
+        },
+        {
+            id: 'post-tweet',
+            name: 'Post Tweet',
+            description: 'Post a new tweet',
+            trustMinimum: 3,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: true,
+            params: {
+                text: { type: 'string', description: 'Tweet text', required: true },
+            },
+        },
+        {
+            id: 'reply-tweet',
+            name: 'Reply to Tweet',
+            description: 'Reply to an existing tweet',
+            trustMinimum: 3,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: true,
+            params: {
+                tweetId: { type: 'string', description: 'Tweet ID to reply to', required: true },
+                text: { type: 'string', description: 'Reply text', required: true },
+            },
+        },
+        {
+            id: 'delete-tweet',
+            name: 'Delete Tweet',
+            description: 'Delete an existing tweet',
+            trustMinimum: 3,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: true,
+            params: {
+                tweetId: { type: 'string', description: 'Tweet ID to delete', required: true },
+            },
+        },
+        {
+            id: 'search-tweets',
+            name: 'Search Tweets',
+            description: 'Search for tweets matching a query',
+            trustMinimum: 1,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: false,
+            params: {
+                query: { type: 'string', description: 'Search query', required: true },
+            },
+        },
+        {
+            id: 'dm-list',
+            name: 'List Direct Messages',
+            description: 'List recent direct messages',
+            trustMinimum: 1,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: false,
+            params: {},
+        },
+        {
+            id: 'dm-send',
+            name: 'Send Direct Message',
+            description: 'Send a direct message to a user',
+            trustMinimum: 3,
+            trustDomain: 'messaging',
+            reversible: false,
+            sideEffects: true,
+            params: {
+                recipientId: { type: 'string', description: 'Recipient user ID', required: true },
+                text: { type: 'string', description: 'Message text', required: true },
+            },
+        },
+    ],
+    triggers: [
+        {
+            id: 'new-mention',
+            name: 'New Mention',
+            description: 'Triggered when the user is mentioned in a tweet',
+            type: 'poll',
+            pollIntervalMs: 60_000,
+        },
+        {
+            id: 'new-dm',
+            name: 'New Direct Message',
+            description: 'Triggered when a new direct message is received',
+            type: 'poll',
+            pollIntervalMs: 120_000,
+        },
+    ],
+    entities: [
+        {
+            id: 'tweet',
+            name: 'Tweet',
+            description: 'A tweet on Twitter/X',
+            fields: { id: 'string', text: 'string', authorId: 'string', createdAt: 'string', likeCount: 'number', retweetCount: 'number' },
+        },
+        {
+            id: 'direct-message',
+            name: 'Direct Message',
+            description: 'A direct message on Twitter/X',
+            fields: { id: 'string', text: 'string', senderId: 'string', createdAt: 'string' },
+        },
+    ],
+    async executeAction(actionId, params, token) {
+        switch (actionId) {
+            case 'timeline-read': {
+                const userId = await getMyUserId(token);
+                const res = await twitterFetch(token, `/users/${userId}/timelines/reverse_chronological`);
+                return { tweets: res.data };
+            }
+            case 'mentions-list': {
+                const userId = await getMyUserId(token);
+                const res = await twitterFetch(token, `/users/${userId}/mentions`);
+                return { mentions: res.data };
+            }
+            case 'post-tweet': {
+                const res = await twitterFetch(token, '/tweets', {
+                    method: 'POST',
+                    body: { text: params.text },
+                });
+                const data = res.data;
+                return { tweetId: data.id, status: 'posted' };
+            }
+            case 'reply-tweet': {
+                const res = await twitterFetch(token, '/tweets', {
+                    method: 'POST',
+                    body: { text: params.text, reply: { in_reply_to_tweet_id: params.tweetId } },
+                });
+                const data = res.data;
+                return { tweetId: data.id, status: 'replied' };
+            }
+            case 'delete-tweet': {
+                await twitterFetch(token, `/tweets/${params.tweetId}`, { method: 'DELETE' });
+                return { tweetId: params.tweetId, status: 'deleted' };
+            }
+            case 'search-tweets': {
+                const query = encodeURIComponent(params.query);
+                const res = await twitterFetch(token, `/tweets/search/recent?query=${query}`);
+                return { tweets: res.data };
+            }
+            case 'dm-list': {
+                const res = await twitterFetch(token, '/dm_events');
+                return { messages: res.data };
+            }
+            case 'dm-send': {
+                const res = await twitterFetch(token, `/dm_conversations/with/${params.recipientId}/messages`, {
+                    method: 'POST',
+                    body: { text: params.text },
+                });
+                const data = res.data;
+                return { messageId: data.dm_event_id ?? data.id, status: 'sent' };
+            }
+            default:
+                throw new Error(`Unknown action: ${actionId}`);
+        }
+    },
+    async pollTrigger(triggerId, token, lastPollAt) {
+        switch (triggerId) {
+            case 'new-mention': {
+                const userId = await getMyUserId(token);
+                const startTime = lastPollAt ? new Date(lastPollAt).toISOString() : undefined;
+                const query = startTime ? `?start_time=${startTime}` : '';
+                const res = await twitterFetch(token, `/users/${userId}/mentions${query}`);
+                const mentions = (res.data ?? []);
+                return mentions.map((m) => ({
+                    triggerId: 'new-mention',
+                    connectorId: 'twitter',
+                    data: m,
+                    timestamp: m.created_at ? new Date(m.created_at).getTime() : Date.now(),
+                }));
+            }
+            case 'new-dm': {
+                const res = await twitterFetch(token, '/dm_events?event_types=MessageCreate');
+                const events = (res.data ?? []);
+                const cutoff = lastPollAt ?? 0;
+                return events
+                    .filter((e) => {
+                    const ts = e.created_at ? new Date(e.created_at).getTime() : 0;
+                    return ts > cutoff;
+                })
+                    .map((e) => ({
+                    triggerId: 'new-dm',
+                    connectorId: 'twitter',
+                    data: e,
+                    timestamp: e.created_at ? new Date(e.created_at).getTime() : Date.now(),
+                }));
+            }
+            default:
+                return [];
+        }
+    },
+});
+//# sourceMappingURL=twitter.js.map

package/dist/twitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter.js","sourceRoot":"","sources":["../src/twitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,KAAK,UAAU,YAAY,CAAC,KAAa,EAAE,IAAY,EAAE,OAA6C;IACpG,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,4BAA4B,IAAI,EAAE,EAAE;QAC1D,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;QAChC,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,KAAK,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QACnF,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC/D,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACjH,OAAO,GAAG,CAAC,IAAI,EAAsC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,KAAa;IACtC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;IACjD,OAAO,IAAI,CAAC,EAAY,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;IAC9C,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,sEAAsE;IACnF,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,SAAS;IAEf,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE;YACN,OAAO,EAAE,wCAAwC;YACjD,QAAQ,EAAE,wCAAwC;YAClD,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,CAAC;SAC7F;KACF;IAED,OAAO,EAAE;QACP;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,sCAAsC;YACnD,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,EAAE;SACX;QACD;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,gDAAgD;YAC7D,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,EAAE;SACX;QACD;YACE,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,kBAAkB;YAC/B,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE;aACpE;SACF;QACD;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,4BAA4B;YACzC,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE;gBACN,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAChF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE;aACpE;SACF;QACD;YACE,EAAE,EAAE,cAAc;YAClB,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,0BAA0B;YACvC,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE;gBACN,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC/E;SACF;QACD;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,oCAAoC;YACjD,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE;gBACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;aACvE;SACF;QACD;YACE,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,6BAA6B;YAC1C,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,EAAE;SACX;QACD;YACE,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,iCAAiC;YAC9C,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE;gBACN,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACjF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;aACtE;SACF;KACF;IAED,QAAQ,EAAE;QACR;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,iDAAiD;YAC9D,IAAI,EAAE,MAAM;YACZ,cAAc,EAAE,MAAM;SACvB;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,iDAAiD;YAC9D,IAAI,EAAE,MAAM;YACZ,cAAc,EAAE,OAAO;SACxB;KACF;IAED,QAAQ,EAAE;QACR;YACE,EAAE,EAAE,OAAO;YACX,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,sBAAsB;YACnC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE;SAC/H;QACD;YACE,EAAE,EAAE,gBAAgB;YACpB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,+BAA+B;YAC5C,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;SAClF;KACF;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,MAA+B,EAAE,KAAa;QAClF,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;gBACxC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,MAAM,kCAAkC,CAAC,CAAC;gBAC1F,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;gBACxC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,MAAM,WAAW,CAAC,CAAC;gBACnE,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE;oBAC/C,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;iBAC5B,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;gBACjD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAChD,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE;oBAC/C,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,oBAAoB,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE;iBAC7E,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;gBACjD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACjD,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,YAAY,CAAC,KAAK,EAAE,WAAW,MAAM,CAAC,OAAiB,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACvF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACxD,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;gBACzD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,+BAA+B,KAAK,EAAE,CAAC,CAAC;gBAC9E,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;gBACpD,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,0BAA0B,MAAM,CAAC,WAAqB,WAAW,EAAE;oBACvG,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;iBAC5B,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;gBACjD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACpE,CAAC;YACD;gBACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,KAAa,EAAE,UAAmB;QACrE,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;gBACxC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC9E,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,MAAM,YAAY,KAAK,EAAE,CAAC,CAAC;gBAC3E,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAmC,CAAC;gBACpE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC1B,SAAS,EAAE,aAAa;oBACxB,WAAW,EAAE,SAAS;oBACtB,IAAI,EAAE,CAAC;oBACP,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAoB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;iBAClF,CAAC,CAAC,CAAC;YACN,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,sCAAsC,CAAC,CAAC;gBAC9E,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAmC,CAAC;gBAClE,MAAM,MAAM,GAAG,UAAU,IAAI,CAAC,CAAC;gBAC/B,OAAO,MAAM;qBACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;oBACZ,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAoB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;oBACzE,OAAO,EAAE,GAAG,MAAM,CAAC;gBACrB,CAAC,CAAC;qBACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACX,SAAS,EAAE,QAAQ;oBACnB,WAAW,EAAE,SAAS;oBACtB,IAAI,EAAE,CAAC;oBACP,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAoB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;iBAClF,CAAC,CAAC,CAAC;YACR,CAAC;YACD;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@auxiora/connector-social",
+  "version": "1.0.0",
+  "description": "Social media connectors: Twitter/X, LinkedIn, Reddit, Instagram",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@auxiora/connectors": "1.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { twitterConnector } from './twitter.js';
+export { linkedinConnector } from './linkedin.js';
+export { redditConnector } from './reddit.js';
+export { instagramConnector } from './instagram.js';

package/src/instagram.ts

@@ -0,0 +1,212 @@
+import { defineConnector } from '@auxiora/connectors';
+import type { TriggerEvent } from '@auxiora/connectors';
+
+async function instagramFetch(token: string, path: string, options?: { method?: string; body?: unknown }) {
+  const url = new URL(`https://graph.instagram.com${path}`);
+  if (!options?.method || options.method === 'GET') {
+    url.searchParams.set('access_token', token);
+  }
+  const res = await fetch(url.toString(), {
+    method: options?.method ?? 'GET',
+    headers: options?.body ? { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` } : { 'Authorization': `Bearer ${token}` },
+    body: options?.body ? JSON.stringify(options.body) : undefined,
+  });
+  if (!res.ok) throw new Error(`Instagram API error: ${res.status} ${await res.text().catch(() => res.statusText)}`);
+  return res.json() as Promise<Record<string, unknown>>;
+}
+
+export const instagramConnector = defineConnector({
+  id: 'instagram',
+  name: 'Instagram',
+  description: 'Integration with Instagram for posts, stories, and direct messages',
+  version: '1.0.0',
+  category: 'social',
+  icon: 'instagram',
+
+  auth: {
+    type: 'oauth2',
+    oauth2: {
+      authUrl: 'https://api.instagram.com/oauth/authorize',
+      tokenUrl: 'https://api.instagram.com/oauth/access_token',
+      scopes: ['user_profile', 'user_media', 'instagram_basic', 'instagram_manage_messages'],
+    },
+  },
+
+  actions: [
+    {
+      id: 'feed-read',
+      name: 'Read Feed',
+      description: 'Read the Instagram feed',
+      trustMinimum: 1,
+      trustDomain: 'messaging',
+      reversible: false,
+      sideEffects: false,
+      params: {},
+    },
+    {
+      id: 'stories-read',
+      name: 'Read Stories',
+      description: 'Read Instagram stories',
+      trustMinimum: 1,
+      trustDomain: 'messaging',
+      reversible: false,
+      sideEffects: false,
+      params: {},
+    },
+    {
+      id: 'dm-list',
+      name: 'List Direct Messages',
+      description: 'List Instagram direct messages',
+      trustMinimum: 1,
+      trustDomain: 'messaging',
+      reversible: false,
+      sideEffects: false,
+      params: {},
+    },
+    {
+      id: 'dm-send',
+      name: 'Send Direct Message',
+      description: 'Send an Instagram direct message',
+      trustMinimum: 3,
+      trustDomain: 'messaging',
+      reversible: false,
+      sideEffects: true,
+      params: {
+        recipientId: { type: 'string', description: 'Recipient user ID', required: true },
+        text: { type: 'string', description: 'Message text', required: true },
+      },
+    },
+    {
+      id: 'post-schedule',
+      name: 'Schedule Post',
+      description: 'Schedule a post on Instagram',
+      trustMinimum: 3,
+      trustDomain: 'messaging',
+      reversible: false,
+      sideEffects: true,
+      params: {
+        caption: { type: 'string', description: 'Post caption', required: true },
+        mediaUrl: { type: 'string', description: 'Media URL', required: true },
+        scheduledAt: { type: 'string', description: 'Scheduled time (ISO 8601)' },
+      },
+    },
+    {
+      id: 'profile-get',
+      name: 'Get Profile',
+      description: 'Get an Instagram profile',
+      trustMinimum: 1,
+      trustDomain: 'messaging',
+      reversible: false,
+      sideEffects: false,
+      params: {
+        userId: { type: 'string', description: 'User ID (default: authenticated user)' },
+      },
+    },
+  ],
+
+  triggers: [
+    {
+      id: 'new-dm',
+      name: 'New Direct Message',
+      description: 'Triggered when a new direct message is received',
+      type: 'poll',
+      pollIntervalMs: 120_000,
+    },
+    {
+      id: 'new-comment',
+      name: 'New Comment',
+      description: 'Triggered when a new comment is posted on your content',
+      type: 'poll',
+      pollIntervalMs: 300_000,
+    },
+  ],
+
+  entities: [
+    {
+      id: 'post',
+      name: 'Post',
+      description: 'An Instagram post',
+      fields: { id: 'string', caption: 'string', mediaUrl: 'string', likeCount: 'number', commentCount: 'number' },
+    },
+    {
+      id: 'story',
+      name: 'Story',
+      description: 'An Instagram story',
+      fields: { id: 'string', mediaUrl: 'string', expiresAt: 'string' },
+    },
+  ],
+
+  async executeAction(actionId: string, params: Record<string, unknown>, token: string): Promise<unknown> {
+    switch (actionId) {
+      case 'feed-read': {
+        const res = await instagramFetch(token, '/me/media?fields=id,caption,media_url,timestamp,like_count,comments_count');
+        return { posts: res.data };
+      }
+      case 'stories-read': {
+        const res = await instagramFetch(token, '/me/stories?fields=id,media_url,timestamp');
+        return { stories: res.data };
+      }
+      case 'dm-list': {
+        return { messages: [], note: 'Instagram Messaging API requires approved app access' };
+      }
+      case 'dm-send': {
+        return { error: 'Instagram Messaging API requires approved app access', status: 'unavailable' };
+      }
+      case 'post-schedule': {
+        // Step 1: Create media container
+        const container = await instagramFetch(token, '/me/media', {
+          method: 'POST',
+          body: {
+            caption: params.caption,
+            image_url: params.mediaUrl,
+          },
+        });
+        const creationId = container.id as string;
+        // Step 2: Publish the media
+        const published = await instagramFetch(token, '/me/media_publish', {
+          method: 'POST',
+          body: { creation_id: creationId },
+        });
+        return { postId: published.id, status: 'published' };
+      }
+      case 'profile-get': {
+        const userId = (params.userId as string | undefined) ?? 'me';
+        const fields = 'id,username,name,biography,media_count,followers_count,follows_count';
+        const res = await instagramFetch(token, `/${userId}?fields=${fields}`);
+        return res;
+      }
+      default:
+        throw new Error(`Unknown action: ${actionId}`);
+    }
+  },
+
+  async pollTrigger(triggerId: string, token: string, lastPollAt?: number): Promise<TriggerEvent[]> {
+    switch (triggerId) {
+      case 'new-dm':
+        // Instagram Messaging API requires approved access
+        return [];
+      case 'new-comment': {
+        const media = await instagramFetch(token, '/me/media?fields=id&limit=10');
+        const posts = (media.data ?? []) as Array<Record<string, unknown>>;
+        const events: TriggerEvent[] = [];
+        const since = lastPollAt ? new Date(lastPollAt).toISOString() : undefined;
+        for (const post of posts) {
+          const sinceParam = since ? `&since=${since}` : '';
+          const commentsRes = await instagramFetch(token, `/${post.id as string}/comments?fields=id,text,username,timestamp${sinceParam}`);
+          const comments = (commentsRes.data ?? []) as Array<Record<string, unknown>>;
+          for (const comment of comments) {
+            events.push({
+              triggerId: 'new-comment',
+              connectorId: 'instagram',
+              data: { ...comment, mediaId: post.id },
+              timestamp: comment.timestamp ? new Date(comment.timestamp as string).getTime() : Date.now(),
+            });
+          }
+        }
+        return events;
+      }
+      default:
+        return [];
+    }
+  },
+});