@mostfeatured/dbi 0.0.30 → 0.0.31

package/.gitattributes

@@ -1,2 +1,2 @@
-# Auto detect text files and perform LF normalization
-* text=auto
+# Auto detect text files and perform LF normalization
+* text=auto

package/dist/utils/customId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customId.d.ts","sourceRoot":"","sources":["../../src/utils/customId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,EAAC,MAAM,GAAG,MAAM,CAiB9F;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAA;CAAC,CAYrF"}
+{"version":3,"file":"customId.d.ts","sourceRoot":"","sources":["../../src/utils/customId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,EAAC,MAAM,GAAG,MAAM,CAkB9F;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAA;CAAC,CAYrF"}

package/dist/utils/customId.js

@@ -20,6 +20,8 @@ function customIdBuilder(dbi, name, customData, ttl) {
             return `¤${id}`;
         })
     ].join("—");
+    if (!dbi.config.strict)
+        customId = customId.slice(0, 100);
     if (customId.length > 100)
         throw new Error("Custom id cannot be longer than 100 characters.");
     return customId;

package/dist/utils/customId.js.map

@@ -1 +1 @@
-{"version":3,"file":"customId.js","sourceRoot":"","sources":["../../src/utils/customId.ts"],"names":[],"mappings":";;;;AACA,uDAAiC;AAEjC,SAAgB,eAAe,CAAC,GAAQ,EAAE,IAAY,EAAE,UAAiB,EAAE,GAAW;IACpF,IAAI,QAAQ,GAAG;QACb,IAAI;QACJ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACxB,IAAI,OAAO,KAAK,IAAI,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC3C,IAAI,OAAO,KAAK,IAAI,QAAQ;gBAAE,OAAO,IAAI,KAAK,EAAE,CAAC;YACjD,IAAI,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;gBACnB,IAAI,EAAE,EAAE;gBACR,MAAM,KAAK,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aAC9C,CAAC,CAAA;YACF,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACtD,OAAO,IAAI,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;KACH,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IAC7F,OAAO,QAAQ,CAAC;AAClB,CAAC;AAjBD,0CAiBC;AAED,SAAgB,aAAa,CAAC,GAAQ,EAAE,QAAgB;IACtD,IAAI,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAC9B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,IAAI;KACL,CAAA;AACH,CAAC;AAZD,sCAYC","sourcesContent":["import { DBI } from \"../DBI\";\r\nimport * as stuffs from \"stuffs\";\r\n\r\nexport function customIdBuilder(dbi: DBI, name: string, customData: any[], ttl?:number): string {\r\n  let customId = [\r\n    name,\r\n    ...customData.map(value => {\r\n      if (typeof value == \"string\") return value;\r\n      if (typeof value == \"number\") return `π${value}`;\r\n      let id = stuffs.randomString(8);\r\n      Object.assign(value, {\r\n        $ref: id,\r\n        $unRef() { return dbi.data.refs.delete(id); },\r\n      })\r\n      dbi.data.refs.set(id, { at: Date.now(), value, ttl });\r\n      return `¤${id}`;\r\n    })\r\n  ].join(\"—\");\r\n  if (customId.length > 100) throw new Error(\"Custom id cannot be longer than 100 characters.\")\r\n  return customId;\r\n}\r\n\r\nexport function parseCustomId(dbi: DBI, customId: string): {name: string, data: any[]} {\r\n  let splitted = customId.split(\"—\");\r\n  let name = splitted.shift();\r\n  let data = splitted.map(value => {\r\n    if (value.startsWith(\"π\")) return Number(value.slice(1));\r\n    if (value.startsWith(\"¤\")) return dbi.data.refs.get(value.slice(1))?.value;\r\n    return value;\r\n  });\r\n  return {\r\n    name,\r\n    data\r\n  }\r\n}"]}
+{"version":3,"file":"customId.js","sourceRoot":"","sources":["../../src/utils/customId.ts"],"names":[],"mappings":";;;;AACA,uDAAiC;AAEjC,SAAgB,eAAe,CAAC,GAAQ,EAAE,IAAY,EAAE,UAAiB,EAAE,GAAW;IACpF,IAAI,QAAQ,GAAG;QACb,IAAI;QACJ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YACxB,IAAI,OAAO,KAAK,IAAI,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC3C,IAAI,OAAO,KAAK,IAAI,QAAQ;gBAAE,OAAO,IAAI,KAAK,EAAE,CAAC;YACjD,IAAI,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;gBACnB,IAAI,EAAE,EAAE;gBACR,MAAM,KAAK,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aAC9C,CAAC,CAAA;YACF,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACtD,OAAO,IAAI,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;KACH,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM;QAAE,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IAC7F,OAAO,QAAQ,CAAC;AAClB,CAAC;AAlBD,0CAkBC;AAED,SAAgB,aAAa,CAAC,GAAQ,EAAE,QAAgB;IACtD,IAAI,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAC9B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,IAAI;KACL,CAAA;AACH,CAAC;AAZD,sCAYC","sourcesContent":["import { DBI } from \"../DBI\";\r\nimport * as stuffs from \"stuffs\";\r\n\r\nexport function customIdBuilder(dbi: DBI, name: string, customData: any[], ttl?:number): string {\r\n  let customId = [\r\n    name,\r\n    ...customData.map(value => {\r\n      if (typeof value == \"string\") return value;\r\n      if (typeof value == \"number\") return `π${value}`;\r\n      let id = stuffs.randomString(8);\r\n      Object.assign(value, {\r\n        $ref: id,\r\n        $unRef() { return dbi.data.refs.delete(id); },\r\n      })\r\n      dbi.data.refs.set(id, { at: Date.now(), value, ttl });\r\n      return `¤${id}`;\r\n    })\r\n  ].join(\"—\");\r\n  if (!dbi.config.strict) customId = customId.slice(0, 100);\r\n  if (customId.length > 100) throw new Error(\"Custom id cannot be longer than 100 characters.\")\r\n  return customId;\r\n}\r\n\r\nexport function parseCustomId(dbi: DBI, customId: string): {name: string, data: any[]} {\r\n  let splitted = customId.split(\"—\");\r\n  let name = splitted.shift();\r\n  let data = splitted.map(value => {\r\n    if (value.startsWith(\"π\")) return Number(value.slice(1));\r\n    if (value.startsWith(\"¤\")) return dbi.data.refs.get(value.slice(1))?.value;\r\n    return value;\r\n  });\r\n  return {\r\n    name,\r\n    data\r\n  }\r\n}"]}

