@composurecdk/core 0.1.2 → 0.3.0

package/README.md

@@ -0,0 +1,98 @@
+# @composurecdk/core
+
+Core primitives for [ComposureCDK](../../README.md).
+
+This package provides the foundational types and utilities that all ComposureCDK resource packages build on: the fluent `Builder` proxy, the `compose` function for assembling component systems with dependency resolution, lazy `Ref` cross-references, and stack strategies for routing components to scopes.
+
+Most users interact with these primitives indirectly through resource packages (e.g., `@composurecdk/lambda`, `@composurecdk/s3`). Use this package directly when building a custom ComposureCDK resource package or when composing systems.
+
+## Builder
+
+Generic fluent-builder factory that wraps a class, exposing every property in `Props` as an overloaded getter/setter method. Resource packages use this internally to create their builders.
+
+```ts
+import { Builder, type IBuilder } from "@composurecdk/core";
+
+type IMyBuilder = IBuilder<MyProps, MyLifecycle>;
+
+export function createMyBuilder(): IMyBuilder {
+  return Builder<MyProps, MyLifecycle>(MyLifecycle);
+}
+```
+
+## compose
+
+Composes a set of `Lifecycle` components into a single system with automatic dependency resolution. Dependencies are declared as data; the system builds components in topological order and passes resolved outputs as context.
+
+```ts
+import { compose } from "@composurecdk/core";
+
+const system = compose(
+  { handler: createFunctionBuilder(), api: createRestApiBuilder() },
+  { handler: [], api: ["handler"] },
+);
+
+system.build(stack, "MySystem");
+```
+
+Cyclic dependencies are detected at composition time and throw a `CyclicDependencyError`.
+
+### Stack routing
+
+Route components to different scopes (typically Stacks) using `withStacks` or `withStackStrategy`:
+
+```ts
+// Explicit scope mapping
+system.withStacks({ handler: serviceStack, api: apiStack }).build(app, "MySystem");
+
+// Strategy-based routing
+import { singleStack, groupedStacks } from "@composurecdk/core";
+
+system.withStackStrategy(singleStack(myFactory)).build(app, "MySystem");
+
+system
+  .withStackStrategy(groupedStacks((key) => (key === "handler" ? "compute" : "api"), myFactory))
+  .build(app, "MySystem");
+```
+
+### Post-build hooks
+
+Register callbacks that run after all components are built via `afterBuild`. Domain-specific packages provide helper functions that return hooks — for example, `outputs()` from `@composurecdk/cloudformation`.
+
+```ts
+system
+  .afterBuild((scope, id, results) => {
+    console.log("Built:", Object.keys(results));
+  })
+  .build(stack, "MySystem");
+```
+
+## Ref
+
+Lazy cross-component references that are resolved at build time. Use `ref` to reference a dependency's output at configuration time — the value is resolved when the system is built.
+
+```ts
+import { ref } from "@composurecdk/core";
+import type { FunctionBuilderResult } from "@composurecdk/lambda";
+
+// Reference the full build result
+ref<FunctionBuilderResult>("handler");
+
+// Narrow to a specific property
+ref<FunctionBuilderResult>("handler").get("function");
+
+// Transform the referenced value
+ref<FunctionBuilderResult>("handler")
+  .get("function")
+  .map((fn) => new LambdaIntegration(fn));
+
+// Shorthand with inline transform
+ref<FunctionBuilderResult>("handler", (r) => new LambdaIntegration(r.function));
+```
+
+## Examples
+
+- [MultiStackApp](../examples/src/multi-stack-app.ts) — System composed with `withStacks` for multi-stack routing
+- [StrategyStackApp](../examples/src/strategy-stack-app.ts) — System composed with `withStackStrategy`
+- [LambdaApiStack](../examples/src/lambda-api-app.ts) — Cross-component wiring with `ref`
+- [StaticWebsiteStack](../examples/src/static-website/app.ts) — S3 + CloudFront composed system with `ref` and `afterBuild`

package/dist/compose.d.ts

