arcane-os 0.5.17 → 0.5.18

package/src/event-queue.mjs

@@ -1,6 +1,9 @@
+import Is from 'strong-type';
 import {AsyncLocalStorage} from 'node:async_hooks';
 import {arcaneEvents} from './event-manager.mjs';
 
+const is = new Is(false);
+
 const deliveryStorage=new AsyncLocalStorage();
 
 function deliveryOccurrence(event){
@@ -17,13 +20,13 @@ function deliveryOccurrence(event){
 }
 
 function mirror(manager,event,eventMetadata,occurrence){
-    if(!manager||!event||typeof event!=='object'||occurrence.managers.has(manager)){
+    if(!manager||!event||!is.object(event)||occurrence.managers.has(manager)){
         return;
     }
     occurrence.managers.add(manager);
     try{
         const result=manager.forward(event,eventMetadata);
-        if(result&&typeof result.then==='function'){
+        if(result&&is.function(result.then)){
             void Promise.resolve(result).catch(()=>{});
         }
     }catch{
@@ -44,9 +47,9 @@ export function createEventQueue(onEvent,{
     eventManager=arcaneEvents,
     eventMetadata={source:'sdk',category:'operation'}
 }={}){
-    const callback=typeof onEvent==='function'?onEvent:null;
+    const callback=is.function(onEvent)?onEvent:null;
     const manager=eventManager===null?null:eventManager;
-    if(manager&&typeof manager.forward!=='function'){
+    if(manager&&!is.function(manager.forward)){
         throw new TypeError('The central event manager must provide forward(event, metadata).');
     }
     let firstError=null;
@@ -65,7 +68,7 @@ export function createEventQueue(onEvent,{
         resolveFailure(firstError);
         try{
             const result=onFailure?.(firstError);
-            if(result&&typeof result.then==='function'){
+            if(result&&is.function(result.then)){
                 void Promise.resolve(result).catch(()=>{});
             }
         }catch{

package/src/events.mjs

@@ -1,22 +1,25 @@
+import Is from 'strong-type';
 import {randomUUID} from 'node:crypto';
 import {CLI_EVENT_PROTOCOL,OUTPUT_MODES} from './constants.mjs';
 import {ArcaneError,ERROR_CODES,errorRecord} from './errors.mjs';
 
+const is = new Is(false);
+
 function write(stream,value){
     stream.write(`${value}\n`);
 }
 
 function jsonSafe(value,seen=new WeakSet()){
-    if(value===undefined||value===null||typeof value==='string'
-        ||typeof value==='number'||typeof value==='boolean'){
+    if(value===undefined||value===null||is.string(value)
+        ||is.number(value)||is.boolean(value)){
         return value;
     }
 
-    if(typeof value==='bigint'){
+    if(is.bigint(value)){
         return value.toString();
     }
 
-    if(typeof value==='function'||typeof value==='symbol'){
+    if(is.function(value)||is.symbol(value)){
         return undefined;
     }
 
@@ -24,7 +27,7 @@ function jsonSafe(value,seen=new WeakSet()){
         return errorRecord(value);
     }
 
-    if(Array.isArray(value)){
+    if(is.array(value)){
         if(seen.has(value)){
             return undefined;
         }
@@ -35,7 +38,7 @@ function jsonSafe(value,seen=new WeakSet()){
         return result;
     }
 
-    if(typeof value==='object'){
+    if(is.object(value)){
         if(seen.has(value)){
             return undefined;
         }
@@ -152,7 +155,7 @@ export function createReporter({
             }));
         }else{
             if(result!==undefined){
-                if(typeof result==='string'){
+                if(is.string(result)){
                     write(stdout,result);
                 }else{
                     write(stdout,JSON.stringify(jsonSafe(result),null,2));
@@ -195,10 +198,10 @@ export function createReporter({
     }
 
     function forward(value,data){
-        if(typeof value==='string'){
+        if(is.string(value)){
             return emit(value,data);
         }
-        if(value&&typeof value==='object'){
+        if(value&&is.object(value)){
             const {type='operation.progress',message,...rest}=value;
             return emit(type,rest.data??rest,message);
         }

package/src/import-map.mjs

@@ -1,8 +1,11 @@
+import Is from 'strong-type';
 import {lstat,mkdir,readFile as readFileFromDisk,readdir,realpath,writeFile} from 'node:fs/promises';
 import path from 'node:path';
 import {pathToFileURL} from 'node:url';
 import {SDK_VERSION} from './constants.mjs';
 
+const is = new Is(false);
+
 export const IMPORT_MAP_RELATIVE_PATH='modules/arcane.importmap.json';
 export const MANAGED_IMPORT_MAP_ATTRIBUTE='data-arcane-import-map';
 
@@ -38,7 +41,7 @@ function throwIfAborted(signal){
 }
 
 async function emit(onEvent,event){
-    if(typeof onEvent!=='function')return null;
+    if(!is.function(onEvent))return null;
     try{
         await onEvent(event);
         return null;
@@ -56,7 +59,7 @@ function compareText(left,right){
 }
 
 function safeRelativePath(value,label='path'){
-    if(typeof value!=='string'||!value||value.includes('\\')||value.includes('\0')
+    if(!is.string(value)||!value||value.includes('\\')||value.includes('\0')
         ||path.posix.isAbsolute(value)||path.posix.normalize(value)!==value
         ||value==='.'||value.startsWith('../')||value.includes('/../')){
         fail(`Import-map ${label} is unsafe: ${String(value)}.`);
@@ -66,7 +69,7 @@ function safeRelativePath(value,label='path'){
 
 function normalizedDocumentPaths(entry,documents){
     if(documents===undefined)return [entry];
-    if(!Array.isArray(documents)||documents.length===0){
+    if(!is.array(documents)||documents.length===0){
         fail('Import-map documents must be a non-empty array of application-relative paths.');
     }
     const normalized=[];
@@ -266,7 +269,7 @@ function classHeader(tokens){
 
 function functionHeader(tokens,closingParenthesis,enclosingBraceKind){
     const openIndex=closingParenthesis?.openTokenIndex;
-    if(!Number.isInteger(openIndex))return null;
+    if(!is.integer(openIndex))return null;
     for(let index=openIndex-1;index>=0;index-=1){
         const token=tokens[index];
         if(new Set([';', '{', '}']).has(token.value))break;
@@ -297,7 +300,7 @@ function arrowFunctionContext(tokens){
     if(arrow?.value!=='=>')return null;
     const parameter=tokens.at(-2);
     let async=false;
-    if(parameter?.value===')'&&Number.isInteger(parameter.openTokenIndex)){
+    if(parameter?.value===')'&&is.integer(parameter.openTokenIndex)){
         const beforeOpen=tokens[parameter.openTokenIndex-1];
         async=beforeOpen?.type==='identifier'&&beforeOpen.value==='async';
     }else{
@@ -375,7 +378,7 @@ function contextualForOf(tokens,parentheses){
 
 function functionParameterDeclaration(tokens,parentheses){
     const context=parentheses.at(-1);
-    if(!Number.isInteger(context?.openTokenIndex))return false;
+    if(!is.integer(context?.openTokenIndex))return false;
     for(let index=context.openTokenIndex-1;index>=0;index-=1){
         const token=tokens[index];
         if(new Set([';','{','}']).has(token.value))return false;
@@ -716,7 +719,7 @@ function importRecord(kind,token){
 }
 
 export function scanModuleImports(source,{importer='<module>'}={}){
-    if(typeof source!=='string')throw new TypeError('scanModuleImports source must be a string.');
+    if(!is.string(source))throw new TypeError('scanModuleImports source must be a string.');
     return moduleImportsFromTokens(tokenize(source),importer);
 }
 
@@ -794,12 +797,12 @@ function moduleImportsFromTokens(tokens,importer){
 }
 
 export function versionAssetUrl(value,version=SDK_VERSION){
-    if(typeof value!=='string')return value;
+    if(!is.string(value))return value;
     return applyReferenceEdits(value,assetUrlVersionEdits(value,version));
 }
 
 function assetUrlVersionEdits(value,version){
-    if(typeof value!=='string'||!value||!version||value.startsWith('#')
+    if(!is.string(value)||!value||!version||value.startsWith('#')
         ||value.startsWith('//')||/^[A-Za-z][A-Za-z0-9+.-]*:/u.test(value)
         ||/^\s/u.test(value))return [];
     const fragmentStart=value.indexOf('#');
@@ -949,7 +952,7 @@ function literalResourceFetch(argumentsList){
 }
 
 function reportAssetReference(onReference,url,kind,baseKind){
-    if(typeof onReference==='function')onReference({url,kind,baseHref:null,...(baseKind?{baseKind}:{})});
+    if(is.function(onReference))onReference({url,kind,baseHref:null,...(baseKind?{baseKind}:{})});
 }
 
 function javascriptReferenceEdits(source,version,onReference){
@@ -1158,7 +1161,7 @@ function importMapReferenceEdits(source,version,onReference){
 }
 
 export function rewriteAssetReferences(source,{filePath,version=SDK_VERSION,onReference}={}){
-    if(typeof source!=='string')throw new TypeError('Asset reference source must be a string.');
+    if(!is.string(source))throw new TypeError('Asset reference source must be a string.');
     const extension=path.extname(String(filePath??'')).toLowerCase();
     if(extension==='.js'||extension==='.mjs'){
         return applyReferenceEdits(source,javascriptReferenceEdits(source,version,onReference));
@@ -1193,7 +1196,7 @@ function importMapUrlVersionEdits(value,version){
 }
 
 function validateInventory(files){
-    if(!Array.isArray(files))throw new TypeError('buildImportMap files must be an array.');
+    if(!is.array(files))throw new TypeError('buildImportMap files must be an array.');
     const exact=new Set();
     for(const value of [...files].sort(compareText)){
         const relative=safeRelativePath(value,'runtime inventory path');
@@ -1249,6 +1252,11 @@ export async function buildImportMap({files,signal,version=SDK_VERSION}={}){
         );
     }
     if(inventory.has('dependencies/strong-type/index.js')){
+        registerSpecifier(
+            namedRegistry,
+            'strong-type',
+            './arcane/dependencies/strong-type/index.js'
+        );
         registerSpecifier(
             namedRegistry,
             './node_modules/strong-type/index.js',
@@ -1344,7 +1352,7 @@ export async function readWorkspaceAssetVersion(workspaceRoot){
     }
     const document=JSON.parse(source);
     const version=document?.sdk?.version;
-    return typeof version==='string'&&version?version:SDK_VERSION;
+    return is.string(version)&&version?version:SDK_VERSION;
 }
 
 function asciiLower(value){
@@ -1432,7 +1440,7 @@ function decodeStructuralAttribute(value,label){
                 return {amp:'&',apos:"'",gt:'>',lt:'<',quot:'"'}[asciiLower(named)];
             }
             const point=Number.parseInt(decimal??hex,decimal?10:16);
-            if(!Number.isSafeInteger(point)||point<=0||point>0x10ffff
+            if(!is.safeInteger(point)||point<=0||point>0x10ffff
                 ||(point>=0xd800&&point<=0xdfff)){
                 fail(`Application HTML ${label} contains an invalid character reference.`);
             }
@@ -1716,7 +1724,7 @@ function htmlAttributeView(value){
             const point=entity[1]||entity[2]
                 ?Number.parseInt(entity[1]??entity[2],entity[1]?10:16)
                 :null;
-            if(point!==null&&(!Number.isSafeInteger(point)||point<=0||point>0x10ffff))return null;
+            if(point!==null&&(!is.safeInteger(point)||point<=0||point>0x10ffff))return null;
             const character=point===null
                 ?{amp:'&',apos:"'",gt:'>',lt:'<',quot:'"'}[asciiLower(entity[3])]
                 :String.fromCodePoint(point);
@@ -1788,7 +1796,7 @@ function htmlReferenceEdits(source,version,onReference){
     const baseHref=base?structuralAttribute(parseTagAttributes(base.open),'href','base'):null;
     if(baseHref&&(/^[A-Za-z][A-Za-z0-9+.-]*:/u.test(baseHref)||baseHref.startsWith('//')))version=null;
     function reportHtmlReference(reference){
-        if(typeof onReference==='function')onReference({...reference,baseHref});
+        if(is.function(onReference))onReference({...reference,baseHref});
     }
     function addNestedEdits(offset,nested){
         for(const edit of nested)edits.push({...edit,start:offset+edit.start,end:offset+edit.end});
@@ -2115,7 +2123,7 @@ async function writeGeneratedFiles({root,files,signal,onEvent}){
 }
 
 function resolvedAppRoot(workspaceRoot,appId,appRoot){
-    if(typeof appId!=='string'||appId.trim()===''){
+    if(!is.string(appId)||appId.trim()===''){
         throw new TypeError('Import-map app id must be a nonempty string.');
     }
     const resolved=path.resolve(appRoot??path.join(workspaceRoot,'apps',appId));
@@ -2129,13 +2137,13 @@ export async function createApplicationTestImportMapContext({
     imports={},
     signal
 }={}){
-    if(typeof applicationRoot!=='string'||applicationRoot.trim()===''){
+    if(!is.string(applicationRoot)||applicationRoot.trim()===''){
         throw new TypeError('applicationRoot must be a nonempty string.');
     }
     if(!['source','dist','test'].includes(boundary)){
         throw new TypeError('boundary must be source, dist, or test.');
     }
-    if(imports===null||typeof imports!=='object'||Array.isArray(imports)){
+    if(imports===null||!is.object(imports)||is.array(imports)){
         throw new TypeError('imports must be a plain object.');
     }
     throwIfAborted(signal);
@@ -2159,7 +2167,7 @@ export async function createApplicationTestImportMapContext({
     const selectedImports={};
     for(const [specifier,target] of Object.entries(imports)){
         throwIfAborted(signal);
-        if(typeof specifier!=='string'||specifier===''||typeof target!=='string'
+        if(!is.string(specifier)||specifier===''||!is.string(target)
             ||!target.startsWith('./')){
             fail(`Application test import-map entry is invalid: ${String(specifier)}.`);
         }
@@ -2192,10 +2200,10 @@ export async function readApplicationTestImportMapContext({
     applicationRoot,
     signal
 }={}){
-    if(typeof workspaceRoot!=='string'||workspaceRoot.trim()===''){
+    if(!is.string(workspaceRoot)||workspaceRoot.trim()===''){
         throw new TypeError('workspaceRoot must be a nonempty string.');
     }
-    if(typeof applicationRoot!=='string'||applicationRoot.trim()===''){
+    if(!is.string(applicationRoot)||applicationRoot.trim()===''){
         throw new TypeError('applicationRoot must be a nonempty string.');
     }
     throwIfAborted(signal);
@@ -2223,9 +2231,9 @@ export async function readApplicationTestImportMapContext({
     catch(error){
         fail(`Application test import-map artifact is not valid JSON: ${error.message}`);
     }
-    if(document===null||typeof document!=='object'||Array.isArray(document)
-        ||document.imports===null||typeof document.imports!=='object'
-        ||Array.isArray(document.imports)){
+    if(document===null||!is.object(document)||is.array(document)
+        ||document.imports===null||!is.object(document.imports)
+        ||is.array(document.imports)){
         fail('Application test import-map artifact must contain an imports object.');
     }
     return createApplicationTestImportMapContext({
@@ -2245,7 +2253,7 @@ async function generateImportMapUnlocked({
     signal,
     onEvent
 }={}){
-    if(typeof workspaceRoot!=='string'||workspaceRoot.trim()===''){
+    if(!is.string(workspaceRoot)||workspaceRoot.trim()===''){
         throw new TypeError('generateImportMap workspaceRoot must be a nonempty string.');
     }
     throwIfAborted(signal);
@@ -2348,7 +2356,7 @@ async function generateImportMapUnlocked({
 
 export async function generateImportMap(options={}){
     const {workspaceRoot}=options??{};
-    if(typeof workspaceRoot!=='string'||workspaceRoot.trim()===''){
+    if(!is.string(workspaceRoot)||workspaceRoot.trim()===''){
         throw new TypeError('generateImportMap workspaceRoot must be a nonempty string.');
     }
     return generateImportMapUnlocked(options);

package/src/installed-sdk-runtime.mjs

@@ -1,3 +1,4 @@
+import Is from 'strong-type';
 import {lstat,readFile,realpath,stat,writeFile} from 'node:fs/promises';
 import path from 'node:path';
 import {materializeWorkspaceRuntimeContent} from './workspace-runtime.mjs';
@@ -8,6 +9,8 @@ import {
     resolveSdkPackageDeclaration
 } from './workspace.mjs';
 
+const is = new Is(false);
+
 function fail(message,code='ARCANE_INSTALLED_SDK_RUNTIME_INVALID'){
     const error=new Error(message);
     error.code=code;
@@ -22,7 +25,7 @@ function throwIfAborted(signal){
 }
 
 async function canonicalWorkspaceRoot(workspaceRoot){
-    if(typeof workspaceRoot!=='string'||!workspaceRoot.trim()){
+    if(!is.string(workspaceRoot)||!workspaceRoot.trim()){
         fail('workspaceRoot is required to materialize an installed SDK runtime.');
     }
     const requested=path.resolve(workspaceRoot);

package/src/integrated-provider-loader.mjs

@@ -1,9 +1,12 @@
+import Is from 'strong-type';
 import {stat} from 'node:fs/promises';
 import path from 'node:path';
 import {pathToFileURL} from 'node:url';
 import {ArcaneError,ERROR_CODES,throwIfAborted} from './errors.mjs';
 import {runProcess} from './process.mjs';
 
+const is = new Is(false);
+
 export const INTEGRATED_TOOLCHAIN_PROTOCOL='arcane-integrated-toolchain/1';
 export const ARCANE_INTEGRATED_PROVIDER_RELATIVE_PATH=[
     'tools',
@@ -19,7 +22,7 @@ async function emit(onEvent,event){
 }
 
 async function selectedProvider(arcaneRoot){
-    if(typeof arcaneRoot!=='string'||!arcaneRoot.trim()){
+    if(!is.string(arcaneRoot)||!arcaneRoot.trim()){
         fail('An explicit Arcane OS root is required for shared development.',ERROR_CODES.usage);
     }
     const toolchainRoot=path.resolve(arcaneRoot);
@@ -53,10 +56,10 @@ async function selectedProvider(arcaneRoot){
 async function importedProvider(providerPath){
     const namespace=await import(pathToFileURL(providerPath).href);
     const provider=namespace?.integratedDevelopmentProvider;
-    if(!provider||typeof provider!=='object'
-        ||typeof provider.describe!=='function'
-        ||typeof provider.prepare!=='function'
-        ||typeof provider.execute!=='function'){
+    if(!provider||!is.object(provider)
+        ||!is.function(provider.describe)
+        ||!is.function(provider.prepare)
+        ||!is.function(provider.execute)){
         fail('The integrated provider must export integratedDevelopmentProvider.');
     }
     return provider;
@@ -69,7 +72,7 @@ export async function loadArcaneIntegratedProvider({
     run=runProcess
 }={}){
     throwIfAborted(signal);
-    if(typeof run!=='function'){
+    if(!is.function(run)){
         fail('The integrated provider process runner must be a function.',ERROR_CODES.usage);
     }
     await emit(onEvent,{

package/src/mail-credentials.mjs

@@ -1,8 +1,11 @@
+import Is from 'strong-type';
 import {spawn} from 'node:child_process';
 import path from 'node:path';
 import {TextDecoder} from 'node:util';
 import {ArcaneError,ERROR_CODES} from './errors.mjs';
 
+const is = new Is(false);
+
 export const RESEND_CREDENTIAL_TARGET_PREFIX='ArcaneOSSDK/mail/resend/';
 
 const CREDENTIAL_STORE='windows-credential-manager';
@@ -264,7 +267,7 @@ function assertNotAborted(signal){
 }
 
 export function validateMailCredentialProfile(profile){
-    if(typeof profile!=='string'||profile.length>MAX_PROFILE_LENGTH
+    if(!is.string(profile)||profile.length>MAX_PROFILE_LENGTH
         ||!PROFILE_PATTERN.test(profile)){
         throw usageError(
             'A credential profile must be 1-64 lowercase letters, digits, dots, underscores, or hyphens, and must begin and end with a letter or digit.'
@@ -278,7 +281,7 @@ export function mailCredentialTarget(profile){
 }
 
 function validateSecret(secret){
-    if(typeof secret!=='string'||!SECRET_PATTERN.test(secret)
+    if(!is.string(secret)||!SECRET_PATTERN.test(secret)
         ||Buffer.byteLength(secret,'utf8')>MAX_CREDENTIAL_BYTES){
         throw usageError(
             'A Resend API key must be a nonempty printable ASCII string no larger than 2,560 bytes.'
@@ -292,7 +295,7 @@ function validatePlatform(platform){
 }
 
 function validateTimeout(timeoutMs){
-    if(!Number.isSafeInteger(timeoutMs)||timeoutMs<1||timeoutMs>MAX_HELPER_TIMEOUT_MS){
+    if(!is.safeInteger(timeoutMs)||timeoutMs<1||timeoutMs>MAX_HELPER_TIMEOUT_MS){
         throw usageError(
             `Credential helper timeout must be an integer from 1 through ${String(MAX_HELPER_TIMEOUT_MS)} milliseconds.`
         );
@@ -301,7 +304,7 @@ function validateTimeout(timeoutMs){
 }
 
 function powershellExecutable(systemRoot){
-    if(typeof systemRoot!=='string'||systemRoot.length===0
+    if(!is.string(systemRoot)||systemRoot.length===0
         ||systemRoot.includes('\0')||!path.win32.isAbsolute(systemRoot)){
         throw unavailableError();
     }
@@ -327,7 +330,7 @@ function helperArguments(){
 }
 
 function helperEnvironment(systemRoot,temporaryDirectory){
-    if(typeof temporaryDirectory!=='string'||temporaryDirectory.length===0
+    if(!is.string(temporaryDirectory)||temporaryDirectory.length===0
         ||temporaryDirectory.includes('\0')||!path.win32.isAbsolute(temporaryDirectory)){
         throw unavailableError();
     }
@@ -352,7 +355,7 @@ function parseResponse(buffer){
     try{
         responseText=buffer.toString('utf8');
         const response=JSON.parse(responseText);
-        if(response===null||typeof response!=='object'||Array.isArray(response)
+        if(response===null||!is.object(response)||is.array(response)
             ||response.ok!==true){
             throw operationError();
         }
@@ -374,7 +377,7 @@ function runCredentialProcess({
     signal,
     timeoutMs
 }){
-    if(typeof spawnImpl!=='function')throw usageError('spawnImpl must be a function.');
+    if(!is.function(spawnImpl))throw usageError('spawnImpl must be a function.');
     let input=stdin;
     return new Promise(function executeCredentialHelper(resolve,reject){
         let child;
@@ -494,7 +497,7 @@ async function runWindowsCredentialHelper(request,{
 }={}){
     validatePlatform(platform);
     assertNotAborted(signal);
-    if(typeof runner!=='function')throw usageError('runner must be a function.');
+    if(!is.function(runner))throw usageError('runner must be a function.');
     const executable=powershellExecutable(systemRoot);
     const args=helperArguments();
     const boundedTimeout=validateTimeout(timeoutMs);
@@ -527,7 +530,7 @@ async function runWindowsCredentialHelper(request,{
         invocation.stdin='';
         requestText='';
     }
-    if(typeof output==='string')output=Buffer.from(output,'utf8');
+    if(is.string(output))output=Buffer.from(output,'utf8');
     if(!Buffer.isBuffer(output))throw operationError();
     if(output.length>MAX_HELPER_OUTPUT_BYTES){
         output.fill(0);
@@ -557,7 +560,7 @@ function credentialStatus(profile,exists){
 }
 
 function validateOptions(options){
-    if(options===null||typeof options!=='object'||Array.isArray(options)){
+    if(options===null||!is.object(options)||is.array(options)){
         throw usageError('Mail credential options must be an object.');
     }
     return options;
@@ -601,7 +604,7 @@ export async function setMailCredential(options={}){
 }
 
 function decodeSecret(value){
-    if(typeof value!=='string'||value.length===0||value.length%4!==0
+    if(!is.string(value)||value.length===0||value.length%4!==0
         ||!BASE64_PATTERN.test(value)){
         throw operationError();
     }
@@ -648,7 +651,7 @@ export async function getMailCredentialStatus(options={}){
         {operation:'status',target},
         helperOptions(options)
     );
-    if(typeof response.configured!=='boolean')throw operationError();
+    if(!is.boolean(response.configured))throw operationError();
     return credentialStatus(validatedProfile,response.configured);
 }
 
@@ -660,7 +663,7 @@ export async function deleteMailCredential(options={}){
         {operation:'delete',target},
         helperOptions(options)
     );
-    if(typeof response.deleted!=='boolean'||response.configured!==false){
+    if(!is.boolean(response.deleted)||response.configured!==false){
         throw operationError();
     }
     return credentialStatus(validatedProfile,false);