@lunora/hyperdrive 1.0.0-alpha.1 → 1.0.0-alpha.100

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/dist/global.d.mts CHANGED
@@ -1,47 +1,141 @@
1
- import { DatabaseWriterLike } from '@lunora/do';
1
+ import { DatabaseWriterLike } from '@lunora/shard-engine';
2
2
  import { SqlExec, SqlDialect, SqlCtxDbOptions } from '@lunora/sql-store';
3
- /** Minimal row-returning client (e.g. `@lunora/hyperdrive`'s `fromPostgresJs`/`fromNodePg` result). */
4
- interface RowClient {
5
- query: <Row = Record<string, unknown>>(text: string, params?: ReadonlyArray<unknown>) => Promise<Row[]>;
6
- }
7
- /** Minimal `mysql2/promise` connection/pool surface`execute` resolves to `[rows | ResultSetHeader, fields]`. */
8
- interface Mysql2Execute {
9
- execute: (text: string, params?: ReadonlyArray<unknown>) => Promise<[unknown, unknown]>;
10
- }
3
+ import { M as Mysql2Like, S as SqlClient } from "./packem_shared/types.d-DE1NYxyA.mjs";
4
+ import { VectorMetric, VectorizeIndexLike } from '@lunora/platform';
5
+ /**
6
+ * Minimal row-returning client (e.g. `@lunora/hyperdrive`'s `fromPostgresJs`/`fromNodePg`
7
+ * result). Aliases {@link SqlClient} the exec-facing name is kept so call sites read
8
+ * intent, but the shape is the single source of truth in `./types` (no drift).
9
+ */
10
+ type RowClient = SqlClient;
11
11
  /**
12
- * Wrap a Postgres row-client (from `@lunora/hyperdrive`'s `fromPostgresJs` /
13
- * `fromNodePg`) as a {@link SqlExec}. The core already renders `$N` placeholders
14
- * for Postgres, so `all`/`run` forward verbatim. Postgres uses `RETURNING` for
15
- * OCC (read via `all`), so `run` reports no affected-row count.
16
- */
12
+ * Minimal `mysql2/promise` connection/pool surface `execute` resolves to
13
+ * `[rows | ResultSetHeader, fields]`. Aliases {@link Mysql2Like} so the /global
14
+ * entry's driver surface can never drift from the main entry's, widened with the
15
+ * (optional, structural) shape {@link assertFoundRows}'s `CLIENT_FOUND_ROWS`
16
+ * probe reads.
17
+ *
18
+ * A real `mysql2/promise` connection/pool exposes the merged client-flags
19
+ * bitmask synchronously, but at two different depths depending on which one it
20
+ * is, and NEITHER is in `mysql2`'s own `.d.ts` — its `Pool extends Connection`
21
+ * signature claims a top-level `config`, but at runtime a `mysql2/promise`
22
+ * `Pool` has none; the real value lives one level down, on the core pool it
23
+ * wraps:
24
+ *
25
+ * - a single `Connection`/`PoolConnection` → `connection.config.clientFlags`
26
+ * - a `Pool` (the `createPool({ flags: ["FOUND_ROWS"] })` example above) →
27
+ * `pool.pool.config.connectionConfig.clientFlags`
28
+ *
29
+ * Because those paths are undocumented driver internals, `global-dialect.test.ts`
30
+ * pins them against a REAL `mysql2` pool (built without connecting) rather than
31
+ * only against hand-written doubles — if a `mysql2` release relocates them, the
32
+ * probe would otherwise degrade silently to the warn branch and the OCC guard
33
+ * would go unchecked.
34
+ *
35
+ * Both fields are optional so a minimal `Mysql2Like` test double (only
36
+ * `execute`) safely resolves to "undeterminable" instead of a `TypeError`.
37
+ */
38
+ type Mysql2Execute = Mysql2Like & {
39
+ config?: {
40
+ clientFlags?: number;
41
+ };
42
+ pool?: {
43
+ config?: {
44
+ connectionConfig?: {
45
+ clientFlags?: number;
46
+ };
47
+ };
48
+ };
49
+ };
50
+ /**
51
+ * Wrap a Postgres row-client (from `@lunora/hyperdrive`'s `fromPostgresJs` /
52
+ * `fromNodePg`) as a {@link SqlExec}. The core already renders `$N` placeholders
53
+ * for Postgres, so `all`/`run` forward verbatim. Postgres uses `RETURNING` for
54
+ * OCC (read via `all`), so `run` reports no affected-row count.
55
+ *
56
+ * `batch` dispatches every statement concurrently (`Promise.all`) over `client`
57
+ * rather than awaiting each `query` call in turn — `RowClient` only exposes a
58
+ * single-statement `query`, so there is no wire-level multi-statement command
59
+ * to reach for. When `client` is backed by a pool (the common production
60
+ * shape), this genuinely spreads the statements across multiple physical
61
+ * connections instead of serializing one full round trip at a time; against a
62
+ * single connection it still removes the sequential *await*, though the
63
+ * underlying driver may itself queue the sends. Either way it stays
64
+ * non-atomic, at-least-once, and unordered between elements, same as the
65
+ * sequential fallback minus the ordering — safe only for statements whose
66
+ * effects don't depend on each other, which is what every current caller
67
+ * batches (distinct-keyed companion rows).
68
+ */
17
69
  declare const buildPgExec: (client: RowClient) => SqlExec;
