@devkong/cli 0.0.67-alpha.0 → 0.0.67-alpha.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli",
-  "version": "0.0.67-alpha.0",
+  "version": "0.0.67-alpha.10",
   "type": "commonjs",
   "main": "./index.js",
   "typings": "./index.d.ts",
@@ -8,6 +8,7 @@
     "kong": "./index.js"
   },
   "dependencies": {
-    "@napi-rs/keyring": "1.1.6"
+    "@napi-rs/keyring": "1.1.6",
+    "create-nx-workspace": "23.0.1"
   }
 }

package/packages/kong-cli/src/commands/setAliasCommand.d.ts

@@ -5,4 +5,11 @@ export declare class SetAliasCommand {
     private managementClient;
     constructor(profile: Profile);
     execute(aliasName: string, extensionVersion: number, timeoutSeconds: number): Promise<void>;
+    /**
+     * Poll the deployment audit log and settle one step per matching event. Runs
+     * detached from the task list; it settles a step as its event arrives and
+     * fails the rest on a failed/timed-out deployment, stopping on the failed or
+     * "deployment completed" event (poll terminal).
+     */
+    private pollDeploymentSteps;
 }

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

@@ -1,12 +1,19 @@
-import { AppAuditLog, AuditObjectType } from "@kong/contract";
+import { AppAuditLog } from "@kong/contract";
 import { Loading } from "@kong/ts";
 import { ManagementClient } from "../services/managementClient";
