@mtcute/core 0.25.7 → 0.26.0

package/highlevel/methods/premium/get-stars-transactions.cjs

@@ -8,7 +8,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const starsStatus = require("../../types/premium/stars-status.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
 async function getStarsTransactions(client, peerId, params) {
-  const { direction, sort, subscriptionId, offset = "", limit = 100 } = params ?? {};
+  const { direction, sort, subscriptionId, offset = "", limit = 100, ton } = params ?? {};
   const res = await client.call({
     _: "payments.getStarsTransactions",
     peer: await resolvePeer.resolvePeer(client, peerId),
@@ -17,7 +17,8 @@ async function getStarsTransactions(client, peerId, params) {
     outbound: direction === "outgoing",
     inbound: direction === "incoming",
     ascending: sort === "asc",
-    subscriptionId
+    subscriptionId,
+    ton
   });
   return new starsStatus.StarsStatus(res);
 }

package/highlevel/methods/premium/get-stars-transactions.d.cts

@@ -25,6 +25,8 @@ export declare function getStarsTransactions(client: ITelegramClient, peerId: In
     subscriptionId?: string;
     /** Pagination offset */
     offset?: string;
+    /** Whether to return transactions made in TON */
+    ton?: boolean;
     /**
      * Pagination limit
      *

package/highlevel/methods/premium/get-stars-transactions.d.ts

@@ -25,6 +25,8 @@ export declare function getStarsTransactions(client: ITelegramClient, peerId: In
     subscriptionId?: string;
     /** Pagination offset */
     offset?: string;
+    /** Whether to return transactions made in TON */
+    ton?: boolean;
     /**
      * Pagination limit
      *

package/highlevel/methods/premium/get-stars-transactions.js

@@ -1,7 +1,7 @@
 import { StarsStatus as StarsStatus$2 } from "../../types/premium/stars-status.js";
 import { resolvePeer } from "../users/resolve-peer.js";
 async function getStarsTransactions(client, peerId, params) {
-  const { direction, sort, subscriptionId, offset = "", limit = 100 } = params ?? {};
+  const { direction, sort, subscriptionId, offset = "", limit = 100, ton } = params ?? {};
   const res = await client.call({
     _: "payments.getStarsTransactions",
     peer: await resolvePeer(client, peerId),
@@ -10,7 +10,8 @@ async function getStarsTransactions(client, peerId, params) {
     outbound: direction === "outgoing",
     inbound: direction === "incoming",
     ascending: sort === "asc",
-    subscriptionId
+    subscriptionId,
+    ton
   });
   return new StarsStatus$2(res);
 }

package/highlevel/methods/premium/iter-saved-star-gifts.cjs

@@ -9,25 +9,30 @@ const savedStarGift = require("../../types/premium/saved-star-gift.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
 const peersIndex = require("../../types/peers/peers-index.cjs");
 async function* iterSavedStarGifts(client, params) {
-  const owner = await resolvePeer.resolvePeer(client, params.owner);
-  let offset = "";
+  const {
+    owner,
+    offset: offsetInitial = "",
+    chunkSize = 100,
+    limit = Infinity,
+    ...rest
+  } = params;
+  const ownerPeer = await resolvePeer.resolvePeer(client, owner);
+  let offset = offsetInitial;
+  let current = 0;
   while (true) {
     const res = await client.call({
       _: "payments.getSavedStarGifts",
-      peer: owner,
-      excludeUnsaved: params.excludeUnsaved,
-      excludeSaved: params.excludeSaved,
-      excludeUnlimited: params.excludeUnlimited,
-      excludeLimited: params.excludeLimited,
-      excludeUnique: params.excludeUnique,
-      sortByValue: params.sortByValue,
+      peer: ownerPeer,
       offset,
-      limit: params.limit ?? 100
+      limit: Math.min(chunkSize, limit - current),
+      ...rest
     });
     const peers = peersIndex.PeersIndex.from(res);
     yield* res.gifts.map((it) => new savedStarGift.SavedStarGift(it, peers));
     if (!res.nextOffset) break;
     offset = res.nextOffset;
+    current += res.gifts.length;
+    if (current >= limit) break;
   }
 }
 exports.iterSavedStarGifts = iterSavedStarGifts;

package/highlevel/methods/premium/iter-saved-star-gifts.d.cts

@@ -1,27 +1,21 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike } from '../../types/index.js';
+import { getSavedStarGifts } from './get-saved-star-gifts.js';
 import { SavedStarGift } from '../../types/premium/saved-star-gift.js';
 /**
  * Iterate over saved star gifts of a user,
  * wrapper over {@link getSavedStarGifts}
  */
-export declare function iterSavedStarGifts(client: ITelegramClient, params: {
-    /** Peer to get saved gifts from */
-    owner: InputPeerLike;
-    /** Whether to exclude unsaved gifts */
-    excludeUnsaved?: boolean;
-    /** Whether to exclude saved gifts */
-    excludeSaved?: boolean;
-    /** Whether to exclude gifts with unlimited availability */
-    excludeUnlimited?: boolean;
-    /** Whether to exclude gifts with limited availability */
-    excludeLimited?: boolean;
-    /** Whether to exclude unique gifts */
-    excludeUnique?: boolean;
-    /** Whether to sort by value */
-    sortByValue?: boolean;
-    /** Offset for pagination */
-    offset?: string;
-    /** Limit for pagination */
+export declare function iterSavedStarGifts(client: ITelegramClient, params: Parameters<typeof getSavedStarGifts>[1] & {
+    /**
+     * Number of gifts to fetch per request
+     *
+     * @default 100
+     */
+    chunkSize?: number;
+    /**
+     * Total number of gifts to fetch
+     *
+     * @default Infinity
+     */
     limit?: number;
 }): AsyncIterableIterator<SavedStarGift>;

package/highlevel/methods/premium/iter-saved-star-gifts.d.ts

@@ -1,27 +1,21 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike } from '../../types/index.js';
+import { getSavedStarGifts } from './get-saved-star-gifts.js';
 import { SavedStarGift } from '../../types/premium/saved-star-gift.js';
 /**
  * Iterate over saved star gifts of a user,
  * wrapper over {@link getSavedStarGifts}
  */
-export declare function iterSavedStarGifts(client: ITelegramClient, params: {
-    /** Peer to get saved gifts from */
-    owner: InputPeerLike;
-    /** Whether to exclude unsaved gifts */
-    excludeUnsaved?: boolean;
-    /** Whether to exclude saved gifts */
-    excludeSaved?: boolean;
-    /** Whether to exclude gifts with unlimited availability */
-    excludeUnlimited?: boolean;
-    /** Whether to exclude gifts with limited availability */
-    excludeLimited?: boolean;
-    /** Whether to exclude unique gifts */
-    excludeUnique?: boolean;
-    /** Whether to sort by value */
-    sortByValue?: boolean;
-    /** Offset for pagination */
-    offset?: string;
-    /** Limit for pagination */
+export declare function iterSavedStarGifts(client: ITelegramClient, params: Parameters<typeof getSavedStarGifts>[1] & {
+    /**
+     * Number of gifts to fetch per request
+     *
+     * @default 100
+     */
+    chunkSize?: number;
+    /**
+     * Total number of gifts to fetch
+     *
+     * @default Infinity
+     */
     limit?: number;
 }): AsyncIterableIterator<SavedStarGift>;

package/highlevel/methods/premium/iter-saved-star-gifts.js

@@ -2,25 +2,30 @@ import { SavedStarGift as SavedStarGift$2 } from "../../types/premium/saved-star
 import { resolvePeer } from "../users/resolve-peer.js";
 import { PeersIndex } from "../../types/peers/peers-index.js";
 async function* iterSavedStarGifts(client, params) {
-  const owner = await resolvePeer(client, params.owner);
-  let offset = "";
+  const {
+    owner,
+    offset: offsetInitial = "",
+    chunkSize = 100,
+    limit = Infinity,
+    ...rest
+  } = params;
+  const ownerPeer = await resolvePeer(client, owner);
+  let offset = offsetInitial;
+  let current = 0;
   while (true) {
     const res = await client.call({
       _: "payments.getSavedStarGifts",
-      peer: owner,
-      excludeUnsaved: params.excludeUnsaved,
-      excludeSaved: params.excludeSaved,
-      excludeUnlimited: params.excludeUnlimited,
-      excludeLimited: params.excludeLimited,
-      excludeUnique: params.excludeUnique,
-      sortByValue: params.sortByValue,
+      peer: ownerPeer,
       offset,
-      limit: params.limit ?? 100
+      limit: Math.min(chunkSize, limit - current),
+      ...rest
     });
     const peers = PeersIndex.from(res);
     yield* res.gifts.map((it) => new SavedStarGift$2(it, peers));
     if (!res.nextOffset) break;
     offset = res.nextOffset;
+    current += res.gifts.length;
+    if (current >= limit) break;
   }
 }
 export {

package/highlevel/methods/premium/prepay-star-gift-upgrade.cjs

@@ -0,0 +1,30 @@
+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");
+const findInUpdate = require("../messages/find-in-update.cjs");
+const resolvePeer = require("../users/resolve-peer.cjs");
+async function prepayStarGiftUpgrade(client, params) {
+  const { peer, hash, shouldDispatch } = params;
+  const invoice = {
+    _: "inputInvoiceStarGiftPrepaidUpgrade",
+    peer: await resolvePeer.resolvePeer(client, peer),
+    hash
+  };
+  const form = await client.call({
+    _: "payments.getPaymentForm",
+    invoice
+  });
+  const res = await client.call({
+    _: "payments.sendStarsForm",
+    invoice,
+    formId: form.formId
+  });
+  typeAssertions.assertTypeIs("payments.sendStarsForm", res, "payments.paymentResult");
+  return findInUpdate._findMessageInUpdate(client, res.updates, false, !shouldDispatch, true);
+}
+exports.prepayStarGiftUpgrade = prepayStarGiftUpgrade;

package/highlevel/methods/premium/prepay-star-gift-upgrade.d.cts

@@ -0,0 +1,23 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+import { Message } from '../../types/messages/message.js';
+/**
+ * Pay for other user's star gift upgrade.
+ *
+ * > **Note**: this method is not indended to be used by full-fledged clients,
+ * > as this method hides the actual invoice and payment form from the user.
+ * > For GUI clients, you should refer to the method's source code and
+ * > present the payment form to the user.
+ *
+ * @returns  Service message about the payment for the upgrade, if one was generated.
+ */
+export declare function prepayStarGiftUpgrade(client: ITelegramClient, params: {
+    peer: InputPeerLike;
+    /** Prepaid upgrade hash, taken from `SavedStarGift.prepaidUpgradeHash` */
+    hash: string;
+    /**
+     * Whether to dispatch the new message event
+     * to the client's update handler.
+     */
+    shouldDispatch?: true;
+}): Promise<Message | null>;

package/highlevel/methods/premium/prepay-star-gift-upgrade.d.ts

@@ -0,0 +1,23 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+import { Message } from '../../types/messages/message.js';
+/**
+ * Pay for other user's star gift upgrade.
+ *
+ * > **Note**: this method is not indended to be used by full-fledged clients,
+ * > as this method hides the actual invoice and payment form from the user.
+ * > For GUI clients, you should refer to the method's source code and
+ * > present the payment form to the user.
+ *
+ * @returns  Service message about the payment for the upgrade, if one was generated.
+ */
+export declare function prepayStarGiftUpgrade(client: ITelegramClient, params: {
+    peer: InputPeerLike;
+    /** Prepaid upgrade hash, taken from `SavedStarGift.prepaidUpgradeHash` */
+    hash: string;
+    /**
+     * Whether to dispatch the new message event
+     * to the client's update handler.
+     */
+    shouldDispatch?: true;
+}): Promise<Message | null>;

package/highlevel/methods/premium/prepay-star-gift-upgrade.js

@@ -0,0 +1,25 @@
+import { assertTypeIs } from "../../../utils/type-assertions.js";
+import { _findMessageInUpdate } from "../messages/find-in-update.js";
+import { resolvePeer } from "../users/resolve-peer.js";
+async function prepayStarGiftUpgrade(client, params) {
+  const { peer, hash, shouldDispatch } = params;
+  const invoice = {
+    _: "inputInvoiceStarGiftPrepaidUpgrade",
+    peer: await resolvePeer(client, peer),
+    hash
+  };
+  const form = await client.call({
+    _: "payments.getPaymentForm",
+    invoice
+  });
+  const res = await client.call({
+    _: "payments.sendStarsForm",
+    invoice,
+    formId: form.formId
+  });
+  assertTypeIs("payments.sendStarsForm", res, "payments.paymentResult");
+  return _findMessageInUpdate(client, res.updates, false, !shouldDispatch, true);
+}
+export {
+  prepayStarGiftUpgrade
+};

package/highlevel/methods/stickers/delete-sticker-from-set.d.cts

@@ -1,7 +1,5 @@
-import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
-import { tdFileId } from '@mtcute/file-id';
-import { StickerSet } from '../../types/index.js';
+import { InputDocumentId, StickerSet } from '../../types/index.js';
 /**
  * Delete a sticker from a sticker set
  *
@@ -12,4 +10,4 @@ import { StickerSet } from '../../types/index.js';
  *     TL object representing a sticker to be removed
  * @returns  Modfiied sticker set
  */
-export declare function deleteStickerFromSet(client: ITelegramClient, sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument): Promise<StickerSet>;
+export declare function deleteStickerFromSet(client: ITelegramClient, sticker: InputDocumentId): Promise<StickerSet>;

package/highlevel/methods/stickers/delete-sticker-from-set.d.ts

@@ -1,7 +1,5 @@
-import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
-import { tdFileId } from '@mtcute/file-id';
-import { StickerSet } from '../../types/index.js';
+import { InputDocumentId, StickerSet } from '../../types/index.js';
 /**
  * Delete a sticker from a sticker set
  *
@@ -12,4 +10,4 @@ import { StickerSet } from '../../types/index.js';
  *     TL object representing a sticker to be removed
  * @returns  Modfiied sticker set
  */
-export declare function deleteStickerFromSet(client: ITelegramClient, sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument): Promise<StickerSet>;
+export declare function deleteStickerFromSet(client: ITelegramClient, sticker: InputDocumentId): Promise<StickerSet>;

package/highlevel/methods/stickers/move-sticker-in-set.d.cts

@@ -1,7 +1,5 @@
-import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
-import { tdFileId } from '@mtcute/file-id';
-import { StickerSet } from '../../types/index.js';
+import { InputDocumentId, StickerSet } from '../../types/index.js';
 /**
  * Move a sticker in a sticker set
  * to another position
@@ -14,4 +12,4 @@ import { StickerSet } from '../../types/index.js';
  * @param position  New sticker position (starting from 0)
  * @returns  Modified sticker set
  */
-export declare function moveStickerInSet(client: ITelegramClient, sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument, position: number): Promise<StickerSet>;
+export declare function moveStickerInSet(client: ITelegramClient, sticker: InputDocumentId, position: number): Promise<StickerSet>;

package/highlevel/methods/stickers/move-sticker-in-set.d.ts

@@ -1,7 +1,5 @@
-import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
-import { tdFileId } from '@mtcute/file-id';
-import { StickerSet } from '../../types/index.js';
+import { InputDocumentId, StickerSet } from '../../types/index.js';
 /**
  * Move a sticker in a sticker set
  * to another position
@@ -14,4 +12,4 @@ import { StickerSet } from '../../types/index.js';
  * @param position  New sticker position (starting from 0)
  * @returns  Modified sticker set
  */
-export declare function moveStickerInSet(client: ITelegramClient, sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument, position: number): Promise<StickerSet>;
+export declare function moveStickerInSet(client: ITelegramClient, sticker: InputDocumentId, position: number): Promise<StickerSet>;

package/highlevel/methods/stickers/replace-sticker-in-set.d.cts

@@ -1,7 +1,5 @@
-import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
-import { InputStickerSetItem, StickerSet } from '../../types/index.js';
-import { tdFileId } from '@mtcute/file-id';
+import { InputDocumentId, InputStickerSetItem, StickerSet } from '../../types/index.js';
 /**
  * Replace a sticker in a sticker set with another sticker
  *
@@ -13,7 +11,7 @@ import { tdFileId } from '@mtcute/file-id';
  * @param newSticker  New sticker to replace the old one with
  * @returns  Modfiied sticker set
  */
-export declare function replaceStickerInSet(client: ITelegramClient, sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument, newSticker: InputStickerSetItem, params?: {
+export declare function replaceStickerInSet(client: ITelegramClient, sticker: InputDocumentId, newSticker: InputStickerSetItem, params?: {
     /**
      * Upload progress callback
      *

package/highlevel/methods/stickers/replace-sticker-in-set.d.ts

@@ -1,7 +1,5 @@
-import { tl } from '@mtcute/tl';
 import { ITelegramClient } from '../../client.types.js';
-import { InputStickerSetItem, StickerSet } from '../../types/index.js';
-import { tdFileId } from '@mtcute/file-id';
+import { InputDocumentId, InputStickerSetItem, StickerSet } from '../../types/index.js';
 /**
  * Replace a sticker in a sticker set with another sticker
  *
@@ -13,7 +11,7 @@ import { tdFileId } from '@mtcute/file-id';
  * @param newSticker  New sticker to replace the old one with
  * @returns  Modfiied sticker set
  */
-export declare function replaceStickerInSet(client: ITelegramClient, sticker: string | tdFileId.RawFullRemoteFileLocation | tl.TypeInputDocument, newSticker: InputStickerSetItem, params?: {
+export declare function replaceStickerInSet(client: ITelegramClient, sticker: InputDocumentId, newSticker: InputStickerSetItem, params?: {
     /**
      * Upload progress callback
      *

package/highlevel/methods/users/get-saved-music.cjs

@@ -0,0 +1,38 @@
+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 Long = require("long");
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const documentUtils = require("../../types/media/document-utils.cjs");
+const resolvePeer = require("./resolve-peer.cjs");
+const miscUtils = require("../../utils/misc-utils.cjs");
+async function getSavedMusic(client, params) {
+  const res = await client.call({
+    _: "users.getSavedMusic",
+    id: await resolvePeer.resolveUser(client, params.userId),
+    offset: params.offset ?? 0,
+    limit: params.limit ?? 100,
+    hash: Long.ZERO
+  });
+  typeAssertions.assertTypeIsNot("getSavedMusic", res, "users.savedMusicNotModified");
+  const files = [];
+  for (const file of res.documents) {
+    typeAssertions.assertTypeIs("getSavedMusic", file, "document");
+    const doc = documentUtils.parseDocument(file);
+    utils.assert(doc.type === "audio");
+    files.push(doc);
+  }
+  let nextOffset = (params.offset ?? 0) + files.length;
+  if (nextOffset >= res.count) nextOffset = void 0;
+  return miscUtils.makeArrayPaginated(
+    files,
+    res.count ?? files.length,
+    nextOffset
+  );
+}
+exports.getSavedMusic = getSavedMusic;

package/highlevel/methods/users/get-saved-music.d.cts

@@ -0,0 +1,13 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayPaginated, Audio, InputPeerLike } from '../../types/index.js';
+/**
+ * Get music files saved to the user's profile
+ */
+export declare function getSavedMusic(client: ITelegramClient, params: {
+    /** User ID, username, phone number, `"me"` or `"self"` */
+    userId: InputPeerLike;
+    /** Offset for pagination */
+    offset?: number;
+    /** Limit for pagination */
+    limit?: number;
+}): Promise<ArrayPaginated<Audio, number>>;

package/highlevel/methods/users/get-saved-music.d.ts

@@ -0,0 +1,13 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayPaginated, Audio, InputPeerLike } from '../../types/index.js';
+/**
+ * Get music files saved to the user's profile
+ */
+export declare function getSavedMusic(client: ITelegramClient, params: {
+    /** User ID, username, phone number, `"me"` or `"self"` */
+    userId: InputPeerLike;
+    /** Offset for pagination */
+    offset?: number;
+    /** Limit for pagination */
+    limit?: number;
+}): Promise<ArrayPaginated<Audio, number>>;

package/highlevel/methods/users/get-saved-music.js

@@ -0,0 +1,33 @@
+import { assert } from "@fuman/utils";
+import Long from "long";
+import { assertTypeIsNot, assertTypeIs } from "../../../utils/type-assertions.js";
+import { parseDocument } from "../../types/media/document-utils.js";
+import { resolveUser } from "./resolve-peer.js";
+import { makeArrayPaginated } from "../../utils/misc-utils.js";
+async function getSavedMusic(client, params) {
+  const res = await client.call({
+    _: "users.getSavedMusic",
+    id: await resolveUser(client, params.userId),
+    offset: params.offset ?? 0,
+    limit: params.limit ?? 100,
+    hash: Long.ZERO
+  });
+  assertTypeIsNot("getSavedMusic", res, "users.savedMusicNotModified");
+  const files = [];
+  for (const file of res.documents) {
+    assertTypeIs("getSavedMusic", file, "document");
+    const doc = parseDocument(file);
+    assert(doc.type === "audio");
+    files.push(doc);
+  }
+  let nextOffset = (params.offset ?? 0) + files.length;
+  if (nextOffset >= res.count) nextOffset = void 0;
+  return makeArrayPaginated(
+    files,
+    res.count ?? files.length,
+    nextOffset
+  );
+}
+export {
+  getSavedMusic
+};

package/highlevel/methods/users/save-music-to-profile.cjs

@@ -0,0 +1,57 @@
+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 fileId = require("@mtcute/file-id");
+const tl = require("@mtcute/tl");
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const convertFileId = require("../../utils/convert-file-id.cjs");
+const normalizeInputMedia = require("../files/normalize-input-media.cjs");
+async function saveMusicToProfile(client, params) {
+  let after = params.after;
+  if (fileId.tdFileId.isFileIdLike(after)) {
+    after = convertFileId.fileIdToInputDocument(after);
+  }
+  let audio = params.audio;
+  if (fileId.tdFileId.isFileIdLike(audio)) {
+    audio = {
+      type: "audio",
+      file: audio
+    };
+  }
+  let audioId;
+  if (tl.tl.isAnyInputDocument(audio)) {
+    audioId = audio;
+  } else {
+    const media = await normalizeInputMedia._normalizeInputMedia(client, audio, {
+      progressCallback: params.progressCallback,
+      uploadPeer: { _: "inputPeerSelf" }
+    }, true);
+    utils.assert(media._ === "inputMediaDocument");
+    audioId = media.id;
+  }
+  const res = await client.call({
+    _: "account.saveMusic",
+    id: audioId,
+    afterId: after
+  });
+  typeAssertions.assertTrue("account.saveMusic", res);
+}
+async function unsaveMusicFromProfile(client, params) {
+  let audio = params.audio;
+  if (fileId.tdFileId.isFileIdLike(audio)) {
+    audio = convertFileId.fileIdToInputDocument(audio);
+  }
+  const res = await client.call({
+    _: "account.saveMusic",
+    id: audio,
+    unsave: true
+  });
+  typeAssertions.assertTrue("account.saveMusic", res);
+}
+exports.saveMusicToProfile = saveMusicToProfile;
+exports.unsaveMusicFromProfile = unsaveMusicFromProfile;

package/highlevel/methods/users/save-music-to-profile.d.cts

@@ -0,0 +1,19 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputDocumentId, InputMediaAudio } from '../../types/index.js';
+export declare function saveMusicToProfile(client: ITelegramClient, params: {
+    /** Audio file to save (or its ID) */
+    audio: InputMediaAudio | InputDocumentId;
+    /** Optionally, document ID after which we should insert the music */
+    after?: InputDocumentId;
+    /**
+     * Upload progress callback
+     *
+     * @param uploaded  Number of bytes uploaded
+     * @param total  Total file size
+     */
+    progressCallback?: (uploaded: number, total: number) => void;
+}): Promise<void>;
+export declare function unsaveMusicFromProfile(client: ITelegramClient, params: {
+    /** ID of the Audio file to unsave */
+    audio: InputDocumentId;
+}): Promise<void>;

package/highlevel/methods/users/save-music-to-profile.d.ts

@@ -0,0 +1,19 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputDocumentId, InputMediaAudio } from '../../types/index.js';
+export declare function saveMusicToProfile(client: ITelegramClient, params: {
+    /** Audio file to save (or its ID) */
+    audio: InputMediaAudio | InputDocumentId;
+    /** Optionally, document ID after which we should insert the music */
+    after?: InputDocumentId;
+    /**
+     * Upload progress callback
+     *
+     * @param uploaded  Number of bytes uploaded
+     * @param total  Total file size
+     */
+    progressCallback?: (uploaded: number, total: number) => void;
+}): Promise<void>;
+export declare function unsaveMusicFromProfile(client: ITelegramClient, params: {
+    /** ID of the Audio file to unsave */
+    audio: InputDocumentId;
+}): Promise<void>;