@hasna/cloud 0.1.0

package/dist/cli-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from "commander";
+/**
+ * Register cloud-related subcommands onto an existing Commander program.
+ * Services call this to embed cloud sync/feedback commands into their own CLI.
+ *
+ * @example
+ * ```ts
+ * import { Command } from "commander";
+ * import { registerCloudCommands } from "@hasna/cloud";
+ *
+ * const program = new Command();
+ * registerCloudCommands(program, "my-service");
+ * program.parse();
+ * ```
+ */
+export declare function registerCloudCommands(program: Command, serviceName: string): void;
+//# sourceMappingURL=cli-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-helpers.d.ts","sourceRoot":"","sources":["../src/cli-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,GAClB,IAAI,CAwHN"}

package/dist/config.d.ts

@@ -0,0 +1,73 @@
+import { z } from "zod";
+export declare const CloudConfigSchema: z.ZodObject<{
+    rds: z.ZodDefault<z.ZodObject<{
+        host: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+        username: z.ZodDefault<z.ZodString>;
+        password_env: z.ZodDefault<z.ZodString>;
+        ssl: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+        username: string;
+        password_env: string;
+        ssl: boolean;
+    }, {
+        host?: string | undefined;
+        port?: number | undefined;
+        username?: string | undefined;
+        password_env?: string | undefined;
+        ssl?: boolean | undefined;
+    }>>;
+    mode: z.ZodDefault<z.ZodEnum<["local", "cloud", "hybrid"]>>;
+    auto_sync_interval_minutes: z.ZodDefault<z.ZodNumber>;
+    feedback_endpoint: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    rds: {
+        host: string;
+        port: number;
+        username: string;
+        password_env: string;
+        ssl: boolean;
+    };
+    mode: "local" | "cloud" | "hybrid";
+    auto_sync_interval_minutes: number;
+    feedback_endpoint: string;
+}, {
+    rds?: {
+        host?: string | undefined;
+        port?: number | undefined;
+        username?: string | undefined;
+        password_env?: string | undefined;
+        ssl?: boolean | undefined;
+    } | undefined;
+    mode?: "local" | "cloud" | "hybrid" | undefined;
+    auto_sync_interval_minutes?: number | undefined;
+    feedback_endpoint?: string | undefined;
+}>;
+export type CloudConfig = z.infer<typeof CloudConfigSchema>;
+export declare function getConfigDir(): string;
+export declare function getConfigPath(): string;
+export declare function getCloudConfig(): CloudConfig;
+export declare function saveCloudConfig(config: CloudConfig): void;
+export declare function getConnectionString(dbName: string): string;
+import { type DbAdapter } from "./adapter.js";
+export interface CreateDatabaseOptions {
+    /** Service name — used to locate the SQLite file and PG database. */
+    service: string;
+    /** Override mode from config. */
+    mode?: "local" | "cloud" | "hybrid";
+    /** Override the SQLite file path. */
+    sqlitePath?: string;
+    /** Override the PG connection string. */
+    pgConnectionString?: string;
+}
+/**
+ * Create a database adapter based on the current configuration.
+ *
+ * - `local` mode → SqliteAdapter
+ * - `cloud` mode → PgAdapter
+ * - `hybrid` mode → SqliteAdapter (PG is used only for sync)
+ */
+export declare function createDatabase(options: CreateDatabaseOptions): DbAdapter;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAS5D,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAMD,wBAAgB,cAAc,IAAI,WAAW,CAU5C;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAGzD;AAMD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa1D;AAMD,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGxE,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,CAaxE"}

package/dist/dialect.d.ts

@@ -0,0 +1,17 @@
+export type Dialect = "sqlite" | "pg";
+/**
+ * Translate SQLite-flavored SQL to PostgreSQL.
+ * When dialect is "sqlite", returns the SQL unchanged.
+ */
+export declare function translateSql(sql: string, dialect: Dialect): string;
+/**
+ * Flatten params for PG — bun:sqlite accepts variadic params or a single
+ * array; pg always wants a flat array. Also handles undefined → null.
+ */
+export declare function translateParams(params: any[]): any[];
+/**
+ * Translate a CREATE TABLE statement from SQLite DDL to PostgreSQL DDL.
+ * More aggressive transformations than query-level translation.
+ */
+export declare function translateDdl(ddl: string, dialect: Dialect): string;
+//# sourceMappingURL=dialect.d.ts.map

