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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkong/cli",
-  "version": "0.0.67-alpha.24",
+  "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/generateCommand.d.ts

@@ -1,5 +1,5 @@
 import { AppExtension } from "@kong/contract";
-export type ExtensionTemplate = "basic" | "advanced";
+export type ExtensionTemplate = "basic" | "with-secret" | "with-s3";
 export declare class GenerateCommand {
     execute(extensionName: AppExtension["name"], sdk: "kotlin" | "python", presetVersion: string, template?: ExtensionTemplate): Promise<void>;
     private promptTemplate;

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

@@ -6,6 +6,8 @@ export { KongSpecBuild } from "./lib/kongSpecBuild";
 export { KongSpecDoc } from "./lib/kongSpecDoc";
 export { KongSpecEnv } from "./lib/kongSpecEnv";
 export type { KongSpecFile } from "./lib/kongSpecFile";
+export { getKongFunctionOperations, getKongFunctionOperationSchema, getKongSpecXUI, getKongSpecXUIComponentConfig, isKongFunctionContractSchema, } from "./lib/kongSpecFunctionContract";
+export type { KongSpecXUIComponentConfig, KongSpecXUIConfig, KongSpecXUIFormConfig, KongSpecXUISecretConfig, } from "./lib/kongSpecFunctionContract";
 export type { KongSpecLayout, KongSpecLayoutPosition, KongSpecLayoutPositionKey, } from "./lib/kongSpecLayout";
 export { migrate } from "./lib/kongSpecMigrate";
 export { nameGenerator } from "./lib/kongSpecName";
@@ -13,8 +15,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, 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 { findSourceState, getActions, getConnectedExitStates, outputAggregator, outputAggregatorUnsafe, parallelStateOutputAggregator, parallelStateOutputAggregatorUnsafe, quoteSecretReferences, 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

@@ -10,8 +10,8 @@ export interface KongSpecProcessRef {
     basedOn: KongSpecFlow["id"];
     aliasName: Distinct<string, "KongSpecProcessRefAliasName">;
 }
-export type KongSpecSecretRef = Distinct<string, "KongSpecSecretRef">;
 export type KongSpecSecretType = Distinct<string, "KongSpecSecretType">;
+export type KongSpecSecretRef = Distinct<string, "KongSpecSecretRef">;
 interface KongSpecStateBase {
     id: Distinct<string, "KongSpecStateId">;
     name: string;
@@ -46,7 +46,7 @@ export interface KongSpecCircuitBreaker {
 }
 export interface KongSpecHowToInvoke {
     prefix: string;
-    secretRefs: Record<string, KongSpecSecretRef | null>;
+    secretRefs: Record<string, JqFilter | null>;
     retry: KongSpecRetry;
     cache: KongSpecCache;
     circuitBreaker: KongSpecCircuitBreaker;

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

@@ -1,17 +1,10 @@
-import { JqFilter, JsonObject, JsonText, Optional, SessionTenant } from "@kong/ts";
-import { KongSpecAction, KongSpecFlow, KongSpecFunctionRef, KongSpecProcessRef, KongSpecState, KongSpecStateExit, KongSpecStateParallel, KongSpecSupportsTransition } from "./kongSpec";
+import { JqFilter, JsonObject, JsonText, Optional } from "@kong/ts";
+import { KongSpecAction, KongSpecFlow, KongSpecState, KongSpecStateExit, KongSpecStateParallel, KongSpecSupportsTransition } from "./kongSpec";
 import { KongSpecActionPath, KongSpecStatePath } from "./kongSpecRef";
 interface TestItem {
     id: KongSpecState["id"] | KongSpecAction["id"];
     source: "initial" | "errors" | "transition" | "noMatchedRule" | "conditions" | "compensateBy" | "actions" | "branches";
 }
-interface Dependency {
-    type: "function" | "process";
-    tenant: SessionTenant;
-    basedOn: KongSpecFunctionRef["basedOn"] | KongSpecProcessRef["basedOn"];
-    aliasName: KongSpecFunctionRef["aliasName"] | KongSpecProcessRef["aliasName"];
-    usage: Array<KongSpecAction["name"] | KongSpecState["name"]>;
-}
 export declare function quoteSecretReferences(filter: JqFilter): JqFilter;
 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[];
@@ -22,5 +15,4 @@ export declare function findSourceState(states: KongSpecState[], targetRef: Kong
 export declare function convertActionToState(action: KongSpecAction): KongSpecState & KongSpecSupportsTransition;
 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-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,14 +15,14 @@ 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, convertToJqFilter, extractJqTextContent, jqFilter, JqObjectSerializer, jqText, sanitizeJqFilter, wrapWithJqTextMarkers, } from "./lib/jq";
+export { applyJqFilterReplacements, applyJqObjectReplacements, applyJqTextReplacements, containsJqExpression, convertToJqFilter, extractJqTextContent, jqFilter, JqObjectSerializer, jqText, sanitizeJqFilter, wrapWithJqTextMarkers, } from "./lib/jq";
 export type { JqArray, JqFilter, JqObject, JqSerializer, JqText, RefactorReplacement, } from "./lib/jq";
 export { generateFakeJsonObject, jsonToHumanReadable, prettyJsonObject, prettyJsonText, safeJsonParse, } from "./lib/json";
 export type { JsonArray, JsonObject, JsonSchemaUrl, JsonText } from "./lib/json";
-export { buildExampleObject, buildJSONSchemaType, createEmptyJsonSchema, getNestedValue, getPropertyType, hasJSONSchemaType, isRequired, normalizeNullableUnions, updateNestedValue, } from "./lib/jsonSchema";
+export { buildExampleObject, buildJSONSchemaType, createEmptyJsonSchema, getNestedValue, getPropertyType, hasJSONSchemaType, inferJsonSchema, isLikelyJsonSchema, isRequired, normalizeNullableUnions, updateNestedValue, } 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/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/src/lib/jq.d.ts

@@ -11,6 +11,7 @@ export interface JqSerializer<T = JqObject | JqArray | JqText> {
 }
 export declare function jqFilter(value: Primitive): JqFilter;
 export declare function jqText(value: string): JqText;
+export declare function containsJqExpression(value: unknown): value is JqText;
 export declare function sanitizeJqFilter(value: JqFilter): JqFilter;
 export declare function convertToJqFilter(value: JqText): JqFilter;
 export declare function applyJqFilterReplacements(value: JqFilter, replacements: RefactorReplacement[]): JqFilter;

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

@@ -19,4 +19,17 @@ export declare function getNestedValue(obj: any, path: string[]): any;
 export declare function updateNestedValue(obj: any, path: string[], value: any): any;
 export declare function buildJSONSchemaType(type: JSONSchema7["type"], nullable: boolean): JSONSchema7["type"];
 export declare function buildExampleObject(schema: JSONSchema7): Optional<JsonObject>;
+/**
+ * Heuristically decides whether a parsed JSON object is itself a JSON Schema rather than a plain
+ * data sample. A `properties` key alone is ambiguous (data can have one too), so it only counts
+ * when every property value is an object — i.e. could be a subschema.
+ */
+export declare function isLikelyJsonSchema(value: unknown): boolean;
+/**
+ * Derives a draft-07 schema from a plain JSON sample. Primitives keep the sampled value as
+ * `examples`, nulls become nullable strings (the sample carries no type information), array
+ * item schemas are inferred from the first element, and object properties with a non-null
+ * sampled value are marked required.
+ */
+export declare function inferJsonSchema(value: unknown): JSONSchema7;
 export declare function createEmptyJsonSchema(): JSONSchema7;

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

@@ -8,12 +8,14 @@ export type { AppAuditLog } from "./lib/appAuditLog";
 export type { AppBroadcastData } from "./lib/appBroadcastData";
 export type { AppCheckpoint } from "./lib/appCheckpoint";
 export type { AppComponentStartRequest } from "./lib/appComponentStartRequest";
+export type { AppDependency } from "./lib/appDependency";
 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";
@@ -32,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/appAuditLog.d.ts

@@ -5,7 +5,8 @@ export declare enum AuditObjectType {
     EXTENSION_ALIAS = "extension_alias",
     EXTENSION_SNAPSHOT = "extension_snapshot",
     DOCUMENT_SNAPSHOT = "document_snapshot",
-    EXTENSION = "extension"
+    EXTENSION = "extension",
+    SECRET = "secret"
 }
 export interface AppAuditLog {
     objectType: AuditObjectType;

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

@@ -0,0 +1,9 @@
+import { KongSpecAction, KongSpecFunctionRef, KongSpecProcessRef, KongSpecSecretRef, KongSpecState } from "@kong/spec";
+import { SessionTenant } from "@kong/ts";
+export interface AppDependency {
+    type: "function" | "process" | "secret";
+    tenant: SessionTenant;
+    basedOn: KongSpecFunctionRef["basedOn"] | KongSpecProcessRef["basedOn"] | undefined;
+    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/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";