dirsql 0.4.144 → 0.4.146

package/docs/reference/cli.md

@@ -128,6 +128,11 @@ several lines, and **anything longer than 60 characters is truncated with
 `…`** so one column cannot set the width of every row. `--format json`
 returns the values unaltered.
 
+A text value that is not valid UTF-8 (`CAST(x'ff' AS TEXT)`, `char(55296)`)
+fails the query in every format, with an error naming its column, rather
+than printing replacement characters. Wrap it in `hex()` or `CAST(… AS BLOB)`
+to read its bytes.
+
 Laying the table out to the terminal's width, and paging a long result, are
 both out of scope; pipe to `less` for the latter.
 

package/docs/reference/config.md

@@ -224,10 +224,10 @@ what its required `on-file` command emits — dirsql injects nothing (see
 | Key | Required | Description |
 |---|---|---|
 | `name` | yes | The table's SQL name — the name you query it by. Declared, never derived from `ddl`: dirsql does not read the DDL text. The `ddl` must create a table by this name; if it doesn't, loading fails. |
-| `ddl` | yes | A SQL batch, run verbatim — any number of statements. It must create a table called `name`; that table holds the file rows, and only the columns it declares are kept (keys the `on-file` command emits that are not declared are dropped). The rest of the batch is yours: indexes, virtual tables, triggers. See [Batch `ddl`](#batch-ddl). |
+| `ddl` | yes | A SQL batch, run verbatim — any number of statements. It must create a table called `name`; that table holds the file rows, and only the columns it declares are kept (a key the `on-file` command emits fills the declared column it names, compared case-insensitively for ASCII letters as SQL identifiers are; a key naming no declared column is dropped). The rest of the batch is yours: indexes, virtual tables, triggers. See [Batch `ddl`](#batch-ddl). |
 | `glob` | yes | Glob pattern, [anchored](#glob-anchor) at the config file's directory, under the [one glob rule](#glob-rule): `*` matches one level, `**` any depth. Every table whose glob matches a file receives that file's rows — a file can populate multiple tables. A `{name}` is a literal, as in bash and a path-table; the [glob page](./glob.md) has the syntax. |
 | `on-file` | **yes** | A command run once per table, with every matched file's absolute path appended as a trailing argument; its stdout (one JSON object per line) is the table's rows. Must be non-empty. A `[[table]]` with no `on-file` is a load error (see [parse errors](#parse-errors)). See [Command hooks](./hooks.md#on-file). |
-| `strict` | no (default `false`) | When `true`, rows whose keys do not exactly match the declared columns are rejected with an error: extra keys error, and every declared column must be supplied by the `on-file` output. When `false`, extra keys are dropped and missing columns become `NULL`. |
+| `strict` | no (default `false`) | When `true`, rows whose keys do not match the declared columns (compared case-insensitively, as above) are rejected with an error: extra keys error, and every declared column must be supplied by the `on-file` output. When `false`, extra keys are dropped and missing columns become `NULL`. |
 
 `on-file` is required because a table's rows come from nowhere else. dirsql
 does not read file contents or merge filesystem facts on your behalf: the

package/docs/reference/sdk.md

@@ -223,7 +223,9 @@ db.query_with(sql: &str, params: &Params) -> Result<Vec<Row>>
 
 :::
 
-Executes a SQL query and returns rows keyed by column name.
+Executes a SQL query and returns rows keyed by column name. If a result repeats
+a column name, later occurrences receive `:N` suffixes (for example, `a` and
+`a:1`); suffixes avoid names already present in the result.
 
 **Bind parameters.** `params` reaches SQLite's own parameter binding; the
 values never enter the SQL text, so text holding quotes needs no escaping.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.4.144",
+  "version": "0.4.146",
   "description": "Ephemeral SQL index over a local directory",
   "license": "MIT",
   "repository": "https://github.com/thekevinscott/dirsql",
@@ -221,10 +221,10 @@
     ]
   },
   "optionalDependencies": {
-    "@dirsql/lib-linux-x64-gnu": "0.4.144",
-    "@dirsql/lib-linux-arm64-gnu": "0.4.144",
-    "@dirsql/lib-darwin-x64": "0.4.144",
-    "@dirsql/lib-darwin-arm64": "0.4.144",
-    "@dirsql/lib-win32-x64-msvc": "0.4.144"
+    "@dirsql/lib-linux-x64-gnu": "0.4.146",
+    "@dirsql/lib-linux-arm64-gnu": "0.4.146",
+    "@dirsql/lib-darwin-x64": "0.4.146",
+    "@dirsql/lib-darwin-arm64": "0.4.146",
+    "@dirsql/lib-win32-x64-msvc": "0.4.146"
   }
 }