@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.8

package/lib/models/service-result.js

@@ -0,0 +1,81 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * Creates a successful service result.
+ *
+ * @template T The type of the data payload
+ * @param data - The result data
+ * @param options - Optional message, warnings, and metadata
+ * @returns A successful ServiceResult
+ *
+ * @example
+ * ```typescript
+ * return createSuccessResult(records, {
+ *   message: `Found ${records.length} records`,
+ *   metadata: { duration: Date.now() - startTime }
+ * });
+ * ```
+ */
+export function createSuccessResult(data, options) {
+    return {
+        success: true,
+        data,
+        message: options?.message,
+        warnings: options?.warnings,
+        metadata: options?.metadata,
+    };
+}
+/**
+ * Creates a failed service result.
+ *
+ * @template T The type of the data payload
+ * @param data - The default/empty data for failed result
+ * @param errorCode - The error code categorizing the failure
+ * @param message - Human-readable error message (optional — omit to test nullish coalescing fallback)
+ * @param options - Optional metadata
+ * @returns A failed ServiceResult
+ *
+ * @example
+ * ```typescript
+ * return createFailureResult([], 'E3102', 'Invalid SOQL query syntax', {
+ *   metadata: { sfErrorCode: 'INVALID_QUERY' }
+ * });
+ * ```
+ */
+export function createFailureResult(data, errorCode, message, options) {
+    return {
+        success: false,
+        data,
+        errorCode,
+        message,
+        metadata: options?.metadata,
+    };
+}
+/**
+ * Creates a failed service result without data.
+ *
+ * Use when a failure occurs before any data is available (e.g., namespace guard
+ * blocks a request, or validation fails before query execution). Avoids the
+ * `undefined as unknown as T` cast pattern.
+ *
+ * @template T The type of the data payload (inferred from calling context)
+ * @param errorCode - The error code categorizing the failure
+ * @param message - Human-readable error message
+ * @param options - Optional metadata
+ * @returns A failed ServiceResult with data set to undefined
+ */
+export function createEmptyFailureResult(errorCode, message, options) {
+    return {
+        success: false,
+        data: undefined,
+        errorCode,
+        message,
+        metadata: options?.metadata,
+    };
+}
+//# sourceMappingURL=service-result.js.map

package/lib/models/service-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-result.js","sourceRoot":"","sources":["../../src/models/service-result.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAO,EACP,OAIC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAO,EACP,SAAiB,EACjB,OAAgB,EAChB,OAEC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI;QACJ,SAAS;QACT,OAAO;QACP,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAiB,EACjB,OAAgB,EAChB,OAEC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,SAAc;QACpB,SAAS;QACT,OAAO;QACP,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAC;AACJ,CAAC"}

package/lib/models/sfdmu-types.d.ts

@@ -0,0 +1,53 @@
+export type { ServiceResult, ServiceResultMetadata } from './service-result.js';
+export { createSuccessResult, createFailureResult } from './service-result.js';
+/**
+ * Options for SFDMU execution operations.
+ */
+export type ISFDMUOptions = {
+    /** Source org username or alias for export operations */
+    sourceOrg?: string;
+    /** Target org username or alias for import operations */
+    targetOrg?: string;
+    /** Path to the export.json configuration file */
+    configPath: string;
+    /** Whether to use Bulk API for operations (default: true) */
+    useBulkAPI?: boolean;
+    /** Execution timeout in milliseconds (default: 300000 = 5 minutes) */
+    timeout?: number;
+    /** Maximum buffer size in bytes for stdout/stderr (default: 10MB) */
+    maxBuffer?: number;
+    /** Enable simulation mode - validates and previews changes without modifying data */
+    simulation?: boolean;
+};
+/**
+ * Raw result from SFDMU CLI execution.
+ */
+export type ISFDMUResult = {
+    /** Exit code from the SFDMU process (0 = success) */
+    exitCode: number;
+    /** Standard output from SFDMU */
+    stdout: string;
+    /** Standard error from SFDMU */
+    stderr: string;
+    /** Number of records processed (parsed from stdout) */
+    recordsProcessed?: number;
+    /** Error messages extracted from the output */
+    errors?: string[];
+};
+/**
+ * SFDMU-specific error codes (5000 range for system/internal errors).
+ */
+export declare const SFDMUErrorCodes: {
+    /** SFDMU plugin is not installed */
+    readonly NOT_INSTALLED: "SFDMU_NOT_INSTALLED";
+    /** SFDMU execution timed out */
+    readonly TIMEOUT: "SFDMU_TIMEOUT";
+    /** SFDMU execution failed with non-zero exit code */
+    readonly EXECUTION_FAILED: "SFDMU_EXECUTION_FAILED";
+    /** Invalid configuration file path */
+    readonly CONFIG_INVALID: "SFDMU_CONFIG_INVALID";
+};
+/**
+ * Type alias for SFDMU error code values.
+ */
+export type SFDMUErrorCode = (typeof SFDMUErrorCodes)[keyof typeof SFDMUErrorCodes];

