@tabsircg/fb-sdk 1.0.0

package/README.md

@@ -0,0 +1,384 @@
+# fb-sdk
+
+A typed Node.js SDK for the Facebook Graph API (v25.0). Select only the fields you need, get full autocomplete while writing the selector, strict compile-time validation that rejects unknown fields, and a return type narrowed to exactly what you selected — all without runtime overhead.
+
+## Installation
+
+```bash
+npm install fb-sdk
+```
+
+**Requirements:** Node.js 18+, TypeScript 5.9+
+
+**Dependencies:** `axios`, `form-data`
+
+## Quick Start
+
+```typescript
+import { fbGraph } from "fb-sdk";
+
+const fb = fbGraph("your-access-token");
+
+// Get a post — only the fields you select exist on the result
+const post = await fb.post("postId").get({
+  id: true,
+  message: true,
+  comments: {
+    options: { filter: "toplevel" },
+    fields: { id: true, message: true },
+  },
+});
+
+post.id; // string
+post.message; // string | undefined
+post.comments.data[0].message; // string
+post.comments.paging; // Paging
+// post.fullPicture             — compile error, not selected
+```
+
+## Field Selection
+
+Every `get` and `list` method accepts a **field selector** — an object whose shape mirrors the resource type. You pick fields by setting them to `true`. The SDK converts this object into the Graph API `fields` query parameter and infers a return type containing only the selected fields.
+
+### Scalar fields
+
+```typescript
+{ id: true, message: true }
+// → fields=id,message
+```
+
+### Nested objects
+
+For non-collection nested objects, nest the selector directly:
+
+```typescript
+{ picture: { data: { url: true, height: true } } }
+// → fields=picture{data{url,height}}
+```
+
+You can also pass `true` to select all fields of a nested object:
+
+```typescript
+{
+  picture: true;
+}
+// → fields=picture
+```
+
+### Edges (collections)
+
+Edges — like `comments` on a post — are paginated collections. They require the `{ fields }` wrapper:
+
+```typescript
+{
+  comments: {
+    fields: { id: true, message: true }
+  }
+}
+// → fields=comments{id,message}
+```
+
+Passing `true` selects all fields on the edge's items:
+
+```typescript
+{
+  comments: true;
+}
+// → fields=comments
+```
+
+### Edge options
+
+Some edges accept extra parameters (limit, pagination cursors, filters). These go in `options`:
+
+```typescript
+{
+  comments: {
+    options: { filter: "toplevel", limit: 10 },
+    fields: { id: true, message: true }
+  }
+}
+// → fields=comments.filter(toplevel).limit(10){id,message}
+```
+
+Available options vary per edge. The `comments` edge supports `filter` and `summary` on top of the base `limit`, `after`, and `before`. The SDK infers the correct options type for each edge — you get autocomplete for what's available.
+
+### Return type narrowing
+
+The return type contains **only** what you selected. If you select `{ id: true, message: true }` on a `FacebookPost`, the result type is `{ id: string; message: string | undefined }` — not the full `FacebookPost`. This applies recursively to nested objects and edges.
+
+When an edge has option-dependent response fields (e.g., `comments` includes a `summary` object), those fields appear in the return type only when `options` is provided in the selector.
+
+## Available Resources
+
+### `fb.post(postId)`
+
+Operations on a specific post by ID.
+
+#### `fb.post(postId).get(fields)`
+
+Fetch a single post.
+
+```typescript
+const post = await fb.post("postId").get({
+  id: true,
+  statusType: true,
+  createdTime: true,
+  shares: true,
+  reactions: true,
+});
+```
+
+#### `fb.post(postId).expire(time, type)`
+
+Set an expiration on a post.
+
+```typescript
+await fb.post("postId").expire(Date.now() + 86400000, "expire_only");
+```
+
+#### `fb.post(postId).comments.list(fields)`
+
+Fetch comments on a post. Also provides a `.create(data)` method to add a comment.
+
+```typescript
+const comments = await fb.post("postId").comments.list({
+  id: true,
+  message: true,
+  from: { name: true },
+});
+// comments.data    — Comment[]
+// comments.paging  — Paging
+
+// Create a comment
+const newComment = await fb.post("postId").comments.create({
+  message: "Hello world!"
+});
+```
+
+---
+
+### `fb.me`
+
+Operations on the authenticated user.
+
+#### `fb.me.get(fields)`
+
+Fetch the current user's profile.
+
+```typescript
+const me = await fb.me.get({ id: true, name: true });
+```
+
+#### `fb.me.accounts(fields)`
+
+List Facebook Pages the user manages.
+
+```typescript
+const pages = await fb.me.accounts({
+  id: true,
+  name: true,
+  accessToken: true,
+});
+// pages.data    — FacebookPage[]
+// pages.paging  — Paging
+```
+
+---
+
+### `fb.page(pageId)`
+
+Operations scoped to a specific Page. Returns sub-resources for posts, videos, reels, images, and aggregated comments.
+
+```typescript
+const page = fb.page("pageId");
+```
+
+#### `page.posts.list(query)` 
+
+List posts on a Page. Note: to fetch a specific post, use `fb.post(postId).get()`.
+
+```typescript
+const feed = await page.posts.list({
+  fields: { id: true, message: true, createdTime: true },
+});
+```
+
+#### `page.comments.list(query, config)`
+
+Fetch an aggregated stream of comments across recent page posts.
+
+```typescript
+const allComments = await page.comments.list({
+  fields: { id: true, message: true, createdTime: true }
+});
+```
+
+#### `page.videos.list(query)` / `page.videos.publish(data)`
+
+List videos or publish a new video.
+
+```typescript
+const videos = await page.videos.list({
+  fields: { id: true, title: true, status: true },
+});
+
+const { postId } = await page.videos.publish({
+  fileUrl: "https://example.com/video.mp4",
+  title: "My Video",
+  description: "A description",
+  thumbnailUrl: "https://example.com/thumb.jpg",
+});
+```
+
+Publishing handles the upload, waits for processing via polling, and returns the resulting post ID. Throws `FacebookUploadError` on failure.
+
+#### `page.reels.list(query)` / `page.reels.publish(data)`
+
+List or publish reels. Publishing uses Facebook's resumable upload protocol (start session → upload file → finish session) and polls until the reel is processed.
+
+```typescript
+const { postId } = await page.reels.publish({
+  fileUrl: "https://example.com/reel.mp4",
+  title: "My Reel",
+  thumbnailUrl: "https://example.com/thumb.jpg",
+});
+```
+
+#### `page.images.list(query)` / `page.images.publish(data)`
+
+List or publish images.
+
+```typescript
+const { postId } = await page.images.publish({
+  url: "https://example.com/image.jpg",
+  caption: "My image",
+});
+```
+
+---
+
+### `fb.comment(commentId)`
+
+Operations to manage a single comment node.
+
+```typescript
+const myComment = fb.comment("commentId");
+
+// Update message
+await myComment.update({ message: "new message" });
+
+// Like / unlike
+await myComment.like();
+await myComment.unlike();
+
+// Delete
+await myComment.delete();
+
+// Get nested replies
+const subComments = await myComment.replies.list({ id: true, message: true });
+```
+
+## Adding New Endpoints
+
+To add a new resource or edge, follow this pattern:
+
+### 1. Define the raw type
+
+Create or update a file in `src/types/`. Define the raw interface with snake_case keys matching the Facebook API response:
+
+```typescript
+// src/types/facebookstory.ts
+import { KeysToCamel } from "../lib/transformCase.js";
+
+interface FacebookStoryRaw {
+  id: string;
+  created_time: string;
+  media_url: string;
+}
+export type FacebookStory = KeysToCamel<FacebookStoryRaw>;
+```
+
+### 2. Define edge options (if needed)
+
+If the edge supports custom parameters beyond the base `limit`/`after`/`before`, extend `EdgeOptions` in `src/types/shared.ts`:
+
+```typescript
+export interface StoryEdgeOptions extends EdgeOptions {
+  since?: number;
+}
+```
+
+### 3. Use `CollectionOf` for edges with option-dependent fields
+
+If the edge's response includes extra fields only when certain options are passed, use `CollectionOf` with an intersection:
+
+```typescript
+interface ParentRaw {
+  stories: CollectionOf<FacebookStoryRaw, StoryEdgeOptions> & {
+    extra_field: string; // only present when options are provided
+  };
+}
+```
+
+### 4. Create the resource
+
+In `src/resources/`, create a factory function using `GetNode` and `ListEdge` types:
+
+```typescript
+import { GetNode, ListEdge } from "../types/shared.js";
+import { FacebookStory } from "../types/facebookstory.js";
+
+export type ListStories = ListEdge<FacebookStory>;
+export type GetStory = GetNode<FacebookStory>;
+
+export const createStoryResource = (http: HttpClient, pageId: string) => {
+  const list: ListStories = async (query) =>
+    http.get(`/${pageId}/stories`, {
+      params: { fields: toGraphFields(query.fields), ...query.options },
+    });
+
+  const get: GetStory = async (fields) =>
+    http.get(`/${pageId}`, {
+      params: { fields: toGraphFields(fields) },
+    });
+
+  return { list, get };
+};
+```
+
+### 5. Wire into the SDK
+
+Add the resource to the appropriate factory in `src/client.ts`:
+
+```typescript
+export function fbGraph(accessToken: string) {
+  const http = createHttpClient(accessToken);
+  return {
+    post: (postId: string) => createPostResource(http, postId),
+    page: (pageId: string) => ({
+      ...createPageResource(http, pageId),
+      stories: createStoryResource(http, pageId),
+    }),
+    me: createUserResource(http),
+  };
+}
+```
+
+## Type System Overview
+
+The SDK's type system follows a three-stage pipeline:
+
+### 1. Selector generation (`FbFieldSelector<T>`)
+
+Given a resource type `T`, `FbFieldSelector<T>` generates the shape of a valid field selector object. Scalar fields become `true | undefined`. Nested objects become recursive selectors or `true`. Collection edges become `{ options?: O; fields: FbFieldSelector<Inner> } | true`, where `O` is the edge-specific options type extracted from the `CollectionOf` phantom type. Recursion depth is bounded by a `Decrement` counter (default depth: 1 level of nesting).
+
+### 2. Strict validation (`DeepStrict<Valid, Inferred>`)
+
+TypeScript's structural type system doesn't reject excess properties when generics are involved. `DeepStrict` solves this by mapping every key in the inferred selector — if the key exists in the valid selector shape, it passes through; otherwise it becomes `never`, causing a compile error. This gives you red squiggles on typos and invalid fields.
+
+### 3. Return type narrowing (`FbPickDeep<T, F>`)
+
+`FbPickDeep<T, F>` walks the resource type `T` in parallel with your selector `F` and keeps only the fields you selected. For collections, it wraps the picked inner type in `{ data: Picked[]; paging: Paging }`. If the selector included `options`, option-dependent fields (defined via `& { ... }` on `CollectionOf`) are also included via `CleanCollection`.
+
+The result is end-to-end type safety: autocomplete guides you to valid fields, the compiler rejects invalid ones, and the return type contains exactly what you asked for.

package/dist/client.js

@@ -0,0 +1,20 @@
+import { createHttpClient } from "./httpClient.js";
+import { createPostResource } from "./resources/PostResource.js";
+import { createPageResource } from "./resources/PageResource.js";
+import { createUserResource } from "./resources/UserResource.js";
+import { createCommentResource } from "./resources/comment/CommentResource.js";
+export function createFbSdk(config = {}) {
+    return (accessToken) => {
+        const http = createHttpClient(accessToken);
+        return {
+            post: (postId) => createPostResource({ http, id: postId, config }),
+            page: (pageId) => createPageResource({ http, id: pageId, config }),
+            comment: (commentId) => createCommentResource({ http, id: commentId, config }),
+            me: createUserResource({ http, config, id: "me" }),
+        };
+    };
+}
+export { createMemoryStore } from "./store/memory.js";
+export { createRedisStore } from "./store/redis.js";
+export { createWebhookHandler } from "./webhook/handler.js";
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAc,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAa/E,MAAM,UAAU,WAAW,CAAC,SAAsB,EAAE;IAClD,OAAO,CAAC,WAAmB,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC3C,OAAO;YACL,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1E,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1E,OAAO,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;YACtF,EAAE,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;SACnD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/httpClient.js

@@ -0,0 +1,39 @@
+import axios from "axios";
+import { toCamel, toSnakeObj } from "./lib/transformCase.js";
+import FormData from "form-data";
+export const api = axios.create({ family: 4 });
+const fbApi = axios.create({
+    baseURL: "https://graph.facebook.com/v25.0",
+    family: 4,
+    headers: { "Accept-Encoding": "gzip, deflate, br" },
+});
+export function createHttpClient(accessToken) {
+    return {
+        get: async (path, options) => {
+            const res = await fbApi.get(path, {
+                params: { access_token: accessToken, ...options?.params },
+            });
+            const data = toCamel(res.data);
+            return options?.safe ? { data, status: res.status } : data;
+        },
+        post: async (path, data, options) => {
+            const isForm = data instanceof FormData;
+            const res = await fbApi.post(path, isForm ? data : toSnakeObj(data), {
+                headers: isForm ? data.getHeaders() : {},
+                ...(options?.safe && { validateStatus: (s) => s === 200 || s === 504 }),
+                params: { access_token: accessToken },
+            });
+            const body = toCamel(res.data);
+            return options?.safe ? { data: body, status: res.status } : body;
+        },
+        delete: async (path, options) => {
+            const res = await fbApi.delete(path, {
+                params: { access_token: accessToken, ...options?.params },
+            });
+            const data = toCamel(res.data);
+            return options?.safe ? { data, status: res.status } : data;
+        },
+        getToken: () => accessToken,
+    };
+}
+//# sourceMappingURL=httpClient.js.map

