@kensio/yulin 1.21.3 → 1.21.5

package/dist/service/cloudformation/template/sim-cfn-template.js

@@ -5,6 +5,7 @@ import { SimCfnTemplateBodyValidator } from "./sim-cfn-template-body-validator.j
 import { parseSimCfnTemplateBody } from "./sim-cfn-template-body-parse.js";
 import { SimCfnPseudoParameters } from "../parameters/pseudo/sim-cfn-pseudo-parameters.js";
 import { SimCfnConditionEvaluator } from "./condition/sim-cfn-condition-evaluator.js";
+import { SimCfnOutputConditions } from "./condition/sim-cfn-output-conditions.js";
 import { SimCfnResourceConditions } from "./condition/sim-cfn-resource-conditions.js";
 import { samExpandedTemplate } from "../sam/sim-cfn-sam-expansion.js";
 /**
@@ -15,15 +16,18 @@ import { samExpandedTemplate } from "../sam/sim-cfn-sam-expansion.js";
 export class SimCfnTemplate {
     template;
     stackName;
+    /** The unique ID of the Stack this template is being deployed as. */
+    stackId;
     parameters;
     /** The export names a Stack deployed from this template can import. */
     exports;
     accountRegionScope;
     evaluatedConditions;
     constructor(properties) {
-        const { template, parameters, stackName, accountRegionScope, exports } = properties;
+        const { template, parameters, stackName, stackId, accountRegionScope, exports, } = properties;
         this.template = template;
         this.stackName = stackName;
+        this.stackId = stackId;
         this.accountRegionScope = accountRegionScope;
         this.exports = exports;
         const validator = new SimCfnTemplateBodyValidator({ template, stackName });
@@ -49,6 +53,7 @@ export class SimCfnTemplate {
             template: samExpandedTemplate(template),
             parameters: properties.parameters,
             stackName: properties.stackName,
+            stackId: properties.stackId,
             accountRegionScope: properties.accountRegionScope,
             exports: properties.exports,
         });
