@epilot/cli 0.1.154 → 0.1.155

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.154 — CLI for epilot APIs
+epilot v0.1.155 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/access-token.json

@@ -86,6 +86,21 @@
                       "739224:e5c1f9b1-e41d-421d-83c4-c5626e464430"
                     ]
                   }
+                },
+                "contact_identification": {
+                  "value": {
+                    "name": "Contact Identification Token",
+                    "token_type": "contact_identification",
+                    "portal_id": "portal_abc123",
+                    "contact_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
+                    "surface_id": "website-journeys",
+                    "origin": "END_CUSTOMER_PORTAL",
+                    "allowed_operations": [
+                      "getContact",
+                      "getContracts"
+                    ],
+                    "expires_in": 300
+                  }
                 }
               }
             }
@@ -495,6 +510,98 @@
           }
         }
       }
+    },
+    "/v1/access-tokens/contact-identification/.well-known/jwks.json": {
+      "get": {
+        "operationId": "getContactIdentificationTokenJwks",
+        "summary": "getContactIdentificationTokenJwks",
+        "description": "Get jwks public key set to verify contact identification tokens generated by this API",
+        "tags": [
+          "Public"
+        ],
+        "security": [],
+        "responses": {
+          "200": {
+            "description": "Set of jwks",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "keys": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "alg": {
+                            "type": "string",
+                            "example": "RS256"
+                          },
+                          "e": {
+                            "type": "string",
+                            "example": "AQAB"
+                          },
+                          "kid": {
+                            "type": "string",
+                            "example": "tXWU5mPMbRPczpbQwi6vbhLF4GgF3wlMDSyqo7pfeiw="
+                          },
+                          "kty": {
+                            "type": "string",
+                            "example": "RSA"
+                          },
+                          "n": {
+                            "type": "string",
+                            "example": "h_QDoCjZ8W_trtYXaP7_S22wf5r5Wd9XBLED78oT44bJjQXn8ddcFV8Hik65_4IYXVX_hTTU4zpxe3H8vx2j7-Zz3O59mYMp5S0MzODNEdf5Y_2o19eis0brmAJniixsNlQ9LlYkdrVamrgaxHu3ZpP_99zkfFybYeuYoQNzb3PyrT8xVnz_USs_nlFMHpGUxvvz7gfKPqxcLvgLJr4cwI9yzaSY9CD4qW181QVcnL_WzpQ8xx6AuhhHZQ1l_3GG4InTk8ahE7U2ZHVu8RrX6d01pMgc3piEcet9RgFLnhbTg3YIiKGoAbN42wJn_x3lgIAC42T9mbmTsHyUdS6nUQ"
+                          },
+                          "use": {
+                            "type": "string",
+                            "example": "sig"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/access-tokens/contact-identification/.well-known/openid-configuration": {
+      "get": {
+        "operationId": "getContactIdentificationTokenOIDC",
+        "summary": "getContactIdentificationTokenOIDC",
+        "description": "OpenID Connect configuration for Access Token API as a contact identification identity provider\n\nNote: This API is not a fully compliant OAuth2.0 / OIDC identity provider, but this endpoint is useful to\nautomate the process of verifying JWT tokens.\n",
+        "tags": [
+          "Public"
+        ],
+        "security": [],
+        "responses": {
+          "200": {
+            "description": "OpenID Configuration",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "issuer": {
+                      "type": "string",
+                      "format": "uri",
+                      "example": "https://access-token.sls.epilot.io/v1/access-tokens/contact-identification"
+                    },
+                    "jwks_uri": {
+                      "type": "string",
+                      "format": "uri",
+                      "example": "https://access-token.sls.epilot.io/v1/access-tokens/contact-identification/.well-known/jwks.json"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
     }
   },
   "components": {
@@ -535,7 +642,8 @@
           "portal",
           "assume",
           "app",
-          "portal_preview"
+          "portal_preview",
+          "contact_identification"
         ],
         "description": "Access token type",
         "example": "api"
@@ -552,6 +660,30 @@
         "type": "string",
         "description": "Portal User ID for access token type \"portal_preview\""
       },
+      "ContactId": {
+        "type": "string",
+        "description": "Contact entity ID for access token type \"contact_identification\"",
+        "example": "5da0a718-c822-403d-9f5d-20d4584e0528"
+      },
+      "PortalOrigin": {
+        "type": "string",
+        "enum": [
+          "END_CUSTOMER_PORTAL",
+          "INSTALLER_PORTAL"
+        ],
+        "description": "Portal origin the token assumes, so the bearer is permission-masked the same way the corresponding portal role is."
+      },
+      "AllowedOperations": {
+        "type": "array",
+        "description": "openapi operationIds the token may call. Enforced by the API that consumes the token, which must additionally deny any operation not on this list. Baked into the token at issue time so widening the consumer's own allowlist later cannot retroactively widen a token that is already in circulation.",
+        "items": {
+          "type": "string"
+        },
+        "example": [
+          "getContact",
+          "getContracts"
+        ]
+      },
       "TokenParameters": {
         "anyOf": [
           {
@@ -571,6 +703,9 @@
           },
           {
             "$ref": "#/components/schemas/PortalPreviewTokenParameters"
+          },
+          {
+            "$ref": "#/components/schemas/ContactIdentificationTokenParameters"
           }
         ]
       },
@@ -579,10 +714,10 @@
           {
             "type": "integer",
             "format": "int32",
-            "description": "Expiration time in seconds",
+            "description": "Expiration time in seconds. api tokens may live up to 365 days (31536000); all other token types are capped at 7 days (604800) server-side.",
             "example": 3600,
             "minimum": 30,
-            "maximum": 604800
+            "maximum": 31536000
           },
           {
             "type": "string",
@@ -766,6 +901,61 @@
           "portal_user_id"
         ]
       },
+      "ContactIdentificationTokenParameters": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "A token that acts as one contact, issued after that contact was identified by a portal's registration identifiers rather than by logging in. Distinct from portal_preview, which impersonates an existing portal user for a 360 operator: this kind belongs to no user, is minted for an unauthenticated caller, and is therefore always short-lived and restricted to an explicit operation allowlist. Never stored, so it cannot be listed or revoked - keep expires_in short.",
+        "properties": {
+          "name": {
+            "$ref": "#/components/schemas/AccessTokenName"
+          },
+          "token_type": {
+            "type": "string",
+            "enum": [
+              "contact_identification"
+            ]
+          },
+          "portal_id": {
+            "$ref": "#/components/schemas/PortalId"
+          },
+          "contact_id": {
+            "$ref": "#/components/schemas/ContactId"
+          },
+          "surface_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "description": "Portal surface the token is issued for (see `surfaces` on the portal config in customer-portal-api). Carried as the `custom:surface_id` claim; the consuming API resolves the surface's data access from the portal config on every request.",
+            "example": "website-journeys"
+          },
+          "origin": {
+            "$ref": "#/components/schemas/PortalOrigin"
+          },
+          "allowed_operations": {
+            "$ref": "#/components/schemas/AllowedOperations"
+          },
+          "expires_in": {
+            "type": "integer",
+            "format": "int32",
+            "minimum": 60,
+            "maximum": 900,
+            "description": "Lifetime in seconds. Integer only for this token type (no \"5m\" strings), and capped server-side by CONTACT_IDENTIFICATION_TOKEN_MAX_EXPIRATION_SECONDS - the value originates from portal configuration, so it is not trusted as-is.",
+            "example": 300
+          },
+          "email": {
+            "type": "string",
+            "description": "Optional. Carried as the `email` claim when the consumer needs it (e.g. to attribute an activity). Omit to keep the contact's email out of the token."
+          }
+        },
+        "required": [
+          "name",
+          "portal_id",
+          "contact_id",
+          "surface_id",
+          "allowed_operations",
+          "expires_in"
+        ]
+      },
       "AccessTokenItem": {
         "type": "object",
         "properties": {
@@ -791,6 +981,15 @@
           "portal_user_id": {
             "$ref": "#/components/schemas/PortalUserId"
           },
+          "contact_id": {
+            "$ref": "#/components/schemas/ContactId"
+          },
+          "origin": {
+            "$ref": "#/components/schemas/PortalOrigin"
+          },
+          "allowed_operations": {
+            "$ref": "#/components/schemas/AllowedOperations"
+          },
           "assignments": {
             "$ref": "#/components/schemas/Assignments"
           },
@@ -805,6 +1004,12 @@
             "format": "date",
             "description": "Last date the token was used (YYYY-MM-DD format, 1 day accuracy)",
             "example": "2026-02-24"
+          },
+          "expires_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Timestamp when the token expires and stops being accepted (only set for tokens created with expires_in)",
+            "example": "2026-03-01T12:00:00.000Z"
           }
         },
         "required": [

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-V3XTUOKN.js";
+} from "../chunk-PZQM3BWY.js";
 
 // bin/epilot.ts
 import { runMain } from "citty";
@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.154",
+    version: "0.1.155",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-WMXFMPWE.js").then((m) => m.default),
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
-    completion: () => import("../completion-ZKB2LRUW.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-66YVWUZD.js").then((m) => m.default),
+    completion: () => import("../completion-6CAE47TY.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-DF6ERFIY.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
@@ -134,13 +134,13 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.154" : (await null).default.version;
+var VERSION = true ? "0.1.155" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);
 var completionsIdx = args.indexOf("--_completions");
 if (completionsIdx >= 0) {
-  const { handleCompletions } = await import("../completion-ZKB2LRUW.js");
+  const { handleCompletions } = await import("../completion-6CAE47TY.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-V3XTUOKN.js → chunk-PZQM3BWY.js}

@@ -7,7 +7,7 @@ var API_LIST = [
     kebabName: "access-token",
     title: "Access Token API",
     serverUrl: "https://access-token.sls.epilot.io",
-    operationCount: 9,
+    operationCount: 11,
     operationIds: [
       "listAccessTokens",
       "createAccessToken",
@@ -17,7 +17,9 @@ var API_LIST = [
       "getPublicTokenJwks",
       "getPortalPreviewTokenJwks",
       "getPublicTokenOIDC",
-      "getPortalPreviewTokenOIDC"
+      "getPortalPreviewTokenOIDC",
+      "getContactIdentificationTokenJwks",
+      "getContactIdentificationTokenOIDC"
     ]
   },
   {

package/dist/{completion-ZKB2LRUW.js → completion-6CAE47TY.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "./chunk-V3XTUOKN.js";
+} from "./chunk-PZQM3BWY.js";
 import {
   DIM,
   GREEN,

package/dist/{upgrade-66YVWUZD.js → upgrade-DF6ERFIY.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.154";
+  if (true) return "0.1.155";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.154",
+  "version": "0.1.155",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {