Add types for Structured Metadata functions (#359)

* Add types for Structured Metadata functions

Author: strausr

types/cloudinary_ts_spec.ts

@@ -568,6 +568,42 @@ cloudinary.v2.api.usage(function (error, result) {
 // $ExpectType Promise<any>
 cloudinary.v2.api.usage({public_id: 'demo'});
 
+cloudinary.v2.api.add_metadata_field({
+    external_id: 'EXTERNAL_ID_GET_LIST',
+    label: 'LABEL_INT_1',
+    type: "integer",
+    default_value: 10,
+}).then((result)=> {
+    console.log(result);
+});
+
+cloudinary.v2.api.list_metadata_fields().then((result)=> {
+    console.log(result.metadata_fields[0].datasource);
+});
+
+cloudinary.v2.api.delete_metadata_field('EXTERNAL_ID_GET_LIST').then((res) => {
+  console.log(res.message)
+}).catch((err)=> {console.log(err)})
+
+cloudinary.v2.api.update_metadata_field('EXTERNAL_ID_GET_LIST',{mandatory: true},
+    function (res) {
+    console.log(res);
+})
+
+const datasource_changes = {
+    values: [
+        { external_id: "color_1", value: "brown" },
+        { external_id: "color_2", value: "black" },
+    ],
+};
+
+cloudinary.v2.api.update_metadata_field_datasource('EXTERNAL_ID_GET_LIST1', datasource_changes)
+    .then((res)=> {console.log(res)})
+    .catch((err)=> {console.log(err)});
+
+cloudinary.v2.api.delete_datasource_entries('EXTERNAL_ID_DELETE_DATASOURCE_ENTRIES', ['size_2'])
+    .then((res)=>{console.log(res)})
+
 // $ExpectType Promise<any>
 cloudinary.v2.uploader.add_context('alt=Animal|class=Mammalia', ['dog', 'lion'],
     function (error, result) {

types/index.d.ts

@@ -592,6 +592,43 @@ declare module 'cloudinary' {
     class UploadStream extends Transform {
     }
 
+    export interface DeleteApiResponse {
+        message: string;
+        http_code: number;
+    }
+
+    export interface MetadataFieldApiOptions {
+        external_id?: string;
+        type?: string;
+        label?: string;
+        mandatory?: boolean;
+        default_value?: number;
+        validation?: object;
+        datasource?: object;
+
+        [futureKey: string]: any;
+    }
+
+    export interface MetadataFieldApiResponse {
+        external_id: string;
+        type: string;
+        label: string;
+        mandatory: boolean;
+        default_value: number;
+        validation: object;
+        datasource: object;
+
+        [futureKey: string]: any;
+    }
+
+    export interface MetadataFieldsApiResponse {
+        metadata_fields: MetadataFieldApiResponse[]
+    }
+
+    export interface DatasourceChange {
+        values: Array<object>
+    }
+
     export interface ResourceApiResponse {
         resources: [
             {
@@ -851,6 +888,40 @@ declare module 'cloudinary' {
             function usage(callback?: ResponseCallback, options?: AdminApiOptions): Promise<any>;
 
             function usage(options?: AdminApiOptions): Promise<any>;
+
+            /****************************** Structured Metadata API V2 Methods *************************************/
+
+            function add_metadata_field(field: MetadataFieldApiOptions, options?: AdminApiOptions, callback?: ResponseCallback): Promise<MetadataFieldApiResponse>;
+
+            function add_metadata_field(field: MetadataFieldApiOptions, callback?: ResponseCallback): Promise<MetadataFieldApiResponse>;
+
+            function list_metadata_fields(callback?: ResponseCallback, options?: AdminApiOptions): Promise<MetadataFieldsApiResponse>;
+
+            function list_metadata_fields(options?: AdminApiOptions): Promise<MetadataFieldsApiResponse>;
+
+            function delete_metadata_field(field_external_id: string, options?: AdminApiOptions, callback?: ResponseCallback): Promise<DeleteApiResponse>;
+
+            function delete_metadata_field(field_external_id: string, callback?: ResponseCallback): Promise<DeleteApiResponse>;
+
+            function metadata_field_by_field_id(external_id:string, options?: AdminApiOptions, callback?: ResponseCallback): Promise<MetadataFieldApiResponse>;
+
+            function metadata_field_by_field_id(external_id:string, callback?: ResponseCallback): Promise<MetadataFieldApiResponse>;
+
+            function update_metadata_field(external_id: string, field: MetadataFieldApiOptions, options?: AdminApiOptions, callback?: ResponseCallback): Promise<MetadataFieldApiResponse>;
+
+            function update_metadata_field(external_id: string, field: MetadataFieldApiOptions, callback?: ResponseCallback): Promise<MetadataFieldApiResponse>;
+
+            function update_metadata_field_datasource(field_external_id: string, entries_external_id: object, options?: AdminApiOptions, callback?: ResponseCallback): Promise<DatasourceChange>;
+
+            function update_metadata_field_datasource(field_external_id: string, entries_external_id: object, callback?: ResponseCallback): Promise<DatasourceChange>;
+
+            function delete_datasource_entries(field_external_id: string, entries_external_id: string[], options?: AdminApiOptions, callback?: ResponseCallback): Promise<DatasourceChange>;
+
+            function delete_datasource_entries(field_external_id: string, entries_external_id: string[], callback?: ResponseCallback): Promise<DatasourceChange>;
+
+            function restore_metadata_field_datasource(field_external_id: string, entries_external_id: string[], options?: AdminApiOptions, callback?: ResponseCallback): Promise<DatasourceChange>;
+
+            function restore_metadata_field_datasource(field_external_id: string, entries_external_id: string[], callback?: ResponseCallback): Promise<DatasourceChange>;
         }
 
         /****************************** Upload API V2 Methods *************************************/