@contentful/react-apps-toolkit 1.2.15 → 1.2.21-alpha.0

package/README.md

@@ -67,6 +67,7 @@ function App() {
 ```
 
 ### useCMA
+> :warning: **DEPRECATED** If you are using App SDK v4.20 or greater use `sdk.cma` instead.
 
 `useCMA` returns an initialized [client for the Contentful Management API](https://www.npmjs.com/package/contentful-management). This can be used immediately to communicate with the environment the app is rendered in. [Contentful Management API docs](/developers/docs/references/content-management-api/).
 
@@ -107,13 +108,33 @@ If used in the [entry sidebar location](/developers/docs/extensibility/app-frame
 
 Usage:
 
+Field component:
+```tsx
+import { SDKProvider, useFieldValue } from '@contentful/react-apps-toolkit';
+
+function FieldComponentUsingFieldValue() {
+  const [localizedValue, setLocalizedValue] = useFieldValue(sdk.field.id, sdk.field.locale); // specifies the current field and locale
+
+  return <input value={localizedValue} onChange={(e) => setLocalizedValue(e.target.value)} />;
+}
+
+function App() {
+  return (
+    <SDKProvider>
+      <FieldComponentUsingFieldValue />
+    </SDKProvider>
+  );
+}
+```
+
+Sidebar or Entry Editor component:
 ```tsx
 import { SDKProvider, useFieldValue } from '@contentful/react-apps-toolkit';
 
 function ComponentUsingFieldValue() {
-  const [value, setValue] = useFieldValue('slug', 'en-US');
+  const [defaultValue, setDefaultValue] = useFieldValue('slug', sdk.locales.default); // specifies the "slug" field and the environment's default locale
 
-  return <input value={value} onChange={(e) => setValue(e.target.value)} />;
+  return <input value={defaultValue} onChange={(e) => setDefaultValue(e.target.value)} />;
 }
 
 function App() {

package/dist/SDKProvider.js

@@ -25,7 +25,7 @@ var SDKProvider = function (props) {
     var _a = (0, react_1.useState)(), sdk = _a[0], setSDK = _a[1];
     (0, react_1.useEffect)(function () {
         var timeout = window.setTimeout(function () {
-            console.warn("Your app is taking longer than expected to initialize. If you think this is an error with Contentful's App SDK, let us know: https://github.com/contentful/ui-extensions-sdk/issues");
+            console.warn("Your app is taking longer than expected to initialize. If you think this is an error with Contentful's App SDK, let us know: https://github.com/contentful/ui-extensions-sdk/issues.");
         }, DELAY_TIMEOUT);
         (0, app_sdk_1.init)(function (sdk) {
             setSDK(sdk);

package/dist/useCMA.d.ts

@@ -2,6 +2,8 @@ import { PlainClientAPI } from 'contentful-management';
 import type { CMAClient } from '@contentful/app-sdk';
 type UseCMAReturnValue = (CMAClient extends never ? true : false) extends false ? CMAClient : PlainClientAPI;
 /**
+ * @deprecated if on App SDK v4.20 or greater use `sdk.cma` instead.
+ *
  * React hook returning a CMA plain client instance.
  * Must be used in the `SDKProvider` component. Will throw error, if called outside of `SDKProvider`.
  */

package/dist/useCMA.js

@@ -5,6 +5,8 @@ var contentful_management_1 = require("contentful-management");
 var react_1 = require("react");
 var useSDK_1 = require("./useSDK");
 /**
+ * @deprecated if on App SDK v4.20 or greater use `sdk.cma` instead.
+ *
  * React hook returning a CMA plain client instance.
  * Must be used in the `SDKProvider` component. Will throw error, if called outside of `SDKProvider`.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/react-apps-toolkit",
-  "version": "1.2.15",
+  "version": "1.2.21-alpha.0",
   "description": "Toolkit for building a Contentful app in React",
   "keywords": [],
   "author": "Contentful GmbH",
@@ -47,10 +47,11 @@
     "typescript": "4.9.5"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://npm.pkg.github.com/"
   },
   "dependencies": {
     "contentful-management": ">=7.30.0"
   },
-  "gitHead": "d2dac61d0116ef9df6fc95e4a4cb14bafc679378"
+  "gitHead": "83eea204b666977602cb680d5e5913864aa6dcc1"
 }