@honua/app-platform 0.0.20-alpha.0

package/contract/temporal.d.ts

@@ -0,0 +1,455 @@
+/**
+ * Protocol-neutral temporal data-history contracts.
+ *
+ * Honua exposes temporal history — "git over data" — from many surfaces:
+ * Console, MCP clients in Claude/GPT, the QGIS plugin, and Studio-generated
+ * maps, dashboards, and reports. This module is the single shared vocabulary
+ * those surfaces speak so AI prompts and UI builders do not drift from server
+ * truth. It mirrors the server contract tracked in honua-server#1166 and the
+ * Console information model in
+ * `honua-console/docs/architecture/temporal-data-viewer-information-model.md`.
+ *
+ * It is intentionally a contract surface only: it describes the request
+ * envelopes SDK callers send and the response shapes apps render. Unsupported
+ * capabilities are represented explicitly (`mode: "none"`, capability flags,
+ * and {@link TemporalError} codes) rather than inferred from missing fields,
+ * so a read-only history source is never confused with named-version editing
+ * (honua-server#371).
+ *
+ * The {@link createTemporalClient} factory layers thin request builders over
+ * any client that can issue a JSON request (the SDK's `HonuaClient` satisfies
+ * it via `pipelineRequestJson`); it does not couple to a concrete transport.
+ *
+ * @module
+ */
+import type { SpatialFilter } from "../core/spatial-filter.js";
+import type { HonuaExtent } from "../core/types.js";
+import type { FeatureId, SourceId } from "./types.js";
+export declare const TEMPORAL_SCHEMA_VERSION: "honua.temporal.v1";
+export declare const TEMPORAL_CAPABILITY: "temporalHistory";
+/** Route prefix every temporal endpoint shares. */
+export declare const TEMPORAL_ROUTE_PREFIX: "/temporal";
+/**
+ * Canonical request routes. Large diff and rollback operations return job
+ * references (see {@link TemporalDiff.job} / {@link TemporalRollbackOperation})
+ * rather than forcing synchronous responses.
+ */
+export declare const TEMPORAL_ROUTES: {
+    readonly capabilities: "/temporal/capabilities";
+    readonly checkpoints: "/temporal/checkpoints";
+    readonly queryAsOf: "/temporal/query-as-of";
+    readonly diff: "/temporal/diff";
+    readonly diffStatus: "/temporal/diffs/{diffId}";
+    readonly featureTimeline: "/temporal/features/{featureId}/timeline";
+    readonly rollbackPlans: "/temporal/rollback-plans";
+    readonly rollbackOperations: "/temporal/rollback-operations";
+    readonly rollbackOperationStatus: "/temporal/rollback-operations/{operationId}";
+};
+/**
+ * What a layer or table can support. `none` means temporal history is
+ * unavailable; the richer modes are additive (`rollback` implies `diff`,
+ * `history`, and `as_of` are also offered). Capability discovery is
+ * server-owned — clients must not infer a mode from the presence of fields.
+ */
+export type TemporalMode = "none" | "as_of" | "history" | "diff" | "rollback";
+/** Underlying history model. Opaque to apps; surfaced for diagnostics only. */
+export type TemporalHistoryModel = "system_versioned" | "valid_time" | "transaction_time" | "bitemporal" | "delta_log" | "external_audit";
+/** Cursor kinds a checkpoint can address. */
+export type TemporalCursorType = "timestamp" | "transaction" | "release" | "job" | "named_checkpoint";
+/** Operation that produced a revision. */
+export type TemporalRevisionOperation = "insert" | "update" | "delete" | "restore";
+/** Operation that produced a change set. */
+export type TemporalChangeSetOperationKind = "interactive_edit" | "bulk_import" | "etl_job" | "metadata_release" | "sync" | "rollback";
+/** Per-feature change classification within a diff. */
+export type TemporalFeatureChangeType = "added" | "removed" | "updated" | "unchanged";
+/** Scope a rollback targets. */
+export type TemporalRollbackScope = "feature" | "selection" | "layer" | "change_set" | "release";
+/** How a rollback would be carried out. */
+export type TemporalRollbackMode = "metadata_only" | "data_revert" | "service_revision_switch" | "script_required" | "manual";
+/** Coarse risk band the server assigns to a rollback plan. */
+export type TemporalRiskLevel = "low" | "medium" | "high";
+/** Lifecycle of a rollback operation. Mirrors {@link import("./jobs.js").JobStatus}. */
+export type TemporalRollbackStatus = "accepted" | "running" | "successful" | "failed" | "dismissed";
+/** Lifecycle of an asynchronously produced diff. */
+export type TemporalDiffStatus = "accepted" | "running" | "successful" | "failed" | "dismissed";
+/**
+ * Stable machine codes for temporal error/status conditions. Servers and SDK
+ * helpers use these so consumers branch on a code rather than parse prose.
+ */
+export type TemporalErrorCode = "unsupported-history" | "masked-fields" | "expired-retention" | "large-diff-job-required" | "rollback-blocked" | "approval-required";
+/** Error/status envelope shared by every temporal surface. */
+export interface TemporalError {
+    code: TemporalErrorCode;
+    message: string;
+    /** Fields the server masked from the response when `code` is `masked-fields`. */
+    maskedFields?: readonly string[];
+    /** Job reference to follow when `code` is `large-diff-job-required`. */
+    job?: TemporalJobRef;
+    /** Approver roles/identities required when `code` is `approval-required`. */
+    requiredApprovals?: readonly string[];
+    /** Optional retention boundary the request fell outside of. */
+    retentionExpiresAt?: string;
+    details?: unknown;
+}
+/** Reference to a server job that produces a large diff or runs a rollback. */
+export interface TemporalJobRef {
+    jobRunId: string;
+    /** Stable status code if the server reports one inline. */
+    status?: TemporalDiffStatus | TemporalRollbackStatus;
+    /** Links to artifacts (diff pages, rollback evidence) when produced. */
+    artifactRefs?: readonly string[];
+}
+/**
+ * What a source supports. Read-only history (`rollbackSupported: false`) is
+ * always distinguishable from named-version editing, which is a separate
+ * contract (honua-server#371).
+ */
+export interface TemporalSourceCapability {
+    sourceId: SourceId;
+    resourceId?: string;
+    layerId?: string | number;
+    mode: TemporalMode;
+    historyModel?: TemporalHistoryModel;
+    stableFeatureIdField?: string;
+    validFromField?: string;
+    validToField?: string;
+    transactionIdField?: string;
+    actorField?: string;
+    operationIdField?: string;
+    geometryHistorySupported: boolean;
+    attributeHistorySupported: boolean;
+    rollbackSupported: boolean;
+    retentionPolicyId?: string;
+    schemaEvolutionPolicy?: string;
+    /** Smallest snapshot granularity, e.g. ISO-8601 duration `"PT1H"`. */
+    minimumSnapshotGranularity?: string;
+    /** Largest diff window the server will compute synchronously, ISO-8601. */
+    maxDiffWindow?: string;
+    changeTrackingSupported?: boolean;
+}
+/** Named or implicit point usable as a history cursor. */
+export interface TemporalCheckpoint {
+    checkpointId: string;
+    sourceId: SourceId;
+    resourceId?: string;
+    cursorType: TemporalCursorType;
+    /** Cursor payload; an ISO-8601 timestamp, transaction id, release id, etc. */
+    cursorValue: string;
+    label?: string;
+    createdAt?: string;
+    createdBy?: string;
+    operationRef?: string;
+    gitRef?: string;
+    jobRunId?: string;
+    metadataReleaseId?: string;
+}
+/** One committed state of one feature or row. */
+export interface TemporalRevision {
+    revisionId: string;
+    sourceId: SourceId;
+    featureId: FeatureId;
+    validFrom?: string;
+    validTo?: string;
+    transactionTime?: string;
+    operation: TemporalRevisionOperation;
+    actorId?: string;
+    actorDisplayName?: string;
+    sourceClient?: string;
+    jobRunId?: string;
+    releaseOperationId?: string;
+    editSessionId?: string;
+    reason?: string;
+    schemaVersion?: string;
+    geometryDigest?: string;
+    attributeDigest?: string;
+}
+/** A grouped set of revisions caused by one operation. */
+export interface TemporalChangeSet {
+    changeSetId: string;
+    sourceId: SourceId;
+    operationRef?: string;
+    operationKind: TemporalChangeSetOperationKind;
+    startedAt?: string;
+    completedAt?: string;
+    actorId?: string;
+    status?: string;
+    featureCounts?: Readonly<Record<string, number>>;
+    fieldCounts?: Readonly<Record<string, number>>;
+    geometryChangeCount?: number;
+    validationSummary?: unknown;
+    /** Whether this change set can be the target of a rollback. */
+    rollbackEligibility?: "eligible" | "ineligible" | "requires-approval";
+}
+/** Field-level before/after change. `before`/`after` are absent when masked. */
+export interface TemporalAttributeChange {
+    field: string;
+    before?: unknown;
+    after?: unknown;
+    /** True when policy masked the values; see {@link TemporalError} `masked-fields`. */
+    masked?: boolean;
+}
+/** Summary of a geometry change between two revisions. */
+export interface TemporalGeometryChange {
+    changed: boolean;
+    fromDigest?: string;
+    toDigest?: string;
+    /** Optional server-computed magnitude, e.g. area or vertex delta. */
+    magnitude?: number;
+}
+/** Per-feature comparison within a diff or feature timeline. */
+export interface TemporalFeatureDiff {
+    featureId: FeatureId;
+    changeType: TemporalFeatureChangeType;
+    fromRevisionId?: string;
+    toRevisionId?: string;
+    attributeChanges?: readonly TemporalAttributeChange[];
+    geometryChange?: TemporalGeometryChange;
+    actorIds?: readonly string[];
+    operationRefs?: readonly string[];
+    validationFindings?: readonly unknown[];
+}
+/** Aggregate counts for a diff. */
+export interface TemporalDiffSummary {
+    addedFeatures: number;
+    removedFeatures: number;
+    updatedFeatures: number;
+    geometryChangedFeatures: number;
+    attributeChangedFeatures: number;
+    unchangedFeatures?: number;
+}
+/** Server-generated comparison between two checkpoints or time cursors. */
+export interface TemporalDiff {
+    diffId: string;
+    sourceId: SourceId;
+    fromCheckpointId: string;
+    toCheckpointId: string;
+    status: TemporalDiffStatus;
+    extent?: HonuaExtent;
+    summary?: TemporalDiffSummary;
+    /** A page of per-feature changes; large diffs page via {@link nextCursor}. */
+    sampleFeatureChanges?: readonly TemporalFeatureDiff[];
+    nextCursor?: string;
+    generatedAt?: string;
+    expiresAt?: string;
+    /** Set when the diff is produced asynchronously by the job runner. */
+    job?: TemporalJobRef;
+    /** Present on `failed` / unsupported responses. */
+    error?: TemporalError;
+}
+/** The complete revision history for one feature. */
+export interface TemporalFeatureTimeline {
+    sourceId: SourceId;
+    featureId: FeatureId;
+    revisions: readonly TemporalRevision[];
+    /** Per-revision change detail, parallel to {@link revisions}. */
+    changes?: readonly TemporalFeatureDiff[];
+    nextCursor?: string;
+    error?: TemporalError;
+}
+/** Server-authored plan for a proposed rollback. Immutable evidence. */
+export interface TemporalRollbackPlan {
+    rollbackPlanId: string;
+    sourceId: SourceId;
+    targetScope: TemporalRollbackScope;
+    targetCheckpointId: string;
+    currentCheckpointId?: string;
+    affectedFeatureCount?: number;
+    validationFindings?: readonly unknown[];
+    compatibilityFindings?: readonly unknown[];
+    requiresJob: boolean;
+    requiresApproval: boolean;
+    rollbackMode: TemporalRollbackMode;
+    generatedScriptRef?: string;
+    /** Estimated duration as an ISO-8601 duration. */
+    estimatedDuration?: string;
+    riskLevel?: TemporalRiskLevel;
+    /** Set when the plan cannot be produced or rollback is blocked. */
+    error?: TemporalError;
+}
+/** Tracked execution record for a rollback. */
+export interface TemporalRollbackOperation {
+    rollbackOperationId: string;
+    rollbackPlanId: string;
+    jobRunId?: string;
+    status: TemporalRollbackStatus;
+    requestedBy?: string;
+    approvedBy?: string;
+    startedAt?: string;
+    completedAt?: string;
+    resultCheckpointId?: string;
+    auditEventIds?: readonly string[];
+    artifactRefs?: readonly string[];
+    failureReason?: string;
+    error?: TemporalError;
+}
+/** Shared filter for as-of, diff, and timeline reads. */
+export interface TemporalFilter {
+    actorIds?: readonly string[];
+    jobRunIds?: readonly string[];
+    serviceIds?: readonly string[];
+    releaseOperationIds?: readonly string[];
+    fields?: readonly string[];
+    featureIds?: readonly FeatureId[];
+    extent?: HonuaExtent;
+    spatialFilter?: SpatialFilter;
+    /** Inclusive ISO-8601 time range. */
+    from?: string;
+    to?: string;
+}
+/** A history cursor: a checkpoint id, or a typed cursor value. */
+export interface TemporalCursor {
+    checkpointId?: string;
+    cursorType?: TemporalCursorType;
+    cursorValue?: string;
+}
+/** Request to read a source's state at a checkpoint or timestamp. */
+export interface TemporalAsOfRequest {
+    sourceId: SourceId;
+    /** The point in time to read. Provide a checkpoint id or a typed cursor. */
+    cursor: TemporalCursor;
+    where?: string;
+    outFields?: readonly string[];
+    filter?: TemporalFilter;
+    /** Page size hint for the returned feature window. */
+    limit?: number;
+    cursorToken?: string;
+}
+/** Request to compute a diff between two cursors. */
+export interface TemporalDiffRequest {
+    sourceId: SourceId;
+    from: TemporalCursor;
+    to: TemporalCursor;
+    filter?: TemporalFilter;
+    /** Include field-level before/after values when policy allows it. */
+    includeAttributeChanges?: boolean;
+    includeGeometryChanges?: boolean;
+    limit?: number;
+}
+/** Request to read a feature's revision timeline. */
+export interface TemporalFeatureTimelineRequest {
+    sourceId: SourceId;
+    featureId: FeatureId;
+    filter?: TemporalFilter;
+    limit?: number;
+    cursorToken?: string;
+}
+/** Request to author a rollback plan. */
+export interface TemporalRollbackPlanRequest {
+    sourceId: SourceId;
+    targetScope: TemporalRollbackScope;
+    targetCheckpointId: string;
+    /** Required for `feature` / `selection` scopes. */
+    featureIds?: readonly FeatureId[];
+    /** Required for `layer` scope. */
+    layerId?: string | number;
+    /** Required for `change_set` scope. */
+    changeSetId?: string;
+    /** Required for `release` scope. */
+    releaseOperationId?: string;
+    reason?: string;
+}
+/** Request to execute a previously authored rollback plan. */
+export interface TemporalRollbackExecuteRequest {
+    rollbackPlanId: string;
+    /** Approver identity when the plan requires approval. */
+    approvedBy?: string;
+    reason?: string;
+}
+/**
+ * Fixture envelope for Console and Studio temporal viewer prototypes. Captures
+ * a coherent set of states for one source so apps and tests can render the
+ * full viewer without a live server.
+ */
+export interface TemporalContractFixture {
+    schemaVersion: typeof TEMPORAL_SCHEMA_VERSION;
+    capability: TemporalSourceCapability;
+    checkpoints: readonly TemporalCheckpoint[];
+    asOf: {
+        request: TemporalAsOfRequest;
+        revisions: readonly TemporalRevision[];
+    };
+    diff: {
+        request: TemporalDiffRequest;
+        response: TemporalDiff;
+    };
+    featureTimeline: {
+        request: TemporalFeatureTimelineRequest;
+        response: TemporalFeatureTimeline;
+    };
+    rollback: {
+        planRequest: TemporalRollbackPlanRequest;
+        plan: TemporalRollbackPlan;
+        operation: TemporalRollbackOperation;
+    };
+    /** Representative error/status envelopes, keyed by code. */
+    errors: Readonly<Record<TemporalErrorCode, TemporalError>>;
+}
+/**
+ * `true` when `capability` advertises at least `required`. The modes are
+ * additive, so a `rollback` source also supports `diff`, `history`, and
+ * `as_of`. A `none` source never satisfies any positive requirement.
+ */
+export declare function temporalModeSupports(capability: TemporalSourceCapability, required: TemporalMode): boolean;
+/**
+ * `true` when the source exposes read-only temporal history but not rollback
+ * — the case that must stay distinct from named-version editing.
+ */
+export declare function isReadOnlyTemporalHistory(capability: TemporalSourceCapability): boolean;
+/** Validation issue from {@link validateTemporalRollbackPlanRequest}. */
+export interface TemporalValidationIssue {
+    path: string;
+    message: string;
+}
+/**
+ * Validate the scope-specific fields a rollback plan request must carry.
+ * Returns an empty array when valid.
+ */
+export declare function validateTemporalRollbackPlanRequest(request: TemporalRollbackPlanRequest): readonly TemporalValidationIssue[];
+/** Throwing variant of {@link validateTemporalRollbackPlanRequest}. */
+export declare function assertValidTemporalRollbackPlanRequest(request: TemporalRollbackPlanRequest): void;
+/**
+ * Minimal client surface the temporal helpers need. The SDK's `HonuaClient`
+ * satisfies this via `pipelineRequestJson`; tests can pass a stub. Query
+ * parameters belong on `path`.
+ */
+export interface TemporalRequestClient {
+    pipelineRequestJson<T = unknown>(method: "GET" | "POST", path: string, init?: {
+        headers?: HeadersInit;
+        body?: BodyInit | null;
+    }, signal?: AbortSignal): Promise<T>;
+}
+/** Options accepted by every temporal client method. */
+export interface TemporalClientCallOptions {
+    signal?: AbortSignal;
+}
+/**
+ * Thin request builders over a {@link TemporalRequestClient}. Every method
+ * targets a route in {@link TEMPORAL_ROUTES} and returns the canonical shape;
+ * unsupported capabilities surface as {@link TemporalError} on the response or
+ * as a server error, never as silently empty data.
+ */
+export interface TemporalClient {
+    /** Discover what a source supports. */
+    capabilities(resourceId: string, options?: TemporalClientCallOptions): Promise<TemporalSourceCapability>;
+    /** List checkpoints (history cursors) for a source. */
+    listCheckpoints(sourceId: SourceId, options?: TemporalClientCallOptions): Promise<readonly TemporalCheckpoint[]>;
+    /** Read a source's state at a checkpoint or timestamp. */
+    queryAsOf(request: TemporalAsOfRequest, options?: TemporalClientCallOptions): Promise<readonly TemporalRevision[]>;
+    /** Request a diff between two cursors. May return a job reference. */
+    requestDiff(request: TemporalDiffRequest, options?: TemporalClientCallOptions): Promise<TemporalDiff>;
+    /** Read the status / next page of a previously requested diff. */
+    getDiff(diffId: string, options?: TemporalClientCallOptions & {
+        cursor?: string;
+    }): Promise<TemporalDiff>;
+    /** Read a feature's revision timeline. */
+    featureTimeline(request: TemporalFeatureTimelineRequest, options?: TemporalClientCallOptions): Promise<TemporalFeatureTimeline>;
+    /** Author a rollback plan. */
+    createRollbackPlan(request: TemporalRollbackPlanRequest, options?: TemporalClientCallOptions): Promise<TemporalRollbackPlan>;
+    /** Execute a previously authored rollback plan. */
+    executeRollback(request: TemporalRollbackExecuteRequest, options?: TemporalClientCallOptions): Promise<TemporalRollbackOperation>;
+    /** Read the status of a rollback operation. */
+    rollbackOperationStatus(operationId: string, options?: TemporalClientCallOptions): Promise<TemporalRollbackOperation>;
+}
+/** Build a {@link TemporalClient} bound to a request client. */
+export declare function createTemporalClient(client: TemporalRequestClient): TemporalClient;
+//# sourceMappingURL=temporal.d.ts.map

