@empireaiorg/econnect 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Manuel / Empire AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+## @empireaiorg/econnect
+
+Official Node.js SDK for **eConnect** — one consistent API for messaging and
+music platforms.
+
+## Install
+
+```bash
+npm install @empireaiorg/econnect
+```
+
+## Quick start
+
+```js
+const EConnect = require('@empireaiorg/econnect');
+
+const eConnect = new EConnect(
+  'https://api.empireunion.xyz', // your eConnect base URL
+  process.env.ECONNECT_API_KEY   // your Empire ID developer key
+);
+
+// Messaging
+await eConnect.messaging.sendText('telegram', chatId, 'Hello!');
+await eConnect.messaging.sendEmail(userId, 'gmail', to, subject, text, html);
+
+// Music
+await eConnect.music.play(userId, 'spotify:track:...', 'spotify');
+await eConnect.music.getDevices(userId, 'spotify');
+```
+
+## Two identities in every call
+
+- **You (the developer)** — authenticated by your Empire ID key, passed to
+  the constructor above.
+- **Your end-user** — identified by whatever `user_id`/`chatId` string you
+  pass to each method. Their connected accounts (Spotify, Gmail, etc.) live
+  in eConnect's vault — your key never touches their personal tokens.
+
+## Messaging methods
+
+| Method | Platforms |
+|---|---|
+| `sendText(app, chatId, text)` | telegram, discord, slack |
+| `sendMedia(app, chatId, imageUrl, caption)` | telegram |
+| `sendDocument(app, chatId, documentUrl, caption)` | telegram |
+| `editMessage(app, chatId, messageId, text)` | telegram |
+| `sendEmbed(app, chatId, embed)` | discord |
+| `addReaction(app, chatId, messageId, emoji)` | discord |
+| `updateMessage(app, chatId, ts, text)` | slack |
+| `sendBlocks(app, chatId, blocks, fallbackText)` | slack |
+| `sendEmail(userId, provider, to, subject, text, html?)` | gmail, sendgrid, resend |
+| `getHistory(app, chatId, limit)` | telegram, discord, slack |
+| `deleteMessage(app, chatId, messageId)` | telegram |
+| `addComment(userId, repo, issueNumber, body)` | github |
+| `sendSMS(app, to, text)` | twilio |
+| `sendWhatsApp(app, to, text)` | twilio |
+| `makeCall(app, to, twimlUrl)` | twilio |
+| `getMessageStatus(app, messageSid)` | twilio |
+
+## Music methods
+
+| Method | Platforms |
+|---|---|
+| `search(userId, query, app)` | spotify, youtube, deezer |
+| `play(userId, uri, app)` | spotify |
+| `pause(userId, app)` | spotify |
+| `skip(userId, app)` | spotify |
+| `getCurrent(userId, app)` | spotify |
+| `getDevices(userId, app)` | spotify |
+| `addToQueue(userId, uri, app)` | spotify |
+
+## Full docs
+
+See [empireunion.xyz/docs](https://empireunion.xyz/docs) for the full guide,
+including connecting a user's account via OAuth.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,148 @@
+// Pillar 4: The Developer SDK
+class EConnectSDK {
+    constructor(apiBaseUrl, developerApiKey) {
+        this.apiBaseUrl = apiBaseUrl;
+        this.developerApiKey = developerApiKey; // This will now be the Logto JWT
+    }
+
+    // --- MESSAGING BLUEPRINT ---
+    get messaging() {
+        const sdk = this;
+        return {
+            sendText: async (targetApp, chatId, text) =>
+                sdk.executeAction(chatId, 'send_text', { text: text }, targetApp),
+
+            sendMedia: async (targetApp, chatId, imageUrl, caption = "") =>
+                sdk.executeAction(chatId, 'send_media', { imageUrl: imageUrl, caption: caption }, targetApp),
+
+            sendDocument: async (targetApp, chatId, documentUrl, caption = "") =>
+                sdk.executeAction(chatId, 'send_document', { documentUrl: documentUrl, caption: caption }, targetApp),
+
+            editMessage: async (targetApp, chatId, messageId, text) =>
+                sdk.executeAction(chatId, 'edit_message', { messageId: messageId, text: text }, targetApp),
+
+            sendEmbed: async (targetApp, chatId, embed) =>
+                sdk.executeAction(chatId, 'send_embed', { embed: embed }, targetApp),
+
+            addReaction: async (targetApp, chatId, messageId, emoji) =>
+                sdk.executeAction(chatId, 'add_reaction', { messageId: messageId, emoji: emoji }, targetApp),
+
+            updateMessage: async (targetApp, chatId, ts, text) =>
+                sdk.executeAction(chatId, 'update_message', { ts: ts, text: text }, targetApp),
+
+            sendBlocks: async (targetApp, chatId, blocks, fallbackText = "New message") =>
+                sdk.executeAction(chatId, 'send_blocks', { blocks: blocks, fallbackText: fallbackText }, targetApp),
+
+            sendEmail: async (user_id, provider, toEmail, subject, text, html = null) =>
+                sdk.executeAction(user_id, 'send_email', { to: toEmail, subject: subject, text: text, html: html }, provider),
+
+            getHistory: async (targetApp, chatId, limit = 10) =>
+                sdk.executeAction(chatId, 'get_history', { limit: limit }, targetApp),
+
+            deleteMessage: async (targetApp, chatId, messageId) =>
+                sdk.executeAction(chatId, 'delete_message', { messageId: messageId }, targetApp),
+
+            addComment: async (user_id, repo, issueNumber, body) =>
+                sdk.executeAction(user_id, 'add_comment', { repo: repo, issueNumber: issueNumber, body: body }, 'github'),
+
+            sendSMS: async (targetApp, to, text) =>
+                sdk.executeAction(null, 'send_sms', { to: to, text: text }, targetApp),
+
+            sendWhatsApp: async (targetApp, to, text) =>
+                sdk.executeAction(null, 'send_whatsapp', { to: to, text: text }, targetApp),
+
+            makeCall: async (targetApp, to, twimlUrl) =>
+                sdk.executeAction(null, 'make_call', { to: to, twiml_url: twimlUrl }, targetApp),
+
+            getMessageStatus: async (targetApp, messageSid) =>
+                sdk.executeAction(null, 'get_message_status', { messageSid: messageSid }, targetApp),
+        };
+    }
+
+    // --- MUSIC BLUEPRINT ---
+    get music() {
+        const sdk = this;
+        return {
+            search: async (userId, query, targetApp) => sdk.executeMusicAction(userId, 'search', { query: query }, targetApp),
+            play: async (userId, uri, targetApp) => sdk.executeMusicAction(userId, 'play', { uri: uri }, targetApp),
+            pause: async (userId, targetApp) => sdk.executeMusicAction(userId, 'pause', {}, targetApp),
+            skip: async (userId, targetApp) => sdk.executeMusicAction(userId, 'skip', {}, targetApp),
+            getCurrent: async (userId, targetApp) => sdk.executeMusicAction(userId, 'get_current', {}, targetApp),
+            getDevices: async (userId, targetApp) => sdk.executeMusicAction(userId, 'get_devices', {}, targetApp),
+            addToQueue: async (userId, uri, targetApp) => sdk.executeMusicAction(userId, 'add_to_queue', { uri: uri }, targetApp)
+        };
+    }
+
+    // --- INTERNAL HELPER: Messaging ---
+    async executeAction(chatId, action, payload, targetApp) {
+        try {
+            const response = await fetch(`${this.apiBaseUrl}/v1/messaging/execute`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.developerApiKey}` // <-- UPDATED TO EMPIRE ID FORMAT
+                },
+                body: JSON.stringify({
+                    user_id: chatId,
+                    action: action,
+                    payload: payload,
+                    target_app: targetApp
+                })
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Unknown eConnect error');
+            return data;
+        } catch (error) {
+            console.error("❌ eConnect SDK Error:", error.message);
+            throw error;
+        }
+    }
+
+    // --- INTERNAL HELPER: Music ---
+    async executeMusicAction(userId, action, payload, targetApp) {
+        try {
+            const response = await fetch(`${this.apiBaseUrl}/v1/music/execute`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.developerApiKey}` // <-- UPDATED TO EMPIRE ID FORMAT
+                },
+                body: JSON.stringify({
+                    user_id: userId,
+                    action: action,
+                    payload: payload,
+                    target_app: targetApp
+                })
+            });
+            const data = await response.json();
+            if (!response.ok) throw new Error(data.error || 'Unknown eConnect error');
+            return data;
+        } catch (error) {
+            console.error("❌ eConnect SDK Error:", error.message);
+            throw error;
+        }
+    }
+
+    // --- APP DIRECTORY BLUEPRINT ---
+    get apps() {
+        return {
+            getSupported: async () => {
+                try {
+                    const response = await fetch(`${this.apiBaseUrl}/v1/apps/supported`, {
+                        headers: {
+                            'Authorization': `Bearer ${this.developerApiKey}` // <-- UPDATED TO EMPIRE ID FORMAT
+                        }
+                    });
+                    const data = await response.json();
+                    if (!response.ok) throw new Error(data.error || 'Unknown eConnect error');
+                    return data;
+                } catch (error) {
+                    console.error("❌ eConnect SDK Error:", error.message);
+                    throw error;
+                }
+            }
+        };
+    }
+}
+
+module.exports = EConnectSDK;

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@empireaiorg/econnect",
+  "version": "1.0.0",
+  "description": "Official Node.js SDK for eConnect — one API for messaging (Telegram, Discord, Slack, Gmail, GitHub, Twilio) and music (Spotify, YouTube Music, Deezer) platforms.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "econnect",
+    "empire-ai",
+    "sdk",
+    "api",
+    "messaging",
+    "telegram",
+    "discord",
+    "slack",
+    "spotify",
+    "twilio"
+  ],
+  "author": "David Manuel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/davidmaximimanuel/eConnect.git"
+  },
+  "homepage": "https://empireunion.xyz",
+  "engines": {
+    "node": ">=18"
+  }
+}