@flow-as-code/cdk 0.1.0

package/dist/flow-set.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { FlowSet as FlowSetClass, FlowSetProps } from "./flow-set.js";
+export { bindRef, type TokenBinder } from "./binder.js";
+export type { FlowSetProps };
+export declare const DEFAULT_MODULE_ALIAS: string;
+export declare const FlowSet: typeof FlowSetClass;
+export type FlowSet = FlowSetClass;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,CAAC;AAqB7B,eAAO,MAAM,oBAAoB,EAAE,MAAqC,CAAC;AACzE,eAAO,MAAM,OAAO,EAAE,OAAO,YAA8B,CAAC;AAC5D,MAAM,MAAM,OAAO,GAAG,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// CDK binding for @flow-as-code/core. See README.md.
+//
+// TokenBinder maps FlowDoc references to CloudFormation-token strings;
+// FlowSet turns a set of FlowDocs into AWS::Connect resources with module
+// version publishing and alias repointing.
+//
+// aws-cdk-lib and constructs are OPTIONAL peers, so that installing @flow-as-code/cli
+// (which only reaches this package through the ./scaffold subpath, and that
+// subpath imports no CDK) does not drag 168 MB of CDK in. The cost is that npm
+// no longer warns at install time, so a consumer who forgets them used to meet
+// a bare ERR_MODULE_NOT_FOUND for aws-cdk-lib raised from flow-set.js. ESM
+// resolves the whole graph before any module body runs, so the only way to
+// front-run that is to keep flow-set.js off the static import graph: this
+// module checks the peer itself and then loads flow-set through a dynamic
+// import. The type-only imports below are erased and pull in nothing.
+import { createRequire } from "node:module";
+import { PACKAGE_NAMES } from "@flow-as-code/core";
+export { bindRef } from "./binder.js";
+/** Peer floor, kept in step with peerDependencies in package.json. */
+const CDK_PEERS = "aws-cdk-lib@^2.267.0 constructs@^10.8.1";
+function assertCdkPeersInstalled() {
+    try {
+        createRequire(import.meta.url).resolve("aws-cdk-lib");
+    }
+    catch {
+        throw new Error(`${PACKAGE_NAMES.cdk} needs the CDK at runtime, but aws-cdk-lib is not installed. ` +
+            "It and constructs are optional peers so that a CLI-only install stays small, " +
+            `which means npm does not warn about them at install time. Install them with: npm install ${CDK_PEERS}`);
+    }
+}
+assertCdkPeersInstalled();
+const flowSet = await import("./flow-set.js");
+export const DEFAULT_MODULE_ALIAS = flowSet.DEFAULT_MODULE_ALIAS;
+export const FlowSet = flowSet.FlowSet;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qDAAqD;AACrD,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,2CAA2C;AAC3C,EAAE;AACF,sFAAsF;AACtF,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,2EAA2E;AAC3E,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,sEAAsE;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAGxD,sEAAsE;AACtE,MAAM,SAAS,GAAG,yCAAyC,CAAC;AAE5D,SAAS,uBAAuB;IAC9B,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,GAAG,aAAa,CAAC,GAAG,+DAA+D;YACjF,+EAA+E;YAC/E,4FAA4F,SAAS,EAAE,CAC1G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,uBAAuB,EAAE,CAAC;AAE1B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAW,OAAO,CAAC,oBAAoB,CAAC;AACzE,MAAM,CAAC,MAAM,OAAO,GAAwB,OAAO,CAAC,OAAO,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,31 @@
+import { type FlowDoc, type RefType } from "@flow-as-code/core";
+/** Basename of the file the scaffold is written to. */
+export declare const CDK_SCAFFOLD_FILE = "flow-stack.ts";
+/**
+ * Reference names per type across the whole set, sorted and deduplicated.
+ *
+ * A document's `refs` index is the authored answer, but it is derived data and
+ * nothing in the schema forces it to be current, so the content is scanned too
+ * and the two are unioned. A stale index can therefore only add a binder method
+ * the set does not strictly need, never drop one it does.
+ */
+export declare function referencedNames(docs: readonly FlowDoc[]): Map<RefType, string[]>;
+/**
+ * The FLOW_DOCS expression for an output directory `depth` levels below the
+ * directory holding the FlowDocs: `.`, `..`, `../..`. This is what node's
+ * `path.relative` produces for the same pair, which is what the CLI passes;
+ * packages/studio/tests/exportParity.test.ts compares the two byte for
+ * byte on a real `flow-cli emit --target cdk --out` run.
+ */
+export declare function sourceForDepth(depth: number): string;
+export interface CdkScaffoldInput {
+    docs: readonly FlowDoc[];
+    /**
+     * Where FlowSet reads the `*.flowdoc.json` files, relative to the scaffold:
+     * `.` when they sit beside it, `..` from a subdirectory. See sourceForDepth.
+     */
+    source: string;
+}
+/** The scaffold source. Pure: no filesystem access, no clock, no randomness. */
+export declare function cdkScaffold({ docs, source }: CdkScaffoldInput): string;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,KAAK,OAAO,EAAiB,KAAK,OAAO,EAAe,MAAM,oBAAoB,CAAC;AAE5F,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAyBjD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAWhF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAmBD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAuEtE"}

