arcane-os 0.3.0 → 0.3.2

package/src/index.mjs

@@ -1,7 +1,6 @@
 export {
     ARCANE_MACHINE_BUNDLE_VERSION,
     ARCANE_PROTOCOL,
-    ARCANE_UPSTREAM_COMMIT,
     ARCANE_UPSTREAM_REPOSITORY,
     CLI_EVENT_PROTOCOL,
     CLI_NAME,
@@ -63,7 +62,6 @@ export {
     PLAYBACK_RECORD_EVENT,
     PLAYBACK_STARTED_EVENT,
     projectArcaneDOMEvent,
-    TIME_TRAVEL_OVERFLOW_EVENT,
     TIME_TRAVEL_SEEK_EVENT
 } from './event-manager.mjs';
 export {runProcess} from './process.mjs';
@@ -102,8 +100,6 @@ export {
 export {
     assertIntegratedNativeToolchain,
     assertIntegratedPortableToolchain,
-    assertNativeApplicationToolchainCompatibility,
-    assertPortableToolchainCompatibility,
     buildApplication,
     bundleApplication,
     checkApplication,
@@ -116,6 +112,7 @@ export {
     doctorNativeTarget,
     executeOperation,
     initializeApplication,
+    upgradeApplication,
     packageApplication,
     planApplication,
     prepareNativeTarget,
@@ -130,12 +127,21 @@ export {
 } from './toolchain.mjs';
 export {createWorkspace,initWorkspace} from './scaffold.mjs';
 export {
-    authenticateRuntimeReceipt,
     getSdkRoot,
+    listRuntimeFiles,
     loadRuntimeRelease,
-    readVerifiedRuntimeFile,
-    verifyRuntime
+    readRuntimeFile
 } from './runtime.mjs';
+export {
+    getSdkBrowserRuntimeRoot,
+    listSdkBrowserRuntimeFiles,
+    loadSdkBrowserRuntimeRelease,
+    readSdkBrowserRuntimeFile
+} from './sdk-browser-runtime.mjs';
+export {
+    materializeWorkspaceRuntime,
+    materializeWorkspaceRuntimeContent
+} from './workspace-runtime.mjs';
 export {
     discoverApps,
     inspectWorkspaceProfile,
@@ -145,11 +151,10 @@ export {
 } from './workspace.mjs';
 export {materializeInstalledSdkRuntime} from './installed-sdk-runtime.mjs';
 export {startDevServer} from './dev-server.mjs';
+export {startSourceExampleServer} from './source-server.mjs';
 export {
     NATIVE_BUILD_PLAN_PROTOCOL,
     NATIVE_BUILDER_PROTOCOL,
-    assertNativeToolchainCompatibility,
-    authenticateNativeBuildPlan,
     createNativeBuildPlan,
     executeNativeBuildPlan,
     validateNativeBuilder
@@ -157,21 +162,15 @@ export {
 export {
     APP_DESCRIPTOR_NAME,
     APP_DESCRIPTOR_SCHEMA_VERSION,
-    appDescriptorSha256,
     loadAppDescriptor,
     projectNativeDescriptor,
     projectPackageManifest,
     validateAppDescriptor
 } from './app-descriptor.mjs';
 export {
-    authenticateAppReleaseAuthority,
-    authenticateAppReleaseReceipt,
-    authenticateSharedPayloadSnapshot,
     discoverApps as discoverPackagerApps,
     inspectApp,
     packageApp,
-    prepareSharedPayloadSnapshot,
-    readVerifiedAppReleaseFile,
     verifyApp
 } from './packager/core.mjs';
 export {
@@ -179,7 +178,6 @@ export {
     APP_BUNDLE_EXTENSION,
     APP_BUNDLE_FORMAT,
     APP_BUNDLE_KIND,
-    APP_BUNDLE_LIMITS,
     APP_BUNDLE_MANIFEST_NAME,
     APP_BUNDLE_RELEASE_PATH,
     APP_BUNDLE_SCHEMA_VERSION,

package/src/installed-sdk-runtime.mjs

@@ -1,8 +1,7 @@
-import {lstat,readFile,realpath} from 'node:fs/promises';
+import {readFile,realpath,stat} from 'node:fs/promises';
 import path from 'node:path';
-import {verifyRuntime} from './runtime.mjs';
-import {verifySdkBrowserRuntime} from './sdk-browser-runtime.mjs';
-import {materializeWorkspaceRuntime} from './workspace-runtime.mjs';
+import {materializeWorkspaceRuntimeContent} from './workspace-runtime.mjs';
+import {withWorkspaceOperationLock} from './workspace-operation-lock.mjs';
 import {
     resolveInstalledSdkInstallation,
     resolveSdkPackageDeclaration
@@ -21,92 +20,71 @@ function throwIfAborted(signal){
     throw error;
 }
 
-function samePath(left,right){
-    const normalize=value=>path.resolve(value).replaceAll('\\','/');
-    const a=normalize(left);
-    const b=normalize(right);
-    return process.platform==='win32'?a.toLowerCase()===b.toLowerCase():a===b;
-}
-
 async function canonicalWorkspaceRoot(workspaceRoot){
     if(typeof workspaceRoot!=='string'||!workspaceRoot.trim()){
         fail('workspaceRoot is required to materialize an installed SDK runtime.');
     }
     const requested=path.resolve(workspaceRoot);
     let info;
-    try{info=await lstat(requested);}
+    try{info=await stat(requested);}
     catch(error){
         if(error?.code==='ENOENT')fail(`Workspace root does not exist: ${requested}.`);
         throw error;
     }
-    if(info.isSymbolicLink()||!info.isDirectory()){
-        fail(`Workspace root must be a real directory: ${requested}.`);
-    }
-    const canonical=await realpath(requested);
-    if(!samePath(requested,canonical)){
-        fail(`Workspace root must not resolve through another path: ${requested}.`);
-    }
-    return canonical;
+    if(!info.isDirectory())fail(`Workspace root must be a directory: ${requested}.`);
+    return realpath(requested);
 }
 
 async function readRootPackage(workspaceRoot){
     const packagePath=path.join(workspaceRoot,'package.json');
-    let info;
-    try{info=await lstat(packagePath);}
+    let document;
+    try{document=JSON.parse(await readFile(packagePath,'utf8'));}
     catch(error){
         if(error?.code==='ENOENT')fail(`Workspace package.json is missing: ${packagePath}.`);
-        throw error;
-    }
-    if(info.isSymbolicLink()||!info.isFile()){
-        fail('Workspace package.json must be a real file.');
+        fail(`Workspace package.json is not valid JSON: ${error.message}`);
     }
-    try{return JSON.parse(await readFile(packagePath,'utf8'));}
-    catch(error){fail(`Workspace package.json is not valid JSON: ${error.message}`);}
+    return document;
+}
+
+async function installedSdkAuthority(canonicalRoot,{sdkPackageSource}={}){
+    const declaration=resolveSdkPackageDeclaration(
+        await readRootPackage(canonicalRoot),
+        sdkPackageSource===undefined?{}:{packageSource:sdkPackageSource}
+    );
+    const installation=await resolveInstalledSdkInstallation(canonicalRoot,declaration);
+    return {declaration,installation};
 }
 
-/**
- * Resolves the workspace's one exact installed Arcane SDK declaration, verifies
- * both physical runtime receipts, and materializes their dynamic inventories.
- */
 export async function materializeInstalledSdkRuntime({
     workspaceRoot,
     sdkPackageSource,
+    workspaceOperationLease,
     signal,
     onEvent
 }={}){
     throwIfAborted(signal);
     const canonicalRoot=await canonicalWorkspaceRoot(workspaceRoot);
-    const rootPackage=await readRootPackage(canonicalRoot);
-    const declaration=resolveSdkPackageDeclaration(rootPackage,
-        sdkPackageSource===undefined?{}:{packageSource:sdkPackageSource});
-    const installation=await resolveInstalledSdkInstallation(canonicalRoot,declaration);
-    const [runtimeReceipt,sdkBrowserRuntimeReceipt]=await Promise.all([
-        verifyRuntime({
-            runtimeRoot:installation.runtimeRoot,
-            signal,
-            onEvent
-        }),
-        verifySdkBrowserRuntime({
-            browserRuntimeRoot:installation.browserRuntimeRoot,
-            signal,
-            onEvent
-        })
-    ]);
-    const workspaceRuntimeReceipt=await materializeWorkspaceRuntime({
+    return withWorkspaceOperationLock({
         workspaceRoot:canonicalRoot,
-        runtimeRoot:installation.runtimeRoot,
-        runtimeReceipt,
-        browserRuntimeRoot:installation.browserRuntimeRoot,
-        sdkBrowserRuntimeReceipt,
+        operation:'installed-sdk-runtime',
         signal,
-        onEvent
-    });
-    return Object.freeze({
-        schemaVersion:1,
-        kind:'arcane-installed-sdk-runtime-materialization',
-        installation,
-        runtimeReceipt,
-        sdkBrowserRuntimeReceipt,
-        workspaceRuntimeReceipt
+        onEvent,
+        workspaceOperationLease
+    },async()=>{
+        const authority=await installedSdkAuthority(canonicalRoot,{sdkPackageSource});
+        const workspaceRuntime=await materializeWorkspaceRuntimeContent({
+            workspaceRoot:canonicalRoot,
+            runtimeRoot:authority.installation.runtimeRoot,
+            browserRuntimeRoot:authority.installation.browserRuntimeRoot,
+            signal,
+            onEvent
+        });
+        return {
+            schemaVersion:1,
+            kind:'arcane-installed-sdk-runtime-materialization',
+            status:'materialized',
+            installation:authority.installation,
+            workspaceRuntime
+        };
     });
 }