@contentchef/contentchef-types 10.1.0 → 11.0.0-alpha.1

package/dist/api/Content.d.ts

@@ -769,7 +769,9 @@ export declare enum ContentFieldViolationCodes {
     textFieldPatternNotMatched = "textField.patternNotMatched",
     textFieldValueMissingInListOfValue = "textField.valueMissingInListOfValue",
     textFieldValueIsNotAString = "textField.valueIsNotAString",
-    textFieldBlankValueNotAllowed = "textField.blankValueNotAllowed"
+    textFieldBlankValueNotAllowed = "textField.blankValueNotAllowed",
+    segmentedFieldValueIsNotSegmented = "segmentedField.valueIsNotSegmented",
+    segmentedFieldSegmentNotDeclared = "segmentedField.segmentNotDeclared"
 }
 /**
  * Request type for getContentStatus

package/dist/api/Content.js

@@ -86,6 +86,8 @@ var ContentFieldViolationCodes;
     ContentFieldViolationCodes["textFieldValueMissingInListOfValue"] = "textField.valueMissingInListOfValue";
     ContentFieldViolationCodes["textFieldValueIsNotAString"] = "textField.valueIsNotAString";
     ContentFieldViolationCodes["textFieldBlankValueNotAllowed"] = "textField.blankValueNotAllowed";
+    ContentFieldViolationCodes["segmentedFieldValueIsNotSegmented"] = "segmentedField.valueIsNotSegmented";
+    ContentFieldViolationCodes["segmentedFieldSegmentNotDeclared"] = "segmentedField.segmentNotDeclared";
 })(ContentFieldViolationCodes || (exports.ContentFieldViolationCodes = ContentFieldViolationCodes = {}));
 var LocalizationSettings;
 (function (LocalizationSettings) {

package/dist/api/ContentDefinition.d.ts

@@ -366,6 +366,7 @@ export declare enum SchemaFieldViolationCodes {
     invalidNumberValueInList = "invalidNumberValueInList",
     invalidArrayValue = "invalidArrayValue",
     invalidEmptyArray = "invalidEmptyArray",
+    invalidEmptyObject = "invalidEmptyObject",
     invalidListOfValuesValue = "invalidListOfValuesValue",
     fragmentNameNotFound = "fragmentNameNotFound",
     fragmentNameAlreadyInUse = "fragmentNameAlreadyInUse",
@@ -387,5 +388,7 @@ export declare enum SchemaFieldViolationCodes {
     extensionNotSupportedForType = "extensionNotSupportedForType",
     translatableNotAllowed = "translatableNotAllowed",
     invalidEnumValue = "invalidEnumValue",
-    compactCannotBeNested = "compactCannotBeNested"
+    compactCannotBeNested = "compactCannotBeNested",
+    segmentTypeNotAllowed = "segmentTypeNotAllowed",
+    segmentNameNotFound = "segmentNameNotFound"
 }

package/dist/api/ContentDefinition.js

@@ -22,6 +22,7 @@ var SchemaFieldViolationCodes;
     SchemaFieldViolationCodes["invalidNumberValueInList"] = "invalidNumberValueInList";
     SchemaFieldViolationCodes["invalidArrayValue"] = "invalidArrayValue";
     SchemaFieldViolationCodes["invalidEmptyArray"] = "invalidEmptyArray";
+    SchemaFieldViolationCodes["invalidEmptyObject"] = "invalidEmptyObject";
     SchemaFieldViolationCodes["invalidListOfValuesValue"] = "invalidListOfValuesValue";
     SchemaFieldViolationCodes["fragmentNameNotFound"] = "fragmentNameNotFound";
     SchemaFieldViolationCodes["fragmentNameAlreadyInUse"] = "fragmentNameAlreadyInUse";
@@ -44,4 +45,6 @@ var SchemaFieldViolationCodes;
     SchemaFieldViolationCodes["translatableNotAllowed"] = "translatableNotAllowed";
     SchemaFieldViolationCodes["invalidEnumValue"] = "invalidEnumValue";
     SchemaFieldViolationCodes["compactCannotBeNested"] = "compactCannotBeNested";
+    SchemaFieldViolationCodes["segmentTypeNotAllowed"] = "segmentTypeNotAllowed";
+    SchemaFieldViolationCodes["segmentNameNotFound"] = "segmentNameNotFound";
 })(SchemaFieldViolationCodes || (exports.SchemaFieldViolationCodes = SchemaFieldViolationCodes = {}));

package/dist/api/ContentDefinitionSchema.d.ts

@@ -19,7 +19,8 @@ export declare enum SchemaTypeIds {
     ONE_LINKED_CONTENT_OF = "oneLinkedContentOf",
     ARRAY = "array",
     SLUG = "slug",
-    MEDIA = "media"
+    MEDIA = "media",
+    SEGMENTED = "segmented"
 }
 /**
  * This enum represent al possible long text sub types
@@ -293,6 +294,68 @@ export type OneLinkedContentOfConstraints = {
     lazy?: boolean;
     linkType?: LinkType;
 };
+/**
+ * This type represent one segment of a segmented field: the same `{ type, constraints }` pair a
+ * schema field carries, minus the name, because the map key in `SegmentsTable` is the name
+ *
+ * `oneLinkedContentOf` is the only reference form admitted, `linked-content` is its single
+ * definition special case and carries the identical payload value
+ */
+export type SegmentDescriptor = {
+    type: SchemaTypeIds.FRAGMENT;
+    constraints: FragmentFieldConstraints;
+} | {
+    type: SchemaTypeIds.ONE_FRAGMENT_OF;
+    constraints: OneFragmentOfConstraints;
+} | {
+    type: SchemaTypeIds.ONE_LINKED_CONTENT_OF;
+    constraints: OneLinkedContentOfConstraints;
+};
+/**
+ * This type represent the model to define a segment of a segmented field
+ */
+export type SegmentDefinition = SegmentDescriptor & {
+    /**
+     * The friendly labels of the segment
+     */
+    labels?: I18NDictionary;
+};
+/**
+ * This type represent the model of the attribute segments of a segmented field, keyed by segment
+ * name, like `FragmentsTable`
+ * Names must match `^[a-z0-9_-]+$` and are unordered
+ */
+export type SegmentsTable = {
+    /**
+     * The name is the unique id of the segment and its value is the model representing the segment
+     */
+    [name: string]: SegmentDefinition;
+};
+/**
+ * This enum constrains every segment of a field to one family
+ * When omitted, segments of both families are allowed in the same field
+ */
+export declare enum SegmentsType {
+    FRAGMENTS = "fragments",
+    REFERENCES = "references"
+}
+/**
+ * This type represent the model of a segmented field constraints
+ */
+export type SegmentedFieldConstraints = {
+    /**
+     * Set this value to define the segments the field is made of
+     */
+    segments: SegmentsTable;
+    /**
+     * Set this value to define the segment served when the request matches none of this field's segments
+     */
+    defaultSegment?: string;
+    /**
+     * Set this value to constrain every segment of the field to one family
+     */
+    segmentsType?: SegmentsType;
+};
 /**
  * This type represent the model of an array field constraints
  * @template T The type of the item used ad children of the array
@@ -444,6 +507,10 @@ export type OneFragmentOfSchemaType = SchemaType<SchemaTypeIds.ONE_FRAGMENT_OF,
  * A one linked content of field can be indexed and searched when requesting the content
  */
 export type OneLinkedContentOfSchemaType = IndexableSchemaType<SchemaTypeIds.ONE_LINKED_CONTENT_OF, OneLinkedContentOfConstraints>;
