@terros-inc/cli 1.0.5 → 1.0.7

package/cli.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import './dist/index.js'
+import './dist/index.js'

package/dist/api/analytics.js

@@ -0,0 +1,12 @@
+import { join } from 'node:path';
+import { platform, release } from 'node:os';
+import { readFileSync } from 'node:fs';
+export function getAnalyticsHeaders() {
+    const packageJson = JSON.parse(readFileSync(join(import.meta.url, 'package.json'), 'utf8'));
+    return {
+        'Terros-Platform': platform(),
+        'Terros-Platform-Version': release(),
+        'Terros-Bundle-Identifier': 'com.terros.cli',
+        'Terros-App-Version': packageJson.version,
+    };
+}

package/dist/api/query.js

@@ -1,13 +1,32 @@
+import * as process from 'node:process';
 import { getAuthorizationHeader } from "./auth.js";
+import { getAnalyticsHeaders } from "./analytics.js";
 export async function queryTerrosAPI(path, input) {
+    const endpoint = getApiEndpoint();
+    const impersonation = getImpersonationHeaders();
+    const analytics = getAnalyticsHeaders();
     const authorization = await getAuthorizationHeader();
-    const res = await fetch(`https://api.terros.com${path}`, {
+    const res = await fetch(`${endpoint}${path}`, {
         method: 'POST',
         headers: {
+            ...analytics,
+            ...impersonation,
             Authorization: authorization,
             'Content-Type': 'application/json',
         },
-        body: JSON.stringify(input)
+        body: JSON.stringify(input),
     });
-    return await res.json();
+    return (await res.json());
+}
+function getApiEndpoint() {
+    const envEndpoint = process.env.TERROS_API_ENDPOINT;
+    if (envEndpoint)
+        return envEndpoint;
+    return 'https://api.terros.com';
+}
+function getImpersonationHeaders() {
+    const userId = process.env.TERROS_IMPERSONATE;
+    if (userId)
+        return { impersonate_user_id: userId };
+    return {};
 }

package/dist/auth/auth0.js

@@ -1,20 +1,20 @@
+import open from 'open';
+import { DateTime } from 'luxon';
 import { AUTH0_CLIENT_ID, AUTH0_DOMAIN } from "./constants.js";
-import open from "open";
-import { DateTime } from "luxon";
 export async function signInToAuth0() {
     const res = await fetch(`${AUTH0_DOMAIN}/oauth/device/code`, {
         method: 'POST',
         headers: {
-            "Content-Type": 'application/json'
+            'Content-Type': 'application/json',
         },
         body: JSON.stringify({
             client_id: AUTH0_CLIENT_ID,
-            scope: 'offline_access'
-        })
+            scope: 'offline_access',
+        }),
     });
     if (!res.ok)
         throw new Error('Failed to get OAuth device code');
-    const body = await res.json();
+    const body = (await res.json());
     const deadline = DateTime.now().plus({ seconds: body.expires_in });
     await open(body.verification_uri_complete);
     console.log(`Confirm that the code in your browser matches: ${body.user_code}`);
@@ -33,36 +33,36 @@ async function pollForToken(deadline, interval, deviceCode) {
     const res = await fetch(`${AUTH0_DOMAIN}/oauth/token`, {
         method: 'POST',
         headers: {
-            "Content-Type": 'application/json',
+            'Content-Type': 'application/json',
         },
         body: JSON.stringify({
             client_id: AUTH0_CLIENT_ID,
             grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
-            device_code: deviceCode
-        })
+            device_code: deviceCode,
+        }),
     });
     if (!res.ok) {
-        const body = await res.json();
+        const body = (await res.json());
         if (body.error === 'access_denied')
             throw new Error('Authorization request denied');
         return pollForToken(deadline, interval, deviceCode);
     }
