3.4.95 • Published 4d ago

@pipeline-builder/pipeline-core

Licence

Apache-2.0

Version

3.4.95

Deps

Size

843 kB

Vulns

Weekly

2.7K

Summary Dependency Versions

@pipeline-builder/pipeline-core

View documentation

AWS CDK construct library for Pipeline Builder: the PipelineBuilder construct that assembles plugin specs into a CodePipeline stack, the PluginLookup custom resource, pipeline/plugin domain types, and shared configuration.

Internal workspace package — consumed by other packages via workspace:*.

Responsibilities

Provides the CDK constructs that synthesize a CodePipeline stack from plugin specs (PipelineBuilder, StageBuilder, PipelineConfiguration, ArtifactManager).
Resolves plugin specs at deploy time via the PluginLookup custom resource.
Hosts the synth-time template engine that parameterizes pipeline config and plugin specs.
Owns the pipeline/plugin domain types and the environment-driven application Config.
Re-exports the pipeline-data database layer so consumers depend on a single package for both CDK and DB access.

Key exports

CDK constructs

Export	Purpose
`PipelineBuilder`	Top-level construct that assembles plugin specs into a CodePipeline stack
`StageBuilder`	Composes pipeline stages from plugin steps
`PipelineConfiguration`	Resolves and merges pipeline config metadata
`ArtifactManager`	Manages build artifacts across stages
`PluginLookup`	Custom resource that resolves plugin specs at deploy time

Template engine (synth-time)

Export	Purpose
`tokenize`, `hasTemplate`	Parse template strings into tokens
`resolve`, `resolveString`, `dependencies`, `lookupPath`	Evaluate expressions and report dependencies
`resolveTemplates`, `resolveSelfReferencing`	Walk a document and resolve string fields in place
`walkAndBind`, `topoSort`, `validateTemplates`, `TokenCache`	Field binding, dependency ordering, validation, and token caching

Domain types & config

Export	Purpose
`Config`, `ConfigTypes`	Environment-driven application config singleton and typed interfaces
`PipelineType`, `ComputeType`, `AccessModifier`, `PluginType`	Pipeline domain enums
`SourceTypes`, `StepTypes`, `NetworkTypes`, `RoleTypes`, `SecurityGroupTypes`	Pipeline source/step and infrastructure type definitions
`IdGenerator`, `replaceNonAlphanumeric`, `extractMetadataEnv`	ID generation and string/metadata helpers
`buildConfigFromMetadata`, `metadataForCodePipeline`, `metadataForShellStep`, …	Metadata builders

Re-exported from `pipeline-data`

db, getConnection, closeConnection, schema, CrudService, runMigrations, the tenant-context primitives (tenantContext, runWithTenantContext, withTenantTx), the query condition builders/filters, and drizzleRows / drizzleCount.

Usage

import { PipelineBuilder, Config } from '@pipeline-builder/pipeline-core';

const config = Config.getInstance();

new PipelineBuilder(this, 'Pipeline', {
  // plugin specs + pipeline config resolved into a CodePipeline stack
});

Development

pnpm build   # projen build (compile + lint + test + package)
pnpm test    # run the Jest test suite

License

Apache-2.0. See LICENSE.