package/dist/httpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.js","sourceRoot":"","sources":["../src/httpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IACzB,OAAO,EAAE,kCAAkC;IAC3C,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,EAAE,iBAAiB,EAAE,mBAAmB,EAAE;CACpD,CAAC,CAAC;AAwBH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC3B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;gBAChC,MAAM,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE;aAC1D,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,CAAC;QAED,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAClC,MAAM,MAAM,GAAG,IAAI,YAAY,QAAQ,CAAC;YACxC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;gBACnE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;gBACxC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,cAAc,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC/E,MAAM,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE;aACtC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAE/B,OAAO,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;gBACnC,MAAM,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE;aAC1D,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,CAAC;QAED,QAAQ,EAAE,GAAG,EAAE,CAAC,WAAW;KAC5B,CAAC;AACJ,CAAC"}

package/dist/internal/error.js

@@ -0,0 +1,9 @@
+export class FacebookUploadError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "FacebookUploadError";
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/internal/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/internal/error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG1B;IAFlB,YACE,OAAe,EACC,MAAgC;QAEhD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAA0B;QAGhD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/internal/fetchers.js

@@ -0,0 +1,56 @@
+import FormData from "form-data";
+import { ORDER, } from "../types/shared.js";
+export const fetchComments = async (http, { postIds, fieldsStr, options, cursors }) => {
+    const allComments = [];
+    const nextCursors = {};
+    const remaining = [];
+    const chunks = [];
+    for (let i = 0; i < postIds.length; i += 50) {
+        chunks.push(postIds.slice(i, i + 50));
+    }
+    for (const chunk of chunks) {
+        const batch = chunk.map((postId) => {
+            const params = new URLSearchParams();
+            params.set("fields", fieldsStr);
+            params.set("order", options?.order || ORDER.NEWEST);
+            params.set("limit", "5");
+            if (options?.filter)
+                params.set("filter", options.filter);
+            if (options?.summary !== undefined)
+                params.set("summary", String(options.summary));
+            if (options?.since)
+                params.set("since", String(options.since));
+            if (options?.until)
+                params.set("until", String(options.until));
+            const cursor = cursors[postId];
+            if (cursor)
+                params.set("after", cursor);
+            console.log(params.toString());
+            return {
+                method: "GET",
+                relative_url: `${postId}/comments?${params.toString()}`,
+            };
+        });
+        const form = new FormData();
+        form.append("batch", JSON.stringify(batch));
+        form.append("include_headers", "false");
+        const responses = await http.post("/", form);
+        const responseArray = Array.isArray(responses) ? responses : [];
+        for (let i = 0; i < responseArray.length; i++) {
+            const resp = responseArray[i];
+            const postId = chunk[i];
+            if (!resp || resp.code !== 200)
+                continue;
+            const parsed = JSON.parse(resp.body);
+            for (const comment of parsed.data) {
+                allComments.push({ ...comment, _postId: postId });
+            }
+            if (parsed.paging?.next && parsed.paging.cursors?.after) {
+                nextCursors[postId] = parsed.paging.cursors.after;
+                remaining.push(postId);
+            }
+        }
+    }
+    return { comments: allComments, nextCursors, remaining };
+};
+//# sourceMappingURL=fetchers.js.map

