mcbe-ipc 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OmniacDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# MCBE-IPC 📡
+
+An IPC[^1] system for MCBE Script API projects
+
+[^1]: Inter-Pack Communication
+
+## Dependencies
+
+| Name | Version |
+|---|---|
+| `@minecraft/server` | Any |
+
+## Installation
+**JavaScript**
+1. Download `ipc.js` and `ipc.d.ts` from the latest [release](https://github.com/OmniacDev/MCBE-IPC/releases/latest)
+2. Copy the files into your project
+
+**TypeScript**
+1. Download `ipc.ts` from the latest [release](https://github.com/OmniacDev/MCBE-IPC/releases/latest)
+2. Copy file into your project
+
+##  Usage
+
+### Sending & Receiving
+
+`IPC.send()` and `IPC.on()` can be used to send messages or data between packs. 
+
+_Pack 1_
+```js
+import IPC from 'ipc.js'
+
+IPC.on('message_channel', (args) => {
+  console.log(`Message: ${args}`)
+})
+
+IPC.on('data_channel', (args) => {
+  console.log(`Data: ${args.example_bool}, ${args.example_number}`)
+})
+```
+_Pack 2_
+```js
+import IPC from 'ipc.js'
+
+IPC.send('message_channel', 'Example Message')
+
+IPC.send('data_channel', { example_number: 100, example_bool: true })
+```
+_Console Output_
+```
+Message: Example Message
+Data: true, 100
+```
+
+### Requesting & Serving
+
+`IPC.invoke()` and `IPC.handle()` can be used to request and serve data between packs.
+
+_Pack 1_
+```js
+import IPC from 'ipc.js'
+
+IPC.handle('request_channel', (args) => {
+  switch (args) {
+    case 'status': 
+      return 'inactive'
+    case 'size': 
+      return 100
+  }
+})
+```
+_Pack 2_
+```js
+import IPC from 'ipc.js'
+
+IPC.invoke('request_channel', 'status').then(result => {
+  console.log(`Status: ${result}`)
+})
+
+IPC.invoke('request_channel', 'size').then(result => {
+  console.log(`Size: ${result}`)
+})
+```
+_Console Output_
+```
+Status: inactive
+Size: 100
+```
+
+
+

package/dist/ipc.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * MIT License
+ *
+ * Copyright (c) 2024 OmniacDev
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+declare namespace IPC {
+    type SendTypes = {};
+    type InvokeTypes = {};
+    type HandleTypes = {};
+    export class Connection {
+        private readonly _from;
+        private readonly _to;
+        private readonly _enc;
+        private readonly _terminators;
+        private MAYBE_ENCRYPT;
+        private MAYBE_DECRYPT;
+        get from(): string;
+        get to(): string;
+        constructor(from: string, to: string, encryption: string | false);
+        terminate(notify?: boolean): void;
+        send<T extends any[]>(channel: string, ...args: T): void;
+        invoke<T extends any[], R extends any>(channel: string, ...args: T): Promise<R>;
+        on<T extends any[]>(channel: string, listener: (...args: T) => void): () => void;
+        once<T extends any[]>(channel: string, listener: (...args: T) => void): () => void;
+        handle<T extends any[], R extends any>(channel: string, listener: (...args: T) => R): () => void;
+    }
+    export class ConnectionManager {
+        private readonly _id;
+        private readonly _enc_map;
+        private readonly _con_map;
+        private readonly _enc_force;
+        private MAYBE_ENCRYPT;
+        private MAYBE_DECRYPT;
+        get id(): string;
+        constructor(id: string, force_encryption?: boolean);
+        connect(to: string, encrypted?: boolean, timeout?: number): Promise<Connection>;
+        send<T extends any[]>(channel: string, ...args: T): void;
+        invoke<T extends any[], R extends any>(channel: string, ...args: T): Promise<R>[];
+        on<T extends any[]>(channel: string, listener: (...args: T) => void): () => void;
+        once<T extends any[]>(channel: string, listener: (...args: T) => void): () => void;
+        handle<T extends any[], R extends any>(channel: string, listener: (...args: T) => R): () => void;
+    }
+    /** Sends a message with `args` to `channel` */
+    export function send<C extends keyof SendTypes>(channel: C, ...args: SendTypes[C]): void;
+    /** Sends a message with `args` to `channel` */
+    export function send<T extends any[]>(channel: string, ...args: T): void;
+    /** Sends an `invoke` message through IPC, and expects a result asynchronously. */
+    export function invoke<C extends keyof (HandleTypes & InvokeTypes)>(channel: C, ...args: InvokeTypes[C]): Promise<HandleTypes[C]>;
+    /** Sends an `invoke` message through IPC, and expects a result asynchronously. */
+    export function invoke<T extends any[], R extends any>(channel: string, ...args: T): Promise<R>;
+    /** Listens to `channel`. When a new message arrives, `listener` will be called with `listener(args)`. */
+    export function on<C extends keyof SendTypes>(channel: C, listener: (...args: SendTypes[C]) => void): () => void;
+    /** Listens to `channel`. When a new message arrives, `listener` will be called with `listener(args)`. */
+    export function on<T extends any[]>(channel: string, listener: (...args: T) => void): () => void;
+    /** Listens to `channel` once. When a new message arrives, `listener` will be called with `listener(args)`, and then removed. */
+    export function once<C extends keyof SendTypes>(channel: C, listener: (...args: SendTypes[C]) => void): () => void;
+    /** Listens to `channel` once. When a new message arrives, `listener` will be called with `listener(args)`, and then removed. */
+    export function once<T extends any[]>(channel: string, listener: (...args: T) => void): () => void;
+    /** Adds a handler for an `invoke` IPC. This handler will be called whenever `invoke(channel, ...args)` is called */
+    export function handle<C extends keyof (HandleTypes & InvokeTypes)>(channel: C, listener: (...args: InvokeTypes[C]) => HandleTypes[C]): () => void;
+    /** Adds a handler for an `invoke` IPC. This handler will be called whenever `invoke(channel, ...args)` is called */
+    export function handle<T extends any[], R extends any>(channel: string, listener: (...args: T) => R): () => void;
+    export {};
+}
+export default IPC;
+export declare namespace NET {
+    function emit<T = any>(namespace: string, channel: string, args: T): Generator<void, void, void>;
+    function listen<T = any>(namespace: string, channel: string, callback: (args: T) => Generator<void, void, void>): () => void;
+}

package/dist/ipc.js

@@ -0,0 +1,515 @@
+/**
+ * @license
+ * MIT License
+ *
+ * Copyright (c) 2024 OmniacDev
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { world, system, ScriptEventSource } from '@minecraft/server';
+var IPC;
+(function (IPC) {
+    class Connection {
+        *MAYBE_ENCRYPT(args) {
+            return this._enc !== false ? yield* CRYPTO.encrypt(JSON.stringify(args), this._enc) : args;
+        }
+        *MAYBE_DECRYPT(args) {
+            return this._enc !== false ? JSON.parse(yield* CRYPTO.decrypt(args[1], this._enc)) : args[1];
+        }
+        get from() {
+            return this._from;
+        }
+        get to() {
+            return this._to;
+        }
+        constructor(from, to, encryption) {
+            this._from = from;
+            this._to = to;
+            this._enc = encryption;
+            this._terminators = new Array();
+        }
+        terminate(notify = true) {
+            const $ = this;
+            $._terminators.forEach(terminate => terminate());
+            $._terminators.length = 0;
+            if (notify) {
+                system.runJob(NET.emit('ipc', `${$._to}:terminate`, [$._from]));
+            }
+        }
+        send(channel, ...args) {
+            const $ = this;
+            system.runJob((function* () {
+                const data = yield* $.MAYBE_ENCRYPT(args);
+                yield* NET.emit('ipc', `${$._to}:${channel}:send`, [$._from, data]);
+            })());
+        }
+        invoke(channel, ...args) {
+            const $ = this;
+            system.runJob((function* () {
+                const data = yield* $.MAYBE_ENCRYPT(args);
+                yield* NET.emit('ipc', `${$._to}:${channel}:invoke`, [$._from, data]);
+            })());
+            return new Promise(resolve => {
+                const terminate = NET.listen('ipc', `${$._from}:${channel}:handle`, function* (args) {
+                    if (args[0] === $._to) {
+                        const data = yield* $.MAYBE_DECRYPT(args);
+                        resolve(data);
+                        terminate();
+                    }
+                });
+            });
+        }
+        on(channel, listener) {
+            const $ = this;
+            const terminate = NET.listen('ipc', `${$._from}:${channel}:send`, function* (args) {
+                if (args[0] === $._to) {
+                    const data = yield* $.MAYBE_DECRYPT(args);
+                    listener(...data);
+                }
+            });
+            $._terminators.push(terminate);
+            return terminate;
+        }
+        once(channel, listener) {
+            const $ = this;
+            const terminate = NET.listen('ipc', `${$._from}:${channel}:send`, function* (args) {
+                if (args[0] === $._to) {
+                    const data = yield* $.MAYBE_DECRYPT(args);
+                    listener(...data);
+                    terminate();
+                }
+            });
+            $._terminators.push(terminate);
+            return terminate;
+        }
+        handle(channel, listener) {
+            const $ = this;
+            const terminate = NET.listen('ipc', `${$._from}:${channel}:invoke`, function* (args) {
+                if (args[0] === $._to) {
+                    const data = yield* $.MAYBE_DECRYPT(args);
+                    const result = listener(...data);
+                    const return_data = yield* $.MAYBE_ENCRYPT([result]);
+                    yield* NET.emit('ipc', `${$._to}:${channel}:handle`, [$._from, return_data]);
+                }
+            });
+            $._terminators.push(terminate);
+            return terminate;
+        }
+    }
+    IPC.Connection = Connection;
+    class ConnectionManager {
+        *MAYBE_ENCRYPT(args, encryption) {
+            return encryption !== false ? yield* CRYPTO.encrypt(JSON.stringify(args), encryption) : args;
+        }
+        *MAYBE_DECRYPT(args, encryption) {
+            return encryption !== false ? JSON.parse(yield* CRYPTO.decrypt(args[1], encryption)) : args[1];
+        }
+        get id() {
+            return this._id;
+        }
+        constructor(id, force_encryption = false) {
+            const $ = this;
+            this._id = id;
+            this._enc_map = new Map();
+            this._con_map = new Map();
+            this._enc_force = force_encryption;
+            NET.listen('ipc', `${this._id}:handshake:SYN`, function* (args) {
+                const secret = CRYPTO.make_secret(args[4]);
+                const public_key = yield* CRYPTO.make_public(secret, args[4], args[3]);
+                const enc = args[1] === 1 || $._enc_force ? yield* CRYPTO.make_shared(secret, args[2], args[3]) : false;
+                $._enc_map.set(args[0], enc);
+                yield* NET.emit('ipc', `${args[0]}:handshake:ACK`, [
+                    $._id,
+                    $._enc_force ? 1 : 0,
+                    public_key
+                ]);
+            });
+            NET.listen('ipc', `${this._id}:terminate`, function* (args) {
+                $._enc_map.delete(args[0]);
+            });
+        }
+        connect(to, encrypted = false, timeout = 20) {
+            const $ = this;
+            return new Promise((resolve, reject) => {
+                const con = this._con_map.get(to);
+                if (con !== undefined) {
+                    con.terminate(false);
+                    resolve(con);
+                }
+                else {
+                    const secret = CRYPTO.make_secret();
+                    const enc_flag = encrypted ? 1 : 0;
+                    system.runJob((function* () {
+                        const public_key = yield* CRYPTO.make_public(secret);
+                        yield* NET.emit('ipc', `${to}:handshake:SYN`, [
+                            $._id,
+                            enc_flag,
+                            public_key,
+                            CRYPTO.PRIME,
+                            CRYPTO.MOD
+                        ]);
+                    })());
+                    function clear() {
+                        terminate();
+                        system.clearRun(timeout_handle);
+                    }
+                    const timeout_handle = system.runTimeout(() => {
+                        reject();
+                        clear();
+                    }, timeout);
+                    const terminate = NET.listen('ipc', `${this._id}:handshake:ACK`, function* (args) {
+                        if (args[0] === to) {
+                            const enc = args[1] === 1 || encrypted ? yield* CRYPTO.make_shared(secret, args[2]) : false;
+                            const new_con = new Connection($._id, to, enc);
+                            $._con_map.set(to, new_con);
+                            resolve(new_con);
+                            clear();
+                        }
+                    });
+                }
+            });
+        }
+        send(channel, ...args) {
+            const $ = this;
+            system.runJob((function* () {
+                for (const [key, value] of $._enc_map) {
+                    const data = yield* $.MAYBE_ENCRYPT(args, value);
+                    yield* NET.emit('ipc', `${key}:${channel}:send`, [$._id, data]);
+                }
+            })());
+        }
+        invoke(channel, ...args) {
+            const $ = this;
+            const promises = [];
+            for (const [key, value] of $._enc_map) {
+                system.runJob((function* () {
+                    const data = yield* $.MAYBE_ENCRYPT(args, value);
+                    yield* NET.emit('ipc', `${key}:${channel}:invoke`, [$._id, data]);
+                })());
+                promises.push(new Promise(resolve => {
+                    const terminate = NET.listen('ipc', `${$._id}:${channel}:handle`, function* (args) {
+                        if (args[0] === key) {
+                            const data = yield* $.MAYBE_DECRYPT(args, value);
+                            resolve(data);
+                            terminate();
+                        }
+                    });
+                }));
+            }
+            return promises;
+        }
+        on(channel, listener) {
+            const $ = this;
+            return NET.listen('ipc', `${$._id}:${channel}:send`, function* (args) {
+                const enc = $._enc_map.get(args[0]);
+                if (enc !== undefined) {
+                    const data = yield* $.MAYBE_DECRYPT(args, enc);
+                    listener(...data);
+                }
+            });
+        }
+        once(channel, listener) {
+            const $ = this;
+            const terminate = NET.listen('ipc', `${$._id}:${channel}:send`, function* (args) {
+                const enc = $._enc_map.get(args[0]);
+                if (enc !== undefined) {
+                    const data = yield* $.MAYBE_DECRYPT(args, enc);
+                    listener(...data);
+                    terminate();
+                }
+            });
+            return terminate;
+        }
+        handle(channel, listener) {
+            const $ = this;
+            return NET.listen('ipc', `${$._id}:${channel}:invoke`, function* (args) {
+                const enc = $._enc_map.get(args[0]);
+                if (enc !== undefined) {
+                    const data = yield* $.MAYBE_DECRYPT(args, enc);
+                    const result = listener(...data);
+                    const return_data = yield* $.MAYBE_ENCRYPT([result], enc);
+                    yield* NET.emit('ipc', `${args[0]}:${channel}:handle`, [$._id, return_data]);
+                }
+            });
+        }
+    }
+    IPC.ConnectionManager = ConnectionManager;
+    /** Sends a message with `args` to `channel` */
+    function send(channel, ...args) {
+        system.runJob(NET.emit('ipc', `${channel}:send`, args));
+    }
+    IPC.send = send;
+    function invoke(channel, ...args) {
+        system.runJob(NET.emit('ipc', `${channel}:invoke`, args));
+        return new Promise(resolve => {
+            const terminate = NET.listen('ipc', `${channel}:handle`, function* (args) {
+                resolve(args);
+                terminate();
+            });
+        });
+    }
+    IPC.invoke = invoke;
+    /** Listens to `channel`. When a new message arrives, `listener` will be called with `listener(args)`. */
+    function on(channel, listener) {
+        return NET.listen('ipc', `${channel}:send`, function* (args) {
+            listener(...args);
+        });
+    }
+    IPC.on = on;
+    /** Listens to `channel` once. When a new message arrives, `listener` will be called with `listener(args)`, and then removed. */
+    function once(channel, listener) {
+        const terminate = NET.listen('ipc', `${channel}:send`, function* (args) {
+            listener(...args);
+            terminate();
+        });
+        return terminate;
+    }
+    IPC.once = once;
+    /** Adds a handler for an `invoke` IPC. This handler will be called whenever `invoke(channel, ...args)` is called */
+    function handle(channel, listener) {
+        return NET.listen('ipc', `${channel}:invoke`, function* (args) {
+            const result = listener(...args);
+            yield* NET.emit('ipc', `${channel}:handle`, result);
+        });
+    }
+    IPC.handle = handle;
+})(IPC || (IPC = {}));
+export default IPC;
+var SERDE;
+(function (SERDE) {
+    const INVALID_START_CODES = [48, 49, 50, 51, 52, 53, 54, 55, 56, 57];
+    const INVALID_CODES = [
+        0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30,
+        31, 32, 33, 34, 35, 36, 37, 38, 39, 42, 43, 44, 47, 58, 59, 60, 61, 62, 63, 64, 91, 92, 93, 94, 96, 123, 124, 125,
+        126, 127
+    ];
+    const sequence_regex = /\?[0-9a-zA-Z.\-]{2}|[^?]+/g;
+    const encoded_regex = /^\?[0-9a-zA-Z.\-]{2}$/;
+    const BASE64 = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-';
+    function* b64_encode(char) {
+        let encoded = '';
+        for (let code = char.charCodeAt(0); code > 0; code = Math.floor(code / 64)) {
+            encoded = BASE64[code % 64] + encoded;
+            yield;
+        }
+        return encoded;
+    }
+    function* b64_decode(enc) {
+        let code = 0;
+        for (let i = 0; i < enc.length; i++) {
+            code += 64 ** (enc.length - 1 - i) * BASE64.indexOf(enc[i]);
+            yield;
+        }
+        return String.fromCharCode(code);
+    }
+    function* encode(str) {
+        let result = '';
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charAt(i);
+            const char_code = char.charCodeAt(0);
+            if ((i === 0 && INVALID_START_CODES.includes(char_code)) || INVALID_CODES.includes(char_code)) {
+                result += `?${(yield* b64_encode(char)).padStart(2, '0')}`;
+            }
+            else {
+                result += char;
+            }
+            yield;
+        }
+        return result;
+    }
+    SERDE.encode = encode;
+    function* decode(str) {
+        let result = '';
+        const seqs = str.match(sequence_regex) ?? [];
+        for (let i = 0; i < seqs.length; i++) {
+            const seq = seqs[i];
+            if (seq.startsWith('?') && encoded_regex.test(seq))
+                result += yield* b64_decode(seq.slice(1));
+            else {
+                result += seq;
+            }
+            yield;
+        }
+        return result;
+    }
+    SERDE.decode = decode;
+})(SERDE || (SERDE = {}));
+var CRYPTO;
+(function (CRYPTO) {
+    CRYPTO.PRIME = 19893121;
+    CRYPTO.MOD = 341;
+    const to_HEX = (n) => n.toString(16).toUpperCase();
+    const to_NUM = (h) => parseInt(h, 16);
+    function* mod_exp(base, exp, mod) {
+        let result = 1;
+        let b = base % mod;
+        for (let e = exp; e > 0; e = Math.floor(e / 2)) {
+            if (e % 2 === 1) {
+                result = (result * b) % mod;
+            }
+            b = (b * b) % mod;
+            yield;
+        }
+        return result;
+    }
+    function make_secret(mod = CRYPTO.MOD) {
+        return Math.floor(Math.random() * (mod - 1)) + 1;
+    }
+    CRYPTO.make_secret = make_secret;
+    function* make_public(secret, mod = CRYPTO.MOD, prime = CRYPTO.PRIME) {
+        return to_HEX(yield* mod_exp(mod, secret, prime));
+    }
+    CRYPTO.make_public = make_public;
+    function* make_shared(secret, other, prime = CRYPTO.PRIME) {
+        return to_HEX(yield* mod_exp(to_NUM(other), secret, prime));
+    }
+    CRYPTO.make_shared = make_shared;
+    function* encrypt(raw, key) {
+        let encrypted = '';
+        for (let i = 0; i < raw.length; i++) {
+            encrypted += String.fromCharCode(raw.charCodeAt(i) ^ key.charCodeAt(i % key.length));
+            yield;
+        }
+        return encrypted;
+    }
+    CRYPTO.encrypt = encrypt;
+    function* decrypt(encrypted, key) {
+        let decrypted = '';
+        for (let i = 0; i < encrypted.length; i++) {
+            decrypted += String.fromCharCode(encrypted.charCodeAt(i) ^ key.charCodeAt(i % key.length));
+            yield;
+        }
+        return decrypted;
+    }
+    CRYPTO.decrypt = decrypt;
+})(CRYPTO || (CRYPTO = {}));
+export var NET;
+(function (NET) {
+    const FRAG_MAX = 2048;
+    const namespace_listeners = new Map();
+    system.afterEvents.scriptEventReceive.subscribe(event => {
+        system.runJob((function* () {
+            const ids = event.id.split(':');
+            const namespace = yield* SERDE.decode(ids[0]);
+            const listeners = namespace_listeners.get(namespace);
+            if (event.sourceType === ScriptEventSource.Server && listeners) {
+                const payload = Payload.fromString(yield* SERDE.decode(ids[1]));
+                for (let i = 0; i < listeners.length; i++) {
+                    yield* listeners[i](payload, event.message);
+                }
+            }
+        })());
+    });
+    function create_listener(namespace, listener) {
+        let listeners = namespace_listeners.get(namespace);
+        if (!listeners) {
+            listeners = new Array();
+            namespace_listeners.set(namespace, listeners);
+        }
+        listeners.push(listener);
+        return () => {
+            const idx = listeners.indexOf(listener);
+            if (idx !== -1)
+                listeners.splice(idx, 1);
+            if (listeners.length === 0) {
+                namespace_listeners.delete(namespace);
+            }
+        };
+    }
+    let Payload;
+    (function (Payload) {
+        function toString(p) {
+            return JSON.stringify(p);
+        }
+        Payload.toString = toString;
+        function fromString(s) {
+            return JSON.parse(s);
+        }
+        Payload.fromString = fromString;
+    })(Payload || (Payload = {}));
+    function generate_id() {
+        const r = (Math.random() * 0x100000000) >>> 0;
+        return ((r & 0xff).toString(16).padStart(2, '0') +
+            ((r >> 8) & 0xff).toString(16).padStart(2, '0') +
+            ((r >> 16) & 0xff).toString(16).padStart(2, '0') +
+            ((r >> 24) & 0xff).toString(16).padStart(2, '0')).toUpperCase();
+    }
+    function* emit(namespace, channel, args) {
+        const id = generate_id();
+        const enc_namespace = yield* SERDE.encode(namespace);
+        const enc_args_str = yield* SERDE.encode(JSON.stringify(args));
+        const RUN = function* (payload, data_str) {
+            const enc_payload = yield* SERDE.encode(Payload.toString(payload));
+            world.getDimension('overworld').runCommand(`scriptevent ${enc_namespace}:${enc_payload} ${data_str}`);
+        };
+        let len = 0;
+        let str = '';
+        let str_size = 0;
+        for (let i = 0; i < enc_args_str.length; i++) {
+            const char = enc_args_str[i];
+            const code = char.charCodeAt(0);
+            const char_size = code <= 0x7f ? 1 : code <= 0x7ff ? 2 : code <= 0xffff ? 3 : 4;
+            if (str_size + char_size < FRAG_MAX) {
+                str += char;
+                str_size += char_size;
+            }
+            else {
+                yield* RUN([channel, id, len], str);
+                len++;
+                str = char;
+                str_size = char_size;
+            }
+            yield;
+        }
+        yield* RUN(len === 0 ? [channel, id] : [channel, id, len, 1], str);
+    }
+    NET.emit = emit;
+    function listen(namespace, channel, callback) {
+        const buffer = new Map();
+        const listener = function* ([p_channel, p_id, p_index, p_final], data) {
+            if (p_channel === channel) {
+                if (p_index === undefined) {
+                    yield* callback(JSON.parse(yield* SERDE.decode(data)));
+                }
+                else {
+                    let fragment = buffer.get(p_id);
+                    if (!fragment) {
+                        fragment = { size: -1, data_strs: [], data_size: 0 };
+                        buffer.set(p_id, fragment);
+                    }
+                    if (p_final === 1)
+                        fragment.size = p_index + 1;
+                    fragment.data_strs[p_index] = data;
+                    fragment.data_size += p_index + 1;
+                    if (fragment.size !== -1 && fragment.data_size === (fragment.size * (fragment.size + 1)) / 2) {
+                        let full_str = '';
+                        for (let i = 0; i < fragment.data_strs.length; i++) {
+                            full_str += fragment.data_strs[i];
+                            yield;
+                        }
+                        yield* callback(JSON.parse(yield* SERDE.decode(full_str)));
+                        buffer.delete(p_id);
+                    }
+                }
+            }
+        };
+        return create_listener(namespace, listener);
+    }
+    NET.listen = listen;
+})(NET || (NET = {}));

