@docker-harpoon/prisma 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @harpoon/prisma
+ *
+ * Prisma binding for Harpoon.
+ *
+ * Provides:
+ * - PrismaBinding: Attaches to database containers for connection strings and migrations
+ * - Config patchers for Prisma v7 LibSQL support
+ * - Dockerfile transformers for prisma commands in monorepos
+ */
+import { Effect } from 'effect';
+import type { Binding, PatchContext, PatchResult, DockerfileInstruction, TransformContext } from '@harpoon/core';
+export { prismaV7LibSqlPatcher } from './patchers/prisma-v7-libsql';
+export { prismaTransformers, prismaPackageManagerTransformer, prismaConditionalSeedTransformer, } from './transformers/prisma';
+export interface PrismaBindingOptions {
+    /** Run prisma migrate deploy on container start */
+    migrate?: boolean;
+    /** Run prisma db push on container start */
+    push?: boolean;
+    /** Run prisma generate on container start */
+    generate?: boolean;
+    /** Path to prisma schema (default: ./prisma/schema.prisma) */
+    schema?: string;
+    /** Custom database URL override */
+    databaseUrl?: string;
+}
+export interface DatabaseLike {
+    connectionString: string;
+}
+/**
+ * Creates a Prisma binding that attaches to a database container.
+ *
+ * Provides:
+ * - DATABASE_URL environment variable
+ * - Optional migration/generation on container start
+ * - Dockerfile transformations for Prisma commands
+ *
+ * @example
+ * ```typescript
+ * import { database, Container } from '@harpoon/core';
+ * import { PrismaBinding } from '@harpoon/prisma';
+ *
+ * const db = await database("postgres", {
+ *   image: "postgres:15",
+ *   env: { POSTGRES_PASSWORD: "secret" },
+ * });
+ *
+ * const app = await Container("app", {
+ *   image: appImage,
+ *   bindings: {
+ *     DB: PrismaBinding(db, { migrate: true }),
+ *   },
+ * });
+ * ```
+ */
+/**
+ * Extended binding interface that includes build-time capabilities.
+ * Unlike BuildBinding, this allows a resource to be attached.
+ */
+interface PrismaBindingResult<TDb> extends Binding<TDb, {
+    DATABASE_URL: string;
+}> {
+    transformDockerfile(instructions: readonly DockerfileInstruction[], ctx: TransformContext): readonly DockerfileInstruction[];
+    patchConfig(ctx: PatchContext): Effect.Effect<PatchResult, Error>;
+}
+export declare function PrismaBinding<TDb extends DatabaseLike>(db: TDb, options?: PrismaBindingOptions): PrismaBindingResult<TDb>;
+/**
+ * Register all Prisma patchers and transformers with Harpoon's registries.
+ *
+ * Call this once at application startup if you want the patchers and
+ * transformers to be available globally.
+ *
+ * @example
+ * ```typescript
+ * import { registerPrismaPlugins } from '@harpoon/prisma';
+ *
+ * registerPrismaPlugins();
+ * ```
+ */
+export declare function registerPrismaPlugins(): void;
+export default PrismaBinding;
+//# 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;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAGjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;;;GAGG;AACH,UAAU,mBAAmB,CAAC,GAAG,CAAE,SAAQ,OAAO,CAAC,GAAG,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;IAC/E,mBAAmB,CACjB,YAAY,EAAE,SAAS,qBAAqB,EAAE,EAC9C,GAAG,EAAE,gBAAgB,GACpB,SAAS,qBAAqB,EAAE,CAAC;IACpC,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;CACnE;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAS,YAAY,EACpD,EAAE,EAAE,GAAG,EACP,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAAC,GAAG,CAAC,CA6E1B;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAiB5C;AAED,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,103 @@
+/**
+ * @harpoon/prisma
+ *
+ * Prisma binding for Harpoon.
+ *
+ * Provides:
+ * - PrismaBinding: Attaches to database containers for connection strings and migrations
+ * - Config patchers for Prisma v7 LibSQL support
+ * - Dockerfile transformers for prisma commands in monorepos
+ */
+import { Effect } from 'effect';
+// Re-export patchers and transformers
+export { prismaV7LibSqlPatcher } from './patchers/prisma-v7-libsql';
+export { prismaTransformers, prismaPackageManagerTransformer, prismaConditionalSeedTransformer, } from './transformers/prisma';
+export function PrismaBinding(db, options = {}) {
+    const databaseUrl = options.databaseUrl ?? db.connectionString;
+    return {
+        type: 'prisma',
+        resource: db,
+        getEnv() {
+            return {
+                DATABASE_URL: databaseUrl,
+            };
+        },
+        onStart(_container) {
+            return Effect.gen(function* () {
+                if (options.generate) {
+                    console.log(`[PrismaBinding] Running prisma generate...`);
+                    // In a real implementation, this would exec into the container
+                    // For now, this is a placeholder for the hook
+                }
+                if (options.migrate) {
+                    console.log(`[PrismaBinding] Running prisma migrate deploy...`);
+                    // In a real implementation, this would exec into the container
+                }
+                if (options.push) {
+                    console.log(`[PrismaBinding] Running prisma db push...`);
+                    // In a real implementation, this would exec into the container
+                }
+            });
+        },
+        // Build-time transformations (for when building images with Prisma)
+        transformDockerfile(instructions, ctx) {
+            // Import and apply prisma transformers
+            const { prismaTransformers } = require('./transformers/prisma');
+            let result = [...instructions];
+            for (const transformer of prismaTransformers) {
+                result = result.flatMap((inst) => {
+                    if (!transformer.handlesTypes.includes(inst.type)) {
+                        return [inst];
+                    }
+                    if (!transformer.matches(inst, ctx)) {
+                        return [inst];
+                    }
+                    const transformed = transformer.transform(inst, ctx);
+                    return Array.isArray(transformed) ? [...transformed] : [transformed];
+                });
+            }
+            return result;
+        },
+        patchConfig(ctx) {
+            const { prismaV7LibSqlPatcher } = require('./patchers/prisma-v7-libsql');
+            return Effect.gen(function* () {
+                const shouldApply = yield* prismaV7LibSqlPatcher.shouldApply(ctx);
+                if (!shouldApply) {
+                    return {
+                        applied: false,
+                        modifiedFiles: [],
+                        description: 'Prisma v7 not detected',
+                    };
+                }
+                return yield* prismaV7LibSqlPatcher.apply(ctx);
+            });
+        },
+    };
+}
+// ============ Registration Helpers ============
+/**
+ * Register all Prisma patchers and transformers with Harpoon's registries.
+ *
+ * Call this once at application startup if you want the patchers and
+ * transformers to be available globally.
+ *
+ * @example
+ * ```typescript
+ * import { registerPrismaPlugins } from '@harpoon/prisma';
+ *
+ * registerPrismaPlugins();
+ * ```
+ */
+export function registerPrismaPlugins() {
+    // Dynamic imports to avoid circular dependencies
+    const core = require('@harpoon/core');
+    const { prismaV7LibSqlPatcher } = require('./patchers/prisma-v7-libsql');
+    const { prismaTransformers } = require('./transformers/prisma');
+    // Register config patcher
+    core.registerConfigPatcher(prismaV7LibSqlPatcher);
+    // Register transformers
+    for (const transformer of prismaTransformers) {
+        core.registerTransformer(transformer);
+    }
+}
+export default PrismaBinding;

