emoji-hub-api-client 1.0.0

package/README.md

@@ -0,0 +1,396 @@
+![emoji-hub-api-banner-2](https://github.com/user-attachments/assets/3c273cde-0d8a-4b31-a9c5-1c6c72a0d1e7)
+# Emoji Hub API Client
+A lightweight JavaScript/TypeScript client for the EmojiHub API (https://github.com/cheatsnake/emojihub), providing easy access to emojis by category, group, search, and random selection. This package is ESM-only and works in modern browsers and Node.js 18+ environments that support the Fetch API.
+
+### 📦 Installation
+```console
+npm install emoji-hub-api-client
+```
+Note: If you are using Node.js, ensure your project supports ES modules.
+
+### 🎲 Features
+1. Lightweight & fast — minimal abstraction over the EmojiHub API
+2. Zero dependencies — uses the native fetch API
+3. JavaScript & TypeScript support — includes type definitions out of the box
+4. Search emojis by name
+5. Fetch random emojis
+6. Filter emojis by category or group
+7. Retrieve all available categories and groups
+
+### 📚 API Functions
+The emoji-hub-api-client package exposes the following functions:
+1. ```getAllEmojiCategories()```: Retrieve a list of all available emoji categories.
+2. ```getAllEmojiGroups()```: Retrieve a list of all available emoji groups.
+3. ```getAllEmojis()```: Fetch all emojis available in the EmojiHub API.
+4. ```getRandomEmoji()```: Fetch a single random emoji.
+5. ```getRandomEmojiByCategory()```: Fetch a random emoji from a specific category.
+6. ```getRandomEmojiByGroup()```: Fetch a random emoji from a specific group.
+7. ```searchEmojisByName()```: Search emojis by name.
+8. ```searchSimilarEmojisByName()```: Retrieve emojis with names similar to the provided emoji name.
+
+### 🔤 Example Usage
+1. Get All Emoji Categories
+```javascript
+import { getAllEmojiCategories } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await getAllEmojiCategories();
+  if (response.code === "api-ok" && response.payload) {
+    console.log(response.payload.categories);
+  } else {
+    console.error("Failed to fetch categories:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": {
+    "categories": [
+      "smileys and people",
+      "animals and nature",
+      "food and drink",
+      "travel and places"
+      ...
+      ...
+    ]
+  }
+}
+*/
+
+// Error
+/*
+{
+    code: "api-fail",
+    message: "Get All Emoji Categories: Encountered Error!",
+    payload: null
+}
+*/
+```
+2. Get All Emoji Groups
+```javascript
+import { getAllEmojiGroups } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await getAllEmojiGroups();
+  if (response.code === "api-ok" && response.payload) {
+    console.log(response.payload.groups);
+  } else {
+    console.error("Failed to fetch groups:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": {
+    "groups": [
+      "face positive",
+      "face neutral",
+      "face negative",
+      "animal mammal",
+      "animal bird"
+      ...
+      ...
+      ...
+    ]
+  }
+}
+*/
+
+// Error
+/* { code: "api-fail", message: "Get All Emoji Groups: Encountered Error", payload: null }; */
+```
+3. Get All Emojis
+```javascript
+import { getAllEmojis } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await getAllEmojis();
+  if (response.code === "api-ok" && response.payload) {
+    // Log the first emoji as a sample
+    console.log("Sample emoji:", response.payload[0]);
+  } else {
+    console.error("Failed to fetch emojis:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": [
+    {
+      "name": "grinning face",
+      "category": "smileys and people",
+      "group": "face positive",
+      "htmlCode": ["😀"],
+      "unicode": ["U+1F600"]
+    }
+    ...
+    ...
+    ...
+  ]
+}
+*/
+
+// Error
+/*
+{
+    code: "api-fail",
+    message: "Get All Emoji: Encountered Error!",
+    payload: null
+}
+*/
+```
+4. Get A Random Emoji
+```javascript
+import { getRandomEmoji } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await getRandomEmoji();
+  if (response.code === "api-ok" && response.payload) {
+    console.log(response.payload);
+  } else {
+    console.error("Failed to fetch random emoji:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": {
+    "name": "rocket",
+    "category": "travel and places",
+    "group": "transport air",
+    "htmlCode": ["🚀"],
+    "unicode": ["U+1F680"]
+  }
+}
+*/
+
+// Error
+/*
+{
+    code: "api-fail",
+    message: "Get Random Emoji: Encountered Error!",
+    payload: null
+}
+*/
+```
+5. Get a Random Emoji by Category
+```javascript
+/* Note: To get the type of categories, check the getAllEmojiCategories() function response */
+import { getRandomEmojiByCategory } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await getRandomEmojiByCategory({
+    category: "smileys-and-people" /* join with hyphen if there are more than 2 words */
+  });
+
+  if (response.code === "api-ok" && response.payload) {
+    console.log(response.payload);
+  } else {
+    console.error("Failed to fetch random emoji by category:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": {
+    "name": "grinning face",
+    "category": "smileys and people",
+    "group": "face positive",
+    "htmlCode": ["😀"],
+    "unicode": ["U+1F600"]
+  }
+}
+*/
+
+// Error
+/*
+{
+    code: "api-fail",
+    message: "Get Random Emoji By Category: Encountered Error!",
+    payload: null
+}
+*/
+```
+6. Get Random Emoji By Group
+```javascript
+/* Note: to get the names of the groups, check the getAllEmojiGroups() function response */
+import { getRandomEmojiByGroup } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await getRandomEmojiByGroup({
+    group: "face-positive" /* join with hyphen if there are more than 2 words*/
+  });
+
+  if (response.code === "api-ok" && response.payload) {
+    console.log(response.payload);
+  } else {
+    console.error("Failed to fetch random emoji by group:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": {
+    "name": "smiling face with sunglasses",
+    "category": "smileys and people",
+    "group": "face positive",
+    "htmlCode": ["😎"],
+    "unicode": ["U+1F60E"]
+  }
+}
+*/
+
+// Error
+/*
+{
+    code: "api-fail",
+    message: "Get Random Emoji By Group: Encountered Error!",
+    payload: null
+}
+*/
+```
+7. Search An Emoji By Name/Query
+```javascript
+import { searchEmojisByName } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await searchEmojisByName({
+    query: "smile"
+  });
+
+  if (response.code === "api-ok" && response.payload) {
+    console.log(`Total results: ${response.payload.totalResults}`);
+    console.log(response.payload.results);
+  } else {
+    console.error("Failed to search emojis:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": {
+    "totalResults": 2,
+    "results": [
+      {
+        "name": "smiling face",
+        "category": "smileys and people",
+        "group": "face positive",
+        "htmlCode": ["😊"],
+        "unicode": ["U+1F642"]
+      },
+      {
+        "name": "smiling face with sunglasses",
+        "category": "smileys and people",
+        "group": "face positive",
+        "htmlCode": ["😎"],
+        "unicode": ["U+1F60E"]
+      }
+    ]
+  }
+}
+*/
+
+// Error
+/*
+{
+    code: "api-fail",
+    message: "Search Emoji(s) By Name: Encountered Error!",
+    payload: null
+}
+*/
+```
+8. Get Similar Emoji(s) By Name/Query
+```javascript
+import { searchSimilarEmojisByName } from "emoji-hub-api-client";
+
+async function run() {
+  const response = await searchSimilarEmojisByName({
+    query: "heart"
+  });
+  if (response.code === "api-ok" && response.payload) {
+    console.log(`Total similar emojis found: ${response.payload.totalResults}`);
+    console.log(response.payload.results);
+  } else {
+    console.error("Failed to search similar emojis:", response.message);
+  }
+}
+run();
+
+// 200:OK
+/*
+{
+  "code": "api-ok",
+  "message": "No error encountered",
+  "payload": {
+    "totalResults": 3,
+    "results": [
+      {
+        "name": "red heart",
+        "category": "smileys and people",
+        "group": "emotion",
+        "htmlCode": ["❤"],
+        "unicode": ["U+2764"]
+      },
+      {
+        "name": "orange heart",
+        "category": "smileys and people",
+        "group": "emotion",
+        "htmlCode": ["🟧"],
+        "unicode": ["U+1F9E7"]
+      },
+      {
+        "name": "yellow heart",
+        "category": "smileys and people",
+        "group": "emotion",
+        "htmlCode": ["💛"],
+        "unicode": ["U+1F49B"]
+      }
+    ]
+  }
+}
+*/
+
+// Error
+/*
+{
+    code: "api-fail",
+    message: "Search Similar Emoji(s) By Name: Encountered Error!",
+    payload: null
+}
+*/
+```
+
+### 📘 Contributing
+Contributions, suggestions, and improvements are welcome.<br/>
+Feel free to open issues or pull requests.
+
+### ❤️ Support
+Like this project? Support it with a github star, it would mean a lot to me! Cheers and Happy Coding.

package/dist/get-all-emoji-categories/index.d.ts

@@ -0,0 +1,10 @@
+import { TAPIResponse } from "../types/index.js";
+type TEmojiCategories = TAPIResponse & {
+    payload: {
+        categories: string[];
+    } | null;
+};
+declare function getAllEmojiCategories(): Promise<TEmojiCategories>;
+export type { TEmojiCategories };
+export { getAllEmojiCategories };
+//# sourceMappingURL=index.d.ts.map

package/dist/get-all-emoji-categories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/get-all-emoji-categories/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,KAAK,gBAAgB,GAAG,YAAY,GAAG;IACnC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5C,CAAC;AAGF,iBAAe,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAyBhE;AAGD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/get-all-emoji-categories/index.js

@@ -0,0 +1,32 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function getAllEmojiCategories() {
+    try {
+        /* setup and fetch */
+        const API_URL = `${API_BASE_URL}/api/categories`;
+        const response = await fetch(API_URL);
+        /* check and return */
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        else {
+            const categories = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered",
+                payload: { categories }
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Get All Emoji Categories: Encountered Error!",
+            payload: null
+        };
+    }
+}
+export { getAllEmojiCategories };
+//# sourceMappingURL=index.js.map

package/dist/get-all-emoji-categories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/get-all-emoji-categories/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,YAAY;AACZ,KAAK,UAAU,qBAAqB;IAChC,IAAI,CAAC;QACD,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,iBAAiB,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACJ,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE,EAAE,UAAU,EAAE;aAC1B,CAAA;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,8CAA8C;YACvD,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAID,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/get-all-emoji-groups/index.d.ts

@@ -0,0 +1,10 @@
+import { TAPIResponse } from "../types/index.js";
+type TEmojiGroups = TAPIResponse & {
+    payload: null | {
+        groups: string[];
+    };
+};
+declare function getAllEmojiGroups(): Promise<TEmojiGroups>;
+export { getAllEmojiGroups };
+export type { TEmojiGroups };
+//# sourceMappingURL=index.d.ts.map

package/dist/get-all-emoji-groups/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/get-all-emoji-groups/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAIhD,KAAK,YAAY,GAAG,YAAY,GAAG;IAC/B,OAAO,EAAE,IAAI,GAAG;QACZ,MAAM,EAAE,MAAM,EAAE,CAAA;KACnB,CAAC;CACL,CAAC;AAGF,iBAAe,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC,CAwBxD;AAGD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,YAAY,EAAC,YAAY,EAAC,CAAC"}

package/dist/get-all-emoji-groups/index.js

@@ -0,0 +1,29 @@
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function getAllEmojiGroups() {
+    try {
+        /* setup and fetch */
+        const API_URL = `${API_BASE_URL}/api/groups`;
+        const response = await fetch(API_URL);
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        else {
+            const emojiGroups = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered",
+                payload: {
+                    groups: emojiGroups
+                }
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return { code: "api-fail", message: "Get All Emoji Groups: Encountered Error", payload: null };
+    }
+}
+/* export */
+export { getAllEmojiGroups };
+//# sourceMappingURL=index.js.map

package/dist/get-all-emoji-groups/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/get-all-emoji-groups/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAShD,YAAY;AACZ,KAAK,UAAU,iBAAiB;IAC5B,IAAI,CAAC;QACD,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,aAAa,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,IAAI,CAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,uBACZ,QAAQ,CAAC,MACb,EAAE,CAAC,CAAC;QACR,CAAC;aAAM,CAAC;YACJ,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC1C,OAAO;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE;oBACL,MAAM,EAAE,WAAW;iBACtB;aACJ,CAAC;QACN,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACpB,OAAO,EAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,yCAAyC,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC;IACjG,CAAC;AACL,CAAC;AAED,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/get-all-emojis/index.d.ts

@@ -0,0 +1,8 @@
+import { TEmoji, TAPIResponse } from "../types/index.js";
+type TAllEmojis = TAPIResponse & {
+    payload: null | TEmoji[];
+};
+declare function getAllEmojis(): Promise<TAllEmojis>;
+export { getAllEmojis };
+export type { TAllEmojis };
+//# sourceMappingURL=index.d.ts.map

package/dist/get-all-emojis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/get-all-emojis/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,KAAK,UAAU,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,GAAG,MAAM,EAAE,CAAA;CAAE,CAAC;AAG9D,iBAAe,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC,CAyBjD;AAGD,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/get-all-emojis/index.js

@@ -0,0 +1,33 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function getAllEmojis() {
+    try {
+        /* setup and fetch */
+        const API_URL = `${API_BASE_URL}/api/all`;
+        const response = await fetch(API_URL);
+        /* check and return */
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        else {
+            const emojis = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered",
+                payload: emojis
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Get All Emoji: Encountered Error!",
+            payload: null
+        };
+    }
+}
+/* export */
+export { getAllEmojis };
+//# sourceMappingURL=index.js.map

package/dist/get-all-emojis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/get-all-emojis/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,YAAY;AACZ,KAAK,UAAU,YAAY;IACvB,IAAI,CAAC;QACD,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,UAAU,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE,MAAM;aAClB,CAAC;QACN,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,mCAAmC;YAC5C,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAED,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/get-random-emoji/get-random-by-category.d.ts

@@ -0,0 +1,11 @@
+import { TEmoji, TAPIResponse } from "../types/index.js";
+type TRandomEmojiByCategory = TAPIResponse & {
+    payload: null | TEmoji;
+};
+type TInput = {
+    category: string;
+};
+declare function getRandomEmojiByCategory(props: TInput): Promise<TRandomEmojiByCategory>;
+export type { TRandomEmojiByCategory };
+export { getRandomEmojiByCategory };
+//# sourceMappingURL=get-random-by-category.d.ts.map

package/dist/get-random-emoji/get-random-by-category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-random-by-category.d.ts","sourceRoot":"","sources":["../../src/get-random-emoji/get-random-by-category.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,KAAK,sBAAsB,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC;AACxE,KAAK,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAGnC,iBAAe,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4BtF;AAGD,YAAY,EAAE,sBAAsB,EAAE,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/get-random-emoji/get-random-by-category.js

@@ -0,0 +1,34 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function getRandomEmojiByCategory(props) {
+    try {
+        /* props - destruct */
+        const { category } = props;
+        /* setup and fetch */
+        const API_URL = `${API_BASE_URL}/api/random/category/${category}`;
+        const response = await fetch(API_URL);
+        /* check and return */
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        else {
+            const emoji = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered",
+                payload: emoji
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Get Random Emoji By Category: Encountered Error!",
+            payload: null
+        };
+    }
+}
+export { getRandomEmojiByCategory };
+//# sourceMappingURL=get-random-by-category.js.map

package/dist/get-random-emoji/get-random-by-category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-random-by-category.js","sourceRoot":"","sources":["../../src/get-random-emoji/get-random-by-category.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,YAAY;AACZ,KAAK,UAAU,wBAAwB,CAAC,KAAa;IACjD,IAAI,CAAC;QACD,sBAAsB;QACtB,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QAE3B,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,wBAAwB,QAAQ,EAAE,CAAC;QAClE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE,KAAK;aACjB,CAAA;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,kDAAkD;YAC3D,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAID,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/get-random-emoji/get-random-by-group.d.ts

@@ -0,0 +1,11 @@
+import { TEmoji, TAPIResponse } from "../types/index.js";
+type TRandomEmojiByGroup = TAPIResponse & {
+    payload: null | TEmoji;
+};
+type TInput = {
+    group: string;
+};
+declare function getRandomEmojiByGroup(props: TInput): Promise<TRandomEmojiByGroup>;
+export type { TRandomEmojiByGroup };
+export { getRandomEmojiByGroup };
+//# sourceMappingURL=get-random-by-group.d.ts.map

package/dist/get-random-emoji/get-random-by-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-random-by-group.d.ts","sourceRoot":"","sources":["../../src/get-random-emoji/get-random-by-group.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,KAAK,mBAAmB,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC;AACrE,KAAK,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAGhC,iBAAe,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4BhF;AAGD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/get-random-emoji/get-random-by-group.js

@@ -0,0 +1,34 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function getRandomEmojiByGroup(props) {
+    try {
+        /* props - destruct */
+        const { group } = props;
+        /* setup and fetch */
+        const API_URL = `${API_BASE_URL}/api/random/group/${group}`;
+        const response = await fetch(API_URL);
+        /* check and return */
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        else {
+            const emoji = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered",
+                payload: emoji
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Get Random Emoji By Group: Encountered Error!",
+            payload: null
+        };
+    }
+}
+export { getRandomEmojiByGroup };
+//# sourceMappingURL=get-random-by-group.js.map

package/dist/get-random-emoji/get-random-by-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-random-by-group.js","sourceRoot":"","sources":["../../src/get-random-emoji/get-random-by-group.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,YAAY;AACZ,KAAK,UAAU,qBAAqB,CAAC,KAAa;IAC9C,IAAI,CAAC;QACD,sBAAsB;QACtB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;QAExB,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,qBAAqB,KAAK,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE,KAAK;aACjB,CAAA;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,+CAA+C;YACxD,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAID,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/get-random-emoji/get-random.d.ts

@@ -0,0 +1,8 @@
+import { TEmoji, TAPIResponse } from "../types/index.js";
+type TRandomEmoji = TAPIResponse & {
+    payload: null | TEmoji;
+};
+declare function getRandomEmoji(): Promise<TRandomEmoji>;
+export type { TRandomEmoji };
+export { getRandomEmoji };
+//# sourceMappingURL=get-random.d.ts.map

package/dist/get-random-emoji/get-random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-random.d.ts","sourceRoot":"","sources":["../../src/get-random-emoji/get-random.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,KAAK,YAAY,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC;AAG9D,iBAAe,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CAyBrD;AAGD,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/get-random-emoji/get-random.js

@@ -0,0 +1,32 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function getRandomEmoji() {
+    try {
+        /* setup and fetch */
+        const API_URL = `${API_BASE_URL}/api/random`;
+        const response = await fetch(API_URL);
+        /* check and return */
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        else {
+            const emoji = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered",
+                payload: emoji
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Get Random Emoji: Encountered Error!",
+            payload: null
+        };
+    }
+}
+export { getRandomEmoji };
+//# sourceMappingURL=get-random.js.map

package/dist/get-random-emoji/get-random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-random.js","sourceRoot":"","sources":["../../src/get-random-emoji/get-random.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,YAAY;AACZ,KAAK,UAAU,cAAc;IACzB,IAAI,CAAC;QACD,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,aAAa,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE,KAAK;aACjB,CAAA;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,sCAAsC;YAC/C,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAID,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/get-random-emoji/index.d.ts

@@ -0,0 +1,8 @@
+import { TEmoji, TAPIResponse } from "../types/index.js";
+type TRandomEmojiResponse = TAPIResponse & {
+    payload: null | TEmoji;
+};
+declare function getRandomEmoji(): Promise<TRandomEmojiResponse>;
+export type { TRandomEmojiResponse };
+export { getRandomEmoji };
+//# sourceMappingURL=index.d.ts.map

package/dist/get-random-emoji/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/get-random-emoji/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,KAAK,oBAAoB,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC;AAGtE,iBAAe,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAyB7D;AAGD,YAAY,EAAE,oBAAoB,EAAE,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/get-random-emoji/index.js

@@ -0,0 +1,32 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function getRandomEmoji() {
+    try {
+        /* setup and fetch */
+        const API_URL = `${API_BASE_URL}/api/random`;
+        const response = await fetch(API_URL);
+        /* check and return */
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        else {
+            const emoji = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered",
+                payload: emoji
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Get Random Emoji: Encountered Error!",
+            payload: null
+        };
+    }
+}
+export { getRandomEmoji };
+//# sourceMappingURL=index.js.map

package/dist/get-random-emoji/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/get-random-emoji/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,YAAY;AACZ,KAAK,UAAU,cAAc;IACzB,IAAI,CAAC;QACD,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,aAAa,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO;gBACH,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE,KAAK;aACjB,CAAA;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,sCAAsC;YAC/C,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAID,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./get-random-emoji/get-random.js";
+export * from "./get-random-emoji/get-random-by-category.js";
+export * from "./get-random-emoji/get-random-by-group.js";
+export * from "./get-all-emojis/index.js";
+export * from "./get-all-emoji-categories/index.js";
+export * from "./get-all-emoji-groups/index.js";
+export * from "./search-emojis/search-emojis-by-name.js";
+export * from "./search-emojis/search-similar-emojis-by-name.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC;AACzD,cAAc,kDAAkD,CAAC;AACjE,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/* exports */
+export * from "./get-random-emoji/get-random.js";
+export * from "./get-random-emoji/get-random-by-category.js";
+export * from "./get-random-emoji/get-random-by-group.js";
+export * from "./get-all-emojis/index.js";
+export * from "./get-all-emoji-categories/index.js";
+export * from "./get-all-emoji-groups/index.js";
+export * from "./search-emojis/search-emojis-by-name.js";
+export * from "./search-emojis/search-similar-emojis-by-name.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,kCAAkC,CAAC;AACjD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,0CAA0C,CAAC;AACzD,cAAc,kDAAkD,CAAC;AACjE,cAAc,kBAAkB,CAAC"}

package/dist/search-emojis/search-emojis-by-name.d.ts

@@ -0,0 +1,14 @@
+import { TEmoji, TAPIResponse } from "../types/index.js";
+type TEmojiSearchResponse = TAPIResponse & {
+    payload: null | {
+        totalResults: number;
+        results: TEmoji[];
+    };
+};
+type TInput = {
+    query: string;
+};
+declare function searchEmojisByName(props: TInput): Promise<TEmojiSearchResponse>;
+export type { TEmojiSearchResponse };
+export { searchEmojisByName };
+//# sourceMappingURL=search-emojis-by-name.d.ts.map

package/dist/search-emojis/search-emojis-by-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-emojis-by-name.d.ts","sourceRoot":"","sources":["../../src/search-emojis/search-emojis-by-name.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,KAAK,oBAAoB,GAAG,YAAY,GAAG;IACvC,OAAO,EAAE,IAAI,GAAG;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAA;CACJ,CAAC;AACF,KAAK,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAGhC,iBAAe,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoC9E;AAGD,YAAY,EAAE,oBAAoB,EAAE,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/search-emojis/search-emojis-by-name.js

@@ -0,0 +1,43 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function searchEmojisByName(props) {
+    try {
+        /* props - destruct */
+        const { query } = props;
+        if (query.length <= 0) {
+            throw new Error("Emoji Search: Query must be at least 1 character long!");
+        }
+        else {
+            /* setup and fetch */
+            const encoded = encodeURIComponent(query);
+            const API_URL = `${API_BASE_URL}/api/search?q=${encoded}`;
+            const response = await fetch(API_URL);
+            /* check and return */
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            else {
+                const results = await response.json();
+                return {
+                    code: "api-ok",
+                    message: "No errors encountered",
+                    payload: {
+                        results: results,
+                        totalResults: results.length
+                    }
+                };
+            }
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Search Emoji(s) By Name: Encountered Error!",
+            payload: null
+        };
+    }
+}
+export { searchEmojisByName };
+//# sourceMappingURL=search-emojis-by-name.js.map

package/dist/search-emojis/search-emojis-by-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-emojis-by-name.js","sourceRoot":"","sources":["../../src/search-emojis/search-emojis-by-name.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYlD,YAAY;AACZ,KAAK,UAAU,kBAAkB,CAAC,KAAa;IAC3C,IAAI,CAAC;QACD,sBAAsB;QACtB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;QAExB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC9E,CAAC;aAAM,CAAC;YACJ,qBAAqB;YACrB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,GAAG,YAAY,iBAAiB,OAAO,EAAE,CAAC;YAC1D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YAEtC,sBAAsB;YACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtC,OAAO;oBACH,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,uBAAuB;oBAChC,OAAO,EAAE;wBACL,OAAO,EAAE,OAAO;wBAChB,YAAY,EAAE,OAAO,CAAC,MAAM;qBAC/B;iBACJ,CAAA;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,6CAA6C;YACtD,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAID,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/search-emojis/search-similar-emojis-by-name.d.ts

@@ -0,0 +1,14 @@
+import { TEmoji, TAPIResponse } from "../types/index.js";
+type TEmojiSimilarSearchResponse = TAPIResponse & {
+    payload: null | {
+        totalResults: number;
+        results: TEmoji[];
+    };
+};
+type TInput = {
+    query: string;
+};
+declare function searchSimilarEmojisByName(props: TInput): Promise<TEmojiSimilarSearchResponse>;
+export type { TEmojiSimilarSearchResponse };
+export { searchSimilarEmojisByName };
+//# sourceMappingURL=search-similar-emojis-by-name.d.ts.map

package/dist/search-emojis/search-similar-emojis-by-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-similar-emojis-by-name.d.ts","sourceRoot":"","sources":["../../src/search-emojis/search-similar-emojis-by-name.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,KAAK,2BAA2B,GAAG,YAAY,GAAG;IAC9C,OAAO,EAAE,IAAI,GAAG;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAA;CACJ,CAAC;AACF,KAAK,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAGhC,iBAAe,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAoC5F;AAGD,YAAY,EAAE,2BAA2B,EAAE,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/search-emojis/search-similar-emojis-by-name.js

@@ -0,0 +1,43 @@
+/* app imports */
+import { API_BASE_URL } from "../shared/index.js";
+/* module */
+async function searchSimilarEmojisByName(props) {
+    try {
+        /* props - destruct */
+        const { query } = props;
+        if (query.length <= 0) {
+            throw new Error("Emoji Similar Search: Query must be at least 1 character long!");
+        }
+        else {
+            /* setup and fetch */
+            const encoded = encodeURIComponent(query);
+            const API_URL = `${API_BASE_URL}/api/similar/${encoded}`;
+            const response = await fetch(API_URL);
+            /* check and return */
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            else {
+                const results = await response.json();
+                return {
+                    code: "api-ok",
+                    message: "No errors encountered",
+                    payload: {
+                        results: results,
+                        totalResults: results.length
+                    }
+                };
+            }
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Search Similar Emoji(s) By Name: Encountered Error!",
+            payload: null
+        };
+    }
+}
+export { searchSimilarEmojisByName };
+//# sourceMappingURL=search-similar-emojis-by-name.js.map

package/dist/search-emojis/search-similar-emojis-by-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-similar-emojis-by-name.js","sourceRoot":"","sources":["../../src/search-emojis/search-similar-emojis-by-name.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYlD,YAAY;AACZ,KAAK,UAAU,yBAAyB,CAAC,KAAa;IAClD,IAAI,CAAC;QACD,sBAAsB;QACtB,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;QAExB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACJ,qBAAqB;YACrB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,GAAG,YAAY,gBAAgB,OAAO,EAAE,CAAC;YACzD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YAEtC,sBAAsB;YACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtC,OAAO;oBACH,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,uBAAuB;oBAChC,OAAO,EAAE;wBACL,OAAO,EAAE,OAAO;wBAChB,YAAY,EAAE,OAAO,CAAC,MAAM;qBAC/B;iBACJ,CAAA;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,qDAAqD;YAC9D,OAAO,EAAE,IAAI;SAChB,CAAA;IACL,CAAC;AACL,CAAC;AAID,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,2 @@
+export declare const API_BASE_URL = "https://emojihub.yurace.pro";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY,gCAAgC,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,3 @@
+/* api root url */
+export const API_BASE_URL = 'https://emojihub.yurace.pro';
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,MAAM,CAAC,MAAM,YAAY,GAAG,6BAA6B,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export type TAPIResponse = {
+    code: "api-ok" | "api-fail";
+    message: string;
+};
+export type TEmoji = Record<string, any>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACnB,CAAA;AACD,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/random-emoji.d.ts

@@ -0,0 +1,5 @@
+import { TEmoji, TAPIResponse } from "./index.js";
+export type TRandomEmojiResponse = TAPIResponse & {
+    payload: null | TEmoji;
+};
+//# sourceMappingURL=random-emoji.d.ts.map

package/dist/types/random-emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-emoji.d.ts","sourceRoot":"","sources":["../../src/types/random-emoji.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG;IAAE,OAAO,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/random-emoji.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=random-emoji.js.map

package/dist/types/random-emoji.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-emoji.js","sourceRoot":"","sources":["../../src/types/random-emoji.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "emoji-hub-api-client",
+  "description": "A lightweight JavaScript and TypeScript client for the EmojiHub API, allowing easy access to emojis by category, group, search, and random selection.",
+  "type": "module",
+  "version": "1.0.0",
+    "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+     "emoji",
+    "emojis",
+    "emoji-api",
+    "emojihub",
+    "unicode",
+    "symbols",
+    "fun-api",
+    "public-api",
+    "api-client",
+    "http-client",
+    "javascript",
+    "typescript"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NPM-Workbench/emoji-hub-api-client"
+  },
+  "homepage": "https://github.com/NPM-Workbench/emoji-hub-api-client",
+  "bugs": {
+    "url": "https://github.com/NPM-Workbench/emoji-hub-api-client/issues"
+  }
+}