dink-pets-shared 1.0.0

package/dist/src/auth.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { JwtToken, UserId } from "./ids.js";
+import { UserRole } from "./roles.js";
+// =============================================================================
+// OAUTH2 TOKEN RESPONSE
+// =============================================================================
+// Validates the response from Descope's /oauth2/v1/token endpoint.
+// Uses snake_case per OAuth2 spec (RFC 6749).
+//
+// access_token is the JWT we send to our server in Authorization headers,
+// so it's branded as JwtToken for type safety.
+export const OAuthTokenResponse = z.object({
+    access_token: JwtToken,
+    refresh_token: z.string().optional(),
+    id_token: z.string().optional(),
+    token_type: z.string().optional(),
+    expires_in: z.number().optional(),
+});
+// =============================================================================
+// AUTH INFO SCHEMA (companion object pattern)
+// =============================================================================
+// Validates the claims we expect from a Descope JWT after it's been verified.
+// This is the contract between Descope and our app - if Descope changes their
+// claim structure, this schema will catch it at runtime with a clear error.
+//
+// Uses companion object pattern: AuthInfo is both a type and a Zod schema.
+// - Use as type: `const info: AuthInfo = ...`
+// - Use as schema: `AuthInfo.parse(...)`
+//
+// Standard OIDC claims:
+// - sub: Subject identifier (Descope's user ID)
+// - email: User's email address
+// - name: User's display name (optional - not all auth methods provide it)
+// - picture: User's avatar URL (optional - from OAuth providers like Google)
+export const AuthInfo = z.object({
+    sub: UserId,
+    email: z.email(),
+    name: z.string().optional(),
+    picture: z.url().optional(),
+    roles: z.array(UserRole).optional(), // Descope sends roles in JWT claims
+});
+// Re-export for convenience
+export { JwtToken, UserId };

package/dist/src/constants.d.ts

@@ -0,0 +1,13 @@
+import { AchievementType, UserTier } from "./enums.js";
+export declare const APP_NAME = "Dink Pets";
+/** Request timeout in milliseconds. Used by both server (Fastify) and mobile (tRPC client). */
+export declare const REQUEST_TIMEOUT_MS = 30000;
+export declare const achievementLabels: Record<AchievementType, string>;
+/** Tiers that grant premium access (paid or gifted) */
+export declare const PREMIUM_TIERS: UserTier[];
+export declare const PAID_TIERS: UserTier[];
+export declare const isPaidTier: (tier: UserTier) => boolean;
+/** Check if a tier has premium access */
+export declare const isAnyPremiumTier: (tier: UserTier) => boolean;
+/** Month names (1-indexed: MONTH_NAMES[0] = January, MONTH_NAMES[11] = December) */
+export declare const MONTH_NAMES: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];

package/dist/src/constants.js

@@ -0,0 +1,41 @@
+import { AchievementType, UserTier } from "./enums.js";
+export const APP_NAME = "Dink Pets";
+/** Request timeout in milliseconds. Used by both server (Fastify) and mobile (tRPC client). */
+export const REQUEST_TIMEOUT_MS = 30000;
+export const achievementLabels = {
+    [AchievementType.enum.FIRST_WALK]: "First Walk",
+    [AchievementType.enum.FIRST_PHOTO]: "First Photo",
+    [AchievementType.enum.DAYS_TOGETHER_30]: "30 Days Together",
+    [AchievementType.enum.DAYS_TOGETHER_100]: "100 Days Together",
+    [AchievementType.enum.DAYS_TOGETHER_365]: "1 Year Together",
+    [AchievementType.enum.WALKS_STREAK_7]: "7-Day Walk Streak",
+    [AchievementType.enum.WALKS_STREAK_30]: "30-Day Walk Streak",
+    [AchievementType.enum.MEALS_ON_TIME_7]: "7-Day Meals On Time",
+    [AchievementType.enum.WALKS_100]: "100 Walks",
+    [AchievementType.enum.WALKS_500]: "500 Walks",
+    [AchievementType.enum.PHOTOS_50]: "50 Photos",
+};
+/** Tiers that grant premium access (paid or gifted) */
+export const PREMIUM_TIERS = [
+    UserTier.enum.PREMIUM,
+    UserTier.enum.PREMIUM_GRATIS,
+];
+export const PAID_TIERS = [UserTier.enum.PREMIUM];
+export const isPaidTier = (tier) => PAID_TIERS.includes(tier);
+/** Check if a tier has premium access */
+export const isAnyPremiumTier = (tier) => PREMIUM_TIERS.includes(tier);
+/** Month names (1-indexed: MONTH_NAMES[0] = January, MONTH_NAMES[11] = December) */
+export const MONTH_NAMES = [
+    "January",
+    "February",
+    "March",
+    "April",
+    "May",
+    "June",
+    "July",
+    "August",
+    "September",
+    "October",
+    "November",
+    "December",
+];

