@devkong/cli 0.0.33 → 0.0.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli",
-  "version": "0.0.33",
+  "version": "0.0.34",
   "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,12 +1,13 @@
 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, 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";

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 {
@@ -14,7 +14,7 @@ export interface KongSpecProcessRef {
 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,22 +59,16 @@ 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[];
 }
@@ -83,10 +78,13 @@ export interface KongSpecSupportsOutputFilter {
 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 +104,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,6 +168,10 @@ 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;
@@ -211,7 +213,7 @@ export interface KongSpecStateParallel extends KongSpecStateBase, KongSpecSuppor
     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;
 export interface KongSpecFlow {
     id: Distinct<ShortUUID, "KongSpecFlowId">;

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, KongSpecActionSendEvent, 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,11 @@ 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;
+    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;
+    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 +30,4 @@ 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;
 }

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

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

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

@@ -7,5 +7,5 @@ interface ConvertSpecToServerlessResult {
     workflow: Specification.Workflow;
     inputSchema: JSONSchema7;
 }
-export declare function convertSpecToServerless(type: "main", tenant: SessionTenant, specFlow: KongSpecFlow, aliasName: KongSpecProcessRef["aliasName"], env: KongSpecEnv): ConvertSpecToServerlessResult;
+export declare function convertSpecToServerless(type: "v1", tenant: SessionTenant, specFlow: KongSpecFlow, aliasName: KongSpecProcessRef["aliasName"], env: KongSpecEnv): ConvertSpecToServerlessResult;
 export {};

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

@@ -1,11 +1,11 @@
-import { JqFilter, JsonObject } from "@kong/ts";
+import { JqFilter, JsonText } from "@kong/ts";
 import { KongSpecAction, KongSpecFlow, KongSpecState } from "./kongSpec";
 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, targetRef: KongSpecState["id"] | KongSpecAction["id"], 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 {};

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";

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-contract/src/index.d.ts

@@ -1,5 +1,4 @@
 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 { AppCheckpoint } from "./lib/appCheckpoint";

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/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/appDocumentBuild.d.ts

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

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

@@ -1,7 +1,10 @@
 import { KongSpecProcessRef } from "@kong/spec";
+import { Optional } from "@kong/ts";
 import { AppAliasDetails } from "./appAliasDetails";
+import { AppDocument } from "./appDocument";
 import { AppProcessAliasUseDetails } from "./appProcessAliasUseDetails";
 export interface AppProcessAliasDetails extends AppAliasDetails<AppProcessAliasUseDetails> {
+    appDocument: Optional<AppDocument>;
     name: KongSpecProcessRef["aliasName"];
     basedOnName: KongSpecProcessRef["basedOn"];
 }

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/appAliasEditorMode.d.ts

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