package/lib/models/sfdmu-types.js

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+export { createSuccessResult, createFailureResult } from './service-result.js';
+// ServiceResult<T> is now imported from ./service-result.ts (re-exported above)
+/**
+ * SFDMU-specific error codes (5000 range for system/internal errors).
+ */
+export const SFDMUErrorCodes = {
+    /** SFDMU plugin is not installed */
+    NOT_INSTALLED: 'SFDMU_NOT_INSTALLED',
+    /** SFDMU execution timed out */
+    TIMEOUT: 'SFDMU_TIMEOUT',
+    /** SFDMU execution failed with non-zero exit code */
+    EXECUTION_FAILED: 'SFDMU_EXECUTION_FAILED',
+    /** Invalid configuration file path */
+    CONFIG_INVALID: 'SFDMU_CONFIG_INVALID',
+};
+//# sourceMappingURL=sfdmu-types.js.map

package/lib/models/sfdmu-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfdmu-types.js","sourceRoot":"","sources":["../../src/models/sfdmu-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAgD/E,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,aAAa,EAAE,qBAAqB;IACpC,gCAAgC;IAChC,OAAO,EAAE,eAAe;IACxB,qDAAqD;IACrD,gBAAgB,EAAE,wBAAwB;IAC1C,sCAAsC;IACtC,cAAc,EAAE,sBAAsB;CAC9B,CAAC"}

package/lib/models/status-types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Centralized status type registry for the Cuneiform CLI plugin.
+ *
+ * Naming Conventions:
+ * PascalCase for Salesforce API-sourced statuses (picklist values, deploy results).
+ * These must match the exact casing returned by the Salesforce API.
+ *
+ * camelCase for internal operational statuses (CLI execution states, action results).
+ * These are defined by the CLI and never sent to Salesforce.
+ *
+ * @module status-types
+ */
+/**
+ * Profiling request status values from `pnova__Prop_RequestStatus__c` picklist.
+ *
+ * Note: "Canceled" uses a single 'l' (Salesforce convention).
+ */
+export type ProfilingRequestStatus = 'Queued' | 'Canceled' | 'Completed' | 'Rejected';
+/**
+ * Terminal status values that indicate profiling is complete.
+ */
+export declare const TERMINAL_STATUSES: Set<ProfilingRequestStatus>;
+/**
+ * Metadata deployment status values from the Salesforce Metadata API.
+ */
+export type DeploymentStatus = 'Pending' | 'InProgress' | 'Succeeded' | 'Failed' | 'Canceled' | 'Unknown';
+/**
+ * Execution status for a single definition in bulk execution.
+ */
+export type DefinitionExecutionStatus = 'pending' | 'executing' | 'completed' | 'failed' | 'skipped';
+/**
+ * Action result status for configuration operations (permission set assignment, CMT deployment).
+ */
+export type ConfigurationActionStatus = 'applied' | 'skipped' | 'failed';
+/**
+ * Deletion result status for summary purge operations.
+ */
+export type SummaryDeletionStatus = 'deleted' | 'skipped' | 'failed';

package/lib/models/status-types.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * Terminal status values that indicate profiling is complete.
+ */
+export const TERMINAL_STATUSES = new Set(['Completed', 'Canceled', 'Rejected']);
+//# sourceMappingURL=status-types.js.map

