@honua/app-platform 0.2.6 → 0.2.8

package/control-plane/dataset-import/index.d.ts

@@ -1,6 +1,7 @@
 export { hashDatasetImportFile } from "./file-hash.js";
 export type { DatasetImportFileHashOptions } from "./file-hash.js";
-export type { CreateDatasetImportTask, DatasetImportArtifactSource, DatasetImportAuthorityDescriptor, DatasetImportAuthorityRenewal, DatasetImportDestination, DatasetImportSource, DatasetImportTask, DatasetImportTaskOptions, DatasetImportTaskReference, RenewDatasetImportAuthority, } from "./types.js";
+export type { CreateDatasetImportTask, DatasetImportArtifactSource, DatasetImportAuthorityDescriptor, DatasetImportAuthorityRenewal, DatasetImportBrowserFileSource, DatasetImportDestination, DatasetImportLocalProcessSource, DatasetImportServerJobArtifactReference, DatasetImportServerJobArtifactSource, DatasetImportServerJobSource, DatasetImportSource, DatasetImportTask, DatasetImportTaskOptions, DatasetImportTaskReference, RenewDatasetImportAuthority, DescribeServerJobImportSource, ListServerJobImportSources, ServerJobImportSourceChoice, ServerJobImportSourcePage, } from "./types.js";
+export { DatasetImportServerJobSourceClient } from "./server-job-source-client.js";
 export { DatasetImportTaskApiError, DatasetImportTaskClient, } from "./client.js";
 export type { DatasetImportTaskClientOptions } from "./client.js";
 export { DatasetImportUploadClient } from "./upload-client.js";

package/control-plane/dataset-import/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EACV,mCAAmC,EACnC,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,EAC/B,uCAAuC,EACvC,oCAAoC,EACpC,4BAA4B,EAC5B,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EACV,mCAAmC,EACnC,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/control-plane/dataset-import/index.js

@@ -1,4 +1,5 @@
 export { hashDatasetImportFile } from "./file-hash.js";
+export { DatasetImportServerJobSourceClient } from "./server-job-source-client.js";
 export { DatasetImportTaskApiError, DatasetImportTaskClient, } from "./client.js";
 export { DatasetImportUploadClient } from "./upload-client.js";
 export { DatasetImportSubmissionClient } from "./submission-client.js";

package/control-plane/dataset-import/server-job-source-client.d.ts

@@ -0,0 +1,16 @@
+import type { DatasetImportTaskClientOptions } from "./client.js";
+import type { DatasetImportServerJobSource, DescribeServerJobImportSource, ListServerJobImportSources, ServerJobImportSourcePage } from "./types.js";
+/**
+ * Optional preview Server-job source APIs. Requires an installed Server that
+ * advertises these capabilities. Discovery is metadata-only; describe verifies
+ * the original output without returning its bytes or storage location. Server
+ * authorization remains authoritative on every observation and transfer.
+ */
+export declare class DatasetImportServerJobSourceClient {
+    private readonly transport;
+    private readonly targetId;
+    constructor(options: DatasetImportTaskClientOptions);
+    list(request: ListServerJobImportSources, signal?: AbortSignal): Promise<ServerJobImportSourcePage | null>;
+    describe(request: DescribeServerJobImportSource, signal?: AbortSignal): Promise<DatasetImportServerJobSource | null>;
+}
+//# sourceMappingURL=server-job-source-client.d.ts.map

package/control-plane/dataset-import/server-job-source-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-job-source-client.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/server-job-source-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,qBAAa,kCAAkC;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,8BAA8B;IAK7C,IAAI,CAAC,OAAO,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IA2D1G,QAAQ,CACZ,OAAO,EAAE,6BAA6B,EACtC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;CA4DhD"}

package/control-plane/dataset-import/server-job-source-client.js

