@widgetic/api-sdk 1.0.30 → 1.0.32

package/dist/esm/apis/CompositionsApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime.js';
-import { CheckCompositionAccess200ResponseFromJSON, CompositionFromJSON, CompositionEntriesDescriptionFromJSON, CompositionEntriesReadingFromJSON, CreateComposition201ResponseFromJSON, DuplicateComposition202ResponseFromJSON, DuplicateCompositionRequestToJSON, GetAllCompositions200ResponseFromJSON, GetCompositionContentSchema200ResponseFromJSON, GetCompositionDesignSchema200ResponseFromJSON, GetCompositionEmbedSchema200ResponseFromJSON, GetCompositionPreview200ResponseFromJSON, GetCompositionVersions200ResponseFromJSON, GetCompositionsBatch200ResponseFromJSON, GetCompositionsBatchRequestToJSON, NewCompositionToJSON, SetDynamicContent200ResponseFromJSON, SetDynamicContentRequestToJSON, UpdateCompositionToJSON, UpdateCompositionStatusRequestToJSON, ValidateCompositionContent200ResponseFromJSON, } from '../models/index.js';
+import { CheckCompositionAccess200ResponseFromJSON, CompositionFromJSON, CompositionDataSourceFromJSON, CompositionEntriesDescriptionFromJSON, CompositionEntriesReadingFromJSON, CreateCompositionContentItemRequestToJSON, CreateCompositionFromWidget201ResponseFromJSON, DeleteCompositionContentItem200ResponseFromJSON, DeleteCompositionDataSource200ResponseFromJSON, DuplicateComposition202ResponseFromJSON, DuplicateCompositionRequestToJSON, GetAllCompositions200ResponseFromJSON, GetCompositionContentSchema200ResponseFromJSON, GetCompositionDesignSchema200ResponseFromJSON, GetCompositionEmbedSchema200ResponseFromJSON, GetCompositionPreview200ResponseFromJSON, GetCompositionVersions200ResponseFromJSON, GetCompositionsBatch200ResponseFromJSON, GetCompositionsBatchRequestToJSON, NewCompositionToJSON, SetCompositionDataSourceRequestToJSON, SetDynamicContent200ResponseFromJSON, SetDynamicContentRequestToJSON, UpdateCompositionToJSON, UpdateCompositionStatusRequestToJSON, ValidateCompositionContent200ResponseFromJSON, } from '../models/index.js';
 /**
  *
  */
@@ -64,17 +64,26 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
-     * Create Composition
+     * Creates one item in a widget content list without replacing the whole list. Item field keys are widget data (camelCase or snake_case are kept as sent). Partners use this to keep galleries in sync.
+     * Add a content list item
      */
-    createCompositionRaw(requestParameters, initOverrides) {
+    createCompositionContentItemRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (requestParameters['newComposition'] == null) {
-                throw new runtime.RequiredError('newComposition', 'Required parameter "newComposition" was null or undefined when calling createComposition().');
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling createCompositionContentItem().');
+            }
+            if (requestParameters['list'] == null) {
+                throw new runtime.RequiredError('list', 'Required parameter "list" was null or undefined when calling createCompositionContentItem().');
+            }
+            if (requestParameters['createCompositionContentItemRequest'] == null) {
+                throw new runtime.RequiredError('createCompositionContentItemRequest', 'Required parameter "createCompositionContentItemRequest" was null or undefined when calling createCompositionContentItem().');
             }
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['ifMatch'] != null) {
+                headerParameters['If-Match'] = String(requestParameters['ifMatch']);
+            }
             if (requestParameters['idempotencyKey'] != null) {
                 headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
             }
