@yoryoboy/bi-mcp 1.11.0 → 1.13.0

package/dist/src/services/meta/__tests__/meta-ads.test.js

@@ -0,0 +1,126 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const metaFetchMock = vi.fn();
+vi.mock("../meta-api.js", () => ({
+  metaFetch: metaFetchMock
+}));
+const metaAdsModule = await import("../meta-ads.js");
+describe("meta ads service", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("lists businesses and ad accounts with normalized paging and account ids", async () => {
+    metaFetchMock.mockResolvedValueOnce({
+      data: [{ id: "biz-1", name: "Main Business", verification_status: "verified" }],
+      paging: {
+        next: "https://graph.facebook.com/v25.0/me/businesses?after=cursor-2"
+      }
+    }).mockResolvedValueOnce({
+      data: [
+        {
+          id: "act_123",
+          name: "Main Account",
+          currency: "ARS",
+          account_status: 1,
+          timezone_name: "America/Argentina/Buenos_Aires",
+          business: { id: "biz-1", name: "Main Business" }
+        }
+      ],
+      paging: {
+        cursors: { before: "before-1", after: "after-1" },
+        next: "https://graph.facebook.com/v25.0/me/adaccounts?after=after-1"
+      }
+    });
+    await expect(
+      metaAdsModule.listAccessibleMetaBusinesses({ accessToken: "token" })
+    ).resolves.toEqual({
+      businesses: [{ id: "biz-1", name: "Main Business", verification_status: "verified" }],
+      paging: { after: "cursor-2", before: void 0, has_more: true }
+    });
+    await expect(
+      metaAdsModule.listAccessibleMetaAdAccounts({ accessToken: "token" }, "after-0")
+    ).resolves.toEqual({
+      adAccounts: [
+        {
+          id: "act_123",
+          account_id: "123",
+          name: "Main Account",
+          currency: "ARS",
+          account_status: 1,
+          timezone_name: "America/Argentina/Buenos_Aires",
+          business: { id: "biz-1", name: "Main Business" }
+        }
+      ],
+      paging: { after: "after-1", before: "before-1", has_more: true }
+    });
+    expect(metaFetchMock).toHaveBeenNthCalledWith(
+      1,
+      { accessToken: "token" },
+      "/me/businesses",
+      { fields: "id,name,verification_status", limit: 100, after: void 0 }
+    );
+    expect(metaFetchMock).toHaveBeenNthCalledWith(
+      2,
+      { accessToken: "token" },
+      "/me/adaccounts",
+      {
+        fields: "id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name}",
+        limit: 100,
+        after: "after-0"
+      }
+    );
+  });
+  it("fetches individual objects and uses act_ account ids for account-scoped reads", async () => {
+    metaFetchMock.mockResolvedValueOnce({ id: "biz-1", name: "Business" }).mockResolvedValueOnce({ id: "act_321", name: "Scoped", currency: "USD" }).mockResolvedValueOnce({ data: [{ id: "cmp-1", name: "Campaign" }] }).mockResolvedValueOnce({ data: [{ id: "ad-1", name: "Ad", creative: { id: "crt-1" } }] }).mockResolvedValueOnce({ data: [{ spend: "10" }] }).mockResolvedValueOnce({ data: [{ publisher_platform: "instagram", spend: "4" }] });
+    await expect(metaAdsModule.getMetaBusinessInfo({ accessToken: "token" }, "biz-1")).resolves.toEqual({
+      id: "biz-1",
+      name: "Business"
+    });
+    await expect(metaAdsModule.getMetaAdAccountInfo({ accessToken: "token" }, "321")).resolves.toEqual({
+      id: "act_321",
+      account_id: "321",
+      name: "Scoped",
+      currency: "USD"
+    });
+    await expect(metaAdsModule.getMetaCampaigns({ accessToken: "token" }, "321", 10)).resolves.toEqual([
+      { id: "cmp-1", name: "Campaign" }
+    ]);
+    await expect(metaAdsModule.getMetaAds({ accessToken: "token" }, "321", 10)).resolves.toEqual([
+      { id: "ad-1", name: "Ad", creative: { id: "crt-1" } }
+    ]);
+    await expect(
+      metaAdsModule.getMetaInsights({ accessToken: "token" }, "act_321", { level: "account" })
+    ).resolves.toEqual([{ spend: "10" }]);
+    await expect(
+      metaAdsModule.getMetaPlacementInsights({ accessToken: "token" }, "321", { level: "account" })
+    ).resolves.toEqual([{ publisher_platform: "instagram", spend: "4" }]);
+    expect(metaFetchMock).toHaveBeenCalledWith(
+      { accessToken: "token" },
+      "/act_321",
+      {
+        fields: "id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name},amount_spent,balance,spend_cap"
+      }
+    );
+    expect(metaFetchMock).toHaveBeenCalledWith(
+      { accessToken: "token" },
+      "/act_321/campaigns",
+      { fields: "id,name,status,effective_status,objective", limit: 10 }
+    );
+  });
+  it("deduplicates account ids and ignores rejected account lookups", async () => {
+    metaFetchMock.mockResolvedValueOnce({ id: "act_111", name: "One", currency: "ARS" }).mockRejectedValueOnce(new Error("not found"));
+    await expect(
+      metaAdsModule.getMetaAdAccountsByIds({ accessToken: "token" }, ["act_111", "111", "222"])
+    ).resolves.toEqual([{ id: "act_111", account_id: "111", name: "One", currency: "ARS" }]);
+    expect(metaFetchMock).toHaveBeenCalledTimes(2);
+  });
+  it("returns empty arrays when list responses omit data", async () => {
+    metaFetchMock.mockResolvedValue({});
+    await expect(metaAdsModule.getMetaInsights({ accessToken: "token" }, "obj-1", {})).resolves.toEqual([]);
+    await expect(metaAdsModule.getMetaCampaigns({ accessToken: "token" }, "123")).resolves.toEqual([]);
+    await expect(metaAdsModule.getMetaAds({ accessToken: "token" }, "123")).resolves.toEqual([]);
+    await expect(metaAdsModule.getMetaPlacementInsights({ accessToken: "token" }, "123", {})).resolves.toEqual(
+      []
+    );
+  });
+});
+//# sourceMappingURL=meta-ads.test.js.map

