@kadi.build/deploy-ability 0.0.1

package/dist/types/profiles.js

@@ -0,0 +1,27 @@
+/**
+ * Profile type definitions from agent.json
+ *
+ * These types represent the structure of deployment profiles
+ * as defined in an agent's agent.json configuration file.
+ *
+ * @module types/profiles
+ */
+/**
+ * Type guard to check if profile is for local deployment
+ *
+ * @param profile - The profile to check
+ * @returns True if profile targets local deployment
+ */
+export function isLocalProfile(profile) {
+    return profile.target === 'local';
+}
+/**
+ * Type guard to check if profile is for Akash deployment
+ *
+ * @param profile - The profile to check
+ * @returns True if profile targets Akash deployment
+ */
+export function isAkashProfile(profile) {
+    return profile.target === 'akash';
+}
+//# sourceMappingURL=profiles.js.map

package/dist/types/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/types/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6WH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA0B;IAE1B,OAAO,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA0B;IAE1B,OAAO,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC;AACpC,CAAC"}

package/dist/types/results.d.ts

@@ -0,0 +1,443 @@
+/**
+ * Result type definitions for deployment operations
+ *
+ * This module uses discriminated unions for type-safe error handling.
+ * All deployment operations return Result types that explicitly represent
+ * success or failure states.
+ *
+ * @module types/results
+ */
+import type { DeploymentSequence, WalletAddress, ProviderUri, Network, ContainerEngine } from './common.js';
+/**
+ * Success result wrapper
+ *
+ * Represents a successful operation with data
+ *
+ * @template TData - The type of the success data
+ */
+export interface Success<TData> {
+    readonly success: true;
+    readonly data: TData;
+}
+/**
+ * Failure result wrapper
+ *
+ * Represents a failed operation with error information
+ *
+ * @template TError - The type of the error
+ */
+export interface Failure<TError> {
+    readonly success: false;
+    readonly error: TError;
+}
+/**
+ * Result type combining success and failure
+ *
+ * A discriminated union that forces explicit error handling
+ *
+ * @template TData - The type of success data
+ * @template TError - The type of error (defaults to Error)
+ *
+ * @example
+ * const result: Result<number> = await someOperation();
+ * if (result.success) {
+ *   console.log(result.data); // TypeScript knows this is number
+ * } else {
+ *   console.error(result.error); // TypeScript knows this is Error
+ * }
+ */
+export type Result<TData, TError = Error> = Success<TData> | Failure<TError>;
+/**
+ * Akash deployment result data
+ *
+ * Contains all information about a successful Akash deployment
+ */
+export interface AkashDeploymentData {
+    /**
+     * Deployment sequence number (unique ID)
+     */
+    readonly dseq: DeploymentSequence;
+    /**
+     * Wallet address that owns the deployment
+     */
+    readonly owner: WalletAddress;
+    /**
+     * Provider that accepted the lease
+     */
+    readonly provider: WalletAddress;
+    /**
+     * Provider's API endpoint
+     */
+    readonly providerUri: ProviderUri;
+    /**
+     * Group sequence number
+     */
+    readonly gseq: number;
+    /**
+     * Order sequence number
+     */
+    readonly oseq: number;
+    /**
+     * Network where deployment was created
+     */
+    readonly network: Network;
+    /**
+     * Service endpoints (if exposed globally)
+     * Maps service name to its public URL
+     *
+     * @example
+     * {
+     *   "api": "https://provider.akash.network:12345",
+     *   "web": "https://provider.akash.network:12346"
+     * }
+     */
+    readonly endpoints?: Readonly<Record<string, string>>;
+    /**
+     * TLS certificate used for provider communication
+     * Only included if certificate was generated during deployment
+     */
+    readonly certificate?: {
+        readonly cert: string;
+        readonly privateKey: string;
+    };
+    /**
+     * Profile name that was deployed
+     */
+    readonly profile: string;
+    /**
+     * Timestamp when deployment was created
+     */
+    readonly deployedAt: Date;
+    /**
+     * Deployment status on blockchain
+     *
+     * - `active`: Deployment is running
+     * - `closed`: Deployment has been terminated
+     */
+    readonly status: 'active' | 'closed';
+    /**
+     * Lease pricing information
+     *
+     * Complete pricing breakdown including per-block, per-hour, and per-month costs
+     * in uAKT and AKT. Includes method to convert to USD when AKT market price is provided.
+     *
+     * @example Display pricing in uAKT
+     * ```typescript
+     * const { leasePrice } = deploymentData;
+     * console.log(`${leasePrice.uakt.perMonth} uAKT/month`);
+     * console.log(`${leasePrice.akt.perMonth} AKT/month`);
+     * ```
+     *
+     * @example Convert to USD
+     * ```typescript
+     * const aktPrice = 0.50; // $0.50 per AKT from CoinGecko
+     * const usd = leasePrice.toUSD(aktPrice);
+     * console.log(`$${usd.perMonth.toFixed(2)}/month`);
+     * ```
+     *
+     * @see LeasePrice for detailed documentation
+     */
+    readonly leasePrice: import('../targets/akash/pricing.js').LeasePrice;
+    /**
+     * When the lease was created (blockchain timestamp)
+     *
+     * This is a string representation of the block height or timestamp
+     * when the lease was established on-chain.
+     */
+    readonly leaseCreatedAt: string;
+    /**
+     * Services deployed with their resource allocations
+     *
+     * Provides both aggregated totals and detailed resource specifications.
+     * Each service may have multiple resource specs (e.g., different replica configurations),
+     * and this field provides both summary totals and granular details.
+     *
+     * **totalResources**: Aggregated sum of all resource specs (count × resources)
+     * **replicaCount**: Total number of replicas across all specs
+     * **resourceSpecs**: Detailed breakdown of each resource specification with replica counts
+     *
+     * @example Simple usage - Display totals
+     * ```typescript
+     * deploymentData.services?.forEach(service => {
+     *   console.log(`Service: ${service.name}`);
+     *   console.log(`  Total CPU: ${service.totalResources.cpu}`);
+     *   console.log(`  Total Memory: ${service.totalResources.memory}`);
+     *   console.log(`  Total Replicas: ${service.replicaCount}`);
+     * });
+     * ```
+     *
+     * @example Advanced usage - Show detailed specs
+     * ```typescript
+     * deploymentData.services?.forEach(service => {
+     *   console.log(`Service: ${service.name} (${service.replicaCount} replicas)`);
+     *   service.resourceSpecs.forEach((spec, i) => {
+     *     console.log(`  Spec ${i + 1}: ${spec.count}× ${spec.cpu} CPU, ${spec.memory} RAM`);
+     *   });
+     * });
+     * ```
+     *
+     * @example Real-world scenario
+     * ```typescript
+     * // Service with mixed replica configurations:
+     * {
+     *   name: "web",
+     *   totalResources: { cpu: "5.0", memory: "10Gi", storage: "5Gi" },
+     *   replicaCount: 4,
+     *   resourceSpecs: [
+     *     { count: 3, cpu: "1.0", memory: "2Gi", storage: "1Gi" },  // 3 standard replicas
+     *     { count: 1, cpu: "2.0", memory: "4Gi", storage: "2Gi" }   // 1 high-performance replica
+     *   ]
+     * }
+     * ```
+     */
+    readonly services?: ReadonlyArray<{
+        /** Service name from SDL */
+        readonly name: string;
+        /**
+         * Aggregated total resources across all replicas
+         *
+         * This is the sum of (count × resources) for all resource specs.
+         * Use this for displaying overall capacity or cost estimation.
+         */
+        readonly totalResources: {
+            /** Total CPU allocation (e.g., "5.0" = 5 CPU cores total) */
+            readonly cpu: string;
+            /** Total memory allocation (e.g., "10Gi" = 10 GiB total) */
+            readonly memory: string;
+            /** Total storage allocation (e.g., "5Gi" = 5 GiB total) */
+            readonly storage: string;
+        };
+        /**
+         * Total number of replicas across all resource specs
+         *
+         * Sum of all `count` fields in resourceSpecs.
+         */
+        readonly replicaCount: number;
+        /**
+         * Detailed resource specifications with replica counts
+         *
+         * Each spec represents a distinct resource configuration and the number
+         * of replicas (count) using that configuration. Most services have only
+         * one spec, but advanced deployments may have multiple.
+         */
+        readonly resourceSpecs: ReadonlyArray<{
+            /** Number of replicas with this resource configuration */
+            readonly count: number;
+            /** CPU per replica (e.g., "1.0", "0.5") */
+            readonly cpu: string;
+            /** Memory per replica (e.g., "2Gi", "512Mi") */
+            readonly memory: string;
+            /** Storage per replica (e.g., "1Gi", "10Gi") */
+            readonly storage: string;
+        }>;
+    }>;
+}
+/**
+ * Akash dry-run result data
+ *
+ * Contains preview information without actually deploying
+ */
+export interface AkashDryRunData {
+    /**
+     * Indicates this was a dry run
+     */
+    readonly dryRun: true;
+    /**
+     * Generated SDL (Stack Definition Language) content
+     */
+    readonly sdl: string;
+    /**
+     * Estimated cost per block in uAKT
+     */
+    readonly estimatedCost?: number;
+    /**
+     * Profile name that would be deployed
+     */
+    readonly profile: string;
+    /**
+     * Network that would be targeted
+     */
+    readonly network: Network;
+}
+/**
+ * Result of Akash Network deployment
+ *
+ * Either deployment data or dry-run data depending on options
+ */
+export type AkashDeploymentResult = Result<AkashDeploymentData> | Result<AkashDryRunData>;
+/**
+ * Local deployment result data
+ *
+ * Contains information about a successful local deployment
+ */
+export interface LocalDeploymentData {
+    /**
+     * Profile name that was deployed
+     */
+    readonly profile: string;
+    /**
+     * Container engine used
+     */
+    readonly engine: ContainerEngine;
+    /**
+     * Docker network name
+     */
+    readonly network: string;
+    /**
+     * Service names that were deployed
+     */
+    readonly services: readonly string[];
+    /**
+     * Container IDs mapped by service name
+     */
+    readonly containers: Readonly<Record<string, string>>;
+    /**
+     * Service endpoints (local URLs)
+     * Maps service name to localhost:port
+     *
+     * @example
+     * {
+     *   "api": "http://localhost:8080",
+     *   "web": "http://localhost:3000"
+     * }
+     */
+    readonly endpoints: Readonly<Record<string, string>>;
+    /**
+     * Path to generated docker-compose.yml
+     */
+    readonly composePath: string;
+    /**
+     * Timestamp when deployment was created
+     */
+    readonly deployedAt: Date;
+}
+/**
+ * Local dry-run result data
+ */
+export interface LocalDryRunData {
+    /**
+     * Indicates this was a dry run
+     */
+    readonly dryRun: true;
+    /**
+     * Generated docker-compose.yml content
+     */
+    readonly composeFile: string;
+    /**
+     * Profile name that would be deployed
+     */
+    readonly profile: string;
+    /**
+     * Container engine that would be used
+     */
+    readonly engine: ContainerEngine;
+    /**
+     * Services that would be deployed
+     */
+    readonly services: readonly string[];
+}
+/**
+ * Result of local deployment
+ */
+export type LocalDeploymentResult = Result<LocalDeploymentData> | Result<LocalDryRunData>;
+/**
+ * Wallet connection result data
+ */
+export interface WalletConnectionData {
+    /**
+     * Connected wallet address
+     */
+    readonly address: WalletAddress;
+    /**
+     * Wallet type that was used
+     */
+    readonly walletType: 'keplr' | 'walletconnect';
+    /**
+     * Account balance in uAKT
+     */
+    readonly balance?: number;
+    /**
+     * Network the wallet is connected to
+     */
+    readonly network: Network;
+}
+/**
+ * Result of wallet connection attempt
+ */
+export type WalletConnectionResult = Result<WalletConnectionData>;
+/**
+ * Certificate data
+ */
+export interface CertificateData {
+    /**
+     * PEM-encoded certificate
+     */
+    readonly cert: string;
+    /**
+     * PEM-encoded private key
+     */
+    readonly privateKey: string;
+    /**
+     * Certificate serial number
+     */
+    readonly serial: string;
+    /**
+     * Whether this certificate was newly created
+     */
+    readonly isNew: boolean;
+    /**
+     * Path where certificate was saved
+     */
+    readonly path?: string;
+}
+/**
+ * Result of certificate operation
+ */
+export type CertificateResult = Result<CertificateData>;
+/**
+ * Helper function to create a success result
+ *
+ * @template TData - Type of success data
+ * @param data - The success data
+ * @returns Success result
+ *
+ * @example
+ * return success({ dseq: 12345, provider: 'akash1...' });
+ */
+export declare function success<TData>(data: TData): Success<TData>;
+/**
+ * Helper function to create a failure result
+ *
+ * @template TError - Type of error
+ * @param error - The error
+ * @returns Failure result
+ *
+ * @example
+ * return failure(new DeploymentError('Failed to connect', 'CONN_001'));
+ */
+export declare function failure<TError = Error>(error: TError): Failure<TError>;
+/**
+ * Type guard to check if result is successful
+ *
+ * @param result - The result to check
+ * @returns True if result is successful
+ *
+ * @example
+ * if (isSuccess(result)) {
+ *   console.log(result.data); // TypeScript knows this exists
+ * }
+ */
+export declare function isSuccess<TData, TError>(result: Result<TData, TError>): result is Success<TData>;
+/**
+ * Type guard to check if result is a failure
+ *
+ * @param result - The result to check
+ * @returns True if result is a failure
+ *
+ * @example
+ * if (isFailure(result)) {
+ *   console.error(result.error); // TypeScript knows this exists
+ * }
+ */
+export declare function isFailure<TData, TError>(result: Result<TData, TError>): result is Failure<TError>;
+//# sourceMappingURL=results.d.ts.map