package/dist/internal/fetchers.js.map

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

package/dist/internal/poller.js

@@ -0,0 +1,55 @@
+import { FacebookUploadError } from "./error.js";
+const getProcessingError = (status) => {
+    if (status.videoStatus === "error")
+        return "Video upload failed";
+    const phase = status.uploadingPhase?.status === "error"
+        ? status.uploadingPhase
+        : status.processingPhase?.status === "error"
+            ? status.processingPhase
+            : status.publishingPhase?.status === "error"
+                ? status.publishingPhase
+                : null;
+    return phase?.errors?.[0]?.message;
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export function poll(fn, config = {}) {
+    const { maxAttempts = 30, intervalMs = 10000 } = config;
+    return async (...args) => {
+        for (let i = 0; i < maxAttempts; i++) {
+            const result = await fn(...args);
+            if (result !== undefined)
+                return result;
+            await sleep(intervalMs);
+        }
+        throw new Error(`Polling timed out after ${maxAttempts} attempts (${(maxAttempts * intervalMs) / 60000} min)`);
+    };
+}
+export const pollVideoStatus = poll(async (listVideos, trackingId) => {
+    const videos = await listVideos({
+        fields: {
+            status: true,
+            postId: true,
+            universalVideoId: true,
+        },
+    });
+    const target = videos.data.find((v) => v.universalVideoId === trackingId);
+    if (!target)
+        return undefined;
+    const error = getProcessingError(target.status);
+    if (error)
+        throw new FacebookUploadError(error, target.status);
+    if (target.status.publishingPhase?.status === "complete") {
+        return { postId: target.postId };
+    }
+    return undefined;
+}, { maxAttempts: 30, intervalMs: 20000 });
+export const pollReelStatus = poll(async (getReel) => {
+    const { postId, status } = await getReel({ postId: true, status: true });
+    const error = getProcessingError(status);
+    if (error)
+        throw new FacebookUploadError(error, status);
+    if (postId)
+        return { postId };
+    return undefined;
+}, { maxAttempts: 30, intervalMs: 10000 });
+//# sourceMappingURL=poller.js.map

package/dist/internal/poller.js.map

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

package/dist/internal/utils.js

@@ -0,0 +1,25 @@
+import { toSnakeCase } from "../lib/transformCase.js";
+function serializeEdgeOptions(options) {
+    if (!options)
+        return "";
+    return Object.entries(options)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => `.${toSnakeCase(k)}(${v})`)
+        .join("");
+}
+export function toGraphFields(fields) {
+    return Object.entries(fields)
+        .filter(([, value]) => value !== undefined && value !== false)
+        .map(([key, value]) => {
+        const snakeKey = toSnakeCase(key);
+        if (value === true)
+            return snakeKey;
+        if (value.fields) {
+            const opts = serializeEdgeOptions(value.options);
+            return `${snakeKey}${opts}{${toGraphFields(value.fields)}}`;
+        }
+        return `${snakeKey}{${toGraphFields(value)}}`;
+    })
+        .join(",");
+}
+//# sourceMappingURL=utils.js.map