@@ -21,9 +21,32 @@ type BuildResult<T extends {
  * @typeParam Components - The full set of components in the system.
  */
 type Dependency<Components extends Record<string, Lifecycle>> = (keyof Components)[];
+/**
+ * A callback invoked after all components in a composed system have been
+ * built. Receives the scope, system id, and the fully-typed build results
+ * of every component. Use this to create additional constructs that depend
+ * on the composed system's outputs — CloudFormation outputs, tags, alarms,
+ * dashboards, etc.
+ *
+ * Domain-specific packages provide helper functions that return hooks. For
+ * example, `@composurecdk/cloudformation` exports {@link outputs} which
+ * creates `CfnOutput` constructs from {@link Ref}-based definitions.
+ *
+ * @typeParam T - The build result type of the composed system.
+ *
+ * @example
+ * ```ts
+ * const logResults: AfterBuildHook<{ site: BucketBuilderResult }> =
+ *   (_scope, _id, results) => {
+ *     console.log("Bucket:", results.site.bucket.bucketName);
+ *   };
+ * ```
+ */
+export type AfterBuildHook<T extends object> = (scope: IConstruct, id: string, results: T) => void;
 /**
  * A {@link Lifecycle} produced by {@link compose}, extended with methods
- * for controlling how components are routed to scopes during build.
+ * for controlling how components are routed to scopes and for registering
+ * post-build hooks.
  *
  * Because `ComposedSystem` extends `Lifecycle`, a composed system can be
  * nested as a component inside another `compose` call — composition is
@@ -50,13 +73,18 @@ export interface ComposedSystem<Components extends Record<string, Lifecycle>> ex
      */
     withStacks(stacks: {
         [K in keyof Components]?: IConstruct;
-    }): Lifecycle<BuildResult<Components>>;
+    }): ConfiguredSystem<Components>;
     /**
-     * Returns a new {@link Lifecycle} that uses a {@link StackStrategy} to
-     * determine each component's scope during build.
+     * Returns a new {@link ConfiguredSystem} that uses a {@link StackStrategy}
+     * to determine each component's scope during build. The returned system
+     * supports further chaining of {@link ConfiguredSystem.afterBuild | .afterBuild()} hooks.
+     *
+     * Mutually exclusive with {@link withStacks} — calling one locks the
+     * stack routing; further stack-routing methods are not available on the
+     * returned {@link ConfiguredSystem}.
      *
      * @param strategy - The strategy that resolves scopes for components.
-     * @returns A {@link Lifecycle} with strategy-based stack routing applied.
+     * @returns A {@link ConfiguredSystem} with strategy-based stack routing applied.
      *
      * @example
      * ```ts
@@ -65,10 +93,59 @@ export interface ComposedSystem<Components extends Record<string, Lifecycle>> ex
      *     key => key === "table" ? "persistence" : "service",
      *     (app, id) => new Stack(app, id),
      *   ))
+     *   .afterBuild(outputs({ ... }))
      *   .build(app, "MySystem");
      * ```
      */
