@nexia/sdk 0.8.15 → 0.8.16

package/changelog/0.8.16/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.16
+date: 2026-10-28
+title: Read-only POST header declaration
+description: Export NEXIA_READ_ONLY_HEADER for read-only mutation-verb requests.
+---
+
+React SDK 0.8.16 exports `NEXIA_READ_ONLY_HEADER` (`'X-Nexia-Read-Only'`) from `@nexia/sdk` and `@nexia/sdk/host`. App frontends can pass this request header on query-only or preview POST calls to declare read semantics, enforce read budgets, and fail immediately upon network interruption instead of waiting in unconfirmed write recovery. See the [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts).

package/changelog/0.8.16/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.16
+date: 2026-10-28
+title: 읽기 전용 POST 헤더 선언
+description: 읽기 목적 변이 요청을 위한 NEXIA_READ_ONLY_HEADER를 내보냅니다.
+---
+
+React SDK 0.8.16에서 `NEXIA_READ_ONLY_HEADER`(`'X-Nexia-Read-Only'`)를 `@nexia/sdk` 및 `@nexia/sdk/host`로부터 내보냅니다. App 프런트엔드는 상태 변경이 없는 순수 조회나 미리보기 목적의 POST 호출 시 이 요청 헤더를 전달하여 읽기 의도를 선언할 수 있으며, 읽기 예산 적용과 통신 단절 시 미확인 쓰기 복구 대기 없이 즉시 실패하도록 처리할 수 있습니다. [프런트엔드 호스트 안내](https://developers.nexia.to/ko/docs/app-sdk-frontend-host-contracts)를 참고하세요.

package/dist/host.d.ts

@@ -371,6 +371,11 @@ export declare function configureNexiaAppFrontendHost(bindings: NexiaAppFrontend
 export declare function openFile(href: string, options?: OpenFileOptions): Promise<void>;
 /** Axios-compatible host client carrying the active shell CSRF configuration. */
 export declare const api: AxiosInstance;
+/**
+ * Header sent on read-only mutation-verb requests (e.g. POST previews, queries)
+ * to bypass unconfirmed write recovery and enforce read budgets.
+ */
+export declare const NEXIA_READ_ONLY_HEADER = "X-Nexia-Read-Only";
 /**
  * Polls Core's standard background-operation endpoint. By default unmounting
  * cancels the wait; callers retaining a checkpoint can explicitly keep waiting.

package/dist/host.js

@@ -104,6 +104,11 @@ export const api = new Proxy(apiProxyTarget, {
         return typeof value === 'function' ? value.bind(client) : value;
     },
 });
+/**
+ * Header sent on read-only mutation-verb requests (e.g. POST previews, queries)
+ * to bypass unconfirmed write recovery and enforce read budgets.
+ */
+export const NEXIA_READ_ONLY_HEADER = 'X-Nexia-Read-Only';
 function operationFailureMessage(operation) {
     const validationMessage = operation.validation_errors
         ? Object.values(operation.validation_errors)

package/dist/index.d.ts

@@ -37,7 +37,7 @@ export { APPROVAL_STATES, APPROVAL_STEP_KINDS } from "./approval";
 export type { BpmnEditorDocument, BpmnEditorElement, BpmnEditorNodeType, BpmnEditorProcess, DmnEditorDocument, DmnEditorHitPolicy, DmnEditorInputClause, DmnEditorOutputClause, DmnEditorRule, DmnEditorValueType, ProcessUserTaskFormController, ProcessUserTaskFormRegistrar, ProcessUserTaskFormRegistration, ProcessUserTaskFormRegistry, ProcessUserTaskFormSlotPropsV1, ProcessUserTaskFormWidgetLoader, ProcessUserTaskResourceRef, } from "./process";
 export { DMN_EDITOR_HIT_POLICIES } from "./process";
 export type { AppRouteFrameProps, AppRoutePrefetchContext, AppRoutePrefetcher, AutoRegisterPackageSurfacesOptions, PackageSurfaceLoader, PackageSurfaceOverride, PackageSurfaceOverrideRegistration, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, ListLocateRecord, MessageApi, MutationFormError, NxCanonicalRoutePaneProps, NxActionKind, NxIconButtonProps, NxComboboxOption, NxComboboxProps, NxRefreshControlProps, NxColumnBrowserLabels, NxColumnBrowserProps, NxColumnNode, NxColumnPickerLabels, NxColumnPickerProps, NxDatePickerLabels, NxDatePickerProps, NxDateRangePickerProps, NxDateRangeValue, NxDropdownMenuItem, NxHelpTooltipProps, InsightFilterControls, InsightFilterState, InsightQueryLike, InsightRangePreset, UseInsightFilterStateOptions, NxOverviewBandCard, NxSelectOption, NxStatDelta, NxStatDeltaDirection, NxStatDeltaTone, NxTabNavItem, NxTabNavProps, NxTooltipAlign, NxTooltipProps, NxTooltipSide, OpenResourceWorkTab, OpenResourceWorkTabOptions, ResourceCreateCompletion, ResourceCreateCompletionInput, ResourceCreateContinuationTarget, ResourceCreateReceiverRegistration, ResourceInspectorAdapter, ResourceInspectorAdapterLoader, ResourceInspectorAdapterProps, ResourceInspectorQueryProps, ResourceInspectorAdapterRegistry, ResourceInspectorPanelProps, ResourceInspectorStack, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListFilters, ResourceListFilterValue, ResourceListFooterConfig, ResourceListParams, ResourceListParamsControls, ResourceListRefreshConfig, ResourceListToolbarConfig, ResourceListToolbarMoreMenuProps, ResourceListToolbarViewOption, ResourcePrimaryCellProps, ResourceActionDescriptor, ResourceRef, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableColumn, ResourceTableAccess, ResourceTableDensity, ResourceTableProps, ResourceTableStyle, ResourceTableSummaryRow, ResourceTableSort, TabContextActionContext, TabContextActionRegistration, DraftFieldBinding, RegisterDraftActionOptions, TabContextActionResult, ResourceTextCellProps, ToastOptions, ToastSource, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, WorkSectionProps, FavoriteTarget, WorkTabRef, WorkSurfaceAction, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps, } from "./shell";
-export { FavoriteButton } from "./host";
+export { FavoriteButton, NEXIA_READ_ONLY_HEADER } from "./host";
 export type { FavoriteButtonProps } from "./host";
 export { createSpreadsheetWorkbook } from "./spreadsheet";
 export type { SpreadsheetWorkbook, SpreadsheetWorksheet, SpreadsheetCell, NxSpreadsheetEditorProps } from "./spreadsheet";

package/dist/index.js

@@ -18,7 +18,7 @@ export { HANDOFF_RESULT_STATES, isHandoffResultState, isRetryableFailure, } from
 export { isRetryableHandoffFailure } from "./handoff-result.js";
 export { APPROVAL_STATES, APPROVAL_STEP_KINDS } from "./approval.js";
 export { DMN_EDITOR_HIT_POLICIES } from "./process.js";
-export { FavoriteButton } from "./host.js";
+export { FavoriteButton, NEXIA_READ_ONLY_HEADER } from "./host.js";
 export { createSpreadsheetWorkbook } from "./spreadsheet.js";
 export { documentDataFieldIdentity } from './document-data.js';
 export { buildAppCatalogTree } from './app-catalog.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.8.15",
+    "version": "0.8.16",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",