@pushwoosh/rpc-v2-http-api-data 0.2.449 → 0.2.451

package/data.js

@@ -24602,6 +24602,18 @@ export const data = {
                 "response": "pushwoosh.rpc_v2.media_files.GetMediaFilesUsageResponse",
                 "method": "get",
                 "path": "/api/media/files/usage"
+            },
+            "GetSettings": {
+                "request": "pushwoosh.rpc_v2.media_files.GetMediaSettingsRequest",
+                "response": "pushwoosh.rpc_v2.media_files.GetMediaSettingsResponse",
+                "method": "get",
+                "path": "/api/media/settings"
+            },
+            "UpdateSettings": {
+                "request": "pushwoosh.rpc_v2.media_files.UpdateMediaSettingsRequest",
+                "response": "pushwoosh.rpc_v2.media_files.UpdateMediaSettingsResponse",
+                "method": "put",
+                "path": "/api/media/settings"
             }
         }
     },
@@ -24643,6 +24655,9 @@ export const data = {
             },
             "height": {
                 "type": "number"
+            },
+            "focalPoint": {
+                "type": "pushwoosh.rpc_v2.media_files.FocalPoint"
             }
         },
         "oneofs": {
@@ -24654,6 +24669,17 @@ export const data = {
             }
         }
     },
