@adkit.so/cli 1.0.0 → 1.0.2

package/package.json

@@ -1,20 +1,20 @@
 {
     "name": "@adkit.so/cli",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "description": "AdKit CLI — manage campaigns and accounts from the terminal",
     "type": "module",
     "bin": {
         "adkit": "dist/cli.js"
     },
-    "files": ["dist"],
+    "files": [
+        "dist"
+    ],
     "scripts": {
-        "build": "tsc"
-    },
-    "dependencies": {
-        "open": "^10.0.0"
+        "build": "esbuild src/cli.ts --bundle --format=esm --platform=node --target=node18 --outfile=dist/cli.js --banner:js='#!/usr/bin/env node'"
     },
     "devDependencies": {
         "@types/node": "^20.10.0",
+        "esbuild": "^0.25.12",
         "typescript": "^5.3.0"
     }
 }

package/dist/cli-utils.d.ts

@@ -1,11 +0,0 @@
-export type Flags = Record<string, string | string[] | true>;
-interface ParseOptions {
-    multi?: string[];
-}
-export declare function parseArgs(argv: string[], options?: ParseOptions): {
-    args: string[];
-    flags: Record<string, string | true | string[]>;
-};
-export declare function validateFlags(flags: Flags, allowed: string[], command: string): void;
-export declare function unwrapList(data: unknown): Record<string, unknown>[];
-export {};

package/dist/cli-utils.js

@@ -1,58 +0,0 @@
-import { CliError } from './errors.js';
-export function parseArgs(argv, options) {
-    const args = [];
-    const flags = {};
-    const multiSet = new Set(options?.multi);
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (!arg.startsWith('--')) {
-            args.push(arg);
-            continue;
-        }
-        const eqIdx = arg.indexOf('=');
-        let key;
-        let value;
-        if (eqIdx !== -1) {
-            key = arg.slice(2, eqIdx);
-            value = arg.slice(eqIdx + 1);
-        }
-        else {
-            key = arg.slice(2);
-            const next = argv[i + 1];
-            if (next && !next.startsWith('--')) {
-                value = next;
-                i++;
-            }
-            else
-                value = true;
-        }
-        if (multiSet.has(key) && typeof value === 'string') {
-            const existing = flags[key];
-            if (Array.isArray(existing))
-                existing.push(value);
-            else
-                flags[key] = [value];
-        }
-        else
-            flags[key] = value;
-    }
-    return { args, flags };
-}
-const GLOBAL_FLAGS = ['account', 'json', 'fields', 'publish', 'data', 'platform-overrides', 'force', 'project'];
-export function validateFlags(flags, allowed, command) {
-    const allAllowed = new Set([...GLOBAL_FLAGS, ...allowed]);
-    const unknown = Object.keys(flags).filter((k) => !allAllowed.has(k));
-    if (unknown.length)
-        throw new CliError('UNKNOWN_FLAG', `Unknown flag${unknown.length > 1 ? 's' : ''}: ${unknown.map((f) => `--${f}`).join(', ')}`, `Run: adkit ${command} --help`);
-}
-export function unwrapList(data) {
-    if (Array.isArray(data))
-        return data;
-    if (data && typeof data === 'object') {
-        const values = Object.values(data);
-        const arr = values.find((v) => Array.isArray(v));
-        if (arr)
-            return arr;
-    }
-    return [];
-}

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/client.d.ts

@@ -1,13 +0,0 @@
-export declare class AdkitClient {
-    private apiKey;
-    private baseUrl;
-    constructor({ apiKey, baseUrl }: {
-        apiKey: string;
-        baseUrl: string;
-    });
-    private request;
-    get(path: string): Promise<unknown>;
-    post(path: string, body?: unknown): Promise<unknown>;
-    patch(path: string, body?: unknown): Promise<unknown>;
-    delete(path: string): Promise<unknown>;
-}

package/dist/client.js

