@emailmaker/extensions-sandbox 1.1.85-dev.10 → 1.1.85-dev.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +16 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -878,6 +878,22 @@ App.registerPlugin('MyPluginSandbox', MyPluginSandbox);
878
878
 
879
879
  > ⚠️ Sandbox работает в изолированном iframe. React-компоненты здесь недоступны — только нативный DOM.
880
880
 
881
+ ### Скрипт живёт одно письмо
882
+
883
+ Документ холста пересоздаётся на каждое письмо: скрипт песочницы выполняется заново, и ничего из
884
+ прошлого письма в нём не остаётся. `handle.ready` — обещание, оно разрешается один раз, для первого
885
+ холста. Чтобы узнавать о готовности каждый раз, подпишитесь на `onReady`:
886
+
887
+ ```ts
888
+ const script = sandboxApi.registerSandboxScript(url);
889
+ script.onReady(() => {
890
+ messageService.send('my-plugin:settings', mySettings);
891
+ });
892
+ ```
893
+
894
+ Последнее, что вы отправили скрипту после его готовности, редактор повторяет в новый холст сам —
895
+ по каждому ключу сообщения. `onReady` нужен для состояния, которое вы считаете заново.
896
+
881
897
 
882
898
  ### MessageService (внутри sandbox)
883
899
 
package/package.json CHANGED
@@ -5,5 +5,5 @@
5
5
  "main": "index.js",
6
6
  "types": "types.d.ts",
7
7
  "name": "@emailmaker/extensions-sandbox",
8
- "version": "1.1.85-dev.10"
8
+ "version": "1.1.85-dev.11"
9
9
  }