tetherdb 0.1.0

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

@@ -0,0 +1,31 @@
+import type { UserStorage } from '../user.cjs';
+/**
+ * Common abstract base class for UserStorage implementations.
+ */
+export declare abstract class UserBaseStorage implements UserStorage {
+    readonly id: string;
+    readonly username: string;
+    readonly createdAt: number;
+    constructor(id: string, username: string, createdAt: number);
+    /** Retrieves the secret key used for signing session tokens. */
+    protected abstract getSecret(): string;
+    /** Verifies if the plaintext password matches. */
+    abstract verifyPassword(password: string): Promise<boolean>;
+    /** Updates user credentials with a new password. */
+    abstract changePassword(newPassword: string): Promise<void>;
+    /** Deletes the user account and associated data. */
+    abstract delete(): Promise<boolean>;
+    /** Creates a signed session token for this user. */
+    createToken(expiresInSeconds?: number): Promise<string>;
+    /** Verifies whether the session token is valid for this user. */
+    verifyToken(token: string): Promise<boolean>;
+}
+/**
+ * Verifies a candidate plaintext password against a stored bcrypt hash.
+ */
+export declare function verifyUserPassword(password: string, passwordHash: string | null | undefined): Promise<boolean>;
+/**
+ * Hashes a validated plaintext password.
+ */
+export declare function hashUserPassword(newPassword: string): Promise<string>;
+//# sourceMappingURL=user.d.ts.map

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

@@ -0,0 +1,31 @@
+import type { UserStorage } from '../user.js';
+/**
+ * Common abstract base class for UserStorage implementations.
+ */
+export declare abstract class UserBaseStorage implements UserStorage {
+    readonly id: string;
+    readonly username: string;
+    readonly createdAt: number;
+    constructor(id: string, username: string, createdAt: number);
+    /** Retrieves the secret key used for signing session tokens. */
+    protected abstract getSecret(): string;
+    /** Verifies if the plaintext password matches. */
+    abstract verifyPassword(password: string): Promise<boolean>;
+    /** Updates user credentials with a new password. */
+    abstract changePassword(newPassword: string): Promise<void>;
+    /** Deletes the user account and associated data. */
+    abstract delete(): Promise<boolean>;
+    /** Creates a signed session token for this user. */
+    createToken(expiresInSeconds?: number): Promise<string>;
+    /** Verifies whether the session token is valid for this user. */
+    verifyToken(token: string): Promise<boolean>;
+}
+/**
+ * Verifies a candidate plaintext password against a stored bcrypt hash.
+ */
+export declare function verifyUserPassword(password: string, passwordHash: string | null | undefined): Promise<boolean>;
+/**
+ * Hashes a validated plaintext password.
+ */
+export declare function hashUserPassword(newPassword: string): Promise<string>;
+//# sourceMappingURL=user.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/base/user.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,8BAAsB,eAAgB,YAAW,WAAW;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAI1D;IAED,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC;IAEvC,kDAAkD;IAClD,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5D,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,oDAAoD;IACpD,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpC,oDAAoD;IAC9C,WAAW,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5D;IAED,iEAAiE;IAC3D,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjD;CACF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3E"}

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

