@allourthings/core 0.1.11 → 1.0.1

package/README.md

@@ -1,14 +1,7 @@
 # allourthings-core
 
-Rust storage library for [AllOurThings](https://allourthings.io) — an AI-powered household inventory system.
+Rust storage library for [AllOurThings](https://allourthings.io) — an AI-powered inventory system.
 
-Shared across clients via platform-specific bindings:
-
-| Consumer | Distribution |
-|---|---|
-| MCP server (Node.js) | npm — `@allourthings/core` |
-| iOS app | Swift Package Manager — binary XCFramework |
-| Android app *(planned)* | crates.io — `allourthings-core` |
 
 ## Storage format
 
@@ -18,7 +11,40 @@ Each item is a directory containing a single JSON file:
 <data-dir>/items/<slug>-<id>/item.json
 ```
 
-Required fields: `id`, `name`, `created_at`, `updated_at`. All other fields are optional and round-trip without modification.
+The directory name is `<slug>-<id>` where `<slug>` is a URL-safe lowercase version of the item name (max 50 chars) and `<id>` is an 8-character lowercase hex string. 
+
+Required fields: `id`, `name`, `created_at`, `updated_at`. Well-known optional fields include `category`, `subcategory`, `tags`, and `attachments`. Any additional fields are preserved and round-trip without modification.
+
+Attachment files (PDFs, images, etc.) are stored alongside `item.json` in the same directory.
+
+
+## Query cache
+
+`CatalogStore` supports an optional SQLite query cache for efficient filtering.
+
+The cache is write-through — every mutation (`add_item`, `update_item`, `delete_item`, and the attachment operations) updates the cache immediately. Call `refresh()` to sync changes written externally (e.g. by another process or a mobile app), and `rebuild_cache()` to fully repopulate from disk if the cache becomes corrupt.
+
+| Platform | Default location |
+|---|---|
+| macOS | `~/Library/Caches/allourthings/<hash>/` |
+| Windows | `%LOCALAPPDATA%\allourthings\<hash>\` |
+| Linux | `~/.cache/allourthings/<hash>/` |
+
+The `<hash>` is a SHA-256 of the data directory path, so multiple vaults each get their own isolated cache.
+
+The cache schema indexes `category`, `subcategory`, and `tags` for SQL filtering, and stores the full item as a JSON blob for everything else. All three are optional on any item — items missing them are stored and returned normally, they just won't appear when those specific filters are applied. Keeping the indexed columns to only those actually queried means new well-known fields can be added without any schema migration.
+
+## Running tests
+
+```bash
+cargo test
+```
+
+This runs two test suites:
+
+- **Unit tests** (in `src/`) — cover the item schema, slug generation, ID generation, storage CRUD, attachments, and cache write-through behaviour
+- **Conformance tests** (`tests/conformance.rs`) — assert against the shared fixtures in `test-fixtures/catalog/`. These define the canonical storage format that all AllOurThings clients (MCP server, iOS app, etc.) must honour
+
 
 ## License
 

package/index.d.ts

@@ -6,7 +6,7 @@
 /** Filter options for listItems, exposed as a plain JS object. */
 export interface JsListFilter {
   category?: string
-  location?: string
+  subcategory?: string
   tags?: Array<string>
 }
 /**
@@ -17,11 +17,17 @@ export interface JsListFilter {
  * blocking the event loop (operations are fast local filesystem I/O).
  */
 export declare class JsCatalogStore {
-  constructor(dataDir: string)
+  constructor(dataDir: string, cacheDir?: string | undefined | null)
+  refresh(): NapiResult
+  rebuildCache(): NapiResult
   addItem(newItem: any): NapiResult
   getItem(idOrName: string): NapiResult
   listItems(filter?: JsListFilter | undefined | null): NapiResult
   updateItem(id: string, updates: any): NapiResult
   deleteItem(id: string): NapiResult
   searchItems(query: string): NapiResult
+  getItemFields(): NapiResult
+  addAttachment(itemId: string, filename: string, kind: string, data: Buffer, label?: string | undefined | null): NapiResult
+  getAttachment(itemId: string, filename: string): NapiResult
+  deleteAttachment(itemId: string, filename: string): NapiResult
 }

package/index.js

@@ -37,7 +37,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.android-arm64.node')
           } else {
-            nativeBinding = require('allourthings-core-android-arm64')
+            nativeBinding = require('@allourthings/core-android-arm64')
           }
         } catch (e) {
           loadError = e
@@ -49,7 +49,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.android-arm-eabi.node')
           } else {
-            nativeBinding = require('allourthings-core-android-arm-eabi')
+            nativeBinding = require('@allourthings/core-android-arm-eabi')
           }
         } catch (e) {
           loadError = e
@@ -69,7 +69,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.win32-x64-msvc.node')
           } else {
-            nativeBinding = require('allourthings-core-win32-x64-msvc')
+            nativeBinding = require('@allourthings/core-win32-x64-msvc')
           }
         } catch (e) {
           loadError = e
@@ -83,7 +83,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.win32-ia32-msvc.node')
           } else {
-            nativeBinding = require('allourthings-core-win32-ia32-msvc')
+            nativeBinding = require('@allourthings/core-win32-ia32-msvc')
           }
         } catch (e) {
           loadError = e
@@ -97,7 +97,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.win32-arm64-msvc.node')
           } else {
-            nativeBinding = require('allourthings-core-win32-arm64-msvc')
+            nativeBinding = require('@allourthings/core-win32-arm64-msvc')
           }
         } catch (e) {
           loadError = e
@@ -113,7 +113,7 @@ switch (platform) {
       if (localFileExisted) {
         nativeBinding = require('./allourthings-core.darwin-universal.node')
       } else {
-        nativeBinding = require('allourthings-core-darwin-universal')
+        nativeBinding = require('@allourthings/core-darwin-universal')
       }
       break
     } catch {}
@@ -124,7 +124,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.darwin-x64.node')
           } else {
-            nativeBinding = require('allourthings-core-darwin-x64')
+            nativeBinding = require('@allourthings/core-darwin-x64')
           }
         } catch (e) {
           loadError = e
@@ -138,7 +138,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.darwin-arm64.node')
           } else {
-            nativeBinding = require('allourthings-core-darwin-arm64')
+            nativeBinding = require('@allourthings/core-darwin-arm64')
           }
         } catch (e) {
           loadError = e
@@ -157,7 +157,7 @@ switch (platform) {
       if (localFileExisted) {
         nativeBinding = require('./allourthings-core.freebsd-x64.node')
       } else {
-        nativeBinding = require('allourthings-core-freebsd-x64')
+        nativeBinding = require('@allourthings/core-freebsd-x64')
       }
     } catch (e) {
       loadError = e
@@ -174,7 +174,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-x64-musl.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-x64-musl')
+              nativeBinding = require('@allourthings/core-linux-x64-musl')
             }
           } catch (e) {
             loadError = e
@@ -187,7 +187,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-x64-gnu.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-x64-gnu')
+              nativeBinding = require('@allourthings/core-linux-x64-gnu')
             }
           } catch (e) {
             loadError = e
@@ -203,7 +203,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-arm64-musl.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-arm64-musl')
+              nativeBinding = require('@allourthings/core-linux-arm64-musl')
             }
           } catch (e) {
             loadError = e
@@ -216,7 +216,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-arm64-gnu.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-arm64-gnu')
+              nativeBinding = require('@allourthings/core-linux-arm64-gnu')
             }
           } catch (e) {
             loadError = e
@@ -232,7 +232,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-arm-musleabihf.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-arm-musleabihf')
+              nativeBinding = require('@allourthings/core-linux-arm-musleabihf')
             }
           } catch (e) {
             loadError = e
@@ -245,7 +245,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-arm-gnueabihf.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-arm-gnueabihf')
+              nativeBinding = require('@allourthings/core-linux-arm-gnueabihf')
             }
           } catch (e) {
             loadError = e
@@ -261,7 +261,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-riscv64-musl.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-riscv64-musl')
+              nativeBinding = require('@allourthings/core-linux-riscv64-musl')
             }
           } catch (e) {
             loadError = e
@@ -274,7 +274,7 @@ switch (platform) {
             if (localFileExisted) {
               nativeBinding = require('./allourthings-core.linux-riscv64-gnu.node')
             } else {
-              nativeBinding = require('allourthings-core-linux-riscv64-gnu')
+              nativeBinding = require('@allourthings/core-linux-riscv64-gnu')
             }
           } catch (e) {
             loadError = e
@@ -289,7 +289,7 @@ switch (platform) {
           if (localFileExisted) {
             nativeBinding = require('./allourthings-core.linux-s390x-gnu.node')
           } else {
-            nativeBinding = require('allourthings-core-linux-s390x-gnu')
+            nativeBinding = require('@allourthings/core-linux-s390x-gnu')
           }
         } catch (e) {
           loadError = e

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allourthings/core",
-  "version": "0.1.11",
+  "version": "1.0.1",
   "description": "Native storage core for All Our Things",
   "main": "index.js",
   "types": "index.d.ts",