@curvhex/orm 0.1.2 → 0.1.4

package/README.md

@@ -1,485 +1,40 @@
-# Curvhex ORM
+<p align="center">
+  <img src="docs/public/logo.svg" width="80" alt="Curvhex ORM" />
+</p>
 
-TypeScript ORM for Solana PDA accounts. Query, filter, and aggregate on-chain data with a familiar API — inspired by Prisma, built for Solana.
+<h1 align="center">Curvhex ORM</h1>
 
-```typescript
-const users = await orm.models.userAccount.findMany({
-  where:   { authority: wallet.publicKey, isActive: true },
-  orderBy: { balance: 'desc' },
-  take:    10,
-})
-```
-
----
-
-## The Problem
-
-Solana stores program state in accounts (PDAs). Querying them is painful:
-
-- `getProgramAccounts` only supports exact byte matching (`memcmp`)
-- No range queries, sorting, aggregation, or relations at the RPC level
-- Every project reimplements the same deserialization + filtering boilerplate
-- Switching from a public RPC to an indexer (Helius, your own Postgres) requires rewriting query logic
-
-Curvhex ORM solves this with a single, adapter-agnostic query API.
-
----
+<p align="center">
+  TypeScript ORM for Solana PDA accounts.<br/>
+  Query, filter, and aggregate on-chain data with a Prisma-style API.
+</p>
 
-## How It Works
-
-```
-Your Code  →  CurvhexORM  →  QueryAdapter  →  Data Source
-                                ├── RpcAdapter       (getProgramAccounts)
-                                ├── HeliusAdapter    (DAS API)        [soon]
-                                └── PostgresAdapter  (your indexer)   [soon]
-```
-
-Define your schema once. Write queries once. Swap the adapter as your needs grow — from a quick prototype on public RPC to a production indexer — without changing a single query.
-
----
-
-## Installation
-
-```bash
-npm install curvhex-orm @solana/web3.js
-```
+<p align="center">
+  <a href="https://curvhex-lab.github.io/orm/">Documentation</a> ·
+  <a href="https://curvhex-lab.github.io/orm/guide/quick-start">Quick Start</a> ·
+  <a href="https://www.npmjs.com/package/@curvhex/orm">npm</a>
+</p>
 
 ---
 