@@ -1,84 +0,0 @@
-import { CliError } from './errors.js';
-function isErrorResponse(value) {
-    return value != null && typeof value === 'object';
-}
-export class AdkitClient {
-    apiKey;
-    baseUrl;
-    constructor({ apiKey, baseUrl }) {
-        const isLocalhost = baseUrl.startsWith('http://localhost') || baseUrl.startsWith('http://127.0.0.1');
-        if (baseUrl.startsWith('http://') && !isLocalhost)
-            throw new Error('HTTPS is required — insecure HTTP base URLs are not allowed');
-        this.apiKey = apiKey;
-        this.baseUrl = baseUrl;
-    }
-    async request(method, path, body) {
-        const url = `${this.baseUrl}${path}`;
-        const headers = {
-            Authorization: `Bearer ${this.apiKey}`,
-            'Content-Type': 'application/json',
-        };
-        const init = { method, headers };
-        if (body !== undefined)
-            init.body = JSON.stringify(body);
-        let response;
-        try {
-            response = await fetch(url, init);
-        }
-        catch (err) {
-            if (err instanceof DOMException && err.name === 'AbortError')
-                throw new CliError('NETWORK_ERROR', 'Request timed out', 'Retry the command');
-            throw new CliError('NETWORK_ERROR', 'Network connection error — check your internet connection and try again. If using a custom base URL, verify `ADKIT_BASE_URL` is correct.', 'Check internet connection');
-        }
-        if (response.status === 204)
-            return undefined;
-        if (!response.ok) {
-            let serverMessage = '';
-            let dataMessage = '';
-            let retryable;
-            try {
-                const json = await response.json();
-                if (isErrorResponse(json)) {
-                    serverMessage = json.statusMessage ?? json.message ?? '';
-                    dataMessage = json.data?.message ?? '';
-                    retryable = json.data?.retryable;
-                }
-            }
-            catch {
-                // no parseable body
-            }
-            if (response.status === 401)
-                throw new CliError('INVALID_API_KEY', `Invalid or expired API key${serverMessage ? ` — ${serverMessage}` : ''}`, 'Run: adkit setup');
-            if (response.status === 429) {
-                const retryAfter = response.headers.get('Retry-After') ?? '60';
-                throw new CliError('RATE_LIMITED', serverMessage || 'Rate limit exceeded', `Wait ${retryAfter} seconds before retrying`);
-            }
-            if (response.status === 404) {
-                const fallback = `Not found: ${method} ${path} — the resource may have been deleted or the ID is wrong`;
-                throw new CliError('NOT_FOUND', serverMessage || fallback, 'Check the resource ID');
-            }
-            if (response.status >= 500) {
-                // H3/Nuxt sanitizes statusMessage on 5xx — prefer data.message (always set by normalizeError)
-                const errorMsg = dataMessage || serverMessage || `Server error (HTTP ${String(response.status)})`;
-                let suggestion;
-                if (retryable === true)
-                    suggestion = 'Retry in a few seconds';
-                throw new CliError('SERVER_ERROR', errorMsg, suggestion);
-            }
-            throw new CliError('SERVER_ERROR', serverMessage || `Request failed (HTTP ${String(response.status)})`);
-        }
-        return response.json();
-    }
-    async get(path) {
-        return this.request('GET', path);
-    }
-    async post(path, body) {
-        return this.request('POST', path, body);
-    }
-    async patch(path, body) {
-        return this.request('PATCH', path, body);
-    }
-    async delete(path) {
-        return this.request('DELETE', path);
-    }
-}

package/dist/commands/auth.d.ts

@@ -1,7 +0,0 @@
-interface LoginOptions {
-    baseUrl: string;
-    scope?: string[];
-}
-export declare function login({ baseUrl, scope }: LoginOptions): Promise<void>;
-export declare function logout(): void;
-export {};

package/dist/commands/auth.js