package/dist/internal/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/internal/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,SAAS,oBAAoB,CAAC,OAAiC;IAC7D,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC;SAC7D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;QAGpC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjD,OAAO,GAAG,QAAQ,GAAG,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;QAC9D,CAAC;QAGD,OAAO,GAAG,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC;IAChD,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/lib/edge.js

@@ -0,0 +1,33 @@
+import { toGraphFields } from "../utils.js";
+function cleanParams(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+export function listEdge(http, path, defaults) {
+    return ((fields, options) => {
+        return http.get(path, {
+            params: cleanParams({ fields: toGraphFields(fields), ...defaults, ...options }),
+        });
+    });
+}
+export function listByParentEdge(http, suffix, defaults) {
+    return ((parentId, fields, options) => {
+        return http.get(`/${parentId}${suffix}`, {
+            params: cleanParams({ fields: toGraphFields(fields), ...defaults, ...options }),
+        });
+    });
+}
+export function getEdge(http) {
+    return ((id, fields) => {
+        return http.get(`/${id}`, {
+            params: { fields: toGraphFields(fields) },
+        });
+    });
+}
+export function getFixedEdge(http, path) {
+    return ((fields) => {
+        return http.get(path, {
+            params: { fields: toGraphFields(fields) },
+        });
+    });
+}
+//# sourceMappingURL=edge.js.map

package/dist/lib/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../../src/lib/edge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgD5C,SAAS,WAAW,CAAC,GAA4B;IAC/C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;AACpF,CAAC;AAKD,MAAM,UAAU,QAAQ,CACtB,IAAgB,EAChB,IAAY,EACZ,QAA0B;IAE1B,OAAO,CAAC,CAAC,MAA+B,EAAE,OAAgB,EAAE,EAAE;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YACpB,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;SAChF,CAAC,CAAC;IACL,CAAC,CAAmC,CAAC;AACvC,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAC9B,IAAgB,EAChB,MAAc,EACd,QAA0B;IAE1B,OAAO,CAAC,CAAC,QAAgB,EAAE,MAA+B,EAAE,OAAgB,EAAE,EAAE;QAC9E,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,GAAG,MAAM,EAAE,EAAE;YACvC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;SAChF,CAAC,CAAC;IACL,CAAC,CAA2C,CAAC;AAC/C,CAAC;AAGD,MAAM,UAAU,OAAO,CAAgC,IAAgB;IACrE,OAAO,CAAC,CAAC,EAAU,EAAE,MAA+B,EAAE,EAAE;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE;YACxB,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC,CAA0B,CAAC;AAC9B,CAAC;AAGD,MAAM,UAAU,YAAY,CAC1B,IAAgB,EAChB,IAAY;IAEZ,OAAO,CAAC,CAAC,MAA+B,EAAE,EAAE;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YACpB,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC,CAA+B,CAAC;AACnC,CAAC"}