@tbs-fitness/contract 0.3.0 → 0.5.0

package/README.md

@@ -11,6 +11,7 @@ It is published as `@tbs-fitness/contract`. The package holds definitions only:
 | `@tbs-fitness/contract/enums`         | `ROLES`, `ACCOUNT_STATUSES`, `TOKEN_TRANSPORTS`, `AUDIT_OUTCOMES`, `APP_ENVIRONMENTS`, `FEATURE_FLAG_RULE_TYPES` and their types |
 | `@tbs-fitness/contract/common`        | Pagination, response envelopes (`{ data }`, `{ data, meta }`, `{ error }`), `emailSchema`, `phoneSchema`, `safeTextSchema`       |
 | `@tbs-fitness/contract/auth`          | Login, sessions, password changes and resets, account administration                                                             |
+| `@tbs-fitness/contract/client`        | Client sign-up, one-time code verification and resend, client sign-in and profile, password recovery                             |
 | `@tbs-fitness/contract/coach`         | Coach sign-up, one-time code verification and resend, coach sign-in and profile, password recovery                               |
 | `@tbs-fitness/contract/audit`         | The audit log query and response                                                                                                 |
 | `@tbs-fitness/contract/feature-flags` | Feature flag requests and responses                                                                                              |
@@ -41,6 +42,26 @@ const result = createFlagSchema.safeParse(input); // The same rules as the API.
 
 Requests have two types. Clients use `*Input`, where fields with a default are optional. The backend uses `*Body`, which is the result after validation. List queries come from the URL as strings, so they have no `*Input`: use `Partial<PaginationQuery>` or `Partial<AuditLogQuery>`.
 
+## Version 0.5.0 (breaking)
+
+- `ROLES` is now `ADMIN`, `COACH` and `CLIENT`: `CUSTOMER` is renamed to `CLIENT`. The backend migrates stored roles in step.
+- `FEATURE_FLAG_RULE_TYPES` renames `customer` to `client`, and `createRuleSchema` accepts `ruleType: 'client'`.
+- New `/client`: `clientSignupSchema` (`fullName`, `email`, `password`, optional detected `timezone`), `clientLoginSchema` (body transport by default, for the mobile app), `clientProfileSchema` and `clientLoginResponseSchema`.
+- The one-time code and recovery schemas (`otpEmailSchema`, `verifyOtpSchema`, `resetPasswordSchema`, `otpDispatchResponseSchema`, `signupVerifiedResponseSchema`, `resetTokenResponseSchema`) now live in `/auth`. `/coach` and `/client` re-export them, so existing imports keep working.
+
+Consumers install `^0.5.0` explicitly, and deploy the backend first.
+
+## Version 0.4.0
+
+Communication and runtime settings. Additive; consumers install `^0.4.0` explicitly.
+
+- `/enums`: `COMMUNICATION_CHANNELS` (`EMAIL`, `SMS`), `MESSAGE_TYPES`, `DELIVERY_STATUSES` and `TEMPLATE_STATUSES`.
+- New `/communication`:
+  - `MESSAGE_CATALOGUE`: per message type, the channels that may carry it, the default switches, and the variables its sender supplies, with the required ones.
+  - `templatePlaceholders`, `hasMalformedPlaceholder` and `templateProblems`, the template rules shared by the server and the admin editor.
+  - `createTemplateSchema`, `templateResponseSchema`, `previewTemplateSchema`, `renderedMessageSchema`, `testSendResponseSchema` and `messageTypeResponseSchema`.
+- New `/app-settings`: `APP_SETTING_KEYS`, a value schema and default per key (`communication.channels` master switches, `communication.messages` per type and channel), plus `appSettingResponseSchema`, `updateAppSettingSchema` (`{ value, version }`) and `appSettingHistoryResponseSchema`.
+
 ## Version 0.3.0
 
 Time zones and the platform's date and time rules. Additive, but a caret range on 0.x does not cross minor versions, so consumers install `^0.3.0` explicitly.