-    return await res.json();
+    return (await res.json());
 }
 export async function refreshTokens(refreshToken) {
     const res = await fetch(`${AUTH0_DOMAIN}/oauth/token`, {
         method: 'POST',
         headers: {
-            'Content-Type': 'application/json'
+            'Content-Type': 'application/json',
         },
         body: JSON.stringify({
             client_id: AUTH0_CLIENT_ID,
             grant_type: 'refresh_token',
-            refresh_token: refreshToken
-        })
+            refresh_token: refreshToken,
+        }),
     });
     if (res.ok) {
-        return await res.json();
+        return (await res.json());
     }
     throw new Error('Unable to refresh token, it may be expired. Run `terros auth login` to sign in again');
 }

package/dist/auth/tokens.js

@@ -1,8 +1,8 @@
-import { DateTime } from 'luxon';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { mkdir, writeFile, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { DateTime } from 'luxon';
 import { refreshTokens } from "./auth0.js";
 export async function getTokens() {
     const tokens = await readTokens();

package/dist/commands/auth.js

@@ -1,5 +1,5 @@
-import { signInToAuth0 } from "../auth/auth0.js";
 import { getTokens, saveTokens } from "../auth/tokens.js";
+import { signInToAuth0 } from "../auth/auth0.js";
 export const authCommands = {
     login: {
         description: 'Sign in to Terros',
@@ -18,6 +18,6 @@ export const authCommands = {
                 return;
             }
             console.log(tokens.access_token);
-        }
-    }
+        },
+    },
 };

package/dist/crud/index.js