package/dist/src/enums.d.ts

@@ -0,0 +1,121 @@
+import { z } from "zod";
+export declare const userTiers: readonly ["FREE", "PREMIUM", "PREMIUM_GRATIS"];
+export declare const UserTier: z.ZodEnum<{
+    FREE: "FREE";
+    PREMIUM: "PREMIUM";
+    PREMIUM_GRATIS: "PREMIUM_GRATIS";
+}>;
+export type UserTier = z.infer<typeof UserTier>;
+export declare const petRoles: readonly ["OWNER", "COOWNER", "CARETAKER"];
+export declare const PetRole: z.ZodEnum<{
+    OWNER: "OWNER";
+    COOWNER: "COOWNER";
+    CARETAKER: "CARETAKER";
+}>;
+export type PetRole = z.infer<typeof PetRole>;
+export declare const speciesValues: readonly ["DOG", "CAT", "BIRD", "RABBIT", "FISH", "REPTILE", "OTHER"];
+export declare const Species: z.ZodEnum<{
+    DOG: "DOG";
+    CAT: "CAT";
+    BIRD: "BIRD";
+    RABBIT: "RABBIT";
+    FISH: "FISH";
+    REPTILE: "REPTILE";
+    OTHER: "OTHER";
+}>;
+export type Species = z.infer<typeof Species>;
+export declare const genders: readonly ["MALE", "FEMALE"];
+export declare const Gender: z.ZodEnum<{
+    MALE: "MALE";
+    FEMALE: "FEMALE";
+}>;
+export type Gender = z.infer<typeof Gender>;
+export declare const recurrences: readonly ["DAILY", "WEEKLY", "SPECIFIC_WEEKDAYS", "MONTHLY", "YEARLY", "ONCE"];
+export declare const Recurrence: z.ZodEnum<{
+    DAILY: "DAILY";
+    WEEKLY: "WEEKLY";
+    SPECIFIC_WEEKDAYS: "SPECIFIC_WEEKDAYS";
+    MONTHLY: "MONTHLY";
+    YEARLY: "YEARLY";
+    ONCE: "ONCE";
+}>;
+export type Recurrence = z.infer<typeof Recurrence>;
+export declare const daysOfWeek: readonly ["SUN", "MON", "TUE", "WED", "THU", "FRI", "SAT"];
+export declare const DayOfWeek: z.ZodEnum<{
+    SUN: "SUN";
+    MON: "MON";
+    TUE: "TUE";
+    WED: "WED";
+    THU: "THU";
+    FRI: "FRI";
+    SAT: "SAT";
+}>;
+export type DayOfWeek = z.infer<typeof DayOfWeek>;
+export declare const activityTypes: readonly ["WALK", "MEAL", "BATHROOM", "TREAT", "PLAYTIME", "MEDICATION", "VET_APPOINTMENT", "GROOMING", "BATH", "NAIL_TRIM"];
+export declare const ActivityType: z.ZodEnum<{
+    WALK: "WALK";
+    MEAL: "MEAL";
+    BATHROOM: "BATHROOM";
+    TREAT: "TREAT";
+    PLAYTIME: "PLAYTIME";
+    MEDICATION: "MEDICATION";
+    VET_APPOINTMENT: "VET_APPOINTMENT";
+    GROOMING: "GROOMING";
+    BATH: "BATH";
+    NAIL_TRIM: "NAIL_TRIM";
+}>;
+export type ActivityType = z.infer<typeof ActivityType>;
+export declare const healthLogTypes: readonly ["WEIGHT", "VET_VISIT", "SYMPTOM", "CONDITION", "ALLERGY", "VACCINE"];
+export declare const HealthLogType: z.ZodEnum<{
+    WEIGHT: "WEIGHT";
+    VET_VISIT: "VET_VISIT";
+    SYMPTOM: "SYMPTOM";
+    CONDITION: "CONDITION";
+    ALLERGY: "ALLERGY";
+    VACCINE: "VACCINE";
+}>;
+export type HealthLogType = z.infer<typeof HealthLogType>;
+export declare const achievementTypes: readonly ["FIRST_WALK", "FIRST_PHOTO", "DAYS_TOGETHER_30", "DAYS_TOGETHER_100", "DAYS_TOGETHER_365", "WALKS_STREAK_7", "WALKS_STREAK_30", "MEALS_ON_TIME_7", "WALKS_100", "WALKS_500", "PHOTOS_50"];
+export declare const AchievementType: z.ZodEnum<{
+    FIRST_WALK: "FIRST_WALK";
+    FIRST_PHOTO: "FIRST_PHOTO";
+    DAYS_TOGETHER_30: "DAYS_TOGETHER_30";
+    DAYS_TOGETHER_100: "DAYS_TOGETHER_100";
+    DAYS_TOGETHER_365: "DAYS_TOGETHER_365";
+    WALKS_STREAK_7: "WALKS_STREAK_7";
+    WALKS_STREAK_30: "WALKS_STREAK_30";
+    MEALS_ON_TIME_7: "MEALS_ON_TIME_7";
+    WALKS_100: "WALKS_100";
+    WALKS_500: "WALKS_500";
+    PHOTOS_50: "PHOTOS_50";
+}>;
+export type AchievementType = z.infer<typeof AchievementType>;
+export declare const accessTypes: readonly ["PERMANENT", "DATE_RANGE", "ONE_TIME", "RECURRING"];
+export declare const AccessType: z.ZodEnum<{
+    PERMANENT: "PERMANENT";
+    DATE_RANGE: "DATE_RANGE";
+    ONE_TIME: "ONE_TIME";
+    RECURRING: "RECURRING";
+}>;
+export type AccessType = z.infer<typeof AccessType>;
+export declare const inviteTypes: readonly ["PET_ACCESS", "REFERRAL"];
+export declare const InviteType: z.ZodEnum<{
+    PET_ACCESS: "PET_ACCESS";
+    REFERRAL: "REFERRAL";
+}>;
+export type InviteType = z.infer<typeof InviteType>;
+export declare const updateTypes: readonly ["PET_ACCESS_GRANTED", "ACHIEVEMENT_UNLOCKED", "REFERRAL_ACCEPTED"];
+export declare const UpdateType: z.ZodEnum<{
+    PET_ACCESS_GRANTED: "PET_ACCESS_GRANTED";
+    ACHIEVEMENT_UNLOCKED: "ACHIEVEMENT_UNLOCKED";
+    REFERRAL_ACCEPTED: "REFERRAL_ACCEPTED";
+}>;
+export type UpdateType = z.infer<typeof UpdateType>;
+export declare const reminderAlertStatuses: readonly ["PENDING", "SENT", "FAILED", "SKIPPED"];
+export declare const ReminderAlertStatus: z.ZodEnum<{
+    PENDING: "PENDING";
+    SENT: "SENT";
+    FAILED: "FAILED";
+    SKIPPED: "SKIPPED";
+}>;
+export type ReminderAlertStatus = z.infer<typeof ReminderAlertStatus>;

