@nexia/sdk 0.8.14 → 0.8.16

package/changelog/0.8.15/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.15
+date: 2026-10-28
+title: Approval receipt and record print contracts
+description: Distinguish an accepted approval submission from a case and declare record print layouts.
+---
+
+React SDK 0.8.15 lets an approval business form return either `caseId` or `submissionId`. A `submissionId` means the host accepted work for later processing; it does not mean an Approval Case exists yet. Handle both results when enabling asynchronous approval with matching Core and runtime support. See the [approval contract guide](https://developers.nexia.to/docs/app-sdk-approval-contracts).
+
+Resource table and transfer action props also accept `recordPrint` for an optional per-record print layout. Adopt the matching Core host before using it. See the [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts).

package/changelog/0.8.15/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.15
+date: 2026-10-28
+title: 결재 접수 영수증과 레코드 인쇄 계약
+description: 접수된 결재 요청과 결재 건을 구분하고 레코드별 인쇄 구성을 선언합니다.
+---
+
+React SDK 0.8.15에서 결재 업무 폼은 `caseId` 또는 `submissionId`를 반환할 수 있습니다. `submissionId`는 호스트가 나중에 처리할 작업을 접수했다는 뜻이며, 아직 결재 건이 생성됐다는 뜻은 아닙니다. 비동기 결재를 활성화할 때는 대응하는 Core·런타임과 함께 두 결과를 처리하세요. [결재 계약 안내](https://developers.nexia.to/ko/docs/app-sdk-approval-contracts)를 참고하세요.
+
+리소스 표와 전송 작업 속성에 선택적인 레코드별 인쇄 구성 `recordPrint`가 추가되었습니다. 사용 전에 대응하는 Core 호스트를 적용하세요. [프런트엔드 호스트 안내](https://developers.nexia.to/ko/docs/app-sdk-frontend-host-contracts)를 참고하세요.

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/approval.d.ts

@@ -132,9 +132,14 @@ export interface ApprovalBusinessFormController {
 export interface ApprovalBusinessFormDraftResult {
     appDraftRef: string;
 }
-export interface ApprovalBusinessFormSubmitResult {
+/** A receipt is durable acceptance, not a submitted case. */
+export type ApprovalBusinessFormSubmitResult = {
     caseId: string;
-}
+    submissionId?: never;
+} | {
+    submissionId: string;
+    caseId?: never;
+};
 export interface ApprovalBusinessFormTemplate {
     key: string;
     version: number;

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

@@ -118,6 +118,11 @@ export interface NxResourceImportDialogProps {
 }
 /** Host-owned Resource Transfer actions for list and management surfaces. */
 export interface NxResourceTransferActionsProps {
+    recordPrint?: {
+        label: string;
+        title: string;
+        columnKeys: readonly string[];
+    };
     transferMeta: ResourceTransferMeta | null | undefined;
     onImported: () => void | Promise<void>;
     translationPrefix?: string;

package/dist/shell.d.ts

@@ -457,6 +457,12 @@ export interface ResourceTableProps<T> {
     filters?: ResourceListFilters;
     onFiltersChange?: (next: ResourceListFilters) => void;
     transferMeta?: ResourceTransferMeta | null;
+    /** Offer a per-record print layout alongside the selected-column list layout. */
+    recordPrint?: {
+        label: string;
+        title: string;
+        columnKeys: readonly string[];
+    };
     onTransferImported?: () => void | Promise<void>;
     pagination?: {
         current_page: number;

package/package.json

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