@mtkruto/node 0.1.135 → 0.1.138

package/script/deps/raw.githubusercontent.com/MTKruto/mutex/main/semaphore.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Semaphore = exports.E_CANCELED = void 0;
+exports.E_CANCELED = new Error("request for lock canceled");
+class Semaphore {
+    constructor(_value, _cancelError = exports.E_CANCELED) {
+        Object.defineProperty(this, "_value", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: _value
+        });
+        Object.defineProperty(this, "_cancelError", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: _cancelError
+        });
+        Object.defineProperty(this, "_weightedQueues", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "_weightedWaiters", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+    }
+    acquire(weight = 1) {
+        if (weight <= 0) {
+            throw new Error(`invalid weight ${weight}: must be positive`);
+        }
+        return new Promise((resolve, reject) => {
+            if (!this._weightedQueues[weight - 1]) {
+                this._weightedQueues[weight - 1] = [];
+            }
+            this._weightedQueues[weight - 1].push({ resolve, reject });
+            this._dispatch();
+        });
+    }
+    async runExclusive(callback, weight = 1) {
+        const [value, release] = await this.acquire(weight);
+        try {
+            return await callback(value);
+        }
+        finally {
+            release();
+        }
+    }
+    waitForUnlock(weight = 1) {
+        if (weight <= 0) {
+            throw new Error(`invalid weight ${weight}: must be positive`);
+        }
+        return new Promise((resolve) => {
+            if (!this._weightedWaiters[weight - 1]) {
+                this._weightedWaiters[weight - 1] = [];
+            }
+            this._weightedWaiters[weight - 1].push(resolve);
+            this._dispatch();
+        });
+    }
+    isLocked() {
+        return this._value <= 0;
+    }
+    getValue() {
+        return this._value;
+    }
+    setValue(value) {
+        this._value = value;
+        this._dispatch();
+    }
+    release(weight = 1) {
+        if (weight <= 0) {
+            throw new Error(`invalid weight ${weight}: must be positive`);
+        }
+        this._value += weight;
+        this._dispatch();
+    }
+    cancel() {
+        this._weightedQueues.forEach((queue) => queue.forEach((entry) => entry.reject(this._cancelError)));
+        this._weightedQueues = [];
+    }
+    _dispatch() {
+        for (let weight = this._value; weight > 0; weight--) {
+            const queueEntry = this._weightedQueues[weight - 1]?.shift();
+            if (!queueEntry)
+                continue;
+            const previousValue = this._value;
+            const previousWeight = weight;
+            this._value -= weight;
+            weight = this._value + 1;
+            queueEntry.resolve([previousValue, this._newReleaser(previousWeight)]);
+        }
+        this._drainUnlockWaiters();
+    }
+    _newReleaser(weight) {
+        let called = false;
+        return () => {
+            if (called)
+                return;
+            called = true;
+            this.release(weight);
+        };
+    }
+    _drainUnlockWaiters() {
+        for (let weight = this._value; weight > 0; weight--) {
+            if (!this._weightedWaiters[weight - 1])
+                continue;
+            this._weightedWaiters[weight - 1].forEach((waiter) => waiter());
+            this._weightedWaiters[weight - 1] = [];
+        }
+    }
+}
+exports.Semaphore = Semaphore;

package/script/storage/1_storage_local_storage.js