package/dist/src/enums.js

@@ -0,0 +1,41 @@
+// =============================================================================
+// SHARED ENUMS - AUTO-GENERATED FROM PRISMA SCHEMA
+// =============================================================================
+// DO NOT EDIT THIS FILE MANUALLY.
+// Run: node shared/scripts/generate-enums.js
+// Or:  cd server && npx prisma generate (runs automatically)
+//
+// This file generates Zod schemas (not TypeScript enums) because:
+// - TS enums are nominally typed (Prisma's enums != shared enums even with same values)
+// - Zod schemas produce string unions which are structurally typed
+// - Server can pass Prisma enum values to shared functions without type errors
+//
+// See shared/README.md for full architecture explanation.
+// =============================================================================
+import { z } from "zod";
+export const userTiers = ["FREE", "PREMIUM", "PREMIUM_GRATIS"];
+export const UserTier = z.enum(userTiers);
+export const petRoles = ["OWNER", "COOWNER", "CARETAKER"];
+export const PetRole = z.enum(petRoles);
+export const speciesValues = ["DOG", "CAT", "BIRD", "RABBIT", "FISH", "REPTILE", "OTHER"];
+export const Species = z.enum(speciesValues);
+export const genders = ["MALE", "FEMALE"];
+export const Gender = z.enum(genders);
+export const recurrences = ["DAILY", "WEEKLY", "SPECIFIC_WEEKDAYS", "MONTHLY", "YEARLY", "ONCE"];
+export const Recurrence = z.enum(recurrences);
+export const daysOfWeek = ["SUN", "MON", "TUE", "WED", "THU", "FRI", "SAT"];
+export const DayOfWeek = z.enum(daysOfWeek);
+export const activityTypes = ["WALK", "MEAL", "BATHROOM", "TREAT", "PLAYTIME", "MEDICATION", "VET_APPOINTMENT", "GROOMING", "BATH", "NAIL_TRIM"];
+export const ActivityType = z.enum(activityTypes);
+export const healthLogTypes = ["WEIGHT", "VET_VISIT", "SYMPTOM", "CONDITION", "ALLERGY", "VACCINE"];
+export const HealthLogType = z.enum(healthLogTypes);
+export const achievementTypes = ["FIRST_WALK", "FIRST_PHOTO", "DAYS_TOGETHER_30", "DAYS_TOGETHER_100", "DAYS_TOGETHER_365", "WALKS_STREAK_7", "WALKS_STREAK_30", "MEALS_ON_TIME_7", "WALKS_100", "WALKS_500", "PHOTOS_50"];
+export const AchievementType = z.enum(achievementTypes);
+export const accessTypes = ["PERMANENT", "DATE_RANGE", "ONE_TIME", "RECURRING"];
+export const AccessType = z.enum(accessTypes);
+export const inviteTypes = ["PET_ACCESS", "REFERRAL"];
+export const InviteType = z.enum(inviteTypes);
+export const updateTypes = ["PET_ACCESS_GRANTED", "ACHIEVEMENT_UNLOCKED", "REFERRAL_ACCEPTED"];
+export const UpdateType = z.enum(updateTypes);
+export const reminderAlertStatuses = ["PENDING", "SENT", "FAILED", "SKIPPED"];
+export const ReminderAlertStatus = z.enum(reminderAlertStatuses);

