ankka-console 0.10.0 → 0.11.0

package/dist/client/control-plane.d.ts

@@ -1,4 +1,4 @@
-import { type AuthDiscovery, type CreateDeployToken, type CreateOrganization, type DeployTokenCreated, type DeployTokenSummary, type HistoryEntry, type LogsResponse, type MembersResponse, type OrganizationSummary, type ProjectDetail, type ProjectSummary, type Quota, type Role, type ServiceStatus, type SetRegistry, type Whoami } from "./schemas.ts";
+import { type AuthDiscovery, type BrokerDeclarationRequest, type CreateDeployToken, type CreateOrganization, type DeployTokenCreated, type DeployTokenSummary, type HistoryEntry, type LogsResponse, type MembersResponse, type OrganizationSummary, type ProjectBroker, type ProjectDetail, type ProjectSecretSummary, type ProjectSummary, type ProjectTopic, type Quota, type Role, type RolledBack, type ServiceStatus, type ServiceTopology, type SetRegistry, type TopicDeclarationRequest, type Whoami } from "./schemas.ts";
 /** `fetch`'s shape; the server supplies one that presents the console's certificate. */
 export type Transport = (url: string, init: RequestInit) => Promise<Response>;
 /**
@@ -11,6 +11,8 @@ export type BearerSource = (options: {
 export interface LogsQuery {
     instance?: string;
     previous?: boolean;
+    /** The platform's container (the sidecar, or a web-hosted service's proxy) instead of the developer's. */
+    platform?: boolean;
     tail?: number;
     since?: number;
 }
@@ -56,12 +58,34 @@ export declare class ControlPlaneClient {
     deleteProject(id: string): Promise<void>;
     setRegistry(id: string, body: SetRegistry): Promise<void>;
     clearRegistry(id: string): Promise<void>;
+    /** Entries of a project secret, merged into what it holds. The values are never read back. */
+    setProjectSecret(id: string, name: string, entries: Record<string, string>): Promise<void>;
+    unsetProjectSecretEntry(id: string, name: string, entry: string): Promise<void>;
+    listProjectSecrets(id: string): Promise<ProjectSecretSummary[]>;
+    /** Declares a topic on the project, or raises its partitions; its compaction and contract with it. */
+    declareTopic(id: string, name: string, request: TopicDeclarationRequest): Promise<void>;
+    /** The schema document a topic's contract was declared with. */
+    topicSchema(id: string, name: string): Promise<unknown>;
+    /** Stops declaring a topic; it stays on the broker. */
+    removeTopic(id: string, name: string): Promise<void>;
+    listTopics(id: string): Promise<ProjectTopic[]>;
+    /** Declares a broker beside the installation's, or changes where it is; the project secret holds its credential. */
+    declareBroker(id: string, name: string, request: BrokerDeclarationRequest): Promise<void>;
+    /** Stops declaring a broker; a service naming it is refused at its next start. */
+    removeBroker(id: string, name: string): Promise<void>;
+    listBrokers(id: string): Promise<ProjectBroker[]>;
     listServices(projectId: string): Promise<ServiceStatus[]>;
     getService(projectId: string, name: string): Promise<ServiceStatus>;
     /** The descriptor is sent as the text the person gave; the control plane is the one that validates it. */
     applyService(projectId: string, name: string, descriptor: string): Promise<ServiceStatus>;
     serviceOperation(projectId: string, name: string, operation: "pause" | "resume" | "restart" | "expose" | "unexpose"): Promise<void>;
     deleteService(projectId: string, name: string): Promise<void>;
+    /** Roll a service back to a generation: its descriptor applied again, as a new generation. */
+    rollback(projectId: string, name: string, generation: number): Promise<RolledBack>;
+    /** The descriptor applied at a generation, as the control plane accepts one. */
+    descriptor(projectId: string, name: string, generation: number): Promise<unknown>;
     history(projectId: string, name: string): Promise<HistoryEntry[]>;
     logs(projectId: string, name: string, query?: LogsQuery): Promise<LogsResponse>;
+    /** Every instance's topology, merged by the control plane; 404 when no instance runs. */
+    topology(projectId: string, name: string): Promise<ServiceTopology>;
 }

package/dist/client/control-plane.js

@@ -1,5 +1,7 @@
 import { ControlPlaneError, ControlPlaneUnreachable, SignInRequired } from "./errors.js";