-/** Audit object types that carry a deployment trail. */
-export type DeployObjectType = AuditObjectType.EXTENSION_ALIAS | AuditObjectType.PROCESS_ALIAS;
+/**
+ * Audit object types that carry a deployment trail. These are the management
+ * `AuditObjectType` JVM enum *constant names* (not the `extension_alias` JSON
+ * wire value): the `/v1/audit` `objectType` query param is resolved server-side
+ * via `Enum.valueOf`, which matches the constant name.
+ */
+export type DeployObjectType = "EXTENSION_ALIAS" | "PROCESS_ALIAS";
 export interface DeploymentQuery {
     objectType: DeployObjectType;
     basedOnId: string;
     aliasName: string;
+    /** Only fetch audit events created at/after this UTC timestamp (ISO-8601). */
+    createdAfter?: string;
 }
 export interface DeploymentResult {
     /**
@@ -31,9 +38,17 @@ export declare function analyzeDeployment(events: AppAuditLog[]): DeploymentResu
  * `basedOnId`, so both object ids are fetched and merged newest-first.
  */
 export declare function getDeploymentLog(management: ManagementClient, query: DeploymentQuery): Promise<AppAuditLog[]>;
+/**
+ * Best-effort human-readable reason for a failed deployment, pulled from the
+ * first failure event's `eventData` (falling back to its action label) so the
+ * actual backend error can be surfaced to the console.
+ */
+export declare function deploymentErrorMessage(events: AppAuditLog[]): string;
 export interface PollProgress {
     /** Latest analyzed deployment status. */
     status: Loading;
+    /** Full deployment audit log analyzed so far, newest first. */
+    events: AppAuditLog[];
     /** Seconds elapsed since polling started (capped at `timeoutSeconds`). */
     elapsedSeconds: number;
     /** The configured deploy-wait budget. */

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

@@ -1,4 +1,4 @@
-import { Loading, Optional, ShortUUID } from "@kong/ts";
+import { Optional, ShortUUID } from "@kong/ts";
 export interface ILogger {
     info(message: string): void;
     debug(message: string): void;
@@ -14,5 +14,3 @@ export declare function spawnCommand(commandText: string, logger?: ILogger | nul
 export declare function spawnCommandWithArgs(command: string, commandArgs: string[], logger?: ILogger | null, shell?: boolean): Promise<string>;
 export declare function printError(message: string, error: unknown): void;
 export declare function escapePathSpaces(sourcePath: string): string;
-/** Render a fixed-width textual progress bar for live task output. */
-export declare function renderProgressBar(elapsedSeconds: number, timeoutSeconds: number, status: Loading): string;

package/packages/kong-cli/src/services/managementClient.d.ts

@@ -1,5 +1,6 @@
-import { AppAuditLog, AppExtension, AppExtensionAlias, AppSnapshot, AppSnapshotDetails, AuditObjectType } from "@kong/contract";
+import { AppAuditLog, AppExtension, AppExtensionAlias, AppSnapshot, AppSnapshotDetails } from "@kong/contract";
 import { Optional, UrlText } from "@kong/ts";
+import { DeployObjectType } from "../common/deployment";
 import { RequestConfigProvider } from "./api";
 export declare class ManagementClient {
     private requestConfigProvider;
@@ -10,5 +11,5 @@ export declare class ManagementClient {
     getExtensionSnapshot(extensionId: AppExtension["id"], extensionSnapshotVersion: AppSnapshot["version"]): Promise<Optional<AppSnapshotDetails>>;
     getExtensionSnapshotVersions(extensionId: AppExtension["id"]): Promise<AppSnapshot[]>;
     getExtensionSnapshotAliases(extensionId: AppExtension["id"]): Promise<AppExtensionAlias[]>;
-    getAuditLog(objectType: AuditObjectType, objectId: string): Promise<AppAuditLog[]>;
+    getAuditLog(objectType: DeployObjectType, objectId: string, createdAfter?: string): Promise<AppAuditLog[]>;
 }

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, KongSpecSecretType, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateExit, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateResult, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent, KongSpecStoreRetryControl, KongSpecSupportsActions, KongSpecSupportsErrors, KongSpecSupportsInvoke, KongSpecSupportsOutputSample, KongSpecSupportsOutputStore, 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, KongSpecSecretType, KongSpecState, KongSpecStateCallFunction, KongSpecStateCallProcess, KongSpecStateCompensate, KongSpecStateDelay, KongSpecStateExit, KongSpecStateFail, KongSpecStateForeach, KongSpecStateInject, KongSpecStateParallel, KongSpecStateResult, KongSpecStateRule, KongSpecStateSendEvent, KongSpecStateStart, KongSpecStateSucceed, KongSpecStateSwitch, KongSpecStateWaitEvent, KongSpecStoreRetryControl, KongSpecSupportsActions, KongSpecSupportsErrors, KongSpecSupportsInvoke, KongSpecSupportsOutputSample, KongSpecSupportsOutputStore, KongSpecSupportsTaskMode, KongSpecSupportsTransition, } from "./lib/kongSpec";
 export { KongSpecBuild } from "./lib/kongSpecBuild";
 export { KongSpecDoc } from "./lib/kongSpecDoc";
 export { KongSpecEnv } from "./lib/kongSpecEnv";
@@ -14,5 +14,7 @@ export { KongSpecRef } from "./lib/kongSpecRef";
 export type { KongSpecActionPath, KongSpecStatePath } from "./lib/kongSpecRef";
 export { convertSpecToServerless } from "./lib/kongSpecToServerless";
 export { findSourceState, getActions, getConnectedExitStates, getDependencies, outputAggregator, outputAggregatorUnsafe, parallelStateOutputAggregator, parallelStateOutputAggregatorUnsafe, quoteSecretReferences, traverseFlowUp, } from "./lib/kongSpecUtils";
+export { getKongFunctionOperations, getKongFunctionOperationSchema, getKongSpecXUI, getKongSpecXUIComponentConfig, isKongFunctionContractSchema, } from "./lib/kongSpecFunctionContract";
+export type { KongSpecXUIComponentConfig, KongSpecXUIConfig, KongSpecXUIFormConfig, KongSpecXUISecretConfig, } from "./lib/kongSpecFunctionContract";
 export { validate } from "./lib/kongSpecValidate";
 export type { KongSpecValidationIssue, KongSpecValidators } from "./lib/kongSpecValidate";

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

@@ -106,7 +106,10 @@ export interface KongSpecSupportsDataGuards {
 export interface KongSpecSupportsOutputSample {
     outputSample: Optional<JsonText>;
 }
-export interface KongSpecCallModel extends KongSpecSupportsInput, KongSpecSupportsOutputFilter, KongSpecSupportsOutputStore, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample, KongSpecSupportsDataGuards, KongSpecSupportsInvoke {
+export interface KongSpecSupportsTaskMode {
+    mode: "blocking" | "non-blocking";
+}
+export interface KongSpecCallModel extends KongSpecSupportsInput, KongSpecSupportsOutputFilter, KongSpecSupportsOutputStore, KongSpecSupportsOutputAppend, KongSpecSupportsOutputSample, KongSpecSupportsDataGuards, KongSpecSupportsTaskMode, KongSpecSupportsInvoke {
 }
 export interface KongSpecSupportsErrors {
     errors: KongSpecError[];

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

@@ -15,6 +15,7 @@ export declare class KongSpecDoc {
     static aboutIdentify: string;
     static aboutSizeLimit: (bytes: string) => string;
     static aboutCallFunction: string;
+    static aboutMode: string;
     static aboutCallProcess: string;
     static aboutCompensate: string;
     static aboutFail: string;

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

@@ -0,0 +1,26 @@
+import { Optional } from "@kong/ts";
+import { JSONSchema7 } from "json-schema";
+import { KongSpecSecretType } from "./kongSpec";
+export interface KongSpecXUISecretConfig {
+    purpose: string;
+    types: Array<KongSpecSecretType>;
+}
+export interface KongSpecXUIComponentConfig {
+    type: "TEXT_AREA";
+}
+export type KongSpecXUIFormConfig = Record<string, KongSpecXUIComponentConfig>;
+export interface KongSpecXUIConfig {
+    version?: number;
+    secrets: Array<KongSpecXUISecretConfig>;
+    form: KongSpecXUIFormConfig;
+}
+/** Reads the `x-ui` block of a schema, if present. */
+export declare function getKongSpecXUI(schema: Optional<JSONSchema7> | null): Optional<KongSpecXUIConfig>;
+/** Reads the `x-ui.form` component config for a property path (e.g. `[".notes"]`). */
+export declare function getKongSpecXUIComponentConfig(schema: Optional<JSONSchema7> | null, path: string[]): Optional<KongSpecXUIComponentConfig>;
+/** True when the schema describes a KongFunctionContract (i.e. it exposes a `request` envelope). */
+export declare function isKongFunctionContractSchema(schema: Optional<JSONSchema7> | null): boolean;
+/** The operation names of a contract schema — all object properties except `request`. */
+export declare function getKongFunctionOperations(schema: Optional<JSONSchema7> | null): string[];
+/** The sub-schema describing the payload of a single operation. */
+export declare function getKongFunctionOperationSchema(schema: Optional<JSONSchema7> | null, operation: string): Optional<JSONSchema7>;

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

@@ -8,7 +8,7 @@ interface TestItem {
 interface Dependency {
     type: "function" | "process";
     tenant: SessionTenant;
-    basedOn: KongSpecFunctionRef["basedOn"] | KongSpecFunctionRef["basedOn"];
+    basedOn: KongSpecFunctionRef["basedOn"] | KongSpecProcessRef["basedOn"];
     aliasName: KongSpecFunctionRef["aliasName"] | KongSpecProcessRef["aliasName"];
     usage: Array<KongSpecAction["name"] | KongSpecState["name"]>;
 }

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

@@ -1,5 +1,5 @@
 import { AppSnapshot } from "./appSnapshot";
 export interface AppAliasUse {
     snapshot: AppSnapshot;
-    balance: number;
+    balance: number | null;
 }

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

@@ -3,7 +3,7 @@ import { AppAliasUse } from "./appAliasUse";
 import { AppSnapshotDetails } from "./appSnapshotDetails";
 export interface AppAliasUseDetails extends AppAliasUse {
     snapshot: AppSnapshotDetails;
-    balance: number;
+    balance: number | null;
     inputFilter?: JqFilter;
     outputFilter?: JqFilter;
 }