+    "pushwoosh.rpc_v2.media_files.FocalPoint": {
+        "type": "I",
+        "fields": {
+            "x": {
+                "type": "number"
+            },
+            "y": {
+                "type": "number"
+            }
+        }
+    },
     "pushwoosh.rpc_v2.media_files.CreateVariantResponse": {
         "type": "I",
         "fields": {
@@ -24849,6 +24875,9 @@ export const data = {
             "versionsCount": {
                 "type": "number"
             },
+            "originalFileSize": {
+                "type": "number"
+            },
             "imageMeta": {
                 "type": "pushwoosh.rpc_v2.media_files.MediaFile.ImageMeta"
             }
@@ -24861,6 +24890,53 @@ export const data = {
             }
         }
     },
+    "pushwoosh.rpc_v2.media_files.MediaSettings": {
+        "type": "I",
+        "fields": {
+            "compressPng": {
+                "type": "boolean"
+            }
+        }
+    },
+    "pushwoosh.rpc_v2.media_files.GetMediaSettingsRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            }
+        }
+    },
+    "pushwoosh.rpc_v2.media_files.GetMediaSettingsResponse": {
+        "type": "I",
+        "fields": {
+            "settings": {
+                "type": "pushwoosh.rpc_v2.media_files.MediaSettings"
+            },
+            "canModify": {
+                "type": "boolean"
+            }
+        }
+    },
+    "pushwoosh.rpc_v2.media_files.UpdateMediaSettingsRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "compressPng": {
+                "type": "boolean",
+                "optional": true
+            }
+        }
+    },
+    "pushwoosh.rpc_v2.media_files.UpdateMediaSettingsResponse": {
+        "type": "I",
+        "fields": {
+            "settings": {
+                "type": "pushwoosh.rpc_v2.media_files.MediaSettings"
+            }
+        }
+    },
     "pushwoosh.rpc_v2.messages.MessagesService": {
         "type": "S",
         "key": "messages",

package/media_files.d.ts

@@ -3,15 +3,21 @@ export type MediaFilesService_List = RpcMethod<ListMediaFilesRequest, ListMediaF
 export type MediaFilesService_CreateVariant = RpcMethod<CreateVariantRequest, CreateVariantResponse>;
 export type MediaFilesService_Delete = RpcMethod<DeleteMediaFileRequest, DeleteMediaFileResponse>;
 export type MediaFilesService_GetUsage = RpcMethod<GetMediaFilesUsageRequest, GetMediaFilesUsageResponse>;
+export type MediaFilesService_GetSettings = RpcMethod<GetMediaSettingsRequest, GetMediaSettingsResponse>;
+export type MediaFilesService_UpdateSettings = RpcMethod<UpdateMediaSettingsRequest, UpdateMediaSettingsResponse>;
 export interface MediaFilesService {
     /** Lists an application's media image files newest-first, with paging and an optional filename substring search. Returns only originals by default, and of an edited image only its newest version (versions_count tells how many exist); pass parent_uuid to list the cropped variants of an original, or version_root_uuid to list every version of one image. */
     List: MediaFilesService_List;
-    /** Creates a cropped variant of an existing original image (by uuid) for the given aspect ratio, storing it in S3 as a child of the original. Idempotent per original and ratio: calling again with the same original and ratio returns the existing variant instead of duplicating it. */
+    /** Creates a cropped variant of an existing original image (by uuid) for the given aspect ratio, storing it in S3 as a child of the original; focal_point moves the crop window off center. Idempotent per original, ratio, output size and window position: calling again with the same ones returns the existing variant instead of duplicating it. */
     CreateVariant: MediaFilesService_CreateVariant;
     /** Deletes a media file by uuid, removing its database record and S3 objects; deleting an original cascades to all of its cropped variants, while deleting a variant removes only that variant. Deleting the newest version of an edited image lists the previous version again. Not reversible. */
     Delete: MediaFilesService_Delete;
     /** Returns an application's media storage footprint: count of original files, total file count including cropped variants, and total bytes stored in S3 (originals, variants and thumbnails). Use to check or report media quota usage for an application code. */
     GetUsage: MediaFilesService_GetUsage;
+    /** Returns an application's media storage settings, e.g. whether PNG images are compressed on upload, and whether the caller may change them. */
+    GetSettings: MediaFilesService_GetSettings;
+    /** Changes an application's media storage settings. Only the fields present in the request change, the rest keep their value. Applies to images uploaded afterwards; files already stored are not touched. */
+    UpdateSettings: MediaFilesService_UpdateSettings;
 }
 /** AspectRatio enumerates the supported aspect ratios for image variants. */
 export type AspectRatio = 'ASPECT_RATIO_UNSPECIFIED' | 'ASPECT_RATIO_1_1' | 'ASPECT_RATIO_4_3' | 'ASPECT_RATIO_3_2' | 'ASPECT_RATIO_4_5' | 'ASPECT_RATIO_5_4' | 'ASPECT_RATIO_16_9' | 'ASPECT_RATIO_16_10' | 'ASPECT_RATIO_21_9' | 'ASPECT_RATIO_9_16'
@@ -39,8 +45,21 @@ export type CreateVariantRequest = {
      * is encoded as JPEG (i.e. the original is a JPEG); ignored otherwise.
      */
     quality?: number;
+    /**
+     * focal_point is the center of the crop window on the original; the window is shifted
+     * back inside the image near an edge. Unset means the center (0.5, 0.5).
+     */
+    focalPoint?: FocalPoint;
     size: CreateVariantRequest_size;
 };
+/**
+ * FocalPoint is a point on an image as a fraction of its width (x) and height (y), each 0..1
+ * from the top-left corner.
+ */
+export type FocalPoint = {
+    x: number;
+    y: number;
+};
 export type CreateVariantResponse = {
     file: MediaFile;
 };
@@ -161,5 +180,30 @@ export type MediaFile = {
     versionRootUuid: string;
     /** versions_count is how many versions of this image exist, this one included. */
     versionsCount: number;
+    /** original_file_size is the size before PNG compression; set only in an upload response when compression shrank the file. */
+    originalFileSize: number;
     meta: MediaFile_meta;
 };
+/** MediaSettings are per-application media storage settings. The zero value of every field is the default. */
+export type MediaSettings = {
+    /** compress_png quantizes PNG images on upload (lossy palette compression, transparency kept). */
+    compressPng: boolean;
+};
+export type GetMediaSettingsRequest = {
+    /** Application code (format XXXXX-XXXXX) whose media settings to read. */
+    application?: string;
+};
+export type GetMediaSettingsResponse = {
+    settings: MediaSettings;
+    /** can_modify tells whether the caller may change the settings. */
+    canModify: boolean;
+};
+export type UpdateMediaSettingsRequest = {
+    /** Application code (format XXXXX-XXXXX) whose media settings to change. */
+    application?: string;
+    /** Unset leaves the stored value as is. */
+    compressPng?: boolean;
+};
+export type UpdateMediaSettingsResponse = {
+    settings: MediaSettings;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushwoosh/rpc-v2-http-api-data",
-  "version": "0.2.449",
+  "version": "0.2.451",
   "description": "RPC V2 HTTP API Types and Data",
   "main": "index.js",
   "module": "index.js",