insforge 0.3.1

package/shared-schemas/src/ai-api.schema.ts

@@ -0,0 +1,167 @@
+import { z } from 'zod';
+import { aiConfigurationSchema, aiUsageRecordSchema } from './ai.schema';
+
+// ============= Chat Completion Schemas =============
+
+export const chatMessageSchema = z.object({
+  role: z.enum(['user', 'assistant', 'system']),
+  content: z.string(),
+  images: z
+    .array(
+      z.object({
+        url: z.string(),
+      })
+    )
+    .optional(),
+});
+
+export const chatCompletionRequestSchema = z.object({
+  model: z.string(),
+  messages: z.array(chatMessageSchema),
+  temperature: z.number().min(0).max(2).optional(),
+  maxTokens: z.number().positive().optional(),
+  topP: z.number().min(0).max(1).optional(),
+  stream: z.boolean().optional(),
+});
+
+export const chatCompletionResponseSchema = z.object({
+  text: z.string(),
+  metadata: z
+    .object({
+      model: z.string(),
+      usage: z
+        .object({
+          promptTokens: z.number().optional(),
+          completionTokens: z.number().optional(),
+          totalTokens: z.number().optional(),
+        })
+        .optional(),
+    })
+    .optional(),
+});
+
+// ============= Image Generation Schemas =============
+
+export const imageGenerationRequestSchema = z.object({
+  model: z.string(),
+  prompt: z.string(),
+  images: z
+    .array(
+      z.object({
+        url: z.string(),
+      })
+    )
+    .optional(),
+});
+
+export const imageGenerationResponseSchema = z.object({
+  text: z.string().optional(),
+  images: z.array(
+    z.object({
+      type: z.literal('imageUrl'),
+      imageUrl: z.string(),
+    })
+  ),
+  metadata: z
+    .object({
+      model: z.string(),
+      usage: z
+        .object({
+          promptTokens: z.number().optional(),
+          completionTokens: z.number().optional(),
+          totalTokens: z.number().optional(),
+        })
+        .optional(),
+    })
+    .optional(),
+});
+
+// OpenRouter-specific model schema
+export const openRouterModelSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  created: z.number(),
+  description: z.string().optional(),
+  architecture: z
+    .object({
+      inputModalities: z.array(z.string()),
+      outputModalities: z.array(z.string()),
+      tokenizer: z.string(),
+      instructType: z.string(),
+    })
+    .optional(),
+  topProvider: z
+    .object({
+      isModerated: z.boolean(),
+      contextLength: z.number(),
+      maxCompletionTokens: z.number(),
+    })
+    .optional(),
+  pricing: z.object({
+    prompt: z.string(),
+    completion: z.string(),
+    image: z.string().optional(),
+    request: z.string().optional(),
+    webSearch: z.string().optional(),
+    internalReasoning: z.string().optional(),
+    inputCacheRead: z.string().optional(),
+    inputCacheWrite: z.string().optional(),
+  }),
+});
+
+export const listModelsResponseSchema = z.object({
+  text: z.array(
+    z.object({
+      provider: z.string(),
+      configured: z.boolean(),
+      models: z.array(openRouterModelSchema),
+    })
+  ),
+  image: z.array(
+    z.object({
+      provider: z.string(),
+      configured: z.boolean(),
+      models: z.array(openRouterModelSchema),
+    })
+  ),
+});
+
+export const createAIConfigurationRequestSchema = aiConfigurationSchema.omit({
+  id: true,
+});
+
+export const updateAIConfigurationRequestSchema = z.object({
+  systemPrompt: z.string().nullable(),
+});
+
+export const listAIUsageResponseSchema = z.object({
+  records: z.array(aiUsageRecordSchema),
+  total: z.number(),
+});
+
+export const getAIUsageRequestSchema = z.object({
+  startDate: z.string().datetime().optional(),
+  endDate: z.string().datetime().optional(),
+  limit: z.string().regex(/^\d+$/).default('50'),
+  offset: z.string().regex(/^\d+$/).default('0'),
+});
+
+export const getAIUsageSummaryRequestSchema = z.object({
+  configId: z.string().uuid().optional(),
+  startDate: z.string().datetime().optional(),
+  endDate: z.string().datetime().optional(),
+});
+
+// Export types
+export type ChatMessageSchema = z.infer<typeof chatMessageSchema>;
+export type ChatCompletionRequest = z.infer<typeof chatCompletionRequestSchema>;
+export type ChatCompletionResponse = z.infer<typeof chatCompletionResponseSchema>;
+export type ImageGenerationRequest = z.infer<typeof imageGenerationRequestSchema>;
+export type ImageGenerationResponse = z.infer<typeof imageGenerationResponseSchema>;
+export type OpenRouterModel = z.infer<typeof openRouterModelSchema>;
+export type ListModelsResponse = z.infer<typeof listModelsResponseSchema>;
+export type CreateAIConfigurationRequest = z.infer<typeof createAIConfigurationRequestSchema>;
+export type UpdateAIConfigurationRequest = z.infer<typeof updateAIConfigurationRequestSchema>;
+export type ListAIUsageResponse = z.infer<typeof listAIUsageResponseSchema>;
+export type GetAIUsageRequest = z.infer<typeof getAIUsageRequestSchema>;
+export type GetAIUsageSummaryRequest = z.infer<typeof getAIUsageSummaryRequestSchema>;

