@hasna/cloud 0.1.35 → 0.1.36

package/LICENSE

@@ -1,3 +1,4 @@
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -175,7 +176,7 @@
 
    END OF TERMS AND CONDITIONS
 
-   Copyright 2024 Hasna
+   Copyright 2026 Hasna, Inc.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,34 +1,45 @@
 # @hasna/cloud
 
-Archived reference for legacy Hasna cloud sync adapters.
+Shared cloud infrastructure — database adapter (SQLite + PostgreSQL), sync engine, feedback system, unified dotfile config
 
 [![npm](https://img.shields.io/npm/v/@hasna/cloud)](https://www.npmjs.com/package/@hasna/cloud)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
 
-## Status
+## Install
 
-`@hasna/cloud` is no longer a runtime dependency target for `open-[name]`
-packages. It is kept as a reference for older SQLite/PostgreSQL sync,
-feedback, machine registry, and dotfile migration ideas while open packages
-move to repo-native local/remote storage contracts.
-
-Do not add `@hasna/cloud` to a public `open-[name]` package. New work should
-follow the shared boundary:
-
-- local-first storage lives in the open repo
-- optional remote mode is explicit and repo-native
-- hosted databases, object storage, secrets, workers, auth, billing, and
-  deployment live in the matching `platform-[name]` wrapper
+```bash
+npm install -g @hasna/cloud
+```
 
-## Published Stub
+## CLI Usage
 
 ```bash
 cloud --help
 ```
 
-The final published package is a stub. The CLI and MCP binaries print a
-deprecation message and exit without writing config, creating dotfiles, opening
-network connections, or installing runtime dependencies.
+- `cloud setup`
+- `cloud status`
+- `cloud sync push`
+- `cloud sync pull`
+- `cloud sync schedule`
+- `cloud sync daemon --start`
+- `cloud sync daemon --status`
+- `cloud feedback`
+- `cloud migrate`
+
+## SDK
+
+`createDatabase()` now returns a machine-aware adapter. On open, it ensures a
+`machines` registry table exists, auto-registers the current host, and tags
+user-table writes with `machine_id`.
+
+```ts
+import { createDatabase } from "@hasna/cloud";
+
+const db = createDatabase({ service: "todos" });
+const current = db.machines.currentMachine();
+const allMachines = db.machines.list();
+```
 
 ## MCP Server
 
@@ -36,15 +47,7 @@ network connections, or installing runtime dependencies.
 cloud-mcp
 ```
 
-The MCP binary is also a deprecation stub.
-
-## Archive Policy
-
-This repository is marked `private: true` to prevent accidental npm publishing.
-It must not have install-time side effects, default hosted endpoints, or
-release automation. Useful implementation details should be copied into
-repo-specific local interfaces, docs, or templates before this repository is
-removed from active maintenance.
+4 tools available.
 
 ## License
 

package/dist/adapter.d.ts

@@ -0,0 +1,65 @@
+import { Database } from "bun:sqlite";
+import pg from "pg";
+export interface RunResult {
+    changes: number;
+    lastInsertRowid: number | bigint;
+}
+export interface PreparedStatement {
+    run(...params: any[]): RunResult;
+    get(...params: any[]): any;
+    all(...params: any[]): any[];
+    finalize(): void;
+}
+export interface DbAdapter {
+    run(sql: string, ...params: any[]): RunResult;
+    get(sql: string, ...params: any[]): any;
+    all(sql: string, ...params: any[]): any[];
+    exec(sql: string): void;
+    prepare(sql: string): PreparedStatement;
+    close(): void;
+    transaction<T>(fn: () => T): T;
+}
+export declare class SqliteAdapter implements DbAdapter {
+    private db;
+    constructor(path: string);
+    run(sql: string, ...params: any[]): RunResult;
+    get(sql: string, ...params: any[]): any;
+    all(sql: string, ...params: any[]): any[];
+    exec(sql: string): void;
+    /** Passthrough to bun:sqlite's .query() for compatibility with code that uses db.query() */
+    query(sql: string): import("bun:sqlite").Statement<unknown, import("bun:sqlite").SQLQueryBindings[] | [null] | [string] | [number] | [bigint] | [false] | [true] | [Uint8Array<ArrayBufferLike>] | [Uint8ClampedArray<ArrayBufferLike>] | [Uint16Array<ArrayBufferLike>] | [Uint32Array<ArrayBufferLike>] | [Int8Array<ArrayBufferLike>] | [Int16Array<ArrayBufferLike>] | [Int32Array<ArrayBufferLike>] | [BigUint64Array<ArrayBufferLike>] | [BigInt64Array<ArrayBufferLike>] | [Float16Array<ArrayBufferLike>] | [Float32Array<ArrayBufferLike>] | [Float64Array<ArrayBufferLike>] | [Record<string, string | number | bigint | boolean | NodeJS.TypedArray<ArrayBufferLike> | null>]>;
+    prepare(sql: string): PreparedStatement;
+    close(): void;
+    transaction<T>(fn: () => T): T;
+    /** Expose the underlying bun:sqlite Database for advanced usage. */
+    get raw(): Database;
+}
+export declare class PgAdapter implements DbAdapter {
+    private pool;
+    private _client;
+    constructor(connectionString: string);
+    constructor(pool: pg.Pool);
+    private runSync;
+    run(sql: string, ...params: any[]): RunResult;
+    get(sql: string, ...params: any[]): any;
+    all(sql: string, ...params: any[]): any[];
+    exec(sql: string): void;
+    prepare(sql: string): PreparedStatement;
+    close(): void;
+    transaction<T>(fn: () => T): T;
+    /** Expose the underlying pg Pool for advanced usage. */
+    get raw(): pg.Pool;
+}
+export declare class PgAdapterAsync {
+    private pool;
+    constructor(connectionString: string);
+    constructor(pool: pg.Pool);
+    run(sql: string, ...params: any[]): Promise<RunResult>;
+    get(sql: string, ...params: any[]): Promise<any>;
+    all(sql: string, ...params: any[]): Promise<any[]>;
+    exec(sql: string): Promise<void>;
+    close(): Promise<void>;
+    transaction<T>(fn: (client: pg.PoolClient) => Promise<T>): Promise<T>;
+    get raw(): pg.Pool;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.test.d.ts.map

package/dist/adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.test.d.ts","sourceRoot":"","sources":["../src/adapter.test.ts"],"names":[],"mappings":""}

package/dist/auto-sync.d.ts

@@ -0,0 +1,28 @@
+import type { DbAdapter } from "./adapter.js";
+import { PgAdapterAsync } from "./adapter.js";
+export interface AutoSyncConfig {
+    auto_sync_on_start: boolean;
+    auto_sync_on_stop: boolean;
+}
+export interface AutoSyncContext {
+    serviceName: string;
+    local: DbAdapter;
+    tables: string[];
+    config: AutoSyncConfig;
+}
+export interface AutoSyncResult {
+    event: "start" | "stop";
+    direction: "pull" | "push";
+    success: boolean;
+    tables_synced: number;
+    total_rows_synced: number;
+    errors: string[];
+}
+export declare function getAutoSyncConfig(): AutoSyncConfig;
+export declare function setupAutoSync(serviceName: string, server: any, local: DbAdapter, remote: DbAdapter | PgAdapterAsync, tables: string[]): {
+    syncOnStart: () => Promise<AutoSyncResult | null>;
+    syncOnStop: () => Promise<AutoSyncResult | null>;
+    config: AutoSyncConfig;
+};
+export declare function enableAutoSync(serviceName: string, mcpServer: any, local: DbAdapter, remote: DbAdapter | PgAdapterAsync, tables: string[]): void;
+//# sourceMappingURL=auto-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-sync.d.ts","sourceRoot":"","sources":["../src/auto-sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAS9C,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD,wBAAgB,iBAAiB,IAAI,cAAc,CAmBlD;AAiGD,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,GAAG,EACX,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS,GAAG,cAAc,EAClC,MAAM,EAAE,MAAM,EAAE,GACf;IACD,WAAW,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClD,UAAU,EAAE,MAAM,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,EAAE,cAAc,CAAC;CACxB,CA8CA;AAMD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,GAAG,EACd,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS,GAAG,cAAc,EAClC,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAEN"}

package/dist/cli/cmd-doctor.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=cmd-doctor.d.ts.map

package/dist/cli/cmd-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-doctor.d.ts","sourceRoot":"","sources":["../../src/cli/cmd-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6F5D"}

package/dist/cli/cmd-feedback.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerFeedbackCommand(program: Command): void;
+//# sourceMappingURL=cmd-feedback.d.ts.map

package/dist/cli/cmd-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-feedback.d.ts","sourceRoot":"","sources":["../../src/cli/cmd-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+B9D"}

package/dist/cli/cmd-migrate.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerMigrateCommands(program: Command): void;
+//# sourceMappingURL=cmd-migrate.d.ts.map

package/dist/cli/cmd-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-migrate.d.ts","sourceRoot":"","sources":["../../src/cli/cmd-migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAG9D"}

package/dist/cli/cmd-setup.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerSetupCommand(program: Command): void;
+//# sourceMappingURL=cmd-setup.d.ts.map

package/dist/cli/cmd-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-setup.d.ts","sourceRoot":"","sources":["../../src/cli/cmd-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsH3D"}

package/dist/cli/cmd-sync.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from "commander";
+export declare function logSync(direction: string, service: string, rows: number, errors: number): void;
+export declare function registerSyncCommands(syncCmd: Command): void;
+//# sourceMappingURL=cmd-sync.d.ts.map

package/dist/cli/cmd-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-sync.d.ts","sourceRoot":"","sources":["../../src/cli/cmd-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCjD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAS9F;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ3D"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}