jsonplaceholder-api-client 0.9.0-beta.1

package/README.md

@@ -0,0 +1,541 @@
+![json-placeholder-api-client-banner](https://github.com/user-attachments/assets/a26a1bfd-58d1-4e7b-b83e-b003d774cd40)
+
+# jsonplaceholder-API-client
+
+This package is a TypeScript-first wrapper around the [JSONPlaceholder](https://jsonplaceholder.typicode.com/) fake REST API. It provides clean, predictable helper functions for working with common resources such as posts, comments, albums, photos, todos, and users, covering the full CRUD surface `(GET, POST, PUT, PATCH, DELETE)`.
+<br/><br/>
+🌱 The goal of this library is not to replace JSONPlaceholder itself, but to offer a **Developer-Friendly SDK** with consistent response shapes, sensible defaults, and strong TypeScript typing — making it useful for learning, prototyping, demos, and testing frontend or SDK patterns.
+
+### 📻 **Beta Release**
+To encourage developers to download and utilize this package that is made available for your benefit. Additionally, you can post feedback on any issues you encounter so that the needed corrections can be done. Official release will be announced in sometime.
+
+### 📦 Installation
+
+```console
+npm install --save jsonplaceholder-api-client
+```
+
+### 👁 Quick Start
+
+```javascript
+/* node modules */
+import { getAllPosts } from 'jsonplaceholder-api-client';
+
+/* fn */
+async function quickStart() {
+  const response = await getAllPosts();
+  console.log(response);
+}
+
+/* call */
+await quickStart();
+
+/* Sample Response Schema
+{
+  code: "api-ok",
+  message: "No error encountered",
+  payload: ...
+}
+*/
+```
+
+### 🎲 Features
+
+1. Built with strong TypeScript typings from the ground up.
+2. Full REST surface for common JSONPlaceholder resources: `GET, POST, PUT, PATCH and DELETE`.
+3. Uniform response structures to simplify error handling and data access.
+4. ID-based fetches normalize empty API responses, making missing resources easy to handle.
+5. Clean, intention-revealing functions.
+6. Uses the native fetch API without adding unnecessary runtime dependencies.
+7. Designed for demos, tutorials, SDK experiments and frontend testing.
+
+### 📖 What is JSONPlaceholder?
+
+JSONPlaceholder is a free, public fake REST API that provides realistic but non-persistent data for common resources such as posts, comments, users, albums, photos, and todos. This is widely used by developers to practice working with REST APIs.
+
+### 💡 Why This Exists?
+
+JSONPlaceholder is an excellent fake REST API, but using it directly often means repeating the same boilerplate: manual fetch calls, ad-hoc response handling, loose typing, and inconsistent patterns across resources.<br/>
+This package exists to solve that by providing:
+
+1. **Strong TypeScript typings** for all resources and operations
+2. **Consistent, predictable response shapes** across every endpoint
+3. **Clear, intention-revealing helper functions** instead of raw HTTP calls
+   <br/>
+   The goal is not abstraction for abstraction’s sake, but to make working with JSONPlaceholder feel more structured, expressive, and developer-friendly — especially for learning, prototyping, demos, and SDK experimentation.
+
+### 💻 Usage
+
+📁 Resource Name: Albums<br/>
+
+1. Get All Albums
+
+```javascript
+import { getAllAlbums } from 'jsonplaceholder-api-client';
+const response = await getAllAlbums();
+/* Returns an array of album objects */
+```
+
+2. Get Album By ID
+
+```javascript
+import { getAlbumById } from 'jsonplaceholder-api-client';
+const response = await getAlbumById({ id: number });
+/* If the album does not exist, album is returned as null */
+```
+
+3. Create Album
+
+```javascript
+import { createNewAlbum } from 'jsonplaceholder-api-client';
+const response = await createNewAlbum({
+  title: string,
+  userId: number,
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+4. Update Album
+
+```javascript
+import { updateAlbum } from 'jsonplaceholder-api-client';
+const response = await updateAlbum({
+  id: number,
+  data: { id: number, title: string, userId: number },
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+5. Partial Update Album
+
+```javascript
+import { updateAlbumPartial } from "jsonplaceholder-api-client";
+const response = await updateAlbumPartial({
+  id: number,
+  data: { title?: string, userId?: number }
+});
+/* Need to give atleast 1 of the data fields. */
+/* Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+6. Delete Album
+
+```javascript
+import { deleteAlbum } from 'jsonplaceholder-api-client';
+const response = await deleteAlbum({ id: number });
+/* Mock delete endpoint. Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+<br/>📁 Resource Name: Comments<br/>
+
+1. Get All Comments
+
+```javascript
+import { getAllComments } from 'jsonplaceholder-api-client';
+const response = await getAllComments();
+/* Returns an array of comment objects */
+```
+
+2. Get Comment By ID
+
+```javascript
+import { getCommentById } from 'jsonplaceholder-api-client';
+const response = await getCommentById({ id: number });
+/* If the comment does not exist, comment is returned as null */
+```
+
+3. Create Comment
+
+```javascript
+import { createNewComment } from 'jsonplaceholder-api-client';
+const response = await createNewComment({
+  postId: number,
+  name: string,
+  email: string,
+  body: string,
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+4. Update Comment
+
+```javascript
+import { updateComment } from 'jsonplaceholder-api-client';
+const response = await updateComment({
+  id: number,
+  data: {
+    id: number,
+    postId: number,
+    name: string,
+    email: string,
+    body: string,
+  },
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+5. Partial Update Comment
+
+```javascript
+import { updateCommentPartial } from "jsonplaceholder-api-client";
+const response = await updateCommentPartial({
+  id: number,
+  data: {postId?: number, name?: string, email?: string, body?: string}
+});
+/* Need to give atleast 1 of the data fields. */
+/* Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+6. Delete Comment
+
+```javascript
+import { deleteComment } from 'jsonplaceholder-api-client';
+const response = await deleteComment({ id: number });
+/* Mock delete endpoint. Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+<br/>📁 Resource Name: Photos<br/>
+
+1. Get All Photos
+
+```javascript
+import { getAllPhotos } from 'jsonplaceholder-api-client';
+const response = await getAllPhotos();
+/* Returns an array of photo objects */
+```
+
+2. Get Photo By ID
+
+```javascript
+import { getPhotoById } from 'jsonplaceholder-api-client';
+const response = await getPhotoById({ id: number });
+/* If the photo does not exist, photo is returned as null */
+```
+
+3. Create Photo
+
+```javascript
+import { createNewPhoto } from 'jsonplaceholder-api-client';
+const response = await createNewPhoto({
+  albumId: number,
+  title: string,
+  url: string,
+  thumbnailUrl: string,
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+4. Update Photo
+
+```javascript
+import { updatePhoto } from 'jsonplaceholder-api-client';
+const response = await updatePhoto({
+  id: number,
+  data: {
+    id: number,
+    albumId: number,
+    title: string,
+    url: string,
+    thumbnailUrl: string,
+  },
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+5. Partial Update Photo
+
+```javascript
+import { updatePhotoPartial } from "jsonplaceholder-api-client";
+const response = await updatePhotoPartial({
+  id: number,
+  data: { albumId?: number, title?: string, url?: string, thumbnailUrl?: string }
+});
+/* Need to give atleast 1 of the data fields. */
+/* Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+6. Delete Photo
+
+```javascript
+import { deletePhoto } from 'jsonplaceholder-api-client';
+const response = await deletePhoto({ id: number });
+/* Mock delete endpoint. Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+<br/>📁 Resource Name: Posts<br/>
+
+1. Get All Posts
+
+```javascript
+import { getAllPosts } from 'jsonplaceholder-api-client';
+const response = await getAllPosts();
+/* Returns an array of post objects */
+```
+
+2. Get Post By ID
+
+```javascript
+import { getPostById } from 'jsonplaceholder-api-client';
+const response = await getPostById({ id: number });
+/* If the post does not exist, post is returned as null */
+```
+
+3. Create Post
+
+```javascript
+import { createNewPost } from 'jsonplaceholder-api-client';
+const response = await createNewPost({
+  userId: number,
+  title: string,
+  body: string,
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+4. Update Post
+
+```javascript
+import { updatePost } from 'jsonplaceholder-api-client';
+const response = await updatePost({
+  id: number,
+  data: { id: number, userId: number, title: string, body: string },
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+5. Partial Update Post
+
+```javascript
+import { updatePostPartial } from "jsonplaceholder-api-client";
+const response = await updatePostPartial({
+  id: number,
+  data: { userId?: number, title?: string, body?: string }
+});
+/* Need to give atleast 1 of the data fields. */
+/* Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+6. Delete Post
+
+```javascript
+import { deletePost } from 'jsonplaceholder-api-client';
+const response = await deletePost({ id: number });
+/* Mock delete endpoint. Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+<br/>📁 Resource Name: Todos<br/>
+
+1. Get All Todos
+
+```javascript
+import { getAllTodos } from 'jsonplaceholder-api-client';
+const response = await getAllTodos();
+/* Returns an array of todo objects */
+```
+
+2. Get Todo By ID
+
+```javascript
+import { getTodoById } from 'jsonplaceholder-api-client';
+const response = await getTodoById({ id: number });
+/* If the todo does not exist, todo is returned as null */
+```
+
+3. Create Todo
+
+```javascript
+import { createNewTodo } from 'jsonplaceholder-api-client';
+const response = await createNewTodo({
+  userId: number,
+  title: string,
+  completed: boolean,
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+4. Update Todo
+
+```javascript
+import { updateTodo } from 'jsonplaceholder-api-client';
+const response = await updateTodo({
+  id: number,
+  data: { id: number, userId: number, title: string, completed: boolean },
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+5. Partial Update Todo
+
+```javascript
+import { updateTodoPartial } from "jsonplaceholder-api-client";
+const response = await updateTodoPartial({
+  id: number,
+  data: { userId?: number, title?: string, completed?: boolean }
+});
+/* Need to give atleast 1 of the data fields. */
+/* Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+6. Delete Todo
+
+```javascript
+import { deleteTodo } from 'jsonplaceholder-api-client';
+const response = await deleteTodo({ id: number });
+/* Mock delete endpoint. Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+<br/>📁 Resource Name: Users<br/>
+
+1. Get All Users
+
+```javascript
+import { getAllUsers } from 'jsonplaceholder-api-client';
+const response = await getAllUsers();
+/* Returns an array of user objects */
+```
+
+2. Get User By ID
+
+```javascript
+import { getUserById } from 'jsonplaceholder-api-client';
+const response = await getUserById({ id: number });
+/* If the user does not exist, user is returned as null */
+```
+
+3. Create User
+
+```javascript
+import { createNewUser } from 'jsonplaceholder-api-client';
+const response = await createNewUser({
+  name: string,
+  username: string,
+  email: string,
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+4. Update User
+
+```javascript
+import { updateUser } from "jsonplaceholder-api-client";
+const response = await updateUser({
+  id: number,
+  data: {
+    id: number
+    name: string
+    username: string
+    email: string
+    address: {
+      street: string
+      suite: string
+      city: string
+      zipcode: string
+      geo: {
+        lat: string
+        lng: string
+      }
+    }
+    phone: string
+    website: string
+    company: {
+      name: string
+      catchPhrase: string
+      bs: string
+    }
+  }
+});
+/* All required fields. Changes not persisted (JSONPlaceholder behavior) */
+```
+
+5. Partial Update User
+
+```javascript
+import { updateUserPartial } from "jsonplaceholder-api-client";
+const response = await updateUserPartial({
+  id: number,
+  data: {
+    name?: string
+    username?: string
+    email?: string
+    address?: {
+      street?: string
+      suite?: string
+      city?: string
+      zipcode?: string
+      geo?: {
+        lat?: string
+        lng?: string
+      }
+    }
+    phone?: string
+    website?: string
+    company?: {
+      name?: string
+      catchPhrase?: string
+      bs?: string
+    }
+  }
+});
+/* Need to give atleast 1 of the data fields. */
+/* Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+6. Delete User
+
+```javascript
+import { deleteUser } from 'jsonplaceholder-api-client';
+const response = await deleteUser({ id: number });
+/* Mock delete endpoint. Changes are not persisted (JSONPlaceholder behavior). */
+```
+
+### 📗 Test Coverage
+
+```
+ PASS  src/todos/test/update-todo.test.ts
+ PASS  src/users/test/update-user.test.ts
+ PASS  src/users/test/get-all-users.test.ts
+ PASS  src/users/test/get-user-by-id.test.ts
+ PASS  src/users/test/update-user-partial.test.ts
+ PASS  src/users/test/create-new-user.test.ts
+ PASS  src/users/test/delete-user.test.ts
+ PASS  src/albums/test/update-album-partial.test.ts
+ PASS  src/photos/test/delete-photo.test.ts
+ PASS  src/comments/test/create-new-comment.test.ts
+ PASS  src/posts/test/update-post.test.ts
+ PASS  src/albums/test/get-album-by-id.test.ts
+ PASS  src/comments/test/update-comment-partial.test.ts
+ PASS  src/posts/test/get-post-by-id.test.ts
+ PASS  src/photos/test/update-photo.test.ts
+ PASS  src/comments/test/get-comment-by-id.test.ts
+ PASS  src/posts/test/update-post-partial.test.ts
+ PASS  src/photos/test/update-photo-partial.test.ts
+ PASS  src/photos/test/get-photo-by-id.test.ts
+ PASS  src/comments/test/delete-comment.test.ts
+ PASS  src/photos/test/get-all-photos.test.ts
+ PASS  src/photos/test/create-new-photo.test.ts
+ PASS  src/shared/test/index.test.ts
+ PASS  src/albums/test/delete-album.test.ts
+ PASS  src/comments/test/update-comment.test.ts
+ PASS  src/albums/test/update-album.test.ts
+ PASS  src/posts/test/get-all-posts.test.ts
+ PASS  src/posts/test/create-new-post.test.ts
+ PASS  src/posts/test/delete-post.test.ts
+ PASS  src/comments/test/get-all-comments.test.ts
+ PASS  src/albums/test/get-all-albums.test.ts
+ PASS  src/albums/test/create-new-album.test.ts
+ PASS  src/todos/test/create-new-todo.test.ts
+ PASS  src/todos/test/update-todo-partial.test.ts
+ PASS  src/todos/test/get-all-todos.test.ts
+ PASS  src/todos/test/delete-todo.test.ts
+ PASS  src/todos/test/get-todo-by-id.test.ts
+```
+If you would like to see a detailed report of the unit tests created and their respective file coverage, visit this [test-coverage](https://github.com/NPM-Workbench/jsonplaceholder-api-client/tree/master/test-report-md) link.
+
+### 📘 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/albums/create-new-album.d.ts

@@ -0,0 +1,15 @@
+import { TAPIResponse, TNewAlbum } from "../types/index.js";
+type TInput = {
+    title: string;
+    userId: number;
+};
+type TNewAlbumRes = TAPIResponse & {
+    payload: null | {
+        created: boolean;
+        album: null | TNewAlbum;
+    };
+};
+declare function createNewAlbum(props: TInput): Promise<TNewAlbumRes>;
+export type { TNewAlbumRes };
+export { createNewAlbum };
+//# sourceMappingURL=create-new-album.d.ts.map

package/dist/albums/create-new-album.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-new-album.d.ts","sourceRoot":"","sources":["../../src/albums/create-new-album.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI5D,KAAK,MAAM,GAAG;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC;AAC9C,KAAK,YAAY,GAAG,YAAY,GAAG;IACjC,OAAO,EAAE,IAAI,GAAG;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,IAAI,GAAG,SAAS,CAAA;KACxB,CAAA;CACF,CAAC;AAGF,iBAAe,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoClE;AAGD,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/albums/create-new-album.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNewAlbum = createNewAlbum;
+const api_base_url_js_1 = require("../shared/api-base-url.js");
+/* module */
+async function createNewAlbum(props) {
+    try {
+        if (typeof fetch !== "function") {
+            throw new Error("[Bad]: Global Fetch Not Available");
+        }
+        else {
+            /* setup and fetch */
+            const API_URL = `${api_base_url_js_1.API_BASE_URL}/albums`;
+            const response = await fetch(API_URL, {
+                method: "POST",
+                body: JSON.stringify(props),
+                headers: {
+                    'Content-type': 'application/json; charset=UTF-8',
+                }
+            });
+            /* check and return */
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            else {
+                const album = await response.json();
+                const payload = Object.keys(album).length <= 0 ? { created: false, album: null } : { created: true, album };
+                return {
+                    code: "api-ok",
+                    message: "No errors encountered. Check payload.",
+                    payload
+                };
+            }
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "[Bad]: Create New Album. Encountered Error.",
+            payload: { created: false, album: null }
+        };
+    }
+}
+//# sourceMappingURL=create-new-album.js.map

package/dist/albums/create-new-album.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-new-album.js","sourceRoot":"","sources":["../../src/albums/create-new-album.ts"],"names":[],"mappings":";;AAsDS,wCAAc;AApDvB,+DAAyD;AAWzD,YAAY;AACZ,KAAK,UAAU,cAAc,CAAC,KAAa;IACzC,IAAI,CAAC;QACH,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,qBAAqB;YACrB,MAAM,OAAO,GAAG,GAAG,8BAAY,SAAS,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;gBACpC,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAC3B,OAAO,EAAE;oBACP,cAAc,EAAE,iCAAiC;iBAClD;aACF,CAAC,CAAC;YAEH,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;gBACN,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,EAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC,EAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC;gBACxG,OAAO;oBACL,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,uCAAuC;oBAChD,OAAO;iBACR,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,6CAA6C;YACtD,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;SACzC,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/albums/delete-album.d.ts

@@ -0,0 +1,9 @@
+import { TAPIResponse } from "../types/index.js";
+type TInput = {
+    id: number;
+};
+type TAlbumDeleteRes = TAPIResponse;
+declare function deleteAlbum(props: TInput): Promise<TAlbumDeleteRes>;
+export type { TAlbumDeleteRes };
+export { deleteAlbum };
+//# sourceMappingURL=delete-album.d.ts.map

package/dist/albums/delete-album.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-album.d.ts","sourceRoot":"","sources":["../../src/albums/delete-album.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD,KAAK,MAAM,GAAG;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,CAAC;AAC3B,KAAK,eAAe,GAAG,YAAY,CAAC;AAGpC,iBAAe,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA2BlE;AAGD,YAAY,EAAE,eAAe,EAAE,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/albums/delete-album.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteAlbum = deleteAlbum;
+const api_base_url_js_1 = require("../shared/api-base-url.js");
+/* module */
+async function deleteAlbum(props) {
+    try {
+        if (typeof fetch !== "function") {
+            throw new Error("[Bad]: Global Fetch Not Available");
+        }
+        else {
+            /* setup and fetch */
+            const { id } = props;
+            const API_URL = `${api_base_url_js_1.API_BASE_URL}/albums/${id}`;
+            const response = await fetch(API_URL, { method: "DELETE" });
+            /* check and return */
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            else {
+                return {
+                    code: "api-ok",
+                    message: "Album Deleted Successfully. No Errors Encountered",
+                };
+            }
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "[Bad]: Delete Album. Encountered Error.",
+        };
+    }
+}
+//# sourceMappingURL=delete-album.js.map

package/dist/albums/delete-album.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-album.js","sourceRoot":"","sources":["../../src/albums/delete-album.ts"],"names":[],"mappings":";;AAwCS,kCAAW;AAtCpB,+DAAyD;AAMzD,YAAY;AACZ,KAAK,UAAU,WAAW,CAAC,KAAa;IACtC,IAAI,CAAC;QACH,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,qBAAqB;YACrB,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC;YACrB,MAAM,OAAO,GAAG,GAAG,8BAAY,WAAW,EAAE,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,EAAC,MAAM,EAAE,QAAQ,EAAC,CAAC,CAAC;YAE1D,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;gBACN,OAAO;oBACL,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,mDAAmD;iBAC7D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,yCAAyC;SACnD,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/albums/get-album-by-id.d.ts

@@ -0,0 +1,14 @@
+import { TAPIResponse, TAlbum } from "../types/index.js";
+type TInput = {
+    id: number;
+};
+type TAlbumsRes = TAPIResponse & {
+    payload: null | {
+        found: boolean;
+        album: null | TAlbum;
+    };
+};
+declare function getAlbumById(props: TInput): Promise<TAlbumsRes>;
+export type { TAlbumsRes };
+export { getAlbumById };
+//# sourceMappingURL=get-album-by-id.d.ts.map

package/dist/albums/get-album-by-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-album-by-id.d.ts","sourceRoot":"","sources":["../../src/albums/get-album-by-id.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIzD,KAAK,MAAM,GAAG;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,CAAC;AAC3B,KAAK,UAAU,GAAG,YAAY,GAAG;IAC/B,OAAO,EAAE,IAAI,GAAG;QACd,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,IAAI,GAAG,MAAM,CAAA;KACrB,CAAA;CACF,CAAC;AAGF,iBAAe,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA+B9D;AAGD,YAAY,EAAE,UAAU,EAAE,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,CAAC"}