@kensio/yulin 0.37.0 → 0.38.0

package/dist/service/iam/sigv4/canonical/sim-iam-sigv4-payload-hash.js

@@ -1,47 +1,74 @@
 import { createHash } from "node:crypto";
 import { SimIamSignatureDoesNotMatch } from "../error/sim-iam-sigv4.error.js";
+import { simIamSigV4PresignedParameter, simIamSigV4PresignedParameters, } from "../presign/sim-iam-sigv4-presigned-parameters.js";
 export const simIamSigV4UnsignedPayload = "UNSIGNED-PAYLOAD";
-const sha256HeaderName = "x-amz-content-sha256";
+const sha256Name = "x-amz-content-sha256";
 const sha256DigestPattern = /^[\da-f]{64}$/i;
 /**
  * The SHA-256 of an empty body, which SigV4 uses when a request has no body.
  */
 const emptyBodyHash = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855";
 /**
- * Work out the payload hash a signed request was signed with, and check the
- * body it arrived with is the body it claims.
+ * What a signed request declares its body hashes to.
  *
- * A signer states the payload hash in `x-amz-content-sha256`, and that header
- * is itself signed, so the claim cannot be altered without breaking the
- * signature. The claim still has to be checked against the bytes received:
- * without that, a signature would cover only the client's assertion about the
- * body, and the body could be replaced freely.
- *
- * `UNSIGNED-PAYLOAD` is the one declaration that deliberately leaves the body
- * uncovered, and is honoured. Any other non-digest value, including the
- * streaming markers that chunked uploads use, is refused rather than passed
- * through: accepting one would mean serving a request whose body nothing had
- * checked, which is worse than saying the simulator does not support it.
+ * A header-signed request states this in `x-amz-content-sha256`. A presigned
+ * URL states it in the query parameter of the same name, and a presigned URL
+ * that states nothing has an unsigned payload, because a URL is signed before
+ * there is a body to hash. Reading the declaration is the one part of building
+ * a canonical request that differs between the two.
  */