-    withStackStrategy(strategy: StackStrategy): Lifecycle<BuildResult<Components>>;
+    withStackStrategy(strategy: StackStrategy): ConfiguredSystem<Components>;
+    /**
+     * Returns a new {@link ConfiguredSystem} that invokes the given hook after
+     * all components have been built. The hook receives the scope, system id,
+     * and the fully-typed build results.
+     *
+     * Multiple hooks can be chained — each `.afterBuild()` appends to the
+     * hook list and returns the same {@link ConfiguredSystem} for further
+     * chaining.
+     *
+     * This is the extension point for adding post-build behaviour to a
+     * composed system without modifying the system itself. Domain-specific
+     * packages provide helper functions that return hooks — for example,
+     * `outputs()` from `@composurecdk/cloudformation` creates CfnOutput
+     * constructs.
+     *
+     * @param hook - A callback invoked after all components are built.
+     * @returns A {@link ConfiguredSystem} with the hook applied.
+     *
+     * @example
+     * ```ts
+     * compose({ site, cdn }, { site: [], cdn: ["site"] })
+     *   .afterBuild(outputs({
+     *     Url: { value: ref("cdn", r => r.distribution.domainName) },
+     *   }))
+     *   .build(stack, "MySystem");
+     * ```
+     */
+    afterBuild(hook: AfterBuildHook<BuildResult<Components>>): ConfiguredSystem<Components>;
+}
+/**
+ * A {@link Lifecycle} with stack routing or post-build hooks applied.
+ * Returned by {@link ComposedSystem.withStacks},
+ * {@link ComposedSystem.withStackStrategy}, and
+ * {@link ComposedSystem.afterBuild}.
+ *
+ * Supports chaining further {@link afterBuild} hooks. Stack routing methods
+ * are not available — they are mutually exclusive and must be chosen on
+ * the original {@link ComposedSystem}.
+ */
+export interface ConfiguredSystem<Components extends Record<string, Lifecycle>> extends Lifecycle<BuildResult<Components>> {
+    /**
+     * Appends a post-build hook. Multiple hooks can be chained; they execute
+     * in registration order after all components have been built.
+     *
+     * @param hook - A callback invoked after all components are built.
+     * @returns This {@link ConfiguredSystem} for further chaining.
+     */
+    afterBuild(hook: AfterBuildHook<BuildResult<Components>>): ConfiguredSystem<Components>;
 }
 /**
  * Composes a set of {@link Lifecycle} components into a single system that

package/dist/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS;KAAG,QAAQ,IAAI,MAAM,CAAC,GAAG,SAAS;CAAE,IAAI;KAChE,QAAQ,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;GAMG;AACH,KAAK,UAAU,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,EAAE,CAAC;AA+BrF;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAE,SAAQ,SAAS,CAC7F,WAAW,CAAC,UAAU,CAAC,CACxB;IACC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,EAAE,UAAU;KAAE,GAAG,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjG;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;CAChF;AAyDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAClE,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE;KAAG,QAAQ,IAAI,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;CAAE,GACvE,cAAc,CAAC,UAAU,CAAC,CAE5B"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS;KAAG,QAAQ,IAAI,MAAM,CAAC,GAAG,SAAS;CAAE,IAAI;KAChE,QAAQ,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;GAMG;AACH,KAAK,UAAU,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,EAAE,CAAC;AA+BrF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAEnG;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAE,SAAQ,SAAS,CAC7F,WAAW,CAAC,UAAU,CAAC,CACxB;IACC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,UAAU,CAAC,CAAC,EAAE,UAAU;KAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE3F;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;CACzF;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAE,SAAQ,SAAS,CAC/F,WAAW,CAAC,UAAU,CAAC,CACxB;IACC;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;CACzF;AAwFD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAClE,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE;KAAG,QAAQ,IAAI,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;CAAE,GACvE,cAAc,CAAC,UAAU,CAAC,CAE5B"}

package/dist/compose.js

@@ -33,17 +33,16 @@ class ComposedLifecycle {
         this.graph = buildDependencyGraph(components, dependencies);
     }
     withStacks(stacks) {
-        return {
-            build: (scope, id) => this.buildWith(scope, id, stacks),
-        };
+        return new ConfiguredLifecycle((scope, id) => this.buildWith(scope, id, stacks));
     }
     withStackStrategy(strategy) {
-        return {
-            build: (scope, id) => {
-                const stacks = Object.fromEntries(Object.keys(this.components).map((key) => [key, strategy.resolve(scope, id, key)]));
-                return this.buildWith(scope, id, stacks);
-            },
-        };
+        return new ConfiguredLifecycle((scope, id) => {
+            const stacks = Object.fromEntries(Object.keys(this.components).map((key) => [key, strategy.resolve(scope, id, key)]));
+            return this.buildWith(scope, id, stacks);
+        });
+    }
+    afterBuild(hook) {
+        return new ConfiguredLifecycle((scope, id) => this.buildWith(scope, id)).afterBuild(hook);
     }
     build(scope, id) {
         return this.buildWith(scope, id);
@@ -59,6 +58,30 @@ class ComposedLifecycle {
         return results;
     }
 }
+/**
+ * A configured lifecycle that accumulates post-build hooks and applies them
+ * after the underlying build function completes. Returned by
+ * {@link ComposedLifecycle}'s `withStacks`, `withStackStrategy`, and
+ * `afterBuild` methods.
+ */
+class ConfiguredLifecycle {
+    buildFn;
+    hooks = [];
+    constructor(buildFn) {
+        this.buildFn = buildFn;
+    }
+    afterBuild(hook) {
+        this.hooks.push(hook);
+        return this;
+    }
+    build(scope, id) {
+        const results = this.buildFn(scope, id);
+        for (const hook of this.hooks) {
+            hook(scope, id, results);
+        }
+        return results;
+    }
+}
 /**
  * Composes a set of {@link Lifecycle} components into a single system that
  * manages their build order and dependency resolution.

package/dist/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { Builder, type IBuilder } from "./builder.js";
-export { compose, type ComposedSystem } from "./compose.js";
+export { compose, type ComposedSystem, type ConfiguredSystem, type AfterBuildHook, } from "./compose.js";
 export { CyclicDependencyError } from "./cyclic-dependency-error.js";
 export { type Lifecycle } from "./lifecycle.js";
 export { Ref, ref, resolve, isRef, type Resolvable } from "./ref.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,WAAW,EACX,aAAa,GACd,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,WAAW,EACX,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { Builder } from "./builder.js";
-export { compose } from "./compose.js";
+export { compose, } from "./compose.js";
 export { CyclicDependencyError } from "./cyclic-dependency-error.js";
 export { Ref, ref, resolve, isRef } from "./ref.js";
 export { singleStack, groupedStacks, } from "./stack-strategy.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiB,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAuB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAmB,MAAM,UAAU,CAAC;AACrE,OAAO,EAGL,WAAW,EACX,aAAa,GACd,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiB,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,OAAO,GAIR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAmB,MAAM,UAAU,CAAC;AACrE,OAAO,EAGL,WAAW,EACX,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@composurecdk/core",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "Composable CDK component system — lifecycle, dependency resolution, and builder pattern",
   "repository": {
     "type": "git",