18
70
  /**
19
- * Wrap a `mysql2/promise` connection/pool as a {@link SqlExec}. The core already
20
- * renders backtick identifiers and `?` placeholders for MySQL, so `all`/`run`
21
- * forward verbatim. MySQL has no `RETURNING`, so `run` surfaces `affectedRows`
22
- * for the store's affected-rows OCC guard.
23
- *
24
- * **The connection MUST be created with the `CLIENT_FOUND_ROWS` flag**
25
- * (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`). Without it, `affectedRows`
26
- * counts *changed* rows, so an idempotent `patch`/`replace` that re-writes the
27
- * same values reports 0 and the OCC guard raises a spurious conflict.
28
- */
71
+ * Wrap a `mysql2/promise` connection/pool as a {@link SqlExec}. The core already
72
+ * renders backtick identifiers and `?` placeholders for MySQL, so `all`/`run`
73
+ * forward verbatim. MySQL has no `RETURNING`, so `run` surfaces `affectedRows`
74
+ * for the store's affected-rows OCC guard.
75
+ *
76
+ * **The connection MUST be created with the `CLIENT_FOUND_ROWS` flag**
77
+ * (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`). Without it, `affectedRows`
78
+ * counts *changed* rows, so an idempotent `patch`/`replace` that re-writes the
79
+ * same values reports 0 and the OCC guard raises a spurious conflict. Verified
80
+ * once here at construction — see {@link assertFoundRows} — never per statement.
81
+ *
82
+ * `batch` dispatches every statement concurrently (`Promise.all`), same
83
+ * rationale as {@link buildPgExec}'s `batch` — `Mysql2Like` only exposes a
84
+ * single-statement `execute`, so this is "spread across a pool's connections"
85
+ * rather than one wire-level multi-statement command; still non-atomic,
86
+ * at-least-once, and unordered between elements, safe only for statements
87
+ * with no cross-effect (what every current caller batches).
88
+ */
29
89
  declare const buildMysqlExec: (connection: Mysql2Execute) => SqlExec;
30
90
  /**
31
- * **Postgres** dialect. Differs from SQLite only in column types
32
- * (`DOUBLE PRECISION`/`BYTEA`/`BIGSERIAL`), the `information_schema` catalog
33
- * probe, and unique-violation detection (SQLSTATE `23505`).
34
- */
91
+ * **Postgres** dialect. Differs from SQLite only in column types
92
+ * (`DOUBLE PRECISION`/`BYTEA`/`BIGSERIAL`), the `information_schema` catalog
93
+ * probe, and unique-violation detection (SQLSTATE `23505`).
94
+ */
35
95
  declare const postgresDialect: SqlDialect;
36
96
  /**
37
- * **MySQL** dialect. Diverges in: **no `RETURNING`** (the store's OCC falls back
38
- * to affected-rows — which requires the connection's `CLIENT_FOUND_ROWS` flag so
39
- * a no-op update still reports a matched row, see `buildMysqlExec`); bounded
40
- * `VARCHAR` keys (TEXT can't be a primary key / unindexed); a TEXT/BLOB index key
41
- * prefix; and `ER_DUP_ENTRY` (errno 1062) unique violations. (Drizzle's MySQL
42
- * dialect supplies the backtick identifiers + `ON DUPLICATE KEY` upserts.)
43
- */
97
+ * **MySQL** dialect. Diverges in: **no `RETURNING`** (the store's OCC falls back
98
+ * to affected-rows — which requires the connection's `CLIENT_FOUND_ROWS` flag so
99
+ * a no-op update still reports a matched row, see `buildMysqlExec`); bounded
100
+ * `VARCHAR` keys (TEXT can't be a primary key / unindexed); a TEXT/BLOB index key
101
+ * prefix; and `ER_DUP_ENTRY` (errno 1062) unique violations. (Drizzle's MySQL
102
+ * dialect supplies the backtick identifiers + `ON DUPLICATE KEY` upserts.)
103
+ */
44
104
  declare const mysqlDialect: SqlDialect;
105
+ /** Options for {@link createPgVectorIndex}. */
106
+ interface PgVectorIndexOptions {
107
+ /** Postgres client — the same `SqlClient` the Hyperdrive global store takes. */
108
+ client: SqlClient;
109
+ /**
110
+ * Vector width. Must match the embedder's output and the `dimensions` on the
111
+ * schema's `.vectorize(...)`; Postgres enforces it per row, so a mismatch
112
+ * surfaces as a write error rather than silently bad neighbours.
113
+ */
114
+ dimensions: number;
115
+ /** Distance metric. Defaults to `"cosine"`, matching the common embedding case. */
116
+ metric?: VectorMetric;
117
+ /**
118
+ * Names the backing table (`__vec_<name>`), derived rather than configurable —
119
+ * a second name for one index is a way to lose data, not a feature.
120
+ *
121
+ * This is NOT required to equal the key in the shard's `vectors` map, and often
122
+ * cannot: that key mirrors the schema's `.vectorize({ index })`, which may carry
123
+ * hyphens (`"docs-body"`), while this must be a bare SQL identifier. Keep it
124
+ * stable — changing it points the index at a different, empty table.
125
+ */
126
+ name: string;
127
+ }
128
+ /**
129
+ * Build a `pgvector`-backed vector index that satisfies {@link VectorizeIndexLike}.
130
+ *
131
+ * Requires the `vector` extension to be installable by the connecting role
132
+ * (`CREATE EXTENSION IF NOT EXISTS vector`). On a managed Postgres where the
133
+ * role cannot create extensions, install it once out-of-band; the statement is
134
+ * then a no-op.
135
+ * @param options See {@link PgVectorIndexOptions}.
136
+ * @returns An index object the shard's `vectors` map accepts as-is.
137
+ */
138
+ declare const createPgVectorIndex: (options: PgVectorIndexOptions) => VectorizeIndexLike;
45
139
  /** Which engine a Hyperdrive-backed `.global()` store targets. */
46
140
  type HyperdriveEngine = "mysql" | "postgres";
47
141
  /** Options for {@link createHyperdriveGlobalCtxDb}: the store options minus `exec`/`dialect`, plus the engine and a built `SqlExec`. */
@@ -52,18 +146,14 @@ interface CreateHyperdriveGlobalCtxDbOptions extends Omit<SqlCtxDbOptions, "dial
52
146
  exec: SqlExec;
53
147
  }
54
148
  /**
55
- * Build a reactive `.global()` writer backed by a Hyperdrive-reachable
56
- * Postgres/MySQL database. Pass a built {@link SqlExec} (via {@link buildPgExec}/
57
- * {@link buildMysqlExec}) and the matching `engine`; everything else mirrors the
58
- * D1 store options.
59
- */
60
- declare const createHyperdriveGlobalCtxDb: ({
61
- engine,
62
- exec,
63
- ...rest
64
- }: CreateHyperdriveGlobalCtxDbOptions) => DatabaseWriterLike;
149
+ * Build a reactive `.global()` writer backed by a Hyperdrive-reachable
150
+ * Postgres/MySQL database. Pass a built {@link SqlExec} (via {@link buildPgExec}/
151
+ * {@link buildMysqlExec}) and the matching `engine`; everything else mirrors the
152
+ * D1 store options.
153
+ */
154
+ declare const createHyperdriveGlobalCtxDb: ({ engine, exec, ...rest }: CreateHyperdriveGlobalCtxDbOptions) => DatabaseWriterLike;
65
155
  /** Convenience: a **Postgres** `.global()` writer from a row-client (postgres.js/pg over Hyperdrive). */
66
156
  declare const createPostgresGlobalCtxDb: (client: RowClient, options: Omit<CreateHyperdriveGlobalCtxDbOptions, "engine" | "exec">) => DatabaseWriterLike;
67
157
  /** Convenience: a **MySQL** `.global()` writer from a `mysql2/promise` connection/pool (created with `flags: ["FOUND_ROWS"]`). */
68
158
  declare const createMysqlGlobalCtxDb: (connection: Mysql2Execute, options: Omit<CreateHyperdriveGlobalCtxDbOptions, "engine" | "exec">) => DatabaseWriterLike;
69
- export { CreateHyperdriveGlobalCtxDbOptions, HyperdriveEngine, type Mysql2Execute, type RowClient, buildMysqlExec, buildPgExec, createHyperdriveGlobalCtxDb, createMysqlGlobalCtxDb, createPostgresGlobalCtxDb, mysqlDialect, postgresDialect };
159
+ export { CreateHyperdriveGlobalCtxDbOptions, HyperdriveEngine, type Mysql2Execute, type PgVectorIndexOptions, type RowClient, buildMysqlExec, buildPgExec, createHyperdriveGlobalCtxDb, createMysqlGlobalCtxDb, createPgVectorIndex, createPostgresGlobalCtxDb, mysqlDialect, postgresDialect };
package/dist/global.d.ts CHANGED
@@ -1,47 +1,141 @@
1
- import { DatabaseWriterLike } from '@lunora/do';
1
+ import { DatabaseWriterLike } from '@lunora/shard-engine';
2
2
  import { SqlExec, SqlDialect, SqlCtxDbOptions } from '@lunora/sql-store';
3
- /** Minimal row-returning client (e.g. `@lunora/hyperdrive`'s `fromPostgresJs`/`fromNodePg` result). */
4
- interface RowClient {
5
- query: <Row = Record<string, unknown>>(text: string, params?: ReadonlyArray<unknown>) => Promise<Row[]>;
6
- }
7
- /** Minimal `mysql2/promise` connection/pool surface`execute` resolves to `[rows | ResultSetHeader, fields]`. */
8
- interface Mysql2Execute {
9
- execute: (text: string, params?: ReadonlyArray<unknown>) => Promise<[unknown, unknown]>;
10
- }
3
+ import { M as Mysql2Like, S as SqlClient } from "./packem_shared/types.d-DE1NYxyA.js";
4
+ import { VectorMetric, VectorizeIndexLike } from '@lunora/platform';
5
+ /**
6
+ * Minimal row-returning client (e.g. `@lunora/hyperdrive`'s `fromPostgresJs`/`fromNodePg`
7
+ * result). Aliases {@link SqlClient} the exec-facing name is kept so call sites read
8
+ * intent, but the shape is the single source of truth in `./types` (no drift).
9
+ */
10
+ type RowClient = SqlClient;
11
11
  /**
12
- * Wrap a Postgres row-client (from `@lunora/hyperdrive`'s `fromPostgresJs` /
13
- * `fromNodePg`) as a {@link SqlExec}. The core already renders `$N` placeholders
14
- * for Postgres, so `all`/`run` forward verbatim. Postgres uses `RETURNING` for
15
- * OCC (read via `all`), so `run` reports no affected-row count.
16
- */
12
+ * Minimal `mysql2/promise` connection/pool surface `execute` resolves to
13
+ * `[rows | ResultSetHeader, fields]`. Aliases {@link Mysql2Like} so the /global
14
+ * entry's driver surface can never drift from the main entry's, widened with the
15
+ * (optional, structural) shape {@link assertFoundRows}'s `CLIENT_FOUND_ROWS`
16
+ * probe reads.
17
+ *
18
+ * A real `mysql2/promise` connection/pool exposes the merged client-flags
19
+ * bitmask synchronously, but at two different depths depending on which one it
20
+ * is, and NEITHER is in `mysql2`'s own `.d.ts` — its `Pool extends Connection`
21
+ * signature claims a top-level `config`, but at runtime a `mysql2/promise`
22
+ * `Pool` has none; the real value lives one level down, on the core pool it
23
+ * wraps:
24
+ *
25
+ * - a single `Connection`/`PoolConnection` → `connection.config.clientFlags`
26
+ * - a `Pool` (the `createPool({ flags: ["FOUND_ROWS"] })` example above) →
27
+ * `pool.pool.config.connectionConfig.clientFlags`
28
+ *
29
+ * Because those paths are undocumented driver internals, `global-dialect.test.ts`
30
+ * pins them against a REAL `mysql2` pool (built without connecting) rather than
31
+ * only against hand-written doubles — if a `mysql2` release relocates them, the
32
+ * probe would otherwise degrade silently to the warn branch and the OCC guard
33
+ * would go unchecked.
34
+ *
35
+ * Both fields are optional so a minimal `Mysql2Like` test double (only
36
+ * `execute`) safely resolves to "undeterminable" instead of a `TypeError`.
37
+ */
38
+ type Mysql2Execute = Mysql2Like & {
39
+ config?: {
40
+ clientFlags?: number;
41
+ };
42
+ pool?: {
43
+ config?: {
44
+ connectionConfig?: {
45
+ clientFlags?: number;
46
+ };
47
+ };
48
+ };
49
+ };
50
+ /**
51
+ * Wrap a Postgres row-client (from `@lunora/hyperdrive`'s `fromPostgresJs` /
52
+ * `fromNodePg`) as a {@link SqlExec}. The core already renders `$N` placeholders
53
+ * for Postgres, so `all`/`run` forward verbatim. Postgres uses `RETURNING` for
54
+ * OCC (read via `all`), so `run` reports no affected-row count.
55
+ *
56
+ * `batch` dispatches every statement concurrently (`Promise.all`) over `client`
57
+ * rather than awaiting each `query` call in turn — `RowClient` only exposes a
58
+ * single-statement `query`, so there is no wire-level multi-statement command
59
+ * to reach for. When `client` is backed by a pool (the common production
60
+ * shape), this genuinely spreads the statements across multiple physical
61
+ * connections instead of serializing one full round trip at a time; against a
62
+ * single connection it still removes the sequential *await*, though the
63
+ * underlying driver may itself queue the sends. Either way it stays
64
+ * non-atomic, at-least-once, and unordered between elements, same as the
65
+ * sequential fallback minus the ordering — safe only for statements whose
66
+ * effects don't depend on each other, which is what every current caller
67
+ * batches (distinct-keyed companion rows).
68
+ */
17
69
  declare const buildPgExec: (client: RowClient) => SqlExec;
18
70
  /**
19
- * Wrap a `mysql2/promise` connection/pool as a {@link SqlExec}. The core already
20
- * renders backtick identifiers and `?` placeholders for MySQL, so `all`/`run`
21
- * forward verbatim. MySQL has no `RETURNING`, so `run` surfaces `affectedRows`
22
- * for the store's affected-rows OCC guard.
23
- *
24
- * **The connection MUST be created with the `CLIENT_FOUND_ROWS` flag**
25
- * (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`). Without it, `affectedRows`
26
- * counts *changed* rows, so an idempotent `patch`/`replace` that re-writes the
27
- * same values reports 0 and the OCC guard raises a spurious conflict.
28
- */
71
+ * Wrap a `mysql2/promise` connection/pool as a {@link SqlExec}. The core already
72
+ * renders backtick identifiers and `?` placeholders for MySQL, so `all`/`run`
73
+ * forward verbatim. MySQL has no `RETURNING`, so `run` surfaces `affectedRows`
74
+ * for the store's affected-rows OCC guard.
75
+ *
76
+ * **The connection MUST be created with the `CLIENT_FOUND_ROWS` flag**
77
+ * (mysql2: `createPool({ flags: ["FOUND_ROWS"] })`). Without it, `affectedRows`
78
+ * counts *changed* rows, so an idempotent `patch`/`replace` that re-writes the
79
+ * same values reports 0 and the OCC guard raises a spurious conflict. Verified
80
+ * once here at construction — see {@link assertFoundRows} — never per statement.
81
+ *
82
+ * `batch` dispatches every statement concurrently (`Promise.all`), same
83
+ * rationale as {@link buildPgExec}'s `batch` — `Mysql2Like` only exposes a
84
+ * single-statement `execute`, so this is "spread across a pool's connections"
85
+ * rather than one wire-level multi-statement command; still non-atomic,
86
+ * at-least-once, and unordered between elements, safe only for statements
87
+ * with no cross-effect (what every current caller batches).
88
+ */
29
89
  declare const buildMysqlExec: (connection: Mysql2Execute) => SqlExec;