-export function simIamSigV4PayloadHash(headers, body) {
-    const declared = headers.get(sha256HeaderName);
-    if (declared === null || declared.length === 0) {
-        return hashOfBody(body);
+export class SimIamSigV4PayloadDeclaration {
+    declared;
+    constructor(declared) {
+        this.declared = declared;
     }
-    if (declared === simIamSigV4UnsignedPayload) {
-        return declared;
+    /**
+     * The declaration a header-signed request makes.
+     */
+    static fromHeaders(headers) {
+        return new SimIamSigV4PayloadDeclaration(headers.get(sha256Name));
     }
-    if (!sha256DigestPattern.test(declared)) {
-        throw new SimIamSignatureDoesNotMatch(`Signed ${sha256HeaderName} header declares ${declared}, which is ` +
-            `neither a SHA-256 digest nor ${simIamSigV4UnsignedPayload}. ` +
-            `Chunked and streaming payload signing is not simulated.`);
+    /**
+     * The declaration a presigned URL makes, defaulting to an unsigned payload.
+     */
+    static fromPresignedQuery(url) {
+        return new SimIamSigV4PayloadDeclaration(simIamSigV4PresignedParameter(url, simIamSigV4PresignedParameters.contentSha256) ?? simIamSigV4UnsignedPayload);
     }
-    const received = hashOfBody(body);
-    if (received !== declared.toLowerCase()) {
-        throw new SimIamSignatureDoesNotMatch(`Request body hashes to ${received}, not the ${declared} its signed ` +
-            `${sha256HeaderName} header declares`);
+    /**
+     * Work out the payload hash the request was signed with, and check that the
+     * body it arrived with is the body it claims.
+     *
+     * The declaration is itself signed, so the claim cannot be altered without
+     * breaking the signature. The claim still has to be checked against the bytes
+     * received: without that, a signature would cover only the client's assertion
+     * about the body, and the body could be replaced freely.
+     *
+     * `UNSIGNED-PAYLOAD` is the one declaration that deliberately leaves the body
+     * uncovered, and is honoured. Any other non-digest value, including the
+     * streaming markers that chunked uploads use, is refused rather than passed
+     * through: accepting one would mean serving a request whose body nothing had
+     * checked, which is worse than saying the simulator does not support it.
+     */
+    hashFor(body) {
+        const declared = this.declared;
+        if (declared === null || declared.length === 0) {
+            return hashOfBody(body);
+        }
+        if (declared === simIamSigV4UnsignedPayload) {
+            return declared;
+        }
+        if (!sha256DigestPattern.test(declared)) {
+            throw new SimIamSignatureDoesNotMatch(`Signed ${sha256Name} declares ${declared}, which is neither a ` +
+                `SHA-256 digest nor ${simIamSigV4UnsignedPayload}. Chunked and ` +
+                `streaming payload signing is not simulated.`);
+        }
+        const received = hashOfBody(body);
+        if (received !== declared.toLowerCase()) {
+            throw new SimIamSignatureDoesNotMatch(`Request body hashes to ${received}, not the ${declared} its signed ` +
+                `${sha256Name} declares`);
+        }
+        return declared;
     }
-    return declared;
 }
 function hashOfBody(body) {
     if (body === undefined || body.byteLength === 0) {

package/dist/service/iam/sigv4/canonical/sim-iam-sigv4-payload-hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-iam-sigv4-payload-hash.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/canonical/sim-iam-sigv4-payload-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,aAAa,GACjB,kEAAkE,CAAC;AAErE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,IAA4B;IAE5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAE/C,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ,KAAK,0BAA0B,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,2BAA2B,CACnC,UAAU,gBAAgB,oBAAoB,QAAQ,aAAa;YACjE,gCAAgC,0BAA0B,IAAI;YAC9D,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,QAAQ,KAAK,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,2BAA2B,CACnC,0BAA0B,QAAQ,aAAa,QAAQ,cAAc;YACnE,GAAG,gBAAgB,kBAAkB,CACxC,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,IAA4B;IAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"sim-iam-sigv4-payload-hash.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/canonical/sim-iam-sigv4-payload-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,kDAAkD,CAAC;AAE1D,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAC1C,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,aAAa,GACjB,kEAAkE,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,OAAO,6BAA6B;IACvB,QAAQ,CAAgB;IAEzC,YAAoB,QAAuB;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAgB;QACjC,OAAO,IAAI,6BAA6B,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAQ;QAChC,OAAO,IAAI,6BAA6B,CACtC,6BAA6B,CAC3B,GAAG,EACH,8BAA8B,CAAC,aAAa,CAC7C,IAAI,0BAA0B,CAChC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,IAA4B;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE/B,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,QAAQ,KAAK,0BAA0B,EAAE,CAAC;YAC5C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,2BAA2B,CACnC,UAAU,UAAU,aAAa,QAAQ,uBAAuB;gBAC9D,sBAAsB,0BAA0B,gBAAgB;gBAChE,6CAA6C,CAChD,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,QAAQ,KAAK,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,2BAA2B,CACnC,0BAA0B,QAAQ,aAAa,QAAQ,cAAc;gBACnE,GAAG,UAAU,WAAW,CAC3B,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,SAAS,UAAU,CAAC,IAA4B;IAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/service/iam/sigv4/error/sim-iam-sigv4.error.d.ts

@@ -4,7 +4,7 @@
  * These are the codes real AWS returns, so a caller handling a rejection can
  * treat a simulated one exactly as it treats the real thing.
  */
-export type SimIamSigV4ErrorCode = "ExpiredToken" | "IncompleteSignature" | "InvalidClientTokenId" | "SignatureDoesNotMatch";
+export type SimIamSigV4ErrorCode = "AccessDenied" | "ExpiredToken" | "IncompleteSignature" | "InvalidClientTokenId" | "SignatureDoesNotMatch";
 /**
  * Base error for a rejected SigV4 signed request.
  */
@@ -33,6 +33,18 @@ export declare class SimIamInvalidClientTokenId extends SimIamSigV4Error {
 export declare class SimIamExpiredToken extends SimIamSigV4Error {
     constructor(message: string);
 }
+/**
+ * Raised when a presigned URL is used after the window it was signed for.
+ *
+ * The window is judged in simulated time, so a test that freezes the clock
+ * keeps a URL usable however long it spends, and one that advances the clock
+ * past `X-Amz-Expires` sees exactly what a real expired link does. The AWS
+ * error code is the one real S3 answers an expired presigned URL with, which
+ * is `AccessDenied` rather than anything naming expiry.
+ */
+export declare class SimIamPresignedRequestExpired extends SimIamSigV4Error {
+    constructor(message: string);
+}
 /**
  * Raised when a signature was made for a different service or Region than the
  * endpoint it arrived at.

package/dist/service/iam/sigv4/error/sim-iam-sigv4.error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-iam-sigv4.error.d.ts","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/error/sim-iam-sigv4.error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,CAAC;AAE5B;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,oBAAoB,CAAC;IAE3C,YAAY,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAItD;CACF;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;;;;;;GAUG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,gBAAgB;IAC/D,SAAgB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEtD,YAAY,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAGrD;CACF"}
+{"version":3,"file":"sim-iam-sigv4.error.d.ts","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/error/sim-iam-sigv4.error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,cAAc,GACd,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,CAAC;AAE5B;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,oBAAoB,CAAC;IAE3C,YAAY,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAItD;CACF;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;;;;GAQG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;;;;;;GAUG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,gBAAgB;IAC/D,SAAgB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEtD,YAAY,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAGrD;CACF"}

package/dist/service/iam/sigv4/error/sim-iam-sigv4.error.js

@@ -36,6 +36,20 @@ export class SimIamExpiredToken extends SimIamSigV4Error {
         super("ExpiredToken", message);
     }
 }
+/**
+ * Raised when a presigned URL is used after the window it was signed for.
+ *
+ * The window is judged in simulated time, so a test that freezes the clock
+ * keeps a URL usable however long it spends, and one that advances the clock
+ * past `X-Amz-Expires` sees exactly what a real expired link does. The AWS
+ * error code is the one real S3 answers an expired presigned URL with, which
+ * is `AccessDenied` rather than anything naming expiry.
+ */
+export class SimIamPresignedRequestExpired extends SimIamSigV4Error {
+    constructor(message) {
+        super("AccessDenied", message);
+    }
+}
 /**
  * Raised when a signature was made for a different service or Region than the
  * endpoint it arrived at.

package/dist/service/iam/sigv4/error/sim-iam-sigv4.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-iam-sigv4.error.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/error/sim-iam-sigv4.error.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzB,IAAI,CAAuB;IAE3C,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAC7D,YAAY,OAAe;QACzB,KAAK,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,OAAe;QACzB,KAAK,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,OAAe;QACzB,KAAK,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,gBAAgB;IAC/C,gBAAgB,CAAsB;IAEtD,YAAY,OAAe,EAAE,gBAAyB;QACpD,KAAK,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF"}
+{"version":3,"file":"sim-iam-sigv4.error.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/error/sim-iam-sigv4.error.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzB,IAAI,CAAuB;IAE3C,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAC7D,YAAY,OAAe;QACzB,KAAK,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,OAAe;QACzB,KAAK,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,OAAe;QACzB,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,OAAe;QACzB,KAAK,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,gBAAgB;IAC/C,gBAAgB,CAAsB;IAEtD,YAAY,OAAe,EAAE,gBAAyB;QACpD,KAAK,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;CACF"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-credential.d.ts

@@ -0,0 +1,25 @@
+import { SimIamSigV4CredentialScope } from "../sim-iam-sigv4-credential-scope.js";
+/**
+ * The access key and scope a presigned URL's `X-Amz-Credential` names.
+ *
+ * The same `<access-key-id>/<scope>` pair an Authorization header carries,
+ * written into a query parameter instead.
+ */
+export declare class SimIamSigV4PresignedCredential {
+    readonly accessKeyId: string;
+    readonly scope: SimIamSigV4CredentialScope;
+    private constructor();
+    /**
+     * Split a credential value, or fail saying what shape it should have been.
+     */
+    static parse(value: string): SimIamSigV4PresignedCredential;
+}
+/**
+ * Refuse a presigned URL made with a signing algorithm that is not simulated.
+ *
+ * Naming the algorithm is worth doing because the alternative is a signature
+ * mismatch with nothing to act on: SigV4A URLs look identical apart from this
+ * parameter.
+ */
+export declare function simIamSigV4CheckPresignedAlgorithm(algorithm: string): void;
+//# sourceMappingURL=sim-iam-sigv4-presigned-credential.d.ts.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-credential.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-credential.d.ts","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-credential.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF;;;;;GAKG;AACH,qBAAa,8BAA8B;IACzC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,KAAK,EAAE,0BAA0B,CAAC;IAElD,OAAO,eAGN;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,8BAA8B,CAc1D;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQ1E"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-credential.js

@@ -0,0 +1,41 @@
+import { SimIamIncompleteSignature } from "../error/sim-iam-sigv4.error.js";
+import { simIamSigV4Algorithm } from "../sim-iam-sigv4-authorization.js";
+import { SimIamSigV4CredentialScope } from "../sim-iam-sigv4-credential-scope.js";
+/**
+ * The access key and scope a presigned URL's `X-Amz-Credential` names.
+ *
+ * The same `<access-key-id>/<scope>` pair an Authorization header carries,
+ * written into a query parameter instead.
+ */
+export class SimIamSigV4PresignedCredential {
+    accessKeyId;
+    scope;
+    constructor(accessKeyId, scope) {
+        this.accessKeyId = accessKeyId;
+        this.scope = scope;
+    }
+    /**
+     * Split a credential value, or fail saying what shape it should have been.
+     */
+    static parse(value) {
+        const separator = value.indexOf("/");
+        if (separator < 1) {
+            throw new SimIamIncompleteSignature(`Presigned URL X-Amz-Credential ${value} must be ` +
+                `<access-key-id>/<scope>`);
+        }
+        return new SimIamSigV4PresignedCredential(value.slice(0, separator), SimIamSigV4CredentialScope.parse(value.slice(separator + 1)));
+    }
+}
+/**
+ * Refuse a presigned URL made with a signing algorithm that is not simulated.
+ *
+ * Naming the algorithm is worth doing because the alternative is a signature
+ * mismatch with nothing to act on: SigV4A URLs look identical apart from this
+ * parameter.
+ */
+export function simIamSigV4CheckPresignedAlgorithm(algorithm) {
+    if (algorithm !== simIamSigV4Algorithm) {
+        throw new SimIamIncompleteSignature(`Presigned URL X-Amz-Algorithm ${algorithm} is not ${simIamSigV4Algorithm}`);
+    }
+}
+//# sourceMappingURL=sim-iam-sigv4-presigned-credential.js.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-credential.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-credential.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-credential.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,OAAO,8BAA8B;IACzB,WAAW,CAAS;IACpB,KAAK,CAA6B;IAElD,YAAoB,WAAmB,EAAE,KAAiC;QACxE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa;QACxB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAErC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,yBAAyB,CACjC,kCAAkC,KAAK,WAAW;gBAChD,yBAAyB,CAC5B,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,8BAA8B,CACvC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EACzB,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAC7D,CAAC;IACJ,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAAC,SAAiB;IAClE,IAAI,SAAS,KAAK,oBAAoB,EAAE,CAAC;QACvC,MAAM,IAAI,yBAAyB,CACjC,iCAAiC,SAAS,WACxC,oBACF,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-parameters.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The query parameters a presigned URL states its signature in.
+ *
+ * Names are matched without regard to case, as the canonical query builder
+ * already excludes the signature parameter without regard to case. Signers
+ * emit the `X-Amz-` spelling, and nothing is gained by refusing a client that
+ * lower-cases them on the way.
+ */
+export declare const simIamSigV4PresignedParameters: {
+    readonly algorithm: "x-amz-algorithm";
+    readonly credential: "x-amz-credential";
+    readonly date: "x-amz-date";
+    readonly expires: "x-amz-expires";
+    readonly signedHeaders: "x-amz-signedheaders";
+    readonly signature: "x-amz-signature";
+    readonly securityToken: "x-amz-security-token";
+    readonly contentSha256: "x-amz-content-sha256";
+};
+/**
+ * Read a parameter the signature cannot be rebuilt without.
+ */
+export declare function simIamSigV4RequiredPresignedParameter(url: URL, name: string): string;
+/**
+ * Read one presigned parameter from a URL, whatever case it was written in.
+ */
+export declare function simIamSigV4PresignedParameter(url: URL, name: string): string | undefined;
+//# sourceMappingURL=sim-iam-sigv4-presigned-parameters.d.ts.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-parameters.d.ts","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-parameters.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;aACzC,SAAS,EAAE,iBAAiB;aAC5B,UAAU,EAAE,kBAAkB;aAC9B,IAAI,EAAE,YAAY;aAClB,OAAO,EAAE,eAAe;aACxB,aAAa,EAAE,qBAAqB;aACpC,SAAS,EAAE,iBAAiB;aAC5B,aAAa,EAAE,sBAAsB;aACrC,aAAa,EAAE,sBAAsB;CAC7B,CAAC;AAEX;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,MAAM,GACX,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAQpB"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-parameters.js

@@ -0,0 +1,41 @@
+import { SimIamIncompleteSignature } from "../error/sim-iam-sigv4.error.js";
+/**
+ * The query parameters a presigned URL states its signature in.
+ *
+ * Names are matched without regard to case, as the canonical query builder
+ * already excludes the signature parameter without regard to case. Signers
+ * emit the `X-Amz-` spelling, and nothing is gained by refusing a client that
+ * lower-cases them on the way.
+ */
+export const simIamSigV4PresignedParameters = {
+    algorithm: "x-amz-algorithm",
+    credential: "x-amz-credential",
+    date: "x-amz-date",
+    expires: "x-amz-expires",
+    signedHeaders: "x-amz-signedheaders",
+    signature: "x-amz-signature",
+    securityToken: "x-amz-security-token",
+    contentSha256: "x-amz-content-sha256",
+};
+/**
+ * Read a parameter the signature cannot be rebuilt without.
+ */
+export function simIamSigV4RequiredPresignedParameter(url, name) {
+    const value = simIamSigV4PresignedParameter(url, name);
+    if (value === undefined || value.length === 0) {
+        throw new SimIamIncompleteSignature(`Presigned URL is missing its ${name} parameter`);
+    }
+    return value;
+}
+/**
+ * Read one presigned parameter from a URL, whatever case it was written in.
+ */
+export function simIamSigV4PresignedParameter(url, name) {
+    for (const [key, value] of url.searchParams) {
+        if (key.toLowerCase() === name) {
+            return value;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=sim-iam-sigv4-presigned-parameters.js.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-parameters.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,kBAAkB;IAC9B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,eAAe;IACxB,aAAa,EAAE,qBAAqB;IACpC,SAAS,EAAE,iBAAiB;IAC5B,aAAa,EAAE,sBAAsB;IACrC,aAAa,EAAE,sBAAsB;CAC7B,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,qCAAqC,CACnD,GAAQ,EACR,IAAY;IAEZ,MAAM,KAAK,GAAG,6BAA6B,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,yBAAyB,CACjC,gCAAgC,IAAI,YAAY,CACjD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,GAAQ,EACR,IAAY;IAEZ,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-query.d.ts

@@ -0,0 +1,39 @@
+import type { SimIamSigV4CredentialScope } from "../sim-iam-sigv4-credential-scope.js";
+import type { SimIamSigV4SignatureStatement } from "../sim-iam-sigv4-signature-statement.js";
+/**
+ * The signature a presigned URL carries in its query string.
+ *
+ * A presigned URL states in query parameters exactly what an `Authorization`
+ * header states, plus the lifetime it was signed for. That is the whole of the
+ * difference: the canonical request, the signing key and the comparison are
+ * the same work, which is why this is a second way of reading a signature
+ * rather than a second way of verifying one.
+ */
+export declare class SimIamSigV4PresignedQuery implements SimIamSigV4SignatureStatement {
+    readonly accessKeyId: string;
+    readonly scope: SimIamSigV4CredentialScope;
+    readonly signedHeaderNames: readonly string[];
+    readonly signature: string;
+    readonly amzDate: string;
+    readonly sessionToken: string | undefined;
+    private readonly window;
+    private constructor();
+    /**
+     * Whether a URL offers a presigned signature to verify.
+     *
+     * Presence of `X-Amz-Algorithm` is the test, not its value. A request
+     * carrying that parameter is unambiguously an attempt at a presigned URL, so
+     * an unsupported algorithm belongs in a refusal that says so rather than in
+     * a silent fall through to anonymous.
+     */
+    static carriedBy(url: URL): boolean;
+    /**
+     * Read a presigned URL's signature, or fail describing what was missing.
+     */
+    static parse(url: URL): SimIamSigV4PresignedQuery;
+    /**
+     * Refuse this URL if simulated time has passed the window it was signed for.
+     */
+    checkNotExpired(now: Date): void;
+}
+//# sourceMappingURL=sim-iam-sigv4-presigned-query.d.ts.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-query.d.ts","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AAY7F;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,6BAA6B;IAC7E,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,KAAK,EAAE,0BAA0B,CAAC;IAClD,SAAgB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,OAAO,eA4BN;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAIlC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,yBAAyB,CAEhD;IAED;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAE/B;CACF"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-query.js

@@ -0,0 +1,59 @@
+import { simIamSigV4CheckedAmzDate } from "../sim-iam-sigv4-request-date.js";
+import { simIamSigV4CheckPresignedAlgorithm, SimIamSigV4PresignedCredential, } from "./sim-iam-sigv4-presigned-credential.js";
+import { simIamSigV4PresignedParameter, simIamSigV4PresignedParameters as parameters, simIamSigV4RequiredPresignedParameter as required, } from "./sim-iam-sigv4-presigned-parameters.js";
+import { SimIamSigV4PresignedWindow } from "./sim-iam-sigv4-presigned-window.js";
+/**
+ * The signature a presigned URL carries in its query string.
+ *
+ * A presigned URL states in query parameters exactly what an `Authorization`
+ * header states, plus the lifetime it was signed for. That is the whole of the
+ * difference: the canonical request, the signing key and the comparison are
+ * the same work, which is why this is a second way of reading a signature
+ * rather than a second way of verifying one.
+ */
+export class SimIamSigV4PresignedQuery {
+    accessKeyId;
+    scope;
+    signedHeaderNames;
+    signature;
+    amzDate;
+    sessionToken;
+    window;
+    constructor(url) {
+        simIamSigV4CheckPresignedAlgorithm(required(url, parameters.algorithm));
+        const credential = SimIamSigV4PresignedCredential.parse(required(url, parameters.credential));
+        this.accessKeyId = credential.accessKeyId;
+        this.scope = credential.scope;
+        this.amzDate = simIamSigV4CheckedAmzDate(simIamSigV4PresignedParameter(url, parameters.date) ?? null, this.scope, "X-Amz-Date parameter");
+        this.signedHeaderNames = required(url, parameters.signedHeaders)
+            .split(";")
+            .map((name) => name.toLowerCase());
+        this.signature = required(url, parameters.signature);
+        this.sessionToken = simIamSigV4PresignedParameter(url, parameters.securityToken);
+        this.window = new SimIamSigV4PresignedWindow(this.amzDate, SimIamSigV4PresignedWindow.expirySeconds(simIamSigV4PresignedParameter(url, parameters.expires)));
+    }
+    /**
+     * Whether a URL offers a presigned signature to verify.
+     *
+     * Presence of `X-Amz-Algorithm` is the test, not its value. A request
+     * carrying that parameter is unambiguously an attempt at a presigned URL, so
+     * an unsupported algorithm belongs in a refusal that says so rather than in
+     * a silent fall through to anonymous.
+     */
+    static carriedBy(url) {
+        return (simIamSigV4PresignedParameter(url, parameters.algorithm) !== undefined);
+    }
+    /**
+     * Read a presigned URL's signature, or fail describing what was missing.
+     */
+    static parse(url) {
+        return new SimIamSigV4PresignedQuery(url);
+    }
+    /**
+     * Refuse this URL if simulated time has passed the window it was signed for.
+     */
+    checkNotExpired(now) {
+        this.window.checkNotExpired(now);
+    }
+}
+//# sourceMappingURL=sim-iam-sigv4-presigned-query.js.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-query.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,OAAO,EACL,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,IAAI,UAAU,EAC5C,qCAAqC,IAAI,QAAQ,GAClD,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAAyB;IACpB,WAAW,CAAS;IACpB,KAAK,CAA6B;IAClC,iBAAiB,CAAoB;IACrC,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,YAAY,CAAqB;IAEhC,MAAM,CAA6B;IAEpD,YAAoB,GAAQ;QAC1B,kCAAkC,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QAExE,MAAM,UAAU,GAAG,8BAA8B,CAAC,KAAK,CACrD,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,CACrC,CAAC;QAEF,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,yBAAyB,CACtC,6BAA6B,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAC3D,IAAI,CAAC,KAAK,EACV,sBAAsB,CACvB,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,aAAa,CAAC;aAC7D,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY,GAAG,6BAA6B,CAC/C,GAAG,EACH,UAAU,CAAC,aAAa,CACzB,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,0BAA0B,CAC1C,IAAI,CAAC,OAAO,EACZ,0BAA0B,CAAC,aAAa,CACtC,6BAA6B,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CACvD,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,GAAQ;QACvB,OAAO,CACL,6BAA6B,CAAC,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,SAAS,CACvE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAQ;QACnB,OAAO,IAAI,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,GAAS;QACvB,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-window.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The window of time a presigned URL is usable in.
+ *
+ * A presigned URL is the one signed request that carries its own lifetime:
+ * `X-Amz-Expires` says how many seconds after `X-Amz-Date` it stops working.
+ * Both are signed, so neither can be stretched by whoever holds the URL.
+ */
+export declare class SimIamSigV4PresignedWindow {
+    private readonly signedAt;
+    private readonly expiresSeconds;
+    constructor(amzDate: string, expiresSeconds: number);
+    /**
+     * Read the stated lifetime, refusing one AWS would not have signed.
+     *
+     * AWS caps a presigned lifetime at seven days, so a longer one cannot have
+     * come from a signer this simulation should accept. Refusing it here is the
+     * fail-closed answer: honouring it would let a test prove a URL works that
+     * real S3 would never have issued.
+     */
+    static expirySeconds(value: string | undefined): number;
+    /**
+     * The instant this URL stops working.
+     */
+    expiresAt(): Date;
+    /**
+     * Refuse a URL used after its window, in simulated time.
+     */
+    checkNotExpired(now: Date): void;
+}
+//# sourceMappingURL=sim-iam-sigv4-presigned-window.d.ts.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-window.d.ts","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-window.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAO;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,YAAY,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAGlD;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAuBtD;IAED;;OAEG;IACH,SAAS,IAAI,IAAI,CAEhB;IAED;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAa/B;CACF"}

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-window.js

@@ -0,0 +1,64 @@
+import { SimIamIncompleteSignature, SimIamPresignedRequestExpired, } from "../error/sim-iam-sigv4.error.js";
+import { simIamSigV4SignedAt } from "../sim-iam-sigv4-request-date.js";
+/**
+ * The longest window AWS will presign for, seven days in seconds.
+ */
+const maximumExpirySeconds = 604_800;
+const secondsPattern = /^\d+$/;
+/**
+ * The window of time a presigned URL is usable in.
+ *
+ * A presigned URL is the one signed request that carries its own lifetime:
+ * `X-Amz-Expires` says how many seconds after `X-Amz-Date` it stops working.
+ * Both are signed, so neither can be stretched by whoever holds the URL.
+ */
+export class SimIamSigV4PresignedWindow {
+    signedAt;
+    expiresSeconds;
+    constructor(amzDate, expiresSeconds) {
+        this.signedAt = simIamSigV4SignedAt(amzDate);
+        this.expiresSeconds = expiresSeconds;
+    }
+    /**
+     * Read the stated lifetime, refusing one AWS would not have signed.
+     *
+     * AWS caps a presigned lifetime at seven days, so a longer one cannot have
+     * come from a signer this simulation should accept. Refusing it here is the
+     * fail-closed answer: honouring it would let a test prove a URL works that
+     * real S3 would never have issued.
+     */
+    static expirySeconds(value) {
+        if (value === undefined || value.length === 0) {
+            throw new SimIamIncompleteSignature("Presigned URL carries no X-Amz-Expires parameter");
+        }
+        if (!secondsPattern.test(value)) {
+            throw new SimIamIncompleteSignature(`Presigned URL X-Amz-Expires ${value} must be a whole number of seconds`);
+        }
+        const seconds = Number(value);
+        if (seconds < 1 || seconds > maximumExpirySeconds) {
+            throw new SimIamIncompleteSignature(`Presigned URL X-Amz-Expires ${value} is outside the 1 to ` +
+                `${String(maximumExpirySeconds)} seconds AWS signs for`);
+        }
+        return seconds;
+    }
+    /**
+     * The instant this URL stops working.
+     */
+    expiresAt() {
+        return new Date(this.signedAt.getTime() + this.expiresSeconds * 1000);
+    }
+    /**
+     * Refuse a URL used after its window, in simulated time.
+     */
+    checkNotExpired(now) {
+        const expiresAt = this.expiresAt();
+        if (now.getTime() <= expiresAt.getTime()) {
+            return;
+        }
+        throw new SimIamPresignedRequestExpired(`Request has expired. The presigned URL was signed at ` +
+            `${this.signedAt.toISOString()} for ${String(this.expiresSeconds)} ` +
+            `seconds, so it expired at ${expiresAt.toISOString()}, and simulated ` +
+            `time is now ${now.toISOString()}.`);
+    }
+}
+//# sourceMappingURL=sim-iam-sigv4-presigned-window.js.map

package/dist/service/iam/sigv4/presign/sim-iam-sigv4-presigned-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-sigv4-presigned-window.js","sourceRoot":"","sources":["../../../../../src/service/iam/sigv4/presign/sim-iam-sigv4-presigned-window.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAErC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,OAAO,0BAA0B;IACpB,QAAQ,CAAO;IACf,cAAc,CAAS;IAExC,YAAY,OAAe,EAAE,cAAsB;QACjD,IAAI,CAAC,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAAC,KAAyB;QAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,yBAAyB,CACjC,kDAAkD,CACnD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,yBAAyB,CACjC,+BAA+B,KAAK,oCAAoC,CACzE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAE9B,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,oBAAoB,EAAE,CAAC;YAClD,MAAM,IAAI,yBAAyB,CACjC,+BAA+B,KAAK,uBAAuB;gBACzD,GAAG,MAAM,CAAC,oBAAoB,CAAC,wBAAwB,CAC1D,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,GAAS;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEnC,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,6BAA6B,CACrC,uDAAuD;YACrD,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG;YACpE,6BAA6B,SAAS,CAAC,WAAW,EAAE,kBAAkB;YACtE,eAAe,GAAG,CAAC,WAAW,EAAE,GAAG,CACtC,CAAC;IACJ,CAAC;CACF"}

package/dist/service/iam/sigv4/sim-iam-sigv4-authorization.d.ts

@@ -1,4 +1,5 @@
 import { SimIamSigV4CredentialScope } from "./sim-iam-sigv4-credential-scope.js";
+import type { SimIamSigV4SignatureStatement } from "./sim-iam-sigv4-signature-statement.js";
 export declare const simIamSigV4Algorithm = "AWS4-HMAC-SHA256";
 interface SimIamSigV4AuthorizationProperties {
     readonly accessKeyId: string;
@@ -13,7 +14,7 @@ interface SimIamSigV4AuthorizationProperties {
  * canonicalize exactly the headers the signer chose, not whichever headers the
  * request happens to carry now.
  */
-export declare class SimIamSigV4Authorization {
+export declare class SimIamSigV4Authorization implements SimIamSigV4SignatureStatement {
     readonly accessKeyId: string;
     readonly scope: SimIamSigV4CredentialScope;
     readonly signedHeaderNames: readonly string[];

package/dist/service/iam/sigv4/sim-iam-sigv4-authorization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-iam-sigv4-authorization.d.ts","sourceRoot":"","sources":["../../../../src/service/iam/sigv4/sim-iam-sigv4-authorization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,wBAAwB;IACnC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,KAAK,EAAE,0BAA0B,CAAC;IAClD,SAAgB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YAAY,UAAU,EAAE,kCAAkC,EAKzD;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,wBAAwB,CAoCjE;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IAiBrB,OAAO,CAAC,MAAM,CAAC,KAAK;CAcrB"}
+{"version":3,"file":"sim-iam-sigv4-authorization.d.ts","sourceRoot":"","sources":["../../../../src/service/iam/sigv4/sim-iam-sigv4-authorization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAE5F,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,6BAA6B;IAC5E,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,KAAK,EAAE,0BAA0B,CAAC;IAClD,SAAgB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YAAY,UAAU,EAAE,kCAAkC,EAKzD;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,wBAAwB,CAoCjE;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IAiBrB,OAAO,CAAC,MAAM,CAAC,KAAK;CAcrB"}

package/dist/service/iam/sigv4/sim-iam-sigv4-authorization.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-iam-sigv4-authorization.js","sourceRoot":"","sources":["../../../../src/service/iam/sigv4/sim-iam-sigv4-authorization.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sim-iam-sigv4-authorization.js","sourceRoot":"","sources":["../../../../src/service/iam/sigv4/sim-iam-sigv4-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAGjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AASvD;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IACnB,WAAW,CAAS;IACpB,KAAK,CAA6B;IAClC,iBAAiB,CAAoB;IACrC,SAAS,CAAS;IAElC,YAAY,UAA8C;QACxD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAA0B;QACrC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,yBAAyB,CACjC,mDAAmD,CACpD,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEpD,IAAI,SAAS,KAAK,oBAAoB,EAAE,CAAC;YACvC,MAAM,IAAI,yBAAyB,CACjC,kCAAkC,MAAM,CAAC,SAAS,CAAC,WACjD,oBACF,EAAE,CACH,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,yBAAyB,CACjC,mCAAmC,UAAU,WAAW;gBACtD,yBAAyB,CAC5B,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,wBAAwB,CAAC;YAClC,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;YAC3C,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YACxE,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC;iBACnD,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,MAAM,CAAC,KAAa;QACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEzC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAErC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,CAAC,GAAG,CACR,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,EAChC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAClC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,KAAK,CAClB,MAAmC,EACnC,IAAY;QAEZ,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,yBAAyB,CACjC,uCAAuC,IAAI,QAAQ,CACpD,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/service/iam/sigv4/sim-iam-sigv4-request-date.d.ts

@@ -10,7 +10,28 @@ import type { SimIamSigV4CredentialScope } from "./sim-iam-sigv4-credential-scop
  * would buy nothing a caller could assert on, and would break every client that
  * stamps real time and has no way to know what time this simulation is keeping.
  * This is a documented divergence from real AWS, which enforces a five minute
- * window.
+ * window. A presigned URL is the exception: it states its own lifetime in
+ * `X-Amz-Expires`, and that lifetime is enforced, in simulated time.
  */
 export declare function simIamSigV4RequestDate(headers: Headers, scope: SimIamSigV4CredentialScope): string;
+/**
+ * Check a signing stamp from wherever the request carried it.
+ *
+ * A presigned URL states the same value in its query string rather than in a
+ * header, so the source is named by the caller and appears in any complaint
+ * about the stamp.
+ */
+export declare function simIamSigV4CheckedAmzDate(amzDate: string | null, scope: SimIamSigV4CredentialScope, source: string): string;
+/**
+ * The instant an `X-Amz-Date` stamp names.
+ *
+ * The stamp is ISO 8601 basic form, which `Date` does not parse, so the
+ * separators of the extended form are put back before it is read.
+ *
+ * The result is checked to name the day and time it was built from. Digits
+ * alone do not make a date: `Date` reads 24:60:00 as no instant at all, and
+ * quietly rolls February 30th forward into March, which would give a presigned
+ * URL a window nothing signed. Both are refused rather than honoured.
+ */
+export declare function simIamSigV4SignedAt(amzDate: string): Date;
 //# sourceMappingURL=sim-iam-sigv4-request-date.d.ts.map