@aws-amplify/storage 6.0.20 → 6.0.21-gen2-storage.7da2b89.0

package/src/providers/s3/apis/getProperties.ts

@@ -3,22 +3,45 @@
 
 import { Amplify } from '@aws-amplify/core';
 
-import { GetPropertiesInput, GetPropertiesOutput, S3Exception } from '../types';
-import { StorageValidationErrorCode } from '../../../errors/types/validation';
+import {
+	GetPropertiesInput,
+	GetPropertiesInputKey,
+	GetPropertiesInputPath,
+	GetPropertiesOutput,
+	GetPropertiesOutputKey,
+	GetPropertiesOutputPath,
+} from '../types';
 
 import { getProperties as getPropertiesInternal } from './internal/getProperties';
 
-/**
- * Gets the properties of a file. The properties include S3 system metadata and
- * the user metadata that was provided when uploading the file.
- *
- * @param input - The GetPropertiesInput object.
- * @returns Requested object properties.
- * @throws A {@link S3Exception} when the underlying S3 service returned error.
- * @throws A {@link StorageValidationErrorCode} when API call parameters are invalid.
- */
-export const getProperties = (
+interface GetProperties {
+	/**
+	 * Gets the properties of a file. The properties include S3 system metadata and
+	 * the user metadata that was provided when uploading the file.
+	 *
+	 * @param input - The `GetPropertiesInputPath` object.
+	 * @returns Requested object properties.
+	 * @throws An `S3Exception` when the underlying S3 service returned error.
+	 * @throws A `StorageValidationErrorCode` when API call parameters are invalid.
+	 */
+	(input: GetPropertiesInputPath): Promise<GetPropertiesOutputPath>;
+	/**
+	 * @deprecated The `key` and `accessLevel` parameters are deprecated and may be removed in the next major version.
+	 * Please use {@link https://docs.amplify.aws/javascript/build-a-backend/storage/get-properties/ | path} instead.
+	 *
+	 * Gets the properties of a file. The properties include S3 system metadata and
+	 * the user metadata that was provided when uploading the file.
+	 *
+	 * @param input - The `GetPropertiesInputKey` object.
+	 * @returns Requested object properties.
+	 * @throws An `S3Exception` when the underlying S3 service returned error.
+	 * @throws A `StorageValidationErrorCode` when API call parameters are invalid.
+	 */
+	(input: GetPropertiesInputKey): Promise<GetPropertiesOutputKey>;
+}
+
+export const getProperties: GetProperties = <
+	Output extends GetPropertiesOutput,
+>(
 	input: GetPropertiesInput,
-): Promise<GetPropertiesOutput> => {
-	return getPropertiesInternal(Amplify, input);
-};
+): Promise<Output> => getPropertiesInternal(Amplify, input) as Promise<Output>;

package/src/providers/s3/apis/getUrl.ts

@@ -3,28 +3,54 @@
 
 import { Amplify } from '@aws-amplify/core';
 
-import { StorageValidationErrorCode } from '../../../errors/types/validation';
-import { GetUrlInput, GetUrlOutput, S3Exception } from '../types';
-import { StorageError } from '../../../errors/StorageError';
+import {
+	GetUrlInput,
+	GetUrlInputKey,
+	GetUrlInputPath,
+	GetUrlOutput,
+} from '../types';
 
 import { getUrl as getUrlInternal } from './internal/getUrl';
 
