@volontariapp/domain-ranking 0.0.0-stage → 0.1.0-snap-8a39acc

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0
+
+### Minor Changes
+
+- Add the domain-ranking package: pure scoring services (events, posts, popularity, explanation codes, opaque cursor, PASS penalties, encrypted position), the RankingScorer port, the TypeORM models of the ranking tables and the repositories (computation requests, atomic list replacement, rate buckets, signals, like journal, account purge).

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# @volontariapp/domain-ranking
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Domaine du classement personnalisé des événements et des posts (`ms-ranking`). Il est partagé par
+`ms-ranking`, `worker-ranking` et `post-processor-ranking`. Conception : `docs/matching/` du dépôt `docs`.
+
+## Contenu
+
+| Dossier | Rôle |
+| :--- | :--- |
+| `constants/` | Poids, seuils et versions de formule (`FORMULA_VERSION`, `FEED_FORMULA_VERSION`). Toute modification d'un poids incrémente la version. |
+| `enums/` | Types de liste, sources, codes d'explication, seaux, origines. |
+| `entities/` | Entités du domaine (une par table), sans dépendance à TypeORM. |
+| `models/` | Modèles TypeORM des tables `ranking_*` et `registerRankingMappings()` (appelé à l'import du paquet, comme `domain-post`). |
+| `repositories/` | Un `Postgres...Repository` par table, qui étend `BaseRepository` de `@volontariapp/database` (`@Injectable`, `@InjectRepository`), et leurs interfaces dans `repositories/interfaces/`. Le SQL spécifique y vit. |
+| `services/` | Uniquement des classes de service `@Injectable`, une par fichier, au-dessus des interfaces de repository (journalisation et erreurs `DATABASE_ERROR` comme dans les autres domaines) : demandes de calcul, runs, listes, limites de débit, passes, souhaits, mentions, journal de likes, position chiffrée, purge de compte. |
+| `policies/` | Règles de score **pures**, testables sans infrastructure : événements, popularité, posts, codes d'explication, score final, diversité, pénalités `PASS`. |
+| `helpers/` | Fonctions utilitaires : maths, géographie, curseur opaque, chiffrement de la position, conversion des erreurs de base. |
+| `exceptions/` | Exceptions du domaine (`BadRequestError`, `InternalServerError`). |
+| `ports/` | Port `RankingScorer` (scoreur sémantique, Jev) et `NoopRankingScorer`. |
+
+## Points à connaître
+
+- Les dates de demande et de début de calcul viennent de l'horloge de la base (`clock_timestamp()`) et
+  circulent en **texte** (microsecondes conservées) : les comparer en SQL, jamais en JavaScript.
+- Le remplacement d'une liste est une transaction courte avec verrou consultatif et anti-écrasement ;
+  son rappel `afterWrite` s'exécute dans la même transaction (job de suite).
+- Les seaux à jetons exigent les conversions `::numeric`.
+- Le journal de likes n'est **pas** chiffré (exception documentée, décision 30).
+- La position est arrondie à 1 km puis chiffrée (`v1|userId|lat|lng`) avec une clé de 32 octets aléatoires.
+- Les pénalités `PASS` renumérotent les éléments non servis : l'appelant persiste les nouveaux rangs
+  (`updateEventRanks`) pour que le curseur `(listVersion, lastRank)` reste exact.
+
+## Tests
+
+- `yarn test` : tests unitaires des services purs.
+- `yarn test:integration` : PostgreSQL réel (`postgres-ranking` de `ci-tools/docker-compose.yml`, port 5438).
+  Les migrations de test sont dans `src/test/migrations/` ; la migration de domaine est la copie de
+  `ms-ranking/src/migrations/domain/`.

package/dist/constants/formula.d.ts

@@ -0,0 +1,68 @@
+export declare const FORMULA_VERSION = 1;
+export declare const FEED_FORMULA_VERSION = 1;
+export declare const EVENT_WEIGHTS: {
+    readonly proximity: 0.27;
+    readonly friends: 0.23;
+    readonly typeAffinity: 0.22;
+    readonly imminence: 0.18;
+    readonly popularity: 0.1;
+};
+export declare const POST_WEIGHTS: {
+    readonly eventTie: 0.35;
+    readonly authorAffinity: 0.3;
+    readonly recency: 0.35;
+};
+export declare const PROXIMITY_DECAY_KM = 15;
+export declare const MAX_DISTANCE_KM = 100;
+export declare const IMMINENCE_HORIZON_DAYS = 60;
+export declare const NEUTRAL_TYPE_AFFINITY = 0.5;
+export declare const NEUTRAL_PROXIMITY = 0.5;
+export declare const POPULARITY_PRIOR_WISHES = 2;
+export declare const POPULARITY_PRIOR_PASSES = 2;
+export declare const POPULARITY_MENTION_SATURATION = 10;
+export declare const POPULARITY_WEIGHTS: {
+    readonly interest: 0.4;
+    readonly fill: 0.3;
+    readonly mentions: 0.3;
+};
+export declare const POPULARITY_BUZZ_WINDOW_DAYS = 14;
+export declare const AUTHOR_SIGNAL_WEIGHTS: {
+    readonly LIKE: 1;
+    readonly COMMENT: 2;
+};
+export declare const AUTHOR_SIGNAL_HALF_LIFE_DAYS = 14;
+export declare const AUTHOR_SIGNAL_SATURATION = 6;
+export declare const AUTHOR_FOLLOW_BONUS = 0.25;
+export declare const AUTHOR_FRIEND_BONUS = 0.15;
+export declare const POST_RECENCY_SCALE_HOURS = 48;
+export declare const EVENT_TIE_PAST_JOINED = 0.5;
+export declare const ENGAGED_POST_DEMOTION = 0.6;
+export declare const DIVERSITY_WINDOW = 3;
+export declare const EVENT_SEMANTIC_WEIGHT = 0.5;
+export declare const POST_SEMANTIC_WEIGHT = 0.15;
+export declare const MAX_REASONS = 2;
+export declare const REASON_THRESHOLDS: {
+    readonly nearYou: 0.5;
+    readonly matchesInterests: 0.6;
+    readonly startingSoon: 0.8;
+    readonly trending: 0.65;
+    readonly engagedAuthor: 0.1;
+    readonly recent: 0.6;
+};
+export declare const DEFAULT_LIST_SIZE = 100;
+export declare const DEFAULT_PASS_COOLDOWN_DAYS = 30;
+export declare const DEFAULT_REQUEST_TTL_SECONDS = 120;
+export declare const DEFAULT_LOCATION_REFRESH_KM = 10;
+export declare const MAX_FEEDBACK_ITEMS = 50;
+export declare const REFRESH_BUCKET_CAPACITY = 5;
+export declare const LOCATION_BUCKET_CAPACITY = 1;
+export declare const BUCKET_WINDOW_SECONDS = 60;
+export declare const LIKE_LOG_RETENTION_DAYS = 90;
+export declare const LIKE_TOMBSTONE_RETENTION_DAYS = 7;
+export declare const FEEDBACK_RETENTION_DAYS = 90;
+export declare const PASS_TYPE_PENALTY = 0.02;
+export declare const PASS_TAG_PENALTY = 0.03;
+export declare const PASS_MAX_PENALTY = 0.5;
+export declare const DEFAULT_PAGE_LIMIT = 20;
+export declare const MAX_PAGE_LIMIT = 50;
+//# sourceMappingURL=formula.d.ts.map

package/dist/constants/formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../../src/constants/formula.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAGtC,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAGX,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAGrC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,kBAAkB;;;;CAAuD,CAAC;AAEvF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAG9C,eAAO,MAAM,qBAAqB;;;CAAmC,CAAC;AACtE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAGlC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAGzC,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAGX,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAGrC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAGxC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAG1C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAGpC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,cAAc,KAAK,CAAC"}

package/dist/constants/formula.js

@@ -0,0 +1,61 @@
+export const FORMULA_VERSION = 1;
+export const FEED_FORMULA_VERSION = 1;
+export const EVENT_WEIGHTS = {
+    proximity: 0.27,
+    friends: 0.23,
+    typeAffinity: 0.22,
+    imminence: 0.18,
+    popularity: 0.1,
+};
+export const POST_WEIGHTS = {
+    eventTie: 0.35,
+    authorAffinity: 0.3,
+    recency: 0.35,
+};
+export const PROXIMITY_DECAY_KM = 15;
+export const MAX_DISTANCE_KM = 100;
+export const IMMINENCE_HORIZON_DAYS = 60;
+export const NEUTRAL_TYPE_AFFINITY = 0.5;
+export const NEUTRAL_PROXIMITY = 0.5;
+export const POPULARITY_PRIOR_WISHES = 2;
+export const POPULARITY_PRIOR_PASSES = 2;
+export const POPULARITY_MENTION_SATURATION = 10;
+export const POPULARITY_WEIGHTS = { interest: 0.4, fill: 0.3, mentions: 0.3 };
+export const POPULARITY_BUZZ_WINDOW_DAYS = 14;
+export const AUTHOR_SIGNAL_WEIGHTS = { LIKE: 1, COMMENT: 2 };
+export const AUTHOR_SIGNAL_HALF_LIFE_DAYS = 14;
+export const AUTHOR_SIGNAL_SATURATION = 6;
+export const AUTHOR_FOLLOW_BONUS = 0.25;
+export const AUTHOR_FRIEND_BONUS = 0.15;
+export const POST_RECENCY_SCALE_HOURS = 48;
+export const EVENT_TIE_PAST_JOINED = 0.5;
+export const ENGAGED_POST_DEMOTION = 0.6;
+export const DIVERSITY_WINDOW = 3;
+export const EVENT_SEMANTIC_WEIGHT = 0.5;
+export const POST_SEMANTIC_WEIGHT = 0.15;
+export const MAX_REASONS = 2;
+export const REASON_THRESHOLDS = {
+    nearYou: 0.5,
+    matchesInterests: 0.6,
+    startingSoon: 0.8,
+    trending: 0.65,
+    engagedAuthor: 0.1,
+    recent: 0.6,
+};
+export const DEFAULT_LIST_SIZE = 100;
+export const DEFAULT_PASS_COOLDOWN_DAYS = 30;
+export const DEFAULT_REQUEST_TTL_SECONDS = 120;
+export const DEFAULT_LOCATION_REFRESH_KM = 10;
+export const MAX_FEEDBACK_ITEMS = 50;
+export const REFRESH_BUCKET_CAPACITY = 5;
+export const LOCATION_BUCKET_CAPACITY = 1;
+export const BUCKET_WINDOW_SECONDS = 60;
+export const LIKE_LOG_RETENTION_DAYS = 90;
+export const LIKE_TOMBSTONE_RETENTION_DAYS = 7;
+export const FEEDBACK_RETENTION_DAYS = 90;
+export const PASS_TYPE_PENALTY = 0.02;
+export const PASS_TAG_PENALTY = 0.03;
+export const PASS_MAX_PENALTY = 0.5;
+export const DEFAULT_PAGE_LIMIT = 20;
+export const MAX_PAGE_LIMIT = 50;
+//# sourceMappingURL=formula.js.map

package/dist/constants/formula.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula.js","sourceRoot":"","sources":["../../src/constants/formula.ts"],"names":[],"mappings":"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"}

package/dist/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from './formula.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,2 @@
+export * from './formula.js';
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/entities/index.d.ts

@@ -0,0 +1,11 @@
+export * from './ranking-score.entity.js';
+export * from './ranking-post-score.entity.js';
+export * from './ranking-run.entity.js';
+export * from './ranking-request.entity.js';
+export * from './ranking-like-log.entity.js';
+export * from './ranking-event-feedback.entity.js';
+export * from './ranking-event-wish.entity.js';
+export * from './ranking-event-mention.entity.js';
+export * from './ranking-user-location.entity.js';
+export * from './ranking-rate-bucket.entity.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC"}

package/dist/entities/index.js

@@ -0,0 +1,11 @@
+export * from './ranking-score.entity.js';
+export * from './ranking-post-score.entity.js';
+export * from './ranking-run.entity.js';
+export * from './ranking-request.entity.js';
+export * from './ranking-like-log.entity.js';
+export * from './ranking-event-feedback.entity.js';
+export * from './ranking-event-wish.entity.js';
+export * from './ranking-event-mention.entity.js';
+export * from './ranking-user-location.entity.js';
+export * from './ranking-rate-bucket.entity.js';
+//# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC"}

package/dist/entities/ranking-event-feedback.entity.d.ts

@@ -0,0 +1,7 @@
+export declare class RankingEventFeedbackEntity {
+    userId: string;
+    eventId: string;
+    action: string;
+    createdAt: Date;
+}
+//# sourceMappingURL=ranking-event-feedback.entity.d.ts.map

package/dist/entities/ranking-event-feedback.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-event-feedback.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-event-feedback.entity.ts"],"names":[],"mappings":"AACA,qBAAa,0BAA0B;IACrC,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAG,MAAM,CAAC;IACjB,MAAM,EAAG,MAAM,CAAC;IAChB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/entities/ranking-event-feedback.entity.js

@@ -0,0 +1,7 @@
+export class RankingEventFeedbackEntity {
+    userId;
+    eventId;
+    action;
+    createdAt;
+}
+//# sourceMappingURL=ranking-event-feedback.entity.js.map

package/dist/entities/ranking-event-feedback.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-event-feedback.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-event-feedback.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,0BAA0B;IACrC,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,MAAM,CAAU;IAChB,SAAS,CAAQ;CAClB"}

package/dist/entities/ranking-event-mention.entity.d.ts

@@ -0,0 +1,7 @@
+export declare class RankingEventMentionEntity {
+    postId: string;
+    eventId: string;
+    authorId: string;
+    createdAt: Date;
+}
+//# sourceMappingURL=ranking-event-mention.entity.d.ts.map

package/dist/entities/ranking-event-mention.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-event-mention.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-event-mention.entity.ts"],"names":[],"mappings":"AACA,qBAAa,yBAAyB;IACpC,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAG,MAAM,CAAC;IACjB,QAAQ,EAAG,MAAM,CAAC;IAClB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/entities/ranking-event-mention.entity.js

@@ -0,0 +1,7 @@
+export class RankingEventMentionEntity {
+    postId;
+    eventId;
+    authorId;
+    createdAt;
+}
+//# sourceMappingURL=ranking-event-mention.entity.js.map

package/dist/entities/ranking-event-mention.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-event-mention.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-event-mention.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,yBAAyB;IACpC,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,QAAQ,CAAU;IAClB,SAAS,CAAQ;CAClB"}

package/dist/entities/ranking-event-wish.entity.d.ts

@@ -0,0 +1,6 @@
+export declare class RankingEventWishEntity {
+    userId: string;
+    eventId: string;
+    createdAt: Date;
+}
+//# sourceMappingURL=ranking-event-wish.entity.d.ts.map

package/dist/entities/ranking-event-wish.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-event-wish.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-event-wish.entity.ts"],"names":[],"mappings":"AACA,qBAAa,sBAAsB;IACjC,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAG,MAAM,CAAC;IACjB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/entities/ranking-event-wish.entity.js

@@ -0,0 +1,6 @@
+export class RankingEventWishEntity {
+    userId;
+    eventId;
+    createdAt;
+}
+//# sourceMappingURL=ranking-event-wish.entity.js.map

package/dist/entities/ranking-event-wish.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-event-wish.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-event-wish.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,sBAAsB;IACjC,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,SAAS,CAAQ;CAClB"}

package/dist/entities/ranking-like-log.entity.d.ts

@@ -0,0 +1,8 @@
+export declare class RankingLikeLogEntity {
+    userId: string;
+    postId: string;
+    occurredAt: Date;
+    deletedAt: Date | null;
+    origin: string;
+}
+//# sourceMappingURL=ranking-like-log.entity.d.ts.map

package/dist/entities/ranking-like-log.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-like-log.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-like-log.entity.ts"],"names":[],"mappings":"AACA,qBAAa,oBAAoB;IAC/B,MAAM,EAAG,MAAM,CAAC;IAChB,MAAM,EAAG,MAAM,CAAC;IAChB,UAAU,EAAG,IAAI,CAAC;IAClB,SAAS,EAAG,IAAI,GAAG,IAAI,CAAC;IACxB,MAAM,EAAG,MAAM,CAAC;CACjB"}

package/dist/entities/ranking-like-log.entity.js

@@ -0,0 +1,8 @@
+export class RankingLikeLogEntity {
+    userId;
+    postId;
+    occurredAt;
+    deletedAt;
+    origin;
+}
+//# sourceMappingURL=ranking-like-log.entity.js.map

package/dist/entities/ranking-like-log.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-like-log.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-like-log.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAU;IAChB,MAAM,CAAU;IAChB,UAAU,CAAQ;IAClB,SAAS,CAAe;IACxB,MAAM,CAAU;CACjB"}

package/dist/entities/ranking-post-score.entity.d.ts

@@ -0,0 +1,13 @@
+export declare class RankingPostScoreEntity {
+    userId: string;
+    postId: string;
+    authorId: string;
+    origin: string;
+    score: number;
+    structuralScore: number;
+    semanticScore: number | null;
+    rank: number;
+    reasons: string[];
+    computedAt: Date;
+}
+//# sourceMappingURL=ranking-post-score.entity.d.ts.map

package/dist/entities/ranking-post-score.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-post-score.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-post-score.entity.ts"],"names":[],"mappings":"AACA,qBAAa,sBAAsB;IACjC,MAAM,EAAG,MAAM,CAAC;IAChB,MAAM,EAAG,MAAM,CAAC;IAChB,QAAQ,EAAG,MAAM,CAAC;IAElB,MAAM,EAAG,MAAM,CAAC;IAChB,KAAK,EAAG,MAAM,CAAC;IACf,eAAe,EAAG,MAAM,CAAC;IACzB,aAAa,EAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAG,MAAM,CAAC;IACd,OAAO,EAAG,MAAM,EAAE,CAAC;IACnB,UAAU,EAAG,IAAI,CAAC;CACnB"}

package/dist/entities/ranking-post-score.entity.js

@@ -0,0 +1,13 @@
+export class RankingPostScoreEntity {
+    userId;
+    postId;
+    authorId;
+    origin;
+    score;
+    structuralScore;
+    semanticScore;
+    rank;
+    reasons;
+    computedAt;
+}
+//# sourceMappingURL=ranking-post-score.entity.js.map

package/dist/entities/ranking-post-score.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-post-score.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-post-score.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,sBAAsB;IACjC,MAAM,CAAU;IAChB,MAAM,CAAU;IAChB,QAAQ,CAAU;IAElB,MAAM,CAAU;IAChB,KAAK,CAAU;IACf,eAAe,CAAU;IACzB,aAAa,CAAiB;IAC9B,IAAI,CAAU;IACd,OAAO,CAAY;IACnB,UAAU,CAAQ;CACnB"}

package/dist/entities/ranking-rate-bucket.entity.d.ts

@@ -0,0 +1,7 @@
+export declare class RankingRateBucketEntity {
+    userId: string;
+    bucket: string;
+    tokens: number;
+    updatedAt: Date;
+}
+//# sourceMappingURL=ranking-rate-bucket.entity.d.ts.map

package/dist/entities/ranking-rate-bucket.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-rate-bucket.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-rate-bucket.entity.ts"],"names":[],"mappings":"AACA,qBAAa,uBAAuB;IAClC,MAAM,EAAG,MAAM,CAAC;IAChB,MAAM,EAAG,MAAM,CAAC;IAChB,MAAM,EAAG,MAAM,CAAC;IAChB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/entities/ranking-rate-bucket.entity.js

@@ -0,0 +1,7 @@
+export class RankingRateBucketEntity {
+    userId;
+    bucket;
+    tokens;
+    updatedAt;
+}
+//# sourceMappingURL=ranking-rate-bucket.entity.js.map

package/dist/entities/ranking-rate-bucket.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-rate-bucket.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-rate-bucket.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,uBAAuB;IAClC,MAAM,CAAU;IAChB,MAAM,CAAU;IAChB,MAAM,CAAU;IAChB,SAAS,CAAQ;CAClB"}

package/dist/entities/ranking-request.entity.d.ts

@@ -0,0 +1,8 @@
+export declare class RankingRequestEntity {
+    userId: string;
+    listKind: string;
+    requestedAt: Date;
+    reason: string;
+    jobEnqueuedAt: Date;
+}
+//# sourceMappingURL=ranking-request.entity.d.ts.map

package/dist/entities/ranking-request.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-request.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-request.entity.ts"],"names":[],"mappings":"AACA,qBAAa,oBAAoB;IAC/B,MAAM,EAAG,MAAM,CAAC;IAChB,QAAQ,EAAG,MAAM,CAAC;IAClB,WAAW,EAAG,IAAI,CAAC;IACnB,MAAM,EAAG,MAAM,CAAC;IAChB,aAAa,EAAG,IAAI,CAAC;CACtB"}

package/dist/entities/ranking-request.entity.js

@@ -0,0 +1,8 @@
+export class RankingRequestEntity {
+    userId;
+    listKind;
+    requestedAt;
+    reason;
+    jobEnqueuedAt;
+}
+//# sourceMappingURL=ranking-request.entity.js.map

package/dist/entities/ranking-request.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-request.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-request.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAU;IAChB,QAAQ,CAAU;IAClB,WAAW,CAAQ;IACnB,MAAM,CAAU;IAChB,aAAa,CAAQ;CACtB"}

package/dist/entities/ranking-run.entity.d.ts

@@ -0,0 +1,17 @@
+export declare class RankingRunEntity {
+    userId: string;
+    listKind: string;
+    listVersion: string;
+    startedAt: Date;
+    computedAt: Date;
+    source: string;
+    formulaVersion: number;
+    reason: string;
+    candidateCount: number;
+    jevScoredCount: number;
+    jevInputTokens: number | null;
+    jevOutputTokens: number | null;
+    durationMs: number;
+    lastError: string | null;
+}
+//# sourceMappingURL=ranking-run.entity.d.ts.map

package/dist/entities/ranking-run.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-run.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-run.entity.ts"],"names":[],"mappings":"AACA,qBAAa,gBAAgB;IAC3B,MAAM,EAAG,MAAM,CAAC;IAChB,QAAQ,EAAG,MAAM,CAAC;IAElB,WAAW,EAAG,MAAM,CAAC;IACrB,SAAS,EAAG,IAAI,CAAC;IACjB,UAAU,EAAG,IAAI,CAAC;IAClB,MAAM,EAAG,MAAM,CAAC;IAChB,cAAc,EAAG,MAAM,CAAC;IACxB,MAAM,EAAG,MAAM,CAAC;IAChB,cAAc,EAAG,MAAM,CAAC;IACxB,cAAc,EAAG,MAAM,CAAC;IACxB,cAAc,EAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAG,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAG,MAAM,CAAC;IACpB,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/entities/ranking-run.entity.js

@@ -0,0 +1,17 @@
+export class RankingRunEntity {
+    userId;
+    listKind;
+    listVersion;
+    startedAt;
+    computedAt;
+    source;
+    formulaVersion;
+    reason;
+    candidateCount;
+    jevScoredCount;
+    jevInputTokens;
+    jevOutputTokens;
+    durationMs;
+    lastError;
+}
+//# sourceMappingURL=ranking-run.entity.js.map

package/dist/entities/ranking-run.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-run.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-run.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAU;IAChB,QAAQ,CAAU;IAElB,WAAW,CAAU;IACrB,SAAS,CAAQ;IACjB,UAAU,CAAQ;IAClB,MAAM,CAAU;IAChB,cAAc,CAAU;IACxB,MAAM,CAAU;IAChB,cAAc,CAAU;IACxB,cAAc,CAAU;IACxB,cAAc,CAAiB;IAC/B,eAAe,CAAiB;IAChC,UAAU,CAAU;IACpB,SAAS,CAAiB;CAC3B"}

package/dist/entities/ranking-score.entity.d.ts

@@ -0,0 +1,11 @@
+export declare class RankingScoreEntity {
+    userId: string;
+    eventId: string;
+    score: number;
+    structuralScore: number;
+    semanticScore: number | null;
+    rank: number;
+    reasons: string[];
+    computedAt: Date;
+}
+//# sourceMappingURL=ranking-score.entity.d.ts.map

package/dist/entities/ranking-score.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-score.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-score.entity.ts"],"names":[],"mappings":"AACA,qBAAa,kBAAkB;IAC7B,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAG,MAAM,CAAC;IACjB,KAAK,EAAG,MAAM,CAAC;IACf,eAAe,EAAG,MAAM,CAAC;IACzB,aAAa,EAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAG,MAAM,CAAC;IAEd,OAAO,EAAG,MAAM,EAAE,CAAC;IACnB,UAAU,EAAG,IAAI,CAAC;CACnB"}

package/dist/entities/ranking-score.entity.js

@@ -0,0 +1,11 @@
+export class RankingScoreEntity {
+    userId;
+    eventId;
+    score;
+    structuralScore;
+    semanticScore;
+    rank;
+    reasons;
+    computedAt;
+}
+//# sourceMappingURL=ranking-score.entity.js.map

package/dist/entities/ranking-score.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-score.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-score.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,KAAK,CAAU;IACf,eAAe,CAAU;IACzB,aAAa,CAAiB;IAC9B,IAAI,CAAU;IAEd,OAAO,CAAY;IACnB,UAAU,CAAQ;CACnB"}

package/dist/entities/ranking-user-location.entity.d.ts

@@ -0,0 +1,6 @@
+export declare class RankingUserLocationEntity {
+    userId: string;
+    locationEnc: Buffer;
+    updatedAt: Date;
+}
+//# sourceMappingURL=ranking-user-location.entity.d.ts.map

package/dist/entities/ranking-user-location.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-user-location.entity.d.ts","sourceRoot":"","sources":["../../src/entities/ranking-user-location.entity.ts"],"names":[],"mappings":"AACA,qBAAa,yBAAyB;IACpC,MAAM,EAAG,MAAM,CAAC;IAChB,WAAW,EAAG,MAAM,CAAC;IACrB,SAAS,EAAG,IAAI,CAAC;CAClB"}

package/dist/entities/ranking-user-location.entity.js

@@ -0,0 +1,6 @@
+export class RankingUserLocationEntity {
+    userId;
+    locationEnc;
+    updatedAt;
+}
+//# sourceMappingURL=ranking-user-location.entity.js.map

package/dist/entities/ranking-user-location.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-user-location.entity.js","sourceRoot":"","sources":["../../src/entities/ranking-user-location.entity.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,yBAAyB;IACpC,MAAM,CAAU;IAChB,WAAW,CAAU;IACrB,SAAS,CAAQ;CAClB"}

package/dist/enums/index.d.ts

@@ -0,0 +1,52 @@
+export declare const RankingListKind: {
+    readonly EVENT: "EVENT";
+    readonly POST: "POST";
+};
+export type RankingListKind = (typeof RankingListKind)[keyof typeof RankingListKind];
+export declare const RankingRunSource: {
+    readonly FULL: "FULL";
+    readonly STRUCTURAL_ONLY: "STRUCTURAL_ONLY";
+    readonly COLD_START: "COLD_START";
+};
+export type RankingRunSource = (typeof RankingRunSource)[keyof typeof RankingRunSource];
+export declare const EventRankingReason: {
+    readonly FRIEND_INVOLVED: "FRIEND_INVOLVED";
+    readonly NEAR_YOU: "NEAR_YOU";
+    readonly MATCHES_INTERESTS: "MATCHES_INTERESTS";
+    readonly STARTING_SOON: "STARTING_SOON";
+    readonly TRENDING: "TRENDING";
+};
+export type EventRankingReason = (typeof EventRankingReason)[keyof typeof EventRankingReason];
+export declare const PostRankingReason: {
+    readonly FOLLOWED_AUTHOR: "FOLLOWED_AUTHOR";
+    readonly FRIEND_AUTHOR: "FRIEND_AUTHOR";
+    readonly ENGAGED_AUTHOR: "ENGAGED_AUTHOR";
+    readonly LINKED_EVENT_WISHED: "LINKED_EVENT_WISHED";
+    readonly LINKED_EVENT_JOINED: "LINKED_EVENT_JOINED";
+    readonly RECENT: "RECENT";
+};
+export type PostRankingReason = (typeof PostRankingReason)[keyof typeof PostRankingReason];
+export type RankingReason = EventRankingReason | PostRankingReason;
+export declare const PostOrigin: {
+    readonly FOLLOWED: "FOLLOWED";
+    readonly ENGAGED: "ENGAGED";
+    readonly EVENT: "EVENT";
+    readonly GLOBAL: "GLOBAL";
+};
+export type PostOrigin = (typeof PostOrigin)[keyof typeof PostOrigin];
+export declare const FeedbackAction: {
+    readonly PASS: "PASS";
+};
+export type FeedbackAction = (typeof FeedbackAction)[keyof typeof FeedbackAction];
+export declare const RateBucketName: {
+    readonly REFRESH: "REFRESH";
+    readonly LOCATION: "LOCATION";
+};
+export type RateBucketName = (typeof RateBucketName)[keyof typeof RateBucketName];
+export declare const LikeOrigin: {
+    readonly STREAM: "STREAM";
+    readonly BACKFILL: "BACKFILL";
+};
+export type LikeOrigin = (typeof LikeOrigin)[keyof typeof LikeOrigin];
+export type EventType = 'SOCIAL' | 'ECOLOGY';
+//# sourceMappingURL=index.d.ts.map

package/dist/enums/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAGrF,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAExF,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE3F,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAGnE,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,eAAO,MAAM,cAAc;;CAEjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,eAAO,MAAM,UAAU;;;CAGb,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC"}