@byline/cli 4.8.0 → 4.10.0

package/dist/lib/database/postgres.test.js

@@ -0,0 +1,14 @@
+import { Client } from 'pg';
+import { describe, expect, it } from 'vitest';
+import { postgresProvisioner, postgresRoleStatements } from './postgres.js';
+describe('PostgreSQL provisioner', () => {
+    it('registers for PostgreSQL', () => {
+        expect(postgresProvisioner.adapter).toBe('postgres');
+    });
+    it('escapes role identifiers and password literals', () => {
+        const statements = postgresRoleStatements(new Client(), 'role"name', "p'ass\\word");
+        expect(statements.create).toBe('CREATE ROLE "role""name" WITH LOGIN');
+        expect(statements.alter).toBe('ALTER ROLE "role""name" WITH PASSWORD  E\'p\'\'ass\\\\word\'');
+    });
+});
+//# sourceMappingURL=postgres.test.js.map

package/dist/lib/database/postgres.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.test.js","sourceRoot":"","sources":["../../../src/lib/database/postgres.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAA;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAE3E,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,MAAM,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC,CAAA;QAEnF,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;QACrE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAA;IAC/F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/lib/database/provisioner.d.ts

@@ -0,0 +1,35 @@
+import type { DatabaseAdapterId } from '../../types.js';
+import type { Logger } from '../../ui/logger.js';
+export interface DbTargetInspection {
+    exists: boolean;
+    objects: string[];
+}
+export interface ProvisionArgs {
+    adminUrl: string;
+    database: string;
+    user: string;
+    password: string;
+    reset: boolean;
+    logger: Pick<Logger, 'step' | 'success'>;
+}
+export interface BaselineArgs {
+    applicationUrl: string;
+    migrationsFolder: string;
+    logger: Pick<Logger, 'step' | 'success'>;
+}
+export interface DbProvisioner {
+    readonly adapter: DatabaseAdapterId;
+    verifyAdminConnection(adminUrl: string): Promise<string>;
+    inspectTarget(adminUrl: string, database: string): Promise<DbTargetInspection>;
+    provisionTarget(args: ProvisionArgs): Promise<void>;
+    applyBaseline(args: BaselineArgs): Promise<void>;
+}
+export type DatabaseProvisionerRegistry = Readonly<Record<DatabaseAdapterId, DbProvisioner>>;
+export declare const DATABASE_PROVISIONERS: {
+    readonly postgres: DbProvisioner;
+    readonly mysql: DbProvisioner;
+};
+export declare function databaseProvisioner(adapter: DatabaseAdapterId, registry?: DatabaseProvisionerRegistry): DbProvisioner;
+export declare function isValidDatabaseIdentifier(adapter: DatabaseAdapterId, kind: 'database' | 'user', value: string): boolean;
+export declare function databaseIdentifierRequirement(adapter: DatabaseAdapterId, kind: 'database' | 'user'): string;
+//# sourceMappingURL=provisioner.d.ts.map

package/dist/lib/database/provisioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioner.d.ts","sourceRoot":"","sources":["../../../src/lib/database/provisioner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC9E,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD;AAED,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAA;AAE5F,eAAO,MAAM,qBAAqB;;;CAGc,CAAA;AAEhD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,GAAE,2BAAmD,GAC5D,aAAa,CAEf;AAKD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,KAAK,EAAE,MAAM,GACZ,OAAO,CAGT;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,UAAU,GAAG,MAAM,GACxB,MAAM,CAGR"}

package/dist/lib/database/provisioner.js

@@ -0,0 +1,20 @@
+import { mysqlProvisioner } from './mysql.js';
+import { postgresProvisioner } from './postgres.js';
+export const DATABASE_PROVISIONERS = {
+    postgres: postgresProvisioner,
+    mysql: mysqlProvisioner,
+};
+export function databaseProvisioner(adapter, registry = DATABASE_PROVISIONERS) {
+    return registry[adapter];
+}
+const IDENTIFIER_START = '[a-z_]';
+const IDENTIFIER_REST = '[a-z0-9_]';
+export function isValidDatabaseIdentifier(adapter, kind, value) {
+    const maxLength = adapter === 'mysql' ? (kind === 'user' ? 32 : 64) : 63;
+    return new RegExp(`^${IDENTIFIER_START}${IDENTIFIER_REST}{0,${maxLength - 1}}$`).test(value);
+}
+export function databaseIdentifierRequirement(adapter, kind) {
+    const maxLength = adapter === 'mysql' ? (kind === 'user' ? 32 : 64) : 63;
+    return `lowercase letters, digits, and underscores; start with a letter or underscore; max ${maxLength} characters`;
+}
+//# sourceMappingURL=provisioner.js.map