@@ -1,184 +0,0 @@
-import open from 'open';
-import { unlinkSync, existsSync } from 'node:fs';
-import { hostname } from 'node:os';
-import { writeConfig, readConfig, CONFIG_PATH } from '../config.js';
-import { AdkitClient } from '../client.js';
-const MAX_POLL_ATTEMPTS = 450; // 450 × 2s = 15 min — setup flow can take a while
-const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-function createSpinner() {
-    let frame = 0;
-    let timer = null;
-    let currentText = '';
-    return {
-        start(text) {
-            currentText = text;
-            frame = 0;
-            timer = setInterval(() => {
-                process.stderr.write(`\r${SPINNER_FRAMES[frame++ % SPINNER_FRAMES.length]} ${currentText}`);
-            }, 80);
-        },
-        update(text) {
-            currentText = text;
-        },
-        stop(finalText) {
-            if (timer)
-                clearInterval(timer);
-            process.stderr.write('\r\x1b[K'); // clear line
-            if (finalText)
-                console.log(finalText);
-        },
-    };
-}
-function printNextSteps(scope) {
-    const lines = ['Getting started:'];
-    if (scope?.includes('manage')) {
-        lines.push('  adkit meta accounts list       List your connected ad accounts');
-        lines.push('  adkit meta campaigns list      List campaigns');
-        lines.push('  adkit meta campaigns create    Create a campaign');
-        lines.push('  adkit drafts list              View pending drafts');
-    }
-    else
-        lines.push('  adkit setup manage             Connect Meta Ads');
-    lines.push('  adkit --help                   See all commands');
-    lines.push('');
-    console.log(lines.join('\n'));
-}
-async function detectDefaultAccounts(baseUrl, apiKey) {
-    try {
-        const client = new AdkitClient({ apiKey, baseUrl });
-        const data = (await client.get('/manage/status'));
-        const config = readConfig();
-        if (!config?.selectedProject || !config.projects)
-            return;
-        const project = config.projects[config.selectedProject];
-        if (!project)
-            return;
-        let changed = false;
-        const metaAccounts = data.platforms?.meta?.accounts;
-        if (metaAccounts?.length === 1) {
-            project.defaultMetaAccount = metaAccounts[0].id;
-            changed = true;
-            console.log(`Default Meta account: ${metaAccounts[0].name} (${metaAccounts[0].id})`);
-        }
-        const googleAccounts = data.platforms?.google?.accounts;
-        if (googleAccounts?.length === 1) {
-            project.defaultGoogleAccount = googleAccounts[0].id;
-            changed = true;
-            console.log(`Default Google account: ${googleAccounts[0].name} (${googleAccounts[0].id})`);
-        }
-        if (changed)
-            writeConfig({ projects: config.projects });
-    }
-    catch {
-        // Non-critical — skip silently if account detection fails
-    }
-}
-export async function login({ baseUrl, scope }) {
-    const spinner = createSpinner();
-    // Step 1: Create CLI session
-    spinner.start('Connecting to AdKit...');
-    let createResponse;
-    try {
-        createResponse = await fetch(`${baseUrl}/auth/cli-session`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ src: 'cli', hostname: hostname(), scope: scope && scope.length > 0 ? scope : undefined }),
-        });
-    }
-    catch {
-        spinner.stop();
-        throw new Error('Network connection failed — check your internet connection');
-    }
-    if (!createResponse.ok) {
-        spinner.stop();
-        let msg = 'Failed to create session';
-        try {
-            const errData = (await createResponse.json());
-            if (errData.message)
-                msg = errData.message;
-        }
-        catch {
-            // no parseable body
-        }
-        throw new Error(msg);
-    }
-    const createData = (await createResponse.json());
-    const sessionId = createData.session.sessionId;
-    const rawUrl = createData.session.url;
-    // Step 2: Open browser
-    const origin = new URL(baseUrl).origin;
-    const sessionUrl = rawUrl.startsWith('http') ? rawUrl : `${origin}${rawUrl}`;
-    await open(sessionUrl);
-    spinner.stop(`✓ Browser opened — complete setup at ${sessionUrl}`);
-    // Step 3: Poll until complete
-    spinner.start('Waiting for setup to complete...');
-    let projects;
-    let legacyApiKey;
-    for (let attempt = 0; attempt < MAX_POLL_ATTEMPTS; attempt++) {
-        let pollResponse;
-        try {
-            pollResponse = await fetch(`${baseUrl}/auth/cli-session/${sessionId}`, {
-                method: 'GET',
-            });
-        }
-        catch {
-            spinner.stop();
-            throw new Error('Network connection failed during polling');
-        }
-        if (!pollResponse.ok) {
-            spinner.stop();
-            if (pollResponse.status === 404)
-                throw new Error('Session not found or expired');
-            throw new Error(`Poll failed with status ${pollResponse.status}`);
-        }
-        let pollData;
-        try {
-            pollData = (await pollResponse.json());
-        }
-        catch {
-            continue;
-        }
-        const status = pollData.session?.status;
-        if (status === 'complete') {
-            projects = pollData.session.projects;
-            legacyApiKey = pollData.session.apiKey;
-            break;
-        }
-        if (status === 'expired') {
-            spinner.stop();
-            throw new Error('Session expired — timed out waiting for authentication');
-        }
-        await new Promise((r) => setTimeout(r, 2000));
-    }
-    spinner.stop();
-    if (!projects && !legacyApiKey)
-        throw new Error('Login timed out — max poll attempts exceeded');
-    // Step 4: Write config
-    if (projects && projects.length > 0) {
-        const projectsMap = {};
-        for (const p of projects)
-            projectsMap[p.id] = { name: p.name, apiKey: p.apiKey };
-        writeConfig({
-            projects: projectsMap,
-            selectedProject: projects[0].id,
-            apiKey: projects[0].apiKey,
-        });
-        console.log('\n✅ AdKit is configured!\n');
-        const names = projects.map((p) => `  • ${p.name}`).join('\n');
-        console.log(`Projects:\n${names}\n`);
-        // Auto-detect default ad accounts
-        if (scope?.includes('manage'))
-            await detectDefaultAccounts(baseUrl, projects[0].apiKey);
-        printNextSteps(scope);
-    }
-    else {
-        writeConfig({ apiKey: legacyApiKey });
-        console.log('\n✅ AdKit is configured!\n');
-        printNextSteps(scope);
-    }
-}
-export function logout() {
-    if (existsSync(CONFIG_PATH))
-        unlinkSync(CONFIG_PATH);
-    console.log('Logged out — API key removed.');
-}