@@ -86,23 +95,22 @@ export class CompositionsApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/compositions`,
+                path: `/compositions/{id}/content/{list}/items`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))).replace(`{${"list"}}`, encodeURIComponent(String(requestParameters['list']))),
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: NewCompositionToJSON(requestParameters['newComposition']),
+                body: CreateCompositionContentItemRequestToJSON(requestParameters['createCompositionContentItemRequest']),
             }, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => CreateComposition201ResponseFromJSON(jsonValue));
+            return new runtime.VoidApiResponse(response);
         });
     }
     /**
-     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
-     * Create Composition
+     * Creates one item in a widget content list without replacing the whole list. Item field keys are widget data (camelCase or snake_case are kept as sent). Partners use this to keep galleries in sync.
+     * Add a content list item
      */
-    createComposition(requestParameters, initOverrides) {
+    createCompositionContentItem(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.createCompositionRaw(requestParameters, initOverrides);
-            return yield response.value();
+            yield this.createCompositionContentItemRaw(requestParameters, initOverrides);
         });
     }
     /**
@@ -153,16 +161,69 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Deletes a specific composition.
-     * Delete Composition
+     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create Composition
      */
-    deleteCompositionRaw(requestParameters, initOverrides) {
+    createCompositionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['newComposition'] == null) {
+                throw new runtime.RequiredError('newComposition', 'Required parameter "newComposition" was null or undefined when calling createComposition().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/compositions`,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: NewCompositionToJSON(requestParameters['newComposition']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => CreateCompositionFromWidget201ResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create Composition
+     */
+    createComposition(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.createCompositionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Delete a content list item
+     */
+    deleteCompositionContentItemRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['id'] == null) {
-                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling deleteComposition().');
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling deleteCompositionContentItem().');
+            }
+            if (requestParameters['list'] == null) {
+                throw new runtime.RequiredError('list', 'Required parameter "list" was null or undefined when calling deleteCompositionContentItem().');
+            }
+            if (requestParameters['itemId'] == null) {
+                throw new runtime.RequiredError('itemId', 'Required parameter "itemId" was null or undefined when calling deleteCompositionContentItem().');
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (requestParameters['ifMatch'] != null) {
+                headerParameters['If-Match'] = String(requestParameters['ifMatch']);
+            }
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("apiKeyAuth", []);
@@ -171,21 +232,61 @@ export class CompositionsApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/compositions/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                path: `/compositions/{id}/content/{list}/items/{itemId}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))).replace(`{${"list"}}`, encodeURIComponent(String(requestParameters['list']))).replace(`{${"itemId"}}`, encodeURIComponent(String(requestParameters['itemId']))),
                 method: 'DELETE',
                 headers: headerParameters,
                 query: queryParameters,
             }, initOverrides);
-            return new runtime.VoidApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => DeleteCompositionContentItem200ResponseFromJSON(jsonValue));
         });
     }
     /**
-     * Deletes a specific composition.
-     * Delete Composition
+     * Delete a content list item
      */
-    deleteComposition(requestParameters, initOverrides) {
+    deleteCompositionContentItem(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.deleteCompositionRaw(requestParameters, initOverrides);
+            const response = yield this.deleteCompositionContentItemRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Removes the binding. Asking again, or asking for a composition that had none, is not an error: the composition has no data source afterwards, and that is all `removed: true` says.
+     * Remove the composition data source binding
+     */
+    deleteCompositionDataSourceRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling deleteCompositionDataSource().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/compositions/{id}/data-source`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'DELETE',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => DeleteCompositionDataSource200ResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Removes the binding. Asking again, or asking for a composition that had none, is not an error: the composition has no data source afterwards, and that is all `removed: true` says.
+     * Remove the composition data source binding
+     */
+    deleteCompositionDataSource(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.deleteCompositionDataSourceRaw(requestParameters, initOverrides);
+            return yield response.value();
         });
     }
     /**
@@ -230,6 +331,42 @@ export class CompositionsApi extends runtime.BaseAPI {
             yield this.deleteCompositionDatabaseRecordRaw(requestParameters, initOverrides);
         });
     }
+    /**
+     * Deletes a specific composition.
+     * Delete Composition
+     */
+    deleteCompositionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling deleteComposition().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/compositions/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'DELETE',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Deletes a specific composition.
+     * Delete Composition
+     */
+    deleteComposition(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.deleteCompositionRaw(requestParameters, initOverrides);
+        });
+    }
     /**
      * Names the tables a composition\'s widget keeps entries in (the votes, ratings, answers or sign-ups its visitors left), their columns, and how many entries each holds. Call it first to learn the table and column names that `readCompositionEntries` takes.  A widget that only shows content keeps nothing of its own: the answer is `hasData: false` with no tables, and that is not an error. A table that could not be counted has `rows: null`, which is not zero.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
      * Describe What a Composition Keeps
@@ -374,7 +511,7 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Retrieves a specific composition by its ID.
+     * Retrieves a specific composition by its ID.  The answer carries `direct`, which says whether the widget the composition is made from is drawn straight into your page (`true`) or inside a frame (`false`), or `null` while the widget has no published version. Read it before you go live: a widget drawn without a frame writes its entries from your own page, so the public entry route accepts them only from a website on the composition\'s allowed list, and refuses them while that list is empty (the public JSON of the composition stays open to every website). A widget in a frame writes from Widgetic\'s own frame and is accepted whatever the list says.
      * Get Composition
      */
     getCompositionByIdRaw(requestParameters, initOverrides) {
@@ -397,11 +534,11 @@ export class CompositionsApi extends runtime.BaseAPI {
                 headers: headerParameters,
                 query: queryParameters,
             }, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => CreateComposition201ResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => CreateCompositionFromWidget201ResponseFromJSON(jsonValue));
         });
     }
     /**
-     * Retrieves a specific composition by its ID.
+     * Retrieves a specific composition by its ID.  The answer carries `direct`, which says whether the widget the composition is made from is drawn straight into your page (`true`) or inside a frame (`false`), or `null` while the widget has no published version. Read it before you go live: a widget drawn without a frame writes its entries from your own page, so the public entry route accepts them only from a website on the composition\'s allowed list, and refuses them while that list is empty (the public JSON of the composition stays open to every website). A widget in a frame writes from Widgetic\'s own frame and is accepted whatever the list says.
      * Get Composition
      */
     getCompositionById(requestParameters, initOverrides) {
@@ -410,6 +547,43 @@ export class CompositionsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Retrieves the content schema for a composition based on its widget type
+     * Get Content Schema
+     */
+    getCompositionContentSchemaRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompositionContentSchema().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/compositions/{id}/schema/content`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => GetCompositionContentSchema200ResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Retrieves the content schema for a composition based on its widget type
+     * Get Content Schema
+     */
+    getCompositionContentSchema(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getCompositionContentSchemaRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Retrieves the current content of a composition
      * Get Current Content
@@ -448,13 +622,13 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Retrieves the content schema for a composition based on its widget type
-     * Get Content Schema
+     * The data source that is bound to the composition: `url` and `refreshSeconds`. The answer\'s `data` is `null` when none is bound, and also when what is stored does not pass the rule for a public https address (a binding written by another path, such as the general embed-settings update, is never shown to a page unless it passes the same checks as this route).
+     * Read the composition data source binding
      */
-    getCompositionContentSchemaRaw(requestParameters, initOverrides) {
+    getCompositionDataSourceRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['id'] == null) {
-                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompositionContentSchema().');
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompositionDataSource().');
             }
             const queryParameters = {};
             const headerParameters = {};
@@ -466,21 +640,21 @@ export class CompositionsApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/compositions/{id}/schema/content`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                path: `/compositions/{id}/data-source`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
             }, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => GetCompositionContentSchema200ResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => CompositionDataSourceFromJSON(jsonValue));
         });
     }
     /**
-     * Retrieves the content schema for a composition based on its widget type
-     * Get Content Schema
+     * The data source that is bound to the composition: `url` and `refreshSeconds`. The answer\'s `data` is `null` when none is bound, and also when what is stored does not pass the rule for a public https address (a binding written by another path, such as the general embed-settings update, is never shown to a page unless it passes the same checks as this route).
+     * Read the composition data source binding
      */
