velocious 1.0.675 → 1.0.677

package/build/src/testing/browser-frontend-tenant-database-scenarios.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Exercises two durable physical tenant databases inside the real browser.
+ * @returns {Promise<{alphaNames: ReturnType<typeof JSON.parse>[], betaNames: ReturnType<typeof JSON.parse>[], identitiesAreDistinct: boolean, openCount: number}>} Serializable proof result.
+ */
+export default function runFrontendTenantDatabasePersistenceScenario(): Promise<{
+    alphaNames: ReturnType<typeof JSON.parse>[];
+    betaNames: ReturnType<typeof JSON.parse>[];
+    identitiesAreDistinct: boolean;
+    openCount: number;
+}>;
+//# sourceMappingURL=browser-frontend-tenant-database-scenarios.d.ts.map

package/build/src/testing/browser-frontend-tenant-database-scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-frontend-tenant-database-scenarios.d.ts","sourceRoot":"","sources":["../../../src/testing/browser-frontend-tenant-database-scenarios.js"],"names":[],"mappings":"AAiEA;;;GAGG;AACH,wBAA8B,4CAA4C,IAF7D,OAAO,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAAC,SAAS,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAAC,qBAAqB,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CA0FjK"}

package/build/src/testing/browser-frontend-tenant-database-scenarios.js

