@gravity-rail/cli 0.5.1 → 0.7.0

package/dist/lib.d.ts

@@ -1,7 +1,7 @@
 import { ApiClient } from '@gravity-rail/client';
 import { E as EnvironmentConfig, C as CredentialsManager } from './cli-client-context-9KRUt6O-.js';
 export { a as ConciergeAppContextPayload, b as buildCliConciergeAppContext } from './cli-client-context-9KRUt6O-.js';
-import { GravityRailClient } from '@gravity-rail/sdk';
+import { GravityRailClient, PhoneCall } from '@gravity-rail/sdk';
 
 /** Metadata extracted from a paginated API response */
 interface PaginationMeta {
@@ -132,6 +132,8 @@ declare function stderr(msg: string): void;
 interface GlobalOptions {
     env: string;
     realm?: string;
+    /** Override API base URL (also: GRAVITY_RAIL_API_URL env var). */
+    apiUrl?: string;
     outputFormat?: string;
     verbose?: boolean;
     allowWrite?: boolean;
@@ -242,9 +244,33 @@ declare class AuthRequiredError extends CLIError {
 }
 declare function handleError(err: unknown): never;
 
+/**
+ * Whether the CLI should read --data / --file / stdin for this command.
+ *
+ * CRUD create/update handlers rely on COMMON_ARGS for --data, but those flags are
+ * not listed on cmd.args — without this helper, `gr members update --data …` silently
+ * skips the body.
+ */
+declare function commandNeedsJsonBody(cmd: CommandDef, parsedArgs: ParsedArgs): boolean;
 /** Read JSON input from --data string, --file path, or stdin (if piped) */
 declare function readJsonInput(args: ParsedArgs): Promise<unknown | undefined>;
 
+/** True when the number is a provisioned test placeholder, not a real handset. */
+declare function isLikelySeedPhoneNumber(phone: string): boolean;
+/**
+ * Poll until the outbound PhoneCall for a chat reaches a terminal or connected state.
+ * Throws CLIError when Twilio reports failure (often within 1–2s).
+ */
+declare function waitForOutboundPhoneCallOutcome(client: GravityRailClient, workspaceUuid: string, chatId: number, memberId: number, options?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<PhoneCall>;
+/**
+ * Resolve the workspace PhoneNumber id to use for outbound voice.
+ * Order: explicit flag → workspace defaults → first voice-enabled line.
+ */
+declare function resolveVoicePhoneNumberId(client: GravityRailClient, workspaceUuid: string, explicitId?: number): Promise<number>;
+
 /**
  * @deprecated Use `SimpleCrudConfig` with `simpleCrudCommands()` for new code.
  *
@@ -271,6 +297,8 @@ interface CrudConfig<T = unknown> {
     extra?: CommandDef[];
     /** Example lines shown in help for the create command */
     createExamples?: string[];
+    /** Example lines shown in help for the update command */
+    updateExamples?: string[];
     /**
      * Controls how the CRUD list handler interacts with pagination.
      *
@@ -301,7 +329,7 @@ declare function crudCommands<T>(config: CrudConfig<T>): CommandDef[];
  * Typed CRUD config for simple, top-level resources.
  *
  * Unlike the stringly-typed `CrudConfig`, operations are typed functions that
- * receive the real `GravityRailClient`. TypeScript validates the call at the definition
+ * receive the real `ApiClient`. TypeScript validates the call at the definition
  * site, eliminating the string-dispatch + positional-argument blind spot.
  *
  * Use this for resources that fit the simple CRUD contract:
@@ -333,16 +361,16 @@ interface SimpleCrudConfig<T = unknown> {
     extra?: CommandDef[];
     createExamples?: string[];
     paginationSupport?: 'full' | 'client-only' | false;
-    list?: (client: GravityRailClient, workspace: string, opts?: Record<string, unknown>) => Promise<unknown>;
-    get?: (client: GravityRailClient, workspace: string, id: string) => Promise<unknown>;
-    create?: (client: GravityRailClient, workspace: string, data: unknown) => Promise<unknown>;
-    update?: (client: GravityRailClient, workspace: string, id: string, data: unknown) => Promise<unknown>;
-    delete?: (client: GravityRailClient, workspace: string, id: string) => Promise<unknown>;
-    archive?: (client: GravityRailClient, workspace: string, id: string) => Promise<unknown>;
-    unarchive?: (client: GravityRailClient, workspace: string, id: string) => Promise<unknown>;
+    list?: (client: ApiClient, workspace: string, opts?: Record<string, unknown>) => Promise<unknown>;
+    get?: (client: ApiClient, workspace: string, id: string) => Promise<unknown>;
+    create?: (client: ApiClient, workspace: string, data: unknown) => Promise<unknown>;
+    update?: (client: ApiClient, workspace: string, id: string, data: unknown) => Promise<unknown>;
+    delete?: (client: ApiClient, workspace: string, id: string) => Promise<unknown>;
+    archive?: (client: ApiClient, workspace: string, id: string) => Promise<unknown>;
+    unarchive?: (client: ApiClient, workspace: string, id: string) => Promise<unknown>;
     /** When true, adds a --cascade flag to the delete command. */
     supportsCascade?: boolean;
-    deleteFn?: (client: GravityRailClient, workspace: string, id: string, cascade: boolean) => Promise<unknown>;
+    deleteFn?: (client: ApiClient, workspace: string, id: string, cascade: boolean) => Promise<unknown>;
 }
 /**
  * Generate CRUD commands from typed callable functions.
@@ -406,6 +434,18 @@ interface ConciergeMessage {
 declare function listConciergeChats(ctx: AuthenticatedContext): Promise<ConciergeChat[]>;
 declare function createConciergeChat(ctx: AuthenticatedContext, title?: string): Promise<ConciergeChat>;
 declare function getConciergeChat(ctx: AuthenticatedContext, chatId: number): Promise<ConciergeChat>;
+interface ConciergeCallResult {
+    callSid: string;
+    startedAt: string;
+}
+interface ConciergeSmsResult {
+    messageSid: string;
+    conversationId: string;
+}
+declare function originateConciergeCall(ctx: AuthenticatedContext, kind?: string): Promise<ConciergeCallResult>;
+declare function originateConciergeSms(ctx: AuthenticatedContext, kind?: string): Promise<ConciergeSmsResult>;
+declare function startAccountPhoneVerify(ctx: AuthenticatedContext, phone: string): Promise<void>;
+declare function confirmAccountPhoneVerify(ctx: AuthenticatedContext, code: string): Promise<void>;
 declare function getConciergeChatMessages(ctx: AuthenticatedContext, chatId: number): Promise<ConciergeMessage[]>;
 
 /**
@@ -425,6 +465,7 @@ declare function authBrowserCommand(ctx: AuthenticatedContext, args: Record<stri
  * but without requiring a workspace.
  */
 
+declare function conciergeOutboundCommand(hctx: CommandHandlerContext): Promise<void>;
 declare function conciergeCommand(hctx: CommandHandlerContext): Promise<void>;
 
 /**
@@ -459,4 +500,4 @@ declare function organizationsListCommand(ctx: AuthenticatedContext): Promise<vo
 
 declare function whoamiCommand(ctx: AuthenticatedContext): Promise<void>;
 
-export { type ArgDef, AuthRequiredError, type AuthenticatedContext, CLIError, COL, type CommandContext, type CommandDef, type CommandHandlerContext, CommandRegistry, type ConciergeChat, type ConciergeMessage, type DomainDef, type GlobalOptions, LIST_PAGINATION_ARGS, type OutputFormat, type OutputOptions, PAGINATION_ARGS, type PaginationMeta, type ParsedArgs, type PublicGlobalOptions, type TableColumn, authBrowserCommand, chatCommand, conciergeCommand, createAuthenticatedContext, createConciergeChat, createContext, createPublicAuthenticatedContext, createPublicContext, crudCommands, detectOutputFormat, devImportLocalCommand, extractPaginationMeta, fetchAllCursorPages, fetchAllPages, formatPaginationWarning, getConciergeChat, getConciergeChatMessages, getStartedCommand, handleError, isCursorPaginatedResponse, isDirectoryTrusted, isListResult, isPagePaginatedResponse, isPaginatedResponse, listConciergeChats, listResult, loginCommand, logoutCommand, manageCommand, organizationsListCommand, outputData, outputSingle, parseArgs, parsePaginationArgs, readJsonInput, registerPublicDomains, requireAuth, requireDirectoryTrust, requireNumber, requireString, simpleCrudCommands, stderr, unwrapItems, whoamiCommand };
+export { type ArgDef, AuthRequiredError, type AuthenticatedContext, CLIError, COL, type CommandContext, type CommandDef, type CommandHandlerContext, CommandRegistry, type ConciergeChat, type ConciergeMessage, type DomainDef, type GlobalOptions, LIST_PAGINATION_ARGS, type OutputFormat, type OutputOptions, PAGINATION_ARGS, type PaginationMeta, type ParsedArgs, type PublicGlobalOptions, type TableColumn, authBrowserCommand, chatCommand, commandNeedsJsonBody, conciergeCommand, conciergeOutboundCommand, confirmAccountPhoneVerify, createAuthenticatedContext, createConciergeChat, createContext, createPublicAuthenticatedContext, createPublicContext, crudCommands, detectOutputFormat, devImportLocalCommand, extractPaginationMeta, fetchAllCursorPages, fetchAllPages, formatPaginationWarning, getConciergeChat, getConciergeChatMessages, getStartedCommand, handleError, isCursorPaginatedResponse, isDirectoryTrusted, isLikelySeedPhoneNumber, isListResult, isPagePaginatedResponse, isPaginatedResponse, listConciergeChats, listResult, loginCommand, logoutCommand, manageCommand, organizationsListCommand, originateConciergeCall, originateConciergeSms, outputData, outputSingle, parseArgs, parsePaginationArgs, readJsonInput, registerPublicDomains, requireAuth, requireDirectoryTrust, requireNumber, requireString, resolveVoicePhoneNumberId, simpleCrudCommands, startAccountPhoneVerify, stderr, unwrapItems, waitForOutboundPhoneCallOutcome, whoamiCommand };