@nexia/sdk 0.8.1 → 0.8.3

package/changelog/0.7.1/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.7.1
+date: 2026-10-01
+title: Shared App frontend contracts
+description: Compatible frontend contracts for Composer and isolated Apps.
+---
+
+Add host-backed file opening, action presentation and Inspector queries, resource contract Inspector registration, standalone form save bindings and explicit surface modes. Existing App registrations remain supported. Adopt matching Core host bindings before using the new APIs; this package alone does not update a deployed host.

package/changelog/0.7.1/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.7.1
+date: 2026-10-01
+title: 공용 앱 프런트엔드 계약
+description: Composer 앱과 격리 앱에서 사용하는 호환 프런트엔드 계약입니다.
+---
+
+호스트를 통한 파일 열기·액션 표시·Inspector 조회, 리소스 계약 기반 Inspector 등록, 독립 폼 저장 연결과 명시적 화면 모드를 추가합니다. 기존 앱 등록 방식은 유지합니다. 새 API를 사용하기 전에 대응 Core 호스트 연결을 적용하세요. 이 패키지만으로 배포된 호스트가 변경되지는 않습니다.

package/changelog/0.7.2/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.7.2
+date: 2026-10-01
+title: Import reference target context
+description: Pass the reviewed legal entity to App reference setup.
+---
+
+Add optional `legalEntityPublicId` to the import reference review contract so the host can pass the selected import target to an App. Existing implementations remain compatible. Adopt the matching Core and People changes to use it; server authorization remains required.

package/changelog/0.7.2/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.7.2
+date: 2026-10-01
+title: 가져오기 기초정보 대상 전달
+description: 검토 중인 법인을 앱의 기초정보 생성에 전달합니다.
+---
+
+가져오기 기초정보 검토 계약에 선택적 `legalEntityPublicId`를 추가해 호스트가 선택한 대상 법인을 앱에 전달할 수 있습니다. 기존 구현과 호환됩니다. 사용하려면 대응하는 Core·People 변경을 함께 반영해야 하며 서버 권한 검증은 계속 필요합니다.

package/changelog/0.8.0/en.md

@@ -0,0 +1,20 @@
+---
+status: published
+version: 0.8.0
+date: 2026-10-03
+title: Shared React App host
+description: App-bound host services and standalone shared-host builds.
+---
+
+# React SDK 0.8.0
+
+## Required upgrade
+- Approved App UI runs in the shared Core 0.7.0 React host. Previous App-frame bundles are incompatible and must be rebuilt; backend Composer/sandbox selection remains independent.
+- Use `nexiaAppConfig(import.meta.url)` from `@nexia/sdk/vite` for standalone App builds. The plugin binds each App's requests to its owning host services, shares supported host peers, bundles App dependencies, and emits `nexia-host.json` plus styles.
+- Replace removed generic Resource Information schema exports with the existing composed Resource form/detail contracts; `resourceFieldValue` reads form fields.
+
+## Host behavior
+- Host-bound App services preserve request ownership across lazy imports and simultaneously mounted Apps. `useReauthenticate` delegates authentication navigation and dirty-work confirmation to Core while preserving the owning App return route.
+- Shared JavaScript execution requires approved App source and dependencies; it does not isolate malicious frontend code. Backend authorization and isolation remain required.
+
+Adopt Laravel SDK 0.8.0, Core 0.7.0 and rebuilt App artifacts together. CLI asset serving requires the corresponding alpha.7 release.

package/changelog/0.8.0/ko.md

@@ -0,0 +1,20 @@
+---
+status: published
+version: 0.8.0
+date: 2026-10-03
+title: 공용 React 앱 호스트
+description: 앱별 호스트 서비스와 독립 공용 호스트 빌드.
+---
+
+# React SDK 0.8.0
+
+## 필수 전환
+- 승인된 앱 UI는 Core 0.7.0의 공용 React 호스트에서 실행합니다. 이전 앱 프레임 번들은 호환되지 않으므로 다시 빌드해야 합니다. 백엔드의 Composer·sandbox 선택은 별도로 유지됩니다.
+- 독립 앱 빌드에는 `@nexia/sdk/vite`의 `nexiaAppConfig(import.meta.url)`을 사용합니다. 플러그인은 앱 요청을 소유 앱의 호스트 서비스에 연결하고, 지원되는 호스트 의존성을 공유하며, 앱 의존성을 번들에 포함하고 `nexia-host.json`과 스타일을 생성합니다.
+- 제거된 범용 Resource Information 스키마 내보내기는 기존 조합형 Resource 폼·상세 계약으로 전환합니다. 폼 값 조회에는 `resourceFieldValue`를 사용합니다.
+
+## 호스트 동작
+- 지연 로드와 여러 앱의 동시 표시에서도 앱 서비스의 요청 소유권을 유지합니다. `useReauthenticate`는 소유 앱 복귀 경로를 유지하며 인증 이동과 미저장 작업 확인을 Core에 위임합니다.
+- 공용 JavaScript 실행에는 앱 소스와 의존성 승인이 필요하며 악성 프런트엔드 코드를 격리하지 않습니다. 백엔드 권한 검사와 격리는 계속 필요합니다.
+
+Laravel SDK 0.8.0, Core 0.7.0, 다시 빌드한 앱 산출물을 함께 적용합니다. CLI 에셋 제공에는 대응 alpha.7 릴리스가 필요합니다.

