@hasna/sandboxes 0.1.28 → 0.1.30

package/dist/cli/storage.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerStorageCommands(program: Command): void;

package/dist/db/database.d.ts

@@ -1,4 +1,5 @@
 import { Database } from "bun:sqlite";
+export declare function getDbPath(): string;
 export declare function getDatabase(): Database;
 export declare function closeDatabase(): void;
 export declare function resetDatabase(): void;

package/dist/db/pg-migrate.d.ts

@@ -0,0 +1,7 @@
+export interface PgMigrationResult {
+    applied: number[];
+    alreadyApplied: number[];
+    errors: string[];
+    totalMigrations: number;
+}
+export declare function applyPgMigrations(connectionString: string): Promise<PgMigrationResult>;

package/dist/db/pg-migrations.d.ts

@@ -1,5 +1,5 @@
 /**
- * PostgreSQL migrations for open-sandboxes cloud sync.
+ * PostgreSQL migrations for open-sandboxes storage sync.
  *
  * Equivalent to the SQLite schema in database.ts, translated for PostgreSQL.
  */

package/dist/db/remote-storage.d.ts

@@ -0,0 +1,11 @@
+export declare class PgAdapterAsync {
+    private readonly pool;
+    constructor(connectionString: string);
+    run(sql: string, ...params: unknown[]): Promise<{
+        changes: number;
+    }>;
+    get(sql: string, ...params: unknown[]): Promise<unknown>;
+    all(sql: string, ...params: unknown[]): Promise<unknown[]>;
+    exec(sql: string): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/db/storage-config.d.ts

@@ -0,0 +1,26 @@
+export type StorageMode = "local" | "hybrid" | "remote";
+export interface StorageConfig {
+    mode: StorageMode;
+    rds: {
+        host: string;
+        port: number;
+        username: string;
+        password_env: string;
+        ssl: boolean;
+    };
+}
+export interface StorageEnv {
+    name: string;
+}
+export declare const SANDBOXES_STORAGE_ENV = "HASNA_SANDBOXES_DATABASE_URL";
+export declare const SANDBOXES_STORAGE_FALLBACK_ENV = "SANDBOXES_DATABASE_URL";
+export declare const SANDBOXES_STORAGE_MODE_ENV = "HASNA_SANDBOXES_STORAGE_MODE";
+export declare const SANDBOXES_STORAGE_MODE_FALLBACK_ENV = "SANDBOXES_STORAGE_MODE";
+export declare const STORAGE_DATABASE_ENV: readonly ["HASNA_SANDBOXES_DATABASE_URL", "SANDBOXES_DATABASE_URL"];
+export declare const STORAGE_MODE_ENV: readonly ["HASNA_SANDBOXES_STORAGE_MODE", "SANDBOXES_STORAGE_MODE"];
+export declare function getStorageDatabaseEnvName(): (typeof STORAGE_DATABASE_ENV)[number] | null;
+export declare function getStorageDatabaseEnv(): StorageEnv | null;
+export declare function getStorageDatabaseUrl(): string | undefined;
+export declare function getStorageConfig(): StorageConfig;
+export declare function getStorageConnectionString(dbName?: string): string;
+export declare const getConnectionString: typeof getStorageConnectionString;

package/dist/db/storage-sync.d.ts

@@ -0,0 +1,35 @@
+import { type Database } from "bun:sqlite";
+import { STORAGE_DATABASE_ENV, type StorageMode } from "./storage-config.js";
+import { PgAdapterAsync } from "./remote-storage.js";
+export interface SyncResult {
+    table: string;
+    direction: "push" | "pull";
+    rowsRead: number;
+    rowsWritten: number;
+    errors: string[];
+}
+export interface StorageStatus {
+    configured: boolean;
+    mode: StorageMode;
+    enabled: boolean;
+    env: typeof STORAGE_DATABASE_ENV;
+    activeEnv: string | null;
+    service: "sandboxes";
+    db_path: string;
+    tables: Array<{
+        table: string;
+        rows: number;
+    }>;
+}
+export declare const STORAGE_TABLES: readonly ["projects", "agents", "sandboxes", "sandbox_sessions", "sandbox_events", "webhooks", "templates", "snapshots", "feedback"];
+export declare const SANDBOXES_STORAGE_TABLES: readonly ["projects", "agents", "sandboxes", "sandbox_sessions", "sandbox_events", "webhooks", "templates", "snapshots", "feedback"];
+export declare function getStoragePg(): Promise<PgAdapterAsync>;
+export declare function runStorageMigrations(remote: PgAdapterAsync): Promise<void>;
+export declare function getStorageStatus(db?: Database): StorageStatus;
+export declare function pushStorageChanges(tables?: string[]): Promise<SyncResult[]>;
+export declare function pullStorageChanges(tables?: string[]): Promise<SyncResult[]>;
+export declare function syncStorageChanges(tables?: string[]): Promise<{
+    push: SyncResult[];
+    pull: SyncResult[];
+}>;
+export declare function parseStorageTables(raw?: string): string[];

package/dist/index.d.ts

@@ -1,5 +1,10 @@
 export * from "./types/index.js";
 export { getDatabase, closeDatabase, resetDatabase, uuid, shortId, now, resolvePartialId } from "./db/database.js";
+export { SANDBOXES_STORAGE_ENV, SANDBOXES_STORAGE_FALLBACK_ENV, SANDBOXES_STORAGE_MODE_ENV, SANDBOXES_STORAGE_MODE_FALLBACK_ENV, STORAGE_DATABASE_ENV, STORAGE_MODE_ENV, getConnectionString, getStorageConfig, getStorageConnectionString, getStorageDatabaseEnv, getStorageDatabaseEnvName, getStorageDatabaseUrl, type StorageConfig, type StorageEnv, type StorageMode, } from "./db/storage-config.js";
+export { PgAdapterAsync } from "./db/remote-storage.js";
+export { applyPgMigrations } from "./db/pg-migrate.js";
+export { SANDBOXES_STORAGE_TABLES, STORAGE_TABLES, getStoragePg, getStorageStatus, parseStorageTables, pullStorageChanges, pushStorageChanges, runStorageMigrations, syncStorageChanges, } from "./db/storage-sync.js";
+export type { StorageStatus, SyncResult } from "./db/storage-sync.js";
 export { createSandbox, getSandbox, listSandboxes, updateSandbox, deleteSandbox } from "./db/sandboxes.js";
 export { createSession, getSession, listSessions, updateSession, endSession } from "./db/sessions.js";
 export { addEvent, listEvents } from "./db/events.js";