@prisma-next/extension-paradedb 0.12.0-dev.5 → 0.12.0-dev.51

package/README.md

@@ -73,16 +73,9 @@ ParadeDB BM25 indexes require a `key_field` — a unique column that identifies
 
 ## Authoring (maintainers)
 
-The extension's contract + baseline migration are emitted on-disk inside this package using the same pipeline application authors use:
+After changing the contract source, run `pnpm migrations:regen` from the repo root to keep migration metadata, `refs/head.json`, and `end-contract.*` consistent with the freshly-built `src/contract.json`; it is also wired into `pnpm fixtures:emit` automatically.
 
-- `pnpm build:contract-space` — runs `prisma-next contract emit` to produce `src/contract.{json,d.ts}` from `emptyContract({ output: 'src/contract.json', target })` in `prisma-next.config.ts` (migrations-only space: no `contract.prisma` source file).
-- `pnpm exec prisma-next migration plan --name <slug>` (run from this package directory) — scaffolds a new migration directory under `migrations/<dirName>/` for schema changes. **Not chained into `pnpm build`**: `migration plan` is non-idempotent (each invocation generates a new timestamped directory), so it runs manually when the contract changes. Note: paradedb's contract declares no tables or models, so the planner currently refuses to scaffold the baseline migration (this is **Path B** authoring per [ADR 212](../../../docs/architecture%20docs/adrs/ADR%20212%20-%20Contract%20spaces.md#contract-space-package-layout)). That directory was hand-authored once (Migration subclass + seed `migration.json` preserving the full `toContract`) and `pnpm tsx migrations/<dirName>/migration.ts` re-emits `ops.json` + `migration.json` deterministically. Future migrations that add tables or models can use `migration plan` directly (Path A).
-- `pnpm tsx migrations/<dirName>/migration.ts` (run from this package directory) — re-emits `ops.json` + `migration.json` from the hand-edited subclass. Use `tsx`, not bare `node`, because the Migration subclass imports relative TypeScript siblings which Node's native loader can't resolve without a TS-aware loader.
-- `migrations/refs/head.json` is hand-pinned with the latest migration's `to` hash + `providedInvariants`.
-
-The descriptor at `src/exports/control.ts` then JSON-imports those artefacts and synthesises the framework's `MigrationPackage` shape.
-
-See [ADR 212 — Contract spaces](../../../docs/architecture%20docs/adrs/ADR%20212%20-%20Contract%20spaces.md) ("Contract-space package layout") for the canonical layout and rationale.
+See [ADR 212 — Contract spaces](../../../docs/architecture%20docs/adrs/ADR%20212%20-%20Contract%20spaces.md) ("Contract-space package layout") for the layout and rationale.
 
 ## Not yet implemented
 

package/dist/control.mjs

