@kensio/yulin 1.3.0 → 1.4.0

package/dist/service/rekognition/moderation/sim-rekognition-moderation-taxonomy.js

@@ -0,0 +1,87 @@
+import { SimRekognitionDeclarationError } from "../error/sim-rekognition.error.js";
+import { moderationLabels, simRekognitionModerationModelVersion, } from "./sim-rekognition-moderation-labels.js";
+/**
+ * One label in the moderation taxonomy.
+ *
+ * A top-level label carries a parent name of `""` rather than no parent at
+ * all, which is what real Rekognition puts in `ParentName` for one.
+ */
+export class SimRekognitionModerationLabelNode {
+    name;
+    parentName;
+    taxonomyLevel;
+    constructor(name, parentName, taxonomyLevel) {
+        this.name = name;
+        this.parentName = parentName;
+        this.taxonomyLevel = taxonomyLevel;
+    }
+}
+/**
+ * The content moderation label taxonomy, as the thing a declared label is
+ * resolved against.
+ *
+ * Declaring a label is declaring a whole chain: real Rekognition returns the
+ * detected label together with every label above it, so an image declared as
+ * `Implied Nudity` comes back as that, its `Non-Explicit Nudity` parent, and
+ * the top-level category above that. Handler code filtering on the top-level
+ * category therefore sees what it would see on AWS.
+ */
+export class SimRekognitionModerationTaxonomy {
+    nodes = new Map();
+    constructor() {
+        for (const [name, parentName] of moderationLabels) {
+            this.nodes.set(name, new SimRekognitionModerationLabelNode(name, parentName, this.levelOf(parentName) + 1));
+        }
+    }
+    /**
+     * Whether a name is a label in this taxonomy.
+     */
+    has(name) {
+        return this.nodes.has(name);
+    }
+    /**
+     * The chain of labels a detected label comes back with, from the top-level
+     * category down to the label itself.
+     */
+    chain(name) {
+        const node = this.require(name);
+        if (node.parentName === "") {
+            return [node];
+        }
+        return [...this.chain(node.parentName), node];
+    }
+    /**
+     * Get a label by name, refusing one this taxonomy does not have.
+     */
+    require(name) {
+        const node = this.nodes.get(name);
+        if (node === undefined) {
+            throw new SimRekognitionDeclarationError(`'${name}' is not a Rekognition moderation label. Declare one of the ` +
+                `${String(this.nodes.size)} labels in the version ` +
+                `${simRekognitionModerationModelVersion} content moderation ` +
+                `taxonomy, such as 'Explicit Nudity' or 'Violence'.`);
+        }
+        return node;
+    }
+    /**
+     * How deep a parent sits, so its children can be numbered below it.
+     *
+     * The labels are declared parents-first, so a parent is always in place by
+     * the time its children are built.
+     */
+    levelOf(parentName) {
+        if (parentName === "") {
+            return 0;
+        }
+        return this.require(parentName).taxonomyLevel;
+    }
+}
+/**
+ * The one taxonomy instance the simulation resolves labels against.
+ *
+ * It holds no per-simulation state, only the published label list, so there is
+ * nothing for one SimAws to leak into another through it.
+ */
+export const simRekognitionModerationTaxonomy = new SimRekognitionModerationTaxonomy();
+export { simRekognitionModerationModelVersion } from "./sim-rekognition-moderation-labels.js";
+//# sourceMappingURL=sim-rekognition-moderation-taxonomy.js.map

package/dist/service/rekognition/moderation/sim-rekognition-moderation-taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-moderation-taxonomy.js","sourceRoot":"","sources":["../../../../src/service/rekognition/moderation/sim-rekognition-moderation-taxonomy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,oCAAoC,GACrC,MAAM,wCAAwC,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,OAAO,iCAAiC;IAE1B,IAAI;IACJ,UAAU;IACV,aAAa;IAH/B,YACkB,IAAY,EACZ,UAAkB,EAClB,aAAqB;oBAFrB,IAAI;0BACJ,UAAU;6BACV,aAAa;IAC5B,CAAC;CACL;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,gCAAgC;IAC1B,KAAK,GAAG,IAAI,GAAG,EAA6C,CAAC;IAE9E;QACE,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,gBAAgB,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CACZ,IAAI,EACJ,IAAI,iCAAiC,CACnC,IAAI,EACJ,UAAU,EACV,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAC7B,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAY;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,8BAA8B,CACtC,IAAI,IAAI,8DAA8D;gBACpE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB;gBACnD,GAAG,oCAAoC,sBAAsB;gBAC7D,oDAAoD,CACvD,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,OAAO,CAAC,UAAkB;QAChC,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC;IAChD,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAC3C,IAAI,gCAAgC,EAAE,CAAC;AAEzC,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/service/rekognition/moderation/sim-rekognition-moderation.d.ts

