@hesed/conni 0.1.0

package/dist/commands/conni/content/attachment-download.js

@@ -0,0 +1,44 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { action } from '@oclif/core/ux';
+import { readConfig } from '../../../config.js';
+import { clearClients, downloadAttachment } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentDownloadAttachment extends Command {
+    static args = {
+        attachmentId: Args.string({ description: 'Attachment ID', required: true }),
+        outputPath: Args.string({ description: 'Output file path', required: false }),
+    };
+    static description = 'Download attachment from Confluence content';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> att12345',
+        '<%= config.bin %> <%= command.id %> att12345 ./document.pdf',
+    ];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentDownloadAttachment);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        if (!args.outputPath) {
+            args.outputPath = process.cwd();
+        }
+        action.start(`Downloading attachment "${args.attachmentId}" to ""`);
+        const result = await downloadAttachment(config.auth, args.attachmentId, args.outputPath);
+        clearClients();
+        if (result.success) {
+            action.stop('✓ Successfully uploaded');
+        }
+        else {
+            action.stop('✗ Upload failed');
+        }
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/attachment.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class ContentAttachment extends Command {
+    static args: {
+        pageId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        file: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/attachment.js

@@ -0,0 +1,40 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { action } from '@oclif/core/ux';
+import { readConfig } from '../../../config.js';
+import { addAttachment, clearClients } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentAttachment extends Command {
+    /* eslint-disable perfectionist/sort-objects */
+    static args = {
+        pageId: Args.string({ description: 'Page ID', required: true }),
+        file: Args.string({ description: 'Path to the file to upload', required: true }),
+    };
+    /* eslint-enable perfectionist/sort-objects */
+    static description = 'Add attachment to Confluence content';
+    static examples = ['<%= config.bin %> <%= command.id %> 123456 ./document.pdf'];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentAttachment);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        action.start(`Uploading attachment "${args.file}" to page ${args.pageId}`);
+        const result = await addAttachment(config.auth, args.pageId, args.file);
+        clearClients();
+        if (result.success) {
+            action.stop('✓ Successfully uploaded');
+        }
+        else {
+            action.stop('✗ Upload failed');
+        }
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/comment-delete.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class ContentDeleteComment extends Command {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/comment-delete.js

@@ -0,0 +1,29 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, deleteComment } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentDeleteComment extends Command {
+    static args = {
+        id: Args.string({ description: 'Comment ID to delete', required: true }),
+    };
+    static description = 'Delete comment from Confluence content';
+    static examples = ['<%= config.bin %> <%= command.id %> 1544224770'];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentDeleteComment);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await deleteComment(config.auth, args.id);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/comment-update.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class ContentUpdateComment extends Command {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        body: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/comment-update.js

@@ -0,0 +1,35 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, updateComment } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentUpdateComment extends Command {
+    /* eslint-disable perfectionist/sort-objects */
+    static args = {
+        id: Args.string({ description: 'Comment ID to update', required: true }),
+        body: Args.string({ description: 'Comment in Markdown format', required: true }),
+    };
+    /* eslint-enable perfectionist/sort-objects */
+    static description = 'Update a comment';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> 1544224770 "\n# Header\n## Sub-header\n- Item 1\n- Item 2\n```bash\nls -a\n```"',
+        '<%= config.bin %> <%= command.id %> 1544224770 "$(cat content.md)"',
+    ];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentUpdateComment);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await updateComment(config.auth, args.id, args.body);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/comment.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class ContentAddComment extends Command {
+    static args: {
+        pageId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        body: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/comment.js

@@ -0,0 +1,35 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { addComment, clearClients } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentAddComment extends Command {
+    /* eslint-disable perfectionist/sort-objects */
+    static args = {
+        pageId: Args.string({ description: 'Page ID', required: true }),
+        body: Args.string({ description: 'Comment in Markdown format', required: true }),
+    };
+    /* eslint-enable perfectionist/sort-objects */
+    static description = 'Add comment to Confluence content';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> 123456 "\n# Header\n## Sub-header\n- Item 1\n- Item 2\n```bash\nls -a\n```"',
+        '<%= config.bin %> <%= command.id %> 123456 "$(cat content.md)"',
+    ];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentAddComment);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await addComment(config.auth, args.pageId, args.body);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/create.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class ContentCreate extends Command {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        fields: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/create.js

@@ -0,0 +1,50 @@
+import { Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, createPage } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentCreate extends Command {
+    static args = {};
+    static description = 'Create a new Confluence page';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --fields spaceKey="DEV" title="New title" body="New description" status="draft"',
+        '<%= config.bin %> <%= command.id %> --fields spaceKey="DEV" title="New title" body=\'\n# Header\n## Sub-header\n- Item 1\n- Item 2\n```bash\nls -a\n```\'',
+    ];
+    static flags = {
+        fields: Flags.string({
+            description: 'Minimum fields required: spaceKey, title & body',
+            multiple: true,
+            required: true,
+            summary: 'Content fields in key=value format',
+        }),
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(ContentCreate);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const fields = {};
+        if (flags.fields) {
+            for (const field of flags.fields) {
+                const [key, ...valueParts] = field.split('=');
+                const value = valueParts.join('=');
+                fields[key] = value;
+            }
+        }
+        const requiredFields = ['spaceKey', 'title', 'body'];
+        for (const required of requiredFields) {
+            if (!fields[required]) {
+                this.error(`Required field "${required}" is missing`);
+            }
+        }
+        const result = await createPage(config.auth, fields);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/delete.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class ContentDelete extends Command {
+    static args: {
+        pageId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/delete.js

@@ -0,0 +1,29 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, deleteContent } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentDelete extends Command {
+    static args = {
+        pageId: Args.string({ description: 'Page ID to delete', required: true }),
+    };
+    static description = 'Delete a Confluence page';
+    static examples = ['<%= config.bin %> <%= command.id %> 1543634992'];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentDelete);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await deleteContent(config.auth, args.pageId);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/get.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class ContentGet extends Command {
+    static args: {
+        pageId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/get.js

@@ -0,0 +1,29 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, getContent } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentGet extends Command {
+    static args = {
+        pageId: Args.string({ description: 'Page ID', required: true }),
+    };
+    static description = 'Get details of a Confluence content';
+    static examples = ['<%= config.bin %> <%= command.id %> 1544060948'];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentGet);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await getContent(config.auth, args.pageId);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/search.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class ContentSearch extends Command {
+    static args: {
+        cql: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        expand: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/search.js

@@ -0,0 +1,34 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, searchContents } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class ContentSearch extends Command {
+    static args = {
+        cql: Args.string({ description: 'CQL expression', required: true }),
+    };
+    static description = 'Search for Confluence contents using CQL';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> \'space=DEV AND title ~ "Implement email OTP login" AND creator=currentUser()\'',
+        "<%= config.bin %> <%= command.id %> 'created > startOfMonth()' --limit=5 --expand=body,version",
+    ];
+    static flags = {
+        expand: Flags.string({ description: 'Properties of the content to expand', required: false }),
+        limit: Flags.integer({ description: 'Maximum number of contents per page', required: false }),
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentSearch);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await searchContents(config.auth, args.cql, flags.limit, flags.expand ? flags.expand.split(',') : undefined);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/content/update.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class ContentUpdate extends Command {
+    static args: {
+        pageId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        fields: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/content/update.js

@@ -0,0 +1,35 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, updateContent } from '../../../conni/conni-client.js';
+export default class ContentUpdate extends Command {
+    static args = {
+        pageId: Args.string({ description: 'Page ID', required: true }),
+    };
+    static description = 'Update an existing Confluence content';
+    static examples = [
+        "<%= config.bin %> <%= command.id %> 1076199489 --fields title='New summary' body='New description'",
+        "<%= config.bin %> <%= command.id %> 1076199489 --fields body='\n# Header\n## Sub-header\n- Item 1\n- Item 2\n```bash\nls -a\n```'",
+        '<%= config.bin %> <%= command.id %> 1076199489 --fields body="$(cat content.md)"',
+    ];
+    static flags = {
+        fields: Flags.string({ description: 'Content fields to update in key=value format', multiple: true, required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ContentUpdate);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const fields = {};
+        if (flags.fields) {
+            for (const field of flags.fields) {
+                const [key, ...valueParts] = field.split('=');
+                const value = valueParts.join('=');
+                fields[key] = value;
+            }
+        }
+        const result = await updateContent(config.auth, args.pageId, fields);
+        clearClients();
+        this.logJson(result);
+    }
+}

package/dist/commands/conni/space/get.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class SpaceGet extends Command {
+    static args: {
+        spaceKey: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/space/get.js

@@ -0,0 +1,29 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, getSpace } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class SpaceGet extends Command {
+    static args = {
+        spaceKey: Args.string({ description: 'Space key', required: true }),
+    };
+    static description = 'Get details of a Confluence space';
+    static examples = ['<%= config.bin %> <%= command.id %> DEV'];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(SpaceGet);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await getSpace(config.auth, args.spaceKey);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/commands/conni/space/list.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class SpaceList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        toon: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/conni/space/list.js

@@ -0,0 +1,26 @@
+import { Command, Flags } from '@oclif/core';
+import { readConfig } from '../../../config.js';
+import { clearClients, listSpaces } from '../../../conni/conni-client.js';
+import { formatAsToon } from '../../../format.js';
+export default class SpaceList extends Command {
+    static description = 'List all Confluence spaces';
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    static flags = {
+        toon: Flags.boolean({ description: 'Format output as toon', required: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(SpaceList);
+        const config = await readConfig(this.config.configDir, this.log.bind(this));
+        if (!config) {
+            return;
+        }
+        const result = await listSpaces(config.auth);
+        clearClients();
+        if (flags.toon) {
+            this.log(formatAsToon(result));
+        }
+        else {
+            this.logJson(result);
+        }
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+interface AuthConfig {
+    apiToken: string;
+    email: string;
+    host: string;
+}
+interface Config {
+    auth: AuthConfig;
+}
+export declare function readConfig(configDir: string, log: (message: string) => void): Promise<Config | undefined>;
+export {};

package/dist/config.js

@@ -0,0 +1,18 @@
+import { default as fs } from 'fs-extra';
+import { default as path } from 'node:path';
+export async function readConfig(configDir, log) {
+    const configPath = path.join(configDir, 'conni-config.json');
+    try {
+        return await fs.readJSON(configPath);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        if (msg.toLowerCase().includes('no such file or directory')) {
+            log('Missing authentication config');
+        }
+        else {
+            log(msg);
+        }
+        return undefined;
+    }
+}