@ipetsadmin/contracts 1.0.3 → 1.1.2

package/CHANGELOG.md

@@ -19,6 +19,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Security
 
+## [1.1.2] - 2026-04-05
+
+### Added
+
+- **`RepositoryOperationOptions`** (`src/types/repository/RepositoryOperationOptions.ts`): opaque `transactionContext?: unknown` for multi-step atomic work across repositories.
+
+### Changed
+
+- **`IUserRepository`**, **`IRefreshTokenRepository`**, **`IOAuthStateRepository`**: mutating and read methods accept optional `options?: RepositoryOperationOptions`.
+- **`IAuthService`**, **`IJwtTokensService`**: methods accept optional `options?: RepositoryOperationOptions` so handlers can forward a shared session/transaction.
+
+## [1.1.1] - 2026-04-04
+
+### Added
+
+- **Service ports** (`src/interfaces/services/`): `IAuthService`, `IJwtTokensService`, `IAuth0GoogleOAuthService` — describe application service contracts implemented by `@ipetsadmin/api-main`.
+- **Auth0 / OAuth types** (`src/types/auth/`): `Auth0UserProfile`, `Auth0AuthorizationParams`, `OAuthAccessTokenResult`.
+
+## [1.1.0] - 2026-04-04
+
+### Added
+
+- **Authentication domain types** under `src/types/auth/`: `User`, `TokenPair`, `RegisterRequest`, `LoginRequest`, `RefreshRequest`, `LogoutRequest`, `AuthUserResponse`, `AuthSessionResponse`, `CreateUserInput`, `OAuthGoogleStartQuery`, `OAuthGoogleStartResponse`, `OAuthGoogleCallbackRequest`.
+- **Enums:** `AuthMethod`, `OAuthProvider`.
+- **Repository ports** under `src/interfaces/auth/`: `IUserRepository`, `IRefreshTokenRepository` (+ `RefreshTokenRecord`), `IOAuthStateRepository` (+ `OAuthStateRecord`).
+- **`IConfig` extensions** for RS256 JWT (`jwtIssuer`, `jwtAudience`, `jwtAccessExpiresInSeconds`, `jwtRefreshExpiresInDays`, `jwtPrivateKeyPem`, `jwtPublicKeyPem`), and OAuth (`oauthAllowedRedirectUris` string). Existing optional fields retained; `jwtSecret` documented as deprecated in favor of RS256 PEMs.
+
+## [1.0.4] - 2026-04-02
+
+### Added
+
+- **`HealthCheck` type** (`src/types/HealthCheck.ts`) — shape for `IApiResponse<HealthCheck>['data']` on health-check
+  endpoints (`message`, optional `status`).
+- **`HealthStatus` enum** (`src/enums/health-status.ts`) — `healthy` / `unhealthy`; exported for use with `HealthCheck`
+  and API handlers.
+
 ## [1.0.3] - 2026-04-02
 
 ### Fixed

package/README.md

@@ -34,11 +34,20 @@ pnpm add git+https://github.com/your-org/contracts.git#v1.0.0
 
 ```typescript
 import {
+  AuthMethod,
   Errors,
+  HealthCheck,
+  HealthStatus,
   IConfig,
   IApiResponse,
   IPaginatedResponse,
   IServerInit,
+  OAuthProvider,
+  type AuthSessionResponse,
+  type LoginRequest,
+  type RegisterRequest,
+  type TokenPair,
+  type User,
   BaseError,
   BusinessError,
   ForbiddenError,
@@ -46,8 +55,27 @@ import {
   ServerError,
   UnauthorizedError,
 } from '@ipetsadmin/contracts';
+
+// Example: typed health-check response body
+const health: IApiResponse<HealthCheck> = {
+  success: true,
+  message: 'API is running',
+  data: { message: 'API is running', status: HealthStatus.HEALTHY },
+};
 ```
 
