heartraite 1.0.230 → 1.0.232

package/dist/enum/dq.enum.d.ts

@@ -0,0 +1,20 @@
+export declare enum DQPursuitPhase {
+    FIRST_READING = "first_reading",
+    FULL = "full"
+}
+export declare enum DQPursuitPausedReason {
+    BANK = "bank",
+    COMPLETE = "complete",
+    USER = "user"
+}
+export declare enum DQReflectionKind {
+    LEARNING = "learning",
+    DIRECTION = "direction",
+    NONE = "none"
+}
+export declare enum DQSetPursuitOutcome {
+    STARTED = "started",
+    CLEARED = "cleared",
+    NOT_ALLOWED = "not_allowed",
+    DISABLED = "disabled"
+}

package/dist/enum/dq.enum.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DQSetPursuitOutcome = exports.DQReflectionKind = exports.DQPursuitPausedReason = exports.DQPursuitPhase = void 0;
+var DQPursuitPhase;
+(function (DQPursuitPhase) {
+    DQPursuitPhase["FIRST_READING"] = "first_reading";
+    DQPursuitPhase["FULL"] = "full";
+})(DQPursuitPhase || (exports.DQPursuitPhase = DQPursuitPhase = {}));
+var DQPursuitPausedReason;
+(function (DQPursuitPausedReason) {
+    DQPursuitPausedReason["BANK"] = "bank";
+    DQPursuitPausedReason["COMPLETE"] = "complete";
+    DQPursuitPausedReason["USER"] = "user";
+})(DQPursuitPausedReason || (exports.DQPursuitPausedReason = DQPursuitPausedReason = {}));
+var DQReflectionKind;
+(function (DQReflectionKind) {
+    DQReflectionKind["LEARNING"] = "learning";
+    DQReflectionKind["DIRECTION"] = "direction";
+    DQReflectionKind["NONE"] = "none";
+})(DQReflectionKind || (exports.DQReflectionKind = DQReflectionKind = {}));
+var DQSetPursuitOutcome;
+(function (DQSetPursuitOutcome) {
+    DQSetPursuitOutcome["STARTED"] = "started";
+    DQSetPursuitOutcome["CLEARED"] = "cleared";
+    DQSetPursuitOutcome["NOT_ALLOWED"] = "not_allowed";
+    DQSetPursuitOutcome["DISABLED"] = "disabled";
+})(DQSetPursuitOutcome || (exports.DQSetPursuitOutcome = DQSetPursuitOutcome = {}));

package/dist/enum/index.d.ts

@@ -3,6 +3,7 @@ export * from "./ca.enum";
 export * from "./cloudfunction.enum";
 export * from "./consultation.enum";
 export * from "./country.enum";
+export * from "./dq.enum";
 export * from "./evaluation.enum";
 export * from "./environment.enum";
 export * from "./error.enum";

package/dist/enum/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./ca.enum"), exports);
 __exportStar(require("./cloudfunction.enum"), exports);
 __exportStar(require("./consultation.enum"), exports);
 __exportStar(require("./country.enum"), exports);
+__exportStar(require("./dq.enum"), exports);
 __exportStar(require("./evaluation.enum"), exports);
 __exportStar(require("./environment.enum"), exports);
 __exportStar(require("./error.enum"), exports);

package/dist/enum/sa.enum.d.ts

@@ -5,3 +5,58 @@ export declare enum SACategoryID {
     LOVE_LANGUAGE = "self_awareness_love_language",
     VALUES = "self_awareness_values"
 }
+export declare enum SASectionPart {
+    INSIGHT = "insight",
+    REFLECTION = "reflection",
+    TIPS = "tips",
+    CHAPTER = "chapter"
+}
+export declare enum SAEvidenceBand {
+    FEW = "few",
+    FAIRLY_CLEAR = "fairly_clear",
+    CLEAR = "clear"
+}
+export declare enum SAChapterId {
+    A = "self_awareness_chapter_a",
+    C = "self_awareness_chapter_c",
+    I = "self_awareness_chapter_i",
+    R = "self_awareness_chapter_r",
+    E = "self_awareness_chapter_e",
+    G = "self_awareness_chapter_g"
+}
+export declare enum SAItemKind {
+    CATEGORY = "category",
+    CHAPTER = "chapter",
+    LETTER = "letter"
+}
+export declare enum SAItemAccess {
+    FULL = "full",
+    DESCRIBED = "described"
+}
+export declare enum SAAccessState {
+    MEMBER = "member",
+    LEGACY = "legacy",
+    LAPSED = "lapsed",
+    FREE = "free"
+}
+export declare enum SAEntitlementGrant {
+    FREE = "free",
+    MEMBER = "member",
+    LEGACY = "legacy",
+    PAYONCE = "payonce",
+    GRANT = "grant"
+}
+export declare enum SAChapterStage {
+    FIRST_READING = "first_reading",
+    FULL = "full"
+}
+export declare enum SAClaimValence {
+    NEUTRAL = "neutral",
+    STRENGTH = "strength",
+    COST = "cost"
+}
+export declare enum SAClaimFeedbackValue {
+    YES = "yes",
+    PARTIAL = "partial",
+    NO = "no"
+}