30
90
  /**
31
- * **Postgres** dialect. Differs from SQLite only in column types
32
- * (`DOUBLE PRECISION`/`BYTEA`/`BIGSERIAL`), the `information_schema` catalog
33
- * probe, and unique-violation detection (SQLSTATE `23505`).
34
- */
91
+ * **Postgres** dialect. Differs from SQLite only in column types
92
+ * (`DOUBLE PRECISION`/`BYTEA`/`BIGSERIAL`), the `information_schema` catalog
93
+ * probe, and unique-violation detection (SQLSTATE `23505`).
94
+ */
35
95
  declare const postgresDialect: SqlDialect;
36
96
  /**
37
- * **MySQL** dialect. Diverges in: **no `RETURNING`** (the store's OCC falls back
38
- * to affected-rows — which requires the connection's `CLIENT_FOUND_ROWS` flag so
39
- * a no-op update still reports a matched row, see `buildMysqlExec`); bounded
40
- * `VARCHAR` keys (TEXT can't be a primary key / unindexed); a TEXT/BLOB index key
41
- * prefix; and `ER_DUP_ENTRY` (errno 1062) unique violations. (Drizzle's MySQL
42
- * dialect supplies the backtick identifiers + `ON DUPLICATE KEY` upserts.)
43
- */
97
+ * **MySQL** dialect. Diverges in: **no `RETURNING`** (the store's OCC falls back
98
+ * to affected-rows — which requires the connection's `CLIENT_FOUND_ROWS` flag so
99
+ * a no-op update still reports a matched row, see `buildMysqlExec`); bounded
100
+ * `VARCHAR` keys (TEXT can't be a primary key / unindexed); a TEXT/BLOB index key
101
+ * prefix; and `ER_DUP_ENTRY` (errno 1062) unique violations. (Drizzle's MySQL
102
+ * dialect supplies the backtick identifiers + `ON DUPLICATE KEY` upserts.)
103
+ */
44
104
  declare const mysqlDialect: SqlDialect;
105
+ /** Options for {@link createPgVectorIndex}. */
106
+ interface PgVectorIndexOptions {
107
+ /** Postgres client — the same `SqlClient` the Hyperdrive global store takes. */
108
+ client: SqlClient;
109
+ /**
110
+ * Vector width. Must match the embedder's output and the `dimensions` on the
111
+ * schema's `.vectorize(...)`; Postgres enforces it per row, so a mismatch
112
+ * surfaces as a write error rather than silently bad neighbours.
113
+ */
114
+ dimensions: number;
115
+ /** Distance metric. Defaults to `"cosine"`, matching the common embedding case. */
116
+ metric?: VectorMetric;
117
+ /**
118
+ * Names the backing table (`__vec_<name>`), derived rather than configurable —
119
+ * a second name for one index is a way to lose data, not a feature.
120
+ *
121
+ * This is NOT required to equal the key in the shard's `vectors` map, and often
122
+ * cannot: that key mirrors the schema's `.vectorize({ index })`, which may carry
123
+ * hyphens (`"docs-body"`), while this must be a bare SQL identifier. Keep it
124
+ * stable — changing it points the index at a different, empty table.
125
+ */
126
+ name: string;
127
+ }
128
+ /**
129
+ * Build a `pgvector`-backed vector index that satisfies {@link VectorizeIndexLike}.
130
+ *
131
+ * Requires the `vector` extension to be installable by the connecting role
132
+ * (`CREATE EXTENSION IF NOT EXISTS vector`). On a managed Postgres where the
133
+ * role cannot create extensions, install it once out-of-band; the statement is
134
+ * then a no-op.
135
+ * @param options See {@link PgVectorIndexOptions}.
136
+ * @returns An index object the shard's `vectors` map accepts as-is.
137
+ */
138
+ declare const createPgVectorIndex: (options: PgVectorIndexOptions) => VectorizeIndexLike;
45
139
  /** Which engine a Hyperdrive-backed `.global()` store targets. */
46
140
  type HyperdriveEngine = "mysql" | "postgres";
47
141
  /** Options for {@link createHyperdriveGlobalCtxDb}: the store options minus `exec`/`dialect`, plus the engine and a built `SqlExec`. */
@@ -52,18 +146,14 @@ interface CreateHyperdriveGlobalCtxDbOptions extends Omit<SqlCtxDbOptions, "dial
52
146
  exec: SqlExec;
53
147
  }
