melaka 0.0.0

package/packages/cli/src/commands/validate.ts

@@ -0,0 +1,69 @@
+/**
+ * Melaka CLI - Validate Command
+ *
+ * Validate the melaka.config.ts file.
+ */
+
+import { Command } from 'commander';
+import { loadConfig, configExists, getLanguageName } from '@melaka/core';
+
+export const validateCommand = new Command('validate')
+  .description('Validate melaka.config.ts')
+  .action(async () => {
+    const chalk = (await import('chalk')).default;
+    const ora = (await import('ora')).default;
+
+    // Check if config exists
+    const existsSpinner = ora('Checking for melaka.config.ts...').start();
+    const exists = await configExists();
+
+    if (!exists) {
+      existsSpinner.fail('melaka.config.ts not found');
+      console.log('');
+      console.log(chalk.gray('Run `melaka init` to create one.'));
+      process.exit(1);
+    }
+
+    existsSpinner.succeed('Found melaka.config.ts');
+
+    // Load and validate
+    const validateSpinner = ora('Validating configuration...').start();
+
+    try {
+      const config = await loadConfig();
+      validateSpinner.succeed('Configuration is valid');
+
+      console.log('');
+      console.log(chalk.green('✓ Config file found: melaka.config.ts'));
+
+      // Languages
+      const langList = config.languages
+        .map((l) => `${l}`)
+        .join(', ');
+      console.log(chalk.green(`✓ Languages valid: ${langList}`));
+
+      // AI Provider
+      console.log(chalk.green(`✓ AI provider configured: ${config.ai.provider} (${config.ai.model})`));
+
+      // Collections
+      console.log(chalk.green(`✓ Collections configured: ${config.collections.length}`));
+      for (const collection of config.collections) {
+        const fieldCount = collection.fields?.length || 'auto';
+        const groupFlag = collection.isCollectionGroup ? ' (collection group)' : '';
+        console.log(chalk.gray(`    - ${collection.path} (${fieldCount} fields)${groupFlag}`));
+      }
+
+      // Glossary
+      const glossaryCount = config.glossary ? Object.keys(config.glossary).length : 0;
+      console.log(chalk.green(`✓ Glossary entries: ${glossaryCount}`));
+
+      console.log('');
+      console.log(chalk.green('✨ Config is valid!'));
+      console.log('');
+    } catch (error) {
+      validateSpinner.fail('Configuration is invalid');
+      console.log('');
+      console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+      process.exit(1);
+    }
+  });

package/packages/cli/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/packages/core/README.md

@@ -0,0 +1,46 @@
+# @melaka/core
+
+Core types, utilities, and configuration for Melaka.
+
+## Installation
+
+```bash
+npm install @melaka/core
+```
+
+## Usage
+
+### Define Configuration
+
+```typescript
+import { defineConfig } from '@melaka/core';
+
+export default defineConfig({
+  languages: ['ms-MY', 'zh-CN'],
+  ai: {
+    provider: 'gemini',
+    model: 'gemini-2.5-flash',
+  },
+  collections: [
+    {
+      path: 'articles',
+      fields: ['title', 'content'],
+    },
+  ],
+});
+```
+
+### Types
+
+```typescript
+import type {
+  MelakaConfig,
+  CollectionConfig,
+  FieldMapping,
+  TranslationResult,
+} from '@melaka/core';
+```
+
+## API Reference
+
+See [types.ts](./src/types.ts) for full type definitions.

package/packages/core/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@melaka/core",
+  "version": "0.0.0",
+  "description": "Core types and utilities for Melaka",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "firebase-admin": "^12.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  },
+  "peerDependencies": {
+    "firebase-admin": ">=11.0.0"
+  },
+  "peerDependenciesMeta": {
+    "firebase-admin": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rizahassan/melaka.git",
+    "directory": "packages/core"
+  },
+  "license": "MIT"
+}

package/packages/core/src/config.ts

