@honua/react 0.1.7-beta.0 → 0.1.10-beta.0

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

@@ -0,0 +1,89 @@
+import type { operations } from "./generated/admin-api.js";
+import { type AdminOperationId } from "./generated/admin-operations.js";
+type Operation<Id extends AdminOperationId> = operations[Id];
+type OperationParameters<Id extends AdminOperationId> = Operation<Id> extends {
+    parameters: infer Parameters;
+} ? Parameters : never;
+type ParameterValue<Id extends AdminOperationId, Kind extends "header" | "path" | "query"> = OperationParameters<Id> extends {
+    [Key in Kind]?: infer Value;
+} ? Exclude<Value, undefined> : never;
+type RequiredRequestBody<Id extends AdminOperationId> = Operation<Id> extends {
+    requestBody: infer RequestBody;
+} ? RequestBody : never;
+type OptionalRequestBody<Id extends AdminOperationId> = Operation<Id> extends {
+    requestBody?: infer RequestBody;
+} ? Exclude<RequestBody, undefined> : never;
+type RequestBodyContent<RequestBody> = RequestBody extends {
+    content: infer Content;
+} ? Content : never;
+type ContentValue<Content> = Content extends Record<PropertyKey, unknown> ? Content[keyof Content] : never;
+export type AdminOperationRequestBody<Id extends AdminOperationId> = ContentValue<RequestBodyContent<RequiredRequestBody<Id> | OptionalRequestBody<Id>>>;
+export type AdminOperationContentType<Id extends AdminOperationId> = Extract<keyof RequestBodyContent<RequiredRequestBody<Id> | OptionalRequestBody<Id>>, string>;
+type OptionalField<Name extends string, Value> = [Value] extends [never] ? {
+    readonly [Key in Name]?: never;
+} : {
+    readonly [Key in Name]?: Value;
+};
+type RequiredField<Name extends string, Value> = [Value] extends [never] ? {
+    readonly [Key in Name]?: never;
+} : {
+    readonly [Key in Name]: Value;
+};
+type BodyField<Id extends AdminOperationId> = [RequiredRequestBody<Id>] extends [never] ? [OptionalRequestBody<Id>] extends [never] ? {
+    readonly body?: never;
+    readonly contentType?: never;
+} : {
+    readonly body?: AdminOperationRequestBody<Id>;
+    readonly contentType?: AdminOperationContentType<Id>;
+} : {
+    readonly body: AdminOperationRequestBody<Id>;
+    readonly contentType?: AdminOperationContentType<Id>;
+};
+export type AdminOperationRequest<Id extends AdminOperationId> = RequiredField<"path", ParameterValue<Id, "path">> & OptionalField<"query", ParameterValue<Id, "query">> & OptionalField<"headers", ParameterValue<Id, "header"> & HeadersInit> & BodyField<Id> & {
+    readonly signal?: AbortSignal;
+};
+type SuccessStatus<Status> = Status extends number ? `${Status}` extends `2${string}` ? Status : never : Status extends `${2}${string}` ? Status : never;
+type ResponseContent<Response> = Response extends {
+    content: infer Content;
+} ? ContentValue<Content> : undefined;
+type SuccessResponsePayload<Responses> = {
+    [Status in keyof Responses]: SuccessStatus<Status> extends never ? never : ResponseContent<Responses[Status]>;
+}[keyof Responses];
+export type AdminOperationResponse<Id extends AdminOperationId> = Operation<Id> extends {
+    responses: infer Responses;
+} ? SuccessResponsePayload<Responses> : never;
+export interface AdminClientOptions {
+    readonly baseUrl: string;
+    /** Scoped API key; sent as `X-API-Key`. */
+    readonly apiKey?: string;
+    /** Root/admin key. Takes precedence over `apiKey`. */
+    readonly adminKey?: string;
+    readonly basePath?: string;
+    readonly fetchFn?: typeof fetch;
+    readonly headers?: HeadersInit;
+}
+export interface AdminOperationResult<Id extends AdminOperationId> {
+    readonly operationId: Id;
+    readonly data: AdminOperationResponse<Id>;
+    readonly response: Response;
+}
+export declare class HonuaAdminApiError extends Error {
+    readonly operationId: AdminOperationId;
+    readonly statusCode: number;
+    readonly body: unknown;
+    constructor(operationId: AdminOperationId, response: Response, body: unknown);
+}
+/**
+ * Complete generated Admin REST client. Curated clients may wrap this surface,
+ * but every operation in the pinned OpenAPI contract remains callable here.
+ */
+export declare class HonuaAdminClient {
+    #private;
+    constructor(options: AdminClientOptions);
+    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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,200 @@
+import { trimTrailingSlashes } from "../core/path-utils.js";
+import { ADMIN_API_BASE_PATH, ADMIN_OPERATIONS } from "./generated/admin-operations.js";
+export class HonuaAdminApiError extends Error {
+    operationId;
+    statusCode;
+    body;
+    constructor(operationId, response, body) {
+        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.
+ */
+export class HonuaAdminClient {
+    #baseUrl;
+    #basePath;
+    #fetch;
+    #headers;
+    #credential;
+    constructor(options) {
+        const baseUrl = new URL(options.baseUrl);
+        if (baseUrl.protocol !== "http:" && baseUrl.protocol !== "https:") {
+            throw new Error("Admin client baseUrl must use http or https.");
+        }
+        if (baseUrl.username || baseUrl.password || baseUrl.search || baseUrl.hash) {
+            throw new Error("Admin client baseUrl must not include credentials, query parameters, or a fragment.");
+        }
+        if (baseUrl.protocol === "http:" && !isLoopbackHost(baseUrl.hostname)) {
+            throw new Error("Admin client requires HTTPS except for exact loopback HTTP development endpoints.");
+        }
+        this.#baseUrl = baseUrl.toString().replace(/\/+$/, "");
+        this.#basePath = normalizeBasePath(options.basePath ?? ADMIN_API_BASE_PATH);
+        this.#fetch = options.fetchFn ?? fetch;
+        this.#headers = new Headers(options.headers);
+        this.#credential = options.adminKey ?? options.apiKey;
+        if (this.#credential)
+            this.#headers.set("X-API-Key", this.#credential);
+    }
+    async call(operationId, request) {
+        const descriptor = ADMIN_OPERATIONS[operationId];
+        const path = interpolatePath(descriptor.path, request.path);
+        const url = new URL(`${this.#baseUrl}${this.#basePath}${path}`);
+        appendQuery(url, request.query);
+        const headers = new Headers(this.#headers);
+        mergeHeaders(headers, request.headers);
+        if (this.#credential)
+            headers.set("X-API-Key", this.#credential);
+        const body = encodeBody(request.body, request.contentType, headers, descriptor.requestContentTypes);
+        const response = await this.#fetch(url, {
+            method: descriptor.method,
+            headers,
+            body,
+            signal: request.signal,
+            redirect: "manual",
+        });
+        const data = await readResponse(response);
+        if (!response.ok)
+            throw new HonuaAdminApiError(operationId, response, data);
+        return { operationId, data: data, response };
+    }
+}
+function isLoopbackHost(hostname) {
+    const normalized = hostname.toLowerCase();
+    return normalized === "localhost" || normalized === "127.0.0.1" || normalized === "::1" || normalized === "[::1]";
+}
+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);
+}
+function interpolatePath(template, parameters) {
+    const used = new Set();
+    const path = template.replace(/\{([^}]+)\}/g, (_match, name) => {
+        const value = parameters?.[name];
+        if (value === undefined || value === null || value === "") {
+            throw new Error(`Missing required admin path parameter: ${name}`);
+        }
+        used.add(name);
+        return encodeURIComponent(String(value));
+    });
+    for (const name of Object.keys(parameters ?? {})) {
+        if (!used.has(name))
+            throw new Error(`Unknown admin path parameter for ${template}: ${name}`);
+    }
+    return path;
+}
+function appendQuery(url, query) {
+    for (const [name, value] of Object.entries(query ?? {})) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                url.searchParams.append(name, String(item));
+        }
+        else {
+            url.searchParams.set(name, String(value));
+        }
+    }
+}
+function mergeHeaders(target, source) {
+    if (!source)
+        return;
+    for (const [name, value] of new Headers(source))
+        target.set(name, value);
+}
+function encodeBody(value, contentType, headers, declaredContentTypes) {
+    if (value === undefined)
+        return null;
+    const selected = contentType ?? defaultRequestContentType(declaredContentTypes);
+    if (selected === "multipart/form-data")
+        return toFormData(value);
+    headers.set("Content-Type", selected);
+    if (selected.includes("json"))
+        return JSON.stringify(value);
+    if (typeof value === "string" ||
+        value instanceof Uint8Array ||
+        value instanceof Blob ||
+        value instanceof FormData ||
+        value instanceof URLSearchParams) {
+        return value;
+    }
+    return String(value);
+}
+function defaultRequestContentType(declaredContentTypes) {
+    if (declaredContentTypes.includes("application/json"))
+        return "application/json";
+    return declaredContentTypes[0] ?? "application/json";
+}
+function toFormData(value) {
+    if (value instanceof FormData)
+        return value;
+    if (typeof value !== "object" || value === null)
+        throw new Error("multipart/form-data body must be an object.");
+    const form = new FormData();
+    for (const [name, field] of Object.entries(value)) {
+        if (field === undefined || field === null)
+            continue;
+        if (Array.isArray(field)) {
+            for (const item of field)
+                form.append(name, formValue(item));
+        }
+        else {
+            form.append(name, formValue(field));
+        }
+    }
+    return form;
+}
+function formValue(value) {
+    if (value instanceof Blob)
+        return value;
+    return typeof value === "string" ? value : JSON.stringify(value);
+}
+async function readResponse(response) {
+    if (response.status === 204)
+        return undefined;
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("json"))
+        return response.json();
+    if (contentType.startsWith("text/") || contentType.includes("xml"))
+        return response.text();
+    return response.arrayBuffer();
+}

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);
@@ -33,6 +34,8 @@ export class HonuaControlPlaneClient {
         return this.requestJson("raw", request.method ?? "GET", request.path, request.body, {
             signal: request.signal,
             headers: request.headers,
+            idempotencyKey: request.idempotencyKey,
+            ifMatch: request.ifMatch,
             okStatuses: request.okStatuses,
         });
     }
