npm - turbine-orm - Versions diffs - 0.59.2 → 0.60.1 - Mend

turbine-orm 0.59.2 → 0.60.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (34) hide show

package/README.md +7 -0
package/dist/cjs/cli/index.d.ts +7 -0
package/dist/cjs/cli/index.js +28 -0
package/dist/cjs/cli/mcp.d.ts +1 -1
package/dist/cjs/cli/mcp.js +1 -1
package/dist/cjs/generate.d.ts +1 -1
package/dist/cjs/generate.js +7 -2
package/dist/cjs/index.d.ts +2 -1
package/dist/cjs/index.js +5 -2
package/dist/cjs/prisma-compat.js +86 -0
package/dist/cjs/prisma-schema-fingerprint.d.ts +61 -0
package/dist/cjs/prisma-schema-fingerprint.js +73 -0
package/dist/cjs/query/warn-registry.d.ts +7 -0
package/dist/cjs/query/warn-registry.js +7 -0
package/dist/cjs/query/where.js +1 -1
package/dist/cjs/schema-metadata.js +1 -1
package/dist/cjs/schema.d.ts +24 -0
package/dist/cli/index.d.ts +7 -0
package/dist/cli/index.js +29 -1
package/dist/cli/mcp.d.ts +1 -1
package/dist/cli/mcp.js +1 -1
package/dist/generate.d.ts +1 -1
package/dist/generate.js +7 -2
package/dist/index.d.ts +2 -1
package/dist/index.js +2 -0
package/dist/prisma-compat.js +53 -0
package/dist/prisma-schema-fingerprint.d.ts +61 -0
package/dist/prisma-schema-fingerprint.js +70 -0
package/dist/query/warn-registry.d.ts +7 -0
package/dist/query/warn-registry.js +7 -0
package/dist/query/where.js +1 -1
package/dist/schema-metadata.js +1 -1
package/dist/schema.d.ts +24 -0
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1038,6 +1038,13 @@ const prisma = createPrismaCompatClient(db, PRISMA_MAP);
 const users = await prisma.User.findMany({ include: { posts: { take: 5 } } });
 ```
+Because nothing re-runs the generator, the map records a fingerprint of the
+`schema.prisma` it was built from, and `createPrismaCompatClient` warns once at startup
+(development only, never in production, silent when the file is absent) if that file has
+since changed. Put `turbine migrate-from-prisma --if-db` in `postinstall` next to
+`prisma generate` so it does not depend on anyone remembering; `--if-db` exits 0 when no
+database is reachable, so a build image with no `DATABASE_URL` still installs.
 Turbine-only query options (`forceCustomPlan`, `skipGlobalFilters`, `allowFullTableScan`,
 `warnOnUnlimited`, `timeout`, `optimisticLock`, `distinctOn`, …) pass through the compat
 delegates, and an unrecognized query-level key logs a one-time dev warning naming the

package/dist/cjs/cli/index.d.ts CHANGED Viewed

@@ -98,6 +98,13 @@ export interface CliArgs {
     allowPartial?: boolean;
     /** `migrate-from-prisma --no-db`: parse-only, skip database resolution. */
     noDb?: boolean;
+    /**
+     * `migrate-from-prisma --if-db`: when no connection string can be resolved,
+     * print a notice and exit 0 rather than failing. For the postinstall hook,
+     * where an `npm ci` in a build image legitimately has no database and must
+     * not be turned into a failed install.
+     */
+    ifDb?: boolean;
 }
 export declare function parseArgs(argv?: string[]): CliArgs;
 /**

package/dist/cjs/cli/index.js CHANGED Viewed

@@ -84,6 +84,7 @@ const index_stats_js_1 = require("../index-stats.js");
 const introspect_js_1 = require("../introspect.js");
 const plan_divergence_js_1 = require("../plan-divergence.js");
 const plan_flip_probe_js_1 = require("../plan-flip-probe.js");
+const prisma_schema_fingerprint_js_1 = require("../prisma-schema-fingerprint.js");
 const schema_js_1 = require("../schema.js");
 const schema_sql_js_1 = require("../schema-sql.js");
 const config_js_1 = require("./config.js");
@@ -274,6 +275,9 @@ function parseArgs(argv = process.argv.slice(2)) {
             case '--no-db':
                 result.noDb = true;
                 break;
+            case '--if-db':
+                result.ifDb = true;
+                break;
             default:
                 if (!arg.startsWith('-')) {
                     result.positional.push(arg);
@@ -1292,6 +1296,17 @@ async function cmdMigrateFromPrisma(args, config) {
             const origin = variable ? `${(0, ui_js_1.cyan)(variable)} via datasource "${dsName}"` : `datasource "${dsName}" ${key}`;
             (0, ui_js_1.info)(`Using the connection string declared by your Prisma schema (${origin}).`);
         }
+        if (!resolvedUrl.url && args.ifDb) {
+            // `--if-db`: the caller is a postinstall hook. A build image with no
+            // database is the expected case there, and failing the install over it
+            // would make the hook worse than not having one. Leave every existing
+            // artifact untouched and say plainly that nothing was regenerated, so a
+            // stale map is never mistaken for a fresh one.
+            (0, ui_js_1.newline)();
+            (0, ui_js_1.info)(`No connection string resolved and ${(0, ui_js_1.cyan)('--if-db')} was passed: skipping, nothing regenerated.`);
+            (0, ui_js_1.newline)();
+            return;
+        }
         url = resolvedUrl.url ?? requireUrl(config, { datasourceVars: resolvedUrl.missingVariables });
         (0, ui_js_1.label)('Database', (0, ui_js_1.redactUrl)(url));
         const spinner = new ui_js_1.Spinner('Introspecting database schema').start();
@@ -1333,6 +1348,13 @@ async function cmdMigrateFromPrisma(args, config) {
     (0, node_fs_1.writeFileSync)(reportPath, (0, prisma_report_js_1.formatPrismaReport)(result, { schemaPath: prismaPath, noTimestamp: args.noTimestamp }), 'utf-8');
     console.log(`  ${(0, ui_js_1.dim)(ui_js_1.symbols.teeEnd)} ${(0, ui_js_1.cyan)(reportPath)} ${(0, ui_js_1.dim)('(report)')}`);
     if (!args.noDb && schemaMeta) {
+        // Record WHAT WAS READ, so the runtime adapter can report a stale map
+        // instead of quietly translating names from a schema that has moved on.
+        // The path is stored relative to the directory this ran in: the runtime
+        // resolves it against `process.cwd()`, and an absolute path would both
+        // break for everyone else and commit a home directory to the repo.
+        const sourcePath = (0, node_path_1.relative)(process.cwd(), prismaPath).split(node_path_1.sep).join('/');
+        result.map.source = { path: sourcePath, hash: (0, prisma_schema_fingerprint_js_1.fingerprintPrismaSchema)(source) };
         const mapPath = (0, node_path_1.join)(outDir, 'prisma-map.ts');
         (0, node_fs_1.writeFileSync)(mapPath, (0, generate_js_1.generatePrismaMap)(result.map, { noTimestamp: args.noTimestamp }), 'utf-8');
         console.log(`  ${(0, ui_js_1.dim)(ui_js_1.symbols.teeEnd)} ${(0, ui_js_1.cyan)(mapPath)} ${(0, ui_js_1.dim)('(typed name map)')}`);
@@ -3344,6 +3366,7 @@ function showMigrateFromPrismaHelp() {
     console.log(`    ${(0, ui_js_1.cyan)('--url, -u')} ${(0, ui_js_1.dim)('<url>')}     Postgres connection string ${(0, ui_js_1.dim)('(unless --no-db)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--out, -o')} ${(0, ui_js_1.dim)('<dir>')}     Output directory ${(0, ui_js_1.dim)('(default: ./generated/turbine)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--no-db')}             Parse-only: write the report without resolving names`);
+    console.log(`    ${(0, ui_js_1.cyan)('--if-db')}             Skip (exit 0) when no connection string resolves ${(0, ui_js_1.dim)('(postinstall)')}`);
     console.log(`    ${(0, ui_js_1.cyan)('--allow-partial')}     Exit 0 even when some items are UNRESOLVED`);
     console.log(`    ${(0, ui_js_1.cyan)('--no-timestamp')}      Omit the ${(0, ui_js_1.dim)('Generated:')} lines ${(0, ui_js_1.dim)('(reproducible output)')}`);
     (0, ui_js_1.newline)();
@@ -3351,6 +3374,11 @@ function showMigrateFromPrismaHelp() {
     console.log(`    ${(0, ui_js_1.dim)('$')} DATABASE_URL=postgres://... npx turbine migrate-from-prisma --schema prisma/schema.prisma`);
     console.log(`    ${(0, ui_js_1.dim)('$')} npx turbine migrate-from-prisma --schema prisma/schema.prisma --no-db`);
     (0, ui_js_1.newline)();
