@contentful/react-apps-toolkit 0.3.0 → 0.4.2

package/README.md

@@ -20,6 +20,14 @@ yarn add @contentful/react-apps-toolkit
 
 The following hooks and utilities are exported from the package: Nothing
 
+#### SDKProvider
+
+Wrapper component, which makes the Apps SDK available to children via React Context. To use any of the hooks contained in this package, an application must be wrapped in the SDK provider, as all hooks depend on the Apps SDK.
+
+#### useCMA
+
+Returns an initialized client for the Contentful Management API, which can immediately be used to communicate with the rest of your Contentful space. [Contentful Management API docs](https://www.contentful.com/developers/docs/references/content-management-api/).
+
 ### Resources
 
 - [Create Contentful App](https://www.contentful.com/developers/docs/extensibility/app-framework/create-contentful-app/)

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './useSDK';
 export * from './SDKProvider';
+export * from './useCMA';

package/dist/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./useSDK"), exports);
 __exportStar(require("./SDKProvider"), exports);
+__exportStar(require("./useCMA"), exports);

package/dist/useCMA.d.ts

@@ -0,0 +1,6 @@
+import { PlainClientAPI } from 'contentful-management';
+/**
+ * React hook returning a CMA plain client instance.
+ * Must be used in the `SDKProvider` component. Will throw error, if called outside of `SDKProvider`.
+ */
+export declare function useCMA(): PlainClientAPI | undefined;

package/dist/useCMA.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCMA = void 0;
+var contentful_management_1 = require("contentful-management");
+var react_1 = require("react");
+var useSDK_1 = require("./useSDK");
+/**
+ * React hook returning a CMA plain client instance.
+ * Must be used in the `SDKProvider` component. Will throw error, if called outside of `SDKProvider`.
+ */
+function useCMA() {
+    var sdk = (0, useSDK_1.useSDK)();
+    var cma = (0, react_1.useMemo)(function () {
+        return (0, contentful_management_1.createClient)({ apiAdapter: sdk.cmaAdapter }, {
+            type: 'plain',
+            defaults: {
+                environmentId: sdk.ids.environment,
+                spaceId: sdk.ids.space,
+            },
+        });
+    }, [sdk]);
+    return cma;
+}
+exports.useCMA = useCMA;

package/dist/useCMA.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/useCMA.spec.js

@@ -0,0 +1,36 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var react_hooks_1 = require("@testing-library/react-hooks");
+var useCMA_1 = require("./useCMA");
+var mockedCma = 'mocked-cma';
+var mockedSdk = {
+    cmaAdapter: 'placholder',
+    ids: {
+        environment: 'placeholder',
+        space: 'placeholder',
+    },
+};
+jest.mock('./useSDK', function () { return (__assign(__assign({}, jest.requireActual('./useSDK')), { useSDK: function () { return mockedSdk; } })); });
+jest.mock('./SDKProvider', function () { return ({
+    SDKContext: {},
+}); });
+jest.mock('contentful-management', function () {
+    return __assign(__assign({}, jest.requireActual('contentful-management')), { createClient: function () { return mockedCma; } });
+});
+describe('useCMA', function () {
+    test('should return cma client', function () {
+        var result = (0, react_hooks_1.renderHook)(function () { return (0, useCMA_1.useCMA)(); }).result;
+        expect(result.current).toBe(mockedCma);
+    });
+});

package/dist/useSDK.js

@@ -11,7 +11,7 @@ var SDKProvider_1 = require("./SDKProvider");
 function useSDK() {
     var sdk = (0, react_1.useContext)(SDKProvider_1.SDKContext).sdk;
     if (!sdk) {
-        throw new Error('SDKContext not found. Make sure the useSDK hook is used inside the SDKProvider');
+        throw new Error('SDKContext not found. Make sure this hook is used inside the SDKProvider');
     }
     return sdk;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/react-apps-toolkit",
-  "version": "0.3.0",
+  "version": "0.4.2",
   "description": "Toolkit for building a Contentful app in React",
   "keywords": [],
   "author": "Contentful GmbH",
@@ -39,6 +39,7 @@
     "@types/jest": "^27.4.0",
     "@types/react": "^17.0.39",
     "jest": "^27.5.0",
+    "react": "^17.0.2",
     "ts-jest": "^27.1.3",
     "typescript": "^4.5.5"
   },
@@ -46,7 +47,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@contentful/app-sdk": "^4.0.0"
+    "@contentful/app-sdk": "^4.0.0",
+    "contentful-management": ">=7.30.0"
   },
-  "gitHead": "8de11c51bc4d238157b026236e1b5bf62e227058"
+  "gitHead": "07fa91924433749cd6946874600837e42b25e2d5"
 }