@mtcute/core 0.17.1 → 0.18.0

package/utils/links/proxy.js

@@ -0,0 +1,47 @@
+import { deeplinkBuilder } from "./common.js";
+const mtproxy = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: (params) => ["proxy", params],
+  externalBuild: (params) => ["proxy", params],
+  internalParse: (path, query) => {
+    if (path !== "proxy") return null;
+    const server = query.get("server");
+    const port = Number(query.get("port"));
+    const secret = query.get("secret");
+    if (!server || Number.isNaN(port) || !secret) return null;
+    return { server, port, secret };
+  },
+  externalParse: (path, query) => {
+    if (path !== "proxy") return null;
+    const server = query.get("server");
+    const port = Number(query.get("port"));
+    const secret = query.get("secret");
+    if (!server || Number.isNaN(port) || !secret) return null;
+    return { server, port, secret };
+  }
+});
+const socks5 = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: (params) => ["socks", params],
+  externalBuild: (params) => ["socks", params],
+  internalParse: (path, query) => {
+    if (path !== "socks") return null;
+    const server = query.get("server");
+    const port = Number(query.get("port"));
+    const user = query.get("user");
+    const pass = query.get("pass");
+    if (!server || Number.isNaN(port)) return null;
+    return { server, port, user: user || void 0, pass: pass || void 0 };
+  },
+  externalParse: (path, query) => {
+    if (path !== "socks") return null;
+    const server = query.get("server");
+    const port = Number(query.get("port"));
+    const user = query.get("user");
+    const pass = query.get("pass");
+    if (!server || Number.isNaN(port)) return null;
+    return { server, port, user: user || void 0, pass: pass || void 0 };
+  }
+});
+export {
+  mtproxy,
+  socks5
+};

package/utils/links/proxy.test.d.cts

@@ -0,0 +1 @@
+export {};

package/utils/links/stickers.cjs

@@ -0,0 +1,24 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const common = require("./common.cjs");
+const stickerset = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ slug, emoji }) => [emoji ? "addemoji" : "addstickers", { set: slug }],
+  internalParse: (path, query) => {
+    if (path !== "addstickers" && path !== "addemoji") return null;
+    const slug = query.get("set");
+    if (!slug) return null;
+    return { slug, emoji: path === "addemoji" };
+  },
+  externalBuild: ({ slug, emoji }) => [`${emoji ? "addemoji" : "addstickers"}/${slug}`, null],
+  externalParse: (path) => {
+    const [prefix, slug] = path.split("/");
+    if (prefix !== "addstickers" && prefix !== "addemoji") return null;
+    return { slug, emoji: prefix === "addemoji" };
+  }
+});
+exports.stickerset = stickerset;

package/utils/links/stickers.d.cts

@@ -0,0 +1,10 @@
+import { Deeplink } from './common.js';
+/**
+ * Sticker set links
+ *
+ * Used to import stickersets or custom emoji stickersets
+ */
+export declare const stickerset: Deeplink<{
+    slug: string;
+    emoji?: boolean;
+}>;

package/utils/links/stickers.js

@@ -0,0 +1,19 @@
+import { deeplinkBuilder } from "./common.js";
+const stickerset = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ slug, emoji }) => [emoji ? "addemoji" : "addstickers", { set: slug }],
+  internalParse: (path, query) => {
+    if (path !== "addstickers" && path !== "addemoji") return null;
+    const slug = query.get("set");
+    if (!slug) return null;
+    return { slug, emoji: path === "addemoji" };
+  },
+  externalBuild: ({ slug, emoji }) => [`${emoji ? "addemoji" : "addstickers"}/${slug}`, null],
+  externalParse: (path) => {
+    const [prefix, slug] = path.split("/");
+    if (prefix !== "addstickers" && prefix !== "addemoji") return null;
+    return { slug, emoji: prefix === "addemoji" };
+  }
+});
+export {
+  stickerset
+};

package/utils/links/user.cjs

