@voxendar/shared 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared domain constants.
+ * NOTE: naming and values are placeholder scope. The real launch-language set,
+ * channel policy, and provider choices are confirmed by Rob in Phase 0
+ * (Implementation_Plan.md Phase 0).
+ */
+/** Candidate launch languages (2–3 to start, per context.md §10). */
+export declare const SUPPORTED_LANGUAGES: readonly ["en-US", "zh-CN", "es-MX"];
+/** Google Calendar color ids "1"–"11" (color-to-member assignment decided in Phase 0). */
+export declare const GOOGLE_CALENDAR_COLOR_IDS: readonly ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11"];
+/** Default per-event reminder offsets in minutes (1 day, 2 hours). */
+export declare const DEFAULT_REMINDER_OFFSETS_MINUTES: readonly [1440, 120];
+/** Scheduled dispatch interval for `dispatchReminders` (minutes). */
+export declare const SCHEDULER_INTERVAL_MINUTES_DEFAULT = 15;
+/** Safety margin added to the reminder query horizon (minutes). */
+export declare const SCHEDULER_HORIZON_MARGIN_MINUTES_DEFAULT = 360;
+/** Firebase collection names. */
+export declare const FIRESTORE_COLLECTIONS: {
+    readonly userProfiles: "userProfiles";
+    readonly userGoogleTokens: "userGoogleTokens";
+    readonly families: "families";
+    readonly members: "members";
+    readonly captures: "captures";
+    readonly sentReminders: "sentReminders";
+};
+/** Firebase Storage path prefixes. */
+export declare const STORAGE_PATHS: {
+    readonly rawAudio: "audio";
+    readonly ttsClips: "tts";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,sCAAuC,CAAC;AAExE,0FAA0F;AAC1F,eAAO,MAAM,yBAAyB,oEAY5B,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,gCAAgC,sBAAuB,CAAC;AAErE,qEAAqE;AACrE,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD,mEAAmE;AACnE,eAAO,MAAM,wCAAwC,MAAM,CAAC;AAE5D,iCAAiC;AACjC,eAAO,MAAM,qBAAqB;;;;;;;CAOxB,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,aAAa;;;CAGhB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Shared domain constants.
+ * NOTE: naming and values are placeholder scope. The real launch-language set,
+ * channel policy, and provider choices are confirmed by Rob in Phase 0
+ * (Implementation_Plan.md Phase 0).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORAGE_PATHS = exports.FIRESTORE_COLLECTIONS = exports.SCHEDULER_HORIZON_MARGIN_MINUTES_DEFAULT = exports.SCHEDULER_INTERVAL_MINUTES_DEFAULT = exports.DEFAULT_REMINDER_OFFSETS_MINUTES = exports.GOOGLE_CALENDAR_COLOR_IDS = exports.SUPPORTED_LANGUAGES = void 0;
+/** Candidate launch languages (2–3 to start, per context.md §10). */
+exports.SUPPORTED_LANGUAGES = ["en-US", "zh-CN", "es-MX"];
+/** Google Calendar color ids "1"–"11" (color-to-member assignment decided in Phase 0). */
+exports.GOOGLE_CALENDAR_COLOR_IDS = [
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7",
+    "8",
+    "9",
+    "10",
+    "11",
+];
+/** Default per-event reminder offsets in minutes (1 day, 2 hours). */
+exports.DEFAULT_REMINDER_OFFSETS_MINUTES = [1440, 120];
+/** Scheduled dispatch interval for `dispatchReminders` (minutes). */
+exports.SCHEDULER_INTERVAL_MINUTES_DEFAULT = 15;
+/** Safety margin added to the reminder query horizon (minutes). */
+exports.SCHEDULER_HORIZON_MARGIN_MINUTES_DEFAULT = 360;
+/** Firebase collection names. */
+exports.FIRESTORE_COLLECTIONS = {
+    userProfiles: "userProfiles",
+    userGoogleTokens: "userGoogleTokens",
+    families: "families",
+    members: "members",
+    captures: "captures",
+    sentReminders: "sentReminders",
+};
+/** Firebase Storage path prefixes. */
+exports.STORAGE_PATHS = {
+    rawAudio: "audio", // audio/{uid}/... — deleted after transcription
+    ttsClips: "tts", // tts/{...} — cacheable spoken confirmations
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qEAAqE;AACxD,QAAA,mBAAmB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAExE,0FAA0F;AAC7E,QAAA,yBAAyB,GAAG;IACvC,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,IAAI;IACJ,IAAI;CACI,CAAC;AAEX,sEAAsE;AACzD,QAAA,gCAAgC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAU,CAAC;AAErE,qEAAqE;AACxD,QAAA,kCAAkC,GAAG,EAAE,CAAC;AAErD,mEAAmE;AACtD,QAAA,wCAAwC,GAAG,GAAG,CAAC;AAE5D,iCAAiC;AACpB,QAAA,qBAAqB,GAAG;IACnC,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,kBAAkB;IACpC,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;CACtB,CAAC;AAEX,sCAAsC;AACzB,QAAA,aAAa,GAAG;IAC3B,QAAQ,EAAE,OAAO,EAAE,gDAAgD;IACnE,QAAQ,EAAE,KAAK,EAAE,6CAA6C;CACtD,CAAC"}

package/dist/i18n/templates.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Reminder message templates (README §5a).
+ * A template library — not free-form LLM copy — keeps SMS segment billing
+ * predictable and copy consistent across channels and languages.
+ */
+export interface ReminderMessageParams {
+    /** Event title. */
+    title: string;
+    /** Human-friendly time phrase already resolved in the recipient's timezone. */
+    when: string;
+    /** Optional location included in the message. */
+    location?: string | null;
+}
+declare const TEMPLATES: {
+    readonly "en-US": (p: ReminderMessageParams) => string;
+    readonly "zh-CN": (p: ReminderMessageParams) => string;
+    readonly "es-MX": (p: ReminderMessageParams) => string;
+};
+export type TemplateKey = keyof typeof TEMPLATES;
+/** Closest template for a BCP-47 tag: exact → base language ("zh" → "zh-CN") → "en-US". */
+export declare function resolveTemplateKey(language: string): TemplateKey;
+/** Build the reminder message text for a member's language. */
+export declare function buildReminderMessage(language: string, params: ReminderMessageParams): string;
+export {};
+//# sourceMappingURL=templates.d.ts.map

package/dist/i18n/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/i18n/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,QAAA,MAAM,SAAS;0BACA,qBAAqB,KAAG,MAAM;0BAI9B,qBAAqB,KAAG,MAAM;0BAI9B,qBAAqB,KAAG,MAAM;CAI4B,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAEjD,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAUhE;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAG5F"}

package/dist/i18n/templates.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Reminder message templates (README §5a).
+ * A template library — not free-form LLM copy — keeps SMS segment billing
+ * predictable and copy consistent across channels and languages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTemplateKey = resolveTemplateKey;
+exports.buildReminderMessage = buildReminderMessage;
+const TEMPLATES = {
+    "en-US": (p) => p.location
+        ? `⏰ Reminder: ${p.title} — ${p.when} (📍 ${p.location})`
+        : `⏰ Reminder: ${p.title} — ${p.when}`,
+    "zh-CN": (p) => p.location
+        ? `⏰ 提醒：${p.title}，${p.when}（📍 ${p.location}）`
+        : `⏰ 提醒：${p.title}，${p.when}`,
+    "es-MX": (p) => p.location
+        ? `⏰ Recordatorio: ${p.title} — ${p.when} (📍 ${p.location})`
+        : `⏰ Recordatorio: ${p.title} — ${p.when}`,
+};
+/** Closest template for a BCP-47 tag: exact → base language ("zh" → "zh-CN") → "en-US". */
+function resolveTemplateKey(language) {
+    if (language in TEMPLATES)
+        return language;
+    const base = language.split("-")[0] ?? "";
+    if (base.length >= 2) {
+        const baseKey = Object.keys(TEMPLATES).find((key) => key.startsWith(`${base}-`));
+        if (baseKey)
+            return baseKey;
+    }
+    return "en-US";
+}
+/** Build the reminder message text for a member's language. */
+function buildReminderMessage(language, params) {
+    const templateKey = resolveTemplateKey(language);
+    return TEMPLATES[templateKey](params);
+}
+//# sourceMappingURL=templates.js.map

package/dist/i18n/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/i18n/templates.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA6BH,gDAUC;AAGD,oDAGC;AAlCD,MAAM,SAAS,GAAG;IAChB,OAAO,EAAE,CAAC,CAAwB,EAAU,EAAE,CAC5C,CAAC,CAAC,QAAQ;QACR,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,QAAQ,GAAG;QACzD,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,CAAC,CAAwB,EAAU,EAAE,CAC5C,CAAC,CAAC,QAAQ;QACR,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,GAAG;QAC/C,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE;IACjC,OAAO,EAAE,CAAC,CAAwB,EAAU,EAAE,CAC5C,CAAC,CAAC,QAAQ;QACR,CAAC,CAAC,mBAAmB,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,QAAQ,GAAG;QAC7D,CAAC,CAAC,mBAAmB,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,EAAE;CACyB,CAAC;AAI1E,2FAA2F;AAC3F,SAAgB,kBAAkB,CAAC,QAAgB;IACjD,IAAI,QAAQ,IAAI,SAAS;QAAE,OAAO,QAAuB,CAAC;IAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,OAAO,GAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACrE,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAC3B,CAAC;QACF,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+DAA+D;AAC/D,SAAgB,oBAAoB,CAAC,QAAgB,EAAE,MAA6B;IAClF,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./constants";
+export * from "./schemas/enums";
+export * from "./schemas/primitives";
+export * from "./schemas/error";
+export * from "./schemas/event";
+export * from "./schemas/circle";
+export * from "./schemas/member";
+export * from "./schemas/capture";
+export * from "./schemas/reminder";
+export * from "./reminders/math";
+export * from "./i18n/templates";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./schemas/enums"), exports);
+__exportStar(require("./schemas/primitives"), exports);
+__exportStar(require("./schemas/error"), exports);
+__exportStar(require("./schemas/event"), exports);
+__exportStar(require("./schemas/circle"), exports);
+__exportStar(require("./schemas/member"), exports);
+__exportStar(require("./schemas/capture"), exports);
+__exportStar(require("./schemas/reminder"), exports);
+__exportStar(require("./reminders/math"), exports);
+__exportStar(require("./i18n/templates"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,kDAAgC;AAChC,uDAAqC;AACrC,kDAAgC;AAChC,kDAAgC;AAChC,mDAAiC;AACjC,mDAAiC;AACjC,oDAAkC;AAClC,qDAAmC;AACnC,mDAAiC;AACjC,mDAAiC"}

package/dist/reminders/math.d.ts

@@ -0,0 +1,17 @@
+import { NOTIFY_CHANNELS } from "../schemas/enums";
+/**
+ * Reminder query horizon (README §5a): the largest offset present + the job
+ * interval + a safety margin, so a 1-day-before reminder at the window's edge
+ * is never missed.
+ */
+export declare function computeReminderQueryHorizonMinutes(offsets?: readonly number[], opts?: {
+    intervalMinutes?: number;
+    marginMinutes?: number;
+}): number;
+/** A reminder for `eventStartMs` with `offsetMinutes` is due once now >= start - offset. */
+export declare function isReminderDue(eventStartMs: number, offsetMinutes: number, nowMs: number): boolean;
+/** Deterministic sentReminders doc id (create-if-absent for idempotency). */
+export declare function reminderIdKey(eventId: string, offsetMinutes: number, channel: (typeof NOTIFY_CHANNELS)[number]): string;
+/** All-day events: the 1-day reminder fires at previous local midnight (UTC math handled by caller). */
+export declare function allDayReminderInstant(dayStartLocalMs: number, offsetMinutes: number): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/reminders/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/reminders/math.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,SAAS,MAAM,EAAqC,EAC7D,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,MAAM,CAOR;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjG;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,GACxC,MAAM,CAER;AAED,wGAAwG;AACxG,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAE5F"}

package/dist/reminders/math.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeReminderQueryHorizonMinutes = computeReminderQueryHorizonMinutes;
+exports.isReminderDue = isReminderDue;
+exports.reminderIdKey = reminderIdKey;
+exports.allDayReminderInstant = allDayReminderInstant;
+const constants_1 = require("../constants");
+/**
+ * Reminder query horizon (README §5a): the largest offset present + the job
+ * interval + a safety margin, so a 1-day-before reminder at the window's edge
+ * is never missed.
+ */
+function computeReminderQueryHorizonMinutes(offsets = constants_1.DEFAULT_REMINDER_OFFSETS_MINUTES, opts = {}) {
+    const { intervalMinutes = 15, marginMinutes = 360 } = opts;
+    if (offsets.length === 0) {
+        throw new Error("at least one reminder offset is required");
+    }
+    const maxOffset = Math.max(...offsets);
+    return maxOffset + intervalMinutes + marginMinutes;
+}
+/** A reminder for `eventStartMs` with `offsetMinutes` is due once now >= start - offset. */
+function isReminderDue(eventStartMs, offsetMinutes, nowMs) {
+    return nowMs >= eventStartMs - offsetMinutes * 60_000;
+}
+/** Deterministic sentReminders doc id (create-if-absent for idempotency). */
+function reminderIdKey(eventId, offsetMinutes, channel) {
+    return `${eventId}_${offsetMinutes}_${channel}`;
+}
+/** All-day events: the 1-day reminder fires at previous local midnight (UTC math handled by caller). */
+function allDayReminderInstant(dayStartLocalMs, offsetMinutes) {
+    return dayStartLocalMs - offsetMinutes * 60_000;
+}
+//# sourceMappingURL=math.js.map

package/dist/reminders/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/reminders/math.ts"],"names":[],"mappings":";;AAQA,gFAUC;AAGD,sCAEC;AAGD,sCAMC;AAGD,sDAEC;AArCD,4CAAgE;AAGhE;;;;GAIG;AACH,SAAgB,kCAAkC,CAChD,UAA6B,4CAAgC,EAC7D,OAA6D,EAAE;IAE/D,MAAM,EAAE,eAAe,GAAG,EAAE,EAAE,aAAa,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IACvC,OAAO,SAAS,GAAG,eAAe,GAAG,aAAa,CAAC;AACrD,CAAC;AAED,4FAA4F;AAC5F,SAAgB,aAAa,CAAC,YAAoB,EAAE,aAAqB,EAAE,KAAa;IACtF,OAAO,KAAK,IAAI,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;AACxD,CAAC;AAED,6EAA6E;AAC7E,SAAgB,aAAa,CAC3B,OAAe,EACf,aAAqB,EACrB,OAAyC;IAEzC,OAAO,GAAG,OAAO,IAAI,aAAa,IAAI,OAAO,EAAE,CAAC;AAClD,CAAC;AAED,wGAAwG;AACxG,SAAgB,qBAAqB,CAAC,eAAuB,EAAE,aAAqB;IAClF,OAAO,eAAe,GAAG,aAAa,GAAG,MAAM,CAAC;AAClD,CAAC"}

package/dist/schemas/capture.d.ts

@@ -0,0 +1,92 @@
+import { z } from "zod";
+/**
+ * `families/{familyId}/captures/{captureId}` — audit/debug log, not user-facing
+ * (README §3). `editedFields` is the accuracy telemetry behind the
+ * confirmation-fatigue risk (README §8).
+ */
+export declare const CaptureSchema: z.ZodObject<{
+    memberId: z.ZodString;
+    source: z.ZodEnum<["voice", "email", "chat"]>;
+    rawText: z.ZodString;
+    extractedEvent: z.ZodNullable<z.ZodObject<{
+        title: z.ZodString;
+        start: z.ZodString;
+        end: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        timeZone: z.ZodString;
+        allDay: z.ZodDefault<z.ZodBoolean>;
+        location: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        ambiguities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        spokenConfirmation: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        start: string;
+        timeZone: string;
+        allDay: boolean;
+        confidence: "high" | "medium" | "low";
+        ambiguities: string[];
+        spokenConfirmation: string;
+        end?: string | null | undefined;
+        location?: string | null | undefined;
+        notes?: string | null | undefined;
+    }, {
+        title: string;
+        start: string;
+        timeZone: string;
+        confidence: "high" | "medium" | "low";
+        spokenConfirmation: string;
+        end?: string | null | undefined;
+        allDay?: boolean | undefined;
+        location?: string | null | undefined;
+        notes?: string | null | undefined;
+        ambiguities?: string[] | undefined;
+    }>>;
+    status: z.ZodEnum<["pending_confirmation", "confirmed", "discarded"]>;
+    /** Fields the user corrected on the confirmation card. */
+    editedFields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    googleEventId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    status: "pending_confirmation" | "confirmed" | "discarded";
+    memberId: string;
+    source: "voice" | "email" | "chat";
+    rawText: string;
+    extractedEvent: {
+        title: string;
+        start: string;
+        timeZone: string;
+        allDay: boolean;
+        confidence: "high" | "medium" | "low";
+        ambiguities: string[];
+        spokenConfirmation: string;
+        end?: string | null | undefined;
+        location?: string | null | undefined;
+        notes?: string | null | undefined;
+    } | null;
+    editedFields: string[];
+    createdAt?: any;
+    googleEventId?: string | null | undefined;
+}, {
+    status: "pending_confirmation" | "confirmed" | "discarded";
+    memberId: string;
+    source: "voice" | "email" | "chat";
+    rawText: string;
+    extractedEvent: {
+        title: string;
+        start: string;
+        timeZone: string;
+        confidence: "high" | "medium" | "low";
+        spokenConfirmation: string;
+        end?: string | null | undefined;
+        allDay?: boolean | undefined;
+        location?: string | null | undefined;
+        notes?: string | null | undefined;
+        ambiguities?: string[] | undefined;
+    } | null;
+    createdAt?: any;
+    editedFields?: string[] | undefined;
+    googleEventId?: string | null | undefined;
+}>;
+export type Capture = z.infer<typeof CaptureSchema>;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/schemas/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMxB,0DAA0D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI1D,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/capture.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureSchema = void 0;
+const zod_1 = require("zod");
+const enums_1 = require("./enums");
+const primitives_1 = require("./primitives");
+const event_1 = require("./event");
+/**
+ * `families/{familyId}/captures/{captureId}` — audit/debug log, not user-facing
+ * (README §3). `editedFields` is the accuracy telemetry behind the
+ * confirmation-fatigue risk (README §8).
+ */
+exports.CaptureSchema = zod_1.z.object({
+    memberId: zod_1.z.string().min(1),
+    source: zod_1.z.enum(enums_1.CAPTURE_SOURCES),
+    rawText: zod_1.z.string(),
+    extractedEvent: event_1.EventDraftSchema.nullable(),
+    status: zod_1.z.enum(enums_1.CAPTURE_STATUSES),
+    /** Fields the user corrected on the confirmation card. */
+    editedFields: zod_1.z.array(zod_1.z.string()).default([]),
+    googleEventId: zod_1.z.string().nullish(),
+    createdAt: primitives_1.firestoreTimestamp,
+});
+//# sourceMappingURL=capture.js.map

package/dist/schemas/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/schemas/capture.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mCAA4D;AAC5D,6CAAkD;AAClD,mCAA2C;AAE3C;;;;GAIG;AACU,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,uBAAe,CAAC;IAC/B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,cAAc,EAAE,wBAAgB,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,wBAAgB,CAAC;IAChC,0DAA0D;IAC1D,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7C,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACnC,SAAS,EAAE,+BAAkB;CAC9B,CAAC,CAAC"}

package/dist/schemas/circle.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * `families/{familyId}` — a "circle". Size 1 = solo, size N = group; the same
+ * entity either way (README §3, context.md §4).
+ */
+export declare const CircleSchema: z.ZodObject<{
+    name: z.ZodString;
+    googleCalendarId: z.ZodString;
+    calendarMode: z.ZodEnum<["primary", "provisioned"]>;
+    createdAt: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    googleCalendarId: string;
+    calendarMode: "primary" | "provisioned";
+    createdAt?: any;
+}, {
+    name: string;
+    googleCalendarId: string;
+    calendarMode: "primary" | "provisioned";
+    createdAt?: any;
+}>;
+export type Circle = z.infer<typeof CircleSchema>;
+//# sourceMappingURL=circle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circle.d.ts","sourceRoot":"","sources":["../../src/schemas/circle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAKvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/schemas/circle.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircleSchema = void 0;
+const zod_1 = require("zod");
+const enums_1 = require("./enums");
+const primitives_1 = require("./primitives");
+/**
+ * `families/{familyId}` — a "circle". Size 1 = solo, size N = group; the same
+ * entity either way (README §3, context.md §4).
+ */
+exports.CircleSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1).max(100),
+    googleCalendarId: zod_1.z.string().min(1),
+    calendarMode: zod_1.z.enum(enums_1.CIRCLE_MODES),
+    createdAt: primitives_1.firestoreTimestamp,
+});
+//# sourceMappingURL=circle.js.map

package/dist/schemas/circle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle.js","sourceRoot":"","sources":["../../src/schemas/circle.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mCAAuC;AACvC,6CAAkD;AAElD;;;GAGG;AACU,QAAA,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,YAAY,EAAE,OAAC,CAAC,IAAI,CAAC,oBAAY,CAAC;IAClC,SAAS,EAAE,+BAAkB;CAC9B,CAAC,CAAC"}

package/dist/schemas/enums.d.ts

@@ -0,0 +1,11 @@
+/** Shared domain enums — single source of truth for both backend and app. */
+export declare const AUTH_TYPES: readonly ["google", "profile"];
+export declare const CAPTURE_SOURCES: readonly ["voice", "email", "chat"];
+export declare const CAPTURE_STATUSES: readonly ["pending_confirmation", "confirmed", "discarded"];
+export declare const CHANNEL_STATUSES: readonly ["opted_in", "pending", "failed"];
+export declare const CIRCLE_MODES: readonly ["primary", "provisioned"];
+export declare const CONFIDENCE_LEVELS: readonly ["high", "medium", "low"];
+export declare const NOTIFY_CHANNELS: readonly ["sms", "whatsapp", "telegram"];
+export declare const REMINDER_STATUSES: readonly ["sent", "failed", "skipped"];
+export declare const VOICE_STYLE_PRESETS: readonly ["professional", "warm_casual", "friendly_brief"];
+//# sourceMappingURL=enums.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/schemas/enums.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,eAAO,MAAM,UAAU,gCAAiC,CAAC;AACzD,eAAO,MAAM,eAAe,qCAAsC,CAAC;AACnE,eAAO,MAAM,gBAAgB,6DAA8D,CAAC;AAC5F,eAAO,MAAM,gBAAgB,4CAA6C,CAAC;AAC3E,eAAO,MAAM,YAAY,qCAAsC,CAAC;AAChE,eAAO,MAAM,iBAAiB,oCAAqC,CAAC;AACpE,eAAO,MAAM,eAAe,0CAA2C,CAAC;AACxE,eAAO,MAAM,iBAAiB,wCAAyC,CAAC;AACxE,eAAO,MAAM,mBAAmB,4DAA6D,CAAC"}

package/dist/schemas/enums.js

@@ -0,0 +1,14 @@
+"use strict";
+/** Shared domain enums — single source of truth for both backend and app. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VOICE_STYLE_PRESETS = exports.REMINDER_STATUSES = exports.NOTIFY_CHANNELS = exports.CONFIDENCE_LEVELS = exports.CIRCLE_MODES = exports.CHANNEL_STATUSES = exports.CAPTURE_STATUSES = exports.CAPTURE_SOURCES = exports.AUTH_TYPES = void 0;
+exports.AUTH_TYPES = ["google", "profile"];
+exports.CAPTURE_SOURCES = ["voice", "email", "chat"];
+exports.CAPTURE_STATUSES = ["pending_confirmation", "confirmed", "discarded"];
+exports.CHANNEL_STATUSES = ["opted_in", "pending", "failed"];
+exports.CIRCLE_MODES = ["primary", "provisioned"];
+exports.CONFIDENCE_LEVELS = ["high", "medium", "low"];
+exports.NOTIFY_CHANNELS = ["sms", "whatsapp", "telegram"];
+exports.REMINDER_STATUSES = ["sent", "failed", "skipped"];
+exports.VOICE_STYLE_PRESETS = ["professional", "warm_casual", "friendly_brief"];
+//# sourceMappingURL=enums.js.map

package/dist/schemas/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/schemas/enums.ts"],"names":[],"mappings":";AAAA,6EAA6E;;;AAEhE,QAAA,UAAU,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AAC5C,QAAA,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AACtD,QAAA,gBAAgB,GAAG,CAAC,sBAAsB,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC;AAC/E,QAAA,gBAAgB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAC9D,QAAA,YAAY,GAAG,CAAC,SAAS,EAAE,aAAa,CAAU,CAAC;AACnD,QAAA,iBAAiB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AACvD,QAAA,eAAe,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAC3D,QAAA,iBAAiB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAC3D,QAAA,mBAAmB,GAAG,CAAC,cAAc,EAAE,aAAa,EAAE,gBAAgB,CAAU,CAAC"}

package/dist/schemas/error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Application error codes shared across backend functions and the app.
+ * This is the M1.10 graceful-failure contract (Implementation_Plan.md M1.10).
+ */
+export declare const ERROR_CODES: readonly ["ASR_FAILED", "EXTRACTION_FAILED", "TTS_FAILED", "CALENDAR_QUOTA", "NEEDS_OPT_IN", "AUTH_REQUIRED", "VALIDATION_FAILED", "NOT_FOUND", "CHANNEL_FAILED", "RATE_LIMITED", "UNKNOWN"];
+export type ErrorCode = (typeof ERROR_CODES)[number];
+/** Typed application error with a stable machine-readable code for the UI. */
+export declare class AppError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: unknown;
+    constructor(code: ErrorCode, message: string, details?: unknown);
+}
+export declare function isAppError(error: unknown): error is AppError;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/schemas/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,WAAW,8LAYd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,8EAA8E;AAC9E,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAMhE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}