package/dist/cjs/app-settings/app-settings.dto.d.ts

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { type MessageType } from '../enums/index.js';
+/**
+ * Runtime settings an administrator changes without a deploy. Each key has a
+ * value schema here, which both the server and the admin screen use. A key
+ * with no saved value uses its default.
+ */
+export declare const APP_SETTING_KEYS: readonly ["communication.channels", "communication.messages"];
+export type AppSettingKey = (typeof APP_SETTING_KEYS)[number];
+/** A switch per channel. */
+export declare const channelSwitchesSchema: z.ZodObject<{
+    EMAIL: z.ZodBoolean;
+    SMS: z.ZodBoolean;
+}, z.core.$strict>;
+export type ChannelSwitches = z.output<typeof channelSwitchesSchema>;
+/**
+ * Master switches: a channel switched off here sends nothing, whatever the
+ * per-message settings say.
+ */
+export declare const communicationChannelsSettingSchema: z.ZodObject<{
+    EMAIL: z.ZodBoolean;
+    SMS: z.ZodBoolean;
+}, z.core.$strict>;
+/**
+ * Per message type and channel. A type missing from a saved value uses its
+ * catalogue defaults, so a newly added message type needs no data change.
+ */
+export declare const communicationMessagesSettingSchema: z.ZodRecord<z.ZodEnum<{
+    "auth.otp.signup_verification": "auth.otp.signup_verification";
+    "auth.otp.password_reset": "auth.otp.password_reset";
+    "auth.password_reset_link": "auth.password_reset_link";
+}> & z.core.$partial, z.ZodObject<{
+    EMAIL: z.ZodBoolean;
+    SMS: z.ZodBoolean;
+}, z.core.$strict>>;
+export type CommunicationMessagesSetting = z.output<typeof communicationMessagesSettingSchema>;
+export declare const APP_SETTING_VALUE_SCHEMAS: {
+    readonly 'communication.channels': z.ZodObject<{
+        EMAIL: z.ZodBoolean;
+        SMS: z.ZodBoolean;
+    }, z.core.$strict>;
+    readonly 'communication.messages': z.ZodRecord<z.ZodEnum<{
+        "auth.otp.signup_verification": "auth.otp.signup_verification";
+        "auth.otp.password_reset": "auth.otp.password_reset";
+        "auth.password_reset_link": "auth.password_reset_link";
+    }> & z.core.$partial, z.ZodObject<{
+        EMAIL: z.ZodBoolean;
+        SMS: z.ZodBoolean;
+    }, z.core.$strict>>;
+};
+export interface AppSettingValues {
+    'communication.channels': ChannelSwitches;
+    'communication.messages': CommunicationMessagesSetting;
+}
+/** Every message type, with its catalogue defaults: the effective value with nothing saved. */
+export declare function defaultMessageSettings(): Record<MessageType, ChannelSwitches>;
+export declare const APP_SETTING_DEFAULTS: AppSettingValues;
+export declare const appSettingKeyParamSchema: z.ZodEnum<{
+    "communication.channels": "communication.channels";
+    "communication.messages": "communication.messages";
+}>;
+export declare const appSettingResponseSchema: z.ZodObject<{
+    key: z.ZodEnum<{
+        "communication.channels": "communication.channels";
+        "communication.messages": "communication.messages";
+    }>;
+    label: z.ZodString;
+    description: z.ZodString;
+    value: z.ZodUnknown;
+    defaultValue: z.ZodUnknown;
+    version: z.ZodNumber;
+    updatedBy: z.ZodNullable<z.ZodUUID>;
+    updatedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type AppSettingResponse = z.output<typeof appSettingResponseSchema>;
+export declare const appSettingListResponseSchema: z.ZodArray<z.ZodObject<{
+    key: z.ZodEnum<{
+        "communication.channels": "communication.channels";
+        "communication.messages": "communication.messages";
+    }>;
+    label: z.ZodString;
+    description: z.ZodString;
+    value: z.ZodUnknown;
+    defaultValue: z.ZodUnknown;
+    version: z.ZodNumber;
+    updatedBy: z.ZodNullable<z.ZodUUID>;
+    updatedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>>;
+/**
+ * Replaces a setting's value. `version` must be the one last read, so a
+ * change made in between is not silently overwritten. The value is checked
+ * against the key's schema on the server.
+ */
+export declare const updateAppSettingSchema: z.ZodObject<{
+    value: z.ZodUnknown;
+    version: z.ZodNumber;
+}, z.core.$strict>;
+export type UpdateAppSettingInput = z.input<typeof updateAppSettingSchema>;
+export type UpdateAppSettingBody = z.output<typeof updateAppSettingSchema>;
+export declare const appSettingHistoryEntrySchema: z.ZodObject<{
+    id: z.ZodUUID;
+    key: z.ZodEnum<{
+        "communication.channels": "communication.channels";
+        "communication.messages": "communication.messages";
+    }>;
+    previousValue: z.ZodUnknown;
+    newValue: z.ZodUnknown;
+    version: z.ZodNumber;
+    actorUserId: z.ZodUUID;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type AppSettingHistoryEntry = z.output<typeof appSettingHistoryEntrySchema>;
+export declare const appSettingHistoryResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodUUID;
+    key: z.ZodEnum<{
+        "communication.channels": "communication.channels";
+        "communication.messages": "communication.messages";
+    }>;
+    previousValue: z.ZodUnknown;
+    newValue: z.ZodUnknown;
+    version: z.ZodNumber;
+    actorUserId: z.ZodUUID;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>>;

package/dist/cjs/app-settings/app-settings.dto.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appSettingHistoryResponseSchema = exports.appSettingHistoryEntrySchema = exports.updateAppSettingSchema = exports.appSettingListResponseSchema = exports.appSettingResponseSchema = exports.appSettingKeyParamSchema = exports.APP_SETTING_DEFAULTS = exports.APP_SETTING_VALUE_SCHEMAS = exports.communicationMessagesSettingSchema = exports.communicationChannelsSettingSchema = exports.channelSwitchesSchema = exports.APP_SETTING_KEYS = void 0;
+exports.defaultMessageSettings = defaultMessageSettings;
+const zod_1 = require("zod");
+const date_time_schema_js_1 = require("../common/date-time.schema.js");
+const message_catalogue_js_1 = require("../communication/message-catalogue.js");
+const index_js_1 = require("../enums/index.js");
+/**
+ * Runtime settings an administrator changes without a deploy. Each key has a
+ * value schema here, which both the server and the admin screen use. A key
+ * with no saved value uses its default.
+ */
+exports.APP_SETTING_KEYS = [
+    'communication.channels',
+    'communication.messages',
+];
+/** A switch per channel. */
+exports.channelSwitchesSchema = zod_1.z.strictObject({
+    EMAIL: zod_1.z.boolean(),
+    SMS: zod_1.z.boolean(),
+});
+/**
+ * Master switches: a channel switched off here sends nothing, whatever the
+ * per-message settings say.
+ */
+exports.communicationChannelsSettingSchema = exports.channelSwitchesSchema;
+/**
+ * Per message type and channel. A type missing from a saved value uses its
+ * catalogue defaults, so a newly added message type needs no data change.
+ */
+exports.communicationMessagesSettingSchema = zod_1.z
+    .partialRecord(zod_1.z.enum(index_js_1.MESSAGE_TYPES), exports.channelSwitchesSchema)
+    .superRefine((value, ctx) => {
+    for (const [type, switches] of Object.entries(value)) {
+        const allowed = message_catalogue_js_1.MESSAGE_CATALOGUE[type].channels;
+        for (const [channel, on] of Object.entries(switches ?? {})) {
+            if (on && !allowed.includes(channel)) {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: [type, channel],
+                    message: `${message_catalogue_js_1.MESSAGE_CATALOGUE[type].label} cannot be sent by ${channel}`,
+                });
+            }
+        }
+    }
+});
+exports.APP_SETTING_VALUE_SCHEMAS = {
+    'communication.channels': exports.communicationChannelsSettingSchema,
+    'communication.messages': exports.communicationMessagesSettingSchema,
+};
+/** Every message type, with its catalogue defaults: the effective value with nothing saved. */
+function defaultMessageSettings() {
+    return Object.fromEntries(index_js_1.MESSAGE_TYPES.map((type) => [
+        type,
+        { ...message_catalogue_js_1.MESSAGE_CATALOGUE[type].defaultChannels },
+    ]));
+}
+exports.APP_SETTING_DEFAULTS = {
+    'communication.channels': { EMAIL: true, SMS: true },
+    'communication.messages': defaultMessageSettings(),
+};
+exports.appSettingKeyParamSchema = zod_1.z.enum(exports.APP_SETTING_KEYS);
+exports.appSettingResponseSchema = zod_1.z.object({
+    key: zod_1.z.enum(exports.APP_SETTING_KEYS),
+    label: zod_1.z.string(),
+    description: zod_1.z.string(),
+    value: zod_1.z.unknown(),
+    defaultValue: zod_1.z.unknown(),
+    /** 0 until the setting is first saved. Send it back to update. */
+    version: zod_1.z.number().int(),
+    updatedBy: zod_1.z.uuid().nullable(),
+    updatedAt: date_time_schema_js_1.utcTimestampSchema.nullable(),
+});
+exports.appSettingListResponseSchema = zod_1.z.array(exports.appSettingResponseSchema);
+/**
+ * Replaces a setting's value. `version` must be the one last read, so a
+ * change made in between is not silently overwritten. The value is checked
+ * against the key's schema on the server.
+ */
+exports.updateAppSettingSchema = zod_1.z.strictObject({
+    value: zod_1.z.unknown(),
+    version: zod_1.z.number().int().min(0),
+});
+exports.appSettingHistoryEntrySchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    key: zod_1.z.enum(exports.APP_SETTING_KEYS),
+    previousValue: zod_1.z.unknown(),
+    newValue: zod_1.z.unknown(),
+    version: zod_1.z.number().int(),
+    actorUserId: zod_1.z.uuid(),
+    createdAt: date_time_schema_js_1.utcTimestampSchema,
+});
+exports.appSettingHistoryResponseSchema = zod_1.z.array(exports.appSettingHistoryEntrySchema);