@@ -0,0 +1,57 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const common = require("./common.cjs");
+const publicUsername = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ username }) => ["resolve", { domain: username }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const domain = query.get("domain");
+    if (!domain) return null;
+    if ([...query.keys()].length > 1) return null;
+    return { username: domain };
+  },
+  externalBuild: ({ username }) => [username, null],
+  externalParse: (path, query) => {
+    if (path.length <= 1 || path.includes("/") || path[0] === "+") return null;
+    if ([...query.keys()].length > 0) return null;
+    return { username: path };
+  }
+});
+const temporaryProfile = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ token }) => ["contact", { token }],
+  internalParse: (path, query) => {
+    if (path !== "contact") return null;
+    const token = query.get("token");
+    if (!token) return null;
+    return { token };
+  },
+  externalBuild: ({ token }) => [`contact/${token}`, null],
+  externalParse: (path) => {
+    const [prefix, token] = path.split("/");
+    if (prefix !== "contact") return null;
+    return { token };
+  }
+});
+const phoneNumber = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ phone }) => ["resolve", { phone }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const phone = query.get("phone");
+    if (!phone) return null;
+    return { phone };
+  },
+  externalBuild: ({ phone }) => [`+${phone}`, null],
+  externalParse: (path) => {
+    const m = path.match(/^\+(\d+)$/);
+    if (!m) return null;
+    return { phone: m[1] };
+  }
+});
+exports.phoneNumber = phoneNumber;
+exports.publicUsername = publicUsername;
+exports.temporaryProfile = temporaryProfile;

package/utils/links/user.d.cts

@@ -0,0 +1,28 @@
+import { Deeplink } from './common.js';
+/**
+ * Public username links
+ *
+ * Used to link to public users, groups and channels
+ */
+export declare const publicUsername: Deeplink<{
+    username: string;
+}>;
+/**
+ * Temporary profile links
+ *
+ * Used to link to user profiles, generated using contacts.exportContactToken.
+ * These links can be generated even for profiles that don't have a username,
+ * and they have an expiration date, specified by the expires field of the exportedContactToken
+ * constructor returned by contacts.exportContactToken.
+ */
+export declare const temporaryProfile: Deeplink<{
+    token: string;
+}>;
+/**
+ * Phone number links
+ *
+ * Used to link to public and private users by their phone number.
+ */
+export declare const phoneNumber: Deeplink<{
+    phone: string;
+}>;

package/utils/links/user.js

@@ -0,0 +1,52 @@
+import { deeplinkBuilder } from "./common.js";
+const publicUsername = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ username }) => ["resolve", { domain: username }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const domain = query.get("domain");
+    if (!domain) return null;
+    if ([...query.keys()].length > 1) return null;
+    return { username: domain };
+  },
+  externalBuild: ({ username }) => [username, null],
+  externalParse: (path, query) => {
+    if (path.length <= 1 || path.includes("/") || path[0] === "+") return null;
+    if ([...query.keys()].length > 0) return null;
+    return { username: path };
+  }
+});
+const temporaryProfile = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ token }) => ["contact", { token }],
+  internalParse: (path, query) => {
+    if (path !== "contact") return null;
+    const token = query.get("token");
+    if (!token) return null;
+    return { token };
+  },
+  externalBuild: ({ token }) => [`contact/${token}`, null],
+  externalParse: (path) => {
+    const [prefix, token] = path.split("/");
+    if (prefix !== "contact") return null;
+    return { token };
+  }
+});
+const phoneNumber = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ phone }) => ["resolve", { phone }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const phone = query.get("phone");
+    if (!phone) return null;
+    return { phone };
+  },
+  externalBuild: ({ phone }) => [`+${phone}`, null],
+  externalParse: (path) => {
+    const m = path.match(/^\+(\d+)$/);
+    if (!m) return null;
+    return { phone: m[1] };
+  }
+});
+export {
+  phoneNumber,
+  publicUsername,
+  temporaryProfile
+};

