@veruna/api-contracts 19.1.0 → 20.1.0

package/build/v1/avatar/schemas/avatar-release-by-uuid-request.schema.js

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AvatarReleaseByUuidRequestSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
+/**
+ * S2S request: release exactly one avatar by uuid. Used as a compensating
+ * action by the api service after a local DB failure that followed a
+ * successful attach — release the just-attached uuid only, never blindly
+ * the current avatar of the owner (which may be a concurrent successful
+ * attach by another request).
+ */
 exports.AvatarReleaseByUuidRequestSchema = zod_1.z.object({
     uuid: zod_1.z
         .string({ error: 'AvatarReleaseByUuidRequest.uuid.required' })

package/build/v1/avatar/schemas/avatar-release-by-uuid-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-release-by-uuid-request.schema.js","sourceRoot":"","sources":["../../../../v1/avatar/schemas/avatar-release-by-uuid-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAShC,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;SAC7D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;IAC9E,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;SACpE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;CACxF,CAAC,CAAC"}
+{"version":3,"file":"avatar-release-by-uuid-request.schema.js","sourceRoot":"","sources":["../../../../v1/avatar/schemas/avatar-release-by-uuid-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAE7C;;;;;;GAMG;AACU,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;SAC7D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;IAC9E,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;SACpE,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;CACxF,CAAC,CAAC"}

package/build/v1/avatar/schemas/avatar-release-request.schema.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { AvatarOwnerType } from '../avatar-owner-type.enum';
+/**
+ * S2S request: release the avatar attached to a domain entity. Used on entity
+ * deletion or when the user explicitly resets their avatar.
+ *
+ * `ownerUserId` is required for defense-in-depth: even if the S2S key leaks,
+ * an attacker would need both the assistant's id AND its owner's userId to
+ * release the avatar.
+ */
 export declare const AvatarReleaseRequestSchema: z.ZodObject<{
     ownerUserId: z.ZodString;
     ownerType: z.ZodEnum<typeof AvatarOwnerType>;

package/build/v1/avatar/schemas/avatar-release-request.schema.js

@@ -4,6 +4,14 @@ exports.AvatarReleaseRequestSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const avatar_owner_type_enum_1 = require("../avatar-owner-type.enum");
+/**
+ * S2S request: release the avatar attached to a domain entity. Used on entity
+ * deletion or when the user explicitly resets their avatar.
+ *
+ * `ownerUserId` is required for defense-in-depth: even if the S2S key leaks,
+ * an attacker would need both the assistant's id AND its owner's userId to
+ * release the avatar.
+ */
 exports.AvatarReleaseRequestSchema = zod_1.z.object({
     ownerUserId: zod_1.z
         .string({ error: 'AvatarReleaseRequest.ownerUserId.required' })

package/build/v1/avatar/schemas/avatar-release-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-release-request.schema.js","sourceRoot":"","sources":["../../../../v1/avatar/schemas/avatar-release-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,sEAA4D;AAU/C,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IAC/E,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,EAAE;QAC/B,KAAK,EAAE,wCAAwC;KAClD,CAAC;IACF,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;CAC9E,CAAC,CAAC"}
+{"version":3,"file":"avatar-release-request.schema.js","sourceRoot":"","sources":["../../../../v1/avatar/schemas/avatar-release-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,sEAA4D;AAE5D;;;;;;;GAOG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IAC/E,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,EAAE;QAC/B,KAAK,EAAE,wCAAwC;KAClD,CAAC;IACF,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;CAC9E,CAAC,CAAC"}

package/build/v1/avatar/schemas/avatar-upload-query.schema.d.ts

@@ -1,5 +1,10 @@
 import { z } from 'zod';
 import { AvatarOwnerType } from '../avatar-owner-type.enum';
+/**
+ * Avatar upload accepts the owner type as a query parameter so the multipart
+ * body can stay reserved for the file part. Server uses this to pick the
+ * validation limits and the storage key prefix.
+ */
 export declare const AvatarUploadQuerySchema: z.ZodObject<{
     ownerType: z.ZodEnum<typeof AvatarOwnerType>;
 }, z.core.$strip>;

package/build/v1/avatar/schemas/avatar-upload-query.schema.js

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AvatarUploadQuerySchema = void 0;
 const zod_1 = require("zod");
 const avatar_owner_type_enum_1 = require("../avatar-owner-type.enum");
+/**
+ * Avatar upload accepts the owner type as a query parameter so the multipart
+ * body can stay reserved for the file part. Server uses this to pick the
+ * validation limits and the storage key prefix.
+ */
 exports.AvatarUploadQuerySchema = zod_1.z.object({
     ownerType: zod_1.z.enum(avatar_owner_type_enum_1.AvatarOwnerType, {
         error: 'AvatarUploadQuery.ownerType.invalid',

package/build/v1/avatar/schemas/avatar-upload-query.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"avatar-upload-query.schema.js","sourceRoot":"","sources":["../../../../v1/avatar/schemas/avatar-upload-query.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sEAA4D;AAO/C,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,EAAE;QAC/B,KAAK,EAAE,qCAAqC;KAC/C,CAAC;CACL,CAAC,CAAC"}
+{"version":3,"file":"avatar-upload-query.schema.js","sourceRoot":"","sources":["../../../../v1/avatar/schemas/avatar-upload-query.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sEAA4D;AAE5D;;;;GAIG;AACU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAe,EAAE;QAC/B,KAAK,EAAE,qCAAqC;KAC/C,CAAC;CACL,CAAC,CAAC"}

package/build/v1/billing/billing.errors.d.ts

@@ -5,7 +5,19 @@ export declare enum BillingErrorCode {
     MARKUP_TIER_RANGE_OVERLAPS = "MARKUP_TIER_RANGE_OVERLAPS",
     NO_ACTIVE_MARKUP_TIER = "NO_ACTIVE_MARKUP_TIER",
     PRICING_CALCULATION_FAILED = "PRICING_CALCULATION_FAILED",
+    /**
+     * Caller asked to record settlement on a step that has not yet
+     * received an `external_price`. Indicates a programming error in
+     * the stream orchestrator — settlement must not be attempted from
+     * the PENDING billing state.
+     */
     SETTLEMENT_BEFORE_PRICED = "SETTLEMENT_BEFORE_PRICED",
+    /**
+     * `recordSettlement` was called with an `overflow` payload that
+     * violates the per-step invariant `requested = charged + discount`
+     * (or the discount component is negative). Indicates a programming
+     * error in StreamResultHandler's DISCOUNT branch math.
+     */
     SETTLEMENT_OVERFLOW_INVARIANT = "SETTLEMENT_OVERFLOW_INVARIANT",
     BUDGET_LOCK_FAILED = "BUDGET_LOCK_FAILED",
     TOP_UP_FAILED = "TOP_UP_FAILED",

package/build/v1/billing/billing.errors.js

@@ -3,17 +3,33 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BILLING_ERRORS = exports.BillingErrorCode = void 0;
 var BillingErrorCode;
 (function (BillingErrorCode) {
+    // Markup tier
     BillingErrorCode["MARKUP_TIER_NOT_FOUND"] = "MARKUP_TIER_NOT_FOUND";
     BillingErrorCode["MARKUP_TIER_RANGE_INVALID"] = "MARKUP_TIER_RANGE_INVALID";
     BillingErrorCode["MARKUP_TIER_RANGE_OVERLAPS"] = "MARKUP_TIER_RANGE_OVERLAPS";
     BillingErrorCode["NO_ACTIVE_MARKUP_TIER"] = "NO_ACTIVE_MARKUP_TIER";
+    // Pricing
     BillingErrorCode["PRICING_CALCULATION_FAILED"] = "PRICING_CALCULATION_FAILED";
+    /**
+     * Caller asked to record settlement on a step that has not yet
+     * received an `external_price`. Indicates a programming error in
+     * the stream orchestrator — settlement must not be attempted from
+     * the PENDING billing state.
+     */
     BillingErrorCode["SETTLEMENT_BEFORE_PRICED"] = "SETTLEMENT_BEFORE_PRICED";
+    /**
+     * `recordSettlement` was called with an `overflow` payload that
+     * violates the per-step invariant `requested = charged + discount`
+     * (or the discount component is negative). Indicates a programming
+     * error in StreamResultHandler's DISCOUNT branch math.
+     */
     BillingErrorCode["SETTLEMENT_OVERFLOW_INVARIANT"] = "SETTLEMENT_OVERFLOW_INVARIANT";
+    // Hold orchestration
     BillingErrorCode["BUDGET_LOCK_FAILED"] = "BUDGET_LOCK_FAILED";
     BillingErrorCode["TOP_UP_FAILED"] = "TOP_UP_FAILED";
     BillingErrorCode["HOLD_NOT_OWNED_BY_USER"] = "HOLD_NOT_OWNED_BY_USER";
     BillingErrorCode["BILLING_FINALIZE_FAILED"] = "BILLING_FINALIZE_FAILED";
+    // Validation
     BillingErrorCode["INVALID_PERCENT"] = "INVALID_PERCENT";
     BillingErrorCode["INVALID_AMOUNT_RANGE"] = "INVALID_AMOUNT_RANGE";
 })(BillingErrorCode || (exports.BillingErrorCode = BillingErrorCode = {}));

package/build/v1/billing/billing.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing.errors.js","sourceRoot":"","sources":["../../../v1/billing/billing.errors.ts"],"names":[],"mappings":";;;AAEA,IAAY,gBAiCX;AAjCD,WAAY,gBAAgB;IAExB,mEAA+C,CAAA;IAC/C,2EAAuD,CAAA;IACvD,6EAAyD,CAAA;IACzD,mEAA+C,CAAA;IAG/C,6EAAyD,CAAA;IAOzD,yEAAqD,CAAA;IAOrD,mFAA+D,CAAA;IAG/D,6DAAyC,CAAA;IACzC,mDAA+B,CAAA;IAC/B,qEAAiD,CAAA;IACjD,uEAAmD,CAAA;IAGnD,uDAAmC,CAAA;IACnC,iEAA6C,CAAA;AACjD,CAAC,EAjCW,gBAAgB,gCAAhB,gBAAgB,QAiC3B;AAEY,QAAA,cAAc,GAA4C;IACnE,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE;QACtC,IAAI,EAAE,gBAAgB,CAAC,qBAAqB;QAC5C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,EAAE;QAC1C,IAAI,EAAE,gBAAgB,CAAC,yBAAyB;QAChD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,EAAE;QAC3C,IAAI,EAAE,gBAAgB,CAAC,0BAA0B;QACjD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE;QACtC,IAAI,EAAE,gBAAgB,CAAC,qBAAqB;QAC5C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,EAAE;QAC3C,IAAI,EAAE,gBAAgB,CAAC,0BAA0B;QACjD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,EAAE;QACzC,IAAI,EAAE,gBAAgB,CAAC,wBAAwB;QAC/C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,6BAA6B,CAAC,EAAE;QAC9C,IAAI,EAAE,gBAAgB,CAAC,6BAA6B;QACpD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,EAAE;QACnC,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;QACzC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE;QAC9B,IAAI,EAAE,gBAAgB,CAAC,aAAa;QACpC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,EAAE;QACvC,IAAI,EAAE,gBAAgB,CAAC,sBAAsB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,EAAE;QACxC,IAAI,EAAE,gBAAgB,CAAC,uBAAuB;QAC9C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAAE;QAChC,IAAI,EAAE,gBAAgB,CAAC,eAAe;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,EAAE;QACrC,IAAI,EAAE,gBAAgB,CAAC,oBAAoB;QAC3C,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"billing.errors.js","sourceRoot":"","sources":["../../../v1/billing/billing.errors.ts"],"names":[],"mappings":";;;AAEA,IAAY,gBAiCX;AAjCD,WAAY,gBAAgB;IACxB,cAAc;IACd,mEAA+C,CAAA;IAC/C,2EAAuD,CAAA;IACvD,6EAAyD,CAAA;IACzD,mEAA+C,CAAA;IAE/C,UAAU;IACV,6EAAyD,CAAA;IACzD;;;;;OAKG;IACH,yEAAqD,CAAA;IACrD;;;;;OAKG;IACH,mFAA+D,CAAA;IAE/D,qBAAqB;IACrB,6DAAyC,CAAA;IACzC,mDAA+B,CAAA;IAC/B,qEAAiD,CAAA;IACjD,uEAAmD,CAAA;IAEnD,aAAa;IACb,uDAAmC,CAAA;IACnC,iEAA6C,CAAA;AACjD,CAAC,EAjCW,gBAAgB,gCAAhB,gBAAgB,QAiC3B;AAEY,QAAA,cAAc,GAA4C;IACnE,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE;QACtC,IAAI,EAAE,gBAAgB,CAAC,qBAAqB;QAC5C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,EAAE;QAC1C,IAAI,EAAE,gBAAgB,CAAC,yBAAyB;QAChD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,EAAE;QAC3C,IAAI,EAAE,gBAAgB,CAAC,0BAA0B;QACjD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE;QACtC,IAAI,EAAE,gBAAgB,CAAC,qBAAqB;QAC5C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,EAAE;QAC3C,IAAI,EAAE,gBAAgB,CAAC,0BAA0B;QACjD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,EAAE;QACzC,IAAI,EAAE,gBAAgB,CAAC,wBAAwB;QAC/C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,6BAA6B,CAAC,EAAE;QAC9C,IAAI,EAAE,gBAAgB,CAAC,6BAA6B;QACpD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,EAAE;QACnC,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;QACzC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE;QAC9B,IAAI,EAAE,gBAAgB,CAAC,aAAa;QACpC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,EAAE;QACvC,IAAI,EAAE,gBAAgB,CAAC,sBAAsB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,EAAE;QACxC,IAAI,EAAE,gBAAgB,CAAC,uBAAuB;QAC9C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAAE;QAChC,IAAI,EAAE,gBAAgB,CAAC,eAAe;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,EAAE;QACrC,IAAI,EAAE,gBAAgB,CAAC,oBAAoB;QAC3C,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}

package/build/v1/billing/schemas/finalization-action.enum.d.ts

@@ -1,5 +1,17 @@
+/**
+ * Terminal billing action persisted on a BillingFinalizationOutbox row
+ * and dispatched by the worker:
+ *   CONFIRM — debit the hold (BillingOrchestrator.finalize).
+ *   RELEASE — release the hold without charging (BillingOrchestrator.abort).
+ */
 export declare enum BillingFinalizationAction {
     CONFIRM = "CONFIRM",
     RELEASE = "RELEASE"
 }
+/**
+ * Type guard for raw DB strings. Use when reading
+ * `billing_finalization_outbox.action` from Prisma raw queries — the
+ * column is VARCHAR (project convention), so the runtime value can in
+ * principle drift from the enum (legacy data, manual SQL fix, etc.).
+ */
 export declare function isValidBillingFinalizationAction(value: string): value is BillingFinalizationAction;

package/build/v1/billing/schemas/finalization-action.enum.js

@@ -2,12 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BillingFinalizationAction = void 0;
 exports.isValidBillingFinalizationAction = isValidBillingFinalizationAction;
+/**
+ * Terminal billing action persisted on a BillingFinalizationOutbox row
+ * and dispatched by the worker:
+ *   CONFIRM — debit the hold (BillingOrchestrator.finalize).
+ *   RELEASE — release the hold without charging (BillingOrchestrator.abort).
+ */
 var BillingFinalizationAction;
 (function (BillingFinalizationAction) {
     BillingFinalizationAction["CONFIRM"] = "CONFIRM";
     BillingFinalizationAction["RELEASE"] = "RELEASE";
 })(BillingFinalizationAction || (exports.BillingFinalizationAction = BillingFinalizationAction = {}));
 const BILLING_FINALIZATION_ACTION_VALUES = new Set(Object.values(BillingFinalizationAction));
+/**
+ * Type guard for raw DB strings. Use when reading
+ * `billing_finalization_outbox.action` from Prisma raw queries — the
+ * column is VARCHAR (project convention), so the runtime value can in
+ * principle drift from the enum (legacy data, manual SQL fix, etc.).
+ */
 function isValidBillingFinalizationAction(value) {
     return BILLING_FINALIZATION_ACTION_VALUES.has(value);
 }

package/build/v1/billing/schemas/finalization-action.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"finalization-action.enum.js","sourceRoot":"","sources":["../../../../v1/billing/schemas/finalization-action.enum.ts"],"names":[],"mappings":";;;AAqBA,4EAIC;AAnBD,IAAY,yBAGX;AAHD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;IACnB,gDAAmB,CAAA;AACvB,CAAC,EAHW,yBAAyB,yCAAzB,yBAAyB,QAGpC;AAED,MAAM,kCAAkC,GAAgB,IAAI,GAAG,CAC3D,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAC3C,CAAC;AAQF,SAAgB,gCAAgC,CAC5C,KAAa;IAEb,OAAO,kCAAkC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"finalization-action.enum.js","sourceRoot":"","sources":["../../../../v1/billing/schemas/finalization-action.enum.ts"],"names":[],"mappings":";;;AAqBA,4EAIC;AAzBD;;;;;GAKG;AACH,IAAY,yBAGX;AAHD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;IACnB,gDAAmB,CAAA;AACvB,CAAC,EAHW,yBAAyB,yCAAzB,yBAAyB,QAGpC;AAED,MAAM,kCAAkC,GAAgB,IAAI,GAAG,CAC3D,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAC3C,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,gCAAgC,CAC5C,KAAa;IAEb,OAAO,kCAAkC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/build/v1/billing/schemas/finalization-status.enum.d.ts

@@ -1,6 +1,13 @@
+/**
+ * Lifecycle of a BillingFinalizationOutbox row:
+ *   PENDING — created, awaiting worker pickup or in retry-backoff.
+ *   DONE    — worker successfully finalized (confirmHold/releaseHold).
+ *   FAILED  — terminal: max attempts exhausted, operator must reconcile.
+ */
 export declare enum BillingFinalizationStatus {
     PENDING = "PENDING",
     DONE = "DONE",
     FAILED = "FAILED"
 }
+/** Type guard for raw DB string reads. */
 export declare function isValidBillingFinalizationStatus(value: string): value is BillingFinalizationStatus;

package/build/v1/billing/schemas/finalization-status.enum.js

@@ -2,6 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BillingFinalizationStatus = void 0;
 exports.isValidBillingFinalizationStatus = isValidBillingFinalizationStatus;
+/**
+ * Lifecycle of a BillingFinalizationOutbox row:
+ *   PENDING — created, awaiting worker pickup or in retry-backoff.
+ *   DONE    — worker successfully finalized (confirmHold/releaseHold).
+ *   FAILED  — terminal: max attempts exhausted, operator must reconcile.
+ */
 var BillingFinalizationStatus;
 (function (BillingFinalizationStatus) {
     BillingFinalizationStatus["PENDING"] = "PENDING";
@@ -9,6 +15,7 @@ var BillingFinalizationStatus;
     BillingFinalizationStatus["FAILED"] = "FAILED";
 })(BillingFinalizationStatus || (exports.BillingFinalizationStatus = BillingFinalizationStatus = {}));
 const BILLING_FINALIZATION_STATUS_VALUES = new Set(Object.values(BillingFinalizationStatus));
+/** Type guard for raw DB string reads. */
 function isValidBillingFinalizationStatus(value) {
     return BILLING_FINALIZATION_STATUS_VALUES.has(value);
 }

package/build/v1/billing/schemas/finalization-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"finalization-status.enum.js","sourceRoot":"","sources":["../../../../v1/billing/schemas/finalization-status.enum.ts"],"names":[],"mappings":";;;AAiBA,4EAIC;AAfD,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;IACnB,0CAAa,CAAA;IACb,8CAAiB,CAAA;AACrB,CAAC,EAJW,yBAAyB,yCAAzB,yBAAyB,QAIpC;AAED,MAAM,kCAAkC,GAAgB,IAAI,GAAG,CAC3D,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAC3C,CAAC;AAGF,SAAgB,gCAAgC,CAC5C,KAAa;IAEb,OAAO,kCAAkC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"finalization-status.enum.js","sourceRoot":"","sources":["../../../../v1/billing/schemas/finalization-status.enum.ts"],"names":[],"mappings":";;;AAiBA,4EAIC;AArBD;;;;;GAKG;AACH,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;IACnB,0CAAa,CAAA;IACb,8CAAiB,CAAA;AACrB,CAAC,EAJW,yBAAyB,yCAAzB,yBAAyB,QAIpC;AAED,MAAM,kCAAkC,GAAgB,IAAI,GAAG,CAC3D,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAC3C,CAAC;AAEF,0CAA0C;AAC1C,SAAgB,gCAAgC,CAC5C,KAAa;IAEb,OAAO,kCAAkC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/build/v1/billing/schemas/markup-tier.schema.d.ts

@@ -1,8 +1,30 @@
 import { z } from 'zod';
+/**
+ * Bounds chosen to prevent admin-side abuse and downstream integer overflow.
+ *
+ *  - `MARKUP_PERCENT_MAX` (10000 = 100x) is the largest markup any sane
+ *    pricing model would tolerate; values beyond this are nearly always a
+ *    typo that would silently drain users.
+ *  - `MARKUP_AMOUNT_MAX` (10_000_000_00 tokens = 10 000 000 RUB) caps both
+ *    `fromAmount` and `toAmount`. With `MARKUP_PERCENT_MAX = 10000`, the
+ *    arithmetic in PricingCalculator (`externalTokens * (100 + percent)`)
+ *    stays well below `Number.MAX_SAFE_INTEGER` for any plausible
+ *    externalTokens value.
+ *  - `MARKUP_PRIORITY_RANGE` keeps tiebreak ordering predictable and
+ *    rejects accidental `Number.MIN_SAFE_INTEGER` style values.
+ */
 export declare const MARKUP_PERCENT_MAX = 10000;
 export declare const MARKUP_AMOUNT_MAX = 1000000000;
 export declare const MARKUP_PRIORITY_MIN = -1000;
 export declare const MARKUP_PRIORITY_MAX = 1000;
+/**
+ * MarkupTier — admin-editable markup band applied to a step's external cost.
+ *
+ * Lookup: pick the active tier whose [fromAmount, toAmount) contains the
+ * step's external cost in tokens; toAmount = null means open upper bound.
+ *
+ * Billing: internalPrice = ceil(externalTokens * (1 + percent / 100)).
+ */
 export declare const MarkupTierSchema: z.ZodObject<{
     uuid: z.ZodString;
     fromAmount: z.ZodNumber;

package/build/v1/billing/schemas/markup-tier.schema.js

@@ -3,10 +3,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateMarkupTierRequestSchema = exports.CreateMarkupTierRequestSchema = exports.MarkupTierListResponseSchema = exports.MarkupTierSchema = exports.MARKUP_PRIORITY_MAX = exports.MARKUP_PRIORITY_MIN = exports.MARKUP_AMOUNT_MAX = exports.MARKUP_PERCENT_MAX = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
+/**
+ * Bounds chosen to prevent admin-side abuse and downstream integer overflow.
+ *
+ *  - `MARKUP_PERCENT_MAX` (10000 = 100x) is the largest markup any sane
+ *    pricing model would tolerate; values beyond this are nearly always a
+ *    typo that would silently drain users.
+ *  - `MARKUP_AMOUNT_MAX` (10_000_000_00 tokens = 10 000 000 RUB) caps both
+ *    `fromAmount` and `toAmount`. With `MARKUP_PERCENT_MAX = 10000`, the
+ *    arithmetic in PricingCalculator (`externalTokens * (100 + percent)`)
+ *    stays well below `Number.MAX_SAFE_INTEGER` for any plausible
+ *    externalTokens value.
+ *  - `MARKUP_PRIORITY_RANGE` keeps tiebreak ordering predictable and
+ *    rejects accidental `Number.MIN_SAFE_INTEGER` style values.
+ */
 exports.MARKUP_PERCENT_MAX = 10_000;
 exports.MARKUP_AMOUNT_MAX = 1_000_000_000;
 exports.MARKUP_PRIORITY_MIN = -1_000;
 exports.MARKUP_PRIORITY_MAX = 1_000;
+/**
+ * MarkupTier — admin-editable markup band applied to a step's external cost.
+ *
+ * Lookup: pick the active tier whose [fromAmount, toAmount) contains the
+ * step's external cost in tokens; toAmount = null means open upper bound.
+ *
+ * Billing: internalPrice = ceil(externalTokens * (1 + percent / 100)).
+ */
 exports.MarkupTierSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(shared_1.UUID_REGEX),
     fromAmount: zod_1.z.number().int().nonnegative().max(exports.MARKUP_AMOUNT_MAX),

package/build/v1/billing/schemas/markup-tier.schema.js.map

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

package/build/v1/blog/blog.errors.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BLOG_ERRORS = exports.BlogErrorCode = void 0;
 var BlogErrorCode;
 (function (BlogErrorCode) {
+    // Category errors
     BlogErrorCode["CATEGORY_NOT_FOUND"] = "CATEGORY_NOT_FOUND";
     BlogErrorCode["CATEGORY_ALIAS_ALREADY_EXISTS"] = "CATEGORY_ALIAS_ALREADY_EXISTS";
     BlogErrorCode["CATEGORY_IN_USE"] = "CATEGORY_IN_USE";
@@ -10,16 +11,19 @@ var BlogErrorCode;
     BlogErrorCode["CATEGORY_CREATION_FAILED"] = "CATEGORY_CREATION_FAILED";
     BlogErrorCode["CATEGORY_UPDATE_FAILED"] = "CATEGORY_UPDATE_FAILED";
     BlogErrorCode["CATEGORY_DELETE_FAILED"] = "CATEGORY_DELETE_FAILED";
+    // Post errors
     BlogErrorCode["POST_NOT_FOUND"] = "POST_NOT_FOUND";
     BlogErrorCode["POST_ALIAS_ALREADY_EXISTS"] = "POST_ALIAS_ALREADY_EXISTS";
     BlogErrorCode["INVALID_POST_STATUS"] = "INVALID_POST_STATUS";
     BlogErrorCode["POST_CREATION_FAILED"] = "POST_CREATION_FAILED";
     BlogErrorCode["POST_UPDATE_FAILED"] = "POST_UPDATE_FAILED";
     BlogErrorCode["POST_DELETE_FAILED"] = "POST_DELETE_FAILED";
+    // Validation errors
     BlogErrorCode["INVALID_ALIAS_FORMAT"] = "INVALID_ALIAS_FORMAT";
     BlogErrorCode["AI_WIDGET_VALIDATION_FAILED"] = "AI_WIDGET_VALIDATION_FAILED";
 })(BlogErrorCode || (exports.BlogErrorCode = BlogErrorCode = {}));
 exports.BLOG_ERRORS = {
+    // Category errors
     [BlogErrorCode.CATEGORY_NOT_FOUND]: {
         code: BlogErrorCode.CATEGORY_NOT_FOUND,
         statusCode: 404,
@@ -48,6 +52,7 @@ exports.BLOG_ERRORS = {
         code: BlogErrorCode.CATEGORY_DELETE_FAILED,
         statusCode: 500,
     },
+    // Post errors
     [BlogErrorCode.POST_NOT_FOUND]: {
         code: BlogErrorCode.POST_NOT_FOUND,
         statusCode: 404,
@@ -72,6 +77,7 @@ exports.BLOG_ERRORS = {
         code: BlogErrorCode.POST_DELETE_FAILED,
         statusCode: 500,
     },
+    // Validation errors
     [BlogErrorCode.INVALID_ALIAS_FORMAT]: {
         code: BlogErrorCode.INVALID_ALIAS_FORMAT,
         statusCode: 400,

package/build/v1/blog/blog.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"blog.errors.js","sourceRoot":"","sources":["../../../v1/blog/blog.errors.ts"],"names":[],"mappings":";;;AAEA,IAAY,aAqBX;AArBD,WAAY,aAAa;IAErB,0DAAyC,CAAA;IACzC,gFAA+D,CAAA;IAC/D,oDAAmC,CAAA;IACnC,oEAAmD,CAAA;IACnD,sEAAqD,CAAA;IACrD,kEAAiD,CAAA;IACjD,kEAAiD,CAAA;IAGjD,kDAAiC,CAAA;IACjC,wEAAuD,CAAA;IACvD,4DAA2C,CAAA;IAC3C,8DAA6C,CAAA;IAC7C,0DAAyC,CAAA;IACzC,0DAAyC,CAAA;IAGzC,8DAA6C,CAAA;IAC7C,4EAA2D,CAAA;AAC/D,CAAC,EArBW,aAAa,6BAAb,aAAa,QAqBxB;AAEY,QAAA,WAAW,GAAyC;IAE7D,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,6BAA6B,CAAC,EAAE;QAC3C,IAAI,EAAE,aAAa,CAAC,6BAA6B;QACjD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE;QAC7B,IAAI,EAAE,aAAa,CAAC,eAAe;QACnC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,uBAAuB,CAAC,EAAE;QACrC,IAAI,EAAE,aAAa,CAAC,uBAAuB;QAC3C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,wBAAwB,CAAC,EAAE;QACtC,IAAI,EAAE,aAAa,CAAC,wBAAwB;QAC5C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,sBAAsB,CAAC,EAAE;QACpC,IAAI,EAAE,aAAa,CAAC,sBAAsB;QAC1C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,sBAAsB,CAAC,EAAE;QACpC,IAAI,EAAE,aAAa,CAAC,sBAAsB;QAC1C,UAAU,EAAE,GAAG;KAClB;IAGD,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE;QAC5B,IAAI,EAAE,aAAa,CAAC,cAAc;QAClC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,yBAAyB,CAAC,EAAE;QACvC,IAAI,EAAE,aAAa,CAAC,yBAAyB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE;QACjC,IAAI,EAAE,aAAa,CAAC,mBAAmB;QACvC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE;QAClC,IAAI,EAAE,aAAa,CAAC,oBAAoB;QACxC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IAGD,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE;QAClC,IAAI,EAAE,aAAa,CAAC,oBAAoB;QACxC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,2BAA2B,CAAC,EAAE;QACzC,IAAI,EAAE,aAAa,CAAC,2BAA2B;QAC/C,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"blog.errors.js","sourceRoot":"","sources":["../../../v1/blog/blog.errors.ts"],"names":[],"mappings":";;;AAEA,IAAY,aAqBX;AArBD,WAAY,aAAa;IACrB,kBAAkB;IAClB,0DAAyC,CAAA;IACzC,gFAA+D,CAAA;IAC/D,oDAAmC,CAAA;IACnC,oEAAmD,CAAA;IACnD,sEAAqD,CAAA;IACrD,kEAAiD,CAAA;IACjD,kEAAiD,CAAA;IAEjD,cAAc;IACd,kDAAiC,CAAA;IACjC,wEAAuD,CAAA;IACvD,4DAA2C,CAAA;IAC3C,8DAA6C,CAAA;IAC7C,0DAAyC,CAAA;IACzC,0DAAyC,CAAA;IAEzC,oBAAoB;IACpB,8DAA6C,CAAA;IAC7C,4EAA2D,CAAA;AAC/D,CAAC,EArBW,aAAa,6BAAb,aAAa,QAqBxB;AAEY,QAAA,WAAW,GAAyC;IAC7D,kBAAkB;IAClB,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,6BAA6B,CAAC,EAAE;QAC3C,IAAI,EAAE,aAAa,CAAC,6BAA6B;QACjD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE;QAC7B,IAAI,EAAE,aAAa,CAAC,eAAe;QACnC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,uBAAuB,CAAC,EAAE;QACrC,IAAI,EAAE,aAAa,CAAC,uBAAuB;QAC3C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,wBAAwB,CAAC,EAAE;QACtC,IAAI,EAAE,aAAa,CAAC,wBAAwB;QAC5C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,sBAAsB,CAAC,EAAE;QACpC,IAAI,EAAE,aAAa,CAAC,sBAAsB;QAC1C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,sBAAsB,CAAC,EAAE;QACpC,IAAI,EAAE,aAAa,CAAC,sBAAsB;QAC1C,UAAU,EAAE,GAAG;KAClB;IAED,cAAc;IACd,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE;QAC5B,IAAI,EAAE,aAAa,CAAC,cAAc;QAClC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,yBAAyB,CAAC,EAAE;QACvC,IAAI,EAAE,aAAa,CAAC,yBAAyB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE;QACjC,IAAI,EAAE,aAAa,CAAC,mBAAmB;QACvC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE;QAClC,IAAI,EAAE,aAAa,CAAC,oBAAoB;QACxC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,kBAAkB;QACtC,UAAU,EAAE,GAAG;KAClB;IAED,oBAAoB;IACpB,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE;QAClC,IAAI,EAAE,aAAa,CAAC,oBAAoB;QACxC,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,aAAa,CAAC,2BAA2B,CAAC,EAAE;QACzC,IAAI,EAAE,aAAa,CAAC,2BAA2B;QAC/C,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}

package/build/v1/blog/index.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/blog/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,gDAA8B;AAC9B,mDAAiC;AACjC,kDAAgC;AAChC,mDAAiC;AAEjC,iDAK2B;AAJvB,+HAAA,gCAAgC,OAAA;AAChC,0HAAA,2BAA2B,OAAA;AAC3B,gIAAA,iCAAiC,OAAA;AACjC,2HAAA,4BAA4B,OAAA;AAEhC,uCAKsB;AAJlB,sHAAA,4BAA4B,OAAA;AAC5B,iHAAA,uBAAuB,OAAA;AACvB,uHAAA,6BAA6B,OAAA;AAC7B,kHAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/blog/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,gDAA8B;AAC9B,mDAAiC;AACjC,kDAAgC;AAChC,mDAAiC;AACjC,uCAAuC;AACvC,iDAK2B;AAJvB,+HAAA,gCAAgC,OAAA;AAChC,0HAAA,2BAA2B,OAAA;AAC3B,gIAAA,iCAAiC,OAAA;AACjC,2HAAA,4BAA4B,OAAA;AAEhC,uCAKsB;AAJlB,sHAAA,4BAA4B,OAAA;AAC5B,iHAAA,uBAAuB,OAAA;AACvB,uHAAA,6BAA6B,OAAA;AAC7B,kHAAA,wBAAwB,OAAA"}

package/build/v1/blog/schemas/admin-post-sort.enum.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Admin Blog Post sort fields.
+ * Values map to sortable BlogPost columns.
+ * Sort direction uses the shared `SortOrder` enum.
+ */
 export declare enum AdminPostSortField {
     CREATED_AT = "createdAt",
     UPDATED_AT = "updatedAt",

package/build/v1/blog/schemas/admin-post-sort.enum.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminPostSortField = void 0;
+/**
+ * Admin Blog Post sort fields.
+ * Values map to sortable BlogPost columns.
+ * Sort direction uses the shared `SortOrder` enum.
+ */
 var AdminPostSortField;
 (function (AdminPostSortField) {
     AdminPostSortField["CREATED_AT"] = "createdAt";

package/build/v1/blog/schemas/admin-post-sort.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-post-sort.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/admin-post-sort.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,8CAAwB,CAAA;IACxB,8CAAwB,CAAA;IACxB,qCAAe,CAAA;IACf,gDAA0B,CAAA;AAC5B,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B"}
+{"version":3,"file":"admin-post-sort.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/admin-post-sort.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,8CAAwB,CAAA;IACxB,8CAAwB,CAAA;IACxB,qCAAe,CAAA;IACf,gDAA0B,CAAA;AAC5B,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B"}

package/build/v1/blog/schemas/blog-category-status.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Blog Category Status
+ */
 export declare enum BlogCategoryStatus {
     DRAFT = "DRAFT",
     PUBLISHED = "PUBLISHED",

package/build/v1/blog/schemas/blog-category-status.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlogCategoryStatus = void 0;
+/**
+ * Blog Category Status
+ */
 var BlogCategoryStatus;
 (function (BlogCategoryStatus) {
     BlogCategoryStatus["DRAFT"] = "DRAFT";

package/build/v1/blog/schemas/blog-category-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"blog-category-status.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/blog-category-status.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;IACf,6CAAuB,CAAA;IACvB,2CAAqB,CAAA;AACvB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B"}
+{"version":3,"file":"blog-category-status.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/blog-category-status.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;IACf,6CAAuB,CAAA;IACvB,2CAAqB,CAAA;AACvB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B"}

package/build/v1/blog/schemas/blog-post-mark.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Blog Post Marks Enum
+ * Used as feature flags for blog posts
+ */
 export declare enum BlogPostMark {
     AI_WIDGET = "AI_WIDGET"
 }

package/build/v1/blog/schemas/blog-post-mark.enum.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlogPostMark = void 0;
+/**
+ * Blog Post Marks Enum
+ * Used as feature flags for blog posts
+ */
 var BlogPostMark;
 (function (BlogPostMark) {
     BlogPostMark["AI_WIDGET"] = "AI_WIDGET";

package/build/v1/blog/schemas/blog-post-mark.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"blog-post-mark.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/blog-post-mark.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,uCAAuB,CAAA;AAC3B,CAAC,EAFW,YAAY,4BAAZ,YAAY,QAEvB"}
+{"version":3,"file":"blog-post-mark.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/blog-post-mark.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,uCAAuB,CAAA;AAC3B,CAAC,EAFW,YAAY,4BAAZ,YAAY,QAEvB"}

package/build/v1/blog/schemas/blog-post-status.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Blog Post Status
+ */
 export declare enum BlogPostStatus {
     DRAFT = "DRAFT",
     PUBLISHED = "PUBLISHED",

package/build/v1/blog/schemas/blog-post-status.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlogPostStatus = void 0;
+/**
+ * Blog Post Status
+ */
 var BlogPostStatus;
 (function (BlogPostStatus) {
     BlogPostStatus["DRAFT"] = "DRAFT";

package/build/v1/blog/schemas/blog-post-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"blog-post-status.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/blog-post-status.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,yCAAuB,CAAA;IACvB,uCAAqB,CAAA;AACvB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}
+{"version":3,"file":"blog-post-status.enum.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/blog-post-status.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,yCAAuB,CAAA;IACvB,uCAAqB,CAAA;AACvB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}

package/build/v1/blog/schemas/category-response.schema.d.ts

@@ -1,5 +1,8 @@
 import { z } from 'zod';
 import { BlogCategoryStatus } from './blog-category-status.enum';
+/**
+ * Category Response Schema
+ */
 export declare const CategoryResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     alias: z.ZodString;

package/build/v1/blog/schemas/category-response.schema.js

@@ -4,12 +4,18 @@ exports.CategoryResponseSchema = void 0;
 const zod_1 = require("zod");
 const regex_1 = require("../../../shared/regex");
 const blog_category_status_enum_1 = require("./blog-category-status.enum");
+/**
+ * Category Response Schema
+ */
 exports.CategoryResponseSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
     alias: zod_1.z.string(),
     title: zod_1.z.string(),
+    /** Вводный текст страницы категории. Пустая строка — блок не рендерится. */
     description: zod_1.z.string(),
+    /** `null` — тайтл не задан, фронт собирает его по своему шаблону. */
     metaTitle: zod_1.z.string().nullable(),
+    /** `null` — описание не задано, фронт собирает его по своему шаблону. */
     metaDescription: zod_1.z.string().nullable(),
     order: zod_1.z.number().int().nonnegative(),
     status: zod_1.z.enum(blog_category_status_enum_1.BlogCategoryStatus),

package/build/v1/blog/schemas/category-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"category-response.schema.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/category-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,iDAAmE;AACnE,2EAAiE;AAKpD,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IAEjB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IAEvB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,8CAAkB,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;CAC5C,CAAC,CAAC"}
+{"version":3,"file":"category-response.schema.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/category-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,iDAAmE;AACnE,2EAAiE;AAEjE;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;IAClC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,4EAA4E;IAC5E,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,qEAAqE;IACrE,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,yEAAyE;IACzE,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,8CAAkB,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;CAC5C,CAAC,CAAC"}

package/build/v1/blog/schemas/create-category-request.schema.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { BlogCategoryStatus } from './blog-category-status.enum';
+/**
+ * Create Category Request Schema
+ * Error messages: CreateCategoryRequest.{field}.{rule}
+ */
 export declare const CreateCategoryRequestSchema: z.ZodObject<{
     alias: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     title: z.ZodString;

package/build/v1/blog/schemas/create-category-request.schema.js

@@ -4,6 +4,10 @@ exports.CreateCategoryRequestSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const blog_category_status_enum_1 = require("./blog-category-status.enum");
+/**
+ * Create Category Request Schema
+ * Error messages: CreateCategoryRequest.{field}.{rule}
+ */
 exports.CreateCategoryRequestSchema = zod_1.z.object({
     alias: zod_1.z
         .string({ error: 'CreateCategoryRequest.alias.required' })
@@ -15,10 +19,16 @@ exports.CreateCategoryRequestSchema = zod_1.z.object({
         .string({ error: 'CreateCategoryRequest.title.required' })
         .min(1, { message: 'CreateCategoryRequest.title.min' })
         .max(200, { message: 'CreateCategoryRequest.title.max' }),
+    /** Вводный текст страницы категории. Лимиты как у описания поста. */
     description: zod_1.z
         .string()
         .max(1000, { message: 'CreateCategoryRequest.description.max' })
         .default(''),
+    /**
+     * SEO-мета категории. `nullish`: поле можно не слать вовсе или прислать
+     * `null` — и то и другое означает «фронт собирает мету по своему шаблону».
+     * Лимиты как у поста: тайтл 100, описание 200.
+     */
     metaTitle: zod_1.z
         .string()
         .max(100, { message: 'CreateCategoryRequest.metaTitle.max' })

package/build/v1/blog/schemas/create-category-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-category-request.schema.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/create-category-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,2EAAiE;AAMpD,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACrE,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACjD,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;IAE7D,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC/D,OAAO,CAAC,EAAE,CAAC;IAMhB,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC5D,OAAO,EAAE;IACd,eAAe,EAAE,OAAC;SACb,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAClE,OAAO,EAAE;IACd,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAClG,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,8CAAkB,CAAC,CAAC,OAAO,CAAC,8CAAkB,CAAC,KAAK,CAAC;CACvE,CAAC,CAAC"}
+{"version":3,"file":"create-category-request.schema.js","sourceRoot":"","sources":["../../../../v1/blog/schemas/create-category-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,2EAAiE;AAEjE;;;GAGG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACrE,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACjD,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;IAC7D,qEAAqE;IACrE,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC/D,OAAO,CAAC,EAAE,CAAC;IAChB;;;;OAIG;IACH,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC5D,OAAO,EAAE;IACd,eAAe,EAAE,OAAC;SACb,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAClE,OAAO,EAAE;IACd,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAClG,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,8CAAkB,CAAC,CAAC,OAAO,CAAC,8CAAkB,CAAC,KAAK,CAAC;CACvE,CAAC,CAAC"}

package/build/v1/blog/schemas/create-post-request.schema.d.ts

@@ -1,6 +1,10 @@
 import { z } from 'zod';
 import { BlogPostStatus } from './blog-post-status.enum';
 import { BlogPostMark } from './blog-post-mark.enum';
+/**
+ * Create Post Request Schema
+ * Error messages: CreatePostRequest.{field}.{rule}
+ */
 export declare const CreatePostRequestSchema: z.ZodObject<{
     alias: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     title: z.ZodString;