@archildata/api-types 0.0.39 → 0.0.41

package/index.d.ts

@@ -459,6 +459,59 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/sandboxes/{sid}/port-tokens": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List sandbox port tokens
+         * @description Lists unexpired private port token metadata without returning raw tokens.
+         */
+        get: operations["listSandboxPortTokens"];
+        put?: never;
+        /**
+         * Create a private sandbox port token
+         * @description Creates token-authorized HTTP access to one port. Send the raw token returned
+         *     by this request in the `X-Archil-Token` request header at the stable
+         *     `<port>-<sandbox-route-id>.<zone>` hostname. Public ports accept connections
+         *     without a token; otherwise a valid token for that sandbox and port is required.
+         *     The token is not returned again.
+         */
+        post: operations["createSandboxPortToken"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/sandboxes/{sid}/port-tokens/{token_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a sandbox port token
+         * @description Returns token metadata without its raw token. Expired tokens return not found.
+         */
+        get: operations["getSandboxPortToken"];
+        put?: never;
+        post?: never;
+        /**
+         * Revoke a sandbox port token
+         * @description New private connections using the token fail after this request
+         *     completes; established connections remain open. Expired tokens return not found.
+         */
+        delete: operations["deleteSandboxPortToken"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/sandboxes/{sid}/pause": {
         parameters: {
             query?: never;
@@ -806,6 +859,53 @@ export interface components {
             success: boolean;
             data: components["schemas"]["SandboxPortList"];
         };
+        SandboxPortToken: {
+            /** @description Stable token identifier used for get and revoke operations. */
+            id: string;
+            port: number;
+            /** Format: date-time */
+            created_at: string;
+            /**
+             * Format: date-time
+             * @description When the token expires. Absent for a non-expiring token.
+             */
+            expires_at?: string;
+        };
+        CreatedSandboxPortToken: components["schemas"]["SandboxPortToken"] & {
+            /** @description Stable sandbox port hostname, shared with public access. */
+            hostname: string;
+            /** @description Raw token returned only when the token is created. */
+            token: string;
+        };
+        CreateSandboxPortTokenRequest: {
+            port: number;
+            /**
+             * @description Token lifetime as a Go duration string (for example, "4m", "1h",
+             *     or "24h"). Maximum 365 days ("8760h"). Omit for no expiration.
+             * @example 4m
+             */
+            ttl?: string;
+        };
+        SandboxPortTokenList: {
+            tokens: components["schemas"]["SandboxPortToken"][];
+        };
+        ApiResponse_CreatedSandboxPortToken: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["CreatedSandboxPortToken"];
+        };
+        ApiResponse_SandboxPortToken: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["SandboxPortToken"];
+        };
+        ApiResponse_SandboxPortTokenList: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["SandboxPortTokenList"];
+            /** @description Set when more port tokens remain. */
+            nextCursor?: string;
+        };
         SandboxConnection: {
             /** Format: uri */
             url: string;
@@ -902,6 +1002,13 @@ export interface components {
              */
             authMethods?: components["schemas"]["DiskUser"][];
             rootAttrs?: components["schemas"]["RootAttrs"];
+            /**
+             * @description Minimum version required for connecting clients.
+             * @example [
+             *       "1.2.3"
+             *     ]
+             */
+            minClientVersion?: string;
         };
         /** @description POSIX attributes for the disk's root directory, applied when the disk is created. Lets an unprivileged process own the mount root without a post-mount `chown`. Can only be set at creation; a later `chown`/`chmod` through a mount changes the live attributes as usual. Defaults to uid 0, gid 0, mode 0755. */
         RootAttrs: {
@@ -2610,6 +2717,121 @@ export interface operations {
             500: components["responses"]["InternalError"];
         };
     };
+    listSandboxPortTokens: {
+        parameters: {
+            query?: {
+                /** @description Maximum number of items to return. Omit to return all items in a single unpaginated response; when set, the response may include a nextCursor to fetch the next page. */
+                limit?: components["parameters"]["Limit"];
+                /** @description Pagination cursor from a previous response */
+                cursor?: components["parameters"]["Cursor"];
+            };
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sandbox port tokens */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPortTokenList"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    createSandboxPortToken: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateSandboxPortTokenRequest"];
+            };
+        };
+        responses: {
+            /** @description Port token was created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_CreatedSandboxPortToken"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    getSandboxPortToken: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+                token_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sandbox port token */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_SandboxPortToken"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
+    deleteSandboxPortToken: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Sandbox UUID */
+                sid: components["parameters"]["SandboxId"];
+                token_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Port token was revoked */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalError"];
+        };
+    };
     pauseSandbox: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archildata/api-types",
-  "version": "0.0.39",
+  "version": "0.0.41",
   "description": "API types for the Archil control plane",
   "type": "module",
   "types": "index.d.ts",