@@ -0,0 +1,50 @@
+import { type ChangeRecord, type StoredRecord } from '../../../shared/types.cjs';
+import { AppBaseStorage } from '../base/index.cjs';
+import type { TableStorage } from '../table.cjs';
+import type { UserStorage } from '../user.cjs';
+import { type FileStorage } from './storage.cjs';
+export interface AppManifest {
+    id: string;
+    tables: string[];
+    createdAt: number;
+    version: number;
+}
+/**
+ * Filesystem-backed application namespace storage implementation.
+ */
+export declare class AppFileStorage extends AppBaseStorage {
+    readonly storage: FileStorage;
+    constructor(id: string, storage: FileStorage);
+    get appDir(): string;
+    private get manifestFile();
+    getUserDir(userId: string): string;
+    private getUserMetaFile;
+    private getUserSyncFile;
+    getUserTablesDir(userId: string): string;
+    getUserTableFile(userId: string, tableName: string): string;
+    private readManifest;
+    private writeManifest;
+    private readUserMeta;
+    private writeUserMeta;
+    private readUserSync;
+    private appendUserSync;
+    private rewriteUserSync;
+    readTableRecords(userId: string, tableName: string): Promise<Map<string, StoredRecord>>;
+    private writeTableRecords;
+    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): Promise<boolean>;
+}
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1,50 @@
+import { type ChangeRecord, type StoredRecord } from '../../../shared/types.js';
+import { AppBaseStorage } from '../base/index.js';
+import type { TableStorage } from '../table.js';
+import type { UserStorage } from '../user.js';
+import { type FileStorage } from './storage.js';
+export interface AppManifest {
+    id: string;
+    tables: string[];
+    createdAt: number;
+    version: number;
+}
+/**
+ * Filesystem-backed application namespace storage implementation.
+ */
+export declare class AppFileStorage extends AppBaseStorage {
+    readonly storage: FileStorage;
+    constructor(id: string, storage: FileStorage);
+    get appDir(): string;
+    private get manifestFile();
+    getUserDir(userId: string): string;
+    private getUserMetaFile;
+    private getUserSyncFile;
+    getUserTablesDir(userId: string): string;
+    getUserTableFile(userId: string, tableName: string): string;
+    private readManifest;
+    private writeManifest;
+    private readUserMeta;
+    private writeUserMeta;
+    private readUserSync;
+    private appendUserSync;
+    private rewriteUserSync;
+    readTableRecords(userId: string, tableName: string): Promise<Map<string, StoredRecord>>;
+    private writeTableRecords;
+    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): Promise<boolean>;
+}
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/file/app.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,EAAE,cAAc,EAAuB,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAE9B,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAG3C;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,KAAK,YAAY,GAEvB;IAED,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjC;IAED,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IAIvB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvC;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;YAEa,YAAY;YAcZ,aAAa;YAIb,YAAY;YASZ,aAAa;YAOb,YAAY;YAmBZ,cAAc;YAUd,eAAe;IAWvB,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAepC;YAEa,iBAAiB;IAWzB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAcrD;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAO9D;IAEK,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzC;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,CAuGtD;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,CAaD;IAEK,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAItD;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;IAEK,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwChD;CACF"}

package/dist/server/storage/file/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/file/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/file/index.d.ts.map

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

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

