@miguelmorales13/nestkit 0.1.0

package/dist/index.js

@@ -0,0 +1,75 @@
+import "./chunk-EPVKCBPT.js";
+import {
+  PG_POOL,
+  PgModule,
+  withTenantScope
+} from "./chunk-VKOPDDCC.js";
+import {
+  SUPABASE_ANON_CLIENT,
+  SUPABASE_SERVICE_ROLE_CLIENT,
+  SupabaseModule
+} from "./chunk-PA24P76K.js";
+import {
+  applyNestKitDefaults
+} from "./chunk-KP7GRCZW.js";
+import {
+  BaseCrudService,
+  createCrudController
+} from "./chunk-JOVBJDJ2.js";
+import {
+  I18nModule,
+  translateOr
+} from "./chunk-IYUUYCP5.js";
+import {
+  BaseResponseDto
+} from "./chunk-XX2HPTRU.js";
+import "./chunk-NAK4WDKS.js";
+import {
+  ResponseInterceptor
+} from "./chunk-KDAA6GFF.js";
+import {
+  REQUEST_ID_HEADER,
+  RequestIdMiddleware,
+  TrackingModule
+} from "./chunk-EYURGACO.js";
+import {
+  ConflictAppException,
+  ForbiddenAppException,
+  NotFoundAppException,
+  UnauthorizedAppException,
+  ValidationAppException
+} from "./chunk-HGJX2GPE.js";
+import {
+  AppException,
+  GlobalExceptionFilter
+} from "./chunk-EQXYK6AL.js";
+import {
+  RequestContext
+} from "./chunk-EBO6UKHL.js";
+import "./chunk-4MGIQFAJ.js";
+export {
+  AppException,
+  BaseCrudService,
+  BaseResponseDto,
+  ConflictAppException,
+  ForbiddenAppException,
+  GlobalExceptionFilter,
+  I18nModule,
+  NotFoundAppException,
+  PG_POOL,
+  PgModule,
+  REQUEST_ID_HEADER,
+  RequestContext,
+  RequestIdMiddleware,
+  ResponseInterceptor,
+  SUPABASE_ANON_CLIENT,
+  SUPABASE_SERVICE_ROLE_CLIENT,
+  SupabaseModule,
+  TrackingModule,
+  UnauthorizedAppException,
+  ValidationAppException,
+  applyNestKitDefaults,
+  createCrudController,
+  translateOr,
+  withTenantScope
+};

