@ocap/indexdb-sqlite 1.29.5

package/README.md

@@ -0,0 +1,84 @@
+# [**@ocap/indexdb-sqlite**](https://github.com/arcblock/blockchain)
+
+> OCAP indexdb adapter that uses SQLite as backend via [Kysely](https://kysely.dev/)
+
+## Install
+
+```sh
+npm install @ocap/indexdb-sqlite
+// or
+bun install @ocap/indexdb-sqlite
+```
+
+## Usage
+
+### In-Memory Mode
+
+For testing or ephemeral data:
+
+```js
+const SqliteIndexDB = require('@ocap/indexdb-sqlite').default;
+
+const indexdb = new SqliteIndexDB({ filename: ':memory:' });
+await indexdb.initialize();
+
+// Use indexdb...
+await indexdb.tx.insert({ hash: 'abc123', sender: 'z1...' });
+
+// Close when done
+await indexdb.close();
+```
+
+### File Mode
+
+For persistent storage:
+
+```js
+const SqliteIndexDB = require('@ocap/indexdb-sqlite').default;
+
+const indexdb = new SqliteIndexDB({ filename: '/path/to/indexdb.sqlite' });
+await indexdb.initialize();
+
+// Data persists across restarts
+```
+
+## Features
+
+- WAL mode enabled by default for better concurrent read performance
+- Automatic migrations on initialization
+- Generated columns for big number sorting (balances up to 24+ digits)
+- Full-featured list methods with filtering, pagination, and sorting
+- All 12 index tables: tx, account, asset, token, factory, stake, delegation, rollup, etc.
+
+## Big Number Sorting
+
+SQLite cannot natively sort numeric strings as numbers. This adapter uses generated columns to handle large balance values (commonly found in blockchain applications):
+
+```sql
+-- Accounts with balances like "99999999999999999999" sort correctly
+SELECT * FROM account ORDER BY balance_sort DESC;
+```
+
+## API
+
+### Constructor Options
+
+```typescript
+interface SqliteIndexDBOptions {
+  filename: string;  // ':memory:' or file path
+}
+```
+
+### Methods
+
+- `initialize()` - Run migrations and prepare database
+- `close()` - Close database connection
+- `listTransactions(params)` - Query transactions with filters
+- `listTopAccounts(params)` - Get accounts sorted by balance
+- `listAssets(params)` - Query assets by owner/factory
+- `listTokens(params)` - List all tokens
+- `listFactories(params)` - List asset factories
+- `listStakes(params)` - Query stake records
+- `listDelegations(params)` - Query delegations
+- `listRollups(params)` - List rollup configurations
+- `getRelatedAddresses(address)` - Find related addresses

package/esm/_virtual/rolldown_runtime.mjs

@@ -0,0 +1,21 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __exportAll, __require };

package/esm/db/base.d.mts

@@ -0,0 +1,76 @@
+import { Database } from "../interfaces.mjs";
+import { Kysely } from "kysely";
+import { BaseIndexDB } from "@ocap/indexdb";
+import { IIndexDB, IIndexTable, IListAccountsResult, IListAssetsResult, IListDelegationsResult, IListFactoriesResult, IListRollupBlocksResult, IListRollupValidatorsResult, IListRollupsResult, IListStakesResult, IListTokenFactoriesResult, IListTokensResult, IListTransactionsResult, IndexTableTypeMap, TRequestListAssets, TRequestListDelegations, TRequestListFactories, TRequestListRollupBlocks, TRequestListRollupValidators, TRequestListRollups, TRequestListStakes, TRequestListTokenFactories, TRequestListTokens, TRequestListTopAccounts, TRequestListTransactions } from "@ocap/types";
+
+//#region src/db/base.d.ts
+
+/**
+ * Base SQLite IndexDB implementation
+ * Contains all the list methods with SQL-based filtering
+ */
+declare class SqliteBaseIndexDB extends BaseIndexDB implements IIndexDB {
+  protected db: Kysely<Database>;
+  tx: IIndexTable<IndexTableTypeMap['tx']>;
+  account: IIndexTable<IndexTableTypeMap['account']>;
+  asset: IIndexTable<IndexTableTypeMap['asset']>;
+  token: IIndexTable<IndexTableTypeMap['token']>;
+  factory: IIndexTable<IndexTableTypeMap['factory']>;
+  stake: IIndexTable<IndexTableTypeMap['stake']>;
+  delegation: IIndexTable<IndexTableTypeMap['delegation']>;
+  rollup: IIndexTable<IndexTableTypeMap['rollup']>;
+  rollupBlock: IIndexTable<IndexTableTypeMap['rollupBlock']>;
+  rollupValidator: IIndexTable<IndexTableTypeMap['rollupValidator']>;
+  tokenDistribution: IIndexTable<IndexTableTypeMap['tokenDistribution']>;
+  tokenFactory: IIndexTable<IndexTableTypeMap['tokenFactory']>;
+  /**
+   * List transactions with filtering and pagination
+   */
+  listTransactions(params?: Partial<TRequestListTransactions>): Promise<IListTransactionsResult>;
+  /**
+   * Get related addresses for account migration tracking
+   */
+  getRelatedAddresses(address: string): Promise<string[]>;
+  /**
+   * List assets with filtering and pagination
+   */
+  listAssets(params?: Partial<TRequestListAssets>): Promise<IListAssetsResult>;
+  /**
+   * List top accounts by token balance
+   */
+  listTopAccounts(params?: Partial<TRequestListTopAccounts>): Promise<IListAccountsResult>;
+  /**
+   * List tokens with filtering and pagination
+   */
+  listTokens(params?: Partial<TRequestListTokens>): Promise<IListTokensResult>;
+  /**
+   * List token factories (bonding curve)
+   */
+  listTokenFactories(params?: Partial<TRequestListTokenFactories>): Promise<IListTokenFactoriesResult>;
+  /**
+   * List asset factories
+   */
+  listFactories(params?: Partial<TRequestListFactories>): Promise<IListFactoriesResult>;
+  /**
+   * List stakes
+   */
+  listStakes(params?: Partial<TRequestListStakes>): Promise<IListStakesResult>;
+  /**
+   * List rollups
+   */
+  listRollups(params?: Partial<TRequestListRollups>): Promise<IListRollupsResult>;
+  /**
+   * List rollup blocks
+   */
+  listRollupBlocks(params?: Partial<TRequestListRollupBlocks>): Promise<IListRollupBlocksResult>;
+  /**
+   * List rollup validators
+   */
+  listRollupValidators(params?: Partial<TRequestListRollupValidators>): Promise<IListRollupValidatorsResult>;
+  /**
+   * List delegations
+   */
+  listDelegations(params?: Partial<TRequestListDelegations>): Promise<IListDelegationsResult>;
+}
+//#endregion
+export { SqliteBaseIndexDB as default };