neoorm 0.8.8 → 0.8.9

package/dist/studio-ui/index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>NeoOrm Studio</title>
-    <script type="module" crossorigin src="./assets/index-Leicgvwr.js"></script>
+    <script type="module" crossorigin src="./assets/index-ByHGD2Z0.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-wQS4sFQ_.css">
   </head>
   <body>

package/docs/cli.md

@@ -34,7 +34,7 @@ Options:
 
 ## `neoorm migrate dev`
 
-Apply pending migrations, then generate a new migration if the schema changed.
+Apply pending migrations, then generate a new migration if the schema changed. If a pending `CREATE TABLE` targets a relation that already exists, catch the live database up to `schema.ts` and record those files as applied instead of re-running the create.
 
 ```
 neoorm migrate dev
@@ -42,7 +42,7 @@ neoorm migrate dev
 
 ## `neoorm migrate deploy`
 
-Apply all pending migrations.
+Apply all pending migrations. Throws `migration_drift` if a pending `CREATE TABLE` would hit an existing relation.
 
 ```
 neoorm migrate deploy
@@ -113,6 +113,7 @@ Options:
 - `--read-only` — block row mutations and non-read SQL
 - `--verbose` — log SQL statements executed by Studio
 - `--token <token>` — require this token for API access (generated automatically when binding a non-loopback host)
+- `--er-layout <path>` — enable team-shared ER layout stored at `<path>` (e.g. `./neoorm.er-layout.json`); `PUT` is blocked under `--read-only`
 
 See [Studio](studio.md) for features, keyboard shortcuts, and security notes.
 

package/docs/migrations.md

@@ -6,8 +6,8 @@
 |---------|-------------|
 | `neoorm init` | Scaffold `neoorm.config.ts`, `schema.ts`, `.env.example` only (no codegen or migrations; run `neoorm migrate dev` after) |
 | `neoorm generate` | Emit manifest, typed client, models, includes, and migrations |
-| `neoorm migrate dev` | Apply pending migrations, then generate a new one if the schema changed |
-| `neoorm migrate deploy` | Apply pending migrations |
+| `neoorm migrate dev` | Apply pending migrations (or record colliding CREATE TABLE files against the live schema), then generate a new one if `schema.ts` changed |
+| `neoorm migrate deploy` | Apply pending migrations (throws `migration_drift` if a pending `CREATE TABLE` targets a relation that already exists) |
 | `neoorm migrate status` | List applied vs pending migrations |
 | `neoorm migrate down [--steps N]` | Roll back the last N applied migrations (default 1) |
 | `neoorm migrate reset --force` | Drop the `public` schema (PostgreSQL) or all tables (SQLite / MySQL / MariaDB) and re-apply migrations (local dev) |
@@ -31,6 +31,12 @@ When migration is blocked, the CLI explains why — for example unsupported type
 neoorm generate --accept-data-loss
 ```
 
+## Existing tables vs pending CREATE TABLE
+
+`generate` diffs `snapshot.json`. If that file is missing, the first migration is a full `CREATE TABLE` script. `migrate deploy` will not run that SQL when those relations already exist (for example after `db push`). It throws `migration_drift` before any user statement.
+
+`neoorm migrate dev` detects the same collision, diffs the live database to `schema.ts`, applies that catch-up SQL (often none, sometimes `ALTER`), records the pending files in `_neoorm_migrations` using the on-disk checksums, and writes `snapshot.json`. Destructive catch-up still requires `--accept-data-loss`. Empty databases still run `CREATE TABLE` as before.
+
 ## Deploy locking and checksums
 
 `neoorm migrate deploy` serializes concurrent runs and records a SHA-256 checksum of each applied `migration.sql`:

package/docs/studio.md

@@ -31,7 +31,8 @@ Build `findMany`, `findFirst`, `findUnique`, `findById`, `count`, `exists`, `agg
 ## Schema, ER, migrate
 
 - Schema explorer: columns, kinds, constraints, indexes (including partial `WHERE`), foreign keys, and relations per table. Read-only — schema changes belong in `schema.ts` plus `migrate dev`.
-- ER graph: tables as nodes, `1:1` / `1:n` / `n:n` edges, junction tables hidden by default. Click a node to open its data.
+- ER graph: tables as nodes, `1:1` / `1:n` / `n:n` edges, junction tables hidden by default. Click a node to open its data. Drag tables to rearrange — positions, the junction toggle, and the viewport (pan/zoom) persist in `localStorage` per schema. `Reset layout` restores the auto-grid; `Export`/`Import JSON` moves a layout between browsers.
+- Team-shared ER layout (opt-in): restart Studio with `neoorm studio --er-layout ./neoorm.er-layout.json`, switch Scope to `Team`, then `Push to team` / `Pull from team`. The file is committable so the whole team sees the same arrangement. Without the flag the server answers `404` and local layout still works.
 - Migrate status: applied, pending, and orphan migrations. Studio never applies, resets, or rolls back migrations — use the CLI.
 
 ## Keyboard

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "neoorm",
-	"version": "0.8.8",
+	"version": "0.8.9",
 	"description": "TypeScript-first PostgreSQL, SQLite, MySQL, and MariaDB ORM with schema DSL, codegen, and typed relations",
 	"license": "MIT",
 	"repository": {