@devkong/cli 0.0.33 → 0.0.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "type": "commonjs",
   "main": "./index.js",
   "typings": "./index.d.ts",

package/packages/kong-cli/src/common/extensionContract.d.ts

@@ -1 +1,7 @@
-export declare function getExtensionContract(filePath: string): object;
+import { JSONSchema7 } from "json-schema";
+interface ExtensionContract {
+    input: JSONSchema7;
+    output: JSONSchema7;
+}
+export declare function getExtensionContract(filePath: string): ExtensionContract;
+export {};

package/packages/kong-cli/src/common/profile.d.ts

@@ -4,8 +4,9 @@ export interface Profile {
     userName: string;
 }
 export type ProfileName = "default" | string;
-export type ConfigProfiles = Record<ProfileName, Profile>;
-export declare function loadProfiles(): ConfigProfiles;
-export declare function saveProfiles(profiles: ConfigProfiles): void;
-export declare function getProfile(profileName?: string): Profile;
-export declare function printProfile(profile: string): void;
+export type ProfileMap = Record<ProfileName, Profile>;
+export declare function createEmptyProfile(): Profile;
+export declare function loadProfiles(): ProfileMap;
+export declare function saveProfiles(profiles: ProfileMap): void;
+export declare function getProfile(name: ProfileName): Profile;
+export declare function printProfile(name: ProfileName): void;

package/packages/kong-cli/src/common/utils.d.ts

