@backendkit-labs/pipeline 0.1.0

package/README.md

@@ -0,0 +1,447 @@
+# @backendkit-labs/pipeline
+
+[![npm version](https://img.shields.io/npm/v/@backendkit-labs/pipeline?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@backendkit-labs/pipeline)
+[![CI](https://img.shields.io/github/actions/workflow/status/backendkit-dev/backendkit-monorepo/ci.yml?style=flat-square&label=CI)](https://github.com/backendkit-dev/backendkit-monorepo/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/@backendkit-labs/pipeline?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/node/v/@backendkit-labs/pipeline?style=flat-square)](package.json)
+
+> Type-safe async pipeline for Node.js — Chain of Responsibility pattern with stop-on-first / collect-all modes, conditional steps, observability hooks, and optional NestJS integration.
+
+Each step in the pipeline receives the current context, transforms it, and returns a typed result. If a step fails, the pipeline can stop immediately or continue collecting all errors — your choice per pipeline.
+
+---
+
+## Installation
+
+```bash
+npm install @backendkit-labs/pipeline
+```
+
+NestJS peer dependencies (only for the `/nestjs` subpath):
+
+```bash
+npm install @nestjs/common @nestjs/core rxjs
+```
+
+---
+
+## TypeScript Configuration
+
+### Subpath exports (`/nestjs`)
+
+This package uses the `exports` field in `package.json` to expose the `/nestjs` subpath. TypeScript's ability to resolve it depends on the `moduleResolution` setting in your `tsconfig.json`.
+
+**Modern resolution (recommended) — no extra config needed:**
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+`"bundler"`, `"node16"`, and `"nodenext"` all understand the `exports` field natively. This is the recommended setting for any project using a bundler (Webpack, esbuild, Vite) or for NestJS projects on TypeScript ≥ 5.
+
+**Legacy resolution (`"node"`) — add `paths` aliases:**
+
+NestJS projects generated before ~2024 default to `"moduleResolution": "node"`, which ignores the `exports` field entirely. TypeScript won't find the types for `@backendkit-labs/pipeline/nestjs` unless you add explicit path aliases:
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "moduleResolution": "node",
+    "paths": {
+      "@backendkit-labs/pipeline/nestjs": [
+        "./node_modules/@backendkit-labs/pipeline/dist/nestjs/index"
+      ]
+    }
+  }
+}
+```
+
+> **Why does this happen?** The `"node"` resolver was designed before subpath exports existed. It only knows how to find `main` and `types` at the root of a package — it does not read the `exports` map. The `paths` alias manually points TypeScript to the right `.d.ts` file for the subpath.
+>
+> The `splitting: true` tsup option (which this package uses) and this `paths` configuration solve completely different problems. `splitting` fixes a **runtime** class identity issue — ensuring there is only one copy of a class in memory across both bundles. The `paths` alias fixes a **compile-time** issue — helping TypeScript find the types. Both may be needed in a legacy project.
+
+---
+
+### NestJS decorator support
+
+NestJS requires two compiler options to be enabled:
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+And `reflect-metadata` must be imported once at application startup, before any NestJS module is loaded:
+
+```typescript
+// main.ts
+import 'reflect-metadata';
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(3000);
+}
+bootstrap();
+```
+
+> NestJS CLI scaffolds both of these automatically. You only need to check this if you are setting up a project manually or if decorator-related DI errors appear at runtime.
+
+---
+
+## Quick Start — Framework-agnostic
+
+```typescript
+import { pipeline, Ok, Err } from '@backendkit-labs/pipeline';
+import type { PipelineStep, StepResult } from '@backendkit-labs/pipeline';
+
+interface OrderCtx {
+  productId: string;
+  quantity:  number;
+  stock:     number;
+  price:     number;
+  total:     number;
+}
+
+interface OrderError {
+  code:    string;
+  message: string;
+}
+
+class StockStep implements PipelineStep<OrderCtx, OrderError> {
+  async handle(ctx: OrderCtx): Promise<StepResult<OrderCtx, OrderError>> {
+    if (ctx.stock < ctx.quantity) {
+      return Err({ code: 'INSUFFICIENT_STOCK', message: 'Not enough stock' });
+    }
+    return Ok(ctx);
+  }
+}
+
+class PricingStep implements PipelineStep<OrderCtx, OrderError> {
+  async handle(ctx: OrderCtx): Promise<StepResult<OrderCtx, OrderError>> {
+    return Ok({ ...ctx, total: ctx.price * ctx.quantity });
+  }
+}
+
+// Build and run
+const result = await pipeline<OrderCtx, OrderError>()
+  .pipe(new StockStep())
+  .pipe(new PricingStep())
+  .run({ productId: 'p1', quantity: 2, stock: 10, price: 50, total: 0 });
+
+if (result.ok) {
+  console.log(result.value.total);        // 100
+  console.log(result.executedSteps);      // ['StockStep', 'PricingStep']
+} else {
+  console.log(result.error.failedStep);   // 'StockStep'
+  console.log(result.error.cause);        // { code: 'INSUFFICIENT_STOCK', ... }
+}
+```
+
+---
+
+## Quick Start — NestJS
+
+```typescript
+// order.pipeline.ts
+import { definePipeline } from '@backendkit-labs/pipeline';
+import type { OrderCtx, OrderError } from './order.types';
+
+export const ORDER_PIPELINE = definePipeline<OrderCtx, OrderError>('order');
+```
+
+```typescript
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { PipelineModule } from '@backendkit-labs/pipeline/nestjs';
+import { ORDER_PIPELINE } from './order.pipeline';
+import { StockStep, PricingStep, NotifyStep } from './steps';
+
+@Module({
+  imports: [
+    PipelineModule.forRoot({
+      pipelines: [
+        {
+          token:   ORDER_PIPELINE,
+          steps:   [StockStep, PricingStep, NotifyStep],
+          options: {
+            onError: (step, err) => logger.error(`Pipeline failed at ${step}`, err),
+          },
+        },
+      ],
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+```typescript
+// order.service.ts
+import { Injectable } from '@nestjs/common';
+import { InjectPipeline } from '@backendkit-labs/pipeline/nestjs';
+import { Pipeline } from '@backendkit-labs/pipeline';
+import { ORDER_PIPELINE } from './order.pipeline';
+import type { OrderCtx, OrderError } from './order.types';
+
+@Injectable()
+export class OrderService {
+  constructor(
+    @InjectPipeline(ORDER_PIPELINE)
+    private readonly pipeline: Pipeline<OrderCtx, OrderError>,
+  ) {}
+
+  async processOrder(ctx: OrderCtx) {
+    return this.pipeline.run(ctx);
+  }
+}
+```
+
+---
+
+## API
+
+### `pipeline(options?)`
+
+Creates a new pipeline builder.
+
+```typescript
+const p = pipeline<TContext, TError>(options?);
+```
+
+#### Options
+
+```typescript
+pipeline<Ctx, Err>({
+  // 'stop-on-first' — stop and return on the first failure (default)
+  // 'collect-all'   — run all steps, accumulate every failure
+  mode: 'stop-on-first',
+
+  onStep(stepName, ctx) {
+    logger.debug(`[pipeline] → ${stepName}`);
+  },
+
+  onStepComplete(stepName, ctx, durationMs) {
+    metrics.timing(`step.${stepName}`, durationMs);
+  },
+
+  onError(stepName, error) {
+    logger.error(`[pipeline] ✗ ${stepName}`, error);
+  },
+
+  onComplete(ctx, durationMs) {
+    metrics.timing('pipeline.total', durationMs);
+  },
+});
+```
+
+---
+
+### `.pipe(step)`
+
+Adds a step that always runs.
+
+```typescript
+p.pipe(new StockStep())
+ .pipe(new PricingStep());
+```
+
+---
+
+### `.pipeIf(condition, step)`
+
+Adds a step that runs only when `condition(ctx)` returns `true`. The condition receives the context **after** all previous steps have transformed it.
+
+```typescript
+p.pipe(new BaseStep())
+ .pipeIf(ctx => ctx.hasDiscount, new DiscountStep())
+ .pipe(new FinalStep());
+```
+
+---
+
+### `.run(ctx)`
+
+Executes the pipeline and returns a `PipelineRunResult`.
+
+```typescript
+const result = await p.run(initialCtx);
+
+// Success
+result.ok            // true
+result.value         // final context
+result.executedSteps // ['StockStep', 'PricingStep']
+result.durationMs    // total duration
+
+// Failure
+result.ok                    // false
+result.error.failedStep      // 'StockStep'
+result.error.cause           // original typed error
+result.error.executedSteps   // steps that ran before the failure
+result.error.durationMs      // total duration
+result.error.failures        // all failures — one entry for stop-on-first, N for collect-all
+result.error.mode            // 'stop-on-first' | 'collect-all'
+```
+
+---
+
+### `Ok(value)` / `Err(error)`
+
+Helpers for returning step results.
+
+```typescript
+import { Ok, Err } from '@backendkit-labs/pipeline';
+
+async handle(ctx): Promise<StepResult<Ctx, Err>> {
+  if (!valid) return Err({ code: 'INVALID' });
+  return Ok({ ...ctx, validated: true });
+}
+```
+
+---
+
+### `PipelineStep<TContext, TError>`
+
+Interface your step classes implement.
+
+```typescript
+import type { PipelineStep, StepResult } from '@backendkit-labs/pipeline';
+
+class MyStep implements PipelineStep<Ctx, MyError> {
+  // Optional — overrides constructor.name in error reports and hook calls
+  readonly stepName = 'MyStep';
+
+  async handle(ctx: Ctx): Promise<StepResult<Ctx, MyError>> {
+    // ...
+  }
+}
+```
+
+---
+
+## Error Modes
+
+### `stop-on-first` (default)
+
+Stops at the first failure. Use when later steps depend on earlier ones being successful.
+
+```typescript
+pipeline({ mode: 'stop-on-first' })
+  .pipe(new AuthStep())      // if this fails → stop, PaymentStep never runs
+  .pipe(new PaymentStep())
+  .run(ctx);
+```
+
+### `collect-all`
+
+Runs every step regardless of failures. Use when steps are independent and you want to report all errors at once — e.g., form validation.
+
+```typescript
+pipeline({ mode: 'collect-all' })
+  .pipe(new ValidateNameStep())
+  .pipe(new ValidateEmailStep())
+  .pipe(new ValidatePhoneStep())
+  .run(formData);
+
+// result.error.failures → [{ step: 'ValidateEmailStep', cause: ... }, { step: 'ValidatePhoneStep', cause: ... }]
+```
+
+---
+
+## NestJS Integration
+
+### `definePipeline<TContext, TError>(name)`
+
+Creates a typed injection token. Define it once and share across module and service.
+
+```typescript
+export const ORDER_PIPELINE = definePipeline<OrderCtx, OrderError>('order');
+// PipelineToken<OrderCtx, OrderError>
+```
+
+### `PipelineModule.forRoot(options)`
+
+Registers pipelines globally. Each step class is resolved via NestJS DI, so steps can inject other services.
+
+```typescript
+PipelineModule.forRoot({
+  pipelines: [
+    {
+      token:   ORDER_PIPELINE,
+      steps:   [StockStep, PricingStep, NotifyStep],  // resolved via DI
+      options: { mode: 'stop-on-first', onError: ... },
+    },
+  ],
+})
+```
+
+### `@InjectPipeline(token)`
+
+Parameter decorator for injecting a pipeline into a service.
+
+```typescript
+constructor(
+  @InjectPipeline(ORDER_PIPELINE)
+  private readonly orderPipeline: Pipeline<OrderCtx, OrderError>,
+) {}
+```
+
+---
+
+## Use Cases
+
+| Scenario | Mode |
+|---|---|
+| Order processing (stock → payment → notify) | `stop-on-first` |
+| Form / DTO validation (collect all field errors) | `collect-all` |
+| User onboarding (KYC → plan → welcome email) | `stop-on-first` |
+| File processing (validate → scan → compress → upload) | `stop-on-first` |
+| Webhook processing (verify signature → parse → deduplicate → route) | `stop-on-first` |
+| Pricing pipeline (base → volume discount → tax → currency) | `stop-on-first` |
+
+---
+
+## Design Notes
+
+### Context is immutable by convention
+
+Each step returns a **new** context object rather than mutating the existing one. This makes each step's input/output explicit and easy to trace in logs.
+
+```typescript
+// Do this
+return Ok({ ...ctx, total: ctx.price * ctx.quantity });
+
+// Not this
+ctx.total = ctx.price * ctx.quantity;
+return Ok(ctx);
+```
+
+### Steps are plain classes
+
+Steps don't extend a base class or require special decorators. They just implement `PipelineStep<TContext, TError>`. This makes them easy to test in isolation:
+
+```typescript
+const result = await new StockStep().handle({ stock: 0, quantity: 5, ... });
+expect(result.ok).toBe(false);
+```
+
+### NestJS DI class identity
+
+`PipelineModule.forRoot()` resolves step classes via NestJS DI and wires them into the pipeline at startup. All steps share the same DI context — no class identity issues.
+
+---
+
+## License
+
+MIT — [BackendKit Labs](https://github.com/backendkit-dev)

package/dist/chunk-GHWTXTUB.js

@@ -0,0 +1,93 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// src/core/pipeline.ts
+var Pipeline = class {
+  entries = [];
+  options;
+  constructor(options = {}) {
+    this.options = options;
+  }
+  pipe(step) {
+    this.entries.push({
+      instance: step,
+      name: step.stepName ?? step.constructor.name
+    });
+    return this;
+  }
+  pipeIf(condition, step) {
+    this.entries.push({
+      instance: step,
+      name: step.stepName ?? step.constructor.name,
+      condition
+    });
+    return this;
+  }
+  async run(initialCtx) {
+    const start = Date.now();
+    const { mode = "stop-on-first", onStep, onStepComplete, onError, onComplete } = this.options;
+    const executedSteps = [];
+    const failures = [];
+    let ctx = initialCtx;
+    for (const { instance, name, condition } of this.entries) {
+      if (condition && !condition(ctx)) continue;
+      await onStep?.(name, ctx);
+      const stepStart = Date.now();
+      const stepResult = await instance.handle(ctx);
+      const stepMs = Date.now() - stepStart;
+      if (!stepResult.ok) {
+        await onError?.(name, stepResult.error);
+        failures.push({ step: name, cause: stepResult.error });
+        if (mode === "stop-on-first") {
+          return {
+            ok: false,
+            error: {
+              mode,
+              failedStep: name,
+              cause: stepResult.error,
+              executedSteps: [...executedSteps],
+              durationMs: Date.now() - start,
+              failures
+            }
+          };
+        }
+        executedSteps.push(name);
+        continue;
+      }
+      ctx = stepResult.value;
+      executedSteps.push(name);
+      await onStepComplete?.(name, ctx, stepMs);
+    }
+    if (failures.length > 0) {
+      return {
+        ok: false,
+        error: {
+          mode,
+          failedStep: failures[0].step,
+          cause: failures[0].cause,
+          executedSteps: [...executedSteps],
+          durationMs: Date.now() - start,
+          failures
+        }
+      };
+    }
+    const durationMs = Date.now() - start;
+    await onComplete?.(ctx, durationMs);
+    return { ok: true, value: ctx, executedSteps: [...executedSteps], durationMs };
+  }
+};
+function pipeline(options) {
+  return new Pipeline(options);
+}
+
+export { Pipeline, __decorateClass, pipeline };
+//# sourceMappingURL=chunk-GHWTXTUB.js.map
+//# sourceMappingURL=chunk-GHWTXTUB.js.map

package/dist/chunk-GHWTXTUB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/pipeline.ts"],"names":[],"mappings":"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","file":"chunk-GHWTXTUB.js","sourcesContent":["import type {\n  PipelineOptions,\n  PipelineRunResult,\n  PipelineStep,\n  PipelineStepFailure,\n} from './types.js';\n\ninterface StepEntry<TContext, TError> {\n  instance:   PipelineStep<TContext, TError>;\n  name:       string;\n  condition?: (ctx: TContext) => boolean;\n}\n\nexport class Pipeline<TContext, TError = unknown> {\n  private readonly entries: StepEntry<TContext, TError>[] = [];\n  private readonly options: PipelineOptions<TContext, TError>;\n\n  constructor(options: PipelineOptions<TContext, TError> = {}) {\n    this.options = options;\n  }\n\n  pipe(step: PipelineStep<TContext, TError>): this {\n    this.entries.push({\n      instance: step,\n      name:     step.stepName ?? step.constructor.name,\n    });\n    return this;\n  }\n\n  pipeIf(condition: (ctx: TContext) => boolean, step: PipelineStep<TContext, TError>): this {\n    this.entries.push({\n      instance:  step,\n      name:      step.stepName ?? step.constructor.name,\n      condition,\n    });\n    return this;\n  }\n\n  async run(initialCtx: TContext): Promise<PipelineRunResult<TContext, TError>> {\n    const start = Date.now();\n    const { mode = 'stop-on-first', onStep, onStepComplete, onError, onComplete } = this.options;\n    const executedSteps: string[]                      = [];\n    const failures:      PipelineStepFailure<TError>[] = [];\n    let   ctx = initialCtx;\n\n    for (const { instance, name, condition } of this.entries) {\n      if (condition && !condition(ctx)) continue;\n\n      await onStep?.(name, ctx);\n      const stepStart  = Date.now();\n      const stepResult = await instance.handle(ctx);\n      const stepMs     = Date.now() - stepStart;\n\n      if (!stepResult.ok) {\n        await onError?.(name, stepResult.error);\n        failures.push({ step: name, cause: stepResult.error });\n\n        if (mode === 'stop-on-first') {\n          return {\n            ok:    false,\n            error: {\n              mode,\n              failedStep:    name,\n              cause:         stepResult.error,\n              executedSteps: [...executedSteps],\n              durationMs:    Date.now() - start,\n              failures,\n            },\n          };\n        }\n\n        // collect-all: record the failed step and continue\n        executedSteps.push(name);\n        continue;\n      }\n\n      ctx = stepResult.value;\n      executedSteps.push(name);\n      await onStepComplete?.(name, ctx, stepMs);\n    }\n\n    if (failures.length > 0) {\n      return {\n        ok:    false,\n        error: {\n          mode,\n          failedStep:    failures[0].step,\n          cause:         failures[0].cause,\n          executedSteps: [...executedSteps],\n          durationMs:    Date.now() - start,\n          failures,\n        },\n      };\n    }\n\n    const durationMs = Date.now() - start;\n    await onComplete?.(ctx, durationMs);\n    return { ok: true, value: ctx, executedSteps: [...executedSteps], durationMs };\n  }\n}\n\nexport function pipeline<TContext, TError = unknown>(\n  options?: PipelineOptions<TContext, TError>,\n): Pipeline<TContext, TError> {\n  return new Pipeline(options);\n}\n"]}

package/dist/chunk-LPCHUZQE.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// src/core/pipeline.ts
+var Pipeline = class {
+  entries = [];
+  options;
+  constructor(options = {}) {
+    this.options = options;
+  }
+  pipe(step) {
+    this.entries.push({
+      instance: step,
+      name: step.stepName ?? step.constructor.name
+    });
+    return this;
+  }
+  pipeIf(condition, step) {
+    this.entries.push({
+      instance: step,
+      name: step.stepName ?? step.constructor.name,
+      condition
+    });
+    return this;
+  }
+  async run(initialCtx) {
+    const start = Date.now();
+    const { mode = "stop-on-first", onStep, onStepComplete, onError, onComplete } = this.options;
+    const executedSteps = [];
+    const failures = [];
+    let ctx = initialCtx;
+    for (const { instance, name, condition } of this.entries) {
+      if (condition && !condition(ctx)) continue;
+      await onStep?.(name, ctx);
+      const stepStart = Date.now();
+      const stepResult = await instance.handle(ctx);
+      const stepMs = Date.now() - stepStart;
+      if (!stepResult.ok) {
+        await onError?.(name, stepResult.error);
+        failures.push({ step: name, cause: stepResult.error });
+        if (mode === "stop-on-first") {
+          return {
+            ok: false,
+            error: {
+              mode,
+              failedStep: name,
+              cause: stepResult.error,
+              executedSteps: [...executedSteps],
+              durationMs: Date.now() - start,
+              failures
+            }
+          };
+        }
+        executedSteps.push(name);
+        continue;
+      }
+      ctx = stepResult.value;
+      executedSteps.push(name);
+      await onStepComplete?.(name, ctx, stepMs);
+    }
+    if (failures.length > 0) {
+      return {
+        ok: false,
+        error: {
+          mode,
+          failedStep: failures[0].step,
+          cause: failures[0].cause,
+          executedSteps: [...executedSteps],
+          durationMs: Date.now() - start,
+          failures
+        }
+      };
+    }
+    const durationMs = Date.now() - start;
+    await onComplete?.(ctx, durationMs);
+    return { ok: true, value: ctx, executedSteps: [...executedSteps], durationMs };
+  }
+};
+function pipeline(options) {
+  return new Pipeline(options);
+}
+
+exports.Pipeline = Pipeline;
+exports.__decorateClass = __decorateClass;
+exports.pipeline = pipeline;
+//# sourceMappingURL=chunk-LPCHUZQE.cjs.map
+//# sourceMappingURL=chunk-LPCHUZQE.cjs.map

package/dist/chunk-LPCHUZQE.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/pipeline.ts"],"names":[],"mappings":"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","file":"chunk-LPCHUZQE.cjs","sourcesContent":["import type {\n  PipelineOptions,\n  PipelineRunResult,\n  PipelineStep,\n  PipelineStepFailure,\n} from './types.js';\n\ninterface StepEntry<TContext, TError> {\n  instance:   PipelineStep<TContext, TError>;\n  name:       string;\n  condition?: (ctx: TContext) => boolean;\n}\n\nexport class Pipeline<TContext, TError = unknown> {\n  private readonly entries: StepEntry<TContext, TError>[] = [];\n  private readonly options: PipelineOptions<TContext, TError>;\n\n  constructor(options: PipelineOptions<TContext, TError> = {}) {\n    this.options = options;\n  }\n\n  pipe(step: PipelineStep<TContext, TError>): this {\n    this.entries.push({\n      instance: step,\n      name:     step.stepName ?? step.constructor.name,\n    });\n    return this;\n  }\n\n  pipeIf(condition: (ctx: TContext) => boolean, step: PipelineStep<TContext, TError>): this {\n    this.entries.push({\n      instance:  step,\n      name:      step.stepName ?? step.constructor.name,\n      condition,\n    });\n    return this;\n  }\n\n  async run(initialCtx: TContext): Promise<PipelineRunResult<TContext, TError>> {\n    const start = Date.now();\n    const { mode = 'stop-on-first', onStep, onStepComplete, onError, onComplete } = this.options;\n    const executedSteps: string[]                      = [];\n    const failures:      PipelineStepFailure<TError>[] = [];\n    let   ctx = initialCtx;\n\n    for (const { instance, name, condition } of this.entries) {\n      if (condition && !condition(ctx)) continue;\n\n      await onStep?.(name, ctx);\n      const stepStart  = Date.now();\n      const stepResult = await instance.handle(ctx);\n      const stepMs     = Date.now() - stepStart;\n\n      if (!stepResult.ok) {\n        await onError?.(name, stepResult.error);\n        failures.push({ step: name, cause: stepResult.error });\n\n        if (mode === 'stop-on-first') {\n          return {\n            ok:    false,\n            error: {\n              mode,\n              failedStep:    name,\n              cause:         stepResult.error,\n              executedSteps: [...executedSteps],\n              durationMs:    Date.now() - start,\n              failures,\n            },\n          };\n        }\n\n        // collect-all: record the failed step and continue\n        executedSteps.push(name);\n        continue;\n      }\n\n      ctx = stepResult.value;\n      executedSteps.push(name);\n      await onStepComplete?.(name, ctx, stepMs);\n    }\n\n    if (failures.length > 0) {\n      return {\n        ok:    false,\n        error: {\n          mode,\n          failedStep:    failures[0].step,\n          cause:         failures[0].cause,\n          executedSteps: [...executedSteps],\n          durationMs:    Date.now() - start,\n          failures,\n        },\n      };\n    }\n\n    const durationMs = Date.now() - start;\n    await onComplete?.(ctx, durationMs);\n    return { ok: true, value: ctx, executedSteps: [...executedSteps], durationMs };\n  }\n}\n\nexport function pipeline<TContext, TError = unknown>(\n  options?: PipelineOptions<TContext, TError>,\n): Pipeline<TContext, TError> {\n  return new Pipeline(options);\n}\n"]}

package/dist/define-pipeline-BNKM59ML.d.cts

@@ -0,0 +1,52 @@
+type StepResult<TContext, TError> = {
+    readonly ok: true;
+    readonly value: TContext;
+} | {
+    readonly ok: false;
+    readonly error: TError;
+};
+interface PipelineStep<TContext, TError = unknown> {
+    /** Optional human-readable name used in error reporting and hooks. Defaults to constructor.name. */
+    readonly stepName?: string;
+    handle(ctx: TContext): Promise<StepResult<TContext, TError>>;
+}
+type PipelineMode = 'stop-on-first' | 'collect-all';
+interface PipelineStepFailure<TError> {
+    readonly step: string;
+    readonly cause: TError;
+}
+interface PipelineError<TError> {
+    readonly mode: PipelineMode;
+    readonly failedStep: string;
+    readonly cause: TError;
+    readonly executedSteps: string[];
+    readonly durationMs: number;
+    readonly failures: PipelineStepFailure<TError>[];
+}
+type PipelineRunResult<TContext, TError> = {
+    readonly ok: true;
+    readonly value: TContext;
+    readonly executedSteps: string[];
+    readonly durationMs: number;
+} | {
+    readonly ok: false;
+    readonly error: PipelineError<TError>;
+};
+interface PipelineOptions<TContext, TError> {
+    mode?: PipelineMode;
+    onStep?: (stepName: string, ctx: TContext) => void | Promise<void>;
+    onStepComplete?: (stepName: string, ctx: TContext, durationMs: number) => void | Promise<void>;
+    onError?: (stepName: string, error: TError) => void | Promise<void>;
+    onComplete?: (ctx: TContext, durationMs: number) => void | Promise<void>;
+}
+
+declare class PipelineToken<TContext, TError = unknown> {
+    readonly description: string;
+    readonly symbol: symbol;
+    readonly _ctx: TContext;
+    readonly _err: TError;
+    constructor(name: string);
+}
+declare function definePipeline<TContext, TError = unknown>(name: string): PipelineToken<TContext, TError>;
+
+export { type PipelineOptions as P, type StepResult as S, type PipelineStep as a, type PipelineRunResult as b, type PipelineError as c, type PipelineMode as d, type PipelineStepFailure as e, PipelineToken as f, definePipeline as g };

package/dist/define-pipeline-BNKM59ML.d.ts

@@ -0,0 +1,52 @@
+type StepResult<TContext, TError> = {
+    readonly ok: true;
+    readonly value: TContext;
+} | {
+    readonly ok: false;
+    readonly error: TError;
+};
+interface PipelineStep<TContext, TError = unknown> {
+    /** Optional human-readable name used in error reporting and hooks. Defaults to constructor.name. */
+    readonly stepName?: string;
+    handle(ctx: TContext): Promise<StepResult<TContext, TError>>;
+}
+type PipelineMode = 'stop-on-first' | 'collect-all';
+interface PipelineStepFailure<TError> {
+    readonly step: string;
+    readonly cause: TError;
+}
+interface PipelineError<TError> {
+    readonly mode: PipelineMode;
+    readonly failedStep: string;
+    readonly cause: TError;
+    readonly executedSteps: string[];
+    readonly durationMs: number;
+    readonly failures: PipelineStepFailure<TError>[];
+}
+type PipelineRunResult<TContext, TError> = {
+    readonly ok: true;
+    readonly value: TContext;
+    readonly executedSteps: string[];
+    readonly durationMs: number;
+} | {
+    readonly ok: false;
+    readonly error: PipelineError<TError>;
+};
+interface PipelineOptions<TContext, TError> {
+    mode?: PipelineMode;
+    onStep?: (stepName: string, ctx: TContext) => void | Promise<void>;
+    onStepComplete?: (stepName: string, ctx: TContext, durationMs: number) => void | Promise<void>;
+    onError?: (stepName: string, error: TError) => void | Promise<void>;
+    onComplete?: (ctx: TContext, durationMs: number) => void | Promise<void>;
+}
+
+declare class PipelineToken<TContext, TError = unknown> {
+    readonly description: string;
+    readonly symbol: symbol;
+    readonly _ctx: TContext;
+    readonly _err: TError;
+    constructor(name: string);
+}
+declare function definePipeline<TContext, TError = unknown>(name: string): PipelineToken<TContext, TError>;
+
+export { type PipelineOptions as P, type StepResult as S, type PipelineStep as a, type PipelineRunResult as b, type PipelineError as c, type PipelineMode as d, type PipelineStepFailure as e, PipelineToken as f, definePipeline as g };

package/dist/index.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var chunkLPCHUZQE_cjs = require('./chunk-LPCHUZQE.cjs');
+
+// src/core/define-pipeline.ts
+var PipelineToken = class {
+  description;
+  symbol;
+  constructor(name) {
+    this.description = `Pipeline(${name})`;
+    this.symbol = /* @__PURE__ */ Symbol(`Pipeline(${name})`);
+  }
+};
+function definePipeline(name) {
+  return new PipelineToken(name);
+}
+
+// src/core/result.ts
+function Ok(value) {
+  return { ok: true, value };
+}
+function Err(error) {
+  return { ok: false, error };
+}
+
+Object.defineProperty(exports, "Pipeline", {
+  enumerable: true,
+  get: function () { return chunkLPCHUZQE_cjs.Pipeline; }
+});
+Object.defineProperty(exports, "pipeline", {
+  enumerable: true,
+  get: function () { return chunkLPCHUZQE_cjs.pipeline; }
+});
+exports.Err = Err;
+exports.Ok = Ok;
+exports.PipelineToken = PipelineToken;
+exports.definePipeline = definePipeline;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/define-pipeline.ts","../src/core/result.ts"],"names":[],"mappings":";;;;;AAAO,IAAM,gBAAN,MAAgD;AAAA,EAC5C,WAAA;AAAA,EACA,MAAA;AAAA,EAMT,YAAY,IAAA,EAAc;AACxB,IAAA,IAAA,CAAK,WAAA,GAAc,YAAY,IAAI,CAAA,CAAA,CAAA;AACnC,IAAA,IAAA,CAAK,MAAA,mBAAc,MAAA,CAAO,CAAA,SAAA,EAAY,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,EAC/C;AACF;AAEO,SAAS,eACd,IAAA,EACiC;AACjC,EAAA,OAAO,IAAI,cAAgC,IAAI,CAAA;AACjD;;;AChBO,SAAS,GAAa,KAAA,EAA8C;AACzE,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,KAAA,EAAM;AAC3B;AAEO,SAAS,IAAY,KAAA,EAA0C;AACpE,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAM;AAC5B","file":"index.cjs","sourcesContent":["export class PipelineToken<TContext, TError = unknown> {\n  readonly description: string;\n  readonly symbol:      symbol;\n\n  // Phantom brand fields — exist only at the type level, never at runtime\n  declare readonly _ctx: TContext;\n  declare readonly _err: TError;\n\n  constructor(name: string) {\n    this.description = `Pipeline(${name})`;\n    this.symbol      = Symbol(`Pipeline(${name})`);\n  }\n}\n\nexport function definePipeline<TContext, TError = unknown>(\n  name: string,\n): PipelineToken<TContext, TError> {\n  return new PipelineToken<TContext, TError>(name);\n}\n","import type { StepResult } from './types.js';\n\nexport function Ok<TContext>(value: TContext): StepResult<TContext, never> {\n  return { ok: true, value };\n}\n\nexport function Err<TError>(error: TError): StepResult<never, TError> {\n  return { ok: false, error };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,17 @@
+import { P as PipelineOptions, a as PipelineStep, b as PipelineRunResult, S as StepResult } from './define-pipeline-BNKM59ML.cjs';
+export { c as PipelineError, d as PipelineMode, e as PipelineStepFailure, f as PipelineToken, g as definePipeline } from './define-pipeline-BNKM59ML.cjs';
+
+declare class Pipeline<TContext, TError = unknown> {
+    private readonly entries;
+    private readonly options;
+    constructor(options?: PipelineOptions<TContext, TError>);
+    pipe(step: PipelineStep<TContext, TError>): this;
+    pipeIf(condition: (ctx: TContext) => boolean, step: PipelineStep<TContext, TError>): this;
+    run(initialCtx: TContext): Promise<PipelineRunResult<TContext, TError>>;
+}
+declare function pipeline<TContext, TError = unknown>(options?: PipelineOptions<TContext, TError>): Pipeline<TContext, TError>;
+
+declare function Ok<TContext>(value: TContext): StepResult<TContext, never>;
+declare function Err<TError>(error: TError): StepResult<never, TError>;
+
+export { Err, Ok, Pipeline, PipelineOptions, PipelineRunResult, PipelineStep, StepResult, pipeline };

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { P as PipelineOptions, a as PipelineStep, b as PipelineRunResult, S as StepResult } from './define-pipeline-BNKM59ML.js';
+export { c as PipelineError, d as PipelineMode, e as PipelineStepFailure, f as PipelineToken, g as definePipeline } from './define-pipeline-BNKM59ML.js';
+
+declare class Pipeline<TContext, TError = unknown> {
+    private readonly entries;
+    private readonly options;
+    constructor(options?: PipelineOptions<TContext, TError>);
+    pipe(step: PipelineStep<TContext, TError>): this;
+    pipeIf(condition: (ctx: TContext) => boolean, step: PipelineStep<TContext, TError>): this;
+    run(initialCtx: TContext): Promise<PipelineRunResult<TContext, TError>>;
+}
+declare function pipeline<TContext, TError = unknown>(options?: PipelineOptions<TContext, TError>): Pipeline<TContext, TError>;
+
+declare function Ok<TContext>(value: TContext): StepResult<TContext, never>;
+declare function Err<TError>(error: TError): StepResult<never, TError>;
+
+export { Err, Ok, Pipeline, PipelineOptions, PipelineRunResult, PipelineStep, StepResult, pipeline };

package/dist/index.js

@@ -0,0 +1,26 @@
+export { Pipeline, pipeline } from './chunk-GHWTXTUB.js';
+
+// src/core/define-pipeline.ts
+var PipelineToken = class {
+  description;
+  symbol;
+  constructor(name) {
+    this.description = `Pipeline(${name})`;
+    this.symbol = /* @__PURE__ */ Symbol(`Pipeline(${name})`);
+  }
+};
+function definePipeline(name) {
+  return new PipelineToken(name);
+}
+
+// src/core/result.ts
+function Ok(value) {
+  return { ok: true, value };
+}
+function Err(error) {
+  return { ok: false, error };
+}
+
+export { Err, Ok, PipelineToken, definePipeline };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/define-pipeline.ts","../src/core/result.ts"],"names":[],"mappings":";;;AAAO,IAAM,gBAAN,MAAgD;AAAA,EAC5C,WAAA;AAAA,EACA,MAAA;AAAA,EAMT,YAAY,IAAA,EAAc;AACxB,IAAA,IAAA,CAAK,WAAA,GAAc,YAAY,IAAI,CAAA,CAAA,CAAA;AACnC,IAAA,IAAA,CAAK,MAAA,mBAAc,MAAA,CAAO,CAAA,SAAA,EAAY,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,EAC/C;AACF;AAEO,SAAS,eACd,IAAA,EACiC;AACjC,EAAA,OAAO,IAAI,cAAgC,IAAI,CAAA;AACjD;;;AChBO,SAAS,GAAa,KAAA,EAA8C;AACzE,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,KAAA,EAAM;AAC3B;AAEO,SAAS,IAAY,KAAA,EAA0C;AACpE,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAM;AAC5B","file":"index.js","sourcesContent":["export class PipelineToken<TContext, TError = unknown> {\n  readonly description: string;\n  readonly symbol:      symbol;\n\n  // Phantom brand fields — exist only at the type level, never at runtime\n  declare readonly _ctx: TContext;\n  declare readonly _err: TError;\n\n  constructor(name: string) {\n    this.description = `Pipeline(${name})`;\n    this.symbol      = Symbol(`Pipeline(${name})`);\n  }\n}\n\nexport function definePipeline<TContext, TError = unknown>(\n  name: string,\n): PipelineToken<TContext, TError> {\n  return new PipelineToken<TContext, TError>(name);\n}\n","import type { StepResult } from './types.js';\n\nexport function Ok<TContext>(value: TContext): StepResult<TContext, never> {\n  return { ok: true, value };\n}\n\nexport function Err<TError>(error: TError): StepResult<never, TError> {\n  return { ok: false, error };\n}\n"]}

package/dist/nestjs/index.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var chunkLPCHUZQE_cjs = require('../chunk-LPCHUZQE.cjs');
+var common = require('@nestjs/common');
+
+exports.PipelineModule = class PipelineModule {
+  static forRoot(options) {
+    const providers = [];
+    for (const def of options.pipelines) {
+      for (const step of def.steps) {
+        providers.push({ provide: step, useClass: step });
+      }
+      providers.push({
+        provide: def.token.symbol,
+        useFactory: (...stepInstances) => {
+          const p = new chunkLPCHUZQE_cjs.Pipeline(def.options ?? {});
+          for (const instance of stepInstances) {
+            p.pipe(instance);
+          }
+          return p;
+        },
+        inject: def.steps
+      });
+    }
+    return {
+      module: exports.PipelineModule,
+      providers,
+      exports: providers,
+      global: true
+    };
+  }
+};
+exports.PipelineModule = chunkLPCHUZQE_cjs.__decorateClass([
+  common.Module({})
+], exports.PipelineModule);
+var InjectPipeline = (token) => common.Inject(token.symbol);
+
+exports.InjectPipeline = InjectPipeline;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/nestjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nestjs/pipeline.module.ts","../../src/nestjs/pipeline.decorator.ts"],"names":["PipelineModule","Pipeline","__decorateClass","Module","Inject"],"mappings":";;;;;AAMaA,yBAAN,oBAAA,CAAqB;AAAA,EAC1B,OAAO,QAAQ,OAAA,EAA+C;AAC5D,IAAA,MAAM,YAAwB,EAAC;AAE/B,IAAA,KAAA,MAAW,GAAA,IAAO,QAAQ,SAAA,EAAW;AACnC,MAAA,KAAA,MAAW,IAAA,IAAQ,IAAI,KAAA,EAAO;AAC5B,QAAA,SAAA,CAAU,KAAK,EAAE,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU,MAAM,CAAA;AAAA,MAClD;AAEA,MAAA,SAAA,CAAU,IAAA,CAAK;AAAA,QACb,OAAA,EAAY,IAAI,KAAA,CAAM,MAAA;AAAA,QACtB,UAAA,EAAY,IAAI,aAAA,KAAoD;AAClE,UAAA,MAAM,IAAI,IAAIC,0BAAA,CAAS,GAAA,CAAI,OAAA,IAAW,EAAE,CAAA;AACxC,UAAA,KAAA,MAAW,YAAY,aAAA,EAAe;AACpC,YAAA,CAAA,CAAE,KAAK,QAAQ,CAAA;AAAA,UACjB;AACA,UAAA,OAAO,CAAA;AAAA,QACT,CAAA;AAAA,QACA,QAAQ,GAAA,CAAI;AAAA,OACb,CAAA;AAAA,IACH;AAEA,IAAA,OAAO;AAAA,MACL,MAAA,EAAWD,sBAAA;AAAA,MACX,SAAA;AAAA,MACA,OAAA,EAAW,SAAA;AAAA,MACX,MAAA,EAAW;AAAA,KACb;AAAA,EACF;AACF;AA7BaA,sBAAA,GAANE,iCAAA,CAAA;AAAA,EADNC,aAAA,CAAO,EAAE;AAAA,CAAA,EACGH,sBAAA,CAAA;ACHN,IAAM,cAAA,GAAiB,CAC5B,KAAA,KAC8BI,aAAA,CAAO,MAAM,MAAM","file":"index.cjs","sourcesContent":["import { DynamicModule, Module, Provider } from '@nestjs/common';\nimport { Pipeline } from '../core/pipeline.js';\nimport type { PipelineStep } from '../core/types.js';\nimport type { PipelineModuleOptions } from './pipeline.options.js';\n\n@Module({})\nexport class PipelineModule {\n  static forRoot(options: PipelineModuleOptions): DynamicModule {\n    const providers: Provider[] = [];\n\n    for (const def of options.pipelines) {\n      for (const step of def.steps) {\n        providers.push({ provide: step, useClass: step });\n      }\n\n      providers.push({\n        provide:    def.token.symbol,\n        useFactory: (...stepInstances: PipelineStep<unknown, unknown>[]) => {\n          const p = new Pipeline(def.options ?? {});\n          for (const instance of stepInstances) {\n            p.pipe(instance);\n          }\n          return p;\n        },\n        inject: def.steps,\n      });\n    }\n\n    return {\n      module:    PipelineModule,\n      providers,\n      exports:   providers,\n      global:    true,\n    };\n  }\n}\n","import { Inject } from '@nestjs/common';\nimport type { PipelineToken } from '../core/define-pipeline.js';\n\nexport const InjectPipeline = <TContext, TError>(\n  token: PipelineToken<TContext, TError>,\n): ReturnType<typeof Inject> => Inject(token.symbol);\n"]}

package/dist/nestjs/index.d.cts

@@ -0,0 +1,19 @@
+import { Type, DynamicModule, Inject } from '@nestjs/common';
+import { f as PipelineToken, a as PipelineStep, P as PipelineOptions } from '../define-pipeline-BNKM59ML.cjs';
+
+interface PipelineDefinition<TContext = unknown, TError = unknown> {
+    token: PipelineToken<TContext, TError>;
+    steps: Type<PipelineStep<TContext, TError>>[];
+    options?: PipelineOptions<TContext, TError>;
+}
+interface PipelineModuleOptions {
+    pipelines: PipelineDefinition[];
+}
+
+declare class PipelineModule {
+    static forRoot(options: PipelineModuleOptions): DynamicModule;
+}
+
+declare const InjectPipeline: <TContext, TError>(token: PipelineToken<TContext, TError>) => ReturnType<typeof Inject>;
+
+export { InjectPipeline, type PipelineDefinition, PipelineModule, type PipelineModuleOptions };

package/dist/nestjs/index.d.ts

@@ -0,0 +1,19 @@
+import { Type, DynamicModule, Inject } from '@nestjs/common';
+import { f as PipelineToken, a as PipelineStep, P as PipelineOptions } from '../define-pipeline-BNKM59ML.js';
+
+interface PipelineDefinition<TContext = unknown, TError = unknown> {
+    token: PipelineToken<TContext, TError>;
+    steps: Type<PipelineStep<TContext, TError>>[];
+    options?: PipelineOptions<TContext, TError>;
+}
+interface PipelineModuleOptions {
+    pipelines: PipelineDefinition[];
+}
+
+declare class PipelineModule {
+    static forRoot(options: PipelineModuleOptions): DynamicModule;
+}
+
+declare const InjectPipeline: <TContext, TError>(token: PipelineToken<TContext, TError>) => ReturnType<typeof Inject>;
+
+export { InjectPipeline, type PipelineDefinition, PipelineModule, type PipelineModuleOptions };

package/dist/nestjs/index.js

@@ -0,0 +1,38 @@
+import { __decorateClass, Pipeline } from '../chunk-GHWTXTUB.js';
+import { Module, Inject } from '@nestjs/common';
+
+var PipelineModule = class {
+  static forRoot(options) {
+    const providers = [];
+    for (const def of options.pipelines) {
+      for (const step of def.steps) {
+        providers.push({ provide: step, useClass: step });
+      }
+      providers.push({
+        provide: def.token.symbol,
+        useFactory: (...stepInstances) => {
+          const p = new Pipeline(def.options ?? {});
+          for (const instance of stepInstances) {
+            p.pipe(instance);
+          }
+          return p;
+        },
+        inject: def.steps
+      });
+    }
+    return {
+      module: PipelineModule,
+      providers,
+      exports: providers,
+      global: true
+    };
+  }
+};
+PipelineModule = __decorateClass([
+  Module({})
+], PipelineModule);
+var InjectPipeline = (token) => Inject(token.symbol);
+
+export { InjectPipeline, PipelineModule };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nestjs/pipeline.module.ts","../../src/nestjs/pipeline.decorator.ts"],"names":[],"mappings":";;;AAMO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,OAAO,QAAQ,OAAA,EAA+C;AAC5D,IAAA,MAAM,YAAwB,EAAC;AAE/B,IAAA,KAAA,MAAW,GAAA,IAAO,QAAQ,SAAA,EAAW;AACnC,MAAA,KAAA,MAAW,IAAA,IAAQ,IAAI,KAAA,EAAO;AAC5B,QAAA,SAAA,CAAU,KAAK,EAAE,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU,MAAM,CAAA;AAAA,MAClD;AAEA,MAAA,SAAA,CAAU,IAAA,CAAK;AAAA,QACb,OAAA,EAAY,IAAI,KAAA,CAAM,MAAA;AAAA,QACtB,UAAA,EAAY,IAAI,aAAA,KAAoD;AAClE,UAAA,MAAM,IAAI,IAAI,QAAA,CAAS,GAAA,CAAI,OAAA,IAAW,EAAE,CAAA;AACxC,UAAA,KAAA,MAAW,YAAY,aAAA,EAAe;AACpC,YAAA,CAAA,CAAE,KAAK,QAAQ,CAAA;AAAA,UACjB;AACA,UAAA,OAAO,CAAA;AAAA,QACT,CAAA;AAAA,QACA,QAAQ,GAAA,CAAI;AAAA,OACb,CAAA;AAAA,IACH;AAEA,IAAA,OAAO;AAAA,MACL,MAAA,EAAW,cAAA;AAAA,MACX,SAAA;AAAA,MACA,OAAA,EAAW,SAAA;AAAA,MACX,MAAA,EAAW;AAAA,KACb;AAAA,EACF;AACF;AA7Ba,cAAA,GAAN,eAAA,CAAA;AAAA,EADN,MAAA,CAAO,EAAE;AAAA,CAAA,EACG,cAAA,CAAA;ACHN,IAAM,cAAA,GAAiB,CAC5B,KAAA,KAC8B,MAAA,CAAO,MAAM,MAAM","file":"index.js","sourcesContent":["import { DynamicModule, Module, Provider } from '@nestjs/common';\nimport { Pipeline } from '../core/pipeline.js';\nimport type { PipelineStep } from '../core/types.js';\nimport type { PipelineModuleOptions } from './pipeline.options.js';\n\n@Module({})\nexport class PipelineModule {\n  static forRoot(options: PipelineModuleOptions): DynamicModule {\n    const providers: Provider[] = [];\n\n    for (const def of options.pipelines) {\n      for (const step of def.steps) {\n        providers.push({ provide: step, useClass: step });\n      }\n\n      providers.push({\n        provide:    def.token.symbol,\n        useFactory: (...stepInstances: PipelineStep<unknown, unknown>[]) => {\n          const p = new Pipeline(def.options ?? {});\n          for (const instance of stepInstances) {\n            p.pipe(instance);\n          }\n          return p;\n        },\n        inject: def.steps,\n      });\n    }\n\n    return {\n      module:    PipelineModule,\n      providers,\n      exports:   providers,\n      global:    true,\n    };\n  }\n}\n","import { Inject } from '@nestjs/common';\nimport type { PipelineToken } from '../core/define-pipeline.js';\n\nexport const InjectPipeline = <TContext, TError>(\n  token: PipelineToken<TContext, TError>,\n): ReturnType<typeof Inject> => Inject(token.symbol);\n"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@backendkit-labs/pipeline",
+  "version": "0.1.0",
+  "description": "Type-safe async pipeline — Chain of Responsibility with stop-on-first / collect-all modes, conditional steps, observability hooks, and optional NestJS integration",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types":   "./dist/index.d.ts",
+      "import":  "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./nestjs": {
+      "types":   "./dist/nestjs/index.d.ts",
+      "import":  "./dist/nestjs/index.js",
+      "require": "./dist/nestjs/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build":         "tsup",
+    "dev":           "tsup --watch",
+    "test":          "vitest run",
+    "test:watch":    "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck":     "tsc --noEmit",
+    "lint":          "eslint src/",
+    "prepublishOnly": "npm run build && npm run test && npm run lint"
+  },
+  "keywords": [
+    "pipeline", "chain-of-responsibility", "middleware", "handler",
+    "async", "typescript", "nestjs", "node", "pattern"
+  ],
+  "author": "Mairon José Cuello Martínez",
+  "license": "MIT",
+  "homepage": "https://github.com/backendkit-dev/backendkit-monorepo/tree/master/packages/pipeline#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/backendkit-dev/backendkit-monorepo.git",
+    "directory": "packages/pipeline"
+  },
+  "bugs": { "url": "https://github.com/backendkit-dev/backendkit-monorepo/issues" },
+  "publishConfig": { "access": "public" },
+  "sideEffects": false,
+  "engines": { "node": ">=18" },
+  "peerDependencies": {
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core":   ">=10.0.0",
+    "rxjs":           ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": { "optional": true },
+    "@nestjs/core":   { "optional": true },
+    "rxjs":           { "optional": true }
+  },
+  "devDependencies": {
+    "@eslint/js":        "^9.39.4",
+    "@nestjs/common":    "^10.0.0",
+    "@nestjs/core":      "^10.0.0",
+    "@types/node":       "^22.0.0",
+    "eslint":            "^9.0.0",
+    "reflect-metadata":  "^0.2.0",
+    "rxjs":              "^7.8.0",
+    "tsup":              "^8.0.0",
+    "typescript":        "^5.5.0",
+    "typescript-eslint": "^8.59.3",
+    "vitest":            "^2.0.0"
+  }
+}