typhex 0.1.0-alpha.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +20 -0
- package/LICENSE +21 -0
- package/README.md +417 -0
- package/SECURITY.md +32 -0
- package/dist/arrow/aggregates.d.ts +12 -0
- package/dist/arrow/aggregates.d.ts.map +1 -0
- package/dist/arrow/aggregates.js +32 -0
- package/dist/arrow/aggregates.js.map +1 -0
- package/dist/arrow/constants.d.ts +15 -0
- package/dist/arrow/constants.d.ts.map +1 -0
- package/dist/arrow/constants.js +42 -0
- package/dist/arrow/constants.js.map +1 -0
- package/dist/arrow/index.d.ts +7 -0
- package/dist/arrow/index.d.ts.map +1 -0
- package/dist/arrow/index.js +7 -0
- package/dist/arrow/index.js.map +1 -0
- package/dist/config/index.d.ts +6 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +4 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/load-config.d.ts +19 -0
- package/dist/config/load-config.d.ts.map +1 -0
- package/dist/config/load-config.js +84 -0
- package/dist/config/load-config.js.map +1 -0
- package/dist/config/load-env.d.ts +7 -0
- package/dist/config/load-env.d.ts.map +1 -0
- package/dist/config/load-env.js +62 -0
- package/dist/config/load-env.js.map +1 -0
- package/dist/config/types.d.ts +20 -0
- package/dist/config/types.d.ts.map +1 -0
- package/dist/config/types.js +10 -0
- package/dist/config/types.js.map +1 -0
- package/dist/dbs/base-migrator.d.ts +20 -0
- package/dist/dbs/base-migrator.d.ts.map +1 -0
- package/dist/dbs/base-migrator.js +112 -0
- package/dist/dbs/base-migrator.js.map +1 -0
- package/dist/dbs/index.d.ts +9 -0
- package/dist/dbs/index.d.ts.map +1 -0
- package/dist/dbs/index.js +17 -0
- package/dist/dbs/index.js.map +1 -0
- package/dist/dbs/postgres/dialect.d.ts +8 -0
- package/dist/dbs/postgres/dialect.d.ts.map +1 -0
- package/dist/dbs/postgres/dialect.js +17 -0
- package/dist/dbs/postgres/dialect.js.map +1 -0
- package/dist/dbs/postgres/driver.d.ts +42 -0
- package/dist/dbs/postgres/driver.d.ts.map +1 -0
- package/dist/dbs/postgres/driver.js +111 -0
- package/dist/dbs/postgres/driver.js.map +1 -0
- package/dist/dbs/postgres/index.d.ts +6 -0
- package/dist/dbs/postgres/index.d.ts.map +1 -0
- package/dist/dbs/postgres/index.js +5 -0
- package/dist/dbs/postgres/index.js.map +1 -0
- package/dist/dbs/postgres/migrator.d.ts +13 -0
- package/dist/dbs/postgres/migrator.d.ts.map +1 -0
- package/dist/dbs/postgres/migrator.js +22 -0
- package/dist/dbs/postgres/migrator.js.map +1 -0
- package/dist/dbs/postgres/query-compiler.d.ts +22 -0
- package/dist/dbs/postgres/query-compiler.d.ts.map +1 -0
- package/dist/dbs/postgres/query-compiler.js +140 -0
- package/dist/dbs/postgres/query-compiler.js.map +1 -0
- package/dist/dbs/postgres/trx.d.ts +16 -0
- package/dist/dbs/postgres/trx.d.ts.map +1 -0
- package/dist/dbs/postgres/trx.js +68 -0
- package/dist/dbs/postgres/trx.js.map +1 -0
- package/dist/dbs/query-compiler.d.ts +135 -0
- package/dist/dbs/query-compiler.d.ts.map +1 -0
- package/dist/dbs/query-compiler.js +775 -0
- package/dist/dbs/query-compiler.js.map +1 -0
- package/dist/dbs/sqlite/dialect.d.ts +8 -0
- package/dist/dbs/sqlite/dialect.d.ts.map +1 -0
- package/dist/dbs/sqlite/dialect.js +17 -0
- package/dist/dbs/sqlite/dialect.js.map +1 -0
- package/dist/dbs/sqlite/driver.d.ts +9 -0
- package/dist/dbs/sqlite/driver.d.ts.map +1 -0
- package/dist/dbs/sqlite/driver.js +66 -0
- package/dist/dbs/sqlite/driver.js.map +1 -0
- package/dist/dbs/sqlite/index.d.ts +6 -0
- package/dist/dbs/sqlite/index.d.ts.map +1 -0
- package/dist/dbs/sqlite/index.js +5 -0
- package/dist/dbs/sqlite/index.js.map +1 -0
- package/dist/dbs/sqlite/migrator.d.ts +13 -0
- package/dist/dbs/sqlite/migrator.d.ts.map +1 -0
- package/dist/dbs/sqlite/migrator.js +22 -0
- package/dist/dbs/sqlite/migrator.js.map +1 -0
- package/dist/dbs/sqlite/query-compiler.d.ts +26 -0
- package/dist/dbs/sqlite/query-compiler.d.ts.map +1 -0
- package/dist/dbs/sqlite/query-compiler.js +80 -0
- package/dist/dbs/sqlite/query-compiler.js.map +1 -0
- package/dist/dbs/sqlite/trx.d.ts +13 -0
- package/dist/dbs/sqlite/trx.d.ts.map +1 -0
- package/dist/dbs/sqlite/trx.js +69 -0
- package/dist/dbs/sqlite/trx.js.map +1 -0
- package/dist/dbs/types.d.ts +92 -0
- package/dist/dbs/types.d.ts.map +1 -0
- package/dist/dbs/types.js +26 -0
- package/dist/dbs/types.js.map +1 -0
- package/dist/dialect.d.ts +3 -0
- package/dist/dialect.d.ts.map +1 -0
- package/dist/dialect.js +2 -0
- package/dist/dialect.js.map +1 -0
- package/dist/driver/factory.d.ts +19 -0
- package/dist/driver/factory.d.ts.map +1 -0
- package/dist/driver/factory.js +24 -0
- package/dist/driver/factory.js.map +1 -0
- package/dist/driver/index.d.ts +6 -0
- package/dist/driver/index.d.ts.map +1 -0
- package/dist/driver/index.js +3 -0
- package/dist/driver/index.js.map +1 -0
- package/dist/driver/sqlite.d.ts +15 -0
- package/dist/driver/sqlite.d.ts.map +1 -0
- package/dist/driver/sqlite.js +74 -0
- package/dist/driver/sqlite.js.map +1 -0
- package/dist/driver/types.d.ts +75 -0
- package/dist/driver/types.d.ts.map +1 -0
- package/dist/driver/types.js +2 -0
- package/dist/driver/types.js.map +1 -0
- package/dist/entity/entity.d.ts +67 -0
- package/dist/entity/entity.d.ts.map +1 -0
- package/dist/entity/entity.js +139 -0
- package/dist/entity/entity.js.map +1 -0
- package/dist/entity/global-driver.d.ts +38 -0
- package/dist/entity/global-driver.d.ts.map +1 -0
- package/dist/entity/global-driver.js +109 -0
- package/dist/entity/global-driver.js.map +1 -0
- package/dist/entity/index.d.ts +8 -0
- package/dist/entity/index.d.ts.map +1 -0
- package/dist/entity/index.js +3 -0
- package/dist/entity/index.js.map +1 -0
- package/dist/entity/pk-columns.d.ts +5 -0
- package/dist/entity/pk-columns.d.ts.map +1 -0
- package/dist/entity/pk-columns.js +14 -0
- package/dist/entity/pk-columns.js.map +1 -0
- package/dist/entity/relations.d.ts +134 -0
- package/dist/entity/relations.d.ts.map +1 -0
- package/dist/entity/relations.js +23 -0
- package/dist/entity/relations.js.map +1 -0
- package/dist/entity/schema-inference.d.ts +77 -0
- package/dist/entity/schema-inference.d.ts.map +1 -0
- package/dist/entity/schema-inference.js +6 -0
- package/dist/entity/schema-inference.js.map +1 -0
- package/dist/entity/types.d.ts +30 -0
- package/dist/entity/types.d.ts.map +1 -0
- package/dist/entity/types.js +5 -0
- package/dist/entity/types.js.map +1 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +12 -0
- package/dist/index.js.map +1 -0
- package/dist/ir/index.d.ts +2 -0
- package/dist/ir/index.d.ts.map +1 -0
- package/dist/ir/index.js +2 -0
- package/dist/ir/index.js.map +1 -0
- package/dist/ir/types.d.ts +148 -0
- package/dist/ir/types.d.ts.map +1 -0
- package/dist/ir/types.js +97 -0
- package/dist/ir/types.js.map +1 -0
- package/dist/migration/cli.d.ts +18 -0
- package/dist/migration/cli.d.ts.map +1 -0
- package/dist/migration/cli.js +236 -0
- package/dist/migration/cli.js.map +1 -0
- package/dist/migration/diff.d.ts +10 -0
- package/dist/migration/diff.d.ts.map +1 -0
- package/dist/migration/diff.js +10 -0
- package/dist/migration/diff.js.map +1 -0
- package/dist/migration/generator.d.ts +12 -0
- package/dist/migration/generator.d.ts.map +1 -0
- package/dist/migration/generator.js +98 -0
- package/dist/migration/generator.js.map +1 -0
- package/dist/migration/index.d.ts +7 -0
- package/dist/migration/index.d.ts.map +1 -0
- package/dist/migration/index.js +5 -0
- package/dist/migration/index.js.map +1 -0
- package/dist/migration/runner.d.ts +32 -0
- package/dist/migration/runner.d.ts.map +1 -0
- package/dist/migration/runner.js +279 -0
- package/dist/migration/runner.js.map +1 -0
- package/dist/migration/topo-sort.d.ts +12 -0
- package/dist/migration/topo-sort.d.ts.map +1 -0
- package/dist/migration/topo-sort.js +42 -0
- package/dist/migration/topo-sort.js.map +1 -0
- package/dist/migration/types.d.ts +45 -0
- package/dist/migration/types.d.ts.map +1 -0
- package/dist/migration/types.js +2 -0
- package/dist/migration/types.js.map +1 -0
- package/dist/orm/aggregates.d.ts +19 -0
- package/dist/orm/aggregates.d.ts.map +1 -0
- package/dist/orm/aggregates.js +32 -0
- package/dist/orm/aggregates.js.map +1 -0
- package/dist/orm/db.d.ts +105 -0
- package/dist/orm/db.d.ts.map +1 -0
- package/dist/orm/db.js +172 -0
- package/dist/orm/db.js.map +1 -0
- package/dist/orm/expr.d.ts +125 -0
- package/dist/orm/expr.d.ts.map +1 -0
- package/dist/orm/expr.js +10 -0
- package/dist/orm/expr.js.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.d.ts +9 -0
- package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.d.ts.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.js +44 -0
- package/dist/orm/helpers/insert-graph/insert-graph-batch-executor.js.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-executor.d.ts +13 -0
- package/dist/orm/helpers/insert-graph/insert-graph-executor.d.ts.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-executor.js +42 -0
- package/dist/orm/helpers/insert-graph/insert-graph-executor.js.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-planner.d.ts +46 -0
- package/dist/orm/helpers/insert-graph/insert-graph-planner.d.ts.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-planner.js +258 -0
- package/dist/orm/helpers/insert-graph/insert-graph-planner.js.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-sequential-executor.d.ts +7 -0
- package/dist/orm/helpers/insert-graph/insert-graph-sequential-executor.d.ts.map +1 -0
- package/dist/orm/helpers/insert-graph/insert-graph-sequential-executor.js +8 -0
- package/dist/orm/helpers/insert-graph/insert-graph-sequential-executor.js.map +1 -0
- package/dist/orm/helpers/insert-graph/sequence-id-assigner.d.ts +15 -0
- package/dist/orm/helpers/insert-graph/sequence-id-assigner.d.ts.map +1 -0
- package/dist/orm/helpers/insert-graph/sequence-id-assigner.js +48 -0
- package/dist/orm/helpers/insert-graph/sequence-id-assigner.js.map +1 -0
- package/dist/orm/helpers/query-plan/expr-builder.d.ts +155 -0
- package/dist/orm/helpers/query-plan/expr-builder.d.ts.map +1 -0
- package/dist/orm/helpers/query-plan/expr-builder.js +297 -0
- package/dist/orm/helpers/query-plan/expr-builder.js.map +1 -0
- package/dist/orm/helpers/query-plan/query-ir-analyzer.d.ts +48 -0
- package/dist/orm/helpers/query-plan/query-ir-analyzer.d.ts.map +1 -0
- package/dist/orm/helpers/query-plan/query-ir-analyzer.js +262 -0
- package/dist/orm/helpers/query-plan/query-ir-analyzer.js.map +1 -0
- package/dist/orm/helpers/query-plan/query-plan.d.ts +164 -0
- package/dist/orm/helpers/query-plan/query-plan.d.ts.map +1 -0
- package/dist/orm/helpers/query-plan/query-plan.js +549 -0
- package/dist/orm/helpers/query-plan/query-plan.js.map +1 -0
- package/dist/orm/helpers/query-plan/select-classifier.d.ts +161 -0
- package/dist/orm/helpers/query-plan/select-classifier.d.ts.map +1 -0
- package/dist/orm/helpers/query-plan/select-classifier.js +359 -0
- package/dist/orm/helpers/query-plan/select-classifier.js.map +1 -0
- package/dist/orm/helpers/relations/relation-assembler.d.ts +21 -0
- package/dist/orm/helpers/relations/relation-assembler.d.ts.map +1 -0
- package/dist/orm/helpers/relations/relation-assembler.js +60 -0
- package/dist/orm/helpers/relations/relation-assembler.js.map +1 -0
- package/dist/orm/helpers/relations/relation-fetcher.d.ts +30 -0
- package/dist/orm/helpers/relations/relation-fetcher.d.ts.map +1 -0
- package/dist/orm/helpers/relations/relation-fetcher.js +128 -0
- package/dist/orm/helpers/relations/relation-fetcher.js.map +1 -0
- package/dist/orm/helpers/relations/relation-joins.d.ts +74 -0
- package/dist/orm/helpers/relations/relation-joins.d.ts.map +1 -0
- package/dist/orm/helpers/relations/relation-joins.js +138 -0
- package/dist/orm/helpers/relations/relation-joins.js.map +1 -0
- package/dist/orm/helpers/relations/relation-resolver.d.ts +14 -0
- package/dist/orm/helpers/relations/relation-resolver.d.ts.map +1 -0
- package/dist/orm/helpers/relations/relation-resolver.js +25 -0
- package/dist/orm/helpers/relations/relation-resolver.js.map +1 -0
- package/dist/orm/index.d.ts +7 -0
- package/dist/orm/index.d.ts.map +1 -0
- package/dist/orm/index.js +5 -0
- package/dist/orm/index.js.map +1 -0
- package/dist/orm/query-builder.d.ts +136 -0
- package/dist/orm/query-builder.d.ts.map +1 -0
- package/dist/orm/query-builder.js +433 -0
- package/dist/orm/query-builder.js.map +1 -0
- package/dist/orm/query-helpers.d.ts +35 -0
- package/dist/orm/query-helpers.d.ts.map +1 -0
- package/dist/orm/query-helpers.js +83 -0
- package/dist/orm/query-helpers.js.map +1 -0
- package/dist/orm/query-state.d.ts +56 -0
- package/dist/orm/query-state.d.ts.map +1 -0
- package/dist/orm/query-state.js +112 -0
- package/dist/orm/query-state.js.map +1 -0
- package/dist/orm/single-row-query-builder.d.ts +18 -0
- package/dist/orm/single-row-query-builder.d.ts.map +1 -0
- package/dist/orm/single-row-query-builder.js +90 -0
- package/dist/orm/single-row-query-builder.js.map +1 -0
- package/dist/orm/trx.d.ts +40 -0
- package/dist/orm/trx.d.ts.map +1 -0
- package/dist/orm/trx.js +118 -0
- package/dist/orm/trx.js.map +1 -0
- package/dist/parser/acorn-helpers.d.ts +43 -0
- package/dist/parser/acorn-helpers.d.ts.map +1 -0
- package/dist/parser/acorn-helpers.js +104 -0
- package/dist/parser/acorn-helpers.js.map +1 -0
- package/dist/parser/acorn-member.d.ts +16 -0
- package/dist/parser/acorn-member.d.ts.map +1 -0
- package/dist/parser/acorn-member.js +31 -0
- package/dist/parser/acorn-member.js.map +1 -0
- package/dist/parser/acorn-types.d.ts +14 -0
- package/dist/parser/acorn-types.d.ts.map +1 -0
- package/dist/parser/acorn-types.js +6 -0
- package/dist/parser/acorn-types.js.map +1 -0
- package/dist/parser/arrow-source.d.ts +23 -0
- package/dist/parser/arrow-source.d.ts.map +1 -0
- package/dist/parser/arrow-source.js +70 -0
- package/dist/parser/arrow-source.js.map +1 -0
- package/dist/parser/group-by.d.ts +17 -0
- package/dist/parser/group-by.d.ts.map +1 -0
- package/dist/parser/group-by.js +62 -0
- package/dist/parser/group-by.js.map +1 -0
- package/dist/parser/index.d.ts +5 -0
- package/dist/parser/index.d.ts.map +1 -0
- package/dist/parser/index.js +3 -0
- package/dist/parser/index.js.map +1 -0
- package/dist/parser/parse-arrow.d.ts +10 -0
- package/dist/parser/parse-arrow.d.ts.map +1 -0
- package/dist/parser/parse-arrow.js +9 -0
- package/dist/parser/parse-arrow.js.map +1 -0
- package/dist/parser/predicate-walk.d.ts +24 -0
- package/dist/parser/predicate-walk.d.ts.map +1 -0
- package/dist/parser/predicate-walk.js +247 -0
- package/dist/parser/predicate-walk.js.map +1 -0
- package/dist/parser/resolve.d.ts +25 -0
- package/dist/parser/resolve.d.ts.map +1 -0
- package/dist/parser/resolve.js +134 -0
- package/dist/parser/resolve.js.map +1 -0
- package/dist/parser/select.d.ts +7 -0
- package/dist/parser/select.d.ts.map +1 -0
- package/dist/parser/select.js +333 -0
- package/dist/parser/select.js.map +1 -0
- package/dist/parser/update.d.ts +7 -0
- package/dist/parser/update.d.ts.map +1 -0
- package/dist/parser/update.js +51 -0
- package/dist/parser/update.js.map +1 -0
- package/dist/postgres/aggregates.d.ts +12 -0
- package/dist/postgres/aggregates.d.ts.map +1 -0
- package/dist/postgres/aggregates.js +19 -0
- package/dist/postgres/aggregates.js.map +1 -0
- package/dist/postgres.d.ts +6 -0
- package/dist/postgres.d.ts.map +1 -0
- package/dist/postgres.js +6 -0
- package/dist/postgres.js.map +1 -0
- package/dist/schema/index.d.ts +2 -0
- package/dist/schema/index.d.ts.map +1 -0
- package/dist/schema/index.js +2 -0
- package/dist/schema/index.js.map +1 -0
- package/dist/schema/types.d.ts +16 -0
- package/dist/schema/types.d.ts.map +1 -0
- package/dist/schema/types.js +40 -0
- package/dist/schema/types.js.map +1 -0
- package/dist/sqlite/aggregates.d.ts +8 -0
- package/dist/sqlite/aggregates.d.ts.map +1 -0
- package/dist/sqlite/aggregates.js +11 -0
- package/dist/sqlite/aggregates.js.map +1 -0
- package/dist/sqlite.d.ts +6 -0
- package/dist/sqlite.d.ts.map +1 -0
- package/dist/sqlite.js +6 -0
- package/dist/sqlite.js.map +1 -0
- package/dist/transformer/bindings.d.ts +18 -0
- package/dist/transformer/bindings.d.ts.map +1 -0
- package/dist/transformer/bindings.js +52 -0
- package/dist/transformer/bindings.js.map +1 -0
- package/dist/transformer/index.d.ts +17 -0
- package/dist/transformer/index.d.ts.map +1 -0
- package/dist/transformer/index.js +75 -0
- package/dist/transformer/index.js.map +1 -0
- package/dist/transformer/ir-emit.d.ts +12 -0
- package/dist/transformer/ir-emit.d.ts.map +1 -0
- package/dist/transformer/ir-emit.js +144 -0
- package/dist/transformer/ir-emit.js.map +1 -0
- package/dist/transformer/join-transformer.d.ts +12 -0
- package/dist/transformer/join-transformer.d.ts.map +1 -0
- package/dist/transformer/join-transformer.js +102 -0
- package/dist/transformer/join-transformer.js.map +1 -0
- package/dist/transformer/orderby-transformer.d.ts +13 -0
- package/dist/transformer/orderby-transformer.d.ts.map +1 -0
- package/dist/transformer/orderby-transformer.js +84 -0
- package/dist/transformer/orderby-transformer.js.map +1 -0
- package/dist/transformer/select-transformer.d.ts +9 -0
- package/dist/transformer/select-transformer.d.ts.map +1 -0
- package/dist/transformer/select-transformer.js +222 -0
- package/dist/transformer/select-transformer.js.map +1 -0
- package/dist/transformer/shared.d.ts +12 -0
- package/dist/transformer/shared.d.ts.map +1 -0
- package/dist/transformer/shared.js +12 -0
- package/dist/transformer/shared.js.map +1 -0
- package/dist/transformer/subquery-transformer.d.ts +15 -0
- package/dist/transformer/subquery-transformer.d.ts.map +1 -0
- package/dist/transformer/subquery-transformer.js +43 -0
- package/dist/transformer/subquery-transformer.js.map +1 -0
- package/dist/transformer/ts-aggregates.d.ts +13 -0
- package/dist/transformer/ts-aggregates.d.ts.map +1 -0
- package/dist/transformer/ts-aggregates.js +83 -0
- package/dist/transformer/ts-aggregates.js.map +1 -0
- package/dist/transformer/ts-binary.d.ts +8 -0
- package/dist/transformer/ts-binary.d.ts.map +1 -0
- package/dist/transformer/ts-binary.js +32 -0
- package/dist/transformer/ts-binary.js.map +1 -0
- package/dist/transformer/ts-member.d.ts +12 -0
- package/dist/transformer/ts-member.d.ts.map +1 -0
- package/dist/transformer/ts-member.js +22 -0
- package/dist/transformer/ts-member.js.map +1 -0
- package/dist/transformer/ts-utils.d.ts +10 -0
- package/dist/transformer/ts-utils.d.ts.map +1 -0
- package/dist/transformer/ts-utils.js +38 -0
- package/dist/transformer/ts-utils.js.map +1 -0
- package/dist/transformer/typhex-type.d.ts +8 -0
- package/dist/transformer/typhex-type.d.ts.map +1 -0
- package/dist/transformer/typhex-type.js +52 -0
- package/dist/transformer/typhex-type.js.map +1 -0
- package/dist/transformer/where-transformer.d.ts +33 -0
- package/dist/transformer/where-transformer.d.ts.map +1 -0
- package/dist/transformer/where-transformer.js +400 -0
- package/dist/transformer/where-transformer.js.map +1 -0
- package/dist/utils.d.ts +5 -0
- package/dist/utils.d.ts.map +1 -0
- package/dist/utils.js +30 -0
- package/dist/utils.js.map +1 -0
- package/docs/drivers/postgres.md +54 -0
- package/docs/drivers/sqlite.md +33 -0
- package/docs/guide/aggregations.md +272 -0
- package/docs/guide/bulk-operations.md +204 -0
- package/docs/guide/cte-and-unions.md +270 -0
- package/docs/guide/entities-relations.md +208 -0
- package/docs/guide/expressions.md +98 -0
- package/docs/guide/filtering-by-relations.md +166 -0
- package/docs/guide/getting-started.md +277 -0
- package/docs/guide/querying-relations.md +133 -0
- package/docs/guide/subqueries.md +152 -0
- package/docs/guide/transactions.md +146 -0
- package/docs/guide/typescript-transformer.md +138 -0
- package/docs/index.md +33 -0
- package/docs/migrations/overview.md +143 -0
- package/docs/public-api.md +133 -0
- package/docs/reference/api.md +665 -0
- package/docs/reference/architecture.md +83 -0
- package/docs/release-checklist.md +55 -0
- package/etc/typhex.api.md +774 -0
- package/package.json +137 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqC/C,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCvF"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Load typhex config from file or discover in cwd.
|
|
3
|
+
* Resolution: explicit path > typhex.config.js > typhex.config.mjs > typhex.config.json
|
|
4
|
+
*/
|
|
5
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
6
|
+
import { pathToFileURL } from "node:url";
|
|
7
|
+
import { join, resolve } from "node:path";
|
|
8
|
+
import { loadTyphexEnv, envToConfig } from "./load-env.js";
|
|
9
|
+
import { DEFAULT_CONFIG } from "./types.js";
|
|
10
|
+
const CONFIG_NAMES = ["typhex.config.js", "typhex.config.mjs", "typhex.config.json"];
|
|
11
|
+
function findConfigDir(start) {
|
|
12
|
+
let dir = resolve(start);
|
|
13
|
+
for (let i = 0; i < 20; i++) {
|
|
14
|
+
for (const name of CONFIG_NAMES) {
|
|
15
|
+
if (existsSync(join(dir, name)))
|
|
16
|
+
return dir;
|
|
17
|
+
}
|
|
18
|
+
const parent = join(dir, "..");
|
|
19
|
+
if (parent === dir)
|
|
20
|
+
break;
|
|
21
|
+
dir = parent;
|
|
22
|
+
}
|
|
23
|
+
return null;
|
|
24
|
+
}
|
|
25
|
+
async function loadConfigFile(filePath) {
|
|
26
|
+
const url = pathToFileURL(filePath).href;
|
|
27
|
+
let mod;
|
|
28
|
+
if (filePath.endsWith(".json")) {
|
|
29
|
+
const content = readFileSync(filePath, "utf-8");
|
|
30
|
+
mod = JSON.parse(content);
|
|
31
|
+
}
|
|
32
|
+
else {
|
|
33
|
+
mod = await import(url);
|
|
34
|
+
}
|
|
35
|
+
return {
|
|
36
|
+
dialect: mod.dialect,
|
|
37
|
+
database: mod.database,
|
|
38
|
+
url: mod.url,
|
|
39
|
+
migrationsFolder: mod.migrationsFolder,
|
|
40
|
+
entities: mod.entities,
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Load and merge config. Order: overrides > config file > .env > defaults.
|
|
45
|
+
*/
|
|
46
|
+
export async function loadConfig(options = {}) {
|
|
47
|
+
const cwd = options.cwd ?? process.cwd();
|
|
48
|
+
// 1. Load .env into process.env-style and get env-based config
|
|
49
|
+
const envVars = loadTyphexEnv(cwd);
|
|
50
|
+
const envConfig = envToConfig(envVars);
|
|
51
|
+
// 2. Load config file
|
|
52
|
+
let fileConfig = {};
|
|
53
|
+
if (options.configPath) {
|
|
54
|
+
const resolved = resolve(cwd, options.configPath);
|
|
55
|
+
if (existsSync(resolved)) {
|
|
56
|
+
fileConfig = await loadConfigFile(resolved);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
else {
|
|
60
|
+
const configDir = findConfigDir(cwd);
|
|
61
|
+
if (configDir) {
|
|
62
|
+
for (const name of CONFIG_NAMES) {
|
|
63
|
+
const p = join(configDir, name);
|
|
64
|
+
if (existsSync(p)) {
|
|
65
|
+
fileConfig = await loadConfigFile(p);
|
|
66
|
+
break;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
// 3. Merge: defaults < env < file < overrides
|
|
72
|
+
const merged = {
|
|
73
|
+
...DEFAULT_CONFIG,
|
|
74
|
+
...envConfig,
|
|
75
|
+
...fileConfig,
|
|
76
|
+
...options.overrides,
|
|
77
|
+
};
|
|
78
|
+
if (!merged.dialect)
|
|
79
|
+
merged.dialect = "sqlite";
|
|
80
|
+
if (!merged.migrationsFolder)
|
|
81
|
+
merged.migrationsFolder = "./migrations";
|
|
82
|
+
return merged;
|
|
83
|
+
}
|
|
84
|
+
//# sourceMappingURL=load-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Load .env file from cwd. Minimal implementation to avoid dotenv dependency.
|
|
3
|
+
* Supports TYPHEX_* variables.
|
|
4
|
+
*/
|
|
5
|
+
export declare function loadTyphexEnv(cwd?: string): Record<string, string>;
|
|
6
|
+
export declare function envToConfig(env: Record<string, string>): Partial<import("./types.js").TyphexConfig>;
|
|
7
|
+
//# sourceMappingURL=load-env.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../src/config/load-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAczE;AAUD,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,OAAO,YAAY,EAAE,YAAY,CAAC,CAO5C"}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Load .env file from cwd. Minimal implementation to avoid dotenv dependency.
|
|
3
|
+
* Supports TYPHEX_* variables.
|
|
4
|
+
*/
|
|
5
|
+
import { readFileSync, existsSync } from "node:fs";
|
|
6
|
+
import { join } from "node:path";
|
|
7
|
+
const ENV_PREFIX = "TYPHEX_";
|
|
8
|
+
function parseEnv(content) {
|
|
9
|
+
const out = {};
|
|
10
|
+
for (const line of content.split("\n")) {
|
|
11
|
+
const trimmed = line.trim();
|
|
12
|
+
if (!trimmed || trimmed.startsWith("#"))
|
|
13
|
+
continue;
|
|
14
|
+
const eq = trimmed.indexOf("=");
|
|
15
|
+
if (eq === -1)
|
|
16
|
+
continue;
|
|
17
|
+
const key = trimmed.slice(0, eq).trim();
|
|
18
|
+
const raw = trimmed.slice(eq + 1).trim();
|
|
19
|
+
if (!key.startsWith(ENV_PREFIX))
|
|
20
|
+
continue;
|
|
21
|
+
let value = raw;
|
|
22
|
+
if ((raw.startsWith('"') && raw.endsWith('"')) || (raw.startsWith("'") && raw.endsWith("'"))) {
|
|
23
|
+
value = raw.slice(1, -1).replaceAll(/\\(.)/g, "$1");
|
|
24
|
+
}
|
|
25
|
+
out[key] = value;
|
|
26
|
+
}
|
|
27
|
+
return out;
|
|
28
|
+
}
|
|
29
|
+
export function loadTyphexEnv(cwd = process.cwd()) {
|
|
30
|
+
const paths = [".env", ".env.local"];
|
|
31
|
+
const out = {};
|
|
32
|
+
for (const name of paths) {
|
|
33
|
+
const p = join(cwd, name);
|
|
34
|
+
if (!existsSync(p))
|
|
35
|
+
continue;
|
|
36
|
+
try {
|
|
37
|
+
const content = readFileSync(p, "utf-8");
|
|
38
|
+
Object.assign(out, parseEnv(content));
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
// ignore read errors
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return out;
|
|
45
|
+
}
|
|
46
|
+
const ENV_MAP = {
|
|
47
|
+
TYPHEX_DIALECT: "dialect",
|
|
48
|
+
TYPHEX_DATABASE: "database",
|
|
49
|
+
TYPHEX_URL: "url",
|
|
50
|
+
TYPHEX_MIGRATIONS_FOLDER: "migrationsFolder",
|
|
51
|
+
TYPHEX_ENTITIES: "entities",
|
|
52
|
+
};
|
|
53
|
+
export function envToConfig(env) {
|
|
54
|
+
const config = {};
|
|
55
|
+
for (const [envKey, configKey] of Object.entries(ENV_MAP)) {
|
|
56
|
+
const v = env[envKey] ?? process.env[envKey];
|
|
57
|
+
if (v)
|
|
58
|
+
config[configKey] = v;
|
|
59
|
+
}
|
|
60
|
+
return config;
|
|
61
|
+
}
|
|
62
|
+
//# sourceMappingURL=load-env.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"load-env.js","sourceRoot":"","sources":["../../src/config/load-env.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Typhex configuration schema.
|
|
3
|
+
* Used by Db, CLI, and config file.
|
|
4
|
+
*/
|
|
5
|
+
import type { DialectName } from "../dbs/types.js";
|
|
6
|
+
/** Typhex configuration: dialect, connection details, and paths. */
|
|
7
|
+
export interface TyphexConfig {
|
|
8
|
+
/** Database dialect */
|
|
9
|
+
dialect: DialectName;
|
|
10
|
+
/** SQLite: path to database file (or ":memory:") */
|
|
11
|
+
database?: string;
|
|
12
|
+
/** PostgreSQL: connection URL (future) */
|
|
13
|
+
url?: string;
|
|
14
|
+
/** Migrations directory */
|
|
15
|
+
migrationsFolder?: string;
|
|
16
|
+
/** Path to entities module (for migrate:generate) */
|
|
17
|
+
entities?: string;
|
|
18
|
+
}
|
|
19
|
+
export declare const DEFAULT_CONFIG: Partial<TyphexConfig>;
|
|
20
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,YAAY,CAIhD,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,OAAO,EAAE,QAAQ;IACjB,gBAAgB,EAAE,cAAc;IAChC,QAAQ,EAAE,mBAAmB;CAC9B,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Base migrator: owns dialect-agnostic schema diff and introspection.
|
|
3
|
+
* Each dialect subclasses this and overrides dialect-specific hooks.
|
|
4
|
+
*/
|
|
5
|
+
import type { ColumnChange, DiffAction, DbColumnInfo, DbMigrator, DialectName, QueryCompiler } from "./types.js";
|
|
6
|
+
import type { RegisteredEntity } from "../entity/global-driver.js";
|
|
7
|
+
import type { ResolvedDriver } from "../driver/types.js";
|
|
8
|
+
export declare abstract class BaseMigrator implements DbMigrator {
|
|
9
|
+
readonly dialectName: DialectName;
|
|
10
|
+
protected readonly queryCompiler: QueryCompiler;
|
|
11
|
+
constructor(dialectName: DialectName, queryCompiler: QueryCompiler);
|
|
12
|
+
abstract getDbTables(driver: ResolvedDriver): Promise<string[]>;
|
|
13
|
+
abstract getDbColumns(driver: ResolvedDriver, table: string): Promise<DbColumnInfo[]>;
|
|
14
|
+
diffSchema(driver: ResolvedDriver, entities: readonly RegisteredEntity[]): Promise<DiffAction[]>;
|
|
15
|
+
private diffColumns;
|
|
16
|
+
protected static normalizeDefault(value: string | null): string | null;
|
|
17
|
+
protected static extractDefault(def: string): string | null;
|
|
18
|
+
protected static computeColumnChanges(dbCol: DbColumnInfo, entityDef: string): ColumnChange[];
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=base-migrator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"base-migrator.d.ts","sourceRoot":"","sources":["../../src/dbs/base-migrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,8BAAsB,YAAa,YAAW,UAAU;IAEpD,QAAQ,CAAC,WAAW,EAAE,WAAW;IACjC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa;gBADtC,WAAW,EAAE,WAAW,EACd,aAAa,EAAE,aAAa;IAGjD,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/D,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAE/E,UAAU,CACd,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC;YAuBV,WAAW;IAuCzB,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;IActE,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM3D,SAAS,CAAC,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;CAiC9F"}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Base migrator: owns dialect-agnostic schema diff and introspection.
|
|
3
|
+
* Each dialect subclasses this and overrides dialect-specific hooks.
|
|
4
|
+
*/
|
|
5
|
+
import { getColumnDef } from "./types.js";
|
|
6
|
+
import { extractBaseType } from "../utils.js";
|
|
7
|
+
export class BaseMigrator {
|
|
8
|
+
dialectName;
|
|
9
|
+
queryCompiler;
|
|
10
|
+
constructor(dialectName, queryCompiler) {
|
|
11
|
+
this.dialectName = dialectName;
|
|
12
|
+
this.queryCompiler = queryCompiler;
|
|
13
|
+
}
|
|
14
|
+
async diffSchema(driver, entities) {
|
|
15
|
+
const actions = [];
|
|
16
|
+
const dbTables = new Set(await this.getDbTables(driver));
|
|
17
|
+
const entityTables = new Map(entities.map((e) => [e.table._table, e.table._schema]));
|
|
18
|
+
for (const [table, schema] of entityTables) {
|
|
19
|
+
if (!dbTables.has(table)) {
|
|
20
|
+
actions.push({ kind: "add_table", table, schema });
|
|
21
|
+
continue;
|
|
22
|
+
}
|
|
23
|
+
actions.push(...(await this.diffColumns(driver, table, schema)));
|
|
24
|
+
}
|
|
25
|
+
for (const dbTable of dbTables) {
|
|
26
|
+
if (!entityTables.has(dbTable)) {
|
|
27
|
+
const columnInfos = await this.getDbColumns(driver, dbTable);
|
|
28
|
+
actions.push({ kind: "drop_table", table: dbTable, columnInfos });
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
return actions;
|
|
32
|
+
}
|
|
33
|
+
async diffColumns(driver, table, schema) {
|
|
34
|
+
const actions = [];
|
|
35
|
+
const dbCols = await this.getDbColumns(driver, table);
|
|
36
|
+
const dbColMap = new Map(dbCols.map((c) => [c.name, c]));
|
|
37
|
+
const entityCols = new Set(Object.keys(schema));
|
|
38
|
+
for (const [col, def] of Object.entries(schema)) {
|
|
39
|
+
const dbCol = dbColMap.get(col);
|
|
40
|
+
if (!dbCol) {
|
|
41
|
+
actions.push({ kind: "add_column", table, column: col, definition: def });
|
|
42
|
+
continue;
|
|
43
|
+
}
|
|
44
|
+
const changes = BaseMigrator.computeColumnChanges(dbCol, getColumnDef(def, this.dialectName));
|
|
45
|
+
if (changes.length > 0) {
|
|
46
|
+
actions.push({
|
|
47
|
+
kind: "alter_column",
|
|
48
|
+
table,
|
|
49
|
+
column: col,
|
|
50
|
+
oldDef: dbCol.type,
|
|
51
|
+
newDef: def,
|
|
52
|
+
columnInfo: dbCol,
|
|
53
|
+
changes,
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
for (const dbCol of dbCols) {
|
|
58
|
+
if (!entityCols.has(dbCol.name)) {
|
|
59
|
+
actions.push({ kind: "drop_column", table, column: dbCol.name, columnInfo: dbCol });
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
return actions;
|
|
63
|
+
}
|
|
64
|
+
static normalizeDefault(value) {
|
|
65
|
+
if (value == null)
|
|
66
|
+
return null;
|
|
67
|
+
let normalized = value
|
|
68
|
+
.trim()
|
|
69
|
+
.replace(/^\((.*)\)$/, "$1")
|
|
70
|
+
.trim();
|
|
71
|
+
// Strip Postgres type casts (e.g. `'Anon'::text`, `0::integer`, `'x'::"my_enum"`).
|
|
72
|
+
normalized = normalized.replace(/::\s*(?:"[^"]+"|[A-Za-z_][\w ]*)\s*$/, "").trim();
|
|
73
|
+
// Postgres serial/identity columns surface as `nextval('seq'::regclass)`; treat
|
|
74
|
+
// as an implicit default so they don't drift against entity defs that omit it.
|
|
75
|
+
if (/^nextval\s*\(/i.test(normalized))
|
|
76
|
+
return null;
|
|
77
|
+
return normalized;
|
|
78
|
+
}
|
|
79
|
+
static extractDefault(def) {
|
|
80
|
+
const match = /\bdefault\s+(.+?)(?:\s+not\s+null|\s+primary\s+key|\s+unique|\s+references\b|$)/i.exec(def);
|
|
81
|
+
return BaseMigrator.normalizeDefault(match?.[1] ?? null);
|
|
82
|
+
}
|
|
83
|
+
static computeColumnChanges(dbCol, entityDef) {
|
|
84
|
+
const changes = [];
|
|
85
|
+
const dbBaseType = extractBaseType(dbCol.type);
|
|
86
|
+
const entityBaseType = extractBaseType(entityDef);
|
|
87
|
+
if (dbBaseType !== entityBaseType) {
|
|
88
|
+
changes.push({ kind: "type", from: dbBaseType, to: entityBaseType });
|
|
89
|
+
}
|
|
90
|
+
const dbPk = dbCol.pk > 0;
|
|
91
|
+
const entityPk = /\bprimary\s+key\b/i.test(entityDef);
|
|
92
|
+
const dbNotNull = dbCol.notnull === 1 || dbPk;
|
|
93
|
+
const entityNotNull = /\bnot\s+null\b/i.test(entityDef) || entityPk;
|
|
94
|
+
if (dbNotNull !== entityNotNull) {
|
|
95
|
+
changes.push({
|
|
96
|
+
kind: entityNotNull ? "not_null" : "nullable",
|
|
97
|
+
from: dbNotNull,
|
|
98
|
+
to: entityNotNull,
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
const dbDefault = BaseMigrator.normalizeDefault(dbCol.dflt_value);
|
|
102
|
+
const entityDefault = BaseMigrator.extractDefault(entityDef);
|
|
103
|
+
if (dbDefault !== entityDefault) {
|
|
104
|
+
changes.push({ kind: "default", from: dbDefault, to: entityDefault });
|
|
105
|
+
}
|
|
106
|
+
if (dbPk !== entityPk) {
|
|
107
|
+
changes.push({ kind: "primary_key", from: dbPk, to: entityPk });
|
|
108
|
+
}
|
|
109
|
+
return changes;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
//# sourceMappingURL=base-migrator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"base-migrator.js","sourceRoot":"","sources":["../../src/dbs/base-migrator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export * from "./types.js";
|
|
2
|
+
export { createSqliteDriver, sqliteDialect, sqliteMigrator, sqliteQueryCompiler, } from "./sqlite/index.js";
|
|
3
|
+
export type { SqliteDriverOptions } from "./sqlite/index.js";
|
|
4
|
+
export { createPostgresDriver, postgresDialect, postgresMigrator, postgresQueryCompiler, } from "./postgres/index.js";
|
|
5
|
+
export type { PostgresDriverOptions } from "./postgres/index.js";
|
|
6
|
+
import type { Dialect, DialectName } from "./types.js";
|
|
7
|
+
/** Get dialect implementation by name. */
|
|
8
|
+
export declare function getDialect(name: DialectName): Dialect;
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dbs/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASvD,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAIrD"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export * from "./types.js";
|
|
2
|
+
export { createSqliteDriver, sqliteDialect, sqliteMigrator, sqliteQueryCompiler, } from "./sqlite/index.js";
|
|
3
|
+
export { createPostgresDriver, postgresDialect, postgresMigrator, postgresQueryCompiler, } from "./postgres/index.js";
|
|
4
|
+
import { sqliteDialect } from "./sqlite/dialect.js";
|
|
5
|
+
import { postgresDialect } from "./postgres/dialect.js";
|
|
6
|
+
const dialectMap = {
|
|
7
|
+
sqlite: sqliteDialect,
|
|
8
|
+
postgres: postgresDialect,
|
|
9
|
+
};
|
|
10
|
+
/** Get dialect implementation by name. */
|
|
11
|
+
export function getDialect(name) {
|
|
12
|
+
const d = dialectMap[name];
|
|
13
|
+
if (!d)
|
|
14
|
+
throw new Error(`Unknown dialect: ${name}`);
|
|
15
|
+
return d;
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dbs/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,GAAiC;IAC/C,MAAM,EAAE,aAAa;IACrB,QAAQ,EAAE,eAAe;CAC1B,CAAC;AAEF,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../../src/dbs/postgres/dialect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,eAAO,MAAM,eAAe,EAAE,OAQ7B,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PostgreSQL dialect identity and capabilities.
|
|
3
|
+
*
|
|
4
|
+
* SQL generation lives in `PostgresQueryCompiler`.
|
|
5
|
+
*/
|
|
6
|
+
import { postgresMigrator } from "./migrator.js";
|
|
7
|
+
import { postgresQueryCompiler } from "./query-compiler.js";
|
|
8
|
+
export const postgresDialect = {
|
|
9
|
+
name: "postgres",
|
|
10
|
+
insertCapabilities: {
|
|
11
|
+
supportsReturning: true,
|
|
12
|
+
supportsSequences: false,
|
|
13
|
+
},
|
|
14
|
+
queryCompiler: postgresQueryCompiler,
|
|
15
|
+
migrator: postgresMigrator,
|
|
16
|
+
};
|
|
17
|
+
//# sourceMappingURL=dialect.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../../../src/dbs/postgres/dialect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,UAAU;IAChB,kBAAkB,EAAE;QAClB,iBAAiB,EAAE,IAAI;QACvB,iBAAiB,EAAE,KAAK;KACzB;IACD,aAAa,EAAE,qBAAqB;IACpC,QAAQ,EAAE,gBAAgB;CAC3B,CAAC"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PostgreSQL driver using pg.Pool.
|
|
3
|
+
* Thin adapter: execute(), connect(), close() only — no transaction logic.
|
|
4
|
+
*/
|
|
5
|
+
import pg from "pg";
|
|
6
|
+
import type { Driver } from "../../driver/types.js";
|
|
7
|
+
/** Options for `createPostgresDriver`: `connectionString` (or alias `url`) and optional pool sizing. */
|
|
8
|
+
export interface PostgresDriverOptions {
|
|
9
|
+
/** Full PostgreSQL connection string (e.g. `postgres://user:pass@host/db`). */
|
|
10
|
+
connectionString?: string;
|
|
11
|
+
/** Alias for `connectionString`. Useful when reading from a config file. */
|
|
12
|
+
url?: string;
|
|
13
|
+
/** PostgreSQL server hostname (used when `connectionString` is not provided). */
|
|
14
|
+
host?: string;
|
|
15
|
+
/** PostgreSQL server port (default: `5432`). */
|
|
16
|
+
port?: number;
|
|
17
|
+
/** Database name (default: `'postgres'`). */
|
|
18
|
+
database?: string;
|
|
19
|
+
/** Database user. */
|
|
20
|
+
user?: string;
|
|
21
|
+
/** Database password. */
|
|
22
|
+
password?: string;
|
|
23
|
+
/** SSL configuration forwarded to `pg`. */
|
|
24
|
+
ssl?: pg.ConnectionConfig["ssl"];
|
|
25
|
+
/** Minimum pool connections to keep open (default: `2`). */
|
|
26
|
+
poolMin?: number;
|
|
27
|
+
/** Maximum pool size (default: `10`). */
|
|
28
|
+
poolMax?: number;
|
|
29
|
+
/** Milliseconds before an idle connection is released (default: `30000`). */
|
|
30
|
+
idleTimeoutMs?: number;
|
|
31
|
+
/** Milliseconds to wait for a connection from the pool (default: `5000`). */
|
|
32
|
+
connectionTimeoutMs?: number;
|
|
33
|
+
/** PostgreSQL `statement_timeout` in milliseconds (not set by default). */
|
|
34
|
+
statementTimeoutMs?: number;
|
|
35
|
+
/** Custom error logger for pool errors (defaults to `console.error`). */
|
|
36
|
+
logger?: {
|
|
37
|
+
error: (msg: string, err: Error) => void;
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
/** Creates a PostgreSQL driver backed by `pg`. */
|
|
41
|
+
export declare function createPostgresDriver(options: PostgresDriverOptions): Driver;
|
|
42
|
+
//# sourceMappingURL=driver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/dbs/postgres/driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,EACV,MAAM,EAKP,MAAM,uBAAuB,CAAC;AAuB/B,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;KAAE,CAAC;CACvD;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAkG3E"}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PostgreSQL driver using pg.Pool.
|
|
3
|
+
* Thin adapter: execute(), connect(), close() only — no transaction logic.
|
|
4
|
+
*/
|
|
5
|
+
import pg from "pg";
|
|
6
|
+
import { PostgresTrx } from "./trx.js";
|
|
7
|
+
import { postgresDialect } from "./dialect.js";
|
|
8
|
+
import { isRecord } from "../../utils.js";
|
|
9
|
+
const { Pool } = pg;
|
|
10
|
+
function toBindable(value) {
|
|
11
|
+
if (value === undefined || value === null)
|
|
12
|
+
return null;
|
|
13
|
+
if (value instanceof Date)
|
|
14
|
+
return value.toISOString();
|
|
15
|
+
if (typeof value === "boolean")
|
|
16
|
+
return value;
|
|
17
|
+
if (typeof value === "number" ||
|
|
18
|
+
typeof value === "string" ||
|
|
19
|
+
typeof value === "bigint" ||
|
|
20
|
+
Buffer.isBuffer(value))
|
|
21
|
+
return value;
|
|
22
|
+
if (isRecord(value))
|
|
23
|
+
return JSON.stringify(value);
|
|
24
|
+
return value;
|
|
25
|
+
}
|
|
26
|
+
/** Creates a PostgreSQL driver backed by `pg`. */
|
|
27
|
+
export function createPostgresDriver(options) {
|
|
28
|
+
const connectionString = options.connectionString ?? options.url;
|
|
29
|
+
const baseConfig = connectionString
|
|
30
|
+
? { connectionString }
|
|
31
|
+
: {
|
|
32
|
+
host: options.host ?? "localhost",
|
|
33
|
+
port: options.port ?? 5432,
|
|
34
|
+
database: options.database ?? "postgres",
|
|
35
|
+
user: options.user,
|
|
36
|
+
password: options.password,
|
|
37
|
+
};
|
|
38
|
+
const pool = new Pool({
|
|
39
|
+
...baseConfig,
|
|
40
|
+
min: options.poolMin ?? 2,
|
|
41
|
+
max: options.poolMax ?? 10,
|
|
42
|
+
idleTimeoutMillis: options.idleTimeoutMs ?? 30_000,
|
|
43
|
+
connectionTimeoutMillis: options.connectionTimeoutMs ?? 5_000,
|
|
44
|
+
ssl: options.ssl,
|
|
45
|
+
});
|
|
46
|
+
const log = options.logger ?? { error: (msg, err) => console.error(msg, err) };
|
|
47
|
+
const { statementTimeoutMs } = options;
|
|
48
|
+
pool.on("error", (err) => {
|
|
49
|
+
log.error("Unexpected error on idle PostgreSQL client", err);
|
|
50
|
+
});
|
|
51
|
+
function wrapError(e, sql) {
|
|
52
|
+
const err = e;
|
|
53
|
+
const parts = [
|
|
54
|
+
`PG(${err.code ?? "?"})`,
|
|
55
|
+
err.message,
|
|
56
|
+
err.detail,
|
|
57
|
+
`SQL: ${sql.slice(0, 200)}`,
|
|
58
|
+
].filter(Boolean);
|
|
59
|
+
throw new Error(parts.join(" — "), { cause: e });
|
|
60
|
+
}
|
|
61
|
+
function toExecuteResult(result, sql) {
|
|
62
|
+
const rowCount = result.rowCount ?? 0;
|
|
63
|
+
const firstRow = result.rows[0];
|
|
64
|
+
const lastID = firstRow
|
|
65
|
+
? (firstRow["id"] ?? firstRow["lastval"] ?? Object.values(firstRow)[0])
|
|
66
|
+
: undefined;
|
|
67
|
+
return {
|
|
68
|
+
rows: result.rows,
|
|
69
|
+
lastID: typeof lastID === "number" ? lastID : undefined,
|
|
70
|
+
changes: rowCount,
|
|
71
|
+
};
|
|
72
|
+
void sql; // used in wrapError only
|
|
73
|
+
}
|
|
74
|
+
async function runQuery(queryable, sql, params = []) {
|
|
75
|
+
const bound = params.map(toBindable);
|
|
76
|
+
try {
|
|
77
|
+
const result = await queryable.query(sql, bound);
|
|
78
|
+
return toExecuteResult(result, sql);
|
|
79
|
+
}
|
|
80
|
+
catch (e) {
|
|
81
|
+
wrapError(e, sql);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
function makeConnection(client) {
|
|
85
|
+
return {
|
|
86
|
+
dialect: postgresDialect,
|
|
87
|
+
execute: (sql, params) => runQuery(client, sql, params),
|
|
88
|
+
async release() {
|
|
89
|
+
client.release();
|
|
90
|
+
},
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
return {
|
|
94
|
+
dialect: postgresDialect,
|
|
95
|
+
execute: (sql, params) => runQuery(pool, sql, params),
|
|
96
|
+
async connect() {
|
|
97
|
+
const client = await pool.connect();
|
|
98
|
+
if (statementTimeoutMs) {
|
|
99
|
+
await client.query(`SET statement_timeout = ${statementTimeoutMs}`);
|
|
100
|
+
}
|
|
101
|
+
return makeConnection(client);
|
|
102
|
+
},
|
|
103
|
+
createTrx(conn, options) {
|
|
104
|
+
return new PostgresTrx(conn, options);
|
|
105
|
+
},
|
|
106
|
+
async close() {
|
|
107
|
+
await pool.end();
|
|
108
|
+
},
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=driver.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/dbs/postgres/driver.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { createPostgresDriver } from "./driver.js";
|
|
2
|
+
export type { PostgresDriverOptions } from "./driver.js";
|
|
3
|
+
export { postgresDialect } from "./dialect.js";
|
|
4
|
+
export { postgresMigrator } from "./migrator.js";
|
|
5
|
+
export { postgresQueryCompiler } from "./query-compiler.js";
|
|
6
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dbs/postgres/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dbs/postgres/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}
|