@@ -0,0 +1,35 @@
+import type { SimRekognitionImage } from "../image/sim-rekognition-image.js";
+import { SimRekognitionModerationDetection, type SimRekognitionModerationResult } from "./sim-rekognition-moderation-result.js";
+/**
+ * The moderation results simulated Rekognition answers with.
+ *
+ * The rules are grouped per operation rather than hung off the service, so
+ * `moderation()`, and the operation groups added beside it, each own the
+ * result shape their own operation answers with.
+ */
+export declare class SimRekognitionModeration {
+    private readonly rules;
+    /**
+     * The sample images are declared as ordinary hash rules, so a rule a test
+     * registers for the same image replaces the built-in one through the usual
+     * precedence rather than through anything special-cased here.
+     */
+    constructor();
+    /**
+     * Answer with this result for any image no other rule matches.
+     */
+    byDefault(result: SimRekognitionModerationResult): void;
+    /**
+     * Answer with this result for the S3 object with this exact name.
+     */
+    onName(name: string, result: SimRekognitionModerationResult): void;
+    /**
+     * Answer with this result for the image with this exact content hash.
+     */
+    onHash(hash: string, result: SimRekognitionModerationResult): void;
+    /**
+     * The moderation result for one image.
+     */
+    detectionFor(image: SimRekognitionImage): SimRekognitionModerationDetection;
+}
+//# sourceMappingURL=sim-rekognition-moderation.d.ts.map

package/dist/service/rekognition/moderation/sim-rekognition-moderation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-moderation.d.ts","sourceRoot":"","sources":["../../../../src/service/rekognition/moderation/sim-rekognition-moderation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAG7E,OAAO,EACL,iCAAiC,EACjC,KAAK,8BAA8B,EACpC,MAAM,wCAAwC,CAAC;AAYhD;;;;;;GAMG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGlB;IAEJ;;;;OAIG;IACH,cAIC;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,8BAA8B,GAAG,IAAI,CAEtD;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI,CAEjE;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI,CAEjE;IAED;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,iCAAiC,CAE1E;CACF"}

package/dist/service/rekognition/moderation/sim-rekognition-moderation.js

@@ -0,0 +1,57 @@
+import { SimRekognitionResultRules } from "../rule/sim-rekognition-result-rules.js";
+import { simRekognitionSampleModerationRules } from "../sample/sim-rekognition-sample-rules.js";
+import { SimRekognitionModerationDetection, } from "./sim-rekognition-moderation-result.js";
+/**
+ * What DetectModerationLabels answers with before anything is configured.
+ *
+ * A clean image is the useful default: a moderation pipeline is mostly
+ * exercised by images that pass, with the ones that fail declared image by
+ * image. Which images those are is a decision about the system under test, so
+ * the simulation does not invent one.
+ */
+const cleanImage = { labels: [] };
+/**
+ * The moderation results simulated Rekognition answers with.
+ *
+ * The rules are grouped per operation rather than hung off the service, so
+ * `moderation()`, and the operation groups added beside it, each own the
+ * result shape their own operation answers with.
+ */
+export class SimRekognitionModeration {
+    rules = new SimRekognitionResultRules(new SimRekognitionModerationDetection(cleanImage));
+    /**
+     * The sample images are declared as ordinary hash rules, so a rule a test
+     * registers for the same image replaces the built-in one through the usual
+     * precedence rather than through anything special-cased here.
+     */
+    constructor() {
+        for (const sample of simRekognitionSampleModerationRules) {
+            this.onHash(sample.image.hash, sample.result);
+        }
+    }
+    /**
+     * Answer with this result for any image no other rule matches.
+     */
+    byDefault(result) {
+        this.rules.byDefault(new SimRekognitionModerationDetection(result));
+    }
+    /**
+     * Answer with this result for the S3 object with this exact name.
+     */
+    onName(name, result) {
+        this.rules.onName(name, new SimRekognitionModerationDetection(result));
+    }
+    /**
+     * Answer with this result for the image with this exact content hash.
+     */
+    onHash(hash, result) {
+        this.rules.onHash(hash, new SimRekognitionModerationDetection(result));
+    }
+    /**
+     * The moderation result for one image.
+     */
+    detectionFor(image) {
+        return this.rules.resultFor(image);
+    }
+}
+//# sourceMappingURL=sim-rekognition-moderation.js.map

