@zintrust/core 2.4.1 → 2.4.2

package/src/migrations/schema/SchemaCompiler.js

@@ -0,0 +1,275 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { AdaptersEnum, ColumnType, isSqliteFamily, SchOther } from '../enum/index.js';
+const IDENT_RE = /^[A-Za-z_]\w*$/;
+function isSupportedDriver(driver) {
+    return (driver === AdaptersEnum.sqlite ||
+        driver === AdaptersEnum.d1 ||
+        driver === AdaptersEnum.d1Remote ||
+        driver === AdaptersEnum.postgresql ||
+        driver === AdaptersEnum.mysql ||
+        driver === AdaptersEnum.sqlserver);
+}
+function assertIdentifier(label, value) {
+    if (!IDENT_RE.test(value)) {
+        throw ErrorFactory.createValidationError(`Invalid ${label} identifier: ${value}`);
+    }
+}
+function requireSupportedDriver(driver) {
+    if (!isSupportedDriver(driver)) {
+        throw ErrorFactory.createValidationError(`Unsupported DB driver: ${driver}`);
+    }
+    return driver;
+}
+function quoteIdent(driver, ident) {
+    assertIdentifier(ColumnType.SQL, ident);
+    if (driver === AdaptersEnum.mysql)
+        return `\`${ident}\``;
+    return `"${ident}"`;
+}
+function normalizeForeignKeyAction(action) {
+    switch (action) {
+        case ColumnType.CASCADE:
+        case ColumnType.SETNULL:
+        case ColumnType.RESTRICT:
+        case ColumnType.NOACTION:
+        case ColumnType.SETDEFAULT:
+            return action;
+        default:
+            throw ErrorFactory.createValidationError(`Unsupported foreign key action: ${String(action)}`);
+    }
+}
+const TYPE_SQL = Object.freeze({
+    STRING: (driver, def) => {
+        const len = typeof def.length === SchOther.NUMBER && Number.isFinite(def.length) ? def.length : 255;
+        return isSqliteFamily(driver) ? ColumnType.TEXT : `${ColumnType.VARCHAR}(${len})`;
+    },
+    DATE: (driver) => (isSqliteFamily(driver) ? ColumnType.TEXT : ColumnType.DATE),
+    INTEGER: (driver) => (driver === AdaptersEnum.mysql ? ColumnType.INT : ColumnType.INTEGER),
+    BIGINT: () => ColumnType.BIGINT,
+    UUID: (driver) => {
+        if (driver === AdaptersEnum.postgresql)
+            return ColumnType.UUID;
+        return isSqliteFamily(driver) ? ColumnType.TEXT : `${ColumnType.VARCHAR}(36)`;
+    },
+    REAL: (driver) => (driver === AdaptersEnum.sqlserver ? ColumnType.FLOAT : ColumnType.REAL),
+    BOOLEAN: (driver) => (driver === AdaptersEnum.mysql ? ColumnType.TINYINT_1 : ColumnType.BOOLEAN),
+    TEXT: () => ColumnType.TEXT,
+    JSON: (driver) => {
+        if (driver === AdaptersEnum.postgresql)
+            return ColumnType.JSONB;
+        if (driver === AdaptersEnum.mysql)
+            return ColumnType.JSON;
+        return ColumnType.TEXT;
+    },
+    TIMESTAMP: (driver) => {
+        if (driver === AdaptersEnum.mysql)
+            return ColumnType.DATETIME;
+        if (driver === AdaptersEnum.postgresql)
+            return ColumnType.TIMESTAMP;
+        return ColumnType.TEXT;
+    },
+    BLOB: (driver) => (driver === AdaptersEnum.postgresql ? ColumnType.BYTEA : ColumnType.BLOB),
+});
+function getColumnTypeSql(driver, def) {
+    return TYPE_SQL[def.type](driver, def);
+}
+function getAutoIncrementColumnSql(driver, colName, type, isUnsigned = false) {
+    const sqliteFamily = isSqliteFamily(driver);
+    if (sqliteFamily) {
+        return `${colName} ${ColumnType.INTEGER} ${ColumnType.PRIMARY_KEY} ${ColumnType.AUTOINCREMENT}`;
+    }
+    if (driver === AdaptersEnum.postgresql) {
+        return `${colName} ${type === ColumnType.BIGINT ? ColumnType.BIGSERIAL : ColumnType.SERIAL} ${ColumnType.PRIMARY_KEY}`;
+    }
+    if (driver === AdaptersEnum.mysql) {
+        const typeSql = type === ColumnType.BIGINT ? ColumnType.BIGINT : ColumnType.INT;
+        const unsignedStr = isUnsigned ? ` ${ColumnType.UNSIGNED}` : '';
+        return `${colName} ${typeSql}${unsignedStr} ${ColumnType.AUTO_INCREMENT} ${ColumnType.PRIMARY_KEY}`;
+    }
+    if (driver === AdaptersEnum.sqlserver) {
+        const typeSql = type === ColumnType.BIGINT ? ColumnType.BIGINT : ColumnType.INT;
+        return `${colName} ${typeSql} ${ColumnType.IDENTITY_1_1} ${ColumnType.PRIMARY_KEY}`;
+    }
+    throw ErrorFactory.createValidationError(`Auto-increment not supported for driver: ${driver}`);
+}
+function formatDefaultValueSql(driver, table, def) {
+    if (def.defaultValue === undefined)
+        return null;
+    const dv = def.defaultValue;
+    if (dv === null)
+        return ColumnType.DEFAULT_NULL;
+    if (typeof dv === 'number' && Number.isFinite(dv))
+        return `DEFAULT ${dv}`;
+    if (typeof dv === 'boolean') {
+        if (driver === AdaptersEnum.postgresql)
+            return `DEFAULT ${dv ? 'true' : 'false'}`;
+        return `DEFAULT ${dv ? 1 : 0}`;
+    }
+    if (typeof dv === 'string') {
+        if (dv === ColumnType.CURRENT_TIMESTAMP)
+            return `DEFAULT ${ColumnType.CURRENT_TIMESTAMP}`;
+        const escaped = dv.replaceAll("'", "''");
+        return `DEFAULT '${escaped}'`;
+    }
+    throw ErrorFactory.createValidationError(`Unsupported default type for ${table}.${def.name}`);
+}
+function buildColumnSql(driver, table, def) {
+    assertIdentifier(SchOther.TABLE, table);
+    assertIdentifier(SchOther.COLUMN, def.name);
+    const col = quoteIdent(driver, def.name);
+    if (def.autoIncrement === true) {
+        if (def.type !== ColumnType.INTEGER && def.type !== ColumnType.BIGINT) {
+            throw ErrorFactory.createValidationError(`Auto-increment column must be INTEGER or BIGINT: ${table}.${def.name}`);
+        }
+        return getAutoIncrementColumnSql(driver, col, def.type, def.unsigned === true);
+    }
+    const parts = [`${col} ${getColumnTypeSql(driver, def)}`];
+    if (driver === AdaptersEnum.mysql &&
+        def.unsigned === true &&
+        (def.type === ColumnType.INTEGER ||
+            def.type === ColumnType.BIGINT ||
+            def.type === ColumnType.REAL)) {
+        parts.push(ColumnType.UNSIGNED);
+    }
+    if (def.nullable !== true)
+        parts.push(ColumnType.NOT_NULL);
+    if (def.unique === true)
+        parts.push(ColumnType.UNIQUE);
+    if (def.primary === true)
+        parts.push(ColumnType.PRIMARY_KEY);
+    const defaultSql = formatDefaultValueSql(driver, table, def);
+    if (defaultSql !== null)
+        parts.push(defaultSql);
+    return parts.join(' ');
+}
+function buildPrimaryKeyConstraintSql(driver, columns) {
+    const cols = columns.map((c) => {
+        assertIdentifier(SchOther.COLUMN, c);
+        return quoteIdent(driver, c);
+    });
+    return `${ColumnType.PRIMARY_KEY} (${cols.join(', ')})`;
+}
+function buildForeignKeyConstraintSql(driver, table, fk) {
+    assertIdentifier(SchOther.TABLE, table);
+    assertIdentifier(SchOther.FOREIGN_KEY, fk.name);
+    assertIdentifier(SchOther.REFERENCED_TABLE, fk.referencedTable);
+    for (const c of fk.columns)
+        assertIdentifier(SchOther.COLUMN, c);
+    for (const c of fk.referencedColumns)
+        assertIdentifier(SchOther.REFERENCED_COLUMN, c);
+    const constraint = `${ColumnType.CONSTRAINT} ${quoteIdent(driver, fk.name)}`;
+    const localCols = fk.columns.map((c) => quoteIdent(driver, c)).join(', ');
+    const refCols = fk.referencedColumns.map((c) => quoteIdent(driver, c)).join(', ');
+    const parts = [
+        `${constraint} ${ColumnType.FOREIGN_KEY_S} (${localCols}) ${ColumnType.REFERENCES} ${quoteIdent(driver, fk.referencedTable)} (${refCols})`,
+    ];
+    if (fk.onDelete)
+        parts.push(`${ColumnType.ON_DELETE} ${normalizeForeignKeyAction(fk.onDelete)}`);
+    if (fk.onUpdate)
+        parts.push(`${ColumnType.ON_UPDATE} ${normalizeForeignKeyAction(fk.onUpdate)}`);
+    return parts.join(' ');
+}
+function buildCreateIndexSql(driver, table, idx) {
+    assertIdentifier(SchOther.TABLE, table);
+    assertIdentifier(SchOther.INDEX, idx.name);
+    for (const c of idx.columns)
+        assertIdentifier(SchOther.COLUMN, c);
+    const createPrefix = idx.type === ColumnType.UNIQUE ? 'CREATE UNIQUE INDEX' : ColumnType.CREATE_INDEX_S;
+    const cols = idx.columns.map((c) => quoteIdent(driver, c)).join(', ');
+    return `${createPrefix} ${quoteIdent(driver, idx.name)} ${ColumnType.ON} ${quoteIdent(driver, table)} (${cols})`;
+}
+function buildDropIndexSql(driver, table, indexName) {
+    assertIdentifier(SchOther.TABLE, table);
+    assertIdentifier(SchOther.INDEX, indexName);
+    if (driver === AdaptersEnum.mysql) {
+        return `${ColumnType.DROP_INDEX_S} ${quoteIdent(driver, indexName)} ${ColumnType.ON} ${quoteIdent(driver, table)}`;
+    }
+    return `${ColumnType.DROP_INDEX_S} ${ColumnType.IF_EXISTS} ${quoteIdent(driver, indexName)}`;
+}
+function buildDropTableSql(driver, table, ifExists) {
+    assertIdentifier(SchOther.TABLE, table);
+    const ine = ifExists ? `${ColumnType.IF_EXISTS} ` : '';
+    return `${ColumnType.DROP_TABLE_S} ${ine}${quoteIdent(driver, table)}`;
+}
+function buildCreateTableStatements(driver, def, ifNotExists) {
+    assertIdentifier(SchOther.TABLE, def.name);
+    if (def.columns.length === 0) {
+        throw ErrorFactory.createValidationError(`Schema for table '${def.name}' has no columns`);
+    }
+    const primaryCols = def.columns.filter((c) => c.primary === true).map((c) => c.name);
+    const colLines = def.columns.map((c) => buildColumnSql(driver, def.name, c));
+    const constraints = [];
+    if (primaryCols.length > 1)
+        constraints.push(buildPrimaryKeyConstraintSql(driver, primaryCols));
+    for (const fk of def.foreignKeys) {
+        constraints.push(buildForeignKeyConstraintSql(driver, def.name, fk));
+    }
+    const allLines = [...colLines, ...constraints].map((l) => `  ${l}`);
+    const ine = ifNotExists ? `${ColumnType.IF_NOT_EXISTS} ` : '';
+    const createSql = `${ColumnType.CREATE_TABLE_S} ${ine}${quoteIdent(driver, def.name)} (\n${allLines.join(',\n')}\n)`;
+    const statements = [createSql];
+    for (const idx of def.indexes) {
+        statements.push(buildCreateIndexSql(driver, def.name, idx));
+    }
+    return statements;
+}
+function compileAddColumns(driver, table, cols) {
+    return cols.map((col) => {
+        const colSql = buildColumnSql(driver, table, col);
+        return `${ColumnType.ALTER_TABLE_S} ${quoteIdent(driver, table)} ${ColumnType.ADD_COLUMN_S} ${colSql}`;
+    });
+}
+function compileIndexOps(driver, table, plan) {
+    const create = plan.createIndexes.map((idx) => buildCreateIndexSql(driver, table, idx));
+    const drop = plan.dropIndexes.map((idx) => buildDropIndexSql(driver, table, idx));
+    return [...create, ...drop];
+}
+function compileAdvancedAlterOps(driver, table, plan) {
+    const needs = plan.dropColumns.length > 0 ||
+        plan.addForeignKeys.length > 0 ||
+        plan.dropForeignKeys.length > 0;
+    if (!needs)
+        return [];
+    if (isSqliteFamily(driver)) {
+        throw ErrorFactory.createValidationError('SQLite/D1 does not support dropping columns or altering foreign keys safely (table rebuild required)');
+    }
+    const statements = [];
+    for (const col of plan.dropColumns) {
+        assertIdentifier(SchOther.COLUMN, col);
+        statements.push(`${ColumnType.ALTER_TABLE_S} ${quoteIdent(driver, table)} ${ColumnType.DROP_COLUMN_S} ${quoteIdent(driver, col)}`);
+    }
+    for (const fk of plan.addForeignKeys) {
+        statements.push(`${ColumnType.ALTER_TABLE_S} ${quoteIdent(driver, table)} ${ColumnType.ADD} ${buildForeignKeyConstraintSql(driver, table, fk)}`);
+    }
+    for (const fkName of plan.dropForeignKeys) {
+        assertIdentifier(SchOther.FOREIGN_KEY, fkName);
+        if (driver === AdaptersEnum.mysql) {
+            statements.push(`${ColumnType.ALTER_TABLE_S} ${quoteIdent(driver, table)} ${ColumnType.DROP} ${ColumnType.FOREIGN_KEY_S} ${quoteIdent(driver, fkName)}`);
+            continue;
+        }
+        statements.push(`${ColumnType.ALTER_TABLE_S} ${quoteIdent(driver, table)} ${ColumnType.DROP} ${ColumnType.CONSTRAINT} ${quoteIdent(driver, fkName)}`);
+    }
+    return statements;
+}
+function buildAlterTableStatements(driver, table, plan) {
+    assertIdentifier(SchOther.TABLE, table);
+    return [
+        ...compileAddColumns(driver, table, plan.addColumns),
+        ...compileIndexOps(driver, table, plan),
+        ...compileAdvancedAlterOps(driver, table, plan),
+    ];
+}
+export const MigrationSchemaCompiler = Object.freeze({
+    compileCreateTable(driver, def, opts) {
+        const d = requireSupportedDriver(driver);
+        return buildCreateTableStatements(d, def, opts?.ifNotExists !== false);
+    },
+    compileDropTable(driver, table, opts) {
+        const d = requireSupportedDriver(driver);
+        return buildDropTableSql(d, table, opts?.ifExists !== false);
+    },
+    compileAlterTable(driver, table, plan) {
+        const d = requireSupportedDriver(driver);
+        return buildAlterTableStatements(d, table, plan);
+    },
+});

package/src/migrations/schema/index.d.ts

@@ -0,0 +1,5 @@
+export { MigrationBlueprint } from '../schema/Blueprint';
+export { Schema } from '../schema/Schema';
+export { MigrationSchemaCompiler } from '../schema/SchemaCompiler';
+export type { Blueprint, BlueprintCallback, ColumnBuilder, ColumnDefinition, ColumnType, ForeignKeyAction, ForeignKeyBuilder, ForeignKeyDefinition, IndexDefinition, IndexType, SchemaBuilder, TableDefinition, } from '../schema/types';
+//# sourceMappingURL=index.d.ts.map

package/src/migrations/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/migrations/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,0BAA0B,CAAC"}

package/src/migrations/schema/index.js

@@ -0,0 +1,3 @@
+export { MigrationBlueprint } from '../schema/Blueprint.js';
+export { Schema } from '../schema/Schema.js';
+export { MigrationSchemaCompiler } from '../schema/SchemaCompiler.js';

package/src/migrations/schema/types.d.ts

@@ -0,0 +1,88 @@
+import type { IDatabase } from '../../orm/Database';
+export type ColumnType = 'STRING' | 'DATE' | 'INTEGER' | 'BIGINT' | 'UUID' | 'REAL' | 'BOOLEAN' | 'TEXT' | 'JSON' | 'TIMESTAMP' | 'BLOB';
+export type IndexType = 'INDEX' | 'UNIQUE';
+export type ForeignKeyAction = 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION' | 'SET DEFAULT';
+export type ColumnDefinition = {
+    name: string;
+    type: ColumnType;
+    length?: number;
+    nullable: boolean;
+    defaultValue?: unknown;
+    primary: boolean;
+    unique: boolean;
+    autoIncrement: boolean;
+    unsigned: boolean;
+};
+export type IndexDefinition = {
+    name: string;
+    columns: string[];
+    type: IndexType;
+};
+export type ForeignKeyDefinition = {
+    name: string;
+    columns: string[];
+    referencedTable: string;
+    referencedColumns: string[];
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
+};
+export type TableDefinition = {
+    name: string;
+    columns: ColumnDefinition[];
+    indexes: IndexDefinition[];
+    foreignKeys: ForeignKeyDefinition[];
+};
+export type BlueprintCallback<TBlueprint> = (table: TBlueprint) => void | Promise<void>;
+export type ColumnBuilder = {
+    nullable(): ColumnBuilder;
+    notNullable(): ColumnBuilder;
+    default(value: unknown): ColumnBuilder;
+    unique(): ColumnBuilder;
+    primary(): ColumnBuilder;
+    autoIncrement(): ColumnBuilder;
+    unsigned(): ColumnBuilder;
+    getDefinition(): ColumnDefinition;
+};
+export type ForeignKeyBuilder = {
+    references(columns: string | string[]): ForeignKeyBuilder;
+    on(table: string): ForeignKeyBuilder;
+    onDelete(action: ForeignKeyAction): ForeignKeyBuilder;
+    onUpdate(action: ForeignKeyAction): ForeignKeyBuilder;
+    getDefinition(): ForeignKeyDefinition;
+};
+export type Blueprint = {
+    uuid(name: string): ColumnBuilder;
+    string(name: string, length?: number): ColumnBuilder;
+    date(name: string): ColumnBuilder;
+    integer(name: string): ColumnBuilder;
+    bigInteger(name: string): ColumnBuilder;
+    real(name: string): ColumnBuilder;
+    boolean(name: string): ColumnBuilder;
+    text(name: string): ColumnBuilder;
+    json(name: string): ColumnBuilder;
+    timestamp(name: string): ColumnBuilder;
+    blob(name: string): ColumnBuilder;
+    id(name?: string): ColumnBuilder;
+    timestamps(createdAt?: string, updatedAt?: string): void;
+    index(columns: string | string[], name?: string): void;
+    unique(columns: string | string[], name?: string): void;
+    foreign(columns: string | string[], name?: string): ForeignKeyBuilder;
+    dropColumn(name: string): void;
+    dropIndex(name: string): void;
+    dropForeign(name: string): void;
+    getDefinition(): TableDefinition;
+    getDropColumns(): string[];
+    getDropIndexes(): string[];
+    getDropForeignKeys(): string[];
+};
+export type SchemaBuilder = {
+    create(tableName: string, callback: BlueprintCallback<Blueprint>): Promise<void>;
+    table(tableName: string, callback: BlueprintCallback<Blueprint>): Promise<void>;
+    drop(tableName: string): Promise<void>;
+    dropIfExists(tableName: string): Promise<void>;
+    hasTable(tableName: string): Promise<boolean>;
+    hasColumn(tableName: string, columnName: string): Promise<boolean>;
+    getAllTables(): Promise<string[]>;
+    getDb(): IDatabase;
+};
+//# sourceMappingURL=types.d.ts.map

