@myapihq/cli 2.31.3 → 2.31.5

package/dist/commands/domain.js

@@ -51,6 +51,9 @@ export const SCHEMA = {
     'registrant-state': 'string',
     'registrant-postal-code': 'string',
     'registrant-country': 'string',
+    // Alias for --registrant-country, kept because account declared this
+    // spelling for the same field. See fromFlags in registrant.ts.
+    'registrant-country-code': 'string',
     'registrant-organization': 'string',
     // DNS records sub-surface
     type: 'string',

package/dist/commands/pixel.js

@@ -26,7 +26,7 @@ export async function interactions(flags) {
     const config = requireConfig();
     const orgId = flags.org || config.default_org;
     if (!orgId) {
-        error("Missing required arguments.\nUsage: myapi pixel interactions --org <id> [--website <domain>] [--campaign-id <id>] [--domain <domain>]\n(Or set defaults via: myapi config set-org <id>)");
+        error("Missing required arguments.\nUsage: myapi pixel interactions (--website <host> | --campaign-id <id> | --domain <domain>) [--org <id>]\n  --website: a site YOU own, where your pixel runs · --domain: a domain your visitors went to\n(Or set defaults via: myapi config set-org <id>)");
     }
     const params = {};
     if (flags.website)
@@ -44,7 +44,7 @@ export async function interactions(flags) {
     if (flags.offset)
         params.offset = parseInt(flags.offset, 10);
     if (!params.website && !params.campaign_id && !params.domain) {
-        error("You must provide at least one filter: --website, --campaign-id, or --domain");
+        error("You must provide at least one filter.\n  --website <host>     a site you own (where your pixel runs)\n  --campaign-id <id>   one email campaign\n  --domain <domain>    a domain your visitors went to");
     }
     const res = await sdkPixel.getInteractions(config.api_key, orgId, params);
     if (flags.json) {
@@ -87,7 +87,7 @@ export async function visits(flags) {
         ts: v.ts,
     })));
     // /visits returns only {visits, total} — it does NOT echo limit/offset the
-    // way /events and /interactions do, so this used to print
+    // way /interactions does, so this used to print
     // "Showing: undefined | Offset: undefined". Report what the response
     // actually carries.
     info(`Total: ${res.total} | Showing: ${res.visits.length}`);
@@ -128,7 +128,11 @@ export async function events(flags) {
         campaign_id: e.campaign_id ?? '',
         ts: e.ts,
     })));
