@honua/react 0.1.2-beta.0 → 0.1.4-beta.0

package/studio/lifecycle-errors.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Error taxonomy for {@link HonuaStudioLifecycleClient}.
+ *
+ * Every non-2xx response from the Studio package lifecycle API
+ * (`/api/v{version}/studio`) is either a handler-generated client error
+ * (`400`/`404`/`409`) or a caught internal failure (`500`), and both use
+ * RFC 7807 problem details with `type: "https://honua.io/problems/studio"`
+ * (see `docs/internal/admin-api/studio-package-lifecycle.md` in
+ * `honua-server`). {@link HonuaStudioError} normalizes both into one typed
+ * shape so callers branch on `.code` instead of parsing HTTP status numbers
+ * or problem-detail strings.
+ *
+ * `generation-conflict` is a distinct discriminant (not folded into a
+ * generic `"conflict"` bucket) because it is the one Studio failure mode the
+ * SDK expects callers to *recover from automatically* — reload the draft and
+ * retry — rather than surface to a user. Use
+ * {@link isHonuaStudioGenerationConflict} to branch on it without comparing
+ * `.code` strings directly.
+ *
+ * This module intentionally does not join the central `HonuaSdkError`
+ * registry (`src/core/error-code-registry.ts`): `studio` is an
+ * `@experimental`, not-yet-semver-covered domain, matching the existing
+ * `HonuaCollaborationError` (`src/collaboration/errors.ts`) precedent for
+ * experimental-domain errors pending a scoped migration.
+ *
+ * @module
+ */
+/**
+ * Discriminant classifying a {@link HonuaStudioError}. Derived from the HTTP
+ * status code of the failed response:
+ *
+ * - `validation` — `400`, request or envelope failed validation.
+ * - `not-found` — `404`, the draft/version/content item does not exist (or,
+ *   per the API doc, is not reachable from the given `itemId`/`versionId`
+ *   pair — cross-item ids are treated as not found).
+ * - `generation-conflict` — `409`, the draft's server-managed `generation`
+ *   changed since the caller last read it (`PUT /package-drafts/{draftId}`
+ *   optimistic-concurrency check). Reload the draft and retry.
+ * - `internal` — `500`, a caught internal failure.
+ * - `unknown` — any other status the doc does not enumerate.
+ *
+ * @experimental
+ */
+export type HonuaStudioProblemKind = "validation" | "not-found" | "generation-conflict" | "internal" | "unknown";
+/**
+ * RFC 7807 problem-details body returned by the Studio package lifecycle API.
+ * `type` is `"https://honua.io/problems/studio"` on every documented error
+ * response; `code` and `errors` are optional server-supplied extensions.
+ *
+ * @experimental
+ */
+export interface HonuaStudioProblemDetails {
+    readonly type?: string;
+    readonly title?: string;
+    readonly status?: number;
+    readonly detail?: string;
+    readonly instance?: string;
+    readonly code?: string;
+    readonly errors?: Record<string, readonly string[]>;
+    readonly [extra: string]: unknown;
+}
+/** Canonical RFC 7807 `type` URI the Studio lifecycle API uses for every problem response. */
+export declare const HONUA_STUDIO_PROBLEM_TYPE: "https://honua.io/problems/studio";
+/**
+ * Thrown by every {@link HonuaStudioLifecycleClient} method when the server
+ * returns a non-2xx response. Carries the raw HTTP `statusCode`, the
+ * classified `.code` discriminant (see {@link HonuaStudioProblemKind}), and
+ * the parsed RFC 7807 `.problem` body when the response was problem+json.
+ *
+ * @experimental
+ */
+export declare class HonuaStudioError extends Error {
+    readonly code: HonuaStudioProblemKind;
+    readonly statusCode: number;
+    readonly problem: HonuaStudioProblemDetails | undefined;
+    constructor(code: HonuaStudioProblemKind, statusCode: number, message: string, problem?: HonuaStudioProblemDetails, options?: {
+        readonly cause?: unknown;
+    });
+}
+/** Type guard for {@link HonuaStudioError}. */
+export declare function isHonuaStudioError(error: unknown): error is HonuaStudioError;
+/**
+ * True only for the `409` optimistic-concurrency discriminant — the draft's
+ * `generation` changed since the caller last read it. Callers should reload
+ * the draft (`drafts.get`) and retry the `PUT` with the fresh `generation`
+ * rather than surface this as a hard failure.
+ */
+export declare function isHonuaStudioGenerationConflict(error: unknown): error is HonuaStudioError;
+/** @internal Classify an HTTP status code into a {@link HonuaStudioProblemKind}. */
+export declare function classifyStudioProblemStatus(statusCode: number): HonuaStudioProblemKind;
+//# sourceMappingURL=lifecycle-errors.d.ts.map