package/dist/src/services/meta/__tests__/meta-ads.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/meta/__tests__/meta-ads.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst metaFetchMock = vi.fn();\n\nvi.mock(\"../meta-api.js\", () => ({\n  metaFetch: metaFetchMock,\n}));\n\nconst metaAdsModule = await import(\"../meta-ads.js\");\n\ndescribe(\"meta ads service\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"lists businesses and ad accounts with normalized paging and account ids\", async () => {\n    metaFetchMock\n      .mockResolvedValueOnce({\n        data: [{ id: \"biz-1\", name: \"Main Business\", verification_status: \"verified\" }],\n        paging: {\n          next: \"https://graph.facebook.com/v25.0/me/businesses?after=cursor-2\",\n        },\n      })\n      .mockResolvedValueOnce({\n        data: [\n          {\n            id: \"act_123\",\n            name: \"Main Account\",\n            currency: \"ARS\",\n            account_status: 1,\n            timezone_name: \"America/Argentina/Buenos_Aires\",\n            business: { id: \"biz-1\", name: \"Main Business\" },\n          },\n        ],\n        paging: {\n          cursors: { before: \"before-1\", after: \"after-1\" },\n          next: \"https://graph.facebook.com/v25.0/me/adaccounts?after=after-1\",\n        },\n      });\n\n    await expect(\n      metaAdsModule.listAccessibleMetaBusinesses({ accessToken: \"token\" })\n    ).resolves.toEqual({\n      businesses: [{ id: \"biz-1\", name: \"Main Business\", verification_status: \"verified\" }],\n      paging: { after: \"cursor-2\", before: undefined, has_more: true },\n    });\n\n    await expect(\n      metaAdsModule.listAccessibleMetaAdAccounts({ accessToken: \"token\" }, \"after-0\")\n    ).resolves.toEqual({\n      adAccounts: [\n        {\n          id: \"act_123\",\n          account_id: \"123\",\n          name: \"Main Account\",\n          currency: \"ARS\",\n          account_status: 1,\n          timezone_name: \"America/Argentina/Buenos_Aires\",\n          business: { id: \"biz-1\", name: \"Main Business\" },\n        },\n      ],\n      paging: { after: \"after-1\", before: \"before-1\", has_more: true },\n    });\n\n    expect(metaFetchMock).toHaveBeenNthCalledWith(\n      1,\n      { accessToken: \"token\" },\n      \"/me/businesses\",\n      { fields: \"id,name,verification_status\", limit: 100, after: undefined }\n    );\n    expect(metaFetchMock).toHaveBeenNthCalledWith(\n      2,\n      { accessToken: \"token\" },\n      \"/me/adaccounts\",\n      {\n        fields:\n          \"id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name}\",\n        limit: 100,\n        after: \"after-0\",\n      }\n    );\n  });\n\n  it(\"fetches individual objects and uses act_ account ids for account-scoped reads\", async () => {\n    metaFetchMock\n      .mockResolvedValueOnce({ id: \"biz-1\", name: \"Business\" })\n      .mockResolvedValueOnce({ id: \"act_321\", name: \"Scoped\", currency: \"USD\" })\n      .mockResolvedValueOnce({ data: [{ id: \"cmp-1\", name: \"Campaign\" }] })\n      .mockResolvedValueOnce({ data: [{ id: \"ad-1\", name: \"Ad\", creative: { id: \"crt-1\" } }] })\n      .mockResolvedValueOnce({ data: [{ spend: \"10\" }] })\n      .mockResolvedValueOnce({ data: [{ publisher_platform: \"instagram\", spend: \"4\" }] });\n\n    await expect(metaAdsModule.getMetaBusinessInfo({ accessToken: \"token\" }, \"biz-1\")).resolves.toEqual({\n      id: \"biz-1\",\n      name: \"Business\",\n    });\n    await expect(metaAdsModule.getMetaAdAccountInfo({ accessToken: \"token\" }, \"321\")).resolves.toEqual({\n      id: \"act_321\",\n      account_id: \"321\",\n      name: \"Scoped\",\n      currency: \"USD\",\n    });\n    await expect(metaAdsModule.getMetaCampaigns({ accessToken: \"token\" }, \"321\", 10)).resolves.toEqual([\n      { id: \"cmp-1\", name: \"Campaign\" },\n    ]);\n    await expect(metaAdsModule.getMetaAds({ accessToken: \"token\" }, \"321\", 10)).resolves.toEqual([\n      { id: \"ad-1\", name: \"Ad\", creative: { id: \"crt-1\" } },\n    ]);\n    await expect(\n      metaAdsModule.getMetaInsights({ accessToken: \"token\" }, \"act_321\", { level: \"account\" })\n    ).resolves.toEqual([{ spend: \"10\" }]);\n    await expect(\n      metaAdsModule.getMetaPlacementInsights({ accessToken: \"token\" }, \"321\", { level: \"account\" })\n    ).resolves.toEqual([{ publisher_platform: \"instagram\", spend: \"4\" }]);\n\n    expect(metaFetchMock).toHaveBeenCalledWith(\n      { accessToken: \"token\" },\n      \"/act_321\",\n      {\n        fields:\n          \"id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name},amount_spent,balance,spend_cap\",\n      }\n    );\n    expect(metaFetchMock).toHaveBeenCalledWith(\n      { accessToken: \"token\" },\n      \"/act_321/campaigns\",\n      { fields: \"id,name,status,effective_status,objective\", limit: 10 }\n    );\n  });\n\n  it(\"deduplicates account ids and ignores rejected account lookups\", async () => {\n    metaFetchMock\n      .mockResolvedValueOnce({ id: \"act_111\", name: \"One\", currency: \"ARS\" })\n      .mockRejectedValueOnce(new Error(\"not found\"));\n\n    await expect(\n      metaAdsModule.getMetaAdAccountsByIds({ accessToken: \"token\" }, [\"act_111\", \"111\", \"222\"])\n    ).resolves.toEqual([{ id: \"act_111\", account_id: \"111\", name: \"One\", currency: \"ARS\" }]);\n\n    expect(metaFetchMock).toHaveBeenCalledTimes(2);\n  });\n\n  it(\"returns empty arrays when list responses omit data\", async () => {\n    metaFetchMock.mockResolvedValue({});\n\n    await expect(metaAdsModule.getMetaInsights({ accessToken: \"token\" }, \"obj-1\", {})).resolves.toEqual([]);\n    await expect(metaAdsModule.getMetaCampaigns({ accessToken: \"token\" }, \"123\")).resolves.toEqual([]);\n    await expect(metaAdsModule.getMetaAds({ accessToken: \"token\" }, \"123\")).resolves.toEqual([]);\n    await expect(metaAdsModule.getMetaPlacementInsights({ accessToken: \"token\" }, \"123\", {})).resolves.toEqual(\n      []\n    );\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/services/meta/__tests__/meta-api.test.js

@@ -0,0 +1,70 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const getMetaConfigMock = vi.fn();
+const createMetaAppSecretProofMock = vi.fn();
+vi.mock("../../../config/meta.js", () => ({
+  getMetaConfig: getMetaConfigMock,
+  createMetaAppSecretProof: createMetaAppSecretProofMock
+}));
+const { metaFetch } = await import("../meta-api.js");
+describe("meta api", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    getMetaConfigMock.mockReturnValue({
+      baseUrl: "https://graph.facebook.com/v25.0",
+      appSecret: "app-secret"
+    });
+    createMetaAppSecretProofMock.mockReturnValue("proof-123");
+  });
+  it("builds Graph API URLs with token, proof and non-empty query params", async () => {
+    const fetchMock = vi.fn().mockResolvedValue({
+      ok: true,
+      json: vi.fn().mockResolvedValue({ data: [{ id: "biz-1" }] })
+    });
+    vi.stubGlobal("fetch", fetchMock);
+    const result = await metaFetch(
+      { accessToken: "access-token" },
+      "me/businesses",
+      {
+        fields: "id,name",
+        limit: 100,
+        after: void 0,
+        empty: ""
+      }
+    );
+    expect(result).toEqual({ data: [{ id: "biz-1" }] });
+    expect(createMetaAppSecretProofMock).toHaveBeenCalledWith("access-token", "app-secret");
+    expect(fetchMock).toHaveBeenCalledWith(
+      "https://graph.facebook.com/v25.0/me/businesses?access_token=access-token&appsecret_proof=proof-123&fields=id%2Cname&limit=100",
+      {
+        method: "GET",
+        headers: { Accept: "application/json" }
+      }
+    );
+  });
+  it("prefers user-facing Meta errors and falls back to status-based messages", async () => {
+    const userFacingResponse = {
+      ok: false,
+      status: 400,
+      json: vi.fn().mockResolvedValue({
+        error: {
+          error_user_msg: "Choose a different account.",
+          message: "Low-level error"
+        }
+      })
+    };
+    const statusFallbackResponse = {
+      ok: false,
+      status: 503,
+      json: vi.fn().mockRejectedValue(new Error("invalid json"))
+    };
+    const fetchMock = vi.fn().mockResolvedValueOnce(userFacingResponse).mockResolvedValueOnce(statusFallbackResponse);
+    vi.stubGlobal("fetch", fetchMock);
+    await expect(metaFetch({ accessToken: "token" }, "/broken")).rejects.toThrow(
+      "Choose a different account."
+    );
+    await expect(metaFetch({ accessToken: "token" }, "/broken-again")).rejects.toThrow(
+      "Meta API request failed with status 503"
+    );
+  });
+});
+//# sourceMappingURL=meta-api.test.js.map

