@flow-as-code/core 0.1.0

package/dist/blocks.js

@@ -0,0 +1,352 @@
+/*
+ * Copyright 2026 The flow-as-code Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Builder blocks.
+//
+// Blocks map one-to-one onto Connect Actions. That is deliberate: the
+// round-trip invariant (synth(codegen(doc)) equals doc) is a non-negotiable,
+// and a block that expanded into several Actions could not be recognised again
+// on the way back. So "transfer to queue", which needs both an
+// UpdateContactTargetQueue and a TransferContactToQueue, is two blocks.
+//
+// Error branches are required properties on a config object rather than
+// something enforced by a fluent builder's type state. Omitting one is a real
+// compile-time error, and a plain object literal is something codegen can emit
+// as idiomatic, diffable TypeScript. See docs/adr/0002-error-branch-enforcement.md.
+import { ActionType, DTMF_DIGITS, EXTRA_ERRORS, INPUT_TIME_LIMIT_EXCEEDED, INPUT_TIMEOUT_MAX, INPUT_TIMEOUT_MIN, LAMBDA_TIMEOUT_MAX, LAMBDA_TIMEOUT_MIN, NO_MATCHING_CONDITION, NO_MATCHING_ERROR, } from "./actions.js";
+import { isValidIdentifier } from "./flowdoc.js";
+export function targetId(t) {
+    return typeof t === "string" ? t : t.id;
+}
+export class Block {
+    id;
+    constructor(id) {
+        if (!isValidIdentifier(id)) {
+            throw new Error(`Invalid Identifier "${id}". Must be 1 to 50 characters and must not contain % : ( \\ / ) = $ , ; [ ] { }.`);
+        }
+        this.id = id;
+    }
+    toAction() {
+        return {
+            Identifier: this.id,
+            Type: this.type,
+            Parameters: this.parameters(),
+            Transitions: this.transitions(),
+        };
+    }
+}
+function wire(next, errors, conditions = []) {
+    const t = {};
+    if (next !== undefined)
+        t.NextAction = targetId(next);
+    t.Errors = errors.map(([ErrorType, target]) => ({ ErrorType, NextAction: targetId(target) }));
+    t.Conditions = conditions.map((c) => ({
+        NextAction: targetId(c.target),
+        Condition: { Operator: c.operator, Operands: c.operands },
+    }));
+    return t;
+}
+export class MessageParticipant extends Block {
+    config;
+    type = ActionType.MessageParticipant;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        const { text, ssml, prompt } = this.config;
+        if (text !== undefined)
+            return { Text: text };
+        if (ssml !== undefined)
+            return { SSML: ssml };
+        return { PromptId: prompt };
+    }
+    transitions() {
+        return wire(this.config.next, [[NO_MATCHING_ERROR, this.config.onError]]);
+    }
+}
+export class GetParticipantInput extends Block {
+    config;
+    type = ActionType.GetParticipantInput;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+        const t = config.timeoutSeconds;
+        if (!Number.isInteger(t) || t < INPUT_TIMEOUT_MIN || t > INPUT_TIMEOUT_MAX) {
+            throw new Error(`GetParticipantInput "${config.id}" timeoutSeconds must be an integer between ${INPUT_TIMEOUT_MIN} and ${INPUT_TIMEOUT_MAX}, got ${t}.`);
+        }
+        // A key that branches twice is two answers to one press. Only one of
+        // them can be taken, so the class refuses the config rather than emit
+        // both conditions and leave the caller believing each branch is live.
+        // codegen constructs the real block to verify an inversion, so a document
+        // carrying a repeated key stays a GenericBlock instead of generating a
+        // call that throws.
+        const seen = new Set();
+        for (const b of config.branches) {
+            if (!DTMF_DIGITS.includes(b.digit)) {
+                throw new Error(`GetParticipantInput "${config.id}" branch digit must be one of ${DTMF_DIGITS.join(" ")}, got "${String(b.digit)}".`);
+            }
+            if (seen.has(b.digit)) {
+                throw new Error(`GetParticipantInput "${config.id}" branches on key "${b.digit}" twice; each key may branch once.`);
+            }
+            seen.add(b.digit);
+        }
+    }
+    parameters() {
+        const { text, ssml, prompt } = this.config;
+        const p = {};
+        if (text !== undefined)
+            p.Text = text;
+        else if (ssml !== undefined)
+            p.SSML = ssml;
+        else if (prompt !== undefined)
+            p.PromptId = prompt;
+        p.InputTimeLimitSeconds = String(this.config.timeoutSeconds);
+        p.StoreInput = "False";
+        return p;
+    }
+    transitions() {
+        const { onTimeout, onNoMatch, onError } = this.config;
+        return wire(onNoMatch, [
+            [INPUT_TIME_LIMIT_EXCEEDED, onTimeout],
+            [NO_MATCHING_CONDITION, onNoMatch],
+            [NO_MATCHING_ERROR, onError],
+        ], this.config.branches.map((b) => ({
+            target: b.target,
+            operator: "Equals",
+            operands: [b.digit],
+        })));
+    }
+}
+/** Terminal. Takes no parameters and supports no errors. */
+export class DisconnectParticipant extends Block {
+    type = ActionType.DisconnectParticipant;
+    constructor(config) {
+        super(config.id);
+    }
+    parameters() {
+        return {};
+    }
+    transitions() {
+        return {};
+    }
+}
+export class CheckHoursOfOperation extends Block {
+    config;
+    type = ActionType.CheckHoursOfOperation;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        return this.config.hours === undefined ? {} : { HoursOfOperationId: this.config.hours };
+    }
+    transitions() {
+        // NextAction is the fallback when no condition matches. The conditions are
+        // exhaustive, so it mirrors the out-of-hours path.
+        return wire(this.config.onOutOfHours, [[NO_MATCHING_ERROR, this.config.onError]], [
+            { target: this.config.onInHours, operator: "Equals", operands: ["True"] },
+            { target: this.config.onOutOfHours, operator: "Equals", operands: ["False"] },
+        ]);
+    }
+}
+export class Compare extends Block {
+    config;
+    type = ActionType.Compare;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+        if (config.branches.length === 0) {
+            throw new Error(`Compare "${config.id}" needs at least one branch.`);
+        }
+    }
+    parameters() {
+        return { ComparisonValue: this.config.value };
+    }
+    transitions() {
+        return wire(undefined, [[NO_MATCHING_CONDITION, this.config.onNoMatch]], this.config.branches.map((b) => ({
+            target: b.target,
+            operator: b.operator,
+            operands: b.operands,
+        })));
+    }
+}
+export class TransferToFlow extends Block {
+    config;
+    type = ActionType.TransferToFlow;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        return { ContactFlowId: this.config.flow };
+    }
+    transitions() {
+        return wire(this.config.next, [[NO_MATCHING_ERROR, this.config.onError]]);
+    }
+}
+/** Terminal. Only legal in whisper and customer queue flows. */
+export class EndFlowExecution extends Block {
+    type = ActionType.EndFlowExecution;
+    constructor(config) {
+        super(config.id);
+    }
+    parameters() {
+        return {};
+    }
+    transitions() {
+        return {};
+    }
+}
+export class UpdateContactTargetQueue extends Block {
+    config;
+    type = ActionType.UpdateContactTargetQueue;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        return this.config.queue !== undefined
+            ? { QueueId: this.config.queue }
+            : { AgentId: this.config.agent };
+    }
+    transitions() {
+        return wire(this.config.next, [[NO_MATCHING_ERROR, this.config.onError]]);
+    }
+}
+export class TransferContactToQueue extends Block {
+    config;
+    type = ActionType.TransferContactToQueue;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        return {};
+    }
+    transitions() {
+        const extra = EXTRA_ERRORS[ActionType.TransferContactToQueue] ?? [];
+        const errors = extra.map((e) => [e, this.config.onQueueAtCapacity]);
+        errors.push([NO_MATCHING_ERROR, this.config.onError]);
+        return wire(this.config.next, errors);
+    }
+}
+export class UpdateContactAttributes extends Block {
+    config;
+    type = ActionType.UpdateContactAttributes;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        return {
+            Attributes: this.config.attributes,
+            TargetContact: this.config.targetContact ?? "Current",
+        };
+    }
+    transitions() {
+        return wire(this.config.next, [[NO_MATCHING_ERROR, this.config.onError]]);
+    }
+}
+export class UpdateContactRecordingBehavior extends Block {
+    config;
+    type = ActionType.UpdateContactRecordingBehavior;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        const behavior = {
+            RecordedParticipants: this.config.recordedParticipants,
+        };
+        if (this.config.screenRecordedParticipants !== undefined) {
+            behavior.ScreenRecordedParticipants = this.config.screenRecordedParticipants;
+        }
+        if (this.config.ivrRecordingBehavior !== undefined) {
+            behavior.IVRRecordingBehavior = this.config.ivrRecordingBehavior;
+        }
+        return { RecordingBehavior: behavior };
+    }
+    transitions() {
+        return wire(this.config.next, [[NO_MATCHING_ERROR, this.config.onError]]);
+    }
+}
+export class InvokeFlowModule extends Block {
+    config;
+    type = ActionType.InvokeFlowModule;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+    }
+    parameters() {
+        return { FlowModuleId: this.config.module };
+    }
+    transitions() {
+        return wire(this.config.next, [[NO_MATCHING_ERROR, this.config.onError]]);
+    }
+}
+/** Terminal. Only legal inside a module. */
+export class EndFlowModuleExecution extends Block {
+    type = ActionType.EndFlowModuleExecution;
+    constructor(config) {
+        super(config.id);
+    }
+    parameters() {
+        return {};
+    }
+    transitions() {
+        return {};
+    }
+}
+export class InvokeLambdaFunction extends Block {
+    config;
+    type = ActionType.InvokeLambdaFunction;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+        const t = config.timeoutSeconds;
+        if (!Number.isInteger(t) || t < LAMBDA_TIMEOUT_MIN || t > LAMBDA_TIMEOUT_MAX) {
+            throw new Error(`InvokeLambdaFunction "${config.id}" timeoutSeconds must be an integer between ${LAMBDA_TIMEOUT_MIN} and ${LAMBDA_TIMEOUT_MAX}, got ${t}.`);
+        }
+    }
+    parameters() {
+        const p = {
+            LambdaFunctionARN: this.config.lambda,
+            InvocationTimeLimitSeconds: this.config.timeoutSeconds,
+            InvocationType: this.config.invocationType ?? "SYNCHRONOUS",
+        };
+        if (this.config.attributes !== undefined)
+            p.LambdaInvocationAttributes = this.config.attributes;
+        if (this.config.responseType !== undefined) {
+            p.ResponseValidation = { ResponseType: this.config.responseType };
+        }
+        return p;
+    }
+    transitions() {
+        return wire(this.config.next, [[NO_MATCHING_ERROR, this.config.onError]]);
+    }
+}
+export class GenericBlock extends Block {
+    config;
+    type;
+    constructor(config) {
+        super(config.id);
+        this.config = config;
+        this.type = config.type;
+    }
+    parameters() {
+        return this.config.parameters ?? {};
+    }
+    transitions() {
+        // A generic block with nothing wired is terminal, matching Connect's
+        // representation of terminal actions as an empty Transitions object.
+        if (this.config.next === undefined &&
+            (this.config.errors ?? []).length === 0 &&
+            (this.config.conditions ?? []).length === 0) {
+            return {};
+        }
+        return wire(this.config.next, (this.config.errors ?? []).map((e) => [e.errorType, e.target]), this.config.conditions ?? []);
+    }
+}
+//# sourceMappingURL=blocks.js.map

package/dist/blocks.js.map

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

package/dist/codegen.d.ts

@@ -0,0 +1,21 @@
+import type { FlowDoc } from "./flowdoc.js";
+export interface CodegenOptions {
+    /** Import path for the builder API. Defaults to the published package. */
+    moduleSpecifier?: string;
+    /**
+     * A previously generated source for the same flow. Comment lines containing
+     * `@keep` that immediately precede a block construction re-attach to the
+     * block with the same id; ones immediately preceding the export function
+     * re-attach there. Everything else regenerates.
+     */
+    previous?: string;
+}
+/**
+ * The exported factory's name: camelCase of the flow name, prefixed with
+ * "flow" when it would start with a digit, hit a reserved word, or collide
+ * with an identifier the file imports (a flow named "json-path" must not emit
+ * `export function jsonPath` next to `import { jsonPath }`).
+ */
+export declare function factoryName(name: string, taken?: ReadonlySet<string>): string;
+export declare function codegen(doc: FlowDoc, options?: CodegenOptions): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAmDA,OAAO,KAAK,EAIV,OAAO,EAIR,MAAM,cAAc,CAAC;AAMtB,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+5BD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,MAAM,CAUxF;AA8DD,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CA+D1E"}