@kensio/yulin 1.19.4 → 1.20.0

package/dist/service/personalize/event/sim-personalize-recorded-item.js

@@ -0,0 +1,23 @@
+/**
+ * One item a `PutItems` has added to a simulated Items dataset.
+ *
+ * The dataset itself stays empty. Simulated Personalize reads no dataset, so
+ * the item is kept here instead and read back through
+ * `personalize().recordedItems()`.
+ */
+export class SimPersonalizeRecordedItem {
+    /** The Items dataset the request named. */
+    datasetArn;
+    itemId;
+    /** The item's metadata, as the JSON string the request carried. */
+    properties;
+    /** When simulated Personalize accepted the item, from the simulated clock. */
+    recordedAt;
+    constructor(properties) {
+        this.datasetArn = properties.datasetArn;
+        this.itemId = properties.itemId;
+        this.properties = properties.properties;
+        this.recordedAt = properties.recordedAt;
+    }
+}
+//# sourceMappingURL=sim-personalize-recorded-item.js.map

package/dist/service/personalize/event/sim-personalize-recorded-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-recorded-item.js","sourceRoot":"","sources":["../../../../src/service/personalize/event/sim-personalize-recorded-item.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,OAAO,0BAA0B;IACrC,2CAA2C;IAC3B,UAAU,CAAS;IAEnB,MAAM,CAAS;IAE/B,mEAAmE;IACnD,UAAU,CAAqB;IAE/C,8EAA8E;IAC9D,UAAU,CAAO;IAEjC,YAAY,UAAgD;QAC1D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;CACF"}

package/dist/service/personalize/event/sim-personalize-recorded-user.d.ts

@@ -0,0 +1,23 @@
+export interface SimPersonalizeRecordedUserProperties {
+    readonly datasetArn: string;
+    readonly userId: string;
+    readonly properties: string | undefined;
+    readonly recordedAt: Date;
+}
+/**
+ * One user a `PutUsers` has added to a simulated Users dataset.
+ *
+ * It follows the recorded item. The dataset stays empty and the user is read
+ * back through `personalize().recordedUsers()`.
+ */
+export declare class SimPersonalizeRecordedUser {
+    /** The Users dataset the request named. */
+    readonly datasetArn: string;
+    readonly userId: string;
+    /** The user's metadata, as the JSON string the request carried. */
+    readonly properties: string | undefined;
+    /** When simulated Personalize accepted the user, from the simulated clock. */
+    readonly recordedAt: Date;
+    constructor(properties: SimPersonalizeRecordedUserProperties);
+}
+//# sourceMappingURL=sim-personalize-recorded-user.d.ts.map

package/dist/service/personalize/event/sim-personalize-recorded-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-recorded-user.d.ts","sourceRoot":"","sources":["../../../../src/service/personalize/event/sim-personalize-recorded-user.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,0BAA0B;IACrC,2CAA2C;IAC3C,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,mEAAmE;IACnE,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/C,8EAA8E;IAC9E,SAAgB,UAAU,EAAE,IAAI,CAAC;IAEjC,YAAY,UAAU,EAAE,oCAAoC,EAK3D;CACF"}

package/dist/service/personalize/event/sim-personalize-recorded-user.js

@@ -0,0 +1,22 @@
+/**
+ * One user a `PutUsers` has added to a simulated Users dataset.
+ *
+ * It follows the recorded item. The dataset stays empty and the user is read
+ * back through `personalize().recordedUsers()`.
+ */
+export class SimPersonalizeRecordedUser {
+    /** The Users dataset the request named. */
+    datasetArn;
+    userId;
+    /** The user's metadata, as the JSON string the request carried. */
+    properties;
+    /** When simulated Personalize accepted the user, from the simulated clock. */
+    recordedAt;
+    constructor(properties) {
+        this.datasetArn = properties.datasetArn;
+        this.userId = properties.userId;
+        this.properties = properties.properties;
+        this.recordedAt = properties.recordedAt;
+    }
+}
+//# sourceMappingURL=sim-personalize-recorded-user.js.map

