@wavyx/pdcli 0.1.0 → 0.2.0

package/src/commands/deal/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 DealGetCommand extends BaseCommand {
   static description = 'Get a deal by ID'
@@ -22,22 +21,6 @@ export default class DealGetCommand extends BaseCommand {
   async run() {
     const { args } = await this.parse(DealGetCommand)
     const body = await this.apiClient.get(`/api/v2/deals/${args.id}`)
-    let record = body.data
-
-    if (this.resolveFormat() === 'table') {
-      // Table view resolves custom-field hash keys to names and option IDs
-      // to labels; JSON output stays raw for scripting.
-      if (record.custom_fields && Object.keys(record.custom_fields).length) {
-        const defs = await getFields(this.apiClient, 'deal')
-        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, 'deal')
   }
 }

package/src/commands/deal/update.js

@@ -0,0 +1,79 @@
+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 DealUpdateCommand extends BaseCommand {
+  static description = 'Update a deal (v2 PATCH — only provided fields change)'
+
+  static examples = [
+    '<%= config.bin %> deal update 42 --stage 5',
+    '<%= config.bin %> deal update 42 --status won',
+    '<%= config.bin %> deal update 42 --field "Deal Size=Large"',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Deal ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    title: Flags.string({ description: 'Deal title' }),
+    value: Flags.integer({ description: 'Deal value' }),
+    currency: Flags.string({ description: 'Deal currency (e.g. EUR)' }),
+    status: Flags.string({
+      description: 'Deal status',
+      options: ['open', 'won', 'lost'],
+    }),
+    stage: Flags.integer({ description: 'Stage ID' }),
+    pipeline: Flags.integer({ description: 'Pipeline ID' }),
+    person: Flags.integer({ description: 'Linked person ID' }),
+    org: Flags.integer({ description: 'Linked organization ID' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    probability: Flags.integer({ description: 'Success probability (0-100)' }),
+    'expected-close-date': Flags.string({
+      description: 'Expected close date (YYYY-MM-DD)',
+    }),
+    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(DealUpdateCommand)
+
+    const body = buildWriteBody({
+      typed: {
+        title: flags.title,
+        value: flags.value,
+        currency: flags.currency,
+        status: flags.status,
+        stage_id: flags.stage,
+        pipeline_id: flags.pipeline,
+        person_id: flags.person,
+        org_id: flags.org,
+        owner_id: flags.owner,
+        probability: flags.probability,
+        expected_close_date: flags['expected-close-date'],
+      },
+      fields: flags.field,
+      rawBody: flags.body,
+      defs: await defsForFields(this, 'deal', 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/deals/${args.id}`, {
+      body,
+    })
+    await outputRecord(this, res.data, 'deal')
+  }
+}

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

package/src/commands/person/update.js

@@ -0,0 +1,69 @@
+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 PersonUpdateCommand extends BaseCommand {
+  static description =
+    'Update a person (v2 PATCH — only provided fields change)'
+
+  static examples = [
+    '<%= config.bin %> person update 42 --name "New name"',
+    '<%= config.bin %> person update 42 --email new@acme.com',
+    '<%= config.bin %> person update 42 --field "Segment=Enterprise"',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Person ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ 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 { args, flags } = await this.parse(PersonUpdateCommand)
+
+    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),
+    })
+
+    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/persons/${args.id}`, {
+      body,
+    })
+    await outputRecord(this, res.data, 'person')
+  }
+}

package/src/commands/product/create.js

@@ -0,0 +1,62 @@
+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 ProductCreateCommand extends BaseCommand {
+  static description = 'Create a product'
+
+  static examples = [
+    '<%= config.bin %> product create --name "Widget" --code W-1 --price 9.99 --currency EUR',
+    '<%= config.bin %> product create --name "Sized" --field "Material=Steel"',
+    '<%= config.bin %> product create --name "Raw" --body \'{"tax":19}\'',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ required: true, description: 'Product name' }),
+    code: Flags.string({ description: 'Product code (SKU)' }),
+    unit: Flags.string({ description: 'Unit of measure' }),
+    description: Flags.string({ description: 'Product description' }),
+    owner: Flags.integer({ description: 'Owner (user) ID' }),
+    price: Flags.string({
+      description: 'Unit price (requires --currency)',
+      dependsOn: ['currency'],
+    }),
+    currency: Flags.string({
+      description: 'Price currency (requires --price)',
+      dependsOn: ['price'],
+    }),
+    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(ProductCreateCommand)
+
+    const prices =
+      flags.price !== undefined && flags.currency !== undefined
+        ? [{ price: Number(flags.price), currency: flags.currency }]
+        : undefined
+
+    const body = buildWriteBody({
+      typed: {
+        name: flags.name,
+        code: flags.code,
+        unit: flags.unit,
+        description: flags.description,
+        owner_id: flags.owner,
+        prices,
+      },
+      fields: flags.field,
+      rawBody: flags.body,
+      defs: await defsForFields(this, 'product', flags.field),
+    })
+
+    const res = await this.apiClient.post('/api/v2/products', { body })
+    await outputRecord(this, res.data, 'product')
+  }
+}

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

package/src/commands/product/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 ProductGetCommand extends BaseCommand {
+  static description = 'Get a product by ID'
+
+  static examples = [
+    '<%= config.bin %> product get 7',
+    '<%= config.bin %> product get 7 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+  }
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Product ID' }),
+  }
+
+  async run() {
+    const { args } = await this.parse(ProductGetCommand)
+    const body = await this.apiClient.get(`/api/v2/products/${args.id}`)
+    await outputRecord(this, body.data, 'product')
+  }
+}

package/src/commands/product/list.js

@@ -0,0 +1,45 @@
+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' },
+  code: { header: 'Code' },
+  unit: { header: 'Unit' },
+  price: {
+    header: 'Price',
+    get: (row) =>
+      row.prices?.[0] ? `${row.prices[0].price} ${row.prices[0].currency}` : '',
+  },
+}
+
+export default class ProductListCommand extends BaseCommand {
+  static description = 'List products'
+
+  static examples = [
+    '<%= config.bin %> product list',
+    '<%= config.bin %> product list --owner 3 --output json',
+  ]
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    owner: Flags.integer({ description: 'Filter by owner (user) ID' }),
+  }
+
+  async run() {
+    const { flags } = await this.parse(ProductListCommand)
+    const limit = flags.limit ?? 100
+
+    const query = {
+      owner_id: flags.owner,
+      limit: Math.min(limit, 100),
+    }
+
+    const items = await collectPages(
+      this.apiClient.pageV2('/api/v2/products', query),
+      limit,
+    )
+    await this.outputResults(items, columns)
+  }
+}