katanakit-js 3.2.1 → 4.0.2

package/dist/adapters/bun/dummyjson.service.d.ts

@@ -0,0 +1,88 @@
+/** Base URL of the public dummyjson.com REST API. */
+export declare const DUMMYJSON_BASE_URL = "https://dummyjson.com";
+/**
+ * Registers the dummyjson.com API in the HTTP manager under the `dummyjson`
+ * key. Call once before any {@link useDummyJsonProducts}-style handler.
+ *
+ * @example
+ * ```ts
+ * import { useInitDummyJson } from "katanakit-js/adapters/bun";
+ *
+ * useInitDummyJson();
+ * ```
+ */
+export declare function useInitDummyJson(): void;
+/** Serializes `data` into a JSON {@link Response}. */
+export declare function jsonResponse(data: unknown, status?: number): Response;
+/**
+ * Lists products from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the product list.
+ */
+export declare function useDummyJsonProducts(): Promise<Response>;
+/**
+ * Fetches a single product by id.
+ *
+ * @param id - The product id.
+ * @returns A JSON `Response` wrapping the product.
+ */
+export declare function useDummyJsonProductById(id: string): Promise<Response>;
+/**
+ * Searches products by a free-text query.
+ *
+ * @param query - The search term.
+ * @returns A JSON `Response` wrapping the search results.
+ */
+export declare function useDummyJsonProductSearch(query: string): Promise<Response>;
+/**
+ * Lists all product categories.
+ *
+ * @returns A JSON `Response` wrapping the category list.
+ */
+export declare function useDummyJsonProductCategories(): Promise<Response>;
+/**
+ * Lists products within a category.
+ *
+ * @param category - The category slug (e.g. `smartphones`).
+ * @returns A JSON `Response` wrapping the products.
+ */
+export declare function useDummyJsonProductsByCategory(category: string): Promise<Response>;
+/**
+ * Lists users from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the user list.
+ */
+export declare function useDummyJsonUsers(): Promise<Response>;
+/**
+ * Fetches a single user by id.
+ *
+ * @param id - The user id.
+ * @returns A JSON `Response` wrapping the user.
+ */
+export declare function useDummyJsonUserById(id: string): Promise<Response>;
+/**
+ * Lists posts from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the post list.
+ */
+export declare function useDummyJsonPosts(): Promise<Response>;
+/**
+ * Fetches a single post by id.
+ *
+ * @param id - The post id.
+ * @returns A JSON `Response` wrapping the post.
+ */
+export declare function useDummyJsonPostById(id: string): Promise<Response>;
+/**
+ * Lists quotes from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the quote list.
+ */
+export declare function useDummyJsonQuotes(): Promise<Response>;
+/**
+ * Fetches a random quote from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the quote.
+ */
+export declare function useDummyJsonRandomQuote(): Promise<Response>;
+//# sourceMappingURL=dummyjson.service.d.ts.map

package/dist/adapters/bun/dummyjson.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dummyjson.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/dummyjson.service.ts"],"names":[],"mappings":"AAGA,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAiB1D;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAkBD,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,QAAQ,CAKlE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE9D;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE3E;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAIhF;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEvE;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAIxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE5D;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEjE"}

package/dist/adapters/bun/dummyjson.service.js

