@sonicjs-cms/core 2.1.0 → 2.3.0

package/README.md

@@ -319,6 +319,7 @@ await migrationService.runAllMigrations()
 ├── src/
 │   ├── app.ts              # Application factory
 │   ├── db/                 # Database schemas & utilities
+│   │   └── migrations-bundle.ts  # Auto-generated migration bundle
 │   ├── services/           # Business logic
 │   ├── middleware/         # Request processing
 │   ├── routes/             # HTTP handlers
@@ -326,10 +327,83 @@ await migrationService.runAllMigrations()
 │   ├── plugins/            # Plugin system & core plugins
 │   ├── types/              # TypeScript definitions
 │   └── utils/              # Utility functions
-├── migrations/             # Core database migrations
+├── migrations/             # Core database migrations (.sql files)
+├── scripts/
+│   └── generate-migrations.ts  # Migration bundler script
 └── dist/                   # Compiled output
 ```
 
+## 🔄 Development Workflow
+
+### Migration System
+
+SonicJS uses a **build-time migration bundler** because Cloudflare Workers cannot access the filesystem at runtime. All migration SQL is bundled into TypeScript during the build process.
+
+#### Creating New Migrations
+
+1. **Create the SQL file** in `migrations/`:
+   ```bash
+   # Use sequential three-digit numbering
+   touch migrations/027_add_your_feature.sql
+   ```
+
+2. **Write idempotent SQL**:
+   ```sql
+   -- migrations/027_add_your_feature.sql
+   CREATE TABLE IF NOT EXISTS your_table (
+     id TEXT PRIMARY KEY,
+     name TEXT NOT NULL
+   );
+
+   CREATE INDEX IF NOT EXISTS idx_your_table_name ON your_table(name);
+   ```
+
+3. **Regenerate the bundle**:
+   ```bash
+   npm run generate:migrations
+   # Or this runs automatically during: npm run build
+   ```
+
+4. **Build the package**:
+   ```bash
+   npm run build
+   ```
+
+5. **Apply to your test database**:
+   ```bash
+   cd ../my-sonicjs-app
+   wrangler d1 migrations apply DB --local
+   ```
+
+#### Available Scripts
+
+```bash
+# Generate migrations bundle only
+npm run generate:migrations
+
+# Build (automatically runs generate:migrations first)
+npm run build
+
+# Type check
+npm run type-check
+
+# Run tests
+npm run test
+```
+
+#### How It Works
+
+```
+migrations/*.sql → scripts/generate-migrations.ts → src/db/migrations-bundle.ts → dist/
+```
+
+The `generate-migrations.ts` script:
+- Reads all `.sql` files from `migrations/`
+- Generates `src/db/migrations-bundle.ts` with embedded SQL
+- Provides `getMigrationSQLById()` for runtime access
+
+**Important**: Always rebuild after modifying migration files. The `.sql` files are not used at runtime.
+
 ## 🔄 Versioning
 
 SonicJS follows semantic versioning:

package/dist/app-Db0AfT5F.d.cts

@@ -0,0 +1,100 @@
+import { Hono, Context } from 'hono';
+import { D1Database, KVNamespace, R2Bucket } from '@cloudflare/workers-types';
+
+/**
+ * Main Application Factory
+ *
+ * Creates a configured SonicJS application with all core functionality
+ */
+
+interface Bindings {
+    DB: D1Database;
+    CACHE_KV: KVNamespace;
+    MEDIA_BUCKET: R2Bucket;
+    ASSETS: Fetcher;
+    EMAIL_QUEUE?: Queue;
+    SENDGRID_API_KEY?: string;
+    DEFAULT_FROM_EMAIL?: string;
+    IMAGES_ACCOUNT_ID?: string;
+    IMAGES_API_TOKEN?: string;
+    ENVIRONMENT?: string;
+    BUCKET_NAME?: string;
+}
+interface Variables {
+    user?: {
+        userId: string;
+        email: string;
+        role: string;
+        exp: number;
+        iat: number;
+    };
+    requestId?: string;
+    startTime?: number;
+    appVersion?: string;
+}
+interface SonicJSConfig {
+    collections?: {
+        directory?: string;
+        autoSync?: boolean;
+    };
+    plugins?: {
+        directory?: string;
+        autoLoad?: boolean;
+        disableAll?: boolean;
+    };
+    routes?: Array<{
+        path: string;
+        handler: Hono;
+    }>;
+    middleware?: {
+        beforeAuth?: Array<(c: Context, next: () => Promise<void>) => Promise<void>>;
+        afterAuth?: Array<(c: Context, next: () => Promise<void>) => Promise<void>>;
+    };
+    version?: string;
+    name?: string;
+}
+type SonicJSApp = Hono<{
+    Bindings: Bindings;
+    Variables: Variables;
+}>;
+/**
+ * Create a SonicJS application with core functionality
+ *
+ * @param config - Application configuration
+ * @returns Configured Hono application
+ *
+ * @example
+ * ```typescript
+ * import { createSonicJSApp } from '@sonicjs/core'
+ *
+ * const app = createSonicJSApp({
+ *   collections: {
+ *     directory: './src/collections',
+ *     autoSync: true
+ *   },
+ *   plugins: {
+ *     directory: './src/plugins',
+ *     autoLoad: true
+ *   }
+ * })
+ *
+ * export default app
+ * ```
+ */
+declare function createSonicJSApp(config?: SonicJSConfig): SonicJSApp;
+/**
+ * Setup core middleware (backward compatibility)
+ *
+ * @param _app - Hono application
+ * @deprecated Use createSonicJSApp() instead
+ */
+declare function setupCoreMiddleware(_app: SonicJSApp): void;
+/**
+ * Setup core routes (backward compatibility)
+ *
+ * @param _app - Hono application
+ * @deprecated Use createSonicJSApp() instead
+ */
+declare function setupCoreRoutes(_app: SonicJSApp): void;
+
+export { type Bindings as B, type SonicJSConfig as S, type Variables as V, setupCoreRoutes as a, type SonicJSApp as b, createSonicJSApp as c, setupCoreMiddleware as s };

