@yam8d/m8-sdk 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @yam8d/m8-sdk
+
+Client SDK for iframe applications that communicate with an M8 host.
+
+## Install
+
+```bash
+npm install @yam8d/m8-sdk
+```
+
+For local development before the package is published:
+
+```bash
+npm install ../yam8d/packages/m8-sdk
+```
+
+## Usage
+
+```ts
+import { createM8Client } from '@yam8d/m8-sdk'
+
+const m8 = await createM8Client()
+
+console.log(m8.state.viewName)
+await m8.sendKeyPress(['play'])
+
+const unsubscribe = m8.onStateChange((state) => {
+  console.log(state.cursorPos)
+})
+
+unsubscribe()
+m8.disconnect()
+```
+
+For React or other environments where top-level `await` is not convenient:
+
+```ts
+import { createM8ClientSync } from '@yam8d/m8-sdk'
+
+const { client, connect } = createM8ClientSync()
+await connect()
+```
+
+The app must run inside the host iframe. Opening it directly in a standalone browser tab cannot establish the SDK handshake.

package/dist/index.js

@@ -0,0 +1,162 @@
+import { ChildHandshake as e, DebugMessenger as t, WindowMessenger as n } from "post-me";
+//#region src/client.ts
+var r = () => ({
+	viewName: null,
+	viewTitle: null,
+	minimapKey: null,
+	cursorPos: null,
+	cursorRect: null,
+	selectionMode: !1,
+	highlightColor: null,
+	titleColor: null,
+	backgroundColor: null,
+	textUnderCursor: null,
+	currentLine: null,
+	deviceModel: null,
+	fontMode: null,
+	systemInfo: null,
+	macroRunning: !1
+}), i = class {
+	constructor(e = {}) {
+		this.connection = null, this.remoteHandle = null, this.localHandle = null, this.stateCallbacks = /* @__PURE__ */ new Set(), this.viewCallbacks = /* @__PURE__ */ new Set(), this.cursorCallbacks = /* @__PURE__ */ new Set(), this.textCallbacks = /* @__PURE__ */ new Set(), this.keyCallbacks = /* @__PURE__ */ new Set(), this._state = r(), this._isConnected = !1, this.config = e;
+	}
+	get state() {
+		return this._state;
+	}
+	get isConnected() {
+		return this._isConnected;
+	}
+	async connect() {
+		if (this.connection) return;
+		let r = new n({
+			localWindow: window,
+			remoteWindow: window.parent,
+			remoteOrigin: "*"
+		});
+		this.config.debug && (r = t(r, (e, ...t) => {
+			console.log("[M8 SDK]", e, ...t);
+		}));
+		let i = await e(r, { ping: async () => "pong" });
+		this.connection = i, this.remoteHandle = i.remoteHandle(), this.localHandle = i.localHandle(), this._isConnected = !0, this.remoteHandle.addEventListener("stateChanged", (e) => {
+			this._state = e, this.stateCallbacks.forEach((t) => {
+				t(e);
+			});
+		}), this.remoteHandle.addEventListener("viewChanged", ({ viewName: e, viewTitle: t }) => {
+			this._state = {
+				...this._state,
+				viewName: e,
+				viewTitle: t
+			}, this.viewCallbacks.forEach((n) => {
+				n(e, t);
+			});
+		}), this.remoteHandle.addEventListener("cursorMoved", ({ pos: e, rect: t, selectionMode: n }) => {
+			this._state = {
+				...this._state,
+				cursorPos: e,
+				cursorRect: t,
+				selectionMode: n
+			}, this.cursorCallbacks.forEach((r) => {
+				r(e, t, n);
+			});
+		}), this.remoteHandle.addEventListener("textUpdated", ({ textUnderCursor: e, currentLine: t }) => {
+			this._state = {
+				...this._state,
+				textUnderCursor: e,
+				currentLine: t
+			}, this.textCallbacks.forEach((n) => {
+				n(e, t);
+			});
+		}), this.remoteHandle.addEventListener("keyPressed", ({ keys: e }) => {
+			this.keyCallbacks.forEach((t) => {
+				t(e);
+			});
+		}), await this.fetchState(), this.localHandle.emit("ready", void 0);
+	}
+	async navigateToView(e) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("navigateToView", e);
+	}
+	async navigateTo(e, t) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("navigateTo", e, t);
+	}
+	async setValueToHex(e) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("setValueToHex", e);
+	}
+	async setValueToInt(e) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("setValueToInt", e);
+	}
+	async setNote(e) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("setNote", e);
+	}
+	async setValueToString(e, t = !0, n = !1) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("setValueToString", e, t, n);
+	}
+	async browseFile(e, t = !0) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("browseFile", e, t);
+	}
+	async sendKeyPress(e) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("sendKeyPress", e);
+	}
+	async sendKeyDown(e) {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("sendKeyDown", e);
+	}
+	async sendKeyUp() {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		return this.remoteHandle.call("sendKeyUp");
+	}
+	getState() {
+		return this._state;
+	}
+	async fetchState() {
+		if (!this.remoteHandle) throw Error("M8 SDK client is not connected");
+		let e = await this.remoteHandle.call("getState");
+		return this._state = e, e;
+	}
+	onStateChange(e) {
+		return this.stateCallbacks.add(e), () => this.stateCallbacks.delete(e);
+	}
+	onViewChange(e) {
+		return this.viewCallbacks.add(e), () => this.viewCallbacks.delete(e);
+	}
+	onCursorMove(e) {
+		return this.cursorCallbacks.add(e), () => this.cursorCallbacks.delete(e);
+	}
+	onTextUpdate(e) {
+		return this.textCallbacks.add(e), () => this.textCallbacks.delete(e);
+	}
+	onKeyPress(e) {
+		return this.keyCallbacks.add(e), () => this.keyCallbacks.delete(e);
+	}
+	disconnect() {
+		this.connection?.close(), this.connection = null, this.remoteHandle = null, this.localHandle = null, this._isConnected = !1, this.stateCallbacks.clear(), this.viewCallbacks.clear(), this.cursorCallbacks.clear(), this.textCallbacks.clear(), this.keyCallbacks.clear();
+	}
+};
+async function a(e = {}) {
+	let t = new i(e);
+	return await t.connect(), t;
+}
+function o(e = {}) {
+	let t = new i(e);
+	return {
+		client: t,
+		connect: async () => {
+			await t.connect();
+		}
+	};
+}
+var s = {
+	createM8Client: a,
+	createM8ClientSync: o
+};
+//#endregion
+export { a as createM8Client, o as createM8ClientSync, s as default };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["// @ts-expect-error - post-me types are incomplete for the generic handshake signatures used here.\nimport { ChildHandshake, DebugMessenger, WindowMessenger } from 'post-me'\n// @ts-expect-error - post-me types are incomplete for the generic handshake signatures used here.\nimport type { Connection, LocalHandle, RemoteHandle } from 'post-me'\nimport type { M8ClientEvents, M8ClientMethods, M8HostEvents, M8HostMethods, M8KeyName, M8SdkConfig, M8State } from './types'\n\nexport type { CursorPos, CursorRect, M8KeyName, M8State, RGB, SystemInfos } from './types'\n\nexport interface M8Client {\n  readonly state: M8State\n  readonly isConnected: boolean\n  navigateToView(viewName: string): Promise<boolean>\n  navigateTo(x: number, y: number): Promise<void>\n  setValueToHex(targetHex: number): Promise<boolean>\n  setValueToInt(targetInt: number): Promise<boolean>\n  setNote(noteString: string): Promise<boolean>\n  setValueToString(targetString: string, exact?: boolean, searchInCurrentLine?: boolean): Promise<boolean>\n  browseFile(targetText: string, exact?: boolean): Promise<boolean>\n  sendKeyPress(keys: M8KeyName[]): Promise<void>\n  sendKeyDown(keys: M8KeyName[]): Promise<void>\n  sendKeyUp(): Promise<void>\n  getState(): M8State\n  fetchState(): Promise<M8State>\n  onStateChange(callback: (state: M8State) => void): () => void\n  onViewChange(callback: (viewName: string | null, viewTitle: string | null) => void): () => void\n  onCursorMove(callback: (pos: M8State['cursorPos'], rect: M8State['cursorRect'], selectionMode: boolean) => void): () => void\n  onTextUpdate(callback: (textUnderCursor: string | null, currentLine: string | null) => void): () => void\n  onKeyPress(callback: (keys: number) => void): () => void\n  disconnect(): void\n}\n\nconst getDefaultState = (): M8State => ({\n  viewName: null,\n  viewTitle: null,\n  minimapKey: null,\n  cursorPos: null,\n  cursorRect: null,\n  selectionMode: false,\n  highlightColor: null,\n  titleColor: null,\n  backgroundColor: null,\n  textUnderCursor: null,\n  currentLine: null,\n  deviceModel: null,\n  fontMode: null,\n  systemInfo: null,\n  macroRunning: false,\n})\n\nclass M8ClientImpl implements M8Client {\n  private connection: Connection<M8ClientMethods, M8HostEvents, M8HostMethods, M8ClientEvents> | null = null\n  private remoteHandle: RemoteHandle<M8HostMethods, M8HostEvents> | null = null\n  private localHandle: LocalHandle<M8ClientMethods, M8ClientEvents> | null = null\n  private readonly stateCallbacks = new Set<(state: M8State) => void>()\n  private readonly viewCallbacks = new Set<(viewName: string | null, viewTitle: string | null) => void>()\n  private readonly cursorCallbacks = new Set<(pos: M8State['cursorPos'], rect: M8State['cursorRect'], selectionMode: boolean) => void>()\n  private readonly textCallbacks = new Set<(textUnderCursor: string | null, currentLine: string | null) => void>()\n  private readonly keyCallbacks = new Set<(keys: number) => void>()\n  private _state: M8State = getDefaultState()\n  private _isConnected = false\n  private readonly config: M8SdkConfig\n\n  constructor(config: M8SdkConfig = {}) {\n    this.config = config\n  }\n\n  get state(): M8State {\n    return this._state\n  }\n\n  get isConnected(): boolean {\n    return this._isConnected\n  }\n\n  async connect(): Promise<void> {\n    if (this.connection) {\n      return\n    }\n\n    let messenger = new WindowMessenger({\n      localWindow: window,\n      remoteWindow: window.parent,\n      remoteOrigin: '*',\n    })\n\n    if (this.config.debug) {\n      messenger = DebugMessenger(messenger, (msg: string, ...args: unknown[]) => {\n        console.log('[M8 SDK]', msg, ...args)\n      })\n    }\n\n    const connection = await ChildHandshake<M8ClientMethods, M8HostEvents, M8HostMethods, M8ClientEvents>(messenger, {\n      ping: async () => 'pong',\n    })\n\n    this.connection = connection\n    this.remoteHandle = connection.remoteHandle()\n    this.localHandle = connection.localHandle()\n    this._isConnected = true\n\n    this.remoteHandle.addEventListener('stateChanged', (state: M8State) => {\n      this._state = state\n      this.stateCallbacks.forEach((cb) => {\n        cb(state)\n      })\n    })\n\n    this.remoteHandle.addEventListener('viewChanged', ({ viewName, viewTitle }: { viewName: string | null; viewTitle: string | null }) => {\n      this._state = { ...this._state, viewName, viewTitle }\n      this.viewCallbacks.forEach((cb) => {\n        cb(viewName, viewTitle)\n      })\n    })\n\n    this.remoteHandle.addEventListener('cursorMoved', ({ pos, rect, selectionMode }: { pos: M8State['cursorPos']; rect: M8State['cursorRect']; selectionMode: boolean }) => {\n      this._state = { ...this._state, cursorPos: pos, cursorRect: rect, selectionMode }\n      this.cursorCallbacks.forEach((cb) => {\n        cb(pos, rect, selectionMode)\n      })\n    })\n\n    this.remoteHandle.addEventListener('textUpdated', ({ textUnderCursor, currentLine }: { textUnderCursor: string | null; currentLine: string | null }) => {\n      this._state = { ...this._state, textUnderCursor, currentLine }\n      this.textCallbacks.forEach((cb) => {\n        cb(textUnderCursor, currentLine)\n      })\n    })\n\n    this.remoteHandle.addEventListener('keyPressed', ({ keys }: { keys: number }) => {\n      this.keyCallbacks.forEach((cb) => {\n        cb(keys)\n      })\n    })\n\n    await this.fetchState()\n    this.localHandle.emit('ready', undefined)\n  }\n\n  async navigateToView(viewName: string): Promise<boolean> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('navigateToView', viewName)\n  }\n\n  async navigateTo(x: number, y: number): Promise<void> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('navigateTo', x, y)\n  }\n\n  async setValueToHex(targetHex: number): Promise<boolean> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('setValueToHex', targetHex)\n  }\n\n  async setValueToInt(targetInt: number): Promise<boolean> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('setValueToInt', targetInt)\n  }\n\n  async setNote(noteString: string): Promise<boolean> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('setNote', noteString)\n  }\n\n  async setValueToString(targetString: string, exact = true, searchInCurrentLine = false): Promise<boolean> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('setValueToString', targetString, exact, searchInCurrentLine)\n  }\n\n  async browseFile(targetText: string, exact = true): Promise<boolean> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('browseFile', targetText, exact)\n  }\n\n  async sendKeyPress(keys: M8KeyName[]): Promise<void> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('sendKeyPress', keys)\n  }\n\n  async sendKeyDown(keys: M8KeyName[]): Promise<void> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('sendKeyDown', keys)\n  }\n\n  async sendKeyUp(): Promise<void> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    return this.remoteHandle.call('sendKeyUp')\n  }\n\n  getState(): M8State {\n    return this._state\n  }\n\n  async fetchState(): Promise<M8State> {\n    if (!this.remoteHandle) throw new Error('M8 SDK client is not connected')\n    const state = await this.remoteHandle.call('getState')\n    this._state = state\n    return state\n  }\n\n  onStateChange(callback: (state: M8State) => void): () => void {\n    this.stateCallbacks.add(callback)\n    return () => this.stateCallbacks.delete(callback)\n  }\n\n  onViewChange(callback: (viewName: string | null, viewTitle: string | null) => void): () => void {\n    this.viewCallbacks.add(callback)\n    return () => this.viewCallbacks.delete(callback)\n  }\n\n  onCursorMove(callback: (pos: M8State['cursorPos'], rect: M8State['cursorRect'], selectionMode: boolean) => void): () => void {\n    this.cursorCallbacks.add(callback)\n    return () => this.cursorCallbacks.delete(callback)\n  }\n\n  onTextUpdate(callback: (textUnderCursor: string | null, currentLine: string | null) => void): () => void {\n    this.textCallbacks.add(callback)\n    return () => this.textCallbacks.delete(callback)\n  }\n\n  onKeyPress(callback: (keys: number) => void): () => void {\n    this.keyCallbacks.add(callback)\n    return () => this.keyCallbacks.delete(callback)\n  }\n\n  disconnect(): void {\n    this.connection?.close()\n    this.connection = null\n    this.remoteHandle = null\n    this.localHandle = null\n    this._isConnected = false\n    this.stateCallbacks.clear()\n    this.viewCallbacks.clear()\n    this.cursorCallbacks.clear()\n    this.textCallbacks.clear()\n    this.keyCallbacks.clear()\n  }\n}\n\nexport async function createM8Client(config: M8SdkConfig = {}): Promise<M8Client> {\n  const client = new M8ClientImpl(config)\n  await client.connect()\n  return client\n}\n\nexport function createM8ClientSync(config: M8SdkConfig = {}): { client: M8Client; connect: () => Promise<void> } {\n  const client = new M8ClientImpl(config)\n  return {\n    client,\n    connect: async () => {\n      await client.connect()\n    },\n  }\n}\n\nexport default {\n  createM8Client,\n  createM8ClientSync,\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@yam8d/m8-sdk",
+  "version": "0.1.0",
+  "description": "Client SDK for iframe applications that communicate with an M8 host.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "types",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "m8",
+    "sdk",
+    "iframe",
+    "postmessage"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "post-me": "^0.4.5"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vite": "^8.0.1"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,115 @@
+export interface CursorPos {
+  x: number
+  y: number
+}
+
+export interface CursorRect {
+  x: number
+  y: number
+  w: number
+  h: number
+}
+
+export interface RGB {
+  r: number
+  g: number
+  b: number
+}
+
+export interface SystemInfos {
+  [key: string]: string | number | boolean | undefined
+}
+
+export interface M8State {
+  viewName: string | null
+  viewTitle: string | null
+  minimapKey: string | null
+  cursorPos: CursorPos | null
+  cursorRect: CursorRect | null
+  selectionMode: boolean
+  highlightColor: RGB | null
+  titleColor: RGB | null
+  backgroundColor: RGB | null
+  textUnderCursor: string | null
+  currentLine: string | null
+  deviceModel: string | null
+  fontMode: number | null
+  systemInfo: SystemInfos | null
+  macroRunning: boolean
+  macroCurrentStep?: number
+  macroSequenceLength?: number
+}
+
+export type M8KeyName = 'left' | 'right' | 'up' | 'down' | 'shift' | 'play' | 'opt' | 'edit'
+
+export interface M8HostMethods {
+  navigateToView(viewName: string): Promise<boolean>
+  navigateTo(x: number, y: number): Promise<void>
+  setValueToHex(targetHex: number): Promise<boolean>
+  setValueToInt(targetInt: number): Promise<boolean>
+  setNote(noteString: string): Promise<boolean>
+  setValueToString(targetString: string, exact?: boolean, searchInCurrentLine?: boolean): Promise<boolean>
+  browseFile(targetText: string, exact?: boolean): Promise<boolean>
+  sendKeyPress(keys: M8KeyName[]): Promise<void>
+  sendKeyDown(keys: M8KeyName[]): Promise<void>
+  sendKeyUp(): Promise<void>
+  getState(): Promise<M8State>
+}
+
+export interface M8ClientMethods {
+  ping(): Promise<string>
+}
+
+export interface M8HostEvents {
+  stateChanged: M8State
+  viewChanged: { viewName: string | null; viewTitle: string | null }
+  cursorMoved: { pos: CursorPos | null; rect: CursorRect | null; selectionMode: boolean }
+  textUpdated: { textUnderCursor: string | null; currentLine: string | null }
+  keyPressed: { keys: number }
+}
+
+export interface M8ClientEvents {
+  ready: undefined
+  error: { message: string }
+}
+
+export interface M8SdkConfig {
+  debug?: boolean
+}
+
+export interface M8Client {
+  readonly state: M8State
+  readonly isConnected: boolean
+  navigateToView(viewName: string): Promise<boolean>
+  navigateTo(x: number, y: number): Promise<void>
+  setValueToHex(targetHex: number): Promise<boolean>
+  setValueToInt(targetInt: number): Promise<boolean>
+  setNote(noteString: string): Promise<boolean>
+  setValueToString(targetString: string, exact?: boolean, searchInCurrentLine?: boolean): Promise<boolean>
+  browseFile(targetText: string, exact?: boolean): Promise<boolean>
+  sendKeyPress(keys: M8KeyName[]): Promise<void>
+  sendKeyDown(keys: M8KeyName[]): Promise<void>
+  sendKeyUp(): Promise<void>
+  getState(): M8State
+  fetchState(): Promise<M8State>
+  onStateChange(callback: (state: M8State) => void): () => void
+  onViewChange(callback: (viewName: string | null, viewTitle: string | null) => void): () => void
+  onCursorMove(callback: (pos: M8State['cursorPos'], rect: M8State['cursorRect'], selectionMode: boolean) => void): () => void
+  onTextUpdate(callback: (textUnderCursor: string | null, currentLine: string | null) => void): () => void
+  onKeyPress(callback: (keys: number) => void): () => void
+  disconnect(): void
+}
+
+export function createM8Client(config?: M8SdkConfig): Promise<M8Client>
+
+export function createM8ClientSync(config?: M8SdkConfig): {
+  client: M8Client
+  connect: () => Promise<void>
+}
+
+declare const m8Sdk: {
+  createM8Client: typeof createM8Client
+  createM8ClientSync: typeof createM8ClientSync
+}
+
+export default m8Sdk