@voxendar/shared 0.1.0 → 0.3.0

package/dist/capture/audio.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Where a member's raw recording lives (Milestone 1.5).
+ *
+ * Shared because three places have to agree on the shape and only one of them can be
+ * checked at compile time: the app builds the path, `transcribeAndExtract` validates
+ * it (`^audio/[^/]+/.+$` and its own `audio/{uid}/` ownership prefix), and
+ * `storage.rules` grants clients write access to `audio/{uid}/**` and nothing else. A
+ * path that disagrees is a capture that fails after the audio has already been
+ * uploaded — the worst moment to find out. `tests/functions/update-capture.test.js`
+ * feeds this function's output through the callable's schema so the two cannot drift.
+ *
+ * The recording is deleted by the backend the moment it has been transcribed, so this
+ * is a short-lived object, not storage the member can browse.
+ */
+export declare function rawAudioStoragePath(uid: string, fileName: string): string;
+//# sourceMappingURL=audio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/capture/audio.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/capture/audio.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rawAudioStoragePath = rawAudioStoragePath;
+const constants_1 = require("../constants");
+/**
+ * Where a member's raw recording lives (Milestone 1.5).
+ *
+ * Shared because three places have to agree on the shape and only one of them can be
+ * checked at compile time: the app builds the path, `transcribeAndExtract` validates
+ * it (`^audio/[^/]+/.+$` and its own `audio/{uid}/` ownership prefix), and
+ * `storage.rules` grants clients write access to `audio/{uid}/**` and nothing else. A
+ * path that disagrees is a capture that fails after the audio has already been
+ * uploaded — the worst moment to find out. `tests/functions/update-capture.test.js`
+ * feeds this function's output through the callable's schema so the two cannot drift.
+ *
+ * The recording is deleted by the backend the moment it has been transcribed, so this
+ * is a short-lived object, not storage the member can browse.
+ */
+function rawAudioStoragePath(uid, fileName) {
+    return `${constants_1.STORAGE_PATHS.rawAudio}/${uid}/${fileName}`;
+}
+//# sourceMappingURL=audio.js.map

package/dist/capture/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/capture/audio.ts"],"names":[],"mappings":";;AAgBA,kDAEC;AAlBD,4CAA6C;AAE7C;;;;;;;;;;;;;GAaG;AACH,SAAgB,mBAAmB,CAAC,GAAW,EAAE,QAAgB;IAC/D,OAAO,GAAG,yBAAa,CAAC,QAAQ,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;AACxD,CAAC"}

