@docker-harpoon/core 0.1.0

package/dist/build-strategies/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Build Strategies Registry
+ *
+ * Central registry for build strategy implementations.
+ * Provides factory functions and strategy lookup.
+ *
+ * Note: Tool-specific strategies (monorepo simulation, etc.) are provided
+ * by their respective binding packages (@harpoon/monorepo, etc.)
+ */
+import type { BuildStrategy, BuildStrategyRegistry } from './types';
+export { BuildStrategyError } from './types';
+export type { BuildStrategy, BuildStrategyInput, BuildContext, BuildStrategyRegistry, } from './types';
+/**
+ * Build strategy registry singleton.
+ */
+export declare const buildStrategyRegistry: BuildStrategyRegistry;
+/**
+ * Register a build strategy.
+ */
+export declare function registerBuildStrategy(strategy: BuildStrategy): void;
+/**
+ * Get a build strategy by name.
+ */
+export declare function getBuildStrategy(name: string): BuildStrategy | undefined;
+/**
+ * List all registered build strategy names.
+ */
+export declare function listBuildStrategies(): readonly string[];
+export { standardStrategy } from './standard';
+//# sourceMappingURL=index.d.ts.map

package/dist/build-strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build-strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAQnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAEvD;AAUD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/build-strategies/index.js

@@ -0,0 +1,47 @@
+/**
+ * Build Strategies Registry
+ *
+ * Central registry for build strategy implementations.
+ * Provides factory functions and strategy lookup.
+ *
+ * Note: Tool-specific strategies (monorepo simulation, etc.) are provided
+ * by their respective binding packages (@harpoon/monorepo, etc.)
+ */
+// Re-export types
+export { BuildStrategyError } from './types';
+// ============ Registry Implementation ============
+const strategies = new Map();
+/**
+ * Build strategy registry singleton.
+ */
+export const buildStrategyRegistry = {
+    get: (name) => strategies.get(name),
+    register: (strategy) => {
+        strategies.set(strategy.name, strategy);
+    },
+    list: () => Object.freeze([...strategies.keys()]),
+};
+/**
+ * Register a build strategy.
+ */
+export function registerBuildStrategy(strategy) {
+    buildStrategyRegistry.register(strategy);
+}
+/**
+ * Get a build strategy by name.
+ */
+export function getBuildStrategy(name) {
+    return buildStrategyRegistry.get(name);
+}
+/**
+ * List all registered build strategy names.
+ */
+export function listBuildStrategies() {
+    return buildStrategyRegistry.list();
+}
+// ============ Built-in Strategies ============
+import { standardStrategy } from './standard';
+// Register only the standard (generic) strategy
+registerBuildStrategy(standardStrategy);
+// Re-export
+export { standardStrategy } from './standard';

package/dist/build-strategies/standard.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Standard Build Strategy
+ *
+ * Passthrough strategy that uses the provided context as-is.
+ * No build context transformation is performed.
+ */
+import type { BuildStrategy } from './types';
+/**
+ * Standard build strategy.
+ *
+ * Uses the build context as-is without any transformation.
+ * Validates that the Dockerfile exists.
+ */
+export declare const standardStrategy: BuildStrategy;
+export default standardStrategy;
+//# sourceMappingURL=standard.d.ts.map

package/dist/build-strategies/standard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard.d.ts","sourceRoot":"","sources":["../../src/build-strategies/standard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAoC,MAAM,SAAS,CAAC;AAK/E;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,aA4B9B,CAAC;AAGF,eAAe,gBAAgB,CAAC"}

package/dist/build-strategies/standard.js