package/dist/service/personalize/event/sim-personalize-recorded-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-recorded-user.js","sourceRoot":"","sources":["../../../../src/service/personalize/event/sim-personalize-recorded-user.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IACrC,2CAA2C;IAC3B,UAAU,CAAS;IAEnB,MAAM,CAAS;IAE/B,mEAAmE;IACnD,UAAU,CAAqB;IAE/C,8EAA8E;IAC9D,UAAU,CAAO;IAEjC,YAAY,UAAgD;QAC1D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;CACF"}

package/dist/service/personalize/index.d.ts

@@ -0,0 +1,17 @@
+export { SimPersonalize } from "./sim-personalize.js";
+export { SimPersonalizeRuntime } from "./sim-personalize-runtime.js";
+export { SimPersonalizeEvents } from "./sim-personalize-events.js";
+export { SimPersonalizeRecommendations } from "./recommendation/sim-personalize-recommendations.js";
+export { SimPersonalizeRankings } from "./recommendation/sim-personalize-rankings.js";
+export type { SimPersonalizeDeclaredItem, SimPersonalizeDeclaredItems, SimPersonalizeItemDeclaration, } from "./recommendation/sim-personalize-item-declaration.js";
+export type { SimPersonalizeRequestOptions } from "./command/sim-personalize-request-options.js";
+export { SimPersonalizeRecordedEvent } from "./event/sim-personalize-recorded-event.js";
+export { SimPersonalizeRecordedItem } from "./event/sim-personalize-recorded-item.js";
+export { SimPersonalizeRecordedUser } from "./event/sim-personalize-recorded-user.js";
+export { SimPersonalizeEventTracker, type SimPersonalizeEventTrackerProperties, } from "./resource/sim-personalize-event-tracker.js";
+export { SimPersonalizeDatasetGroup, type SimPersonalizeDatasetGroupProperties, } from "./resource/sim-personalize-dataset-group.js";
+export { SimPersonalizeRecommender, type SimPersonalizeRecommenderConfig, type SimPersonalizeRecommenderProperties, } from "./resource/sim-personalize-recommender.js";
+export { simPersonalizeUseCases, type SimPersonalizeUseCase, } from "./resource/sim-personalize-use-case.js";
+export { simPersonalizeDomains, type SimPersonalizeDomain, } from "./resource/sim-personalize-domain.js";
+export { SimPersonalizeAccessDeniedException, SimPersonalizeDeclarationError, SimPersonalizeError, SimPersonalizeInvalidInputException, SimPersonalizeInvalidNextTokenException, SimPersonalizeResourceAlreadyExistsException, SimPersonalizeResourceInUseException, SimPersonalizeResourceNotFoundException, SimPersonalizeUnsimulatedInputException, } from "./error/sim-personalize.error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/service/personalize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/service/personalize/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AACpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,sDAAsD,CAAC;AAC9D,YAAY,EAAE,4BAA4B,EAAE,MAAM,8CAA8C,CAAC;AACjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EACL,0BAA0B,EAC1B,KAAK,oCAAoC,GAC1C,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,0BAA0B,EAC1B,KAAK,oCAAoC,GAC1C,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,yBAAyB,EACzB,KAAK,+BAA+B,EACpC,KAAK,mCAAmC,GACzC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,mCAAmC,EACnC,8BAA8B,EAC9B,mBAAmB,EACnB,mCAAmC,EACnC,uCAAuC,EACvC,4CAA4C,EAC5C,oCAAoC,EACpC,uCAAuC,EACvC,uCAAuC,GACxC,MAAM,kCAAkC,CAAC"}

package/dist/service/personalize/index.js

