How ahmatfauzy/pawql-orm works
PawQL is a runtime-schema TypeScript ORM and SQL query builder. An application supplies a schema and database connection, creates a database instance, builds typed queries, and executes them through a dialect adapter against a database. Distinct runtime capabilities include query construction, adapter execution, schema-based table creation, migrations, introspection, validation, seeding, relations, hooks, and telemetry. The main database/query-builder and adapter execution paths are supported by sampled source; several additional capabilities are documented or exported, but their internal call wiring was not sampled.
Main entry points: database.ts Database · adapter.ts Adapter Contract · builder.ts Query Builder · schema.ts Runtime Schema
Components 20
Schema and API
- Runtime Schema
src/types/schema.ts - Public API
src/index.ts - Database
src/core/database.ts
Query Runtime
- Query Builder
src/query/builder.ts - Relations
src/core/relations.ts - Hooks
src/core/hooks.ts - Row Validation
src/core/validator.ts
Database Adapters
- Adapter Contract
src/core/adapter.ts - PostgreSQL Adapter
src/adapters/pg.ts - MySQL Adapter
src/adapters/mysql.ts - SQLite Adapter
src/adapters/sqlite.ts
Database Operations
- Table Creation
src/core/database.ts - Migrations
src/migration - Introspection
src/core/introspect.ts - Seeders
src/core/seeder.ts - Telemetry Plugin
src/plugins/telemetry.ts - Logger
src/core/logger.ts
Other components
- Application
- Database Service
- Query Results
Connections 27
- Application → Public API: imports
- Application → Runtime Schema: defines
- Application → Database: creates
- Public API → Database: exports
- Runtime Schema → Database: configures
- Database → Query Builder: creates
- Database → Adapter Contract: uses
- Database → Table Creation: creates tables
- Database → Relations: configures
- Database → Hooks: configures
- Database → Logger: wraps adapter
- Query Builder → Adapter Contract: executes SQL
- Query Builder → Relations: resolves joins
- Query Builder → Hooks: runs hooks
- Adapter Contract → PostgreSQL Adapter: implemented by
- Adapter Contract → MySQL Adapter: implemented by
- Adapter Contract → SQLite Adapter: implemented by
- PostgreSQL Adapter → Database Service: queries
- MySQL Adapter → Database Service: queries
- SQLite Adapter → Database Service: queries
- Database Service → Query Results: returns rows
- Application → Row Validation: validates data
- Application → Migrations: runs migrations
- Application → Introspection: requests schema
- Introspection → Adapter Contract: queries metadata
- Application → Seeders: seeds data
- Application → Telemetry Plugin: installs plugin