+/**
+ * This type represent a segmented field schema type
+ */
+export type SegmentedSchemaType = SchemaType<SchemaTypeIds.SEGMENTED, SegmentedFieldConstraints>;
 /**
  * Slug schema type
  * This type is indexable and translatable by default
@@ -469,7 +536,7 @@ export type TranslatableSchemaTypes = NumberSchemaType | TextSchemaType | LongTe
 /**
  * This type group all the schema types of a content definition that are not indexable
  */
-export type PlainSchemaTypes = DateSchemaType | FragmentSchemaType | OneFragmentOfSchemaType | SlugSchemaType;
+export type PlainSchemaTypes = DateSchemaType | FragmentSchemaType | OneFragmentOfSchemaType | SlugSchemaType | SegmentedSchemaType;
 /**
  * This type group all schema types of a content definition
  */

package/dist/api/ContentDefinitionSchema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LinkType = exports.LongTextSubTypes = exports.SchemaTypeIds = void 0;
+exports.SegmentsType = exports.LinkType = exports.LongTextSubTypes = exports.SchemaTypeIds = void 0;
 /**
  * This enum represent al possible schema field type ids
  */
@@ -23,6 +23,7 @@ var SchemaTypeIds;
     SchemaTypeIds["ARRAY"] = "array";
     SchemaTypeIds["SLUG"] = "slug";
     SchemaTypeIds["MEDIA"] = "media";
