@neupgroup/mapper 1.0.0

package/README.md

@@ -0,0 +1,66 @@
+# Neup.Mapper (Library)
+
+Neup.Mapper is now a small, framework-agnostic TypeScript library focused on two things:
+
+- Database connectivity via adapter pattern (bring your own driver)
+- HTTP API access via adapter pattern (bring your own client)
+
+## Install
+
+This project is currently private. Build locally:
+
+```
+npm install
+npm run build
+```
+
+Artifacts are emitted to `dist/`.
+
+## Usage
+
+### Database
+
+```
+import { createDb, IDbAdapter } from "neup-mapper";
+
+const adapter: IDbAdapter = {
+  async connect(config) {
+    // initialize your driver, e.g., pg, mysql2, sqlite, etc.
+  },
+  async query(sql, params) {
+    // delegate to your driver
+    return [];
+  },
+  async close() {
+    // close driver resources
+  },
+};
+
+const db = createDb(adapter);
+await db.connect({ host: "localhost" });
+const rows = await db.query("SELECT 1");
+await db.close();
+```
+
+### API
+
+```
+import { createApiClient, IApiAdapter } from "neup-mapper";
+
+const http: IApiAdapter = {
+  async request(req) {
+    // use fetch/axios/undici, return { status, headers, data }
+    return { status: 200, data: { ok: true } };
+  },
+};
+
+const api = createApiClient("https://api.example.com", http, { Authorization: "Bearer token" });
+const res = await api.get("/users");
+```
+
+## Layout
+
+- Source files live at the project root: `index.ts`, `db.ts`, `api.ts`.
+- Build emits to `dist/` with `index.js` and `index.d.ts` for consumers.
+- No React/Next.js UI is included; the project is library-only.
+- Add any DB driver or HTTP client as dependencies in your own app.

package/api.d.ts

@@ -0,0 +1,22 @@
+export interface ApiRequest {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export interface ApiResponse<T = unknown> {
+    status: number;
+    headers?: Record<string, string>;
+    data?: T;
+}
+export interface ApiAdapter {
+    request<T = unknown>(req: ApiRequest): Promise<ApiResponse<T>>;
+}
+export interface ApiClient {
+    get<T = unknown>(path: string, headers?: Record<string, string>): Promise<ApiResponse<T>>;
+    post<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<ApiResponse<T>>;
+    put<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<ApiResponse<T>>;
+    delete<T = unknown>(path: string, headers?: Record<string, string>): Promise<ApiResponse<T>>;
+}
+export declare function createApiClient(baseUrl: string, adapter: ApiAdapter, defaultHeaders?: Record<string, string>): ApiClient;
+export type { ApiAdapter as IApiAdapter };

package/api.js

@@ -0,0 +1,14 @@
+export function createApiClient(baseUrl, adapter, defaultHeaders) {
+    const buildUrl = (path) => {
+        if (!baseUrl)
+            return path;
+        return baseUrl.endsWith("/") ? `${baseUrl}${path.replace(/^\//, "")}` : `${baseUrl}/${path.replace(/^\//, "")}`;
+    };
+    const mergeHeaders = (headers) => ({ ...(defaultHeaders || {}), ...(headers || {}) });
+    return {
+        get: (path, headers) => adapter.request({ method: "GET", url: buildUrl(path), headers: mergeHeaders(headers) }),
+        post: (path, body, headers) => adapter.request({ method: "POST", url: buildUrl(path), headers: mergeHeaders(headers), body }),
+        put: (path, body, headers) => adapter.request({ method: "PUT", url: buildUrl(path), headers: mergeHeaders(headers), body }),
+        delete: (path, headers) => adapter.request({ method: "DELETE", url: buildUrl(path), headers: mergeHeaders(headers) }),
+    };
+}

package/db.d.ts

@@ -0,0 +1,19 @@
+export type QueryParams = unknown[] | Record<string, unknown> | undefined;
+export interface DbAdapter {
+    connect(config: Record<string, unknown>): Promise<void>;
+    query<T = unknown>(sql: string, params?: QueryParams): Promise<T[]>;
+    execute?(sql: string, params?: QueryParams): Promise<{
+        affectedRows?: number;
+    }>;
+    close(): Promise<void>;
+}
+export interface Db {
+    connect: (config: Record<string, unknown>) => Promise<void>;
+    query: <T = unknown>(sql: string, params?: QueryParams) => Promise<T[]>;
+    execute: (sql: string, params?: QueryParams) => Promise<{
+        affectedRows?: number;
+    }>;
+    close: () => Promise<void>;
+}
+export declare function createDb(adapter: DbAdapter): Db;
+export type { DbAdapter as IDbAdapter };

package/db.js

@@ -0,0 +1,15 @@
+export function createDb(adapter) {
+    const ensure = (fn) => fn();
+    return {
+        connect: (config) => ensure(() => adapter.connect(config)),
+        query: (sql, params) => ensure(() => adapter.query(sql, params)),
+        execute: (sql, params) => ensure(async () => {
+            if (typeof adapter.execute === "function") {
+                return adapter.execute(sql, params);
+            }
+            await adapter.query(sql, params);
+            return { affectedRows: undefined };
+        }),
+        close: () => ensure(() => adapter.close()),
+    };
+}

package/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./db";
+export * from "./api";

package/index.js

@@ -0,0 +1,2 @@
+export * from "./db";
+export * from "./api";

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@neupgroup/mapper",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": ["*.js", "*.d.ts"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5"
+  }
+}