package/dist/ipc.min.js

@@ -0,0 +1 @@
+import{world,system,ScriptEventSource}from"@minecraft/server";var IPC,SERDE,CRYPTO,NET;(e=>{class _{*MAYBE_ENCRYPT(e){return!1!==this._enc?yield*CRYPTO.encrypt(JSON.stringify(e),this._enc):e}*MAYBE_DECRYPT(e){return!1!==this._enc?JSON.parse(yield*CRYPTO.decrypt(e[1],this._enc)):e[1]}get from(){return this._from}get to(){return this._to}constructor(e,t,n){this._from=e,this._to=t,this._enc=n,this._terminators=new Array}terminate(e=!0){var t=this;t._terminators.forEach(e=>e()),t._terminators.length=0,e&&system.runJob(NET.emit("ipc",t._to+":terminate",[t._from]))}send(t,...n){let i=this;system.runJob(function*(){var e=yield*i.MAYBE_ENCRYPT(n);yield*NET.emit("ipc",i._to+`:${t}:send`,[i._from,e])}())}invoke(i,...t){let r=this;return system.runJob(function*(){var e=yield*r.MAYBE_ENCRYPT(t);yield*NET.emit("ipc",r._to+`:${i}:invoke`,[r._from,e])}()),new Promise(t=>{let n=NET.listen("ipc",r._from+`:${i}:handle`,function*(e){e[0]===r._to&&(e=yield*r.MAYBE_DECRYPT(e),t(e),n())})})}on(e,t){let n=this;e=NET.listen("ipc",n._from+`:${e}:send`,function*(e){e[0]===n._to&&(e=yield*n.MAYBE_DECRYPT(e),t(...e))});return n._terminators.push(e),e}once(e,t){let n=this,i=NET.listen("ipc",n._from+`:${e}:send`,function*(e){e[0]===n._to&&(e=yield*n.MAYBE_DECRYPT(e),t(...e),i())});return n._terminators.push(i),i}handle(t,n){let i=this;var e=NET.listen("ipc",i._from+`:${t}:invoke`,function*(e){e[0]===i._to&&(e=yield*i.MAYBE_DECRYPT(e),e=n(...e),e=yield*i.MAYBE_ENCRYPT([e]),yield*NET.emit("ipc",i._to+`:${t}:handle`,[i._from,e]))});return i._terminators.push(e),e}}e.Connection=_,e.ConnectionManager=class{*MAYBE_ENCRYPT(e,t){return!1!==t?yield*CRYPTO.encrypt(JSON.stringify(e),t):e}*MAYBE_DECRYPT(e,t){return!1!==t?JSON.parse(yield*CRYPTO.decrypt(e[1],t)):e[1]}get id(){return this._id}constructor(e,t=!1){let i=this;this._id=e,this._enc_map=new Map,this._con_map=new Map,this._enc_force=t,NET.listen("ipc",this._id+":handshake:SYN",function*(e){var t=CRYPTO.make_secret(e[4]),n=yield*CRYPTO.make_public(t,e[4],e[3]),t=!(1!==e[1]&&!i._enc_force)&&(yield*CRYPTO.make_shared(t,e[2],e[3]));i._enc_map.set(e[0],t),yield*NET.emit("ipc",e[0]+":handshake:ACK",[i._id,i._enc_force?1:0,n])}),NET.listen("ipc",this._id+":terminate",function*(e){i._enc_map.delete(e[0])})}connect(l,d=!1,c=20){let a=this;return new Promise((r,o)=>{var e=this._con_map.get(l);if(void 0!==e)e.terminate(!1),r(e);else{let t=CRYPTO.make_secret(),n=d?1:0;function s(){i(),system.clearRun(e)}system.runJob(function*(){var e=yield*CRYPTO.make_public(t);yield*NET.emit("ipc",l+":handshake:SYN",[a._id,n,e,CRYPTO.PRIME,CRYPTO.MOD])}());let e=system.runTimeout(()=>{o(),s()},c),i=NET.listen("ipc",this._id+":handshake:ACK",function*(e){e[0]===l&&(e=!(1!==e[1]&&!d)&&(yield*CRYPTO.make_shared(t,e[2])),e=new _(a._id,l,e),a._con_map.set(l,e),r(e),s())})}})}send(n,...i){let r=this;system.runJob(function*(){for(var[e,t]of r._enc_map){t=yield*r.MAYBE_ENCRYPT(i,t);yield*NET.emit("ipc",e+`:${n}:send`,[r._id,t])}}())}invoke(o,...t){let s=this;var e=[];for(let[i,r]of s._enc_map)system.runJob(function*(){var e=yield*s.MAYBE_ENCRYPT(t,r);yield*NET.emit("ipc",i+`:${o}:invoke`,[s._id,e])}()),e.push(new Promise(t=>{let n=NET.listen("ipc",s._id+`:${o}:handle`,function*(e){e[0]===i&&(e=yield*s.MAYBE_DECRYPT(e,r),t(e),n())})}));return e}on(e,n){let i=this;return NET.listen("ipc",i._id+`:${e}:send`,function*(e){var t=i._enc_map.get(e[0]);void 0!==t&&(e=yield*i.MAYBE_DECRYPT(e,t),n(...e))})}once(e,n){let i=this,r=NET.listen("ipc",i._id+`:${e}:send`,function*(e){var t=i._enc_map.get(e[0]);void 0!==t&&(e=yield*i.MAYBE_DECRYPT(e,t),n(...e),r())});return r}handle(i,r){let o=this;return NET.listen("ipc",o._id+`:${i}:invoke`,function*(e){var t,n=o._enc_map.get(e[0]);void 0!==n&&(t=yield*o.MAYBE_DECRYPT(e,n),t=r(...t),t=yield*o.MAYBE_ENCRYPT([t],n),yield*NET.emit("ipc",e[0]+`:${i}:handle`,[o._id,t]))})}},e.send=function(e,...t){system.runJob(NET.emit("ipc",e+":send",t))},e.invoke=function(e,...t){return system.runJob(NET.emit("ipc",e+":invoke",t)),new Promise(t=>{let n=NET.listen("ipc",e+":handle",function*(e){t(e[0]),n()})})},e.on=function(e,t){return NET.listen("ipc",e+":send",function*(e){t(...e)})},e.once=function(e,t){let n=NET.listen("ipc",e+":send",function*(e){t(...e),n()});return n},e.handle=function(t,n){return NET.listen("ipc",t+":invoke",function*(e){e=n(...e);yield*NET.emit("ipc",t+":handle",[e])})}})(IPC=IPC||{});export default IPC;(e=>{let o=[48,49,50,51,52,53,54,55,56,57],s=[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,42,43,44,47,58,59,60,61,62,63,64,91,92,93,94,96,123,124,125,126,127],r=/\?[0-9a-zA-Z.\-]{2}|[^?]+/g,l=/^\?[0-9a-zA-Z.\-]{2}$/,d="0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-";e.encode=function*(t){let n="";for(let e=0;e<t.length;e++){var i=t.charAt(e),r=i.charCodeAt(0);0===e&&o.includes(r)||s.includes(r)?n+="?"+(yield*function*(t){let n="";for(let e=t.charCodeAt(0);0<e;e=Math.floor(e/64))n=d[e%64]+n,yield;return n}(i)).padStart(2,"0"):n+=i,yield}return n},e.decode=function*(e){let t="";var n=e.match(r)??[];for(let e=0;e<n.length;e++){var i=n[e];i.startsWith("?")&&l.test(i)?t+=yield*function*(t){let n=0;for(let e=0;e<t.length;e++)n+=64**(t.length-1-e)*d.indexOf(t[e]),yield;return String.fromCharCode(n)}(i.slice(1)):t+=i,yield}return t}})(SERDE=SERDE||{}),(i=>{i.PRIME=19893121,i.MOD=341;let r=e=>e.toString(16).toUpperCase();function*o(e,t,n){let i=1,r=e%n;for(let e=t;0<e;e=Math.floor(e/2))e%2==1&&(i=i*r%n),r=r*r%n,yield;return i}i.make_secret=function(e=i.MOD){return Math.floor(Math.random()*(e-1))+1},i.make_public=function*(e,t=i.MOD,n=i.PRIME){return r(yield*o(t,e,n))},i.make_shared=function*(e,t,n=i.PRIME){return r(yield*o(parseInt(t,16),e,n))},i.encrypt=function*(t,n){let i="";for(let e=0;e<t.length;e++)i+=String.fromCharCode(t.charCodeAt(e)^n.charCodeAt(e%n.length)),yield;return i},i.decrypt=function*(t,n){let i="";for(let e=0;e<t.length;e++)i+=String.fromCharCode(t.charCodeAt(e)^n.charCodeAt(e%n.length)),yield;return i}})(CRYPTO=CRYPTO||{}),(e=>{let o=new Map;system.afterEvents.scriptEventReceive.subscribe(r=>{system.runJob(function*(){var e=r.id.split(":"),t=yield*SERDE.decode(e[0]),n=o.get(t);if(r.sourceType===ScriptEventSource.Server&&n){var i=E.fromString(yield*SERDE.decode(e[1]));for(let e=0;e<n.length;e++)yield*n[e](i,r.message)}}())});let E;var t;(t=E=E||{}).toString=function(e){return JSON.stringify(e)},t.fromString=function(e){return JSON.parse(e)},e.emit=function*(e,t,n){var i,r=((255&(i=4294967296*Math.random()>>>0)).toString(16).padStart(2,"0")+(i>>8&255).toString(16).padStart(2,"0")+(i>>16&255).toString(16).padStart(2,"0")+(i>>24&255).toString(16).padStart(2,"0")).toUpperCase();let o=yield*SERDE.encode(e);function*s(e,t){e=yield*SERDE.encode(E.toString(e)),world.getDimension("overworld").runCommand(`scriptevent ${o}:${e} `+t)}var l=yield*SERDE.encode(JSON.stringify(n));let d=0,c="",a=0;for(let e=0;e<l.length;e++){var _=l[e],u=_.charCodeAt(0),u=u<=127?1:u<=2047?2:u<=65535?3:4;a+u<2048?(c+=_,a+=u):(yield*s([t,r,d],c),d++,c=_,a=u),yield}yield*s(0===d?[t,r]:[t,r,d,1],c)},e.listen=function(e,n,s){let l=new Map;{var i=e,r=function*([e,i,t,r],o){if(e===n)if(void 0===t)yield*s(JSON.parse(yield*SERDE.decode(o)));else{let n=l.get(i);if(n||(n={size:-1,data_strs:[],data_size:0},l.set(i,n)),1===r&&(n.size=t+1),n.data_strs[t]=o,n.data_size+=t+1,-1!==n.size&&n.data_size===n.size*(n.size+1)/2){let t="";for(let e=0;e<n.data_strs.length;e++)t+=n.data_strs[e],yield;yield*s(JSON.parse(yield*SERDE.decode(t))),l.delete(i)}}};let t=o.get(i);return t||(t=new Array,o.set(i,t)),t.push(r),()=>{var e=t.indexOf(r);-1!==e&&t.splice(e,1),0===t.length&&o.delete(i)}}}})(NET=NET||{});export{NET};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "mcbe-ipc",
+  "author": "OmniacDev",
+  "description": "IPC system for MCBE Script API projects",
+  "license": "MIT",
+  "version": "2.0.0",
+  "type": "module",
+  "main": "dist/ipc.js",
+  "types": "dist/ipc.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc && uglifyjs dist/ipc.js --mangle --compress --output dist/ipc.min.js",
+    "format": "prettier --write src",
+    "build-clean": "tsc",
+    "prepublishOnly": "npm run build-clean"
+  },
+  "devDependencies": {
+    "prettier": "^3.3.3",
+    "typescript": "^5.5.4",
+    "uglify-js": "^3.19.3"
+  },
+  "dependencies": {
+    "@minecraft/server": "^1.13.0"
+  }
+}