@bussolabs/closeyourit-cli 0.0.3 → 0.0.5

package/dist/commands/tickets/comment-delete.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base';
+export default class TicketsCommentDelete extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'comment-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/comment-delete.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class TicketsCommentDelete extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static description = 'Delete a comment from a ticket (author, or with tickets.comment.delete_any)';
+    static examples = [
+        '<%= config.bin %> tickets comment-delete <ticket-id> --project acme-api --comment-id <id> --confirm',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        'comment-id': core_1.Flags.string({ description: 'Comment id to delete', required: true }),
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the irreversible deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsCommentDelete);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm (the action is irreversible).', { exit: 2 });
+        }
+        const projectId = await this.resolveProjectId(flags.project);
+        await this.api.delete(`/cli/v1/projects/${projectId}/tickets/${args.id}/comments/${flags['comment-id']}`);
+        if (!this.jsonEnabled())
+            this.log(`Deleted comment ${flags['comment-id']}`);
+        return { deleted: flags['comment-id'] };
+    }
+}
+exports.default = TicketsCommentDelete;

package/dist/commands/tickets/comment.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base';
+export default class TicketsComment extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        body: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/comment.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class TicketsComment extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static description = 'Add a comment to a ticket';
+    static examples = [
+        '<%= config.bin %> tickets comment <ticket-id> --project acme-api --body "Reproduced on staging"',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        body: core_1.Flags.string({ description: 'Comment body', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsComment);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.post(`/cli/v1/projects/${projectId}/tickets/${args.id}/comments`, { body: flags.body });
+        if (!this.jsonEnabled()) {
+            this.log('Comment added:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsComment;

package/dist/commands/tickets/delete.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base';
+export default class TicketsDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/delete.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class TicketsDelete extends base_1.BaseCommand {
+    static description = 'Delete a ticket (irreversible)';
+    static examples = ['<%= config.bin %> tickets delete <ticket-id> --project acme-api --confirm'];
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the irreversible deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsDelete);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm (the action is irreversible).', { exit: 2 });
+        }
+        const projectId = await this.resolveProjectId(flags.project);
+        await this.api.delete(`/cli/v1/projects/${projectId}/tickets/${args.id}`);
+        if (!this.jsonEnabled())
+            this.log(`Deleted ticket ${args.id}`);
+        return { deleted: args.id };
+    }
+}
+exports.default = TicketsDelete;

package/dist/commands/tickets/detach.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base';
+export default class TicketsDetach extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        attachment: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/detach.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class TicketsDetach extends base_1.BaseCommand {
+    static description = 'Remove an attachment from a ticket (irreversible)';
+    static examples = [
+        '<%= config.bin %> tickets detach <ticket-id> --project acme-api --attachment <attachment-id> --confirm',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        attachment: core_1.Flags.string({ description: 'Attachment id to remove', required: true }),
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the irreversible deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsDetach);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm (the action is irreversible).', { exit: 2 });
+        }
+        const projectId = await this.resolveProjectId(flags.project);
+        await this.api.delete(`/cli/v1/projects/${encodeURIComponent(projectId)}/tickets/${encodeURIComponent(args.id)}/attachments/${encodeURIComponent(flags.attachment)}`);
+        if (!this.jsonEnabled())
+            this.log(`Removed attachment ${flags.attachment} from ticket ${args.id}`);
+        return { detached: flags.attachment, ticket: args.id };
+    }
+}
+exports.default = TicketsDetach;

