@mtcute/core 0.27.1 → 0.27.2

package/highlevel/client.test.d.cts

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

package/highlevel/client.test.d.ts

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

package/highlevel/methods/contacts/set-contact-note.cjs

@@ -0,0 +1,21 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS bundles are deprecated. They will be removed completely in one of the upcoming releases. No support is provided for CommonJS users. 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");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+require("@mtcute/tl-runtime");
+const resolvePeer = require("../users/resolve-peer.cjs");
+const entities = require("../../types/misc/entities.cjs");
+async function setContactNote(client, userId, note) {
+  const peer = await resolvePeer.resolveUser(client, userId);
+  const r = await client.call({
+    _: "contacts.updateContactNote",
+    id: peer,
+    note: entities.inputTextToTl(note)
+  });
+  typeAssertions.assertTrue("contacts.updateContactNote", r);
+}
+exports.setContactNote = setContactNote;

package/highlevel/methods/contacts/set-contact-note.js

@@ -0,0 +1,16 @@
+import { assertTrue } from "../../../utils/type-assertions.js";
+import "@mtcute/tl-runtime";
+import { resolveUser } from "../users/resolve-peer.js";
+import { inputTextToTl } from "../../types/misc/entities.js";
+async function setContactNote(client, userId, note) {
+  const peer = await resolveUser(client, userId);
+  const r = await client.call({
+    _: "contacts.updateContactNote",
+    id: peer,
+    note: inputTextToTl(note)
+  });
+  assertTrue("contacts.updateContactNote", r);
+}
+export {
+  setContactNote
+};

package/highlevel/methods/files/download-chunk.cjs

@@ -0,0 +1,63 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS bundles are deprecated. They will be removed completely in one of the upcoming releases. No support is provided for CommonJS users. 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");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
+const tl = require("@mtcute/tl");
+const errors = require("../../../types/errors.cjs");
+const downloadIterable = require("./download-iterable.cjs");
+async function downloadChunk(client, params) {
+  const { location: input, dcId, offset, limit, maxRetryCount, floodSleepThreshold, abortSignal } = params;
+  const normalized = await downloadIterable._normalizeFileDownloadLocation(client, input);
+  const location = normalized.location;
+  if (tl.tl.isAnyInputWebFileLocation(location)) {
+    throw new errors.MtUnsupportedError("Web file locations are not supported for chunked downloads");
+  }
+  if (ArrayBuffer.isView(location)) {
+    throw new errors.MtArgumentError("Inline file locations are not supported for chunked downloads");
+  }
+  let alignedOffset = offset;
+  let alignedLimit = limit;
+  if (alignedOffset % 1024 !== 0) {
+    alignedOffset = Math.floor(alignedOffset / 1024) * 1024;
+  }
+  const stripStart = offset - alignedOffset;
+  if (stripStart > 0) {
+    alignedLimit += 1024 - stripStart;
+  }
+  if (alignedLimit % 1024 !== 0) {
+    alignedLimit = Math.ceil(alignedLimit / 1024) * 1024;
+  }
+  if (alignedLimit > 1048576) {
+    throw new errors.MtArgumentError(`Limit (${alignedLimit}) is too large for chunked downloads`);
+  }
+  const stripEnd = alignedLimit - limit - stripStart;
+  const result = await client.call(
+    {
+      _: "upload.getFile",
+      location,
+      offset: alignedOffset,
+      limit: alignedLimit,
+      precise: true
+    },
+    {
+      dcId,
+      maxRetryCount,
+      floodSleepThreshold,
+      abortSignal
+    }
+  );
+  utils.assert(result._ === "upload.file");
+  let bytes = result.bytes;
+  if (stripStart > 0) {
+    bytes = bytes.subarray(stripStart);
+  }
+  if (stripEnd > 0) {
+    bytes = bytes.subarray(0, -stripEnd);
+  }
+  return bytes;
+}
+exports.downloadChunk = downloadChunk;

package/highlevel/methods/files/download-chunk.d.cts

