@yoryoboy/bi-mcp 1.10.0 → 1.13.0

package/dist/src/config/meta-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/config/meta-store.ts"],
+  "sourcesContent": ["import { getDb } from \"../db/client.js\";\nimport { normalizeRequestedAccountIds } from \"../meta/meta-utils.js\";\nimport { decryptSecret } from \"./vtex-crypto.js\";\n\nexport type MetaConnectionStatus =\n\t| \"active\"\n\t| \"disabled\"\n\t| \"expired\"\n\t| \"error\"\n\t| \"pending\";\n\nexport interface MetaOAuthConnectionRecord {\n\tid: string;\n\tencryptedAccessToken: string | null;\n\tscopes: string[];\n\tstatus: MetaConnectionStatus;\n\tmetaUserId: string | null;\n\ttokenExpiresAt: Date | null;\n\tlastValidatedAt: Date | null;\n\tlastError: string | null;\n\tupdatedAt: Date | null;\n}\n\nexport interface ProfileMetaMappingRecord {\n\tprofileId: string;\n\tmetaBusinessId: string | null;\n\tselectedAdAccountIds: string[];\n\tstatus: MetaConnectionStatus;\n\tlastValidatedAt: Date | null;\n\tlastError: string | null;\n\tupdatedAt: Date | null;\n}\n\ninterface MetaOAuthConnectionRow {\n\tid: string;\n\tencrypted_access_token: string | null;\n\tscopes: string[] | null;\n\tstatus: MetaConnectionStatus;\n\tmeta_user_id: string | null;\n\ttoken_expires_at: Date | null;\n\tlast_validated_at: Date | null;\n\tlast_error: string | null;\n\tupdated_at: Date | null;\n}\n\ninterface ProfileMetaMappingRow {\n\tprofile_id: string;\n\tmeta_business_id: string | null;\n\tselected_ad_account_ids: string[] | null;\n\tstatus: MetaConnectionStatus;\n\tlast_validated_at: Date | null;\n\tlast_error: string | null;\n\tupdated_at: Date | null;\n}\n\nfunction isMissingRelationError(error: unknown): boolean {\n\treturn error instanceof Error && /does not exist/i.test(error.message);\n}\n\nfunction normalizeStoredAdAccountIds(\n\taccountIds: string[] | null | undefined,\n): string[] {\n\treturn normalizeRequestedAccountIds(accountIds ?? []) ?? [];\n}\n\nfunction mapMetaOAuthConnection(\n\trow: MetaOAuthConnectionRow,\n): MetaOAuthConnectionRecord {\n\treturn {\n\t\tid: row.id,\n\t\tencryptedAccessToken: row.encrypted_access_token,\n\t\tscopes: Array.isArray(row.scopes) ? row.scopes : [],\n\t\tstatus: row.status,\n\t\tmetaUserId: row.meta_user_id,\n\t\ttokenExpiresAt: row.token_expires_at,\n\t\tlastValidatedAt: row.last_validated_at,\n\t\tlastError: row.last_error,\n\t\tupdatedAt: row.updated_at,\n\t};\n}\n\nfunction mapProfileMetaMapping(\n\trow: ProfileMetaMappingRow,\n): ProfileMetaMappingRecord {\n\treturn {\n\t\tprofileId: row.profile_id,\n\t\tmetaBusinessId: row.meta_business_id?.trim() || null,\n\t\tselectedAdAccountIds: normalizeStoredAdAccountIds(\n\t\t\trow.selected_ad_account_ids,\n\t\t),\n\t\tstatus: row.status,\n\t\tlastValidatedAt: row.last_validated_at,\n\t\tlastError: row.last_error,\n\t\tupdatedAt: row.updated_at,\n\t};\n}\n\nexport async function getMetaOAuthConnection(): Promise<MetaOAuthConnectionRecord | null> {\n\ttry {\n\t\tconst result = await getDb().query<MetaOAuthConnectionRow>(\n\t\t\t`select id, encrypted_access_token, scopes, status, meta_user_id, token_expires_at, last_validated_at, last_error, updated_at\n       from meta_oauth_connections\n       where id = 'global'`,\n\t\t);\n\t\tconst row = result.rows[0];\n\t\treturn row ? mapMetaOAuthConnection(row) : null;\n\t} catch (error) {\n\t\tif (isMissingRelationError(error)) return null;\n\t\tthrow error;\n\t}\n}\n\nexport async function getActiveMetaAccessTokenFromStore(): Promise<string> {\n\tconst connection = await getMetaOAuthConnection();\n\n\tif (!connection) {\n\t\tthrow new Error(\n\t\t\t\"Missing active Meta OAuth connection in database. Configure Meta OAuth in the dashboard first.\",\n\t\t);\n\t}\n\n\tif (connection.status !== \"active\") {\n\t\tthrow new Error(\n\t\t\t`Meta OAuth connection is not active (status: ${connection.status}). Validate or reconnect Meta OAuth in the dashboard.`,\n\t\t);\n\t}\n\n\tif (!connection.encryptedAccessToken) {\n\t\tthrow new Error(\n\t\t\t\"Meta OAuth connection is active but has no encrypted access token stored.\",\n\t\t);\n\t}\n\n\ttry {\n\t\treturn decryptSecret(connection.encryptedAccessToken);\n\t} catch (error) {\n\t\tconst message =\n\t\t\terror instanceof Error ? error.message : \"Unknown decryption error\";\n\t\tthrow new Error(\n\t\t\t`Failed to decrypt Meta OAuth access token from database: ${message}`,\n\t\t);\n\t}\n}\n\nexport async function getProfileMetaMapping(\n\tprofileId: string,\n): Promise<ProfileMetaMappingRecord | null> {\n\ttry {\n\t\tconst result = await getDb().query<ProfileMetaMappingRow>(\n\t\t\t`select profile_id, meta_business_id, selected_ad_account_ids, status, last_validated_at, last_error, updated_at\n       from profile_meta_mappings\n       where profile_id = $1`,\n\t\t\t[profileId],\n\t\t);\n\t\tconst row = result.rows[0];\n\t\treturn row ? mapProfileMetaMapping(row) : null;\n\t} catch (error) {\n\t\tif (isMissingRelationError(error)) return null;\n\t\tthrow error;\n\t}\n}\n\nexport async function listProfileMetaMappings(): Promise<\n\tProfileMetaMappingRecord[]\n> {\n\ttry {\n\t\tconst result = await getDb().query<ProfileMetaMappingRow>(\n\t\t\t`select profile_id, meta_business_id, selected_ad_account_ids, status, last_validated_at, last_error, updated_at\n       from profile_meta_mappings`,\n\t\t);\n\t\treturn result.rows.map(mapProfileMetaMapping);\n\t} catch (error) {\n\t\tif (isMissingRelationError(error)) return [];\n\t\tthrow error;\n\t}\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa;AACtB,SAAS,oCAAoC;AAC7C,SAAS,qBAAqB;AAqD9B,SAAS,uBAAuB,OAAyB;AACxD,SAAO,iBAAiB,SAAS,kBAAkB,KAAK,MAAM,OAAO;AACtE;AAEA,SAAS,4BACR,YACW;AACX,SAAO,6BAA6B,cAAc,CAAC,CAAC,KAAK,CAAC;AAC3D;AAEA,SAAS,uBACR,KAC4B;AAC5B,SAAO;AAAA,IACN,IAAI,IAAI;AAAA,IACR,sBAAsB,IAAI;AAAA,IAC1B,QAAQ,MAAM,QAAQ,IAAI,MAAM,IAAI,IAAI,SAAS,CAAC;AAAA,IAClD,QAAQ,IAAI;AAAA,IACZ,YAAY,IAAI;AAAA,IAChB,gBAAgB,IAAI;AAAA,IACpB,iBAAiB,IAAI;AAAA,IACrB,WAAW,IAAI;AAAA,IACf,WAAW,IAAI;AAAA,EAChB;AACD;AAEA,SAAS,sBACR,KAC2B;AAC3B,SAAO;AAAA,IACN,WAAW,IAAI;AAAA,IACf,gBAAgB,IAAI,kBAAkB,KAAK,KAAK;AAAA,IAChD,sBAAsB;AAAA,MACrB,IAAI;AAAA,IACL;AAAA,IACA,QAAQ,IAAI;AAAA,IACZ,iBAAiB,IAAI;AAAA,IACrB,WAAW,IAAI;AAAA,IACf,WAAW,IAAI;AAAA,EAChB;AACD;AAEA,eAAsB,yBAAoE;AACzF,MAAI;AACH,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC5B;AAAA;AAAA;AAAA,IAGD;AACA,UAAM,MAAM,OAAO,KAAK,CAAC;AACzB,WAAO,MAAM,uBAAuB,GAAG,IAAI;AAAA,EAC5C,SAAS,OAAO;AACf,QAAI,uBAAuB,KAAK,EAAG,QAAO;AAC1C,UAAM;AAAA,EACP;AACD;AAEA,eAAsB,oCAAqD;AAC1E,QAAM,aAAa,MAAM,uBAAuB;AAEhD,MAAI,CAAC,YAAY;AAChB,UAAM,IAAI;AAAA,MACT;AAAA,IACD;AAAA,EACD;AAEA,MAAI,WAAW,WAAW,UAAU;AACnC,UAAM,IAAI;AAAA,MACT,gDAAgD,WAAW,MAAM;AAAA,IAClE;AAAA,EACD;AAEA,MAAI,CAAC,WAAW,sBAAsB;AACrC,UAAM,IAAI;AAAA,MACT;AAAA,IACD;AAAA,EACD;AAEA,MAAI;AACH,WAAO,cAAc,WAAW,oBAAoB;AAAA,EACrD,SAAS,OAAO;AACf,UAAM,UACL,iBAAiB,QAAQ,MAAM,UAAU;AAC1C,UAAM,IAAI;AAAA,MACT,4DAA4D,OAAO;AAAA,IACpE;AAAA,EACD;AACD;AAEA,eAAsB,sBACrB,WAC2C;AAC3C,MAAI;AACH,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC5B;AAAA;AAAA;AAAA,MAGA,CAAC,SAAS;AAAA,IACX;AACA,UAAM,MAAM,OAAO,KAAK,CAAC;AACzB,WAAO,MAAM,sBAAsB,GAAG,IAAI;AAAA,EAC3C,SAAS,OAAO;AACf,QAAI,uBAAuB,KAAK,EAAG,QAAO;AAC1C,UAAM;AAAA,EACP;AACD;AAEA,eAAsB,0BAEpB;AACD,MAAI;AACH,UAAM,SAAS,MAAM,MAAM,EAAE;AAAA,MAC5B;AAAA;AAAA,IAED;AACA,WAAO,OAAO,KAAK,IAAI,qBAAqB;AAAA,EAC7C,SAAS,OAAO;AACf,QAAI,uBAAuB,KAAK,EAAG,QAAO,CAAC;AAC3C,UAAM;AAAA,EACP;AACD;",
+  "names": []
+}