package/dist/src/feature-flags.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SERVER-SIDE REMINDER PUSH NOTIFICATIONS
+ *
+ * When ENABLED (true):
+ * - Server runs cron job every minute to check due reminders
+ * - Server sends push notifications via Expo Push API
+ * - User timezone is synced from mobile to server
+ * - ReminderAlert table tracks sent notifications
+ *
+ * When DISABLED (false):
+ * - Server cron jobs for reminders do NOT run
+ * - Mobile handles all reminder notifications locally via expo-notifications
+ * - Timezone sync still happens (may be useful for other features) but not required
+ *
+ * IMPORTANT - REMOVAL INSTRUCTIONS:
+ * If removing server-side reminder push entirely, delete ALL of the following together:
+ *
+ * Server:
+ * - server/src/services/reminder-scheduler.ts (entire file)
+ * - server/src/index.ts: cron.schedule blocks wrapped with this flag
+ * - server/src/index.ts: import of reminder-scheduler
+ * - server/prisma/schema.prisma: ReminderAlert model (run migration after)
+ * - server/prisma/schema.prisma: ReminderAlertStatus enum
+ * - server/prisma/schema.prisma: User.timezone field (optional - may want to keep)
+ *
+ * Mobile:
+ * - mobile/lib/sync-timezone.ts (entire file) - only if User.timezone removed
+ * - mobile/stores/auth-store.ts: syncTimezone/clearSyncedTimezone calls - only if above removed
+ *
+ * Shared:
+ * - This flag can be removed once all above code is removed
+ *
+ * DO NOT partially remove - either keep all or remove all to avoid dead code.
+ */
+export declare const SERVER_REMINDER_PUSH_ENABLED = false;

