@capgo/cli 8.0.0-alpha.4 → 8.0.0

package/dist/src/sdk.d.ts

@@ -1,325 +1,16 @@
 import type { Channel } from './api/channels';
-import type { DecryptResult } from './bundle/decryptV2';
-import type { EncryptResult } from './bundle/encryptV2';
-import type { UploadBundleResult } from './bundle/upload';
+import type { DecryptResult } from './bundle/decrypt';
+import type { EncryptResult } from './bundle/encrypt';
 import type { ZipResult } from './bundle/zip';
+import type { StarAllRepositoryResult } from './github';
+import type { ProbeInternalResult } from './probe';
+import type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleCompatibilityOptions, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, OrganizationInfo, ProbeOptions, RequestBuildOptions, SaveKeyOptions, SDKResult, SetSettingOptions, StarAllRepositoriesOptions, StarRepoOptions, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions } from './schemas/sdk';
 import { getInfoInternal } from './app/info';
 import { checkCompatibilityInternal } from './bundle/compatibility';
 export type DoctorInfo = Awaited<ReturnType<typeof getInfoInternal>>;
 type CompatibilityReport = Awaited<ReturnType<typeof checkCompatibilityInternal>>['finalCompatibility'];
 export type BundleCompatibilityEntry = CompatibilityReport[number];
