@farthershore/cli 0.14.5 → 0.14.7

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/README.md CHANGED
@@ -299,6 +299,42 @@ Read recent usage off the management API.
299
299
  farthershore usage summary weather-api --format json
300
300
  ```
301
301
 
302
+ ### `farthershore consumer`
303
+
304
+ Manage live business users/consumers. These are API-controlled runtime actions,
305
+ not repo-authored product behavior.
306
+
307
+ ```bash
308
+ farthershore consumer list weather-api --format json
309
+ farthershore consumer list weather-api --env preview --format json
310
+ farthershore consumer block weather-api <subscriberId> --yes --format json
311
+ farthershore consumer remove weather-api <subscriberId> --yes --format json
312
+ ```
313
+
314
+ Use `consumer list` first to discover `subscriberId`. `block` suspends a user
315
+ and revokes active API keys. `remove` is irreversible and tears down subscriber
316
+ state across billing, edge credentials, and subscriptions.
317
+
318
+ ### `farthershore secret`
319
+
320
+ Manage private business secrets. These are API-controlled operational values,
321
+ not repo-authored product behavior. Values are encrypted at rest and list/read
322
+ responses return metadata only.
323
+
324
+ ```bash
325
+ farthershore secret list weather-api --format json
326
+ printf '%s' "$CLERK_SECRET_KEY" | farthershore secret set weather-api \
327
+ CLERK_SECRET_KEY \
328
+ --from-stdin \
329
+ --target RUNTIME \
330
+ --format json
331
+ farthershore secret delete weather-api CLERK_SECRET_KEY --yes --format json
332
+ ```
333
+
334
+ Use `frontend env` for public browser-visible variables such as
335
+ `NEXT_PUBLIC_*`, `VITE_PUBLIC_*`, or analytics keys. Use `secret` for server
336
+ runtime and private build values.
337
+
302
338
  ### `farthershore backend`
303
339
 
304
340
  Create BYO backends and provision runtime tokens for upstream services. Core
@@ -626,6 +662,8 @@ operation registry that generates the CLI command groups. Tool names use the
626
662
  - Promo codes: `fs_promo_code_list`, `fs_promo_code_create`,
627
663
  `fs_promo_code_update`, `fs_promo_code_archive`,
628
664
  `fs_promo_code_reactivate`
665
+ - Consumers: `fs_consumer_list`, `fs_consumer_block`, `fs_consumer_remove`
666
+ - Secrets: `fs_secret_list`, `fs_secret_set`, `fs_secret_delete`
629
667
  - Personas: `fs_persona_bootstrap`, `fs_persona_list`, `fs_persona_revoke`
630
668
  - Usage and maker tokens: `fs_usage_read`, `fs_maker_token_list`
631
669