arcane-os 0.27.0 → 0.27.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.27.1
+
+- Preserve the previous `apps/<id>/arcane-sw.js` and `arcane-offline.json`
+  endpoints when generating a root-layout PWA. Both use the canonical worker
+  and current root inventory, including navigation aliases and installed npm
+  resource paths; portable output also retains deployment-relative URLs.
+- Serve those previous worker and inventory endpoints directly during SDK
+  development instead of redirecting worker-script requests. Retain ordinary
+  browser update/activation, caches, application identity and saved data.
+- Keep root layout optional and existing multi-app and Node server behavior
+  unchanged. Installed-application execution remains consumer-owned.
+
 ## 0.27.0
 
 - Add optional standalone `appsRoot: "."` discovery and `new`/`init --apps-root .`.

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles preserve the same app URLs, theme, packaging,
 event, cancellation, and browser run contracts.
 
-This checkout defines the `0.27.0` SDK contract. Applications pin one exact npm
+This checkout defines the `0.27.1` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 

package/docs/reference/pwa.md

@@ -59,6 +59,18 @@ authored `manifest.id` remains authoritative. Packaged default identity remains
 fragments and lead to the selected root document. No stored application data is
 rewritten by changing the layout.
 
+Root PWA generation also retains `apps/<id>/arcane-sw.js` and
+`apps/<id>/arcane-offline.json`. These are ordinary generated files served at
+their original URLs, including on a static host. The same canonical worker and
+current inventory use root resource/navigation URLs, rebased for the previous
+scope when deployed beneath a directory. An existing worker's inventory refresh
+can learn the new navigation destinations; the browser can update the worker at
+its retained script URL through normal update and activation. No cache deletion,
+forced activation, user-data migration or application-owned server handler is
+introduced. Offline clients require a later successful connection to receive
+updated files; fixture coverage does not establish a particular installed app's
+actual browser lifecycle.
+
 `offline.include` and `offline.exclude` select literal paths or directory
 prefixes from the selected emitted inventory. An omitted or empty include list
 selects that inventory; exclusions subtract from it. App files use app-relative

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/src/dev-server.mjs

