@a8techads/cli 0.2.0 → 0.3.0

package/dist/a8techads.js

@@ -2646,6 +2646,9 @@ async function login(opts = {}) {
   if (opts.tenantId) {
     authorizeUrl.searchParams.set("tenant_id", opts.tenantId);
   }
+  if (opts.forceLogin) {
+    authorizeUrl.searchParams.set("prompt", "login");
+  }
   const code = await waitForAuthorizationCode(authorizeUrl.toString(), state);
   console.log("Exchanging authorization code for tokens...");
   const tokenResponse = await fetch(tokenEndpoint, {
@@ -3083,11 +3086,12 @@ Examples:
 Browser mode (default): Opens browser for OAuth 2.1 Authorization Code + PKCE.
 Client credentials mode: Non-interactive auth using --client-id and --client-secret.
 
-Requires: network access to auth server.`).option("-p, --profile <name>", "Profile name (browser mode only)", "default").option("--api-url <url>", "API base URL (default: https://api.a8.tech)").option("--auth-url <url>", "Auth server URL (default: https://auth.a8.tech)").option("--client-id <id>", "OAuth client ID (enables client_credentials flow)").option("--client-secret <secret>", "OAuth client secret (requires --client-id)").addHelpText("after", `
+Requires: network access to auth server.`).option("-p, --profile <name>", "Profile name (browser mode only)", "default").option("--api-url <url>", "API base URL (default: https://api.a8.tech)").option("--auth-url <url>", "Auth server URL (default: https://auth.a8.tech)").option("--client-id <id>", "OAuth client ID (enables client_credentials flow)").option("--client-secret <secret>", "OAuth client secret (requires --client-id)").option("--force-login", "Force login prompt even if browser session exists (use to switch users)").addHelpText("after", `
 Examples:
   $ a8techads auth login                               # Interactive browser login
   $ a8techads auth login -p staging --api-url https://api.staging.a8.tech
   $ a8techads auth login --client-id svc-001 --client-secret s3cret
+  $ a8techads auth login -p owner --force-login        # Switch to different user
 
 Note: Client credentials tokens cannot be refreshed. The CLI will prompt
       for re-authentication when the token expires.`).action(async (opts) => {
@@ -3107,7 +3111,8 @@ Note: Client credentials tokens cannot be refreshed. The CLI will prompt
         await login({
           profile: opts.profile,
           apiUrl: opts.apiUrl,
-          authUrl: opts.authUrl
+          authUrl: opts.authUrl,
+          forceLogin: opts.forceLogin
         });
       }
     } catch (err) {
@@ -3514,8 +3519,172 @@ function addFormatOption(cmd) {
   return cmd.option("-f, --format <format>", "Output format: table, json, csv (default: table)", "table");
 }
 
-// src/commands/campaigns.ts
+// src/commands/audiences.ts
 var COLUMNS = [
+  { key: "id", header: "ID", width: 36 },
+  { key: "name", header: "NAME", width: 25 },
+  { key: "type", header: "TYPE", width: 15 },
+  { key: "status", header: "STATUS", width: 10 },
+  { key: "estimatedSize", header: "SIZE", width: 10, format: (v) => v != null ? Number(v).toLocaleString() : "-" }
+];
+function createAudiencesCommand() {
+  const cmd = new Command("audiences").description(`Audience management (DSP)
+
+Phase 1: UPLOADED_LIST only.
+
+Requires: ADVERTISER capability.`).addHelpText("after", `
+Examples:
+  $ a8techads audiences list
+  $ a8techads audiences get <id>
+  $ a8techads audiences create --name "High-Value Customers" --type UPLOADED_LIST
+  $ a8techads audiences upload <id> --file users.csv --identifier-type EMAIL_HASH
+  $ a8techads audiences activate <id>
+  $ a8techads audiences pause <id>`);
+  addFormatOption(cmd.command("list").description("List audiences.").option("--type <type>", "Filter by type (UPLOADED_LIST)").option("--status <status>", "Filter by status (DRAFT, READY, ACTIVE, PAUSED, etc.)").option("--limit <n>", "Max results", "20")).action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit });
+    if (opts.type)
+      params.set("type", opts.type);
+    if (opts.status)
+      params.set("status", opts.status);
+    const resp = await apiRequest({ path: `${dspPrefix()}/audiences?${params}` });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    const rows = (json.data ?? json).map((a) => ({
+      id: a.id,
+      name: a.name,
+      type: a.type,
+      status: a.status,
+      estimatedSize: a.estimatedSize ?? a.estimated_size
+    }));
+    printData(rows, COLUMNS, opts.format);
+  });
+  addFormatOption(cmd.command("get").description("Get audience details by ID.").argument("<id>", "Audience ID")).action(async (id, opts) => {
+    const resp = await apiRequest({ path: `${dspPrefix()}/audiences/${id}` });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    printDetail(json.data ?? json, opts.format);
+  });
+  cmd.command("create").description(`Create a new audience.
+
+Phase 1 only supports type UPLOADED_LIST.`).option("--name <name>", "Audience name (required)").option("--type <type>", "Audience type (default: UPLOADED_LIST)", "UPLOADED_LIST").option("--description <desc>", "Description").option("--ttl <days>", "Membership TTL in days (default: 90)", "90").option("--from-json <file>", "Create from JSON file").addHelpText("after", `
+Examples:
+  $ a8techads audiences create --name "High-Value Customers"
+  $ a8techads audiences create --name "Retarget Pool" --ttl 30
+  $ a8techads audiences create --from-json audience.json`).action(async (opts) => {
+    let body;
+    if (opts.fromJson) {
+      const { readFileSync: readFileSync3 } = await import("fs");
+      body = JSON.parse(readFileSync3(opts.fromJson, "utf-8"));
+    } else {
+      if (!opts.name) {
+        console.error('Error: --name is required. Run "a8techads audiences create --help".');
+        process.exit(1);
+      }
+      body = {
+        name: opts.name,
+        type: opts.type,
+        membershipTtlDays: Number(opts.ttl)
+      };
+      if (opts.description)
+        body.description = opts.description;
+    }
+    const resp = await apiRequest({ method: "POST", path: `${dspPrefix()}/audiences`, body });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? json.errors ?? resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`Audience created: ${json.data?.id ?? json.id}`);
+  });
+  cmd.command("update").description("Update an audience.").argument("<id>", "Audience ID").option("--name <name>", "New name").option("--description <desc>", "New description").option("--ttl <days>", "New membership TTL in days").action(async (id, opts) => {
+    const body = {};
+    if (opts.name)
+      body.name = opts.name;
+    if (opts.description)
+      body.description = opts.description;
+    if (opts.ttl)
+      body.membershipTtlDays = Number(opts.ttl);
+    const resp = await apiRequest({ method: "PATCH", path: `${dspPrefix()}/audiences/${id}`, body });
+    if (!resp.ok) {
+      const j = await resp.json();
+      console.error(`Error: ${j.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`Audience ${id} updated.`);
+  });
+  cmd.command("delete").description("Delete an audience.").argument("<id>", "Audience ID").option("--yes", "Skip confirmation").action(async (id, opts) => {
+    if (!opts.yes) {
+      console.error("Add --yes to confirm deletion.");
+      process.exit(1);
+    }
+    const resp = await apiRequest({ method: "DELETE", path: `${dspPrefix()}/audiences/${id}` });
+    if (!resp.ok && resp.status !== 204) {
+      console.error(`Error: ${resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`Audience ${id} deleted.`);
+  });
+  cmd.command("activate").description("Activate an audience (must be READY or PAUSED).").argument("<id>", "Audience ID").action(async (id) => {
+    const resp = await apiRequest({ method: "PATCH", path: `${dspPrefix()}/audiences/${id}/activate` });
+    if (!resp.ok) {
+      const j = await resp.json();
+      console.error(`Error: ${j.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`Audience ${id} activated.`);
+  });
+  cmd.command("pause").description("Pause an active audience.").argument("<id>", "Audience ID").action(async (id) => {
+    const resp = await apiRequest({ method: "PATCH", path: `${dspPrefix()}/audiences/${id}/pause` });
+    if (!resp.ok) {
+      const j = await resp.json();
+      console.error(`Error: ${j.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`Audience ${id} paused.`);
+  });
+  cmd.command("archive").description("Archive an audience.").argument("<id>", "Audience ID").action(async (id) => {
+    const resp = await apiRequest({ method: "PATCH", path: `${dspPrefix()}/audiences/${id}/archive` });
+    if (!resp.ok) {
+      const j = await resp.json();
+      console.error(`Error: ${j.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`Audience ${id} archived.`);
+  });
+  cmd.command("upload").description(`Upload a user list to populate audience membership.
+
+Accepts CSV or JSON files with user identifiers.`).argument("<id>", "Audience ID").option("--file <path>", "File path (CSV or JSON)").option("--identifier-type <type>", "Identifier type: EMAIL_HASH or DEVICE_ID", "EMAIL_HASH").option("--estimated-size <n>", "Estimated number of users in file").addHelpText("after", `
+Examples:
+  $ a8techads audiences upload <id> --file users.csv --identifier-type EMAIL_HASH
+  $ a8techads audiences upload <id> --file devices.json --identifier-type DEVICE_ID`).action(async (id, opts) => {
+    if (!opts.file) {
+      console.error("Error: --file is required.");
+      process.exit(1);
+    }
+    const body = {
+      identifierType: opts.identifierType
+    };
+    if (opts.estimatedSize)
+      body.estimatedSize = Number(opts.estimatedSize);
+    const resp = await apiRequest({ method: "POST", path: `${dspPrefix()}/audiences/${id}/upload`, body });
+    const json = await resp.json();
+    if (!resp.ok) {
+      console.error(`Error: ${json.error ?? resp.statusText}`);
+      process.exit(1);
+    }
+    console.log(`Upload processed. Audience status: ${json.data?.status ?? json.status}`);
+  });
+  return cmd;
+}
+
+// src/commands/campaigns.ts
+var COLUMNS2 = [
   { key: "id", header: "ID", width: 36 },
   { key: "name", header: "NAME", width: 30 },
   { key: "status", header: "STATUS", width: 12 },
@@ -3549,7 +3718,7 @@ Examples:
       budget: c.budget ?? c.dailyBudget,
       spent: c.stats?.spend ?? c.spent
     }));
-    printData(rows, COLUMNS, opts.format);
+    printData(rows, COLUMNS2, opts.format);
   });
   addFormatOption(cmd.command("get").description("Get campaign details by ID.").argument("<id>", "Campaign ID")).action(async (id, opts) => {
     const resp = await apiRequest({ path: `${dspPrefix()}/campaigns/${id}` });
@@ -3661,7 +3830,7 @@ Examples:
 }
 
 // src/commands/variations.ts
-var COLUMNS2 = [
+var COLUMNS3 = [
   { key: "id", header: "ID", width: 36 },
   { key: "name", header: "NAME", width: 25 },
   { key: "type", header: "TYPE", width: 10 },
@@ -3692,7 +3861,7 @@ Examples:
       status: v.status,
       campaignId: v.campaignId ?? v.campaign_id
     }));