package/dist/commands/tickets/milestone.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base';
+export default class TicketsMilestone extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'milestone-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        clear: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/milestone.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class TicketsMilestone extends base_1.BaseCommand {
+    // PUT .../milestone sets; DELETE .../milestone removes. --clear picks the DELETE verb.
+    static description = 'Set or clear a ticket milestone (--clear)';
+    static examples = [
+        '<%= config.bin %> tickets milestone <ticket-id> --project acme-api --milestone-id <milestone-id>',
+        '<%= config.bin %> tickets milestone <ticket-id> --project acme-api --clear',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        'milestone-id': core_1.Flags.string({ description: 'Milestone id (of this project)', exclusive: ['clear'] }),
+        clear: core_1.Flags.boolean({ description: 'Remove the current milestone (DELETE)', exclusive: ['milestone-id'] }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsMilestone);
+        if (!flags.clear && flags['milestone-id'] === undefined) {
+            this.error('Provide --milestone-id <id> or --clear.', { exit: 2 });
+        }
+        const projectId = await this.resolveProjectId(flags.project);
+        const path = `/cli/v1/projects/${projectId}/tickets/${args.id}/milestone`;
+        const res = flags.clear
+            ? await this.api.delete(path)
+            : await this.api.put(path, { milestone_id: flags['milestone-id'] });
+        if (!this.jsonEnabled()) {
+            this.log(flags.clear ? `Ticket ${args.id} milestone cleared:` : `Ticket ${args.id} milestone set:`);
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsMilestone;

package/dist/commands/tickets/status.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base';
+export default class TicketsStatus extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'status-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/status.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class TicketsStatus extends base_1.BaseCommand {
+    static description = 'Change a ticket status';
+    static examples = ['<%= config.bin %> tickets status <ticket-id> --project acme-api --status-id <status-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        'status-id': core_1.Flags.string({ description: 'Target status lookup id', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsStatus);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/tickets/${args.id}/status`, { status_id: flags['status-id'] });
+        if (!this.jsonEnabled()) {
+            this.log(`Ticket ${args.id} status updated:`);
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsStatus;

package/dist/commands/tickets/unvote.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class TicketsUnvote extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/unvote.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class TicketsUnvote extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static description = 'Remove your upvote from a ticket (idempotent)';
+    static examples = ['<%= config.bin %> tickets unvote <ticket-id> --project acme-api'];
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(TicketsUnvote);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.delete(`/cli/v1/projects/${projectId}/tickets/${args.id}/vote`);
+        if (!this.jsonEnabled()) {
+            const p = res.data ?? {};
+            const count = p.votes_count;
+            this.log(`Removed vote from ticket ${args.id}${count === undefined ? '' : ` (${count} votes)`}`);
+        }
+        return res;
+    }
+}
+exports.default = TicketsUnvote;

package/dist/commands/tickets/update.d.ts

@@ -0,0 +1,25 @@
+import { BaseCommand } from '../../base';
+export default class TicketsUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        kind: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        weight: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'step-given': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'step-when': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'step-then': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'step-expected': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'status-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'priority-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'assignee-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'milestone-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'platform-id': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/update.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class TicketsUpdate extends base_1.BaseCommand {
+    // PUT /cli/v1/projects/:p/tickets/:id maps to Ticketing::UpdateTicket, a full replace:
+    // fields you omit are cleared server-side. Pass the complete desired state, not a partial patch.
+    static description = 'Update a ticket (full replace — fields you omit are cleared server-side)';
+    static examples = [
+        '<%= config.bin %> tickets update <ticket-id> --project acme-api --title "New title"',
+        '<%= config.bin %> tickets update <ticket-id> -p acme-api --title "Login bug" --kind bug --step-given "logged out" --step-when "I submit" --step-then "it 500s" --step-expected "dashboard loads"',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static flags = {
+        ...base_1.projectFlag,
+        title: core_1.Flags.string({ description: 'Ticket title' }),
+        kind: core_1.Flags.string({ description: 'Ticket kind (bug, feature, improvement)' }),
+        description: core_1.Flags.string({ description: 'Free-form description' }),
+        weight: core_1.Flags.string({ description: 'Story points (positive integer)' }),
+        'step-given': core_1.Flags.string({ description: 'Given (precondition)' }),
+        'step-when': core_1.Flags.string({ description: 'When (action)' }),
+        'step-then': core_1.Flags.string({ description: 'Then (outcome)' }),
+        'step-expected': core_1.Flags.string({ description: 'Expected result' }),
+        'status-id': core_1.Flags.string({ description: 'Status lookup id' }),
+        'priority-id': core_1.Flags.string({ description: 'Priority lookup id' }),
+        'assignee-id': core_1.Flags.string({ description: 'Assignee account id' }),
+        'milestone-id': core_1.Flags.string({ description: 'Milestone id (of this project)' }),
+        'platform-id': core_1.Flags.string({ description: 'Affected platform id (repeatable)', multiple: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TicketsUpdate);
+        const projectId = await this.resolveProjectId(flags.project);
+        const body = {};
+        if (flags.title !== undefined)
+            body.title = flags.title;
+        if (flags.kind !== undefined)
+            body.kind = flags.kind;
+        if (flags.description !== undefined)
+            body.description = flags.description;
+        if (flags.weight !== undefined)
+            body.weight = flags.weight;
+        if (flags['step-given'] !== undefined)
+            body.step_given = flags['step-given'];
+        if (flags['step-when'] !== undefined)
+            body.step_when = flags['step-when'];
+        if (flags['step-then'] !== undefined)
+            body.step_then = flags['step-then'];
+        if (flags['step-expected'] !== undefined)
+            body.step_expected = flags['step-expected'];
+        if (flags['status-id'] !== undefined)
+            body.status_id = flags['status-id'];
+        if (flags['priority-id'] !== undefined)
+            body.priority_id = flags['priority-id'];
+        if (flags['assignee-id'] !== undefined)
+            body.assignee_id = flags['assignee-id'];
+        if (flags['milestone-id'] !== undefined)
+            body.milestone_id = flags['milestone-id'];
+        if (flags['platform-id'] !== undefined)
+            body.platform_ids = flags['platform-id'];
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/tickets/${args.id}`, body);
+        if (!this.jsonEnabled()) {
+            this.log('Ticket updated:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = TicketsUpdate;

package/dist/commands/tickets/vote.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class TicketsVote extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/tickets/vote.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class TicketsVote extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+    };
+    static description = 'Upvote a ticket (idempotent)';
+    static examples = ['<%= config.bin %> tickets vote <ticket-id> --project acme-api'];
+    static flags = { ...base_1.projectFlag };
+    async run() {
+        const { args, flags } = await this.parse(TicketsVote);
+        const projectId = await this.resolveProjectId(flags.project);
+        const res = await this.api.put(`/cli/v1/projects/${projectId}/tickets/${args.id}/vote`);
+        if (!this.jsonEnabled()) {
+            const p = res.data ?? {};
+            const count = p.votes_count;
+            this.log(`Voted ticket ${args.id}${count === undefined ? '' : ` (${count} votes)`}`);
+        }
+        return res;
+    }
+}
+exports.default = TicketsVote;

package/dist/lib/api.d.ts

@@ -15,11 +15,28 @@ export interface Envelope<T = unknown> {
     data: T;
     meta?: Record<string, unknown>;
 }
+/** A single file part for a multipart upload. */
+export interface UploadFile {
+    /** Multipart field name (e.g. "files[]"). */
+    field: string;
+    filename: string;
+    data: Blob;
+}
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
 export declare class CliApi {
     private readonly config;
     constructor(config: CliConfig);
     request<T = unknown>(method: HttpMethod, path: string, opts?: RequestOptions): Promise<Envelope<T>>;
+    /**
+     * Upload one or more files as multipart/form-data.
+     * The boundary Content-Type is derived by fetch from the FormData body — never set it by hand.
+     */
+    upload<T = unknown>(method: 'POST' | 'PUT', path: string, files: UploadFile[], opts?: RequestOptions): Promise<Envelope<T>>;
+    private resolveUrl;
+    /** Build the shared Accept + Authorization headers; throws (before any fetch) if an authed call has no token. */
+    private authHeaders;
+    /** Parse the response body and map the error envelope to an ApiRequestError. Shared by request() and upload(). */
+    private handleResponse;
     get<T = unknown>(path: string, opts?: RequestOptions): Promise<Envelope<T>>;
     post<T = unknown>(path: string, body?: unknown, opts?: RequestOptions): Promise<Envelope<T>>;
     put<T = unknown>(path: string, body?: unknown, opts?: RequestOptions): Promise<Envelope<T>>;

package/dist/lib/api.js

@@ -22,18 +22,9 @@ class CliApi {
         this.config = config;
     }
     async request(method, path, opts = {}) {
-        const auth = opts.auth !== false;
-        const headers = {
-            Accept: 'application/json',
-            'Content-Type': 'application/json',
-        };
-        if (auth) {
-            if (!this.config.token) {
-                throw new ApiRequestError(401, error_codes_1.ErrorCodes.Auth.notLoggedIn, 'Not logged in. Run "closeyourit login".');
-            }
-            headers.Authorization = `Bearer ${this.config.token}`;
-        }
-        const url = this.config.apiUrl.replace(/\/+$/, '') + path;
+        const headers = this.authHeaders(opts.auth !== false);
+        headers['Content-Type'] = 'application/json';
+        const url = this.resolveUrl(path);
         let res;
         try {
             res = await fetch(url, {
@@ -45,6 +36,43 @@ class CliApi {
         catch (err) {
             throw new ApiRequestError(0, error_codes_1.ErrorCodes.Network.requestFailed, `Request to ${url} failed: ${err.message}`);
         }
+        return this.handleResponse(res);
+    }
+    /**
+     * Upload one or more files as multipart/form-data.
+     * The boundary Content-Type is derived by fetch from the FormData body — never set it by hand.
+     */
+    async upload(method, path, files, opts = {}) {
+        const headers = this.authHeaders(opts.auth !== false);
+        const form = new FormData();
+        for (const file of files)
+            form.append(file.field, file.data, file.filename);
+        const url = this.resolveUrl(path);
+        let res;
+        try {
+            res = await fetch(url, { method, headers, body: form });
+        }
+        catch (err) {
+            throw new ApiRequestError(0, error_codes_1.ErrorCodes.Network.requestFailed, `Request to ${url} failed: ${err.message}`);
+        }
+        return this.handleResponse(res);
+    }
+    resolveUrl(path) {
+        return this.config.apiUrl.replace(/\/+$/, '') + path;
+    }
+    /** Build the shared Accept + Authorization headers; throws (before any fetch) if an authed call has no token. */
+    authHeaders(auth) {
+        const headers = { Accept: 'application/json' };
+        if (auth) {
+            if (!this.config.token) {
+                throw new ApiRequestError(401, error_codes_1.ErrorCodes.Auth.notLoggedIn, 'Not logged in. Run "closeyourit login".');
+            }
+            headers.Authorization = `Bearer ${this.config.token}`;
+        }
+        return headers;
+    }
+    /** Parse the response body and map the error envelope to an ApiRequestError. Shared by request() and upload(). */
+    async handleResponse(res) {
         const text = await res.text();
         let json = {};
         if (text.length > 0) {