package/dist/commands/drafts.d.ts

@@ -1,6 +0,0 @@
-import type { AdkitClient } from '../client.js';
-import { type Flags } from '../cli-utils.js';
-export declare function listDrafts(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function getDraft(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function publishDraft(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function deleteDraft(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;

package/dist/commands/drafts.js

@@ -1,36 +0,0 @@
-import { validateFlags } from '../cli-utils.js';
-import { CliError } from '../errors.js';
-function requireArg(args, index, label, hint) {
-    const val = args[index];
-    if (!val) {
-        throw new CliError('MISSING_ARGUMENT', `Missing required argument: \`<${label}>\``, hint);
-    }
-    return val;
-}
-function queryString(params) {
-    const entries = Object.entries(params).filter((e) => e[1] !== undefined);
-    if (entries.length === 0)
-        return '';
-    return '?' + entries.map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join('&');
-}
-const DRAFT_LIST_FLAGS = ['platform', 'limit', 'offset'];
-export async function listDrafts(client, _args, flags) {
-    validateFlags(flags, DRAFT_LIST_FLAGS, 'manage drafts list');
-    const platform = typeof flags.platform === 'string' ? flags.platform : undefined;
-    const limit = typeof flags.limit === 'string' ? flags.limit : undefined;
-    const offset = typeof flags.offset === 'string' ? flags.offset : undefined;
-    const qs = queryString({ platform, limit, offset });
-    return client.get(`/manage/drafts${qs}`);
-}
-export async function getDraft(client, args, _flags) {
-    const id = requireArg(args, 0, 'draft-id', 'Run: adkit drafts get <draft-id>');
-    return client.get(`/manage/drafts/${id}`);
-}
-export async function publishDraft(client, args, _flags) {
-    const id = requireArg(args, 0, 'draft-id', 'Run: adkit drafts publish <draft-id>');
-    return client.post(`/manage/drafts/${id}/publish`);
-}
-export async function deleteDraft(client, args, _flags) {
-    const id = requireArg(args, 0, 'draft-id', 'Run: adkit drafts delete <draft-id>');
-    return client.delete(`/manage/drafts/${id}`);
-}

package/dist/commands/meta.d.ts

@@ -1,28 +0,0 @@
-import type { AdkitClient } from '../client.js';
-import { type Flags } from '../cli-utils.js';
-export declare function listAccounts(client: AdkitClient, _args: string[], _flags: Flags): Promise<unknown>;
-export declare function connectAccount(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function disconnectAccount(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function listPages(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function listPixels(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function listCampaigns(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function createCampaign(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function updateCampaign(client: AdkitClient, args: string[], flags: Flags): Promise<unknown>;
-export declare function deleteCampaign(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function listAdSets(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function createAdSet(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function updateAdSet(client: AdkitClient, args: string[], flags: Flags): Promise<unknown>;
-export declare function deleteAdSet(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function listAds(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function createAd(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function updateAd(client: AdkitClient, args: string[], flags: Flags): Promise<unknown>;
-export declare function deleteAd(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function createCreative(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function updateCreative(client: AdkitClient, args: string[], flags: Flags): Promise<unknown>;
-export declare function deleteCreative(client: AdkitClient, args: string[], _flags: Flags): Promise<unknown>;
-export declare function searchInterests(client: AdkitClient, args: string[], flags: Flags): Promise<{
-    results: unknown[];
-}>;
-export declare function uploadMedia(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function listMedia(client: AdkitClient, _args: string[], flags: Flags): Promise<unknown>;
-export declare function deleteMedia(client: AdkitClient, args: string[], flags: Flags): Promise<unknown>;