@@ -0,0 +1,29 @@
+import { ITelegramClient } from '../../client.types.js';
+import { FileDownloadLocation } from '../../types/index.js';
+/**
+ * Download a single chunk of a file, using [`precise`](https://core.telegram.org/api/files#downloading-files) download mode
+ *
+ * @param params  Download parameters
+ */
+export declare function downloadChunk(client: ITelegramClient, params: {
+    /** File from which to download a chunk */
+    location: FileDownloadLocation;
+    /**
+     * DC id from which the file will be downloaded.
+     *
+     * If provided DC is not the one storing the file,
+     * redirection will be handled automatically.
+     */
+    dcId?: number;
+    /** Offset of the chunk in bytes */
+    offset: number;
+    /**
+     * Number of bytes to download (starting from the offset)
+     *
+     * Max 1MB (1048576)
+     */
+    limit: number;
+    maxRetryCount?: number;
+    floodSleepThreshold?: number;
+    abortSignal?: AbortSignal;
+}): Promise<Uint8Array>;

package/highlevel/methods/files/download-chunk.d.ts

@@ -0,0 +1,29 @@
+import { ITelegramClient } from '../../client.types.js';
+import { FileDownloadLocation } from '../../types/index.js';
+/**
+ * Download a single chunk of a file, using [`precise`](https://core.telegram.org/api/files#downloading-files) download mode
+ *
+ * @param params  Download parameters
+ */
+export declare function downloadChunk(client: ITelegramClient, params: {
+    /** File from which to download a chunk */
+    location: FileDownloadLocation;
+    /**
+     * DC id from which the file will be downloaded.
+     *
+     * If provided DC is not the one storing the file,
+     * redirection will be handled automatically.
+     */
+    dcId?: number;
+    /** Offset of the chunk in bytes */
+    offset: number;
+    /**
+     * Number of bytes to download (starting from the offset)
+     *
+     * Max 1MB (1048576)
+     */
+    limit: number;
+    maxRetryCount?: number;
+    floodSleepThreshold?: number;
+    abortSignal?: AbortSignal;
+}): Promise<Uint8Array>;

package/highlevel/methods/files/download-chunk.js

@@ -0,0 +1,58 @@
+import { assert } from "@fuman/utils";
+import { tl } from "@mtcute/tl";
+import { MtUnsupportedError, MtArgumentError } from "../../../types/errors.js";
+import { _normalizeFileDownloadLocation } from "./download-iterable.js";
+async function downloadChunk(client, params) {
+  const { location: input, dcId, offset, limit, maxRetryCount, floodSleepThreshold, abortSignal } = params;
+  const normalized = await _normalizeFileDownloadLocation(client, input);
+  const location = normalized.location;
+  if (tl.isAnyInputWebFileLocation(location)) {
+    throw new MtUnsupportedError("Web file locations are not supported for chunked downloads");
+  }
+  if (ArrayBuffer.isView(location)) {
+    throw new MtArgumentError("Inline file locations are not supported for chunked downloads");
+  }
+  let alignedOffset = offset;
+  let alignedLimit = limit;
+  if (alignedOffset % 1024 !== 0) {
+    alignedOffset = Math.floor(alignedOffset / 1024) * 1024;
+  }
+  const stripStart = offset - alignedOffset;
+  if (stripStart > 0) {
+    alignedLimit += 1024 - stripStart;
+  }
+  if (alignedLimit % 1024 !== 0) {
+    alignedLimit = Math.ceil(alignedLimit / 1024) * 1024;
+  }
+  if (alignedLimit > 1048576) {
+    throw new MtArgumentError(`Limit (${alignedLimit}) is too large for chunked downloads`);
+  }
+  const stripEnd = alignedLimit - limit - stripStart;
+  const result = await client.call(
+    {
+      _: "upload.getFile",
+      location,
+      offset: alignedOffset,
+      limit: alignedLimit,
+      precise: true
+    },
+    {
+      dcId,
+      maxRetryCount,
+      floodSleepThreshold,
+      abortSignal
+    }
+  );
+  assert(result._ === "upload.file");
+  let bytes = result.bytes;
+  if (stripStart > 0) {
+    bytes = bytes.subarray(stripStart);
+  }
+  if (stripEnd > 0) {
+    bytes = bytes.subarray(0, -stripEnd);
+  }
+  return bytes;
+}
+export {
+  downloadChunk
+};

