sociova 1.1.2 → 1.2.3

package/README.md

@@ -0,0 +1,127 @@
+# Sociova
+
+> Powerful Instagram Automation SDK for Node.js
+
+Sociova is a developer-first Node.js SDK that simplifies working with
+the Instagram Graph API. No more handling headers, access tokens, or raw
+HTTP requests just install, initialize, and start sending messages.
+
+------------------------------------------------------------------------
+
+## Features
+
+-   ✅ Simple client initialization
+-   ✅ Send text messages
+-   ✅ Send generic templates (cards, buttons, links)
+-   ✅ Built-in queue support
+-   ✅ Optional AI automation (Gemini-powered)
+-   ✅ Webhook ready
+-   ✅ Secure token-based authentication
+-   ✅ Works with Node.js, Express, Next.js
+
+------------------------------------------------------------------------
+
+##  Installation
+
+``` bash
+npm install sociova
+```
+
+
+------------------------------------------------------------------------
+
+## ⚡ Quick Start
+
+### 1 Initialize Client
+
+``` ts
+import { InstaClient } from "sociova";
+
+const client = new InstaClient({
+  auth: process.env.AUTH_TOKEN!,
+});
+```
+
+------------------------------------------------------------------------
+
+### 2️ Send a Text Message
+
+``` ts
+await client.sendTextMessage({
+  recipientId: "INSTAGRAM_USER_ID",
+  message: "Hello from Sociova 🚀",
+});
+```
+
+------------------------------------------------------------------------
+
+### 3️ Send Generic Template
+
+``` ts
+await client.sendGenericTemplate({
+  recipientId: "INSTAGRAM_USER_ID",
+  elements: [
+    {
+      title: "Sociova Demo",
+      image_url: "https://example.com/image.jpg",
+      subtitle: "Instagram Automation Made Easy",
+      default_action: {
+        type: "web_url",
+        url: "https://yourwebsite.com",
+      },
+      buttons: [
+        {
+          type: "web_url",
+          url: "https://yourwebsite.com",
+          title: "Visit Website",
+        },
+        {
+          type: "postback",
+          title: "Get Started",
+          payload: "GET_STARTED",
+        },
+      ],
+    },
+  ],
+});
+```
+
+------------------------------------------------------------------------
+
+
+
+##  Webhook Example (Express)
+
+``` ts
+import express from "express";
+
+const app = express();
+app.use(express.json());
+
+app.post("/webhooks/instagram", (req, res) => {
+  res.sendStatus(200);
+  console.log("Incoming Event:", req.body);
+});
+```
+
+
+
+##  Roadmap
+
+-   Advanced campaign builder
+-   Analytics dashboard
+-   Multi-account support
+-   SaaS billing integration
+-   Developer dashboard
+
+------------------------------------------------------------------------
+
+##  License
+
+MIT
+
+------------------------------------------------------------------------
+
+##  Author
+
+Built with ❤️ by Eklavya

package/dist/client.d.ts

@@ -113,6 +113,15 @@ export type SendGenericTemplatePayload = {
 
 export type SendGenericTemplateResponse = Record<string, any>;
 
+  export interface MediaResponse {
+    id: string;
+    status?: string;
+    [key: string]: any; // in case Instagram returns extra fields
+  }
+
+  export interface PublishPostResumePayload {
+    creation_id: string;
+  }
 export declare class InstaClient {
   Config: {
     auth: string;
@@ -133,4 +142,7 @@ export declare class InstaClient {
   sendButtonTemplate(payload: SendButtonTemplatePayload): Promise<SendButtonTemplateResponse>;
   sendPublishedPosts(payload: SendMediaPayload): Promise<SendMediaResponse>;
   sendGenericTemplate(payload: SendGenericTemplatePayload): Promise<SendGenericTemplateResponse>;
-}
+   directPublishPost(payload: DirectPublishPayload): Promise<MediaResponse>;
+  createMedia(payload: DirectPublishPayload): Promise<MediaResponse>;
+  publishPostResume(payload: PublishPostResumePayload): Promise<MediaResponse>;
+}

package/dist/client.js

@@ -1,4 +1,4 @@
-import { AUTHENTICATED_USER, INSTAGRAM_BASE_URL } from "./route";
+import { AUTHENTICATED_USER, INSTAGRAM_BASE_URL } from "./route.js";
 
 export class InstaClient{
     constructor({ auth}){
@@ -187,5 +187,63 @@ async  sendGenericTemplate( payload) {
 
   return await res.json();
 }
+// PUBLISHING POSTS 
+async directPublishPost(payload){
+    const url = `${INSTAGRAM_BASE_URL}/26338849465738403/media`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${this.Config.auth}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      "caption":payload.caption,
+      "image_url":payload.image_url
+    }),
+  });
+  const data =  await res.json()
+  const check = await this.publishPostResume({
+    
+    creation_id: await data.id
+  })
+  return await check
+}
+
+// Not direct
+async createMedia(payload){
+    const url = `${INSTAGRAM_BASE_URL}/26338849465738403/media`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${this.Config.auth}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      "caption":payload.caption,
+      "image_url":payload.image_url
+    }),
+  });
+  const data =  await res.json()
+  return data
+}
+async publishPostResume(payload){
+    const url = `${INSTAGRAM_BASE_URL}/26338849465738403/media_publish`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${this.Config.auth}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({  
+          "creation_id":payload.creation_id
+         }),
+  });
+  return await res.json()
+}
+
+
+
+}
+
+
 
-}

package/dist/index.js

@@ -1 +1 @@
-export * from "./client"
+export * from "./client"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sociova",
-  "version": "1.1.2",
+  "version": "1.2.3",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.js",