@@ -1,6 +1,6 @@
-import { readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { readFileSync } from 'node:fs';
 import { parse } from 'yaml';
 import { getPathParts } from "./util.js";
 import { getEndpointParameters } from "./parameters.js";

package/dist/crud/input.js

@@ -6,7 +6,7 @@ export function buildEndpointInput(endpoint, params) {
     if (unknownParameterNames.length > 0) {
         throw new Error(`Unknown parameter(s): ${unknownParameterNames.map((name) => `--${name}`).join(', ')}`);
     }
-    const missingParameters = endpoint.parameters.filter((parameter) => (parameter.required && !Object.hasOwn(parsedParams, parameter.name)));
+    const missingParameters = endpoint.parameters.filter((parameter) => parameter.required && !Object.hasOwn(parsedParams, parameter.name));
     if (missingParameters.length > 0) {
         throw new Error(`Missing required parameter(s): ${missingParameters.map((parameter) => `--${parameter.name}`).join(', ')}`);
     }
@@ -47,7 +47,12 @@ function getHiddenWrapperPrefix(endpoint) {
     if (propertyNames.length !== 1)
         return [];
     const wrapperName = propertyNames[0];
-    return wrapperName ? [wrapperName] : [];
+    if (!wrapperName)
+        return [];
+    const wrapperSchema = schema.properties[wrapperName];
+    if (!wrapperSchema || !('type' in wrapperSchema) || wrapperSchema.type !== 'object')
+        return [];
+    return [wrapperName];
 }
 function setNestedValue(input, path, value) {
     if (path.length === 0) {

package/dist/crud/input.test.js

@@ -0,0 +1,69 @@
+import { expect } from 'vitest';
+import { buildEndpointInput } from "./input.js";
+describe('buildEndpointInput', () => {
+    it('should not add a hidden wrapper prefix for a single non-object property', () => {
+        const endpoint = {
+            path: '/user/profile',
+            parameters: [
+                {
+                    name: 'userId',
+                    type: 'string',
+                    required: false,
+                },
+            ],
+            properties: {
+                type: 'object',
+                properties: {
+                    userId: {
+                        type: 'string',
+                    },
+                },
+            },
+        };
+        const params = {
+            _: ['user', 'profile'],
+            userId: 'U:dj',
+        };
+        const expected = {
+            userId: 'U:dj',
+        };
+        const result = buildEndpointInput(endpoint, params);
+        expect(result).toEqual(expected);
+    });
+    it('should add a hidden wrapper prefix for a single object property', () => {
+        const endpoint = {
+            path: '/user/profile',
+            parameters: [
+                {
+                    name: 'userId',
+                    type: 'string',
+                    required: false,
+                },
+            ],
+            properties: {
+                type: 'object',
+                properties: {
+                    profile: {
+                        type: 'object',
+                        properties: {
+                            userId: {
+                                type: 'string',
+                            },
+                        },
+                    },
+                },
+            },
+        };
+        const params = {
+            _: ['user', 'profile'],
+            userId: 'U:dj',
+        };
+        const expected = {
+            profile: {
+                userId: 'U:dj',
+            },
+        };
+        const result = buildEndpointInput(endpoint, params);
+        expect(result).toEqual(expected);
+    });
+});

package/dist/crud/parameters.js

@@ -37,9 +37,7 @@ function resolveSchema(schema, components, seen = new Set()) {
 }
 function flattenSchema(schema, context) {
     const resolved = resolveSchema(schema, context.components);
-    if ('type' in resolved
-        && resolved.type === 'object'
-        && resolved.properties) {
+    if ('type' in resolved && resolved.type === 'object' && resolved.properties) {
         return Object.entries(resolved.properties).flatMap(([name, childSchema]) => {
             const required = resolved.required?.includes(name) ?? false;
             return flattenSchema(childSchema, {
@@ -54,7 +52,7 @@ function flattenSchema(schema, context) {
             name: context.path.join('.'),
             type: getSchemaType(resolved, context.components),
             required: context.required,
-            ...(schema.description ?? resolved.description
+            ...((schema.description ?? resolved.description)
                 ? { description: schema.description ?? resolved.description }
                 : {}),
         },
@@ -69,9 +67,7 @@ function hideSingleObjectWrapper(parameters) {
         return parameters;
     return parameters.map((parameter) => ({
         ...parameter,
-        name: parameter.name.startsWith(`${wrapperName}.`)
-            ? parameter.name.slice(wrapperName.length + 1)
-            : parameter.name,
+        name: parameter.name.startsWith(`${wrapperName}.`) ? parameter.name.slice(wrapperName.length + 1) : parameter.name,
     }));
 }
 export function getEndpointParameters(schema, components) {

package/dist/index.js

@@ -1,9 +1,9 @@
 import minimist from 'minimist';
 import { formatCommandsHelp, formatSubcommandParametersHelp, formatSubcommandsHelp, HELP_PARENT_MESSAGE, } from "./messages.js";
-import { loadEndpoints } from "./crud/index.js";
 import { buildEndpointInput } from "./crud/input.js";
+import { loadEndpoints } from "./crud/index.js";
+import { getCommandGroup, getCommandNames, getSubcommand, getSubcommandNames } from "./commands/index.js";
 import { queryTerrosAPI } from "./api/query.js";
-import { getCommandGroup, getCommandNames, getSubcommand, getSubcommandNames, } from "./commands/index.js";
 async function main() {
     const params = minimist(process.argv.slice(2));
     const commands = params._;

package/dist/messages.js

@@ -29,11 +29,7 @@ export function formatSubcommandsHelp(command, subcommands) {
     return lines.join('\n');
 }
 export function formatSubcommandParametersHelp(command, subcommand, parameters) {
-    const lines = [
-        `usage: terros ${command} ${subcommand} [parameters]`,
-        '',
-        'Parameters:',
-    ];
+    const lines = [`usage: terros ${command} ${subcommand} [parameters]`, '', 'Parameters:'];
     if (parameters.length === 0) {
         lines.push('  none');
         return lines.join('\n');

package/package.json

@@ -14,10 +14,13 @@
   },
   "description": "Command-line interface for Terros Sales platform",
   "devDependencies": {
+    "@types/luxon": "^3.7.1",
     "@types/minimist": "^1.2.5",
     "@types/node": "^24.13.1",
+    "oxfmt": "^0.54.0",
+    "oxlint": "^1.69.0",
     "typescript": "^6.0.3",
-    "@types/luxon": "^3.7.1"
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=24"
@@ -44,10 +47,12 @@
     "url": "git+https://github.com/terros-inc/cli.git"
   },
   "type": "module",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "scripts": {
     "fetch-openapi": "wget https://docs.terros.com/openapi/terros.yml",
     "build": "tsc",
+    "lint": "oxlint",
+    "test": "vitest run",
     "start": "node src/index.ts"
   }
 }

package/terros.yml

@@ -2922,9 +2922,9 @@ paths:
                   evalDate: 9007199254740991
                   teamId: Team.123
                   categories: []
-                  createdAt: 1781654399759
+                  createdAt: 1781726665720
                   createdBy: U:123
-                  updatedAt: 1781654399760
+                  updatedAt: 1781726665720
                   updatedBy: U:123
                   user:
                     userId: U:123
@@ -2990,9 +2990,9 @@ paths:
                   evalDate: 9007199254740991
                   teamId: Team.123
                   categories: []
-                  createdAt: 1781654399759
+                  createdAt: 1781726665720
                   createdBy: U:123
-                  updatedAt: 1781654399760
+                  updatedAt: 1781726665720
                   updatedBy: U:123
                   user:
                     userId: U:123
@@ -3199,9 +3199,9 @@ paths:
                   evalDate: 9007199254740991
                   teamId: Team.123
                   categories: []
-                  createdAt: 1781654399759
+                  createdAt: 1781726665720
                   createdBy: U:123
-                  updatedAt: 1781654399760
+                  updatedAt: 1781726665720
                   updatedBy: U:123
                   user:
                     userId: U:123
@@ -4699,7 +4699,7 @@ paths:
               task:
                 taskId: Task.123
                 status: Completed
-                completedAt: 1781654399759
+                completedAt: 1781726665719
             schema:
               type: object
               properties:
@@ -6842,8 +6842,8 @@ webhooks:
                       email: jdoe@example.com
                     evalState: Pending
                     possible: 10
-                    createdAt: "1781654399760"
-                    updatedAt: "1781654399760"
+                    createdAt: "1781726665720"
+                    updatedAt: "1781726665720"
               Evaluation Updated:
                 value:
                   entity: Evaluation
@@ -6858,8 +6858,8 @@ webhooks:
                       email: jdoe@example.com
                     evalState: Pending
                     possible: 10
-                    createdAt: "1781654399760"
-                    updatedAt: "1781654399760"
+                    createdAt: "1781726665720"
+                    updatedAt: "1781726665720"
               Evaluation Removed:
                 value:
                   entity: Evaluation
@@ -6974,8 +6974,8 @@ webhooks:
                       longitude: -104.9942
                     parentId: Team.AFCWest
                     description: Professional American football team based in Denver, Colorado.
-                    createdAt: 2026-06-16T23:59:59.756Z
-                    updatedAt: 2026-06-16T23:59:59.756Z
+                    createdAt: 2026-06-17T20:04:25.717Z
+                    updatedAt: 2026-06-17T20:04:25.717Z
                     members: []
               Team Updated:
                 value:
@@ -6991,8 +6991,8 @@ webhooks:
                       longitude: -104.9942
                     parentId: Team.AFCWest
                     description: Professional American football team based in Denver, Colorado.
-                    createdAt: 2026-06-16T23:59:59.756Z
-                    updatedAt: 2026-06-16T23:59:59.756Z
+                    createdAt: 2026-06-17T20:04:25.717Z
+                    updatedAt: 2026-06-17T20:04:25.717Z
                     members:
                       - userId: U:user123
                         lastName: Smith
@@ -7102,8 +7102,8 @@ webhooks:
                     email: john.smith@company.com
                     firstName: John
                     lastName: Smith
-                    createdAt: "1781654399756"
-                    updatedAt: "1781654399756"
+                    createdAt: "1781726665716"
+                    updatedAt: "1781726665716"
               User Updated:
                 value:
                   entity: User
@@ -7113,8 +7113,8 @@ webhooks:
                     email: john.smith@company.com
                     firstName: John
                     lastName: Smith
-                    createdAt: "1781654399756"
-                    updatedAt: "1781654399756"
+                    createdAt: "1781726665716"
+                    updatedAt: "1781726665716"
               User Removed:
                 value:
                   entity: User
@@ -7187,7 +7187,7 @@ components:
       maximum: 8640000000000000
       title: Timestamp
       description: A timestamp in UTC milliseconds
-      example: 1781654399510
+      example: 1781726665493
     latlng:
       type: object
       properties: