@authhero/adapter-interfaces 3.4.1 → 3.5.0

package/dist/types/adapters/UserActivity.d.ts

@@ -0,0 +1,9 @@
+import { UserActivity, UserActivityUpdate } from "../types/UserActivity";
+export interface UserActivityAdapter {
+    get(tenantId: string, userId: string): Promise<UserActivity | null>;
+    /**
+     * Insert or merge-update the activity row for a user. Only the provided
+     * fields are written; previously-stored fields are preserved.
+     */
+    upsert(tenantId: string, userId: string, activity: UserActivityUpdate): Promise<void>;
+}

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

@@ -32,6 +32,7 @@ import { FormsAdapter } from "./Forms";
 import { ResourceServersAdapter } from "./ResourceServers";
 import { RolePermissionsAdapter } from "./RolePermissions";
 import { GrantsAdapter } from "./Grants";
+import { UserActivityAdapter } from "./UserActivity";
 import { UserPermissionsAdapter } from "./UserPermissions";
 import { RolesAdapter } from "./Roles";
 import { UserRolesAdapter } from "./UserRoles";
@@ -114,6 +115,14 @@ export interface DataAdapters {
      * `/api/v2/client-grants`, which is `clientGrants` above).
      */
     grants?: GrantsAdapter;
+    /**
+     * Optional write-often per-user activity counters (last_login, last_ip,
+     * login_count, …) split out of the `users` row (issue #1003). When set, the
+     * login flow double-writes these alongside the legacy `users` columns during
+     * the expand/contract migration. When undefined, only the legacy columns are
+     * written.
+     */
+    userActivity?: UserActivityAdapter;
     userPermissions: UserPermissionsAdapter;
     roles: RolesAdapter;
     sessions: SessionsAdapter;
@@ -238,4 +247,5 @@ export * from "./TenantSettings";
 export * from "./Tenants";
 export * from "./Themes";
 export * from "./Grants";
+export * from "./UserActivity";
 export * from "./Users";

package/dist/types/types/UserActivity.d.ts

@@ -0,0 +1,17 @@
+import { z } from "@hono/zod-openapi";
+/**
+ * Write-often per-user counters split out of the `users` row (issue #1003) so
+ * the profile row isn't rewritten on every login / failed password attempt.
+ * 1:1 with a user, keyed by `(tenant_id, user_id)`.
+ */
+export declare const userActivitySchema: z.ZodObject<{
+    user_id: z.ZodString;
+    last_login: z.ZodOptional<z.ZodString>;
+    last_ip: z.ZodOptional<z.ZodString>;
+    login_count: z.ZodDefault<z.ZodNumber>;
+    failed_logins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    last_password_reset: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UserActivity = z.infer<typeof userActivitySchema>;
+/** Partial payload for an upsert — only the provided fields are written. */
+export type UserActivityUpdate = Partial<Omit<UserActivity, "user_id">>;

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

@@ -41,6 +41,7 @@ export * from "./SmsProvider";
 export * from "./ResourceServer";
 export * from "./RolePermission";
 export * from "./Grant";
+export * from "./UserActivity";
 export * from "./UserPermission";
 export * from "./UserRole";
 export * from "./Role";

package/package.json

@@ -11,7 +11,7 @@
     "type": "git",
     "url": "https://github.com/markusahlstrand/authhero"
   },
-  "version": "3.4.1",
+  "version": "3.5.0",
   "files": [
     "dist"
   ],