package/shared-schemas/src/ai.schema.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+
+// Core schemas - only text and image supported currently
+export const modalitySchema = z.enum(['text', 'image']);
+
+export const aiConfigurationSchema = z.object({
+  id: z.string().uuid(),
+  inputModality: z.array(modalitySchema).min(1),
+  outputModality: z.array(modalitySchema).min(1),
+  provider: z.string(),
+  modelId: z.string(),
+  systemPrompt: z.string().optional(),
+});
+
+export const aiConfigurationWithUsageSchema = aiConfigurationSchema.extend({
+  usageStats: z
+    .object({
+      totalInputTokens: z.number(),
+      totalOutputTokens: z.number(),
+      totalTokens: z.number(),
+      totalImageCount: z.number(),
+      totalRequests: z.number(),
+    })
+    .optional(),
+});
+
+export const aiUsageDataSchema = z.object({
+  configId: z.string().uuid(),
+  inputTokens: z.number().int().optional(),
+  outputTokens: z.number().int().optional(),
+  imageCount: z.number().int().optional(),
+  imageResolution: z.string().optional(),
+});
+
+export const aiUsageRecordSchema = aiUsageDataSchema.extend({
+  id: z.string().uuid(),
+  createdAt: z.date(),
+});
+
+export const aiUsageSummarySchema = z.object({
+  totalInputTokens: z.number(),
+  totalOutputTokens: z.number(),
+  totalTokens: z.number(),
+  totalImageCount: z.number(),
+  totalRequests: z.number(),
+});
+
+// Export types
+export type ModalitySchema = z.infer<typeof modalitySchema>;
+export type AIConfigurationSchema = z.infer<typeof aiConfigurationSchema>;
+export type AIConfigurationWithUsageSchema = z.infer<typeof aiConfigurationWithUsageSchema>;
+export type AIUsageDataSchema = z.infer<typeof aiUsageDataSchema>;
+export type AIUsageRecordSchema = z.infer<typeof aiUsageRecordSchema>;
+export type AIUsageSummarySchema = z.infer<typeof aiUsageSummarySchema>;

package/shared-schemas/src/auth-api.schema.ts

