@honua/react 0.1.9-beta.0 → 0.1.11-beta.0

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

@@ -83,5 +83,7 @@ export declare class HonuaAdminClient {
     call<Id extends AdminOperationId>(operationId: Id, request: AdminOperationRequest<Id>): Promise<AdminOperationResult<Id>>;
 }
 export declare function createHonuaAdminClient(options: AdminClientOptions): HonuaAdminClient;
+/** Enforce the admin credential transport policy for command-layer requests. */
+export declare function assertAdminBaseUrl(baseUrl: string): void;
 export {};
 //# sourceMappingURL=admin-client.d.ts.map

package/control-plane/admin-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-client.d.ts","sourceRoot":"","sources":["../../../src/control-plane/admin-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"admin-client.d.ts","sourceRoot":"","sources":["../../../src/control-plane/admin-client.ts"],"names":[],"mappings":"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"}

package/control-plane/admin-client.js

@@ -5,13 +5,31 @@ export class HonuaAdminApiError extends Error {
     statusCode;
     body;
     constructor(operationId, response, body) {
-        super(`Admin operation ${operationId} failed with HTTP ${response.status}.`);
+        const detail = structuredErrorDetail(body);
+        super(`Admin operation ${operationId} failed with HTTP ${response.status}.${detail ? ` ${detail}` : ""}`);
         this.name = "HonuaAdminApiError";
         this.operationId = operationId;
         this.statusCode = response.status;
         this.body = body;
     }
 }
