@apicity/meta 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justin Tanner
+
+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,356 @@
+# @apicity/meta
+
+[![npm](https://img.shields.io/npm/v/@apicity/meta?color=cb0000)](https://www.npmjs.com/package/@apicity/meta)
+[![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript&logoColor=white)](tsconfig.json)
+
+Instagram Graph API provider for posting reels via the public-URL flow (graph.instagram.com).
+
+## Installation
+
+```bash
+npm install @apicity/meta
+# or
+pnpm add @apicity/meta
+```
+
+## Quick Start
+
+```typescript
+import { meta as createMeta } from "@apicity/meta";
+
+const meta = createMeta({ apiKey: process.env.META_API_KEY! });
+```
+
+## Setup
+
+Instagram requires a **long-lived (60-day) user access token** from the
+Instagram Login OAuth flow. The token is bound to a specific Instagram
+Business or Creator account; personal accounts have no programmatic
+publishing access.
+
+### 1. Configure your Meta App
+
+Open [developers.facebook.com](https://developers.facebook.com), create a
+new app (type: **Business**), then add the **Instagram** product.
+Choose **API setup with Instagram login** and configure:
+
+- Valid OAuth Redirect URI: `http://127.0.0.1:8765/callback`
+- Permissions: `instagram_business_basic` + `instagram_business_content_publish`
+- Save the **Instagram App ID** and **Instagram App Secret**
+
+### 2. Verify Instagram account type
+
+The Instagram account you're publishing to must be **Business** or
+**Creator** (not Personal). Switch in the Instagram mobile app under
+Settings → Account type and tools. No Facebook Page link is required
+for the Instagram Login flow.
+
+### 3. Mint a long-lived access token
+
+Save the script below as `mint-ig-token.mjs` and run it:
+
+```bash
+IG_CLIENT_ID=<your-instagram-app-id> \
+IG_CLIENT_SECRET=<your-instagram-app-secret> \
+  node mint-ig-token.mjs
+```
+
+It prints an authorize URL — open it, click **Allow**, and the helper
+captures the redirect on `127.0.0.1:8765`, exchanges the code for a
+short-lived token, then upgrades it to a long-lived (60-day) token and
+prints `{ access_token, user_id, expires_in }`. Save both `access_token`
+and `user_id` — you need both to call the API.
+
+<details>
+<summary><code>mint-ig-token.mjs</code> — zero-dep OAuth 2.0 helper</summary>
+
+```javascript
+import http from "node:http";
+import crypto from "node:crypto";
+
+const CLIENT_ID = process.env.IG_CLIENT_ID;
+const CLIENT_SECRET = process.env.IG_CLIENT_SECRET;
+const REDIRECT = "http://127.0.0.1:8765/callback";
+const SCOPES = [
+  "instagram_business_basic",
+  "instagram_business_content_publish",
+].join(",");
+
+if (!CLIENT_ID || !CLIENT_SECRET) {
+  console.error("Set IG_CLIENT_ID and IG_CLIENT_SECRET");
+  process.exit(1);
+}
+
+const state = crypto.randomBytes(16).toString("hex");
+const authURL = new URL("https://www.instagram.com/oauth/authorize");
+authURL.searchParams.set("client_id", CLIENT_ID);
+authURL.searchParams.set("redirect_uri", REDIRECT);
+authURL.searchParams.set("response_type", "code");
+authURL.searchParams.set("scope", SCOPES);
+authURL.searchParams.set("state", state);
+
+console.log("Open this URL and click Allow:\n" + authURL.toString());
+
+const server = http.createServer(async (req, res) => {
+  const url = new URL(req.url, REDIRECT);
+  if (!url.pathname.startsWith("/callback")) {
+    res.writeHead(404).end();
+    return;
+  }
+  const code = url.searchParams.get("code");
+  if (!code || url.searchParams.get("state") !== state) {
+    res.writeHead(400).end("bad state");
+    server.close();
+    process.exit(1);
+  }
+
+  // 1. short-lived
+  const shortRes = await fetch(
+    "https://api.instagram.com/oauth/access_token",
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body: new URLSearchParams({
+        client_id: CLIENT_ID,
+        client_secret: CLIENT_SECRET,
+        grant_type: "authorization_code",
+        redirect_uri: REDIRECT,
+        code,
+      }),
+    }
+  );
+  const short = await shortRes.json();
+
+  // 2. long-lived (60-day)
+  const longURL = new URL("https://graph.instagram.com/access_token");
+  longURL.searchParams.set("grant_type", "ig_exchange_token");
+  longURL.searchParams.set("client_secret", CLIENT_SECRET);
+  longURL.searchParams.set("access_token", short.access_token);
+  const longRes = await fetch(longURL);
+  const long = await longRes.json();
+
+  console.log(JSON.stringify({
+    access_token: long.access_token,
+    expires_in: long.expires_in,
+    user_id: short.user_id,
+  }, null, 2));
+  res.writeHead(200).end("Authorized — check your terminal.");
+  server.close();
+});
+
+server.listen(8765, "127.0.0.1");
+```
+
+</details>
+
+### 4. Use the token
+
+```typescript
+import { meta as createMeta } from "@apicity/meta";
+
+const meta = createIg({ accessToken: process.env.IG_ACCESS_TOKEN });
+const igUserId = process.env.IG_USER_ID;
+
+// Public-URL flow: host the mp4 somewhere (e.g. via @apicity/free-media-upload) and
+// pass its URL. Meta GETs the video and processes it asynchronously.
+const container = await ig.post.v25.media(igUserId, {
+  media_type: "REELS",
+  video_url: "https://example.com/clip.mp4",
+  caption: "hello from @apicity/meta",
+});
+
+// Poll until the container is ready.
+let status = "IN_PROGRESS";
+while (status === "IN_PROGRESS") {
+  await new Promise((r) => setTimeout(r, 5000));
+  const s = await ig.get.v25.container(container.id, {
+    fields: "status_code,status",
+  });
+  status = s.status_code ?? "FINISHED";
+}
+
+// Publish.
+const post = await ig.post.v25.mediaPublish(igUserId, {
+  creation_id: container.id,
+});
+console.log(post.id);
+```
+
+## Real-world example: publish a Reel via the public-URL flow
+
+Instagram's Graph API doesn't take video bytes directly — Meta needs a
+publicly reachable URL it can `GET` and transcode asynchronously. The
+snippet below chains `@apicity/free-media-upload` (catbox public hosting, free + zero
+auth) into `@apicity/meta` to land an `mp4` on disk as a published Reel,
+mirroring
+[`tests/integration/ig-post-video.test.ts`](../../../tests/integration/ig-post-video.test.ts)
+step-for-step. The catbox upload replays against
+[`tests/recordings/free_2578706139/`](../../../tests/recordings/free_2578706139/);
+the IG calls land in `tests/recordings/ig_*/post-video_*/recording.har`
+once a Business/Creator account's `IG_ACCESS_TOKEN` is recorded.
+
+```typescript
+import { readFileSync } from "node:fs";
+import { meta as createMeta } from "@apicity/meta";
+import { freeMediaUpload as createFreeMediaUpload } from "@apicity/free-media-upload";
+
+const meta = createIg({ accessToken: process.env.IG_ACCESS_TOKEN! });
+const igUserId = process.env.IG_USER_ID!; // 17-digit numeric, e.g. "17841471234567890"
+
+// 1. Host the mp4 publicly. catbox.moe is auth-free and persistent —
+//    Meta's transcode worker will fetch this URL once during step 2,
+//    so any host that returns the bytes within ~30s works (S3 presigned
+//    URL, R2, your own CDN). @apicity/free-media-upload wraps the multipart upload
+//    and returns the resolved file URL as a string.
+const bytes = readFileSync("./jump.mp4");
+const blob = new Blob([bytes], { type: "video/mp4" });
+
+const freeMediaUpload = createFree({});
+const videoUrl = await free.catbox.upload({
+  file: blob,
+  filename: "jump.mp4",
+});
+console.log(videoUrl);
+// → "https://files.catbox.moe/nn9sei.mp4"
+//   catbox returns a permanent public URL of the form
+//   `https://files.catbox.moe/<6char>.<ext>` — that's what Meta will GET.
+
+// 2. Create a media container. For Reels you must pass `media_type:
+//    "REELS"` (NOT "VIDEO" — that's the legacy IGTV path Meta
+//    deprecated in 2024). The container is a server-side handle: Meta
+//    queues the transcode against `video_url` and returns its id
+//    immediately. Containers expire 24h after creation if you don't
+//    publish them.
+const container = await ig.post.v25.media(igUserId, {
+  media_type: "REELS",
+  video_url: videoUrl,
+  caption: "jump #reels",
+});
+console.log(container.id);
+// → "17889012345678901" (17-digit container id)
+
+// 3. Poll the container's status_code until it leaves IN_PROGRESS.
+//    The state machine is IN_PROGRESS → FINISHED on success;
+//    FINISHED is the only state media_publish accepts. ERROR and
+//    EXPIRED are terminal failure states; PUBLISHED is what you'll
+//    see if you re-poll AFTER calling media_publish. The `fields`
+//    query param is required — by default the GET only returns `id`.
+let statusCode: string = "IN_PROGRESS";
+while (statusCode === "IN_PROGRESS") {
+  await new Promise((r) => setTimeout(r, 5000));
+  const s = await ig.get.v25.container(container.id, {
+    fields: "status_code,status",
+  });
+  statusCode = s.status_code ?? "FINISHED";
+  if (statusCode === "ERROR" || statusCode === "EXPIRED") {
+    throw new Error(`container ${container.id} ${statusCode}: ${s.status}`);
+  }
+}
+// statusCode → "FINISHED"
+// s.status   → "Finished: Media is ready to be published."
+
+// 4. Publish. media_publish takes the container id (NOT the media url)
+//    and returns the new post's id — that's the permanent ig_id you'd
+//    use to construct an https://www.instagram.com/reel/<shortcode>/
+//    URL or to query insights later via Graph API.
+const post = await ig.post.v25.mediaPublish(igUserId, {
+  creation_id: container.id,
+});
+console.log(post.id);
+// → "17912345678901234" (17-digit post id, distinct from container id)
+```
+
+**Notes**
+
+- Meta requires a **Business** or **Creator** Instagram account plus a
+  Meta App approved for `instagram_business_content_publish`. Personal
+  accounts get `190` ("Invalid OAuth access token") even with a
+  syntactically valid token.
+- `video_url` must be reachable from Meta's IPs and serve `Content-Type:
+  video/mp4`. Common gotchas: presigned S3 URLs that expire before the
+  transcoder pulls, hosts that require a `User-Agent`, and CDNs that
+  redirect to a different origin. catbox.moe sidesteps all three.
+- The Reel itself must satisfy Meta's Reel constraints — 9:16 aspect,
+  3–90s duration, ≤ 1GB, H.264 video, AAC audio. Mismatches surface as
+  `status_code: "ERROR"` during the poll, with the human-readable
+  reason in `status` (e.g. `"Error: The video is too short."`).
+- Containers and posts use **distinct** 17-digit ids. The container id
+  is throwaway — you only need it for the GET poll and the subsequent
+  `media_publish` `creation_id`. The post id is permanent and survives
+  user deletion of the post.
+- Errors throw `MetaError` with `status` (HTTP code), `body` (the parsed
+  Meta error envelope), and an optional `code`. Meta's two error shapes
+  — `error.error_user_msg` for user-facing validation and `error.message`
+  for everything else — are both surfaced in `MetaError.message`, so a
+  single `try/catch` reads naturally.
+
+## API Reference
+
+3 endpoints across 3 groups. Each method mirrors an upstream URL path.
+
+### container
+
+<details>
+<summary><code>GET</code> <b><code>meta.v25.container</code></b></summary>
+
+<code>GET https://graph.instagram.com/v25.0/{containerId}{query}</code>
+
+[Upstream docs ↗](https://developers.facebook.com/docs/instagram-platform/reference/ig-container/)
+
+```typescript
+const res = await meta.v25.container({ /* ... */ });
+```
+
+Source: [`packages/provider/meta/src/meta.ts`](src/meta.ts)
+
+</details>
+
+### media
+
+<details>
+<summary><code>POST</code> <b><code>meta.v25.media</code></b></summary>
+
+<code>POST https://graph.instagram.com/v25.0/{igUserId}/media</code>
+
+[Upstream docs ↗](https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/reference/ig-user/media/)
+
+```typescript
+const res = await meta.v25.media({ /* ... */ });
+```
+
+Source: [`packages/provider/meta/src/meta.ts`](src/meta.ts)
+
+</details>
+
+### mediaPublish
+
+<details>
+<summary><code>POST</code> <b><code>meta.v25.mediaPublish</code></b></summary>
+
+<code>POST https://graph.instagram.com/v25.0/{igUserId}/media_publish</code>
+
+[Upstream docs ↗](https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/reference/ig-user/media_publish/)
+
+```typescript
+const res = await meta.v25.mediaPublish({ /* ... */ });
+```
+
+Source: [`packages/provider/meta/src/meta.ts`](src/meta.ts)
+
+</details>
+
+## Middleware
+
+```typescript
+import { meta as createMeta, withRetry } from "@apicity/meta";
+
+const meta = createMeta({ apiKey: process.env.META_API_KEY! });
+const models = withRetry(meta.get.v1.models, { retries: 3 });
+```
+
+Part of the [apicity](https://github.com/justintanner/apicity) monorepo.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/src/example.d.ts

@@ -0,0 +1,8 @@
+export interface EndpointExample {
+    source: string;
+    payload: unknown;
+}
+declare const EXAMPLES: Record<string, EndpointExample>;
+export default EXAMPLES;
+export declare function attachExamples<T>(provider: T): T;
+//# sourceMappingURL=example.d.ts.map

package/dist/src/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAS7C,CAAC;AAEF,eAAe,QAAQ,CAAC;AAOxB,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA6ChD"}

package/dist/src/example.js

@@ -0,0 +1,94 @@
+// Auto-generated by `pnpm run gen:examples` — do not edit by hand.
+// Source: tests/recordings/<provider>_*/<test>_*/recording.har
+//
+// Each entry is the green-path payload for one endpoint, mined from a real
+// integration-test recording. `attachExamples` walks the provider tree and
+// hangs the matching entry off each endpoint function as `.example`.
+const EXAMPLES = {
+    "POST v25.media": {
+        "source": "meta/media-create",
+        "payload": {
+            "media_type": "REELS",
+            "video_url": "https://files.catbox.moe/example-reel.mp4",
+            "caption": "hello from @apicity/meta"
+        }
+    }
+};
+export default EXAMPLES;
+// Walks each "<METHOD> <dotPath>" key onto the provider's tree. Tries the
+// standard `provider.<method>.<dotPath>` shape first, then a few fallbacks
+// to cover providers with non-standard layouts (fal's `.run.` namespace,
+// kie's sub-providers, `free`'s flat root). Returns the same provider for
+// drop-in use as `return attachExamples({ ... });`.
+export function attachExamples(provider) {
+    const root = provider;
+    const HTTP_KEYS = new Set(["post", "get", "put", "delete", "patch", "head"]);
+    for (const [key, example] of Object.entries(EXAMPLES)) {
+        const sp = key.indexOf(" ");
+        if (sp < 0)
+            continue;
+        const method = key.slice(0, sp).toLowerCase();
+        const segs = key.slice(sp + 1).split(".");
+        const candidates = [
+            root[method],
+            root[method]?.run,
+            root,
+        ];
+        if (segs.length > 1) {
+            const sub = root[segs[0]];
+            if (sub && typeof sub === "object") {
+                const subMethod = sub[method];
+                if (subMethod)
+                    candidates.push({ __nested: subMethod, __segs: segs.slice(1) });
+            }
+        }
+        let attached = false;
+        for (const c of candidates) {
+            const fn = walkToFn(c, segs);
+            if (fn) {
+                Object.assign(fn, { example });
+                attached = true;
+                break;
+            }
+        }
+        if (attached)
+            continue;
+        for (const k of Object.keys(root)) {
+            if (HTTP_KEYS.has(k))
+                continue;
+            if (!segs.includes(k))
+                continue;
+            const sub = root[k];
+            if (!sub || typeof sub !== "object")
+                continue;
+            const subMethod = sub[method];
+            if (!subMethod)
+                continue;
+            const fn = walkToFn(subMethod, segs);
+            if (fn) {
+                Object.assign(fn, { example });
+                break;
+            }
+        }
+    }
+    return provider;
+}
+function walkToFn(start, segs) {
+    if (start && typeof start === "object" && "__nested" in start) {
+        const wrapper = start;
+        return walkToFn(wrapper.__nested, wrapper.__segs);
+    }
+    let cur = start;
+    for (const seg of segs) {
+        if (cur === null || cur === undefined)
+            return null;
+        const t = typeof cur;
+        if (t !== "object" && t !== "function")
+            return null;
+        cur = cur[seg];
+    }
+    return typeof cur === "function"
+        ? cur
+        : null;
+}
+//# sourceMappingURL=example.js.map

package/dist/src/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { meta } from "./meta";
+export { MetaError } from "./types";
+export type { MetaOptions, MetaMediaCreateRequest, MetaMediaCreateResponse, MetaMediaCreateMethod, MetaContainerStatusCode, MetaContainerStatusQuery, MetaContainerStatusResponse, MetaContainerStatusMethod, MetaMediaPublishRequest, MetaMediaPublishResponse, MetaMediaPublishMethod, MetaPostV25Namespace, MetaPostNamespace, MetaGetV25Namespace, MetaGetNamespace, MetaProvider, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,YAAY,EACV,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+export { meta } from "./meta.js";
+export { MetaError } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/src/meta.d.ts

@@ -0,0 +1,3 @@
+import { MetaOptions, MetaProvider } from "./types";
+export declare function meta(opts: MetaOptions): MetaProvider;
+//# sourceMappingURL=meta.d.ts.map

package/dist/src/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAOX,YAAY,EAEb,MAAM,SAAS,CAAC;AAOjB,wBAAgB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAiKpD"}

package/dist/src/meta.js

@@ -0,0 +1,104 @@
+import { MetaError, } from "./types.js";
+import { MetaMediaCreateRequestSchema, MetaMediaPublishRequestSchema, } from "./zod.js";
+import { attachExamples } from "./example.js";
+export function meta(opts) {
+    const baseURL = opts.baseURL ?? "https://graph.instagram.com";
+    const doFetch = opts.fetch ?? fetch;
+    const timeout = opts.timeout ?? 30000;
+    function attachAbortHandler(signal, controller) {
+        if (signal.aborted) {
+            controller.abort();
+            return;
+        }
+        signal.addEventListener("abort", () => controller.abort(), { once: true });
+    }
+    // Meta Graph API errors come as `{ error: { message, type, code, ... } }`
+    // for the legacy shape, with a top-level `error_user_msg` available on
+    // some validation failures. Surface whichever the server sent so the
+    // caller sees the actual reason rather than a generic "IG API error: 400".
+    function formatErrorMessage(status, body) {
+        if (typeof body === "object" && body !== null) {
+            const b = body;
+            if (b.error?.error_user_msg)
+                return `IG API error ${status}: ${b.error.error_user_msg}`;
+            if (b.error?.message)
+                return `IG API error ${status}: ${b.error.message}`;
+        }
+        return `IG API error: ${status}`;
+    }
+    async function makeJsonRequest(method, path, body, signal) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        if (signal) {
+            attachAbortHandler(signal, controller);
+        }
+        try {
+            const headers = {
+                Authorization: `Bearer ${opts.accessToken}`,
+            };
+            const init = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (body !== undefined) {
+                headers["Content-Type"] = "application/json";
+                init.body = JSON.stringify(body);
+            }
+            const res = await doFetch(`${baseURL}${path}`, init);
+            clearTimeout(timeoutId);
+            if (!res.ok) {
+                let resBody = null;
+                try {
+                    resBody = await res.json();
+                }
+                catch {
+                    // ignore parse errors
+                }
+                throw new MetaError(formatErrorMessage(res.status, resBody), res.status, resBody);
+            }
+            return (await res.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof MetaError)
+                throw error;
+            throw new MetaError(`IG request failed: ${error}`, 500);
+        }
+    }
+    // sig-ok: numeric URL segments (`/v25.0/`) become identifier-safe (`v25`)
+    // POST https://graph.instagram.com/v25.0/{igUserId}/media
+    // Docs: https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/reference/ig-user/media/
+    const mediaCreate = Object.assign(async (igUserId, req, signal) => {
+        return makeJsonRequest("POST", `/v25.0/${encodeURIComponent(igUserId)}/media`, req, signal);
+    }, { schema: MetaMediaCreateRequestSchema });
+    // sig-ok: numeric URL segments (`/v25.0/`) become identifier-safe (`v25`)
+    // GET https://graph.instagram.com/v25.0/{containerId}{query}
+    // Docs: https://developers.facebook.com/docs/instagram-platform/reference/ig-container/
+    async function containerStatus(containerId, params, signal) {
+        const query = params?.fields
+            ? `?fields=${encodeURIComponent(params.fields)}`
+            : "";
+        return makeJsonRequest("GET", `/v25.0/${encodeURIComponent(containerId)}${query}`, undefined, signal);
+    }
+    // sig-ok: numeric URL segments (`/v25.0/`) become identifier-safe (`v25`)
+    // POST https://graph.instagram.com/v25.0/{igUserId}/media_publish
+    // Docs: https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/reference/ig-user/media_publish/
+    const mediaPublish = Object.assign(async (igUserId, req, signal) => {
+        return makeJsonRequest("POST", `/v25.0/${encodeURIComponent(igUserId)}/media_publish`, req, signal);
+    }, { schema: MetaMediaPublishRequestSchema });
+    return attachExamples({
+        post: {
+            v25: {
+                media: mediaCreate,
+                mediaPublish,
+            },
+        },
+        get: {
+            v25: {
+                container: containerStatus,
+            },
+        },
+    });
+}
+//# sourceMappingURL=meta.js.map

package/dist/src/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/meta.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,55 @@
+import type { z } from "zod";
+import type { MetaMediaCreateRequest, MetaMediaPublishRequest } from "./zod";
+export type { MetaOptions, MetaMediaCreateRequest, MetaMediaPublishRequest, } from "./zod";
+export declare class MetaError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    readonly code?: string;
+    constructor(message: string, status: number, body?: unknown, code?: string);
+}
+export interface MetaMediaCreateResponse {
+    id: string;
+}
+export type MetaContainerStatusCode = "EXPIRED" | "ERROR" | "FINISHED" | "IN_PROGRESS" | "PUBLISHED";
+export interface MetaContainerStatusResponse {
+    id: string;
+    status_code?: MetaContainerStatusCode;
+    status?: string;
+}
+export interface MetaContainerStatusQuery {
+    /** Comma-separated field list. Default returns only `id`; pass
+     *  `"status_code,status"` to read processing state. */
+    fields?: string;
+}
+export interface MetaMediaCreateMethod {
+    (igUserId: string, req: MetaMediaCreateRequest, signal?: AbortSignal): Promise<MetaMediaCreateResponse>;
+    schema: z.ZodType<MetaMediaCreateRequest>;
+}
+export interface MetaContainerStatusMethod {
+    (containerId: string, query?: MetaContainerStatusQuery, signal?: AbortSignal): Promise<MetaContainerStatusResponse>;
+}
+export interface MetaMediaPublishResponse {
+    id: string;
+}
+export interface MetaMediaPublishMethod {
+    (igUserId: string, req: MetaMediaPublishRequest, signal?: AbortSignal): Promise<MetaMediaPublishResponse>;
+    schema: z.ZodType<MetaMediaPublishRequest>;
+}
+export interface MetaPostV25Namespace {
+    media: MetaMediaCreateMethod;
+    mediaPublish: MetaMediaPublishMethod;
+}
+export interface MetaPostNamespace {
+    v25: MetaPostV25Namespace;
+}
+export interface MetaGetV25Namespace {
+    container: MetaContainerStatusMethod;
+}
+export interface MetaGetNamespace {
+    v25: MetaGetV25Namespace;
+}
+export interface MetaProvider {
+    post: MetaPostNamespace;
+    get: MetaGetNamespace;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC;AAE7E,YAAY,EACV,WAAW,EACX,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,OAAO,CAAC;AAIf,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM;CAO3E;AAMD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,OAAO,GACP,UAAU,GACV,aAAa,GACb,WAAW,CAAC;AAKhB,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC;2DACuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,qBAAqB;IACpC,CACE,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,sBAAsB,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,CACE,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,wBAAwB,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,sBAAsB;IACrC,CACE,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,uBAAuB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC5C;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,YAAY,EAAE,sBAAsB,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,oBAAoB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,yBAAyB,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,mBAAmB,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,GAAG,EAAE,gBAAgB,CAAC;CACvB"}

package/dist/src/types.js

@@ -0,0 +1,14 @@
+// -- Error -------------------------------------------------------------------
+export class MetaError extends Error {
+    status;
+    body;
+    code;
+    constructor(message, status, body, code) {
+        super(message);
+        this.name = "MetaError";
+        this.status = status;
+        this.body = body ?? null;
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AASA,+EAA+E;AAE/E,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,MAAM,CAAS;IACf,IAAI,CAAU;IACd,IAAI,CAAU;IAEvB,YAAY,OAAe,EAAE,MAAc,EAAE,IAAc,EAAE,IAAa;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/src/zod.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+export declare const MetaOptionsSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    baseURL: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    fetch: z.ZodOptional<z.ZodType<typeof fetch, z.ZodTypeDef, typeof fetch>>;
+}, "strip", z.ZodTypeAny, {
+    accessToken: string;
+    baseURL?: string | undefined;
+    timeout?: number | undefined;
+    fetch?: typeof fetch | undefined;
+}, {
+    accessToken: string;
+    baseURL?: string | undefined;
+    timeout?: number | undefined;
+    fetch?: typeof fetch | undefined;
+}>;
+export type MetaOptions = z.infer<typeof MetaOptionsSchema>;
+export declare const MetaMediaCreateRequestSchema: z.ZodObject<{
+    media_type: z.ZodEnum<["REELS", "VIDEO", "IMAGE", "CAROUSEL"]>;
+    video_url: z.ZodOptional<z.ZodString>;
+    image_url: z.ZodOptional<z.ZodString>;
+    caption: z.ZodOptional<z.ZodString>;
+    thumb_offset: z.ZodOptional<z.ZodNumber>;
+    share_to_feed: z.ZodOptional<z.ZodBoolean>;
+    location_id: z.ZodOptional<z.ZodString>;
+    user_tags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        username: z.ZodString;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        username: string;
+        x?: number | undefined;
+        y?: number | undefined;
+    }, {
+        username: string;
+        x?: number | undefined;
+        y?: number | undefined;
+    }>, "many">>;
+    collaborators: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    media_type: "REELS" | "VIDEO" | "IMAGE" | "CAROUSEL";
+    video_url?: string | undefined;
+    image_url?: string | undefined;
+    caption?: string | undefined;
+    thumb_offset?: number | undefined;
+    share_to_feed?: boolean | undefined;
+    location_id?: string | undefined;
+    user_tags?: {
+        username: string;
+        x?: number | undefined;
+        y?: number | undefined;
+    }[] | undefined;
+    collaborators?: string[] | undefined;
+}, {
+    media_type: "REELS" | "VIDEO" | "IMAGE" | "CAROUSEL";
+    video_url?: string | undefined;
+    image_url?: string | undefined;
+    caption?: string | undefined;
+    thumb_offset?: number | undefined;
+    share_to_feed?: boolean | undefined;
+    location_id?: string | undefined;
+    user_tags?: {
+        username: string;
+        x?: number | undefined;
+        y?: number | undefined;
+    }[] | undefined;
+    collaborators?: string[] | undefined;
+}>;
+export type MetaMediaCreateRequest = z.infer<typeof MetaMediaCreateRequestSchema>;
+export declare const MetaMediaPublishRequestSchema: z.ZodObject<{
+    creation_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    creation_id: string;
+}, {
+    creation_id: string;
+}>;
+export type MetaMediaPublishRequest = z.infer<typeof MetaMediaPublishRequestSchema>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/src/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AA8B5D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AASF,eAAO,MAAM,6BAA6B;;;;;;EAExC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC"}

package/dist/src/zod.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Provider options
+// ---------------------------------------------------------------------------
+// Instagram Graph API requires a long-lived user access token from the
+// Instagram Login OAuth flow (instagram_business_basic +
+// instagram_business_content_publish scopes). The caller obtains the token
+// externally and supplies it here; this package does not implement the OAuth
+// dance. Tokens last 60 days and are refreshable for another 60 each time.
+export const MetaOptionsSchema = z.object({
+    accessToken: z.string().min(1),
+    baseURL: z.string().optional(),
+    timeout: z.number().optional(),
+    fetch: z.custom().optional(),
+});
+// ---------------------------------------------------------------------------
+// Shared building blocks
+// ---------------------------------------------------------------------------
+// Instagram object IDs are numeric strings. The Graph API uses 64-bit ints
+// over the wire as decimal strings to avoid JS precision loss. Cap at 19
+// digits (max int64).
+const MetaIdStringSchema = z.string().regex(/^[0-9]{1,19}$/);
+const MetaUserTagSchema = z.object({
+    username: z.string().min(1),
+    x: z.number().min(0).max(1).optional(),
+    y: z.number().min(0).max(1).optional(),
+});
+// ---------------------------------------------------------------------------
+// POST /v25.0/{ig-user-id}/media
+// ---------------------------------------------------------------------------
+// `media_type` drives which url field is required. Carousel items reference
+// their parent container via `is_carousel_item: true`, but full carousel
+// support is out of scope for this first cut — REELS / VIDEO / IMAGE only.
+const MetaMediaTypeSchema = z.enum(["REELS", "VIDEO", "IMAGE", "CAROUSEL"]);
+// Server-side validation enforces that REELS / VIDEO require `video_url`,
+// IMAGE requires `image_url`, etc. Mirror the docs at the SDK layer with
+// simple optionality so error messages come back from the API verbatim
+// instead of being pre-empted by an over-zealous local schema.
+export const MetaMediaCreateRequestSchema = z.object({
+    media_type: MetaMediaTypeSchema,
+    video_url: z.string().url().optional(),
+    image_url: z.string().url().optional(),
+    caption: z.string().max(2200).optional(),
+    thumb_offset: z.number().int().min(0).optional(),
+    share_to_feed: z.boolean().optional(),
+    location_id: MetaIdStringSchema.optional(),
+    user_tags: z.array(MetaUserTagSchema).max(20).optional(),
+    collaborators: z.array(z.string().min(1)).max(3).optional(),
+});
+// ---------------------------------------------------------------------------
+// POST /v25.0/{ig-user-id}/media_publish
+// ---------------------------------------------------------------------------
+// `creation_id` is the container ID returned from /media — must reach
+// status_code === "FINISHED" before this endpoint will accept it (server
+// returns 400 otherwise).
+export const MetaMediaPublishRequestSchema = z.object({
+    creation_id: MetaIdStringSchema,
+});
+//# sourceMappingURL=zod.js.map

package/dist/src/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,uEAAuE;AACvE,yDAAyD;AACzD,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAgB,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAIH,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,2EAA2E;AAC3E,yEAAyE;AACzE,sBAAsB;AACtB,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAE7D,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,4EAA4E;AAC5E,yEAAyE;AACzE,2EAA2E;AAC3E,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAE5E,0EAA0E;AAC1E,yEAAyE;AACzE,uEAAuE;AACvE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,UAAU,EAAE,mBAAmB;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACxC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC;AAMH,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,sEAAsE;AACtE,yEAAyE;AACzE,0BAA0B;AAC1B,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,WAAW,EAAE,kBAAkB;CAChC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@apicity/meta",
+  "version": "0.1.0-alpha.0",
+  "description": "Instagram Graph API provider for posting reels via the public-URL flow (graph.instagram.com).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justintanner/apicity.git",
+    "directory": "provider/meta"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    },
+    "./zod": {
+      "import": "./dist/src/zod.js",
+      "types": "./dist/src/zod.d.ts"
+    }
+  },
+  "peerDependencies": {
+    "zod": "^3.24.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "instagram",
+    "ig",
+    "meta",
+    "social",
+    "reels",
+    "post",
+    "media-publish",
+    "apicity"
+  ],
+  "author": "Justin Tanner",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "homepage": "https://github.com/justintanner/apicity#readme",
+  "bugs": {
+    "url": "https://github.com/justintanner/apicity/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/dist.mjs"
+  }
+}