package/dist/patchers/prisma-v7-libsql.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Prisma V7 LibSQL Config Patcher
+ *
+ * Patches Prisma v7 libsql-config.ts to include authToken support.
+ * Also patches prisma.config.ts for LibSQL configuration.
+ */
+import type { ConfigPatcher } from '@harpoon/core';
+/**
+ * Prisma V7 LibSQL patcher.
+ *
+ * Patches:
+ * - prisma/libsql-config.ts: Adds SQL_TOKEN/authToken support
+ * - prisma.config.ts: Ensures LibSQL configuration is correct
+ */
+export declare const prismaV7LibSqlPatcher: ConfigPatcher;
+export default prismaV7LibSqlPatcher;
+//# sourceMappingURL=prisma-v7-libsql.d.ts.map

package/dist/patchers/prisma-v7-libsql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-v7-libsql.d.ts","sourceRoot":"","sources":["../../src/patchers/prisma-v7-libsql.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,eAAe,CAAC;AAsE9E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA0DnC,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/patchers/prisma-v7-libsql.js

@@ -0,0 +1,103 @@
+/**
+ * Prisma V7 LibSQL Config Patcher
+ *
+ * Patches Prisma v7 libsql-config.ts to include authToken support.
+ * Also patches prisma.config.ts for LibSQL configuration.
+ */
+import { Effect } from 'effect';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { ConfigPatchError } from '@harpoon/core';
+// ============ Helper Functions ============
+/**
+ * Check if the project uses Prisma v7.
+ */
+async function isPrismaV7(packageJsonPath) {
+    try {
+        const appPackageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));
+        const prismaVersion = appPackageJson.dependencies?.['prisma'] ||
+            appPackageJson.devDependencies?.['prisma'];
+        return !!(prismaVersion && prismaVersion.startsWith('^7.'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Patch the libsql-config.ts file to include authToken support.
+ */
+async function patchLibSqlConfig(libsqlConfigPath, appName) {
+    try {
+        const libsqlConfig = await fs.readFile(libsqlConfigPath, 'utf-8');
+        const patched = libsqlConfig.replace(/^(\s+)return \{\s*url: env\.DATABASE_URL,\s*\};$/m, (match, indent) => {
+            return `${indent}return {
+${indent}  url: env.DATABASE_URL,
+${indent}  ...(env.SQL_TOKEN ? { authToken: env.SQL_TOKEN } : {}),
+${indent}};`;
+        });
+        if (patched !== libsqlConfig) {
+            await fs.writeFile(libsqlConfigPath, patched);
+            console.log(`[ConfigPatcher] Patched Prisma v7 libsql-config.ts for ${appName}`);
+            return { patched: true, path: libsqlConfigPath };
+        }
+    }
+    catch {
+        // File doesn't exist or error, skip silently
+    }
+    return { patched: false, path: libsqlConfigPath };
+}
+/**
+ * Check if prisma.config.ts needs patching.
+ */
+async function checkPrismaConfig(prismaConfigPath) {
+    try {
+        const prismaConfig = await fs.readFile(prismaConfigPath, 'utf-8');
+        // Check if it's already using LibSQL properly
+        return !prismaConfig.includes('new PrismaLibSql(createLibSqlConfig())');
+    }
+    catch {
+        return false;
+    }
+}
+// ============ Patcher Implementation ============
+/**
+ * Prisma V7 LibSQL patcher.
+ *
+ * Patches:
+ * - prisma/libsql-config.ts: Adds SQL_TOKEN/authToken support
+ * - prisma.config.ts: Ensures LibSQL configuration is correct
+ */
+export const prismaV7LibSqlPatcher = {
+    name: 'prisma-v7-libsql',
+    description: 'Patches Prisma v7 LibSQL configuration for authToken support',
+    shouldApply: (ctx) => Effect.tryPromise({
+        try: () => isPrismaV7(ctx.packageJsonPath),
+        catch: (error) => new ConfigPatchError('prisma-v7-libsql', `Failed to check Prisma version: ${error}`, error instanceof Error ? error : undefined),
+    }),
+    apply: (ctx) => Effect.tryPromise({
+        try: async () => {
+            const modifiedFiles = [];
+            // Patch libsql-config.ts
+            const libsqlConfigPath = path.join(ctx.appDir, 'prisma', 'libsql-config.ts');
+            const libsqlResult = await patchLibSqlConfig(libsqlConfigPath, ctx.appName);
+            if (libsqlResult.patched) {
+                modifiedFiles.push(libsqlResult.path);
+            }
+            // Check prisma.config.ts (only report, don't modify)
+            const prismaConfigPath = path.join(ctx.appDir, 'prisma.config.ts');
+            const needsPrismaPatch = await checkPrismaConfig(prismaConfigPath);
+            if (needsPrismaPatch) {
+                console.log(`[ConfigPatcher] prisma.config.ts may need manual review for ${ctx.appName}`);
+            }
+            return {
+                applied: modifiedFiles.length > 0,
+                modifiedFiles: Object.freeze(modifiedFiles),
+                description: modifiedFiles.length > 0
+                    ? `Patched ${modifiedFiles.length} file(s) for Prisma v7 LibSQL support`
+                    : 'No files needed patching',
+            };
+        },
+        catch: (error) => new ConfigPatchError('prisma-v7-libsql', `Failed to apply Prisma v7 LibSQL patches: ${error}`, error instanceof Error ? error : undefined),
+    }),
+};
+export default prismaV7LibSqlPatcher;

package/dist/transformers/prisma.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Prisma Dockerfile Transformers
+ *
+ * Transforms for Prisma-related RUN commands in Dockerfiles.
+ * Handles prisma:generate, prisma:seed, and exec prisma commands.
+ *
+ * Package-manager agnostic: supports npm, yarn, pnpm, and bun.
+ */
+import type { InstructionTransformer } from '@harpoon/core';
+/**
+ * Transforms package manager prisma commands to include cd to app directory.
+ * Handles: prisma:generate, prisma:seed, exec prisma, run build
+ * Supports: npm, yarn, pnpm, bun
+ */
+export declare const prismaPackageManagerTransformer: InstructionTransformer;
+/**
+ * Transforms conditional prisma:seed commands.
+ * Handles: if [ "$ENV" = "..." ]; then {npm|yarn|pnpm|bun} prisma:seed; fi
+ */
+export declare const prismaConditionalSeedTransformer: InstructionTransformer;
+/**
+ * All Prisma transformers for easy registration.
+ */
+export declare const prismaTransformers: readonly InstructionTransformer[];
+export default prismaTransformers;
+//# sourceMappingURL=prisma.d.ts.map

package/dist/transformers/prisma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/transformers/prisma.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA2C,MAAM,eAAe,CAAC;AA4BrG;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,sBA0B7C,CAAC;AAOF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,sBA0B9C,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,sBAAsB,EAG9D,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/transformers/prisma.js

@@ -0,0 +1,87 @@
+/**
+ * Prisma Dockerfile Transformers
+ *
+ * Transforms for Prisma-related RUN commands in Dockerfiles.
+ * Handles prisma:generate, prisma:seed, and exec prisma commands.
+ *
+ * Package-manager agnostic: supports npm, yarn, pnpm, and bun.
+ */
+import { replaceInstruction } from '@harpoon/core';
+// ============ Helper Functions ============
+/**
+ * Package manager prefixes we recognize.
+ */
+const PACKAGE_MANAGERS = ['npm', 'yarn', 'pnpm', 'bun'];
+/**
+ * Check if instruction uses a known package manager.
+ */
+function isPackageManagerCommand(inst) {
+    const firstArg = inst.args[0] || '';
+    return PACKAGE_MANAGERS.some(pm => firstArg.startsWith(pm));
+}
+/**
+ * Check if command already has cd to app directory.
+ */
+function alreadyHasCd(inst, appName) {
+    const originalCmd = inst.original.replace(/^RUN\s+/, '');
+    return originalCmd.includes(`cd apps/${appName}`);
+}
+// ============ Transformers ============
+/**
+ * Transforms package manager prisma commands to include cd to app directory.
+ * Handles: prisma:generate, prisma:seed, exec prisma, run build
+ * Supports: npm, yarn, pnpm, bun
+ */
+export const prismaPackageManagerTransformer = {
+    name: 'prisma-package-manager',
+    description: 'Transforms package manager prisma commands for monorepo structure',
+    handlesTypes: ['RUN'],
+    matches: (inst, ctx) => {
+        if (!isPackageManagerCommand(inst))
+            return false;
+        if (alreadyHasCd(inst, ctx.appName))
+            return false;
+        const runCmd = inst.args.join(' ');
+        return (runCmd.includes('prisma:generate') ||
+            runCmd.includes('prisma:seed') ||
+            runCmd.includes('exec prisma') ||
+            runCmd.includes('run build'));
+    },
+    transform: (inst, ctx) => {
+        const originalCmd = inst.original.replace(/^RUN\s+/, '');
+        return replaceInstruction(inst, `RUN cd apps/${ctx.appName} && ${originalCmd}`, Object.freeze([`cd apps/${ctx.appName} && ${originalCmd}`]));
+    },
+};
+/**
+ * Pattern to match any package manager with prisma:seed.
+ */
+const PRISMA_SEED_PATTERN = /(npm|yarn|pnpm|bun)\s+(run\s+)?prisma:seed/;
+/**
+ * Transforms conditional prisma:seed commands.
+ * Handles: if [ "$ENV" = "..." ]; then {npm|yarn|pnpm|bun} prisma:seed; fi
+ */
+export const prismaConditionalSeedTransformer = {
+    name: 'prisma-conditional-seed',
+    description: 'Transforms conditional prisma:seed commands for monorepo structure',
+    handlesTypes: ['RUN'],
+    matches: (inst, ctx) => {
+        const originalCmd = inst.original.replace(/^RUN\s+/, '');
+        return (PRISMA_SEED_PATTERN.test(originalCmd) &&
+            !originalCmd.includes(`cd apps/${ctx.appName}`));
+    },
+    transform: (inst, ctx) => {
+        const originalCmd = inst.original.replace(/^RUN\s+/, '');
+        // Replace any package manager prisma:seed with cd + command
+        const transformedCmd = originalCmd.replace(new RegExp(PRISMA_SEED_PATTERN.source, 'g'), `cd apps/${ctx.appName} && $&`);
+        return replaceInstruction(inst, `RUN ${transformedCmd}`, Object.freeze([transformedCmd]));
+    },
+};
+// ============ Exports ============
+/**
+ * All Prisma transformers for easy registration.
+ */
+export const prismaTransformers = Object.freeze([
+    prismaPackageManagerTransformer,
+    prismaConditionalSeedTransformer,
+]);
+export default prismaTransformers;

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@docker-harpoon/prisma",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "Prisma binding for Harpoon - database migrations and Dockerfile transformations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "effect": "^3.19.14"
+  },
+  "peerDependencies": {
+    "@docker-harpoon/core": ">=0.1.0",
+    "bun": ">=1.0.0"
+  }
+}