@gettersethya/mira 0.1.0-alpha.2 → 0.1.0-alpha.21

package/README.md

@@ -0,0 +1,174 @@
+# @gettersethya/mira
+
+[![npm](https://img.shields.io/npm/v/@gettersethya/mira)](https://www.npmjs.com/package/@gettersethya/mira)
+
+> **Early pre-alpha.** Breaking changes may occur without notice.
+
+Self-hosted backend in TypeScript using [Effect v4](https://effect.website). Define collections, get a full REST API with auth, file storage, access rules, and schema migrations — all with zero config.
+
+## Installation
+
+```bash
+npm install @gettersethya/mira @gettersethya/mira-collection effect
+# or
+pnpm add @gettersethya/mira @gettersethya/mira-collection effect
+```
+
+## Quick start
+
+```typescript
+import { defineRule, LocalFileStorage, Mira, NodePlatform, Rule, SqliteDatabase } from "@gettersethya/mira"
+import { Posts, Users } from "./collections.js"
+
+const userRules = defineRule(Users, (R) => ({
+  list:   Rule.public(),
+  view:   Rule.public(),
+  create: Rule.public(),
+  update: R.selfId().eq(R.authId(Users)),
+}))
+
+const postRules = defineRule(Posts, (R) => ({
+  list:   R.field("published").eq(R.literal(true)),
+  view:   R.or(
+    R.field("published").eq(R.literal(true)),
+    R.field("authorId").eq(R.authId(Users))
+  ),
+  create: R.authId(Users).neq(R.literal("")),
+  update: R.field("authorId").eq(R.authId(Users)),
+  delete: R.field("authorId").eq(R.authId(Users)),
+}))
+
+const app = Mira.builder()
+  .platform(NodePlatform)
+  .database(SqliteDatabase({ filename: "mira.db" }))
+  .storage(LocalFileStorage({ directory: "./uploads" }))
+  .collections([Users, Posts])
+  .rules([userRules, postRules])
+  .build()
+
+app.serve({ port: 3000 })
+```
+
+The builder uses phantom types to enforce step ordering — TypeScript will not let you call `.build()` until all four required steps are complete.
+
+On first boot, Mira auto-generates a `jwt_secret`, runs schema migrations, and creates SQL views for view collections. Everything is persisted in the database.
+
+## Builder steps
+
+| Step | Required | Description |
+|---|---|---|
+| `.platform(p)` | Yes | Runtime environment (Node.js, etc.) |
+| `.database(d)` | Yes | Database backend |
+| `.storage(s)` | Yes | File storage backend |
+| `.collections(c)` | Yes | Collection definitions |
+| `.rules(r)` | No | Array of `RuleBinding` from `defineRule(collection, cb)` |
+| `.crons(c)` | No | Array of `CronDef` — scheduled tasks using Effect `Schedule` |
+| `.telemetry(layer)` | No | Custom Effect telemetry layer |
+| `.cors(c)` | No | CORS config. Defaults to permissive (`*`), so a separately-hosted frontend works with zero config |
+| `.extend(plugin)` | No | Register a `MiraPlugin` (lifecycle hooks, routes, crons, layers) |
+
+## Platforms
+
+```typescript
+import { NodePlatform } from "@gettersethya/mira"
+
+// Provides: CryptoService, FileSystem, HttpServerFactory, AuthService
+```
+
+## Databases
+
+```typescript
+import { SqliteDatabase } from "@gettersethya/mira"
+
+SqliteDatabase({ filename: "mira.db" })
+SqliteDatabase({ filename: ":memory:" })  // in-memory for tests
+```
+
+## Storage
+
+```typescript
+import { LocalFileStorage } from "@gettersethya/mira"
+
+LocalFileStorage({ directory: "./uploads" })
+```
+
+## CORS
+
+By default the server is fully permissive (`Access-Control-Allow-Origin: *`), so a frontend hosted on another origin works with zero configuration. `OPTIONS` preflights are answered automatically, and error responses carry CORS headers too.
+
+```typescript
+Mira.builder()
+  // ... required steps
+  .cors({
+    allowedOrigins: ["https://app.example.com"],  // list, or (origin) => boolean predicate
+    credentials: true,                            // requires explicit origins — never combines with "*"
+    // allowedMethods, allowedHeaders, exposedHeaders, maxAge are optional
+  })
+  .build()
+```
+
+`credentials: true` combined with a wildcard origin throws at build time.
+
+## Auto-generated endpoints
+
+Each collection gets a full set of REST endpoints:
+
+| Method | Path | Description |
+|---|---|---|
+| `GET` | `/api/collections/:collection` | List (filter, sort, cursor, expand, select) |
+| `GET` | `/api/collections/:collection/:id` | Get one |
+| `POST` | `/api/collections/:collection` | Create |
+| `PATCH` | `/api/collections/:collection/:id` | Update |
+| `DELETE` | `/api/collections/:collection/:id` | Delete |
+| `POST` | `/api/collections/:collection/auth-with-password` | Login (auth collections only) |
+| `GET` | `/api/auth/me` | Current authenticated record |
+| `POST` | `/api/auth/logout` | Logout |
+| `POST` | `/api/files/token` | Request protected file token |
+| `GET` | `/api/files/:collection/:id/:filename` | Serve file |
+| `GET` | `/api/_schema` | Schema introspection |
+
+## Cron jobs
+
+Register scheduled tasks via the `.crons()` builder step. Each cron uses an Effect `Schedule` to define its recurrence.
+
+```typescript
+import { Schedule } from "effect"
+import { CronService } from "@gettersethya/mira"
+
+const app = Mira.builder()
+  .platform(NodePlatform)
+  .database(SqliteDatabase({ filename: "mira.db" }))
+  .storage(LocalFileStorage({ directory: "./uploads" }))
+  .collections([Users, Posts])
+  .crons([
+    {
+      name: "cleanup",
+      schedule: Schedule.fixed("1 hour"),
+      handler: () => Effect.log("[cron] cleaning up..."),
+    },
+  ])
+  .build()
+  .serve()
+```
+
+Cron names must be globally unique. Use `CronService.getAll()` to inspect state and `CronService.runNow(name)` to trigger immediate execution. Plugins can declare crons via `crons` and hook into `onCronStart`/`onCronExecute`/`onCronSuccess`/`onCronError`/`onCronFinished`.
+
+See the [Mira root README](https://github.com/gettersethya/mira#cron-jobs) for full cron documentation.
+
+## Testing with the service layer
+
+Use `.buildServiceLayer()` to get an Effect `Layer` for all services without starting an HTTP server:
+
+```typescript
+import { Effect, Layer } from "effect"
+
+const serviceLayer = app.buildServiceLayer()
+
+const test = Effect.gen(function* () {
+  // inject and use services directly
+}).pipe(Effect.provide(serviceLayer))
+```
+
+## More
+
+See the [Mira root README](https://github.com/gettersethya/mira) for collection definitions, field types, rules, filter DSL, and client usage.

package/dist/src/app/app.d.ts

@@ -1,8 +1,24 @@
-import { HttpServer } from "@effect/platform";
+import type { AnyCollectionDef } from "@gettersethya/mira-client";
 import { Layer } from "effect";
-import { Migrator } from "../migrator/migrator.js";
 import { AppConfig } from "../config/index.js";
+import { Migrator } from "../migrator/migrator.js";
 import type { MiraAppConfig } from "./builder.js";
+import type { RuleBinding } from "./define-rule.js";
+import type { MiraPlugin } from "./plugin.js";
+export declare function applyRulesToCollections<C extends AnyCollectionDef>(collections: ReadonlyArray<C>, rules: ReadonlyArray<RuleBinding>): Array<C>;
+/**
+ * Options for `MiraApp.serve()` and `MiraApp.buildLayer()`.
+ */
+export interface ServeOptions {
+    /** Port to listen on. Defaults to the port from `AppConfig`. */
+    port?: number;
+    /**
+     * Total number of ports to try when the requested port is already in use.
+     * The server increments the port and retries until a free one is found.
+     * Defaults to 10. Pass `1` to disable retrying.
+     */
+    maxPortAttempts?: number;
+}
 /**
  * The assembled Mira application, ready to serve.
  *
@@ -11,7 +27,7 @@ import type { MiraAppConfig } from "./builder.js";
  *
  * `MiraApp` wires all layers (database, storage, collection service, HTTP server,
  * telemetry, auto-migration) and provides `serve()` to start the server.
- * Use `extend()` to add custom layers before serving.
+ * Use `extend()` to add plugins before serving.
  *
  * @example
  * const app = Mira.builder()
@@ -24,38 +40,40 @@ import type { MiraAppConfig } from "./builder.js";
  * app.serve()
  *
  * @example
- * // With custom layer
- * app.extend(MyCustomLayer).serve({ port: 8080 })
+ * // With plugin
+ * app.extend(MiraDashboard).serve({ port: 8080 })
  *
  * @see MiraBuilder — builds MiraApp
  * @see Mira — entry point: Mira.builder()
  */
-export declare class MiraApp {
+export declare class MiraApp<R = never> {
     #private;
     constructor(config: MiraAppConfig);
     /** @internal for tests only */
     _getConfig(): MiraAppConfig;
     /** @internal for tests only */
-    _getExtras(): ReadonlyArray<Layer.Layer<never, never, never>>;
+    _getExtras(): ReadonlyArray<MiraPlugin<any>>;
+    /** @internal for tests only */
+    _resolveAdminCollections(): ReadonlyArray<AnyCollectionDef>;
     /**
-     * Add an arbitrary Effect Layer to the application's layer composition.
-     * Useful for providing custom services (e.g., custom telemetry, custom auth).
-     * Layers are merged in order of calls to `extend()`.
+     * Add a plugin to the application. Plugins can register lifecycle hooks,
+     * record-lifecycle hooks, custom routes, service layers, and additional
+     * collection definitions.
      *
-     * @param layer - Any Layer<never, never, never>
+     * @param plugin - A MiraPlugin (use `fromLayer()` to wrap a plain Layer)
      * @returns this (for chaining)
      *
      * @example
-     * app.extend(Layer.succeed(MyTag, myImpl))
+     * app.extend(MiraDashboard).serve()
      */
-    extend(layer: Layer.Layer<never, never, never>): this;
+    extend(plugin: MiraPlugin<any>): MiraApp<R>;
     /**
      * Build the full service layer without the HTTP server.
      * Useful for testing — you can run Effects against the service layer without
      * starting a network server.
      *
      * Includes: database, storage, telemetry, repository, migrator, app config,
-     * collection service (with cache), and auto-migration.
+     * collection service (with cache + hooks), and auto-migration.
      *
      * @returns A Layer providing all services
      *
@@ -65,32 +83,33 @@ export declare class MiraApp {
      *   Effect.gen(function* () { ... }).pipe(Effect.provide(serviceLayer))
      * )
      */
-    buildServiceLayer(): Layer.Layer<import("../index.js").FileStorage | import("./types.js").PlatformServices | import("./types.js").DatabaseServices | import("../repository/repository.js").Repository | Migrator | import("../collection-service/collection-service.js").CollectionService | import("../thumbnail/index.js").ThumbnailService | AppConfig, import("effect/ParseResult").ParseError | import("@effect/sql/SqlError").SqlError, never>;
+    buildServiceLayer(): Layer.Layer<import("../index.js").FileStorage | import("./types.js").PlatformServices | import("./types.js").DatabaseServices | import("../repository/repository.js").Repository | import("../index.js").CollectionService | AppConfig | Migrator | import("../cron/cron-service.js").CronService | import("../thumbnail/index.js").ThumbnailService, import("effect/sql/SqlError").SqlError | import("effect/Schema").SchemaError, any>;
     /**
      * Build the complete server layer including the HTTP router and server.
      * Accepts an optional port override (otherwise uses the port from AppConfig).
      *
-     * @param options.port - Optional port number override
+     * @param options - Optional serve options (`port`, `maxPortAttempts`)
      * @returns A Layer ready to be launched
      *
      * @internal Called by serve() — most users should use serve() directly.
      */
-    buildLayer(options?: {
-        port?: number;
-    }): Layer.Layer<HttpServer.HttpServer | import("@effect/platform/HttpPlatform").HttpPlatform | import("@effect/platform/Etag").Generator | import("../index.js").FileStorage | import("./types.js").PlatformServices | import("./types.js").DatabaseServices | import("../repository/repository.js").Repository | Migrator | import("../collection-service/collection-service.js").CollectionService | import("../thumbnail/index.js").ThumbnailService | AppConfig, import("effect/ParseResult").ParseError | import("@effect/platform/HttpServerError").ServeError | import("@effect/sql/SqlError").SqlError, never>;
+    buildLayer(options?: ServeOptions): Layer.Layer<import("../index.js").FileStorage | import("./types.js").PlatformServices | import("./types.js").DatabaseServices | import("../repository/repository.js").Repository | import("../index.js").CollectionService | AppConfig | Migrator | import("../cron/cron-service.js").CronService | import("../thumbnail/index.js").ThumbnailService, import("effect/http/HttpServerError").ServeError | import("effect/sql/SqlError").SqlError | import("effect/Schema").SchemaError, any>;
     /**
      * Start the Mira HTTP server.
-     * Sets up all services, runs auto-migration, and listens for incoming requests.
+     * Sets up all services, runs auto-migration, runs plugin lifecycle hooks,
+     * and listens for incoming requests.
      * Blocks the main thread until the server is shut down.
      *
-     * @param options.port - Optional port override (default: from AppConfig, typically 8080)
+     * If the requested port is already in use, the server automatically retries
+     * on the next available port (up to `maxPortAttempts`, default 10).
+     *
+     * @param options - Optional serve options (`port`, `maxPortAttempts`)
      *
      * @example
-     * app.serve()              // default port
-     * app.serve({ port: 8080 }) // port override
+     * app.serve()                       // default port, auto-increment if busy
+     * app.serve({ port: 8080 })         // explicit port, auto-increment if busy
+     * app.serve({ port: 8080, maxPortAttempts: 1 }) // fail instead of incrementing
      */
-    serve(options?: {
-        port?: number;
-    }): void;
+    serve(options?: ServeOptions): void;
 }
 //# sourceMappingURL=app.d.ts.map

package/dist/src/app/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/app/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AAEtC,OAAO,EAAE,QAAQ,EAAgB,MAAM,wBAAwB,CAAA;AAM/D,OAAO,EAAE,SAAS,EAAiB,MAAM,mBAAmB,CAAA;AAG5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,OAAO;;gBAIN,MAAM,EAAE,aAAa;IAKjC,+BAA+B;IAC/B,UAAU,IAAI,aAAa;IAI3B,+BAA+B;IAC/B,UAAU,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAI7D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI;IAKrD;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB;IAsCjB;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAoBtC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAKzC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/app/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAEjE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AAItC,OAAO,EAAE,SAAS,EAAiB,MAAM,mBAAmB,CAAA;AAW5D,OAAO,EAAE,QAAQ,EAAgB,MAAM,wBAAwB,CAAA;AAK/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAY7C,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,gBAAgB,EAChE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,EAC7B,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAChC,KAAK,CAAC,CAAC,CAAC,CAkBV;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,KAAK;;gBAGhB,MAAM,EAAE,aAAa;IAKjC,+BAA+B;IAC/B,UAAU,IAAI,aAAa;IAI3B,+BAA+B;IAC/B,UAAU,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAI5C,+BAA+B;IAC/B,wBAAwB,IAAI,aAAa,CAAC,gBAAgB,CAAC;IAI3D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiC3C;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB;IAsDjB;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,YAAY;IAyBjC;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;CAqBpC"}

package/dist/src/app/app.js

@@ -1,13 +1,45 @@
-import { HttpServer } from "@effect/platform";
 import { Effect, Layer } from "effect";
-import { RepositoryLive } from "../repository/repository.js";
-import { Migrator, MigratorLive } from "../migrator/migrator.js";
+import { HttpRouter } from "effect/http";
 import { makeCachedCollectionServiceLayer } from "../cache/index.js";
-import { makeCollectionRouter } from "../http/router.js";
-import { ThumbnailServicePhotonLive } from "../thumbnail/index.js";
-import { ipAnnotationMiddleware } from "../http/ip-middleware.js";
 import { AppConfig, AppConfigLive } from "../config/index.js";
+import { makeCronServiceLayer } from "../cron/cron-service.js";
+import { makeHookCollectionServiceLayer } from "../hooks/hook-collection.js";
+import { makeHookServiceLayer } from "../hooks/hook-service.js";
+import { HookService } from "../hooks/hook-service.js";
+import { defaultCorsConfig, makeCorsMiddleware } from "../http/cors.js";
+import { ipAnnotationMiddleware } from "../http/ip-middleware.js";
+import { makePortRetryServerLayer } from "../http/port-retry.js";
+import { makeCollectionRouter } from "../http/router.js";
 import { HttpServerFactory } from "../http/server-factory.js";
+import { Migrator, MigratorLive } from "../migrator/migrator.js";
+import { RepositoryLive } from "../repository/repository.js";
+import { ThumbnailServicePhotonLive } from "../thumbnail/index.js";
+function assertUniqueCronNames(defs) {
+    const seen = new Set();
+    for (const def of defs) {
+        if (seen.has(def.name)) {
+            throw new Error(`Duplicate cron name: "${def.name}". Cron names must be globally unique.`);
+        }
+        seen.add(def.name);
+    }
+}
+export function applyRulesToCollections(collections, rules) {
+    const collectionNames = new Set(collections.map((c) => c.name));
+    for (const rb of rules) {
+        if (!collectionNames.has(rb.collectionName)) {
+            throw new Error(`RuleBinding references unknown collection "${rb.collectionName}". ` +
+                `Available collections: ${[...collectionNames].join(", ")}.`);
+        }
+    }
+    const ruleMap = new Map(rules.map((r) => [r.collectionName, r.ruleMap]));
+    return collections.map((c) => {
+        const rm = ruleMap.get(c.name);
+        if (rm) {
+            return { ...c, schema: { ...c.schema, "x-rules": rm } };
+        }
+        return c;
+    });
+}
 /**
  * The assembled Mira application, ready to serve.
  *
@@ -16,7 +48,7 @@ import { HttpServerFactory } from "../http/server-factory.js";
  *
  * `MiraApp` wires all layers (database, storage, collection service, HTTP server,
  * telemetry, auto-migration) and provides `serve()` to start the server.
- * Use `extend()` to add custom layers before serving.
+ * Use `extend()` to add plugins before serving.
  *
  * @example
  * const app = Mira.builder()
@@ -29,8 +61,8 @@ import { HttpServerFactory } from "../http/server-factory.js";
  * app.serve()
  *
  * @example
- * // With custom layer
- * app.extend(MyCustomLayer).serve({ port: 8080 })
+ * // With plugin
+ * app.extend(MiraDashboard).serve({ port: 8080 })
  *
  * @see MiraBuilder — builds MiraApp
  * @see Mira — entry point: Mira.builder()
@@ -50,28 +82,56 @@ export class MiraApp {
     _getExtras() {
         return this.#extras;
     }
+    /** @internal for tests only */
+    _resolveAdminCollections() {
+        return this.#getAdminCollections();
+    }
     /**
-     * Add an arbitrary Effect Layer to the application's layer composition.
-     * Useful for providing custom services (e.g., custom telemetry, custom auth).
-     * Layers are merged in order of calls to `extend()`.
+     * Add a plugin to the application. Plugins can register lifecycle hooks,
+     * record-lifecycle hooks, custom routes, service layers, and additional
+     * collection definitions.
      *
-     * @param layer - Any Layer<never, never, never>
+     * @param plugin - A MiraPlugin (use `fromLayer()` to wrap a plain Layer)
      * @returns this (for chaining)
      *
      * @example
-     * app.extend(Layer.succeed(MyTag, myImpl))
+     * app.extend(MiraDashboard).serve()
      */
-    extend(layer) {
-        this.#extras.push(layer);
+    extend(plugin) {
+        this.#extras.push(plugin);
         return this;
     }
+    #getAllCollections() {
+        const configCollections = applyRulesToCollections(this.#config.collections, this.#config.rules ?? []);
+        const all = [
+            ...configCollections,
+            ...this.#extras.flatMap((p) => p.collections ?? []),
+            ...this.#getAdminCollections()
+        ];
+        const byName = new Map();
+        for (const c of all) {
+            if (!byName.has(c.name)) {
+                byName.set(c.name, c);
+            }
+        }
+        return [...byName.values()];
+    }
+    #getAllPlugins() {
+        return this.#extras;
+    }
+    #getAllCrons() {
+        return [...this.#config.crons, ...this.#extras.flatMap((p) => p.crons ?? [])];
+    }
+    #getAdminCollections() {
+        return this.#extras.flatMap((p) => p.adminCollections ?? []);
+    }
     /**
      * Build the full service layer without the HTTP server.
      * Useful for testing — you can run Effects against the service layer without
      * starting a network server.
      *
      * Includes: database, storage, telemetry, repository, migrator, app config,
-     * collection service (with cache), and auto-migration.
+     * collection service (with cache + hooks), and auto-migration.
      *
      * @returns A Layer providing all services
      *
@@ -82,58 +142,95 @@ export class MiraApp {
      * )
      */
     buildServiceLayer() {
-        const { platform, database, storage, collections, telemetry } = this.#config;
-        const collectionList = collections;
-        const extrasLayer = this.#extras.length > 0
-            ? this.#extras.reduce((acc, l) => Layer.merge(acc, l))
-            : Layer.empty;
-        // Foundation: database + storage + thumbnail + telemetry + extras, wired on platform
-        const foundation = Layer.mergeAll(database.layer, storage.layer, ThumbnailServicePhotonLive, telemetry, extrasLayer).pipe(Layer.provideMerge(platform.layer));
+        const { database, platform, storage, telemetry } = this.#config;
+        const allCollections = this.#getAllCollections();
+        const allPlugins = this.#getAllPlugins();
+        const allCronDefs = this.#getAllCrons();
+        assertUniqueCronNames(allCronDefs);
+        const pluginLayers = allPlugins.filter((p) => p.layer !== undefined).map((p) => p.layer);
+        const extrasLayer = pluginLayers.length > 0 ? pluginLayers.reduce((acc, l) => Layer.merge(acc, l)) : Layer.empty;
+        // Foundation: database + storage + thumbnail + telemetry, wired on platform
+        const foundation = Layer.mergeAll(database.layer, storage.layer, ThumbnailServicePhotonLive, telemetry).pipe(Layer.provideMerge(platform.layer));
         // Mid: Repository + Migrator + AppConfig, wired on foundation
         const mid = Layer.mergeAll(RepositoryLive, MigratorLive, AppConfigLive).pipe(Layer.provideMerge(foundation));
+        // Extras: plugin layers run after mid so they can depend on AppConfig + platform services
+        const extrasProvided = extrasLayer.pipe(Layer.provide(mid));
+        const fullMid = Layer.merge(mid, extrasProvided);
         // Auto-migrate on boot: runs during layer initialization before requests are served
-        const schemas = collectionList.map((c) => ({ name: c.name, schema: c.schema }));
+        const schemas = allCollections.map((c) => ({ name: c.name, schema: c.schema }));
         const autoMigrateLayer = Layer.effectDiscard(Effect.gen(function* () {
             const migrator = yield* Migrator;
             yield* migrator.migrate(schemas);
-        }).pipe(Effect.orDie)).pipe(Layer.provide(mid));
-        // Top: CollectionService + all mid services + auto-migration side effect
-        return makeCachedCollectionServiceLayer(collectionList).pipe(Layer.provideMerge(Layer.merge(mid, autoMigrateLayer)));
+        }).pipe(Effect.orDie)).pipe(Layer.provide(fullMid));
+        // Core collection service (cached)
+        const cachedCollectionLayer = makeCachedCollectionServiceLayer(allCollections);
+        // Hook service layer (collects all plugin hooks)
+        const hookServiceLayer = makeHookServiceLayer(allPlugins);
+        // Hook collection service decorator: wraps cached collection service with hooks
+        const hookCollectionLayer = makeHookCollectionServiceLayer().pipe(Layer.provide(Layer.mergeAll(cachedCollectionLayer, hookServiceLayer)));
+        // Full top layer: hook-wrapped collection service + all mid services + auto-migration side effect
+        const topLayer = hookCollectionLayer.pipe(Layer.provideMerge(Layer.merge(fullMid, autoMigrateLayer)));
+        // Cron service: scoped fibers die when server stops; provided with full service stack + hook service
+        const cronServiceLayer = makeCronServiceLayer(allCronDefs).pipe(Layer.provide(Layer.mergeAll(topLayer, hookServiceLayer)));
+        return Layer.merge(topLayer, cronServiceLayer);
     }
     /**
      * Build the complete server layer including the HTTP router and server.
      * Accepts an optional port override (otherwise uses the port from AppConfig).
      *
-     * @param options.port - Optional port number override
+     * @param options - Optional serve options (`port`, `maxPortAttempts`)
      * @returns A Layer ready to be launched
      *
      * @internal Called by serve() — most users should use serve() directly.
      */
     buildLayer(options) {
-        const { collections } = this.#config;
-        const collectionList = collections;
-        const router = makeCollectionRouter(collectionList);
+        const allCollections = this.#getAllCollections();
+        const adminCollections = this.#getAdminCollections().map((c) => c.name);
+        const collectionRoutes = makeCollectionRouter(allCollections, adminCollections);
+        const pluginRoutes = this.#extras.flatMap((p) => p.routes ?? []);
+        const routes = [...collectionRoutes, ...pluginRoutes];
         const serviceLayer = this.buildServiceLayer();
-        const serverLayer = Layer.unwrapEffect(Effect.gen(function* () {
+        const serverLayer = Layer.unwrap(Effect.gen(function* () {
             const cfg = yield* AppConfig;
             const factory = yield* HttpServerFactory;
-            return factory.makeLayer(options?.port ?? cfg.port);
-        }));
-        return HttpServer.serve(ipAnnotationMiddleware(router)).pipe(Layer.provideMerge(serverLayer), Layer.provideMerge(serviceLayer));
+            const effectivePort = options?.port ?? cfg.port;
+            return makePortRetryServerLayer(factory, effectivePort, options?.maxPortAttempts, (boundPort) => cfg.updateBoundPort?.(boundPort));
+        })).pipe(Layer.provide(serviceLayer));
+        return HttpRouter.serve(HttpRouter.addAll(routes), {
+            middleware: (effect) => ipAnnotationMiddleware(makeCorsMiddleware(this.#config.cors)(effect))
+        }).pipe(Layer.provide(serverLayer), Layer.provideMerge(serviceLayer));
     }
     /**
      * Start the Mira HTTP server.
-     * Sets up all services, runs auto-migration, and listens for incoming requests.
+     * Sets up all services, runs auto-migration, runs plugin lifecycle hooks,
+     * and listens for incoming requests.
      * Blocks the main thread until the server is shut down.
      *
-     * @param options.port - Optional port override (default: from AppConfig, typically 8080)
+     * If the requested port is already in use, the server automatically retries
+     * on the next available port (up to `maxPortAttempts`, default 10).
+     *
+     * @param options - Optional serve options (`port`, `maxPortAttempts`)
      *
      * @example
-     * app.serve()              // default port
-     * app.serve({ port: 8080 }) // port override
+     * app.serve()                       // default port, auto-increment if busy
+     * app.serve({ port: 8080 })         // explicit port, auto-increment if busy
+     * app.serve({ port: 8080, maxPortAttempts: 1 }) // fail instead of incrementing
      */
     serve(options) {
-        this.#config.platform.runMain(Layer.launch(this.buildLayer(options)).pipe(Effect.orDie));
+        const allPlugins = this.#getAllPlugins();
+        const hookServiceLayer = makeHookServiceLayer(allPlugins);
+        const fullLayer = this.buildLayer(options);
+        const usingDefaultCors = this.#config.cors === defaultCorsConfig;
+        this.#config.platform.runMain(Effect.gen(function* () {
+            if (usingDefaultCors) {
+                yield* Effect.logWarning("CORS: using the permissive default — every Origin is reflected and credentials are allowed. " +
+                    "Configure Mira.builder().cors({ allowedOrigins, credentials }) for production.");
+            }
+            const hookService = yield* HookService.pipe(Effect.provide(hookServiceLayer));
+            const bootstrapLayer = Layer.effectDiscard(hookService.runBootstrap());
+            yield* Layer.launch(bootstrapLayer.pipe(Layer.provideMerge(fullLayer)));
+            yield* hookService.runServe();
+        }));
     }
 }
 //# sourceMappingURL=app.js.map

package/dist/src/app/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/app/app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/app/app.ts"],"names":[],"mappings":"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"}