@@ -46,12 +49,15 @@ 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 {
             const response = await this.#client.pipelineFetch(method, this.resolvePath(path), {
-                headers: jsonHeaders(options.headers),
+                headers: jsonHeaders(options),
                 body: body === undefined ? null : JSON.stringify(body),
             }, options.signal, options.okStatuses ? { okStatuses: options.okStatuses } : {});
             if (response.status === 204)
@@ -153,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) {
@@ -225,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) {
@@ -277,17 +389,33 @@ function withManifestQuery(path, environment, workspaceId) {
     const query = params.toString();
     return query ? `${path}?${query}` : path;
 }
-function jsonHeaders(headers) {
+/**
+ * Base JSON headers plus the concurrency/idempotency options every request
+ * option bag can carry.
+ *
+ * The option-level `idempotencyKey`/`ifMatch` are applied **after** raw
+ * `headers`, so a raw `Idempotency-Key`/`If-Match` entry cannot silently
+ * replace the value the caller passed as an option — the command layer records
+ * that value on its receipt, and a receipt that disagrees with the wire is
+ * worse than no receipt. Per-request `ifMatch` on a resource-client method is
+ * folded into `headers` by {@link withIfMatch} and still applies whenever the
+ * option-level shorthand is absent, which is every existing call site.
+ */
+function jsonHeaders(options) {
     return {
         Accept: "application/json",
         "Content-Type": "application/json",
-        ...headersToRecord(headers),
+        ...headersToRecord(options.headers),
+        ...(options.idempotencyKey ? { "Idempotency-Key": options.idempotencyKey } : {}),
+        ...(options.ifMatch ? { "If-Match": options.ifMatch } : {}),
     };
 }
 function listHeaders(options) {
     const headers = {
         Accept: "application/json",
         ...headersToRecord(options.headers),
+        ...(options.idempotencyKey ? { "Idempotency-Key": options.idempotencyKey } : {}),
+        ...(options.ifMatch ? { "If-Match": options.ifMatch } : {}),
     };
     if (options.validator?.etag)
         headers["If-None-Match"] = options.validator.etag;
@@ -317,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;