@mosaic-code/prisma-select-for-update 0.1.0

package/LICENSE

@@ -0,0 +1,207 @@
+# Do No Harm License
+
+## 1. Preamble
+
+Most software today is developed with little to no thought of how it will be used, or the
+consequences for our society and planet.
+
+As software developers, we engineer the infrastructure of the 21st century. We recognise that our
+infrastructure has great power to shape the world and the lives of those we share it with, and we
+choose to consciously take responsibility for the social and environmental impacts of what we build.
+
+We envisage a world free from injustice, inequality, and the reckless destruction of lives and our
+planet. We reject slavery in all its forms, whether by force, indebtedness, or by algorithms that
+hack human vulnerabilities. We seek a world where humankind is at peace with our neighbours, nature,
+and ourselves. We want our work to enrich the physical, mental and spiritual wellbeing of all
+society.
+
+We build software to further this vision of a just world, or at the very least, to not put that
+vision further from reach.
+
+## 2. Definitions
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by
+Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is
+granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are
+controlled by, or are under common control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the direction or management of such
+entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this
+License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to
+software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a
+Source form, including but not limited to compiled object code, generated documentation, and
+conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the
+License, as indicated by a copyright notice that is included in or attached to the work (an example
+is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or
+derived from) the Work and for which the editorial revisions, annotations, elaborations, or other
+modifications represent, as a whole, an original work of authorship. For the purposes of this
+License, Derivative Works shall not include works that remain separable from, or merely link (or
+bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any
+modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted
+to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity
+authorized to submit on behalf of the copyright owner. For the purposes of this definition,
+"submitted" means any form of electronic, verbal, or written communication sent to the Licensor or
+its representatives, including but not limited to communication on electronic mailing lists, source
+code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor
+for the purpose of discussing and improving the Work, but excluding communication that is
+conspicuously marked or otherwise designated in writing by the copyright owner as "Not a
+Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a
+Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+"Forests" shall mean 0.5 or more hectares of trees that were either planted more than 50 years ago
+or were not planted by humans or human made equipment.
+
+"Deforestation" shall mean the clearing, burning or destruction of 0.5 or more hectares of forests
+within a 1 year period.
+
+## 3. Grant of Copyright License
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to You a
+perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and
+distribute the Work and such Derivative Works in Source or Object form.
+
+## 4. Grant of Patent License
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to You a
+perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
+section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer
+the Work, where such license applies only to those patent claims licensable by such Contributor that
+are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You institute patent litigation
+against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or
+a Contribution incorporated within the Work constitutes direct or contributory patent infringement,
+then any patent licenses granted to You under this License for that Work shall terminate as of the
+date such litigation is filed.
+
+## 5. Redistribution
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with
+or without modifications, and in Source or Object form, provided that You meet the following
+conditions:
+
+1. You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+2. You must cause any modified files to carry prominent notices stating that You changed the
+   files; and
+
+3. You must retain, in the Source form of any Derivative Works that You distribute, all copyright,
+   patent, trademark, and attribution notices from the Source form of the Work, excluding those
+   notices that do not pertain to any part of the Derivative Works; and
+
+4. Neither the name of the copyright holder nor the names of its contributors may be used to endorse
+   or promote products derived from this software without specific prior written permission; and
+
+5. This software must not be used by any organisation, website, product, or service that:
+   1. promotes, lobbies for or derives a majority of income from:
+         1. **abuses of human rights**:
+            * human trafficking
+            * sex trafficking
+            * slavery or indentured servitude
+            * discrimination based on age, gender, gender identity, race, sexuality, religion, nationality
+            * hate speech
+         2. **environmental destruction**:
+            * the extraction or sale of fossil fuels
+            * the destruction of habitats for threatened or endangered species, including through deforestation or burning of forests
+            * the abuse, inhumane killing or neglect of animals under human control
+            * industrial processes that generate waste products that threaten life
+         3. **conflict and war**:
+            * warfare
+            * war crimes
+            * weapons manufacturing
+            * violence (except when required to protect public safety)
+         4. **addictive or destructive products and services**:
+            * gambling
+            * tobacco
+            * products that encourage adversely addictive behaviours
+
+   2. dissuades, lobbies against, or derives a majority of income from actions that discourage or frustrate:
+      * peace
+      * access to the rights set out in the Universal Declaration of Human Rights and the Convention on the Rights of the Child
+      * democratic processes
+      * peaceful assembly and association (including worker associations)
+      * a sustainable environment
+   ; and
+
+5. If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative
+   Works that You distribute must include a readable copy of the attribution notices contained
+   within such NOTICE file, excluding those notices that do not pertain to any part of the
+   Derivative Works, in at least one of the following places: within a NOTICE text file
+   distributed as part of the Derivative Works; within the Source form or documentation, if
+   provided along with the Derivative Works; or, within a display generated by the Derivative
+   Works, if and wherever such third-party notices normally appear. The contents of the NOTICE
+   file are for informational purposes only and do not modify the License. You may add Your own
+   attribution notices within Derivative Works that You distribute, alongside or as an addendum to
+   the NOTICE text from the Work, provided that such additional attribution notices cannot be
+   construed as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide additional or
+different license terms and conditions for use, reproduction, or distribution of Your modifications,
+or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of
+the Work otherwise complies with the conditions stated in this License.
+
+## 6. Submission of Contributions
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the
+Work by You to the Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed with Licensor regarding such
+Contributions.
+
+## 7. Trademarks
+
+This License does not grant permission to use the trade names, trademarks, service marks, or product
+names of the Licensor, except as required for reasonable and customary use in describing the origin
+of the Work and reproducing the content of the NOTICE file.
+
+## 8. Disclaimer of Warranty
+
+Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied, including, without limitation, any warranties or conditions of
+TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely
+responsible for determining the appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+## 9. Limitation of Liability
+
+In no event and under no legal theory, whether in tort (including negligence), contract, or
+otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or
+agreed to in writing, shall any Contributor be liable to You for damages, including any direct,
+indirect, special, incidental, or consequential damages of any character arising as a result of this
+License or out of the use or inability to use the Work (including but not limited to damages for
+loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial
+damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+## 10. Accepting Warranty or Additional Liability
+
+While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee
+for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights
+consistent with this License. However, in accepting such obligations, You may act only on Your own
+behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You
+agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or
+claims asserted against, such Contributor by reason of your accepting any such warranty or
+additional liability.
+
+## Attribution
+
+Do No Harm License [Contributor Covenant], (pre 1.0),
+available at https://github.com/raisely/NoHarm

package/README.md

@@ -0,0 +1,318 @@
+# @mosaic-code/prisma-select-for-update
+
+A Prisma v7 extension that adds `SELECT ... FOR UPDATE` row locking functionality for PostgreSQL databases. This extension provides type-safe methods to lock rows during transactions, preventing concurrent modifications.
+
+## Features
+
+- **Type-safe row locking** - Three methods: `findUniqueForUpdate`, `findFirstForUpdate`, `findManyForUpdate`
+- **Multiple lock modes** - Support for `FOR UPDATE`, `FOR NO KEY UPDATE`, `FOR SHARE`, and `FOR KEY SHARE`
+- **NOWAIT and SKIP LOCKED** - Options for non-blocking lock acquisition
+- **Prisma-compatible API** - Works seamlessly with existing Prisma queries
+- **PostgreSQL-only** - Optimized for PostgreSQL's row-level locking
+
+## Installation
+
+```bash
+npm install @mosaic-code/prisma-select-for-update
+```
+
+**Peer Dependencies:**
+- `@prisma/client@^7.0.0`
+- `@prisma/adapter-pg@^7.0.0` (for PostgreSQL adapter)
+
+## Quick Start
+
+```typescript
+import { PrismaClient } from '@prisma/client'
+import { PrismaPg } from '@prisma/adapter-pg'
+import pg from 'pg'
+import { withForUpdate } from '@mosaic-code/prisma-select-for-update'
+
+const { Pool } = pg
+const pool = new Pool({ connectionString: process.env.DATABASE_URL })
+const adapter = new PrismaPg(pool)
+
+const basePrisma = new PrismaClient({ adapter })
+const prisma = basePrisma.$extends(withForUpdate())
+
+// Use within a transaction
+await prisma.$transaction(async (tx) => {
+  const user = await tx.user.findUniqueForUpdate({
+    where: { id: 1 },
+  })
+  
+  // User row is now locked - safe to modify
+  if (user && user.balance >= 100) {
+    await tx.user.update({
+      where: { id: user.id },
+      data: { balance: { decrement: 100 } },
+    })
+  }
+})
+```
+
+## API Reference
+
+### Methods
+
+All methods **must** be called within a `$transaction` callback. Calling them outside a transaction will throw an error.
+
+#### `findUniqueForUpdate`
+
+Locks and returns a single row by unique field(s).
+
+```typescript
+const user = await prisma.$transaction(async (tx) => {
+  return tx.user.findUniqueForUpdate({
+    where: { id: 1 },
+    select: { id: true, email: true }, // optional
+    lock: { mode: 'ForUpdate' }, // optional, defaults to ForNoKeyUpdate
+  })
+})
+```
+
+#### `findFirstForUpdate`
+
+Locks and returns the first matching row.
+
+```typescript
+const task = await prisma.$transaction(async (tx) => {
+  return tx.task.findFirstForUpdate({
+    where: { status: 'pending' },
+    orderBy: { priority: 'desc' },
+    lock: { skipLocked: true },
+  })
+})
+```
+
+#### `findManyForUpdate`
+
+Locks and returns multiple matching rows.
+
+```typescript
+const users = await prisma.$transaction(async (tx) => {
+  return tx.user.findManyForUpdate({
+    where: { balance: { gte: 100 } },
+    orderBy: { balance: 'asc' },
+    take: 10,
+    skip: 0,
+    lock: { mode: 'ForShare' },
+  })
+})
+```
+
+### Lock Options
+
+```typescript
+interface LockOptions {
+  /** Lock mode - defaults to 'ForNoKeyUpdate' */
+  mode?: 'ForUpdate' | 'ForNoKeyUpdate' | 'ForShare' | 'ForKeyShare'
+  /** Fail immediately if row is locked (NOWAIT) */
+  noWait?: boolean
+  /** Skip locked rows instead of waiting (SKIP LOCKED) */
+  skipLocked?: boolean
+}
+```
+
+#### Lock Modes
+
+- **`ForNoKeyUpdate`** (default) - Exclusive lock for non-key columns, allows other transactions to acquire `FOR KEY SHARE` locks. Less restrictive than `ForUpdate` and common for updates that don't modify key columns.
+- **`ForUpdate`** - Exclusive lock, prevents other transactions from modifying or locking the row
+- **`ForShare`** - Shared lock, allows other transactions to read but not modify
+- **`ForKeyShare`** - Weakest lock, allows other transactions to read and acquire `FOR KEY SHARE` locks
+
+#### NOWAIT and SKIP LOCKED
+
+```typescript
+// Fail immediately if row is locked
+const user = await prisma.$transaction(async (tx) => {
+  return tx.user.findUniqueForUpdate({
+    where: { id: 1 },
+    lock: { noWait: true }, // Throws error if row is locked
+  })
+})
+
+// Skip locked rows (useful for queue processing)
+const tasks = await prisma.$transaction(async (tx) => {
+  return tx.task.findManyForUpdate({
+    where: { status: 'pending' },
+    lock: { skipLocked: true }, // Returns only unlocked rows
+  })
+})
+```
+
+## Examples
+
+### Bank Account Transfer
+
+```typescript
+await prisma.$transaction(async (tx) => {
+  // Lock both accounts
+  const fromAccount = await tx.account.findUniqueForUpdate({
+    where: { id: fromAccountId },
+  })
+  const toAccount = await tx.account.findUniqueForUpdate({
+    where: { id: toAccountId },
+  })
+
+  if (!fromAccount || fromAccount.balance < amount) {
+    throw new Error('Insufficient funds')
+  }
+
+  // Update balances
+  await tx.account.update({
+    where: { id: fromAccountId },
+    data: { balance: { decrement: amount } },
+  })
+  await tx.account.update({
+    where: { id: toAccountId },
+    data: { balance: { increment: amount } },
+  })
+})
+```
+
+### Queue Processing with SKIP LOCKED
+
+```typescript
+// Worker 1
+const jobs1 = await prisma.$transaction(async (tx) => {
+  return tx.job.findManyForUpdate({
+    where: { status: 'pending' },
+    orderBy: { createdAt: 'asc' },
+    take: 10,
+    lock: { skipLocked: true }, // Skip rows locked by other workers
+  })
+})
+
+// Worker 2 (runs concurrently)
+const jobs2 = await prisma.$transaction(async (tx) => {
+  return tx.job.findManyForUpdate({
+    where: { status: 'pending' },
+    orderBy: { createdAt: 'asc' },
+    take: 10,
+    lock: { skipLocked: true }, // Gets different rows
+  })
+})
+```
+
+### Complex WHERE Clauses
+
+All standard Prisma where operators are supported:
+
+```typescript
+const users = await prisma.$transaction(async (tx) => {
+  return tx.user.findManyForUpdate({
+    where: {
+      OR: [
+        { balance: { gte: 1000 } },
+        { email: { contains: '@company.com' } },
+      ],
+      AND: [
+        { status: 'active' },
+        { createdAt: { gte: new Date('2024-01-01') } },
+      ],
+      NOT: {
+        role: 'admin',
+      },
+    },
+    orderBy: [{ balance: 'desc' }, { createdAt: 'asc' }],
+  })
+})
+```
+
+## Supported WHERE Operators
+
+- Equality: `equals`, `not`
+- Comparison: `lt`, `lte`, `gt`, `gte`
+- Arrays: `in`, `notIn`
+- Strings: `contains`, `startsWith`, `endsWith`
+- Logical: `AND`, `OR`, `NOT`
+- Null: `null`, `not: null`
+
+**Note:** String operators (`contains`, `startsWith`, `endsWith`) escape LIKE wildcards (`%`, `_`) to match Prisma's behavior. For custom LIKE patterns, use `$queryRaw` within your transaction.
+
+## Known Limitations
+
+1. **PostgreSQL-only** - This extension is designed specifically for PostgreSQL's row-level locking. MySQL and SQLite are not supported.
+
+2. **Case-insensitive matching** - The `mode: 'insensitive'` option is not supported. Use `$queryRaw` with `ILIKE` for case-insensitive matching:
+
+```typescript
+await prisma.$transaction(async (tx) => {
+  const users = await tx.$queryRaw`
+    SELECT * FROM "User" 
+    WHERE email ILIKE ${'%test%'} 
+    FOR UPDATE
+  `
+})
+```
+
+3. **Transaction required** - All `forUpdate` methods must be called within a transaction. This is enforced at runtime.
+
+4. **Relation filters** - Relation filters (e.g., `posts: { some: {...} }`) are not supported. Use joins or separate queries instead.
+
+## Type Safety
+
+The extension maintains full TypeScript type safety:
+
+```typescript
+const user = await prisma.$transaction(async (tx) => {
+  return tx.user.findUniqueForUpdate({
+    where: { id: 1 },
+    select: { id: true, email: true },
+  })
+})
+
+// Type: { id: number; email: string } | null
+```
+
+## Error Handling
+
+```typescript
+try {
+  await prisma.$transaction(async (tx) => {
+    return tx.user.findUniqueForUpdate({
+      where: { id: 1 },
+      lock: { noWait: true },
+    })
+  })
+} catch (error) {
+  if (error.message.includes('could not obtain lock')) {
+    // Row is locked by another transaction
+  }
+}
+```
+
+## Testing
+
+```bash
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+## Publishing
+
+To publish this package to npm:
+
+```bash
+# Build the package (runs automatically before publish)
+npm run build
+
+# Publish to npm
+npm publish
+```
+
+The `prepublishOnly` script ensures a clean build before publishing. Only the `dist` folder, `README.md`, and `LICENSE` are included in the published package.
+
+## License
+
+[Do No Harm](https://github.com/raisely/NoHarm)
+
+## Related
+
+- [Prisma Documentation](https://www.prisma.io/docs)
+- [PostgreSQL Row-Level Locking](https://www.postgresql.org/docs/current/explicit-locking.html)
+

package/dist/extension.d.ts

@@ -0,0 +1,17 @@
+import { Prisma } from '@prisma/client';
+import type { FindFirstForUpdateArgs, FindManyForUpdateArgs, FindUniqueForUpdateArgs } from './types.js';
+/**
+ * Create the Prisma extension with forUpdate methods
+ */
+export declare function withForUpdate(): (client: any) => {
+    $extends: {
+        extArgs: import(".prisma/client/runtime/client").InternalArgs<unknown, {
+            $allModels: {
+                findUniqueForUpdate<T, Args extends FindUniqueForUpdateArgs<T>>(this: T, args: Args): Promise<Prisma.Result<T, Args, "findUnique"> | null>;
+                findFirstForUpdate<T, Args extends FindFirstForUpdateArgs<T>>(this: T, args?: Args): Promise<Prisma.Result<T, Args, "findFirst"> | null>;
+                findManyForUpdate<T, Args extends FindManyForUpdateArgs<T>>(this: T, args?: Args): Promise<Prisma.Result<T, Args, "findMany">>;
+            };
+        }, {}, unknown>;
+    };
+};
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC,OAAO,KAAK,EAEV,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EAGxB,MAAM,YAAY,CAAA;AAqGnB;;GAEG;AACH,wBAAgB,aAAa;;;;oCAKK,CAAC,EAAE,IAAI,SAAS,uBAAuB,CAAC,CAAC,CAAC,QAC5D,CAAC,QACD,IAAI;mCAuBa,CAAC,EAAE,IAAI,SAAS,sBAAsB,CAAC,CAAC,CAAC,QAC1D,CAAC,SACD,IAAI;kCAwBY,CAAC,EAAE,IAAI,SAAS,qBAAqB,CAAC,CAAC,CAAC,QACxD,CAAC,SACD,IAAI;;;;EAyBnB"}

package/dist/extension.js

@@ -0,0 +1,128 @@
+import { Prisma } from '@prisma/client';
+import { buildSelectForUpdate } from './sql-builder.js';
+/**
+ * Get model metadata from DMMF
+ */
+function getModelMeta(modelName) {
+    const dmmf = Prisma.dmmf;
+    const model = dmmf.datamodel.models.find((m) => m.name.toLowerCase() === modelName.toLowerCase());
+    if (!model) {
+        throw new Error(`Model "${modelName}" not found in Prisma schema`);
+    }
+    return {
+        name: model.name,
+        dbName: model.dbName ?? null,
+        fields: model.fields.map((f) => ({
+            name: f.name,
+            kind: f.kind,
+            type: f.type,
+            dbName: f.dbName ?? null,
+            isId: f.isId ?? false,
+            isUnique: f.isUnique ?? false,
+        })),
+    };
+}
+/**
+ * Transform raw query result to match Prisma's camelCase field naming
+ */
+function transformResult(result, model) {
+    const transformed = {};
+    for (const [key, value] of Object.entries(result)) {
+        // Find field by dbName or name (case-insensitive for PostgreSQL)
+        const field = model.fields.find((f) => (f.dbName ?? f.name).toLowerCase() === key.toLowerCase() ||
+            f.name.toLowerCase() === key.toLowerCase());
+        if (field) {
+            transformed[field.name] = value;
+        }
+        else {
+            transformed[key] = value;
+        }
+    }
+    return transformed;
+}
+/**
+ * Check if we're in a transaction context
+ * Transaction clients do NOT have $transaction method (can't nest transactions)
+ */
+function isTransactionClient(client) {
+    // Transaction clients don't have $transaction method
+    // Base client has $transaction, transaction client doesn't
+    return !(client?.$transaction);
+}
+/**
+ * Get and validate execution context from Prisma extension
+ * Extracts model name, validates transaction context, and returns model metadata
+ */
+function getExecutionContext(thisArg) {
+    const context = Prisma.getExtensionContext(thisArg);
+    const modelName = context.$name;
+    if (!modelName) {
+        throw new Error('Could not determine model name from context');
+    }
+    const client = context.$parent;
+    // Check if we're in a transaction
+    if (!isTransactionClient(client)) {
+        throw new Error('forUpdate methods must be called within a transaction. ' +
+            'Use prisma.$transaction(async (tx) => { await tx.model.findUniqueForUpdate(...) })');
+    }
+    if (!client?.$queryRawUnsafe) {
+        throw new Error('$queryRawUnsafe not available on client');
+    }
+    const model = getModelMeta(modelName);
+    return { client, model, modelName };
+}
+/**
+ * Create the Prisma extension with forUpdate methods
+ */
+export function withForUpdate() {
+    return Prisma.defineExtension({
+        name: 'prisma-lock-for-update',
+        model: {
+            $allModels: {
+                async findUniqueForUpdate(args) {
+                    const { client, model } = getExecutionContext(this);
+                    const { sql, params } = buildSelectForUpdate(model, {
+                        where: args.where,
+                        select: args.select,
+                        lock: args.lock,
+                        take: 1, // findUnique should return at most 1 row
+                    });
+                    const results = await client.$queryRawUnsafe(sql, ...params);
+                    if (results.length === 0) {
+                        return null;
+                    }
+                    return transformResult(results[0], model);
+                },
+                async findFirstForUpdate(args = {}) {
+                    const { client, model } = getExecutionContext(this);
+                    const { sql, params } = buildSelectForUpdate(model, {
+                        where: args.where,
+                        select: args.select,
+                        orderBy: args.orderBy,
+                        lock: args.lock,
+                        take: 1, // findFirst returns at most 1 row
+                    });
+                    const results = await client.$queryRawUnsafe(sql, ...params);
+                    if (results.length === 0) {
+                        return null;
+                    }
+                    return transformResult(results[0], model);
+                },
+                async findManyForUpdate(args = {}) {
+                    const { client, model } = getExecutionContext(this);
+                    const { sql, params } = buildSelectForUpdate(model, {
+                        where: args.where,
+                        select: args.select,
+                        orderBy: args.orderBy,
+                        take: args.take,
+                        skip: args.skip,
+                        lock: args.lock,
+                    });
+                    const results = await client.$queryRawUnsafe(sql, ...params);
+                    return results.map((r) => transformResult(r, model));
+                },
+            },
+        },
+    });
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { withForUpdate } from './extension.js';
+export type { LockMode, LockOptions, FindUniqueForUpdateArgs, FindFirstForUpdateArgs, FindManyForUpdateArgs, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,YAAY,EACV,QAAQ,EACR,WAAW,EACX,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { withForUpdate } from './extension.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/sql-builder.d.ts

@@ -0,0 +1,41 @@
+import type { LockOptions, ModelMeta, SqlQuery } from './types.js';
+/**
+ * Quote a PostgreSQL identifier (table/column name)
+ * Implementation matches pg.escapeIdentifier (ported from PostgreSQL source)
+ * Escapes double quotes by doubling them: " becomes ""
+ */
+export declare function quoteIdentifier(name: string): string;
+/**
+ * Escape LIKE pattern wildcards to treat them as literal characters
+ * Escapes %, _, and \ characters to match Prisma's behavior
+ */
+export declare function escapeLikePattern(value: string): string;
+export declare function buildLockClause(lock?: LockOptions): string;
+/**
+ * Build SELECT clause from select option or return *
+ */
+export declare function buildSelectClause(model: ModelMeta, select?: Record<string, boolean>): string;
+/**
+ * Build ORDER BY clause from orderBy option
+ */
+export declare function buildOrderByClause(model: ModelMeta, orderBy?: Record<string, 'asc' | 'desc'> | Array<Record<string, 'asc' | 'desc'>>): string;
+/**
+ * Convert a Prisma where clause to SQL WHERE clause with parameters
+ * Supports common operators: equals, not, in, notIn, lt, lte, gt, gte, contains, startsWith, endsWith
+ */
+export declare function buildWhereClause(model: ModelMeta, where?: Record<string, unknown>, startParamIndex?: number): {
+    sql: string;
+    params: unknown[];
+};
+/**
+ * Build a complete SELECT ... FOR UPDATE query
+ */
+export declare function buildSelectForUpdate(model: ModelMeta, options: {
+    where?: Record<string, unknown>;
+    select?: Record<string, boolean>;
+    orderBy?: Record<string, 'asc' | 'desc'> | Array<Record<string, 'asc' | 'desc'>>;
+    take?: number;
+    skip?: number;
+    lock?: LockOptions;
+}): SqlQuery;
+//# sourceMappingURL=sql-builder.d.ts.map

package/dist/sql-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-builder.d.ts","sourceRoot":"","sources":["../src/sql-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE5E;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAqBD,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAW1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,GAC/E,MAAM,CAsBR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,eAAe,SAAI,GAClB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAoMpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAA;IAChF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB,GACA,QAAQ,CAgCV"}

package/dist/sql-builder.js

@@ -0,0 +1,304 @@
+/**
+ * Quote a PostgreSQL identifier (table/column name)
+ * Implementation matches pg.escapeIdentifier (ported from PostgreSQL source)
+ * Escapes double quotes by doubling them: " becomes ""
+ */
+export function quoteIdentifier(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+/**
+ * Escape LIKE pattern wildcards to treat them as literal characters
+ * Escapes %, _, and \ characters to match Prisma's behavior
+ */
+export function escapeLikePattern(value) {
+    return value.replace(/[%_\\]/g, '\\$&');
+}
+/**
+ * Get database field name for a model field
+ * Returns dbName if available, otherwise returns the field name
+ */
+function getDbFieldName(model, fieldName) {
+    const field = model.fields.find((f) => f.name === fieldName);
+    return field?.dbName ?? fieldName;
+}
+/**
+ * Get the SQL lock clause based on lock options
+ */
+const LOCK_MODE_SQL = {
+    ForUpdate: 'FOR UPDATE',
+    ForNoKeyUpdate: 'FOR NO KEY UPDATE',
+    ForShare: 'FOR SHARE',
+    ForKeyShare: 'FOR KEY SHARE',
+};
+export function buildLockClause(lock) {
+    const mode = lock?.mode ?? 'ForNoKeyUpdate';
+    let lockSql = LOCK_MODE_SQL[mode];
+    if (lock?.noWait) {
+        lockSql += ' NOWAIT';
+    }
+    else if (lock?.skipLocked) {
+        lockSql += ' SKIP LOCKED';
+    }
+    return lockSql;
+}
+/**
+ * Build SELECT clause from select option or return *
+ */
+export function buildSelectClause(model, select) {
+    if (!select) {
+        return '*';
+    }
+    const selectedFields = Object.entries(select)
+        .filter(([_, include]) => include)
+        .map(([fieldName]) => {
+        const dbName = getDbFieldName(model, fieldName);
+        return quoteIdentifier(dbName);
+    });
+    if (selectedFields.length === 0) {
+        return '*';
+    }
+    return selectedFields.join(', ');
+}
+/**
+ * Build ORDER BY clause from orderBy option
+ */
+export function buildOrderByClause(model, orderBy) {
+    if (!orderBy) {
+        return '';
+    }
+    const orderByList = Array.isArray(orderBy) ? orderBy : [orderBy];
+    if (orderByList.length === 0) {
+        return '';
+    }
+    const clauses = orderByList.flatMap((item) => Object.entries(item).map(([fieldName, direction]) => {
+        const dbName = getDbFieldName(model, fieldName);
+        return `${quoteIdentifier(dbName)} ${direction.toUpperCase()}`;
+    }));
+    if (clauses.length === 0) {
+        return '';
+    }
+    return `ORDER BY ${clauses.join(', ')}`;
+}
+/**
+ * Convert a Prisma where clause to SQL WHERE clause with parameters
+ * Supports common operators: equals, not, in, notIn, lt, lte, gt, gte, contains, startsWith, endsWith
+ */
+export function buildWhereClause(model, where, startParamIndex = 1) {
+    if (!where || Object.keys(where).length === 0) {
+        return { sql: '', params: [] };
+    }
+    const conditions = [];
+    const params = [];
+    let paramIndex = startParamIndex;
+    function processCondition(key, value) {
+        // Handle logical operators
+        if (key === 'AND' && Array.isArray(value)) {
+            const subConditions = [];
+            for (const v of value) {
+                const sub = buildWhereClause(model, v, paramIndex);
+                params.push(...sub.params);
+                paramIndex += sub.params.length;
+                subConditions.push(`(${sub.sql})`);
+            }
+            if (subConditions.length > 0) {
+                conditions.push(`(${subConditions.join(' AND ')})`);
+            }
+            return;
+        }
+        if (key === 'OR' && Array.isArray(value)) {
+            const subConditions = [];
+            for (const v of value) {
+                const sub = buildWhereClause(model, v, paramIndex);
+                params.push(...sub.params);
+                paramIndex += sub.params.length;
+                subConditions.push(`(${sub.sql})`);
+            }
+            if (subConditions.length > 0) {
+                conditions.push(`(${subConditions.join(' OR ')})`);
+            }
+            return;
+        }
+        if (key === 'NOT') {
+            const sub = buildWhereClause(model, value, paramIndex);
+            params.push(...sub.params);
+            paramIndex += sub.params.length;
+            conditions.push(`NOT (${sub.sql})`);
+            return;
+        }
+        // Regular field conditions
+        const field = model.fields.find((f) => f.name === key);
+        if (!field || field.kind !== 'scalar') {
+            return; // Skip non-scalar fields (relations)
+        }
+        const dbName = getDbFieldName(model, key);
+        const quotedName = quoteIdentifier(dbName);
+        if (value === null) {
+            conditions.push(`${quotedName} IS NULL`);
+            return;
+        }
+        if (typeof value !== 'object' || value instanceof Date) {
+            // Simple equality
+            conditions.push(`${quotedName} = $${paramIndex++}`);
+            params.push(value);
+            return;
+        }
+        // Object with operators
+        const ops = value;
+        for (const [op, opValue] of Object.entries(ops)) {
+            switch (op) {
+                case 'equals':
+                    if (opValue === null) {
+                        conditions.push(`${quotedName} IS NULL`);
+                    }
+                    else {
+                        conditions.push(`${quotedName} = $${paramIndex++}`);
+                        params.push(opValue);
+                    }
+                    break;
+                case 'not':
+                    if (opValue === null) {
+                        conditions.push(`${quotedName} IS NOT NULL`);
+                    }
+                    else if (typeof opValue === 'object' && opValue !== null) {
+                        // Nested not with operators
+                        for (const [nestedOp, nestedVal] of Object.entries(opValue)) {
+                            switch (nestedOp) {
+                                case 'equals':
+                                    conditions.push(`${quotedName} != $${paramIndex++}`);
+                                    params.push(nestedVal);
+                                    break;
+                                case 'in':
+                                    if (Array.isArray(nestedVal)) {
+                                        if (nestedVal.length === 0) {
+                                            // Empty array in NOT IN means match all rows
+                                            // Skip condition - no restriction
+                                        }
+                                        else {
+                                            const placeholders = nestedVal.map(() => `$${paramIndex++}`).join(', ');
+                                            conditions.push(`${quotedName} NOT IN (${placeholders})`);
+                                            params.push(...nestedVal);
+                                        }
+                                    }
+                                    break;
+                            }
+                        }
+                    }
+                    else {
+                        conditions.push(`${quotedName} != $${paramIndex++}`);
+                        params.push(opValue);
+                    }
+                    break;
+                case 'in':
+                    if (Array.isArray(opValue)) {
+                        if (opValue.length === 0) {
+                            // Empty array matches nothing (matches Prisma behavior)
+                            conditions.push('FALSE');
+                        }
+                        else {
+                            const placeholders = opValue.map(() => `$${paramIndex++}`).join(', ');
+                            conditions.push(`${quotedName} IN (${placeholders})`);
+                            params.push(...opValue);
+                        }
+                    }
+                    break;
+                case 'notIn':
+                    if (Array.isArray(opValue)) {
+                        if (opValue.length === 0) {
+                            // Empty notIn array matches all rows (matches Prisma behavior)
+                            // Skip condition - no restriction
+                        }
+                        else {
+                            const placeholders = opValue.map(() => `$${paramIndex++}`).join(', ');
+                            conditions.push(`${quotedName} NOT IN (${placeholders})`);
+                            params.push(...opValue);
+                        }
+                    }
+                    break;
+                case 'lt':
+                    conditions.push(`${quotedName} < $${paramIndex++}`);
+                    params.push(opValue);
+                    break;
+                case 'lte':
+                    conditions.push(`${quotedName} <= $${paramIndex++}`);
+                    params.push(opValue);
+                    break;
+                case 'gt':
+                    conditions.push(`${quotedName} > $${paramIndex++}`);
+                    params.push(opValue);
+                    break;
+                case 'gte':
+                    conditions.push(`${quotedName} >= $${paramIndex++}`);
+                    params.push(opValue);
+                    break;
+                case 'contains':
+                    if (typeof opValue !== 'string') {
+                        break;
+                    }
+                    conditions.push(`${quotedName} LIKE $${paramIndex++}`);
+                    params.push(`%${escapeLikePattern(opValue)}%`);
+                    break;
+                case 'startsWith':
+                    if (typeof opValue !== 'string') {
+                        break;
+                    }
+                    conditions.push(`${quotedName} LIKE $${paramIndex++}`);
+                    params.push(`${escapeLikePattern(opValue)}%`);
+                    break;
+                case 'endsWith':
+                    if (typeof opValue !== 'string') {
+                        break;
+                    }
+                    conditions.push(`${quotedName} LIKE $${paramIndex++}`);
+                    params.push(`%${escapeLikePattern(opValue)}`);
+                    break;
+                case 'mode':
+                    if (opValue === 'insensitive') {
+                        throw new Error('Case-insensitive mode is not supported. ' +
+                            'Use $queryRaw with ILIKE for case-insensitive matching, or use Prisma\'s standard query API.');
+                    }
+                    // Other mode values are ignored (default is case-sensitive)
+                    break;
+            }
+        }
+    }
+    for (const [key, value] of Object.entries(where)) {
+        processCondition(key, value);
+    }
+    if (conditions.length === 0) {
+        return { sql: '', params: [] };
+    }
+    return {
+        sql: conditions.join(' AND '),
+        params,
+    };
+}
+/**
+ * Build a complete SELECT ... FOR UPDATE query
+ */
+export function buildSelectForUpdate(model, options) {
+    const tableName = model.dbName ?? model.name;
+    const selectClause = buildSelectClause(model, options.select);
+    const { sql: whereSql, params } = buildWhereClause(model, options.where);
+    const orderByClause = buildOrderByClause(model, options.orderBy);
+    const lockClause = buildLockClause(options.lock);
+    let sql = `SELECT ${selectClause} FROM ${quoteIdentifier(tableName)}`;
+    if (whereSql) {
+        sql += ` WHERE ${whereSql}`;
+    }
+    if (orderByClause) {
+        sql += ` ${orderByClause}`;
+    }
+    // Handle LIMIT and OFFSET
+    let paramIndex = params.length + 1;
+    if (options.take !== undefined) {
+        sql += ` LIMIT $${paramIndex++}`;
+        params.push(options.take);
+    }
+    if (options.skip !== undefined) {
+        sql += ` OFFSET $${paramIndex++}`;
+        params.push(options.skip);
+    }
+    sql += ` ${lockClause}`;
+    return { sql, params };
+}
+//# sourceMappingURL=sql-builder.js.map

package/dist/sql-builder.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+import type { Prisma } from '@prisma/client';
+/**
+ * Lock modes supported by PostgreSQL
+ */
+export type LockMode = 'ForUpdate' | 'ForNoKeyUpdate' | 'ForShare' | 'ForKeyShare';
+/**
+ * Lock options for FOR UPDATE queries
+ */
+export interface LockOptions {
+    /** Lock mode - defaults to ForNoKeyUpdate */
+    mode?: LockMode;
+    /** Fail immediately if row is locked (NOWAIT) */
+    noWait?: boolean;
+    /** Skip locked rows instead of waiting (SKIP LOCKED) */
+    skipLocked?: boolean;
+}
+/**
+ * Arguments for findUniqueForUpdate
+ */
+export interface FindUniqueForUpdateArgs<T> {
+    where: Prisma.Args<T, 'findUnique'>['where'];
+    select?: Prisma.Args<T, 'findUnique'>['select'];
+    lock?: LockOptions;
+}
+/**
+ * Arguments for findFirstForUpdate
+ */
+export interface FindFirstForUpdateArgs<T> {
+    where?: Prisma.Args<T, 'findFirst'>['where'];
+    select?: Prisma.Args<T, 'findFirst'>['select'];
+    orderBy?: Prisma.Args<T, 'findFirst'>['orderBy'];
+    lock?: LockOptions;
+}
+/**
+ * Arguments for findManyForUpdate
+ */
+export interface FindManyForUpdateArgs<T> {
+    where?: Prisma.Args<T, 'findMany'>['where'];
+    select?: Prisma.Args<T, 'findMany'>['select'];
+    orderBy?: Prisma.Args<T, 'findMany'>['orderBy'];
+    take?: number;
+    skip?: number;
+    lock?: LockOptions;
+}
+/**
+ * SQL query result with parameterized values
+ */
+export interface SqlQuery {
+    sql: string;
+    params: unknown[];
+}
+/**
+ * Model metadata from DMMF
+ */
+export interface ModelField {
+    name: string;
+    kind: 'scalar' | 'object' | 'enum' | 'unsupported';
+    type: string;
+    dbName?: string | null;
+    isId?: boolean;
+    isUnique?: boolean;
+}
+export interface ModelMeta {
+    name: string;
+    dbName: string | null;
+    fields: ModelField[];
+}
+/**
+ * Transaction client interface for Prisma extensions
+ * Transaction clients don't have $transaction method (can't nest transactions)
+ */
+export interface TransactionClient {
+    $queryRawUnsafe: <R>(sql: string, ...params: unknown[]) => Promise<R[]>;
+}
+/**
+ * Extension context from Prisma.getExtensionContext
+ */
+export interface ExtensionContext {
+    $name: string;
+    $parent: TransactionClient;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,gBAAgB,GAChB,UAAU,GACV,aAAa,CAAA;AAEjB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC/C,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,SAAS,CAAC,CAAA;IAChD,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAA;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,iBAAiB,CAAA;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@mosaic-code/prisma-select-for-update",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Prisma v7 extension for SELECT ... FOR UPDATE row locking",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "db:up": "docker compose up -d",
+    "db:down": "docker compose down",
+    "db:push": "prisma db push",
+    "db:generate": "prisma generate",
+    "db:setup": "npm run db:up && sleep 2 && npm run db:push",
+    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
+    "release:patch": "npm run changelog && git add CHANGELOG.md && git commit -m \"chore: update changelog\" && npm version patch && git push --follow-tags && npm run build && npm publish",
+    "release:minor": "npm run changelog && git add CHANGELOG.md && git commit -m \"chore: update changelog\" && npm version minor && git push --follow-tags && npm run build && npm publish",
+    "release:major": "npm run changelog && git add CHANGELOG.md && git commit -m \"chore: update changelog\" && npm version major && git push --follow-tags && npm run build && npm publish",
+    "release:dry": "npm run changelog -- --dry-run"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@prisma/adapter-pg": "^7.0.0",
+    "@prisma/client": "^7.0.0",
+    "pg": "^8.0.0"
+  },
+  "devDependencies": {
+    "@prisma/adapter-pg": "^7.2.0",
+    "@prisma/client": "^7.0.0",
+    "@types/node": "^25.0.3",
+    "@types/pg": "^8.16.0",
+    "conventional-changelog-cli": "^5.0.0",
+    "dotenv": "^17.2.3",
+    "pg": "^8.16.3",
+    "prisma": "^7.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "prisma",
+    "for-update",
+    "row-locking",
+    "select-for-update",
+    "postgresql"
+  ],
+  "license": "NoHarm",
+  "packageManager": "npm@11.6.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mosaic-code-coop/prisma-select-for-update.git"
+  },
+  "homepage": "https://github.com/mosaic-code-coop/prisma-select-for-update#readme",
+  "bugs": {
+    "url": "https://github.com/mosaic-code-coop/prisma-select-for-update/issues"
+  },
+  "author": "Chris Jensen <2920476+chrisjensen@users.noreply.github.com> (https://github.com/chrisjensen)"
+}