@vritti/api-sdk 0.1.4 → 0.1.6

package/dist/index.d.cts

@@ -156,6 +156,30 @@ declare const Onboarding: () => _nestjs_common.CustomDecorator<string>;
  */
 declare const Public: () => _nestjs_common.CustomDecorator<string>;
 
+/**
+ * Parameter decorator to extract user ID from authenticated request
+ *
+ * This decorator retrieves the user ID from the request object,
+ * which is set by authentication guards (JwtAuthGuard, VrittiAuthGuard).
+ *
+ * @returns The user's ID as a string (UUID)
+ *
+ * @example
+ * @Post('verify-email')
+ * @Onboarding()
+ * async verifyEmail(@UserId() userId: string) {
+ *   await this.service.verify(userId);
+ * }
+ *
+ * @example
+ * @Post('logout-all')
+ * @UseGuards(JwtAuthGuard)
+ * async logoutAll(@UserId() userId: string) {
+ *   await this.authService.logoutAll(userId);
+ * }
+ */
+declare const UserId: (...dataOrPipes: unknown[]) => ParameterDecorator;
+
 /**
  * Schema Registry Interface
  *
@@ -558,6 +582,12 @@ interface CookieConfig {
      * @default 'strict'
      */
     refreshCookieSameSite: 'strict' | 'lax' | 'none';
+    /**
+     * Cookie domain (e.g., 'localhost' for dev, '.vritti.cloud' for prod)
+     * Required for cross-subdomain auth (e.g., cloud.localhost accessing localhost API)
+     * @default undefined (uses request domain)
+     */
+    refreshCookieDomain?: string;
 }
 /**
  * JWT token configuration options
@@ -650,13 +680,7 @@ declare function resetConfig(): void;
 /**
  * Get refresh cookie options (convenience method)
  */
-declare function getRefreshCookieOptions(): {
-    httpOnly: boolean;
-    secure: boolean;
-    sameSite: "strict" | "lax" | "none";
-    path: string;
-    maxAge: number;
-};
+declare function getRefreshCookieOptions(): Record<string, unknown>;
 /**
  * Get JWT expiry settings (convenience method)
  */
@@ -2491,4 +2515,4 @@ declare function generateCorrelationId(): string;
  */
 declare function addCorrelationIdToResponse(reply: FastifyReply, correlationId: string, headerName?: string): void;
 
-export { type ApiErrorResponse, type ApiSdkConfig, AuthConfigModule, BadGatewayException, BadRequestException, BaseFieldException, ConflictException, type CookieConfig, type CorrelationContext, CorrelationIdMiddleware, CsrfGuard, DEFAULT_CORRELATION_HEADER, DatabaseModule, type DatabaseModuleOptions, type FieldError, ForbiddenException, GoneException, type GuardConfig, HttpExceptionFilter, HttpLoggerInterceptor, type HttpLoggerOptions, HttpModule, InternalServerErrorException, type JwtConfig, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, MethodNotAllowedException, NotAcceptableException, NotFoundException, NotImplementedException, Onboarding, PayloadTooLargeException, PrimaryBaseRepository, PrimaryDatabaseService, type PrimaryDbConfig, type ProblemDetails, Public, type RegisteredSchema, RequestTimeoutException, ServiceUnavailableException, Tenant, TenantBaseRepository, TenantContextService, TenantDatabaseService, type TenantInfo, TooManyRequestsException, type TypedDrizzleClient, UnauthorizedException, UnprocessableEntityException, UnsupportedMediaTypeException, ValidationException, VrittiAuthGuard, addCorrelationIdToResponse, configureApiSdk, correlationStorage, defineConfig, generateCorrelationId, getConfig, getCorrelationContext, getHttpStatusTitle, getJwtExpiry, getRefreshCookieOptions, hashToken, resetConfig, runWithCorrelationContext, updateCorrelationContext, verifyTokenHash };
+export { type ApiErrorResponse, type ApiSdkConfig, AuthConfigModule, BadGatewayException, BadRequestException, BaseFieldException, ConflictException, type CookieConfig, type CorrelationContext, CorrelationIdMiddleware, CsrfGuard, DEFAULT_CORRELATION_HEADER, DatabaseModule, type DatabaseModuleOptions, type FieldError, ForbiddenException, GoneException, type GuardConfig, HttpExceptionFilter, HttpLoggerInterceptor, type HttpLoggerOptions, HttpModule, InternalServerErrorException, type JwtConfig, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, MethodNotAllowedException, NotAcceptableException, NotFoundException, NotImplementedException, Onboarding, PayloadTooLargeException, PrimaryBaseRepository, PrimaryDatabaseService, type PrimaryDbConfig, type ProblemDetails, Public, type RegisteredSchema, RequestTimeoutException, ServiceUnavailableException, Tenant, TenantBaseRepository, TenantContextService, TenantDatabaseService, type TenantInfo, TooManyRequestsException, type TypedDrizzleClient, UnauthorizedException, UnprocessableEntityException, UnsupportedMediaTypeException, UserId, ValidationException, VrittiAuthGuard, addCorrelationIdToResponse, configureApiSdk, correlationStorage, defineConfig, generateCorrelationId, getConfig, getCorrelationContext, getHttpStatusTitle, getJwtExpiry, getRefreshCookieOptions, hashToken, resetConfig, runWithCorrelationContext, updateCorrelationContext, verifyTokenHash };

