@devkong/cli 0.0.56 → 0.0.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli",
-  "version": "0.0.56",
+  "version": "0.0.57",
   "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, 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, 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, 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, outputAggregator, parallelStateOutputAggregator, traverseFlowUp, } from "./lib/kongSpecUtils";
+export { findSourceState, getActions, getDependencies, outputAggregator, outputAggregatorUnsafe, parallelStateOutputAggregator, 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

@@ -1,6 +1,5 @@
-import { DataGuard, Distinct, Duration8601, JqFilter, JqObject, JqText, JsonObject, JsonText, Optional, SessionTenant, ShortUUID } from "@kong/ts";
+import { Cron, 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 {
     tenant: SessionTenant;
     basedOn: Distinct<string, "KongSpecFunctionRefBasedOn">;
@@ -28,7 +27,7 @@ export interface KongSpecCache {
     enabled: boolean;
     key: JqFilter;
     failOnMiss: JqFilter;
-    ttl: Duration8601;
+    ttl: Duration8601 | Cron;
     onFailure: "RETRY" | "SKIP";
 }
 export interface KongSpecRetry {
@@ -68,9 +67,27 @@ export interface KongSpecEffect {
     usage: Record<string, unknown>;
     data: JsonObject | null;
 }
+export interface KongSpecStoreRetryControl {
+    maxAttempts: number;
+    attemptDelay: Duration8601;
+    attemptTimeout: Duration8601 | null;
+}
+export interface KongSpecHowToStore {
+    type: "CONTEXT" | "EXTERNAL" | "CONTEXT_AND_EXTERNAL";
+    onFailure: "RETRY" | "SKIP";
+    retry: KongSpecStoreRetryControl;
+    secretRef: KongSpecSecretRef | null;
+}
+export interface KongSpecSecretRef {
+    type: string;
+    key: string;
+    metadata: Record<string, string>;
+}
 export interface KongSpecHowToOutput {
     filter: JqFilter;
+    store: KongSpecHowToStore;
     destinations: string[];
+    guards: DataGuard[];
 }
 export interface KongSpecSupportsInputFilter {
     inputFilter: JqFilter;
@@ -78,8 +95,12 @@ export interface KongSpecSupportsInputFilter {
 export interface KongSpecSupportsOutputFilter {
     outputFilter: JqFilter;
 }
+export interface KongSpecSupportsOutputStore {
+    outputStore: KongSpecHowToStore;
+}
+export type KongSpecOutputAppend = "list" | "last";
 export interface KongSpecSupportsOutputAppend {
-    outputAppend: Array<KongSpecAppend>;
+    outputAppend: Array<KongSpecOutputAppend>;
 }
 export interface KongSpecSupportsDataGuards {
     guards: DataGuard[];
@@ -87,7 +108,7 @@ export interface KongSpecSupportsDataGuards {
 export interface KongSpecSupportsOutputSample {
     outputSample: Optional<JsonText>;
 }
-export interface KongSpecCallModel extends KongSpecSupportsInput, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample, KongSpecSupportsDataGuards, KongSpecSupportsInvoke {
+export interface KongSpecCallModel extends KongSpecSupportsInput, KongSpecSupportsOutputFilter, KongSpecSupportsOutputStore, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample, KongSpecSupportsDataGuards, KongSpecSupportsInvoke {
 }
 export interface KongSpecSupportsErrors {
     errors: KongSpecError[];
@@ -163,9 +184,15 @@ export interface KongSpecStateSendEvent extends KongSpecStateBase, KongSpecSuppo
     connection: KongSpecEventConnection;
     record: KongSpecRecord;
 }
-export interface KongSpecStateWaitEvent extends KongSpecStateBase, KongSpecSupportsTransition, KongSpecSupportsErrors, KongSpecFeatureCompensation, KongSpecSupportsTimeout, KongSpecSupportsCompensatedBy, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample {
+export interface KongSpecStateWaitEvent extends KongSpecStateBase, KongSpecSupportsTransition, KongSpecSupportsErrors, KongSpecFeatureCompensation, KongSpecSupportsTimeout, KongSpecSupportsCompensatedBy, KongSpecSupportsOutputFilter, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample, KongSpecSupportsOutputStore {
     type: "waitEvent";
-    connection: KongSpecEventConnection;
+    correlationSource: "webhook";
+    correlationPath: string;
+    correlationFilter: JqFilter;
+    resolutionFilter: JqFilter;
+    resolutionAttemptDelay: Duration8601;
+    resolutionAttemptBackoff: "fast";
+    replyContent: JqText;
 }
 export interface KongSpecStateCallProcess extends KongSpecStateBase, KongSpecSupportsTransition, KongSpecCanBeUsedForCompensation, KongSpecSupportsErrors, KongSpecFeatureCompensation, KongSpecSupportsCompensatedBy, KongSpecCallModel {
     type: "callProcess";

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, 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, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent } from "./kongSpec";
 export declare class KongSpecBuild {
     flow(id: KongSpecFlow["id"]): KongSpecFlow;
     startState(overrides?: Partial<KongSpecStateStart>): KongSpecStateStart;
@@ -28,6 +28,7 @@ export declare class KongSpecBuild {
     recordHeader(overrides?: Partial<KongSpecRecordHeader>): KongSpecRecordHeader;
     error(overrides?: Partial<KongSpecError>): KongSpecError;
     output(overrides?: Partial<KongSpecHowToOutput>): KongSpecHowToOutput;
+    store(overrides?: Partial<KongSpecHowToStore>): KongSpecHowToStore;
     invoke(overrides?: Partial<KongSpecHowToInvoke>): KongSpecHowToInvoke;
     retry(overrides?: Partial<KongSpecHowToInvoke["retry"]>): KongSpecHowToInvoke["retry"];
     circuitBreaker(overrides?: Partial<KongSpecHowToInvoke["circuitBreaker"]>): KongSpecHowToInvoke["circuitBreaker"];

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

@@ -1,5 +1,6 @@
 export declare class KongSpecDoc {
     static aboutCompensation: string;
+    static aboutWaitEvent: string;
     static aboutProcessTimeout: string;
     static aboutCallbackTimeout: string;
     static aboutActionDataFilterOfOutput: string;
@@ -12,7 +13,7 @@ export declare class KongSpecDoc {
     static aboutResilience: string;
     static aboutLimits: string;
     static aboutIdentify: string;
-    static aboutSizeLimit: (bytes: number) => string;
+    static aboutSizeLimit: (bytes: string) => string;
     static aboutCallFunction: string;
     static aboutCallProcess: string;
     static aboutCompensate: string;
@@ -25,6 +26,5 @@ export declare class KongSpecDoc {
     static aboutSucceed: string;
     static aboutSwitch: string;
     static aboutRule: string;
-    static aboutWaitEvent: string;
     static aboutOptionalWhenAtLeastOne: string;
 }

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

@@ -1,15 +1,23 @@
-import { JqFilter, JsonText } from "@kong/ts";
-import { KongSpecAction, KongSpecFlow, KongSpecState, KongSpecStateParallel, KongSpecSupportsTransition } from "./kongSpec";
+import { JqFilter, JsonObject, JsonText, SessionTenant } from "@kong/ts";
+import { KongSpecAction, KongSpecFlow, KongSpecFunctionRef, KongSpecProcessRef, KongSpecState, KongSpecStateParallel, KongSpecSupportsTransition } from "./kongSpec";
 import { KongSpecActionPath, KongSpecStatePath } from "./kongSpecRef";
-interface FloweyTraverseStateTestItem {
+interface TestItem {
     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;
+interface Dependency {
+    type: "function" | "process";
+    tenant: SessionTenant;
+    basedOn: KongSpecFunctionRef["basedOn"] | KongSpecFunctionRef["basedOn"];
+    aliasName: KongSpecFunctionRef["aliasName"] | KongSpecProcessRef["aliasName"];
+    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 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 formatBytes(bytes: number, decimals?: number): string;
+export declare function getDependencies(flow: KongSpecFlow): Dependency[];
 export {};

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

@@ -4,16 +4,18 @@ export type { BusinessKey } from "./lib/businessKey";
 export { CloudEvent } from "./lib/cloudEvent";
 export { 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";
 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";
 export { AppError, DataError, errorToPrettyString } from "./lib/error";
-export { ensureIsDuration, nonNegative, nonRecursiveCall, notBlank, notNull } from "./lib/guard";
+export { ensureIsDuration, ensureIsDurationOrCron, nonNegative, nonRecursiveCall, notBlank, notNull, } from "./lib/guard";
 export { guid, stableUUID, uuidc16, uuidc32, uuidStableSequence } from "./lib/id";
 export type { CompactUUID16, CompactUUID32, GUID, ShortUUID } from "./lib/id";
-export { intervalToString } from "./lib/interval";
+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";
@@ -28,10 +30,10 @@ export { fromRequestId, generateTraceParent, newRequestId } from "./lib/telemetr
 export type { RequestId, TraceParent } from "./lib/telemetry";
 export { parseTenant } from "./lib/tenant";
 export type { SessionTenant } from "./lib/tenant";
-export { byteCount, camelize, escapeLikeText, escapeQuotes, escapeRegex, hashString, quote, removeOuterQuotes, replaceFirstOccurrence, splitToBlocks, trim, upperFirst, words, } from "./lib/text";
+export { byteCount, camelize, escapeLikeText, escapeQuotes, escapeRegex, formatBytes, getTextWidth, hashString, quote, removeOuterQuotes, replaceFirstOccurrence, splitToBlocks, trim, upperFirst, words, } from "./lib/text";
 export type { TextBlock } from "./lib/text";
 export { TextReader } from "./lib/textReader";
-export { DEFAULT_TIMEZONE } from "./lib/timezone";
+export { DEFAULT_TIMEZONE, getTimezoneLabel } from "./lib/timezone";
 export type { Timezone } from "./lib/timezone";
 export type { Action, DeepPartial, Distinct, Indexed, Loading, NonFunctionProperties, Optional, Pair, PreventDefault, Primitive, PropertyPath, PropertyPathMap, RequiredProperties, Result, StringKeys, UnArray, ValidateKeys, } from "./lib/types";
 export { joinUrlAndPath, urlText } from "./lib/url";

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

@@ -0,0 +1,4 @@
+import { Distinct } from "./types";
+export type Cron = Distinct<string, "Cron">;
+export declare function cronToText(value: string): string;
+export declare function isCron(value: string): value is Cron;

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

@@ -3,3 +3,4 @@ export declare function nonRecursiveCall<Args extends unknown[], R>(fn: (...args
 export declare function notBlank(value: string): void;
 export declare function nonNegative(value: number): void;
 export declare function ensureIsDuration(value: string): void;
+export declare function ensureIsDurationOrCron(value: string): void;

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

@@ -1 +1,2 @@
 export declare function intervalToString(from: Date, to: Date): string;
+export declare function millisToShortString(ms: number): string;

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

@@ -6,7 +6,7 @@ export interface JqObject {
 }
 export type JqArray = Array<Primitive | JqText | JqObject | JqArray>;
 export type RefactorReplacement = [RegExp, string];
-export interface JqSerializer<T = JqObject | JqArray> {
+export interface JqSerializer<T = JqObject | JqArray | JqText> {
     serialize(value: T): JqFilter;
 }
 export declare function jqFilter(value: Primitive): JqFilter;
@@ -17,8 +17,8 @@ export declare function applyJqFilterReplacements(value: JqFilter, replacements:
 export declare function applyJqObjectReplacements(obj: JqObject, replacements: RefactorReplacement[]): JqObject;
 export declare function applyJqTextReplacements(text: JqText, replacements: RefactorReplacement[]): JqText;
 export declare class JqObjectSerializer implements JqSerializer {
-    serialize(obj: JqObject | JqArray): JqFilter;
+    serialize(obj: JqObject | JqArray | JqText): JqFilter;
     private convert;
 }
-export declare function extractJqTextContent(text: JqText): string;
-export declare function wrapWithJqTextMarkers(content: string): JqText;
+export declare function extractJqTextContent(text: JqText): JqFilter;
+export declare function wrapWithJqTextMarkers(content: JqFilter): JqText;

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

@@ -16,3 +16,5 @@ export declare function camelize(text: string): string;
 export declare function escapeQuotes(text: string): string;
 export declare function escapeLikeText(text: string): string;
 export declare function byteCount(text: string): number;
+export declare function getTextWidth(font: string, text: string): number;
+export declare function formatBytes(bytes: number, decimals?: number): string;

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

@@ -2,4 +2,5 @@ import { Distinct } from "./types";
 export type Timezone = Distinct<string, "timezone">;
 export declare const UTC: Timezone;
 export declare const DEFAULT_TIMEZONE: Timezone;
+export declare function getTimezoneLabel(timezone: Timezone): string;
 export declare function getTimezoneList(): Promise<Timezone[]>;

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

@@ -13,6 +13,7 @@ export type { AppExtension } from "./lib/appExtension";
 export type { AppExtensionAlias } from "./lib/appExtensionAlias";
 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 { AppProject } from "./lib/appProject";
 export type { AppSnapshot } from "./lib/appSnapshot";

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

@@ -0,0 +1,13 @@
+import { BusinessKey, Entity, JsonText, Optional, SessionTenant, UtcDateTime } from "@kong/ts";
+export interface AppProcessData extends Entity {
+    tenant: SessionTenant;
+    processId: string;
+    processVersion: string;
+    businessKey: BusinessKey;
+    status: "REGISTERED" | "STARTED" | "SUCCEEDED" | "FAILED" | "EXPIRED" | "CANCELED";
+    source: string;
+    deadline: UtcDateTime;
+    created: Optional<UtcDateTime>;
+    updated: UtcDateTime;
+    result: Optional<JsonText>;
+}