package/dist/enum/sa.enum.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SACategoryID = void 0;
+exports.SAClaimFeedbackValue = exports.SAClaimValence = exports.SAChapterStage = exports.SAEntitlementGrant = exports.SAAccessState = exports.SAItemAccess = exports.SAItemKind = exports.SAChapterId = exports.SAEvidenceBand = exports.SASectionPart = exports.SACategoryID = void 0;
 var SACategoryID;
 (function (SACategoryID) {
     SACategoryID["PERSONALITY"] = "self_awareness_personality";
@@ -9,3 +9,68 @@ var SACategoryID;
     SACategoryID["LOVE_LANGUAGE"] = "self_awareness_love_language";
     SACategoryID["VALUES"] = "self_awareness_values";
 })(SACategoryID || (exports.SACategoryID = SACategoryID = {}));
+var SASectionPart;
+(function (SASectionPart) {
+    SASectionPart["INSIGHT"] = "insight";
+    SASectionPart["REFLECTION"] = "reflection";
+    SASectionPart["TIPS"] = "tips";
+    SASectionPart["CHAPTER"] = "chapter";
+})(SASectionPart || (exports.SASectionPart = SASectionPart = {}));
+var SAEvidenceBand;
+(function (SAEvidenceBand) {
+    SAEvidenceBand["FEW"] = "few";
+    SAEvidenceBand["FAIRLY_CLEAR"] = "fairly_clear";
+    SAEvidenceBand["CLEAR"] = "clear";
+})(SAEvidenceBand || (exports.SAEvidenceBand = SAEvidenceBand = {}));
+var SAChapterId;
+(function (SAChapterId) {
+    SAChapterId["A"] = "self_awareness_chapter_a";
+    SAChapterId["C"] = "self_awareness_chapter_c";
+    SAChapterId["I"] = "self_awareness_chapter_i";
+    SAChapterId["R"] = "self_awareness_chapter_r";
+    SAChapterId["E"] = "self_awareness_chapter_e";
+    SAChapterId["G"] = "self_awareness_chapter_g";
+})(SAChapterId || (exports.SAChapterId = SAChapterId = {}));
+var SAItemKind;
+(function (SAItemKind) {
+    SAItemKind["CATEGORY"] = "category";
+    SAItemKind["CHAPTER"] = "chapter";
+    SAItemKind["LETTER"] = "letter";
+})(SAItemKind || (exports.SAItemKind = SAItemKind = {}));
+var SAItemAccess;
+(function (SAItemAccess) {
+    SAItemAccess["FULL"] = "full";
+    SAItemAccess["DESCRIBED"] = "described";
+})(SAItemAccess || (exports.SAItemAccess = SAItemAccess = {}));
+var SAAccessState;
+(function (SAAccessState) {
+    SAAccessState["MEMBER"] = "member";
+    SAAccessState["LEGACY"] = "legacy";
+    SAAccessState["LAPSED"] = "lapsed";
+    SAAccessState["FREE"] = "free";
+})(SAAccessState || (exports.SAAccessState = SAAccessState = {}));
+var SAEntitlementGrant;
+(function (SAEntitlementGrant) {
+    SAEntitlementGrant["FREE"] = "free";
+    SAEntitlementGrant["MEMBER"] = "member";
+    SAEntitlementGrant["LEGACY"] = "legacy";
+    SAEntitlementGrant["PAYONCE"] = "payonce";
+    SAEntitlementGrant["GRANT"] = "grant";
+})(SAEntitlementGrant || (exports.SAEntitlementGrant = SAEntitlementGrant = {}));
+var SAChapterStage;
+(function (SAChapterStage) {
+    SAChapterStage["FIRST_READING"] = "first_reading";
+    SAChapterStage["FULL"] = "full";
+})(SAChapterStage || (exports.SAChapterStage = SAChapterStage = {}));
+var SAClaimValence;
+(function (SAClaimValence) {
+    SAClaimValence["NEUTRAL"] = "neutral";
+    SAClaimValence["STRENGTH"] = "strength";
+    SAClaimValence["COST"] = "cost";
+})(SAClaimValence || (exports.SAClaimValence = SAClaimValence = {}));
+var SAClaimFeedbackValue;
+(function (SAClaimFeedbackValue) {
+    SAClaimFeedbackValue["YES"] = "yes";
+    SAClaimFeedbackValue["PARTIAL"] = "partial";
+    SAClaimFeedbackValue["NO"] = "no";
+})(SAClaimFeedbackValue || (exports.SAClaimFeedbackValue = SAClaimFeedbackValue = {}));

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