package/dist/schemas/error.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppError = exports.ERROR_CODES = void 0;
+exports.isAppError = isAppError;
+/**
+ * Application error codes shared across backend functions and the app.
+ * This is the M1.10 graceful-failure contract (Implementation_Plan.md M1.10).
+ */
+exports.ERROR_CODES = [
+    "ASR_FAILED",
+    "EXTRACTION_FAILED",
+    "TTS_FAILED",
+    "CALENDAR_QUOTA",
+    "NEEDS_OPT_IN",
+    "AUTH_REQUIRED",
+    "VALIDATION_FAILED",
+    "NOT_FOUND",
+    "CHANNEL_FAILED",
+    "RATE_LIMITED",
+    "UNKNOWN",
+];
+/** Typed application error with a stable machine-readable code for the UI. */
+class AppError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "AppError";
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.AppError = AppError;
+function isAppError(error) {
+    return error instanceof AppError;
+}
+//# sourceMappingURL=error.js.map

package/dist/schemas/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/schemas/error.ts"],"names":[],"mappings":";;;AAiCA,gCAEC;AAnCD;;;GAGG;AACU,QAAA,WAAW,GAAG;IACzB,YAAY;IACZ,mBAAmB;IACnB,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,WAAW;IACX,gBAAgB;IAChB,cAAc;IACd,SAAS;CACD,CAAC;AAIX,8EAA8E;AAC9E,MAAa,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAY;IAChB,OAAO,CAAW;IAE3B,YAAY,IAAe,EAAE,OAAe,EAAE,OAAiB;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAVD,4BAUC;AAED,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,QAAQ,CAAC;AACnC,CAAC"}