package/dist/capture/fields.d.ts

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import type { EventDraft } from "../schemas/event";
+/**
+ * The confirmation card's fields (Milestone 1.5), shared by the app and the backend.
+ *
+ * Why this lives in `shared` rather than in the app: the card edits a draft that the
+ * backend must store, and both sides have to agree on exactly two things — what may
+ * be edited, and what "edited" means. The `editedFields` list is the accuracy
+ * telemetry behind the confirmation-fatigue risk (README §8), so a field name that
+ * one side spells differently from the other silently produces a wrong metric, which
+ * is the kind of bug nobody notices until the numbers are used to make a decision.
+ *
+ * The conversion direction matters too. The draft stores absolute instants
+ * (`2026-09-27T15:00:00+08:00`), because that is what Google Calendar needs. A person
+ * editing a card thinks in wall clock ("3pm"). `fieldsFromEventDraft` converts one
+ * way — and deliberately does **no** timezone arithmetic: it reads the offset that is
+ * already in the string, since that offset is the one the backend resolved for that
+ * very instant. Rebuilding the instant from edited fields is the backend's job
+ * (`functions/src/capture/updateCapture.ts`), where the real IANA database lives.
+ */
+/** Field names the confirmation card may change. Stable strings — they are logged. */
+export declare const CAPTURE_EDITABLE_FIELDS: readonly ["title", "date", "startTime", "endTime", "allDay", "location", "notes"];
+export type CaptureEditableField = (typeof CAPTURE_EDITABLE_FIELDS)[number];
+export declare const EditableCaptureFieldsSchema: z.ZodObject<{
+    title: z.ZodString;
+    date: z.ZodString;
+    startTime: z.ZodNullable<z.ZodString>;
+    endTime: z.ZodNullable<z.ZodString>;
+    allDay: z.ZodBoolean;
+    location: z.ZodNullable<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    allDay: boolean;
+    location: string | null;
+    notes: string | null;
+    date: string;
+    startTime: string | null;
+    endTime: string | null;
+}, {
+    title: string;
+    allDay: boolean;
+    location: string | null;
+    notes: string | null;
+    date: string;
+    startTime: string | null;
+    endTime: string | null;
+}>;
+export type EditableCaptureFields = z.infer<typeof EditableCaptureFieldsSchema>;
+/**
+ * A draft as the card shows it. `endTime` is null for all-day events — the card has
+ * no use for the exclusive next-midnight end, and a person never typed it.
+ */
+export declare function fieldsFromEventDraft(draft: EventDraft): EditableCaptureFields;
+/**
+ * Which fields the member actually changed — the telemetry the whole card exists to
+ * produce (context.md §9's success signal). Only names from
+ * `CAPTURE_EDITABLE_FIELDS` can be returned, and only real differences: a card that
+ * was opened and confirmed untouched yields `[]`.
+ *
+ * The all-day toggle is reported as **one** edit: flipping it clears the start and
+ * end times as a consequence, and counting those clearings separately would turn a
+ * single tap into three "corrections" in the accuracy metric — the metric exists to
+ * measure how often the extractor is wrong, not how many fields a control happens to
+ * touch.
+ */
+export declare function editedFieldsBetween(original: EditableCaptureFields, edited: EditableCaptureFields): CaptureEditableField[];
+/** True when the draft carries anything the card should flag in amber. */
+export declare function needsAttention(draft: Pick<EventDraft, "confidence" | "ambiguities">): boolean;
+/**
+ * The card's time fields into `HH:MM`, or null when it is not a time at all.
+ *
+ * People type times the way they say them — "3", "3pm", "3:30 pm", "15.00" — and a
+ * card that answers "that is not a time" to "3pm" is a card that makes a member feel
+ * stupid for writing what they meant. The LLM's own output is always `HH:MM`; this is
+ * for the human editing afterwards.
+ *
+ * Deliberately narrow about what it will *infer*: a **bare** hour 1–11 becomes PM only
+ * when the hour has passed (a person editing a card at 16:00 who types "3" means
+ * 15:00, not 03:00), a clock reading ("9:05") is taken exactly as written, and
+ * anything else returns null so the card can say so instead of guessing.
+ *
+ * @param value the raw text from the field
+ * @param now used only to choose AM/PM for a bare hour; injectable for tests
+ */
+export declare function normaliseTimeInput(value: string, now?: Date): string | null;
+//# sourceMappingURL=fields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/capture/fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AAEH,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,mFAQ1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAO5E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAQtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAWhF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,CAY7E;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,qBAAqB,GAC5B,oBAAoB,EAAE,CAYxB;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,aAAa,CAAC,GAAG,OAAO,CAE7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CA+BvF"}

