dirsql 0.4.132__tar.gz → 0.4.133__tar.gz

{dirsql-0.4.132 → dirsql-0.4.133}/Cargo.lock

@@ -573,7 +573,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql"
-version = "0.4.132"
+version = "0.4.133"
 dependencies = [
  "assert_cmd",
  "axum",
@@ -625,7 +625,7 @@ dependencies = [
 
 [[package]]
 name = "dirsql-py-ext"
-version = "0.4.132"
+version = "0.4.133"
 dependencies = [
  "dirsql",
  "pyo3",

{dirsql-0.4.132 → dirsql-0.4.133}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.4.132
+Version: 0.4.133
 Requires-Dist: bin-shim>=0.1
 Summary: Ephemeral SQL index over a local directory
 Keywords: sql,filesystem,directory,sqlite,index

{dirsql-0.4.132/packages/rust → dirsql-0.4.133}/docs/reference/sdk.md

@@ -212,7 +212,7 @@ await db.query(sql: str, params: Sequence | Mapping | None = None) -> list[dict]
 ```
 
 ```typescript [TypeScript]
-await db.query(sql: string) -> Record<string, unknown>[]
+await db.query(sql: string, params?: unknown[] | Record<string, unknown> | null) -> Record<string, unknown>[]
 // Runs on the libuv threadpool; the JS event loop stays responsive.
 ```
 
@@ -227,8 +227,9 @@ Executes a SQL query and returns rows keyed by column name.
 
 **Bind parameters.** `params` reaches SQLite's own parameter binding; the
 values never enter the SQL text, so text holding quotes needs no escaping.
-A sequence fills `?` placeholders in order; a mapping fills `:name`
-placeholders, keyed by the name without its prefix. It works for path-tables
+A sequence (a TypeScript array) fills `?` placeholders in order; a mapping
+(a TypeScript plain object) fills `:name`, `@name` and `$name` placeholders,
+keyed by the name without its prefix. It works for path-tables
 and declared tables alike:
 
 ::: code-group
@@ -241,6 +242,15 @@ await db.query(
 await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ("ann", 2024))
 ```
 
+```typescript [TypeScript]
+await db.query(
+  "SELECT path FROM './*.json' WHERE content ->> 'advice' = :advice",
+  { advice: text },
+);
+await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ["ann", 2024]);
+// queryOrdered takes params the same way.
+```
+
 ```rust [Rust]
 use dirsql::{Params, Value};
 use std::collections::HashMap;
@@ -259,20 +269,23 @@ db.query_with(
 
 :::
 
-TypeScript does not take bind parameters yet.
-
 - Values bind as SQLite's native types. Python accepts `None`, `int`
   (`bool` binds as `0`/`1`), `float`, `str`, `bytes` and `bytearray`;
   anything else raises `TypeError` rather than being stringified, and an
-  `int` outside the signed 64-bit range raises `OverflowError`. Rust binds a
-  `Value`.
+  `int` outside the signed 64-bit range raises `OverflowError`. TypeScript
+  accepts `null`, `number` (an integral value binds as an INTEGER, any other
+  as a REAL, so `1.0` binds as `1`), `bigint`, `boolean` (`0`/`1`), `string`,
+  and `Buffer` / `Uint8Array`; anything else, `undefined` included, rejects
+  with a `TypeError`, and a `bigint` outside the signed 64-bit range with a
+  `RangeError`. Rust binds a `Value`.
 - The params must fit the placeholders exactly, or the query fails with an
   error naming the problem: a wrong count for a sequence, a placeholder name
   the mapping lacks, a mapping key no placeholder uses, or a sequence for
   named placeholders (and a mapping for `?`). Python raises a
   `RuntimeError` for these, and a `TypeError` when `params` is neither a
-  sequence nor a mapping (a `str` counts as neither). Rust returns
-  `DbError::Params`.
+  sequence nor a mapping (a `str` counts as neither). TypeScript rejects
+  with an `Error` for these, and a `TypeError` when `params` is neither an
+  array nor a plain object. Rust returns `DbError::Params`.
 - Without `params`, a statement with placeholders fails the same way: a
   placeholder is never left unbound.
 
@@ -311,11 +324,12 @@ round-trips.
 ::: code-group
 
 ```typescript [TypeScript]
-await db.queryOrdered(sql: string) -> { columns: string[]; rows: Record<string, unknown>[] }
+await db.queryOrdered(sql: string, params?: unknown[] | Record<string, unknown> | null) -> { columns: string[]; rows: Record<string, unknown>[] }
 ```
 
 ```rust [Rust]
 db.query_ordered(sql: &str) -> Result<QueryResult>   // QueryResult { columns, rows }
+db.query_ordered_with(sql: &str, params: &Params) -> Result<QueryResult>
 ```
 
 :::

{dirsql-0.4.132 → dirsql-0.4.133}/packages/python/Cargo.toml

@@ -4,7 +4,7 @@ name = "dirsql-py-ext"
 # pypi/maturin handler can rewrite it via `write-version` before
 # `maturin build`. `pyproject.toml` declares `dynamic = ["version"]`
 # and maturin reads this field. Mirrors `packages/rust/Cargo.toml`.
-version = "0.4.132"
+version = "0.4.133"
 # abi3 note: the `abi3-py310` pyo3 feature (below) builds ONE stable-ABI
 # `cp310-abi3` wheel per platform that loads on every CPython >= 3.10
 # (matching `pyproject.toml`'s `requires-python = ">=3.10"`), instead of

{dirsql-0.4.132 → dirsql-0.4.133}/packages/python/docs/reference/sdk.md

@@ -212,7 +212,7 @@ await db.query(sql: str, params: Sequence | Mapping | None = None) -> list[dict]
 ```
 
 ```typescript [TypeScript]
-await db.query(sql: string) -> Record<string, unknown>[]
+await db.query(sql: string, params?: unknown[] | Record<string, unknown> | null) -> Record<string, unknown>[]
 // Runs on the libuv threadpool; the JS event loop stays responsive.
 ```
 
@@ -227,8 +227,9 @@ Executes a SQL query and returns rows keyed by column name.
 
 **Bind parameters.** `params` reaches SQLite's own parameter binding; the
 values never enter the SQL text, so text holding quotes needs no escaping.
-A sequence fills `?` placeholders in order; a mapping fills `:name`
-placeholders, keyed by the name without its prefix. It works for path-tables
+A sequence (a TypeScript array) fills `?` placeholders in order; a mapping
+(a TypeScript plain object) fills `:name`, `@name` and `$name` placeholders,
+keyed by the name without its prefix. It works for path-tables
 and declared tables alike:
 
 ::: code-group
@@ -241,6 +242,15 @@ await db.query(
 await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ("ann", 2024))
 ```
 
+```typescript [TypeScript]
+await db.query(
+  "SELECT path FROM './*.json' WHERE content ->> 'advice' = :advice",
+  { advice: text },
+);
+await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ["ann", 2024]);
+// queryOrdered takes params the same way.
+```
+
 ```rust [Rust]
 use dirsql::{Params, Value};
 use std::collections::HashMap;
@@ -259,20 +269,23 @@ db.query_with(
 
 :::
 
-TypeScript does not take bind parameters yet.
-
 - Values bind as SQLite's native types. Python accepts `None`, `int`
   (`bool` binds as `0`/`1`), `float`, `str`, `bytes` and `bytearray`;
   anything else raises `TypeError` rather than being stringified, and an
-  `int` outside the signed 64-bit range raises `OverflowError`. Rust binds a
-  `Value`.
+  `int` outside the signed 64-bit range raises `OverflowError`. TypeScript
+  accepts `null`, `number` (an integral value binds as an INTEGER, any other
+  as a REAL, so `1.0` binds as `1`), `bigint`, `boolean` (`0`/`1`), `string`,
+  and `Buffer` / `Uint8Array`; anything else, `undefined` included, rejects
+  with a `TypeError`, and a `bigint` outside the signed 64-bit range with a
+  `RangeError`. Rust binds a `Value`.
 - The params must fit the placeholders exactly, or the query fails with an
   error naming the problem: a wrong count for a sequence, a placeholder name
   the mapping lacks, a mapping key no placeholder uses, or a sequence for
   named placeholders (and a mapping for `?`). Python raises a
   `RuntimeError` for these, and a `TypeError` when `params` is neither a
-  sequence nor a mapping (a `str` counts as neither). Rust returns
-  `DbError::Params`.
+  sequence nor a mapping (a `str` counts as neither). TypeScript rejects
+  with an `Error` for these, and a `TypeError` when `params` is neither an
+  array nor a plain object. Rust returns `DbError::Params`.
 - Without `params`, a statement with placeholders fails the same way: a
   placeholder is never left unbound.
 
@@ -311,11 +324,12 @@ round-trips.
 ::: code-group
 
 ```typescript [TypeScript]
-await db.queryOrdered(sql: string) -> { columns: string[]; rows: Record<string, unknown>[] }
+await db.queryOrdered(sql: string, params?: unknown[] | Record<string, unknown> | null) -> { columns: string[]; rows: Record<string, unknown>[] }
 ```
 
 ```rust [Rust]
 db.query_ordered(sql: &str) -> Result<QueryResult>   // QueryResult { columns, rows }
+db.query_ordered_with(sql: &str, params: &Params) -> Result<QueryResult>
 ```
 
 :::

{dirsql-0.4.132 → dirsql-0.4.133}/packages/rust/Cargo.toml

@@ -6,7 +6,7 @@ description = "Ephemeral SQL index over a local directory"
 # version stays for the binding crates (publish = false). The literal
 # intentionally lags the published version: putitoutthere rewrites it to
 # the planned release version at build time and never commits it back.
-version = "0.4.132"
+version = "0.4.133"
 edition.workspace = true
 # Literal `license` (not `license.workspace = true`) because
 # putitoutthere's preflight check reads `[package].license` directly

{dirsql-0.4.132 → dirsql-0.4.133/packages/rust}/docs/reference/sdk.md

@@ -212,7 +212,7 @@ await db.query(sql: str, params: Sequence | Mapping | None = None) -> list[dict]
 ```
 
 ```typescript [TypeScript]
-await db.query(sql: string) -> Record<string, unknown>[]
+await db.query(sql: string, params?: unknown[] | Record<string, unknown> | null) -> Record<string, unknown>[]
 // Runs on the libuv threadpool; the JS event loop stays responsive.
 ```
 
@@ -227,8 +227,9 @@ Executes a SQL query and returns rows keyed by column name.
 
 **Bind parameters.** `params` reaches SQLite's own parameter binding; the
 values never enter the SQL text, so text holding quotes needs no escaping.
-A sequence fills `?` placeholders in order; a mapping fills `:name`
-placeholders, keyed by the name without its prefix. It works for path-tables
+A sequence (a TypeScript array) fills `?` placeholders in order; a mapping
+(a TypeScript plain object) fills `:name`, `@name` and `$name` placeholders,
+keyed by the name without its prefix. It works for path-tables
 and declared tables alike:
 
 ::: code-group
@@ -241,6 +242,15 @@ await db.query(
 await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ("ann", 2024))
 ```
 
+```typescript [TypeScript]
+await db.query(
+  "SELECT path FROM './*.json' WHERE content ->> 'advice' = :advice",
+  { advice: text },
+);
+await db.query("SELECT * FROM notes WHERE author = ? AND year = ?", ["ann", 2024]);
+// queryOrdered takes params the same way.
+```
+
 ```rust [Rust]
 use dirsql::{Params, Value};
 use std::collections::HashMap;
@@ -259,20 +269,23 @@ db.query_with(
 
 :::
 
-TypeScript does not take bind parameters yet.
-
 - Values bind as SQLite's native types. Python accepts `None`, `int`
   (`bool` binds as `0`/`1`), `float`, `str`, `bytes` and `bytearray`;
   anything else raises `TypeError` rather than being stringified, and an
-  `int` outside the signed 64-bit range raises `OverflowError`. Rust binds a
-  `Value`.
+  `int` outside the signed 64-bit range raises `OverflowError`. TypeScript
+  accepts `null`, `number` (an integral value binds as an INTEGER, any other
+  as a REAL, so `1.0` binds as `1`), `bigint`, `boolean` (`0`/`1`), `string`,
+  and `Buffer` / `Uint8Array`; anything else, `undefined` included, rejects
+  with a `TypeError`, and a `bigint` outside the signed 64-bit range with a
+  `RangeError`. Rust binds a `Value`.
 - The params must fit the placeholders exactly, or the query fails with an
   error naming the problem: a wrong count for a sequence, a placeholder name
   the mapping lacks, a mapping key no placeholder uses, or a sequence for
   named placeholders (and a mapping for `?`). Python raises a
   `RuntimeError` for these, and a `TypeError` when `params` is neither a
-  sequence nor a mapping (a `str` counts as neither). Rust returns
-  `DbError::Params`.
+  sequence nor a mapping (a `str` counts as neither). TypeScript rejects
+  with an `Error` for these, and a `TypeError` when `params` is neither an
+  array nor a plain object. Rust returns `DbError::Params`.
 - Without `params`, a statement with placeholders fails the same way: a
   placeholder is never left unbound.
 
@@ -311,11 +324,12 @@ round-trips.
 ::: code-group
 
 ```typescript [TypeScript]
-await db.queryOrdered(sql: string) -> { columns: string[]; rows: Record<string, unknown>[] }
+await db.queryOrdered(sql: string, params?: unknown[] | Record<string, unknown> | null) -> { columns: string[]; rows: Record<string, unknown>[] }
 ```
 
 ```rust [Rust]
 db.query_ordered(sql: &str) -> Result<QueryResult>   // QueryResult { columns, rows }
+db.query_ordered_with(sql: &str, params: &Params) -> Result<QueryResult>
 ```
 
 :::