@@ -86,13 +91,21 @@ export class SimCfnTemplate {
      *
      * Resource-backed intrinsic functions are left unresolved here because
      * Outputs are resolved after Resource creation.
+     *
+     * An Output whose `Condition` attribute is false is left out entirely, so it
+     * never reaches the Stack's Outputs and publishes no export.
      */
     outputTemplates() {
         const valueResolver = this.valueResolver();
+        const outputConditions = new SimCfnOutputConditions({
+            conditions: this.conditions(),
+            stackName: this.stackName,
+        });
         return Object.entries(this.template.Outputs ?? {})
             .filter((entry) => {
             return isRecord(entry[1]);
         })
+            .filter(([outputKey, outputTemplate]) => !outputConditions.excludes(outputKey, outputTemplate))
             .map(([outputKey, outputTemplate]) => ({
             outputKey,
             template: valueResolver.resolveRecordFor(`Sim CloudFormation Output ${outputKey}`, outputTemplate),
@@ -107,6 +120,7 @@ export class SimCfnTemplate {
         return new SimCfnPseudoParameters({
             accountRegionScope: this.accountRegionScope,
             stackName: this.stackName,
+            stackId: this.stackId,
         });
     }
     /**

package/dist/service/cloudfront/origin/custom/sim-cf-custom-origin-request.d.ts

@@ -1,8 +1,10 @@
+import type { SimCloudFrontBehavior } from "../../behaviour/sim-cloud-front-behavior.js";
 import type { SimCfForwardedToOrigin } from "../../origin-request-policy/sim-cf-forwarded-to-origin.js";
 interface SimCfCustomOriginRequestProperties {
     readonly domainName: string;
     readonly originPath: string;
     readonly request: Request;
+    readonly viewerProtocolPolicy?: SimCloudFrontBehavior["viewerProtocolPolicy"] | undefined;
     /**
      * What the Behavior's cache policy and origin request policy carry to the
      * Origin between them.

package/dist/service/cloudfront/origin/custom/sim-cf-custom-origin-request.js

@@ -1,4 +1,5 @@
 import { SimAwsLocalUrl } from "../../../../serve/http/url/sim-aws-local-url.js";
+import { isSimAwsLocalRequest, simAwsRequestHostname, } from "../../../../serve/http/url/sim-aws-request-hostname.js";
 import { stripSimAwsControlHeaders } from "../../../iam/request/sim-aws-control-headers.js";
 import { simCfForwardedOriginHeaders, simCfForwardedOriginSearch, } from "./sim-cf-custom-origin-forwarding.js";
 /**
@@ -23,6 +24,7 @@ export function simCfCustomOriginRequest(properties) {
     originUrl.pathname = originRequestPath(properties.originPath, viewerUrl.pathname);
     originUrl.search = simCfForwardedOriginSearch(viewerUrl.search, forwarded);
     const headers = simCfForwardedOriginHeaders(request.headers, forwarded);
+    applyAwsFacingViewerOrigin(headers, request, properties.viewerProtocolPolicy);
     headers.set("host", originUrl.host);
     // Who the Origin request is from is the Origin's business, not the viewer's,
     // so a viewer's own control headers are dropped before the Origin's are
@@ -51,6 +53,53 @@ export function simCfCustomOriginRequest(properties) {
         signal: request.signal,
     });
 }
+/**
+ * Replace the local same-origin value a browser sends with the origin the
+ * viewer would use against CloudFront.
+ *
+ * https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/RequestAndResponseBehaviorCustomOrigin.html
+ */
+function applyAwsFacingViewerOrigin(headers, viewerRequest, viewerProtocolPolicy) {
+    const value = headers.get("origin");
+    if (value === null || !isSimAwsLocalRequest(viewerRequest)) {
+        return;
+    }
+    const origin = originUrl(value);
+    if (origin === undefined || origin.origin !== viewerOrigin(viewerRequest)) {
+        return;
+    }
+    origin.hostname = simAwsRequestHostname(viewerRequest);
+    origin.port = "";
+    if (viewerProtocolPolicy === "redirect-to-https" ||
+        viewerProtocolPolicy === "https-only") {
+        origin.protocol = "https:";
+    }
+    headers.set("origin", origin.origin);
+}
+/**
+ * The local origin the viewer used, including the Host header when it differs
+ * from the Request URL.
+ */
+function viewerOrigin(request) {
+    const url = new URL(request.url);
+    const host = request.headers.get("host");
+    if (host !== null) {
+        url.host = host;
+    }
+    return url.origin;
+}
+/**
+ * Read a serialized Origin without rejecting the request when it is `null` or
+ * malformed. CloudFront forwards those values unchanged.
+ */
+function originUrl(value) {
+    try {
+        return new URL(value);
+    }
+    catch {
+        return undefined;
+    }
+}
 /**
  * Prefix the Origin path to the request path, as CloudFront does.
  */

package/dist/service/cloudfront/origin/custom/sim-cloudfront-custom-origin.js

@@ -60,6 +60,7 @@ export class SimCloudFrontCustomOrigin {
             domainName: this.domainName,
             originPath: this.originPath,
             request: request.req,
+            viewerProtocolPolicy: request.behavior.viewerProtocolPolicy,
             forwarded: simCfBehaviorForwardedToOrigin(request.behavior, this.policies),
             customHeaders: this.customHeaders,
             signingHeaders: this.signer.forRequest(request),

package/dist/service/cloudfront/origin/s3/sim-cf-s3-origin-responses.js

@@ -21,6 +21,7 @@ export class SimCfS3OriginResponses {
     foundObject(object, request) {
         const headers = simS3ObjectResponseHeaders({
             metadata: object.metadata.values,
+            userMetadata: object.metadata.userDefined,
             bodyLength: object.body.length,
             etag: simS3QuotedETag(object.etag),
             lastModified: object.lastModified,

package/dist/service/cognito/serve/page/sim-cognito-provider-page.js

@@ -44,7 +44,7 @@ export class SimCognitoProviderPage {
      */
     claimFields(provider) {
         return simCognitoMappedClaimNames(provider)
-            .map((claimName) => this.markup.field(`${simCognitoClaimFieldPrefix}${claimName}`, `${claimName} claim`, "text", simCognitoDefaultClaim(claimName)))
+            .map((claimName) => this.markup.field(`${simCognitoClaimFieldPrefix}${claimName}`, `${claimName} claim`, "text", simCognitoDefaultClaim(provider, claimName)))
             .join("");
     }
 }

package/dist/service/cognito/user-pool/idp/sim-cognito-attribute-mapping.d.ts

@@ -1,3 +1,4 @@
+import type { SimCognitoAttributeDataTypeValue } from "../schema/sim-cognito-attribute-data-type.js";
 import type { SimCognitoUserPoolSchema } from "../schema/sim-cognito-user-pool-schema.js";
 import type { SimCognitoAttributeType } from "../user/sim-cognito-user-attributes.js";
 import type { SimCognitoExternalUser } from "./sim-cognito-external-user.js";
@@ -25,6 +26,10 @@ export declare class SimCognitoAttributeMapping {
      * This mapping as a described provider reports it.
      */
     toOutput(): SimCognitoAttributeMappingType;
+    /**
+     * The pool attribute types one provider claim is mapped onto.
+     */
+    dataTypesForClaim(claimName: string): readonly SimCognitoAttributeDataTypeValue[];
     /**
      * The attributes an external user's claims map onto.
      */

package/dist/service/cognito/user-pool/idp/sim-cognito-attribute-mapping.js

@@ -20,6 +20,23 @@ export class SimCognitoAttributeMapping {
     toOutput() {
         return { ...this.mapping };
     }
+    /**
+     * The pool attribute types one provider claim is mapped onto.
+     */
+    dataTypesForClaim(claimName) {
+        return Object.entries(this.mapping).flatMap(([attributeName, mappedClaimName]) => {
+            if (mappedClaimName !== claimName) {
+                return [];
+            }
+            const attribute = this.schema.find(attributeName);
+            return attribute === undefined
+                ? []
+                : [
+                    attribute.toOutput()
+                        .AttributeDataType,
+                ];
+        });
+    }
     /**
      * The attributes an external user's claims map onto.
      */

package/dist/service/cognito/user-pool/idp/sim-cognito-presented-external-user.d.ts

@@ -16,13 +16,13 @@ export declare const simCognitoClaimFieldPrefix = "claim_";
  */
 export declare function simCognitoMappedClaimNames(provider: SimCognitoUserPoolIdentityProvider): readonly string[];
 /**
- * What one claim field is pre-filled with, so that the page signs a user in
- * when nobody edits it.
+ * What one claim field is pre-filled with, so the page signs a user in when
+ * nobody edits it.
  *
- * An address has to look like one, because a pool that verifies or aliases by
- * email holds it to that. Everything else is a name as far as this knows.
+ * The pool attribute type decides the shape. A string claim whose name refers
+ * to an email address uses the reserved address.
  */
-export declare function simCognitoDefaultClaim(claimName: string): string;
+export declare function simCognitoDefaultClaim(provider: SimCognitoUserPoolIdentityProvider, claimName: string): string;
 /**
  * The subject the page pre-fills, which says on its face where it came from.
  */

package/dist/service/cognito/user-pool/idp/sim-cognito-presented-external-user.js

@@ -28,16 +28,32 @@ export function simCognitoMappedClaimNames(provider) {
     return [...new Set(Object.values(provider.attributeMapping.toOutput()))];
 }
 /**
- * What one claim field is pre-filled with, so that the page signs a user in
- * when nobody edits it.
+ * What one claim field is pre-filled with, so the page signs a user in when
+ * nobody edits it.
  *
- * An address has to look like one, because a pool that verifies or aliases by
- * email holds it to that. Everything else is a name as far as this knows.
+ * The pool attribute type decides the shape. A string claim whose name refers
+ * to an email address uses the reserved address.
  */
-export function simCognitoDefaultClaim(claimName) {
-    return claimName.toLowerCase().includes("email")
-        ? defaultAddress
-        : defaultClaimValue;
+export function simCognitoDefaultClaim(provider, claimName) {
+    const dataType = provider.attributeMapping
+        .dataTypesForClaim(claimName)
+        .find((mappedType) => mappedType !== "String") ?? "String";
+    switch (dataType) {
+        case "Boolean": {
+            return "true";
+        }
+        case "DateTime": {
+            return "1970-01-01T00:00:00.000Z";
+        }
+        case "Number": {
+            return "0";
+        }
+        case "String": {
+            return claimName.toLowerCase().includes("email")
+                ? defaultAddress
+                : defaultClaimValue;
+        }
+    }
 }
 /**
  * The subject the page pre-fills, which says on its face where it came from.

package/dist/service/dynamodb/command/query/sim-dynamodb-query-expressions.d.ts

@@ -1,23 +1,26 @@
 import type { SimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter.js";
 import type { SimDynamoDbKeyConditionTerms } from "../../expression/key-condition/sim-dynamodb-key-condition-terms.js";
+import type { SimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection.js";
 import type { SimQueryCommandInput } from "./query.command.js";
 /**
- * What a query's expressions say, once both have been read.
+ * What a query's expressions say, once all three have been read.
  */
 export interface SimDynamoDbQueryExpressions {
     readonly terms: SimDynamoDbKeyConditionTerms;
     readonly filter: SimDynamoDbFilter | undefined;
+    readonly projection: SimDynamoDbProjection | undefined;
 }
 /**
- * Read both expressions of a query against one set of placeholders.
+ * Read every expression of a query against one set of placeholders.
  *
  * `ExpressionAttributeNames` and `ExpressionAttributeValues` are shared between
- * them, so they are checked once both have been read. A placeholder used by
- * either counts as used, and one used by neither is refused.
+ * the key condition, the filter and the projection, so they are checked once
+ * all three have been read. A placeholder used by any one of them counts as
+ * used, and one used by none is refused.
  *
- * Both are read before the table is reached, so an expression DynamoDB would
- * refuse is refused whether or not the table is there. What is left is the part
- * that needs the key schema, which each of them is held to once the table has
- * been found.
+ * All three are read before the table is reached, so an expression DynamoDB
+ * would refuse is refused whether or not the table is there. What is left is
+ * the part that needs the key schema, which each of them is held to once the
+ * table has been found.
  */
 export declare function readSimDynamoDbQueryExpressions(input: SimQueryCommandInput): SimDynamoDbQueryExpressions;

package/dist/service/dynamodb/command/query/sim-dynamodb-query-expressions.js

@@ -1,24 +1,27 @@
 import { parseSimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter-expression.js";
 import { readSimDynamoDbKeyCondition } from "../../expression/key-condition/sim-dynamodb-key-condition-expression.js";
+import { parseSimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection-expression.js";
 import { SimDynamoDbExpressionParameters } from "../../expression/sim-dynamodb-expression-parameters.js";
 /**
- * Read both expressions of a query against one set of placeholders.
+ * Read every expression of a query against one set of placeholders.
  *
  * `ExpressionAttributeNames` and `ExpressionAttributeValues` are shared between
- * them, so they are checked once both have been read. A placeholder used by
- * either counts as used, and one used by neither is refused.
+ * the key condition, the filter and the projection, so they are checked once
+ * all three have been read. A placeholder used by any one of them counts as
+ * used, and one used by none is refused.
  *
- * Both are read before the table is reached, so an expression DynamoDB would
- * refuse is refused whether or not the table is there. What is left is the part
- * that needs the key schema, which each of them is held to once the table has
- * been found.
+ * All three are read before the table is reached, so an expression DynamoDB
+ * would refuse is refused whether or not the table is there. What is left is
+ * the part that needs the key schema, which each of them is held to once the
+ * table has been found.
  */
 export function readSimDynamoDbQueryExpressions(input) {
     const parameters = new SimDynamoDbExpressionParameters(input);
     const terms = readSimDynamoDbKeyCondition(input, parameters);
     const filter = filterIn(input.FilterExpression, parameters);
+    const projection = projectionIn(input.ProjectionExpression, parameters);
     parameters.assertAllUsed();
-    return { terms, filter };
+    return { terms, filter, projection };
 }
 /**
  * Read the filter a query drops read items by, if it names one.
@@ -29,3 +32,12 @@ function filterIn(expression, parameters) {
     }
     return parseSimDynamoDbFilter(expression, parameters);
 }
+/**
+ * Read the parts of an item a query answers with, if it names them.
+ */
+function projectionIn(expression, parameters) {
+    if (expression === undefined) {
+        return undefined;
+    }
+    return parseSimDynamoDbProjection(expression, parameters);
+}

package/dist/service/dynamodb/command/query/sim-dynamodb-query.js

@@ -46,6 +46,7 @@ export class SimDynamoDbQuery {
         // waits for the view the same way the key condition does.
         expressions.filter?.assertNamesNoKeyAttribute(view.keySchema);
         expressions.filter?.assertNamesOnlyCarried(view);
+        expressions.projection?.assertNamesOnlyCarried(view);
         // The token names an item of the collection being read, so it can only be
         // checked once that collection is known.
         const after = readSimDynamoDbQueryStartKey({
@@ -65,6 +66,7 @@ export class SimDynamoDbQuery {
             ...new SimDynamoDbReadAnswer({
                 page,
                 filter: expressions.filter,
+                projection: expressions.projection,
                 select,
                 view,
             }).fields(),

package/dist/service/dynamodb/command/query/sim-dynamodb-unsimulated-query-input.js

@@ -9,7 +9,6 @@ import { SimDynamoDbUnsimulatedInput } from "../item/sim-dynamodb-unsimulated-in
  */
 export function refuseUnsimulatedQueryInput(input) {
     const unsimulated = new SimDynamoDbUnsimulatedInput("Query");
-    unsimulated.refuse(input.ProjectionExpression !== undefined, "ProjectionExpression", "answering with whole items where part of them was asked for");
     unsimulated.refuse((input.AttributesToGet ?? []).length > 0, "AttributesToGet", "answering with whole items where part of them was asked for");
     unsimulated.refuseNamed(input.KeyConditions, "KeyConditions", "reading a key condition written the way KeyConditionExpression replaced");
     unsimulated.refuseNamed(input.QueryFilter, "QueryFilter", "answering with the items a legacy filter would have dropped");

package/dist/service/dynamodb/command/read/sim-dynamodb-read-answer.d.ts

@@ -1,4 +1,5 @@
 import type { SimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter.js";
+import type { SimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection.js";
 import type { SimDynamoDbReadView } from "../../table/sim-dynamodb-read-view.js";
 import type { SimDynamoDbAttributeValue } from "../item/item.types.js";
 import type { SimDynamoDbItemPage } from "../item/sim-dynamodb-item-page.js";
@@ -15,6 +16,7 @@ export interface SimDynamoDbReadFields {
 interface SimDynamoDbReadAnswerProperties {
     readonly page: SimDynamoDbItemPage;
     readonly filter: SimDynamoDbFilter | undefined;
+    readonly projection: SimDynamoDbProjection | undefined;
     readonly select: SimDynamoDbSelect;
     readonly view: SimDynamoDbReadView;
 }
@@ -35,6 +37,7 @@ export declare class SimDynamoDbReadAnswer {
     private readonly kept;
     private readonly scannedCount;
     private readonly lastEvaluatedKey;
+    private readonly projection;
     private readonly select;
     private readonly view;
     constructor(properties: SimDynamoDbReadAnswerProperties);
@@ -49,10 +52,17 @@ export declare class SimDynamoDbReadAnswer {
     /**
      * One item as the read answers with it.
      *
-     * A read asking for whole items answers with the whole item. Anything else is
-     * cut to what the view carries, so a read of an index answers with the
-     * attributes that index projects rather than with everything. A read of the
-     * table cuts nothing either way.
+     * A `ProjectionExpression` names the attributes it wants, so it is applied to
+     * the whole item and the view is not asked to cut one first. On a global
+     * secondary index that changes nothing, since every path the projection names
+     * has already been checked against what the index projects. On a local
+     * secondary index it is what fetches an unprojected attribute from the base
+     * table, which is what real DynamoDB does for the same read.
+     *
+     * Without a projection, a read asking for whole items answers with the whole
+     * item, and anything else is cut to what the view carries. That is how a read
+     * of an index answers with the attributes that index projects rather than
+     * with everything. A read of the table cuts nothing either way.
      */
     private answered;
 }

package/dist/service/dynamodb/command/read/sim-dynamodb-read-answer.js

@@ -15,6 +15,7 @@ export class SimDynamoDbReadAnswer {
     kept;
     scannedCount;
     lastEvaluatedKey;
+    projection;
     select;
     view;
     constructor(properties) {
@@ -22,6 +23,7 @@ export class SimDynamoDbReadAnswer {
         this.scannedCount = evaluated.length;
         this.kept = properties.filter?.applyTo(evaluated) ?? evaluated;
         this.lastEvaluatedKey = properties.page.lastEvaluatedKey;
+        this.projection = properties.projection;
         this.select = properties.select;
         this.view = properties.view;
     }
@@ -50,12 +52,22 @@ export class SimDynamoDbReadAnswer {
     /**
      * One item as the read answers with it.
      *
-     * A read asking for whole items answers with the whole item. Anything else is
-     * cut to what the view carries, so a read of an index answers with the
-     * attributes that index projects rather than with everything. A read of the
-     * table cuts nothing either way.
+     * A `ProjectionExpression` names the attributes it wants, so it is applied to
+     * the whole item and the view is not asked to cut one first. On a global
+     * secondary index that changes nothing, since every path the projection names
+     * has already been checked against what the index projects. On a local
+     * secondary index it is what fetches an unprojected attribute from the base
+     * table, which is what real DynamoDB does for the same read.
+     *
+     * Without a projection, a read asking for whole items answers with the whole
+     * item, and anything else is cut to what the view carries. That is how a read
+     * of an index answers with the attributes that index projects rather than
+     * with everything. A read of the table cuts nothing either way.
      */
     answered(item) {
+        if (this.projection !== undefined) {
+            return this.projection.apply(item);
+        }
         if (this.select.wholeItems) {
             return item;
         }

package/dist/service/dynamodb/command/read/sim-dynamodb-table-read.fixture.d.ts

@@ -0,0 +1,17 @@
+import type { SimDynamoDb } from "../../sim-dynamodb.js";
+import type { SimQueryCommandInput, SimQueryCommandOutput } from "../query/query.command.js";
+import type { SimScanCommandInput } from "../scan/scan.command.js";
+/**
+ * One way of reading a table, against `simDynamoDbStockedTableFactory`.
+ *
+ * A query carries a key condition of its own, so what a test writes is added to
+ * that rather than replacing it.
+ */
+export interface SimDynamoDbTableRead {
+    readonly operation: string;
+    readonly read: (simDynamoDb: SimDynamoDb, input: SimQueryCommandInput & SimScanCommandInput) => Promise<SimQueryCommandOutput>;
+}
+/**
+ * Every way of reading a table, for a test that iterates them.
+ */
+export declare const simDynamoDbTableReads: readonly SimDynamoDbTableRead[];

package/dist/service/dynamodb/command/read/sim-dynamodb-table-read.fixture.js

@@ -0,0 +1,39 @@
+/**
+ * Test support for checking one rule on both of the operations it governs.
+ *
+ * `Select`, `ProjectionExpression` and the rest of the read parameters mean the
+ * same thing to a Query and to a Scan, and a rule proved on one of them says
+ * nothing about the other. Tests of those iterate this rather than being
+ * written twice.
+ *
+ * These helpers drive the simulator through structural command shapes rather
+ * than real SDK command objects, because this is source rather than a test
+ * file. The colocated tests cover SDK-shaped input.
+ */
+/**
+ * The values a query's own key condition needs, whatever the test adds.
+ */
+const keyConditionValues = { ":customer": { S: "c-1" } };
+/**
+ * Every way of reading a table, for a test that iterates them.
+ */
+export const simDynamoDbTableReads = [
+    {
+        operation: "Query",
+        read: async (simDynamoDb, input) => simDynamoDb.query({
+            input: {
+                TableName: "OrdersTable",
+                KeyConditionExpression: "customerId = :customer",
+                ...input,
+                ExpressionAttributeValues: {
+                    ...keyConditionValues,
+                    ...input.ExpressionAttributeValues,
+                },
+            },
+        }),
+    },
+    {
+        operation: "Scan",
+        read: async (simDynamoDb, input) => simDynamoDb.scan({ input: { TableName: "OrdersTable", ...input } }),
+    },
+];

package/dist/service/dynamodb/command/scan/sim-dynamodb-scan-expressions.d.ts

@@ -0,0 +1,28 @@
+import type { SimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter.js";
+import type { SimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection.js";
+import type { SimScanCommandInput } from "./scan.command.js";
+/**
+ * What a scan's expressions say, once both have been read.
+ */
+export interface SimDynamoDbScanExpressions {
+    readonly filter: SimDynamoDbFilter | undefined;
+    readonly projection: SimDynamoDbProjection | undefined;
+}
+/**
+ * Read both expressions of a scan against one set of placeholders.
+ *
+ * `ExpressionAttributeNames` and `ExpressionAttributeValues` are shared between
+ * the filter and the projection, so they are checked once both have been read.
+ * A placeholder used by either counts as used, and one used by neither is
+ * refused.
+ *
+ * A scan that names neither expression is a different refusal. There is nothing
+ * for a placeholder to be unused in, which is the wording real DynamoDB uses
+ * for a request carrying parameters and no expression at all.
+ *
+ * Both are read before the table is reached, so an expression DynamoDB would
+ * refuse is refused whether or not the table is there. What is left is which
+ * attributes the view being read carries, which each of them is held to once
+ * the table has been found.
+ */
+export declare function readSimDynamoDbScanExpressions(input: SimScanCommandInput): SimDynamoDbScanExpressions;

package/dist/service/dynamodb/command/scan/sim-dynamodb-scan-expressions.js

@@ -0,0 +1,50 @@
+import { parseSimDynamoDbFilter } from "../../expression/filter/sim-dynamodb-filter-expression.js";
+import { parseSimDynamoDbProjection } from "../../expression/projection/sim-dynamodb-projection-expression.js";
+import { SimDynamoDbExpressionParameters } from "../../expression/sim-dynamodb-expression-parameters.js";
+/**
+ * Read both expressions of a scan against one set of placeholders.
+ *
+ * `ExpressionAttributeNames` and `ExpressionAttributeValues` are shared between
+ * the filter and the projection, so they are checked once both have been read.
+ * A placeholder used by either counts as used, and one used by neither is
+ * refused.
+ *
+ * A scan that names neither expression is a different refusal. There is nothing
+ * for a placeholder to be unused in, which is the wording real DynamoDB uses
+ * for a request carrying parameters and no expression at all.
+ *
+ * Both are read before the table is reached, so an expression DynamoDB would
+ * refuse is refused whether or not the table is there. What is left is which
+ * attributes the view being read carries, which each of them is held to once
+ * the table has been found.
+ */
+export function readSimDynamoDbScanExpressions(input) {
+    if (input.FilterExpression === undefined &&
+        input.ProjectionExpression === undefined) {
+        SimDynamoDbExpressionParameters.assertNoneWithout(input);
+        return { filter: undefined, projection: undefined };
+    }
+    const parameters = new SimDynamoDbExpressionParameters(input);
+    const filter = filterIn(input.FilterExpression, parameters);
+    const projection = projectionIn(input.ProjectionExpression, parameters);
+    parameters.assertAllUsed();
+    return { filter, projection };
+}
+/**
+ * Read the filter a scan drops read items by, if it names one.
+ */
+function filterIn(expression, parameters) {
+    if (expression === undefined) {
+        return undefined;
+    }
+    return parseSimDynamoDbFilter(expression, parameters);
+}
+/**
+ * Read the parts of an item a scan answers with, if it names them.
+ */
+function projectionIn(expression, parameters) {
+    if (expression === undefined) {
+        return undefined;
+    }
+    return parseSimDynamoDbProjection(expression, parameters);
+}