@devkong/cli 0.0.67-alpha.3 → 0.0.67-alpha.30

package/package.json

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

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

@@ -0,0 +1,49 @@
+import { Profile, ProfileName } from "../common/profile";
+export declare class ConnectCommand {
+    private profileName;
+    private profile;
+    private readonly isWin;
+    private readonly deployments;
+    private readonly templates;
+    private lock;
+    constructor(profileName: ProfileName, profile: Profile);
+    execute(): Promise<void>;
+    private handle;
+    private profileInfo;
+    /** Scaffolds the template, installs its deps and runs src/main_test.py. */
+    private runTests;
+    /**
+     * Deployments are asynchronous: the ui polls GET /v1/deployments/{id} and
+     * renders the steps in the same progress dialog as the kong-build path.
+     */
+    private startDeployment;
+    /**
+     * Scaffolds the cli template, swaps in the bundle and reuses kong install +
+     * kong publish-version (docker build/push + schema + snapshot save), mirroring
+     * their progress into the deployment status the ui polls.
+     */
+    private deploy;
+    /**
+     * Returns the (cached) scaffolded template for the extension, generating it
+     * once with `kong generate` and only swapping in the ui bundle's src folder
+     * and requirements.txt on subsequent calls. kong.json is patched so the
+     * publish saves the snapshot under the real extension.
+     */
+    private prepareTemplate;
+    /**
+     * Downloads the zip bundle from the kong-fs presigned url and unpacks it into
+     * the connect file list; the `id` entry (image name for kong-build) is not a
+     * source file, so it is dropped here.
+     */
+    private downloadBundle;
+    /** Runs `kong generate` into a fresh temp workspace and locates its root. */
+    private scaffold;
+    private cleanupTemplates;
+    private setStep;
+    private runExclusive;
+    private pythonBin;
+    private venvPython;
+    private run;
+    private readBody;
+    private json;
+}

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

@@ -1,4 +1,6 @@
 import { AppExtension } from "@kong/contract";