package/dist/lib/database/provisioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioner.js","sourceRoot":"","sources":["../../../src/lib/database/provisioner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAkCnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,mBAAmB;IAC7B,KAAK,EAAE,gBAAgB;CACuB,CAAA;AAEhD,MAAM,UAAU,mBAAmB,CACjC,OAA0B,EAC1B,QAAQ,GAAgC,qBAAqB;IAE7D,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AACjC,MAAM,eAAe,GAAG,WAAW,CAAA;AAEnC,MAAM,UAAU,yBAAyB,CACvC,OAA0B,EAC1B,IAAyB,EACzB,KAAa;IAEb,MAAM,SAAS,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACxE,OAAO,IAAI,MAAM,CAAC,IAAI,gBAAgB,GAAG,eAAe,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC9F,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAA0B,EAC1B,IAAyB;IAEzB,MAAM,SAAS,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACxE,OAAO,sFAAsF,SAAS,aAAa,CAAA;AACrH,CAAC"}

package/dist/lib/database/provisioner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provisioner.test.d.ts.map

package/dist/lib/database/provisioner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioner.test.d.ts","sourceRoot":"","sources":["../../../src/lib/database/provisioner.test.ts"],"names":[],"mappings":""}

package/dist/lib/database/provisioner.test.js