package/dist/service/rekognition/moderation/sim-rekognition-moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-moderation.js","sourceRoot":"","sources":["../../../../src/service/rekognition/moderation/sim-rekognition-moderation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EACL,iCAAiC,GAElC,MAAM,wCAAwC,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,UAAU,GAAmC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IAClB,KAAK,GACpB,IAAI,yBAAyB,CAC3B,IAAI,iCAAiC,CAAC,UAAU,CAAC,CAClD,CAAC;IAEJ;;;;OAIG;IACH;QACE,KAAK,MAAM,MAAM,IAAI,mCAAmC,EAAE,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAsC;QAC9C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,iCAAiC,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,MAAsC;QACzD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,iCAAiC,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,MAAsC;QACzD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,iCAAiC,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAA0B;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/service/rekognition/rule/sim-rekognition-declared-confidence.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The confidence a declared result reports a label at.
+ *
+ * Every operation group declares confidences the same way and defaults them
+ * differently, so the range check lives here and the default is passed in.
+ *
+ * Confidences pass through `Math.fround`. Real Rekognition confidences are
+ * float32 values with a long tail, such as `99.44782257080078`, and a value
+ * rounded to four decimals is identifiable as fake.
+ */
+export declare class SimRekognitionDeclaredConfidence {
+    private readonly whenUndeclared;
+    constructor(whenUndeclared: number);
+    /**
+     * The confidence to report a declared label at.
+     *
+     * The label name is only used to say which declaration was wrong.
+     */
+    of(name: string, declared: number | undefined): number;
+}
+//# sourceMappingURL=sim-rekognition-declared-confidence.d.ts.map

package/dist/service/rekognition/rule/sim-rekognition-declared-confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-declared-confidence.d.ts","sourceRoot":"","sources":["../../../../src/service/rekognition/rule/sim-rekognition-declared-confidence.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,qBAAa,gCAAgC;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAA3C,YAA6B,cAAc,EAAE,MAAM,EAAI;IAEvD;;;;OAIG;IACH,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAcrD;CACF"}

package/dist/service/rekognition/rule/sim-rekognition-declared-confidence.js

@@ -0,0 +1,34 @@
+import { SimRekognitionDeclarationError } from "../error/sim-rekognition.error.js";
+/**
+ * The confidence a declared result reports a label at.
+ *
+ * Every operation group declares confidences the same way and defaults them
+ * differently, so the range check lives here and the default is passed in.
+ *
+ * Confidences pass through `Math.fround`. Real Rekognition confidences are
+ * float32 values with a long tail, such as `99.44782257080078`, and a value
+ * rounded to four decimals is identifiable as fake.
+ */
+export class SimRekognitionDeclaredConfidence {
+    whenUndeclared;
+    constructor(whenUndeclared) {
+        this.whenUndeclared = whenUndeclared;
+    }
+    /**
+     * The confidence to report a declared label at.
+     *
+     * The label name is only used to say which declaration was wrong.
+     */
+    of(name, declared) {
+        const confidence = declared ?? this.whenUndeclared;
+        // A NaN is refused with everything else out of range. Every comparison
+        // with one is false, so a label declared at NaN would never survive
+        // MinConfidence filtering and would look like a rule that never matched.
+        if (!Number.isFinite(confidence) || confidence < 0 || confidence > 100) {
+            throw new SimRekognitionDeclarationError(`A confidence of ${String(confidence)} declared for '${name}' is not ` +
+                `a Rekognition confidence, which is a percentage from 0 to 100.`);
+        }
+        return Math.fround(confidence);
+    }
+}
+//# sourceMappingURL=sim-rekognition-declared-confidence.js.map

