@ipetsadmin/contracts 1.1.2 → 1.1.3

package/CHANGELOG.md

@@ -19,6 +19,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Security
 
+## [1.1.3] - 2026-04-05
+
+### Added
+
+- **`IUser`** (`src/interfaces/entities/IUser.ts`): entity interface for persisted users (`id`, `email`, `emailVerified`, `authMethod`, optional `oauth`, timestamps).
+
+### Changed
+
+- **Repository ports** live under **`src/interfaces/repositories/auth/`** (`IUserRepository`, `IRefreshTokenRepository`, `IOAuthStateRepository`) instead of `src/interfaces/auth/`. Public API is unchanged via the package barrel (`@ipetsadmin/contracts`); only deep import paths move.
+- **`IUserRepository`**: return types and `create` / `find*` results use **`IUser`** instead of the former `User` type.
+- **`IAuthService`**: `loginWithUser` accepts **`IUser`** (was `User`).
+- **`AuthUserResponse`**: defined as `Pick<IUser, 'id' | 'email' | 'emailVerified' | 'authMethod' | 'oauth'>`.
+
+### Removed
+
+- **`User`** type (`src/types/auth/User.ts`) — replaced by **`IUser`**.
+
 ## [1.1.2] - 2026-04-05
 
 ### Added

package/dist/index.d.mts

@@ -20,18 +20,18 @@ declare enum OAuthProvider {
     GOOGLE = "google"
 }
 