@@ -11,12 +11,19 @@ const paradedbContractSpace = contractSpaceFromJson({
 		roots: {},
 		domain: { "namespaces": { "public": { "models": {} } } },
 		storage: {
-			"namespaces": { "public": {
-				"id": "public",
-				"kind": "postgres-schema",
-				"tables": {}
-			} },
-			"storageHash": "sha256:5dde71f8985299c9eb464edb00d06e2bdef0501bd30b072a614afb48ed4dc21b"
+			"namespaces": {
+				"__unbound__": {
+					"entries": { "table": {} },
+					"id": "__unbound__",
+					"kind": "postgres-unbound-schema"
+				},
+				"public": {
+					"entries": { "table": {} },
+					"id": "public",
+					"kind": "postgres-schema"
+				}
+			},
+			"storageHash": "sha256:6214fc543ea5ffa1c5bdf6f663e62c61b6a3f04460e1e27bf7f47f1544f11603"
 		},
 		capabilities: {
 			"postgres": {
@@ -46,10 +53,10 @@ const paradedbContractSpace = contractSpaceFromJson({
 		dirName: "20260601T0000_install_pg_search_extension",
 		metadata: {
 			from: null,
-			to: "sha256:5dde71f8985299c9eb464edb00d06e2bdef0501bd30b072a614afb48ed4dc21b",
+			to: "sha256:6214fc543ea5ffa1c5bdf6f663e62c61b6a3f04460e1e27bf7f47f1544f11603",
 			providedInvariants: ["paradedb:install-pg-search-v1"],
 			createdAt: "2026-06-01T00:00:00.000Z",
-			migrationHash: "sha256:9e41d989a1c9715d67ced43dd0ee4210b06641a6fd78a124b77798d27272e704"
+			migrationHash: "sha256:71fba51945d5d0d8f6a7e2e7e6a58d1c90d789d4affe348c195db586f088d971"
 		},
 		ops: [{
 			"id": "paradedb.install-pg-search-extension",
@@ -79,7 +86,7 @@ const paradedbContractSpace = contractSpaceFromJson({
 		}]
 	}],
 	headRef: {
-		hash: "sha256:5dde71f8985299c9eb464edb00d06e2bdef0501bd30b072a614afb48ed4dc21b",
+		hash: "sha256:6214fc543ea5ffa1c5bdf6f663e62c61b6a3f04460e1e27bf7f47f1544f11603",
 		invariants: ["paradedb:install-pg-search-v1"]
 	}
 });

package/dist/control.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"control.mjs","names":["baselineMetadata","baselineOps"],"sources":["../migrations/20260601T0000_install_pg_search_extension/migration.json","../migrations/20260601T0000_install_pg_search_extension/ops.json","../migrations/refs/head.json","../src/contract.json","../src/exports/control.ts"],"sourcesContent":["","","","","/**\n * Control-plane descriptor for the paradedb extension.\n *\n * **Contract-space package layout.** The extension's contract\n * + migrations are emitted by the same pipeline application authors use:\n *\n *   `prisma-next contract emit` → `<package>/src/contract.{json,d.ts}`\n *   `prisma-next migration plan` → `<package>/migrations/<dir>/...`\n *\n * The descriptor wires those JSON artefacts via JSON-import declarations\n * so they flow through the consuming application's module resolver\n * without filesystem assumptions, and synthesises the canonical\n * {@link import('@prisma-next/framework-components/control').MigrationPackage}\n * shape for the framework's runner / verifier to consume. Readers in\n * `@prisma-next/migration-tools` add `dirPath` when loading from disk\n * (`OnDiskMigrationPackage`); descriptor-bundled packages do not need\n * it because the framework reads them directly from the descriptor.\n *\n * Wired surfaces:\n *\n *   - `contractSpace.{contractJson,migrations,headRef}` — sourced from\n *     the on-disk artefacts emitted by `build:contract-space`.\n *   - `queryOperations` — BM25 full-text search operations registered\n *     via `paradedbQueryOperations()`.\n *\n * @see docs/architecture docs/adrs/ADR 212 - Contract spaces.md\n *   (contract-space package layout convention).\n */\n\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { SqlControlExtensionDescriptor } from '@prisma-next/family-sql/control';\nimport { contractSpaceFromJson } from '@prisma-next/migration-tools/spaces';\nimport type { SqlStorage } from '@prisma-next/sql-contract/types';\nimport baselineMetadata from '../../migrations/20260601T0000_install_pg_search_extension/migration.json' with {\n  type: 'json',\n};\nimport baselineOps from '../../migrations/20260601T0000_install_pg_search_extension/ops.json' with {\n  type: 'json',\n};\nimport headRef from '../../migrations/refs/head.json' with { type: 'json' };\nimport contractJson from '../contract.json' with { type: 'json' };\nimport { PARADEDB_SPACE_ID } from '../core/constants';\nimport { paradedbPackMeta, paradedbQueryOperations } from '../core/descriptor-meta';\n\nconst BASELINE_DIR_NAME = '20260601T0000_install_pg_search_extension';\n\nconst paradedbContractSpace = contractSpaceFromJson<Contract<SqlStorage>>({\n  contractJson,\n  migrations: [\n    {\n      dirName: BASELINE_DIR_NAME,\n      metadata: baselineMetadata,\n      ops: baselineOps,\n    },\n  ],\n  headRef,\n});\n\nconst paradedbExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'> = {\n  ...paradedbPackMeta,\n  id: PARADEDB_SPACE_ID,\n  contractSpace: paradedbContractSpace,\n  queryOperations: () => paradedbQueryOperations(),\n  create: () => ({\n    familyId: 'sql' as const,\n    targetId: 'postgres' as const,\n  }),\n};\n\nexport { paradedbExtensionDescriptor, paradedbPackMeta };\nexport default paradedbExtensionDescriptor;\n"],"mappings":";;;;AI8CA,MAAM,wBAAwB,sBAA4C;CACxE,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAA;CACA,YAAY,CACV;EACE,SAAS;EACT,UAAUA;;;;;;EAAAA;EACV,KAAKC;;;;;;;;;;;;;;;;;;;;;;;;;GAAAA;CACP,CACF;CACA,SAAA;;;CAAA;AACF,CAAC;AAED,MAAM,8BAAyE;CAC7E,GAAG;CACH,IAAI;CACJ,eAAe;CACf,uBAAuB,wBAAwB;CAC/C,eAAe;EACb,UAAU;EACV,UAAU;CACZ;AACF"}
+{"version":3,"file":"control.mjs","names":["baselineMetadata","baselineOps"],"sources":["../migrations/20260601T0000_install_pg_search_extension/migration.json","../migrations/20260601T0000_install_pg_search_extension/ops.json","../migrations/refs/head.json","../src/contract.json","../src/exports/control.ts"],"sourcesContent":["","","","","/**\n * Control-plane descriptor for the paradedb extension.\n *\n * **Contract-space package layout.** The extension's contract\n * + migrations are emitted by the same pipeline application authors use:\n *\n *   `prisma-next contract emit` → `<package>/src/contract.{json,d.ts}`\n *   `prisma-next migration plan` → `<package>/migrations/<dir>/...`\n *\n * The descriptor wires those JSON artefacts via JSON-import declarations\n * so they flow through the consuming application's module resolver\n * without filesystem assumptions, and synthesises the canonical\n * {@link import('@prisma-next/framework-components/control').MigrationPackage}\n * shape for the framework's runner / verifier to consume. Readers in\n * `@prisma-next/migration-tools` add `dirPath` when loading from disk\n * (`OnDiskMigrationPackage`); descriptor-bundled packages do not need\n * it because the framework reads them directly from the descriptor.\n *\n * Wired surfaces:\n *\n *   - `contractSpace.{contractJson,migrations,headRef}` — sourced from\n *     the on-disk artefacts emitted by `build:contract-space`.\n *   - `queryOperations` — BM25 full-text search operations registered\n *     via `paradedbQueryOperations()`.\n *\n * @see docs/architecture docs/adrs/ADR 212 - Contract spaces.md\n *   (contract-space package layout convention).\n */\n\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { SqlControlExtensionDescriptor } from '@prisma-next/family-sql/control';\nimport { contractSpaceFromJson } from '@prisma-next/migration-tools/spaces';\nimport type { SqlStorage } from '@prisma-next/sql-contract/types';\nimport baselineMetadata from '../../migrations/20260601T0000_install_pg_search_extension/migration.json' with {\n  type: 'json',\n};\nimport baselineOps from '../../migrations/20260601T0000_install_pg_search_extension/ops.json' with {\n  type: 'json',\n};\nimport headRef from '../../migrations/refs/head.json' with { type: 'json' };\nimport contractJson from '../contract.json' with { type: 'json' };\nimport { PARADEDB_SPACE_ID } from '../core/constants';\nimport { paradedbPackMeta, paradedbQueryOperations } from '../core/descriptor-meta';\n\nconst BASELINE_DIR_NAME = '20260601T0000_install_pg_search_extension';\n\nconst paradedbContractSpace = contractSpaceFromJson<Contract<SqlStorage>>({\n  contractJson,\n  migrations: [\n    {\n      dirName: BASELINE_DIR_NAME,\n      metadata: baselineMetadata,\n      ops: baselineOps,\n    },\n  ],\n  headRef,\n});\n\nconst paradedbExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'> = {\n  ...paradedbPackMeta,\n  id: PARADEDB_SPACE_ID,\n  contractSpace: paradedbContractSpace,\n  queryOperations: () => paradedbQueryOperations(),\n  create: () => ({\n    familyId: 'sql' as const,\n    targetId: 'postgres' as const,\n  }),\n};\n\nexport { paradedbExtensionDescriptor, paradedbPackMeta };\nexport default paradedbExtensionDescriptor;\n"],"mappings":";;;;AI8CA,MAAM,wBAAwB,sBAA4C;CACxE,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAA;CACA,YAAY,CACV;EACE,SAAS;EACT,UAAUA;;;;;;EAAAA;EACV,KAAKC;;;;;;;;;;;;;;;;;;;;;;;;;GAAAA;CACP,CACF;CACA,SAAA;;;CAAA;AACF,CAAC;AAED,MAAM,8BAAyE;CAC7E,GAAG;CACH,IAAI;CACJ,eAAe;CACf,uBAAuB,wBAAwB;CAC/C,eAAe;EACb,UAAU;EACV,UAAU;CACZ;AACF"}

package/package.json

@@ -1,30 +1,30 @@
 {
   "name": "@prisma-next/extension-paradedb",
-  "version": "0.12.0-dev.5",
+  "version": "0.12.0-dev.51",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "dependencies": {
-    "@prisma-next/contract": "0.12.0-dev.5",
-    "@prisma-next/contract-authoring": "0.12.0-dev.5",
-    "@prisma-next/family-sql": "0.12.0-dev.5",
-    "@prisma-next/framework-components": "0.12.0-dev.5",
-    "@prisma-next/migration-tools": "0.12.0-dev.5",
-    "@prisma-next/sql-contract": "0.12.0-dev.5",
-    "@prisma-next/sql-operations": "0.12.0-dev.5",
-    "@prisma-next/sql-relational-core": "0.12.0-dev.5",
-    "@prisma-next/sql-runtime": "0.12.0-dev.5",
+    "@prisma-next/contract": "0.12.0-dev.51",
+    "@prisma-next/contract-authoring": "0.12.0-dev.51",
+    "@prisma-next/family-sql": "0.12.0-dev.51",
+    "@prisma-next/framework-components": "0.12.0-dev.51",
+    "@prisma-next/migration-tools": "0.12.0-dev.51",
+    "@prisma-next/sql-contract": "0.12.0-dev.51",
+    "@prisma-next/sql-operations": "0.12.0-dev.51",
+    "@prisma-next/sql-relational-core": "0.12.0-dev.51",
+    "@prisma-next/sql-runtime": "0.12.0-dev.51",
     "arktype": "^2.2.0"
   },
   "devDependencies": {
-    "@prisma-next/adapter-postgres": "0.12.0-dev.5",
-    "@prisma-next/cli": "0.12.0-dev.5",
-    "@prisma-next/operations": "0.12.0-dev.5",
-    "@prisma-next/sql-contract-ts": "0.12.0-dev.5",
-    "@prisma-next/target-postgres": "0.12.0-dev.5",
-    "@prisma-next/test-utils": "0.12.0-dev.5",
-    "@prisma-next/tsconfig": "0.12.0-dev.5",
-    "@prisma-next/tsdown": "0.12.0-dev.5",
+    "@prisma-next/adapter-postgres": "0.12.0-dev.51",
+    "@prisma-next/cli": "0.12.0-dev.51",
+    "@prisma-next/operations": "0.12.0-dev.51",
+    "@prisma-next/sql-contract-ts": "0.12.0-dev.51",
+    "@prisma-next/target-postgres": "0.12.0-dev.51",
+    "@prisma-next/test-utils": "0.12.0-dev.51",
+    "@prisma-next/tsconfig": "0.12.0-dev.51",
+    "@prisma-next/tsdown": "0.12.0-dev.51",
     "tsdown": "0.22.0",
     "typescript": "5.9.3",
     "vitest": "4.1.6"

package/src/contract.d.ts

@@ -23,7 +23,7 @@ import type {
 } from '@prisma-next/sql-contract/types';
 import type {
   Contract as ContractType,
-  ContractModelsMap,
+  ContractModelDefinitions,
   ExecutionHashBase,
   NamespaceId,
   ProfileHashBase,
@@ -31,7 +31,7 @@ import type {
 } from '@prisma-next/contract/types';
 
 export type StorageHash =
-  StorageHashBase<'sha256:5dde71f8985299c9eb464edb00d06e2bdef0501bd30b072a614afb48ed4dc21b'>;
+  StorageHashBase<'sha256:6214fc543ea5ffa1c5bdf6f663e62c61b6a3f04460e1e27bf7f47f1544f11603'>;
 export type ExecutionHash = ExecutionHashBase<string>;
 export type ProfileHash =
   ProfileHashBase<'sha256:9c8aa3114e84ed3b7ea2bd57526d9c2e1bf7c5292be694e9d3801f566fda7ccb'>;
@@ -56,10 +56,15 @@ type ContractBase = Omit<
   ContractType<
     {
       readonly namespaces: {
+        readonly __unbound__: {
+          readonly id: '__unbound__';
+          readonly kind: 'sql-namespace';
+          readonly entries: { readonly table: {} };
+        };
         readonly public: {
           readonly id: 'public';
           readonly kind: 'sql-namespace';
-          readonly tables: {};
+          readonly entries: { readonly table: {} };
         };
       };
       readonly storageHash: StorageHash;
@@ -100,7 +105,8 @@ type ContractBase = Omit<
   readonly profileHash: ProfileHash;
 };
 
+export type Models = ContractModelDefinitions<Contract>;
+
 export type Contract = ContractWithTypeMaps<ContractBase, TypeMaps>;
 
 export type Namespaces = Contract['storage']['namespaces'];
-export type Models = ContractModelsMap<Contract>;

package/src/contract.json

@@ -13,13 +13,22 @@
   },
   "storage": {
     "namespaces": {
+      "__unbound__": {
+        "entries": {
+          "table": {}
+        },
+        "id": "__unbound__",
+        "kind": "postgres-unbound-schema"
+      },
       "public": {
+        "entries": {
+          "table": {}
+        },
         "id": "public",
-        "kind": "postgres-schema",
-        "tables": {}
+        "kind": "postgres-schema"
       }
     },
-    "storageHash": "sha256:5dde71f8985299c9eb464edb00d06e2bdef0501bd30b072a614afb48ed4dc21b"
+    "storageHash": "sha256:6214fc543ea5ffa1c5bdf6f663e62c61b6a3f04460e1e27bf7f47f1544f11603"
   },
   "capabilities": {
     "postgres": {