package/dist/service/rekognition/rule/sim-rekognition-declared-confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-declared-confidence.js","sourceRoot":"","sources":["../../../../src/service/rekognition/rule/sim-rekognition-declared-confidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,OAAO,gCAAgC;IACd,cAAc;IAA3C,YAA6B,cAAsB;8BAAtB,cAAc;IAAW,CAAC;IAEvD;;;;OAIG;IACH,EAAE,CAAC,IAAY,EAAE,QAA4B;QAC3C,MAAM,UAAU,GAAG,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC;QAEnD,uEAAuE;QACvE,oEAAoE;QACpE,yEAAyE;QACzE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YACvE,MAAM,IAAI,8BAA8B,CACtC,mBAAmB,MAAM,CAAC,UAAU,CAAC,kBAAkB,IAAI,WAAW;gBACpE,gEAAgE,CACnE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/service/rekognition/rule/sim-rekognition-result-rules.d.ts

@@ -0,0 +1,51 @@
+import type { SimRekognitionImage } from "../image/sim-rekognition-image.js";
+/**
+ * The results one detection operation answers with, by image.
+ *
+ * Simulated Rekognition does no image recognition. Every operation answers
+ * from the rules registered against it, in the way simulated ACM issues
+ * certificates without producing real TLS certificates.
+ *
+ * There are three kinds of rule and one order between them: a rule for an
+ * exact content hash wins, then a rule for an exact S3 object name, then the
+ * default. Matching is exact, with no pattern syntax, so which rule applies
+ * never depends on how specific a pattern is thought to be.
+ *
+ * An image passed as `Image.Bytes` has no name, so it consults hash rules and
+ * then the default.
+ */
+export declare class SimRekognitionResultRules<TResult> {
+    private defaultResult;
+    private readonly resultsByName;
+    private readonly resultsByHash;
+    constructor(defaultResult: TResult);
+    /**
+     * Answer with this result for any image no other rule matches.
+     */
+    byDefault(result: TResult): void;
+    /**
+     * Answer with this result for an image read from an S3 object with this
+     * exact name.
+     *
+     * The name is the `Name` a request gives Rekognition, which is the object
+     * key. It is matched on its own rather than with the Bucket, so a rule for
+     * a key applies to that key in whichever Bucket the request names.
+     */
+    onName(name: string, result: TResult): void;
+    /**
+     * Answer with this result for an image whose bytes have this exact content
+     * hash.
+     *
+     * This is the rule for a system that generates its own object keys, where
+     * the name is not something a test can usefully match on. The hash is the
+     * sha256 digest of the image bytes as lowercase hex, which
+     * `simRekognitionImageHash` produces from a fixture.
+     */
+    onHash(hash: string, result: TResult): void;
+    /**
+     * The result for one image.
+     */
+    resultFor(image: SimRekognitionImage): TResult;
+    private byNameOrDefault;
+}
+//# sourceMappingURL=sim-rekognition-result-rules.d.ts.map

package/dist/service/rekognition/rule/sim-rekognition-result-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-result-rules.d.ts","sourceRoot":"","sources":["../../../../src/service/rekognition/rule/sim-rekognition-result-rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAAyB,CAAC,OAAO;IAC5C,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAE5D,YAAY,aAAa,EAAE,OAAO,EAEjC;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAQ1C;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAY1C;IAED;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAQ7C;IAED,OAAO,CAAC,eAAe;CAOxB"}

package/dist/service/rekognition/rule/sim-rekognition-result-rules.js

