tetherdb 0.1.0

package/dist/server/storage/memory/table.d.cts

@@ -0,0 +1,17 @@
+import type { SnapshotRecord, StoredRecord } from '../../../shared/types.cjs';
+import { TableBaseStorage } from '../base/index.cjs';
+import type { UserStorage } from '../user.cjs';
+import type { AppMemoryStorage } from './app.cjs';
+import type { MemoryStorage } from './storage.cjs';
+/**
+ * In-memory implementation of `TableStorage`.
+ */
+export declare class TableMemoryStorage extends TableBaseStorage {
+    readonly app: AppMemoryStorage;
+    private storage;
+    constructor(name: string, app: AppMemoryStorage, storage: MemoryStorage);
+    getRecord(user: UserStorage, id: string): Promise<StoredRecord | undefined>;
+    getAllRecords(user: UserStorage): Promise<SnapshotRecord[]>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=table.d.ts.map

package/dist/server/storage/memory/table.d.ts

@@ -0,0 +1,17 @@
+import type { SnapshotRecord, StoredRecord } from '../../../shared/types.js';
+import { TableBaseStorage } from '../base/index.js';
+import type { UserStorage } from '../user.js';
+import type { AppMemoryStorage } from './app.js';
+import type { MemoryStorage } from './storage.js';
+/**
+ * In-memory implementation of `TableStorage`.
+ */
+export declare class TableMemoryStorage extends TableBaseStorage {
+    readonly app: AppMemoryStorage;
+    private storage;
+    constructor(name: string, app: AppMemoryStorage, storage: MemoryStorage);
+    getRecord(user: UserStorage, id: string): Promise<StoredRecord | undefined>;
+    getAllRecords(user: UserStorage): Promise<SnapshotRecord[]>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=table.d.ts.map

package/dist/server/storage/memory/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/memory/table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAuB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,SAAiB,GAAG,EAAE,gBAAgB,CAAC;IACvC,OAAO,CAAC,OAAO,CAAgB;IAE/B,YAAY,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAGtE;IAEK,SAAS,CACb,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAWnC;IAEK,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAIhE;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;CACF"}

package/dist/server/storage/memory/user.d.cts

@@ -0,0 +1,21 @@
+import { UserBaseStorage } from '../base/index.cjs';
+import type { MemoryStorage } from './storage.cjs';
+export interface MemoryUserData {
+    id: string;
+    username: string;
+    passwordHash: string | null;
+    createdAt: number;
+}
+/**
+ * In-memory implementation of `UserStorage`.
+ */
+export declare class UserMemoryStorage extends UserBaseStorage {
+    private storage;
+    constructor(data: MemoryUserData, storage: MemoryStorage);
+    protected getSecret(): string;
+    private getUserData;
+    verifyPassword(password: string): Promise<boolean>;
+    changePassword(newPassword: string): Promise<void>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/server/storage/memory/user.d.ts

@@ -0,0 +1,21 @@
+import { UserBaseStorage } from '../base/index.js';
+import type { MemoryStorage } from './storage.js';
+export interface MemoryUserData {
+    id: string;
+    username: string;
+    passwordHash: string | null;
+    createdAt: number;
+}
+/**
+ * In-memory implementation of `UserStorage`.
+ */
+export declare class UserMemoryStorage extends UserBaseStorage {
+    private storage;
+    constructor(data: MemoryUserData, storage: MemoryStorage);
+    protected getSecret(): string;
+    private getUserData;
+    verifyPassword(password: string): Promise<boolean>;
+    changePassword(newPassword: string): Promise<void>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/server/storage/memory/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/memory/user.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,OAAO,CAAgB;IAE/B,YAAY,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAGvD;IAED,SAAS,CAAC,SAAS,IAAI,MAAM,CAE5B;IAED,OAAO,CAAC,WAAW;IAWb,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;IAEK,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvD;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;CACF"}

package/dist/server/storage/sqlite/app.d.cts

@@ -0,0 +1,31 @@
+import { type ChangeRecord } from '../../../shared/types.cjs';
+import { AppBaseStorage } from '../base/app.cjs';
+import type { TableStorage } from '../table.cjs';
+import type { UserStorage } from '../user.cjs';
+import type { SqliteStorage, UserAppDbHandle } from './storage.cjs';
+/**
+ * SQLite-backed application namespace storage implementation.
+ */
+export declare class AppSqliteStorage extends AppBaseStorage {
+    readonly storage: SqliteStorage;
+    constructor(id: string, storage: SqliteStorage);
+    getUserDb(userId: string): UserAppDbHandle;
+    private parseData;
+    private serializeData;
+    createTable(name: string): Promise<TableStorage>;
+    getTable(name: string): Promise<TableStorage | undefined>;
+    getTables(): Promise<TableStorage[]>;
+    applyChanges(user: UserStorage, changes: ChangeRecord[]): Promise<{
+        applied: ChangeRecord[];
+        newSeq: number;
+    }>;
+    getChangesSince(user: UserStorage, fromSeq: number): Promise<{
+        changes: ChangeRecord[];
+        currentSeq: number;
+        requiresSnapshot?: boolean;
+    }>;
+    getCurrentSeq(user: UserStorage): Promise<number>;
+    delete(): Promise<boolean>;
+    deleteTable(name: string): boolean;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/server/storage/sqlite/app.d.ts

@@ -0,0 +1,31 @@
+import { type ChangeRecord } from '../../../shared/types.js';
+import { AppBaseStorage } from '../base/app.js';
+import type { TableStorage } from '../table.js';
+import type { UserStorage } from '../user.js';
+import type { SqliteStorage, UserAppDbHandle } from './storage.js';
+/**
+ * SQLite-backed application namespace storage implementation.
+ */
+export declare class AppSqliteStorage extends AppBaseStorage {
+    readonly storage: SqliteStorage;
+    constructor(id: string, storage: SqliteStorage);
+    getUserDb(userId: string): UserAppDbHandle;
+    private parseData;
+    private serializeData;
+    createTable(name: string): Promise<TableStorage>;
+    getTable(name: string): Promise<TableStorage | undefined>;
+    getTables(): Promise<TableStorage[]>;
+    applyChanges(user: UserStorage, changes: ChangeRecord[]): Promise<{
+        applied: ChangeRecord[];
+        newSeq: number;
+    }>;
+    getChangesSince(user: UserStorage, fromSeq: number): Promise<{
+        changes: ChangeRecord[];
+        currentSeq: number;
+        requiresSnapshot?: boolean;
+    }>;
+    getCurrentSeq(user: UserStorage): Promise<number>;
+    delete(): Promise<boolean>;
+    deleteTable(name: string): boolean;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/server/storage/sqlite/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/sqlite/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,0BAA0B,CAAC;AAS5E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA8BnE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAG7C;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAEzC;IAED,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,aAAa;IAMf,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAYrD;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAQ9D;IAEK,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzC;IAEK,YAAY,CAChB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAuJtD;IAEK,eAAe,CACnB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,OAAO,EAAE,YAAY,EAAE,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC,CA+BD;IAEK,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAKtD;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjC;CACF"}

package/dist/server/storage/sqlite/index.d.cts

@@ -0,0 +1,5 @@
+export * from './app.cjs';
+export * from './storage.cjs';
+export * from './table.cjs';
+export * from './user.cjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/storage/sqlite/index.d.ts

@@ -0,0 +1,5 @@
+export * from './app.js';
+export * from './storage.js';
+export * from './table.js';
+export * from './user.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/storage/sqlite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/sqlite/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/server/storage/sqlite/storage.d.cts

@@ -0,0 +1,92 @@
+import type { DatabaseSync, StatementSync } from 'node:sqlite';
+import type { AppStorage } from '../app.cjs';
+import { BaseStorage } from '../base/index.cjs';
+import type { MaintenanceResult, StorageOptions } from '../storage.cjs';
+import type { UserStorage } from '../user.cjs';
+export interface SqliteUserData {
+    id: string;
+    username: string;
+    passwordHash: string | null;
+    createdAt: number;
+}
+export interface UsersDbHandle {
+    db: DatabaseSync;
+    stmtFindById: StatementSync;
+    stmtFindByUsername: StatementSync;
+    stmtInsertUser: StatementSync;
+    stmtUpdatePassword: StatementSync;
+    stmtDeleteUser: StatementSync;
+    stmtListUsers: StatementSync;
+}
+export interface AppsDbHandle {
+    db: DatabaseSync;
+    stmtFindApp: StatementSync;
+    stmtInsertApp: StatementSync;
+    stmtListApps: StatementSync;
+    stmtDeleteApp: StatementSync;
+    stmtFindTable: StatementSync;
+    stmtInsertTable: StatementSync;
+    stmtListTables: StatementSync;
+    stmtDeleteTable: StatementSync;
+    stmtDeleteAppTables: StatementSync;
+}
+export interface UserAppDbHandle {
+    db: DatabaseSync;
+    stmtGetRecord: StatementSync;
+    stmtGetRecordForUpdate: StatementSync;
+    stmtGetSnapshot: StatementSync;
+    stmtGetSnapshotByTable: StatementSync;
+    stmtInsertRecord: StatementSync;
+    stmtUpdateRecord: StatementSync;
+    stmtGetMeta: StatementSync;
+    stmtSetMeta: StatementSync;
+    stmtInsertChangelog: StatementSync;
+    stmtGetChangelogSince: StatementSync;
+    stmtPruneChangelog: StatementSync;
+    stmtCountTableRecords: StatementSync;
+    stmtDeleteTableRecords: StatementSync;
+    stmtDeleteTableChangelog: StatementSync;
+}
+export interface SqliteStorageOptions extends StorageOptions {
+    baseDir?: string;
+    inMemory?: boolean;
+    /** Maximum number of open SQLite user database handles retained in LRU cache (default: 100). */
+    maxOpenDatabases?: number;
+}
+/**
+ * SQLite-backed implementation of `Storage`.
+ */
+export declare class SqliteStorage extends BaseStorage {
+    readonly backend = "sqlite";
+    readonly baseDir: string;
+    readonly inMemory: boolean;
+    readonly maxOpenDatabases: number;
+    readonly options: SqliteStorageOptions;
+    readonly secret: string;
+    private usersHandle;
+    private appsHandle;
+    private userAppDbs;
+    constructor(options?: SqliteStorageOptions);
+    protected getBaseDir(): string | undefined;
+    getUsersDb(): UsersDbHandle;
+    getAppsDb(): AppsDbHandle;
+    getUserAppDb(appId: string, userId: string): UserAppDbHandle;
+    findUserDataById(id: string): SqliteUserData | undefined;
+    updateUserData(id: string, passwordHash: string): void;
+    createApp(id: string): Promise<AppStorage>;
+    getApp(id: string): Promise<AppStorage | undefined>;
+    getApps(): Promise<AppStorage[]>;
+    createUser(username: string, password: string): Promise<UserStorage>;
+    getUser(id: string): Promise<UserStorage | undefined>;
+    getUserByUsername(username: string): Promise<UserStorage | undefined>;
+    getUsers(): Promise<UserStorage[]>;
+    deleteUser(id: string): boolean;
+    deleteApp(id: string): boolean;
+    deleteTable(appId: string, tableName: string): boolean;
+    checkpoint(appId?: string): Promise<MaintenanceResult>;
+    vacuum(appId?: string): Promise<MaintenanceResult>;
+    private executeOnAllDbs;
+    prune(appId?: string, keepCount?: number): Promise<MaintenanceResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/server/storage/sqlite/storage.d.ts

@@ -0,0 +1,92 @@
+import type { DatabaseSync, StatementSync } from 'node:sqlite';
+import type { AppStorage } from '../app.js';
+import { BaseStorage } from '../base/index.js';
+import type { MaintenanceResult, StorageOptions } from '../storage.js';
+import type { UserStorage } from '../user.js';
+export interface SqliteUserData {
+    id: string;
+    username: string;
+    passwordHash: string | null;
+    createdAt: number;
+}
+export interface UsersDbHandle {
+    db: DatabaseSync;
+    stmtFindById: StatementSync;
+    stmtFindByUsername: StatementSync;
+    stmtInsertUser: StatementSync;
+    stmtUpdatePassword: StatementSync;
+    stmtDeleteUser: StatementSync;
+    stmtListUsers: StatementSync;
+}
+export interface AppsDbHandle {
+    db: DatabaseSync;
+    stmtFindApp: StatementSync;
+    stmtInsertApp: StatementSync;
+    stmtListApps: StatementSync;
+    stmtDeleteApp: StatementSync;
+    stmtFindTable: StatementSync;
+    stmtInsertTable: StatementSync;
+    stmtListTables: StatementSync;
+    stmtDeleteTable: StatementSync;
+    stmtDeleteAppTables: StatementSync;
+}
+export interface UserAppDbHandle {
+    db: DatabaseSync;
+    stmtGetRecord: StatementSync;
+    stmtGetRecordForUpdate: StatementSync;
+    stmtGetSnapshot: StatementSync;
+    stmtGetSnapshotByTable: StatementSync;
+    stmtInsertRecord: StatementSync;
+    stmtUpdateRecord: StatementSync;
+    stmtGetMeta: StatementSync;
+    stmtSetMeta: StatementSync;
+    stmtInsertChangelog: StatementSync;
+    stmtGetChangelogSince: StatementSync;
+    stmtPruneChangelog: StatementSync;
+    stmtCountTableRecords: StatementSync;
+    stmtDeleteTableRecords: StatementSync;
+    stmtDeleteTableChangelog: StatementSync;
+}
+export interface SqliteStorageOptions extends StorageOptions {
+    baseDir?: string;
+    inMemory?: boolean;
+    /** Maximum number of open SQLite user database handles retained in LRU cache (default: 100). */
+    maxOpenDatabases?: number;
+}
+/**
+ * SQLite-backed implementation of `Storage`.
+ */
+export declare class SqliteStorage extends BaseStorage {
+    readonly backend = "sqlite";
+    readonly baseDir: string;
+    readonly inMemory: boolean;
+    readonly maxOpenDatabases: number;
+    readonly options: SqliteStorageOptions;
+    readonly secret: string;
+    private usersHandle;
+    private appsHandle;
+    private userAppDbs;
+    constructor(options?: SqliteStorageOptions);
+    protected getBaseDir(): string | undefined;
+    getUsersDb(): UsersDbHandle;
+    getAppsDb(): AppsDbHandle;
+    getUserAppDb(appId: string, userId: string): UserAppDbHandle;
+    findUserDataById(id: string): SqliteUserData | undefined;
+    updateUserData(id: string, passwordHash: string): void;
+    createApp(id: string): Promise<AppStorage>;
+    getApp(id: string): Promise<AppStorage | undefined>;
+    getApps(): Promise<AppStorage[]>;
+    createUser(username: string, password: string): Promise<UserStorage>;
+    getUser(id: string): Promise<UserStorage | undefined>;
+    getUserByUsername(username: string): Promise<UserStorage | undefined>;
+    getUsers(): Promise<UserStorage[]>;
+    deleteUser(id: string): boolean;
+    deleteApp(id: string): boolean;
+    deleteTable(appId: string, tableName: string): boolean;
+    checkpoint(appId?: string): Promise<MaintenanceResult>;
+    vacuum(appId?: string): Promise<MaintenanceResult>;
+    private executeOnAllDbs;
+    prune(appId?: string, keepCount?: number): Promise<MaintenanceResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/server/storage/sqlite/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/sqlite/storage.ts"],"names":[],"mappings":"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"}

package/dist/server/storage/sqlite/table.d.cts

@@ -0,0 +1,15 @@
+import type { SnapshotRecord, StoredRecord } from '../../../shared/types.cjs';
+import { TableBaseStorage } from '../base/table.cjs';
+import type { UserStorage } from '../user.cjs';
+import type { AppSqliteStorage } from './app.cjs';
+/**
+ * SQLite-backed implementation of `TableStorage`.
+ */
+export declare class TableSqliteStorage extends TableBaseStorage {
+    readonly app: AppSqliteStorage;
+    delete(): Promise<boolean>;
+    private parseData;
+    getRecord(user: UserStorage, id: string): Promise<StoredRecord | undefined>;
+    getAllRecords(user: UserStorage): Promise<SnapshotRecord[]>;
+}
+//# sourceMappingURL=table.d.ts.map

package/dist/server/storage/sqlite/table.d.ts

@@ -0,0 +1,15 @@
+import type { SnapshotRecord, StoredRecord } from '../../../shared/types.js';
+import { TableBaseStorage } from '../base/table.js';
+import type { UserStorage } from '../user.js';
+import type { AppSqliteStorage } from './app.js';
+/**
+ * SQLite-backed implementation of `TableStorage`.
+ */
+export declare class TableSqliteStorage extends TableBaseStorage {
+    readonly app: AppSqliteStorage;
+    delete(): Promise<boolean>;
+    private parseData;
+    getRecord(user: UserStorage, id: string): Promise<StoredRecord | undefined>;
+    getAllRecords(user: UserStorage): Promise<SnapshotRecord[]>;
+}
+//# sourceMappingURL=table.d.ts.map

package/dist/server/storage/sqlite/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/sqlite/table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAYjD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,SAAiB,GAAG,EAAE,gBAAgB,CAAC;IAEjC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;IACD,OAAO,CAAC,SAAS;IASX,SAAS,CACb,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC;IAEK,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAehE;CACF"}

package/dist/server/storage/sqlite/user.d.cts

@@ -0,0 +1,14 @@
+import { UserBaseStorage } from '../base/index.cjs';
+import type { SqliteStorage, SqliteUserData } from './storage.cjs';
+/**
+ * SQLite-backed implementation of `UserStorage`.
+ */
+export declare class UserSqliteStorage extends UserBaseStorage {
+    private storage;
+    constructor(data: SqliteUserData, storage: SqliteStorage);
+    protected getSecret(): string;
+    verifyPassword(password: string): Promise<boolean>;
+    changePassword(newPassword: string): Promise<void>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/server/storage/sqlite/user.d.ts

@@ -0,0 +1,14 @@
+import { UserBaseStorage } from '../base/index.js';
+import type { SqliteStorage, SqliteUserData } from './storage.js';
+/**
+ * SQLite-backed implementation of `UserStorage`.
+ */
+export declare class UserSqliteStorage extends UserBaseStorage {
+    private storage;
+    constructor(data: SqliteUserData, storage: SqliteStorage);
+    protected getSecret(): string;
+    verifyPassword(password: string): Promise<boolean>;
+    changePassword(newPassword: string): Promise<void>;
+    delete(): Promise<boolean>;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/server/storage/sqlite/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/sqlite/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAElE;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,OAAO,CAAC,OAAO,CAAgB;IAE/B,YAAY,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAGvD;IAED,SAAS,CAAC,SAAS,IAAI,MAAM,CAE5B;IAEK,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;IAEK,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvD;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;CACF"}

package/dist/server/storage/storage.d.cts

@@ -0,0 +1,152 @@
+import type { AppStorage } from './app.cjs';
+import type { UserStorage } from './user.cjs';
+/**
+ * Configuration options and resource limits for storage engines.
+ */
+export interface StorageOptions {
+    /** Maximum number of active records allowed per table (default: 10,000). */
+    maxRecordsPerTable?: number;
+    /** Maximum allowed payload size in bytes for an individual record (default: 512 KB). */
+    maxRecordSizeBytes?: number;
+    /** Maximum allowed size in bytes for a single change batch payload (default: 5 MB). */
+    maxBatchSizeBytes?: number;
+    /** Maximum number of changelog entries retained per user before compaction (default: 1,000). */
+    maxChangelogEntries?: number;
+    /** Secret key used for signing session tokens. */
+    secret?: string;
+}
+/**
+ * Summary status information describing the storage engine and its contents.
+ */
+export interface StorageStatus {
+    /** Storage persistence type ('sqlite', 'file', or 'memory'). */
+    backend: string;
+    /** Storage base directory if disk-backed. */
+    baseDir?: string;
+    /** Number of registered user accounts. */
+    usersCount: number;
+    /** Number of registered applications. */
+    appsCount: number;
+    /** Detailed statistics per application if queried or available. */
+    apps?: Array<{
+        id: string;
+        tables: string[];
+    }>;
+}
+/**
+ * Result returned by a storage maintenance operation.
+ */
+export interface MaintenanceResult {
+    /** Maintenance action performed ('checkpoint', 'vacuum', 'prune'). */
+    action: 'checkpoint' | 'vacuum' | 'prune';
+    /** Target backend name. */
+    backend: string;
+    /** Optional target application ID. */
+    appId?: string;
+    /** Number of entries or database files affected, if applicable. */
+    affectedCount?: number;
+    /** Human-readable status message. */
+    message: string;
+}
+/**
+ * Top-level storage coordinator managing application namespaces and user accounts.
+ */
+export interface Storage {
+    /** Storage configuration options and resource limits. */
+    readonly options?: StorageOptions;
+    /**
+     * Creates/registers a new application namespace.
+     * Throws an error if an application with the specified ID already exists.
+     *
+     * @param id - Unique application identifier.
+     * @returns Created AppStorage handle.
+     * @throws Error if the application already exists.
+     */
+    createApp(id: string): Promise<AppStorage>;
+    /**
+     * Retrieves an application handle if it exists.
+     *
+     * @param id - Unique application identifier.
+     * @returns AppStorage handle or `undefined` if not found.
+     */
+    getApp(id: string): Promise<AppStorage | undefined>;
+    /**
+     * Lists all registered application handles.
+     *
+     * @returns Array of AppStorage handles.
+     */
+    getApps(): Promise<AppStorage[]>;
+    /**
+     * Creates a new user account with credentials.
+     * Throws an error if a user with the same username already exists.
+     *
+     * @param username - Username for the account.
+     * @param password - Account password.
+     * @returns Created UserStorage handle.
+     * @throws Error if the username is already registered.
+     */
+    createUser(username: string, password: string): Promise<UserStorage>;
+    /**
+     * Retrieves a user handle by user account ID.
+     *
+     * @param id - Unique user identifier.
+     * @returns UserStorage handle or `undefined` if not found.
+     */
+    getUser(id: string): Promise<UserStorage | undefined>;
+    /**
+     * Retrieves a user handle by username.
+     *
+     * @param username - User account username.
+     * @returns UserStorage handle or `undefined` if not found.
+     */
+    getUserByUsername(username: string): Promise<UserStorage | undefined>;
+    /**
+     * Retrieves a user handle by validating a session token.
+     *
+     * @param token - Signed session token.
+     * @returns UserStorage handle if token is valid and active, or `undefined`.
+     */
+    getUserByToken(token: string): Promise<UserStorage | undefined>;
+    /**
+     * Lists all user accounts.
+     *
+     * @returns Array of UserStorage handles.
+     */
+    getUsers(): Promise<UserStorage[]>;
+    /**
+     * Retrieves summary operational status of the storage backend.
+     *
+     * @param appId - Optional application identifier filter.
+     * @returns StorageStatus object.
+     */
+    getStatus(appId?: string): Promise<StorageStatus>;
+    /**
+     * Performs a WAL checkpoint on SQLite databases to truncate WAL files.
+     *
+     * @param appId - Optional target application identifier.
+     * @returns MaintenanceResult describing checkpoint outcome.
+     * @throws TetherServerError if checkpoint is not supported by this backend.
+     */
+    checkpoint(appId?: string): Promise<MaintenanceResult>;
+    /**
+     * Performs database vacuuming to reclaim disk space and defragment storage.
+     *
+     * @param appId - Optional target application identifier.
+     * @returns MaintenanceResult describing vacuum outcome.
+     * @throws TetherServerError if vacuum is not supported by this backend.
+     */
+    vacuum(appId?: string): Promise<MaintenanceResult>;
+    /**
+     * Prunes changelog history entries older than the retention threshold.
+     *
+     * @param appId - Optional target application identifier.
+     * @param keepCount - Optional maximum entries to retain per table/user (defaults to configured limit).
+     * @returns MaintenanceResult describing prune outcome.
+     */
+    prune(appId?: string, keepCount?: number): Promise<MaintenanceResult>;
+    /**
+     * Optional cleanup callback invoked when shutting down the storage engine.
+     */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map