+    SchemaTypeIds["SEGMENTED"] = "segmented";
 })(SchemaTypeIds || (exports.SchemaTypeIds = SchemaTypeIds = {}));
 /**
  * This enum represent al possible long text sub types
@@ -39,3 +40,12 @@ var LinkType;
     LinkType[LinkType["LAZY"] = 1] = "LAZY";
     LinkType[LinkType["COMPACT"] = 2] = "COMPACT";
 })(LinkType || (exports.LinkType = LinkType = {}));
+/**
+ * This enum constrains every segment of a field to one family
+ * When omitted, segments of both families are allowed in the same field
+ */
+var SegmentsType;
+(function (SegmentsType) {
+    SegmentsType["FRAGMENTS"] = "fragments";
+    SegmentsType["REFERENCES"] = "references";
+})(SegmentsType || (exports.SegmentsType = SegmentsType = {}));

package/dist/api/MediaGallery.d.ts

@@ -1,5 +1,23 @@
 import { AuthorResponse } from './Author';
 import { PagedListResponse } from './common';
+/**
+ * The media provider that stores and serves a media.
+ */
+export declare enum MediaProvider {
+    CLOUDFLARE = "cloudflare",
+    CLOUDINARY = "cloudinary"
+}
+/**
+ * The processing status of a media. Numeric values match the backend `smallint` column:
+ * 0 = QUEUED (upload requested, bytes not processed yet), 1 = READY, 2 = ERROR.
+ * MIGRATING (3) is reserved for provider migrations.
+ */
+export declare enum MediaStatus {
+    QUEUED = 0,
+    READY = 1,
+    ERROR = 2,
+    MIGRATING = 3
+}
 /**
  * This type describe the result of a list request on media
  * @template T The type of media requested
@@ -46,10 +64,6 @@ export type MediaGallery = {
      * The chosen media gallery description
      */
     description: string;
-    /**
-     * This is the media provider used to manage media
-     */
-    provider: string;
     /**
      * The creation date of the media gallery
      */
