@veruna/api-contracts 19.1.0 → 20.1.0

package/build-esm/shared/metadata.schema.js

@@ -1,6 +1,34 @@
 import { z } from 'zod';
+/**
+ * Keys that could be used for prototype pollution attacks.
+ * Any metadata object containing these keys is rejected outright.
+ */
 const FORBIDDEN_KEYS = ['__proto__', 'constructor', 'prototype'];
+/**
+ * Safe key regex: starts with a letter or underscore, then up to 63
+ * alphanumerics / underscores / dashes. Matches wallet module's
+ * original validation; chosen to be portable across JSON databases
+ * and common UI frameworks.
+ */
 const SAFE_KEY_REGEX = /^[a-zA-Z_][a-zA-Z0-9_-]{0,63}$/;
+/**
+ * Builds a Zod schema for free-form JSON metadata with security
+ * protections baked in:
+ *
+ *  - **Prototype pollution guard** — rejects objects that contain
+ *    `__proto__`, `constructor`, or `prototype` at any depth.
+ *  - **Safe key names** — keys must match
+ *    `^[a-zA-Z_][a-zA-Z0-9_-]{0,63}$`.
+ *  - **Typed primitive values** — string / number / boolean / null,
+ *    plus bounded arrays and nested records.
+ *  - **Size / depth / key count limits** — configurable per caller.
+ *
+ * The returned schema is intentionally NOT wrapped in
+ * `.optional()` / `.nullable()` — callers compose those as needed.
+ *
+ * Refinement messages use i18n-style keys (`metadata.tooLarge`,
+ * `metadata.tooDeep`, …) so frontends can localise them.
+ */
 export function createMetadataSchema(options) {
     const maxStringLength = options.maxStringLength ?? 1000;
     const maxArrayLength = options.maxArrayLength ?? 50;
@@ -20,6 +48,9 @@ export function createMetadataSchema(options) {
             return JSON.stringify(obj).length <= options.maxBytes;
         }
         catch {
+            // JSON.stringify throws on BigInt, circular refs, or
+            // similar non-serialisable values. Reject them outright
+            // — metadata must be plain serialisable JSON.
             return false;
         }
     }, { message: 'metadata.tooLarge' })
@@ -33,9 +64,20 @@ export function createMetadataSchema(options) {
         message: 'metadata.tooDeep',
     });
 }
+/**
+ * Type guard: narrows `unknown` to a plain record (non-null object
+ * that is not an array). Used by `hasForbiddenKeys` and `getDepth`
+ * so we can access keys without a type assertion.
+ */
 function isPlainRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+/**
+ * Recursively walks an object / array checking for prototype-pollution
+ * key names. Uses a generous safety rail on recursion depth so it
+ * cannot be abused to blow the call stack even if depth validation
+ * is somehow bypassed.
+ */
 function hasForbiddenKeys(obj, depth = 0) {
     const MAX_RECURSION = 64;
     if (depth > MAX_RECURSION)
@@ -53,6 +95,16 @@ function hasForbiddenKeys(obj, depth = 0) {
     }
     return false;
 }
+/**
+ * Calculates the maximum nesting depth of an object / array graph.
+ * Primitive values (and empty objects / arrays) count as depth 0.
+ *
+ * Uses a generous `MAX_RECURSION` safety rail so a maliciously
+ * crafted deeply-nested payload cannot blow the call stack. Payloads
+ * that exceed the rail bottom out at the rail depth and will
+ * consequently fail the caller's `maxDepth` refinement (which is
+ * always lower than `MAX_RECURSION`), rejecting the input cleanly.
+ */
 function getDepth(obj, currentDepth = 0) {
     const MAX_RECURSION = 64;
     if (currentDepth > MAX_RECURSION) {
@@ -71,6 +123,15 @@ function getDepth(obj, currentDepth = 0) {
         return currentDepth;
     return Math.max(...values.map((value) => getDepth(value, currentDepth + 1)));
 }
+/**
+ * Generic success/failure helper for modules that want a simple
+ * "validate this unknown blob" entrypoint. Handles `null` /
+ * `undefined` as "no metadata" (valid with `data: null`) so callers
+ * don't need to special-case empty input.
+ *
+ * Returns the parsed record on success so callers know they can
+ * persist it verbatim.
+ */
 export function validateMetadataWith(schema, metadata) {
     if (metadata === undefined || metadata === null) {
         return { valid: true, data: null };

package/build-esm/shared/metadata.schema.js.map

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

package/build-esm/shared/pagination.schema.js

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Pagination query params schema
+ * Error messages: PaginationQuery.{field}.{rule}
+ */
 export const PaginationQuerySchema = z.object({
     page: z.coerce
         .number()
@@ -12,6 +16,9 @@ export const PaginationQuerySchema = z.object({
         .max(100, { message: 'PaginationQuery.limit.max' })
         .default(10),
 });
+/**
+ * Pagination metadata schema
+ */
 export const PaginationMetaSchema = z.object({
     page: z.number().int().positive(),
     limit: z.number().int().positive(),
@@ -20,6 +27,9 @@ export const PaginationMetaSchema = z.object({
     hasNext: z.boolean(),
     hasPrev: z.boolean(),
 });
+/**
+ * Paginated response schema
+ */
 export const createPaginatedResponseSchema = (itemSchema) => z.object({
     data: z.array(itemSchema),
     meta: PaginationMetaSchema,

package/build-esm/shared/pagination.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.schema.js","sourceRoot":"","sources":["../../shared/pagination.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM;SACX,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;SAChD,QAAQ,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;SACrD,OAAO,CAAC,CAAC,CAAC;IACb,KAAK,EAAE,CAAC,CAAC,MAAM;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SACjD,QAAQ,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;SAClD,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAsB,UAAa,EAAE,EAAE,CAClF,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACzB,IAAI,EAAE,oBAAoB;CAC3B,CAAC,CAAC"}
+{"version":3,"file":"pagination.schema.js","sourceRoot":"","sources":["../../shared/pagination.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM;SACX,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;SAChD,QAAQ,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;SACrD,OAAO,CAAC,CAAC,CAAC;IACb,KAAK,EAAE,CAAC,CAAC,MAAM;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SACjD,QAAQ,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;SAClD,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAsB,UAAa,EAAE,EAAE,CAClF,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACzB,IAAI,EAAE,oBAAoB;CAC3B,CAAC,CAAC"}

package/build-esm/shared/profile-anchor.enum.js

@@ -1,3 +1,4 @@
+/** Deep-link anchors inside a profile tab (…#<anchor>). */
 export var ProfileAnchor;
 (function (ProfileAnchor) {
     ProfileAnchor["EMAIL"] = "email";

package/build-esm/shared/profile-anchor.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile-anchor.enum.js","sourceRoot":"","sources":["../../shared/profile-anchor.enum.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,gCAAe,CAAA;IACf,gDAA+B,CAAA;IAC/B,sCAAqB,CAAA;AACzB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB"}
+{"version":3,"file":"profile-anchor.enum.js","sourceRoot":"","sources":["../../shared/profile-anchor.enum.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,gCAAe,CAAA;IACf,gDAA+B,CAAA;IAC/B,sCAAqB,CAAA;AACzB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB"}

package/build-esm/shared/profile-tab.enum.js

@@ -1,3 +1,4 @@
+/** Tabs on the frontend profile page (/profile/my?tab=<tab>). */
 export var ProfileTab;
 (function (ProfileTab) {
     ProfileTab["PROFILE"] = "profile";

package/build-esm/shared/profile-tab.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile-tab.enum.js","sourceRoot":"","sources":["../../shared/profile-tab.enum.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,UAUX;AAVD,WAAY,UAAU;IAClB,iCAAmB,CAAA;IACnB,2CAA6B,CAAA;IAC7B,mCAAqB,CAAA;IACrB,6CAA+B,CAAA;IAC/B,2CAA6B,CAAA;IAC7B,2CAA6B,CAAA;IAC7B,6BAAe,CAAA;IACf,iCAAmB,CAAA;IACnB,uCAAyB,CAAA;AAC7B,CAAC,EAVW,UAAU,KAAV,UAAU,QAUrB"}
+{"version":3,"file":"profile-tab.enum.js","sourceRoot":"","sources":["../../shared/profile-tab.enum.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAN,IAAY,UAUX;AAVD,WAAY,UAAU;IAClB,iCAAmB,CAAA;IACnB,2CAA6B,CAAA;IAC7B,mCAAqB,CAAA;IACrB,6CAA+B,CAAA;IAC/B,2CAA6B,CAAA;IAC7B,2CAA6B,CAAA;IAC7B,6BAAe,CAAA;IACf,iCAAmB,CAAA;IACnB,uCAAyB,CAAA;AAC7B,CAAC,EAVW,UAAU,KAAV,UAAU,QAUrB"}

package/build-esm/shared/regex.js

@@ -1,14 +1,30 @@
+/**
+ * Common regex patterns for validation
+ */
+// RFC 5322 email regex (simplified)
 export const EMAIL_REGEX = /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
+// UUID v4 regex
 export const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+// ISO 8601 datetime regex
 export const DATETIME_REGEX = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
+// 32-byte random token encoded as hex string (64 chars)
 export const EMAIL_VERIFICATION_TOKEN_REGEX = /^[A-Fa-f0-9]{64}$/;
 export const PASSWORD_RESET_TOKEN_REGEX = /^[A-Fa-f0-9]{64}$/;
 export const ATR_TOKEN_REGEX = /^(?:[A-Fa-f0-9]{64}|[A-Za-z0-9_-]{16,64}\.[A-Za-z0-9_-]{16,128})$/;
+// HMAC-SHA256 в base64url — ровно 43 символа без выравнивающих '='.
 export const UNSUBSCRIBE_TOKEN_REGEX = /^[A-Za-z0-9_-]{43}$/;
+// Slug/alias regex (lowercase letters, numbers, hyphens)
 export const SLUG_REGEX = /^[a-z0-9-]+$/;
+// Hex color regex: #RRGGBB
 export const HEX_COLOR_REGEX = /^#[0-9A-Fa-f]{6}$/;
+// BigInt string regex (non-negative integer as string)
 export const BIGINT_STRING_REGEX = /^\d+$/;
+// Positive (non-zero) BigInt string regex: rejects `0`, rejects leading
+// zeros, and caps at 19 digits (fits safely within i64 / PostgreSQL bigint).
+// Use this for amounts and counters that must always be > 0 when serialized
+// over the wire as a JSON string.
 export const POSITIVE_BIGINT_STRING_REGEX = /^[1-9][0-9]{0,18}$/;
+// OAuth state parameter: base64url-safe characters only
 export const OAUTH_STATE_REGEX = /^[A-Za-z0-9_-]+$/;
 export const OAUTH_STATE_MAX_LENGTH = 128;
 //# sourceMappingURL=regex.js.map

package/build-esm/shared/regex.js.map

@@ -1 +1 @@
-{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../shared/regex.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,WAAW,GACpB,uIAAuI,CAAC;AAG5I,MAAM,CAAC,MAAM,UAAU,GAAG,wEAAwE,CAAC;AAGnG,MAAM,CAAC,MAAM,cAAc,GAAG,oDAAoD,CAAC;AAGnF,MAAM,CAAC,MAAM,8BAA8B,GAAG,mBAAmB,CAAC;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAC9D,MAAM,CAAC,MAAM,eAAe,GACxB,mEAAmE,CAAC;AAExE,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAG7D,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAGzC,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAGnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAM3C,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAGjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../shared/regex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GACpB,uIAAuI,CAAC;AAE5I,gBAAgB;AAChB,MAAM,CAAC,MAAM,UAAU,GAAG,wEAAwE,CAAC;AAEnG,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,oDAAoD,CAAC;AAEnF,wDAAwD;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,mBAAmB,CAAC;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAC9D,MAAM,CAAC,MAAM,eAAe,GACxB,mEAAmE,CAAC;AACxE,oEAAoE;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D,yDAAyD;AACzD,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAEzC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,kCAAkC;AAClC,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEjE,wDAAwD;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}

package/build-esm/shared/tariffs-anchor.enum.js

@@ -1,5 +1,7 @@
+/** Deep-link anchors on the tariffs page (/tariffs#<anchor>). */
 export var TariffsAnchor;
 (function (TariffsAnchor) {
+    /** Open the one-time packages view instead of the default subscriptions view. */
     TariffsAnchor["PACKAGES"] = "packages";
 })(TariffsAnchor || (TariffsAnchor = {}));
 //# sourceMappingURL=tariffs-anchor.enum.js.map

package/build-esm/shared/tariffs-anchor.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"tariffs-anchor.enum.js","sourceRoot":"","sources":["../../shared/tariffs-anchor.enum.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IAErB,sCAAqB,CAAA;AACzB,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}
+{"version":3,"file":"tariffs-anchor.enum.js","sourceRoot":"","sources":["../../shared/tariffs-anchor.enum.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACrB,iFAAiF;IACjF,sCAAqB,CAAA;AACzB,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}

package/build-esm/utils/path-builder.js

@@ -1,3 +1,9 @@
+/**
+ * Build URL path with parameters
+ * @example
+ * buildPath('/users/:id', { id: '123' }) // '/users/123'
+ * buildPath('/users/:id/posts/:postId', { id: '1', postId: '2' }) // '/users/1/posts/2'
+ */
 export function buildPath(pattern, params) {
     if (!params) {
         return pattern;
@@ -8,6 +14,11 @@ export function buildPath(pattern, params) {
     }
     return path;
 }
+/**
+ * Build URL with query parameters
+ * @example
+ * buildUrl('/users', { page: 1, limit: 10 }) // '/users?page=1&limit=10'
+ */
 export function buildUrl(path, queryParams) {
     if (!queryParams || Object.keys(queryParams).length === 0) {
         return path;
@@ -18,6 +29,12 @@ export function buildUrl(path, queryParams) {
         .join('&');
     return query ? `${path}?${query}` : path;
 }
+/**
+ * Build full URL with path params and query params
+ * @example
+ * buildFullUrl('/users/:id', { id: '123' }, { include: 'posts' })
+ * // '/users/123?include=posts'
+ */
 export function buildFullUrl(pattern, pathParams, queryParams) {
     const path = buildPath(pattern, pathParams);
     return buildUrl(path, queryParams);

package/build-esm/utils/path-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-builder.js","sourceRoot":"","sources":["../../utils/path-builder.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,MAAwC;IAExC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,GAAG,OAAO,CAAC;IAEnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAOD,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,WAAmE;IAEnE,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SACtC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;SAC7D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;SACxF,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAQD,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,UAA4C,EAC5C,WAAmE;IAEnE,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"path-builder.js","sourceRoot":"","sources":["../../utils/path-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,MAAwC;IAExC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,GAAG,OAAO,CAAC;IAEnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,WAAmE;IAEnE,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SACtC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;SAC7D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;SACxF,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,UAA4C,EAC5C,WAAmE;IAEnE,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACrC,CAAC"}

package/build-esm/v1/admin-file/commands/admin-file-delete-by-key.command.js

@@ -3,8 +3,10 @@ import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
 export var AdminFileDeleteByKeyCommand;
 (function (AdminFileDeleteByKeyCommand) {
+    // Request/Response
     AdminFileDeleteByKeyCommand.Request = AdminFileByKeyQuerySchema;
     AdminFileDeleteByKeyCommand.Response = AdminFileDeleteByKeyResponseSchema;
+    // URL/Method
     AdminFileDeleteByKeyCommand.URL = REST_API.V1.ADMIN_FILE.ADMIN.DELETE_BY_KEY;
     AdminFileDeleteByKeyCommand.METHOD = HttpMethod.DELETE;
 })(AdminFileDeleteByKeyCommand || (AdminFileDeleteByKeyCommand = {}));

package/build-esm/v1/admin-file/commands/admin-file-delete-by-key.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-delete-by-key.command.js","sourceRoot":"","sources":["../../../../v1/admin-file/commands/admin-file-delete-by-key.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,2BAA2B,CAY3C;AAZD,WAAiB,2BAA2B;IAE3B,mCAAO,GAAG,yBAAyB,CAAC;IACpC,oCAAQ,GAAG,kCAAkC,CAAC;IAG9C,+BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC;IACjD,kCAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAK5C,CAAC,EAZgB,2BAA2B,KAA3B,2BAA2B,QAY3C"}
+{"version":3,"file":"admin-file-delete-by-key.command.js","sourceRoot":"","sources":["../../../../v1/admin-file/commands/admin-file-delete-by-key.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,2BAA2B,CAY3C;AAZD,WAAiB,2BAA2B;IACxC,mBAAmB;IACN,mCAAO,GAAG,yBAAyB,CAAC;IACpC,oCAAQ,GAAG,kCAAkC,CAAC;IAE3D,aAAa;IACA,+BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC;IACjD,kCAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAK5C,CAAC,EAZgB,2BAA2B,KAA3B,2BAA2B,QAY3C"}

package/build-esm/v1/admin-file/commands/admin-file-upload.command.js

@@ -3,8 +3,10 @@ import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
 export var AdminFileUploadCommand;
 (function (AdminFileUploadCommand) {
+    // Request/Response
     AdminFileUploadCommand.Request = AdminFileUploadQuerySchema;
     AdminFileUploadCommand.Response = AdminFileUploadResponseSchema;
+    // URL/Method
     AdminFileUploadCommand.URL = REST_API.V1.ADMIN_FILE.ADMIN.UPLOAD;
     AdminFileUploadCommand.METHOD = HttpMethod.PUT;
 })(AdminFileUploadCommand || (AdminFileUploadCommand = {}));

package/build-esm/v1/admin-file/commands/admin-file-upload.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-upload.command.js","sourceRoot":"","sources":["../../../../v1/admin-file/commands/admin-file-upload.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,sBAAsB,CAYtC;AAZD,WAAiB,sBAAsB;IAEtB,8BAAO,GAAG,0BAA0B,CAAC;IACrC,+BAAQ,GAAG,6BAA6B,CAAC;IAGzC,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1C,6BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAKzC,CAAC,EAZgB,sBAAsB,KAAtB,sBAAsB,QAYtC"}
+{"version":3,"file":"admin-file-upload.command.js","sourceRoot":"","sources":["../../../../v1/admin-file/commands/admin-file-upload.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,sBAAsB,CAYtC;AAZD,WAAiB,sBAAsB;IACnC,mBAAmB;IACN,8BAAO,GAAG,0BAA0B,CAAC;IACrC,+BAAQ,GAAG,6BAA6B,CAAC;IAEtD,aAAa;IACA,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1C,6BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAKzC,CAAC,EAZgB,sBAAsB,KAAtB,sBAAsB,QAYtC"}

package/build-esm/v1/admin-file/queries/admin-file-get-by-key.query.js

@@ -3,8 +3,10 @@ import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
 export var AdminFileGetByKeyQuery;
 (function (AdminFileGetByKeyQuery) {
+    // Request/Response
     AdminFileGetByKeyQuery.Request = AdminFileByKeyQuerySchema;
     AdminFileGetByKeyQuery.Response = AdminFileItemResponseSchema;
+    // URL/Method
     AdminFileGetByKeyQuery.URL = REST_API.V1.ADMIN_FILE.ADMIN.GET_BY_KEY;
     AdminFileGetByKeyQuery.METHOD = HttpMethod.GET;
 })(AdminFileGetByKeyQuery || (AdminFileGetByKeyQuery = {}));

package/build-esm/v1/admin-file/queries/admin-file-get-by-key.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-get-by-key.query.js","sourceRoot":"","sources":["../../../../v1/admin-file/queries/admin-file-get-by-key.query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,sBAAsB,CAYtC;AAZD,WAAiB,sBAAsB;IAEtB,8BAAO,GAAG,yBAAyB,CAAC;IACpC,+BAAQ,GAAG,2BAA2B,CAAC;IAGvC,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;IAC9C,6BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAKzC,CAAC,EAZgB,sBAAsB,KAAtB,sBAAsB,QAYtC"}
+{"version":3,"file":"admin-file-get-by-key.query.js","sourceRoot":"","sources":["../../../../v1/admin-file/queries/admin-file-get-by-key.query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,sBAAsB,CAYtC;AAZD,WAAiB,sBAAsB;IACnC,mBAAmB;IACN,8BAAO,GAAG,yBAAyB,CAAC;IACpC,+BAAQ,GAAG,2BAA2B,CAAC;IAEpD,aAAa;IACA,0BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;IAC9C,6BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAKzC,CAAC,EAZgB,sBAAsB,KAAtB,sBAAsB,QAYtC"}

package/build-esm/v1/admin-file/queries/admin-file-list.query.js

@@ -3,8 +3,10 @@ import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
 export var AdminFileListQuery;
 (function (AdminFileListQuery) {
+    // Request/Response
     AdminFileListQuery.Request = AdminFileListQuerySchema;
     AdminFileListQuery.Response = AdminFileListResponseSchema;
+    // URL/Method
     AdminFileListQuery.URL = REST_API.V1.ADMIN_FILE.ADMIN.LIST;
     AdminFileListQuery.METHOD = HttpMethod.GET;
 })(AdminFileListQuery || (AdminFileListQuery = {}));

package/build-esm/v1/admin-file/queries/admin-file-list.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-list.query.js","sourceRoot":"","sources":["../../../../v1/admin-file/queries/admin-file-list.query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,kBAAkB,CAYlC;AAZD,WAAiB,kBAAkB;IAElB,0BAAO,GAAG,wBAAwB,CAAC;IACnC,2BAAQ,GAAG,2BAA2B,CAAC;IAGvC,sBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAKzC,CAAC,EAZgB,kBAAkB,KAAlB,kBAAkB,QAYlC"}
+{"version":3,"file":"admin-file-list.query.js","sourceRoot":"","sources":["../../../../v1/admin-file/queries/admin-file-list.query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,kBAAkB,CAYlC;AAZD,WAAiB,kBAAkB;IAC/B,mBAAmB;IACN,0BAAO,GAAG,wBAAwB,CAAC;IACnC,2BAAQ,GAAG,2BAA2B,CAAC;IAEpD,aAAa;IACA,sBAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;IACxC,yBAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAKzC,CAAC,EAZgB,kBAAkB,KAAlB,kBAAkB,QAYlC"}

package/build-esm/v1/admin-file/schemas/admin-file-by-key-request.schema.js

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Admin file by-key query parameters schema
+ * Error messages: AdminFileByKeyQuery.{field}.{rule}
+ */
 export const AdminFileByKeyQuerySchema = z.object({
     key: z
         .string({ error: 'AdminFileByKeyQuery.key.required' })

package/build-esm/v1/admin-file/schemas/admin-file-by-key-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-by-key-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-by-key-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,EAAE,CAAC;SACD,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;SACrD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1D,CAAC,CAAC"}
+{"version":3,"file":"admin-file-by-key-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-by-key-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,EAAE,CAAC;SACD,MAAM,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;SACrD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1D,CAAC,CAAC"}

package/build-esm/v1/admin-file/schemas/admin-file-delete-by-key-response.schema.js

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+/**
+ * Admin file delete response schema
+ */
 export const AdminFileDeleteByKeyResponseSchema = z.object({
     success: z.boolean(),
     key: z.string(),

package/build-esm/v1/admin-file/schemas/admin-file-delete-by-key-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-delete-by-key-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-delete-by-key-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"admin-file-delete-by-key-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-delete-by-key-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC"}

package/build-esm/v1/admin-file/schemas/admin-file-folder-response.schema.js

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+/**
+ * Admin folder item schema
+ */
 export const AdminFileFolderResponseSchema = z.object({
     prefix: z.string(),
 });

package/build-esm/v1/admin-file/schemas/admin-file-folder-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-folder-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-folder-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}
+{"version":3,"file":"admin-file-folder-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-folder-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}

package/build-esm/v1/admin-file/schemas/admin-file-image-format.enum.js

@@ -1,3 +1,8 @@
+/**
+ * Output image format an admin can pick when uploading an image. Defaults
+ * to WEBP (the historical behaviour) — the other values let the admin keep
+ * PNG/JPEG instead of forcing every image to WebP.
+ */
 export var AdminFileImageFormat;
 (function (AdminFileImageFormat) {
     AdminFileImageFormat["WEBP"] = "webp";

package/build-esm/v1/admin-file/schemas/admin-file-image-format.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-image-format.enum.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-image-format.enum.ts"],"names":[],"mappings":"AAKA,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC5B,qCAAa,CAAA;IACb,mCAAW,CAAA;IACX,qCAAa,CAAA;IACb,mCAAW,CAAA;AACf,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B"}
+{"version":3,"file":"admin-file-image-format.enum.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-image-format.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC5B,qCAAa,CAAA;IACb,mCAAW,CAAA;IACX,qCAAa,CAAA;IACb,mCAAW,CAAA;AACf,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B"}

package/build-esm/v1/admin-file/schemas/admin-file-item-response.schema.js

@@ -1,5 +1,8 @@
 import { z } from 'zod';
 import { AdminFileType } from './admin-file-type.enum';
+/**
+ * Admin file item schema
+ */
 export const AdminFileItemResponseSchema = z.object({
     key: z.string(),
     cdnUrl: z.string().url(),

package/build-esm/v1/admin-file/schemas/admin-file-item-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-item-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-item-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAKvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"admin-file-item-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-item-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;CAC9B,CAAC,CAAC"}

package/build-esm/v1/admin-file/schemas/admin-file-list-request.schema.js

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { AdminFileType } from './admin-file-type.enum';
+/**
+ * Admin file list query parameters schema
+ * Error messages: AdminFileListQuery.{field}.{rule}
+ */
 export const AdminFileListQuerySchema = z.object({
     prefix: z.string().optional(),
     query: z.string().optional(),

package/build-esm/v1/admin-file/schemas/admin-file-list-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-list-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-list-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAMvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM;SACV,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACpD,QAAQ,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACzD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;SACrD,OAAO,CAAC,EAAE,CAAC;CACnB,CAAC,CAAC"}
+{"version":3,"file":"admin-file-list-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-list-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM;SACV,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACpD,QAAQ,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACzD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;SACrD,OAAO,CAAC,EAAE,CAAC;CACnB,CAAC,CAAC"}

package/build-esm/v1/admin-file/schemas/admin-file-list-response.schema.js

@@ -1,6 +1,9 @@
 import { z } from 'zod';
 import { AdminFileItemResponseSchema } from './admin-file-item-response.schema';
 import { AdminFileFolderResponseSchema } from './admin-file-folder-response.schema';
+/**
+ * Admin file list response schema
+ */
 export const AdminFileListResponseSchema = z.object({
     files: z.array(AdminFileItemResponseSchema),
     folders: z.array(AdminFileFolderResponseSchema),

package/build-esm/v1/admin-file/schemas/admin-file-list-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-list-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-list-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAKpF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}
+{"version":3,"file":"admin-file-list-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-list-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}

package/build-esm/v1/admin-file/schemas/admin-file-type.enum.js

@@ -1,3 +1,6 @@
+/**
+ * Admin File type
+ */
 export var AdminFileType;
 (function (AdminFileType) {
     AdminFileType["IMAGE"] = "IMAGE";

package/build-esm/v1/admin-file/schemas/admin-file-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-type.enum.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-type.enum.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,gCAAe,CAAA;IACf,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,4BAAW,CAAA;AACf,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}
+{"version":3,"file":"admin-file-type.enum.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-type.enum.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,gCAAe,CAAA;IACf,4BAAW,CAAA;IACX,4BAAW,CAAA;IACX,4BAAW,CAAA;AACf,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}

package/build-esm/v1/admin-file/schemas/admin-file-upload-request.schema.js

@@ -1,9 +1,15 @@
 import { z } from 'zod';
 import { AdminFileImageFormat } from './admin-file-image-format.enum';
+/**
+ * Admin file upload query parameters schema
+ * Error messages: AdminFileUploadQuery.{field}.{rule}
+ */
 export const AdminFileUploadQuerySchema = z.object({
     key: z
         .string({ error: 'AdminFileUploadQuery.key.required' })
         .min(1, { error: 'AdminFileUploadQuery.key.min' }),
+    // Output format for image uploads. Omitted → WEBP (historical default).
+    // Ignored for non-image uploads (SVG/docs are stored as-is).
     format: z
         .enum(AdminFileImageFormat, { error: 'AdminFileUploadQuery.format.invalid' })
         .default(AdminFileImageFormat.WEBP),

package/build-esm/v1/admin-file/schemas/admin-file-upload-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-upload-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-upload-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAMtE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,GAAG,EAAE,CAAC;SACD,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;IAGtD,MAAM,EAAE,CAAC;SACJ,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SAC5E,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC;CAC1C,CAAC,CAAC"}
+{"version":3,"file":"admin-file-upload-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-upload-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,GAAG,EAAE,CAAC;SACD,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACtD,wEAAwE;IACxE,6DAA6D;IAC7D,MAAM,EAAE,CAAC;SACJ,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SAC5E,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC;CAC1C,CAAC,CAAC"}

package/build-esm/v1/admin-file/schemas/admin-file-upload-response.schema.js

@@ -1,5 +1,8 @@
 import { z } from 'zod';
 import { AdminFileType } from './admin-file-type.enum';
+/**
+ * Admin file upload response schema
+ */
 export const AdminFileUploadResponseSchema = z.object({
     key: z.string(),
     cdnUrl: z.string().url(),

package/build-esm/v1/admin-file/schemas/admin-file-upload-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file-upload-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-upload-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAKvD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"admin-file-upload-response.schema.js","sourceRoot":"","sources":["../../../../v1/admin-file/schemas/admin-file-upload-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;CAC9B,CAAC,CAAC"}

package/build-esm/v1/admin-lockouts/schemas/clear-login-code-request.schema.js

@@ -1,4 +1,12 @@
 import { z } from 'zod';
+/**
+ * Снятие локаута входа по коду.
+ *
+ * Локаут ключуется по EMAIL, а не по userId (кто угодно десятью неверными
+ * кодами закрывает владельцу вход на сутки), поэтому email передаётся явно,
+ * а не берётся из userId в пути. userId в пути — для единообразия дерева и
+ * аудита, кого разблокировали.
+ */
 export const ClearLoginCodeRequestSchema = z.object({
     email: z
         .string({ error: 'ClearLoginCodeRequest.email.required' })

package/build-esm/v1/admin-lockouts/schemas/clear-login-code-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"clear-login-code-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-lockouts/schemas/clear-login-code-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,KAAK,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CACjE,CAAC,CAAC"}
+{"version":3,"file":"clear-login-code-request.schema.js","sourceRoot":"","sources":["../../../../v1/admin-lockouts/schemas/clear-login-code-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,KAAK,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CACjE,CAAC,CAAC"}

package/build-esm/v1/admin-lockouts/schemas/lockout-item.schema.js

@@ -1,16 +1,30 @@
 import { z } from 'zod';
 import { LockoutKind } from './lockout-kind.enum';
+/**
+ * Одна активная блокировка на экране пользователя.
+ *
+ * Строится сервером из состояния разных модулей и подаётся плоско, чтобы
+ * админка не собирала картину сама. `clearable` говорит, есть ли под эту
+ * блокировку ручка снятия; `autoClearsAt` — когда она отпустит сама (null,
+ * если не отпускает никогда).
+ */
 export const LockoutItemSchema = z.object({
     kind: z.nativeEnum(LockoutKind),
+    /** Человекочитаемое пояснение: что именно закрыто и почему. */
     detail: z.string(),
+    /** Есть ли под эту блокировку ручка снятия в этом же контроллере. */
     clearable: z.boolean(),
+    /** Когда снимется сама, ISO-8601; null — не снимается автоматически. */
     autoClearsAt: z.string().datetime({ offset: true }).nullable(),
 });
+/** Ответ экрана «блокировки пользователя»: плоский список активных. */
 export const UserLockoutsResponseSchema = z.object({
     userId: z.string(),
     lockouts: z.array(LockoutItemSchema),
 });
+/** Результат любой ручки снятия: сняли ли что-то и короткий человекочитаемый итог. */
 export const LockoutClearResponseSchema = z.object({
+    /** true — блокировка была активна и снята; false — снимать было нечего. */
     cleared: z.boolean(),
     detail: z.string(),
 });

package/build-esm/v1/admin-lockouts/schemas/lockout-item.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"lockout-item.schema.js","sourceRoot":"","sources":["../../../../v1/admin-lockouts/schemas/lockout-item.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAUlD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC;IAE/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAElB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IAEtB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjE,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CACvC,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAE/C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}
+{"version":3,"file":"lockout-item.schema.js","sourceRoot":"","sources":["../../../../v1/admin-lockouts/schemas/lockout-item.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,qEAAqE;IACrE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,wEAAwE;IACxE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjE,CAAC,CAAC;AAIH,uEAAuE;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CACvC,CAAC,CAAC;AAIH,sFAAsF;AACtF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,2EAA2E;IAC3E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}

package/build-esm/v1/admin-lockouts/schemas/lockout-kind.enum.js

@@ -1,9 +1,22 @@
+/**
+ * Виды блокировок и лимитов, показываемые на экране пользователя в админке.
+ *
+ * Это НЕ полный каталог из 42 механизмов — только те, что человек ощущает
+ * как «меня заблокировали» и по которым саппорт получает обращение. Тихие
+ * лимиты (частотные капы писем, TTL-локи) сюда не выносятся: они снимаются
+ * сами за минуты и обращения не порождают.
+ */
 export var LockoutKind;
 (function (LockoutKind) {
+    /** Аккаунт забанен администратором. */
     LockoutKind["ACCOUNT_BANNED"] = "ACCOUNT_BANNED";
+    /** Аккаунт удалён (deleted_at выставлен). */
     LockoutKind["ACCOUNT_DELETED"] = "ACCOUNT_DELETED";
+    /** Слишком много неверных кодов входа — приём кода закрыт на сутки. */
     LockoutKind["LOGIN_CODE_LOCKOUT"] = "LOGIN_CODE_LOCKOUT";
+    /** Профиль завис в ручной проверке — стартовый грант и бонусы удержаны. */
     LockoutKind["PENDING_REVIEW"] = "PENDING_REVIEW";
+    /** Анонимная сессия помечена как фрод — гранты не капают. */
     LockoutKind["UNREG_FRAUD"] = "UNREG_FRAUD";
 })(LockoutKind || (LockoutKind = {}));
 //# sourceMappingURL=lockout-kind.enum.js.map