@@ -0,0 +1,80 @@
+import { SimRekognitionDeclarationError } from "../error/sim-rekognition.error.js";
+import { isSimRekognitionImageHash } from "../image/sim-rekognition-image-hash.js";
+/**
+ * The results one detection operation answers with, by image.
+ *
+ * Simulated Rekognition does no image recognition. Every operation answers
+ * from the rules registered against it, in the way simulated ACM issues
+ * certificates without producing real TLS certificates.
+ *
+ * There are three kinds of rule and one order between them: a rule for an
+ * exact content hash wins, then a rule for an exact S3 object name, then the
+ * default. Matching is exact, with no pattern syntax, so which rule applies
+ * never depends on how specific a pattern is thought to be.
+ *
+ * An image passed as `Image.Bytes` has no name, so it consults hash rules and
+ * then the default.
+ */
+export class SimRekognitionResultRules {
+    defaultResult;
+    resultsByName = new Map();
+    resultsByHash = new Map();
+    constructor(defaultResult) {
+        this.defaultResult = defaultResult;
+    }
+    /**
+     * Answer with this result for any image no other rule matches.
+     */
+    byDefault(result) {
+        this.defaultResult = result;
+    }
+    /**
+     * Answer with this result for an image read from an S3 object with this
+     * exact name.
+     *
+     * The name is the `Name` a request gives Rekognition, which is the object
+     * key. It is matched on its own rather than with the Bucket, so a rule for
+     * a key applies to that key in whichever Bucket the request names.
+     */
+    onName(name, result) {
+        if (name.length === 0) {
+            throw new SimRekognitionDeclarationError("A simulated Rekognition name rule needs an S3 object name to match");
+        }
+        this.resultsByName.set(name, result);
+    }
+    /**
+     * Answer with this result for an image whose bytes have this exact content
+     * hash.
+     *
+     * This is the rule for a system that generates its own object keys, where
+     * the name is not something a test can usefully match on. The hash is the
+     * sha256 digest of the image bytes as lowercase hex, which
+     * `simRekognitionImageHash` produces from a fixture.
+     */
+    onHash(hash, result) {
+        const digest = hash.toLowerCase();
+        if (!isSimRekognitionImageHash(digest)) {
+            throw new SimRekognitionDeclarationError(`'${hash}' is not a simulated Rekognition image hash. A hash rule ` +
+                `matches a sha256 digest of the image bytes, as 64 hex ` +
+                `characters, which simRekognitionImageHash produces.`);
+        }
+        this.resultsByHash.set(digest, result);
+    }
+    /**
+     * The result for one image.
+     */
+    resultFor(image) {
+        const byHash = this.resultsByHash.get(image.hash());
+        if (byHash !== undefined) {
+            return byHash;
+        }
+        return this.byNameOrDefault(image);
+    }
+    byNameOrDefault(image) {
+        if (image.name === undefined) {
+            return this.defaultResult;
+        }
+        return this.resultsByName.get(image.name) ?? this.defaultResult;
+    }
+}
+//# sourceMappingURL=sim-rekognition-result-rules.js.map

package/dist/service/rekognition/rule/sim-rekognition-result-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-result-rules.js","sourceRoot":"","sources":["../../../../src/service/rekognition/rule/sim-rekognition-result-rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAGnF;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,yBAAyB;IAC5B,aAAa,CAAU;IACd,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC3C,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE5D,YAAY,aAAsB;QAChC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAe;QACvB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAY,EAAE,MAAe;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,8BAA8B,CACtC,oEAAoE,CACrE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAY,EAAE,MAAe;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAElC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,8BAA8B,CACtC,IAAI,IAAI,2DAA2D;gBACjE,wDAAwD;gBACxD,qDAAqD,CACxD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAA0B;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAEpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAEO,eAAe,CAAC,KAA0B;QAChD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC;IAClE,CAAC;CACF"}

package/dist/service/rekognition/sample/sim-rekognition-sample-image-files.d.ts

