founder-schema 0.4.0 → 0.6.0

package/dist/domains/profile/founder-profile.d.ts

@@ -56,6 +56,39 @@ export declare const ventureSchema: z.ZodObject<{
     foundedYear: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type Venture = z.infer<typeof ventureSchema>;
+/**
+ * A member as a byline renders them: on a post (`feedAuthorSchema` is this), a
+ * product's team, a review, a notification, the top-helpers list.
+ *
+ * Every field is LIVE, joined against the profile at read time rather than
+ * frozen onto the post or review at write time. So a renamed handle, a new
+ * photo or an edited headline updates everywhere, the link always targets the
+ * current username, and nothing personal survives in other people's rows once
+ * an account is deleted.
+ */
+export declare const memberBylineSchema: z.ZodObject<{
+    userId: z.ZodString;
+    username: z.ZodString;
+    displayName: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    headline: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemberByline = z.infer<typeof memberBylineSchema>;
+/**
+ * What a member has given the community, on their profile and card.
+ *
+ * `score` is points earned from OTHER members' recognition only: a product's
+ * team marking your feedback helpful, confirming you tested their product,
+ * members finding your review helpful, and writing reviews. Nothing a member
+ * does to their own product counts, so the score cannot be bought by having a
+ * popular one. `helpedCount` is how many different founders recognised that
+ * help ("Helped 12 founders"). See `domains/contributions`.
+ */
+export declare const contributionSummarySchema: z.ZodObject<{
+    score: z.ZodNumber;
+    helpedCount: z.ZodNumber;
+}, z.core.$strip>;
+export type ContributionSummary = z.infer<typeof contributionSummarySchema>;
 /**
  * The founder's off-platform links. ONE shape: onboarding's contact step picks
  * its three from this, so a link one side knows can never be missing on the
@@ -86,6 +119,18 @@ export declare const founderProfileSchema: z.ZodObject<{
     headline: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
     about: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
     avatarUrl: z.ZodOptional<z.ZodURL>;
+    avatar: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodURL;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        variants: z.ZodArray<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            url: z.ZodURL;
+        }, z.core.$strip>>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     location: z.ZodOptional<z.ZodObject<{
         city: z.ZodString;
         state: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
@@ -168,6 +213,10 @@ export declare const founderProfileSchema: z.ZodObject<{
         github: z.ZodOptional<z.ZodURL>;
         website: z.ZodOptional<z.ZodURL>;
     }, z.core.$strip>>;
+    contribution: z.ZodObject<{
+        score: z.ZodNumber;
+        helpedCount: z.ZodNumber;
+    }, z.core.$strip>;
     isOnboarded: z.ZodDefault<z.ZodBoolean>;
     isActive: z.ZodDefault<z.ZodBoolean>;
     createdAt: z.ZodISODateTime;
@@ -189,9 +238,14 @@ export declare const founderCardSchema: z.ZodObject<{
         country: z.ZodString;
     }, z.core.$strip>>;
     displayName: z.ZodString;
+    userId: z.ZodString;
     username: z.ZodString;
     avatarUrl: z.ZodOptional<z.ZodURL>;
     headline: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    contribution: z.ZodObject<{
+        score: z.ZodNumber;
+        helpedCount: z.ZodNumber;
+    }, z.core.$strip>;
     venture: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
         tagline: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
@@ -384,4 +438,16 @@ export declare const usernameAvailabilitySchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type UsernameAvailability = z.infer<typeof usernameAvailabilitySchema>;
+/**
+ * `PUT /api/v1/profiles/me/avatar`: use a completed upload (purpose `avatar`)
+ * as the member's photo. Answers with the updated `founderProfileSchema`.
+ *
+ * The previous photo is deleted from storage, not merely unlinked, so its old
+ * address stops working. `DELETE /api/v1/profiles/me/avatar` removes the photo
+ * the same way and the member falls back to their sign-in provider's picture.
+ */
+export declare const setAvatarBodySchema: z.ZodObject<{
+    mediaId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type SetAvatarBody = z.infer<typeof setAvatarBodySchema>;
 //# sourceMappingURL=founder-profile.d.ts.map

package/dist/domains/profile/founder-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"founder-profile.d.ts","sourceRoot":"","sources":["../../../src/domains/profile/founder-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoC/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAqB5D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;iBAA+C,CAAC;AACrF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,oDAAoD;AACpD,eAAO,MAAM,0BAA0B;;;;;;;iBAKrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"founder-profile.d.ts","sourceRoot":"","sources":["../../../src/domains/profile/founder-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAS7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqD/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgB5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAqB5D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;iBAA+C,CAAC;AACrF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,oDAAoD;AACpD,eAAO,MAAM,0BAA0B;;;;;;;iBAKrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;iBAAwC,CAAC;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/domains/profile/founder-profile.js

@@ -7,9 +7,10 @@
  * @module founder-schema/domains/profile
  */
 import { z } from 'zod';
-import { chosenUsernameSchema, GOAL_VALUES, goalSchema, httpUrlSchema, industrySchema, locationSchema, optionalTrimmedString, skillSchema, startupStageSchema, usernameSchema, } from '../../core/common.js';
+import { chosenUsernameSchema, GOAL_VALUES, goalSchema, httpUrlSchema, industrySchema, locationSchema, objectIdSchema, optionalTrimmedString, skillSchema, startupStageSchema, usernameSchema, } from '../../core/common.js';
 import { ABOUT_MAX, DISPLAY_NAME_MAX, FOUNDED_YEAR_MIN, HEADLINE_MAX, SKILLS_MAX, TEAM_SIZE_MAX, TEAM_SIZE_MIN, VENTURE_NAME_MAX, VENTURE_TAGLINE_MAX, } from '../../core/limits.js';
 import { VALIDATION_MESSAGE } from '../../core/validation.js';
+import { mediaImageSchema } from '../media/media.js';
 // ─── Venture ─────────────────────────────────────────────────────────────────
 /**
  * ⚠ NUMBERS ARE NUMBERS, never coerced. This is a BODY, which arrives as JSON
@@ -46,6 +47,41 @@ export const ventureSchema = z.object({
     })
         .optional(),
 });
+// ─── A member as other surfaces name them ────────────────────────────────────
+/**
+ * A member as a byline renders them: on a post (`feedAuthorSchema` is this), a
+ * product's team, a review, a notification, the top-helpers list.
+ *
+ * Every field is LIVE, joined against the profile at read time rather than
+ * frozen onto the post or review at write time. So a renamed handle, a new
+ * photo or an edited headline updates everywhere, the link always targets the
+ * current username, and nothing personal survives in other people's rows once
+ * an account is deleted.
+ */
+export const memberBylineSchema = z.object({
+    userId: z.string(),
+    username: usernameSchema,
+    displayName: z.string(),
+    /** Server-generated or from the login provider, never member-typed, so a
+     *  plain URL check. Same reasoning as `avatarUrl` on the profile. */
+    avatarUrl: z.url().optional(),
+    /** The member's one-line headline, live-joined. */
+    headline: z.string().optional(),
+});
+/**
+ * What a member has given the community, on their profile and card.
+ *
+ * `score` is points earned from OTHER members' recognition only: a product's
+ * team marking your feedback helpful, confirming you tested their product,
+ * members finding your review helpful, and writing reviews. Nothing a member
+ * does to their own product counts, so the score cannot be bought by having a
+ * popular one. `helpedCount` is how many different founders recognised that
+ * help ("Helped 12 founders"). See `domains/contributions`.
+ */
+export const contributionSummarySchema = z.object({
+    score: z.number().int().nonnegative(),
+    helpedCount: z.number().int().nonnegative(),
+});
 // ─── Profile ─────────────────────────────────────────────────────────────────
 /**
  * The founder's off-platform links. ONE shape: onboarding's contact step picks
@@ -91,13 +127,30 @@ export const founderProfileSchema = z.object({
      * `user.updated` webhook, which carries the Google OAuth picture. If a
      * "paste a link to your photo" control is ever added, this goes back to
      * `httpUrlSchema` and the ruling behind it is void.
+     *
+     * WHICH picture: the member's uploaded photo at its small size (192, see
+     * `MEDIA_SIZES.avatar`), else their sign-in provider's picture, else absent.
+     * Every surface that shows this member resolves it the same way.
      */
     avatarUrl: z.url().optional(),
+    /**
+     * The uploaded photo itself, every size, when the member has one. Absent
+     * means `avatarUrl` (if any) is the sign-in provider's picture, so a client
+     * offers "Remove photo" only when this is present. Not on `founderCardSchema`:
+     * a card needs one small picture, not the set.
+     */
+    avatar: mediaImageSchema.optional(),
     location: locationSchema.optional(),
     venture: ventureSchema.optional(),
     skills: z.array(skillSchema).max(SKILLS_MAX).default([]),
     goals: z.array(goalSchema).max(GOAL_VALUES.length).default([]),
     links: founderLinksSchema.default({}),
+    /**
+     * Their contribution to other founders. Server-computed, never written by a
+     * member. REQUIRED, no default: a read-side default would let a server that
+     * forgot the field pass as a real zero.
+     */
+    contribution: contributionSummarySchema,
     /** Onboarding is finished and the member is visible in Discover. */
     isOnboarded: z.boolean().default(false),
     /** Member paused their own profile. Hidden from Discover, keeps their data. */
@@ -114,6 +167,11 @@ export const founderProfileSchema = z.object({
  */
 export const founderCardSchema = founderProfileSchema.pick({
     id: true,
+    /**
+     * The MEMBER's id (0.6.0): what a team invitation, a chat and every byline
+     * key on. `id` is the profile's own id, which nothing takes as input.
+     */
+    userId: true,
     username: true,
     displayName: true,
     headline: true,
@@ -122,6 +180,7 @@ export const founderCardSchema = founderProfileSchema.pick({
     venture: true,
     skills: true,
     goals: true,
+    contribution: true,
 });
 // ─── Write bodies ────────────────────────────────────────────────────────────
 /**
@@ -177,4 +236,14 @@ export const usernameAvailabilitySchema = z.object({
     /** Present when unavailable: `taken` or `reserved`. */
     reason: z.enum(['taken', 'reserved']).optional(),
 });
+// ─── The member's own photo ──────────────────────────────────────────────────
+/**
+ * `PUT /api/v1/profiles/me/avatar`: use a completed upload (purpose `avatar`)
+ * as the member's photo. Answers with the updated `founderProfileSchema`.
+ *
+ * The previous photo is deleted from storage, not merely unlinked, so its old
+ * address stops working. `DELETE /api/v1/profiles/me/avatar` removes the photo
+ * the same way and the member falls back to their sign-in provider's picture.
+ */
+export const setAvatarBodySchema = z.object({ mediaId: objectIdSchema });
 //# sourceMappingURL=founder-profile.js.map

package/dist/domains/profile/founder-profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"founder-profile.js","sourceRoot":"","sources":["../../../src/domains/profile/founder-profile.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema — The founder profile\n *\n * One member, one profile. The central auth account owns identity (email,\n * verification, deletion); this owns everything Founder Circle shows.\n *\n * @module founder-schema/domains/profile\n */\n\nimport { z } from 'zod';\nimport {\n  chosenUsernameSchema,\n  GOAL_VALUES,\n  goalSchema,\n  httpUrlSchema,\n  industrySchema,\n  locationSchema,\n  optionalTrimmedString,\n  skillSchema,\n  startupStageSchema,\n  usernameSchema,\n} from '../../core/common.js';\nimport {\n  ABOUT_MAX,\n  DISPLAY_NAME_MAX,\n  FOUNDED_YEAR_MIN,\n  HEADLINE_MAX,\n  SKILLS_MAX,\n  TEAM_SIZE_MAX,\n  TEAM_SIZE_MIN,\n  VENTURE_NAME_MAX,\n  VENTURE_TAGLINE_MAX,\n} from '../../core/limits.js';\nimport { VALIDATION_MESSAGE } from '../../core/validation.js';\n\n// ─── Venture ─────────────────────────────────────────────────────────────────\n\n/**\n * ⚠ NUMBERS ARE NUMBERS, never coerced. This is a BODY, which arrives as JSON\n * and already carries types. `z.coerce.number()` here accepted `teamSize: true`\n * as 1 and `\"  \"` as 0, and made the schema's input type `unknown`, so a form\n * typed against it could put anything in the field. Coercion belongs to query\n * strings, where everything is text; a form converts its text input before it\n * builds the body.\n */\nexport const ventureSchema = z.object({\n  name: z.string().trim().min(1).max(VENTURE_NAME_MAX),\n  tagline: optionalTrimmedString(VENTURE_TAGLINE_MAX),\n  website: httpUrlSchema.optional(),\n  industry: industrySchema,\n  stage: startupStageSchema,\n  /** Team size including the founder. Optional: a solo pre-idea founder has none to report. */\n  teamSize: z.number().int().min(TEAM_SIZE_MIN).max(TEAM_SIZE_MAX).optional(),\n  /**\n   * Not in the future. The bound is read per parse, never captured once.\n   *\n   * `.max(new Date().getUTCFullYear())` looks equivalent and is not: it is\n   * evaluated when this module is imported, so a server process still up on\n   * 1 January rejects the new year until somebody restarts it. The backend's\n   * Mongoose model deliberately carries no upper bound for the same reason, a\n   * `max` there being frozen at schema construction. This is where the ceiling\n   * lives.\n   */\n  foundedYear: z\n    .number()\n    .int()\n    .min(FOUNDED_YEAR_MIN)\n    .refine((year) => year <= new Date().getUTCFullYear(), {\n      error: VALIDATION_MESSAGE.foundedYearFuture,\n    })\n    .optional(),\n});\nexport type Venture = z.infer<typeof ventureSchema>;\n\n// ─── Profile ─────────────────────────────────────────────────────────────────\n\n/**\n * The founder's off-platform links. ONE shape: onboarding's contact step picks\n * its three from this, so a link one side knows can never be missing on the\n * other. (It was written twice until 0.2.0, and the profile side lacked\n * Instagram, which onboarding collected.)\n *\n * Defined without a default, because the read side wants one and the write\n * side must not have one; each adds its own.\n */\nexport const founderLinksSchema = z.object({\n  linkedin: httpUrlSchema.optional(),\n  x: httpUrlSchema.optional(),\n  instagram: httpUrlSchema.optional(),\n  github: httpUrlSchema.optional(),\n  website: httpUrlSchema.optional(),\n});\nexport type FounderLinks = z.infer<typeof founderLinksSchema>;\n\n/**\n * The profile as the owner sees it. A peer sees the redacted projection\n * (`founderCardSchema`), which is built on the server and never by dropping\n * fields on the client.\n */\nexport const founderProfileSchema = z.object({\n  id: z.string(),\n  userId: z.string(),\n  username: usernameSchema,\n  displayName: z.string().trim().min(1).max(DISPLAY_NAME_MAX),\n  headline: optionalTrimmedString(HEADLINE_MAX),\n  about: optionalTrimmedString(ABOUT_MAX),\n  /**\n   * Plain `z.url()`, NOT `httpUrlSchema`, and the difference is deliberate.\n   *\n   * No member can write this field: it appears in no write body, and\n   * `public-surface.test.ts` asserts that and will fail the day somebody adds it\n   * to a form. So the scheme restriction would be defending a field that takes\n   * no member input, while refusing hosts we legitimately serve avatars from,\n   * our own dev host among them. A read schema that rejects our own response is\n   * a self-inflicted outage.\n   *\n   * ⚠️ That argument holds only while nothing member-supplied reaches this\n   * field. Two sources write an avatar today and NEITHER is a member typing a\n   * URL: our own upload path, and the central-auth `user.created` /\n   * `user.updated` webhook, which carries the Google OAuth picture. If a\n   * \"paste a link to your photo\" control is ever added, this goes back to\n   * `httpUrlSchema` and the ruling behind it is void.\n   */\n  avatarUrl: z.url().optional(),\n  location: locationSchema.optional(),\n  venture: ventureSchema.optional(),\n  skills: z.array(skillSchema).max(SKILLS_MAX).default([]),\n  goals: z.array(goalSchema).max(GOAL_VALUES.length).default([]),\n  links: founderLinksSchema.default({}),\n  /** Onboarding is finished and the member is visible in Discover. */\n  isOnboarded: z.boolean().default(false),\n  /** Member paused their own profile. Hidden from Discover, keeps their data. */\n  isActive: z.boolean().default(true),\n  createdAt: z.iso.datetime(),\n  updatedAt: z.iso.datetime(),\n});\nexport type FounderProfile = z.infer<typeof founderProfileSchema>;\n\n/**\n * What one founder sees of another in Discover and on a profile page.\n *\n * Built server-side. Keep it a strict subset of `founderProfileSchema` — if a\n * private field ever needs to show here, that is a product decision, not an\n * accident of spreading the full document.\n */\nexport const founderCardSchema = founderProfileSchema.pick({\n  id: true,\n  username: true,\n  displayName: true,\n  headline: true,\n  avatarUrl: true,\n  location: true,\n  venture: true,\n  skills: true,\n  goals: true,\n});\nexport type FounderCard = z.infer<typeof founderCardSchema>;\n\n// ─── Write bodies ────────────────────────────────────────────────────────────\n\n/**\n * A text field the member is allowed to empty.\n *\n * Three states, and they are deliberately distinct:\n *   absent  do not touch this field\n *   null    clear it (the backend turns this into an `$unset`)\n *   \"\"      REJECTED\n *\n * The empty string is refused on purpose. A form that forgets to convert a\n * cleared input to `null` then fails loudly at the boundary, instead of being\n * silently dropped and leaving the member staring at text they just deleted.\n * `optionalTrimmedString` does the dropping, which is right for a create body\n * and wrong for a patch.\n */\nconst clearableText = (maxLength: number) =>\n  z.string().trim().min(1, VALIDATION_MESSAGE.clearWithNull).max(maxLength).nullable().optional();\n\n/**\n * Patch body for the Me tab. Only the keys the member actually changed.\n *\n * ⚠️ Written as its own object ON PURPOSE. Do NOT rebuild it as\n * `founderProfileSchema.pick({...}).partial()`: `.partial()` does not switch\n * off `.default()`, so `skills`, `goals` and `links` would materialise as\n * `[]`, `[]` and `{}` on every request, including an empty one. Under a `$set`\n * that wipes a member's skills and every one of their links the moment they\n * edit their display name. `tsc` cannot see it and the request looks correct in\n * the network tab.\n *\n * The rule this comes from: defaults belong on the READ side. A write body\n * states what the caller sent and nothing else.\n */\nexport const updateFounderProfileBodySchema = z.object({\n  displayName: z.string().trim().min(1).max(DISPLAY_NAME_MAX).optional(),\n  headline: clearableText(HEADLINE_MAX),\n  about: clearableText(ABOUT_MAX),\n  /** Carries the whole location; `locationSchema` has no default to fill a gap. */\n  location: locationSchema.optional(),\n  venture: ventureSchema.optional(),\n  skills: z.array(skillSchema).max(SKILLS_MAX).optional(),\n  goals: z.array(goalSchema).max(GOAL_VALUES.length).optional(),\n  /** Sent whole. To drop one link, send the object without that key. */\n  links: founderLinksSchema.optional(),\n});\nexport type UpdateFounderProfileBody = z.infer<typeof updateFounderProfileBodySchema>;\n\n/**\n * Username change. Separate from the profile patch because it needs a\n * uniqueness check, and it refuses a reserved handle (`chosenUsernameSchema`).\n */\nexport const updateUsernameBodySchema = z.object({ username: chosenUsernameSchema });\nexport type UpdateUsernameBody = z.infer<typeof updateUsernameBodySchema>;\n\n/** Availability probe behind the username field. */\nexport const usernameAvailabilitySchema = z.object({\n  username: usernameSchema,\n  available: z.boolean(),\n  /** Present when unavailable: `taken` or `reserved`. */\n  reason: z.enum(['taken', 'reserved']).optional(),\n});\nexport type UsernameAvailability = z.infer<typeof usernameAvailabilitySchema>;\n"]}
+{"version":3,"file":"founder-profile.js","sourceRoot":"","sources":["../../../src/domains/profile/founder-profile.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema — The founder profile\n *\n * One member, one profile. The central auth account owns identity (email,\n * verification, deletion); this owns everything Founder Circle shows.\n *\n * @module founder-schema/domains/profile\n */\n\nimport { z } from 'zod';\nimport {\n  chosenUsernameSchema,\n  GOAL_VALUES,\n  goalSchema,\n  httpUrlSchema,\n  industrySchema,\n  locationSchema,\n  objectIdSchema,\n  optionalTrimmedString,\n  skillSchema,\n  startupStageSchema,\n  usernameSchema,\n} from '../../core/common.js';\nimport {\n  ABOUT_MAX,\n  DISPLAY_NAME_MAX,\n  FOUNDED_YEAR_MIN,\n  HEADLINE_MAX,\n  SKILLS_MAX,\n  TEAM_SIZE_MAX,\n  TEAM_SIZE_MIN,\n  VENTURE_NAME_MAX,\n  VENTURE_TAGLINE_MAX,\n} from '../../core/limits.js';\nimport { VALIDATION_MESSAGE } from '../../core/validation.js';\nimport { mediaImageSchema } from '../media/media.js';\n\n// ─── Venture ─────────────────────────────────────────────────────────────────\n\n/**\n * ⚠ NUMBERS ARE NUMBERS, never coerced. This is a BODY, which arrives as JSON\n * and already carries types. `z.coerce.number()` here accepted `teamSize: true`\n * as 1 and `\"  \"` as 0, and made the schema's input type `unknown`, so a form\n * typed against it could put anything in the field. Coercion belongs to query\n * strings, where everything is text; a form converts its text input before it\n * builds the body.\n */\nexport const ventureSchema = z.object({\n  name: z.string().trim().min(1).max(VENTURE_NAME_MAX),\n  tagline: optionalTrimmedString(VENTURE_TAGLINE_MAX),\n  website: httpUrlSchema.optional(),\n  industry: industrySchema,\n  stage: startupStageSchema,\n  /** Team size including the founder. Optional: a solo pre-idea founder has none to report. */\n  teamSize: z.number().int().min(TEAM_SIZE_MIN).max(TEAM_SIZE_MAX).optional(),\n  /**\n   * Not in the future. The bound is read per parse, never captured once.\n   *\n   * `.max(new Date().getUTCFullYear())` looks equivalent and is not: it is\n   * evaluated when this module is imported, so a server process still up on\n   * 1 January rejects the new year until somebody restarts it. The backend's\n   * Mongoose model deliberately carries no upper bound for the same reason, a\n   * `max` there being frozen at schema construction. This is where the ceiling\n   * lives.\n   */\n  foundedYear: z\n    .number()\n    .int()\n    .min(FOUNDED_YEAR_MIN)\n    .refine((year) => year <= new Date().getUTCFullYear(), {\n      error: VALIDATION_MESSAGE.foundedYearFuture,\n    })\n    .optional(),\n});\nexport type Venture = z.infer<typeof ventureSchema>;\n\n// ─── A member as other surfaces name them ────────────────────────────────────\n\n/**\n * A member as a byline renders them: on a post (`feedAuthorSchema` is this), a\n * product's team, a review, a notification, the top-helpers list.\n *\n * Every field is LIVE, joined against the profile at read time rather than\n * frozen onto the post or review at write time. So a renamed handle, a new\n * photo or an edited headline updates everywhere, the link always targets the\n * current username, and nothing personal survives in other people's rows once\n * an account is deleted.\n */\nexport const memberBylineSchema = z.object({\n  userId: z.string(),\n  username: usernameSchema,\n  displayName: z.string(),\n  /** Server-generated or from the login provider, never member-typed, so a\n   *  plain URL check. Same reasoning as `avatarUrl` on the profile. */\n  avatarUrl: z.url().optional(),\n  /** The member's one-line headline, live-joined. */\n  headline: z.string().optional(),\n});\nexport type MemberByline = z.infer<typeof memberBylineSchema>;\n\n/**\n * What a member has given the community, on their profile and card.\n *\n * `score` is points earned from OTHER members' recognition only: a product's\n * team marking your feedback helpful, confirming you tested their product,\n * members finding your review helpful, and writing reviews. Nothing a member\n * does to their own product counts, so the score cannot be bought by having a\n * popular one. `helpedCount` is how many different founders recognised that\n * help (\"Helped 12 founders\"). See `domains/contributions`.\n */\nexport const contributionSummarySchema = z.object({\n  score: z.number().int().nonnegative(),\n  helpedCount: z.number().int().nonnegative(),\n});\nexport type ContributionSummary = z.infer<typeof contributionSummarySchema>;\n\n// ─── Profile ─────────────────────────────────────────────────────────────────\n\n/**\n * The founder's off-platform links. ONE shape: onboarding's contact step picks\n * its three from this, so a link one side knows can never be missing on the\n * other. (It was written twice until 0.2.0, and the profile side lacked\n * Instagram, which onboarding collected.)\n *\n * Defined without a default, because the read side wants one and the write\n * side must not have one; each adds its own.\n */\nexport const founderLinksSchema = z.object({\n  linkedin: httpUrlSchema.optional(),\n  x: httpUrlSchema.optional(),\n  instagram: httpUrlSchema.optional(),\n  github: httpUrlSchema.optional(),\n  website: httpUrlSchema.optional(),\n});\nexport type FounderLinks = z.infer<typeof founderLinksSchema>;\n\n/**\n * The profile as the owner sees it. A peer sees the redacted projection\n * (`founderCardSchema`), which is built on the server and never by dropping\n * fields on the client.\n */\nexport const founderProfileSchema = z.object({\n  id: z.string(),\n  userId: z.string(),\n  username: usernameSchema,\n  displayName: z.string().trim().min(1).max(DISPLAY_NAME_MAX),\n  headline: optionalTrimmedString(HEADLINE_MAX),\n  about: optionalTrimmedString(ABOUT_MAX),\n  /**\n   * Plain `z.url()`, NOT `httpUrlSchema`, and the difference is deliberate.\n   *\n   * No member can write this field: it appears in no write body, and\n   * `public-surface.test.ts` asserts that and will fail the day somebody adds it\n   * to a form. So the scheme restriction would be defending a field that takes\n   * no member input, while refusing hosts we legitimately serve avatars from,\n   * our own dev host among them. A read schema that rejects our own response is\n   * a self-inflicted outage.\n   *\n   * ⚠️ That argument holds only while nothing member-supplied reaches this\n   * field. Two sources write an avatar today and NEITHER is a member typing a\n   * URL: our own upload path, and the central-auth `user.created` /\n   * `user.updated` webhook, which carries the Google OAuth picture. If a\n   * \"paste a link to your photo\" control is ever added, this goes back to\n   * `httpUrlSchema` and the ruling behind it is void.\n   *\n   * WHICH picture: the member's uploaded photo at its small size (192, see\n   * `MEDIA_SIZES.avatar`), else their sign-in provider's picture, else absent.\n   * Every surface that shows this member resolves it the same way.\n   */\n  avatarUrl: z.url().optional(),\n  /**\n   * The uploaded photo itself, every size, when the member has one. Absent\n   * means `avatarUrl` (if any) is the sign-in provider's picture, so a client\n   * offers \"Remove photo\" only when this is present. Not on `founderCardSchema`:\n   * a card needs one small picture, not the set.\n   */\n  avatar: mediaImageSchema.optional(),\n  location: locationSchema.optional(),\n  venture: ventureSchema.optional(),\n  skills: z.array(skillSchema).max(SKILLS_MAX).default([]),\n  goals: z.array(goalSchema).max(GOAL_VALUES.length).default([]),\n  links: founderLinksSchema.default({}),\n  /**\n   * Their contribution to other founders. Server-computed, never written by a\n   * member. REQUIRED, no default: a read-side default would let a server that\n   * forgot the field pass as a real zero.\n   */\n  contribution: contributionSummarySchema,\n  /** Onboarding is finished and the member is visible in Discover. */\n  isOnboarded: z.boolean().default(false),\n  /** Member paused their own profile. Hidden from Discover, keeps their data. */\n  isActive: z.boolean().default(true),\n  createdAt: z.iso.datetime(),\n  updatedAt: z.iso.datetime(),\n});\nexport type FounderProfile = z.infer<typeof founderProfileSchema>;\n\n/**\n * What one founder sees of another in Discover and on a profile page.\n *\n * Built server-side. Keep it a strict subset of `founderProfileSchema` — if a\n * private field ever needs to show here, that is a product decision, not an\n * accident of spreading the full document.\n */\nexport const founderCardSchema = founderProfileSchema.pick({\n  id: true,\n  /**\n   * The MEMBER's id (0.6.0): what a team invitation, a chat and every byline\n   * key on. `id` is the profile's own id, which nothing takes as input.\n   */\n  userId: true,\n  username: true,\n  displayName: true,\n  headline: true,\n  avatarUrl: true,\n  location: true,\n  venture: true,\n  skills: true,\n  goals: true,\n  contribution: true,\n});\nexport type FounderCard = z.infer<typeof founderCardSchema>;\n\n// ─── Write bodies ────────────────────────────────────────────────────────────\n\n/**\n * A text field the member is allowed to empty.\n *\n * Three states, and they are deliberately distinct:\n *   absent  do not touch this field\n *   null    clear it (the backend turns this into an `$unset`)\n *   \"\"      REJECTED\n *\n * The empty string is refused on purpose. A form that forgets to convert a\n * cleared input to `null` then fails loudly at the boundary, instead of being\n * silently dropped and leaving the member staring at text they just deleted.\n * `optionalTrimmedString` does the dropping, which is right for a create body\n * and wrong for a patch.\n */\nconst clearableText = (maxLength: number) =>\n  z.string().trim().min(1, VALIDATION_MESSAGE.clearWithNull).max(maxLength).nullable().optional();\n\n/**\n * Patch body for the Me tab. Only the keys the member actually changed.\n *\n * ⚠️ Written as its own object ON PURPOSE. Do NOT rebuild it as\n * `founderProfileSchema.pick({...}).partial()`: `.partial()` does not switch\n * off `.default()`, so `skills`, `goals` and `links` would materialise as\n * `[]`, `[]` and `{}` on every request, including an empty one. Under a `$set`\n * that wipes a member's skills and every one of their links the moment they\n * edit their display name. `tsc` cannot see it and the request looks correct in\n * the network tab.\n *\n * The rule this comes from: defaults belong on the READ side. A write body\n * states what the caller sent and nothing else.\n */\nexport const updateFounderProfileBodySchema = z.object({\n  displayName: z.string().trim().min(1).max(DISPLAY_NAME_MAX).optional(),\n  headline: clearableText(HEADLINE_MAX),\n  about: clearableText(ABOUT_MAX),\n  /** Carries the whole location; `locationSchema` has no default to fill a gap. */\n  location: locationSchema.optional(),\n  venture: ventureSchema.optional(),\n  skills: z.array(skillSchema).max(SKILLS_MAX).optional(),\n  goals: z.array(goalSchema).max(GOAL_VALUES.length).optional(),\n  /** Sent whole. To drop one link, send the object without that key. */\n  links: founderLinksSchema.optional(),\n});\nexport type UpdateFounderProfileBody = z.infer<typeof updateFounderProfileBodySchema>;\n\n/**\n * Username change. Separate from the profile patch because it needs a\n * uniqueness check, and it refuses a reserved handle (`chosenUsernameSchema`).\n */\nexport const updateUsernameBodySchema = z.object({ username: chosenUsernameSchema });\nexport type UpdateUsernameBody = z.infer<typeof updateUsernameBodySchema>;\n\n/** Availability probe behind the username field. */\nexport const usernameAvailabilitySchema = z.object({\n  username: usernameSchema,\n  available: z.boolean(),\n  /** Present when unavailable: `taken` or `reserved`. */\n  reason: z.enum(['taken', 'reserved']).optional(),\n});\nexport type UsernameAvailability = z.infer<typeof usernameAvailabilitySchema>;\n\n// ─── The member's own photo ──────────────────────────────────────────────────\n\n/**\n * `PUT /api/v1/profiles/me/avatar`: use a completed upload (purpose `avatar`)\n * as the member's photo. Answers with the updated `founderProfileSchema`.\n *\n * The previous photo is deleted from storage, not merely unlinked, so its old\n * address stops working. `DELETE /api/v1/profiles/me/avatar` removes the photo\n * the same way and the member falls back to their sign-in provider's picture.\n */\nexport const setAvatarBodySchema = z.object({ mediaId: objectIdSchema });\nexport type SetAvatarBody = z.infer<typeof setAvatarBodySchema>;\n"]}

package/dist/domains/reviews/reviews.d.ts

@@ -0,0 +1,184 @@
+/**
+ * founder-schema — Reviews: stars and words on a product
+ *
+ * One review per member per product: 1 to 5 stars AND text of at least
+ * `REVIEW_TEXT_MIN` characters, because a star with no reason does not help
+ * the founder. Nobody on a product's team reviews it. The writer may edit it
+ * any time (it then shows as edited) or delete it. The team may answer each
+ * review once, publicly; other members may find it Helpful.
+ *
+ * `testedIt` marks a review by a member the team confirmed as a tester of the
+ * product, so a reader can tell a review from use from a review from a glance.
+ *
+ * The product's average shows from `REVIEW_AVERAGE_MIN_COUNT` reviews. Hidden
+ * reviews (staff) are not counted.
+ *
+ * Routes (all signed in):
+ *   GET    /api/v1/products/:productId/reviews   reviewsQuerySchema -> reviewPageSchema
+ *   POST   /api/v1/products/:productId/reviews   createReviewBodySchema -> productReviewSchema
+ *   GET    /api/v1/reviews/:reviewId             -> productReviewSchema (yours, to edit it)
+ *   PATCH  /api/v1/reviews/:reviewId             updateReviewBodySchema -> productReviewSchema
+ *   DELETE /api/v1/reviews/:reviewId             -> IdResponse
+ *   PUT    /api/v1/reviews/:reviewId/reply       reviewReplyBodySchema -> productReviewSchema
+ *   DELETE /api/v1/reviews/:reviewId/reply       -> productReviewSchema
+ *   PUT    /api/v1/reviews/:reviewId/helpful     -> reviewHelpfulResponseSchema
+ *   DELETE /api/v1/reviews/:reviewId/helpful     -> reviewHelpfulResponseSchema
+ *   POST   /api/v1/reviews/:reviewId/report      createReportBodySchema -> CreateReportResponse
+ *
+ * @module founder-schema/domains/reviews
+ */
+import { z } from 'zod';
+/** Whole stars. */
+export declare const reviewRatingSchema: z.ZodNumber;
+export type ReviewRating = z.infer<typeof reviewRatingSchema>;
+/** `new` (the default) or `helpful` first. */
+export declare const REVIEW_SORT_VALUES: readonly ["new", "helpful"];
+export declare const reviewSortSchema: z.ZodEnum<{
+    new: "new";
+    helpful: "helpful";
+}>;
+export type ReviewSort = z.infer<typeof reviewSortSchema>;
+/** The team's public answer to a review. */
+export declare const reviewReplySchema: z.ZodObject<{
+    text: z.ZodString;
+    author: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodISODateTime;
+    editedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type ReviewReply = z.infer<typeof reviewReplySchema>;
+/** What this viewer may do with a review, decided by the server. */
+export declare const reviewViewerSchema: z.ZodObject<{
+    isAuthor: z.ZodBoolean;
+    votedHelpful: z.ZodBoolean;
+    canEdit: z.ZodBoolean;
+    canDelete: z.ZodBoolean;
+    canReply: z.ZodBoolean;
+    canVoteHelpful: z.ZodBoolean;
+    canReport: z.ZodBoolean;
+}, z.core.$strip>;
+export type ReviewViewer = z.infer<typeof reviewViewerSchema>;
+export declare const productReviewSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    productId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    author: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    rating: z.ZodNumber;
+    text: z.ZodString;
+    testedIt: z.ZodBoolean;
+    helpfulCount: z.ZodNumber;
+    reply: z.ZodNullable<z.ZodObject<{
+        text: z.ZodString;
+        author: z.ZodNullable<z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodISODateTime;
+        editedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodISODateTime;
+    editedAt: z.ZodNullable<z.ZodISODateTime>;
+    viewer: z.ZodOptional<z.ZodObject<{
+        isAuthor: z.ZodBoolean;
+        votedHelpful: z.ZodBoolean;
+        canEdit: z.ZodBoolean;
+        canDelete: z.ZodBoolean;
+        canReply: z.ZodBoolean;
+        canVoteHelpful: z.ZodBoolean;
+        canReport: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProductReview = z.infer<typeof productReviewSchema>;
+export declare const reviewPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        productId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        author: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        rating: z.ZodNumber;
+        text: z.ZodString;
+        testedIt: z.ZodBoolean;
+        helpfulCount: z.ZodNumber;
+        reply: z.ZodNullable<z.ZodObject<{
+            text: z.ZodString;
+            author: z.ZodNullable<z.ZodObject<{
+                userId: z.ZodString;
+                username: z.ZodString;
+                displayName: z.ZodString;
+                avatarUrl: z.ZodOptional<z.ZodURL>;
+                headline: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            createdAt: z.ZodISODateTime;
+            editedAt: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodISODateTime;
+        editedAt: z.ZodNullable<z.ZodISODateTime>;
+        viewer: z.ZodOptional<z.ZodObject<{
+            isAuthor: z.ZodBoolean;
+            votedHelpful: z.ZodBoolean;
+            canEdit: z.ZodBoolean;
+            canDelete: z.ZodBoolean;
+            canReply: z.ZodBoolean;
+            canVoteHelpful: z.ZodBoolean;
+            canReport: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ReviewPage = z.infer<typeof reviewPageSchema>;
+export declare const reviewsQuerySchema: z.ZodObject<{
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodCoercedNumber<unknown>>, unknown>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sort: z.ZodPreprocess<z.ZodDefault<z.ZodEnum<{
+        new: "new";
+        helpful: "helpful";
+    }>>, unknown>;
+}, z.core.$strip>;
+export type ReviewsQuery = z.infer<typeof reviewsQuerySchema>;
+export type ReviewsQueryInput = z.input<typeof reviewsQuerySchema>;
+export declare const reviewParamsSchema: z.ZodObject<{
+    reviewId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type ReviewParams = z.infer<typeof reviewParamsSchema>;
+export declare const createReviewBodySchema: z.ZodObject<{
+    rating: z.ZodNumber;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type CreateReviewBody = z.infer<typeof createReviewBodySchema>;
+/** Only what changed. An empty body changes nothing and answers the review as it is. */
+export declare const updateReviewBodySchema: z.ZodObject<{
+    rating: z.ZodOptional<z.ZodNumber>;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateReviewBody = z.infer<typeof updateReviewBodySchema>;
+/** The team's reply: written once, then edited in place by sending it again. */
+export declare const reviewReplyBodySchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export type ReviewReplyBody = z.infer<typeof reviewReplyBodySchema>;
+/** `PUT|DELETE /reviews/:id/helpful`: the state it settled on and the fresh count. */
+export declare const reviewHelpfulResponseSchema: z.ZodObject<{
+    reviewId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    votedHelpful: z.ZodBoolean;
+    helpfulCount: z.ZodNumber;
+}, z.core.$strip>;
+export type ReviewHelpfulResponse = z.infer<typeof reviewHelpfulResponseSchema>;
+//# sourceMappingURL=reviews.d.ts.map

package/dist/domains/reviews/reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../../src/domains/reviews/reviews.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,mBAAmB;AACnB,eAAO,MAAM,kBAAkB,aAAiC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,6BAA8B,CAAC;AAC9D,eAAO,MAAM,gBAAgB;;;EAA6B,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,oEAAoE;AACpE,eAAO,MAAM,kBAAkB;;;;;;;;iBAU7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAuC,CAAC;AACrE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,kBAAkB;;;;;;;iBAE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,eAAO,MAAM,kBAAkB;;iBAAyC,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,wFAAwF;AACxF,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,gFAAgF;AAChF,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,sFAAsF;AACtF,eAAO,MAAM,2BAA2B;;;;iBAItC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/domains/reviews/reviews.js

@@ -0,0 +1,99 @@
+/**
+ * founder-schema — Reviews: stars and words on a product
+ *
+ * One review per member per product: 1 to 5 stars AND text of at least
+ * `REVIEW_TEXT_MIN` characters, because a star with no reason does not help
+ * the founder. Nobody on a product's team reviews it. The writer may edit it
+ * any time (it then shows as edited) or delete it. The team may answer each
+ * review once, publicly; other members may find it Helpful.
+ *
+ * `testedIt` marks a review by a member the team confirmed as a tester of the
+ * product, so a reader can tell a review from use from a review from a glance.
+ *
+ * The product's average shows from `REVIEW_AVERAGE_MIN_COUNT` reviews. Hidden
+ * reviews (staff) are not counted.
+ *
+ * Routes (all signed in):
+ *   GET    /api/v1/products/:productId/reviews   reviewsQuerySchema -> reviewPageSchema
+ *   POST   /api/v1/products/:productId/reviews   createReviewBodySchema -> productReviewSchema
+ *   GET    /api/v1/reviews/:reviewId             -> productReviewSchema (yours, to edit it)
+ *   PATCH  /api/v1/reviews/:reviewId             updateReviewBodySchema -> productReviewSchema
+ *   DELETE /api/v1/reviews/:reviewId             -> IdResponse
+ *   PUT    /api/v1/reviews/:reviewId/reply       reviewReplyBodySchema -> productReviewSchema
+ *   DELETE /api/v1/reviews/:reviewId/reply       -> productReviewSchema
+ *   PUT    /api/v1/reviews/:reviewId/helpful     -> reviewHelpfulResponseSchema
+ *   DELETE /api/v1/reviews/:reviewId/helpful     -> reviewHelpfulResponseSchema
+ *   POST   /api/v1/reviews/:reviewId/report      createReportBodySchema -> CreateReportResponse
+ *
+ * @module founder-schema/domains/reviews
+ */
+import { z } from 'zod';
+import { emptyStringToUndefined, objectIdSchema, paginationQuerySchema, } from '../../core/common.js';
+import { REVIEW_REPLY_MAX, REVIEW_TEXT_MAX, REVIEW_TEXT_MIN } from '../../core/limits.js';
+import { paginatedSchema } from '../../core/responses.js';
+import { memberBylineSchema } from '../profile/founder-profile.js';
+/** Whole stars. */
+export const reviewRatingSchema = z.number().int().min(1).max(5);
+/** `new` (the default) or `helpful` first. */
+export const REVIEW_SORT_VALUES = ['new', 'helpful'];
+export const reviewSortSchema = z.enum(REVIEW_SORT_VALUES);
+/** The team's public answer to a review. */
+export const reviewReplySchema = z.object({
+    text: z.string().max(REVIEW_REPLY_MAX),
+    /** Who on the team wrote it; null when they have since deleted their account. */
+    author: memberBylineSchema.nullable(),
+    createdAt: z.iso.datetime(),
+    editedAt: z.iso.datetime().nullable(),
+});
+/** What this viewer may do with a review, decided by the server. */
+export const reviewViewerSchema = z.object({
+    isAuthor: z.boolean(),
+    votedHelpful: z.boolean(),
+    canEdit: z.boolean(),
+    canDelete: z.boolean(),
+    /** On the product's team: write, edit or remove the team's reply. */
+    canReply: z.boolean(),
+    /** Not the writer. */
+    canVoteHelpful: z.boolean(),
+    canReport: z.boolean(),
+});
+export const productReviewSchema = z.object({
+    id: objectIdSchema,
+    productId: objectIdSchema,
+    author: memberBylineSchema,
+    rating: reviewRatingSchema,
+    text: z.string().max(REVIEW_TEXT_MAX),
+    /** The team confirmed the writer as a tester of this product. */
+    testedIt: z.boolean(),
+    helpfulCount: z.number().int().nonnegative(),
+    reply: reviewReplySchema.nullable(),
+    createdAt: z.iso.datetime(),
+    editedAt: z.iso.datetime().nullable(),
+    viewer: reviewViewerSchema.optional(),
+});
+export const reviewPageSchema = paginatedSchema(productReviewSchema);
+export const reviewsQuerySchema = paginationQuerySchema.extend({
+    sort: z.preprocess(emptyStringToUndefined, reviewSortSchema.default('new')),
+});
+export const reviewParamsSchema = z.object({ reviewId: objectIdSchema });
+const reviewTextSchema = z.string().trim().min(REVIEW_TEXT_MIN).max(REVIEW_TEXT_MAX);
+export const createReviewBodySchema = z.object({
+    rating: reviewRatingSchema,
+    text: reviewTextSchema,
+});
+/** Only what changed. An empty body changes nothing and answers the review as it is. */
+export const updateReviewBodySchema = z.object({
+    rating: reviewRatingSchema.optional(),
+    text: reviewTextSchema.optional(),
+});
+/** The team's reply: written once, then edited in place by sending it again. */
+export const reviewReplyBodySchema = z.object({
+    text: z.string().trim().min(1).max(REVIEW_REPLY_MAX),
+});
+/** `PUT|DELETE /reviews/:id/helpful`: the state it settled on and the fresh count. */
+export const reviewHelpfulResponseSchema = z.object({
+    reviewId: objectIdSchema,
+    votedHelpful: z.boolean(),
+    helpfulCount: z.number().int().nonnegative(),
+});
+//# sourceMappingURL=reviews.js.map

package/dist/domains/reviews/reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../../src/domains/reviews/reviews.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema — Reviews: stars and words on a product\n *\n * One review per member per product: 1 to 5 stars AND text of at least\n * `REVIEW_TEXT_MIN` characters, because a star with no reason does not help\n * the founder. Nobody on a product's team reviews it. The writer may edit it\n * any time (it then shows as edited) or delete it. The team may answer each\n * review once, publicly; other members may find it Helpful.\n *\n * `testedIt` marks a review by a member the team confirmed as a tester of the\n * product, so a reader can tell a review from use from a review from a glance.\n *\n * The product's average shows from `REVIEW_AVERAGE_MIN_COUNT` reviews. Hidden\n * reviews (staff) are not counted.\n *\n * Routes (all signed in):\n *   GET    /api/v1/products/:productId/reviews   reviewsQuerySchema -> reviewPageSchema\n *   POST   /api/v1/products/:productId/reviews   createReviewBodySchema -> productReviewSchema\n *   GET    /api/v1/reviews/:reviewId             -> productReviewSchema (yours, to edit it)\n *   PATCH  /api/v1/reviews/:reviewId             updateReviewBodySchema -> productReviewSchema\n *   DELETE /api/v1/reviews/:reviewId             -> IdResponse\n *   PUT    /api/v1/reviews/:reviewId/reply       reviewReplyBodySchema -> productReviewSchema\n *   DELETE /api/v1/reviews/:reviewId/reply       -> productReviewSchema\n *   PUT    /api/v1/reviews/:reviewId/helpful     -> reviewHelpfulResponseSchema\n *   DELETE /api/v1/reviews/:reviewId/helpful     -> reviewHelpfulResponseSchema\n *   POST   /api/v1/reviews/:reviewId/report      createReportBodySchema -> CreateReportResponse\n *\n * @module founder-schema/domains/reviews\n */\n\nimport { z } from 'zod';\nimport {\n  emptyStringToUndefined,\n  objectIdSchema,\n  paginationQuerySchema,\n} from '../../core/common.js';\nimport { REVIEW_REPLY_MAX, REVIEW_TEXT_MAX, REVIEW_TEXT_MIN } from '../../core/limits.js';\nimport { paginatedSchema } from '../../core/responses.js';\nimport { memberBylineSchema } from '../profile/founder-profile.js';\n\n/** Whole stars. */\nexport const reviewRatingSchema = z.number().int().min(1).max(5);\nexport type ReviewRating = z.infer<typeof reviewRatingSchema>;\n\n/** `new` (the default) or `helpful` first. */\nexport const REVIEW_SORT_VALUES = ['new', 'helpful'] as const;\nexport const reviewSortSchema = z.enum(REVIEW_SORT_VALUES);\nexport type ReviewSort = z.infer<typeof reviewSortSchema>;\n\n/** The team's public answer to a review. */\nexport const reviewReplySchema = z.object({\n  text: z.string().max(REVIEW_REPLY_MAX),\n  /** Who on the team wrote it; null when they have since deleted their account. */\n  author: memberBylineSchema.nullable(),\n  createdAt: z.iso.datetime(),\n  editedAt: z.iso.datetime().nullable(),\n});\nexport type ReviewReply = z.infer<typeof reviewReplySchema>;\n\n/** What this viewer may do with a review, decided by the server. */\nexport const reviewViewerSchema = z.object({\n  isAuthor: z.boolean(),\n  votedHelpful: z.boolean(),\n  canEdit: z.boolean(),\n  canDelete: z.boolean(),\n  /** On the product's team: write, edit or remove the team's reply. */\n  canReply: z.boolean(),\n  /** Not the writer. */\n  canVoteHelpful: z.boolean(),\n  canReport: z.boolean(),\n});\nexport type ReviewViewer = z.infer<typeof reviewViewerSchema>;\n\nexport const productReviewSchema = z.object({\n  id: objectIdSchema,\n  productId: objectIdSchema,\n  author: memberBylineSchema,\n  rating: reviewRatingSchema,\n  text: z.string().max(REVIEW_TEXT_MAX),\n  /** The team confirmed the writer as a tester of this product. */\n  testedIt: z.boolean(),\n  helpfulCount: z.number().int().nonnegative(),\n  reply: reviewReplySchema.nullable(),\n  createdAt: z.iso.datetime(),\n  editedAt: z.iso.datetime().nullable(),\n  viewer: reviewViewerSchema.optional(),\n});\nexport type ProductReview = z.infer<typeof productReviewSchema>;\n\nexport const reviewPageSchema = paginatedSchema(productReviewSchema);\nexport type ReviewPage = z.infer<typeof reviewPageSchema>;\n\nexport const reviewsQuerySchema = paginationQuerySchema.extend({\n  sort: z.preprocess(emptyStringToUndefined, reviewSortSchema.default('new')),\n});\nexport type ReviewsQuery = z.infer<typeof reviewsQuerySchema>;\nexport type ReviewsQueryInput = z.input<typeof reviewsQuerySchema>;\n\nexport const reviewParamsSchema = z.object({ reviewId: objectIdSchema });\nexport type ReviewParams = z.infer<typeof reviewParamsSchema>;\n\nconst reviewTextSchema = z.string().trim().min(REVIEW_TEXT_MIN).max(REVIEW_TEXT_MAX);\n\nexport const createReviewBodySchema = z.object({\n  rating: reviewRatingSchema,\n  text: reviewTextSchema,\n});\nexport type CreateReviewBody = z.infer<typeof createReviewBodySchema>;\n\n/** Only what changed. An empty body changes nothing and answers the review as it is. */\nexport const updateReviewBodySchema = z.object({\n  rating: reviewRatingSchema.optional(),\n  text: reviewTextSchema.optional(),\n});\nexport type UpdateReviewBody = z.infer<typeof updateReviewBodySchema>;\n\n/** The team's reply: written once, then edited in place by sending it again. */\nexport const reviewReplyBodySchema = z.object({\n  text: z.string().trim().min(1).max(REVIEW_REPLY_MAX),\n});\nexport type ReviewReplyBody = z.infer<typeof reviewReplyBodySchema>;\n\n/** `PUT|DELETE /reviews/:id/helpful`: the state it settled on and the fresh count. */\nexport const reviewHelpfulResponseSchema = z.object({\n  reviewId: objectIdSchema,\n  votedHelpful: z.boolean(),\n  helpfulCount: z.number().int().nonnegative(),\n});\nexport type ReviewHelpfulResponse = z.infer<typeof reviewHelpfulResponseSchema>;\n"]}