@docker-harpoon/nextjs 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @harpoon/nextjs
+ *
+ * Next.js binding for Harpoon.
+ *
+ * Provides:
+ * - NextjsBinding: Build-time transformations for Next.js standalone output
+ * - Dockerfile transformers for .next/standalone paths
+ */
+import type { BuildBinding } from '@harpoon/core';
+export { nextjsTransformers, nextjsPublicTransformer, nextjsStaticTransformer, nextjsStandaloneTransformer, nextjsCmdTransformer, } from './transformers/nextjs';
+export interface NextjsBindingOptions {
+    /** Enable standalone output transformations (default: true) */
+    standalone?: boolean;
+    /** Custom output directory (default: .next) */
+    outputDir?: string;
+}
+/**
+ * Creates a Next.js binding for build-time Dockerfile transformations.
+ *
+ * This binding transforms Dockerfile instructions to work with Next.js
+ * standalone output in a monorepo structure.
+ *
+ * @example
+ * ```typescript
+ * import { Image } from '@harpoon/core';
+ * import { NextjsBinding } from '@harpoon/nextjs';
+ * import { MonorepoBinding } from '@harpoon/monorepo';
+ *
+ * // Build image with Next.js transformations
+ * const appImage = await Image("my-nextjs-app:latest", {
+ *   context: "./app",
+ *   bindings: {
+ *     NEXTJS: NextjsBinding({ standalone: true }),
+ *     MONOREPO: MonorepoBinding({ appName: "web" }),
+ *   },
+ * });
+ * ```
+ */
+export declare function NextjsBinding(options?: NextjsBindingOptions): BuildBinding<Record<string, never>>;
+/**
+ * Register all Next.js transformers with Harpoon's registry.
+ *
+ * Call this once at application startup if you want the transformers
+ * to be available globally.
+ *
+ * @example
+ * ```typescript
+ * import { registerNextjsPlugins } from '@harpoon/nextjs';
+ *
+ * registerNextjsPlugins();
+ * ```
+ */
+export declare function registerNextjsPlugins(): void;
+export default NextjsBinding;
+//# 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;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,oBAAyB,GACjC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CA8CrC;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAU5C;AAED,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,92 @@
+/**
+ * @harpoon/nextjs
+ *
+ * Next.js binding for Harpoon.
+ *
+ * Provides:
+ * - NextjsBinding: Build-time transformations for Next.js standalone output
+ * - Dockerfile transformers for .next/standalone paths
+ */
+// Re-export transformers
+export { nextjsTransformers, nextjsPublicTransformer, nextjsStaticTransformer, nextjsStandaloneTransformer, nextjsCmdTransformer, } from './transformers/nextjs';
+// ============ Binding Implementation ============
+/**
+ * Creates a Next.js binding for build-time Dockerfile transformations.
+ *
+ * This binding transforms Dockerfile instructions to work with Next.js
+ * standalone output in a monorepo structure.
+ *
+ * @example
+ * ```typescript
+ * import { Image } from '@harpoon/core';
+ * import { NextjsBinding } from '@harpoon/nextjs';
+ * import { MonorepoBinding } from '@harpoon/monorepo';
+ *
+ * // Build image with Next.js transformations
+ * const appImage = await Image("my-nextjs-app:latest", {
+ *   context: "./app",
+ *   bindings: {
+ *     NEXTJS: NextjsBinding({ standalone: true }),
+ *     MONOREPO: MonorepoBinding({ appName: "web" }),
+ *   },
+ * });
+ * ```
+ */
+export function NextjsBinding(options = {}) {
+    const standalone = options.standalone !== false;
+    return {
+        type: 'nextjs',
+        resource: undefined,
+        getEnv() {
+            return {};
+        },
+        transformDockerfile(instructions, ctx) {
+            if (!standalone) {
+                return instructions;
+            }
+            // Mark context as standalone app for transformers
+            const standaloneCtx = {
+                ...ctx,
+                isStandaloneApp: true,
+            };
+            // Import and apply nextjs transformers
+            const { nextjsTransformers } = require('./transformers/nextjs');
+            let result = [...instructions];
+            for (const transformer of nextjsTransformers) {
+                result = result.flatMap((inst) => {
+                    if (!transformer.handlesTypes.includes(inst.type)) {
+                        return [inst];
+                    }
+                    if (!transformer.matches(inst, standaloneCtx)) {
+                        return [inst];
+                    }
+                    const transformed = transformer.transform(inst, standaloneCtx);
+                    return Array.isArray(transformed) ? [...transformed] : [transformed];
+                });
+            }
+            return result;
+        },
+    };
+}
+// ============ Registration Helpers ============
+/**
+ * Register all Next.js transformers with Harpoon's registry.
+ *
+ * Call this once at application startup if you want the transformers
+ * to be available globally.
+ *
+ * @example
+ * ```typescript
+ * import { registerNextjsPlugins } from '@harpoon/nextjs';
+ *
+ * registerNextjsPlugins();
+ * ```
+ */
+export function registerNextjsPlugins() {
+    const core = require('@harpoon/core');
+    const { nextjsTransformers } = require('./transformers/nextjs');
+    for (const transformer of nextjsTransformers) {
+        core.registerTransformer(transformer);
+    }
+}
+export default NextjsBinding;