@@ -79,6 +93,10 @@ export type MediaGallery = {
  * This is the media unique id
  */
 export type MediaPublicId = string;
+/**
+ * This is the media numeric unique id (the media entity id)
+ */
+export type MediaId = number;
 /**
  * This type represent a media information
  */
@@ -116,9 +134,9 @@ export type Media = {
      */
     originalUrl: string;
     /**
-     * The thumbnail public url of the media
+     * The thumbnail public url of the media (not provided for every resource type / provider)
      */
-    thumbnailUrl: string;
+    thumbnailUrl?: string;
     /**
      * The type of the media
      */
@@ -126,12 +144,38 @@ export type Media = {
     /**
      * The tags saved with the media
      */
-    tags: string[];
+    tags?: string[];
     /**
-     * The tags saved with the media
+     * The media format
      * e.g. -> svg, jpg, png, ...
      */
-    format: string;
+    format?: string;
+    /**
+     * The dominant colors of the media. Computed by Cloudinary; empty (`[]`) for providers
+     * that don't compute them, e.g. Cloudflare.
+     */
+    colors?: any[];
+    /**
+     * The predominant color information of the media. Computed by Cloudinary; empty (`{}`)
+     * for providers that don't compute it, e.g. Cloudflare.
+     */
+    predominant?: object;
+    /**
+     * The media name
+     */
+    name?: string;
+    /**
+     * The processing status of the media. Present when the media is read from a stored row
+     * (get / list). Newly requested uploads start as `MediaStatus.QUEUED`.
+     */
+    status?: MediaStatus;
+    /**
+     * Streaming playback urls (hls / dash) for video media, when available.
+     */
+    playback?: {
+        hls?: string;
+        dash?: string;
+    };
 };
 /**
  * This type represent all possible filters used to retrieve a list of media gallery
@@ -309,6 +353,7 @@ export type ListMediaGalleryFoldersResponse = {
      */
     folders: Folder[];
 };
+export type MediaStatusFilter = 'ALL' | 'QUEUED' | 'READY';
 /**
  * This type represent the data needed to make a list media API request
  */
@@ -341,6 +386,10 @@ export type ListMediaRequest = {
      * The tags that the media have to contain to be searched
      */
     tags?: string[];
+    /**
+     * Needed for filtering list depending on media status
+     */
+    status?: MediaStatusFilter;
 };
 /**
  * This type represent the response of a list media API request
@@ -355,13 +404,9 @@ export type GetMediaRequest = {
      */
     mediaGalleryId: MediaGalleryId;
     /**
-     * The path needed to locate the media in the media gallery
-     */
-    parentFolder?: string;
-    /**
-     * The media public id
+     * The media entity unique id
      */
-    mediaPublicId: string;
+    mediaId: MediaId;
 };
 /**
  * This type represent the response of a get media API request
@@ -395,28 +440,41 @@ export type UploadMediaRequest = {
      * The tags saved with the media
      */
     tags?: string[];
+    /**
+     * mimeType of the file to upload
+     */
+    mimeType: string;
 };
 /**
  * This type represent the response of a upload media API request
  */
 export type UploadMediaResponse = {
     /**
-     * This property is a boolean that determines whether or not a media requires an additional step
+     * The provider that will handle this upload, determined server-side from the media
+     * gallery's per-mediaType provider defaults. Also selects the upload protocol:
+     * - `cloudflare`: R2 presigned upload — PUT the raw file to `uploadUrl`.
+     * - `cloudinary`: POST FormData(file) to `uploadUrl`; for large files (`largeUpload === true`)
+     *   PUT the raw file to `writeUrl`, then POST FormData(file=readUrl) to `uploadUrl`.
      */
-    largeUpload: boolean;
+    type: MediaProvider;
     /**
-     * The media provider signed url where to perform the upload request
+     * The signed url where to perform the upload request.
+     *
+     * How to send the bytes depends on `type` (see {@link MediaProvider}):
      *
      * e.g.
      * ``` js
-     *      if (largeUpload) {
-     *          // call this url with the readUrl value
+     *      if (type === 'cloudflare') {
+     *          // R2 presigned PUT of the raw file
+     *          await axios.put(uploadUrl, <THE_FILE>, { headers: { 'Content-Type': mimeType } });
+     *      } else if (largeUpload) {
+     *          // Cloudinary large file: PUT to the scratch bucket, then let Cloudinary fetch it
      *          await axios.put(writeUrl, <THE_FILE>);
      *          const formData = new FormData();
      *          formData.append('file', readUrl);
-     *          await axios.post(uploadUrl, formData)
+     *          await axios.post(uploadUrl, formData);
      *      } else {
-     *          // call this url directly with the media
+     *          // Cloudinary (small file): multipart POST of the raw file
      *          const formData = new FormData();
      *          formData.append('file', <THE_FILE>);
      *          await axios.post(uploadUrl, formData);
@@ -429,11 +487,22 @@ export type UploadMediaResponse = {
      */
     mediaPublicId: string;
     /**
-     * If the media is large (largeUpload value) this is the url where to read the file when performing a large upload
+     * Id of the media entity, created server-side as soon as the upload is requested
+     */
+    mediaId: number;
+    /**
+     * Cloudinary only. When `true` the media exceeds the direct-upload size limit and must be
+     * uploaded via the `writeUrl` + `readUrl` two-step. Undefined for cloudflare providers.
+     */
+    largeUpload?: boolean;
+    /**
+     * The url where to read the uploaded file. Present for cloudflare R2 uploads, and for
+     * cloudinary large uploads (`largeUpload === true`).
      */
     readUrl?: string;
     /**
-     * If the media is large (largeUpload value) this is the url where to write the file before to perform the real upload
+     * The url where to write the file. Present for cloudflare R2 uploads, and for
+     * cloudinary large uploads (`largeUpload === true`).
      */
     writeUrl?: string;
 };