package/package.json

@@ -9,7 +9,7 @@
     "stuffs": "^0.1.17"
   },
   "name": "@mostfeatured/dbi",
-  "version": "0.0.30",
+  "version": "0.0.31",
   "main": "dist/index.js",
   "type": "commonjs",
   "private": false,

package/readme.md

@@ -1,34 +1,282 @@
-# DiscordBotInfrastructure
+# DiscordBotInfrastructure - [Turkish]
 
-Büyük ihtimalle internette bulabileceğiniz kullanımı basit ve en kullanışlı altyapı bu olabilir.
+İnternet üzerinde bulabileceğiniz en gelişmiş, güncel ve kullanımı basit Discord bot altyapısı.
 
-## Hemen Kullanımına Geçelim
-Unutmadan söyleyeyim bu altyapı diğer alışık olduğunuz altyapılar gibi kendi halinde bir proje değil, bir NPM modülüdür. Bu yüzden kullanmaya başlamak için bir klasör açıyoruz ve içerisine `npm install @mostfeatured/dbi` komutunu kullanarak altyapıyı indiriyoruz.
+# Kullanım Senaryosu
 
-Önce `3 dosya` ve `1 klasöre` ihitiyacımız var. Bu yapı tamamen sizin keyfinize kalmış bir durumda ancak ben bu şekilde kullanıyorum ve tavsiye ediyorum.
+MostFeatured/DiscordBotInfrastructure projesi diğer alışık olduğunuz altyapılar gibi kendi halinde bir proje değil, bir NPM modülüdür. Bu bağlamda kullanmaya başlamadan önce bir klasör açmanız ve içerisine `npm install @mostfeatured/dbi discord.js` komutunu girerek altyapıyı ve discord.js'i indirmeniz gerekmektedir.
 