@@ -0,0 +1,15 @@
+export { SimPersonalize } from "./sim-personalize.js";
+export { SimPersonalizeRuntime } from "./sim-personalize-runtime.js";
+export { SimPersonalizeEvents } from "./sim-personalize-events.js";
+export { SimPersonalizeRecommendations } from "./recommendation/sim-personalize-recommendations.js";
+export { SimPersonalizeRankings } from "./recommendation/sim-personalize-rankings.js";
+export { SimPersonalizeRecordedEvent } from "./event/sim-personalize-recorded-event.js";
+export { SimPersonalizeRecordedItem } from "./event/sim-personalize-recorded-item.js";
+export { SimPersonalizeRecordedUser } from "./event/sim-personalize-recorded-user.js";
+export { SimPersonalizeEventTracker, } from "./resource/sim-personalize-event-tracker.js";
+export { SimPersonalizeDatasetGroup, } from "./resource/sim-personalize-dataset-group.js";
+export { SimPersonalizeRecommender, } from "./resource/sim-personalize-recommender.js";
+export { simPersonalizeUseCases, } from "./resource/sim-personalize-use-case.js";
+export { simPersonalizeDomains, } from "./resource/sim-personalize-domain.js";
+export { SimPersonalizeAccessDeniedException, SimPersonalizeDeclarationError, SimPersonalizeError, SimPersonalizeInvalidInputException, SimPersonalizeInvalidNextTokenException, SimPersonalizeResourceAlreadyExistsException, SimPersonalizeResourceInUseException, SimPersonalizeResourceNotFoundException, SimPersonalizeUnsimulatedInputException, } from "./error/sim-personalize.error.js";
+//# sourceMappingURL=index.js.map

package/dist/service/personalize/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/service/personalize/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AACpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAOtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EACL,0BAA0B,GAE3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,0BAA0B,GAE3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,yBAAyB,GAG1B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,sBAAsB,GAEvB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,qBAAqB,GAEtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,mCAAmC,EACnC,8BAA8B,EAC9B,mBAAmB,EACnB,mCAAmC,EACnC,uCAAuC,EACvC,4CAA4C,EAC5C,oCAAoC,EACpC,uCAAuC,EACvC,uCAAuC,GACxC,MAAM,kCAAkC,CAAC"}

package/dist/service/personalize/recommendation/sim-personalize-declared-target.d.ts

@@ -0,0 +1,32 @@
+import type { SimPersonalizeCampaign } from "../resource/sim-personalize-campaign.js";
+import type { SimPersonalizeRecommender } from "../resource/sim-personalize-recommender.js";
+import type { SimPersonalizeResource } from "../resource/sim-personalize-resource.js";
+import type { SimPersonalizeResourceStore } from "../resource/sim-personalize-resource-store.js";
+/**
+ * The stores a declaration is resolved against.
+ *
+ * Both, because the two paths reach the runtime through different resources.
+ * A custom dataset group serves through a campaign, and a Domain dataset group
+ * serves through a recommender.
+ */
+export interface SimPersonalizeDeclarationTargets {
+    readonly campaigns: SimPersonalizeResourceStore<SimPersonalizeCampaign>;
+    readonly recommenders: SimPersonalizeResourceStore<SimPersonalizeRecommender>;
+}
+/**
+ * Read the campaign or recommender a recommendation is declared against.
+ *
+ * The refusal is what makes a mistyped ARN visible. A declaration left against
+ * an ARN nothing holds would go unanswered, and the empty item list the runtime
+ * came back with would read as the system under test asking for the wrong item.
+ */
+export declare function requireSimPersonalizeRecommendationTarget(targets: SimPersonalizeDeclarationTargets, arn: string): SimPersonalizeResource;
+/**
+ * Read the campaign a ranking is declared against.
+ *
+ * Rankings are campaigns only. `GetPersonalizedRanking` takes a `campaignArn`
+ * and has no recommender form, and the domain use cases all recommend rather
+ * than rank, so a recommender ARN here is told what it is missing.
+ */
+export declare function requireSimPersonalizeRankingTarget(targets: SimPersonalizeDeclarationTargets, arn: string): SimPersonalizeCampaign;
+//# sourceMappingURL=sim-personalize-declared-target.d.ts.map

package/dist/service/personalize/recommendation/sim-personalize-declared-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-declared-target.d.ts","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-declared-target.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAEjG;;;;;;GAMG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC,sBAAsB,CAAC,CAAC;IACxE,QAAQ,CAAC,YAAY,EAAE,2BAA2B,CAAC,yBAAyB,CAAC,CAAC;CAC/E;AAED;;;;;;GAMG;AACH,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,gCAAgC,EACzC,GAAG,EAAE,MAAM,GACV,sBAAsB,CAYxB;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,gCAAgC,EACzC,GAAG,EAAE,MAAM,GACV,sBAAsB,CAoBxB"}

