copilotz 1.0.0-rc.20 → 1.0.0-rc.21
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 +417 -0
- package/README.md +295 -19
- package/hosts/orgs/mod.d.ts +4 -1
- package/hosts/orgs/mod.js +2 -2
- package/hosts/web/files.d.ts +6 -2
- package/hosts/web/files.js +36 -3
- package/hosts/web/node/mod.d.ts +1 -1
- package/hosts/web/node/mod.js +1 -1
- package/hosts/web/node/serve.d.ts +26 -0
- package/hosts/web/node/serve.js +23 -1
- package/hosts/web/routes.d.ts +28 -1
- package/hosts/web/routes.js +65 -10
- package/hosts/web/server.d.ts +5 -4
- package/hosts/web/server.js +1 -1
- package/package.json +2 -2
- package/plugins/access/accounts/collections/account.d.ts +2 -2
- package/plugins/access/contacts/actions/chat.d.ts +1 -0
- package/plugins/access/contacts/actions/chat.js +45 -0
- package/plugins/access/contacts/actions/forget.d.ts +1 -0
- package/plugins/access/contacts/actions/forget.js +56 -0
- package/plugins/access/contacts/actions/start.d.ts +1 -0
- package/plugins/access/contacts/actions/start.js +50 -0
- package/plugins/access/contacts/collections/contact.d.ts +81 -0
- package/plugins/access/contacts/collections/contact.js +58 -0
- package/plugins/access/contacts/contract.d.ts +10 -0
- package/plugins/access/contacts/contract.js +10 -0
- package/plugins/access/contacts/mod.d.ts +27 -0
- package/plugins/access/contacts/mod.js +49 -0
- package/plugins/access/contacts/views/contact.d.ts +8 -0
- package/plugins/access/contacts/views/contact.js +25 -0
- package/plugins/access/contacts/web.d.ts +7 -0
- package/plugins/access/contacts/web.js +11 -0
- package/plugins/access/directory/collections/credit-code.d.ts +1 -1
- package/plugins/access/directory/collections/invite.d.ts +1 -1
- package/plugins/access/identity/mod.js +8 -6
- package/plugins/access/mod.d.ts +7 -1
- package/plugins/access/mod.js +7 -2
- package/plugins/access/spaces/actions/agents.js +12 -6
- package/plugins/access/spaces/actions/create.js +10 -1
- package/plugins/access/spaces/actions/invitation.js +5 -2
- package/plugins/access/spaces/actions/keep.d.ts +1 -0
- package/plugins/access/spaces/actions/keep.js +55 -0
- package/plugins/access/spaces/actions/member.js +17 -4
- package/plugins/access/spaces/actions/rename.js +4 -0
- package/plugins/access/spaces/collections/member.d.ts +1 -1
- package/plugins/access/spaces/collections/request.d.ts +1 -1
- package/plugins/access/spaces/collections/space.d.ts +9 -0
- package/plugins/access/spaces/collections/space.js +2 -0
- package/plugins/access/spaces/contract.d.ts +4 -3
- package/plugins/access/spaces/contract.js +1 -1
- package/plugins/access/spaces/mod.d.ts +7 -1
- package/plugins/access/spaces/mod.js +8 -1
- package/plugins/access/spaces/resources/tools.d.ts +0 -5
- package/plugins/access/spaces/resources/tools.js +11 -1
- package/plugins/access/spaces/shared/agents.js +2 -2
- package/plugins/access/spaces/shared/can.d.ts +18 -3
- package/plugins/access/spaces/shared/can.js +32 -5
- package/plugins/access/spaces/shared/declared.d.ts +21 -0
- package/plugins/access/spaces/shared/declared.js +8 -0
- package/plugins/access/spaces/shared/labels.d.ts +7 -1
- package/plugins/access/spaces/shared/labels.js +56 -8
- package/plugins/access/spaces/shared/managers.js +2 -2
- package/plugins/access/spaces/shared/names.d.ts +9 -5
- package/plugins/access/spaces/shared/names.js +36 -19
- package/plugins/access/spaces/shared/reach.d.ts +20 -6
- package/plugins/access/spaces/shared/reach.js +62 -20
- package/plugins/access/spaces/shared/rules.d.ts +10 -5
- package/plugins/access/spaces/shared/rules.js +35 -10
- package/plugins/access/spaces/shared/seat.d.ts +3 -2
- package/plugins/access/spaces/shared/seat.js +9 -2
- package/plugins/access/spaces/views/where.d.ts +4 -2
- package/plugins/access/spaces/views/where.js +9 -0
- package/plugins/access/spaces/web.js +1 -1
- package/plugins/access/web.d.ts +1 -0
- package/plugins/access/web.js +1 -0
- package/plugins/agents/chat/actions/erase.d.ts +1 -0
- package/plugins/agents/chat/actions/erase.js +51 -0
- package/plugins/agents/chat/actions/open.d.ts +1 -0
- package/plugins/agents/chat/actions/open.js +49 -0
- package/plugins/agents/chat/actions/quiet.d.ts +1 -0
- package/plugins/agents/chat/actions/quiet.js +33 -0
- package/plugins/agents/chat/actions/say.d.ts +1 -0
- package/plugins/agents/chat/actions/say.js +82 -0
- package/plugins/agents/chat/actions/send.js +57 -19
- package/plugins/agents/chat/actions/shown.d.ts +1 -0
- package/plugins/agents/chat/actions/shown.js +35 -0
- package/plugins/agents/chat/collections/intent.d.ts +124 -0
- package/plugins/agents/chat/collections/intent.js +52 -0
- package/plugins/agents/chat/collections/message.d.ts +74 -1
- package/plugins/agents/chat/collections/message.js +23 -1
- package/plugins/agents/chat/collections/shown.d.ts +105 -0
- package/plugins/agents/chat/collections/shown.js +34 -0
- package/plugins/agents/chat/contract.d.ts +15 -7
- package/plugins/agents/chat/contract.js +7 -1
- package/plugins/agents/chat/mod.d.ts +20 -2
- package/plugins/agents/chat/mod.js +43 -4
- package/plugins/agents/chat/processors/failed.js +15 -5
- package/plugins/agents/chat/processors/turn.d.ts +1 -1
- package/plugins/agents/chat/processors/turn.js +95 -35
- package/plugins/agents/chat/shared/delivery.d.ts +16 -2
- package/plugins/agents/chat/shared/delivery.js +62 -7
- package/plugins/agents/chat/shared/send.d.ts +1 -3
- package/plugins/agents/chat/shared/send.js +2 -9
- package/plugins/agents/chat/shared/tools.d.ts +33 -0
- package/plugins/agents/chat/shared/tools.js +28 -0
- package/plugins/agents/chat/shared/types.d.ts +59 -1
- package/plugins/agents/chat/views/message.d.ts +4 -2
- package/plugins/agents/chat/views/message.js +22 -4
- package/plugins/agents/chat/views/prompt.js +38 -4
- package/plugins/agents/history/collections/outline.d.ts +1 -1
- package/plugins/agents/history/collections/summary.d.ts +1 -1
- package/plugins/agents/history/mod.js +2 -1
- package/plugins/agents/history/processors/erase.d.ts +3 -0
- package/plugins/agents/history/processors/erase.js +11 -0
- package/plugins/agents/memory/mod.js +2 -1
- package/plugins/agents/memory/processors/extract.d.ts +1 -1
- package/plugins/agents/memory/processors/extract.js +5 -0
- package/plugins/agents/memory/resources/tools.js +1 -1
- package/plugins/agents/memory/shared/settings.d.ts +7 -2
- package/plugins/agents/memory/shared/settings.js +9 -1
- package/plugins/agents/routines/collections/routine.d.ts +1 -1
- package/plugins/agents/routines/collections/run.d.ts +1 -1
- package/plugins/compute/apps/collections/app.d.ts +2 -2
- package/plugins/compute/cloud/resources/tools.js +3 -3
- package/plugins/compute/computers/collections/approval.d.ts +2 -2
- package/plugins/compute/computers/collections/grant.d.ts +1 -1
- package/plugins/compute/computers/collections/preview.d.ts +2 -2
- package/plugins/compute/computers/program/version.d.ts +1 -1
- package/plugins/compute/computers/program/version.js +1 -1
- package/plugins/compute/computers/resources/downloads.js +1 -1
- package/plugins/compute/computers/shared/wake.d.ts +1 -1
- package/plugins/compute/computers/shared/wake.js +17 -0
- package/plugins/interfaces/api/collections/key.d.ts +1 -1
- package/plugins/interfaces/api/shared/events.js +5 -4
- package/plugins/interfaces/maintenance/actions/read.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/read.js +76 -0
- package/plugins/interfaces/maintenance/actions/write.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/write.js +64 -0
- package/plugins/interfaces/maintenance/contract.d.ts +60 -0
- package/plugins/interfaces/maintenance/contract.js +2 -0
- package/plugins/interfaces/maintenance/mod.d.ts +52 -0
- package/plugins/interfaces/maintenance/mod.js +66 -0
- package/plugins/interfaces/maintenance/resources/routes.d.ts +71 -0
- package/plugins/interfaces/maintenance/resources/routes.js +457 -0
- package/plugins/interfaces/maintenance/shared/ops.d.ts +4 -0
- package/plugins/interfaces/maintenance/shared/ops.js +19 -0
- package/plugins/interfaces/mcp/actions/call.d.ts +11 -0
- package/plugins/interfaces/mcp/actions/call.js +304 -0
- package/plugins/interfaces/mcp/actions/prune.d.ts +1 -0
- package/plugins/interfaces/mcp/actions/prune.js +18 -0
- package/plugins/interfaces/mcp/collections/closed.d.ts +23 -0
- package/plugins/interfaces/mcp/collections/closed.js +17 -0
- package/plugins/interfaces/mcp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/mcp/collections/rate.js +18 -0
- package/plugins/interfaces/mcp/collections/receipt.d.ts +46 -0
- package/plugins/interfaces/mcp/collections/receipt.js +46 -0
- package/plugins/interfaces/mcp/contract.d.ts +9 -0
- package/plugins/interfaces/mcp/contract.js +9 -0
- package/plugins/interfaces/mcp/mod.d.ts +84 -0
- package/plugins/interfaces/mcp/mod.js +122 -0
- package/plugins/interfaces/mcp/processors/closed.d.ts +13 -0
- package/plugins/interfaces/mcp/processors/closed.js +16 -0
- package/plugins/interfaces/mcp/resources/running.d.ts +21 -0
- package/plugins/interfaces/mcp/resources/running.js +36 -0
- package/plugins/interfaces/mcp/resources/server.d.ts +54 -0
- package/plugins/interfaces/mcp/resources/server.js +423 -0
- package/plugins/interfaces/mcp/resources/tools.d.ts +114 -0
- package/plugins/interfaces/mcp/resources/tools.js +324 -0
- package/plugins/interfaces/mcp/shared/caller.d.ts +45 -0
- package/plugins/interfaces/mcp/shared/caller.js +99 -0
- package/plugins/interfaces/mcp/shared/keys.d.ts +50 -0
- package/plugins/interfaces/mcp/shared/keys.js +53 -0
- package/plugins/interfaces/mcp/shared/settings.d.ts +187 -0
- package/plugins/interfaces/mcp/shared/settings.js +176 -0
- package/plugins/interfaces/mcp/views/offered.d.ts +20 -0
- package/plugins/interfaces/mcp/views/offered.js +20 -0
- package/plugins/interfaces/mod.d.ts +5 -1
- package/plugins/interfaces/mod.js +5 -1
- package/plugins/interfaces/terminal/actions/print.js +1 -1
- package/plugins/interfaces/terminal/actions/set.js +1 -1
- package/plugins/interfaces/terminal/collections/output.d.ts +1 -1
- package/plugins/interfaces/terminal/collections/shell.js +1 -1
- package/plugins/interfaces/voice/actions/block.d.ts +2 -0
- package/plugins/interfaces/voice/actions/block.js +74 -0
- package/plugins/interfaces/voice/actions/call.d.ts +19 -0
- package/plugins/interfaces/voice/actions/call.js +253 -0
- package/plugins/interfaces/voice/actions/hook.d.ts +5 -0
- package/plugins/interfaces/voice/actions/hook.js +225 -0
- package/plugins/interfaces/voice/actions/prune.d.ts +1 -0
- package/plugins/interfaces/voice/actions/prune.js +35 -0
- package/plugins/interfaces/voice/collections/blocked.d.ts +87 -0
- package/plugins/interfaces/voice/collections/blocked.js +34 -0
- package/plugins/interfaces/voice/collections/call.d.ts +279 -0
- package/plugins/interfaces/voice/collections/call.js +77 -0
- package/plugins/interfaces/voice/collections/phone.d.ts +74 -0
- package/plugins/interfaces/voice/collections/phone.js +26 -0
- package/plugins/interfaces/voice/contract.d.ts +14 -0
- package/plugins/interfaces/voice/contract.js +2 -0
- package/plugins/interfaces/voice/mod.d.ts +57 -0
- package/plugins/interfaces/voice/mod.js +118 -0
- package/plugins/interfaces/voice/processors/forget.d.ts +13 -0
- package/plugins/interfaces/voice/processors/forget.js +27 -0
- package/plugins/interfaces/voice/resources/relay.d.ts +77 -0
- package/plugins/interfaces/voice/resources/relay.js +428 -0
- package/plugins/interfaces/voice/resources/tools.d.ts +1 -0
- package/plugins/interfaces/voice/resources/tools.js +25 -0
- package/plugins/interfaces/voice/shared/caller.d.ts +27 -0
- package/plugins/interfaces/voice/shared/caller.js +38 -0
- package/plugins/interfaces/voice/shared/settings.d.ts +136 -0
- package/plugins/interfaces/voice/shared/settings.js +121 -0
- package/plugins/interfaces/voice/shared/signature.d.ts +11 -0
- package/plugins/interfaces/voice/shared/signature.js +34 -0
- package/plugins/interfaces/voice/views/call.d.ts +41 -0
- package/plugins/interfaces/voice/views/call.js +30 -0
- package/plugins/interfaces/voice/views/context.d.ts +9 -0
- package/plugins/interfaces/voice/views/context.js +14 -0
- package/plugins/interfaces/voice/views/message.d.ts +17 -0
- package/plugins/interfaces/voice/views/message.js +41 -0
- package/plugins/interfaces/whatsapp/actions/connect.js +3 -0
- package/plugins/interfaces/whatsapp/actions/disconnect.js +4 -1
- package/plugins/interfaces/whatsapp/actions/hook.js +27 -11
- package/plugins/interfaces/whatsapp/actions/set.d.ts +8 -0
- package/plugins/interfaces/whatsapp/actions/set.js +121 -0
- package/plugins/interfaces/whatsapp/collections/blocked.d.ts +29 -0
- package/plugins/interfaces/whatsapp/collections/blocked.js +22 -0
- package/plugins/interfaces/whatsapp/collections/code.d.ts +1 -1
- package/plugins/interfaces/whatsapp/collections/number.d.ts +90 -4
- package/plugins/interfaces/whatsapp/collections/number.js +36 -4
- package/plugins/interfaces/whatsapp/collections/phone.d.ts +13 -3
- package/plugins/interfaces/whatsapp/collections/phone.js +9 -3
- package/plugins/interfaces/whatsapp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/whatsapp/collections/rate.js +13 -0
- package/plugins/interfaces/whatsapp/collections/sent.d.ts +24 -12
- package/plugins/interfaces/whatsapp/collections/sent.js +11 -7
- package/plugins/interfaces/whatsapp/collections/thread.d.ts +14 -6
- package/plugins/interfaces/whatsapp/collections/thread.js +7 -5
- package/plugins/interfaces/whatsapp/collections/typing.d.ts +70 -0
- package/plugins/interfaces/whatsapp/collections/typing.js +21 -0
- package/plugins/interfaces/whatsapp/contract.d.ts +27 -4
- package/plugins/interfaces/whatsapp/contract.js +34 -1
- package/plugins/interfaces/whatsapp/events/undelivered.d.ts +8 -0
- package/plugins/interfaces/whatsapp/events/undelivered.js +17 -0
- package/plugins/interfaces/whatsapp/mod.d.ts +28 -2
- package/plugins/interfaces/whatsapp/mod.js +65 -6
- package/plugins/interfaces/whatsapp/processors/forget.d.ts +6 -0
- package/plugins/interfaces/whatsapp/processors/forget.js +11 -0
- package/plugins/interfaces/whatsapp/processors/receive.d.ts +17 -3
- package/plugins/interfaces/whatsapp/processors/receive.js +264 -81
- package/plugins/interfaces/whatsapp/processors/reply.d.ts +25 -5
- package/plugins/interfaces/whatsapp/processors/reply.js +216 -20
- package/plugins/interfaces/whatsapp/processors/typing.d.ts +8 -0
- package/plugins/interfaces/whatsapp/processors/typing.js +25 -0
- package/plugins/interfaces/whatsapp/shared/customers.d.ts +13 -0
- package/plugins/interfaces/whatsapp/shared/customers.js +16 -0
- package/plugins/interfaces/whatsapp/shared/graph.d.ts +31 -6
- package/plugins/interfaces/whatsapp/shared/graph.js +117 -10
- package/plugins/interfaces/whatsapp/shared/media.d.ts +23 -0
- package/plugins/interfaces/whatsapp/shared/media.js +46 -0
- package/plugins/interfaces/whatsapp/shared/number.d.ts +19 -8
- package/plugins/interfaces/whatsapp/shared/number.js +64 -7
- package/plugins/interfaces/whatsapp/shared/parts.d.ts +94 -0
- package/plugins/interfaces/whatsapp/shared/parts.js +184 -0
- package/plugins/interfaces/whatsapp/shared/payload.d.ts +27 -1
- package/plugins/interfaces/whatsapp/shared/payload.js +36 -1
- package/plugins/interfaces/whatsapp/shared/settings.d.ts +49 -1
- package/plugins/interfaces/whatsapp/shared/settings.js +11 -0
- package/plugins/interfaces/whatsapp/views/message.d.ts +13 -0
- package/plugins/interfaces/whatsapp/views/message.js +13 -0
- package/plugins/interfaces/whatsapp/views/web/line.d.ts +24 -0
- package/plugins/interfaces/whatsapp/views/web/line.js +44 -0
- package/plugins/interfaces/whatsapp/views/web/space.d.ts +7 -5
- package/plugins/interfaces/whatsapp/views/web/space.js +17 -10
- package/plugins/interfaces/whatsapp/views/web/style.d.ts +1 -1
- package/plugins/interfaces/whatsapp/views/web/style.js +8 -0
- package/plugins/models/adapters/llm/anthropic.d.ts +1 -1
- package/plugins/models/adapters/llm/anthropic.js +28 -15
- package/plugins/models/adapters/llm/gemini.d.ts +1 -1
- package/plugins/models/adapters/llm/gemini.js +2 -1
- package/plugins/models/adapters/llm/openai-compatible.d.ts +1 -1
- package/plugins/models/adapters/llm/openai-compatible.js +2 -1
- package/plugins/models/adapters/llm/openai.d.ts +1 -1
- package/plugins/models/adapters/llm/openai.js +16 -4
- package/plugins/models/shared/types.d.ts +8 -0
- package/plugins/models/shared/types.js +10 -0
- package/runtime/actor.d.ts +6 -0
- package/runtime/actor.js +9 -4
- package/runtime/aggregate.js +8 -2
- package/runtime/blobs.d.ts +15 -12
- package/runtime/blobs.js +58 -11
- package/runtime/cache.d.ts +6 -0
- package/runtime/cache.js +19 -1
- package/runtime/define.d.ts +10 -0
- package/runtime/errors.d.ts +20 -2
- package/runtime/errors.js +7 -1
- package/runtime/executor.js +27 -11
- package/runtime/links.d.ts +31 -0
- package/runtime/links.js +60 -0
- package/runtime/maintain.d.ts +88 -0
- package/runtime/maintain.js +120 -0
- package/runtime/memory.js +7 -4
- package/runtime/mod.d.ts +6 -4
- package/runtime/mod.js +5 -2
- package/runtime/mongo.d.ts +13 -0
- package/runtime/mongo.js +39 -8
- package/runtime/observe.d.ts +2 -0
- package/runtime/observe.js +14 -10
- package/runtime/ops.d.ts +5 -0
- package/runtime/ops.js +10 -1
- package/runtime/owner.d.ts +18 -1
- package/runtime/owner.js +127 -61
- package/runtime/presence.d.ts +18 -0
- package/runtime/presence.js +25 -0
- package/runtime/registry.d.ts +5 -0
- package/runtime/registry.js +18 -0
- package/runtime/runtime.js +9 -3
- package/runtime/store.d.ts +48 -1
- package/runtime/wire.d.ts +1 -0
- package/runtime/wire.js +3 -1
- package/stores/blobs/files/mod.js +4 -2
- package/stores/blobs/gcs/mod.d.ts +3 -0
- package/stores/blobs/gcs/mod.js +6 -5
- package/stores/blobs/http/mod.d.ts +1 -1
- package/stores/blobs/http/mod.js +2 -1
- package/stores/latency/mod.js +5 -1
- package/stores/sql/postgres/maintenance.d.ts +24 -0
- package/stores/sql/postgres/maintenance.js +258 -0
- package/stores/sql/postgres/mod.d.ts +20 -4
- package/stores/sql/postgres/mod.js +363 -96
- package/stores/sql/postgres/update.js +3 -1
- package/stores/sql/shared/capped.d.ts +2 -0
- package/stores/sql/shared/capped.js +22 -0
- package/stores/sql/shared/rows.d.ts +14 -0
- package/stores/sql/shared/rows.js +29 -0
- package/stores/sql/shared/statement.d.ts +12 -0
- package/stores/sql/shared/statement.js +244 -0
- package/stores/sql/sqlite/apart.d.ts +11 -0
- package/stores/sql/sqlite/apart.js +219 -0
- package/stores/sql/sqlite/mod.d.ts +16 -2
- package/stores/sql/sqlite/mod.js +246 -51
- package/testing/mod.js +1 -1
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export type Dialect = "postgres" | "sqlite";
|
|
2
|
+
/** What reading or writing it does: a write may change the database, never the connection. */
|
|
3
|
+
export type Mode = "read" | "write";
|
|
4
|
+
/**
|
|
5
|
+
* The statement in `sql`, checked: its text without the `;` that ends it
|
|
6
|
+
* (and whatever follows), and its first keyword, uppercased. Throws
|
|
7
|
+
* `invalid` for none, more than one, or one maintenance can't run.
|
|
8
|
+
*/
|
|
9
|
+
export declare function statement(sql: string, dialect: Dialect, mode: Mode): {
|
|
10
|
+
text: string;
|
|
11
|
+
keyword: string;
|
|
12
|
+
};
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One SQL statement, as maintenance runs it (a store's `inspect`, and its
|
|
3
|
+
* transactions' `execute`): exactly one, and none that would end the
|
|
4
|
+
* transaction it runs in, or change its connection beyond it.
|
|
5
|
+
*
|
|
6
|
+
* A statement is read here first, as its database's scanner reads it:
|
|
7
|
+
* strings, quoted names and comments are skipped, and a `;` outside them
|
|
8
|
+
* may only end it. PostgreSQL's line comments end at a CR or an LF, its
|
|
9
|
+
* block comments nest, and its `E'…'` strings (and their continuations on
|
|
10
|
+
* a later line) take backslash escapes, as they do once
|
|
11
|
+
* `standard_conforming_strings` is on, which maintenance sets; `$tag$…$tag$`
|
|
12
|
+
* bodies are skipped. SQLite's line comments end at an LF. Behind this,
|
|
13
|
+
* PostgreSQL gets every maintenance statement over its extended protocol,
|
|
14
|
+
* which refuses more than one, and SQLite compiles only the first. A
|
|
15
|
+
* SQLite trigger's body (`BEGIN …; END`) is more than one: make triggers
|
|
16
|
+
* elsewhere.
|
|
17
|
+
*/
|
|
18
|
+
import { invalid } from "../../../runtime/errors.js";
|
|
19
|
+
/** Statements that end or nest transactions: they'd take the statement out of its own. */
|
|
20
|
+
const TRANSACTIONS = new Set([
|
|
21
|
+
"BEGIN",
|
|
22
|
+
"START",
|
|
23
|
+
"COMMIT",
|
|
24
|
+
"END",
|
|
25
|
+
"ROLLBACK",
|
|
26
|
+
"ABORT",
|
|
27
|
+
"SAVEPOINT",
|
|
28
|
+
"RELEASE",
|
|
29
|
+
]);
|
|
30
|
+
/** Statements whose effect outlives the transaction, on a connection other work shares. */
|
|
31
|
+
/**
|
|
32
|
+
* PostgreSQL statements that reach past the statement, whatever the role
|
|
33
|
+
* may otherwise do, and why each is refused.
|
|
34
|
+
*/
|
|
35
|
+
const OUTLIVING = {
|
|
36
|
+
// A role may change its own password and settings: a login that outlives the key, or a
|
|
37
|
+
// setting every later connection of it starts with.
|
|
38
|
+
"ALTER ROLE": "a role's password and settings outlive the statement.",
|
|
39
|
+
"ALTER USER": "a role's password and settings outlive the statement.",
|
|
40
|
+
"ALTER GROUP": "a role's members outlive the statement.",
|
|
41
|
+
// An anonymous block is a way around this check: whatever it runs, runs unread.
|
|
42
|
+
DO: "a block runs statements of its own, which nothing here reads first.",
|
|
43
|
+
// A lock holds a table against the app's own writes until the statement's transaction ends.
|
|
44
|
+
LOCK: "it would hold the store's tables against the app's own writes.",
|
|
45
|
+
};
|
|
46
|
+
const SESSION = {
|
|
47
|
+
postgres: new Set([
|
|
48
|
+
"PREPARE",
|
|
49
|
+
"DEALLOCATE",
|
|
50
|
+
"SET",
|
|
51
|
+
"RESET",
|
|
52
|
+
"DISCARD",
|
|
53
|
+
"LISTEN",
|
|
54
|
+
"UNLISTEN",
|
|
55
|
+
"LOAD",
|
|
56
|
+
"DECLARE",
|
|
57
|
+
"FETCH",
|
|
58
|
+
"MOVE",
|
|
59
|
+
"CLOSE",
|
|
60
|
+
"COPY",
|
|
61
|
+
"VACUUM",
|
|
62
|
+
]),
|
|
63
|
+
sqlite: new Set(["ATTACH", "DETACH", "VACUUM"]),
|
|
64
|
+
};
|
|
65
|
+
const word = /[A-Za-z_][A-Za-z0-9_$]*/y;
|
|
66
|
+
const identifier = /[A-Za-z0-9_$\u0080-]/;
|
|
67
|
+
const tag = /\$(?:[A-Za-z_\u0080-][A-Za-z0-9_\u0080-]*)?\$/y;
|
|
68
|
+
/**
|
|
69
|
+
* Whether the `$` at `at` goes on a name (`a$b`): one that starts with a
|
|
70
|
+
* letter or `_`, as PostgreSQL's names do. After a number, or anything
|
|
71
|
+
* else, a `$` may open a `$tag$` body.
|
|
72
|
+
*/
|
|
73
|
+
function named(sql, at) {
|
|
74
|
+
let start = at;
|
|
75
|
+
while (start > 0 && identifier.test(sql[start - 1]))
|
|
76
|
+
start--;
|
|
77
|
+
return start < at && !/[0-9$]/.test(sql[start]);
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Where a PostgreSQL string continues, if it does: after its closing quote,
|
|
81
|
+
* space with a line break in it (comments allowed), then a quote (the
|
|
82
|
+
* scanner's `quotecontinue`). The index just past that quote, or undefined.
|
|
83
|
+
*/
|
|
84
|
+
function continued(sql, from) {
|
|
85
|
+
let i = from;
|
|
86
|
+
let broke = false;
|
|
87
|
+
for (;;) {
|
|
88
|
+
const c = sql[i];
|
|
89
|
+
if (c === "\n" || c === "\r")
|
|
90
|
+
(broke = true, i++);
|
|
91
|
+
else if (c === " " || c === "\t" || c === "\f" || (broke && c === "\v"))
|
|
92
|
+
i++;
|
|
93
|
+
else if (sql.startsWith("--", i)) {
|
|
94
|
+
const line = sql.slice(i).search(/[\n\r]/);
|
|
95
|
+
if (line < 0)
|
|
96
|
+
return undefined;
|
|
97
|
+
i += line;
|
|
98
|
+
}
|
|
99
|
+
else
|
|
100
|
+
return broke && c === "'" ? i + 1 : undefined;
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* The statement in `sql`, checked: its text without the `;` that ends it
|
|
105
|
+
* (and whatever follows), and its first keyword, uppercased. Throws
|
|
106
|
+
* `invalid` for none, more than one, or one maintenance can't run.
|
|
107
|
+
*/
|
|
108
|
+
export function statement(sql, dialect, mode) {
|
|
109
|
+
if (typeof sql !== "string")
|
|
110
|
+
throw invalid("The statement is SQL text.");
|
|
111
|
+
const postgres = dialect === "postgres";
|
|
112
|
+
let i = 0;
|
|
113
|
+
let keyword = "";
|
|
114
|
+
/** The statement's first two words, uppercased: what it is (`ALTER ROLE`). */
|
|
115
|
+
const words = [];
|
|
116
|
+
let end;
|
|
117
|
+
/** Parentheses open outside strings and comments: they balance, or it's no statement. */
|
|
118
|
+
let depth = 0;
|
|
119
|
+
const unterminated = (what) => invalid(`The statement has an unterminated ${what}.`);
|
|
120
|
+
/** Skips a comment at `i`; false when there's none. */
|
|
121
|
+
const comment = () => {
|
|
122
|
+
if (sql.startsWith("--", i)) {
|
|
123
|
+
// PostgreSQL ends a line comment at either; SQLite only at an LF.
|
|
124
|
+
const line = sql.slice(i).search(postgres ? /[\n\r]/ : /\n/);
|
|
125
|
+
i = line < 0 ? sql.length : i + line + 1;
|
|
126
|
+
return true;
|
|
127
|
+
}
|
|
128
|
+
if (!sql.startsWith("/*", i))
|
|
129
|
+
return false;
|
|
130
|
+
// PostgreSQL's block comments nest; SQLite's don't.
|
|
131
|
+
let depth = 0;
|
|
132
|
+
do {
|
|
133
|
+
if (sql.startsWith("/*", i))
|
|
134
|
+
(depth++, i += 2);
|
|
135
|
+
else if (sql.startsWith("*/", i))
|
|
136
|
+
(depth = postgres ? depth - 1 : 0, i += 2);
|
|
137
|
+
else if (i >= sql.length)
|
|
138
|
+
throw unterminated("comment");
|
|
139
|
+
else
|
|
140
|
+
i++;
|
|
141
|
+
} while (depth > 0);
|
|
142
|
+
return true;
|
|
143
|
+
};
|
|
144
|
+
/** Skips text quoted by `close` from i (just past the opening), a doubled `close` inside it. */
|
|
145
|
+
const quoted = (close, what, backslashes = false) => {
|
|
146
|
+
for (;;) {
|
|
147
|
+
if (i >= sql.length)
|
|
148
|
+
throw unterminated(what);
|
|
149
|
+
const c = sql[i++];
|
|
150
|
+
if (backslashes && c === "\\")
|
|
151
|
+
i++;
|
|
152
|
+
else if (c === close) {
|
|
153
|
+
if (sql[i] !== close || close === "]")
|
|
154
|
+
return;
|
|
155
|
+
i++;
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
};
|
|
159
|
+
while (i < sql.length && end === undefined) {
|
|
160
|
+
const c = sql[i];
|
|
161
|
+
const before = sql[i - 1] ?? "";
|
|
162
|
+
if (comment())
|
|
163
|
+
continue;
|
|
164
|
+
if (c === "'") {
|
|
165
|
+
// E'…' takes backslash escapes, in PostgreSQL; a plain string doesn't.
|
|
166
|
+
const escaped = postgres && /[eE]/.test(before) && !identifier.test(sql[i - 2] ?? "");
|
|
167
|
+
i++;
|
|
168
|
+
quoted("'", "string", escaped);
|
|
169
|
+
// An E'…' string goes on in a quote after a line break, escapes and all.
|
|
170
|
+
for (let next; escaped && (next = continued(sql, i)) !== undefined;) {
|
|
171
|
+
i = next;
|
|
172
|
+
quoted("'", "string", true);
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
else if (c === '"')
|
|
176
|
+
(i++, quoted('"', "quoted name"));
|
|
177
|
+
else if (!postgres && c === "`")
|
|
178
|
+
(i++, quoted("`", "quoted name"));
|
|
179
|
+
else if (!postgres && c === "[")
|
|
180
|
+
(i++, quoted("]", "quoted name"));
|
|
181
|
+
else if (postgres && c === "$" && !named(sql, i)) {
|
|
182
|
+
tag.lastIndex = i;
|
|
183
|
+
const open = tag.exec(sql)?.[0];
|
|
184
|
+
if (!open)
|
|
185
|
+
i++; // A parameter ($1), not a body.
|
|
186
|
+
else {
|
|
187
|
+
const close = sql.indexOf(open, i + open.length);
|
|
188
|
+
if (close < 0)
|
|
189
|
+
throw unterminated(`${open} body`);
|
|
190
|
+
i = close + open.length;
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
else if (c === ";")
|
|
194
|
+
end = i;
|
|
195
|
+
else if (c === "(")
|
|
196
|
+
(depth++, i++);
|
|
197
|
+
else if (c === ")") {
|
|
198
|
+
if (--depth < 0)
|
|
199
|
+
throw invalid("The statement closes a parenthesis it never opened.");
|
|
200
|
+
i++;
|
|
201
|
+
}
|
|
202
|
+
else {
|
|
203
|
+
word.lastIndex = i;
|
|
204
|
+
const found = !identifier.test(before) && word.exec(sql)?.[0];
|
|
205
|
+
if (found) {
|
|
206
|
+
keyword ||= found.toUpperCase();
|
|
207
|
+
if (words.length < 2)
|
|
208
|
+
words.push(found.toUpperCase());
|
|
209
|
+
i += found.length;
|
|
210
|
+
}
|
|
211
|
+
else
|
|
212
|
+
i++;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
if (end !== undefined) {
|
|
216
|
+
// Only space and comments may follow the statement's `;`.
|
|
217
|
+
for (i = end + 1; i < sql.length;) {
|
|
218
|
+
if (/\s/.test(sql[i]))
|
|
219
|
+
i++;
|
|
220
|
+
else if (!comment()) {
|
|
221
|
+
throw invalid("One statement at a time: send each on its own.");
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
if (!keyword)
|
|
226
|
+
throw invalid("There's no statement to run.");
|
|
227
|
+
if (depth)
|
|
228
|
+
throw invalid("The statement leaves a parenthesis open.");
|
|
229
|
+
if (postgres) {
|
|
230
|
+
const what = OUTLIVING[keyword] ? keyword : words.join(" ");
|
|
231
|
+
const said = OUTLIVING[what];
|
|
232
|
+
if (said)
|
|
233
|
+
throw invalid(`${what} can't run here: ${said}`);
|
|
234
|
+
}
|
|
235
|
+
if (TRANSACTIONS.has(keyword)) {
|
|
236
|
+
throw invalid(`${keyword} can't run here: the statement runs in a transaction of its own, which ` +
|
|
237
|
+
`commits it (or rolls it back) as a whole.`);
|
|
238
|
+
}
|
|
239
|
+
if (SESSION[dialect].has(keyword) || (mode === "write" && !postgres && keyword === "PRAGMA")) {
|
|
240
|
+
throw invalid(`${keyword} can't run here: it would change the connection, which the store's other ` +
|
|
241
|
+
`work shares, beyond this statement.`);
|
|
242
|
+
}
|
|
243
|
+
return { text: sql.slice(0, end ?? sql.length), keyword };
|
|
244
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Runs `sql` on `path`, read-only, in a child process; rejects with what
|
|
3
|
+
* SQLite said (`errcode`), `timeout` after `timeout` ms (the process
|
|
4
|
+
* killed), or `unstarted`.
|
|
5
|
+
*/
|
|
6
|
+
export declare function readApart(path: string, sql: string, params: unknown[], options?: {
|
|
7
|
+
timeout?: number;
|
|
8
|
+
bytes?: number;
|
|
9
|
+
}): Promise<Record<string, unknown>[] & {
|
|
10
|
+
cut?: true;
|
|
11
|
+
}>;
|
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
|
|
2
|
+
if (typeof path === "string" && /^\.\.?\//.test(path)) {
|
|
3
|
+
return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
|
|
4
|
+
return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
|
|
5
|
+
});
|
|
6
|
+
}
|
|
7
|
+
return path;
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* A maintenance read of a SQLite file, apart: in a child process of this
|
|
11
|
+
* same runtime (Deno, Node or Bun), on a read-only connection of its own.
|
|
12
|
+
* SQLite runs a statement synchronously and can't be stopped from another
|
|
13
|
+
* thread, so on the store's connection, or in a worker, a long one would go
|
|
14
|
+
* on burning a core and holding the WAL however long it takes. A process
|
|
15
|
+
* is killed at the read's timeout, statement and all: the process goes on,
|
|
16
|
+
* the read answers at its timeout, and nothing it set (a pragma, a
|
|
17
|
+
* temporary object) outlives it. Its rows come back within `bytes`.
|
|
18
|
+
*
|
|
19
|
+
* The process is the runtime itself, never the app: only when the
|
|
20
|
+
* executable is `deno`, `node` or `bun` (a compiled app runs as itself),
|
|
21
|
+
* and on Deno only with permission to run it already granted (it never
|
|
22
|
+
* asks). It gets no more than it needs: an environment of its own (no
|
|
23
|
+
* `NODE_OPTIONS`, nothing of the app's), and on Deno and Node permission to
|
|
24
|
+
* read the database's files alone. Where it can't start, the read says
|
|
25
|
+
* `unstarted` (and why), and the store reads on its own connection instead.
|
|
26
|
+
*/
|
|
27
|
+
import { failure } from "../../../runtime/errors.js";
|
|
28
|
+
/** Not literal, so no bundler resolves them where there are no processes. */
|
|
29
|
+
const CHILDREN = "node:child_process";
|
|
30
|
+
const PROCESS = "node:process";
|
|
31
|
+
/** The read, in the child: reads its request from stdin, answers on stdout. Rows past `bytes` aren't sent. */
|
|
32
|
+
const CODE = `
|
|
33
|
+
import process from "node:process";
|
|
34
|
+
let input = "";
|
|
35
|
+
for await (const chunk of process.stdin) input += chunk;
|
|
36
|
+
const bytesOf = (text) => Uint8Array.from(atob(text), (c) => c.charCodeAt(0));
|
|
37
|
+
const base64 = (bytes) => {
|
|
38
|
+
let text = "";
|
|
39
|
+
for (let i = 0; i < bytes.length; i += 0x8000) {
|
|
40
|
+
text += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
|
|
41
|
+
}
|
|
42
|
+
return btoa(text);
|
|
43
|
+
};
|
|
44
|
+
const revive = (_key, value) =>
|
|
45
|
+
value && typeof value === "object" && typeof value.$bytes === "string" ? bytesOf(value.$bytes)
|
|
46
|
+
: value && typeof value === "object" && typeof value.$bigint === "string" ? BigInt(value.$bigint)
|
|
47
|
+
: value;
|
|
48
|
+
const plain = (_key, value) =>
|
|
49
|
+
typeof value === "bigint" ? { $bigint: value.toString() }
|
|
50
|
+
: value instanceof Uint8Array ? { $bytes: base64(value) }
|
|
51
|
+
: value;
|
|
52
|
+
const { path, sql, params, bytes } = JSON.parse(input, revive);
|
|
53
|
+
let db;
|
|
54
|
+
try {
|
|
55
|
+
if ("Bun" in globalThis) {
|
|
56
|
+
const { Database } = await import("bun:sqlite");
|
|
57
|
+
db = new Database(path, { readonly: true });
|
|
58
|
+
} else {
|
|
59
|
+
const { DatabaseSync } = await import("node:sqlite");
|
|
60
|
+
db = new DatabaseSync(path, { readOnly: true });
|
|
61
|
+
}
|
|
62
|
+
db.exec("PRAGMA query_only = 1");
|
|
63
|
+
const rows = [];
|
|
64
|
+
let used = 0;
|
|
65
|
+
let cut = false;
|
|
66
|
+
for (const row of db.prepare(sql).all(...params)) {
|
|
67
|
+
const text = JSON.stringify({ ...row }, plain);
|
|
68
|
+
used += new TextEncoder().encode(text).length + 1;
|
|
69
|
+
if (bytes !== null && used > bytes) {
|
|
70
|
+
cut = true;
|
|
71
|
+
break;
|
|
72
|
+
}
|
|
73
|
+
rows.push(text);
|
|
74
|
+
}
|
|
75
|
+
process.stdout.write('{"cut":' + cut + ',"rows":[' + rows.join(",") + "]}");
|
|
76
|
+
} catch (error) {
|
|
77
|
+
process.stdout.write(JSON.stringify({
|
|
78
|
+
error: { message: String(error?.message ?? error), errcode: error?.errcode ?? error?.errno },
|
|
79
|
+
}));
|
|
80
|
+
} finally {
|
|
81
|
+
try { db?.close(); } catch {}
|
|
82
|
+
}
|
|
83
|
+
`;
|
|
84
|
+
const SOURCE = `data:text/javascript;base64,${btoa(CODE)}`;
|
|
85
|
+
/** The runtimes a read's process may be: the executable's name, without `.exe`. */
|
|
86
|
+
const RUNTIMES = new Set(["deno", "node", "bun"]);
|
|
87
|
+
/**
|
|
88
|
+
* How this runtime runs the read, reading `files` alone where it can say
|
|
89
|
+
* so: Deno and Node grant it read access to them and nothing else.
|
|
90
|
+
*/
|
|
91
|
+
const running = (runtime, files) => runtime === "deno"
|
|
92
|
+
? ["run", "--quiet", "--no-prompt", "--no-config", `--allow-read=${files.join(",")}`, SOURCE]
|
|
93
|
+
: runtime === "bun"
|
|
94
|
+
? ["-e", CODE]
|
|
95
|
+
: [
|
|
96
|
+
"--no-warnings",
|
|
97
|
+
"--permission",
|
|
98
|
+
...files.map((file) => `--allow-fs-read=${file}`),
|
|
99
|
+
"--input-type=module",
|
|
100
|
+
"-e",
|
|
101
|
+
CODE,
|
|
102
|
+
];
|
|
103
|
+
/** A process that couldn't start here: then no read runs apart, and `why` says so. */
|
|
104
|
+
const unstarted = (why, cause) => Object.assign(new Error(`The read's process didn't start: ${why}.`), {
|
|
105
|
+
code: "unstarted",
|
|
106
|
+
why,
|
|
107
|
+
cause,
|
|
108
|
+
});
|
|
109
|
+
const base64 = (bytes) => {
|
|
110
|
+
let text = "";
|
|
111
|
+
for (let i = 0; i < bytes.length; i += 0x8000) {
|
|
112
|
+
text += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
|
|
113
|
+
}
|
|
114
|
+
return btoa(text);
|
|
115
|
+
};
|
|
116
|
+
const plain = (_key, value) => typeof value === "bigint"
|
|
117
|
+
? { $bigint: value.toString() }
|
|
118
|
+
: value instanceof Uint8Array
|
|
119
|
+
? { $bytes: base64(value) }
|
|
120
|
+
: value;
|
|
121
|
+
const revive = (_key, value) => {
|
|
122
|
+
const it = value;
|
|
123
|
+
if (it && typeof it === "object" && typeof it.$bytes === "string") {
|
|
124
|
+
return Uint8Array.from(atob(it.$bytes), (c) => c.charCodeAt(0));
|
|
125
|
+
}
|
|
126
|
+
if (it && typeof it === "object" && typeof it.$bigint === "string")
|
|
127
|
+
return BigInt(it.$bigint);
|
|
128
|
+
return value;
|
|
129
|
+
};
|
|
130
|
+
let started;
|
|
131
|
+
/** Whether, and how, this process can start the read's: why not, else the runtime it starts. */
|
|
132
|
+
async function look() {
|
|
133
|
+
const [children, process] = await Promise.all([import(__rewriteRelativeImportExtension(CHILDREN)), import(__rewriteRelativeImportExtension(PROCESS))]).catch(() => [undefined, undefined]);
|
|
134
|
+
if (!children || !process)
|
|
135
|
+
return undefined;
|
|
136
|
+
const proc = process.default ?? process;
|
|
137
|
+
const execPath = String(proc.execPath);
|
|
138
|
+
const runtime = execPath.split(/[\\/]/).pop().replace(/\.exe$/i, "").toLowerCase();
|
|
139
|
+
// Deno asks for a permission it lacks, mid-request: only one granted already is used.
|
|
140
|
+
const deno = globalThis.Deno;
|
|
141
|
+
const granted = (d) => (deno?.permissions?.querySync?.(d).state ?? "granted") === "granted";
|
|
142
|
+
const env = {};
|
|
143
|
+
if (proc.platform === "win32" && granted({ name: "env", variable: "SystemRoot" })) {
|
|
144
|
+
const root = proc.env.SystemRoot ?? proc.env.SYSTEMROOT;
|
|
145
|
+
if (root)
|
|
146
|
+
env.SystemRoot = root;
|
|
147
|
+
}
|
|
148
|
+
const here = { spawn: children.spawn, execPath, env, runtime };
|
|
149
|
+
if (!RUNTIMES.has(runtime)) {
|
|
150
|
+
return { ...here, why: `this program (${runtime}) isn't deno, node or bun, so not itself` };
|
|
151
|
+
}
|
|
152
|
+
if (!granted({ name: "run", command: execPath })) {
|
|
153
|
+
return { ...here, why: "deno has no permission to run itself (--allow-run)" };
|
|
154
|
+
}
|
|
155
|
+
return here;
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Runs `sql` on `path`, read-only, in a child process; rejects with what
|
|
159
|
+
* SQLite said (`errcode`), `timeout` after `timeout` ms (the process
|
|
160
|
+
* killed), or `unstarted`.
|
|
161
|
+
*/
|
|
162
|
+
export async function readApart(path, sql, params, options = {}) {
|
|
163
|
+
const here = await (started ??= look());
|
|
164
|
+
if (!here)
|
|
165
|
+
throw unstarted("this runtime starts no processes");
|
|
166
|
+
if (here.why)
|
|
167
|
+
throw unstarted(here.why);
|
|
168
|
+
let child;
|
|
169
|
+
try {
|
|
170
|
+
child = here.spawn(here.execPath, running(here.runtime, [path, `${path}-wal`, `${path}-shm`]), {
|
|
171
|
+
stdio: ["pipe", "pipe", "ignore"],
|
|
172
|
+
env: here.env,
|
|
173
|
+
});
|
|
174
|
+
}
|
|
175
|
+
catch (error) {
|
|
176
|
+
throw unstarted("it couldn't be started", error);
|
|
177
|
+
}
|
|
178
|
+
const { timeout, bytes } = options;
|
|
179
|
+
return await new Promise((resolve, reject) => {
|
|
180
|
+
const chunks = [];
|
|
181
|
+
let settled = false;
|
|
182
|
+
let timer;
|
|
183
|
+
const settle = (done) => {
|
|
184
|
+
if (settled)
|
|
185
|
+
return;
|
|
186
|
+
settled = true;
|
|
187
|
+
clearTimeout(timer);
|
|
188
|
+
done();
|
|
189
|
+
};
|
|
190
|
+
child.on("error", (error) => settle(() => reject(unstarted("it couldn't be started", error))));
|
|
191
|
+
child.stdout.on("data", (chunk) => chunks.push(chunk));
|
|
192
|
+
child.on("close", (code) => settle(() => {
|
|
193
|
+
const text = new TextDecoder().decode(chunks.reduce((all, chunk) => {
|
|
194
|
+
const joined = new Uint8Array(all.length + chunk.length);
|
|
195
|
+
joined.set(all);
|
|
196
|
+
joined.set(chunk, all.length);
|
|
197
|
+
return joined;
|
|
198
|
+
}, new Uint8Array()));
|
|
199
|
+
let answer;
|
|
200
|
+
try {
|
|
201
|
+
answer = JSON.parse(text, revive);
|
|
202
|
+
}
|
|
203
|
+
catch {
|
|
204
|
+
return reject(new Error(`The read's process ended without an answer (exit ${code}).`));
|
|
205
|
+
}
|
|
206
|
+
if (answer.rows) {
|
|
207
|
+
return resolve(answer.cut ? Object.assign(answer.rows, { cut: true }) : answer.rows);
|
|
208
|
+
}
|
|
209
|
+
reject(Object.assign(new Error(answer.error.message), answer.error));
|
|
210
|
+
}));
|
|
211
|
+
if (timeout !== undefined && Number.isFinite(timeout) && timeout > 0) {
|
|
212
|
+
timer = setTimeout(() => settle(() => {
|
|
213
|
+
child.kill("SIGKILL");
|
|
214
|
+
reject(failure("timeout", `The statement ran past its timeout (${timeout} ms).`));
|
|
215
|
+
}), timeout);
|
|
216
|
+
}
|
|
217
|
+
child.stdin.end(JSON.stringify({ path, sql, params, bytes: bytes ?? null }, plain));
|
|
218
|
+
});
|
|
219
|
+
}
|
|
@@ -10,7 +10,11 @@
|
|
|
10
10
|
*
|
|
11
11
|
* The owner writes through one connection and reads committed state through a
|
|
12
12
|
* second one. WAL mode lets any SQLite client read the file while it runs, and
|
|
13
|
-
* each collection is also a SQL view (`SELECT * FROM message`).
|
|
13
|
+
* each collection is also a SQL view (`SELECT * FROM message`). The store
|
|
14
|
+
* names its own tables in `main`, so nothing temporary stands in for them.
|
|
15
|
+
* Maintenance SQL (`inspect`, a transaction's `execute`) runs one statement
|
|
16
|
+
* as it is: a read apart, in a process of its own on a read-only connection
|
|
17
|
+
* (apart.ts), a write in a maintenance transaction on the writer.
|
|
14
18
|
*/
|
|
15
19
|
type SQLInputValue = null | number | bigint | string | Uint8Array;
|
|
16
20
|
/** What the store uses of a SQLite database: `node:sqlite`'s `DatabaseSync` and Bun's `Database` both fit. */
|
|
@@ -31,7 +35,7 @@ export type SqliteStatement = {
|
|
|
31
35
|
};
|
|
32
36
|
};
|
|
33
37
|
import type { JSONSchema } from "../../../runtime/define.js";
|
|
34
|
-
import { type IndexSpec, type Store } from "../../../runtime/store.js";
|
|
38
|
+
import { type IndexSpec, type Inspected, type Store } from "../../../runtime/store.js";
|
|
35
39
|
export declare function sqliteStore(options: {
|
|
36
40
|
path: string;
|
|
37
41
|
/** Each connection's page cache (64 MiB) and memory-mapped reads (256 MiB). */
|
|
@@ -39,9 +43,19 @@ export declare function sqliteStore(options: {
|
|
|
39
43
|
mmapMiB?: number;
|
|
40
44
|
/** Opens a connection (two are opened: one writes, one reads). Default: the runtime's own SQLite. */
|
|
41
45
|
open?: (path: string) => SqliteDatabase | Promise<SqliteDatabase>;
|
|
46
|
+
/** Maintenance reads at once, each a process of its own (2): past that, `busy`. */
|
|
47
|
+
maintenance?: {
|
|
48
|
+
connections?: number;
|
|
49
|
+
};
|
|
42
50
|
}): Promise<Store & {
|
|
43
51
|
/** Exposes each collection as a SQL view of its schema's top-level fields. */
|
|
44
52
|
describe(collections: Record<string, JSONSchema>): void;
|
|
45
53
|
index(collections: Record<string, IndexSpec[]>): void;
|
|
54
|
+
/** Runs one read-only statement, for inspection and maintenance. */
|
|
55
|
+
inspect(sql: string, params?: unknown[], options?: {
|
|
56
|
+
limit?: number;
|
|
57
|
+
timeout?: number;
|
|
58
|
+
bytes?: number;
|
|
59
|
+
}): Promise<Inspected>;
|
|
46
60
|
}>;
|
|
47
61
|
export {};
|