package/dist/src/feature-flags.js

@@ -0,0 +1,41 @@
+// =============================================================================
+// FEATURE FLAGS
+// =============================================================================
+// Toggles for features that may not be fully implemented or need coordination
+// between client and server.
+// =============================================================================
+/**
+ * SERVER-SIDE REMINDER PUSH NOTIFICATIONS
+ *
+ * When ENABLED (true):
+ * - Server runs cron job every minute to check due reminders
+ * - Server sends push notifications via Expo Push API
+ * - User timezone is synced from mobile to server
+ * - ReminderAlert table tracks sent notifications
+ *
+ * When DISABLED (false):
+ * - Server cron jobs for reminders do NOT run
+ * - Mobile handles all reminder notifications locally via expo-notifications
+ * - Timezone sync still happens (may be useful for other features) but not required
+ *
+ * IMPORTANT - REMOVAL INSTRUCTIONS:
+ * If removing server-side reminder push entirely, delete ALL of the following together:
+ *
+ * Server:
+ * - server/src/services/reminder-scheduler.ts (entire file)
+ * - server/src/index.ts: cron.schedule blocks wrapped with this flag
+ * - server/src/index.ts: import of reminder-scheduler
+ * - server/prisma/schema.prisma: ReminderAlert model (run migration after)
+ * - server/prisma/schema.prisma: ReminderAlertStatus enum
+ * - server/prisma/schema.prisma: User.timezone field (optional - may want to keep)
+ *
+ * Mobile:
+ * - mobile/lib/sync-timezone.ts (entire file) - only if User.timezone removed
+ * - mobile/stores/auth-store.ts: syncTimezone/clearSyncedTimezone calls - only if above removed
+ *
+ * Shared:
+ * - This flag can be removed once all above code is removed
+ *
+ * DO NOT partially remove - either keep all or remove all to avoid dead code.
+ */
+export const SERVER_REMINDER_PUSH_ENABLED = false;

