@nexia/sdk 0.8.15 → 0.8.17

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/changelog/0.8.17/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.17
+date: 2026-10-29
+title: Table menu commands and export restrictions
+description: Extend the shared table menu and describe permission-excluded export columns.
+---
+
+React SDK 0.8.17 adds optional `ResourceListToolbarConfig.moreItems` commands to the standard table menu while retaining export, print and column controls. Transfer metadata can declare `export_restricted_columns` as `{ key, label }` entries so the host explains permission exclusions. Existing callers remain compatible; use the matching Core host and keep row/field authorization in the App export source.
+
+See the [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts) and the [package artifact](https://www.npmjs.com/package/@nexia/sdk/v/0.8.17).

package/changelog/0.8.17/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.17
+date: 2026-10-29
+title: 표 메뉴 작업과 내보내기 권한 안내
+description: 공통 표 메뉴에 작업을 추가하고 권한으로 제외한 내보내기 열을 안내합니다.
+---
+
+React SDK 0.8.17은 선택 항목 `ResourceListToolbarConfig.moreItems`로 기본 내보내기·인쇄·열 설정 메뉴에 앱 작업을 추가합니다. 전송 메타데이터의 `export_restricted_columns`에 `{ key, label }` 항목을 전달하면 호스트가 권한으로 제외된 열을 안내합니다. 기존 호출도 호환됩니다. 대응하는 Core 호스트를 함께 적용하고 앱의 내보내기 조회에서 행·필드 권한을 계속 확인하세요.
+
+[프런트엔드 호스트 가이드](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts)와 [패키지 산출물](https://www.npmjs.com/package/@nexia/sdk/v/0.8.17)을 확인하세요.

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/dist/resources/resource-transfer.d.ts

@@ -25,6 +25,11 @@ export interface ResourceTransferMeta {
         }>;
     };
     schema_hash: string;
+    /** Declared export fields omitted from schema.columns by column permissions. */
+    export_restricted_columns?: Array<{
+        key: string;
+        label: string;
+    }>;
     formats: ResourceTransferFormat[];
     export_formats?: ResourceTransferFormat[];
     import_formats?: ResourceTransferFormat[];
@@ -208,6 +213,8 @@ export interface NxDatasetImportWorkspaceProps {
         onChange: (key: string, value: string) => void;
         busy: boolean;
         previewIsCurrent: boolean;
+        /** Mark changed reference setup as needing review without starting a job. */
+        invalidatePreview: () => void;
         /** Reanalyze the uploaded file with the current App rules. */
         recheck: () => void;
     }) => ReactNode;

package/dist/shell.d.ts

@@ -382,6 +382,8 @@ export interface ResourceListToolbarConfig {
     filters?: ReactNode;
     refresh?: ReactNode;
     more?: ReactNode;
+    /** Commands appended to the standard export/print menu. */
+    moreItems?: NxDropdownMenuItem[];
     testId?: string;
 }
 export interface ResourceListRefreshConfig {

package/package.json

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