@wavyx/pdcli 0.2.0 → 0.3.0

package/src/commands/note/delete.js

@@ -0,0 +1,39 @@
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import BaseCommand from '../../base-command.js'
+import { confirmAction } from '../../lib/confirm.js'
+import { CliError } from '../../lib/errors.js'
+
+export default class NoteDeleteCommand extends BaseCommand {
+  static description = 'Delete a note'
+
+  static examples = [
+    '<%= config.bin %> note delete 5',
+    '<%= config.bin %> note delete 5 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Note ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(NoteDeleteCommand)
+
+    const ok = await confirmAction(`Delete note ${args.id}?`, flags.yes)
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(`/api/v1/notes/${args.id}`)
+    this.log(chalk.green(`Deleted note ${args.id}`))
+  }
+}

package/src/commands/note/get.js

@@ -0,0 +1,26 @@
+import { Args } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { outputRecord } from '../../lib/entity-view.js'
+
+export default class NoteGetCommand extends BaseCommand {
+  static description = 'Get a note by ID'
+
+  static examples = [
+    '<%= config.bin %> note get 5',
+    '<%= config.bin %> note get 5 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Note ID' }),
+  }
+
+  async run() {
+    const { args } = await this.parse(NoteGetCommand)
+    const body = await this.apiClient.get(`/api/v1/notes/${args.id}`)
+    await outputRecord(this, body.data)
+  }
+}

package/src/commands/note/list.js