package/dist/src/ids.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+declare const __brand: unique symbol;
+type Brand<T, B> = T & {
+    readonly [__brand]: B;
+};
+export type UserId = Brand<string, "UserId">;
+export declare const UserId: z.ZodPipe<z.ZodString, z.ZodCustom<UserId, UserId>>;
+export type PetId = Brand<string, "PetId">;
+export declare const PetId: z.ZodPipe<z.ZodString, z.ZodCustom<PetId, PetId>>;
+export type ReminderId = Brand<string, "ReminderId">;
+export declare const ReminderId: z.ZodPipe<z.ZodString, z.ZodCustom<ReminderId, ReminderId>>;
+export type ActivityId = Brand<string, "ActivityId">;
+export declare const ActivityId: z.ZodPipe<z.ZodString, z.ZodCustom<ActivityId, ActivityId>>;
+export type HealthLogId = Brand<string, "HealthLogId">;
+export declare const HealthLogId: z.ZodPipe<z.ZodString, z.ZodCustom<HealthLogId, HealthLogId>>;
+export type PhotoId = Brand<string, "PhotoId">;
+export declare const PhotoId: z.ZodPipe<z.ZodString, z.ZodCustom<PhotoId, PhotoId>>;
+export type PetPhotoFileId = Brand<string, "PetPhotoFileId">;
+export declare const PetPhotoFileId: z.ZodPipe<z.ZodString, z.ZodCustom<PetPhotoFileId, PetPhotoFileId>>;
+export type AchievementId = Brand<string, "AchievementId">;
+export declare const AchievementId: z.ZodPipe<z.ZodString, z.ZodCustom<AchievementId, AchievementId>>;
+export type PetAccessId = Brand<string, "PetAccessId">;
+export declare const PetAccessId: z.ZodPipe<z.ZodString, z.ZodCustom<PetAccessId, PetAccessId>>;
+export type UpdateId = Brand<string, "UpdateId">;
+export declare const UpdateId: z.ZodPipe<z.ZodString, z.ZodCustom<UpdateId, UpdateId>>;
+export type UserSettingsId = Brand<string, "UserSettingsId">;
+export declare const UserSettingsId: z.ZodPipe<z.ZodString, z.ZodCustom<UserSettingsId, UserSettingsId>>;
+export type ReminderAlertId = Brand<string, "ReminderAlertId">;
+export declare const ReminderAlertId: z.ZodPipe<z.ZodString, z.ZodCustom<ReminderAlertId, ReminderAlertId>>;
+export type InviteId = Brand<string, "InviteId">;
+export declare const InviteId: z.ZodPipe<z.ZodString, z.ZodCustom<InviteId, InviteId>>;
+export type PushTokenId = Brand<string, "PushTokenId">;
+export declare const PushTokenId: z.ZodPipe<z.ZodString, z.ZodCustom<PushTokenId, PushTokenId>>;
+/**
+ * The actual Expo push token value (e.g., "ExponentPushToken[abc123...]").
+ * This is the token used to send push notifications to a device.
+ * Distinct from PushTokenId which is the database row ID.
+ */
+export type ExpoPushToken = Brand<string, "ExpoPushToken">;
+export declare const ExpoPushToken: z.ZodPipe<z.ZodString, z.ZodCustom<ExpoPushToken, ExpoPushToken>>;
+export type JwtToken = Brand<string, "JwtToken">;
+export declare const JwtToken: z.ZodPipe<z.ZodString, z.ZodCustom<JwtToken, JwtToken>>;
+/**
+ * Cast a plain string to a branded ID type at trust boundaries.
+ *
+ * Trust boundaries include:
+ * - Database query results (Prisma returns plain strings)
+ * - API request params (user input)
+ * - External services (Descope returns user ID as string)
+ *
+ * Don't scatter casts everywhere - do it once at the boundary, then pass
+ * the branded type through your code.
+ */
+export declare const asUserId: (id: string) => UserId;
+export declare const asPetId: (id: string) => PetId;
+export declare const asReminderId: (id: string) => ReminderId;
+export declare const asActivityId: (id: string) => ActivityId;
+export declare const asHealthLogId: (id: string) => HealthLogId;
+export declare const asPhotoId: (id: string) => PhotoId;
+export declare const asPetPhotoFileId: (id: string) => PetPhotoFileId;
+export declare const asAchievementId: (id: string) => AchievementId;
+export declare const asPetAccessId: (id: string) => PetAccessId;
+export declare const asUpdateId: (id: string) => UpdateId;
+export declare const asUserSettingsId: (id: string) => UserSettingsId;
+export declare const asReminderAlertId: (id: string) => ReminderAlertId;
+export declare const asInviteId: (id: string) => InviteId;
+export declare const asPushTokenId: (id: string) => PushTokenId;
+export declare const asExpoPushToken: (token: string) => ExpoPushToken;
+export declare const asJwtToken: (token: string) => JwtToken;
+export {};