package/contract/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../../src/contract/temporal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,uBAAuB,EAAG,mBAA4B,CAAC;AACpE,eAAO,MAAM,mBAAmB,EAAG,iBAA0B,CAAC;AAE9D,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,EAAG,WAAoB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;CAUlB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9E,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,gBAAgB,CAAC;AAErB,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,kBAAkB,CAAC;AAEtG,0CAA0C;AAC1C,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnF,4CAA4C;AAC5C,MAAM,MAAM,8BAA8B,GACtC,kBAAkB,GAClB,aAAa,GACb,SAAS,GACT,kBAAkB,GAClB,MAAM,GACN,UAAU,CAAC;AAEf,uDAAuD;AACvD,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtF,gCAAgC;AAChC,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjG,2CAA2C;AAC3C,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,aAAa,GACb,yBAAyB,GACzB,iBAAiB,GACjB,QAAQ,CAAC;AAEb,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D,wFAAwF;AACxF,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpG,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhG;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,GACrB,eAAe,GACf,mBAAmB,GACnB,yBAAyB,GACzB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,wEAAwE;IACxE,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,CAAC;IACrD,wEAAwE;IACxE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;IAClC,yBAAyB,EAAE,OAAO,CAAC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sEAAsE;IACtE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,yBAAyB,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,8BAA8B,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,mBAAmB,CAAC;CACvE;AAED,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,yBAAyB,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,kBAAkB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACzC;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvC,iEAAiE;IACjE,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,qBAAqB,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACxC,qBAAqB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3C,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,oBAAoB,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,mEAAmE;IACnE,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,4EAA4E;IAC5E,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,cAAc,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qEAAqE;IACrE,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,qBAAqB,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,8BAA8B;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,OAAO,uBAAuB,CAAC;IAC9C,UAAU,EAAE,wBAAwB,CAAC;IACrC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC3C,IAAI,EAAE;QACJ,OAAO,EAAE,mBAAmB,CAAC;QAC7B,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;KACxC,CAAC;IACF,IAAI,EAAE;QACJ,OAAO,EAAE,mBAAmB,CAAC;QAC7B,QAAQ,EAAE,YAAY,CAAC;KACxB,CAAC;IACF,eAAe,EAAE;QACf,OAAO,EAAE,8BAA8B,CAAC;QACxC,QAAQ,EAAE,uBAAuB,CAAC;KACnC,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,EAAE,2BAA2B,CAAC;QACzC,IAAI,EAAE,oBAAoB,CAAC;QAC3B,SAAS,EAAE,yBAAyB,CAAC;KACtC,CAAC;IACF,4DAA4D;IAC5D,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;CAC5D;AAUD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,wBAAwB,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAG1G;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,wBAAwB,GAAG,OAAO,CAEvF;AAED,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,2BAA2B,GACnC,SAAS,uBAAuB,EAAE,CAmBpC;AAED,uEAAuE;AACvE,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAKjG;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,WAAW,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE,EACxD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACzG,uDAAuD;IACvD,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;IACjH,0DAA0D;IAC1D,SAAS,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC;IACnH,sEAAsE;IACtE,WAAW,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtG,kEAAkE;IAClE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1G,0CAA0C;IAC1C,eAAe,CACb,OAAO,EAAE,8BAA8B,EACvC,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,8BAA8B;IAC9B,kBAAkB,CAChB,OAAO,EAAE,2BAA2B,EACpC,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,mDAAmD;IACnD,eAAe,CACb,OAAO,EAAE,8BAA8B,EACvC,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,+CAA+C;IAC/C,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACvH;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CA4DlF"}

