@synterai/sdk-js 0.1.1 → 0.1.2

package/README.md

@@ -1,12 +1,12 @@
 # @synterai/sdk-js
 
-TypeScript SDK for the [Synter](https://syntermedia.ai) advertising API — manage campaigns across Google Ads, Meta, LinkedIn, Microsoft Ads, Reddit, TikTok, and X from your own code, with full types and IDE autocomplete.
+TypeScript SDK for the [Synter](https://syntermedia.ai) advertising API — manage campaigns across 27 ad platforms (Google Ads, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, Amazon DSP, Amazon Ads, Pinterest, Snap, Spotify, OpenAI Ads, The Trade Desk, FreeWheel, DV360, CM360, Walmart Connect, Instacart Ads, Target Roundel, Criteo) from your own code, with full types and IDE autocomplete.
 
-> **`0.1.0` — early release.** Live on npm and installable, but pre-1.0: the surface may change before a stable `1.0`. Pin a version in production.
+> **`0.1.2` — live on npm.** Pre-1.0: the surface may change before a stable `1.0`. Pin a version in production. `0.1.2` fixes `analytics.getPerformance({ platform: "google" | "linkedin" })`, which in `0.1.0`/`0.1.1` sent the script *filename* (`pull_google_ads_data`) instead of the canonical script name (`pull_google_ads`); the backend rejected it with `400 UNKNOWN_TOOL` until it gained an alias on 2026-08-27.
 
 ## What this actually talks to
 
-Every method in this SDK calls the same live, production endpoint that powers Synter's MCP server (`@synterai/mcp-server`) and the `synter` CLI: `POST https://syntermedia.ai/api/v1/tools/run`. There is no separate "SDK backend" — if a method works here, it works because the exact same call already works for every MCP client (Claude, Cursor, Codex, ChatGPT) today.
+Every method in this SDK calls the same live, production endpoint that powers Synter's MCP server (`@synterai/mcp-server`) and the `synter` CLI: `POST https://syntermedia.ai/api/v1/tools/run`. There is no separate "SDK backend" — if a method works here, it works because the exact same call already works for every MCP client (Claude, Cursor, Codex, Devin, ChatGPT) today.
 
 See [`../sdk-shared/SPEC.md`](../sdk-shared/SPEC.md) and [`../sdk-shared/catalog.json`](../sdk-shared/catalog.json) for the full transport contract this SDK — and every sibling-language SDK — implements.
 
@@ -18,7 +18,7 @@ npm install @synterai/sdk-js
 
 ## Authentication
 
-Get an API key at [syntermedia.ai/developer](https://syntermedia.ai/developer). Keys look like `syn_` followed by 32 base64url characters.
+Get an API key at [syntermedia.ai/developer](https://syntermedia.ai/developer). Keys look like `syn_` followed by 32 base64url characters. Keys issued from a sandbox workspace use the `syn_test_` prefix instead and only work against that sandbox — no live ad-account risk.
 
 > **⚠️ Server-side only.** Your `SYNTER_API_KEY` is a secret that can spend money and modify your ad accounts. Use this SDK from a **backend** — a Node service, a Next.js API route or Server Action, an edge/serverless function. **Never** instantiate `Synter` in client-side code (React components, browser bundles, mobile apps); the key would ship to every visitor. For a React/SPA frontend, call your own backend, and have the backend call Synter.
 

package/dist/index.d.mts

@@ -161,9 +161,7 @@ declare class CampaignsResource {
  * Both are custom-dispatch per SPEC.md's testing bar (not forced through
  * the generic argMapping-only path): get_performance has a platform-scoped
  * `onlyForPlatform` flag and a `dateRangeToDays` transform; get_daily_spend
- * has a fixed script name but still resolves/sends a platform, and (unlike
- * any other tool) also re-emits that resolved platform as an uppercased
- * CLI flag.
+ * uses the same platform-routed pull scripts with `--days` (default 7).
  */
 
 interface GetPerformanceInput {

package/dist/index.d.ts

@@ -161,9 +161,7 @@ declare class CampaignsResource {
  * Both are custom-dispatch per SPEC.md's testing bar (not forced through
  * the generic argMapping-only path): get_performance has a platform-scoped
  * `onlyForPlatform` flag and a `dateRangeToDays` transform; get_daily_spend
- * has a fixed script name but still resolves/sends a platform, and (unlike
- * any other tool) also re-emits that resolved platform as an uppercased
- * CLI flag.
+ * uses the same platform-routed pull scripts with `--days` (default 7).
  */
 
 interface GetPerformanceInput {

package/dist/index.js

@@ -151,7 +151,7 @@ function flattenArgsToFlags(args) {
 
 // src/resources/campaigns.ts
 var LIST_CAMPAIGNS_SCRIPT_BY_PLATFORM = {
-  google: "google_ads_list_campaigns",
+  google: "google_ads_get_campaigns",
   meta: "meta_ads_list_campaigns",
   linkedin: "linkedin_ads_list_campaigns",
   microsoft: "microsoft_ads_list_campaigns",
@@ -279,9 +279,9 @@ var CampaignsResource = class {
 
 // src/resources/analytics.ts
 var GET_PERFORMANCE_SCRIPT_BY_PLATFORM = {
-  google: "pull_google_ads_data",
+  google: "pull_google_ads",
   meta: "pull_meta_ads",
-  linkedin: "pull_linkedin_ads_data",
+  linkedin: "pull_linkedin_ads",
   microsoft: "pull_microsoft_ads",
   reddit: "pull_reddit_ads",
   tiktok: "pull_tiktok_ads",
@@ -313,17 +313,22 @@ var AnalyticsResource = class {
       "google",
       input.platform
     );
-    const args = buildArgsFromMapping(GET_PERFORMANCE_ARG_MAPPING, input, platform);
+    const args = buildArgsFromMapping(
+      GET_PERFORMANCE_ARG_MAPPING,
+      { ...input, date_range: input.date_range ?? "LAST_7_DAYS" },
+      platform
+    );
     return this.client.runTool(scriptName, args, platform);
   }
   /** Get daily spend breakdown across all connected ad accounts. */
   async getDailySpend(input = {}) {
-    const platform = input.platform ?? "google";
-    const args = ["--platform", platform.toUpperCase()];
-    if (input.days !== void 0) {
-      args.push("--days", String(input.days));
-    }
-    return this.client.runTool("get_account_daily_spend", args, platform);
+    const { platform, scriptName } = resolvePlatformScriptName(
+      GET_PERFORMANCE_SCRIPT_BY_PLATFORM,
+      "google",
+      input.platform
+    );
+    const days = input.days ?? 7;
+    return this.client.runTool(scriptName, ["--days", String(days)], platform);
   }
 };
 
@@ -906,7 +911,7 @@ var Synter = class {
   // ---------------------------------------------------------------------
   /** List all connected ad accounts across platforms. */
   async listAdAccounts() {
-    return this.runTool("google_ads_list_customers", [], "google");
+    return this.runTool("google_ads_get_customers", [], "google");
   }
   /**
    * Upload an image as an asset for use in ads.

package/dist/index.mjs

@@ -98,7 +98,7 @@ function flattenArgsToFlags(args) {
 
 // src/resources/campaigns.ts
 var LIST_CAMPAIGNS_SCRIPT_BY_PLATFORM = {
-  google: "google_ads_list_campaigns",
+  google: "google_ads_get_campaigns",
   meta: "meta_ads_list_campaigns",
   linkedin: "linkedin_ads_list_campaigns",
   microsoft: "microsoft_ads_list_campaigns",
@@ -226,9 +226,9 @@ var CampaignsResource = class {
 
 // src/resources/analytics.ts
 var GET_PERFORMANCE_SCRIPT_BY_PLATFORM = {
-  google: "pull_google_ads_data",
+  google: "pull_google_ads",
   meta: "pull_meta_ads",
-  linkedin: "pull_linkedin_ads_data",
+  linkedin: "pull_linkedin_ads",
   microsoft: "pull_microsoft_ads",
   reddit: "pull_reddit_ads",
   tiktok: "pull_tiktok_ads",
@@ -260,17 +260,22 @@ var AnalyticsResource = class {
       "google",
       input.platform
     );
-    const args = buildArgsFromMapping(GET_PERFORMANCE_ARG_MAPPING, input, platform);
+    const args = buildArgsFromMapping(
+      GET_PERFORMANCE_ARG_MAPPING,
+      { ...input, date_range: input.date_range ?? "LAST_7_DAYS" },
+      platform
+    );
     return this.client.runTool(scriptName, args, platform);
   }
   /** Get daily spend breakdown across all connected ad accounts. */
   async getDailySpend(input = {}) {
-    const platform = input.platform ?? "google";
-    const args = ["--platform", platform.toUpperCase()];
-    if (input.days !== void 0) {
-      args.push("--days", String(input.days));
-    }
-    return this.client.runTool("get_account_daily_spend", args, platform);
+    const { platform, scriptName } = resolvePlatformScriptName(
+      GET_PERFORMANCE_SCRIPT_BY_PLATFORM,
+      "google",
+      input.platform
+    );
+    const days = input.days ?? 7;
+    return this.client.runTool(scriptName, ["--days", String(days)], platform);
   }
 };
 
@@ -853,7 +858,7 @@ var Synter = class {
   // ---------------------------------------------------------------------
   /** List all connected ad accounts across platforms. */
   async listAdAccounts() {
-    return this.runTool("google_ads_list_customers", [], "google");
+    return this.runTool("google_ads_get_customers", [], "google");
   }
   /**
    * Upload an image as an asset for use in ads.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synterai/sdk-js",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "TypeScript SDK for the Synter advertising API — manage campaigns across Google Ads, Meta, LinkedIn, Reddit, Microsoft, TikTok, and X",
   "main": "dist/index.js",
   "module": "dist/index.mjs",