+### Authentication and users
+
+The package defines **shared contracts** for email/password and OAuth (Google via Auth0 on the server), **API-issued JWTs** (access) and **opaque refresh tokens** (server-side storage only—hashes are not part of the public types):
+
+- **Enums:** `AuthMethod` (`password` | `oauth`), `OAuthProvider` (e.g. `GOOGLE`, extensible later).
+- **Entities / DTOs:** `User`, `TokenPair`, `AuthUserResponse`, `AuthSessionResponse`, `RegisterRequest`, `LoginRequest`, `RefreshRequest`, `LogoutRequest`, OAuth Google start/callback types, `CreateUserInput`.
+- **Repository ports (implementations live in services):** `IUserRepository`, `IRefreshTokenRepository`, `IOAuthStateRepository` — keep domain types free of MongoDB/Passport imports so SQL or other adapters can implement the same interfaces later.
+- **Service ports** (`interfaces/services/`): `IAuthService`, `IJwtTokensService`, `IAuth0GoogleOAuthService` — implemented by the API’s concrete classes for DI, testing, and clear boundaries.
+- **Auth0/OIDC helpers:** `Auth0UserProfile`, `Auth0AuthorizationParams`, `OAuthAccessTokenResult`.
+
+`IConfig` includes optional fields for **RS256** JWT (`jwtIssuer`, `jwtAudience`, PEM keys, TTLs), **MongoDB**, **Auth0**, and **`oauthAllowedRedirectUris`** (comma-separated allowlist for OAuth redirect URIs).
+
 Path aliases (`@/…`) apply only inside this package’s source; consumers import from `@ipetsadmin/contracts` as above.
 
 The published package is **dual CJS + ESM** (`exports.require` → `dist/index.js`, `exports.import` → `dist/index.mjs`).
@@ -98,9 +126,12 @@ pnpm install
 
 Source lives under `src/`:
 
-- `enums/` — shared enums (e.g. `Errors`)
+- `enums/` — shared enums (e.g. `Errors`, `HealthStatus`, `AuthMethod`, `OAuthProvider`)
 - `errors/` — error classes (`BaseError`, domain errors, …)
 - `interfaces/general/` — cross-cutting interfaces (`IConfig`, pagination, API responses, server bootstrap types, …)
+- `interfaces/auth/` — repository ports (`IUserRepository`, `IRefreshTokenRepository`, `IOAuthStateRepository`)
+- `interfaces/services/` — service ports (`IAuthService`, `IJwtTokensService`, `IAuth0GoogleOAuthService`)
+- `types/` — shared type aliases (`HealthCheck`, auth DTOs under `types/auth/`, …)
 
 The public API is whatever `src/index.ts` re-exports. Additional error classes may exist under `src/errors/` but only appear in consumers if listed in `index.ts`.
 

package/dist/index.d.mts

@@ -1,6 +1,116 @@
 import { Application } from 'express';
 import { Logger } from 'winston';
 
