@veruna/api-contracts 20.0.0 → 20.2.0

package/build/v1/subscription/subscription.errors.js

@@ -16,8 +16,17 @@ var SubscriptionErrorCode;
     SubscriptionErrorCode["PAYMENT_ALREADY_FINALIZED"] = "PAYMENT_ALREADY_FINALIZED";
     SubscriptionErrorCode["INVALID_ENTITLEMENT_SNAPSHOT"] = "INVALID_ENTITLEMENT_SNAPSHOT";
     SubscriptionErrorCode["ILLEGAL_STATUS_TRANSITION"] = "ILLEGAL_STATUS_TRANSITION";
+    /** A plan change is already in progress (an upgrade order is pending/unfulfilled). */
     SubscriptionErrorCode["CHANGE_ALREADY_IN_PROGRESS"] = "CHANGE_ALREADY_IN_PROGRESS";
+    /** Another billing operation for this user is currently being processed (concurrency lock). */
     SubscriptionErrorCode["BILLING_OPERATION_IN_PROGRESS"] = "BILLING_OPERATION_IN_PROGRESS";
+    /**
+     * POST /subscription/pay-now was called but canPayNow would be false: the subscriber
+     * withdrew consent (cancelAtPeriodEnd — 376-ФЗ), the subscription was refunded, superseded
+     * or force-expired by an admin, it is a comp (unpaid) grant, or more than 11 months have
+     * passed since the term became unpaid (reactivation window closed — see
+     * LOCAL_DUNNING_DEADLINE_MONTHS).
+     */
     SubscriptionErrorCode["PAY_NOW_NOT_ALLOWED"] = "PAY_NOW_NOT_ALLOWED";
 })(SubscriptionErrorCode || (exports.SubscriptionErrorCode = SubscriptionErrorCode = {}));
 exports.SUBSCRIPTION_ERRORS = {

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

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

package/build/v1/tasks/queries/get-unreg-tasks.query.d.ts

@@ -1,5 +1,22 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Public (unauthenticated) endpoint that returns the task list shown
+ * to visitors before they register.
+ *
+ * **Authentication:** none — callable by SSR, crawlers, and anonymous
+ * browsers without any bearer or unreg token.
+ *
+ * **Response semantics:** the payload is filtered to active
+ * `TaskDefinition` rows whose `visibility.unregistered !== HIDDEN`.
+ * Every item is returned with:
+ *  - `access: false` (unreg users can never complete tasks directly)
+ *  - `status: AVAILABLE`
+ *  - `currentCompletion: 0`
+ *
+ * No per-user state is returned. Used as a marketing teaser to
+ * motivate registration.
+ */
 export declare namespace GetUnregTasksQuery {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{

package/build/v1/tasks/queries/get-unreg-tasks.query.js

@@ -5,6 +5,23 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * Public (unauthenticated) endpoint that returns the task list shown
+ * to visitors before they register.
+ *
+ * **Authentication:** none — callable by SSR, crawlers, and anonymous
+ * browsers without any bearer or unreg token.
+ *
+ * **Response semantics:** the payload is filtered to active
+ * `TaskDefinition` rows whose `visibility.unregistered !== HIDDEN`.
+ * Every item is returned with:
+ *  - `access: false` (unreg users can never complete tasks directly)
+ *  - `status: AVAILABLE`
+ *  - `currentCompletion: 0`
+ *
+ * No per-user state is returned. Used as a marketing teaser to
+ * motivate registration.
+ */
 var GetUnregTasksQuery;
 (function (GetUnregTasksQuery) {
     GetUnregTasksQuery.Request = zod_1.z.object({});

package/build/v1/tasks/queries/get-unreg-tasks.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-unreg-tasks.query.js","sourceRoot":"","sources":["../../../../v1/tasks/queries/get-unreg-tasks.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAwD;AACxD,gDAA6C;AAC7C,uEAA8D;AAmB9D,IAAiB,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,2BAAQ,GAAG,oCAA0B,CAAC;IAEtC,sBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACnC,yBAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,kBAAkB,kCAAlB,kBAAkB,QASlC"}
+{"version":3,"file":"get-unreg-tasks.query.js","sourceRoot":"","sources":["../../../../v1/tasks/queries/get-unreg-tasks.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAwD;AACxD,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,IAAiB,kBAAkB,CASlC;AATD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,2BAAQ,GAAG,oCAA0B,CAAC;IAEtC,sBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IACnC,yBAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,kBAAkB,kCAAlB,kBAAkB,QASlC"}

package/build/v1/tasks/schemas/admin-task-definition.schema.js

@@ -9,6 +9,12 @@ const task_requirements_schema_1 = require("./task-requirements.schema");
 const tasks_constants_1 = require("../tasks.constants");
 const task_definition_status_enum_1 = require("./task-definition-status.enum");
 const task_type_enum_1 = require("./task-type.enum");
+/**
+ * Admin task metadata — uses the shared `createMetadataSchema`
+ * factory with tasks-specific limits. All security protections
+ * (prototype-pollution guard, safe key names, typed values) come
+ * from the factory for free.
+ */
 const MetadataSchema = (0, metadata_schema_1.createMetadataSchema)({
     maxBytes: tasks_constants_1.MAX_TASK_METADATA_BYTES,
     maxDepth: tasks_constants_1.MAX_TASK_METADATA_DEPTH,

package/build/v1/tasks/schemas/admin-task-definition.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-task-definition.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/admin-task-definition.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAAuE;AACvE,iDAAqE;AACrE,iEAA8D;AAC9D,yEAAoE;AACpE,wDAS4B;AAC5B,+EAAqE;AACrE,qDAA4C;AAQ5C,MAAM,cAAc,GAAG,IAAA,sCAAoB,EAAC;IACxC,QAAQ,EAAE,yCAAuB;IACjC,QAAQ,EAAE,yCAAuB;IACjC,OAAO,EAAE,wCAAsB;CAClC,CAAC,CAAC;AAEU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACtC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;IACxB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAChC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC;IACtB,UAAU,EAAE,2CAAoB;IAChC,YAAY,EAAE,iDAAsB;IACpC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,kDAAoB,CAAC;IACpC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEU,QAAA,qCAAqC,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1D,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC;CAC5C,CAAC,CAAC;AAEU,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACtD,QAAQ,EAAE,OAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,KAAK,CAAC,iCAAe,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAClF,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC5D,GAAG,CAAC,uCAAqB,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;IACrF,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC;SACrE,GAAG,CAAC,6CAA2B,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC5F,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC5D,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,mBAAmB,EAAE,OAAC;SACjB,MAAM,CAAC,EAAE,KAAK,EAAE,0DAA0D,EAAE,CAAC;SAC7E,IAAI,CAAC,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC;IACjF,YAAY,EAAE,OAAC;SACV,MAAM,CAAC,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;SACtE,KAAK,CAAC,oCAA4B,EAAE;QACjC,OAAO,EAAE,kDAAkD;KAC9D,CAAC;IACN,cAAc,EAAE,OAAC;SACZ,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;SACxE,GAAG,CAAC,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;SAClE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;SACrE,GAAG,CAAC,sCAAoB,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;SACxF,OAAO,CAAC,CAAC,CAAC;IACf,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,EAAE,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;IAC7E,UAAU,EAAE,2CAAoB;IAChC,YAAY,EAAE,iDAAsB;IACpC,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,GAAG,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC5D,GAAG,CAAC,gCAAc,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SACzE,OAAO,CAAC,CAAC,CAAC;IACf,MAAM,EAAE,OAAC;SACJ,UAAU,CAAC,kDAAoB,EAAE;QAC9B,KAAK,EAAE,4CAA4C;KACtD,CAAC;SACD,OAAO,CAAC,kDAAoB,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC;SACnE,QAAQ,CAAC,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SACtE,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEC,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACtD,QAAQ,EAAE,OAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,KAAK,CAAC,iCAAe,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAClF,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC5D,GAAG,CAAC,uCAAqB,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAChF,QAAQ,EAAE;IACf,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC;SACrE,GAAG,CAAC,6CAA2B,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC5F,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC5D,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,mBAAmB,EAAE,OAAC;SACjB,MAAM,CAAC,EAAE,KAAK,EAAE,0DAA0D,EAAE,CAAC;SAC7E,IAAI,CAAC,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC;SAC5E,QAAQ,EAAE;IACf,YAAY,EAAE,OAAC;SACV,MAAM,CAAC,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;SACtE,KAAK,CAAC,oCAA4B,EAAE;QACjC,OAAO,EAAE,kDAAkD;KAC9D,CAAC;SACD,QAAQ,EAAE;IACf,cAAc,EAAE,OAAC;SACZ,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;SACxE,GAAG,CAAC,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;SAClE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;SACrE,GAAG,CAAC,sCAAoB,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;SACxF,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC;SACF,UAAU,CAAC,yBAAQ,EAAE,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;SAC3E,QAAQ,EAAE;IACf,UAAU,EAAE,2CAAoB,CAAC,QAAQ,EAAE;IAC3C,YAAY,EAAE,iDAAsB,CAAC,QAAQ,EAAE;IAC/C,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,GAAG,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC5D,GAAG,CAAC,gCAAc,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SACzE,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC;SACJ,UAAU,CAAC,kDAAoB,EAAE;QAC9B,KAAK,EAAE,4CAA4C;KACtD,CAAC;SACD,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC;SACnE,QAAQ,CAAC,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SACtE,QAAQ,EAAE;SACV,QAAQ,EAAE;IACf,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC,MAAM,EAAE,CAAC"}
+{"version":3,"file":"admin-task-definition.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/admin-task-definition.schema.ts"],"names":[],"mappings":"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"}

package/build/v1/tasks/schemas/backfill-registration-grants-request.schema.d.ts

@@ -1,4 +1,13 @@
 import { z } from 'zod';
+/**
+ * Keyset pagination: `cursor` is the last userId of the previous page
+ * (uuid, exclusive); null/omitted starts from the beginning. Keyset (not
+ * offset) so page boundaries stay deterministic (userId is unique) and
+ * stable while the activated cohort grows mid-run. The whole body defaults
+ * so a POST without a body starts the first page. NOTE: with
+ * `Content-Type: application/json` an EMPTY payload is rejected by the
+ * body parser before validation — send `{}` (admin-mcp does).
+ */
 export declare const BackfillRegistrationGrantsRequestSchema: z.ZodDefault<z.ZodObject<{
     cursor: z.ZodDefault<z.ZodNullable<z.ZodUUID>>;
     limit: z.ZodDefault<z.ZodNumber>;

package/build/v1/tasks/schemas/backfill-registration-grants-request.schema.js

@@ -3,8 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackfillRegistrationGrantsRequestSchema = void 0;
 const zod_1 = require("zod");
 const DEFAULT_LIMIT = 100;
+// Capped so a sequential page (per-user verify+claim, ~4 queries each)
+// finishes well inside the edge proxy timeout — counters/nextCursor must
+// reach the admin.
 const MAX_LIMIT = 200;
 const MIN_LIMIT = 1;
+/**
+ * Keyset pagination: `cursor` is the last userId of the previous page
+ * (uuid, exclusive); null/omitted starts from the beginning. Keyset (not
+ * offset) so page boundaries stay deterministic (userId is unique) and
+ * stable while the activated cohort grows mid-run. The whole body defaults
+ * so a POST without a body starts the first page. NOTE: with
+ * `Content-Type: application/json` an EMPTY payload is rejected by the
+ * body parser before validation — send `{}` (admin-mcp does).
+ */
 exports.BackfillRegistrationGrantsRequestSchema = zod_1.z
     .object({
     cursor: zod_1.z

package/build/v1/tasks/schemas/backfill-registration-grants-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"backfill-registration-grants-request.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/backfill-registration-grants-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,aAAa,GAAG,GAAG,CAAC;AAI1B,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,SAAS,GAAG,CAAC,CAAC;AAWP,QAAA,uCAAuC,GAAG,OAAC;KACnD,MAAM,CAAC;IACJ,MAAM,EAAE,OAAC;SACJ,IAAI,CAAC,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SAClE,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;IAClB,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC;SACrE,GAAG,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC/D,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC1E,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC1E,OAAO,CAAC,aAAa,CAAC;CAC9B,CAAC;KACD,MAAM,EAAE;KACR,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC"}
+{"version":3,"file":"backfill-registration-grants-request.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/backfill-registration-grants-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,uEAAuE;AACvE,yEAAyE;AACzE,mBAAmB;AACnB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;;;;;GAQG;AACU,QAAA,uCAAuC,GAAG,OAAC;KACnD,MAAM,CAAC;IACJ,MAAM,EAAE,OAAC;SACJ,IAAI,CAAC,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;SAClE,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;IAClB,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC;SACrE,GAAG,CAAC,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC/D,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC1E,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;SAC1E,OAAO,CAAC,aAAa,CAAC;CAC9B,CAAC;KACD,MAAM,EAAE;KACR,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC"}

package/build/v1/tasks/schemas/backfill-registration-grants-response.schema.js

@@ -7,6 +7,7 @@ exports.BackfillRegistrationGrantsResponseSchema = zod_1.z.object({
     claimed: zod_1.z.number().int(),
     skipped: zod_1.z.number().int(),
     failed: zod_1.z.number().int(),
+    /** Cursor (last scanned userId) to resume from, or null when the cohort is exhausted. */
     nextCursor: zod_1.z.uuid().nullable(),
 });
 //# sourceMappingURL=backfill-registration-grants-response.schema.js.map

package/build/v1/tasks/schemas/backfill-registration-grants-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"backfill-registration-grants-response.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/backfill-registration-grants-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAEX,QAAA,wCAAwC,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7D,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAExB,UAAU,EAAE,OAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}
+{"version":3,"file":"backfill-registration-grants-response.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/backfill-registration-grants-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAEX,QAAA,wCAAwC,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7D,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,yFAAyF;IACzF,UAAU,EAAE,OAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}

package/build/v1/tasks/schemas/metadata/task-code-metadata.registry.d.ts

@@ -1,4 +1,29 @@
 import type { ZodTypeAny } from 'zod';
 import { TaskCode } from '../task-code.enum';
+/**
+ * Maps a built-in `TaskCode` to its required metadata Zod schema. When
+ * an admin creates/updates a task definition with a `taskCode` present
+ * in this map, the `metadata` field MUST pass the mapped schema or the
+ * request is rejected with `TASK_CONFIG_INVALID`.
+ *
+ * Task codes NOT in this map accept any metadata shape (validated only
+ * by the generic `createMetadataSchema` factory for shape/size limits).
+ *
+ * The registry is exposed as a strongly-typed `Record` for tests that
+ * need direct property access by enum value. For runtime lookup from
+ * a raw string (e.g. admin request / DB row), use
+ * `getTaskCodeMetadataSchema()` below — it avoids `as` casts.
+ */
 export declare const TASK_CODE_METADATA_REGISTRY: Partial<Record<TaskCode, ZodTypeAny>>;
+/**
+ * Type-safe lookup of a metadata schema by an arbitrary `taskCode`
+ * string. Returns the registered schema, or `null` when:
+ *  - the taskCode is unknown (not in `TaskCode` enum), or
+ *  - the taskCode exists but has no metadata schema registered
+ *    (e.g. `REGISTER`, `COMPLETE_REGISTRATION`).
+ *
+ * Use this helper in application handlers instead of indexing
+ * `TASK_CODE_METADATA_REGISTRY[...]` — direct indexing requires an
+ * `as keyof typeof ...` cast that the project's code style forbids.
+ */
 export declare function getTaskCodeMetadataSchema(taskCode: string): ZodTypeAny | null;

package/build/v1/tasks/schemas/metadata/task-code-metadata.registry.js

@@ -4,10 +4,39 @@ exports.TASK_CODE_METADATA_REGISTRY = void 0;
 exports.getTaskCodeMetadataSchema = getTaskCodeMetadataSchema;
 const task_code_enum_1 = require("../task-code.enum");
 const telegram_channel_metadata_schema_1 = require("./telegram-channel-metadata.schema");
+/**
+ * Maps a built-in `TaskCode` to its required metadata Zod schema. When
+ * an admin creates/updates a task definition with a `taskCode` present
+ * in this map, the `metadata` field MUST pass the mapped schema or the
+ * request is rejected with `TASK_CONFIG_INVALID`.
+ *
+ * Task codes NOT in this map accept any metadata shape (validated only
+ * by the generic `createMetadataSchema` factory for shape/size limits).
+ *
+ * The registry is exposed as a strongly-typed `Record` for tests that
+ * need direct property access by enum value. For runtime lookup from
+ * a raw string (e.g. admin request / DB row), use
+ * `getTaskCodeMetadataSchema()` below — it avoids `as` casts.
+ */
 exports.TASK_CODE_METADATA_REGISTRY = {
     [task_code_enum_1.TaskCode.SUBSCRIBE_TELEGRAM_CHANNEL]: telegram_channel_metadata_schema_1.TelegramChannelMetadataSchema,
 };
+/**
+ * Type-safe lookup of a metadata schema by an arbitrary `taskCode`
+ * string. Returns the registered schema, or `null` when:
+ *  - the taskCode is unknown (not in `TaskCode` enum), or
+ *  - the taskCode exists but has no metadata schema registered
+ *    (e.g. `REGISTER`, `COMPLETE_REGISTRATION`).
+ *
+ * Use this helper in application handlers instead of indexing
+ * `TASK_CODE_METADATA_REGISTRY[...]` — direct indexing requires an
+ * `as keyof typeof ...` cast that the project's code style forbids.
+ */
 function getTaskCodeMetadataSchema(taskCode) {
+    // `Object.entries` yields `[string, ZodTypeAny | undefined][]` for
+    // `Partial<Record<TaskCode, ZodTypeAny>>` — we can match the
+    // incoming string directly against registered keys without any
+    // type assertions.
     for (const [registeredCode, schema] of Object.entries(exports.TASK_CODE_METADATA_REGISTRY)) {
         if (registeredCode === taskCode && schema !== undefined) {
             return schema;

package/build/v1/tasks/schemas/metadata/task-code-metadata.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-code-metadata.registry.js","sourceRoot":"","sources":["../../../../../v1/tasks/schemas/metadata/task-code-metadata.registry.ts"],"names":[],"mappings":";;;AAiCA,8DAWC;AA3CD,sDAA6C;AAC7C,yFAAmF;AAgBtE,QAAA,2BAA2B,GAA0C;IAC9E,CAAC,yBAAQ,CAAC,0BAA0B,CAAC,EAAE,gEAA6B;CACvE,CAAC;AAaF,SAAgB,yBAAyB,CAAC,QAAgB;IAKtD,KAAK,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mCAA2B,CAAC,EAAE,CAAC;QACjF,IAAI,cAAc,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}
+{"version":3,"file":"task-code-metadata.registry.js","sourceRoot":"","sources":["../../../../../v1/tasks/schemas/metadata/task-code-metadata.registry.ts"],"names":[],"mappings":";;;AAiCA,8DAWC;AA3CD,sDAA6C;AAC7C,yFAAmF;AAEnF;;;;;;;;;;;;;GAaG;AACU,QAAA,2BAA2B,GAA0C;IAC9E,CAAC,yBAAQ,CAAC,0BAA0B,CAAC,EAAE,gEAA6B;CACvE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAgB,yBAAyB,CAAC,QAAgB;IACtD,mEAAmE;IACnE,6DAA6D;IAC7D,+DAA+D;IAC/D,mBAAmB;IACnB,KAAK,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mCAA2B,CAAC,EAAE,CAAC;QACjF,IAAI,cAAc,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/build/v1/tasks/schemas/metadata/telegram-channel-metadata.schema.d.ts

@@ -1,6 +1,28 @@
 import { z } from 'zod';
+/**
+ * Regex for numeric Telegram supergroup/channel IDs. Telegram chat IDs
+ * for supergroups and channels always start with `-100` followed by
+ * 9–15 digits.
+ */
 export declare const TELEGRAM_CHANNEL_ID_REGEX: RegExp;
+/**
+ * Regex for public Telegram channel/group URLs. Accepts only the
+ * official `t.me` and `telegram.me` domains (optionally `www.`-prefixed)
+ * over HTTPS, followed by a channel username or `joinchat/…` / `+`
+ * invite path. Crucially, this blocks arbitrary schemes such as
+ * `javascript:`, `data:`, and `file://` that `z.string().url()` would
+ * otherwise accept — defending consumers of this metadata (e.g.
+ * admin UI) from XSS/phishing via task configuration.
+ *
+ * Path validation is deliberately loose (`[A-Za-z0-9_+/\-]{1,64}`) so
+ * we cover usernames, invite codes (`joinchat/...`), and the newer
+ * `+abc...` format without hand-picking each case.
+ */
 export declare const TELEGRAM_CHANNEL_URL_REGEX: RegExp;
+/**
+ * Metadata for `SUBSCRIBE_TELEGRAM_CHANNEL` tasks. Validated by the
+ * admin create/update handlers before persisting.
+ */
 export declare const TelegramChannelMetadataSchema: z.ZodObject<{
     channelId: z.ZodString;
     channelUrl: z.ZodString;

package/build/v1/tasks/schemas/metadata/telegram-channel-metadata.schema.js

@@ -2,8 +2,30 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TelegramChannelMetadataSchema = exports.TELEGRAM_CHANNEL_URL_REGEX = exports.TELEGRAM_CHANNEL_ID_REGEX = void 0;
 const zod_1 = require("zod");
+/**
+ * Regex for numeric Telegram supergroup/channel IDs. Telegram chat IDs
+ * for supergroups and channels always start with `-100` followed by
+ * 9–15 digits.
+ */
 exports.TELEGRAM_CHANNEL_ID_REGEX = /^-100\d{9,15}$/;
+/**
+ * Regex for public Telegram channel/group URLs. Accepts only the
+ * official `t.me` and `telegram.me` domains (optionally `www.`-prefixed)
+ * over HTTPS, followed by a channel username or `joinchat/…` / `+`
+ * invite path. Crucially, this blocks arbitrary schemes such as
+ * `javascript:`, `data:`, and `file://` that `z.string().url()` would
+ * otherwise accept — defending consumers of this metadata (e.g.
+ * admin UI) from XSS/phishing via task configuration.
+ *
+ * Path validation is deliberately loose (`[A-Za-z0-9_+/\-]{1,64}`) so
+ * we cover usernames, invite codes (`joinchat/...`), and the newer
+ * `+abc...` format without hand-picking each case.
+ */
 exports.TELEGRAM_CHANNEL_URL_REGEX = /^https:\/\/(?:www\.)?(?:t|telegram)\.me\/[A-Za-z0-9_+/\-]{1,64}$/;
+/**
+ * Metadata for `SUBSCRIBE_TELEGRAM_CHANNEL` tasks. Validated by the
+ * admin create/update handlers before persisting.
+ */
 exports.TelegramChannelMetadataSchema = zod_1.z
     .object({
     channelId: zod_1.z

package/build/v1/tasks/schemas/metadata/telegram-channel-metadata.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"telegram-channel-metadata.schema.js","sourceRoot":"","sources":["../../../../../v1/tasks/schemas/metadata/telegram-channel-metadata.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAOX,QAAA,yBAAyB,GAAG,gBAAgB,CAAC;AAe7C,QAAA,0BAA0B,GACnC,kEAAkE,CAAC;AAM1D,QAAA,6BAA6B,GAAG,OAAC;KACzC,MAAM,CAAC;IACJ,SAAS,EAAE,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,KAAK,CAAC,iCAAyB,EAAE;QAC9B,OAAO,EAAE,0CAA0C;KACtD,CAAC;IACN,UAAU,EAAE,OAAC;SACR,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SAC9D,KAAK,CAAC,kCAA0B,EAAE;QAC/B,OAAO,EAAE,2CAA2C;KACvD,CAAC;IACN,YAAY,EAAE,OAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACjE,QAAQ,EAAE;CAClB,CAAC;KACD,MAAM,EAAE,CAAC"}
+{"version":3,"file":"telegram-channel-metadata.schema.js","sourceRoot":"","sources":["../../../../../v1/tasks/schemas/metadata/telegram-channel-metadata.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,gBAAgB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACU,QAAA,0BAA0B,GACnC,kEAAkE,CAAC;AAEvE;;;GAGG;AACU,QAAA,6BAA6B,GAAG,OAAC;KACzC,MAAM,CAAC;IACJ,SAAS,EAAE,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,KAAK,CAAC,iCAAyB,EAAE;QAC9B,OAAO,EAAE,0CAA0C;KACtD,CAAC;IACN,UAAU,EAAE,OAAC;SACR,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SAC9D,KAAK,CAAC,kCAA0B,EAAE;QAC/B,OAAO,EAAE,2CAA2C;KACvD,CAAC;IACN,YAAY,EAAE,OAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACjE,QAAQ,EAAE;CAClB,CAAC;KACD,MAAM,EAAE,CAAC"}

package/build/v1/tasks/schemas/route-params.schema.d.ts

@@ -1,7 +1,23 @@
 import { z } from 'zod';
+/**
+ * `:taskDefinitionId` path parameter used by user-facing endpoints:
+ *  - `POST /api/v1/tasks/:taskDefinitionId/verify`
+ *  - `POST /api/v1/tasks/:taskDefinitionId/claim`
+ *
+ * Error messages follow the `TaskDefinitionIdParam.<field>.<rule>` key
+ * convention consumed by `getValidationMessage()`.
+ */
 export declare const TaskDefinitionIdParamSchema: z.ZodObject<{
     taskDefinitionId: z.ZodString;
 }, z.core.$strip>;
+/**
+ * `:id` path parameter used by the admin endpoints:
+ *  - `PATCH /api/v1/admin/tasks/:id`
+ *  - `DELETE /api/v1/admin/tasks/:id`
+ *
+ * Error messages follow the `TaskIdParam.<field>.<rule>` key
+ * convention consumed by `getValidationMessage()`.
+ */
 export declare const TaskIdParamSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;

package/build/v1/tasks/schemas/route-params.schema.js

@@ -3,6 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskIdParamSchema = exports.TaskDefinitionIdParamSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
+/**
+ * `:taskDefinitionId` path parameter used by user-facing endpoints:
+ *  - `POST /api/v1/tasks/:taskDefinitionId/verify`
+ *  - `POST /api/v1/tasks/:taskDefinitionId/claim`
+ *
+ * Error messages follow the `TaskDefinitionIdParam.<field>.<rule>` key
+ * convention consumed by `getValidationMessage()`.
+ */
 exports.TaskDefinitionIdParamSchema = zod_1.z.object({
     taskDefinitionId: zod_1.z
         .string({ error: 'TaskDefinitionIdParam.taskDefinitionId.required' })
@@ -10,6 +18,14 @@ exports.TaskDefinitionIdParamSchema = zod_1.z.object({
         message: 'TaskDefinitionIdParam.taskDefinitionId.invalid',
     }),
 });
+/**
+ * `:id` path parameter used by the admin endpoints:
+ *  - `PATCH /api/v1/admin/tasks/:id`
+ *  - `DELETE /api/v1/admin/tasks/:id`
+ *
+ * Error messages follow the `TaskIdParam.<field>.<rule>` key
+ * convention consumed by `getValidationMessage()`.
+ */
 exports.TaskIdParamSchema = zod_1.z.object({
     id: zod_1.z
         .string({ error: 'TaskIdParam.id.required' })

package/build/v1/tasks/schemas/route-params.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-params.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/route-params.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAUhC,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,gBAAgB,EAAE,OAAC;SACd,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;SACpE,KAAK,CAAC,mBAAU,EAAE;QACf,OAAO,EAAE,gDAAgD;KAC5D,CAAC;CACT,CAAC,CAAC;AAUU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,OAAC;SACA,MAAM,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;SAC5C,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;CAChE,CAAC,CAAC"}
+{"version":3,"file":"route-params.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/route-params.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAE7C;;;;;;;GAOG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,gBAAgB,EAAE,OAAC;SACd,MAAM,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;SACpE,KAAK,CAAC,mBAAU,EAAE;QACf,OAAO,EAAE,gDAAgD;KAC5D,CAAC;CACT,CAAC,CAAC;AAEH;;;;;;;GAOG;AACU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,OAAC;SACA,MAAM,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;SAC5C,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;CAChE,CAAC,CAAC"}

package/build/v1/tasks/schemas/task-audience.enum.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Audience segment a task is shown to. Computed from the user's auth
+ * state at request time:
+ * - `UNREGISTERED` — anonymous visitor (no userId)
+ * - `REGISTERED`   — authenticated user whose `status !== 'active'`
+ *                    (email not verified)
+ * - `VERIFIED`     — authenticated user with `status === 'active'`
+ */
 export declare enum TaskAudience {
     UNREGISTERED = "UNREGISTERED",
     REGISTERED = "REGISTERED",

package/build/v1/tasks/schemas/task-audience.enum.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskAudience = void 0;
+/**
+ * Audience segment a task is shown to. Computed from the user's auth
+ * state at request time:
+ * - `UNREGISTERED` — anonymous visitor (no userId)
+ * - `REGISTERED`   — authenticated user whose `status !== 'active'`
+ *                    (email not verified)
+ * - `VERIFIED`     — authenticated user with `status === 'active'`
+ */
 var TaskAudience;
 (function (TaskAudience) {
     TaskAudience["UNREGISTERED"] = "UNREGISTERED";

package/build/v1/tasks/schemas/task-audience.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-audience.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-audience.enum.ts"],"names":[],"mappings":";;;AAQA,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,6CAA6B,CAAA;IAC7B,yCAAyB,CAAA;IACzB,qCAAqB,CAAA;AACzB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}
+{"version":3,"file":"task-audience.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-audience.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,6CAA6B,CAAA;IAC7B,yCAAyB,CAAA;IACzB,qCAAqB,CAAA;AACzB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}

package/build/v1/tasks/schemas/task-audience.schema.js

@@ -3,6 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskVisibleForSchema = void 0;
 const zod_1 = require("zod");
 const task_audience_enum_1 = require("./task-audience.enum");
+/**
+ * Which audience segments the task is shown to. A task is omitted from
+ * the list entirely when the requesting user's segment is not in this
+ * array. At least one audience must be present.
+ */
+/**
+ * Upper bound equals the cardinality of `TaskAudience` — any longer
+ * array is necessarily a duplicate or malformed payload. Explicit
+ * `.max()` rejects it BEFORE the `.refine()` Set allocation, guarding
+ * against memory-exhaustion DoS via crafted admin requests.
+ */
 const TASK_AUDIENCE_CARDINALITY = 3;
 exports.TaskVisibleForSchema = zod_1.z
     .array(zod_1.z.enum(task_audience_enum_1.TaskAudience))

package/build/v1/tasks/schemas/task-audience.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-audience.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-audience.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAoD;AAapD,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAEvB,QAAA,oBAAoB,GAAG,OAAC;KAChC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,iCAAY,CAAC,CAAC;KAC3B,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,yBAAyB,CAAC;KAC9B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,2BAA2B;CACvC,CAAC,CAAC"}
+{"version":3,"file":"task-audience.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-audience.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAoD;AAEpD;;;;GAIG;AACH;;;;;GAKG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAEvB,QAAA,oBAAoB,GAAG,OAAC;KAChC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,iCAAY,CAAC,CAAC;KAC3B,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,yBAAyB,CAAC;KAC9B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,2BAA2B;CACvC,CAAC,CAAC"}

package/build/v1/tasks/schemas/task-code.constants.d.ts

@@ -1,2 +1,24 @@
+/**
+ * Task codes that back **multiple** task definitions rather than a single
+ * singleton row.
+ *
+ * Most task codes are singletons — there is exactly one `REGISTER`,
+ * `LINK_TELEGRAM`, etc. `SUBSCRIBE_TELEGRAM_CHANNEL` is different: one task
+ * definition exists *per channel*, all sharing the same code, distinguished
+ * by `metadata.channelId`. The verifier is channel-agnostic (it reads the
+ * channel from metadata), so a single code drives every channel task.
+ *
+ * Consequences enforced by consumers:
+ *  - the `task_code` uniqueness guard is skipped for these codes (admins may
+ *    create many channel tasks with the same code);
+ *  - `findByTaskCode` is only ever used for singleton codes.
+ *
+ * Exposed as `ReadonlySet<string>` so callers can test arbitrary strings
+ * (e.g. an admin-supplied `taskCode`) without a type assertion.
+ */
 export declare const MULTI_INSTANCE_TASK_CODES: ReadonlySet<string>;
+/**
+ * Returns true when the given task code backs multiple task definitions
+ * (see {@link MULTI_INSTANCE_TASK_CODES}).
+ */
 export declare function isMultiInstanceTaskCode(taskCode: string): boolean;

package/build/v1/tasks/schemas/task-code.constants.js

@@ -3,9 +3,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MULTI_INSTANCE_TASK_CODES = void 0;
 exports.isMultiInstanceTaskCode = isMultiInstanceTaskCode;
 const task_code_enum_1 = require("./task-code.enum");
+/**
+ * Task codes that back **multiple** task definitions rather than a single
+ * singleton row.
+ *
+ * Most task codes are singletons — there is exactly one `REGISTER`,
+ * `LINK_TELEGRAM`, etc. `SUBSCRIBE_TELEGRAM_CHANNEL` is different: one task
+ * definition exists *per channel*, all sharing the same code, distinguished
+ * by `metadata.channelId`. The verifier is channel-agnostic (it reads the
+ * channel from metadata), so a single code drives every channel task.
+ *
+ * Consequences enforced by consumers:
+ *  - the `task_code` uniqueness guard is skipped for these codes (admins may
+ *    create many channel tasks with the same code);
+ *  - `findByTaskCode` is only ever used for singleton codes.
+ *
+ * Exposed as `ReadonlySet<string>` so callers can test arbitrary strings
+ * (e.g. an admin-supplied `taskCode`) without a type assertion.
+ */
 exports.MULTI_INSTANCE_TASK_CODES = new Set([
     task_code_enum_1.TaskCode.SUBSCRIBE_TELEGRAM_CHANNEL,
 ]);
+/**
+ * Returns true when the given task code backs multiple task definitions
+ * (see {@link MULTI_INSTANCE_TASK_CODES}).
+ */
 function isMultiInstanceTaskCode(taskCode) {
     return exports.MULTI_INSTANCE_TASK_CODES.has(taskCode);
 }

package/build/v1/tasks/schemas/task-code.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-code.constants.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-code.constants.ts"],"names":[],"mappings":";;;AA4BA,0DAEC;AA9BD,qDAA4C;AAoB/B,QAAA,yBAAyB,GAAwB,IAAI,GAAG,CAAS;IAC1E,yBAAQ,CAAC,0BAA0B;CACtC,CAAC,CAAC;AAMH,SAAgB,uBAAuB,CAAC,QAAgB;IACpD,OAAO,iCAAyB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"task-code.constants.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-code.constants.ts"],"names":[],"mappings":";;;AA4BA,0DAEC;AA9BD,qDAA4C;AAE5C;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,yBAAyB,GAAwB,IAAI,GAAG,CAAS;IAC1E,yBAAQ,CAAC,0BAA0B;CACtC,CAAC,CAAC;AAEH;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,QAAgB;IACpD,OAAO,iCAAyB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC"}

package/build/v1/tasks/schemas/task-code.enum.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Built-in task identifiers used by internal verifiers in the
+ * `TaskVerifierRegistry`. Custom (admin-created) task definitions may use
+ * `taskCode = null` and rely on `EXTERNAL_LINK` / `MANUAL` flows instead.
+ */
 export declare enum TaskCode {
     REGISTER = "REGISTER",
     COMPLETE_REGISTRATION = "COMPLETE_REGISTRATION",

package/build/v1/tasks/schemas/task-code.enum.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskCode = void 0;
+/**
+ * Built-in task identifiers used by internal verifiers in the
+ * `TaskVerifierRegistry`. Custom (admin-created) task definitions may use
+ * `taskCode = null` and rely on `EXTERNAL_LINK` / `MANUAL` flows instead.
+ */
 var TaskCode;
 (function (TaskCode) {
     TaskCode["REGISTER"] = "REGISTER";

package/build/v1/tasks/schemas/task-code.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-code.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-code.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,QAOX;AAPD,WAAY,QAAQ;IAChB,iCAAqB,CAAA;IACrB,2DAA+C,CAAA;IAC/C,2CAA+B,CAAA;IAC/B,+BAAmB,CAAA;IACnB,uCAA2B,CAAA;IAC3B,qEAAyD,CAAA;AAC7D,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB"}
+{"version":3,"file":"task-code.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,QAOX;AAPD,WAAY,QAAQ;IAChB,iCAAqB,CAAA;IACrB,2DAA+C,CAAA;IAC/C,2CAA+B,CAAA;IAC/B,+BAAmB,CAAA;IACnB,uCAA2B,CAAA;IAC3B,qEAAyD,CAAA;AAC7D,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB"}

package/build/v1/tasks/schemas/task-definition-status.enum.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Lifecycle state of a TaskDefinition (admin-managed).
+ *
+ * - `ACTIVE`    — visible and actionable per its `visibility` rules
+ * - `INACTIVE`  — soft-deleted; existing UserTask records are preserved
+ * - `DRAFT`     — created but not yet activated; not returned to users
+ */
 export declare enum TaskDefinitionStatus {
     ACTIVE = "ACTIVE",
     INACTIVE = "INACTIVE",

package/build/v1/tasks/schemas/task-definition-status.enum.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskDefinitionStatus = void 0;
+/**
+ * Lifecycle state of a TaskDefinition (admin-managed).
+ *
+ * - `ACTIVE`    — visible and actionable per its `visibility` rules
+ * - `INACTIVE`  — soft-deleted; existing UserTask records are preserved
+ * - `DRAFT`     — created but not yet activated; not returned to users
+ */
 var TaskDefinitionStatus;
 (function (TaskDefinitionStatus) {
     TaskDefinitionStatus["ACTIVE"] = "ACTIVE";

package/build/v1/tasks/schemas/task-definition-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-definition-status.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-definition-status.enum.ts"],"names":[],"mappings":";;;AAOA,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC5B,yCAAiB,CAAA;IACjB,6CAAqB,CAAA;IACrB,uCAAe,CAAA;AACnB,CAAC,EAJW,oBAAoB,oCAApB,oBAAoB,QAI/B"}
+{"version":3,"file":"task-definition-status.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-definition-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC5B,yCAAiB,CAAA;IACjB,6CAAqB,CAAA;IACrB,uCAAe,CAAA;AACnB,CAAC,EAJW,oBAAoB,oCAApB,oBAAoB,QAI/B"}

package/build/v1/tasks/schemas/task-requirement.enum.d.ts

@@ -1,3 +1,9 @@
+/**
+ * A prerequisite that must be satisfied before a task can be verified
+ * and claimed. Evaluated at request time by `TaskRequirementChecker`.
+ * Order in the `requirements` array matters: the first unmet
+ * requirement drives the `lockMessage` and the verify error code.
+ */
 export declare enum TaskRequirement {
     USER_REGISTERED = "USER_REGISTERED",
     USER_VERIFIED = "USER_VERIFIED",

package/build/v1/tasks/schemas/task-requirement.enum.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskRequirement = void 0;
+/**
+ * A prerequisite that must be satisfied before a task can be verified
+ * and claimed. Evaluated at request time by `TaskRequirementChecker`.
+ * Order in the `requirements` array matters: the first unmet
+ * requirement drives the `lockMessage` and the verify error code.
+ */
 var TaskRequirement;
 (function (TaskRequirement) {
     TaskRequirement["USER_REGISTERED"] = "USER_REGISTERED";

package/build/v1/tasks/schemas/task-requirement.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-requirement.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-requirement.enum.ts"],"names":[],"mappings":";;;AAMA,IAAY,eAMX;AAND,WAAY,eAAe;IACvB,sDAAmC,CAAA;IACnC,kDAA+B,CAAA;IAC/B,sDAAmC,CAAA;IACnC,0CAAuB,CAAA;IACvB,kDAA+B,CAAA;AACnC,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B"}
+{"version":3,"file":"task-requirement.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-requirement.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,eAMX;AAND,WAAY,eAAe;IACvB,sDAAmC,CAAA;IACnC,kDAA+B,CAAA;IAC/B,sDAAmC,CAAA;IACnC,0CAAuB,CAAA;IACvB,kDAA+B,CAAA;AACnC,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B"}