arcane-os 0.3.1 → 0.3.3

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,9 +1,8 @@
-import {lstat,readFile,realpath} from 'node:fs/promises';
+import {lstat,readFile,realpath,stat,writeFile} 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 {createWorkspaceLockDocument} from './templates/workspace-template.mjs';
 import {
     resolveInstalledSdkInstallation,
     resolveSdkPackageDeclaration
@@ -22,53 +21,53 @@ 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;
+        fail(`Workspace package.json is not valid JSON: ${error.message}`);
     }
-    if(info.isSymbolicLink()||!info.isFile()){
-        fail('Workspace package.json must be a real file.');
+    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};
+}
+
+async function writeWorkspaceLock(lockPath,lock){
+    try{
+        const info=await lstat(lockPath);
+        if(info.isSymbolicLink()||!info.isFile()){
+            fail(`Workspace SDK lock must be a real file: ${lockPath}.`);
+        }
+    }catch(error){
+        if(error?.code!=='ENOENT')throw error;
     }
-    try{return JSON.parse(await readFile(packagePath,'utf8'));}
-    catch(error){fail(`Workspace package.json is not valid JSON: ${error.message}`);}
+    await writeFile(lockPath,`${JSON.stringify(lock,null,2)}\n`,'utf8');
 }
 
-/**
- * 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,
@@ -85,46 +84,29 @@ export async function materializeInstalledSdkRuntime({
         onEvent,
         workspaceOperationLease
     },async()=>{
-        throwIfAborted(signal);
-        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({
+        const authority=await installedSdkAuthority(canonicalRoot,{sdkPackageSource});
+        const workspaceRuntime=await materializeWorkspaceRuntimeContent({
             workspaceRoot:canonicalRoot,
-            runtimeRoot:installation.runtimeRoot,
-            runtimeReceipt,
-            browserRuntimeRoot:installation.browserRuntimeRoot,
-            sdkBrowserRuntimeReceipt,
-            installedSdkAuthority:Object.freeze({declaration,installation}),
+            runtimeRoot:authority.installation.runtimeRoot,
+            browserRuntimeRoot:authority.installation.browserRuntimeRoot,
             signal,
             onEvent
         });
-        const materialization=workspaceRuntimeReceipt.materialization;
-        return Object.freeze({
+        const lockPath=path.join(canonicalRoot,'arcane.lock.json');
+        const lock=createWorkspaceLockDocument({
+            dependencyName:authority.installation.dependencyName,
+            packageName:authority.installation.packageName,
+            packageVersion:authority.installation.packageVersion,
+            packageSource:authority.installation.packageSource
+        });
+        await writeWorkspaceLock(lockPath,lock);
+        return {
             schemaVersion:1,
             kind:'arcane-installed-sdk-runtime-materialization',
-            status:materialization.status,
-            generation:materialization.generation,
-            receiptPath:materialization.receiptPath,
-            persistentReceipt:materialization.persistentReceipt,
-            cleanupWarnings:materialization.cleanupWarnings,
-            installation,
-            runtimeReceipt,
-            sdkBrowserRuntimeReceipt,
-            workspaceRuntimeReceipt
-        });
+            status:'materialized',
+            installation:authority.installation,
+            workspaceRuntime,
+            workspaceLock:{path:lockPath,document:lock}
+        };
     });
 }