heartraite 1.0.194 → 1.0.195

package/dist/types/dq.types.d.ts

@@ -109,6 +109,24 @@ export interface GetQuestionResponse {
     quotaResetsAt?: string;
     /** Number of questions remaining for today */
     questionsRemainingToday: number;
+    /**
+     * True when the user has answered every question currently in the
+     * DQ pool. Distinct from `quotaExhausted` (the daily 3/day cap):
+     *
+     *   - `quotaExhausted: true`           → user used today's 3 — come back tomorrow.
+     *   - `allQuestionsCompleted: true`    → user has cleared the entire pool;
+     *                                        no more questions exist until new ones
+     *                                        are added. Tomorrow's quota reset won't
+     *                                        bring new questions.
+     *
+     * Optional for backward compatibility — older clients that don't
+     * read this field will continue inferring "no question available"
+     * from `question: null && !quotaExhausted`, but they'll show the
+     * generic "come back tomorrow" message which is misleading in this
+     * state. New clients should render a dedicated "all caught up"
+     * surface when this is `true`.
+     */
+    allQuestionsCompleted?: boolean;
     /** User's discovery progress (streaks, counts) */
     progress?: DiscoveryProgress;
 }

package/dist/utils/date/age.util.js

@@ -4,9 +4,9 @@ exports.calculateAgeFromDateString = calculateAgeFromDateString;
 function calculateAgeFromDateString(isoDateString) {
     const birthDate = new Date(isoDateString);
     const today = new Date();
-    const ageDiff = today.getFullYear() - birthDate.getFullYear();
-    const hasBirthdayPassed = today.getMonth() > birthDate.getMonth() ||
-        (today.getMonth() === birthDate.getMonth() &&
-            today.getDate() >= birthDate.getDate());
+    const ageDiff = today.getUTCFullYear() - birthDate.getUTCFullYear();
+    const hasBirthdayPassed = today.getUTCMonth() > birthDate.getUTCMonth() ||
+        (today.getUTCMonth() === birthDate.getUTCMonth() &&
+            today.getUTCDate() >= birthDate.getUTCDate());
     return hasBirthdayPassed ? ageDiff : ageDiff - 1;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heartraite",
-  "version": "1.0.194",
+  "version": "1.0.195",
   "description": "Heartraite npm package for common functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/types/dq.types.ts

@@ -149,6 +149,25 @@ export interface GetQuestionResponse {
   /** Number of questions remaining for today */
   questionsRemainingToday: number;
 
+  /**
+   * True when the user has answered every question currently in the
+   * DQ pool. Distinct from `quotaExhausted` (the daily 3/day cap):
+   *
+   *   - `quotaExhausted: true`           → user used today's 3 — come back tomorrow.
+   *   - `allQuestionsCompleted: true`    → user has cleared the entire pool;
+   *                                        no more questions exist until new ones
+   *                                        are added. Tomorrow's quota reset won't
+   *                                        bring new questions.
+   *
+   * Optional for backward compatibility — older clients that don't
+   * read this field will continue inferring "no question available"
+   * from `question: null && !quotaExhausted`, but they'll show the
+   * generic "come back tomorrow" message which is misleading in this
+   * state. New clients should render a dedicated "all caught up"
+   * surface when this is `true`.
+   */
+  allQuestionsCompleted?: boolean;
+
   /** User's discovery progress (streaks, counts) */
   progress?: DiscoveryProgress;
 }

package/src/utils/date/age.util.ts

@@ -2,11 +2,11 @@ export function calculateAgeFromDateString(isoDateString: string): number {
   const birthDate = new Date(isoDateString);
   const today = new Date();
 
-  const ageDiff = today.getFullYear() - birthDate.getFullYear();
+  const ageDiff = today.getUTCFullYear() - birthDate.getUTCFullYear();
   const hasBirthdayPassed =
-    today.getMonth() > birthDate.getMonth() ||
-    (today.getMonth() === birthDate.getMonth() &&
-      today.getDate() >= birthDate.getDate());
+    today.getUTCMonth() > birthDate.getUTCMonth() ||
+    (today.getUTCMonth() === birthDate.getUTCMonth() &&
+      today.getUTCDate() >= birthDate.getUTCDate());
 
   return hasBirthdayPassed ? ageDiff : ageDiff - 1;
 }