@leaflow/sdk 0.36.0 → 0.37.0

package/dist/support/v1/index.d.ts

@@ -36,8 +36,8 @@ export type ListTicketCategoriesQuery = operations["list-ticket-categories"]["pa
 export type UploadAttachmentResult = operations["upload-attachment"]["responses"][201]["content"]["application/json"];
 /** `POST /api/v1/attachments` 的查询参数。 */
 export type UploadAttachmentQuery = operations["upload-attachment"]["parameters"]["query"];
-/** `GET /api/v1/attachments/{attachmentId}/download-url` 成功时的响应体。 */
-export type DescribeAttachmentDownloadResult = operations["describe-attachment-download"]["responses"][200]["content"]["application/json"];
+/** `GET /api/v1/attachments/{attachmentId}/content` 的查询参数。 */
+export type DownloadAttachmentQuery = operations["download-attachment"]["parameters"]["query"];
 /** `GET /api/v1/maintenances` 成功时的响应体。 */
 export type ListMaintenancesResult = operations["list-maintenances"]["responses"][200]["content"]["application/json"];
 /** `GET /api/v1/maintenances` 的查询参数。 */

package/dist/support/v1/schema.d.ts

@@ -202,7 +202,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/attachments/{attachmentId}/download-url": {
+    "/api/v1/attachments/{attachmentId}/content": {
         parameters: {
             query?: never;
             header?: never;
@@ -210,13 +210,16 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get a download address for an attachment
-         * @description Returns a temporary address that serves the file. The address expires; request a new one
-         *     rather than storing it.
+         * Download an attachment
+         * @description Serves the file itself. The bytes are proxied by this API; the object store is not reachable
+         *     from outside, and no address to it is ever handed out.
          *
-         *     Returns 404 for an attachment uploaded in another project.
+         *     `Content-Type` is the type determined from the content at upload time, not the one the
+         *     client claimed. `Content-Disposition` is `attachment` unless `inline` is requested **and**
+         *     the content type is one that can be rendered safely, in which case it is `inline`. Asking
+         *     for `inline` on anything else still yields a download.
          */
-        get: operations["describe-attachment-download"];
+        get: operations["download-attachment"];
         put?: never;
         post?: never;
         delete?: never;
@@ -469,15 +472,6 @@ export interface components {
             status: components["schemas"]["MaintenanceStatus"];
             title: string;
         };
-        AttachmentDownloadResource: {
-            /**
-             * Format: date-time
-             * @description After this moment the address stops working; request a new one
-             */
-            expires_at: string;
-            /** @description A temporary address serving the file */
-            url: string;
-        };
         CreateTicketRequestBody: {
             /** @description Attachments to reference from the first message. Each must have been uploaded in this project and not yet referenced */
             attachment_ids?: string[];
@@ -940,9 +934,12 @@ export interface operations {
             };
         };
     };
-    "describe-attachment-download": {
+    "download-attachment": {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Render in the browser instead of downloading, where the content type allows it */
+                inline?: boolean;
+            };
             header?: never;
             path: {
                 attachmentId: string;
@@ -954,10 +951,12 @@ export interface operations {
             /** @description OK */
             200: {
                 headers: {
+                    /** @description `inline` when the content type can be rendered safely and `inline` was asked for, `attachment` otherwise. Carries the original file name */
+                    "Content-Disposition"?: string;
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["AttachmentDownloadResource"];
+                    "*/*": string;
                 };
             };
             /** @description Error */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {