@nara-web/core 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+export declare class HttpError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    constructor(message: string, statusCode?: number, code?: string);
+    toJSON(): Record<string, unknown>;
+}
+export declare class ValidationError extends HttpError {
+    readonly errors: Record<string, string[]>;
+    constructor(message?: string, errors?: Record<string, string[]>);
+    toJSON(): Record<string, unknown>;
+}
+export declare class AuthError extends HttpError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends HttpError {
+    constructor(message?: string);
+}
+export declare class ForbiddenError extends HttpError {
+    constructor(message?: string);
+}
+export declare class BadRequestError extends HttpError {
+    constructor(message?: string);
+}
+export declare class ConflictError extends HttpError {
+    constructor(message?: string);
+}
+export declare class TooManyRequestsError extends HttpError {
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+    toJSON(): Record<string, unknown>;
+}
+export declare class InternalError extends HttpError {
+    constructor(message?: string);
+}
+export declare function isHttpError(error: unknown): error is HttpError;
+export declare function isValidationError(error: unknown): error is ValidationError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAgBA,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,EAAE,IAAI,GAAE,MAAqB;IAWlF,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAcD,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAErC,OAAO,GAAE,MAA4B,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAMxF,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAWD,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,OAAO,GAAE,MAAuB;CAI7C;AAWD,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,GAAE,MAAoB;CAI1C;AAWD,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,GAAE,MAAoB;CAI1C;AAWD,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,GAAE,MAAsB;CAI5C;AAWD,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,GAAE,MAAmB;CAIzC;AAUD,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,GAAE,MAA4B,EAAE,UAAU,CAAC,EAAE,MAAM;IAMtE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAUD,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,GAAE,MAAgC;CAItD;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/errors.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalError = exports.TooManyRequestsError = exports.ConflictError = exports.BadRequestError = exports.ForbiddenError = exports.NotFoundError = exports.AuthError = exports.ValidationError = exports.HttpError = void 0;
+exports.isHttpError = isHttpError;
+exports.isValidationError = isValidationError;
+class HttpError extends Error {
+    constructor(message, statusCode = 500, code = 'HTTP_ERROR') {
+        super(message);
+        this.name = 'HttpError';
+        this.statusCode = statusCode;
+        this.code = code;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            statusCode: this.statusCode,
+            code: this.code,
+        };
+    }
+}
+exports.HttpError = HttpError;
+class ValidationError extends HttpError {
+    constructor(message = 'Validation failed', errors = {}) {
+        super(message, 422, 'VALIDATION_ERROR');
+        this.name = 'ValidationError';
+        this.errors = errors;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            errors: this.errors,
+        };
+    }
+}
+exports.ValidationError = ValidationError;
+class AuthError extends HttpError {
+    constructor(message = 'Unauthorized') {
+        super(message, 401, 'AUTH_ERROR');
+        this.name = 'AuthError';
+    }
+}
+exports.AuthError = AuthError;
+class NotFoundError extends HttpError {
+    constructor(message = 'Not Found') {
+        super(message, 404, 'NOT_FOUND');
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+class ForbiddenError extends HttpError {
+    constructor(message = 'Forbidden') {
+        super(message, 403, 'FORBIDDEN');
+        this.name = 'ForbiddenError';
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+class BadRequestError extends HttpError {
+    constructor(message = 'Bad Request') {
+        super(message, 400, 'BAD_REQUEST');
+        this.name = 'BadRequestError';
+    }
+}
+exports.BadRequestError = BadRequestError;
+class ConflictError extends HttpError {
+    constructor(message = 'Conflict') {
+        super(message, 409, 'CONFLICT');
+        this.name = 'ConflictError';
+    }
+}
+exports.ConflictError = ConflictError;
+class TooManyRequestsError extends HttpError {
+    constructor(message = 'Too Many Requests', retryAfter) {
+        super(message, 429, 'TOO_MANY_REQUESTS');
+        this.name = 'TooManyRequestsError';
+        this.retryAfter = retryAfter;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            ...(this.retryAfter && { retryAfter: this.retryAfter }),
+        };
+    }
+}
+exports.TooManyRequestsError = TooManyRequestsError;
+class InternalError extends HttpError {
+    constructor(message = 'Internal Server Error') {
+        super(message, 500, 'INTERNAL_ERROR');
+        this.name = 'InternalError';
+    }
+}
+exports.InternalError = InternalError;
+function isHttpError(error) {
+    return error instanceof HttpError;
+}
+function isValidationError(error) {
+    return error instanceof ValidationError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './adapters/types';
+//# 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":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./adapters/types"), exports);
+//# 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,0CAAwB;AACxB,mDAAiC"}

package/dist/response.d.ts

@@ -0,0 +1,29 @@
+import type { NaraResponse } from './types';
+import { PaginatedMeta } from '@services/Paginator';
+export type PaginationMeta = PaginatedMeta;
+export type { PaginatedMeta };
+export type ResponseMeta = PaginationMeta | Record<string, unknown>;
+export interface ApiSuccessResponse<T = unknown> {
+    success: true;
+    message: string;
+    data?: T;
+    meta?: ResponseMeta;
+}
+export interface ApiErrorResponse {
+    success: false;
+    message: string;
+    code?: string;
+    errors?: Record<string, string[]>;
+}
+export type ApiResponse<T = unknown> = ApiSuccessResponse<T> | ApiErrorResponse;
+export declare function jsonSuccess<T = unknown>(res: NaraResponse, message: string, data?: T, meta?: ResponseMeta, statusCode?: number): NaraResponse;
+export declare function jsonError(res: NaraResponse, message: string, statusCode?: number, code?: string, errors?: Record<string, string[]>): NaraResponse;
+export declare function jsonPaginated<T = unknown>(res: NaraResponse, message: string, data: T[], meta: PaginatedMeta): NaraResponse;
+export declare function jsonCreated<T = unknown>(res: NaraResponse, message: string, data?: T): NaraResponse;
+export declare function jsonNoContent(res: NaraResponse): NaraResponse;
+export declare function jsonUnauthorized(res: NaraResponse, message?: string): NaraResponse;
+export declare function jsonForbidden(res: NaraResponse, message?: string): NaraResponse;
+export declare function jsonNotFound(res: NaraResponse, message?: string): NaraResponse;
+export declare function jsonValidationError(res: NaraResponse, message?: string, errors?: Record<string, string[]>): NaraResponse;
+export declare function jsonServerError(res: NaraResponse, message?: string): NaraResponse;
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,CAAC;AAK9B,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAKpE,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAKD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAKD,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;AAyBhF,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACrC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,CAAC,EACR,IAAI,CAAC,EAAE,YAAY,EACnB,UAAU,GAAE,MAAY,GACvB,YAAY,CAgBd;AAyBD,wBAAgB,SAAS,CACvB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAY,EACxB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAChC,YAAY,CAgBd;AAwBD,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,aAAa,GAClB,YAAY,CAQd;AAUD,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACrC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,CAAC,GACP,YAAY,CAEd;AAYD,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAG7D;AAQD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,MAAuB,GAC/B,YAAY,CAEd;AAQD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,MAAoB,GAC5B,YAAY,CAEd;AAQD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,MAAoB,GAC5B,YAAY,CAEd;AAWD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,MAA4B,EACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAChC,YAAY,CAEd;AAQD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,MAAgC,GACxC,YAAY,CAEd"}

package/dist/response.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSuccess = jsonSuccess;
+exports.jsonError = jsonError;
+exports.jsonPaginated = jsonPaginated;
+exports.jsonCreated = jsonCreated;
+exports.jsonNoContent = jsonNoContent;
+exports.jsonUnauthorized = jsonUnauthorized;
+exports.jsonForbidden = jsonForbidden;
+exports.jsonNotFound = jsonNotFound;
+exports.jsonValidationError = jsonValidationError;
+exports.jsonServerError = jsonServerError;
+function jsonSuccess(res, message, data, meta, statusCode = 200) {
+    const response = {
+        success: true,
+        message,
+    };
+    if (data !== undefined) {
+        response.data = data;
+    }
+    if (meta !== undefined) {
+        response.meta = meta;
+    }
+    res.status(statusCode).json(response);
+    return res;
+}
+function jsonError(res, message, statusCode = 400, code, errors) {
+    const response = {
+        success: false,
+        message,
+    };
+    if (code !== undefined) {
+        response.code = code;
+    }
+    if (errors !== undefined) {
+        response.errors = errors;
+    }
+    res.status(statusCode).json(response);
+    return res;
+}
+function jsonPaginated(res, message, data, meta) {
+    const paginationMeta = {
+        ...meta,
+        totalPages: meta.totalPages ?? Math.ceil(meta.total / meta.limit),
+    };
+    return jsonSuccess(res, message, data, paginationMeta);
+}
+function jsonCreated(res, message, data) {
+    return jsonSuccess(res, message, data, undefined, 201);
+}
+function jsonNoContent(res) {
+    res.status(204).send('');
+    return res;
+}
+function jsonUnauthorized(res, message = 'Unauthorized') {
+    return jsonError(res, message, 401, 'UNAUTHORIZED');
+}
+function jsonForbidden(res, message = 'Forbidden') {
+    return jsonError(res, message, 403, 'FORBIDDEN');
+}
+function jsonNotFound(res, message = 'Not Found') {
+    return jsonError(res, message, 404, 'NOT_FOUND');
+}
+function jsonValidationError(res, message = 'Validation failed', errors) {
+    return jsonError(res, message, 422, 'VALIDATION_ERROR', errors);
+}
+function jsonServerError(res, message = 'Internal Server Error') {
+    return jsonError(res, message, 500, 'INTERNAL_ERROR');
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+import type { Request as HyperRequest, Response as HyperResponse, MiddlewareNext } from "hyper-express";
+export interface User {
+    id: string;
+    name: string | null;
+    email: string;
+    phone: string | null;
+    avatar: string | null;
+    is_admin: boolean;
+    is_verified: boolean;
+    created_at?: number;
+    updated_at?: number;
+}
+export interface NaraRequest extends HyperRequest {
+    user?: User;
+    share?: Record<string, unknown>;
+}
+export interface NaraResponse extends HyperResponse {
+    view(template: string, data?: Record<string, unknown>): Promise<unknown>;
+    inertia?(component: string, props?: Record<string, unknown>, viewProps?: Record<string, unknown>): Promise<unknown>;
+    flash(key: string, value: unknown): NaraResponse;
+}
+export interface NaraResponseWithInertia extends NaraResponse {
+    inertia(component: string, props?: Record<string, unknown>, viewProps?: Record<string, unknown>): Promise<unknown>;
+}
+export type NaraMiddleware = (req: NaraRequest, res: NaraResponse, next: MiddlewareNext) => unknown | Promise<unknown>;
+export type NaraHandler = (req: NaraRequest, res: NaraResponse) => unknown | Promise<unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,QAAQ,IAAI,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKxG,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAKD,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,OAAO,CAAC,CACN,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC;CAClD;AAKD,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAKD,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,cAAc,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAKhC,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,YAAY,KACd,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@nara-web/core",
+  "version": "0.1.0",
+  "description": "NARA Framework Core - HyperExpress-based Node.js framework",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "hyper-express": "^6.17.3",
+    "knex": "^3.1.0",
+    "bcrypt": "^5.1.1",
+    "jsonwebtoken": "^9.0.2",
+    "dotenv": "^16.4.7",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {},
+  "license": "MIT"
+}

package/src/adapters/types.ts

@@ -0,0 +1,31 @@
+import type { MiddlewareNext } from "hyper-express";
+import type { NaraRequest, NaraResponse } from "../types";
+
+/**
+ * Handler type for adapter middleware
+ */
+export type AdapterMiddlewareHandler = (
+  req: NaraRequest,
+  res: NaraResponse,
+  next: MiddlewareNext
+) => unknown | Promise<unknown>;
+
+/**
+ * Frontend Adapter Interface
+ */
+export interface FrontendAdapter {
+  /**
+   * Unique name for the adapter
+   */
+  name: string;
+
+  /**
+   * Factory that returns the adapter's global middleware
+   */
+  middleware: () => AdapterMiddlewareHandler;
+
+  /**
+   * Method called during app initialization to extend the NaraResponse prototype or instance
+   */
+  extendResponse: (res: NaraResponse) => void;
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './adapters/types';

package/src/types.ts

@@ -0,0 +1,65 @@
+import type { Request as HyperRequest, Response as HyperResponse, MiddlewareNext } from "hyper-express";
+
+/**
+ * User interface for authenticated requests
+ */
+export interface User {
+  id: string;
+  name: string | null;
+  email: string;
+  phone: string | null;
+  avatar: string | null;
+  is_admin: boolean;
+  is_verified: boolean;
+  created_at?: number;
+  updated_at?: number;
+}
+
+/**
+ * Extended Request interface with user and shared data
+ */
+export interface NaraRequest extends HyperRequest {
+  user?: User;
+  share?: Record<string, unknown>;
+}
+
+/**
+ * Extended Response interface with Nara-specific methods
+ */
+export interface NaraResponse extends HyperResponse {
+  view(template: string, data?: Record<string, unknown>): Promise<unknown>;
+  inertia?(
+    component: string,
+    props?: Record<string, unknown>,
+    viewProps?: Record<string, unknown>
+  ): Promise<unknown>;
+  flash(key: string, value: unknown): NaraResponse;
+}
+
+/**
+ * NaraResponse with Inertia support explicitly enabled
+ */
+export interface NaraResponseWithInertia extends NaraResponse {
+  inertia(
+    component: string,
+    props?: Record<string, unknown>,
+    viewProps?: Record<string, unknown>
+  ): Promise<unknown>;
+}
+
+/**
+ * Middleware function type
+ */
+export type NaraMiddleware = (
+  req: NaraRequest,
+  res: NaraResponse,
+  next: MiddlewareNext
+) => unknown | Promise<unknown>;
+
+/**
+ * Route handler function type
+ */
+export type NaraHandler = (
+  req: NaraRequest,
+  res: NaraResponse
+) => unknown | Promise<unknown>;

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "composite": true,
+    "declaration": true,
+    "declarationMap": true
+  },
+  "include": ["src/**/*"]
+}