package/studio/lifecycle-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-errors.d.ts","sourceRoot":"","sources":["../../../src/studio/lifecycle-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,WAAW,GAAG,qBAAqB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjH;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACpD,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,8FAA8F;AAC9F,eAAO,MAAM,yBAAyB,EAAG,kCAA2C,CAAC;AAErF;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,sBAAsB,CAAC;IAC7C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,EAAE,yBAAyB,GAAG,SAAS,CAAC;gBAG7D,IAAI,EAAE,sBAAsB,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,yBAAyB,EACnC,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAQ7C;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAEzF;AAED,oFAAoF;AACpF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAatF"}

package/studio/lifecycle-errors.js

@@ -0,0 +1,77 @@
+/**
+ * Error taxonomy for {@link HonuaStudioLifecycleClient}.
+ *
+ * Every non-2xx response from the Studio package lifecycle API
+ * (`/api/v{version}/studio`) is either a handler-generated client error
+ * (`400`/`404`/`409`) or a caught internal failure (`500`), and both use
+ * RFC 7807 problem details with `type: "https://honua.io/problems/studio"`
+ * (see `docs/internal/admin-api/studio-package-lifecycle.md` in
+ * `honua-server`). {@link HonuaStudioError} normalizes both into one typed
+ * shape so callers branch on `.code` instead of parsing HTTP status numbers
+ * or problem-detail strings.
+ *
+ * `generation-conflict` is a distinct discriminant (not folded into a
+ * generic `"conflict"` bucket) because it is the one Studio failure mode the
+ * SDK expects callers to *recover from automatically* — reload the draft and
+ * retry — rather than surface to a user. Use
+ * {@link isHonuaStudioGenerationConflict} to branch on it without comparing
+ * `.code` strings directly.
+ *
+ * This module intentionally does not join the central `HonuaSdkError`
+ * registry (`src/core/error-code-registry.ts`): `studio` is an
+ * `@experimental`, not-yet-semver-covered domain, matching the existing
+ * `HonuaCollaborationError` (`src/collaboration/errors.ts`) precedent for
+ * experimental-domain errors pending a scoped migration.
+ *
+ * @module
+ */
+/** Canonical RFC 7807 `type` URI the Studio lifecycle API uses for every problem response. */
+export const HONUA_STUDIO_PROBLEM_TYPE = "https://honua.io/problems/studio";
+/**
+ * Thrown by every {@link HonuaStudioLifecycleClient} method when the server
+ * returns a non-2xx response. Carries the raw HTTP `statusCode`, the
+ * classified `.code` discriminant (see {@link HonuaStudioProblemKind}), and
+ * the parsed RFC 7807 `.problem` body when the response was problem+json.
+ *
+ * @experimental
+ */
+export class HonuaStudioError extends Error {
+    code;
+    statusCode;
+    problem;
+    constructor(code, statusCode, message, problem, options = {}) {
+        super(message, "cause" in options ? { cause: options.cause } : undefined);
+        this.name = "HonuaStudioError";
+        this.code = code;
+        this.statusCode = statusCode;
+        this.problem = problem;
+    }
+}
+/** Type guard for {@link HonuaStudioError}. */
+export function isHonuaStudioError(error) {
+    return error instanceof HonuaStudioError;
+}
+/**
+ * True only for the `409` optimistic-concurrency discriminant — the draft's
+ * `generation` changed since the caller last read it. Callers should reload
+ * the draft (`drafts.get`) and retry the `PUT` with the fresh `generation`
+ * rather than surface this as a hard failure.
+ */
+export function isHonuaStudioGenerationConflict(error) {
+    return isHonuaStudioError(error) && error.code === "generation-conflict";
+}
+/** @internal Classify an HTTP status code into a {@link HonuaStudioProblemKind}. */
+export function classifyStudioProblemStatus(statusCode) {
+    switch (statusCode) {
+        case 400:
+            return "validation";
+        case 404:
+            return "not-found";
+        case 409:
+            return "generation-conflict";
+        case 500:
+            return "internal";
+        default:
+            return "unknown";
+    }
+}

package/studio/lifecycle-types.d.ts