-    info(`Total: ${res.total} | Showing: ${res.limit} | Offset: ${res.offset}`);
+    // /events returns {events, total} — the limit/offset echo the visits comment
+    // above attributes to it is in `meta`, which the SDK does not surface, so
+    // this printed "Showing: undefined | Offset: undefined" too. Only
+    // /interactions genuinely echoes them in the body.
+    info(`Total: ${res.total} | Showing: ${res.events.length}`);
 }
 // Geographic distribution sample of the org's pixel audience.
 export async function audience(flags) {
@@ -191,7 +195,7 @@ Subcommands:
   identify       Link a known email/user id to an anonymous pixel visitor
   identity       Resolve the identity graph (emails, IPs, profiles) for a pixel ID
   interactions   Get a unified timeline of visits and events
-                 (requires at least one filter: --website, --campaign-id, or --domain)
+                 (requires one of: --website = a site you own · --campaign-id · --domain = a visited domain)
   visits         Page-visit timeline scoped to a website host
 
 All commands accept --org <id> (or set default: myapi config set-org <id>).`);

package/dist/commands/status.js

@@ -113,8 +113,13 @@ export async function run(_subcommand, _args, flags = {}) {
             info(`Recharge: ${summary}`);
     }
     if (Array.isArray(freeTier) && freeTier.length > 0) {
+        // A zero allowance rendered as "domain 0/0" reads like an error and says
+        // nothing a user can act on — there is no free tier for that slot, which
+        // is the platform's default, not this account's state. Show a slot only
+        // when there is an allowance to consume or usage to explain.
         const parts = freeTier
             .filter((e) => e && typeof e.service === 'string')
+            .filter((e) => (e.allowance ?? 0) > 0 || (e.used ?? 0) > 0)
             .map((e) => `${e.service} ${e.used ?? 0}/${e.allowance ?? '?'}`);
         if (parts.length > 0)
             info(`FreeTier: ${parts.join(' · ')}`);

package/dist/errors.js

@@ -144,7 +144,16 @@ export function friendlyError(err) {
         lines.push(err.requestId
             ? `  Quote this when reporting it: ${err.requestId}`
             : '  No request id came back, so quote the exact command and the time instead.');
-        lines.push('  Whether the change went through is not knowable from here — check before retrying.');
+        // Only for a request that could have changed something. A 500 can land
+        // before or after a write, so the warning is right for POST/PATCH/DELETE —
+        // but `pixel audience` is a GET, and telling someone to go and check
+        // whether their read went through sends them looking for a change that
+        // could not exist. Unknown method keeps the warning: silence about a
+        // possible half-applied write is the worse failure.
+        const read = err.method === 'GET' || err.method === 'HEAD';
+        if (!read) {
+            lines.push('  Whether the change went through is not knowable from here — check before retrying.');
+        }
         return withOrgContext(lines.join('\n'), err);
     }
     const base = ERROR_MESSAGES[err.code] || err.code;

package/dist/errors.test.js

@@ -139,3 +139,29 @@ function looksLikeBadKey(err) {
     ]);
     return err.status === 401 && (!err.code || AUTH_CODES.has(String(err.code).toLowerCase()));
 }
+// A 500 on a GET used to end with "Whether the change went through is not
+// knowable from here — check before retrying." `pixel audience` is a read; it
+// sent people to look for a change that could not exist. Found 2026-08-24 while
+// fixing PIXEL_BASE, when the command finally reached the platform at all.
+describe('5xx advice distinguishes a read from a write', () => {
+    function err(method) {
+        const e = new MyApiError('ANALYTICS_ERROR', 502, 'analytics query failed');
+        e.requestId = 'req_test';
+        if (method)
+            e.method = method;
+        return e;
+    }
+    it('says nothing about a change after a failed GET', () => {
+        const msg = friendlyError(err('GET'));
+        expect(msg).not.toContain('went through');
+        expect(msg).toContain('req_test');
+        expect(msg).toContain('our fault');
+    });
+    it('still warns after a failed write', () => {
+        expect(friendlyError(err('POST'))).toContain('went through');
+        expect(friendlyError(err('DELETE'))).toContain('went through');
+    });
+    it('keeps the warning when the method is unknown', () => {
+        expect(friendlyError(err())).toContain('went through');
+    });
+});

package/dist/registrant.js

@@ -21,6 +21,21 @@ import { saveConfig } from './config.js';
 // whether the partial is "complete enough" (we require all six base
 // fields plus country_code; state is optional).
 function fromFlags(flags) {
+    // Two spellings exist in the wild: account's schema declared
+    // `registrant-country-code` while this reader only ever read
+    // `registrant-country` — so the -code spelling was typed, swallowed a value,
+    // and did nothing. A scripted `account registrant set` then failed with
+    // "country_code missing" while the country sat in argv. Accept both;
+    // `registrant-country` is canonical (matching the rest of the family, which
+    // carries no type suffixes). Both-with-different-values is refused rather
+    // than resolved by precedence.
+    const country = flags['registrant-country'];
+    const countryAlias = flags['registrant-country-code'];
+    if (typeof country === 'string' && typeof countryAlias === 'string' && country !== countryAlias) {
+        error(`--registrant-country ("${country}") and --registrant-country-code ("${countryAlias}") disagree — they are the same field. Pass one.`);
+    }
+    const countryCode = typeof country === 'string' ? country
+        : typeof countryAlias === 'string' ? countryAlias : undefined;
     return {
         name: typeof flags['registrant-name'] === 'string' ? flags['registrant-name'] : undefined,
         email: typeof flags['registrant-email'] === 'string' ? flags['registrant-email'] : undefined,
@@ -29,7 +44,7 @@ function fromFlags(flags) {
         city: typeof flags['registrant-city'] === 'string' ? flags['registrant-city'] : undefined,
         state: typeof flags['registrant-state'] === 'string' ? flags['registrant-state'] : undefined,
         postal_code: typeof flags['registrant-postal-code'] === 'string' ? flags['registrant-postal-code'] : undefined,
-        country_code: typeof flags['registrant-country'] === 'string' ? flags['registrant-country'] : undefined,
+        country_code: countryCode,
         organization: typeof flags['registrant-organization'] === 'string' ? flags['registrant-organization'] : undefined,
     };
 }

package/dist/registrant.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/registrant.test.js

@@ -0,0 +1,39 @@
+import { describe, it, expect } from 'vitest';
+import { resolveRegistrantForRegister } from './registrant.js';
+import { withSink, CommandFailed } from './output.js';
+// error() exits the process unless a sink captures it — same pattern as
+// dispatch-in-process.test.ts.
+const SINK = { out: () => { }, err: () => { }, fail: (m) => { throw new CommandFailed(m); } };
+// `--registrant-country-code` was declared in account's SCHEMA but read by
+// nothing: fromFlags only ever looked at `registrant-country`. The -code
+// spelling consumed a value and discarded it, so a scripted registrant set
+// failed with "country_code missing" while the country sat in argv. Found
+// 2026-08-24 by dumping every SCHEMA key and asking which have no consumer.
+// Both spellings are read now; these tests pin that to behaviour, not to a
+// schema entry a lint could satisfy without a consumer.
+const BASE = {
+    'registrant-name': 'Ada Lovelace',
+    'registrant-email': 'ada@example.com',
+    'registrant-phone': '+44.2071234567',
+    'registrant-street': '12 Analytical Way',
+    'registrant-city': 'London',
+    'registrant-postal-code': 'EC1A 1AA',
+};
+const CONFIG = {};
+describe('registrant country spellings', () => {
+    it('canonical --registrant-country reaches country_code', async () => {
+        const r = await resolveRegistrantForRegister({ ...BASE, 'registrant-country': 'GB' }, CONFIG);
+        expect(r.country_code).toBe('GB');
+    });
+    it('the alias --registrant-country-code reaches country_code too', async () => {
+        const r = await resolveRegistrantForRegister({ ...BASE, 'registrant-country-code': 'GB' }, CONFIG);
+        expect(r.country_code).toBe('GB');
+    });
+    it('both spellings with different values are refused, not resolved by precedence', async () => {
+        await expect(withSink(SINK, () => resolveRegistrantForRegister({ ...BASE, 'registrant-country': 'GB', 'registrant-country-code': 'DE' }, CONFIG))).rejects.toThrow(/disagree/);
+    });
+    it('both spellings agreeing is fine', async () => {
+        const r = await resolveRegistrantForRegister({ ...BASE, 'registrant-country': 'GB', 'registrant-country-code': 'GB' }, CONFIG);
+        expect(r.country_code).toBe('GB');
+    });
+});

package/dist/skills/my-pixel-api/SKILL.md

@@ -4,7 +4,7 @@ version: 1.0.0
 description: >
   Tracking pixel + identity resolution for MyAPI funnels and email. Capture visits and events, resolve known users to anonymous sessions, stream interaction events for analytics. Pairs with mycrmapi for auto-ingest of pixel_visit events on known contacts.
 triggers: [pixel, analytics, tracking, visit, event, identity, session, attribution, geo, open pixel]
-checksum: sha256-2c6508a5fdfa752cc5fd4231c087380e6d904f514973830a34e919b277ad31de
+checksum: sha256-4be497d5db05dbca3646b76b3385c22f84de4726d1049a7d9876c054159e4a58
 ---
 
 # MyPixelAPI
@@ -103,7 +103,7 @@ graph across the visitor's sessions.
 <!-- http:start -->
 <!-- generated by `npm run canonical-sync` — do not edit -->
 ```
-base   https://api.mypixelapi.com
+base   https://api.myapihq.com
 path   POST /pixel/orgs/{org_id}/identify
 auth   Authorization: Bearer <key>   (fn: env.__MYAPI_KEY · container: env.MYAPI_KEY)
 reply  { "success": true, "data": …, "error": null, "meta": {…} }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/cli",
   "license": "Apache-2.0",
-  "version": "2.31.3",
+  "version": "2.31.5",
   "description": "MyAPI command-line interface",
   "repository": {
     "type": "git",
@@ -35,6 +35,8 @@
     "lint:help-order": "node scripts/lint-help-order.js",
     "lint:exposes": "node scripts/lint-exposes.js",
     "lint:query-params": "node scripts/lint-query-params.js",
+    "lint:flag-lexicon": "node scripts/lint-flag-lexicon.js",
+    "lint:verb-symmetry": "node scripts/lint-verb-symmetry.js",
     "lint:request-fields": "node scripts/lint-request-fields.js",
     "audit:doctor": "npm run build && node scripts/audit-doctor.js",
     "lint:docs": "node scripts/lint-docs.js",
@@ -47,7 +49,7 @@
     "lint:skills:strict": "node scripts/copy-skills.js && node scripts/lint-skills.js --strict"
   },
   "dependencies": {
-    "@myapihq/sdk": "^2.31.3"
+    "@myapihq/sdk": "^2.31.5"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",