braaand 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,8 @@
 # braaand
 
-CLI for [Braaand](https://braaand.ai) — brand infrastructure for agentic automation.
+CLI for [Braaand](https://www.braaand.ai) — brand infrastructure for agentic automation.
 
-Manage brands, assets, templates, and renders from the terminal. AI agents use the same tool via Claude Code skills.
+Manage brands, assets, templates, projects, ad sets, and renders from the terminal. AI agents use the same tool via Claude Code skills.
 
 ## Install
 
@@ -13,25 +13,107 @@ npm install -g braaand
 ## Auth
 
 ```bash
-braaand auth login     # Device auth flow
-braaand auth status    # Check connection
+braaand auth login     # Device auth flow (opens browser)
+braaand whoami         # Who you're authed as + brand counts
+braaand auth logout    # Remove stored credentials
 ```
 
 ## Commands
 
+### Brands
+
+```bash
+braaand brands list
+braaand brands get <id>
+braaand brands config <id>                             # colors, fonts, voice, tokens
+braaand brands info <id>                               # Full dump with asset URLs
+braaand brands knowledge <id> [sectionId]
+braaand brands portal <id>                             # Open brand portal in browser
+braaand brands create <name> [--description <d>]
+braaand brands update <id> [--name <n>] [--description <d>]
+braaand brands delete <id> --yes --confirm-brand-id <id>
+```
+
+### Assets
+
+```bash
+braaand assets list <brandId>
+braaand assets get <brandId> <assetId> [--meta] [--output <path>]
+braaand assets upload <brandId> <file> [--name <n>] [--type logo|image|font|icon|symbol|document]
+braaand assets delete <brandId> <assetId>
+```
+
+### Templates
+
+```bash
+braaand templates list <brandId>
+braaand templates get <brandId> <templateId>
+braaand templates discover <brandId>                   # Agent-facing catalog
+braaand templates create <brandId> <name> [--from <file.json>]
+braaand templates delete <brandId> <templateId> [--force]
+```
+
+### System templates
+
+```bash
+braaand system-templates list
+braaand system-templates instantiate <id> --brand <brandId>
+```
+
+### Projects & ad sets
+
+```bash
+braaand projects list <brandId>
+braaand projects create <brandId> <name> [--description <d>]
+braaand projects update <brandId> <projectId> [--name <n>]
+braaand projects delete <brandId> <projectId>
+
+braaand adsets list <brandId> <projectId>
+braaand adsets create <brandId> <projectId> <name> --ads @ads.json
+braaand adsets update <brandId> <projectId> <adSetId> --ads @ads.json
+braaand adsets delete <brandId> <projectId> <adSetId>
+```
+
+### Rendering
+
+```bash
+# Single format
+braaand render <brandId> <templateId> --format 1x1 --output hero.png
+
+# Multiple formats (comma-separated)
+braaand render <brandId> <templateId> --format 1x1,9x16,4x5 --output hero
+# → writes hero-1x1.png, hero-9x16.png, hero-4x5.png
+
+# All formats the template supports
+braaand render <brandId> <templateId> --all-formats --output hero
+
+# Batch render a saved ad set
+braaand render batch <brandId> <projectId> <adSetId> --output-dir ./renders
+```
+
+### Onboarding & sync
+
+```bash
+braaand onboard <file.json>                            # Create brand + config + assets
+braaand sync [brandId] [--dir <path>]                  # Sync brand assets locally
+```
+
+### Config
+
+```bash
+braaand config show                                    # Current API URL + auth state
+braaand config set-url <url>                           # Default: https://www.braaand.ai
+```
+
+## Output
+
+All commands output JSON to stdout. Pipe to `jq` for filtering:
+
 ```bash
-braaand brands list                          # List brands
-braaand brands config <brandId>              # Get brand config
-braaand brands info <brandId>                # Full dump with asset URLs
-braaand assets list <brandId>                # List assets
-braaand assets upload <brandId> <file>       # Upload asset
-braaand templates discover <brandId>         # Agent-facing catalog
-braaand system-templates list                # Browse system templates
-braaand render <brandId> <templateId>        # Render to PNG
-braaand onboard <file.json>                  # Create brand + config + assets
-braaand sync                                 # Sync brand assets locally
+braaand brands list | jq '.[].name'
+braaand assets list my-brand | jq '.[] | select(.type == "font") | .name'
 ```
 
 ## More
 
-See [braaand.ai](https://braaand.ai) for full documentation.
+See [braaand.ai](https://www.braaand.ai) for full documentation.

package/dist/api.d.ts

@@ -2,8 +2,34 @@ export declare class ApiError extends Error {
     status: number;
     constructor(status: number, message: string);
 }
-export declare function apiFetch(path: string, options?: RequestInit): Promise<unknown>;
+/**
+ * Read the API key or throw ApiError(401).
+ * Use this in commands that need auth — replaces duplicated checks.
+ */
+export declare function requireAuth(): string;
+interface FetchOptions extends Omit<RequestInit, "body"> {
+    body?: BodyInit | Record<string, unknown> | null;
+}
+/**
+ * JSON API fetch with auth.
+ * Auto-stringifies plain object bodies. For multipart uploads use apiUpload.
+ */
+export declare function apiFetch(path: string, options?: FetchOptions): Promise<unknown>;
+/**
+ * Multipart upload with auth. Sets Authorization but lets fetch set the
+ * multipart boundary via Content-Type.
+ */
+export declare function apiUpload(path: string, form: FormData): Promise<unknown>;
+/**
+ * Binary download with auth. Returns buffer and response headers
+ * (so callers can read custom headers like x-render-id).
+ */
+export declare function apiDownload(path: string, options?: FetchOptions): Promise<{
+    buffer: Buffer;
+    headers: Headers;
+}>;
 /**
  * Unauthenticated fetch for public endpoints (device auth).
  */
 export declare function publicFetch(url: string, options?: RequestInit): Promise<unknown>;
+export {};

package/dist/api.js

@@ -6,15 +6,40 @@ export class ApiError extends Error {
         this.status = status;
     }
 }
+/**
+ * Read the API key or throw ApiError(401).
+ * Use this in commands that need auth — replaces duplicated checks.
+ */
+export function requireAuth() {
+    const key = getApiKey();
+    if (!key) {
+        throw new ApiError(401, "Not authenticated. Run: braaand auth login");
+    }
+    return key;
+}
+/**
+ * JSON API fetch with auth.
+ * Auto-stringifies plain object bodies. For multipart uploads use apiUpload.
+ */
 export async function apiFetch(path, options = {}) {
+    const apiKey = requireAuth();
     const config = getConfig();
-    const apiKey = getApiKey();
-    if (!apiKey) {
-        throw new ApiError(401, "Not authenticated. Run: braaand auth login");
+    let body = undefined;
+    if (options.body != null) {
+        if (typeof options.body === "object" &&
+            !(options.body instanceof FormData) &&
+            !(options.body instanceof ArrayBuffer) &&
+            !(options.body instanceof Uint8Array) &&
+            !(options.body instanceof Blob)) {
+            body = JSON.stringify(options.body);
+        }
+        else {
+            body = options.body;
+        }
     }
-    const url = `${config.apiUrl}${path}`;
-    const res = await fetch(url, {
+    const res = await fetch(`${config.apiUrl}${path}`, {
         ...options,
+        body,
         headers: {
             "Authorization": `Bearer ${apiKey}`,
             "Content-Type": "application/json",
@@ -22,22 +47,101 @@ export async function apiFetch(path, options = {}) {
         },
     });
     if (!res.ok) {
-        const body = await res.text();
+        const text = await res.text();
         let message;
         try {
-            const json = JSON.parse(body);
-            message = json.error || json.message || body;
+            const json = JSON.parse(text);
+            message = json.error || json.message || text;
         }
         catch {
-            message = body;
+            message = text;
         }
         throw new ApiError(res.status, `${res.status} ${message}`);
     }
+    // DELETE may return empty body
+    const text = await res.text();
+    if (!text)
+        return {};
     const contentType = res.headers.get("content-type") ?? "";
     if (contentType.includes("application/json")) {
-        return res.json();
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    return text;
+}
+/**
+ * Multipart upload with auth. Sets Authorization but lets fetch set the
+ * multipart boundary via Content-Type.
+ */
+export async function apiUpload(path, form) {
+    const apiKey = requireAuth();
+    const config = getConfig();
+    const res = await fetch(`${config.apiUrl}${path}`, {
+        method: "POST",
+        headers: { "Authorization": `Bearer ${apiKey}` },
+        body: form,
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        let message;
+        try {
+            const json = JSON.parse(text);
+            message = json.error || json.message || text;
+        }
+        catch {
+            message = text;
+        }
+        throw new ApiError(res.status, `${res.status} ${message}`);
+    }
+    return res.json();
+}
+/**
+ * Binary download with auth. Returns buffer and response headers
+ * (so callers can read custom headers like x-render-id).
+ */
+export async function apiDownload(path, options = {}) {
+    const apiKey = requireAuth();
+    const config = getConfig();
+    let body = undefined;
+    if (options.body != null) {
+        if (typeof options.body === "object" &&
+            !(options.body instanceof FormData) &&
+            !(options.body instanceof ArrayBuffer) &&
+            !(options.body instanceof Uint8Array) &&
+            !(options.body instanceof Blob)) {
+            body = JSON.stringify(options.body);
+        }
+        else {
+            body = options.body;
+        }
+    }
+    const res = await fetch(`${config.apiUrl}${path}`, {
+        ...options,
+        body,
+        headers: {
+            "Authorization": `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            ...options.headers,
+        },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        let message;
+        try {
+            const json = JSON.parse(text);
+            message = json.error || json.message || text;
+        }
+        catch {
+            message = text;
+        }
+        throw new ApiError(res.status, `${res.status} ${message}`);
     }
-    return res.text();
+    const buffer = Buffer.from(await res.arrayBuffer());
+    return { buffer, headers: res.headers };
 }
 /**
  * Unauthenticated fetch for public endpoints (device auth).
@@ -45,6 +149,7 @@ export async function apiFetch(path, options = {}) {
 export async function publicFetch(url, options = {}) {
     const res = await fetch(url, {
         ...options,
+        redirect: "follow",
         headers: {
             "Content-Type": "application/json",
             ...options.headers,

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACd;IAAnB,YAAmB,MAAc,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,WAAM,GAAN,MAAM,CAAQ;IAEjC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,UAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,4CAA4C,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,GAAG,OAAO;QACV,OAAO,EAAE;YACP,eAAe,EAAE,UAAU,MAAM,EAAE;YACnC,cAAc,EAAE,kBAAkB;YAClC,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,UAAuB,EAAE;IAEzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,GAAG,OAAO;QACV,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/commands/assets.d.ts

@@ -1,7 +1,12 @@
 export declare function list(brandId: string): Promise<void>;
+export declare function get(brandId: string, assetId: string, options: {
+    meta?: boolean;
+    output?: string;
+}): Promise<void>;
 export declare function upload(brandId: string, filePath: string, options: {
     name?: string;
     type?: string;
     tags?: string;
     description?: string;
 }): Promise<void>;
+export declare function remove(brandId: string, assetId: string): Promise<void>;

package/dist/commands/assets.js

@@ -1,7 +1,8 @@
-import { readFileSync } from "fs";
+import { readFileSync, writeFileSync } from "fs";
 import { basename, extname } from "path";
-import { getApiKey, getConfig } from "../config.js";
-import { apiFetch } from "../api.js";
+import { getConfig } from "../config.js";
+import { apiFetch, apiUpload, apiDownload } from "../api.js";
+import { exitWithUsage } from "../errors.js";
 const MIME_MAP = {
     ".svg": "image/svg+xml",
     ".png": "image/png",
@@ -20,10 +21,8 @@ function getMime(filename) {
     return MIME_MAP[ext] || "application/octet-stream";
 }
 export async function list(brandId) {
-    if (!brandId) {
-        console.error("Usage: braaand assets list <brandId>");
-        process.exit(1);
-    }
+    if (!brandId)
+        exitWithUsage("Usage: braaand assets list <brandId>");
     const apiUrl = getConfig().apiUrl;
     const assets = (await apiFetch(`/api/brands/${brandId}/assets`));
     const enriched = assets.map((a) => ({
@@ -32,49 +31,63 @@ export async function list(brandId) {
     }));
     console.log(JSON.stringify(enriched, null, 2));
 }
+export async function get(brandId, assetId, options) {
+    if (!brandId || !assetId) {
+        exitWithUsage("Usage: braaand assets get <brandId> <assetId> [--meta] [--output <path>]");
+    }
+    if (options.meta) {
+        const meta = await apiFetch(`/api/brands/${brandId}/assets/${assetId}?meta`);
+        console.log(JSON.stringify(meta, null, 2));
+        return;
+    }
+    // Download binary
+    const { buffer, headers } = await apiDownload(`/api/brands/${brandId}/assets/${assetId}`);
+    const contentType = headers.get("content-type") ?? "application/octet-stream";
+    // Infer extension from content-type
+    const ext = (() => {
+        for (const [e, mt] of Object.entries(MIME_MAP)) {
+            if (mt === contentType)
+                return e;
+        }
+        return ".bin";
+    })();
+    const filename = options.output ?? `${assetId}${ext}`;
+    writeFileSync(filename, buffer);
+    console.log(`Downloaded to ${filename} (${buffer.length} bytes, ${contentType})`);
+}
 export async function upload(brandId, filePath, options) {
     if (!brandId || !filePath) {
-        console.error("Usage: braaand assets upload <brandId> <file> [--name <name>] [--type logo|image|font|icon|symbol] [--tags <comma-sep>] [--description <desc>]");
-        process.exit(1);
-    }
-    const config = getConfig();
-    const apiKey = getApiKey();
-    if (!apiKey) {
-        console.error("Not authenticated. Run: braaand auth login");
-        process.exit(1);
+        exitWithUsage("Usage: braaand assets upload <brandId> <file> [--name <name>] [--type logo|image|font|icon|symbol|document] [--tags <comma-sep>] [--description <desc>]");
     }
     const buffer = readFileSync(filePath);
     const filename = basename(filePath);
     const mime = getMime(filename);
-    // Infer asset type from file extension if not specified
     const inferredType = options.type || (() => {
         const ext = extname(filename).toLowerCase();
         if ([".woff", ".woff2", ".ttf", ".otf"].includes(ext))
             return "font";
         if (ext === ".svg")
             return "logo";
+        if (ext === ".pdf")
+            return "document";
         return "image";
     })();
-    // Build multipart form data
     const form = new FormData();
-    form.append("file", new Blob([buffer], { type: mime }), filename);
+    form.append("file", new Blob([new Uint8Array(buffer)], { type: mime }), filename);
     form.append("name", options.name || filename.replace(/\.[^.]+$/, ""));
     form.append("type", inferredType);
     if (options.tags)
         form.append("tags", options.tags);
     if (options.description)
         form.append("description", options.description);
-    const res = await fetch(`${config.apiUrl}/api/brands/${brandId}/assets`, {
-        method: "POST",
-        headers: { "Authorization": `Bearer ${apiKey}` },
-        body: form,
-    });
-    if (!res.ok) {
-        const text = await res.text();
-        console.error(`Upload failed: ${res.status} ${text}`);
-        process.exit(1);
-    }
-    const asset = await res.json();
+    const asset = await apiUpload(`/api/brands/${brandId}/assets`, form);
     console.log(JSON.stringify(asset, null, 2));
 }
+export async function remove(brandId, assetId) {
+    if (!brandId || !assetId) {
+        exitWithUsage("Usage: braaand assets delete <brandId> <assetId>");
+    }
+    await apiFetch(`/api/brands/${brandId}/assets/${assetId}`, { method: "DELETE" });
+    console.log(JSON.stringify({ deleted: assetId }, null, 2));
+}
 //# sourceMappingURL=assets.js.map

package/dist/commands/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/commands/assets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/commands/assets.ts"],"names":[],"mappings":"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"}

package/dist/commands/brands.d.ts

@@ -4,4 +4,12 @@ export declare function get(brandId: string): Promise<void>;
 export declare function config(brandId: string): Promise<void>;
 export declare function info(brandId: string): Promise<void>;
 export declare function knowledge(brandId: string, sectionId?: string): Promise<void>;
+export declare function update(brandId: string, patch: {
+    name?: string;
+    description?: string;
+}): Promise<void>;
+export declare function remove(brandId: string, options: {
+    yes?: boolean;
+    confirmBrandId?: string;
+}): Promise<void>;
 export declare function portal(brandId: string): Promise<void>;

package/dist/commands/brands.js

@@ -1,5 +1,6 @@
 import { apiFetch } from "../api.js";
 import { getConfig } from "../config.js";
+import { exitWithUsage } from "../errors.js";
 export async function list() {
     const brands = await apiFetch("/api/brands");
     console.log(JSON.stringify(brands, null, 2));
@@ -68,6 +69,42 @@ export async function knowledge(brandId, sectionId) {
         console.log(JSON.stringify(sections, null, 2));
     }
 }
+export async function update(brandId, patch) {
+    if (!brandId) {
+        exitWithUsage("Usage: braaand brands update <brandId> [--name <n>] [--description <d>]");
+    }
+    const body = {};
+    if (patch.name !== undefined)
+        body.name = patch.name;
+    if (patch.description !== undefined)
+        body.description = patch.description;
+    const brand = await apiFetch(`/api/brands/${brandId}`, {
+        method: "PUT",
+        body,
+    });
+    console.log(JSON.stringify(brand, null, 2));
+}
+export async function remove(brandId, options) {
+    if (!brandId) {
+        exitWithUsage("Usage: braaand brands delete <brandId> --yes --confirm-brand-id <brandId>");
+    }
+    if (!options.yes) {
+        exitWithUsage("Refusing to delete: pass --yes to confirm. Brand deletion is owner-only and permanently removes all projects, ad sets, templates, and assets.");
+    }
+    if (options.confirmBrandId !== brandId) {
+        exitWithUsage(`Refusing to delete: --confirm-brand-id must match <brandId> exactly. Got "${options.confirmBrandId ?? ""}".`);
+    }
+    // Best-effort: show what's about to be deleted
+    try {
+        const info = (await apiFetch(`/api/brands/${brandId}`));
+        console.error(`Deleting brand: ${info.name ?? brandId}`);
+    }
+    catch {
+        // ignore — we still attempt delete
+    }
+    await apiFetch(`/api/brands/${brandId}`, { method: "DELETE" });
+    console.log(JSON.stringify({ deleted: brandId }, null, 2));
+}
 export async function portal(brandId) {
     if (!brandId) {
         console.error("Usage: braaand brands portal <brandId>");

package/dist/commands/brands.js.map

@@ -1 +1 @@
-{"version":3,"file":"brands.js","sourceRoot":"","sources":["../../src/commands/brands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"brands.js","sourceRoot":"","sources":["../../src/commands/brands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,WAAoB;IAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE;QAC1C,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAC5C,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAe;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAe;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,eAAe,OAAO,eAAe,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAe;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrD,QAAQ,CAAC,eAAe,OAAO,EAAE,CAAqC;QACtE,QAAQ,CAAC,eAAe,OAAO,eAAe,CAAqC;QACnF,QAAQ,CAAC,eAAe,OAAO,SAAS,CAA4C;KACrF,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,GAAG,CAAC;QACJ,GAAG,EAAE,GAAG,MAAM,eAAe,OAAO,WAAW,CAAC,CAAC,EAAE,EAAE;KACtD,CAAC,CAAC,CAAC;IAEJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,SAAkB;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,eAAe,OAAO,eAAe,CAAC,CAA4B,CAAC;IAClG,MAAM,QAAQ,GAAI,MAAM,CAAC,cAAiD,IAAI,EAAE,CAAC;IACjF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,YAAY,SAAS,2BAA2B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;YAChH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAe,EACf,KAA8C;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,aAAa,CACX,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACrD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC1E,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,eAAe,OAAO,EAAE,EAAE;QACrD,MAAM,EAAE,KAAK;QACb,IAAI;KACL,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAe,EACf,OAAmD;IAEnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,aAAa,CACX,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACjB,aAAa,CACX,+IAA+I,CAChJ,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC;QACvC,aAAa,CACX,6EAA6E,OAAO,CAAC,cAAc,IAAI,EAAE,IAAI,CAC9G,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,eAAe,OAAO,EAAE,CAAC,CAA4B,CAAC;QACnF,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IAED,MAAM,QAAQ,CAAC,eAAe,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAe;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,MAAM,WAAW,OAAO,EAAE,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QACzG,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+export declare function show(): void;
+export declare function setUrl(url: string): void;

package/dist/commands/config.js

@@ -0,0 +1,17 @@
+import { getConfig, getCredentials, getCredentialsPath, saveConfig } from "../config.js";
+export function show() {
+    const config = getConfig();
+    const creds = getCredentials();
+    const out = {
+        apiUrl: config.apiUrl,
+        authenticated: !!creds?.apiKey,
+        apiKeyPrefix: creds?.apiKey ? `${creds.apiKey.slice(0, 11)}…` : null,
+        credentialsPath: getCredentialsPath(),
+    };
+    console.log(JSON.stringify(out, null, 2));
+}
+export function setUrl(url) {
+    saveConfig({ apiUrl: url });
+    console.log(`API URL set to ${url}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEzF,MAAM,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM;QAC9B,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QACpE,eAAe,EAAE,kBAAkB,EAAE;KACtC,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/dist/commands/projects.d.ts

@@ -0,0 +1,21 @@
+export declare function list(brandId: string): Promise<void>;
+export declare function get(brandId: string, projectId: string): Promise<void>;
+export declare function create(brandId: string, name: string, description?: string, externalId?: string): Promise<void>;
+export declare function update(brandId: string, projectId: string, patch: {
+    name?: string;
+    description?: string;
+    externalId?: string;
+}): Promise<void>;
+export declare function remove(brandId: string, projectId: string): Promise<void>;
+export declare function adsetsList(brandId: string, projectId: string): Promise<void>;
+export declare function adsetsGet(brandId: string, projectId: string, adSetId: string): Promise<void>;
+export declare function adsetsCreate(brandId: string, projectId: string, name: string, opts: {
+    description?: string;
+    ads?: string;
+}): Promise<void>;
+export declare function adsetsUpdate(brandId: string, projectId: string, adSetId: string, patch: {
+    name?: string;
+    description?: string;
+    ads?: string;
+}): Promise<void>;
+export declare function adsetsRemove(brandId: string, projectId: string, adSetId: string): Promise<void>;