@wavyx/pdcli 0.1.0 → 0.3.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/create.js

@@ -0,0 +1,42 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { defsForFields, outputRecord } from '../../lib/entity-view.js'
+
+export default class OrgCreateCommand extends BaseCommand {
+  static description = 'Create an organization'
+
+  static examples = [
+    '<%= config.bin %> org create --name "Acme Corp"',
+    '<%= config.bin %> org create --name "Tiered" --field "Tier=Gold"',
+    '<%= config.bin %> org create --name "Raw" --body \'{"visible_to":3}\'',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ required: true, description: 'Organization name' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    field: Flags.string({
+      multiple: true,
+      description: 'Custom/standard field as "Name=Value" (repeatable)',
+    }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(OrgCreateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        name: flags.name,
+        owner_id: flags.owner,
+      },
+      fields: flags.field,
+      rawBody: flags.body,
+      defs: await defsForFields(this, 'org', flags.field),
+    })
+
+    const res = await this.apiClient.post('/api/v2/organizations', { body })
+    await outputRecord(this, res.data, 'org')
+  }
+}

package/src/commands/org/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 OrgDeleteCommand extends BaseCommand {
+  static description = 'Delete an organization'
+
+  static examples = [
+    '<%= config.bin %> org delete 7',
+    '<%= config.bin %> org delete 7 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Organization 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(OrgDeleteCommand)
+
+    const ok = await confirmAction(`Delete organization ${args.id}?`, flags.yes)
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(`/api/v2/organizations/${args.id}`)
+    this.log(chalk.green(`Deleted organization ${args.id}`))
+  }
+}

package/src/commands/org/get.js

@@ -1,7 +1,6 @@
 import { Args } from '@oclif/core'
 import BaseCommand from '../../base-command.js'
-import { getFields, makeResolver } from '../../lib/fields.js'
-import { flattenRecord } from '../../lib/output/record.js'
+import { outputRecord } from '../../lib/entity-view.js'
 
 export default class OrgGetCommand extends BaseCommand {
   static description = 'Get an organization by ID'
@@ -22,20 +21,6 @@ export default class OrgGetCommand extends BaseCommand {
   async run() {
     const { args } = await this.parse(OrgGetCommand)
     const body = await this.apiClient.get(`/api/v2/organizations/${args.id}`)
-    let record = body.data
-
-    if (this.resolveFormat() === 'table') {
-      if (record.custom_fields && Object.keys(record.custom_fields).length) {
-        const defs = await getFields(this.apiClient, 'org')
-        record = makeResolver(defs).resolveCustomFields(record)
-      }
-      await this.outputResults(flattenRecord(record), {
-        field: { header: 'Field' },
-        value: { header: 'Value' },
-      })
-      return
-    }
-
-    await this.outputResults(record, {})
+    await outputRecord(this, body.data, 'org')
   }
 }

package/src/commands/org/update.js

@@ -0,0 +1,57 @@
+import { Args, Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { defsForFields, outputRecord } from '../../lib/entity-view.js'
+import { CliError } from '../../lib/errors.js'
+
+export default class OrgUpdateCommand extends BaseCommand {
+  static description =
+    'Update an organization (v2 PATCH — only provided fields change)'
+
+  static examples = [
+    '<%= config.bin %> org update 7 --name "Acme Inc"',
+    '<%= config.bin %> org update 7 --owner 9',
+    '<%= config.bin %> org update 7 --field "Tier=Gold"',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Organization ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ description: 'Organization name' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    field: Flags.string({
+      multiple: true,
+      description: 'Custom/standard field as "Name=Value" (repeatable)',
+    }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { args, flags } = await this.parse(OrgUpdateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        name: flags.name,
+        owner_id: flags.owner,
+      },
+      fields: flags.field,
+      rawBody: flags.body,
+      defs: await defsForFields(this, 'org', flags.field),
+    })
+
+    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.patch(`/api/v2/organizations/${args.id}`, {
+      body,
+    })
+    await outputRecord(this, res.data, 'org')
+  }
+}

package/src/commands/person/create.js

@@ -0,0 +1,54 @@
+import { Flags } from '@oclif/core'
+import BaseCommand from '../../base-command.js'
+import { buildWriteBody } from '../../lib/input.js'
+import { defsForFields, outputRecord } from '../../lib/entity-view.js'
+
+export default class PersonCreateCommand extends BaseCommand {
+  static description = 'Create a person'
+
+  static examples = [
+    '<%= config.bin %> person create --name "Jane Doe" --email jane@acme.com',
+    '<%= config.bin %> person create --name "Jane" --field "Segment=Enterprise"',
+    '<%= config.bin %> person create --name "Raw" --body \'{"visible_to":"3"}\'',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ required: true, description: 'Person name' }),
+    email: Flags.string({
+      multiple: true,
+      description: 'Email address (repeatable; first is primary)',
+    }),
+    phone: Flags.string({
+      multiple: true,
+      description: 'Phone number (repeatable; first is primary)',
+    }),
+    org: Flags.integer({ description: 'Linked organization ID' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    field: Flags.string({
+      multiple: true,
+      description: 'Custom/standard field as "Name=Value" (repeatable)',
+    }),
+    body: Flags.string({ description: 'Raw JSON body to merge (flags win)' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(PersonCreateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        name: flags.name,
+        org_id: flags.org,
+        owner_id: flags.owner,
+        emails: flags.email?.map((value, i) => ({ value, primary: i === 0 })),
+        phones: flags.phone?.map((value, i) => ({ value, primary: i === 0 })),
+      },
+      fields: flags.field,
+      rawBody: flags.body,
+      defs: await defsForFields(this, 'person', flags.field),
+    })
+
+    const res = await this.apiClient.post('/api/v2/persons', { body })
+    await outputRecord(this, res.data, 'person')
+  }
+}

package/src/commands/person/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 PersonDeleteCommand extends BaseCommand {
+  static description = 'Delete a person'
+
+  static examples = [
+    '<%= config.bin %> person delete 42',
+    '<%= config.bin %> person delete 42 --yes',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Person 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(PersonDeleteCommand)
+
+    const ok = await confirmAction(`Delete person ${args.id}?`, flags.yes)
+    if (!ok) {
+      throw new CliError('Aborted', { exitCode: 1 })
+    }
+
+    await this.apiClient.del(`/api/v2/persons/${args.id}`)
+    this.log(chalk.green(`Deleted person ${args.id}`))
+  }
+}

package/src/commands/person/get.js

@@ -1,7 +1,6 @@
 import { Args } from '@oclif/core'
 import BaseCommand from '../../base-command.js'
-import { getFields, makeResolver } from '../../lib/fields.js'
-import { flattenRecord } from '../../lib/output/record.js'
+import { outputRecord } from '../../lib/entity-view.js'
 
 export default class PersonGetCommand extends BaseCommand {
   static description = 'Get a person by ID'
@@ -22,20 +21,6 @@ export default class PersonGetCommand extends BaseCommand {
   async run() {
     const { args } = await this.parse(PersonGetCommand)
     const body = await this.apiClient.get(`/api/v2/persons/${args.id}`)
-    let record = body.data
-
-    if (this.resolveFormat() === 'table') {
-      if (record.custom_fields && Object.keys(record.custom_fields).length) {
-        const defs = await getFields(this.apiClient, 'person')
-        record = makeResolver(defs).resolveCustomFields(record)
-      }
-      await this.outputResults(flattenRecord(record), {
-        field: { header: 'Field' },
-        value: { header: 'Value' },
-      })
-      return
-    }
-
-    await this.outputResults(record, {})
+    await outputRecord(this, body.data, 'person')
   }
 }