package/dist/schemas/event.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { CONFIDENCE_LEVELS } from "./enums";
+/**
+ * EventDraft — the extraction-pipeline output (README §4) and the payload a
+ * confirmation card edits before confirmEvent writes it to Google Calendar.
+ */
+export declare const EventDraftSchema: z.ZodObject<{
+    title: z.ZodString;
+    start: z.ZodString;
+    end: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    timeZone: z.ZodString;
+    allDay: z.ZodDefault<z.ZodBoolean>;
+    location: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    ambiguities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * TTS string read back to the user — generated in the same LLM call so there
+     * is no second LLM call per capture (README §4).
+     */
+    spokenConfirmation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    start: string;
+    timeZone: string;
+    allDay: boolean;
+    confidence: "high" | "medium" | "low";
+    ambiguities: string[];
+    spokenConfirmation: string;
+    end?: string | null | undefined;
+    location?: string | null | undefined;
+    notes?: string | null | undefined;
+}, {
+    title: string;
+    start: string;
+    timeZone: string;
+    confidence: "high" | "medium" | "low";
+    spokenConfirmation: string;
+    end?: string | null | undefined;
+    allDay?: boolean | undefined;
+    location?: string | null | undefined;
+    notes?: string | null | undefined;
+    ambiguities?: string[] | undefined;
+}>;
+export type EventDraft = z.infer<typeof EventDraftSchema>;
+export type ConfidenceLevel = (typeof CONFIDENCE_LEVELS)[number];
+//# sourceMappingURL=event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/schemas/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;IAU3B;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/schemas/event.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventDraftSchema = void 0;
+const zod_1 = require("zod");
+const enums_1 = require("./enums");
+const primitives_1 = require("./primitives");
+/**
+ * EventDraft — the extraction-pipeline output (README §4) and the payload a
+ * confirmation card edits before confirmEvent writes it to Google Calendar.
+ */
+exports.EventDraftSchema = zod_1.z.object({
+    title: zod_1.z.string().min(1).max(200),
+    start: primitives_1.rfc3339,
+    end: primitives_1.rfc3339.optional().nullable(),
+    timeZone: primitives_1.ianaTimeZone,
+    allDay: zod_1.z.boolean().default(false),
+    location: zod_1.z.string().max(500).optional().nullable(),
+    notes: zod_1.z.string().max(2000).optional().nullable(),
+    confidence: zod_1.z.enum(enums_1.CONFIDENCE_LEVELS),
+    ambiguities: zod_1.z.array(zod_1.z.string()).default([]),
+    /**
+     * TTS string read back to the user — generated in the same LLM call so there
+     * is no second LLM call per capture (README §4).
+     */
+    spokenConfirmation: zod_1.z.string().min(1),
+});
+//# sourceMappingURL=event.js.map

