arcane-os 0.2.2 → 0.3.0

package/src/import-map.mjs

@@ -20,6 +20,11 @@ const SDK_BROWSER_ENTRY='sdk/event-manager.mjs';
 const SDK_BROWSER_AI_ENTRY='sdk/ai/browser-wasm.mjs';
 const SDK_BROWSER_SPEECH_ENTRY='sdk/ai/browser-speech.mjs';
 const SDK_BROWSER_SPEECH_WORKER_RUNTIME='sdk/ai/speech-worker-runtime.mjs';
+const SDK_BROWSER_SELF_IMPORTS=new Map([
+    ['arcane-os/event-manager',SDK_BROWSER_ENTRY],
+    ['arcane-os/ai/browser-wasm',SDK_BROWSER_AI_ENTRY],
+    ['arcane-os/ai/browser-speech',SDK_BROWSER_SPEECH_ENTRY]
+]);
 const SDK_BROWSER_FILES=Object.freeze([
     'sdk/ai/ARCANE_AI_BROWSER_WASM_COMPONENTS.json',
     'sdk/ai/browser-kokoro-worker.mjs',
@@ -761,8 +766,8 @@ function nonliteralDynamic(importer,offset){
 
 function isAuthorizedSpeechRuntimeImport(tokens,index,close,importer){
     if(importer!==SDK_BROWSER_SPEECH_WORKER_RUNTIME||close!==index+5)return false;
-    const [entry,dot,moduleUrl]=tokens.slice(index+2,close);
-    return entry?.type==='identifier'&&entry.value==='entry'
+    const [binding,dot,moduleUrl]=tokens.slice(index+2,close);
+    return binding?.type==='identifier'&&['entry','target'].includes(binding.value)
         &&dot?.value==='.'
         &&moduleUrl?.type==='identifier'&&moduleUrl.value==='moduleUrl';
 }
@@ -889,6 +894,19 @@ function resolveImport(importer,specifier,files){
                 +'deterministic shipped-runtime subset'
         );
     }
+    const sdkBrowserTarget=SDK_BROWSER_SELF_IMPORTS.get(reachableSpecifier);
+    if(sdkBrowserTarget){
+        if(reachableSpecifier!==specifier){
+            unresolved(
+                importer,
+                specifier,
+                sdkBrowserTarget,
+                'uses a query or fragment that cannot match its exact browser import-map key'
+            );
+        }
+        if(!files.has(sdkBrowserTarget))unresolved(importer,specifier,sdkBrowserTarget);
+        return {target:sdkBrowserTarget};
+    }
     if(reachableSpecifier===RUNTIME_STRONG_TYPE_IMPORT){
         const target='dependencies/strong-type/index.js';
         if(reachableSpecifier!==specifier){
@@ -1860,7 +1878,7 @@ function renderManagedHtml(html,json,baseHref='../../'){
         ...base,
         href:structuralAttribute(parseTagAttributes(base.open),'href','base')
     }));
-    if(renderedBases.length!==1||renderedBases[0].href!=='../../'
+    if(renderedBases.length!==1||renderedBases[0].href!==baseHref
         ||renderedBases[0].end>managedPosition
         ||!/^[\t\n\f\r ]*$/u.test(rendered.slice(renderedBases[0].end,managedPosition))){
         fail('Generated Arcane import-map HTML has an invalid or late base element.');

package/src/index.mjs

@@ -33,8 +33,18 @@ export {
     validateUpdateRegistry
 } from './update-check.mjs';
 export {
+    ARCANE_EVENT_AUTHORITY_BRAND,
+    ARCANE_EVENT_AUTHORITY_KIND,
+    ARCANE_EVENT_AUTHORITY_PROTOCOL,
+    ARCANE_EVENT_ERROR_CODES,
+    ARCANE_EVENT_LISTENER_ERROR_EVENT,
+    ARCANE_EVENT_OCCURRENCE_PROTOCOL,
+    ARCANE_EVENT_SOURCE_DISPOSED_EVENT,
+    ARCANE_EVENT_SOURCE_KIND,
+    ARCANE_EVENT_SOURCE_PROTOCOL,
     ARCANE_EVENT_STACK_PROTOCOL,
     arcaneEvents,
+    createArcaneEventSource,
     createDOMInstrumentation,
     createEventManager,
     DEFAULT_DOM_EVENT_TYPES,
@@ -45,12 +55,14 @@ export {
     DOM_OBSERVATION_STOPPED_EVENT,
     domSelector,
     EventManager,
+    isArcaneEventOccurrence,
     parseEventStack,
     PLAYBACK_CANCELLED_EVENT,
     PLAYBACK_COMPLETED_EVENT,
     PLAYBACK_FAILED_EVENT,
     PLAYBACK_RECORD_EVENT,
     PLAYBACK_STARTED_EVENT,
+    projectArcaneDOMEvent,
     TIME_TRAVEL_OVERFLOW_EVENT,
     TIME_TRAVEL_SEEK_EVENT
 } from './event-manager.mjs';
@@ -131,6 +143,7 @@ export {
     selectApp,
     validateWorkspace
 } from './workspace.mjs';
+export {materializeInstalledSdkRuntime} from './installed-sdk-runtime.mjs';
 export {startDevServer} from './dev-server.mjs';
 export {
     NATIVE_BUILD_PLAN_PROTOCOL,

package/src/installed-sdk-runtime.mjs

@@ -0,0 +1,112 @@
+import {lstat,readFile,realpath} 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 {
+    resolveInstalledSdkInstallation,
+    resolveSdkPackageDeclaration
+} from './workspace.mjs';
+
+function fail(message,code='ARCANE_INSTALLED_SDK_RUNTIME_INVALID'){
+    const error=new Error(message);
+    error.code=code;
+    throw error;
+}
+
+function throwIfAborted(signal){
+    if(!signal?.aborted)return;
+    const error=signal.reason instanceof Error?signal.reason:new Error('Operation cancelled.');
+    error.code=error.code||'ARCANE_CANCELLED';
+    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);}
+    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;
+}
+
+async function readRootPackage(workspaceRoot){
+    const packagePath=path.join(workspaceRoot,'package.json');
+    let info;
+    try{info=await lstat(packagePath);}
+    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.');
+    }
+    try{return JSON.parse(await readFile(packagePath,'utf8'));}
+    catch(error){fail(`Workspace package.json is not valid JSON: ${error.message}`);}
+}
+
+/**
+ * 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,
+    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({
+        workspaceRoot:canonicalRoot,
+        runtimeRoot:installation.runtimeRoot,
+        runtimeReceipt,
+        browserRuntimeRoot:installation.browserRuntimeRoot,
+        sdkBrowserRuntimeReceipt,
+        signal,
+        onEvent
+    });
+    return Object.freeze({
+        schemaVersion:1,
+        kind:'arcane-installed-sdk-runtime-materialization',
+        installation,
+        runtimeReceipt,
+        sdkBrowserRuntimeReceipt,
+        workspaceRuntimeReceipt
+    });
+}

package/src/mail-api.mjs

@@ -0,0 +1,22 @@
+export {
+    default,
+    default as Mail,
+    resolveMailConfig
+} from '../runtime/arcane/modules/Mail.js';
+export {
+    MAIL_OUTBOX_ACCEPTANCE_AUTHORITIES,
+    MAIL_OUTBOX_IDEMPOTENCY_WINDOW_MS,
+    MAIL_OUTBOX_PROTOCOL,
+    MAIL_OUTBOX_STATES,
+    MAIL_OUTBOX_TABLE,
+    MailOutbox,
+    createMailOutbox
+} from '../runtime/arcane/modules/MailOutbox.mjs';
+export {
+    DEFAULT_MAIL_REQUEST_TIMEOUT_MS,
+    MAX_MAIL_RESPONSE_BYTES,
+    MailTransportError,
+    normalizeMailEndpoint,
+    sendMailReport,
+    serializeMailReport
+} from '../runtime/arcane/modules/MailTransport.mjs';