@gravity-rail/cli 0.8.0 → 0.11.0

package/dist/lib.d.ts

@@ -1,6 +1,6 @@
 import { GravityRailClient, PhoneCall } from '@gravity-rail/sdk';
-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 { E as EnvironmentConfig, C as CredentialsManager, a as CLICredentials } from './cli-client-context-C5l8lg7h.js';
+export { b as ConciergeAppContextPayload, c as buildCliConciergeAppContext } from './cli-client-context-C5l8lg7h.js';
 
 /** Metadata extracted from a paginated API response */
 interface PaginationMeta {
@@ -114,7 +114,12 @@ declare function detectOutputFormat(explicit?: string): OutputFormat;
 declare function outputData(data: unknown, opts: OutputOptions, columns?: TableColumn<any>[], paginationMeta?: PaginationMeta, supportsAll?: boolean): void;
 /** Write a single object to stdout in the requested format */
 declare function outputSingle<T>(data: T, opts: OutputOptions, columns?: TableColumn<T>[]): void;
-/** Common column factory helpers for domain files */
+/** Common column factory helpers for domain files.
+ *
+ * GR app-facing API wire is camelCase. First-party consumers (CLI, lambdas we
+ * own) read that shape only — no snake_case dual-read "bandaid". When the API
+ * flips a key, convert the consumer; do not carry both. (#19305)
+ */
 declare const COL: {
     id: () => TableColumn<any>;
     uuid: () => TableColumn<any>;
@@ -130,12 +135,13 @@ 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;
+    /** Named credential profile (`--profile` / GRAVITY_RAIL_PROFILE). */
+    profile?: string;
 }
 interface PublicGlobalOptions {
     env?: string;
@@ -144,6 +150,8 @@ interface PublicGlobalOptions {
     outputFormat?: string;
     verbose?: boolean;
     allowWrite?: boolean;
+    /** Named credential profile (`--profile` / GRAVITY_RAIL_PROFILE). */
+    profile?: string;
 }
 interface CommandContext {
     env: string;
@@ -152,15 +160,24 @@ interface CommandContext {
     verbose: boolean;
     allowWrite: boolean;
     credentialsManager: CredentialsManager;
+    /** Resolved credential profile for this invocation. */
+    profile: string;
 }
 interface AuthenticatedContext extends CommandContext {
     accessToken: string;
     apiClient: GravityRailClient;
-    realmWorkspace?: string;
+    /** Default workspace UUID from the profile (dev workspace/member profiles). */
+    profileWorkspace?: string;
 }
 /** Create a base command context (no auth required) */
 declare function createContext(opts: GlobalOptions): CommandContext;
-/** Create an authenticated command context. Tries realm, env var, then cached token. Never auto-triggers OAuth. */
+/**
+ * Create an authenticated command context.
+ * Order: GRAVITY_RAIL_API_KEY → named/current profile store. Never auto-triggers OAuth.
+ *
+ * Dev accounts that used to be selected with `--realm` are now named profiles
+ * (import with `gr auth import-dev` after provisioning).
+ */
 declare function createAuthenticatedContext(opts: GlobalOptions): Promise<AuthenticatedContext>;
 /**
  * Narrow a handler context to `AuthenticatedContext`.
@@ -319,6 +336,18 @@ interface CrudConfig<T = unknown> {
      * Default: `false` (safe — never forwards pagination options unless opted in).
      */
     paginationSupport?: 'full' | 'client-only' | false;
+    /**
+     * Optional resolver for the client object that string methods are dispatched
+     * against. Defaults to the context's plain `apiClient` (`GravityRailClient`).
+     *
+     * Domains whose CRUD methods live on an extended/rebound surface (e.g. the
+     * gr-cli admin client, where `adminApi(ctx)` lazily binds `*AsAdmin` methods
+     * onto the instance) must pass a resolver so the generic dispatcher targets
+     * the rebound client instead of the stale bare `apiClient` — otherwise the
+     * methods are undefined and dispatch fails with "API method not found".
+     * See issue #17508.
+     */
+    resolveClient?: (ctx: AuthenticatedContext | CommandContext) => unknown;
 }
 /**
  * @deprecated Use `simpleCrudCommands()` for new code — it provides compile-time
@@ -500,8 +529,47 @@ declare function requireDirectoryTrust(opts: DirectoryTrustOptions): Promise<voi
 
 declare function devImportLocalCommand(ctx: AuthenticatedContext, workspace: string): Promise<void>;
 
-declare function loginCommand(ctx: CommandContext): Promise<void>;
-declare function logoutCommand(ctx: CommandContext): Promise<void>;
+declare function loginCommand(ctx: CommandContext, args?: ParsedArgs): Promise<void>;
+declare function logoutCommand(ctx: CommandContext, args?: ParsedArgs): Promise<void>;
+/** List stored credential profiles for the current environment. */
+declare function authListCommand(ctx: CommandContext): Promise<void>;
+/** Switch the default profile for subsequent commands. */
+declare function authSwitchCommand(ctx: CommandContext, args: ParsedArgs): Promise<void>;
+/**
+ * Import account + workspace/member tokens from dev-realms.json into named profiles.
+ * Replaces the old per-invocation `--realm` flag.
+ */
+declare function authImportDevCommand(ctx: CommandContext, args?: ParsedArgs): Promise<void>;
+
+/**
+ * Import local/dev-cloud auth tokens from dev-realms.json into gr CLI profiles.
+ *
+ * Replaces the old `--realm` flag: after import, use
+ *   yarn gr whoami --profile superadmin
+ *   yarn gr tasks list --profile acme-demo/acme-admin
+ *
+ * dev-realms.json remains the provisioner output (and is still used by e2e /
+ * site-template tooling). The gr CLI no longer reads it at command time.
+ */
+
+interface ImportDevProfilesResult {
+    path: string;
+    imported: number;
+    accountProfiles: number;
+    memberProfiles: number;
+    storePath: string;
+}
+/** Parse dev-realms.json into profile name → credentials (token + optional workspace). */
+declare function profilesFromDevRealms(data: Record<string, unknown>): Record<string, CLICredentials>;
+/**
+ * Import all accounts + workspace/member entries from dev-realms into the
+ * credential store for `env`. Overwrites matching profile names; leaves
+ * unrelated OAuth profiles intact.
+ */
+declare function importDevProfiles(credentialsManager: CredentialsManager, env: string, options?: {
+    file?: string;
+    preferCurrent?: string;
+}): ImportDevProfilesResult;
 
 declare function manageCommand(hctx: CommandHandlerContext): Promise<void>;
 declare function chatCommand(hctx: CommandHandlerContext): Promise<void>;
@@ -510,4 +578,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, 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, topLevelCommands, unwrapItems, waitForOutboundPhoneCallOutcome, 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, authImportDevCommand, authListCommand, authSwitchCommand, chatCommand, commandNeedsJsonBody, conciergeCommand, conciergeOutboundCommand, confirmAccountPhoneVerify, createAuthenticatedContext, createConciergeChat, createContext, createPublicAuthenticatedContext, createPublicContext, crudCommands, detectOutputFormat, devImportLocalCommand, extractPaginationMeta, fetchAllCursorPages, fetchAllPages, formatPaginationWarning, getConciergeChat, getConciergeChatMessages, getStartedCommand, handleError, importDevProfiles, isCursorPaginatedResponse, isDirectoryTrusted, isLikelySeedPhoneNumber, isListResult, isPagePaginatedResponse, isPaginatedResponse, listConciergeChats, listResult, loginCommand, logoutCommand, manageCommand, organizationsListCommand, originateConciergeCall, originateConciergeSms, outputData, outputSingle, parseArgs, parsePaginationArgs, profilesFromDevRealms, readJsonInput, registerPublicDomains, requireAuth, requireDirectoryTrust, requireNumber, requireString, resolveVoicePhoneNumberId, simpleCrudCommands, startAccountPhoneVerify, stderr, topLevelCommands, unwrapItems, waitForOutboundPhoneCallOutcome, whoamiCommand };