package/lib/models/status-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-types.js","sourceRoot":"","sources":["../../src/models/status-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAyB,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC"}

package/lib/models/summary-bulk-types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Per-item result from a bulk summary operation (stop or reprofile).
+ */
+export type SummaryItemResult = {
+    /** The profiling summary record ID */
+    id: string;
+    /** Whether this item was successfully processed */
+    success: boolean;
+    /** Error code when not successful */
+    errorCode?: string;
+    /** Human-readable message when not successful */
+    message?: string;
+    /** Request ID assigned by the ISV backend (reprofile only) */
+    requestId?: string;
+};
+/**
+ * Result of a bulk summary operation (stop or reprofile).
+ */
+export type BulkSummaryResult = {
+    /** Per-item results preserving input order */
+    results: SummaryItemResult[];
+    /** Aggregate summary */
+    summary: {
+        /** Total unique IDs processed */
+        total: number;
+        /** Number of successfully processed items */
+        succeeded: number;
+        /** Number of failed items */
+        failed: number;
+    };
+};
+/**
+ * Response shape from the Cuneiform profiling REST API for bulk summary operations.
+ * Used by both stop and reprofile endpoints.
+ */
+export type BulkSummaryApiResponse = {
+    success: boolean;
+    results: Array<{
+        id: string;
+        success: boolean;
+        errorCode?: string;
+        message?: string;
+        requestId?: string;
+    }> | null;
+    errors: string[] | null;
+};
+/**
+ * In-progress profiling statuses eligible for stopping.
+ *
+ * Agg_OverallStatus__c is populated from Custom Labels with exactly 3 values:
+ * IN PROGRESS, COMPLETED, FAILED. PREPARING/STAGED/NOT STARTED are PFx_Status__c
+ * values, not overall status values.
+ */
+export declare const IN_PROGRESS_SUMMARY_STATUSES: readonly ["IN PROGRESS"];
+/**
+ * Terminal failure statuses eligible for re-profiling.
+ *
+ * When a summary is stopped, Agg_OverallStatus__c becomes FAILED (not CANCELED).
+ * CANCELED is a PFx_Status__c value, not an overall status value.
+ */
+export declare const REPROFILABLE_SUMMARY_STATUSES: readonly ["FAILED"];

package/lib/models/summary-bulk-types.js

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * In-progress profiling statuses eligible for stopping.
+ *
+ * Agg_OverallStatus__c is populated from Custom Labels with exactly 3 values:
+ * IN PROGRESS, COMPLETED, FAILED. PREPARING/STAGED/NOT STARTED are PFx_Status__c
+ * values, not overall status values.
+ */
+export const IN_PROGRESS_SUMMARY_STATUSES = ['IN PROGRESS'];
+/**
+ * Terminal failure statuses eligible for re-profiling.
+ *
+ * When a summary is stopped, Agg_OverallStatus__c becomes FAILED (not CANCELED).
+ * CANCELED is a PFx_Status__c value, not an overall status value.
+ */
+export const REPROFILABLE_SUMMARY_STATUSES = ['FAILED'];
+//# sourceMappingURL=summary-bulk-types.js.map

package/lib/models/summary-bulk-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-bulk-types.js","sourceRoot":"","sources":["../../src/models/summary-bulk-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmDH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,aAAa,CAAU,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,QAAQ,CAAU,CAAC"}