@@ -0,0 +1,49 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { collectPages } from '../../lib/pagination.js'
+
+const columns = {
+  id: { header: 'ID' },
+  content: {
+    header: 'Content',
+    get: (row) => (row.content ?? '').slice(0, 60),
+  },
+  deal_id: { header: 'Deal' },
+  person_id: { header: 'Person' },
+  org_id: { header: 'Org' },
+  add_time: { header: 'Created' },
+}
+
+export default class NoteListCommand extends BaseCommand {
+  static description = 'List notes'
+
+  static examples = [
+    '<%= config.bin %> note list',
+    '<%= config.bin %> note list --deal 42 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    deal: Flags.integer({ description: 'Filter by deal ID' }),
+    person: Flags.integer({ description: 'Filter by person ID' }),
+    org: Flags.integer({ description: 'Filter by organization ID' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(NoteListCommand)
+    const limit = flags.limit ?? 100
+
+    const query = {
+      deal_id: flags.deal,
+      person_id: flags.person,
+      org_id: flags.org,
+      limit: Math.min(limit, 100),
+    }
+
+    const items = await collectPages(
+      this.apiClient.pageV1('/api/v1/notes', query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}

package/src/commands/note/update.js

@@ -0,0 +1,45 @@
+import { Args, Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { outputRecord } from '../../lib/entity-view.js'
+import { CliError } from '../../lib/errors.js'
+
+export default class NoteUpdateCommand extends BaseCommand {
+  static description = 'Update a note (only provided fields change)'
+
+  static examples = [
+    '<%= config.bin %> note update 5 --content "Revised note"',
+    '<%= config.bin %> note update 5 --body \'{"pinned_to_deal_flag":1}\'',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Note ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    content: Flags.string({ description: 'Note content' }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(NoteUpdateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        content: flags.content,
+      },
+      rawBody: flags.body,
+    })
+
+    if (Object.keys(body).length === 0) {
+      throw new CliError(
+        'Nothing to update — pass at least one field flag, --field, or --body',
+        { exitCode: 64 },
+      )
+    }
+
+    const res = await this.apiClient.put(`/api/v1/notes/${args.id}`, { body })
+    await outputRecord(this, res.data)
+  }
+}

package/src/commands/pipeline/get.js

@@ -0,0 +1,26 @@
+import { Args } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { outputRecord } from '../../lib/entity-view.js'
+
+export default class PipelineGetCommand extends BaseCommand {
+  static description = 'Get a pipeline by ID'
+
+  static examples = [
+    '<%= config.bin %> pipeline get 1',
+    '<%= config.bin %> pipeline get 1 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Pipeline ID' }),
+  }
+
+  async run() {
+    const { args } = await this.parse(PipelineGetCommand)
+    const body = await this.apiClient.get(`/api/v2/pipelines/${args.id}`)
+    await outputRecord(this, body.data)
+  }
+}

package/src/commands/pipeline/list.js

@@ -0,0 +1,37 @@
+import BaseCommand from '../../base-command.js'
+import { collectPages } from '../../lib/pagination.js'
+
+const columns = {
+  id: { header: 'ID' },
+  name: { header: 'Name' },
+  is_deal_probability_enabled: { header: 'Probability' },
+  order_nr: { header: 'Order' },
+}
+
+export default class PipelineListCommand extends BaseCommand {
+  static description = 'List pipelines'
+
+  static examples = [
+    '<%= config.bin %> pipeline list',
+    '<%= config.bin %> pipeline list --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  async run() {
+    const { flags } = await this.parse(PipelineListCommand)
+    const limit = flags.limit ?? 100
+
+    const query = {
+      limit: Math.min(limit, 100),
+    }
+
+    const items = await collectPages(
+      this.apiClient.pageV2('/api/v2/pipelines', query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}

package/src/commands/project/create.js

@@ -0,0 +1,48 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { outputRecord } from '../../lib/entity-view.js'
+
+export default class ProjectCreateCommand extends BaseCommand {
+  static description = 'Create a project'
+
+  static examples = [
+    '<%= config.bin %> project create --title "Launch"',
+    '<%= config.bin %> project create --title "Launch" --owner 3 --status open',
+    '<%= config.bin %> project create --title "Raw" --body \'{"deal_ids":[1,2]}\'',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    title: Flags.string({ required: true, description: 'Project title' }),
+    description: Flags.string({ description: 'Project description' }),
+    status: Flags.string({ description: 'Project status' }),
+    'start-date': Flags.string({ description: 'Start date (YYYY-MM-DD)' }),
+    'end-date': Flags.string({ description: 'End date (YYYY-MM-DD)' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    board: Flags.integer({ description: 'Board ID' }),
+    phase: Flags.integer({ description: 'Phase ID' }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(ProjectCreateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        title: flags.title,
+        description: flags.description,
+        status: flags.status,
+        start_date: flags['start-date'],
+        end_date: flags['end-date'],
+        owner_id: flags.owner,
+        board_id: flags.board,
+        phase_id: flags.phase,
+      },
+      rawBody: flags.body,
+    })
+
+    const res = await this.apiClient.post('/api/v2/projects', { body })
+    await outputRecord(this, res.data)
+  }
+}

package/src/commands/project/delete.js

@@ -0,0 +1,39 @@
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import BaseCommand from '../../base-command.js'
+import { confirmAction } from '../../lib/confirm.js'
+import { CliError } from '../../lib/errors.js'
+
+export default class ProjectDeleteCommand extends BaseCommand {
+  static description = 'Delete a project'
+
+  static examples = [
+    '<%= config.bin %> project delete 7',
+    '<%= config.bin %> project delete 7 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Project ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(ProjectDeleteCommand)
+
+    const ok = await confirmAction(`Delete project ${args.id}?`, flags.yes)
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(`/api/v2/projects/${args.id}`)
+    this.log(chalk.green(`Deleted project ${args.id}`))
+  }
+}

package/src/commands/project/get.js

@@ -0,0 +1,26 @@
+import { Args } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { outputRecord } from '../../lib/entity-view.js'
+
+export default class ProjectGetCommand extends BaseCommand {
+  static description = 'Get a project by ID'
+
+  static examples = [
+    '<%= config.bin %> project get 3',
+    '<%= config.bin %> project get 3 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Project ID' }),
+  }
+
+  async run() {
+    const { args } = await this.parse(ProjectGetCommand)
+    const body = await this.apiClient.get(`/api/v2/projects/${args.id}`)
+    await outputRecord(this, body.data)
+  }
+}

package/src/commands/project/list.js

@@ -0,0 +1,39 @@
+import BaseCommand from '../../base-command.js'
+import { collectPages } from '../../lib/pagination.js'
+
+const columns = {
+  id: { header: 'ID' },
+  title: { header: 'Title' },
+  status: { header: 'Status' },
+  owner_id: { header: 'Owner' },
+  start_date: { header: 'Start' },
+  end_date: { header: 'End' },
+}
+
+export default class ProjectListCommand extends BaseCommand {
+  static description = 'List projects'
+
+  static examples = [
+    '<%= config.bin %> project list',
+    '<%= config.bin %> project list --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  async run() {
+    const { flags } = await this.parse(ProjectListCommand)
+    const limit = flags.limit ?? 100
+
+    const query = {
+      limit: Math.min(limit, 100),
+    }
+
+    const items = await collectPages(
+      this.apiClient.pageV2('/api/v2/projects', query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}

package/src/commands/project/update.js

@@ -0,0 +1,63 @@
+import { Args, Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { outputRecord } from '../../lib/entity-view.js'
+import { CliError } from '../../lib/errors.js'
+
+export default class ProjectUpdateCommand extends BaseCommand {
+  static description =
+    'Update a project (v2 PATCH — only provided fields change)'
+
+  static examples = [
+    '<%= config.bin %> project update 7 --title "Relaunch"',
+    '<%= config.bin %> project update 7 --status closed',
+    '<%= config.bin %> project update 7 --owner 9',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Project ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    title: Flags.string({ description: 'Project title' }),
+    description: Flags.string({ description: 'Project description' }),
+    status: Flags.string({ description: 'Project status' }),
+    'start-date': Flags.string({ description: 'Start date (YYYY-MM-DD)' }),
+    'end-date': Flags.string({ description: 'End date (YYYY-MM-DD)' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    board: Flags.integer({ description: 'Board ID' }),
+    phase: Flags.integer({ description: 'Phase ID' }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(ProjectUpdateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        title: flags.title,
+        description: flags.description,
+        status: flags.status,
+        start_date: flags['start-date'],
+        end_date: flags['end-date'],
+        owner_id: flags.owner,
+        board_id: flags.board,
+        phase_id: flags.phase,
+      },
+      rawBody: flags.body,
+    })
+
+    if (Object.keys(body).length === 0) {
+      throw new CliError(
+        'Nothing to update — pass at least one field flag or --body',
+        { exitCode: 64 },
+      )
+    }
+
+    const res = await this.apiClient.patch(`/api/v2/projects/${args.id}`, {
+      body,
+    })
+    await outputRecord(this, res.data)
+  }
+}

package/src/commands/stage/get.js

@@ -0,0 +1,26 @@
+import { Args } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { outputRecord } from '../../lib/entity-view.js'
+
+export default class StageGetCommand extends BaseCommand {
+  static description = 'Get a stage by ID'
+
+  static examples = [
+    '<%= config.bin %> stage get 5',
+    '<%= config.bin %> stage get 5 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Stage ID' }),
+  }
+
+  async run() {
+    const { args } = await this.parse(StageGetCommand)
+    const body = await this.apiClient.get(`/api/v2/stages/${args.id}`)
+    await outputRecord(this, body.data)
+  }
+}

package/src/commands/stage/list.js

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { collectPages } from '../../lib/pagination.js'
+
+const columns = {
+  id: { header: 'ID' },
+  name: { header: 'Name' },
+  pipeline_id: { header: 'Pipeline' },
+  deal_probability: { header: 'Probability' },
+  order_nr: { header: 'Order' },
+}
+
+export default class StageListCommand extends BaseCommand {
+  static description = 'List stages'
+
+  static examples = [
+    '<%= config.bin %> stage list',
+    '<%= config.bin %> stage list --pipeline 1 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    pipeline: Flags.integer({ description: 'Filter by pipeline ID' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(StageListCommand)
+    const limit = flags.limit ?? 100
+
+    const query = {
+      pipeline_id: flags.pipeline,
+      limit: Math.min(limit, 100),
+    }
+
+    const items = await collectPages(
+      this.apiClient.pageV2('/api/v2/stages', query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}

package/src/commands/webhook/create.js

@@ -0,0 +1,75 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { outputRecord } from '../../lib/entity-view.js'
+
+export default class WebhookCreateCommand extends BaseCommand {
+  static description = 'Create a webhook'
+
+  static examples = [
+    '<%= config.bin %> webhook create --url https://example.com/hook --event-action change --event-object deal',
+    '<%= config.bin %> webhook create --url https://example.com/hook --event-action "*" --event-object "*"',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    url: Flags.string({
+      required: true,
+      description: 'Webhook subscription URL',
+    }),
+    'event-action': Flags.string({
+      required: true,
+      description: 'Event action to subscribe to',
+      options: ['create', 'change', 'delete', '*'],
+    }),
+    'event-object': Flags.string({
+      required: true,
+      description: 'Event object to subscribe to',
+      options: [
+        'activity',
+        'deal',
+        'lead',
+        'note',
+        'organization',
+        'person',
+        'product',
+        'user',
+        'pipeline',
+        'stage',
+        '*',
+      ],
+    }),
+    name: Flags.string({ description: 'Webhook name' }),
+    version: Flags.string({
+      description: 'Webhook payload version',
+      default: '2.0',
+    }),
+    'http-auth-user': Flags.string({
+      description: 'HTTP basic auth username for the endpoint',
+      dependsOn: ['http-auth-password'],
+    }),
+    'http-auth-password': Flags.string({
+      description: 'HTTP basic auth password for the endpoint',
+      dependsOn: ['http-auth-user'],
+    }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(WebhookCreateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        subscription_url: flags.url,
+        event_action: flags['event-action'],
+        event_object: flags['event-object'],
+        version: flags.version,
+        name: flags.name,
+        http_auth_user: flags['http-auth-user'],
+        http_auth_password: flags['http-auth-password'],
+      },
+    })
+
+    const res = await this.apiClient.post('/api/v1/webhooks', { body })
+    await outputRecord(this, res.data)
+  }
+}

package/src/commands/webhook/delete.js

@@ -0,0 +1,39 @@
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import BaseCommand from '../../base-command.js'
+import { confirmAction } from '../../lib/confirm.js'
+import { CliError } from '../../lib/errors.js'
+
+export default class WebhookDeleteCommand extends BaseCommand {
+  static description = 'Delete a webhook'
+
+  static examples = [
+    '<%= config.bin %> webhook delete 3',
+    '<%= config.bin %> webhook delete 3 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Webhook ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(WebhookDeleteCommand)
+
+    const ok = await confirmAction(`Delete webhook ${args.id}?`, flags.yes)
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(`/api/v1/webhooks/${args.id}`)
+    this.log(chalk.green(`Deleted webhook ${args.id}`))
+  }
+}

package/src/commands/webhook/list.js

@@ -0,0 +1,33 @@
+import BaseCommand from '../../base-command.js'
+
+const columns = {
+  id: { header: 'ID' },
+  subscription_url: { header: 'URL' },
+  event_action: { header: 'Action' },
+  event_object: { header: 'Object' },
+  version: { header: 'Version' },
+  is_active: {
+    header: 'Active',
+    get: (row) => row.is_active ?? row.active_flag ?? '',
+  },
+}
+
+export default class WebhookListCommand extends BaseCommand {
+  static description = 'List webhooks'
+
+  static examples = [
+    '<%= config.bin %> webhook list',
+    '<%= config.bin %> webhook list --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  async run() {
+    await this.parse(WebhookListCommand)
+
+    const body = await this.apiClient.get('/api/v1/webhooks')
+    await this.outputResults(body.data, columns)
+  }
+}