package/dist/transformers/nextjs.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Next.js Dockerfile Transformers
+ *
+ * Transforms for Next.js standalone output paths in Dockerfiles.
+ * Handles .next/standalone, .next/static, and public folder paths.
+ */
+import type { InstructionTransformer } from '@harpoon/core';
+/**
+ * Transforms COPY --from=builder for /app/public paths.
+ */
+export declare const nextjsPublicTransformer: InstructionTransformer;
+/**
+ * Transforms COPY --from=builder for /app/.next/static paths.
+ */
+export declare const nextjsStaticTransformer: InstructionTransformer;
+/**
+ * Transforms COPY --from=builder for /app/.next/standalone paths.
+ */
+export declare const nextjsStandaloneTransformer: InstructionTransformer;
+/**
+ * Transforms CMD to use monorepo path for server.js.
+ */
+export declare const nextjsCmdTransformer: InstructionTransformer;
+/**
+ * All Next.js transformers for easy registration.
+ */
+export declare const nextjsTransformers: readonly InstructionTransformer[];
+export default nextjsTransformers;
+//# sourceMappingURL=nextjs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../src/transformers/nextjs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA2C,MAAM,eAAe,CAAC;AAqBrG;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,sBAqCrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,sBAqCrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,sBAqCzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,sBAiBlC,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,sBAAsB,EAK9D,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/transformers/nextjs.js

