@particle-academy/instagram-business-js 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to `@particle-academy/instagram-business-ui`,
+`@particle-academy/instagram-business-js`,
+`particle-academy/instagram-business-php` and `fancy-instagram-business`.
+
+## [0.1.0] - 2026-08-24
+
+### Added
+
+- Create an image media container from a public URL and optional caption.
+- Publish a container by wiring its returned id into `creation_id`.
+- OAuth2 with App Secret Proof for Meta professional Instagram accounts.
+- Deterministic fixtures for both publishing calls.
+
+[0.1.0]: https://github.com/Fancy-Friends/instagram-business/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Particle Academy
+
+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,112 @@
+# Instagram for Business
+
+Instagram for Business for [fancy-flow][flow] — as **four imported, versioned packages**, one
+per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
+change.
+
+[flow]: https://github.com/Particle-Academy/fancy-flow
+
+| Runtime | Package | Install |
+|---|---|---|
+| Authoring surface (every host) | `@particle-academy/instagram-business-ui` | `npm install @particle-academy/instagram-business-ui` |
+| Node | `@particle-academy/instagram-business-js` | `npm install @particle-academy/instagram-business-js` |
+| PHP 8.4+ | `particle-academy/instagram-business-php` | `composer require particle-academy/instagram-business-php` |
+| Python 3.11+ | `fancy-instagram-business` | `pip install fancy-instagram-business` |
+
+The `ui` package is the editor surface and is React on every host — a PHP or
+Python project installs it *and* its own runtime package, and never the `js` one.
+
+## What it costs you
+
+One dependency: `@particle-academy/fancy-connector-core` (or
+`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
+packages pull in themselves. The Python package has **zero** runtime
+dependencies.
+
+**No Instagram for Business SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
+subject to the kit's full approval bar, and one per provider is hundreds of
+dependencies nobody is tracking.
+
+## Setting it up
+
+Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
+
+### Credentials
+
+A Instagram for Business connection holds 4 values.
+
+**Two kinds of value, and mixing them up matters.** A `provider` credential is ONE value for the whole installation — an OAuth app's client secret serves every connected account. An `account` credential is one per connected account. A host that stores the second where it stores the first lets one account's credentials reach another's.
+
+| Field | Scope | Secret | Where it comes from |
+|---|---|---|---|
+| **App ID** | per installation | not secret | From the Meta app dashboard. One value serves the installation. |
+| **App secret (OAuth)** | per installation | **secret** | Used for the authorization-code exchange. |
+| **App secret (proof)** | per installation | **secret** | Keys appsecret_proof on outgoing Graph API calls. |
+| **Instagram access token** | per connected account | **secret** | The connected professional account's long-lived Meta access token. |
+
+### Authorising
+
+Instagram for Business uses OAuth2 (authorization_code). The package DECLARES the exchange; the HOST performs it — a consent screen needs a browser, a redirect URI and somewhere to persist the result, and all three belong to the host.
+
+- **Authorize URL** — https://www.facebook.com/v25.0/dialog/oauth
+- **Token URL** — https://graph.facebook.com/v25.0/oauth/access_token
+- **Scopes** — `instagram_basic`, `instagram_content_publish`, `pages_read_engagement`
+- **Access token lifetime** — 5184000 seconds (60 days). A host that never refreshes works all afternoon and is broken by morning.
+
+**This flow issues NO refresh token.** A connection is RE-AUTHORISED rather than refreshed when the access token expires — checked, not assumed.
+
+### The estate
+
+**Instagram for Business has no test estate, and somebody checked.** Everything this connector does is real. Use the faker to build against it.
+
+> Instagram publishing has no sandbox. Publishing creates a real post on a real professional account, and an unpublished container expires after 24 hours.
+
+## What it can do
+
+### Actions
+
+#### `media_container_create` — Instagram media container
+
+Create an Instagram image container. This reports success before any post exists: pass its id to Publish Instagram media, or the unpublished container expires after 24 hours without producing a post.
+
+`POST /{igUserId}/media` · **unsafe to replay** — a retried durable run does it TWICE
+
+| Input | Required | What it is |
+|---|---|---|
+| `igUserId` | yes | The professional Instagram account's numeric Graph API id. |
+| `imageUrl` | yes | A publicly reachable image URL. Meta fetches its bytes while creating the container. |
+| `caption` | no | The caption stored with the container and used when published. |
+
+#### `media_publish` — Publish Instagram media
+
+Publish a previously created Instagram media container as a real post.
+
+`POST /{igUserId}/media_publish` · **unsafe to replay** — a retried durable run does it TWICE
+
+| Input | Required | What it is |
+|---|---|---|
+| `igUserId` | yes | The same professional account id used to create the container. |
+| `creationId` | yes | The id returned by Create Instagram media container. Unpublished containers expire after 24 hours. |
+
+## Run it before you have credentials
+
+Every operation ships a **faker**, whether or not Instagram for Business has a sandbox. Set a
+node's mode to `fake` and it returns the shape Instagram for Business actually publishes — the
+same field names, deterministically — so you can wire the downstream nodes before
+touching an account, a key, or a network.
+
+## This repository is generated
+
+`provider/` is the source. Everything under `packages/` is emitted from it and
+**must not be hand-edited** — CI regenerates and diffs on every push, and the
+next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
+
+## Two namespaces, which do not match on purpose
+
+The repo is `github.com/Fancy-Friends/instagram-business`; the packages publish under
+`particle-academy`. Nothing derives one from the other — the names come from
+weaver's `friends.json` and nowhere else.
+
+## Licence
+
+MIT.

package/dist/chunk-Z43FUIPD.js

@@ -0,0 +1,111 @@
+import { createHmac } from 'crypto';
+import { callConnector } from '@particle-academy/fancy-connector-core';
+
+// src/faker.ts
+function fakeMediaContainerCreate({ config, fake }) {
+  return {
+    "id": "17889455560051444"
+  };
+}
+function fakeMediaPublish({ config, fake }) {
+  return {
+    "id": "17920238422030506"
+  };
+}
+var instagramBusinessFaker = (operation, request) => {
+  switch (operation) {
+    case "media_container_create":
+      return fakeMediaContainerCreate(request);
+    case "media_publish":
+      return fakeMediaPublish(request);
+    default:
+      throw new Error(
+        `instagram_business: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+var CONNECTOR_API_VERSION = 1;
+var INSTAGRAM_BUSINESS_BASE_URLS = {
+  "live": "https://graph.facebook.com/v25.0"
+};
+var INSTAGRAM_BUSINESS_REQUIRES = [
+  "accessToken",
+  "appSecret",
+  "clientId",
+  "clientSecret"
+];
+function instagramBusinessAuthorize(credentials, request, _mode) {
+  const url = new URL(request.url);
+  url.searchParams.set("access_token", String(credentials.accessToken ?? ""));
+  const proof = createHmac("sha256", String(credentials.appSecret ?? "")).update(String(credentials.accessToken ?? "")).digest("hex");
+  url.searchParams.set("appsecret_proof", proof);
+  request.url = url.toString();
+}
+var INSTAGRAM_BUSINESS = {
+  service: "instagram_business",
+  title: "Instagram for Business",
+  sandbox: "none",
+  baseUrls: { ...INSTAGRAM_BUSINESS_BASE_URLS },
+  requires: [...INSTAGRAM_BUSINESS_REQUIRES],
+  authorize: instagramBusinessAuthorize,
+  faker: instagramBusinessFaker
+};
+var MEDIA_CONTAINER_CREATE_OPERATION = "media_container_create";
+async function instagramBusinessMediaContainerCreate(options) {
+  const config = options.config ?? {};
+  if (config.igUserId === void 0 || config.igUserId === null || config.igUserId === "") {
+    throw new Error(`media_container_create: "igUserId" is required (Instagram user ID).`);
+  }
+  if (config.imageUrl === void 0 || config.imageUrl === null || config.imageUrl === "") {
+    throw new Error(`media_container_create: "imageUrl" is required (Image URL).`);
+  }
+  return callConnector(INSTAGRAM_BUSINESS, {
+    operation: MEDIA_CONTAINER_CREATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/${encodeURIComponent(String(config.igUserId))}/media`,
+      json: {
+        "image_url": String(config.imageUrl),
+        ...config.caption !== void 0 && config.caption !== null && config.caption !== "" ? { "caption": String(config.caption) } : {}
+      }
+    }
+  });
+}
+var MEDIA_PUBLISH_OPERATION = "media_publish";
+async function instagramBusinessMediaPublish(options) {
+  const config = options.config ?? {};
+  if (config.igUserId === void 0 || config.igUserId === null || config.igUserId === "") {
+    throw new Error(`media_publish: "igUserId" is required (Instagram user ID).`);
+  }
+  if (config.creationId === void 0 || config.creationId === null || config.creationId === "") {
+    throw new Error(`media_publish: "creationId" is required (Creation ID).`);
+  }
+  return callConnector(INSTAGRAM_BUSINESS, {
+    operation: MEDIA_PUBLISH_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/${encodeURIComponent(String(config.igUserId))}/media_publish`,
+      json: {
+        "creation_id": String(config.creationId)
+      }
+    }
+  });
+}
+
+export { CONNECTOR_API_VERSION, INSTAGRAM_BUSINESS, INSTAGRAM_BUSINESS_BASE_URLS, INSTAGRAM_BUSINESS_REQUIRES, MEDIA_CONTAINER_CREATE_OPERATION, MEDIA_PUBLISH_OPERATION, instagramBusinessAuthorize, instagramBusinessFaker, instagramBusinessMediaContainerCreate, instagramBusinessMediaPublish };
+//# sourceMappingURL=chunk-Z43FUIPD.js.map
+//# sourceMappingURL=chunk-Z43FUIPD.js.map