@@ -0,0 +1,143 @@
+import { DatasetImportWorkspaceTransport, validId } from "./transport.js";
+/**
+ * Optional preview Server-job source APIs. Requires an installed Server that
+ * advertises these capabilities. Discovery is metadata-only; describe verifies
+ * the original output without returning its bytes or storage location. Server
+ * authorization remains authoritative on every observation and transfer.
+ */
+export class DatasetImportServerJobSourceClient {
+    transport;
+    targetId;
+    constructor(options) {
+        this.transport = new DatasetImportWorkspaceTransport(options);
+        this.targetId = options.targetId;
+    }
+    async list(request, signal) {
+        const { jobId, offset = 0, resultPackageId = null } = request;
+        validId(jobId);
+        if (!Number.isSafeInteger(offset) || offset < 0 || (offset > 0 && resultPackageId === null))
+            throw new TypeError("Continuation requires a nonnegative offset and the original result package.");
+        if (resultPackageId !== null)
+            validPackage(jobId, resultPackageId);
+        const value = await this.transport.request("/dataset-import-sources/server-job-artifacts", "POST", JSON.stringify({ jobId, offset, resultPackageId }), signal, true);
+        if (value === null)
+            return null;
+        if (value.targetId !== this.targetId || value.jobId !== jobId)
+            throw new Error("The job source page changed deployment or job identity.");
+        validPackage(jobId, value.resultPackageId);
+        if (resultPackageId !== null && value.resultPackageId !== resultPackageId)
+            throw new Error("The job source page changed the original result version.");
+        // AgentWorkspaceJsonContext omits null members on the wire.
+        const nextOffset = value.nextOffset ?? null;
+        if (!Number.isSafeInteger(value.totalArtifacts) ||
+            value.totalArtifacts < offset ||
+            !Array.isArray(value.artifacts) ||
+            value.artifacts.length !== Math.min(50, value.totalArtifacts - offset) ||
+            nextOffset !== (offset + value.artifacts.length < value.totalArtifacts ? offset + value.artifacts.length : null))
+            throw new Error("The job source page has an inconsistent bounded continuation.");
+        const artifacts = value.artifacts.map((choice, index) => {
+            if (!choice ||
+                choice.artifactId !== `${jobId}:artifact:${offset + index + 1}` ||
+                typeof choice.kind !== "string" ||
+                !/^[A-Za-z][A-Za-z0-9]{0,63}$/.test(choice.kind) ||
+                typeof choice.label !== "string" ||
+                !/^[A-Za-z0-9 _.\-]{1,128}$/.test(choice.label) ||
+                typeof choice.canDescribeForImport !== "boolean")
+                throw new Error("The job source page contains an invalid artifact identity or metadata.");
+            return {
+                artifactId: choice.artifactId,
+                kind: choice.kind,
+                label: choice.label,
+                canDescribeForImport: choice.canDescribeForImport,
+            };
+        });
+        // Project only the supported metadata: never propagate unexpected bulk or
+        // storage-location members to an agent through a loosely typed JSON object.
+        return {
+            targetId: value.targetId,
+            jobId,
+            resultPackageId: value.resultPackageId,
+            artifacts,
+            totalArtifacts: value.totalArtifacts,
+            nextOffset,
+        };
+    }
+    async describe(request, signal) {
+        const { jobId, resultPackageId, artifactId } = request;
+        validId(jobId);
+        validPackage(jobId, resultPackageId);
+        validArtifact(jobId, artifactId);
+        const source = await this.transport.request("/dataset-import-sources/server-job-artifact", "POST", JSON.stringify({ jobId, resultPackageId, artifactId }), signal, true);
+        if (source === null)
+            return null;
+        const output = source.serverJobArtifact;
+        const reference = output?.reference;
+        if (source.kind !== "server-job-artifact" ||
+            source.fileName !== "job-artifact.geojson" ||
+            !positiveInteger(source.totalBytes) ||
+            !digest(source.expectedSha256) ||
+            source.artifact != null ||
+            source.browserSelectionId != null ||
+            !reference ||
+            reference.targetId !== this.targetId ||
+            reference.jobId !== jobId ||
+            reference.resultPackageId !== resultPackageId ||
+            reference.artifactId !== artifactId ||
+            !digest(reference.referenceSha256) ||
+            !positiveInteger(output.featureCount) ||
+            (output.crsState === "known"
+                ? !positiveInteger(output.sourceSrid) || output.sourceSrid > 2147483647
+                : output.crsState !== "unknown" || output.sourceSrid != null))
+            throw new Error("The job source description changed its original identity or content/coordinate contract.");
+        if (!principalText(output.producerActorId, 2048) ||
+            (output.producerTenantId != null && !principalText(output.producerTenantId, 512, true)))
+            throw new Error("The job source producer identity is outside the Server contract.");
+        return {
+            kind: "server-job-artifact",
+            fileName: source.fileName,
+            totalBytes: source.totalBytes,
+            expectedSha256: source.expectedSha256,
+            serverJobArtifact: {
+                reference: {
+                    targetId: this.targetId,
+                    jobId,
+                    resultPackageId,
+                    artifactId,
+                    referenceSha256: reference.referenceSha256,
+                },
+                producerActorId: output.producerActorId,
+                producerTenantId: output.producerTenantId ?? null,
+                crsState: output.crsState,
+                sourceSrid: output.sourceSrid ?? null,
+                featureCount: output.featureCount,
+            },
+        };
+    }
+}
+function validPackage(jobId, value) {
+    validId(value);
+    if (!value.startsWith(`${jobId}:v`) || !/^[1-9][0-9]*$/.test(value.slice(jobId.length + 2)))
+        throw new TypeError("The original versioned job result package is required.");
+}
+function validArtifact(jobId, value) {
+    validId(value);
+    const prefix = `${jobId}:artifact:`;
+    if (!value.startsWith(prefix) || !/^[1-9][0-9]*$/.test(value.slice(prefix.length)))
+        throw new TypeError("The original job artifact identity is required.");
+}
+function positiveInteger(value) {
+    return Number.isSafeInteger(value) && value > 0;
+}
+function digest(value) {
+    return typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
+}
+// Principal identifiers have different Server bounds from workspace/job IDs.
+function principalText(value, maximum, allowEmpty = false) {
+    return (typeof value === "string" &&
+        (allowEmpty || value.length > 0) &&
+        value.length <= maximum &&
+        Array.from(value).every((character) => {
+            const code = character.charCodeAt(0);
+            return code > 31 && (code < 127 || code > 159);
+        }));
+}