package/dist/schemas/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/schemas/event.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mCAA4C;AAC5C,6CAAqD;AAErD;;;GAGG;AACU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC,KAAK,EAAE,oBAAO;IACd,GAAG,EAAE,oBAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,yBAAY;IACtB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAiB,CAAC;IACrC,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C;;;OAGG;IACH,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACtC,CAAC,CAAC"}

package/dist/schemas/member.d.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+/**
+ * `families/{familyId}/members/{memberId}` (README §3).
+ * Note: `googleUserId` stores the Firebase Auth UID — NOT Google's `sub`.
+ * The uid → (familyId, memberId) mapping lives in `userProfiles/{uid}`.
+ */
+export declare const MemberProfileSchema: z.ZodObject<{
+    displayName: z.ZodString;
+    colorId: z.ZodString;
+    /** Built-in illustration-library id (DigitalAvatar decision, README §3). */
+    avatarId: z.ZodString;
+    authType: z.ZodEnum<["google", "profile"]>;
+    /** Firebase Auth UID; null for login-less profile members. */
+    googleUserId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Optional per-member forwarding alias for email intake. */
+    intakeEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Who created this profile (admin member id), if authType === "profile". */
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    language: z.ZodString;
+    timeZone: z.ZodString;
+    voiceId: z.ZodString;
+    voiceStylePreset: z.ZodEnum<["professional", "warm_casual", "friendly_brief"]>;
+    /** Primary first, fallback after — NOT fan-out (README §5a). */
+    notifyChannels: z.ZodArray<z.ZodEnum<["sms", "whatsapp", "telegram"]>, "many">;
+    channelStatus: z.ZodRecord<z.ZodEnum<["sms", "whatsapp", "telegram"]>, z.ZodEnum<["opted_in", "pending", "failed"]>>;
+    phoneNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    telegramChatId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    timeZone: string;
+    displayName: string;
+    colorId: string;
+    avatarId: string;
+    authType: "google" | "profile";
+    language: string;
+    voiceId: string;
+    voiceStylePreset: "professional" | "warm_casual" | "friendly_brief";
+    notifyChannels: ("sms" | "whatsapp" | "telegram")[];
+    channelStatus: Partial<Record<"sms" | "whatsapp" | "telegram", "opted_in" | "pending" | "failed">>;
+    googleUserId?: string | null | undefined;
+    intakeEmail?: string | null | undefined;
+    createdBy?: string | null | undefined;
+    phoneNumber?: string | null | undefined;
+    telegramChatId?: string | null | undefined;
+}, {
+    timeZone: string;
+    displayName: string;
+    colorId: string;
+    avatarId: string;
+    authType: "google" | "profile";
+    language: string;
+    voiceId: string;
+    voiceStylePreset: "professional" | "warm_casual" | "friendly_brief";
+    notifyChannels: ("sms" | "whatsapp" | "telegram")[];
+    channelStatus: Partial<Record<"sms" | "whatsapp" | "telegram", "opted_in" | "pending" | "failed">>;
+    googleUserId?: string | null | undefined;
+    intakeEmail?: string | null | undefined;
+    createdBy?: string | null | undefined;
+    phoneNumber?: string | null | undefined;
+    telegramChatId?: string | null | undefined;
+}>;
+/** `userProfiles/{firebaseUid}` — O(1) uid → (familyId, memberId) auth mapping. */
+export declare const UserProfileSchema: z.ZodObject<{
+    familyId: z.ZodString;
+    memberId: z.ZodString;
+    authType: z.ZodEnum<["google", "profile"]>;
+    createdAt: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
+    authType: "google" | "profile";
+    familyId: string;
+    memberId: string;
+    createdAt?: any;
+}, {
+    authType: "google" | "profile";
+    familyId: string;
+    memberId: string;
+    createdAt?: any;
+}>;
+export type MemberProfile = z.infer<typeof MemberProfileSchema>;
+export type UserProfile = z.infer<typeof UserProfileSchema>;
+//# sourceMappingURL=member.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"member.d.ts","sourceRoot":"","sources":["../../src/schemas/member.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;IAG9B,4EAA4E;;;IAG5E,8DAA8D;;IAE9D,6DAA6D;;IAE7D,6EAA6E;;;;;;IAM7E,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKhE,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/member.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserProfileSchema = exports.MemberProfileSchema = void 0;
+const zod_1 = require("zod");
+const enums_1 = require("./enums");
+const primitives_1 = require("./primitives");
+/**
+ * `families/{familyId}/members/{memberId}` (README §3).
+ * Note: `googleUserId` stores the Firebase Auth UID — NOT Google's `sub`.
+ * The uid → (familyId, memberId) mapping lives in `userProfiles/{uid}`.
+ */
+exports.MemberProfileSchema = zod_1.z.object({
+    displayName: zod_1.z.string().min(1).max(100),
+    colorId: primitives_1.calendarColorId,
+    /** Built-in illustration-library id (DigitalAvatar decision, README §3). */
+    avatarId: zod_1.z.string().min(1),
+    authType: zod_1.z.enum(enums_1.AUTH_TYPES),
+    /** Firebase Auth UID; null for login-less profile members. */
+    googleUserId: zod_1.z.string().nullish(),
+    /** Optional per-member forwarding alias for email intake. */
+    intakeEmail: zod_1.z.string().email().nullish(),
+    /** Who created this profile (admin member id), if authType === "profile". */
+    createdBy: zod_1.z.string().nullish(),
+    language: primitives_1.bcp47Language,
+    timeZone: primitives_1.ianaTimeZone,
+    voiceId: zod_1.z.string().min(1),
+    voiceStylePreset: zod_1.z.enum(enums_1.VOICE_STYLE_PRESETS),
+    /** Primary first, fallback after — NOT fan-out (README §5a). */
+    notifyChannels: zod_1.z.array(zod_1.z.enum(enums_1.NOTIFY_CHANNELS)).min(1),
+    channelStatus: zod_1.z.record(zod_1.z.enum(enums_1.NOTIFY_CHANNELS), zod_1.z.enum(enums_1.CHANNEL_STATUSES)),
+    phoneNumber: primitives_1.e164Phone.nullish(),
+    telegramChatId: zod_1.z.string().nullish(),
+});
+/** `userProfiles/{firebaseUid}` — O(1) uid → (familyId, memberId) auth mapping. */
+exports.UserProfileSchema = zod_1.z.object({
+    familyId: zod_1.z.string().min(1),
+    memberId: zod_1.z.string().min(1),
+    authType: zod_1.z.enum(enums_1.AUTH_TYPES),
+    createdAt: primitives_1.firestoreTimestamp,
+});
+//# sourceMappingURL=member.js.map

