@nexia/sdk 0.8.19 → 0.8.21

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

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.21
+date: 2026-11-05
+title: User-task form context
+description: Show host-provided task context in process forms.
+---
+
+Process form widgets can receive optional `taskContext`, including the current sequential work item. Existing widgets remain compatible. Treat it as display context and keep server-side authorization and validation. Adopt matching Core support before relying on the field. See the [Business Process contracts](https://developers.nexia.to/docs/app-sdk-business-process-contracts) and [npm package](https://www.npmjs.com/package/@nexia/sdk/v/0.8.21).

package/changelog/0.8.21/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.21
+date: 2026-11-05
+title: 사용자 작업 폼 컨텍스트
+description: 프로세스 폼에서 호스트가 제공한 작업 컨텍스트를 표시합니다.
+---
+
+프로세스 폼 위젯은 현재 순차 작업 항목 등을 담은 선택적 `taskContext`를 받을 수 있습니다. 기존 위젯은 호환됩니다. 화면 표시용 컨텍스트로 사용하고 서버의 권한 및 입력 검사를 유지하세요. 이 필드에 의존하기 전에 대응 Core를 적용하세요. [업무 프로세스 계약](https://developers.nexia.to/ko/docs/app-sdk-business-process-contracts)과 [npm 패키지](https://www.npmjs.com/package/@nexia/sdk/v/0.8.21)를 참고하세요.

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

@@ -75,6 +75,8 @@ export interface ProcessUserTaskFormSlotPropsV1 {
         stateVersion: number;
     };
     resourceRef: ProcessUserTaskResourceRef | null;
+    /** Read-only activity data frozen by the host at task activation. */
+    taskContext?: Record<string, unknown>;
     registerController: (controller: ProcessUserTaskFormController | null) => void;
 }
 export type ProcessUserTaskFormWidgetLoader = () => Promise<{

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.8.19",
+    "version": "0.8.21",
     "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",