-import { authDiscoverySchema, deployTokenCreatedSchema, deployTokenSummarySchema, historyEntrySchema, logsResponseSchema, membersResponseSchema, organizationSummarySchema, projectDetailSchema, projectSummarySchema, serviceStatusSchema, whoamiSchema, } from "./schemas.js";
+import { authDiscoverySchema, deployTokenCreatedSchema, deployTokenSummarySchema, historyEntrySchema, logsResponseSchema, membersResponseSchema, organizationSummarySchema, projectBrokerSchema, projectDetailSchema, projectSecretSummarySchema, projectSummarySchema, projectTopicSchema, rolledBackSchema, serviceStatusSchema, serviceTopologySchema, whoamiSchema, } from "./schemas.js";
+/** A descriptor is passed through as the control plane wrote it, as `applyService` takes one. */
+const anyJson = { parse: (value) => value };
 const arrayOf = (schema) => ({
     parse: (value) => {
         if (!Array.isArray(value))
@@ -119,6 +121,42 @@ export class ControlPlaneClient {
     clearRegistry(id) {
         return this.#call("DELETE", `/projects/${segment(id)}/registry`);
     }
+    /** Entries of a project secret, merged into what it holds. The values are never read back. */
+    setProjectSecret(id, name, entries) {
+        return this.#call("PUT", `/projects/${segment(id)}/secrets/${segment(name)}`, { body: { entries } });
+    }
+    unsetProjectSecretEntry(id, name, entry) {
+        return this.#call("DELETE", `/projects/${segment(id)}/secrets/${segment(name)}?entry=${segment(entry)}`);
+    }
+    listProjectSecrets(id) {
+        return this.#call("GET", `/projects/${segment(id)}/secrets`, { schema: arrayOf(projectSecretSummarySchema) });
+    }
+    /** Declares a topic on the project, or raises its partitions; its compaction and contract with it. */
+    declareTopic(id, name, request) {
+        return this.#call("PUT", `/projects/${segment(id)}/topics/${segment(name)}`, { body: request });
+    }
+    /** The schema document a topic's contract was declared with. */
+    topicSchema(id, name) {
+        return this.#call("GET", `/projects/${segment(id)}/topics/${segment(name)}/schema`, { schema: { parse: (v) => v } });
+    }
+    /** Stops declaring a topic; it stays on the broker. */
+    removeTopic(id, name) {
+        return this.#call("DELETE", `/projects/${segment(id)}/topics/${segment(name)}`);
+    }
+    listTopics(id) {
+        return this.#call("GET", `/projects/${segment(id)}/topics`, { schema: arrayOf(projectTopicSchema) });
+    }
+    /** Declares a broker beside the installation's, or changes where it is; the project secret holds its credential. */
+    declareBroker(id, name, request) {
+        return this.#call("PUT", `/projects/${segment(id)}/brokers/${segment(name)}`, { body: request });
+    }
+    /** Stops declaring a broker; a service naming it is refused at its next start. */
+    removeBroker(id, name) {
+        return this.#call("DELETE", `/projects/${segment(id)}/brokers/${segment(name)}`);
+    }
+    listBrokers(id) {
+        return this.#call("GET", `/projects/${segment(id)}/brokers`, { schema: arrayOf(projectBrokerSchema) });
+    }
     // ── Services ──────────────────────────────────────────────────────────────
     listServices(projectId) {
         return this.#call("GET", `/services/${segment(projectId)}`, { schema: arrayOf(serviceStatusSchema) });
@@ -139,6 +177,19 @@ export class ControlPlaneClient {
     deleteService(projectId, name) {
         return this.#call("DELETE", `/services/${segment(projectId)}/${segment(name)}`);
     }
+    /** Roll a service back to a generation: its descriptor applied again, as a new generation. */
+    rollback(projectId, name, generation) {
+        return this.#call("POST", `/services/${segment(projectId)}/${segment(name)}/rollback`, {
+            body: { generation },
+            schema: rolledBackSchema,
+        });
+    }
+    /** The descriptor applied at a generation, as the control plane accepts one. */
+    descriptor(projectId, name, generation) {
+        return this.#call("GET", `/services/${segment(projectId)}/${segment(name)}/descriptor?generation=${generation}`, {
+            schema: anyJson,
+        });
+    }
     history(projectId, name) {
         return this.#call("GET", `/services/${segment(projectId)}/${segment(name)}/history`, {
             schema: arrayOf(historyEntrySchema),
@@ -150,6 +201,8 @@ export class ControlPlaneClient {
             params.set("instance", query.instance);
         if (query.previous)
             params.set("previous", "true");
+        if (query.platform)
+            params.set("platform", "true");
         if (query.tail !== undefined)
             params.set("tail", String(query.tail));
         if (query.since !== undefined)
@@ -159,6 +212,12 @@ export class ControlPlaneClient {
             schema: logsResponseSchema,
         });
     }
+    /** Every instance's topology, merged by the control plane; 404 when no instance runs. */
+    topology(projectId, name) {
+        return this.#call("GET", `/services/${segment(projectId)}/${segment(name)}/topology`, {
+            schema: serviceTopologySchema,
+        });
+    }
     // ── Transport ─────────────────────────────────────────────────────────────
     async #call(method, path, options = {}) {
         const url = this.#baseUrl + path;