@basis-theory-labs/cli 2.0.0 → 3.0.0

package/README.md

@@ -19,7 +19,7 @@ $ npm install -g @basis-theory-labs/cli
 $ bt COMMAND
 running command...
 $ bt (--version)
-@basis-theory-labs/cli/2.0.0 linux-x64 node-v18.20.8
+@basis-theory-labs/cli/3.0.0 linux-x64 node-v18.20.8
 $ bt --help [COMMAND]
 USAGE
   $ bt COMMAND
@@ -62,7 +62,7 @@ EXAMPLES
   $ bt applications
 ```
 
-_See code: [dist/commands/applications/index.ts](https://github.com/Basis-Theory-Labs/basistheory-cli/blob/v2.0.0/dist/commands/applications/index.ts)_
+_See code: [dist/commands/applications/index.ts](https://github.com/Basis-Theory-Labs/basistheory-cli/blob/v3.0.0/dist/commands/applications/index.ts)_
 
 ## `bt applications create`
 
@@ -151,7 +151,7 @@ EXAMPLES
   $ bt proxies
 ```
 
-_See code: [dist/commands/proxies/index.ts](https://github.com/Basis-Theory-Labs/basistheory-cli/blob/v2.0.0/dist/commands/proxies/index.ts)_
+_See code: [dist/commands/proxies/index.ts](https://github.com/Basis-Theory-Labs/basistheory-cli/blob/v3.0.0/dist/commands/proxies/index.ts)_
 
 ## `bt proxies create`
 
@@ -160,23 +160,74 @@ Creates a new Pre-Configured Proxy. Requires `proxy:create` Management Applicati
 ```
 USAGE
   $ bt proxies create -x <value> [-n <value>] [-u <value>] [-q <value>] [-s <value>] [-i <value>] [-c <value>] [-a]
+    [--request-transform-image node-bt|node22] [--request-transform-package-json <value>] [--request-transform-timeout
+    <value>] [--request-transform-warm-concurrency <value>] [--request-transform-resources standard|large|xlarge]
+    [--request-transform-permissions <value>] [--response-transform-image node-bt|node22]
+    [--response-transform-package-json <value>] [--response-transform-timeout <value>]
+    [--response-transform-warm-concurrency <value>] [--response-transform-resources standard|large|xlarge]
+    [--response-transform-permissions <value>] [--async]
 
 FLAGS
-  -a, --[no-]require-auth                whether the Proxy requires Basis Theory authentication to be invoked. Default:
-                                         true
-  -c, --configuration=<value>            path to configuration file (.env format) to use in the Proxy
-  -i, --application-id=<value>           application ID to use in the Proxy
-  -n, --name=<value>                     name of the Proxy
-  -q, --request-transform-code=<value>   path to JavaScript file containing a Request Transform code
-  -s, --response-transform-code=<value>  path to JavaScript file containing a Response Transform code
-  -u, --destination-url=<value>          URL to which requests will be proxied
-  -x, --management-key=<value>           (required) management key used for connecting with the reactor / proxy
+  -a, --[no-]require-auth                        whether the Proxy requires Basis Theory authentication to be invoked.
+                                                 Default: true
+  -c, --configuration=<value>                    path to configuration file (.env format) to use in the Proxy
+  -i, --application-id=<value>                   application ID to use in the Proxy
+  -n, --name=<value>                             name of the Proxy
+  -q, --request-transform-code=<value>           path to JavaScript file containing a Request Transform code
+  -s, --response-transform-code=<value>          path to JavaScript file containing a Response Transform code
+  -u, --destination-url=<value>                  URL to which requests will be proxied
+  -x, --management-key=<value>                   (required) management key used for connecting with the reactor / proxy
+  --async                                        do not wait for proxy to be ready (requires at least one transform with
+                                                 node22)
+  --request-transform-image=<option>             request-transform runtime image (node-bt|node22)
+                                                 <options: node-bt|node22>
+  --request-transform-package-json=<value>       path to runtime package.json JSON file (top-level dependencies
+                                                 required; supports resolutions or overrides fallback; pinned versions
+                                                 required) (node22 only)
+  --request-transform-permissions=<value>...     request-transform permission to grant, repeatable (node22 only)
+  --request-transform-resources=<option>         request-transform resource tier (node22 only)
+                                                 <options: standard|large|xlarge>
+  --request-transform-timeout=<value>            request-transform timeout in seconds, 1-30 (node22 only)
+  --request-transform-warm-concurrency=<value>   request-transform warm concurrency, 0-1 (node22 only)
+  --response-transform-image=<option>            response-transform runtime image (node-bt|node22)
+                                                 <options: node-bt|node22>
+  --response-transform-package-json=<value>      path to runtime package.json JSON file (top-level dependencies
+                                                 required; supports resolutions or overrides fallback; pinned versions
+                                                 required) (node22 only)
+  --response-transform-permissions=<value>...    response-transform permission to grant, repeatable (node22 only)
+  --response-transform-resources=<option>        response-transform resource tier (node22 only)
+                                                 <options: standard|large|xlarge>
+  --response-transform-timeout=<value>           response-transform timeout in seconds, 1-30 (node22 only)
+  --response-transform-warm-concurrency=<value>  response-transform warm concurrency, 0-1 (node22 only)
 
 DESCRIPTION
   Creates a new Pre-Configured Proxy. Requires `proxy:create` Management Application permission
 
 EXAMPLES
-  $ bt proxies create
+  Create a proxy without transforms
+
+    $ bt proxies create --name "My Proxy" --destination-url https://api.example.com
+
+  Create a proxy with legacy runtime transforms
+
+    $ bt proxies create --name "My Proxy" --destination-url https://api.example.com --request-transform-code \
+      ./request.js --request-transform-image node-bt --application-id <application-id>
+
+  Create a proxy with node22 transforms
+
+    $ bt proxies create --name "My Proxy" --destination-url https://api.example.com --request-transform-code \
+      ./request.js --request-transform-image node22 --response-transform-code ./response.js --response-transform-image \
+      node22
+
+  Create a proxy with node22 transforms and all runtime options
+
+    $ bt proxies create --name "My Proxy" --destination-url https://api.example.com --configuration ./config.env \
+      --require-auth --request-transform-code ./request.js --request-transform-image node22 \
+      --request-transform-timeout 10 --request-transform-warm-concurrency 0 --request-transform-resources standard \
+      --request-transform-package-json ./request/package.json --request-transform-permissions token:read \
+      --response-transform-code ./response.js --response-transform-image node22 --response-transform-timeout 10 \
+      --response-transform-warm-concurrency 0 --response-transform-resources standard \
+      --response-transform-package-json ./response/package.json --response-transform-permissions token:read
 ```
 
 ## `bt proxies delete ID`
@@ -234,35 +285,78 @@ Updates an existing Pre-Configured Proxy. Requires `proxy:update` Management App
 ```
 USAGE
   $ bt proxies update ID -x <value> [-n <value>] [-u <value>] [-q <value>] [-s <value>] [-i <value>] [-c <value>]
-    [-a] [-w] [-l]
+    [-a] [--request-transform-image node-bt|node22] [--request-transform-package-json <value>]
+    [--request-transform-timeout <value>] [--request-transform-warm-concurrency <value>] [--request-transform-resources
+    standard|large|xlarge] [--request-transform-permissions <value>] [--response-transform-image node-bt|node22]
+    [--response-transform-package-json <value>] [--response-transform-timeout <value>]
+    [--response-transform-warm-concurrency <value>] [--response-transform-resources standard|large|xlarge]
+    [--response-transform-permissions <value>] [--async] [-w] [-l]
 
 ARGUMENTS
   ID  Proxy id to update
 
 FLAGS
-  -a, --[no-]require-auth                whether the Proxy requires Basis Theory authentication to be invoked. Default:
-                                         true
-  -c, --configuration=<value>            path to configuration file (.env format) to use in the Proxy
-  -i, --application-id=<value>           application ID to use in the Proxy
-  -l, --logs                             Start logs server after update
-  -n, --name=<value>                     name of the Proxy
-  -q, --request-transform-code=<value>   path to JavaScript file containing a Request Transform code
-  -s, --response-transform-code=<value>  path to JavaScript file containing a Response Transform code
-  -u, --destination-url=<value>          URL to which requests will be proxied
-  -w, --watch                            Watch for changes in informed files
-  -x, --management-key=<value>           (required) management key used for connecting with the reactor / proxy
+  -a, --[no-]require-auth                        whether the Proxy requires Basis Theory authentication to be invoked.
+                                                 Default: true
+  -c, --configuration=<value>                    path to configuration file (.env format) to use in the Proxy
+  -i, --application-id=<value>                   application ID to use in the Proxy
+  -l, --logs                                     Start logs server after update
+  -n, --name=<value>                             name of the Proxy
+  -q, --request-transform-code=<value>           path to JavaScript file containing a Request Transform code
+  -s, --response-transform-code=<value>          path to JavaScript file containing a Response Transform code
+  -u, --destination-url=<value>                  URL to which requests will be proxied
+  -w, --watch                                    Watch for changes in informed files
+  -x, --management-key=<value>                   (required) management key used for connecting with the reactor / proxy
+  --async                                        do not wait for proxy to be ready (requires at least one transform with
+                                                 node22)
+  --request-transform-image=<option>             request-transform runtime image (node-bt|node22)
+                                                 <options: node-bt|node22>
+  --request-transform-package-json=<value>       path to runtime package.json JSON file (top-level dependencies
+                                                 required; supports resolutions or overrides fallback; pinned versions
+                                                 required) (node22 only)
+  --request-transform-permissions=<value>...     request-transform permission to grant, repeatable (node22 only)
+  --request-transform-resources=<option>         request-transform resource tier (node22 only)
+                                                 <options: standard|large|xlarge>
+  --request-transform-timeout=<value>            request-transform timeout in seconds, 1-30 (node22 only)
+  --request-transform-warm-concurrency=<value>   request-transform warm concurrency, 0-1 (node22 only)
+  --response-transform-image=<option>            response-transform runtime image (node-bt|node22)
+                                                 <options: node-bt|node22>
+  --response-transform-package-json=<value>      path to runtime package.json JSON file (top-level dependencies
+                                                 required; supports resolutions or overrides fallback; pinned versions
+                                                 required) (node22 only)
+  --response-transform-permissions=<value>...    response-transform permission to grant, repeatable (node22 only)
+  --response-transform-resources=<option>        response-transform resource tier (node22 only)
+                                                 <options: standard|large|xlarge>
+  --response-transform-timeout=<value>           response-transform timeout in seconds, 1-30 (node22 only)
+  --response-transform-warm-concurrency=<value>  response-transform warm concurrency, 0-1 (node22 only)
 
 DESCRIPTION
   Updates an existing Pre-Configured Proxy. Requires `proxy:update` Management Application permission
 
 EXAMPLES
-  $ bt proxies update 03858bf5-32d3-4a2e-b74b-daeea0883bca
+  Update a proxy destination URL
+
+    $ bt proxies update <proxy-id> --destination-url https://api.example.com
+
+  Update a proxy with legacy runtime transforms
+
+    $ bt proxies update <proxy-id> --request-transform-code ./request.js --request-transform-image node-bt \
+      --application-id <application-id>
 
-  $ bt proxies update 03858bf5-32d3-4a2e-b74b-daeea0883bca --destination-url https://echo.basistheory.com
+  Update a proxy with node22 transforms
 
-  $ bt proxies update 03858bf5-32d3-4a2e-b74b-daeea0883bca --request-transform-code ./myRequestTransform.js
+    $ bt proxies update <proxy-id> --request-transform-code ./request.js --request-transform-image node22 \
+      --response-transform-code ./response.js --response-transform-image node22
 
-  $ bt proxies update 03858bf5-32d3-4a2e-b74b-daeea0883bca --configuration ./.env.proxy
+  Update a proxy with node22 transforms and all runtime options
+
+    $ bt proxies update <proxy-id> --name "My Proxy" --destination-url https://api.example.com --configuration \
+      ./config.env --require-auth --request-transform-code ./request.js --request-transform-image node22 \
+      --request-transform-timeout 10 --request-transform-warm-concurrency 0 --request-transform-resources standard \
+      --request-transform-package-json ./request/package.json --request-transform-permissions token:read \
+      --response-transform-code ./response.js --response-transform-image node22 --response-transform-timeout 10 \
+      --response-transform-warm-concurrency 0 --response-transform-resources standard \
+      --response-transform-package-json ./response/package.json --response-transform-permissions token:read
 ```
 
 ## `bt reactors`
@@ -284,7 +378,7 @@ EXAMPLES
   $ bt reactors
 ```
 
-_See code: [dist/commands/reactors/index.ts](https://github.com/Basis-Theory-Labs/basistheory-cli/blob/v2.0.0/dist/commands/reactors/index.ts)_
+_See code: [dist/commands/reactors/index.ts](https://github.com/Basis-Theory-Labs/basistheory-cli/blob/v3.0.0/dist/commands/reactors/index.ts)_
 
 ## `bt reactors create`
 
@@ -292,7 +386,9 @@ Creates a new Reactor. Requires `reactor:create` Management Application permissi
 
 ```
 USAGE
-  $ bt reactors create -x <value> [-n <value>] [-c <value>] [-i <value>] [-r <value>]
+  $ bt reactors create -x <value> [-n <value>] [-c <value>] [-i <value>] [-r <value>] [--image node-bt|node22]
+    [--package-json <value>] [--timeout <value>] [--warm-concurrency <value>] [--resources standard|large|xlarge]
+    [--permissions <value>] [--async]
 
 FLAGS
   -c, --configuration=<value>   path to configuration file (.env format) to use in the Reactor
@@ -300,12 +396,34 @@ FLAGS
   -n, --name=<value>            name of the Reactor
   -r, --code=<value>            path to JavaScript file containing the Reactor code
   -x, --management-key=<value>  (required) management key used for connecting with the reactor / proxy
+  --async                       do not wait for resource to be ready (node22 only)
+  --image=<option>              runtime image (node-bt|node22)
+                                <options: node-bt|node22>
+  --package-json=<value>        path to runtime package.json JSON file (top-level dependencies required; supports
+                                resolutions or overrides fallback; pinned versions required) (node22 only)
+  --permissions=<value>...      permission to grant, repeatable (node22 only)
+  --resources=<option>          resource tier (node22 only, default: standard)
+                                <options: standard|large|xlarge>
+  --timeout=<value>             timeout in seconds, 1-30 (node22 only, default: 10)
+  --warm-concurrency=<value>    number of warm instances, 0-1 (node22 only, default: 0)
 
 DESCRIPTION
   Creates a new Reactor. Requires `reactor:create` Management Application permission
 
 EXAMPLES
-  $ bt reactors create
+  Create a reactor with legacy runtime
+
+    $ bt reactors create --name "My Reactor" --code ./reactor.js --image node-bt --application-id <application-id>
+
+  Create a reactor with node22 runtime
+
+    $ bt reactors create --name "My Reactor" --code ./reactor.js --image node22
+
+  Create a reactor with node22 and all runtime options
+
+    $ bt reactors create --name "My Reactor" --code ./reactor.js --configuration ./config.env --image node22 \
+      --timeout 10 --warm-concurrency 0 --resources standard --package-json ./package.json --permissions token:read \
+      --permissions token:create
 ```
 
 ## `bt reactors delete ID`
@@ -362,7 +480,9 @@ Updates an existing Reactor. Requires `reactor:update` Management Application pe
 
 ```
 USAGE
-  $ bt reactors update ID -x <value> [-n <value>] [-c <value>] [-i <value>] [-r <value>] [-w] [-l]
+  $ bt reactors update ID -x <value> [-n <value>] [-c <value>] [-i <value>] [-r <value>] [--image node-bt|node22]
+    [--package-json <value>] [--timeout <value>] [--warm-concurrency <value>] [--resources standard|large|xlarge]
+    [--permissions <value>] [--async] [-w] [-l]
 
 ARGUMENTS
   ID  Reactor id to update
@@ -375,15 +495,33 @@ FLAGS
   -r, --code=<value>            path to JavaScript file containing the Reactor code
   -w, --watch                   Watch for changes in informed files
   -x, --management-key=<value>  (required) management key used for connecting with the reactor / proxy
+  --async                       do not wait for resource to be ready (node22 only)
+  --image=<option>              runtime image (node-bt|node22)
+                                <options: node-bt|node22>
+  --package-json=<value>        path to runtime package.json JSON file (top-level dependencies required; supports
+                                resolutions or overrides fallback; pinned versions required) (node22 only)
+  --permissions=<value>...      permission to grant, repeatable (node22 only)
+  --resources=<option>          resource tier (node22 only, default: standard)
+                                <options: standard|large|xlarge>
+  --timeout=<value>             timeout in seconds, 1-30 (node22 only, default: 10)
+  --warm-concurrency=<value>    number of warm instances, 0-1 (node22 only, default: 0)
 
 DESCRIPTION
   Updates an existing Reactor. Requires `reactor:update` Management Application permission
 
 EXAMPLES
-  $ bt reactors update 03858bf5-32d3-4a2e-b74b-daeea0883bca
+  Update a reactor with legacy runtime
+
+    $ bt reactors update <reactor-id> --code ./reactor.js --image node-bt --application-id <application-id>
+
+  Update a reactor with node22 runtime
+
+    $ bt reactors update <reactor-id> --code ./reactor.js --image node22
 
-  $ bt reactors update 03858bf5-32d3-4a2e-b74b-daeea0883bca --code ./reactor.js
+  Update a reactor with node22 and all runtime options
 
-  $ bt reactors update 03858bf5-32d3-4a2e-b74b-daeea0883bca --configuration ./.env.reactor
+    $ bt reactors update <reactor-id> --name "My Reactor" --code ./reactor.js --configuration ./config.env --image \
+      node22 --timeout 10 --warm-concurrency 0 --resources standard --package-json ./package.json --permissions \
+      token:read --permissions token:create
 ```
 <!-- commandsstop -->

package/dist/base.js

@@ -3,6 +3,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseCommand = void 0;
 const node_sdk_1 = require("@basis-theory/node-sdk");
 const core_1 = require("@oclif/core");
+const formatApiError = (body) => {
+    const parts = [];
+    if (body.title) {
+        const status = body.status ? ` [${body.status}]` : '';
+        parts.push(`${body.title}${status}`);
+    }
+    if (body.detail) {
+        parts.push(`Detail: ${body.detail}`);
+    }
+    if ('errors' in body && body.errors) {
+        for (const [field, messages] of Object.entries(body.errors)) {
+            if (Array.isArray(messages)) {
+                for (const message of messages) {
+                    parts.push(`  - ${field}: ${message}`);
+                }
+            }
+        }
+    }
+    return parts.join('\n');
+};
 class BaseCommand extends core_1.Command {
     async parse(options, argv) {
         const { flags, ...parsed } = await super.parse(options, argv);
@@ -19,7 +39,8 @@ class BaseCommand extends core_1.Command {
     }
     catch(err) {
         if (err instanceof node_sdk_1.BasisTheoryError && err.body) {
-            this.logJson(err.body);
+            const formatted = formatApiError(err.body);
+            return super.catch(new core_1.Errors.CLIError(formatted));
         }
         return super.catch(err);
     }

package/dist/commands/proxies/create.d.ts

@@ -2,7 +2,10 @@
 import { BaseCommand } from '../../base';
 export default class Create extends BaseCommand {
     static description: string;
-    static examples: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
     static flags: {
         name: import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'destination-url': import("@oclif/core/lib/interfaces/parser").OptionFlag<import("url").URL | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
@@ -11,6 +14,19 @@ export default class Create extends BaseCommand {
         'application-id': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         configuration: import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'require-auth': import("@oclif/core/lib/interfaces/parser").BooleanFlag<boolean>;
+        'request-transform-image': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-package-json': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-timeout': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-warm-concurrency': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-resources': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-permissions': import("@oclif/core/lib/interfaces/parser").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-image': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-package-json': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-timeout': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-warm-concurrency': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-resources': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-permissions': import("@oclif/core/lib/interfaces/parser").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        async: import("@oclif/core/lib/interfaces/parser").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/proxies/create.js

@@ -2,12 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const base_1 = require("../../base");
 const management_1 = require("../../proxies/management");
+const runtime_1 = require("../../proxies/runtime");
 const utils_1 = require("../../proxies/utils");
+const runtime_2 = require("../../runtime");
 const utils_2 = require("../../utils");
 class Create extends base_1.BaseCommand {
     async run() {
         var _a, _b;
         const { flags, metadata, bt } = await this.parse(Create);
+        (0, runtime_1.validateTransformRuntimeFlags)('request-transform', flags, flags['request-transform-image']);
+        (0, runtime_1.validateTransformRuntimeFlags)('response-transform', flags, flags['response-transform-image']);
         const name = await (0, utils_2.promptStringIfUndefined)(flags.name, {
             message: 'What is the Proxy name?',
             validate: (value) => Boolean(value),
@@ -18,12 +22,22 @@ class Create extends base_1.BaseCommand {
         const requestTransformCode = await (0, utils_2.promptStringIfUndefined)(flags['request-transform-code'], {
             message: '(Optional) Enter the Request Transform code file path:',
         });
+        const requestTransformImage = requestTransformCode
+            ? await (0, runtime_2.promptRuntimeImage)(flags['request-transform-image'], 'Which runtime do you want for the request transform?')
+            : flags['request-transform-image'];
         const responseTransformCode = await (0, utils_2.promptStringIfUndefined)(flags['response-transform-code'], {
             message: '(Optional) Enter the Response Transform code file path:',
         });
-        const applicationId = await (0, utils_2.promptStringIfUndefined)(flags['application-id'], {
-            message: '(Optional) Enter the Application ID to use in the Proxy:',
-        });
+        const responseTransformImage = responseTransformCode
+            ? await (0, runtime_2.promptRuntimeImage)(flags['response-transform-image'], 'Which runtime do you want for the response transform?')
+            : flags['response-transform-image'];
+        const hasLegacyTransform = (0, runtime_2.isLegacyRuntimeImage)(requestTransformImage) ||
+            (0, runtime_2.isLegacyRuntimeImage)(responseTransformImage);
+        const applicationId = hasLegacyTransform
+            ? await (0, utils_2.promptStringIfUndefined)(flags['application-id'], {
+                message: '(Optional) Enter the Application ID to use in the Proxy:',
+            })
+            : flags['application-id'];
         const configuration = await (0, utils_2.promptStringIfUndefined)(flags.configuration, {
             message: '(Optional) Enter the configuration file path (.env format):',
         });
@@ -33,6 +47,14 @@ class Create extends base_1.BaseCommand {
             message: 'Does the Proxy require Basis Theory authentication?',
             default: true,
         });
+        const updatedFlags = {
+            ...flags,
+            'request-transform-image': requestTransformImage,
+            'response-transform-image': responseTransformImage,
+        };
+        (0, runtime_1.validateProxyApplicationId)(applicationId, updatedFlags);
+        const requestTransformRuntime = await (0, runtime_1.promptTransformRuntime)('request', flags, requestTransformCode, requestTransformImage);
+        const responseTransformRuntime = await (0, runtime_1.promptTransformRuntime)('response', flags, responseTransformCode, responseTransformImage);
         const model = (0, utils_1.createModelFromFlags)({
             name,
             destinationUrl,
@@ -41,16 +63,70 @@ class Create extends base_1.BaseCommand {
             applicationId,
             configuration,
             requireAuth,
+            requestTransformRuntime,
+            responseTransformRuntime,
         });
-        const { id, key } = await (0, management_1.createProxy)(bt, model);
-        this.log('Proxy created successfully!');
-        this.log(`id: ${id}`);
-        this.log(`key: ${key}`);
+        const proxy = await (0, management_1.createProxy)(bt, model);
+        if (!flags.async && proxy.id) {
+            try {
+                await (0, runtime_2.waitForResourceState)(bt, 'proxy', proxy.id, proxy.state);
+                this.log('Proxy created successfully!');
+                this.log(`id: ${proxy.id}`);
+                this.log(`key: ${proxy.key}`);
+            }
+            catch (error) {
+                this.log('Proxy created but failed to become ready.');
+                this.log(`id: ${proxy.id}`);
+                this.log(`key: ${proxy.key}`);
+                this.log(`You can retry by running: bt proxies update ${proxy.id} [OPTIONS]`);
+                throw error;
+            }
+        }
+        else {
+            this.log('Proxy created successfully!');
+            this.log(`id: ${proxy.id}`);
+            this.log(`key: ${proxy.key}`);
+        }
     }
 }
 exports.default = Create;
 Create.description = 'Creates a new Pre-Configured Proxy. Requires `proxy:create` Management Application permission';
-Create.examples = ['<%= config.bin %> <%= command.id %> '];
+Create.examples = [
+    {
+        description: 'Create a proxy without transforms',
+        command: '<%= config.bin %> <%= command.id %> --name "My Proxy" --destination-url https://api.example.com',
+    },
+    {
+        description: 'Create a proxy with legacy runtime transforms',
+        command: '<%= config.bin %> <%= command.id %> --name "My Proxy" --destination-url https://api.example.com --request-transform-code ./request.js --request-transform-image node-bt --application-id <application-id>',
+    },
+    {
+        description: 'Create a proxy with node22 transforms',
+        command: '<%= config.bin %> <%= command.id %> --name "My Proxy" --destination-url https://api.example.com --request-transform-code ./request.js --request-transform-image node22 --response-transform-code ./response.js --response-transform-image node22',
+    },
+    {
+        description: 'Create a proxy with node22 transforms and all runtime options',
+        command: '<%= config.bin %> <%= command.id %> ' +
+            '--name "My Proxy" ' +
+            '--destination-url https://api.example.com ' +
+            '--configuration ./config.env ' +
+            '--require-auth ' +
+            '--request-transform-code ./request.js ' +
+            '--request-transform-image node22 ' +
+            '--request-transform-timeout 10 ' +
+            '--request-transform-warm-concurrency 0 ' +
+            '--request-transform-resources standard ' +
+            '--request-transform-package-json ./request/package.json ' +
+            '--request-transform-permissions token:read ' +
+            '--response-transform-code ./response.js ' +
+            '--response-transform-image node22 ' +
+            '--response-transform-timeout 10 ' +
+            '--response-transform-warm-concurrency 0 ' +
+            '--response-transform-resources standard ' +
+            '--response-transform-package-json ./response/package.json ' +
+            '--response-transform-permissions token:read',
+    },
+];
 Create.flags = {
     ...utils_1.PROXY_FLAGS,
 };

package/dist/commands/proxies/update.d.ts

@@ -2,7 +2,10 @@
 import { BaseCommand } from '../../base';
 export default class Update extends BaseCommand {
     static description: string;
-    static examples: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
     static flags: {
         watch: import("@oclif/core/lib/interfaces/parser").BooleanFlag<boolean>;
         logs: import("@oclif/core/lib/interfaces/parser").BooleanFlag<boolean>;
@@ -13,6 +16,19 @@ export default class Update extends BaseCommand {
         'application-id': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         configuration: import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
         'require-auth': import("@oclif/core/lib/interfaces/parser").BooleanFlag<boolean>;
+        'request-transform-image': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-package-json': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-timeout': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-warm-concurrency': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-resources': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'request-transform-permissions': import("@oclif/core/lib/interfaces/parser").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-image': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-package-json': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-timeout': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-warm-concurrency': import("@oclif/core/lib/interfaces/parser").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-resources': import("@oclif/core/lib/interfaces/parser").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'response-transform-permissions': import("@oclif/core/lib/interfaces/parser").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        async: import("@oclif/core/lib/interfaces/parser").BooleanFlag<boolean>;
     };
     static args: {
         id: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;