contentful-management 12.0.0-beta.1 → 12.0.0-beta.3

package/dist/cjs/constants/editor-interface-defaults/sidebar-defaults.cjs

@@ -0,0 +1,71 @@
+'use strict';
+
+var types = require('./types.js');
+
+const SidebarWidgetTypes = {
+    USERS: 'users-widget',
+    CONTENT_PREVIEW: 'content-preview-widget',
+    TRANSLATION: 'translation-widget',
+    INCOMING_LINKS: 'incoming-links-widget',
+    PUBLICATION: 'publication-widget',
+    RELEASES: 'releases-widget',
+    VERSIONS: 'versions-widget',
+    INFO_PANEL: 'info-panel',
+    JOBS: 'jobs-widget',
+    COMMENTS_PANEL: 'comments-panel',
+};
+const Publication = {
+    widgetId: SidebarWidgetTypes.PUBLICATION,
+    widgetNamespace: types.WidgetNamespace.SIDEBAR_BUILTIN,
+    name: 'Publish & Status',
+    description: 'Built-in - View entry status, publish, etc.',
+};
+const Releases = {
+    widgetId: SidebarWidgetTypes.RELEASES,
+    widgetNamespace: types.WidgetNamespace.SIDEBAR_BUILTIN,
+    name: 'Release',
+    description: 'Built-in - View release, add to it, etc.',
+};
+const ContentPreview = {
+    widgetId: SidebarWidgetTypes.CONTENT_PREVIEW,
+    widgetNamespace: types.WidgetNamespace.SIDEBAR_BUILTIN,
+    name: 'Preview',
+    description: 'Built-in - Displays preview functionality.',
+};
+const Links = {
+    widgetId: SidebarWidgetTypes.INCOMING_LINKS,
+    widgetNamespace: types.WidgetNamespace.SIDEBAR_BUILTIN,
+    name: 'Links',
+    description: 'Built-in - Shows where an entry is linked.',
+};
+const Translation = {
+    widgetId: SidebarWidgetTypes.TRANSLATION,
+    widgetNamespace: types.WidgetNamespace.SIDEBAR_BUILTIN,
+    name: 'Translation',
+    description: 'Built-in - Manage which translations are visible.',
+};
+const Versions = {
+    widgetId: SidebarWidgetTypes.VERSIONS,
+    widgetNamespace: types.WidgetNamespace.SIDEBAR_BUILTIN,
+    name: 'Versions',
+    description: 'Built-in - View previously published versions. Available only for master environment.',
+};
+const Users = {
+    widgetId: SidebarWidgetTypes.USERS,
+    widgetNamespace: types.WidgetNamespace.SIDEBAR_BUILTIN,
+    name: 'Users',
+    description: 'Built-in - Displays users on the same entry.',
+};
+const SidebarEntryConfiguration = [
+    Publication,
+    Releases,
+    ContentPreview,
+    Links,
+    Translation,
+    Versions,
+    Users,
+];
+const SidebarAssetConfiguration = [Publication, Releases, Links, Translation, Users];
+
+exports.SidebarAssetConfiguration = SidebarAssetConfiguration;
+exports.SidebarEntryConfiguration = SidebarEntryConfiguration;

package/dist/cjs/constants/editor-interface-defaults/types.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+exports.WidgetNamespace = void 0;
+(function (WidgetNamespace) {
+    WidgetNamespace["BUILTIN"] = "builtin";
+    WidgetNamespace["EXTENSION"] = "extension";
+    WidgetNamespace["SIDEBAR_BUILTIN"] = "sidebar-builtin";
+    WidgetNamespace["APP"] = "app";
+    WidgetNamespace["EDITOR_BUILTIN"] = "editor-builtin";
+})(exports.WidgetNamespace || (exports.WidgetNamespace = {}));
+const DEFAULT_EDITOR_ID = 'default-editor';
+/**
+ * @private
+ */
+const in_ = (key, object) => key in object;
+
+exports.DEFAULT_EDITOR_ID = DEFAULT_EDITOR_ID;
+exports.in_ = in_;

