@capgo/cli 8.0.0-alpha.5 → 8.0.0

package/dist/src/updaterConfig.d.ts

@@ -0,0 +1,8 @@
+type AutoUpdatePolicy = boolean | 'off' | 'atBackground' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload';
+type DirectUpdatePolicy = boolean | 'atInstall' | 'always' | 'onLaunch';
+export interface CapacitorUpdaterPluginConfig {
+    autoUpdate?: AutoUpdatePolicy;
+    directUpdate?: DirectUpdatePolicy;
+}
+export declare function usesAlwaysDirectUpdate(config: CapacitorUpdaterPluginConfig | undefined): boolean;
+export {};

package/dist/src/user/account.d.ts

@@ -1,4 +1,3 @@
 import type { Options } from '../api/app';
 export declare function getUserIdInternal(options: Options, silent?: boolean): Promise<string>;
 export declare function getUserId(options: Options): Promise<void>;
-//# sourceMappingURL=account.d.ts.map

package/dist/src/utils/latest-version.d.ts

@@ -4,4 +4,3 @@
  * @returns The latest version string, or null if not found
  */
 export declare function getLatestVersion(packageName: string): Promise<string | null>;
-//# sourceMappingURL=latest-version.d.ts.map

package/dist/src/utils/safeWrites.d.ts

@@ -0,0 +1,21 @@
+interface WriteOptions {
+    mode?: number;
+    encoding?: BufferEncoding;
+}
+/**
+ * Create (or reuse) a directory and enforce safe permissions.
+ */
+export declare function ensureSecureDirectory(path: string, mode: number): Promise<void>;
+/**
+ * Append content to a file without following symbolic links.
+ */
+export declare function appendToSafeFile(filePath: string, content: string, mode?: number): Promise<void>;
+/**
+ * Write content atomically by writing a temp file and renaming.
+ */
+export declare function writeFileAtomic(filePath: string, content: string, options?: WriteOptions): Promise<void>;
+/**
+ * Read file content while rejecting symbolic-link targets.
+ */
+export declare function readSafeFile(filePath: string): Promise<string>;
+export {};

package/dist/src/utils/security_policy_errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Security Policy Error Handling for CLI, SDK, and MCP
+ *
+ * This module provides utilities for parsing and displaying security policy errors
+ * returned from the Capgo API. It transforms error codes into human-readable messages.
+ *
+ * Note: These are the error codes actually returned by the backend API.
+ * Other security policies (2FA, password policy, hashed API keys) are enforced
+ * via RLS which returns generic permission denied errors.
+ */
+export declare const SECURITY_POLICY_ERRORS: {
+    readonly ORG_REQUIRES_EXPIRING_KEY: "org_requires_expiring_key";
+    readonly EXPIRATION_REQUIRED: "expiration_required";
+    readonly EXPIRATION_EXCEEDS_MAX: "expiration_exceeds_max";
+};
+export type SecurityPolicyErrorCode = typeof SECURITY_POLICY_ERRORS[keyof typeof SECURITY_POLICY_ERRORS];
+export declare const SECURITY_POLICY_MESSAGES: Record<string, string>;
+export type { ParsedSecurityError } from '../schemas/common';
+type ParsedSecurityError = import('../schemas/common').ParsedSecurityError;
+/**
+ * Check if an error code is a security policy error.
+ */
+export declare function isSecurityPolicyError(errorCode: string): boolean;
+/**
+ * Parse an error response and return formatted security policy information.
+ *
+ * @param error - The error object or error message from the API
+ * @returns ParsedSecurityError with formatted message and metadata
+ */
+export declare function parseSecurityPolicyError(error: unknown): ParsedSecurityError;
+/**
+ * Get a human-readable message for a security policy error code.
+ * Returns the original message if not a security policy error.
+ *
+ * @param errorCode - The error code from the API
+ * @param defaultMessage - The default message to use if not a security policy error
+ * @returns Human-readable error message
+ */
+export declare function getSecurityPolicyMessage(errorCode: string, defaultMessage?: string): string;
+/**
+ * Format an API error for CLI display with security policy awareness.
+ * This should be used when displaying errors to users in the CLI.
+ *
+ * @param error - The error object from the API
+ * @returns Formatted error string for CLI display
+ */
+export declare function formatApiErrorForCli(error: unknown): string;