@maravilla-labs/types 0.1.34 → 0.2.0

package/index.d.ts

@@ -203,6 +203,64 @@ export interface Storage {
      */
     getMetadata(key: string): Promise<StorageMetadata>;
 }
+/**
+ * Authenticated user record
+ */
+export interface AuthUser {
+    id: string;
+    email: string;
+    email_verified: boolean;
+    status: 'active' | 'suspended' | 'deactivated';
+    provider: string;
+    groups: string[];
+    created_at: number;
+    updated_at: number;
+    last_login_at?: number;
+}
+
+/**
+ * Session returned after login or refresh
+ */
+export interface AuthSession {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+    user: AuthUser;
+}
+
+/**
+ * Custom registration field
+ */
+export interface AuthField {
+    key: string;
+    label: string;
+    field_type: string;
+    required: boolean;
+    show_on_register: boolean;
+}
+
+/**
+ * Auth service for end-user authentication
+ */
+export interface AuthService {
+    register(options: { email: string; password: string; profile?: Record<string, any> }): Promise<AuthUser>;
+    login(options: { email: string; password: string }): Promise<AuthSession>;
+    validate(accessToken: string): Promise<AuthUser>;
+    refresh(refreshToken: string): Promise<AuthSession>;
+    logout(sessionId: string): Promise<void>;
+    getUser(userId: string): Promise<AuthUser | null>;
+    listUsers(filter?: { limit?: number; offset?: number; status?: string; email_contains?: string }): Promise<{ users: AuthUser[]; total: number; limit: number; offset: number }>;
+    updateUser(userId: string, update: { email?: string; status?: string; profile?: Record<string, any> }): Promise<AuthUser>;
+    deleteUser(userId: string): Promise<void>;
+    sendVerification(userId: string): Promise<{ token: string }>;
+    verifyEmail(token: string): Promise<void>;
+    sendPasswordReset(email: string): Promise<{ token: string }>;
+    resetPassword(token: string, newPassword: string): Promise<void>;
+    changePassword(userId: string, oldPassword: string, newPassword: string): Promise<void>;
+    getFieldConfig(): Promise<{ fields: AuthField[] }>;
+    withAuth<T extends (request: Request & { user: AuthUser }) => Promise<Response>>(handler: T): (request: Request) => Promise<Response>;
+}
+
 /**
  * Main platform interface available in runtime
  */
@@ -213,6 +271,8 @@ export interface Platform {
     db: Database;
     /** Storage service instance */
     storage: Storage;
+    /** Auth service for end-user authentication */
+    auth: AuthService;
     /** Legacy aliases for compatibility */
     env: {
         KV: KvStore;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maravilla-labs/types",
-  "version": "0.1.34",
+  "version": "0.2.0",
   "description": "TypeScript definitions for Maravilla Runtime platform APIs",
   "main": "index.ts",
   "types": "index.ts",