package/dist/index.d.ts

@@ -156,6 +156,30 @@ declare const Onboarding: () => _nestjs_common.CustomDecorator<string>;
  */
 declare const Public: () => _nestjs_common.CustomDecorator<string>;
 
+/**
+ * Parameter decorator to extract user ID from authenticated request
+ *
+ * This decorator retrieves the user ID from the request object,
+ * which is set by authentication guards (JwtAuthGuard, VrittiAuthGuard).
+ *
+ * @returns The user's ID as a string (UUID)
+ *
+ * @example
+ * @Post('verify-email')
+ * @Onboarding()
+ * async verifyEmail(@UserId() userId: string) {
+ *   await this.service.verify(userId);
+ * }
+ *
+ * @example
+ * @Post('logout-all')
+ * @UseGuards(JwtAuthGuard)
+ * async logoutAll(@UserId() userId: string) {
+ *   await this.authService.logoutAll(userId);
+ * }
+ */
+declare const UserId: (...dataOrPipes: unknown[]) => ParameterDecorator;
+
 /**
  * Schema Registry Interface
  *
@@ -558,6 +582,12 @@ interface CookieConfig {
      * @default 'strict'
      */
     refreshCookieSameSite: 'strict' | 'lax' | 'none';
+    /**
+     * Cookie domain (e.g., 'localhost' for dev, '.vritti.cloud' for prod)
+     * Required for cross-subdomain auth (e.g., cloud.localhost accessing localhost API)
+     * @default undefined (uses request domain)
+     */
+    refreshCookieDomain?: string;
 }
 /**
  * JWT token configuration options
@@ -650,13 +680,7 @@ declare function resetConfig(): void;
 /**
  * Get refresh cookie options (convenience method)
  */
-declare function getRefreshCookieOptions(): {
-    httpOnly: boolean;
-    secure: boolean;
-    sameSite: "strict" | "lax" | "none";
-    path: string;
-    maxAge: number;
-};
+declare function getRefreshCookieOptions(): Record<string, unknown>;
 /**
  * Get JWT expiry settings (convenience method)
  */
@@ -2491,4 +2515,4 @@ declare function generateCorrelationId(): string;
  */
 declare function addCorrelationIdToResponse(reply: FastifyReply, correlationId: string, headerName?: string): void;
 
