@medway-ui/native 1.2.0 → 1.3.0

package/lib/commonjs/editor/editorHtml.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EDITOR_HTML","exports"],"sourceRoot":"../../../src","sources":["editor/editorHtml.generated.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,MAAMA,WAAmB,GAAAC,OAAA,CAAAD,WAAA,GAAG,i5haAAi5ha","ignoreList":[]}

package/lib/commonjs/editor/index.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "EDITOR_PROTOCOL_VERSION", {
+  enumerable: true,
+  get: function () {
+    return _protocol.EDITOR_PROTOCOL_VERSION;
+  }
+});
+Object.defineProperty(exports, "EDITOR_RECEIVE_HANDLER", {
+  enumerable: true,
+  get: function () {
+    return _protocol.EDITOR_RECEIVE_HANDLER;
+  }
+});
+Object.defineProperty(exports, "NoteEditor", {
+  enumerable: true,
+  get: function () {
+    return _NoteEditor.default;
+  }
+});
+Object.defineProperty(exports, "isEditorMessage", {
+  enumerable: true,
+  get: function () {
+    return _protocol.isEditorMessage;
+  }
+});
+var _NoteEditor = _interopRequireDefault(require("./NoteEditor.js"));
+var _protocol = require("./protocol.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=index.js.map

package/lib/commonjs/editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_NoteEditor","_interopRequireDefault","require","_protocol","e","__esModule","default"],"sourceRoot":"../../../src","sources":["editor/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,WAAA,GAAAC,sBAAA,CAAAC,OAAA;AAIA,IAAAC,SAAA,GAAAD,OAAA;AAIoB,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/lib/commonjs/editor/protocol.js

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isEditorMessage = exports.EDITOR_RECEIVE_HANDLER = exports.EDITOR_PROTOCOL_VERSION = void 0;
+/**
+ * Transport between React Native and the Tiptap editor inside the WebView. Both
+ * sides compile against this file — the bundle imports it through the `@/`
+ * alias in `editor-bundle/vite.config.ts`.
+ *
+ * Invariants:
+ * - The document never crosses the bridge on keystrokes: the editor emits
+ *   `change` with a revision counter, and the native side asks with
+ *   `getDocument`.
+ * - Every message is validated on arrival (`isEditorMessage`: envelope plus the
+ *   required fields of its variant) — the WebView renders student content, so
+ *   its output is untrusted input. Documents get a second pass through
+ *   `normalizeDocument` before reaching the host.
+ */
+
+/**
+ * Bumped whenever the message shapes below change. The native side refuses to
+ * talk to a bundle that reports a different version, which turns a stale
+ * `editorHtml.generated.ts` into a clear error instead of silent breakage.
+ */
+const EDITOR_PROTOCOL_VERSION = exports.EDITOR_PROTOCOL_VERSION = 3;
+
+/** Name of the global the WebView bundle installs to receive native messages. */
+const EDITOR_RECEIVE_HANDLER = exports.EDITOR_RECEIVE_HANDLER = '__medwayNoteEditorReceive';
+const isRecord = value => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isString = value => typeof value === 'string';
+
+/** Rejects `NaN` and the infinities, which `JSON.parse` can still produce. */
+const isFiniteNumber = value => typeof value === 'number' && Number.isFinite(value);
+
+/*
+ * `Record<Union, …>` rather than an array so it is exhaustive: adding a variant
+ * to `EditorToNativeMessage` without listing it here stops compiling, instead
+ * of letting `isEditorMessage` reject the new type at runtime — which would
+ * look like the message never arrived, not like a build error.
+ *
+ * Each entry checks the fields its own variant declares, so narrowing to the
+ * union is backed by the payload and not by `type` alone: a `document` without
+ * `doc`/`requestId`, or a `ready` without `protocol`, is rejected here instead
+ * of blowing up at the use site.
+ *
+ * `state`, `slash` and `doc` are checked as objects rather than field by field:
+ * their shapes belong to `@medway-ui/notes-core` and are validated there — for
+ * `doc`, by the `normalizeDocument` pass the native side runs before handing a
+ * document to the host.
+ */
+const EDITOR_MESSAGE_VALIDATORS = {
+  ready: message => isFiniteNumber(message.protocol),
+  state: message => isRecord(message.state),
+  change: message => isFiniteNumber(message.revision),
+  document: message => isString(message.requestId) && isFiniteNumber(message.revision) && isRecord(message.doc),
+  slash: message => isRecord(message.slash),
+  resize: message => isFiniteNumber(message.height),
+  linkPress: message => isString(message.href),
+  backspaceAtDocStart: () => true,
+  imageRemoved: message => isString(message.src),
+  error: message => isString(message.message)
+};
+
+/**
+ * Guard for anything arriving from the WebView: checks the envelope *and* the
+ * required fields of the variant its `type` names. Establishes the shape, not
+ * the contents — a `document` payload's `doc` still goes through
+ * `normalizeDocument` before the native side hands it to the host.
+ */
+const isEditorMessage = value => {
+  if (!isRecord(value)) return false;
+  const {
+    type
+  } = value;
+  if (typeof type !== 'string') return false;
+
+  // `hasOwnProperty`, not `in`: `in` walks the prototype chain, so a `type` of
+  // `"toString"` or `"constructor"` matches any plain object literal.
+  // `Object.hasOwn` would read better but is ES2022 and `lib` here is ES2020.
+  if (!Object.prototype.hasOwnProperty.call(EDITOR_MESSAGE_VALIDATORS, type)) {
+    return false;
+  }
+  return EDITOR_MESSAGE_VALIDATORS[type](value);
+};
+exports.isEditorMessage = isEditorMessage;
+//# sourceMappingURL=protocol.js.map

package/lib/commonjs/editor/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EDITOR_PROTOCOL_VERSION","exports","EDITOR_RECEIVE_HANDLER","isRecord","value","Array","isArray","isString","isFiniteNumber","Number","isFinite","EDITOR_MESSAGE_VALIDATORS","ready","message","protocol","state","change","revision","document","requestId","doc","slash","resize","height","linkPress","href","backspaceAtDocStart","imageRemoved","src","error","isEditorMessage","type","Object","prototype","hasOwnProperty","call"],"sourceRoot":"../../../src","sources":["editor/protocol.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA;AACA;AACA;AACA;AACA;AACO,MAAMA,uBAAuB,GAAAC,OAAA,CAAAD,uBAAA,GAAG,CAAC;;AAExC;AACO,MAAME,sBAAsB,GAAAD,OAAA,CAAAC,sBAAA,GAAG,2BAA2B;AAmFjE,MAAMC,QAAQ,GAAIC,KAAc,IAC9B,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI,IAAI,CAACC,KAAK,CAACC,OAAO,CAACF,KAAK,CAAC;AAEtE,MAAMG,QAAQ,GAAIH,KAAc,IAAsB,OAAOA,KAAK,KAAK,QAAQ;;AAE/E;AACA,MAAMI,cAAc,GAAIJ,KAAc,IACpC,OAAOA,KAAK,KAAK,QAAQ,IAAIK,MAAM,CAACC,QAAQ,CAACN,KAAK,CAAC;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMO,yBAGL,GAAG;EACFC,KAAK,EAAGC,OAAO,IAAKL,cAAc,CAACK,OAAO,CAACC,QAAQ,CAAC;EACpDC,KAAK,EAAGF,OAAO,IAAKV,QAAQ,CAACU,OAAO,CAACE,KAAK,CAAC;EAC3CC,MAAM,EAAGH,OAAO,IAAKL,cAAc,CAACK,OAAO,CAACI,QAAQ,CAAC;EACrDC,QAAQ,EAAGL,OAAO,IAChBN,QAAQ,CAACM,OAAO,CAACM,SAAS,CAAC,IAC3BX,cAAc,CAACK,OAAO,CAACI,QAAQ,CAAC,IAChCd,QAAQ,CAACU,OAAO,CAACO,GAAG,CAAC;EACvBC,KAAK,EAAGR,OAAO,IAAKV,QAAQ,CAACU,OAAO,CAACQ,KAAK,CAAC;EAC3CC,MAAM,EAAGT,OAAO,IAAKL,cAAc,CAACK,OAAO,CAACU,MAAM,CAAC;EACnDC,SAAS,EAAGX,OAAO,IAAKN,QAAQ,CAACM,OAAO,CAACY,IAAI,CAAC;EAC9CC,mBAAmB,EAAEA,CAAA,KAAM,IAAI;EAC/BC,YAAY,EAAGd,OAAO,IAAKN,QAAQ,CAACM,OAAO,CAACe,GAAG,CAAC;EAChDC,KAAK,EAAGhB,OAAO,IAAKN,QAAQ,CAACM,OAAO,CAACA,OAAO;AAC9C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,MAAMiB,eAAe,GAC1B1B,KAAc,IACqB;EACnC,IAAI,CAACD,QAAQ,CAACC,KAAK,CAAC,EAAE,OAAO,KAAK;EAElC,MAAM;IAAE2B;EAAK,CAAC,GAAG3B,KAAK;EACtB,IAAI,OAAO2B,IAAI,KAAK,QAAQ,EAAE,OAAO,KAAK;;EAE1C;EACA;EACA;EACA,IAAI,CAACC,MAAM,CAACC,SAAS,CAACC,cAAc,CAACC,IAAI,CAACxB,yBAAyB,EAAEoB,IAAI,CAAC,EAAE;IAC1E,OAAO,KAAK;EACd;EAEA,OAAOpB,yBAAyB,CAACoB,IAAI,CAAkC,CACrE3B,KACF,CAAC;AACH,CAAC;AAACH,OAAA,CAAA6B,eAAA,GAAAA,eAAA","ignoreList":[]}