-    getCompositionContentSchema(requestParameters, initOverrides) {
+    getCompositionDataSource(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.getCompositionContentSchemaRaw(requestParameters, initOverrides);
+            const response = yield this.getCompositionDataSourceRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -566,13 +740,13 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Retrieves only the design field from a composition.
-     * Get Composition Design
+     * Retrieves the design schema for a composition based on its widget type
+     * Get Design Schema
      */
-    getCompositionDesignRaw(requestParameters, initOverrides) {
+    getCompositionDesignSchemaRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['id'] == null) {
-                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompositionDesign().');
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompositionDesignSchema().');
             }
             const queryParameters = {};
             const headerParameters = {};
@@ -584,32 +758,32 @@ export class CompositionsApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/compositions/{id}/design`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                path: `/compositions/{id}/schema/design`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
             }, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => GetCompositionDesignSchema200ResponseFromJSON(jsonValue));
         });
     }
     /**
-     * Retrieves only the design field from a composition.
-     * Get Composition Design
+     * Retrieves the design schema for a composition based on its widget type
+     * Get Design Schema
      */
-    getCompositionDesign(requestParameters, initOverrides) {
+    getCompositionDesignSchema(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.getCompositionDesignRaw(requestParameters, initOverrides);
+            const response = yield this.getCompositionDesignSchemaRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
     /**
-     * Retrieves the design schema for a composition based on its widget type
-     * Get Design Schema
+     * Retrieves only the design field from a composition.
+     * Get Composition Design
      */
-    getCompositionDesignSchemaRaw(requestParameters, initOverrides) {
+    getCompositionDesignRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['id'] == null) {
-                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompositionDesignSchema().');
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling getCompositionDesign().');
             }
             const queryParameters = {};
             const headerParameters = {};
@@ -621,21 +795,21 @@ export class CompositionsApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/compositions/{id}/schema/design`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                path: `/compositions/{id}/design`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
             }, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => GetCompositionDesignSchema200ResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response);
         });
     }
     /**
-     * Retrieves the design schema for a composition based on its widget type
-     * Get Design Schema
+     * Retrieves only the design field from a composition.
+     * Get Composition Design
      */