@@ -5,6 +5,9 @@
  * Internal backend details (psychometrics, scoring, etc.) belong in backend only.
  */
 import { Locale } from "../enum/localization.enum";
+import { DQPursuitPausedReason, DQPursuitPhase, DQReflectionKind, DQSetPursuitOutcome } from "../enum/dq.enum";
+import { SAChapterId, SAChapterStage } from "../enum/sa.enum";
+import type { SAReadiness } from "./sa.types";
 /**
  * DQ locale codes for question content
  * Currently supports Swedish and Danish
@@ -129,4 +132,40 @@ export interface GetQuestionResponse {
     allQuestionsCompleted?: boolean;
     /** User's discovery progress (streaks, counts) */
     progress?: DiscoveryProgress;
+    pursuit?: DQPursuit;
+}
+export interface DQPursuit {
+    chapterId: SAChapterId;
+    phase: DQPursuitPhase;
+    startedAt: string;
+    pausedReason?: DQPursuitPausedReason;
+    readiness?: SAReadiness;
+}
+export interface DQReflection {
+    kind: DQReflectionKind;
+    text: string;
+    traitId?: string;
+    traitName?: string;
+    answersOnTrait?: number;
+}
+export interface DQChapterEvent {
+    chapterId: SAChapterId;
+    stage: SAChapterStage;
+}
+export interface DQSubmitAnswerResponse {
+    answerId: string;
+    nextQuestion: DQQuestion | null;
+    progress: DiscoveryProgress;
+    quotaExhausted: boolean;
+    quotaResetsAt?: string;
+    pursuit?: DQPursuit;
+    reflection?: DQReflection;
+    chapterEvent?: DQChapterEvent;
+}
+export interface DQSetPursuitRequest {
+    chapterId: SAChapterId | null;
+}
+export interface DQSetPursuitResponse {
+    outcome: DQSetPursuitOutcome;
+    pursuit: DQPursuit | null;
 }

package/dist/types/sa.types.d.ts

@@ -1,4 +1,6 @@
+import { LoveLanguageTrait, PersonalityTrait, SAAccessState, SACategoryID, SAChapterId, SAChapterStage, SAClaimFeedbackValue, SAClaimValence, SAEntitlementGrant, SAEvidenceBand, SAItemAccess, SAItemKind } from "../enum";
 import { LoveLanguages, Personality } from "./ca.types";