@@ -0,0 +1,126 @@
+/**
+ * Next.js Dockerfile Transformers
+ *
+ * Transforms for Next.js standalone output paths in Dockerfiles.
+ * Handles .next/standalone, .next/static, and public folder paths.
+ */
+import { replaceInstruction } from '@harpoon/core';
+// ============ Helper Functions ============
+/**
+ * Check if this is a standalone Next.js app (not already monorepo structure).
+ */
+function isStandaloneApp(ctx) {
+    return ctx.isStandaloneApp === true;
+}
+/**
+ * Check if we're in the runner stage.
+ */
+function isRunnerStage(ctx) {
+    return ctx.currentStage?.toLowerCase() === 'runner';
+}
+// ============ Transformers ============
+/**
+ * Transforms COPY --from=builder for /app/public paths.
+ */
+export const nextjsPublicTransformer = {
+    name: 'nextjs-public',
+    description: 'Transforms /app/public paths for Next.js monorepo structure',
+    handlesTypes: ['COPY'],
+    matches: (inst, ctx) => {
+        if (!isStandaloneApp(ctx) || !isRunnerStage(ctx))
+            return false;
+        if (!inst.args[0]?.includes('--from=builder'))
+            return false;
+        const sourcePath = inst.args[1];
+        return !!(sourcePath?.includes('/app/public') &&
+            !sourcePath.includes('/apps/'));
+    },
+    transform: (inst, ctx) => {
+        const sourcePath = inst.args[1] || '';
+        const destPath = inst.args[2] || '';
+        const newSource = sourcePath.replace('/app/public', `/app/apps/${ctx.appName}/public`);
+        const newDest = destPath.replace('./public', `./apps/${ctx.appName}/public`);
+        return replaceInstruction(inst, inst.original
+            .replace('/app/public', `/app/apps/${ctx.appName}/public`)
+            .replace('./public', `./apps/${ctx.appName}/public`), Object.freeze([inst.args[0] || '', newSource, newDest]));
+    },
+};
+/**
+ * Transforms COPY --from=builder for /app/.next/static paths.
+ */
+export const nextjsStaticTransformer = {
+    name: 'nextjs-static',
+    description: 'Transforms .next/static paths for Next.js monorepo structure',
+    handlesTypes: ['COPY'],
+    matches: (inst, ctx) => {
+        if (!isStandaloneApp(ctx) || !isRunnerStage(ctx))
+            return false;
+        if (!inst.args[0]?.includes('--from=builder'))
+            return false;
+        const sourcePath = inst.args[1];
+        return !!(sourcePath?.includes('/app/.next/static') &&
+            !sourcePath.includes('/apps/'));
+    },
+    transform: (inst, ctx) => {
+        const sourcePath = inst.args[1] || '';
+        const destPath = inst.args[2] || '';
+        const newSource = sourcePath.replace('/app/.next/static', `/app/apps/${ctx.appName}/.next/static`);
+        const newDest = destPath.replace('./.next/static', `./apps/${ctx.appName}/.next/static`);
+        return replaceInstruction(inst, inst.original
+            .replace('/app/.next/static', `/app/apps/${ctx.appName}/.next/static`)
+            .replace('./.next/static', `./apps/${ctx.appName}/.next/static`), Object.freeze([inst.args[0] || '', newSource, newDest]));
+    },
+};
+/**
+ * Transforms COPY --from=builder for /app/.next/standalone paths.
+ */
+export const nextjsStandaloneTransformer = {
+    name: 'nextjs-standalone',
+    description: 'Transforms .next/standalone paths for Next.js monorepo structure',
+    handlesTypes: ['COPY'],
+    matches: (inst, ctx) => {
+        if (!isStandaloneApp(ctx) || !isRunnerStage(ctx))
+            return false;
+        if (!inst.args[0]?.includes('--from=builder'))
+            return false;
+        const sourcePath = inst.args[1];
+        return !!(sourcePath?.includes('/app/.next/standalone') &&
+            !sourcePath.includes('/apps/'));
+    },
+    transform: (inst, ctx) => {
+        const sourcePath = inst.args[1] || '';
+        const newSource = sourcePath.replace('/app/.next/standalone', `/app/apps/${ctx.appName}/.next/standalone`);
+        return replaceInstruction(inst, inst.original.replace('/app/.next/standalone', `/app/apps/${ctx.appName}/.next/standalone`), Object.freeze([
+            inst.args[0] || '',
+            newSource,
+            './', // Keep dest as './' - standalone structure will have apps/{appName}/server.js
+        ]));
+    },
+};
+/**
+ * Transforms CMD to use monorepo path for server.js.
+ */
+export const nextjsCmdTransformer = {
+    name: 'nextjs-cmd',
+    description: 'Transforms CMD to use monorepo path for server.js',
+    handlesTypes: ['CMD'],
+    matches: (inst, ctx) => {
+        if (!isStandaloneApp(ctx))
+            return false;
+        return inst.original.includes('server.js');
+    },
+    transform: (inst, ctx) => {
+        return replaceInstruction(inst, `CMD ["node", "apps/${ctx.appName}/server.js"]`, Object.freeze(['node', `apps/${ctx.appName}/server.js`]));
+    },
+};
+// ============ Exports ============
+/**
+ * All Next.js transformers for easy registration.
+ */
+export const nextjsTransformers = Object.freeze([
+    nextjsPublicTransformer,
+    nextjsStaticTransformer,
+    nextjsStandaloneTransformer,
+    nextjsCmdTransformer,
+]);
+export default nextjsTransformers;

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@docker-harpoon/nextjs",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "Next.js binding for Harpoon - standalone output 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": {
+    "@docker-harpoon/core": "workspace:*"
+  },
+  "peerDependencies": {
+    "bun": ">=1.0.0"
+  }
+}