package/src/migrations/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/migrations/schema/types.ts"],"names":[],"mappings":"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"}

package/src/migrations/schema/types.js

@@ -0,0 +1 @@
+export {};

package/src/migrations/types.d.ts

@@ -0,0 +1,45 @@
+import type { IDatabase } from '../orm/Database';
+export type MigrationScope = 'global' | 'service';
+export type MigrationRecordStatus = 'running' | 'completed' | 'failed';
+export type MigrationRecord = {
+    name: string;
+    scope: MigrationScope;
+    service: string;
+    batch: number;
+    status: MigrationRecordStatus;
+    appliedAt: string | null;
+};
+export type MigrationModule = {
+    migration?: {
+        up?: unknown;
+        down?: unknown;
+    };
+    up?: unknown;
+    down?: unknown;
+};
+export type MigrationHandler = (db: IDatabase) => Promise<void>;
+export type LoadedMigration = {
+    name: string;
+    filePath: string;
+    up: MigrationHandler;
+    down: MigrationHandler;
+};
+export type MigratorStatusRow = {
+    name: string;
+    applied: boolean;
+    batch: number | null;
+    status: string | null;
+    appliedAt: string | null;
+};
+export type MigratorOptions = {
+    db: IDatabase;
+    projectRoot: string;
+    globalDir: string;
+    extension: string;
+    lockFile?: string;
+    separateTracking?: boolean;
+    scope?: MigrationScope;
+    service?: string;
+    includeGlobal?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/src/migrations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/migrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,EAAE;QACV,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC"}

package/src/migrations/types.js

@@ -0,0 +1 @@
+export {};

package/src/node-singletons/async_hooks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Node.js Async Hooks Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:async_hooks built-in
+ */
+import * as async_hooks from 'node:async_hooks';
+export declare const AsyncLocalStorage: typeof async_hooks.AsyncLocalStorage, AsyncResource: typeof async_hooks.AsyncResource, createHook: typeof async_hooks.createHook, executionAsyncId: typeof async_hooks.executionAsyncId, triggerAsyncId: typeof async_hooks.triggerAsyncId;
+export default async_hooks;
+//# sourceMappingURL=async_hooks.d.ts.map

package/src/node-singletons/async_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_hooks.d.ts","sourceRoot":"","sources":["../../../src/node-singletons/async_hooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD,eAAO,MAAQ,iBAAiB,wCAAE,aAAa,oCAAE,UAAU,iCAAE,gBAAgB,uCAAE,cAAc,mCAChF,CAAC;AAEd,eAAe,WAAW,CAAC"}

package/src/node-singletons/async_hooks.js

@@ -0,0 +1,8 @@
+/**
+ * Node.js Async Hooks Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:async_hooks built-in
+ */
+import * as async_hooks from 'node:async_hooks';
+export const { AsyncLocalStorage, AsyncResource, createHook, executionAsyncId, triggerAsyncId } = async_hooks;
+export default async_hooks;

package/src/node-singletons/child-process.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Node.js Child Process Module Singleton
+ * CLI-only: Should not be imported in API/serverless code
+ * Exported from node:child_process built-in
+ */
+export { execFileSync, execSync, spawn } from 'node:child_process';
+//# sourceMappingURL=child-process.d.ts.map

package/src/node-singletons/child-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../../src/node-singletons/child-process.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}

