@veruna/api-contracts 1.0.0

package/README.md

@@ -0,0 +1,81 @@
+# @veruna/api-contracts
+
+API contracts for Veruna project - type-safe Zod schemas, TypeScript types, and API paths.
+
+## Installation
+
+```bash
+npm install @veruna/api-contracts
+# or
+pnpm add @veruna/api-contracts
+```
+
+## Usage
+
+### Import schemas and types
+
+```typescript
+import {
+  // Auth
+  SignUpRequestSchema,
+  LoginRequestSchema,
+  SignUpRequest,
+  LoginRequest,
+  AuthResponse,
+
+  // Users
+  UpdateProfileRequestSchema,
+  ChangePasswordRequestSchema,
+  UpdateProfileRequest,
+  ChangePasswordRequest,
+  UserResponse,
+
+  // Paths
+  AUTH_PATHS,
+  USERS_PATHS,
+} from '@veruna/api-contracts';
+```
+
+### Frontend usage with Zod
+
+```typescript
+// Validate data
+const data = UpdateProfileRequestSchema.parse({ name: 'John' });
+
+// Type-safe API calls
+async function updateProfile(data: UpdateProfileRequest): Promise<UpdateProfileResponse> {
+  const response = await fetch('/api/v1/users/me', {
+    method: 'PATCH',
+    body: JSON.stringify(data),
+  });
+
+  return response.json();
+}
+```
+
+### Error handling
+
+```typescript
+const response = await changePassword(data);
+
+if ('code' in response) {
+  // Error response
+  console.error(response.code);  // e.g., "UNAUTHORIZED"
+  if (response.details) {
+    console.error(response.details);
+  }
+} else {
+  // Success response
+  console.log('Password changed!');
+}
+```
+
+## Available Contracts
+
+- **Auth** (`/v1/auth`): signup, login, logout, sessions
+- **Users** (`/v1/users`): profile management, password change
+- **Unregistered Users** (`/v1/unreg-users`): guest users
+
+## License
+
+ISC

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export * from './v1/auth';
+export * from './v1/users';
+export * from './v1/unregistered-users';

package/build/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Export all contracts
+__exportStar(require("./v1/auth"), exports);
+__exportStar(require("./v1/users"), exports);
+__exportStar(require("./v1/unregistered-users"), exports);

package/build/v1/auth/auth.errors.d.ts

@@ -0,0 +1,12 @@
+export declare enum AuthErrorCode {
+    EMAIL_ALREADY_EXISTS = "EMAIL_ALREADY_EXISTS",
+    INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
+    USER_NOT_FOUND = "USER_NOT_FOUND",
+    USER_DELETED = "USER_DELETED",
+    SESSION_NOT_FOUND = "SESSION_NOT_FOUND",
+    SESSION_INACTIVE = "SESSION_INACTIVE",
+    INVALID_TOKEN = "INVALID_TOKEN",
+    PASSWORD_TOO_WEAK = "PASSWORD_TOO_WEAK",
+    UNREG_USER_ALREADY_MIGRATED = "UNREG_USER_ALREADY_MIGRATED",
+    SESSION_NOT_OWNED_BY_USER = "SESSION_NOT_OWNED_BY_USER"
+}

package/build/v1/auth/auth.errors.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthErrorCode = void 0;
+var AuthErrorCode;
+(function (AuthErrorCode) {
+    AuthErrorCode["EMAIL_ALREADY_EXISTS"] = "EMAIL_ALREADY_EXISTS";
+    AuthErrorCode["INVALID_CREDENTIALS"] = "INVALID_CREDENTIALS";
+    AuthErrorCode["USER_NOT_FOUND"] = "USER_NOT_FOUND";
+    AuthErrorCode["USER_DELETED"] = "USER_DELETED";
+    AuthErrorCode["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+    AuthErrorCode["SESSION_INACTIVE"] = "SESSION_INACTIVE";
+    AuthErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
+    AuthErrorCode["PASSWORD_TOO_WEAK"] = "PASSWORD_TOO_WEAK";
+    AuthErrorCode["UNREG_USER_ALREADY_MIGRATED"] = "UNREG_USER_ALREADY_MIGRATED";
+    AuthErrorCode["SESSION_NOT_OWNED_BY_USER"] = "SESSION_NOT_OWNED_BY_USER";
+})(AuthErrorCode || (exports.AuthErrorCode = AuthErrorCode = {}));

package/build/v1/auth/auth.paths.d.ts

@@ -0,0 +1,17 @@
+export declare const AUTH_PATHS: {
+    readonly BASE: "v1/auth";
+    readonly SIGNUP: "signup";
+    readonly LOGIN: "login";
+    readonly LOGOUT: "logout";
+    readonly LOGOUT_ALL: "logout-all";
+    readonly SESSIONS: "sessions";
+    readonly SESSION_BY_ID: "sessions/:id";
+};
+export declare const AUTH_API_PATHS: {
+    readonly SIGNUP: "/api/v1/auth/signup";
+    readonly LOGIN: "/api/v1/auth/login";
+    readonly LOGOUT: "/api/v1/auth/logout";
+    readonly LOGOUT_ALL: "/api/v1/auth/logout-all";
+    readonly SESSIONS: "/api/v1/auth/sessions";
+    readonly SESSION_BY_ID: (id: string) => string;
+};

package/build/v1/auth/auth.paths.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTH_API_PATHS = exports.AUTH_PATHS = void 0;
+exports.AUTH_PATHS = {
+    BASE: 'v1/auth',
+    SIGNUP: 'signup',
+    LOGIN: 'login',
+    LOGOUT: 'logout',
+    LOGOUT_ALL: 'logout-all',
+    SESSIONS: 'sessions',
+    SESSION_BY_ID: 'sessions/:id',
+};
+exports.AUTH_API_PATHS = {
+    SIGNUP: `/api/${exports.AUTH_PATHS.BASE}/${exports.AUTH_PATHS.SIGNUP}`,
+    LOGIN: `/api/${exports.AUTH_PATHS.BASE}/${exports.AUTH_PATHS.LOGIN}`,
+    LOGOUT: `/api/${exports.AUTH_PATHS.BASE}/${exports.AUTH_PATHS.LOGOUT}`,
+    LOGOUT_ALL: `/api/${exports.AUTH_PATHS.BASE}/${exports.AUTH_PATHS.LOGOUT_ALL}`,
+    SESSIONS: `/api/${exports.AUTH_PATHS.BASE}/${exports.AUTH_PATHS.SESSIONS}`,
+    SESSION_BY_ID: (id) => `/api/${exports.AUTH_PATHS.BASE}/sessions/${id}`,
+};

package/build/v1/auth/auth.schemas.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+/**
+ * User Role enum
+ */
+export declare enum UserRole {
+    USER = "user",
+    ADMIN = "admin"
+}
+/**
+ * UTM Schema
+ */
+export declare const UtmSchema: z.ZodObject<{
+    utmSource: z.ZodOptional<z.ZodString>;
+    utmMedium: z.ZodOptional<z.ZodString>;
+    utmCampaign: z.ZodOptional<z.ZodString>;
+    utmContent: z.ZodOptional<z.ZodString>;
+    utmTerm: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Sign Up Request Schema
+ */
+export declare const SignUpRequestSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+    name: z.ZodString;
+    marketingConsent: z.ZodDefault<z.ZodBoolean>;
+    utm: z.ZodOptional<z.ZodObject<{
+        utmSource: z.ZodOptional<z.ZodString>;
+        utmMedium: z.ZodOptional<z.ZodString>;
+        utmCampaign: z.ZodOptional<z.ZodString>;
+        utmContent: z.ZodOptional<z.ZodString>;
+        utmTerm: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Login Request Schema
+ */
+export declare const LoginRequestSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Session Response Schema
+ */
+export declare const SessionResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    deviceName: z.ZodString;
+    ip: z.ZodString;
+    isCurrent: z.ZodBoolean;
+    createdAt: z.ZodString;
+    lastUsedAt: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Auth Response Schema (signup/login)
+ */
+export declare const AuthResponseSchema: z.ZodObject<{
+    user: z.ZodObject<{
+        uuid: z.ZodString;
+        email: z.ZodString;
+        name: z.ZodString;
+        role: z.ZodString;
+        marketingConsent: z.ZodBoolean;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+    accessToken: z.ZodString;
+    session: z.ZodObject<{
+        uuid: z.ZodString;
+        deviceName: z.ZodString;
+        ip: z.ZodString;
+        isCurrent: z.ZodBoolean;
+        createdAt: z.ZodString;
+        lastUsedAt: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Sessions List Response Schema
+ */
+export declare const SessionsListResponseSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        deviceName: z.ZodString;
+        ip: z.ZodString;
+        isCurrent: z.ZodBoolean;
+        createdAt: z.ZodString;
+        lastUsedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/build/v1/auth/auth.schemas.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionsListResponseSchema = exports.AuthResponseSchema = exports.SessionResponseSchema = exports.LoginRequestSchema = exports.SignUpRequestSchema = exports.UtmSchema = exports.UserRole = void 0;
+const zod_1 = require("zod");
+const users_schemas_1 = require("../users/users.schemas");
+/**
+ * User Role enum
+ */
+var UserRole;
+(function (UserRole) {
+    UserRole["USER"] = "user";
+    UserRole["ADMIN"] = "admin";
+})(UserRole || (exports.UserRole = UserRole = {}));
+/**
+ * UTM Schema
+ */
+exports.UtmSchema = zod_1.z.object({
+    utmSource: zod_1.z.string().optional(),
+    utmMedium: zod_1.z.string().optional(),
+    utmCampaign: zod_1.z.string().optional(),
+    utmContent: zod_1.z.string().optional(),
+    utmTerm: zod_1.z.string().optional(),
+});
+/**
+ * Sign Up Request Schema
+ */
+exports.SignUpRequestSchema = zod_1.z.object({
+    email: zod_1.z.string().email('Invalid email format'),
+    password: zod_1.z
+        .string()
+        .min(8, 'Password must be at least 8 characters')
+        .max(128, 'Password too long (maximum 128 characters)')
+        .regex(/[0-9!@#$%^&*(),.?":{}|<>]/, 'Password must contain at least one number or special character'),
+    name: zod_1.z.string().min(2, 'Name must be at least 2 characters'),
+    marketingConsent: zod_1.z.boolean().default(false),
+    utm: exports.UtmSchema.optional(),
+});
+/**
+ * Login Request Schema
+ */
+exports.LoginRequestSchema = zod_1.z.object({
+    email: zod_1.z.string().email('Invalid email format'),
+    password: zod_1.z.string().min(1, 'Password is required'),
+});
+/**
+ * Session Response Schema
+ */
+exports.SessionResponseSchema = zod_1.z.object({
+    uuid: zod_1.z.string().uuid(),
+    deviceName: zod_1.z.string(),
+    ip: zod_1.z.string(),
+    isCurrent: zod_1.z.boolean(),
+    createdAt: zod_1.z.string().datetime(),
+    lastUsedAt: zod_1.z.string().datetime(),
+});
+/**
+ * Auth Response Schema (signup/login)
+ */
+exports.AuthResponseSchema = zod_1.z.object({
+    user: users_schemas_1.UserResponseSchema,
+    accessToken: zod_1.z.string(),
+    session: exports.SessionResponseSchema,
+});
+/**
+ * Sessions List Response Schema
+ */
+exports.SessionsListResponseSchema = zod_1.z.object({
+    sessions: zod_1.z.array(exports.SessionResponseSchema),
+});

package/build/v1/auth/auth.types.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { SignUpRequestSchema, LoginRequestSchema, SessionResponseSchema, AuthResponseSchema, SessionsListResponseSchema, UtmSchema } from './auth.schemas';
+export type SignUpRequest = z.infer<typeof SignUpRequestSchema>;
+export type LoginRequest = z.infer<typeof LoginRequestSchema>;
+export type SessionResponse = z.infer<typeof SessionResponseSchema>;
+export type AuthResponse = z.infer<typeof AuthResponseSchema>;
+export type SessionsListResponse = z.infer<typeof SessionsListResponseSchema>;
+export type Utm = z.infer<typeof UtmSchema>;

package/build/v1/auth/auth.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Note: UserResponse is exported from users module

package/build/v1/auth/index.d.ts

@@ -0,0 +1,4 @@
+export * from './auth.schemas';
+export * from './auth.types';
+export * from './auth.paths';
+export * from './auth.errors';

package/build/v1/auth/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth.schemas"), exports);
+__exportStar(require("./auth.types"), exports);
+__exportStar(require("./auth.paths"), exports);
+__exportStar(require("./auth.errors"), exports);

package/build/v1/index.d.ts

@@ -0,0 +1,2 @@
+export * from './auth';
+export * from './unregistered-users';

package/build/v1/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth"), exports);
+__exportStar(require("./unregistered-users"), exports);

package/build/v1/unregistered-users/index.d.ts

@@ -0,0 +1,4 @@
+export * from './unregistered-users.schemas';
+export * from './unregistered-users.types';
+export * from './unregistered-users.paths';
+export * from './unregistered-users.errors';

package/build/v1/unregistered-users/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./unregistered-users.schemas"), exports);
+__exportStar(require("./unregistered-users.types"), exports);
+__exportStar(require("./unregistered-users.paths"), exports);
+__exportStar(require("./unregistered-users.errors"), exports);

package/build/v1/unregistered-users/unregistered-users.errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Unregistered User error codes
+ */
+export declare enum UnregUserErrorCode {
+    /** Invalid JWT token */
+    INVALID_TOKEN = "INVALID_TOKEN",
+    /** Token expired or invalidated */
+    TOKEN_EXPIRED = "TOKEN_EXPIRED",
+    /** IP mismatch - token bound to different IP */
+    IP_MISMATCH = "IP_MISMATCH",
+    /** User marked as fraud */
+    FRAUD_DETECTED = "FRAUD_DETECTED",
+    /** Token version mismatch */
+    TOKEN_VERSION_MISMATCH = "TOKEN_VERSION_MISMATCH"
+}

package/build/v1/unregistered-users/unregistered-users.errors.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnregUserErrorCode = void 0;
+/**
+ * Unregistered User error codes
+ */
+var UnregUserErrorCode;
+(function (UnregUserErrorCode) {
+    /** Invalid JWT token */
+    UnregUserErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
+    /** Token expired or invalidated */
+    UnregUserErrorCode["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
+    /** IP mismatch - token bound to different IP */
+    UnregUserErrorCode["IP_MISMATCH"] = "IP_MISMATCH";
+    /** User marked as fraud */
+    UnregUserErrorCode["FRAUD_DETECTED"] = "FRAUD_DETECTED";
+    /** Token version mismatch */
+    UnregUserErrorCode["TOKEN_VERSION_MISMATCH"] = "TOKEN_VERSION_MISMATCH";
+})(UnregUserErrorCode || (exports.UnregUserErrorCode = UnregUserErrorCode = {}));

package/build/v1/unregistered-users/unregistered-users.paths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Unregistered Users API paths
+ */
+export declare const UNREG_USERS_PATHS: {
+    /** Base path for unregistered users controller */
+    readonly BASE: "v1/unreg";
+    /** Authenticate unregistered user - PUT /api/v1/unreg */
+    readonly AUTHENTICATE: "";
+};
+/**
+ * Full API paths (with /api prefix)
+ */
+export declare const UNREG_USERS_API_PATHS: {
+    readonly AUTHENTICATE: "/api/v1/unreg";
+};

package/build/v1/unregistered-users/unregistered-users.paths.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNREG_USERS_API_PATHS = exports.UNREG_USERS_PATHS = void 0;
+/**
+ * Unregistered Users API paths
+ */
+exports.UNREG_USERS_PATHS = {
+    /** Base path for unregistered users controller */
+    BASE: 'v1/unreg',
+    /** Authenticate unregistered user - PUT /api/v1/unreg */
+    AUTHENTICATE: '',
+};
+/**
+ * Full API paths (with /api prefix)
+ */
+exports.UNREG_USERS_API_PATHS = {
+    AUTHENTICATE: `/api/${exports.UNREG_USERS_PATHS.BASE}`,
+};

package/build/v1/unregistered-users/unregistered-users.schemas.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * Unregistered User Status
+ */
+export declare enum UnregUserStatusContract {
+    ACTIVE = "active",
+    FRAUD = "fraud",
+    MIGRATED = "migrated"
+}
+/**
+ * Authenticate Unregistered User Request Schema
+ */
+export declare const AuthenticateUnregUserRequestSchema: z.ZodObject<{
+    token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Authenticate Unregistered User Response Schema
+ */
+export declare const AuthenticateUnregUserResponseSchema: z.ZodObject<{
+    token: z.ZodString;
+    requests: z.ZodNumber;
+    nextResetAt: z.ZodString;
+    status: z.ZodEnum<typeof UnregUserStatusContract>;
+}, z.core.$strip>;

package/build/v1/unregistered-users/unregistered-users.schemas.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthenticateUnregUserResponseSchema = exports.AuthenticateUnregUserRequestSchema = exports.UnregUserStatusContract = void 0;
+const zod_1 = require("zod");
+/**
+ * Unregistered User Status
+ */
+var UnregUserStatusContract;
+(function (UnregUserStatusContract) {
+    UnregUserStatusContract["ACTIVE"] = "active";
+    UnregUserStatusContract["FRAUD"] = "fraud";
+    UnregUserStatusContract["MIGRATED"] = "migrated";
+})(UnregUserStatusContract || (exports.UnregUserStatusContract = UnregUserStatusContract = {}));
+/**
+ * Authenticate Unregistered User Request Schema
+ */
+exports.AuthenticateUnregUserRequestSchema = zod_1.z.object({
+    token: zod_1.z.string().optional(),
+});
+/**
+ * Authenticate Unregistered User Response Schema
+ */
+exports.AuthenticateUnregUserResponseSchema = zod_1.z.object({
+    token: zod_1.z.string(),
+    requests: zod_1.z.number().int().nonnegative(),
+    nextResetAt: zod_1.z.string().datetime(),
+    status: zod_1.z.nativeEnum(UnregUserStatusContract),
+});

package/build/v1/unregistered-users/unregistered-users.types.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { AuthenticateUnregUserRequestSchema, AuthenticateUnregUserResponseSchema } from './unregistered-users.schemas';
+/**
+ * Request/Response Types
+ */
+export type AuthenticateUnregUserRequest = z.infer<typeof AuthenticateUnregUserRequestSchema>;
+export type AuthenticateUnregUserResponse = z.infer<typeof AuthenticateUnregUserResponseSchema>;

package/build/v1/unregistered-users/unregistered-users.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/v1/users/index.d.ts

@@ -0,0 +1,3 @@
+export * from './users.schemas';
+export * from './users.types';
+export * from './users.paths';

package/build/v1/users/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./users.schemas"), exports);
+__exportStar(require("./users.types"), exports);
+__exportStar(require("./users.paths"), exports);

package/build/v1/users/users.paths.d.ts

@@ -0,0 +1,11 @@
+export declare const USERS_PATHS: {
+    readonly BASE: "v1/users";
+    readonly ME: "me";
+    readonly ME_MARKETING_CONSENT: "me/marketing-consent";
+    readonly ME_PASSWORD: "me/password";
+};
+export declare const USERS_API_PATHS: {
+    readonly ME: "/api/v1/users/me";
+    readonly ME_MARKETING_CONSENT: "/api/v1/users/me/marketing-consent";
+    readonly ME_PASSWORD: "/api/v1/users/me/password";
+};

package/build/v1/users/users.paths.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USERS_API_PATHS = exports.USERS_PATHS = void 0;
+exports.USERS_PATHS = {
+    BASE: 'v1/users',
+    ME: 'me',
+    ME_MARKETING_CONSENT: 'me/marketing-consent',
+    ME_PASSWORD: 'me/password',
+};
+exports.USERS_API_PATHS = {
+    ME: `/api/${exports.USERS_PATHS.BASE}/${exports.USERS_PATHS.ME}`,
+    ME_MARKETING_CONSENT: `/api/${exports.USERS_PATHS.BASE}/${exports.USERS_PATHS.ME_MARKETING_CONSENT}`,
+    ME_PASSWORD: `/api/${exports.USERS_PATHS.BASE}/${exports.USERS_PATHS.ME_PASSWORD}`,
+};

package/build/v1/users/users.schemas.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+/**
+ * Update Profile Request Schema
+ */
+export declare const UpdateProfileRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Toggle Marketing Consent Request Schema
+ */
+export declare const ToggleMarketingConsentRequestSchema: z.ZodObject<{
+    marketingConsent: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Change Password Request Schema
+ */
+export declare const ChangePasswordRequestSchema: z.ZodObject<{
+    oldPassword: z.ZodString;
+    newPassword: z.ZodString;
+    logoutFromAllDevices: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * User Response Schema
+ */
+export declare const UserResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    email: z.ZodString;
+    name: z.ZodString;
+    role: z.ZodString;
+    marketingConsent: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Empty Response (for void operations like update, delete)
+ */
+export declare const EmptyResponseSchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * Error Response Schema
+ */
+export declare const ErrorResponseSchema: z.ZodObject<{
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Endpoint Response Unions (for frontend type safety)
+ */
+export declare const UpdateProfileResponseSchema: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>]>;
+export declare const DeleteAccountResponseSchema: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>]>;
+export declare const ToggleMarketingConsentResponseSchema: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>]>;
+export declare const ChangePasswordResponseSchema: z.ZodUnion<readonly [z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>]>;
+export declare const GetCurrentUserResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    uuid: z.ZodString;
+    email: z.ZodString;
+    name: z.ZodString;
+    role: z.ZodString;
+    marketingConsent: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>]>;

package/build/v1/users/users.schemas.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCurrentUserResponseSchema = exports.ChangePasswordResponseSchema = exports.ToggleMarketingConsentResponseSchema = exports.DeleteAccountResponseSchema = exports.UpdateProfileResponseSchema = exports.ErrorResponseSchema = exports.EmptyResponseSchema = exports.UserResponseSchema = exports.ChangePasswordRequestSchema = exports.ToggleMarketingConsentRequestSchema = exports.UpdateProfileRequestSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Update Profile Request Schema
+ */
+exports.UpdateProfileRequestSchema = zod_1.z.object({
+    name: zod_1.z.string().min(2, 'Name must be at least 2 characters').max(100, 'Name too long'),
+});
+/**
+ * Toggle Marketing Consent Request Schema
+ */
+exports.ToggleMarketingConsentRequestSchema = zod_1.z.object({
+    marketingConsent: zod_1.z.boolean(),
+});
+/**
+ * Change Password Request Schema
+ */
+exports.ChangePasswordRequestSchema = zod_1.z.object({
+    oldPassword: zod_1.z.string().min(1, 'Current password is required'),
+    newPassword: zod_1.z
+        .string()
+        .min(8, 'Password must be at least 8 characters')
+        .max(128, 'Password too long (maximum 128 characters)')
+        .regex(/[0-9!@#$%^&*(),.?":{}|<>]/, 'Password must contain at least one number or special character'),
+    logoutFromAllDevices: zod_1.z.boolean().default(false),
+});
+/**
+ * User Response Schema
+ */
+exports.UserResponseSchema = zod_1.z.object({
+    uuid: zod_1.z.string().uuid(),
+    email: zod_1.z.string().email(),
+    name: zod_1.z.string(),
+    role: zod_1.z.string(),
+    marketingConsent: zod_1.z.boolean(),
+    createdAt: zod_1.z.string().datetime(),
+});
+/**
+ * Empty Response (for void operations like update, delete)
+ */
+exports.EmptyResponseSchema = zod_1.z.object({});
+/**
+ * Error Response Schema
+ */
+exports.ErrorResponseSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    details: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+});
+/**
+ * Endpoint Response Unions (for frontend type safety)
+ */
+exports.UpdateProfileResponseSchema = zod_1.z.union([exports.EmptyResponseSchema, exports.ErrorResponseSchema]);
+exports.DeleteAccountResponseSchema = zod_1.z.union([exports.EmptyResponseSchema, exports.ErrorResponseSchema]);
+exports.ToggleMarketingConsentResponseSchema = zod_1.z.union([exports.EmptyResponseSchema, exports.ErrorResponseSchema]);
+exports.ChangePasswordResponseSchema = zod_1.z.union([exports.EmptyResponseSchema, exports.ErrorResponseSchema]);
+exports.GetCurrentUserResponseSchema = zod_1.z.union([exports.UserResponseSchema, exports.ErrorResponseSchema]);

package/build/v1/users/users.types.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { UpdateProfileRequestSchema, ToggleMarketingConsentRequestSchema, ChangePasswordRequestSchema, UserResponseSchema, EmptyResponseSchema, ErrorResponseSchema, UpdateProfileResponseSchema, DeleteAccountResponseSchema, ToggleMarketingConsentResponseSchema, ChangePasswordResponseSchema, GetCurrentUserResponseSchema } from './users.schemas';
+export type UpdateProfileRequest = z.infer<typeof UpdateProfileRequestSchema>;
+export type ToggleMarketingConsentRequest = z.infer<typeof ToggleMarketingConsentRequestSchema>;
+export type ChangePasswordRequest = z.infer<typeof ChangePasswordRequestSchema>;
+export type UserResponse = z.infer<typeof UserResponseSchema>;
+export type EmptyResponse = z.infer<typeof EmptyResponseSchema>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+export type UpdateProfileResponse = z.infer<typeof UpdateProfileResponseSchema>;
+export type DeleteAccountResponse = z.infer<typeof DeleteAccountResponseSchema>;
+export type ToggleMarketingConsentResponse = z.infer<typeof ToggleMarketingConsentResponseSchema>;
+export type ChangePasswordResponse = z.infer<typeof ChangePasswordResponseSchema>;
+export type GetCurrentUserResponse = z.infer<typeof GetCurrentUserResponseSchema>;

package/build/v1/users/users.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@veruna/api-contracts",
+  "version": "1.0.0",
+  "description": "API contracts for Veruna project - Zod schemas, types, and paths",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "scripts": {
+    "prepublish": "rm -rf build && tsc",
+    "build": "tsc",
+    "clean": "rm -rf build node_modules"
+  },
+  "keywords": [
+    "api",
+    "contracts",
+    "zod",
+    "types",
+    "veruna"
+  ],
+  "author": "Veruna",
+  "license": "ISC",
+  "dependencies": {
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "build"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}