package/dist/src/services/meta/__tests__/meta-api.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/meta/__tests__/meta-api.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst getMetaConfigMock = vi.fn();\nconst createMetaAppSecretProofMock = vi.fn();\n\nvi.mock(\"../../../config/meta.js\", () => ({\n  getMetaConfig: getMetaConfigMock,\n  createMetaAppSecretProof: createMetaAppSecretProofMock,\n}));\n\nconst { metaFetch } = await import(\"../meta-api.js\");\n\ndescribe(\"meta api\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n    getMetaConfigMock.mockReturnValue({\n      baseUrl: \"https://graph.facebook.com/v25.0\",\n      appSecret: \"app-secret\",\n    });\n    createMetaAppSecretProofMock.mockReturnValue(\"proof-123\");\n  });\n\n  it(\"builds Graph API URLs with token, proof and non-empty query params\", async () => {\n    const fetchMock = vi.fn().mockResolvedValue({\n      ok: true,\n      json: vi.fn().mockResolvedValue({ data: [{ id: \"biz-1\" }] }),\n    });\n    vi.stubGlobal(\"fetch\", fetchMock);\n\n    const result = await metaFetch(\n      { accessToken: \"access-token\" },\n      \"me/businesses\",\n      {\n        fields: \"id,name\",\n        limit: 100,\n        after: undefined,\n        empty: \"\",\n      }\n    );\n\n    expect(result).toEqual({ data: [{ id: \"biz-1\" }] });\n    expect(createMetaAppSecretProofMock).toHaveBeenCalledWith(\"access-token\", \"app-secret\");\n    expect(fetchMock).toHaveBeenCalledWith(\n      \"https://graph.facebook.com/v25.0/me/businesses?access_token=access-token&appsecret_proof=proof-123&fields=id%2Cname&limit=100\",\n      {\n        method: \"GET\",\n        headers: { Accept: \"application/json\" },\n      }\n    );\n  });\n\n  it(\"prefers user-facing Meta errors and falls back to status-based messages\", async () => {\n    const userFacingResponse = {\n      ok: false,\n      status: 400,\n      json: vi.fn().mockResolvedValue({\n        error: {\n          error_user_msg: \"Choose a different account.\",\n          message: \"Low-level error\",\n        },\n      }),\n    };\n    const statusFallbackResponse = {\n      ok: false,\n      status: 503,\n      json: vi.fn().mockRejectedValue(new Error(\"invalid json\")),\n    };\n    const fetchMock = vi\n      .fn()\n      .mockResolvedValueOnce(userFacingResponse)\n      .mockResolvedValueOnce(statusFallbackResponse);\n    vi.stubGlobal(\"fetch\", fetchMock);\n\n    await expect(metaFetch({ accessToken: \"token\" }, \"/broken\")).rejects.toThrow(\n      \"Choose a different account.\"\n    );\n    await expect(metaFetch({ accessToken: \"token\" }, \"/broken-again\")).rejects.toThrow(\n      \"Meta API request failed with status 503\"\n    );\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,YAAY,UAAU,QAAQ,IAAI,UAAU;AAErD,MAAM,oBAAoB,GAAG,GAAG;AAChC,MAAM,+BAA+B,GAAG,GAAG;AAE3C,GAAG,KAAK,2BAA2B,OAAO;AAAA,EACxC,eAAe;AAAA,EACf,0BAA0B;AAC5B,EAAE;AAEF,MAAM,EAAE,UAAU,IAAI,MAAM,OAAO,gBAAgB;AAEnD,SAAS,YAAY,MAAM;AACzB,aAAW,MAAM;AACf,OAAG,cAAc;AACjB,sBAAkB,gBAAgB;AAAA,MAChC,SAAS;AAAA,MACT,WAAW;AAAA,IACb,CAAC;AACD,iCAA6B,gBAAgB,WAAW;AAAA,EAC1D,CAAC;AAED,KAAG,sEAAsE,YAAY;AACnF,UAAM,YAAY,GAAG,GAAG,EAAE,kBAAkB;AAAA,MAC1C,IAAI;AAAA,MACJ,MAAM,GAAG,GAAG,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC;AAAA,IAC7D,CAAC;AACD,OAAG,WAAW,SAAS,SAAS;AAEhC,UAAM,SAAS,MAAM;AAAA,MACnB,EAAE,aAAa,eAAe;AAAA,MAC9B;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC;AAClD,WAAO,4BAA4B,EAAE,qBAAqB,gBAAgB,YAAY;AACtF,WAAO,SAAS,EAAE;AAAA,MAChB;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,SAAS,EAAE,QAAQ,mBAAmB;AAAA,MACxC;AAAA,IACF;AAAA,EACF,CAAC;AAED,KAAG,2EAA2E,YAAY;AACxF,UAAM,qBAAqB;AAAA,MACzB,IAAI;AAAA,MACJ,QAAQ;AAAA,MACR,MAAM,GAAG,GAAG,EAAE,kBAAkB;AAAA,QAC9B,OAAO;AAAA,UACL,gBAAgB;AAAA,UAChB,SAAS;AAAA,QACX;AAAA,MACF,CAAC;AAAA,IACH;AACA,UAAM,yBAAyB;AAAA,MAC7B,IAAI;AAAA,MACJ,QAAQ;AAAA,MACR,MAAM,GAAG,GAAG,EAAE,kBAAkB,IAAI,MAAM,cAAc,CAAC;AAAA,IAC3D;AACA,UAAM,YAAY,GACf,GAAG,EACH,sBAAsB,kBAAkB,EACxC,sBAAsB,sBAAsB;AAC/C,OAAG,WAAW,SAAS,SAAS;AAEhC,UAAM,OAAO,UAAU,EAAE,aAAa,QAAQ,GAAG,SAAS,CAAC,EAAE,QAAQ;AAAA,MACnE;AAAA,IACF;AACA,UAAM,OAAO,UAAU,EAAE,aAAa,QAAQ,GAAG,eAAe,CAAC,EAAE,QAAQ;AAAA,MACzE;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/src/services/meta/meta-ads.js

@@ -1,4 +1,6 @@
-import { metaFetch } from "./meta-api.js";
+import {
+  metaFetch
+} from "./meta-api.js";
 import { normalizeMetaAdAccountId, toActId } from "../../meta/meta-utils.js";
 function decodePagingCursor(url) {
   if (!url) {
@@ -10,12 +12,22 @@ function decodePagingCursor(url) {
     return void 0;
   }
 }
-async function listAccessibleMetaBusinesses(after) {
-  const response = await metaFetch("/me/businesses", {
-    fields: "id,name,verification_status",
-    limit: 100,
-    after
-  });
+function normalizeMetaAdAccount(account) {
+  return {
+    ...account,
+    account_id: account.account_id || normalizeMetaAdAccountId(account.id || "")
+  };
+}
+async function listAccessibleMetaBusinesses(context, after) {
+  const response = await metaFetch(
+    context,
+    "/me/businesses",
+    {
+      fields: "id,name,verification_status",
+      limit: 100,
+      after
+    }
+  );
   return {
     businesses: response.data ?? [],
     paging: {
@@ -25,16 +37,22 @@ async function listAccessibleMetaBusinesses(after) {
     }
   };
 }
-async function listAccessibleMetaAdAccounts(after) {
-  const response = await metaFetch("/me/adaccounts", {
-    fields: "id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name}",
-    limit: 100,
-    after
+async function getMetaBusinessInfo(context, businessId) {
+  return metaFetch(context, `/${businessId}`, {
+    fields: "id,name,verification_status"
   });
-  const accounts = (response.data ?? []).map((account) => ({
-    ...account,
-    account_id: account.account_id || normalizeMetaAdAccountId(account.id || "")
-  }));
+}
+async function listAccessibleMetaAdAccounts(context, after) {
+  const response = await metaFetch(
+    context,
+    "/me/adaccounts",
+    {
+      fields: "id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name}",
+      limit: 100,
+      after
+    }
+  );
+  const accounts = (response.data ?? []).map(normalizeMetaAdAccount);
   return {
     adAccounts: accounts,
     paging: {
@@ -44,42 +62,78 @@ async function listAccessibleMetaAdAccounts(after) {
     }
   };
 }
-async function getMetaAdAccountInfo(adAccountId) {
-  return metaFetch(`/${toActId(adAccountId)}`, {
-    fields: "id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name},amount_spent,balance,spend_cap"
-  });
+async function getMetaAdAccountInfo(context, adAccountId) {
+  const account = await metaFetch(
+    context,
+    `/${toActId(adAccountId)}`,
+    {
+      fields: "id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name},amount_spent,balance,spend_cap"
+    }
+  );
+  return normalizeMetaAdAccount(account);
 }
-async function getMetaInsights(objectId, params) {
-  const response = await metaFetch(`/${objectId}/insights`, {
-    fields: "impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas,date_start,date_stop",
-    ...params
-  });
+async function getMetaAdAccountsByIds(context, adAccountIds) {
+  const uniqueIds = Array.from(
+    new Set(
+      adAccountIds.map((adAccountId) => normalizeMetaAdAccountId(adAccountId))
+    )
+  );
+  const results = await Promise.allSettled(
+    uniqueIds.map((adAccountId) => getMetaAdAccountInfo(context, adAccountId))
+  );
+  return results.flatMap(
+    (result) => result.status === "fulfilled" ? [result.value] : []
+  );
+}
+async function getMetaInsights(context, objectId, params) {
+  const response = await metaFetch(
+    context,
+    `/${objectId}/insights`,
+    {
+      fields: "impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas,date_start,date_stop",
+      ...params
+    }
+  );
   return response.data ?? [];
 }
-async function getMetaCampaigns(adAccountId, limit = 50) {
-  const response = await metaFetch(`/${toActId(adAccountId)}/campaigns`, {
-    fields: "id,name,status,effective_status,objective",
-    limit
-  });
+async function getMetaCampaigns(context, adAccountId, limit = 50) {
+  const response = await metaFetch(
+    context,
+    `/${toActId(adAccountId)}/campaigns`,
+    {
+      fields: "id,name,status,effective_status,objective",
+      limit
+    }
+  );
   return response.data ?? [];
 }
-async function getMetaAds(adAccountId, limit = 50) {
-  const response = await metaFetch(`/${toActId(adAccountId)}/ads`, {
-    fields: "id,name,status,effective_status,creative{id}",
-    limit
-  });
+async function getMetaAds(context, adAccountId, limit = 50) {
+  const response = await metaFetch(
+    context,
+    `/${toActId(adAccountId)}/ads`,
+    {
+      fields: "id,name,status,effective_status,creative{id}",
+      limit
+    }
+  );
   return response.data ?? [];
 }
-async function getMetaPlacementInsights(adAccountId, params) {
-  const response = await metaFetch(`/${toActId(adAccountId)}/insights`, {
-    fields: "impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas",
-    ...params
-  });
+async function getMetaPlacementInsights(context, adAccountId, params) {
+  const response = await metaFetch(
+    context,
+    `/${toActId(adAccountId)}/insights`,
+    {
+      fields: "impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas",
+      ...params
+    }
+  );
   return response.data ?? [];
 }
 export {
   getMetaAdAccountInfo,
+  getMetaAdAccountsByIds,
   getMetaAds,
+  getMetaBusinessInfo,
   getMetaCampaigns,
   getMetaInsights,
   getMetaPlacementInsights,

package/dist/src/services/meta/meta-ads.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/services/meta/meta-ads.ts"],
-  "sourcesContent": ["import { metaFetch, type MetaListResponse } from \"./meta-api.js\";\nimport { normalizeMetaAdAccountId, toActId } from \"../../meta/meta-utils.js\";\n\nexport interface MetaBusiness {\n  id?: string;\n  name?: string;\n  verification_status?: string;\n}\n\nexport interface MetaBusinessRef {\n  id?: string;\n  name?: string;\n}\n\nexport interface MetaAdAccount {\n  id?: string;\n  account_id?: string;\n  name?: string;\n  currency?: string;\n  account_status?: number;\n  timezone_name?: string;\n  timezone_offset_hours_utc?: number;\n  business?: MetaBusinessRef;\n}\n\nexport interface MetaActionMetric {\n  action_type?: string;\n  value?: string;\n}\n\nexport interface MetaRoasMetric {\n  action_type?: string;\n  value?: string;\n}\n\nexport interface MetaAdInsight {\n  date_start?: string;\n  date_stop?: string;\n  impressions?: string;\n  reach?: string;\n  clicks?: string;\n  spend?: string;\n  ctr?: string;\n  cpc?: string;\n  cpm?: string;\n  actions?: MetaActionMetric[];\n  action_values?: MetaActionMetric[];\n  purchase_roas?: MetaRoasMetric[];\n}\n\nexport interface MetaCampaign {\n  id?: string;\n  name?: string;\n  status?: string;\n  effective_status?: string;\n  objective?: string;\n}\n\nexport interface MetaAd {\n  id?: string;\n  name?: string;\n  status?: string;\n  effective_status?: string;\n  creative?: {\n    id?: string;\n  };\n}\n\nexport interface MetaPlacementRow extends MetaAdInsight {\n  publisher_platform?: string;\n  platform_position?: string;\n  impression_device?: string;\n}\n\nfunction decodePagingCursor(url: string | undefined): string | undefined {\n  if (!url) {\n    return undefined;\n  }\n\n  try {\n    return new URL(url).searchParams.get(\"after\") || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport async function listAccessibleMetaBusinesses(after?: string) {\n  const response = await metaFetch<MetaListResponse<MetaBusiness>>(\"/me/businesses\", {\n    fields: \"id,name,verification_status\",\n    limit: 100,\n    after,\n  });\n\n  return {\n    businesses: response.data ?? [],\n    paging: {\n      after: response.paging?.cursors?.after || decodePagingCursor(response.paging?.next),\n      before: response.paging?.cursors?.before,\n      has_more: Boolean(response.paging?.next),\n    },\n  };\n}\n\nexport async function listAccessibleMetaAdAccounts(after?: string) {\n  const response = await metaFetch<MetaListResponse<MetaAdAccount>>(\"/me/adaccounts\", {\n    fields:\n      \"id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name}\",\n    limit: 100,\n    after,\n  });\n\n  const accounts = (response.data ?? []).map((account) => ({\n    ...account,\n    account_id: account.account_id || normalizeMetaAdAccountId(account.id || \"\"),\n  }));\n\n  return {\n    adAccounts: accounts,\n    paging: {\n      after: response.paging?.cursors?.after || decodePagingCursor(response.paging?.next),\n      before: response.paging?.cursors?.before,\n      has_more: Boolean(response.paging?.next),\n    },\n  };\n}\n\nexport async function getMetaAdAccountInfo(adAccountId: string): Promise<MetaAdAccount> {\n  return metaFetch<MetaAdAccount>(`/${toActId(adAccountId)}`, {\n    fields:\n      \"id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name},amount_spent,balance,spend_cap\",\n  });\n}\n\nexport async function getMetaInsights(\n  objectId: string,\n  params: Record<string, string | number | undefined>\n): Promise<MetaAdInsight[]> {\n  const response = await metaFetch<MetaListResponse<MetaAdInsight>>(`/${objectId}/insights`, {\n    fields:\n      \"impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas,date_start,date_stop\",\n    ...params,\n  });\n\n  return response.data ?? [];\n}\n\nexport async function getMetaCampaigns(adAccountId: string, limit = 50): Promise<MetaCampaign[]> {\n  const response = await metaFetch<MetaListResponse<MetaCampaign>>(`/${toActId(adAccountId)}/campaigns`, {\n    fields: \"id,name,status,effective_status,objective\",\n    limit,\n  });\n\n  return response.data ?? [];\n}\n\nexport async function getMetaAds(adAccountId: string, limit = 50): Promise<MetaAd[]> {\n  const response = await metaFetch<MetaListResponse<MetaAd>>(`/${toActId(adAccountId)}/ads`, {\n    fields: \"id,name,status,effective_status,creative{id}\",\n    limit,\n  });\n\n  return response.data ?? [];\n}\n\nexport async function getMetaPlacementInsights(\n  adAccountId: string,\n  params: Record<string, string | number | undefined>\n): Promise<MetaPlacementRow[]> {\n  const response = await metaFetch<MetaListResponse<MetaPlacementRow>>(`/${toActId(adAccountId)}/insights`, {\n    fields:\n      \"impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas\",\n    ...params,\n  });\n\n  return response.data ?? [];\n}\n"],
-  "mappings": "AAAA,SAAS,iBAAwC;AACjD,SAAS,0BAA0B,eAAe;AAyElD,SAAS,mBAAmB,KAA6C;AACvE,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,IAAI,IAAI,GAAG,EAAE,aAAa,IAAI,OAAO,KAAK;AAAA,EACnD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,6BAA6B,OAAgB;AACjE,QAAM,WAAW,MAAM,UAA0C,kBAAkB;AAAA,IACjF,QAAQ;AAAA,IACR,OAAO;AAAA,IACP;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL,YAAY,SAAS,QAAQ,CAAC;AAAA,IAC9B,QAAQ;AAAA,MACN,OAAO,SAAS,QAAQ,SAAS,SAAS,mBAAmB,SAAS,QAAQ,IAAI;AAAA,MAClF,QAAQ,SAAS,QAAQ,SAAS;AAAA,MAClC,UAAU,QAAQ,SAAS,QAAQ,IAAI;AAAA,IACzC;AAAA,EACF;AACF;AAEA,eAAsB,6BAA6B,OAAgB;AACjE,QAAM,WAAW,MAAM,UAA2C,kBAAkB;AAAA,IAClF,QACE;AAAA,IACF,OAAO;AAAA,IACP;AAAA,EACF,CAAC;AAED,QAAM,YAAY,SAAS,QAAQ,CAAC,GAAG,IAAI,CAAC,aAAa;AAAA,IACvD,GAAG;AAAA,IACH,YAAY,QAAQ,cAAc,yBAAyB,QAAQ,MAAM,EAAE;AAAA,EAC7E,EAAE;AAEF,SAAO;AAAA,IACL,YAAY;AAAA,IACZ,QAAQ;AAAA,MACN,OAAO,SAAS,QAAQ,SAAS,SAAS,mBAAmB,SAAS,QAAQ,IAAI;AAAA,MAClF,QAAQ,SAAS,QAAQ,SAAS;AAAA,MAClC,UAAU,QAAQ,SAAS,QAAQ,IAAI;AAAA,IACzC;AAAA,EACF;AACF;AAEA,eAAsB,qBAAqB,aAA6C;AACtF,SAAO,UAAyB,IAAI,QAAQ,WAAW,CAAC,IAAI;AAAA,IAC1D,QACE;AAAA,EACJ,CAAC;AACH;AAEA,eAAsB,gBACpB,UACA,QAC0B;AAC1B,QAAM,WAAW,MAAM,UAA2C,IAAI,QAAQ,aAAa;AAAA,IACzF,QACE;AAAA,IACF,GAAG;AAAA,EACL,CAAC;AAED,SAAO,SAAS,QAAQ,CAAC;AAC3B;AAEA,eAAsB,iBAAiB,aAAqB,QAAQ,IAA6B;AAC/F,QAAM,WAAW,MAAM,UAA0C,IAAI,QAAQ,WAAW,CAAC,cAAc;AAAA,IACrG,QAAQ;AAAA,IACR;AAAA,EACF,CAAC;AAED,SAAO,SAAS,QAAQ,CAAC;AAC3B;AAEA,eAAsB,WAAW,aAAqB,QAAQ,IAAuB;AACnF,QAAM,WAAW,MAAM,UAAoC,IAAI,QAAQ,WAAW,CAAC,QAAQ;AAAA,IACzF,QAAQ;AAAA,IACR;AAAA,EACF,CAAC;AAED,SAAO,SAAS,QAAQ,CAAC;AAC3B;AAEA,eAAsB,yBACpB,aACA,QAC6B;AAC7B,QAAM,WAAW,MAAM,UAA8C,IAAI,QAAQ,WAAW,CAAC,aAAa;AAAA,IACxG,QACE;AAAA,IACF,GAAG;AAAA,EACL,CAAC;AAED,SAAO,SAAS,QAAQ,CAAC;AAC3B;",
+  "sourcesContent": ["import {\n\tmetaFetch,\n\ttype MetaListResponse,\n\ttype MetaRequestContext,\n} from \"./meta-api.js\";\nimport { normalizeMetaAdAccountId, toActId } from \"../../meta/meta-utils.js\";\n\nexport interface MetaBusiness {\n\tid?: string;\n\tname?: string;\n\tverification_status?: string;\n}\n\nexport interface MetaBusinessRef {\n\tid?: string;\n\tname?: string;\n}\n\nexport interface MetaAdAccount {\n\tid?: string;\n\taccount_id?: string;\n\tname?: string;\n\tcurrency?: string;\n\taccount_status?: number;\n\ttimezone_name?: string;\n\ttimezone_offset_hours_utc?: number;\n\tbusiness?: MetaBusinessRef;\n}\n\nexport interface MetaActionMetric {\n\taction_type?: string;\n\tvalue?: string;\n}\n\nexport interface MetaRoasMetric {\n\taction_type?: string;\n\tvalue?: string;\n}\n\nexport interface MetaAdInsight {\n\tdate_start?: string;\n\tdate_stop?: string;\n\timpressions?: string;\n\treach?: string;\n\tclicks?: string;\n\tspend?: string;\n\tctr?: string;\n\tcpc?: string;\n\tcpm?: string;\n\tactions?: MetaActionMetric[];\n\taction_values?: MetaActionMetric[];\n\tpurchase_roas?: MetaRoasMetric[];\n}\n\nexport interface MetaCampaign {\n\tid?: string;\n\tname?: string;\n\tstatus?: string;\n\teffective_status?: string;\n\tobjective?: string;\n}\n\nexport interface MetaAd {\n\tid?: string;\n\tname?: string;\n\tstatus?: string;\n\teffective_status?: string;\n\tcreative?: {\n\t\tid?: string;\n\t};\n}\n\nexport interface MetaPlacementRow extends MetaAdInsight {\n\tpublisher_platform?: string;\n\tplatform_position?: string;\n\timpression_device?: string;\n}\n\nfunction decodePagingCursor(url: string | undefined): string | undefined {\n\tif (!url) {\n\t\treturn undefined;\n\t}\n\n\ttry {\n\t\treturn new URL(url).searchParams.get(\"after\") || undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction normalizeMetaAdAccount(account: MetaAdAccount): MetaAdAccount {\n\treturn {\n\t\t...account,\n\t\taccount_id:\n\t\t\taccount.account_id || normalizeMetaAdAccountId(account.id || \"\"),\n\t};\n}\n\nexport async function listAccessibleMetaBusinesses(\n\tcontext: MetaRequestContext,\n\tafter?: string,\n) {\n\tconst response = await metaFetch<MetaListResponse<MetaBusiness>>(\n\t\tcontext,\n\t\t\"/me/businesses\",\n\t\t{\n\t\t\tfields: \"id,name,verification_status\",\n\t\t\tlimit: 100,\n\t\t\tafter,\n\t\t},\n\t);\n\n\treturn {\n\t\tbusinesses: response.data ?? [],\n\t\tpaging: {\n\t\t\tafter:\n\t\t\t\tresponse.paging?.cursors?.after ||\n\t\t\t\tdecodePagingCursor(response.paging?.next),\n\t\t\tbefore: response.paging?.cursors?.before,\n\t\t\thas_more: Boolean(response.paging?.next),\n\t\t},\n\t};\n}\n\nexport async function getMetaBusinessInfo(\n\tcontext: MetaRequestContext,\n\tbusinessId: string,\n): Promise<MetaBusiness> {\n\treturn metaFetch<MetaBusiness>(context, `/${businessId}`, {\n\t\tfields: \"id,name,verification_status\",\n\t});\n}\n\nexport async function listAccessibleMetaAdAccounts(\n\tcontext: MetaRequestContext,\n\tafter?: string,\n) {\n\tconst response = await metaFetch<MetaListResponse<MetaAdAccount>>(\n\t\tcontext,\n\t\t\"/me/adaccounts\",\n\t\t{\n\t\t\tfields:\n\t\t\t\t\"id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name}\",\n\t\t\tlimit: 100,\n\t\t\tafter,\n\t\t},\n\t);\n\n\tconst accounts = (response.data ?? []).map(normalizeMetaAdAccount);\n\n\treturn {\n\t\tadAccounts: accounts,\n\t\tpaging: {\n\t\t\tafter:\n\t\t\t\tresponse.paging?.cursors?.after ||\n\t\t\t\tdecodePagingCursor(response.paging?.next),\n\t\t\tbefore: response.paging?.cursors?.before,\n\t\t\thas_more: Boolean(response.paging?.next),\n\t\t},\n\t};\n}\n\nexport async function getMetaAdAccountInfo(\n\tcontext: MetaRequestContext,\n\tadAccountId: string,\n): Promise<MetaAdAccount> {\n\tconst account = await metaFetch<MetaAdAccount>(\n\t\tcontext,\n\t\t`/${toActId(adAccountId)}`,\n\t\t{\n\t\t\tfields:\n\t\t\t\t\"id,account_id,name,currency,account_status,timezone_name,timezone_offset_hours_utc,business{id,name},amount_spent,balance,spend_cap\",\n\t\t},\n\t);\n\n\treturn normalizeMetaAdAccount(account);\n}\n\nexport async function getMetaAdAccountsByIds(\n\tcontext: MetaRequestContext,\n\tadAccountIds: string[],\n): Promise<MetaAdAccount[]> {\n\tconst uniqueIds = Array.from(\n\t\tnew Set(\n\t\t\tadAccountIds.map((adAccountId) => normalizeMetaAdAccountId(adAccountId)),\n\t\t),\n\t);\n\tconst results = await Promise.allSettled(\n\t\tuniqueIds.map((adAccountId) => getMetaAdAccountInfo(context, adAccountId)),\n\t);\n\n\treturn results.flatMap((result) =>\n\t\tresult.status === \"fulfilled\" ? [result.value] : [],\n\t);\n}\n\nexport async function getMetaInsights(\n\tcontext: MetaRequestContext,\n\tobjectId: string,\n\tparams: Record<string, string | number | undefined>,\n): Promise<MetaAdInsight[]> {\n\tconst response = await metaFetch<MetaListResponse<MetaAdInsight>>(\n\t\tcontext,\n\t\t`/${objectId}/insights`,\n\t\t{\n\t\t\tfields:\n\t\t\t\t\"impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas,date_start,date_stop\",\n\t\t\t...params,\n\t\t},\n\t);\n\n\treturn response.data ?? [];\n}\n\nexport async function getMetaCampaigns(\n\tcontext: MetaRequestContext,\n\tadAccountId: string,\n\tlimit = 50,\n): Promise<MetaCampaign[]> {\n\tconst response = await metaFetch<MetaListResponse<MetaCampaign>>(\n\t\tcontext,\n\t\t`/${toActId(adAccountId)}/campaigns`,\n\t\t{\n\t\t\tfields: \"id,name,status,effective_status,objective\",\n\t\t\tlimit,\n\t\t},\n\t);\n\n\treturn response.data ?? [];\n}\n\nexport async function getMetaAds(\n\tcontext: MetaRequestContext,\n\tadAccountId: string,\n\tlimit = 50,\n): Promise<MetaAd[]> {\n\tconst response = await metaFetch<MetaListResponse<MetaAd>>(\n\t\tcontext,\n\t\t`/${toActId(adAccountId)}/ads`,\n\t\t{\n\t\t\tfields: \"id,name,status,effective_status,creative{id}\",\n\t\t\tlimit,\n\t\t},\n\t);\n\n\treturn response.data ?? [];\n}\n\nexport async function getMetaPlacementInsights(\n\tcontext: MetaRequestContext,\n\tadAccountId: string,\n\tparams: Record<string, string | number | undefined>,\n): Promise<MetaPlacementRow[]> {\n\tconst response = await metaFetch<MetaListResponse<MetaPlacementRow>>(\n\t\tcontext,\n\t\t`/${toActId(adAccountId)}/insights`,\n\t\t{\n\t\t\tfields:\n\t\t\t\t\"impressions,reach,clicks,spend,ctr,cpc,cpm,actions,action_values,purchase_roas\",\n\t\t\t...params,\n\t\t},\n\t);\n\n\treturn response.data ?? [];\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/services/meta/meta-api.js

@@ -1,11 +1,13 @@
 import { createMetaAppSecretProof, getMetaConfig } from "../../config/meta.js";
-function buildUrl(path, query) {
+function buildUrl(context, path, query) {
   const config = getMetaConfig();
-  const accessToken = config.accessToken;
-  const appSecretProof = createMetaAppSecretProof(accessToken, config.appSecret);
+  const appSecretProof = createMetaAppSecretProof(
+    context.accessToken,
+    config.appSecret
+  );
   const normalizedPath = path.startsWith("/") ? path : `/${path}`;
   const searchParams = new URLSearchParams();
-  searchParams.set("access_token", accessToken);
+  searchParams.set("access_token", context.accessToken);
   searchParams.set("appsecret_proof", appSecretProof);
   for (const [key, value] of Object.entries(query)) {
     if (value === void 0 || value === null || value === "") {
@@ -15,8 +17,8 @@ function buildUrl(path, query) {
   }
   return `${config.baseUrl}${normalizedPath}?${searchParams.toString()}`;
 }
-async function metaFetch(path, query = {}) {
-  const response = await fetch(buildUrl(path, query), {
+async function metaFetch(context, path, query = {}) {
+  const response = await fetch(buildUrl(context, path, query), {
     method: "GET",
     headers: {
       Accept: "application/json"

package/dist/src/services/meta/meta-api.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/services/meta/meta-api.ts"],
-  "sourcesContent": ["import { createMetaAppSecretProof, getMetaConfig } from \"../../config/meta.js\";\n\ninterface MetaErrorPayload {\n  error?: {\n    message?: string;\n    type?: string;\n    code?: number;\n    error_subcode?: number;\n    error_user_title?: string;\n    error_user_msg?: string;\n    fbtrace_id?: string;\n  };\n}\n\nexport interface MetaPagingCursor {\n  before?: string;\n  after?: string;\n}\n\nexport interface MetaPaging {\n  cursors?: MetaPagingCursor;\n  next?: string;\n  previous?: string;\n}\n\nexport interface MetaListResponse<T> {\n  data?: T[];\n  paging?: MetaPaging;\n}\n\nfunction buildUrl(path: string, query: Record<string, string | number | undefined>): string {\n  const config = getMetaConfig();\n  const accessToken = config.accessToken;\n  const appSecretProof = createMetaAppSecretProof(accessToken, config.appSecret);\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  const searchParams = new URLSearchParams();\n\n  searchParams.set(\"access_token\", accessToken);\n  searchParams.set(\"appsecret_proof\", appSecretProof);\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null || value === \"\") {\n      continue;\n    }\n\n    searchParams.set(key, String(value));\n  }\n\n  return `${config.baseUrl}${normalizedPath}?${searchParams.toString()}`;\n}\n\nexport async function metaFetch<T>(\n  path: string,\n  query: Record<string, string | number | undefined> = {}\n): Promise<T> {\n  const response = await fetch(buildUrl(path, query), {\n    method: \"GET\",\n    headers: {\n      Accept: \"application/json\",\n    },\n  });\n\n  if (!response.ok) {\n    const payload = (await response.json().catch(() => ({}))) as MetaErrorPayload;\n    const message =\n      payload.error?.error_user_msg ||\n      payload.error?.error_user_title ||\n      payload.error?.message ||\n      `Meta API request failed with status ${response.status}`;\n\n    throw new Error(message);\n  }\n\n  return (await response.json()) as T;\n}\n"],
-  "mappings": "AAAA,SAAS,0BAA0B,qBAAqB;AA8BxD,SAAS,SAAS,MAAc,OAA4D;AAC1F,QAAM,SAAS,cAAc;AAC7B,QAAM,cAAc,OAAO;AAC3B,QAAM,iBAAiB,yBAAyB,aAAa,OAAO,SAAS;AAC7E,QAAM,iBAAiB,KAAK,WAAW,GAAG,IAAI,OAAO,IAAI,IAAI;AAC7D,QAAM,eAAe,IAAI,gBAAgB;AAEzC,eAAa,IAAI,gBAAgB,WAAW;AAC5C,eAAa,IAAI,mBAAmB,cAAc;AAElD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,UAAU,UAAa,UAAU,QAAQ,UAAU,IAAI;AACzD;AAAA,IACF;AAEA,iBAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,EACrC;AAEA,SAAO,GAAG,OAAO,OAAO,GAAG,cAAc,IAAI,aAAa,SAAS,CAAC;AACtE;AAEA,eAAsB,UACpB,MACA,QAAqD,CAAC,GAC1C;AACZ,QAAM,WAAW,MAAM,MAAM,SAAS,MAAM,KAAK,GAAG;AAAA,IAClD,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,UAAW,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AACvD,UAAM,UACJ,QAAQ,OAAO,kBACf,QAAQ,OAAO,oBACf,QAAQ,OAAO,WACf,uCAAuC,SAAS,MAAM;AAExD,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AAEA,SAAQ,MAAM,SAAS,KAAK;AAC9B;",
+  "sourcesContent": ["import { createMetaAppSecretProof, getMetaConfig } from \"../../config/meta.js\";\n\ninterface MetaErrorPayload {\n\terror?: {\n\t\tmessage?: string;\n\t\ttype?: string;\n\t\tcode?: number;\n\t\terror_subcode?: number;\n\t\terror_user_title?: string;\n\t\terror_user_msg?: string;\n\t\tfbtrace_id?: string;\n\t};\n}\n\nexport interface MetaRequestContext {\n\taccessToken: string;\n}\n\nexport interface MetaPagingCursor {\n\tbefore?: string;\n\tafter?: string;\n}\n\nexport interface MetaPaging {\n\tcursors?: MetaPagingCursor;\n\tnext?: string;\n\tprevious?: string;\n}\n\nexport interface MetaListResponse<T> {\n\tdata?: T[];\n\tpaging?: MetaPaging;\n}\n\nfunction buildUrl(\n\tcontext: MetaRequestContext,\n\tpath: string,\n\tquery: Record<string, string | number | undefined>,\n): string {\n\tconst config = getMetaConfig();\n\tconst appSecretProof = createMetaAppSecretProof(\n\t\tcontext.accessToken,\n\t\tconfig.appSecret,\n\t);\n\tconst normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n\tconst searchParams = new URLSearchParams();\n\n\tsearchParams.set(\"access_token\", context.accessToken);\n\tsearchParams.set(\"appsecret_proof\", appSecretProof);\n\n\tfor (const [key, value] of Object.entries(query)) {\n\t\tif (value === undefined || value === null || value === \"\") {\n\t\t\tcontinue;\n\t\t}\n\n\t\tsearchParams.set(key, String(value));\n\t}\n\n\treturn `${config.baseUrl}${normalizedPath}?${searchParams.toString()}`;\n}\n\nexport async function metaFetch<T>(\n\tcontext: MetaRequestContext,\n\tpath: string,\n\tquery: Record<string, string | number | undefined> = {},\n): Promise<T> {\n\tconst response = await fetch(buildUrl(context, path, query), {\n\t\tmethod: \"GET\",\n\t\theaders: {\n\t\t\tAccept: \"application/json\",\n\t\t},\n\t});\n\n\tif (!response.ok) {\n\t\tconst payload = (await response\n\t\t\t.json()\n\t\t\t.catch(() => ({}))) as MetaErrorPayload;\n\t\tconst message =\n\t\t\tpayload.error?.error_user_msg ||\n\t\t\tpayload.error?.error_user_title ||\n\t\t\tpayload.error?.message ||\n\t\t\t`Meta API request failed with status ${response.status}`;\n\n\t\tthrow new Error(message);\n\t}\n\n\treturn (await response.json()) as T;\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B,qBAAqB;AAkCxD,SAAS,SACR,SACA,MACA,OACS;AACT,QAAM,SAAS,cAAc;AAC7B,QAAM,iBAAiB;AAAA,IACtB,QAAQ;AAAA,IACR,OAAO;AAAA,EACR;AACA,QAAM,iBAAiB,KAAK,WAAW,GAAG,IAAI,OAAO,IAAI,IAAI;AAC7D,QAAM,eAAe,IAAI,gBAAgB;AAEzC,eAAa,IAAI,gBAAgB,QAAQ,WAAW;AACpD,eAAa,IAAI,mBAAmB,cAAc;AAElD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AACjD,QAAI,UAAU,UAAa,UAAU,QAAQ,UAAU,IAAI;AAC1D;AAAA,IACD;AAEA,iBAAa,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,EACpC;AAEA,SAAO,GAAG,OAAO,OAAO,GAAG,cAAc,IAAI,aAAa,SAAS,CAAC;AACrE;AAEA,eAAsB,UACrB,SACA,MACA,QAAqD,CAAC,GACzC;AACb,QAAM,WAAW,MAAM,MAAM,SAAS,SAAS,MAAM,KAAK,GAAG;AAAA,IAC5D,QAAQ;AAAA,IACR,SAAS;AAAA,MACR,QAAQ;AAAA,IACT;AAAA,EACD,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AACjB,UAAM,UAAW,MAAM,SACrB,KAAK,EACL,MAAM,OAAO,CAAC,EAAE;AAClB,UAAM,UACL,QAAQ,OAAO,kBACf,QAAQ,OAAO,oBACf,QAAQ,OAAO,WACf,uCAAuC,SAAS,MAAM;AAEvD,UAAM,IAAI,MAAM,OAAO;AAAA,EACxB;AAEA,SAAQ,MAAM,SAAS,KAAK;AAC7B;",
   "names": []
 }