@wavyx/pdcli 0.1.0 → 0.3.0

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

package/src/commands/product/update.js

@@ -0,0 +1,77 @@
+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 ProductUpdateCommand extends BaseCommand {
+  static description =
+    'Update a product (v2 PATCH — only provided fields change)'
+
+  static examples = [
+    '<%= config.bin %> product update 7 --name "New name"',
+    '<%= config.bin %> product update 7 --price 12.50 --currency USD',
+    '<%= config.bin %> product update 7 --field "Material=Steel"',
+  ]
+
+  static args = {
+    id: Args.integer({ required: true, description: 'Product ID' }),
+  }
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ 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 { args, flags } = await this.parse(ProductUpdateCommand)
+
+    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),
+    })
+
+    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/products/${args.id}`, {
+      body,
+    })
+    await outputRecord(this, res.data, 'product')
+  }
+}

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