@kensio/yulin 1.21.0 → 1.21.2

package/dist/service/s3/command/delete-objects/delete-object-attempt.js

@@ -2,13 +2,17 @@
  * What one key of a DeleteObjects request came to.
  *
  * A batch deletion carries on past a key it could not remove, so the failure
- * travels with the key it belongs to rather than being raised.
+ * travels with the key it belongs to rather than being raised. So does the
+ * delete marker, which a versioned Bucket reports per key alongside the id it
+ * was written under.
  */
 export class DeleteObjectAttempt {
     key;
     error;
-    constructor(key, error) {
+    deleteMarker;
+    constructor(key, error, deleteMarker) {
         this.key = key;
         this.error = error;
+        this.deleteMarker = deleteMarker;
     }
 }

package/dist/service/s3/command/delete-objects/delete-objects-key-removal.js

@@ -1,5 +1,6 @@
 import { DeleteObjectAuthorizer } from "../delete-object/delete-object-authorizer.js";
 import { DeleteObjectAttempt } from "./delete-object-attempt.js";
+import { simS3NotifyDeleted } from "../delete-object/sim-s3-notify-deleted.js";
 /**
  * Removes one key of a batch deletion.
  *
@@ -21,15 +22,15 @@ export class DeleteObjectsKeyRemoval {
     async remove(bucket, key, options) {
         try {
             const resolvedCaller = this.authorizer.authorize(bucket, key, options);
-            const removed = await bucket.deleteObject(key);
-            if (removed) {
-                this.notifications.objectRemoved({
-                    bucket,
-                    key,
-                    caller: resolvedCaller,
-                });
-            }
-            return new DeleteObjectAttempt(key);
+            const deletion = await bucket.deleteObject(key);
+            simS3NotifyDeleted({
+                notifications: this.notifications,
+                bucket,
+                key,
+                caller: resolvedCaller,
+                deletion,
+            });
+            return new DeleteObjectAttempt(key, undefined, deletion.deleteMarker);
         }
         catch (error) {
             return new DeleteObjectAttempt(key, error);

package/dist/service/s3/command/delete-objects/delete-objects-outcome.js

@@ -33,7 +33,15 @@ export class DeleteObjectsOutcome {
      */
     record(attempt) {
         if (attempt.error === undefined) {
-            this.deleted.push({ Key: attempt.key });
+            this.deleted.push({
+                Key: attempt.key,
+                // Reported per key, as real S3 does, so a caller can tell which keys
+                // of the batch were hidden behind a marker rather than removed.
+                ...(attempt.deleteMarker !== undefined && {
+                    DeleteMarker: true,
+                    DeleteMarkerVersionId: attempt.deleteMarker.versionId,
+                }),
+            });
             return;
         }
         this.recordFailure(attempt.key, attempt.error);

package/dist/service/s3/command/delete-objects/delete-objects.command.d.ts

@@ -38,9 +38,15 @@ export interface SimDeleteObjectsCommandOutput {
 }
 /**
  * One Object a DeleteObjects request removed.
+ *
+ * A versioned Bucket hides the Object behind a marker instead of removing it,
+ * and reports the marker it wrote under `DeleteMarker` and
+ * `DeleteMarkerVersionId`. A Bucket without versioning carries neither.
  */
 export interface SimS3DeletedObject {
     readonly Key: string;
+    readonly DeleteMarker?: boolean | undefined;
+    readonly DeleteMarkerVersionId?: string | undefined;
 }
 /**
  * One Object a DeleteObjects request could not remove.

package/dist/service/s3/command/get-bucket-versioning/get-bucket-versioning.command.d.ts

@@ -0,0 +1,23 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+/**
+ * Minimal structural sim S3 GetBucketVersioning command.
+ */
+export interface SimGetBucketVersioningCommand {
+    readonly input: SimGetBucketVersioningCommandInput;
+}
+/**
+ * Minimal structural sim S3 GetBucketVersioning input.
+ */
+export interface SimGetBucketVersioningCommandInput {
+    readonly Bucket?: string | undefined;
+}
+/**
+ * Minimal structural sim S3 GetBucketVersioning output.
+ *
+ * A Bucket nobody has configured answers with neither field, which is how real
+ * S3 separates an unversioned Bucket from a suspended one.
+ */
+export interface SimGetBucketVersioningCommandOutput {
+    readonly Status?: "Enabled" | "Suspended" | undefined;
+    readonly $metadata: SimResponseMetadata;
+}

package/dist/service/s3/command/get-bucket-versioning/get-bucket-versioning.command.js

@@ -0,0 +1 @@
+export {};

package/dist/service/s3/command/get-bucket-versioning/get-bucket-versioning.handler.d.ts

@@ -0,0 +1,31 @@
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import { type BackgroundScheduler } from "../../../../util/background/background.js";
+import { type SimIamInterServiceAuthZ } from "../../../iam/authorize/sim-iam-inter-service-auth-z.js";
+import type { SimS3Bucket, SimS3BucketName } from "../../bucket/sim-s3-bucket.js";
+import type { SimS3RequestOptions } from "../sim-s3-request-options.js";
+import type { SimGetBucketVersioningCommand, SimGetBucketVersioningCommandOutput } from "./get-bucket-versioning.command.js";
+interface GetBucketVersioningHandlerProperties {
+    readonly buckets: Map<SimS3BucketName, SimS3Bucket>;
+    readonly iam?: SimIamInterServiceAuthZ;
+    readonly background?: BackgroundScheduler;
+}
+/**
+ * Simulated S3 GetBucketVersioningCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3/command/GetBucketVersioningCommand/
+ */
+export declare class GetBucketVersioningCommandHandler implements CommandHandler<SimGetBucketVersioningCommand, SimGetBucketVersioningCommandOutput> {
+    private readonly buckets;
+    private readonly authorizer;
+    private readonly background;
+    constructor(properties: GetBucketVersioningHandlerProperties);
+    /**
+     * Authorize and report how a Bucket is versioned.
+     *
+     * A Bucket nobody has configured answers with an empty response rather than
+     * an error, which is how real S3 reports one and what distinguishes it from
+     * a Bucket whose versioning was suspended.
+     */
+    handle(command: SimGetBucketVersioningCommand, options?: SimS3RequestOptions): Promise<SimGetBucketVersioningCommandOutput>;
+}
+export {};

package/dist/service/s3/command/get-bucket-versioning/get-bucket-versioning.handler.js

@@ -0,0 +1,40 @@
+import { BackgroundTasks, } from "../../../../util/background/background.js";
+import { assertDefined } from "../../../../util/type-guard/defined.js";
+import { SimIamAllowAllAuth, } from "../../../iam/authorize/sim-iam-inter-service-auth-z.js";
+import { requireSimS3Bucket } from "../require-sim-s3-bucket.js";
+import { SimS3VersioningAuthorizer } from "../versioning/sim-s3-versioning-authorizer.js";
+/**
+ * Simulated S3 GetBucketVersioningCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3/command/GetBucketVersioningCommand/
+ */
+export class GetBucketVersioningCommandHandler {
+    buckets;
+    authorizer;
+    background;
+    constructor(properties) {
+        const { buckets, iam = new SimIamAllowAllAuth(), background = new BackgroundTasks(), } = properties;
+        this.buckets = buckets;
+        this.authorizer = new SimS3VersioningAuthorizer({ iam });
+        this.background = background;
+    }
+    /**
+     * Authorize and report how a Bucket is versioned.
+     *
+     * A Bucket nobody has configured answers with an empty response rather than
+     * an error, which is how real S3 reports one and what distinguishes it from
+     * a Bucket whose versioning was suspended.
+     */
+    async handle(command, options) {
+        assertDefined(command.input.Bucket, "GetBucketVersioningCommand.input.Bucket");
+        const bucketName = command.input.Bucket;
+        const bucket = requireSimS3Bucket(this.buckets, bucketName);
+        await this.background.sequence();
+        this.authorizer.authorizeRead(bucket, options);
+        const status = bucket.getVersions().configuration.status;
+        return {
+            ...(status !== undefined && { Status: status }),
+            $metadata: {},
+        };
+    }
+}

package/dist/service/s3/command/get-object/get-object-loader.d.ts

@@ -10,7 +10,8 @@ import type { SimGetObjectCommandOutput } from "./get-object.command.js";
  * This class owns both storage lookup and response conversion because the SDK
  * response is a representation of the stored Object:
  *
- * - a missing storage entry becomes the S3 NoSuchKey error;
+ * - a missing storage entry becomes the S3 NoSuchKey error, and a `VersionId`
+ *   naming a version the Bucket never issued becomes NoSuchVersion;
  * - the stored Buffer, or the part of it the read asked for, becomes the
  *   readable response body;
  * - what S3 was told about the Object becomes the response's own fields, and
@@ -25,5 +26,5 @@ export declare class GetObjectLoader {
      * Read an Object, or the range of it that was asked for, from the resolved
      * Bucket, and build its SDK command output.
      */
-    load(bucket: SimS3Bucket, key: string, rangeHeader?: string): Promise<SimGetObjectCommandOutput>;
+    load(bucket: SimS3Bucket, key: string, rangeHeader?: string, versionId?: string): Promise<SimGetObjectCommandOutput>;
 }

package/dist/service/s3/command/get-object/get-object-loader.js

@@ -2,6 +2,7 @@ import { Readable } from "node:stream";
 import { SimS3NoSuchKey } from "../../error/sim-s3.error.js";
 import { simS3QuotedETag } from "../../object/s3-object-etag.js";
 import { simS3ContentRange, simS3ReadObjectRange, } from "../../object/s3-object-range.js";
+import { simS3ReadObjectVersion } from "../object/sim-s3-read-object-version.js";
 /**
  * Loads an authorized S3 Object and converts it to a GetObject response.
  *
@@ -12,7 +13,8 @@ import { simS3ContentRange, simS3ReadObjectRange, } from "../../object/s3-object
  * This class owns both storage lookup and response conversion because the SDK
  * response is a representation of the stored Object:
  *
- * - a missing storage entry becomes the S3 NoSuchKey error;
+ * - a missing storage entry becomes the S3 NoSuchKey error, and a `VersionId`
+ *   naming a version the Bucket never issued becomes NoSuchVersion;
  * - the stored Buffer, or the part of it the read asked for, becomes the
  *   readable response body;
  * - what S3 was told about the Object becomes the response's own fields, and
@@ -27,11 +29,12 @@ export class GetObjectLoader {
      * Read an Object, or the range of it that was asked for, from the resolved
      * Bucket, and build its SDK command output.
      */
-    async load(bucket, key, rangeHeader) {
-        const object = await bucket.getObject(key);
-        if (object === undefined) {
+    async load(bucket, key, rangeHeader, versionId) {
+        const read = await simS3ReadObjectVersion(bucket, key, versionId);
+        if (read === undefined) {
             throw new SimS3NoSuchKey(`No S3 Object named ${key}`);
         }
+        const object = read.object;
         const size = object.body.length;
         const range = simS3ReadObjectRange(rangeHeader, size);
         const body = range === undefined
@@ -47,6 +50,8 @@ export class GetObjectLoader {
             ETag: simS3QuotedETag(object.etag),
             LastModified: object.lastModified,
             ContentLength: body.length,
+            ...(read.versionId !== undefined && { VersionId: read.versionId }),
+            ...read.lock?.reported,
             ...(range !== undefined && {
                 ContentRange: simS3ContentRange(range, size),
             }),

package/dist/service/s3/command/get-object/get-object.command.d.ts

@@ -1,5 +1,6 @@
 import type { Readable } from "node:stream";
 import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+import type { SimS3ObjectLockOutput } from "../../bucket/lock/sim-s3-object-lock-output.js";
 import type { SimS3SystemMetadataOutput } from "../../object/s3-system-metadata-read.js";
 /**
  * Minimal structural sim S3 GetObject command.
@@ -19,6 +20,11 @@ export interface SimGetObjectCommandInput {
      * Object.
      */
     readonly Range?: string | undefined;
+    /**
+     * The version to read. A request naming none reads the current version, and
+     * a Bucket keeping no versions answers the Object under the key.
+     */
+    readonly VersionId?: string | undefined;
 }
 /**
  * Minimal structural sim S3 GetObject output.
@@ -35,12 +41,14 @@ export interface SimGetObjectCommandInput {
  * when it was written. `Metadata` is what the caller attached to it, and holds
  * nothing else.
  */
-export interface SimGetObjectCommandOutput extends SimS3SystemMetadataOutput {
+export interface SimGetObjectCommandOutput extends SimS3SystemMetadataOutput, SimS3ObjectLockOutput {
     readonly Body?: Readable;
     readonly Metadata?: Record<string, string>;
     readonly ETag?: string;
     readonly LastModified?: Date;
     readonly ContentLength?: number;
     readonly ContentRange?: string;
+    /** The version read, on a Bucket keeping versions. */
+    readonly VersionId?: string | undefined;
     readonly $metadata: SimResponseMetadata;
 }

package/dist/service/s3/command/get-object/get-object.handler.js

@@ -45,6 +45,6 @@ export class GetObjectCommandHandler {
         // Complete request sequencing before authorization and storage access.
         await this.background.sequence();
         this.authorizer.authorize(bucket, command.input.Key, options);
-        return await this.loader.load(bucket, command.input.Key, command.input.Range);
+        return await this.loader.load(bucket, command.input.Key, command.input.Range, command.input.VersionId);
     }
 }

package/dist/service/s3/command/get-object-lock-configuration/get-object-lock-configuration.command.d.ts

@@ -0,0 +1,25 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+import type { SimS3ObjectLockConfigurationInput } from "../../bucket/lock/sim-s3-object-lock-configuration.js";
+/**
+ * Minimal structural sim S3 GetObjectLockConfiguration command.
+ */
+export interface SimGetObjectLockConfigurationCommand {
+    readonly input: SimGetObjectLockConfigurationCommandInput;
+}
+/**
+ * Minimal structural sim S3 GetObjectLockConfiguration input.
+ */
+export interface SimGetObjectLockConfigurationCommandInput {
+    readonly Bucket?: string | undefined;
+}
+/**
+ * Minimal structural sim S3 GetObjectLockConfiguration output.
+ *
+ * A Bucket that has never had Object Lock answers with
+ * `ObjectLockConfigurationNotFoundError` rather than an empty configuration,
+ * so this always carries one.
+ */
+export interface SimGetObjectLockConfigurationCommandOutput {
+    readonly ObjectLockConfiguration: SimS3ObjectLockConfigurationInput;
+    readonly $metadata: SimResponseMetadata;
+}

package/dist/service/s3/command/get-object-lock-configuration/get-object-lock-configuration.command.js

@@ -0,0 +1 @@
+export {};

package/dist/service/s3/command/get-object-lock-configuration/get-object-lock-configuration.handler.d.ts

@@ -0,0 +1,31 @@
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import { type BackgroundScheduler } from "../../../../util/background/background.js";
+import { type SimIamInterServiceAuthZ } from "../../../iam/authorize/sim-iam-inter-service-auth-z.js";
+import type { SimS3Bucket, SimS3BucketName } from "../../bucket/sim-s3-bucket.js";
+import type { SimS3RequestOptions } from "../sim-s3-request-options.js";
+import type { SimGetObjectLockConfigurationCommand, SimGetObjectLockConfigurationCommandOutput } from "./get-object-lock-configuration.command.js";
+interface GetObjectLockConfigurationHandlerProperties {
+    readonly buckets: Map<SimS3BucketName, SimS3Bucket>;
+    readonly iam?: SimIamInterServiceAuthZ;
+    readonly background?: BackgroundScheduler;
+}
+/**
+ * Simulated S3 GetObjectLockConfigurationCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3/command/GetObjectLockConfigurationCommand/
+ */
+export declare class GetObjectLockConfigurationCommandHandler implements CommandHandler<SimGetObjectLockConfigurationCommand, SimGetObjectLockConfigurationCommandOutput> {
+    private readonly buckets;
+    private readonly authorizer;
+    private readonly background;
+    constructor(properties: GetObjectLockConfigurationHandlerProperties);
+    /**
+     * Report how a Bucket is locked.
+     *
+     * A Bucket that has never had Object Lock is answered with
+     * `ObjectLockConfigurationNotFoundError`, as real S3 answers one, rather
+     * than with a configuration saying it is off.
+     */
+    handle(command: SimGetObjectLockConfigurationCommand, options?: SimS3RequestOptions): Promise<SimGetObjectLockConfigurationCommandOutput>;
+}
+export {};

package/dist/service/s3/command/get-object-lock-configuration/get-object-lock-configuration.handler.js

@@ -0,0 +1,41 @@
+import { BackgroundTasks, } from "../../../../util/background/background.js";
+import { assertDefined } from "../../../../util/type-guard/defined.js";
+import { SimIamAllowAllAuth, } from "../../../iam/authorize/sim-iam-inter-service-auth-z.js";
+import { SimS3ObjectLockConfigurationNotFound } from "../../error/sim-s3-object-lock.error.js";
+import { SimS3ObjectLockAuthorizer } from "../object-lock/sim-s3-object-lock-authorizer.js";
+import { requireSimS3Bucket } from "../require-sim-s3-bucket.js";
+/**
+ * Simulated S3 GetObjectLockConfigurationCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3/command/GetObjectLockConfigurationCommand/
+ */
+export class GetObjectLockConfigurationCommandHandler {
+    buckets;
+    authorizer;
+    background;
+    constructor(properties) {
+        const { buckets, iam = new SimIamAllowAllAuth(), background = new BackgroundTasks(), } = properties;
+        this.buckets = buckets;
+        this.authorizer = new SimS3ObjectLockAuthorizer({ iam });
+        this.background = background;
+    }
+    /**
+     * Report how a Bucket is locked.
+     *
+     * A Bucket that has never had Object Lock is answered with
+     * `ObjectLockConfigurationNotFoundError`, as real S3 answers one, rather
+     * than with a configuration saying it is off.
+     */
+    async handle(command, options) {
+        const { Bucket } = command.input;
+        assertDefined(Bucket, "GetObjectLockConfigurationCommand.input.Bucket");
+        const bucket = requireSimS3Bucket(this.buckets, Bucket);
+        await this.background.sequence();
+        this.authorizer.authorizeReadConfiguration(bucket, options);
+        const configuration = bucket.getObjectLock().configuration;
+        if (configuration === undefined) {
+            throw new SimS3ObjectLockConfigurationNotFound(`S3 Bucket ${Bucket} does not have an Object Lock configuration`);
+        }
+        return { ObjectLockConfiguration: configuration.reported, $metadata: {} };
+    }
+}

package/dist/service/s3/command/head-object/head-object-loader.d.ts

@@ -12,5 +12,5 @@ export declare class HeadObjectLoader {
     /**
      * Describe an Object in the resolved Bucket.
      */
-    describe(bucket: SimS3Bucket, key: string): Promise<SimHeadObjectCommandOutput>;
+    describe(bucket: SimS3Bucket, key: string, versionId?: string): Promise<SimHeadObjectCommandOutput>;
 }

package/dist/service/s3/command/head-object/head-object-loader.js

@@ -1,5 +1,6 @@
 import { SimS3NotFound } from "../../error/sim-s3.error.js";
 import { simS3QuotedETag } from "../../object/s3-object-etag.js";
+import { simS3ReadObjectVersion } from "../object/sim-s3-read-object-version.js";
 /**
  * Describes an authorized S3 Object without reading it out.
  *
@@ -12,17 +13,20 @@ export class HeadObjectLoader {
     /**
      * Describe an Object in the resolved Bucket.
      */
-    async describe(bucket, key) {
-        const object = await bucket.getObject(key);
-        if (object === undefined) {
+    async describe(bucket, key, versionId) {
+        const read = await simS3ReadObjectVersion(bucket, key, versionId);
+        if (read === undefined) {
             throw new SimS3NotFound(`No S3 Object named ${key}`);
         }
+        const object = read.object;
         return {
             ...object.metadata.system,
             ContentLength: object.body.length,
             Metadata: object.metadata.userDefined,
             ETag: simS3QuotedETag(object.etag),
             LastModified: object.lastModified,
+            ...(read.versionId !== undefined && { VersionId: read.versionId }),
+            ...read.lock?.reported,
             $metadata: {},
         };
     }

package/dist/service/s3/command/head-object/head-object.command.d.ts

@@ -1,4 +1,5 @@
 import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+import type { SimS3ObjectLockOutput } from "../../bucket/lock/sim-s3-object-lock-output.js";
 import type { SimS3SystemMetadataOutput } from "../../object/s3-system-metadata-read.js";
 /**
  * Minimal structural sim S3 HeadObject command.
@@ -12,6 +13,11 @@ export interface SimHeadObjectCommand {
 export interface SimHeadObjectCommandInput {
     readonly Bucket?: string | undefined;
     readonly Key?: string | undefined;
+    /**
+     * The version to read. A request naming none reads the current version, and
+     * a Bucket keeping no versions answers the Object under the key.
+     */
+    readonly VersionId?: string | undefined;
 }
 /**
  * Minimal structural sim S3 HeadObject output.
@@ -20,10 +26,12 @@ export interface SimHeadObjectCommandInput {
  * the Object itself, so this is a GetObject output without its body and with
  * the length that body would have had.
  */
-export interface SimHeadObjectCommandOutput extends SimS3SystemMetadataOutput {
+export interface SimHeadObjectCommandOutput extends SimS3SystemMetadataOutput, SimS3ObjectLockOutput {
     readonly ContentLength?: number;
     readonly Metadata?: Record<string, string>;
     readonly ETag?: string;
     readonly LastModified?: Date;
+    /** The version described, on a Bucket keeping versions. */
+    readonly VersionId?: string | undefined;
     readonly $metadata: SimResponseMetadata;
 }

package/dist/service/s3/command/head-object/head-object.handler.js

@@ -44,6 +44,6 @@ export class HeadObjectCommandHandler {
         // Authorization runs before the key is looked up, so a denied caller
         // cannot learn whether an Object exists.
         this.authorizer.authorize(bucket, command.input.Key, options);
-        return await this.loader.describe(bucket, command.input.Key);
+        return await this.loader.describe(bucket, command.input.Key, command.input.VersionId);
     }
 }

package/dist/service/s3/command/list-object-versions/list-object-versions-listing.d.ts

@@ -0,0 +1,31 @@
+import type { SimS3Bucket } from "../../bucket/sim-s3-bucket.js";
+import { SimS3ObjectVersion } from "../../bucket/versioning/sim-s3-object-version.js";
+import type { SimS3DeleteMarkerSummary, SimS3ObjectVersionSummary } from "./list-object-versions.command.js";
+/**
+ * The versions a listing reports, and how it describes each of them.
+ *
+ * A Bucket that keeps no versions still answers this operation. Real S3 gives
+ * every Object in one the null version id and marks it latest, so the listing
+ * of an unversioned Bucket reads as a version history one entry deep rather
+ * than as an error or an empty response.
+ */
+export declare class ListObjectVersionsListing {
+    private readonly bucket;
+    constructor(bucket: SimS3Bucket);
+    /**
+     * Every version under a prefix, in the order a listing reports them.
+     */
+    versions(prefix?: string): Promise<readonly SimS3ObjectVersion[]>;
+    /**
+     * Describe the Objects among a page of versions.
+     */
+    objectSummaries(page: readonly SimS3ObjectVersion[]): readonly SimS3ObjectVersionSummary[];
+    /**
+     * Describe the delete markers among a page of versions.
+     */
+    deleteMarkerSummaries(page: readonly SimS3ObjectVersion[]): readonly SimS3DeleteMarkerSummary[];
+    /**
+     * Whether a version is the one a read of its key answers with.
+     */
+    private isLatest;
+}

package/dist/service/s3/command/list-object-versions/list-object-versions-listing.js

@@ -0,0 +1,55 @@
+import { compareSimS3Keys } from "../../bucket/versioning/sim-s3-compare-keys.js";
+import { SimS3ObjectVersion } from "../../bucket/versioning/sim-s3-object-version.js";
+import { simS3DeleteMarkerSummaries, simS3ObjectVersionSummaries, } from "./list-object-versions-summaries.js";
+/**
+ * The versions a listing reports, and how it describes each of them.
+ *
+ * A Bucket that keeps no versions still answers this operation. Real S3 gives
+ * every Object in one the null version id and marks it latest, so the listing
+ * of an unversioned Bucket reads as a version history one entry deep rather
+ * than as an error or an empty response.
+ */
+export class ListObjectVersionsListing {
+    bucket;
+    constructor(bucket) {
+        this.bucket = bucket;
+    }
+    /**
+     * Every version under a prefix, in the order a listing reports them.
+     */
+    async versions(prefix) {
+        // Read the Objects first either way. That is what applies the lifecycle
+        // rules, and on a versioned Bucket it writes the delete marker an expiry
+        // leaves behind. Reading the history without it would report a version the
+        // rules have already expired as the current one.
+        const objects = await this.bucket.listObjects(prefix);
+        if (this.bucket.getVersions().keepsVersions) {
+            return this.bucket.getVersions().list(prefix);
+        }
+        return objects
+            .toSorted((left, right) => compareSimS3Keys(left.key, right.key))
+            .map((object) => SimS3ObjectVersion.nullVersionOf(object));
+    }
+    /**
+     * Describe the Objects among a page of versions.
+     */
+    objectSummaries(page) {
+        return simS3ObjectVersionSummaries(page, (version) => this.isLatest(version));
+    }
+    /**
+     * Describe the delete markers among a page of versions.
+     */
+    deleteMarkerSummaries(page) {
+        return simS3DeleteMarkerSummaries(page, (version) => this.isLatest(version));
+    }
+    /**
+     * Whether a version is the one a read of its key answers with.
+     */
+    isLatest(version) {
+        const versions = this.bucket.getVersions();
+        if (!versions.keepsVersions) {
+            return true;
+        }
+        return versions.current(version.key)?.versionId === version.versionId;
+    }
+}

package/dist/service/s3/command/list-object-versions/list-object-versions-summaries.d.ts

@@ -0,0 +1,17 @@
+import type { SimS3ObjectVersion } from "../../bucket/versioning/sim-s3-object-version.js";
+import type { SimS3DeleteMarkerSummary, SimS3ObjectVersionSummary } from "./list-object-versions.command.js";
+/**
+ * Whether a version is the one a read of its key answers with.
+ */
+export type SimS3IsLatestVersion = (version: SimS3ObjectVersion) => boolean;
+/**
+ * Describe the Objects among a page of versions.
+ */
+export declare function simS3ObjectVersionSummaries(page: readonly SimS3ObjectVersion[], isLatest: SimS3IsLatestVersion): readonly SimS3ObjectVersionSummary[];
+/**
+ * Describe the delete markers among a page of versions.
+ *
+ * A marker holds no bytes, so it carries neither a size nor an ETag, which is
+ * why real S3 sends the two kinds in separate lists.
+ */
+export declare function simS3DeleteMarkerSummaries(page: readonly SimS3ObjectVersion[], isLatest: SimS3IsLatestVersion): readonly SimS3DeleteMarkerSummary[];

package/dist/service/s3/command/list-object-versions/list-object-versions-summaries.js

@@ -0,0 +1,34 @@
+import { simS3QuotedETag } from "../../object/s3-object-etag.js";
+import { simS3DefaultStorageClass } from "../../object/s3-object-summary.js";
+/**
+ * Describe the Objects among a page of versions.
+ */
+export function simS3ObjectVersionSummaries(page, isLatest) {
+    return page
+        .filter((version) => !version.isDeleteMarker)
+        .map((version) => ({
+        Key: version.key,
+        VersionId: version.versionId,
+        IsLatest: isLatest(version),
+        LastModified: version.lastModified,
+        ETag: simS3QuotedETag(version.object.etag),
+        Size: version.object.body.length,
+        StorageClass: simS3DefaultStorageClass,
+    }));
+}
+/**
+ * Describe the delete markers among a page of versions.
+ *
+ * A marker holds no bytes, so it carries neither a size nor an ETag, which is
+ * why real S3 sends the two kinds in separate lists.
+ */
+export function simS3DeleteMarkerSummaries(page, isLatest) {
+    return page
+        .filter((version) => version.isDeleteMarker)
+        .map((version) => ({
+        Key: version.key,
+        VersionId: version.versionId,
+        IsLatest: isLatest(version),
+        LastModified: version.lastModified,
+    }));
+}