package/src/node-singletons/child-process.js

@@ -0,0 +1,6 @@
+/**
+ * Node.js Child Process Module Singleton
+ * CLI-only: Should not be imported in API/serverless code
+ * Exported from node:child_process built-in
+ */
+export { execFileSync, execSync, spawn } from 'node:child_process';

package/src/node-singletons/crypto.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Node.js Crypto Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:crypto built-in
+ */
+export { createCipheriv, createDecipheriv, createHash, createHmac, createSign, createVerify, generateKeyPairSync, pbkdf2, pbkdf2Sync, randomBytes, randomInt, randomUUID, scryptSync, timingSafeEqual, } from 'node:crypto';
+//# sourceMappingURL=crypto.d.ts.map

package/src/node-singletons/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/node-singletons/crypto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/src/node-singletons/crypto.js

@@ -0,0 +1,6 @@
+/**
+ * Node.js Crypto Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:crypto built-in
+ */
+export { createCipheriv, createDecipheriv, createHash, createHmac, createSign, createVerify, generateKeyPairSync, pbkdf2, pbkdf2Sync, randomBytes, randomInt, randomUUID, scryptSync, timingSafeEqual, } from 'node:crypto';

package/src/node-singletons/events.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Node.js Events Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:events built-in
+ */
+export { EventEmitter } from 'node:events';
+//# sourceMappingURL=events.d.ts.map

