@roarkanalytics/cli 0.57.0 → 0.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.58.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.57.0...v0.58.0) (2026-10-28)
4
+
5
+
6
+ ### Features
7
+
8
+ * **cli:** cli update ([#150](https://github.com/roarkhq/cli-roark-analytics/issues/150)) ([0bb4471](https://github.com/roarkhq/cli-roark-analytics/commit/0bb44717ab2b6e7569ae0f9033bbd359a384ffc4))
9
+
3
10
  ## [0.57.0](https://github.com/roarkhq/cli-roark-analytics/compare/v0.56.1...v0.57.0) (2026-10-27)
4
11
 
5
12
 
package/README.md CHANGED
@@ -271,7 +271,7 @@ roark completion fish | source
271
271
  | --------------------------------------------- | ------------------------------ |
272
272
  | `roark phone-number allowance get` | Get the phone number allowance |
273
273
  | `roark phone-number available list` | Search available phone numbers |
274
- | `roark phone-number create --e164 <value>` | Buy a phone number |
274
+ | `roark phone-number create` | Buy a phone number |
275
275
  | `roark phone-number delete <phone-number-id>` | Release a phone number |
276
276
  | `roark phone-number list` | List phone numbers |
277
277
  | `roark phone-number update <phone-number-id>` | Update a phone number |
package/commands.js CHANGED
@@ -4680,15 +4680,35 @@ exports.COMMANDS = [
4680
4680
  httpMethod: 'get',
4681
4681
  httpPath: '/v1/phone-number/available',
4682
4682
  summary: 'Search available phone numbers',
4683
- description: 'Returns US numbers the carrier has for sale, narrowed by area code or by digits the number must contain. Buy one with POST /v1/phone-number.',
4683
+ description: 'Returns US or Canadian numbers the carrier has for sale, local or toll-free, narrowed by area code or by digits the number must contain. When an area code has no numbers, nearby ones are returned flagged bestEffort; an empty list means nothing matched. Buy one with POST /v1/phone-number, or let Roark pick with autoPick.',
4684
4684
  positionals: [],
4685
4685
  flags: [
4686
+ {
4687
+ name: 'country',
4688
+ path: ['country'],
4689
+ location: 'query',
4690
+ required: false,
4691
+ description: 'ISO 3166-1 alpha-2 country of the number: US or CA',
4692
+ valueKind: 'string',
4693
+ enumValues: ['US', 'CA'],
4694
+ repeatable: false,
4695
+ },
4696
+ {
4697
+ name: 'number-type',
4698
+ path: ['numberType'],
4699
+ location: 'query',
4700
+ required: false,
4701
+ description: 'LOCAL for a number in an area code, TOLL_FREE for one from the shared US and Canada toll-free pool',
4702
+ valueKind: 'string',
4703
+ enumValues: ['LOCAL', 'TOLL_FREE'],
4704
+ repeatable: false,
4705
+ },
4686
4706
  {
4687
4707
  name: 'area-code',
4688
4708
  path: ['areaCode'],
4689
4709
  location: 'query',
4690
4710
  required: false,
4691
- description: 'Three-digit US area code',
4711
+ description: 'Three-digit area code, or a toll-free prefix such as 800. When it has no numbers, nearby ones are returned instead, flagged bestEffort.',
4692
4712
  valueKind: 'string',
4693
4713
  repeatable: false,
4694
4714
  },
@@ -4706,7 +4726,7 @@ exports.COMMANDS = [
4706
4726
  path: ['limit'],
4707
4727
  location: 'query',
4708
4728
  required: false,
4709
- description: 'Maximum number of results (default: 20, max: 50)',
4729
+ description: 'Maximum number of results (default: 20, max: 100)',
4710
4730
  valueKind: 'integer',
4711
4731
  repeatable: false,
4712
4732
  },
@@ -4725,18 +4745,74 @@ exports.COMMANDS = [
4725
4745
  httpMethod: 'post',
4726
4746
  httpPath: '/v1/phone-number',
4727
4747
  summary: 'Buy a phone number',
4728
- description: 'Buys a number from the carrier for this project. Free inside the plan allowance; past it, the first month of rent is charged now and monthly after that.',
4748
+ description: 'Buys a number from the carrier for this project: the one named by e164, or one Roark picks to match autoPick (trying the next match if the carrier has just sold one). Free inside the plan allowance; past it, the first month of rent is charged now and monthly after that.',
4729
4749
  positionals: [],
4730
4750
  flags: [
4731
4751
  {
4732
4752
  name: 'e164',
4733
4753
  path: ['e164'],
4734
4754
  location: 'body',
4735
- required: true,
4736
- description: 'The number to buy, in E.164 format, from a search result',
4755
+ required: false,
4756
+ description: 'The number to buy, in E.164 format, from a search result. Give this or autoPick.',
4757
+ valueKind: 'string',
4758
+ repeatable: false,
4759
+ },
4760
+ {
4761
+ name: 'auto-pick',
4762
+ path: ['autoPick'],
4763
+ location: 'body',
4764
+ required: false,
4765
+ description: 'What the number Roark picks should look like. Roark buys the first matching number the carrier will sell, preferring the area code and falling back to a nearby one.',
4766
+ valueKind: 'object',
4767
+ },
4768
+ {
4769
+ name: 'auto-pick.country',
4770
+ path: ['autoPick', 'country'],
4771
+ location: 'body',
4772
+ required: false,
4773
+ description: 'ISO 3166-1 alpha-2 country of the number: US or CA',
4774
+ valueKind: 'string',
4775
+ enumValues: ['US', 'CA'],
4776
+ repeatable: false,
4777
+ },
4778
+ {
4779
+ name: 'auto-pick.number-type',
4780
+ path: ['autoPick', 'numberType'],
4781
+ location: 'body',
4782
+ required: false,
4783
+ description: 'LOCAL for a number in an area code, TOLL_FREE for one from the shared US and Canada toll-free pool',
4784
+ valueKind: 'string',
4785
+ enumValues: ['LOCAL', 'TOLL_FREE'],
4786
+ repeatable: false,
4787
+ },
4788
+ {
4789
+ name: 'auto-pick.area-code',
4790
+ path: ['autoPick', 'areaCode'],
4791
+ location: 'body',
4792
+ required: false,
4793
+ description: 'Three-digit area code, or a toll-free prefix such as 800. When it has no numbers, nearby ones are returned instead, flagged bestEffort.',
4794
+ valueKind: 'string',
4795
+ repeatable: false,
4796
+ },
4797
+ {
4798
+ name: 'auto-pick.contains',
4799
+ path: ['autoPick', 'contains'],
4800
+ location: 'body',
4801
+ required: false,
4802
+ description: 'Digits or letters the number must contain (1 to 7, * matches any digit)',
4737
4803
  valueKind: 'string',
4738
4804
  repeatable: false,
4739
4805
  },
4806
+ {
4807
+ name: 'country',
4808
+ path: ['country'],
4809
+ location: 'body',
4810
+ required: false,
4811
+ description: 'The country of the number given by e164 (default: US). An auto-picked number uses autoPick.country.',
4812
+ valueKind: 'string',
4813
+ enumValues: ['US', 'CA'],
4814
+ repeatable: false,
4815
+ },
4740
4816
  {
4741
4817
  name: 'name',
4742
4818
  path: ['name'],
@@ -4775,7 +4851,7 @@ exports.COMMANDS = [
4775
4851
  },
4776
4852
  ],
4777
4853
  hasParams: true,
4778
- paramsAllOptional: false,
4854
+ paramsAllOptional: true,
4779
4855
  bodyOpaque: false,
4780
4856
  bodyVariants: [],
4781
4857
  acceptsBody: true,