package/dist/src/ids.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+export const UserId = z.string().pipe(z.custom());
+export const PetId = z.string().pipe(z.custom());
+export const ReminderId = z.string().pipe(z.custom());
+export const ActivityId = z.string().pipe(z.custom());
+export const HealthLogId = z.string().pipe(z.custom());
+export const PhotoId = z.string().pipe(z.custom());
+export const PetPhotoFileId = z.string().pipe(z.custom());
+export const AchievementId = z.string().pipe(z.custom());
+export const PetAccessId = z.string().pipe(z.custom());
+export const UpdateId = z.string().pipe(z.custom());
+export const UserSettingsId = z.string().pipe(z.custom());
+export const ReminderAlertId = z.string().pipe(z.custom());
+export const InviteId = z.string().pipe(z.custom());
+export const PushTokenId = z.string().pipe(z.custom());
+export const ExpoPushToken = z.string().pipe(z.custom());
+export const JwtToken = z.string().pipe(z.custom());
+// =============================================================================
+// CASTING HELPERS
+// =============================================================================
+/**
+ * Cast a plain string to a branded ID type at trust boundaries.
+ *
+ * Trust boundaries include:
+ * - Database query results (Prisma returns plain strings)
+ * - API request params (user input)
+ * - External services (Descope returns user ID as string)
+ *
+ * Don't scatter casts everywhere - do it once at the boundary, then pass
+ * the branded type through your code.
+ */
+export const asUserId = (id) => id;
+export const asPetId = (id) => id;
+export const asReminderId = (id) => id;
+export const asActivityId = (id) => id;
+export const asHealthLogId = (id) => id;
+export const asPhotoId = (id) => id;
+export const asPetPhotoFileId = (id) => id;
+export const asAchievementId = (id) => id;
+export const asPetAccessId = (id) => id;
+export const asUpdateId = (id) => id;
+export const asUserSettingsId = (id) => id;
+export const asReminderAlertId = (id) => id;
+export const asInviteId = (id) => id;
+export const asPushTokenId = (id) => id;
+export const asExpoPushToken = (token) => token;
+export const asJwtToken = (token) => token;

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./activity-details.js";
+export * from "./admin.js";
+export * from "./auth.js";
+export * from "./constants.js";
+export * from "./enums.js";
+export * from "./feature-flags.js";
+export * from "./ids.js";
+export * from "./roles.js";
+export * from "./schemas.js";
+export * from "./theme.js";
+export * from "./updates.js";
+export * from "./uploads.js";
+export * from "./utils.js";
+export * from "./web-routes.js";

package/dist/src/index.js

@@ -0,0 +1,14 @@
+export * from "./activity-details.js";
+export * from "./admin.js";
+export * from "./auth.js";
+export * from "./constants.js";
+export * from "./enums.js";
+export * from "./feature-flags.js";
+export * from "./ids.js";
+export * from "./roles.js";
+export * from "./schemas.js";
+export * from "./theme.js";
+export * from "./updates.js";
+export * from "./uploads.js";
+export * from "./utils.js";
+export * from "./web-routes.js";

package/dist/src/roles.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export declare const userRoles: readonly ["admin"];
+export declare const UserRole: z.ZodEnum<{
+    admin: "admin";
+}>;
+export type UserRole = z.infer<typeof UserRole>;

package/dist/src/roles.js

@@ -0,0 +1,17 @@
+// =============================================================================
+// USER ROLES - Constants Only
+// =============================================================================
+// Shared role string constants to avoid typos between mobile and server.
+//
+// IMPORTANT: Role checking logic is NOT shared. Each platform has its own:
+// - Server: adminProcedure in trpc.ts checks ctx.auth (validated by Descope SDK)
+// - Mobile: decodes JWT for UI only (not a security boundary)
+//
+// Descope setup required:
+// 1. Create "admin" role in Descope dashboard
+// 2. Assign role to admin users
+// 3. Role appears in JWT claims under "roles" array
+// =============================================================================
+import { z } from "zod";
+export const userRoles = ["admin"];
+export const UserRole = z.enum(userRoles);