-## Quick Start
-
-### 1. Define your schema
-
-```typescript
-import { defineModel, anchor } from 'curvhex-orm'
-
-const UserAccount = defineModel({
-  // Anchor programs: use anchor() helper
-  discriminator: anchor('UserAccount'),
-
-  // Native programs: provide raw bytes
-  // discriminator: [1, 2, 3, 4, 5, 6, 7, 8],
-
-  fields: {
-    authority: { type: 'publicKey' },
-    balance:   { type: 'u64' },
-    tier:      { type: 'u8' },
-    isActive:  { type: 'bool' },
-    name:      { type: 'string' },
-  }
-})
-```
-
-Field offsets are calculated automatically from the discriminator length and field order — no manual byte counting.
-
-### 2. Create the ORM
-
 ```typescript
-import { CurvhexORM, RpcAdapter } from 'curvhex-orm'
-import { Connection, PublicKey } from '@solana/web3.js'
-
-const connection = new Connection('https://api.mainnet-beta.solana.com')
-
-const orm = new CurvhexORM({
-  connection,
-  programId: 'YOUR_PROGRAM_ID',
-  models: { UserAccount },
-})
-```
-
-### 3. Query
-
-```typescript
-// Find by PDA seeds
-const user = await orm.models.userAccount.findByPda([
-  Buffer.from('user'),
-  wallet.publicKey.toBuffer(),
-])
-
-// Find by address
-const user = await orm.models.userAccount.findByAddress('Abc123...')
-
-// Find many with filters
 const users = await orm.models.userAccount.findMany({
-  where:   { isActive: true, authority: wallet.publicKey.toBase58() },
-  orderBy: { balance: 'desc' },
-  take:    20,
-  skip:    0,
-})
-```
-
----
-
-## API Reference
-
-### `defineModel(input)`
-
-Defines an account schema. Offsets are computed automatically.
-
-```typescript
-const MyAccount = defineModel({
-  discriminator: anchor('MyAccount'), // or raw number[]
-  fields: {
-    owner:   { type: 'publicKey' },
-    amount:  { type: 'u64' },
-    enabled: { type: 'bool' },
-  }
-})
-```
-
-**Supported field types:**
-
-| Type | Size | TypeScript type |
-|------|------|-----------------|
-| `u8` `u16` `u32` | 1–4 bytes | `number` |
-| `i8` `i16` `i32` | 1–4 bytes | `number` |
-| `u64` `u128` | 8–16 bytes | `bigint` |
-| `i64` `i128` | 8–16 bytes | `bigint` |
-| `bool` | 1 byte | `boolean` |
-| `publicKey` | 32 bytes | `string` (base58) |
-| `string` | 4 + N bytes | `string` |
-| `bytes` | 4 + N bytes | `string` (hex) |
-
-### `anchor(name)`
-
-Computes the 8-byte Anchor discriminator for an account name.
-
-```typescript
-import { anchor } from 'curvhex-orm'
-
-anchor('UserAccount') // → [149, 88, 201, ...]
-```
-
-### `findMany(options?)`
-
-```typescript
-const results = await orm.models.userAccount.findMany({
-  where: {
-    // Equality (on-chain memcmp — fast)
-    authority: 'Abc123...',
-    isActive:  true,
-    tier:      2,
-
-    // Range operators (client-side filter)
-    balance: { gte: 100n, lte: 10_000n },
-    balance: { gt: 0n },
-    tier:    { in: [1, 2, 3] },
-    balance: { between: [100n, 1000n] },
-    tier:    { not: 0 },
-  },
-  orderBy: { balance: 'desc' },
-  take:    10,
-  skip:    0,
-  dataSize: 165, // optional: filter by account byte size
-})
-```
-
-> **On-chain vs client-side:** Equality filters (`authority`, `isActive`, `tier`) are sent as `memcmp` filters to the RPC node — only matching accounts are transferred. Range operators (`gt`, `gte`, `lt`, `lte`, `between`, `in`) are applied after accounts are received. Combine both for best performance.
-
-### `findFirst(options?)`
-
-Returns the first matching account or `null`.
-
-```typescript
-const user = await orm.models.userAccount.findFirst({
-  where: { authority: wallet.publicKey.toBase58() }
-})
-```
-
-### `findByAddress(address)`
-
-Fetches a single account by its public key string.
-
-```typescript
-const user = await orm.models.userAccount.findByAddress('Abc123...')
-```
-
-### `findByPda(seeds)`
-
-Derives the PDA and fetches the account.
-
-```typescript
-const user = await orm.models.userAccount.findByPda([
-  Buffer.from('user'),
-  wallet.publicKey.toBuffer(),
-])
-```
-
-### `count(where?)`
-
-```typescript
-const total = await orm.models.userAccount.count({ isActive: true })
-```
-
-### `aggregate(options)`
-
-```typescript
-const stats = await orm.models.userAccount.aggregate({
-  where:  { isActive: true },
-  _count: true,
-  _sum:   { balance: true },
-  _avg:   { balance: true },
-  _min:   { balance: true },
-  _max:   { balance: true },
-})
-// → { _count: 142, _sum: { balance: 5_000_000n }, _avg: ..., _min: ..., _max: ... }
-```
-
-### `groupBy(options)`
-
-```typescript
-const byTier = await orm.models.userAccount.groupBy({
-  by:    ['tier'],
-  where: { isActive: true },
-  _count: true,
-  _sum:  { balance: true },
-})
-// → [
-//     { tier: 2, _count: 40,  _sum: { balance: 2_000_000n } },
-//     { tier: 1, _count: 102, _sum: { balance: 3_000_000n } },
-//   ]
-```
-
-### `findMany` with `include` (Relations)
-
-Fetch related accounts in a single call. Deduplicates addresses automatically — if 100 vaults share the same owner, the owner account is fetched once.
-
-```typescript
-const VaultAccount = defineModel({
-  discriminator: anchor('VaultAccount'),
-  fields: {
-    ownerPubkey: { type: 'publicKey' },
-    totalLocked: { type: 'u64' },
-  }
-})
-
-const vaults = await orm.models.vaultAccount.findMany({
-  where: { totalLocked: { gt: 1000n } },
-  include: {
-    owner: {
-      model:      UserAccount,
-      foreignKey: 'ownerPubkey',
-    }
-  }
-})
-// → [{ address, totalLocked, owner: { authority, balance, tier } }]
-```
-
----
-
-## Adapters
-
-The query API is adapter-agnostic. Swap the data source without changing your queries.
-
-### RpcAdapter (default)
-
-Works with any Solana RPC endpoint. No setup required.
-
-```typescript
-import { CurvhexORM, RpcAdapter } from 'curvhex-orm'
-
-const orm = new CurvhexORM({
-  connection,
-  programId: 'YOUR_PROGRAM_ID',
-  models:    { UserAccount },
-  // adapter defaults to RpcAdapter
-})
-```
-
-**Limitations:** `getProgramAccounts` is rate-limited or blocked on many public endpoints for large programs. Range queries require fetching all matching accounts first.
-
-### HeliusAdapter *(coming soon)*
-
-Uses the Helius DAS API. Faster, higher rate limits, better support for large programs.
-
-```typescript
-import { HeliusAdapter } from 'curvhex-orm/adapters'
-
-const orm = new CurvhexORM({
-  connection,
-  programId: 'YOUR_PROGRAM_ID',
-  models:    { UserAccount },
-  adapter:   new HeliusAdapter({ apiKey: 'your-helius-key' }),
-})
-```
-
-### PostgresAdapter *(coming soon)*
-
-Query your own Geyser-indexed database. Enables true range queries, sorting, and aggregation at the database level.
-
-```typescript
-import { PostgresAdapter } from 'curvhex-orm/adapters'
-
-const orm = new CurvhexORM({
-  connection,
-  programId: 'YOUR_PROGRAM_ID',
-  models:    { UserAccount },
-  adapter:   new PostgresAdapter({
-    connectionString: 'postgresql://user:pass@localhost:5432/mydb',
-    table:            'user_accounts',
-  }),
-})
-```
-
----
-
-## Architecture
-
-### Why adapters?
-
-Solana's native RPC (`getProgramAccounts`) only supports exact byte matching. Range queries, sorting, and aggregation require off-chain infrastructure.
-
-Rather than picking one solution, Curvhex ORM abstracts the data source:
-
+  where: { authority: wallet.publicKey, isActive: true },
+  orderBy: { balance: "desc" },
+  take: 10,
+});
 ```
-findMany({ where: { balance: { gt: 100n } } })
-  │
-  ├── RpcAdapter       → fetch all + client-side filter
-  ├── HeliusAdapter    → Helius API query
-  └── PostgresAdapter  → SELECT * WHERE balance > 100
-```
-
-As the Solana ecosystem matures (Triton's RPC 2.0, indexers), adapters can be upgraded independently.
-
-### On-chain vs off-chain filtering
-
-| Filter type | RpcAdapter | HeliusAdapter | PostgresAdapter |
-|-------------|-----------|---------------|-----------------|
-| Equality (`authority = X`) | ✅ on-chain memcmp | ✅ | ✅ |
-| Range (`balance > 100`) | ⚠️ client-side | ✅ | ✅ |
-| Sorting | ⚠️ client-side | ✅ | ✅ |
-| Aggregation | ⚠️ client-side | partial | ✅ |
-| Relations (`include`) | ⚠️ N+1 fetches | ⚠️ N+1 fetches | ✅ JOIN |
-
-### Data consistency
-
-When using off-chain adapters (Helius, Postgres), there is an inherent indexer lag of 1–2 slots (~400–800ms). For critical reads (balance checks before transactions), use `findByAddress` or `findByPda` which always hit the RPC directly.
-
----
-
-## Roadmap
-
-- [x] Schema definition with automatic offset calculation
-- [x] Borsh deserialization (all primitive types)
-- [x] `findMany` — memcmp filters + client-side range operators
-- [x] `findFirst`, `findByAddress`, `findByPda`
-- [x] `count`, `aggregate`, `groupBy`
-- [x] `include` — relation loading with deduplication
-- [x] Anchor discriminator helper (`anchor()`)
-- [x] Adapter pattern (`QueryAdapter` interface)
-- [x] `RpcAdapter`
-- [ ] `HeliusAdapter`
-- [ ] `PostgresAdapter` + Geyser sync guide
-- [ ] Cursor-based pagination
-- [ ] WebSocket subscriptions (`watch`)
-- [ ] Enum field support
-- [ ] Option<T> field support
-- [ ] Vec<T> field support
-- [ ] CLI: generate schema from IDL
-- [ ] RPC 2.0 adapter (Triton)
-
----
-
-## Contributing
-
-Contributions are welcome. Here's how to get started:
-
-### Setup
-
-```bash
-git clone https://github.com/your-username/curvhex-orm
-cd curvhex-orm
-npm install
-```
-
-### Project structure
-
-```
-src/
-├── core/
-│   ├── types.ts          — field types, ModelDefinition, InferModel
-│   ├── schema.ts         — defineModel, anchor(), offset calculation
-│   ├── deserializer.ts   — Buffer → TypeScript object
-│   └── filters.ts        — memcmp builder, client-side filter logic
-├── adapters/
-│   ├── abstract/
-│   │   └── QueryAdapter.ts   — adapter interface
-│   └── RpcAdapter.ts         — getProgramAccounts implementation
-├── client/
-│   ├── CurvhexClient.ts   — findMany, findFirst, aggregate, groupBy, include
-│   └── CurvhexORM.ts      — entry point, wires models to adapter
-└── __tests__/
-    └── integration.test.ts
-```
-
-### Where to contribute
-
-Good first issues:
-
-- **`HeliusAdapter`** — implement `QueryAdapter` using the Helius DAS API
-- **`PostgresAdapter`** — implement `QueryAdapter` using `pg` or `postgres` client
-- **`Vec<T>` field support** — extend `FieldType` and the deserializer
-- **`Option<T>` field support** — handle Borsh option prefix byte
-- **Enum fields** — map `u8` values to string variants via schema
-- **Cursor-based pagination** — add `cursor` to `FindManyOptions`
-- **`watch()`** — WebSocket subscription wrapping `onAccountChange`
-
-### Implementing a new adapter
-
-Create a file under `src/adapters/` and implement the `QueryAdapter` interface:
 
-```typescript
-import { QueryAdapter, FindManyOptions } from './abstract/QueryAdapter'
-import { ModelDefinition, InferModel } from '../core/types'
-
-export class MyAdapter implements QueryAdapter {
-  async findMany<M extends ModelDefinition>(
-    model: M,
-    options: FindManyOptions<M>
-  ): Promise<InferModel<M>[]> {
-    // your implementation
-  }
-
-  async findByAddress<M extends ModelDefinition>(
-    model: M,
-    address: string
-  ): Promise<InferModel<M> | null> {
-    // your implementation
-  }
-
-  async findByPda<M extends ModelDefinition>(
-    model: M,
-    seeds: (Buffer | Uint8Array)[]
-  ): Promise<InferModel<M> | null> {
-    // your implementation
-  }
-}
-```
-
-Then export it from `src/index.ts` and add a test case to `integration.test.ts`.
-
-### Before submitting a PR
+## Installation
 
 ```bash
-npx tsc --noEmit                          # type check
-npx tsx src/__tests__/integration.test.ts # run tests
+npm install @curvhex/orm @solana/web3.js
 ```
 
-All 8 integration test cases must pass. If you're adding a new adapter, add at least `findByAddress` and `findMany` test cases using a mock or a real endpoint.
-
-### Commit style
-
-```
-feat: add HeliusAdapter
-fix: handle empty discriminator in buildFilters
-docs: add Vec<T> field type to README
-```
+## Documentation
 
----
+Full documentation at **[curvhex-labs.github.io/orm](https://curvhex-lab.github.io/orm/)**.
 
 ## License
 
 Apache 2.0 with Commons Clause.
-
-Free to use in your own projects. You may not sell this software or offer it as a hosted service without a commercial license.
-

package/dist/core/filters.d.ts

@@ -33,6 +33,7 @@ export interface ClientFilter {
         offset: number;
     };
     condition: {
+        eq?: any;
         gt?: any;
         gte?: any;
         lt?: any;

package/dist/core/filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/core/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAGtD,MAAM,MAAM,aAAa,CAAC,CAAC,IACrB,CAAC,GACD;IAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;CAAE,CAAC;AAExF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,IAAI;KAChD,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC;CAChD,CAAC;AA4CF,wBAAgB,YAAY,CAAC,CAAC,SAAS,eAAe,EAClD,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB;IAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAAC,aAAa,EAAE,YAAY,EAAE,CAAA;CAAE,CAoC5D;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,SAAS,EAAE;QAAE,EAAE,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAC;QAAC,EAAE,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAC;QAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;CACxG;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,OAAO,EAAE,CAAC,EAAE,EACZ,aAAa,EAAE,YAAY,EAAE,GAC9B,CAAC,EAAE,CAmBL"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/core/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAGtD,MAAM,MAAM,aAAa,CAAC,CAAC,IACrB,CAAC,GACD;IAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;CAAE,CAAC;AAExF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,IAAI;KAChD,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC;CAChD,CAAC;AA4CF,wBAAgB,YAAY,CAAC,CAAC,SAAS,eAAe,EAClD,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB;IAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAAC,aAAa,EAAE,YAAY,EAAE,CAAA;CAAE,CAqC5D;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,SAAS,EAAE;QAAE,EAAE,CAAC,EAAE,GAAG,CAAC;QAAC,EAAE,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAC;QAAC,EAAE,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAC;QAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;CAClH;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,OAAO,EAAE,CAAC,EAAE,EACZ,aAAa,EAAE,YAAY,EAAE,GAC9B,CAAC,EAAE,CAoBL"}

package/dist/core/filters.js

@@ -63,7 +63,8 @@ function buildFilters(model, where) {
         const eqValue = isDirectValue(condition)
             ? condition
             : condition?.eq;
-        if (eqValue !== undefined) {
+        // offset === -1 means field comes after a variable-length field — must filter client-side
+        if (eqValue !== undefined && fieldDef.offset !== -1) {
             const encoded = encodeValue(fieldDef.type, eqValue);
             rpcFilters.push({
                 memcmp: {
@@ -73,13 +74,15 @@ function buildFilters(model, where) {
             });
             continue;
         }
-        clientFilters.push({ fieldName, fieldDef, condition: condition });
+        clientFilters.push({ fieldName, fieldDef, condition: isDirectValue(condition) ? { eq: condition } : condition });
     }
     return { rpcFilters, clientFilters };
 }
 function applyClientFilters(records, clientFilters) {
     return records.filter(record => clientFilters.every(({ fieldName, condition }) => {
         const val = record[fieldName];
+        if (condition.eq !== undefined && val !== condition.eq)
+            return false;
         if (condition.gt !== undefined && !(val > condition.gt))
             return false;
         if (condition.gte !== undefined && !(val >= condition.gte))

package/dist/core/filters.js.map

@@ -1 +1 @@
-{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/core/filters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/core/filters.ts"],"names":[],"mappings":"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"}

package/dist/core/schema.d.ts

@@ -2,6 +2,7 @@ import type { FieldType, ModelDefinition } from "./types";
 export declare function anchor(name: string): number[];
 type FieldInput = {
     type: FieldType;
+    maxLen?: number;
 };
 type ModelInput = {
     discriminator: number[];

package/dist/core/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,eAAe,EAAE,MAAM,SAAS,CAAC;AAI3E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK7C;AAcD,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AACtC,KAAK,UAAU,GAAG;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC,CAAC;AAEF,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAa3E"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,eAAe,EAAE,MAAM,SAAS,CAAC;AAI3E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK7C;AAcD,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACvD,KAAK,UAAU,GAAG;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC,CAAC;AAEF,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAqB3E"}

package/dist/core/schema.js

@@ -24,10 +24,19 @@ const FIELD_SIZES = {
 function defineModel(input) {
     const fields = {};
     let offset = input.discriminator.length;
+    let dynamicOffset = false; // true after first variable-length field
     for (const [name, field] of Object.entries(input.fields)) {
-        const size = FIELD_SIZES[field.type];
-        fields[name] = { type: field.type, offset };
-        offset += size === 0 ? 4 : size;
+        const baseSize = FIELD_SIZES[field.type];
+        // -1 signals "offset unknown at compile time — must filter client-side"
+        fields[name] = { type: field.type, offset: dynamicOffset ? -1 : offset, maxLen: field.maxLen };
+        if (baseSize === 0) {
+            // string/bytes: actual on-chain size is dynamic, all subsequent offsets are unknown
+            dynamicOffset = true;
+            offset = -1;
+        }
+        else if (!dynamicOffset) {
+            offset += baseSize;
+        }
     }
     return { discriminator: input.discriminator, fields };
 }

package/dist/core/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":";;AAIA,wBAKC;AAoBD,kCAaC;AAzCD,mCAAoC;AAEpC,oEAAoE;AACpE,SAAgB,MAAM,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC;SAC5B,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;SACzB,MAAM,EAAE,CAAC;IACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,WAAW,GAA8B;IAC3C,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACZ,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;IAClB,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;CACX,CAAC;AAQF,SAAgB,WAAW,CAAuB,KAAQ;IACtD,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,IAAI,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC;IAExC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAE5C,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":";;AAIA,wBAKC;AAoBD,kCAqBC;AAjDD,mCAAoC;AAEpC,oEAAoE;AACpE,SAAgB,MAAM,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC;SAC5B,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;SACzB,MAAM,EAAE,CAAC;IACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,WAAW,GAA8B;IAC3C,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACZ,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;IAClB,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;CACX,CAAC;AAQF,SAAgB,WAAW,CAAuB,KAAQ;IACtD,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,IAAI,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC;IACxC,IAAI,aAAa,GAAG,KAAK,CAAC,CAAC,yCAAyC;IAEpE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzC,wEAAwE;QACxE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAE/F,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACjB,oFAAoF;YACpF,aAAa,GAAG,IAAI,CAAC;YACrB,MAAM,GAAG,CAAC,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,QAAQ,CAAC;QACvB,CAAC;IACL,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC"}

package/dist/core/types.d.ts

@@ -2,6 +2,7 @@ export type FieldType = 'u8' | 'u16' | 'u32' | 'u64' | 'u128' | 'i8' | 'i16' | '
 export interface FieldDefinition {
     type: FieldType;
     offset: number;
+    maxLen?: number;
 }
 export interface ModelDefinition {
     discriminator: number[];

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACf,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GACrC,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GACrC,MAAM,GACN,WAAW,GACX,QAAQ,GACR,OAAO,CAAC;AAEd,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,eAAe;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,IAC1C,CAAC,SAAS,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAClD,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAC9D,CAAC,SAAS,MAAM,GAAG,OAAO,GAC1B,CAAC,SAAS,WAAW,GAAG,MAAM,GAC9B,CAAC,SAAS,QAAQ,GAAG,OAAO,GAAG,MAAM,GACrC,KAAK,CAAC;AAGV,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI;KAC/C,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACnE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACf,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GACrC,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GACrC,MAAM,GACN,WAAW,GACX,QAAQ,GACR,OAAO,CAAC;AAEd,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,eAAe;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,IAC1C,CAAC,SAAS,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAClD,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAC9D,CAAC,SAAS,MAAM,GAAG,OAAO,GAC1B,CAAC,SAAS,WAAW,GAAG,MAAM,GAC9B,CAAC,SAAS,QAAQ,GAAG,OAAO,GAAG,MAAM,GACrC,KAAK,CAAC;AAGV,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,eAAe,IAAI;KAC/C,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CACnE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curvhex/orm",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "TypeScript ORM for Solana PDA accounts",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,7 +12,10 @@
   },
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   },
   "keywords": [
     "solana",
@@ -29,6 +32,7 @@
     "@solana/web3.js": "^1.98.0",
     "@types/node": "^25.9.3",
     "tsx": "^4.19.4",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitepress": "^1.6.4"
   }
 }