package/dist/schemas/member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member.js","sourceRoot":"","sources":["../../src/schemas/member.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mCAA6F;AAC7F,6CAMsB;AAEtB;;;;GAIG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,OAAO,EAAE,4BAAe;IACxB,4EAA4E;IAC5E,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,kBAAU,CAAC;IAC5B,8DAA8D;IAC9D,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAClC,6DAA6D;IAC7D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE;IACzC,6EAA6E;IAC7E,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC/B,QAAQ,EAAE,0BAAa;IACvB,QAAQ,EAAE,yBAAY;IACtB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,gBAAgB,EAAE,OAAC,CAAC,IAAI,CAAC,2BAAmB,CAAC;IAC7C,gEAAgE;IAChE,cAAc,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,uBAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,IAAI,CAAC,uBAAe,CAAC,EAAE,OAAC,CAAC,IAAI,CAAC,wBAAgB,CAAC,CAAC;IAC1E,WAAW,EAAE,sBAAS,CAAC,OAAO,EAAE;IAChC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;CACrC,CAAC,CAAC;AAEH,mFAAmF;AACtE,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,kBAAU,CAAC;IAC5B,SAAS,EAAE,+BAAkB;CAC9B,CAAC,CAAC"}

package/dist/schemas/primitives.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+/** RFC3339 timestamp with timezone offset, e.g. "2026-09-08T15:00:00+08:00". */
+export declare const rfc3339: z.ZodString;
+/** IANA timezone name, light-validated (Region/City shape). */
+export declare const ianaTimeZone: z.ZodString;
+/** Loose BCP-47 language tag, e.g. en-US, zh-CN, es-MX. */
+export declare const bcp47Language: z.ZodString;
+/** E.164 phone number, e.g. +14155552671. */
+export declare const e164Phone: z.ZodString;
+/** Google Calendar color id "1"–"11". */
+export declare const calendarColorId: z.ZodString;
+/**
+ * Firestore server timestamp — intentionally loose in the shared layer
+ * (a JS Date in the app, a firestore Timestamp in Cloud Functions).
+ */
+export declare const firestoreTimestamp: z.ZodAny;
+//# sourceMappingURL=primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/schemas/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,eAAO,MAAM,OAAO,aAAwC,CAAC;AAE7D,+DAA+D;AAC/D,eAAO,MAAM,YAAY,aAA0D,CAAC;AAEpF,2DAA2D;AAC3D,eAAO,MAAM,aAAa,aAA0D,CAAC;AAErF,6CAA6C;AAC7C,eAAO,MAAM,SAAS,aAAwC,CAAC;AAE/D,yCAAyC;AACzC,eAAO,MAAM,eAAe,aAAsC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,UAAU,CAAC"}