+declare enum HealthStatus {
+    HEALTHY = "healthy",
+    UNHEALTHY = "unhealthy"
+}
+
+type HealthCheck = {
+    message: string;
+    status?: HealthStatus;
+};
+
+declare enum AuthMethod {
+    PASSWORD = "password",
+    OAUTH = "oauth"
+}
+
+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;
+    };
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+
+type TokenPair = {
+    readonly accessToken: string;
+    readonly refreshToken: string;
+    readonly expiresIn: number;
+    readonly tokenType: 'Bearer';
+};
+
+type RegisterRequest = {
+    readonly email: string;
+    readonly password: string;
+};
+
+type LoginRequest = {
+    readonly email: string;
+    readonly password: string;
+};
+
+type RefreshRequest = {
+    readonly refreshToken: string;
+};
+
+type LogoutRequest = {
+    readonly refreshToken: string;
+};
+
+type AuthUserResponse = Pick<User, 'id' | 'email' | 'emailVerified' | 'authMethod' | 'oauth'>;
+
+type AuthSessionResponse = TokenPair & {
+    readonly user: AuthUserResponse;
+};
+
+type OAuthGoogleStartQuery = {
+    readonly redirectUri: string;
+};
+
+type OAuthGoogleStartResponse = {
+    readonly authorizationUrl: string;
+    readonly state: string;
+};
+
+type OAuthGoogleCallbackRequest = {
+    readonly code: string;
+    readonly state: string;
+    readonly redirectUri: string;
+};
+
+type CreateUserInput = {
+    readonly email: string;
+    readonly emailVerified: boolean;
+    readonly authMethod: AuthMethod;
+    readonly passwordHash?: string;
+    readonly oauth?: {
+        readonly provider: OAuthProvider;
+        readonly providerSubject: string;
+    };
+};
+
+type Auth0UserProfile = {
+    readonly sub: string;
+    readonly email?: string;
+    readonly email_verified?: boolean;
+};
+
+type Auth0AuthorizationParams = {
+    readonly state: string;
+    readonly nonce: string;
+    readonly redirectUri: string;
+    readonly connection?: string;
+};
+
+type OAuthAccessTokenResult = {
+    readonly accessToken: string;
+};
+
+type RepositoryOperationOptions = {
+    readonly transactionContext?: unknown;
+};
+
 interface IConfig {
     port: number;
     cors: {
@@ -25,6 +135,13 @@ interface IConfig {
     auth0ClientId?: string;
     auth0ClientSecret?: string;
     auth0Audience?: string;
+    jwtIssuer?: string;
+    jwtAudience?: string;
+    jwtAccessExpiresInSeconds?: number;
+    jwtRefreshExpiresInDays?: number;
+    jwtPrivateKeyPem?: string;
+    jwtPublicKeyPem?: string;
+    oauthAllowedRedirectUris?: string;
 }
 
 interface IPagination {
@@ -53,6 +170,61 @@ interface IApiResponse<T = unknown> {
     message?: string;
 }
 
+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'>> & {
+        passwordHash?: string | null;
+    }, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+type RefreshTokenRecord = {
+    readonly id: string;
+    readonly userId: string;
+    readonly expiresAt: string;
+    readonly revokedAt?: string;
+};
+interface IRefreshTokenRepository {
+    create(userId: string, tokenHash: string, expiresAt: Date, options?: RepositoryOperationOptions): Promise<RefreshTokenRecord>;
+    findValidByHash(tokenHash: string, options?: RepositoryOperationOptions): Promise<RefreshTokenRecord | null>;
+    revokeById(id: string, options?: RepositoryOperationOptions): Promise<void>;
+    revokeAllForUser(userId: string, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+type OAuthStateRecord = {
+    readonly state: string;
+    readonly redirectUri: string;
+    readonly nonce: string;
+    readonly expiresAt: string;
+};
+interface IOAuthStateRepository {
+    create(state: string, nonce: string, redirectUri: string, expiresAt: Date, options?: RepositoryOperationOptions): Promise<void>;
+    consume(state: string, options?: RepositoryOperationOptions): Promise<OAuthStateRecord | null>;
+}
+
+interface IAuthService {
+    register(email: string, password: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
+    loginWithUser(user: User, 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>;
+    logout(refreshToken: string, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+interface IJwtTokensService {
+    issueTokenPair(userId: string, email: string, options?: RepositoryOperationOptions): Promise<TokenPair>;
+    consumeRefreshTokenForRotation(refreshToken: string, options?: RepositoryOperationOptions): Promise<string>;
+    revokeRefreshToken(refreshToken: string, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+interface IAuth0GoogleOAuthService {
+    buildAuthorizationUrl(params: Auth0AuthorizationParams): string;
+    exchangeCodeForTokens(code: string, redirectUri: string): Promise<OAuthAccessTokenResult>;
+    getUserProfile(accessToken: string): Promise<Auth0UserProfile>;
+}
+
 declare enum Errors {
     NOT_FOUND_ERROR = "NotFoundError",
     BUSINESS_ERROR = "BusinessError",
@@ -103,4 +275,4 @@ declare class UnauthorizedError extends BaseError {
     constructor(message: string, details?: Record<string, unknown>);
 }
 
-export { BaseError, BusinessError, Errors, ForbiddenError, type IApiResponse, type IConfig, type IPaginatedResponse, type IServerInit, NotFoundError, ServerError, UnauthorizedError };
+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 };

package/dist/index.d.ts

@@ -1,6 +1,116 @@
 import { Application } from 'express';
 import { Logger } from 'winston';
 
+declare enum HealthStatus {
+    HEALTHY = "healthy",
+    UNHEALTHY = "unhealthy"
+}
+
+type HealthCheck = {
+    message: string;
+    status?: HealthStatus;
+};
+
+declare enum AuthMethod {
+    PASSWORD = "password",
+    OAUTH = "oauth"
+}
+
+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;
+    };
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+
+type TokenPair = {
+    readonly accessToken: string;
+    readonly refreshToken: string;
+    readonly expiresIn: number;
+    readonly tokenType: 'Bearer';
+};
+
+type RegisterRequest = {
+    readonly email: string;
+    readonly password: string;
+};
+
+type LoginRequest = {
+    readonly email: string;
+    readonly password: string;
+};
+
+type RefreshRequest = {
+    readonly refreshToken: string;
+};
+
+type LogoutRequest = {
+    readonly refreshToken: string;
+};
+
+type AuthUserResponse = Pick<User, 'id' | 'email' | 'emailVerified' | 'authMethod' | 'oauth'>;
+
+type AuthSessionResponse = TokenPair & {
+    readonly user: AuthUserResponse;
+};
+
+type OAuthGoogleStartQuery = {
+    readonly redirectUri: string;
+};
+
+type OAuthGoogleStartResponse = {
+    readonly authorizationUrl: string;
+    readonly state: string;
+};
+
+type OAuthGoogleCallbackRequest = {
+    readonly code: string;
+    readonly state: string;
+    readonly redirectUri: string;
+};
+
+type CreateUserInput = {
+    readonly email: string;
+    readonly emailVerified: boolean;
+    readonly authMethod: AuthMethod;
+    readonly passwordHash?: string;
+    readonly oauth?: {
+        readonly provider: OAuthProvider;
+        readonly providerSubject: string;
+    };
+};
+
+type Auth0UserProfile = {
+    readonly sub: string;
+    readonly email?: string;
+    readonly email_verified?: boolean;
+};
+
+type Auth0AuthorizationParams = {
+    readonly state: string;
+    readonly nonce: string;
+    readonly redirectUri: string;
+    readonly connection?: string;
+};
+
+type OAuthAccessTokenResult = {
+    readonly accessToken: string;
+};
+
+type RepositoryOperationOptions = {
+    readonly transactionContext?: unknown;
+};
+
 interface IConfig {
     port: number;
     cors: {
@@ -25,6 +135,13 @@ interface IConfig {
     auth0ClientId?: string;
     auth0ClientSecret?: string;
     auth0Audience?: string;
+    jwtIssuer?: string;
+    jwtAudience?: string;
+    jwtAccessExpiresInSeconds?: number;
+    jwtRefreshExpiresInDays?: number;
+    jwtPrivateKeyPem?: string;
+    jwtPublicKeyPem?: string;
+    oauthAllowedRedirectUris?: string;
 }
 
 interface IPagination {
@@ -53,6 +170,61 @@ interface IApiResponse<T = unknown> {
     message?: string;
 }
 
+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'>> & {
+        passwordHash?: string | null;
+    }, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+type RefreshTokenRecord = {
+    readonly id: string;
+    readonly userId: string;
+    readonly expiresAt: string;
+    readonly revokedAt?: string;
+};
+interface IRefreshTokenRepository {
+    create(userId: string, tokenHash: string, expiresAt: Date, options?: RepositoryOperationOptions): Promise<RefreshTokenRecord>;
+    findValidByHash(tokenHash: string, options?: RepositoryOperationOptions): Promise<RefreshTokenRecord | null>;
+    revokeById(id: string, options?: RepositoryOperationOptions): Promise<void>;
+    revokeAllForUser(userId: string, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+type OAuthStateRecord = {
+    readonly state: string;
+    readonly redirectUri: string;
+    readonly nonce: string;
+    readonly expiresAt: string;
+};
+interface IOAuthStateRepository {
+    create(state: string, nonce: string, redirectUri: string, expiresAt: Date, options?: RepositoryOperationOptions): Promise<void>;
+    consume(state: string, options?: RepositoryOperationOptions): Promise<OAuthStateRecord | null>;
+}
+
+interface IAuthService {
+    register(email: string, password: string, options?: RepositoryOperationOptions): Promise<AuthSessionResponse>;
+    loginWithUser(user: User, 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>;
+    logout(refreshToken: string, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+interface IJwtTokensService {
+    issueTokenPair(userId: string, email: string, options?: RepositoryOperationOptions): Promise<TokenPair>;
+    consumeRefreshTokenForRotation(refreshToken: string, options?: RepositoryOperationOptions): Promise<string>;
+    revokeRefreshToken(refreshToken: string, options?: RepositoryOperationOptions): Promise<void>;
+}
+
+interface IAuth0GoogleOAuthService {
+    buildAuthorizationUrl(params: Auth0AuthorizationParams): string;
+    exchangeCodeForTokens(code: string, redirectUri: string): Promise<OAuthAccessTokenResult>;
+    getUserProfile(accessToken: string): Promise<Auth0UserProfile>;
+}
+
 declare enum Errors {
     NOT_FOUND_ERROR = "NotFoundError",
     BUSINESS_ERROR = "BusinessError",
@@ -103,4 +275,4 @@ declare class UnauthorizedError extends BaseError {
     constructor(message: string, details?: Record<string, unknown>);
 }
 
-export { BaseError, BusinessError, Errors, ForbiddenError, type IApiResponse, type IConfig, type IPaginatedResponse, type IServerInit, NotFoundError, ServerError, UnauthorizedError };
+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 };

package/dist/index.js

@@ -19,6 +19,26 @@ var Errors = /* @__PURE__ */ ((Errors2) => {
   return Errors2;
 })(Errors || {});
 
+// src/enums/health-status.ts
+var HealthStatus = /* @__PURE__ */ ((HealthStatus2) => {
+  HealthStatus2["HEALTHY"] = "healthy";
+  HealthStatus2["UNHEALTHY"] = "unhealthy";
+  return HealthStatus2;
+})(HealthStatus || {});
+
+// src/enums/auth-method.ts
+var AuthMethod = /* @__PURE__ */ ((AuthMethod2) => {
+  AuthMethod2["PASSWORD"] = "password";
+  AuthMethod2["OAUTH"] = "oauth";
+  return AuthMethod2;
+})(AuthMethod || {});
+
+// src/enums/oauth-provider.ts
+var OAuthProvider = /* @__PURE__ */ ((OAuthProvider2) => {
+  OAuthProvider2["GOOGLE"] = "google";
+  return OAuthProvider2;
+})(OAuthProvider || {});
+
 // src/errors/BaseError.ts
 var BaseError = class extends Error {
   toErrorRecord() {
@@ -80,11 +100,14 @@ var UnauthorizedError = class _UnauthorizedError extends BaseError {
   }
 };
 
+exports.AuthMethod = AuthMethod;
 exports.BaseError = BaseError;
 exports.BusinessError = BusinessError;
 exports.Errors = Errors;
 exports.ForbiddenError = ForbiddenError;
+exports.HealthStatus = HealthStatus;
 exports.NotFoundError = NotFoundError;
+exports.OAuthProvider = OAuthProvider;
 exports.ServerError = ServerError;
 exports.UnauthorizedError = UnauthorizedError;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/enums/errors.ts","../src/errors/BaseError.ts","../src/errors/BusinessError.ts","../src/errors/ForbiddenError.ts","../src/errors/NotFoundError.ts","../src/errors/ServerError.ts","../src/errors/UnauthorizedError.ts"],"names":["Errors"],"mappings":"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","file":"index.js","sourcesContent":["export enum Errors {\n  NOT_FOUND_ERROR = 'NotFoundError',\n  BUSINESS_ERROR = 'BusinessError',\n  FORBIDDEN_ERROR = 'ForbiddenError',\n  SERVER_ERROR = 'ServerError',\n  UNAUTHORIZED_ERROR = 'UnauthorizedError',\n  BAD_REQUEST_ERROR = 'BadRequestError',\n  UNPROCESSABLE_ENTITY_ERROR = 'UnprocessableEntityError',\n  TOO_MANY_REQUESTS_ERROR = 'TooManyRequestsError',\n  INTERNAL_SERVER_ERROR = 'InternalServerError',\n  SERVICE_UNAVAILABLE_ERROR = 'ServiceUnavailableError',\n  GATEWAY_TIMEOUT_ERROR = 'GatewayTimeoutError',\n  BAD_GATEWAY_ERROR = 'BadGatewayError',\n  PRECONDITION_FAILED_ERROR = 'PreconditionFailedError',\n  PAYLOAD_TOO_LARGE_ERROR = 'PayloadTooLargeError',\n}\n","export class BaseError extends Error {\n  public details?: Record<string, unknown>;\n  public toErrorRecord(): { error: string; details?: unknown } {\n    const obj: { error: string; details?: unknown } = { error: this.message };\n    if (this.details) {\n      obj.details = this.details;\n    }\n    return obj;\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class BusinessError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.BUSINESS_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, BusinessError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ForbiddenError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.FORBIDDEN_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ForbiddenError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class NotFoundError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.NOT_FOUND_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, NotFoundError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ServerError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.SERVER_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ServerError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class UnauthorizedError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.UNAUTHORIZED_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, UnauthorizedError.prototype);\n  }\n}\n"]}
+{"version":3,"sources":["../src/enums/errors.ts","../src/enums/health-status.ts","../src/enums/auth-method.ts","../src/enums/oauth-provider.ts","../src/errors/BaseError.ts","../src/errors/BusinessError.ts","../src/errors/ForbiddenError.ts","../src/errors/NotFoundError.ts","../src/errors/ServerError.ts","../src/errors/UnauthorizedError.ts"],"names":["Errors","HealthStatus","AuthMethod","OAuthProvider"],"mappings":"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","file":"index.js","sourcesContent":["export enum Errors {\n  NOT_FOUND_ERROR = 'NotFoundError',\n  BUSINESS_ERROR = 'BusinessError',\n  FORBIDDEN_ERROR = 'ForbiddenError',\n  SERVER_ERROR = 'ServerError',\n  UNAUTHORIZED_ERROR = 'UnauthorizedError',\n  BAD_REQUEST_ERROR = 'BadRequestError',\n  UNPROCESSABLE_ENTITY_ERROR = 'UnprocessableEntityError',\n  TOO_MANY_REQUESTS_ERROR = 'TooManyRequestsError',\n  INTERNAL_SERVER_ERROR = 'InternalServerError',\n  SERVICE_UNAVAILABLE_ERROR = 'ServiceUnavailableError',\n  GATEWAY_TIMEOUT_ERROR = 'GatewayTimeoutError',\n  BAD_GATEWAY_ERROR = 'BadGatewayError',\n  PRECONDITION_FAILED_ERROR = 'PreconditionFailedError',\n  PAYLOAD_TOO_LARGE_ERROR = 'PayloadTooLargeError',\n}\n","export enum HealthStatus {\n  HEALTHY = 'healthy',\n  UNHEALTHY = 'unhealthy',\n}\n","/**\n * How the user primarily authenticates. Switching methods is admin-only (future).\n */\nexport enum AuthMethod {\n  PASSWORD = 'password',\n  OAUTH = 'oauth',\n}\n","/**\n * OAuth identity provider (Auth0 connection / social). MVP: Google only; extend for Microsoft, GitHub, etc.\n */\nexport enum OAuthProvider {\n  GOOGLE = 'google',\n}\n","export class BaseError extends Error {\n  public details?: Record<string, unknown>;\n  public toErrorRecord(): { error: string; details?: unknown } {\n    const obj: { error: string; details?: unknown } = { error: this.message };\n    if (this.details) {\n      obj.details = this.details;\n    }\n    return obj;\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class BusinessError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.BUSINESS_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, BusinessError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ForbiddenError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.FORBIDDEN_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ForbiddenError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class NotFoundError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.NOT_FOUND_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, NotFoundError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ServerError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.SERVER_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ServerError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class UnauthorizedError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.UNAUTHORIZED_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, UnauthorizedError.prototype);\n  }\n}\n"]}

package/dist/index.mjs

@@ -17,6 +17,26 @@ var Errors = /* @__PURE__ */ ((Errors2) => {
   return Errors2;
 })(Errors || {});
 
+// src/enums/health-status.ts
+var HealthStatus = /* @__PURE__ */ ((HealthStatus2) => {
+  HealthStatus2["HEALTHY"] = "healthy";
+  HealthStatus2["UNHEALTHY"] = "unhealthy";
+  return HealthStatus2;
+})(HealthStatus || {});
+
+// src/enums/auth-method.ts
+var AuthMethod = /* @__PURE__ */ ((AuthMethod2) => {
+  AuthMethod2["PASSWORD"] = "password";
+  AuthMethod2["OAUTH"] = "oauth";
+  return AuthMethod2;
+})(AuthMethod || {});
+
+// src/enums/oauth-provider.ts
+var OAuthProvider = /* @__PURE__ */ ((OAuthProvider2) => {
+  OAuthProvider2["GOOGLE"] = "google";
+  return OAuthProvider2;
+})(OAuthProvider || {});
+
 // src/errors/BaseError.ts
 var BaseError = class extends Error {
   toErrorRecord() {
@@ -78,6 +98,6 @@ var UnauthorizedError = class _UnauthorizedError extends BaseError {
   }
 };
 
-export { BaseError, BusinessError, Errors, ForbiddenError, NotFoundError, ServerError, UnauthorizedError };
+export { AuthMethod, BaseError, BusinessError, Errors, ForbiddenError, HealthStatus, NotFoundError, OAuthProvider, ServerError, UnauthorizedError };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/enums/errors.ts","../src/errors/BaseError.ts","../src/errors/BusinessError.ts","../src/errors/ForbiddenError.ts","../src/errors/NotFoundError.ts","../src/errors/ServerError.ts","../src/errors/UnauthorizedError.ts"],"names":["Errors"],"mappings":"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","file":"index.mjs","sourcesContent":["export enum Errors {\n  NOT_FOUND_ERROR = 'NotFoundError',\n  BUSINESS_ERROR = 'BusinessError',\n  FORBIDDEN_ERROR = 'ForbiddenError',\n  SERVER_ERROR = 'ServerError',\n  UNAUTHORIZED_ERROR = 'UnauthorizedError',\n  BAD_REQUEST_ERROR = 'BadRequestError',\n  UNPROCESSABLE_ENTITY_ERROR = 'UnprocessableEntityError',\n  TOO_MANY_REQUESTS_ERROR = 'TooManyRequestsError',\n  INTERNAL_SERVER_ERROR = 'InternalServerError',\n  SERVICE_UNAVAILABLE_ERROR = 'ServiceUnavailableError',\n  GATEWAY_TIMEOUT_ERROR = 'GatewayTimeoutError',\n  BAD_GATEWAY_ERROR = 'BadGatewayError',\n  PRECONDITION_FAILED_ERROR = 'PreconditionFailedError',\n  PAYLOAD_TOO_LARGE_ERROR = 'PayloadTooLargeError',\n}\n","export class BaseError extends Error {\n  public details?: Record<string, unknown>;\n  public toErrorRecord(): { error: string; details?: unknown } {\n    const obj: { error: string; details?: unknown } = { error: this.message };\n    if (this.details) {\n      obj.details = this.details;\n    }\n    return obj;\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class BusinessError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.BUSINESS_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, BusinessError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ForbiddenError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.FORBIDDEN_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ForbiddenError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class NotFoundError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.NOT_FOUND_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, NotFoundError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ServerError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.SERVER_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ServerError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class UnauthorizedError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.UNAUTHORIZED_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, UnauthorizedError.prototype);\n  }\n}\n"]}
+{"version":3,"sources":["../src/enums/errors.ts","../src/enums/health-status.ts","../src/enums/auth-method.ts","../src/enums/oauth-provider.ts","../src/errors/BaseError.ts","../src/errors/BusinessError.ts","../src/errors/ForbiddenError.ts","../src/errors/NotFoundError.ts","../src/errors/ServerError.ts","../src/errors/UnauthorizedError.ts"],"names":["Errors","HealthStatus","AuthMethod","OAuthProvider"],"mappings":"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","file":"index.mjs","sourcesContent":["export enum Errors {\n  NOT_FOUND_ERROR = 'NotFoundError',\n  BUSINESS_ERROR = 'BusinessError',\n  FORBIDDEN_ERROR = 'ForbiddenError',\n  SERVER_ERROR = 'ServerError',\n  UNAUTHORIZED_ERROR = 'UnauthorizedError',\n  BAD_REQUEST_ERROR = 'BadRequestError',\n  UNPROCESSABLE_ENTITY_ERROR = 'UnprocessableEntityError',\n  TOO_MANY_REQUESTS_ERROR = 'TooManyRequestsError',\n  INTERNAL_SERVER_ERROR = 'InternalServerError',\n  SERVICE_UNAVAILABLE_ERROR = 'ServiceUnavailableError',\n  GATEWAY_TIMEOUT_ERROR = 'GatewayTimeoutError',\n  BAD_GATEWAY_ERROR = 'BadGatewayError',\n  PRECONDITION_FAILED_ERROR = 'PreconditionFailedError',\n  PAYLOAD_TOO_LARGE_ERROR = 'PayloadTooLargeError',\n}\n","export enum HealthStatus {\n  HEALTHY = 'healthy',\n  UNHEALTHY = 'unhealthy',\n}\n","/**\n * How the user primarily authenticates. Switching methods is admin-only (future).\n */\nexport enum AuthMethod {\n  PASSWORD = 'password',\n  OAUTH = 'oauth',\n}\n","/**\n * OAuth identity provider (Auth0 connection / social). MVP: Google only; extend for Microsoft, GitHub, etc.\n */\nexport enum OAuthProvider {\n  GOOGLE = 'google',\n}\n","export class BaseError extends Error {\n  public details?: Record<string, unknown>;\n  public toErrorRecord(): { error: string; details?: unknown } {\n    const obj: { error: string; details?: unknown } = { error: this.message };\n    if (this.details) {\n      obj.details = this.details;\n    }\n    return obj;\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class BusinessError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.BUSINESS_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, BusinessError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ForbiddenError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.FORBIDDEN_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ForbiddenError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class NotFoundError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.NOT_FOUND_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, NotFoundError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class ServerError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.SERVER_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, ServerError.prototype);\n  }\n}\n","import { BaseError } from '@/errors/BaseError';\nimport { Errors } from '@/enums/errors';\n\nexport class UnauthorizedError extends BaseError {\n  public details?: Record<string, unknown>;\n  public constructor(message: string, details?: Record<string, unknown>) {\n    super(message);\n    this.name = Errors.UNAUTHORIZED_ERROR;\n    this.details = details || {};\n    Object.setPrototypeOf(this, UnauthorizedError.prototype);\n  }\n}\n"]}

package/package.json

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