package/src/node-singletons/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/node-singletons/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/src/node-singletons/events.js

@@ -0,0 +1,6 @@
+/**
+ * Node.js Events Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:events built-in
+ */
+export { EventEmitter } from 'node:events';

package/src/node-singletons/fs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Node.js File System Module Singleton
+ * CLI-only: Should not be imported in API/serverless code
+ * Exported from node:fs and node:fs/promises built-ins
+ */
+import * as fs from 'node:fs';
+export * as fsPromises from 'node:fs/promises';
+export { appendFileSync, copyFileSync, createReadStream, createWriteStream, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, utimesSync, writeFileSync, } from 'node:fs';
+export type { PathLike, ReadStream, Stats, WriteStream, WriteStreamOptions } from 'node:fs';
+export { mkdir, mkdtemp, readFile, realpath, rm, stat, writeFile } from 'node:fs/promises';
+export default fs;
+//# sourceMappingURL=fs.d.ts.map

package/src/node-singletons/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/node-singletons/fs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAK9B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,MAAM,EACN,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE5F,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG3F,eAAe,EAAE,CAAC"}

package/src/node-singletons/fs.js

@@ -0,0 +1,14 @@
+/**
+ * Node.js File System Module Singleton
+ * CLI-only: Should not be imported in API/serverless code
+ * Exported from node:fs and node:fs/promises built-ins
+ */
+import * as fs from 'node:fs';
+// Many parts of the CLI codebase use the "fsPromises" naming convention.
+// Exporting it here keeps imports consistent and makes Vitest mocking of
+// `node:fs/promises` flow through this singleton layer.
+export * as fsPromises from 'node:fs/promises';
+export { appendFileSync, copyFileSync, createReadStream, createWriteStream, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, utimesSync, writeFileSync, } from 'node:fs';
+export { mkdir, mkdtemp, readFile, realpath, rm, stat, writeFile } from 'node:fs/promises';
+// Default export for compatibility
+export default fs;