package/dist/schemas/primitives.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firestoreTimestamp = exports.calendarColorId = exports.e164Phone = exports.bcp47Language = exports.ianaTimeZone = exports.rfc3339 = void 0;
+const zod_1 = require("zod");
+/** RFC3339 timestamp with timezone offset, e.g. "2026-09-08T15:00:00+08:00". */
+exports.rfc3339 = zod_1.z.string().datetime({ offset: true });
+/** IANA timezone name, light-validated (Region/City shape). */
+exports.ianaTimeZone = zod_1.z.string().regex(/^[A-Za-z]{2,}(\/[A-Za-z0-9_+\-]+)+$/);
+/** Loose BCP-47 language tag, e.g. en-US, zh-CN, es-MX. */
+exports.bcp47Language = zod_1.z.string().regex(/^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/i);
+/** E.164 phone number, e.g. +14155552671. */
+exports.e164Phone = zod_1.z.string().regex(/^\+[1-9]\d{1,14}$/);
+/** Google Calendar color id "1"–"11". */
+exports.calendarColorId = zod_1.z.string().regex(/^(1[01]|[1-9])$/);
+/**
+ * Firestore server timestamp — intentionally loose in the shared layer
+ * (a JS Date in the app, a firestore Timestamp in Cloud Functions).
+ */
+exports.firestoreTimestamp = zod_1.z.any();
+//# sourceMappingURL=primitives.js.map