@@ -0,0 +1,27 @@
+import { SimRekognitionSampleImage } from "./sim-rekognition-sample-image.js";
+/**
+ * The images that ship with simulated Rekognition.
+ *
+ * Each is a real 16 by 16 PNG or JPEG, so the format check reads the same
+ * magic bytes from a sample image as from any other image and there is no
+ * path around it. Three are PNG and two are JPEG, which is the pair of formats
+ * Rekognition accepts.
+ *
+ * They are 1,909 bytes in total, held here as base64. What they are pictures
+ * of decides nothing: no image is looked at, and each one answers from the
+ * rule registered against its hash. They are pictures of something anyway,
+ * because an image that reads as a photograph of a landscape is easier to
+ * follow in a test than a rectangle of one colour.
+ *
+ * The bytes are fixed. Re-encoding one would change its hash and leave the
+ * built-in rule matching nothing, so they are checked in as they are rather
+ * than generated at build time.
+ */
+export declare const simRekognitionSampleImageFiles: {
+    passesModeration: SimRekognitionSampleImage;
+    flaggedByModeration: SimRekognitionSampleImage;
+    noFaces: SimRekognitionSampleImage;
+    oneFace: SimRekognitionSampleImage;
+    severalFaces: SimRekognitionSampleImage;
+};
+//# sourceMappingURL=sim-rekognition-sample-image-files.d.ts.map

package/dist/service/rekognition/sample/sim-rekognition-sample-image-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-sample-image-files.d.ts","sourceRoot":"","sources":["../../../../src/service/rekognition/sample/sim-rekognition-sample-image-files.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,8BAA8B;IACzC,gBAAgB;IAIhB,mBAAmB;IAkBnB,OAAO;IAIP,OAAO;IAkBP,YAAY;CAKb,CAAC"}

package/dist/service/rekognition/sample/sim-rekognition-sample-image-files.js

@@ -0,0 +1,62 @@
+/* eslint-disable no-secrets/no-secrets -- base64 image files, not secrets. */
+import { SimRekognitionSampleImage } from "./sim-rekognition-sample-image.js";
+/**
+ * The images that ship with simulated Rekognition.
+ *
+ * Each is a real 16 by 16 PNG or JPEG, so the format check reads the same
+ * magic bytes from a sample image as from any other image and there is no
+ * path around it. Three are PNG and two are JPEG, which is the pair of formats
+ * Rekognition accepts.
+ *
+ * They are 1,909 bytes in total, held here as base64. What they are pictures
+ * of decides nothing: no image is looked at, and each one answers from the
+ * rule registered against its hash. They are pictures of something anyway,
+ * because an image that reads as a photograph of a landscape is easier to
+ * follow in a test than a rectangle of one colour.
+ *
+ * The bytes are fixed. Re-encoding one would change its hash and leave the
+ * built-in rule matching nothing, so they are checked in as they are rather
+ * than generated at build time.
+ */
+export const simRekognitionSampleImageFiles = {
+    passesModeration: new SimRekognitionSampleImage("iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAAAHklEQVR42mMwTp" +
+        "tJEmKgo4ZPz07iQaMaho+GQZP4ABIcwWyZg5lwAAAAAElFTkSuQmCC"),
+    flaggedByModeration: new SimRekognitionSampleImage("/9j/4AAQSkZJRgABAQAASABIAAD/wAARCAAQABADASIAAhEBAxEB/8QAHwAAAQ" +
+        "UBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9" +
+        "AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJi" +
+        "coKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWG" +
+        "h4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19" +
+        "jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAEC" +
+        "AwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcR" +
+        "MiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZH" +
+        "SElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoq" +
+        "OkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP0" +
+        "9fb3+Pn6/9sAQwAEBAQEBAQGBAQGCQYGBgkMCQkJCQwPDAwMDAwPEg8PDw8PDx" +
+        "ISEhISEhISFRUVFRUVGRkZGRkcHBwcHBwcHBwc/9sAQwEEBQUHBwcMBwcMHRQQ" +
+        "FB0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR" +
+        "0dHR0d/90ABAAB/9oADAMBAAIRAxEAPwDwL7//AE08z95+848zH/LWX+7Ev8K9" +
+        "6Pv/APTTzP3n7zjzMf8ALWX+7Ev8K96Pv/8ATTzP3n7zjzMf8tZf7sS/wr3o+/" +
+        "8A9NPM/efvOPMx/wAtZf7sS/wr3rxv6/r+vutp+l7/ANf8P387363/AHn/2Q=="),
+    noFaces: new SimRekognitionSampleImage("iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAAAG0lEQVR42mNo3/" +
+        "uCJMQwqmGIavDvsicJjUgNAOxJxJC8NL++AAAAAElFTkSuQmCC"),
+    oneFace: new SimRekognitionSampleImage("/9j/4AAQSkZJRgABAQAASABIAAD/wAARCAAQABADASIAAhEBAxEB/8QAHwAAAQ" +
+        "UBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9" +
+        "AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJi" +
+        "coKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWG" +
+        "h4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19" +
+        "jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAEC" +
+        "AwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcR" +
+        "MiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZH" +
+        "SElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoq" +
+        "OkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP0" +
+        "9fb3+Pn6/9sAQwAEBAQEBAQGBAQGCQYGBgkMCQkJCQwPDAwMDAwPEg8PDw8PDx" +
+        "ISEhISEhISFRUVFRUVGRkZGRkcHBwcHBwcHBwc/9sAQwEEBQUHBwcMBwcMHRQQ" +
+        "FB0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR0dHR" +
+        "0dHR0d/90ABAAB/9oADAMBAAIRAxEAPwD2ZF3sF6ZoddjFeuK8bHivXwci6x/w" +
+        "BP8A4mg+K9fJybrP/AE/+Jrp/wBZaPtub3uS21lvfe9+x8jy0/YcvL799/K21v" +
+        "U//9k="),
+    severalFaces: new SimRekognitionSampleImage("iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAAAMElEQVR42mNo3/" +
+        "uCJMQwJDQ82DAJgnBqQFNBqQY0LjU04PcS4VBC1+DfZU8SGpEaAJaDwyjublVb" +
+        "AAAAAElFTkSuQmCC"),
+};
+//# sourceMappingURL=sim-rekognition-sample-image-files.js.map