package/dist/src/config/meta.js

@@ -9,12 +9,10 @@ function requireEnv(name) {
 function getMetaConfig() {
   const appId = requireEnv("META_APP_ID");
   const appSecret = requireEnv("META_APP_SECRET");
-  const accessToken = requireEnv("META_ACCESS_TOKEN");
   const apiVersion = process.env.META_API_VERSION?.trim() || "v25.0";
   return {
     appId,
     appSecret,
-    accessToken,
     apiVersion,
     baseUrl: `https://graph.facebook.com/${apiVersion}`
   };

package/dist/src/config/meta.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/config/meta.ts"],
-  "sourcesContent": ["import { createHmac } from \"node:crypto\";\n\nfunction requireEnv(name: \"META_APP_ID\" | \"META_APP_SECRET\" | \"META_ACCESS_TOKEN\"): string {\n  const value = process.env[name]?.trim();\n  if (!value) {\n    throw new Error(`Missing required environment variable: ${name}`);\n  }\n\n  return value;\n}\n\nexport interface MetaConfig {\n  appId: string;\n  appSecret: string;\n  accessToken: string;\n  apiVersion: string;\n  baseUrl: string;\n}\n\nexport function getMetaConfig(): MetaConfig {\n  const appId = requireEnv(\"META_APP_ID\");\n  const appSecret = requireEnv(\"META_APP_SECRET\");\n  const accessToken = requireEnv(\"META_ACCESS_TOKEN\");\n  const apiVersion = process.env.META_API_VERSION?.trim() || \"v25.0\";\n\n  return {\n    appId,\n    appSecret,\n    accessToken,\n    apiVersion,\n    baseUrl: `https://graph.facebook.com/${apiVersion}`,\n  };\n}\n\nexport function createMetaAppSecretProof(accessToken: string, appSecret: string): string {\n  return createHmac(\"sha256\", appSecret).update(accessToken).digest(\"hex\");\n}\n"],
-  "mappings": "AAAA,SAAS,kBAAkB;AAE3B,SAAS,WAAW,MAAuE;AACzF,QAAM,QAAQ,QAAQ,IAAI,IAAI,GAAG,KAAK;AACtC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,0CAA0C,IAAI,EAAE;AAAA,EAClE;AAEA,SAAO;AACT;AAUO,SAAS,gBAA4B;AAC1C,QAAM,QAAQ,WAAW,aAAa;AACtC,QAAM,YAAY,WAAW,iBAAiB;AAC9C,QAAM,cAAc,WAAW,mBAAmB;AAClD,QAAM,aAAa,QAAQ,IAAI,kBAAkB,KAAK,KAAK;AAE3D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,8BAA8B,UAAU;AAAA,EACnD;AACF;AAEO,SAAS,yBAAyB,aAAqB,WAA2B;AACvF,SAAO,WAAW,UAAU,SAAS,EAAE,OAAO,WAAW,EAAE,OAAO,KAAK;AACzE;",
+  "sourcesContent": ["import { createHmac } from \"node:crypto\";\n\nfunction requireEnv(name: \"META_APP_ID\" | \"META_APP_SECRET\"): string {\n\tconst value = process.env[name]?.trim();\n\tif (!value) {\n\t\tthrow new Error(`Missing required environment variable: ${name}`);\n\t}\n\n\treturn value;\n}\n\nexport interface MetaConfig {\n\tappId: string;\n\tappSecret: string;\n\tapiVersion: string;\n\tbaseUrl: string;\n}\n\nexport function getMetaConfig(): MetaConfig {\n\tconst appId = requireEnv(\"META_APP_ID\");\n\tconst appSecret = requireEnv(\"META_APP_SECRET\");\n\tconst apiVersion = process.env.META_API_VERSION?.trim() || \"v25.0\";\n\n\treturn {\n\t\tappId,\n\t\tappSecret,\n\t\tapiVersion,\n\t\tbaseUrl: `https://graph.facebook.com/${apiVersion}`,\n\t};\n}\n\nexport function createMetaAppSecretProof(\n\taccessToken: string,\n\tappSecret: string,\n): string {\n\treturn createHmac(\"sha256\", appSecret).update(accessToken).digest(\"hex\");\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAE3B,SAAS,WAAW,MAAiD;AACpE,QAAM,QAAQ,QAAQ,IAAI,IAAI,GAAG,KAAK;AACtC,MAAI,CAAC,OAAO;AACX,UAAM,IAAI,MAAM,0CAA0C,IAAI,EAAE;AAAA,EACjE;AAEA,SAAO;AACR;AASO,SAAS,gBAA4B;AAC3C,QAAM,QAAQ,WAAW,aAAa;AACtC,QAAM,YAAY,WAAW,iBAAiB;AAC9C,QAAM,aAAa,QAAQ,IAAI,kBAAkB,KAAK,KAAK;AAE3D,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,8BAA8B,UAAU;AAAA,EAClD;AACD;AAEO,SAAS,yBACf,aACA,WACS;AACT,SAAO,WAAW,UAAU,SAAS,EAAE,OAAO,WAAW,EAAE,OAAO,KAAK;AACxE;",
   "names": []
 }

package/dist/src/meta/__tests__/meta-utils.test.js

@@ -0,0 +1,155 @@
+import { describe, expect, it } from "vitest";
+import {
+  aggregateInsightsByCurrency,
+  getActionValue,
+  getMetaAdAccountStatusLabel,
+  getMetricBundle,
+  normalizeMetaAdAccountId,
+  normalizeRequestedAccountIds,
+  parseNumber,
+  resolveRequestedAccounts,
+  round,
+  toActId,
+  toPercent
+} from "../meta-utils.js";
+describe("meta utils", () => {
+  it("normalizes Meta ad account ids and rejects invalid values", () => {
+    expect(normalizeMetaAdAccountId(" act_12345 ")).toBe("12345");
+    expect(toActId("12345")).toBe("act_12345");
+    expect(() => normalizeMetaAdAccountId("act_12A")).toThrow(
+      "Invalid Meta ad account ID. Use digits only, with or without the act_ prefix."
+    );
+  });
+  it("parses numbers, rounds values and guards percent math", () => {
+    expect(parseNumber("12.45")).toBe(12.45);
+    expect(parseNumber("nope")).toBe(0);
+    expect(parseNumber(void 0)).toBe(0);
+    expect(round(12.345)).toBe(12.35);
+    expect(round(Number.POSITIVE_INFINITY)).toBe(0);
+    expect(toPercent(4, 8)).toBe(50);
+    expect(toPercent(4, 0)).toBe(0);
+  });
+  it("extracts action values and builds metric bundles with ROAS fallback", () => {
+    expect(
+      getActionValue(
+        [
+          { action_type: "purchase", value: "3" },
+          { action_type: "lead", value: "7" }
+        ],
+        "purchase"
+      )
+    ).toBe(3);
+    expect(
+      getMetricBundle({
+        spend: "25.125",
+        impressions: "1000",
+        clicks: "40",
+        reach: "700",
+        ctr: "4",
+        cpc: "0.628125",
+        cpm: "25.125",
+        actions: [{ action_type: "purchase", value: "2" }],
+        purchase_roas: [{ action_type: "omni_purchase", value: "3" }]
+      })
+    ).toEqual({
+      spend: 25.13,
+      impressions: 1e3,
+      clicks: 40,
+      reach: 700,
+      purchases: 2,
+      purchase_value: 75.38,
+      ctr_percent: 4,
+      cpc: 0.63,
+      cpm: 25.13,
+      roas: 3,
+      conversion_rate_percent: 5
+    });
+  });
+  it("aggregates insights by currency without unsafe cross-currency totals", () => {
+    expect(
+      aggregateInsightsByCurrency([
+        {
+          currencyCode: "ARS",
+          insight: {
+            spend: "10",
+            impressions: "100",
+            clicks: "5",
+            reach: "80",
+            actions: [{ action_type: "purchase", value: "1" }],
+            action_values: [{ action_type: "purchase", value: "20" }]
+          }
+        },
+        {
+          currencyCode: "ARS",
+          insight: {
+            spend: "15.5",
+            impressions: "150",
+            clicks: "10",
+            reach: "120",
+            actions: [{ action_type: "purchase", value: "2" }],
+            action_values: [{ action_type: "purchase", value: "40" }]
+          }
+        },
+        {
+          currencyCode: "USD",
+          insight: {
+            spend: "5",
+            impressions: "50",
+            clicks: "1",
+            reach: "45",
+            actions: [{ action_type: "purchase", value: "0" }],
+            action_values: [{ action_type: "purchase", value: "0" }]
+          }
+        }
+      ])
+    ).toEqual([
+      {
+        currency_code: "ARS",
+        spend: 25.5,
+        purchases: 3,
+        purchase_value: 60,
+        impressions: 250,
+        clicks: 15,
+        reach: 200,
+        ctr_percent: 6,
+        cpc: 1.7,
+        cpm: 102,
+        roas: 2.35
+      },
+      {
+        currency_code: "USD",
+        spend: 5,
+        purchases: 0,
+        purchase_value: 0,
+        impressions: 50,
+        clicks: 1,
+        reach: 45,
+        ctr_percent: 2,
+        cpc: 5,
+        cpm: 100,
+        roas: 0
+      }
+    ]);
+  });
+  it("normalizes requested ids, resolves accessible accounts and exposes status labels", () => {
+    expect(normalizeRequestedAccountIds(["act_123", "123", " 456 "])).toEqual([
+      "123",
+      "456"
+    ]);
+    expect(normalizeRequestedAccountIds([])).toBeUndefined();
+    expect(getMetaAdAccountStatusLabel(1)).toBe("active");
+    expect(getMetaAdAccountStatusLabel(9)).toBeUndefined();
+    const accessibleAccounts = [
+      { id: "act_123", account_id: "123", name: "Main" },
+      { id: "act_456", account_id: "456", name: "Secondary" }
+    ];
+    expect(resolveRequestedAccounts(void 0, accessibleAccounts)).toEqual(accessibleAccounts);
+    expect(resolveRequestedAccounts(["456"], accessibleAccounts)).toEqual([
+      { id: "act_456", account_id: "456", name: "Secondary" }
+    ]);
+    expect(() => resolveRequestedAccounts(["999"], accessibleAccounts)).toThrow(
+      "None of the requested Meta ad accounts are accessible with the configured token."
+    );
+  });
+});
+//# sourceMappingURL=meta-utils.test.js.map

package/dist/src/meta/__tests__/meta-utils.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/meta/__tests__/meta-utils.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from \"vitest\";\n\nimport {\n  aggregateInsightsByCurrency,\n  getActionValue,\n  getMetaAdAccountStatusLabel,\n  getMetricBundle,\n  normalizeMetaAdAccountId,\n  normalizeRequestedAccountIds,\n  parseNumber,\n  resolveRequestedAccounts,\n  round,\n  toActId,\n  toPercent,\n} from \"../meta-utils.js\";\n\ndescribe(\"meta utils\", () => {\n  it(\"normalizes Meta ad account ids and rejects invalid values\", () => {\n    expect(normalizeMetaAdAccountId(\" act_12345 \")).toBe(\"12345\");\n    expect(toActId(\"12345\")).toBe(\"act_12345\");\n    expect(() => normalizeMetaAdAccountId(\"act_12A\")).toThrow(\n      \"Invalid Meta ad account ID. Use digits only, with or without the act_ prefix.\"\n    );\n  });\n\n  it(\"parses numbers, rounds values and guards percent math\", () => {\n    expect(parseNumber(\"12.45\")).toBe(12.45);\n    expect(parseNumber(\"nope\")).toBe(0);\n    expect(parseNumber(undefined)).toBe(0);\n    expect(round(12.345)).toBe(12.35);\n    expect(round(Number.POSITIVE_INFINITY)).toBe(0);\n    expect(toPercent(4, 8)).toBe(50);\n    expect(toPercent(4, 0)).toBe(0);\n  });\n\n  it(\"extracts action values and builds metric bundles with ROAS fallback\", () => {\n    expect(\n      getActionValue(\n        [\n          { action_type: \"purchase\", value: \"3\" },\n          { action_type: \"lead\", value: \"7\" },\n        ],\n        \"purchase\"\n      )\n    ).toBe(3);\n\n    expect(\n      getMetricBundle({\n        spend: \"25.125\",\n        impressions: \"1000\",\n        clicks: \"40\",\n        reach: \"700\",\n        ctr: \"4\",\n        cpc: \"0.628125\",\n        cpm: \"25.125\",\n        actions: [{ action_type: \"purchase\", value: \"2\" }],\n        purchase_roas: [{ action_type: \"omni_purchase\", value: \"3\" }],\n      })\n    ).toEqual({\n      spend: 25.13,\n      impressions: 1000,\n      clicks: 40,\n      reach: 700,\n      purchases: 2,\n      purchase_value: 75.38,\n      ctr_percent: 4,\n      cpc: 0.63,\n      cpm: 25.13,\n      roas: 3,\n      conversion_rate_percent: 5,\n    });\n  });\n\n  it(\"aggregates insights by currency without unsafe cross-currency totals\", () => {\n    expect(\n      aggregateInsightsByCurrency([\n        {\n          currencyCode: \"ARS\",\n          insight: {\n            spend: \"10\",\n            impressions: \"100\",\n            clicks: \"5\",\n            reach: \"80\",\n            actions: [{ action_type: \"purchase\", value: \"1\" }],\n            action_values: [{ action_type: \"purchase\", value: \"20\" }],\n          },\n        },\n        {\n          currencyCode: \"ARS\",\n          insight: {\n            spend: \"15.5\",\n            impressions: \"150\",\n            clicks: \"10\",\n            reach: \"120\",\n            actions: [{ action_type: \"purchase\", value: \"2\" }],\n            action_values: [{ action_type: \"purchase\", value: \"40\" }],\n          },\n        },\n        {\n          currencyCode: \"USD\",\n          insight: {\n            spend: \"5\",\n            impressions: \"50\",\n            clicks: \"1\",\n            reach: \"45\",\n            actions: [{ action_type: \"purchase\", value: \"0\" }],\n            action_values: [{ action_type: \"purchase\", value: \"0\" }],\n          },\n        },\n      ])\n    ).toEqual([\n      {\n        currency_code: \"ARS\",\n        spend: 25.5,\n        purchases: 3,\n        purchase_value: 60,\n        impressions: 250,\n        clicks: 15,\n        reach: 200,\n        ctr_percent: 6,\n        cpc: 1.7,\n        cpm: 102,\n        roas: 2.35,\n      },\n      {\n        currency_code: \"USD\",\n        spend: 5,\n        purchases: 0,\n        purchase_value: 0,\n        impressions: 50,\n        clicks: 1,\n        reach: 45,\n        ctr_percent: 2,\n        cpc: 5,\n        cpm: 100,\n        roas: 0,\n      },\n    ]);\n  });\n\n  it(\"normalizes requested ids, resolves accessible accounts and exposes status labels\", () => {\n    expect(normalizeRequestedAccountIds([\"act_123\", \"123\", \" 456 \"])).toEqual([\n      \"123\",\n      \"456\",\n    ]);\n    expect(normalizeRequestedAccountIds([])).toBeUndefined();\n    expect(getMetaAdAccountStatusLabel(1)).toBe(\"active\");\n    expect(getMetaAdAccountStatusLabel(9)).toBeUndefined();\n\n    const accessibleAccounts = [\n      { id: \"act_123\", account_id: \"123\", name: \"Main\" },\n      { id: \"act_456\", account_id: \"456\", name: \"Secondary\" },\n    ];\n\n    expect(resolveRequestedAccounts(undefined, accessibleAccounts)).toEqual(accessibleAccounts);\n    expect(resolveRequestedAccounts([\"456\"], accessibleAccounts)).toEqual([\n      { id: \"act_456\", account_id: \"456\", name: \"Secondary\" },\n    ]);\n    expect(() => resolveRequestedAccounts([\"999\"], accessibleAccounts)).toThrow(\n      \"None of the requested Meta ad accounts are accessible with the configured token.\"\n    );\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,265 @@
+import axios from "axios";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getMercadoLibreAccessForProfile } from "../../../config/mercadolibre.js";
+import {
+  createMercadoLibreClient,
+  formatMercadoLibreError,
+  getMercadoLibreApiContext,
+  getMercadoLibreUsersMe,
+  isRetryableMercadoLibreError,
+  MercadoLibreApiError,
+  buildMercadoLibrePaginationMetadata,
+  normalizeMercadoLibrePaging,
+  parseMercadoLibreMultiget,
+  runMercadoLibreBatch,
+  sanitizeMercadoLibreText
+} from "../mercadolibre-api.js";
+vi.mock("../../../config/mercadolibre.js", () => ({
+  getMercadoLibreAccessForProfile: vi.fn()
+}));
+describe("mercadolibre-api foundations", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+  });
+  it("redacts sensitive tokens from MercadoLibre errors", () => {
+    const sanitized = sanitizeMercadoLibreText(
+      "Bearer abc.def access_token=secret refresh_token=refresh client_secret=topsecret code=oauth"
+    );
+    expect(sanitized).toContain("Bearer [redacted]");
+    expect(sanitized).toContain("access_token=[redacted]");
+    expect(sanitized).toContain("refresh_token=[redacted]");
+    expect(sanitized).toContain("client_secret=[redacted]");
+    expect(sanitized).toContain("code=[redacted]");
+  });
+  it("normalizes paging values and builds continuation metadata", () => {
+    const paging = normalizeMercadoLibrePaging({ total: 25, limit: "10", offset: -4 });
+    const metadata = buildMercadoLibrePaginationMetadata({
+      total: paging.total,
+      limit: paging.limit,
+      offset: paging.offset,
+      returned: 10,
+      nextField: "offset"
+    });
+    expect(paging).toEqual({ total: 25, limit: 10, offset: 0 });
+    expect(metadata).toEqual({
+      total: 25,
+      limit: 10,
+      offset: 0,
+      returned: 10,
+      has_more: true,
+      continuation: "Reenviar la misma tool con offset=10 para continuar."
+    });
+  });
+  it("normalizes invalid paging values and reports finished pagination when no more pages exist", () => {
+    const paging = normalizeMercadoLibrePaging({ total: "oops", limit: void 0, offset: Number.NaN });
+    const metadata = buildMercadoLibrePaginationMetadata({
+      total: 2,
+      limit: 0,
+      offset: 0,
+      returned: 2,
+      nextField: "scroll_id"
+    });
+    expect(paging).toEqual({ total: 0, limit: 0, offset: 0 });
+    expect(metadata).toEqual({
+      total: 2,
+      limit: 2,
+      offset: 0,
+      returned: 2,
+      has_more: false,
+      continuation: "No more pages for this query."
+    });
+  });
+  it("filters multiget responses to successful bodies only", async () => {
+    const result = await parseMercadoLibreMultiget({
+      data: [
+        { code: 200, body: { id: "MLA1" } },
+        { code: 404, body: { id: "MLA2" } },
+        { code: 204 },
+        { code: 201, body: { id: "MLA3" } }
+      ]
+    });
+    expect(result).toEqual([{ id: "MLA1" }, { id: "MLA3" }]);
+  });
+  it("returns an empty multiget payload when no successful bodies are present", async () => {
+    const result = await parseMercadoLibreMultiget({
+      data: [{ code: 404, body: { id: "missing" } }, { code: 204 }, { code: 200 }]
+    });
+    expect(result).toEqual([]);
+  });
+  it("retries retryable batch failures and keeps ordering stable", async () => {
+    vi.useFakeTimers();
+    vi.spyOn(Math, "random").mockReturnValue(0);
+    const fetcher = vi.fn().mockImplementationOnce(async () => {
+      throw new MercadoLibreApiError("rate limited", 429);
+    }).mockResolvedValueOnce({ id: "one", recovered: true }).mockResolvedValueOnce({ id: "two" });
+    const promise = runMercadoLibreBatch(["one", "two"], fetcher, {
+      maxConcurrency: 1,
+      maxRetries: 1,
+      baseRetryDelayMs: 50
+    });
+    await vi.advanceTimersByTimeAsync(50);
+    await expect(promise).resolves.toEqual({
+      successful: [
+        { id: "one", document: { id: "one", recovered: true } },
+        { id: "two", document: { id: "two" } }
+      ],
+      failed: []
+    });
+    expect(fetcher).toHaveBeenCalledTimes(3);
+  });
+  it("honors retry-after headers for retryable failures", async () => {
+    vi.useFakeTimers();
+    const fetcher = vi.fn().mockImplementationOnce(async () => {
+      throw new MercadoLibreApiError("wait", 429, void 0, 120);
+    }).mockResolvedValueOnce({ id: "one" });
+    const promise = runMercadoLibreBatch(["one"], fetcher, {
+      maxRetries: 1,
+      baseRetryDelayMs: 50
+    });
+    await vi.advanceTimersByTimeAsync(119);
+    expect(fetcher).toHaveBeenCalledTimes(1);
+    await vi.advanceTimersByTimeAsync(1);
+    await expect(promise).resolves.toEqual({
+      successful: [{ id: "one", document: { id: "one" } }],
+      failed: []
+    });
+  });
+  it("classifies non-retryable batch failures with a safe message", async () => {
+    const result = await runMercadoLibreBatch(
+      ["broken"],
+      async () => {
+        throw new Error("refresh_token=secret exploded");
+      },
+      { maxRetries: 2 }
+    );
+    expect(result).toEqual({
+      successful: [],
+      failed: [
+        {
+          id: "broken",
+          message: "refresh_token=[redacted] exploded",
+          statusCode: void 0,
+          attempts: 1,
+          retryable: false
+        }
+      ]
+    });
+  });
+  it("treats unknown rejected batch reasons as a single failed attempt", async () => {
+    const fetcher = vi.fn(async () => {
+      throw "Bearer abc123";
+    });
+    const result = await runMercadoLibreBatch(["broken"], fetcher, { maxRetries: 0 });
+    expect(result).toEqual({
+      successful: [],
+      failed: [
+        {
+          id: "broken",
+          message: "Failed to fetch MercadoLibre resource broken",
+          statusCode: void 0,
+          attempts: 1,
+          retryable: false
+        }
+      ]
+    });
+  });
+  it("returns an empty batch result when no ids are provided", async () => {
+    const fetcher = vi.fn();
+    await expect(runMercadoLibreBatch([], fetcher)).resolves.toEqual({
+      successful: [],
+      failed: []
+    });
+    expect(fetcher).not.toHaveBeenCalled();
+  });
+  it("formats axios errors with sanitized response details", () => {
+    const error = {
+      isAxiosError: true,
+      message: "Request failed with status code 400",
+      response: {
+        status: 400,
+        data: {
+          error: "bad_request",
+          cause: [{ message: "refresh_token=top-secret" }]
+        },
+        headers: {}
+      }
+    };
+    expect(formatMercadoLibreError(error)).toBe(
+      "MercadoLibre API request failed (400): refresh_token=[redacted]"
+    );
+  });
+  it("creates a client with auth headers and converts axios failures into MercadoLibreApiError", async () => {
+    const responseUse = vi.fn();
+    const client = {
+      interceptors: { response: { use: responseUse } }
+    };
+    vi.spyOn(axios, "create").mockReturnValue(client);
+    const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => void 0);
+    createMercadoLibreClient("access-token");
+    expect(axios.create).toHaveBeenCalledWith({
+      baseURL: "https://api.mercadolibre.com",
+      timeout: 3e4,
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: "Bearer access-token"
+      }
+    });
+    const rejectHandler = responseUse.mock.calls[0]?.[1];
+    const retryAt = new Date(Date.now() + 5e3).toUTCString();
+    await expect(
+      rejectHandler({
+        isAxiosError: true,
+        message: "boom",
+        config: { method: "get", url: "/orders/search" },
+        response: {
+          status: 429,
+          headers: { "retry-after": retryAt },
+          data: { error: "rate_limit", message: "access_token=secret" }
+        }
+      })
+    ).rejects.toMatchObject({
+      name: "MercadoLibreApiError",
+      status: 429,
+      code: "rate_limit",
+      message: "MercadoLibre API request failed (429): access_token=[redacted]",
+      retryAfterMs: expect.any(Number)
+    });
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "[MERCADOLIBRE API ERROR] GET /orders/search -> 429"
+    );
+  });
+  it("builds api context from the persisted profile access and exposes /users/me", async () => {
+    const getMock = vi.fn().mockResolvedValue({ data: { id: 123, nickname: "seller" } });
+    const client = {
+      get: getMock,
+      interceptors: { response: { use: vi.fn() } }
+    };
+    vi.mocked(getMercadoLibreAccessForProfile).mockResolvedValue({
+      sellerId: "seller-1",
+      accessToken: "stored-token",
+      refreshToken: "refresh"
+    });
+    vi.spyOn(axios, "create").mockReturnValue(client);
+    const context = await getMercadoLibreApiContext("profile-1");
+    const me = await getMercadoLibreUsersMe("profile-1");
+    expect(context).toMatchObject({
+      sellerId: "seller-1",
+      accessToken: "stored-token",
+      refreshToken: "refresh",
+      api: client
+    });
+    expect(getMock).toHaveBeenCalledWith("/users/me");
+    expect(me).toEqual({ id: 123, nickname: "seller" });
+  });
+  it("detects retryable MercadoLibre errors including missing status codes", () => {
+    expect(isRetryableMercadoLibreError(new MercadoLibreApiError("network"))).toBe(true);
+    expect(isRetryableMercadoLibreError(new MercadoLibreApiError("forbidden", 403))).toBe(false);
+    expect(isRetryableMercadoLibreError(new Error("plain"))).toBe(false);
+  });
+});
+//# sourceMappingURL=mercadolibre-api.test.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/mercadolibre/__tests__/mercadolibre-api.test.ts"],
+  "sourcesContent": ["import axios, { AxiosError } from \"axios\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { getMercadoLibreAccessForProfile } from \"../../../config/mercadolibre.js\";\nimport {\n  createMercadoLibreClient,\n  formatMercadoLibreError,\n  getMercadoLibreApiContext,\n  getMercadoLibreUsersMe,\n  isRetryableMercadoLibreError,\n  MercadoLibreApiError,\n  buildMercadoLibrePaginationMetadata,\n  normalizeMercadoLibrePaging,\n  parseMercadoLibreMultiget,\n  runMercadoLibreBatch,\n  sanitizeMercadoLibreText,\n} from \"../mercadolibre-api.js\";\n\nvi.mock(\"../../../config/mercadolibre.js\", () => ({\n  getMercadoLibreAccessForProfile: vi.fn(),\n}));\n\ndescribe(\"mercadolibre-api foundations\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  afterEach(() => {\n    vi.useRealTimers();\n    vi.restoreAllMocks();\n  });\n\n  it(\"redacts sensitive tokens from MercadoLibre errors\", () => {\n    const sanitized = sanitizeMercadoLibreText(\n      \"Bearer abc.def access_token=secret refresh_token=refresh client_secret=topsecret code=oauth\"\n    );\n\n    expect(sanitized).toContain(\"Bearer [redacted]\");\n    expect(sanitized).toContain(\"access_token=[redacted]\");\n    expect(sanitized).toContain(\"refresh_token=[redacted]\");\n    expect(sanitized).toContain(\"client_secret=[redacted]\");\n    expect(sanitized).toContain(\"code=[redacted]\");\n  });\n\n  it(\"normalizes paging values and builds continuation metadata\", () => {\n    const paging = normalizeMercadoLibrePaging({ total: 25, limit: \"10\", offset: -4 });\n    const metadata = buildMercadoLibrePaginationMetadata({\n      total: paging.total,\n      limit: paging.limit,\n      offset: paging.offset,\n      returned: 10,\n      nextField: \"offset\",\n    });\n\n    expect(paging).toEqual({ total: 25, limit: 10, offset: 0 });\n    expect(metadata).toEqual({\n      total: 25,\n      limit: 10,\n      offset: 0,\n      returned: 10,\n      has_more: true,\n      continuation: \"Reenviar la misma tool con offset=10 para continuar.\",\n    });\n  });\n\n  it(\"normalizes invalid paging values and reports finished pagination when no more pages exist\", () => {\n    const paging = normalizeMercadoLibrePaging({ total: \"oops\", limit: undefined, offset: Number.NaN });\n    const metadata = buildMercadoLibrePaginationMetadata({\n      total: 2,\n      limit: 0,\n      offset: 0,\n      returned: 2,\n      nextField: \"scroll_id\",\n    });\n\n    expect(paging).toEqual({ total: 0, limit: 0, offset: 0 });\n    expect(metadata).toEqual({\n      total: 2,\n      limit: 2,\n      offset: 0,\n      returned: 2,\n      has_more: false,\n      continuation: \"No more pages for this query.\",\n    });\n  });\n\n  it(\"filters multiget responses to successful bodies only\", async () => {\n    const result = await parseMercadoLibreMultiget({\n      data: [\n        { code: 200, body: { id: \"MLA1\" } },\n        { code: 404, body: { id: \"MLA2\" } },\n        { code: 204 },\n        { code: 201, body: { id: \"MLA3\" } },\n      ],\n    } as never);\n\n    expect(result).toEqual([{ id: \"MLA1\" }, { id: \"MLA3\" }]);\n  });\n\n  it(\"returns an empty multiget payload when no successful bodies are present\", async () => {\n    const result = await parseMercadoLibreMultiget({\n      data: [{ code: 404, body: { id: \"missing\" } }, { code: 204 }, { code: 200 }],\n    } as never);\n\n    expect(result).toEqual([]);\n  });\n\n  it(\"retries retryable batch failures and keeps ordering stable\", async () => {\n    vi.useFakeTimers();\n    vi.spyOn(Math, \"random\").mockReturnValue(0);\n\n    const fetcher = vi\n      .fn<(id: string) => Promise<{ id: string; recovered?: boolean }>>()\n      .mockImplementationOnce(async () => {\n        throw new MercadoLibreApiError(\"rate limited\", 429);\n      })\n      .mockResolvedValueOnce({ id: \"one\", recovered: true })\n      .mockResolvedValueOnce({ id: \"two\" });\n\n    const promise = runMercadoLibreBatch([\"one\", \"two\"], fetcher, {\n      maxConcurrency: 1,\n      maxRetries: 1,\n      baseRetryDelayMs: 50,\n    });\n\n    await vi.advanceTimersByTimeAsync(50);\n\n    await expect(promise).resolves.toEqual({\n      successful: [\n        { id: \"one\", document: { id: \"one\", recovered: true } },\n        { id: \"two\", document: { id: \"two\" } },\n      ],\n      failed: [],\n    });\n    expect(fetcher).toHaveBeenCalledTimes(3);\n  });\n\n  it(\"honors retry-after headers for retryable failures\", async () => {\n    vi.useFakeTimers();\n\n    const fetcher = vi\n      .fn<(id: string) => Promise<{ id: string }>>()\n      .mockImplementationOnce(async () => {\n        throw new MercadoLibreApiError(\"wait\", 429, undefined, 120);\n      })\n      .mockResolvedValueOnce({ id: \"one\" });\n\n    const promise = runMercadoLibreBatch([\"one\"], fetcher, {\n      maxRetries: 1,\n      baseRetryDelayMs: 50,\n    });\n\n    await vi.advanceTimersByTimeAsync(119);\n    expect(fetcher).toHaveBeenCalledTimes(1);\n\n    await vi.advanceTimersByTimeAsync(1);\n\n    await expect(promise).resolves.toEqual({\n      successful: [{ id: \"one\", document: { id: \"one\" } }],\n      failed: [],\n    });\n  });\n\n  it(\"classifies non-retryable batch failures with a safe message\", async () => {\n    const result = await runMercadoLibreBatch(\n      [\"broken\"],\n      async () => {\n        throw new Error(\"refresh_token=secret exploded\");\n      },\n      { maxRetries: 2 }\n    );\n\n    expect(result).toEqual({\n      successful: [],\n      failed: [\n        {\n          id: \"broken\",\n          message: \"refresh_token=[redacted] exploded\",\n          statusCode: undefined,\n          attempts: 1,\n          retryable: false,\n        },\n      ],\n    });\n  });\n\n  it(\"treats unknown rejected batch reasons as a single failed attempt\", async () => {\n    const fetcher = vi.fn(async () => {\n      throw \"Bearer abc123\";\n    });\n\n    const result = await runMercadoLibreBatch([\"broken\"], fetcher, { maxRetries: 0 });\n\n    expect(result).toEqual({\n      successful: [],\n      failed: [\n        {\n          id: \"broken\",\n          message: \"Failed to fetch MercadoLibre resource broken\",\n          statusCode: undefined,\n          attempts: 1,\n          retryable: false,\n        },\n      ],\n    });\n  });\n\n  it(\"returns an empty batch result when no ids are provided\", async () => {\n    const fetcher = vi.fn();\n\n    await expect(runMercadoLibreBatch([], fetcher)).resolves.toEqual({\n      successful: [],\n      failed: [],\n    });\n    expect(fetcher).not.toHaveBeenCalled();\n  });\n\n  it(\"formats axios errors with sanitized response details\", () => {\n    const error = {\n      isAxiosError: true,\n      message: \"Request failed with status code 400\",\n      response: {\n        status: 400,\n        data: {\n          error: \"bad_request\",\n          cause: [{ message: \"refresh_token=top-secret\" }],\n        },\n        headers: {},\n      },\n    } as AxiosError;\n\n    expect(formatMercadoLibreError(error)).toBe(\n      \"MercadoLibre API request failed (400): refresh_token=[redacted]\"\n    );\n  });\n\n  it(\"creates a client with auth headers and converts axios failures into MercadoLibreApiError\", async () => {\n    const responseUse = vi.fn();\n    const client = {\n      interceptors: { response: { use: responseUse } },\n    };\n    vi.spyOn(axios, \"create\").mockReturnValue(client as never);\n    const consoleSpy = vi.spyOn(console, \"error\").mockImplementation(() => undefined);\n\n    createMercadoLibreClient(\"access-token\");\n\n    expect(axios.create).toHaveBeenCalledWith({\n      baseURL: \"https://api.mercadolibre.com\",\n      timeout: 30000,\n      headers: {\n        Accept: \"application/json\",\n        \"Content-Type\": \"application/json\",\n        Authorization: \"Bearer access-token\",\n      },\n    });\n\n    const rejectHandler = responseUse.mock.calls[0]?.[1] as (error: AxiosError) => Promise<never>;\n    const retryAt = new Date(Date.now() + 5000).toUTCString();\n\n    await expect(\n      rejectHandler({\n        isAxiosError: true,\n        message: \"boom\",\n        config: { method: \"get\", url: \"/orders/search\" },\n        response: {\n          status: 429,\n          headers: { \"retry-after\": retryAt },\n          data: { error: \"rate_limit\", message: \"access_token=secret\" },\n        },\n      } as unknown as AxiosError)\n    ).rejects.toMatchObject({\n      name: \"MercadoLibreApiError\",\n      status: 429,\n      code: \"rate_limit\",\n      message: \"MercadoLibre API request failed (429): access_token=[redacted]\",\n      retryAfterMs: expect.any(Number),\n    });\n\n    expect(consoleSpy).toHaveBeenCalledWith(\n      \"[MERCADOLIBRE API ERROR] GET /orders/search -> 429\"\n    );\n  });\n\n  it(\"builds api context from the persisted profile access and exposes /users/me\", async () => {\n    const getMock = vi.fn().mockResolvedValue({ data: { id: 123, nickname: \"seller\" } });\n    const client = {\n      get: getMock,\n      interceptors: { response: { use: vi.fn() } },\n    };\n\n    vi.mocked(getMercadoLibreAccessForProfile).mockResolvedValue({\n      sellerId: \"seller-1\",\n      accessToken: \"stored-token\",\n      refreshToken: \"refresh\",\n    } as never);\n    vi.spyOn(axios, \"create\").mockReturnValue(client as never);\n\n    const context = await getMercadoLibreApiContext(\"profile-1\");\n    const me = await getMercadoLibreUsersMe(\"profile-1\");\n\n    expect(context).toMatchObject({\n      sellerId: \"seller-1\",\n      accessToken: \"stored-token\",\n      refreshToken: \"refresh\",\n      api: client,\n    });\n    expect(getMock).toHaveBeenCalledWith(\"/users/me\");\n    expect(me).toEqual({ id: 123, nickname: \"seller\" });\n  });\n\n  it(\"detects retryable MercadoLibre errors including missing status codes\", () => {\n    expect(isRetryableMercadoLibreError(new MercadoLibreApiError(\"network\"))).toBe(true);\n    expect(isRetryableMercadoLibreError(new MercadoLibreApiError(\"forbidden\", 403))).toBe(false);\n    expect(isRetryableMercadoLibreError(new Error(\"plain\"))).toBe(false);\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}