@hauska-sdk/node-manager 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @hauska-sdk/node-manager
+ *
+ * Provision and manage IPFS nodes for Hauska SDK consumers.
+ * Supports fly.io, GCP, AWS, and Docker.
+ *
+ * @example
+ * import { NodeManager } from '@hauska-sdk/node-manager';
+ *
+ * const manager = new NodeManager({ provider: 'fly.io' });
+ * await manager.provision({ region: 'iad', memory: '512mb' });
+ * const { apiUrl, gatewayUrl } = await manager.getEndpoints();
+ */
+export type NodeProvider = "fly.io" | "gcp" | "aws" | "docker";
+export interface NodeManagerConfig {
+    provider: NodeProvider;
+    authToken?: string;
+    projectId?: string;
+    region?: string;
+}
+export interface NodeEndpoints {
+    apiUrl: string;
+    gatewayUrl: string;
+    peerId?: string;
+}
+export interface ProvisionOptions {
+    region?: string;
+    memory?: string;
+    replicas?: number;
+    name?: string;
+}
+export interface NodeStatus {
+    healthy: boolean;
+    peerId?: string;
+    version?: string;
+    peers?: number;
+    repoSize?: string;
+}
+/**
+ * NodeManager — provision and manage IPFS nodes for Hauska SDK
+ *
+ * Status: Scaffold only. Provider implementations are stubs.
+ * Full implementations coming in node-manager v0.2.
+ */
+export declare class NodeManager {
+    private config;
+    constructor(config: NodeManagerConfig);
+    /**
+     * Provision a new IPFS node with the configured provider.
+     * Returns endpoints once the node is ready.
+     */
+    provision(_options?: ProvisionOptions): Promise<NodeEndpoints>;
+    /**
+     * Get endpoints for an already-running node.
+     */
+    getEndpoints(): Promise<NodeEndpoints>;
+    /**
+     * Check health of a running node.
+     */
+    checkHealth(apiUrl: string): Promise<NodeStatus>;
+    /**
+     * Docker run command for local development.
+     * Copy-paste this to get an IPFS node running locally.
+     */
+    static dockerDevCommand(port?: number, gatewayPort?: number): string;
+}
+//# 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":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IAIrC;;;OAGG;IAEG,SAAS,CAAC,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IASxE;;OAEG;IAEG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAM5C;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBtD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,SAAO,EAAE,WAAW,SAAO,GAAG,MAAM;CAWjE"}

package/dist/index.js

@@ -0,0 +1,79 @@
+/**
+ * @hauska-sdk/node-manager
+ *
+ * Provision and manage IPFS nodes for Hauska SDK consumers.
+ * Supports fly.io, GCP, AWS, and Docker.
+ *
+ * @example
+ * import { NodeManager } from '@hauska-sdk/node-manager';
+ *
+ * const manager = new NodeManager({ provider: 'fly.io' });
+ * await manager.provision({ region: 'iad', memory: '512mb' });
+ * const { apiUrl, gatewayUrl } = await manager.getEndpoints();
+ */
+/**
+ * NodeManager — provision and manage IPFS nodes for Hauska SDK
+ *
+ * Status: Scaffold only. Provider implementations are stubs.
+ * Full implementations coming in node-manager v0.2.
+ */
+export class NodeManager {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Provision a new IPFS node with the configured provider.
+     * Returns endpoints once the node is ready.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async provision(_options = {}) {
+        throw new Error(`NodeManager.provision() not yet implemented for provider: ${this.config.provider}. ` +
+            `Coming in @hauska-sdk/node-manager v0.2. ` +
+            `For now, run IPFS manually with Docker: ` +
+            `docker run -d -p 5001:5001 -p 8080:8080 ipfs/kubo`);
+    }
+    /**
+     * Get endpoints for an already-running node.
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getEndpoints() {
+        throw new Error(`NodeManager.getEndpoints() not yet implemented for provider: ${this.config.provider}.`);
+    }
+    /**
+     * Check health of a running node.
+     */
+    async checkHealth(apiUrl) {
+        try {
+            const response = await fetch(`${apiUrl}/api/v0/id`, { method: "POST" });
+            if (!response.ok)
+                return { healthy: false };
+            const data = (await response.json());
+            return {
+                healthy: true,
+                peerId: data.ID,
+                version: data.AgentVersion,
+                peers: Array.isArray(data.Peers) ? data.Peers.length : 0,
+            };
+        }
+        catch {
+            return { healthy: false };
+        }
+    }
+    /**
+     * Docker run command for local development.
+     * Copy-paste this to get an IPFS node running locally.
+     */
+    static dockerDevCommand(port = 5001, gatewayPort = 8080) {
+        return [
+            "docker run -d",
+            `--name hauska-ipfs`,
+            `-p ${port}:5001`,
+            `-p ${gatewayPort}:8080`,
+            `-v hauska-ipfs-data:/data/ipfs`,
+            "ipfs/kubo:latest",
+            "--migrate=true --agent-version-suffix=hauska",
+        ].join(" \\\n  ");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgCH;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAoB;IAElC,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,4DAA4D;IAC5D,KAAK,CAAC,SAAS,CAAC,WAA6B,EAAE;QAC7C,MAAM,IAAI,KAAK,CACb,6DAA6D,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI;YACnF,2CAA2C;YAC3C,0CAA0C;YAC1C,mDAAmD,CACtD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,4DAA4D;IAC5D,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,KAAK,CACb,gEAAgE,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,CACxF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,OAAO,EAAE,IAAI,CAAC,YAAY;gBAC1B,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;aACzD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,GAAG,IAAI,EAAE,WAAW,GAAG,IAAI;QACrD,OAAO;YACL,eAAe;YACf,oBAAoB;YACpB,MAAM,IAAI,OAAO;YACjB,MAAM,WAAW,OAAO;YACxB,gCAAgC;YAChC,kBAAkB;YAClB,8CAA8C;SAC/C,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@hauska-sdk/node-manager",
+  "version": "0.1.0",
+  "description": "Provision and manage IPFS nodes for Hauska SDK — fly.io, GCP, AWS, Docker",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "rimraf": "^5.0.5",
+    "@types/node": "^20.11.0"
+  },
+  "keywords": [
+    "hauska",
+    "ipfs",
+    "node-manager",
+    "provisioning",
+    "fly.io",
+    "gcp",
+    "aws",
+    "docker"
+  ],
+  "author": "Hauska SDK Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hauska-sdk/hauska-sdk.git",
+    "directory": "packages/adapters/node-manager"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}