-Neyse, açacağamız dosyalar ve klasörler şunlar; `dbi.js`, `login.js`, `publish.js` dosyaları ve `src` klasörü.
+# Başlarken
 
-İlk olarak `dbi.js` adındaki dosyamı açıyorum ve içerisine altyapının temellerini atıyorum.
-![1](https://i.imgur.com/I3NV7MD.png)
+İlk olarak `3 dosya` ve `1 klasöre` ihitiyacımız olacak. Bu yapı tamamen sizin çalışma düzeninize uygun olarak konfigüre edilebilmektedir. Lakin bizim önerdiğimiz senaryo aşağıdaki gibidir.
 
-`createDBI()` fonksiyonu ile altyapıyı başlatıyorum. Fonksiyonun ilk parametresi botunuzun `kodAdı`, ikinci parametresi ise botunuzun konfigürasyonudur.
+Açılması gereken dosyalar ve klasörler; `dbi.js`, `login.js`, `publish.js` dosyaları ve `src` klasörü.
 
+1. adım olarak `dbi.js` adındaki dosyamızı açıyoruz ve içerisine altyapının temellerini atıyoruz.
+```js
+const { createDBI } = require("@mostfeatured/dbi");
 
+let dbi = createDBI("xd", {
+  strict: true,
+  discord: {
+    token: "<yourTokenHere>",
+    options: {
+      intents: [
+        "Guilds"
+      ]
+    }
+  },
+  defaults: {
+    locale: "en",
+    defaultMemberPermissions: ["SendMessages"],
+    directMessages: false
+  },
+  references: {
+    autoClear: {
+      ttl: 60 * 1000 * 60,
+      check: 60 * 1000
+    }
+  }
+});
 
-İkinci olarak `login.js` dosyamı açıyorum ve içerisine botu açmak için kullanacağım kod gurubunu yazıyorum.
-![2](https://i.imgur.com/Kn9ELps.png)
+module.exports = dbi;
+```
 
-İçeriye `recursiveImport()` fonksiyonunu alıyorum. Bu fonksiyon ile sonsuz bir şekilde `x` klasöründeki bütün dosyaları `import`/`require` edebiliyoruz, bu sayede altyapı bu dosyalardan haberdar oluyor.
-Ana `dbi.js` dosyamdan altyapıma ulaşıyorum. Ve `async` bir ortam oluşturup ilk önce tüm proje dosylarını altyapıya tanımlıyorum. Tanımlamanın ardından tanımladığım tüm özellikleri altyapıya `load()` fonksiyonunu ile yüklüyorum. Hemen ardından `login()` fonksiyonu ile Discord'a giriş sağlıyorum.
+`createDBI()` fonksiyonu ile altyapıyı başlatıyoruz. Fonksiyonun ilk parametresi botunuzun `kodAdı`, ikinci parametresi ise botunuzun konfigürasyonudur.
 
+2. adım olarak `login.js` dosyamızı açıyoruz ve içerisine botu açmak için kullanacağımız kod gurubunu yazıyoruz.
+```js
+const { recursiveImport } = require("@mostfeatured/dbi");
+const dbi = require("./dbi");
 
-Üçüncü olarak `publish.js` dosyamı açıyorum ve ikinci aşamada yaptığım tüm herşeyi tekrardan yapıyorum.
-![3](https://i.imgur.com/p2VI6Js.png)
+(async () => {
+  await recursiveImport("./src");
 
-Ancak `login()` fonksiyonunu çağırmak yerine, `publish()` fonksiyonunu çağrıyorum bu fonksiyon ile botumun komutlarını istediğim yere tanıtıyorum.
+  await dbi.load();
+  await dbi.login();
 
+  await dbi.client.user.setActivity({
+    name: "MostFeatured ❤️ TheArmagan"
+  });
 
-<sub>Devamı gelecek..</sub>
+  console.log(`Logged in! ${dbi.client.user.tag} (${dbi.client.user.id})`);
+})();
+```
 
+İçeriye `recursiveImport()` fonksiyonunu alıyoruz. Bu fonksiyon ile sonsuz bir şekilde `x` klasöründeki bütün dosyaları `import`/`require` edebiliyoruz. Bu sayede altyapı bu dosyalardan haberdar oluyor.
+Ana `dbi.js` dosyamızdan altyapımıza ulaşıyoruz ve `async` bir ortam oluşturup ilk önce tüm proje dosylarını altyapıya tanımlıyoruz. Tanımlamanın ardından tanımladığımız tüm özellikleri altyapıya `load()` fonksiyonunu ile yüklüyoruz. Hemen ardından `login()` fonksiyonu ile Discord'a giriş sağlıyoruz.
 
+
+3. adım olarak `publish.js` dosyamızı açıyoruz ve ikinci aşamada yaptığımız tüm işlemleri tekrardan uyguluyoruz.
+```js
+const { recursiveImport } = require("@mostfeatured/dbi");
+const dbi = require("./dbi");
+
+(async () => {
+  await recursiveImport("./src");
+
+  await dbi.load();
+  await dbi.publish("Guild", "<yourGuildId>");
+  // await dbi.publish("Global");
+  await dbi.unload();
+
+  console.log("Published!");
+})();
+```
+
+Ancak `login()` fonksiyonunu çağırmak yerine, `publish()` fonksiyonunu çağrıyoruz ve bu fonksiyon ile botumuzun komutlarını istediğimiz yere tanıtıyoruz.
+
+# Harika! 
+
+Artık altyapıyı kullanabilmek için gerekli olan bütün dosyalara sahibiz. (Bilgilendirme: Detaylı bir şekilde anlattığımız bu adımlar size karmaşık ve zor geliyorsa üzgünüz ki bu altyapı size uygun değil.)
+
+# Detaylı Kullanım Senaryosu
+
+Özel olarak geliştirdiğimiz ve v14'ü eksiksiz bir şekilde destekleyen altyapımız ile Discord'un her türlü özelliğini tam anlamıyla kullanabiliyorsunuz. (`ChatInput`, `Event`, `Locale`, `Button`, `SelectMenu`, `MessageContextMenu`, `UserContextMenu`, `Modal`, `InteractionLocale`)
+
+Şimdi sizlere altyapıya özellik tanımlamayı göstermek istiyoruz. Örnek: (ChatInput/Button vb.)
+
+İlk olarak ilgili özelliği altyapımıza dahil ediyoruz.
+```js
+const dbi = require("../dbi");
+```
+Ve devamında altyapının üzerindeki `register()` fonksiyonunu çağırıp içerisine bir `callback` fonksiyonu koyuyoruz. Bu `callback` fonksiyonu ilk parametre olarak size altyapı üzerine tanımlayabilceğiniz tüm her şeyi bir obje olarak sunuyor. Bu obje içerisinden istediğiniz özellik fonksiyonunu çağırarak altyapıya tanımlama işlemini gerçekleştirebiliyorsunuz.
+```js
+dbi.register(({ ChatInput, Event })=>{
+  ChatInput({ ... });
+  Event({ ... });
+})
+```
+Unutmayın ki aynı anda istediğiniz kadar özelliği çağırabilirsiniz!
+
+#ChatInput & ChatInputOptions
+
+`ChatInput` sizin anlayacağınız şekilde "Slash Komut" olarak tanımlanmaktadır.
+
+<sub>`src/chatInput.js` dosyası:</sub>
+
+```js
+const dbi = require("../dbi");
+const Discord = require("discord.js");
+
+dbi.register(({ ChatInput, ChatInputOptions })=>{
+  ChatInput({
+    name: "cinsiyet seç",
+    description: "Cinsiyet seçmenizi sağlar.",
+    onExecute({ interaction, locale }) {
+      let gender = interaction.options.get("cinsiyet").value;
+      let genderNames = locale.user.data.genders;
+      let genderText = locale.user.data.genderText(interaction.user, genderNames[gender]());
+      interaction.reply({ 
+        content: genderText,
+        components: [
+          {
+            type: Discord.ComponentType.ActionRow,
+            components: [
+              dbi.interaction("viewGender").toJSON({ gender }),
+            ]
+          }
+        ]
+      });
+    },
+    options: [
+      ChatInputOptions.stringChoices({
+        name: "cinsiyet",
+        description: "Seçeceğiniz cinsiyet.",
+        required: true,
+        choices: [
+          { name: "Erkek", value: "erkek" },
+          { name: "Kadın", value: "kadın" },
+          { name: "Diğer", value: "diğer" },
+        ]
+      })
+    ],
+  });
+});
+```
+Genel olarak `ChatInput`'un yapısı gözünüze `options` dışında tanıdık gelmiş olabilir. Direkt olarak options içerisine bir şey doldurmaya çalıştığınızda otomatik tamamlama alamayacaksınız. Çünkü options içerisinde ChatInputOptions class'ındaki statik fonksiyonlardan beklemekte. Fonksiyonlar ise şunlara benzemekte; `stringChoices`, `user`, `numberAutocomplete` vb.
+Ayrıca yukarıda göstermiş olduğumuz Locale ve Component sisteminin nasıl kullanıldığıyla ilgili örnek gösterim için aşağıdan daha fazla örneğe ulaşabilirsiniz.
+
+# Event
+
+<sub>`src/event.js` dosyası:</sub>
+
+```js
+const dbi = require("../dbi");
+
+dbi.register(({ Event })=>{
+  Event({
+    name: "ready",
+    id: "botIsReady",
+    onExecute() {
+      console.log(`Bot ready!`);
+    }
+  });
+});
+```
+Event yani olay tanımlarken `name` kısmına istediğiniz olayın ismini yazabilirsiniz. Ancak eğer aynı olaydan birden fazla açmak istiyorsanız o olaya bir `id` tanımlamanız gerekmektedir.
+
+# Locale
+
+<sub>`src/locales.js` dosyası:</sub>
+
+```js
+const dbi = require("../dbi");
+
+dbi.register(({ Locale })=>{
+  Locale({
+    name: "tr",
+    data: {
+      genders: {
+        erkek: "Erkek",
+        kadın: "Kadın",
+        diğer: "Diğer"
+      },
+      genderText: "{0} adlı üye {1} cinsiyetini seçti."
+    }
+  });
+
+  Locale({
+    name: "en",
+    data: {
+      genders: {
+        erkek: "Male",
+        kadın: "Female",
+        diğer: "Other"
+      },
+      genderText: "{0}, picked {1} gender."
+    }
+  });
+});
+```
+
+Locale sayesinde her interaksiyon içerisinde kullanıcının veya sunucunun diline göre cevap vermenizi kolaylaştıracak bilgiler bulunmakta. Locale içerisindeki `name` hangi dil için tanımlama yaptığınız `data` kısmı ise tutmak istediğiniz değerleri içermekte. Yazı içerisindeki `{0}` ve `{1}` işaretleri aynı şekilde yazı içerisindeki değişkenlerimiz. Locale kullanırken istediğimiz değeri alıp onu bir fonksiyon gibi çağırabiliyoruz. Ve içerisine sırasıyla parametreleri veriyoruz. Örneğin `locale.data.genderText(user, gender)`.
+
+# Button & SelectMenu & Modal
+
+Bu bölümde ise üç adet özelliğimize bakacağız. (Aslında arka planda hepsi aynı özellik.)
+
+<sub>`src/components.js` dosyası:</sub>
+
+```js
+const dbi = require("../dbi");
+const Discord = require("discord.js");
+
+dbi.register(({ Button, SelectMenu, Modal })=>{
+  Button({
+    name: "viewGender",
+    onExecute({ interaction, data }) {
+      interaction.reply(`\`${data[0].gender}\``);
+    },
+    options: {
+      style: Discord.ButtonStyle.Primary,
+      label: "View Gender"
+    }
+  });
+});
+```
+Button & SelectMenu & Modal hakkında çok güzel ve havalı bir özelliği sizlerle buluşturuyoruz. Artık bunların üzerinde istediğiniz değeri taşıyabilirsiniz. (Referans/Obje veya yazı/sayı gibi.) Örneğin `dbi.interaction("viewGender").toJSON("male")` bize Discord.js tarafından desteklenen geçerli bir component sunacaktır. Ve to json içerisinde sunulan değere hem `options` kısmını bir fonksiyona çevirerek ulaşabilir hem de interaksiyonun kendisi çağırıldığında ulaşabilirsiniz. Bu konuyla ilgili unutmamanız gereken bir şey var. Eğer düz yazı veya sayı taşıyacaksanız bu yazı veya sayıların toplam uzunluğu 100 karakteri geçmemeli. Çünkü bu değerler direkt olarak düğmenin üzerinde taşınmakta ve siz botu kapatıp açsanız bile orada kalacak şekilde çalışmaktadırlar.
+
+# MessageContextMenu & UserContextMenu
+
+`ChatInput` ile birebir aynı özelliklere sahip ancak `options` değeri almamaktadır.
+
+# InteractionLocale
+
+Bir eşsiz özelliği daha sizlere sunuyoruz. Artık her kullanıcıya özel komut dili tanımlamanızı sağlayabilirsiniz.
+Örneğin Türk bir kullanıcıya `/cinsiyet seç` şeklinde gözüken komut yabancı bir kullanıcıya `/select gender` olarak gözükebilir. (Dilediğiniz gibi konfigüre edebilirsiniz.)
+
+<sub>`src/interactionlocales.js` dosyası:</sub>
+
+```js
+dbi.register(({ InteractionLocale })=>{
+  InteractionLocale({
+    name: "cinsiyet seç",
+    data: {
+      en: {
+        name: "select gender",
+        description: "Allows you to select a gender.",
+        options: {
+          cinsiyet: {
+            name: "gender",
+            description: "Select your gender correctly.",
+            choices: {
+              "Erkek": "Male",
+              "Kadın": "Female",
+              "Diğer": "Other"
+            }
+          }
+        }
+      }
+    }
+  });
+});
+```
+
+Son not: `InteractionLocale` için `name` değeri sizin tanımladığınız diğer interaksiyonlardan birinin ismi olacaktır. Örneğin `cinsiyet seç`. Data'nın yapısını en basit hale getirmeye çalıştık. ilk önce istediğiniz dili seçiyorsunuz ve sonrasında içerisini örnekteki gibi uygun bir şekilde dolduruyorsunuz. İçerisine aynı anda istediğin kadar dilde nasıl gözükeceğini ekleyebilirsiniz.
+
+Karşılacağınız hatalar ya da benzer konular için Discord üzerinden tarafıma ulaşabilirsiniz. (Armagan#4869)
+
+Unutmayın ki: "Yeryüzünde her zaman ücretsiz ve değerli bir şeyler olacaktır."
+
+<sub>12.09.2022: Orjinal metin TheArmagan tarafından yazıldı, Maschera tarafından düzenlendi. </sub>

package/src/utils/customId.ts

@@ -16,6 +16,7 @@ export function customIdBuilder(dbi: DBI, name: string, customData: any[], ttl?:
       return `¤${id}`;
     })
   ].join("—");
+  if (!dbi.config.strict) customId = customId.slice(0, 100);
   if (customId.length > 100) throw new Error("Custom id cannot be longer than 100 characters.")
   return customId;
 }