webflow-api 0.5.3 → 0.7.0

package/index.d.ts

@@ -0,0 +1,354 @@
+declare class Webflow {
+  constructor(options: Webflow.WebflowOptions);
+
+  get<Result extends any>(
+    path: string,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Result>;
+  post<Data extends any, Result extends any>(
+    path: string,
+    data?: Data,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Result>;
+  put<Data extends any, Result extends any>(
+    path: string,
+    data?: Data,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Result>;
+  patch<Data extends any, Result extends any>(
+    path: string,
+    data?: Data,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Result>;
+  delete<Result extends any>(
+    path: string,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Result>;
+
+  info(query?: Webflow.WebflowQueryArg): Promise<Webflow.WebflowApiModel.Info>;
+
+  // sites
+
+  sites(
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Site[]>;
+
+  site(
+    params: {
+      siteId: string;
+    },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Site>;
+
+  publishSite(
+    data: {
+      siteId: string;
+      domains: string[];
+    },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<{ queued: boolean }>;
+
+  // Domains
+
+  domains(
+    data: {
+      siteId: string;
+    },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Domain[]>;
+
+  // Collections
+
+  collections(
+    data: {
+      siteId: string;
+    },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Collection[]>;
+  collection(
+    data: {
+      collectionId: string;
+    },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Collection>;
+
+  // Items
+
+  items(
+    data: {
+      collectionId: string;
+    },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.ItemsResponse>;
+
+  item(
+    data: {
+      collectionId: string;
+      itemId: string;
+    },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.CollectionItem>;
+
+  createItem(
+    // TODO: add a better data type
+    data: { collectionId: string } & Record<string, any>,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.CollectionItem>;
+
+  updateItem(
+    // TODO: add a better data type
+    data: { collectionId: string; itemId: string } & Record<string, any>,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.CollectionItem>;
+
+  removeItem(
+    data: { collectionId: string; itemId: string },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<{ deleted: number }>;
+
+  patchItem(
+    // TODO: add a better data type
+    data: { collectionId: string; itemId: string } & Record<string, any>,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.CollectionItem>;
+
+  // Webhooks
+
+  webhooks(
+    data: { siteId: string },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Webhook[]>;
+
+  webhook(
+    data: { siteId: string; webhookId: string },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Webhook>;
+
+  createWebhook(
+    // TODO: add a better data type
+    data: { siteId: string } & Record<string, any>,
+    query?: Webflow.WebflowQueryArg
+  ): Promise<Webflow.WebflowApiModel.Webhook>;
+
+  removeWebhook(
+    data: { siteId: string; webhookId: string },
+    query?: Webflow.WebflowQueryArg
+  ): Promise<{ deleted: number }>;
+}
+
+declare namespace Webflow {
+  // other exported properties
+  class WebflowError extends Error {}
+
+  // helper types / namespaces
+  type WebflowQueryArg = Record<string, any>;
+
+  interface WebflowOptions {
+    token: string;
+    endpoint?: string;
+    version?: string;
+  }
+
+  namespace WebflowApiModel {
+    interface InfoApplication {
+      _id: string;
+      description: string;
+      homepage: string;
+      name: string;
+      owner: string;
+      ownerType: string;
+    }
+
+    /**
+     * https://developers.webflow.com/?javascript#get-current-authorization-info
+     */
+    interface Info {
+      _id: string;
+      createdOn: string;
+      grantType: string;
+      lastUsed: string;
+      sites: string[];
+      orgs: string[];
+      users: string[];
+      rateLimit: number;
+      status: string;
+      application: InfoApplication;
+    }
+    /**
+     * https://developers.webflow.com/?javascript#sites
+     */
+    interface Site {
+      _id: string;
+      createdOn: string;
+      name: string;
+      shortName: string;
+      lastPublished: string;
+      previewUrl: string;
+      timezone: string;
+      database: string;
+
+      collections: OmitFirstArgOfFunction<Webflow["collections"]>;
+      webhooks: OmitFirstArgOfFunction<Webflow["webhooks"]>;
+      domains: OmitFirstArgOfFunction<Webflow["domains"]>;
+      webhook: OmitPropertyFromFirstArgOfFunction<Webflow["webhook"], "siteId">;
+      createWebhook: OmitPropertyFromFirstArgOfFunction<
+        Webflow["createWebhook"],
+        "siteId"
+      >;
+      removeWebhook: OmitPropertyFromFirstArgOfFunction<
+        Webflow["removeWebhook"],
+        "siteId"
+      >;
+      publishSite: OmitPropertyFromFirstArgOfFunction<
+        Webflow["publishSite"],
+        "siteId"
+      >;
+    }
+
+    /**
+     * https://developers.webflow.com/?javascript#domains
+     */
+    interface Domain {
+      _id: string;
+      name: string;
+    }
+
+    /**
+     * https://developers.webflow.com/?javascript#collections
+     */
+    interface Collection {
+      _id: string;
+      lastUpdated: string;
+      createdOn: string;
+      name: string;
+      slug: string;
+      singularName: string;
+      fields: CollectionField[];
+
+      items: OmitFirstArgOfFunction<Webflow["items"]>;
+      item: OmitPropertyFromFirstArgOfFunction<Webflow["item"], "collectionId">;
+      createItem: OmitPropertyFromFirstArgOfFunction<
+        Webflow["createItem"],
+        "collectionId"
+      >;
+      updateItem: OmitPropertyFromFirstArgOfFunction<
+        Webflow["updateItem"],
+        "collectionId"
+      >;
+      removeItem: OmitPropertyFromFirstArgOfFunction<
+        Webflow["removeItem"],
+        "collectionId"
+      >;
+    }
+
+    type CollectionFieldType =
+      | "Bool"
+      | "Color"
+      | "Date"
+      | "ExtFileRef"
+      | "Set"
+      | "ImageRef"
+      | "Set"
+      | "ItemRef"
+      | "ItemRefSet"
+      | "Link"
+      | "Number"
+      | "Option"
+      | "PlainText"
+      | "RichText"
+      | "Video"
+      | "User";
+
+    /**
+     * https://developers.webflow.com/?javascript#fields
+     */
+    interface CollectionField {
+      id: string;
+      type: CollectionFieldType;
+      slug: string;
+      name: string;
+      required: boolean;
+      editable: boolean;
+      // TODO: add a better type
+      validations: any;
+    }
+
+    /**
+     * https://developers.webflow.com/?javascript#items
+     */
+    interface CollectionItem extends Record<string, any> {
+      _archived: boolean;
+      _draft: boolean;
+      _id: string;
+      _cid: string;
+      name: string;
+      slug: string;
+      "updated-on": string;
+      "created-on": string;
+      "published-on": string;
+      "updated-by": string;
+      "created-by": string;
+      "published-by": string;
+
+      update: OmitPropertyFromFirstArgOfFunction<
+        Webflow["updateItem"],
+        "collectionId" | "itemId"
+      >;
+      remove: OmitFirstArgOfFunction<Webflow["removeItem"]>;
+    }
+
+    interface ResponseMeta {
+      rateLimit: {
+        limit: number;
+        remaining: number;
+      }
+    }
+
+    interface ItemsResponse {
+      items: CollectionItem[];
+      count: number;
+      limit: number;
+      offset: number;
+      total: number;
+      _meta: ResponseMeta;
+    }
+
+    type WebhookTriggerType =
+      | "form_submission"
+      | "site_publish"
+      | "ecomm_new_order"
+      | "ecomm_order_changed"
+      | "ecomm_inventory_changed"
+      | "collection_item_created"
+      | "collection_item_changed"
+      | "collection_item_deleted";
+
+    interface Webhook {
+      _id: string;
+      triggerType: WebhookTriggerType;
+      triggerId: string;
+      site: string;
+      filter: string;
+      lastUsed: string;
+      createdOn: string;
+
+      remove: OmitFirstArgOfFunction<Webflow["removeWebhook"]>;
+    }
+  }
+}
+
+export = Webflow;
+
+type OmitFirstArgOfFunction<Fn> = Fn extends (
+  x: any,
+  ...args: infer Args
+) => infer R
+  ? (...args: Args) => R
+  : never;
+
+type OmitPropertyFromFirstArgOfFunction<Fn, P extends string> = Fn extends (
+  x: infer A,
+  ...args: infer Args
+) => infer R
+  ? (x: Omit<A, P>, ...args: Args) => R
+  : never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webflow-api",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "SDK for the Webflow CMS API",
   "main": "dist/index.js",
   "jsnext:main": "src/index.js",
@@ -9,11 +9,13 @@
     "type": "git"
   },
   "license": "MIT",
+  "types": "index.d.ts",
   "files": [
     "dist",
     "src",
     "LICENSE",
-    "yarn.lock"
+    "yarn.lock",
+    "index.d.ts"
   ],
   "scripts": {
     "build": "BABEL_ENV=production babel --out-dir dist src/",
@@ -25,29 +27,25 @@
     "watch:test": "npm run test -- --watch"
   },
   "devDependencies": {
-    "ava": "^0.16.0",
-    "babel-cli": "^6.18.0",
-    "babel-core": "^6.18.2",
-    "babel-eslint": "^7.1.0",
-    "babel-plugin-add-module-exports": "^0.2.1",
-    "babel-preset-es2015": "^6.18.0",
-    "babel-preset-stage-1": "^6.16.0",
-    "babel-register": "^6.18.0",
-    "eslint": "^3.10.1",
-    "eslint-config-airbnb-base": "^10.0.1",
-    "eslint-plugin-import": "^2.2.0",
+    "@babel/cli": "^7.17.6",
+    "@babel/core": "^7.17.8",
+    "@babel/preset-env": "^7.16.11",
+    "@babel/register": "^7.17.7",
+    "ava": "^4.1.0",
+    "es6-error": "^4.0.0",
+    "eslint": "^8.12.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-plugin-import": "^2.25.2",
     "nock": "^13.0.7",
-    "nyc": "^9.0.1"
+    "nyc": "^15.1.0"
   },
   "dependencies": {
-    "es6-error": "^4.0.0",
     "isomorphic-fetch": "^3.0.0",
     "qs": "^6.3.0"
   },
   "ava": {
     "require": [
-      "babel-register"
-    ],
-    "babel": "inherit"
+      "@babel/register"
+    ]
   }
 }

package/src/Webflow.js

@@ -179,7 +179,7 @@ export default class Webflow {
 
   item({ collectionId, itemId }, query = {}) {
     if (!collectionId) return Promise.reject(buildRequiredArgError('collectionId'));
-    if (!itemId) return Promise.reject(buildRequiredArgError('siteId'));
+    if (!itemId) return Promise.reject(buildRequiredArgError('itemId'));
 
     return this.get(`/collections/${collectionId}/items/${itemId}`, query).then(
       res => this.responseWrapper.item(res.items[0], collectionId),

package/src/index.js

@@ -1,2 +1,2 @@
-module.exports = require('./Webflow');
-module.exports.WebflowError = require('./WebflowError').default;
+module.exports = require("./Webflow").default;
+module.exports.WebflowError = require("./WebflowError").default;