@@ -0,0 +1,149 @@
+import { useFetch, useInitApis } from "../../core/services/http.service.js";
+/** Base URL of the public dummyjson.com REST API. */
+export const DUMMYJSON_BASE_URL = "https://dummyjson.com";
+/** Endpoints of the dummyjson.com REST API (relative to {@link DUMMYJSON_BASE_URL}). */
+const DUMMYJSON_ENDPOINTS = {
+    products: "/products",
+    productById: "/products/:id",
+    productSearch: "/products/search",
+    productCategories: "/products/categories",
+    productByCategory: "/products/category/:category",
+    users: "/users",
+    userById: "/users/:id",
+    posts: "/posts",
+    postById: "/posts/:id",
+    quotes: "/quotes",
+    quoteRandom: "/quotes/random",
+};
+/**
+ * Registers the dummyjson.com API in the HTTP manager under the `dummyjson`
+ * key. Call once before any {@link useDummyJsonProducts}-style handler.
+ *
+ * @example
+ * ```ts
+ * import { useInitDummyJson } from "katanakit-js/adapters/bun";
+ *
+ * useInitDummyJson();
+ * ```
+ */
+export function useInitDummyJson() {
+    useInitApis({
+        dummyjson: {
+            baseUri: DUMMYJSON_BASE_URL,
+            endpoints: DUMMYJSON_ENDPOINTS,
+        },
+    });
+}
+/**
+ * Converts a Safe Result into a JSON {@link Response}.
+ *
+ * @param result - The Safe Result from `useFetch`.
+ * @returns A JSON `Response` with the data or error body.
+ */
+function toResponse(result) {
+    if (result.ok) {
+        return jsonResponse(result.data);
+    }
+    return jsonResponse({ message: result.error.message, details: result.error.details }, result.error.status || 500);
+}
+/** Serializes `data` into a JSON {@link Response}. */
+export function jsonResponse(data, status = 200) {
+    return new Response(JSON.stringify(data), {
+        status,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+/**
+ * Lists products from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the product list.
+ */
+export async function useDummyJsonProducts() {
+    return toResponse(await useFetch("dummyjson", "products"));
+}
+/**
+ * Fetches a single product by id.
+ *
+ * @param id - The product id.
+ * @returns A JSON `Response` wrapping the product.
+ */
+export async function useDummyJsonProductById(id) {
+    return toResponse(await useFetch("dummyjson", "productById", { urlOptions: { params: { id } } }));
+}
+/**
+ * Searches products by a free-text query.
+ *
+ * @param query - The search term.
+ * @returns A JSON `Response` wrapping the search results.
+ */
+export async function useDummyJsonProductSearch(query) {
+    return toResponse(await useFetch("dummyjson", "productSearch", { urlOptions: { query: { q: query } } }));
+}
+/**
+ * Lists all product categories.
+ *
+ * @returns A JSON `Response` wrapping the category list.
+ */
+export async function useDummyJsonProductCategories() {
+    return toResponse(await useFetch("dummyjson", "productCategories"));
+}
+/**
+ * Lists products within a category.
+ *
+ * @param category - The category slug (e.g. `smartphones`).
+ * @returns A JSON `Response` wrapping the products.
+ */
+export async function useDummyJsonProductsByCategory(category) {
+    return toResponse(await useFetch("dummyjson", "productByCategory", { urlOptions: { params: { category } } }));
+}
+/**
+ * Lists users from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the user list.
+ */
+export async function useDummyJsonUsers() {
+    return toResponse(await useFetch("dummyjson", "users"));
+}
+/**
+ * Fetches a single user by id.
+ *
+ * @param id - The user id.
+ * @returns A JSON `Response` wrapping the user.
+ */
+export async function useDummyJsonUserById(id) {
+    return toResponse(await useFetch("dummyjson", "userById", { urlOptions: { params: { id } } }));
+}
+/**
+ * Lists posts from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the post list.
+ */
+export async function useDummyJsonPosts() {
+    return toResponse(await useFetch("dummyjson", "posts"));
+}
+/**
+ * Fetches a single post by id.
+ *
+ * @param id - The post id.
+ * @returns A JSON `Response` wrapping the post.
+ */
+export async function useDummyJsonPostById(id) {
+    return toResponse(await useFetch("dummyjson", "postById", { urlOptions: { params: { id } } }));
+}
+/**
+ * Lists quotes from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the quote list.
+ */
+export async function useDummyJsonQuotes() {
+    return toResponse(await useFetch("dummyjson", "quotes"));
+}
+/**
+ * Fetches a random quote from dummyjson.com.
+ *
+ * @returns A JSON `Response` wrapping the quote.
+ */
+export async function useDummyJsonRandomQuote() {
+    return toResponse(await useFetch("dummyjson", "quoteRandom"));
+}
+//# sourceMappingURL=dummyjson.service.js.map

package/dist/adapters/bun/dummyjson.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dummyjson.service.js","sourceRoot":"","sources":["../../../src/adapters/bun/dummyjson.service.ts"],"names":[],"mappings":"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"}

package/dist/adapters/bun/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./dummyjson.service.js";
+export * from "./routes.js";
+export * from "./seed.js";
+export * from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/bun/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/adapters/bun/index.js

@@ -0,0 +1,5 @@
+export * from "./dummyjson.service.js";
+export * from "./routes.js";
+export * from "./seed.js";
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/bun/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/bun/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/adapters/bun/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/adapters/bun/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/main.ts"],"names":[],"mappings":""}

package/dist/adapters/bun/main.js

@@ -0,0 +1,6 @@
+import { useInitDummyJson } from "./dummyjson.service.js";
+import { useBunStart } from "./server.js";
+useInitDummyJson();
+const server = useBunStart(Number(process.env.PORT ?? 3000), process.env.HOST ?? "localhost");
+console.log(`Server running at ${server.url}`);
+//# sourceMappingURL=main.js.map

package/dist/adapters/bun/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/adapters/bun/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,gBAAgB,EAAE,CAAC;AAEnB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC;AAC9F,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/adapters/bun/routes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Builds the Bun.serve `routes` table for the dummyjson.com demo.
+ *
+ * Maps KatanaKit's dummyjson handlers onto a Bun router: static routes,
+ * `:param` routes (with typed `req.params`), per-method handlers, and a
+ * `/api/*` catch-all.
+ *
+ * @returns A route table ready for `Bun.serve({ routes })`.
+ *
+ * @example
+ * ```ts
+ * import { useBuildDummyJsonRoutes } from "katanakit-js/adapters/bun";
+ *
+ * Bun.serve({
+ *   routes: useBuildDummyJsonRoutes(),
+ *   fetch: () => new Response("Not Found", { status: 404 }),
+ * });
+ * ```
+ */
+export declare function useBuildDummyJsonRoutes(): {
+    "/api/status": Response;
+    "/api/products": {
+        GET: () => Promise<Response>;
+    };
+    "/api/products/:id": {
+        GET: (req: Bun.BunRequest<"/api/products/:id">) => Promise<Response>;
+    };
+    "/api/products/search": {
+        GET: (req: Request) => Promise<Response>;
+    };
+    "/api/products/categories": {
+        GET: () => Promise<Response>;
+    };
+    "/api/products/category/:category": {
+        GET: (req: Bun.BunRequest<"/api/products/category/:category">) => Promise<Response>;
+    };
+    "/api/users": {
+        GET: () => Promise<Response>;
+    };
+    "/api/users/:id": {
+        GET: (req: Bun.BunRequest<"/api/users/:id">) => Promise<Response>;
+    };
+    "/api/posts": {
+        GET: () => Promise<Response>;
+    };
+    "/api/posts/:id": {
+        GET: (req: Bun.BunRequest<"/api/posts/:id">) => Promise<Response>;
+    };
+    "/api/quotes": {
+        GET: () => Promise<Response>;
+    };
+    "/api/quotes/random": {
+        GET: () => Promise<Response>;
+    };
+    "/api/seed": {
+        GET: () => Response;
+    };
+    "/api/*": Response;
+};
+/** Route table type inferred from {@link useBuildDummyJsonRoutes}. */
+export type DummyJsonRoutes = ReturnType<typeof useBuildDummyJsonRoutes>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/adapters/bun/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/routes.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB;;;;;;mBAOzB,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC;;;mBAGnC,OAAO;;;;;;mBAOP,GAAG,CAAC,UAAU,CAAC,kCAAkC,CAAC;;;;;;mBAOlD,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;;;;;;mBAMhC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;;;;;;;;;;;;EAa7C;AAED,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/adapters/bun/routes.js

@@ -0,0 +1,60 @@
+/// <reference types="bun-types" />
+import { jsonResponse, useDummyJsonPostById, useDummyJsonPosts, useDummyJsonProductById, useDummyJsonProductCategories, useDummyJsonProducts, useDummyJsonProductsByCategory, useDummyJsonProductSearch, useDummyJsonQuotes, useDummyJsonRandomQuote, useDummyJsonUserById, useDummyJsonUsers, } from "./dummyjson.service.js";
+import { useGetDummyJsonSeed } from "./seed.js";
+/**
+ * Builds the Bun.serve `routes` table for the dummyjson.com demo.
+ *
+ * Maps KatanaKit's dummyjson handlers onto a Bun router: static routes,
+ * `:param` routes (with typed `req.params`), per-method handlers, and a
+ * `/api/*` catch-all.
+ *
+ * @returns A route table ready for `Bun.serve({ routes })`.
+ *
+ * @example
+ * ```ts
+ * import { useBuildDummyJsonRoutes } from "katanakit-js/adapters/bun";
+ *
+ * Bun.serve({
+ *   routes: useBuildDummyJsonRoutes(),
+ *   fetch: () => new Response("Not Found", { status: 404 }),
+ * });
+ * ```
+ */
+export function useBuildDummyJsonRoutes() {
+    return {
+        "/api/status": jsonResponse({ status: "ok", service: "katanakit-js/adapters/bun" }),
+        // Products
+        "/api/products": { GET: () => useDummyJsonProducts() },
+        "/api/products/:id": {
+            GET: (req) => useDummyJsonProductById(req.params.id),
+        },
+        "/api/products/search": {
+            GET: (req) => {
+                const query = new URL(req.url).searchParams.get("q") ?? "";
+                return useDummyJsonProductSearch(query);
+            },
+        },
+        "/api/products/categories": { GET: () => useDummyJsonProductCategories() },
+        "/api/products/category/:category": {
+            GET: (req) => useDummyJsonProductsByCategory(req.params.category),
+        },
+        // Users
+        "/api/users": { GET: () => useDummyJsonUsers() },
+        "/api/users/:id": {
+            GET: (req) => useDummyJsonUserById(req.params.id),
+        },
+        // Posts
+        "/api/posts": { GET: () => useDummyJsonPosts() },
+        "/api/posts/:id": {
+            GET: (req) => useDummyJsonPostById(req.params.id),
+        },
+        // Quotes
+        "/api/quotes": { GET: () => useDummyJsonQuotes() },
+        "/api/quotes/random": { GET: () => useDummyJsonRandomQuote() },
+        // Offline seed
+        "/api/seed": { GET: () => jsonResponse(useGetDummyJsonSeed()) },
+        // Catch-all for unmatched /api/* routes
+        "/api/*": jsonResponse({ message: "Not found" }, 404),
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/adapters/bun/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/adapters/bun/routes.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EACN,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,yBAAyB,EACzB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,uBAAuB;IACtC,OAAO;QACN,aAAa,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QAEnF,WAAW;QACX,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,oBAAoB,EAAE,EAAE;QACtD,mBAAmB,EAAE;YACpB,GAAG,EAAE,CAAC,GAAwC,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;SACzF;QACD,sBAAsB,EAAE;YACvB,GAAG,EAAE,CAAC,GAAY,EAAE,EAAE;gBACrB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC3D,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;SACD;QACD,0BAA0B,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,6BAA6B,EAAE,EAAE;QAC1E,kCAAkC,EAAE;YACnC,GAAG,EAAE,CAAC,GAAuD,EAAE,EAAE,CAChE,8BAA8B,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;SACpD;QAED,QAAQ;QACR,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,EAAE;QAChD,gBAAgB,EAAE;YACjB,GAAG,EAAE,CAAC,GAAqC,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;SACnF;QAED,QAAQ;QACR,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,EAAE;QAChD,gBAAgB,EAAE;YACjB,GAAG,EAAE,CAAC,GAAqC,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;SACnF;QAED,SAAS;QACT,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,EAAE;QAClD,oBAAoB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,uBAAuB,EAAE,EAAE;QAE9D,eAAe;QACf,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC,EAAE;QAE/D,wCAAwC;QACxC,QAAQ,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC;KACrD,CAAC;AACH,CAAC"}

package/dist/adapters/bun/seed.d.ts

@@ -0,0 +1,65 @@
+/** A single product in the dummyjson-shaped seed. */
+export interface SeedProduct {
+    id: number;
+    title: string;
+    description: string;
+    category: string;
+    price: number;
+    rating: number;
+    stock: number;
+    brand: string;
+}
+/** A single user in the dummyjson-shaped seed. */
+export interface SeedUser {
+    id: number;
+    firstName: string;
+    lastName: string;
+    username: string;
+    email: string;
+    age: number;
+    role: string;
+}
+/** A single post in the dummyjson-shaped seed. */
+export interface SeedPost {
+    id: number;
+    title: string;
+    body: string;
+    tags: string[];
+    reactions: number;
+    userId: number;
+}
+/** A single quote in the dummyjson-shaped seed. */
+export interface SeedQuote {
+    id: number;
+    quote: string;
+    author: string;
+}
+/** Container for the Bun adapter seed data (dummyjson-compatible shapes). */
+export interface DummyJsonSeed {
+    products: SeedProduct[];
+    users: SeedUser[];
+    posts: SeedPost[];
+    quotes: SeedQuote[];
+}
+/**
+ * Offline seed data shaped after https://dummyjson.com responses.
+ * Useful for tests, demos and local development without hitting the network.
+ *
+ * Deep-frozen so callers can't mutate the shared module singleton.
+ */
+export declare const dummyJsonSeed: DummyJsonSeed;
+/**
+ * Returns the Bun adapter seed data.
+ *
+ * @returns The deep-frozen {@link dummyJsonSeed}.
+ *
+ * @example
+ * ```ts
+ * import { useGetDummyJsonSeed } from "katanakit-js/adapters/bun";
+ *
+ * const seed = useGetDummyJsonSeed();
+ * seed.products; // [{ id: 1, title: "Essence Mascara Lash Princess", ... }]
+ * ```
+ */
+export declare function useGetDummyJsonSeed(): DummyJsonSeed;
+//# sourceMappingURL=seed.d.ts.map

package/dist/adapters/bun/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/seed.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAED,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;CACpB;AAaD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,aAoF1B,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/adapters/bun/seed.js

@@ -0,0 +1,117 @@
+/** Recursively freezes a value (arrays and plain objects) in place. */
+function deepFreeze(value) {
+    if (value && typeof value === "object" && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const key of Object.keys(value)) {
+            deepFreeze(value[key]);
+        }
+    }
+    return value;
+}
+/**
+ * Offline seed data shaped after https://dummyjson.com responses.
+ * Useful for tests, demos and local development without hitting the network.
+ *
+ * Deep-frozen so callers can't mutate the shared module singleton.
+ */
+export const dummyJsonSeed = deepFreeze({
+    products: [
+        {
+            id: 1,
+            title: "Essence Mascara Lash Princess",
+            description: "The Essence Mascara Lash Princess is a popular mascara known for its volumizing and lengthening effects.",
+            category: "beauty",
+            price: 9.99,
+            rating: 4.94,
+            stock: 5,
+            brand: "Essence",
+        },
+        {
+            id: 2,
+            title: "iPhone X",
+            description: "SIM-Free, Model A19211 6.5-inch Super Retina HD display with OLED technology.",
+            category: "smartphones",
+            price: 899,
+            rating: 4.44,
+            stock: 34,
+            brand: "Apple",
+        },
+        {
+            id: 3,
+            title: "Samsung Universe 9",
+            description: "Samsung's new variant which goes beyond Galaxy to the Universe.",
+            category: "smartphones",
+            price: 1249,
+            rating: 4.09,
+            stock: 36,
+            brand: "Samsung",
+        },
+    ],
+    users: [
+        {
+            id: 1,
+            firstName: "Terry",
+            lastName: "Medhurst",
+            username: "atuny0",
+            email: "atuny0@sohu.com",
+            age: 50,
+            role: "admin",
+        },
+        {
+            id: 2,
+            firstName: "Sheldon",
+            lastName: "Quigley",
+            username: "hbingley1",
+            email: "hbingley1@plala.or.jp",
+            age: 28,
+            role: "moderator",
+        },
+    ],
+    posts: [
+        {
+            id: 1,
+            title: "His mother had always taught him",
+            body: "His mother had always taught him not to ever think of himself as better than others...",
+            tags: ["history", "american", "crime"],
+            reactions: 2,
+            userId: 121,
+        },
+        {
+            id: 2,
+            title: "He was an expert but not in a discipline",
+            body: "He was an expert but not in a discipline that anyone could fully appreciate...",
+            tags: ["french", "fiction", "english"],
+            reactions: 2,
+            userId: 69,
+        },
+    ],
+    quotes: [
+        {
+            id: 1,
+            quote: "Life isn't about getting and having, it's about giving and being.",
+            author: "Kevin Kruse",
+        },
+        {
+            id: 2,
+            quote: "Whatever the mind of man can conceive and believe, it can achieve.",
+            author: "Napoleon Hill",
+        },
+    ],
+});
+/**
+ * Returns the Bun adapter seed data.
+ *
+ * @returns The deep-frozen {@link dummyJsonSeed}.
+ *
+ * @example
+ * ```ts
+ * import { useGetDummyJsonSeed } from "katanakit-js/adapters/bun";
+ *
+ * const seed = useGetDummyJsonSeed();
+ * seed.products; // [{ id: 1, title: "Essence Mascara Lash Princess", ... }]
+ * ```
+ */
+export function useGetDummyJsonSeed() {
+    return dummyJsonSeed;
+}
+//# sourceMappingURL=seed.js.map

package/dist/adapters/bun/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../../src/adapters/bun/seed.ts"],"names":[],"mappings":"AAgDA,uEAAuE;AACvE,SAAS,UAAU,CAAI,KAAQ;IAC9B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,UAAU,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB,UAAU,CAAC;IACtD,QAAQ,EAAE;QACT;YACC,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,+BAA+B;YACtC,WAAW,EACV,0GAA0G;YAC3G,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,SAAS;SAChB;QACD;YACC,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,+EAA+E;YAC5F,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,OAAO;SACd;QACD;YACC,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EAAE,iEAAiE;YAC9E,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,SAAS;SAChB;KACD;IACD,KAAK,EAAE;QACN;YACC,EAAE,EAAE,CAAC;YACL,SAAS,EAAE,OAAO;YAClB,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,iBAAiB;YACxB,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,OAAO;SACb;QACD;YACC,EAAE,EAAE,CAAC;YACL,SAAS,EAAE,SAAS;YACpB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,uBAAuB;YAC9B,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,WAAW;SACjB;KACD;IACD,KAAK,EAAE;QACN;YACC,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,kCAAkC;YACzC,IAAI,EAAE,wFAAwF;YAC9F,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC;YACtC,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,GAAG;SACX;QACD;YACC,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,0CAA0C;YACjD,IAAI,EAAE,gFAAgF;YACtF,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;YACtC,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,EAAE;SACV;KACD;IACD,MAAM,EAAE;QACP;YACC,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,mEAAmE;YAC1E,MAAM,EAAE,aAAa;SACrB;QACD;YACC,EAAE,EAAE,CAAC;YACL,KAAK,EAAE,oEAAoE;YAC3E,MAAM,EAAE,eAAe;SACvB;KACD;CACD,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB;IAClC,OAAO,aAAa,CAAC;AACtB,CAAC"}

package/dist/adapters/bun/server.d.ts

@@ -0,0 +1,53 @@
+import { type DummyJsonRoutes } from "./routes.js";
+/** Options accepted by {@link useBunCreate}. */
+export interface BunServerOptions {
+    /** Port to listen on (default `3000`). */
+    port?: string | number;
+    /** Hostname to bind to (default `"localhost"`). */
+    hostname?: string;
+    /** Route table (defaults to {@link useBuildDummyJsonRoutes}). */
+    routes?: DummyJsonRoutes;
+    /** Optional fallback handler for unmatched routes. */
+    fetch?: (req: Request, server: Bun.Server<undefined>) => Response | Promise<Response>;
+}
+/**
+ * Creates (or returns the existing) Bun HTTP server with the dummyjson route
+ * table. Idempotent — subsequent calls return the same server.
+ *
+ * Requires the Bun runtime (Bun v1.2.3+ for the `routes` API).
+ *
+ * @param options - Optional port, hostname, routes and fetch handler.
+ * @returns The running {@link Bun.Server}.
+ *
+ * @example
+ * ```ts
+ * import { useInitDummyJson, useBunCreate } from "katanakit-js/adapters/bun";
+ *
+ * useInitDummyJson();
+ * const server = useBunCreate({ port: 3000 });
+ * console.log(`Server running at ${server.url}`);
+ * ```
+ */
+export declare function useBunCreate(options?: BunServerOptions): Bun.Server<undefined>;
+/**
+ * Starts the Bun server on the given port/hostname (Singleton).
+ *
+ * @param port - Port to listen on (default `3000`).
+ * @param hostname - Hostname to bind to (default `"localhost"`).
+ * @returns The running {@link Bun.Server}.
+ */
+export declare function useBunStart(port?: string | number, hostname?: string): Bun.Server<undefined>;
+/**
+ * Returns the current Bun server singleton, or `null` before {@link useBunCreate}.
+ *
+ * @returns The {@link Bun.Server} or `null`.
+ */
+export declare function useBunGetServer(): Bun.Server<undefined> | null;
+/**
+ * Stops the Bun server and clears the singleton.
+ *
+ * @param closeActiveConnections - Immediately terminate in-flight requests.
+ * @returns A promise that resolves once all connections are closed.
+ */
+export declare function useBunStop(closeActiveConnections?: boolean): Promise<void>;
+//# sourceMappingURL=server.d.ts.map