package/lib/models/user-details-types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Shared types for the `sf cuneiform user details` command result.
+ *
+ * Extracted from the command file so that display formatters (utils layer)
+ * can consume these types without importing from the commands layer.
+ *
+ * @module models/user-details-types
+ */
+/**
+ * Org context information for JSON output.
+ */
+export type OrgContextResult = {
+    /** Organization name */
+    orgName: string;
+    /** 18-character Organization ID */
+    orgId: string;
+    /** Instance URL (e.g., https://acme.my.salesforce.com) */
+    instanceUrl: string;
+    /** Whether this is a sandbox org */
+    isSandbox: boolean;
+    /** Organization type (e.g., Developer Edition, Enterprise Edition) */
+    orgType: string;
+};
+/**
+ * User identity information for JSON output.
+ */
+export type UserIdentityResult = {
+    /** Salesforce User ID */
+    id: string;
+    /** User's login username */
+    username: string;
+    /** User's email address */
+    email: string;
+    /** Name of the user's assigned Profile */
+    profileName: string;
+    /** Name of the user's assigned Role (null if not assigned) */
+    roleName: string | null;
+};
+/**
+ * Prerequisites check result.
+ */
+export type PrerequisitesResult = {
+    /** Whether Cuneiform for Salesforce is installed in the org */
+    cuneiformInstalled: boolean;
+    /** Whether the Admin permission set is assigned */
+    adminAccessAssigned: boolean;
+    /** Whether all prerequisites passed */
+    allPassed: boolean;
+};
+/**
+ * Permission set assignment status for JSON output.
+ */
+export type PermissionSetAssignmentResult = {
+    /** Full API name with namespace (e.g., pnova__Cuneiform_for_CRM_PRO_Administrative_User) */
+    apiName: string;
+    /** Human-readable label (e.g., Cuneiform for CRM PRO Administrative User) */
+    label: string;
+    /** Whether the permission set is assigned */
+    isAssigned: boolean;
+    /** Whether this permission set is required for profiling */
+    isRequired: boolean;
+};
+/**
+ * Configuration profile status for JSON output.
+ */
+export type ConfigProfileResult = {
+    /** Whether a configuration profile is active */
+    isConfigured: boolean;
+    /** Label of the active profile (null if not configured) */
+    profileLabel: string | null;
+    /** Whether API-only profiling is enabled (null if not configured) */
+    apiOnlyProfilingEnabled: boolean | null;
+    /** Whether CLI self-provisioning is enabled (null if not configured) */
+    selfRegistrationEnabled: boolean | null;
+};
+/**
+ * Readiness assessment combining permission sets and config profile.
+ */
+export type ReadinessResult = {
+    /** Whether the user is ready to use Cuneiform */
+    isReady: boolean;
+    /** Permission set assignment statuses */
+    permissionSets: PermissionSetAssignmentResult[];
+    /** Configuration profile status */
+    configProfile: ConfigProfileResult;
+};
+/**
+ * Structured resolution guidance item with persona routing.
+ */
+export type ResolutionGuidanceItem = {
+    /** What the issue is */
+    issue: string;
+    /** Itemized detail lines (rendered as indented bullets) */
+    detail?: string[];
+    /** What action to take */
+    action: string;
+    /** Who should take the action */
+    persona: 'admin' | 'self';
+};
+/**
+ * Individual configuration action result.
+ */
+export type ConfigurationActionResult = {
+    /** Type of action */
+    type: 'assignPermissionSet' | 'enableApiOnlyProfiling' | 'unassignPermissionSet' | 'disableApiOnlyProfiling';
+    /** Target identifier (permission set name or profile name) */
+    target: string;
+    /** Human-readable label for the target */
+    targetLabel: string;
+    /** Action status */
+    status: 'applied' | 'skipped' | 'failed' | 'planned';
+    /** Status message */
+    message?: string;
+};
+/**
+ * Configuration result (only present when --configure is used).
+ */
+export type ConfigurationResult = {
+    /** Whether this was a dry-run (no changes applied) */
+    dryRun: boolean;
+    /** Actions taken or planned */
+    actions: ConfigurationActionResult[];
+    /** Summary statistics */
+    summary: {
+        /** Number of changes required */
+        changesRequired: number;
+        /** Number of changes successfully applied */
+        changesApplied: number;
+        /** Number of changes that failed */
+        changesFailed: number;
+    };
+    /** Deployment job ID for tracking (if API-only profiling was enabled) */
+    deploymentJobId?: string;
+};
+/**
+ * Contextual links for the user.
+ */
+export type LinksResult = {
+    /** URL to verification documentation */
+    documentation?: string;
+    /** URL to installation guide */
+    installationGuide?: string;
+};
+/**
+ * Unified command result type for JSON output.
+ * Used by both diagnostic (default) and configure (--configure) modes.
+ */
+export type UserDetailsResult = {
+    /** Org context information */
+    orgContext: OrgContextResult;
+    /** User identity information */
+    user: UserIdentityResult;
+    /** Prerequisites check result */
+    prerequisites: PrerequisitesResult;
+    /** Readiness assessment */
+    readiness: ReadinessResult;
+    /** Structured resolution guidance (empty if ready) */
+    resolutionGuidance: ResolutionGuidanceItem[];
+    /** Configuration result (only present when --configure is used) */
+    configuration?: ConfigurationResult;
+    /** Contextual links */
+    links: LinksResult;
+};

