@devkong/cli 0.0.65 → 0.0.66

package/package.json

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

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

@@ -1,7 +1,7 @@
 export { makeServerlessJavaAppProps, serverlessFlowBuilder, stringifyServerlessFlow, } from "./lib/kongServerless";
 export type { FloweyServerlessBuilder } from "./lib/kongServerless";
 export type { KongSpecJobSession } from "./lib/kongSession";
-export type { KongSpecAction, KongSpecActionCallFunction, KongSpecActionCallProcess, KongSpecActionDelay, KongSpecActionInject, KongSpecActionSendEvent, KongSpecAnnotation, KongSpecBranch, KongSpecCache, KongSpecCallModel, KongSpecCircuitBreaker, KongSpecCondition, KongSpecEffect, KongSpecEffectStatus, KongSpecError, KongSpecEventBroker, KongSpecEventConnection, KongSpecFeatureCompensation, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecHowToStore, KongSpecOutputAppend, KongSpecProcessRef, KongSpecRecord, KongSpecRecordHeader, KongSpecRetry, KongSpecRule, KongSpecSecretRef, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateExit, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent, KongSpecStoreRetryControl, KongSpecSupportsActions, KongSpecSupportsErrors, KongSpecSupportsOutputSample, KongSpecSupportsTransition, } from "./lib/kongSpec";
+export type { KongSpecAction, KongSpecActionCallFunction, KongSpecActionCallProcess, KongSpecActionDelay, KongSpecActionInject, KongSpecActionSendEvent, KongSpecAnnotation, KongSpecBranch, KongSpecCache, KongSpecCallModel, KongSpecCircuitBreaker, KongSpecCondition, KongSpecEffect, KongSpecEffectStatus, KongSpecError, KongSpecEventBroker, KongSpecEventConnection, KongSpecFeatureCompensation, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecHowToStore, KongSpecOutputAppend, KongSpecProcessRef, KongSpecRecord, KongSpecRecordHeader, KongSpecRetry, KongSpecRule, KongSpecSecretRef, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateExit, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateResult, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent, KongSpecStoreRetryControl, KongSpecSupportsActions, KongSpecSupportsErrors, KongSpecSupportsOutputSample, KongSpecSupportsTransition, } from "./lib/kongSpec";
 export { KongSpecBuild } from "./lib/kongSpecBuild";
 export { KongSpecDoc } from "./lib/kongSpecDoc";
 export { KongSpecEnv } from "./lib/kongSpecEnv";
@@ -13,6 +13,6 @@ 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, getDependencies, outputAggregator, outputAggregatorUnsafe, parallelStateOutputAggregator, traverseFlowUp, } from "./lib/kongSpecUtils";
+export { findSourceState, getActions, getConnectedExitStates, getDependencies, outputAggregator, outputAggregatorUnsafe, parallelStateOutputAggregator, parallelStateOutputAggregatorUnsafe, traverseFlowUp, } from "./lib/kongSpecUtils";
 export { validate } from "./lib/kongSpecValidate";
 export type { KongSpecValidationIssue, KongSpecValidators } from "./lib/kongSpecValidate";

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

@@ -13,7 +13,7 @@ export interface KongSpecProcessRef {
 interface KongSpecStateBase {
     id: Distinct<string, "KongSpecStateId">;
     name: string;
-    type: "start" | "succeed" | "fail" | "inject" | "compensate" | "foreach" | "callFunction" | "delay" | "parallel" | "rule" | "switch" | "sendEvent" | "waitEvent" | "callProcess";
+    type: "start" | "succeed" | "fail" | "result" | "inject" | "compensate" | "foreach" | "callFunction" | "delay" | "parallel" | "rule" | "switch" | "sendEvent" | "waitEvent" | "callProcess";
 }
 export interface KongSpecSupportsTransition {
     next: KongSpecStateBase["id"] | null;
@@ -136,6 +136,10 @@ export interface KongSpecStateSucceed extends KongSpecStateBase, KongSpecSupport
 export interface KongSpecStateFail extends KongSpecStateBase, KongSpecSupportsOutputFilter {
     type: "fail";
 }
+export interface KongSpecStateResult extends KongSpecStateBase, KongSpecSupportsOutputFilter {
+    type: "result";
+    status: string;
+}
 export interface KongSpecStateInject extends KongSpecStateBase, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend, KongSpecSupportsTransition {
     type: "inject";
 }
@@ -251,8 +255,8 @@ export interface KongSpecStateParallel extends KongSpecStateBase, KongSpecSuppor
     branches: KongSpecBranch[];
     completionType: "allOf" | "atLeast";
 }
-export type KongSpecState = KongSpecStateCallFunction | KongSpecStateCallProcess | KongSpecStateCompensate | KongSpecStateDelay | KongSpecStateFail | KongSpecStateForeach | KongSpecStateInject | KongSpecStateParallel | KongSpecStateRule | KongSpecStateSendEvent | KongSpecStateStart | KongSpecStateSucceed | KongSpecStateSwitch | KongSpecStateWaitEvent;
-export type KongSpecStateExit = KongSpecStateFail | KongSpecStateSucceed;
+export type KongSpecState = KongSpecStateCallFunction | KongSpecStateCallProcess | KongSpecStateCompensate | KongSpecStateDelay | KongSpecStateFail | KongSpecStateForeach | KongSpecStateInject | KongSpecStateParallel | KongSpecStateRule | KongSpecStateSendEvent | KongSpecStateStart | KongSpecStateResult | KongSpecStateSucceed | KongSpecStateSwitch | KongSpecStateWaitEvent;
+export type KongSpecStateExit = KongSpecStateFail | KongSpecStateSucceed | KongSpecStateResult;
 interface KongSpecAnnotationBase {
     id: Distinct<string, "KongSpecAnnotationId">;
 }

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

@@ -1,5 +1,5 @@
 import { JqObject, Optional } from "@kong/ts";
-import { KongSpecActionCallFunction, KongSpecActionCallProcess, KongSpecActionDelay, KongSpecActionInject, KongSpecActionSendEvent, KongSpecAnnotation, KongSpecBranch, KongSpecCallModel, KongSpecCondition, KongSpecError, KongSpecEventBroker, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecHowToStore, KongSpecProcessRef, KongSpecRecordHeader, KongSpecRule, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent } from "./kongSpec";
+import { KongSpecActionCallFunction, KongSpecActionCallProcess, KongSpecActionDelay, KongSpecActionInject, KongSpecActionSendEvent, KongSpecAnnotation, KongSpecBranch, KongSpecCallModel, KongSpecCondition, KongSpecError, KongSpecEventBroker, KongSpecFlow, KongSpecFunctionRef, KongSpecHowToInvoke, KongSpecHowToOutput, KongSpecHowToStore, KongSpecProcessRef, KongSpecRecordHeader, KongSpecRule, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateResult, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent } from "./kongSpec";
 export declare class KongSpecBuild {
     flow(id: KongSpecFlow["id"]): KongSpecFlow;
     startState(overrides?: Partial<KongSpecStateStart>): KongSpecStateStart;
@@ -16,6 +16,7 @@ export declare class KongSpecBuild {
     injectAction(overrides?: Partial<KongSpecActionInject>): KongSpecActionInject;
     delayAction(overrides?: Partial<KongSpecActionDelay>): KongSpecActionDelay;
     succeedState(afterState: Optional<KongSpecState["name"]>, overrides?: Partial<KongSpecStateSucceed>): KongSpecStateSucceed;
+    resultState(afterState: Optional<KongSpecState["name"]>, overrides?: Partial<KongSpecStateResult>): KongSpecStateResult;
     sendEventState(overrides?: Partial<KongSpecStateSendEvent>): KongSpecStateSendEvent;
     sendEventAction(overrides?: Partial<KongSpecActionSendEvent>): KongSpecActionSendEvent;
     waitEventState(overrides?: Partial<KongSpecStateWaitEvent>): KongSpecStateWaitEvent;

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

@@ -1,5 +1,5 @@
 import { JqFilter, JsonObject, JsonText, SessionTenant } from "@kong/ts";
-import { KongSpecAction, KongSpecFlow, KongSpecFunctionRef, KongSpecProcessRef, KongSpecState, KongSpecStateParallel, KongSpecSupportsTransition } from "./kongSpec";
+import { KongSpecAction, KongSpecFlow, KongSpecFunctionRef, KongSpecProcessRef, KongSpecState, KongSpecStateExit, KongSpecStateParallel, KongSpecSupportsTransition } from "./kongSpec";
 import { KongSpecActionPath, KongSpecStatePath } from "./kongSpecRef";
 interface TestItem {
     id: KongSpecState["id"] | KongSpecAction["id"];
@@ -13,11 +13,13 @@ interface Dependency {
     usage: Array<KongSpecAction["name"] | KongSpecState["name"]>;
 }
 export declare function traverseFlowUp(id: KongSpecState["id"] | KongSpecAction["id"], states: KongSpecFlow["states"], test: (current: TestItem) => boolean): boolean;
+export declare function getConnectedExitStates(states: KongSpecFlow["states"], stateRef: KongSpecState["id"]): KongSpecStateExit[];
+export declare function outputAggregatorUnsafe(jq: (sample: string, filter: JqFilter) => Promise<string>, getParallelOutput: (state: KongSpecStateParallel, flow: KongSpecFlow) => Promise<JsonObject>): (flow: KongSpecFlow, path: KongSpecStatePath | KongSpecActionPath, 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 outputAggregatorUnsafe(jq: (sample: string, filter: JqFilter) => Promise<string>): (flow: KongSpecFlow, path: KongSpecStatePath | KongSpecActionPath, includeTarget?: boolean) => Promise<JsonObject>;
 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 declare function parallelStateOutputAggregatorUnsafe(jq: (sample: string, filter: JqFilter) => Promise<string>): (state: KongSpecStateParallel, flow: KongSpecFlow) => Promise<JsonObject>;
+export declare function parallelStateOutputAggregator(jq: (sample: string, filter: JqFilter) => Promise<string>): (state: KongSpecStateParallel, flow: KongSpecFlow) => Promise<JsonObject>;
 export declare function getDependencies(flow: KongSpecFlow): Dependency[];
 export {};

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

@@ -1,7 +1,9 @@
-import { KongSpecAction, KongSpecFlow, KongSpecState } from "./kongSpec";
+import { JqArray, JqFilter, JqObject, JsonObject } from "@kong/ts";
+import { KongSpecAction, KongSpecFlow, KongSpecState, KongSpecStateParallel } from "./kongSpec";
 import { KongSpecActionPath, KongSpecStatePath } from "./kongSpecRef";
 export interface KongSpecValidationIssue {
     path: KongSpecStatePath | KongSpecActionPath;
+    isKick: boolean;
     severity: "error" | "warning";
     message: string;
     fix: string;
@@ -10,4 +12,4 @@ export interface KongSpecValidators {
     state: Array<(target: KongSpecState, path: KongSpecStatePath) => Promise<KongSpecValidationIssue[]>>;
     action: Array<(target: KongSpecAction, path: KongSpecActionPath) => Promise<KongSpecValidationIssue[]>>;
 }
-export declare function validate(flow: KongSpecFlow, validators: KongSpecValidators): Promise<KongSpecValidationIssue[]>;
+export declare function validate(flow: KongSpecFlow, validators: KongSpecValidators, getStateInputUnsafe: (flow: KongSpecFlow, path: KongSpecStatePath | KongSpecActionPath) => Promise<JsonObject>, getParallelStateOutputUnsafe: (state: KongSpecStateParallel, flow: KongSpecFlow) => Promise<JsonObject>, jqUnsafe: (sample: string, expression: JqFilter | JqObject | JqArray) => Promise<string>): Promise<KongSpecValidationIssue[]>;

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

@@ -2,7 +2,7 @@ export { compileGet, compileSet } from "./lib/accessor";
 export { generateBusinessKey } from "./lib/businessKey";
 export type { BusinessKey } from "./lib/businessKey";
 export { CloudEvent } from "./lib/cloudEvent";
-export { textToColor, textToMonoGradient } from "./lib/color";
+export { textToBackground, textToColor, textToMonoGradient } from "./lib/color";
 export { deepEquals, prepareTextForComparison, sameText, shadowEquals } from "./lib/compare";
 export { cronToText, isCron } from "./lib/cron";
 export type { Cron } from "./lib/cron";
@@ -18,9 +18,9 @@ export type { CompactUUID16, CompactUUID32, GUID, ShortUUID } from "./lib/id";
 export { intervalToString, millisToShortString } from "./lib/interval";
 export { applyJqFilterReplacements, applyJqObjectReplacements, applyJqTextReplacements, convertToJqFilter, extractJqTextContent, jqFilter, JqObjectSerializer, jqText, sanitizeJqFilter, wrapWithJqTextMarkers, } from "./lib/jq";
 export type { JqArray, JqFilter, JqObject, JqSerializer, JqText, RefactorReplacement, } from "./lib/jq";
-export { generateFakeJsonObject, jsonToHumanReadable, prettyJson, safeJsonParse } from "./lib/json";
+export { generateFakeJsonObject, jsonToHumanReadable, prettyJsonObject, prettyJsonText, safeJsonParse, } from "./lib/json";
 export type { JsonArray, JsonObject, JsonSchemaUrl, JsonText } from "./lib/json";
-export { buildExampleObject, createEmptyJsonSchema } from "./lib/jsonSchema";
+export { buildExampleObject, buildJSONSchemaType, createEmptyJsonSchema, hasJSONSchemaType, } from "./lib/jsonSchema";
 export { KeyGenerator } from "./lib/keyGenerator";
 export { findLastIndex, insertItem, moveItem, unique } from "./lib/list";
 export { deepMerge, deepMergeAll } from "./lib/merge";

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

@@ -1,2 +1,3 @@
 export declare function textToColor(text: string): string;
 export declare function textToMonoGradient(text: string): string;
+export declare function textToBackground(text: string): string;

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

@@ -1,3 +1,4 @@
 import { Distinct } from "./types";
 export type Duration8601 = Distinct<string, "Duration8601">;
+export type DynamicDuration = Duration8601 | string;
 export declare function isDuration(value: string): value is Duration8601;

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

@@ -1,3 +1,4 @@
+import { JSONSchema7 } from "json-schema";
 import { Distinct, Optional, Result } from "./types";
 export type JsonObject = Record<string, any>;
 export type JsonArray = Array<unknown>;
@@ -6,6 +7,7 @@ export type JsonSchemaUrl = Distinct<string, "JsonSchemaUrl">;
 export declare function safeJsonParse<T = any>(text: string): Result<{
     result: T;
 }>;
-export declare function generateFakeJsonObject(schemaObject: JsonObject): Optional<JsonObject>;
-export declare function prettyJson(value: Optional<JsonObject | JsonArray>): JsonText;
+export declare function generateFakeJsonObject(schemaObject: JSONSchema7): Optional<JsonObject>;
+export declare function prettyJsonObject(value: Optional<JsonObject | JsonArray>): JsonText;
 export declare function jsonToHumanReadable(value: Optional<JsonObject | JsonArray>): string;
+export declare function prettyJsonText(text: JsonText): Promise<JsonText>;

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

@@ -1,4 +1,6 @@
-import { JSONSchema7 } from "json-schema";
+import { JSONSchema7, JSONSchema7TypeName } from "json-schema";
 import { JsonObject, Optional } from "./types";
+export declare function hasJSONSchemaType(type: JSONSchema7["type"], name: JSONSchema7TypeName): boolean;
+export declare function buildJSONSchemaType(type: JSONSchema7["type"], nullable: boolean): JSONSchema7["type"];
 export declare function buildExampleObject(schema: JSONSchema7): Optional<JsonObject>;
 export declare function createEmptyJsonSchema(): JSONSchema7;

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

@@ -15,6 +15,7 @@ export type { AppPresignedUrl } from "./lib/appPresignedUrl";
 export type { AppProcessAlias } from "./lib/appProcessAlias";
 export type { AppProcessData } from "./lib/appProcessData";
 export type { AppProcessInstanceId } from "./lib/appProcessInstanceId";
+export type { AppProcessStats } from "./lib/appProcessStats";
 export type { AppProject } from "./lib/appProject";
 export type { AppSnapshot } from "./lib/appSnapshot";
 export type { AppSnapshotDetails } from "./lib/appSnapshotDetails";

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

@@ -1,5 +1,7 @@
+import { KongSpecJobSession } from "@kong/spec";
 import { BusinessKey, Entity, JsonText, Optional, SessionTenant, UtcDateTime } from "@kong/ts";
 export interface AppProcessData extends Entity {
+    sessionRootId: KongSpecJobSession["id"];
     tenant: SessionTenant;
     processId: string;
     processVersion: string;

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

@@ -0,0 +1,9 @@
+export interface AppProcessStats {
+    processVersion: string;
+    source: string;
+    total: number;
+    statusCounts: Record<string, number>;
+    avgDurationUs: number | null;
+    minDurationUs: number | null;
+    maxDurationUs: number | null;
+}

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

@@ -1,7 +1,9 @@
 import { Entity, User, UtcDateTime } from "@kong/ts";
+import { AppCheckpoint } from "./appCheckpoint";
 export interface AppSnapshot extends Entity {
     version: number;
     notes: string;
+    checkpoint: AppCheckpoint["id"];
     created: UtcDateTime;
     createdBy: User["name"];
 }