lib.progressive-delivery
Progressive-delivery contracts and runtime controls for safe staged rollouts.
@lssm-tech/lib.progressive-deliverybun add @lssm-tech/lib.progressive-deliveryManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Progressive delivery and canary release primitives. Provides strategy definitions and rollout logic for safe, incremental deployments.
What It Provides
- Layer: lib.
- Consumers: bundles.
- Related ContractSpec packages include
@lssm-tech/lib.observability,@lssm-tech/tool.bun,@lssm-tech/tool.typescript. - Related ContractSpec packages include
@lssm-tech/lib.observability,@lssm-tech/tool.bun,@lssm-tech/tool.typescript.
Installation
npm install @lssm-tech/lib.progressive-delivery
or
bun add @lssm-tech/lib.progressive-delivery
Usage
Import the root entrypoint from @lssm-tech/lib.progressive-delivery, or choose a documented subpath when you only need one part of the package surface.
Architecture
src/canary-analyzer.tsis part of the package's public or composition surface.src/canary-controller.tsis part of the package's public or composition surface.src/deployment-coordinator.tsis part of the package's public or composition surface.src/events.tsis package-level event definitions.src/feature-flags.tsis part of the package's public or composition surface.src/index.tsis the root public barrel and package entrypoint.src/rollback-manager.tsis part of the package's public or composition surface.
Public Entry Points
- Export
.resolves through./src/index.ts.
Local Commands
bun run dev— contractspec-bun-build devbun run build— contractspec-bun-build buildbun run lint— bun lint:fixbun run lint:check— biome check .bun run lint:fix— biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .bun run typecheck— tsgo --noEmitbun run publish:pkg— bun publish --tolerate-republish --ignore-scripts --verbosebun run publish:pkg:canary— bun publish:pkg --tag canarybun run clean— rimraf dist .turbobun run build:bundle— contractspec-bun-build transpilebun run build:types— contractspec-bun-build typesbun run prebuild— contractspec-bun-build prebuild
Recent Updates
- Replace eslint+prettier by biomejs to optimize speed.
Notes
- Delivery strategies must be deterministic — same input must produce same rollout decision.
- Peer dependency on observability; ensure OTel integration stays aligned.
- Strategy interface changes affect all deployment pipelines consuming this lib.
The package Turbo extension explicitly schedules observability before full and declaration-only builds. Observability remains a peer dependency for consumers; its declaration artifact must exist before the workspace declaration resolver runs.
PWA update contracts
The pure @lssm-tech/lib.progressive-delivery/pwa entry owns browser frontend release checks, optional/blocking update policy contracts and prompt/applied/ deferred telemetry. This extends staged-release ownership to client update delivery; service-worker activation remains host-owned. The leaf does not import canary controllers, deployment coordinators, observability or other runtime roots.
Existing @lssm-tech/lib.contracts-spec/pwa imports and deeper contract paths forward to these exact definitions. Core continues to own portable manifest models, and the runtime kernel owns manifest registries and version selection. Wire keys, REST routes, anonymous check policy and registration behavior are preserved. Capability registry types refer to the existing SurfaceRuntime owner.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
4 declarations
@lssm-tech/lib.contracts-spec-coreworkspace:^
Read the package manual ↗@lssm-tech/lib.schemaworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-runtime-kernelworkspace:^
Read the package manual ↗@lssm-tech/lib.surface-runtimeworkspace:^
Read the package manual ↗
Declared capabilities
Progressive-delivery contracts and runtime controls for safe staged rollouts.
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .prebuildcontractspec-bun-build prebuildtestbun testtypechecktsgo --noEmit