+export type ExtensionTemplate = "basic" | "with-secret" | "with-s3";
 export declare class GenerateCommand {
-    execute(extensionName: AppExtension["name"], sdk: "kotlin" | "python", presetVersion: string): Promise<void>;
+    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/commands/publishVersionCommand.d.ts

@@ -1,5 +1,11 @@
 import { ListrTask } from "listr2";
 import { Profile } from "../common/profile";
+import { PublishDetails } from "../services/registryClient";
+interface PublishContext {
+    contractText: string;
+    publishDetails?: PublishDetails;
+    fullImageName?: string;
+}
 export declare class PublishVersionCommand {
     private profile;
     private verbose;
@@ -11,8 +17,8 @@ export declare class PublishVersionCommand {
     private defaultRendererOptions;
     private get wslPrefix();
     constructor(profile: Profile, verbose?: boolean, contractPath?: string | null);
-    execute(appName: string, notes: string): Promise<void>;
-    flowFactory(appName: string, notes: string): Generator<ListrTask>;
+    execute(appName: string, notes: string, checkpoint?: string, onStep?: (step: string, status: "pending" | "succeeded" | "failed") => void): Promise<number>;
+    flowFactory(appName: string, notes: string, checkpoint?: string): Generator<ListrTask<PublishContext>>;
     private resolveRegistryUrl;
     private dockerBuildCmdText;
     private dockerPushCmdText;
@@ -21,3 +27,4 @@ export declare class PublishVersionCommand {
     private getKotlinBuildCmdTask;
     private getKotlinSchemaCmdTask;
 }
+export {};

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

@@ -1,8 +1,27 @@
 import { Profile } from "../common/profile";
+/** A single version→weight assignment parsed from the command line. */
+export interface AppAliasVersionWeight {
+    version: number;
+    /** Traffic percentage, or `null` for a "shadow" version (mirrored, no live traffic). */
+    balance: number | null;
+}
+/**
+ * Parse and validate all version configs. Live (non-shadow) weights must be > 0 and
+ * sum to exactly 100%; shadow versions are excluded from that total. Versions may
+ * not repeat and no more than {@link MAX_USES} versions can share an alias.
+ */
+export declare function parseVersionWeightList(list: string[]): AppAliasVersionWeight[];
 export declare class SetAliasCommand {
     private profile;
     private publicClient;
     private managementClient;
     constructor(profile: Profile);
-    execute(aliasName: string, extensionVersion: number, timeoutSeconds: number): Promise<void>;
+    execute(aliasName: string, weights: AppAliasVersionWeight[], 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

@@ -12,6 +12,8 @@ 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 {
     /**

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

@@ -1,4 +1,4 @@
-import { Optional, ShortUUID } from "@kong/ts";
+import { Optional } from "@kong/ts";
 export interface ILogger {
     info(message: string): void;
     debug(message: string): void;
@@ -9,8 +9,7 @@ export declare function env(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;
 export declare function spawnCommand(commandText: string, logger?: ILogger | null, shell?: boolean): Promise<string>;
 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 printError(label: string, error: unknown): void;
 export declare function escapePathSpaces(sourcePath: string): string;

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[]>;
-    getAuditLog(objectType: DeployObjectType, objectId: string): Promise<AppAuditLog[]>;
+    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,11 +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, 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";
 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,6 +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 { 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;
@@ -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

@@ -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"] | KongSpecFunctionRef["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

@@ -13,14 +13,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 { generateShortId, 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, 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";
@@ -36,7 +36,7 @@ export { TextReader } from "./lib/textReader";
 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";
+export { joinUrlAndFetch, joinUrlAndPath, urlText } from "./lib/url";
 export type { UrlText } from "./lib/url";
 export type { User } from "./lib/user";
 export { dateToUtc, utcNow, utcToZonedDate, utcToZonedText } from "./lib/utc";

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 generateShortId(): 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

@@ -1,5 +1,17 @@
 import { JSONSchema7, JSONSchema7TypeName } from "json-schema";
 import { JsonObject, Optional } from "./types";
+/**
+ * Collapses Pydantic's optional idiom `anyOf: [X, { "type": "null" }]` (and the `oneOf` form) down
+ * to `X`, recursively, and drops the now-dead `$defs`/`definitions`.
+ *
+ * Pydantic encodes every optional/nullable field as such a union instead of a nullable type, and
+ * `$ref` dereferencing inlines the branch but leaves the union in place. A form that reads
+ * `properties`/`type` straight off the node then sees an `anyOf` wrapper with no `properties` and
+ * renders nothing. When a single non-null branch remains it is merged with the union's sibling
+ * keywords (`default`, `description`, `title`, ...); genuine multi-branch unions keep their non-null
+ * branches. Run this right after dereferencing, before the schema reaches the form.
+ */
+export declare function normalizeNullableUnions<T = JSONSchema7>(schema: T): T;
 export declare function hasJSONSchemaType(type: JSONSchema7["type"], name: JSONSchema7TypeName): boolean;
 export declare function getPropertyType(schema: Optional<JSONSchema7> | null): string;
 export declare function isRequired(schema: Optional<JSONSchema7> | null, propertyKey: string): boolean;
@@ -7,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/src/lib/url.d.ts

@@ -2,3 +2,4 @@ import { Distinct } from "./types";
 export type UrlText = Distinct<string, "UrlText">;
 export declare function urlText(value: string): UrlText;
 export declare function joinUrlAndPath(baseUrl: UrlText, ...pathSegments: Array<string | number>): UrlText;
+export declare function joinUrlAndFetch(baseUrl: UrlText, path: string | number, init?: RequestInit): Promise<Response>;

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

@@ -1,3 +1,4 @@
 export interface User {
     name: string;
+    roles: string[];
 }

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

@@ -3,17 +3,23 @@ export type { AppAliasDetails } from "./lib/appAliasDetails";
 export type { AppAliasListItem } from "./lib/appAliasListItem";
 export type { AppAliasUse } from "./lib/appAliasUse";
 export type { AppAliasUseDetails } from "./lib/appAliasUseDetails";
+export type { AppArtifact, AppArtifactDetails, AppCodeTemplateData, AppCodeTemplateFile, } from "./lib/appArtifact";
 export { AuditObjectType } from "./lib/appAuditLog";
 export type { AppAuditLog } from "./lib/appAuditLog";
 export type { AppBroadcastData } from "./lib/appBroadcastData";
 export type { AppCheckpoint } from "./lib/appCheckpoint";
+export type { AppOrganizationItem } from "./lib/appOrganizationItem";
 export type { AppComponentStartRequest } from "./lib/appComponentStartRequest";
+export { APP_CONNECT_PORT, CLI_CONNECT_BASE_URL } from "./lib/appConnect";
+export type { AppConnectDeployRequest, AppConnectDeployStart, AppConnectDeployStatus, AppConnectDeployStep, AppConnectFile, AppConnectProfile, AppConnectTestRequest, AppConnectTestResult, } from "./lib/appConnect";
+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";
@@ -22,6 +28,7 @@ export type { AppProcessStats, AppProcessStatsBucket, AppProcessStatsSeries, } f
 export type { AppProject } from "./lib/appProject";
 export type { AppSecret } from "./lib/appSecret";
 export type { AppSecretDetails } from "./lib/appSecretDetails";
+export type { AppSecretPermission, AppSecretPermissionSubjectType, } from "./lib/appSecretPermission";
 export type { AppSecretType } from "./lib/appSecretType";
 export type { AppSnapshot } from "./lib/appSnapshot";
 export type { AppSnapshotDetails } from "./lib/appSnapshotDetails";
@@ -32,7 +39,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/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;
 }

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

@@ -0,0 +1,19 @@
+import { JsonObject } from "@kong/ts";
+export interface AppArtifact {
+    id: string;
+    name: string;
+    category: "code-template";
+    type: string;
+    description: string;
+}
+export interface AppArtifactDetails extends AppArtifact {
+    data: JsonObject;
+}
+export interface AppCodeTemplateFile {
+    name: string;
+    content: string;
+    binary?: boolean;
+}
+export interface AppCodeTemplateData {
+    files: AppCodeTemplateFile[];
+}

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

@@ -0,0 +1,45 @@
+import { Loading, UrlText } from "@kong/ts";
+export declare const APP_CONNECT_PORT = 41321;
+export declare const CLI_CONNECT_BASE_URL: UrlText;
+export interface AppConnectProfile {
+    profile: string;
+    baseUrl: string;
+    userName: string;
+    docker: boolean;
+    python: boolean;
+}
+export interface AppConnectFile {
+    name: string;
+    content: string;
+    binary?: boolean;
+}
+export interface AppConnectTestRequest {
+    extensionId: string;
+    extensionName: string;
+    bundleUrl: string;
+}
+export interface AppConnectTestResult {
+    passed: boolean;
+    output: string;
+}
+export interface AppConnectDeployRequest {
+    extensionId: string;
+    extensionName: string;
+    checkpoint: string;
+    bundleUrl: string;
+    notes?: string;
+}
+export interface AppConnectDeployStart {
+    deploymentId: string;
+}
+export interface AppConnectDeployStep {
+    name: string;
+    status: Loading;
+}
+export interface AppConnectDeployStatus {
+    status: "pending" | "succeeded" | "failed";
+    steps: AppConnectDeployStep[];
+    output: string;
+    version?: number;
+    error?: string;
+}

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

@@ -8,6 +8,7 @@ export interface AppDocument extends Entity {
     workspaceId: AppWorkspace["id"];
     projectId: AppProject["id"];
     title: string;
+    deprecated: boolean;
     checkpoint: Optional<AppCheckpoint["id"]>;
     created: UtcDateTime;
     updated: UtcDateTime;

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

@@ -0,0 +1,7 @@
+export interface AppOrganizationItem {
+    type: string;
+    id: string;
+    name: string;
+    context?: string;
+    deprecated: boolean;
+}

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

@@ -3,6 +3,7 @@ import { AppWorkspace } from "./appWorkspace";
 export interface AppProject extends Entity {
     id: ShortUUID;
     title: string;
+    deprecated: boolean;
     created: UtcDateTime;
     updated: UtcDateTime;
     workspaceId: AppWorkspace["id"];

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

@@ -1,5 +1,7 @@
 import { JsonObject } from "@kong/ts";
 import { AppSecret } from "@kong/contract";
+import { AppSecretPermission } from "./appSecretPermission";
 export type AppSecretDetails = AppSecret & {
     data: JsonObject;
+    permissions: AppSecretPermission[];
 };

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

@@ -0,0 +1,5 @@
+export type AppSecretPermissionSubjectType = "ORG_WORKSPACE" | "ORG_PROJECT";
+export interface AppSecretPermission {
+    subjectType: AppSecretPermissionSubjectType;
+    subjectId: 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";