package/dist/capture/fields.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EditableCaptureFieldsSchema = exports.CAPTURE_EDITABLE_FIELDS = void 0;
+exports.fieldsFromEventDraft = fieldsFromEventDraft;
+exports.editedFieldsBetween = editedFieldsBetween;
+exports.needsAttention = needsAttention;
+exports.normaliseTimeInput = normaliseTimeInput;
+const zod_1 = require("zod");
+/**
+ * The confirmation card's fields (Milestone 1.5), shared by the app and the backend.
+ *
+ * Why this lives in `shared` rather than in the app: the card edits a draft that the
+ * backend must store, and both sides have to agree on exactly two things — what may
+ * be edited, and what "edited" means. The `editedFields` list is the accuracy
+ * telemetry behind the confirmation-fatigue risk (README §8), so a field name that
+ * one side spells differently from the other silently produces a wrong metric, which
+ * is the kind of bug nobody notices until the numbers are used to make a decision.
+ *
+ * The conversion direction matters too. The draft stores absolute instants
+ * (`2026-09-27T15:00:00+08:00`), because that is what Google Calendar needs. A person
+ * editing a card thinks in wall clock ("3pm"). `fieldsFromEventDraft` converts one
+ * way — and deliberately does **no** timezone arithmetic: it reads the offset that is
+ * already in the string, since that offset is the one the backend resolved for that
+ * very instant. Rebuilding the instant from edited fields is the backend's job
+ * (`functions/src/capture/updateCapture.ts`), where the real IANA database lives.
+ */
+/** Field names the confirmation card may change. Stable strings — they are logged. */
+exports.CAPTURE_EDITABLE_FIELDS = [
+    "title",
+    "date",
+    "startTime",
+    "endTime",
+    "allDay",
+    "location",
+    "notes",
+];
+/** `YYYY-MM-DD`, the shape the card and the extractor both use. */
+const localDate = zod_1.z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
+/** `HH:MM`, 24-hour, the shape the card and the extractor both use. */
+const localTime = zod_1.z.string().regex(/^\d{1,2}:\d{2}$/);
+exports.EditableCaptureFieldsSchema = zod_1.z.object({
+    title: zod_1.z.string().min(1).max(200),
+    date: localDate,
+    startTime: localTime.nullable(),
+    endTime: localTime.nullable(),
+    allDay: zod_1.z.boolean(),
+    location: zod_1.z.string().max(500).nullable(),
+    notes: zod_1.z.string().max(2000).nullable(),
+});
+/** One RFC3339 timestamp split into the offset it carries and the wall clock it reads. */
+function wallClockFromRfc3339(value) {
+    const match = /^(\d{4}-\d{2}-\d{2})T(\d{2}):(\d{2})/.exec(value);
+    if (!match)
+        return null;
+    // The string is already expressed in the member's zone with the right offset (the
+    // backend produced it that way), so the wall clock is simply its local part.
+    return { date: match[1] ?? "", time: `${match[2]}:${match[3]}` };
+}
+/**
+ * A draft as the card shows it. `endTime` is null for all-day events — the card has
+ * no use for the exclusive next-midnight end, and a person never typed it.
+ */
+function fieldsFromEventDraft(draft) {
+    const start = wallClockFromRfc3339(draft.start);
+    const end = draft.end ? wallClockFromRfc3339(draft.end) : null;
+    return {
+        title: draft.title,
+        date: start?.date ?? "",
+        startTime: draft.allDay ? null : (start?.time ?? null),
+        endTime: draft.allDay ? null : (end?.time ?? null),
+        allDay: draft.allDay,
+        location: draft.location ?? null,
+        notes: draft.notes ?? null,
+    };
+}
+/** Trimmed comparison, so whitespace is not reported as an edit the member made. */
+function normalise(value) {
+    return (value ?? "").trim();
+}
+/**
+ * Which fields the member actually changed — the telemetry the whole card exists to
+ * produce (context.md §9's success signal). Only names from
+ * `CAPTURE_EDITABLE_FIELDS` can be returned, and only real differences: a card that
+ * was opened and confirmed untouched yields `[]`.
+ *
+ * The all-day toggle is reported as **one** edit: flipping it clears the start and
+ * end times as a consequence, and counting those clearings separately would turn a
+ * single tap into three "corrections" in the accuracy metric — the metric exists to
+ * measure how often the extractor is wrong, not how many fields a control happens to
+ * touch.
+ */
+function editedFieldsBetween(original, edited) {
+    const changed = [];
+    const allDayToggled = original.allDay !== edited.allDay;
+    for (const field of exports.CAPTURE_EDITABLE_FIELDS) {
+        if (field === "allDay") {
+            if (allDayToggled)
+                changed.push(field);
+            continue;
+        }
+        if ((field === "startTime" || field === "endTime") && allDayToggled)
+            continue;
+        if (normalise(original[field]) !== normalise(edited[field]))
+            changed.push(field);
+    }
+    return changed;
+}
+/** True when the draft carries anything the card should flag in amber. */
+function needsAttention(draft) {
+    return draft.confidence !== "high" || draft.ambiguities.length > 0;
+}
+/**
+ * The card's time fields into `HH:MM`, or null when it is not a time at all.
+ *
+ * People type times the way they say them — "3", "3pm", "3:30 pm", "15.00" — and a
+ * card that answers "that is not a time" to "3pm" is a card that makes a member feel
+ * stupid for writing what they meant. The LLM's own output is always `HH:MM`; this is
+ * for the human editing afterwards.
+ *
+ * Deliberately narrow about what it will *infer*: a **bare** hour 1–11 becomes PM only
+ * when the hour has passed (a person editing a card at 16:00 who types "3" means
+ * 15:00, not 03:00), a clock reading ("9:05") is taken exactly as written, and
+ * anything else returns null so the card can say so instead of guessing.
+ *
+ * @param value the raw text from the field
+ * @param now used only to choose AM/PM for a bare hour; injectable for tests
+ */
+function normaliseTimeInput(value, now = new Date()) {
+    const text = value.trim().toLowerCase().replace(/\s+/g, "");
+    if (text.length === 0)
+        return null;
+    const match = /^(\d{1,2})(?:[:.](\d{2}))?(am|pm|a\.m\.|p\.m\.)?$/.exec(text);
+    if (!match)
+        return null;
+    const hour = Number(match[1]);
+    const minute = match[2] ? Number(match[2]) : 0;
+    if (!Number.isFinite(hour) || minute > 59)
+        return null;
+    const meridiem = match[3]?.[0];
+    if (meridiem === "a") {
+        // 12am is midnight, and the only 12 that does not keep its number.
+        if (hour < 1 || hour > 12)
+            return null;
+        return format(checked(hour === 12 ? 0 : hour), minute);
+    }
+    if (meridiem === "p") {
+        if (hour < 1 || hour > 12)
+            return null;
+        return format(checked(hour === 12 ? 12 : hour + 12), minute);
+    }
+    if (hour > 23)
+        return null;
+    // A *bare* hour (no minutes) of 1–11 with no meridiem is read as the next time that
+    // hour comes round — at 16:00, "3" means 15:00, because someone re-timing a dentist
+    // appointment does not mean 03:00. A clock reading ("9:05", "15:00") is read exactly
+    // as written, in the morning or not.
+    const bareHour = match[2] === undefined;
+    if (bareHour && hour >= 1 && hour <= 11 && now.getHours() >= 12) {
+        return format(checked(hour + 12), minute);
+    }
+    return format(checked(hour), minute);
+}
+function checked(hour) {
+    return hour >= 0 && hour <= 23 ? hour : null;
+}
+function format(hour, minute) {
+    if (hour === null)
+        return null;
+    return `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
+}
+//# sourceMappingURL=fields.js.map

package/dist/capture/fields.js.map

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

package/dist/constants.d.ts

@@ -4,8 +4,27 @@
  * 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"];
+/**
+ * The launch languages (decided by Rob 2026-09-23; Phase 0's last open item).
+ *
+ * Every entry here is **verified to round-trip**: a reminder sentence is
+ * synthesised by the TTS provider and the audio is transcribed back, and the
+ * transcript matches what was said (see `daily_development_log.md` →
+ * 2026-09-23 "语言集扩容"). That test is the bar for adding a language, because
+ * a provider can accept a request for an unsupported language and still
+ * mispronounce it — Hebrew failed exactly that way on `eleven_multilingual_v2`.
+ *
+ * `he-IL` is included because it **passes on `eleven_v3`** (70+ languages); see
+ * `ELEVEN_MODEL_BY_LANGUAGE` in `functions/` for the per-language model choice.
+ * Arabic and Hebrew are RTL — the *content* renders fine, but app-UI
+ * localisation for RTL is a separate, still-open workstream.
+ *
+ * Adding a language is not one constant: it also needs a reminder template in
+ * `i18n/templates.ts` (an unknown language silently falls back to English), a
+ * native-name label in the app, and a republish of this package + a functions
+ * redeploy, since the backend resolves it from the registry.
+ */
+export declare const SUPPORTED_LANGUAGES: readonly ["en-US", "zh-CN", "es-MX", "fr-FR", "de-DE", "pt-BR", "ru-RU", "ar-SA", "hi-IN", "he-IL", "ja-JP", "ko-KR"];
 /** 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). */

package/dist/constants.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mBAAmB,uHAatB,CAAC;AAEX,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

@@ -7,8 +7,40 @@
  */
 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"];
+/**
+ * The launch languages (decided by Rob 2026-09-23; Phase 0's last open item).
+ *
+ * Every entry here is **verified to round-trip**: a reminder sentence is
+ * synthesised by the TTS provider and the audio is transcribed back, and the
+ * transcript matches what was said (see `daily_development_log.md` →
+ * 2026-09-23 "语言集扩容"). That test is the bar for adding a language, because
+ * a provider can accept a request for an unsupported language and still
+ * mispronounce it — Hebrew failed exactly that way on `eleven_multilingual_v2`.
+ *
+ * `he-IL` is included because it **passes on `eleven_v3`** (70+ languages); see
+ * `ELEVEN_MODEL_BY_LANGUAGE` in `functions/` for the per-language model choice.
+ * Arabic and Hebrew are RTL — the *content* renders fine, but app-UI
+ * localisation for RTL is a separate, still-open workstream.
+ *
+ * Adding a language is not one constant: it also needs a reminder template in
+ * `i18n/templates.ts` (an unknown language silently falls back to English), a
+ * native-name label in the app, and a republish of this package + a functions
+ * redeploy, since the backend resolves it from the registry.
+ */
+exports.SUPPORTED_LANGUAGES = [
+    "en-US",
+    "zh-CN",
+    "es-MX",
+    "fr-FR",
+    "de-DE",
+    "pt-BR",
+    "ru-RU",
+    "ar-SA",
+    "hi-IN",
+    "he-IL",
+    "ja-JP",
+    "ko-KR",
+];
 /** Google Calendar color ids "1"–"11" (color-to-member assignment decided in Phase 0). */
 exports.GOOGLE_CALENDAR_COLOR_IDS = [
     "1",

package/dist/constants.js.map

@@ -1 +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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,mBAAmB,GAAG;IACjC,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAEX,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

@@ -11,13 +11,94 @@ export interface ReminderMessageParams {
     /** 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;
+/**
+ * Per-language copy, as data rather than one function per language: with 12
+ * languages the only thing that varies is punctuation and word order, so the
+ * variation belongs in a table a reviewer can scan in one screen.
+ *
+ * Two things worth knowing when adding a row:
+ * - **`lead` + `join` are the whole sentence shape.** `{location}` in `location`
+ *   is replaced only when the event has one, which is why the parentheses live
+ *   in the table (Japanese uses full-width ones, English half-width).
+ * - **Anything outside GSM-7 costs a second SMS segment.** Latin/Cyrillic-adjacent
+ *   text is 160 chars per segment on the Latin-1 path, but Arabic, Hebrew, Hindi,
+ *   Japanese and Korean are UCS-2 — 70 chars per segment — and Chinese already
+ *   is. So the 9 new languages make a long title likelier to bill as 2 segments;
+ *   this is exactly why the file header rejects free-form LLM copy.
+ */
+declare const COPY: {
+    readonly "en-US": {
+        readonly lead: "⏰ Reminder: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "zh-CN": {
+        readonly lead: "⏰ 提醒：";
+        readonly join: "，";
+        readonly location: "（📍 {location}）";
+    };
+    readonly "es-MX": {
+        readonly lead: "⏰ Recordatorio: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "fr-FR": {
+        readonly lead: "⏰ Rappel : ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "de-DE": {
+        readonly lead: "⏰ Erinnerung: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "pt-BR": {
+        readonly lead: "⏰ Lembrete: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "ru-RU": {
+        readonly lead: "⏰ Напоминание: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "ar-SA": {
+        readonly lead: "⏰ تذكير: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "hi-IN": {
+        readonly lead: "⏰ रिमाइंडर: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "he-IL": {
+        readonly lead: "⏰ תזכורת: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
+    readonly "ja-JP": {
+        readonly lead: "⏰ リマインダー：";
+        readonly join: " — ";
+        readonly location: "（📍 {location}）";
+    };
+    readonly "ko-KR": {
+        readonly lead: "⏰ 알림: ";
+        readonly join: " — ";
+        readonly location: " (📍 {location})";
+    };
 };
-export type TemplateKey = keyof typeof TEMPLATES;
-/** Closest template for a BCP-47 tag: exact → base language ("zh" → "zh-CN") → "en-US". */
+export type TemplateKey = keyof typeof COPY;
+/**
+ * Closest template for a BCP-47 tag: exact → base language ("zh" → "zh-CN") →
+ * "en-US".
+ *
+ * The base-language step now matters more than it did with three languages: a
+ * member on `pt-PT` or `ar-EG` gets `pt-BR` / `ar-SA` rather than English. That
+ * is the right trade for a message *template* — the times inside `when` are
+ * already resolved in the member's own timezone by the caller — but it is a
+ * deliberate approximation, not true localisation.
+ */
 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;

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB2E,CAAC;AAEtF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,IAAI,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAQhE;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAI5F"}

package/dist/i18n/templates.js

@@ -7,24 +7,56 @@
 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}`,
+/**
+ * Per-language copy, as data rather than one function per language: with 12
+ * languages the only thing that varies is punctuation and word order, so the
+ * variation belongs in a table a reviewer can scan in one screen.
+ *
+ * Two things worth knowing when adding a row:
+ * - **`lead` + `join` are the whole sentence shape.** `{location}` in `location`
+ *   is replaced only when the event has one, which is why the parentheses live
+ *   in the table (Japanese uses full-width ones, English half-width).
+ * - **Anything outside GSM-7 costs a second SMS segment.** Latin/Cyrillic-adjacent
+ *   text is 160 chars per segment on the Latin-1 path, but Arabic, Hebrew, Hindi,
+ *   Japanese and Korean are UCS-2 — 70 chars per segment — and Chinese already
+ *   is. So the 9 new languages make a long title likelier to bill as 2 segments;
+ *   this is exactly why the file header rejects free-form LLM copy.
+ */
+const COPY = {
+    "en-US": { lead: "⏰ Reminder: ", join: " — ", location: " (📍 {location})" },
+    "zh-CN": { lead: "⏰ 提醒：", join: "，", location: "（📍 {location}）" },
+    "es-MX": { lead: "⏰ Recordatorio: ", join: " — ", location: " (📍 {location})" },
+    // French puts a space before the colon — `Rappel :` — not `Rappel:`.
+    "fr-FR": { lead: "⏰ Rappel : ", join: " — ", location: " (📍 {location})" },
+    "de-DE": { lead: "⏰ Erinnerung: ", join: " — ", location: " (📍 {location})" },
+    "pt-BR": { lead: "⏰ Lembrete: ", join: " — ", location: " (📍 {location})" },
+    "ru-RU": { lead: "⏰ Напоминание: ", join: " — ", location: " (📍 {location})" },
+    // Arabic is RTL: the whole line renders right-to-left, but `lead` still comes
+    // first in logical order, which is what the messaging APIs expect.
+    "ar-SA": { lead: "⏰ تذكير: ", join: " — ", location: " (📍 {location})" },
+    "hi-IN": { lead: "⏰ रिमाइंडर: ", join: " — ", location: " (📍 {location})" },
+    "he-IL": { lead: "⏰ תזכורת: ", join: " — ", location: " (📍 {location})" },
+    // Japanese uses `：` after the lead and `、`-style separation; full-width
+    // parentheses keep the location visually inside the sentence.
+    "ja-JP": { lead: "⏰ リマインダー：", join: " — ", location: "（📍 {location}）" },
+    "ko-KR": { lead: "⏰ 알림: ", join: " — ", location: " (📍 {location})" },
 };
-/** Closest template for a BCP-47 tag: exact → base language ("zh" → "zh-CN") → "en-US". */
+/**
+ * Closest template for a BCP-47 tag: exact → base language ("zh" → "zh-CN") →
+ * "en-US".
+ *
+ * The base-language step now matters more than it did with three languages: a
+ * member on `pt-PT` or `ar-EG` gets `pt-BR` / `ar-SA` rather than English. That
+ * is the right trade for a message *template* — the times inside `when` are
+ * already resolved in the member's own timezone by the caller — but it is a
+ * deliberate approximation, not true localisation.
+ */
 function resolveTemplateKey(language) {
-    if (language in TEMPLATES)
+    if (language in COPY)
         return language;
     const base = language.split("-")[0] ?? "";
     if (base.length >= 2) {
-        const baseKey = Object.keys(TEMPLATES).find((key) => key.startsWith(`${base}-`));
+        const baseKey = Object.keys(COPY).find((key) => key.startsWith(`${base}-`));
         if (baseKey)
             return baseKey;
     }
@@ -32,7 +64,8 @@ function resolveTemplateKey(language) {
 }
 /** Build the reminder message text for a member's language. */
 function buildReminderMessage(language, params) {
-    const templateKey = resolveTemplateKey(language);
-    return TEMPLATES[templateKey](params);
+    const copy = COPY[resolveTemplateKey(language)];
+    const body = `${copy.lead}${params.title}${copy.join}${params.when}`;
+    return params.location ? body + copy.location.replace("{location}", params.location) : body;
 }
 //# sourceMappingURL=templates.js.map

package/dist/i18n/templates.js.map

@@ -1 +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"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/i18n/templates.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA0DH,gDAQC;AAGD,oDAIC;AA9DD;;;;;;;;;;;;;;GAcG;AACH,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAC5E,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,iBAAiB,EAAE;IAClE,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAChF,qEAAqE;IACrE,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAC9E,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAC5E,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAC/E,8EAA8E;IAC9E,mEAAmE;IACnE,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IACzE,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAC5E,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IAC1E,wEAAwE;IACxE,8DAA8D;IAC9D,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE;IACxE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE;CACa,CAAC;AAItF;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAAC,QAAgB;IACjD,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,QAAuB,CAAC;IACrD,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,IAAI,CAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;QAC/F,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,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACrE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9F,CAAC"}

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export * from "./schemas/event";
 export * from "./schemas/circle";
 export * from "./schemas/member";
 export * from "./schemas/capture";
+export * from "./capture/fields";
+export * from "./capture/audio";
 export * from "./schemas/reminder";
 export * from "./reminders/math";
 export * from "./i18n/templates";

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -22,6 +22,8 @@ __exportStar(require("./schemas/event"), exports);
 __exportStar(require("./schemas/circle"), exports);
 __exportStar(require("./schemas/member"), exports);
 __exportStar(require("./schemas/capture"), exports);
+__exportStar(require("./capture/fields"), exports);
+__exportStar(require("./capture/audio"), exports);
 __exportStar(require("./schemas/reminder"), exports);
 __exportStar(require("./reminders/math"), exports);
 __exportStar(require("./i18n/templates"), exports);

package/dist/index.js.map

@@ -1 +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"}
+{"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,mDAAiC;AACjC,kDAAgC;AAChC,qDAAmC;AACnC,mDAAiC;AACjC,mDAAiC"}

package/dist/schemas/capture.d.ts

@@ -47,6 +47,12 @@ export declare const CaptureSchema: z.ZodObject<{
     editedFields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     googleEventId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodAny;
+    /**
+     * When the member confirmed or discarded it (M1.5). Optional because captures
+     * written before this existed have no such instant, and because a capture sitting
+     * in `pending_confirmation` has not been decided at all.
+     */
+    decidedAt: z.ZodOptional<z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
     status: "pending_confirmation" | "confirmed" | "discarded";
     memberId: string;
@@ -67,6 +73,7 @@ export declare const CaptureSchema: z.ZodObject<{
     editedFields: string[];
     createdAt?: any;
     googleEventId?: string | null | undefined;
+    decidedAt?: any;
 }, {
     status: "pending_confirmation" | "confirmed" | "discarded";
     memberId: string;
@@ -87,6 +94,7 @@ export declare const CaptureSchema: z.ZodObject<{
     createdAt?: any;
     editedFields?: string[] | undefined;
     googleEventId?: string | null | undefined;
+    decidedAt?: any;
 }>;
 export type Capture = z.infer<typeof CaptureSchema>;
 //# sourceMappingURL=capture.d.ts.map

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

@@ -1 +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"}
+{"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;;;;IAI1D;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/capture.js

@@ -20,5 +20,11 @@ exports.CaptureSchema = zod_1.z.object({
     editedFields: zod_1.z.array(zod_1.z.string()).default([]),
     googleEventId: zod_1.z.string().nullish(),
     createdAt: primitives_1.firestoreTimestamp,
+    /**
+     * When the member confirmed or discarded it (M1.5). Optional because captures
+     * written before this existed have no such instant, and because a capture sitting
+     * in `pending_confirmation` has not been decided at all.
+     */
+    decidedAt: primitives_1.firestoreTimestamp.optional(),
 });
 //# sourceMappingURL=capture.js.map

package/dist/schemas/capture.js.map

@@ -1 +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"}
+{"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;IAC7B;;;;OAIG;IACH,SAAS,EAAE,+BAAkB,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@voxendar/shared",
-    "version": "0.1.0",
-    "private": false,
+  "version": "0.3.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",
@@ -11,7 +11,9 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run"
+    "test": "vitest run",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm test"
   },
   "dependencies": {
     "zod": "^3.23.8"
@@ -21,4 +23,4 @@
     "typescript": "^5.5.4",
     "vitest": "^2.1.9"
   }
-}
+}