54
148
  /**
55
- * Build a reactive `.global()` writer backed by a Hyperdrive-reachable
56
- * Postgres/MySQL database. Pass a built {@link SqlExec} (via {@link buildPgExec}/
57
- * {@link buildMysqlExec}) and the matching `engine`; everything else mirrors the
58
- * D1 store options.
59
- */
60
- declare const createHyperdriveGlobalCtxDb: ({
61
- engine,
62
- exec,
63
- ...rest
64
- }: CreateHyperdriveGlobalCtxDbOptions) => DatabaseWriterLike;
149
+ * Build a reactive `.global()` writer backed by a Hyperdrive-reachable
150
+ * Postgres/MySQL database. Pass a built {@link SqlExec} (via {@link buildPgExec}/
151
+ * {@link buildMysqlExec}) and the matching `engine`; everything else mirrors the
152
+ * D1 store options.
153
+ */
154
+ declare const createHyperdriveGlobalCtxDb: ({ engine, exec, ...rest }: CreateHyperdriveGlobalCtxDbOptions) => DatabaseWriterLike;
65
155
  /** Convenience: a **Postgres** `.global()` writer from a row-client (postgres.js/pg over Hyperdrive). */
66
156
  declare const createPostgresGlobalCtxDb: (client: RowClient, options: Omit<CreateHyperdriveGlobalCtxDbOptions, "engine" | "exec">) => DatabaseWriterLike;