@@ -0,0 +1,32 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { DATABASE_PROVISIONERS, databaseIdentifierRequirement, isValidDatabaseIdentifier, } from './provisioner.js';
+describe('database provisioner registry', () => {
+    it('registers both supported adapters', () => {
+        expect(DATABASE_PROVISIONERS.postgres.adapter).toBe('postgres');
+        expect(DATABASE_PROVISIONERS.mysql.adapter).toBe('mysql');
+    });
+    it.each(['postgres.ts', 'mysql.ts'])('%s never shells out', (filename) => {
+        const source = readFileSync(fileURLToPath(new URL(`./${filename}`, import.meta.url)), 'utf8');
+        expect(source).not.toMatch(/from\s+['"](?:node:child_process|child_process|execa)['"]/);
+    });
+});
+describe('database identifier policy', () => {
+    it.each([
+        ['postgres', 'database', 'a'.repeat(63), true],
+        ['postgres', 'database', 'a'.repeat(64), false],
+        ['mysql', 'database', 'a'.repeat(64), true],
+        ['mysql', 'database', 'a'.repeat(65), false],
+        ['mysql', 'user', 'a'.repeat(32), true],
+        ['mysql', 'user', 'a'.repeat(33), false],
+        ['mysql', 'user', "editor'ops", false],
+        ['postgres', 'user', 'Editor', false],
+    ])('%s %s identifier %j is valid=%s', (adapter, kind, value, valid) => {
+        expect(isValidDatabaseIdentifier(adapter, kind, value)).toBe(valid);
+    });
+    it('describes the MySQL account-name limit', () => {
+        expect(databaseIdentifierRequirement('mysql', 'user')).toContain('max 32');
+    });
+});
+//# sourceMappingURL=provisioner.test.js.map

package/dist/lib/database/provisioner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioner.test.js","sourceRoot":"","sources":["../../../src/lib/database/provisioner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,kBAAkB,CAAA;AAEzB,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/D,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,qBAAqB,EAAE,CAAC,QAAQ,EAAE,EAAE;QACvE,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,QAAQ,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QAC7F,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,2DAA2D,CAAC,CAAA;IACzF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;QAC9C,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;QAC/C,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;QAC3C,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;QAC5C,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;QACvC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;QACxC,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC;QACtC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;KAC7B,CAAC,CAAC,iCAAiC,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7E,MAAM,CAAC,yBAAyB,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/lib/database/selection.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context.js';
+import type { DatabaseAdapterId } from '../../types.js';
+export interface DatabaseAdapterInspection {
+    state: 'resolved' | 'pending' | 'blocked';
+    adapter?: DatabaseAdapterId;
+    reason?: string;
+}
+export declare function isDatabaseAdapterId(value: unknown): value is DatabaseAdapterId;
+export declare function inspectDatabaseAdapter(ctx: Context): DatabaseAdapterInspection;
+export declare function resolveDatabaseAdapter(ctx: Context): Promise<DatabaseAdapterId | null>;
+//# sourceMappingURL=selection.d.ts.map

package/dist/lib/database/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/lib/database/selection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAEvD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;IACzC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CA0B9E;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAsB5F"}

package/dist/lib/database/selection.js

@@ -0,0 +1,52 @@
+import { DATABASE_ADAPTER_IDS, DATABASE_ADAPTERS, DEFAULT_DATABASE_ADAPTER } from './adapters.js';
+export function isDatabaseAdapterId(value) {
+    return typeof value === 'string' && DATABASE_ADAPTER_IDS.includes(value);
+}
+export function inspectDatabaseAdapter(ctx) {
+    const persisted = ctx.state.get().answers.dbAdapter;
+    const requested = ctx.cliFlags.database;
+    if (requested !== undefined && !isDatabaseAdapterId(requested)) {
+        return {
+            state: 'blocked',
+            reason: `invalid database adapter "${String(requested)}"; expected ${DATABASE_ADAPTER_IDS.join(' or ')}`,
+        };
+    }
+    if (persisted !== undefined && !isDatabaseAdapterId(persisted)) {
+        return {
+            state: 'blocked',
+            reason: `persisted database adapter "${String(persisted)}" is invalid`,
+        };
+    }
+    if (persisted && requested && persisted !== requested) {
+        return {
+            state: 'blocked',
+            reason: `this installation is already configured for ${persisted}; ` +
+                `changing it to ${requested} is a data migration, not an installer re-run`,
+        };
+    }
+    const adapter = persisted ?? requested;
+    return adapter ? { state: 'resolved', adapter } : { state: 'pending' };
+}
+export async function resolveDatabaseAdapter(ctx) {
+    const inspection = inspectDatabaseAdapter(ctx);
+    if (inspection.state === 'blocked') {
+        ctx.logger.error(inspection.reason ?? 'database adapter selection is invalid');
+        return null;
+    }
+    if (inspection.adapter) {
+        if (!ctx.state.get().answers.dbAdapter) {
+            ctx.state.patchAnswers({ dbAdapter: inspection.adapter });
+        }
+        return inspection.adapter;
+    }
+    const adapter = await ctx.prompter.select({
+        message: 'Which database should Byline use?',
+        options: DATABASE_ADAPTER_IDS.map((id) => ({
+            value: id,
+            label: `${DATABASE_ADAPTERS[id].selectionLabel}${id === DEFAULT_DATABASE_ADAPTER ? ' (default)' : ''}`,
+        })),
+    });
+    ctx.state.patchAnswers({ dbAdapter: adapter });
+    return adapter;
+}
+//# sourceMappingURL=selection.js.map

package/dist/lib/database/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/lib/database/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAUjG,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACjG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAA;IACnD,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAA;IAEvC,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,6BAA6B,MAAM,CAAC,SAAS,CAAC,eAAe,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;SACzG,CAAA;IACH,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,+BAA+B,MAAM,CAAC,SAAS,CAAC,cAAc;SACvE,CAAA;IACH,CAAC;IACD,IAAI,SAAS,IAAI,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EACJ,+CAA+C,SAAS,IAAI;gBAC5D,kBAAkB,SAAS,+CAA+C;SAC7E,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,IAAI,SAAS,CAAA;IACtC,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAY;IACvD,MAAM,UAAU,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;IAC9C,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,uCAAuC,CAAC,CAAA;QAC9E,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAA;QAC3D,CAAC;QACD,OAAO,UAAU,CAAC,OAAO,CAAA;IAC3B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAoB;QAC3D,OAAO,EAAE,mCAAmC;QAC5C,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACzC,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC,cAAc,GAAG,EAAE,KAAK,wBAAwB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE;SACvG,CAAC,CAAC;KACJ,CAAC,CAAA;IACF,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;IAC9C,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/lib/database/selection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selection.test.d.ts.map

package/dist/lib/database/selection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.test.d.ts","sourceRoot":"","sources":["../../../src/lib/database/selection.test.ts"],"names":[],"mappings":""}

package/dist/lib/database/selection.test.js

@@ -0,0 +1,58 @@
+import { rmSync } from 'node:fs';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createTestContext } from '../../test-helpers.js';
+import { inspectDatabaseAdapter, isDatabaseAdapterId, resolveDatabaseAdapter } from './selection.js';
+const contexts = [];
+afterEach(() => {
+    for (const ctx of contexts.splice(0))
+        rmSync(ctx.cwd, { recursive: true, force: true });
+});
+describe('database adapter selection', () => {
+    it.each([
+        ['postgres', true],
+        ['mysql', true],
+        ['sqlite', false],
+        ['', false],
+        [true, false],
+    ])('classifies %j as a supported adapter=%s', (value, supported) => {
+        expect(isDatabaseAdapterId(value)).toBe(supported);
+    });
+    it('persists a command-line selection into fresh state', async () => {
+        const ctx = createTestContext({ dbAdapter: undefined });
+        contexts.push(ctx);
+        ctx.cliFlags.database = 'mysql';
+        expect(await resolveDatabaseAdapter(ctx)).toBe('mysql');
+        expect(ctx.state.get().answers.dbAdapter).toBe('mysql');
+    });
+    it('prompts for a fresh state and uses PostgreSQL as the first/default choice', async () => {
+        const ctx = createTestContext({ dbAdapter: undefined });
+        contexts.push(ctx);
+        expect(await resolveDatabaseAdapter(ctx)).toBe('postgres');
+        expect(ctx.state.get().answers.dbAdapter).toBe('postgres');
+    });
+    it('reuses the persisted adapter when the matching flag is supplied', async () => {
+        const ctx = createTestContext({ dbAdapter: 'mysql' });
+        contexts.push(ctx);
+        ctx.cliFlags.database = 'mysql';
+        expect(inspectDatabaseAdapter(ctx)).toEqual({ state: 'resolved', adapter: 'mysql' });
+        expect(await resolveDatabaseAdapter(ctx)).toBe('mysql');
+    });
+    it('blocks a conflicting flag without changing persisted state', async () => {
+        const ctx = createTestContext({ dbAdapter: 'postgres' });
+        contexts.push(ctx);
+        ctx.cliFlags.database = 'mysql';
+        expect(inspectDatabaseAdapter(ctx)).toMatchObject({ state: 'blocked' });
+        expect(await resolveDatabaseAdapter(ctx)).toBeNull();
+        expect(ctx.state.get().answers.dbAdapter).toBe('postgres');
+    });
+    it('blocks an invalid value even when a caller bypasses CLI validation', () => {
+        const ctx = createTestContext({ dbAdapter: undefined });
+        contexts.push(ctx);
+        ctx.cliFlags.database = 'sqlite';
+        expect(inspectDatabaseAdapter(ctx)).toMatchObject({
+            state: 'blocked',
+            reason: expect.stringContaining('sqlite'),
+        });
+    });
+});
+//# sourceMappingURL=selection.test.js.map

package/dist/lib/database/selection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.test.js","sourceRoot":"","sources":["../../../src/lib/database/selection.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAGpG,MAAM,QAAQ,GAAc,EAAE,CAAA;AAE9B,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AACzF,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,UAAU,EAAE,IAAI,CAAC;QAClB,CAAC,OAAO,EAAE,IAAI,CAAC;QACf,CAAC,QAAQ,EAAE,KAAK,CAAC;QACjB,CAAC,EAAE,EAAE,KAAK,CAAC;QACX,CAAC,IAAI,EAAE,KAAK,CAAC;KACd,CAAC,CAAC,yCAAyC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QACjE,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAA;QACvD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClB,GAAG,CAAC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAA;QAE/B,MAAM,CAAC,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACvD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAA;QACvD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAElB,MAAM,CAAC,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC1D,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;QACrD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClB,GAAG,CAAC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAA;QAE/B,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;QACpF,MAAM,CAAC,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAA;QACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClB,GAAG,CAAC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAA;QAE/B,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QACvE,MAAM,CAAC,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;QACpD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAA;QACvD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClB,GAAG,CAAC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAEhC,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;YAChD,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC;SAC1C,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/lib/database/state.d.ts

@@ -0,0 +1,4 @@
+import type { DbTargetInspection } from './provisioner.js';
+export type DbTargetState = 'missing' | 'empty' | 'byline-schema' | 'occupied-schema';
+export declare function classifyDbTarget(inspection: DbTargetInspection): DbTargetState;
+//# sourceMappingURL=state.d.ts.map

package/dist/lib/database/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/lib/database/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,iBAAiB,CAAA;AAErF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,aAAa,CAM9E"}

package/dist/lib/database/state.js

@@ -0,0 +1,10 @@
+export function classifyDbTarget(inspection) {
+    if (!inspection.exists)
+        return 'missing';
+    if (inspection.objects.length === 0)
+        return 'empty';
+    return inspection.objects.some((name) => name.toLowerCase().startsWith('byline_'))
+        ? 'byline-schema'
+        : 'occupied-schema';
+}
+//# sourceMappingURL=state.js.map

package/dist/lib/database/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/lib/database/state.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,gBAAgB,CAAC,UAA8B;IAC7D,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAA;IACnD,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAChF,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,iBAAiB,CAAA;AACvB,CAAC"}

package/dist/lib/database/state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state.test.d.ts.map

package/dist/lib/database/state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.d.ts","sourceRoot":"","sources":["../../../src/lib/database/state.test.ts"],"names":[],"mappings":""}

package/dist/lib/database/state.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest';
+import { classifyDbTarget } from './state.js';
+describe.each([
+    [{ exists: false, objects: [] }, 'missing'],
+    [{ exists: true, objects: [] }, 'empty'],
+    [{ exists: true, objects: ['byline_documents'] }, 'byline-schema'],
+    [{ exists: true, objects: ['BYLINE_DOCUMENTS'] }, 'byline-schema'],
+    [{ exists: true, objects: ['posts'] }, 'occupied-schema'],
+    [{ exists: true, objects: ['posts', 'byline_documents'] }, 'byline-schema'],
+    [{ exists: true, objects: ['current_documents_view'] }, 'occupied-schema'],
+    [{ exists: true, objects: ['__drizzle_migrations'] }, 'occupied-schema'],
+])('database target classification', (inspection, expected) => {
+    it(`classifies ${JSON.stringify(inspection)} as ${expected}`, () => {
+        expect(classifyDbTarget({ ...inspection, objects: [...inspection.objects] })).toBe(expected);
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/lib/database/state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.js","sourceRoot":"","sources":["../../../src/lib/database/state.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,QAAQ,CAAC,IAAI,CAAC;IACZ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC;IAC3C,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC;IACxC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,eAAe,CAAC;IAClE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,eAAe,CAAC;IAClE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,iBAAiB,CAAC;IACzD,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,EAAE,eAAe,CAAC;IAC3E,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,wBAAwB,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC1E,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,CAAC;CAChE,CAAC,CAAC,gCAAgC,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;IACrE,EAAE,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,QAAQ,EAAE,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,gBAAgB,CAAC,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC9F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/lib/database/urls.d.ts

@@ -0,0 +1,19 @@
+import type { DatabaseAdapterId } from '../../types.js';
+export interface DbConnectionParts {
+    host: string;
+    port?: number;
+    user: string;
+    password: string;
+    database: string;
+}
+export interface DatabaseUrlCodec {
+    acceptedProtocols: readonly string[];
+    defaultPort?: number;
+    build(connection: DbConnectionParts): string;
+    parse(raw: string): DbConnectionParts;
+}
+export declare function defaultDbPort(adapter: DatabaseAdapterId): number | undefined;
+export declare function buildDbUrl(adapter: DatabaseAdapterId, connection: DbConnectionParts): string;
+export declare function parseDbUrl(raw: string, adapter: DatabaseAdapterId): DbConnectionParts;
+export declare function withDbDatabase(connection: DbConnectionParts, database: string): DbConnectionParts;
+//# sourceMappingURL=urls.d.ts.map

package/dist/lib/database/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../../src/lib/database/urls.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAEvD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAAA;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAA;CACtC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAE5F;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAErF;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAEjG"}

package/dist/lib/database/urls.js

@@ -0,0 +1,14 @@
+import { databaseAdapterDefinition } from './adapters.js';
+export function defaultDbPort(adapter) {
+    return databaseAdapterDefinition(adapter).url.defaultPort;
+}
+export function buildDbUrl(adapter, connection) {
+    return databaseAdapterDefinition(adapter).url.build(connection);
+}
+export function parseDbUrl(raw, adapter) {
+    return databaseAdapterDefinition(adapter).url.parse(raw);
+}
+export function withDbDatabase(connection, database) {
+    return { ...connection, database };
+}
+//# sourceMappingURL=urls.js.map

package/dist/lib/database/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../../../src/lib/database/urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AAkBzD,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA0B,EAAE,UAA6B;IAClF,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAA0B;IAChE,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAA6B,EAAE,QAAgB;IAC5E,OAAO,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAE,CAAA;AACpC,CAAC"}

package/dist/lib/database/urls.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=urls.test.d.ts.map

package/dist/lib/database/urls.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.test.d.ts","sourceRoot":"","sources":["../../../src/lib/database/urls.test.ts"],"names":[],"mappings":""}

package/dist/lib/database/urls.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import { buildDbUrl, defaultDbPort, parseDbUrl, withDbDatabase } from './urls.js';
+describe.each([
+    ['postgres', 'postgresql', 5432],
+    ['mysql', 'mysql', 3306],
+])('%s database URLs', (adapter, protocol, defaultPort) => {
+    it('round-trips encoded credentials and database names', () => {
+        const parts = {
+            host: 'db.example.test',
+            port: defaultPort,
+            user: "by/line'editor",
+            password: 'p@ss/#% word',
+            database: 'byline content',
+        };
+        const rendered = buildDbUrl(adapter, parts);
+        expect(rendered).toMatch(new RegExp(`^${protocol}://`));
+        expect(rendered).not.toContain(parts.password);
+        expect(parseDbUrl(rendered, adapter)).toEqual(parts);
+    });
+    it('uses the dialect default port and can replace the database', () => {
+        const parsed = parseDbUrl(`${protocol}://root:secret@localhost/system`, adapter);
+        expect(parsed.port).toBe(defaultPort);
+        expect(defaultDbPort(adapter)).toBe(defaultPort);
+        expect(withDbDatabase(parsed, 'byline')).toMatchObject({ database: 'byline' });
+    });
+});
+it('rejects a connection URL for the wrong dialect', () => {
+    expect(() => parseDbUrl('mysql://root:secret@localhost/mysql', 'postgres')).toThrow('expected postgres connection URL');
+    expect(() => parseDbUrl('postgresql://root:secret@localhost/postgres', 'mysql')).toThrow('expected mysql connection URL');
+});
+//# sourceMappingURL=urls.test.js.map

package/dist/lib/database/urls.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.test.js","sourceRoot":"","sources":["../../../src/lib/database/urls.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEjF,QAAQ,CAAC,IAAI,CAAC;IACZ,CAAC,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC;IAChC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;CAChB,CAAC,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE;IACjE,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,cAAc;YACxB,QAAQ,EAAE,gBAAgB;SAC3B,CAAA;QACD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAE3C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAC9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,QAAQ,iCAAiC,EAAE,OAAO,CAAC,CAAA;QAChF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACrC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAChD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;IACxD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,qCAAqC,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CACjF,kCAAkC,CACnC,CAAA;IACD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,6CAA6C,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CACtF,+BAA+B,CAChC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/lib/dependency-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-version.d.ts","sourceRoot":"","sources":["../../src/lib/dependency-version.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAAA;IACjD,gBAAgB,EAAE,OAAO,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,uBAAuB,CAMzB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,uBAAuB,CA+CzB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtF"}
+{"version":3,"file":"dependency-version.d.ts","sourceRoot":"","sources":["../../src/lib/dependency-version.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAAA;IACjD,gBAAgB,EAAE,OAAO,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,uBAAuB,CAMzB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,uBAAuB,CAgDzB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtF"}

package/dist/lib/dependency-version.js

@@ -17,6 +17,7 @@ export function checkDependencyVersion(spec, declared, actualVersion) {
         return { status: 'compatible', preserveDeclared: false, reason: 'not a Byline package' };
     }
     const trimmed = declared.trim();
+    const supportedRange = spec.versionPolicy === 'exact' ? spec.version : BYLINE_RELEASE_POLICY.supportedRange;
     if (BARE_WORKSPACE_RANGES.has(trimmed)) {
         if (!actualVersion) {
             return {
@@ -25,12 +26,12 @@ export function checkDependencyVersion(spec, declared, actualVersion) {
                 reason: `${trimmed} target version could not be resolved locally`,
             };
         }
-        if (!valid(actualVersion) || !satisfies(actualVersion, BYLINE_RELEASE_POLICY.supportedRange)) {
+        if (!valid(actualVersion) || !satisfies(actualVersion, supportedRange)) {
             return {
                 status: 'incompatible',
                 preserveDeclared: true,
                 actualVersion,
-                reason: `${trimmed} resolves to unsupported ${actualVersion}`,
+                reason: `${trimmed} resolves to ${actualVersion}, expected ${supportedRange}`,
             };
         }
         return {
@@ -45,13 +46,13 @@ export function checkDependencyVersion(spec, declared, actualVersion) {
         return { status: 'incompatible', preserveDeclared: false, reason: 'invalid version range' };
     }
     try {
-        const compatible = validRange(range) !== null && subset(range, BYLINE_RELEASE_POLICY.supportedRange);
+        const compatible = validRange(range) !== null && subset(range, supportedRange);
         return compatible
             ? { status: 'compatible', preserveDeclared: trimmed.startsWith('workspace:'), reason: range }
             : {
                 status: 'incompatible',
                 preserveDeclared: trimmed.startsWith('workspace:'),
-                reason: `${range} is not wholly within ${BYLINE_RELEASE_POLICY.supportedRange}`,
+                reason: `${range} is not wholly within ${supportedRange}`,
             };
     }
     catch {

package/dist/lib/dependency-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-version.js","sourceRoot":"","sources":["../../src/lib/dependency-version.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dependency-version.js","sourceRoot":"","sources":["../../src/lib/dependency-version.ts"],"names":[],"mappings":"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"}

package/dist/lib/template-hook-boundary.test.node.js

@@ -2,6 +2,7 @@ import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { describe, expect, it } from 'vitest';
+import { DATABASE_ADAPTER_IDS } from './database/adapters.js';
 const templates = resolve(dirname(fileURLToPath(import.meta.url)), '../templates');
 function source(path) {
     return readFileSync(resolve(templates, path), 'utf8');
@@ -10,18 +11,22 @@ describe('scaffold server hook boundary', () => {
     it('keeps the example schema host-agnostic and registers its hooks from the server graph', () => {
         const schema = source('byline-examples/collections/docs/schema.ts');
         const registry = source('byline-examples/collections/server-hooks.ts');
-        const serverConfig = source('byline-examples/server.config.ts');
         expect(schema).not.toContain('@tanstack/react-start');
         expect(schema).not.toContain('createServerOnlyFn');
         expect(schema).not.toContain("'./hooks.js'");
         expect(registry).toContain("docs: () => import('./docs/hooks.js')");
-        expect(serverConfig).toContain("import { serverHooks } from './collections/server-hooks.js'");
-        expect(serverConfig).toContain('hooks: serverHooks');
+        for (const adapter of DATABASE_ADAPTER_IDS) {
+            const serverConfig = source(`dialects/${adapter}/byline-examples/server.config.ts`);
+            expect(serverConfig).toContain("import { serverHooks } from './collections/server-hooks.js'");
+            expect(serverConfig).toContain('hooks: serverHooks');
+        }
     });
     it('ships the registry seam in both scaffold flavors and configures the host build guard', () => {
         for (const flavor of ['byline', 'byline-examples']) {
             expect(source(`${flavor}/collections/server-hooks.ts`)).toContain('satisfies ServerHooksConfig');
-            expect(source(`${flavor}/server.config.ts`)).toContain('hooks: serverHooks');
+            for (const adapter of DATABASE_ADAPTER_IDS) {
+                expect(source(`dialects/${adapter}/${flavor}/server.config.ts`)).toContain('hooks: serverHooks');
+            }
         }
         expect(source('host/vite.config.ts')).toContain("import { bylineClientHookBoundary } from '@byline/host-tanstack-start/vite'");
         expect(source('host/vite.config.ts')).toContain('bylineClientHookBoundary()');

package/dist/lib/template-hook-boundary.test.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-hook-boundary.test.node.js","sourceRoot":"","sources":["../../src/lib/template-hook-boundary.test.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;AAElF,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;AACvD,CAAC;AAED,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,MAAM,MAAM,GAAG,MAAM,CAAC,4CAA4C,CAAC,CAAA;QACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,6CAA6C,CAAC,CAAA;QACtE,MAAM,YAAY,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAA;QAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QAC5C,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAA;QACnE,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,6DAA6D,CAAC,CAAA;QAC7F,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,8BAA8B,CAAC,CAAC,CAAC,SAAS,CAC/D,6BAA6B,CAC9B,CAAA;YACD,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;QAC9E,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAC7C,6EAA6E,CAC9E,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAA;IAC/E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"template-hook-boundary.test.node.js","sourceRoot":"","sources":["../../src/lib/template-hook-boundary.test.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;AAElF,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;AACvD,CAAC;AAED,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,MAAM,MAAM,GAAG,MAAM,CAAC,4CAA4C,CAAC,CAAA;QACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,6CAA6C,CAAC,CAAA;QAEtE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QAC5C,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAA;QACnE,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;YAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,OAAO,mCAAmC,CAAC,CAAA;YACnF,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,6DAA6D,CAAC,CAAA;YAC7F,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAA;QACtD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,8BAA8B,CAAC,CAAC,CAAC,SAAS,CAC/D,6BAA6B,CAC9B,CAAA;YACD,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;gBAC3C,MAAM,CAAC,MAAM,CAAC,YAAY,OAAO,IAAI,MAAM,mBAAmB,CAAC,CAAC,CAAC,SAAS,CACxE,oBAAoB,CACrB,CAAA;YACH,CAAC;QACH,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAC7C,6EAA6E,CAC9E,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAA;IAC/E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/manifest/deps.d.ts

@@ -14,6 +14,7 @@
  * `src/routes/_byline/`, `src/ui/byline/`). Transitive deps reach the
  * user via the `@byline/*` package boundary and don't need declaring.
  */
+import type { Answers, DatabaseAdapterId } from '../types.js';
 export type DepGroup = 'byline' | 'runtime' | 'dev';
 /**
  * Tag for opt-in deps. When set, the `deps` phase only installs the
@@ -21,7 +22,7 @@ export type DepGroup = 'byline' | 'runtime' | 'dev';
  * of dependencies they didn't ask for (e.g. the markdown ingestion stack
  * that exists only to serve `byline/scripts/import-docs.ts`).
  */
-export type DepOptionalFlag = 'importDocs';
+export type DepOptionalFlag = 'examples' | 'importDocs';
 export interface DepSpec {
     name: string;
     version: string;
@@ -30,7 +31,13 @@ export interface DepSpec {
     note: string;
     /** When set, only install if the matching `answers` flag is true. */
     optional?: DepOptionalFlag;
+    /** Database adapters for which this dependency is required. */
+    adapters?: readonly DatabaseAdapterId[];
+    /** Byline compatibility rule. Defaults to the supported release range. */
+    versionPolicy?: 'supported-range' | 'exact';
 }
 export declare const BYLINE_VERSION: string;
+export declare const BYLINE_ADAPTER_VERSION: string;
 export declare const DEP_SPECS: readonly DepSpec[];
+export declare function dependencySpecsFor(answers: Answers): readonly DepSpec[];
 //# sourceMappingURL=deps.d.ts.map

package/dist/manifest/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,CAAA;AAE1C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AAKD,eAAO,MAAM,cAAc,QAAwC,CAAA;AAEnE,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EA0L9B,CAAA"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE7D,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,CAAA;AAEvD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACvC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAA;CAC5C;AAKD,eAAO,MAAM,cAAc,QAAwC,CAAA;AACnE,eAAO,MAAM,sBAAsB,QAAsB,CAAA;AA2BzD,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAgL9B,CAAA;AAEV,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAQvE"}