package/utils/links/user.test.d.cts

@@ -0,0 +1 @@
+export {};

package/{chunks/cjs/D4qcXFYA.js → utils/logger.cjs}

@@ -1,12 +1,13 @@
 if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
   globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
-  console.warn("[@mtcute/core] CommonJS support is deprecated and will be removed soon. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
-  console.warn("[@mtcute/core] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
 }
 "use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
 const tl = require("@mtcute/tl");
-const platform = require("./j7rWn_1y.js");
-const controllablePromise = require("./CZAB54t2.js");
+const typeAssertions = require("./type-assertions.cjs");
 const DEFAULT_LOG_LEVEL = 2;
 const FORMATTER_RE = /%[a-z]/gi;
 class Logger {
@@ -42,7 +43,7 @@ class Logger {
           let val = args[idx];
           args.splice(idx, 1);
           if (m === "%h") {
-            if (ArrayBuffer.isView(val)) return this.mgr.platform.hexEncode(val);
+            if (ArrayBuffer.isView(val)) return utils.hex.encode(val);
             if (typeof val === "number" || typeof val === "bigint") return val.toString(16);
             return String(val);
           }
@@ -53,7 +54,7 @@ class Logger {
             }
             return JSON.stringify(val, (k, v) => {
               if (ArrayBuffer.isView(v) || typeof v === "object" && v.type === "Buffer" && Array.isArray(v.data)) {
-                let str = v.data ? Buffer.from(v.data).toString("hex") : this.mgr.platform.hexEncode(v);
+                let str = v.data ? Buffer.from(v.data).toString("hex") : utils.hex.encode(v);
                 if (str.length > 300) {
                   str = `${str.slice(0, 300)}...`;
                 }
@@ -68,7 +69,7 @@ class Logger {
             return `[${val.map(String).join(", ")}]`;
           }
           if (m === "%e") {
-            if (controllablePromise.isTlRpcError(val)) {
+            if (typeAssertions.isTlRpcError(val)) {
               return `${val.errorCode} ${val.errorMessage}`;
             }
             if (tl.tl.RpcError.is(val)) {
@@ -107,15 +108,13 @@ class LogManager extends Logger {
   static INFO = 3;
   static DEBUG = 4;
   static VERBOSE = 5;
-  platform;
   level;
   handler;
-  constructor(tag = "base") {
+  constructor(tag = "base", platform) {
     super(null, tag);
     this.mgr = this;
-    this.platform = platform.getPlatform();
-    this.level = this.platform.getDefaultLogLevel() ?? DEFAULT_LOG_LEVEL;
-    this.handler = this.platform.log.bind(this.platform);
+    this.level = platform.getDefaultLogLevel() ?? DEFAULT_LOG_LEVEL;
+    this.handler = platform.log.bind(platform);
   }
   _filter = defaultFilter;
   /**

package/utils/logger.d.cts

@@ -0,0 +1,54 @@
+import { ICorePlatform } from '../types/platform.js';
+/**
+ * Logger created by {@link LogManager}
+ */
+export declare class Logger {
+    readonly mgr: LogManager;
+    readonly tag: string;
+    readonly parent: Logger;
+    private color;
+    prefix: string;
+    constructor(mgr: LogManager, tag: string, parent?: Logger);
+    getPrefix(): string;
+    log(level: number, fmt: string, ...args: unknown[]): void;
+    readonly error: (fmt: string, ...args: unknown[]) => void;
+    readonly warn: (fmt: string, ...args: unknown[]) => void;
+    readonly info: (fmt: string, ...args: unknown[]) => void;
+    readonly debug: (fmt: string, ...args: unknown[]) => void;
+    readonly verbose: (fmt: string, ...args: unknown[]) => void;
+    /**
+     * Create a {@link Logger} with the given tag
+     * from the same {@link LogManager} as the current
+     * Logger.
+     *
+     * @param tag  Logger tag
+     */
+    create(tag: string): Logger;
+}
+/**
+ * Log manager. A logger that allows managing child loggers
+ */
+export declare class LogManager extends Logger {
+    static OFF: number;
+    static ERROR: number;
+    static WARN: number;
+    static INFO: number;
+    static DEBUG: number;
+    static VERBOSE: number;
+    level: number;
+    handler: (color: number, level: number, tag: string, fmt: string, args: unknown[]) => void;
+    constructor(tag: string | undefined, platform: ICorePlatform);
+    private _filter;
+    /**
+     * Create a {@link Logger} with the given tag
+     *
+     * @param tag  Logger tag
+     */
+    create(tag: string): Logger;
+    /**
+     * Filter logging by tags.
+     *
+     * @param cb
+     */
+    filter(cb: ((tag: string) => boolean) | null): void;
+}

package/utils/logger.d.ts

@@ -1,4 +1,4 @@
-import { ICorePlatform } from '../platform.js';
+import { ICorePlatform } from '../types/platform.js';
 /**
  * Logger created by {@link LogManager}
  */
@@ -35,10 +35,9 @@ export declare class LogManager extends Logger {
     static INFO: number;
     static DEBUG: number;
     static VERBOSE: number;
-    readonly platform: ICorePlatform;
     level: number;
     handler: (color: number, level: number, tag: string, fmt: string, args: unknown[]) => void;
-    constructor(tag?: string);
+    constructor(tag: string | undefined, platform: ICorePlatform);
     private _filter;
     /**
      * Create a {@link Logger} with the given tag

package/{chunks/es/BRgz_-S8.js → utils/logger.js}

@@ -1,6 +1,6 @@
+import { hex } from "@fuman/utils";
 import { tl } from "@mtcute/tl";
-import { getPlatform } from "./DBMBgE7t.js";
-import { isTlRpcError } from "./BN3qj7tU.js";
+import { isTlRpcError } from "./type-assertions.js";
 const DEFAULT_LOG_LEVEL = 2;
 const FORMATTER_RE = /%[a-z]/gi;
 class Logger {
@@ -36,7 +36,7 @@ class Logger {
           let val = args[idx];
           args.splice(idx, 1);
           if (m === "%h") {
-            if (ArrayBuffer.isView(val)) return this.mgr.platform.hexEncode(val);
+            if (ArrayBuffer.isView(val)) return hex.encode(val);
             if (typeof val === "number" || typeof val === "bigint") return val.toString(16);
             return String(val);
           }
@@ -47,7 +47,7 @@ class Logger {
             }
             return JSON.stringify(val, (k, v) => {
               if (ArrayBuffer.isView(v) || typeof v === "object" && v.type === "Buffer" && Array.isArray(v.data)) {
-                let str = v.data ? Buffer.from(v.data).toString("hex") : this.mgr.platform.hexEncode(v);
+                let str = v.data ? Buffer.from(v.data).toString("hex") : hex.encode(v);
                 if (str.length > 300) {
                   str = `${str.slice(0, 300)}...`;
                 }
@@ -101,15 +101,13 @@ class LogManager extends Logger {
   static INFO = 3;
   static DEBUG = 4;
   static VERBOSE = 5;
-  platform;
   level;
   handler;
-  constructor(tag = "base") {
+  constructor(tag = "base", platform) {
     super(null, tag);
     this.mgr = this;
-    this.platform = getPlatform();
-    this.level = this.platform.getDefaultLogLevel() ?? DEFAULT_LOG_LEVEL;
-    this.handler = this.platform.log.bind(this.platform);
+    this.level = platform.getDefaultLogLevel() ?? DEFAULT_LOG_LEVEL;
+    this.handler = platform.log.bind(platform);
   }
   _filter = defaultFilter;
   /**

package/utils/logger.test.d.cts

@@ -0,0 +1 @@
+export {};

package/utils/long-utils.cjs

@@ -0,0 +1,68 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
+const Long = require("long");
+const miscUtils = require("./misc-utils.cjs");
+function randomLong(unsigned = false) {
+  const lo = miscUtils.getRandomInt(4294967295);
+  const hi = miscUtils.getRandomInt(4294967295);
+  return new Long(lo, hi, unsigned);
+}
+function longFromBuffer(buf, unsigned = false, le = true) {
+  const dv = utils.typed.toDataView(buf);
+  if (le) {
+    return new Long(dv.getInt32(0, true), dv.getInt32(4, true), unsigned);
+  }
+  return new Long(dv.getInt32(4, false), dv.getInt32(0, false), unsigned);
+}
+function removeFromLongArray(arr, val) {
+  for (let i = 0; i < arr.length; i++) {
+    const v = arr[i];
+    if (v === val || v.eq(val)) {
+      arr.splice(i, 1);
+      return true;
+    }
+  }
+  return false;
+}
+function compareLongs(a, b) {
+  if (a.eq(b)) return 0;
+  if (a.gt(b)) return 1;
+  return -1;
+}
+function longToFastString(val) {
+  return `${val.low}|${val.high}`;
+}
+function longFromFastString(val, unsigned = false) {
+  const parts = val.split("|");
+  if (parts.length !== 2) throw new Error(`Invalid long fast string: ${val}`);
+  const low = Number.parseInt(parts[0]);
+  const high = Number.parseInt(parts[1]);
+  if (Number.isNaN(low) || Number.isNaN(high)) {
+    throw new TypeError(`Invalid long fast string: ${val}`);
+  }
+  return new Long(low, high, unsigned);
+}
+class LongMap extends utils.CustomMap {
+  constructor() {
+    super(longToFastString, longFromFastString);
+  }
+}
+class LongSet extends utils.CustomSet {
+  constructor() {
+    super(longToFastString, longFromFastString);
+  }
+}
+exports.LongMap = LongMap;
+exports.LongSet = LongSet;
+exports.compareLongs = compareLongs;
+exports.longFromBuffer = longFromBuffer;
+exports.longFromFastString = longFromFastString;
+exports.longToFastString = longToFastString;
+exports.randomLong = randomLong;
+exports.removeFromLongArray = removeFromLongArray;

package/utils/long-utils.d.cts

@@ -0,0 +1,67 @@
+import { CustomMap, CustomSet } from '@fuman/utils';
+import { default as Long } from 'long';
+/**
+ * Get a random Long
+ *
+ * @param unsigned  Whether the number should be unsigned
+ */
+export declare function randomLong(unsigned?: boolean): Long;
+/**
+ * Read a Long from a buffer
+ *
+ * @param buf  Buffer to read from
+ * @param unsigned  Whether the number should be unsigned
+ * @param le  Whether the number is little-endian
+ */
+export declare function longFromBuffer(buf: Uint8Array, unsigned?: boolean, le?: boolean): Long;
+/**
+ * Remove a Long from an array
+ *
+ * @param arr  Array to remove from
+ * @param val  Value to remove
+ */
+export declare function removeFromLongArray(arr: Long[], val: Long): boolean;
+/**
+ * Compare two Longs and return -1, 0 or 1,
+ * to be used as a comparator function.
+ */
+export declare function compareLongs(a: Long, b: Long): number;
+/**
+ * Serialize a Long (int64) to its fast string representation:
+ * `$high|$low`.
+ *
+ * This method is about 500* times faster than using `Long.toString()`,
+ * and very useful when the string will only ever be used internally
+ * (e.g. for keying a map)
+ *
+ * _\* benchmark result, YMMV_
+ *
+ * @param val
+ */
+export declare function longToFastString(val: Long): string;
+/**
+ * Parse a Long (int64) from its fast string representation:
+ * `$high|$low`.
+ *
+ * This method is about 2 times faster than using Long.fromString.
+ *
+ * @param val
+ * @param unsigned
+ */
+export declare function longFromFastString(val: string, unsigned?: boolean): Long;
+/**
+ * Map with Longs as key.
+ *
+ * Uses fast string representation internally.
+ */
+export declare class LongMap<V> extends CustomMap<Long, string, V> {
+    constructor();
+}
+/**
+ * Set for Longs.
+ *
+ * Uses fast string representation internally
+ */
+export declare class LongSet extends CustomSet<Long, string> {
+    constructor();
+}

package/utils/long-utils.d.ts

@@ -1,3 +1,4 @@
+import { CustomMap, CustomSet } from '@fuman/utils';
 import { default as Long } from 'long';
 /**
  * Get a random Long
@@ -53,28 +54,14 @@ export declare function longFromFastString(val: string, unsigned?: boolean): Lon
  *
  * Uses fast string representation internally.
  */
-export declare class LongMap<V> {
-    private _map;
-    set(key: Long, value: V): void;
-    has(key: Long): boolean;
-    get(key: Long): V | undefined;
-    delete(key: Long): void;
-    keys(unsigned?: boolean): IterableIterator<Long>;
-    values(): IterableIterator<V>;
-    clear(): void;
-    size(): number;
+export declare class LongMap<V> extends CustomMap<Long, string, V> {
+    constructor();
 }
 /**
  * Set for Longs.
  *
  * Uses fast string representation internally
  */
-export declare class LongSet {
-    private _set;
-    get size(): number;
-    add(val: Long): void;
-    delete(val: Long): void;
-    has(val: Long): boolean;
-    clear(): void;
-    toArray(): Long[];
+export declare class LongSet extends CustomSet<Long, string> {
+    constructor();
 }

package/utils/long-utils.js

@@ -0,0 +1,63 @@
+import { CustomMap, CustomSet, typed } from "@fuman/utils";
+import Long from "long";
+import { getRandomInt } from "./misc-utils.js";
+function randomLong(unsigned = false) {
+  const lo = getRandomInt(4294967295);
+  const hi = getRandomInt(4294967295);
+  return new Long(lo, hi, unsigned);
+}
+function longFromBuffer(buf, unsigned = false, le = true) {
+  const dv = typed.toDataView(buf);
+  if (le) {
+    return new Long(dv.getInt32(0, true), dv.getInt32(4, true), unsigned);
+  }
+  return new Long(dv.getInt32(4, false), dv.getInt32(0, false), unsigned);
+}
+function removeFromLongArray(arr, val) {
+  for (let i = 0; i < arr.length; i++) {
+    const v = arr[i];
+    if (v === val || v.eq(val)) {
+      arr.splice(i, 1);
+      return true;
+    }
+  }
+  return false;
+}
+function compareLongs(a, b) {
+  if (a.eq(b)) return 0;
+  if (a.gt(b)) return 1;
+  return -1;
+}
+function longToFastString(val) {
+  return `${val.low}|${val.high}`;
+}
+function longFromFastString(val, unsigned = false) {
+  const parts = val.split("|");
+  if (parts.length !== 2) throw new Error(`Invalid long fast string: ${val}`);
+  const low = Number.parseInt(parts[0]);
+  const high = Number.parseInt(parts[1]);
+  if (Number.isNaN(low) || Number.isNaN(high)) {
+    throw new TypeError(`Invalid long fast string: ${val}`);
+  }
+  return new Long(low, high, unsigned);
+}
+class LongMap extends CustomMap {
+  constructor() {
+    super(longToFastString, longFromFastString);
+  }
+}
+class LongSet extends CustomSet {
+  constructor() {
+    super(longToFastString, longFromFastString);
+  }
+}
+export {
+  LongMap,
+  LongSet,
+  compareLongs,
+  longFromBuffer,
+  longFromFastString,
+  longToFastString,
+  randomLong,
+  removeFromLongArray
+};

package/utils/long-utils.test.d.cts

@@ -0,0 +1 @@
+export {};