qubu 0.5.0 → 0.5.1
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.
|
@@ -111,6 +111,40 @@ const adapter: QueryAdapter = {
|
|
|
111
111
|
}
|
|
112
112
|
```
|
|
113
113
|
|
|
114
|
+
### Experimental cloud adapters
|
|
115
|
+
|
|
116
|
+
The workspace also publishes experimental adapters for HTTP and serverless
|
|
117
|
+
database clients. They are not production-ready and are intentionally outside
|
|
118
|
+
provider-backed CI until funded infrastructure and an external maintainer are
|
|
119
|
+
available.
|
|
120
|
+
|
|
121
|
+
| Package | Driver boundary | Advertised capabilities |
|
|
122
|
+
| ----------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------- |
|
|
123
|
+
| `@qubu/adapter-neon` | Neon HTTP PostgreSQL query function | PostgreSQL rendering, object rows, mutation counts, EXPLAIN, and fetch cancellation |
|
|
124
|
+
| `@qubu/adapter-planetscale` | PlanetScale serverless MySQL client | MySQL rendering, rows, mutation metadata, EXPLAIN, and provider transaction callbacks |
|
|
125
|
+
| `@qubu/adapter-aws-rds-data-api/postgres` | AWS RDS Data API for Aurora PostgreSQL | PostgreSQL rendering, typed Data API values/results, EXPLAIN, mutation metadata, and transaction IDs |
|
|
126
|
+
| `@qubu/adapter-aws-rds-data-api/mysql` | AWS RDS Data API for Aurora MySQL | MySQL rendering, typed Data API values/results, EXPLAIN, mutation metadata, and transaction IDs |
|
|
127
|
+
|
|
128
|
+
Neon HTTP and the RDS Data API do not advertise interactive streaming. The
|
|
129
|
+
RDS adapter uses named placeholders (`:p1`, `:p2`, ...), while PlanetScale uses
|
|
130
|
+
the MySQL dialect and the provider's own value formatting. Read each package's
|
|
131
|
+
README for its experimental boundary and required provider setup.
|
|
132
|
+
|
|
133
|
+
### Official SQLite WASM adapter
|
|
134
|
+
|
|
135
|
+
`@qubu/adapter-sqlite-wasm` adapts the official SQLite WASM OO1
|
|
136
|
+
`sqlite3.oo1.DB` API for browser and web-worker use. It prepares one statement
|
|
137
|
+
per request, binds Qubu's ordered parameters, copies object rows, and finalizes
|
|
138
|
+
the statement in a `finally` block. SQLite's change count and generated row ID
|
|
139
|
+
are returned as mutation metadata when the request is a mutation.
|
|
140
|
+
|
|
141
|
+
The package does not create or terminate workers. Initialize the official
|
|
142
|
+
SQLite module inside a dedicated worker, construct the adapter around its
|
|
143
|
+
`sqlite3.oo1.DB`, and close the adapter before terminating that worker. The
|
|
144
|
+
browser build must serve the package's `sqlite3.wasm` asset beside the bundled
|
|
145
|
+
worker module; the combo runner's verified browser scenario demonstrates this
|
|
146
|
+
lifecycle.
|
|
147
|
+
|
|
114
148
|
### Decode schema-aware result values
|
|
115
149
|
|
|
116
150
|
Portable boolean, date, timestamp, and JSON columns retain their logical
|
|
@@ -4,38 +4,43 @@
|
|
|
4
4
|
|
|
5
5
|
## Package entrypoints
|
|
6
6
|
|
|
7
|
-
| Import
|
|
8
|
-
|
|
|
9
|
-
| `qubu`
|
|
10
|
-
| `qubu/core`
|
|
11
|
-
| `qubu/codegen`
|
|
12
|
-
| `qubu/diff`
|
|
13
|
-
| `qubu/introspection`
|
|
14
|
-
| `qubu/mysql`
|
|
15
|
-
| `qubu/postgres`
|
|
16
|
-
| `qubu/schema`
|
|
17
|
-
| `qubu/snapshot`
|
|
18
|
-
| `qubu/sqlite`
|
|
19
|
-
| `qubu/vite`
|
|
20
|
-
| `qubu/package.json`
|
|
21
|
-
| `@qubu/migrate`
|
|
22
|
-
| `@qubu/migrate/plan`
|
|
23
|
-
| `@qubu/migrate/ddl`
|
|
24
|
-
| `@qubu/migrate/artifact`
|
|
25
|
-
| `@qubu/migrate/repository`
|
|
26
|
-
| `@qubu/migrate/journal`
|
|
27
|
-
| `@qubu/migrate/executor`
|
|
28
|
-
| `@qubu/migrate/baseline`
|
|
29
|
-
| `@qubu/migrate/status`
|
|
30
|
-
| `@qubu/migrate/bootstrap`
|
|
31
|
-
| `@qubu/migrate/testing`
|
|
32
|
-
| `@qubu/cli`
|
|
33
|
-
| `@qubu/drizzle`
|
|
34
|
-
| `@qubu/drizzle/mysql`
|
|
35
|
-
| `@qubu/drizzle/postgres`
|
|
36
|
-
| `@qubu/drizzle/sqlite`
|
|
37
|
-
| `@qubu/better-auth`
|
|
38
|
-
|
|
|
7
|
+
| Import | Kind | Use it for |
|
|
8
|
+
| ----------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------- |
|
|
9
|
+
| `qubu` | Runtime | Ordinary query and schema definitions, reads, writes, SQL templates, rendering, EXPLAIN, and execution contracts |
|
|
10
|
+
| `qubu/core` | Runtime | Fragment and rendering primitives, dialect construction, SQL types, and extension constructors |
|
|
11
|
+
| `qubu/codegen` | Runtime | Deterministic machine-owned TypeScript schemas from complete, non-lossy introspection |
|
|
12
|
+
| `qubu/diff` | Runtime | Canonical Snapshot v1 or v2 comparison, rename hints, suggestions, and safety diagnostics |
|
|
13
|
+
| `qubu/introspection` | Runtime | Catalog readers, normalized catalogs, and mapping to Snapshot v1 or v2 |
|
|
14
|
+
| `qubu/mysql` | Runtime | The MySQL query dialect policy |
|
|
15
|
+
| `qubu/postgres` | Runtime | PostgreSQL query dialect helpers such as `postgresDialect()` and `ilike()` |
|
|
16
|
+
| `qubu/schema` | Runtime | Advanced schema metadata, storage and constraint models, source models, and schema-expression extensions |
|
|
17
|
+
| `qubu/snapshot` | Runtime | Canonical Snapshot v1 and v2 traversal, encoding, decoding, diagnostics, and fingerprints |
|
|
18
|
+
| `qubu/sqlite` | Runtime | The SQLite query dialect policy and native SQLite column factories |
|
|
19
|
+
| `qubu/vite` | Runtime | The optional `qubu()` Vite compiler hint |
|
|
20
|
+
| `qubu/package.json` | JSON | The published package manifest |
|
|
21
|
+
| `@qubu/migrate` | Runtime | Migration compiler format identity and shared plan types |
|
|
22
|
+
| `@qubu/migrate/plan` | Runtime | Pure migration planning with dependencies, decisions, preconditions, and explicit custom SQL |
|
|
23
|
+
| `@qubu/migrate/ddl` | Runtime | DDL preflight and deterministic PostgreSQL, SQLite, or MySQL emission from a migration plan |
|
|
24
|
+
| `@qubu/migrate/artifact` | Runtime | Versioned programs, strict artifacts and baselines, canonical encoding, and SHA-256 integrity |
|
|
25
|
+
| `@qubu/migrate/repository` | Runtime | Strict full-chain and journal-prefix verification |
|
|
26
|
+
| `@qubu/migrate/journal` | Runtime | Storage-neutral journal records, transitions, validation, and reference storage |
|
|
27
|
+
| `@qubu/migrate/executor` | Runtime | Portable execution, structured errors, checkpointing, and explicit reconciliation |
|
|
28
|
+
| `@qubu/migrate/baseline` | Runtime | Strict live baseline verification and physical managed-schema comparison |
|
|
29
|
+
| `@qubu/migrate/status` | Runtime | Pending chain, managed drift, unmanaged objects, interrupted attempts, and incompatible requirements |
|
|
30
|
+
| `@qubu/migrate/bootstrap` | Runtime | Fresh SQLite schema planning through the normal diff, plan, and program compiler |
|
|
31
|
+
| `@qubu/migrate/testing` | Runtime | Deterministic fake adapters, fault boundaries, and adapter conformance checks |
|
|
32
|
+
| `@qubu/cli` | Runtime and CLI | `@alloc/cmd-ts` commands, typed config, filesystem repositories, stable output, and exit codes |
|
|
33
|
+
| `@qubu/drizzle` | Runtime | Shared Drizzle conversion errors and dialect types |
|
|
34
|
+
| `@qubu/drizzle/mysql` | Runtime | Runtime conversion from Qubu schemas to MySQL Drizzle tables |
|
|
35
|
+
| `@qubu/drizzle/postgres` | Runtime | Runtime conversion from Qubu schemas to PostgreSQL Drizzle tables |
|
|
36
|
+
| `@qubu/drizzle/sqlite` | Runtime | Runtime conversion from Qubu schemas to SQLite Drizzle tables |
|
|
37
|
+
| `@qubu/better-auth` | Runtime | Better Auth schema derivation and native PostgreSQL, MySQL, and SQLite adapter behavior |
|
|
38
|
+
| `@qubu/adapter-neon` | Runtime | Experimental Neon HTTP PostgreSQL `QueryAdapter` behavior |
|
|
39
|
+
| `@qubu/adapter-planetscale` | Runtime | Experimental PlanetScale serverless MySQL `QueryAdapter` and transaction behavior |
|
|
40
|
+
| `@qubu/adapter-aws-rds-data-api/postgres` | Runtime | Experimental Aurora PostgreSQL AWS RDS Data API adapter behavior |
|
|
41
|
+
| `@qubu/adapter-aws-rds-data-api/mysql` | Runtime | Experimental Aurora MySQL AWS RDS Data API adapter behavior |
|
|
42
|
+
| `@qubu/adapter-sqlite-wasm` | Runtime | Official SQLite WASM OO1 `QueryAdapter` for browser and web-worker databases |
|
|
43
|
+
| `qubu/globals` | TypeScript types | Opt-in ambient declarations for directive-bearing modules |
|
|
39
44
|
|
|
40
45
|
The package validator checks every declared entrypoint in each packed workspace
|
|
41
46
|
package. Concrete dialect constructors live on their database subpaths. The
|