@@ -1081,7 +1081,10 @@ async function startOwnedDevServer({
                 navigationAliases,
                 basePath: '/',
                 appBase,
-                ...(rootApp ? {installationId:`/apps/${routeSet.appId}/`} : {}),
+                ...(rootApp ? {
+                    installationId:`/apps/${routeSet.appId}/`,
+                    legacyAppPath:`apps/${routeSet.appId}`
+                } : {}),
                 runtimeBase: selectedRoutes.browserRuntimeBase
                     ?? selectedRoutes.installed?.browserRuntimeBase ?? '/arcane/sdk/',
                 mode: 'development'
@@ -1109,8 +1112,8 @@ async function startOwnedDevServer({
             pwaStates.set(selectedRoutes, state);
             if (selectedRoutes === currentSourceRoutes) currentPwaState = state;
         }
-        if (targetPath === '/arcane-sw.js'
-            || targetPath === '/arcane-offline.json') {
+        if (targetPath.endsWith('/arcane-sw.js')
+            || targetPath.endsWith('/arcane-offline.json')) {
             if (!state.inventoryTask) {
                 // Timestamp selection before traversal, so an older snapshot
                 // finishing later cannot acquire a newer HTTP modification date.
@@ -1173,10 +1176,13 @@ async function startOwnedDevServer({
             const target=parseRequestTarget(request.url);
             if(!target){deny(response,400,'Invalid request path.');return;}
             const {segments}=target;
-            const generatedPwaPath = ['/arcane.webmanifest', '/arcane-offline.json', '/arcane-sw.js', '/arcane-pwa.mjs']
-                .includes(target.path);
             const legacyAppRequest = mode === 'source' && routeSet.config.appsRoot === '.'
                 && segments[0] === 'apps' && segments[1] === routeSet.appId;
+            const legacyPwaRequest = legacyAppRequest && segments.length === 3
+                && ['arcane-sw.js', 'arcane-offline.json'].includes(segments[2]);
+            const generatedPwaPath = legacyPwaRequest
+                || ['/arcane.webmanifest', '/arcane-offline.json', '/arcane-sw.js', '/arcane-pwa.mjs']
+                    .includes(target.path);
             const requestedMapping = currentSourceRoutes.mappings.find(function currentRequestMapping(route) {
                 return route.prefix.every(function currentRequestSegment(segment,index) {
                     return segments[index] === segment;
@@ -1186,7 +1192,7 @@ async function startOwnedDevServer({
             const selectedRoutes = mode === 'source' && (appRequest || segments.length === 0 || generatedPwaPath)
                 ? await refreshSourceRoutes() : currentSourceRoutes;
             const pwaEnabled = mode === 'source' ? selectedRoutes.app?.pwa?.enabled === true : routeSet.pwa;
-            if (legacyAppRequest) {
+            if (legacyAppRequest && !(pwaEnabled && legacyPwaRequest)) {
                 const legacyPath = target.pathname.slice(`/apps/${routeSet.appId}`.length);
                 const location = !legacyPath || legacyPath === '/' || legacyPath === '/index.html'
                     ? selectedRoutes.startPath : legacyPath;

package/src/packager/core.mjs

@@ -757,6 +757,7 @@ async function replaceDirectory(stagingRoot,outputRoot){
 async function packageWithContext(context,options={}){
     const {signal,onEvent,browserPwa=true}=options;
     const pwaEnabled=browserPwa&&context.config.pwa?.enabled===true;
+    const legacyAppPath=context.rootConfig.appsRoot==='.'?`apps/${context.appId}`:undefined;
     const appPath=appRelativeRoot(context.rootConfig,context.appId);
     const entryPath=appPackagePath(context,context.config.entry);
     const inspected=await inspectContext(context,{signal});
@@ -775,7 +776,11 @@ async function packageWithContext(context,options={}){
                     PWA_MANIFEST_NAME,
                     PWA_OFFLINE_MANIFEST_NAME,
                     PWA_WORKER_NAME,
-                    PWA_BOOTSTRAP_NAME
+                    PWA_BOOTSTRAP_NAME,
+                    ...(legacyAppPath?[
+                        `${legacyAppPath}/${PWA_WORKER_NAME}`,
+                        `${legacyAppPath}/${PWA_OFFLINE_MANIFEST_NAME}`
+                    ]:[])
                 ]:[])
             ].sort(compareText)
         };
@@ -962,6 +967,7 @@ async function packageWithContext(context,options={}){
                 entry:packageResourceUrl(entryPath)
             },
             appPath,
+            ...(legacyAppPath?{legacyAppPath}:{}),
             ...(installed?.direct?{runtimeBase:`.${installed.browserRuntimeBase}`} : {}),
             ...(navigationAliases?{navigationAliases}:{}),
             sdkVersion:assetVersion,
@@ -974,7 +980,9 @@ async function packageWithContext(context,options={}){
                 if(inventory.has(artifact.path)){
                     fail(`Package content overlaps generated PWA file: ${artifact.path}.`);
                 }
-                await writeFile(path.join(stagingRoot,artifact.path),artifact.content,'utf8');
+                const artifactPath=path.join(stagingRoot,...artifact.path.split('/'));
+                await mkdir(path.dirname(artifactPath),{recursive:true});
+                await writeFile(artifactPath,artifact.content,'utf8');
                 files.push(artifact.path);
             }
             for(const [documentPath,document] of pwaDocumentSources){

package/src/pwa.mjs

@@ -1,5 +1,6 @@
 import Is from 'strong-type';
 import {randomUUID} from 'node:crypto';
+import path from 'node:path';
 import {createPwaWorkerScript} from './pwa-worker.mjs';
 import {versionAssetUrl} from './import-map.mjs';
 
@@ -203,6 +204,7 @@ export function createPwaArtifacts(
         runtimeBase = './arcane/sdk/',
         appBase,
         installationId,
+        legacyAppPath,
         appPath = '',
         navigationAliases,
         revision
@@ -305,18 +307,60 @@ controller.ready.catch(
     const entryAssets = {manifest: PWA_MANIFEST_NAME, bootstrap: PWA_BOOTSTRAP_NAME};
     const manifestHref = resourceUrl(basePath, entryAssets.manifest);
     const bootstrapHref = resourceUrl(basePath, entryAssets.bootstrap);
+    const generatedFiles = [
+        {path: PWA_MANIFEST_NAME, content: json(manifest)},
+        {path: PWA_OFFLINE_MANIFEST_NAME, content: json(offlineManifest)},
+        {
+            path: PWA_WORKER_NAME,
+            content: createPwaWorkerScript(offlineManifest, `${runtimeBase}pwa.mjs`)
+        },
+        {path: PWA_BOOTSTRAP_NAME, content: bootstrap}
+    ];
+    if (legacyAppPath) {
+        const directory = legacyAppPath.endsWith('/') ? legacyAppPath : `${legacyAppPath}/`;
+        const priorDirectory = new URL(resourceUrl('./', directory), 'https://arcane.invalid/').pathname;
+        // Existing registrations continue updating their own script and inventory URLs.
+        function priorScopeUrl(value) {
+            if (value.startsWith('/') || /^[A-Za-z][A-Za-z0-9+.-]*:/u.test(value)) return value;
+            const resolved = new URL(value, 'https://arcane.invalid/');
+            let relative = path.posix.relative(priorDirectory, resolved.pathname);
+            if (!relative) {
+                relative = resolved.pathname.endsWith('/')
+                    ? './'
+                    : `../${path.posix.basename(resolved.pathname)}`;
+            }
+            else {
+                if (!relative.startsWith('.')) relative = `./${relative}`;
+                if (resolved.pathname.endsWith('/') && !relative.endsWith('/')) relative += '/';
+            }
+            return `${relative}${resolved.search}${resolved.hash}`;
+        }
+        const legacyOfflineManifest = {
+            ...offlineManifest,
+            assets: [...new Set([
+                ...offlineManifest.assets.map(priorScopeUrl),
+                `./${PWA_OFFLINE_MANIFEST_NAME}`
+            ])],
+            navigationAliases: Object.fromEntries(
+                Object.entries(offlineManifest.navigationAliases).map(
+                    function priorScopeNavigation([alias, target]) {
+                        return [priorScopeUrl(alias), priorScopeUrl(target)];
+                    }
+                )
+            )
+        };
+        generatedFiles.push(
+            {
+                path: `${directory}${PWA_WORKER_NAME}`,
+                content: createPwaWorkerScript(legacyOfflineManifest, priorScopeUrl(`${runtimeBase}pwa.mjs`))
+            },
+            {path: `${directory}${PWA_OFFLINE_MANIFEST_NAME}`, content: json(legacyOfflineManifest)}
+        );
+    }
     return {
         manifest,
         offlineManifest,
-        files: [
-            {path: PWA_MANIFEST_NAME, content: json(manifest)},
-            {path: PWA_OFFLINE_MANIFEST_NAME, content: json(offlineManifest)},
-            {
-                path: PWA_WORKER_NAME,
-                content: createPwaWorkerScript(offlineManifest, `${runtimeBase}pwa.mjs`)
-            },
-            {path: PWA_BOOTSTRAP_NAME, content: bootstrap}
-        ],
+        files: generatedFiles,
         entryAssets,
         entryMarkup: `<link rel="manifest" href="${htmlAttribute(manifestHref)}">\n`
             + `<script type="module" async data-arcane-pwa src="${htmlAttribute(bootstrapHref)}"></script>\n`

package/src/toolchain.mjs

@@ -361,6 +361,7 @@ async function refreshRootApplicationFiles(prepared,inspected,importMap,{signal,
         basePath:'/',
         appBase:'/',
         installationId:`/apps/${appId}/`,
+        legacyAppPath:`apps/${appId}`,
         runtimeBase:installed.browserRuntimeBase,
         mode:'development',
         navigationAliases