+import type { DQPursuit } from "./dq.types";
 export type SelfAwareness = {
     userId: string;
     categories: SACategory[];
@@ -6,6 +8,8 @@ export type SelfAwareness = {
     personality: Personality;
     loveLanguages: LoveLanguages;
     processing?: boolean;
+    readState?: SAReadState;
+    evidence?: SAEvidence;
 };
 export type SACategory = {
     id: string;
@@ -17,3 +21,128 @@ export type SACategorySection = {
     reflection: string;
     tip: string;
 };
+export type SASectionReadState = {
+    insight?: string;
+    reflection?: string;
+    tips?: string;
+    chapter?: string;
+};
+export type SACategoryReadState = {
+    sections: Record<string, SASectionReadState>;
+};
+export type SAReadState = {
+    firstOpenedAt?: string;
+    categories: Record<string, SACategoryReadState>;
+};
+export type SAEvidenceItem = {
+    answers: number;
+    band: SAEvidenceBand;
+};
+export type SAPersonalityEvidence = Record<PersonalityTrait, SAEvidenceItem>;
+export type SALoveLanguageEvidence = Record<LoveLanguageTrait, SAEvidenceItem>;
+export type SAEvidence = {
+    personality: SAPersonalityEvidence;
+    loveLanguages?: SALoveLanguageEvidence;
+};
+export type SALetterItemId = `self_awareness_letter_${string}`;
+export type SAItemId = SACategoryID | SAChapterId | SALetterItemId;
+export type SATraitRef = {
+    traitId: string;
+    name: string;
+};
+export type SAReadiness = {
+    traitsAt3: number;
+    traitsAt4: number;
+    traitsTotal: number;
+    firstReadingReady: boolean;
+    fullReady: boolean;
+    writtenParagraphs: number;
+    nextTrait?: SATraitRef;
+    answersToNextParagraph?: number;
+};
+export type SAChapterBadge = {
+    answers: number;
+    traitsAt3: number;
+    traitsTotal: number;
+};
+export type SAClaimFeedback = {
+    value: SAClaimFeedbackValue;
+    note?: string;
+    at: string;
+};
+export type SAClaim = {
+    id: string;
+    text: string;
+    basis: string[];
+    band: SAEvidenceBand;
+    valence: SAClaimValence;
+    feedback?: SAClaimFeedback;
+    rewrittenAt?: string;
+    retired?: boolean;
+};
+export type SAChapterGap = {
+    text: string;
+    traitId: string;
+    answersToClose: number;
+};
+export type SAChapter = {
+    chapterId: SAChapterId;
+    version: number;
+    stage: SAChapterStage;
+    generatedAt: string;
+    badge: SAChapterBadge;
+    framingId: string;
+    framing?: string;
+    claims: SAClaim[];
+    gap?: SAChapterGap;
+    reflection: string;
+    practice: string;
+    art9OptIn: boolean;
+    refreshedAt?: string;
+};
+export type SAChapters = Partial<Record<SAChapterId, SAChapter>>;
+export type SAEntitlementStamp = {
+    grantedAt: string;
+    grantedUnder: SAEntitlementGrant;
+};
+export type SAEntitlements = Partial<Record<SAItemId, SAEntitlementStamp>>;
+export type SAArt9OptIn = Partial<Record<SAItemId, boolean>>;
+export type SAItem = {
+    itemId: SAItemId;
+    kind: SAItemKind;
+    access: SAItemAccess;
+    title?: string;
+    description?: string;
+    framingId?: string;
+    framing?: string;
+    readiness?: SAReadiness;
+    stage?: SAChapterStage;
+    writing?: boolean;
+    stamped?: boolean;
+    pursuable?: boolean;
+};
+export type SelfAwarenessV2 = SelfAwareness & {
+    accessState: SAAccessState;
+    items: SAItem[];
+    chapters: SAChapters;
+    pursuit?: DQPursuit;
+    freeChapterId?: SAChapterId;
+    freeChapterSwitchUsed?: boolean;
+    art9OptIn?: SAArt9OptIn;
+};
+export type SAClaimFeedbackResponse = {
+    claim: SAClaim;
+};
+export type SASetArt9OptInResponse = {
+    art9OptIn: SAArt9OptIn;
+};
+export type SAClaimFeedbackRequest = {
+    chapterId: SAChapterId;
+    claimId: string;
+    value: SAClaimFeedbackValue;
+    note?: string;
+};
+export type SASetArt9OptInRequest = {
+    chapterId: SAChapterId;
+    optIn: boolean;
+};

package/package.json

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

package/src/enum/dq.enum.ts

@@ -0,0 +1,23 @@
+export enum DQPursuitPhase {
+  FIRST_READING = "first_reading",
+  FULL = "full",
+}
+
+export enum DQPursuitPausedReason {
+  BANK = "bank",
+  COMPLETE = "complete",
+  USER = "user",
+}
+
+export enum DQReflectionKind {
+  LEARNING = "learning",
+  DIRECTION = "direction",
+  NONE = "none",
+}
+
+export enum DQSetPursuitOutcome {
+  STARTED = "started",
+  CLEARED = "cleared",
+  NOT_ALLOWED = "not_allowed",
+  DISABLED = "disabled",
+}

package/src/enum/index.ts

@@ -3,6 +3,7 @@ export * from "./ca.enum";
 export * from "./cloudfunction.enum";
 export * from "./consultation.enum";
 export * from "./country.enum";
+export * from "./dq.enum";
 export * from "./evaluation.enum";
 export * from "./environment.enum";
 export * from "./error.enum";

package/src/enum/sa.enum.ts

@@ -5,3 +5,68 @@ export enum SACategoryID {
   LOVE_LANGUAGE = "self_awareness_love_language",
   VALUES = "self_awareness_values",
 }
+
+export enum SASectionPart {
+  INSIGHT = "insight",
+  REFLECTION = "reflection",
+  TIPS = "tips",
+  CHAPTER = "chapter",
+}
+
+export enum SAEvidenceBand {
+  FEW = "few",
+  FAIRLY_CLEAR = "fairly_clear",
+  CLEAR = "clear",
+}
+
+export enum SAChapterId {
+  A = "self_awareness_chapter_a",
+  C = "self_awareness_chapter_c",
+  I = "self_awareness_chapter_i",
+  R = "self_awareness_chapter_r",
+  E = "self_awareness_chapter_e",
+  G = "self_awareness_chapter_g",
+}
+
+export enum SAItemKind {
+  CATEGORY = "category",
+  CHAPTER = "chapter",
+  LETTER = "letter",
+}
+
+export enum SAItemAccess {
+  FULL = "full",
+  DESCRIBED = "described",
+}
+
+export enum SAAccessState {
+  MEMBER = "member",
+  LEGACY = "legacy",
+  LAPSED = "lapsed",
+  FREE = "free",
+}
+
+export enum SAEntitlementGrant {
+  FREE = "free",
+  MEMBER = "member",
+  LEGACY = "legacy",
+  PAYONCE = "payonce",
+  GRANT = "grant",
+}
+
+export enum SAChapterStage {
+  FIRST_READING = "first_reading",
+  FULL = "full",
+}
+
+export enum SAClaimValence {
+  NEUTRAL = "neutral",
+  STRENGTH = "strength",
+  COST = "cost",
+}
+
+export enum SAClaimFeedbackValue {
+  YES = "yes",
+  PARTIAL = "partial",
+  NO = "no",
+}

package/src/types/dq.types.ts

@@ -6,6 +6,14 @@
  */
 
 import { Locale } from "../enum/localization.enum";
+import {
+  DQPursuitPausedReason,
+  DQPursuitPhase,
+  DQReflectionKind,
+  DQSetPursuitOutcome,
+} from "../enum/dq.enum";
+import { SAChapterId, SAChapterStage } from "../enum/sa.enum";
+import type { SAReadiness } from "./sa.types";
 
 // ========== BASIC TYPES ==========
 
@@ -170,4 +178,47 @@ export interface GetQuestionResponse {
 
   /** User's discovery progress (streaks, counts) */
   progress?: DiscoveryProgress;
+
+  pursuit?: DQPursuit;
+}
+
+export interface DQPursuit {
+  chapterId: SAChapterId;
+  phase: DQPursuitPhase;
+  startedAt: string;
+  pausedReason?: DQPursuitPausedReason;
+  readiness?: SAReadiness;
+}
+
+export interface DQReflection {
+  kind: DQReflectionKind;
+  text: string;
+  traitId?: string;
+  traitName?: string;
+  answersOnTrait?: number;
+}
+
+export interface DQChapterEvent {
+  chapterId: SAChapterId;
+  stage: SAChapterStage;
+}
+
+export interface DQSubmitAnswerResponse {
+  answerId: string;
+  nextQuestion: DQQuestion | null;
+  progress: DiscoveryProgress;
+  quotaExhausted: boolean;
+  quotaResetsAt?: string;
+  pursuit?: DQPursuit;
+  reflection?: DQReflection;
+  chapterEvent?: DQChapterEvent;
+}
+
+export interface DQSetPursuitRequest {
+  chapterId: SAChapterId | null;
+}
+
+export interface DQSetPursuitResponse {
+  outcome: DQSetPursuitOutcome;
+  pursuit: DQPursuit | null;
 }

package/src/types/sa.types.ts

@@ -1,4 +1,19 @@
+import {
+  LoveLanguageTrait,
+  PersonalityTrait,
+  SAAccessState,
+  SACategoryID,
+  SAChapterId,
+  SAChapterStage,
+  SAClaimFeedbackValue,
+  SAClaimValence,
+  SAEntitlementGrant,
+  SAEvidenceBand,
+  SAItemAccess,
+  SAItemKind,
+} from "../enum";
 import { LoveLanguages, Personality } from "./ca.types";
+import type { DQPursuit } from "./dq.types";
 
 export type SelfAwareness = {
   userId: string;
@@ -7,6 +22,8 @@ export type SelfAwareness = {
   personality: Personality;
   loveLanguages: LoveLanguages;
   processing?: boolean;
+  readState?: SAReadState;
+  evidence?: SAEvidence;
 };
 
 export type SACategory = {
@@ -20,3 +37,154 @@ export type SACategorySection = {
   reflection: string;
   tip: string;
 };
+
+export type SASectionReadState = {
+  insight?: string;
+  reflection?: string;
+  tips?: string;
+  chapter?: string;
+};
+
+export type SACategoryReadState = {
+  sections: Record<string, SASectionReadState>;
+};
+
+export type SAReadState = {
+  firstOpenedAt?: string;
+  categories: Record<string, SACategoryReadState>;
+};
+
+export type SAEvidenceItem = {
+  answers: number;
+  band: SAEvidenceBand;
+};
+
+export type SAPersonalityEvidence = Record<PersonalityTrait, SAEvidenceItem>;
+
+export type SALoveLanguageEvidence = Record<LoveLanguageTrait, SAEvidenceItem>;
+
+export type SAEvidence = {
+  personality: SAPersonalityEvidence;
+  loveLanguages?: SALoveLanguageEvidence;
+};
+
+export type SALetterItemId = `self_awareness_letter_${string}`;
+
+export type SAItemId = SACategoryID | SAChapterId | SALetterItemId;
+
+export type SATraitRef = {
+  traitId: string;
+  name: string;
+};
+
+export type SAReadiness = {
+  traitsAt3: number;
+  traitsAt4: number;
+  traitsTotal: number;
+  firstReadingReady: boolean;
+  fullReady: boolean;
+  writtenParagraphs: number;
+  nextTrait?: SATraitRef;
+  answersToNextParagraph?: number;
+};
+
+export type SAChapterBadge = {
+  answers: number;
+  traitsAt3: number;
+  traitsTotal: number;
+};
+
+export type SAClaimFeedback = {
+  value: SAClaimFeedbackValue;
+  note?: string;
+  at: string;
+};
+
+export type SAClaim = {
+  id: string;
+  text: string;
+  basis: string[];
+  band: SAEvidenceBand;
+  valence: SAClaimValence;
+  feedback?: SAClaimFeedback;
+  rewrittenAt?: string;
+  retired?: boolean;
+};
+
+export type SAChapterGap = {
+  text: string;
+  traitId: string;
+  answersToClose: number;
+};
+
+export type SAChapter = {
+  chapterId: SAChapterId;
+  version: number;
+  stage: SAChapterStage;
+  generatedAt: string;
+  badge: SAChapterBadge;
+  framingId: string;
+  framing?: string;
+  claims: SAClaim[];
+  gap?: SAChapterGap;
+  reflection: string;
+  practice: string;
+  art9OptIn: boolean;
+  refreshedAt?: string;
+};
+
+export type SAChapters = Partial<Record<SAChapterId, SAChapter>>;
+
+export type SAEntitlementStamp = {
+  grantedAt: string;
+  grantedUnder: SAEntitlementGrant;
+};
+
+export type SAEntitlements = Partial<Record<SAItemId, SAEntitlementStamp>>;
+
+export type SAArt9OptIn = Partial<Record<SAItemId, boolean>>;
+
+export type SAItem = {
+  itemId: SAItemId;
+  kind: SAItemKind;
+  access: SAItemAccess;
+  title?: string;
+  description?: string;
+  framingId?: string;
+  framing?: string;
+  readiness?: SAReadiness;
+  stage?: SAChapterStage;
+  writing?: boolean;
+  stamped?: boolean;
+  pursuable?: boolean;
+};
+
+export type SelfAwarenessV2 = SelfAwareness & {
+  accessState: SAAccessState;
+  items: SAItem[];
+  chapters: SAChapters;
+  pursuit?: DQPursuit;
+  freeChapterId?: SAChapterId;
+  freeChapterSwitchUsed?: boolean;
+  art9OptIn?: SAArt9OptIn;
+};
+
+export type SAClaimFeedbackResponse = {
+  claim: SAClaim;
+};
+
+export type SASetArt9OptInResponse = {
+  art9OptIn: SAArt9OptIn;
+};
+
+export type SAClaimFeedbackRequest = {
+  chapterId: SAChapterId;
+  claimId: string;
+  value: SAClaimFeedbackValue;
+  note?: string;
+};
+
+export type SASetArt9OptInRequest = {
+  chapterId: SAChapterId;
+  optIn: boolean;
+};