@abyss-project/main 15.2.0 → 16.0.0

package/dist/types/interface/api/responses/activity.admin.response.d.ts

@@ -0,0 +1,90 @@
+import { AbyssService } from '../../../enum/abyss-service.enum';
+import { ActivityStatus } from '../../../enum/activity.enum';
+import { OrganizationKind } from '../../../enum/organization-kind.enum';
+import { IActivityScore } from '../../models/activity.model';
+import { BasePaginate } from '../type-message/base-paginate';
+import { IResponse } from '../type-message/response';
+export interface IActivityOverviewAdminData {
+    active7: number;
+    active30: number;
+    inactive: number;
+    never: number;
+    averageActivityScore: number | null;
+    averageUsageScore: number | null;
+}
+export interface IActivityUserIdentity {
+    id: string;
+    alias: string;
+    email: string;
+}
+export interface IActivityOrganizationIdentity {
+    id: string;
+    name: string;
+    kind: OrganizationKind;
+}
+export interface IActivityUserRowAdmin {
+    user: IActivityUserIdentity;
+    enabledServices: AbyssService[];
+    activityScore: number | null;
+    usageScore: number;
+    status: ActivityStatus;
+    lastSeenAt: string | null;
+}
+export interface IActivityOrganizationRowAdmin {
+    organization: IActivityOrganizationIdentity;
+    memberCount: number;
+    enabledServices: AbyssService[];
+    activityScore: number | null;
+    usageScore: number;
+    status: ActivityStatus;
+    lastSeenAt: string | null;
+}
+export interface IActivityPresenceCell {
+    day: string;
+    actionCount: number | null;
+}
+export interface IActivityPresenceRow {
+    service: AbyssService;
+    days: IActivityPresenceCell[];
+}
+export interface IActivityScoreHistoryPoint {
+    day: string;
+    activityScore: number | null;
+    usageScore: number;
+}
+export interface IGetUserActivityAdminData {
+    user: IActivityUserIdentity;
+    enabledServices: AbyssService[];
+    score: IActivityScore | null;
+    presence: IActivityPresenceRow[];
+    snapshots: IActivityScoreHistoryPoint[];
+}
+export interface IGetOrganizationActivityAdminData {
+    organization: IActivityOrganizationIdentity;
+    enabledServices: AbyssService[];
+    score: IActivityScore | null;
+    presence: IActivityPresenceRow[];
+    members: IActivityUserRowAdmin[];
+    snapshots: IActivityScoreHistoryPoint[];
+}
+export interface IActivityDailyActiveUsers {
+    day: string;
+    activeUsers: number;
+}
+export interface IActivityServiceAdoption {
+    service: AbyssService;
+    enabledCount: number;
+    active30Count: number;
+    activationRate: number;
+    activityRate: number;
+    dailyActiveUsers: IActivityDailyActiveUsers[];
+}
+export interface IGetServicesActivityAdminData {
+    services: IActivityServiceAdoption[];
+}
+export type IGetOverviewActivityAdminResponse = IResponse<IActivityOverviewAdminData>;
+export type IPaginateUsersActivityAdminResponse = IResponse<BasePaginate<IActivityUserRowAdmin>>;
+export type IGetUserActivityAdminResponse = IResponse<IGetUserActivityAdminData>;
+export type IPaginateOrganizationsActivityAdminResponse = IResponse<BasePaginate<IActivityOrganizationRowAdmin>>;
+export type IGetOrganizationActivityAdminResponse = IResponse<IGetOrganizationActivityAdminData>;
+export type IGetServicesActivityAdminResponse = IResponse<IGetServicesActivityAdminData>;

package/dist/types/interface/api/responses/activity.admin.response.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=activity.admin.response.js.map

package/dist/types/interface/api/responses/activity.admin.response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.admin.response.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/responses/activity.admin.response.ts"],"names":[],"mappings":""}

package/dist/types/interface/api/responses/analytics-snapshot.response.d.ts

@@ -25,8 +25,6 @@ export interface IUsageAnalyticsAdminData {
         applications: number;
     };
     activity: {
-        activeUsers7d: number;
-        activeUsers30d: number;
         newUsers30d: number;
     };
     storage: {

package/dist/types/interface/api/responses/index.d.ts

@@ -50,3 +50,4 @@ export * from './user-sidebar-pin.response';
 export * from './session.response';
 export * from './mcp-connection.response';
 export * from './oauth-authorization-request.response';
+export * from './activity.admin.response';

package/dist/types/interface/api/responses/index.js

@@ -66,4 +66,5 @@ __exportStar(require("./user-sidebar-pin.response"), exports);
 __exportStar(require("./session.response"), exports);
 __exportStar(require("./mcp-connection.response"), exports);
 __exportStar(require("./oauth-authorization-request.response"), exports);
+__exportStar(require("./activity.admin.response"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/interface/api/responses/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/responses/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,+DAA6C;AAC7C,yDAAuC;AACvC,mDAAiC;AACjC,kDAAgC;AAChC,6DAA2C;AAC3C,mEAAiD;AACjD,6DAA2C;AAC3C,0DAAwC;AACxC,wEAAsD;AACtD,iEAA+C;AAC/C,2DAAyC;AACzC,qDAAmC;AACnC,2DAAyC;AACzC,iEAA+C;AAC/C,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,2DAAyC;AACzC,2DAAyC;AACzC,iDAA+B;AAC/B,qDAAmC;AACnC,8DAA4C;AAC5C,qDAAmC;AACnC,kEAAgD;AAChD,kFAAgE;AAChE,4EAA0D;AAC1D,iEAA+C;AAC/C,gEAA8C;AAC9C,0DAAwC;AACxC,mEAAiD;AACjD,sDAAoC;AACpC,kEAAgD;AAChD,4DAA0C;AAC1C,6DAA2C;AAC3C,8DAA4C;AAC5C,2DAAyC;AACzC,qDAAmC;AACnC,4DAA0C;AAC1C,kDAAgC;AAChC,iEAA+C;AAC/C,0DAAwC;AACxC,iEAA+C;AAC/C,iEAA+C;AAC/C,qEAAmD;AACnD,+DAA6C;AAC7C,wDAAsC;AACtC,kDAAgC;AAChC,8DAA4C;AAC5C,qDAAmC;AACnC,4DAA0C;AAC1C,yEAAuD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/responses/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,+DAA6C;AAC7C,yDAAuC;AACvC,mDAAiC;AACjC,kDAAgC;AAChC,6DAA2C;AAC3C,mEAAiD;AACjD,6DAA2C;AAC3C,0DAAwC;AACxC,wEAAsD;AACtD,iEAA+C;AAC/C,2DAAyC;AACzC,qDAAmC;AACnC,2DAAyC;AACzC,iEAA+C;AAC/C,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,2DAAyC;AACzC,2DAAyC;AACzC,iDAA+B;AAC/B,qDAAmC;AACnC,8DAA4C;AAC5C,qDAAmC;AACnC,kEAAgD;AAChD,kFAAgE;AAChE,4EAA0D;AAC1D,iEAA+C;AAC/C,gEAA8C;AAC9C,0DAAwC;AACxC,mEAAiD;AACjD,sDAAoC;AACpC,kEAAgD;AAChD,4DAA0C;AAC1C,6DAA2C;AAC3C,8DAA4C;AAC5C,2DAAyC;AACzC,qDAAmC;AACnC,4DAA0C;AAC1C,kDAAgC;AAChC,iEAA+C;AAC/C,0DAAwC;AACxC,iEAA+C;AAC/C,iEAA+C;AAC/C,qEAAmD;AACnD,+DAA6C;AAC7C,wDAAsC;AACtC,kDAAgC;AAChC,8DAA4C;AAC5C,qDAAmC;AACnC,4DAA0C;AAC1C,yEAAuD;AACvD,4DAA0C"}

package/dist/types/interface/index.d.ts

@@ -75,3 +75,4 @@ export * from './models/passkey.model';
 export * from './models/mcp-connection.model';
 export * from './models/mcp-connection-read.model';
 export * from './mcp';
+export * from './models/activity.model';

package/dist/types/interface/index.js

@@ -91,4 +91,5 @@ __exportStar(require("./models/passkey.model"), exports);
 __exportStar(require("./models/mcp-connection.model"), exports);
 __exportStar(require("./models/mcp-connection-read.model"), exports);
 __exportStar(require("./mcp"), exports);
+__exportStar(require("./models/activity.model"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/interface/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/interface/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,yDAAuC;AACvC,gEAA8C;AAC9C,4EAA0D;AAC1D,6DAA2C;AAC3C,mEAAiD;AACjD,yEAAuD;AACvD,+DAA6C;AAC7C,+DAA6C;AAC7C,8DAA4C;AAC5C,mEAAiD;AACjD,oEAAkD;AAGlD,2DAAyC;AACzC,sEAAoD;AAGpD,wCAAsB;AAGtB,uDAAqC;AAGrC,wDAAsC;AACtC,gEAA8C;AAC9C,8DAA4C;AAC5C,oEAAkD;AAClD,8EAA4D;AAC5D,kFAAgE;AAGhE,8DAA4C;AAC5C,0EAAwD;AACxD,qEAAmD;AACnD,gFAA8D;AAC9D,mEAAiD;AAGjD,+DAA6C;AAC7C,iEAA+C;AAC/C,uEAAqD;AACrD,4EAA0D;AAC1D,4EAA0D;AAC1D,8DAA4C;AAC5C,yDAAuC;AACvC,8DAA4C;AAC5C,oEAAkD;AAClD,6DAA2C;AAC3C,oEAAkD;AAClD,iEAA+C;AAC/C,0EAAwD;AACxD,6DAA2C;AAC3C,sEAAoD;AACpD,mEAAiD;AACjD,mEAAiD;AACjD,kEAAgD;AAChD,qEAAmD;AACnD,wEAAsD;AACtD,+DAA6C;AAC7C,8DAA4C;AAC5C,qEAAmD;AACnD,sDAAoC;AACpC,6DAA2C;AAC3C,qEAAmD;AACnD,iFAA+D;AAC/D,iEAA+C;AAC/C,oFAAkE;AAGlE,kEAAgD;AAGhD,mEAAiD;AAGjD,+DAA6C;AAO7C,gEAA8C;AAG9C,gEAA8C;AAC9C,wEAAsD;AACtD,2EAAyD;AACzD,oEAAkD;AAClD,yEAAuD;AAGvD,4DAA0C;AAG1C,4DAA0C;AAG1C,qEAAmD;AAGnD,qEAAmD;AAGnD,kEAAgD;AAGhD,iEAA+C;AAC/C,4DAA0C;AAG1C,yDAAuC;AACvC,yDAAuC;AAGvC,gEAA8C;AAC9C,qEAAmD;AACnD,wCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/interface/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,yDAAuC;AACvC,gEAA8C;AAC9C,4EAA0D;AAC1D,6DAA2C;AAC3C,mEAAiD;AACjD,yEAAuD;AACvD,+DAA6C;AAC7C,+DAA6C;AAC7C,8DAA4C;AAC5C,mEAAiD;AACjD,oEAAkD;AAGlD,2DAAyC;AACzC,sEAAoD;AAGpD,wCAAsB;AAGtB,uDAAqC;AAGrC,wDAAsC;AACtC,gEAA8C;AAC9C,8DAA4C;AAC5C,oEAAkD;AAClD,8EAA4D;AAC5D,kFAAgE;AAGhE,8DAA4C;AAC5C,0EAAwD;AACxD,qEAAmD;AACnD,gFAA8D;AAC9D,mEAAiD;AAGjD,+DAA6C;AAC7C,iEAA+C;AAC/C,uEAAqD;AACrD,4EAA0D;AAC1D,4EAA0D;AAC1D,8DAA4C;AAC5C,yDAAuC;AACvC,8DAA4C;AAC5C,oEAAkD;AAClD,6DAA2C;AAC3C,oEAAkD;AAClD,iEAA+C;AAC/C,0EAAwD;AACxD,6DAA2C;AAC3C,sEAAoD;AACpD,mEAAiD;AACjD,mEAAiD;AACjD,kEAAgD;AAChD,qEAAmD;AACnD,wEAAsD;AACtD,+DAA6C;AAC7C,8DAA4C;AAC5C,qEAAmD;AACnD,sDAAoC;AACpC,6DAA2C;AAC3C,qEAAmD;AACnD,iFAA+D;AAC/D,iEAA+C;AAC/C,oFAAkE;AAGlE,kEAAgD;AAGhD,mEAAiD;AAGjD,+DAA6C;AAO7C,gEAA8C;AAG9C,gEAA8C;AAC9C,wEAAsD;AACtD,2EAAyD;AACzD,oEAAkD;AAClD,yEAAuD;AAGvD,4DAA0C;AAG1C,4DAA0C;AAG1C,qEAAmD;AAGnD,qEAAmD;AAGnD,kEAAgD;AAGhD,iEAA+C;AAC/C,4DAA0C;AAG1C,yDAAuC;AACvC,yDAAuC;AAGvC,gEAA8C;AAC9C,qEAAmD;AACnD,wCAAsB;AAGtB,0DAAwC"}

package/dist/types/interface/models/activity.model.d.ts

@@ -0,0 +1,51 @@
+import { AbyssService } from '../../enum/abyss-service.enum';
+import { ActivityStatus, ActivitySubjectType } from '../../enum/activity.enum';
+export interface IUserServiceActivityDay {
+    id: string;
+    userId: string;
+    service: AbyssService;
+    day: string;
+    firstSeenAt: Date;
+    actionCount: number | null;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+export interface IProjectServiceActivityDay {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    service: AbyssService;
+    day: string;
+    actionCount: number | null;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+export interface IActivityBreakdownEntry {
+    service: AbyssService;
+    enabled: boolean;
+    activeDays30: number;
+    regularity: number;
+    actionCount30: number | null;
+}
+export interface IActivityScore {
+    subjectType: ActivitySubjectType;
+    userId: string | null;
+    organizationId: string | null;
+    activityScore: number | null;
+    usageScore: number;
+    status: ActivityStatus;
+    lastSeenAt: string | null;
+    breakdown: IActivityBreakdownEntry[];
+    computedAt: string;
+}
+export interface IActivityScoreSnapshot {
+    id: string;
+    subjectType: ActivitySubjectType;
+    userId: string | null;
+    organizationId: string | null;
+    day: string;
+    activityScore: number | null;
+    usageScore: number;
+    createdAt?: Date;
+    updatedAt?: Date;
+}

package/dist/types/interface/models/activity.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=activity.model.js.map

package/dist/types/interface/models/activity.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.model.js","sourceRoot":"","sources":["../../../../src/types/interface/models/activity.model.ts"],"names":[],"mappings":""}

package/dist/types/interface/models/index.d.ts

@@ -64,3 +64,4 @@ export * from './session.model';
 export * from './passkey.model';
 export * from './mcp-connection.model';
 export * from './mcp-connection-read.model';
+export * from './activity.model';

package/dist/types/interface/models/index.js

@@ -80,4 +80,5 @@ __exportStar(require("./session.model"), exports);
 __exportStar(require("./passkey.model"), exports);
 __exportStar(require("./mcp-connection.model"), exports);
 __exportStar(require("./mcp-connection-read.model"), exports);
+__exportStar(require("./activity.model"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/interface/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/interface/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC;AAChC,yDAAuC;AACvC,qEAAmD;AACnD,sDAAoC;AACpC,4DAA0C;AAC1C,wDAAsC;AACtC,wDAAsC;AACtC,uDAAqC;AACrC,4DAA0C;AAC1C,6DAA2C;AAG3C,oDAAkC;AAClC,+DAA6C;AAG7C,gDAA8B;AAG9B,iDAA+B;AAG/B,uDAAqC;AACrC,mEAAiD;AACjD,8DAA4C;AAG5C,wDAAsC;AACtC,0DAAwC;AACxC,gEAA8C;AAC9C,qEAAmD;AACnD,qEAAmD;AACnD,uDAAqC;AACrC,kDAAgC;AAChC,uDAAqC;AACrC,6DAA2C;AAC3C,sDAAoC;AACpC,6DAA2C;AAC3C,0DAAwC;AACxC,mEAAiD;AACjD,sDAAoC;AACpC,+DAA6C;AAC7C,4DAA0C;AAC1C,4DAA0C;AAC1C,2DAAyC;AACzC,8DAA4C;AAC5C,iEAA+C;AAC/C,wDAAsC;AACtC,uDAAqC;AACrC,8DAA4C;AAC5C,+CAA6B;AAC7B,sDAAoC;AACpC,8DAA4C;AAC5C,0EAAwD;AACxD,0DAAwC;AACxC,6EAA2D;AAG3D,2DAAyC;AAGzC,4DAA0C;AAG1C,wDAAsC;AAGtC,yDAAuC;AACvC,iEAA+C;AAC/C,oEAAkD;AAClD,yDAAuC;AACvC,6DAA2C;AAC3C,kEAAgD;AAGhD,qDAAmC;AAGnC,qDAAmC;AAGnC,8DAA4C;AAG5C,8DAA4C;AAG5C,2DAAyC;AAGzC,0DAAwC;AAGxC,kDAAgC;AAChC,kDAAgC;AAGhC,yDAAuC;AACvC,8DAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/interface/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC;AAChC,yDAAuC;AACvC,qEAAmD;AACnD,sDAAoC;AACpC,4DAA0C;AAC1C,wDAAsC;AACtC,wDAAsC;AACtC,uDAAqC;AACrC,4DAA0C;AAC1C,6DAA2C;AAG3C,oDAAkC;AAClC,+DAA6C;AAG7C,gDAA8B;AAG9B,iDAA+B;AAG/B,uDAAqC;AACrC,mEAAiD;AACjD,8DAA4C;AAG5C,wDAAsC;AACtC,0DAAwC;AACxC,gEAA8C;AAC9C,qEAAmD;AACnD,qEAAmD;AACnD,uDAAqC;AACrC,kDAAgC;AAChC,uDAAqC;AACrC,6DAA2C;AAC3C,sDAAoC;AACpC,6DAA2C;AAC3C,0DAAwC;AACxC,mEAAiD;AACjD,sDAAoC;AACpC,+DAA6C;AAC7C,4DAA0C;AAC1C,4DAA0C;AAC1C,2DAAyC;AACzC,8DAA4C;AAC5C,iEAA+C;AAC/C,wDAAsC;AACtC,uDAAqC;AACrC,8DAA4C;AAC5C,+CAA6B;AAC7B,sDAAoC;AACpC,8DAA4C;AAC5C,0EAAwD;AACxD,0DAAwC;AACxC,6EAA2D;AAG3D,2DAAyC;AAGzC,4DAA0C;AAG1C,wDAAsC;AAGtC,yDAAuC;AACvC,iEAA+C;AAC/C,oEAAkD;AAClD,yDAAuC;AACvC,6DAA2C;AAC3C,kEAAgD;AAGhD,qDAAmC;AAGnC,qDAAmC;AAGnC,8DAA4C;AAG5C,8DAA4C;AAG5C,2DAAyC;AAGzC,0DAAwC;AAGxC,kDAAgC;AAChC,kDAAgC;AAGhC,yDAAuC;AACvC,8DAA4C;AAG5C,mDAAiC"}

package/dist/utils/index.d.ts

@@ -24,6 +24,7 @@ export * from './invitation.utils';
 export * from './invoice-amounts.utils';
 export * from './invoice-line-label.utils';
 export * from './resolve-user.utils';
+export * from './record-presence.utils';
 export * from './pricing.utils';
 export * from './plan-capacity.utils';
 export * from './billing-deep-link.utils';

package/dist/utils/index.js

@@ -40,6 +40,7 @@ __exportStar(require("./invitation.utils"), exports);
 __exportStar(require("./invoice-amounts.utils"), exports);
 __exportStar(require("./invoice-line-label.utils"), exports);
 __exportStar(require("./resolve-user.utils"), exports);
+__exportStar(require("./record-presence.utils"), exports);
 __exportStar(require("./pricing.utils"), exports);
 __exportStar(require("./plan-capacity.utils"), exports);
 __exportStar(require("./billing-deep-link.utils"), exports);

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,gDAA8B;AAC9B,0DAAwC;AACxC,+CAA6B;AAC7B,iDAA+B;AAC/B,uDAAqC;AACrC,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,+CAA6B;AAC7B,sDAAoC;AACpC,iDAA+B;AAC/B,mDAAiC;AACjC,mDAAiC;AACjC,sDAAoC;AACpC,kDAAgC;AAChC,wDAAsC;AACtC,wDAAsC;AACtC,wDAAsC;AACtC,6DAA2C;AAC3C,8DAA4C;AAC5C,qDAAmC;AACnC,0DAAwC;AACxC,6DAA2C;AAC3C,uDAAqC;AAIrC,kDAAgC;AAChC,wDAAsC;AACtC,4DAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,gDAA8B;AAC9B,0DAAwC;AACxC,+CAA6B;AAC7B,iDAA+B;AAC/B,uDAAqC;AACrC,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,gDAA8B;AAC9B,+CAA6B;AAC7B,sDAAoC;AACpC,iDAA+B;AAC/B,mDAAiC;AACjC,mDAAiC;AACjC,sDAAoC;AACpC,kDAAgC;AAChC,wDAAsC;AACtC,wDAAsC;AACtC,wDAAsC;AACtC,6DAA2C;AAC3C,8DAA4C;AAC5C,qDAAmC;AACnC,0DAAwC;AACxC,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AAIxC,kDAAgC;AAChC,wDAAsC;AACtC,4DAA0C"}

package/dist/utils/record-presence.utils.d.ts

@@ -0,0 +1,18 @@
+import { AbyssService } from '../types/enum/abyss-service.enum';
+export interface IPresenceRedis {
+    set(key: string, value: string, mode: 'EX', ttl: number, flag: 'NX'): Promise<'OK' | null>;
+    del(key: string): Promise<number>;
+}
+export interface IPresenceLogger {
+    warn: (message: string) => void;
+}
+export interface IRecordPresenceParams {
+    userId: string;
+    service: AbyssService;
+    redis: IPresenceRedis | null;
+    logger: IPresenceLogger;
+    now?: Date;
+}
+export declare const presenceDay: (at: Date) => string;
+export declare const buildPresenceKey: (service: AbyssService, userId: string, at: Date) => string;
+export declare const recordPresence: (params: IRecordPresenceParams) => void;

package/dist/utils/record-presence.utils.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordPresence = exports.buildPresenceKey = exports.presenceDay = void 0;
+const axios_1 = require("axios");
+const __1 = require("..");
+const activity_constants_1 = require("../constants/activity.constants");
+const presenceDay = (at) => at.toISOString().slice(0, 10);
+exports.presenceDay = presenceDay;
+const buildPresenceKey = (service, userId, at) => `activity:presence:${service}:${userId}:${(0, exports.presenceDay)(at)}`;
+exports.buildPresenceKey = buildPresenceKey;
+const errorMessage = (error) => error instanceof Error ? error.message : String(error);
+const isRefusal = (error) => {
+    if (!(0, axios_1.isAxiosError)(error) || !error.response) {
+        return false;
+    }
+    const { status } = error.response;
+    return status >= 400 && status < 500;
+};
+let redisUnavailableWarned = false;
+const warnRedisUnavailableOnce = (logger, reason) => {
+    if (redisUnavailableWarned) {
+        return;
+    }
+    redisUnavailableWarned = true;
+    logger.warn(`Presence heartbeat skipped, Redis unavailable (logged once per process): ${reason}`);
+};
+const sendPresence = async (params) => {
+    const { userId, service, redis, logger } = params;
+    const now = params.now ?? new Date();
+    if (!redis) {
+        warnRedisUnavailableOnce(logger, 'no Redis client');
+        return;
+    }
+    const key = (0, exports.buildPresenceKey)(service, userId, now);
+    let claimed;
+    try {
+        claimed = (await redis.set(key, '1', 'EX', activity_constants_1.PRESENCE_KEY_TTL_SECONDS, 'NX')) === 'OK';
+    }
+    catch (error) {
+        warnRedisUnavailableOnce(logger, errorMessage(error));
+        return;
+    }
+    if (!claimed) {
+        return;
+    }
+    try {
+        await __1.AbyssCore.sdk.activity.admin.recordPresence({ userId, service, at: now.toISOString() });
+    }
+    catch (error) {
+        logger.warn(`Failed to record presence of user ${userId} on ${service}: ${errorMessage(error)}`);
+        if (isRefusal(error)) {
+            return;
+        }
+        try {
+            await redis.del(key);
+        }
+        catch (delError) {
+            logger.warn(`Failed to release presence key ${key}: ${errorMessage(delError)}`);
+        }
+    }
+};
+const recordPresence = (params) => {
+    void sendPresence(params);
+};
+exports.recordPresence = recordPresence;
+//# sourceMappingURL=record-presence.utils.js.map

package/dist/utils/record-presence.utils.js.map

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

package/dist/utils/resolve-user.utils.d.ts

@@ -1,10 +1,18 @@
+import { AbyssService } from '../types/enum/abyss-service.enum';
+import { IPresenceRedis } from './record-presence.utils';
 export interface IResolveUserLogger {
     log: (message: string) => void;
+    warn?: (message: string) => void;
+}
+export interface IResolveUserPresence {
+    service: AbyssService;
+    redis: IPresenceRedis | null;
 }
 export interface IResolveUserParams {
     userId: string;
     UserModel: any;
     logger: IResolveUserLogger;
+    presence: IResolveUserPresence | null;
     transaction?: unknown;
 }
 interface IResolveUserMirror {

package/dist/utils/resolve-user.utils.js

@@ -2,11 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveUserFromAbyssMain = void 0;
 const __1 = require("..");
+const record_presence_utils_1 = require("./record-presence.utils");
 const resolveUserFromAbyssMain = async (params) => {
-    const { userId, UserModel, logger, transaction } = params;
+    const { userId, UserModel, logger, presence, transaction } = params;
     const existingUser = (await UserModel.findByPk(userId, {
         transaction,
     }));
+    if (presence) {
+        (0, record_presence_utils_1.recordPresence)({
+            userId,
+            service: presence.service,
+            redis: presence.redis,
+            logger: {
+                warn: (message) => (logger.warn ? logger.warn(message) : logger.log(message)),
+            },
+        });
+    }
     if (existingUser) {
         return existingUser;
     }

package/dist/utils/resolve-user.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-user.utils.js","sourceRoot":"","sources":["../../src/utils/resolve-user.utils.ts"],"names":[],"mappings":";;;AAAA,0BAA+B;AA+CxB,MAAM,wBAAwB,GAAG,KAAK,EAC3C,MAA0B,EACV,EAAE;IAClB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE1D,MAAM,YAAY,GAAG,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE;QACrD,WAAW;KACZ,CAAC,CAA+B,CAAC;IAMlC,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAqB,CAAC;IAC/B,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,wBAAwB,GAAkB,IAAI,CAAC;IACnD,IAAI,uBAAuB,GAAgB,IAAI,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QACrC,wBAAwB,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC;QAC/E,uBAAuB,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,IAAI,IAAI,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,GAAG,CAAC,wBAAwB,MAAM,qDAAqD,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,YAAY,CAAC;QACpD,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;QACrB,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE;QACpF,WAAW;KACZ,CAAC,CAAmC,CAAC;IAEtC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,qBAAqB,MAAM,cAAc,OAAO,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAa,CAAC;AACvB,CAAC,CAAC;AAzCW,QAAA,wBAAwB,4BAyCnC"}
+{"version":3,"file":"resolve-user.utils.js","sourceRoot":"","sources":["../../src/utils/resolve-user.utils.ts"],"names":[],"mappings":";;;AAAA,0BAA+B;AAE/B,mEAAyE;AA6DlE,MAAM,wBAAwB,GAAG,KAAK,EAC3C,MAA0B,EACV,EAAE;IAClB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAEpE,MAAM,YAAY,GAAG,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE;QACrD,WAAW;KACZ,CAAC,CAA+B,CAAC;IAGlC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAA,sCAAc,EAAC;YACb,MAAM;YACN,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE;gBACN,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;aACtF;SACF,CAAC,CAAC;IACL,CAAC;IAMD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAqB,CAAC;IAC/B,CAAC;IAGD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,wBAAwB,GAAkB,IAAI,CAAC;IACnD,IAAI,uBAAuB,GAAgB,IAAI,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QACrC,wBAAwB,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC;QAC/E,uBAAuB,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,IAAI,IAAI,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,GAAG,CAAC,wBAAwB,MAAM,qDAAqD,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,YAAY,CAAC;QACpD,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;QACrB,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE;QACpF,WAAW;KACZ,CAAC,CAAmC,CAAC;IAEtC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,qBAAqB,MAAM,cAAc,OAAO,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAa,CAAC;AACvB,CAAC,CAAC;AArDW,QAAA,wBAAwB,4BAqDnC"}