package/dist/app-Db0AfT5F.d.ts

@@ -0,0 +1,100 @@
+import { Hono, Context } from 'hono';
+import { D1Database, KVNamespace, R2Bucket } from '@cloudflare/workers-types';
+
+/**
+ * Main Application Factory
+ *
+ * Creates a configured SonicJS application with all core functionality
+ */
+
+interface Bindings {
+    DB: D1Database;
+    CACHE_KV: KVNamespace;
+    MEDIA_BUCKET: R2Bucket;
+    ASSETS: Fetcher;
+    EMAIL_QUEUE?: Queue;
+    SENDGRID_API_KEY?: string;
+    DEFAULT_FROM_EMAIL?: string;
+    IMAGES_ACCOUNT_ID?: string;
+    IMAGES_API_TOKEN?: string;
+    ENVIRONMENT?: string;
+    BUCKET_NAME?: string;
+}
+interface Variables {
+    user?: {
+        userId: string;
+        email: string;
+        role: string;
+        exp: number;
+        iat: number;
+    };
+    requestId?: string;
+    startTime?: number;
+    appVersion?: string;
+}
+interface SonicJSConfig {
+    collections?: {
+        directory?: string;
+        autoSync?: boolean;
+    };
+    plugins?: {
+        directory?: string;
+        autoLoad?: boolean;
+        disableAll?: boolean;
+    };
+    routes?: Array<{
+        path: string;
+        handler: Hono;
+    }>;
+    middleware?: {
+        beforeAuth?: Array<(c: Context, next: () => Promise<void>) => Promise<void>>;
+        afterAuth?: Array<(c: Context, next: () => Promise<void>) => Promise<void>>;
+    };
+    version?: string;
+    name?: string;
+}
+type SonicJSApp = Hono<{
+    Bindings: Bindings;
+    Variables: Variables;
+}>;
+/**
+ * Create a SonicJS application with core functionality
+ *
+ * @param config - Application configuration
+ * @returns Configured Hono application
+ *
+ * @example
+ * ```typescript
+ * import { createSonicJSApp } from '@sonicjs/core'
+ *
+ * const app = createSonicJSApp({
+ *   collections: {
+ *     directory: './src/collections',
+ *     autoSync: true
+ *   },
+ *   plugins: {
+ *     directory: './src/plugins',
+ *     autoLoad: true
+ *   }
+ * })
+ *
+ * export default app
+ * ```
+ */
+declare function createSonicJSApp(config?: SonicJSConfig): SonicJSApp;
+/**
+ * Setup core middleware (backward compatibility)
+ *
+ * @param _app - Hono application
+ * @deprecated Use createSonicJSApp() instead
+ */
+declare function setupCoreMiddleware(_app: SonicJSApp): void;
+/**
+ * Setup core routes (backward compatibility)
+ *
+ * @param _app - Hono application
+ * @deprecated Use createSonicJSApp() instead
+ */
+declare function setupCoreRoutes(_app: SonicJSApp): void;
+
+export { type Bindings as B, type SonicJSConfig as S, type Variables as V, setupCoreRoutes as a, type SonicJSApp as b, createSonicJSApp as c, setupCoreMiddleware as s };