@nexia/sdk 0.8.11 → 0.8.12

package/changelog/0.8.12/en.md

@@ -0,0 +1,13 @@
+---
+status: published
+version: 0.8.12
+date: 2026-10-23
+title: Import progress timestamps
+description: Observe phase start and the last work response in background imports.
+---
+
+# Import progress timestamps
+
+Background migration `onProgress` callbacks can now receive an optional third argument with `phase_started_at` and `last_activity_at`. Existing two-argument callbacks remain compatible; missing timestamps mean the host has no observation. Activity is not a completed-row count.
+
+[Frontend migration contracts](https://github.com/nexia-cloud-os/app-sdk/blob/develop/packages/react/src/data-migration.ts)

package/changelog/0.8.12/ko.md

@@ -0,0 +1,13 @@
+---
+status: published
+version: 0.8.12
+date: 2026-10-23
+title: 가져오기 진행 시각
+description: 백그라운드 가져오기의 단계 시작과 마지막 작업 응답 시각을 확인합니다.
+---
+
+# 가져오기 진행 시각
+
+백그라운드 가져오기 `onProgress` 콜백의 선택적 세 번째 인자로 `phase_started_at`과 `last_activity_at`을 받을 수 있습니다. 기존 두 인자 콜백도 그대로 동작하며, 시각이 없으면 호스트에서 확인한 정보가 없는 상태입니다. 작업 응답 시각은 처리 완료 행 수를 뜻하지 않습니다.
+
+[프런트엔드 가져오기 계약](https://github.com/nexia-cloud-os/app-sdk/blob/develop/packages/react/src/data-migration.ts)

package/dist/data-migration.d.ts

@@ -9,6 +9,10 @@ export interface DataMigrationBackgroundOperation<TResult = Readonly<Record<stri
     validation_errors?: Record<string, string[]>;
     progress?: number;
     phase?: string;
+    /** Last actual phase transition, never the status polling time. */
+    phase_started_at?: string | null;
+    /** Last successful work callback; not a completed-row count. */
+    last_activity_at?: string | null;
 }
 /** Initial response when a migration operation continues on the queue. */
 export interface DataMigrationOperationAccepted {
@@ -21,7 +25,7 @@ export interface DataMigrationOperationWaitOptions {
     signal?: AbortSignal;
     /** Keep an already submitted operation observable across route unmounts. */
     continueInBackground?: boolean;
-    onProgress?: (progress: number, phase: string | null) => void;
+    onProgress?: (progress: number, phase: string | null, details?: Pick<DataMigrationBackgroundOperation, 'phase_started_at' | 'last_activity_at'>) => void;
 }
 export interface DataMigrationBackgroundOperationClient {
     wait<TResult>(accepted: DataMigrationOperationAccepted | string, options?: DataMigrationOperationWaitOptions): Promise<TResult>;

package/dist/host.js

@@ -177,7 +177,8 @@ function useBackgroundOperationClient(client) {
         try {
             for (;;) {
                 const operation = (await client.get(backgroundOperationClientPath(statusUrl), { signal: controller.signal })).data;
-                options.onProgress?.(typeof operation.progress === 'number' ? operation.progress : 0, typeof operation.phase === 'string' ? operation.phase : null);
+                options.onProgress?.(typeof operation.progress === 'number' ? operation.progress : 0, typeof operation.phase === 'string' ? operation.phase : null, ...(operation.phase_started_at || operation.last_activity_at ? [{ phase_started_at: operation.phase_started_at,
+                        ...(operation.last_activity_at ? { last_activity_at: operation.last_activity_at } : {}) }] : []));
                 if (operation.status === 'completed') {
                     if (operation.result === undefined) {
                         throw new Error('Completed data migration operation has no result.');

package/package.json

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