-type User = {
-    readonly id: string;
-    readonly email: string;
-    readonly emailVerified: boolean;
-    readonly authMethod: AuthMethod;
-    readonly oauth?: {
-        readonly provider: OAuthProvider;
-        readonly providerSubject: string;
+interface IUser {
+    id: string;
+    email: string;
+    emailVerified: boolean;
+    authMethod: AuthMethod;
+    oauth?: {
+        provider: OAuthProvider;
+        providerSubject: string;
     };
-    readonly createdAt: string;
-    readonly updatedAt: string;
-};
+    createdAt: string;
+    updatedAt: string;
+}
 
 type TokenPair = {
     readonly accessToken: string;
@@ -58,7 +58,7 @@ type LogoutRequest = {
     readonly refreshToken: string;
 };
 
-type AuthUserResponse = Pick<User, 'id' | 'email' | 'emailVerified' | 'authMethod' | 'oauth'>;
+type AuthUserResponse = Pick<IUser, 'id' | 'email' | 'emailVerified' | 'authMethod' | 'oauth'>;
 
 type AuthSessionResponse = TokenPair & {
     readonly user: AuthUserResponse;
@@ -171,11 +171,11 @@ interface IApiResponse<T = unknown> {
 }
 
 interface IUserRepository {
-    create(input: CreateUserInput, options?: RepositoryOperationOptions): Promise<User>;
-    findById(id: string, options?: RepositoryOperationOptions): Promise<User | null>;
-    findByEmail(email: string, options?: RepositoryOperationOptions): Promise<User | null>;
-    findByOAuth(provider: OAuthProvider, providerSubject: string, options?: RepositoryOperationOptions): Promise<User | null>;
-    update(id: string, patch: Partial<Pick<User, 'email' | 'emailVerified' | 'authMethod' | 'oauth'>> & {
+    create(input: CreateUserInput, options?: RepositoryOperationOptions): Promise<IUser>;
+    findById(id: string, options?: RepositoryOperationOptions): Promise<IUser | null>;
+    findByEmail(email: string, options?: RepositoryOperationOptions): Promise<IUser | null>;
+    findByOAuth(provider: OAuthProvider, providerSubject: string, options?: RepositoryOperationOptions): Promise<IUser | null>;
+    update(id: string, patch: Partial<Pick<IUser, 'email' | 'emailVerified' | 'authMethod' | 'oauth'>> & {
         passwordHash?: string | null;
     }, options?: RepositoryOperationOptions): Promise<void>;
 }
@@ -206,7 +206,7 @@ interface IOAuthStateRepository {
 
 interface IAuthService {
     register(email: string, password: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
-    loginWithUser(user: User, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
+    loginWithUser(user: IUser, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
     startGoogleOAuth(redirectUri: string): Promise<OAuthGoogleStartResponse>;
     completeGoogleOAuth(code: string, state: string, redirectUri: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
     refreshSession(refreshToken: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
@@ -275,4 +275,4 @@ declare class UnauthorizedError extends BaseError {
     constructor(message: string, details?: Record<string, unknown>);
 }
 
-export { type Auth0AuthorizationParams, type Auth0UserProfile, AuthMethod, type AuthSessionResponse, type AuthUserResponse, BaseError, BusinessError, type CreateUserInput, Errors, ForbiddenError, type HealthCheck, HealthStatus, type IApiResponse, type IAuth0GoogleOAuthService, type IAuthService, type IConfig, type IJwtTokensService, type IOAuthStateRepository, type IPaginatedResponse, type IRefreshTokenRepository, type IServerInit, type IUserRepository, type LoginRequest, type LogoutRequest, NotFoundError, type OAuthAccessTokenResult, type OAuthGoogleCallbackRequest, type OAuthGoogleStartQuery, type OAuthGoogleStartResponse, OAuthProvider, type OAuthStateRecord, type RefreshRequest, type RefreshTokenRecord, type RegisterRequest, type RepositoryOperationOptions, ServerError, type TokenPair, UnauthorizedError, type User };
+export { type Auth0AuthorizationParams, type Auth0UserProfile, AuthMethod, type AuthSessionResponse, type AuthUserResponse, BaseError, BusinessError, type CreateUserInput, Errors, ForbiddenError, type HealthCheck, HealthStatus, type IApiResponse, type IAuth0GoogleOAuthService, type IAuthService, type IConfig, type IJwtTokensService, type IOAuthStateRepository, type IPaginatedResponse, type IRefreshTokenRepository, type IServerInit, type IUser, type IUserRepository, type LoginRequest, type LogoutRequest, NotFoundError, type OAuthAccessTokenResult, type OAuthGoogleCallbackRequest, type OAuthGoogleStartQuery, type OAuthGoogleStartResponse, OAuthProvider, type OAuthStateRecord, type RefreshRequest, type RefreshTokenRecord, type RegisterRequest, type RepositoryOperationOptions, ServerError, type TokenPair, UnauthorizedError };

package/dist/index.d.ts

@@ -20,18 +20,18 @@ declare enum OAuthProvider {
     GOOGLE = "google"
 }
 
-type User = {
-    readonly id: string;
-    readonly email: string;
-    readonly emailVerified: boolean;
-    readonly authMethod: AuthMethod;
-    readonly oauth?: {
-        readonly provider: OAuthProvider;
-        readonly providerSubject: string;
+interface IUser {
+    id: string;
+    email: string;
+    emailVerified: boolean;
+    authMethod: AuthMethod;
+    oauth?: {
+        provider: OAuthProvider;
+        providerSubject: string;
     };
-    readonly createdAt: string;
-    readonly updatedAt: string;
-};
+    createdAt: string;
+    updatedAt: string;
+}
 
 type TokenPair = {
     readonly accessToken: string;
@@ -58,7 +58,7 @@ type LogoutRequest = {
     readonly refreshToken: string;
 };
 
-type AuthUserResponse = Pick<User, 'id' | 'email' | 'emailVerified' | 'authMethod' | 'oauth'>;
+type AuthUserResponse = Pick<IUser, 'id' | 'email' | 'emailVerified' | 'authMethod' | 'oauth'>;
 
 type AuthSessionResponse = TokenPair & {
     readonly user: AuthUserResponse;
@@ -171,11 +171,11 @@ interface IApiResponse<T = unknown> {
 }
 
 interface IUserRepository {
-    create(input: CreateUserInput, options?: RepositoryOperationOptions): Promise<User>;
-    findById(id: string, options?: RepositoryOperationOptions): Promise<User | null>;
-    findByEmail(email: string, options?: RepositoryOperationOptions): Promise<User | null>;
-    findByOAuth(provider: OAuthProvider, providerSubject: string, options?: RepositoryOperationOptions): Promise<User | null>;
-    update(id: string, patch: Partial<Pick<User, 'email' | 'emailVerified' | 'authMethod' | 'oauth'>> & {
+    create(input: CreateUserInput, options?: RepositoryOperationOptions): Promise<IUser>;
+    findById(id: string, options?: RepositoryOperationOptions): Promise<IUser | null>;
+    findByEmail(email: string, options?: RepositoryOperationOptions): Promise<IUser | null>;
+    findByOAuth(provider: OAuthProvider, providerSubject: string, options?: RepositoryOperationOptions): Promise<IUser | null>;
+    update(id: string, patch: Partial<Pick<IUser, 'email' | 'emailVerified' | 'authMethod' | 'oauth'>> & {
         passwordHash?: string | null;
     }, options?: RepositoryOperationOptions): Promise<void>;
 }
@@ -206,7 +206,7 @@ interface IOAuthStateRepository {
 
 interface IAuthService {
     register(email: string, password: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
-    loginWithUser(user: User, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
+    loginWithUser(user: IUser, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
     startGoogleOAuth(redirectUri: string): Promise<OAuthGoogleStartResponse>;
     completeGoogleOAuth(code: string, state: string, redirectUri: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
     refreshSession(refreshToken: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
@@ -275,4 +275,4 @@ declare class UnauthorizedError extends BaseError {
     constructor(message: string, details?: Record<string, unknown>);
 }
 
-export { type Auth0AuthorizationParams, type Auth0UserProfile, AuthMethod, type AuthSessionResponse, type AuthUserResponse, BaseError, BusinessError, type CreateUserInput, Errors, ForbiddenError, type HealthCheck, HealthStatus, type IApiResponse, type IAuth0GoogleOAuthService, type IAuthService, type IConfig, type IJwtTokensService, type IOAuthStateRepository, type IPaginatedResponse, type IRefreshTokenRepository, type IServerInit, type IUserRepository, type LoginRequest, type LogoutRequest, NotFoundError, type OAuthAccessTokenResult, type OAuthGoogleCallbackRequest, type OAuthGoogleStartQuery, type OAuthGoogleStartResponse, OAuthProvider, type OAuthStateRecord, type RefreshRequest, type RefreshTokenRecord, type RegisterRequest, type RepositoryOperationOptions, ServerError, type TokenPair, UnauthorizedError, type User };
+export { type Auth0AuthorizationParams, type Auth0UserProfile, AuthMethod, type AuthSessionResponse, type AuthUserResponse, BaseError, BusinessError, type CreateUserInput, Errors, ForbiddenError, type HealthCheck, HealthStatus, type IApiResponse, type IAuth0GoogleOAuthService, type IAuthService, type IConfig, type IJwtTokensService, type IOAuthStateRepository, type IPaginatedResponse, type IRefreshTokenRepository, type IServerInit, type IUser, type IUserRepository, type LoginRequest, type LogoutRequest, NotFoundError, type OAuthAccessTokenResult, type OAuthGoogleCallbackRequest, type OAuthGoogleStartQuery, type OAuthGoogleStartResponse, OAuthProvider, type OAuthStateRecord, type RefreshRequest, type RefreshTokenRecord, type RegisterRequest, type RepositoryOperationOptions, ServerError, type TokenPair, UnauthorizedError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ipetsadmin/contracts",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Shared types, enums, and interfaces for Truffa projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",