@veruna/api-contracts 20.0.0 → 20.1.0

package/build/v1/unregistered-users/admin/schemas/admin-unreg-sort.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Sort fields for the admin unregistered-users search.
+ * `CREATED_AT` — session creation; `LAST_ACCESS_AT` — last activity.
+ */
 export declare enum AdminUnregSortField {
     CREATED_AT = "CREATED_AT",
     LAST_ACCESS_AT = "LAST_ACCESS_AT"

package/build/v1/unregistered-users/admin/schemas/admin-unreg-sort.enum.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminUnregSortField = void 0;
+/**
+ * Sort fields for the admin unregistered-users search.
+ * `CREATED_AT` — session creation; `LAST_ACCESS_AT` — last activity.
+ */
 var AdminUnregSortField;
 (function (AdminUnregSortField) {
     AdminUnregSortField["CREATED_AT"] = "CREATED_AT";

package/build/v1/unregistered-users/admin/schemas/admin-unreg-sort.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-unreg-sort.enum.js","sourceRoot":"","sources":["../../../../../v1/unregistered-users/admin/schemas/admin-unreg-sort.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,gDAAyB,CAAA;IACzB,wDAAiC,CAAA;AACrC,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B"}
+{"version":3,"file":"admin-unreg-sort.enum.js","sourceRoot":"","sources":["../../../../../v1/unregistered-users/admin/schemas/admin-unreg-sort.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,gDAAyB,CAAA;IACzB,wDAAiC,CAAA;AACrC,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B"}

package/build/v1/unregistered-users/admin/schemas/unreg-status-action.enum.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Admin status transition on an unregistered session.
+ * MARK_FRAUD — flag ACTIVE/PAUSED/LOGIN_LINK → FRAUD; PAUSE — ACTIVE → PAUSED;
+ * RESUME — PAUSED → ACTIVE; UNMARK_FRAUD — FRAUD → the pre-fraud shape
+ * (LOGIN_LINK when the session carries a login link, ACTIVE otherwise).
+ * Migrated sessions reject all four.
+ */
 export declare enum UnregStatusAction {
     MARK_FRAUD = "MARK_FRAUD",
     PAUSE = "PAUSE",

package/build/v1/unregistered-users/admin/schemas/unreg-status-action.enum.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnregStatusAction = void 0;
+/**
+ * Admin status transition on an unregistered session.
+ * MARK_FRAUD — flag ACTIVE/PAUSED/LOGIN_LINK → FRAUD; PAUSE — ACTIVE → PAUSED;
+ * RESUME — PAUSED → ACTIVE; UNMARK_FRAUD — FRAUD → the pre-fraud shape
+ * (LOGIN_LINK when the session carries a login link, ACTIVE otherwise).
+ * Migrated sessions reject all four.
+ */
 var UnregStatusAction;
 (function (UnregStatusAction) {
     UnregStatusAction["MARK_FRAUD"] = "MARK_FRAUD";

package/build/v1/unregistered-users/admin/schemas/unreg-status-action.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"unreg-status-action.enum.js","sourceRoot":"","sources":["../../../../../v1/unregistered-users/admin/schemas/unreg-status-action.enum.ts"],"names":[],"mappings":";;;AAOA,IAAY,iBAKX;AALD,WAAY,iBAAiB;IACzB,8CAAyB,CAAA;IACzB,oCAAe,CAAA;IACf,sCAAiB,CAAA;IACjB,kDAA6B,CAAA;AACjC,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}
+{"version":3,"file":"unreg-status-action.enum.js","sourceRoot":"","sources":["../../../../../v1/unregistered-users/admin/schemas/unreg-status-action.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,iBAKX;AALD,WAAY,iBAAiB;IACzB,8CAAyB,CAAA;IACzB,oCAAe,CAAA;IACf,sCAAiB,CAAA;IACjB,kDAA6B,CAAA;AACjC,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B"}

package/build/v1/unregistered-users/schemas/authenticate-request.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Authenticate Unregistered User Request Schema
+ * Error messages: AuthenticateUnregUserRequest.{field}.{rule}
+ */
 export declare const AuthenticateUnregUserRequestSchema: z.ZodObject<{
     token: z.ZodOptional<z.ZodString>;
     utm: z.ZodOptional<z.ZodObject<{

package/build/v1/unregistered-users/schemas/authenticate-request.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthenticateUnregUserRequestSchema = void 0;
 const zod_1 = require("zod");
 const utm_schema_1 = require("../../utm/schemas/utm.schema");
+/**
+ * Authenticate Unregistered User Request Schema
+ * Error messages: AuthenticateUnregUserRequest.{field}.{rule}
+ */
 exports.AuthenticateUnregUserRequestSchema = zod_1.z.object({
     token: zod_1.z.string({ error: 'AuthenticateUnregUserRequest.token.invalid' }).optional(),
     utm: utm_schema_1.UtmSchema.optional(),

package/build/v1/unregistered-users/schemas/authenticate-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate-request.schema.js","sourceRoot":"","sources":["../../../../v1/unregistered-users/schemas/authenticate-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAyD;AAM5C,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnF,GAAG,EAAE,sBAAS,CAAC,QAAQ,EAAE;CAC1B,CAAC,CAAC"}
+{"version":3,"file":"authenticate-request.schema.js","sourceRoot":"","sources":["../../../../v1/unregistered-users/schemas/authenticate-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAyD;AAEzD;;;GAGG;AACU,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnF,GAAG,EAAE,sBAAS,CAAC,QAAQ,EAAE;CAC1B,CAAC,CAAC"}

package/build/v1/unregistered-users/schemas/authenticate-response.schema.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { UnregUserStatus } from './unreg-user-status.enum';
+/**
+ * Authenticate Unregistered User Response Schema.
+ *
+ * The legacy `requests` / `nextResetAt` fields were removed when unreg
+ * billing migrated from a request-counter quota to a wallet-based
+ * UNREG_WELCOME balance. The frontend reads remaining funds from the
+ * standard billing-balance endpoint instead.
+ */
 export declare const AuthenticateUnregUserResponseSchema: z.ZodObject<{
     token: z.ZodString;
     status: z.ZodEnum<typeof UnregUserStatus>;

package/build/v1/unregistered-users/schemas/authenticate-response.schema.js

@@ -3,6 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthenticateUnregUserResponseSchema = void 0;
 const zod_1 = require("zod");
 const unreg_user_status_enum_1 = require("./unreg-user-status.enum");
+/**
+ * Authenticate Unregistered User Response Schema.
+ *
+ * The legacy `requests` / `nextResetAt` fields were removed when unreg
+ * billing migrated from a request-counter quota to a wallet-based
+ * UNREG_WELCOME balance. The frontend reads remaining funds from the
+ * standard billing-balance endpoint instead.
+ */
 exports.AuthenticateUnregUserResponseSchema = zod_1.z.object({
     token: zod_1.z.string(),
     status: zod_1.z.enum(unreg_user_status_enum_1.UnregUserStatus),

package/build/v1/unregistered-users/schemas/authenticate-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"authenticate-response.schema.js","sourceRoot":"","sources":["../../../../v1/unregistered-users/schemas/authenticate-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAA2D;AAU9C,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,CAAC;CAClC,CAAC,CAAC"}
+{"version":3,"file":"authenticate-response.schema.js","sourceRoot":"","sources":["../../../../v1/unregistered-users/schemas/authenticate-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAA2D;AAE3D;;;;;;;GAOG;AACU,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,CAAC;CAClC,CAAC,CAAC"}

package/build/v1/unregistered-users/schemas/unreg-user-status.enum.d.ts

@@ -1,7 +1,19 @@
+/**
+ * Unregistered User Status
+ */
 export declare enum UnregUserStatus {
     ACTIVE = "ACTIVE",
     FRAUD = "FRAUD",
     MIGRATED = "MIGRATED",
+    /** Dormant > antifraud.unreg.pauseAfterDays: freed from active-counters, chats purged. */
     PAUSED = "PAUSED",
+    /**
+     * Linked (not migrated) to a registered account on login — every sign-in
+     * (email, login-code, VK/Yandex/Telegram) links the carried unreg token's
+     * session to the account for audit/antifraud lineage. Nothing is
+     * transferred (wallet/chats/files stay on the unreg session). Terminal,
+     * like MIGRATED: token gates reject it and it is excluded from live-unreg
+     * counting.
+     */
     LOGIN_LINK = "LOGIN_LINK"
 }

package/build/v1/unregistered-users/schemas/unreg-user-status.enum.js

@@ -1,12 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnregUserStatus = void 0;
+/**
+ * Unregistered User Status
+ */
 var UnregUserStatus;
 (function (UnregUserStatus) {
     UnregUserStatus["ACTIVE"] = "ACTIVE";
     UnregUserStatus["FRAUD"] = "FRAUD";
     UnregUserStatus["MIGRATED"] = "MIGRATED";
+    /** Dormant > antifraud.unreg.pauseAfterDays: freed from active-counters, chats purged. */
     UnregUserStatus["PAUSED"] = "PAUSED";
+    /**
+     * Linked (not migrated) to a registered account on login — every sign-in
+     * (email, login-code, VK/Yandex/Telegram) links the carried unreg token's
+     * session to the account for audit/antifraud lineage. Nothing is
+     * transferred (wallet/chats/files stay on the unreg session). Terminal,
+     * like MIGRATED: token gates reject it and it is excluded from live-unreg
+     * counting.
+     */
     UnregUserStatus["LOGIN_LINK"] = "LOGIN_LINK";
 })(UnregUserStatus || (exports.UnregUserStatus = UnregUserStatus = {}));
 //# sourceMappingURL=unreg-user-status.enum.js.map

package/build/v1/unregistered-users/schemas/unreg-user-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"unreg-user-status.enum.js","sourceRoot":"","sources":["../../../../v1/unregistered-users/schemas/unreg-user-status.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,eAeX;AAfD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,wCAAqB,CAAA;IAErB,oCAAiB,CAAA;IASjB,4CAAyB,CAAA;AAC3B,CAAC,EAfW,eAAe,+BAAf,eAAe,QAe1B"}
+{"version":3,"file":"unreg-user-status.enum.js","sourceRoot":"","sources":["../../../../v1/unregistered-users/schemas/unreg-user-status.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,eAeX;AAfD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,wCAAqB,CAAA;IACrB,0FAA0F;IAC1F,oCAAiB,CAAA;IACjB;;;;;;;OAOG;IACH,4CAAyB,CAAA;AAC3B,CAAC,EAfW,eAAe,+BAAf,eAAe,QAe1B"}

package/build/v1/users/admin/commands/admin-delete-user.command.d.ts

@@ -2,6 +2,12 @@ import { z } from 'zod';
 import { HttpMethod } from '../../../../shared/http-method.enum';
 export declare namespace AdminDeleteUserCommand {
     const Request: z.ZodObject<{}, z.core.$strip>;
+    /**
+     * UUID of the user that was just soft-deleted. Mirrors the
+     * `:userId` from the URL — exposed in the body so admin
+     * tooling can pipe the response straight to follow-up calls
+     * without reparsing the URL.
+     */
     const Response: z.ZodObject<{
         uuid: z.ZodString;
     }, z.core.$strip>;

package/build/v1/users/admin/commands/admin-delete-user.command.js

@@ -8,6 +8,12 @@ const http_method_enum_1 = require("../../../../shared/http-method.enum");
 var AdminDeleteUserCommand;
 (function (AdminDeleteUserCommand) {
     AdminDeleteUserCommand.Request = zod_1.z.object({});
+    /**
+     * UUID of the user that was just soft-deleted. Mirrors the
+     * `:userId` from the URL — exposed in the body so admin
+     * tooling can pipe the response straight to follow-up calls
+     * without reparsing the URL.
+     */
     AdminDeleteUserCommand.Response = zod_1.z.object({
         uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
     });

package/build/v1/users/admin/commands/admin-delete-user.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-delete-user.command.js","sourceRoot":"","sources":["../../../../../v1/users/admin/commands/admin-delete-user.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oDAAsD;AACtD,mDAAgD;AAChD,0EAAiE;AAEjE,IAAiB,sBAAsB,CAetC;AAfD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAOvB,+BAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;KACrC,CAAC,CAAC;IACU,0BAAG,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE,6BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAG5C,CAAC,EAfgB,sBAAsB,sCAAtB,sBAAsB,QAetC"}
+{"version":3,"file":"admin-delete-user.command.js","sourceRoot":"","sources":["../../../../../v1/users/admin/commands/admin-delete-user.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oDAAsD;AACtD,mDAAgD;AAChD,0EAAiE;AAEjE,IAAiB,sBAAsB,CAetC;AAfD,WAAiB,sBAAsB;IACtB,8BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpC;;;;;OAKG;IACU,+BAAQ,GAAG,OAAC,CAAC,MAAM,CAAC;QAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;KACrC,CAAC,CAAC;IACU,0BAAG,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE,6BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAG5C,CAAC,EAfgB,sBAAsB,sCAAtB,sBAAsB,QAetC"}

package/build/v1/users/admin/schemas/admin-update-user.schema.d.ts

@@ -1,6 +1,13 @@
 import { z } from 'zod';
 import { UserStatus } from '../../schemas/user-status.enum';
 import { UserRole } from '../../../auth/schemas/user-role.enum';
+/**
+ * PATCH /v1/admin/users/:userId — partial update body. Empty body is
+ * rejected at the service layer.
+ *
+ * Note: status DELETED is NOT allowed via PATCH — use DELETE
+ * /:userId. Admin only flips the lifecycle between ACTIVE / BANNED.
+ */
 export declare const AdminUpdateUserRequestSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodEnum<typeof UserRole>>;

package/build/v1/users/admin/schemas/admin-update-user.schema.js

@@ -5,6 +5,13 @@ const zod_1 = require("zod");
 const user_status_enum_1 = require("../../schemas/user-status.enum");
 const user_role_enum_1 = require("../../../auth/schemas/user-role.enum");
 const admin_user_details_schema_1 = require("./admin-user-details.schema");
+/**
+ * PATCH /v1/admin/users/:userId — partial update body. Empty body is
+ * rejected at the service layer.
+ *
+ * Note: status DELETED is NOT allowed via PATCH — use DELETE
+ * /:userId. Admin only flips the lifecycle between ACTIVE / BANNED.
+ */
 exports.AdminUpdateUserRequestSchema = zod_1.z.object({
     name: zod_1.z
         .string({ error: 'AdminUpdateUserRequest.name.invalid' })

package/build/v1/users/admin/schemas/admin-update-user.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-update-user.schema.js","sourceRoot":"","sources":["../../../../../v1/users/admin/schemas/admin-update-user.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAA4D;AAC5D,yEAAgE;AAChE,2EAAkE;AASrD,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,6BAAU,CAAC,MAAM,EAAE,6BAAU,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC,CAAC;AAGU,QAAA,6BAA6B,GAAG,+CAAmB,CAAC"}
+{"version":3,"file":"admin-update-user.schema.js","sourceRoot":"","sources":["../../../../../v1/users/admin/schemas/admin-update-user.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAA4D;AAC5D,yEAAgE;AAChE,2EAAkE;AAElE;;;;;;GAMG;AACU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,6BAAU,CAAC,MAAM,EAAE,6BAAU,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC,CAAC;AAGU,QAAA,6BAA6B,GAAG,+CAAmB,CAAC"}

package/build/v1/users/admin/schemas/admin-user-details.schema.d.ts

@@ -3,6 +3,12 @@ import { EmailProfileStatus } from '../../schemas/email-profile-status.enum';
 import { AuthProfileStatus } from '../../schemas/auth-profile-status.enum';
 import { UserRole } from '../../../auth/schemas/user-role.enum';
 import { TelegramDeliveryStatus } from '../../../notifications/schemas/telegram-delivery-status.enum';
+/**
+ * Admin variant of `TelegramProfileResponseSchema`. The user-facing
+ * schema exposes `photoUrl` for chat avatars; the admin view drops
+ * that and instead surfaces operational fields (languageCode,
+ * deliveryStatus) needed to debug TG bot delivery issues.
+ */
 export declare const AdminTelegramProfileSchema: z.ZodObject<{
     telegramId: z.ZodString;
     username: z.ZodNullable<z.ZodString>;
@@ -13,6 +19,11 @@ export declare const AdminTelegramProfileSchema: z.ZodObject<{
     deliveryStatus: z.ZodEnum<typeof TelegramDeliveryStatus>;
 }, z.core.$strip>;
 export type AdminTelegramProfile = z.infer<typeof AdminTelegramProfileSchema>;
+/**
+ * VK / Yandex have no admin-specific projection — the user-facing
+ * schemas already cover everything an admin needs. Re-exported under
+ * `Admin*` aliases so the admin contract stays self-documenting.
+ */
 export declare const AdminVkProfileSchema: z.ZodObject<{
     vkId: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
@@ -50,6 +61,10 @@ export declare const AdminYandexProfileSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.core.$strip>;
 export type AdminYandexProfile = z.infer<typeof AdminYandexProfileSchema>;
+/**
+ * Email profile data for admin view (active row only — full history
+ * lives in `AdminProfilesHistorySchema`).
+ */
 export declare const AdminEmailInfoSchema: z.ZodObject<{
     email: z.ZodString;
     status: z.ZodEnum<typeof EmailProfileStatus>;
@@ -104,6 +119,11 @@ export declare const AdminProfilesSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AdminProfiles = z.infer<typeof AdminProfilesSchema>;
+/**
+ * Audit-trail rows surfaced on the admin user-card. Each social-link
+ * type carries the same lifecycle envelope (uuid + status + deletedAt
+ * + createdAt) wrapping the profile snapshot at link-time.
+ */
 export declare const AdminTelegramProfileHistoryItemSchema: z.ZodObject<{
     uuid: z.ZodString;
     status: z.ZodEnum<typeof AuthProfileStatus>;
@@ -169,6 +189,11 @@ export declare const AdminYandexProfileHistoryItemSchema: z.ZodObject<{
     deletedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type AdminYandexProfileHistoryItem = z.infer<typeof AdminYandexProfileHistoryItemSchema>;
+/**
+ * Email history row = the active-row fields + lifecycle envelope.
+ * Built off the `AdminEmailInfoSchema` so the wire-DTO never drifts
+ * from the headline projection.
+ */
 export declare const AdminEmailHistoryItemSchema: z.ZodObject<{
     email: z.ZodString;
     status: z.ZodEnum<typeof EmailProfileStatus>;
@@ -253,6 +278,13 @@ export declare const AdminProfilesHistorySchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AdminProfilesHistory = z.infer<typeof AdminProfilesHistorySchema>;
+/**
+ * Core user fields for admin views. Builds on the public
+ * `UserResponseSchema` and adds the admin-only fields. `email` is
+ * dropped here — it lives separately in the `AdminEmailInfoSchema`
+ * block to surface verifiedAt/hasPassword alongside it. `role` is
+ * narrowed to the `UserRole` enum.
+ */
 export declare const AdminUserCoreSchema: z.ZodObject<{
     status: z.ZodEnum<typeof import("../..").UserStatus>;
     uuid: z.ZodString;
@@ -264,6 +296,12 @@ export declare const AdminUserCoreSchema: z.ZodObject<{
     deletedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type AdminUserCore = z.infer<typeof AdminUserCoreSchema>;
+/**
+ * Single round-trip user-card payload. Wallet balance, sessions and
+ * chat counts are NOT part of this response — the admin frontend
+ * pulls them via dedicated endpoints (`/wallet/balance`, `/sessions`)
+ * so the user-card snapshot stays bounded to the user domain.
+ */
 export declare const AdminUserDetailsResponseSchema: z.ZodObject<{
     user: z.ZodObject<{
         status: z.ZodEnum<typeof import("../..").UserStatus>;

package/build/v1/users/admin/schemas/admin-user-details.schema.js

@@ -11,14 +11,29 @@ const telegram_profile_response_schema_1 = require("../../../telegram-profile/sc
 const vk_profile_response_schema_1 = require("../../../vk-profile/schemas/vk-profile-response.schema");
 const yandex_profile_response_schema_1 = require("../../../yandex-profile/schemas/yandex-profile-response.schema");
 const telegram_delivery_status_enum_1 = require("../../../notifications/schemas/telegram-delivery-status.enum");
+/**
+ * Admin variant of `TelegramProfileResponseSchema`. The user-facing
+ * schema exposes `photoUrl` for chat avatars; the admin view drops
+ * that and instead surfaces operational fields (languageCode,
+ * deliveryStatus) needed to debug TG bot delivery issues.
+ */
 exports.AdminTelegramProfileSchema = telegram_profile_response_schema_1.TelegramProfileResponseSchema.omit({
     photoUrl: true,
 }).extend({
     languageCode: zod_1.z.string().nullable(),
     deliveryStatus: zod_1.z.enum(telegram_delivery_status_enum_1.TelegramDeliveryStatus),
 });
+/**
+ * VK / Yandex have no admin-specific projection — the user-facing
+ * schemas already cover everything an admin needs. Re-exported under
+ * `Admin*` aliases so the admin contract stays self-documenting.
+ */
 exports.AdminVkProfileSchema = vk_profile_response_schema_1.VkProfileResponseSchema;
 exports.AdminYandexProfileSchema = yandex_profile_response_schema_1.YandexProfileResponseSchema;
+/**
+ * Email profile data for admin view (active row only — full history
+ * lives in `AdminProfilesHistorySchema`).
+ */
 exports.AdminEmailInfoSchema = zod_1.z.object({
     email: zod_1.z.string(),
     status: zod_1.z.enum(email_profile_status_enum_1.EmailProfileStatus),
@@ -30,6 +45,11 @@ exports.AdminProfilesSchema = zod_1.z.object({
     vk: exports.AdminVkProfileSchema.nullable(),
     yandex: exports.AdminYandexProfileSchema.nullable(),
 });
+/**
+ * Audit-trail rows surfaced on the admin user-card. Each social-link
+ * type carries the same lifecycle envelope (uuid + status + deletedAt
+ * + createdAt) wrapping the profile snapshot at link-time.
+ */
 exports.AdminTelegramProfileHistoryItemSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
     status: zod_1.z.enum(auth_profile_status_enum_1.AuthProfileStatus),
@@ -51,6 +71,11 @@ exports.AdminYandexProfileHistoryItemSchema = zod_1.z.object({
     createdAt: zod_1.z.string().regex(regex_1.DATETIME_REGEX),
     deletedAt: zod_1.z.string().regex(regex_1.DATETIME_REGEX).nullable(),
 });
+/**
+ * Email history row = the active-row fields + lifecycle envelope.
+ * Built off the `AdminEmailInfoSchema` so the wire-DTO never drifts
+ * from the headline projection.
+ */
 exports.AdminEmailHistoryItemSchema = exports.AdminEmailInfoSchema.extend({
     uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
     createdAt: zod_1.z.string().regex(regex_1.DATETIME_REGEX),
@@ -62,12 +87,25 @@ exports.AdminProfilesHistorySchema = zod_1.z.object({
     vk: zod_1.z.array(exports.AdminVkProfileHistoryItemSchema),
     yandex: zod_1.z.array(exports.AdminYandexProfileHistoryItemSchema),
 });
+/**
+ * Core user fields for admin views. Builds on the public
+ * `UserResponseSchema` and adds the admin-only fields. `email` is
+ * dropped here — it lives separately in the `AdminEmailInfoSchema`
+ * block to surface verifiedAt/hasPassword alongside it. `role` is
+ * narrowed to the `UserRole` enum.
+ */
 exports.AdminUserCoreSchema = user_response_schema_1.UserResponseSchema.omit({ email: true }).extend({
     role: zod_1.z.enum(user_role_enum_1.UserRole),
     registrationIp: zod_1.z.string().nullable(),
     updatedAt: zod_1.z.string().regex(regex_1.DATETIME_REGEX),
     deletedAt: zod_1.z.string().regex(regex_1.DATETIME_REGEX).nullable(),
 });
+/**
+ * Single round-trip user-card payload. Wallet balance, sessions and
+ * chat counts are NOT part of this response — the admin frontend
+ * pulls them via dedicated endpoints (`/wallet/balance`, `/sessions`)
+ * so the user-card snapshot stays bounded to the user domain.
+ */
 exports.AdminUserDetailsResponseSchema = zod_1.z.object({
     user: exports.AdminUserCoreSchema,
     email: exports.AdminEmailInfoSchema.nullable(),

package/build/v1/users/admin/schemas/admin-user-details.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-user-details.schema.js","sourceRoot":"","sources":["../../../../../v1/users/admin/schemas/admin-user-details.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oDAAsE;AACtE,6EAAwE;AACxE,uFAA6E;AAC7E,qFAA2E;AAC3E,yEAAgE;AAChE,yHAAmH;AACnH,uGAAiG;AACjG,mHAA6G;AAC7G,gHAAsG;AAQzF,QAAA,0BAA0B,GAAG,gEAA6B,CAAC,IAAI,CAAC;IACzE,QAAQ,EAAE,IAAI;CACjB,CAAC,CAAC,MAAM,CAAC;IACN,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,cAAc,EAAE,OAAC,CAAC,IAAI,CAAC,sDAAsB,CAAC;CACjD,CAAC,CAAC;AAQU,QAAA,oBAAoB,GAAG,oDAAuB,CAAC;AAG/C,QAAA,wBAAwB,GAAG,4DAA2B,CAAC;AAOvD,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,8CAAkB,CAAC;IAClC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC,QAAQ,EAAE;IACvD,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE;CAC3B,CAAC,CAAC;AAGU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,kCAA0B,CAAC,QAAQ,EAAE;IAC/C,EAAE,EAAE,4BAAoB,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,gCAAwB,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAQU,QAAA,qCAAqC,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,4CAAiB,CAAC;IACjC,OAAO,EAAE,kCAA0B;IACnC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAKU,QAAA,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,4CAAiB,CAAC;IACjC,OAAO,EAAE,4BAAoB;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAGU,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,4CAAiB,CAAC;IACjC,OAAO,EAAE,gCAAwB;IACjC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAUU,QAAA,2BAA2B,GAAG,4BAAoB,CAAC,MAAM,CAAC;IACnE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAGU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,mCAA2B,CAAC;IAC3C,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,6CAAqC,CAAC;IACxD,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,uCAA+B,CAAC;IAC5C,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,2CAAmC,CAAC;CACvD,CAAC,CAAC;AAUU,QAAA,mBAAmB,GAAG,yCAAkB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC/E,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC;IACtB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AASU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,2BAAmB;IACzB,KAAK,EAAE,4BAAoB,CAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,2BAAmB;IAC7B,OAAO,EAAE,kCAA0B;CACtC,CAAC,CAAC"}
+{"version":3,"file":"admin-user-details.schema.js","sourceRoot":"","sources":["../../../../../v1/users/admin/schemas/admin-user-details.schema.ts"],"names":[],"mappings":"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"}

package/build/v1/users/admin/schemas/admin-user-list.schema.d.ts

@@ -2,6 +2,12 @@ import { z } from 'zod';
 import { UserStatus } from '../../schemas/user-status.enum';
 import { UserRole } from '../../../auth/schemas/user-role.enum';
 import { AdminUserSortField, AdminUserSortOrder } from './admin-user-sort.enum';
+/**
+ * Single row in the admin users list. Builds on the public
+ * `UserResponseSchema` and adds admin-only columns: registrationIp,
+ * social-link presence flags and aggregate balance. The `role`
+ * field is narrowed from `z.string()` to the `UserRole` enum.
+ */
 export declare const AdminUserListItemSchema: z.ZodObject<{
     uuid: z.ZodString;
     email: z.ZodNullable<z.ZodString>;

package/build/v1/users/admin/schemas/admin-user-list.schema.js

@@ -7,12 +7,19 @@ const user_response_schema_1 = require("../../schemas/user-response.schema");
 const user_status_enum_1 = require("../../schemas/user-status.enum");
 const user_role_enum_1 = require("../../../auth/schemas/user-role.enum");
 const admin_user_sort_enum_1 = require("./admin-user-sort.enum");
+/**
+ * Single row in the admin users list. Builds on the public
+ * `UserResponseSchema` and adds admin-only columns: registrationIp,
+ * social-link presence flags and aggregate balance. The `role`
+ * field is narrowed from `z.string()` to the `UserRole` enum.
+ */
 exports.AdminUserListItemSchema = user_response_schema_1.UserResponseSchema.extend({
     role: zod_1.z.enum(user_role_enum_1.UserRole),
     registrationIp: zod_1.z.string().nullable(),
     hasTelegram: zod_1.z.boolean(),
     hasVk: zod_1.z.boolean(),
     hasYandex: zod_1.z.boolean(),
+    /** Сумма available по всем ACTIVE балансам, в kopeks. */
     balanceAvailable: shared_1.BigIntStringSchema,
 });
 const SortFieldSchema = zod_1.z.enum(admin_user_sort_enum_1.AdminUserSortField).default(admin_user_sort_enum_1.AdminUserSortField.CREATED_AT);

package/build/v1/users/admin/schemas/admin-user-list.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-user-list.schema.js","sourceRoot":"","sources":["../../../../../v1/users/admin/schemas/admin-user-list.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"admin-user-list.schema.js","sourceRoot":"","sources":["../../../../../v1/users/admin/schemas/admin-user-list.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+CAAwD;AACxD,6EAAwE;AACxE,qEAA4D;AAC5D,yEAAgE;AAChE,iEAAgF;AAEhF;;;;;GAKG;AACU,QAAA,uBAAuB,GAAG,yCAAkB,CAAC,MAAM,CAAC;IAC7D,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC;IACtB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE;IACxB,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE;IAClB,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE;IACtB,yDAAyD;IACzD,gBAAgB,EAAE,2BAAkB;CACvC,CAAC,CAAC;AAGH,MAAM,eAAe,GAAG,OAAC,CAAC,IAAI,CAAC,yCAAkB,CAAC,CAAC,OAAO,CAAC,yCAAkB,CAAC,UAAU,CAAC,CAAC;AAC1F,MAAM,eAAe,GAAG,OAAC,CAAC,IAAI,CAAC,yCAAkB,CAAC,CAAC,OAAO,CAAC,yCAAkB,CAAC,IAAI,CAAC,CAAC;AAEvE,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,CAAC,EAAE,OAAC;SACC,MAAM,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;SACpD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;SACpD,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,CAAC,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC1C,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,OAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAClE,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;SAChE,QAAQ,EAAE;IACf,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,eAAe;IAC1B,IAAI,EAAE,OAAC,CAAC,MAAM;SACT,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SACtD,QAAQ,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SAC3D,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,OAAC,CAAC,MAAM;SACV,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACvD,QAAQ,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC5D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,OAAO,CAAC,EAAE,CAAC;CACnB,CAAC,CAAC;AAGU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,+BAAuB,CAAC;IACvC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/build/v1/users/admin/users-admin.errors.d.ts

@@ -1,5 +1,11 @@
 import { ErrorMetadata } from '../../../shared';
+/**
+ * Errors specific to admin-side user management. Generic user errors
+ * (USER_NOT_FOUND, EMAIL_ALREADY_EXISTS, etc.) reuse the existing
+ * `UserErrorCode` from the user contracts root.
+ */
 export declare enum UsersAdminErrorCode {
+    /** Admin tried to ban / change role of their own account. */
     CANNOT_MODIFY_SELF = "CANNOT_MODIFY_SELF"
 }
 export declare const USERS_ADMIN_ERRORS: Record<UsersAdminErrorCode, ErrorMetadata>;

package/build/v1/users/admin/users-admin.errors.js

@@ -1,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.USERS_ADMIN_ERRORS = exports.UsersAdminErrorCode = void 0;
+/**
+ * Errors specific to admin-side user management. Generic user errors
+ * (USER_NOT_FOUND, EMAIL_ALREADY_EXISTS, etc.) reuse the existing
+ * `UserErrorCode` from the user contracts root.
+ */
 var UsersAdminErrorCode;
 (function (UsersAdminErrorCode) {
+    /** Admin tried to ban / change role of their own account. */
     UsersAdminErrorCode["CANNOT_MODIFY_SELF"] = "CANNOT_MODIFY_SELF";
 })(UsersAdminErrorCode || (exports.UsersAdminErrorCode = UsersAdminErrorCode = {}));
 exports.USERS_ADMIN_ERRORS = {

package/build/v1/users/admin/users-admin.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"users-admin.errors.js","sourceRoot":"","sources":["../../../../v1/users/admin/users-admin.errors.ts"],"names":[],"mappings":";;;AAOA,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAE3B,gEAAyC,CAAA;AAC7C,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAEY,QAAA,kBAAkB,GAA+C;IAC1E,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,EAAE;QACtC,IAAI,EAAE,mBAAmB,CAAC,kBAAkB;QAC5C,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"users-admin.errors.js","sourceRoot":"","sources":["../../../../v1/users/admin/users-admin.errors.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,6DAA6D;IAC7D,gEAAyC,CAAA;AAC7C,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAEY,QAAA,kBAAkB,GAA+C;IAC1E,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,EAAE;QACtC,IAAI,EAAE,mBAAmB,CAAC,kBAAkB;QAC5C,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}

package/build/v1/users/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./users.errors"), exports);
 __exportStar(require("./commands"), exports);
 __exportStar(require("./queries"), exports);
 __exportStar(require("./admin"), exports);
+// Re-export from centralized locations
 var controllers_1 = require("../../controllers");
 Object.defineProperty(exports, "USERS_CONTROLLER", { enumerable: true, get: function () { return controllers_1.USERS_CONTROLLER; } });
 var routes_1 = require("../../routes");

package/build/v1/users/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/users/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AAExB,iDAAqD;AAA5C,+GAAA,gBAAgB,OAAA;AACzB,uCAA4C;AAAnC,sGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/users/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,uCAAuC;AACvC,iDAAqD;AAA5C,+GAAA,gBAAgB,OAAA;AACzB,uCAA4C;AAAnC,sGAAA,YAAY,OAAA"}

package/build/v1/users/queries/get-verification-status.query.d.ts

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * The unified verification/activation status surface — the single endpoint
+ * the frontend reads to render "what is available, what is blocked, why and
+ * what to do next". Replaces the activation fields formerly duplicated on
+ * setup-status.
+ */
 export declare namespace UserGetVerificationStatusQuery {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{

package/build/v1/users/queries/get-verification-status.query.js

@@ -5,6 +5,12 @@ const zod_1 = require("zod");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const account_verification_status_response_schema_1 = require("../schemas/account-verification-status-response.schema");
+/**
+ * The unified verification/activation status surface — the single endpoint
+ * the frontend reads to render "what is available, what is blocked, why and
+ * what to do next". Replaces the activation fields formerly duplicated on
+ * setup-status.
+ */
 var UserGetVerificationStatusQuery;
 (function (UserGetVerificationStatusQuery) {
     UserGetVerificationStatusQuery.Request = zod_1.z.object({});

package/build/v1/users/queries/get-verification-status.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-verification-status.query.js","sourceRoot":"","sources":["../../../../v1/users/queries/get-verification-status.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,gDAA6C;AAC7C,uEAA8D;AAC9D,wHAAiH;AAQjH,IAAiB,8BAA8B,CAO9C;AAPD,WAAiB,8BAA8B;IAC9B,sCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,uCAAQ,GAAG,qFAAuC,CAAC;IACnD,kCAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACnD,qCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,8BAA8B,8CAA9B,8BAA8B,QAO9C"}
+{"version":3,"file":"get-verification-status.query.js","sourceRoot":"","sources":["../../../../v1/users/queries/get-verification-status.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,gDAA6C;AAC7C,uEAA8D;AAC9D,wHAAiH;AAEjH;;;;;GAKG;AACH,IAAiB,8BAA8B,CAO9C;AAPD,WAAiB,8BAA8B;IAC9B,sCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,uCAAQ,GAAG,qFAAuC,CAAC;IACnD,kCAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACnD,qCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,8BAA8B,8CAA9B,8BAA8B,QAO9C"}

package/build/v1/users/schemas/account-verification-status-response.schema.d.ts

@@ -4,6 +4,11 @@ import { TrustStatusReason } from '../../antifraud/enums/trust-status-reason.enu
 import { TrustDisplayStatus } from '../../antifraud/enums/trust-display-status.enum';
 import { UserVerifiedSource } from './user-verified-source.enum';
 import { ActivationBlockedReason, ActivationEmailAction, BonusLockedReason, EmailChangeReason, RestrictedNextStep } from './verification-status.enums';
+/**
+ * The unified verification/activation status: what is available, what is
+ * blocked, why, and the next action per path. All activation paths report
+ * `available=false` once the account is verified.
+ */
 export declare const AccountVerificationStatusResponseSchema: z.ZodObject<{
     isVerified: z.ZodBoolean;
     activatedAt: z.ZodNullable<z.ZodString>;