@nexia/sdk 0.8.5 → 0.8.7

package/changelog/0.8.6/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.6
+date: 2026-10-14
+title: Development App updates
+description: Optional loader support for updating development Apps within the Shell.
+---
+
+The optional `wrapLoader` host hook and `development_updates: 1` build metadata let compatible hosts replace development App surfaces without reloading the Shell. Existing hosts can omit the hook.
+
+Use Core 0.8.34, CLI 0.2.0-alpha.13 and sandbox-manager 0.1.0-alpha.24 or compatible later versions, then rebuild the development App with React SDK 0.8.6. Unsaved forms and pending writes defer replacement. Component-local state may reset; this is not React Fast Refresh.

package/changelog/0.8.6/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.6
+date: 2026-10-14
+title: 개발 앱 변경 반영
+description: Shell 안에서 개발 앱을 갱신하기 위한 선택적 로더 계약입니다.
+---
+
+선택적 `wrapLoader` 호스트 훅과 `development_updates: 1` 빌드 메타데이터를 추가합니다. 이를 지원하는 호스트는 Shell을 새로고침하지 않고 개발 앱 화면을 교체할 수 있습니다. 기존 호스트는 훅을 생략할 수 있습니다.
+
+Core 0.8.34, CLI 0.2.0-alpha.13, sandbox-manager 0.1.0-alpha.24 또는 호환되는 이후 버전을 함께 적용하고 React SDK 0.8.6으로 개발 앱을 다시 빌드하세요. 미저장 폼이나 처리 중인 쓰기가 있으면 교체를 보류합니다. 컴포넌트 내부 상태는 초기화될 수 있으며 React Fast Refresh 방식은 아닙니다.

package/dist/host.d.ts

