@hasna/cloud 0.1.0

package/dist/mcp-helpers.d.ts

@@ -0,0 +1,16 @@
+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.
+ *
+ * @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");
+ * ```
+ */
+export declare function registerCloudTools(server: McpServer, serviceName: 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;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAuJN"}

package/dist/sync.d.ts

@@ -0,0 +1,48 @@
+import type { DbAdapter } from "./adapter.js";
+export interface SyncProgress {
+    table: string;
+    phase: "reading" | "writing" | "done";
+    rowsRead: number;
+    rowsWritten: number;
+    totalTables: number;
+    currentTableIndex: number;
+}
+export type SyncProgressCallback = (progress: SyncProgress) => void;
+export interface SyncOptions {
+    /** Tables to sync. */
+    tables: string[];
+    /** Optional progress callback. */
+    onProgress?: SyncProgressCallback;
+    /** Batch size for UPSERT operations. Default: 500 */
+    batchSize?: number;
+    /** Conflict resolution column (default: "updated_at"). Newest wins. */
+    conflictColumn?: string;
+    /** Primary key column name (default: "id"). */
+    primaryKey?: string;
+}
+export interface SyncResult {
+    table: string;
+    rowsRead: number;
+    rowsWritten: number;
+    rowsSkipped: number;
+    errors: string[];
+}
+/**
+ * Push data from a local database to the cloud database.
+ * For each table: SELECT * from source → UPSERT into target.
+ * Conflict resolution: compare `updated_at`, newest wins.
+ */
+export declare function syncPush(local: DbAdapter, cloud: DbAdapter, options: SyncOptions): SyncResult[];
+/**
+ * Pull data from the cloud database into the local database.
+ */
+export declare function syncPull(local: DbAdapter, cloud: DbAdapter, options: SyncOptions): SyncResult[];
+/**
+ * List all user tables in a SQLite database.
+ */
+export declare function listSqliteTables(db: DbAdapter): string[];
+/**
+ * List all user tables in a PostgreSQL database.
+ */
+export declare function listPgTables(db: DbAdapter): string[];
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACnB,UAAU,EAAE,CAEd;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACnB,UAAU,EAAE,CAEd;AAoLD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,CAKxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,CAKpD"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@hasna/cloud",
+  "version": "0.1.0",
+  "description": "Shared cloud infrastructure — database adapter (SQLite + PostgreSQL), sync engine, feedback system, unified dotfile config",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "cloud": "dist/cli/index.js",
+    "cloud-mcp": "dist/mcp/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node && bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/mcp/index.ts --outdir dist/mcp --target node && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "commander": "^13.1.0",
+    "pg": "^8.13.3",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.6",
+    "@types/pg": "^8.11.11",
+    "typescript": "^5.7.3"
+  }
+}