package/lib/models/user-details-types.js

@@ -0,0 +1,9 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+export {};
+//# sourceMappingURL=user-details-types.js.map

package/lib/models/user-details-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-details-types.js","sourceRoot":"","sources":["../../src/models/user-details-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/lib/models/year-range.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Represents a single comparative year entry within a year range.
+ *
+ * Each entry defines what "Set A" and "Set B" are for a comparative definition:
+ * - Bounded: year vs year-1 (e.g., 2026 vs 2025)
+ * - Unbounded: year vs all prior records (e.g., 2023 vs Prior)
+ */
+export type ComparativeYearEntry = {
+    /** The target year (Set A: records created in this year) */
+    readonly year: number;
+    /** When true, Set B is "all records before year" instead of "year - 1" */
+    readonly unbounded: boolean;
+};
+/**
+ * A resolved year range for comparative profiling definitions.
+ *
+ * Contains the ordered list of comparative year entries derived from user input
+ * (flags like --year, --depth, --from, --to, --use-prior).
+ *
+ * Default behavior:
+ * - comparative method: depth=1 (current year only)
+ * - full method: depth=3 (current year + 2 prior years)
+ * - --use-prior replaces the last entry with an unbounded comparison
+ */
+export type YearRange = {
+    /** Ordered list of comparative years (most recent first) */
+    readonly entries: readonly ComparativeYearEntry[];
+};
+/**
+ * Raw flag inputs for year range resolution.
+ * Mirrors the CLI flags before validation and resolution.
+ */
+export type YearRangeInput = {
+    /** Single year or comma-delimited years (e.g., 2026 or "2026,2025,2024") */
+    year?: number | number[];
+    /** Number of years to include (counting back from year) */
+    depth?: number;
+    /** Start year of explicit range (inclusive) */
+    from?: number;
+    /** End year of explicit range (inclusive) */
+    to?: number;
+    /** Replace last comparison with unbounded "vs Prior" */
+    usePrior?: boolean;
+    /** Profiling method — determines default depth */
+    method?: 'metadata' | 'historical' | 'comparative' | 'recordtype' | 'outcome' | 'full';
+};
+/**
+ * Resolves CLI flag inputs into a validated YearRange.
+ *
+ * Resolution priority:
+ * 1. --from/--to: explicit range (inclusive, most recent first)
+ * 2. --year (array): comma-delimited years
+ * 3. --year + --depth: single year with lookback depth
+ * 4. --year alone: single year with method-default depth
+ * 5. No flags: current year with method-default depth
+ *
+ * @param input - Raw flag inputs
+ * @returns Resolved YearRange
+ * @throws Error if inputs are invalid or conflicting
+ */
+export declare function resolveYearRange(input?: YearRangeInput): YearRange;
+/**
+ * Returns the default depth for a given profiling method.
+ *
+ * - comparative: 1 (current year only)
+ * - outcome: 1 (no year dimension — uses filterJson)
+ * - full: 3 (current year + 2 prior)
+ * - recordtype: 3 (same as full)
+ */
+export declare function getDefaultDepth(method: string): number;
+/**
+ * Formats a ComparativeYearEntry as a human-readable string.
+ *
+ * @example
+ * formatYearEntry({ year: 2026, unbounded: false }) // "2026 vs 2025"
+ * formatYearEntry({ year: 2023, unbounded: true })  // "2023 vs Prior"
+ */
+export declare function formatYearEntry(entry: ComparativeYearEntry): string;