-    printData(rows, COLUMNS2, opts.format);
+    printData(rows, COLUMNS3, opts.format);
   });
   addFormatOption(cmd.command("get").description("Get variation details.").argument("<id>", "Variation ID")).action(async (id, opts) => {
     const resp = await apiRequest({ path: `${dspPrefix()}/variations/${id}` });
@@ -3757,7 +3926,7 @@ Examples:
 }
 
 // src/commands/sites.ts
-var COLUMNS3 = [
+var COLUMNS4 = [
   { key: "id", header: "ID", width: 36 },
   { key: "name", header: "NAME", width: 25 },
   { key: "domain", header: "DOMAIN", width: 25 },
@@ -3790,7 +3959,7 @@ Examples:
       status: s.status,
       zoneCount: s.zoneCount ?? s.zone_count ?? "-"
     }));
-    printData(rows, COLUMNS3, opts.format);
+    printData(rows, COLUMNS4, opts.format);
   });
   addFormatOption(cmd.command("get").description("Get site details by ID.").argument("<id>", "Site ID")).action(async (id, opts) => {
     const resp = await apiRequest({ path: `${sspPrefix()}/sites/${id}` });
@@ -3876,7 +4045,7 @@ Examples:
 }
 
 // src/commands/zones.ts
-var COLUMNS4 = [
+var COLUMNS5 = [
   { key: "id", header: "ID", width: 36 },
   { key: "name", header: "NAME", width: 25 },
   { key: "format", header: "FORMAT", width: 18 },
@@ -3908,7 +4077,7 @@ Examples:
       format: z.adFormat ?? z.ad_format ?? "-",
       status: z.status
     }));
