@zixt/host 0.0.91 → 0.0.93

package/dist/index.js

@@ -28,7 +28,7 @@ import { homedir as homedir3 } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.91",
+  version: "0.0.93",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -16042,6 +16042,8 @@ var ApiConnection = external_exports.object({
   definitionRevision: external_exports.number().int().min(1),
   definitionName: external_exports.string().min(1).max(120),
   name: external_exports.string().min(1).max(120),
+  /** Optional human-authored guidance rendered to teammates that can use this connection. */
+  usageNotes: external_exports.string().max(4e3).optional(),
   serverUrl: external_exports.url().max(2e3),
   serverLabel: external_exports.string().min(1).max(120),
   credentials: external_exports.array(
@@ -16062,6 +16064,7 @@ var ListApiConnectionsResponse = external_exports.object({ connections: external
 var CreateApiConnectionRequest = external_exports.object({
   definitionId: IntegrationDefinitionId,
   name: external_exports.string().min(1).max(120),
+  usageNotes: external_exports.string().max(4e3).optional(),
   serverId: external_exports.string().min(1).max(100).optional(),
   customBaseUrl: external_exports.url().max(2e3).optional(),
   credentials: external_exports.record(
@@ -16072,6 +16075,7 @@ var CreateApiConnectionRequest = external_exports.object({
 }).strict();
 var UpdateApiConnectionRequest = external_exports.object({
   name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional(),
   serverId: external_exports.string().min(1).max(100).optional(),
   customBaseUrl: external_exports.url().max(2e3).nullable().optional(),
   credentials: external_exports.record(
@@ -16096,9 +16100,21 @@ var ApiOperationInput = external_exports.object({
     }
   }
 });
+var TryApiAuthentication = external_exports.discriminatedUnion("mode", [
+  external_exports.object({ mode: external_exports.literal("saved") }).strict(),
+  external_exports.object({
+    mode: external_exports.literal("one_time"),
+    alternative: external_exports.array(external_exports.string().min(1).max(120)).min(1).max(20).refine((items) => new Set(items).size === items.length, "Schemes must be unique"),
+    credentials: external_exports.record(
+      external_exports.string().min(1).max(120),
+      external_exports.record(external_exports.string().min(1).max(120), external_exports.string().min(1).max(2e4))
+    )
+  }).strict()
+]);
 var TryApiOperationRequest = external_exports.object({
   operationId: external_exports.string().min(1).max(240),
   input: ApiOperationInput.default({ path: {}, query: {}, headers: {} }),
+  authentication: TryApiAuthentication.default({ mode: "saved" }),
   confirmed: external_exports.boolean().default(false)
 }).strict();
 var ApiOperationResult = external_exports.object({
@@ -16106,6 +16122,7 @@ var ApiOperationResult = external_exports.object({
   status: external_exports.number().int().min(0).max(999).nullable(),
   statusText: external_exports.string().max(500),
   contentType: external_exports.string().max(500).nullable(),
+  headers: external_exports.record(external_exports.string().min(1).max(200), external_exports.string().max(8e3)).refine((items) => Object.keys(items).length <= 100, "Too many response headers").default({}),
   body: external_exports.string().max(2e5),
   truncated: external_exports.boolean(),
   durationMs: external_exports.number().int().min(0),
@@ -16132,6 +16149,7 @@ var ResolvedApiConnection = external_exports.object({
   name: external_exports.string().min(1).max(120),
   definitionId: IntegrationDefinitionId,
   definitionName: external_exports.string().min(1).max(120),
+  usageNotes: external_exports.string().max(4e3).optional(),
   definitionRevision: external_exports.number().int().min(1),
   baseUrl: external_exports.url().max(2e3),
   auth: external_exports.array(ResolvedApiAuth).max(20),
@@ -20042,10 +20060,13 @@ var LinearTriggerSettings = external_exports.object({
 var LinearInstallationProjection = external_exports.object({
   id: LinearInstallationId,
   provider: external_exports.literal("linear"),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional(),
   organizationName: external_exports.string().min(1).max(200),
   status: LinearInstallationStatus,
   webhookStatus: LinearWebhookStatus,
   connectedTeammateCount: external_exports.number().int().min(0),
+  revision: external_exports.number().int().min(1).optional(),
   createdAt: IsoDate,
   updatedAt: IsoDate
 }).strict();
@@ -20068,19 +20089,28 @@ var LinearIntegrationResponse = external_exports.object({
   /** False when this Zixt deployment has no complete Linear OAuth configuration. */
   available: external_exports.boolean(),
   configured: external_exports.boolean(),
+  installations: external_exports.array(LinearInstallationProjection).optional(),
   installation: LinearInstallationProjection.nullable(),
   identities: external_exports.array(LinearIdentityProjection)
 }).strict();
 var SafeReturnPath = external_exports.string().min(1).max(2e3).regex(/^\/(?!\/)[^\r\n\\]*$/, "return path must be a local absolute path");
 var StartLinearOAuthRequest = external_exports.object({
   /** Local web-app route restored after the popup reports success. */
-  returnPath: SafeReturnPath.optional()
+  returnPath: SafeReturnPath.optional(),
+  installationId: LinearInstallationId.optional(),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional()
 }).strict();
 var StartLinearOAuthResponse = external_exports.object({
   authorizeUrl: HttpUrl.max(4e3),
   /** Exact postMessage target origin. The callback never uses a wildcard. */
   callbackOrigin: HttpOrigin.max(2e3)
 }).strict();
+var UpdateLinearInstallationRequest = external_exports.object({
+  expectedRevision: external_exports.number().int().min(1),
+  name: external_exports.string().min(1).max(120),
+  usageNotes: external_exports.string().max(4e3)
+}).strict();
 var UpdateLinearIdentityRequest = external_exports.object({
   expectedRevision: external_exports.number().int().min(1),
   triggers: LinearTriggerSettings
@@ -20332,6 +20362,8 @@ var InterruptBrowserVoiceSessionResponse = external_exports.object({ interrupted
 // ../../packages/contracts/src/slack.ts
 var SlackInstallationProjection = external_exports.object({
   id: external_exports.string(),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional(),
   teamId: external_exports.string(),
   teamName: external_exports.string(),
   botUserId: external_exports.string(),
@@ -20362,12 +20394,25 @@ var SlackBindingProjection = external_exports.object({
 var SlackIntegrationResponse = external_exports.object({
   /** False when this deployment has no Slack app configured at all. */
   available: external_exports.boolean(),
+  installations: external_exports.array(SlackInstallationProjection).optional(),
+  /** Focused installation for detail routes; null when none is selected. */
   installation: SlackInstallationProjection.nullable(),
   bindings: external_exports.array(SlackBindingProjection)
 }).strict();
-var StartSlackInstallRequest = external_exports.object({ returnPath: external_exports.string().min(1).max(2e3).optional() }).strict();
+var StartSlackInstallRequest = external_exports.object({
+  returnPath: external_exports.string().min(1).max(2e3).optional(),
+  installationId: external_exports.string().min(1).optional(),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional()
+}).strict();
 var StartSlackInstallResponse = external_exports.object({ authorizeUrl: external_exports.url().max(4e3), callbackOrigin: external_exports.url().max(2e3) }).strict();
+var UpdateSlackInstallationRequest = external_exports.object({
+  expectedRevision: external_exports.number().int().min(1),
+  name: external_exports.string().min(1).max(120),
+  usageNotes: external_exports.string().max(4e3)
+}).strict();
 var UpsertSlackBindingRequest = external_exports.object({
+  installationId: external_exports.string().min(1),
   /** Answer when the workspace bot is named in a channel. */
   mentionEnabled: external_exports.boolean(),
   /** Answer direct messages to the workspace bot. */
@@ -20385,6 +20430,8 @@ var WhatsappTemplateRef = external_exports.object({
 }).strict();
 var WhatsappInstallationProjection = external_exports.object({
   id: external_exports.string(),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional(),
   /** WhatsApp Business Account id, read back from the token, never the callback. */
   wabaId: external_exports.string(),
   businessName: external_exports.string(),
@@ -20440,6 +20487,7 @@ var WhatsappIdentityProjection = external_exports.object({
 var WhatsappIntegrationResponse = external_exports.object({
   /** False when this deployment has no WhatsApp app configured at all. */
   available: external_exports.boolean(),
+  installations: external_exports.array(WhatsappInstallationProjection).optional(),
   installation: WhatsappInstallationProjection.nullable(),
   numbers: external_exports.array(WhatsappNumberProjection),
   bindings: external_exports.array(WhatsappBindingProjection),
@@ -20448,9 +20496,17 @@ var WhatsappIntegrationResponse = external_exports.object({
 var StartWhatsappInstallRequest = external_exports.object({
   // Local absolute path only: no scheme, no protocol-relative "//host", and no
   // newline or backslash that could smuggle a header or a Windows path.
-  returnPath: external_exports.string().min(1).max(2e3).regex(/^\/(?!\/)[^\r\n\\]*$/, "return path must be a local absolute path").optional()
+  returnPath: external_exports.string().min(1).max(2e3).regex(/^\/(?!\/)[^\r\n\\]*$/, "return path must be a local absolute path").optional(),
+  installationId: external_exports.string().min(1).optional(),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional()
 }).strict();
 var StartWhatsappInstallResponse = external_exports.object({ authorizeUrl: external_exports.url().max(4e3), callbackOrigin: external_exports.url().max(2e3) }).strict();
+var UpdateWhatsappInstallationRequest = external_exports.object({
+  expectedRevision: external_exports.number().int().min(1),
+  name: external_exports.string().min(1).max(120),
+  usageNotes: external_exports.string().max(4e3)
+}).strict();
 var UpsertWhatsappBindingRequest = external_exports.object({
   /** Meta's opaque phone number id, not the printable number. */
   phoneNumberId: external_exports.string().min(1).max(64)
@@ -20510,6 +20566,8 @@ var GithubAppRemovalStatus = external_exports.enum([
 ]);
 var GithubInstallationProjection = external_exports.object({
   id: GithubInstallationId,
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional(),
   accountLogin: external_exports.string().min(1).max(100),
   accountType: external_exports.enum(["Organization", "User"]),
   botLogin: external_exports.string().min(1).max(200),
@@ -20588,6 +20646,16 @@ var GithubMemberInstallationProjection = GithubInstallationProjection.pick({
   repositoryCount: true,
   updatedAt: true
 }).strict();
+var GithubMemberInstallationSummaryProjection = GithubInstallationProjection.pick({
+  id: true,
+  name: true,
+  accountLogin: true,
+  status: true,
+  appRemovalStatus: true,
+  webhookStatus: true,
+  repositoryCount: true,
+  updatedAt: true
+}).strict();
 var GithubMemberAppRemovalProjection = GithubAppRemovalObligationProjection.pick({
   appRemovalStatus: true,
   updatedAt: true
@@ -20607,6 +20675,7 @@ var GithubMemberTeammateProjection = external_exports.object({
 var GithubIntegrationResponse = external_exports.object({
   available: external_exports.boolean(),
   configured: external_exports.boolean(),
+  installations: external_exports.array(GithubInstallationProjection).optional(),
   installation: GithubInstallationProjection.nullable(),
   focusedAppRemoval: GithubAppRemovalObligationProjection.nullable(),
   pendingCreatedRepositories: external_exports.array(GithubPendingRepositoryAccessProjection).max(50)
@@ -20614,6 +20683,7 @@ var GithubIntegrationResponse = external_exports.object({
 var GithubMemberIntegrationResponse = external_exports.object({
   available: external_exports.boolean(),
   configured: external_exports.boolean(),
+  installations: external_exports.array(GithubMemberInstallationSummaryProjection).optional(),
   installation: GithubMemberInstallationProjection.nullable(),
   focusedAppRemoval: GithubMemberAppRemovalProjection.nullable(),
   pendingCreatedRepositoryCount: external_exports.number().int().min(0).max(50)
@@ -20638,9 +20708,13 @@ var HttpOrigin2 = external_exports.url().max(2e3).refine((value) => {
   return (parsed.protocol === "https:" || parsed.protocol === "http:" && (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1")) && parsed.origin === value && parsed.username === "" && parsed.password === "";
 }, "must be an exact credential-free HTTPS origin or local loopback HTTP origin");
 var StartGithubConnectionRequest = external_exports.object({
-  returnPath: SafeReturnPath2.optional()
+  returnPath: SafeReturnPath2.optional(),
+  installationId: GithubInstallationId.optional(),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional()
 }).strict();
 var StartGithubTeammateOAuthRequest = external_exports.object({
+  installationId: GithubInstallationId.optional(),
   expectedRevision: external_exports.number().int().min(1),
   returnPath: SafeReturnPath2.optional()
 }).strict();
@@ -20660,8 +20734,11 @@ var GithubOAuthPopupMessage = external_exports.discriminatedUnion("ok", [
   }).strict()
 ]);
 var UpdateGithubOrgSettingsRequest = external_exports.object({
+  installationId: GithubInstallationId.optional(),
   expectedRevision: external_exports.number().int().min(1),
-  allowRepositoryCreation: external_exports.boolean()
+  allowRepositoryCreation: external_exports.boolean(),
+  name: external_exports.string().min(1).max(120).optional(),
+  usageNotes: external_exports.string().max(4e3).optional()
 }).strict();
 var UpdateGithubRepositoryRoutesRequest = external_exports.object({
   expectedRouteRevision: external_exports.number().int().min(1),
@@ -20676,12 +20753,14 @@ var UpdateGithubRepositoryRoutesRequest = external_exports.object({
   removeRouteIds: external_exports.array(GithubLabelRouteId).max(100)
 }).strict();
 var UpdateGithubTeammateRequest = external_exports.object({
+  installationId: GithubInstallationId.optional(),
   expectedRevision: external_exports.number().int().min(1),
   mode: GithubActingMode,
   repositoryAccess: GithubRepositoryAccess,
   triggers: GithubTriggerSettings
 }).strict();
 var SaveGithubPatRequest = external_exports.object({
+  installationId: GithubInstallationId.optional(),
   expectedRevision: external_exports.number().int().min(1),
   token: external_exports.string().min(20).max(1e4),
   repositoryIds: external_exports.array(GithubRepositoryId).min(1).max(500)
@@ -21722,6 +21801,9 @@ var REQUEST_BODY_LIMIT = 1e6;
 var REQUEST_URL_LIMIT = 2e4;
 var REQUEST_HEADERS_LIMIT = 64e3;
 var REQUEST_TIMEOUT_MS2 = 3e4;
+var RESPONSE_HEADERS_LIMIT = 64e3;
+var RESPONSE_HEADER_VALUE_LIMIT = 8e3;
+var RESPONSE_HEADER_COUNT_LIMIT = 100;
 var FORBIDDEN_HEADERS = /* @__PURE__ */ new Set([
   "authorization",
   "cookie",
@@ -21731,6 +21813,7 @@ var FORBIDDEN_HEADERS = /* @__PURE__ */ new Set([
   "proxy-authorization",
   "transfer-encoding"
 ]);
+var PRIVATE_RESPONSE_HEADERS = /* @__PURE__ */ new Set(["set-cookie", "set-cookie2"]);
 function operationFor(connection, operationId) {
   const operation = connection.operations.find(({ id }) => id === operationId);
   if (!operation) throw new Error("That API operation is not available on this connection.");
@@ -21789,6 +21872,21 @@ async function boundedBody(response) {
   }
   return { body: new TextDecoder("utf-8", { fatal: false }).decode(joined), truncated };
 }
+function boundedHeaders(response) {
+  const result = {};
+  let bytes = 0;
+  for (const [name, rawValue] of response.headers) {
+    const normalized = name.toLowerCase();
+    if (PRIVATE_RESPONSE_HEADERS.has(normalized)) continue;
+    if (Object.keys(result).length >= RESPONSE_HEADER_COUNT_LIMIT) break;
+    const value = rawValue.slice(0, RESPONSE_HEADER_VALUE_LIMIT);
+    const nextBytes = Buffer.byteLength(normalized) + Buffer.byteLength(value);
+    if (bytes + nextBytes > RESPONSE_HEADERS_LIMIT) break;
+    result[normalized] = value;
+    bytes += nextBytes;
+  }
+  return result;
+}
 async function executeApiOperation(input) {
   const started = performance.now();
   try {
@@ -21909,6 +22007,7 @@ async function executeApiOperation(input) {
       status: response.status,
       statusText: response.statusText.slice(0, 500),
       contentType: response.headers.get("content-type")?.slice(0, 500) ?? null,
+      headers: boundedHeaders(response),
       ...payload,
       durationMs: Math.max(0, Math.round(performance.now() - started)),
       error: response.ok ? null : `The API returned HTTP ${response.status}.`
@@ -21919,6 +22018,7 @@ async function executeApiOperation(input) {
       status: null,
       statusText: "",
       contentType: null,
+      headers: {},
       body: "",
       truncated: false,
       durationMs: Math.max(0, Math.round(performance.now() - started)),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zixt/host",
-  "version": "0.0.91",
+  "version": "0.0.93",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",