@@ -0,0 +1,193 @@
+import { z } from 'zod';
+import {
+  emailSchema,
+  passwordSchema,
+  nameSchema,
+  userIdSchema,
+  roleSchema,
+  userSchema,
+  oAuthConfigSchema,
+} from './auth.schema';
+
+// ============================================================================
+// Common schemas
+// ============================================================================
+
+/**
+ * Pagination parameters shared across list endpoints
+ */
+export const paginationSchema = z.object({
+  limit: z.string().optional(),
+  offset: z.string().optional(),
+});
+
+/**
+ * POST /api/auth/users - Create user
+ */
+export const createUserRequestSchema = z.object({
+  email: emailSchema,
+  password: passwordSchema,
+  name: nameSchema.optional(),
+});
+
+/**
+ * POST /api/auth/sessions - Create session
+ */
+export const createSessionRequestSchema = z.object({
+  email: emailSchema,
+  password: passwordSchema,
+});
+
+/**
+ * POST /api/auth/admin/sessions - Create admin session
+ */
+export const createAdminSessionRequestSchema = createSessionRequestSchema;
+
+export const exchangeAdminSessionRequestSchema = z.object({
+  code: z.string(),
+});
+
+/**
+ * GET /api/auth/users - List users (query parameters)
+ */
+export const listUsersRequestSchema = paginationSchema
+  .extend({
+    search: z.string().optional(),
+  })
+  .optional();
+
+/**
+ * DELETE /api/auth/users - Delete users (batch)
+ */
+export const deleteUsersRequestSchema = z.object({
+  userIds: z.array(userIdSchema).min(1, 'At least one user ID is required'),
+});
+
+// ============================================================================
+// Response schemas
+// ============================================================================
+
+/**
+ * Response for POST /api/auth/users
+ */
+export const createUserResponseSchema = z.object({
+  user: userSchema,
+  accessToken: z.string(),
+});
+
+/**
+ * Response for POST /api/auth/sessions
+ */
+export const createSessionResponseSchema = createUserResponseSchema;
+
+/**
+ * Response for POST /api/auth/admin/sessions
+ */
+export const createAdminSessionResponseSchema = createUserResponseSchema;
+
+/**
+ * Response for GET /api/auth/sessions/current
+ */
+export const getCurrentSessionResponseSchema = z.object({
+  user: z.object({
+    id: userIdSchema,
+    email: emailSchema,
+    role: roleSchema,
+  }),
+});
+
+/**
+ * Response for GET /api/auth/users
+ */
+export const listUsersResponseSchema = z.object({
+  data: z.array(userSchema),
+  pagination: z.object({
+    offset: z.number(),
+    limit: z.number(),
+    total: z.number(),
+  }),
+});
+
+/**
+ * Response for DELETE /api/auth/users
+ */
+export const deleteUsersResponseSchema = z.object({
+  message: z.string(),
+  deletedCount: z.number().int().nonnegative(),
+});
+
+/**
+ * Response for GET /api/auth/v1/google-auth and GET /api/auth/v1/github-auth
+ */
+export const getOauthUrlResponseSchema = z.object({
+  authUrl: z.string().url(),
+});
+
+// ============================================================================
+// OAuth Configuration Management schemas
+// ============================================================================
+
+/**
+ * POST /api/auth/oauth/configs - Create OAuth configuration
+ */
+export const createOAuthConfigRequestSchema = oAuthConfigSchema.extend({
+  clientSecret: z.string().optional(),
+});
+
+/**
+ * PUT /api/auth/oauth/configs/:provider - Update OAuth configuration
+ */
+export const updateOAuthConfigRequestSchema = oAuthConfigSchema
+  .extend({
+    clientSecret: z.string().optional(),
+  })
+  .omit({
+    provider: true,
+  });
+
+/**
+ * Response for GET /api/auth/oauth/configs
+ */
+export const listOAuthConfigsResponseSchema = z.object({
+  data: z.array(oAuthConfigSchema),
+  count: z.number(),
+});
+
+// ============================================================================
+// Error response schema
+// ============================================================================
+
+/**
+ * Standard error response format for auth endpoints
+ */
+export const authErrorResponseSchema = z.object({
+  error: z.string(),
+  message: z.string(),
+  statusCode: z.number().int(),
+  nextActions: z.string().optional(),
+});
+
+// ============================================================================
+// Type exports
+// ============================================================================
+
+// Request types for type-safe request handling
+export type CreateUserRequest = z.infer<typeof createUserRequestSchema>;
+export type CreateSessionRequest = z.infer<typeof createSessionRequestSchema>;
+export type CreateAdminSessionRequest = z.infer<typeof createAdminSessionRequestSchema>;
+export type ListUsersRequest = z.infer<typeof listUsersRequestSchema>;
+export type DeleteUsersRequest = z.infer<typeof deleteUsersRequestSchema>;
+export type CreateOAuthConfigRequest = z.infer<typeof createOAuthConfigRequestSchema>;
+export type UpdateOAuthConfigRequest = z.infer<typeof updateOAuthConfigRequestSchema>;
+
+// Response types for type-safe responses
+export type CreateUserResponse = z.infer<typeof createUserResponseSchema>;
+export type CreateSessionResponse = z.infer<typeof createSessionResponseSchema>;
+export type CreateAdminSessionResponse = z.infer<typeof createAdminSessionResponseSchema>;
+export type GetCurrentSessionResponse = z.infer<typeof getCurrentSessionResponseSchema>;
+export type ListUsersResponse = z.infer<typeof listUsersResponseSchema>;
+export type DeleteUsersResponse = z.infer<typeof deleteUsersResponseSchema>;
+export type GetOauthUrlResponse = z.infer<typeof getOauthUrlResponseSchema>;
+export type ListOAuthConfigsResponse = z.infer<typeof listOAuthConfigsResponseSchema>;
+
+export type AuthErrorResponse = z.infer<typeof authErrorResponseSchema>;