package/dist/types/results.d.ts.map

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

package/dist/types/results.js

@@ -0,0 +1,64 @@
+/**
+ * Result type definitions for deployment operations
+ *
+ * This module uses discriminated unions for type-safe error handling.
+ * All deployment operations return Result types that explicitly represent
+ * success or failure states.
+ *
+ * @module types/results
+ */
+/**
+ * Helper function to create a success result
+ *
+ * @template TData - Type of success data
+ * @param data - The success data
+ * @returns Success result
+ *
+ * @example
+ * return success({ dseq: 12345, provider: 'akash1...' });
+ */
+export function success(data) {
+    return { success: true, data };
+}
+/**
+ * Helper function to create a failure result
+ *
+ * @template TError - Type of error
+ * @param error - The error
+ * @returns Failure result
+ *
+ * @example
+ * return failure(new DeploymentError('Failed to connect', 'CONN_001'));
+ */
+export function failure(error) {
+    return { success: false, error };
+}
+/**
+ * Type guard to check if result is successful
+ *
+ * @param result - The result to check
+ * @returns True if result is successful
+ *
+ * @example
+ * if (isSuccess(result)) {
+ *   console.log(result.data); // TypeScript knows this exists
+ * }
+ */
+export function isSuccess(result) {
+    return result.success === true;
+}
+/**
+ * Type guard to check if result is a failure
+ *
+ * @param result - The result to check
+ * @returns True if result is a failure
+ *
+ * @example
+ * if (isFailure(result)) {
+ *   console.error(result.error); // TypeScript knows this exists
+ * }
+ */
+export function isFailure(result) {
+    return result.success === false;
+}
+//# sourceMappingURL=results.js.map

package/dist/types/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/types/results.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAocH;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAQ,IAAW;IACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAiB,KAAa;IACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,MAA6B;IAE7B,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,MAA6B;IAE7B,OAAO,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC;AAClC,CAAC"}

package/dist/types/validators.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Type Validators and Constructors for Branded Types
+ *
+ * This module provides runtime validation and safe constructors for branded types
+ * using Zod. Instead of blind type assertions (as SomeType), these schemas validate
+ * input and provide compile-time guarantees.
+ *
+ * **Philosophy:**
+ * - Branded types provide documentation and prevent mixing incompatible values
+ * - Zod schemas enforce the brand contract at runtime
+ * - Single point of validation - once created, branded values are trusted
+ *
+ * **Why Zod:**
+ * - Composable, reusable schemas
+ * - Excellent error messages
+ * - Type inference works perfectly with branded types
+ * - Industry standard (Vercel, tRPC, Remix, etc.)
+ *
+ * @module types/validators
+ */
+import { z } from 'zod';
+import type { WalletAddress, DeploymentSequence } from './common.js';
+export declare const WalletAddressSchema: z.ZodString;
+/**
+ * Validates and creates a WalletAddress branded type
+ *
+ * Throws ZodError if validation fails with detailed error messages.
+ *
+ * @param address - String to validate as wallet address
+ * @returns Branded WalletAddress
+ * @throws {ZodError} If address format is invalid
+ *
+ * @example
+ * ```typescript
+ * const addr = createWalletAddress('akash1...');
+ * ```
+ */
+export declare function createWalletAddress(address: string): WalletAddress;
+/**
+ * Type guard to check if a string is a valid wallet address
+ *
+ * @param address - String to check
+ * @returns true if address is valid
+ *
+ * @example
+ * ```typescript
+ * if (isWalletAddress(address)) {
+ *   // TypeScript knows address is WalletAddress
+ * }
+ * ```
+ */
+export declare function isWalletAddress(address: string): address is WalletAddress;
+/**
+ * Safely converts unknown value to WalletAddress
+ *
+ * Returns undefined instead of throwing if validation fails.
+ * Useful for optional fields or untrusted input.
+ *
+ * @param value - Value to convert
+ * @returns WalletAddress if valid, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const addr = toWalletAddress(untrustedInput);
+ * if (addr) {
+ *   // Use validated address
+ * }
+ * ```
+ */
+export declare function toWalletAddress(value: unknown): WalletAddress | undefined;
+export declare const DeploymentSequenceSchema: z.ZodNumber;
+/**
+ * Validates and creates a DeploymentSequence branded type
+ *
+ * Throws ZodError if validation fails.
+ *
+ * @param dseq - Number to validate as deployment sequence
+ * @returns Branded DeploymentSequence
+ * @throws {ZodError} If dseq is invalid
+ *
+ * @example
+ * ```typescript
+ * const dseq = createDeploymentSequence(12345);
+ * ```
+ */
+export declare function createDeploymentSequence(dseq: number): DeploymentSequence;
+/**
+ * Type guard to check if a number is a valid deployment sequence
+ *
+ * @param dseq - Number to check
+ * @returns true if dseq is valid
+ *
+ * @example
+ * ```typescript
+ * if (isDeploymentSequence(dseq)) {
+ *   // TypeScript knows dseq is DeploymentSequence
+ * }
+ * ```
+ */
+export declare function isDeploymentSequence(dseq: number): dseq is DeploymentSequence;
+/**
+ * Safely converts unknown value to DeploymentSequence
+ *
+ * Returns undefined instead of throwing if validation fails.
+ *
+ * @param value - Value to convert
+ * @returns DeploymentSequence if valid, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const dseq = toDeploymentSequence(untrustedInput);
+ * if (dseq) {
+ *   // Use validated dseq
+ * }
+ * ```
+ */
+export declare function toDeploymentSequence(value: unknown): DeploymentSequence | undefined;
+//# sourceMappingURL=validators.d.ts.map

package/dist/types/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/types/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAyCrE,eAAO,MAAM,mBAAmB,aAA8B,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAGlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,aAAa,CAEzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAGzE;AAmCD,eAAO,MAAM,wBAAwB,aAAmC,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAGzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,kBAAkB,CAE7E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAGnF"}