package/dist/scaffold.js

@@ -0,0 +1,176 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// The CDK stack scaffold, shared by `flow-cli emit --target cdk` and the
+// studio's CDK export button.
+//
+// @flow-as-code/cdk is a library, not a code generator: FlowSet reads the FlowDoc
+// directory at synth time, so there is nothing per-document to emit. What a
+// user actually has to write by hand is the stack that instantiates it and,
+// above all, the TokenBinder, whose method set depends on which reference types
+// their documents use. That is what this generates: a valid, compiling starting
+// point with a TODO on exactly the binder methods the document set needs.
+//
+// It lives in the package whose API it writes, and is published as
+// `@flow-as-code/cdk/scaffold`, so the CLI and the studio emit the
+// same bytes instead of two implementations that drift. The studio cannot
+// import the CLI (the CLI depends on the studio for its built assets) and
+// parity between the two is the point of the feature, so a shared module is
+// the only arrangement that holds.
+//
+// Pure by contract: no node builtins, no filesystem, no clock, no randomness,
+// because this module is bundled into a browser. The one calculation that
+// needs a path, the FLOW_DOCS expression, is passed in as `source`: the CLI
+// computes it with node:path and the studio with `sourceForDepth` below.
+//
+// Deterministic: same documents in, byte-identical TypeScript out. Reference
+// types and names are sorted, and nothing in the output depends on the order
+// files were read.
+//
+// FlowSet resolves `${cdref:module:...}` itself against the modules it manages,
+// so `module` never appears on a binder (packages/cdk/src/binder.ts).
+import { PACKAGE_NAMES, collectRefs } from "@flow-as-code/core";
+/** Basename of the file the scaffold is written to. */
+export const CDK_SCAFFOLD_FILE = "flow-stack.ts";
+/** Required TokenBinder methods, in the order they are emitted. */
+const REQUIRED_TYPES = ["hours", "lambda", "lex", "prompt", "queue"];
+/** What each binder method must return, echoing packages/cdk/src/binder.ts. */
+const RETURNS = {
+    flow: "ARN of a contact flow not managed by this FlowSet",
+    hours: "ARN of the hours of operation, e.g. hours.attrHoursOfOperationArn",
+    lambda: "ARN of the Lambda function, e.g. fn.functionArn",
+    lex: "ARN of the Lex bot alias",
+    prompt: "ARN of the prompt",
+    queue: "ARN of the queue, e.g. queue.attrQueueArn",
+};
+/** What each reference type names, for the comment on an unused method. */
+const NOUNS = {
+    flow: "contact flow",
+    hours: "hours of operation",
+    lambda: "Lambda function",
+    lex: "Lex bot alias",
+    prompt: "prompt",
+    queue: "queue",
+};
+/**
+ * Reference names per type across the whole set, sorted and deduplicated.
+ *
+ * A document's `refs` index is the authored answer, but it is derived data and
+ * nothing in the schema forces it to be current, so the content is scanned too
+ * and the two are unioned. A stale index can therefore only add a binder method
+ * the set does not strictly need, never drop one it does.
+ */
+export function referencedNames(docs) {
+    const byType = new Map();
+    for (const doc of docs) {
+        for (const ref of [...(doc.refs ?? []), ...collectRefs(doc.content)]) {
+            if (ref.type === "module")
+                continue;
+            const names = byType.get(ref.type) ?? new Set();
+            names.add(ref.name);
+            byType.set(ref.type, names);
+        }
+    }
+    return new Map([...byType].map(([type, names]) => [type, [...names].sort()]));
+}
+/**
+ * The FLOW_DOCS expression for an output directory `depth` levels below the
+ * directory holding the FlowDocs: `.`, `..`, `../..`. This is what node's
+ * `path.relative` produces for the same pair, which is what the CLI passes;
+ * packages/studio/tests/exportParity.test.ts compares the two byte for
+ * byte on a real `flow-cli emit --target cdk --out` run.
+ */
+export function sourceForDepth(depth) {
+    if (depth <= 0)
+        return ".";
+    return Array.from({ length: depth }, () => "..").join("/");
+}
+function binderMethod(type, names) {
+    const returns = RETURNS[type] ?? "ARN of the referenced resource";
+    const noun = NOUNS[type] ?? type;
+    const head = names.length === 0
+        ? [`  // No document in this set references a ${noun}.`]
+        : [`  // TODO: return the ${returns}.`, `  // Names referenced: ${names.join(", ")}.`];
+    return [
+        ...head,
+        `  ${type}: (name) => {`,
+        names.length === 0
+            ? `    throw new Error(\`Unexpected ${type} reference "\${name}".\`);`
+            : `    throw new Error(\`TODO: bind ${type} "\${name}" to an ARN.\`);`,
+        "  },",
+    ];
+}
+/** The scaffold source. Pure: no filesystem access, no clock, no randomness. */
+export function cdkScaffold({ docs, source }) {
+    const referenced = referencedNames(docs);
+    const types = [...REQUIRED_TYPES];
+    // `flow` is optional on TokenBinder, so it is emitted only when it is used.
+    if ((referenced.get("flow") ?? []).length > 0)
+        types.unshift("flow");
+    const used = [...referenced]
+        .filter(([, names]) => names.length > 0)
+        .map(([type]) => type)
+        .sort();
+    const names = docs.map((d) => `${d.kind} ${d.name}`).sort();
+    // No licence header: this file lands in a user's project and is theirs, not
+    // ours. Same reasoning as codegen's banner (packages/core/src/codegen.ts).
+    const lines = [
+        "// Generated by `flow-cli emit --target cdk` as a starting point, then yours to",
+        "// keep: re-running the command overwrites this file, so move it or rename it",
+        "// once you have edited it.",
+        "//",
+        `// Documents in the set: ${names.join(", ")}.`,
+        "//",
+        "// FlowSet reads every *.flowdoc.json in the source directory at synth time and",
+        "// creates AWS::Connect::ContactFlow and AWS::Connect::ContactFlowModule",
+        "// resources, publishing a module version and repointing its alias whenever the",
+        `// module content changes. See the ${PACKAGE_NAMES.cdk} README.`,
+        "",
+        'import { fileURLToPath } from "node:url";',
+        "",
+        'import { Stack, type StackProps } from "aws-cdk-lib";',
+        `import { FlowSet, type TokenBinder } from "${PACKAGE_NAMES.cdk}";`,
+        'import type { Construct } from "constructs";',
+        "",
+        "/**",
+        " * Directory holding the FlowDocs. Resolved against this file rather than the",
+        " * working directory, so `cdk synth` works from the project root, from here, or",
+        " * from anywhere else.",
+        " */",
+        `const FLOW_DOCS = fileURLToPath(new URL(${JSON.stringify(source)}, import.meta.url));`,
+        "",
+        "/**",
+        " * Resolves each reference token in the documents to a CloudFormation token,",
+        ` * normally a construct attribute. ${PACKAGE_NAMES.cdk} inserts what you`,
+        " * return byte for byte, so CDK tokens pass through and CloudFormation",
+        " * resolves them at deploy time. Never return a literal ARN here.",
+        " *",
+        used.length === 0
+            ? " * These documents contain no references."
+            : ` * These documents reference: ${used.join(", ")}.`,
+        " */",
+        "const binder: TokenBinder = {",
+        ...types.flatMap((type) => binderMethod(type, referenced.get(type) ?? [])),
+        "};",
+        "",
+        "export interface FlowStackProps extends StackProps {",
+        "  /** ARN of the Amazon Connect instance these flows deploy into. */",
+        "  instanceArn: string;",
+        "}",
+        "",
+        "export class FlowStack extends Stack {",
+        "  constructor(scope: Construct, id: string, props: FlowStackProps) {",
+        "    super(scope, id, props);",
+        "",
+        '    new FlowSet(this, "Flows", {',
+        "      instanceArn: props.instanceArn,",
+        "      source: FLOW_DOCS,",
+        "      binder,",
+        "    });",
+        "  }",
+        "}",
+    ];
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@flow-as-code/cdk",
+  "version": "0.1.0",
+  "description": "CDK binding for @flow-as-code/core: materialize FlowDoc refs as CloudFormation tokens; FlowSet construct with module version/alias publishing; a CDK stack scaffold generator on the /scaffold subpath.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./scaffold": {
+      "types": "./dist/scaffold.d.ts",
+      "import": "./dist/scaffold.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "!**/*.test.ts",
+    "!**/*.test.tsx",
+    "!**/__fixtures__",
+    "!**/__generated__",
+    "!**/*.tsbuildinfo",
+    "!**/__snapshots__",
+    "!**/*.snap",
+    "!**/test-helpers.ts",
+    "!**/test-helpers.tsx"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@flow-as-code/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "aws-cdk-lib": "^2.267.0",
+    "constructs": "^10.8.1"
+  },
+  "peerDependenciesMeta": {
+    "aws-cdk-lib": {
+      "optional": true
+    },
+    "constructs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "aws-cdk-lib": "^2.267.0",
+    "constructs": "^10.8.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flow-as-code/flow-as-code.git",
+    "directory": "packages/cdk"
+  },
+  "homepage": "https://github.com/flow-as-code/flow-as-code/tree/main/packages/cdk#readme",
+  "bugs": {
+    "url": "https://github.com/flow-as-code/flow-as-code/issues"
+  }
+}