package/dist/chunk-Z43FUIPD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/media-container-create.ts","../src/actions/media-publish.ts"],"names":["callConnector"],"mappings":"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","file":"chunk-Z43FUIPD.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * The Instagram for Business faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Instagram for Business actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeMediaContainerCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": \"17889455560051444\",\n  };\n}\n\nfunction fakeMediaPublish({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": \"17920238422030506\",\n  };\n}\n\nexport const instagramBusinessFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"media_container_create\":\n      return fakeMediaContainerCreate(request);\n\n    case \"media_publish\":\n      return fakeMediaPublish(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `instagram_business: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Instagram for Business, as one service descriptor shared by every Instagram\n * for Business operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Instagram for Business: its base\n * URL, its auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Instagram publishing has no sandbox. Publishing creates a real post on a\n * real professional account, and an unpublished container expires after 24\n * hours.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { instagramBusinessFaker } from \"./faker.js\";\nimport { createHmac } from \"node:crypto\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const INSTAGRAM_BUSINESS_BASE_URLS = {\n  \"live\": \"https://graph.facebook.com/v25.0\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const INSTAGRAM_BUSINESS_REQUIRES = [\n  \"accessToken\",\n  \"appSecret\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Instagram for Business's auth scheme to an outgoing request.\n *\n * Meta documents the token as a query parameter. appsecret_proof travels\n * beside it so installations requiring App Secret Proof do not reject every\n * call.\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function instagramBusinessAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  const url = new URL(request.url);\n\n  url.searchParams.set(\"access_token\", String(credentials.accessToken ?? \"\"));\n\n  const proof = createHmac(\"sha256\", String(credentials.appSecret ?? \"\"))\n    .update(String(credentials.accessToken ?? \"\"))\n    .digest(\"hex\");\n\n  url.searchParams.set(\"appsecret_proof\", proof);\n  request.url = url.toString();\n}\n\n/** The Instagram for Business service, for the TypeScript runtime. */\nexport const INSTAGRAM_BUSINESS: ServiceDescriptor = {\n  service: \"instagram_business\",\n  title: \"Instagram for Business\",\n  sandbox: \"none\",\n  baseUrls: { ...INSTAGRAM_BUSINESS_BASE_URLS },\n  requires: [...INSTAGRAM_BUSINESS_REQUIRES],\n  authorize: instagramBusinessAuthorize,\n  faker: instagramBusinessFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/media-container-create.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/media-container-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Create an Instagram image container. This reports success before any post\n * exists: pass its id to Publish Instagram media, or the unpublished container\n * expires after 24 hours without producing a post.\n *\n * POST /{igUserId}/media —\n * https://developers.facebook.com/docs/instagram-platform/content-publishing/#create-a-container\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Instagram for Business or\n * calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"../service.js\";\n\nexport const MEDIA_CONTAINER_CREATE_OPERATION = \"media_container_create\";\n\nexport type MediaContainerCreateOptions = {\n  /** The node's resolved config. Keys: igUserId, imageUrl, caption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function instagramBusinessMediaContainerCreate(options: MediaContainerCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.igUserId === undefined || config.igUserId === null || config.igUserId === \"\") {\n    throw new Error(`media_container_create: \"igUserId\" is required (Instagram user ID).`);\n  }\n\n  if (config.imageUrl === undefined || config.imageUrl === null || config.imageUrl === \"\") {\n    throw new Error(`media_container_create: \"imageUrl\" is required (Image URL).`);\n  }\n\n  return callConnector(INSTAGRAM_BUSINESS, {\n    operation: MEDIA_CONTAINER_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/${encodeURIComponent(String(config.igUserId))}/media`,\n      json: {\n        \"image_url\": String(config.imageUrl),\n        ...(config.caption !== undefined && config.caption !== null && config.caption !== \"\" ? { \"caption\": String(config.caption) } : {}),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/media-publish.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/media-publish.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Publish a previously created Instagram media container as a real post.\n *\n * POST /{igUserId}/media_publish —\n * https://developers.facebook.com/docs/instagram-platform/content-publishing/#publish-the-container\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Instagram for Business or\n * calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"../service.js\";\n\nexport const MEDIA_PUBLISH_OPERATION = \"media_publish\";\n\nexport type MediaPublishOptions = {\n  /** The node's resolved config. Keys: igUserId, creationId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function instagramBusinessMediaPublish(options: MediaPublishOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.igUserId === undefined || config.igUserId === null || config.igUserId === \"\") {\n    throw new Error(`media_publish: \"igUserId\" is required (Instagram user ID).`);\n  }\n\n  if (config.creationId === undefined || config.creationId === null || config.creationId === \"\") {\n    throw new Error(`media_publish: \"creationId\" is required (Creation ID).`);\n  }\n\n  return callConnector(INSTAGRAM_BUSINESS, {\n    operation: MEDIA_PUBLISH_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/${encodeURIComponent(String(config.igUserId))}/media_publish`,\n      json: {\n        \"creation_id\": String(config.creationId),\n      },\n    },\n  });\n}\n"]}