package/dist/api/MediaGallery.js

@@ -1,2 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaStatus = exports.MediaProvider = void 0;
+/**
+ * The media provider that stores and serves a media.
+ */
+var MediaProvider;
+(function (MediaProvider) {
+    MediaProvider["CLOUDFLARE"] = "cloudflare";
+    MediaProvider["CLOUDINARY"] = "cloudinary";
+})(MediaProvider || (exports.MediaProvider = MediaProvider = {}));
+/**
+ * The processing status of a media. Numeric values match the backend `smallint` column:
+ * 0 = QUEUED (upload requested, bytes not processed yet), 1 = READY, 2 = ERROR.
+ * MIGRATING (3) is reserved for provider migrations.
+ */
+var MediaStatus;
+(function (MediaStatus) {
+    MediaStatus[MediaStatus["QUEUED"] = 0] = "QUEUED";
+    MediaStatus[MediaStatus["READY"] = 1] = "READY";
+    MediaStatus[MediaStatus["ERROR"] = 2] = "ERROR";
+    MediaStatus[MediaStatus["MIGRATING"] = 3] = "MIGRATING";
+})(MediaStatus || (exports.MediaStatus = MediaStatus = {}));

package/lib/api/Content.ts

@@ -838,6 +838,8 @@ export enum ContentFieldViolationCodes {
   textFieldValueMissingInListOfValue = "textField.valueMissingInListOfValue",
   textFieldValueIsNotAString = "textField.valueIsNotAString",
   textFieldBlankValueNotAllowed = "textField.blankValueNotAllowed",
+  segmentedFieldValueIsNotSegmented = "segmentedField.valueIsNotSegmented",
+  segmentedFieldSegmentNotDeclared = "segmentedField.segmentNotDeclared",
 }
 
 /**

package/lib/api/ContentDefinition.ts

@@ -393,6 +393,7 @@ export enum SchemaFieldViolationCodes {
     invalidNumberValueInList = 'invalidNumberValueInList',
     invalidArrayValue = 'invalidArrayValue',
     invalidEmptyArray = 'invalidEmptyArray',
+    invalidEmptyObject = 'invalidEmptyObject',
     invalidListOfValuesValue = 'invalidListOfValuesValue',
     fragmentNameNotFound = 'fragmentNameNotFound',
     fragmentNameAlreadyInUse = 'fragmentNameAlreadyInUse',
@@ -414,5 +415,7 @@ export enum SchemaFieldViolationCodes {
     extensionNotSupportedForType = 'extensionNotSupportedForType',
     translatableNotAllowed = 'translatableNotAllowed',
     invalidEnumValue = 'invalidEnumValue',
-    compactCannotBeNested = 'compactCannotBeNested'
+    compactCannotBeNested = 'compactCannotBeNested',
+    segmentTypeNotAllowed = 'segmentTypeNotAllowed',
+    segmentNameNotFound = 'segmentNameNotFound'
 }

package/lib/api/ContentDefinitionSchema.ts

@@ -21,6 +21,7 @@ export enum SchemaTypeIds {
     ARRAY = 'array',
     SLUG = 'slug',
     MEDIA = 'media',
+    SEGMENTED = 'segmented',
 }
 
 /**
@@ -319,6 +320,67 @@ export type OneLinkedContentOfConstraints = {
     linkType?: LinkType;
 };
 
+/**
+ * This type represent one segment of a segmented field: the same `{ type, constraints }` pair a
+ * schema field carries, minus the name, because the map key in `SegmentsTable` is the name
+ *
+ * `oneLinkedContentOf` is the only reference form admitted, `linked-content` is its single
+ * definition special case and carries the identical payload value
+ */
+export type SegmentDescriptor =
+    | { type: SchemaTypeIds.FRAGMENT; constraints: FragmentFieldConstraints; }
+    | { type: SchemaTypeIds.ONE_FRAGMENT_OF; constraints: OneFragmentOfConstraints; }
+    | { type: SchemaTypeIds.ONE_LINKED_CONTENT_OF; constraints: OneLinkedContentOfConstraints; };
+
+/**
+ * This type represent the model to define a segment of a segmented field
+ */
+export type SegmentDefinition = SegmentDescriptor & {
+    /**
+     * The friendly labels of the segment
+     */
+    labels?: I18NDictionary;
+};
+
+/**
+ * This type represent the model of the attribute segments of a segmented field, keyed by segment
+ * name, like `FragmentsTable`
+ * Names must match `^[a-z0-9_-]+$` and are unordered
+ */
+export type SegmentsTable = {
+    /**
+     * The name is the unique id of the segment and its value is the model representing the segment
+     */
+    [name: string]: SegmentDefinition;
+};
+
+/**
+ * This enum constrains every segment of a field to one family
+ * When omitted, segments of both families are allowed in the same field
+ */
+export enum SegmentsType {
+    FRAGMENTS = 'fragments',
+    REFERENCES = 'references'
+}
+
+/**
+ * This type represent the model of a segmented field constraints
+ */
+export type SegmentedFieldConstraints = {
+    /**
+     * Set this value to define the segments the field is made of
+     */
+    segments: SegmentsTable;
+    /**
+     * Set this value to define the segment served when the request matches none of this field's segments
+     */
+    defaultSegment?: string;
+    /**
+     * Set this value to constrain every segment of the field to one family
+     */
+    segmentsType?: SegmentsType;
+};
+
 /**
  * This type represent the model of an array field constraints
  * @template T The type of the item used ad children of the array
@@ -483,6 +545,11 @@ export type OneFragmentOfSchemaType = SchemaType<SchemaTypeIds.ONE_FRAGMENT_OF,
  */
 export type OneLinkedContentOfSchemaType = IndexableSchemaType<SchemaTypeIds.ONE_LINKED_CONTENT_OF, OneLinkedContentOfConstraints>;
 