@@ -0,0 +1,241 @@
+/**
+ * Melaka Core - Config Loader
+ *
+ * Loads and validates melaka.config.ts configuration files.
+ */
+
+import { pathToFileURL } from 'url';
+import path from 'path';
+import { MelakaConfigSchema } from './schemas';
+import type { MelakaConfig, CollectionConfig, AIConfig } from './types';
+
+// ============================================================================
+// Config Loading
+// ============================================================================
+
+/**
+ * Load and validate a Melaka configuration file.
+ *
+ * Supports both TypeScript (.ts) and JavaScript (.js) config files.
+ * The config file must export a default configuration object.
+ *
+ * @param configPath - Path to config file (defaults to 'melaka.config.ts' in cwd)
+ * @returns Validated configuration
+ * @throws Error if config file not found or invalid
+ *
+ * @example
+ * ```typescript
+ * const config = await loadConfig();
+ * // or
+ * const config = await loadConfig('/path/to/melaka.config.ts');
+ * ```
+ */
+export async function loadConfig(configPath?: string): Promise<MelakaConfig> {
+  const resolvedPath = await resolveConfigPath(configPath);
+
+  // Check if file exists
+  const fs = await import('fs/promises');
+  try {
+    await fs.access(resolvedPath);
+  } catch {
+    throw new Error(`Config file not found: ${resolvedPath}`);
+  }
+
+  // Import the config file
+  let configModule: unknown;
+  try {
+    // Use file URL for ESM compatibility
+    const fileUrl = pathToFileURL(resolvedPath).href;
+    configModule = await import(fileUrl);
+  } catch (error) {
+    throw new Error(
+      `Failed to load config file: ${resolvedPath}\n${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+
+  // Extract default export
+  const rawConfig = (configModule as { default?: unknown }).default;
+  if (!rawConfig) {
+    throw new Error(`Config file must have a default export: ${resolvedPath}`);
+  }
+
+  // Validate with Zod
+  const result = MelakaConfigSchema.safeParse(rawConfig);
+  if (!result.success) {
+    const errors = result.error.errors
+      .map((e) => `  - ${e.path.join('.')}: ${e.message}`)
+      .join('\n');
+    throw new Error(`Invalid configuration:\n${errors}`);
+  }
+
+  return result.data as MelakaConfig;
+}
+
+/**
+ * Resolve the config file path.
+ *
+ * Checks for config files in order: .ts, .js, .mjs
+ *
+ * @param configPath - Optional explicit path
+ * @returns Resolved absolute path
+ */
+async function resolveConfigPath(configPath?: string): Promise<string> {
+  if (configPath) {
+    return path.resolve(configPath);
+  }
+
+  const fs = await import('fs/promises');
+  const cwd = process.cwd();
+
+  // Check for config files in order of preference
+  const configFiles = [
+    'melaka.config.ts',
+    'melaka.config.js',
+    'melaka.config.mjs',
+  ];
+
+  for (const filename of configFiles) {
+    const fullPath = path.resolve(cwd, filename);
+    try {
+      await fs.access(fullPath);
+      return fullPath;
+    } catch {
+      // File doesn't exist, try next
+    }
+  }
+
+  // Default to .ts for error messages
+  return path.resolve(cwd, 'melaka.config.ts');
+}
+
+// ============================================================================
+// Config Helpers
+// ============================================================================
+
+/**
+ * Get the effective AI config for a collection.
+ *
+ * Merges collection-specific AI overrides with root AI config.
+ *
+ * @param rootConfig - Root Melaka configuration
+ * @param collection - Collection configuration
+ * @returns Effective AI config
+ */
+export function getEffectiveAIConfig(
+  rootConfig: MelakaConfig,
+  collection: CollectionConfig
+): AIConfig {
+  return {
+    ...rootConfig.ai,
+    ...(collection.ai || {}),
+  };
+}
+
+/**
+ * Get the effective batch size for a collection.
+ *
+ * @param rootConfig - Root Melaka configuration
+ * @param collection - Collection configuration
+ * @returns Effective batch size
+ */
+export function getEffectiveBatchSize(
+  rootConfig: MelakaConfig,
+  collection: CollectionConfig
+): number {
+  return (
+    collection.batchSize ||
+    rootConfig.defaults?.batchSize ||
+    20
+  );
+}
+
+/**
+ * Get the effective max concurrency for a collection.
+ *
+ * @param rootConfig - Root Melaka configuration
+ * @param collection - Collection configuration
+ * @returns Effective max concurrency
+ */
+export function getEffectiveMaxConcurrency(
+  rootConfig: MelakaConfig,
+  collection: CollectionConfig
+): number {
+  return (
+    collection.maxConcurrency ||
+    rootConfig.defaults?.maxConcurrency ||
+    10
+  );
+}
+
+/**
+ * Get the effective forceUpdate flag for a collection.
+ *
+ * @param rootConfig - Root Melaka configuration
+ * @param collection - Collection configuration
+ * @returns Effective forceUpdate value
+ */
+export function getEffectiveForceUpdate(
+  rootConfig: MelakaConfig,
+  collection: CollectionConfig
+): boolean {
+  return (
+    collection.forceUpdate ??
+    rootConfig.defaults?.forceUpdate ??
+    false
+  );
+}
+
+/**
+ * Find a collection config by path.
+ *
+ * @param config - Root Melaka configuration
+ * @param collectionPath - Collection path to find
+ * @returns Collection config or undefined
+ */
+export function findCollectionConfig(
+  config: MelakaConfig,
+  collectionPath: string
+): CollectionConfig | undefined {
+  return config.collections.find((c) => c.path === collectionPath);
+}
+
+// ============================================================================
+// Config Validation
+// ============================================================================
+
+/**
+ * Validate a configuration without loading from file.
+ *
+ * Useful for programmatic config generation or testing.
+ *
+ * @param config - Configuration object to validate
+ * @returns Validated configuration
+ * @throws Error if configuration is invalid
+ */
+export function validateConfig(config: unknown): MelakaConfig {
+  const result = MelakaConfigSchema.safeParse(config);
+  if (!result.success) {
+    const errors = result.error.errors
+      .map((e) => `  - ${e.path.join('.')}: ${e.message}`)
+      .join('\n');
+    throw new Error(`Invalid configuration:\n${errors}`);
+  }
+  return result.data as MelakaConfig;
+}
+
+/**
+ * Check if a config file exists at the given path.
+ *
+ * @param configPath - Path to check (defaults to 'melaka.config.ts' in cwd)
+ * @returns Whether the config file exists
+ */
+export async function configExists(configPath?: string): Promise<boolean> {
+  const resolvedPath = await resolveConfigPath(configPath);
+  const fs = await import('fs/promises');
+  try {
+    await fs.access(resolvedPath);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/packages/core/src/index.ts

@@ -0,0 +1,111 @@
+/**
+ * @melaka/core
+ *
+ * Core types, schemas, and utilities for Melaka - AI-powered Firestore localization.
+ *
+ * @packageDocumentation
+ */
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type {
+  // Configuration
+  MelakaConfig,
+  AIConfig,
+  DefaultsConfig,
+  CollectionConfig,
+  FieldMapping,
+  SchemaType,
+  // Translation
+  MelakaMetadata,
+  TranslationStatus,
+  TranslationTaskPayload,
+  TranslationResult,
+  // Migration
+  MigrationResult,
+  ProgressResult,
+  // Helpers
+  SeparatedContent,
+  TranslationRequest,
+} from './types';
+
+// Re-export defineConfig from types
+export { defineConfig } from './types';
+
+// ============================================================================
+// Schemas (Zod)
+// ============================================================================
+
+export {
+  // Config schemas
+  MelakaConfigSchema,
+  AIConfigSchema,
+  AIProviderSchema,
+  CollectionConfigSchema,
+  DefaultsConfigSchema,
+  FieldMappingSchema,
+  SchemaTypeSchema,
+  // Runtime schemas
+  TranslationTaskPayloadSchema,
+  MelakaMetadataSchema,
+  TranslationStatusSchema,
+  // Type inference
+  type AIConfigInput,
+  type AIConfigOutput,
+  type CollectionConfigInput,
+  type CollectionConfigOutput,
+  type MelakaConfigInput,
+  type MelakaConfigOutput,
+} from './schemas';
+
+// ============================================================================
+// Config Loading
+// ============================================================================
+
+export {
+  loadConfig,
+  validateConfig,
+  configExists,
+  getEffectiveAIConfig,
+  getEffectiveBatchSize,
+  getEffectiveMaxConcurrency,
+  getEffectiveForceUpdate,
+  findCollectionConfig,
+} from './config';
+
+// ============================================================================
+// Utilities
+// ============================================================================
+
+export {
+  // Content hashing
+  hashContent,
+  // Field detection
+  detectFieldType,
+  isTranslatableType,
+  // Content separation
+  separateContent,
+  // Glossary
+  mergeGlossaries,
+  formatGlossary,
+  // Language
+  getLanguageName,
+  // ID generation
+  generateBatchId,
+} from './utils';
+
+// ============================================================================
+// Schema Generation
+// ============================================================================
+
+export {
+  createFieldSchema,
+  createTranslationSchema,
+  createSchemaFromMappings,
+  createTranslatableSchemaFromMappings,
+  validateWithSchema,
+  safeValidateWithSchema,
+  schemaToJsonSchema,
+} from './schema-generator';