vona-core 5.1.56 → 5.1.58

package/dist/index.js

@@ -4,7 +4,7 @@ import { combineApiPathControllerAndActionRaw, combineApiPathControllerAndAction
 import { toLowerCaseFirstChar, splitWords } from '@cabloy/word-utils';
 import path from 'node:path';
 import fse from 'fs-extra';
-import crypto, { createHash as createHash$1, randomBytes, timingSafeEqual } from 'node:crypto';
+import crypto, { createHash as createHash$1, randomBytes, timingSafeEqual, randomUUID } from 'node:crypto';
 import fs, { lstatSync, existsSync, readFileSync, constants } from 'node:fs';
 import { compose as compose$1 } from '@cabloy/compose';
 import { extend } from '@cabloy/extend';
@@ -26,10 +26,11 @@ import chalk from 'chalk';
 import * as Winston from 'winston';
 import DailyRotateFile from 'winston-daily-rotate-file';
 import { MESSAGE, LEVEL } from 'triple-beam';
+import cluster from 'node:cluster';
+import { isMainThread } from 'node:worker_threads';
 import { createServer } from 'node:http';
 import { mkdir, open, rename, unlink, lstat, readdir } from 'node:fs/promises';
 import { execFileSync, execFile } from 'node:child_process';
-import cluster from 'node:cluster';
 import React from 'react';
 import { extendZodWithOpenApi } from '@cabloy/zod-to-openapi';
 import { z } from 'zod';
@@ -2734,7 +2735,7 @@ class VonaAsyncLocalStorage extends AsyncLocalStorage {
   }
 }
 
-const owners = new WeakMap();
+const owners$1 = new WeakMap();
 const capabilities = new WeakMap();
 const captures = new WeakSet();
 const pins = new WeakMap();
@@ -2752,13 +2753,13 @@ function createCompletedReadiness(appIdentity) {
       application: state.application
     })
   });
-  owners.set(facade, state);
+  owners$1.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);
+  const state = owners$1.get(owner);
   state.publications.clear();
   state.attempts.clear();
   state.applicationAttempt = Object.freeze({});
