@nexia/sdk 0.8.18 → 0.8.20

package/changelog/0.8.19/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.19
+date: 2026-11-02
+title: Import review recovery actions
+description: Offer an App-owned action when import reference review is blocked.
+---
+
+React SDK 0.8.19 adds the optional `onBlockedReviewActionChange` callback to `NxDatasetImportWorkspaceProps`. An App can provide a labeled recovery action, disable it while busy, or pass `null` to hide it. Clear the action when leaving the review. Existing callers remain compatible; unresolved rows still require server validation. Adopt the matching Core host before using this callback. See the [import and export guide](https://developers.nexia.to/docs/building-apps-import-and-export) and [npm package](https://www.npmjs.com/package/@nexia/sdk/v/0.8.19).

package/changelog/0.8.19/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.19
+date: 2026-11-02
+title: 가져오기 검토 복구 동작
+description: 가져오기 기준정보 검토가 막혔을 때 앱이 복구 동작을 제공할 수 있습니다.
+---
+
+React SDK 0.8.19의 `NxDatasetImportWorkspaceProps`에 선택적 `onBlockedReviewActionChange` 콜백을 추가했습니다. 앱은 이름이 있는 복구 동작을 제공하고, 처리 중에는 비활성화하거나 `null`로 숨길 수 있습니다. 검토 화면을 떠날 때 동작을 해제하세요. 기존 호출은 호환되며 해결되지 않은 행은 여전히 서버 검증이 필요합니다. 이 콜백을 사용하기 전에 대응하는 Core 호스트를 함께 적용하세요. [가져오기·내보내기 안내](https://developers.nexia.to/docs/building-apps-import-and-export)와 [npm 패키지](https://www.npmjs.com/package/@nexia/sdk/v/0.8.19)를 참고하세요.

package/changelog/0.8.20/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.20
+date: 2026-11-03
+title: Background approval submissions
+description: Queue existing App approval requests and track their receipt.
+---
+
+React SDK 0.8.20 adds `queueApprovalRequest` to submit an existing App request for background approval and return a durable submission ID. Use a stable idempotency key and adopt the matching Core host before switching a form. A receipt confirms acceptance, not approval completion; existing submission contracts remain supported. See the [approval contracts guide](https://developers.nexia.to/docs/app-sdk-approval-contracts) and [SDK source](https://www.npmjs.com/package/@nexia/sdk/v/0.8.20).

package/changelog/0.8.20/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.20
+date: 2026-11-03
+title: 백그라운드 결재 상신
+description: 기존 App 상신 요청을 접수하고 진행 상태를 확인합니다.
+---
+
+React SDK 0.8.20은 기존 App 요청을 백그라운드 결재로 접수하고 영속 접수 ID를 반환하는 `queueApprovalRequest`를 추가합니다. 안정적인 멱등성 키를 사용하고 양식을 전환하기 전에 대응 Core 호스트를 적용하세요. 접수는 결재 완료를 뜻하지 않으며 기존 상신 계약도 유지됩니다. [전자결재 계약 안내](https://developers.nexia.to/docs/app-sdk-approval-contracts)와 [SDK 소스](https://www.npmjs.com/package/@nexia/sdk/v/0.8.20)를 참고하세요.

package/dist/approval-request.d.ts

@@ -0,0 +1,6 @@
+import { type AxiosInstance, type AxiosRequestConfig } from 'axios';
+import type { ApprovalBusinessFormSubmitResult } from './approval';
+/** Queue the whole App submission; the ordinary handler still owns business validation.
+ * Preserve the caller's idempotency key across ambiguous responses. Acceptance is not a case.
+ */
+export declare function queueApprovalRequest(api: AxiosInstance, legalEntityPublicId: string, path: string, body: Record<string, unknown>, config?: AxiosRequestConfig, appDraftRef?: string | null): Promise<ApprovalBusinessFormSubmitResult>;

package/dist/approval-request.js

@@ -0,0 +1,15 @@
+import axios, { AxiosHeaders } from 'axios';
+/** Queue the whole App submission; the ordinary handler still owns business validation.
+ * Preserve the caller's idempotency key across ambiguous responses. Acceptance is not a case.
+ */
+export async function queueApprovalRequest(api, legalEntityPublicId, path, body, config = {}, appDraftRef) {
+    const headerKey = config.headers instanceof AxiosHeaders
+        ? config.headers.get('Idempotency-Key')
+        : Object.entries(config.headers ?? {}).find(([name]) => name.toLowerCase() === 'idempotency-key')?.[1];
+    const key = headerKey ?? body.idempotency_key;
+    if (typeof key !== 'string' || !key)
+        throw new Error('Approval submission requires a stable idempotency key.');
+    const uri = axios.getUri({ url: path, baseURL: '/api', params: config.params });
+    const { data } = await api.post('/approval-submissions/requests', { uri, body, legal_entity_public_id: legalEntityPublicId, app_draft_ref: appDraftRef ?? null }, { headers: { 'Idempotency-Key': key } });
+    return { submissionId: data.submission.public_id };
+}

package/dist/index.d.ts

@@ -34,6 +34,7 @@ export { isRetryableHandoffFailure } from "./handoff-result";
 export type { HandoffResultState } from "./handoff-result";
 export type { ApprovalActor, ApprovalBodySnapshot, ApprovalBusinessFormController, ApprovalBusinessFormBinding, ApprovalBusinessFormDraftResult, ApprovalBusinessFormEntryMode, ApprovalBusinessFormRegistration, ApprovalBusinessFormRegistry, ApprovalBusinessFormSlotPropsV2, ApprovalBusinessFormSubmitError, ApprovalBusinessFormSubmitEnvelope, ApprovalBusinessFormSubmitResult, ApprovalBusinessFormSubject, ApprovalBusinessFormTemplate, ApprovalBusinessFormWidgetLoader, ApprovalCase, ApprovalCirculationRecipient, ApprovalDocument, ApprovalDocumentField, ApprovalDocumentSection, ApprovalDocumentView, ApprovalDrafterIdentity, ApprovalResourceSummary, ApprovalResourceSummaryField, ApprovalLineResolutionCategory, ApprovalLineResolutionError, ApprovalLineStages, ApprovalLineStep, ApprovalState, ApprovalStepKind, ApprovalStep, ApprovalSupplementalBodySnapshot, } from "./approval";
 export { APPROVAL_STATES, APPROVAL_STEP_KINDS } from "./approval";
+export { queueApprovalRequest } from "./approval-request";
 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";

package/dist/index.js

@@ -17,6 +17,7 @@ export { HANDOFF_RESULT_STATES, isHandoffResultState, isRetryableFailure, } from
 /** @deprecated Use isRetryableFailure. */
 export { isRetryableHandoffFailure } from "./handoff-result.js";
 export { APPROVAL_STATES, APPROVAL_STEP_KINDS } from "./approval.js";
+export { queueApprovalRequest } from "./approval-request.js";
 export { DMN_EDITOR_HIT_POLICIES } from "./process.js";
 export { FavoriteButton, NEXIA_READ_ONLY_HEADER } from "./host.js";
 export { createSpreadsheetWorkbook } from "./spreadsheet.js";

package/dist/resources/resource-transfer.d.ts

@@ -187,6 +187,12 @@ export interface NxDatasetImportWorkspaceProps {
             count: number;
         }>;
         busy: boolean;
+        /** Replace the blocked-review notice actions with an App-owned recovery action. Null hides them. */
+        onBlockedReviewActionChange?: (action: {
+            label: string;
+            disabled: boolean;
+            onClick: () => void;
+        } | null) => void;
         recheck: () => void;
         /** Open an offered reference editor after preserving the import draft. */
         createReference: (kind: string, seed: string) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.8.18",
+    "version": "0.8.20",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",
@@ -34,7 +34,7 @@
     "scripts": {
         "build": "node scripts/build.mjs",
         "prepack": "npm run build",
-        "test": "npm run build && node tests/WireValuesTest.mjs && node tests/ResourceCompositionFrontendContractsTest.mjs && node scripts/organization-target-contract.mjs && node tests/ResourceInspectorRegistrationTest.mjs && node tests/SettingsPrimitivesTest.mjs && node tests/AppServicesTest.mjs && node tests/AppStylesTest.mjs",
+        "test": "npm run build && node tests/WireValuesTest.mjs && node tests/ResourceCompositionFrontendContractsTest.mjs && node scripts/organization-target-contract.mjs && node tests/ResourceInspectorRegistrationTest.mjs && node tests/SettingsPrimitivesTest.mjs && node tests/AppServicesTest.mjs && node tests/AppStylesTest.mjs && node --test tests/ApprovalRequestTest.mjs",
         "test:wire-values": "node tests/WireValuesTest.mjs",
         "typecheck": "tsc -p tsconfig.json --noEmit",
         "test:resource-composition": "pnpm run build && node tests/ResourceCompositionFrontendContractsTest.mjs",