@devkong/cli 0.0.67-alpha.25 → 0.0.67-alpha.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli",
-  "version": "0.0.67-alpha.25",
+  "version": "0.0.67-alpha.26",
   "type": "commonjs",
   "main": "./index.js",
   "typings": "./index.d.ts",

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

@@ -0,0 +1,29 @@
+import { Profile, ProfileName } from "../common/profile";
+export declare class ConnectCommand {
+    private profileName;
+    private profile;
+    private readonly isWin;
+    private readonly registryClient;
+    private readonly managementClient;
+    constructor(profileName: ProfileName, profile: Profile);
+    execute(): Promise<void>;
+    private handle;
+    private profileInfo;
+    /** Runs only src/main_test.py in a fresh venv and returns the raw output. */
+    private runTests;
+    /**
+     * The client-side twin of the kong-build pipeline: docker build + push from
+     * this machine (requirements.txt applied), schema generated locally with
+     * `main.py --schema`, then the snapshot registered in kong-management.
+     */
+    private deploy;
+    private snapshotFor;
+    /** Writes the bundle to a fresh temp folder, decoding binary entries. */
+    private materialize;
+    private prepareVenv;
+    private pythonBin;
+    private venvPython;
+    private run;
+    private readBody;
+    private json;
+}

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

@@ -4,5 +4,5 @@ export declare class ListAliasesCommand {
     private verbose;
     private readonly managementClient;
     constructor(profile: Profile, verbose: boolean);
-    execute(): Promise<void>;
+    execute(processId?: string): Promise<void>;
 }

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

@@ -3,5 +3,5 @@ export declare class ListVersionsCommand {
     private verbose;
     private readonly managementClient;
     constructor(profile: Profile, verbose: boolean);
-    execute(): Promise<void>;
+    execute(processId?: string): Promise<void>;
 }

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

@@ -1,4 +1,4 @@
-import { AppAuditLog, AppExtension, AppExtensionAlias, AppSnapshot, AppSnapshotDetails } from "@kong/contract";
+import { AppAliasDetails, AppAuditLog, AppDocument, AppExtension, AppExtensionAlias, AppSnapshot, AppSnapshotDetails } from "@kong/contract";
 import { Optional, UrlText } from "@kong/ts";
 import { DeployObjectType } from "../common/deployment";
 import { RequestConfigProvider } from "./api";
@@ -11,5 +11,7 @@ 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[]>;
+    getDocumentSnapshotVersions(documentId: AppDocument["id"]): Promise<AppSnapshot[]>;
+    getProcessAliases(documentId: AppDocument["id"]): Promise<AppAliasDetails[]>;
     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, 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 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";

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

@@ -11,6 +11,7 @@ export interface KongSpecProcessRef {
     aliasName: Distinct<string, "KongSpecProcessRefAliasName">;
 }
 export type KongSpecSecretType = Distinct<string, "KongSpecSecretType">;