package/dist/schemas/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/schemas/primitives.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,gFAAgF;AACnE,QAAA,OAAO,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE7D,+DAA+D;AAClD,QAAA,YAAY,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AAEpF,2DAA2D;AAC9C,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AAErF,6CAA6C;AAChC,QAAA,SAAS,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAE/D,yCAAyC;AAC5B,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAEnE;;;GAGG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,GAAG,EAAE,CAAC"}

package/dist/schemas/reminder.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/**
+ * `families/{familyId}/sentReminders/{eventId}_{offsetMinutes}_{channel}`
+ * (README §3, §5a). The deterministic doc id + create-if-absent write means
+ * overlapping scheduled runs and function retries can never double-send.
+ */
+export declare const SentReminderSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    offsetMinutes: z.ZodNumber;
+    sentAt: z.ZodOptional<z.ZodAny>;
+    channel: z.ZodEnum<["sms", "whatsapp", "telegram"]>;
+    status: z.ZodEnum<["sent", "failed", "skipped"]>;
+    attempt: z.ZodDefault<z.ZodNumber>;
+    lastError: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "failed" | "sent" | "skipped";
+    eventId: string;
+    offsetMinutes: number;
+    channel: "sms" | "whatsapp" | "telegram";
+    attempt: number;
+    lastError: string | null;
+    sentAt?: any;
+}, {
+    status: "failed" | "sent" | "skipped";
+    eventId: string;
+    offsetMinutes: number;
+    channel: "sms" | "whatsapp" | "telegram";
+    sentAt?: any;
+    attempt?: number | undefined;
+    lastError?: string | null | undefined;
+}>;
+export type SentReminder = z.infer<typeof SentReminderSchema>;
+//# sourceMappingURL=reminder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.d.ts","sourceRoot":"","sources":["../../src/schemas/reminder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schemas/reminder.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SentReminderSchema = void 0;
+const zod_1 = require("zod");
+const enums_1 = require("./enums");
+const primitives_1 = require("./primitives");
+/**
+ * `families/{familyId}/sentReminders/{eventId}_{offsetMinutes}_{channel}`
+ * (README §3, §5a). The deterministic doc id + create-if-absent write means
+ * overlapping scheduled runs and function retries can never double-send.
+ */
+exports.SentReminderSchema = zod_1.z.object({
+    eventId: zod_1.z.string().min(1),
+    offsetMinutes: zod_1.z.number().int().positive(),
+    sentAt: primitives_1.firestoreTimestamp.optional(),
+    channel: zod_1.z.enum(enums_1.NOTIFY_CHANNELS),
+    status: zod_1.z.enum(enums_1.REMINDER_STATUSES),
+    attempt: zod_1.z.number().int().nonnegative().default(0),
+    lastError: zod_1.z.string().nullable().default(null),
+});
+//# sourceMappingURL=reminder.js.map

package/dist/schemas/reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.js","sourceRoot":"","sources":["../../src/schemas/reminder.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mCAA6D;AAC7D,6CAAkD;AAElD;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,+BAAkB,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,OAAC,CAAC,IAAI,CAAC,uBAAe,CAAC;IAChC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAiB,CAAC;IACjC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC/C,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@voxendar/shared",
+    "version": "0.1.0",
+    "private": false,
+  "description": "Shared contracts, schemas, constants and pure logic for Voxendar/Tellie (consumed by functions/ and app/)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.4",
+    "vitest": "^2.1.9"
+  }
+}