package/control-plane/dataset-import/types.d.ts

@@ -10,14 +10,75 @@ export interface DatasetImportArtifactSource {
     readonly runId: string;
     readonly path: string;
 }
-export interface DatasetImportSource {
-    readonly kind: "browser-file" | "local-process-artifact";
+interface DatasetImportSourceMetadata {
     readonly fileName: string;
     readonly totalBytes: number;
     readonly expectedSha256?: string | null;
-    readonly artifact?: DatasetImportArtifactSource | null;
+}
+export interface DatasetImportBrowserFileSource extends DatasetImportSourceMetadata {
+    readonly kind: "browser-file";
     /** Original human file selection captured by the immutable originating turn. */
     readonly browserSelectionId?: string | null;
+    readonly artifact?: null;
+    readonly serverJobArtifact?: null;
+}
+export interface DatasetImportLocalProcessSource extends DatasetImportSourceMetadata {
+    readonly kind: "local-process-artifact";
+    readonly artifact: DatasetImportArtifactSource;
+    readonly browserSelectionId?: null;
+    readonly serverJobArtifact?: null;
+}
+/** Each source kind carries its own canonical reference rather than optional mixed identities. */
+export type DatasetImportSource = DatasetImportBrowserFileSource | DatasetImportLocalProcessSource | DatasetImportServerJobSource;
+/** Exact Server-owned result identity; no caller-supplied location or bulk content. */
+export interface DatasetImportServerJobArtifactReference {
+    readonly targetId: string;
+    readonly jobId: string;
+    readonly resultPackageId: string;
+    readonly artifactId: string;
+    readonly referenceSha256: string;
+}
+/** Server recomputes this description at task creation; it is not execution authority. */
+export interface DatasetImportServerJobArtifactSource {
+    readonly reference: DatasetImportServerJobArtifactReference;
+    readonly producerActorId: string;
+    readonly producerTenantId: string | null;
+    readonly crsState: "known" | "unknown";
+    readonly sourceSrid: number | null;
+    readonly featureCount: number;
+}
+export interface DatasetImportServerJobSource extends DatasetImportSourceMetadata {
+    readonly kind: "server-job-artifact";
+    readonly expectedSha256: string;
+    readonly serverJobArtifact: DatasetImportServerJobArtifactSource;
+    readonly artifact?: null;
+    readonly browserSelectionId?: null;
+}
+export interface ListServerJobImportSources {
+    readonly jobId: string;
+    readonly offset?: number;
+    /** Required for continuation, preserving the exact original result version. */
+    readonly resultPackageId?: string | null;
+}
+export interface DescribeServerJobImportSource {
+    readonly jobId: string;
+    readonly resultPackageId: string;
+    readonly artifactId: string;
+}
+export interface ServerJobImportSourceChoice {
+    readonly artifactId: string;
+    readonly kind: string;
+    readonly label: string;
+    /** Envelope eligibility only; describe still verifies content, CRS and current access. */
+    readonly canDescribeForImport: boolean;
+}
+export interface ServerJobImportSourcePage {
+    readonly targetId: string;
+    readonly jobId: string;
+    readonly resultPackageId: string;
+    readonly artifacts: readonly ServerJobImportSourceChoice[];
+    readonly totalArtifacts: number;
+    readonly nextOffset: number | null;
 }
 export interface DatasetImportTaskOptions {
     /** Current new-table slice supports Append (1); occupied destinations remain unsupported. */
@@ -147,4 +208,5 @@ export interface DatasetImportSubmissionReceipt {
     readonly acceptBefore?: string | null;
     readonly job?: DatasetImportJobReceipt | null;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/control-plane/dataset-import/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/types.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD,UAAU,2BAA2B;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,8BAA+B,SAAQ,2BAA2B;IACjF,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,+BAAgC,SAAQ,2BAA2B;IAClF,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;CACnC;AAED,kGAAkG;AAClG,MAAM,MAAM,mBAAmB,GAC3B,8BAA8B,GAC9B,+BAA+B,GAC/B,4BAA4B,CAAC;AAEjC,uFAAuF;AACvF,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,0FAA0F;AAC1F,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,uCAAuC,CAAC;IAC5D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA6B,SAAQ,2BAA2B;IAC/E,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AACD,MAAM,WAAW,wBAAwB;IACvC,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AACD,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;CAC5C;AACD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AACD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AACD,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AACD,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AACD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,uFAAuF;AACvF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AACD,kFAAkF;AAClF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,mCAAmC,GAAG,IAAI,CAAC;CACvE;AACD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;CAC7C;AAED,0GAA0G;AAC1G,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;CAC3C;AACD,kGAAkG;AAClG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AACD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC9F,kGAAkG;IAClG,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AACD,8FAA8F;AAC9F,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,GAAG,UAAU,CAAC;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC/C"}

package/control-plane/dataset-import/upload-client.d.ts

@@ -14,6 +14,13 @@ export declare class DatasetImportUploadClient {
     /** Read-only recovery of a known session, preserving its immutable fields and terminal receipts. */
     reconcile(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, signal?: AbortSignal): Promise<DatasetImportUploadReceipt | null>;
     create(reference: DatasetImportTaskReference, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
+    /**
+     * Transfer the original task's Server-owned job output through the canonical
+     * upload coordinator and retain it. This does not submit an import. A lost
+     * reply remains unknown: recover with read/reconcile before explicitly resuming
+     * this same task. Never create a replacement task or automatically retry.
+     */
+    transferServerJobArtifact(reference: DatasetImportTaskReference, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
     appendChunk(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, chunk: Blob, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
     seal(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
     retainSource(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;

package/control-plane/dataset-import/upload-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-client.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/upload-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAKpB;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;gBAChD,OAAO,EAAE,8BAA8B;IAI7C,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAqB5C,IAAI,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAanH,oGAAoG;IAC9F,SAAS,CACb,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAcvC,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQxG,WAAW,CACf,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,KAAK,EAAE,IAAI,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAqBhC,IAAI,CACR,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,MAAM,CACV,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;YAaxB,MAAM;CAmBrB"}
+{"version":3,"file":"upload-client.d.ts","sourceRoot":"","sources":["../../../../src/control-plane/dataset-import/upload-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAKpB;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;gBAChD,OAAO,EAAE,8BAA8B;IAI7C,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAqB5C,IAAI,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAanH,oGAAoG;IAC9F,SAAS,CACb,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAcvC,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQ9G;;;;;OAKG;IACG,yBAAyB,CAC7B,SAAS,EAAE,0BAA0B,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAchC,WAAW,CACf,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,KAAK,EAAE,IAAI,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAqBhC,IAAI,CACR,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,YAAY,CAChB,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAGhC,MAAM,CACV,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC;YAaxB,MAAM;CAmBrB"}

package/control-plane/dataset-import/upload-client.js

@@ -48,6 +48,20 @@ export class DatasetImportUploadClient {
         validate(value, pinned);
         return value;
     }
+    /**
+     * Transfer the original task's Server-owned job output through the canonical
+     * upload coordinator and retain it. This does not submit an import. A lost
+     * reply remains unknown: recover with read/reconcile before explicitly resuming
+     * this same task. Never create a replacement task or automatically retry.
+     */
+    async transferServerJobArtifact(reference, signal) {
+        const pinned = pin(reference);
+        const value = await this.transport.request(`${path(pinned)}/server-job-artifact`, "POST", JSON.stringify({ taskContentHash: pinned.contentHash }), signal);
+        validate(value, pinned);
+        if (value.state !== "sealed" || value.sourceRetention == null)
+            throw new Error("The Server job transfer did not return a sealed retained source receipt.");
+        return value;
+    }
     async appendChunk(reference, original, chunk, signal) {
         const pinned = pin(reference);
         const session = captureSession(original, pinned);

package/map/feature-service-adapter.d.ts

@@ -23,7 +23,7 @@
  * @module
  */
 import type { HonuaClient } from "../core/client.js";
-import type { EsriGeometryType } from "../core/types.js";
+import type { EsriGeometryType, HonuaLayerMetadata } from "../core/types.js";
 import type { HonuaMap } from "./honua-map.js";
 /** A GeoJSON geometry produced by the adapter. */
 export interface AdapterGeoJsonGeometry {
@@ -81,7 +81,7 @@ export interface FeatureServiceAdapterMap {
  * multipoint, polyline, polygon, envelope). Returns `null` when the geometry is
  * absent or unrecognised so the feature still renders attribute-only.
  */
-export declare function esriGeometryToGeoJson(geometry: Record<string, unknown> | null | undefined, geometryType: EsriGeometryType | undefined): AdapterGeoJsonGeometry | null;
+export declare function esriGeometryToGeoJson(geometry: Record<string, unknown> | null | undefined, geometryType: EsriGeometryType | undefined, dimensions?: Pick<HonuaLayerMetadata, "hasZ" | "hasM">): AdapterGeoJsonGeometry | null;
 /**
  * Convert an array of Esri features (attributes + geometry) into a GeoJSON
  * `FeatureCollection`.
@@ -89,7 +89,7 @@ export declare function esriGeometryToGeoJson(geometry: Record<string, unknown>
 export declare function esriFeaturesToGeoJson(features: ReadonlyArray<{
     attributes?: Record<string, unknown>;
     geometry?: Record<string, unknown> | null;
-}>, geometryType: EsriGeometryType | undefined): AdapterGeoJsonFeatureCollection;
+}>, geometryType: EsriGeometryType | undefined, dimensions?: Pick<HonuaLayerMetadata, "hasZ" | "hasM">): AdapterGeoJsonFeatureCollection;
 /**
  * Fetch a Honua feature-service layer through the SDK and return a standard
  * MapLibre `geojson` source specification that the renderer renders natively.

package/map/feature-service-adapter.d.ts.map

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

package/map/feature-service-adapter.js

@@ -22,8 +22,46 @@
  *
  * @module
  */
+import { esriGeometryToGeoJSON } from "../core/esri-geojson.js";
 import { HonuaFeatureLayer } from "../core/surfaces.js";
 import { parseFeatureLayerUrl } from "../esri-compat/url.js";
+/** Validate an unambiguous shape when the service cannot declare its geometry type. */
+function isValidGenericGeometry(geometry) {
+    const shapes = [
+        "x" in geometry || "y" in geometry,
+        "points" in geometry,
+        "paths" in geometry,
+        "rings" in geometry,
+        ["xmin", "ymin", "xmax", "ymax"].some((key) => key in geometry),
+    ];
+    if (shapes.filter(Boolean).length !== 1)
+        return false;
+    if (shapes[0])
+        return asFiniteNumber(geometry.x) !== undefined && asFiniteNumber(geometry.y) !== undefined;
+    if (shapes[1])
+        return (Array.isArray(geometry.points) &&
+            geometry.points.length > 0 &&
+            geometry.points.every((point) => asPosition(point) !== undefined));
+    if (shapes[2] || shapes[3]) {
+        const parts = shapes[2] ? geometry.paths : geometry.rings;
+        const polygon = shapes[3];
+        return (Array.isArray(parts) &&
+            parts.length > 0 &&
+            parts.every((part) => {
+                if (!Array.isArray(part) ||
+                    part.length < (polygon ? 4 : 2) ||
+                    !part.every((point) => asPosition(point) !== undefined))
+                    return false;
+                if (!polygon)
+                    return true;
+                const first = asPosition(part[0]);
+                const last = asPosition(part[part.length - 1]);
+                return first[0] === last[0] && first[1] === last[1];
+            }));
+    }
+    const bounds = [geometry.xmin, geometry.ymin, geometry.xmax, geometry.ymax].map(asFiniteNumber);
+    return bounds.every((value) => value !== undefined) && bounds[0] <= bounds[2] && bounds[1] <= bounds[3];
+}
 /**
  * Convert a single Esri geometry into a GeoJSON geometry.
  *
@@ -31,75 +69,68 @@ import { parseFeatureLayerUrl } from "../esri-compat/url.js";
  * multipoint, polyline, polygon, envelope). Returns `null` when the geometry is
  * absent or unrecognised so the feature still renders attribute-only.
  */
-export function esriGeometryToGeoJson(geometry, geometryType) {
-    if (!geometry) {
+export function esriGeometryToGeoJson(geometry, geometryType, dimensions) {
+    if (!geometry || typeof geometry !== "object" || Array.isArray(geometry))
         return null;
+    let shape;
+    if (geometryType === undefined || geometryType === null || geometryType === "esriGeometryNull") {
+        shape = geometry;
     }
-    // Point geometries are recognisable structurally even without a declared
-    // type (queries that elide geometryType still return {x, y}).
-    if (geometryType === "esriGeometryPoint" || (geometry.x !== undefined && geometry.y !== undefined)) {
-        const x = asFiniteNumber(geometry.x);
-        const y = asFiniteNumber(geometry.y);
-        if (x === undefined || y === undefined)
-            return null;
-        return { type: "Point", coordinates: [x, y] };
+    else if (geometryType === "esriGeometryPoint" || (geometry.x !== undefined && geometry.y !== undefined)) {
+        shape = { x: geometry.x, y: geometry.y, z: geometry.z };
     }
-    if (geometryType === "esriGeometryMultipoint") {
-        const points = asArray(geometry.points)
-            .map(asCoordinatePair)
-            .filter((value) => value !== undefined);
-        return { type: "MultiPoint", coordinates: points };
+    else if (geometryType === "esriGeometryMultipoint") {
+        shape = { points: geometry.points };
     }
-    if (geometryType === "esriGeometryPolyline") {
-        const paths = asArray(geometry.paths)
-            .map(asCoordinateArray)
-            .filter((path) => path.length > 0);
-        if (paths.length === 1) {
-            return { type: "LineString", coordinates: paths[0] };
-        }
-        return { type: "MultiLineString", coordinates: paths };
+    else if (geometryType === "esriGeometryPolyline") {
+        shape = { paths: geometry.paths };
+    }
+    else if (geometryType === "esriGeometryPolygon") {
+        shape = { rings: geometry.rings };
     }
-    if (geometryType === "esriGeometryPolygon") {
-        const rings = asArray(geometry.rings)
-            .map(asCoordinateArray)
-            .filter((ring) => ring.length > 0);
-        // MapLibre does not enforce GeoJSON ring winding for rendering, so the
-        // adapter passes Esri rings through as a Polygon without re-nesting.
-        return { type: "Polygon", coordinates: rings };
+    else if (geometryType === "esriGeometryEnvelope") {
+        shape = { xmin: geometry.xmin, ymin: geometry.ymin, xmax: geometry.xmax, ymax: geometry.ymax };
     }
-    if (geometryType === "esriGeometryEnvelope") {
-        const xmin = asFiniteNumber(geometry.xmin);
-        const ymin = asFiniteNumber(geometry.ymin);
-        const xmax = asFiniteNumber(geometry.xmax);
-        const ymax = asFiniteNumber(geometry.ymax);
-        if (xmin === undefined || ymin === undefined || xmax === undefined || ymax === undefined) {
-            return null;
+    else
+        return null;
+    // One converter owns exterior/hole grouping, winding and coordinate ordinates
+    // for both metadata-declared and structurally inferred feature geometry.
+    if (!isValidGenericGeometry(shape))
+        return null;
+    // Optional Esri Z/M can be null. Keep finite spatial coordinates, omit
+    // absent Z, and never treat a measure as GeoJSON altitude.
+    const converted = esriGeometryToGeoJSON({ ...shape, z: asFiniteNumber(shape.z) });
+    if (!converted || !("coordinates" in converted))
+        return null;
+    const hasZ = asFiniteNumber(shape.z) !== undefined || (geometry.hasZ ?? dimensions?.hasZ) === true;
+    const coordinates = projectCoordinates(converted.coordinates, hasZ);
+    const polygons = converted.type === "Polygon"
+        ? [coordinates]
+        : converted.type === "MultiPolygon"
+            ? coordinates
+            : [];
+    for (const polygon of polygons) {
+        for (const ring of polygon) {
+            const first = ring[0];
+            const last = ring[ring.length - 1];
+            // Close after dimension projection, comparing every retained ordinate.
+            // Append the first position so a distinct final Z is not discarded.
+            if (first && last && (first.length !== last.length || first.some((value, index) => value !== last[index])))
+                ring.push([...first]);
         }
-        return {
-            type: "Polygon",
-            coordinates: [
-                [
-                    [xmin, ymin],
-                    [xmax, ymin],
-                    [xmax, ymax],
-                    [xmin, ymax],
-                    [xmin, ymin],
-                ],
-            ],
-        };
     }
-    return null;
+    return { type: converted.type, coordinates };
 }
 /**
  * Convert an array of Esri features (attributes + geometry) into a GeoJSON
  * `FeatureCollection`.
  */
-export function esriFeaturesToGeoJson(features, geometryType) {
+export function esriFeaturesToGeoJson(features, geometryType, dimensions) {
     return {
         type: "FeatureCollection",
         features: features.map((feature) => ({
             type: "Feature",
-            geometry: esriGeometryToGeoJson(feature.geometry ?? null, geometryType),
+            geometry: esriGeometryToGeoJson(feature.geometry ?? null, geometryType, dimensions),
             properties: { ...(feature.attributes ?? {}) },
         })),
     };
@@ -136,8 +167,8 @@ export async function loadHonuaFeatureServiceGeoJson(client, url, options = {})
     };
     const metadataPromise = layer.metadata(options.signal ? { signal: options.signal } : {}).catch(() => undefined);
     const features = await layer.queryFeaturesAll(request);
-    const geometryType = (await metadataPromise)?.geometryType;
-    const data = esriFeaturesToGeoJson(features, geometryType);
+    const metadata = await metadataPromise;
+    const data = esriFeaturesToGeoJson(features, metadata?.geometryType, metadata);
     return {
         type: "geojson",
         data,
@@ -260,20 +291,19 @@ async function allSettledLimited(values, concurrency, worker) {
 function asFiniteNumber(value) {
     return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
-function asArray(value) {
-    return Array.isArray(value) ? value : [];
-}
-function asCoordinatePair(value) {
-    if (!Array.isArray(value) || value.length < 2)
-        return undefined;
-    const x = asFiniteNumber(value[0]);
-    const y = asFiniteNumber(value[1]);
-    if (x === undefined || y === undefined)
-        return undefined;
-    return [x, y];
+function asPosition(value) {
+    return Array.isArray(value) &&
+        value.length >= 2 &&
+        asFiniteNumber(value[0]) !== undefined &&
+        asFiniteNumber(value[1]) !== undefined
+        ? value
+        : undefined;
 }
-function asCoordinateArray(value) {
-    return asArray(value)
-        .map(asCoordinatePair)
-        .filter((pair) => pair !== undefined);
+/** GeoJSON has spatial coordinates, not Esri measures; absent optional Z stays 2D. */
+function projectCoordinates(coordinates, hasZ) {
+    if (!Array.isArray(coordinates))
+        return coordinates;
+    if (Array.isArray(coordinates[0]))
+        return coordinates.map((part) => projectCoordinates(part, hasZ));
+    return coordinates.slice(0, hasZ && asFiniteNumber(coordinates[2]) !== undefined ? 3 : 2);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honua/app-platform",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Honua application-platform surfaces: app-shell, workspace, scene, operator, studio, and hosted-product clients",
   "keywords": [
     "gis",
@@ -121,7 +121,7 @@
     "proj4": "^2.20.9"
   },
   "peerDependencies": {
-    "@honua/sdk": "0.2.6",
+    "@honua/sdk": "0.2.8",
     "@bufbuild/protobuf": "^2.0.0",
     "@connectrpc/connect": "^2.0.0",
     "@connectrpc/connect-web": "^2.0.0",