package/dist/flow.cjs

@@ -0,0 +1,151 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+var crypto = require('crypto');
+var instagramBusinessUi = require('@particle-academy/instagram-business-ui');
+
+// src/flow.ts
+
+// src/faker.ts
+function fakeMediaContainerCreate({ config, fake }) {
+  return {
+    "id": "17889455560051444"
+  };
+}
+function fakeMediaPublish({ config, fake }) {
+  return {
+    "id": "17920238422030506"
+  };
+}
+var instagramBusinessFaker = (operation, request) => {
+  switch (operation) {
+    case "media_container_create":
+      return fakeMediaContainerCreate(request);
+    case "media_publish":
+      return fakeMediaPublish(request);
+    default:
+      throw new Error(
+        `instagram_business: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+var INSTAGRAM_BUSINESS_BASE_URLS = {
+  "live": "https://graph.facebook.com/v25.0"
+};
+var INSTAGRAM_BUSINESS_REQUIRES = [
+  "accessToken",
+  "appSecret",
+  "clientId",
+  "clientSecret"
+];
+function instagramBusinessAuthorize(credentials, request, _mode) {
+  const url = new URL(request.url);
+  url.searchParams.set("access_token", String(credentials.accessToken ?? ""));
+  const proof = crypto.createHmac("sha256", String(credentials.appSecret ?? "")).update(String(credentials.accessToken ?? "")).digest("hex");
+  url.searchParams.set("appsecret_proof", proof);
+  request.url = url.toString();
+}
+var INSTAGRAM_BUSINESS = {
+  service: "instagram_business",
+  title: "Instagram for Business",
+  sandbox: "none",
+  baseUrls: { ...INSTAGRAM_BUSINESS_BASE_URLS },
+  requires: [...INSTAGRAM_BUSINESS_REQUIRES],
+  authorize: instagramBusinessAuthorize,
+  faker: instagramBusinessFaker
+};
+var MEDIA_CONTAINER_CREATE_OPERATION = "media_container_create";
+async function instagramBusinessMediaContainerCreate(options) {
+  const config = options.config ?? {};
+  if (config.igUserId === void 0 || config.igUserId === null || config.igUserId === "") {
+    throw new Error(`media_container_create: "igUserId" is required (Instagram user ID).`);
+  }
+  if (config.imageUrl === void 0 || config.imageUrl === null || config.imageUrl === "") {
+    throw new Error(`media_container_create: "imageUrl" is required (Image URL).`);
+  }
+  return fancyConnectorCore.callConnector(INSTAGRAM_BUSINESS, {
+    operation: MEDIA_CONTAINER_CREATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/${encodeURIComponent(String(config.igUserId))}/media`,
+      json: {
+        "image_url": String(config.imageUrl),
+        ...config.caption !== void 0 && config.caption !== null && config.caption !== "" ? { "caption": String(config.caption) } : {}
+      }
+    }
+  });
+}
+var MEDIA_PUBLISH_OPERATION = "media_publish";
+async function instagramBusinessMediaPublish(options) {
+  const config = options.config ?? {};
+  if (config.igUserId === void 0 || config.igUserId === null || config.igUserId === "") {
+    throw new Error(`media_publish: "igUserId" is required (Instagram user ID).`);
+  }
+  if (config.creationId === void 0 || config.creationId === null || config.creationId === "") {
+    throw new Error(`media_publish: "creationId" is required (Creation ID).`);
+  }
+  return fancyConnectorCore.callConnector(INSTAGRAM_BUSINESS, {
+    operation: MEDIA_PUBLISH_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/${encodeURIComponent(String(config.igUserId))}/media_publish`,
+      json: {
+        "creation_id": String(config.creationId)
+      }
+    }
+  });
+}
+
+// src/flow.ts
+var instagramBusinessMediaContainerExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await instagramBusinessMediaContainerCreate({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `instagram_business media_container_create ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var instagramBusinessMediaPublishExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await instagramBusinessMediaPublish({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `instagram_business media_publish ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var INSTAGRAM_BUSINESS_RUNNABLE_KINDS = [
+  { ...instagramBusinessUi.instagramBusinessMediaContainerKind, executor: instagramBusinessMediaContainerExecutor },
+  { ...instagramBusinessUi.instagramBusinessMediaPublishKind, executor: instagramBusinessMediaPublishExecutor }
+];
+
+exports.INSTAGRAM_BUSINESS_RUNNABLE_KINDS = INSTAGRAM_BUSINESS_RUNNABLE_KINDS;
+exports.instagramBusinessMediaContainerExecutor = instagramBusinessMediaContainerExecutor;
+exports.instagramBusinessMediaPublishExecutor = instagramBusinessMediaPublishExecutor;
+//# sourceMappingURL=flow.cjs.map
+//# sourceMappingURL=flow.cjs.map

package/dist/flow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/media-container-create.ts","../src/actions/media-publish.ts","../src/flow.ts"],"names":["createHmac","callConnector","instagramBusinessMediaContainerKind","instagramBusinessMediaPublishKind"],"mappings":";;;;;;;;;AA0BA,SAAS,wBAAA,CAAyB,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AACxE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM;AAAA,GACR;AACF;AAEA,SAAS,gBAAA,CAAiB,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AAChE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM;AAAA,GACR;AACF;AAEO,IAAM,sBAAA,GAAyC,CAAC,SAAA,EAAW,OAAA,KAAY;AAC5E,EAAA,QAAQ,SAAA;AAAW,IACjB,KAAK,wBAAA;AACH,MAAA,OAAO,yBAAyB,OAAO,CAAA;AAAA,IAEzC,KAAK,eAAA;AACH,MAAA,OAAO,iBAAiB,OAAO,CAAA;AAAA,IAEjC;AAIE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,wDAAwD,SAAS,CAAA,iJAAA;AAAA,OAGnE;AAAA;AAEN,CAAA;AChBO,IAAM,4BAAA,GAA+B;AAAA,EAC1C,MAAA,EAAQ;AACV,CAAA;AAGO,IAAM,2BAAA,GAA8B;AAAA,EACzC,aAAA;AAAA,EACA,WAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF,CAAA;AAaO,SAAS,0BAAA,CACd,WAAA,EACA,OAAA,EACA,KAAA,EACM;AACN,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAE/B,EAAA,GAAA,CAAI,aAAa,GAAA,CAAI,cAAA,EAAgB,OAAO,WAAA,CAAY,WAAA,IAAe,EAAE,CAAC,CAAA;AAE1E,EAAA,MAAM,QAAQA,iBAAA,CAAW,QAAA,EAAU,MAAA,CAAO,WAAA,CAAY,aAAa,EAAE,CAAC,CAAA,CACnE,MAAA,CAAO,OAAO,WAAA,CAAY,WAAA,IAAe,EAAE,CAAC,CAAA,CAC5C,OAAO,KAAK,CAAA;AAEf,EAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,iBAAA,EAAmB,KAAK,CAAA;AAC7C,EAAA,OAAA,CAAQ,GAAA,GAAM,IAAI,QAAA,EAAS;AAC7B;AAGO,IAAM,kBAAA,GAAwC;AAAA,EACnD,OAAA,EAAS,oBAAA;AAAA,EACT,KAAA,EAAO,wBAAA;AAAA,EACP,OAAA,EAAS,MAAA;AAAA,EACT,QAAA,EAAU,EAAE,GAAG,4BAAA,EAA6B;AAAA,EAC5C,QAAA,EAAU,CAAC,GAAG,2BAA2B,CAAA;AAAA,EACzC,SAAA,EAAW,0BAAA;AAAA,EACX,KAAA,EAAO;AACT,CAAA;ACtDO,IAAM,gCAAA,GAAmC,wBAAA;AAchD,eAAsB,sCAAsC,OAAA,EAAgE;AAC1H,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,aAAa,MAAA,IAAa,MAAA,CAAO,aAAa,IAAA,IAAQ,MAAA,CAAO,aAAa,EAAA,EAAI;AACvF,IAAA,MAAM,IAAI,MAAM,CAAA,mEAAA,CAAqE,CAAA;AAAA,EACvF;AAEA,EAAA,IAAI,MAAA,CAAO,aAAa,MAAA,IAAa,MAAA,CAAO,aAAa,IAAA,IAAQ,MAAA,CAAO,aAAa,EAAA,EAAI;AACvF,IAAA,MAAM,IAAI,MAAM,CAAA,2DAAA,CAA6D,CAAA;AAAA,EAC/E;AAEA,EAAA,OAAOC,iCAAc,kBAAA,EAAoB;AAAA,IACvC,SAAA,EAAW,gCAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,MAAA;AAAA,MACR,MAAM,CAAA,CAAA,EAAI,kBAAA,CAAmB,OAAO,MAAA,CAAO,QAAQ,CAAC,CAAC,CAAA,MAAA,CAAA;AAAA,MACrD,IAAA,EAAM;AAAA,QACJ,WAAA,EAAa,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAA;AAAA,QACnC,GAAI,MAAA,CAAO,OAAA,KAAY,MAAA,IAAa,MAAA,CAAO,YAAY,IAAA,IAAQ,MAAA,CAAO,OAAA,KAAY,EAAA,GAAK,EAAE,SAAA,EAAW,MAAA,CAAO,OAAO,OAAO,CAAA,KAAM;AAAC;AAClI;AACF,GACD,CAAA;AACH;AC7CO,IAAM,uBAAA,GAA0B,eAAA;AAcvC,eAAsB,8BAA8B,OAAA,EAAwD;AAC1G,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,aAAa,MAAA,IAAa,MAAA,CAAO,aAAa,IAAA,IAAQ,MAAA,CAAO,aAAa,EAAA,EAAI;AACvF,IAAA,MAAM,IAAI,MAAM,CAAA,0DAAA,CAA4D,CAAA;AAAA,EAC9E;AAEA,EAAA,IAAI,MAAA,CAAO,eAAe,MAAA,IAAa,MAAA,CAAO,eAAe,IAAA,IAAQ,MAAA,CAAO,eAAe,EAAA,EAAI;AAC7F,IAAA,MAAM,IAAI,MAAM,CAAA,sDAAA,CAAwD,CAAA;AAAA,EAC1E;AAEA,EAAA,OAAOA,iCAAc,kBAAA,EAAoB;AAAA,IACvC,SAAA,EAAW,uBAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,MAAA;AAAA,MACR,MAAM,CAAA,CAAA,EAAI,kBAAA,CAAmB,OAAO,MAAA,CAAO,QAAQ,CAAC,CAAC,CAAA,cAAA,CAAA;AAAA,MACrD,IAAA,EAAM;AAAA,QACJ,aAAA,EAAe,MAAA,CAAO,MAAA,CAAO,UAAU;AAAA;AACzC;AACF,GACD,CAAA;AACH;;;ACrCO,IAAM,uCAAA,GAAwD,OAAO,GAAA,KAAQ;AAClF,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,qCAAA,CAAsC;AAAA,IACzD,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,0CAAA,EAA8C,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC3G,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAEO,IAAM,qCAAA,GAAsD,OAAO,GAAA,KAAQ;AAChF,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,6BAAA,CAA8B;AAAA,IACjD,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,iCAAA,EAAqC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAClG,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,iCAAA,GAA0D;AAAA,EACrE,EAAE,GAAGC,uDAAA,EAAqC,QAAA,EAAU,uCAAA,EAAwC;AAAA,EAC5F,EAAE,GAAGC,qDAAA,EAAmC,QAAA,EAAU,qCAAA;AACpD","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * The Instagram for Business faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Instagram for Business actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeMediaContainerCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": \"17889455560051444\",\n  };\n}\n\nfunction fakeMediaPublish({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": \"17920238422030506\",\n  };\n}\n\nexport const instagramBusinessFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"media_container_create\":\n      return fakeMediaContainerCreate(request);\n\n    case \"media_publish\":\n      return fakeMediaPublish(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `instagram_business: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Instagram for Business, as one service descriptor shared by every Instagram\n * for Business operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Instagram for Business: its base\n * URL, its auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Instagram publishing has no sandbox. Publishing creates a real post on a\n * real professional account, and an unpublished container expires after 24\n * hours.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { instagramBusinessFaker } from \"./faker.js\";\nimport { createHmac } from \"node:crypto\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const INSTAGRAM_BUSINESS_BASE_URLS = {\n  \"live\": \"https://graph.facebook.com/v25.0\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const INSTAGRAM_BUSINESS_REQUIRES = [\n  \"accessToken\",\n  \"appSecret\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Instagram for Business's auth scheme to an outgoing request.\n *\n * Meta documents the token as a query parameter. appsecret_proof travels\n * beside it so installations requiring App Secret Proof do not reject every\n * call.\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function instagramBusinessAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  const url = new URL(request.url);\n\n  url.searchParams.set(\"access_token\", String(credentials.accessToken ?? \"\"));\n\n  const proof = createHmac(\"sha256\", String(credentials.appSecret ?? \"\"))\n    .update(String(credentials.accessToken ?? \"\"))\n    .digest(\"hex\");\n\n  url.searchParams.set(\"appsecret_proof\", proof);\n  request.url = url.toString();\n}\n\n/** The Instagram for Business service, for the TypeScript runtime. */\nexport const INSTAGRAM_BUSINESS: ServiceDescriptor = {\n  service: \"instagram_business\",\n  title: \"Instagram for Business\",\n  sandbox: \"none\",\n  baseUrls: { ...INSTAGRAM_BUSINESS_BASE_URLS },\n  requires: [...INSTAGRAM_BUSINESS_REQUIRES],\n  authorize: instagramBusinessAuthorize,\n  faker: instagramBusinessFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/media-container-create.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/media-container-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Create an Instagram image container. This reports success before any post\n * exists: pass its id to Publish Instagram media, or the unpublished container\n * expires after 24 hours without producing a post.\n *\n * POST /{igUserId}/media —\n * https://developers.facebook.com/docs/instagram-platform/content-publishing/#create-a-container\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Instagram for Business or\n * calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"../service.js\";\n\nexport const MEDIA_CONTAINER_CREATE_OPERATION = \"media_container_create\";\n\nexport type MediaContainerCreateOptions = {\n  /** The node's resolved config. Keys: igUserId, imageUrl, caption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function instagramBusinessMediaContainerCreate(options: MediaContainerCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.igUserId === undefined || config.igUserId === null || config.igUserId === \"\") {\n    throw new Error(`media_container_create: \"igUserId\" is required (Instagram user ID).`);\n  }\n\n  if (config.imageUrl === undefined || config.imageUrl === null || config.imageUrl === \"\") {\n    throw new Error(`media_container_create: \"imageUrl\" is required (Image URL).`);\n  }\n\n  return callConnector(INSTAGRAM_BUSINESS, {\n    operation: MEDIA_CONTAINER_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/${encodeURIComponent(String(config.igUserId))}/media`,\n      json: {\n        \"image_url\": String(config.imageUrl),\n        ...(config.caption !== undefined && config.caption !== null && config.caption !== \"\" ? { \"caption\": String(config.caption) } : {}),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/media-publish.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/media-publish.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Publish a previously created Instagram media container as a real post.\n *\n * POST /{igUserId}/media_publish —\n * https://developers.facebook.com/docs/instagram-platform/content-publishing/#publish-the-container\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Instagram for Business or\n * calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"../service.js\";\n\nexport const MEDIA_PUBLISH_OPERATION = \"media_publish\";\n\nexport type MediaPublishOptions = {\n  /** The node's resolved config. Keys: igUserId, creationId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function instagramBusinessMediaPublish(options: MediaPublishOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.igUserId === undefined || config.igUserId === null || config.igUserId === \"\") {\n    throw new Error(`media_publish: \"igUserId\" is required (Instagram user ID).`);\n  }\n\n  if (config.creationId === undefined || config.creationId === null || config.creationId === \"\") {\n    throw new Error(`media_publish: \"creationId\" is required (Creation ID).`);\n  }\n\n  return callConnector(INSTAGRAM_BUSINESS, {\n    operation: MEDIA_PUBLISH_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/${encodeURIComponent(String(config.igUserId))}/media_publish`,\n      json: {\n        \"creation_id\": String(config.creationId),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Instagram for Business's node kinds with their TypeScript executors attached\n * — for hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/instagram-business-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"./service.js\";\n\nimport {\n  instagramBusinessMediaContainerKind,\n  instagramBusinessMediaPublishKind,\n} from \"@particle-academy/instagram-business-ui\";\n\nimport { instagramBusinessMediaContainerCreate } from \"./actions/media-container-create.js\";\nimport { instagramBusinessMediaPublish } from \"./actions/media-publish.js\";\n\nexport const instagramBusinessMediaContainerExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await instagramBusinessMediaContainerCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `instagram_business media_container_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const instagramBusinessMediaPublishExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await instagramBusinessMediaPublish({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `instagram_business media_publish ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const INSTAGRAM_BUSINESS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...instagramBusinessMediaContainerKind, executor: instagramBusinessMediaContainerExecutor },\n  { ...instagramBusinessMediaPublishKind, executor: instagramBusinessMediaPublishExecutor },\n];\n"]}

package/dist/flow.d.cts

@@ -0,0 +1,27 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Instagram for Business's node kinds with their TypeScript executors attached
+ * — for hosts that EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/instagram-business-ui carries no
+ * executor: the editor is React on every host, so a PHP or Python project
+ * installs the ui package and never this one.
+ */
+
+declare const instagramBusinessMediaContainerExecutor: NodeExecutor;
+declare const instagramBusinessMediaPublishExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const INSTAGRAM_BUSINESS_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { INSTAGRAM_BUSINESS_RUNNABLE_KINDS, instagramBusinessMediaContainerExecutor, instagramBusinessMediaPublishExecutor };

package/dist/flow.d.ts

@@ -0,0 +1,27 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Instagram for Business's node kinds with their TypeScript executors attached
+ * — for hosts that EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/instagram-business-ui carries no
+ * executor: the editor is React on every host, so a PHP or Python project
+ * installs the ui package and never this one.
+ */
+
+declare const instagramBusinessMediaContainerExecutor: NodeExecutor;
+declare const instagramBusinessMediaPublishExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const INSTAGRAM_BUSINESS_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { INSTAGRAM_BUSINESS_RUNNABLE_KINDS, instagramBusinessMediaContainerExecutor, instagramBusinessMediaPublishExecutor };

package/dist/flow.js

@@ -0,0 +1,40 @@
+import { instagramBusinessMediaContainerCreate, instagramBusinessMediaPublish } from './chunk-Z43FUIPD.js';
+import '@particle-academy/fancy-connector-core';
+import { instagramBusinessMediaContainerKind, instagramBusinessMediaPublishKind } from '@particle-academy/instagram-business-ui';
+
+var instagramBusinessMediaContainerExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await instagramBusinessMediaContainerCreate({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `instagram_business media_container_create ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var instagramBusinessMediaPublishExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await instagramBusinessMediaPublish({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `instagram_business media_publish ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var INSTAGRAM_BUSINESS_RUNNABLE_KINDS = [
+  { ...instagramBusinessMediaContainerKind, executor: instagramBusinessMediaContainerExecutor },
+  { ...instagramBusinessMediaPublishKind, executor: instagramBusinessMediaPublishExecutor }
+];
+
+export { INSTAGRAM_BUSINESS_RUNNABLE_KINDS, instagramBusinessMediaContainerExecutor, instagramBusinessMediaPublishExecutor };
+//# sourceMappingURL=flow.js.map
+//# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAsCO,IAAM,uCAAA,GAAwD,OAAO,GAAA,KAAQ;AAClF,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,qCAAA,CAAsC;AAAA,IACzD,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,0CAAA,EAA8C,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC3G,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAEO,IAAM,qCAAA,GAAsD,OAAO,GAAA,KAAQ;AAChF,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,6BAAA,CAA8B;AAAA,IACjD,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,iCAAA,EAAqC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAClG,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,iCAAA,GAA0D;AAAA,EACrE,EAAE,GAAG,mCAAA,EAAqC,QAAA,EAAU,uCAAA,EAAwC;AAAA,EAC5F,EAAE,GAAG,iCAAA,EAAmC,QAAA,EAAU,qCAAA;AACpD","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Instagram for Business's node kinds with their TypeScript executors attached\n * — for hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/instagram-business-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"./service.js\";\n\nimport {\n  instagramBusinessMediaContainerKind,\n  instagramBusinessMediaPublishKind,\n} from \"@particle-academy/instagram-business-ui\";\n\nimport { instagramBusinessMediaContainerCreate } from \"./actions/media-container-create.js\";\nimport { instagramBusinessMediaPublish } from \"./actions/media-publish.js\";\n\nexport const instagramBusinessMediaContainerExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await instagramBusinessMediaContainerCreate({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `instagram_business media_container_create ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\nexport const instagramBusinessMediaPublishExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await instagramBusinessMediaPublish({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `instagram_business media_publish ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const INSTAGRAM_BUSINESS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...instagramBusinessMediaContainerKind, executor: instagramBusinessMediaContainerExecutor },\n  { ...instagramBusinessMediaPublishKind, executor: instagramBusinessMediaPublishExecutor },\n];\n"]}

package/dist/index.cjs

@@ -0,0 +1,122 @@
+'use strict';
+
+var crypto = require('crypto');
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+
+// src/faker.ts
+function fakeMediaContainerCreate({ config, fake }) {
+  return {
+    "id": "17889455560051444"
+  };
+}
+function fakeMediaPublish({ config, fake }) {
+  return {
+    "id": "17920238422030506"
+  };
+}
+var instagramBusinessFaker = (operation, request) => {
+  switch (operation) {
+    case "media_container_create":
+      return fakeMediaContainerCreate(request);
+    case "media_publish":
+      return fakeMediaPublish(request);
+    default:
+      throw new Error(
+        `instagram_business: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+var CONNECTOR_API_VERSION = 1;
+var INSTAGRAM_BUSINESS_BASE_URLS = {
+  "live": "https://graph.facebook.com/v25.0"
+};
+var INSTAGRAM_BUSINESS_REQUIRES = [
+  "accessToken",
+  "appSecret",
+  "clientId",
+  "clientSecret"
+];
+function instagramBusinessAuthorize(credentials, request, _mode) {
+  const url = new URL(request.url);
+  url.searchParams.set("access_token", String(credentials.accessToken ?? ""));
+  const proof = crypto.createHmac("sha256", String(credentials.appSecret ?? "")).update(String(credentials.accessToken ?? "")).digest("hex");
+  url.searchParams.set("appsecret_proof", proof);
+  request.url = url.toString();
+}
+var INSTAGRAM_BUSINESS = {
+  service: "instagram_business",
+  title: "Instagram for Business",
+  sandbox: "none",
+  baseUrls: { ...INSTAGRAM_BUSINESS_BASE_URLS },
+  requires: [...INSTAGRAM_BUSINESS_REQUIRES],
+  authorize: instagramBusinessAuthorize,
+  faker: instagramBusinessFaker
+};
+var MEDIA_CONTAINER_CREATE_OPERATION = "media_container_create";
+async function instagramBusinessMediaContainerCreate(options) {
+  const config = options.config ?? {};
+  if (config.igUserId === void 0 || config.igUserId === null || config.igUserId === "") {
+    throw new Error(`media_container_create: "igUserId" is required (Instagram user ID).`);
+  }
+  if (config.imageUrl === void 0 || config.imageUrl === null || config.imageUrl === "") {
+    throw new Error(`media_container_create: "imageUrl" is required (Image URL).`);
+  }
+  return fancyConnectorCore.callConnector(INSTAGRAM_BUSINESS, {
+    operation: MEDIA_CONTAINER_CREATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/${encodeURIComponent(String(config.igUserId))}/media`,
+      json: {
+        "image_url": String(config.imageUrl),
+        ...config.caption !== void 0 && config.caption !== null && config.caption !== "" ? { "caption": String(config.caption) } : {}
+      }
+    }
+  });
+}
+var MEDIA_PUBLISH_OPERATION = "media_publish";
+async function instagramBusinessMediaPublish(options) {
+  const config = options.config ?? {};
+  if (config.igUserId === void 0 || config.igUserId === null || config.igUserId === "") {
+    throw new Error(`media_publish: "igUserId" is required (Instagram user ID).`);
+  }
+  if (config.creationId === void 0 || config.creationId === null || config.creationId === "") {
+    throw new Error(`media_publish: "creationId" is required (Creation ID).`);
+  }
+  return fancyConnectorCore.callConnector(INSTAGRAM_BUSINESS, {
+    operation: MEDIA_PUBLISH_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/${encodeURIComponent(String(config.igUserId))}/media_publish`,
+      json: {
+        "creation_id": String(config.creationId)
+      }
+    }
+  });
+}
+
+exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
+exports.INSTAGRAM_BUSINESS = INSTAGRAM_BUSINESS;
+exports.INSTAGRAM_BUSINESS_BASE_URLS = INSTAGRAM_BUSINESS_BASE_URLS;
+exports.INSTAGRAM_BUSINESS_REQUIRES = INSTAGRAM_BUSINESS_REQUIRES;
+exports.MEDIA_CONTAINER_CREATE_OPERATION = MEDIA_CONTAINER_CREATE_OPERATION;
+exports.MEDIA_PUBLISH_OPERATION = MEDIA_PUBLISH_OPERATION;
+exports.instagramBusinessAuthorize = instagramBusinessAuthorize;
+exports.instagramBusinessFaker = instagramBusinessFaker;
+exports.instagramBusinessMediaContainerCreate = instagramBusinessMediaContainerCreate;
+exports.instagramBusinessMediaPublish = instagramBusinessMediaPublish;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/media-container-create.ts","../src/actions/media-publish.ts"],"names":["createHmac","callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * The Instagram for Business faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Instagram for Business actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeMediaContainerCreate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": \"17889455560051444\",\n  };\n}\n\nfunction fakeMediaPublish({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": \"17920238422030506\",\n  };\n}\n\nexport const instagramBusinessFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"media_container_create\":\n      return fakeMediaContainerCreate(request);\n\n    case \"media_publish\":\n      return fakeMediaPublish(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `instagram_business: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Instagram for Business, as one service descriptor shared by every Instagram\n * for Business operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Instagram for Business: its base\n * URL, its auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Instagram publishing has no sandbox. Publishing creates a real post on a\n * real professional account, and an unpublished container expires after 24\n * hours.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { instagramBusinessFaker } from \"./faker.js\";\nimport { createHmac } from \"node:crypto\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const INSTAGRAM_BUSINESS_BASE_URLS = {\n  \"live\": \"https://graph.facebook.com/v25.0\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const INSTAGRAM_BUSINESS_REQUIRES = [\n  \"accessToken\",\n  \"appSecret\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Instagram for Business's auth scheme to an outgoing request.\n *\n * Meta documents the token as a query parameter. appsecret_proof travels\n * beside it so installations requiring App Secret Proof do not reject every\n * call.\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function instagramBusinessAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  const url = new URL(request.url);\n\n  url.searchParams.set(\"access_token\", String(credentials.accessToken ?? \"\"));\n\n  const proof = createHmac(\"sha256\", String(credentials.appSecret ?? \"\"))\n    .update(String(credentials.accessToken ?? \"\"))\n    .digest(\"hex\");\n\n  url.searchParams.set(\"appsecret_proof\", proof);\n  request.url = url.toString();\n}\n\n/** The Instagram for Business service, for the TypeScript runtime. */\nexport const INSTAGRAM_BUSINESS: ServiceDescriptor = {\n  service: \"instagram_business\",\n  title: \"Instagram for Business\",\n  sandbox: \"none\",\n  baseUrls: { ...INSTAGRAM_BUSINESS_BASE_URLS },\n  requires: [...INSTAGRAM_BUSINESS_REQUIRES],\n  authorize: instagramBusinessAuthorize,\n  faker: instagramBusinessFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/media-container-create.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/media-container-create.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Create an Instagram image container. This reports success before any post\n * exists: pass its id to Publish Instagram media, or the unpublished container\n * expires after 24 hours without producing a post.\n *\n * POST /{igUserId}/media —\n * https://developers.facebook.com/docs/instagram-platform/content-publishing/#create-a-container\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Instagram for Business or\n * calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"../service.js\";\n\nexport const MEDIA_CONTAINER_CREATE_OPERATION = \"media_container_create\";\n\nexport type MediaContainerCreateOptions = {\n  /** The node's resolved config. Keys: igUserId, imageUrl, caption. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function instagramBusinessMediaContainerCreate(options: MediaContainerCreateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.igUserId === undefined || config.igUserId === null || config.igUserId === \"\") {\n    throw new Error(`media_container_create: \"igUserId\" is required (Instagram user ID).`);\n  }\n\n  if (config.imageUrl === undefined || config.imageUrl === null || config.imageUrl === \"\") {\n    throw new Error(`media_container_create: \"imageUrl\" is required (Image URL).`);\n  }\n\n  return callConnector(INSTAGRAM_BUSINESS, {\n    operation: MEDIA_CONTAINER_CREATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/${encodeURIComponent(String(config.igUserId))}/media`,\n      json: {\n        \"image_url\": String(config.imageUrl),\n        ...(config.caption !== undefined && config.caption !== null && config.caption !== \"\" ? { \"caption\": String(config.caption) } : {}),\n      },\n    },\n  });\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/media-publish.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/media-publish.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- instagram_business\n */\n\n/**\n * Publish a previously created Instagram media container as a real post.\n *\n * POST /{igUserId}/media_publish —\n * https://developers.facebook.com/docs/instagram-platform/content-publishing/#publish-the-container\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Instagram for Business or\n * calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { INSTAGRAM_BUSINESS } from \"../service.js\";\n\nexport const MEDIA_PUBLISH_OPERATION = \"media_publish\";\n\nexport type MediaPublishOptions = {\n  /** The node's resolved config. Keys: igUserId, creationId. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function instagramBusinessMediaPublish(options: MediaPublishOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.igUserId === undefined || config.igUserId === null || config.igUserId === \"\") {\n    throw new Error(`media_publish: \"igUserId\" is required (Instagram user ID).`);\n  }\n\n  if (config.creationId === undefined || config.creationId === null || config.creationId === \"\") {\n    throw new Error(`media_publish: \"creationId\" is required (Creation ID).`);\n  }\n\n  return callConnector(INSTAGRAM_BUSINESS, {\n    operation: MEDIA_PUBLISH_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/${encodeURIComponent(String(config.igUserId))}/media_publish`,\n      json: {\n        \"creation_id\": String(config.creationId),\n      },\n    },\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,159 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Instagram for Business, as one service descriptor shared by every Instagram
+ * for Business operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Instagram for Business: its base
+ * URL, its auth scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Instagram publishing has no sandbox. Publishing creates a real post on a
+ * real professional account, and an unpublished container expires after 24
+ * hours.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const INSTAGRAM_BUSINESS_BASE_URLS: {
+    readonly live: "https://graph.facebook.com/v25.0";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const INSTAGRAM_BUSINESS_REQUIRES: readonly ["accessToken", "appSecret", "clientId", "clientSecret"];
+/**
+ * Apply Instagram for Business's auth scheme to an outgoing request.
+ *
+ * Meta documents the token as a query parameter. appsecret_proof travels
+ * beside it so installations requiring App Secret Proof do not reject every
+ * call.
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function instagramBusinessAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Instagram for Business service, for the TypeScript runtime. */
+declare const INSTAGRAM_BUSINESS: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * The Instagram for Business faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Instagram for Business actually publishes, so an author can wire {{
+ * $json.data.id }} against a fake and have it keep working against the real
+ * thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const instagramBusinessFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/media-container-create.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/media-container-create.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Create an Instagram image container. This reports success before any post
+ * exists: pass its id to Publish Instagram media, or the unpublished container
+ * expires after 24 hours without producing a post.
+ *
+ * POST /{igUserId}/media —
+ * https://developers.facebook.com/docs/instagram-platform/content-publishing/#create-a-container
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Instagram for Business or
+ * calls the faker.
+ *
+ * sideEffects: unsafe-to-replay.
+ */
+
+declare const MEDIA_CONTAINER_CREATE_OPERATION = "media_container_create";
+type MediaContainerCreateOptions = {
+    /** The node's resolved config. Keys: igUserId, imageUrl, caption. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function instagramBusinessMediaContainerCreate(options: MediaContainerCreateOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/media-publish.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/media-publish.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Publish a previously created Instagram media container as a real post.
+ *
+ * POST /{igUserId}/media_publish —
+ * https://developers.facebook.com/docs/instagram-platform/content-publishing/#publish-the-container
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Instagram for Business or
+ * calls the faker.
+ *
+ * sideEffects: unsafe-to-replay.
+ */
+
+declare const MEDIA_PUBLISH_OPERATION = "media_publish";
+type MediaPublishOptions = {
+    /** The node's resolved config. Keys: igUserId, creationId. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function instagramBusinessMediaPublish(options: MediaPublishOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, INSTAGRAM_BUSINESS, INSTAGRAM_BUSINESS_BASE_URLS, INSTAGRAM_BUSINESS_REQUIRES, MEDIA_CONTAINER_CREATE_OPERATION, MEDIA_PUBLISH_OPERATION, type MediaContainerCreateOptions, type MediaPublishOptions, instagramBusinessAuthorize, instagramBusinessFaker, instagramBusinessMediaContainerCreate, instagramBusinessMediaPublish };

package/dist/index.d.ts

@@ -0,0 +1,159 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Instagram for Business, as one service descriptor shared by every Instagram
+ * for Business operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Instagram for Business: its base
+ * URL, its auth scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Instagram publishing has no sandbox. Publishing creates a real post on a
+ * real professional account, and an unpublished container expires after 24
+ * hours.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const INSTAGRAM_BUSINESS_BASE_URLS: {
+    readonly live: "https://graph.facebook.com/v25.0";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const INSTAGRAM_BUSINESS_REQUIRES: readonly ["accessToken", "appSecret", "clientId", "clientSecret"];
+/**
+ * Apply Instagram for Business's auth scheme to an outgoing request.
+ *
+ * Meta documents the token as a query parameter. appsecret_proof travels
+ * beside it so installations requiring App Secret Proof do not reject every
+ * call.
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function instagramBusinessAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Instagram for Business service, for the TypeScript runtime. */
+declare const INSTAGRAM_BUSINESS: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * The Instagram for Business faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Instagram for Business actually publishes, so an author can wire {{
+ * $json.data.id }} against a fake and have it keep working against the real
+ * thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const instagramBusinessFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/media-container-create.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/media-container-create.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Create an Instagram image container. This reports success before any post
+ * exists: pass its id to Publish Instagram media, or the unpublished container
+ * expires after 24 hours without producing a post.
+ *
+ * POST /{igUserId}/media —
+ * https://developers.facebook.com/docs/instagram-platform/content-publishing/#create-a-container
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Instagram for Business or
+ * calls the faker.
+ *
+ * sideEffects: unsafe-to-replay.
+ */
+
+declare const MEDIA_CONTAINER_CREATE_OPERATION = "media_container_create";
+type MediaContainerCreateOptions = {
+    /** The node's resolved config. Keys: igUserId, imageUrl, caption. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function instagramBusinessMediaContainerCreate(options: MediaContainerCreateOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/media-publish.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/media-publish.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- instagram_business
+ */
+/**
+ * Publish a previously created Instagram media container as a real post.
+ *
+ * POST /{igUserId}/media_publish —
+ * https://developers.facebook.com/docs/instagram-platform/content-publishing/#publish-the-container
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Instagram for Business or
+ * calls the faker.
+ *
+ * sideEffects: unsafe-to-replay.
+ */
+
+declare const MEDIA_PUBLISH_OPERATION = "media_publish";
+type MediaPublishOptions = {
+    /** The node's resolved config. Keys: igUserId, creationId. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function instagramBusinessMediaPublish(options: MediaPublishOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, INSTAGRAM_BUSINESS, INSTAGRAM_BUSINESS_BASE_URLS, INSTAGRAM_BUSINESS_REQUIRES, MEDIA_CONTAINER_CREATE_OPERATION, MEDIA_PUBLISH_OPERATION, type MediaContainerCreateOptions, type MediaPublishOptions, instagramBusinessAuthorize, instagramBusinessFaker, instagramBusinessMediaContainerCreate, instagramBusinessMediaPublish };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CONNECTOR_API_VERSION, INSTAGRAM_BUSINESS, INSTAGRAM_BUSINESS_BASE_URLS, INSTAGRAM_BUSINESS_REQUIRES, MEDIA_CONTAINER_CREATE_OPERATION, MEDIA_PUBLISH_OPERATION, instagramBusinessAuthorize, instagramBusinessFaker, instagramBusinessMediaContainerCreate, instagramBusinessMediaPublish } from './chunk-Z43FUIPD.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@particle-academy/instagram-business-js",
+  "version": "0.1.0",
+  "description": "Instagram for Business for Node — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP on @particle-academy/fancy-connector-core; no vendor SDK.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Fancy-Friends/instagram-business.git"
+  },
+  "homepage": "https://github.com/Fancy-Friends/instagram-business#readme",
+  "bugs": "https://github.com/Fancy-Friends/instagram-business/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./flow": {
+      "import": {
+        "types": "./dist/flow.d.ts",
+        "default": "./dist/flow.js"
+      },
+      "require": {
+        "types": "./dist/flow.d.cts",
+        "default": "./dist/flow.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "tsc --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "prepublishOnly": "tsup"
+  },
+  "dependencies": {
+    "@particle-academy/fancy-connector-core": ">=0.3.1 <2.0"
+  },
+  "peerDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@particle-academy/instagram-business-ui": ">=0.1.0 <0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@particle-academy/fancy-flow": {
+      "optional": true
+    },
+    "@particle-academy/instagram-business-ui": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@types/node": "^26.2.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "instagram_business",
+    "marketing",
+    "connector",
+    "api",
+    "fancy-ui",
+    "particle-academy"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  }
+}