Skip to content

History / Adapter: Indirect indices

Revisions

  • Updated docs.

    @uhop uhop committed Apr 23, 2026
  • Rename colon-bearing filenames to fullwidth colon (Windows fix) + update wiki for 3.7.0. **Windows-safe page names.** Filenames like `Adapter:-Hooks.md` break `git clone` / checkout on Windows (the filesystem reserves ASCII `:`). Replaced `:` with U+FF1A FULLWIDTH COLON `:` in 13 page filenames: Adapter:-Batch-builders.md Adapter:-CRUD-methods.md Adapter:-Constructor-options.md Adapter:-Hooks.md Adapter:-Indirect-indices.md Adapter:-Mass-methods.md Adapter:-Raw-marker.md Adapter:-Transaction-auto-upgrade.md Expressions:-Condition-builder.md Expressions:-Filter-builder.md Expressions:-Projection-builder.md Expressions:-Update-builder.md Migration:-v2-to-v3.md All intra-wiki cross-references rewritten (~79 sites). Display in GitHub Wiki is "Adapter: Constructor options" — fullwidth colon is slightly wider but reads the same and is filesystem-safe on Linux / macOS / Windows. **Content updates for 3.7.0.** - **`Release-notes.md`** — new `3.7.0 — unreleased` entry covering filter-grammar flip, option renames (`fFilter` → `filter`, `filter` → `search`, `buildFilter` → `buildSearch`), polymorphic clause shape, `planTable`/`ensureTable` split, `buildKey` simplification (default children, `{self}`, `{partial}`, drop `kind: 'exact'`), `putItems` versioning, descriptor hiding, and additions (`typeField`, `getListUnder`, `filterable {ops, type}`, `stampCreatedAtISO` / `stampCreatedAtEpoch`, index `pk`/`sk` string shorthand, shorthand declaration knobs, example refresh + TS mirror). - **`Adapter:-Constructor-options.md`** — rewritten from 7 options to the full 3.7.0 surface (~20 options) grouped by purpose (required, technical-fields machinery, structural key, type tags, indices, filter grammar, text search, concurrency, cascade gate, descriptor, projection + hooks). Added an end-to-end "typical hierarchical adapter" example. - **`Adapter:-CRUD-methods.md`** — renamed `getAll` / `getAllByParams` to `getList` / `getListByParams` (old names were deprecated in 3.1.2); added `getListUnder` sugar, `buildKey` with new shapes, `edit` and `editListByParams` (landed 3.3.0), `typeOf`, and `applyFilter`. Expanded `ListOptions` to match the 3.7.0 shape. - **`HTTP-handler.md`** — URL grammar updated from `?filter=` to `?<op>-<field>=` + `?search=`. Route table reflects `putItems` / `deleteListByParams` / etc. names. - **`REST-core.md`** — split `parseFilter` (now structured clauses) and `parseSearch` (free-form search-text). New sub-section documenting the `<op>-<field>=<value>` grammar. - **`Expressions:-Filter-builder.md`** — rewritten for `buildSearch` (was `buildFilter` pre-3.7.0). Explicit 3.7.0-rename callout. `buildFilterByExample` doc unchanged. - **Other pages** (`Adapter.md`, `Concepts.md`, `Getting-started.md`, `Home.md`, `Adapter:-Mass-methods.md`, `Adapter:-Hooks.md`, `Adapter:-Indirect-indices.md`, `Expressions:-Condition-builder.md`, `Expressions:-Projection-builder.md`, `Batch-and-transactions.md`, `Mass-operations.md`, `Migration:-v2-to-v3.md`) — mechanical rename of the still-present `getAll` / `putAll` / `cloneAllByParams` / `moveAllByParams` / `deleteAllByParams` / `buildFilter` identifiers to the post-3.1.2 names. **Not covered (Phase 7b — deferred).** New recipe pages for the F10 sparse-GSI patterns + other hierarchical recipes. Wait until this foundation lands, then build on top. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

    @uhop uhop committed Apr 23, 2026