@@ -0,0 +1,67 @@
+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 FileUserData {
+    id: string;
+    username: string;
+    passwordHash: string | null;
+    createdAt: number;
+}
+export interface FileAppData {
+    id: string;
+    createdAt: number;
+}
+export interface FileStorageOptions extends StorageOptions {
+    baseDir?: string;
+}
+/**
+ * Filesystem-backed implementation of `Storage`.
+ */
+export declare class FileStorage extends BaseStorage {
+    readonly backend = "file";
+    readonly baseDir: string;
+    readonly options: FileStorageOptions;
+    readonly secret: string;
+    private userLocks;
+    constructor(options?: FileStorageOptions);
+    protected getBaseDir(): string | undefined;
+    private get usersFile();
+    private get appsFile();
+    withLock<T>(key: string, fn: () => Promise<T>): Promise<T>;
+    withUserLock<T>(userId: string, appId: string, fn: () => Promise<T>): Promise<T>;
+    private readUsersFile;
+    private writeUsersFile;
+    private readAppsFile;
+    private writeAppsFile;
+    findUserDataById(id: string): Promise<FileUserData | undefined>;
+    updateUserData(id: string, update: Partial<FileUserData>): Promise<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): Promise<boolean>;
+    deleteApp(id: string): Promise<boolean>;
+    checkpoint(appId?: string): Promise<MaintenanceResult>;
+    vacuum(appId?: string): Promise<MaintenanceResult>;
+    prune(appId?: string, keepCount?: number): Promise<MaintenanceResult>;
+    close(): Promise<void>;
+}
+/**
+ * Validates that no external TetherDB server process is actively running on this data directory.
+ *
+ * @param baseDir - Storage base directory.
+ * @throws TetherServerError if an active server lock is held by another process.
+ */
+export declare function assertNoActiveServerLock(baseDir: string): void;
+/**
+ * Writes data atomically to a file using a unique temp file and atomic rename.
+ *
+ * @param filePath - The destination file path.
+ * @param content - File content to write.
+ */
+export declare function writeFileAtomic(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1,67 @@
+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 FileUserData {
+    id: string;
+    username: string;
+    passwordHash: string | null;
+    createdAt: number;
+}
+export interface FileAppData {
+    id: string;
+    createdAt: number;
+}
+export interface FileStorageOptions extends StorageOptions {
+    baseDir?: string;
+}
+/**
+ * Filesystem-backed implementation of `Storage`.
+ */
+export declare class FileStorage extends BaseStorage {
+    readonly backend = "file";
+    readonly baseDir: string;
+    readonly options: FileStorageOptions;
+    readonly secret: string;
+    private userLocks;
+    constructor(options?: FileStorageOptions);
+    protected getBaseDir(): string | undefined;
+    private get usersFile();
+    private get appsFile();
+    withLock<T>(key: string, fn: () => Promise<T>): Promise<T>;
+    withUserLock<T>(userId: string, appId: string, fn: () => Promise<T>): Promise<T>;
+    private readUsersFile;
+    private writeUsersFile;
+    private readAppsFile;
+    private writeAppsFile;
+    findUserDataById(id: string): Promise<FileUserData | undefined>;
+    updateUserData(id: string, update: Partial<FileUserData>): Promise<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): Promise<boolean>;
+    deleteApp(id: string): Promise<boolean>;
+    checkpoint(appId?: string): Promise<MaintenanceResult>;
+    vacuum(appId?: string): Promise<MaintenanceResult>;
+    prune(appId?: string, keepCount?: number): Promise<MaintenanceResult>;
+    close(): Promise<void>;
+}
+/**
+ * Validates that no external TetherDB server process is actively running on this data directory.
+ *
+ * @param baseDir - Storage base directory.
+ * @throws TetherServerError if an active server lock is held by another process.
+ */
+export declare function assertNoActiveServerLock(baseDir: string): void;
+/**
+ * Writes data atomically to a file using a unique temp file and atomic rename.
+ *
+ * @param filePath - The destination file path.
+ * @param content - File content to write.
+ */
+export declare function writeFileAtomic(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/file/storage.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAoB,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,QAAQ,CAAC,OAAO,UAAU;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,SAAS,CAA4C;IAE7D,YAAY,OAAO,GAAE,kBAAuB,EAK3C;IAED,UAAmB,UAAU,IAAI,MAAM,GAAG,SAAS,CAElD;IAED,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAEK,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoB/D;IAEK,YAAY,CAAC,CAAC,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ;YAEa,aAAa;YAcb,cAAc;YASd,YAAY;YAcZ,aAAa;IAOrB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAGpE;IAEK,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAcf;IAEK,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoC/C;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAgBxD;IAEK,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAKrC;IAEK,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8BzE;IAEK,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAO1D;IAEK,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAU1E;IAEK,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAKvC;IAEK,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiC7C;IAEK,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuB5C;IAEK,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK3D;IAEK,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKvD;IAEK,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2D1E;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF;AAID;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf"}

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

@@ -0,0 +1,14 @@
+import type { SnapshotRecord, StoredRecord } from '../../../shared/types.cjs';
+import { TableBaseStorage } from '../base/index.cjs';
+import type { UserStorage } from '../user.cjs';
+import type { AppFileStorage } from './app.cjs';
+/**
+ * Filesystem-backed implementation of `TableStorage`.
+ */
+export declare class TableFileStorage extends TableBaseStorage {
+    readonly app: AppFileStorage;
+    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/file/table.d.ts

@@ -0,0 +1,14 @@
+import type { SnapshotRecord, StoredRecord } from '../../../shared/types.js';
+import { TableBaseStorage } from '../base/index.js';
+import type { UserStorage } from '../user.js';
+import type { AppFileStorage } from './app.js';
+/**
+ * Filesystem-backed implementation of `TableStorage`.
+ */
+export declare class TableFileStorage extends TableBaseStorage {
+    readonly app: AppFileStorage;
+    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/file/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/file/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,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,SAAiB,GAAG,EAAE,cAAc,CAAC;IAE/B,SAAS,CACb,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CASnC;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/file/user.d.cts

@@ -0,0 +1,14 @@
+import { UserBaseStorage } from '../base/index.cjs';
+import type { FileStorage, FileUserData } from './storage.cjs';
+/**
+ * Filesystem-backed implementation of `UserStorage`.
+ */
+export declare class UserFileStorage extends UserBaseStorage {
+    private storage;
+    constructor(data: FileUserData, storage: FileStorage);
+    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/file/user.d.ts

@@ -0,0 +1,14 @@
+import { UserBaseStorage } from '../base/index.js';
+import type { FileStorage, FileUserData } from './storage.js';
+/**
+ * Filesystem-backed implementation of `UserStorage`.
+ */
+export declare class UserFileStorage extends UserBaseStorage {
+    private storage;
+    constructor(data: FileUserData, storage: FileStorage);
+    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/file/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/file/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE9D;;GAEG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,OAAO,CAAC,OAAO,CAAc;IAE7B,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAGnD;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/index.d.cts

@@ -0,0 +1,14 @@
+/**
+ * TetherDB Server Storage — Modular storage architecture.
+ *
+ * @module tetherdb/server/storage
+ */
+export type { AppStorage } from './app.cjs';
+export { AppBaseStorage, BaseStorage, TableBaseStorage, UserBaseStorage, } from './base/index.cjs';
+export { FileStorage, type FileStorageOptions, } from './file/storage.cjs';
+export { MemoryStorage, type MemoryStorageOptions, } from './memory/storage.cjs';
+export { SqliteStorage, type SqliteStorageOptions, } from './sqlite/storage.cjs';
+export type { Storage, StorageOptions } from './storage.cjs';
+export type { TableStorage } from './table.cjs';
+export type { UserStorage } from './user.cjs';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,14 @@
+/**
+ * TetherDB Server Storage — Modular storage architecture.
+ *
+ * @module tetherdb/server/storage
+ */
+export type { AppStorage } from './app.js';
+export { AppBaseStorage, BaseStorage, TableBaseStorage, UserBaseStorage, } from './base/index.js';
+export { FileStorage, type FileStorageOptions, } from './file/storage.js';
+export { MemoryStorage, type MemoryStorageOptions, } from './memory/storage.js';
+export { SqliteStorage, type SqliteStorageOptions, } from './sqlite/storage.js';
+export type { Storage, StorageOptions } from './storage.js';
+export type { TableStorage } from './table.js';
+export type { UserStorage } from './user.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/storage/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,29 @@
+import { type ChangeRecord } from '../../../shared/types.cjs';
+import { AppBaseStorage } from '../base/index.cjs';
+import type { TableStorage } from '../table.cjs';
+import type { UserStorage } from '../user.cjs';
+import type { MemoryStorage } from './storage.cjs';
+/**
+ * In-memory implementation of `AppStorage`.
+ */
+export declare class AppMemoryStorage extends AppBaseStorage {
+    private tables;
+    private storage;
+    constructor(id: string, storage: MemoryStorage);
+    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/memory/app.d.ts

@@ -0,0 +1,29 @@
+import { type ChangeRecord } from '../../../shared/types.js';
+import { AppBaseStorage } from '../base/index.js';
+import type { TableStorage } from '../table.js';
+import type { UserStorage } from '../user.js';
+import type { MemoryStorage } from './storage.js';
+/**
+ * In-memory implementation of `AppStorage`.
+ */
+export declare class AppMemoryStorage extends AppBaseStorage {
+    private tables;
+    private storage;
+    constructor(id: string, storage: MemoryStorage);
+    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/memory/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/memory/app.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,0BAA0B,CAAC;AAQlC,OAAO,EAAE,cAAc,EAAuB,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,OAAO,CAAgB;IAE/B,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAG7C;IAEK,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAWrD;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAG9D;IAEK,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAEzC;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,CAgGtD;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,CAWD;IAEK,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtD;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjC;CACF"}

package/dist/server/storage/memory/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/memory/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/memory/index.d.ts.map

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

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

@@ -0,0 +1,47 @@
+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';
+import { type MemoryUserData } from './user.cjs';
+export interface UserState {
+    currentSeq: number;
+    minSeq: number;
+    tables: Map<string, Map<string, import('../../../shared/types.cjs').StoredRecord>>;
+    changelog: Array<import('../../../shared/types.cjs').ChangeRecord & {
+        seq: number;
+    }>;
+}
+export interface MemoryStorageOptions extends StorageOptions {
+}
+/**
+ * In-memory implementation of `Storage`.
+ */
+export declare class MemoryStorage extends BaseStorage {
+    readonly backend = "memory";
+    private apps;
+    private userStates;
+    private users;
+    private usersByUsername;
+    readonly secret: string;
+    readonly options: MemoryStorageOptions;
+    constructor(options?: MemoryStorageOptions);
+    getUserState(userId: string, appId: string): UserState;
+    deleteUserState(userId: string): boolean;
+    deleteAppUserStates(appId: string): void;
+    deleteTableInUserStates(appId: string, tableName: string): void;
+    createApp(id: string): Promise<AppStorage>;
+    getApp(id: string): Promise<AppStorage | undefined>;
+    getApps(): Promise<AppStorage[]>;
+    createUser(username: string, password: string): Promise<UserStorage>;
+    getUserData(userId: string): MemoryUserData | undefined;
+    getUser(id: string): Promise<UserStorage | undefined>;
+    getUserByUsername(username: string): Promise<UserStorage | undefined>;
+    getUsers(): Promise<UserStorage[]>;
+    deleteUser(id: string): boolean;
+    deleteApp(id: string): boolean;
+    checkpoint(appId?: string): Promise<MaintenanceResult>;
+    vacuum(appId?: string): Promise<MaintenanceResult>;
+    prune(appId?: string, keepCount?: number): Promise<MaintenanceResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1,47 @@
+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';
+import { type MemoryUserData } from './user.js';
+export interface UserState {
+    currentSeq: number;
+    minSeq: number;
+    tables: Map<string, Map<string, import('../../../shared/types.js').StoredRecord>>;
+    changelog: Array<import('../../../shared/types.js').ChangeRecord & {
+        seq: number;
+    }>;
+}
+export interface MemoryStorageOptions extends StorageOptions {
+}
+/**
+ * In-memory implementation of `Storage`.
+ */
+export declare class MemoryStorage extends BaseStorage {
+    readonly backend = "memory";
+    private apps;
+    private userStates;
+    private users;
+    private usersByUsername;
+    readonly secret: string;
+    readonly options: MemoryStorageOptions;
+    constructor(options?: MemoryStorageOptions);
+    getUserState(userId: string, appId: string): UserState;
+    deleteUserState(userId: string): boolean;
+    deleteAppUserStates(appId: string): void;
+    deleteTableInUserStates(appId: string, tableName: string): void;
+    createApp(id: string): Promise<AppStorage>;
+    getApp(id: string): Promise<AppStorage | undefined>;
+    getApps(): Promise<AppStorage[]>;
+    createUser(username: string, password: string): Promise<UserStorage>;
+    getUserData(userId: string): MemoryUserData | undefined;
+    getUser(id: string): Promise<UserStorage | undefined>;
+    getUserByUsername(username: string): Promise<UserStorage | undefined>;
+    getUsers(): Promise<UserStorage[]>;
+    deleteUser(id: string): boolean;
+    deleteApp(id: string): boolean;
+    checkpoint(appId?: string): Promise<MaintenanceResult>;
+    vacuum(appId?: string): Promise<MaintenanceResult>;
+    prune(appId?: string, keepCount?: number): Promise<MaintenanceResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/memory/storage.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAoB,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,WAAW,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,CACT,MAAM,EACN,GAAG,CAAC,MAAM,EAAE,OAAO,0BAA0B,EAAE,YAAY,CAAC,CAC7D,CAAC;IACF,SAAS,EAAE,KAAK,CACd,OAAO,0BAA0B,EAAE,YAAY,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAClE,CAAC;CACH;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;CAAG;AAE/D;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,OAAO,YAAY;IAC5B,OAAO,CAAC,IAAI,CAA4C;IACxD,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,eAAe,CAAkC;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IAEvC,YAAY,OAAO,GAAE,oBAAyB,EAI7C;IAED,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAerD;IAED,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUvC;IAED,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAOvC;IAED,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO9D;IAEK,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAW/C;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAGxD;IAEK,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAErC;IAEK,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBzE;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtD;IAEK,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAO1D;IAEK,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAU1E;IAEK,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAIvC;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAU9B;IAED,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAI7B;IAEK,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK3D;IAEK,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKvD;IAEK,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4B1E;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAK3B;CACF"}