-/** Common result wrapper for all SDK operations */
-export interface SDKResult<T = void> {
-    success: boolean;
-    data?: T;
-    error?: string;
-    warnings?: string[];
-}
-export interface AddAppOptions {
-    /** App ID (e.g., com.example.app) */
-    appId: string;
-    /** App name for display in Capgo Cloud */
-    name?: string;
-    /** App icon path for display in Capgo Cloud */
-    icon?: string;
-    /** API key for authentication */
-    apikey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-}
-export interface UpdateAppOptions {
-    /** App ID (e.g., com.example.app) */
-    appId: string;
-    /** Updated app name */
-    name?: string;
-    /** Updated app icon path */
-    icon?: string;
-    /** Days to keep old bundles (0 = infinite) */
-    retention?: number;
-    /** API key for authentication */
-    apikey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-}
-export interface AppInfo {
-    appId: string;
-    name: string;
-    iconUrl?: string;
-    createdAt: Date;
-}
-export interface UploadOptions {
-    /** App ID (e.g., com.example.app) */
-    appId: string;
-    /** Path to build folder */
-    path: string;
-    /** Bundle version */
-    bundle?: string;
-    /** Channel name */
-    channel?: string;
-    /** API key for authentication */
-    apikey?: string;
-    /** External URL instead of upload */
-    external?: string;
-    /** Enable encryption */
-    encrypt?: boolean;
-    /** Private key for encryption */
-    encryptionKey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-    /** Timeout in seconds */
-    timeout?: number;
-    /** Use TUS protocol for upload */
-    useTus?: boolean;
-    /** Comment for this version */
-    comment?: string;
-    /** Minimum update version required */
-    minUpdateVersion?: string;
-    /** Automatically set min-update-version when compatibility fails */
-    autoMinUpdateVersion?: boolean;
-    /** Allow self-assignment to channel */
-    selfAssign?: boolean;
-    /** Package.json paths for monorepos */
-    packageJsonPaths?: string;
-    /** Ignore compatibility checks */
-    ignoreCompatibilityCheck?: boolean;
-    /** Disable code check for notifyAppReady() */
-    disableCodeCheck?: boolean;
-    /** Use legacy zip upload instead of TUS */
-    useZip?: boolean;
-}
-export interface UploadResult {
-    success: boolean;
-    bundleId?: string;
-    bundleUrl?: string;
-    checksum?: string | null;
-    encryptionMethod?: UploadBundleResult['encryptionMethod'];
-    sessionKey?: string;
-    ivSessionKey?: string | null;
-    storageProvider?: string;
-    skipped?: boolean;
-    reason?: string;
-    error?: string;
-    warnings?: string[];
-}
-export interface BundleInfo {
-    id: string;
-    version: string;
-    channel?: string;
-    uploadedAt: Date;
-    size: number;
-    encrypted: boolean;
-}
-export interface CleanupOptions {
-    /** App ID */
-    appId: string;
-    /** Number of versions to keep */
-    keep?: number;
-    /** Bundle version pattern */
-    bundle?: string;
-    /** Force removal without confirmation */
-    force?: boolean;
-    /** Delete bundles even if linked to channels */
-    ignoreChannel?: boolean;
-    /** API key for authentication */
-    apikey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-}
-export interface GenerateKeyOptions {
-    /** Overwrite existing keys if they already exist */
-    force?: boolean;
-    /** Automatically configure the default encryption channel instead of prompting */
-    setupChannel?: boolean;
-}
-export interface SaveKeyOptions {
-    /** Path to the public key file (.pub) */
-    keyPath?: string;
-    /** Public key contents as string (used if keyPath not provided) */
-    keyData?: string;
-    /** Automatically configure the default encryption channel instead of prompting */
-    setupChannel?: boolean;
-}
-export interface DeleteOldKeyOptions {
-    /** Force deletion if legacy files are present */
-    force?: boolean;
-    /** Automatically configure the default encryption channel instead of prompting */
-    setupChannel?: boolean;
-}
-export interface AddChannelOptions {
-    /** Channel ID/name */
-    channelId: string;
-    /** App ID */
-    appId: string;
-    /** Set as default channel */
-    default?: boolean;
-    /** Allow device self-assignment */
-    selfAssign?: boolean;
-    /** API key for authentication */
-    apikey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-}
-export interface UpdateChannelOptions {
-    /** Channel ID/name */
-    channelId: string;
-    /** App ID */
-    appId: string;
-    /** Bundle version to link */
-    bundle?: string;
-    /** Channel state (default or normal) */
-    state?: string;
-    /** Allow downgrade */
-    downgrade?: boolean;
-    /** Enable for iOS */
-    ios?: boolean;
-    /** Enable for Android */
-    android?: boolean;
-    /** Allow device self-assignment */
-    selfAssign?: boolean;
-    /** Disable auto update strategy */
-    disableAutoUpdate?: string;
-    /** Enable for dev builds */
-    dev?: boolean;
-    /** Enable for emulators */
-    emulator?: boolean;
-    /** API key for authentication */
-    apikey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-}
-export interface AccountIdOptions {
-    /** API key for authentication */
-    apikey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-}
-export interface ListOrganizationsOptions extends AccountIdOptions {
-}
-export interface AddOrganizationOptions extends AccountIdOptions {
-    /** Organization name */
-    name: string;
-    /** Management email */
-    email: string;
-}
-export interface UpdateOrganizationOptions extends AccountIdOptions {
-    /** Organization ID */
-    orgId: string;
-    /** Updated name */
-    name?: string;
-    /** Updated management email */
-    email?: string;
-}
-export interface OrganizationInfo {
-    id: string;
-    name: string;
-    role?: string;
-    appCount?: number;
-    email?: string;
-    createdAt?: Date;
-}
-export interface DeleteOrganizationOptions extends AccountIdOptions {
-    autoConfirm?: boolean;
-}
-export interface LoginOptions {
-    apikey: string;
-    local?: boolean;
-    supaHost?: string;
-    supaAnon?: string;
-}
-export interface DoctorOptions {
-    packageJson?: string;
-}
-export interface BundleCompatibilityOptions {
-    appId: string;
-    channel: string;
-    packageJson?: string;
-    nodeModules?: string;
-    textOutput?: boolean;
-    apikey?: string;
-    supaHost?: string;
-    supaAnon?: string;
-}
-export interface EncryptBundleOptions {
-    zipPath: string;
-    checksum: string;
-    keyPath?: string;
-    keyData?: string;
-    json?: boolean;
-}
-export interface DecryptBundleOptions {
-    zipPath: string;
-    ivSessionKey: string;
-    keyPath?: string;
-    keyData?: string;
-    checksum?: string;
-}
-export interface ZipBundleOptions {
-    appId: string;
-    path: string;
-    bundle?: string;
-    name?: string;
-    codeCheck?: boolean;
-    json?: boolean;
-    keyV2?: boolean;
-    packageJson?: string;
-}
-export interface CurrentBundleOptions extends AccountIdOptions {
-}
-export interface SetSettingOptions {
-    apikey?: string;
-    bool?: string;
-    string?: string;
-}
-export interface StatsOrder {
-    key: string;
-    sortable?: 'asc' | 'desc';
-}
-export interface GetStatsOptions {
-    /** App ID */
-    appId: string;
-    /** Filter by specific device IDs */
-    deviceIds?: string[];
-    /** Search query */
-    search?: string;
-    /** Sort order */
-    order?: StatsOrder[];
-    /** Start date/time for range filter (ISO string) */
-    rangeStart?: string;
-    /** End date/time for range filter (ISO string) */
-    rangeEnd?: string;
-    /** Limit number of results */
-    limit?: number;
-    /** Get only stats after this timestamp (for polling) */
-    after?: string | null;
-    /** API key for authentication */
-    apikey?: string;
-    /** Custom Supabase host */
-    supaHost?: string;
-    /** Custom Supabase anon key */
-    supaAnon?: string;
-}
-export interface DeviceStats {
-    appId: string;
-    deviceId: string;
-    action: string;
-    versionId: number;
-    version?: number;
-    createdAt: string;
-}
+export type { UpdateProbeResult } from './app/updateProbe';
 /**
  * Capgo SDK for programmatic access to all CLI functionality.
  * Use this class to integrate Capgo operations directly into your application.
@@ -418,6 +109,35 @@ export declare class CapgoSDK {
      * Retrieve the account ID associated with the configured API key
      */
     getAccountId(options?: AccountIdOptions): Promise<SDKResult<string>>;
+    /**
+     * Star the Capgo repository on GitHub
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.starRepo({ repository: 'Cap-go/capacitor-updater' })
+     * if (result.success) {
+     *   console.log(`${result.data?.repository} starred`)
+     * }
+     * ```
+     */
+    starRepo(options?: StarRepoOptions): Promise<SDKResult<{
+        repository: string;
+        alreadyStarred: boolean;
+    }>>;
+    /**
+     * Star the Capgo-related repositories on GitHub
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.starAllRepositories()
+     * if (result.success) {
+     *   for (const entry of result.data ?? []) {
+     *     console.log(entry.repository, entry.status)
+     *   }
+     * }
+     * ```
+     */
+    starAllRepositories(options?: StarAllRepositoriesOptions): Promise<SDKResult<StarAllRepositoryResult[]>>;
     checkBundleCompatibility(options: BundleCompatibilityOptions): Promise<SDKResult<BundleCompatibilityEntry[]>>;
     encryptBundle(options: EncryptBundleOptions): Promise<SDKResult<EncryptResult>>;
     decryptBundle(options: DecryptBundleOptions): Promise<SDKResult<DecryptResult>>;
@@ -478,6 +198,42 @@ export declare class CapgoSDK {
         removed: number;
         kept: number;
     }>>;
+    /**
+     * Request a native build for your app with store publishing
+     *
+     * SECURITY GUARANTEE:
+     * Credentials provided to this method are NEVER stored on Capgo servers.
+     * They are used only during the build process and automatically deleted
+     * after completion (maximum 24 hours retention). Build outputs may optionally
+     * be uploaded for time-limited download links.
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.requestBuild({
+     *   appId: 'com.example.app',
+     *   path: './my-project',
+     *   lane: 'ios', // Must be exactly "ios" or "android"
+     *   credentials: {
+     *     BUILD_CERTIFICATE_BASE64: 'base64-cert...',
+     *     CAPGO_IOS_PROVISIONING_MAP: '{"com.example.app":{"profile":"base64...","name":"match AppStore com.example.app"}}',
+     *     P12_PASSWORD: 'cert-password',
+     *     APPLE_KEY_ID: 'KEY123',
+     *     APPLE_ISSUER_ID: 'issuer-uuid',
+     *     APPLE_KEY_CONTENT: 'base64-p8...',
+     *     APP_STORE_CONNECT_TEAM_ID: 'team-id'
+     *   }
+     * })
+     *
+     * if (result.success) {
+     *   console.log('Job ID:', result.data.jobId)
+     * }
+     * ```
+     */
+    requestBuild(options: RequestBuildOptions): Promise<SDKResult<{
+        jobId: string;
+        uploadUrl: string;
+        status: string;
+    }>>;
     getCurrentBundle(appId: string, channelId: string, options?: CurrentBundleOptions): Promise<SDKResult<string>>;
     /**
      * Create a new channel for app distribution
@@ -593,6 +349,7 @@ export declare class CapgoSDK {
      */
     getStats(options: GetStatsOptions): Promise<SDKResult<DeviceStats[]>>;
     setAppSetting(path: string, options: SetSettingOptions): Promise<SDKResult>;
+    probe(options: ProbeOptions): Promise<SDKResult<ProbeInternalResult>>;
 }
 /**
  * Upload a bundle to Capgo Cloud (functional API)
@@ -614,6 +371,11 @@ export declare function checkBundleCompatibility(options: BundleCompatibilityOpt
 export declare function encryptBundle(options: EncryptBundleOptions): Promise<SDKResult<EncryptResult>>;
 export declare function decryptBundle(options: DecryptBundleOptions): Promise<SDKResult<DecryptResult>>;
 export declare function zipBundle(options: ZipBundleOptions): Promise<SDKResult<ZipResult>>;
+export declare function starRepo(options?: StarRepoOptions): Promise<SDKResult<{
+    repository: string;
+    alreadyStarred: boolean;
+}>>;
+export declare function starAllRepositories(options?: StarAllRepositoriesOptions): Promise<SDKResult<StarAllRepositoryResult[]>>;
 export declare function generateEncryptionKeys(options?: GenerateKeyOptions): Promise<SDKResult>;
 export declare function saveEncryptionKey(options?: SaveKeyOptions): Promise<SDKResult>;
 export declare function deleteLegacyEncryptionKey(options?: DeleteOldKeyOptions): Promise<SDKResult<{
@@ -667,6 +429,50 @@ export declare function listBundles(appId: string, options?: {
  * ```
  */
 export declare function addChannel(options: AddChannelOptions): Promise<SDKResult>;
+/**
+ * Request a native build for your app (functional API)
+ *
+ * SECURITY GUARANTEE:
+ * Credentials are NEVER stored on Capgo servers. They are used only during
+ * the build process and automatically deleted after completion.
+ * Build outputs may optionally be uploaded for time-limited download links.
+ *
+ * @example
+ * ```typescript
+ * const result = await requestBuild({
+ *   appId: 'com.example.app',
+ *   path: './my-project',
+ *   lane: 'ios', // Must be exactly "ios" or "android"
+ *   credentials: {
+ *     // iOS credentials (use standard environment variable names)
+ *     BUILD_CERTIFICATE_BASE64: 'base64-encoded-cert',
+ *     BUILD_PROVISION_PROFILE_BASE64: 'base64-encoded-profile',
+ *     P12_PASSWORD: 'cert-password',
+ *     APPLE_KEY_ID: 'KEY123',
+ *     APPLE_ISSUER_ID: 'issuer-uuid',
+ *     APPLE_KEY_CONTENT: 'base64-encoded-p8',
+ *     APP_STORE_CONNECT_TEAM_ID: 'team-id',
+ *     // Android credentials (use standard environment variable names)
+ *     ANDROID_KEYSTORE_FILE: 'base64-encoded-keystore',
+ *     KEYSTORE_KEY_ALIAS: 'my-key-alias',
+ *     KEYSTORE_KEY_PASSWORD: 'key-password',
+ *     KEYSTORE_STORE_PASSWORD: 'store-password',
+ *     PLAY_CONFIG_JSON: 'base64-encoded-service-account-json'
+ *   },
+ *   apikey: 'your-api-key'
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Job ID:', result.data.jobId)
+ *   console.log('Status:', result.data.status)
+ * }
+ * ```
+ */
+export declare function requestBuild(options: RequestBuildOptions): Promise<SDKResult<{
+    jobId: string;
+    uploadUrl: string;
+    status: string;
+}>>;
 /**
  * Get device statistics/logs from Capgo backend (functional API)
  *
@@ -690,6 +496,7 @@ export declare function addChannel(options: AddChannelOptions): Promise<SDKResul
  * ```
  */
 export declare function getStats(options: GetStatsOptions): Promise<SDKResult<DeviceStats[]>>;
+export declare function probeUpdates(options: ProbeOptions): Promise<SDKResult<ProbeInternalResult>>;
 /**
  * Get Capacitor configuration
  *
@@ -701,8 +508,22 @@ export declare function getStats(options: GetStatsOptions): Promise<SDKResult<De
  * }
  * ```
  */
-export declare function getCapacitorConfig(): Promise<import("./config").ExtConfigPairs | null>;
+export declare function getCapacitorConfig(): Promise<{
+    config: {
+        [x: string]: unknown;
+        appId: string;
+        appName: string;
+        webDir: string;
+        plugins?: Record<string, any> | undefined;
+        android?: Record<string, any> | undefined;
+    };
+    path: string;
+} | null>;
+export type { BuildCredentials } from './build/request';
 export type { CapacitorConfig } from './config';
+export type { ProbeInternalResult } from './probe';
+export type { AccountIdOptions, AddAppOptions, AddChannelOptions, AddOrganizationOptions, AppInfo, BundleCompatibilityOptions, BundleInfo, CleanupOptions, CurrentBundleOptions, DecryptBundleOptions, DeleteOldKeyOptions, DeleteOrganizationOptions, DeviceStats, DoctorOptions, EncryptBundleOptions, GenerateKeyOptions, GetStatsOptions, ListOrganizationsOptions, LoginOptions, OrganizationInfo, ProbeOptions, RequestBuildOptions, SaveKeyOptions, SDKResult, SetSettingOptions, StarAllRepositoriesOptions, StarRepoOptions, StatsOrder, UpdateAppOptions, UpdateChannelOptions, UpdateOrganizationOptions, UploadOptions, UploadResult, ZipBundleOptions, } from './schemas/sdk';
 export type { Database } from './types/supabase.types';
 export { createSupabaseClient } from './utils';
-//# sourceMappingURL=sdk.d.ts.map
+export { formatApiErrorForCli, getSecurityPolicyMessage, isSecurityPolicyError, parseSecurityPolicyError, SECURITY_POLICY_ERRORS, SECURITY_POLICY_MESSAGES, } from './utils/security_policy_errors';
+export type { ParsedSecurityError, SecurityPolicyErrorCode } from './utils/security_policy_errors';