+/**
+ * This type represent a segmented field schema type
+ */
+export type SegmentedSchemaType = SchemaType<SchemaTypeIds.SEGMENTED, SegmentedFieldConstraints>;
+
 /**
  * Slug schema type
  * This type is indexable and translatable by default
@@ -515,7 +582,7 @@ export type TranslatableSchemaTypes = NumberSchemaType | TextSchemaType | LongTe
 /**
  * This type group all the schema types of a content definition that are not indexable
  */
-export type PlainSchemaTypes = DateSchemaType | FragmentSchemaType | OneFragmentOfSchemaType | SlugSchemaType;
+export type PlainSchemaTypes = DateSchemaType | FragmentSchemaType | OneFragmentOfSchemaType | SlugSchemaType | SegmentedSchemaType;
 
 /**
  * This type group all schema types of a content definition

package/lib/api/MediaGallery.ts

@@ -1,6 +1,26 @@
 import { AuthorResponse } from './Author';
 import { PagedListResponse } from './common';
 
+/**
+ * The media provider that stores and serves a media.
+ */
+export enum MediaProvider {
+    CLOUDFLARE = 'cloudflare',
+    CLOUDINARY = 'cloudinary'
+}
+
+/**
+ * The processing status of a media. Numeric values match the backend `smallint` column:
+ * 0 = QUEUED (upload requested, bytes not processed yet), 1 = READY, 2 = ERROR.
+ * MIGRATING (3) is reserved for provider migrations.
+ */
+export enum MediaStatus {
+    QUEUED = 0,
+    READY = 1,
+    ERROR = 2,
+    MIGRATING = 3
+}
+
 /**
  * This type describe the result of a list request on media
  * @template T The type of media requested
@@ -49,10 +69,6 @@ export type MediaGallery = {
      * The chosen media gallery description
      */
     description: string;
