@robinpath/instagram - npm Package Compare versions

Comparing version

0.1.0

0.1.1

+36

-7

package.json

		{
		"name": "@robinpath/instagram",
		"version": "0.1.0",
		"publishConfig": { "access": "public" },
		"version": "0.1.1",
		"publishConfig": {
		"access": "public"
		},
		"type": "module",
		"main": "dist/index.js",
		"types": "dist/index.d.ts",
		"exports": { ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" } },
		"files": ["dist"],
		"scripts": { "build": "tsc" },
		"peerDependencies": { "@wiredwp/robinpath": ">=0.20.0" },
		"devDependencies": { "@wiredwp/robinpath": "^0.30.1", "typescript": "^5.6.0" }
		"exports": {
		".": {
		"import": "./dist/index.js",
		"types": "./dist/index.d.ts"
		}
		},
		"files": [
		"dist"
		],
		"scripts": {
		"build": "tsc"
		},
		"peerDependencies": {
		"@robinpath/core": ">=0.20.0"
		},
		"devDependencies": {
		"@robinpath/core": "^0.30.1",
		"typescript": "^5.6.0"
		},
		"description": "Instagram module for RobinPath.",
		"keywords": [
		"instagram",
		"social media"
		],
		"license": "MIT",
		"robinpath": {
		"category": "social-media",
		"type": "integration",
		"auth": "bearer-token",
		"functionCount": 21,
		"baseUrl": "https://graph.facebook.com/v22.0"
		}
		}

-6

dist/index.d.ts

		import type { ModuleAdapter } from "@wiredwp/robinpath";
		declare const InstagramModule: ModuleAdapter;
		export default InstagramModule;
		export { InstagramModule };
		export { InstagramFunctions, InstagramFunctionMetadata, InstagramModuleMetadata } from "./instagram.js";
		//# sourceMappingURL=index.d.ts.map

-1

dist/index.d.ts.map

{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,QAAA,MAAM,eAAe,EAAE,aAMtB,CAAC;AAEF,eAAe,eAAe,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}

-12

dist/index.js

		import { InstagramFunctions, InstagramFunctionMetadata, InstagramModuleMetadata } from "./instagram.js";
		const InstagramModule = {
		name: "instagram",
		functions: InstagramFunctions,
		functionMetadata: InstagramFunctionMetadata,
		moduleMetadata: InstagramModuleMetadata,
		global: false,
		}; // as ModuleAdapter
		export default InstagramModule;
		export { InstagramModule };
		export { InstagramFunctions, InstagramFunctionMetadata, InstagramModuleMetadata } from "./instagram.js";
		//# sourceMappingURL=index.js.map

-1

dist/index.js.map

{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAExG,MAAM,eAAe,GAAkB;IACrC,IAAI,EAAE,WAAW;IACjB,SAAS,EAAE,kBAAkB;IAC7B,gBAAgB,EAAE,yBAAgC;IAClD,cAAc,EAAE,uBAA8B;IAC9C,MAAM,EAAE,KAAK;CACd,CAAC,CAAC,mBAAmB;AAEtB,eAAe,eAAe,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}

-283

dist/instagram.d.ts

		import type { BuiltinHandler } from "@wiredwp/robinpath";
		export declare const InstagramFunctions: Record<string, BuiltinHandler>;
		export declare const InstagramFunctionMetadata: {
		setToken: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		setBusinessAccount: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getProfile: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getMedia: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		listMedia: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		createMediaContainer: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		createVideoContainer: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		createCarouselContainer: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		publishMedia: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getMediaInsights: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getAccountInsights: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getComments: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		replyToComment: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		deleteComment: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getStories: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getHashtag: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getHashtagMedia: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getMentions: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		sendMessage: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getConversations: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		getMessages: {
		description: string;
		parameters: {
		name: string;
		dataType: string;
		description: string;
		formInputType: string;
		required: boolean;
		}[];
		returnType: string;
		returnDescription: string;
		example: string;
		};
		};
		export declare const InstagramModuleMetadata: {
		description: string;
		methods: string[];
		category: string;
		};
		//# sourceMappingURL=instagram.d.ts.map

-1

dist/instagram.d.ts.map

{"version":3,"file":"instagram.d.ts","sourceRoot":"","sources":["../src/instagram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA2C,MAAM,oBAAoB,CAAC;AA8hBlG,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAsB7D,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8MrC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;CAInC,CAAC"}

-647

dist/instagram.js

		const accounts = new Map();
		const API_BASE = "https://graph.facebook.com/v22.0";
		// ── Helper ──────────────────────────────────────────────────────────
		function getConfig(accountId = "default") {
		const config = accounts.get(accountId);
		if (!config) {
		throw new Error(`Instagram account "${accountId}" not configured. Call instagram.setToken or instagram.setBusinessAccount first.`);
		}
		return config;
		}
		async function callApi(endpoint, accessToken, method = "GET", body) {
		const url = new URL(`${API_BASE}/${endpoint}`);
		const headers = {
		Authorization: `Bearer ${accessToken}`,
		};
		const fetchOptions = { method, headers };
		if (body && (method === "POST" \|\| method === "DELETE")) {
		headers["Content-Type"] = "application/json";
		fetchOptions.body = JSON.stringify(body);
		}
		const response = await fetch(url.toString(), fetchOptions);
		const result = (await response.json());
		if (result.error) {
		const err = result.error;
		throw new Error(`Instagram API error: ${String(err.message ?? err.type ?? "unknown_error")} (code ${err.code ?? "?"})`);
		}
		return result;
		}
		async function callApiGet(endpoint, accessToken, params) {
		const url = new URL(`${API_BASE}/${endpoint}`);
		url.searchParams.set("access_token", accessToken);
		if (params) {
		for (const [key, value] of Object.entries(params)) {
		url.searchParams.set(key, value);
		}
		}
		const response = await fetch(url.toString());
		const result = (await response.json());
		if (result.error) {
		const err = result.error;
		throw new Error(`Instagram API error: ${String(err.message ?? err.type ?? "unknown_error")} (code ${err.code ?? "?"})`);
		}
		return result;
		}
		async function callApiPost(endpoint, accessToken, body) {
		const url = new URL(`${API_BASE}/${endpoint}`);
		const response = await fetch(url.toString(), {
		method: "POST",
		headers: {
		Authorization: `Bearer ${accessToken}`,
		"Content-Type": "application/json",
		},
		body: JSON.stringify(body),
		});
		const result = (await response.json());
		if (result.error) {
		const err = result.error;
		throw new Error(`Instagram API error: ${String(err.message ?? err.type ?? "unknown_error")} (code ${err.code ?? "?"})`);
		}
		return result;
		}
		async function callApiDelete(endpoint, accessToken) {
		const url = new URL(`${API_BASE}/${endpoint}`);
		const response = await fetch(url.toString(), {
		method: "DELETE",
		headers: {
		Authorization: `Bearer ${accessToken}`,
		},
		});
		const result = (await response.json());
		if (result.error) {
		const err = result.error;
		throw new Error(`Instagram API error: ${String(err.message ?? err.type ?? "unknown_error")} (code ${err.code ?? "?"})`);
		}
		return result;
		}
		// ── Function Handlers ───────────────────────────────────────────────
		const setToken = (args) => {
		const accessToken = String(args[0] ?? "");
		if (!accessToken)
		throw new Error("Access token is required.");
		accounts.set("default", {
		accessToken,
		igBusinessAccountId: "",
		});
		return { ok: true, accountId: "default" };
		};
		const setBusinessAccount = (args) => {
		const accessToken = String(args[0] ?? "");
		const igBusinessAccountId = String(args[1] ?? "");
		if (!accessToken)
		throw new Error("Access token is required.");
		if (!igBusinessAccountId)
		throw new Error("IG Business Account ID is required.");
		accounts.set("default", {
		accessToken,
		igBusinessAccountId,
		});
		return { ok: true, accountId: "default", igBusinessAccountId };
		};
		const getProfile = async (args) => {
		const opts = (typeof args[0] === "object" && args[0] !== null ? args[0] : {});
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const fields = String(opts.fields ?? "id,name,username,biography,followers_count,follows_count,media_count,profile_picture_url,website");
		const result = await callApiGet(`${config.igBusinessAccountId}`, config.accessToken, { fields });
		return result;
		};
		const getMedia = async (args) => {
		const mediaId = String(args[0] ?? "");
		const fields = String(args[1] ?? "id,caption,media_type,media_url,timestamp,permalink,like_count,comments_count,thumbnail_url");
		if (!mediaId)
		throw new Error("Media ID is required.");
		const config = getConfig("default");
		const result = await callApiGet(mediaId, config.accessToken, { fields });
		return result;
		};
		const listMedia = async (args) => {
		const opts = (typeof args[0] === "object" && args[0] !== null ? args[0] : {});
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const params = {
		fields: String(opts.fields ?? "id,caption,media_type,media_url,timestamp,permalink,like_count,comments_count"),
		};
		if (opts.limit)
		params.limit = String(opts.limit);
		if (opts.after)
		params.after = String(opts.after);
		if (opts.before)
		params.before = String(opts.before);
		const result = await callApiGet(`${config.igBusinessAccountId}/media`, config.accessToken, params);
		return result;
		};
		const createMediaContainer = async (args) => {
		const imageUrl = String(args[0] ?? "");
		const caption = String(args[1] ?? "");
		const opts = (typeof args[2] === "object" && args[2] !== null ? args[2] : {});
		if (!imageUrl)
		throw new Error("Image URL is required.");
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const body = {
		image_url: imageUrl,
		access_token: config.accessToken,
		};
		if (caption)
		body.caption = caption;
		if (opts.locationId)
		body.location_id = String(opts.locationId);
		if (opts.userTags)
		body.user_tags = opts.userTags;
		if (opts.isCarouselItem)
		body.is_carousel_item = true;
		const result = await callApiPost(`${config.igBusinessAccountId}/media`, config.accessToken, body);
		return result;
		};
		const createVideoContainer = async (args) => {
		const videoUrl = String(args[0] ?? "");
		const caption = String(args[1] ?? "");
		const opts = (typeof args[2] === "object" && args[2] !== null ? args[2] : {});
		if (!videoUrl)
		throw new Error("Video URL is required.");
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const mediaType = String(opts.mediaType ?? "REELS");
		const body = {
		video_url: videoUrl,
		media_type: mediaType,
		access_token: config.accessToken,
		};
		if (caption)
		body.caption = caption;
		if (opts.coverUrl)
		body.cover_url = String(opts.coverUrl);
		if (opts.thumbOffset)
		body.thumb_offset = Number(opts.thumbOffset);
		if (opts.locationId)
		body.location_id = String(opts.locationId);
		if (opts.isCarouselItem)
		body.is_carousel_item = true;
		if (opts.shareToFeed !== undefined)
		body.share_to_feed = Boolean(opts.shareToFeed);
		const result = await callApiPost(`${config.igBusinessAccountId}/media`, config.accessToken, body);
		return result;
		};
		const createCarouselContainer = async (args) => {
		const children = Array.isArray(args[0]) ? args[0].map(String) : [];
		const caption = String(args[1] ?? "");
		if (children.length < 2)
		throw new Error("At least 2 child container IDs are required for a carousel.");
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const body = {
		media_type: "CAROUSEL",
		children: children.join(","),
		access_token: config.accessToken,
		};
		if (caption)
		body.caption = caption;
		const result = await callApiPost(`${config.igBusinessAccountId}/media`, config.accessToken, body);
		return result;
		};
		const publishMedia = async (args) => {
		const containerId = String(args[0] ?? "");
		if (!containerId)
		throw new Error("Container ID is required.");
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const body = {
		creation_id: containerId,
		access_token: config.accessToken,
		};
		const result = await callApiPost(`${config.igBusinessAccountId}/media_publish`, config.accessToken, body);
		return result;
		};
		const getMediaInsights = async (args) => {
		const mediaId = String(args[0] ?? "");
		const metrics = String(args[1] ?? "impressions,reach,engagement,saved");
		if (!mediaId)
		throw new Error("Media ID is required.");
		const config = getConfig("default");
		const result = await callApiGet(`${mediaId}/insights`, config.accessToken, { metric: metrics });
		return result;
		};
		const getAccountInsights = async (args) => {
		const metrics = String(args[0] ?? "impressions,reach,follower_count");
		const period = String(args[1] ?? "day");
		const opts = (typeof args[2] === "object" && args[2] !== null ? args[2] : {});
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const params = {
		metric: metrics,
		period,
		};
		if (opts.since)
		params.since = String(opts.since);
		if (opts.until)
		params.until = String(opts.until);
		const result = await callApiGet(`${config.igBusinessAccountId}/insights`, config.accessToken, params);
		return result;
		};
		const getComments = async (args) => {
		const mediaId = String(args[0] ?? "");
		const opts = (typeof args[1] === "object" && args[1] !== null ? args[1] : {});
		if (!mediaId)
		throw new Error("Media ID is required.");
		const config = getConfig("default");
		const params = {
		fields: String(opts.fields ?? "id,text,timestamp,username,like_count,replies"),
		};
		if (opts.limit)
		params.limit = String(opts.limit);
		if (opts.after)
		params.after = String(opts.after);
		const result = await callApiGet(`${mediaId}/comments`, config.accessToken, params);
		return result;
		};
		const replyToComment = async (args) => {
		const commentId = String(args[0] ?? "");
		const message = String(args[1] ?? "");
		if (!commentId)
		throw new Error("Comment ID is required.");
		if (!message)
		throw new Error("Message is required.");
		const config = getConfig("default");
		const body = {
		message,
		access_token: config.accessToken,
		};
		const result = await callApiPost(`${commentId}/replies`, config.accessToken, body);
		return result;
		};
		const deleteComment = async (args) => {
		const commentId = String(args[0] ?? "");
		if (!commentId)
		throw new Error("Comment ID is required.");
		const config = getConfig("default");
		await callApiDelete(commentId, config.accessToken);
		return { ok: true, commentId };
		};
		const getStories = async (args) => {
		const opts = (typeof args[0] === "object" && args[0] !== null ? args[0] : {});
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const params = {
		fields: String(opts.fields ?? "id,media_type,media_url,timestamp,permalink"),
		};
		const result = await callApiGet(`${config.igBusinessAccountId}/stories`, config.accessToken, params);
		return result;
		};
		const getHashtag = async (args) => {
		const hashtagName = String(args[0] ?? "");
		if (!hashtagName)
		throw new Error("Hashtag name is required.");
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const result = await callApiGet("ig_hashtag_search", config.accessToken, {
		q: hashtagName,
		user_id: config.igBusinessAccountId,
		});
		return result;
		};
		const getHashtagMedia = async (args) => {
		const hashtagId = String(args[0] ?? "");
		const type = String(args[1] ?? "top_media");
		const opts = (typeof args[2] === "object" && args[2] !== null ? args[2] : {});
		if (!hashtagId)
		throw new Error("Hashtag ID is required.");
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const edgeType = type === "recent_media" ? "recent_media" : "top_media";
		const params = {
		user_id: config.igBusinessAccountId,
		fields: String(opts.fields ?? "id,caption,media_type,media_url,permalink,timestamp,like_count,comments_count"),
		};
		if (opts.limit)
		params.limit = String(opts.limit);
		if (opts.after)
		params.after = String(opts.after);
		const result = await callApiGet(`${hashtagId}/${edgeType}`, config.accessToken, params);
		return result;
		};
		const getMentions = async (args) => {
		const opts = (typeof args[0] === "object" && args[0] !== null ? args[0] : {});
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const params = {
		fields: String(opts.fields ?? "id,caption,media_type,media_url,permalink,timestamp"),
		};
		if (opts.limit)
		params.limit = String(opts.limit);
		if (opts.after)
		params.after = String(opts.after);
		const result = await callApiGet(`${config.igBusinessAccountId}/tags`, config.accessToken, params);
		return result;
		};
		const sendMessage = async (args) => {
		const recipientId = String(args[0] ?? "");
		const message = String(args[1] ?? "");
		if (!recipientId)
		throw new Error("Recipient ID is required.");
		if (!message)
		throw new Error("Message is required.");
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const body = {
		recipient: { id: recipientId },
		message: { text: message },
		access_token: config.accessToken,
		};
		const result = await callApiPost(`${config.igBusinessAccountId}/messages`, config.accessToken, body);
		return result;
		};
		const getConversations = async (args) => {
		const opts = (typeof args[0] === "object" && args[0] !== null ? args[0] : {});
		const config = getConfig("default");
		if (!config.igBusinessAccountId) {
		throw new Error("IG Business Account ID is required. Call instagram.setBusinessAccount first.");
		}
		const params = {
		platform: "instagram",
		fields: String(opts.fields ?? "id,updated_time,participants,messages"),
		};
		if (opts.limit)
		params.limit = String(opts.limit);
		if (opts.after)
		params.after = String(opts.after);
		const result = await callApiGet(`${config.igBusinessAccountId}/conversations`, config.accessToken, params);
		return result;
		};
		const getMessages = async (args) => {
		const conversationId = String(args[0] ?? "");
		const opts = (typeof args[1] === "object" && args[1] !== null ? args[1] : {});
		if (!conversationId)
		throw new Error("Conversation ID is required.");
		const config = getConfig("default");
		const params = {
		fields: String(opts.fields ?? "id,message,from,to,created_time"),
		};
		if (opts.limit)
		params.limit = String(opts.limit);
		if (opts.after)
		params.after = String(opts.after);
		const result = await callApiGet(`${conversationId}/messages`, config.accessToken, params);
		return result;
		};
		// ── Exports ─────────────────────────────────────────────────────────
		export const InstagramFunctions = {
		setToken,
		setBusinessAccount,
		getProfile,
		getMedia,
		listMedia,
		createMediaContainer,
		createVideoContainer,
		createCarouselContainer,
		publishMedia,
		getMediaInsights,
		getAccountInsights,
		getComments,
		replyToComment,
		deleteComment,
		getStories,
		getHashtag,
		getHashtagMedia,
		getMentions,
		sendMessage,
		getConversations,
		getMessages,
		};
		export const InstagramFunctionMetadata = {
		setToken: {
		description: "Store a long-lived Instagram access token for API calls",
		parameters: [
		{ name: "accessToken", dataType: "string", description: "Long-lived access token from Meta/Facebook", formInputType: "text", required: true },
		],
		returnType: "object",
		returnDescription: "{ok, accountId}",
		example: 'instagram.setToken "EAAG..."',
		},
		setBusinessAccount: {
		description: "Store access token and IG Business Account ID for full API access",
		parameters: [
		{ name: "accessToken", dataType: "string", description: "Long-lived access token from Meta/Facebook", formInputType: "text", required: true },
		{ name: "igBusinessAccountId", dataType: "string", description: "Instagram Business Account ID (numeric)", formInputType: "text", required: true },
		],
		returnType: "object",
		returnDescription: "{ok, accountId, igBusinessAccountId}",
		example: 'instagram.setBusinessAccount "EAAG..." "17841400123456"',
		},
		getProfile: {
		description: "Get authenticated user's Instagram profile (id, username, biography, followers, media count, etc.)",
		parameters: [
		{ name: "options", dataType: "object", description: "{fields?: string} - comma-separated fields to retrieve", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{id, name, username, biography, followers_count, follows_count, media_count, ...}",
		example: 'instagram.getProfile',
		},
		getMedia: {
		description: "Get details of a specific media item by ID",
		parameters: [
		{ name: "mediaId", dataType: "string", description: "Media ID to retrieve", formInputType: "text", required: true },
		{ name: "fields", dataType: "string", description: "Comma-separated fields (default: id,caption,media_type,media_url,timestamp,permalink,like_count,comments_count)", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{id, caption, media_type, media_url, timestamp, permalink, like_count, comments_count, ...}",
		example: 'instagram.getMedia "17895695668004550"',
		},
		listMedia: {
		description: "List the authenticated user's media posts with pagination",
		parameters: [
		{ name: "options", dataType: "object", description: "{limit?, after?, before?, fields?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [...media], paging: {cursors, next, previous}}",
		example: 'instagram.listMedia {"limit": 10}',
		},
		createMediaContainer: {
		description: "Create a media container for an image post (returns container ID for publishing)",
		parameters: [
		{ name: "imageUrl", dataType: "string", description: "Public URL of the image to post", formInputType: "text", required: true },
		{ name: "caption", dataType: "string", description: "Post caption text", formInputType: "textarea", required: false },
		{ name: "options", dataType: "object", description: "{locationId?, userTags?, isCarouselItem?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{id} - container ID for use with publishMedia",
		example: 'instagram.createMediaContainer "https://example.com/photo.jpg" "Beautiful sunset! #nature"',
		},
		createVideoContainer: {
		description: "Create a media container for a video or Reel post",
		parameters: [
		{ name: "videoUrl", dataType: "string", description: "Public URL of the video", formInputType: "text", required: true },
		{ name: "caption", dataType: "string", description: "Post caption text", formInputType: "textarea", required: false },
		{ name: "options", dataType: "object", description: "{mediaType?: 'REELS'\|'VIDEO', coverUrl?, thumbOffset?, locationId?, isCarouselItem?, shareToFeed?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{id} - container ID for use with publishMedia",
		example: 'instagram.createVideoContainer "https://example.com/video.mp4" "Check this out!" {"mediaType": "REELS"}',
		},
		createCarouselContainer: {
		description: "Create a carousel container from multiple child container IDs",
		parameters: [
		{ name: "children", dataType: "array", description: "Array of child container IDs (minimum 2)", formInputType: "json", required: true },
		{ name: "caption", dataType: "string", description: "Carousel caption text", formInputType: "textarea", required: false },
		],
		returnType: "object",
		returnDescription: "{id} - carousel container ID for use with publishMedia",
		example: 'instagram.createCarouselContainer ["17889615691123456", "17889615691123457"] "Photo dump!"',
		},
		publishMedia: {
		description: "Publish a previously created media container (image, video, or carousel)",
		parameters: [
		{ name: "containerId", dataType: "string", description: "Container ID from createMediaContainer, createVideoContainer, or createCarouselContainer", formInputType: "text", required: true },
		],
		returnType: "object",
		returnDescription: "{id} - published media ID",
		example: 'instagram.publishMedia "17889615691123456"',
		},
		getMediaInsights: {
		description: "Get insights/analytics for a specific media item",
		parameters: [
		{ name: "mediaId", dataType: "string", description: "Media ID to get insights for", formInputType: "text", required: true },
		{ name: "metrics", dataType: "string", description: "Comma-separated metrics (default: impressions,reach,engagement,saved)", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [{name, period, values, title, description, id}]}",
		example: 'instagram.getMediaInsights "17895695668004550" "impressions,reach,engagement,saved"',
		},
		getAccountInsights: {
		description: "Get account-level insights (impressions, reach, follower_count, etc.)",
		parameters: [
		{ name: "metrics", dataType: "string", description: "Comma-separated metrics (e.g. impressions,reach,follower_count)", formInputType: "text", required: true },
		{ name: "period", dataType: "string", description: "Time period: day, week, days_28, month, lifetime", formInputType: "select", required: true },
		{ name: "options", dataType: "object", description: "{since?: unix_timestamp, until?: unix_timestamp}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [{name, period, values, title, description}]}",
		example: 'instagram.getAccountInsights "impressions,reach,follower_count" "day"',
		},
		getComments: {
		description: "List comments on a media post",
		parameters: [
		{ name: "mediaId", dataType: "string", description: "Media ID to list comments for", formInputType: "text", required: true },
		{ name: "options", dataType: "object", description: "{limit?, after?, fields?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [{id, text, timestamp, username, like_count}], paging}",
		example: 'instagram.getComments "17895695668004550" {"limit": 25}',
		},
		replyToComment: {
		description: "Reply to a specific comment on a media post",
		parameters: [
		{ name: "commentId", dataType: "string", description: "Comment ID to reply to", formInputType: "text", required: true },
		{ name: "message", dataType: "string", description: "Reply text", formInputType: "text", required: true },
		],
		returnType: "object",
		returnDescription: "{id} - reply comment ID",
		example: 'instagram.replyToComment "17858893269123456" "Thank you!"',
		},
		deleteComment: {
		description: "Delete or hide a comment by ID",
		parameters: [
		{ name: "commentId", dataType: "string", description: "Comment ID to delete", formInputType: "text", required: true },
		],
		returnType: "object",
		returnDescription: "{ok, commentId}",
		example: 'instagram.deleteComment "17858893269123456"',
		},
		getStories: {
		description: "Get the authenticated user's currently active stories",
		parameters: [
		{ name: "options", dataType: "object", description: "{fields?: string}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [{id, media_type, media_url, timestamp, permalink}]}",
		example: 'instagram.getStories',
		},
		getHashtag: {
		description: "Search for a hashtag ID by name",
		parameters: [
		{ name: "hashtagName", dataType: "string", description: "Hashtag name without # (e.g. 'travel')", formInputType: "text", required: true },
		],
		returnType: "object",
		returnDescription: "{data: [{id}]}",
		example: 'instagram.getHashtag "travel"',
		},
		getHashtagMedia: {
		description: "Get top or recent media for a hashtag",
		parameters: [
		{ name: "hashtagId", dataType: "string", description: "Hashtag ID from getHashtag", formInputType: "text", required: true },
		{ name: "type", dataType: "string", description: "'top_media' or 'recent_media' (default: top_media)", formInputType: "select", required: false },
		{ name: "options", dataType: "object", description: "{limit?, after?, fields?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [...media], paging}",
		example: 'instagram.getHashtagMedia "17843853986012965" "top_media" {"limit": 20}',
		},
		getMentions: {
		description: "Get media posts where the authenticated user is tagged/mentioned",
		parameters: [
		{ name: "options", dataType: "object", description: "{limit?, after?, fields?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [...media], paging}",
		example: 'instagram.getMentions {"limit": 10}',
		},
		sendMessage: {
		description: "Send a direct message to a user via Instagram Messaging API",
		parameters: [
		{ name: "recipientId", dataType: "string", description: "Instagram-scoped ID of the recipient", formInputType: "text", required: true },
		{ name: "message", dataType: "string", description: "Message text to send", formInputType: "text", required: true },
		],
		returnType: "object",
		returnDescription: "{recipient_id, message_id}",
		example: 'instagram.sendMessage "17841400123456" "Hello from RobinPath!"',
		},
		getConversations: {
		description: "List DM conversations for the authenticated account",
		parameters: [
		{ name: "options", dataType: "object", description: "{limit?, after?, fields?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [{id, updated_time, participants, messages}], paging}",
		example: 'instagram.getConversations {"limit": 10}',
		},
		getMessages: {
		description: "Get messages within a specific DM conversation",
		parameters: [
		{ name: "conversationId", dataType: "string", description: "Conversation ID from getConversations", formInputType: "text", required: true },
		{ name: "options", dataType: "object", description: "{limit?, after?, fields?}", formInputType: "text", required: false },
		],
		returnType: "object",
		returnDescription: "{data: [{id, message, from, to, created_time}], paging}",
		example: 'instagram.getMessages "t_1234567890" {"limit": 20}',
		},
		};
		export const InstagramModuleMetadata = {
		description: "Instagram Graph API client for managing posts, stories, comments, insights, hashtags, mentions, and direct messages via Meta/Facebook platform",
		methods: Object.keys(InstagramFunctions),
		category: "social",
		};
		//# sourceMappingURL=instagram.js.map

-1

dist/instagram.js.map

@robinpath/instagram - npm Package Compare versions

New alerts

Fixed alerts

Improved metrics

Worsened metrics