package/dist/src/schemas.d.ts

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { DayOfWeek } from "./enums.js";
+export declare const TINY_TEXT_MAX = 50;
+export declare const SHORT_TEXT_MAX = 100;
+export declare const LONG_TEXT_MAX = 2000;
+export declare const MEALS_PER_DAY_MIN = 1;
+export declare const MEALS_PER_DAY_MAX = 10;
+export declare const ShortText: z.ZodString;
+export declare const TinyText: z.ZodString;
+export declare const LongText: z.ZodString;
+export declare const AmountUnit: z.ZodString;
+export declare const Subtype: z.ZodString;
+export declare const PetColor: z.ZodString;
+export declare const Breed: z.ZodString;
+export declare const MicrochipId: z.ZodString;
+export declare const RabiesTagNumber: z.ZodString;
+export declare const InsuranceProvider: z.ZodString;
+export declare const InsurancePolicyNumber: z.ZodString;
+export declare const DURATION_MIN_MIN = 1;
+export declare const DURATION_MIN_MAX = 1440;
+export declare const DurationMin: z.ZodNumber;
+export declare const Amount: z.ZodNumber;
+export declare const CAPTION_MAX = 250;
+export declare const Caption: z.ZodString;
+export declare const HealthValue: z.ZodNumber;
+export declare const HealthUnit: z.ZodString;
+export declare const Title: z.ZodString;
+export declare const VetName: z.ZodString;
+export declare const Location: z.ZodString;
+/**
+ * Name field for pets, users, etc.
+ *
+ * Restricts to safe characters to prevent XSS in contexts like email templates
+ * where names are interpolated. Allows unicode letters (\p{L}) for international
+ * names (José, 北京, Мария) while blocking HTML-unsafe characters like < >.
+ */
+export declare const Name: z.ZodString;
+export declare const Notes: z.ZodString;
+export declare const bathroomActivitySubtypes: readonly ["pee", "poo"];
+export declare const BathroomActivitySubtype: z.ZodEnum<{
+    pee: "pee";
+    poo: "poo";
+}>;
+export type BathroomActivitySubtype = z.infer<typeof BathroomActivitySubtype>;
+/**
+ * URL for images (pet photos, avatars, etc.)
+ *
+ * Restricted to HTTPS only to prevent XSS via javascript:, data:, or file:// URLs
+ * if the URL is ever rendered in an <img src> or <a href> context.
+ */
+export declare const ImageUrl: z.ZodURL;
+export declare const DateField: z.ZodCoercedDate<unknown>;
+export declare const MealsPerDay: z.ZodNumber;
+export declare const PAGINATION_LIMIT_MIN = 1;
+export declare const PAGINATION_LIMIT_MAX = 50;
+export declare const PAGINATION_LIMIT_DEFAULT = 20;
+export declare const PaginationLimit: z.ZodDefault<z.ZodNumber>;
+export declare const MOOD_MIN = 1;
+export declare const MOOD_MAX = 5;
+export declare const Mood: z.ZodNumber;
+/**
+ * Time of day in HH:MM format (24-hour).
+ *
+ * Examples: "08:00", "14:30", "23:59"
+ * Used for reminder schedules. The mobile app interprets this in the device's timezone.
+ */
+export declare const Time: z.ZodString;
+/**
+ * Day of month (1-31).
+ *
+ * Used for monthly reminders. Values 29-31 may not exist in all months;
+ * the scheduler should handle this (e.g., Feb 30 becomes Feb 28).
+ */
+export declare const DAY_OF_MONTH_MIN = 1;
+export declare const DAY_OF_MONTH_MAX = 31;
+export declare const DayOfMonth: z.ZodNumber;
+/**
+ * Interval count for recurring reminders.
+ *
+ * "Every N days/weeks/months" - N is the interval count.
+ * Minimum 1 (every day/week/month), no maximum because it depends on user needs and allows flexibility like 45 days.
+ */
+export declare const INTERVAL_COUNT_MIN = 1;
+export declare const IntervalCount: z.ZodNumber;
+/**
+ * Maps DayOfWeek enum values to JavaScript Date.getDay() values (0 = Sunday).
+ */
+export declare const DAY_OF_WEEK_TO_NUMBER: Record<DayOfWeek, 0 | 1 | 2 | 3 | 4 | 5 | 6>;
+/**
+ * Year for pet dates (birthday, adoption).
+ *
+ * Range: 1990-2100. Pets born before 1990 are extremely rare (35+ years old).
+ * Upper bound leaves room for future dates (adoption planned for next year).
+ */
+export declare const YEAR_MIN = 1990;
+export declare const YEAR_MAX = 2100;
+export declare const YearInt: z.ZodNumber;
+/**
+ * Month (1-12).
+ */
+export declare const MONTH_MIN = 1;
+export declare const MONTH_MAX = 12;
+export declare const MonthInt: z.ZodNumber;
+/**
+ * Format a pet date with variable precision.
+ *
+ * @example
+ * formatPetDate(2020) // "2020"
+ * formatPetDate(2020, 3) // "March 2020"
+ * formatPetDate(2020, 3, 15) // "March 15, 2020"
+ */
+export declare function formatPetDate(year: number, month?: number | null, day?: number | null): string;