@aws-amplify/storage/src/internals/apis/listPaths/listPaths.ts

Storage category of aws-amplify

// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0

import { AmplifyContext, getGlobalContext } from '@aws-amplify/core';

import { assertValidationError } from '../../../errors/utils/assertValidationError';
import { StorageValidationErrorCode } from '../../../errors/types/validation';
import { ListPathsOutput } from '../../types/credentials';

import { resolveLocationsForCurrentSession } from './resolveLocationsForCurrentSession';
import { getHighestPrecedenceUserGroup } from './getHighestPrecedenceUserGroup';

export function listPaths(ctx: AmplifyContext): Promise<ListPathsOutput>;
export function listPaths(): Promise<ListPathsOutput>;
export async function listPaths(
	maybeCtx?: AmplifyContext,
): Promise<ListPathsOutput> {
	// Resolve the optional leading context. The global context is resolved at
	// CALL time (never cached) so zero-arg callers follow live configuration.
	const ctx = maybeCtx ?? getGlobalContext();

	const { Storage, Auth } = ctx.resourcesConfig;

	const s3Config = Storage?.S3;
	assertValidationError(!!s3Config, StorageValidationErrorCode.NoS3Config);

	const authConfig = Auth?.Cognito;
	assertValidationError(!!authConfig, StorageValidationErrorCode.NoAuthConfig);

	const { buckets } = s3Config;
	const { groups } = authConfig;

	if (!buckets) {
		return { locations: [] };
	}

	const { tokens, identityId } = await ctx.fetchAuthSession();
	const currentUserGroups = tokens?.accessToken.payload['cognito:groups'] as
		| string[]
		| undefined;

	const userGroupToUse = getHighestPrecedenceUserGroup(
		groups,
		currentUserGroups,
	);

	const locations = resolveLocationsForCurrentSession({
		buckets,
		isAuthenticated: !!tokens,
		identityId,
		userGroup: userGroupToUse,
	});

	return { locations };
}