-/**
- * Get a temporary presigned URL to download the specified S3 object.
- * The presigned URL expires when the associated role used to sign the request expires or
- * the option  `expiresIn` is reached. The `expiresAt` property in the output object indicates when the URL MAY expire.
- *
- * By default, it will not validate the object that exists in S3. If you set the `options.validateObjectExistence`
- * to true, this method will verify the given object already exists in S3 before returning a presigned
- * URL, and will throw {@link StorageError} if the object does not exist.
- *
- * @param input - The GetUrlInput object.
- * @returns Presigned URL and timestamp when the URL MAY expire.
- * @throws service: {@link S3Exception} - thrown when checking for existence of the object
- * @throws validation: {@link StorageValidationErrorCode } - Validation errors
- * thrown either username or key are not defined.
- *
- */
-export const getUrl = (input: GetUrlInput): Promise<GetUrlOutput> => {
-	return getUrlInternal(Amplify, input);
-};
+interface GetUrl {
+	/**
+	 * Get a temporary presigned URL to download the specified S3 object.
+	 * The presigned URL expires when the associated role used to sign the request expires or
+	 * the option  `expiresIn` is reached. The `expiresAt` property in the output object indicates when the URL MAY expire.
+	 *
+	 * By default, it will not validate the object that exists in S3. If you set the `options.validateObjectExistence`
+	 * to true, this method will verify the given object already exists in S3 before returning a presigned
+	 * URL, and will throw `StorageError` if the object does not exist.
+	 *
+	 * @param input - The `GetUrlInputPath` object.
+	 * @returns Presigned URL and timestamp when the URL MAY expire.
+	 * @throws service: `S3Exception` - thrown when checking for existence of the object
+	 * @throws validation: `StorageValidationErrorCode` - Validation errors
+	 * thrown either username or key are not defined.
+	 *
+	 */
+	(input: GetUrlInputPath): Promise<GetUrlOutput>;
+	/**
+	 * @deprecated The `key` and `accessLevel` parameters are deprecated and may be removed in the next major version.
+	 * Please use {@link https://docs.amplify.aws/javascript/build-a-backend/storage/download/#generate-a-download-url | path} instead.
+	 *
+	 * Get a temporary presigned URL to download the specified S3 object.
+	 * The presigned URL expires when the associated role used to sign the request expires or
+	 * the option  `expiresIn` is reached. The `expiresAt` property in the output object indicates when the URL MAY expire.
+	 *
+	 * By default, it will not validate the object that exists in S3. If you set the `options.validateObjectExistence`
+	 * to true, this method will verify the given object already exists in S3 before returning a presigned
+	 * URL, and will throw `StorageError` if the object does not exist.
+	 *
+	 * @param input - The `GetUrlInputKey` object.
+	 * @returns Presigned URL and timestamp when the URL MAY expire.
+	 * @throws service: `S3Exception` - thrown when checking for existence of the object
+	 * @throws validation: `StorageValidationErrorCode` - Validation errors
+	 * thrown either username or key are not defined.
+	 *
+	 */
+	(input: GetUrlInputKey): Promise<GetUrlOutput>;
+}
+
+export const getUrl: GetUrl = (input: GetUrlInput): Promise<GetUrlOutput> =>
+	getUrlInternal(Amplify, input);

package/src/providers/s3/apis/internal/copy.ts

@@ -4,18 +4,80 @@
 import { AmplifyClassV6 } from '@aws-amplify/core';
 import { StorageAction } from '@aws-amplify/core/internals/utils';
 
-import { CopyInput, CopyOutput } from '../../types';
-import { resolveS3ConfigAndInput } from '../../utils';
+import {
+	CopyInput,
+	CopyInputKey,
+	CopyInputPath,
+	CopyOutput,
+	CopyOutputKey,
+	CopyOutputPath,
+} from '../../types';
+import { ResolvedS3Config } from '../../types/options';
+import {
+	isInputWithPath,
+	resolveS3ConfigAndInput,
+	validateStorageOperationInput,
+} from '../../utils';
 import { StorageValidationErrorCode } from '../../../../errors/types/validation';
 import { assertValidationError } from '../../../../errors/utils/assertValidationError';
 import { copyObject } from '../../utils/client';
 import { getStorageUserAgentValue } from '../../utils/userAgent';
 import { logger } from '../../../../utils';
 