-export { type ApiErrorResponse, type ApiSdkConfig, AuthConfigModule, BadGatewayException, BadRequestException, BaseFieldException, ConflictException, type CookieConfig, type CorrelationContext, CorrelationIdMiddleware, CsrfGuard, DEFAULT_CORRELATION_HEADER, DatabaseModule, type DatabaseModuleOptions, type FieldError, ForbiddenException, GoneException, type GuardConfig, HttpExceptionFilter, HttpLoggerInterceptor, type HttpLoggerOptions, HttpModule, InternalServerErrorException, type JwtConfig, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, MethodNotAllowedException, NotAcceptableException, NotFoundException, NotImplementedException, Onboarding, PayloadTooLargeException, PrimaryBaseRepository, PrimaryDatabaseService, type PrimaryDbConfig, type ProblemDetails, Public, type RegisteredSchema, RequestTimeoutException, ServiceUnavailableException, Tenant, TenantBaseRepository, TenantContextService, TenantDatabaseService, type TenantInfo, TooManyRequestsException, type TypedDrizzleClient, UnauthorizedException, UnprocessableEntityException, UnsupportedMediaTypeException, ValidationException, VrittiAuthGuard, addCorrelationIdToResponse, configureApiSdk, correlationStorage, defineConfig, generateCorrelationId, getConfig, getCorrelationContext, getHttpStatusTitle, getJwtExpiry, getRefreshCookieOptions, hashToken, resetConfig, runWithCorrelationContext, updateCorrelationContext, verifyTokenHash };
+export { type ApiErrorResponse, type ApiSdkConfig, AuthConfigModule, BadGatewayException, BadRequestException, BaseFieldException, ConflictException, type CookieConfig, type CorrelationContext, CorrelationIdMiddleware, CsrfGuard, DEFAULT_CORRELATION_HEADER, DatabaseModule, type DatabaseModuleOptions, type FieldError, ForbiddenException, GoneException, type GuardConfig, HttpExceptionFilter, HttpLoggerInterceptor, type HttpLoggerOptions, HttpModule, InternalServerErrorException, type JwtConfig, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, MethodNotAllowedException, NotAcceptableException, NotFoundException, NotImplementedException, Onboarding, PayloadTooLargeException, PrimaryBaseRepository, PrimaryDatabaseService, type PrimaryDbConfig, type ProblemDetails, Public, type RegisteredSchema, RequestTimeoutException, ServiceUnavailableException, Tenant, TenantBaseRepository, TenantContextService, TenantDatabaseService, type TenantInfo, TooManyRequestsException, type TypedDrizzleClient, UnauthorizedException, UnprocessableEntityException, UnsupportedMediaTypeException, UserId, ValidationException, VrittiAuthGuard, addCorrelationIdToResponse, configureApiSdk, correlationStorage, defineConfig, generateCorrelationId, getConfig, getCorrelationContext, getHttpStatusTitle, getJwtExpiry, getRefreshCookieOptions, hashToken, resetConfig, runWithCorrelationContext, updateCorrelationContext, verifyTokenHash };

package/dist/index.js

@@ -21,7 +21,8 @@ var defaultConfig = {
     refreshCookieMaxAge: 30 * 24 * 60 * 60 * 1e3,
     refreshCookiePath: "/",
     refreshCookieSecure: process.env.NODE_ENV === "production",
-    refreshCookieSameSite: "strict"
+    refreshCookieSameSite: "strict",
+    refreshCookieDomain: "localhost"
   },
   jwt: {
     accessTokenExpiry: "15m",
@@ -70,13 +71,17 @@ function resetConfig() {
 }
 __name(resetConfig, "resetConfig");
 function getRefreshCookieOptions() {
-  return {
+  const options = {
     httpOnly: true,
     secure: currentConfig.cookie.refreshCookieSecure,
     sameSite: currentConfig.cookie.refreshCookieSameSite,
     path: currentConfig.cookie.refreshCookiePath,
     maxAge: currentConfig.cookie.refreshCookieMaxAge
   };
+  if (currentConfig.cookie.refreshCookieDomain) {
+    options.domain = currentConfig.cookie.refreshCookieDomain;
+  }
+  return options;
 }
 __name(getRefreshCookieOptions, "getRefreshCookieOptions");
 function getJwtExpiry() {
@@ -726,6 +731,17 @@ var Onboarding = /* @__PURE__ */ __name(() => SetMetadata("isOnboarding", true),
 import { SetMetadata as SetMetadata2 } from "@nestjs/common";
 var Public = /* @__PURE__ */ __name(() => SetMetadata2("isPublic", true), "Public");
 
+// src/auth/decorators/user-id.decorator.ts
+import { createParamDecorator } from "@nestjs/common";
+var UserId = createParamDecorator((_data, ctx) => {
+  const request = ctx.switchToHttp().getRequest();
+  const user = request.user;
+  if (!user?.id) {
+    throw new Error("User ID not found on request. Ensure route is protected by auth guard.");
+  }
+  return user.id;
+});
+
 // src/database/database.module.ts
 import { Global as Global3, Module as Module3 } from "@nestjs/common";
 import { APP_INTERCEPTOR } from "@nestjs/core";
@@ -1296,8 +1312,8 @@ DatabaseModule = _ts_decorate10([
 ], DatabaseModule);
 
 // src/database/decorators/tenant.decorator.ts
-import { createParamDecorator } from "@nestjs/common";
-var Tenant = createParamDecorator((_data, ctx) => {
+import { createParamDecorator as createParamDecorator2 } from "@nestjs/common";
+var Tenant = createParamDecorator2((_data, ctx) => {
   const request = ctx.switchToHttp().getRequest();
   const tenantContext = request.app?.get?.(TenantContextService);
   if (!tenantContext) {
@@ -3387,6 +3403,7 @@ export {
   UnauthorizedException4 as UnauthorizedException,
   UnprocessableEntityException,
   UnsupportedMediaTypeException,
+  UserId,
   ValidationException,
   VrittiAuthGuard,
   addCorrelationIdToResponse,