@@ -0,0 +1,147 @@
+// @ts-check
+import Configuration, { CurrentConfigurationNotSetError } from "../configuration.js";
+import DatabaseRecord from "../database/record/index.js";
+import BrowserEnvironmentHandler from "../environment-handlers/browser.js";
+import Migration from "../database/migration/index.js";
+import SingleMultiUsePool from "../database/pool/single-multi-use.js";
+import SqliteWebDriver from "../database/drivers/sqlite/index.web.js";
+import Tenant from "../tenants/tenant.js";
+const DATABASE_IDENTIFIER = "projectTenant";
+const SCHEMA_GENERATION = "frontend-tenant-browser-persistence-1";
+/**
+ * Returns the current configuration without requiring one to exist.
+ * @returns {Configuration | undefined} Current configuration when installed.
+ */
+function currentConfigurationOrUndefined() {
+    try {
+        return Configuration.current();
+    }
+    catch (error) {
+        if (!(error instanceof CurrentConfigurationNotSetError))
+            throw error;
+        return undefined;
+    }
+}
+/**
+ * Builds the real browser-backed two-project configuration.
+ * @returns {Configuration} Browser tenant configuration.
+ */
+function buildConfiguration() {
+    return new Configuration({
+        database: {
+            test: {
+                projectTenant: {
+                    driver: SqliteWebDriver,
+                    locateFile: () => "/sql-wasm.wasm",
+                    migrations: true,
+                    name: "velocious-browser-project-proof-template",
+                    poolType: SingleMultiUsePool,
+                    tenantOnly: true,
+                    type: "sqlite"
+                }
+            }
+        },
+        directory: "/frontend-tenant-browser-persistence-scenario",
+        environment: "test",
+        environmentHandler: new BrowserEnvironmentHandler(),
+        frontendTenantSqlite: { maxOpenHandles: 2 },
+        initializeModels: async () => { },
+        locale: "en",
+        localeFallbacks: { en: ["en"] },
+        locales: ["en"],
+        tenantDatabaseResolver: ({ identifier, tenant }) => {
+            if (identifier !== DATABASE_IDENTIFIER || !tenant || typeof tenant !== "object")
+                return;
+            const projectSlug = /** @type {{projectSlug?: string}} */ (tenant).projectSlug;
+            if (projectSlug !== "alpha" && projectSlug !== "beta")
+                return;
+            return { name: `velocious-browser-project-proof-${projectSlug}` };
+        }
+    });
+}
+/**
+ * Exercises two durable physical tenant databases inside the real browser.
+ * @returns {Promise<{alphaNames: ReturnType<typeof JSON.parse>[], betaNames: ReturnType<typeof JSON.parse>[], identitiesAreDistinct: boolean, openCount: number}>} Serializable proof result.
+ */
+export default async function runFrontendTenantDatabasePersistenceScenario() {
+    const previousConfiguration = currentConfigurationOrUndefined();
+    const configuration = buildConfiguration();
+    class BrowserProjectRecord extends DatabaseRecord {
+    }
+    class CreateBrowserProjectRecords extends Migration {
+        async up() {
+            await this.execute("CREATE TABLE browser_project_records(id integer PRIMARY KEY AUTOINCREMENT, name varchar(255) NOT NULL)");
+        }
+    }
+    BrowserProjectRecord.setTableName("browser_project_records");
+    BrowserProjectRecord.switchesTenantDatabase(DATABASE_IDENTIFIER);
+    BrowserProjectRecord.registerRecordClass({ configuration });
+    CreateBrowserProjectRecords.onDatabases([DATABASE_IDENTIFIER]);
+    const migrationFile = "20260919090000-create-browser-project-records.js";
+    /**
+     * Loads the one migration bundled into this browser proof.
+     * @type {import("../database/migrator/types.js").RequireMigrationContextType}
+     */
+    const migrations = (fileName) => {
+        if (fileName !== migrationFile)
+            throw new Error(`Unknown browser tenant proof migration: ${fileName}`);
+        return { default: CreateBrowserProjectRecords };
+    };
+    migrations.keys = () => [migrationFile];
+    migrations.id = "frontend-tenant-browser-persistence-scenario";
+    const alpha = Tenant.handle({ projectSlug: "alpha" }, configuration);
+    const beta = Tenant.handle({ projectSlug: "beta" }, configuration);
+    configuration.setCurrent();
+    try {
+        await Promise.all([
+            alpha.delete({ databaseIdentifier: DATABASE_IDENTIFIER }),
+            beta.delete({ databaseIdentifier: DATABASE_IDENTIFIER })
+        ]);
+        await Promise.all([
+            alpha.initialize({ databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION }),
+            beta.initialize({ databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION })
+        ]);
+        for (let index = 0; index < 12; index++) {
+            await Promise.all([
+                alpha.databaseOperation({ databaseIdentifier: DATABASE_IDENTIFIER }, async (operation) => {
+                    await operation.forModel(BrowserProjectRecord).create({ name: `alpha-${index}` });
+                }),
+                beta.databaseOperation({ databaseIdentifier: DATABASE_IDENTIFIER }, async (operation) => {
+                    await operation.forModel(BrowserProjectRecord).create({ name: `beta-${index}` });
+                })
+            ]);
+        }
+        await Promise.all([
+            alpha.close({ databaseIdentifier: DATABASE_IDENTIFIER, flush: true }),
+            beta.close({ databaseIdentifier: DATABASE_IDENTIFIER, flush: true })
+        ]);
+        await Promise.all([
+            alpha.initialize({ databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION }),
+            beta.initialize({ databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION })
+        ]);
+        const [alphaNames, betaNames] = await Promise.all([
+            alpha.databaseOperation({ databaseIdentifier: DATABASE_IDENTIFIER }, async (operation) => {
+                return await operation.forModel(BrowserProjectRecord).order("id").pluck("name");
+            }),
+            beta.databaseOperation({ databaseIdentifier: DATABASE_IDENTIFIER }, async (operation) => {
+                return await operation.forModel(BrowserProjectRecord).order("id").pluck("name");
+            })
+        ]);
+        return {
+            alphaNames,
+            betaNames,
+            identitiesAreDistinct: alpha.databaseIdentity(DATABASE_IDENTIFIER) !== beta.databaseIdentity(DATABASE_IDENTIFIER),
+            openCount: configuration.inspectFrontendTenantSqliteHandles().openCount
+        };
+    }
+    finally {
+        await Promise.all([
+            alpha.delete({ databaseIdentifier: DATABASE_IDENTIFIER }),
+            beta.delete({ databaseIdentifier: DATABASE_IDENTIFIER })
+        ]);
+        if (previousConfiguration)
+            previousConfiguration.setCurrent();
+        await configuration.closeDatabaseConnections();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci1mcm9udGVuZC10ZW5hbnQtZGF0YWJhc2Utc2NlbmFyaW9zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3Rlc3RpbmcvYnJvd3Nlci1mcm9udGVuZC10ZW5hbnQtZGF0YWJhc2Utc2NlbmFyaW9zLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixPQUFPLGFBQWEsRUFBRSxFQUFFLCtCQUErQixFQUFFLE1BQU0scUJBQXFCLENBQUE7QUFDcEYsT0FBTyxjQUFjLE1BQU0sNkJBQTZCLENBQUE7QUFDeEQsT0FBTyx5QkFBeUIsTUFBTSxvQ0FBb0MsQ0FBQTtBQUMxRSxPQUFPLFNBQVMsTUFBTSxnQ0FBZ0MsQ0FBQTtBQUN0RCxPQUFPLGtCQUFrQixNQUFNLHNDQUFzQyxDQUFBO0FBQ3JFLE9BQU8sZUFBZSxNQUFNLHlDQUF5QyxDQUFBO0FBQ3JFLE9BQU8sTUFBTSxNQUFNLHNCQUFzQixDQUFBO0FBRXpDLE1BQU0sbUJBQW1CLEdBQUcsZUFBZSxDQUFBO0FBQzNDLE1BQU0saUJBQWlCLEdBQUcsdUNBQXVDLENBQUE7QUFFakU7OztHQUdHO0FBQ0gsU0FBUywrQkFBK0I7SUFDdEMsSUFBSSxDQUFDO1FBQ0gsT0FBTyxhQUFhLENBQUMsT0FBTyxFQUFFLENBQUE7SUFDaEMsQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixJQUFJLENBQUMsQ0FBQyxLQUFLLFlBQVksK0JBQStCLENBQUM7WUFBRSxNQUFNLEtBQUssQ0FBQTtRQUVwRSxPQUFPLFNBQVMsQ0FBQTtJQUNsQixDQUFDO0FBQ0gsQ0FBQztBQUVEOzs7R0FHRztBQUNILFNBQVMsa0JBQWtCO0lBQ3pCLE9BQU8sSUFBSSxhQUFhLENBQUM7UUFDdkIsUUFBUSxFQUFFO1lBQ1IsSUFBSSxFQUFFO2dCQUNKLGFBQWEsRUFBRTtvQkFDYixNQUFNLEVBQUUsZUFBZTtvQkFDdkIsVUFBVSxFQUFFLEdBQUcsRUFBRSxDQUFDLGdC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QUFNLENBQUMsQ0FBQTtZQUNqRixDQUFDLENBQUM7U0FDSCxDQUFDLENBQUE7UUFFRixPQUFPO1lBQ0wsVUFBVTtZQUNWLFNBQVM7WUFDVCxxQkFBcUIsRUFBRSxLQUFLLENBQUMsZ0JBQWdCLENBQUMsbUJBQW1CLENBQUMsS0FBSyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsbUJBQW1CLENBQUM7WUFDakgsU0FBUyxFQUFFLGFBQWEsQ0FBQyxrQ0FBa0MsRUFBRSxDQUFDLFNBQVM7U0FDeEUsQ0FBQTtJQUNILENBQUM7WUFBUyxDQUFDO1FBQ1QsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUFDO1lBQ2hCLEtBQUssQ0FBQyxNQUFNLENBQUMsRUFBQyxrQkFBa0IsRUFBRSxtQkFBbUIsRUFBQyxDQUFDO1lBQ3ZELElBQUksQ0FBQyxNQUFNLENBQUMsRUFBQyxrQkFBa0IsRUFBRSxtQkFBbUIsRUFBQyxDQUFDO1NBQ3ZELENBQUMsQ0FBQTtRQUNGLElBQUkscUJBQXFCO1lBQUUscUJBQXFCLENBQUMsVUFBVSxFQUFFLENBQUE7UUFDN0QsTUFBTSxhQUFhLENBQUMsd0JBQXdCLEVBQUUsQ0FBQTtJQUNoRCxDQUFDO0FBQ0gsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgQ29uZmlndXJhdGlvbiwgeyBDdXJyZW50Q29uZmlndXJhdGlvbk5vdFNldEVycm9yIH0gZnJvbSBcIi4uL2NvbmZpZ3VyYXRpb24uanNcIlxuaW1wb3J0IERhdGFiYXNlUmVjb3JkIGZyb20gXCIuLi9kYXRhYmFzZS9yZWNvcmQvaW5kZXguanNcIlxuaW1wb3J0IEJyb3dzZXJFbnZpcm9ubWVudEhhbmRsZXIgZnJvbSBcIi4uL2Vudmlyb25tZW50LWhhbmRsZXJzL2Jyb3dzZXIuanNcIlxuaW1wb3J0IE1pZ3JhdGlvbiBmcm9tIFwiLi4vZGF0YWJhc2UvbWlncmF0aW9uL2luZGV4LmpzXCJcbmltcG9ydCBTaW5nbGVNdWx0aVVzZVBvb2wgZnJvbSBcIi4uL2RhdGFiYXNlL3Bvb2wvc2luZ2xlLW11bHRpLXVzZS5qc1wiXG5pbXBvcnQgU3FsaXRlV2ViRHJpdmVyIGZyb20gXCIuLi9kYXRhYmFzZS9kcml2ZXJzL3NxbGl0ZS9pbmRleC53ZWIuanNcIlxuaW1wb3J0IFRlbmFudCBmcm9tIFwiLi4vdGVuYW50cy90ZW5hbnQuanNcIlxuXG5jb25zdCBEQVRBQkFTRV9JREVOVElGSUVSID0gXCJwcm9qZWN0VGVuYW50XCJcbmNvbnN0IFNDSEVNQV9HRU5FUkFUSU9OID0gXCJmcm9udGVuZC10ZW5hbnQtYnJvd3Nlci1wZXJzaXN0ZW5jZS0xXCJcblxuLyoqXG4gKiBSZXR1cm5zIHRoZSBjdXJyZW50IGNvbmZpZ3VyYXRpb24gd2l0aG91dCByZXF1aXJpbmcgb25lIHRvIGV4aXN0LlxuICogQHJldHVybnMge0NvbmZpZ3VyYXRpb24gfCB1bmRlZmluZWR9IEN1cnJlbnQgY29uZmlndXJhdGlvbiB3aGVuIGluc3RhbGxlZC5cbiAqL1xuZnVuY3Rpb24gY3VycmVudENvbmZpZ3VyYXRpb25PclVuZGVmaW5lZCgpIHtcbiAgdHJ5IHtcbiAgICByZXR1cm4gQ29uZmlndXJhdGlvbi5jdXJyZW50KClcbiAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICBpZiAoIShlcnJvciBpbnN0YW5jZW9mIEN1cnJlbnRDb25maWd1cmF0aW9uTm90U2V0RXJyb3IpKSB0aHJvdyBlcnJvclxuXG4gICAgcmV0dXJuIHVuZGVmaW5lZFxuICB9XG59XG5cbi8qKlxuICogQnVpbGRzIHRoZSByZWFsIGJyb3dzZXItYmFja2VkIHR3by1wcm9qZWN0IGNvbmZpZ3VyYXRpb24uXG4gKiBAcmV0dXJucyB7Q29uZmlndXJhdGlvbn0gQnJvd3NlciB0ZW5hbnQgY29uZmlndXJhdGlvbi5cbiAqL1xuZnVuY3Rpb24gYnVpbGRDb25maWd1cmF0aW9uKCkge1xuICByZXR1cm4gbmV3IENvbmZpZ3VyYXRpb24oe1xuICAgIGRhdGFiYXNlOiB7XG4gICAgICB0ZXN0OiB7XG4gICAgICAgIHByb2plY3RUZW5hbnQ6IHtcbiAgICAgICAgICBkcml2ZXI6IFNxbGl0ZVdlYkRyaXZlcixcbiAgICAgICAgICBsb2NhdGVGaWxlOiAoKSA9PiBcIi9zcWwtd2FzbS53YXNtXCIsXG4gICAgICAgICAgbWlncmF0aW9uczogdHJ1ZSxcbiAgICAgICAgICBuYW1lOiBcInZlbG9jaW91cy1icm93c2VyLXByb2plY3QtcHJvb2YtdGVtcGxhdGVcIixcbiAgICAgICAgICBwb29sVHlwZTogU2luZ2xlTXVsdGlVc2VQb29sLFxuICAgICAgICAgIHRlbmFudE9ubHk6IHRydWUsXG4gICAgICAgICAgdHlwZTogXCJzcWxpdGVcIlxuICAgICAgICB9XG4gICAgICB9XG4gICAgfSxcbiAgICBkaXJlY3Rvcnk6IFwiL2Zyb250ZW5kLXRlbmFudC1icm93c2VyLXBlcnNpc3RlbmNlLXNjZW5hcmlvXCIsXG4gICAgZW52aXJvbm1lbnQ6IFwidGVzdFwiLFxuICAgIGVudmlyb25tZW50SGFuZGxlcjogbmV3IEJyb3dzZXJFbnZpcm9ubWVudEhhbmRsZXIoKSxcbiAgICBmcm9udGVuZFRlbmFudFNxbGl0ZToge21heE9wZW5IYW5kbGVzOiAyfSxcbiAgICBpbml0aWFsaXplTW9kZWxzOiBhc3luYyAoKSA9PiB7fSxcbiAgICBsb2NhbGU6IFwiZW5cIixcbiAgICBsb2NhbGVGYWxsYmFja3M6IHtlbjogW1wiZW5cIl19LFxuICAgIGxvY2FsZXM6IFtcImVuXCJdLFxuICAgIHRlbmFudERhdGFiYXNlUmVzb2x2ZXI6ICh7aWRlbnRpZmllciwgdGVuYW50fSkgPT4ge1xuICAgICAgaWYgKGlkZW50aWZpZXIgIT09IERBVEFCQVNFX0lERU5USUZJRVIgfHwgIXRlbmFudCB8fCB0eXBlb2YgdGVuYW50ICE9PSBcIm9iamVjdFwiKSByZXR1cm5cbiAgICAgIGNvbnN0IHByb2plY3RTbHVnID0gLyoqIEB0eXBlIHt7cHJvamVjdFNsdWc/OiBzdHJpbmd9fSAqLyAodGVuYW50KS5wcm9qZWN0U2x1Z1xuXG4gICAgICBpZiAocHJvamVjdFNsdWcgIT09IFwiYWxwaGFcIiAmJiBwcm9qZWN0U2x1ZyAhPT0gXCJiZXRhXCIpIHJldHVyblxuXG4gICAgICByZXR1cm4ge25hbWU6IGB2ZWxvY2lvdXMtYnJvd3Nlci1wcm9qZWN0LXByb29mLSR7cHJvamVjdFNsdWd9YH1cbiAgICB9XG4gIH0pXG59XG5cbi8qKlxuICogRXhlcmNpc2VzIHR3byBkdXJhYmxlIHBoeXNpY2FsIHRlbmFudCBkYXRhYmFzZXMgaW5zaWRlIHRoZSByZWFsIGJyb3dzZXIuXG4gKiBAcmV0dXJucyB7UHJvbWlzZTx7YWxwaGFOYW1lczogUmV0dXJuVHlwZTx0eXBlb2YgSlNPTi5wYXJzZT5bXSwgYmV0YU5hbWVzOiBSZXR1cm5UeXBlPHR5cGVvZiBKU09OLnBhcnNlPltdLCBpZGVudGl0aWVzQXJlRGlzdGluY3Q6IGJvb2xlYW4sIG9wZW5Db3VudDogbnVtYmVyfT59IFNlcmlhbGl6YWJsZSBwcm9vZiByZXN1bHQuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGFzeW5jIGZ1bmN0aW9uIHJ1bkZyb250ZW5kVGVuYW50RGF0YWJhc2VQZXJzaXN0ZW5jZVNjZW5hcmlvKCkge1xuICBjb25zdCBwcmV2aW91c0NvbmZpZ3VyYXRpb24gPSBjdXJyZW50Q29uZmlndXJhdGlvbk9yVW5kZWZpbmVkKClcbiAgY29uc3QgY29uZmlndXJhdGlvbiA9IGJ1aWxkQ29uZmlndXJhdGlvbigpXG5cbiAgY2xhc3MgQnJvd3NlclByb2plY3RSZWNvcmQgZXh0ZW5kcyBEYXRhYmFzZVJlY29yZCB7fVxuICBjbGFzcyBDcmVhdGVCcm93c2VyUHJvamVjdFJlY29yZHMgZXh0ZW5kcyBNaWdyYXRpb24ge1xuICAgIGFzeW5jIHVwKCkge1xuICAgICAgYXdhaXQgdGhpcy5leGVjdXRlKFwiQ1JFQVRFIFRBQkxFIGJyb3dzZXJfcHJvamVjdF9yZWNvcmRzKGlkIGludGVnZXIgUFJJTUFSWSBLRVkgQVVUT0lOQ1JFTUVOVCwgbmFtZSB2YXJjaGFyKDI1NSkgTk9UIE5VTEwpXCIpXG4gICAgfVxuICB9XG5cbiAgQnJvd3NlclByb2plY3RSZWNvcmQuc2V0VGFibGVOYW1lKFwiYnJvd3Nlcl9wcm9qZWN0X3JlY29yZHNcIilcbiAgQnJvd3NlclByb2plY3RSZWNvcmQuc3dpdGNoZXNUZW5hbnREYXRhYmFzZShEQVRBQkFTRV9JREVOVElGSUVSKVxuICBCcm93c2VyUHJvamVjdFJlY29yZC5yZWdpc3RlclJlY29yZENsYXNzKHtjb25maWd1cmF0aW9ufSlcbiAgQ3JlYXRlQnJvd3NlclByb2plY3RSZWNvcmRzLm9uRGF0YWJhc2VzKFtEQVRBQkFTRV9JREVOVElGSUVSXSlcblxuICBjb25zdCBtaWdyYXRpb25GaWxlID0gXCIyMDI2MDkxOTA5MDAwMC1jcmVhdGUtYnJvd3Nlci1wcm9qZWN0LXJlY29yZHMuanNcIlxuICAvKipcbiAgICogTG9hZHMgdGhlIG9uZSBtaWdyYXRpb24gYnVuZGxlZCBpbnRvIHRoaXMgYnJvd3NlciBwcm9vZi5cbiAgICogQHR5cGUge2ltcG9ydChcIi4uL2RhdGFiYXNlL21pZ3JhdG9yL3R5cGVzLmpzXCIpLlJlcXVpcmVNaWdyYXRpb25Db250ZXh0VHlwZX1cbiAgICovXG4gIGNvbnN0IG1pZ3JhdGlvbnMgPSAoZmlsZU5hbWUpID0+IHtcbiAgICBpZiAoZmlsZU5hbWUgIT09IG1pZ3JhdGlvbkZpbGUpIHRocm93IG5ldyBFcnJvcihgVW5rbm93biBicm93c2VyIHRlbmFudCBwcm9vZiBtaWdyYXRpb246ICR7ZmlsZU5hbWV9YClcblxuICAgIHJldHVybiB7ZGVmYXVsdDogQ3JlYXRlQnJvd3NlclByb2plY3RSZWNvcmRzfVxuICB9XG5cbiAgbWlncmF0aW9ucy5rZXlzID0gKCkgPT4gW21pZ3JhdGlvbkZpbGVdXG4gIG1pZ3JhdGlvbnMuaWQgPSBcImZyb250ZW5kLXRlbmFudC1icm93c2VyLXBlcnNpc3RlbmNlLXNjZW5hcmlvXCJcblxuICBjb25zdCBhbHBoYSA9IFRlbmFudC5oYW5kbGUoe3Byb2plY3RTbHVnOiBcImFscGhhXCJ9LCBjb25maWd1cmF0aW9uKVxuICBjb25zdCBiZXRhID0gVGVuYW50LmhhbmRsZSh7cHJvamVjdFNsdWc6IFwiYmV0YVwifSwgY29uZmlndXJhdGlvbilcblxuICBjb25maWd1cmF0aW9uLnNldEN1cnJlbnQoKVxuXG4gIHRyeSB7XG4gICAgYXdhaXQgUHJvbWlzZS5hbGwoW1xuICAgICAgYWxwaGEuZGVsZXRlKHtkYXRhYmFzZUlkZW50aWZpZXI6IERBVEFCQVNFX0lERU5USUZJRVJ9KSxcbiAgICAgIGJldGEuZGVsZXRlKHtkYXRhYmFzZUlkZW50aWZpZXI6IERBVEFCQVNFX0lERU5USUZJRVJ9KVxuICAgIF0pXG4gICAgYXdhaXQgUHJvbWlzZS5hbGwoW1xuICAgICAgYWxwaGEuaW5pdGlhbGl6ZSh7ZGF0YWJhc2VJZGVudGlmaWVyOiBEQVRBQkFTRV9JREVOVElGSUVSLCBtaWdyYXRpb25zLCBzY2hlbWFHZW5lcmF0aW9uOiBTQ0hFTUFfR0VORVJBVElPTn0pLFxuICAgICAgYmV0YS5pbml0aWFsaXplKHtkYXRhYmFzZUlkZW50aWZpZXI6IERBVEFCQVNFX0lERU5USUZJRVIsIG1pZ3JhdGlvbnMsIHNjaGVtYUdlbmVyYXRpb246IFNDSEVNQV9HRU5FUkFUSU9OfSlcbiAgICBdKVxuXG4gICAgZm9yIChsZXQgaW5kZXggPSAwOyBpbmRleCA8IDEyOyBpbmRleCsrKSB7XG4gICAgICBhd2FpdCBQcm9taXNlLmFsbChbXG4gICAgICAgIGFscGhhLmRhdGFiYXNlT3BlcmF0aW9uKHtkYXRhYmFzZUlkZW50aWZpZXI6IERBVEFCQVNFX0lERU5USUZJRVJ9LCBhc3luYyAob3BlcmF0aW9uKSA9PiB7XG4gICAgICAgICAgYXdhaXQgb3BlcmF0aW9uLmZvck1vZGVsKEJyb3dzZXJQcm9qZWN0UmVjb3JkKS5jcmVhdGUoe25hbWU6IGBhbHBoYS0ke2luZGV4fWB9KVxuICAgICAgICB9KSxcbiAgICAgICAgYmV0YS5kYXRhYmFzZU9wZXJhdGlvbih7ZGF0YWJhc2VJZGVudGlmaWVyOiBEQVRBQkFTRV9JREVOVElGSUVSfSwgYXN5bmMgKG9wZXJhdGlvbikgPT4ge1xuICAgICAgICAgIGF3YWl0IG9wZXJhdGlvbi5mb3JNb2RlbChCcm93c2VyUHJvamVjdFJlY29yZCkuY3JlYXRlKHtuYW1lOiBgYmV0YS0ke2luZGV4fWB9KVxuICAgICAgICB9KVxuICAgICAgXSlcbiAgICB9XG5cbiAgICBhd2FpdCBQcm9taXNlLmFsbChbXG4gICAgICBhbHBoYS5jbG9zZSh7ZGF0YWJhc2VJZGVudGlmaWVyOiBEQVRBQkFTRV9JREVOVElGSUVSLCBmbHVzaDogdHJ1ZX0pLFxuICAgICAgYmV0YS5jbG9zZSh7ZGF0YWJhc2VJZGVudGlmaWVyOiBEQVRBQkFTRV9JREVOVElGSUVSLCBmbHVzaDogdHJ1ZX0pXG4gICAgXSlcbiAgICBhd2FpdCBQcm9taXNlLmFsbChbXG4gICAgICBhbHBoYS5pbml0aWFsaXplKHtkYXRhYmFzZUlkZW50aWZpZXI6IERBVEFCQVNFX0lERU5USUZJRVIsIG1pZ3JhdGlvbnMsIHNjaGVtYUdlbmVyYXRpb246IFNDSEVNQV9HRU5FUkFUSU9OfSksXG4gICAgICBiZXRhLmluaXRpYWxpemUoe2RhdGFiYXNlSWRlbnRpZmllcjogREFUQUJBU0VfSURFTlRJRklFUiwgbWlncmF0aW9ucywgc2NoZW1hR2VuZXJhdGlvbjogU0NIRU1BX0dFTkVSQVRJT059KVxuICAgIF0pXG5cbiAgICBjb25zdCBbYWxwaGFOYW1lcywgYmV0YU5hbWVzXSA9IGF3YWl0IFByb21pc2UuYWxsKFtcbiAgICAgIGFscGhhLmRhdGFiYXNlT3BlcmF0aW9uKHtkYXRhYmFzZUlkZW50aWZpZXI6IERBVEFCQVNFX0lERU5USUZJRVJ9LCBhc3luYyAob3BlcmF0aW9uKSA9PiB7XG4gICAgICAgIHJldHVybiBhd2FpdCBvcGVyYXRpb24uZm9yTW9kZWwoQnJvd3NlclByb2plY3RSZWNvcmQpLm9yZGVyKFwiaWRcIikucGx1Y2soXCJuYW1lXCIpXG4gICAgICB9KSxcbiAgICAgIGJldGEuZGF0YWJhc2VPcGVyYXRpb24oe2RhdGFiYXNlSWRlbnRpZmllcjogREFUQUJBU0VfSURFTlRJRklFUn0sIGFzeW5jIChvcGVyYXRpb24pID0+IHtcbiAgICAgICAgcmV0dXJuIGF3YWl0IG9wZXJhdGlvbi5mb3JNb2RlbChCcm93c2VyUHJvamVjdFJlY29yZCkub3JkZXIoXCJpZFwiKS5wbHVjayhcIm5hbWVcIilcbiAgICAgIH0pXG4gICAgXSlcblxuICAgIHJldHVybiB7XG4gICAgICBhbHBoYU5hbWVzLFxuICAgICAgYmV0YU5hbWVzLFxuICAgICAgaWRlbnRpdGllc0FyZURpc3RpbmN0OiBhbHBoYS5kYXRhYmFzZUlkZW50aXR5KERBVEFCQVNFX0lERU5USUZJRVIpICE9PSBiZXRhLmRhdGFiYXNlSWRlbnRpdHkoREFUQUJBU0VfSURFTlRJRklFUiksXG4gICAgICBvcGVuQ291bnQ6IGNvbmZpZ3VyYXRpb24uaW5zcGVjdEZyb250ZW5kVGVuYW50U3FsaXRlSGFuZGxlcygpLm9wZW5Db3VudFxuICAgIH1cbiAgfSBmaW5hbGx5IHtcbiAgICBhd2FpdCBQcm9taXNlLmFsbChbXG4gICAgICBhbHBoYS5kZWxldGUoe2RhdGFiYXNlSWRlbnRpZmllcjogREFUQUJBU0VfSURFTlRJRklFUn0pLFxuICAgICAgYmV0YS5kZWxldGUoe2RhdGFiYXNlSWRlbnRpZmllcjogREFUQUJBU0VfSURFTlRJRklFUn0pXG4gICAgXSlcbiAgICBpZiAocHJldmlvdXNDb25maWd1cmF0aW9uKSBwcmV2aW91c0NvbmZpZ3VyYXRpb24uc2V0Q3VycmVudCgpXG4gICAgYXdhaXQgY29uZmlndXJhdGlvbi5jbG9zZURhdGFiYXNlQ29ubmVjdGlvbnMoKVxuICB9XG59XG4iXX0=

package/build/src/testing/browser-test-app.js

@@ -2,6 +2,7 @@
 import SystemTestBrowserHelper from "system-testing/build/system-test-browser-helper.js";
 import BrowserEnvironmentHandler from "../environment-handlers/browser.js";
 import runFrontendModelEventHookScenario from "./browser-frontend-model-event-hook-scenarios.js";
+import runFrontendTenantDatabasePersistenceScenario from "./browser-frontend-tenant-database-scenarios.js";
 import runUseDatabaseSelectionTransitionScenario from "./browser-use-database-hook-scenarios.js";
 const root = document.getElementById("root") || (() => {
     const element = document.createElement("div");
@@ -22,7 +23,8 @@ systemTestBrowserHelper.enableOnBrowser();
 Object.assign(globalThis, { velociousBrowserTest: {
         BrowserEnvironmentHandler,
         runFrontendModelEventHookScenario,
+        runFrontendTenantDatabasePersistenceScenario,
         runUseDatabaseSelectionTransitionScenario,
         systemTestBrowserHelper
     } });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci10ZXN0LWFwcC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90ZXN0aW5nL2Jyb3dzZXItdGVzdC1hcHAuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sdUJBQXVCLE1BQU0sb0RBQW9ELENBQUE7QUFDeEYsT0FBTyx5QkFBeUIsTUFBTSxvQ0FBb0MsQ0FBQTtBQUMxRSxPQUFPLGlDQUFpQyxNQUFNLGtEQUFrRCxDQUFBO0FBQ2hHLE9BQU8seUNBQXlDLE1BQU0sMENBQTBDLENBQUE7QUFFaEcsTUFBTSxJQUFJLEdBQUcsUUFBUSxDQUFDLGNBQWMsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRTtJQUNwRCxNQUFNLE9BQU8sR0FBRyxRQUFRLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxDQUFBO0lBQzdDLE9BQU8sQ0FBQyxFQUFFLEdBQUcsTUFBTSxDQUFBO0lBQ25CLFFBQVEsQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLE9BQU8sQ0FBQyxDQUFBO0lBQ2xDLE9BQU8sT0FBTyxDQUFBO0FBQ2hCLENBQUMsQ0FBQyxFQUFFLENBQUE7QUFFSixNQUFNLHNCQUFzQixHQUFHLFFBQVEsQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLENBQUE7QUFDNUQsc0JBQXNCLENBQUMsWUFBWSxDQUFDLGFBQWEsRUFBRSx3QkFBd0IsQ0FBQyxDQUFBO0FBQzVFLHNCQUFzQixDQUFDLFlBQVksQ0FBQyxlQUFlLEVBQUUsTUFBTSxDQUFDLENBQUE7QUFFNUQsTUFBTSxTQUFTLEdBQUcsUUFBUSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQUMsQ0FBQTtBQUMvQyxTQUFTLENBQUMsWUFBWSxDQUFDLGFBQWEsRUFBRSxXQUFXLENBQUMsQ0FBQTtBQUNsRCxTQUFTLENBQUMsV0FBVyxHQUFHLE9BQU8sQ0FBQTtBQUUvQixzQkFBc0IsQ0FBQyxXQUFXLENBQUMsU0FBUyxDQUFDLENBQUE7QUFDN0MsSUFBSSxDQUFDLFdBQVcsQ0FBQyxzQkFBc0IsQ0FBQyxDQUFBO0FBRXhDLE1BQU0sdUJBQXVCLEdBQUcsSUFBSSx1QkFBdUIsRUFBRSxDQUFBO0FBQzdELHVCQUF1QixDQUFDLGVBQWUsRUFBRSxDQUFBO0FBRXpDLE1BQU0sQ0FBQyxNQUFNLENBQUMsVUFBVSxFQUFFLEVBQUMsb0JBQW9CLEVBQUU7UUFDL0MseUJBQXlCO1FBQ3pCLGlDQUFpQztRQUNqQyx5Q0FBeUM7UUFDekMsdUJBQXVCO0tBQ3hCLEVBQUMsQ0FBQyxDQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbmltcG9ydCBTeXN0ZW1UZXN0QnJvd3NlckhlbHBlciBmcm9tIFwic3lzdGVtLXRlc3RpbmcvYnVpbGQvc3lzdGVtLXRlc3QtYnJvd3Nlci1oZWxwZXIuanNcIlxuaW1wb3J0IEJyb3dzZXJFbnZpcm9ubWVudEhhbmRsZXIgZnJvbSBcIi4uL2Vudmlyb25tZW50LWhhbmRsZXJzL2Jyb3dzZXIuanNcIlxuaW1wb3J0IHJ1bkZyb250ZW5kTW9kZWxFdmVudEhvb2tTY2VuYXJpbyBmcm9tIFwiLi9icm93c2VyLWZyb250ZW5kLW1vZGVsLWV2ZW50LWhvb2stc2NlbmFyaW9zLmpzXCJcbmltcG9ydCBydW5Vc2VEYXRhYmFzZVNlbGVjdGlvblRyYW5zaXRpb25TY2VuYXJpbyBmcm9tIFwiLi9icm93c2VyLXVzZS1kYXRhYmFzZS1ob29rLXNjZW5hcmlvcy5qc1wiXG5cbmNvbnN0IHJvb3QgPSBkb2N1bWVudC5nZXRFbGVtZW50QnlJZChcInJvb3RcIikgfHwgKCgpID0+IHtcbiAgY29uc3QgZWxlbWVudCA9IGRvY3VtZW50LmNyZWF0ZUVsZW1lbnQoXCJkaXZcIilcbiAgZWxlbWVudC5pZCA9IFwicm9vdFwiXG4gIGRvY3VtZW50LmJvZHkuYXBwZW5kQ2hpbGQoZWxlbWVudClcbiAgcmV0dXJuIGVsZW1lbnRcbn0pKClcblxuY29uc3Qgc3lzdGVtVGVzdGluZ0NvbXBvbmVudCA9IGRvY3VtZW50LmNyZWF0ZUVsZW1lbnQoXCJkaXZcIilcbnN5c3RlbVRlc3RpbmdDb21wb25lbnQuc2V0QXR0cmlidXRlKFwiZGF0YS10ZXN0aWRcIiwgXCJzeXN0ZW1UZXN0aW5nQ29tcG9uZW50XCIpXG5zeXN0ZW1UZXN0aW5nQ29tcG9uZW50LnNldEF0dHJpYnV0ZShcImRhdGEtZm9jdXNzZWRcIiwgXCJ0cnVlXCIpXG5cbmNvbnN0IGJsYW5rVGV4dCA9IGRvY3VtZW50LmNyZWF0ZUVsZW1lbnQoXCJkaXZcIilcbmJsYW5rVGV4dC5zZXRBdHRyaWJ1dGUoXCJkYXRhLXRlc3RpZFwiLCBcImJsYW5rVGV4dFwiKVxuYmxhbmtUZXh0LnRleHRDb250ZW50ID0gXCJibGFua1wiXG5cbnN5c3RlbVRlc3RpbmdDb21wb25lbnQuYXBwZW5kQ2hpbGQoYmxhbmtUZXh0KVxucm9vdC5hcHBlbmRDaGlsZChzeXN0ZW1UZXN0aW5nQ29tcG9uZW50KVxuXG5jb25zdCBzeXN0ZW1UZXN0QnJvd3NlckhlbHBlciA9IG5ldyBTeXN0ZW1UZXN0QnJvd3NlckhlbHBlcigpXG5zeXN0ZW1UZXN0QnJvd3NlckhlbHBlci5lbmFibGVPbkJyb3dzZXIoKVxuXG5PYmplY3QuYXNzaWduKGdsb2JhbFRoaXMsIHt2ZWxvY2lvdXNCcm93c2VyVGVzdDoge1xuICBCcm93c2VyRW52aXJvbm1lbnRIYW5kbGVyLFxuICBydW5Gcm9udGVuZE1vZGVsRXZlbnRIb29rU2NlbmFyaW8sXG4gIHJ1blVzZURhdGFiYXNlU2VsZWN0aW9uVHJhbnNpdGlvblNjZW5hcmlvLFxuICBzeXN0ZW1UZXN0QnJvd3NlckhlbHBlclxufX0pXG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3Nlci10ZXN0LWFwcC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90ZXN0aW5nL2Jyb3dzZXItdGVzdC1hcHAuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sdUJBQXVCLE1BQU0sb0RBQW9ELENBQUE7QUFDeEYsT0FBTyx5QkFBeUIsTUFBTSxvQ0FBb0MsQ0FBQTtBQUMxRSxPQUFPLGlDQUFpQyxNQUFNLGtEQUFrRCxDQUFBO0FBQ2hHLE9BQU8sNENBQTRDLE1BQU0saURBQWlELENBQUE7QUFDMUcsT0FBTyx5Q0FBeUMsTUFBTSwwQ0FBMEMsQ0FBQTtBQUVoRyxNQUFNLElBQUksR0FBRyxRQUFRLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFO0lBQ3BELE1BQU0sT0FBTyxHQUFHLFFBQVEsQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLENBQUE7SUFDN0MsT0FBTyxDQUFDLEVBQUUsR0FBRyxNQUFNLENBQUE7SUFDbkIsUUFBUSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsT0FBTyxDQUFDLENBQUE7SUFDbEMsT0FBTyxPQUFPLENBQUE7QUFDaEIsQ0FBQyxDQUFDLEVBQUUsQ0FBQTtBQUVKLE1BQU0sc0JBQXNCLEdBQUcsUUFBUSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQUMsQ0FBQTtBQUM1RCxzQkFBc0IsQ0FBQyxZQUFZLENBQUMsYUFBYSxFQUFFLHdCQUF3QixDQUFDLENBQUE7QUFDNUUsc0JBQXNCLENBQUMsWUFBWSxDQUFDLGVBQWUsRUFBRSxNQUFNLENBQUMsQ0FBQTtBQUU1RCxNQUFNLFNBQVMsR0FBRyxRQUFRLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxDQUFBO0FBQy9DLFNBQVMsQ0FBQyxZQUFZLENBQUMsYUFBYSxFQUFFLFdBQVcsQ0FBQyxDQUFBO0FBQ2xELFNBQVMsQ0FBQyxXQUFXLEdBQUcsT0FBTyxDQUFBO0FBRS9CLHNCQUFzQixDQUFDLFdBQVcsQ0FBQyxTQUFTLENBQUMsQ0FBQTtBQUM3QyxJQUFJLENBQUMsV0FBVyxDQUFDLHNCQUFzQixDQUFDLENBQUE7QUFFeEMsTUFBTSx1QkFBdUIsR0FBRyxJQUFJLHVCQUF1QixFQUFFLENBQUE7QUFDN0QsdUJBQXVCLENBQUMsZUFBZSxFQUFFLENBQUE7QUFFekMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxVQUFVLEVBQUUsRUFBQyxvQkFBb0IsRUFBRTtRQUMvQyx5QkFBeUI7UUFDekIsaUNBQWlDO1FBQ2pDLDRDQUE0QztRQUM1Qyx5Q0FBeUM7UUFDekMsdUJBQXVCO0tBQ3hCLEVBQUMsQ0FBQyxDQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbmltcG9ydCBTeXN0ZW1UZXN0QnJvd3NlckhlbHBlciBmcm9tIFwic3lzdGVtLXRlc3RpbmcvYnVpbGQvc3lzdGVtLXRlc3QtYnJvd3Nlci1oZWxwZXIuanNcIlxuaW1wb3J0IEJyb3dzZXJFbnZpcm9ubWVudEhhbmRsZXIgZnJvbSBcIi4uL2Vudmlyb25tZW50LWhhbmRsZXJzL2Jyb3dzZXIuanNcIlxuaW1wb3J0IHJ1bkZyb250ZW5kTW9kZWxFdmVudEhvb2tTY2VuYXJpbyBmcm9tIFwiLi9icm93c2VyLWZyb250ZW5kLW1vZGVsLWV2ZW50LWhvb2stc2NlbmFyaW9zLmpzXCJcbmltcG9ydCBydW5Gcm9udGVuZFRlbmFudERhdGFiYXNlUGVyc2lzdGVuY2VTY2VuYXJpbyBmcm9tIFwiLi9icm93c2VyLWZyb250ZW5kLXRlbmFudC1kYXRhYmFzZS1zY2VuYXJpb3MuanNcIlxuaW1wb3J0IHJ1blVzZURhdGFiYXNlU2VsZWN0aW9uVHJhbnNpdGlvblNjZW5hcmlvIGZyb20gXCIuL2Jyb3dzZXItdXNlLWRhdGFiYXNlLWhvb2stc2NlbmFyaW9zLmpzXCJcblxuY29uc3Qgcm9vdCA9IGRvY3VtZW50LmdldEVsZW1lbnRCeUlkKFwicm9vdFwiKSB8fCAoKCkgPT4ge1xuICBjb25zdCBlbGVtZW50ID0gZG9jdW1lbnQuY3JlYXRlRWxlbWVudChcImRpdlwiKVxuICBlbGVtZW50LmlkID0gXCJyb290XCJcbiAgZG9jdW1lbnQuYm9keS5hcHBlbmRDaGlsZChlbGVtZW50KVxuICByZXR1cm4gZWxlbWVudFxufSkoKVxuXG5jb25zdCBzeXN0ZW1UZXN0aW5nQ29tcG9uZW50ID0gZG9jdW1lbnQuY3JlYXRlRWxlbWVudChcImRpdlwiKVxuc3lzdGVtVGVzdGluZ0NvbXBvbmVudC5zZXRBdHRyaWJ1dGUoXCJkYXRhLXRlc3RpZFwiLCBcInN5c3RlbVRlc3RpbmdDb21wb25lbnRcIilcbnN5c3RlbVRlc3RpbmdDb21wb25lbnQuc2V0QXR0cmlidXRlKFwiZGF0YS1mb2N1c3NlZFwiLCBcInRydWVcIilcblxuY29uc3QgYmxhbmtUZXh0ID0gZG9jdW1lbnQuY3JlYXRlRWxlbWVudChcImRpdlwiKVxuYmxhbmtUZXh0LnNldEF0dHJpYnV0ZShcImRhdGEtdGVzdGlkXCIsIFwiYmxhbmtUZXh0XCIpXG5ibGFua1RleHQudGV4dENvbnRlbnQgPSBcImJsYW5rXCJcblxuc3lzdGVtVGVzdGluZ0NvbXBvbmVudC5hcHBlbmRDaGlsZChibGFua1RleHQpXG5yb290LmFwcGVuZENoaWxkKHN5c3RlbVRlc3RpbmdDb21wb25lbnQpXG5cbmNvbnN0IHN5c3RlbVRlc3RCcm93c2VySGVscGVyID0gbmV3IFN5c3RlbVRlc3RCcm93c2VySGVscGVyKClcbnN5c3RlbVRlc3RCcm93c2VySGVscGVyLmVuYWJsZU9uQnJvd3NlcigpXG5cbk9iamVjdC5hc3NpZ24oZ2xvYmFsVGhpcywge3ZlbG9jaW91c0Jyb3dzZXJUZXN0OiB7XG4gIEJyb3dzZXJFbnZpcm9ubWVudEhhbmRsZXIsXG4gIHJ1bkZyb250ZW5kTW9kZWxFdmVudEhvb2tTY2VuYXJpbyxcbiAgcnVuRnJvbnRlbmRUZW5hbnREYXRhYmFzZVBlcnNpc3RlbmNlU2NlbmFyaW8sXG4gIHJ1blVzZURhdGFiYXNlU2VsZWN0aW9uVHJhbnNpdGlvblNjZW5hcmlvLFxuICBzeXN0ZW1UZXN0QnJvd3NlckhlbHBlclxufX0pXG4iXX0=

package/build/testing/browser-frontend-tenant-database-scenarios.js

@@ -0,0 +1,158 @@
+// @ts-check
+
+import Configuration, { CurrentConfigurationNotSetError } from "../configuration.js"
+import DatabaseRecord from "../database/record/index.js"
+import BrowserEnvironmentHandler from "../environment-handlers/browser.js"
+import Migration from "../database/migration/index.js"
+import SingleMultiUsePool from "../database/pool/single-multi-use.js"
+import SqliteWebDriver from "../database/drivers/sqlite/index.web.js"
+import Tenant from "../tenants/tenant.js"
+
+const DATABASE_IDENTIFIER = "projectTenant"
+const SCHEMA_GENERATION = "frontend-tenant-browser-persistence-1"
+
+/**
+ * Returns the current configuration without requiring one to exist.
+ * @returns {Configuration | undefined} Current configuration when installed.
+ */
+function currentConfigurationOrUndefined() {
+  try {
+    return Configuration.current()
+  } catch (error) {
+    if (!(error instanceof CurrentConfigurationNotSetError)) throw error
+
+    return undefined
+  }
+}
+
+/**
+ * Builds the real browser-backed two-project configuration.
+ * @returns {Configuration} Browser tenant configuration.
+ */
+function buildConfiguration() {
+  return new Configuration({
+    database: {
+      test: {
+        projectTenant: {
+          driver: SqliteWebDriver,
+          locateFile: () => "/sql-wasm.wasm",
+          migrations: true,
+          name: "velocious-browser-project-proof-template",
+          poolType: SingleMultiUsePool,
+          tenantOnly: true,
+          type: "sqlite"
+        }
+      }
+    },
+    directory: "/frontend-tenant-browser-persistence-scenario",
+    environment: "test",
+    environmentHandler: new BrowserEnvironmentHandler(),
+    frontendTenantSqlite: {maxOpenHandles: 2},
+    initializeModels: async () => {},
+    locale: "en",
+    localeFallbacks: {en: ["en"]},
+    locales: ["en"],
+    tenantDatabaseResolver: ({identifier, tenant}) => {
+      if (identifier !== DATABASE_IDENTIFIER || !tenant || typeof tenant !== "object") return
+      const projectSlug = /** @type {{projectSlug?: string}} */ (tenant).projectSlug
+
+      if (projectSlug !== "alpha" && projectSlug !== "beta") return
+
+      return {name: `velocious-browser-project-proof-${projectSlug}`}
+    }
+  })
+}
+
+/**
+ * Exercises two durable physical tenant databases inside the real browser.
+ * @returns {Promise<{alphaNames: ReturnType<typeof JSON.parse>[], betaNames: ReturnType<typeof JSON.parse>[], identitiesAreDistinct: boolean, openCount: number}>} Serializable proof result.
+ */
+export default async function runFrontendTenantDatabasePersistenceScenario() {
+  const previousConfiguration = currentConfigurationOrUndefined()
+  const configuration = buildConfiguration()
+
+  class BrowserProjectRecord extends DatabaseRecord {}
+  class CreateBrowserProjectRecords extends Migration {
+    async up() {
+      await this.execute("CREATE TABLE browser_project_records(id integer PRIMARY KEY AUTOINCREMENT, name varchar(255) NOT NULL)")
+    }
+  }
+
+  BrowserProjectRecord.setTableName("browser_project_records")
+  BrowserProjectRecord.switchesTenantDatabase(DATABASE_IDENTIFIER)
+  BrowserProjectRecord.registerRecordClass({configuration})
+  CreateBrowserProjectRecords.onDatabases([DATABASE_IDENTIFIER])
+
+  const migrationFile = "20260919090000-create-browser-project-records.js"
+  /**
+   * Loads the one migration bundled into this browser proof.
+   * @type {import("../database/migrator/types.js").RequireMigrationContextType}
+   */
+  const migrations = (fileName) => {
+    if (fileName !== migrationFile) throw new Error(`Unknown browser tenant proof migration: ${fileName}`)
+
+    return {default: CreateBrowserProjectRecords}
+  }
+
+  migrations.keys = () => [migrationFile]
+  migrations.id = "frontend-tenant-browser-persistence-scenario"
+
+  const alpha = Tenant.handle({projectSlug: "alpha"}, configuration)
+  const beta = Tenant.handle({projectSlug: "beta"}, configuration)
+
+  configuration.setCurrent()
+
+  try {
+    await Promise.all([
+      alpha.delete({databaseIdentifier: DATABASE_IDENTIFIER}),
+      beta.delete({databaseIdentifier: DATABASE_IDENTIFIER})
+    ])
+    await Promise.all([
+      alpha.initialize({databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION}),
+      beta.initialize({databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION})
+    ])
+
+    for (let index = 0; index < 12; index++) {
+      await Promise.all([
+        alpha.databaseOperation({databaseIdentifier: DATABASE_IDENTIFIER}, async (operation) => {
+          await operation.forModel(BrowserProjectRecord).create({name: `alpha-${index}`})
+        }),
+        beta.databaseOperation({databaseIdentifier: DATABASE_IDENTIFIER}, async (operation) => {
+          await operation.forModel(BrowserProjectRecord).create({name: `beta-${index}`})
+        })
+      ])
+    }
+
+    await Promise.all([
+      alpha.close({databaseIdentifier: DATABASE_IDENTIFIER, flush: true}),
+      beta.close({databaseIdentifier: DATABASE_IDENTIFIER, flush: true})
+    ])
+    await Promise.all([
+      alpha.initialize({databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION}),
+      beta.initialize({databaseIdentifier: DATABASE_IDENTIFIER, migrations, schemaGeneration: SCHEMA_GENERATION})
+    ])
+
+    const [alphaNames, betaNames] = await Promise.all([
+      alpha.databaseOperation({databaseIdentifier: DATABASE_IDENTIFIER}, async (operation) => {
+        return await operation.forModel(BrowserProjectRecord).order("id").pluck("name")
+      }),
+      beta.databaseOperation({databaseIdentifier: DATABASE_IDENTIFIER}, async (operation) => {
+        return await operation.forModel(BrowserProjectRecord).order("id").pluck("name")
+      })
+    ])
+
+    return {
+      alphaNames,
+      betaNames,
+      identitiesAreDistinct: alpha.databaseIdentity(DATABASE_IDENTIFIER) !== beta.databaseIdentity(DATABASE_IDENTIFIER),
+      openCount: configuration.inspectFrontendTenantSqliteHandles().openCount
+    }
+  } finally {
+    await Promise.all([
+      alpha.delete({databaseIdentifier: DATABASE_IDENTIFIER}),
+      beta.delete({databaseIdentifier: DATABASE_IDENTIFIER})
+    ])
+    if (previousConfiguration) previousConfiguration.setCurrent()
+    await configuration.closeDatabaseConnections()
+  }
+}

package/build/testing/browser-test-app.js

@@ -3,6 +3,7 @@
 import SystemTestBrowserHelper from "system-testing/build/system-test-browser-helper.js"
 import BrowserEnvironmentHandler from "../environment-handlers/browser.js"
 import runFrontendModelEventHookScenario from "./browser-frontend-model-event-hook-scenarios.js"
+import runFrontendTenantDatabasePersistenceScenario from "./browser-frontend-tenant-database-scenarios.js"
 import runUseDatabaseSelectionTransitionScenario from "./browser-use-database-hook-scenarios.js"
 
 const root = document.getElementById("root") || (() => {
@@ -29,6 +30,7 @@ systemTestBrowserHelper.enableOnBrowser()
 Object.assign(globalThis, {velociousBrowserTest: {
   BrowserEnvironmentHandler,
   runFrontendModelEventHookScenario,
+  runFrontendTenantDatabasePersistenceScenario,
   runUseDatabaseSelectionTransitionScenario,
   systemTestBrowserHelper
 }})

package/package.json

@@ -3,7 +3,7 @@
     "velocious": "build/bin/velocious.js"
   },
   "name": "velocious",
-  "version": "1.0.675",
+  "version": "1.0.677",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "files": [

package/scripts/test-browser.js

@@ -95,6 +95,11 @@ async function buildBrowserTestApp() {
     sourcemap: true
   })
 
+  await fs.copyFile(
+    path.join(rootDir, "node_modules", "sql.js", "dist", "sql-wasm.wasm"),
+    path.join(distDir, "sql-wasm.wasm")
+  )
+
   const html = `<!doctype html>
 <html lang="en">
   <head>

package/src/background-jobs/pooled-runner-child.js

@@ -1,13 +1,17 @@
 // @ts-check
 
 import { randomUUID } from "node:crypto"
+import timeout from "awaitery/build/timeout.js"
 import runJobPayload, { BackgroundJobPerformedFailure } from "./job-runner.js"
+import { boundedPooledRunnerInflightJobIds, isPooledChildShutdownReason, isPooledChildShutdownSignal } from "./pooled-runner-shutdown.js"
 import { closeRunnerConnections, closeRunnerFrameworkConnections, currentConfigurationOrNull } from "./runner-graceful-shutdown.js"
 import setRunnerProcessTitle from "./runner-process-title.js"
 import PooledRunnerBrokerIdentity from "./pooled-runner-broker-identity.js"
 import { runWithSharedTransactionBrokerConfig } from "../testing/shared-transaction-proxy-driver.js"
 
 const BASE_PROCESS_TITLE = "velocious background-jobs-runner"
+/** A shutdown observation may delay resource teardown only for this bounded IPC send. */
+const SHUTDOWN_OBSERVATION_SEND_TIMEOUT_MS = 100
 /** Stable identity of this pooled child process for the life of the process. */
 const childInstanceId = randomUUID()
 
@@ -20,13 +24,18 @@ let shutdownPromise
  * Closes the runner's connections — releasing any advisory lock a killed-mid-pass
  * job still holds — before exiting, instead of leaving a half-open session that
  * keeps the lock until the DB server's `wait_timeout`.
- * @param {number} exitCode - Process exit code.
+ * @param {object} args - Shutdown observation.
+ * @param {number} args.exitCode - Process exit code.
+ * @param {import("./types.js").PooledChildShutdownReason} args.reason - Exact shutdown reason observed by the child.
+ * @param {number | null} [args.shutdownRequestedAtMs] - Parent request timestamp when supplied over IPC.
+ * @param {import("node:child_process").ChildProcess["signalCode"]} [args.signal] - Requested or observed signal.
  * @returns {Promise<void>}
  */
-function shutdownRunner(exitCode) {
+function shutdownRunner({exitCode, reason, shutdownRequestedAtMs = null, signal = null}) {
   if (shutdownPromise) return shutdownPromise
 
   shutdownPromise = (async () => {
+    await sendShutdownObservation({reason, shutdownRequestedAtMs, signal})
     await closeRunnerConnections(currentConfigurationOrNull())
     process.exit(exitCode)
   })()
@@ -60,6 +69,52 @@ function updateProcessTitle() {
   process.title = count > 0 ? `${BASE_PROCESS_TITLE}: ${count} ${count === 1 ? "job" : "jobs"}` : BASE_PROCESS_TITLE
 }
 
+/**
+ * Sends one bounded lifecycle observation before application/framework teardown.
+ * A closed IPC channel is expected for `ipc_disconnect`; other send failures are
+ * surfaced on stderr but never hold connection cleanup past the fixed bound.
+ * @param {object} args - Shutdown observation.
+ * @param {import("./types.js").PooledChildShutdownReason} args.reason - Shutdown reason.
+ * @param {number | null} args.shutdownRequestedAtMs - Parent request timestamp.
+ * @param {import("node:child_process").ChildProcess["signalCode"]} args.signal - Requested or observed signal.
+ * @returns {Promise<void>} - Resolves after IPC accepts the observation or the bound expires.
+ */
+async function sendShutdownObservation({reason, shutdownRequestedAtMs, signal}) {
+  if (!process.send || !process.connected) return
+
+  const boundedInflight = boundedPooledRunnerInflightJobIds(runningJobIds)
+  /** @type {import("./types.js").PooledChildShutdownObservation & {type: "shutdown-observation"}} */
+  const message = {
+    childInstanceId,
+    ...boundedInflight,
+    reason,
+    shutdownObservedAtMs: Date.now(),
+    shutdownRequestedAtMs,
+    signal,
+    type: "shutdown-observation"
+  }
+
+  try {
+    await timeout({timeout: SHUTDOWN_OBSERVATION_SEND_TIMEOUT_MS}, async () => {
+      await new Promise((resolve, reject) => {
+        try {
+          process.send?.(message, (error) => {
+            if (error) {
+              reject(error)
+            } else {
+              resolve(undefined)
+            }
+          })
+        } catch (error) {
+          reject(error)
+        }
+      })
+    })
+  } catch (error) {
+    console.error("Pooled background job runner could not send its shutdown observation:", error)
+  }
+}
+
 /**
  * Reports one acceptance observation (job received / perform started) to the
  * worker over IPC. The message carries the job's exact handoff lease so the
@@ -105,6 +160,22 @@ function isJobMessage(message) {
   return record.type === "job" && !!record.payload && typeof record.payload === "object" && typeof record.payload.id === "string"
 }
 
+/**
+ * Checks whether an IPC value requests a typed pooled-child shutdown.
+ * @param {ReturnType<typeof JSON.parse>} message - IPC message.
+ * @returns {message is {type: "shutdown-request", reason: import("./types.js").PooledChildShutdownReason, shutdownRequestedAtMs: number, signal: import("node:child_process").ChildProcess["signalCode"]}} - Whether this is a valid parent shutdown request.
+ */
+function isShutdownRequestMessage(message) {
+  if (!message || typeof message !== "object") return false
+  const record = /** @type {{type?: ReturnType<typeof JSON.parse>, reason?: ReturnType<typeof JSON.parse>, shutdownRequestedAtMs?: ReturnType<typeof JSON.parse>, signal?: ReturnType<typeof JSON.parse>}} */ (message)
+
+  return record.type === "shutdown-request"
+    && isPooledChildShutdownReason(record.reason)
+    && typeof record.shutdownRequestedAtMs === "number"
+    && Number.isFinite(record.shutdownRequestedAtMs)
+    && isPooledChildShutdownSignal(record.signal)
+}
+
 /**
  * Sends the terminal outcome after the main/DB report has been acknowledged or rejected.
  * @param {object} args - Outcome.
@@ -176,6 +247,16 @@ async function runJob(payload, sharedTransactionBroker) {
  * @returns {void}
  */
 function handleMessage(message) {
+  if (isShutdownRequestMessage(message)) {
+    void shutdownRunner({
+      exitCode: message.reason === "parent_retire_drained" ? 0 : 1,
+      reason: message.reason,
+      shutdownRequestedAtMs: message.shutdownRequestedAtMs,
+      signal: message.signal
+    })
+    return
+  }
+
   if (!isJobMessage(message) || runningJobIds.has(message.payload.id)) return
 
   runningJobIds.add(message.payload.id)
@@ -185,6 +266,7 @@ function handleMessage(message) {
 }
 
 process.on("message", (message) => handleMessage(message))
-process.once("disconnect", () => void shutdownRunner(0))
-for (const signal of ["SIGTERM", "SIGINT"]) process.once(signal, () => void shutdownRunner(1))
-if (process.send) process.send({type: "ready"})
+process.once("disconnect", () => void shutdownRunner({exitCode: 0, reason: "ipc_disconnect"}))
+process.once("SIGTERM", () => void shutdownRunner({exitCode: 1, reason: "signal_sigterm", signal: "SIGTERM"}))
+process.once("SIGINT", () => void shutdownRunner({exitCode: 1, reason: "signal_sigint", signal: "SIGINT"}))
+if (process.send) process.send({childInstanceId, childPid: process.pid, type: "ready"})

package/src/background-jobs/pooled-runner-shutdown.js

@@ -0,0 +1,55 @@
+// @ts-check
+
+import { constants } from "node:os"
+
+/** Maximum job ids copied into a pooled-child shutdown observation or failure snapshot. */
+export const POOLED_RUNNER_INFLIGHT_JOB_ID_LIMIT = 100
+
+/** @type {readonly import("./types.js").PooledChildShutdownReason[]} */
+export const POOLED_CHILD_SHUTDOWN_REASONS = Object.freeze([
+  "parent_retire_drained",
+  "job_timeout",
+  "worker_stop",
+  "signal_sigterm",
+  "signal_sigint",
+  "signal_sigkill",
+  "signal_other",
+  "ipc_disconnect",
+  "process_error",
+  "unexpected_exit"
+])
+
+/**
+ * Checks one dynamic IPC reason against the complete shutdown contract.
+ * @param {ReturnType<typeof JSON.parse>} value - Candidate shutdown reason.
+ * @returns {value is import("./types.js").PooledChildShutdownReason} - Whether the value is a known reason.
+ */
+export function isPooledChildShutdownReason(value) {
+  if (typeof value !== "string") return false
+
+  return POOLED_CHILD_SHUTDOWN_REASONS.some((reason) => reason === value)
+}
+
+/**
+ * Checks one dynamic IPC value against Node's named process signals.
+ * @param {ReturnType<typeof JSON.parse>} value - Candidate signal.
+ * @returns {value is import("node:child_process").ChildProcess["signalCode"]} - Whether the value is null or a named signal.
+ */
+export function isPooledChildShutdownSignal(value) {
+  return value === null || (typeof value === "string" && Object.hasOwn(constants.signals, value))
+}
+
+/**
+ * Sorts, deduplicates, and bounds job ids before they cross IPC/report boundaries.
+ * @param {Iterable<string>} jobIds - In-flight durable job ids.
+ * @returns {{inflightJobIds: string[], inflightJobIdsTruncatedCount: number}} - Bounded snapshot.
+ */
+export function boundedPooledRunnerInflightJobIds(jobIds) {
+  const sortedJobIds = [...new Set(jobIds)].sort((left, right) => left.localeCompare(right))
+  const inflightJobIds = sortedJobIds.slice(0, POOLED_RUNNER_INFLIGHT_JOB_ID_LIMIT)
+
+  return {
+    inflightJobIds,
+    inflightJobIdsTruncatedCount: sortedJobIds.length - inflightJobIds.length
+  }
+}