@aburi/effects-prisma 0.4.1 → 0.4.2

package/dist/index.d.mts

@@ -1,53 +1,23 @@
 import { CallCandidate, ClassifyContext, Confidence, EffectClassification, EffectPlugin, ImportEdge, PluginContext } from "@aburi/types";
 
 //#region src/classify.d.ts
-/**
- * Classify a CallCandidate against Prisma Client conventions.
- *
- * Two shapes are accepted once the file imports a Prisma Client module (`hasPrismaImport`):
- *   - `<...>.<model>.<verb>` (3+ segments) — a model delegate call. The client segment is
- *     what separates it from two-segment collisions such as Express `router.create(...)`.
- *   - `<...>.$transaction` (2+ segments) — the transaction API on the client itself.
- *
- * The import gate is not a receiver check: `this.cache.items.delete(key)` is a `Map` and
- * `session.user.update(fields)` an object, both three segments with a delegate verb in a
- * file that also uses Prisma. A literal first argument rules a call out — no Prisma method
- * takes one — and the receiver plus argument count decide the tier, downgrading rather
- * than dropping (`receiverConfidence`). A model addressed through brackets arrives as
- * `<computed>` and supplies the third segment without a model, so there the receiver must
- * name a client outright.
- *
- * Throws on a malformed target (`assertNonEmptySegments`): an upstream contract violation,
- * not a classification decision. Pure with respect to plugin state (effect-plugin.md).
- */
 declare function classifyPrismaCall(call: CallCandidate, ctx: ClassifyContext): EffectClassification | null;
 //#endregion
 //#region src/constants.d.ts
-/** Plugin name: the manifest's `name` and the prefix of every thrown message. */
 declare const EFFECTS_PRISMA_PLUGIN_NAME: "effects-prisma";
-/** derivedBy namespace shared by the classifier's tag builder and the manifest. */
 declare const EFFECTS_PRISMA_DERIVED_BY_PREFIX: "effects-plugin:prisma";
 //#endregion
 //#region src/imports.d.ts
-/** True when the file imports a Prisma Client module; see `hasMatchingImport`. */
 declare function hasPrismaImport(imports: readonly ImportEdge[], filePath: string): boolean;
 //#endregion
 //#region src/manifest.d.ts
-/** See `defineEffectsManifest` for why `provides` claims no vocabulary of its own. */
 declare const effectsPrismaManifest: import("@aburi/plugin-registry/plugin-input").EffectsPluginManifest<"effects-prisma", "effects-plugin:prisma">;
 //#endregion
 //#region src/methods.d.ts
-/**
- * Prisma model delegate method vocabulary. Each `_LIST` is the single source of truth for
- * its union type and runtime `Set`. Only methods that map onto core `db.read` / `db.write`
- * are listed; metadata accessors, raw SQL escapes and connection lifecycle stay out, so the
- * plugin returns `null` for them and downstream effect plugins get a chance.
- */
 declare const PRISMA_READ_METHODS_LIST: readonly ["findUnique", "findUniqueOrThrow", "findFirst", "findFirstOrThrow", "findMany", "count", "aggregate", "groupBy"];
 declare const PRISMA_WRITE_METHODS_LIST: readonly ["create", "createMany", "createManyAndReturn", "update", "updateMany", "updateManyAndReturn", "upsert", "delete", "deleteMany"];
 type PrismaReadMethod = (typeof PRISMA_READ_METHODS_LIST)[number];
 type PrismaWriteMethod = (typeof PRISMA_WRITE_METHODS_LIST)[number];
-/** Top-level client method: `prisma.$transaction(...)`. Not nested under a model. */
 type PrismaTransactionMethod = "$transaction";
 declare const PRISMA_READ_METHODS: ReadonlySet<PrismaReadMethod>;
 declare const PRISMA_WRITE_METHODS: ReadonlySet<PrismaWriteMethod>;
@@ -57,46 +27,21 @@ declare function isPrismaWriteMethod(name: string): name is PrismaWriteMethod;
 declare function isPrismaTransactionMethod(name: string): name is PrismaTransactionMethod;
 //#endregion
 //#region src/plugin.d.ts
