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

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":"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"}

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"}