+    console.log(`  ${(0, ui_js_1.bold)('Keeping it current:')}`);
+    console.log(`    ${(0, ui_js_1.dim)('Nothing re-runs this for you, and a stale prisma-map.ts fails silently, so')}`);
+    console.log(`    ${(0, ui_js_1.dim)('put it next to prisma generate:')}`);
+    console.log(`    ${(0, ui_js_1.dim)('"postinstall": "prisma generate && turbine migrate-from-prisma --if-db"')}`);
+    (0, ui_js_1.newline)();
 }
 function showPushHelp() {
     (0, ui_js_1.banner)();

package/dist/cjs/cli/mcp.d.ts CHANGED Viewed

@@ -34,7 +34,7 @@ interface ForeignKeyRow {
  * naming to the SHARED introspection builder (`buildRelationsFromForeignKeys`
  * + `addAutoManyToManyRelations` in ../introspect.ts). MCP previously carried
  * a stale copy of a retired naming scheme, so `turbine mcp` and `turbine
- * generate` derived DIFFERENT relation names from the same database (N-3).
+ * generate` derived DIFFERENT relation names from the same database.
  * Exported for the parity unit test.
  */
 export declare function buildRelations(tableNames: string[], columnsByTable: Map<string, ColumnMetadata[]>, pkByTable: Map<string, string[]>, rows: ForeignKeyRow[], enums?: Record<string, string[]>): Map<string, Record<string, RelationDef>>;

package/dist/cjs/cli/mcp.js CHANGED Viewed

@@ -630,7 +630,7 @@ async function loadSchemaMetadata(client, options) {
  * naming to the SHARED introspection builder (`buildRelationsFromForeignKeys`
  * + `addAutoManyToManyRelations` in ../introspect.ts). MCP previously carried
  * a stale copy of a retired naming scheme, so `turbine mcp` and `turbine
- * generate` derived DIFFERENT relation names from the same database (N-3).
+ * generate` derived DIFFERENT relation names from the same database.
  * Exported for the parity unit test.
  */
 function buildRelations(tableNames, columnsByTable, pkByTable, rows, enums = {}) {

package/dist/cjs/generate.d.ts CHANGED Viewed

@@ -25,7 +25,7 @@ export interface GenerateOptions {
     zod?: boolean;
     /**
      * Omit the `Generated at: <ISO timestamp>` line from every generated file
-     * header (T-8b, reproducible codegen). With this set, byte-identical
+     * header (reproducible codegen). With this set, byte-identical
      * schemas regenerate to byte-identical output, so regens produce empty
      * diffs. Default: `false` (timestamp included, unchanged behavior).
      */

package/dist/cjs/generate.js CHANGED Viewed

@@ -259,7 +259,7 @@ function stripJsonComments(text) {
 // types.ts generator
 // ---------------------------------------------------------------------------
 function generatedFileHeader(options) {
-    // `noTimestamp` omits the volatile line entirely (T-8b) so regenerating an
+    // `noTimestamp` omits the volatile line entirely so regenerating an
     // unchanged schema produces byte-identical files.
     return [
         '/**',
@@ -996,6 +996,11 @@ function generatePrismaMap(map, options) {
     }
     lines.push('  },');
     lines.push(`  enums: ${serializeStringRecord(map.enums)},`);
+    if (map.source) {
+        // Provenance, so the runtime adapter can tell you this file is stale rather
+        // than behaving as if the schema never changed.
+        lines.push(`  source: { path: '${escSQ(map.source.path)}', hash: '${escSQ(map.source.hash)}' },`);
+    }
     lines.push('};');
     lines.push('');
     return lines.join('\n');
@@ -1044,7 +1049,7 @@ function serializeColumn(col) {
     ];
     // Cross-schema type marker, introspection records it only for types living
     // outside the introspected schema; it must survive codegen or the runtime
-    // enum-cast guard in query/builder.ts loses the signal (N-5).
+    // enum-cast guard in query/builder.ts loses the signal.
     if (col.pgTypeSchema !== undefined)
         parts.push(`pgTypeSchema: '${escSQ(col.pgTypeSchema)}'`);
     // Emit isGenerated only when set (server-generated serial/identity), so the

package/dist/cjs/index.d.ts CHANGED Viewed

@@ -43,9 +43,10 @@ export { type IntrospectOptions, introspect } from './introspect.js';
 export { executeNestedCreate, executeNestedUpdate, hasRelationFields, type NestedWriteContext, } from './nested-write.js';
 export { HttpJsonSink, type HttpJsonSinkOptions, type MetricsFlushBatch, type MetricsFlushRow, type ObserveConfig, type ObserveHandle, type ObserveSink, PgMetricsSink, type PgMetricsSinkOptions, } from './observe.js';
 export { executePipeline, type PipelineOptions, type PipelineResults, pipelineSupported } from './pipeline.js';
+export { fingerprintPrismaSchema } from './prisma-schema-fingerprint.js';
 export { type AggregateArgs, type AggregateResult, type ArrayFilter, AUTO_ASSUMED_ROUND_TRIP_MS, AUTO_COUNT_BATCH_MIN_PARENT_ROWS, AUTO_JOIN_PENALTY_MS_PER_ROW, AUTO_TO_ONE_JOIN_MAX_ROWS, AUTO_TO_ONE_JOIN_ROWS_MAX, AUTO_TO_ONE_JOIN_ROWS_MIN, type ColumnRef, type ConnectOrCreateOp, type CountArgs, type CreateArgs, type CreateDataInput, type CreateManyArgs, type DeferredQuery, type DeleteArgs, type DeleteManyArgs, type FieldResult, type FindManyArgs, type FindManyStreamArgs, type FindUniqueArgs, type GlobalFilters, type GroupByAggregateSpec, type GroupByArgs, type GroupByDistinctOn, type GroupByResult, type HavingClause, type JsonFilter, type JsonPathAggregateTarget, type JsonPathGroupKey, type JsonPathOrderBy, type MiddlewareFn, type NestedCreateOp, type NestedUpdateOp, type NestedUpdateOpItem, type NestedUpsertOpItem, type OmitResult, type OrderByClause, type OrderByObject, type OrderDirection, type QueryEvent, type QueryEventListener, QueryInterface, type QueryResult, type RelationDescriptor, type RelationFilter, type RelationLoadStrategy, type RelationPickBy, type RelationPickOrderBy, type SelectResult, type SkipGlobalFilters, type TemporalInfinityReading, type TextSearchFilter, type TypedWithClause, type UpdateArgs, type UpdateDataInput, type UpdateInput, type UpdateManyArgs, type UpdateOperatorInput, type UpsertArgs, type VectorDistanceFilter, type VectorFilter, type VectorMetric, type VectorOrderBy, type VectorOrderByDistance, type WhereClause, type WhereOperator, type WhereValue, type WithClause, type WithOptions, type WithOrderByObject, type WithResult, } from './query/index.js';
 export { type ActiveSubscription, type NotificationHandler, type Subscription, validateChannel } from './realtime.js';
-export type { CheckMetadata, ColumnMetadata, IndexMetadata, PrismaCompatMap, PrismaModelMap, PrismaRelationMap, ReferentialAction, RelationDef, SchemaMetadata, TableMetadata, } from './schema.js';
+export type { CheckMetadata, ColumnMetadata, IndexMetadata, PrismaCompatMap, PrismaModelMap, PrismaRelationMap, PrismaSchemaSource, ReferentialAction, RelationDef, SchemaMetadata, TableMetadata, } from './schema.js';
 export { camelToSnake, isDateType, normalizeKeyColumns, pgArrayType, pgTypeToTs, singularize, snakeToCamel, snakeToPascal, withDbFieldNames, } from './schema.js';
 export { applyManyToManyRelations, type CheckDef, ColumnBuilder, type ColumnConfig, type ColumnDef, type ColumnIndexDef, type ColumnType, type ColumnTypeName, column, type DefineSchemaOptions, type DocFieldIndexDef, defineSchema, isDocFieldIndexDef, type ManyToManyDef, type ReferenceDef, type SchemaDef, type SchemaIndexDef, type TableDef, table, } from './schema-builder.js';
 export { schemaDefToMetadata } from './schema-metadata.js';

package/dist/cjs/index.js CHANGED Viewed

@@ -34,8 +34,8 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.camelToSnake = exports.validateChannel = exports.QueryInterface = exports.AUTO_TO_ONE_JOIN_ROWS_MIN = exports.AUTO_TO_ONE_JOIN_ROWS_MAX = exports.AUTO_TO_ONE_JOIN_MAX_ROWS = exports.AUTO_JOIN_PENALTY_MS_PER_ROW = exports.AUTO_COUNT_BATCH_MIN_PARENT_ROWS = exports.AUTO_ASSUMED_ROUND_TRIP_MS = exports.pipelineSupported = exports.executePipeline = exports.PgMetricsSink = exports.HttpJsonSink = exports.hasRelationFields = exports.executeNestedUpdate = exports.executeNestedCreate = exports.introspect = exports.generate = exports.wrapPgError = exports.ValidationError = exports.UnsupportedFeatureError = exports.UniqueConstraintError = exports.TurbineErrorCode = exports.TurbineError = exports.TimeoutError = exports.setErrorMessageMode = exports.SerializationFailureError = exports.RelationError = exports.ReadOnlyError = exports.PipelineError = exports.OptimisticLockError = exports.NotNullViolationError = exports.NotFoundError = exports.MigrationError = exports.getErrorMessageMode = exports.ForeignKeyError = exports.ExclusionConstraintError = exports.DeadlockError = exports.ConnectionError = exports.CircularRelationError = exports.CheckConstraintError = exports.postgresDialect = exports.withRetry = exports.TurbineClient = exports.TransactionClient = exports.yugabytedb = exports.timescale = exports.postgresql = exports.cockroachdb = exports.alloydb = void 0;
-exports.TypedSqlQuery = exports.buildTypedSql = exports.turbineHttp = exports.defineSeed = exports.schemaToSQLString = exports.schemaToSQL = exports.schemaPush = exports.schemaDiff = exports.DestructivePushRefusal = exports.schemaDefToMetadata = exports.table = exports.isDocFieldIndexDef = exports.defineSchema = exports.column = exports.ColumnBuilder = exports.applyManyToManyRelations = exports.withDbFieldNames = exports.snakeToPascal = exports.snakeToCamel = exports.singularize = exports.pgTypeToTs = exports.pgArrayType = exports.normalizeKeyColumns = exports.isDateType = void 0;
+exports.validateChannel = exports.QueryInterface = exports.AUTO_TO_ONE_JOIN_ROWS_MIN = exports.AUTO_TO_ONE_JOIN_ROWS_MAX = exports.AUTO_TO_ONE_JOIN_MAX_ROWS = exports.AUTO_JOIN_PENALTY_MS_PER_ROW = exports.AUTO_COUNT_BATCH_MIN_PARENT_ROWS = exports.AUTO_ASSUMED_ROUND_TRIP_MS = exports.fingerprintPrismaSchema = exports.pipelineSupported = exports.executePipeline = exports.PgMetricsSink = exports.HttpJsonSink = exports.hasRelationFields = exports.executeNestedUpdate = exports.executeNestedCreate = exports.introspect = exports.generate = exports.wrapPgError = exports.ValidationError = exports.UnsupportedFeatureError = exports.UniqueConstraintError = exports.TurbineErrorCode = exports.TurbineError = exports.TimeoutError = exports.setErrorMessageMode = exports.SerializationFailureError = exports.RelationError = exports.ReadOnlyError = exports.PipelineError = exports.OptimisticLockError = exports.NotNullViolationError = exports.NotFoundError = exports.MigrationError = exports.getErrorMessageMode = exports.ForeignKeyError = exports.ExclusionConstraintError = exports.DeadlockError = exports.ConnectionError = exports.CircularRelationError = exports.CheckConstraintError = exports.postgresDialect = exports.withRetry = exports.TurbineClient = exports.TransactionClient = exports.yugabytedb = exports.timescale = exports.postgresql = exports.cockroachdb = exports.alloydb = void 0;
+exports.TypedSqlQuery = exports.buildTypedSql = exports.turbineHttp = exports.defineSeed = exports.schemaToSQLString = exports.schemaToSQL = exports.schemaPush = exports.schemaDiff = exports.DestructivePushRefusal = exports.schemaDefToMetadata = exports.table = exports.isDocFieldIndexDef = exports.defineSchema = exports.column = exports.ColumnBuilder = exports.applyManyToManyRelations = exports.withDbFieldNames = exports.snakeToPascal = exports.snakeToCamel = exports.singularize = exports.pgTypeToTs = exports.pgArrayType = exports.normalizeKeyColumns = exports.isDateType = exports.camelToSnake = void 0;
 var index_js_1 = require("./adapters/index.js");
 Object.defineProperty(exports, "alloydb", { enumerable: true, get: function () { return index_js_1.alloydb; } });
 Object.defineProperty(exports, "cockroachdb", { enumerable: true, get: function () { return index_js_1.cockroachdb; } });
@@ -93,6 +93,9 @@ Object.defineProperty(exports, "PgMetricsSink", { enumerable: true, get: functio
 var pipeline_js_1 = require("./pipeline.js");
 Object.defineProperty(exports, "executePipeline", { enumerable: true, get: function () { return pipeline_js_1.executePipeline; } });
 Object.defineProperty(exports, "pipelineSupported", { enumerable: true, get: function () { return pipeline_js_1.pipelineSupported; } });
+// Prisma-schema fingerprint (provenance on a generated PRISMA_MAP)
+var prisma_schema_fingerprint_js_1 = require("./prisma-schema-fingerprint.js");
+Object.defineProperty(exports, "fingerprintPrismaSchema", { enumerable: true, get: function () { return prisma_schema_fingerprint_js_1.fingerprintPrismaSchema; } });
 // Query builder
 var index_js_2 = require("./query/index.js");
 Object.defineProperty(exports, "AUTO_ASSUMED_ROUND_TRIP_MS", { enumerable: true, get: function () { return index_js_2.AUTO_ASSUMED_ROUND_TRIP_MS; } });

package/dist/cjs/prisma-compat.js CHANGED Viewed

@@ -110,11 +110,45 @@
  * });
  * ```
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLIENT_RESERVED_KEYS = exports.COMPAT_DEFERRED = exports.PRISMA_ARG_KEYS = exports.Prisma = void 0;
 exports.createPrismaCompatClient = createPrismaCompatClient;
 const errors_js_1 = require("./errors.js");
 const nested_write_js_1 = require("./nested-write.js");
+const prisma_schema_fingerprint_js_1 = require("./prisma-schema-fingerprint.js");
 const index_js_1 = require("./query/index.js");
 const utils_js_1 = require("./query/utils.js");
 const warn_registry_js_1 = require("./query/warn-registry.js");
@@ -442,6 +476,55 @@ function warnUnknownQueryOptions(model, op, args) {
         // must never be the reason a query fails.
     }
 }
+/**
+ * Dev-mode notice that the `prisma-map.ts` driving this client no longer matches
+ * the Prisma schema it was generated from.
+ *
+ * Nothing re-runs `turbine migrate-from-prisma`. When the schema moves on, the
+ * map does not, and the adapter keeps translating the names it has: a model
+ * added last week is simply not on the client, a renamed field is quietly
+ * absent from results. Both read as adapter bugs. This turns them into one line
+ * naming the file and the command that fixes it.
+ *
+ * Everything about the check is subordinate to "never break an app that works":
+ *
+ *  - **Async and unawaited.** Client construction does not wait on a file read;
+ *    the warning lands a tick later or not at all.
+ *  - **Any failure is silence.** A missing file is the NORMAL deployed state
+ *    (nobody ships `prisma/` to production) and so are a bundled runtime with no
+ *    `node:fs` and a read that is refused. None of them is evidence of drift.
+ *  - **Production is skipped entirely**, before anything is imported or read.
+ *  - **Once per process per path**, via the shared registry, so a process that
+ *    builds a client per request says it once.
+ *
+ * @param map - the map under test; a map with no `source` (hand-written, or
+ *   emitted before 0.60) is skipped, since absence carries no information.
+ */
+function warnStalePrismaMap(map) {
+    const source = map.source;
+    if (!source || typeof source.path !== 'string' || typeof source.hash !== 'string')
+        return;
+    if (typeof process === 'undefined' || process.env?.NODE_ENV === 'production')
+        return;
+    void (async () => {
+        try {
+            // Dynamic so a bundle that never reaches this line never needs `node:fs`.
+            const { readFile } = await Promise.resolve().then(() => __importStar(require('node:fs/promises')));
+            const onDisk = await readFile(source.path, 'utf8');
+            if ((0, prisma_schema_fingerprint_js_1.fingerprintPrismaSchema)(onDisk) === source.hash)
+                return;
+            if (!(0, warn_registry_js_1.shouldWarnOnce)(warn_registry_js_1.WARN_NS.stalePrismaMap, source.path))
+                return;
+            console.warn(`[turbine] prisma-compat: ${source.path} has changed since prisma-map.ts was generated,` +
+                ' so any model, field, relation or compound-unique added or renamed since then is missing' +
+                ' from the compat client. Re-run: turbine migrate-from-prisma');
+        }
+        catch {
+            // No file, no `node:fs`, no permission. None of these means the map is
+            // stale, and a diagnostic must never be the reason a client fails.
+        }
+    })();
+}
 /**
  * Prisma 6.7+ accepts `limit` on `updateMany` / `deleteMany` to BOUND how many
  * rows a mass mutation touches. Turbine has no row-bounded mass mutation, so
@@ -1844,6 +1927,9 @@ function createPrismaCompatClient(client, map, options = {}) {
     // the real client satisfies it structurally (the cast just relaxes the strict
     // callback-param variance on `$transaction`).
     const db = client;
+    // Fire-and-forget, dev-only, once per process: is this map still describing
+    // the schema on disk? Nothing else in the system ever asks.
+    warnStalePrismaMap(map);
     const tableToModel = new Map();
     for (const [prismaModel, mm] of Object.entries(map.models))
         tableToModel.set(mm.table, prismaModel);

package/dist/cjs/prisma-schema-fingerprint.d.ts ADDED Viewed

@@ -0,0 +1,61 @@
+/**
+ * turbine-orm, fingerprint of the Prisma schema a `PRISMA_MAP` was generated
+ * from.
+ *
+ * ## The failure this exists for
+ *
+ * `turbine migrate-from-prisma` reads `prisma/schema.prisma` and emits a
+ * `prisma-map.ts` that the `turbine-orm/prisma-compat` adapter is driven by.
+ * Nothing re-runs it. Add a model, rename a field, change a `@@unique` name, and
+ * the map keeps describing the schema as it was: the adapter goes on translating
+ * the names it knows and simply has no entry for the new ones. That surfaces as
+ * "this model is not on the compat client" or a field silently absent from a
+ * result, which reads like an adapter bug rather than a stale artifact, and
+ * which is exactly the failure mode a code generator ought to be able to
+ * announce about itself.
+ *
+ * So the generator records what it read, and the adapter checks that record
+ * against what is on disk. This is the same shape as the unknown-config-key
+ * check in `client.ts` and the parser-overwrite warning in `query/utils.ts`,
+ * with a higher severity than either: those two produce visible breakage on
+ * their own, and this one produces none at all.
+ *
+ * ## Why FNV-1a and not a cryptographic digest
+ *
+ * The question asked is "is this the same file", not "did an adversary craft a
+ * collision". A collision costs one missed warning, so a 64-bit non-crypto hash
+ * is the right instrument, and it keeps this module pure: no `node:crypto`, no
+ * new dependency, and it is importable from the runtime adapter, from the CLI,
+ * and from an edge bundle alike.
+ *
+ * ## Normalization
+ *
+ * Deliberately minimal, and only for differences that are not edits:
+ *
+ *  - a leading UTF-8 BOM, which some editors add and remove without being asked;
+ *  - CRLF and lone CR line endings, so a Windows checkout of an unchanged file
+ *    is not reported as drift (`core.autocrlf` rewrites on checkout);
+ *  - whitespace at the very END of the file, for the same reason.
+ *
+ * Note the last one is end-of-FILE only, not per line. Trailing whitespace on an
+ * individual line is hashed, and changing it is reported as drift. That is the
+ * intended reading: nothing in a checkout rewrites it, so it got there because
+ * someone edited the line, and the cost of an unnecessary regeneration is lower
+ * than the cost of a missed one.
+ *
+ * Nothing else is normalized. Comments and blank lines are hashed as-is: a
+ * "harmless" edit is still an edit, and reporting one costs a regeneration
+ * nobody regrets, while normalizing one away risks silence on a real change
+ * whose only visible trace happened to be a comment.
+ */
+/**
+ * Fingerprint the TEXT of a Prisma schema file. Stable across line-ending and
+ * BOM differences that a checkout can introduce (see the module doc), sensitive
+ * to every other byte.
+ *
+ * The returned string is opaque and versioned by its `v1:` prefix: if the
+ * normalization ever has to change, old maps carry the old prefix and can be
+ * recognized rather than reported as drift against a rule they were not
+ * generated under.
+ */
+export declare function fingerprintPrismaSchema(source: string): string;

package/dist/cjs/prisma-schema-fingerprint.js ADDED Viewed

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * turbine-orm, fingerprint of the Prisma schema a `PRISMA_MAP` was generated
+ * from.
+ *
+ * ## The failure this exists for
+ *
+ * `turbine migrate-from-prisma` reads `prisma/schema.prisma` and emits a
+ * `prisma-map.ts` that the `turbine-orm/prisma-compat` adapter is driven by.
+ * Nothing re-runs it. Add a model, rename a field, change a `@@unique` name, and
+ * the map keeps describing the schema as it was: the adapter goes on translating
+ * the names it knows and simply has no entry for the new ones. That surfaces as
+ * "this model is not on the compat client" or a field silently absent from a
+ * result, which reads like an adapter bug rather than a stale artifact, and
+ * which is exactly the failure mode a code generator ought to be able to
+ * announce about itself.
+ *
+ * So the generator records what it read, and the adapter checks that record
+ * against what is on disk. This is the same shape as the unknown-config-key
+ * check in `client.ts` and the parser-overwrite warning in `query/utils.ts`,
+ * with a higher severity than either: those two produce visible breakage on
+ * their own, and this one produces none at all.
+ *
+ * ## Why FNV-1a and not a cryptographic digest
+ *
+ * The question asked is "is this the same file", not "did an adversary craft a
+ * collision". A collision costs one missed warning, so a 64-bit non-crypto hash
+ * is the right instrument, and it keeps this module pure: no `node:crypto`, no
+ * new dependency, and it is importable from the runtime adapter, from the CLI,
+ * and from an edge bundle alike.
+ *
+ * ## Normalization
+ *
+ * Deliberately minimal, and only for differences that are not edits:
+ *
+ *  - a leading UTF-8 BOM, which some editors add and remove without being asked;
+ *  - CRLF and lone CR line endings, so a Windows checkout of an unchanged file
+ *    is not reported as drift (`core.autocrlf` rewrites on checkout);
+ *  - whitespace at the very END of the file, for the same reason.
+ *
+ * Note the last one is end-of-FILE only, not per line. Trailing whitespace on an
+ * individual line is hashed, and changing it is reported as drift. That is the
+ * intended reading: nothing in a checkout rewrites it, so it got there because
+ * someone edited the line, and the cost of an unnecessary regeneration is lower
+ * than the cost of a missed one.
+ *
+ * Nothing else is normalized. Comments and blank lines are hashed as-is: a
+ * "harmless" edit is still an edit, and reporting one costs a regeneration
+ * nobody regrets, while normalizing one away risks silence on a real change
+ * whose only visible trace happened to be a comment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fingerprintPrismaSchema = fingerprintPrismaSchema;
+const utils_js_1 = require("./query/utils.js");
+/**
+ * Fingerprint the TEXT of a Prisma schema file. Stable across line-ending and
+ * BOM differences that a checkout can introduce (see the module doc), sensitive
+ * to every other byte.
+ *
+ * The returned string is opaque and versioned by its `v1:` prefix: if the
+ * normalization ever has to change, old maps carry the old prefix and can be
+ * recognized rather than reported as drift against a rule they were not
+ * generated under.
+ */
+function fingerprintPrismaSchema(source) {
+    const normalized = source
+        // Written as an escape, not the literal character: a bare BOM in source is
+        // invisible in a diff and some tools strip it from the file it lives in.
+        .replace(/^\uFEFF/, '')
+        .replace(/\r\n?/g, '\n')
+        .replace(/\s+$/, '');
+    return `v1:${(0, utils_js_1.fnv1a64Hex)(normalized)}`;
+}

package/dist/cjs/query/warn-registry.d.ts CHANGED Viewed

@@ -104,6 +104,13 @@ export declare const WARN_NS: {
      * a million executions of one call site is one.
      */
     readonly unknownQueryOption: "unknownQueryOption";
+    /**
+     * The `prisma-map.ts` driving a `turbine-orm/prisma-compat` client no longer
+     * matches the Prisma schema it was generated from (prisma-compat.ts
+     * `warnStalePrismaMap`). Keyed on the schema path, so a process that builds a
+     * compat client per request reports it once.
+     */
+    readonly stalePrismaMap: "stalePrismaMap";
     /**
      * `planCacheMode` was set on a client given an EXTERNAL pool, where Turbine
      * runs no connection setup, so the option is a no-op (client.ts constructor).

package/dist/cjs/query/warn-registry.js CHANGED Viewed

@@ -145,6 +145,13 @@ exports.WARN_NS = {
      * a million executions of one call site is one.
      */
     unknownQueryOption: 'unknownQueryOption',
+    /**
+     * The `prisma-map.ts` driving a `turbine-orm/prisma-compat` client no longer
+     * matches the Prisma schema it was generated from (prisma-compat.ts
+     * `warnStalePrismaMap`). Keyed on the schema path, so a process that builds a
+     * compat client per request reports it once.
+     */
+    stalePrismaMap: 'stalePrismaMap',
     /**
      * `planCacheMode` was set on a client given an EXTERNAL pool, where Turbine
      * runs no connection setup, so the option is a no-op (client.ts constructor).

package/dist/cjs/query/where.js CHANGED Viewed

@@ -1064,7 +1064,7 @@ function enumTypeForColumn(qi, column) {
     const enums = qi.schema.enums;
     if (!enums)
         return null;
-    // Cross-schema guard (N-5): introspection records pgTypeSchema ONLY when
+    // Cross-schema guard: introspection records pgTypeSchema ONLY when
     // the column's type lives OUTSIDE the introspected schema. A same-named
     // enum in another schema must not get this schema's cast, search_path
     // would resolve `::"status"` to the wrong type. Skipping the cast restores

package/dist/cjs/schema-metadata.js CHANGED Viewed

@@ -252,7 +252,7 @@ function schemaDefToMetadata(def) {
     // local reimplementation had NO collision guard, `posts.user` (text) +
     // `userId references users.id` produced a relation `user` that shadowed the
     // scalar, and two FKs deriving the same name silently clobbered each other
-    // (N-4).
+    //.
     //
     // Constraint names are synthesized in pg's default `<table>_<column>_fkey`
     // form; they only feed the referential-action lookup and composite-FK

package/dist/cjs/schema.d.ts CHANGED Viewed

@@ -325,6 +325,30 @@ export interface PrismaCompatMap {
     models: Record<string, PrismaModelMap>;
     /** Prisma enum name → resolved database enum-type name. */
     enums: Record<string, string>;
+    /**
+     * The Prisma schema file this map was generated from. Present on maps emitted
+     * by `turbine migrate-from-prisma` since 0.60; absent on older ones, and on a
+     * map assembled by hand.
+     *
+     * `turbine-orm/prisma-compat` uses it for a once-per-process, dev-only staleness
+     * check: nothing re-runs the generator, so a map can silently fall behind the
+     * schema it describes and the adapter has no way to know. See
+     * {@link fingerprintPrismaSchema}.
+     */
+    source?: PrismaSchemaSource;
+}
+/** Provenance of a generated {@link PrismaCompatMap}. */
+export interface PrismaSchemaSource {
+    /**
+     * The Prisma schema file, POSIX-separated and relative to the directory the
+     * generator ran in (which for the documented workflow is the project root, so
+     * it resolves against `process.cwd()` at runtime). Relative rather than
+     * absolute so the value is identical for every developer and in CI, and so a
+     * generated file never carries someone's home directory into version control.
+     */
+    path: string;
+    /** {@link fingerprintPrismaSchema} of that file's contents at generation time. */
+    hash: string;
 }
 /** One Prisma model's resolved mapping onto a Turbine table + client accessor. */
 export interface PrismaModelMap {

package/dist/cli/index.d.ts CHANGED Viewed

@@ -98,6 +98,13 @@ export interface CliArgs {
     allowPartial?: boolean;
     /** `migrate-from-prisma --no-db`: parse-only, skip database resolution. */
     noDb?: boolean;
+    /**
+     * `migrate-from-prisma --if-db`: when no connection string can be resolved,
+     * print a notice and exit 0 rather than failing. For the postinstall hook,
+     * where an `npm ci` in a build image legitimately has no database and must
+     * not be turned into a failed install.
+     */
+    ifDb?: boolean;
 }
 export declare function parseArgs(argv?: string[]): CliArgs;
 /**

package/dist/cli/index.js CHANGED Viewed

@@ -26,7 +26,7 @@
  */
 import { appendFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync, } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { basename, dirname, extname, join, relative, resolve } from 'node:path';
+import { basename, dirname, extname, join, relative, resolve, sep } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { generate, generatePrismaMap } from '../generate.js';
 import { buildCreateIndexSql, buildDropIndexSql, collectDoctorProbeIndexNames, collectRelationProbeColumns, findMissingRelationIndexes, } from '../index-advisor.js';
@@ -34,6 +34,7 @@ import { auditDoctorIndexes, collectStatsSnapshot, collectTableHeat, findInvalid
 import { introspect } from '../introspect.js';
 import { collectDivergenceCandidateColumns, collectDivergenceOrderColumns, findPlanDivergence, PLAN_DIVERGENCE_THRESHOLDS, } from '../plan-divergence.js';
 import { applyFlipVerdicts, emptyFlipProbeResult, needsFlipProbe, probePlanFlips } from '../plan-flip-probe.js';
+import { fingerprintPrismaSchema } from '../prisma-schema-fingerprint.js';
 import { snakeToCamel } from '../schema.js';
 import { DestructivePushRefusal, schemaDiff, schemaPush } from '../schema-sql.js';
 import { configTemplate, DEFAULT_INIT_SEED_FILE, findConfigFile, loadConfigResult, looksLikeSchemaFilePath, resolveConfig, resolveSeedFile, unwrapModuleDefault, } from './config.js';
@@ -224,6 +225,9 @@ export function parseArgs(argv = process.argv.slice(2)) {
             case '--no-db':
                 result.noDb = true;
                 break;
+            case '--if-db':
+                result.ifDb = true;
+                break;
             default:
                 if (!arg.startsWith('-')) {
                     result.positional.push(arg);
@@ -1242,6 +1246,17 @@ async function cmdMigrateFromPrisma(args, config) {
             const origin = variable ? `${cyan(variable)} via datasource "${dsName}"` : `datasource "${dsName}" ${key}`;
             info(`Using the connection string declared by your Prisma schema (${origin}).`);
         }
+        if (!resolvedUrl.url && args.ifDb) {
+            // `--if-db`: the caller is a postinstall hook. A build image with no
+            // database is the expected case there, and failing the install over it
+            // would make the hook worse than not having one. Leave every existing
+            // artifact untouched and say plainly that nothing was regenerated, so a
+            // stale map is never mistaken for a fresh one.
+            newline();
+            info(`No connection string resolved and ${cyan('--if-db')} was passed: skipping, nothing regenerated.`);
+            newline();
+            return;
+        }
         url = resolvedUrl.url ?? requireUrl(config, { datasourceVars: resolvedUrl.missingVariables });
         label('Database', redactUrl(url));
         const spinner = new Spinner('Introspecting database schema').start();
@@ -1283,6 +1298,13 @@ async function cmdMigrateFromPrisma(args, config) {
     writeFileSync(reportPath, formatPrismaReport(result, { schemaPath: prismaPath, noTimestamp: args.noTimestamp }), 'utf-8');
     console.log(`  ${dim(symbols.teeEnd)} ${cyan(reportPath)} ${dim('(report)')}`);
     if (!args.noDb && schemaMeta) {
+        // Record WHAT WAS READ, so the runtime adapter can report a stale map
+        // instead of quietly translating names from a schema that has moved on.
+        // The path is stored relative to the directory this ran in: the runtime
+        // resolves it against `process.cwd()`, and an absolute path would both
+        // break for everyone else and commit a home directory to the repo.
+        const sourcePath = relative(process.cwd(), prismaPath).split(sep).join('/');
+        result.map.source = { path: sourcePath, hash: fingerprintPrismaSchema(source) };
         const mapPath = join(outDir, 'prisma-map.ts');
         writeFileSync(mapPath, generatePrismaMap(result.map, { noTimestamp: args.noTimestamp }), 'utf-8');
         console.log(`  ${dim(symbols.teeEnd)} ${cyan(mapPath)} ${dim('(typed name map)')}`);
@@ -3294,6 +3316,7 @@ function showMigrateFromPrismaHelp() {
     console.log(`    ${cyan('--url, -u')} ${dim('<url>')}     Postgres connection string ${dim('(unless --no-db)')}`);
     console.log(`    ${cyan('--out, -o')} ${dim('<dir>')}     Output directory ${dim('(default: ./generated/turbine)')}`);
     console.log(`    ${cyan('--no-db')}             Parse-only: write the report without resolving names`);
+    console.log(`    ${cyan('--if-db')}             Skip (exit 0) when no connection string resolves ${dim('(postinstall)')}`);
     console.log(`    ${cyan('--allow-partial')}     Exit 0 even when some items are UNRESOLVED`);
     console.log(`    ${cyan('--no-timestamp')}      Omit the ${dim('Generated:')} lines ${dim('(reproducible output)')}`);
     newline();
@@ -3301,6 +3324,11 @@ function showMigrateFromPrismaHelp() {
     console.log(`    ${dim('$')} DATABASE_URL=postgres://... npx turbine migrate-from-prisma --schema prisma/schema.prisma`);
     console.log(`    ${dim('$')} npx turbine migrate-from-prisma --schema prisma/schema.prisma --no-db`);
     newline();
+    console.log(`  ${bold('Keeping it current:')}`);
+    console.log(`    ${dim('Nothing re-runs this for you, and a stale prisma-map.ts fails silently, so')}`);
+    console.log(`    ${dim('put it next to prisma generate:')}`);
+    console.log(`    ${dim('"postinstall": "prisma generate && turbine migrate-from-prisma --if-db"')}`);
+    newline();
 }
 function showPushHelp() {
     banner();

package/dist/cli/mcp.d.ts CHANGED Viewed

@@ -34,7 +34,7 @@ interface ForeignKeyRow {
  * naming to the SHARED introspection builder (`buildRelationsFromForeignKeys`
  * + `addAutoManyToManyRelations` in ../introspect.ts). MCP previously carried
  * a stale copy of a retired naming scheme, so `turbine mcp` and `turbine
- * generate` derived DIFFERENT relation names from the same database (N-3).
+ * generate` derived DIFFERENT relation names from the same database.
  * Exported for the parity unit test.
  */
 export declare function buildRelations(tableNames: string[], columnsByTable: Map<string, ColumnMetadata[]>, pkByTable: Map<string, string[]>, rows: ForeignKeyRow[], enums?: Record<string, string[]>): Map<string, Record<string, RelationDef>>;

package/dist/cli/mcp.js CHANGED Viewed

@@ -622,7 +622,7 @@ async function loadSchemaMetadata(client, options) {
  * naming to the SHARED introspection builder (`buildRelationsFromForeignKeys`
  * + `addAutoManyToManyRelations` in ../introspect.ts). MCP previously carried
  * a stale copy of a retired naming scheme, so `turbine mcp` and `turbine
- * generate` derived DIFFERENT relation names from the same database (N-3).
+ * generate` derived DIFFERENT relation names from the same database.
  * Exported for the parity unit test.
  */
 export function buildRelations(tableNames, columnsByTable, pkByTable, rows, enums = {}) {

package/dist/generate.d.ts CHANGED Viewed

@@ -25,7 +25,7 @@ export interface GenerateOptions {
     zod?: boolean;
     /**
      * Omit the `Generated at: <ISO timestamp>` line from every generated file
-     * header (T-8b, reproducible codegen). With this set, byte-identical
+     * header (reproducible codegen). With this set, byte-identical
      * schemas regenerate to byte-identical output, so regens produce empty
      * diffs. Default: `false` (timestamp included, unchanged behavior).
      */

package/dist/generate.js CHANGED Viewed

@@ -247,7 +247,7 @@ export function stripJsonComments(text) {
 // types.ts generator
 // ---------------------------------------------------------------------------
 function generatedFileHeader(options) {
-    // `noTimestamp` omits the volatile line entirely (T-8b) so regenerating an
+    // `noTimestamp` omits the volatile line entirely so regenerating an
     // unchanged schema produces byte-identical files.
     return [
         '/**',
@@ -984,6 +984,11 @@ export function generatePrismaMap(map, options) {
     }
     lines.push('  },');
     lines.push(`  enums: ${serializeStringRecord(map.enums)},`);
+    if (map.source) {
+        // Provenance, so the runtime adapter can tell you this file is stale rather
+        // than behaving as if the schema never changed.
+        lines.push(`  source: { path: '${escSQ(map.source.path)}', hash: '${escSQ(map.source.hash)}' },`);
+    }
     lines.push('};');
     lines.push('');
     return lines.join('\n');
@@ -1032,7 +1037,7 @@ function serializeColumn(col) {
     ];
     // Cross-schema type marker, introspection records it only for types living
     // outside the introspected schema; it must survive codegen or the runtime
-    // enum-cast guard in query/builder.ts loses the signal (N-5).
+    // enum-cast guard in query/builder.ts loses the signal.
     if (col.pgTypeSchema !== undefined)
         parts.push(`pgTypeSchema: '${escSQ(col.pgTypeSchema)}'`);
     // Emit isGenerated only when set (server-generated serial/identity), so the

package/dist/index.d.ts CHANGED Viewed

@@ -43,9 +43,10 @@ export { type IntrospectOptions, introspect } from './introspect.js';
 export { executeNestedCreate, executeNestedUpdate, hasRelationFields, type NestedWriteContext, } from './nested-write.js';
 export { HttpJsonSink, type HttpJsonSinkOptions, type MetricsFlushBatch, type MetricsFlushRow, type ObserveConfig, type ObserveHandle, type ObserveSink, PgMetricsSink, type PgMetricsSinkOptions, } from './observe.js';
 export { executePipeline, type PipelineOptions, type PipelineResults, pipelineSupported } from './pipeline.js';
+export { fingerprintPrismaSchema } from './prisma-schema-fingerprint.js';
 export { type AggregateArgs, type AggregateResult, type ArrayFilter, AUTO_ASSUMED_ROUND_TRIP_MS, AUTO_COUNT_BATCH_MIN_PARENT_ROWS, AUTO_JOIN_PENALTY_MS_PER_ROW, AUTO_TO_ONE_JOIN_MAX_ROWS, AUTO_TO_ONE_JOIN_ROWS_MAX, AUTO_TO_ONE_JOIN_ROWS_MIN, type ColumnRef, type ConnectOrCreateOp, type CountArgs, type CreateArgs, type CreateDataInput, type CreateManyArgs, type DeferredQuery, type DeleteArgs, type DeleteManyArgs, type FieldResult, type FindManyArgs, type FindManyStreamArgs, type FindUniqueArgs, type GlobalFilters, type GroupByAggregateSpec, type GroupByArgs, type GroupByDistinctOn, type GroupByResult, type HavingClause, type JsonFilter, type JsonPathAggregateTarget, type JsonPathGroupKey, type JsonPathOrderBy, type MiddlewareFn, type NestedCreateOp, type NestedUpdateOp, type NestedUpdateOpItem, type NestedUpsertOpItem, type OmitResult, type OrderByClause, type OrderByObject, type OrderDirection, type QueryEvent, type QueryEventListener, QueryInterface, type QueryResult, type RelationDescriptor, type RelationFilter, type RelationLoadStrategy, type RelationPickBy, type RelationPickOrderBy, type SelectResult, type SkipGlobalFilters, type TemporalInfinityReading, type TextSearchFilter, type TypedWithClause, type UpdateArgs, type UpdateDataInput, type UpdateInput, type UpdateManyArgs, type UpdateOperatorInput, type UpsertArgs, type VectorDistanceFilter, type VectorFilter, type VectorMetric, type VectorOrderBy, type VectorOrderByDistance, type WhereClause, type WhereOperator, type WhereValue, type WithClause, type WithOptions, type WithOrderByObject, type WithResult, } from './query/index.js';
 export { type ActiveSubscription, type NotificationHandler, type Subscription, validateChannel } from './realtime.js';
-export type { CheckMetadata, ColumnMetadata, IndexMetadata, PrismaCompatMap, PrismaModelMap, PrismaRelationMap, ReferentialAction, RelationDef, SchemaMetadata, TableMetadata, } from './schema.js';
+export type { CheckMetadata, ColumnMetadata, IndexMetadata, PrismaCompatMap, PrismaModelMap, PrismaRelationMap, PrismaSchemaSource, ReferentialAction, RelationDef, SchemaMetadata, TableMetadata, } from './schema.js';
 export { camelToSnake, isDateType, normalizeKeyColumns, pgArrayType, pgTypeToTs, singularize, snakeToCamel, snakeToPascal, withDbFieldNames, } from './schema.js';
 export { applyManyToManyRelations, type CheckDef, ColumnBuilder, type ColumnConfig, type ColumnDef, type ColumnIndexDef, type ColumnType, type ColumnTypeName, column, type DefineSchemaOptions, type DocFieldIndexDef, defineSchema, isDocFieldIndexDef, type ManyToManyDef, type ReferenceDef, type SchemaDef, type SchemaIndexDef, type TableDef, table, } from './schema-builder.js';
 export { schemaDefToMetadata } from './schema-metadata.js';

package/dist/index.js CHANGED Viewed

@@ -48,6 +48,8 @@ export { executeNestedCreate, executeNestedUpdate, hasRelationFields, } from './
 export { HttpJsonSink, PgMetricsSink, } from './observe.js';
 // Pipeline
 export { executePipeline, pipelineSupported } from './pipeline.js';
+// Prisma-schema fingerprint (provenance on a generated PRISMA_MAP)
+export { fingerprintPrismaSchema } from './prisma-schema-fingerprint.js';
 // Query builder
 export { AUTO_ASSUMED_ROUND_TRIP_MS, AUTO_COUNT_BATCH_MIN_PARENT_ROWS, AUTO_JOIN_PENALTY_MS_PER_ROW, AUTO_TO_ONE_JOIN_MAX_ROWS, AUTO_TO_ONE_JOIN_ROWS_MAX, AUTO_TO_ONE_JOIN_ROWS_MIN, QueryInterface, } from './query/index.js';
 // Realtime, LISTEN/NOTIFY pub/sub

package/dist/prisma-compat.js CHANGED Viewed

@@ -111,6 +111,7 @@
  */
 import { TurbineError, TurbineErrorCode, UnsupportedFeatureError, ValidationError, wrapPgError } from './errors.js';
 import { createManyShapeRuns } from './nested-write.js';
+import { fingerprintPrismaSchema } from './prisma-schema-fingerprint.js';
 import { AGGREGATE_OPTIONS, applyNativeOptions, COUNT_OPTIONS, CREATE_MANY_OPTIONS, CREATE_OPTIONS, DELETE_MANY_OPTIONS, DELETE_OPTIONS, FIND_MANY_OPTIONS, FIND_UNIQUE_OPTIONS, GROUP_BY_OPTIONS, optionKeysOfKind, UPDATE_MANY_OPTIONS, UPDATE_OPTIONS, UPSERT_OPTIONS, } from './query/index.js';
 import { suggestKey } from './query/utils.js';
 import { shouldWarnOnce, WARN_NS } from './query/warn-registry.js';
@@ -438,6 +439,55 @@ function warnUnknownQueryOptions(model, op, args) {
         // must never be the reason a query fails.
     }
 }
+/**
+ * Dev-mode notice that the `prisma-map.ts` driving this client no longer matches
+ * the Prisma schema it was generated from.
+ *
+ * Nothing re-runs `turbine migrate-from-prisma`. When the schema moves on, the
+ * map does not, and the adapter keeps translating the names it has: a model
+ * added last week is simply not on the client, a renamed field is quietly
+ * absent from results. Both read as adapter bugs. This turns them into one line
+ * naming the file and the command that fixes it.
+ *
+ * Everything about the check is subordinate to "never break an app that works":
+ *
+ *  - **Async and unawaited.** Client construction does not wait on a file read;
+ *    the warning lands a tick later or not at all.
+ *  - **Any failure is silence.** A missing file is the NORMAL deployed state
+ *    (nobody ships `prisma/` to production) and so are a bundled runtime with no
+ *    `node:fs` and a read that is refused. None of them is evidence of drift.
+ *  - **Production is skipped entirely**, before anything is imported or read.
+ *  - **Once per process per path**, via the shared registry, so a process that
+ *    builds a client per request says it once.
+ *
+ * @param map - the map under test; a map with no `source` (hand-written, or
+ *   emitted before 0.60) is skipped, since absence carries no information.
+ */
+function warnStalePrismaMap(map) {
+    const source = map.source;
+    if (!source || typeof source.path !== 'string' || typeof source.hash !== 'string')
+        return;
+    if (typeof process === 'undefined' || process.env?.NODE_ENV === 'production')
+        return;
+    void (async () => {
+        try {
+            // Dynamic so a bundle that never reaches this line never needs `node:fs`.
+            const { readFile } = await import('node:fs/promises');
+            const onDisk = await readFile(source.path, 'utf8');
+            if (fingerprintPrismaSchema(onDisk) === source.hash)
+                return;
+            if (!shouldWarnOnce(WARN_NS.stalePrismaMap, source.path))
+                return;
+            console.warn(`[turbine] prisma-compat: ${source.path} has changed since prisma-map.ts was generated,` +
+                ' so any model, field, relation or compound-unique added or renamed since then is missing' +
+                ' from the compat client. Re-run: turbine migrate-from-prisma');
+        }
+        catch {
+            // No file, no `node:fs`, no permission. None of these means the map is
+            // stale, and a diagnostic must never be the reason a client fails.
+        }
+    })();
+}
 /**
  * Prisma 6.7+ accepts `limit` on `updateMany` / `deleteMany` to BOUND how many
  * rows a mass mutation touches. Turbine has no row-bounded mass mutation, so
@@ -1840,6 +1890,9 @@ export function createPrismaCompatClient(client, map, options = {}) {
     // the real client satisfies it structurally (the cast just relaxes the strict
     // callback-param variance on `$transaction`).
     const db = client;
+    // Fire-and-forget, dev-only, once per process: is this map still describing
+    // the schema on disk? Nothing else in the system ever asks.
+    warnStalePrismaMap(map);
     const tableToModel = new Map();
     for (const [prismaModel, mm] of Object.entries(map.models))
         tableToModel.set(mm.table, prismaModel);

package/dist/prisma-schema-fingerprint.d.ts ADDED Viewed

@@ -0,0 +1,61 @@
+/**
+ * turbine-orm, fingerprint of the Prisma schema a `PRISMA_MAP` was generated
+ * from.
+ *
+ * ## The failure this exists for
+ *
+ * `turbine migrate-from-prisma` reads `prisma/schema.prisma` and emits a
+ * `prisma-map.ts` that the `turbine-orm/prisma-compat` adapter is driven by.
+ * Nothing re-runs it. Add a model, rename a field, change a `@@unique` name, and
+ * the map keeps describing the schema as it was: the adapter goes on translating
+ * the names it knows and simply has no entry for the new ones. That surfaces as
+ * "this model is not on the compat client" or a field silently absent from a
+ * result, which reads like an adapter bug rather than a stale artifact, and
+ * which is exactly the failure mode a code generator ought to be able to
+ * announce about itself.
+ *
+ * So the generator records what it read, and the adapter checks that record
+ * against what is on disk. This is the same shape as the unknown-config-key
+ * check in `client.ts` and the parser-overwrite warning in `query/utils.ts`,
+ * with a higher severity than either: those two produce visible breakage on
+ * their own, and this one produces none at all.
+ *
+ * ## Why FNV-1a and not a cryptographic digest
+ *
+ * The question asked is "is this the same file", not "did an adversary craft a
+ * collision". A collision costs one missed warning, so a 64-bit non-crypto hash
+ * is the right instrument, and it keeps this module pure: no `node:crypto`, no
+ * new dependency, and it is importable from the runtime adapter, from the CLI,
+ * and from an edge bundle alike.
+ *
+ * ## Normalization
+ *
+ * Deliberately minimal, and only for differences that are not edits:
+ *
+ *  - a leading UTF-8 BOM, which some editors add and remove without being asked;
+ *  - CRLF and lone CR line endings, so a Windows checkout of an unchanged file
+ *    is not reported as drift (`core.autocrlf` rewrites on checkout);
+ *  - whitespace at the very END of the file, for the same reason.
+ *
+ * Note the last one is end-of-FILE only, not per line. Trailing whitespace on an
+ * individual line is hashed, and changing it is reported as drift. That is the
+ * intended reading: nothing in a checkout rewrites it, so it got there because
+ * someone edited the line, and the cost of an unnecessary regeneration is lower
+ * than the cost of a missed one.
+ *
+ * Nothing else is normalized. Comments and blank lines are hashed as-is: a
+ * "harmless" edit is still an edit, and reporting one costs a regeneration
+ * nobody regrets, while normalizing one away risks silence on a real change
+ * whose only visible trace happened to be a comment.
+ */
+/**
+ * Fingerprint the TEXT of a Prisma schema file. Stable across line-ending and
+ * BOM differences that a checkout can introduce (see the module doc), sensitive
+ * to every other byte.
+ *
+ * The returned string is opaque and versioned by its `v1:` prefix: if the
+ * normalization ever has to change, old maps carry the old prefix and can be
+ * recognized rather than reported as drift against a rule they were not
+ * generated under.
+ */
+export declare function fingerprintPrismaSchema(source: string): string;

package/dist/prisma-schema-fingerprint.js ADDED Viewed

@@ -0,0 +1,70 @@
+/**
+ * turbine-orm, fingerprint of the Prisma schema a `PRISMA_MAP` was generated
+ * from.
+ *
+ * ## The failure this exists for
+ *
+ * `turbine migrate-from-prisma` reads `prisma/schema.prisma` and emits a
+ * `prisma-map.ts` that the `turbine-orm/prisma-compat` adapter is driven by.
+ * Nothing re-runs it. Add a model, rename a field, change a `@@unique` name, and
+ * the map keeps describing the schema as it was: the adapter goes on translating
+ * the names it knows and simply has no entry for the new ones. That surfaces as
+ * "this model is not on the compat client" or a field silently absent from a
+ * result, which reads like an adapter bug rather than a stale artifact, and
+ * which is exactly the failure mode a code generator ought to be able to
+ * announce about itself.
+ *
+ * So the generator records what it read, and the adapter checks that record
+ * against what is on disk. This is the same shape as the unknown-config-key
+ * check in `client.ts` and the parser-overwrite warning in `query/utils.ts`,
+ * with a higher severity than either: those two produce visible breakage on
+ * their own, and this one produces none at all.
+ *
+ * ## Why FNV-1a and not a cryptographic digest
+ *
+ * The question asked is "is this the same file", not "did an adversary craft a
+ * collision". A collision costs one missed warning, so a 64-bit non-crypto hash
+ * is the right instrument, and it keeps this module pure: no `node:crypto`, no
+ * new dependency, and it is importable from the runtime adapter, from the CLI,
+ * and from an edge bundle alike.
+ *
+ * ## Normalization
+ *
+ * Deliberately minimal, and only for differences that are not edits:
+ *
+ *  - a leading UTF-8 BOM, which some editors add and remove without being asked;
+ *  - CRLF and lone CR line endings, so a Windows checkout of an unchanged file
+ *    is not reported as drift (`core.autocrlf` rewrites on checkout);
+ *  - whitespace at the very END of the file, for the same reason.
+ *
+ * Note the last one is end-of-FILE only, not per line. Trailing whitespace on an
+ * individual line is hashed, and changing it is reported as drift. That is the
+ * intended reading: nothing in a checkout rewrites it, so it got there because
+ * someone edited the line, and the cost of an unnecessary regeneration is lower
+ * than the cost of a missed one.
+ *
+ * Nothing else is normalized. Comments and blank lines are hashed as-is: a
+ * "harmless" edit is still an edit, and reporting one costs a regeneration
+ * nobody regrets, while normalizing one away risks silence on a real change
+ * whose only visible trace happened to be a comment.
+ */
+import { fnv1a64Hex } from './query/utils.js';
+/**
+ * Fingerprint the TEXT of a Prisma schema file. Stable across line-ending and
+ * BOM differences that a checkout can introduce (see the module doc), sensitive
+ * to every other byte.
+ *
+ * The returned string is opaque and versioned by its `v1:` prefix: if the
+ * normalization ever has to change, old maps carry the old prefix and can be
+ * recognized rather than reported as drift against a rule they were not
+ * generated under.
+ */
+export function fingerprintPrismaSchema(source) {
+    const normalized = source
+        // Written as an escape, not the literal character: a bare BOM in source is
+        // invisible in a diff and some tools strip it from the file it lives in.
+        .replace(/^\uFEFF/, '')
+        .replace(/\r\n?/g, '\n')
+        .replace(/\s+$/, '');
+    return `v1:${fnv1a64Hex(normalized)}`;
+}

package/dist/query/warn-registry.d.ts CHANGED Viewed

@@ -104,6 +104,13 @@ export declare const WARN_NS: {
      * a million executions of one call site is one.
      */
     readonly unknownQueryOption: "unknownQueryOption";
+    /**
+     * The `prisma-map.ts` driving a `turbine-orm/prisma-compat` client no longer
+     * matches the Prisma schema it was generated from (prisma-compat.ts
+     * `warnStalePrismaMap`). Keyed on the schema path, so a process that builds a
+     * compat client per request reports it once.
+     */
+    readonly stalePrismaMap: "stalePrismaMap";
     /**
      * `planCacheMode` was set on a client given an EXTERNAL pool, where Turbine
      * runs no connection setup, so the option is a no-op (client.ts constructor).

package/dist/query/warn-registry.js CHANGED Viewed

@@ -139,6 +139,13 @@ export const WARN_NS = {
      * a million executions of one call site is one.
      */
     unknownQueryOption: 'unknownQueryOption',
+    /**
+     * The `prisma-map.ts` driving a `turbine-orm/prisma-compat` client no longer
+     * matches the Prisma schema it was generated from (prisma-compat.ts
+     * `warnStalePrismaMap`). Keyed on the schema path, so a process that builds a
+     * compat client per request reports it once.
+     */
+    stalePrismaMap: 'stalePrismaMap',
     /**
      * `planCacheMode` was set on a client given an EXTERNAL pool, where Turbine
      * runs no connection setup, so the option is a no-op (client.ts constructor).

package/dist/query/where.js CHANGED Viewed

@@ -999,7 +999,7 @@ export function enumTypeForColumn(qi, column) {
     const enums = qi.schema.enums;
     if (!enums)
         return null;
-    // Cross-schema guard (N-5): introspection records pgTypeSchema ONLY when
+    // Cross-schema guard: introspection records pgTypeSchema ONLY when
     // the column's type lives OUTSIDE the introspected schema. A same-named
     // enum in another schema must not get this schema's cast, search_path
     // would resolve `::"status"` to the wrong type. Skipping the cast restores

package/dist/schema-metadata.js CHANGED Viewed

@@ -249,7 +249,7 @@ export function schemaDefToMetadata(def) {
     // local reimplementation had NO collision guard, `posts.user` (text) +
     // `userId references users.id` produced a relation `user` that shadowed the
     // scalar, and two FKs deriving the same name silently clobbered each other
-    // (N-4).
+    //.
     //
     // Constraint names are synthesized in pg's default `<table>_<column>_fkey`
     // form; they only feed the referential-action lookup and composite-FK

package/dist/schema.d.ts CHANGED Viewed

@@ -325,6 +325,30 @@ export interface PrismaCompatMap {
     models: Record<string, PrismaModelMap>;
     /** Prisma enum name → resolved database enum-type name. */
     enums: Record<string, string>;
+    /**
+     * The Prisma schema file this map was generated from. Present on maps emitted
+     * by `turbine migrate-from-prisma` since 0.60; absent on older ones, and on a
+     * map assembled by hand.
+     *
+     * `turbine-orm/prisma-compat` uses it for a once-per-process, dev-only staleness
+     * check: nothing re-runs the generator, so a map can silently fall behind the
+     * schema it describes and the adapter has no way to know. See
+     * {@link fingerprintPrismaSchema}.
+     */
+    source?: PrismaSchemaSource;
+}
+/** Provenance of a generated {@link PrismaCompatMap}. */
+export interface PrismaSchemaSource {
+    /**
+     * The Prisma schema file, POSIX-separated and relative to the directory the
+     * generator ran in (which for the documented workflow is the project root, so
+     * it resolves against `process.cwd()` at runtime). Relative rather than
+     * absolute so the value is identical for every developer and in CI, and so a
+     * generated file never carries someone's home directory into version control.
+     */
+    path: string;
+    /** {@link fingerprintPrismaSchema} of that file's contents at generation time. */
+    hash: string;
 }
 /** One Prisma model's resolved mapping onto a Turbine table + client accessor. */
 export interface PrismaModelMap {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "turbine-orm",
-  "version": "0.59.2",
+  "version": "0.60.1",
   "description": "Postgres-native TypeScript ORM, runs on Neon, Vercel Postgres, Cloudflare, Supabase. Streaming cursors, typed errors, single-query nested relations. One dependency, no WASM engine",
   "type": "module",
   "//exports": "Each subpath declares its types PER CONDITION. A single shared top-level \"types\" resolves to the ESM declarations for `require` too, which is TS1479 (\"is an ES module ... cannot be require()d\") for any CJS consumer on moduleResolution node16/nodenext. The require condition points at dist/cjs, which ships its own {\"type\":\"commonjs\"} package.json, so those declarations are CJS declarations. Gated in CI by publint + @arethetypeswrong/cli + a real .cts consumer typecheck (see the package-types job in ci.yml).",