package/src/node-singletons/http.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Node.js HTTP Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:http built-in
+ */
+export { createServer, IncomingMessage, ServerResponse } from 'node:http';
+export type { IncomingHttpHeaders, OutgoingHttpHeader, OutgoingHttpHeaders, Server, } from 'node:http';
+//# sourceMappingURL=http.d.ts.map

package/src/node-singletons/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/node-singletons/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1E,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,GACP,MAAM,WAAW,CAAC"}

package/src/node-singletons/http.js

@@ -0,0 +1,6 @@
+/**
+ * Node.js HTTP Module Singleton
+ * Safe to import in both API and CLI code
+ * Exported from node:http built-in
+ */
+export { createServer, IncomingMessage, ServerResponse } from 'node:http';

package/src/node-singletons/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Node.js Singleton Modules
+ * Centralized exports for all node:* imports
+ * This allows conditional loading and runtime-aware imports
+ *
+ * Safe for all runtimes (API, CLI, Serverless):
+ * - http
+ * - crypto
+ * - events
+ * - perf-hooks
+ *
+ * CLI-only (Node.js):
+ * - fs
+ * - path
+ * - child-process
+ * - url
+ * - os
+ * - readline
+ */
+export * from './async_hooks';
+export * from './crypto';
+export * from './events';
+export * from './http';
+export * from './perf-hooks';
+export * as process from './process';
+export * as childProcess from './child-process';
+export * as fs from './fs';
+export * as module from './module';
+export * as net from './net';
+export * as os from './os';
+export * as path from './path';
+export * as readline from './readline';
+export * as tls from './tls';
+export * as url from './url';
+//# sourceMappingURL=index.d.ts.map

package/src/node-singletons/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node-singletons/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AAGpD,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AACtD,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC"}