@seamapi/cli 0.19.0 → 0.20.0

package/lib/http/client.js

@@ -3,7 +3,7 @@ import { resolveAuth } from '../context.js';
 import { tokenEnvVar, workspaceIdEnvVar } from '../env.js';
 export const getSeam = async (auth = resolveAuth()) => {
     const token = getRequiredToken(auth);
-    const options = { endpoint: auth.server };
+    const options = { endpoint: auth.endpoint };
     if (isPersonalAccessToken(token)) {
         return SeamHttp.fromPersonalAccessToken(token, getRequiredWorkspaceId(auth), options);
     }
@@ -14,7 +14,7 @@ export const getSeam = async (auth = resolveAuth()) => {
 };
 export const getSeamMultiWorkspace = async (auth = resolveAuth()) => {
     const token = getRequiredToken(auth);
-    const options = { endpoint: auth.server };
+    const options = { endpoint: auth.endpoint };
     if (isPersonalAccessToken(token)) {
         return SeamHttpWithoutWorkspace.fromPersonalAccessToken(token, options);
     }

package/lib/http/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/http/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,QAAQ,EACR,wBAAwB,GACzB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAoB,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAC1B,OAAoB,WAAW,EAAE,EACd,EAAE;IACrB,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAEpC,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAEzC,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,uBAAuB,CACrC,KAAK,EACL,sBAAsB,CAAC,IAAI,CAAC,EAC5B,OAAO,CACR,CAAA;IACH,CAAC;IAED,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,uBAAuB,CACrC,KAAK,EACL,sBAAsB,CAAC,IAAI,CAAC,EAC5B,OAAO,CACR,CAAA;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,OAAoB,WAAW,EAAE,EACa,EAAE;IAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAEzC,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,wBAAwB,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,IAAiB,EAAU,EAAE;IACrD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAEtB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,8CAA8C,WAAW,uBAAuB,CACjF,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,IAAiB,EAAU,EAAE;IAC3D,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAE5B,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,iEAAiE,iBAAiB,uBAAuB,CAC1G,CAAA;IACH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/http/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,QAAQ,EACR,wBAAwB,GACzB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAoB,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAC1B,OAAoB,WAAW,EAAE,EACd,EAAE;IACrB,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAEpC,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA;IAE3C,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,uBAAuB,CACrC,KAAK,EACL,sBAAsB,CAAC,IAAI,CAAC,EAC5B,OAAO,CACR,CAAA;IACH,CAAC;IAED,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,uBAAuB,CACrC,KAAK,EACL,sBAAsB,CAAC,IAAI,CAAC,EAC5B,OAAO,CACR,CAAA;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,OAAoB,WAAW,EAAE,EACa,EAAE;IAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA;IAE3C,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,wBAAwB,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,IAAiB,EAAU,EAAE;IACrD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAEtB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,8CAA8C,WAAW,uBAAuB,CACjF,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,IAAiB,EAAU,EAAE;IAC3D,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAE5B,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,iEAAiE,iBAAiB,uBAAuB,CAC1G,CAAA;IACH,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}

package/lib/interactions/endpoint-selection.d.ts

@@ -0,0 +1 @@
+export declare function interactForEndpointSelection(): Promise<void>;

package/lib/interactions/endpoint-selection.js

@@ -0,0 +1,39 @@
+import { randomBytes } from 'node:crypto';
+import { assertMutable, selectEndpoint, selectFakeEndpoint, } from '../auth/operations.js';
+import { getConfigStore } from '../config/index.js';
+import { resolveAuth } from '../context.js';
+import { getOutput } from '../output/get-output.js';
+import { promptAutocomplete, promptText } from '../prompt.js';
+export async function interactForEndpointSelection() {
+    const config = getConfigStore();
+    assertMutable(resolveAuth(config), 'endpoint', 'select an endpoint');
+    const endpoints = [
+        'http://localhost:3020',
+        'https://connect.getseam.com',
+        'https://fakeseamconnect.seam.vc',
+    ];
+    // Searchable, as selecting a device or a command is.
+    const endpoint = await promptAutocomplete({
+        message: 'Select an endpoint:',
+        choices: endpoints.map((endpoint) => ({
+            label: endpoint,
+            value: endpoint,
+        })),
+    });
+    const output = getOutput();
+    if (endpoint === endpoints[2]) {
+        let userUrlSeed = await promptText({
+            message: 'You can input a custom endpoint URL or leave this field empty to use a new fakeserver.',
+        });
+        if (userUrlSeed.trim().length === 0) {
+            userUrlSeed = randomBytes(5).toString('hex');
+        }
+        selectFakeEndpoint({ urlSeed: userUrlSeed, config });
+        output.info(`PAT set to use fakeseamconnect with "seam_apikey1_token"`);
+    }
+    else {
+        selectEndpoint(endpoint, config);
+    }
+    output.info(`Endpoint set to ${endpoint}`);
+}
+//# sourceMappingURL=endpoint-selection.js.map

package/lib/interactions/endpoint-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-selection.js","sourceRoot":"","sources":["../../src/lib/interactions/endpoint-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EACL,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE9D,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAA;IAEpE,MAAM,SAAS,GAAG;QAChB,uBAAuB;QACvB,6BAA6B;QAC7B,iCAAiC;KAClC,CAAA;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;QACxC,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACpC,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;KACJ,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9B,IAAI,WAAW,GAAG,MAAM,UAAU,CAAC;YACjC,OAAO,EACL,wFAAwF;SAC3F,CAAC,CAAA;QAEF,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC9C,CAAC;QACD,kBAAkB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAA;QACpD,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAA;IACzE,CAAC;SAAM,CAAC;QACN,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAA;AAC5C,CAAC"}

package/lib/interactions/index.d.ts

@@ -10,9 +10,9 @@ export * from './command-selection.js';
 export * from './connected-account.js';
 export * from './custom-metadata.js';
 export * from './device.js';
+export * from './endpoint-selection.js';
 export * from './login.js';
 export * from './resource.js';
-export * from './server-selection.js';
 export * from './timestamp.js';
 export * from './use-remote-api-defs.js';
 export * from './user-identity.js';

package/lib/interactions/index.js

@@ -10,9 +10,9 @@ export * from './command-selection.js';
 export * from './connected-account.js';
 export * from './custom-metadata.js';
 export * from './device.js';
+export * from './endpoint-selection.js';
 export * from './login.js';
 export * from './resource.js';
-export * from './server-selection.js';
 export * from './timestamp.js';
 export * from './use-remote-api-defs.js';
 export * from './user-identity.js';

package/lib/interactions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/interactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/interactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,yBAAyB,CAAA;AACvC,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA"}

package/lib/interactions/login.js

@@ -14,8 +14,8 @@ export const interactForLogin = async () => {
     const auth = resolveAuth(config);
     // Refuse before prompting: nothing typed here could be stored.
     assertMutable(auth, 'token', 'log in');
-    if (auth.server.includes('localhost')) {
-        output.info(`You're using a local Seam Connect instance, you can enter the API Key to your local user, you can create a new user from:\n\n${auth.server}/admin/create_user_with_api_key`);
+    if (auth.endpoint.includes('localhost')) {
+        output.info(`You're using a local Seam Connect instance, you can enter the API Key to your local user, you can create a new user from:\n\n${auth.endpoint}/admin/create_user_with_api_key`);
     }
     else {
         output.info(`To login, navigate to the URL below and create a new Personal Access Token (PAT) and paste the PAT in the provided box:\n\nhttps://console.seam.co/settings/access-tokens\n\n`);

package/lib/interactions/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/lib/interactions/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAAI,EAAE;IACzC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAEhC,+DAA+D;IAC/D,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IAEtC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CACT,gIAAgI,IAAI,CAAC,MAAM,iCAAiC,CAC7K,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CACT,+KAA+K,CAChL,CAAA;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,IAAI,CACR,mEAAmE,CACpE,CACF,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC;QAC3B,OAAO,EAAE,wBAAwB;KAClC,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IAExB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;IACtC,CAAC;IAED,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;SAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IACxE,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAA;IACH,CAAC;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;AAC1D,CAAC,CAAA"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/lib/interactions/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAAI,EAAE;IACzC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAEhC,+DAA+D;IAC/D,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IAEtC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CACT,gIAAgI,IAAI,CAAC,QAAQ,iCAAiC,CAC/K,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CACT,+KAA+K,CAChL,CAAA;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,IAAI,CACR,mEAAmE,CACpE,CACF,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC;QAC3B,OAAO,EAAE,wBAAwB;KAClC,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IAExB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;IACtC,CAAC;IAED,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;SAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IACxE,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAA;IACH,CAAC;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;AAC1D,CAAC,CAAA"}

package/lib/interactions/workspace-id.js

@@ -11,7 +11,7 @@ export const interactForWorkspaceId = async (personalAccessToken) => {
     assertMutable(resolveAuth(config), 'workspaceId', 'select a workspace');
     const seam = personalAccessToken
         ? SeamHttpWithoutWorkspace.fromPersonalAccessToken(personalAccessToken, {
-            endpoint: resolveAuth(config).server,
+            endpoint: resolveAuth(config).endpoint,
         })
         : await getSeamMultiWorkspace();
     const workspaces = await withLoading('Fetching workspaces...', () => seam.workspaces.list());

package/lib/interactions/workspace-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-id.js","sourceRoot":"","sources":["../../src/lib/interactions/workspace-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,mBAA4B,EAAE,EAAE;IAC3E,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAE/B,kEAAkE;IAClE,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAA;IAEvE,MAAM,IAAI,GAAG,mBAAmB;QAC9B,CAAC,CAAC,wBAAwB,CAAC,uBAAuB,CAAC,mBAAmB,EAAE;YACpE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM;SACrC,CAAC;QACJ,CAAC,CAAC,MAAM,qBAAqB,EAAE,CAAA;IAEjC,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAClE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CACvB,CAAA;IACD,yEAAyE;IACzE,wCAAwC;IACxC,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAS;QACnD,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAc,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK,EAAE,SAAS,CAAC,IAAI;YACrB,KAAK,EAAE,SAAS,CAAC,YAAY;YAC7B,IAAI,EAAE,SAAS,CAAC,YAAY;SAC7B,CAAC,CAAC;KACJ,CAAC,CAAA;IAEF,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IACpC,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}
+{"version":3,"file":"workspace-id.js","sourceRoot":"","sources":["../../src/lib/interactions/workspace-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,mBAA4B,EAAE,EAAE;IAC3E,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAE/B,kEAAkE;IAClE,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAA;IAEvE,MAAM,IAAI,GAAG,mBAAmB;QAC9B,CAAC,CAAC,wBAAwB,CAAC,uBAAuB,CAAC,mBAAmB,EAAE;YACpE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ;SACvC,CAAC;QACJ,CAAC,CAAC,MAAM,qBAAqB,EAAE,CAAA;IAEjC,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAClE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CACvB,CAAA;IACD,yEAAyE;IACzE,wCAAwC;IACxC,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAS;QACnD,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAc,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK,EAAE,SAAS,CAAC,IAAI;YACrB,KAAK,EAAE,SAAS,CAAC,YAAY;YAC7B,IAAI,EAAE,SAAS,CAAC,YAAY;SAC7B,CAAC,CAAC;KACJ,CAAC,CAAA;IAEF,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IACpC,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}

package/lib/version.d.ts

@@ -1,4 +1,4 @@
-declare const seamapiCliVersion = "0.19.0";
+declare const seamapiCliVersion = "0.20.0";
 declare const seamapiBlueprintVersion = "1.5.0";
 export { seamapiBlueprintVersion };
 export default seamapiCliVersion;

package/lib/version.js

@@ -1,5 +1,5 @@
 // Versions are replaced with generated values when the package is packed.
-const seamapiCliVersion = '0.19.0';
+const seamapiCliVersion = '0.20.0';
 const seamapiBlueprintVersion = '1.5.0';
 export { seamapiBlueprintVersion };
 export default seamapiCliVersion;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/cli",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "A command-line interface (CLI) for interacting with the Seam API.",
   "type": "module",
   "main": "index.js",

package/src/bin/cli.ts

@@ -122,12 +122,12 @@ async function cli(args: ParsedArgs, argv: string[]) {
   const localCommand = findLocalCommand(args._)
 
   // Commands declared not to need a token bypass the login gate. A partial
-  // path keeps the historical rule: only login and select server may be
+  // path keeps the historical rule: only login and select endpoint may be
   // reached logged out.
   const requiresAuth =
     localCommand != null
       ? localCommand.requiresAuth
-      : !(args._[0] === 'login' || isEqual(args._, ['select', 'server']))
+      : !(args._[0] === 'login' || isEqual(args._, ['select', 'endpoint']))
 
   if (requiresAuth && resolveAuth(config).token == null) {
     output.error(`Not logged in. Please run "seam login" or set ${tokenEnvVar}`)

package/src/lib/auth/operations.ts

@@ -12,7 +12,7 @@ import {
 import { validateToken } from './validate-token.js'
 
 /** A stored auth setting an environment variable may override. */
-export type AuthSetting = 'server' | 'token' | 'workspaceId'
+export type AuthSetting = 'endpoint' | 'token' | 'workspaceId'
 
 /**
  * Refuse to store a setting the environment overrides.
@@ -29,10 +29,10 @@ export const assertMutable = (
   action: string,
 ): void => {
   const { envVar, source, value } = {
-    server: {
+    endpoint: {
       envVar: endpointEnvVar,
-      source: auth.serverSource,
-      value: auth.server,
+      source: auth.endpointSource,
+      value: auth.endpoint,
     },
     token: { envVar: tokenEnvVar, source: auth.tokenSource, value: auth.token },
     workspaceId: {
@@ -47,7 +47,7 @@ export const assertMutable = (
 }
 
 export interface LoginOptions {
-  server?: string | undefined
+  endpoint?: string | undefined
   token?: string | undefined
   workspaceId?: string | undefined
 }
@@ -55,13 +55,13 @@ export interface LoginOptions {
 /**
  * Store the given credentials, validating the token first.
  *
- * The token is stored under the server it will be used with, so a given
- * server is stored and re-resolved before the token key is derived.
+ * The token is stored under the endpoint it will be used with, so a given
+ * endpoint is stored and re-resolved before the token key is derived.
  *
  * Validation reaches the network, so a test may inject its own `validate`.
  */
 export const login = async (
-  { server, token, workspaceId }: LoginOptions,
+  { endpoint, token, workspaceId }: LoginOptions,
   config: ConfigStore = getConfigStore(),
   validate: typeof validateToken = validateToken,
 ): Promise<void> => {
@@ -70,20 +70,19 @@ export const login = async (
   // Nothing is stored while the environment overrides it, so refuse before
   // storing anything rather than part way through.
   assertMutable(auth, 'token', 'log in')
-  if (server != null) assertMutable(auth, 'server', 'select a server')
+  if (endpoint != null) assertMutable(auth, 'endpoint', 'select an endpoint')
   if (workspaceId != null) {
     assertMutable(auth, 'workspaceId', 'select a workspace')
   }
 
-  if (server != null) {
-    config.set('server', server)
-    config.delete('current_workspace_id')
+  if (endpoint != null) {
+    storeEndpoint(endpoint, config)
     auth = resolveAuth(config)
   }
 
   if (token != null) {
     await validate(token, workspaceId)
-    config.set(`${auth.server}.pat`, token)
+    config.set(`${auth.endpoint}.pat`, token)
     config.delete('current_workspace_id')
   }
 
@@ -92,39 +91,38 @@ export const login = async (
   }
 }
 
-/** Store the token for the current server, e.g., one just prompted for. */
+/** Store the token for the current endpoint, e.g., one just prompted for. */
 export const storeToken = (
   token: string,
   config: ConfigStore = getConfigStore(),
 ): void => {
   const auth = resolveAuth(config)
   assertMutable(auth, 'token', 'log in')
-  config.set(`${auth.server}.pat`, token)
+  config.set(`${auth.endpoint}.pat`, token)
 }
 
 /** Remove the stored token and workspace selection. */
 export const logout = (config: ConfigStore = getConfigStore()): void => {
   const auth = resolveAuth(config)
   assertMutable(auth, 'token', 'log out')
-  config.delete(`${auth.server}.pat`)
-  // Configs written before tokens were stored per server may still hold an
+  config.delete(`${auth.endpoint}.pat`)
+  // Configs written before tokens were stored per endpoint may still hold an
   // un-namespaced token, so drop that too.
   config.delete('pat')
   config.delete('current_workspace_id')
 }
 
 /**
- * Store the server to make requests against.
+ * Store the endpoint to make requests against.
  *
- * The workspace selection belongs to the previous server, so it is cleared.
+ * The workspace selection belongs to the previous endpoint, so it is cleared.
  */
-export const selectServer = (
-  server: string,
+export const selectEndpoint = (
+  endpoint: string,
   config: ConfigStore = getConfigStore(),
 ): void => {
-  assertMutable(resolveAuth(config), 'server', 'select a server')
-  config.set('server', server)
-  config.delete('current_workspace_id')
+  assertMutable(resolveAuth(config), 'endpoint', 'select an endpoint')
+  storeEndpoint(endpoint, config)
 }
 
 /** Store the workspace requests are made against. */
@@ -137,33 +135,43 @@ export const selectWorkspace = (
 }
 
 /**
- * Point the CLI at a fake Seam Connect server and store the well-known
- * token it accepts. Returns the generated server URL for reporting.
+ * Point the CLI at a fake Seam Connect endpoint and store the well-known
+ * token it accepts. Returns the generated endpoint URL for reporting.
  */
-export const selectFakeServer = ({
+export const selectFakeEndpoint = ({
   urlSeed = randomBytes(5).toString('hex'),
   config = getConfigStore(),
 }: {
   urlSeed?: string
   config?: ConfigStore
-} = {}): { server: string; token: string } => {
+} = {}): { endpoint: string; token: string } => {
   const auth = resolveAuth(config)
-  assertMutable(auth, 'server', 'select a server')
+  assertMutable(auth, 'endpoint', 'select an endpoint')
   assertMutable(auth, 'token', 'log in')
 
-  const server = `https://${urlSeed}.fakeseamconnect.seam.vc`
+  const endpoint = `https://${urlSeed}.fakeseamconnect.seam.vc`
   const token = 'seam_apikey1_token'
-  config.set('server', server)
-  config.set(`${server}.pat`, token)
-  config.delete('current_workspace_id')
+  storeEndpoint(endpoint, config)
+  config.set(`${endpoint}.pat`, token)
 
-  return { server, token }
+  return { endpoint, token }
 }
 
-/** Store whether API definitions come from the server instead of npm. */
+/** Store whether API definitions come from the endpoint instead of npm. */
 export const setUseRemoteApiDefs = (
   useRemoteApiDefs: boolean,
   config: ConfigStore = getConfigStore(),
 ): void => {
   config.set('use_remote_api_defs', useRemoteApiDefs)
 }
+
+/**
+ * Write the endpoint, dropping what belonged to the previous one: the
+ * workspace selection, and any value left under the legacy `server` key that
+ * {@link resolveAuth} would otherwise still fall back to.
+ */
+const storeEndpoint = (endpoint: string, config: ConfigStore): void => {
+  config.set('endpoint', endpoint)
+  config.delete('server')
+  config.delete('current_workspace_id')
+}

package/src/lib/auth/validate-token.ts

@@ -8,7 +8,7 @@ import {
 import { resolveAuth } from 'lib/context.js'
 
 export const validateToken = async (token: string, workspaceId?: string) => {
-  const options = { endpoint: resolveAuth().server }
+  const options = { endpoint: resolveAuth().endpoint }
 
   if (isPersonalAccessToken(token)) {
     const seam = workspaceId

package/src/lib/blueprint/index.ts

@@ -7,7 +7,7 @@ export type ApiBlueprint = Blueprint
 
 export interface GetApiBlueprintOptions {
   /**
-   * Build from the OpenAPI document the configured server is currently
+   * Build from the OpenAPI document the configured endpoint is currently
    * running, instead of the published npm types.
    */
   useRemoteDefinitions?: boolean
@@ -19,8 +19,8 @@ export const getApiBlueprint = async ({
   useRemoteDefinitions = false,
   update = false,
 }: GetApiBlueprintOptions = {}): Promise<ApiBlueprint> => {
-  // Remote definitions describe whatever the server is currently running, so
-  // build them directly from the server's OpenAPI document.
+  // Remote definitions describe whatever the endpoint is currently running, so
+  // build them directly from that endpoint's OpenAPI document.
   if (useRemoteDefinitions) return await createRemoteBlueprint()
 
   return await getBlueprint({ update })

package/src/lib/blueprint/source-remote.ts

@@ -3,15 +3,15 @@ import type { Blueprint } from '@seamapi/blueprint'
 import { resolveAuth } from 'lib/context.js'
 
 /**
- * Build a blueprint from the OpenAPI document the current server is running,
- * describing exactly what that server accepts rather than what is published.
+ * Build a blueprint from the OpenAPI document the current endpoint is running,
+ * describing exactly what that endpoint accepts rather than what is published.
  */
 export const createRemoteBlueprint = async (): Promise<Blueprint> => {
   const [{ createBlueprint }, { getOpenapiSchema }] = await Promise.all([
     import('@seamapi/blueprint'),
     import('@seamapi/http/connect'),
   ])
-  const openapi = await getOpenapiSchema(resolveAuth().server)
+  const openapi = await getOpenapiSchema(resolveAuth().endpoint)
 
   return await createBlueprint({ openapi }, { omitUndocumented: true })
 }

package/src/lib/commands/local/login.ts

@@ -12,17 +12,17 @@ export const loginCommand: Command = {
     description:
       'Prompts for a personal access token unless one is passed with --token.',
     flags: [
-      stringFlag('server', 'Seam API server to log in to.'),
+      stringFlag('endpoint', 'Seam API endpoint to log in to.'),
       stringFlag('token', 'Personal access token to log in with.'),
       stringFlag('workspace-id', 'Workspace to select after logging in.'),
     ],
   },
   requiresAuth: false,
   execute: async ({ args }, ctx) => {
-    if (args['token'] || args['workspace_id'] || args['server']) {
+    if (args['token'] || args['workspace_id'] || args['endpoint']) {
       await login(
         {
-          server: args['server'] ? args['server'] : undefined,
+          endpoint: args['endpoint'] ? args['endpoint'] : undefined,
           token: args['token'] ? String(args['token']).trim() : undefined,
           workspaceId: args['workspace_id'] ? args['workspace_id'] : undefined,
         },

package/src/lib/commands/local/select-endpoint.ts

@@ -0,0 +1,30 @@
+import { assertMutable, selectEndpoint } from 'lib/auth/operations.js'
+import type { Command } from 'lib/commands/registry.js'
+import { stringFlag } from 'lib/commands/spec.js'
+import { NonInteractiveError } from 'lib/errors.js'
+import { interactForEndpointSelection } from 'lib/interactions/index.js'
+
+export const selectEndpointCommand: Command = {
+  definition: {
+    path: ['select', 'endpoint'],
+    kind: 'cli',
+    title: 'Select the Seam API endpoint.',
+    description: '',
+    flags: [stringFlag('endpoint', 'Seam API endpoint to select.')],
+  },
+  requiresAuth: false,
+  execute: async ({ args }, ctx) => {
+    assertMutable(ctx.auth, 'endpoint', 'select an endpoint')
+    if (args['endpoint']) {
+      selectEndpoint(args['endpoint'], ctx.config)
+      return { kind: 'done' }
+    }
+    if (ctx.interactivity === 'non-interactive') {
+      throw new NonInteractiveError(
+        'Missing required parameter for select endpoint: --endpoint',
+      )
+    }
+    await interactForEndpointSelection()
+    return { kind: 'done' }
+  },
+}

package/src/lib/commands/registry.ts

@@ -7,12 +7,11 @@ import type { CliContext } from 'lib/context.js'
 import { executeApiCommand } from './api-command.js'
 import { createCompletionCommands } from './local/completion.js'
 import { configRevealLocationCommand } from './local/config-reveal-location.js'
-import { configSetFakeServerCommand } from './local/config-set-fake-server.js'
 import { configUseRemoteApiDefsCommand } from './local/config-use-remote-api-defs.js'
 import { healthCommand } from './local/health.js'
 import { loginCommand } from './local/login.js'
 import { logoutCommand } from './local/logout.js'
-import { selectServerCommand } from './local/select-server.js'
+import { selectEndpointCommand } from './local/select-endpoint.js'
 import { selectWorkspaceCommand } from './local/select-workspace.js'
 import { wizardCommand } from './local/wizard.js'
 import {
@@ -72,12 +71,11 @@ const completionCommands = createCompletionCommands(
 export const localCommands: Command[] = [
   ...completionCommands,
   configRevealLocationCommand,
-  configSetFakeServerCommand,
   configUseRemoteApiDefsCommand,
   healthCommand,
   loginCommand,
   logoutCommand,
-  selectServerCommand,
+  selectEndpointCommand,
   selectWorkspaceCommand,
   wizardCommand,
 ]

package/src/lib/context.ts

@@ -9,21 +9,21 @@ import {
 import type { SeamApi } from './http/api.js'
 import type { Output } from './output/output.js'
 
-export const defaultServer = 'https://connect.getseam.com'
+export const defaultEndpoint = 'https://connect.getseam.com'
 
 /** Where a resolved value came from, e.g., to refuse writes the env shadows. */
 export type ValueSource = 'env' | 'config' | 'default'
 
 /**
- * The server, token, and workspace requests are made with.
+ * The endpoint, token, and workspace requests are made with.
  *
  * Resolved in one place so the precedence rule exists once: an environment
- * variable wins over the stored value, and the server falls back to Seam.
+ * variable wins over the stored value, and the endpoint falls back to Seam.
  * The source tags say where each value came from.
  */
 export interface AuthContext {
-  server: string
-  serverSource: ValueSource
+  endpoint: string
+  endpointSource: ValueSource
   token: string | null
   tokenSource: Exclude<ValueSource, 'default'> | null
   workspaceId: string | null
@@ -33,21 +33,25 @@ export interface AuthContext {
 export const resolveAuth = (
   config: ConfigStore = getConfigStore(),
 ): AuthContext => {
-  const envServer = getEndpointFromEnv()
-  const storedServer = config.get('server')
-  const server =
-    envServer ?? (typeof storedServer === 'string' ? storedServer : null)
+  const envEndpoint = getEndpointFromEnv()
+  // Configs written before the endpoint was called one still hold it under
+  // `server`, so fall back to that key rather than silently resetting them.
+  const storedEndpoint = config.get('endpoint') ?? config.get('server')
+  const endpoint =
+    envEndpoint ?? (typeof storedEndpoint === 'string' ? storedEndpoint : null)
 
   const envToken = getTokenFromEnv()
-  const storedToken = readString(config.get(`${server ?? defaultServer}.pat`))
+  const storedToken = readString(
+    config.get(`${endpoint ?? defaultEndpoint}.pat`),
+  )
 
   const envWorkspaceId = getWorkspaceIdFromEnv()
   const storedWorkspaceId = readString(config.get('current_workspace_id'))
 
   return {
-    server: server ?? defaultServer,
-    serverSource:
-      envServer != null ? 'env' : server != null ? 'config' : 'default',
+    endpoint: endpoint ?? defaultEndpoint,
+    endpointSource:
+      envEndpoint != null ? 'env' : endpoint != null ? 'config' : 'default',
     token: envToken ?? storedToken,
     tokenSource:
       envToken != null ? 'env' : storedToken != null ? 'config' : null,

package/src/lib/env.ts

@@ -1,5 +1,5 @@
 /**
- * Credentials and the server may be given in the environment.
+ * Credentials and the endpoint may be given in the environment.
  *
  * Each variable overrides the corresponding stored value for as long as it
  * is set, so any of them may be used per command or per shell. Commands that
@@ -12,7 +12,7 @@ export const tokenEnvVar = 'SEAM_CLI_TOKEN'
 /** Overrides the workspace stored by `seam select workspace`. */
 export const workspaceIdEnvVar = 'SEAM_CLI_WORKSPACE_ID'
 
-/** Overrides the server stored by `seam select server`. */
+/** Overrides the endpoint stored by `seam select endpoint`. */
 export const endpointEnvVar = 'SEAM_CLI_ENDPOINT'
 
 /** Every variable read here is declared on `ProcessEnv` in `env.d.ts`. */

package/src/lib/http/client.ts

@@ -13,7 +13,7 @@ export const getSeam = async (
 ): Promise<SeamHttp> => {
   const token = getRequiredToken(auth)
 
-  const options = { endpoint: auth.server }
+  const options = { endpoint: auth.endpoint }
 
   if (isPersonalAccessToken(token)) {
     return SeamHttp.fromPersonalAccessToken(
@@ -38,7 +38,7 @@ export const getSeamMultiWorkspace = async (
   auth: AuthContext = resolveAuth(),
 ): Promise<SeamHttpWithoutWorkspace | SeamHttp> => {
   const token = getRequiredToken(auth)
-  const options = { endpoint: auth.server }
+  const options = { endpoint: auth.endpoint }
 
   if (isPersonalAccessToken(token)) {
     return SeamHttpWithoutWorkspace.fromPersonalAccessToken(token, options)