package/dist/response/api-response.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Envelope shared by every response nestkit produces, success or error.
+ */
+export interface BaseApiResponse {
+    requestId: string;
+    timestamp: string;
+}
+export interface ApiSuccessResponse<T> extends BaseApiResponse {
+    success: true;
+    data: T;
+}
+export interface ApiErrorResponse extends BaseApiResponse {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;

package/dist/response/index.d.ts

@@ -0,0 +1,2 @@
+export type { ApiResponse, ApiSuccessResponse, ApiErrorResponse, BaseApiResponse } from './api-response.js';
+export { ResponseInterceptor } from './response.interceptor.js';

package/dist/response/index.js

@@ -0,0 +1,9 @@
+import "../chunk-NAK4WDKS.js";
+import {
+  ResponseInterceptor
+} from "../chunk-KDAA6GFF.js";
+import "../chunk-EBO6UKHL.js";
+import "../chunk-4MGIQFAJ.js";
+export {
+  ResponseInterceptor
+};

package/dist/response/response.interceptor.d.ts

@@ -0,0 +1,13 @@
+import { type CallHandler, type ExecutionContext, type NestInterceptor } from '@nestjs/common';
+import type { Observable } from 'rxjs';
+import type { ApiSuccessResponse } from './api-response.js';
+/**
+ * Global interceptor that wraps every controller return value in the
+ * standard ApiSuccessResponse envelope. Register it with
+ * `app.useGlobalInterceptors(new ResponseInterceptor())` (or via
+ * `applyNestKitDefaults`). Relies on TrackingModule's RequestIdMiddleware
+ * having already populated RequestContext for the current request.
+ */
+export declare class ResponseInterceptor<T> implements NestInterceptor<T, ApiSuccessResponse<T>> {
+    intercept(_context: ExecutionContext, next: CallHandler<T>): Observable<ApiSuccessResponse<T>>;
+}

package/dist/tracking/index.d.ts

@@ -0,0 +1,4 @@
+export { RequestContext } from './request-context.js';
+export type { RequestContextStore } from './request-context.js';
+export { RequestIdMiddleware, REQUEST_ID_HEADER } from './request-id.middleware.js';
+export { TrackingModule } from './tracking.module.js';

package/dist/tracking/index.js

@@ -0,0 +1,15 @@
+import {
+  REQUEST_ID_HEADER,
+  RequestIdMiddleware,
+  TrackingModule
+} from "../chunk-EYURGACO.js";
+import {
+  RequestContext
+} from "../chunk-EBO6UKHL.js";
+import "../chunk-4MGIQFAJ.js";
+export {
+  REQUEST_ID_HEADER,
+  RequestContext,
+  RequestIdMiddleware,
+  TrackingModule
+};

package/dist/tracking/request-context.d.ts

@@ -0,0 +1,14 @@
+export interface RequestContextStore {
+    requestId: string;
+}
+/**
+ * Thin wrapper around AsyncLocalStorage so any layer (filters, interceptors,
+ * services, repositories) can read the current request's id without it
+ * being threaded through every function signature by hand.
+ */
+export declare class RequestContext {
+    private static readonly storage;
+    static run<T>(store: RequestContextStore, fn: () => T): T;
+    static getStore(): RequestContextStore | undefined;
+    static getRequestId(): string | undefined;
+}

package/dist/tracking/request-id.middleware.d.ts

@@ -0,0 +1,17 @@
+import { type NestMiddleware } from '@nestjs/common';
+/**
+ * Structural (not express/fastify-specific) shapes so this middleware works
+ * on either HTTP adapter without pulling in extra type dependencies.
+ */
+interface RequestIdRequest {
+    headers: Record<string, string | string[] | undefined>;
+    requestId?: string;
+}
+interface RequestIdResponse {
+    setHeader(name: string, value: string): unknown;
+}
+export declare const REQUEST_ID_HEADER = "x-request-id";
+export declare class RequestIdMiddleware implements NestMiddleware {
+    use(req: RequestIdRequest, res: RequestIdResponse, next: () => void): void;
+}
+export {};

package/dist/tracking/tracking.module.d.ts

@@ -0,0 +1,9 @@
+import { type MiddlewareConsumer, type NestModule } from '@nestjs/common';
+/**
+ * Wires RequestIdMiddleware globally. Import this module in the consumer's
+ * root AppModule so every request gets a request id before it reaches
+ * controllers, the ResponseInterceptor, and the GlobalExceptionFilter.
+ */
+export declare class TrackingModule implements NestModule {
+    configure(consumer: MiddlewareConsumer): void;
+}

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "@miguelmorales13/nestkit",
+  "version": "0.1.0",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "description": "Reusable NestJS building blocks: i18n, error handling, standardized responses, request tracking, base entities, generic CRUD, and Postgres/Supabase connection helpers.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./entities": {
+      "types": "./dist/entities/index.d.ts",
+      "import": "./dist/entities/index.js"
+    },
+    "./response": {
+      "types": "./dist/response/index.d.ts",
+      "import": "./dist/response/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js"
+    },
+    "./tracking": {
+      "types": "./dist/tracking/index.d.ts",
+      "import": "./dist/tracking/index.js"
+    },
+    "./crud": {
+      "types": "./dist/crud/index.d.ts",
+      "import": "./dist/crud/index.js"
+    },
+    "./database/postgres": {
+      "types": "./dist/database/postgres/index.d.ts",
+      "import": "./dist/database/postgres/index.js"
+    },
+    "./database/supabase": {
+      "types": "./dist/database/supabase/index.d.ts",
+      "import": "./dist/database/supabase/index.js"
+    },
+    "./database/mongo": {
+      "types": "./dist/database/mongo/index.d.ts",
+      "import": "./dist/database/mongo/index.js"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "import": "./dist/i18n/index.js"
+    },
+    "./bootstrap": {
+      "types": "./dist/bootstrap/index.d.ts",
+      "import": "./dist/bootstrap/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsup --watch"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/swagger": "^11.0.0",
+    "@supabase/supabase-js": "^2.45.0",
+    "helmet": "^8.0.0",
+    "pg": "^8.11.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "@nestjs/swagger": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    },
+    "helmet": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "nestjs-i18n": "^10.4.5"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "tsup": "^8.5.1",
+    "@types/node": "^22.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/swagger": "^11.0.0",
+    "@supabase/supabase-js": "^2.45.0",
+    "pg": "^8.11.0",
+    "@types/pg": "^8.11.0",
+    "helmet": "^8.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0",
+    "class-validator": "^0.14.0",
+    "class-transformer": "^0.5.1"
+  }
+}