@@ -0,0 +1,321 @@
+/**
+ * Typed request/response models for the Studio package lifecycle API
+ * (`/api/v{version}/studio` in `honua-server`), backing
+ * {@link HonuaStudioLifecycleClient}.
+ *
+ * These mirror the DTOs documented in
+ * `docs/internal/admin-api/studio-package-lifecycle.md` (`honua-server`):
+ * `Honua.Core.Features.Studio.Domain` for the entities and
+ * `Honua.Server.Features.Studio.Models` for the request shapes. Every
+ * interface keeps an open `[extra: string]: unknown` index signature so
+ * additive server fields do not break existing clients, and reuses the
+ * existing {@link StudioPackageDiagnostic} / {@link HonuaStudioPackageFamily}
+ * projections from `./validation.js` / `./types.js` rather than redeclaring
+ * them.
+ *
+ * @experimental Not yet covered by the SDK's semver contract — these shapes
+ *   may change in any minor release prior to `1.0.0`, and until a dedicated
+ *   Studio OpenAPI snapshot is published this doc and the source-generated
+ *   JSON contexts are `honua-server`'s only contract reference.
+ * @module
+ */
+import type { HonuaStudioPackageFamily } from "./types.js";
+import type { StudioPackageDiagnostic } from "./validation.js";
+/**
+ * Successful `ApiResponse<T>` envelope every Studio lifecycle endpoint wraps
+ * its payload in. The source-generated JSON context omits `null`-valued
+ * properties, so `message` is present only on responses that carry one (for
+ * example the draft-delete response).
+ *
+ * @experimental
+ */
+export interface StudioApiResponse<T> {
+    readonly success: true;
+    readonly data: T;
+    readonly timestamp: string;
+    readonly message?: string;
+}
+/** Depth of validation a package family currently receives. */
+export type StudioValidationDepth = "full" | "envelope" | (string & {});
+/** Deployment persistence backing for Studio lifecycle data. */
+export type StudioPersistenceMode = "postgres" | "in-memory" | (string & {});
+/** Support level a deployment advertises for a package family. */
+export type StudioPackageFamilySupportLevel = "supported" | "limited" | (string & {});
+/**
+ * One package-family-scoped operation name as returned by
+ * `GET /package-families`. `draft.delete` is available on every family but,
+ * per the API doc, is not itself advertised as a per-family capability
+ * operation.
+ */
+export type StudioPackageFamilyOperation = "draft.create" | "draft.read" | "draft.update" | "validate" | "preview-plan" | "content-version.create" | "content-version.read" | "content-version.compare" | "publish-request.create" | "reopen" | "rollback" | (string & {});
+/** Capability descriptor for one Studio package family. */
+export interface StudioPackageFamilyCapability {
+    readonly family: HonuaStudioPackageFamily | (string & {});
+    readonly schemaVersion: string;
+    readonly format: string;
+    readonly supportLevel: StudioPackageFamilySupportLevel;
+    readonly supportedOperations: readonly StudioPackageFamilyOperation[];
+    readonly validationDepth: StudioValidationDepth;
+    readonly limitations?: readonly string[];
+    readonly maxPackageBytes: number;
+    readonly durable: boolean;
+    readonly persistenceMode?: StudioPersistenceMode;
+    readonly [extra: string]: unknown;
+}
+/** `GET /package-families` response payload — every registered package family. */
+export interface StudioPackageFamilyCapabilities {
+    readonly families: readonly StudioPackageFamilyCapability[];
+    readonly [extra: string]: unknown;
+}
+/** Reference to a source a package envelope binds to. */
+export interface StudioBindingRef {
+    readonly key: string;
+    readonly kind: string;
+    readonly ref: string;
+    readonly crs?: string;
+    readonly srid?: number;
+    readonly requiredPermissions?: readonly string[];
+    readonly [extra: string]: unknown;
+}
+/** Dependency lineage entry (e.g. on a content item's version) carried on an envelope. */
+export interface StudioDependencyRef {
+    readonly kind: string;
+    readonly ref: string;
+    readonly versionId?: string;
+    readonly required?: boolean;
+    readonly [extra: string]: unknown;
+}
+/** Provenance lineage entry (e.g. the prompt or plan that generated the package). */
+export interface StudioProvenanceRef {
+    readonly kind: string;
+    readonly ref: string;
+    readonly rel: string;
+    readonly [extra: string]: unknown;
+}
+/** Route/visibility a package declares it wants to publish to. */
+export interface StudioPublicationIntent {
+    readonly route?: string;
+    readonly visibility?: "private" | "organization" | "public" | (string & {});
+    readonly [extra: string]: unknown;
+}
+/** `StudioValidationSummary.status` — see the API doc's "Validation And Preview" section. */
+export type StudioValidationStatus = "not-validated" | "valid" | "warning" | "invalid";
+/**
+ * Validation summary persisted on a draft or captured on a content version.
+ * Returned directly by `POST /package-drafts/{draftId}/validate` and embedded
+ * in every {@link StudioPackageEnvelope.validation}.
+ */
+export interface StudioValidationSummary {
+    readonly status: StudioValidationStatus;
+    readonly diagnostics?: readonly StudioPackageDiagnostic[];
+    readonly unsupportedCapabilities?: readonly string[];
+    readonly generatedAt?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * `StudioPackageEnvelope` — the wire shape shared by every package family.
+ * `schemaVersion` and `format` must match the descriptor
+ * {@link StudioPackageFamilyCapability} returns for `family` from
+ * `GET /package-families`. `body` is deliberately generic: for `map`/`app` it
+ * is validated against the existing `honua_map_package.v1` /
+ * `honua_app_package.v1` models (pass `HonuaMapPackage` /
+ * `HonuaGeneratedAppPackage` as `TBody` for full typing); every other family
+ * currently receives only envelope-level validation.
+ *
+ * @experimental
+ */
+export interface StudioPackageEnvelope<TBody = Record<string, unknown>> {
+    readonly family: HonuaStudioPackageFamily | (string & {});
+    readonly schemaVersion: string;
+    readonly format: string;
+    readonly bindings?: readonly StudioBindingRef[];
+    readonly dependencies?: readonly StudioDependencyRef[];
+    readonly validation?: StudioValidationSummary;
+    readonly publicationIntent?: StudioPublicationIntent;
+    readonly provenance?: readonly StudioProvenanceRef[];
+    readonly body: TBody;
+}
+/** A mutable Studio package draft. `generation` increments on every successful `PUT`. */
+export interface StudioPackageDraft {
+    readonly draftId: string;
+    readonly itemId: string;
+    readonly family: HonuaStudioPackageFamily | (string & {});
+    readonly packageKey: string;
+    readonly workspaceId?: string;
+    readonly ownerId?: string;
+    readonly generation: number;
+    readonly envelope: StudioPackageEnvelope;
+    readonly baseVersionId?: string;
+    readonly createdAt?: string;
+    readonly updatedAt?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * `POST /package-drafts` request body. `packageKey` is trimmed, limited to
+ * 200 characters, and may contain only letters, numbers, dash, underscore, or
+ * dot. Omit `itemId` to let the server allocate a new Studio content item;
+ * omit `ownerId` to use the authenticated actor id.
+ */
+export interface StudioPackageDraftCreateRequest {
+    readonly packageKey: string;
+    readonly workspaceId?: string;
+    readonly ownerId?: string;
+    readonly itemId?: string;
+    readonly envelope: StudioPackageEnvelope;
+}
+/**
+ * `PUT /package-drafts/{draftId}` request body. `workspaceId` uses replace
+ * semantics: omit it or send an empty string to clear the stored workspace.
+ * Omit `ownerId` to preserve the existing owner. Omit `generation` to update
+ * from the current server-loaded generation (last-write-wins); include the
+ * last-seen `generation` for strict optimistic-concurrency protection — a
+ * stale value throws {@link HonuaStudioError} with
+ * `code: "generation-conflict"` (`409`).
+ */
+export interface StudioPackageDraftReplaceRequest {
+    readonly packageKey: string;
+    readonly workspaceId?: string;
+    readonly ownerId?: string;
+    readonly envelope: StudioPackageEnvelope;
+    readonly generation?: number;
+}
+/**
+ * `POST /package-drafts/{draftId}/preview-plan` response. `gp`, `etl`, and
+ * `workflow` drafts return `requiresJob: true, synchronous: false`; every
+ * other family returns `requiresJob: false, synchronous: true`.
+ */
+export interface StudioPreviewPlan {
+    readonly requiresJob: boolean;
+    readonly synchronous: boolean;
+    readonly steps: readonly string[];
+    readonly [extra: string]: unknown;
+}
+/**
+ * An immutable Studio content version. Never edited in place — call
+ * `versions.reopen` to continue work as a new mutable draft.
+ */
+export interface StudioContentVersion {
+    readonly versionId: string;
+    readonly itemId: string;
+    readonly family: HonuaStudioPackageFamily | (string & {});
+    readonly versionNumber: number;
+    readonly contentHash: string;
+    readonly envelope: StudioPackageEnvelope;
+    readonly validation?: StudioValidationSummary;
+    readonly dependencies?: readonly StudioDependencyRef[];
+    readonly provenance?: readonly StudioProvenanceRef[];
+    readonly baseDraftId?: string;
+    readonly createdAt?: string;
+    readonly createdBy?: string;
+    readonly [extra: string]: unknown;
+}
+/** `GET /content-items/{itemId}/versions` response — empty `versions` when none exist. */
+export interface StudioContentVersionListResponse {
+    readonly itemId: string;
+    readonly versions: readonly StudioContentVersion[];
+    readonly [extra: string]: unknown;
+}
+/** `POST /content-items/{itemId}/version-comparisons` request body. */
+export interface StudioVersionComparisonRequest {
+    readonly baseVersionId: string;
+    readonly compareVersionId: string;
+}
+/** Added/removed/unchanged partition for one comparison facet. */
+export interface StudioVersionComparisonDiff<T> {
+    readonly added?: readonly T[];
+    readonly removed?: readonly T[];
+    readonly unchanged?: readonly T[];
+    readonly [extra: string]: unknown;
+}
+/**
+ * `POST /content-items/{itemId}/version-comparisons` response — compares two
+ * immutable versions by content hash, dependencies, validation, and
+ * provenance. The exact diff shape is not yet OpenAPI-pinned server-side;
+ * the documented facets are typed here and every field keeps its own open
+ * index signature so an unrecognized server addition still round-trips.
+ */
+export interface StudioVersionComparison {
+    readonly itemId: string;
+    readonly baseVersionId: string;
+    readonly compareVersionId: string;
+    readonly contentHashChanged: boolean;
+    readonly dependencies?: StudioVersionComparisonDiff<StudioDependencyRef>;
+    readonly provenance?: StudioVersionComparisonDiff<StudioProvenanceRef>;
+    readonly validation?: {
+        readonly base?: StudioValidationSummary;
+        readonly compare?: StudioValidationSummary;
+        readonly [extra: string]: unknown;
+    };
+    readonly [extra: string]: unknown;
+}
+/**
+ * `pending` is reserved for later asynchronous publication execution and is
+ * not emitted by the API service today.
+ */
+export type StudioPublicationRequestStatus = "accepted" | "rejected" | "pending" | (string & {});
+/**
+ * `POST /content-items/{itemId}/versions/{versionId}/publish-requests`
+ * request body. `intent` overrides the version envelope's
+ * `publicationIntent` when supplied; an invalid override fails with `400`
+ * before a request is persisted. `warningAcknowledgment` is optional audit
+ * text for `warning`-status versions.
+ */
+export interface StudioPublicationRequestInput {
+    readonly intent?: StudioPublicationIntent;
+    readonly warningAcknowledgment?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * A persisted publication request. Versions whose captured validation status
+ * is `invalid` still produce a durable request with `status: "rejected"` and
+ * do not move the published pointer; `valid`/`warning` versions are
+ * `"accepted"` and do move it.
+ */
+export interface StudioPublicationRequest {
+    readonly requestId: string;
+    readonly itemId: string;
+    readonly versionId: string;
+    readonly status: StudioPublicationRequestStatus;
+    readonly intent?: StudioPublicationIntent;
+    readonly createdAt?: string;
+    readonly createdBy?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * `POST /content-items/{itemId}/versions/{versionId}/reopen` request body.
+ * No fields are documented as required; this is intentionally open for a
+ * future owner/workspace override.
+ */
+export interface StudioReopenVersionRequest {
+    readonly ownerId?: string;
+    readonly workspaceId?: string;
+    readonly [extra: string]: unknown;
+}
+/** Which content-item pointer(s) a rollback request moves. */
+export type StudioRollbackPointer = "current" | "published" | "both";
+/** `POST /content-items/{itemId}/rollback-requests` request body. */
+export interface StudioRollbackRequestInput {
+    readonly versionId: string;
+    readonly pointer: StudioRollbackPointer;
+    readonly message?: string;
+    readonly [extra: string]: unknown;
+}
+/** The Studio content item's current/published version pointers. */
+export interface StudioContentItemPointers {
+    readonly itemId: string;
+    readonly currentVersionId?: string;
+    readonly publishedVersionId?: string;
+    readonly [extra: string]: unknown;
+}
+/** A persisted rollback request, carrying the resulting content-item pointers. */
+export interface StudioRollbackRequest {
+    readonly requestId: string;
+    readonly itemId: string;
+    readonly versionId: string;
+    readonly pointer: StudioRollbackPointer;
+    readonly pointers: StudioContentItemPointers;
+    readonly createdAt?: string;
+    readonly createdBy?: string;
+    readonly [extra: string]: unknown;
+}
+//# sourceMappingURL=lifecycle-types.d.ts.map

package/studio/lifecycle-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-types.d.ts","sourceRoot":"","sources":["../../../src/studio/lifecycle-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExE,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE7E,kEAAkE;AAClE,MAAM,MAAM,+BAA+B,GAAG,WAAW,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GACpC,cAAc,GACd,YAAY,GACZ,cAAc,GACd,UAAU,GACV,cAAc,GACd,wBAAwB,GACxB,sBAAsB,GACtB,yBAAyB,GACzB,wBAAwB,GACxB,QAAQ,GACR,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,2DAA2D;AAC3D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,+BAA+B,CAAC;IACvD,QAAQ,CAAC,mBAAmB,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACtE,QAAQ,CAAC,eAAe,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACjD,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,kFAAkF;AAClF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC5D,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAMD,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,0FAA0F;AAC1F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,kEAAkE;AAClE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC5E,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,6FAA6F;AAC7F,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvF;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1D,QAAQ,CAAC,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAMD,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAMD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,0FAA0F;AAC1F,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,uEAAuE;AACvE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,kEAAkE;AAClE,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,2BAA2B,CAAC,mBAAmB,CAAC,CAAC;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,2BAA2B,CAAC,mBAAmB,CAAC,CAAC;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,uBAAuB,CAAC;QACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;QAC3C,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;KACnC,CAAC;IACF,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAMD;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEjG;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAMD;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAMD,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAErE,qEAAqE;AACrE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,oEAAoE;AACpE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,kFAAkF;AAClF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC"}

package/studio/lifecycle-types.js

@@ -0,0 +1,22 @@
+/**
+ * Typed request/response models for the Studio package lifecycle API
+ * (`/api/v{version}/studio` in `honua-server`), backing
+ * {@link HonuaStudioLifecycleClient}.
+ *
+ * These mirror the DTOs documented in
+ * `docs/internal/admin-api/studio-package-lifecycle.md` (`honua-server`):
+ * `Honua.Core.Features.Studio.Domain` for the entities and
+ * `Honua.Server.Features.Studio.Models` for the request shapes. Every
+ * interface keeps an open `[extra: string]: unknown` index signature so
+ * additive server fields do not break existing clients, and reuses the
+ * existing {@link StudioPackageDiagnostic} / {@link HonuaStudioPackageFamily}
+ * projections from `./validation.js` / `./types.js` rather than redeclaring
+ * them.
+ *
+ * @experimental Not yet covered by the SDK's semver contract — these shapes
+ *   may change in any minor release prior to `1.0.0`, and until a dedicated
+ *   Studio OpenAPI snapshot is published this doc and the source-generated
+ *   JSON contexts are `honua-server`'s only contract reference.
+ * @module
+ */
+export {};

package/webmap/convert-label.js

@@ -45,7 +45,6 @@ export function convertLabelingInfo(labelClasses, sourceId, baseLayerId, warn) {
     return layers;
 }
 const FEATURE_FIELD_RE = /^\$feature\.(\w+)$/;
-const FEATURE_FIELD_GLOBAL_RE = /\$feature\.(\w+)/g;
 function parseLabelExpression(lc, warn) {
     // Prefer labelExpressionInfo (Arcade-based)
     if (lc.labelExpressionInfo?.expression) {

package/webmap/convert-symbol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert-symbol.d.ts","sourceRoot":"","sources":["../../../src/webmap/convert-symbol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,SAAS,EAKT,YAAY,EAEb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAM/E;AAaD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAGxF;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,IAAI,EAAE,gBAAgB,GACrB,sBAAsB,GAAG,SAAS,CAkBpC"}
+{"version":3,"file":"convert-symbol.d.ts","sourceRoot":"","sources":["../../../src/webmap/convert-symbol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,SAAS,EAKT,YAAY,EAEb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAM/E;AAaD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAGxF;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,IAAI,EAAE,gBAAgB,GACrB,sBAAsB,GAAG,SAAS,CAkBpC"}