package/dist/cjs/app-settings/index.d.ts

@@ -0,0 +1 @@
+export * from './app-settings.dto.js';

package/dist/cjs/app-settings/index.js

@@ -0,0 +1,17 @@
+"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("./app-settings.dto.js"), exports);

package/dist/cjs/auth/auth.dto.d.ts

@@ -45,7 +45,7 @@ export declare const setRoleSchema: z.ZodObject<{
     role: z.ZodEnum<{
         ADMIN: "ADMIN";
         COACH: "COACH";
-        CUSTOMER: "CUSTOMER";
+        CLIENT: "CLIENT";
     }>;
 }, z.core.$strict>;
 export type SetRoleInput = z.input<typeof setRoleSchema>;
@@ -100,7 +100,7 @@ export declare const accountResponseSchema: z.ZodObject<{
     role: z.ZodEnum<{
         ADMIN: "ADMIN";
         COACH: "COACH";
-        CUSTOMER: "CUSTOMER";
+        CLIENT: "CLIENT";
     }>;
     roles: z.ZodArray<z.ZodString>;
     permissions: z.ZodArray<z.ZodString>;
@@ -125,7 +125,7 @@ export declare const loginResponseSchema: z.ZodObject<{
         role: z.ZodEnum<{
             ADMIN: "ADMIN";
             COACH: "COACH";
-            CUSTOMER: "CUSTOMER";
+            CLIENT: "CLIENT";
         }>;
         roles: z.ZodArray<z.ZodString>;
         permissions: z.ZodArray<z.ZodString>;
@@ -162,7 +162,7 @@ export declare const adminAccountResponseSchema: z.ZodObject<{
     role: z.ZodEnum<{
         ADMIN: "ADMIN";
         COACH: "COACH";
-        CUSTOMER: "CUSTOMER";
+        CLIENT: "CLIENT";
     }>;
     status: z.ZodEnum<{
         pending_verification: "pending_verification";

package/dist/cjs/auth/index.d.ts

@@ -1 +1,2 @@
 export * from './auth.dto.js';
+export * from './otp.dto.js';

package/dist/cjs/auth/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./auth.dto.js"), exports);
+__exportStar(require("./otp.dto.js"), exports);

package/dist/cjs/auth/otp.dto.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+/**
+ * One-time code and password recovery shapes shared by every role's sign-up
+ * and recovery routes. `/coach` and `/client` re-export them.
+ */
+/** Used by both resend endpoints and by forgot-password. */
+export declare const otpEmailSchema: z.ZodObject<{
+    email: z.ZodPipe<z.ZodString, z.ZodEmail>;
+}, z.core.$strict>;
+export type OtpEmailInput = z.input<typeof otpEmailSchema>;
+export type OtpEmailBody = z.output<typeof otpEmailSchema>;
+export declare const verifyOtpSchema: z.ZodObject<{
+    email: z.ZodPipe<z.ZodString, z.ZodEmail>;
+    code: z.ZodString;
+}, z.core.$strict>;
+export type VerifyOtpInput = z.input<typeof verifyOtpSchema>;
+export type VerifyOtpBody = z.output<typeof verifyOtpSchema>;
+export declare const resetPasswordSchema: z.ZodObject<{
+    resetToken: z.ZodString;
+    newPassword: z.ZodString;
+}, z.core.$strict>;
+export type ResetPasswordInput = z.input<typeof resetPasswordSchema>;
+export type ResetPasswordBody = z.output<typeof resetPasswordSchema>;
+/**
+ * Says what the client needs to drive the code screen, and nothing about
+ * whether the email belongs to an account: the same values are returned either
+ * way.
+ */
+export declare const otpDispatchResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    otpLength: z.ZodNumber;
+    expiresInSeconds: z.ZodNumber;
+    resendAvailableInSeconds: z.ZodNumber;
+}, z.core.$strip>;
+export type OtpDispatchResponse = z.output<typeof otpDispatchResponseSchema>;
+export declare const signupVerifiedResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strip>;
+export type SignupVerifiedResponse = z.output<typeof signupVerifiedResponseSchema>;
+/** Issued only after a recovery code is verified. It can reset a password once. */
+export declare const resetTokenResponseSchema: z.ZodObject<{
+    resetToken: z.ZodString;
+    expiresInSeconds: z.ZodNumber;
+}, z.core.$strip>;
+export type ResetTokenResponse = z.output<typeof resetTokenResponseSchema>;

package/dist/cjs/auth/otp.dto.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetTokenResponseSchema = exports.signupVerifiedResponseSchema = exports.otpDispatchResponseSchema = exports.resetPasswordSchema = exports.verifyOtpSchema = exports.otpEmailSchema = void 0;
+const zod_1 = require("zod");
+const contact_schema_js_1 = require("../common/contact.schema.js");
+const auth_dto_js_1 = require("./auth.dto.js");
+/**
+ * One-time code and password recovery shapes shared by every role's sign-up
+ * and recovery routes. `/coach` and `/client` re-export them.
+ */
+/** Used by both resend endpoints and by forgot-password. */
+exports.otpEmailSchema = zod_1.z.strictObject({ email: contact_schema_js_1.emailSchema });
+exports.verifyOtpSchema = zod_1.z.strictObject({
+    email: contact_schema_js_1.emailSchema,
+    code: auth_dto_js_1.otpCodeSchema,
+});
+exports.resetPasswordSchema = zod_1.z.strictObject({
+    resetToken: auth_dto_js_1.opaqueTokenSchema,
+    newPassword: auth_dto_js_1.newPasswordSchema,
+});
+/**
+ * Says what the client needs to drive the code screen, and nothing about
+ * whether the email belongs to an account: the same values are returned either
+ * way.
+ */
+exports.otpDispatchResponseSchema = zod_1.z.object({
+    message: zod_1.z.string(),
+    otpLength: zod_1.z.number().int(),
+    expiresInSeconds: zod_1.z.number().int(),
+    resendAvailableInSeconds: zod_1.z.number().int(),
+});
+exports.signupVerifiedResponseSchema = zod_1.z.object({
+    message: zod_1.z.string(),
+});
+/** Issued only after a recovery code is verified. It can reset a password once. */
+exports.resetTokenResponseSchema = zod_1.z.object({
+    resetToken: zod_1.z.string(),
+    expiresInSeconds: zod_1.z.number().int(),
+});

package/dist/cjs/client/client-auth.dto.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+/**
+ * Client self sign-up: a name, an email address and a password. The account
+ * cannot sign in until the emailed code is verified.
+ */
+export declare const clientSignupSchema: z.ZodObject<{
+    fullName: z.ZodPipe<z.ZodString, z.ZodString>;
+    email: z.ZodPipe<z.ZodString, z.ZodEmail>;
+    password: z.ZodString;
+    timezone: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<string | undefined, unknown>>>;
+}, z.core.$strict>;
+export type ClientSignupInput = z.input<typeof clientSignupSchema>;
+export type ClientSignupBody = z.output<typeof clientSignupSchema>;
+/**
+ * Clients sign in from the mobile app, so the refresh token comes back in the
+ * body by default. A browser sends `tokenTransport: "cookie"` instead, and
+ * `rememberMe: false` then makes the cookie end with the browser session.
+ */
+export declare const clientLoginSchema: z.ZodObject<{
+    email: z.ZodPipe<z.ZodString, z.ZodEmail>;
+    password: z.ZodString;
+    deviceName: z.ZodOptional<z.ZodString>;
+    tokenTransport: z.ZodDefault<z.ZodEnum<{
+        body: "body";
+        cookie: "cookie";
+    }>>;
+    rememberMe: z.ZodDefault<z.ZodBoolean>;
+    timezone: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodTransform<string | undefined, unknown>>>;
+}, z.core.$strict>;
+export type ClientLoginInput = z.input<typeof clientLoginSchema>;
+export type ClientLoginBody = z.output<typeof clientLoginSchema>;
+export declare const clientProfileSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    email: z.ZodString;
+    fullName: z.ZodNullable<z.ZodString>;
+    phone: z.ZodNullable<z.ZodString>;
+    role: z.ZodLiteral<"CLIENT">;
+    status: z.ZodEnum<{
+        pending_verification: "pending_verification";
+        active: "active";
+        disabled: "disabled";
+    }>;
+    emailVerifiedAt: z.ZodNullable<z.ZodISODateTime>;
+    lastLoginAt: z.ZodNullable<z.ZodISODateTime>;
+    createdAt: z.ZodISODateTime;
+    timezone: z.ZodString;
+    timezoneSource: z.ZodEnum<{
+        AUTO: "AUTO";
+        MANUAL: "MANUAL";
+    }>;
+}, z.core.$strip>;
+export type ClientProfile = z.output<typeof clientProfileSchema>;
+export declare const clientLoginResponseSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    tokenType: z.ZodLiteral<"Bearer">;
+    expiresInSeconds: z.ZodNumber;
+    refreshToken: z.ZodOptional<z.ZodString>;
+    csrfToken: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodUUID;
+    client: z.ZodObject<{
+        id: z.ZodUUID;
+        email: z.ZodString;
+        fullName: z.ZodNullable<z.ZodString>;
+        phone: z.ZodNullable<z.ZodString>;
+        role: z.ZodLiteral<"CLIENT">;
+        status: z.ZodEnum<{
+            pending_verification: "pending_verification";
+            active: "active";
+            disabled: "disabled";
+        }>;
+        emailVerifiedAt: z.ZodNullable<z.ZodISODateTime>;
+        lastLoginAt: z.ZodNullable<z.ZodISODateTime>;
+        createdAt: z.ZodISODateTime;
+        timezone: z.ZodString;
+        timezoneSource: z.ZodEnum<{
+            AUTO: "AUTO";
+            MANUAL: "MANUAL";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ClientLoginResponse = z.output<typeof clientLoginResponseSchema>;

package/dist/cjs/client/client-auth.dto.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientLoginResponseSchema = exports.clientProfileSchema = exports.clientLoginSchema = exports.clientSignupSchema = void 0;
+const zod_1 = require("zod");
+const auth_dto_js_1 = require("../auth/auth.dto.js");
+const contact_schema_js_1 = require("../common/contact.schema.js");
+const date_time_schema_js_1 = require("../common/date-time.schema.js");
+const safe_text_schema_js_1 = require("../common/safe-text.schema.js");
+const index_js_1 = require("../enums/index.js");
+/**
+ * Client self sign-up: a name, an email address and a password. The account
+ * cannot sign in until the emailed code is verified.
+ */
+exports.clientSignupSchema = zod_1.z.strictObject({
+    fullName: (0, safe_text_schema_js_1.safeTextSchema)(100).pipe(zod_1.z.string().min(2, { error: 'Enter your full name' })),
+    email: contact_schema_js_1.emailSchema,
+    password: auth_dto_js_1.newPasswordSchema,
+    /** The device's time zone. Missing or unusable becomes UTC on the server. */
+    timezone: date_time_schema_js_1.detectedTimezoneSchema,
+});
+/**
+ * Clients sign in from the mobile app, so the refresh token comes back in the
+ * body by default. A browser sends `tokenTransport: "cookie"` instead, and
+ * `rememberMe: false` then makes the cookie end with the browser session.
+ */
+exports.clientLoginSchema = auth_dto_js_1.loginSchema.extend({
+    rememberMe: zod_1.z.boolean().default(true),
+    /**
+     * The device's time zone. It replaces the saved one only while the client's
+     * preference is `AUTO`; a manual choice is never overwritten.
+     */
+    timezone: date_time_schema_js_1.detectedTimezoneSchema,
+});
+exports.clientProfileSchema = zod_1.z
+    .object({
+    id: zod_1.z.uuid(),
+    email: zod_1.z.string(),
+    fullName: zod_1.z.string().nullable(),
+    phone: zod_1.z.string().nullable(),
+    role: zod_1.z.literal('CLIENT'),
+    status: zod_1.z.enum(index_js_1.ACCOUNT_STATUSES),
+    emailVerifiedAt: date_time_schema_js_1.utcTimestampSchema.nullable(),
+    lastLoginAt: date_time_schema_js_1.utcTimestampSchema.nullable(),
+    createdAt: date_time_schema_js_1.utcTimestampSchema,
+})
+    .extend(auth_dto_js_1.timezonePreferenceSchema.shape);
+exports.clientLoginResponseSchema = auth_dto_js_1.tokenResponseSchema.extend({
+    client: exports.clientProfileSchema,
+});

package/dist/cjs/client/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../auth/otp.dto.js';
+export * from './client-auth.dto.js';

package/dist/cjs/client/index.js

@@ -0,0 +1,18 @@
+"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("../auth/otp.dto.js"), exports);
+__exportStar(require("./client-auth.dto.js"), exports);

package/dist/cjs/coach/coach-auth.dto.d.ts

@@ -8,18 +8,6 @@ export declare const coachSignupSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type CoachSignupInput = z.input<typeof coachSignupSchema>;
 export type CoachSignupBody = z.output<typeof coachSignupSchema>;
-/** Used by both resend endpoints and by forgot-password. */
-export declare const otpEmailSchema: z.ZodObject<{
-    email: z.ZodPipe<z.ZodString, z.ZodEmail>;
-}, z.core.$strict>;
-export type OtpEmailInput = z.input<typeof otpEmailSchema>;
-export type OtpEmailBody = z.output<typeof otpEmailSchema>;
-export declare const verifyOtpSchema: z.ZodObject<{
-    email: z.ZodPipe<z.ZodString, z.ZodEmail>;
-    code: z.ZodString;
-}, z.core.$strict>;
-export type VerifyOtpInput = z.input<typeof verifyOtpSchema>;
-export type VerifyOtpBody = z.output<typeof verifyOtpSchema>;
 /**
  * Coaches sign in from the browser, so the refresh token always travels in an
  * HttpOnly cookie. `rememberMe: false` makes that cookie end with the browser
@@ -34,34 +22,6 @@ export declare const coachLoginSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type CoachLoginInput = z.input<typeof coachLoginSchema>;
 export type CoachLoginBody = z.output<typeof coachLoginSchema>;
-export declare const resetPasswordSchema: z.ZodObject<{
-    resetToken: z.ZodString;
-    newPassword: z.ZodString;
-}, z.core.$strict>;
-export type ResetPasswordInput = z.input<typeof resetPasswordSchema>;
-export type ResetPasswordBody = z.output<typeof resetPasswordSchema>;
-/**
- * Says what the client needs to drive the code screen, and nothing about
- * whether the email belongs to an account: the same values are returned either
- * way.
- */
-export declare const otpDispatchResponseSchema: z.ZodObject<{
-    message: z.ZodString;
-    otpLength: z.ZodNumber;
-    expiresInSeconds: z.ZodNumber;
-    resendAvailableInSeconds: z.ZodNumber;
-}, z.core.$strip>;
-export type OtpDispatchResponse = z.output<typeof otpDispatchResponseSchema>;
-export declare const signupVerifiedResponseSchema: z.ZodObject<{
-    message: z.ZodString;
-}, z.core.$strip>;
-export type SignupVerifiedResponse = z.output<typeof signupVerifiedResponseSchema>;
-/** Issued only after a recovery code is verified. It can reset a password once. */
-export declare const resetTokenResponseSchema: z.ZodObject<{
-    resetToken: z.ZodString;
-    expiresInSeconds: z.ZodNumber;
-}, z.core.$strip>;
-export type ResetTokenResponse = z.output<typeof resetTokenResponseSchema>;
 export declare const coachProfileSchema: z.ZodObject<{
     id: z.ZodUUID;
     email: z.ZodString;