67
157
  /** Convenience: a **MySQL** `.global()` writer from a `mysql2/promise` connection/pool (created with `flags: ["FOUND_ROWS"]`). */
68
158
  declare const createMysqlGlobalCtxDb: (connection: Mysql2Execute, options: Omit<CreateHyperdriveGlobalCtxDbOptions, "engine" | "exec">) => DatabaseWriterLike;
69
- export { CreateHyperdriveGlobalCtxDbOptions, HyperdriveEngine, type Mysql2Execute, type RowClient, buildMysqlExec, buildPgExec, createHyperdriveGlobalCtxDb, createMysqlGlobalCtxDb, createPostgresGlobalCtxDb, mysqlDialect, postgresDialect };
159
+ export { CreateHyperdriveGlobalCtxDbOptions, HyperdriveEngine, type Mysql2Execute, type PgVectorIndexOptions, type RowClient, buildMysqlExec, buildPgExec, createHyperdriveGlobalCtxDb, createMysqlGlobalCtxDb, createPgVectorIndex, createPostgresGlobalCtxDb, mysqlDialect, postgresDialect };
package/dist/global.mjs CHANGED
@@ -1,9 +1 @@
1
- import { createSqlCtxDb } from '@lunora/sql-store';
2
- import { postgresDialect, mysqlDialect } from './packem_shared/postgresDialect-oNhZ58s8.mjs';
3
- import { buildMysqlExec, buildPgExec } from './packem_shared/buildPgExec-DBbCjyq3.mjs';
4
-
5
- const createHyperdriveGlobalCtxDb = ({ engine, exec, ...rest }) => createSqlCtxDb({ ...rest, dialect: engine === "postgres" ? postgresDialect : mysqlDialect, exec });
6
- const createPostgresGlobalCtxDb = (client, options) => createHyperdriveGlobalCtxDb({ ...options, engine: "postgres", exec: buildPgExec(client) });
7
- const createMysqlGlobalCtxDb = (connection, options) => createHyperdriveGlobalCtxDb({ ...options, engine: "mysql", exec: buildMysqlExec(connection) });
8
-
9
- export { buildMysqlExec, buildPgExec, createHyperdriveGlobalCtxDb, createMysqlGlobalCtxDb, createPostgresGlobalCtxDb, mysqlDialect, postgresDialect };
1
+ import{createSqlCtxDb as c}from"@lunora/sql-store";import{postgresDialect as l,mysqlDialect as s}from"./packem_shared/mysqlDialect-DitNAlpV.mjs";import{buildMysqlExec as a,buildPgExec as i}from"./packem_shared/buildMysqlExec-CPwtojyL.mjs";import{createPgVectorIndex as d}from"./packem_shared/createPgVectorIndex-DcpguGpe.mjs";const r=({engine:e,exec:t,...o})=>c({...o,dialect:e==="postgres"?l:s,exec:t}),p=(e,t)=>r({...t,engine:"postgres",exec:i(e)}),g=(e,t)=>r({...t,engine:"mysql",exec:a(e)});export{a as buildMysqlExec,i as buildPgExec,r as createHyperdriveGlobalCtxDb,g as createMysqlGlobalCtxDb,d as createPgVectorIndex,p as createPostgresGlobalCtxDb,s as mysqlDialect,l as postgresDialect};