package/dist/service/personalize/recommendation/sim-personalize-declared-target.js

@@ -0,0 +1,39 @@
+import { SimPersonalizeDeclarationError } from "../error/sim-personalize.error.js";
+/**
+ * Read the campaign or recommender a recommendation is declared against.
+ *
+ * The refusal is what makes a mistyped ARN visible. A declaration left against
+ * an ARN nothing holds would go unanswered, and the empty item list the runtime
+ * came back with would read as the system under test asking for the wrong item.
+ */
+export function requireSimPersonalizeRecommendationTarget(targets, arn) {
+    const found = targets.campaigns.find(arn) ?? targets.recommenders.find(arn);
+    if (found === undefined) {
+        throw new SimPersonalizeDeclarationError(`No simulated Personalize campaign or recommender is deployed at ` +
+            `'${arn}'. Recommendations are declared against the resource a ` +
+            `runtime call names, so that resource is created first.`);
+    }
+    return found;
+}
+/**
+ * Read the campaign a ranking is declared against.
+ *
+ * Rankings are campaigns only. `GetPersonalizedRanking` takes a `campaignArn`
+ * and has no recommender form, and the domain use cases all recommend rather
+ * than rank, so a recommender ARN here is told what it is missing.
+ */
+export function requireSimPersonalizeRankingTarget(targets, arn) {
+    const campaign = targets.campaigns.find(arn);
+    if (campaign !== undefined) {
+        return campaign;
+    }
+    if (targets.recommenders.find(arn) !== undefined) {
+        throw new SimPersonalizeDeclarationError(`'${arn}' is a simulated Personalize recommender, and rankings are ` +
+            `declared against a campaign. GetPersonalizedRanking takes a ` +
+            `campaignArn and has no recommender form.`);
+    }
+    throw new SimPersonalizeDeclarationError(`No simulated Personalize campaign is deployed at '${arn}'. Rankings are ` +
+        `declared against the campaign a runtime call names, so the campaign ` +
+        `is created first.`);
+}
+//# sourceMappingURL=sim-personalize-declared-target.js.map

package/dist/service/personalize/recommendation/sim-personalize-declared-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-declared-target.js","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-declared-target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAkBnF;;;;;;GAMG;AACH,MAAM,UAAU,yCAAyC,CACvD,OAAyC,EACzC,GAAW;IAEX,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE5E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,8BAA8B,CACtC,kEAAkE;YAChE,IAAI,GAAG,yDAAyD;YAChE,wDAAwD,CAC3D,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAChD,OAAyC,EACzC,GAAW;IAEX,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,8BAA8B,CACtC,IAAI,GAAG,6DAA6D;YAClE,8DAA8D;YAC9D,0CAA0C,CAC7C,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,8BAA8B,CACtC,qDAAqD,GAAG,kBAAkB;QACxE,sEAAsE;QACtE,mBAAmB,CACtB,CAAC;AACJ,CAAC"}

package/dist/service/personalize/recommendation/sim-personalize-item-declaration.d.ts

@@ -0,0 +1,34 @@
+/**
+ * An item declared against a campaign, with what the runtime is to report
+ * alongside it.
+ *
+ * The score is the declaration's own. Nothing here computes one, because
+ * there is no model behind it to compute one from, so an item declared
+ * without a score comes back without a score.
+ */
+export interface SimPersonalizeDeclaredItem {
+    readonly itemId: string;
+    readonly score?: number | undefined;
+}
+/**
+ * An item as a rule declares it: an item id on its own, or an id with what is
+ * to be reported with it.
+ */
+export type SimPersonalizeItemDeclaration = string | SimPersonalizeDeclaredItem;
+/**
+ * What one runtime call answers with: the items, in the order they are to
+ * come back in.
+ *
+ * Both runtime operations answer with an ordered list of items, so both
+ * declare one. `GetRecommendations` reports it as `itemList` and
+ * `GetPersonalizedRanking` as `personalizedRanking`.
+ */
+export interface SimPersonalizeDeclaredItems {
+    readonly itemIds: readonly SimPersonalizeItemDeclaration[];
+    readonly recommendationId?: string | undefined;
+}
+/**
+ * Read a declaration that may be a bare item id.
+ */
+export declare function simPersonalizeDeclaredItem(declaration: SimPersonalizeItemDeclaration): SimPersonalizeDeclaredItem;
+//# sourceMappingURL=sim-personalize-item-declaration.d.ts.map

