@pushwoosh/rpc-v2-http-api-data 0.2.375 → 0.2.376

package/data.js

@@ -23006,6 +23006,16 @@ export const data = {
             "description": {
                 "type": "string",
                 "optional": true
+            },
+            "source": {
+                "type": "string"
+            },
+            "sourceRef": {
+                "type": "string"
+            },
+            "replacesUuid": {
+                "type": "string",
+                "optional": true
             }
         }
     },
@@ -23039,6 +23049,10 @@ export const data = {
             "extensions": {
                 "type": "string",
                 "array": true
+            },
+            "versionRootUuid": {
+                "type": "string",
+                "optional": true
             }
         }
     },
@@ -23149,6 +23163,18 @@ export const data = {
                 "type": "string",
                 "optional": true
             },
+            "source": {
+                "type": "string"
+            },
+            "version": {
+                "type": "number"
+            },
+            "versionRootUuid": {
+                "type": "string"
+            },
+            "versionsCount": {
+                "type": "number"
+            },
             "imageMeta": {
                 "type": "pushwoosh.rpc_v2.media_files.MediaFile.ImageMeta"
             }

package/media_files.d.ts

@@ -4,11 +4,11 @@ export type MediaFilesService_CreateVariant = RpcMethod<CreateVariantRequest, Cr
 export type MediaFilesService_Delete = RpcMethod<DeleteMediaFileRequest, DeleteMediaFileResponse>;
 export type MediaFilesService_GetUsage = RpcMethod<GetMediaFilesUsageRequest, GetMediaFilesUsageResponse>;
 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; pass parent_uuid to instead list the cropped variants of that original. */
+    /** 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. */
     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. Not reversible. */
+    /** 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;
@@ -50,6 +50,15 @@ export type UploadMediaFileRequest = {
     /** MIME type of the image (image/jpeg, image/png, image/gif, image/webp); auto-detected from the bytes when empty. */
     mimeType: string;
     description?: string;
+    /** Where the image was imported from: empty for a file from disk, "canva" or "figma". */
+    source: string;
+    /** Provider-side identity of the image as a JSON object, e.g. {"design_id": "...", "page": 2}. */
+    sourceRef: string;
+    /**
+     * uuid of an original of this application to store a new version of; the old one keeps its URL.
+     * Another application's uuid is NOT_FOUND, a cropped variant's INVALID_ARGUMENT.
+     */
+    replacesUuid?: string;
 };
 export type UploadMediaFileResponse = {
     file: MediaFile;
@@ -76,6 +85,11 @@ export type ListMediaFilesRequest = {
      * must filter here rather than client-side, so page size and total stay honest.
      */
     extensions?: string[];
+    /**
+     * version_root_uuid lists every version of one image, newest first, including the ones no
+     * longer listed by default. Pass a file's version_root_uuid; other filters are ignored.
+     */
+    versionRootUuid?: string;
 };
 export type ListMediaFilesResponse = {
     files: MediaFile[];
@@ -95,7 +109,10 @@ export type GetMediaFilesUsageRequest = {
     application?: string;
 };
 export type GetMediaFilesUsageResponse = {
-    /** originals_count is the number of original files (no parent). */
+    /**
+     * originals_count is the number of original files (no parent), every stored version of an
+     * edited image included: each one occupies storage.
+     */
     originalsCount: number;
     /** total_count is the number of files, including cropped variants. */
     totalCount: number;
@@ -129,5 +146,13 @@ export type MediaFile = {
     description?: string;
     /** parent_uuid is set on variants and points to the original image's uuid. */
     parentUuid?: string;
+    /** source is where the image was imported from: empty for a file from disk, "canva" or "figma". */
+    source: string;
+    /** version is 0 for the first upload of an image and grows with every new version of it. */
+    version: number;
+    /** version_root_uuid groups the versions of one image: the uuid of its first version. */
+    versionRootUuid: string;
+    /** versions_count is how many versions of this image exist, this one included. */
+    versionsCount: number;
     meta: MediaFile_meta;
 };

package/package.json

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