@better-i18n/schemas 0.2.0 → 0.2.2

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@better-i18n/schemas",
-  "version": "0.2.0",
-  "description": "Public schemas and types for Better i18n SDK and MCP",
+  "version": "0.2.2",
+  "description": "Shared validation schemas for API and frontend",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {
     ".": "./src/index.ts",
-    "./ai-models": "./src/ai-models.ts"
+    "./projects": "./src/projects/index.ts",
+    "./organizations": "./src/organizations/index.ts",
+    "./languages": "./src/languages/index.ts",
+    "./github": "./src/github.ts",
+    "./translations": "./src/translations.ts"
   },
   "files": [
     "src"
@@ -15,8 +19,14 @@
   "scripts": {
     "type-check": "tsc --noEmit"
   },
+  "dependencies": {
+    "zod": "^3.25.76"
+  },
   "devDependencies": {
     "typescript": "~5.9.2"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT"
 }

package/src/ai-models.ts

@@ -9,7 +9,8 @@ export type ModelProvider =
   | "openai"
   | "gemini"
   | "claude"
-  | "openrouter";
+  | "openrouter"
+  | "azure-openai";
 
 // Model categories
 export type ModelCategory =
@@ -20,7 +21,7 @@ export type ModelCategory =
   | "legacy";
 
 // Icon types for models
-export type ModelIcon = "OpenAI" | "Gemini" | "Claude" | "BetterAI";
+export type ModelIcon = "OpenAI" | "Gemini" | "Claude" | "BetterAI" | "AzureOpenAI";
 
 // Model color configuration
 export interface ModelColors {
@@ -41,7 +42,7 @@ export interface AIModelConfig {
   /** Provider identifier */
   provider: ModelProvider;
   /** Icon to display for this model (from lucide-react or custom) */
-  icon: "OpenAI" | "Gemini" | "Claude" | "BetterAI";
+  icon: ModelIcon;
   /** Colors for UI elements */
   colors: ModelColors;
   /** Actual API model ID to send to provider SDK (e.g., "gpt-5.2", "gemini-2.5-flash") */
@@ -85,7 +86,7 @@ export interface ProviderInfo {
  */
 export const AI_MODELS: AIModelConfig[] = [
   // ============================================
-  // Better AI - Platform Default (Powered by Gemini 3 Flash)
+  // Better AI - Platform Default (Powered by Gemini 3.1 Pro Preview)
   // ============================================
   {
     id: "better-ai",
@@ -97,11 +98,11 @@ export const AI_MODELS: AIModelConfig[] = [
       hover: "hover:bg-gray-100 dark:hover:bg-neutral-600",
       icon: "text-gray-700 dark:text-white",
     },
-    apiModelId: "gemini-3-pro-preview",
-    contextSize: 1_048_576, // 1M tokens (verified from Google docs)
+    apiModelId: "gemini-2.5-flash",
+    contextSize: 1_048_576, // 1M tokens
     maxOutput: 65_536,
     description:
-      "Most capable AI model powered by Gemini 3 Pro. Best for complex translations.",
+      "Powerful AI model powered by Gemini 2.5 Preview. Great for translations.",
     isDefault: true,
     badge: "Default",
     releaseDate: "Jan 2025",
@@ -112,47 +113,47 @@ export const AI_MODELS: AIModelConfig[] = [
   },
 
   // ============================================
-  // OpenAI Models (via OpenRouter)
+  // Azure OpenAI Models (via Azure credits)
   // ============================================
   {
-    id: "gpt-5.2",
-    name: "GPT 5.2",
-    provider: "openrouter",
-    icon: "OpenAI",
+    id: "gpt-5.3",
+    name: "GPT 5.3",
+    provider: "azure-openai",
+    icon: "AzureOpenAI",
     colors: {
-      background: "bg-gray-200 dark:bg-neutral-700",
-      hover: "hover:bg-gray-300 dark:hover:bg-neutral-600",
-      icon: "text-gray-600 dark:text-white",
+      background: "bg-gray-100 dark:bg-neutral-800",
+      hover: "hover:bg-gray-200 dark:hover:bg-neutral-700",
+      icon: "text-gray-700 dark:text-neutral-300",
     },
-    apiModelId: "openai/gpt-5.2",
-    contextSize: 400_000, // 400K tokens (GPT-5 series standard)
+    apiModelId: "gpt-5.3-chat",
+    contextSize: 1_047_576,
     maxOutput: 128_000,
-    description: "OpenAI's latest flagship model via OpenRouter.",
+    description: "OpenAI's latest and most capable model via Azure.",
     badge: "New",
     releaseDate: "2025",
     trainingData: "2025",
-    speed: 95,
+    speed: 90,
     category: "flagship",
     requiresUserKey: false,
   },
   {
-    id: "gpt-5.1",
-    name: "GPT 5.1",
-    provider: "openrouter",
-    icon: "OpenAI",
+    id: "gpt-5.2",
+    name: "GPT 5.2",
+    provider: "azure-openai",
+    icon: "AzureOpenAI",
     colors: {
-      background: "bg-gray-200 dark:bg-neutral-700",
-      hover: "hover:bg-gray-300 dark:hover:bg-neutral-600",
-      icon: "text-gray-600 dark:text-white",
+      background: "bg-gray-100 dark:bg-neutral-800",
+      hover: "hover:bg-gray-200 dark:hover:bg-neutral-700",
+      icon: "text-gray-700 dark:text-neutral-300",
     },
-    apiModelId: "openai/gpt-5.1",
-    contextSize: 400_000, // 400K tokens (GPT-5 series standard)
+    apiModelId: "gpt-5.2-chat",
+    contextSize: 1_047_576,
     maxOutput: 128_000,
-    description: "OpenAI's capable model via OpenRouter.",
+    description: "OpenAI GPT 5.2 via Azure OpenAI.",
     badge: "Fast",
     releaseDate: "2025",
     trainingData: "2025",
-    speed: 93,
+    speed: 95,
     category: "flagship",
     requiresUserKey: false,
   },
@@ -168,7 +169,7 @@ export const AI_MODELS: AIModelConfig[] = [
     colors: {
       background: "bg-blue-50 dark:bg-blue-700",
       hover: "hover:bg-blue-100 dark:hover:bg-blue-600",
-      icon: "text-blue-400 dark:text-blue-400",
+      icon: "text-blue-500 dark:text-blue-100",
     },
     apiModelId: "gemini-3-pro-preview",
     contextSize: 1_048_576, // 1M tokens (verified from Google docs)
@@ -181,31 +182,6 @@ export const AI_MODELS: AIModelConfig[] = [
     category: "flagship",
     requiresUserKey: false,
   },
-
-  // ============================================
-  // Anthropic Claude (via OpenRouter) - Moved to bottom
-  // ============================================
-  {
-    id: "claude-4-sonnet",
-    name: "Claude Sonnet 4",
-    provider: "openrouter",
-    icon: "Claude",
-    colors: {
-      background: "bg-orange-50 dark:bg-orange-700",
-      hover: "hover:bg-orange-100 dark:hover:bg-orange-600",
-      icon: "text-orange-400 dark:text-orange-400",
-    },
-    apiModelId: "anthropic/claude-sonnet-4.5",
-    contextSize: 200_000,
-    maxOutput: 8_192,
-    description:
-      "Anthropic's flagship. Excellent reasoning and writing via OpenRouter.",
-    badge: "New",
-    releaseDate: "2025",
-    speed: 90,
-    category: "flagship",
-    requiresUserKey: false,
-  },
 ];
 
 // ============================================

package/src/content.ts

@@ -0,0 +1,291 @@
+/**
+ * Zod validation schemas for Content Model CRUD operations.
+ *
+ * Content models are user-defined content types (blog, changelog, legal, etc.)
+ * with custom field definitions. These schemas validate all API inputs.
+ */
+
+import { z } from "zod";
+
+// —————————————————————————————————————————————————————————————————————————————
+// Shared enums
+// —————————————————————————————————————————————————————————————————————————————
+
+export const contentModelFieldTypeEnum = z.enum([
+  "text",
+  "textarea",
+  "richtext",
+  "number",
+  "boolean",
+  "date",
+  "datetime",
+  "enum",
+  "media",
+  "relation",
+]);
+
+export const contentModelKindEnum = z.enum(["collection", "single"]);
+
+// —————————————————————————————————————————————————————————————————————————————
+// Field-level config schemas (must precede model schemas that reference them)
+// —————————————————————————————————————————————————————————————————————————————
+
+/** Single enum option (label displayed to users, value stored in DB) */
+export const enumValueItemSchema = z.object({
+  label: z.string().min(1).max(200),
+  value: z.string().min(1).max(200),
+});
+
+/** Extensible field-level options (Unsplash, AI generation, enum values, etc.) */
+export const fieldOptionsSchema = z.object({
+  unsplash: z.object({ enabled: z.boolean() }).optional(),
+  aiGeneration: z.object({
+    enabled: z.boolean(),
+    prompt: z.string().max(2000).optional(),
+    model: z.string().max(100).optional(),
+  }).optional(),
+  enumValues: z.array(enumValueItemSchema).max(200).optional(),
+  showInTable: z.boolean().optional(),
+}).optional();
+
+/** Type-specific field configuration (e.g., targetModel for relation fields) */
+export const fieldConfigSchema = z.object({
+  targetModel: z.string().optional(),
+}).optional();
+
+// —————————————————————————————————————————————————————————————————————————————
+// Model schemas
+// —————————————————————————————————————————————————————————————————————————————
+
+/** List all content models for a project */
+export const listContentModelsSchema = z.object({
+  projectId: z.string().uuid(),
+});
+
+/** Get a single content model by slug */
+export const getContentModelBySlugSchema = z.object({
+  projectId: z.string().uuid(),
+  slug: z.string().min(1),
+});
+
+/** Get a single content model by ID */
+export const getContentModelSchema = z.object({
+  modelId: z.string().uuid(),
+});
+
+/** Create a content model with fields atomically */
+export const createContentModelSchema = z.object({
+  projectId: z.string().uuid(),
+  organizationId: z.string().uuid(),
+  slug: z
+    .string()
+    .min(1)
+    .max(100)
+    .regex(/^[a-z0-9-]+$/, "Slug must contain only lowercase letters, numbers, and hyphens"),
+  displayName: z.string().min(1).max(200),
+  description: z.string().max(1000).optional(),
+  kind: contentModelKindEnum.default("collection"),
+  icon: z.string().max(50).optional(),
+  enableVersionHistory: z.boolean().default(true),
+  includeBody: z.boolean().default(true),
+  fields: z
+    .array(
+      z.object({
+        name: z
+          .string()
+          .min(1)
+          .max(100)
+          .regex(
+            /^[a-z_][a-z0-9_]*$/,
+            "Field name must be snake_case (lowercase letters, numbers, underscores)",
+          ),
+        displayName: z.string().min(1).max(200),
+        type: contentModelFieldTypeEnum.default("text"),
+        localized: z.boolean().default(false),
+        required: z.boolean().default(false),
+        placeholder: z.string().max(500).optional(),
+        helpText: z.string().max(500).optional(),
+        position: z.number().int().min(0),
+        fieldConfig: fieldConfigSchema,
+        options: fieldOptionsSchema,
+      }),
+    )
+    .default([]),
+});
+
+/** Table settings schema for base field visibility */
+export const contentModelTableSettingsSchema = z.object({
+  baseFields: z.record(z.string(), z.boolean()).optional(),
+}).optional();
+
+/** Update a content model's metadata (not fields) */
+export const updateContentModelSchema = z.object({
+  modelId: z.string().uuid(),
+  displayName: z.string().min(1).max(200).optional(),
+  description: z.string().max(1000).optional(),
+  kind: contentModelKindEnum.optional(),
+  icon: z.string().max(50).optional(),
+  enableVersionHistory: z.boolean().optional(),
+  includeBody: z.boolean().optional(),
+  tableSettings: contentModelTableSettingsSchema,
+});
+
+/** Delete a content model */
+export const deleteContentModelSchema = z.object({
+  modelId: z.string().uuid(),
+});
+
+// —————————————————————————————————————————————————————————————————————————————
+// Field schemas
+// —————————————————————————————————————————————————————————————————————————————
+
+/** Add a field to a content model */
+export const addContentModelFieldSchema = z.object({
+  modelId: z.string().uuid(),
+  name: z
+    .string()
+    .min(1)
+    .max(100)
+    .regex(
+      /^[a-z_][a-z0-9_]*$/,
+      "Field name must be snake_case",
+    ),
+  displayName: z.string().min(1).max(200),
+  type: contentModelFieldTypeEnum.default("text"),
+  localized: z.boolean().default(false),
+  required: z.boolean().default(false),
+  placeholder: z.string().max(500).optional(),
+  helpText: z.string().max(500).optional(),
+  position: z.number().int().min(0).optional(),
+  options: fieldOptionsSchema,
+  fieldConfig: fieldConfigSchema,
+});
+
+/** Update an existing field */
+export const updateContentModelFieldSchema = z.object({
+  fieldId: z.string().uuid(),
+  displayName: z.string().min(1).max(200).optional(),
+  type: contentModelFieldTypeEnum.optional(),
+  localized: z.boolean().optional(),
+  required: z.boolean().optional(),
+  placeholder: z.string().max(500).optional(),
+  helpText: z.string().max(500).optional(),
+  options: fieldOptionsSchema,
+  fieldConfig: fieldConfigSchema,
+});
+
+/** Remove a field from a content model */
+export const removeContentModelFieldSchema = z.object({
+  fieldId: z.string().uuid(),
+});
+
+/** Reorder fields within a content model */
+export const reorderContentModelFieldsSchema = z.object({
+  modelId: z.string().uuid(),
+  fieldIds: z.array(z.string().uuid()).min(1),
+});
+
+// —————————————————————————————————————————————————————————————————————————————
+// Entry schemas
+// —————————————————————————————————————————————————————————————————————————————
+
+export const contentEntryStatusEnum = z.enum(["draft", "published", "archived"]);
+export const contentEntrySortFieldEnum = z.enum(["publishedAt", "createdAt", "updatedAt", "title"]);
+
+/** List content entries with filtering and pagination */
+export const listContentEntriesSchema = z.object({
+  projectId: z.string().uuid(),
+  modelSlug: z.string().optional(),
+  status: contentEntryStatusEnum.optional(),
+  search: z.string().optional(),
+  languageCodes: z.array(z.string().transform(v => v.toLowerCase())).optional(),
+  /** Filter by custom field values. Key = field name, value = exact match. */
+  fieldFilters: z.record(z.string(), z.string()).optional(),
+  sort: contentEntrySortFieldEnum.optional(),
+  order: z.enum(["asc", "desc"]).optional(),
+  page: z.number().int().min(1).default(1),
+  limit: z.number().int().min(1).max(100).default(25),
+});
+
+/** Get a single content entry by ID */
+export const getContentEntrySchema = z.object({
+  entryId: z.string().uuid(),
+});
+
+/** Create a content entry */
+export const createContentEntrySchema = z.object({
+  contentModelId: z.string().uuid(),
+  organizationId: z.string().uuid(),
+  slug: z
+    .string()
+    .min(1)
+    .max(200)
+    .regex(/^[a-z0-9-]+$/, "Slug must contain only lowercase letters, numbers, and hyphens"),
+  sourceLanguageCode: z.string().default("en").transform(v => v.toLowerCase()),
+  title: z.string().min(1).max(500),
+  body: z.unknown().default([]),
+  bodyMarkdown: z.string().optional(),
+  customFields: z.record(z.string(), z.string().nullable()).default({}),
+  status: contentEntryStatusEnum.default("draft"),
+});
+
+/** Update a content entry */
+export const updateContentEntrySchema = z.object({
+  entryId: z.string().uuid(),
+  languageCode: z.string().optional().transform(v => v?.toLowerCase()),
+  title: z.string().min(1).max(500).optional(),
+  body: z.unknown().optional(),
+  bodyMarkdown: z.string().optional(),
+  customFields: z.record(z.string(), z.string().nullable()).optional(),
+  status: contentEntryStatusEnum.optional(),
+  slug: z
+    .string()
+    .min(1)
+    .max(200)
+    .regex(/^[a-z0-9-]+$/, "Slug must contain only lowercase letters, numbers, and hyphens")
+    .optional(),
+  publishedAt: z.string().datetime({ offset: true }).nullable().optional(),
+});
+
+/** Delete a content entry */
+export const deleteContentEntrySchema = z.object({
+  entryId: z.string().uuid(),
+});
+
+/** Publish a content entry */
+export const publishContentEntrySchema = z.object({
+  entryId: z.string().uuid(),
+});
+
+/** Generate AI content for a specific field */
+export const generateFieldContentSchema = z.object({
+  entryId: z.string().uuid(),
+  fieldName: z.string().min(1),
+  languageCode: z.string().min(1).transform(v => v.toLowerCase()),
+  modelId: z.string().max(100).optional(),
+  prompt: z.string().max(4000).optional(),
+});
+
+// —————————————————————————————————————————————————————————————————————————————
+// Type exports
+// —————————————————————————————————————————————————————————————————————————————
+
+export type EnumValueItem = z.infer<typeof enumValueItemSchema>;
+export type ListContentModelsInput = z.infer<typeof listContentModelsSchema>;
+export type GetContentModelBySlugInput = z.infer<typeof getContentModelBySlugSchema>;
+export type GetContentModelInput = z.infer<typeof getContentModelSchema>;
+export type CreateContentModelInput = z.infer<typeof createContentModelSchema>;
+export type UpdateContentModelInput = z.infer<typeof updateContentModelSchema>;
+export type DeleteContentModelInput = z.infer<typeof deleteContentModelSchema>;
+export type AddContentModelFieldInput = z.infer<typeof addContentModelFieldSchema>;
+export type UpdateContentModelFieldInput = z.infer<typeof updateContentModelFieldSchema>;
+export type RemoveContentModelFieldInput = z.infer<typeof removeContentModelFieldSchema>;
+export type ReorderContentModelFieldsInput = z.infer<typeof reorderContentModelFieldsSchema>;
+
+export type ListContentEntriesInput = z.infer<typeof listContentEntriesSchema>;
+export type GetContentEntryInput = z.infer<typeof getContentEntrySchema>;
+export type CreateContentEntryInput = z.infer<typeof createContentEntrySchema>;
+export type UpdateContentEntryInput = z.infer<typeof updateContentEntrySchema>;
+export type DeleteContentEntryInput = z.infer<typeof deleteContentEntrySchema>;
+export type PublishContentEntryInput = z.infer<typeof publishContentEntrySchema>;
+export type GenerateFieldContentInput = z.infer<typeof generateFieldContentSchema>;

package/src/github.ts

@@ -0,0 +1,130 @@
+
+import { z } from 'zod';
+
+/**
+ * Schema for listing GitHub repositories from an installation.
+ */
+export const listRepositoriesSchema = z.object({
+  installationId: z.number(),
+  page: z.number().min(1).default(1),
+  limit: z.number().min(1).max(100).default(30),
+  type: z.enum(["all", "public", "private"]).default("all"),
+  sort: z
+    .enum(["created", "updated", "pushed", "full_name"])
+    .default("updated"),
+  direction: z.enum(["asc", "desc"]).default("desc"),
+});
+
+/**
+ * Schema for getting a specific GitHub repository.
+ */
+export const getRepositorySchema = z.object({
+  installationId: z.number(),
+  owner: z.string().min(1),
+  repo: z.string().min(1),
+});
+
+/**
+ * Schema for adding a GitHub repository to a project.
+ */
+export const addRepositorySchema = z.object({
+  projectId: z.string().uuid(),
+  installationId: z.number(),
+  owner: z.string().min(1),
+  repo: z.string().min(1),
+  path: z.string().default(""),
+  pattern: z.string().default(""),
+  format: z.enum(["JSON_FLAT", "JSON_NAMESPACED"]).default("JSON_FLAT"),
+  branch: z.string().optional(),
+  targetBranch: z.string().default("i18n-sync"),
+  autoPushToSourceBranch: z.boolean().default(false),
+});
+
+/**
+ * Schema for updating a GitHub repository.
+ */
+export const updateRepositorySchema = z.object({
+  repositoryId: z.string().uuid(),
+  path: z.string().optional(),
+  pattern: z.string().optional(),
+  format: z.enum(["JSON_FLAT", "JSON_NAMESPACED"]).optional(),
+  branch: z.string().optional(),
+  targetBranch: z.string().optional(),
+  enabled: z.boolean().optional(),
+  autoPushToSourceBranch: z.boolean().optional(),
+});
+
+/**
+ * Schema for removing a GitHub repository from a project.
+ */
+export const removeRepositorySchema = z.object({
+  repositoryId: z.string().uuid(),
+});
+
+/**
+ * Schema for syncing a GitHub repository.
+ */
+export const syncRepositorySchema = z.object({
+  repositoryId: z.string().uuid(),
+});
+
+/**
+ * Schema for GitHub OAuth callback.
+ */
+export const oauthCallbackSchema = z.object({
+  code: z.string().min(1),
+  state: z.string().optional(),
+  installation_id: z.string().optional(), // GitHub App installation ID (as string)
+});
+
+/**
+ * Schema for listing GitHub repository branches.
+ */
+export const listBranchesSchema = z.object({
+  installationId: z.number(),
+  owner: z.string().min(1),
+  repo: z.string().min(1),
+});
+
+/**
+ * Schema for getting GitHub repository tree.
+ */
+export const getTreeSchema = z.object({
+  installationId: z.number(),
+  owner: z.string().min(1),
+  repo: z.string().min(1),
+  branch: z.string().min(1),
+  path: z.string().default(""),
+});
+
+/**
+ * Schema for getting source files from a repository.
+ */
+export const getSourceFilesSchema = z.object({
+  repositoryId: z.string().uuid(),
+});
+
+/**
+ * Schema for connecting a GitHub repository for Doctor CI only (no sync).
+ */
+export const connectForDoctorSchema = z.object({
+  projectId: z.string().uuid(),
+  installationId: z.number(),
+  owner: z.string().min(1),
+  repo: z.string().min(1),
+});
+
+/**
+ * Types for GitHub repository operations.
+ */
+export type ListRepositoriesInput = z.infer<typeof listRepositoriesSchema>;
+export type GetRepositoryInput = z.infer<typeof getRepositorySchema>;
+export type AddRepositoryInput = z.infer<typeof addRepositorySchema>;
+export type UpdateRepositoryInput = z.infer<typeof updateRepositorySchema>;
+export type RemoveRepositoryInput = z.infer<typeof removeRepositorySchema>;
+export type SyncRepositoryInput = z.infer<typeof syncRepositorySchema>;
+export type OAuthCallbackInput = z.infer<typeof oauthCallbackSchema>;
+export type ListBranchesInput = z.infer<typeof listBranchesSchema>;
+export type GetTreeInput = z.infer<typeof getTreeSchema>;
+export type GetSourceFilesInput = z.infer<typeof getSourceFilesSchema>;
+export type ConnectForDoctorInput = z.infer<typeof connectForDoctorSchema>;

package/src/index.ts

@@ -1,11 +1,10 @@
-/**
- * Better i18n Public Schemas
- *
- * This package contains public-facing types and schemas for:
- * - AI model configurations (used by landing demo and SDKs)
- * - MCP tool input/output types (future)
- *
- * Internal tRPC validation schemas are in the platform repo.
- */
 
 export * from "./ai-models";
+export * from "./github";
+export * from "./languages/index";
+export * from "./organizations/index";
+export * from "./projects/index";
+export * from "./subscription";
+export * from "./sync";
+export * from "./translations";
+export * from "./content";