+export type KongSpecSecretRef = Distinct<string, "KongSpecSecretRef">;
 interface KongSpecStateBase {
     id: Distinct<string, "KongSpecStateId">;
     name: string;
@@ -78,7 +79,7 @@ export interface KongSpecHowToStore {
     type: "CONTEXT" | "EXTERNAL" | "CONTEXT_AND_EXTERNAL";
     onFailure: "RETRY" | "SKIP";
     retry: KongSpecStoreRetryControl;
-    secretRef: JqFilter | null;
+    secretRef: KongSpecSecretRef | null;
 }
 export interface KongSpecHowToOutput {
     filter: JqFilter;

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

@@ -4,6 +4,8 @@ export type { BusinessKey } from "./lib/businessKey";
 export { CloudEvent } from "./lib/cloudEvent";
 export { textToBackground, textToColor, textToMonoGradient } from "./lib/color";
 export { deepEquals, prepareTextForComparison, sameText, shadowEquals } from "./lib/compare";
+export { KONG_CONNECT_BASE_URL, KONG_CONNECT_PORT } from "./lib/connect";
+export type { KongConnectDeployRequest, KongConnectDeployResult, KongConnectFile, KongConnectProfile, KongConnectTestRequest, KongConnectTestResult, } from "./lib/connect";
 export { cronToText, isCron } from "./lib/cron";
 export type { Cron } from "./lib/cron";
 export { DataGuardType } from "./lib/dataGuard";
@@ -13,7 +15,7 @@ export type { Duration8601 } from "./lib/duration";
 export type { Entity } from "./lib/entity";
 export { AppError, DataError, errorToPrettyString } from "./lib/error";
 export { ensureIsDuration, ensureIsDurationOrCron, ensureMinLength, nonNegative, nonRecursiveCall, notBlank, notNull, } from "./lib/guard";
-export { guid, stableUUID, uuidc16, uuidc32, uuidStableSequence } from "./lib/id";
+export { generateEmbeddedId, guid, stableUUID, uuidc16, uuidc32, uuidStableSequence, } from "./lib/id";
 export type { CompactUUID16, CompactUUID32, GUID, ShortUUID } from "./lib/id";
 export { intervalToString, millisToShortString } from "./lib/interval";
 export { applyJqFilterReplacements, applyJqObjectReplacements, applyJqTextReplacements, containsJqExpression, convertToJqFilter, extractJqTextContent, jqFilter, JqObjectSerializer, jqText, sanitizeJqFilter, wrapWithJqTextMarkers, } from "./lib/jq";

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

@@ -0,0 +1,31 @@
+export declare const KONG_CONNECT_PORT = 41321;
+export declare const KONG_CONNECT_BASE_URL = "http://localhost:41321";
+export interface KongConnectProfile {
+    profile: string;
+    baseUrl: string;
+    userName: string;
+    docker: boolean;
+    python: boolean;
+}
+export interface KongConnectFile {
+    name: string;
+    content: string;
+    binary?: boolean;
+}
+export interface KongConnectTestRequest {
+    files: KongConnectFile[];
+}
+export interface KongConnectTestResult {
+    passed: boolean;
+    output: string;
+}
+export interface KongConnectDeployRequest {
+    extensionId: string;
+    extensionName: string;
+    files: KongConnectFile[];
+    notes?: string;
+}
+export interface KongConnectDeployResult {
+    version: number;
+    output: string;
+}

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

@@ -8,5 +8,6 @@ export declare function guid(): GUID;
 export declare function uuidc32(): CompactUUID32;
 export declare function uuidc16(): CompactUUID16;
 export declare function uuidc8(): CompactUUID8;
+export declare function generateEmbeddedId(): ShortUUID;
 export declare function stableUUID<T extends string>(based: T): T;
 export declare function uuidStableSequence<T extends string>(based: T): () => T;

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

@@ -13,15 +13,16 @@ export type { AppDocument } from "./lib/appDocument";
 export type { AppDocumentPublish } from "./lib/appDocumentPublish";
 export type { AppDocumentSnapshot } from "./lib/appDocumentSnapshot";
 export type { AppDocumentSnapshotDetails } from "./lib/appDocumentSnapshotDetails";
-export type { AppExtension } from "./lib/appExtension";
+export type { AppExtension, AppExtensionOrigin } from "./lib/appExtension";
 export type { AppExtensionAlias } from "./lib/appExtensionAlias";
+export type { AppLabelledRole, AppMember, AppMemberGroup, AppMemberPermission, AppMemberPrincipal, AppPrincipalType, } from "./lib/appMember";
 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, AppProcessStatsBucket, AppProcessStatsSeries, } from "./lib/appProcessStats";
 export type { AppProject } from "./lib/appProject";
-export type { AppSecret, AppSecretKey } from "./lib/appSecret";
+export type { AppSecret } from "./lib/appSecret";
 export type { AppSecretDetails } from "./lib/appSecretDetails";
 export type { AppSecretType } from "./lib/appSecretType";
 export type { AppSnapshot } from "./lib/appSnapshot";
@@ -33,7 +34,6 @@ export type { AppTestCaseMatchFeature } from "./lib/appTestCaseMatchFeature";
 export type { AppTestResult } from "./lib/appTestResult";
 export type { AppTrigger } from "./lib/appTrigger";
 export type { AppWorkspace } from "./lib/appWorkspace";
-export type { AppLabelledRole, AppMember, AppMemberGroup, AppMemberPermission, AppMemberPrincipal, AppPrincipalType, } from "./lib/appMember";
 export type { AppWorkspaceAccess } from "./lib/appWorkspaceAccess";
 export type { SdkKongJson } from "./lib/sdkKongJson";
 export type { SdkConcurrencyQuota, SdkQuotaName, SdkRateLimiterQuota } from "./lib/sdkQuota";

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

@@ -1,10 +1,9 @@
-import { KongSpecAction, KongSpecFunctionRef, KongSpecProcessRef, KongSpecState } from "@kong/spec";
+import { KongSpecAction, KongSpecFunctionRef, KongSpecProcessRef, KongSpecSecretRef, KongSpecState } from "@kong/spec";
 import { SessionTenant } from "@kong/ts";
-import { AppSecretKey } from "./appSecret";
 export interface AppDependency {
     type: "function" | "process" | "secret";
     tenant: SessionTenant;
     basedOn: KongSpecFunctionRef["basedOn"] | KongSpecProcessRef["basedOn"] | undefined;
-    name: KongSpecFunctionRef["aliasName"] | KongSpecProcessRef["aliasName"] | AppSecretKey;
+    name: KongSpecFunctionRef["aliasName"] | KongSpecProcessRef["aliasName"] | KongSpecSecretRef;
     usage: Array<KongSpecAction["name"] | KongSpecState["name"]>;
 }

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

@@ -1,9 +1,12 @@
 import { Entity, Optional, ShortUUID, User, UtcDateTime } from "@kong/ts";
+export type AppExtensionOrigin = "ui" | "cli";
 export interface AppExtension extends Entity {
     id: ShortUUID;
     name: string;
     category: Optional<string>;
     deprecated: boolean;
+    origin: AppExtensionOrigin;
+    checkpoint: Optional<string>;
     created: UtcDateTime;
     updated: UtcDateTime;
     createdBy: User["name"];

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

@@ -1,8 +1,7 @@
-import { KongSpecSecretType } from "@kong/spec";
-import { Distinct, Entity, Loading, Optional, ShortUUID, User, UtcDateTime } from "@kong/ts";
-export type AppSecretKey = Distinct<string, "AppSecretKey">;
+import { KongSpecSecretRef, KongSpecSecretType } from "@kong/spec";
+import { Entity, Loading, Optional, ShortUUID, User, UtcDateTime } from "@kong/ts";
 export interface AppSecret extends Entity {
-    key: AppSecretKey;
+    key: KongSpecSecretRef;
     typeId: ShortUUID;
     type: KongSpecSecretType;
     typeCategory: string;

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

@@ -1,6 +1,6 @@
+import { KongSpecSecretType } from "@kong/spec";
 import { Entity, Optional, ShortUUID, User, UtcDateTime } from "@kong/ts";
 import { JSONSchema7 } from "json-schema";
-import { KongSpecSecretType } from "packages/kong-spec/src";
 export interface AppSecretType extends Entity {
     id: ShortUUID;
     category: "api" | "database" | "storage" | "custom";