@no-witness-labs/midday-sdk 0.1.1 → 0.2.0

package/dist/devnet/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Error types for DevNet operations.
+ *
+ * @since 0.2.0
+ * @module
+ */
+import { Data } from 'effect';
+/**
+ * Error thrown when cluster operations fail.
+ *
+ * @since 0.2.0
+ * @category errors
+ */
+export class ClusterError extends Data.TaggedError('ClusterError') {
+}
+/**
+ * Error thrown when container operations fail.
+ *
+ * @since 0.2.0
+ * @category errors
+ */
+export class ContainerError extends Data.TaggedError('ContainerError') {
+}
+/**
+ * Error thrown when health check fails.
+ *
+ * @since 0.2.0
+ * @category errors
+ */
+export class HealthCheckError extends Data.TaggedError('HealthCheckError') {
+}
+/**
+ * Error thrown when Docker is not running.
+ *
+ * @since 0.2.0
+ * @category errors
+ */
+export class DockerNotRunningError extends Data.TaggedError('DockerNotRunningError') {
+}
+//# sourceMappingURL=errors.js.map

package/dist/devnet/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/devnet/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,IAAI,CAAC,WAAW,CAAC,cAAc,CAI/D;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAInE;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAGvE;CAAG;AAEL;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAEjF;CAAG"}

package/dist/devnet/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * DevNet module for local Midnight development and testing.
+ *
+ * Provides a complete local development environment with Docker containers
+ * for Midnight node, indexer, and proof server.
+ *
+ * @example Promise API (default)
+ * ```typescript
+ * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+ * import { createClient } from '@no-witness-labs/midday-sdk';
+ *
+ * // Create and start a local devnet
+ * const cluster = await Cluster.make();
+ * await Cluster.start(cluster);
+ *
+ * // Use with midday-sdk
+ * const client = await createClient({
+ *   networkConfig: Cluster.toNetworkConfig(cluster),
+ *   seed: 'your-wallet-seed',
+ * });
+ *
+ * // ... run your tests or development ...
+ *
+ * // Cleanup
+ * await Cluster.remove(cluster);
+ * ```
+ *
+ * @example Effect API (composable)
+ * ```typescript
+ * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+ * import { Effect } from 'effect';
+ *
+ * // Compose with Effect
+ * const program = Effect.gen(function* () {
+ *   const cluster = yield* Cluster.effect.make();
+ *   yield* Cluster.effect.start(cluster);
+ *   // ... your Effect-based code ...
+ *   yield* Cluster.effect.remove(cluster);
+ * });
+ *
+ * await Effect.runPromise(program);
+ * ```
+ *
+ * @example Effect DI (dependency injection)
+ * ```typescript
+ * import { Cluster, ClusterService } from '@no-witness-labs/midday-sdk/devnet';
+ * import { Effect } from 'effect';
+ *
+ * // Use with Effect's dependency injection
+ * const program = Effect.gen(function* () {
+ *   const svc = yield* ClusterService;
+ *   const cluster = yield* svc.make();
+ *   yield* svc.start(cluster);
+ *   return Cluster.toNetworkConfig(cluster);
+ * });
+ *
+ * await Effect.runPromise(program.pipe(Effect.provide(Cluster.Live)));
+ * ```
+ *
+ * @since 0.2.0
+ * @module
+ */
+export * as Cluster from './Cluster.js';
+export * as Config from './Config.js';
+export * as Container from './Container.js';
+export * as Health from './Health.js';
+export * as Images from './Images.js';
+export * from './errors.js';
+export { ClusterService } from './Cluster.js';
+export { ContainerService } from './Container.js';
+export { HealthService } from './Health.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/devnet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/devnet/index.js

@@ -0,0 +1,73 @@
+/**
+ * DevNet module for local Midnight development and testing.
+ *
+ * Provides a complete local development environment with Docker containers
+ * for Midnight node, indexer, and proof server.
+ *
+ * @example Promise API (default)
+ * ```typescript
+ * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+ * import { createClient } from '@no-witness-labs/midday-sdk';
+ *
+ * // Create and start a local devnet
+ * const cluster = await Cluster.make();
+ * await Cluster.start(cluster);
+ *
+ * // Use with midday-sdk
+ * const client = await createClient({
+ *   networkConfig: Cluster.toNetworkConfig(cluster),
+ *   seed: 'your-wallet-seed',
+ * });
+ *
+ * // ... run your tests or development ...
+ *
+ * // Cleanup
+ * await Cluster.remove(cluster);
+ * ```
+ *
+ * @example Effect API (composable)
+ * ```typescript
+ * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+ * import { Effect } from 'effect';
+ *
+ * // Compose with Effect
+ * const program = Effect.gen(function* () {
+ *   const cluster = yield* Cluster.effect.make();
+ *   yield* Cluster.effect.start(cluster);
+ *   // ... your Effect-based code ...
+ *   yield* Cluster.effect.remove(cluster);
+ * });
+ *
+ * await Effect.runPromise(program);
+ * ```
+ *
+ * @example Effect DI (dependency injection)
+ * ```typescript
+ * import { Cluster, ClusterService } from '@no-witness-labs/midday-sdk/devnet';
+ * import { Effect } from 'effect';
+ *
+ * // Use with Effect's dependency injection
+ * const program = Effect.gen(function* () {
+ *   const svc = yield* ClusterService;
+ *   const cluster = yield* svc.make();
+ *   yield* svc.start(cluster);
+ *   return Cluster.toNetworkConfig(cluster);
+ * });
+ *
+ * await Effect.runPromise(program.pipe(Effect.provide(Cluster.Live)));
+ * ```
+ *
+ * @since 0.2.0
+ * @module
+ */
+export * as Cluster from './Cluster.js';
+export * as Config from './Config.js';
+export * as Container from './Container.js';
+export * as Health from './Health.js';
+export * as Images from './Images.js';
+export * from './errors.js';
+// Re-export service tags for DI users
+export { ClusterService } from './Cluster.js';
+export { ContainerService } from './Container.js';
+export { HealthService } from './Health.js';
+//# sourceMappingURL=index.js.map

package/dist/devnet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/devnet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,cAAc,aAAa,CAAC;AAE5B,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@no-witness-labs/midday-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Developer-friendly SDK for building dapps on Midnight Network",
   "type": "module",
   "main": "dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./devnet": {
+      "types": "./dist/devnet/index.d.ts",
+      "import": "./dist/devnet/index.js"
     }
   },
   "files": [
@@ -30,17 +34,22 @@
     "@midnight-ntwrk/wallet-sdk-hd": "3.0.0-beta.7",
     "@midnight-ntwrk/wallet-sdk-shielded": "1.0.0-beta.12",
     "@midnight-ntwrk/wallet-sdk-unshielded-wallet": "1.0.0-beta.14",
+    "dockerode": "^4.0.7",
+    "effect": "^3.19.15",
     "pino": "^8.16.0",
     "pino-pretty": "^10.2.3",
-    "rxjs": "^7.8.1"
+    "rxjs": "^7.8.1",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
     "@changesets/cli": "^2.28.1",
-    "typedoc": "^0.28.7",
-    "typedoc-plugin-markdown": "^4.6.3",
     "@eslint/js": "^9.34.0",
+    "@types/dockerode": "^3.3.43",
     "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.10",
     "eslint": "^9.34.0",
+    "typedoc": "^0.28.7",
+    "typedoc-plugin-markdown": "^4.6.3",
     "typescript": "^5.6.0",
     "typescript-eslint": "^8.33.0",
     "vitest": "^3.2.4"
@@ -76,6 +85,7 @@
     "docgen:html": "typedoc --options typedoc.html.json",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:devnet": "vitest run test/devnet.integration.test.ts",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "changeset:publish": "pnpm build && changeset publish"