@@ -325,6 +325,12 @@ export interface NexiaAppRequestServices {
     api: AxiosInstance;
     openFile: (href: string, options?: OpenFileOptions) => Promise<void>;
     wrapComponent?: <P extends object>(component: ComponentType<P>) => ComponentType<P>;
+    /** Optional development host hook. Installed/Composer loaders remain unchanged. */
+    wrapLoader?: <P extends object>(key: string, load: () => Promise<{
+        default: ComponentType<P>;
+    }>) => () => Promise<{
+        default: ComponentType<P>;
+    }>;
 }
 /** Used by the SDK build facade, not by application source. Captures a fixed owner. */
 export declare function bindNexiaAppRequestServices(appKey: string): {

package/dist/host.js

@@ -10,15 +10,18 @@ export function bindNexiaAppRequestServices(appKey) {
         throw new Error('This host does not support App-bound frontend services.');
     const services = resolve(appKey);
     const wrap = (component) => services.wrapComponent?.(component) ?? component;
-    const loader = (load) => async () => {
-        const module = await load();
-        return { ...module, default: wrap(module.default) };
+    const loader = (key, load) => {
+        const wrapped = async () => {
+            const module = await load();
+            return { ...module, default: wrap(module.default) };
+        };
+        return services.wrapLoader?.(key, wrapped) ?? wrapped;
     };
     const inspectors = {
         register(type, load) {
+            const wrapped = loader(`inspector:${type}`, load);
             host().registries.resourceInspectorAdapterRegistry.register(type, async () => {
-                const module = await load();
-                const Component = wrap(module.default);
+                const { default: Component } = await wrapped();
                 return { default: props => createElement(Component, props) };
             });
         },
@@ -26,8 +29,8 @@ export function bindNexiaAppRequestServices(appKey) {
     const approvals = {
         register(registration, legacyLoader) {
             host().registries.approvalComposerBusinessFormRegistry.register(typeof registration === 'string'
-                ? { formWidgetKey: registration, loader: loader(legacyLoader) }
-                : { ...registration, loader: loader(registration.loader) });
+                ? { formWidgetKey: registration, loader: loader(`approval:${registration}`, legacyLoader) }
+                : { ...registration, loader: loader(`approval:${registration.formWidgetKey}`, registration.loader) });
         },
     };
     return {
@@ -37,29 +40,32 @@ export function bindNexiaAppRequestServices(appKey) {
         },
         autoRegisterPackageSurfaces(options) {
             host().runtime.autoRegisterPackageSurfaces({ ...options, appKey,
-                overview: options.overview && loader(options.overview),
-                surfaces: Object.fromEntries(Object.entries(options.surfaces).map(([key, load]) => [key, loader(load)])),
+                overview: options.overview && loader('overview', options.overview),
+                surfaces: Object.fromEntries(Object.entries(options.surfaces).map(([key, load]) => [key, loader(`surface:${key}`, load)])),
                 overrides: Object.fromEntries(Object.entries(options.overrides ?? {}).map(([key, value]) => [key,
-                    typeof value === 'function' ? loader(value) : { ...value, load: loader(value.load) }])), });
+                    typeof value === 'function' ? loader(`override:${key}`, value) : { ...value, load: loader(`override:${key}`, value.load) }])), });
         },
         approvalComposerBusinessFormRegistry: approvals,
         processUserTaskFormRegistry: {
             register(registration) {
-                host().registries.processUserTaskFormRegistry.register({ ...registration, loader: loader(registration.loader) });
+                host().registries.processUserTaskFormRegistry.register({ ...registration, loader: loader(`process:${registration.componentKey}`, registration.loader) });
             },
         },
         dataMigrationRegistry: {
             registerProvider: dataMigrationRegistry.registerProvider,
             registerTarget: dataMigrationRegistry.registerTarget,
             registerStage(registration) {
-                host().registries.dataMigrationRegistry.registerStage({ ...registration, ownerAppKey: appKey, loader: loader(registration.loader) });
+                host().registries.dataMigrationRegistry.registerStage({ ...registration, ownerAppKey: appKey, loader: loader(`migration:${registration.providerKey}:${registration.id}`, registration.loader) });
             },
         },
         registerAgentComponent(name, component) {
-            host().runtime.registerAgentComponent(name, wrap(component));
+            if (services.wrapLoader)
+                host().runtime.registerLazyAgentComponent(name, loader(`agent:${name}`, async () => ({ default: component })));
+            else
+                host().runtime.registerAgentComponent(name, wrap(component));
         },
         registerLazyAgentComponent(name, load) {
-            host().runtime.registerLazyAgentComponent(name, loader(load));
+            host().runtime.registerLazyAgentComponent(name, loader(`agent:${name}`, load));
         },
         api: services.api,
         openFile: services.openFile,
@@ -114,10 +120,6 @@ function waitForOperationPoll(signal) {
     if (signal.aborted) {
         return Promise.reject(signal.reason ?? new DOMException('Aborted', 'AbortError'));
     }
-    const delay = typeof document !== 'undefined'
-        && document.visibilityState === 'hidden'
-        ? 3000
-        : 1200;
     return new Promise((resolve, reject) => {
         const aborted = () => {
             globalThis.clearTimeout(timer);
@@ -126,7 +128,7 @@ function waitForOperationPoll(signal) {
         const timer = globalThis.setTimeout(() => {
             signal.removeEventListener('abort', aborted);
             resolve();
-        }, delay);
+        }, 5000);
         signal.addEventListener('abort', aborted, { once: true });
     });
 }

package/dist/vite.mjs

@@ -60,7 +60,7 @@ export const { api, openFile, sendUserInvitation, useDataMigrationBackgroundOper
             // Standalone App builds expose compatibility before executing their entry.
             if (owners.length === 1) this.emitFile({
                 type: 'asset', fileName: 'nexia-host.json',
-                source: JSON.stringify({ version: 1, app_key: owners[0].appKey,
+                source: JSON.stringify({ version: 1, development_updates: 1, app_key: owners[0].appKey,
                     styles: Object.keys(bundle).filter(file => file.endsWith('.css')) }),
             });
         },

package/package.json

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