vona-core 5.1.49 → 5.1.51

package/dist/index.js

@@ -663,6 +663,10 @@ function _resolverAddonFile(addonName, projectPath, resolver) {
   }
 }
 
+const queryCoercion = new AsyncLocalStorage();
+function runWithZodQueryCoercion(enabled, fn) {
+  return queryCoercion.run(enabled, fn);
+}
 function zodEnhance() {
   setLocaleAdapter((text, iss) => {
     const app = useApp();
@@ -670,7 +674,7 @@ function zodEnhance() {
       return app.meta.text(text, ...args);
     }, text, iss);
   });
-  setParseAdapter(ZodMetadata);
+  setParseAdapter(ZodMetadata, () => queryCoercion.getStore() !== false);
 }
 function zodSetLocaleErrors(app, localeErrors, localeDefault) {
   setLocaleErrors(() => {
@@ -2700,6 +2704,191 @@ class VonaAsyncLocalStorage extends AsyncLocalStorage {
   }
 }
 
+const owners = new WeakMap();
+const capabilities = new WeakMap();
+const captures = new WeakSet();
+const pins = new WeakMap();
+function createCompletedReadiness(appIdentity) {
+  const state = {
+    app: appIdentity,
+    application: 'starting',
+    applicationAttempt: Object.freeze({}),
+    attempts: new Map(),
+    provisions: new Map(),
+    publications: new Map()
+  };
+  const facade = Object.freeze({
+    snapshot: () => Object.freeze({
+      application: state.application
+    })
+  });
+  owners.set(facade, state);
+  return facade;
+}
+
+// Internal framework integration only. None of the issuance/provisioning helpers are barrel exports.
+function beginCompletedApplication(owner) {
+  const state = owners.get(owner);
+  state.publications.clear();
+  state.attempts.clear();
+  state.applicationAttempt = Object.freeze({});
+  if (state.application !== 'closing') state.application = 'starting';
+  return state.applicationAttempt;
+}
+function finishCompletedApplication(owner, attempt, success) {
+  const state = owners.get(owner);
+  if (state.application === 'closing' || state.applicationAttempt !== attempt) return;
+  state.application = success ? 'ready' : 'failed';
+  if (!success) state.publications.clear();
+}
+function closeCompletedReadiness(owner) {
+  const state = owners.get(owner);
+  state.application = 'closing';
+  state.publications.clear();
+  state.attempts.clear();
+}
+function invalidateCompletedInstance(owner, name) {
+  if (!owner) return;
+  const state = owners.get(owner);
+  state.attempts.set(name, Object.freeze({}));
+  state.publications.delete(name);
+}
+function beginCompletedInstance(owner, name) {
+  if (!owner) return;
+  invalidateCompletedInstance(owner, name);
+  return owners.get(owner).attempts.get(name);
+}
+function rowCopy(value) {
+  if (!value || typeof value !== 'object') return;
+  const fields = ['id', 'name', 'disabled', 'isolate', 'config'];
+  const data = Object.create(null);
+  for (const key of fields) {
+    const desc = Object.getOwnPropertyDescriptor(value, key);
+    if (!desc || !('value' in desc)) return;
+    data[key] = desc.value;
+  }
+  if (typeof data.id !== 'number' || !Number.isSafeInteger(data.id) || data.id <= 0 || typeof data.name !== 'string' || !data.name.isWellFormed() || data.name.includes('\0') || Buffer.byteLength(data.name) > 256 || data.disabled !== false || typeof data.isolate !== 'boolean' || !(data.config === null || typeof data.config === 'string' && data.config.isWellFormed() && Buffer.byteLength(data.config) <= 65_536)) {
+    return;
+  }
+  return Object.freeze(data);
+}
+function detach(value, functions, active = new Set(), depth = 0, budget = {
+  nodes: 0
+}) {
+  if (++budget.nodes > 100_000 || depth > 64) throw new Error('Unsupported completed configuration');
+  if (value === null || value === undefined || typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number' && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === 'function') {
+    if (!functions.has(value) || !Object.isFrozen(value)) throw new Error('Unsupported completed configuration');
+    for (const key of Reflect.ownKeys(value)) {
+      const desc = Object.getOwnPropertyDescriptor(value, key);
+      if (!('value' in desc) || desc.writable || desc.value && (typeof desc.value === 'object' || typeof desc.value === 'function')) {
+        throw new Error('Unsupported completed configuration');
+      }
+    }
+    return value;
+  }
+  if (typeof value !== 'object' || !value || active.has(value)) throw new Error('Unsupported completed configuration');
+  const array = Array.isArray(value);
+  const proto = Object.getPrototypeOf(value);
+  if (!array && proto !== Object.prototype && proto !== null || array && proto !== Array.prototype) {
+    throw new Error('Unsupported completed configuration');
+  }
+  active.add(value);
+  const result = array ? [] : Object.create(null);
+  for (const key of Reflect.ownKeys(value)) {
+    if (array && key === 'length') continue;
+    if (typeof key !== 'string') throw new Error('Unsupported completed configuration');
+    const desc = Object.getOwnPropertyDescriptor(value, key);
+    if (!('value' in desc)) throw new Error('Unsupported completed configuration');
+    Object.defineProperty(result, key, {
+      value: detach(desc.value, functions, active, depth + 1, budget),
+      enumerable: desc.enumerable,
+      configurable: false,
+      writable: false
+    });
+  }
+  if (array) Object.defineProperty(result, 'length', {
+    value: value.length
+  });
+  active.delete(value);
+  return Object.freeze(result);
+}
+function captureCompletedInstance(owner, name, attempt, row, config) {
+  if (!owner || !attempt) return;
+  const state = owners.get(owner);
+  const provision = state.provisions.get(name);
+  if (!provision || state.application === 'closing' || state.attempts.get(name) !== attempt) return;
+  try {
+    const capturedRow = rowCopy(row);
+    if (!capturedRow || capturedRow.name !== name || capturedRow.isolate !== provision.isolate) return;
+    const snapshot = detach(config, provision.functions);
+    if (!snapshot || typeof snapshot !== 'object') return;
+    const captured = Object.freeze({
+      attempt,
+      provision,
+      row: capturedRow,
+      config: snapshot
+    });
+    captures.add(captured);
+    return captured;
+  } catch {
+    // Unsupported snapshots leave admission unavailable without inspecting the failure.
+  }
+}
+function finishCompletedInstance(owner, name, attempt, captured) {
+  if (!owner || !attempt || !captured || !captures.has(captured)) return;
+  const state = owners.get(owner);
+  const publication = captured;
+  if (state.application !== 'closing' && state.application !== 'failed' && state.attempts.get(name) === attempt && publication.attempt === attempt && state.provisions.get(name) === publication.provision) {
+    state.publications.set(name, publication);
+  }
+}
+function resolveExistingReadyCapability(owner, capability, app) {
+  const issued = capabilities.get(capability),
+    state = owners.get(owner);
+  if (!issued || issued.owner !== owner || !state || state.application !== 'ready' || app && app !== state.app) {
+    return;
+  }
+  try {
+    const current = issued.now();
+    if (!Number.isFinite(current) || current >= issued.deadline) return;
+  } catch {
+    return;
+  }
+  const publication = issued.publication;
+  if (state.publications.get(publication.row.name) !== publication || state.attempts.get(publication.row.name) !== publication.attempt) {
+    return;
+  }
+  return Object.freeze({
+    publication,
+    name: publication.row.name,
+    handle: publication.provision.handle
+  });
+}
+function pinExistingReadyContext(owner, capability, app, context) {
+  const resolved = resolveExistingReadyCapability(owner, capability, app);
+  if (!resolved || pins.has(context)) return false;
+  const publication = resolved.publication;
+  pins.set(context, publication);
+  for (const [key, value] of [['config', publication.config], ['instance', publication.row], ['instanceName', publication.row.name], ['innerAccess', false]]) {
+    Object.defineProperty(context, key, {
+      value,
+      enumerable: true,
+      configurable: false,
+      writable: false
+    });
+  }
+  return true;
+}
+function getExistingReadyContextConfig(context) {
+  return pins.get(context)?.config;
+}
+function isExistingReadyContext(context) {
+  return !!context && pins.has(context);
+}
+
 const BEAN = Symbol.for('Context#__bean');
 const INNERACCESS = Symbol.for('Context#__inneraccess');
 const CTXCALLER = Symbol.for('Context#__ctxcaller');
@@ -2738,6 +2927,8 @@ const contextBase = {
   },
   get config() {
     const self = cast(this);
+    const pinned = getExistingReadyContextConfig(self);
+    if (pinned) return pinned;
     const serviceInstance = cast(self.app.bean._getBean('a-instance.service.instance'));
     return serviceInstance.getConfig(self.instanceName) || self.app.config;
   },
@@ -3042,6 +3233,7 @@ class AppMeta extends BeanSimple {
     this.hmrCacheLocaleModules = void 0;
     this.hmrCacheConfigModules = void 0;
     //
+    this.completedReadiness = void 0;
     this.appReady = void 0;
     this.appReadyInstances = void 0;
     //
@@ -3052,6 +3244,7 @@ class AppMeta extends BeanSimple {
     this.appClosed = void 0;
   }
   __init__(env) {
+    this.completedReadiness = createCompletedReadiness(this.app);
     // env
     this.env = env;
     this._prepareEnv();
@@ -3109,6 +3302,7 @@ class AppMeta extends BeanSimple {
     });
   }
   async close() {
+    closeCompletedReadiness(this.completedReadiness);
     if (!this[SymbolClosePromise]) {
       this[SymbolClosePromise] = this._closeInner();
     }
@@ -3468,9 +3662,12 @@ function decode(source) {
     throw new Error('Windows test claim filesystem helper returned an invalid response');
   }
   if (!value || value.ok !== true) {
-    const error = new Error(value?.code === 'EEXIST' ? 'Test claim file already exists' : `Unsafe Windows test claim filesystem operation (${value?.code ?? 'unknown'})`);
+    const code = ['EEXIST', 'ENOENT', 'EBUSY', 'EACCES', 'EUNSAFE'].includes(value?.code) ? value.code : 'EUNSAFE';
+    const nativeCode = Number.isInteger(value?.nativeCode) && value.nativeCode >= 0 && value.nativeCode <= 65535 ? value.nativeCode : 0;
+    const error = new Error(`Unsafe Windows test claim filesystem operation (${code}, nativeCode=${nativeCode})`);
     Object.assign(error, {
-      code: value?.code ?? 'EUNSAFE'
+      code,
+      nativeCode
     });
     throw error;
   }
@@ -4160,9 +4357,19 @@ async function startTestClaimBroker(claimPath) {
   const update = event => {
     if (closing) return Promise.reject(new Error('Test claim broker is closed'));
     const result = queue.then(async () => {
-      const manifest = await loadTestClaim(claimPath);
-      applyEvent(manifest, event);
-      await writeTestClaim(claimPath, manifest);
+      let phase = 'read';
+      try {
+        const manifest = await loadTestClaim(claimPath);
+        phase = 'validate';
+        applyEvent(manifest, event);
+        phase = 'write';
+        await writeTestClaim(claimPath, manifest);
+      } catch (error) {
+        if (error instanceof Error) Object.assign(error, {
+          testClaimPhase: phase
+        });
+        throw error;
+      }
     });
     queue = result.catch(() => {});
     return result;
@@ -4183,8 +4390,15 @@ async function startTestClaimBroker(claimPath) {
       }
       if (req.url === '/containment') await containment(parseTestClaimJson(body));else await update(parseTestClaimJson(body));
       res.writeHead(204).end();
-    } catch {
-      res.writeHead(409).end('Test claim registration rejected');
+    } catch (error) {
+      const failure = error;
+      const headers = {};
+      if (['read', 'validate', 'write'].includes(failure?.testClaimPhase)) headers['x-vona-claim-phase'] = failure.testClaimPhase;
+      if (['EEXIST', 'ENOENT', 'EBUSY', 'EACCES', 'EUNSAFE'].includes(failure?.code)) headers['x-vona-claim-code'] = failure.code;
+      if (Number.isInteger(failure?.nativeCode) && failure.nativeCode >= 0 && failure.nativeCode <= 65535) {
+        headers['x-vona-claim-native-code'] = String(failure.nativeCode);
+      }
+      res.writeHead(409, headers).end('Test claim registration rejected');
     }
   });
   server.requestTimeout = 10000;
@@ -4234,20 +4448,34 @@ function hasTestClaimTransport(env = process.env) {
 }
 async function sendTestClaimEvent(env, event) {
   if (!hasTestClaimTransport(env)) return;
+  let response;
   try {
-    const response = await fetch(env[TEST_CLAIM_URL_ENV], {
+    response = await fetch(env[TEST_CLAIM_URL_ENV], {
       method: 'POST',
       headers: {
         'authorization': `Bearer ${env[TEST_CLAIM_TOKEN_ENV]}`,
+        // Startup can block past the broker's idle timeout; never reuse a stale socket.
+        'connection': 'close',
         'content-type': 'application/json'
       },
       body: JSON.stringify(event),
-      signal: AbortSignal.timeout(10000),
+      // Includes the serialized queue and durable Windows filesystem work (30s per operation).
+      signal: AbortSignal.timeout(120000),
       redirect: 'error'
     });
-    if (response.status !== 204) throw new Error('Registration rejected');
   } catch {
-    throw new Error('Managed test allocation registration failed');
+    throw new Error('Managed test allocation registration failed (transport)');
+  }
+  if (response.status !== 204) {
+    const details = [`HTTP ${response.status}`];
+    const phase = response.headers.get('x-vona-claim-phase');
+    const code = response.headers.get('x-vona-claim-code');
+    const nativeCode = response.headers.get('x-vona-claim-native-code');
+    if (['read', 'validate', 'write'].includes(phase)) details.push(phase);
+    if (['EEXIST', 'ENOENT', 'EBUSY', 'EACCES', 'EUNSAFE'].includes(code)) details.push(code);
+    if (nativeCode && /^\d{1,5}$/.test(nativeCode) && Number(nativeCode) <= 65535) details.push(`native ${nativeCode}`);
+    await response.body?.cancel().catch(() => {});
+    throw new Error(`Managed test allocation registration failed (${details.join(', ')})`);
   }
 }
 
@@ -4269,6 +4497,8 @@ async function assertTestClaimWindowsJob(env, identity) {
       method: 'POST',
       headers: {
         'authorization': `Bearer ${env[TEST_CLAIM_TOKEN_ENV]}`,
+        // Startup can block past the broker's idle timeout; never reuse a stale socket.
+        'connection': 'close',
         'content-type': 'application/json'
       },
       body: JSON.stringify(query),
@@ -4865,6 +5095,8 @@ class Start {
   }
   async start() {
     const app = this.app;
+    const owner = app.meta.completedReadiness;
+    const attempt = beginCompletedApplication(owner);
     try {
       await this._start_appConfig();
       await assertFreshTestResources(app);
@@ -4872,7 +5104,9 @@ class Start {
       await this._start_appStart();
       await this._start_appReady();
       await this._start_appStarted();
+      finishCompletedApplication(owner, attempt, true);
     } catch (err) {
+      finishCompletedApplication(owner, attempt, false);
       // record
       app.meta.appStartError = err;
       // event: appReadyError
@@ -5257,5 +5491,5 @@ async function retry(options, fn) {
 
 zodExtendOpenApi();
 
-export { $Class, $localeScope, $makeLocaleMagic, $protocolKey, AppHmr, AppHmrDeps, AppLocale, AppLogger, AppMeta, AppMetadata, AppResource, AppUtil, BeanAopBase, BeanAopMethodBase, BeanBase, BeanBaseSimple, BeanContainer, BeanInfo, BeanScopeBase, BeanScopeContainer, BeanScopeError, BeanScopeErrorImpl, BeanScopeLocale, BeanScopeScene, BeanScopeUtil, BeanSimple, EnumAppEvent, ErrorClass, Global, LocaleModuleNameSeparator, PickClassInner, ProxyDisable, SymbolBeanContainerInstances, SymbolBeanFullName, SymbolBeanInstanceKey, SymbolBeanInstancePropsLazy, SymbolCacheAopChains, SymbolCacheAopChainsKey, SymbolDecoratorBeanFullName, SymbolDecoratorBeanInfo, SymbolDecoratorGlobal, SymbolDecoratorProxyDisable, SymbolDecoratorUse, SymbolDecoratorVirtual, SymbolHmrStateLoad, SymbolHmrStateSave, SymbolMappedClassMetadataKeys, SymbolModuleBelong, SymbolModuleName, TEST_CLAIM_DIRECTORY, TEST_CLAIM_TOKEN_ENV, TEST_CLAIM_URL_ENV, TEST_CLAIM_WINDOWS_GUARDIAN_ENV, TEST_REQUIRE_FRESH_RESOURCES_ENV, TEST_RUN_ID_ENV, TEST_RUN_OWNER_FILE, Use, Virtual, VonaApplication, __prepareInjectSelectorInfo, appHmrDeps, appMetadata, appResource, assertDisposableDatabaseName, assertFreshTestResources, assertFreshTestResourcesReady, assertIsolatedTestConfig, assertIsolatedTestDatabaseClient, assertIsolatedTestPath, assertTestAppIdentity, assertTestClaimDatabaseClient, assertTestClaimRedisClient, assertTestClaimSafePath, assertTestClaimWindowsJob, assertTestRunOwner, beanFullNameFromOnionName, bootstrap, buildTestClaimResourceInventory, captureRequestBoundary, cast, closeApp, closeProcessWorker, combineConfigDefault, combineFilePathSafe, compose, copyAddon, copyMetadataOfClasses, copyProperties, copyPropertiesOfClasses, createApp, createAppMaster, createBeanDecorator, createDiagnosticLogger, createFreshnessDependencies, createGeneralApp, createHash, createRequestBoundary, createTestClaim, deepExtend, disposeInstance, errorsInternal, filterHeaders, formatLoggerAxiosError, formatLoggerBoundary, formatLoggerConsole, formatLoggerCtx, formatLoggerDummy, formatLoggerErrors, formatLoggerFilter, functionNoop, getDatabaseTestPrefix, getHomeVonaAppDir, getLoggerPathPhysicalRoot, getMappedClassMetadataKeys, getPlatformArch, getPublicPathPhysicalRoot, getRequestBoundary, getRuntimePathPhysicalRoot, getSqlite3DatabaseNameDefault, getSuppressedDiagnosticLogger, getTestAppName, getTestClaimCreatedAt, getTestClaimPaths, getTestClaimRedisPrefix, getTestRunIdFromEnv, hasFreshnessDatabase, hasFreshnessRedis, hasTestClaimTransport, instanceDesp, isLocaleMagic, loadJSONFile, loadTestClaim, mergeTestClaimDatabaseOptions, mergeTestClaimRedisOptions, normalizeTestClaimDatabaseEndpoint, normalizeTestClaimRedisEndpoint, onionNameFromBeanFullName, pathToHref, polyfillDispose, prepareEnv, registerMappedClassMetadataKey, registerTestClaimDatabaseCreation, registerTestClaimResourceInventory, registerTestClaimWindowsJobVerifier, requireAddon, requireDynamic, requiresFreshTestResources, resolveAddon, resolveTestRunId, resolveVonaLocalPaths, resolverSharp, resolverSharpLibvips, resolverSqlite3, retry, runWithRequestBoundary, saveJSONFile, sendTestClaimEvent, setMappedClassMetadataKeys, startTestClaimBroker, text$1 as text, useApp, usePrepareArg, usePrepareArgs, uuidv4, validateTestClaim, withIsolatedTestDatabaseDiscovery, writeTestClaim };
+export { $Class, $localeScope, $makeLocaleMagic, $protocolKey, AppHmr, AppHmrDeps, AppLocale, AppLogger, AppMeta, AppMetadata, AppResource, AppUtil, BeanAopBase, BeanAopMethodBase, BeanBase, BeanBaseSimple, BeanContainer, BeanInfo, BeanScopeBase, BeanScopeContainer, BeanScopeError, BeanScopeErrorImpl, BeanScopeLocale, BeanScopeScene, BeanScopeUtil, BeanSimple, EnumAppEvent, ErrorClass, Global, LocaleModuleNameSeparator, PickClassInner, ProxyDisable, SymbolBeanContainerInstances, SymbolBeanFullName, SymbolBeanInstanceKey, SymbolBeanInstancePropsLazy, SymbolCacheAopChains, SymbolCacheAopChainsKey, SymbolDecoratorBeanFullName, SymbolDecoratorBeanInfo, SymbolDecoratorGlobal, SymbolDecoratorProxyDisable, SymbolDecoratorUse, SymbolDecoratorVirtual, SymbolHmrStateLoad, SymbolHmrStateSave, SymbolMappedClassMetadataKeys, SymbolModuleBelong, SymbolModuleName, TEST_CLAIM_DIRECTORY, TEST_CLAIM_TOKEN_ENV, TEST_CLAIM_URL_ENV, TEST_CLAIM_WINDOWS_GUARDIAN_ENV, TEST_REQUIRE_FRESH_RESOURCES_ENV, TEST_RUN_ID_ENV, TEST_RUN_OWNER_FILE, Use, Virtual, VonaApplication, __prepareInjectSelectorInfo, appHmrDeps, appMetadata, appResource, assertDisposableDatabaseName, assertFreshTestResources, assertFreshTestResourcesReady, assertIsolatedTestConfig, assertIsolatedTestDatabaseClient, assertIsolatedTestPath, assertTestAppIdentity, assertTestClaimDatabaseClient, assertTestClaimRedisClient, assertTestClaimSafePath, assertTestClaimWindowsJob, assertTestRunOwner, beanFullNameFromOnionName, beginCompletedInstance, bootstrap, buildTestClaimResourceInventory, captureCompletedInstance, captureRequestBoundary, cast, closeApp, closeProcessWorker, combineConfigDefault, combineFilePathSafe, compose, copyAddon, copyMetadataOfClasses, copyProperties, copyPropertiesOfClasses, createApp, createAppMaster, createBeanDecorator, createCompletedReadiness, createDiagnosticLogger, createFreshnessDependencies, createGeneralApp, createHash, createRequestBoundary, createTestClaim, deepExtend, disposeInstance, errorsInternal, filterHeaders, finishCompletedInstance, formatLoggerAxiosError, formatLoggerBoundary, formatLoggerConsole, formatLoggerCtx, formatLoggerDummy, formatLoggerErrors, formatLoggerFilter, functionNoop, getDatabaseTestPrefix, getHomeVonaAppDir, getLoggerPathPhysicalRoot, getMappedClassMetadataKeys, getPlatformArch, getPublicPathPhysicalRoot, getRequestBoundary, getRuntimePathPhysicalRoot, getSqlite3DatabaseNameDefault, getSuppressedDiagnosticLogger, getTestAppName, getTestClaimCreatedAt, getTestClaimPaths, getTestClaimRedisPrefix, getTestRunIdFromEnv, hasFreshnessDatabase, hasFreshnessRedis, hasTestClaimTransport, instanceDesp, invalidateCompletedInstance, isExistingReadyContext, isLocaleMagic, loadJSONFile, loadTestClaim, mergeTestClaimDatabaseOptions, mergeTestClaimRedisOptions, normalizeTestClaimDatabaseEndpoint, normalizeTestClaimRedisEndpoint, onionNameFromBeanFullName, pathToHref, pinExistingReadyContext, polyfillDispose, prepareEnv, registerMappedClassMetadataKey, registerTestClaimDatabaseCreation, registerTestClaimResourceInventory, registerTestClaimWindowsJobVerifier, requireAddon, requireDynamic, requiresFreshTestResources, resolveAddon, resolveExistingReadyCapability, resolveTestRunId, resolveVonaLocalPaths, resolverSharp, resolverSharpLibvips, resolverSqlite3, retry, runWithRequestBoundary, runWithZodQueryCoercion, saveJSONFile, sendTestClaimEvent, setMappedClassMetadataKeys, startTestClaimBroker, text$1 as text, useApp, usePrepareArg, usePrepareArgs, uuidv4, validateTestClaim, withIsolatedTestDatabaseDiscovery, writeTestClaim };
 //# sourceMappingURL=index.js.map