@wavyx/pdcli 0.2.0 → 0.4.0

package/src/commands/lead/list.js

@@ -0,0 +1,50 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { collectPages } from '../../lib/pagination.js'
+
+const columns = {
+  id: { header: 'ID' },
+  title: { header: 'Title' },
+  person_id: { header: 'Person' },
+  organization_id: { header: 'Org' },
+  value: {
+    header: 'Value',
+    get: (row) =>
+      row.value ? `${row.value.amount} ${row.value.currency}` : '',
+  },
+  add_time: { header: 'Created' },
+}
+
+export default class LeadListCommand extends BaseCommand {
+  static description = 'List leads'
+
+  static examples = [
+    '<%= config.bin %> lead list',
+    '<%= config.bin %> lead list --owner 3 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    owner: Flags.integer({ description: 'Filter by owner (user) ID' }),
+    person: Flags.integer({ description: 'Filter by person ID' }),
+    org: Flags.integer({ description: 'Filter by organization ID' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(LeadListCommand)
+    const limit = flags.limit ?? 100
+
+    const query = {
+      owner_id: flags.owner,
+      person_id: flags.person,
+      organization_id: flags.org,
+      limit: Math.min(limit, 100),
+    }
+
+    const items = await collectPages(
+      this.apiClient.pageV1('/api/v1/leads', query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}

package/src/commands/lead/update.js

@@ -0,0 +1,71 @@
+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 LeadUpdateCommand extends BaseCommand {
+  static description = 'Update a lead (v1 PATCH — only provided fields change)'
+
+  static examples = [
+    '<%= config.bin %> lead update adf21080-0e10-11eb-879b-05d71fb426ec --title "Renamed"',
+    '<%= config.bin %> lead update adf21080-0e10-11eb-879b-05d71fb426ec --value 7500 --currency USD',
+  ]
+
+  static args = {
+    id: Args.string({ required: true, description: 'Lead ID (UUID)' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    title: Flags.string({ description: 'Lead title' }),
+    person: Flags.integer({ description: 'Linked person ID' }),
+    org: Flags.integer({ description: 'Linked organization ID' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    value: Flags.string({
+      description: 'Lead value amount (requires --currency)',
+      dependsOn: ['currency'],
+    }),
+    currency: Flags.string({
+      description: 'Lead value currency (requires --value)',
+      dependsOn: ['value'],
+    }),
+    'expected-close-date': Flags.string({
+      description: 'Expected close date (YYYY-MM-DD)',
+    }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(LeadUpdateCommand)
+
+    const value =
+      flags.value !== undefined && flags.currency !== undefined
+        ? { amount: Number(flags.value), currency: flags.currency }
+        : undefined
+
+    const body = buildWriteBody({
+      typed: {
+        title: flags.title,
+        person_id: flags.person,
+        organization_id: flags.org,
+        owner_id: flags.owner,
+        value,
+        expected_close_date: flags['expected-close-date'],
+      },
+      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/v1/leads/${args.id}`, {
+      body,
+    })
+    await outputRecord(this, res.data, 'deal')
+  }
+}

package/src/commands/note/create.js

@@ -0,0 +1,42 @@
+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 NoteCreateCommand extends BaseCommand {
+  static description = 'Create a note'
+
+  static examples = [
+    '<%= config.bin %> note create --content "Called the lead"',
+    '<%= config.bin %> note create --content "Follow up" --deal 42',
+    '<%= config.bin %> note create --content "Pinned" --body \'{"pinned_to_deal_flag":1}\'',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    content: Flags.string({ required: true, description: 'Note content' }),
+    deal: Flags.integer({ description: 'Attach to deal ID' }),
+    person: Flags.integer({ description: 'Attach to person ID' }),
+    org: Flags.integer({ description: 'Attach to organization ID' }),
+    lead: Flags.string({ description: 'Attach to lead ID (UUID)' }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(NoteCreateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        content: flags.content,
+        deal_id: flags.deal,
+        person_id: flags.person,
+        org_id: flags.org,
+        lead_id: flags.lead,
+      },
+      rawBody: flags.body,
+    })
+
+    const res = await this.apiClient.post('/api/v1/notes', { body })
+    await outputRecord(this, res.data)
+  }
+}

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/org/import.js

@@ -0,0 +1,109 @@
+import { readFileSync } from 'node:fs'
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import BaseCommand from '../../base-command.js'
+import { parseCsv } from '../../lib/csv-parse.js'
+import { prepareImportBodies } from '../../lib/import.js'
+import { bulkRun } from '../../lib/bulk.js'
+import { getFields } from '../../lib/fields.js'
+import { confirmAction } from '../../lib/confirm.js'
+import { CliError } from '../../lib/errors.js'
+
+const SPECIAL_COLUMNS = {
+  name: (typed, value) => {
+    typed.name = value
+  },
+  owner_id: (typed, value) => {
+    typed.owner_id = Number(value)
+  },
+}
+
+export default class OrgImportCommand extends BaseCommand {
+  static description =
+    'Bulk-create organizations from a CSV (headers map to fields, custom fields by name)'
+
+  static examples = [
+    '<%= config.bin %> org import orgs.csv',
+    '<%= config.bin %> org import orgs.csv --dry-run',
+  ]
+
+  static args = {
+    file: Args.string({ required: true, description: 'CSV file path' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    'dry-run': Flags.boolean({
+      description: 'Validate every row without creating anything',
+      default: false,
+    }),
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(OrgImportCommand)
+
+    const { headers, rows } = parseCsv(readFileSync(args.file, 'utf8'))
+    if (!headers.some((h) => h.toLowerCase() === 'name')) {
+      throw new CliError('CSV must include a "name" column', { exitCode: 64 })
+    }
+
+    const needsDefs = headers.some((h) => !(h.toLowerCase() in SPECIAL_COLUMNS))
+    const bodies = prepareImportBodies({
+      headers,
+      rows,
+      specialColumns: SPECIAL_COLUMNS,
+      defs: needsDefs ? await getFields(this.apiClient, 'org') : [],
+    })
+
+    if (flags['dry-run']) {
+      this.log(chalk.green(`${bodies.length} rows valid — nothing created`))
+      return
+    }
+
+    const ok = await confirmAction(
+      `Create ${bodies.length} organizations from ${args.file}?`,
+      flags.yes,
+    )
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    const spinner = ora(`Importing ${bodies.length} organizations...`).start()
+    let summary
+    try {
+      summary = await bulkRun(
+        bodies,
+        (body) => this.apiClient.post('/api/v2/organizations', { body }),
+        {
+          onProgress: (done, total) => {
+            spinner.text = `Importing organizations ${done}/${total}`
+          },
+        },
+      )
+    } finally {
+      spinner.stop()
+    }
+
+    this.log(
+      chalk.green(
+        `Imported ${summary.succeeded.length}/${bodies.length} organizations`,
+      ),
+    )
+
+    if (summary.failed.length > 0) {
+      for (const { item, error } of summary.failed) {
+        this.log(chalk.red(`  ✘ ${item.name ?? '(unnamed)'}: ${error}`))
+      }
+      throw new CliError(
+        `${summary.failed.length} of ${bodies.length} rows failed`,
+        { exitCode: 1 },
+      )
+    }
+  }
+}

package/src/commands/person/import.js

@@ -0,0 +1,118 @@
+import { readFileSync } from 'node:fs'
+import { Args, Flags } from '@oclif/core'
+import chalk from 'chalk'
+import ora from 'ora'
+import BaseCommand from '../../base-command.js'
+import { parseCsv } from '../../lib/csv-parse.js'
+import { prepareImportBodies } from '../../lib/import.js'
+import { bulkRun } from '../../lib/bulk.js'
+import { getFields } from '../../lib/fields.js'
+import { confirmAction } from '../../lib/confirm.js'
+import { CliError } from '../../lib/errors.js'
+
+const SPECIAL_COLUMNS = {
+  name: (typed, value) => {
+    typed.name = value
+  },
+  email: (typed, value) => {
+    typed.emails = [{ value, primary: true }]
+  },
+  phone: (typed, value) => {
+    typed.phones = [{ value, primary: true }]
+  },
+  org_id: (typed, value) => {
+    typed.org_id = Number(value)
+  },
+  owner_id: (typed, value) => {
+    typed.owner_id = Number(value)
+  },
+}
+
+export default class PersonImportCommand extends BaseCommand {
+  static description =
+    'Bulk-create persons from a CSV (headers map to fields, custom fields by name)'
+
+  static examples = [
+    '<%= config.bin %> person import people.csv',
+    '<%= config.bin %> person import people.csv --dry-run',
+  ]
+
+  static args = {
+    file: Args.string({ required: true, description: 'CSV file path' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    'dry-run': Flags.boolean({
+      description: 'Validate every row without creating anything',
+      default: false,
+    }),
+    yes: Flags.boolean({
+      char: 'y',
+      description: 'Skip the confirmation prompt',
+      default: false,
+    }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(PersonImportCommand)
+
+    const { headers, rows } = parseCsv(readFileSync(args.file, 'utf8'))
+    if (!headers.some((h) => h.toLowerCase() === 'name')) {
+      throw new CliError('CSV must include a "name" column', { exitCode: 64 })
+    }
+
+    const needsDefs = headers.some((h) => !(h.toLowerCase() in SPECIAL_COLUMNS))
+    const bodies = prepareImportBodies({
+      headers,
+      rows,
+      specialColumns: SPECIAL_COLUMNS,
+      defs: needsDefs ? await getFields(this.apiClient, 'person') : [],
+    })
+
+    if (flags['dry-run']) {
+      this.log(chalk.green(`${bodies.length} rows valid — nothing created`))
+      return
+    }
+
+    const ok = await confirmAction(
+      `Create ${bodies.length} persons from ${args.file}?`,
+      flags.yes,
+    )
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    const spinner = ora(`Importing ${bodies.length} persons...`).start()
+    let summary
+    try {
+      summary = await bulkRun(
+        bodies,
+        (body) => this.apiClient.post('/api/v2/persons', { body }),
+        {
+          onProgress: (done, total) => {
+            spinner.text = `Importing persons ${done}/${total}`
+          },
+        },
+      )
+    } finally {
+      spinner.stop()
+    }
+
+    this.log(
+      chalk.green(
+        `Imported ${summary.succeeded.length}/${bodies.length} persons`,
+      ),
+    )
+
+    if (summary.failed.length > 0) {
+      for (const { item, error } of summary.failed) {
+        this.log(chalk.red(`  ✘ ${item.name ?? '(unnamed)'}: ${error}`))
+      }
+      throw new CliError(
+        `${summary.failed.length} of ${bodies.length} rows failed`,
+        { exitCode: 1 },
+      )
+    }
+  }
+}

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)
+  }
+}