fastify-wrap 0.1.0

package/dist/src/modules/health/service/HealthService.d.ts

@@ -0,0 +1,4 @@
+export declare class HealthService {
+    getStatus(): string;
+}
+//# sourceMappingURL=HealthService.d.ts.map

package/dist/src/modules/health/service/HealthService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthService.d.ts","sourceRoot":"","sources":["../../../../../src/modules/health/service/HealthService.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,SAAS,IAAI,MAAM;CAGpB"}

package/dist/src/modules/health/service/HealthService.js

@@ -0,0 +1,6 @@
+export class HealthService {
+    getStatus() {
+        return 'ok';
+    }
+}
+//# sourceMappingURL=HealthService.js.map

package/dist/src/modules/health/service/HealthService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthService.js","sourceRoot":"","sources":["../../../../../src/modules/health/service/HealthService.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAa;IACxB,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/src/types.d.ts

@@ -0,0 +1,75 @@
+import type { SecretResolver } from './common/auth/SignatureStrategy';
+/**
+ * User payload attached to request after successful authentication.
+ */
+export interface User {
+    id: string;
+    /** Optional role for role-based access control. */
+    role?: string;
+    /** User type for blacklist lookup (e.g. 'bd', 'merchant', 'admin', 'wx_user'). */
+    type?: string;
+}
+/**
+ * Application configuration passed to createApp().
+ */
+export interface AppConfig {
+    db: {
+        host: string;
+        port: number;
+        user: string;
+        password: string;
+        database: string;
+        connectionLimit?: number;
+    };
+    auth: {
+        jwtSecret?: string;
+        /** JWT expiration time, e.g. '30m', '24h'. Default: no expiration. */
+        expiresIn?: string;
+    };
+    /** Optional HMAC signature-based API authentication. */
+    signature?: SignatureConfig;
+    /** Optional Redis connection. Required if using RedisNonceStore. */
+    redis?: RedisConfig;
+    /** Optional context path prefix, e.g. "/myapp" ⇒ all routes become /myapp/api/... */
+    contextPath?: string;
+    /** Optional Swagger / OpenAPI documentation. */
+    swagger?: SwaggerConfig;
+    /** Optional static file serving configuration. */
+    static?: StaticConfig;
+    /** Run DB migrations on startup. Scans src/migrations/*.sql. */
+    migrate?: boolean;
+    port?: number;
+    host?: string;
+}
+export interface SignatureConfig {
+    /**
+     * Resolve appSecret and metadata by clientId.
+     * Return null if clientId is unknown.
+     */
+    resolveSecret: SecretResolver;
+    /** Allowed timestamp drift in milliseconds. Default: 5 minutes. */
+    timestampWindowMs?: number;
+}
+export interface RedisConfig {
+    host: string;
+    port: number;
+    password?: string;
+    db?: number;
+}
+export interface SwaggerConfig {
+    /** API title. Default: package name. */
+    title?: string;
+    /** API description. */
+    description?: string;
+    /** API version. Default: package version. */
+    version?: string;
+    /** Route prefix for Swagger UI. Default: /docs. */
+    uiPrefix?: string;
+}
+export interface StaticConfig {
+    /** Directory to serve static files from, relative to project root. */
+    root: string;
+    /** URL prefix for static files, e.g. "/admin". */
+    prefix: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,IAAI,EAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,sEAAsE;QACtE,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,wDAAwD;IACxD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,kDAAkD;IAClD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,aAAa,EAAE,cAAc,CAAC;IAC9B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/src/types.js

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

package/dist/src/types.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "fastify-wrap",
+  "version": "0.1.0",
+  "description": "A thin wrapper on top of Fastify — decorator-based routing, JWT auth, HMAC signature, JSON Schema validation, DB connection pooling, auto-scanned controllers.",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./client": {
+      "types": "./dist/src/client/index.d.ts",
+      "default": "./dist/src/client/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx watch src/main.ts",
+    "start": "tsx src/main.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write \"src/**/*.{ts,js}\" \"test/**/*.{ts,js}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,js}\" \"test/**/*.{ts,js}\""
+  },
+  "dependencies": {
+    "@fastify/jwt": "^10.2.0",
+    "@fastify/multipart": "^10.1.0",
+    "@fastify/redis": "^8.0.0",
+    "@fastify/static": "^10.1.0",
+    "@fastify/swagger": "^9.8.1",
+    "@fastify/swagger-ui": "^6.1.0",
+    "fast-glob": "^3.3.3",
+    "fastify": "^5.10.0",
+    "knex": "^3.1.0",
+    "mysql2": "^3.23.0",
+    "pino-pretty": "^11.0.0",
+    "reflect-metadata": "^0.2.2",
+    "uuid": "^14.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.1",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.10"
+  }
+}