adapty 0.8.4 → 0.8.5

package/dist/lib/output.js

@@ -3,10 +3,12 @@ function formatLabel(snakeKey) {
     return snakeKey
         .split('_')
         .map((w) => {
-        if (w === 'ids')
+        if (w === 'ids') {
             return 'IDs';
-        if (UPPER_WORDS.has(w))
+        }
+        if (UPPER_WORDS.has(w)) {
             return w.toUpperCase();
+        }
         return w.charAt(0).toUpperCase() + w.slice(1);
     })
         .join(' ');
@@ -18,19 +20,22 @@ function renderArrayItems(items, indent) {
     const childIndent = indent + '  ';
     const lines = [];
     for (const item of items) {
-        if (item === undefined || item === null)
+        if (item === undefined || item === null) {
             continue;
+        }
         if (Array.isArray(item)) {
             lines.push(...renderArrayItems(item, childIndent));
         }
         else if (isScalar(item)) {
+            // eslint-disable-next-line @typescript-eslint/no-base-to-string -- FIXME if you see this
             lines.push(`${indent}- ${String(item)}`);
         }
         else {
-            const rendered = renderObject(item, childIndent);
-            if (rendered.length === 0)
+            const [head, ...rest] = renderObject(item, childIndent);
+            if (head === undefined) {
                 continue;
-            lines.push(`${indent}- ${rendered[0].slice(childIndent.length)}`, ...rendered.slice(1));
+            }
+            lines.push(`${indent}- ${head.slice(childIndent.length)}`, ...rest);
         }
     }
     return lines;
@@ -38,13 +43,15 @@ function renderArrayItems(items, indent) {
 function renderObject(data, indent) {
     const lines = [];
     for (const [key, value] of Object.entries(data)) {
-        if (value === undefined || value === null)
+        if (value === undefined || value === null) {
             continue;
+        }
         const label = `${indent}${formatLabel(key)}:`;
         if (Array.isArray(value)) {
-            if (value.length === 0)
+            if (value.length === 0) {
                 continue;
-            if (value.every((v) => isScalar(v))) {
+            }
+            if (value.every(v => isScalar(v))) {
                 lines.push(`${label} ${value.map(String).join(', ')}`);
             }
             else {
@@ -52,25 +59,29 @@ function renderObject(data, indent) {
             }
         }
         else if (isScalar(value)) {
+            // eslint-disable-next-line @typescript-eslint/no-base-to-string -- FIXME if you see this
             lines.push(`${label} ${String(value)}`);
         }
         else {
             const nested = renderObject(value, indent + '  ');
-            if (nested.length > 0)
+            if (nested.length > 0) {
                 lines.push(label, ...nested);
+            }
         }
     }
     return lines;
 }
 export function printResponse(data, log) {
-    for (const line of renderObject(data, ''))
+    for (const line of renderObject(data, '')) {
         log(line);
+    }
 }
 export function printList(items, log, pagination) {
     for (const [i, item] of items.entries()) {
         printResponse(item, log);
-        if (i < items.length - 1)
+        if (i < items.length - 1) {
             log('---');
+        }
     }
     if (pagination) {
         log('');

package/dist/lib/preview.d.ts

@@ -5,10 +5,10 @@ export declare const DEFAULT_DEVICE_ID = "iphone-14";
 export declare const ORIENTATIONS: readonly ["landscape", "portrait"];
 export declare const DEFAULT_ORIENTATION = "portrait";
 /** Payload the render page expects. Wire format shared with the UI, hence camelCase. */
-export interface PreviewPayload {
+export type PreviewPayload = {
     flow: Record<string, unknown>;
     remoteConfigs: unknown[];
-}
+};
 /**
  * Accepts either a dashboard-api envelope (`{config, remote_configs, ...}`) or a bare
  * builder config, and returns the shape the render page injects.
@@ -18,10 +18,10 @@ export interface PreviewPayload {
  * rejected there instead — better to say so here, against the file the user named.
  */
 export declare function normalizePreviewConfig(raw: unknown): PreviewPayload;
-export interface RenderTarget {
+export type RenderTarget = {
     device: string;
     orientation: string;
     /** Omitted lets the render page fall back to the flow's first screen. */
-    screen?: string;
-}
+    screen?: string | undefined;
+};
 export declare function buildRenderUrl(target: RenderTarget, payload: PreviewPayload): string;

package/dist/lib/preview.js

@@ -39,8 +39,9 @@ function encodeConfigFragment(payload) {
 }
 export function buildRenderUrl(target, payload) {
     const url = appUrl(PREVIEW_PATH);
-    if (target.screen)
+    if (target.screen) {
         url.searchParams.set('screen', target.screen);
+    }
     url.searchParams.set('device', target.device);
     url.searchParams.set('orientation', target.orientation);
     url.hash = `config=${encodeConfigFragment(payload)}`;

package/oclif.manifest.json

@@ -425,36 +425,59 @@
         "update.js"
       ]
     },
-    "auth:login": {
+    "asa:connect": {
       "aliases": [],
       "args": {},
-      "description": "Authenticate with Adapty via browser",
+      "description": "Connect an Apple Search Ads account to this company",
       "examples": [
-        "<%= config.bin %> auth login"
+        "<%= config.bin %> asa connect",
+        "<%= config.bin %> asa connect --no-wait"
       ],
-      "flags": {},
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the browser step",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait until Apple Ads reports as connected",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:login",
+      "id": "asa:connect",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "login.js"
+        "asa",
+        "connect.js"
       ]
     },
-    "auth:logout": {
+    "asa:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Remove stored authentication token",
+      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
       "examples": [
-        "<%= config.bin %> auth logout"
+        "<%= config.bin %> asa whoami"
       ],
       "flags": {
         "json": {
@@ -467,7 +490,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:logout",
+      "id": "asa:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -477,48 +500,40 @@
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "logout.js"
+        "asa",
+        "whoami.js"
       ]
     },
-    "auth:revoke": {
+    "auth:login": {
       "aliases": [],
       "args": {},
-      "description": "Revoke the current authentication token",
+      "description": "Authenticate with Adapty via browser",
       "examples": [
-        "<%= config.bin %> auth revoke"
+        "<%= config.bin %> auth login"
       ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:revoke",
+      "id": "auth:login",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "auth",
-        "revoke.js"
+        "login.js"
       ]
     },
-    "auth:status": {
+    "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Show current authentication state (local only)",
+      "description": "Remove stored authentication token",
       "examples": [
-        "<%= config.bin %> auth status"
+        "<%= config.bin %> auth logout"
       ],
       "flags": {
         "json": {
@@ -531,7 +546,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:status",
+      "id": "auth:logout",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -542,15 +557,15 @@
         "dist",
         "commands",
         "auth",
-        "status.js"
+        "logout.js"
       ]
     },
-    "auth:whoami": {
+    "auth:revoke": {
       "aliases": [],
       "args": {},
-      "description": "Show current user info from server (verifies token)",
+      "description": "Revoke the current authentication token",
       "examples": [
-        "<%= config.bin %> auth whoami"
+        "<%= config.bin %> auth revoke"
       ],
       "flags": {
         "json": {
@@ -563,7 +578,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:whoami",
+      "id": "auth:revoke",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -574,16 +589,15 @@
         "dist",
         "commands",
         "auth",
-        "whoami.js"
+        "revoke.js"
       ]
     },
-    "asa:connect": {
+    "auth:status": {
       "aliases": [],
       "args": {},
-      "description": "Connect an Apple Search Ads account to this company",
+      "description": "Show current authentication state (local only)",
       "examples": [
-        "<%= config.bin %> asa connect",
-        "<%= config.bin %> asa connect --no-wait"
+        "<%= config.bin %> auth status"
       ],
       "flags": {
         "json": {
@@ -592,25 +606,11 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the browser step",
-          "name": "timeout",
-          "default": 300,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "Wait until Apple Ads reports as connected",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:connect",
+      "id": "auth:status",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -620,16 +620,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "connect.js"
+        "auth",
+        "status.js"
       ]
     },
-    "asa:whoami": {
+    "auth:whoami": {
       "aliases": [],
       "args": {},
-      "description": "Show which company the token unlocks and whether Apple Ads is connected",
+      "description": "Show current user info from server (verifies token)",
       "examples": [
-        "<%= config.bin %> asa whoami"
+        "<%= config.bin %> auth whoami"
       ],
       "flags": {
         "json": {
@@ -642,7 +642,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:whoami",
+      "id": "auth:whoami",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -652,7 +652,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
+        "auth",
         "whoami.js"
       ]
     },
@@ -3788,70 +3788,6 @@
         "summary.js"
       ]
     },
-    "asa:creatives:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List creatives; creative_id is what `asa ads create` needs",
-      "examples": [
-        "<%= config.bin %> asa creatives list",
-        "<%= config.bin %> asa creatives list --app APP_UUID"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:creatives:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "creatives",
-        "list.js"
-      ]
-    },
     "asa:keywords:add": {
       "aliases": [],
       "args": {},
@@ -4158,7 +4094,7 @@
     "asa:metrics": {
       "aliases": [],
       "args": {},
-      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at 5000 breakdown\nrows (entities × countries × periods); over it the call fails with 422 cli_response_too_large — coarsen\nthe grouping, narrow the window, or reduce page[size]. Budget: 5 metrics calls per minute, at most\n2 per 10 seconds, one at a time.\n\n--metric is required and every metric named is computed over the whole entity set, so ask for the\ncolumns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)\ncount unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they\nare refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way\nto make any call fast, since cost follows the number of entities aggregated, not the page size.",
+      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at a breakdown-row\ncount (entities × countries × periods); over it the call fails with 422 cli_response_too_large naming the\npage[size] that fits — coarsen the grouping, narrow the window, or reduce page[size].\n\nMoney columns are in the campaign group currency, not USD, and spend and local_spend carry the same\nfigure; the currency itself comes from asa orgs list. Rate budgets and the breakdown-row cap are set per\ncompany: read the current ones with asa whoami rather than assuming a default. meta.pagination.count is\nthe full entity count behind the filters, so take inventory from there instead of counting the rows on a\npage. meta.max_valid_day says how many days the youngest cohort in the window has lived — any --by-days\nwindow above it repeats the last real figure because that time has not passed yet, so treat those as\nunreached rather than as a plateau.\n\n--metric is required and every metric named is computed over the whole entity set, so ask for the\ncolumns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)\ncount unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they\nare refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way\nto make any call fast, since cost follows the number of entities aggregated, not the page size.",
       "examples": [
         "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric adapty_installs",
         "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --order-by spend --page-size 5",
@@ -4877,6 +4813,70 @@
         "list.js"
       ]
     },
+    "asa:creatives:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List creatives; creative_id is what `asa ads create` needs",
+      "examples": [
+        "<%= config.bin %> asa creatives list",
+        "<%= config.bin %> asa creatives list --app APP_UUID"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:creatives:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "creatives",
+        "list.js"
+      ]
+    },
     "flows:config:get": {
       "aliases": [],
       "args": {
@@ -5181,5 +5181,5 @@
       ]
     }
   },
-  "version": "0.8.4"
+  "version": "0.8.5"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adapty",
   "description": "Adapty command line interface",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "author": "Adapty team <support@adapty.io>",
   "bin": {
     "adapty": "./bin/run.js"
@@ -16,25 +16,27 @@
   },
   "devDependencies": {
     "@eslint/compat": "^1",
-    "@oclif/prettier-config": "^0.2.1",
+    "@eslint/js": "^9.39.2",
     "@oclif/test": "^4",
+    "@stylistic/eslint-plugin": "^5.10.0",
     "@types/chai": "^4",
     "@types/mocha": "^10",
-    "@types/node": "^18",
+    "@types/node": "^22",
     "@types/sinon": "^21.0.0",
     "chai": "^4",
     "eslint": "^9",
-    "eslint-config-oclif": "^6",
-    "eslint-config-prettier": "^10",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-n": "^18.3.0",
     "mocha": "^10",
     "oclif": "^4",
     "shx": "^0.3.3",
     "sinon": "^21.0.2",
     "ts-node": "^10",
-    "typescript": "^5"
+    "typescript": "^5",
+    "typescript-eslint": "^8.70.0"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": "^22 || >=24"
   },
   "packageManager": "pnpm@10.28.1",
   "files": [
@@ -137,7 +139,7 @@
   "scripts": {
     "build": "shx rm -rf dist && tsc -b",
     "check:agent-docs": "oclif manifest && node scripts/check-agent-docs.mjs",
-    "lint": "eslint",
+    "lint": "eslint --max-warnings 0",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "pnpm run lint",
     "prepack": "oclif manifest && oclif readme",