@@ -0,0 +1,39 @@
+/**
+ * Standard Build Strategy
+ *
+ * Passthrough strategy that uses the provided context as-is.
+ * No build context transformation is performed.
+ */
+import { Effect } from 'effect';
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { BuildStrategyError } from './types';
+// ============ Strategy Implementation ============
+/**
+ * Standard build strategy.
+ *
+ * Uses the build context as-is without any transformation.
+ * Validates that the Dockerfile exists.
+ */
+export const standardStrategy = {
+    name: 'standard',
+    description: 'Standard Dockerfile build with no context transformation',
+    prepare: (input) => Effect.gen(function* () {
+        const dockerfilePath = input.dockerfile
+            ? path.resolve(input.context, input.dockerfile)
+            : path.resolve(input.context, 'Dockerfile');
+        // Verify Dockerfile exists
+        yield* Effect.tryPromise({
+            try: () => fs.access(dockerfilePath),
+            catch: () => new BuildStrategyError('standard', `Dockerfile not found at ${dockerfilePath} for ${input.tag}`),
+        });
+        const result = {
+            contextPath: input.context,
+            dockerfilePath,
+            requiresCleanup: false,
+        };
+        return result;
+    }),
+};
+// Export as default
+export default standardStrategy;

package/dist/build-strategies/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Build Strategy Types
+ *
+ * Interfaces for pluggable Docker build context preparation strategies.
+ * Strategies prepare the build context before invoking docker build.
+ */
+import { Effect } from 'effect';
+/**
+ * Input provided to a build strategy.
+ */
+export interface BuildStrategyInput {
+    /** Docker image tag to build */
+    readonly tag: string;
+    /** Path to the build context directory */
+    readonly context: string;
+    /** Optional path to Dockerfile relative to context */
+    readonly dockerfile?: string;
+    /** Docker build arguments */
+    readonly buildArgs?: Readonly<Record<string, string>>;
+    /** App name for monorepo strategies */
+    readonly monorepoAppName?: string;
+    /** Source directory for shared monorepo folders */
+    readonly monorepoSource?: string;
+    /** Strategy-specific options */
+    readonly options?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Result of build context preparation.
+ */
+export interface BuildContext {
+    /** Path to the prepared build context */
+    readonly contextPath: string;
+    /** Path to the Dockerfile to use */
+    readonly dockerfilePath: string;
+    /** Whether the context is a temp directory requiring cleanup */
+    readonly requiresCleanup: boolean;
+    /** Optional modified Dockerfile content */
+    readonly dockerfileContent?: string;
+    /** Temp directory path (if requiresCleanup is true) */
+    readonly tempDir?: string;
+}
+/**
+ * Error during build strategy execution.
+ */
+export declare class BuildStrategyError extends Error {
+    readonly _tag: "BuildStrategyError";
+    readonly strategyName: string;
+    readonly cause?: Error | undefined;
+    constructor(strategyName: string, message: string, cause?: Error);
+}
+/**
+ * A pluggable build strategy.
+ *
+ * Strategies transform the build context before docker build is invoked.
+ * Examples: standard (passthrough), monorepo-simulation, template-substitution
+ */
+export interface BuildStrategy {
+    /** Unique strategy identifier */
+    readonly name: string;
+    /** Human-readable description */
+    readonly description: string;
+    /**
+     * Prepare the build context.
+     *
+     * @param input Build strategy input
+     * @returns Effect yielding the prepared build context
+     */
+    readonly prepare: (input: BuildStrategyInput) => Effect.Effect<BuildContext, BuildStrategyError>;
+}
+/**
+ * Registry of available build strategies.
+ */
+export interface BuildStrategyRegistry {
+    /** Get a strategy by name */
+    readonly get: (name: string) => BuildStrategy | undefined;
+    /** Register a new strategy */
+    readonly register: (strategy: BuildStrategy) => void;
+    /** List all registered strategy names */
+    readonly list: () => readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/build-strategies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/build-strategies/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEtD,uCAAuC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC,gCAAgC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAEvB,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAYjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,kBAAkB,KACtB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IAE1D,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAErD,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CACxC"}

package/dist/build-strategies/types.js

@@ -0,0 +1,25 @@
+/**
+ * Build Strategy Types
+ *
+ * Interfaces for pluggable Docker build context preparation strategies.
+ * Strategies prepare the build context before invoking docker build.
+ */
+/**
+ * Error during build strategy execution.
+ */
+export class BuildStrategyError extends Error {
+    _tag = 'BuildStrategyError';
+    strategyName;
+    cause;
+    constructor(strategyName, message, cause) {
+        super(message);
+        this.name = 'BuildStrategyError';
+        this.strategyName = strategyName;
+        if (cause) {
+            this.cause = cause;
+        }
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}

package/dist/config-patchers/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Config Patchers Registry
+ *
+ * Central registry for config patcher implementations.
+ * Provides factory functions and patcher lookup.
+ *
+ * Note: Tool-specific patchers (Prisma, pnpm, etc.) are provided
+ * by their respective binding packages (@harpoon/prisma, @harpoon/monorepo, etc.)
+ */
+import type { ConfigPatcher, ConfigPatcherRegistry, PatcherChain } from './types';
+export { ConfigPatchError } from './types';
+export type { ConfigPatcher, PatchContext, PatchResult, ConfigPatcherRegistry, PatcherChain, } from './types';
+/**
+ * Config patcher registry singleton.
+ */
+export declare const configPatcherRegistry: ConfigPatcherRegistry;
+/**
+ * Register a config patcher.
+ */
+export declare function registerConfigPatcher(patcher: ConfigPatcher): void;
+/**
+ * Get a config patcher by name.
+ */
+export declare function getConfigPatcher(name: string): ConfigPatcher | undefined;
+/**
+ * List all registered config patcher names.
+ */
+export declare function listConfigPatchers(): readonly string[];
+/**
+ * Create a patcher chain that runs multiple patchers in sequence.
+ */
+export declare function createPatcherChain(patcherNames?: readonly string[]): PatcherChain;
+//# sourceMappingURL=index.d.ts.map

package/dist/config-patchers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config-patchers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EAGrB,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,YAAY,GACb,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAsBnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,YAAY,CAsBd"}

package/dist/config-patchers/index.js

@@ -0,0 +1,75 @@
+/**
+ * Config Patchers Registry
+ *
+ * Central registry for config patcher implementations.
+ * Provides factory functions and patcher lookup.
+ *
+ * Note: Tool-specific patchers (Prisma, pnpm, etc.) are provided
+ * by their respective binding packages (@harpoon/prisma, @harpoon/monorepo, etc.)
+ */
+import { Effect } from 'effect';
+// Re-export types
+export { ConfigPatchError } from './types';
+// ============ Registry Implementation ============
+const patchers = new Map();
+/**
+ * Config patcher registry singleton.
+ */
+export const configPatcherRegistry = {
+    get: (name) => patchers.get(name),
+    register: (patcher) => {
+        patchers.set(patcher.name, patcher);
+    },
+    list: () => Object.freeze([...patchers.keys()]),
+    getApplicable: (ctx) => Effect.gen(function* () {
+        const applicable = [];
+        for (const patcher of patchers.values()) {
+            const shouldApply = yield* patcher.shouldApply(ctx);
+            if (shouldApply) {
+                applicable.push(patcher);
+            }
+        }
+        return Object.freeze(applicable);
+    }),
+};
+/**
+ * Register a config patcher.
+ */
+export function registerConfigPatcher(patcher) {
+    configPatcherRegistry.register(patcher);
+}
+/**
+ * Get a config patcher by name.
+ */
+export function getConfigPatcher(name) {
+    return configPatcherRegistry.get(name);
+}
+/**
+ * List all registered config patcher names.
+ */
+export function listConfigPatchers() {
+    return configPatcherRegistry.list();
+}
+// ============ Patcher Chain ============
+/**
+ * Create a patcher chain that runs multiple patchers in sequence.
+ */
+export function createPatcherChain(patcherNames) {
+    return {
+        run: (ctx) => Effect.gen(function* () {
+            const results = [];
+            // Get patchers to run
+            const patchersToRun = patcherNames
+                ? patcherNames
+                    .map((name) => patchers.get(name))
+                    .filter((p) => p !== undefined)
+                : yield* configPatcherRegistry.getApplicable(ctx);
+            // Run each patcher
+            for (const patcher of patchersToRun) {
+                const result = yield* patcher.apply(ctx);
+                results.push(result);
+            }
+            return Object.freeze(results);
+        }),
+    };
+}

package/dist/config-patchers/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Config Patcher Types
+ *
+ * Interfaces for pluggable configuration modification hooks.
+ * Patchers modify project config files before Docker builds.
+ */
+import { Effect } from 'effect';
+/**
+ * Context provided to config patchers.
+ */
+export interface PatchContext {
+    /** Path to the app directory */
+    readonly appDir: string;
+    /** Name of the app being built */
+    readonly appName: string;
+    /** Path to package.json in the app */
+    readonly packageJsonPath: string;
+    /** Temp directory (if using monorepo simulation) */
+    readonly tempDir?: string;
+    /** Additional context data */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Result of applying a config patch.
+ */
+export interface PatchResult {
+    /** Whether the patch was applied */
+    readonly applied: boolean;
+    /** Files that were modified */
+    readonly modifiedFiles: readonly string[];
+    /** Description of what was patched */
+    readonly description?: string;
+}
+/**
+ * Error during config patching.
+ */
+export declare class ConfigPatchError extends Error {
+    readonly _tag: "ConfigPatchError";
+    readonly patcherName: string;
+    readonly cause?: Error | undefined;
+    constructor(patcherName: string, message: string, cause?: Error);
+}
+/**
+ * A pluggable config patcher.
+ *
+ * Patchers modify configuration files (package.json, prisma config, etc.)
+ * before the Docker build process begins.
+ */
+export interface ConfigPatcher {
+    /** Unique patcher identifier */
+    readonly name: string;
+    /** Human-readable description */
+    readonly description: string;
+    /**
+     * Check if this patcher should be applied.
+     *
+     * @param ctx Patch context
+     * @returns Effect yielding true if patcher should run
+     */
+    readonly shouldApply: (ctx: PatchContext) => Effect.Effect<boolean, ConfigPatchError>;
+    /**
+     * Apply the configuration patch.
+     *
+     * @param ctx Patch context
+     * @returns Effect yielding the patch result
+     */
+    readonly apply: (ctx: PatchContext) => Effect.Effect<PatchResult, ConfigPatchError>;
+}
+/**
+ * Registry of available config patchers.
+ */
+export interface ConfigPatcherRegistry {
+    /** Get a patcher by name */
+    readonly get: (name: string) => ConfigPatcher | undefined;
+    /** Register a new patcher */
+    readonly register: (patcher: ConfigPatcher) => void;
+    /** List all registered patcher names */
+    readonly list: () => readonly string[];
+    /** Get patchers that should run for a given context */
+    readonly getApplicable: (ctx: PatchContext) => Effect.Effect<readonly ConfigPatcher[], ConfigPatchError>;
+}
+/**
+ * Chain multiple patchers together.
+ */
+export interface PatcherChain {
+    /** Run all applicable patchers in sequence */
+    readonly run: (ctx: PatchContext) => Effect.Effect<readonly PatchResult[], ConfigPatchError>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config-patchers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config-patchers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,sCAAsC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,+BAA+B;IAC/B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1C,sCAAsC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAU;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAEvB,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAYhE;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,CACpB,GAAG,EAAE,YAAY,KACd,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CACd,GAAG,EAAE,YAAY,KACd,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IAE1D,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAEpD,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAEvC,uDAAuD;IACvD,QAAQ,CAAC,aAAa,EAAE,CACtB,GAAG,EAAE,YAAY,KACd,MAAM,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,gBAAgB,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,CACZ,GAAG,EAAE,YAAY,KACd,MAAM,CAAC,MAAM,CAAC,SAAS,WAAW,EAAE,EAAE,gBAAgB,CAAC,CAAC;CAC9D"}

package/dist/config-patchers/types.js

@@ -0,0 +1,25 @@
+/**
+ * Config Patcher Types
+ *
+ * Interfaces for pluggable configuration modification hooks.
+ * Patchers modify project config files before Docker builds.
+ */
+/**
+ * Error during config patching.
+ */
+export class ConfigPatchError extends Error {
+    _tag = 'ConfigPatchError';
+    patcherName;
+    cause;
+    constructor(patcherName, message, cause) {
+        super(message);
+        this.name = 'ConfigPatchError';
+        this.patcherName = patcherName;
+        if (cause) {
+            this.cause = cause;
+        }
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}

package/dist/dockerfile-transformers/core.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Dockerfile Transformer Core
+ *
+ * Core parsing, serialization, and pipeline utilities for Dockerfile transformation.
+ * This module provides the foundation for all Dockerfile transformers.
+ */
+import { Effect } from 'effect';
+import type { DockerfileInstruction, TransformContext, InstructionTransformer, TransformPipeline, TransformResult } from './types';
+import { TransformerError } from './types';
+/**
+ * Parses a Dockerfile into structured instructions.
+ * Pure function - synchronous for direct use.
+ *
+ * @param dockerfile Raw Dockerfile content
+ * @returns Array of parsed instructions
+ */
+export declare function parseDockerfile(dockerfile: string): DockerfileInstruction[];
+/**
+ * Effect-wrapped parser for composable error handling.
+ */
+export declare function parseDockerfileEffect(dockerfile: string): Effect.Effect<DockerfileInstruction[], TransformerError>;
+/**
+ * Serializes instructions back to Dockerfile format.
+ *
+ * @param instructions Parsed Dockerfile instructions
+ * @returns Dockerfile content as string
+ */
+export declare function serializeDockerfile(instructions: readonly DockerfileInstruction[]): string;
+/**
+ * Creates a new transformation pipeline.
+ *
+ * @param transformers Initial transformers to add
+ * @returns A TransformPipeline instance
+ */
+export declare function createPipeline(transformers?: readonly InstructionTransformer[]): TransformPipeline;
+/**
+ * Transform a Dockerfile using a pipeline and return full result.
+ */
+export declare function transformDockerfile(dockerfile: string, ctx: TransformContext, pipeline: TransformPipeline): Effect.Effect<TransformResult, TransformerError>;
+/**
+ * Creates a simple instruction that replaces the original line.
+ */
+export declare function replaceInstruction(inst: DockerfileInstruction, newOriginal: string, newArgs?: readonly string[]): DockerfileInstruction;
+/**
+ * Creates multiple instructions from one (for splitting).
+ */
+export declare function splitInstruction(inst: DockerfileInstruction, replacements: readonly {
+    original: string;
+    args?: readonly string[];
+}[]): DockerfileInstruction[];
+/**
+ * Check if an instruction's args contain a pattern.
+ */
+export declare function argsContain(inst: DockerfileInstruction, pattern: string | RegExp): boolean;
+/**
+ * Get a specific argument by index (0-based).
+ */
+export declare function getArg(inst: DockerfileInstruction, index: number): string | undefined;
+//# sourceMappingURL=core.d.ts.map

package/dist/dockerfile-transformers/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/dockerfile-transformers/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAuE3C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAkD3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,EAAE,gBAAgB,CAAC,CAW1D;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,qBAAqB,EAAE,GAC7C,MAAM,CAER;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,YAAY,GAAE,SAAS,sBAAsB,EAAO,GACnD,iBAAiB,CAuFnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAUlD;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAC1B,qBAAqB,CAMvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,qBAAqB,EAC3B,YAAY,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,GACtE,qBAAqB,EAAE,CAOzB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAEpB"}