@ahhaohho/event-publisher 0.1.2 → 0.2.0

package/README.md

@@ -134,6 +134,7 @@ payload에는 id와 작은 사실값만 싣는다. 닉네임·댓글 본문·썸
 | `ai.comment.created` | ai-chatbot | comment.service.ts | 봇 계정 | 게시자 |
 | `app.activity.challenge_viewed` | challenge | 챌린지 상세 API | 본인 | 본인 |
 | `app.activity.gallery_post_viewed` | gallery | 갤러리 상세 API | 본인 | 본인 |
+| `app.activity.session_active` | gallery, challenge | 인증된 앱 요청 (사용자당 ~10분 throttle, 박스별 중복 가능 → 소비자 debounce) | 본인 | 본인 |
 | `app.activity.post_step_viewed` | (POST /activity 수신 서버) | 앱 신호 | 본인 | 본인 |
 | `campaign.schedule.fired` | notification (Scheduler) | — | null | (비움) |
 

package/dist/catalog/app-activity.d.ts

@@ -5,7 +5,9 @@ import { z } from 'zod';
  * - 서버가 API 호출에서 직접 아는 신호는 해당 서버가 발행한다 (challenge_viewed, gallery_post_viewed).
  * - 서버가 모르는 화면 단계 신호(post_step_viewed)만 앱이 `POST /activity`로 보내고, 받는 서버가 발행한다.
  * - userId는 항상 JWT 검증값이다. 요청 body/query의 userId를 쓰지 않는다.
- * - 단순 접속(lastActiveAt)은 요청마다 이벤트를 만들지 않고 Redis → DB로 따로 반영한다.
+ * - 단순 접속(lastActiveAt)은 session_active 이벤트로 반영한다. prod는 박스별 Redis라 서버 간에 접속 상태를
+ *   공유할 수 없어서, 발행 서버가 사용자당 약 10분 간격으로 throttle해 발행한다.
+ *   throttle이 박스별이므로 같은 사용자의 이벤트가 박스 수만큼 중복될 수 있고, 소비자가 debounce한다.
  */
 export declare const appActivityEvents: {
     'app.activity.challenge_viewed': import("../envelope").EventDefinition<z.ZodObject<{
@@ -17,6 +19,9 @@ export declare const appActivityEvents: {
         galleryId: z.ZodString;
         communityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    'app.activity.session_active': import("../envelope").EventDefinition<z.ZodObject<{
+        userId: z.ZodString;
+    }, z.core.$strip>>;
     'app.activity.post_step_viewed': import("../envelope").EventDefinition<z.ZodObject<{
         userId: z.ZodString;
         stepId: z.ZodString;

package/dist/catalog/app-activity.js

@@ -9,7 +9,9 @@ const envelope_1 = require("../envelope");
  * - 서버가 API 호출에서 직접 아는 신호는 해당 서버가 발행한다 (challenge_viewed, gallery_post_viewed).
  * - 서버가 모르는 화면 단계 신호(post_step_viewed)만 앱이 `POST /activity`로 보내고, 받는 서버가 발행한다.
  * - userId는 항상 JWT 검증값이다. 요청 body/query의 userId를 쓰지 않는다.
- * - 단순 접속(lastActiveAt)은 요청마다 이벤트를 만들지 않고 Redis → DB로 따로 반영한다.
+ * - 단순 접속(lastActiveAt)은 session_active 이벤트로 반영한다. prod는 박스별 Redis라 서버 간에 접속 상태를
+ *   공유할 수 없어서, 발행 서버가 사용자당 약 10분 간격으로 throttle해 발행한다.
+ *   throttle이 박스별이므로 같은 사용자의 이벤트가 박스 수만큼 중복될 수 있고, 소비자가 debounce한다.
  */
 exports.appActivityEvents = {
     'app.activity.challenge_viewed': (0, envelope_1.defineEvent)({
@@ -35,6 +37,16 @@ exports.appActivityEvents = {
         actor: (p) => p.userId,
         subjects: (p) => [p.userId],
     }),
+    'app.activity.session_active': (0, envelope_1.defineEvent)({
+        version: 1,
+        publishers: ['ao-gallery-server', 'ao-challenge-server'],
+        description: '인증된 앱 요청 = 접속 신호 (S3 비활동 트리거 lastActiveAt). 발행 서버가 사용자당 약 10분 간격으로 throttle',
+        schema: zod_1.z.object({
+            userId: envelope_1.ids.userId,
+        }),
+        actor: (p) => p.userId,
+        subjects: (p) => [p.userId],
+    }),
     'app.activity.post_step_viewed': (0, envelope_1.defineEvent)({
         version: 1,
         // POST /activity를 받을 서버는 S3 카드(qSPjswwl)에서 확정 — 우선 notification-server로 둔다.

package/dist/catalog/index.d.ts

@@ -26,6 +26,9 @@ export declare const catalog: {
         galleryId: z.ZodString;
         communityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    readonly 'app.activity.session_active': import("../envelope").EventDefinition<z.ZodObject<{
+        userId: z.ZodString;
+    }, z.core.$strip>>;
     readonly 'app.activity.post_step_viewed': import("../envelope").EventDefinition<z.ZodObject<{
         userId: z.ZodString;
         stepId: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahhaohho/event-publisher",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "AhhaOhho 도메인 이벤트 발행 SDK — EventBridge envelope + Zod 이벤트 카탈로그",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",