package/shared-schemas/src/auth.schema.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+
+/**
+ * Core auth entity schemas (PostgreSQL structure)
+ * These define the fundamental auth data models
+ */
+
+// ============================================================================
+// Base field schemas
+// ============================================================================
+
+export const userIdSchema = z.string().uuid('Invalid user ID format');
+
+export const emailSchema = z.string().email('Invalid email format').toLowerCase().trim();
+
+export const passwordSchema = z
+  .string()
+  .min(6, 'Password must be at least 6 characters')
+  .max(32, 'Password must be less than 32 characters');
+
+export const nameSchema = z
+  .string()
+  .min(1, 'Name is required')
+  .max(100, 'Name must be less than 100 characters')
+  .trim();
+
+export const roleSchema = z.enum(['authenticated', 'project_admin']);
+
+// ============================================================================
+// Core entity schemas
+// ============================================================================
+
+/**
+ * User entity schema - represents the _user table in PostgreSQL
+ */
+export const userSchema = z.object({
+  id: userIdSchema,
+  email: emailSchema,
+  name: nameSchema,
+  emailVerified: z.boolean(),
+  identities: z
+    .array(
+      z.object({
+        provider: z.string(),
+      })
+    )
+    .optional(),
+  providerType: z.string().optional(),
+  createdAt: z.string(), // PostgreSQL timestamp
+  updatedAt: z.string(), // PostgreSQL timestamp
+});
+
+/**
+ * OAuth state for redirect handling
+ */
+
+export const oAuthProvidersSchema = z.enum(['google', 'github']);
+
+export const oAuthStateSchema = z.object({
+  provider: oAuthProvidersSchema,
+  redirectUri: z.string().url().optional(),
+});
+
+// OAuth provider configuration schema
+export const oAuthConfigSchema = z.object({
+  provider: z.string(),
+  clientId: z.string().optional(),
+  scopes: z.array(z.string()).optional(),
+  redirectUri: z.string().optional(),
+  useSharedKey: z.boolean(),
+});
+
+/**
+ * JWT token payload schema
+ */
+export const tokenPayloadSchema = z.object({
+  sub: userIdSchema, // Subject (user ID)
+  email: emailSchema,
+  role: roleSchema,
+  iat: z.number().optional(), // Issued at
+  exp: z.number().optional(), // Expiration
+});
+
+// ============================================================================
+// Type exports
+// ============================================================================
+
+export type UserIdSchema = z.infer<typeof userIdSchema>;
+export type EmailSchema = z.infer<typeof emailSchema>;
+export type PasswordSchema = z.infer<typeof passwordSchema>;
+export type RoleSchema = z.infer<typeof roleSchema>;
+export type UserSchema = z.infer<typeof userSchema>;
+export type TokenPayloadSchema = z.infer<typeof tokenPayloadSchema>;
+export type OAuthConfigSchema = z.infer<typeof oAuthConfigSchema>;