package/changelog/0.8.1/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.1
+date: 2026-10-08
+title: Business approval document copy contracts
+description: Declare independent business draft copying with matching Core and App support.
+---
+
+Add optional `copySourceResourceId` to approval business forms. Apps authorize the source and persist an independent draft; never reuse the source as `appDraftRef`.
+
+Adopt with Core 0.7.53 and the matching App implementation. Existing integrations remain compatible.

package/changelog/0.8.1/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.1
+date: 2026-10-08
+title: 업무형 기안 복사 계약
+description: 대응 Core와 App에서 독립된 업무 초안 복사를 지원합니다.
+---
+
+결재 업무 폼에 선택적 `copySourceResourceId`를 추가합니다. App은 원본 조회 권한을 확인하고 독립된 초안을 저장해야 하며 원본을 `appDraftRef`로 재사용하면 안 됩니다.
+
+Core 0.7.53 및 대응 App 구현과 함께 적용하세요. 기존 연동은 호환됩니다.

package/changelog/0.8.2/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.2
+date: 2026-10-08
+title: Parallel loading for standalone App screens
+description: Standalone App builds preload lazy screens and their shared dependencies together.
+---
+
+`nexiaAppConfig` now uses Vite application output so lazy screens preload their dependency graph instead of fetching each dependency only after its parent arrives. Relative asset URLs preserve the selected runtime asset grant; the shared host imports and `index.js` entry contract remain unchanged.
+
+Update the frontend SDK and rebuild and publish the App image to adopt this change. Existing images are unchanged. No PHP SDK or Core contract upgrade is required.

package/changelog/0.8.2/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.2
+date: 2026-10-08
+title: 독립 앱 화면의 병렬 로딩
+description: 독립 앱 빌드가 지연 로딩 화면과 공통 의존 파일을 함께 불러옵니다.
+---
+
+`nexiaAppConfig`가 Vite 앱 빌드 방식을 사용합니다. 상위 파일을 받은 뒤에야 다음 의존 파일을 요청하던 지연 로딩 경로에서 화면과 의존 파일을 함께 미리 불러옵니다. 상대 자산 URL은 선택한 런타임의 자산 접근 경로를 유지하며, 공통 호스트 모듈과 `index.js` 진입 계약은 유지됩니다.
+
+프런트엔드 SDK를 업데이트하고 앱 이미지를 다시 빌드·게시해야 적용됩니다. 기존 이미지는 바뀌지 않습니다. PHP SDK나 Core 계약 업그레이드는 필요하지 않습니다.

package/dist/vite.mjs

@@ -12,13 +12,16 @@ export function nexiaAppConfig(configUrl) {
     const root = fileURLToPath(new URL('.', configUrl));
     const manifest = JSON.parse(readFileSync(new URL('./nexia.json', configUrl), 'utf8'));
     return {
-        root, plugins: [nexiaAppFrontend({ appKey: manifest.app.app_key, root })],
+        root, base: './', plugins: [nexiaAppFrontend({ appKey: manifest.app.app_key, root })],
         publicDir: false, envDir: false, esbuild: { jsx: 'automatic' },
         resolve: { alias: { '#app': path.join(root, 'resources/js'), '#lang': path.join(root, 'resources/lang') } },
         build: {
             outDir: 'dist/frontend', emptyOutDir: true, sourcemap: false, manifest: true,
-            lib: { entry: path.join(root, 'resources/js/index.ts'), formats: ['es'], fileName: () => 'index.js' },
+            // Application builds preload lazy chunks and their dependencies in parallel.
+            modulePreload: { polyfill: false }, cssCodeSplit: false,
             rollupOptions: {
+                input: path.join(root, 'resources/js/index.ts'),
+                output: { format: 'es', entryFileNames: 'index.js' },
                 external: (id, importer) => nexiaHostPeers.includes(id)
                     && (!['@nexia/sdk', '@nexia/sdk/host'].includes(id) || importer?.startsWith('\0nexia-app-services:')),
             },

package/package.json

@@ -1,12 +1,13 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.8.1",
+    "version": "0.8.3",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",
     "packageManager": "pnpm@11.17.0",
     "files": [
-        "dist"
+        "dist",
+        "changelog"
     ],
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",