+const isCopyInputWithPath = (input: CopyInput): input is CopyInputPath =>
+	isInputWithPath(input.source);
+
 export const copy = async (
 	amplify: AmplifyClassV6,
 	input: CopyInput,
 ): Promise<CopyOutput> => {
+	return isCopyInputWithPath(input)
+		? copyWithPath(amplify, input)
+		: copyWithKey(amplify, input);
+};
+
+const copyWithPath = async (
+	amplify: AmplifyClassV6,
+	input: CopyInputPath,
+): Promise<CopyOutputPath> => {
+	const { source, destination } = input;
+	const { s3Config, bucket, identityId } =
+		await resolveS3ConfigAndInput(amplify);
+
+	assertValidationError(!!source.path, StorageValidationErrorCode.NoSourcePath);
+	assertValidationError(
+		!!destination.path,
+		StorageValidationErrorCode.NoDestinationPath,
+	);
+
+	const { objectKey: sourcePath } = validateStorageOperationInput(
+		source,
+		identityId,
+	);
+	const { objectKey: destinationPath } = validateStorageOperationInput(
+		destination,
+		identityId,
+	);
+
+	const finalCopySource = `${bucket}/${sourcePath}`;
+	const finalCopyDestination = destinationPath;
+	logger.debug(`copying "${finalCopySource}" to "${finalCopyDestination}".`);
+
+	await serviceCopy({
+		source: finalCopySource,
+		destination: finalCopyDestination,
+		bucket,
+		s3Config,
+	});
+
+	return { path: finalCopyDestination };
+};
+
+/** @deprecated Use {@link copyWithPath} instead. */
+export const copyWithKey = async (
+	amplify: AmplifyClassV6,
+	input: CopyInputKey,
+): Promise<CopyOutputKey> => {
 	const {
 		source: { key: sourceKey },
 		destination: { key: destinationKey },
@@ -41,6 +103,30 @@ export const copy = async (
 	const finalCopySource = `${bucket}/${sourceKeyPrefix}${sourceKey}`;
 	const finalCopyDestination = `${destinationKeyPrefix}${destinationKey}`;
 	logger.debug(`copying "${finalCopySource}" to "${finalCopyDestination}".`);
+
+	await serviceCopy({
+		source: finalCopySource,
+		destination: finalCopyDestination,
+		bucket,
+		s3Config,
+	});
+
+	return {
+		key: destinationKey,
+	};
+};
+
+const serviceCopy = async ({
+	source,
+	destination,
+	bucket,
+	s3Config,
+}: {
+	source: string;
+	destination: string;
+	bucket: string;
+	s3Config: ResolvedS3Config;
+}) => {
 	await copyObject(
 		{
 			...s3Config,
@@ -48,13 +134,9 @@ export const copy = async (
 		},
 		{
 			Bucket: bucket,
-			CopySource: finalCopySource,
-			Key: finalCopyDestination,
+			CopySource: source,
+			Key: destination,
 			MetadataDirective: 'COPY', // Copies over metadata like contentType as well
 		},
 	);
-
-	return {
-		key: destinationKey,
-	};
 };

package/src/providers/s3/apis/internal/getProperties.ts

@@ -5,24 +5,31 @@ import { AmplifyClassV6 } from '@aws-amplify/core';
 import { StorageAction } from '@aws-amplify/core/internals/utils';
 
 import { GetPropertiesInput, GetPropertiesOutput } from '../../types';
-import { resolveS3ConfigAndInput } from '../../utils';
+import {
+	resolveS3ConfigAndInput,
+	validateStorageOperationInput,
+} from '../../utils';
 import { headObject } from '../../utils/client';
 import { getStorageUserAgentValue } from '../../utils/userAgent';
 import { logger } from '../../../../utils';
+import { STORAGE_INPUT_KEY } from '../../utils/constants';
 
 export const getProperties = async (
 	amplify: AmplifyClassV6,
 	input: GetPropertiesInput,
 	action?: StorageAction,
 ): Promise<GetPropertiesOutput> => {
-	const { key, options } = input;
-	const { s3Config, bucket, keyPrefix } = await resolveS3ConfigAndInput(
-		amplify,
-		options,
+	const { options: getPropertiesOptions } = input;
+	const { s3Config, bucket, keyPrefix, identityId } =
+		await resolveS3ConfigAndInput(amplify, getPropertiesOptions);
+	const { inputType, objectKey } = validateStorageOperationInput(
+		input,
+		identityId,
 	);
-	const finalKey = `${keyPrefix}${key}`;
+	const finalKey =
+		inputType === STORAGE_INPUT_KEY ? keyPrefix + objectKey : objectKey;
 
-	logger.debug(`get properties of ${key} from ${finalKey}`);
+	logger.debug(`get properties of ${objectKey} from ${finalKey}`);
 	const response = await headObject(
 		{
 			...s3Config,
@@ -36,8 +43,7 @@ export const getProperties = async (
 		},
 	);
 
-	return {
-		key,
+	const result = {
 		contentType: response.ContentType,
 		size: response.ContentLength,
 		eTag: response.ETag,
@@ -45,4 +51,8 @@ export const getProperties = async (
 		metadata: response.Metadata,
 		versionId: response.VersionId,
 	};
+
+	return inputType === STORAGE_INPUT_KEY
+		? { key: objectKey, ...result }
+		: { path: objectKey, ...result };
 };

package/src/providers/s3/apis/internal/getUrl.ts

@@ -7,11 +7,15 @@ import { StorageAction } from '@aws-amplify/core/internals/utils';
 import { GetUrlInput, GetUrlOutput } from '../../types';
 import { StorageValidationErrorCode } from '../../../../errors/types/validation';
 import { getPresignedGetObjectUrl } from '../../utils/client';
-import { resolveS3ConfigAndInput } from '../../utils';
+import {
+	resolveS3ConfigAndInput,
+	validateStorageOperationInput,
+} from '../../utils';
 import { assertValidationError } from '../../../../errors/utils/assertValidationError';
 import {
 	DEFAULT_PRESIGN_EXPIRATION,
 	MAX_URL_EXPIRATION,
+	STORAGE_INPUT_KEY,
 } from '../../utils/constants';
 
 import { getProperties } from './getProperties';
@@ -20,18 +24,32 @@ export const getUrl = async (
 	amplify: AmplifyClassV6,
 	input: GetUrlInput,
 ): Promise<GetUrlOutput> => {
-	const { key, options } = input;
+	const { options: getUrlOptions } = input;
+	const { s3Config, keyPrefix, bucket, identityId } =
+		await resolveS3ConfigAndInput(amplify, getUrlOptions);
+	const { inputType, objectKey } = validateStorageOperationInput(
+		input,
+		identityId,
+	);
 
-	if (options?.validateObjectExistence) {
-		await getProperties(amplify, { key, options }, StorageAction.GetUrl);
-	}
+	const finalKey =
+		inputType === STORAGE_INPUT_KEY ? keyPrefix + objectKey : objectKey;
 
-	const { s3Config, keyPrefix, bucket } = await resolveS3ConfigAndInput(
-		amplify,
-		options,
-	);
+	if (getUrlOptions?.validateObjectExistence) {
+		await getProperties(
+			amplify,
+			{
+				options: getUrlOptions,
+				...((inputType === STORAGE_INPUT_KEY
+					? { key: input.key }
+					: { path: input.path }) as GetUrlInput),
+			},
+			StorageAction.GetUrl,
+		);
+	}
 
-	let urlExpirationInSec = options?.expiresIn ?? DEFAULT_PRESIGN_EXPIRATION;
+	let urlExpirationInSec =
+		getUrlOptions?.expiresIn ?? DEFAULT_PRESIGN_EXPIRATION;
 	const awsCredExpiration = s3Config.credentials?.expiration;
 	if (awsCredExpiration) {
 		const awsCredExpirationInSec = Math.floor(
@@ -54,7 +72,7 @@ export const getUrl = async (
 			},
 			{
 				Bucket: bucket,
-				Key: `${keyPrefix}${key}`,
+				Key: finalKey,
 			},
 		),
 		expiresAt: new Date(Date.now() + urlExpirationInSec * 1000),

package/src/providers/s3/apis/internal/remove.ts

@@ -5,23 +5,37 @@ import { AmplifyClassV6 } from '@aws-amplify/core';
 import { StorageAction } from '@aws-amplify/core/internals/utils';
 
 import { RemoveInput, RemoveOutput } from '../../types';
-import { resolveS3ConfigAndInput } from '../../utils';
+import {
+	resolveS3ConfigAndInput,
+	validateStorageOperationInput,
+} from '../../utils';
 import { deleteObject } from '../../utils/client';
 import { getStorageUserAgentValue } from '../../utils/userAgent';
 import { logger } from '../../../../utils';
+import { STORAGE_INPUT_KEY } from '../../utils/constants';
 
 export const remove = async (
 	amplify: AmplifyClassV6,
 	input: RemoveInput,
 ): Promise<RemoveOutput> => {
-	const { key, options = {} } = input;
-	const { s3Config, keyPrefix, bucket } = await resolveS3ConfigAndInput(
-		amplify,
-		options,
+	const { options = {} } = input ?? {};
+	const { s3Config, keyPrefix, bucket, identityId } =
+		await resolveS3ConfigAndInput(amplify, options);
+
+	const { inputType, objectKey } = validateStorageOperationInput(
+		input,
+		identityId,
 	);
 
-	const finalKey = `${keyPrefix}${key}`;
-	logger.debug(`remove "${key}" from "${finalKey}".`);
+	let finalKey;
+	if (inputType === STORAGE_INPUT_KEY) {
+		finalKey = `${keyPrefix}${objectKey}`;
+		logger.debug(`remove "${objectKey}" from "${finalKey}".`);
+	} else {
+		finalKey = objectKey;
+		logger.debug(`removing object in path "${finalKey}"`);
+	}
+
 	await deleteObject(
 		{
 			...s3Config,
@@ -33,7 +47,11 @@ export const remove = async (
 		},
 	);
 
-	return {
-		key,
-	};
+	return inputType === STORAGE_INPUT_KEY
+		? {
+				key: objectKey,
+			}
+		: {
+				path: objectKey,
+			};
 };

package/src/providers/s3/apis/remove.ts

@@ -3,18 +3,41 @@
 
 import { Amplify } from '@aws-amplify/core';
 
-import { RemoveInput, RemoveOutput, S3Exception } from '../types';
-import { StorageValidationErrorCode } from '../../../errors/types/validation';
+import {
+	RemoveInput,
+	RemoveInputKey,
+	RemoveInputPath,
+	RemoveOutput,
+	RemoveOutputKey,
+	RemoveOutputPath,
+} from '../types';
 
 import { remove as removeInternal } from './internal/remove';
 
-/**
- * Remove a file from your S3 bucket.
- * @param input - The RemoveInput object.
- * @return Output containing the removed object key
- * @throws service: {@link S3Exception} - S3 service errors thrown while getting properties
- * @throws validation: {@link StorageValidationErrorCode } - Validation errors thrown
- */
-export const remove = (input: RemoveInput): Promise<RemoveOutput> => {
-	return removeInternal(Amplify, input);
-};
+interface RemoveApi {
+	/**
+	 * Remove a file from your S3 bucket.
+	 * @param input - The `RemoveInputPath` object.
+	 * @return Output containing the removed object path.
+	 * @throws service: `S3Exception` - S3 service errors thrown while while removing the object.
+	 * @throws validation: `StorageValidationErrorCode` - Validation errors thrown
+	 * when there is no path or path is empty or path has a leading slash.
+	 */
+	(input: RemoveInputPath): Promise<RemoveOutputPath>;
+	/**
+	 * @deprecated The `key` and `accessLevel` parameters are deprecated and may be removed in the next major version.
+	 * Please use {@link https://docs.amplify.aws/react/build-a-backend/storage/remove | path} instead.
+	 *
+	 * Remove a file from your S3 bucket.
+	 * @param input - The `RemoveInputKey` object.
+	 * @return Output containing the removed object key
+	 * @throws service: `S3Exception` - S3 service errors thrown while while removing the object
+	 * @throws validation: `StorageValidationErrorCode` - Validation errors thrown
+	 * when there is no key or its empty.
+	 */
+	(input: RemoveInputKey): Promise<RemoveOutputKey>;
+}
+
+export const remove: RemoveApi = <Output extends RemoveOutput>(
+	input: RemoveInput,
+): Promise<Output> => removeInternal(Amplify, input) as Promise<Output>;

package/src/providers/s3/apis/server/copy.ts

@@ -1,17 +1,60 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-
 import {
 	AmplifyServer,
 	getAmplifyServerContext,
 } from '@aws-amplify/core/internals/adapter-core';
 
-import { CopyInput, CopyOutput } from '../../types';
+import {
+	CopyInput,
+	CopyInputKey,
+	CopyInputPath,
+	CopyOutput,
+	CopyOutputKey,
+	CopyOutputPath,
+} from '../../types';
 import { copy as copyInternal } from '../internal/copy';
 
-export const copy = async (
+interface Copy {
+	/**
+	 * Copy an object from a source to a destination object within the same bucket.
+	 *
+	 * @param contextSpec - The isolated server context.
+	 * @param input - The CopyInputPath object.
+	 * @returns Output containing the destination object path.
+	 * @throws service: `S3Exception` - Thrown when checking for existence of the object
+	 * @throws validation: `StorageValidationErrorCode` - Thrown when
+	 * source or destination path is not defined.
+	 */
+	(
+		contextSpec: AmplifyServer.ContextSpec,
+		input: CopyInputPath,
+	): Promise<CopyOutputPath>;
+	/**
+	 * @deprecated The `key` and `accessLevel` parameters are deprecated and may be removed in the next major version.
+	 * Please use {@link https://docs.amplify.aws/react/build-a-backend/storage/copy | path} instead.
+	 *
+	 * Copy an object from a source to a destination object within the same bucket. Can optionally copy files across
+	 * different accessLevel or identityId (if source object's accessLevel is 'protected').
+	 *
+	 * @param contextSpec - The isolated server context.
+	 * @param input - The CopyInputKey object.
+	 * @returns Output containing the destination object key.
+	 * @throws service: `S3Exception` - Thrown when checking for existence of the object
+	 * @throws validation: `StorageValidationErrorCode` - Thrown when
+	 * source or destination key is not defined.
+	 */
+	(
+		contextSpec: AmplifyServer.ContextSpec,
+		input: CopyInputKey,
+	): Promise<CopyOutputKey>;
+}
+
+export const copy: Copy = <Output extends CopyOutput>(
 	contextSpec: AmplifyServer.ContextSpec,
 	input: CopyInput,
-): Promise<CopyOutput> => {
-	return copyInternal(getAmplifyServerContext(contextSpec).amplify, input);
-};
+): Promise<Output> =>
+	copyInternal(
+		getAmplifyServerContext(contextSpec).amplify,
+		input,
+	) as Promise<Output>;

package/src/providers/s3/apis/server/getProperties.ts

@@ -6,15 +6,57 @@ import {
 	getAmplifyServerContext,
 } from '@aws-amplify/core/internals/adapter-core';
 
-import { GetPropertiesInput, GetPropertiesOutput } from '../../types';
+import {
+	GetPropertiesInput,
+	GetPropertiesInputKey,
+	GetPropertiesInputPath,
+	GetPropertiesOutput,
+	GetPropertiesOutputKey,
+	GetPropertiesOutputPath,
+} from '../../types';
 import { getProperties as getPropertiesInternal } from '../internal/getProperties';
 
-export const getProperties = (
+interface GetProperties {
+	/**
+	 * Gets the properties of a file. The properties include S3 system metadata and
+	 * the user metadata that was provided when uploading the file.
+	 *
+	 * @param contextSpec - The isolated server context.
+	 * @param input - The `GetPropertiesInputPath` object.
+	 * @returns Requested object properties.
+	 * @throws An `S3Exception` when the underlying S3 service returned error.
+	 * @throws A `StorageValidationErrorCode` when API call parameters are invalid.
+	 */
+	(
+		contextSpec: AmplifyServer.ContextSpec,
+		input: GetPropertiesInputPath,
+	): Promise<GetPropertiesOutputPath>;
+	/**
+	 * @deprecated The `key` and `accessLevel` parameters are deprecated and may be removed in the next major version.
+	 * Please use {@link https://docs.amplify.aws/javascript/build-a-backend/storage/get-properties/ | path} instead.
+	 *
+	 * Gets the properties of a file. The properties include S3 system metadata and
+	 * the user metadata that was provided when uploading the file.
+	 *
+	 * @param contextSpec - The isolated server context.
+	 * @param input - The `GetPropertiesInputKey` object.
+	 * @returns Requested object properties.
+	 * @throws An `S3Exception` when the underlying S3 service returned error.
+	 * @throws A `StorageValidationErrorCode` when API call parameters are invalid.
+	 */
+	(
+		contextSpec: AmplifyServer.ContextSpec,
+		input: GetPropertiesInputKey,
+	): Promise<GetPropertiesOutputKey>;
+}
+
+export const getProperties: GetProperties = <
+	Output extends GetPropertiesOutput,
+>(
 	contextSpec: AmplifyServer.ContextSpec,
 	input: GetPropertiesInput,
-): Promise<GetPropertiesOutput> => {
-	return getPropertiesInternal(
+): Promise<Output> =>
+	getPropertiesInternal(
 		getAmplifyServerContext(contextSpec).amplify,
 		input,
-	);
-};
+	) as Promise<Output>;