-/**
- * Prisma effect plugin: maps `prisma.<model>.<verb>` and `prisma.$transaction` call
- * expressions onto the core `db.read` / `db.write` / `db.transaction` vocabulary. `classify`
- * is pure (effect-plugin.md) and throws on a malformed CallCandidate — an
- * upstream contract violation, surfaced rather than swallowed.
- */
 declare class PrismaEffectsPlugin implements EffectPlugin {
   readonly manifest: import("@aburi/plugin-registry/plugin-input").EffectsPluginManifest<"effects-prisma", "effects-plugin:prisma">;
   init(_ctx: PluginContext): Promise<void>;
   classify(call: CallCandidate, ctx: ClassifyContext): EffectClassification | null;
 }
-/** Ready-to-register instance; left unannotated so the manifest literals stay visible. */
+/** Left unannotated so the manifest literals stay visible. */
 declare const prismaEffectsPlugin: PrismaEffectsPlugin;
 //#endregion
 //#region src/receivers.d.ts
-/**
- * The words a Prisma Client binding is spelled with. The callee string is all a classifier
- * sees (effect-plugin.md), and matching is per word (`identifierWords`): `prisma`,
- * `prismaClient`, `readReplicaDb` and `_prisma` count; `cache`, `router`, `items` and
- * `feedback` do not. `tx` / `trx` cover the interactive-transaction callback parameter.
- *
- * Deliberately absent: `client`, which would hand an SDK's `apiClient.users.update(payload)`
- * — spelled exactly like a delegate call — a high-confidence `db.write`; `transaction`,
- * which names a domain noun (`paymentTransaction`) far more often than a client; and
- * `datasource`, which `identifierWords("dataSource")` splits so only the all-lowercase form
- * ever matched. See docs/design/effect-plugin.md.
- */
 declare const PRISMA_CLIENT_WORDS_LIST: readonly ["prisma", "db", "database", "orm", "tx", "trx"];
 type PrismaClientWord = (typeof PRISMA_CLIENT_WORDS_LIST)[number];
 declare const PRISMA_CLIENT_WORDS: ReadonlySet<PrismaClientWord>;
-/** True when `segment` spells a word this package recognizes as a Prisma client binding. */
 declare function namesPrismaClient(segment: string): boolean;
-/**
- * The most arguments a Prisma call takes before it stops looking like Prisma's own API: a
- * delegate method takes one options object or nothing; `$transaction(fn, { timeout })`
- * takes two.
- */
 declare const PRISMA_DELEGATE_MAX_ARGUMENTS = 1;
 declare const PRISMA_TRANSACTION_MAX_ARGUMENTS = 2;
-/** `receiverConfidence` under this package's client vocabulary. */
 declare function classificationConfidence(clientSegment: string | undefined, call: CallCandidate, maxArguments: number): Confidence;
 //#endregion
 export { EFFECTS_PRISMA_DERIVED_BY_PREFIX, EFFECTS_PRISMA_PLUGIN_NAME, PRISMA_CLIENT_WORDS, PRISMA_DELEGATE_MAX_ARGUMENTS, PRISMA_READ_METHODS, PRISMA_TRANSACTION_MAX_ARGUMENTS, PRISMA_TRANSACTION_METHOD, PRISMA_WRITE_METHODS, type PrismaClientWord, PrismaEffectsPlugin, type PrismaReadMethod, type PrismaTransactionMethod, type PrismaWriteMethod, classificationConfidence, classifyPrismaCall, effectsPrismaManifest, hasPrismaImport, isPrismaReadMethod, isPrismaTransactionMethod, isPrismaWriteMethod, namesPrismaClient, prismaEffectsPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aburi/effects-prisma",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Aburi Prisma effects plugin: classifies prisma.<model>.<verb> and prisma.$transaction call expressions into core db.read / db.write / db.transaction effects",
   "license": "Apache-2.0",
   "author": "kage1020",
@@ -32,16 +32,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@aburi/plugin-registry": "0.5.0",
-    "@aburi/types": "0.5.0"
+    "@aburi/plugin-registry": "0.5.1",
+    "@aburi/types": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.1",
     "tsdown": "^0.22.3",
     "typescript": "^6.0.3",
     "vitest": "^4.1.11",
-    "@aburi/lang-typescript": "0.5.0",
-    "@aburi/test-support": "0.0.1"
+    "@aburi/core": "0.6.0",
+    "@aburi/lang-typescript": "0.6.0",
+    "@aburi/test-harness": "0.0.1",
+    "@aburi/test-support": "0.0.2"
   },
   "scripts": {
     "build": "tsdown",