@seamapi/cli 0.18.1 → 0.19.0

package/lib/args/coerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.js","sourceRoot":"","sources":["../../src/lib/args/coerce.ts"],"names":[],"mappings":"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"}

package/lib/{util/cli-args.d.ts → args/parse.d.ts}

@@ -20,24 +20,21 @@ export declare const interactivityFlags: string[];
  * and are therefore never sent as command parameters.
  */
 export declare const cliFlags: string[];
-/**
- * Thrown when the CLI needs input it cannot prompt for.
- */
-export declare class NonInteractiveError extends Error {
-    name: string;
+export interface ParseCliArgsOptions {
+    /**
+     * Argument keys read exactly as given rather than by guessing at a type,
+     * e.g., every parameter of an endpoint that does not take a number or a
+     * boolean. Read as a number, an opaque value like an access code would
+     * lose leading zeroes or turn exponent notation into a digit string.
+     */
+    stringKeys?: string[];
 }
+export declare const parseCliArgs: (argv: string[], { stringKeys }?: ParseCliArgsOptions) => ParsedArgs;
 /**
- * Thrown when the arguments do not name something the CLI can run.
+ * The request params among the parsed arguments: every key normalized to
+ * the parameter it names, minus the flags that configure the CLI itself.
  */
-export declare class UsageError extends Error {
-    name: string;
-    /** What to run instead, reported after the message. */
-    readonly hint: string;
-    constructor(message: string, { hint }?: {
-        hint?: string;
-    });
-}
-export declare const parseCliArgs: (argv: string[]) => ParsedArgs;
+export declare const toArgParams: (args: ParsedArgs) => Record<string, unknown>;
 export interface GetInteractivityOptions {
     /**
      * Whether there is a terminal to prompt on.

package/lib/{util/cli-args.js → args/parse.js}

@@ -22,34 +22,31 @@ export const cliFlags = [
     'update',
     'version',
 ];
-/**
- * Thrown when the CLI needs input it cannot prompt for.
- */
-export class NonInteractiveError extends Error {
-    name = 'NonInteractiveError';
-}
-/**
- * Thrown when the arguments do not name something the CLI can run.
- */
-export class UsageError extends Error {
-    name = 'UsageError';
-    /** What to run instead, reported after the message. */
-    hint;
-    constructor(message, { hint = '' } = {}) {
-        super(message);
-        this.hint = hint;
-    }
-}
-export const parseCliArgs = (argv) => parseArgs(argv, {
-    // A page cursor is opaque, so keep it exactly as given: read as a number
-    // it would lose leading zeroes and turn exponent notation into a digit
-    // string, naming a page the API never issued.
-    string: ['code', 'page-cursor', 'page_cursor'],
+export const parseCliArgs = (argv, { stringKeys = [] } = {}) => parseArgs(argv, {
+    // A page cursor and a code are opaque even before the endpoint's own
+    // parameter types are known, so always keep them exactly as given.
+    string: ['code', 'page-cursor', 'page_cursor', ...stringKeys],
     boolean: ['non-interactive', 'interactive', 'json'],
     // Deliberately not aliased to -n, which is reserved for a future
     // --dry-run flag.
     alias: { 'non-interactive': 'y', interactive: 'i' },
 });
+/**
+ * The request params among the parsed arguments: every key normalized to
+ * the parameter it names, minus the flags that configure the CLI itself.
+ */
+export const toArgParams = (args) => {
+    const argParams = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (key === '_')
+            continue;
+        const name = toParameterName(key);
+        if (cliFlags.includes(name))
+            continue;
+        argParams[name] = value;
+    }
+    return argParams;
+};
 export const getInteractivity = (args, { canPrompt = true } = {}) => {
     const isNonInteractive = args['non_interactive'] === true || args['y'] === true;
     const isInteractive = args['interactive'] === true || args['i'] === true;
@@ -80,4 +77,4 @@ export const toParameterName = (argKey) => argKey.toLowerCase().replace(/-/g, '_
  * key as the short form it can only have been written as, e.g., `-n`.
  */
 export const toGivenArgName = (argKey) => argKey.length === 1 ? `-${argKey}` : toArgName(argKey);
-//# sourceMappingURL=cli-args.js.map
+//# sourceMappingURL=parse.js.map

package/lib/args/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/lib/args/parse.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAmB,MAAM,UAAU,CAAA;AAcrD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,iBAAiB;IACjB,GAAG;IACH,aAAa;IACb,GAAG;CACJ,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,GAAG,kBAAkB;IACrB,GAAG;IACH,MAAM;IACN,MAAM;IACN,iBAAiB;IACjB,QAAQ;IACR,SAAS;CACV,CAAA;AAYD,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,IAAc,EACd,EAAE,UAAU,GAAG,EAAE,KAA0B,EAAE,EACjC,EAAE,CACd,SAAS,CAAC,IAAI,EAAE;IACd,qEAAqE;IACrE,mEAAmE;IACnE,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,UAAU,CAAC;IAC7D,OAAO,EAAE,CAAC,iBAAiB,EAAE,aAAa,EAAE,MAAM,CAAC;IACnD,iEAAiE;IACjE,kBAAkB;IAClB,KAAK,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE;CACpD,CAAC,CAAA;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAgB,EAA2B,EAAE;IACvE,MAAM,SAAS,GAA4B,EAAE,CAAA;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,GAAG;YAAE,SAAQ;QACzB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAQ;QACrC,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAaD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAAgB,EAChB,EAAE,SAAS,GAAG,IAAI,KAA8B,EAAE,EACnC,EAAE;IACjB,MAAM,gBAAgB,GACpB,IAAI,CAAC,iBAAiB,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;IACxD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;IAExE,IAAI,gBAAgB,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAA;IACH,CAAC;IACD,IAAI,gBAAgB;QAAE,OAAO,iBAAiB,CAAA;IAC9C,uEAAuE;IACvE,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,IAAI,CAAC,SAAS;QAAE,OAAO,iBAAiB,CAAA;IACxC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,aAAqB,EAAU,EAAE,CACzD,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE,CACxD,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE,CACvD,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA"}

package/lib/args/validate.d.ts

@@ -0,0 +1,23 @@
+import type { Parameter } from '@seamapi/blueprint';
+/**
+ * Report every required parameter still missing from the params, rather
+ * than prompting for it.
+ *
+ * @param target What the params are for, e.g., `/devices/list`.
+ */
+export declare const assertRequiredParams: (parameters: Parameter[], params: Record<string, unknown>, target: string) => void;
+/**
+ * Report any argument the command does not accept, rather than acting on it.
+ * An unrecognized argument is a mistake: forwarded to the API it would fail
+ * somewhere less obvious or be quietly ignored, and on a command the CLI
+ * handles itself it would go nowhere at all.
+ *
+ * Only arguments are checked. Params read from stdin are passed through as
+ * given, so a caller may send whatever the API itself accepts.
+ */
+export declare const assertKnownArgs: (argParams: Record<string, unknown>, command: string[], { accepted, isLocal, }: {
+    /** Parameter names the command accepts. */
+    accepted: Set<string>;
+    /** Whether the CLI handles the command itself. */
+    isLocal: boolean;
+}) => void;

package/lib/args/validate.js

@@ -0,0 +1,42 @@
+import { NonInteractiveError, UsageError } from '../errors.js';
+import { toArgName, toGivenArgName } from './parse.js';
+/**
+ * Report every required parameter still missing from the params, rather
+ * than prompting for it.
+ *
+ * @param target What the params are for, e.g., `/devices/list`.
+ */
+export const assertRequiredParams = (parameters, params, target) => {
+    // A required parameter is satisfied by being present, not by being
+    // truthy: `false`, `0` and `''` are values a caller can supply.
+    const missing = parameters
+        .filter((parameter) => parameter.isRequired)
+        .map((parameter) => parameter.name)
+        .filter((name) => params[name] === undefined);
+    if (missing.length === 0)
+        return;
+    throw new NonInteractiveError(`Missing required ${missing.length === 1 ? 'parameter' : 'parameters'} for ${target}: ${missing.map(toArgName).join(' ')}`);
+};
+/**
+ * Report any argument the command does not accept, rather than acting on it.
+ * An unrecognized argument is a mistake: forwarded to the API it would fail
+ * somewhere less obvious or be quietly ignored, and on a command the CLI
+ * handles itself it would go nowhere at all.
+ *
+ * Only arguments are checked. Params read from stdin are passed through as
+ * given, so a caller may send whatever the API itself accepts.
+ */
+export const assertKnownArgs = (argParams, command, { accepted, isLocal, }) => {
+    const unknown = Object.keys(argParams).filter((key) => !accepted.has(key));
+    if (unknown.length === 0)
+        return;
+    // Name an endpoint command by its path, as missing params are named, and a
+    // command the CLI handles itself by the words that run it.
+    const target = isLocal
+        ? command.join(' ')
+        : `/${command.join('/').replace(/-/g, '_')}`;
+    throw new UsageError(`Unknown ${unknown.length === 1 ? 'parameter' : 'parameters'} for ${target}: ${unknown.map(toGivenArgName).join(' ')}`, {
+        hint: `Run 'seam ${command.join(' ')} --help' to see what it accepts.`,
+    });
+};
+//# sourceMappingURL=validate.js.map

package/lib/args/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/lib/args/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,UAAuB,EACvB,MAA+B,EAC/B,MAAc,EACR,EAAE;IACR,mEAAmE;IACnE,gEAAgE;IAChE,MAAM,OAAO,GAAG,UAAU;SACvB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC;SAC3C,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;SAClC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAA;IAE/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEhC,MAAM,IAAI,mBAAmB,CAC3B,oBACE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YACvC,QAAQ,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACtD,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,SAAkC,EAClC,OAAiB,EACjB,EACE,QAAQ,EACR,OAAO,GAMR,EACK,EAAE;IACR,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEhC,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAM,MAAM,GAAG,OAAO;QACpB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QACnB,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAA;IAE9C,MAAM,IAAI,UAAU,CAClB,WACE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YACvC,QAAQ,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAC1D;QACE,IAAI,EAAE,aAAa,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,kCAAkC;KACvE,CACF,CAAA;AACH,CAAC,CAAA"}

package/lib/auth/operations.d.ts

@@ -0,0 +1,54 @@
+import { type ConfigStore } from '../config/index.js';
+import { type AuthContext } from '../context.js';
+import { validateToken } from './validate-token.js';
+/** A stored auth setting an environment variable may override. */
+export type AuthSetting = 'server' | 'token' | 'workspaceId';
+/**
+ * Refuse to store a setting the environment overrides.
+ *
+ * The env-override policy lives here alone: every auth mutation asserts
+ * through this before writing, so a command that appears to succeed cannot
+ * leave the CLI using something else.
+ *
+ * @param action What the command does, e.g., `log in`.
+ */
+export declare const assertMutable: (auth: AuthContext, setting: AuthSetting, action: string) => void;
+export interface LoginOptions {
+    server?: string | undefined;
+    token?: string | undefined;
+    workspaceId?: string | undefined;
+}
+/**
+ * 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.
+ *
+ * Validation reaches the network, so a test may inject its own `validate`.
+ */
+export declare const login: ({ server, token, workspaceId }: LoginOptions, config?: ConfigStore, validate?: typeof validateToken) => Promise<void>;
+/** Store the token for the current server, e.g., one just prompted for. */
+export declare const storeToken: (token: string, config?: ConfigStore) => void;
+/** Remove the stored token and workspace selection. */
+export declare const logout: (config?: ConfigStore) => void;
+/**
+ * Store the server to make requests against.
+ *
+ * The workspace selection belongs to the previous server, so it is cleared.
+ */
+export declare const selectServer: (server: string, config?: ConfigStore) => void;
+/** Store the workspace requests are made against. */
+export declare const selectWorkspace: (workspaceId: string, config?: ConfigStore) => void;
+/**
+ * Point the CLI at a fake Seam Connect server and store the well-known
+ * token it accepts. Returns the generated server URL for reporting.
+ */
+export declare const selectFakeServer: ({ urlSeed, config, }?: {
+    urlSeed?: string;
+    config?: ConfigStore;
+}) => {
+    server: string;
+    token: string;
+};
+/** Store whether API definitions come from the server instead of npm. */
+export declare const setUseRemoteApiDefs: (useRemoteApiDefs: boolean, config?: ConfigStore) => void;

package/lib/auth/operations.js

@@ -0,0 +1,115 @@
+import { randomBytes } from 'node:crypto';
+import { getConfigStore } from '../config/index.js';
+import { resolveAuth } from '../context.js';
+import { assertEnvVarUnset, endpointEnvVar, tokenEnvVar, workspaceIdEnvVar, } from '../env.js';
+import { validateToken } from './validate-token.js';
+/**
+ * Refuse to store a setting the environment overrides.
+ *
+ * The env-override policy lives here alone: every auth mutation asserts
+ * through this before writing, so a command that appears to succeed cannot
+ * leave the CLI using something else.
+ *
+ * @param action What the command does, e.g., `log in`.
+ */
+export const assertMutable = (auth, setting, action) => {
+    const { envVar, source, value } = {
+        server: {
+            envVar: endpointEnvVar,
+            source: auth.serverSource,
+            value: auth.server,
+        },
+        token: { envVar: tokenEnvVar, source: auth.tokenSource, value: auth.token },
+        workspaceId: {
+            envVar: workspaceIdEnvVar,
+            source: auth.workspaceIdSource,
+            value: auth.workspaceId,
+        },
+    }[setting];
+    if (source !== 'env')
+        return;
+    assertEnvVarUnset(envVar, value, action);
+};
+/**
+ * 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.
+ *
+ * Validation reaches the network, so a test may inject its own `validate`.
+ */
+export const login = async ({ server, token, workspaceId }, config = getConfigStore(), validate = validateToken) => {
+    let auth = resolveAuth(config);
+    // 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 (workspaceId != null) {
+        assertMutable(auth, 'workspaceId', 'select a workspace');
+    }
+    if (server != null) {
+        config.set('server', server);
+        config.delete('current_workspace_id');
+        auth = resolveAuth(config);
+    }
+    if (token != null) {
+        await validate(token, workspaceId);
+        config.set(`${auth.server}.pat`, token);
+        config.delete('current_workspace_id');
+    }
+    if (workspaceId != null) {
+        config.set('current_workspace_id', workspaceId);
+    }
+};
+/** Store the token for the current server, e.g., one just prompted for. */
+export const storeToken = (token, config = getConfigStore()) => {
+    const auth = resolveAuth(config);
+    assertMutable(auth, 'token', 'log in');
+    config.set(`${auth.server}.pat`, token);
+};
+/** Remove the stored token and workspace selection. */
+export const logout = (config = getConfigStore()) => {
+    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
+    // un-namespaced token, so drop that too.
+    config.delete('pat');
+    config.delete('current_workspace_id');
+};
+/**
+ * Store the server to make requests against.
+ *
+ * The workspace selection belongs to the previous server, so it is cleared.
+ */
+export const selectServer = (server, config = getConfigStore()) => {
+    assertMutable(resolveAuth(config), 'server', 'select a server');
+    config.set('server', server);
+    config.delete('current_workspace_id');
+};
+/** Store the workspace requests are made against. */
+export const selectWorkspace = (workspaceId, config = getConfigStore()) => {
+    assertMutable(resolveAuth(config), 'workspaceId', 'select a workspace');
+    config.set('current_workspace_id', workspaceId);
+};
+/**
+ * Point the CLI at a fake Seam Connect server and store the well-known
+ * token it accepts. Returns the generated server URL for reporting.
+ */
+export const selectFakeServer = ({ urlSeed = randomBytes(5).toString('hex'), config = getConfigStore(), } = {}) => {
+    const auth = resolveAuth(config);
+    assertMutable(auth, 'server', 'select a server');
+    assertMutable(auth, 'token', 'log in');
+    const server = `https://${urlSeed}.fakeseamconnect.seam.vc`;
+    const token = 'seam_apikey1_token';
+    config.set('server', server);
+    config.set(`${server}.pat`, token);
+    config.delete('current_workspace_id');
+    return { server, token };
+};
+/** Store whether API definitions come from the server instead of npm. */
+export const setUseRemoteApiDefs = (useRemoteApiDefs, config = getConfigStore()) => {
+    config.set('use_remote_api_defs', useRemoteApiDefs);
+};
+//# sourceMappingURL=operations.js.map

package/lib/auth/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/lib/auth/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAoB,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAoB,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAKnD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAAiB,EACjB,OAAoB,EACpB,MAAc,EACR,EAAE;IACR,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;QAChC,MAAM,EAAE;YACN,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,IAAI,CAAC,YAAY;YACzB,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB;QACD,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;QAC3E,WAAW,EAAE;YACX,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,IAAI,CAAC,iBAAiB;YAC9B,KAAK,EAAE,IAAI,CAAC,WAAW;SACxB;KACF,CAAC,OAAO,CAAC,CAAA;IAEV,IAAI,MAAM,KAAK,KAAK;QAAE,OAAM;IAC5B,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AAC1C,CAAC,CAAA;AAQD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EACxB,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAgB,EAC5C,SAAsB,cAAc,EAAE,EACtC,WAAiC,aAAa,EAC/B,EAAE;IACjB,IAAI,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAE9B,yEAAyE;IACzE,iDAAiD;IACjD,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACtC,IAAI,MAAM,IAAI,IAAI;QAAE,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAA;IACpE,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;QACrC,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,MAAM,EAAE,KAAK,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;IACvC,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAA;IACjD,CAAC;AACH,CAAC,CAAA;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAAa,EACb,SAAsB,cAAc,EAAE,EAChC,EAAE;IACR,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACtC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,MAAM,EAAE,KAAK,CAAC,CAAA;AACzC,CAAC,CAAA;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAsB,cAAc,EAAE,EAAQ,EAAE;IACrE,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IACvC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,MAAM,CAAC,CAAA;IACnC,yEAAyE;IACzE,yCAAyC;IACzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpB,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;AACvC,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAc,EACd,SAAsB,cAAc,EAAE,EAChC,EAAE;IACR,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAA;IAC/D,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;AACvC,CAAC,CAAA;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,WAAmB,EACnB,SAAsB,cAAc,EAAE,EAChC,EAAE;IACR,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAA;IACvE,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAA;AACjD,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EACxC,MAAM,GAAG,cAAc,EAAE,MAIvB,EAAE,EAAqC,EAAE;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAA;IAChD,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IAEtC,MAAM,MAAM,GAAG,WAAW,OAAO,0BAA0B,CAAA;IAC3D,MAAM,KAAK,GAAG,oBAAoB,CAAA;IAClC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,MAAM,EAAE,KAAK,CAAC,CAAA;IAClC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;IAErC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC1B,CAAC,CAAA;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,gBAAyB,EACzB,SAAsB,cAAc,EAAE,EAChC,EAAE;IACR,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAA;AACrD,CAAC,CAAA"}

package/lib/{validate-token.js → auth/validate-token.js}

@@ -1,7 +1,7 @@
 import { isApiKey, isPersonalAccessToken, SeamHttp, SeamHttpWithoutWorkspace, } from '@seamapi/http/connect';
-import { getServer } from './get-server.js';
+import { resolveAuth } from '../context.js';
 export const validateToken = async (token, workspaceId) => {
-    const options = { endpoint: getServer() };
+    const options = { endpoint: resolveAuth().server };
     if (isPersonalAccessToken(token)) {
         const seam = workspaceId
             ? SeamHttp.fromPersonalAccessToken(token, workspaceId, options)

package/lib/auth/validate-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-token.js","sourceRoot":"","sources":["../../src/lib/auth/validate-token.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,QAAQ,EACR,wBAAwB,GACzB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAa,EAAE,WAAoB,EAAE,EAAE;IACzE,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,CAAA;IAElD,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,WAAW;YACtB,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC;YAC/D,CAAC,CAAC,wBAAwB,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACpE,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;QAC5B,OAAM;IACR,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAChD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;QAC5B,OAAM;IACR,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;AAC/E,CAAC,CAAA"}

package/lib/blueprint/cache.d.ts

@@ -0,0 +1,16 @@
+import type { Blueprint } from '@seamapi/blueprint';
+export interface BlueprintCache {
+    blueprintVersion: string;
+    typesVersion: string;
+    checkedAt: string;
+    blueprint: Blueprint;
+}
+export declare const getCacheFile: (cacheDirectory: string) => string;
+export declare const readCache: (file: string) => Promise<BlueprintCache | null>;
+export declare const writeCache: (file: string, cache: BlueprintCache) => Promise<void>;
+export declare const isUpdateCheckDue: (checkedAt: string) => boolean;
+/**
+ * The blueprint version the cache is keyed on: a cached blueprint built by a
+ * different @seamapi/blueprint version is stale even for the same types.
+ */
+export declare const getBlueprintVersion: () => Promise<string>;

package/lib/blueprint/cache.js

@@ -0,0 +1,73 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { seamapiBlueprintVersion } from '../version.js';
+const cacheFileName = 'blueprint.json';
+const updateCheckInterval = 24 * 60 * 60 * 1000;
+export const getCacheFile = (cacheDirectory) => join(cacheDirectory, cacheFileName);
+export const readCache = async (file) => {
+    try {
+        const contents = await readFile(file, 'utf8');
+        const cache = JSON.parse(contents);
+        if (!isBlueprintCache(cache))
+            return null;
+        return cache;
+    }
+    catch {
+        return null;
+    }
+};
+export const writeCache = async (file, cache) => {
+    const temporaryFile = `${file}.tmp`;
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(temporaryFile, `${JSON.stringify(cache)}\n`, 'utf8');
+    await rename(temporaryFile, file);
+};
+export const isUpdateCheckDue = (checkedAt) => {
+    const checkedAtTime = Date.parse(checkedAt);
+    if (Number.isNaN(checkedAtTime))
+        return true;
+    return Date.now() - checkedAtTime > updateCheckInterval;
+};
+/**
+ * The blueprint version the cache is keyed on: a cached blueprint built by a
+ * different @seamapi/blueprint version is stale even for the same types.
+ */
+export const getBlueprintVersion = async () => {
+    if (seamapiBlueprintVersion !== '0.0.0')
+        return seamapiBlueprintVersion;
+    // The version is only injected when the package is packed, so a
+    // development checkout reads the pinned version from package.json
+    // to keep invalidating the cache on version changes as expected.
+    const pkg = await findOwnPackageJson();
+    return pkg?.dependencies?.['@seamapi/blueprint'] ?? seamapiBlueprintVersion;
+};
+const findOwnPackageJson = async () => {
+    let directory = dirname(fileURLToPath(import.meta.url));
+    while (true) {
+        try {
+            const contents = await readFile(join(directory, 'package.json'), 'utf8');
+            const pkg = JSON.parse(contents);
+            if (pkg.name === '@seamapi/cli')
+                return pkg;
+        }
+        catch {
+            // Keep walking up until a package.json for this package is found.
+        }
+        const parent = dirname(directory);
+        if (parent === directory)
+            return null;
+        directory = parent;
+    }
+};
+const isBlueprintCache = (cache) => {
+    if (cache == null || typeof cache !== 'object')
+        return false;
+    const { blueprintVersion, typesVersion, checkedAt, blueprint } = cache;
+    return (typeof blueprintVersion === 'string' &&
+        typeof typesVersion === 'string' &&
+        typeof checkedAt === 'string' &&
+        blueprint != null &&
+        typeof blueprint === 'object');
+};
+//# sourceMappingURL=cache.js.map

package/lib/blueprint/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/lib/blueprint/cache.ts"],"names":[],"mappings":"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"}

package/lib/blueprint/endpoint.d.ts

@@ -0,0 +1,14 @@
+import type { ApiBlueprint } from './index.js';
+export declare const getCommandBlueprintDef: (cmd: string[], helpers: {
+    blueprint: ApiBlueprint;
+}) => import("@seamapi/blueprint").Endpoint;
+/**
+ * The top level response key documented for a command,
+ * e.g., `devices` for `seam devices list`.
+ *
+ * Returns null when the command is not in the blueprint,
+ * or when it does not respond with a resource.
+ */
+export declare const getResponseKey: (command: string[], ctx: {
+    blueprint: ApiBlueprint;
+}) => string | null;

package/lib/{get-response-key.js → blueprint/endpoint.js}

@@ -1,4 +1,13 @@
-import { getCommandBlueprintDef } from './get-command-blueprint-def.js';
+export const getCommandBlueprintDef = (cmd, helpers) => {
+    const path = `/${cmd.join('/').replace(/-/g, '_')}`;
+    const def = helpers.blueprint.routes
+        .flatMap((route) => route.endpoints)
+        .find((endpoint) => endpoint.path === path);
+    if (!def) {
+        throw new Error(`No definition for path ${path}`);
+    }
+    return def;
+};
 /**
  * The top level response key documented for a command,
  * e.g., `devices` for `seam devices list`.
@@ -18,4 +27,4 @@ export const getResponseKey = (command, ctx) => {
         return null;
     return endpoint.response.responseKey;
 };
-//# sourceMappingURL=get-response-key.js.map
+//# sourceMappingURL=endpoint.js.map

package/lib/blueprint/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/lib/blueprint/endpoint.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,GAAa,EACb,OAAoC,EACpC,EAAE;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAA;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM;SACjC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;SACnC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAiB,EACjB,GAAgC,EACjB,EAAE;IACjB,IAAI,QAAQ,CAAA;IACZ,IAAI,CAAC;QACH,QAAQ,GAAG,sBAAsB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAE1D,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAA;AACtC,CAAC,CAAA"}

package/lib/blueprint/index.d.ts

@@ -0,0 +1,12 @@
+import type { Blueprint } from '@seamapi/blueprint';
+export type ApiBlueprint = Blueprint;
+export interface GetApiBlueprintOptions {
+    /**
+     * Build from the OpenAPI document the configured server is currently
+     * running, instead of the published npm types.
+     */
+    useRemoteDefinitions?: boolean;
+    /** Force an update of the cached Seam API definitions. */
+    update?: boolean;
+}
+export declare const getApiBlueprint: ({ useRemoteDefinitions, update, }?: GetApiBlueprintOptions) => Promise<ApiBlueprint>;

package/lib/blueprint/index.js

@@ -0,0 +1,10 @@
+import { getBlueprint } from './source-npm.js';
+import { createRemoteBlueprint } from './source-remote.js';
+export const getApiBlueprint = async ({ useRemoteDefinitions = false, update = false, } = {}) => {
+    // Remote definitions describe whatever the server is currently running, so
+    // build them directly from the server's OpenAPI document.
+    if (useRemoteDefinitions)
+        return await createRemoteBlueprint();
+    return await getBlueprint({ update });
+};
+//# sourceMappingURL=index.js.map

package/lib/blueprint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/blueprint/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAc1D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,EACpC,oBAAoB,GAAG,KAAK,EAC5B,MAAM,GAAG,KAAK,MACY,EAAE,EAAyB,EAAE;IACvD,2EAA2E;IAC3E,0DAA0D;IAC1D,IAAI,oBAAoB;QAAE,OAAO,MAAM,qBAAqB,EAAE,CAAA;IAE9D,OAAO,MAAM,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;AACvC,CAAC,CAAA"}

package/lib/blueprint/source-npm.d.ts

@@ -0,0 +1,10 @@
+import type { Blueprint } from '@seamapi/blueprint';
+export interface GetBlueprintOptions {
+    update?: boolean;
+    cacheDirectory?: string;
+}
+/**
+ * Build a blueprint from the latest published Seam API types on npm,
+ * using the on-disk cache unless it is stale or an update is forced.
+ */
+export declare const getBlueprint: (options?: GetBlueprintOptions) => Promise<Blueprint>;