@terros-inc/cli 1.0.4 → 1.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Terros Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# Terros CLI
+
+Command-line interface for the Terros Sales platform.
+
+## Requirements
+
+- Node.js 24 or newer
+- A Terros account with access to the platform
+
+## Install
+
+Install the CLI globally with your package manager:
+
+```sh
+npm install -g @terros-inc/cli
+```
+
+After installation, verify that the `terros` command is available:
+
+```sh
+terros help
+```
+
+## Sign In
+
+Authenticate before running Terros API commands:
+
+```sh
+terros auth login
+```
+
+The CLI opens a browser-based device login flow. Confirm that the code shown in
+your browser matches the code printed in the terminal, then finish signing in.
+
+To print the current API access token (for usage in scripts):
+
+```sh
+terros auth token
+```
+
+## Find Commands
+
+Terros CLI uses the pattern:
+
+```sh
+terros <command> <subcommand> [parameters]
+```
+
+List available commands:
+
+```sh
+terros help
+```
+
+List subcommands for a command:
+
+```sh
+terros <command> help
+```
+
+Show parameters for a subcommand:
+
+```sh
+terros <command> <subcommand> help
+```
+
+## Run a Command
+
+Pass parameters as flags:
+
+```sh
+terros <command> <subcommand> --name "Acme Inc." --active true
+```
+
+Parameter values are validated based on the Terros API schema. Supported values
+include strings, numbers, booleans, arrays, and JSON objects.
+
+Examples:
+
+```sh
+terros <command> <subcommand> --count 10
+terros <command> <subcommand> --active true
+terros <command> <subcommand> --ids id_1,id_2,id_3
+terros <command> <subcommand> --metadata '{"source":"cli"}'
+```
+
+Responses are printed as formatted JSON.
+
+## Local Development
+
+Install dependencies:
+
+```sh
+pnpm install
+```
+
+Build the CLI:
+
+```sh
+pnpm build
+```
+
+Run the CLI locally:
+
+```sh
+node dist/index.js help
+```
+
+The published `terros` executable loads the compiled code from `dist/index.js`,
+so run `pnpm build` after changing TypeScript files.
+
+## Troubleshooting
+
+If a command says the CLI is not authorized, sign in again:
+
+```sh
+terros auth login
+```
+
+If a token cannot be refreshed, the saved login may have expired. Run
+`terros auth login` to create a new session.

package/package.json

@@ -44,7 +44,7 @@
     "url": "git+https://github.com/terros-inc/cli.git"
   },
   "type": "module",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "scripts": {
     "fetch-openapi": "wget https://docs.terros.com/openapi/terros.yml",
     "build": "tsc",

package/terros.yml

@@ -2922,9 +2922,9 @@ paths:
                   evalDate: 9007199254740991
                   teamId: Team.123
                   categories: []
-                  createdAt: 1781639069347
+                  createdAt: 1781654399759
                   createdBy: U:123
-                  updatedAt: 1781639069347
+                  updatedAt: 1781654399760
                   updatedBy: U:123
                   user:
                     userId: U:123
@@ -2990,9 +2990,9 @@ paths:
                   evalDate: 9007199254740991
                   teamId: Team.123
                   categories: []
-                  createdAt: 1781639069347
+                  createdAt: 1781654399759
                   createdBy: U:123
-                  updatedAt: 1781639069347
+                  updatedAt: 1781654399760
                   updatedBy: U:123
                   user:
                     userId: U:123
@@ -3199,9 +3199,9 @@ paths:
                   evalDate: 9007199254740991
                   teamId: Team.123
                   categories: []
-                  createdAt: 1781639069347
+                  createdAt: 1781654399759
                   createdBy: U:123
-                  updatedAt: 1781639069347
+                  updatedAt: 1781654399760
                   updatedBy: U:123
                   user:
                     userId: U:123
@@ -4699,7 +4699,7 @@ paths:
               task:
                 taskId: Task.123
                 status: Completed
-                completedAt: 1781639069347
+                completedAt: 1781654399759
             schema:
               type: object
               properties:
@@ -5667,6 +5667,8 @@ paths:
                         $ref: "#/components/schemas/__schema961"
                       kind:
                         $ref: "#/components/schemas/__schema848"
+                      accessStatus:
+                        $ref: "#/components/schemas/__schema850"
                       internalOwnerId:
                         $ref: "#/components/schemas/__schema962"
                       billingEmail:
@@ -5695,8 +5697,6 @@ paths:
                         $ref: "#/components/schemas/companyId"
                       stripeCustomerId:
                         $ref: "#/components/schemas/__schema971"
-                      accessStatus:
-                        $ref: "#/components/schemas/__schema850"
                       accessOverride:
                         $ref: "#/components/schemas/__schema972"
                       highestTeamLevel:
@@ -6842,8 +6842,8 @@ webhooks:
                       email: jdoe@example.com
                     evalState: Pending
                     possible: 10
-                    createdAt: "1781639069347"
-                    updatedAt: "1781639069347"
+                    createdAt: "1781654399760"
+                    updatedAt: "1781654399760"
               Evaluation Updated:
                 value:
                   entity: Evaluation
@@ -6858,8 +6858,8 @@ webhooks:
                       email: jdoe@example.com
                     evalState: Pending
                     possible: 10
-                    createdAt: "1781639069347"
-                    updatedAt: "1781639069347"
+                    createdAt: "1781654399760"
+                    updatedAt: "1781654399760"
               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-16T19:44:29.344Z
-                    updatedAt: 2026-06-16T19:44:29.344Z
+                    createdAt: 2026-06-16T23:59:59.756Z
+                    updatedAt: 2026-06-16T23:59:59.756Z
                     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-16T19:44:29.344Z
-                    updatedAt: 2026-06-16T19:44:29.344Z
+                    createdAt: 2026-06-16T23:59:59.756Z
+                    updatedAt: 2026-06-16T23:59:59.756Z
                     members:
                       - userId: U:user123
                         lastName: Smith
@@ -7102,8 +7102,8 @@ webhooks:
                     email: john.smith@company.com
                     firstName: John
                     lastName: Smith
-                    createdAt: "1781639069344"
-                    updatedAt: "1781639069344"
+                    createdAt: "1781654399756"
+                    updatedAt: "1781654399756"
               User Updated:
                 value:
                   entity: User
@@ -7113,8 +7113,8 @@ webhooks:
                     email: john.smith@company.com
                     firstName: John
                     lastName: Smith
-                    createdAt: "1781639069344"
-                    updatedAt: "1781639069344"
+                    createdAt: "1781654399756"
+                    updatedAt: "1781654399756"
               User Removed:
                 value:
                   entity: User
@@ -7187,7 +7187,7 @@ components:
       maximum: 8640000000000000
       title: Timestamp
       description: A timestamp in UTC milliseconds
-      example: 1781639069126
+      example: 1781654399510
     latlng:
       type: object
       properties: