@ttt-productions/ttt-core 0.78.10 → 0.78.11

package/dist/schemas/voting.d.ts

@@ -7,4 +7,37 @@ export declare const VoteForAuditionEntryInputSchema: z.ZodObject<{
     currentVoteId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
 export type VoteForAuditionEntryInput = z.infer<typeof VoteForAuditionEntryInputSchema>;
+/**
+ * Authoritative result of voteForAuditionEntry — the committed final vote state the
+ * transaction already knows (it READS both entry docs: the new entry for the
+ * existence/hidden checks, and on a vote switch the old entry for the clamped
+ * decrement — so both committed counts cost no extra read; the like/unlike precedent).
+ *
+ * This callable only CASTS or MOVES a vote — there is no unvote path (the input
+ * requires `newVote.auditionEntryId`; `currentVoteId` is ignored server-side), so
+ * `isVoted` is always true.
+ *
+ * Path semantics:
+ * - First vote: `alreadyVoted: false`, `voteCount` = read count + 1,
+ *   `previousAuditionEntryId: null`, no `previousVoteCount`.
+ * - Vote switch: `alreadyVoted: false`, `voteCount` = read count + 1,
+ *   `previousAuditionEntryId` = the entry the vote moved off; `previousVoteCount` =
+ *   its clamped post-decrement count — ABSENT when that entry no longer exists
+ *   (deleted entries skip the decrement).
+ * - Idempotent no-op (already voting for this entry): `alreadyVoted: true`,
+ *   `voteCount` = the UNCHANGED read count, `previousAuditionEntryId: null`.
+ *
+ * Non-strict (server → client result posture).
+ */
+export declare const VoteForAuditionEntryResultSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    auditionId: z.ZodString;
+    auditionEntryId: z.ZodString;
+    isVoted: z.ZodLiteral<true>;
+    alreadyVoted: z.ZodBoolean;
+    voteCount: z.ZodNumber;
+    previousAuditionEntryId: z.ZodNullable<z.ZodString>;
+    previousVoteCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type VoteForAuditionEntryResult = z.infer<typeof VoteForAuditionEntryResultSchema>;
 //# sourceMappingURL=voting.d.ts.map

package/dist/schemas/voting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voting.d.ts","sourceRoot":"","sources":["../../src/schemas/voting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,+BAA+B;;;;;;kBAOjC,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}
+{"version":3,"file":"voting.d.ts","sourceRoot":"","sources":["../../src/schemas/voting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,+BAA+B;;;;;;kBAOjC,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;iBAgB3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/dist/schemas/voting.js

@@ -8,4 +8,43 @@ export const VoteForAuditionEntryInputSchema = z.object({
     // Accepted for backwards compatibility but ignored server-side; see runtime comment below.
     currentVoteId: z.string().nullable().optional(),
 }).strict();
+/**
+ * Authoritative result of voteForAuditionEntry — the committed final vote state the
+ * transaction already knows (it READS both entry docs: the new entry for the
+ * existence/hidden checks, and on a vote switch the old entry for the clamped
+ * decrement — so both committed counts cost no extra read; the like/unlike precedent).
+ *
+ * This callable only CASTS or MOVES a vote — there is no unvote path (the input
+ * requires `newVote.auditionEntryId`; `currentVoteId` is ignored server-side), so
+ * `isVoted` is always true.
+ *
+ * Path semantics:
+ * - First vote: `alreadyVoted: false`, `voteCount` = read count + 1,
+ *   `previousAuditionEntryId: null`, no `previousVoteCount`.
+ * - Vote switch: `alreadyVoted: false`, `voteCount` = read count + 1,
+ *   `previousAuditionEntryId` = the entry the vote moved off; `previousVoteCount` =
+ *   its clamped post-decrement count — ABSENT when that entry no longer exists
+ *   (deleted entries skip the decrement).
+ * - Idempotent no-op (already voting for this entry): `alreadyVoted: true`,
+ *   `voteCount` = the UNCHANGED read count, `previousAuditionEntryId: null`.
+ *
+ * Non-strict (server → client result posture).
+ */
+export const VoteForAuditionEntryResultSchema = z.object({
+    success: z.literal(true),
+    auditionId: auditionIdSchema,
+    /** The entry the caller's vote now rests on. */
+    auditionEntryId: auditionEntryIdSchema,
+    /** Final caller vote-state — always true; this callable never removes a vote. */
+    isVoted: z.literal(true),
+    /** True when the caller was already voting for this entry (idempotent no-op). */
+    alreadyVoted: z.boolean(),
+    /** Committed vote count of the voted entry. */
+    voteCount: z.number().int().nonnegative(),
+    /** Entry the vote moved OFF on a switch; null on a first vote or idempotent no-op. */
+    previousAuditionEntryId: auditionEntryIdSchema.nullable(),
+    /** Committed post-decrement count of the previous entry — absent when
+     * previousAuditionEntryId is null or that entry was deleted (no decrement applied). */
+    previousVoteCount: z.number().int().nonnegative().optional(),
+});
 //# sourceMappingURL=voting.js.map

package/dist/schemas/voting.js.map

@@ -1 +1 @@
-{"version":3,"file":"voting.js","sourceRoot":"","sources":["../../src/schemas/voting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,UAAU,EAAE,gBAAgB;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,eAAe,EAAE,qBAAqB;KACvC,CAAC,CAAC,MAAM,EAAE;IACX,2FAA2F;IAC3F,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC,MAAM,EAAE,CAAC"}
+{"version":3,"file":"voting.js","sourceRoot":"","sources":["../../src/schemas/voting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,UAAU,EAAE,gBAAgB;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,eAAe,EAAE,qBAAqB;KACvC,CAAC,CAAC,MAAM,EAAE;IACX,2FAA2F;IAC3F,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxB,UAAU,EAAE,gBAAgB;IAC5B,gDAAgD;IAChD,eAAe,EAAE,qBAAqB;IACtC,iFAAiF;IACjF,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxB,iFAAiF;IACjF,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,sFAAsF;IACtF,uBAAuB,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACzD;2FACuF;IACvF,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/ttt-core",
-  "version": "0.78.10",
+  "version": "0.78.11",
   "description": "Core types, Firestore path constants, and shared constants for TTT Productions",
   "repository": {
     "type": "git",