package/dist/service/personalize/recommendation/sim-personalize-item-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-item-declaration.d.ts","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-item-declaration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,GAAG,0BAA0B,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,6BAA6B,GACzC,0BAA0B,CAM5B"}

package/dist/service/personalize/recommendation/sim-personalize-item-declaration.js

@@ -0,0 +1,10 @@
+/**
+ * Read a declaration that may be a bare item id.
+ */
+export function simPersonalizeDeclaredItem(declaration) {
+    if (typeof declaration === "string") {
+        return { itemId: declaration };
+    }
+    return declaration;
+}
+//# sourceMappingURL=sim-personalize-item-declaration.js.map

package/dist/service/personalize/recommendation/sim-personalize-item-declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-item-declaration.js","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-item-declaration.ts"],"names":[],"mappings":"AAgCA;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,WAA0C;IAE1C,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/service/personalize/recommendation/sim-personalize-rankings.d.ts

@@ -0,0 +1,30 @@
+import type { SimPersonalizeDeclaredItems } from "./sim-personalize-item-declaration.js";
+/**
+ * The rankings one campaign answers GetPersonalizedRanking with.
+ *
+ * A rule for an exact user wins, then the default. There is no item rule
+ * here, unlike the recommendations beside it: a ranking request names a user
+ * and the list to rank, never one item, so an item rule would be a rule
+ * nothing could ever match.
+ *
+ * Nothing declared at all is the case worth having. The request already
+ * carries the items, and a ranking with no rule answers with them in the
+ * order they arrived, so a test that does not care about the order does not
+ * have to write one down.
+ */
+export declare class SimPersonalizeRankings {
+    private readonly rules;
+    /**
+     * Answer with these items for any request no other rule matches.
+     */
+    byDefault(result: SimPersonalizeDeclaredItems): void;
+    /**
+     * Answer with these items for a request naming this exact user.
+     */
+    onUser(userId: string, result: SimPersonalizeDeclaredItems): void;
+    /**
+     * The items declared for one ranking request, where any are.
+     */
+    itemsFor(userId: string): SimPersonalizeDeclaredItems | undefined;
+}
+//# sourceMappingURL=sim-personalize-rankings.d.ts.map

package/dist/service/personalize/recommendation/sim-personalize-rankings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-rankings.d.ts","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-rankings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAGzF;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAET;IAEb;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI,CAEnD;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,GAAG,IAAI,CAKhE;IAED;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAEhE;CACF"}

package/dist/service/personalize/recommendation/sim-personalize-rankings.js

@@ -0,0 +1,37 @@
+import { SimDeclaredResultRules } from "../../../util/rule/sim-declared-result-rules.js";
+import { requireSimPersonalizeRuleKey } from "./sim-personalize-rule-key.js";
+/**
+ * The rankings one campaign answers GetPersonalizedRanking with.
+ *
+ * A rule for an exact user wins, then the default. There is no item rule
+ * here, unlike the recommendations beside it: a ranking request names a user
+ * and the list to rank, never one item, so an item rule would be a rule
+ * nothing could ever match.
+ *
+ * Nothing declared at all is the case worth having. The request already
+ * carries the items, and a ranking with no rule answers with them in the
+ * order they arrived, so a test that does not care about the order does not
+ * have to write one down.
+ */
+export class SimPersonalizeRankings {
+    rules = new SimDeclaredResultRules(undefined);
+    /**
+     * Answer with these items for any request no other rule matches.
+     */
+    byDefault(result) {
+        this.rules.byDefault(result);
+    }
+    /**
+     * Answer with these items for a request naming this exact user.
+     */
+    onUser(userId, result) {
+        this.rules.onTrailingKey(requireSimPersonalizeRuleKey(userId, "a user id"), result);
+    }
+    /**
+     * The items declared for one ranking request, where any are.
+     */
+    itemsFor(userId) {
+        return this.rules.resultFor({ trailing: userId });
+    }
+}
+//# sourceMappingURL=sim-personalize-rankings.js.map

package/dist/service/personalize/recommendation/sim-personalize-rankings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-rankings.js","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-rankings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAE7E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAsB;IAChB,KAAK,GAAG,IAAI,sBAAsB,CAEjD,SAAS,CAAC,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,MAAmC;QAC3C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,MAAmC;QACxD,IAAI,CAAC,KAAK,CAAC,aAAa,CACtB,4BAA4B,CAAC,MAAM,EAAE,WAAW,CAAC,EACjD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/service/personalize/recommendation/sim-personalize-recommendations.d.ts

@@ -0,0 +1,39 @@
+import type { SimPersonalizeDeclaredItems } from "./sim-personalize-item-declaration.js";
+/**
+ * The request a recommendation rule is matched against.
+ */
+export interface SimPersonalizeRecommendationRequest {
+    readonly itemId?: string | undefined;
+    readonly userId?: string | undefined;
+}
+/**
+ * The recommendations one campaign answers GetRecommendations with.
+ *
+ * A rule for an exact item wins, then a rule for an exact user, then the
+ * default. Item first because the related-items recipes are the ones whose
+ * requests name an item at all: `aws-similar-items` requires `itemId` and
+ * ignores `userId`, where the user-personalization recipes require `userId`
+ * and name no item. A request therefore reaches the tier its own recipe
+ * would have used.
+ */
+export declare class SimPersonalizeRecommendations {
+    private readonly rules;
+    /**
+     * Answer with these items for any request no other rule matches.
+     */
+    byDefault(result: SimPersonalizeDeclaredItems): void;
+    /**
+     * Answer with these items for a request naming this exact item.
+     */
+    onItem(itemId: string, result: SimPersonalizeDeclaredItems): void;
+    /**
+     * Answer with these items for a request naming this exact user, where no
+     * item rule matched it first.
+     */
+    onUser(userId: string, result: SimPersonalizeDeclaredItems): void;
+    /**
+     * The items declared for one recommendation request.
+     */
+    itemsFor(request: SimPersonalizeRecommendationRequest): SimPersonalizeDeclaredItems;
+}
+//# sourceMappingURL=sim-personalize-recommendations.d.ts.map

package/dist/service/personalize/recommendation/sim-personalize-recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-recommendations.d.ts","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-recommendations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAGzF;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAYD;;;;;;;;;GASG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CACwD;IAE9E;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI,CAEnD;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,GAAG,IAAI,CAKhE;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,GAAG,IAAI,CAKhE;IAED;;OAEG;IACH,QAAQ,CACN,OAAO,EAAE,mCAAmC,GAC3C,2BAA2B,CAK7B;CACF"}

package/dist/service/personalize/recommendation/sim-personalize-recommendations.js

@@ -0,0 +1,53 @@
+import { SimDeclaredResultRules } from "../../../util/rule/sim-declared-result-rules.js";
+import { requireSimPersonalizeRuleKey } from "./sim-personalize-rule-key.js";
+/**
+ * What GetRecommendations answers with where nothing is declared.
+ *
+ * Real Personalize answers an item it does not recognise with popular items,
+ * which it knows from the interaction history. Simulated Personalize holds no
+ * interactions, so it answers with nothing rather than inventing a catalogue
+ * to be popular in.
+ */
+const nothingRecommended = { itemIds: [] };
+/**
+ * The recommendations one campaign answers GetRecommendations with.
+ *
+ * A rule for an exact item wins, then a rule for an exact user, then the
+ * default. Item first because the related-items recipes are the ones whose
+ * requests name an item at all: `aws-similar-items` requires `itemId` and
+ * ignores `userId`, where the user-personalization recipes require `userId`
+ * and name no item. A request therefore reaches the tier its own recipe
+ * would have used.
+ */
+export class SimPersonalizeRecommendations {
+    rules = new SimDeclaredResultRules(nothingRecommended);
+    /**
+     * Answer with these items for any request no other rule matches.
+     */
+    byDefault(result) {
+        this.rules.byDefault(result);
+    }
+    /**
+     * Answer with these items for a request naming this exact item.
+     */
+    onItem(itemId, result) {
+        this.rules.onLeadingKey(requireSimPersonalizeRuleKey(itemId, "an item id"), result);
+    }
+    /**
+     * Answer with these items for a request naming this exact user, where no
+     * item rule matched it first.
+     */
+    onUser(userId, result) {
+        this.rules.onTrailingKey(requireSimPersonalizeRuleKey(userId, "a user id"), result);
+    }
+    /**
+     * The items declared for one recommendation request.
+     */
+    itemsFor(request) {
+        return this.rules.resultFor({
+            leading: request.itemId,
+            trailing: request.userId,
+        });
+    }
+}
+//# sourceMappingURL=sim-personalize-recommendations.js.map

package/dist/service/personalize/recommendation/sim-personalize-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-recommendations.js","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAU7E;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAgC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAExE;;;;;;;;;GASG;AACH,MAAM,OAAO,6BAA6B;IACvB,KAAK,GACpB,IAAI,sBAAsB,CAA8B,kBAAkB,CAAC,CAAC;IAE9E;;OAEG;IACH,SAAS,CAAC,MAAmC;QAC3C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,MAAmC;QACxD,IAAI,CAAC,KAAK,CAAC,YAAY,CACrB,4BAA4B,CAAC,MAAM,EAAE,YAAY,CAAC,EAClD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAc,EAAE,MAAmC;QACxD,IAAI,CAAC,KAAK,CAAC,aAAa,CACtB,4BAA4B,CAAC,MAAM,EAAE,WAAW,CAAC,EACjD,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,OAA4C;QAE5C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,QAAQ,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/service/personalize/recommendation/sim-personalize-result-rules.d.ts

@@ -0,0 +1,31 @@
+import { type SimPersonalizeDeclarationTargets } from "./sim-personalize-declared-target.js";
+import { SimPersonalizeRankings } from "./sim-personalize-rankings.js";
+import { SimPersonalizeRecommendations } from "./sim-personalize-recommendations.js";
+/**
+ * The results declared against the campaigns and recommenders of one simulated
+ * Personalize.
+ *
+ * Rules are held per resource because that is what real Personalize answers a
+ * runtime call from. A campaign serves one solution version trained on one
+ * recipe and a recommender serves one use case, so two of them answer the same
+ * item differently, and rules that sat on the service would have to pretend
+ * otherwise.
+ *
+ * The resource has to exist before anything is declared against it.
+ */
+export declare class SimPersonalizeResultRules {
+    private readonly targets;
+    private readonly byArn;
+    constructor(targets: SimPersonalizeDeclarationTargets);
+    /**
+     * The recommendations one campaign or recommender answers
+     * GetRecommendations with.
+     */
+    recommendations(arn: string): SimPersonalizeRecommendations;
+    /**
+     * The rankings one campaign answers GetPersonalizedRanking with.
+     */
+    rankings(campaignArn: string): SimPersonalizeRankings;
+    private declaredAgainst;
+}
+//# sourceMappingURL=sim-personalize-result-rules.d.ts.map

package/dist/service/personalize/recommendation/sim-personalize-result-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-result-rules.d.ts","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-result-rules.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,gCAAgC,EACtC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAerF;;;;;;;;;;;GAWG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAElE,YAAY,OAAO,EAAE,gCAAgC,EAEpD;IAED;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,6BAA6B,CAK1D;IAED;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAKpD;IAED,OAAO,CAAC,eAAe;CAoBxB"}

package/dist/service/personalize/recommendation/sim-personalize-result-rules.js

@@ -0,0 +1,49 @@
+import { requireSimPersonalizeRankingTarget, requireSimPersonalizeRecommendationTarget, } from "./sim-personalize-declared-target.js";
+import { SimPersonalizeRankings } from "./sim-personalize-rankings.js";
+import { SimPersonalizeRecommendations } from "./sim-personalize-recommendations.js";
+/**
+ * The results declared against the campaigns and recommenders of one simulated
+ * Personalize.
+ *
+ * Rules are held per resource because that is what real Personalize answers a
+ * runtime call from. A campaign serves one solution version trained on one
+ * recipe and a recommender serves one use case, so two of them answer the same
+ * item differently, and rules that sat on the service would have to pretend
+ * otherwise.
+ *
+ * The resource has to exist before anything is declared against it.
+ */
+export class SimPersonalizeResultRules {
+    targets;
+    byArn = new Map();
+    constructor(targets) {
+        this.targets = targets;
+    }
+    /**
+     * The recommendations one campaign or recommender answers
+     * GetRecommendations with.
+     */
+    recommendations(arn) {
+        return this.declaredAgainst(arn, requireSimPersonalizeRecommendationTarget(this.targets, arn)).recommendations;
+    }
+    /**
+     * The rankings one campaign answers GetPersonalizedRanking with.
+     */
+    rankings(campaignArn) {
+        return this.declaredAgainst(campaignArn, requireSimPersonalizeRankingTarget(this.targets, campaignArn)).rankings;
+    }
+    declaredAgainst(arn, target) {
+        const held = this.byArn.get(arn);
+        if (held?.target === target) {
+            return held;
+        }
+        const declared = {
+            target,
+            recommendations: new SimPersonalizeRecommendations(),
+            rankings: new SimPersonalizeRankings(),
+        };
+        this.byArn.set(arn, declared);
+        return declared;
+    }
+}
+//# sourceMappingURL=sim-personalize-result-rules.js.map

package/dist/service/personalize/recommendation/sim-personalize-result-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-result-rules.js","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-result-rules.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kCAAkC,EAClC,yCAAyC,GAE1C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAerF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,yBAAyB;IACnB,OAAO,CAAmC;IAC1C,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAC;IAElE,YAAY,OAAyC;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,GAAW;QACzB,OAAO,IAAI,CAAC,eAAe,CACzB,GAAG,EACH,yCAAyC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAC7D,CAAC,eAAe,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,WAAmB;QAC1B,OAAO,IAAI,CAAC,eAAe,CACzB,WAAW,EACX,kCAAkC,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAC9D,CAAC,QAAQ,CAAC;IACb,CAAC;IAEO,eAAe,CACrB,GAAW,EACX,MAA8B;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjC,IAAI,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG;YACf,MAAM;YACN,eAAe,EAAE,IAAI,6BAA6B,EAAE;YACpD,QAAQ,EAAE,IAAI,sBAAsB,EAAE;SACvC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAE9B,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/service/personalize/recommendation/sim-personalize-rule-key.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Read the id a rule matches on, refusing one there is nothing to match.
+ *
+ * An empty id would match a request that named no item or no user at all,
+ * which is the rule the default is already there for.
+ */
+export declare function requireSimPersonalizeRuleKey(key: string, description: string): string;
+//# sourceMappingURL=sim-personalize-rule-key.d.ts.map

package/dist/service/personalize/recommendation/sim-personalize-rule-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-rule-key.d.ts","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-rule-key.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR"}

package/dist/service/personalize/recommendation/sim-personalize-rule-key.js

@@ -0,0 +1,14 @@
+import { SimPersonalizeDeclarationError } from "../error/sim-personalize.error.js";
+/**
+ * Read the id a rule matches on, refusing one there is nothing to match.
+ *
+ * An empty id would match a request that named no item or no user at all,
+ * which is the rule the default is already there for.
+ */
+export function requireSimPersonalizeRuleKey(key, description) {
+    if (key.length === 0) {
+        throw new SimPersonalizeDeclarationError(`A simulated Personalize rule needs ${description} to match`);
+    }
+    return key;
+}
+//# sourceMappingURL=sim-personalize-rule-key.js.map

package/dist/service/personalize/recommendation/sim-personalize-rule-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-personalize-rule-key.js","sourceRoot":"","sources":["../../../../src/service/personalize/recommendation/sim-personalize-rule-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,GAAW,EACX,WAAmB;IAEnB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,8BAA8B,CACtC,sCAAsC,WAAW,WAAW,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}