package/src/binder.ts

@@ -0,0 +1,77 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// TokenBinder: the user's side of CDK materialization.
+//
+// A binder maps each non-module reference in a FlowDoc to a string, normally a
+// CloudFormation token from an L1/L2 construct attribute (queue.attrQueueArn,
+// fn.functionArn, a Lex alias ARN). @flow-as-code/core's materializeWithBinder inserts
+// the returned string byte-for-byte, so CDK tokens survive untouched and
+// CloudFormation resolves them per account at deploy time. No resource map, no
+// literal ARNs in this path.
+//
+// Module references (`${cdref:module:name@alias}`) are deliberately absent:
+// FlowSet manages the module resources itself and resolves those tokens to the
+// alias ARN of the CfnContactFlowModuleAlias it created (see flow-set.ts).
+
+import type { RefEntry } from "@flow-as-code/core";
+
+/**
+ * Maps reference names to CloudFormation-token strings. Implemented by the
+ * user, typically as thin closures over constructs in the same stack.
+ *
+ * `flow` is optional because cross-flow references are rare; a doc set that
+ * uses `${cdref:flow:...}` against a binder without `flow()` fails synth with
+ * an error naming the token.
+ */
+/**
+ * Boundary worth knowing: a binder may return any opaque string and it passes
+ * through byte-exact, EXCEPT that CDK itself parses `${Token[...]}` markers.
+ * Returning a string containing an unregistered marker such as
+ * `${Token[TOKEN.999]}` fails deep inside aws-cdk-lib with "Unrecognized token
+ * key". Real tokens (Fn.importValue, attr getters) are registered and fine.
+ * This is CDK's behavior, not something this package can intercept.
+ */
+export interface TokenBinder {
+  /** ARN of the queue, e.g. `queue.attrQueueArn`. */
+  queue(name: string): string;
+  /** ARN of the hours of operation, e.g. `hours.attrHoursOfOperationArn`. */
+  hours(name: string): string;
+  /** ARN of the Lambda function, e.g. `fn.functionArn`. */
+  lambda(name: string): string;
+  /** ARN of the Lex bot alias. */
+  lex(name: string): string;
+  /** ARN of the prompt. */
+  prompt(name: string): string;
+  /** ARN of a contact flow not managed by this FlowSet. */
+  flow?(name: string): string;
+}
+
+/**
+ * Resolves one non-module reference through the binder. Throws a diagnostic
+ * naming the token, the document, and the missing method when the binder
+ * cannot answer, so the failure is actionable without a stack-trace dig.
+ */
+export function bindRef(binder: TokenBinder, ref: RefEntry, docName: string): string {
+  if (ref.type === "module") {
+    // FlowSet resolves module refs itself; reaching here is a programming
+    // error in the caller, not a binder gap.
+    throw new Error(`Internal: module ref ${ref.token} must be resolved by FlowSet, not a binder.`);
+  }
+  const method = binder[ref.type];
+  if (typeof method !== "function") {
+    throw new Error(
+      `TokenBinder has no ${ref.type}() method, but "${docName}" contains ${ref.token}. ` +
+        `Implement ${ref.type}(name) on the binder.`,
+    );
+  }
+  const value = method.call(binder, ref.name);
+  if (typeof value !== "string") {
+    throw new Error(
+      `TokenBinder.${ref.type}("${ref.name}") returned ${String(value)} for ${ref.token} ` +
+        `in "${docName}". Binder methods must return a string.`,
+    );
+  }
+  return value;
+}