package/dist/service/rekognition/sample/sim-rekognition-sample-image-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-sample-image-files.js","sourceRoot":"","sources":["../../../../src/service/rekognition/sample/sim-rekognition-sample-image-files.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,gBAAgB,EAAE,IAAI,yBAAyB,CAC7C,gEAAgE;QAC9D,wDAAwD,CAC3D;IACD,mBAAmB,EAAE,IAAI,yBAAyB,CAChD,gEAAgE;QAC9D,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE,CACnE;IACD,OAAO,EAAE,IAAI,yBAAyB,CACpC,gEAAgE;QAC9D,oDAAoD,CACvD;IACD,OAAO,EAAE,IAAI,yBAAyB,CACpC,gEAAgE;QAC9D,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,gEAAgE;QAChE,QAAQ,CACX;IACD,YAAY,EAAE,IAAI,yBAAyB,CACzC,gEAAgE;QAC9D,gEAAgE;QAChE,kBAAkB,CACrB;CACF,CAAC"}

package/dist/service/rekognition/sample/sim-rekognition-sample-image.d.ts

@@ -0,0 +1,26 @@
+/**
+ * One image that ships with simulated Rekognition.
+ *
+ * The bytes are held as base64 in the source rather than as a file beside it,
+ * so a sample image is the same bytes in the published package as in this
+ * repository, and reading one needs no filesystem.
+ *
+ * The hash is taken once, when the image is made, because it is what the
+ * built-in rules are registered against.
+ */
+export declare class SimRekognitionSampleImage {
+    /**
+     * The content hash of this image, which is the hash a rule matches it by.
+     */
+    readonly hash: string;
+    private readonly image;
+    constructor(base64: string);
+    /**
+     * The bytes of this image.
+     *
+     * A copy, so a caller that writes into what it uploaded cannot change what
+     * the next caller gets and leave the built-in rule matching nothing.
+     */
+    bytes(): Uint8Array;
+}
+//# sourceMappingURL=sim-rekognition-sample-image.d.ts.map

package/dist/service/rekognition/sample/sim-rekognition-sample-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-sample-image.d.ts","sourceRoot":"","sources":["../../../../src/service/rekognition/sample/sim-rekognition-sample-image.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,YAAY,MAAM,EAAE,MAAM,EAGzB;IAED;;;;;OAKG;IACH,KAAK,IAAI,UAAU,CAElB;CACF"}

package/dist/service/rekognition/sample/sim-rekognition-sample-image.js

