(feat): Add extra field support for CollectionItem (#137)

Author: fern-support

src/wrapper/CollectionsClient.ts

@@ -0,0 +1,16 @@
+import { Collections } from "../api/resources/collections/client/Client";
+import { Client as Items } from "./ItemsClient";
+
+// Client adapts the base client to permit extra properties in
+// the client.Collections.Items.createItem request.
+export class Client extends Collections {
+    constructor(protected readonly _options: Collections.Options) {
+        super(_options);
+    }
+
+    protected _items: Items | undefined;
+
+    public get items(): Items {
+        return (this._items ??= new Items(this._options));
+    }
+}

src/wrapper/ItemsClient.ts

@@ -0,0 +1,108 @@
+import urlJoin from "url-join";
+import * as Webflow from "../api";
+import { Items } from "../api/resources/collections/resources/items/client/Client";
+import * as core from "../core";
+import * as environments from "../environments";
+import * as errors from "../errors";
+import * as serializers from "../serialization";
+
+// Client adapts the base client to permit extra properties in
+// the client.Collections.Items.createItem request.
+export class Client extends Items {
+    constructor(protected readonly _options: Items.Options) {
+        super(_options);
+    }
+
+    /**
+     * Create Item in a Collection.</br></br> To create items across multiple locales, <a href="https://developers.webflow.com/data/reference/create-item-for-multiple-locales"> please use this endpoint.</a> </br></br> Required scope | `CMS:write`
+     * @throws {@link Webflow.BadRequestError}
+     * @throws {@link Webflow.UnauthorizedError}
+     * @throws {@link Webflow.NotFoundError}
+     * @throws {@link Webflow.TooManyRequestsError}
+     * @throws {@link Webflow.InternalServerError}
+     *
+     * @example
+     *     await webflow.collections.items.createItem("collection_id", {
+     *         id: "42b720ef280c7a7a3be8cabe",
+     *         cmsLocaleId: "653ad57de882f528b32e810e",
+     *         lastPublished: "2022-11-29T16:22:43.159Z",
+     *         lastUpdated: "2022-11-17T17:19:43.282Z",
+     *         createdOn: "2022-11-17T17:11:57.148Z",
+     *         isArchived: false,
+     *         isDraft: false,
+     *         fieldData: {
+     *             name: "Pan Galactic Gargle Blaster Recipe",
+     *             slug: "pan-galactic-gargle-blaster"
+     *         }
+     *     })
+     */
+    public async createItem(
+        collectionId: string,
+        request: Webflow.CollectionItem,
+        requestOptions?: Items.RequestOptions
+    ): Promise<void> {
+        const _response = await core.fetcher({
+            url: urlJoin(
+                (await core.Supplier.get(this._options.environment)) ?? environments.WebflowEnvironment.Default,
+                `collections/${collectionId}/items`
+            ),
+            method: "POST",
+            headers: {
+                Authorization: await this._getAuthorizationHeader(),
+                "X-Fern-Language": "JavaScript",
+                "X-Fern-SDK-Name": "webflow-api",
+                "X-Fern-SDK-Version": "v2.2.1",
+                "X-Fern-Runtime": core.RUNTIME.type,
+                "X-Fern-Runtime-Version": core.RUNTIME.version,
+            },
+            contentType: "application/json",
+            body: await serializers.CollectionItem.jsonOrThrow(
+                request, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                },
+            ),
+            timeoutMs: requestOptions?.timeoutInSeconds != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+            maxRetries: requestOptions?.maxRetries,
+        });
+        if (_response.ok) {
+            return;
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new Webflow.BadRequestError(_response.error.body);
+                case 401:
+                    throw new Webflow.UnauthorizedError(_response.error.body);
+                case 404:
+                    throw new Webflow.NotFoundError(_response.error.body);
+                case 429:
+                    throw new Webflow.TooManyRequestsError(_response.error.body);
+                case 500:
+                    throw new Webflow.InternalServerError(_response.error.body);
+                default:
+                    throw new errors.WebflowError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                    });
+            }
+        }
+
+        switch (_response.error.reason) {
+            case "non-json":
+                throw new errors.WebflowError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.rawBody,
+                });
+            case "timeout":
+                throw new errors.WebflowTimeoutError();
+            case "unknown":
+                throw new errors.WebflowError({
+                    message: _response.error.errorMessage,
+                });
+        }
+    }
+}

src/wrapper/WebflowClient.ts

@@ -1,10 +1,21 @@
+import qs from "qs";
 import { WebflowClient as FernClient } from "../Client";
 import { OauthScope } from "../api/types";
-import * as errors from "../errors";
 import * as core from "../core";
-import qs from "qs";
+import * as errors from "../errors";
+import { Client as Collections } from "./CollectionsClient";
 
 export class WebflowClient extends FernClient {
+    constructor(protected readonly _options: FernClient.Options) {
+        super(_options);
+    }
+
+    protected _collections: Collections | undefined;
+
+    public get collections(): Collections {
+        return (this._collections ??= new Collections(this._options));
+    }
+
     /**
      * @param clientId The OAuth client ID
      * @param state The state