@prisma-next/family-mongo 0.3.0-dev.164 → 0.4.0-dev.1

package/README.md

@@ -21,6 +21,7 @@ This package is the Mongo family integration point for both control-plane assemb
 ## Entrypoints
 
 - `./control`: control-plane entrypoint exporting `mongoFamilyDescriptor`, `mongoTargetDescriptor`, `createMongoFamilyInstance`, and `MongoControlFamilyInstance`
+- `./migration`: migration authoring — `Migration` class, factory functions, and strategies (re-exported from `@prisma-next/target-mongo/migration`)
 - `./pack`: pure pack ref for TypeScript authoring flows such as `@prisma-next/mongo-contract-ts/contract-builder`
 
 ## Usage
@@ -95,18 +96,49 @@ export const contract = defineContract({
 
 The current `contract.ts` slice supports roots and collections, typed reference relations, owned models with `storage.relations`, value objects, and discriminator-based polymorphism.
 
+### Migration authoring
+
+```typescript
+import { Migration, createIndex, createCollection }
+  from "@prisma-next/family-mongo/migration"
+
+export default class extends Migration {
+  describe() {
+    return { from: "abc123", to: "def456", labels: ["add-users"] }
+  }
+
+  plan() {
+    return [
+      createCollection("users", {
+        validator: { $jsonSchema: { required: ["email"] } },
+        validationLevel: "strict",
+      }),
+      createIndex("users", [{ field: "email", direction: 1 }], { unique: true }),
+    ]
+  }
+}
+
+Migration.run(import.meta.url)
+```
+
+Run `node migration.ts` to produce `ops.json` and `migration.json`. Use `--dry-run` to preview without writing.
+
 ## Package Structure
 
 - `src/core/control-descriptor.ts`: `MongoFamilyDescriptor` implementation
 - `src/core/control-instance.ts`: `createMongoFamilyInstance()` and `MongoControlFamilyInstance`
 - `src/core/mongo-target-descriptor.ts`: pre-built control target descriptor derived from `@prisma-next/target-mongo/pack`
+- `src/core/mongo-migration.ts`: `MongoMigration` class (fixes the `Migration<TOperation>` type parameter to `MongoMigrationPlanOperation`)
 - `src/exports/control.ts`: control-plane entrypoint
+- `src/exports/migration.ts`: migration authoring entrypoint
 - `src/exports/pack.ts`: authoring-time family pack ref
 
 ## Dependencies
 
 - `@prisma-next/framework-components`: control-plane types and stack assembly
+- `@prisma-next/migration-tools`: generic `Migration<TOperation>` base class
 - `@prisma-next/mongo-contract`: Mongo contract validation and types
 - `@prisma-next/mongo-contract-ts`: Mongo `contract.ts` authoring surface
 - `@prisma-next/mongo-emitter`: Mongo family emission hook
-- `@prisma-next/target-mongo`: Mongo target pack metadata
+- `@prisma-next/mongo-query-ast`: Mongo command AST types (`MongoMigrationPlanOperation`)
+- `@prisma-next/target-mongo`: Mongo target pack metadata and migration factories

package/dist/migration.d.mts

@@ -0,0 +1,8 @@
+import { Migration } from "@prisma-next/migration-tools/migration";
+import { MongoMigrationPlanOperation } from "@prisma-next/mongo-query-ast/control";
+
+//#region src/core/mongo-migration.d.ts
+declare abstract class MongoMigration extends Migration<MongoMigrationPlanOperation> {}
+//#endregion
+export { MongoMigration as Migration };
+//# sourceMappingURL=migration.d.mts.map

package/dist/migration.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.mts","names":[],"sources":["../src/core/mongo-migration.ts"],"sourcesContent":[],"mappings":";;;;uBAGsB,cAAA,SAAuB,UAAU"}

package/dist/migration.mjs

@@ -0,0 +1,8 @@
+import { Migration } from "@prisma-next/migration-tools/migration";
+
+//#region src/core/mongo-migration.ts
+var MongoMigration = class extends Migration {};
+
+//#endregion
+export { MongoMigration as Migration };
+//# sourceMappingURL=migration.mjs.map

package/dist/migration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.mjs","names":[],"sources":["../src/core/mongo-migration.ts"],"sourcesContent":["import { Migration } from '@prisma-next/migration-tools/migration';\nimport type { MongoMigrationPlanOperation } from '@prisma-next/mongo-query-ast/control';\n\nexport abstract class MongoMigration extends Migration<MongoMigrationPlanOperation> {}\n"],"mappings":";;;AAGA,IAAsB,iBAAtB,cAA6C,UAAuC"}

package/package.json

@@ -1,28 +1,30 @@
 {
   "name": "@prisma-next/family-mongo",
-  "version": "0.3.0-dev.164",
+  "version": "0.4.0-dev.1",
   "type": "module",
   "sideEffects": false,
   "description": "Mongo family descriptor for Prisma Next",
   "dependencies": {
     "mongodb": "^6.16.0",
-    "@prisma-next/adapter-mongo": "0.3.0-dev.164",
-    "@prisma-next/contract": "0.3.0-dev.164",
-    "@prisma-next/emitter": "0.3.0-dev.164",
-    "@prisma-next/framework-components": "0.3.0-dev.164",
-    "@prisma-next/mongo-contract": "0.3.0-dev.164",
-    "@prisma-next/mongo-emitter": "0.3.0-dev.164",
-    "@prisma-next/mongo-schema-ir": "0.3.0-dev.164",
-    "@prisma-next/target-mongo": "0.3.0-dev.164",
-    "@prisma-next/utils": "0.3.0-dev.164"
+    "@prisma-next/adapter-mongo": "0.4.0-dev.1",
+    "@prisma-next/framework-components": "0.4.0-dev.1",
+    "@prisma-next/contract": "0.4.0-dev.1",
+    "@prisma-next/emitter": "0.4.0-dev.1",
+    "@prisma-next/mongo-contract": "0.4.0-dev.1",
+    "@prisma-next/mongo-emitter": "0.4.0-dev.1",
+    "@prisma-next/migration-tools": "0.4.0-dev.1",
+    "@prisma-next/mongo-schema-ir": "0.4.0-dev.1",
+    "@prisma-next/target-mongo": "0.4.0-dev.1",
+    "@prisma-next/utils": "0.4.0-dev.1",
+    "@prisma-next/mongo-query-ast": "0.4.0-dev.1"
   },
   "devDependencies": {
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
     "@prisma-next/tsconfig": "0.0.0",
-    "@prisma-next/tsdown": "0.0.0",
-    "@prisma-next/mongo-contract-ts": "0.3.0-dev.164"
+    "@prisma-next/mongo-contract-ts": "0.4.0-dev.1",
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",
@@ -38,6 +40,7 @@
   "types": "./dist/control.d.mts",
   "exports": {
     "./control": "./dist/control.mjs",
+    "./migration": "./dist/migration.mjs",
     "./pack": "./dist/pack.mjs",
     "./package.json": "./package.json"
   },

package/src/core/mongo-migration.ts

@@ -0,0 +1,4 @@
+import { Migration } from '@prisma-next/migration-tools/migration';
+import type { MongoMigrationPlanOperation } from '@prisma-next/mongo-query-ast/control';
+
+export abstract class MongoMigration extends Migration<MongoMigrationPlanOperation> {}

package/src/exports/migration.ts

@@ -0,0 +1 @@
+export { MongoMigration as Migration } from '../core/mongo-migration';