Function objectCopy

objectCopy(
    profileId: string,
    source: ObjectRef,
    destination: ObjectRef,
    options?: CopyOptions,
    confirmedToken?: string,
): Promise<CopyOutcome>
Copy source to destination with automatic cross-account fallback.

The backend attempts a server-side CopyObject first. On AccessDenied (cross-account signal) it falls back to download+upload when the source is ≤ 100 MiB. For larger files an explicit confirmedToken (obtained via crossAccountConfirm) is required.

The backend acquires locks on both source and destination prefixes, performs the copy, invalidates the destination prefix cache, and emits objects:updated { profileId, bucket, prefix } for the destination.
Parameters
- profileId: string
  The profile whose credentials to use.
- source: ObjectRef
  Source bucket + key.
- destination: ObjectRef
  Destination bucket + key (may be a different bucket).
- Optionaloptions: CopyOptions
  Copy directives (defaults to Copy/Copy if omitted).
- OptionalconfirmedToken: string
  One-time token from crossAccountConfirm for large cross-account copies.
Returns Promise<CopyOutcome>
- Defined in src/api/objects.ts:269