-    /**
-     * This is the media provider used to manage media
-     */
-    provider: string;
     /**
      * The creation date of the media gallery
      */
@@ -84,6 +100,11 @@ export type MediaGallery = {
  */
 export type MediaPublicId = string;
 
+/**
+ * This is the media numeric unique id (the media entity id)
+ */
+export type MediaId = number;
+
 /**
  * This type represent a media information
  */
@@ -121,9 +142,9 @@ export type Media = {
      */
     originalUrl: string;
     /**
-     * The thumbnail public url of the media
+     * The thumbnail public url of the media (not provided for every resource type / provider)
      */
-    thumbnailUrl: string;
+    thumbnailUrl?: string;
     /**
      * The type of the media
      */
@@ -131,12 +152,38 @@ export type Media = {
     /**
      * The tags saved with the media
      */
-    tags: string[];
+    tags?: string[];
     /**
-     * The tags saved with the media
+     * The media format
      * e.g. -> svg, jpg, png, ...
      */
-    format: string;
+    format?: string;
+    /**
+     * The dominant colors of the media. Computed by Cloudinary; empty (`[]`) for providers
+     * that don't compute them, e.g. Cloudflare.
+     */
+    colors?: any[];
+    /**
+     * The predominant color information of the media. Computed by Cloudinary; empty (`{}`)
+     * for providers that don't compute it, e.g. Cloudflare.
+     */
+    predominant?: object;
+    /**
+     * The media name
+     */
+    name?: string;
+    /**
+     * The processing status of the media. Present when the media is read from a stored row
+     * (get / list). Newly requested uploads start as `MediaStatus.QUEUED`.
+     */
+    status?: MediaStatus;
+    /**
+     * Streaming playback urls (hls / dash) for video media, when available.
+     */
+    playback?: {
+        hls?: string;
+        dash?: string;
+    };
 };
 
 /**
@@ -327,6 +374,8 @@ export type ListMediaGalleryFoldersResponse = {
     folders: Folder[];
 };
 
+export type MediaStatusFilter = 'ALL' | 'QUEUED' | 'READY';
+
 /**
  * This type represent the data needed to make a list media API request
  */
@@ -359,6 +408,11 @@ export type ListMediaRequest = {
      * The tags that the media have to contain to be searched
      */
     tags?: string[];
+
+    /**
+     * Needed for filtering list depending on media status
+     */
+    status?: MediaStatusFilter;
 };
 
 /**
@@ -375,13 +429,9 @@ export type GetMediaRequest = {
      */
     mediaGalleryId: MediaGalleryId;
     /**
-     * The path needed to locate the media in the media gallery
-     */
-    parentFolder?: string;
-    /**
-     * The media public id
+     * The media entity unique id
      */
-    mediaPublicId: string;
+    mediaId: MediaId;
 };
 
 /**
@@ -417,6 +467,11 @@ export type UploadMediaRequest = {
      * The tags saved with the media
      */
     tags?: string[];
+
+    /**
+     * mimeType of the file to upload
+     */
+    mimeType: string;
 };
 
 /**
@@ -424,22 +479,31 @@ export type UploadMediaRequest = {
  */
 export type UploadMediaResponse = {
     /**
-     * This property is a boolean that determines whether or not a media requires an additional step
+     * The provider that will handle this upload, determined server-side from the media
+     * gallery's per-mediaType provider defaults. Also selects the upload protocol:
+     * - `cloudflare`: R2 presigned upload — PUT the raw file to `uploadUrl`.
+     * - `cloudinary`: POST FormData(file) to `uploadUrl`; for large files (`largeUpload === true`)
+     *   PUT the raw file to `writeUrl`, then POST FormData(file=readUrl) to `uploadUrl`.
      */
-    largeUpload: boolean;
+    type: MediaProvider;
     /**
-     * The media provider signed url where to perform the upload request
+     * The signed url where to perform the upload request.
+     *
+     * How to send the bytes depends on `type` (see {@link MediaProvider}):
      *
      * e.g.
      * ``` js
-     *      if (largeUpload) {
-     *          // call this url with the readUrl value
+     *      if (type === 'cloudflare') {
+     *          // R2 presigned PUT of the raw file
+     *          await axios.put(uploadUrl, <THE_FILE>, { headers: { 'Content-Type': mimeType } });
+     *      } else if (largeUpload) {
+     *          // Cloudinary large file: PUT to the scratch bucket, then let Cloudinary fetch it
      *          await axios.put(writeUrl, <THE_FILE>);
      *          const formData = new FormData();
      *          formData.append('file', readUrl);
-     *          await axios.post(uploadUrl, formData)
+     *          await axios.post(uploadUrl, formData);
      *      } else {
-     *          // call this url directly with the media
+     *          // Cloudinary (small file): multipart POST of the raw file
      *          const formData = new FormData();
      *          formData.append('file', <THE_FILE>);
      *          await axios.post(uploadUrl, formData);
@@ -452,11 +516,22 @@ export type UploadMediaResponse = {
      */
     mediaPublicId: string;
     /**
-     * If the media is large (largeUpload value) this is the url where to read the file when performing a large upload
+     * Id of the media entity, created server-side as soon as the upload is requested
+     */
+    mediaId: number;
+    /**
+     * Cloudinary only. When `true` the media exceeds the direct-upload size limit and must be
+     * uploaded via the `writeUrl` + `readUrl` two-step. Undefined for cloudflare providers.
+     */
+    largeUpload?: boolean;
+    /**
+     * The url where to read the uploaded file. Present for cloudflare R2 uploads, and for
+     * cloudinary large uploads (`largeUpload === true`).
      */
     readUrl?: string;
     /**
-     * If the media is large (largeUpload value) this is the url where to write the file before to perform the real upload
+     * The url where to write the file. Present for cloudflare R2 uploads, and for
+     * cloudinary large uploads (`largeUpload === true`).
      */
     writeUrl?: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentchef/contentchef-types",
-  "version": "10.1.0",
+  "version": "11.0.0-alpha.1",
   "description": "ContentChef types",
   "author": "PierpaoloIannone <piannone@byte-code.com>",
   "homepage": "https://github.com/ContentChef/contentchef-management-js-client#readme",
@@ -34,5 +34,5 @@
   "devDependencies": {
     "typescript": "^5.9.3"
   },
-  "gitHead": "686fc2951c882a81cdbe56b5df9d60309dfebf95"
+  "gitHead": "b618c00d0b1642ac9a75685fa08e214b83e22fc8"
 }