+function structuredErrorDetail(body) {
+    if (typeof body !== "object" || body === null)
+        return undefined;
+    const record = body;
+    const detail = [record.detail, record.message, record.title].find((value) => typeof value === "string" && value.trim() !== "");
+    if (detail)
+        return detail;
+    if (record.errors !== undefined) {
+        try {
+            return JSON.stringify(record.errors);
+        }
+        catch {
+            return "The server returned structured validation errors.";
+        }
+    }
+    return undefined;
+}
 /**
  * Complete generated Admin REST client. Curated clients may wrap this surface,
  * but every operation in the pinned OpenAPI contract remains callable here.
@@ -71,6 +89,19 @@ function isLoopbackHost(hostname) {
 export function createHonuaAdminClient(options) {
     return new HonuaAdminClient(options);
 }
+/** Enforce the admin credential transport policy for command-layer requests. */
+export function assertAdminBaseUrl(baseUrl) {
+    const parsed = new URL(baseUrl);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error("Admin client baseUrl must use http or https.");
+    }
+    if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+        throw new Error("Admin client baseUrl must not include credentials, query parameters, or a fragment.");
+    }
+    if (parsed.protocol === "http:" && !isLoopbackHost(parsed.hostname)) {
+        throw new Error("Admin client requires HTTPS except for exact loopback HTTP development endpoints.");
+    }
+}
 function normalizeBasePath(value) {
     const rooted = value.startsWith("/") ? value : `/${value}`;
     return trimTrailingSlashes(rooted);

package/control-plane/client.d.ts

@@ -1,7 +1,7 @@
 import type { HonuaClient } from "../core/client.js";
 import type { QueryMethod } from "../core/types.js";
 import type { HonuaMapPackage } from "../runtime/index.js";
-import type { StudioCapabilityManifest } from "../studio/capability-manifest.js";
+import { type StudioCapabilityManifest } from "../studio/capability-manifest.js";
 import { type HonuaApiToken, type HonuaApiTokenCreateRequest, type HonuaCapabilityManifestOptions, type HonuaConnectionSummary, type HonuaControlPlaneCapability, type HonuaControlPlaneJob, type HonuaControlPlaneListOptions, type HonuaControlPlanePage, type HonuaControlPlaneRawRequest, type HonuaControlPlaneRequestOptions, type HonuaControlPlaneResult, type HonuaCreateHostedMapRequest, type HonuaHostedMap, type HonuaHostedMapSummary, type HonuaImportCreateRequest, type HonuaMapPackageSummary, type HonuaPublishMapPackageRequest, type HonuaPublishMapPackageResponse, type HonuaShareRequest, type HonuaShareResponse, type HonuaUpdateHostedMapRequest, type HonuaWorkspaceSummary } from "./types.js";
 export interface HonuaControlPlaneClientOptions {
     readonly client: HonuaClient;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/control-plane/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/control-plane/client.ts"],"names":[],"mappings":"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"}

package/control-plane/client.js

@@ -1,6 +1,7 @@
 import { honuaCacheValidatorFromHeaders } from "../core/cache-state.js";
 import { HonuaHttpError } from "../core/errors.js";
 import { trimTrailingSlashes } from "../core/path-utils.js";
+import { assertStudioCapabilityManifest } from "../studio/capability-manifest.js";
 import { HONUA_CAPABILITY_MANIFEST_PATH, HONUA_CONTROL_PLANE_BASE_PATH, } from "./types.js";
 export function createHonuaControlPlane(options) {
     return new HonuaControlPlaneClient(options);
@@ -48,7 +49,10 @@ export class HonuaControlPlaneClient {
      */
     async getCapabilityManifest(options = {}) {
         const { environment, workspaceId, ...requestOptions } = options;
-        return this.requestJson("capabilities", "GET", withManifestQuery(HONUA_CAPABILITY_MANIFEST_PATH, environment, workspaceId), undefined, requestOptions);
+        const result = await this.requestJson("capabilities", "GET", withManifestQuery(HONUA_CAPABILITY_MANIFEST_PATH, environment, workspaceId), undefined, requestOptions);
+        if (result.supported)
+            assertStudioCapabilityManifest(result.value);
+        return result;
     }
     async requestJson(capability, method, path, body, options = {}) {
         try {
@@ -155,18 +159,120 @@ export class HonuaImportsClient {
         this.#controlPlane = controlPlane;
     }
     listJobs(options = {}) {
-        return this.#controlPlane.requestPage("imports", "/imports/jobs", options);
+        return this.#controlPlane.requestPage("imports", "/import/jobs", options).then((result) => result.supported
+            ? {
+                supported: true,
+                value: {
+                    ...result.value,
+                    items: result.value.items.map(normalizeImportJob),
+                },
+            }
+            : result);
     }
-    create(request, options = {}) {
-        return this.#controlPlane.requestJson("imports", "POST", "/imports", request, options);
+    async create(request, options = {}) {
+        if (!request.sourceUrl?.trim()) {
+            throw new TypeError("Stored-connection imports are not supported by /import/upload-url; provide a sourceUrl for a URL import.");
+        }
+        if (request.connectionId) {
+            throw new TypeError("connectionId cannot be sent to /import/upload-url; provide only sourceUrl.");
+        }
+        const fileName = stringOption(request.options, "fileName") ?? fileNameFromUrl(request.sourceUrl);
+        const tableName = stringOption(request.options, "tableName") ?? slug(request.title ?? fileName ?? "imported_data");
+        const body = {
+            sourceUrl: request.sourceUrl,
+            fileName: fileName ?? "import.geojson",
+            tableName,
+            targetSchema: stringOption(request.options, "targetSchema"),
+            sourceSrid: numberOption(request.options, "sourceSrid"),
+            targetSrid: numberOption(request.options, "targetSrid") ?? 4326,
+            overwriteExisting: booleanOption(request.options, "overwriteExisting") ?? false,
+            forceBackground: true,
+            trackProgress: true,
+        };
+        return this.#controlPlane
+            .requestJson("imports", "POST", "/import/upload-url", body, options)
+            .then((result) => (result.supported ? { supported: true, value: normalizeImportJob(result.value) } : result));
     }
     getJob(jobId, options = {}) {
-        return this.#controlPlane.requestJson("imports", "GET", `/imports/jobs/${encodeURIComponent(jobId)}`, undefined, options);
+        return this.#controlPlane
+            .requestJson("imports", "GET", `/import/jobs/${encodeURIComponent(jobId)}`, undefined, options)
+            .then((result) => (result.supported ? { supported: true, value: normalizeImportJob(result.value) } : result));
     }
     job(jobId) {
-        return new HonuaControlPlaneJobHandle(this.#controlPlane, "imports", `/imports/jobs/${encodeURIComponent(jobId)}`);
+        return new HonuaControlPlaneJobHandle(this.#controlPlane, "imports", `/import/jobs/${encodeURIComponent(jobId)}`);
     }
 }
+function normalizeImportJob(value) {
+    const id = value.id ?? value.jobId;
+    if (!id)
+        throw new Error("Import response did not contain a job identifier.");
+    return {
+        ...value,
+        id,
+        type: "import",
+        status: normalizeImportJobStatus(value.status),
+        links: {
+            ...(value.links ?? {}),
+            ...(value.statusUrl ? { self: value.statusUrl } : {}),
+            ...(value.cancelUrl ? { cancel: value.cancelUrl } : {}),
+        },
+    };
+}
+function normalizeImportJobStatus(status) {
+    switch (status?.toLowerCase()) {
+        case "processing":
+        case "running":
+            return "running";
+        case "completed":
+        case "succeeded":
+        case "success":
+            return "succeeded";
+        case "cancelled":
+        case "canceled":
+            return "cancelled";
+        case "failed":
+            return "failed";
+        case "queued":
+            return "queued";
+        default:
+            return (status ?? "queued").toLowerCase();
+    }
+}
+function stringOption(options, key) {
+    return typeof options?.[key] === "string" ? options[key] : undefined;
+}
+function numberOption(options, key) {
+    return typeof options?.[key] === "number" ? options[key] : undefined;
+}
+function booleanOption(options, key) {
+    return typeof options?.[key] === "boolean" ? options[key] : undefined;
+}
+function fileNameFromUrl(sourceUrl) {
+    if (!sourceUrl)
+        return undefined;
+    try {
+        const name = new URL(sourceUrl).pathname.split("/").pop();
+        return name || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function slug(value) {
+    const normalized = Array.from(value.trim(), (character) => {
+        const code = character.charCodeAt(0);
+        return (code >= 48 && code <= 57) || (code >= 65 && code <= 90) || (code >= 97 && code <= 122) || code === 95
+            ? character
+            : "_";
+    }).join("");
+    let start = 0;
+    while (start < normalized.length && normalized[start] === "_")
+        start += 1;
+    let end = normalized.length;
+    while (end > start && normalized[end - 1] === "_")
+        end -= 1;
+    return normalized.slice(start, end) || "imported_data";
+}
 export class HonuaApiTokensClient {
     #controlPlane;
     constructor(controlPlane) {
@@ -227,7 +333,11 @@ export class HonuaControlPlaneJobHandle {
         this.#path = path;
     }
     poll(options = {}) {
-        return this.#controlPlane.requestJson(this.#capability, "GET", this.#path, undefined, options);
+        return this.#controlPlane
+            .requestJson(this.#capability, "GET", this.#path, undefined, options)
+            .then((result) => this.#capability === "imports" && result.supported
+            ? { supported: true, value: normalizeImportJob(result.value) }
+            : result);
     }
 }
 function supported(value) {
@@ -335,7 +445,13 @@ async function readJson(response) {
 }
 function normalizePage(body, response, options = {}) {
     const value = isRecord(body) ? body : {};
-    const items = (Array.isArray(value.items) ? value.items : Array.isArray(value.data) ? value.data : []);
+    const items = (Array.isArray(value.items)
+        ? value.items
+        : Array.isArray(value.data)
+            ? value.data
+            : Array.isArray(value.jobs)
+                ? value.jobs
+                : []);
     const pagination = isRecord(value.pagination) ? value.pagination : value;
     const validator = honuaCacheValidatorFromHeaders(response.headers) ?? options.fallbackValidator;
     const sourceUpdatedAt = response.headers.get("last-modified") ?? undefined;

package/control-plane/commands/catalog.d.ts

@@ -42,8 +42,6 @@ import type { HonuaCommand } from "./types.js";
 export interface ConnectionTestInput {
     /** Existing connection to probe. */
     readonly connectionId: string;
-    /** Workspace the connection belongs to, when the deployment scopes them. */
-    readonly workspaceId?: string;
 }
 /** Server probe result. Left open: the probe payload is deployment-specific. */
 export interface ConnectionTestOutput {
@@ -55,9 +53,9 @@ export interface ConnectionTestOutput {
 /**
  * `POST /connections/{connectionId}/test` — probe a stored connection.
  *
- * Modelled as an `action` rather than a `read` so repeated probes carry an
- * `Idempotency-Key` and collapse server-side; the probe itself does not mutate
- * the connection.
+ * The server does not consume an idempotency key or a workspace body. Keep the
+ * command identity limited to the connection route so receipts describe the
+ * request the server actually processed.
  */
 export declare const connectionTestCommand: HonuaCommand<ConnectionTestInput, ConnectionTestOutput>;
 /**
@@ -65,7 +63,9 @@ export declare const connectionTestCommand: HonuaCommand<ConnectionTestInput, Co
  *
  * The server's own `dryRun` request field is deliberately not exposed: dry run
  * is a command-layer concept here, and two spellings of it would let one
- * transport preview while another executed.
+ * transport preview while another executed. The current file-import endpoint
+ * accepts public source URLs only; stored-connection imports have no matching
+ * server route yet and are rejected before a request is issued.
  */
 export interface ImportCreateInput {
     readonly sourceKind: string;
@@ -75,7 +75,7 @@ export interface ImportCreateInput {
     readonly title?: string;
     readonly options?: Record<string, unknown>;
 }
-/** `POST /imports` — enqueue an import job. */
+/** `POST /import/upload-url` — enqueue a URL import job. */
 export declare const importCreateCommand: HonuaCommand<ImportCreateInput, HonuaControlPlaneJob>;
 /**
  * Input for {@link mapPackagePublishCommand}.

package/control-plane/commands/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/commands/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EACV,oBAAoB,EAGpB,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAmB,YAAY,EAA2B,MAAM,YAAY,CAAC;AAMzF,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,mBAAmB,EAAE,oBAAoB,CAyCzF,CAAC;AAkBF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,iBAAiB,EAAE,oBAAoB,CAsErF,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wDAAwD;AACxD,eAAO,MAAM,wBAAwB,EAAE,YAAY,CAAC,sBAAsB,EAAE,8BAA8B,CAwDzG,CAAC;AAMF,uDAAuD;AACvD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,gGAAgG;AAChG,eAAO,MAAM,6BAA6B,EAAE,YAAY,CAAC,2BAA2B,EAAE,oBAAoB,CA0FzG,CAAC;AAMF,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,kGAKpB,CAAC;AAEX,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;CAKiC,CAAC;AAE7D,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/commands/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EACV,oBAAoB,EAGpB,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAmB,YAAY,EAA2B,MAAM,YAAY,CAAC;AAMzF,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,mBAAmB,EAAE,oBAAoB,CAuCzF,CAAC;AAiBF;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,iBAAiB,EAAE,oBAAoB,CAqFrF,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wDAAwD;AACxD,eAAO,MAAM,wBAAwB,EAAE,YAAY,CAAC,sBAAsB,EAAE,8BAA8B,CAwDzG,CAAC;AAMF,uDAAuD;AACvD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,gGAAgG;AAChG,eAAO,MAAM,6BAA6B,EAAE,YAAY,CAAC,2BAA2B,EAAE,oBAAoB,CA0FzG,CAAC;AAMF,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,kGAKpB,CAAC;AAEX,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;CAKiC,CAAC;AAE7D,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE"}

package/control-plane/commands/catalog.js

@@ -38,22 +38,21 @@ import { HonuaCommandError } from "./errors.js";
 /**
  * `POST /connections/{connectionId}/test` — probe a stored connection.
  *
- * Modelled as an `action` rather than a `read` so repeated probes carry an
- * `Idempotency-Key` and collapse server-side; the probe itself does not mutate
- * the connection.
+ * The server does not consume an idempotency key or a workspace body. Keep the
+ * command identity limited to the connection route so receipts describe the
+ * request the server actually processed.
  */
 export const connectionTestCommand = {
     id: "connection.test",
     title: "Test a connection",
     description: "Probe a stored control-plane connection and report whether the server can reach it.",
-    mode: "action",
+    mode: "read",
     resourceKind: "connection",
     inputSchema: {
         type: "object",
         description: "Identifies the stored connection to probe.",
         properties: {
             connectionId: { type: "string", minLength: 1, description: "Identifier of the stored connection." },
-            workspaceId: { type: "string", minLength: 1, description: "Owning workspace, when the deployment scopes them." },
         },
         required: ["connectionId"],
         additionalProperties: false,
@@ -70,7 +69,6 @@ export const connectionTestCommand = {
         const result = await context.controlPlane.raw({
             method: "POST",
             path: connectionTestPath(context.input.connectionId),
-            ...(context.input.workspaceId ? { body: { workspaceId: context.input.workspaceId } } : {}),
             ...context.requestOptions(),
         });
         const value = unwrap(result, this.id, {
@@ -91,14 +89,13 @@ function connectionRef(input) {
     return {
         type: "connection",
         id: input.connectionId,
-        ...(input.workspaceId ? { workspaceId: input.workspaceId } : {}),
     };
 }
-/** `POST /imports` — enqueue an import job. */
+/** `POST /import/upload-url` — enqueue a URL import job. */
 export const importCreateCommand = {
     id: "import.create",
     title: "Create an import job",
-    description: "Enqueue a control-plane import job for a source URL or a stored connection.",
+    description: "Enqueue a control-plane import job for a source URL.",
     mode: "action",
     resourceKind: "import-job",
     inputSchema: {
@@ -107,7 +104,11 @@ export const importCreateCommand = {
         properties: {
             sourceKind: { type: "string", minLength: 1, description: "Import source kind, e.g. `geojson` or `postgis`." },
             sourceUrl: { type: "string", minLength: 1, description: "Source URL, when the import reads a location." },
-            connectionId: { type: "string", minLength: 1, description: "Stored connection, when the import reads a system." },
+            connectionId: {
+                type: "string",
+                minLength: 1,
+                description: "Compatibility input; the current /import/upload-url endpoint accepts sourceUrl only.",
+            },
             workspaceId: { type: "string", minLength: 1, description: "Workspace that will own the imported content." },
             title: { type: "string", minLength: 1, description: "Human title for the resulting content." },
             options: { type: "object", description: "Import-kind-specific options, passed through verbatim." },
@@ -116,11 +117,22 @@ export const importCreateCommand = {
         additionalProperties: false,
     },
     validate(input) {
-        // JSON Schema cannot say "one of these two", and this has to run before the
-        // dry-run short circuit: a preview that accepts an import with no source
-        // would be a preview of a request the server never sees.
+        // This has to run before the dry-run short circuit: a preview that accepts
+        // an import with no URL would be a preview of a request the server never
+        // sees.
         if (!input.sourceUrl && !input.connectionId) {
-            return [{ path: "", message: "one of `sourceUrl` or `connectionId` is required" }];
+            return [{ path: "sourceUrl", message: "`sourceUrl` is required by /import/upload-url" }];
+        }
+        if (!input.sourceUrl && input.connectionId) {
+            return [
+                {
+                    path: "connectionId",
+                    message: "stored-connection imports are not supported by /import/upload-url; provide `sourceUrl`",
+                },
+            ];
+        }
+        if (input.sourceUrl && input.connectionId) {
+            return [{ path: "", message: "provide only one of `sourceUrl` or `connectionId`" }];
         }
         return [];
     },
@@ -128,7 +140,7 @@ export const importCreateCommand = {
         const { input } = context;
         return {
             method: "POST",
-            path: "/imports",
+            path: "/import/upload-url",
             summary: `Import ${input.sourceKind} from ${input.sourceUrl ?? input.connectionId ?? "(unspecified source)"}`,
             resourceRef: {
                 type: "import-job",

package/control-plane/commands/runtime.d.ts

@@ -21,7 +21,7 @@
  *   every transport. The claimed {@link HonuaCommandIdentity} is echoed onto
  *   the receipt and never placed on the wire.
  * - **No caller-owned request identity.** The same screen refuses
- *   {@link HONUA_COMMAND_OWNED_HEADERS} — the `Idempotency-Key` and `If-Match`
+ *   {@link HONUA_COMMAND_OWNED_HEADERS} — the `Idempotency-Key`, `If-Match`, and `X-Correlation-ID`
  *   the runtime derives and records on the receipt. Both screens compare
  *   header names case-insensitively, so `Idempotency-Key`, `idempotency-key`,
  *   and `IDEMPOTENCY-KEY` are the same header to them. Without this a caller
@@ -54,14 +54,14 @@ export declare const HONUA_COMMAND_RESERVED_HEADERS: readonly ["authorization",
 /**
  * Headers the runtime derives and records on the receipt.
  *
- * A caller-supplied value for either one would put a different key on the wire
+ * A caller-supplied value would put a different key on the wire
  * than the receipt claims, which breaks exactly the two guarantees the receipt
  * exists to provide: that a retry collapses to one server-side effect, and that
  * an audit join can match a receipt to the request it describes. Callers set
- * these through {@link HonuaCommandInvocation.idempotencyKey} and
- * {@link HonuaCommandInvocation.ifMatch}, which are recorded.
+ * these through {@link HonuaCommandInvocation.idempotencyKey},
+ * {@link HonuaCommandInvocation.ifMatch}, and {@link HonuaCommandInvocation.correlationId}, which are recorded.
  */
-export declare const HONUA_COMMAND_OWNED_HEADERS: readonly ["idempotency-key", "if-match"];
+export declare const HONUA_COMMAND_OWNED_HEADERS: readonly ["idempotency-key", "if-match", "x-correlation-id"];
 /** Options accepted by every {@link HonuaCommandRuntime.execute} call. */
 export interface HonuaCommandInvocation {
     /** Surface issuing the call. Recorded on the receipt; never trusted. */
@@ -70,7 +70,7 @@ export interface HonuaCommandInvocation {
     readonly identity?: HonuaCommandIdentity;
     /** Explicit `Idempotency-Key`; derived deterministically from the input when omitted. */
     readonly idempotencyKey?: string;
-    /** Explicit correlation id; derived from the idempotency key when omitted. */
+    /** Explicit server correlation id (1–64 ASCII letters, digits, `-_.:`); derived when omitted. */
     readonly correlationId?: string;
     /** Preview only — the runtime returns the plan and never calls `execute`. */
     readonly dryRun?: boolean;

package/control-plane/commands/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/commands/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAUvD,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EAExB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAGpB;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,4WAmBjC,CAAC;AAIX;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,0CAA2C,CAAC;AAIpF,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AAED,iEAAiE;AACjE,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IAC7C,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,2CAA2C;AAC3C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CAElG;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;;gBAKX,OAAO,EAAE,0BAA0B;IAWtD,IAAW,YAAY,IAAI,uBAAuB,CAEjD;IAED,IAAW,MAAM,IAAI,0BAA0B,GAAG,SAAS,CAE1D;IAED;;;;;OAKG;IACU,OAAO,CAAC,MAAM,EAAE,OAAO,EAClC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;CAwFzC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,IAAI,CAUN;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,IAAI,CAgBN"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/commands/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAUvD,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EAExB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAGpB;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,4WAmBjC,CAAC;AAIX;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,8DAA+D,CAAC;AAIxG,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iGAAiG;IACjG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AAED,iEAAiE;AACjE,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IAC7C,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,2CAA2C;AAC3C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CAElG;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;;gBAKX,OAAO,EAAE,0BAA0B;IAWtD,IAAW,YAAY,IAAI,uBAAuB,CAEjD;IAED,IAAW,MAAM,IAAI,0BAA0B,GAAG,SAAS,CAE1D;IAED;;;;;OAKG;IACU,OAAO,CAAC,MAAM,EAAE,OAAO,EAClC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;CAyGzC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,IAAI,CAUN;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,IAAI,CAgBN"}

package/control-plane/commands/runtime.js

@@ -21,7 +21,7 @@
  *   every transport. The claimed {@link HonuaCommandIdentity} is echoed onto
  *   the receipt and never placed on the wire.
  * - **No caller-owned request identity.** The same screen refuses
- *   {@link HONUA_COMMAND_OWNED_HEADERS} — the `Idempotency-Key` and `If-Match`
+ *   {@link HONUA_COMMAND_OWNED_HEADERS} — the `Idempotency-Key`, `If-Match`, and `X-Correlation-ID`
  *   the runtime derives and records on the receipt. Both screens compare
  *   header names case-insensitively, so `Idempotency-Key`, `idempotency-key`,
  *   and `IDEMPOTENCY-KEY` are the same header to them. Without this a caller
@@ -76,14 +76,14 @@ const RESERVED_HEADER_SET = new Set(HONUA_COMMAND_RESERVED_HEADERS);
 /**
  * Headers the runtime derives and records on the receipt.
  *
- * A caller-supplied value for either one would put a different key on the wire
+ * A caller-supplied value would put a different key on the wire
  * than the receipt claims, which breaks exactly the two guarantees the receipt
  * exists to provide: that a retry collapses to one server-side effect, and that
  * an audit join can match a receipt to the request it describes. Callers set
- * these through {@link HonuaCommandInvocation.idempotencyKey} and
- * {@link HonuaCommandInvocation.ifMatch}, which are recorded.
+ * these through {@link HonuaCommandInvocation.idempotencyKey},
+ * {@link HonuaCommandInvocation.ifMatch}, and {@link HonuaCommandInvocation.correlationId}, which are recorded.
  */
-export const HONUA_COMMAND_OWNED_HEADERS = ["idempotency-key", "if-match"];
+export const HONUA_COMMAND_OWNED_HEADERS = ["idempotency-key", "if-match", "x-correlation-id"];
 const OWNED_HEADER_SET = new Set(HONUA_COMMAND_OWNED_HEADERS);
 /** Build a {@link HonuaCommandRuntime}. */
 export function createHonuaCommandRuntime(options) {
@@ -128,6 +128,14 @@ export class HonuaCommandRuntime {
         const failureContext = { correlationId, idempotencyKey, signal: invocation.signal };
         assertNoAuthorityOverride(command.id, invocation.headers, { correlationId, idempotencyKey });
         assertNoCommandKeyOverride(command.id, invocation.headers, { correlationId, idempotencyKey });
+        // Match the server's CorrelationIdMiddleware contract. An unsupported id
+        // would be silently replaced there, leaving the receipt unable to join it.
+        if (!/^[A-Za-z0-9_.:-]{1,64}$/.test(correlationId)) {
+            throw new HonuaCommandError("validation", command.id, "Command correlationId must contain 1–64 ASCII letters, digits, hyphens, underscores, dots, or colons.", {
+                ...failureContext,
+                issues: [{ path: "correlationId", message: "must match the server correlation-id format" }],
+            });
+        }
         // Schema first, then the command's own cross-field rules. Both run before
         // `plan`, so the dry-run preview below is reachable only for input the real
         // invocation would also accept.
@@ -151,13 +159,17 @@ export class HonuaCommandRuntime {
             correlationId,
             dryRun: invocation.dryRun === true,
             ...(invocation.signal ? { signal: invocation.signal } : {}),
-            requestOptions: (overrides = {}) => ({
-                ...(invocation.signal ? { signal: invocation.signal } : {}),
-                ...(command.mode === "action" ? { idempotencyKey } : {}),
-                ...(invocation.ifMatch ? { ifMatch: invocation.ifMatch } : {}),
-                ...(invocation.headers ? { headers: invocation.headers } : {}),
-                ...overrides,
-            }),
+            requestOptions: (overrides = {}) => {
+                const headers = new Headers(overrides.headers ?? invocation.headers);
+                headers.set("X-Correlation-ID", correlationId);
+                return {
+                    ...(invocation.signal ? { signal: invocation.signal } : {}),
+                    ...(command.mode === "action" ? { idempotencyKey } : {}),
+                    ...(invocation.ifMatch ? { ifMatch: invocation.ifMatch } : {}),
+                    ...overrides,
+                    headers,
+                };
+            },
         };
         let plan;
         try {
@@ -226,7 +238,7 @@ export function assertNoCommandKeyOverride(commandId, headers, context = {}) {
     if (offending.length === 0)
         return;
     const named = offending.sort().join(", ");
-    throw new HonuaCommandError("validation", commandId, `Command ${commandId} refused caller-supplied header(s) it derives itself: ${named}. Set them through the invocation's \`idempotencyKey\` / \`ifMatch\` so the value on the wire is the value the receipt records.`, {
+    throw new HonuaCommandError("validation", commandId, `Command ${commandId} refused caller-supplied header(s) it derives itself: ${named}. Set them through the invocation's \`idempotencyKey\` / \`ifMatch\` / \`correlationId\` so the value on the wire is the value the receipt records.`, {
         ...context,
         issues: offending.sort().map((name) => ({
             path: `headers.${name}`,
@@ -300,7 +312,7 @@ function buildReceipt(parts) {
         commandId: parts.command.id,
         mode: parts.command.mode,
         status: parts.status,
-        idempotencyKey: parts.idempotencyKey,
+        ...(parts.command.mode === "action" ? { idempotencyKey: parts.idempotencyKey } : {}),
         correlationId: parts.correlationId,
         identity: parts.identity,
         authorization: "server-enforced",

package/control-plane/commands/types.d.ts

@@ -146,14 +146,16 @@ export declare const HONUA_COMMAND_RECEIPT_KIND: "honua.command.receipt.v1";
  * the transport-independent projection so a server-side audit join can match
  * them. Nothing here is time-, host-, or random-dependent: `idempotencyKey`
  * and `correlationId` are derived from the command id, the canonicalized
- * input, and the tenant unless the caller supplies them.
+ * input, and the tenant unless the caller supplies them. Read commands omit
+ * `idempotencyKey` because no such key is sent to the server.
  */
 export interface HonuaCommandReceipt<TOutput = unknown> {
     readonly kind: typeof HONUA_COMMAND_RECEIPT_KIND;
     readonly commandId: string;
     readonly mode: HonuaCommandMode;
     readonly status: HonuaCommandStatus;
-    readonly idempotencyKey: string;
+    readonly idempotencyKey?: string;
+    /** Sent as `X-Correlation-ID` on every request belonging to this command. */
     readonly correlationId: string;
     readonly identity: HonuaCommandIdentity;
     /** Surface that issued the call. Recorded for audit; excluded from `auditKey`. */

package/control-plane/commands/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/commands/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/commands/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAC;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAErF,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,0CAA2C,CAAC;AAEjF,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,iEAAiE;AACjE,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;CAChD;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB,CAAC,OAAO;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,EAAG,0BAAmC,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO;IACpD,QAAQ,CAAC,IAAI,EAAE,OAAO,0BAA0B,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,mFAAmF;IACnF,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB,CAAC,MAAM;IACzC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,CAAC,EAAE,+BAA+B,GAAG,+BAA+B,CAAC;CAC9F;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,EAAE,OAAO;IAC3C,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,2BAA2B,EAAE,CAAC;IACjE,kFAAkF;IAClF,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC;IAC7D,wDAAwD;IACxD,OAAO,CAAC,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;CACtF;AAED,iEAAiE;AAEjE,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC"}