@@ -0,0 +1,32 @@
+import { simRekognitionImageHash } from "../image/sim-rekognition-image-hash.js";
+/**
+ * One image that ships with simulated Rekognition.
+ *
+ * The bytes are held as base64 in the source rather than as a file beside it,
+ * so a sample image is the same bytes in the published package as in this
+ * repository, and reading one needs no filesystem.
+ *
+ * The hash is taken once, when the image is made, because it is what the
+ * built-in rules are registered against.
+ */
+export class SimRekognitionSampleImage {
+    /**
+     * The content hash of this image, which is the hash a rule matches it by.
+     */
+    hash;
+    image;
+    constructor(base64) {
+        this.image = Uint8Array.from(Buffer.from(base64, "base64"));
+        this.hash = simRekognitionImageHash(this.image);
+    }
+    /**
+     * The bytes of this image.
+     *
+     * A copy, so a caller that writes into what it uploaded cannot change what
+     * the next caller gets and leave the built-in rule matching nothing.
+     */
+    bytes() {
+        return Uint8Array.from(this.image);
+    }
+}
+//# sourceMappingURL=sim-rekognition-sample-image.js.map

package/dist/service/rekognition/sample/sim-rekognition-sample-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-sample-image.js","sourceRoot":"","sources":["../../../../src/service/rekognition/sample/sim-rekognition-sample-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;;;;;;;;GASG;AACH,MAAM,OAAO,yBAAyB;IACpC;;OAEG;IACa,IAAI,CAAS;IAEZ,KAAK,CAAa;IAEnC,YAAY,MAAc;QACxB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/service/rekognition/sample/sim-rekognition-sample-images.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The images simulated Rekognition ships with, each already declared as a
+ * rule.
+ *
+ * They are for the case the hash rules exist for: a system that generates its
+ * own object keys, where the name a detection sees is not something a test can
+ * match on. A test uploads one of these through its own code and gets a known
+ * answer without configuring anything.
+ *
+ * ```typescript
+ * await simAws.s3().putObject(
+ *   new PutObjectCommand({
+ *     Bucket: "uploads",
+ *     Key: randomUUID(),
+ *     Body: simRekognitionSampleImages.flaggedByModeration(),
+ *   }),
+ * );
+ * ```
+ *
+ * Each image is declared for the one operation it is named for. The
+ * moderation images say nothing about faces, and the face images say nothing
+ * about moderation, so those detections answer from their own rules as they
+ * would for any other image.
+ */
+export declare class SimRekognitionSampleImages {
+    /**
+     * A PNG that content moderation finds nothing in.
+     */
+    passesModeration(): Uint8Array;
+    /**
+     * A JPEG that content moderation flags, as `Weapon Violence` and the two
+     * labels above it in the taxonomy.
+     */
+    flaggedByModeration(): Uint8Array;
+    /**
+     * A PNG with nobody in it.
+     */
+    noFaces(): Uint8Array;
+    /**
+     * A JPEG with one face in it, reported as the built-in default face.
+     */
+    oneFace(): Uint8Array;
+    /**
+     * A PNG with three faces in it.
+     */
+    severalFaces(): Uint8Array;
+}
+/**
+ * The sample images simulated Rekognition ships with.
+ */
+export declare const simRekognitionSampleImages: SimRekognitionSampleImages;
+//# sourceMappingURL=sim-rekognition-sample-images.d.ts.map

package/dist/service/rekognition/sample/sim-rekognition-sample-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rekognition-sample-images.d.ts","sourceRoot":"","sources":["../../../../src/service/rekognition/sample/sim-rekognition-sample-images.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,0BAA0B;IACrC;;OAEG;IACH,gBAAgB,IAAI,UAAU,CAE7B;IAED;;;OAGG;IACH,mBAAmB,IAAI,UAAU,CAEhC;IAED;;OAEG;IACH,OAAO,IAAI,UAAU,CAEpB;IAED;;OAEG;IACH,OAAO,IAAI,UAAU,CAEpB;IAED;;OAEG;IACH,YAAY,IAAI,UAAU,CAEzB;CACF;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,4BAAmC,CAAC"}