@@ -59,7 +59,7 @@ class StorageLocalStorage extends _0_storage_js_1.Storage {
         if (params?.limit !== undefined) {
             entries = entries.slice(0, params.limit <= 0 ? 1 : params.limit);
         }
-        for (let [key, value] of entries) {
+        entries: for (let [key, value] of entries) {
             if (key.startsWith(this.prefix)) {
                 key = key.slice(this.prefix.length);
             }
@@ -68,7 +68,7 @@ class StorageLocalStorage extends _0_storage_js_1.Storage {
                 if ("prefix" in filter) {
                     for (const [i, p] of filter.prefix.entries()) {
                         if ((0, _0_utilities_js_1.toString)(p) != (0, _0_utilities_js_1.toString)(parts[i])) {
-                            continue;
+                            continue entries;
                         }
                     }
                 }

package/script/storage/1_storage_session_storage.js

@@ -59,7 +59,7 @@ class StorageSessionStorage extends _0_storage_js_1.Storage {
         if (params?.limit !== undefined) {
             entries = entries.slice(0, params.limit <= 0 ? 1 : params.limit);
         }
-        for (let [key, value] of entries) {
+        entries: for (let [key, value] of entries) {
             if (key.startsWith(this.prefix)) {
                 key = key.slice(this.prefix.length);
             }
@@ -68,7 +68,7 @@ class StorageSessionStorage extends _0_storage_js_1.Storage {
                 if ("prefix" in filter) {
                     for (const [i, p] of filter.prefix.entries()) {
                         if ((0, _0_utilities_js_1.toString)(p) != (0, _0_utilities_js_1.toString)(parts[i])) {
-                            continue;
+                            continue entries;
                         }
                     }
                 }

package/script/types/6_update.d.ts

@@ -9,7 +9,13 @@ import { Message } from "./4_message.js";
 import { CallbackQuery } from "./5_callback_query.js";
 import { Chat } from "./5_chat.js";
 /**
- * The client's connection state was changed.
+ * A client's connection state was changed.
+ *
+ * ```
+ * client.on("connectionState", (ctx) => {
+ *   console.log("The client's connection state is now:", ctx.connectionState);
+ * });
+ * ```
  * @unlisted
  */
 export interface UpdateConnectionState {
@@ -17,7 +23,18 @@ export interface UpdateConnectionState {
     connectionState: ConnectionState;
 }
 /**
- * The client's authorization state was changed.
+ * A client's authorization state was changed.
+ *
+ * ```
+ * client.on("authorizationState", (ctx) => {
+ *   if (ctx.authorizationState.authorized) {
+ *     const me = await ctx.client.getMe();
+ *     console.log("The client is now authorized as", me.firstName);
+ *   } else {
+ *     console.log("The client is no longer authorized.")
+ *   }
+ * });
+ * ```
  * @unlisted
  */
 export interface UpdateAuthorizationState {
@@ -26,6 +43,23 @@ export interface UpdateAuthorizationState {
 }
 /**
  * A message was sent or received.
+ *
+ * ```
+ * // Handle text messages
+ * client.on("message:text", (ctx) => {
+ *   const receivedOrSent = ctx.message.out ? "sent" : "received";
+ *   console.log("Just", receivedOrSent, "a text message:", ctx.message.text);
+ * });
+ *
+ * // Handle other messages
+ * client.on("message", (ctx) => {
+ *   if (ctx.message.out) {
+ *    console.log("Just sent a message.");
+ *   }
+ * });
+ * ```
+ *
+ * Note that updates on outgoing messages are disabled by default for bots.
  * @unlisted
  */
 export interface UpdateNewMessage {
@@ -34,6 +68,13 @@ export interface UpdateNewMessage {
 }
 /**
  * A message was edited.
+ *
+ * ```
+ * client.on("editedMessage", (ctx) => {
+ *   console.log("A message was just edited.");
+ *   // ctx.editedMessage
+ * });
+ * ```
  * @unlisted
  */
 export interface UpdateEditedMessage {
@@ -42,6 +83,14 @@ export interface UpdateEditedMessage {
 }
 /**
  * One or more messages were deleted.
+ *
+ * ```
+ * client.on("deletedMessages", (ctx) => {
+ *   for (const deletedMessage of ctx.deletedMessages) {
+ *     console.log(deletedMessage);
+ *   }
+ * });
+ * ```
  * @unlisted
  */
 export interface UpdateDeletedMessages {
@@ -49,7 +98,13 @@ export interface UpdateDeletedMessages {
     deletedMessages: MessageIdentifier[];
 }
 /**
- * A callback query was received. Bot-only.
+ * A callback query was made (a user presses an inline button). Bot-only.
+ *
+ * ```
+ * client.on("callbackQuery", async (ctx) => {
+ *   await ctx.answerCallbackQuery(ctx.callbackQuery.data, { alert: true });
+ * });
+ * ```
  * @unlisted
  */
 export interface UpdateCallbackQuery {
@@ -58,6 +113,13 @@ export interface UpdateCallbackQuery {
 }
 /**
  * An inline query was received. Bot-only.
+ *
+ * ```
+ * client.on("inlineQuery", (ctx) => {
+ *   const { from, query } = ctx.inlineQuery;
+ *   console.log("User", from.id, "sent an inline query:", query);
+ * });
+ * ```
  * @unlisted
  */
 export interface UpdateInlineQuery {
@@ -65,15 +127,15 @@ export interface UpdateInlineQuery {
     inlineQuery: InlineQuery;
 }
 /**
- * An inline result was chosen. Bot-only.
+ * An inline query result was chosen. Bot-only.
  * @unlisted
  */
 export interface UpdateChosenInlineResult {
-    /** The chosen inline result. */
+    /** The chosen inline query result. */
     chosenInlineResult: ChosenInlineResult;
 }
 /**
- * A new chat was added. User-only.
+ * A new chat was added to the chat list. User-only.
  * @unlisted
  */
 export interface UpdateNewChat {
@@ -81,14 +143,14 @@ export interface UpdateNewChat {
     newChat: Chat;
 }
 /**
- * A chat was deleted. User-only.
+ * A chat in the chat list was edited. User-only.
  * @unlisted
  */
 export interface UpdateEditedChat {
     editedChat: Chat;
 }
 /**
- * A chat was deleted. User-only.
+ * A chat was removed from the chat list. User-only.
  * @unlisted
  */
 export interface UpdateDeletedChat {