@@ -1,4 +1,4 @@
-import { ShortUUID } from "@kong/ts";
+import { Optional, ShortUUID } from "@kong/ts";
 export interface ILogger {
     info(message: string): any;
     debug(message: string): any;
@@ -6,7 +6,7 @@ export interface ILogger {
     warn(message: string): any;
 }
 export declare function env(key: string): string;
-export declare function optionalEnv(key: string): string;
+export declare function optionalEnv(key: string): Optional<string>;
 export declare function loadJsonFile<T>(filePath: string): T;
 export declare function resolveProjectPath(fileName: string): string;
 export declare function generateShortId(): ShortUUID;

package/packages/kong-spec/src/index.d.ts

@@ -1,17 +1,18 @@
 export { makeServerlessJavaAppProps, serverlessFlowBuilder, stringifyServerlessFlow, } from "./lib/kongServerless";
 export type { FloweyServerlessBuilder } from "./lib/kongServerless";
 export type { KongSpecJobSession } from "./lib/kongSession";
-export type { KongSpecAction, KongSpecActionCallFunction, KongSpecActionCallProcess, KongSpecActionSendEvent, KongSpecAppend, KongSpecBranch, KongSpecCache, KongSpecCallModel, KongSpecCircuitBreaker, KongSpecCondition, KongSpecEffect, KongSpecEffectStatus, KongSpecError, KongSpecEventBroker, KongSpecEventConnection, KongSpecFeatureCompensation, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecProcessRef, KongSpecRecord, KongSpecRecordHeader, KongSpecRetry, KongSpecRule, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateExit, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent, KongSpecSupportsActions, KongSpecSupportsErrors, KongSpecSupportsTransition, } from "./lib/kongSpec";
+export type { KongSpecAction, KongSpecActionCallFunction, KongSpecActionCallProcess, KongSpecActionSendEvent, KongSpecAnnotation, KongSpecAppend, KongSpecBranch, KongSpecCache, KongSpecCallModel, KongSpecCircuitBreaker, KongSpecCondition, KongSpecEffect, KongSpecEffectStatus, KongSpecError, KongSpecEventBroker, KongSpecEventConnection, KongSpecFeatureCompensation, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecProcessRef, KongSpecRecord, KongSpecRecordHeader, KongSpecRetry, KongSpecRule, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateExit, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent, KongSpecSupportsActions, KongSpecSupportsErrors, KongSpecSupportsTransition, } from "./lib/kongSpec";
 export { KongSpecBuild } from "./lib/kongSpecBuild";
 export { KongSpecDoc } from "./lib/kongSpecDoc";
 export { KongSpecEnv } from "./lib/kongSpecEnv";
 export type { KongSpecFile } from "./lib/kongSpecFile";
 export type { KongSpecLayout, KongSpecLayoutPosition, KongSpecLayoutPositionKey, } from "./lib/kongSpecLayout";
+export { migrate } from "./lib/kongSpecMigrate";
 export { nameGenerator } from "./lib/kongSpecName";
 export { normalizeName } from "./lib/kongSpecNormalize";
 export { KongSpecRef } from "./lib/kongSpecRef";
 export type { KongSpecActionPath, KongSpecStatePath } from "./lib/kongSpecRef";
 export { convertSpecToServerless } from "./lib/kongSpecToServerless";
-export { findSourceState, getActions, outputAggregator, traverseFlowUp } from "./lib/kongSpecUtils";
+export { findSourceState, getActions, outputAggregator, parallelStateOutputAggregator, traverseFlowUp, } from "./lib/kongSpecUtils";
 export { validate } from "./lib/kongSpecValidate";
 export type { KongSpecValidationIssue, KongSpecValidators } from "./lib/kongSpecValidate";

package/packages/kong-spec/src/lib/kongServerless.d.ts

@@ -6,8 +6,9 @@ export declare const copyServerlessFlow: (workflow: Specification.Workflow) => S
 export declare function stringifyServerlessFlow(workflow: Specification.Workflow): string;
 interface ServerlessJavaAppPropsGenerator {
     tenant: SessionTenant;
+    processTitle: string;
     processName: string;
     events: Specification.Eventdef[];
 }
-export declare function makeServerlessJavaAppProps({ tenant, processName, events, }: ServerlessJavaAppPropsGenerator): string;
+export declare function makeServerlessJavaAppProps({ tenant, processTitle, processName, events, }: ServerlessJavaAppPropsGenerator): string;
 export {};

package/packages/kong-spec/src/lib/kongSession.d.ts

@@ -5,7 +5,9 @@ export declare enum KongSpecSessionAgent {
 interface KongSpecSession {
     agent: KongSpecSessionAgent;
     id: TraceParent;
+    rootId: Optional<KongSpecSession["id"]>;
     parentId: Optional<KongSpecSession["id"]>;
+    rootCreated: UtcDateTime;
     created: UtcDateTime;
 }
 export declare enum KongSpecJobSessionExecutionMode {
@@ -23,7 +25,6 @@ export interface KongSpecJobSession extends KongSpecSession {
     businessKey: BusinessKey;
     source: string;
     tenant: SessionTenant;
-    partition: number;
     topic: string;
     metadata: JsonObject;
     priority: KongSpecJobSessionPriority;

package/packages/kong-spec/src/lib/kongSpec.d.ts

@@ -1,4 +1,4 @@
-import { Distinct, Duration8601, JqFilter, JqObject, JqText, JsonArray, JsonObject, Optional, SessionTenant, ShortUUID } from "@kong/ts";
+import { DataGuard, Distinct, Duration8601, JqFilter, JqObject, JqText, JsonObject, JsonText, Optional, SessionTenant, ShortUUID } from "@kong/ts";
 import { JSONSchema7 } from "json-schema";
 export type KongSpecAppend = "list" | "last";
 export interface KongSpecFunctionRef {
@@ -8,13 +8,13 @@ export interface KongSpecFunctionRef {
 }
 export interface KongSpecProcessRef {
     tenant: SessionTenant;
-    basedOn: Distinct<string, "KongSpecProcessRefBasedOn">;
+    basedOn: KongSpecFlow["id"];
     aliasName: Distinct<string, "KongSpecProcessRefAliasName">;
 }
 interface KongSpecStateBase {
     id: Distinct<string, "KongSpecStateId">;
     name: string;
-    type: "start" | "succeed" | "fail" | "inject" | "compensate" | "foreach" | "callFunction" | "parallel" | "rule" | "switch" | "sendEvent" | "waitEvent" | "callProcess";
+    type: "start" | "succeed" | "fail" | "inject" | "compensate" | "foreach" | "callFunction" | "delay" | "parallel" | "rule" | "switch" | "sendEvent" | "waitEvent" | "callProcess";
 }
 export interface KongSpecSupportsTransition {
     next: KongSpecStateBase["id"] | null;
@@ -27,6 +27,7 @@ export interface KongSpecError extends KongSpecSupportsTransition {
 export interface KongSpecCache {
     enabled: boolean;
     key: JqFilter;
+    failOnMiss: JqFilter;
     ttl: Duration8601;
     onFailure: "RETRY" | "SKIP";
 }
@@ -58,35 +59,35 @@ export interface KongSpecEffectProducer {
     id: string;
     type: string;
 }
-export interface KongSpecEffectAck {
-    producer: KongSpecEffectProducer;
-    seqNum: number;
-}
 export declare enum KongSpecEffectStatus {
     FAILED = "FAILED",
     SUCCEEDED = "SUCCEEDED"
 }
 export interface KongSpecEffect {
     status: KongSpecEffectStatus;
-    ack: KongSpecEffectAck;
     usage: Record<string, unknown>;
     data: JsonObject | null;
 }
 export interface KongSpecHowToOutput {
-    ack: KongSpecEffectAck;
     filter: JqFilter;
     destinations: string[];
 }
+export interface KongSpecSupportsInputFilter {
+    inputFilter: JqFilter;
+}
 export interface KongSpecSupportsOutputFilter {
     outputFilter: JqFilter;
 }
 export interface KongSpecSupportsOutputAppend {
     outputAppend: Array<KongSpecAppend>;
 }
+export interface KongSpecSupportsDataGuards {
+    guards: DataGuard[];
+}
 export interface KongSpecSupportsOutputSample {
-    outputSample: Optional<JsonObject | JsonArray>;
+    outputSample: Optional<JsonText>;
 }
-export interface KongSpecCallModel extends KongSpecSupportsInput, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample, KongSpecSupportsInvoke {
+export interface KongSpecCallModel extends KongSpecSupportsInput, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample, KongSpecSupportsDataGuards, KongSpecSupportsInvoke {
 }
 export interface KongSpecSupportsErrors {
     errors: KongSpecError[];
@@ -106,7 +107,7 @@ export interface KongSpecCanBeUsedForCompensation {
 export interface KongSpecStateStart extends KongSpecStateBase, KongSpecSupportsTransition, KongSpecSupportsTimeout {
     type: "start";
     inputSchema: JSONSchema7;
-    inputSample: JsonObject;
+    inputSample: JsonText;
 }
 export interface KongSpecStateSucceed extends KongSpecStateBase, KongSpecSupportsOutputFilter {
     type: "succeed";
@@ -170,13 +171,17 @@ export interface KongSpecStateCallProcess extends KongSpecStateBase, KongSpecSup
     type: "callProcess";
     ref: KongSpecProcessRef;
 }
+export interface KongSpecStateDelay extends KongSpecStateBase, KongSpecSupportsTransition {
+    type: "delay";
+    value: Duration8601;
+}
 export interface KongSpecStateCallFunction extends KongSpecStateBase, KongSpecSupportsTransition, KongSpecSupportsErrors, KongSpecFeatureCompensation, KongSpecCanBeUsedForCompensation, KongSpecSupportsCompensatedBy, KongSpecCallModel {
     type: "callFunction";
     ref: KongSpecFunctionRef;
 }
 export interface KongSpecActionBase {
     id: Distinct<string, "KongSpecActionId">;
-    type: "callFunction" | "sendEvent" | "callProcess";
+    type: "callFunction" | "sendEvent" | "callProcess" | "inject";
     name: string;
 }
 export interface KongSpecActionCallFunction extends KongSpecActionBase, KongSpecCallModel {
@@ -185,13 +190,17 @@ export interface KongSpecActionCallFunction extends KongSpecActionBase, KongSpec
 }
 export interface KongSpecActionCallProcess extends KongSpecActionBase, KongSpecCallModel {
     type: "callProcess";
+    ref: KongSpecProcessRef;
 }
 export interface KongSpecActionSendEvent extends KongSpecActionBase {
     type: "sendEvent";
     connection: KongSpecEventConnection;
     record: KongSpecRecord;
 }
-export type KongSpecAction = KongSpecActionCallFunction | KongSpecActionCallProcess | KongSpecActionSendEvent;
+export interface KongSpecActionInject extends KongSpecActionBase, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend {
+    type: "inject";
+}
+export type KongSpecAction = KongSpecActionCallFunction | KongSpecActionCallProcess | KongSpecActionSendEvent | KongSpecActionInject;
 export interface KongSpecSupportsActions {
     actions: KongSpecAction[];
 }
@@ -206,16 +215,28 @@ export interface KongSpecStateForeach extends KongSpecStateBase, KongSpecSupport
     outputCollection: JqFilter;
     actions: KongSpecAction[];
 }
-export interface KongSpecStateParallel extends KongSpecStateBase, KongSpecSupportsTransition, KongSpecCanBeUsedForCompensation, KongSpecFeatureCompensation, KongSpecSupportsCompensatedBy, KongSpecSupportsErrors {
+export interface KongSpecStateParallel extends KongSpecStateBase, KongSpecSupportsTransition, KongSpecCanBeUsedForCompensation, KongSpecFeatureCompensation, KongSpecSupportsCompensatedBy, KongSpecSupportsInputFilter, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend, KongSpecSupportsErrors, KongSpecSupportsInput {
     type: "parallel";
     branches: KongSpecBranch[];
     completionType: "allOf" | "atLeast";
 }
-export type KongSpecState = KongSpecStateStart | KongSpecStateSucceed | KongSpecStateFail | KongSpecStateInject | KongSpecStateCompensate | KongSpecStateForeach | KongSpecStateCallFunction | KongSpecStateCallProcess | KongSpecStateSwitch | KongSpecStateRule | KongSpecStateSendEvent | KongSpecStateWaitEvent | KongSpecStateParallel;
+export type KongSpecState = KongSpecStateCallFunction | KongSpecStateCallProcess | KongSpecStateCompensate | KongSpecStateDelay | KongSpecStateFail | KongSpecStateForeach | KongSpecStateInject | KongSpecStateParallel | KongSpecStateRule | KongSpecStateSendEvent | KongSpecStateStart | KongSpecStateSucceed | KongSpecStateSwitch | KongSpecStateWaitEvent;
 export type KongSpecStateExit = KongSpecStateFail | KongSpecStateSucceed;
+interface KongSpecAnnotationBase {
+    id: Distinct<string, "KongSpecAnnotationId">;
+}
+export interface KongSpecNoteAnnotation extends KongSpecAnnotationBase {
+    type: "note";
+    content: string;
+    size: [number, number];
+    fill: string;
+    stroke: string;
+}
+export type KongSpecAnnotation = KongSpecNoteAnnotation;
 export interface KongSpecFlow {
     id: Distinct<ShortUUID, "KongSpecFlowId">;
-    version: "1.0";
+    version: "1";
     states: KongSpecState[];
+    annotations: KongSpecAnnotation[];
 }
 export {};

package/packages/kong-spec/src/lib/kongSpecBuild.d.ts

@@ -1,6 +1,5 @@
-import { JqObject, SessionTenant, Timezone } from "@kong/ts";
-import { KongSpecJobSession } from "./kongSession";
-import { KongSpecActionCallFunction, KongSpecActionSendEvent, KongSpecBranch, KongSpecCallModel, KongSpecCondition, KongSpecError, KongSpecEventBroker, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecProcessRef, KongSpecRecordHeader, KongSpecRule, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent } from "./kongSpec";
+import { JqObject, Optional } from "@kong/ts";
+import { KongSpecActionCallFunction, KongSpecActionCallProcess, KongSpecActionInject, KongSpecActionSendEvent, KongSpecAnnotation, KongSpecBranch, KongSpecCallModel, KongSpecCondition, KongSpecError, KongSpecEventBroker, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecProcessRef, KongSpecRecordHeader, KongSpecRule, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent } from "./kongSpec";
 export declare class KongSpecBuild {
     flow(id: KongSpecFlow["id"]): KongSpecFlow;
     startState(overrides?: Partial<KongSpecStateStart>): KongSpecStateStart;
@@ -9,10 +8,13 @@ export declare class KongSpecBuild {
     callFunctionState(ref: KongSpecFunctionRef, overrides?: Partial<KongSpecStateCallFunction>): KongSpecStateCallFunction;
     callFunctionAction(ref: KongSpecFunctionRef, overrides?: Partial<KongSpecActionCallFunction>): KongSpecActionCallFunction;
     callProcessState(ref: KongSpecProcessRef, overrides?: Partial<KongSpecStateCallProcess>): KongSpecStateCallProcess;
+    callProcessAction(ref: KongSpecProcessRef, overrides?: Partial<KongSpecActionCallProcess>): KongSpecActionCallProcess;
+    delayState(overrides?: Partial<KongSpecStateDelay>): KongSpecStateDelay;
     compensateState(overrides?: Partial<KongSpecStateCompensate>): KongSpecStateCompensate;
     failState(overrides?: Partial<KongSpecStateFail>): KongSpecStateFail;
     injectState(overrides?: Partial<KongSpecStateInject>): KongSpecStateInject;
-    succeedState(overrides?: Partial<KongSpecStateSucceed>): KongSpecStateSucceed;
+    injectAction(overrides?: Partial<KongSpecActionInject>): KongSpecActionInject;
+    succeedState(afterState: Optional<KongSpecState["name"]>, overrides?: Partial<KongSpecStateSucceed>): KongSpecStateSucceed;
     sendEventState(overrides?: Partial<KongSpecStateSendEvent>): KongSpecStateSendEvent;
     sendEventAction(overrides?: Partial<KongSpecActionSendEvent>): KongSpecActionSendEvent;
     waitEventState(overrides?: Partial<KongSpecStateWaitEvent>): KongSpecStateWaitEvent;
@@ -30,5 +32,5 @@ export declare class KongSpecBuild {
     circuitBreaker(overrides?: Partial<KongSpecHowToInvoke["circuitBreaker"]>): KongSpecHowToInvoke["circuitBreaker"];
     cache(overrides?: Partial<KongSpecHowToInvoke["cache"]>): KongSpecHowToInvoke["cache"];
     callModel(payload: JqObject): KongSpecCallModel;
-    session(tenant: SessionTenant, timezone: Timezone, overrides?: Partial<KongSpecJobSession>): KongSpecJobSession;
+    note(overrides?: Partial<KongSpecAnnotation>): KongSpecAnnotation;
 }

package/packages/kong-spec/src/lib/kongSpecDoc.d.ts

@@ -25,4 +25,5 @@ export declare class KongSpecDoc {
     static aboutSwitch: string;
     static aboutRule: string;
     static aboutWaitEvent: string;
+    static aboutOptionalWhenAtLeastOne: string;
 }

package/packages/kong-spec/src/lib/kongSpecLayout.d.ts

@@ -1,4 +1,4 @@
-import { KongSpecAction, KongSpecState } from "./kongSpec";
-export type KongSpecLayoutPositionKey = KongSpecState["id"] | KongSpecAction["id"];
+import { KongSpecAction, KongSpecAnnotation, KongSpecState } from "./kongSpec";
+export type KongSpecLayoutPositionKey = KongSpecState["id"] | KongSpecAction["id"] | KongSpecAnnotation["id"];
 export type KongSpecLayoutPosition = [number, number];
 export type KongSpecLayout = Record<KongSpecLayoutPositionKey, KongSpecLayoutPosition>;

package/packages/kong-spec/src/lib/kongSpecMigrate.d.ts

@@ -0,0 +1,2 @@
+import { KongSpecFile } from "./kongSpecFile";
+export declare function migrate(file: KongSpecFile): KongSpecFile;

package/packages/kong-spec/src/lib/kongSpecRef.d.ts

@@ -1,5 +1,5 @@
 import { Optional, SessionTenant } from "@kong/ts";
-import { KongSpecAction, KongSpecBranch, KongSpecCondition, KongSpecError, KongSpecFunctionRef, KongSpecProcessRef, KongSpecRule, KongSpecState } from "./kongSpec";
+import { KongSpecAction, KongSpecAnnotation, KongSpecBranch, KongSpecCondition, KongSpecError, KongSpecFunctionRef, KongSpecProcessRef, KongSpecRule, KongSpecState } from "./kongSpec";
 export declare class KongSpecRef {
     static newStateId(): KongSpecState["id"];
     static newConditionId(): KongSpecCondition["id"];
@@ -7,6 +7,7 @@ export declare class KongSpecRef {
     static newBranchId(): KongSpecBranch["id"];
     static newErrorId(): KongSpecError["id"];
     static newActionId(): KongSpecAction["id"];
+    static newAnnotationId(): KongSpecAnnotation["id"];
     static functionRef(tenant: SessionTenant, basedOn: string, aliasName: string): KongSpecFunctionRef;
     static processRef(tenant: SessionTenant, basedOn: string, aliasName: string): KongSpecProcessRef;
 }

package/packages/kong-spec/src/lib/kongSpecToServerless.d.ts

@@ -1,11 +1,10 @@
-import { SessionTenant } from "@kong/ts";
+import { Optional, SessionTenant } from "@kong/ts";
 import { Specification } from "@severlessworkflow/sdk-typescript";
 import { JSONSchema7 } from "json-schema";
-import { KongSpecFlow, KongSpecProcessRef } from "./kongSpec";
-import { KongSpecEnv } from "./kongSpecEnv";
+import { KongSpecFlow } from "./kongSpec";
 interface ConvertSpecToServerlessResult {
     workflow: Specification.Workflow;
-    inputSchema: JSONSchema7;
+    inputSchema: Optional<JSONSchema7>;
 }
-export declare function convertSpecToServerless(type: "main", tenant: SessionTenant, specFlow: KongSpecFlow, aliasName: KongSpecProcessRef["aliasName"], env: KongSpecEnv): ConvertSpecToServerlessResult;
+export declare function convertSpecToServerless(tenant: SessionTenant, specFlow: KongSpecFlow, processName: string, parentProcessName?: string): ConvertSpecToServerlessResult[];
 export {};

package/packages/kong-spec/src/lib/kongSpecUtils.d.ts

@@ -1,11 +1,14 @@
-import { JqFilter, JsonObject } from "@kong/ts";
-import { KongSpecAction, KongSpecFlow, KongSpecState } from "./kongSpec";
+import { JqFilter, JsonText } from "@kong/ts";
+import { KongSpecAction, KongSpecFlow, KongSpecState, KongSpecStateParallel, KongSpecSupportsTransition } from "./kongSpec";
+import { KongSpecActionPath, KongSpecStatePath } from "./kongSpecRef";
 interface FloweyTraverseStateTestItem {
     id: KongSpecState["id"] | KongSpecAction["id"];
     source: "initial" | "errors" | "transition" | "noMatchedRule" | "conditions" | "compensateBy" | "actions" | "branches";
 }
 export declare function traverseFlowUp(id: KongSpecState["id"] | KongSpecAction["id"], states: KongSpecFlow["states"], test: (current: FloweyTraverseStateTestItem) => boolean): boolean;
-export declare function outputAggregator(jq: (sample: JsonObject, filter: JqFilter) => Promise<string>): (flow: KongSpecFlow, targetRef: KongSpecState["id"] | KongSpecAction["id"], includeTarget?: boolean) => Promise<JsonObject>;
+export declare function outputAggregator(jq: (sample: string, filter: JqFilter) => Promise<string>): (flow: KongSpecFlow, path: KongSpecStatePath | KongSpecActionPath, includeTarget?: boolean) => Promise<JsonText>;
 export declare function getActions(state: KongSpecState): KongSpecAction[];
 export declare function findSourceState(states: KongSpecState[], targetRef: KongSpecState["id"]): import("@kong/ts").Distinct<string, "KongSpecStateId">;
+export declare function convertActionToState(action: KongSpecAction): KongSpecState & KongSpecSupportsTransition;
+export declare function parallelStateOutputAggregator(jq: (sample: string, filter: JqFilter) => Promise<string>): (state: KongSpecStateParallel, flow: KongSpecFlow) => Promise<JsonText>;
 export {};

package/packages/kong-ts/src/index.d.ts

@@ -4,6 +4,8 @@ export type { BusinessKey } from "./lib/businessKey";
 export { CloudEvent } from "./lib/cloudEvent";
 export { textToColor } from "./lib/color";
 export { deepEquals, prepareTextForComparison, sameText, shadowEquals } from "./lib/compare";
+export { DataGuardType } from "./lib/dataGuard";
+export type { DataGuard } from "./lib/dataGuard";
 export { isDuration } from "./lib/duration";
 export type { Duration8601 } from "./lib/duration";
 export type { Entity } from "./lib/entity";
@@ -17,7 +19,7 @@ export type { JqArray, JqFilter, JqObject, JqSerializer, JqText, RefactorReplace
 export { generateFakeJsonObject, jsonToHumanReadable, prettyJson, safeJsonParse } from "./lib/json";
 export type { JsonArray, JsonObject, JsonSchemaUrl, JsonText } from "./lib/json";
 export { KeyGenerator } from "./lib/keyGenerator";
-export { insertItem, moveItem, unique } from "./lib/list";
+export { findLastIndex, insertItem, moveItem, unique } from "./lib/list";
 export { deepMerge, deepMergeAll } from "./lib/merge";
 export { deepDeleteKeys } from "./lib/normalize";
 export { retry } from "./lib/retry";
@@ -36,4 +38,4 @@ export type { UrlText } from "./lib/url";
 export type { User } from "./lib/user";
 export { dateToUtc, utcNow, utcToZonedDate, utcToZonedText } from "./lib/utc";
 export type { UtcDateTime } from "./lib/utc";
-export { assignDefined, clone, coalesce, getFirstObjectValue, isEmpty, isFunction, isNumber, isString, jitter, no, noop, reinterpret, safeCall, yes, } from "./lib/utils";
+export { assignDefined, clone, coalesce, getFirstObjectValue, isEmpty, isFunction, isNumber, isString, jitter, no, noop, reinterpret, safeCall, toAlphabetic, yes, } from "./lib/utils";

package/packages/kong-ts/src/lib/dataGuard.d.ts

@@ -0,0 +1,11 @@
+export declare enum DataGuardType {
+    NULL = "NULL",
+    EMPTY_TEXT = "EMPTY_TEXT",
+    WHITESPACES = "WHITESPACES",
+    EMPTY_OBJECT = "EMPTY_OBJECT",
+    EMPTY_ARRAY = "EMPTY_ARRAY"
+}
+export interface DataGuard {
+    type: DataGuardType;
+    arguments: Array<unknown>;
+}

package/packages/kong-ts/src/lib/jq.d.ts

@@ -1,5 +1,5 @@
 import { Distinct, Primitive } from "./types";
-export type JqFilter = Distinct<Primitive, "JqExpression">;
+export type JqFilter = Distinct<Primitive, "JqFilter">;
 export type JqText = Distinct<string, "JqText">;
 export interface JqObject {
     [key: string]: Primitive | JqText | JqObject | Array<JqObject> | null;

package/packages/kong-ts/src/lib/keyGenerator.d.ts

@@ -2,5 +2,4 @@ export declare class KeyGenerator {
     private existingKeys;
     constructor(existingKeys: string[]);
     next(baseName: string, separator?: string): string;
-    private toAlphabetic;
 }

package/packages/kong-ts/src/lib/list.d.ts

@@ -1,3 +1,4 @@
 export declare function insertItem<T>(list: ReadonlyArray<T>, item: T, index: number): T[];
 export declare function moveItem<T>(list: ReadonlyArray<T>, from: number, to: number): T[];
 export declare function unique<T>(list: T[]): T[];
+export declare function findLastIndex<T>(list: ReadonlyArray<T>, predicate: (value: T, index: number, array: ReadonlyArray<T>) => boolean): number;

package/packages/kong-ts/src/lib/utils.d.ts

@@ -13,3 +13,4 @@ export declare function coalesce<T>(...values: (T | undefined | null)[]): T;
 export declare function safeCall(action: Action): Optional<Error>;
 export declare function getFirstObjectValue<T extends JsonObject>(instance: T): Optional<T[keyof T]>;
 export declare function jitter(bottom: number, up: number): number;
+export declare function toAlphabetic(index: number): string;

package/packages/kong-ts-contract/src/index.d.ts

@@ -1,11 +1,11 @@
+export type { AppAlias } from "./lib/appAlias";
 export type { AppAliasDetails } from "./lib/appAliasDetails";
-export type { AppAliasEditorMode } from "./lib/appAliasEditorMode";
 export type { AppAliasUse } from "./lib/appAliasUse";
 export type { AppAliasUseDetails } from "./lib/appAliasUseDetails";
+export type { AppBroadcastData } from "./lib/appBroadcastData";
 export type { AppCheckpoint } from "./lib/appCheckpoint";
-export type { AppDevRequest } from "./lib/appDevRequest";
 export type { AppDocument } from "./lib/appDocument";
-export type { AppDocumentBuild } from "./lib/appDocumentBuild";
+export type { AppDocumentPublish } from "./lib/appDocumentPublish";
 export type { AppDocumentSnapshot } from "./lib/appDocumentSnapshot";
 export type { AppExtension } from "./lib/appExtension";
 export type { AppExtensionAlias } from "./lib/appExtensionAlias";
@@ -20,9 +20,9 @@ export type { AppProcessAliasDetails } from "./lib/appProcessAliasDetails";
 export type { AppProcessAliasUse } from "./lib/appProcessAliasUse";
 export type { AppProcessAliasUseDetails } from "./lib/appProcessAliasUseDetails";
 export type { AppProcessInstanceId } from "./lib/appProcessInstanceId";
-export type { AppProcessStartRequest } from "./lib/appProcessStartRequest";
 export type { AppProject } from "./lib/appProject";
 export type { AppSnapshotDetails } from "./lib/appSnapshotDetails";
+export type { AppTaskStartRequest } from "./lib/appTaskStartRequest";
 export type { AppTestCase } from "./lib/appTestCase";
 export type { AppTestCaseDetails } from "./lib/appTestCaseDetails";
 export type { AppTestCaseMatchFeature } from "./lib/appTestCaseMatchFeature";
@@ -31,3 +31,4 @@ export type { AppWorkspace } from "./lib/appWorkspace";
 export type { SdkAlias, SdkAliasInput, SdkAliasOutput } from "./lib/sdkAlias";
 export type { SdkExtensionAlias } from "./lib/sdkExtensionAlias";
 export type { SdkConcurrencyQuota, SdkQuotaName, SdkRateLimiterQuota } from "./lib/sdkQuota";
+export type { FQIN } from "./lib/types";

package/packages/kong-ts-contract/src/lib/appAlias.d.ts

@@ -1,9 +1,11 @@
 import { KongSpecFunctionRef, KongSpecProcessRef } from "@kong/spec";
-import { Entity, ShortUUID, User, UtcDateTime } from "@kong/ts";
+import { Entity, User, UtcDateTime } from "@kong/ts";
+import { AppDocument } from "./appDocument";
+import { AppExtension } from "./appExtension";
 export interface AppAlias<T> extends Entity {
     name: KongSpecProcessRef["aliasName"] | KongSpecFunctionRef["aliasName"];
-    basedOnId: ShortUUID;
-    basedOnName: KongSpecProcessRef["basedOn"] | KongSpecFunctionRef["basedOn"];
+    basedOnId: AppDocument["id"] | AppExtension["id"];
+    basedOnName: AppDocument["title"] | AppExtension["name"];
     use: T[];
     created: UtcDateTime;
     updated: UtcDateTime;

package/packages/kong-ts-contract/src/lib/appAliasDetails.d.ts

@@ -1,8 +1,6 @@
-import { KongSpecHowToInvoke } from "@kong/spec";
 import { AppAlias } from "./appAlias";
 import { SdkAlias } from "./sdkAlias";
 export interface AppAliasDetails<T> extends AppAlias<T> {
     inputSchema?: NonNullable<SdkAlias["input"]>["schema"];
     outputSchema?: NonNullable<SdkAlias["input"]>["schema"];
-    invoke?: Partial<KongSpecHowToInvoke>;
 }

package/packages/kong-ts-contract/src/lib/appBroadcastData.d.ts

@@ -0,0 +1,7 @@
+export interface AppBroadcastData<T> {
+    type: "INFO" | "ERROR";
+    data: {
+        comment: string;
+        value: T;
+    };
+}

package/packages/kong-ts-contract/src/lib/appDocument.d.ts

@@ -2,8 +2,10 @@ import { KongSpecFlow } from "@kong/spec";
 import { Entity, Optional, User, UtcDateTime } from "@kong/ts";
 import { AppCheckpoint } from "./appCheckpoint";
 import { AppProject } from "./appProject";
+import { AppWorkspace } from "./appWorkspace";
 export interface AppDocument extends Entity {
     id: KongSpecFlow["id"];
+    workspaceId: AppWorkspace["id"];
     projectId: AppProject["id"];
     title: string;
     checkpoint: Optional<AppCheckpoint["id"]>;

package/packages/kong-ts-contract/src/lib/appDocumentPublish.d.ts

@@ -0,0 +1,7 @@
+import { Optional, UrlText, User, UtcDateTime } from "@kong/ts";
+export interface AppDocumentPublish {
+    bundleUrl: UrlText;
+    deadline: UtcDateTime;
+    tag: Optional<string>;
+    createdBy: User["name"];
+}

package/packages/kong-ts-contract/src/lib/appExtensionSnapshotDetails.d.ts

@@ -1,4 +1,2 @@
 import { AppSnapshotDetails } from "./appSnapshotDetails";
-export interface AppExtensionSnapshotDetails extends AppSnapshotDetails {
-    sdk: string;
-}
+export type AppExtensionSnapshotDetails = AppSnapshotDetails;

package/packages/kong-ts-contract/src/lib/appSnapshotDetails.d.ts

@@ -2,6 +2,7 @@ import { JsonObject } from "@kong/ts";
 import { JSONSchema7 } from "json-schema";
 import { AppSnapshot } from "./appSnapshot";
 export interface AppSnapshotDetails extends AppSnapshot {
+    sdk: string;
     inputSchema: JSONSchema7;
     outputSchema: JSONSchema7;
     metadata: JsonObject;

package/packages/kong-ts-contract/src/lib/{appProcessStartRequest.d.ts → appTaskStartRequest.d.ts}

@@ -1,6 +1,6 @@
 import { KongSpecJobSession } from "@kong/spec";
 import { JsonObject } from "@kong/ts";
-export interface AppProcessStartRequest {
+export interface AppTaskStartRequest {
     session: {
         businessKey: KongSpecJobSession["businessKey"];
         priority: KongSpecJobSession["priority"];

package/packages/kong-ts-contract/src/lib/sdkQuota.d.ts

@@ -8,4 +8,5 @@ export interface SdkRateLimiterQuota {
 export interface SdkConcurrencyQuota {
     minValue: number;
     maxValue: number;
+    initialValue: number;
 }

package/packages/kong-ts-contract/src/lib/types.d.ts

@@ -0,0 +1,2 @@
+import { Distinct } from "@kong/ts";
+export type FQIN = Distinct<string, "FQIN">;

package/packages/kong-ts-contract/src/lib/appAliasEditorMode.d.ts

@@ -1 +0,0 @@
-export type AppAliasEditorMode = "add" | "edit";

package/packages/kong-ts-contract/src/lib/appDevRequest.d.ts

@@ -1,8 +0,0 @@
-import { BusinessKey, JsonObject, UrlText, UtcDateTime } from "@kong/ts";
-export interface AppDevRequest {
-    url: UrlText;
-    businessKey: BusinessKey;
-    headers: Record<string, string>;
-    body: JsonObject;
-    deadline: UtcDateTime;
-}

package/packages/kong-ts-contract/src/lib/appDocumentBuild.d.ts

@@ -1,7 +0,0 @@
-import { UrlText, UtcDateTime } from "@kong/ts";
-import { AppExtensionAlias } from "./appExtensionAlias";
-export interface AppDocumentBuild {
-    aliasName: AppExtensionAlias["name"];
-    bundleUrl: UrlText;
-    deadline: UtcDateTime;
-}