@hasna/cloud 0.1.35 → 0.1.36

package/dist/mcp-helpers.d.ts

@@ -0,0 +1,22 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register cloud-related MCP tools onto an existing MCP server.
+ * Services call this to embed cloud sync/feedback tools into their own MCP server.
+ *
+ * @param migrations - Optional list of SQL statements to run against PG before pushing.
+ *   Use this to ensure the cloud schema exists (CREATE TABLE IF NOT EXISTS ...).
+ *
+ * @example
+ * ```ts
+ * import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+ * import { registerCloudTools } from "@hasna/cloud";
+ *
+ * const server = new McpServer({ name: "my-service", version: "0.1.0" });
+ * registerCloudTools(server, "my-service", { migrations: PG_MIGRATIONS });
+ * ```
+ */
+export declare function registerCloudTools(server: McpServer, serviceName: string, opts?: {
+    migrations?: string[];
+    dbPath?: string;
+}): void;
+//# sourceMappingURL=mcp-helpers.d.ts.map

package/dist/mcp-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-helpers.d.ts","sourceRoot":"","sources":["../src/mcp-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,IAAI,CA2JN"}

package/dist/pg-migrate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Generic PostgreSQL migration runner.
+ *
+ * Applies a flat array of SQL migration strings to a PG database.
+ * Tracks applied versions in a `_pg_migrations` table.
+ * Forward-only — no rollbacks. Migrations must be idempotent.
+ *
+ * Usage:
+ *   import { applyPgMigrations } from "@hasna/cloud";
+ *   const result = await applyPgMigrations(connectionString, migrations);
+ *
+ * Or for service discovery:
+ *   import { migrateService, migrateAllServices } from "@hasna/cloud";
+ *   await migrateService("todos", connectionString);
+ *   await migrateAllServices();  // discovers all installed @hasna/* services
+ */
+export interface PgMigrationResult {
+    service: string;
+    applied: number[];
+    alreadyApplied: number[];
+    errors: string[];
+    totalMigrations: number;
+}
+/**
+ * Apply an array of SQL migrations to a PostgreSQL database.
+ *
+ * @param connectionString - PG connection string (postgres://...)
+ * @param migrations - Ordered array of SQL strings. Index = version number.
+ * @param service - Service name for result reporting (default: "unknown")
+ */
+export declare function applyPgMigrations(connectionString: string, migrations: string[], service?: string): Promise<PgMigrationResult>;
+/**
+ * Migrate a single service's PG database.
+ *
+ * @param service - Service name (e.g., "todos", "conversations")
+ * @param connectionString - Optional override. Default: auto-detected from cloud config.
+ */
+export declare function migrateService(service: string, connectionString?: string): Promise<PgMigrationResult>;
+/**
+ * Discover all installed @hasna/* services and migrate their PG databases.
+ *
+ * Discovery: scans ~/.hasna/ for service directories that have local DBs.
+ */
+export declare function migrateAllServices(): Promise<PgMigrationResult[]>;
+/**
+ * Ensure a PostgreSQL database exists for a service.
+ * Connects to the `postgres` default database and runs CREATE DATABASE.
+ */
+export declare function ensurePgDatabase(service: string): Promise<boolean>;
+/**
+ * Ensure PG databases exist for all discovered services.
+ */
+export declare function ensureAllPgDatabases(): Promise<Array<{
+    service: string;
+    created: boolean;
+    error?: string;
+}>>;
+//# sourceMappingURL=pg-migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pg-migrate.d.ts","sourceRoot":"","sources":["../src/pg-migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,SAAY,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAwD5B;AA+CD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAe5B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqBvE;AAMD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BxE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAelH"}

package/dist/scheduled-sync.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Discover services under `~/.hasna/` that have a `<service>.db` SQLite file.
+ * Returns an array of service names.
+ */
+export declare function discoverSyncableServices(): string[];
+export interface ScheduledSyncResult {
+    service: string;
+    tables_synced: number;
+    total_rows_synced: number;
+    errors: string[];
+}
+/**
+ * Run a scheduled sync push for all discovered services.
+ *
+ * - Skips if mode is `local`.
+ * - Opens each service's SQLite DB, discovers tables, and pushes to PG.
+ * - Returns per-service results.
+ */
+export declare function runScheduledSync(): Promise<ScheduledSyncResult[]>;
+declare const _default: {
+    scheduled(): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=scheduled-sync.d.ts.map

package/dist/scheduled-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-sync.d.ts","sourceRoot":"","sources":["../src/scheduled-sync.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAkBnD;AAMD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA2EvE;;;;AAUD,wBAIE"}