@honua/app-platform 0.2.2 → 0.2.4

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

@@ -0,0 +1,150 @@
+/** Experimental canonical dataset-import task contract; transfer admission is separate. */
+export interface DatasetImportDestination {
+    readonly schema: string;
+    readonly table: string;
+}
+export interface DatasetImportArtifactSource {
+    readonly projectId: string;
+    readonly snapshotId: string;
+    readonly snapshotDigest: string;
+    readonly runId: string;
+    readonly path: string;
+}
+export interface DatasetImportSource {
+    readonly kind: "browser-file" | "local-process-artifact";
+    readonly fileName: string;
+    readonly totalBytes: number;
+    readonly expectedSha256?: string | null;
+    readonly artifact?: DatasetImportArtifactSource | null;
+    /** Original human file selection captured by the immutable originating turn. */
+    readonly browserSelectionId?: string | null;
+}
+export interface DatasetImportTaskOptions {
+    /** Current new-table slice supports Append (1); occupied destinations remain unsupported. */
+    readonly loadMode: 1;
+    readonly targetSrid: number;
+    readonly sourceSrid?: number | null;
+}
+export interface CreateDatasetImportTask {
+    /** Persist before POST; a lost reply is recovered by this original intent ID. */
+    readonly intentId: string;
+    readonly viewId: string;
+    readonly contextRevision: number;
+    readonly destination: DatasetImportDestination;
+    readonly source: DatasetImportSource;
+    readonly options: DatasetImportTaskOptions;
+}
+export interface DatasetImportTask {
+    readonly taskId: string;
+    readonly revision: number;
+    readonly contentHash: string;
+    readonly ownerActorId: string;
+    readonly tenantId?: string | null;
+    readonly targetId: string;
+    readonly workspaceId: string;
+    readonly destination: DatasetImportDestination;
+    readonly source: DatasetImportSource;
+    readonly options: DatasetImportTaskOptions;
+    readonly uploadAdmissionDeadline: string;
+}
+export interface DatasetImportTaskReference {
+    readonly taskId: string;
+    readonly revision: number;
+    readonly contentHash: string;
+}
+export interface DatasetImportAuthorityDescriptor {
+    readonly taskId: string;
+    readonly taskRevision: number;
+    readonly taskContentHash: string;
+    readonly executorActorId: string;
+    readonly initiatingHumanActorId?: string | null;
+    readonly originatingTurnId: string;
+    readonly originalTurnHash: string;
+    readonly authorityRevision: number;
+    readonly authorityFingerprint: string;
+    readonly policyContextFingerprint: string;
+    readonly uploadAdmissionDeadline: string;
+    /** Preparation is not an accepted job receipt. */
+    readonly preparedOperationId?: string | null;
+}
+export interface RenewDatasetImportAuthority {
+    /** Persist before POST. Reuse it to recover the original renewal receipt. */
+    readonly renewalId: string;
+    readonly expectedAuthorityRevision: number;
+    readonly taskContentHash: string;
+}
+export interface DatasetImportAuthorityRenewal {
+    readonly renewalId: string;
+    readonly previousAuthorityRevision: number;
+    readonly authorityRevision: number;
+    readonly authorityFingerprint: string;
+    readonly renewedAt: string;
+}
+/** Describes a retained receipt; it does not prove the storage object still exists. */
+export interface DatasetImportSourceRetentionReceipt {
+    readonly bytes: number;
+    readonly sha256: string;
+    readonly expiresAt?: string | null;
+}
+/** Task-bound transfer receipt. Sealing/retaining never accepts an import job. */
+export interface DatasetImportUploadReceipt {
+    readonly taskId: string;
+    readonly taskRevision: number;
+    readonly taskContentHash: string;
+    readonly uploadId: string;
+    readonly version: number;
+    readonly state: "receiving" | "sealed" | "cancelled";
+    readonly acceptedBytes: number;
+    readonly totalBytes: number;
+    readonly chunkBytes: number;
+    readonly chunkCount: number;
+    readonly expiresAt: string;
+    readonly contentSha256?: string | null;
+    readonly sourceRetention?: DatasetImportSourceRetentionReceipt | null;
+}
+export interface DatasetImportUploadCapabilities {
+    readonly chunkBytes: number;
+    readonly maximumFileBytes: number;
+    readonly importAcceptanceSupported: boolean;
+}
+/** Current authority tuple explicitly reviewed before human preparation or actual executor submission. */
+export interface SubmitDatasetImport {
+    readonly taskContentHash: string;
+    readonly authorityRevision: number;
+    readonly authorityFingerprint: string;
+    readonly policyContextFingerprint: string;
+}
+/** Actual persisted successful provider output, never inferred from the requested destination. */
+export interface DatasetImportOutputReceipt {
+    readonly physicalTableName: string;
+    readonly schema: string;
+    readonly featureCount: number;
+    readonly detectedSrid?: number | null;
+}
+export interface DatasetImportJobReceipt {
+    readonly jobId: string;
+    readonly leaseId: string;
+    readonly status: "queued" | "provisioning" | "running" | "succeeded" | "failed" | "cancelled";
+    /** The accepted operation is checking a durable commit decision; never permission to resubmit. */
+    readonly outcomePending?: boolean;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly completedAt?: string | null;
+    readonly percentComplete?: number | null;
+    readonly output?: DatasetImportOutputReceipt | null;
+    readonly errorCode?: string | null;
+}
+/** Preparation awaits the actual agent; only accepted contains a real durable job receipt. */
+export interface DatasetImportSubmissionReceipt {
+    readonly taskId: string;
+    readonly taskRevision: number;
+    readonly taskContentHash: string;
+    readonly state: "not-prepared" | "prepared" | "accepted";
+    readonly operationId?: string | null;
+    readonly authorityRevision?: number | null;
+    readonly authorityFingerprint?: string | null;
+    readonly policyContextFingerprint?: string | null;
+    readonly acceptBefore?: string | null;
+    readonly job?: DatasetImportJobReceipt | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,23 @@
+import type { DatasetImportTaskClientOptions } from "./client.js";
+import type { DatasetImportTaskReference, DatasetImportUploadCapabilities, DatasetImportUploadReceipt } from "./types.js";
+/**
+ * Canonical transfer primitives. No import submission or automatic mutation retry.
+ * Persist the original immutable task reference before create; recover uncertain
+ * create/chunk/seal/source outcomes using read against that SAME task. Always
+ * verify the complete reselected file SHA-256 before sending any resumed chunk.
+ */
+export declare class DatasetImportUploadClient {
+    private readonly transport;
+    constructor(options: DatasetImportTaskClientOptions);
+    capabilities(reference: DatasetImportTaskReference, signal?: AbortSignal): Promise<DatasetImportUploadCapabilities | null>;
+    read(reference: DatasetImportTaskReference, signal?: AbortSignal): Promise<DatasetImportUploadReceipt | null>;
+    /** 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>;
+    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>;
+    cancel(reference: DatasetImportTaskReference, original: DatasetImportUploadReceipt, signal?: AbortSignal): Promise<DatasetImportUploadReceipt>;
+    private mutate;
+}
+//# sourceMappingURL=upload-client.d.ts.map

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

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

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

@@ -0,0 +1,187 @@
+import { hashDatasetImportFile } from "./file-hash.js";
+import { DatasetImportWorkspaceTransport, validId } from "./transport.js";
+const maximumChunkBytes = 4 * 1024 * 1024;
+const maximumChunks = 65536;
+/**
+ * Canonical transfer primitives. No import submission or automatic mutation retry.
+ * Persist the original immutable task reference before create; recover uncertain
+ * create/chunk/seal/source outcomes using read against that SAME task. Always
+ * verify the complete reselected file SHA-256 before sending any resumed chunk.
+ */
+export class DatasetImportUploadClient {
+    transport;
+    constructor(options) {
+        this.transport = new DatasetImportWorkspaceTransport(options);
+    }
+    async capabilities(reference, signal) {
+        const pinned = pin(reference);
+        const value = await this.transport.request(`${path(pinned)}/capabilities?contentHash=${pinned.contentHash}`, "GET", undefined, signal, true);
+        if (value !== null &&
+            (!validChunkBytes(value.chunkBytes) ||
+                !Number.isSafeInteger(value.maximumFileBytes) ||
+                value.maximumFileBytes < 1 ||
+                value.maximumFileBytes > value.chunkBytes * maximumChunks ||
+                typeof value.importAcceptanceSupported !== "boolean"))
+            throw new Error("The host returned an unsupported transfer capability contract.");
+        return value;
+    }
+    async read(reference, signal) {
+        const pinned = pin(reference);
+        const value = await this.transport.request(`${path(pinned)}?contentHash=${pinned.contentHash}`, "GET", undefined, signal, true);
+        if (value !== null)
+            validate(value, pinned);
+        return value;
+    }
+    /** Read-only recovery of a known session, preserving its immutable fields and terminal receipts. */
+    async reconcile(reference, original, signal) {
+        const pinned = pin(reference);
+        const session = captureSession(original, pinned);
+        const value = await this.transport.request(`${path(pinned)}?contentHash=${pinned.contentHash}`, "GET", undefined, signal, true);
+        if (value !== null)
+            validate(value, pinned, session);
+        return value;
+    }
+    async create(reference, signal) {
+        const pinned = pin(reference);
+        const body = JSON.stringify({ taskContentHash: pinned.contentHash });
+        const value = await this.transport.request(path(pinned), "POST", body, signal);
+        validate(value, pinned);
+        return value;
+    }
+    async appendChunk(reference, original, chunk, signal) {
+        const pinned = pin(reference);
+        const session = captureSession(original, pinned);
+        // Snapshot every mutable receipt field before hashing or authentication awaits.
+        const { version, acceptedBytes, totalBytes, chunkBytes, state } = session;
+        const expectedBytes = Math.min(chunkBytes, totalBytes - acceptedBytes);
+        if (state !== "receiving" || expectedBytes < 1 || chunk.size !== expectedBytes)
+            throw new TypeError("Exactly one original next chunk is required.");
+        const sha256 = await hashDatasetImportFile(chunk, { signal });
+        const value = await this.transport.request(`${path(pinned)}/chunks?contentHash=${pinned.contentHash}&expectedVersion=${version}&offset=${acceptedBytes}&sha256=${sha256}`, "PUT", chunk, signal, false, "application/octet-stream");
+        validate(value, pinned, session);
+        return value;
+    }
+    async seal(reference, original, signal) {
+        return await this.mutate(reference, original, "/seal", signal);
+    }
+    async retainSource(reference, original, signal) {
+        return await this.mutate(reference, original, "/source", signal);
+    }
+    async cancel(reference, original, signal) {
+        const pinned = pin(reference);
+        const session = captureSession(original, pinned);
+        const { version } = session;
+        const value = await this.transport.request(`${path(pinned)}?contentHash=${pinned.contentHash}&expectedVersion=${version}`, "DELETE", undefined, signal);
+        validate(value, pinned, session);
+        return value;
+    }
+    async mutate(reference, original, action, signal) {
+        const pinned = pin(reference);
+        const session = captureSession(original, pinned);
+        const { version } = session;
+        const body = JSON.stringify({ taskContentHash: pinned.contentHash, expectedVersion: version });
+        const value = await this.transport.request(`${path(pinned)}${action}`, "POST", body, signal);
+        validate(value, pinned, session);
+        return value;
+    }
+}
+function pin(reference) {
+    validId(reference.taskId);
+    if (!Number.isSafeInteger(reference.revision) || reference.revision < 1 || !digest(reference.contentHash))
+        throw new TypeError("An exact immutable task reference is required.");
+    return { taskId: reference.taskId, revision: reference.revision, contentHash: reference.contentHash };
+}
+function digest(value) {
+    return typeof value === "string" && value.length === 64 && /^[a-f0-9]{64}$/.test(value);
+}
+function validChunkBytes(value) {
+    return Number.isSafeInteger(value) && value >= 65536 && value <= maximumChunkBytes;
+}
+function path(reference) {
+    return `/dataset-import-tasks/${encodeURIComponent(reference.taskId)}/versions/${reference.revision}/upload`;
+}
+function validate(value, reference, session) {
+    if (!value ||
+        value.taskId !== reference.taskId ||
+        value.taskRevision !== reference.revision ||
+        value.taskContentHash !== reference.contentHash ||
+        typeof value.uploadId !== "string" ||
+        value.uploadId.length !== 32 ||
+        !/^[a-f0-9]{32}$/.test(value.uploadId) ||
+        (session !== undefined && !matchesOriginalSession(value, session)) ||
+        !Number.isSafeInteger(value.version) ||
+        value.version < 1 ||
+        !Number.isSafeInteger(value.totalBytes) ||
+        value.totalBytes < 1 ||
+        !validChunkBytes(value.chunkBytes) ||
+        value.totalBytes > value.chunkBytes * maximumChunks ||
+        !Number.isSafeInteger(value.acceptedBytes) ||
+        value.acceptedBytes < 0 ||
+        value.acceptedBytes > value.totalBytes ||
+        value.chunkCount !== Math.ceil(value.acceptedBytes / value.chunkBytes) ||
+        value.acceptedBytes !== Math.min(value.chunkCount * value.chunkBytes, value.totalBytes) ||
+        !["receiving", "sealed", "cancelled"].includes(value.state) ||
+        !Number.isFinite(Date.parse(value.expiresAt)) ||
+        (value.state === "sealed"
+            ? value.acceptedBytes !== value.totalBytes || !digest(value.contentSha256)
+            : value.contentSha256 != null))
+        throw new Error("The transfer receipt changed its immutable task/session binding or canonical byte range.");
+    if (session?.sourceRetention !== undefined &&
+        (value.sourceRetention == null ||
+            value.sourceRetention.bytes !== session.sourceRetention.bytes ||
+            value.sourceRetention.sha256 !== session.sourceRetention.sha256 ||
+            (value.sourceRetention.expiresAt ?? null) !== session.sourceRetention.expiresAt))
+        throw new Error("The original retained source receipt changed.");
+    if (value.sourceRetention != null &&
+        (value.state !== "sealed" ||
+            value.sourceRetention.bytes !== value.totalBytes ||
+            value.sourceRetention.sha256 !== value.contentSha256 ||
+            (value.sourceRetention.expiresAt != null && !Number.isFinite(Date.parse(value.sourceRetention.expiresAt)))))
+        throw new Error("The retained source receipt does not match the sealed original bytes.");
+}
+function captureSession(original, reference) {
+    validate(original, reference);
+    return {
+        uploadId: original.uploadId,
+        version: original.version,
+        state: original.state,
+        acceptedBytes: original.acceptedBytes,
+        totalBytes: original.totalBytes,
+        chunkBytes: original.chunkBytes,
+        expiresAt: original.expiresAt,
+        contentSha256: original.contentSha256,
+        ...(original.sourceRetention == null
+            ? {}
+            : {
+                sourceRetention: {
+                    bytes: original.sourceRetention.bytes,
+                    sha256: original.sourceRetention.sha256,
+                    expiresAt: original.sourceRetention.expiresAt ?? null,
+                },
+            }),
+    };
+}
+function matchesOriginalSession(value, original) {
+    if (value.uploadId !== original.uploadId ||
+        value.totalBytes !== original.totalBytes ||
+        value.chunkBytes !== original.chunkBytes ||
+        value.expiresAt !== original.expiresAt ||
+        value.version < original.version ||
+        value.acceptedBytes < original.acceptedBytes ||
+        (original.state !== "receiving" && value.state !== original.state) ||
+        (original.state === "cancelled" && value.acceptedBytes !== original.acceptedBytes) ||
+        (original.contentSha256 != null && value.contentSha256 !== original.contentSha256))
+        return false;
+    // Every byte/state/source mutation advances canonical CAS version. A same-version
+    // response cannot add bytes, a seal, cancellation or a retained source receipt.
+    return (value.version !== original.version ||
+        (value.acceptedBytes === original.acceptedBytes &&
+            value.state === original.state &&
+            (value.contentSha256 ?? null) === (original.contentSha256 ?? null) &&
+            sameRetention(value.sourceRetention, original.sourceRetention)));
+}
+function sameRetention(left, right) {
+    if (left == null || right == null)
+        return left == null && right == null;
+    return (left.bytes === right.bytes && left.sha256 === right.sha256 && (left.expiresAt ?? null) === (right.expiresAt ?? null));
+}

package/control-plane/index.d.ts

@@ -26,4 +26,5 @@ export type { components as AdminApiComponents, operations as AdminApiOperations
 export type { StudioCapabilityManifest } from "../studio/capability-manifest.js";
 export { HONUA_CAPABILITY_MANIFEST_PATH, HONUA_CONTROL_PLANE_BASE_PATH } from "./types.js";
 export type { HonuaApiToken, HonuaApiTokenCreateRequest, HonuaCapabilityManifestOptions, HonuaConnectionSummary, HonuaControlPlaneCapability, HonuaControlPlaneJob, HonuaControlPlaneJobStatus, HonuaControlPlaneLinks, HonuaControlPlaneListOptions, HonuaControlPlanePage, HonuaControlPlaneRawRequest, HonuaControlPlaneRequestOptions, HonuaControlPlaneResult, HonuaControlPlaneSourceDescriptor, HonuaControlPlaneSuccess, HonuaControlPlaneUnsupported, HonuaCreateHostedMapRequest, HonuaEntityValidators, HonuaHostedMap, HonuaHostedMapSummary, HonuaImportCreateRequest, HonuaMapPackageSummary, HonuaProblemDetails, HonuaMapPublicationIntent, HonuaPublishMapPackageRequest, HonuaPublishMapPackageResponse, HonuaShareRequest, HonuaShareResponse, HonuaUpdateHostedMapRequest, HonuaWorkspaceSummary, } from "./types.js";
+export * from "./dataset-import/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/control-plane/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAClE,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,oCAAoC,EACpC,yBAAyB,EACzB,yBAAyB,EACzB,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EACjC,8BAA8B,EAC9B,gBAAgB,EAChB,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,UAAU,IAAI,kBAAkB,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnH,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC3F,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,2BAA2B,EAC3B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,EACvB,iCAAiC,EACjC,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/control-plane/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAClE,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,oCAAoC,EACpC,yBAAyB,EACzB,yBAAyB,EACzB,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EACjC,8BAA8B,EAC9B,gBAAgB,EAChB,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,UAAU,IAAI,kBAAkB,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnH,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAC3F,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,8BAA8B,EAC9B,sBAAsB,EACtB,2BAA2B,EAC3B,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,EAC/B,uBAAuB,EACvB,iCAAiC,EACjC,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,cAAc,2BAA2B,CAAC"}

package/control-plane/index.js

@@ -20,3 +20,4 @@ export * from "./commands/index.js";
 export { assertAdminBaseUrl, HonuaAdminApiError, HonuaAdminClient, createHonuaAdminClient, } from "./admin-client.js";
 export { ADMIN_API_BASE_PATH, ADMIN_API_OPERATION_COUNT, ADMIN_API_SERVER_SHA, ADMIN_API_SPEC_SHA256, ADMIN_MCP_CONTRACT_SERVER_SHA, ADMIN_MCP_CONTRACT_REVIEW_SERVER_SHA, ADMIN_MCP_CONTRACT_STATUS, ADMIN_MCP_COVERAGE_SHA256, ADMIN_MCP_EXCLUDED_OPERATION_COUNT, ADMIN_MCP_EXCLUDED_OPERATIONS, ADMIN_MCP_EXCLUSION_ROSTER_SHA256, ADMIN_MCP_PUBLISHED_TOOL_NAMES, ADMIN_OPERATIONS, ADMIN_PUBLISHED_OPERATION_COUNT, ADMIN_RELEASE_CONTRACT_COMPATIBLE, ADMIN_RELEASE_CONTRACT_STATUS, ADMIN_RELEASE_OPERATION_COUNT, ADMIN_RELEASE_SERVER_SHA, MCP_DEFAULT_STATIC_TOOL_COUNT, MCP_DEFAULT_TOTAL_TOOL_COUNT, } from "./generated/admin-operations.js";
 export { HONUA_CAPABILITY_MANIFEST_PATH, HONUA_CONTROL_PLANE_BASE_PATH } from "./types.js";
+export * from "./dataset-import/index.js";

package/core/job-run-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-run-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/job-run-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE;AAED,8EAA8E;AAC9E,qBAAa,eAAe,CAAC,CAAC;IAQT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP3C,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;gBAE3B,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAKtE,IAAW,MAAM,IAAI,SAAS,CAE7B;IACD,IAAW,QAAQ,IAAI,WAAW,GAAG,SAAS,CAE7C;IACD,IAAW,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAEhD;IAEM,KAAK,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAK7C,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAKrC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IAc3C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBvE,OAAO,CAAC,SAAS,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAWxE,OAAO,CAAC,aAAa;YAOP,gBAAgB;YAkChB,gBAAgB;IAgC9B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,YAAY;CASrB"}
+{"version":3,"file":"job-run-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/core/job-run-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE;AAED,8EAA8E;AAC9E,qBAAa,eAAe,CAAC,CAAC;IAQT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP3C,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;gBAE3B,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAKtE,IAAW,MAAM,IAAI,SAAS,CAE7B;IACD,IAAW,QAAQ,IAAI,WAAW,GAAG,SAAS,CAE7C;IACD,IAAW,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAEhD;IAEM,KAAK,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAK7C,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAKrC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IAiB3C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBvE,OAAO,CAAC,SAAS,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAWxE,OAAO,CAAC,aAAa;YAOP,gBAAgB;YAkChB,gBAAgB;IAgC9B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,YAAY;CASrB"}

package/core/job-run-lifecycle.js

@@ -34,6 +34,10 @@ export class JobRunLifecycle {
         return this.observe(await this.options.poll());
     }
     observe(snapshot) {
+        // A terminal learned from another poll or cancellation wins over any
+        // response still in flight, including the results polling loop.
+        if (this.terminalSnapshot)
+            return this.terminalSnapshot;
         this.currentStatus = snapshot.status;
         this.currentProgress = snapshot.progress;
         if (isJobTerminal(snapshot.status))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honua/app-platform",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "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.2",
+    "@honua/sdk": "0.2.4",
     "@bufbuild/protobuf": "^2.0.0",
     "@connectrpc/connect": "^2.0.0",
     "@connectrpc/connect-web": "^2.0.0",

package/query-planner/canonical.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../../src/query-planner/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAM,GAAG,SAAS,CAEjE;AA6DD,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,MAAM,EAAE,CA6DxD"}
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../../src/query-planner/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAM,GAAG,SAAS,CAEjE;AAqDD,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,MAAM,EAAE,CA6DxD"}

package/query-planner/canonical.js

@@ -33,20 +33,17 @@ function convertJson(value, path, ancestors) {
             throw new TypeError(`${path} must contain only plain JSON objects`);
         }
         ancestors.add(value);
-        const converted = {};
+        const entries = [];
         for (const key of Object.keys(value).sort()) {
             const entry = value[key];
             if (entry !== undefined) {
-                Object.defineProperty(converted, key, {
-                    value: convertJson(entry, `${path}.${key}`, ancestors),
-                    enumerable: true,
-                    writable: true,
-                    configurable: true,
-                });
+                entries.push([key, convertJson(entry, `${path}.${key}`, ancestors)]);
             }
         }
         ancestors.delete(value);
-        return converted;
+        // Native data-property creation keeps special keys inert without allocating
+        // a property descriptor for every member of every detached object.
+        return Object.fromEntries(entries);
     }
     throw new TypeError(`${path} contains unsupported ${typeof value}`);
 }
@@ -55,16 +52,11 @@ function sortJson(value) {
         return value.map(sortJson);
     if (value !== null && typeof value === "object") {
         const object = value;
-        const sorted = {};
+        const entries = [];
         for (const key of Object.keys(object).sort()) {
-            Object.defineProperty(sorted, key, {
-                value: sortJson(object[key]),
-                enumerable: true,
-                writable: true,
-                configurable: true,
-            });
+            entries.push([key, sortJson(object[key])]);
         }
-        return sorted;
+        return Object.fromEntries(entries);
     }
     return value;
 }

package/runtime/generated/map-package-schema-meta.d.ts

@@ -1,7 +1,7 @@
 /** `$id` of the schema this projection was generated from. */
 export declare const HONUA_MAP_PACKAGE_SCHEMA_ID: "https://honua.io/schemas/honua-map-package.v1.json";
 /** sha256 of the schema bytes, so a drifted projection is identifiable. */
-export declare const HONUA_MAP_PACKAGE_SCHEMA_SHA256: "b923ea9bc7111e3fd886f9fd0e35d725df964a645d3e27576b0f2a579b8baca8";
+export declare const HONUA_MAP_PACKAGE_SCHEMA_SHA256: "d25f1ecd7240e71bd606fa10b75ad0b03510afdf6b59a49d77be1e3e048b1465";
 /** Every `SourceBinding.protocol` value the schema admits. */
 export declare const HONUA_MAP_PACKAGE_SCHEMA_PROTOCOLS: readonly ["geoservices_feature_service", "geoservices_map_service", "ogc_features", "ogc_maps", "ogc_tiles", "wfs", "wms", "wmts", "odata", "vector_tile", "raster_tile", "pmtiles", "workspace_artifact"];
 /** Every `status` value the schema admits (server-produced; see the schema). */

package/runtime/generated/map-package-schema-meta.js

@@ -3,7 +3,7 @@
 /** `$id` of the schema this projection was generated from. */
 export const HONUA_MAP_PACKAGE_SCHEMA_ID = "https://honua.io/schemas/honua-map-package.v1.json";
 /** sha256 of the schema bytes, so a drifted projection is identifiable. */
-export const HONUA_MAP_PACKAGE_SCHEMA_SHA256 = "b923ea9bc7111e3fd886f9fd0e35d725df964a645d3e27576b0f2a579b8baca8";
+export const HONUA_MAP_PACKAGE_SCHEMA_SHA256 = "d25f1ecd7240e71bd606fa10b75ad0b03510afdf6b59a49d77be1e3e048b1465";
 /** Every `SourceBinding.protocol` value the schema admits. */
 export const HONUA_MAP_PACKAGE_SCHEMA_PROTOCOLS = ["geoservices_feature_service", "geoservices_map_service", "ogc_features", "ogc_maps", "ogc_tiles", "wfs", "wms", "wmts", "odata", "vector_tile", "raster_tile", "pmtiles", "workspace_artifact"];
 /** Every `status` value the schema admits (server-produced; see the schema). */

package/runtime/generated/map-package-schema-validator.d.ts

@@ -1,16 +1,16 @@
-declare const _: typeof k;
-declare var R: typeof k;
-declare function k(m: any, { instancePath: i, parentData: h, parentDataProperty: c, rootData: u, dynamicAnchors: f }?: {
+declare const E: typeof I;
+declare var D: typeof I;
+declare function I(m: any, { instancePath: i, parentData: b, parentDataProperty: f, rootData: h, dynamicAnchors: w }?: {
     instancePath?: string | undefined;
     rootData?: any;
     dynamicAnchors?: {} | undefined;
 }): boolean;
-declare namespace k {
+declare namespace I {
     var evaluated: {
         props: boolean;
         dynamicProps: boolean;
         dynamicItems: boolean;
     };
 }
-export { R as default, _ as validate };
+export { D as default, E as validate };
 //# sourceMappingURL=map-package-schema-validator.d.ts.map

package/runtime/generated/map-package-schema-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-package-schema-validator.d.ts","sourceRoot":"","sources":["../../../../src/runtime/generated/map-package-schema-validator.ts"],"names":[],"mappings":"AA2B4J,QAAA,MAAM,CAAC,UAAE,CAAC;AAAA,QAAA,IAAI,CAAC,UAAE,CAAC;AAA+/rB,iBAAS,CAAC,CAAC,CAAC,KAAA,EAAC,EAAC,YAAY,EAAC,CAAI,EAAC,UAAU,EAAC,CAAC,EAAC,kBAAkB,EAAC,CAAC,EAAC,QAAQ,EAAC,CAAG,EAAC,cAAc,EAAC,CAAI,EAAC;;;;CAAG,WAA6i2C;kBAA1o2C,CAAC;;;;;;;AAAgs2C,OAAM,EAAC,CAAC,IAAI,OAAO,EAAC,CAAC,IAAI,QAAQ,EAAC,CAAC"}
+{"version":3,"file":"map-package-schema-validator.d.ts","sourceRoot":"","sources":["../../../../src/runtime/generated/map-package-schema-validator.ts"],"names":[],"mappings":"AA2B4J,QAAA,MAAM,CAAC,UAAE,CAAC;AAAA,QAAA,IAAI,CAAC,UAAE,CAAC;AAA0j5B,iBAAS,CAAC,CAAC,CAAC,KAAA,EAAC,EAAC,YAAY,EAAC,CAAI,EAAC,UAAU,EAAC,CAAC,EAAC,kBAAkB,EAAC,CAAC,EAAC,QAAQ,EAAC,CAAG,EAAC,cAAc,EAAC,CAAI,EAAC;;;;CAAG,WAA6i2C;kBAA1o2C,CAAC;;;;;;;AAAgs2C,OAAM,EAAC,CAAC,IAAI,OAAO,EAAC,CAAC,IAAI,QAAQ,EAAC,CAAC"}