package/contract/temporal.js

@@ -0,0 +1,146 @@
+/**
+ * Protocol-neutral temporal data-history contracts.
+ *
+ * Honua exposes temporal history — "git over data" — from many surfaces:
+ * Console, MCP clients in Claude/GPT, the QGIS plugin, and Studio-generated
+ * maps, dashboards, and reports. This module is the single shared vocabulary
+ * those surfaces speak so AI prompts and UI builders do not drift from server
+ * truth. It mirrors the server contract tracked in honua-server#1166 and the
+ * Console information model in
+ * `honua-console/docs/architecture/temporal-data-viewer-information-model.md`.
+ *
+ * It is intentionally a contract surface only: it describes the request
+ * envelopes SDK callers send and the response shapes apps render. Unsupported
+ * capabilities are represented explicitly (`mode: "none"`, capability flags,
+ * and {@link TemporalError} codes) rather than inferred from missing fields,
+ * so a read-only history source is never confused with named-version editing
+ * (honua-server#371).
+ *
+ * The {@link createTemporalClient} factory layers thin request builders over
+ * any client that can issue a JSON request (the SDK's `HonuaClient` satisfies
+ * it via `pipelineRequestJson`); it does not couple to a concrete transport.
+ *
+ * @module
+ */
+export const TEMPORAL_SCHEMA_VERSION = "honua.temporal.v1";
+export const TEMPORAL_CAPABILITY = "temporalHistory";
+/** Route prefix every temporal endpoint shares. */
+export const TEMPORAL_ROUTE_PREFIX = "/temporal";
+/**
+ * Canonical request routes. Large diff and rollback operations return job
+ * references (see {@link TemporalDiff.job} / {@link TemporalRollbackOperation})
+ * rather than forcing synchronous responses.
+ */
+export const TEMPORAL_ROUTES = {
+    capabilities: "/temporal/capabilities",
+    checkpoints: "/temporal/checkpoints",
+    queryAsOf: "/temporal/query-as-of",
+    diff: "/temporal/diff",
+    diffStatus: "/temporal/diffs/{diffId}",
+    featureTimeline: "/temporal/features/{featureId}/timeline",
+    rollbackPlans: "/temporal/rollback-plans",
+    rollbackOperations: "/temporal/rollback-operations",
+    rollbackOperationStatus: "/temporal/rollback-operations/{operationId}",
+};
+const MODE_RANK = {
+    none: 0,
+    as_of: 1,
+    history: 2,
+    diff: 3,
+    rollback: 4,
+};
+/**
+ * `true` when `capability` advertises at least `required`. The modes are
+ * additive, so a `rollback` source also supports `diff`, `history`, and
+ * `as_of`. A `none` source never satisfies any positive requirement.
+ */
+export function temporalModeSupports(capability, required) {
+    if (required === "none")
+        return true;
+    return MODE_RANK[capability.mode] >= MODE_RANK[required];
+}
+/**
+ * `true` when the source exposes read-only temporal history but not rollback
+ * — the case that must stay distinct from named-version editing.
+ */
+export function isReadOnlyTemporalHistory(capability) {
+    return capability.mode !== "none" && !capability.rollbackSupported;
+}
+/**
+ * Validate the scope-specific fields a rollback plan request must carry.
+ * Returns an empty array when valid.
+ */
+export function validateTemporalRollbackPlanRequest(request) {
+    const issues = [];
+    if (!request.sourceId)
+        issues.push({ path: "sourceId", message: "sourceId is required" });
+    if (!request.targetCheckpointId) {
+        issues.push({ path: "targetCheckpointId", message: "targetCheckpointId is required" });
+    }
+    if ((request.targetScope === "feature" || request.targetScope === "selection") && !hasItems(request.featureIds)) {
+        issues.push({ path: "featureIds", message: `${request.targetScope} rollback requires featureIds` });
+    }
+    if (request.targetScope === "layer" && request.layerId === undefined) {
+        issues.push({ path: "layerId", message: "layer rollback requires layerId" });
+    }
+    if (request.targetScope === "change_set" && !request.changeSetId) {
+        issues.push({ path: "changeSetId", message: "change_set rollback requires changeSetId" });
+    }
+    if (request.targetScope === "release" && !request.releaseOperationId) {
+        issues.push({ path: "releaseOperationId", message: "release rollback requires releaseOperationId" });
+    }
+    return issues;
+}
+/** Throwing variant of {@link validateTemporalRollbackPlanRequest}. */
+export function assertValidTemporalRollbackPlanRequest(request) {
+    const issues = validateTemporalRollbackPlanRequest(request);
+    if (issues.length > 0) {
+        throw new Error(`Invalid temporal rollback plan request: ${issues.map((issue) => issue.path).join(", ")}`);
+    }
+}
+/** Build a {@link TemporalClient} bound to a request client. */
+export function createTemporalClient(client) {
+    const jsonInit = (body) => ({
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    return {
+        capabilities(resourceId, options) {
+            const path = `${TEMPORAL_ROUTES.capabilities}?resourceId=${encodeURIComponent(resourceId)}`;
+            return client.pipelineRequestJson("GET", path, undefined, options?.signal);
+        },
+        listCheckpoints(sourceId, options) {
+            const path = `${TEMPORAL_ROUTES.checkpoints}?sourceId=${encodeURIComponent(String(sourceId))}`;
+            return client.pipelineRequestJson("GET", path, undefined, options?.signal);
+        },
+        queryAsOf(request, options) {
+            return client.pipelineRequestJson("POST", TEMPORAL_ROUTES.queryAsOf, jsonInit(request), options?.signal);
+        },
+        requestDiff(request, options) {
+            return client.pipelineRequestJson("POST", TEMPORAL_ROUTES.diff, jsonInit(request), options?.signal);
+        },
+        getDiff(diffId, options) {
+            const base = TEMPORAL_ROUTES.diffStatus.replace("{diffId}", encodeURIComponent(diffId));
+            const path = options?.cursor ? `${base}?cursor=${encodeURIComponent(options.cursor)}` : base;
+            return client.pipelineRequestJson("GET", path, undefined, options?.signal);
+        },
+        featureTimeline(request, options) {
+            const path = TEMPORAL_ROUTES.featureTimeline.replace("{featureId}", encodeURIComponent(String(request.featureId)));
+            return client.pipelineRequestJson("POST", path, jsonInit(request), options?.signal);
+        },
+        async createRollbackPlan(request, options) {
+            assertValidTemporalRollbackPlanRequest(request);
+            return client.pipelineRequestJson("POST", TEMPORAL_ROUTES.rollbackPlans, jsonInit(request), options?.signal);
+        },
+        executeRollback(request, options) {
+            return client.pipelineRequestJson("POST", TEMPORAL_ROUTES.rollbackOperations, jsonInit(request), options?.signal);
+        },
+        rollbackOperationStatus(operationId, options) {
+            const path = TEMPORAL_ROUTES.rollbackOperationStatus.replace("{operationId}", encodeURIComponent(operationId));
+            return client.pipelineRequestJson("GET", path, undefined, options?.signal);
+        },
+    };
+}
+function hasItems(value) {
+    return Array.isArray(value) && value.length > 0;
+}