@junobuild/config 2.3.0 → 2.4.1

package/dist/types/index.d.ts

@@ -15,6 +15,7 @@ export * from './satellite/configs/module.settings';
 export * from './satellite/configs/orbiter.config';
 export * from './satellite/configs/rules';
 export * from './satellite/configs/satellite.config';
+export * from './satellite/constants/emulator.constants';
 export * from './satellite/juno.config';
 export * from './shared/feature.config';
 export * from './shared/storage.config';

package/dist/types/satellite/configs/emulator.config.d.ts

@@ -80,6 +80,62 @@ export interface EmulatorRunner {
      */
     platform?: 'linux/amd64' | 'linux/arm64';
 }
+/**
+ * Network services that can be enabled in the emulator.
+ *
+ * Each flag corresponds to a system canister or application that can be included
+ * in the local Internet Computer network when the emulator starts.
+ */
+export interface NetworkServices {
+    /**
+     * Registry canister: Stores network configuration and topology (subnet membership, public keys, feature flags).
+     * Acts as the source of truth other system canisters read/write to.
+     */
+    registry?: boolean;
+    /**
+     * CMC (Cycles Minting Canister): Converts ICP to cycles and distributes them; maintains subnet lists and conversion rate.
+     * Requires icp and nns to not be enabled.
+     */
+    cmc?: boolean;
+    /**
+     * ICP token: Deploys the ICP ledger and index canisters.
+     */
+    icp?: boolean;
+    /**
+     * Cycles token: Deploys the cycles ledger and index canisters.
+     */
+    cycles?: boolean;
+    /**
+     * NNS governance canisters: Deploys the governance and root canisters.
+     * Core governance system (neurons, proposals, voting) and related control logic.
+     * Enables managing network-level decisions in an emulated environment.
+     */
+    nns?: boolean;
+    /**
+     * SNS canisters: Deploys the SNS-W and aggregator canisters.
+     * Service Nervous System stack used to govern individual dapps.
+     */
+    sns?: boolean;
+    /**
+     * Internet Identity: Deploys the II canister for authentication.
+     */
+    internet_identity?: boolean;
+    /**
+     * NNS dapp: Deploys the NNS UI canister and frontend application
+     * Requires cmc, icp, nns, sns, internet_identity to be enabled.
+     */
+    nns_dapp?: boolean;
+}
+/**
+ * Configuration for customizing the Internet Computer network bootstrapped
+ * by the emulator.
+ */
+export interface Network {
+    /**
+     * System canisters and applications available in the network.
+     */
+    services: NetworkServices;
+}
 /**
  * @see EmulatorConfig
  */
@@ -98,6 +154,18 @@ export declare const EmulatorConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
             "linux/arm64": "linux/arm64";
         }>>;
     }, z.core.$strict>>;
+    network: z.ZodOptional<z.ZodObject<{
+        services: z.ZodObject<{
+            registry: z.ZodOptional<z.ZodBoolean>;
+            cmc: z.ZodOptional<z.ZodBoolean>;
+            icp: z.ZodOptional<z.ZodBoolean>;
+            cycles: z.ZodOptional<z.ZodBoolean>;
+            nns: z.ZodOptional<z.ZodBoolean>;
+            sns: z.ZodOptional<z.ZodBoolean>;
+            internet_identity: z.ZodOptional<z.ZodBoolean>;
+            nns_dapp: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
     skylab: z.ZodObject<{
         ports: z.ZodOptional<z.ZodObject<{
             server: z.ZodOptional<z.ZodNumber>;
@@ -120,6 +188,18 @@ export declare const EmulatorConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
             "linux/arm64": "linux/arm64";
         }>>;
     }, z.core.$strict>>;
+    network: z.ZodOptional<z.ZodObject<{
+        services: z.ZodObject<{
+            registry: z.ZodOptional<z.ZodBoolean>;
+            cmc: z.ZodOptional<z.ZodBoolean>;
+            icp: z.ZodOptional<z.ZodBoolean>;
+            cycles: z.ZodOptional<z.ZodBoolean>;
+            nns: z.ZodOptional<z.ZodBoolean>;
+            sns: z.ZodOptional<z.ZodBoolean>;
+            internet_identity: z.ZodOptional<z.ZodBoolean>;
+            nns_dapp: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
     console: z.ZodObject<{
         ports: z.ZodOptional<z.ZodObject<{
             /**
@@ -147,6 +227,18 @@ export declare const EmulatorConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
             "linux/arm64": "linux/arm64";
         }>>;
     }, z.core.$strict>>;
+    network: z.ZodOptional<z.ZodObject<{
+        services: z.ZodObject<{
+            registry: z.ZodOptional<z.ZodBoolean>;
+            cmc: z.ZodOptional<z.ZodBoolean>;
+            icp: z.ZodOptional<z.ZodBoolean>;
+            cycles: z.ZodOptional<z.ZodBoolean>;
+            nns: z.ZodOptional<z.ZodBoolean>;
+            sns: z.ZodOptional<z.ZodBoolean>;
+            internet_identity: z.ZodOptional<z.ZodBoolean>;
+            nns_dapp: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
     satellite: z.ZodObject<{
         ports: z.ZodOptional<z.ZodObject<{
             /**
@@ -165,11 +257,14 @@ export declare const EmulatorConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
  */
 export type EmulatorConfig = {
     runner?: EmulatorRunner;
+    network?: Network;
     skylab: EmulatorSkylab;
 } | {
     runner?: EmulatorRunner;
+    network?: Network;
     console: EmulatorConsole;
 } | {
     runner?: EmulatorRunner;
+    network?: Network;
     satellite: EmulatorSatellite;
 };

package/dist/types/satellite/constants/emulator.constants.d.ts

@@ -0,0 +1,3 @@
+import type { NetworkServices } from '../configs/emulator.config';
+export declare const DEFAULT_NETWORK_SERVICES: NetworkServices;
+export declare const DEFAULT_SATELLITE_NETWORK_SERVICES: NetworkServices;

package/dist/types/satellite/juno.config.d.ts

@@ -245,6 +245,18 @@ export declare const JunoConfigSchema: z.ZodObject<{
                 "linux/arm64": "linux/arm64";
             }>>;
         }, z.core.$strict>>;
+        network: z.ZodOptional<z.ZodObject<{
+            services: z.ZodObject<{
+                registry: z.ZodOptional<z.ZodBoolean>;
+                cmc: z.ZodOptional<z.ZodBoolean>;
+                icp: z.ZodOptional<z.ZodBoolean>;
+                cycles: z.ZodOptional<z.ZodBoolean>;
+                nns: z.ZodOptional<z.ZodBoolean>;
+                sns: z.ZodOptional<z.ZodBoolean>;
+                internet_identity: z.ZodOptional<z.ZodBoolean>;
+                nns_dapp: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
         skylab: z.ZodObject<{
             ports: z.ZodOptional<z.ZodObject<{
                 server: z.ZodOptional<z.ZodNumber>;
@@ -267,6 +279,18 @@ export declare const JunoConfigSchema: z.ZodObject<{
                 "linux/arm64": "linux/arm64";
             }>>;
         }, z.core.$strict>>;
+        network: z.ZodOptional<z.ZodObject<{
+            services: z.ZodObject<{
+                registry: z.ZodOptional<z.ZodBoolean>;
+                cmc: z.ZodOptional<z.ZodBoolean>;
+                icp: z.ZodOptional<z.ZodBoolean>;
+                cycles: z.ZodOptional<z.ZodBoolean>;
+                nns: z.ZodOptional<z.ZodBoolean>;
+                sns: z.ZodOptional<z.ZodBoolean>;
+                internet_identity: z.ZodOptional<z.ZodBoolean>;
+                nns_dapp: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
         console: z.ZodObject<{
             ports: z.ZodOptional<z.ZodObject<{
                 server: z.ZodOptional<z.ZodNumber>;
@@ -288,6 +312,18 @@ export declare const JunoConfigSchema: z.ZodObject<{
                 "linux/arm64": "linux/arm64";
             }>>;
         }, z.core.$strict>>;
+        network: z.ZodOptional<z.ZodObject<{
+            services: z.ZodObject<{
+                registry: z.ZodOptional<z.ZodBoolean>;
+                cmc: z.ZodOptional<z.ZodBoolean>;
+                icp: z.ZodOptional<z.ZodBoolean>;
+                cycles: z.ZodOptional<z.ZodBoolean>;
+                nns: z.ZodOptional<z.ZodBoolean>;
+                sns: z.ZodOptional<z.ZodBoolean>;
+                internet_identity: z.ZodOptional<z.ZodBoolean>;
+                nns_dapp: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
         satellite: z.ZodObject<{
             ports: z.ZodOptional<z.ZodObject<{
                 server: z.ZodOptional<z.ZodNumber>;

package/dist/types/satellite/validators/emulator.validators.d.ts

@@ -0,0 +1,5 @@
+import type * as z from 'zod';
+import type { EmulatorConfigSchema } from '../configs/emulator.config';
+type EmulatorConfigInput = z.input<typeof EmulatorConfigSchema>;
+export declare const refineEmulatorConfig: (cfg: EmulatorConfigInput, ctx: z.RefinementCtx) => void;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junobuild/config",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Configuration options for Juno CLI",
   "author": "David Dal Busco (https://daviddalbusco.com)",
   "license": "MIT",