@black-cape/microstore 0.0.1

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025, MicroStore Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,794 @@
+# MicroStore
+
+![MicroStore Logo](https://github.com/black-cape/microstore/raw/refs/heads/main/logo.png)
+
+**A powerful TypeScript React data normalization library that provides a single source of truth for your application state.**
+
+MicroStore is an abstract data normalization layer for React projects that eliminates data duplication across AJAX / fetch requests and provides reactive access to normalized records. Built on [TinyBase](https://tinybase.org/), it automatically interprets REST API responses and maintains a consistent, normalized data record layer that your UI can reactively subscribe to. Each component using the reactivity layer still receives immutable copies of each record, but they will always be in sync.
+
+## 🚀 Features
+
+- **🎯 Single Source of Truth**: Eliminates data duplication by normalizing records across all API requests
+- **⚡ Reactive Updates**: Components automatically re-render when normalized data changes
+- **🔄 Automatic REST Interpretation**: Built-in support for Ember REST Adapter and fastapi-cruddy-framework response formats
+- **🔌 Provider Agnostic**: Works with any AJAX library (ky, axios, fetch) or query cache (React Query, SWR)
+- **🛡️ TypeScript First**: Fully typed with comprehensive schema validation
+- **🎨 Transform System**: Flexible field and record-level data transformations
+- **⚡ Performance Optimized**: Built on TinyBase for efficient storage and queries
+
+## 📦 Installation
+
+```bash
+npm install @black-cape/microstore
+# or
+yarn add @black-cape/microstore
+# or
+pnpm add @black-cape/microstore
+```
+
+## ⚛️ React Compatibility
+
+MicroStore supports both **React 18** and **React 19**:
+
+- ✅ **React 18.0+**: Full compatibility with all features
+- ✅ **React 19.0+**: Full compatibility with latest React features
+- 🔧 **React Compiler**: Optional support for React's experimental compiler
+
+### Testing Compatibility
+
+Test your specific React version:
+
+```bash
+# Test with React 18
+npm install react@^18.0.0 react-dom@^18.0.0
+npm run test:compatibility
+
+# Test with React 19
+npm install react@^19.0.0 react-dom@^19.0.0
+npm run test:compatibility
+```
+
+## 🏃 Quick Start
+
+### 1. Define Your Schemas
+
+```typescript
+import { MicroStore, MicroStoreProvider, useReactive } from 'microstore';
+
+// Define your data schemas
+const schemas = {
+  user: {
+    id: { type: 'string', primaryKey: true },
+    name: { type: 'string' },
+    email: { type: 'string' },
+    tags: { type: 'string', transform: 'json' }, // Will serialized / deserialized into and out of tinybase as JSON
+    preferences: { type: 'string', transform: 'json' } // Will serialized / deserialized into and out of tinybase as JSON
+  },
+  post: {
+    id: { type: 'string', primaryKey: true },
+    title: { type: 'string' },
+    content: { type: 'string' },
+    userId: { type: 'string' },
+    tags: { type: 'string', transform: 'json' } // Will serialized / deserialized into and out of tinybase as JSON
+  }
+} as const;
+```
+
+### 2. Setup the Provider
+
+```typescript
+import { MicroStore, MicroStoreProvider } from 'microstore';
+
+const store = new MicroStore({ schemas });
+
+function App() {
+  return (
+    <MicroStoreProvider store={store}>
+      <UserList />
+    </MicroStoreProvider>
+  );
+}
+```
+
+### 3. Use with React Query (or any data fetcher)
+
+```typescript
+import { useQuery } from '@tanstack/react-query';
+import { useReactive, useMicroStore } from 'microstore';
+
+function UserList() {
+  const store = useMicroStore();
+
+  // Fetch data with React Query
+  const { data: rawUsers } = useQuery({
+    queryKey: ['users'],
+    queryFn: async () => {
+      const response = await fetch('/api/users');
+      const data = await response.json();
+
+      // Push the response into MicroStore for normalization
+      store?.pushPayload('GET', data);
+
+      return data.users; // Return the raw array for React Query
+    }
+  });
+
+  // useReactive ensures components get the normalized, single-source-of-truth data
+  const users = useReactive('user', rawUsers || []);
+
+  return (
+    <ul>
+      {users.map(user => (
+        <UserItem key={user.id} user={user} />
+      ))}
+    </ul>
+  );
+}
+
+function UserItem({ user }) {
+  // This component will automatically re-render if this user
+  // is updated anywhere else in the application!
+  return (
+    <li>
+      {user.name} - {user.email}
+      <small>Joined: {user.createdAt.toLocaleDateString()}</small>
+    </li>
+  );
+}
+```
+
+## 🔌 Core Classes and Hooks
+
+### `MicroStore`
+
+The main store class that handles data normalization, storage, and retrieval.
+
+```typescript
+const store = new MicroStore({
+  schemas,
+  fieldTransforms?: FieldTransforms,
+  recordTransforms?: RecordTransforms,
+  interpreter?: MicrostoreInterpreter
+});
+
+// Push data from API responses
+store.pushPayload('GET', response);
+store.pushRecord('user', userData, 'POST');
+store.pushRecords('user', userArray, 'GET');
+
+// Direct data access
+const user = store.peekRecord<User>('user', '123');
+const allUsers = store.peekAll<User>('user');
+
+// Data management
+store.unloadRecord('user', '123');
+store.unloadAll('user');
+store.reset();
+```
+
+### `useReactive<T>(type: string, data: T[]): T[]`
+
+React hook that wraps an array of records to provide reactive updates from the normalized store.
+
+```typescript
+function UserList() {
+  const { data } = useQuery(['users'], fetchUsers);
+
+  // Returns normalized users that update reactively
+  // You can update individual records in MicroStore using
+  // websockets, for instance, or if you have many components
+  // querying for users on screen at different times, any REST response
+  // that has the latest information on user x would cause user x
+  // to synchronize across all components without additional queries
+  const users = useReactive('user', data?.users || []);
+
+  return <div>{users.map(user => <User key={JSON.stringify(user)} user={user} />)}</div>;
+}
+```
+
+### `RESTInterpreter`
+
+Built-in interpreter for standard REST API responses. Supports:
+
+- **[Ember REST Adapter](https://api.emberjs.com/ember-data/release/classes/restadapter) format**
+- **[fastapi-cruddy-framework](https://github.com/mdconaway/fastapi-cruddy-framework) format**
+- Custom pluralized resource names
+
+```typescript
+// Automatically normalizes responses like:
+{
+  "users": [
+    { "id": "1", "name": "John" },
+    { "id": "2", "name": "Jane" }
+  ],
+  "posts": [
+    { "id": "1", "userId": "1", "title": "Hello World" }
+  ],
+  "meta": { "total": 100 }
+}
+```
+
+### `MicroStoreProvider`
+
+React context provider that makes the store available to child components.
+
+```typescript
+<MicroStoreProvider store={store}>
+  <App />
+</MicroStoreProvider>
+```
+
+## 🔄 Data Flow
+
+1. **API Request**: Use any HTTP client (fetch, ky, axios) or query library (React Query, SWR)
+2. **Normalization**: Push response data into MicroStore via `pushPayload()`
+3. **Storage**: Data is normalized, deduplicated, and stored in TinyBase
+4. **Reactive Access**: Components use `useReactive()` to get live, normalized data
+5. **Updates**: Any changes to normalized data automatically trigger component re-renders
+
+## 🛠️ Advanced Features
+
+### Custom Field Transforms
+
+Transform data at the field level during serialization/deserialization:
+
+```typescript
+const customTransforms = {
+  date: {
+    serialize: (value: Date) => value.toISOString(),
+    deserialize: (value: string) => new Date(value)
+  },
+  currency: {
+    serialize: (value: number) => Math.round(value * 100), // Store as cents
+    deserialize: (value: number) => value / 100 // Display as dollars
+  }
+};
+
+const store = new MicroStore({
+  schemas: {
+    product: {
+      id: { type: 'string', primaryKey: true },
+      name: { type: 'string' },
+      price: { type: 'number', transform: 'currency' },
+      createdAt: { type: 'string', transform: 'date' }
+    }
+  },
+  fieldTransforms: customTransforms
+});
+```
+
+### Custom Record Transforms
+
+Transform entire records during serialization/deserialization:
+
+```typescript
+const recordTransforms = {
+  user: {
+    serialize: (user: User) => ({
+      ...user // you COULD omit the computed field (displayName) here, but it will be clipped out automatically by the field schema during storage
+    }),
+    deserialize: (userData: any) => ({
+      ...userData,
+      displayName: userData.fullName || userData.name // Computed field for UI
+    })
+  }
+};
+```
+
+### Practical Zod Integration Example
+
+You can use record transforms to integrate [Zod](https://zod.dev/) for robust type validation and transformation:
+
+```typescript
+import { z } from 'zod';
+
+// Define Zod schema for validation and type inference
+const UserSchema = z.object({
+  id: z.string(),
+  email: z.string().email(),
+  name: z.string(),
+  createdAt: z.date(),
+  preferences: z.object({
+    theme: z.enum(['light', 'dark']),
+    notifications: z.boolean()
+  }),
+  // Computed properties available only in class instances
+  getDisplayName: z.function().returns(z.string()).optional()
+});
+
+// Create a User class with methods
+class User {
+  constructor(
+    public id: string,
+    public email: string,
+    public name: string,
+    public createdAt: Date,
+    public preferences: { theme: 'light' | 'dark'; notifications: boolean }
+  ) {}
+
+  getDisplayName(): string {
+    return `${this.name} (${this.email})`;
+  }
+
+  toJSON() {
+    // Convert class instance to plain object for API serialization
+    return {
+      id: this.id,
+      email: this.email,
+      name: this.name,
+      createdAt: this.createdAt,
+      preferences: this.preferences
+    };
+  }
+
+  static fromJSON(data: any): User {
+    // Validate and create User instance from plain object
+    const validated = UserSchema.omit({ getDisplayName: true }).parse(data);
+    return new User(
+      validated.id,
+      validated.email,
+      validated.name,
+      validated.createdAt,
+      validated.preferences
+    );
+  }
+}
+
+// Configure record transforms with Zod validation
+const recordTransforms = {
+  user: {
+    // serialize: receives User class instance, returns plain object for TinyBase storage
+    serialize: (user: User) => {
+      return user.toJSON(); // Convert class instance to POJO
+    },
+    // deserialize: receives POJO from TinyBase, returns User class instance for components
+    deserialize: (userData: any) => {
+      return User.fromJSON(userData); // Validate and convert to class instance
+    }
+  }
+};
+
+// Configure MicroStore with Zod-powered transforms
+const store = new MicroStore({
+  schemas: {
+    user: {
+      id: { type: 'string', primaryKey: true },
+      email: { type: 'string' },
+      name: { type: 'string' },
+      createdAt: { type: 'string', transform: 'json' }, // Dates serialized as ISO strings
+      preferences: { type: 'string', transform: 'json' } // Objects serialized as JSON
+    }
+  },
+  recordTransforms
+});
+
+// Usage in components - you receive fully validated User class instances
+function UserProfile({ userId }: { userId: string }) {
+  const user = store.peekRecord<User>('user', userId);
+
+  return (
+    <div>
+      <h1>{user?.getDisplayName()}</h1> {/* Class method available */}
+      <p>Theme: {user?.preferences.theme}</p>
+      <p>Notifications: {user?.preferences.notifications ? 'On' : 'Off'}</p>
+    </div>
+  );
+}
+```
+
+**Benefits of Zod Integration:**
+
+- **Runtime Validation**: Ensures data integrity when deserializing from storage
+- **Type Safety**: Full TypeScript support with inferred types
+- **Class Methods**: Enable rich domain models with behavior, not just data
+- **Error Handling**: Automatic validation errors for malformed data
+- **Schema Evolution**: Easy to update schemas as your API evolves
+
+Your `deserialize` function receives a POJO (plain old javascript object) format object _after_ it has already been run through `tinybase` field level `deserialize` functions. (So your arrays will be arrays, objects will be objects, etc) You can then take this simple POJO record and transform it into more complex types that cannot be represented in raw JSON, like class instances, dates, etc. If you create a `zod`-based deserialize function, the expectation of the correlated `serialize` method handler would be to receive a record object in its `zod` format, and to then convert it into its pure POJO format before it is then delegated to the final field-level transformers before being pushed into `tinybase` for reactivity.
+
+### Generating Schemas with ZodSchematizer
+
+You can automatically generate MicroStore schemas from Zod models using TinyBase's [ZodSchematizer](https://tinybase.org/api/schematizer-zod/interfaces/schematizer/zodschematizer/):
+
+```bash
+# Install the ZodSchematizer
+npm install tinybase schematizer-zod zod
+```
+
+```typescript
+import { z } from 'zod';
+import { createZodSchematizer } from 'schematizer-zod';
+
+// Define your Zod models
+const UserZodModel = z.object({
+  id: z.string(),
+  email: z.string().email(),
+  name: z.string(),
+  age: z.number().min(0).max(120),
+  isActive: z.boolean(),
+  createdAt: z.date(), // Date object in application
+  preferences: z.object({
+    theme: z.enum(['light', 'dark']),
+    notifications: z.boolean()
+  }),
+  tags: z.array(z.string())
+});
+
+const PostZodModel = z.object({
+  id: z.string(),
+  title: z.string(),
+  content: z.string(),
+  userId: z.string(),
+  publishedAt: z.date().nullable(),
+  metadata: z.object({
+    readTime: z.number(),
+    wordCount: z.number()
+  })
+});
+
+// Create the ZodSchematizer
+const schematizer = createZodSchematizer({
+  user: UserZodModel,
+  post: PostZodModel
+});
+
+// Generate base TinyBase schemas
+const baseTinyBaseSchemas = schematizer.getTablesSchema();
+
+// Define custom field transforms for complex types
+const customFieldTransforms = {
+  date: {
+    // serialize: convert Date object to ISO string for TinyBase storage
+    serialize: (value: Date) => value.toISOString(),
+    // deserialize: convert ISO string back to Date object for application use
+    deserialize: (value: string) => new Date(value)
+  }
+};
+
+// Convert to MicroStore schemas by adding MicroStore-specific properties
+const microStoreSchemas = {
+  user: {
+    ...baseTinyBaseSchemas.user,
+    // Override the id field to mark it as primary key
+    id: { ...baseTinyBaseSchemas.user.id, primaryKey: true },
+    // Add transforms for complex fields
+    createdAt: { type: 'string', transform: 'date' }, // Use custom date transform
+    preferences: { type: 'string', transform: 'json' },
+    tags: { type: 'string', transform: 'json' }
+  },
+  post: {
+    ...baseTinyBaseSchemas.post,
+    // Override the id field to mark it as primary key
+    id: { ...baseTinyBaseSchemas.post.id, primaryKey: true },
+    // Add transforms for complex fields
+    publishedAt: { type: 'string', transform: 'date' }, // Use custom date transform
+    metadata: { type: 'string', transform: 'json' }
+  }
+} as const;
+
+// Create MicroStore with generated schemas and custom transforms
+const store = new MicroStore({
+  schemas: microStoreSchemas,
+  fieldTransforms: customFieldTransforms, // Add custom field transforms
+  recordTransforms: {
+    user: {
+      // serialize: receives Zod model instance, returns POJO for TinyBase storage
+      serialize: (user: z.infer<typeof UserZodModel>) => {
+        // Convert Zod model to plain object
+        return {
+          id: user.id,
+          email: user.email,
+          name: user.name,
+          age: user.age,
+          isActive: user.isActive,
+          createdAt: user.createdAt, // Date object - will be converted by field transform
+          preferences: user.preferences,
+          tags: user.tags
+        };
+      },
+      // deserialize: receives POJO from TinyBase, returns Zod-validated model
+      deserialize: (data: any) => {
+        return UserZodModel.parse(data); // createdAt will be Date object from field transform
+      }
+    },
+    post: {
+      // serialize: receives Zod model instance, returns POJO for TinyBase storage
+      serialize: (post: z.infer<typeof PostZodModel>) => {
+        // Convert Zod model to plain object
+        return {
+          id: post.id,
+          title: post.title,
+          content: post.content,
+          userId: post.userId,
+          publishedAt: post.publishedAt, // Date object - will be converted by field transform
+          metadata: post.metadata
+        };
+      },
+      // deserialize: receives POJO from TinyBase, returns Zod-validated model
+      deserialize: (data: any) => {
+        return PostZodModel.parse(data); // publishedAt will be Date object from field transform
+      }
+    }
+  }
+});
+```
+
+**Benefits of ZodSchematizer:**
+
+- **Automatic Schema Generation**: Convert Zod models directly to TinyBase/MicroStore schemas
+- **Type Consistency**: Ensure your validation schemas match your storage schemas
+- **Reduced Boilerplate**: Less manual schema definition
+- **Schema Evolution**: Update Zod models and regenerate schemas automatically
+- **Validation Integration**: Natural integration between Zod validation and MicroStore storage
+
+**Workflow:**
+
+1. Define your domain models using Zod schemas
+2. Use ZodSchematizer to generate base TinyBase schemas
+3. Create custom field transforms for complex types (Date, etc.)
+4. Enhance generated schemas with MicroStore properties (`primaryKey`, `transform`)
+5. Add record transforms with serialize returning POJOs and deserialize returning validated models
+6. Create MicroStore instance with enhanced schemas and field transforms
+
+### Custom Interpreters
+
+Create custom interpreters for non-standard API formats:
+
+```typescript
+function GraphQLInterpreter(data: any, options: any) {
+  // Handle GraphQL responses, JSON:API, or any other format
+  return {
+    data: [
+      {
+        type: 'user',
+        data: data.data.users
+      }
+    ],
+    meta: data.meta
+  };
+}
+
+const store = new MicroStore({
+  schemas,
+  interpreter: GraphQLInterpreter
+});
+```
+
+## 🎯 Use Cases
+
+### ✅ Perfect For
+
+- **React applications with multiple data sources** that need consistent state
+- **Applications fetching the same entities** from different API endpoints
+- **Complex UIs** where the same data appears in multiple components
+- **Real-time applications** that need reactive updates across components or use websockets
+- **Data-heavy applications** that need efficient normalization and deduplication
+
+## 🔗 Integration Examples
+
+### With React Query
+
+```typescript
+function useUsers() {
+  const store = useMicroStore();
+
+  return useQuery({
+    queryKey: ['users'],
+    queryFn: async () => {
+      const response = await api.get('/users');
+      store?.pushPayload('GET', response.data);
+      return response.data.users;
+    }
+  });
+}
+
+function UserList() {
+  const { data } = useUsers();
+  const users = useReactive('user', data || []);
+  return <div>{/* Render users */}</div>;
+}
+```
+
+### With SWR
+
+```typescript
+function useUsers() {
+  const store = useMicroStore();
+
+  return useSWR('/api/users', async (url) => {
+    const response = await fetch(url);
+    const data = await response.json();
+    store?.pushPayload('GET', data);
+    return data.users;
+  });
+}
+```
+
+### With Ky
+
+```typescript
+const api = ky.create({
+  hooks: {
+    afterResponse: [
+      async (request, _options, response) => {
+        const data = await response.json();
+        store.pushPayload(request.method, data);
+        return response;
+      }
+    ]
+  }
+});
+```
+
+- If you use the `afterResponse` hook in your global `ky` api, you DON'T need to manually push data into your store in your `queryFn`s! The data will automagically be in your `MicroStore` and all you need to do is pass the IDs you want to render to `useReactive` in your components! This is thanks to the `RESTInterpreter` which will digest all of your Ember RESTAdapter compliant responses automatically. If you need to see a server framework that responds with the correct format, checkout [fastapi-cruddy-framework](https://github.com/mdconaway/fastapi-cruddy-framework)
+
+## 📚 API Reference
+
+### MicroStore Methods
+
+| Method                                         | Description                           |
+| ---------------------------------------------- | ------------------------------------- |
+| `pushPayload(method, data, options?)`          | Normalize and store API response data |
+| `pushRecord(type, record, method, options?)`   | Store a single record                 |
+| `pushRecords(type, records, method, options?)` | Store multiple records                |
+| `peekRecord<T>(type, id)`                      | Get a single record by ID             |
+| `peekAll<T>(type)`                             | Get all records of a type             |
+| `unloadRecord(type, id)`                       | Remove a record from store            |
+| `unloadAll(type)`                              | Remove all records of a type          |
+| `reset()`                                      | Clear entire store                    |
+
+### Schema Options
+
+| Property      | Type                                | Description                      |
+| ------------- | ----------------------------------- | -------------------------------- |
+| `type`        | `'string' \| 'number' \| 'boolean'` | Field data type                  |
+| `primaryKey?` | `boolean`                           | Mark field as primary key        |
+| `transform?`  | `string`                            | Apply named transform to field   |
+| `default?`    | `any`                               | Default value for field          |
+| `allowNull?`  | `boolean`                           | Available if using tinybase >= 7 |
+
+## 📋 TODO
+
+### 🔗 TinyBase Relationships Support
+
+Add support for [TinyBase Relationships](https://tinybase.org/api/relationships/) to enable automatic relationship management between schemas:
+
+- [ ] **Schema Relationship Definitions**: Allow defining relationships directly in schema configuration
+- [ ] **Automatic Relationship Creation**: Auto-generate TinyBase relationships based on schema definitions
+- [ ] **Relationship Queries**: Extend query capabilities to leverage relationships for efficient data access
+- [ ] **Reactive Relationship Hooks**: Create hooks that reactively update when related data changes
+- [ ] **Foreign Key Validation**: Validate and maintain referential integrity across related records
+- [ ] **Cascade Operations**: Support cascade delete/update operations through relationships
+
+Example future API:
+
+### One-to-One Relationships (using belongsTo)
+
+```typescript
+const schemas = {
+  user: {
+    id: { type: 'string', primaryKey: true },
+    name: { type: 'string' },
+    email: { type: 'string' }
+  },
+  profile: {
+    id: { type: 'string', primaryKey: true },
+    userId: { type: 'string' }, // References user.id
+    user: { belongsTo: 'user', key: 'userId' } // Virtual relationship field (feeds off of local foreign key)
+    bio: { type: 'string' },
+    avatar: { type: 'string' }
+  }
+} as const;
+
+// Future hooks
+const profile = useRelationship(user, 'profile'); // Get user's profile (inverse hasOne)
+const user = useRelationship(profile, 'user'); // Get profile's user (belongsTo)
+```
+
+### One-to-Many Relationships (belongsTo + hasMany)
+
+```typescript
+const schemas = {
+  user: {
+    id: { type: 'string', primaryKey: true },
+    name: { type: 'string' },
+    posts: { hasMany: 'post', inverse: 'user' } // Virtual field for relationship
+  },
+  post: {
+    id: { type: 'string', primaryKey: true },
+    title: { type: 'string' },
+    content: { type: 'string' },
+    userId: { type: 'string' }, // Stores actual foreign key
+    user: { belongsTo: 'user', key: 'userId' } // Virtual relationship field (feeds off of local foreign key)
+  }
+} as const;
+
+// Future hooks
+const posts = useRelationship(user, 'posts'); // Get all posts for a user (hasMany)
+const author = useRelationship(post, 'user'); // Get post's author (belongsTo)
+```
+
+### Many-to-Many Relationships (through junction model)
+
+```typescript
+const schemas = {
+  user: {
+    id: { type: 'string', primaryKey: true },
+    name: { type: 'string' },
+    userTags: { hasMany: 'userTag', inverse: 'user' },
+    tags: { hasMany: 'tag', through: 'userTags.tag' } // Through relationship
+  },
+  tag: {
+    id: { type: 'string', primaryKey: true },
+    name: { type: 'string' },
+    color: { type: 'string' },
+    userTags: { hasMany: 'userTag', inverse: 'tag' },
+    users: { hasMany: 'user', through: 'userTags.user' } // Through relationship
+  },
+  userTag: {
+    id: { type: 'string', primaryKey: true },
+    userId: { type: 'string' },
+    tagId: { type: 'string' },
+    user: { belongsTo: 'user', key: 'userId' },
+    tag: { belongsTo: 'tag', key: 'tagId' },
+    createdAt: { type: 'string' } // Junction tables can have additional fields
+  }
+} as const;
+
+// Future hooks for many-to-many
+const userTags = useRelationship(user, 'tags'); // Get user's tags (through userTags)
+const tagUsers = useRelationship(tag, 'users'); // Get tag's users (through userTags)
+const userTagJunctions = useRelationship(user, 'userTags'); // Get actual junction records
+
+// Post tagging example
+const schemas = {
+  post: {
+    id: { type: 'string', primaryKey: true },
+    title: { type: 'string' },
+    postTags: { hasMany: 'postTag', inverse: 'post' },
+    tags: { hasMany: 'tag', through: 'postTags.tag' }
+  },
+  tag: {
+    id: { type: 'string', primaryKey: true },
+    name: { type: 'string' },
+    postTags: { hasMany: 'postTag', inverse: 'tag' },
+    posts: { hasMany: 'post', through: 'postTags.post' }
+  },
+  postTag: {
+    id: { type: 'string', primaryKey: true },
+    postId: { type: 'string' },
+    tagId: { type: 'string' },
+    post: { belongsTo: 'post', key: 'postId' },
+    tag: { belongsTo: 'tag', key: 'tagId' }
+  }
+} as const;
+
+// Complex many-to-many usage
+const tagsForPost = useRelationship(post, 'tags'); // Get all tags for a post
+const postsForTag = useRelationship(tag, 'posts'); // Get all posts with a tag
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our [contributing guidelines](./CONTRIBUTING.md) and submit pull requests to our repository.
+
+We especially welcome contributions in these areas:
+
+- 🧪 **Testing**: Help us add comprehensive test coverage
+- 📖 **Documentation**: Improve examples and API documentation
+- 🔗 **Relationships**: Implement TinyBase relationships support
+- 🎯 **Transformers**: Add more field and record transform types
+- 💡 **Examples**: Create real-world usage examples
+
+See our [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines on development workflow, code style, and pull request requirements.
+
+## 📄 License
+
+ISC License - see LICENSE file for details.
+
+## 🔗 Related Projects
+
+- [TinyBase](https://tinybase.org/) - The reactive data store powering MicroStore
+- [fastapi-cruddy-framework](https://github.com/mdconaway/fastapi-cruddy-framework) - Compatible REST API framework
+- [React Query](https://tanstack.com/query) - Recommended for data fetching
+- [SWR](https://swr.vercel.app/) - Alternative data fetching solution

package/dist/index.d.mts

@@ -0,0 +1,88 @@
+import { CellSchema, Row } from 'tinybase/with-schemas';
+import { Store, Queries, Row as Row$1 } from 'tinybase';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type CallableWithReturn<T> = (data: any) => T;
+type RecordCallableWithReturn<T> = (data: Record<string, any>) => T;
+type RowCallableWithReturn<T> = (data: Row<any, any>) => T;
+type InterpretableWithReturn<T> = (data: Record<string, any>, options: Record<string, any>) => T;
+type InterpreterTypedBatch = {
+    data: Record<string, any>[];
+    type: string;
+};
+type InterpreterReturnValue = {
+    data: InterpreterTypedBatch[];
+    meta: Record<string, any> | undefined;
+};
+type FieldTransform = {
+    serialize: CallableWithReturn<any>;
+    deserialize: CallableWithReturn<any>;
+};
+type RecordTransform = {
+    serialize: RecordCallableWithReturn<any>;
+    deserialize: RowCallableWithReturn<any>;
+};
+type MicroStoreCellSchema = CellSchema & {
+    transform?: string;
+    primaryKey?: boolean;
+};
+type MicrostoreInterpreter = InterpretableWithReturn<InterpreterReturnValue>;
+type ConventionalSchema = Record<string, CellSchema>;
+type ConventionalSchemas = Record<string, ConventionalSchema>;
+type MicroStoreSchema = Record<string, MicroStoreCellSchema>;
+type MicroStoreSchemas = Record<string, MicroStoreSchema>;
+type FieldTransforms = Record<string, FieldTransform>;
+type RecordTransforms = Record<string, RecordTransform>;
+type RawRow = Record<string, any>;
+type RawRecord = Record<any, any>;
+type MethodType = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
+type MicroStoreOptions = {
+    schemas: MicroStoreSchemas;
+    recordTransforms?: RecordTransforms;
+    fieldTransforms?: FieldTransforms;
+    interpreter?: MicrostoreInterpreter;
+};
+
+declare function RESTInterpreter(data: Record<string, any>, _options: Record<string, any>): InterpreterReturnValue;
+
+declare class MicroStore {
+    schemas: MicroStoreSchemas;
+    fieldTransforms: FieldTransforms;
+    recordTransforms: RecordTransforms;
+    store: Store;
+    queries: Queries;
+    interpreter: MicrostoreInterpreter;
+    private primaryKeys;
+    constructor(options: MicroStoreOptions);
+    private transformSchemas;
+    getPrimaryKey(type: string): string | undefined;
+    getSchema(type: string): MicroStoreSchema | null;
+    getRecordTransform(type: string | undefined): RecordTransform | undefined;
+    getFieldTransform(type: string | undefined): FieldTransform | undefined;
+    serialize(row: RawRow, schema: MicroStoreSchema): RawRow;
+    deserialize(row: Row$1, schema: MicroStoreSchema): RawRow;
+    pushRecord(type: string, data: RawRecord, method: MethodType, options?: Record<string, any>): InterpreterReturnValue | undefined;
+    pushRecords(type: string, data: RawRecord[], method: MethodType, options?: Record<string, any>): InterpreterReturnValue | undefined;
+    pushPayload(method: MethodType, data: any, options?: Record<string, any>): InterpreterReturnValue | undefined;
+    peekRecord<T>(type: string, id: string): T | undefined;
+    peekAll<T>(type: string): T[];
+    unloadRecord<T>(type: string, id: string): T | undefined;
+    unloadAll(type: string): void;
+    reset(): void;
+    getStore(): Store;
+    getQueries(): Queries;
+}
+
+declare function useMicroStore(): MicroStore | null;
+type WithExistingStore = {
+    store: MicroStore;
+    children: ReactNode;
+};
+declare function MicroStoreProvider(props: WithExistingStore): react_jsx_runtime.JSX.Element;
+
+declare function useReactive<T>(type: string, data: T[]): T[];
+
+declare const json: FieldTransform;
+
+export { type CallableWithReturn, type ConventionalSchema, type ConventionalSchemas, type FieldTransform, type FieldTransforms, type InterpretableWithReturn, type InterpreterReturnValue, type InterpreterTypedBatch, type MethodType, MicroStore, type MicroStoreCellSchema, type MicroStoreOptions, MicroStoreProvider, type MicroStoreSchema, type MicroStoreSchemas, type MicrostoreInterpreter, RESTInterpreter, type RawRecord, type RawRow, type RecordCallableWithReturn, type RecordTransform, type RecordTransforms, type RowCallableWithReturn, json, useMicroStore, useReactive };

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+import { CellSchema, Row } from 'tinybase/with-schemas';
+import { Store, Queries, Row as Row$1 } from 'tinybase';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type CallableWithReturn<T> = (data: any) => T;
+type RecordCallableWithReturn<T> = (data: Record<string, any>) => T;
+type RowCallableWithReturn<T> = (data: Row<any, any>) => T;
+type InterpretableWithReturn<T> = (data: Record<string, any>, options: Record<string, any>) => T;
+type InterpreterTypedBatch = {
+    data: Record<string, any>[];
+    type: string;
+};
+type InterpreterReturnValue = {
+    data: InterpreterTypedBatch[];
+    meta: Record<string, any> | undefined;
+};
+type FieldTransform = {
+    serialize: CallableWithReturn<any>;
+    deserialize: CallableWithReturn<any>;
+};
+type RecordTransform = {
+    serialize: RecordCallableWithReturn<any>;
+    deserialize: RowCallableWithReturn<any>;
+};
+type MicroStoreCellSchema = CellSchema & {
+    transform?: string;
+    primaryKey?: boolean;
+};
+type MicrostoreInterpreter = InterpretableWithReturn<InterpreterReturnValue>;
+type ConventionalSchema = Record<string, CellSchema>;
+type ConventionalSchemas = Record<string, ConventionalSchema>;
+type MicroStoreSchema = Record<string, MicroStoreCellSchema>;
+type MicroStoreSchemas = Record<string, MicroStoreSchema>;
+type FieldTransforms = Record<string, FieldTransform>;
+type RecordTransforms = Record<string, RecordTransform>;
+type RawRow = Record<string, any>;
+type RawRecord = Record<any, any>;
+type MethodType = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
+type MicroStoreOptions = {
+    schemas: MicroStoreSchemas;
+    recordTransforms?: RecordTransforms;
+    fieldTransforms?: FieldTransforms;
+    interpreter?: MicrostoreInterpreter;
+};
+
+declare function RESTInterpreter(data: Record<string, any>, _options: Record<string, any>): InterpreterReturnValue;
+
+declare class MicroStore {
+    schemas: MicroStoreSchemas;
+    fieldTransforms: FieldTransforms;
+    recordTransforms: RecordTransforms;
+    store: Store;
+    queries: Queries;
+    interpreter: MicrostoreInterpreter;
+    private primaryKeys;
+    constructor(options: MicroStoreOptions);
+    private transformSchemas;
+    getPrimaryKey(type: string): string | undefined;
+    getSchema(type: string): MicroStoreSchema | null;
+    getRecordTransform(type: string | undefined): RecordTransform | undefined;
+    getFieldTransform(type: string | undefined): FieldTransform | undefined;
+    serialize(row: RawRow, schema: MicroStoreSchema): RawRow;
+    deserialize(row: Row$1, schema: MicroStoreSchema): RawRow;
+    pushRecord(type: string, data: RawRecord, method: MethodType, options?: Record<string, any>): InterpreterReturnValue | undefined;
+    pushRecords(type: string, data: RawRecord[], method: MethodType, options?: Record<string, any>): InterpreterReturnValue | undefined;
+    pushPayload(method: MethodType, data: any, options?: Record<string, any>): InterpreterReturnValue | undefined;
+    peekRecord<T>(type: string, id: string): T | undefined;
+    peekAll<T>(type: string): T[];
+    unloadRecord<T>(type: string, id: string): T | undefined;
+    unloadAll(type: string): void;
+    reset(): void;
+    getStore(): Store;
+    getQueries(): Queries;
+}
+
+declare function useMicroStore(): MicroStore | null;
+type WithExistingStore = {
+    store: MicroStore;
+    children: ReactNode;
+};
+declare function MicroStoreProvider(props: WithExistingStore): react_jsx_runtime.JSX.Element;
+
+declare function useReactive<T>(type: string, data: T[]): T[];
+
+declare const json: FieldTransform;
+
+export { type CallableWithReturn, type ConventionalSchema, type ConventionalSchemas, type FieldTransform, type FieldTransforms, type InterpretableWithReturn, type InterpreterReturnValue, type InterpreterTypedBatch, type MethodType, MicroStore, type MicroStoreCellSchema, type MicroStoreOptions, MicroStoreProvider, type MicroStoreSchema, type MicroStoreSchemas, type MicrostoreInterpreter, RESTInterpreter, type RawRecord, type RawRow, type RecordCallableWithReturn, type RecordTransform, type RecordTransforms, type RowCallableWithReturn, json, useMicroStore, useReactive };

package/dist/index.js

@@ -0,0 +1,2 @@
+'use strict';var emberInflector=require('ember-inflector'),lodashEs=require('lodash-es'),tinybase=require('tinybase'),react=require('react'),uiReact=require('tinybase/ui-react'),jsxRuntime=require('react/jsx-runtime');var K=Object.defineProperty;var z=(o,e,r)=>e in o?K(o,e,{enumerable:true,configurable:true,writable:true,value:r}):o[e]=r;var f=(o,e,r)=>z(o,typeof e!="symbol"?e+"":e,r);function l(o,e){let r={data:[],meta:void 0},s;return o!==void 0&&Object.keys(o).forEach(t=>{let i=o[t];if(t!=="meta"){let n=[],c=lodashEs.camelCase(emberInflector.singularize(t));lodashEs.isArray(i)?i.forEach(a=>{n.push(a);}):n.push(i),r.data.push({data:n,type:c});}else s=o[t];}),r.meta=s,r}var p={serialize(o){return o?JSON.stringify(o):null},deserialize(o){return o?JSON.parse(o):null}};var N=["transform","primaryKey"],q={json:p},y=class{constructor(e){f(this,"schemas");f(this,"fieldTransforms");f(this,"recordTransforms");f(this,"store");f(this,"queries");f(this,"interpreter");f(this,"primaryKeys");this.primaryKeys={},this.schemas=e.schemas?e.schemas:{},this.fieldTransforms={...e.fieldTransforms?e.fieldTransforms:{},...q},this.recordTransforms=e.recordTransforms?e.recordTransforms:{},this.interpreter=e.interpreter?e.interpreter:l,this.store=tinybase.createStore(),this.store.setTablesSchema(this.transformSchemas()),this.queries=tinybase.createQueries(this.store);}transformSchemas(){let e={};return Object.keys(this.schemas).forEach(r=>{if(e[r]={},Object.keys(this.schemas[r]).forEach(s=>{if(e[r][s]=lodashEs.omit(this.schemas[r][s],N),this.schemas[r][s].primaryKey&&this.schemas[r][s].type==="string"){if(this.primaryKeys[r])throw Error(`More than one primary key defined for schema ${r}`);this.primaryKeys[r]=s;}}),!this.getPrimaryKey(r)&&this.schemas[r].id&&this.schemas[r].id.type==="string"&&(this.primaryKeys[r]="id"),!this.getPrimaryKey(r))throw Error(`No primary key defined for schema ${r}. This schema must have an 'id' field of "type": "string", or another field of "type": "string" with "primaryKey": true.`)}),e}getPrimaryKey(e){let r=this.primaryKeys[e];return r||void 0}getSchema(e){return e&&Object.hasOwn(this.schemas,e)?this.schemas[e]:null}getRecordTransform(e){if(e)return this.recordTransforms[e]?this.recordTransforms[e]:void 0}getFieldTransform(e){if(e)return this.fieldTransforms[e]?this.fieldTransforms[e]:void 0}serialize(e,r){let s={};return Object.keys(e).forEach(t=>{let i=r[t];if(i){let n=this.getFieldTransform(i.transform);s[t]=n?n.serialize(e[t]):e[t];}}),s}deserialize(e,r){let s={};return Object.keys(e).forEach(t=>{let i=r[t];if(i){let n=i.transform&&this.fieldTransforms[i.transform]?this.fieldTransforms[i.transform]:void 0;s[t]=n?n.deserialize(e[t]):e[t];}}),s}pushRecord(e,r,s,t={}){return this.pushRecords(e,[r],s,t)}pushRecords(e,r,s,t={}){let i=this.getRecordTransform(e),n=lodashEs.camelCase(emberInflector.pluralize(e));if(!i)return this.pushPayload(s,{[n]:r},t);let c=r.map(a=>i.serialize(a));return this.pushPayload(s,{[n]:c},t)}pushPayload(e,r,s={}){try{let t=this.interpreter(r,s);return t.data.forEach(i=>{let n=this.getSchema(i.type);if(n){let c=this.getPrimaryKey(i.type)||"id";e==="DELETE"?i.data.forEach(a=>{this.store.delRow(i.type,a[c]);}):e==="PATCH"?i.data.forEach(a=>{this.store.getRow(i.type,a[c])?this.store.setPartialRow(i.type,a[c],this.serialize(a,n)):this.store.setRow(i.type,a[c],this.serialize(a,n));}):i.data.forEach(a=>{this.store.setRow(i.type,a[c],this.serialize(a,n));});}}),t}catch(t){console.warn(t);}}peekRecord(e,r){let s=this.getSchema(e),t=this.getPrimaryKey(e),i=this.getRecordTransform(e),n=i?i.deserialize:c=>c;if(s&&t){let c=this.getStore().getRow(e,r);if(c)return n(this.deserialize(c,s))}}peekAll(e){let r=this.getSchema(e),s=this.getPrimaryKey(e),t=this.getRecordTransform(e),i=t?t.deserialize:n=>n;if(r&&s){let n=this.getStore().getTable(e);return Object.entries(n).map(([c,a])=>i(this.deserialize(a,r)))}return []}unloadRecord(e,r){let s=this.peekRecord(e,r);return s&&this.getStore().delRow(e,r),s}unloadAll(e){this.getSchema(e)&&this.getStore().delTable(e);}reset(){Object.entries(this.schemas).forEach(([e,r])=>{this.unloadAll(e);});}getStore(){return this.store}getQueries(){return this.queries}};var w=react.createContext(null);function g(){return react.useContext(w)}function J(o){let e=react.useMemo(()=>o.store,[o]);return jsxRuntime.jsx(w.Provider,{value:e,children:jsxRuntime.jsx(uiReact.Provider,{store:e.getStore(),queries:e.getQueries(),children:o.children})})}function U(o,e){return o?o.map(r=>r[e]):[]}function G(o,e,r,s,t,i){t.setQueryDefinition(s,o,({select:n,where:c})=>{Object.keys(e).forEach(a=>{n(a);}),c(a=>i.includes(a(r)));});}function X(o,e){let r=g(),s=r?.getSchema(o),t=r?.getPrimaryKey(o);if(!s||!t)throw new Error(`No MicroStore schema defined for type ${o}`);let[i,n]=react.useState(crypto.randomUUID()),c=uiReact.useQueries(),a=uiReact.useResultTable(i,c),[d,E]=react.useState(""),u=react.useRef("");react.useEffect(()=>{if(c){let m=U(e,t),h=JSON.stringify(m);d!==h&&u.current!==h&&(Object.entries(a).length>0&&(u.current=h),E(h),G(o,s,t,i,c,m));}},[e,t,s,o,c,i,d,a,u]);let R=r?.getRecordTransform(o),P=R?R.deserialize:m=>m,S=[];return e.forEach(m=>{let h=m[t],T=a[h];if(T){let v=r?.deserialize(T,s);S.push(P(v));}}),S}exports.MicroStore=y;exports.MicroStoreProvider=J;exports.RESTInterpreter=l;exports.json=p;exports.useMicroStore=g;exports.useReactive=X;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/interpreter.ts","../src/transforms.ts","../src/microstore.ts","../src/provider.tsx","../src/reactive.ts"],"names":["RESTInterpreter","data","_options","typedPayload","meta","k","content","typedData","typeName","camelCase","singularize","isArray","item","json","microStoreReservedKeys","defaultFieldTransforms","MicroStore","options","__publicField","createStore","createQueries","transformedSchemas","k2","omit","type","possiblePK","row","schema","serializedRow","field","transform","deserializedRow","method","typeKey","pluralize","rawData","batchedPayload","payload","pk","e","id","transformer","effectiveTransformer","x","table","_","record","schemaName","StoreContext","createContext","useMicroStore","useContext","MicroStoreProvider","props","store","useMemo","jsx","TinyBaseProvider","generateFilter","obj","resetQueryDefinition","queryName","queries","filter","select","where","getCell","useReactive","uniqueHookID","useState","useQueries","rows","useResultTable","lastFilter","setLastFilter","airBrake","useRef","useEffect","stringifiedFilter","returnData","identifier","possibleRow","thing"],"mappings":"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","file":"index.js","sourcesContent":["// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport { singularize } from 'ember-inflector';\nimport { camelCase, isArray } from 'lodash-es';\nimport type { InterpreterReturnValue } from './types';\n\nexport function RESTInterpreter(data: Record<string, any>, _options: Record<string, any>) {\n  const typedPayload: InterpreterReturnValue = {\n    data: [],\n    meta: undefined\n  };\n  let meta: Record<string, any> | undefined = undefined;\n\n  if (data !== undefined) {\n    Object.keys(data).forEach((k) => {\n      const content = data[k];\n      if (k !== 'meta') {\n        const typedData: Record<string, any>[] = [];\n        const typeName = camelCase(singularize(k));\n        if (isArray(content)) {\n          content.forEach((item: any) => {\n            typedData.push(item);\n          });\n        } else {\n          typedData.push(content);\n        }\n        typedPayload.data.push({\n          data: typedData,\n          type: typeName\n        });\n      } else {\n        meta = data[k];\n      }\n    });\n  }\n  typedPayload.meta = meta;\n  return typedPayload;\n}\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport type { FieldTransform } from './types';\n\nexport const json: FieldTransform = {\n  serialize(data) {\n    return data ? JSON.stringify(data) : null;\n  },\n  deserialize(data) {\n    return data ? JSON.parse(data) : null;\n  }\n};\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport { pluralize } from 'ember-inflector';\nimport { camelCase, omit } from 'lodash-es';\nimport { createQueries, createStore, type CellSchema, type Queries, type Row, type Store } from 'tinybase';\nimport { RESTInterpreter } from './interpreter';\nimport { json } from './transforms';\nimport type {\n  ConventionalSchema,\n  ConventionalSchemas,\n  FieldTransforms,\n  MethodType,\n  MicrostoreInterpreter,\n  MicroStoreOptions,\n  MicroStoreSchema,\n  MicroStoreSchemas,\n  RawRecord,\n  RawRow,\n  RecordTransforms\n} from './types';\n\nconst microStoreReservedKeys = ['transform', 'primaryKey'];\nconst defaultFieldTransforms = {\n  json\n};\n\nexport class MicroStore {\n  schemas: MicroStoreSchemas;\n  fieldTransforms: FieldTransforms;\n  recordTransforms: RecordTransforms;\n  store: Store;\n  queries: Queries;\n  interpreter: MicrostoreInterpreter;\n  private primaryKeys: Record<string, string>;\n\n  constructor(options: MicroStoreOptions) {\n    this.primaryKeys = {};\n    this.schemas = options.schemas ? options.schemas : {};\n    // Thats right, we even support our own field and record level transforms!\n    this.fieldTransforms = { ...(options.fieldTransforms ? options.fieldTransforms : {}), ...defaultFieldTransforms };\n    this.recordTransforms = options.recordTransforms ? options.recordTransforms : {};\n    this.interpreter = options.interpreter ? options.interpreter : RESTInterpreter;\n    this.store = createStore();\n    this.store.setTablesSchema(this.transformSchemas());\n    this.queries = createQueries(this.store);\n  }\n\n  private transformSchemas() {\n    // we have to remove custom properties or tinybase\n    // will ignore our fields.\n    const transformedSchemas: ConventionalSchemas = {};\n    Object.keys(this.schemas).forEach((k) => {\n      transformedSchemas[k] = <ConventionalSchema>{};\n      Object.keys(this.schemas[k]).forEach((k2) => {\n        transformedSchemas[k][k2] = omit(this.schemas[k][k2], microStoreReservedKeys) as CellSchema;\n        const possiblePK: boolean | undefined = this.schemas[k][k2]['primaryKey'];\n        if (possiblePK && this.schemas[k][k2]['type'] === 'string') {\n          if (this.primaryKeys[k]) {\n            throw Error(`More than one primary key defined for schema ${k}`);\n          }\n          this.primaryKeys[k] = k2;\n        }\n      });\n      // Default PK to id\n      if (!this.getPrimaryKey(k) && this.schemas[k]['id'] && this.schemas[k]['id']['type'] === 'string') {\n        this.primaryKeys[k] = 'id';\n      }\n      if (!this.getPrimaryKey(k)) {\n        throw Error(\n          `No primary key defined for schema ${k}. This schema must have an 'id' field of \"type\": \"string\", or another field of \"type\": \"string\" with \"primaryKey\": true.`\n        );\n      }\n    });\n    return transformedSchemas;\n  }\n\n  getPrimaryKey(type: string) {\n    const possiblePK = this.primaryKeys[type];\n    return possiblePK ? possiblePK : undefined;\n  }\n\n  getSchema(type: string) {\n    if (type) {\n      if (Object.hasOwn(this.schemas, type)) {\n        return this.schemas[type];\n      }\n    }\n    return null;\n  }\n\n  getRecordTransform(type: string | undefined) {\n    if (type) {\n      return this.recordTransforms[type] ? this.recordTransforms[type] : undefined;\n    }\n    return undefined;\n  }\n\n  getFieldTransform(type: string | undefined) {\n    if (type) {\n      return this.fieldTransforms[type] ? this.fieldTransforms[type] : undefined;\n    }\n    return undefined;\n  }\n\n  serialize(row: RawRow, schema: MicroStoreSchema) {\n    const serializedRow: RawRow = {};\n    Object.keys(row).forEach((k) => {\n      const field = schema[k];\n      if (field) {\n        const transform = this.getFieldTransform(field.transform);\n        serializedRow[k] = transform ? transform.serialize(row[k]) : row[k];\n      }\n    });\n    return serializedRow;\n  }\n\n  deserialize(row: Row, schema: MicroStoreSchema) {\n    const deserializedRow: RawRow = {};\n    Object.keys(row).forEach((k) => {\n      const field = schema[k];\n      if (field) {\n        const transform =\n          field.transform && this.fieldTransforms[field.transform] ? this.fieldTransforms[field.transform] : undefined;\n        deserializedRow[k] = transform ? transform.deserialize(row[k]) : row[k];\n      }\n    });\n    return deserializedRow;\n  }\n\n  // pushRecord is a sugar method to take a single record and push it into the store using whatever verb was used\n  pushRecord(type: string, data: RawRecord, method: MethodType, options: Record<string, any> = {}) {\n    return this.pushRecords(type, [data], method, options);\n  }\n\n  // pushRecords handles an incoming data (\"row\"s) that are in application level format (with dates, blobs, or other complex types that can't be POJO'd)\n  pushRecords(type: string, data: RawRecord[], method: MethodType, options: Record<string, any> = {}) {\n    const transform = this.getRecordTransform(type);\n    const typeKey = camelCase(pluralize(type));\n    if (!transform) {\n      return this.pushPayload(method, { [typeKey]: data }, options);\n    }\n    const rawData = data.map((item) => {\n      return transform.serialize(item);\n    });\n    return this.pushPayload(method, { [typeKey]: rawData }, options);\n  }\n\n  // pushPayload handles incoming data (many \"row\"s) that are in POJO format\n  pushPayload(method: MethodType, data: any, options: Record<string, any> = {}) {\n    try {\n      const batchedPayload = this.interpreter(data, options);\n      batchedPayload.data.forEach((payload) => {\n        const schema = this.getSchema(payload.type);\n        // Only process typed batches that match a defined data schema\n        if (schema) {\n          const pk = this.getPrimaryKey(payload.type) || 'id';\n          if (method === 'DELETE') {\n            payload.data.forEach((row) => {\n              this.store.delRow(payload.type, row[pk]);\n            });\n          } else if (method === 'PATCH') {\n            payload.data.forEach((row) => {\n              // Only try a partial row update if a row already exists\n              if (this.store.getRow(payload.type, row[pk])) {\n                this.store.setPartialRow(payload.type, row[pk], this.serialize(row, schema));\n              } else {\n                this.store.setRow(payload.type, row[pk], this.serialize(row, schema));\n              }\n            });\n          } else {\n            payload.data.forEach((row) => {\n              this.store.setRow(payload.type, row[pk], this.serialize(row, schema));\n            });\n          }\n        }\n      });\n      return batchedPayload;\n    } catch (e) {\n      console.warn(e);\n    }\n  }\n\n  peekRecord<T>(type: string, id: string): T | undefined {\n    const schema = this.getSchema(type);\n    const pk = this.getPrimaryKey(type);\n    const transformer = this.getRecordTransform(type);\n    const effectiveTransformer = transformer ? transformer.deserialize : (x: any) => x;\n    if (schema && pk) {\n      const row = this.getStore().getRow(type, id);\n      if (row) {\n        return effectiveTransformer(this.deserialize(row, schema));\n      }\n    }\n    return undefined;\n  }\n\n  peekAll<T>(type: string): T[] {\n    const schema = this.getSchema(type);\n    const pk = this.getPrimaryKey(type);\n    const transformer = this.getRecordTransform(type);\n    const effectiveTransformer = transformer ? transformer.deserialize : (x: any) => x;\n    if (schema && pk) {\n      const table = this.getStore().getTable(type);\n      return Object.entries(table).map(([_, row]) => {\n        const thing = effectiveTransformer(this.deserialize(row, schema));\n        return thing as T;\n      });\n    }\n    return [];\n  }\n\n  unloadRecord<T>(type: string, id: string): T | undefined {\n    const record = this.peekRecord<T>(type, id);\n    if (record) {\n      this.getStore().delRow(type, id);\n    }\n    return record;\n  }\n\n  unloadAll(type: string) {\n    if (this.getSchema(type)) {\n      this.getStore().delTable(type);\n    }\n  }\n\n  reset() {\n    Object.entries(this.schemas).forEach(([schemaName, _]) => {\n      this.unloadAll(schemaName);\n    });\n  }\n\n  // Need to get the raw tinybase store? use this method\n  getStore() {\n    return this.store;\n  }\n\n  // Need to get the raw tinybase query views? use this method\n  getQueries() {\n    return this.queries;\n  }\n}\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\nimport { Provider as TinyBaseProvider } from 'tinybase/ui-react';\nimport type { MicroStore } from './microstore';\n\nconst StoreContext = createContext<MicroStore | null>(null);\n\nexport function useMicroStore(): MicroStore | null {\n  const store = useContext(StoreContext);\n\n  return store;\n}\n\ntype WithExistingStore = { store: MicroStore; children: ReactNode };\n\nexport function MicroStoreProvider(props: WithExistingStore) {\n  const store = useMemo(() => props.store, [props]);\n\n  // TODO: Add store.relationships, which can be passed to tinybase\n  return (\n    <StoreContext.Provider value={store}>\n      <TinyBaseProvider store={store.getStore()} queries={store.getQueries()}>\n        {props.children}\n      </TinyBaseProvider>\n    </StoreContext.Provider>\n  );\n}\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\n// This whole file will get \"genericized\" so that it can wrap any useQuery that we currently use\n// Right now it is hard coded to do object stuff...\n// The same logic can be made more abstract and receive a couple more\n// arguments to then handle ANYTHING. :)\nimport { useEffect, useRef, useState } from 'react';\nimport { type Queries } from 'tinybase';\nimport { useQueries, useResultTable } from 'tinybase/ui-react';\nimport { useMicroStore } from './provider';\nimport type { MicroStoreSchema } from './types';\n\nfunction generateFilter(data: any[] | undefined, pk: string) {\n  return data ? data.map((obj) => obj[pk]) : [];\n}\n\nfunction resetQueryDefinition(\n  type: string,\n  schema: MicroStoreSchema,\n  pk: string,\n  queryName: string,\n  queries: Queries,\n  filter: string[]\n) {\n  // So what exactly does this do? It returns all the same tinybase rows that are\n  // returned by the same React query being referenced by this reactive wrapper!!\n  // That way, when the rows from useResultTable change due to some localized store\n  // update through the MicroStore engine, we see those changes reflected without\n  // additional server traffic!\n  queries.setQueryDefinition(queryName, type, ({ select, where }) => {\n    Object.keys(schema).forEach((k) => {\n      select(k);\n    });\n    where((getCell) => filter.includes(<string>getCell(pk)));\n  });\n}\n\n// Wrap the objects in tinybase rows to make them react at a record level\n// to individual record changes\nexport function useReactive<T>(type: string, data: T[]): T[] {\n  const store = useMicroStore();\n  const schema = store?.getSchema(type);\n  const pk = store?.getPrimaryKey(type);\n  if (!schema || !pk) {\n    throw new Error(`No MicroStore schema defined for type ${type}`);\n  }\n  const [uniqueHookID, _] = useState(crypto.randomUUID());\n  const queries = useQueries();\n  const rows = useResultTable(uniqueHookID, queries);\n  const [lastFilter, setLastFilter] = useState('');\n  // Air Brake prevents render loops if a user does something very silly like chasing\n  // records in a circle\n  const airBrake = useRef('');\n\n  // Why is this effect important? Because you ONLY want to update the thing\n  // that is bubbling out new rows (the query) if the supporting REST request\n  // with its own internal IDs has changed. We\n  useEffect(() => {\n    if (queries) {\n      const filter = generateFilter(data, pk);\n      const stringifiedFilter = JSON.stringify(filter);\n      if (lastFilter !== stringifiedFilter && airBrake.current !== stringifiedFilter) {\n        if (Object.entries(rows).length > 0) {\n          airBrake.current = stringifiedFilter;\n        }\n        setLastFilter(stringifiedFilter);\n        resetQueryDefinition(type, schema, pk, uniqueHookID, queries, filter);\n      }\n    }\n  }, [data, pk, schema, type, queries, uniqueHookID, lastFilter, rows, airBrake]);\n\n  const transformer = store?.getRecordTransform(type);\n  const effectiveTransformer = transformer ? transformer.deserialize : (x: any) => x;\n  const returnData: T[] = [];\n  data.forEach((item: any) => {\n    const identifier = item[pk];\n    const possibleRow = rows[identifier];\n    if (possibleRow) {\n      const thing: any = store?.deserialize(possibleRow, schema);\n      returnData.push(effectiveTransformer(thing) as T);\n    }\n  });\n  return returnData;\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import {singularize,pluralize}from'ember-inflector';import {camelCase,isArray,omit}from'lodash-es';import {createStore,createQueries}from'tinybase';import {createContext,useContext,useMemo,useState,useRef,useEffect}from'react';import {Provider,useQueries,useResultTable}from'tinybase/ui-react';import {jsx}from'react/jsx-runtime';var K=Object.defineProperty;var z=(o,e,r)=>e in o?K(o,e,{enumerable:true,configurable:true,writable:true,value:r}):o[e]=r;var f=(o,e,r)=>z(o,typeof e!="symbol"?e+"":e,r);function l(o,e){let r={data:[],meta:void 0},s;return o!==void 0&&Object.keys(o).forEach(t=>{let i=o[t];if(t!=="meta"){let n=[],c=camelCase(singularize(t));isArray(i)?i.forEach(a=>{n.push(a);}):n.push(i),r.data.push({data:n,type:c});}else s=o[t];}),r.meta=s,r}var p={serialize(o){return o?JSON.stringify(o):null},deserialize(o){return o?JSON.parse(o):null}};var N=["transform","primaryKey"],q={json:p},y=class{constructor(e){f(this,"schemas");f(this,"fieldTransforms");f(this,"recordTransforms");f(this,"store");f(this,"queries");f(this,"interpreter");f(this,"primaryKeys");this.primaryKeys={},this.schemas=e.schemas?e.schemas:{},this.fieldTransforms={...e.fieldTransforms?e.fieldTransforms:{},...q},this.recordTransforms=e.recordTransforms?e.recordTransforms:{},this.interpreter=e.interpreter?e.interpreter:l,this.store=createStore(),this.store.setTablesSchema(this.transformSchemas()),this.queries=createQueries(this.store);}transformSchemas(){let e={};return Object.keys(this.schemas).forEach(r=>{if(e[r]={},Object.keys(this.schemas[r]).forEach(s=>{if(e[r][s]=omit(this.schemas[r][s],N),this.schemas[r][s].primaryKey&&this.schemas[r][s].type==="string"){if(this.primaryKeys[r])throw Error(`More than one primary key defined for schema ${r}`);this.primaryKeys[r]=s;}}),!this.getPrimaryKey(r)&&this.schemas[r].id&&this.schemas[r].id.type==="string"&&(this.primaryKeys[r]="id"),!this.getPrimaryKey(r))throw Error(`No primary key defined for schema ${r}. This schema must have an 'id' field of "type": "string", or another field of "type": "string" with "primaryKey": true.`)}),e}getPrimaryKey(e){let r=this.primaryKeys[e];return r||void 0}getSchema(e){return e&&Object.hasOwn(this.schemas,e)?this.schemas[e]:null}getRecordTransform(e){if(e)return this.recordTransforms[e]?this.recordTransforms[e]:void 0}getFieldTransform(e){if(e)return this.fieldTransforms[e]?this.fieldTransforms[e]:void 0}serialize(e,r){let s={};return Object.keys(e).forEach(t=>{let i=r[t];if(i){let n=this.getFieldTransform(i.transform);s[t]=n?n.serialize(e[t]):e[t];}}),s}deserialize(e,r){let s={};return Object.keys(e).forEach(t=>{let i=r[t];if(i){let n=i.transform&&this.fieldTransforms[i.transform]?this.fieldTransforms[i.transform]:void 0;s[t]=n?n.deserialize(e[t]):e[t];}}),s}pushRecord(e,r,s,t={}){return this.pushRecords(e,[r],s,t)}pushRecords(e,r,s,t={}){let i=this.getRecordTransform(e),n=camelCase(pluralize(e));if(!i)return this.pushPayload(s,{[n]:r},t);let c=r.map(a=>i.serialize(a));return this.pushPayload(s,{[n]:c},t)}pushPayload(e,r,s={}){try{let t=this.interpreter(r,s);return t.data.forEach(i=>{let n=this.getSchema(i.type);if(n){let c=this.getPrimaryKey(i.type)||"id";e==="DELETE"?i.data.forEach(a=>{this.store.delRow(i.type,a[c]);}):e==="PATCH"?i.data.forEach(a=>{this.store.getRow(i.type,a[c])?this.store.setPartialRow(i.type,a[c],this.serialize(a,n)):this.store.setRow(i.type,a[c],this.serialize(a,n));}):i.data.forEach(a=>{this.store.setRow(i.type,a[c],this.serialize(a,n));});}}),t}catch(t){console.warn(t);}}peekRecord(e,r){let s=this.getSchema(e),t=this.getPrimaryKey(e),i=this.getRecordTransform(e),n=i?i.deserialize:c=>c;if(s&&t){let c=this.getStore().getRow(e,r);if(c)return n(this.deserialize(c,s))}}peekAll(e){let r=this.getSchema(e),s=this.getPrimaryKey(e),t=this.getRecordTransform(e),i=t?t.deserialize:n=>n;if(r&&s){let n=this.getStore().getTable(e);return Object.entries(n).map(([c,a])=>i(this.deserialize(a,r)))}return []}unloadRecord(e,r){let s=this.peekRecord(e,r);return s&&this.getStore().delRow(e,r),s}unloadAll(e){this.getSchema(e)&&this.getStore().delTable(e);}reset(){Object.entries(this.schemas).forEach(([e,r])=>{this.unloadAll(e);});}getStore(){return this.store}getQueries(){return this.queries}};var w=createContext(null);function g(){return useContext(w)}function J(o){let e=useMemo(()=>o.store,[o]);return jsx(w.Provider,{value:e,children:jsx(Provider,{store:e.getStore(),queries:e.getQueries(),children:o.children})})}function U(o,e){return o?o.map(r=>r[e]):[]}function G(o,e,r,s,t,i){t.setQueryDefinition(s,o,({select:n,where:c})=>{Object.keys(e).forEach(a=>{n(a);}),c(a=>i.includes(a(r)));});}function X(o,e){let r=g(),s=r?.getSchema(o),t=r?.getPrimaryKey(o);if(!s||!t)throw new Error(`No MicroStore schema defined for type ${o}`);let[i,n]=useState(crypto.randomUUID()),c=useQueries(),a=useResultTable(i,c),[d,E]=useState(""),u=useRef("");useEffect(()=>{if(c){let m=U(e,t),h=JSON.stringify(m);d!==h&&u.current!==h&&(Object.entries(a).length>0&&(u.current=h),E(h),G(o,s,t,i,c,m));}},[e,t,s,o,c,i,d,a,u]);let R=r?.getRecordTransform(o),P=R?R.deserialize:m=>m,S=[];return e.forEach(m=>{let h=m[t],T=a[h];if(T){let v=r?.deserialize(T,s);S.push(P(v));}}),S}export{y as MicroStore,J as MicroStoreProvider,l as RESTInterpreter,p as json,g as useMicroStore,X as useReactive};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/interpreter.ts","../src/transforms.ts","../src/microstore.ts","../src/provider.tsx","../src/reactive.ts"],"names":["RESTInterpreter","data","_options","typedPayload","meta","k","content","typedData","typeName","camelCase","singularize","isArray","item","json","microStoreReservedKeys","defaultFieldTransforms","MicroStore","options","__publicField","createStore","createQueries","transformedSchemas","k2","omit","type","possiblePK","row","schema","serializedRow","field","transform","deserializedRow","method","typeKey","pluralize","rawData","batchedPayload","payload","pk","e","id","transformer","effectiveTransformer","x","table","_","record","schemaName","StoreContext","createContext","useMicroStore","useContext","MicroStoreProvider","props","store","useMemo","jsx","TinyBaseProvider","generateFilter","obj","resetQueryDefinition","queryName","queries","filter","select","where","getCell","useReactive","uniqueHookID","useState","useQueries","rows","useResultTable","lastFilter","setLastFilter","airBrake","useRef","useEffect","stringifiedFilter","returnData","identifier","possibleRow","thing"],"mappings":"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","file":"index.mjs","sourcesContent":["// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport { singularize } from 'ember-inflector';\nimport { camelCase, isArray } from 'lodash-es';\nimport type { InterpreterReturnValue } from './types';\n\nexport function RESTInterpreter(data: Record<string, any>, _options: Record<string, any>) {\n  const typedPayload: InterpreterReturnValue = {\n    data: [],\n    meta: undefined\n  };\n  let meta: Record<string, any> | undefined = undefined;\n\n  if (data !== undefined) {\n    Object.keys(data).forEach((k) => {\n      const content = data[k];\n      if (k !== 'meta') {\n        const typedData: Record<string, any>[] = [];\n        const typeName = camelCase(singularize(k));\n        if (isArray(content)) {\n          content.forEach((item: any) => {\n            typedData.push(item);\n          });\n        } else {\n          typedData.push(content);\n        }\n        typedPayload.data.push({\n          data: typedData,\n          type: typeName\n        });\n      } else {\n        meta = data[k];\n      }\n    });\n  }\n  typedPayload.meta = meta;\n  return typedPayload;\n}\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport type { FieldTransform } from './types';\n\nexport const json: FieldTransform = {\n  serialize(data) {\n    return data ? JSON.stringify(data) : null;\n  },\n  deserialize(data) {\n    return data ? JSON.parse(data) : null;\n  }\n};\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport { pluralize } from 'ember-inflector';\nimport { camelCase, omit } from 'lodash-es';\nimport { createQueries, createStore, type CellSchema, type Queries, type Row, type Store } from 'tinybase';\nimport { RESTInterpreter } from './interpreter';\nimport { json } from './transforms';\nimport type {\n  ConventionalSchema,\n  ConventionalSchemas,\n  FieldTransforms,\n  MethodType,\n  MicrostoreInterpreter,\n  MicroStoreOptions,\n  MicroStoreSchema,\n  MicroStoreSchemas,\n  RawRecord,\n  RawRow,\n  RecordTransforms\n} from './types';\n\nconst microStoreReservedKeys = ['transform', 'primaryKey'];\nconst defaultFieldTransforms = {\n  json\n};\n\nexport class MicroStore {\n  schemas: MicroStoreSchemas;\n  fieldTransforms: FieldTransforms;\n  recordTransforms: RecordTransforms;\n  store: Store;\n  queries: Queries;\n  interpreter: MicrostoreInterpreter;\n  private primaryKeys: Record<string, string>;\n\n  constructor(options: MicroStoreOptions) {\n    this.primaryKeys = {};\n    this.schemas = options.schemas ? options.schemas : {};\n    // Thats right, we even support our own field and record level transforms!\n    this.fieldTransforms = { ...(options.fieldTransforms ? options.fieldTransforms : {}), ...defaultFieldTransforms };\n    this.recordTransforms = options.recordTransforms ? options.recordTransforms : {};\n    this.interpreter = options.interpreter ? options.interpreter : RESTInterpreter;\n    this.store = createStore();\n    this.store.setTablesSchema(this.transformSchemas());\n    this.queries = createQueries(this.store);\n  }\n\n  private transformSchemas() {\n    // we have to remove custom properties or tinybase\n    // will ignore our fields.\n    const transformedSchemas: ConventionalSchemas = {};\n    Object.keys(this.schemas).forEach((k) => {\n      transformedSchemas[k] = <ConventionalSchema>{};\n      Object.keys(this.schemas[k]).forEach((k2) => {\n        transformedSchemas[k][k2] = omit(this.schemas[k][k2], microStoreReservedKeys) as CellSchema;\n        const possiblePK: boolean | undefined = this.schemas[k][k2]['primaryKey'];\n        if (possiblePK && this.schemas[k][k2]['type'] === 'string') {\n          if (this.primaryKeys[k]) {\n            throw Error(`More than one primary key defined for schema ${k}`);\n          }\n          this.primaryKeys[k] = k2;\n        }\n      });\n      // Default PK to id\n      if (!this.getPrimaryKey(k) && this.schemas[k]['id'] && this.schemas[k]['id']['type'] === 'string') {\n        this.primaryKeys[k] = 'id';\n      }\n      if (!this.getPrimaryKey(k)) {\n        throw Error(\n          `No primary key defined for schema ${k}. This schema must have an 'id' field of \"type\": \"string\", or another field of \"type\": \"string\" with \"primaryKey\": true.`\n        );\n      }\n    });\n    return transformedSchemas;\n  }\n\n  getPrimaryKey(type: string) {\n    const possiblePK = this.primaryKeys[type];\n    return possiblePK ? possiblePK : undefined;\n  }\n\n  getSchema(type: string) {\n    if (type) {\n      if (Object.hasOwn(this.schemas, type)) {\n        return this.schemas[type];\n      }\n    }\n    return null;\n  }\n\n  getRecordTransform(type: string | undefined) {\n    if (type) {\n      return this.recordTransforms[type] ? this.recordTransforms[type] : undefined;\n    }\n    return undefined;\n  }\n\n  getFieldTransform(type: string | undefined) {\n    if (type) {\n      return this.fieldTransforms[type] ? this.fieldTransforms[type] : undefined;\n    }\n    return undefined;\n  }\n\n  serialize(row: RawRow, schema: MicroStoreSchema) {\n    const serializedRow: RawRow = {};\n    Object.keys(row).forEach((k) => {\n      const field = schema[k];\n      if (field) {\n        const transform = this.getFieldTransform(field.transform);\n        serializedRow[k] = transform ? transform.serialize(row[k]) : row[k];\n      }\n    });\n    return serializedRow;\n  }\n\n  deserialize(row: Row, schema: MicroStoreSchema) {\n    const deserializedRow: RawRow = {};\n    Object.keys(row).forEach((k) => {\n      const field = schema[k];\n      if (field) {\n        const transform =\n          field.transform && this.fieldTransforms[field.transform] ? this.fieldTransforms[field.transform] : undefined;\n        deserializedRow[k] = transform ? transform.deserialize(row[k]) : row[k];\n      }\n    });\n    return deserializedRow;\n  }\n\n  // pushRecord is a sugar method to take a single record and push it into the store using whatever verb was used\n  pushRecord(type: string, data: RawRecord, method: MethodType, options: Record<string, any> = {}) {\n    return this.pushRecords(type, [data], method, options);\n  }\n\n  // pushRecords handles an incoming data (\"row\"s) that are in application level format (with dates, blobs, or other complex types that can't be POJO'd)\n  pushRecords(type: string, data: RawRecord[], method: MethodType, options: Record<string, any> = {}) {\n    const transform = this.getRecordTransform(type);\n    const typeKey = camelCase(pluralize(type));\n    if (!transform) {\n      return this.pushPayload(method, { [typeKey]: data }, options);\n    }\n    const rawData = data.map((item) => {\n      return transform.serialize(item);\n    });\n    return this.pushPayload(method, { [typeKey]: rawData }, options);\n  }\n\n  // pushPayload handles incoming data (many \"row\"s) that are in POJO format\n  pushPayload(method: MethodType, data: any, options: Record<string, any> = {}) {\n    try {\n      const batchedPayload = this.interpreter(data, options);\n      batchedPayload.data.forEach((payload) => {\n        const schema = this.getSchema(payload.type);\n        // Only process typed batches that match a defined data schema\n        if (schema) {\n          const pk = this.getPrimaryKey(payload.type) || 'id';\n          if (method === 'DELETE') {\n            payload.data.forEach((row) => {\n              this.store.delRow(payload.type, row[pk]);\n            });\n          } else if (method === 'PATCH') {\n            payload.data.forEach((row) => {\n              // Only try a partial row update if a row already exists\n              if (this.store.getRow(payload.type, row[pk])) {\n                this.store.setPartialRow(payload.type, row[pk], this.serialize(row, schema));\n              } else {\n                this.store.setRow(payload.type, row[pk], this.serialize(row, schema));\n              }\n            });\n          } else {\n            payload.data.forEach((row) => {\n              this.store.setRow(payload.type, row[pk], this.serialize(row, schema));\n            });\n          }\n        }\n      });\n      return batchedPayload;\n    } catch (e) {\n      console.warn(e);\n    }\n  }\n\n  peekRecord<T>(type: string, id: string): T | undefined {\n    const schema = this.getSchema(type);\n    const pk = this.getPrimaryKey(type);\n    const transformer = this.getRecordTransform(type);\n    const effectiveTransformer = transformer ? transformer.deserialize : (x: any) => x;\n    if (schema && pk) {\n      const row = this.getStore().getRow(type, id);\n      if (row) {\n        return effectiveTransformer(this.deserialize(row, schema));\n      }\n    }\n    return undefined;\n  }\n\n  peekAll<T>(type: string): T[] {\n    const schema = this.getSchema(type);\n    const pk = this.getPrimaryKey(type);\n    const transformer = this.getRecordTransform(type);\n    const effectiveTransformer = transformer ? transformer.deserialize : (x: any) => x;\n    if (schema && pk) {\n      const table = this.getStore().getTable(type);\n      return Object.entries(table).map(([_, row]) => {\n        const thing = effectiveTransformer(this.deserialize(row, schema));\n        return thing as T;\n      });\n    }\n    return [];\n  }\n\n  unloadRecord<T>(type: string, id: string): T | undefined {\n    const record = this.peekRecord<T>(type, id);\n    if (record) {\n      this.getStore().delRow(type, id);\n    }\n    return record;\n  }\n\n  unloadAll(type: string) {\n    if (this.getSchema(type)) {\n      this.getStore().delTable(type);\n    }\n  }\n\n  reset() {\n    Object.entries(this.schemas).forEach(([schemaName, _]) => {\n      this.unloadAll(schemaName);\n    });\n  }\n\n  // Need to get the raw tinybase store? use this method\n  getStore() {\n    return this.store;\n  }\n\n  // Need to get the raw tinybase query views? use this method\n  getQueries() {\n    return this.queries;\n  }\n}\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\nimport { Provider as TinyBaseProvider } from 'tinybase/ui-react';\nimport type { MicroStore } from './microstore';\n\nconst StoreContext = createContext<MicroStore | null>(null);\n\nexport function useMicroStore(): MicroStore | null {\n  const store = useContext(StoreContext);\n\n  return store;\n}\n\ntype WithExistingStore = { store: MicroStore; children: ReactNode };\n\nexport function MicroStoreProvider(props: WithExistingStore) {\n  const store = useMemo(() => props.store, [props]);\n\n  // TODO: Add store.relationships, which can be passed to tinybase\n  return (\n    <StoreContext.Provider value={store}>\n      <TinyBaseProvider store={store.getStore()} queries={store.getQueries()}>\n        {props.children}\n      </TinyBaseProvider>\n    </StoreContext.Provider>\n  );\n}\n","// This software is provided to the United States Government (USG) with SBIR Data Rights as defined at Federal Acquisition Regulation 52.227-14, \"Rights in Data-SBIR Program\" (May 2014) SBIR Rights Notice (Dec 2026) These SBIR data are furnished with SBIR rights under Contract No. H9241522D0001. For a period of 19 years, unless extended in accordance with FAR 27.409(h), after acceptance of all items to be delivered under this contract, the Government will use these data for Government purposes only, and they shall not be disclosed outside the Government (including disclosure for procurement purposes) during such period without permission of the Contractor, except that, subject to the foregoing use and disclosure prohibitions, these data may be disclosed for use by support Contractors. After the protection period, the Government has a paid-up license to use, and to authorize others to use on its behalf, these data for Government purposes, but is relieved of all disclosure prohibitions and assumes no liability for unauthorized use of these data by third parties. This notice shall be affixed to any reproductions of these data, in whole or in part.\n// This whole file will get \"genericized\" so that it can wrap any useQuery that we currently use\n// Right now it is hard coded to do object stuff...\n// The same logic can be made more abstract and receive a couple more\n// arguments to then handle ANYTHING. :)\nimport { useEffect, useRef, useState } from 'react';\nimport { type Queries } from 'tinybase';\nimport { useQueries, useResultTable } from 'tinybase/ui-react';\nimport { useMicroStore } from './provider';\nimport type { MicroStoreSchema } from './types';\n\nfunction generateFilter(data: any[] | undefined, pk: string) {\n  return data ? data.map((obj) => obj[pk]) : [];\n}\n\nfunction resetQueryDefinition(\n  type: string,\n  schema: MicroStoreSchema,\n  pk: string,\n  queryName: string,\n  queries: Queries,\n  filter: string[]\n) {\n  // So what exactly does this do? It returns all the same tinybase rows that are\n  // returned by the same React query being referenced by this reactive wrapper!!\n  // That way, when the rows from useResultTable change due to some localized store\n  // update through the MicroStore engine, we see those changes reflected without\n  // additional server traffic!\n  queries.setQueryDefinition(queryName, type, ({ select, where }) => {\n    Object.keys(schema).forEach((k) => {\n      select(k);\n    });\n    where((getCell) => filter.includes(<string>getCell(pk)));\n  });\n}\n\n// Wrap the objects in tinybase rows to make them react at a record level\n// to individual record changes\nexport function useReactive<T>(type: string, data: T[]): T[] {\n  const store = useMicroStore();\n  const schema = store?.getSchema(type);\n  const pk = store?.getPrimaryKey(type);\n  if (!schema || !pk) {\n    throw new Error(`No MicroStore schema defined for type ${type}`);\n  }\n  const [uniqueHookID, _] = useState(crypto.randomUUID());\n  const queries = useQueries();\n  const rows = useResultTable(uniqueHookID, queries);\n  const [lastFilter, setLastFilter] = useState('');\n  // Air Brake prevents render loops if a user does something very silly like chasing\n  // records in a circle\n  const airBrake = useRef('');\n\n  // Why is this effect important? Because you ONLY want to update the thing\n  // that is bubbling out new rows (the query) if the supporting REST request\n  // with its own internal IDs has changed. We\n  useEffect(() => {\n    if (queries) {\n      const filter = generateFilter(data, pk);\n      const stringifiedFilter = JSON.stringify(filter);\n      if (lastFilter !== stringifiedFilter && airBrake.current !== stringifiedFilter) {\n        if (Object.entries(rows).length > 0) {\n          airBrake.current = stringifiedFilter;\n        }\n        setLastFilter(stringifiedFilter);\n        resetQueryDefinition(type, schema, pk, uniqueHookID, queries, filter);\n      }\n    }\n  }, [data, pk, schema, type, queries, uniqueHookID, lastFilter, rows, airBrake]);\n\n  const transformer = store?.getRecordTransform(type);\n  const effectiveTransformer = transformer ? transformer.deserialize : (x: any) => x;\n  const returnData: T[] = [];\n  data.forEach((item: any) => {\n    const identifier = item[pk];\n    const possibleRow = rows[identifier];\n    if (possibleRow) {\n      const thing: any = store?.deserialize(possibleRow, schema);\n      returnData.push(effectiveTransformer(thing) as T);\n    }\n  });\n  return returnData;\n}\n"]}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@black-cape/microstore",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "tsc --noEmit --pretty",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
+    "test:compatibility": "node test-compatibility.js",
+    "clean": "rm -rf dist",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "react",
+    "typescript",
+    "state-management",
+    "data-normalization",
+    "normalizer",
+    "reactive",
+    "store",
+    "rest",
+    "api",
+    "crud",
+    "tinybase",
+    "single-source-of-truth",
+    "react-hooks",
+    "cache",
+    "orm",
+    "immutable",
+    "real-time",
+    "rest-envelope"
+  ],
+  "homepage": "https://github.com/black-cape/microstore",
+  "repository": "https://github.com/black-cape/microstore",
+  "authors": [
+    {
+      "name": "Michael Conaway",
+      "email": "mdconaway@noreply.github.com"
+    }
+  ],
+  "organization": {
+    "name": "Black Cape",
+    "url": "https://github.com/black-cape"
+  },
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "ember-inflector": "^6.0.0",
+    "lodash-es": "^4.17.22",
+    "tinybase": ">=5.4.9"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-compiler-runtime": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/lodash-es": "^4.17.12",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "prettier": "^3.8.0",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}