-    printData(rows, COLUMNS4, opts.format);
+    printData(rows, COLUMNS5, opts.format);
   });
   addFormatOption(cmd.command("get").description("Get zone details by ID.").argument("<id>", "Zone ID")).action(async (id, opts) => {
     const resp = await apiRequest({ path: `${sspPrefix()}/zones/${id}` });
@@ -4209,7 +4378,7 @@ function usersPrefix() {
   }
   return app === "ssp" ? "/api/v1/ssp" : "/api/v1/dsp";
 }
-var COLUMNS5 = [
+var COLUMNS6 = [
   { key: "id", header: "ID", width: 36 },
   { key: "email", header: "EMAIL", width: 30 },
   { key: "name", header: "NAME", width: 20 },
@@ -4240,7 +4409,7 @@ Examples:
       role: u.role,
       status: u.status
     }));
-    printData(rows, COLUMNS5, opts.format);
+    printData(rows, COLUMNS6, opts.format);
   });
   addFormatOption(cmd.command("get").description("Get team member details.").argument("<id>", "User ID")).action(async (id, opts) => {
     const resp = await apiRequest({ path: `${usersPrefix()}/users/${id}` });
@@ -4455,6 +4624,7 @@ Command Groups:
   auth          Authentication (login, logout, token, status)
   profile       Multi-profile management
   context       Workspace context (tenant, capability, app)
+  audiences     Audience management (DSP)
   campaigns     Campaign management (DSP)
   variations    Ad variation management (DSP)
   sites         Site management (SSP)
@@ -4474,6 +4644,7 @@ Getting Started:
   program2.addCommand(createAuthCommand());
   program2.addCommand(createProfileCommand());
   program2.addCommand(createContextCommand());
+  program2.addCommand(createAudiencesCommand());
   program2.addCommand(createCampaignsCommand());
   program2.addCommand(createVariationsCommand());
   program2.addCommand(createSitesCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a8techads/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A8TechAds CLI — programmatic ad platform management",
   "type": "module",
   "bin": {