package/highlevel/methods/files/download-chunk.test.d.cts

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

package/highlevel/methods/files/download-chunk.test.d.ts

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

package/highlevel/methods/files/download-iterable.cjs

@@ -8,36 +8,26 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("@fuman/utils");
 const fileId = require("@mtcute/file-id");
 const tl = require("@mtcute/tl");
-const errors = require("../../../types/errors.cjs");
+const errors$1 = require("../../../types/errors.cjs");
 const peerUtils = require("../../../utils/peer-utils.cjs");
 const convertFileId = require("../../utils/convert-file-id.cjs");
 const fileUtils = require("../../utils/file-utils.cjs");
 const fileLocation = require("../../types/files/file-location.cjs");
-const errors$1 = require("../../types/errors.cjs");
+const errors = require("../../types/errors.cjs");
 const SMALL_FILE_MAX_SIZE = 131072;
 const REQUESTS_PER_CONNECTION = 3;
-async function* downloadAsIterable(client, input, params) {
-  const offset = params?.offset ?? 0;
-  if (offset % 4096 !== 0) {
-    throw new errors.MtArgumentError(`Invalid offset: ${offset}. Must be divisible by 4096`);
-  }
-  let dcId = params?.dcId;
-  let fileSize = params?.fileSize;
-  const abortSignal = params?.abortSignal;
-  let ended = false;
+async function _normalizeFileDownloadLocation(client, input) {
   let location;
   if (input instanceof fileLocation.FileLocation) {
     let locationInner = input.location;
     if (typeof locationInner === "function") {
       locationInner = locationInner();
     }
-    if (ArrayBuffer.isView(locationInner)) {
-      yield locationInner;
-      return;
-    }
-    if (!dcId) dcId = input.dcId;
-    if (!fileSize) fileSize = input.fileSize;
-    location = locationInner;
+    return {
+      location: locationInner,
+      dcId: input.dcId,
+      fileSize: input.fileSize
+    };
   } else if (typeof input === "string") {
     const parsed = fileId.parseFileId(input);
     if (parsed.location._ === "web") {
@@ -48,13 +38,12 @@ async function* downloadAsIterable(client, input, params) {
   } else {
     location = input;
   }
-  const isWeb = tl.tl.isAnyInputWebFileLocation(location);
   if (location._ === "inputPeerPhotoFileLocation") {
     if (location.peer._ === "mtcute.dummyInputPeerMinUser" || location.peer._ === "mtcute.dummyInputPeerMinChannel") {
       const peerId = location.peer._ === "mtcute.dummyInputPeerMinUser" ? location.peer.userId : peerUtils.toggleChannelIdMark(location.peer.channelId);
       const accessHash = await client.storage.peers.getMinAccessHash(peerId);
       if (!accessHash) {
-        throw new errors$1.MtPeerNotFoundError(`Peer ${peerId} not found`);
+        throw new errors.MtPeerNotFoundError(`Peer ${peerId} not found`);
       }
       location = {
         _: "inputPeerPhotoFileLocation",
@@ -72,15 +61,41 @@ async function* downloadAsIterable(client, input, params) {
       };
     }
   }
+  return { location };
+}
+async function* downloadAsIterable(client, input, params) {
+  const offset = params?.offset ?? 0;
+  if (offset % 4096 !== 0) {
+    throw new errors$1.MtArgumentError(`Invalid offset: ${offset}. Must be divisible by 4096`);
+  }
+  const normalized = await _normalizeFileDownloadLocation(client, input);
+  const fileSize = params?.fileSize ?? normalized.fileSize;
+  const location = normalized.location;
+  if (ArrayBuffer.isView(location)) {
+    yield location;
+    return;
+  }
+  const isWeb = tl.tl.isAnyInputWebFileLocation(location);
+  let dcId = params?.dcId ?? normalized?.dcId;
   const primaryDcId = await client.getPrimaryDcId();
   if (!dcId) dcId = primaryDcId;
+  const abortSignal = params?.abortSignal;
+  let ended = false;
   const partSizeKb = params?.partSize ?? (fileSize ? fileUtils.determinePartSize(fileSize) : 64);
   if (partSizeKb % 4 !== 0) {
-    throw new errors.MtArgumentError(`Invalid part size: ${partSizeKb}. Must be divisible by 4.`);
+    throw new errors$1.MtArgumentError(`Invalid part size: ${partSizeKb}. Must be divisible by 4.`);
   }
   const chunkSize = partSizeKb * 1024;
   let limitBytes = params?.limit ?? fileSize ?? Infinity;
   if (limitBytes === 0) return;
+  if (limitBytes !== Infinity && limitBytes !== fileSize) {
+    if (limitBytes % 4096 !== 0) {
+      throw new errors$1.MtArgumentError(`Invalid limit: ${limitBytes}. Must be divisible by 4096.`);
+    }
+    if (1048576 % limitBytes !== 0) {
+      throw new errors$1.MtArgumentError(`Invalid limit: ${limitBytes}. Must be a multiple of 1MB.`);
+    }
+  }
   let numChunks = limitBytes === Infinity ? Infinity : ~~((limitBytes + chunkSize - offset - 1) / chunkSize);
   let nextChunkIdx = 0;
   let nextWorkerChunkIdx = 0;
@@ -131,7 +146,7 @@ async function* downloadAsIterable(client, input, params) {
         dcId = e.newDc;
         return downloadChunk(chunk);
       } else if (e.is("FILEREF_UPGRADE_NEEDED")) {
-        throw new errors.MtUnsupportedError("File ref expired!");
+        throw new errors$1.MtUnsupportedError("File ref expired!");
       } else if (e.is("MTPROTO_CLUSTER_INVALID") && dcId != null) {
         client.log.debug("received cluster invalid error for dc %d, recreating dc", dcId);
         await client.recreateDc(dcId);
@@ -141,7 +156,7 @@ async function* downloadAsIterable(client, input, params) {
       }
     }
     if (result._ === "upload.fileCdnRedirect") {
-      throw new errors.MtUnsupportedError("Received CDN redirect, which is not supported (yet)");
+      throw new errors$1.MtUnsupportedError("Received CDN redirect, which is not supported (yet)");
     }
     if (ended) {
       return;
@@ -192,4 +207,5 @@ async function* downloadAsIterable(client, input, params) {
     }
   }
 }
+exports._normalizeFileDownloadLocation = _normalizeFileDownloadLocation;
 exports.downloadAsIterable = downloadAsIterable;

package/highlevel/methods/files/download-iterable.d.cts

@@ -1,5 +1,11 @@
 import { ITelegramClient } from '../../client.types.js';
 import { FileDownloadLocation, FileDownloadParameters } from '../../types/index.js';
+import { tl } from '@mtcute/tl';
+export declare function _normalizeFileDownloadLocation(client: ITelegramClient, input: FileDownloadLocation): Promise<{
+    location: tl.TypeInputFileLocation | tl.TypeInputWebFileLocation | Uint8Array<ArrayBufferLike>;
+    dcId?: number;
+    fileSize?: number;
+}>;
 /**
  * Download a file and return it as an iterable, which yields file contents
  * in chunks of a given size. Order of the chunks is guaranteed to be

package/highlevel/methods/files/download-iterable.d.ts

@@ -1,5 +1,11 @@
 import { ITelegramClient } from '../../client.types.js';
 import { FileDownloadLocation, FileDownloadParameters } from '../../types/index.js';
+import { tl } from '@mtcute/tl';
+export declare function _normalizeFileDownloadLocation(client: ITelegramClient, input: FileDownloadLocation): Promise<{
+    location: tl.TypeInputFileLocation | tl.TypeInputWebFileLocation | Uint8Array<ArrayBufferLike>;
+    dcId?: number;
+    fileSize?: number;
+}>;
 /**
  * Download a file and return it as an iterable, which yields file contents
  * in chunks of a given size. Order of the chunks is guaranteed to be

package/highlevel/methods/files/download-iterable.js

@@ -9,28 +9,18 @@ import { FileLocation as FileLocation$1 } from "../../types/files/file-location.
 import { MtPeerNotFoundError } from "../../types/errors.js";
 const SMALL_FILE_MAX_SIZE = 131072;
 const REQUESTS_PER_CONNECTION = 3;
-async function* downloadAsIterable(client, input, params) {
-  const offset = params?.offset ?? 0;
-  if (offset % 4096 !== 0) {
-    throw new MtArgumentError(`Invalid offset: ${offset}. Must be divisible by 4096`);
-  }
-  let dcId = params?.dcId;
-  let fileSize = params?.fileSize;
-  const abortSignal = params?.abortSignal;
-  let ended = false;
+async function _normalizeFileDownloadLocation(client, input) {
   let location;
   if (input instanceof FileLocation$1) {
     let locationInner = input.location;
     if (typeof locationInner === "function") {
       locationInner = locationInner();
     }
-    if (ArrayBuffer.isView(locationInner)) {
-      yield locationInner;
-      return;
-    }
-    if (!dcId) dcId = input.dcId;
-    if (!fileSize) fileSize = input.fileSize;
-    location = locationInner;
+    return {
+      location: locationInner,
+      dcId: input.dcId,
+      fileSize: input.fileSize
+    };
   } else if (typeof input === "string") {
     const parsed = parseFileId(input);
     if (parsed.location._ === "web") {
@@ -41,7 +31,6 @@ async function* downloadAsIterable(client, input, params) {
   } else {
     location = input;
   }
-  const isWeb = tl.isAnyInputWebFileLocation(location);
   if (location._ === "inputPeerPhotoFileLocation") {
     if (location.peer._ === "mtcute.dummyInputPeerMinUser" || location.peer._ === "mtcute.dummyInputPeerMinChannel") {
       const peerId = location.peer._ === "mtcute.dummyInputPeerMinUser" ? location.peer.userId : toggleChannelIdMark(location.peer.channelId);
@@ -65,8 +54,26 @@ async function* downloadAsIterable(client, input, params) {
       };
     }
   }
+  return { location };
+}
+async function* downloadAsIterable(client, input, params) {
+  const offset = params?.offset ?? 0;
+  if (offset % 4096 !== 0) {
+    throw new MtArgumentError(`Invalid offset: ${offset}. Must be divisible by 4096`);
+  }
+  const normalized = await _normalizeFileDownloadLocation(client, input);
+  const fileSize = params?.fileSize ?? normalized.fileSize;
+  const location = normalized.location;
+  if (ArrayBuffer.isView(location)) {
+    yield location;
+    return;
+  }
+  const isWeb = tl.isAnyInputWebFileLocation(location);
+  let dcId = params?.dcId ?? normalized?.dcId;
   const primaryDcId = await client.getPrimaryDcId();
   if (!dcId) dcId = primaryDcId;
+  const abortSignal = params?.abortSignal;
+  let ended = false;
   const partSizeKb = params?.partSize ?? (fileSize ? determinePartSize(fileSize) : 64);
   if (partSizeKb % 4 !== 0) {
     throw new MtArgumentError(`Invalid part size: ${partSizeKb}. Must be divisible by 4.`);
@@ -74,6 +81,14 @@ async function* downloadAsIterable(client, input, params) {
   const chunkSize = partSizeKb * 1024;
   let limitBytes = params?.limit ?? fileSize ?? Infinity;
   if (limitBytes === 0) return;
+  if (limitBytes !== Infinity && limitBytes !== fileSize) {
+    if (limitBytes % 4096 !== 0) {
+      throw new MtArgumentError(`Invalid limit: ${limitBytes}. Must be divisible by 4096.`);
+    }
+    if (1048576 % limitBytes !== 0) {
+      throw new MtArgumentError(`Invalid limit: ${limitBytes}. Must be a multiple of 1MB.`);
+    }
+  }
   let numChunks = limitBytes === Infinity ? Infinity : ~~((limitBytes + chunkSize - offset - 1) / chunkSize);
   let nextChunkIdx = 0;
   let nextWorkerChunkIdx = 0;
@@ -186,5 +201,6 @@ async function* downloadAsIterable(client, input, params) {
   }
 }
 export {
+  _normalizeFileDownloadLocation,
   downloadAsIterable
 };

package/highlevel/methods/forums/reorder-pinned-forum-topics.cjs

@@ -9,8 +9,8 @@ const resolvePeer = require("../users/resolve-peer.cjs");
 async function reorderPinnedForumTopics(client, params) {
   const { chatId, order, force } = params;
   await client.call({
-    _: "channels.reorderPinnedForumTopics",
-    channel: await resolvePeer.resolveChannel(client, chatId),
+    _: "messages.reorderPinnedForumTopics",
+    peer: await resolvePeer.resolvePeer(client, chatId),
     order: order.map((it) => typeof it === "number" ? it : it.id),
     force
   });

package/highlevel/methods/forums/reorder-pinned-forum-topics.js

@@ -1,9 +1,9 @@
-import { resolveChannel } from "../users/resolve-peer.js";
+import { resolvePeer } from "../users/resolve-peer.js";
 async function reorderPinnedForumTopics(client, params) {
   const { chatId, order, force } = params;
   await client.call({
-    _: "channels.reorderPinnedForumTopics",
-    channel: await resolveChannel(client, chatId),
+    _: "messages.reorderPinnedForumTopics",
+    peer: await resolvePeer(client, chatId),
     order: order.map((it) => typeof it === "number" ? it : it.id),
     force
   });

package/highlevel/methods/forums/toggle-forum-topic-closed.cjs

@@ -10,8 +10,8 @@ const resolvePeer = require("../users/resolve-peer.cjs");
 async function toggleForumTopicClosed(client, parmas) {
   const { chatId, topicId, closed, shouldDispatch } = parmas;
   const res = await client.call({
-    _: "channels.editForumTopic",
-    channel: await resolvePeer.resolveChannel(client, chatId),
+    _: "messages.editForumTopic",
+    peer: await resolvePeer.resolvePeer(client, chatId),
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     closed
   });

package/highlevel/methods/forums/toggle-forum-topic-closed.js

@@ -1,10 +1,10 @@
 import { _findMessageInUpdate } from "../messages/find-in-update.js";
-import { resolveChannel } from "../users/resolve-peer.js";
+import { resolvePeer } from "../users/resolve-peer.js";
 async function toggleForumTopicClosed(client, parmas) {
   const { chatId, topicId, closed, shouldDispatch } = parmas;
   const res = await client.call({
-    _: "channels.editForumTopic",
-    channel: await resolveChannel(client, chatId),
+    _: "messages.editForumTopic",
+    peer: await resolvePeer(client, chatId),
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     closed
   });

package/highlevel/methods/forums/toggle-forum-topic-pinned.cjs

@@ -9,8 +9,8 @@ const resolvePeer = require("../users/resolve-peer.cjs");
 async function toggleForumTopicPinned(client, params) {
   const { chatId, topicId, pinned } = params;
   await client.call({
-    _: "channels.updatePinnedForumTopic",
-    channel: await resolvePeer.resolveChannel(client, chatId),
+    _: "messages.updatePinnedForumTopic",
+    peer: await resolvePeer.resolvePeer(client, chatId),
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     pinned
   });

package/highlevel/methods/forums/toggle-forum-topic-pinned.js

@@ -1,9 +1,9 @@
-import { resolveChannel } from "../users/resolve-peer.js";
+import { resolvePeer } from "../users/resolve-peer.js";
 async function toggleForumTopicPinned(client, params) {
   const { chatId, topicId, pinned } = params;
   await client.call({
-    _: "channels.updatePinnedForumTopic",
-    channel: await resolveChannel(client, chatId),
+    _: "messages.updatePinnedForumTopic",
+    peer: await resolvePeer(client, chatId),
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     pinned
   });

package/highlevel/methods.d.cts

@@ -86,6 +86,7 @@ export { addContact } from './methods/contacts/add-contact.js';
 export { deleteContacts } from './methods/contacts/delete-contacts.js';
 export { getContacts } from './methods/contacts/get-contacts.js';
 export { importContacts } from './methods/contacts/import-contacts.js';
+export { setContactNote } from './methods/contacts/set-contact-note.js';
 export { createFolder } from './methods/dialogs/create-folder.js';
 export { deleteFolder } from './methods/dialogs/delete-folder.js';
 export { editFolder } from './methods/dialogs/edit-folder.js';
@@ -98,6 +99,8 @@ export { iterDialogs } from './methods/dialogs/iter-dialogs.js';
 export { joinChatlist } from './methods/dialogs/join-chatlist.js';
 export { setFoldersOrder } from './methods/dialogs/set-folders-order.js';
 export { downloadAsBuffer } from './methods/files/download-buffer.js';
+export { downloadChunk } from './methods/files/download-chunk.js';
+export { _normalizeFileDownloadLocation } from './methods/files/download-iterable.js';
 export { downloadAsIterable } from './methods/files/download-iterable.js';
 export { downloadAsStream } from './methods/files/download-stream.js';
 export { _normalizeInputFile } from './methods/files/normalize-input-file.js';

package/highlevel/methods.d.ts

@@ -86,6 +86,7 @@ export { addContact } from './methods/contacts/add-contact.js';
 export { deleteContacts } from './methods/contacts/delete-contacts.js';
 export { getContacts } from './methods/contacts/get-contacts.js';
 export { importContacts } from './methods/contacts/import-contacts.js';
+export { setContactNote } from './methods/contacts/set-contact-note.js';
 export { createFolder } from './methods/dialogs/create-folder.js';
 export { deleteFolder } from './methods/dialogs/delete-folder.js';
 export { editFolder } from './methods/dialogs/edit-folder.js';
@@ -98,6 +99,8 @@ export { iterDialogs } from './methods/dialogs/iter-dialogs.js';
 export { joinChatlist } from './methods/dialogs/join-chatlist.js';
 export { setFoldersOrder } from './methods/dialogs/set-folders-order.js';
 export { downloadAsBuffer } from './methods/files/download-buffer.js';
+export { downloadChunk } from './methods/files/download-chunk.js';
+export { _normalizeFileDownloadLocation } from './methods/files/download-iterable.js';
 export { downloadAsIterable } from './methods/files/download-iterable.js';
 export { downloadAsStream } from './methods/files/download-stream.js';
 export { _normalizeInputFile } from './methods/files/normalize-input-file.js';

package/highlevel/types/premium/star-gift.cjs

@@ -34,13 +34,17 @@ class StarGift {
     return this.raw.requirePremium;
   }
   /** If this gift is currently sold through an auction, info about that auction. `null` otherwise */
-  get action() {
+  get auction() {
     if (!this.raw.auctionSlug || this.raw.giftsPerRound == null) return null;
     return {
       slug: this.raw.auctionSlug,
       giftsPerRound: this.raw.giftsPerRound
     };
   }
+  /** @deprecated Use {@link auction} instead (typo in older versions) */
+  get action() {
+    return this.auction;
+  }
   /** Whether this gift includes a peer color that can be applied to user's profile */
   get hasPeerColor() {
     return this.raw.peerColorAvailable;

package/highlevel/types/premium/star-gift.d.cts

@@ -29,10 +29,12 @@ export declare class StarGift {
     /** Whether this gift is available only to premium users */
     get isPremiumOnly(): boolean;
     /** If this gift is currently sold through an auction, info about that auction. `null` otherwise */
-    get action(): {
+    get auction(): {
         slug: string;
         giftsPerRound: number;
     } | null;
+    /** @deprecated Use {@link auction} instead (typo in older versions) */
+    get action(): this['auction'];
     /** Whether this gift includes a peer color that can be applied to user's profile */
     get hasPeerColor(): boolean;
     /** Whether this gift is a unique gift */

package/highlevel/types/premium/star-gift.d.ts

@@ -29,10 +29,12 @@ export declare class StarGift {
     /** Whether this gift is available only to premium users */
     get isPremiumOnly(): boolean;
     /** If this gift is currently sold through an auction, info about that auction. `null` otherwise */
-    get action(): {
+    get auction(): {
         slug: string;
         giftsPerRound: number;
     } | null;
+    /** @deprecated Use {@link auction} instead (typo in older versions) */
+    get action(): this['auction'];
     /** Whether this gift includes a peer color that can be applied to user's profile */
     get hasPeerColor(): boolean;
     /** Whether this gift is a unique gift */