@junobuild/admin 0.1.8 → 0.2.0

package/dist/types/api/actor.api.d.ts

@@ -1,15 +1,36 @@
 import type { IDL } from '@dfinity/candid';
+import type { _SERVICE as DeprecatedMissionControlVersionActor } from '../../declarations/mission_control/mission_control-deprecated-version.did';
 import type { _SERVICE as MissionControlActor } from '../../declarations/mission_control/mission_control.did';
+import type { _SERVICE as DeprecatedOrbiterVersionActor } from '../../declarations/orbiter/orbiter-deprecated-version.did';
 import type { _SERVICE as OrbiterActor } from '../../declarations/orbiter/orbiter.did';
 import type { _SERVICE as DeprecatedSatelliteNoScopeActor } from '../../declarations/satellite/satellite-deprecated-no-scope.did';
+import type { _SERVICE as DeprecatedSatelliteVersionActor } from '../../declarations/satellite/satellite-deprecated-version.did';
 import type { _SERVICE as DeprecatedSatelliteActor } from '../../declarations/satellite/satellite-deprecated.did';
 import type { _SERVICE as SatelliteActor } from '../../declarations/satellite/satellite.did';
 import type { ActorParameters, MissionControlParameters, OrbiterParameters, SatelliteParameters } from '../types/actor.types';
+/**
+ * @deprecated TODO: for backwards compatibility - to be removed
+ */
 export declare const getDeprecatedSatelliteActor: ({ satelliteId, ...rest }: SatelliteParameters) => Promise<DeprecatedSatelliteActor>;
 export declare const getSatelliteActor: ({ satelliteId, ...rest }: SatelliteParameters) => Promise<SatelliteActor>;
+/**
+ * @deprecated TODO: for backwards compatibility - to be removed
+ */
 export declare const getDeprecatedSatelliteNoScopeActor: ({ satelliteId, ...rest }: SatelliteParameters) => Promise<DeprecatedSatelliteNoScopeActor>;
+/**
+ * @deprecated TODO: for backwards compatibility - to be removed
+ */
+export declare const getDeprecatedSatelliteVersionActor: ({ satelliteId, ...rest }: SatelliteParameters) => Promise<DeprecatedSatelliteVersionActor>;
 export declare const getMissionControlActor: ({ missionControlId, ...rest }: MissionControlParameters) => Promise<MissionControlActor>;
+/**
+ * @deprecated TODO: for backwards compatibility - to be removed
+ */
+export declare const getDeprecatedMissionControlVersionActor: ({ missionControlId, ...rest }: MissionControlParameters) => Promise<DeprecatedMissionControlVersionActor>;
 export declare const getOrbiterActor: ({ orbiterId, ...rest }: OrbiterParameters) => Promise<OrbiterActor>;
+/**
+ * @deprecated TODO: for backwards compatibility - to be removed
+ */
+export declare const getDeprecatedOrbiterVersionActor: ({ orbiterId, ...rest }: OrbiterParameters) => Promise<DeprecatedOrbiterVersionActor>;
 export declare const getActor: <T>({ canisterId, idlFactory, ...rest }: ActorParameters & {
     canisterId: string | undefined;
     idlFactory: IDL.InterfaceFactory;

package/dist/types/api/ic.api.d.ts

@@ -1,5 +1,5 @@
 import { CanisterStatus } from '@dfinity/agent';
-import { type chunk_hash, type InstallChunkedCodeParams, type UploadChunkParams, InstallCodeParams, list_canister_snapshots_result, snapshot_id } from '@dfinity/ic-management';
+import { type chunk_hash, type InstallChunkedCodeParams, type InstallCodeParams, type list_canister_snapshots_result, type snapshot_id, type UploadChunkParams } from '@dfinity/ic-management';
 import type { take_canister_snapshot_result } from '@dfinity/ic-management/dist/candid/ic-management';
 import type { CanisterStatusResponse } from '@dfinity/ic-management/dist/types/types/ic-management.responses';
 import { Principal } from '@dfinity/principal';
@@ -37,7 +37,7 @@ export declare const canisterStatus: ({ actor, canisterId }: {
     canisterId: Principal;
 }) => Promise<CanisterStatusResponse>;
 export declare const canisterMetadata: ({ canisterId, path, ...rest }: ActorParameters & {
-    canisterId: Principal | string | undefined;
+    canisterId: Principal | string;
     path: string;
 }) => Promise<CanisterStatus.Status | undefined>;
 export declare const listCanisterSnapshots: ({ actor, canisterId }: {

package/dist/types/api/mission-control.api.d.ts

@@ -1,6 +1,9 @@
 import type { Principal } from '@dfinity/principal';
 import type { Controller, SetController } from '../../declarations/mission_control/mission_control.did';
 import type { MissionControlParameters } from '../types/actor.types';
+/**
+ * @deprecated - Replaced in Mission Control > v0.0.14 with public custom section juno:package
+ */
 export declare const version: ({ missionControl }: {
     missionControl: MissionControlParameters;
 }) => Promise<string>;

package/dist/types/api/orbiter.api.d.ts

@@ -1,6 +1,9 @@
 import type { Principal } from '@dfinity/principal';
 import type { Controller, MemorySize } from '../../declarations/orbiter/orbiter.did';
 import type { OrbiterParameters } from '../types/actor.types';
+/**
+ * @deprecated - Replaced in Orbiter > v0.0.8 with public custom section juno:package
+ */
 export declare const version: ({ orbiter }: {
     orbiter: OrbiterParameters;
 }) => Promise<string>;

package/dist/types/api/satellite.api.d.ts

@@ -32,15 +32,21 @@ export declare const setRule: ({ type, collection, rule, satellite }: {
     rule: SetRule;
     satellite: SatelliteParameters;
 }) => Promise<Rule>;
+/**
+ * @deprecated - Replaced in Satellite > v0.0.22 with public custom section juno:package
+ */
 export declare const version: ({ satellite }: {
     satellite: SatelliteParameters;
 }) => Promise<string>;
-export declare const buildVersion: ({ satellite }: {
-    satellite: SatelliteParameters;
-}) => Promise<string>;
+/**
+ * @deprecated TODO: for backwards compatibility - to be removed
+ */
 export declare const listDeprecatedControllers: ({ satellite }: {
     satellite: SatelliteParameters;
 }) => Promise<Principal[]>;
+/**
+ * @deprecated TODO: for backwards compatibility - to be removed
+ */
 export declare const listDeprecatedNoScopeControllers: ({ satellite }: {
     satellite: SatelliteParameters;
 }) => Promise<[Principal, Controller][]>;

package/dist/types/errors/version.errors.d.ts

@@ -0,0 +1,9 @@
+export declare class SatelliteMissingDependencyError extends Error {
+    constructor();
+}
+export declare class MissionControlVersionError extends Error {
+    constructor();
+}
+export declare class OrbiterVersionError extends Error {
+    constructor();
+}

package/dist/types/handlers/upgrade.chunks.handlers.d.ts

@@ -1,2 +1,2 @@
-import { UpgradeCodeParams } from '../types/upgrade.types';
+import type { UpgradeCodeParams } from '../types/upgrade.types';
 export declare const upgradeChunkedCode: ({ actor, canisterId, missionControlId, wasmModule, preClearChunks: userPreClearChunks, ...rest }: UpgradeCodeParams) => Promise<void>;

package/dist/types/handlers/upgrade.handlers.d.ts

@@ -1,4 +1,4 @@
-import { UpgradeCodeParams } from '../types/upgrade.types';
+import { type UpgradeCodeParams } from '../types/upgrade.types';
 export declare const upgrade: ({ wasmModule, canisterId, actor, onProgress, takeSnapshot, ...rest }: UpgradeCodeParams & {
     reset?: boolean;
 }) => Promise<void>;

package/dist/types/handlers/upgrade.single.handlers.d.ts

@@ -1,2 +1,2 @@
-import { UpgradeCodeParams } from '../types/upgrade.types';
+import type { UpgradeCodeParams } from '../types/upgrade.types';
 export declare const upgradeSingleChunkCode: ({ actor, ...rest }: UpgradeCodeParams) => Promise<void>;

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from './errors/upgrade.errors';
+export * from './errors/version.errors';
 export * from './services/mission-control.controllers.services';
 export * from './services/mission-control.upgrade.services';
 export * from './services/mission-control.version.services';
@@ -25,3 +26,4 @@ export type * from './types/customdomain.types';
 export type * from './types/releases.types';
 export * from './types/upgrade.types';
 export * from './utils/crypto.utils';
+export * from './utils/package.utils';

package/dist/types/services/mission-control.controllers.services.d.ts

@@ -1,4 +1,4 @@
-import { Principal } from '@dfinity/principal';
+import type { Principal } from '@dfinity/principal';
 import type { Controller } from '../../declarations/mission_control/mission_control.did';
 import type { MissionControlParameters } from '../types/actor.types';
 import type { SetControllerParams } from '../types/controllers.types';

package/dist/types/services/mission-control.upgrade.services.d.ts

@@ -1,5 +1,5 @@
 import type { MissionControlParameters } from '../types/actor.types';
-import { UpgradeCodeParams } from '../types/upgrade.types';
+import type { UpgradeCodeParams } from '../types/upgrade.types';
 /**
  * Upgrades the Mission Control with the provided WASM module.
  * @param {Object} params - The parameters for upgrading the Mission Control.

package/dist/types/services/mission-control.version.services.d.ts

@@ -5,6 +5,6 @@ import type { MissionControlParameters } from '../types/actor.types';
  * @param {MissionControlParameters} params.missionControl - The Mission Control parameters.
  * @returns {Promise<string>} A promise that resolves to the version of Mission Control.
  */
-export declare const missionControlVersion: (params: {
+export declare const missionControlVersion: ({ missionControl: { missionControlId, ...rest } }: {
     missionControl: MissionControlParameters;
 }) => Promise<string>;

package/dist/types/services/orbiter.controllers.services.d.ts

@@ -1,4 +1,4 @@
-import { Principal } from '@dfinity/principal';
+import type { Principal } from '@dfinity/principal';
 import type { Controller } from '../../declarations/mission_control/mission_control.did';
 import type { OrbiterParameters } from '../types/actor.types';
 /**

package/dist/types/services/orbiter.upgrade.services.d.ts

@@ -1,5 +1,5 @@
 import type { OrbiterParameters } from '../types/actor.types';
-import { UpgradeCodeParams } from '../types/upgrade.types';
+import type { UpgradeCodeParams } from '../types/upgrade.types';
 /**
  * Upgrades the Orbiter with the provided WASM module.
  * @param {Object} params - The parameters for upgrading the Orbiter.

package/dist/types/services/orbiter.version.services.d.ts

@@ -5,6 +5,6 @@ import type { OrbiterParameters } from '../types/actor.types';
  * @param {OrbiterParameters} params.orbiter - The Orbiter parameters.
  * @returns {Promise<string>} A promise that resolves to the version of the Orbiter.
  */
-export declare const orbiterVersion: (params: {
+export declare const orbiterVersion: ({ orbiter: { orbiterId, ...rest } }: {
     orbiter: OrbiterParameters;
 }) => Promise<string>;

package/dist/types/services/package.services.d.ts

@@ -1,6 +1,6 @@
-import { Principal } from '@dfinity/principal';
+import type { Principal } from '@dfinity/principal';
 import { type JunoPackage } from '@junobuild/config';
-import { ActorParameters } from '../types/actor.types';
+import type { ActorParameters } from '../types/actor.types';
 /**
  * Parameters required to retrieve a `juno:package` metadata section.
  *
@@ -33,3 +33,13 @@ export declare const getJunoPackage: ({ moduleId, ...rest }: GetJunoPackageParam
  * @throws {ZodError} If the metadata exists but does not conform to the expected `JunoPackage` schema.
  */
 export declare const getJunoPackageVersion: (params: GetJunoPackageParams) => Promise<JunoPackage["version"] | undefined>;
+/**
+ * Retrieves the `dependencies` field from the `juno:package` metadata.
+ *
+ * @param {GetJunoPackageParams} params - The parameters to fetch the package metadata.
+ *
+ * @returns {Promise<JunoPackage['dependencies'] | undefined>} A promise that resolves to the dependencies object or `undefined` if not found.
+ *
+ * @throws {ZodError} If the metadata exists but does not conform to the expected `JunoPackage` schema.
+ */
+export declare const getJunoPackageDependencies: (params: GetJunoPackageParams) => Promise<JunoPackage["dependencies"] | undefined>;

package/dist/types/services/satellite.controllers.services.d.ts

@@ -1,4 +1,4 @@
-import { Principal } from '@dfinity/principal';
+import type { Principal } from '@dfinity/principal';
 import type { Controller, SetControllersArgs } from '../../declarations/satellite/satellite.did';
 import type { SatelliteParameters } from '../types/actor.types';
 /**

package/dist/types/services/satellite.upgrade.services.d.ts

@@ -1,5 +1,5 @@
 import type { SatelliteParameters } from '../types/actor.types';
-import { UpgradeCodeParams } from '../types/upgrade.types';
+import type { UpgradeCodeParams } from '../types/upgrade.types';
 /**
  * Upgrades a satellite with the provided WASM module.
  * @param {Object} params - The parameters for upgrading the satellite.

package/dist/types/services/satellite.version.services.d.ts

@@ -6,16 +6,7 @@ import type { BuildType } from '../types/build.types';
  * @param {SatelliteParameters} params.satellite - The satellite parameters.
  * @returns {Promise<string>} A promise that resolves to the version of the satellite.
  */
-export declare const satelliteVersion: (params: {
-    satellite: SatelliteParameters;
-}) => Promise<string>;
-/**
- * Retrieves the build version of the satellite.
- * @param {Object} params - The parameters for retrieving the build version.
- * @param {SatelliteParameters} params.satellite - The satellite parameters.
- * @returns {Promise<string>} A promise that resolves to the build version of the satellite.
- */
-export declare const satelliteBuildVersion: (params: {
+export declare const satelliteVersion: ({ satellite: { satelliteId, ...rest } }: {
     satellite: SatelliteParameters;
 }) => Promise<string>;
 /**

package/dist/types/types/upgrade.types.d.ts

@@ -1,6 +1,6 @@
 import type { canister_install_mode } from '@dfinity/ic-management';
-import { Principal } from '@dfinity/principal';
-import { ActorParameters } from './actor.types';
+import type { Principal } from '@dfinity/principal';
+import type { ActorParameters } from './actor.types';
 export declare enum UpgradeCodeProgressStep {
     AssertingExistingCode = 0,
     StoppingCanister = 1,

package/dist/types/utils/actor.utils.d.ts

@@ -1,7 +1,7 @@
 import { HttpAgent, type ActorConfig, type ActorMethod, type ActorSubclass } from '@dfinity/agent';
 import type { IDL } from '@dfinity/candid';
 import type { ActorParameters } from '../types/actor.types';
-export declare const createActor: <T = Record<string, ActorMethod<unknown[], unknown>>>({ canisterId, idlFactory, config, ...rest }: {
+export declare const createActor: <T = Record<string, ActorMethod>>({ canisterId, idlFactory, config, ...rest }: {
     idlFactory: IDL.InterfaceFactory;
     canisterId: string;
     config?: Pick<ActorConfig, "callTransform" | "queryTransform">;

package/dist/types/utils/package.utils.d.ts

@@ -0,0 +1,14 @@
+import type { JunoPackageDependencies } from '@junobuild/config';
+/**
+ * Finds a specific dependency in a `JunoPackageDependencies` map.
+ *
+ * @param {Object} params - The parameters for the search.
+ * @param {string} params.dependencyId - The ID of the dependency to look for.
+ * @param {JunoPackageDependencies | undefined} params.dependencies - The full list of dependencies, or `undefined`.
+ *
+ * @returns {[string, string] | undefined} A tuple containing the dependency ID and version if found, or `undefined` if not found or no dependencies are present.
+ */
+export declare const findJunoPackageDependency: ({ dependencyId, dependencies }: {
+    dependencyId: string;
+    dependencies: JunoPackageDependencies | undefined;
+}) => [string, string] | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junobuild/admin",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "A library for interfacing with admin features of Juno",
   "author": "David Dal Busco (https://daviddalbusco.com)",
   "license": "MIT",