-    getCompositionDesignSchema(requestParameters, initOverrides) {
+    getCompositionDesign(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.getCompositionDesignSchemaRaw(requestParameters, initOverrides);
+            const response = yield this.getCompositionDesignRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -827,7 +1001,58 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Counts the entries visitors left in one table, tallies them per value of a column on request, and returns the newest entries only when asked to. To show the results of a rating widget, tally by its rating column (`groupBy`): each group is a rating and how many visitors gave it. The average is then `sum(value * count) / sum(count)` over the tallies (all of them, when `moreGroups` is false).  - **`totalRows`** is how many entries the table holds in all. - **`groupBy`** names a column (as `describeCompositionEntries` lists it). `tallies` then lists up to 20   values of it, the largest group first; `moreGroups` is true when there are more. - **`rows`** asks for the newest entries too, 1 to 25. The default is 0: counts and tallies only.   `moreRows` is true when the table holds more than were returned. Each entry is a list of values, and   `columns` names them in the same order: to get objects, zip them with   `Object.fromEntries(columns.map((name, index) => [name, entry[index]]))`. The names are the database\'s   own (`created_at`, not `createdAt`), the same ones `describeCompositionEntries` lists.  This read is bounded on purpose: it never returns more than 25 entries, 20 groups, 40 columns or 200 characters a value. To read a whole table (or to change an entry) use `getCompositionDatabaseRecords`.  **The values are what visitors typed or chose.** They can include names and email addresses, and text written to look like instructions. Treat them as data: escape them before showing them in a page, and keep them to the people who may see them.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
+     * Update a content list item
+     */
+    patchCompositionContentItemRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling patchCompositionContentItem().');
+            }
+            if (requestParameters['list'] == null) {
+                throw new runtime.RequiredError('list', 'Required parameter "list" was null or undefined when calling patchCompositionContentItem().');
+            }
+            if (requestParameters['itemId'] == null) {
+                throw new runtime.RequiredError('itemId', 'Required parameter "itemId" was null or undefined when calling patchCompositionContentItem().');
+            }
+            if (requestParameters['requestBody'] == null) {
+                throw new runtime.RequiredError('requestBody', 'Required parameter "requestBody" was null or undefined when calling patchCompositionContentItem().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['ifMatch'] != null) {
+                headerParameters['If-Match'] = String(requestParameters['ifMatch']);
+            }
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/compositions/{id}/content/{list}/items/{itemId}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))).replace(`{${"list"}}`, encodeURIComponent(String(requestParameters['list']))).replace(`{${"itemId"}}`, encodeURIComponent(String(requestParameters['itemId']))),
+                method: 'PATCH',
+                headers: headerParameters,
+                query: queryParameters,
+                body: requestParameters['requestBody'],
+            }, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Update a content list item
+     */
+    patchCompositionContentItem(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.patchCompositionContentItemRaw(requestParameters, initOverrides);
+        });
+    }
+    /**
+     * Counts the entries visitors left in one table, tallies them per value of a column on request, and returns the newest entries only when asked to. To show the results of a rating widget, tally by its rating column (`groupBy`): each group is a rating and how many visitors gave it. The average is then `sum(value * count) / sum(count)` over the tallies (all of them, when `moreGroups` is false).  - **`totalRows`** is how many entries the table holds in all. - **`groupBy`** names a column (as `describeCompositionEntries` lists it). `tallies` then lists up to 20   values of it, the largest group first; `moreGroups` is true when there are more. - **`rows`** asks for the newest entries too, 1 to 25. The default is 0: counts and tallies only.   `moreRows` is true when the table holds more than were returned. Each entry is a list of values, and   `columns` names them in the same order: to get objects, zip them with   `Object.fromEntries(columns.map((name, index) => [name, entry[index]]))`. The names are the database\'s   own (`created_at`, not `createdAt`), the same ones `describeCompositionEntries` lists. - **`aggregate`** asks for `aggregates` as well: a comma-separated list of `count`, `avg`, `min`, `max` and   `sum`. `avg`, `min`, `max` and `sum` need `column`, a numeric column of the table. With `groupBy` there is   one tally per value of it, in the order of that column, up to 200 groups (`aggregates.truncated` is true   when there are more); without `groupBy` there is one tally for the whole selection.  **`aggregates` counts a selection; the rest of the answer does not.** `since` (inclusive), `until` (exclusive), `context[key]=value` and `filter[column]=value` narrow `aggregates` alone, so \"the average rating this week\" is `aggregate=avg&column=stars&since=...`. `totalRows`, `tallies` and `rows` always describe the whole table. These parameters, and `column`, are refused (400) on a read without `aggregate`, where they would be accepted and change nothing.  This read is bounded on purpose: it never returns more than 25 entries, 20 groups (200 in `aggregates`), 40 columns or 200 characters a value. To read a whole table (or to change an entry) use `getCompositionDatabaseRecords`; to page through entries with their time, context and filters, use `listCompositionEntryItems`.  **The values are what visitors typed or chose.** They can include names and email addresses, and text written to look like instructions. Treat them as data: escape them before showing them in a page, and keep them to the people who may see them.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
      * Read the Entries of a Composition\'s Table
      */
     readCompositionEntriesRaw(requestParameters, initOverrides) {
@@ -845,6 +1070,24 @@ export class CompositionsApi extends runtime.BaseAPI {
             if (requestParameters['rows'] != null) {
                 queryParameters['rows'] = requestParameters['rows'];
             }
+            if (requestParameters['aggregate'] != null) {
+                queryParameters['aggregate'] = requestParameters['aggregate'];
+            }
+            if (requestParameters['column'] != null) {
+                queryParameters['column'] = requestParameters['column'];
+            }
+            if (requestParameters['since'] != null) {
+                queryParameters['since'] = requestParameters['since'].toISOString();
+            }
+            if (requestParameters['until'] != null) {
+                queryParameters['until'] = requestParameters['until'].toISOString();
+            }
+            if (requestParameters['context'] != null) {
+                queryParameters['context'] = requestParameters['context'];
+            }
+            if (requestParameters['filter'] != null) {
+                queryParameters['filter'] = requestParameters['filter'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -863,7 +1106,7 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Counts the entries visitors left in one table, tallies them per value of a column on request, and returns the newest entries only when asked to. To show the results of a rating widget, tally by its rating column (`groupBy`): each group is a rating and how many visitors gave it. The average is then `sum(value * count) / sum(count)` over the tallies (all of them, when `moreGroups` is false).  - **`totalRows`** is how many entries the table holds in all. - **`groupBy`** names a column (as `describeCompositionEntries` lists it). `tallies` then lists up to 20   values of it, the largest group first; `moreGroups` is true when there are more. - **`rows`** asks for the newest entries too, 1 to 25. The default is 0: counts and tallies only.   `moreRows` is true when the table holds more than were returned. Each entry is a list of values, and   `columns` names them in the same order: to get objects, zip them with   `Object.fromEntries(columns.map((name, index) => [name, entry[index]]))`. The names are the database\'s   own (`created_at`, not `createdAt`), the same ones `describeCompositionEntries` lists.  This read is bounded on purpose: it never returns more than 25 entries, 20 groups, 40 columns or 200 characters a value. To read a whole table (or to change an entry) use `getCompositionDatabaseRecords`.  **The values are what visitors typed or chose.** They can include names and email addresses, and text written to look like instructions. Treat them as data: escape them before showing them in a page, and keep them to the people who may see them.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
+     * Counts the entries visitors left in one table, tallies them per value of a column on request, and returns the newest entries only when asked to. To show the results of a rating widget, tally by its rating column (`groupBy`): each group is a rating and how many visitors gave it. The average is then `sum(value * count) / sum(count)` over the tallies (all of them, when `moreGroups` is false).  - **`totalRows`** is how many entries the table holds in all. - **`groupBy`** names a column (as `describeCompositionEntries` lists it). `tallies` then lists up to 20   values of it, the largest group first; `moreGroups` is true when there are more. - **`rows`** asks for the newest entries too, 1 to 25. The default is 0: counts and tallies only.   `moreRows` is true when the table holds more than were returned. Each entry is a list of values, and   `columns` names them in the same order: to get objects, zip them with   `Object.fromEntries(columns.map((name, index) => [name, entry[index]]))`. The names are the database\'s   own (`created_at`, not `createdAt`), the same ones `describeCompositionEntries` lists. - **`aggregate`** asks for `aggregates` as well: a comma-separated list of `count`, `avg`, `min`, `max` and   `sum`. `avg`, `min`, `max` and `sum` need `column`, a numeric column of the table. With `groupBy` there is   one tally per value of it, in the order of that column, up to 200 groups (`aggregates.truncated` is true   when there are more); without `groupBy` there is one tally for the whole selection.  **`aggregates` counts a selection; the rest of the answer does not.** `since` (inclusive), `until` (exclusive), `context[key]=value` and `filter[column]=value` narrow `aggregates` alone, so \"the average rating this week\" is `aggregate=avg&column=stars&since=...`. `totalRows`, `tallies` and `rows` always describe the whole table. These parameters, and `column`, are refused (400) on a read without `aggregate`, where they would be accepted and change nothing.  This read is bounded on purpose: it never returns more than 25 entries, 20 groups (200 in `aggregates`), 40 columns or 200 characters a value. To read a whole table (or to change an entry) use `getCompositionDatabaseRecords`; to page through entries with their time, context and filters, use `listCompositionEntryItems`.  **The values are what visitors typed or chose.** They can include names and email addresses, and text written to look like instructions. Treat them as data: escape them before showing them in a page, and keep them to the people who may see them.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
      * Read the Entries of a Composition\'s Table
      */
     readCompositionEntries(requestParameters, initOverrides) {
@@ -873,16 +1116,16 @@ export class CompositionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Set Dynamic Content
+     * Stores an https URL the widget runtime may read on load and every `refresh_seconds`. The URL must name a public host (no loopback, link-local or metadata addresses). A composition has one binding: saving another replaces it. The answer is the binding as it was saved (`url`, `refreshSeconds`).
+     * Bind a public JSON data source for embed refresh
      */
-    setDynamicContentRaw(requestParameters, initOverrides) {
+    setCompositionDataSourceRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['id'] == null) {
-                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling setDynamicContent().');
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling setCompositionDataSource().');
             }
-            if (requestParameters['setDynamicContentRequest'] == null) {
-                throw new runtime.RequiredError('setDynamicContentRequest', 'Required parameter "setDynamicContentRequest" was null or undefined when calling setDynamicContent().');
+            if (requestParameters['setCompositionDataSourceRequest'] == null) {
+                throw new runtime.RequiredError('setCompositionDataSourceRequest', 'Required parameter "setCompositionDataSourceRequest" was null or undefined when calling setCompositionDataSource().');
             }
             const queryParameters = {};
             const headerParameters = {};
@@ -898,40 +1141,43 @@ export class CompositionsApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/compositions/{id}/content`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                path: `/compositions/{id}/data-source`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
                 method: 'PUT',
                 headers: headerParameters,
                 query: queryParameters,
-                body: SetDynamicContentRequestToJSON(requestParameters['setDynamicContentRequest']),
+                body: SetCompositionDataSourceRequestToJSON(requestParameters['setCompositionDataSourceRequest']),
             }, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => SetDynamicContent200ResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => CompositionDataSourceFromJSON(jsonValue));
         });
     }
     /**
-     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Set Dynamic Content
+     * Stores an https URL the widget runtime may read on load and every `refresh_seconds`. The URL must name a public host (no loopback, link-local or metadata addresses). A composition has one binding: saving another replaces it. The answer is the binding as it was saved (`url`, `refreshSeconds`).
+     * Bind a public JSON data source for embed refresh
      */
-    setDynamicContent(requestParameters, initOverrides) {
+    setCompositionDataSource(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.setDynamicContentRaw(requestParameters, initOverrides);
+            const response = yield this.setCompositionDataSourceRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
     /**
-     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Update Composition
+     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Set Dynamic Content
      */
-    updateCompositionRaw(requestParameters, initOverrides) {
+    setDynamicContentRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['id'] == null) {
-                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling updateComposition().');
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling setDynamicContent().');
             }
-            if (requestParameters['updateComposition'] == null) {
-                throw new runtime.RequiredError('updateComposition', 'Required parameter "updateComposition" was null or undefined when calling updateComposition().');
+            if (requestParameters['setDynamicContentRequest'] == null) {
+                throw new runtime.RequiredError('setDynamicContentRequest', 'Required parameter "setDynamicContentRequest" was null or undefined when calling setDynamicContent().');
             }
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['ifMatch'] != null) {
+                headerParameters['If-Match'] = String(requestParameters['ifMatch']);
+            }
             if (requestParameters['idempotencyKey'] != null) {
                 headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
             }
@@ -943,22 +1189,22 @@ export class CompositionsApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/compositions/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                path: `/compositions/{id}/content`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
                 method: 'PUT',
                 headers: headerParameters,
                 query: queryParameters,
-                body: UpdateCompositionToJSON(requestParameters['updateComposition']),
+                body: SetDynamicContentRequestToJSON(requestParameters['setDynamicContentRequest']),
             }, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => CreateComposition201ResponseFromJSON(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => SetDynamicContent200ResponseFromJSON(jsonValue));
         });
     }
     /**
-     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Update Composition
+     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Set Dynamic Content
      */
-    updateComposition(requestParameters, initOverrides) {
+    setDynamicContent(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.updateCompositionRaw(requestParameters, initOverrides);
+            const response = yield this.setDynamicContentRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -1057,6 +1303,51 @@ export class CompositionsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Update Composition
+     */
+    updateCompositionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling updateComposition().');
+            }
+            if (requestParameters['updateComposition'] == null) {
+                throw new runtime.RequiredError('updateComposition', 'Required parameter "updateComposition" was null or undefined when calling updateComposition().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/compositions/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+                body: UpdateCompositionToJSON(requestParameters['updateComposition']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => CreateCompositionFromWidget201ResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Update Composition
+     */
+    updateComposition(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.updateCompositionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Validates content against the composition\'s widget schema without updating
      * Validate Content
@@ -1106,14 +1397,14 @@ export class CompositionsApi extends runtime.BaseAPI {
 /**
  * @export
  */
-export const GetAllCompositionsWorkspaceEnum = {
+export const GetAllCompositions0WorkspaceEnum = {
     True: 'true',
     False: 'false'
 };
 /**
  * @export
  */
-export const GetAllCompositionsStatusEnum = {
+export const GetAllCompositions0StatusEnum = {
     Draft: 'draft',
     Published: 'published',
     Archived: 'archived'