@stacknext/prisma 0.0.0-stage → 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackNext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @stacknext/prisma
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Prisma Client query instrumentation for [StackNext](https://github.com/marrrkkk/stacknext).
+
+```ts
+import { PrismaClient } from '@prisma/client'
+import { instrumentPrismaClient } from '@stacknext/prisma'
+
+const prisma = new PrismaClient({
+  log: [{ emit: 'event', level: 'query' }],
+})
+
+const stop = instrumentPrismaClient(prisma, { databaseSystem: 'postgresql' })
+```
+
+Query text is redacted and bind parameters are never read. Registration is
+idempotent for the same client and returns a cleanup function.
+
+The package is ESM-only and requires Node.js 20.9 or newer. `@prisma/client` is
+an optional peer dependency.
+
+License: MIT.

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { type StackNextTransport } from '@stacknext/core/transport';
+/** Structural subset of Prisma's `$on('query')` event. */
+export interface PrismaQueryEventLike {
+    timestamp: Date;
+    query: string;
+    /** Prisma passes bind parameters as a JSON string. They are never read. */
+    params: string;
+    duration: number;
+    target: string;
+}
+/** Structural subset of PrismaClient needed for instrumentation. */
+export interface PrismaClientLike {
+    $on(event: 'query', callback: (event: PrismaQueryEventLike) => void): void;
+}
+export interface StackNextPrismaOptions {
+    /** Database engine reported to StackNext, for example "postgresql". */
+    databaseSystem?: string;
+    /** Override the process-wide transport (mostly for tests). */
+    transport?: Pick<StackNextTransport, 'enqueueDatabaseQuery'>;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Subscribes to Prisma query events:
+ *
+ * ```ts
+ * const prisma = new PrismaClient()
+ * instrumentPrismaClient(prisma, { databaseSystem: 'sqlite' })
+ * ```
+ *
+ * Query text is redacted; bind parameters are never read or transmitted.
+ * Returns a cleanup function and is idempotent for the same client instance.
+ */
+export declare function instrumentPrismaClient(client: PrismaClientLike, options?: StackNextPrismaOptions): () => void;
+//# 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":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAA;AAElC,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,IAAI,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI,CAAA;CAC3E;AAED,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAA;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AAWD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,sBAA2B,GACnC,MAAM,IAAI,CAkDZ"}

package/dist/index.js

@@ -0,0 +1,72 @@
+import { randomUUID } from 'node:crypto';
+import { isSpanContextValid, trace } from '@opentelemetry/api';
+import { redactSql } from '@stacknext/core';
+import { getStackNextTransport, } from '@stacknext/core/transport';
+const instrumented = new WeakSet();
+const OPERATION_PATTERN = /^\s*(select|insert|update|delete|with|begin|commit|rollback)\b/i;
+function inferOperation(sql) {
+    return OPERATION_PATTERN.exec(sql)?.[1]?.toLowerCase();
+}
+/**
+ * Subscribes to Prisma query events:
+ *
+ * ```ts
+ * const prisma = new PrismaClient()
+ * instrumentPrismaClient(prisma, { databaseSystem: 'sqlite' })
+ * ```
+ *
+ * Query text is redacted; bind parameters are never read or transmitted.
+ * Returns a cleanup function and is idempotent for the same client instance.
+ */
+export function instrumentPrismaClient(client, options = {}) {
+    if (instrumented.has(client))
+        return () => undefined;
+    instrumented.add(client);
+    const databaseSystem = options.databaseSystem ?? 'prisma';
+    let disposed = false;
+    const listener = (event) => {
+        if (disposed)
+            return;
+        try {
+            const transport = options.transport ?? getStackNextTransport();
+            if (!transport)
+                return;
+            const activeSpan = trace.getActiveSpan();
+            const spanContext = activeSpan?.spanContext();
+            const operation = inferOperation(event.query);
+            const duration = typeof event.duration === 'number' && Number.isFinite(event.duration)
+                ? Math.max(0, event.duration)
+                : null;
+            const input = {
+                id: randomUUID(),
+                ...(spanContext && isSpanContextValid(spanContext)
+                    ? { traceId: spanContext.traceId, spanId: spanContext.spanId }
+                    : {}),
+                timestamp: event.timestamp instanceof Date && Number.isFinite(event.timestamp.getTime())
+                    ? event.timestamp.getTime()
+                    : Date.now(),
+                durationMs: duration,
+                sql: redactSql(event.query).slice(0, 20_000),
+                databaseSystem,
+                ...(operation ? { operation } : {}),
+                success: true,
+                source: 'prisma',
+                attributes: {
+                    'db.system.name': databaseSystem,
+                    'db.duration.measured': duration !== null,
+                    ...(event.target ? { 'db.prisma.target': event.target.slice(0, 200) } : {}),
+                },
+            };
+            transport.enqueueDatabaseQuery(input);
+        }
+        catch (error) {
+            options.onError?.(error);
+        }
+    };
+    client.$on('query', listener);
+    return () => {
+        disposed = true;
+        instrumented.delete(client);
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@stacknext/prisma",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.0",
+  "description": "Prisma Client query instrumentation adapter for StackNext",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@stacknext/core": "0.6.0",
+    "@opentelemetry/api": "1.9.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/sdk-trace-node": "2.12.0"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "author": "StackNext contributors",
+  "homepage": "https://github.com/marrrkkk/stacknext#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marrrkkk/stacknext.git",
+    "directory": "packages/prisma"
+  },
+  "bugs": {
+    "url": "https://github.com/marrrkkk/stacknext/issues"
+  },
+  "keywords": [
+    "stacknext",
+    "nextjs",
+    "prisma",
+    "sql",
+    "observability"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@prisma/client": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@prisma/client": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }