fix: types

packages/bot/src/core/localization/strings/constants.ts

@@ -0,0 +1,3 @@
+import { Locale } from 'discord.js';
+
+export const SUPPORTED_LOCALES: Locale[] = [Locale.EnglishUS, Locale.SpanishES];

packages/bot/src/core/localization/strings/index.ts

@@ -0,0 +1,19 @@
+import { Locale } from 'discord.js';
+import { SUPPORTED_LOCALES } from './constants';
+
+export type TranslationFragmentTree = {
+  [key: string]: TranslationFragment;
+} & {
+  $?: string;
+};
+export type TranslationFragment = string | TranslationFragmentTree;
+
+export const translations = SUPPORTED_LOCALES.reduce<
+  Partial<Record<Locale, TranslationFragment>>
+>(
+  (table, locale) => ({
+    ...table,
+    [locale]: require(`../lang/${locale}.json`),
+  }),
+  {},
+);

packages/bot/src/core/localization/translator.ts

@@ -0,0 +1,74 @@
+import { Locale } from 'discord.js';
+import { translations } from './strings';
+import { SUPPORTED_LOCALES } from './strings/constants';
+
+export function translator(localeRaw: Locale) {
+  const locale =
+    localeRaw !== Locale.EnglishUS && SUPPORTED_LOCALES.includes(localeRaw)
+      ? localeRaw
+      : Locale.EnglishUS;
+  const strings = translations[locale]!;
+
+  function translate(path: string, literals?: string[]): string {
+    const pathArray = path.split('.');
+    let fragment = strings;
+    let resolvedString: string;
+
+    for (const pathItem of pathArray) {
+      if (typeof fragment === 'string') {
+        throw new SyntaxError(
+          `Attempted to access string with key "${pathItem}" in "${path}" from within a string instead of an object in locale "${locale}"`,
+        );
+      } else {
+        fragment = fragment[pathItem];
+
+        if (typeof fragment === 'undefined') {
+          const message = `Undefined translation at "${pathItem}" in "${path}" for locale "${locale}"`;
+
+          if (locale === Locale.EnglishUS) {
+            throw new Error(message);
+          } else {
+            console.warn(`${message} falling back to en-US`);
+            return translator(Locale.EnglishUS).translate(path, literals);
+          }
+        }
+      }
+    }
+
+    if (typeof fragment === 'string') {
+      resolvedString = fragment;
+    } else if (fragment.$) {
+      resolvedString = fragment.$!;
+    } else {
+      throw new Error(
+        `Unresolved tree ending for "${path}" in locale "${locale}"`,
+      );
+    }
+
+    if (literals) {
+      const chunks = resolvedString.split('%s');
+      let embeddedString = '';
+
+      chunks.forEach((chunk, index) => {
+        if (index !== 0) embeddedString += literals[index - 1];
+        embeddedString += chunk;
+      });
+
+      return embeddedString;
+    }
+
+    return resolvedString;
+  }
+
+  function t(paths: TemplateStringsArray, ...embeds: string[]) {
+    return paths
+      .map((path, index) =>
+        path.length === 0
+          ? ''
+          : `${translate(path)}${index === embeds.length ? '' : embeds[index]}`,
+      )
+      .join('');
+  }
+
+  return { locale, translate, t };
+}