package/dist/cjs/create-adapter.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var restAdapter = require('./adapters/REST/rest-adapter.js');
+
+/**
+ * @packageDocumentation
+ * @hidden
+ */
+/**
+ * @private
+ */
+function createAdapter(params) {
+    if ('apiAdapter' in params) {
+        return params.apiAdapter;
+    }
+    else {
+        return new restAdapter.RestAdapter(params);
+    }
+}
+
+exports.createAdapter = createAdapter;

package/dist/cjs/create-app-definition-api.cjs

@@ -0,0 +1,254 @@
+'use strict';
+
+var index = require('./entities/index.js');
+var appDefinition = require('./entities/app-definition.js');
+
+/**
+ * @private
+ */
+function createAppDefinitionApi(makeRequest) {
+    const { wrapAppBundle, wrapAppBundleCollection } = index.appBundle;
+    const { wrapResourceProvider } = index.resourceProvider;
+    const getParams = (data) => ({
+        appDefinitionId: data.sys.id,
+        organizationId: data.sys.organization.sys.id,
+    });
+    return {
+        /**
+         * Sends an update to the server with any changes made to the object's properties
+         * @return Object returned from the server with updated changes.
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         *
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         *
+         * client.getOrganization('<org_id>')
+         * .then((org) => org.getAppDefinition('<app_def_id>'))
+         * .then((appDefinition) => {
+         *   appDefinition.name = 'New App Definition name'
+         *   return appDefinition.update()
+         * })
+         * .then((appDefinition) => console.log(`App Definition ${appDefinition.sys.id} updated.`))
+         * .catch(console.error)
+         * ```
+         */
+        update: function update() {
+            const data = this.toPlainObject();
+            return makeRequest({
+                entityType: 'AppDefinition',
+                action: 'update',
+                params: getParams(data),
+                headers: {},
+                payload: data,
+            }).then((data) => appDefinition.wrapAppDefinition(makeRequest, data));
+        },
+        /**
+         * Deletes this object on the server.
+         * @return Promise for the deletion. It contains no data, but the Promise error case should be handled.
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         *
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         *
+         * client.getOrganization('<org_id>')
+         * .then((org) => org.getAppDefinition('<app_def_id>'))
+         * .then((appDefinition) => appDefinition.delete())
+         * .then(() => console.log(`App Definition deleted.`))
+         * .catch(console.error)
+         * ```
+         */
+        delete: function del() {
+            const data = this.toPlainObject();
+            return makeRequest({
+                entityType: 'AppDefinition',
+                action: 'delete',
+                params: getParams(data),
+            });
+        },
+        /**
+         * Gets an app bundle
+         * @param id - AppBundle ID
+         * @return Promise for an AppBundle
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         *
+         * client.getOrganization('<org_id>')
+         * .then((org) => org.getAppDefinition('<app_def_id>'))
+         * .then((appDefinition) => appDefinition.getAppBundle('<app_upload_id>'))
+         * .then((appBundle) => console.log(appBundle))
+         * .catch(console.error)
+         * ```
+         */
+        getAppBundle(id) {
+            const raw = this.toPlainObject();
+            return makeRequest({
+                entityType: 'AppBundle',
+                action: 'get',
+                params: {
+                    appBundleId: id,
+                    appDefinitionId: raw.sys.id,
+                    organizationId: raw.sys.organization.sys.id,
+                },
+            }).then((data) => wrapAppBundle(makeRequest, data));
+        },
+        /**
+         * Gets a collection of AppBundles
+         * @return Promise for a collection of AppBundles
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         *
+         * client.getOrganization('<org_id>')
+         * .then((org) => org.getAppDefinition('<app_def_id>'))
+         * .then((appDefinition) => appDefinition.getAppBundles())
+         * .then((response) => console.log(response.items))
+         * .catch(console.error)
+         * ```
+         */
+        getAppBundles(query = {}) {
+            const raw = this.toPlainObject();
+            return makeRequest({
+                entityType: 'AppBundle',
+                action: 'getMany',
+                params: { organizationId: raw.sys.organization.sys.id, appDefinitionId: raw.sys.id, query },
+            }).then((data) => wrapAppBundleCollection(makeRequest, data));
+        },
+        /**
+         * Creates an app bundle
+         * @param Object representation of the App Bundle to be created
+         * @return Promise for the newly created AppBundle
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         * client.getOrganization('<org_id>')
+         * .then((org) => org.getAppDefinition('<app_def_id>'))
+         * .then((appDefinition) => appDefinition.createAppBundle('<app_upload_id>'))
+         * .then((appBundle) => console.log(appBundle))
+         * .catch(console.error)
+         * ```
+         */
+        createAppBundle(data) {
+            const raw = this.toPlainObject();
+            return makeRequest({
+                entityType: 'AppBundle',
+                action: 'create',
+                params: {
+                    appDefinitionId: raw.sys.id,
+                    organizationId: raw.sys.organization.sys.id,
+                },
+                payload: data,
+            }).then((data) => wrapAppBundle(makeRequest, data));
+        },
+        /**
+         * Gets a list of App Installations across an org for given organization and App Definition
+         * If a spaceId is provided in the query object, it will return the App Installations for that specific space.
+         * @return Promise for the newly created AppBundle
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         * client.getAppDefinition('<organization_id>', '<app_definition_id>')
+         * .then((appDefinition) => appDefinition.getInstallationsForOrg(
+         *   { spaceId: '<space_id>' } // optional
+         * ))
+         * .then((appInstallationsForOrg) => console.log(appInstallationsForOrg.items))
+         * .catch(console.error)
+         * ```
+         */
+        getInstallationsForOrg(query = {}) {
+            const raw = this.toPlainObject();
+            return makeRequest({
+                entityType: 'AppDefinition',
+                action: 'getInstallationsForOrg',
+                params: {
+                    appDefinitionId: raw.sys.id,
+                    organizationId: raw.sys.organization.sys.id,
+                    query,
+                },
+            });
+        },
+        /**
+         * Creates or updates a resource provider
+         * @param data representation of the ResourceProvider
+         * @return Promise for the newly created or updated ResourceProvider
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         *
+         * // You need a valid AppDefinition with an activated AppBundle that has a contentful function configured
+         * client.getOrganization('<org_id>')
+         * .then((org) => org.getAppDefinition('<app_def_id>'))
+         * .then((appDefinition) => appDefinition.upsertResourceProvider({
+         *    sys: {
+         *      id: '<resource_provider_id>'
+         *    },
+         *    type: 'function',
+         *    function: {
+         *      sys: {
+         *        id: '<contentful_function_id>',
+         *        type: 'Link'
+         *        linkType: 'Function'
+         *      }
+         *    }
+         * }))
+         * .then((resourceProvider) => console.log(resourceProvider))
+         * .catch(console.error)
+         * ```
+         */
+        upsertResourceProvider(data) {
+            const raw = this.toPlainObject();
+            return makeRequest({
+                entityType: 'ResourceProvider',
+                action: 'upsert',
+                params: {
+                    appDefinitionId: raw.sys.id,
+                    organizationId: raw.sys.organization.sys.id,
+                },
+                payload: data,
+            }).then((payload) => wrapResourceProvider(makeRequest, payload));
+        },
+        /**
+         * Gets a Resource Provider
+         * @return Promise for a Resource Provider
+         * @example ```javascript
+         * const contentful = require('contentful-management')
+         * const client = contentful.createClient({
+         *   accessToken: '<content_management_api_key>'
+         * })
+         *
+         * client.getOrganization('<org_id>')
+         * .then((org) => org.getAppDefinition('<app_def_id>'))
+         * .then((appDefinition) => appDefinition.getResourceProvider())
+         * .then((resourceProvider) => console.log(resourceProvider))
+         * .catch(console.error)
+         * ```
+         */
+        getResourceProvider() {
+            const raw = this.toPlainObject();
+            return makeRequest({
+                entityType: 'ResourceProvider',
+                action: 'get',
+                params: {
+                    appDefinitionId: raw.sys.id,
+                    organizationId: raw.sys.organization.sys.id,
+                },
+            }).then((payload) => wrapResourceProvider(makeRequest, payload));
+        },
+    };
+}
+
+module.exports = createAppDefinitionApi;