package/dist/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAGlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAKpD;AAyFD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CA6BlE"}

package/dist/dotfile.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Returns `~/.hasna/<serviceName>/`, creating it if needed.
+ */
+export declare function getDataDir(serviceName: string): string;
+/**
+ * Returns the path for the service's SQLite database:
+ * `~/.hasna/<serviceName>/<serviceName>.db`
+ */
+export declare function getDbPath(serviceName: string): string;
+/**
+ * Migrate from legacy `~/.<serviceName>/` to `~/.hasna/<serviceName>/`.
+ *
+ * - If `~/.<serviceName>/` exists and `~/.hasna/<serviceName>/` does NOT,
+ *   copies all contents over.
+ * - Returns a list of migrated file paths (relative to the source dir),
+ *   or an empty array if no migration was needed.
+ */
+export declare function migrateDotfile(serviceName: string): string[];
+/**
+ * Check if a legacy dotfile directory exists for the given service.
+ */
+export declare function hasLegacyDotfile(serviceName: string): boolean;
+/**
+ * Get the `.hasna` base directory.
+ */
+export declare function getHasnaDir(): string;
+//# sourceMappingURL=dotfile.d.ts.map

package/dist/dotfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotfile.d.ts","sourceRoot":"","sources":["../src/dotfile.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGrD;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAe5D;AAsBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC"}

package/dist/feedback.d.ts

@@ -0,0 +1,32 @@
+import type { DbAdapter } from "./adapter.js";
+export interface Feedback {
+    id?: string;
+    service: string;
+    version?: string;
+    message: string;
+    email?: string;
+    machine_id?: string;
+    created_at?: string;
+}
+/**
+ * Ensure the feedback table exists in the given database.
+ */
+export declare function ensureFeedbackTable(db: DbAdapter): void;
+/**
+ * Save feedback to the local database.
+ */
+export declare function saveFeedback(db: DbAdapter, feedback: Feedback): string;
+/**
+ * Send feedback to the remote endpoint.
+ * If the POST fails, saves locally and does NOT throw.
+ */
+export declare function sendFeedback(feedback: Feedback, db?: DbAdapter): Promise<{
+    sent: boolean;
+    id: string;
+    error?: string;
+}>;
+/**
+ * Get all feedback entries from the local database.
+ */
+export declare function listFeedback(db: DbAdapter): Feedback[];
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAEvD;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAsBtE;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,EAAE,CAAC,EAAE,SAAS,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsDxD;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,QAAQ,EAAE,CAKtD"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { SqliteAdapter, PgAdapter, PgAdapterAsync, type DbAdapter, type PreparedStatement, type RunResult, } from "./adapter.js";
+export { translateSql, translateDdl, translateParams, type Dialect, } from "./dialect.js";
+export { getCloudConfig, saveCloudConfig, getConnectionString, createDatabase, getConfigDir, getConfigPath, CloudConfigSchema, type CloudConfig, type CreateDatabaseOptions, } from "./config.js";
+export { syncPush, syncPull, listSqliteTables, listPgTables, type SyncOptions, type SyncResult, type SyncProgress, type SyncProgressCallback, } from "./sync.js";
+export { saveFeedback, sendFeedback, listFeedback, ensureFeedbackTable, type Feedback, } from "./feedback.js";
+export { migrateDotfile, getDataDir, getDbPath, hasLegacyDotfile, getHasnaDir, } from "./dotfile.js";
+export { registerCloudTools } from "./mcp-helpers.js";
+export { registerCloudCommands } from "./cli-helpers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,aAAa,EACb,SAAS,EACT,cAAc,EACd,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,SAAS,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,KAAK,OAAO,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}