@@ -2766,27 +2767,27 @@ function beginCompletedApplication(owner) {
   return state.applicationAttempt;
 }
 function finishCompletedApplication(owner, attempt, success) {
-  const state = owners.get(owner);
+  const state = owners$1.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);
+  const state = owners$1.get(owner);
   state.application = 'closing';
   state.publications.clear();
   state.attempts.clear();
 }
 function invalidateCompletedInstance(owner, name) {
   if (!owner) return;
-  const state = owners.get(owner);
+  const state = owners$1.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);
+  return owners$1.get(owner).attempts.get(name);
 }
 function rowCopy(value) {
   if (!value || typeof value !== 'object') return;
@@ -2847,7 +2848,7 @@ function detach(value, functions, active = new Set(), depth = 0, budget = {
 }
 function captureCompletedInstance(owner, name, attempt, row, config) {
   if (!owner || !attempt) return;
-  const state = owners.get(owner);
+  const state = owners$1.get(owner);
   const provision = state.provisions.get(name);
   if (!provision || state.application === 'closing' || state.attempts.get(name) !== attempt) return;
   try {
@@ -2869,7 +2870,7 @@ function captureCompletedInstance(owner, name, attempt, row, config) {
 }
 function finishCompletedInstance(owner, name, attempt, captured) {
   if (!owner || !attempt || !captured || !captures.has(captured)) return;
-  const state = owners.get(owner);
+  const state = owners$1.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);
@@ -2877,7 +2878,7 @@ function finishCompletedInstance(owner, name, attempt, captured) {
 }
 function resolveExistingReadyCapability(owner, capability, app) {
   const issued = capabilities.get(capability),
-    state = owners.get(owner);
+    state = owners$1.get(owner);
   if (!issued || issued.owner !== owner || !state || state.application !== 'ready' || app && app !== state.app) {
     return;
   }
@@ -4758,6 +4759,184 @@ function assertTestClaimRedisClient(app, clientName, options) {
   if (plan.kind === 'client' ? options.keyPrefix !== plan.prefix : options.keyPrefix !== undefined) throw new Error('Unregistered managed Redis key prefix');
 }
 
+const owners = new WeakMap();
+const ownerStorage = new AsyncLocalStorage();
+class TestAsyncCompletion {
+  constructor(app, options) {
+    this.id = randomUUID();
+    this.instanceName = void 0;
+    this.clientName = void 0;
+    this.app = void 0;
+    this.databaseIdentity = void 0;
+    this.pending = new Map();
+    this.failures = [];
+    this.waiters = new Set();
+    this.version = 0;
+    this.closed = false;
+    if (!app.meta.isTest || !app.meta.appReady || !cluster.isPrimary || !isMainThread || process.env.NODE_UNIQUE_ID !== undefined || useApp() !== app) {
+      throw new Error('Test async completion requires the ready in-process test application');
+    }
+    const env = app.meta.env;
+    const runId = assertTestAppIdentity('test', env.VONA_TEST_RUN_ID, app.name);
+    if (!runId || env.META_MODE !== 'test' || process.env.VONA_TEST_RUN_ID !== runId || !hasTestClaimTransport()) {
+      throw new Error('Test async completion requires a managed test run');
+    }
+    const paths = resolveVonaLocalPaths(app.projectPath, 'test', runId);
+    assertTestRunOwner(paths.dataRoot, runId);
+    assertTestRunOwner(paths.generatedRoot, runId);
+    if (!options.instanceName || !options.clientName || options.clientName.includes(':')) {
+      throw new Error('Test async completion requires an instance and a database client name');
+    }
+    this.app = app;
+    this.instanceName = options.instanceName;
+    this.clientName = options.clientName;
+    this.databaseIdentity = getDatabaseIdentity(app, this.clientName);
+    let registry = owners.get(app);
+    if (!registry) {
+      registry = new Map();
+      owners.set(app, registry);
+    }
+    registry.set(this.id, this);
+  }
+  async run(fn) {
+    const ticket = this.reserve('run');
+    try {
+      return await this.bind(fn);
+    } finally {
+      ticket.complete();
+    }
+  }
+  reserve(label) {
+    this.assertOpen();
+    const key = Symbol(label);
+    this.pending.set(key, label);
+    this.version++;
+    return {
+      complete: error => {
+        if (!this.pending.delete(key)) return;
+        if (error !== undefined) this.failures.push(error);
+        this.version++;
+        for (const wake of this.waiters) wake();
+        this.waiters.clear();
+      }
+    };
+  }
+  track(label, fn) {
+    const ticket = this.reserve(label);
+    const result = this.bind(async () => {
+      try {
+        return await fn();
+      } catch (error) {
+        ticket.complete(error === undefined ? new Error(`Test async operation rejected: ${label}`) : error);
+        throw error;
+      } finally {
+        ticket.complete();
+      }
+    });
+    void result.catch(() => {});
+    return result;
+  }
+  bind(fn) {
+    this.assertOpen();
+    return ownerStorage.run(this, fn);
+  }
+  async settle({
+    timeout = 30_000
+  } = {}) {
+    if (ownerStorage.getStore()) {
+      throw new Error('Test async completion cannot settle from an active owner context');
+    }
+    if (!Number.isFinite(timeout) || timeout < 0 || timeout > 2_147_483_647) {
+      throw new Error('Test async completion timeout must be a valid nonnegative timer duration');
+    }
+    let timedOut = false;
+    let wake;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      wake?.();
+    }, timeout);
+    try {
+      while (true) {
+        if (timedOut) {
+          throw new Error(`Test async completion timed out; pending: ${[...this.pending.values()].join(', ')}`);
+        }
+        if (this.pending.size) {
+          await new Promise(resolve => {
+            wake = resolve;
+            this.waiters.add(resolve);
+          });
+          continue;
+        }
+        const version = this.version;
+        await Promise.resolve();
+        if (this.pending.size || this.version !== version) continue;
+        this.assertSettled();
+        return;
+      }
+    } finally {
+      clearTimeout(timer);
+      if (wake) this.waiters.delete(wake);
+    }
+  }
+  assertSettled() {
+    if (this.pending.size) {
+      throw new Error(`Test async completion is pending: ${[...this.pending.values()].join(', ')}`);
+    }
+    if (this.failures.length) {
+      throw new AggregateError(this.failures, 'Test async completion failed');
+    }
+  }
+  assertScope(options) {
+    this.assertOpen();
+    if (options?.instanceName !== this.instanceName && options?.instanceName !== null || options?.dbInfo?.clientName !== this.clientName) {
+      throw new Error('Test async completion scope does not match its owner');
+    }
+    if (!isDeepStrictEqual(this.databaseIdentity, getDatabaseIdentity(this.app, this.clientName))) {
+      throw new Error('Test async completion database identity changed');
+    }
+  }
+  close() {
+    this.assertSettled();
+    owners.get(this.app)?.delete(this.id);
+    this.closed = true;
+  }
+  assertOpen() {
+    if (this.closed) throw new Error('Test async completion is closed');
+  }
+}
+function createTestAsyncCompletion(app, options) {
+  return new TestAsyncCompletion(app, options);
+}
+function getTestAsyncCompletion(app) {
+  const owner = ownerStorage.getStore();
+  return owner && owners.get(app)?.get(owner.id) === owner ? owner : undefined;
+}
+function withoutTestAsyncCompletion(fn) {
+  return ownerStorage.exit(fn);
+}
+function findTestAsyncCompletion(app, id) {
+  return owners.get(app)?.get(id);
+}
+function getDatabaseIdentity(app, clientName) {
+  const bean = app.bean;
+  const client = bean.database.getClient(clientName);
+  if (client.clientName !== clientName) {
+    throw new Error('Test async completion requires a resolved database client name');
+  }
+  const config = client.clientConfig;
+  assertIsolatedTestDatabaseClient(app, clientName, config);
+  assertTestClaimDatabaseClient(app, clientName, config);
+  const connection = config.connection;
+  return {
+    name: client.getDatabaseName(),
+    client: config.client,
+    host: connection.host,
+    port: connection.port,
+    database: connection.database,
+    filename: connection.filename
+  };
+}
+
 const freshApps = new WeakSet();
 function assertFreshTestResourcesReady(app) {
   if (!requiresFreshTestResources()) return;
@@ -5536,5 +5715,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, beginCompletedInstance, bootstrap, buildTestClaimResourceInventory, canonicalizeLocale, 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, resolveEnabledLocale, resolveExistingReadyCapability, resolveLocale, resolveTestRunId, resolveVonaLocalPaths, resolverSharp, resolverSharpLibvips, resolverSqlite3, retry, runWithRequestBoundary, runWithZodQueryCoercion, saveJSONFile, sendTestClaimEvent, setMappedClassMetadataKeys, startTestClaimBroker, text$1 as text, useApp, usePrepareArg, usePrepareArgs, uuidv4, validateLocaleConfig, 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, TestAsyncCompletion, Use, Virtual, VonaApplication, __prepareInjectSelectorInfo, appHmrDeps, appMetadata, appResource, assertDisposableDatabaseName, assertFreshTestResources, assertFreshTestResourcesReady, assertIsolatedTestConfig, assertIsolatedTestDatabaseClient, assertIsolatedTestPath, assertTestAppIdentity, assertTestClaimDatabaseClient, assertTestClaimRedisClient, assertTestClaimSafePath, assertTestClaimWindowsJob, assertTestRunOwner, beanFullNameFromOnionName, beginCompletedInstance, bootstrap, buildTestClaimResourceInventory, canonicalizeLocale, captureCompletedInstance, captureRequestBoundary, cast, closeApp, closeProcessWorker, combineConfigDefault, combineFilePathSafe, compose, copyAddon, copyMetadataOfClasses, copyProperties, copyPropertiesOfClasses, createApp, createAppMaster, createBeanDecorator, createCompletedReadiness, createDiagnosticLogger, createFreshnessDependencies, createGeneralApp, createHash, createRequestBoundary, createTestAsyncCompletion, createTestClaim, deepExtend, disposeInstance, errorsInternal, filterHeaders, findTestAsyncCompletion, finishCompletedInstance, formatLoggerAxiosError, formatLoggerBoundary, formatLoggerConsole, formatLoggerCtx, formatLoggerDummy, formatLoggerErrors, formatLoggerFilter, functionNoop, getDatabaseTestPrefix, getHomeVonaAppDir, getLoggerPathPhysicalRoot, getMappedClassMetadataKeys, getPlatformArch, getPublicPathPhysicalRoot, getRequestBoundary, getRuntimePathPhysicalRoot, getSqlite3DatabaseNameDefault, getSuppressedDiagnosticLogger, getTestAppName, getTestAsyncCompletion, 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, resolveEnabledLocale, resolveExistingReadyCapability, resolveLocale, resolveTestRunId, resolveVonaLocalPaths, resolverSharp, resolverSharpLibvips, resolverSqlite3, retry, runWithRequestBoundary, runWithZodQueryCoercion, saveJSONFile, sendTestClaimEvent, setMappedClassMetadataKeys, startTestClaimBroker, text$1 as text, useApp, usePrepareArg, usePrepareArgs, uuidv4, validateLocaleConfig, validateTestClaim, withIsolatedTestDatabaseDiscovery, withoutTestAsyncCompletion, writeTestClaim };
 //# sourceMappingURL=index.js.map