founder-schema 0.1.0 → 0.3.0

package/dist/onboarding.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../src/onboarding.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema — Onboarding: steps, enums, and the two shapes of the answers\n *\n * ONE LIST DEFINES THE FLOW. `FOUNDER_ONBOARDING_STEPS` carries the screen\n * title, the help line, the progress denominator AND the fields each step\n * gates on. GymMonk arrived here after keeping two lists in sync by hand, where\n * a step could exist with no title or, worse, be left with no validation gate\n * at all. Dating reached the same place independently. One list makes both\n * impossible.\n *\n * TWO SHAPES, ONE SET OF RULES. A half-filled form legitimately holds `null`\n * for a choice nobody has made yet; the finalize body only ever sees completed\n * answers. So the rules are written once and expressed over both shapes:\n * `onboardingFormSchema` for work in progress and `completeOnboardingBodySchema`\n * for the end. Letting those two drift is how a wizard says a step is optional\n * and then answers 422 at Finish.\n *\n * @module founder-schema/onboarding\n */\n\nimport { z } from 'zod';\nimport {\n  GOAL_VALUES,\n  genderSchema,\n  goalSchema,\n  httpUrlSchema,\n  industrySchema,\n  optionalTrimmedString,\n  phoneSchema,\n  skillSchema,\n  startupStageSchema,\n} from './common.js';\n\n// ─── Age ─────────────────────────────────────────────────────────────────────\n\n/**\n * 18, ruled by the user 2026-09-21. Under-18 would pull in parental-consent\n * duties under the DPDP Act, which is a different and larger problem than a\n * validation rule.\n *\n * ⚠️ The SERVER refuses at finalize. This schema exists so the member sees a\n * useful message; it is not the gate.\n */\nexport const MIN_AGE_YEARS = 18;\n/** A sanity ceiling, not a product rule. Catches a mistyped year. */\nexport const MAX_AGE_YEARS = 120;\n\n/**\n * Whole years completed, by the calendar.\n *\n * ⚠️ NOT `elapsedMs / (365.25 * day)`, which is what the sibling product uses.\n * That approximation reads 17.9986 at the start of somebody's eighteenth\n * birthday and only crosses 18 about halfway through the day, so it refuses\n * them for the half of their birthday they are most likely to be signing up on.\n * Measured: it disagrees with the calendar on all 400 of the next 400 days.\n * An age gate is exactly the place an approximation is not good enough.\n */\nexport function ageInYears(isoDate: string, now: Date = new Date()): number {\n  // ⚠️ A STRING, `YYYY-MM-DD`, not a `Date`. This is a wire contract, so it\n  // takes the wire type. The backend is the obvious caller and the backend\n  // holds a `Date`, so it must format first; passing the Date straight in used\n  // to fail with `isoDate.split is not a function`, which says nothing useful.\n  // Naming the fix costs one line and saves the next person the detour.\n  if (typeof isoDate !== 'string') {\n    throw new TypeError(\n      'ageInYears expects a YYYY-MM-DD string, not a Date. Format it first, e.g. date.toISOString().slice(0, 10).',\n    );\n  }\n  const [y, m, d] = isoDate.split('-').map(Number) as [number, number, number];\n  let age = now.getUTCFullYear() - y;\n  const monthNow = now.getUTCMonth() + 1;\n  if (monthNow < m || (monthNow === m && now.getUTCDate() < d)) age -= 1;\n  return age;\n}\n\n/** A calendar date with no time component, `YYYY-MM-DD`. */\nexport const isoDateSchema = z\n  .string()\n  .trim()\n  .regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'Expected a YYYY-MM-DD date');\n\n/** True only for a date that exists. Rejects 2026-02-30 and 2026-13-01. */\nfunction isRealDate(iso: string): boolean {\n  const [y, m, d] = iso.split('-').map(Number) as [number, number, number];\n  if (m < 1 || m > 12 || d < 1) return false;\n  const asDate = new Date(Date.UTC(y, m - 1, d));\n  return (\n    asDate.getUTCFullYear() === y && asDate.getUTCMonth() === m - 1 && asDate.getUTCDate() === d\n  );\n}\n\n/**\n * Date of birth, with the age gate applied per parse.\n *\n * ⚠️ THE CLIENT IS NOT THE GATE. This schema exists so the member sees a useful\n * message, and the server must refuse the same dates at finalize regardless.\n * The sibling dating product validates the identical rule on its client and\n * still shipped a defect where an under-age date of birth produced a live,\n * discoverable profile, because the client was the only thing checking.\n */\nexport const dateOfBirthSchema = isoDateSchema\n  .refine(isRealDate, { message: 'That date does not exist' })\n  .refine((v) => ageInYears(v) >= MIN_AGE_YEARS, {\n    message: `You must be at least ${MIN_AGE_YEARS} to join`,\n  })\n  .refine((v) => ageInYears(v) <= MAX_AGE_YEARS, { message: 'Check the year of birth' });\n\n// ─── Business ────────────────────────────────────────────────────────────────\n\nexport const BUSINESS_TYPE_VALUES = ['startup', 'sme', 'enterprise'] as const;\nexport const businessTypeSchema = z.enum(BUSINESS_TYPE_VALUES);\nexport type BusinessType = z.infer<typeof businessTypeSchema>;\n\n// ─── Topics: the shared vocabulary ───────────────────────────────────────────────────────────────\n\n/**\n * ONE vocabulary, used TWICE: a member picks these as their `interests`, and a\n * post carries them as its `topics`. That is what makes relevance an index\n * lookup rather than a guess, and it is why this list is not called \"interests\"\n * - naming it for one of its two jobs would have invited a second list for the\n * other, which is the mistake this package has already made once with goals.\n * (User's ruling via hary, 2026-09-21.)\n *\n * Deliberately DISTINCT from two neighbours that will otherwise collect the\n * same words:\n *\n *   industry  what your company does\n *   skills    what you can do\n *   interests what you want to read about\n *\n * If the copy does not keep them apart, members fill all three identically and\n * every one of them stops telling us anything.\n *\n * A closed list, consistent with industry, skill and stage, for the reason\n * already written beside those: free text means two people typing \"growth\" and\n * \"Growth Marketing\" never match, and matching is the entire point. The cost is\n * that adding an interest needs a publish.\n *\n * Tuned down from the dating product's 246, which is mostly dating material.\n * Values reuse its exact strings wherever one existed, so its Hindi\n * translations can be lifted across.\n *\n * ⚠️ Stored per member. Append only; removing a value orphans data.\n */\nexport const TOPIC_VALUES = [\n  // Career growth\n  'mentoring',\n  'leadership',\n  'networking',\n  'public_speaking',\n  'teaching',\n  'hiring_talent',\n  'personal_branding',\n  'career_transition',\n  'remote_work',\n  // Innovation and tech\n  'ai_ml',\n  'blockchain',\n  'crypto_web3',\n  'robotics',\n  'data_science',\n  'cybersecurity',\n  'game_dev',\n  'ux_design',\n  'app_development',\n  'open_source',\n  'electronics',\n  'space_exploration',\n  'green_tech',\n  'deeptech',\n  'no_code',\n  // Business\n  'entrepreneurship',\n  'investing',\n  'stock_trading',\n  'personal_finance',\n  'fundraising',\n  'marketing',\n  'sales',\n  'consulting',\n  'ecommerce',\n  'retail',\n  'real_estate',\n  'supply_chain',\n  'product_management',\n  'growth',\n  'b2b_saas',\n  'd2c',\n  // Personal development\n  'meditation',\n  'journaling',\n  'self_improvement',\n  'productivity',\n  'reading',\n  'online_courses',\n  'philosophy',\n  'psychology',\n  'therapy',\n  'sleep_optimization',\n  'gym',\n  'yoga',\n  // Creative\n  'photography',\n  'writing',\n  'graphic_design',\n  'filmmaking',\n  'digital_art',\n  'content_creation',\n  'blogging',\n  'vlogging',\n  'podcasts',\n  'animation',\n  'music_production',\n  // Impact and community\n  'volunteering',\n  'ngo_work',\n  'environmental',\n  'women_empowerment',\n  'community_service',\n  'social_enterprise',\n  'education_access',\n] as const;\nexport const topicSchema = z.enum(TOPIC_VALUES);\nexport type Topic = z.infer<typeof topicSchema>;\n\n/**\n * The grouping the picker renders.\n *\n * ⚠️ `TOPIC_VALUES` above is the single source of truth and this is typed\n * against it, so a typo here is a compile error rather than a chip that renders\n * and can never be selected. The dating product keeps a categorised list and a\n * flat list side by side and they have already drifted apart by two values;\n * a test in this package asserts these two agree exactly, in both directions.\n */\nexport interface TopicCategory {\n  key: string;\n  label: string;\n  values: readonly Topic[];\n}\n\nexport const TOPIC_CATEGORIES: readonly TopicCategory[] = [\n  {\n    key: 'career',\n    label: 'Career Growth',\n    values: [\n      'mentoring',\n      'leadership',\n      'networking',\n      'public_speaking',\n      'teaching',\n      'hiring_talent',\n      'personal_branding',\n      'career_transition',\n      'remote_work',\n    ],\n  },\n  {\n    key: 'tech',\n    label: 'Innovation & Tech',\n    values: [\n      'ai_ml',\n      'blockchain',\n      'crypto_web3',\n      'robotics',\n      'data_science',\n      'cybersecurity',\n      'game_dev',\n      'ux_design',\n      'app_development',\n      'open_source',\n      'electronics',\n      'space_exploration',\n      'green_tech',\n      'deeptech',\n      'no_code',\n    ],\n  },\n  {\n    key: 'business',\n    label: 'Business',\n    values: [\n      'entrepreneurship',\n      'investing',\n      'stock_trading',\n      'personal_finance',\n      'fundraising',\n      'marketing',\n      'sales',\n      'consulting',\n      'ecommerce',\n      'retail',\n      'real_estate',\n      'supply_chain',\n      'product_management',\n      'growth',\n      'b2b_saas',\n      'd2c',\n    ],\n  },\n  {\n    key: 'growth',\n    label: 'Personal Development',\n    values: [\n      'meditation',\n      'journaling',\n      'self_improvement',\n      'productivity',\n      'reading',\n      'online_courses',\n      'philosophy',\n      'psychology',\n      'therapy',\n      'sleep_optimization',\n      'gym',\n      'yoga',\n    ],\n  },\n  {\n    key: 'creative',\n    label: 'Creative Arts',\n    values: [\n      'photography',\n      'writing',\n      'graphic_design',\n      'filmmaking',\n      'digital_art',\n      'content_creation',\n      'blogging',\n      'vlogging',\n      'podcasts',\n      'animation',\n      'music_production',\n    ],\n  },\n  {\n    key: 'impact',\n    label: 'Impact & Community',\n    values: [\n      'volunteering',\n      'ngo_work',\n      'environmental',\n      'women_empowerment',\n      'community_service',\n      'social_enterprise',\n      'education_access',\n    ],\n  },\n];\n\n/**\n * How many a member must pick. A minimum exists because these drive feed\n * relevance and zero of them means no relevance at all.\n *\n * ⚠️ If 3 turns out to be hard to reach against this list, that is a signal\n * about the LIST, not about the minimum. The sibling product enforces no\n * minimum at all, and its own field config says \"pick up to 10\" while every\n * screen and schema enforces 20.\n */\n/**\n * ⚠️ TRANSLATION KEY SHAPE, for whoever builds the picker:\n * `<fieldKey>.<value>` for a value and `<fieldKey>._label` for the field name.\n * The dating product's interests JSON is keyed by CATEGORY instead, so all five\n * of its label lookups miss and every chip renders its raw English in every\n * locale, with a fully translated Hindi file sitting unreachable. Lift the\n * translations, reshape the keys.\n */\nexport const INTERESTS_MIN = 3;\nexport const INTERESTS_MAX = 10;\n\n// ─── The step list ───────────────────────────────────────────────────────────\n\n/**\n * One step of the wizard.\n *\n * `fields` is what gates leaving this step, and it is why this list and the\n * validation map are the same object: a field that appears in no step is\n * unreachable twice over, because Continue will not surface its error and the\n * final submit's jump-to-the-bad-step finds no step to jump to and leaves the\n * last screen dead.\n */\nexport interface OnboardingStepConfig {\n  /** Stable identifier. Safe for analytics and for a resume cursor, unlike an index. */\n  key: string;\n  title: string;\n  helpText: string;\n  fields: readonly string[];\n  /** False when the whole step may be passed without answering anything. */\n  required: boolean;\n}\n\nexport const FOUNDER_ONBOARDING_STEPS: readonly OnboardingStepConfig[] = [\n  {\n    key: 'identity',\n    title: \"We'd love to hear more about you\",\n    helpText: 'This is what other founders see first.',\n    fields: ['displayName', 'gender', 'dateOfBirth', 'headline', 'about', 'avatarUploadKey'],\n    required: true,\n  },\n  {\n    key: 'contact',\n    title: 'How can people reach you?',\n    helpText: 'Your number is never shown on your profile.',\n    fields: ['phone', 'links'],\n    required: true,\n  },\n  {\n    key: 'location',\n    title: 'Where are you based?',\n    helpText: 'Used to show founders near you. You can skip this.',\n    fields: ['location'],\n    required: false,\n  },\n  {\n    key: 'goals',\n    title: 'Goals & Passion',\n    helpText: 'Pick what matters most to you.',\n    fields: ['goals'],\n    required: true,\n  },\n  {\n    key: 'interests',\n    title: 'What inspires you the most?',\n    helpText: 'We use these to shape your feed.',\n    fields: ['interests'],\n    required: true,\n  },\n  {\n    key: 'business',\n    title: 'Tell us about your business',\n    helpText: 'Skip it if you are still figuring things out.',\n    fields: ['venture', 'businessType'],\n    required: false,\n  },\n  {\n    key: 'guidelines',\n    title: 'How we behave here',\n    helpText: 'A short read, and the only rule that matters.',\n    fields: ['guidelinesVersion'],\n    required: true,\n  },\n];\n\nexport const ONBOARDING_TOTAL_STEPS = FOUNDER_ONBOARDING_STEPS.length;\n\n/**\n * Fields gating each step, DERIVED from the list above so the two can never\n * disagree.\n */\nexport const ONBOARDING_STEP_FIELDS: readonly (readonly string[])[] = FOUNDER_ONBOARDING_STEPS.map(\n  (s) => s.fields,\n);\n\n// ─── Contact ─────────────────────────────────────────────────────────────────\n\n/**\n * Indian mobile number, ten digits, stored raw with no country code, matching\n * the standard used across this family. Display adds `+91`.\n */\nexport const contactLinksSchema = z.object({\n  linkedin: httpUrlSchema.optional(),\n  x: httpUrlSchema.optional(),\n  instagram: httpUrlSchema.optional(),\n});\n\n// ─── The form, mid-flight ────────────────────────────────────────────────────\n\n/**\n * The wizard's working shape.\n *\n * Every choice is nullable because \"not answered yet\" is a real state here and\n * is NOT the same as \"answered with nothing\". Arrays start empty. Nothing in\n * this schema is required, on purpose: it describes a form somebody is halfway\n * through, and the rules that decide whether they may FINISH live in\n * `completeOnboardingBodySchema`.\n */\nexport const onboardingFormSchema = z.object({\n  displayName: z.string().trim().max(80),\n  gender: genderSchema.nullable(),\n  dateOfBirth: z.string().trim(),\n  headline: z.string().trim().max(120),\n  about: z.string().trim().max(1000),\n  avatarUploadKey: z.string().trim().nullable(),\n\n  phone: z.string().trim(),\n  links: contactLinksSchema,\n\n  location: z\n    .object({\n      city: z.string().trim().max(80),\n      state: z.string().trim().max(80),\n      country: z.string().trim().max(80),\n    })\n    .nullable(),\n\n  goals: z.array(goalSchema).max(GOAL_VALUES.length),\n  interests: z.array(topicSchema).max(INTERESTS_MAX),\n\n  venture: z\n    .object({\n      name: z.string().trim().max(120),\n      tagline: z.string().trim().max(160),\n      website: z.string().trim(),\n      industry: industrySchema.nullable(),\n      stage: startupStageSchema.nullable(),\n      teamSize: z.string().trim(),\n    })\n    .nullable(),\n  businessType: businessTypeSchema.nullable(),\n  skills: z.array(skillSchema).max(8),\n\n  guidelinesVersion: z.string().trim().nullable(),\n});\nexport type OnboardingForm = z.infer<typeof onboardingFormSchema>;\n\n// ─── The finalize body ───────────────────────────────────────────────────────\n\n/**\n * What the client sends to finish. Completed answers only.\n *\n * ⚠️ EVERY OPTIONAL FIELD HERE MUST BE ABSENT WHEN UNANSWERED, never a default\n * standing in for one. The sibling gym product sent `bloodGroup ?? 'O+'`, so\n * every member who skipped the question was recorded as O-positive: a real\n * answer, indistinguishable from one somebody gave, sitting on a screen staff\n * would read in an emergency. Absent has to stay absent.\n *\n * ⚠️ AND THIS IS NOT THE GATE EITHER. The server re-checks the age and refuses\n * at finalize. `isOnboarded` may be set here and nowhere else: four of the\n * profile's partial indexes are gated on it, so a half-built profile carrying\n * it true appears in Discover half-built.\n */\nexport const completeOnboardingBodySchema = z.object({\n  displayName: z.string().trim().min(1, 'Tell us your name').max(80),\n  /**\n   * ⚠️ NO `username` HERE, and its absence is deliberate.\n   *\n   * It used to be required, and that was a defect: no onboarding step collects\n   * one, the design draws no screen for one, and it was not even on the\n   * in-progress form, so a finalize could never have succeeded. Found by\n   * checking every finalize-required field against the step list; a test now\n   * asserts that relationship in both directions.\n   *\n   * The handle is DERIVED SERVER-SIDE at finalize and edited later from the Me\n   * tab, which is what the product describes. That also makes the collision\n   * case kinder: a server deriving a handle can suffix it and move on, whereas\n   * a member who picked one six steps ago can only be told, at the end, that\n   * step one failed.\n   */\n  gender: genderSchema,\n  dateOfBirth: dateOfBirthSchema,\n  headline: optionalTrimmedString(120),\n  about: optionalTrimmedString(1000),\n  avatarUploadKey: z.string().trim().min(1).optional(),\n\n  phone: phoneSchema,\n  links: contactLinksSchema.optional(),\n\n  /** Absent when the member skipped the step or refused the permission. */\n  location: z\n    .object({\n      city: z.string().trim().min(1).max(80),\n      state: optionalTrimmedString(80),\n      country: z.string().trim().min(1).max(80),\n    })\n    .optional(),\n\n  goals: z.array(goalSchema).min(1, 'Pick at least one').max(GOAL_VALUES.length),\n  interests: z\n    .array(topicSchema)\n    .min(INTERESTS_MIN, `Pick at least ${INTERESTS_MIN}`)\n    .max(INTERESTS_MAX),\n  skills: z.array(skillSchema).max(8).optional(),\n\n  /** Absent when the member skipped the business step. */\n  venture: z\n    .object({\n      name: z.string().trim().min(1).max(120),\n      tagline: optionalTrimmedString(160),\n      website: httpUrlSchema.optional(),\n      industry: industrySchema,\n      stage: startupStageSchema,\n      teamSize: z.coerce.number().int().min(1).max(100000).optional(),\n    })\n    .optional(),\n  businessType: businessTypeSchema.optional(),\n\n  /**\n   * The version of the guidelines this member read.\n   *\n   * A version and not a boolean, and the server stamps the time. A boolean says\n   * somebody agreed; a version and a timestamp say WHAT they agreed to and\n   * WHEN, which is the only form worth anything the day the text changes or a\n   * moderation decision is disputed.\n   */\n  guidelinesVersion: z.string().trim().min(1),\n});\nexport type CompleteOnboardingBody = z.infer<typeof completeOnboardingBodySchema>;\n\n// ─── The resume cursor ───────────────────────────────────────────────────────\n\n/**\n * Where the member got to, kept in its own collection, separate from the\n * profile.\n *\n * `step` is a flat index into `FOUNDER_ONBOARDING_STEPS`, not a `(step, sub)`\n * pair: one number is what lets a member start on the web and resume elsewhere,\n * provided both ends agree on the encoding.\n *\n * `draft` is opaque here on purpose. The client owns the form's shape, and it is\n * re-validated strictly at finalize, so this schema has no business describing\n * it.\n */\nexport const onboardingDraftSchema = z.record(z.string(), z.unknown());\n\nexport const onboardingProgressSchema = z.object({\n  step: z.number().int().min(0).max(ONBOARDING_TOTAL_STEPS),\n  draft: onboardingDraftSchema.optional(),\n});\nexport type OnboardingProgress = z.infer<typeof onboardingProgressSchema>;\n\n/** `PUT` body: any subset of the cursor, merged server-side. No defaults. */\nexport const onboardingProgressUpdateSchema = z.object({\n  step: z.number().int().min(0).max(ONBOARDING_TOTAL_STEPS).optional(),\n  draft: onboardingDraftSchema.optional(),\n});\nexport type OnboardingProgressUpdate = z.infer<typeof onboardingProgressUpdateSchema>;\n\n/**\n * What the client reads on return.\n *\n * ⚠️ `onboarded` is the gate and it comes from the profile, not from the\n * cursor: a finished member on a new device must be recognised even when the\n * cursor row is gone, and a cursor that failed to load must never make an\n * unfinished member look finished.\n */\nexport const onboardingStatusSchema = z.object({\n  onboarded: z.boolean(),\n  step: z.number().int().min(0),\n  draft: onboardingDraftSchema.optional(),\n});\nexport type OnboardingStatus = z.infer<typeof onboardingStatusSchema>;\n"]}
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../src/onboarding.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema — Onboarding: steps, enums, and the two shapes of the answers\n *\n * ONE LIST DEFINES THE FLOW, AND IT IS DERIVED. Each step's fields are a pick\n * of the finish body (`ONBOARDING_STEP_SCHEMAS`), and `FOUNDER_ONBOARDING_STEPS`\n * is built FROM those picks: its `fields`, and even whether a step may be\n * skipped, come from the schema rather than from a second hand-written list.\n * GymMonk arrived at one list after keeping two in sync by hand, where a step\n * could exist with no title or, worse, no validation gate at all; until 0.2.0\n * this file still wrote the field lists twice.\n *\n * TWO SHAPES, ONE SET OF RULES. A half-filled form legitimately holds `null`\n * for a choice nobody has made yet; the finalize body only ever sees completed\n * answers. So the rules are written once and expressed over both shapes:\n * `onboardingFormSchema` for work in progress and `completeOnboardingBodySchema`\n * for the end. Letting those two drift is how a wizard says a step is optional\n * and then answers 422 at Finish.\n *\n * NO COPY IN HERE. Step titles, help lines and topic category names are\n * translation KEYS (`titleKey`, `helpKey`, `labelKey`), Jansathi's rule for\n * every config string: an English sentence in a shared package is a sentence\n * every other language has to match by wording.\n *\n * @module founder-schema/onboarding\n */\n\nimport { z } from 'zod';\nimport {\n  GOAL_VALUES,\n  genderSchema,\n  goalSchema,\n  industrySchema,\n  locationSchema,\n  optionalTrimmedString,\n  phoneSchema,\n  skillSchema,\n  startupStageSchema,\n} from './common.js';\nimport { founderLinksSchema, ventureSchema } from './founder-profile.js';\nimport {\n  ABOUT_MAX,\n  CITY_MAX,\n  COUNTRY_MAX,\n  DISPLAY_NAME_MAX,\n  GOALS_MIN,\n  HEADLINE_MAX,\n  SKILLS_MAX,\n  STATE_MAX,\n  VENTURE_NAME_MAX,\n  VENTURE_TAGLINE_MAX,\n} from './limits.js';\nimport { uploadKeySchema } from './uploads.js';\nimport { VALIDATION_MESSAGE } from './validation.js';\n\n// ─── Age ─────────────────────────────────────────────────────────────────────\n\n/**\n * 18, ruled by the user 2026-09-21. Under-18 would pull in parental-consent\n * duties under the DPDP Act, which is a different and larger problem than a\n * validation rule.\n *\n * ⚠️ The SERVER refuses at finalize. This schema exists so the member sees a\n * useful message; it is not the gate.\n */\nexport const MIN_AGE_YEARS = 18;\n/** A sanity ceiling, not a product rule. Catches a mistyped year. */\nexport const MAX_AGE_YEARS = 120;\n\n/**\n * Whole years completed, by the calendar.\n *\n * ⚠️ NOT `elapsedMs / (365.25 * day)`, which is what the sibling product uses.\n * That approximation reads 17.9986 at the start of somebody's eighteenth\n * birthday and only crosses 18 about halfway through the day, so it refuses\n * them for the half of their birthday they are most likely to be signing up on.\n * Measured: it disagrees with the calendar on all 400 of the next 400 days.\n * An age gate is exactly the place an approximation is not good enough.\n */\nexport function ageInYears(isoDate: string, now: Date = new Date()): number {\n  // ⚠️ A STRING, `YYYY-MM-DD`, not a `Date`. This is a wire contract, so it\n  // takes the wire type. The backend is the obvious caller and the backend\n  // holds a `Date`, so it must format first; passing the Date straight in used\n  // to fail with `isoDate.split is not a function`, which says nothing useful.\n  // Naming the fix costs one line and saves the next person the detour.\n  if (typeof isoDate !== 'string') {\n    throw new TypeError(\n      'ageInYears expects a YYYY-MM-DD string, not a Date. Format it first, e.g. date.toISOString().slice(0, 10).',\n    );\n  }\n  const [y, m, d] = isoDate.split('-').map(Number) as [number, number, number];\n  let age = now.getUTCFullYear() - y;\n  const monthNow = now.getUTCMonth() + 1;\n  if (monthNow < m || (monthNow === m && now.getUTCDate() < d)) age -= 1;\n  return age;\n}\n\n/** A calendar date with no time component, `YYYY-MM-DD`. */\nexport const isoDateSchema = z\n  .string()\n  .trim()\n  .regex(/^\\d{4}-\\d{2}-\\d{2}$/, VALIDATION_MESSAGE.dateInvalid);\nexport type IsoDate = z.infer<typeof isoDateSchema>;\n\n/** True only for a date that exists. Rejects 2026-02-30 and 2026-13-01. */\nfunction isRealDate(iso: string): boolean {\n  const [y, m, d] = iso.split('-').map(Number) as [number, number, number];\n  if (m < 1 || m > 12 || d < 1) return false;\n  const asDate = new Date(Date.UTC(y, m - 1, d));\n  return (\n    asDate.getUTCFullYear() === y && asDate.getUTCMonth() === m - 1 && asDate.getUTCDate() === d\n  );\n}\n\n/**\n * Date of birth, with the age gate applied per parse.\n *\n * ⚠️ THE CLIENT IS NOT THE GATE. This schema exists so the member sees a useful\n * message, and the server must refuse the same dates at finalize regardless.\n * The sibling dating product validates the identical rule on its client and\n * still shipped a defect where an under-age date of birth produced a live,\n * discoverable profile, because the client was the only thing checking.\n */\nexport const dateOfBirthSchema = isoDateSchema\n  .refine(isRealDate, { error: VALIDATION_MESSAGE.dobInvalid })\n  .refine((v) => ageInYears(v) >= MIN_AGE_YEARS, { error: VALIDATION_MESSAGE.dobUnderAge })\n  .refine((v) => ageInYears(v) <= MAX_AGE_YEARS, { error: VALIDATION_MESSAGE.dobTooOld });\nexport type DateOfBirth = z.infer<typeof dateOfBirthSchema>;\n\n// ─── Business ────────────────────────────────────────────────────────────────\n\nexport const BUSINESS_TYPE_VALUES = ['startup', 'sme', 'enterprise'] as const;\nexport const businessTypeSchema = z.enum(BUSINESS_TYPE_VALUES);\nexport type BusinessType = z.infer<typeof businessTypeSchema>;\n\n// ─── Topics: the shared vocabulary ───────────────────────────────────────────────────────────────\n\n/**\n * ONE vocabulary, used TWICE: a member picks these as their `interests`, and a\n * post carries them as its `topics`. That is what makes relevance an index\n * lookup rather than a guess, and it is why this list is not called \"interests\"\n * - naming it for one of its two jobs would have invited a second list for the\n * other, which is the mistake this package has already made once with goals.\n * (User's ruling via hary, 2026-09-21.)\n *\n * Deliberately DISTINCT from two neighbours that will otherwise collect the\n * same words:\n *\n *   industry  what your company does\n *   skills    what you can do\n *   interests what you want to read about\n *\n * If the copy does not keep them apart, members fill all three identically and\n * every one of them stops telling us anything.\n *\n * A closed list, consistent with industry, skill and stage, for the reason\n * already written beside those: free text means two people typing \"growth\" and\n * \"Growth Marketing\" never match, and matching is the entire point. The cost is\n * that adding an interest needs a publish.\n *\n * Tuned down from the dating product's 246, which is mostly dating material.\n * Values reuse its exact strings wherever one existed, so its Hindi\n * translations can be lifted across.\n *\n * ⚠️ Stored per member. Append only; removing a value orphans data.\n */\nexport const TOPIC_VALUES = [\n  // Career growth\n  'mentoring',\n  'leadership',\n  'networking',\n  'public_speaking',\n  'teaching',\n  'hiring_talent',\n  'personal_branding',\n  'career_transition',\n  'remote_work',\n  // Innovation and tech\n  'ai_ml',\n  'blockchain',\n  'crypto_web3',\n  'robotics',\n  'data_science',\n  'cybersecurity',\n  'game_dev',\n  'ux_design',\n  'app_development',\n  'open_source',\n  'electronics',\n  'space_exploration',\n  'green_tech',\n  'deeptech',\n  'no_code',\n  // Business\n  'entrepreneurship',\n  'investing',\n  'stock_trading',\n  'personal_finance',\n  'fundraising',\n  'marketing',\n  'sales',\n  'consulting',\n  'ecommerce',\n  'retail',\n  'real_estate',\n  'supply_chain',\n  'product_management',\n  'growth',\n  'b2b_saas',\n  'd2c',\n  // Personal development\n  'meditation',\n  'journaling',\n  'self_improvement',\n  'productivity',\n  'reading',\n  'online_courses',\n  'philosophy',\n  'psychology',\n  'therapy',\n  'sleep_optimization',\n  'gym',\n  'yoga',\n  // Creative\n  'photography',\n  'writing',\n  'graphic_design',\n  'filmmaking',\n  'digital_art',\n  'content_creation',\n  'blogging',\n  'vlogging',\n  'podcasts',\n  'animation',\n  'music_production',\n  // Impact and community\n  'volunteering',\n  'ngo_work',\n  'environmental',\n  'women_empowerment',\n  'community_service',\n  'social_enterprise',\n  'education_access',\n] as const;\nexport const topicSchema = z.enum(TOPIC_VALUES);\nexport type Topic = z.infer<typeof topicSchema>;\n\n/**\n * The grouping the picker renders.\n *\n * ⚠️ `TOPIC_VALUES` above is the single source of truth and this is typed\n * against it, so a typo here is a compile error rather than a chip that renders\n * and can never be selected. The dating product keeps a categorised list and a\n * flat list side by side and they have already drifted apart by two values;\n * a test in this package asserts these two agree exactly, in both directions.\n */\nexport const TOPIC_CATEGORY_KEYS = [\n  'career',\n  'tech',\n  'business',\n  'growth',\n  'creative',\n  'impact',\n] as const;\nexport type TopicCategoryKey = (typeof TOPIC_CATEGORY_KEYS)[number];\n\n/**\n * ⚠ TRANSLATION KEY SHAPE, for whoever builds the picker: `topics.category.<key>`\n * for a category and `topics.value.<topic>` for a topic. The dating product's\n * interests JSON is keyed by CATEGORY NAME instead, so all five of its label\n * lookups miss and every chip renders its raw English in every locale, with a\n * fully translated Hindi file sitting unreachable.\n */\nexport interface TopicCategory {\n  key: TopicCategoryKey;\n  /** A translation key. The English lives in the client's message files, not here. */\n  labelKey: `topics.category.${TopicCategoryKey}`;\n  values: readonly Topic[];\n}\n\nconst topicCategory = (key: TopicCategoryKey, values: readonly Topic[]): TopicCategory => ({\n  key,\n  labelKey: `topics.category.${key}`,\n  values,\n});\n\nexport const TOPIC_CATEGORIES: readonly TopicCategory[] = [\n  topicCategory('career', [\n    'mentoring',\n    'leadership',\n    'networking',\n    'public_speaking',\n    'teaching',\n    'hiring_talent',\n    'personal_branding',\n    'career_transition',\n    'remote_work',\n  ]),\n  topicCategory('tech', [\n    'ai_ml',\n    'blockchain',\n    'crypto_web3',\n    'robotics',\n    'data_science',\n    'cybersecurity',\n    'game_dev',\n    'ux_design',\n    'app_development',\n    'open_source',\n    'electronics',\n    'space_exploration',\n    'green_tech',\n    'deeptech',\n    'no_code',\n  ]),\n  topicCategory('business', [\n    'entrepreneurship',\n    'investing',\n    'stock_trading',\n    'personal_finance',\n    'fundraising',\n    'marketing',\n    'sales',\n    'consulting',\n    'ecommerce',\n    'retail',\n    'real_estate',\n    'supply_chain',\n    'product_management',\n    'growth',\n    'b2b_saas',\n    'd2c',\n  ]),\n  topicCategory('growth', [\n    'meditation',\n    'journaling',\n    'self_improvement',\n    'productivity',\n    'reading',\n    'online_courses',\n    'philosophy',\n    'psychology',\n    'therapy',\n    'sleep_optimization',\n    'gym',\n    'yoga',\n  ]),\n  topicCategory('creative', [\n    'photography',\n    'writing',\n    'graphic_design',\n    'filmmaking',\n    'digital_art',\n    'content_creation',\n    'blogging',\n    'vlogging',\n    'podcasts',\n    'animation',\n    'music_production',\n  ]),\n  topicCategory('impact', [\n    'volunteering',\n    'ngo_work',\n    'environmental',\n    'women_empowerment',\n    'community_service',\n    'social_enterprise',\n    'education_access',\n  ]),\n];\n\n/**\n * How many a member must pick. A minimum exists because these drive feed\n * relevance and zero of them means no relevance at all.\n *\n * ⚠️ If 3 turns out to be hard to reach against this list, that is a signal\n * about the LIST, not about the minimum. The sibling product enforces no\n * minimum at all, and its own field config says \"pick up to 10\" while every\n * screen and schema enforces 20.\n */\nexport const INTERESTS_MIN = 3;\nexport const INTERESTS_MAX = 10;\n\n// ─── The step keys ───────────────────────────────────────────────────────────\n\n/**\n * The step keys, in order, as a literal union, so a consumer can key a table by\n * step and have TypeScript insist on every one. Before 0.2.0 `key` was a plain\n * string and the web client kept its own copy of this list to get the same\n * check; a test there held the two together. Now there is one list.\n */\nexport const ONBOARDING_STEP_KEYS = [\n  'identity',\n  'contact',\n  'location',\n  'goals',\n  'interests',\n  'business',\n  'guidelines',\n] as const;\nexport type OnboardingStepKey = (typeof ONBOARDING_STEP_KEYS)[number];\n\n// ─── Guidelines ──────────────────────────────────────────────────────────────\n\n/**\n * The community guidelines a member agrees to at the last step, by version.\n *\n * The finish body accepts THIS version and no other: an old tab still showing\n * last month's text cannot record agreement to text it never displayed, and\n * `'whatever'` is not a version. Until 0.2.0 any non-empty string passed, and\n * the web client held this constant on its own.\n *\n * ⚠ Changing the guidelines text means bumping this, in the same publish.\n * Every member who agreed to an earlier version keeps that version on their\n * profile; that record is the point.\n */\nexport const GUIDELINES_VERSION = '2026-10-03' as const;\nexport const guidelinesVersionSchema = z.literal(GUIDELINES_VERSION, {\n  error: VALIDATION_MESSAGE.guidelinesOutdated,\n});\n\n// ─── Contact ─────────────────────────────────────────────────────────────────\n\n/**\n * The links the contact step collects, picked from the profile's own links so\n * the two cannot disagree on what a link is. The phone is `phoneSchema`: ten\n * digits, stored raw with no country code, on the account rather than here.\n */\nexport const contactLinksSchema = founderLinksSchema.pick({\n  linkedin: true,\n  x: true,\n  instagram: true,\n});\nexport type ContactLinks = z.infer<typeof contactLinksSchema>;\n\n// ─── The form, mid-flight ────────────────────────────────────────────────────\n\n/**\n * The wizard's working shape.\n *\n * Every choice is nullable because \"not answered yet\" is a real state here and\n * is NOT the same as \"answered with nothing\". Arrays start empty. Nothing in\n * this schema is required, on purpose: it describes a form somebody is halfway\n * through, and the rules that decide whether they may FINISH live in\n * `completeOnboardingBodySchema`.\n *\n * Text inputs stay text here (`teamSize`, `dateOfBirth`), because that is what\n * an input holds while somebody types; the form converts them when it builds\n * the finish body, which takes real numbers.\n */\nexport const onboardingFormSchema = z.object({\n  displayName: z.string().trim().max(DISPLAY_NAME_MAX),\n  gender: genderSchema.nullable(),\n  dateOfBirth: z.string().trim(),\n  headline: z.string().trim().max(HEADLINE_MAX),\n  about: z.string().trim().max(ABOUT_MAX),\n  /** Only ever a key the server minted for this member. */\n  avatarUploadKey: uploadKeySchema.nullable(),\n\n  phone: z.string().trim(),\n  links: contactLinksSchema,\n\n  location: z\n    .object({\n      city: z.string().trim().max(CITY_MAX),\n      state: z.string().trim().max(STATE_MAX),\n      country: z.string().trim().max(COUNTRY_MAX),\n    })\n    .nullable(),\n\n  goals: z.array(goalSchema).max(GOAL_VALUES.length),\n  interests: z.array(topicSchema).max(INTERESTS_MAX),\n\n  venture: z\n    .object({\n      name: z.string().trim().max(VENTURE_NAME_MAX),\n      tagline: z.string().trim().max(VENTURE_TAGLINE_MAX),\n      website: z.string().trim(),\n      industry: industrySchema.nullable(),\n      stage: startupStageSchema.nullable(),\n      teamSize: z.string().trim(),\n    })\n    .nullable(),\n  businessType: businessTypeSchema.nullable(),\n  skills: z.array(skillSchema).max(SKILLS_MAX),\n\n  guidelinesVersion: z.string().trim().nullable(),\n});\nexport type OnboardingForm = z.infer<typeof onboardingFormSchema>;\n\n// ─── The finalize body ───────────────────────────────────────────────────────\n\n/**\n * What the client sends to finish. Completed answers only.\n *\n * ⚠️ EVERY OPTIONAL FIELD HERE MUST BE ABSENT WHEN UNANSWERED, never a default\n * standing in for one. The sibling gym product sent `bloodGroup ?? 'O+'`, so\n * every member who skipped the question was recorded as O-positive: a real\n * answer, indistinguishable from one somebody gave, sitting on a screen staff\n * would read in an emergency. Absent has to stay absent.\n *\n * ⚠️ AND THIS IS NOT THE GATE EITHER. The server re-checks the age and refuses\n * at finalize. `isOnboarded` may be set here and nowhere else: four of the\n * profile's partial indexes are gated on it, so a half-built profile carrying\n * it true appears in Discover half-built.\n *\n * Location, venture and links are the profile's own shapes, not copies: the\n * copies are how the profile model came to lack Instagram.\n */\nexport const completeOnboardingBodySchema = z.object({\n  // Plain bounds, no custom message: `too_small` with minimum 1 already says\n  // \"required\", and the client words it in the member's language.\n  displayName: z.string().trim().min(1).max(DISPLAY_NAME_MAX),\n  /**\n   * ⚠️ NO `username` HERE, and its absence is deliberate.\n   *\n   * It used to be required, and that was a defect: no onboarding step collects\n   * one, the design draws no screen for one, and it was not even on the\n   * in-progress form, so a finalize could never have succeeded. Found by\n   * checking every finalize-required field against the step list; a test now\n   * asserts that relationship in both directions.\n   *\n   * The handle is DERIVED SERVER-SIDE at finalize and edited later from the Me\n   * tab, which is what the product describes. That also makes the collision\n   * case kinder: a server deriving a handle can suffix it and move on, whereas\n   * a member who picked one six steps ago can only be told, at the end, that\n   * step one failed.\n   */\n  gender: genderSchema,\n  dateOfBirth: dateOfBirthSchema,\n  headline: optionalTrimmedString(HEADLINE_MAX),\n  about: optionalTrimmedString(ABOUT_MAX),\n  /**\n   * The key the presign handed out, in the minted format. It was a bare\n   * string until 0.2.0, so `'../../etc/passwd'` passed this schema and only\n   * the server's own commit check stood in the way.\n   */\n  avatarUploadKey: uploadKeySchema.optional(),\n\n  phone: phoneSchema,\n  links: contactLinksSchema.optional(),\n\n  /** Absent when the member skipped the step or refused the permission. */\n  location: locationSchema.optional(),\n\n  goals: z.array(goalSchema).min(GOALS_MIN).max(GOAL_VALUES.length),\n  interests: z.array(topicSchema).min(INTERESTS_MIN).max(INTERESTS_MAX),\n  skills: z.array(skillSchema).max(SKILLS_MAX).optional(),\n\n  /**\n   * Absent when the member skipped the business step. The profile's venture\n   * without `foundedYear`, which onboarding does not ask; the Me tab does.\n   */\n  venture: ventureSchema.omit({ foundedYear: true }).optional(),\n  businessType: businessTypeSchema.optional(),\n\n  /**\n   * The version of the guidelines this member read: `GUIDELINES_VERSION`,\n   * exactly.\n   *\n   * A version and not a boolean, and the server stamps the time. A boolean says\n   * somebody agreed; a version and a timestamp say WHAT they agreed to and\n   * WHEN, which is the only form worth anything the day the text changes or a\n   * moderation decision is disputed.\n   */\n  guidelinesVersion: guidelinesVersionSchema,\n});\nexport type CompleteOnboardingBody = z.infer<typeof completeOnboardingBodySchema>;\n/** What a form may hand to the finish body before parsing. */\nexport type CompleteOnboardingBodyInput = z.input<typeof completeOnboardingBodySchema>;\n\n// ─── The steps ───────────────────────────────────────────────────────────────\n\n/**\n * Each step's slice of the finish body, picked FROM it, so a client validating\n * \"may I leave this step\" and the server validating the finish apply the very\n * same rules. A copy would drift, and the drift shows up as a wizard that lets\n * a step pass and a finish that refuses it, on the last screen.\n *\n * THIS IS THE ONE PLACE A STEP'S FIELDS ARE WRITTEN. `FOUNDER_ONBOARDING_STEPS`\n * below reads them from here. A test asserts that every finish field belongs to\n * exactly one step.\n *\n * These validate the FINISH shape (skipped = absent), not the in-progress form:\n * a client maps its form state to the slice first. The server does not run them\n * on a draft save, because a half-answered step must be storable.\n */\nexport const ONBOARDING_STEP_SCHEMAS = {\n  identity: completeOnboardingBodySchema.pick({\n    displayName: true,\n    gender: true,\n    dateOfBirth: true,\n    headline: true,\n    about: true,\n    avatarUploadKey: true,\n    // Here because ruling D8 folded the design's orphan \"title, achievements,\n    // skills\" screen into step one. It was on no step until 0.2.0, which made\n    // it the one finish field no step owned.\n    skills: true,\n  }),\n  contact: completeOnboardingBodySchema.pick({ phone: true, links: true }),\n  location: completeOnboardingBodySchema.pick({ location: true }),\n  goals: completeOnboardingBodySchema.pick({ goals: true }),\n  interests: completeOnboardingBodySchema.pick({ interests: true }),\n  business: completeOnboardingBodySchema.pick({ venture: true, businessType: true }),\n  guidelines: completeOnboardingBodySchema.pick({ guidelinesVersion: true }),\n} as const satisfies Record<OnboardingStepKey, z.ZodObject>;\n\n/** One step's slice, parsed: `OnboardingStepBody<'contact'>` is `{ phone, links? }`. */\nexport type OnboardingStepBody<K extends OnboardingStepKey> = z.infer<\n  (typeof ONBOARDING_STEP_SCHEMAS)[K]\n>;\n\n/** A finish-body field name. */\nexport type OnboardingField = keyof CompleteOnboardingBody;\n\n/**\n * One step of the wizard, as a client renders it.\n *\n * `fields` is what gates leaving this step: a field that appears in no step is\n * unreachable twice over, because Continue will not surface its error and the\n * final submit's jump-to-the-bad-step finds no step to jump to and leaves the\n * last screen dead.\n */\nexport interface OnboardingStepConfig {\n  /** Stable identifier. Safe for analytics and for a resume cursor, unlike an index. */\n  key: OnboardingStepKey;\n  /** Translation keys. The words live in the client's message files. */\n  titleKey: `onboarding.steps.${OnboardingStepKey}.title`;\n  helpKey: `onboarding.steps.${OnboardingStepKey}.help`;\n  /** The step's slice of the finish body, in schema order. */\n  fields: readonly OnboardingField[];\n  /**\n   * False when the whole step may be passed without answering anything.\n   * DERIVED: a step is optional exactly when its slice accepts an empty\n   * object, so \"skippable\" can never disagree with what the finish accepts.\n   */\n  required: boolean;\n}\n\nexport const FOUNDER_ONBOARDING_STEPS: readonly OnboardingStepConfig[] = ONBOARDING_STEP_KEYS.map(\n  (key): OnboardingStepConfig => {\n    const slice = ONBOARDING_STEP_SCHEMAS[key];\n    return {\n      key,\n      titleKey: `onboarding.steps.${key}.title`,\n      helpKey: `onboarding.steps.${key}.help`,\n      fields: Object.keys(slice.shape) as OnboardingField[],\n      required: !slice.safeParse({}).success,\n    };\n  },\n);\n\nexport const ONBOARDING_TOTAL_STEPS = FOUNDER_ONBOARDING_STEPS.length;\n\n/** Fields gating each step, in step order. Read from the same picks. */\nexport const ONBOARDING_STEP_FIELDS: readonly (readonly OnboardingField[])[] =\n  FOUNDER_ONBOARDING_STEPS.map((s) => s.fields);\n\n/** What finishing answers: the new profile's id and the handle derived for it. */\nexport const completeOnboardingResponseSchema = z.object({\n  id: z.string(),\n  username: z.string(),\n});\nexport type CompleteOnboardingResponse = z.infer<typeof completeOnboardingResponseSchema>;\n\n// ─── The resume cursor ───────────────────────────────────────────────────────\n\n/**\n * The keys a draft may hold: exactly the in-progress form's fields.\n *\n * ⚠ The server writes each key as a dot path (`draft.<key>`). Unchecked, a key\n * holding a dot writes somewhere nested the form never asked for, and the\n * collection fills with whatever a client invents. Until 0.2.0 the backend\n * kept its own copy of this list and DROPPED unknown keys without a word; now a\n * draft carrying one is refused, with the key in the issue's path.\n */\nexport const onboardingDraftKeySchema = onboardingFormSchema.keyof();\nexport const ONBOARDING_DRAFT_KEYS = onboardingDraftKeySchema.options;\nexport type OnboardingDraftKey = z.infer<typeof onboardingDraftKeySchema>;\n\n/**\n * Where the member got to, kept in its own collection, separate from the\n * profile.\n *\n * `step` is a flat index into `FOUNDER_ONBOARDING_STEPS`, not a `(step, sub)`\n * pair: one number is what lets a member start on the web and resume elsewhere,\n * provided both ends agree on the encoding.\n *\n * The draft's KEYS come from the form; its VALUES are opaque on purpose. A\n * half-answered step must be storable even though it would fail the finish,\n * and everything in it is re-validated strictly at finalize.\n *\n * `partialRecord`, not `record`: in Zod 4 an enum-keyed `z.record` demands\n * every key, and a draft holds whichever steps the member has reached.\n */\nexport const onboardingDraftSchema = z.partialRecord(onboardingDraftKeySchema, z.unknown());\nexport type OnboardingDraft = z.infer<typeof onboardingDraftSchema>;\n\nexport const onboardingProgressSchema = z.object({\n  step: z.number().int().min(0).max(ONBOARDING_TOTAL_STEPS),\n  draft: onboardingDraftSchema.optional(),\n});\nexport type OnboardingProgress = z.infer<typeof onboardingProgressSchema>;\n\n/**\n * `PATCH` body: any subset of the cursor, merged server-side. No defaults.\n * `step` may equal `ONBOARDING_TOTAL_STEPS`: \"past the last step\", which the\n * client sends on its way to finish.\n */\nexport const onboardingProgressUpdateSchema = z.object({\n  step: z.number().int().min(0).max(ONBOARDING_TOTAL_STEPS).optional(),\n  draft: onboardingDraftSchema.optional(),\n});\nexport type OnboardingProgressUpdate = z.infer<typeof onboardingProgressUpdateSchema>;\n\n/**\n * What the client reads on return, from `GET` and from every `PATCH`.\n *\n * ⚠️ `onboarded` is the gate and it comes from the profile, not from the\n * cursor: a finished member on a new device must be recognised even when the\n * cursor row is gone, and a cursor that failed to load must never make an\n * unfinished member look finished.\n */\nexport const onboardingStatusSchema = z.object({\n  onboarded: z.boolean(),\n  step: z.number().int().min(0).max(ONBOARDING_TOTAL_STEPS),\n  draft: onboardingDraftSchema.optional(),\n});\nexport type OnboardingStatus = z.infer<typeof onboardingStatusSchema>;\n"]}

package/dist/responses/common.d.ts

@@ -8,10 +8,79 @@
  * @module founder-schema/responses/common
  */
 import { z } from 'zod';
+/**
+ * Where the per-field problems of a 400 go.
+ *
+ * `issues` is EVERY problem, each with its path, built on the server by
+ * `toValidationIssues`. Until 0.2.0 this was typed as a record of strings that
+ * nothing ever sent, while the real 400s carried only the first issue's
+ * message, so a client could not tell which field to mark.
+ */
+export declare const apiErrorDetailsSchema: z.ZodObject<{
+    issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        location: z.ZodOptional<z.ZodEnum<{
+            body: "body";
+            query: "query";
+            params: "params";
+        }>>;
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        code: z.ZodString;
+        message: z.ZodString;
+        minimum: z.ZodOptional<z.ZodNumber>;
+        maximum: z.ZodOptional<z.ZodNumber>;
+        origin: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ApiErrorDetails = z.infer<typeof apiErrorDetailsSchema>;
+/**
+ * `code` is one of `API_ERROR_CODE_VALUES`, and it is what a client acts on.
+ * `message` is English, for logs and for a client that predates the code.
+ */
 export declare const apiErrorSchema: z.ZodObject<{
-    code: z.ZodString;
+    code: z.ZodEnum<{
+        INTERNAL_ERROR: "INTERNAL_ERROR";
+        VALIDATION_ERROR: "VALIDATION_ERROR";
+        NOT_FOUND: "NOT_FOUND";
+        CONFLICT: "CONFLICT";
+        RATE_LIMITED: "RATE_LIMITED";
+        SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+        UNAUTHORIZED: "UNAUTHORIZED";
+        INVALID_TOKEN: "INVALID_TOKEN";
+        TOKEN_EXPIRED: "TOKEN_EXPIRED";
+        SESSION_INVALIDATED: "SESSION_INVALIDATED";
+        FORBIDDEN: "FORBIDDEN";
+        ONBOARDING_INCOMPLETE: "ONBOARDING_INCOMPLETE";
+        ALREADY_ONBOARDED: "ALREADY_ONBOARDED";
+        UNDER_AGE: "UNDER_AGE";
+        UPLOAD_NOT_ATTACHABLE: "UPLOAD_NOT_ATTACHABLE";
+        UPLOAD_TOO_LARGE: "UPLOAD_TOO_LARGE";
+        UPLOAD_WRONG_TYPE: "UPLOAD_WRONG_TYPE";
+        EDIT_WINDOW_CLOSED: "EDIT_WINDOW_CLOSED";
+        POLL_NOT_EDITABLE: "POLL_NOT_EDITABLE";
+        POLL_CLOSED: "POLL_CLOSED";
+        POLL_CHOICE_INVALID: "POLL_CHOICE_INVALID";
+        REPLY_TOO_DEEP: "REPLY_TOO_DEEP";
+        CANNOT_REPORT_OWN: "CANNOT_REPORT_OWN";
+        CHAT_WITH_SELF: "CHAT_WITH_SELF";
+    }>;
     message: z.ZodString;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    details: z.ZodOptional<z.ZodObject<{
+        issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            location: z.ZodOptional<z.ZodEnum<{
+                body: "body";
+                query: "query";
+                params: "params";
+            }>>;
+            path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            code: z.ZodString;
+            message: z.ZodString;
+            minimum: z.ZodOptional<z.ZodNumber>;
+            maximum: z.ZodOptional<z.ZodNumber>;
+            origin: z.ZodOptional<z.ZodString>;
+            format: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ApiError = z.infer<typeof apiErrorSchema>;
 /** Success envelope. `T` is the payload schema. */
@@ -23,9 +92,49 @@ export declare const successResponseSchema: <T extends z.ZodType>(data: T) => z.
 export declare const errorResponseSchema: z.ZodObject<{
     success: z.ZodLiteral<false>;
     error: z.ZodObject<{
-        code: z.ZodString;
+        code: z.ZodEnum<{
+            INTERNAL_ERROR: "INTERNAL_ERROR";
+            VALIDATION_ERROR: "VALIDATION_ERROR";
+            NOT_FOUND: "NOT_FOUND";
+            CONFLICT: "CONFLICT";
+            RATE_LIMITED: "RATE_LIMITED";
+            SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+            UNAUTHORIZED: "UNAUTHORIZED";
+            INVALID_TOKEN: "INVALID_TOKEN";
+            TOKEN_EXPIRED: "TOKEN_EXPIRED";
+            SESSION_INVALIDATED: "SESSION_INVALIDATED";
+            FORBIDDEN: "FORBIDDEN";
+            ONBOARDING_INCOMPLETE: "ONBOARDING_INCOMPLETE";
+            ALREADY_ONBOARDED: "ALREADY_ONBOARDED";
+            UNDER_AGE: "UNDER_AGE";
+            UPLOAD_NOT_ATTACHABLE: "UPLOAD_NOT_ATTACHABLE";
+            UPLOAD_TOO_LARGE: "UPLOAD_TOO_LARGE";
+            UPLOAD_WRONG_TYPE: "UPLOAD_WRONG_TYPE";
+            EDIT_WINDOW_CLOSED: "EDIT_WINDOW_CLOSED";
+            POLL_NOT_EDITABLE: "POLL_NOT_EDITABLE";
+            POLL_CLOSED: "POLL_CLOSED";
+            POLL_CHOICE_INVALID: "POLL_CHOICE_INVALID";
+            REPLY_TOO_DEEP: "REPLY_TOO_DEEP";
+            CANNOT_REPORT_OWN: "CANNOT_REPORT_OWN";
+            CHAT_WITH_SELF: "CHAT_WITH_SELF";
+        }>;
         message: z.ZodString;
-        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        details: z.ZodOptional<z.ZodObject<{
+            issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                location: z.ZodOptional<z.ZodEnum<{
+                    body: "body";
+                    query: "query";
+                    params: "params";
+                }>>;
+                path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                code: z.ZodString;
+                message: z.ZodString;
+                minimum: z.ZodOptional<z.ZodNumber>;
+                maximum: z.ZodOptional<z.ZodNumber>;
+                origin: z.ZodOptional<z.ZodString>;
+                format: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ErrorResponse = z.infer<typeof errorResponseSchema>;
@@ -46,4 +155,13 @@ export declare const paginatedSchema: <T extends z.ZodType>(item: T) => z.ZodObj
     items: z.ZodArray<T>;
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * What a create, an edit or a delete answers: the id of the thing it touched.
+ * A client that needs the whole item reads it, so a write never ships a second
+ * projection of it that could drift from the read path's.
+ */
+export declare const idResponseSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export type IdResponse = z.infer<typeof idResponseSchema>;
 //# sourceMappingURL=common.d.ts.map

package/dist/responses/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/responses/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;;;;iBAKzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC;;;;iBAK9D,CAAC;AAEL,eAAO,MAAM,mBAAmB;;;;;;;iBAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC;;;iBAIxD,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/responses/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;iBAEhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC;;;;iBAK9D,CAAC;AAEL,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC;;;iBAIxD,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;iBAAmC,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/responses/common.js

@@ -8,11 +8,28 @@
  * @module founder-schema/responses/common
  */
 import { z } from 'zod';
+import { objectIdSchema } from '../common.js';
+import { apiErrorCodeSchema } from '../errors.js';
+import { validationIssueSchema } from '../validation.js';
+/**
+ * Where the per-field problems of a 400 go.
+ *
+ * `issues` is EVERY problem, each with its path, built on the server by
+ * `toValidationIssues`. Until 0.2.0 this was typed as a record of strings that
+ * nothing ever sent, while the real 400s carried only the first issue's
+ * message, so a client could not tell which field to mark.
+ */
+export const apiErrorDetailsSchema = z.object({
+    issues: z.array(validationIssueSchema).optional(),
+});
+/**
+ * `code` is one of `API_ERROR_CODE_VALUES`, and it is what a client acts on.
+ * `message` is English, for logs and for a client that predates the code.
+ */
 export const apiErrorSchema = z.object({
-    code: z.string(),
+    code: apiErrorCodeSchema,
     message: z.string(),
-    /** Field-level problems, keyed by the path the client rendered. */
-    details: z.record(z.string(), z.array(z.string())).optional(),
+    details: apiErrorDetailsSchema.optional(),
 });
 /** Success envelope. `T` is the payload schema. */
 export const successResponseSchema = (data) => z.object({
@@ -41,4 +58,10 @@ export const paginatedSchema = (item) => z.object({
     items: z.array(item),
     nextCursor: z.string().nullable(),
 });
+/**
+ * What a create, an edit or a delete answers: the id of the thing it touched.
+ * A client that needs the whole item reads it, so a write never ships a second
+ * projection of it that could drift from the read path's.
+ */
+export const idResponseSchema = z.object({ id: objectIdSchema });
 //# sourceMappingURL=common.js.map

package/dist/responses/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/responses/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,mEAAmE;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC;AAGH,mDAAmD;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAsB,IAAO,EAAE,EAAE,CACpE,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxB,IAAI;IACJ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,KAAK,EAAE,cAAc;CACtB,CAAC,CAAC;AAGH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAsB,IAAO,EAAE,EAAE,CAC9D,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC","sourcesContent":["/**\n * founder-schema — API response envelope\n *\n * Every Founder Circle endpoint answers in this shape. The clients read the\n * failure reason at `error.message`, so a handler must never return a bare\n * string body.\n *\n * @module founder-schema/responses/common\n */\n\nimport { z } from 'zod';\n\nexport const apiErrorSchema = z.object({\n  code: z.string(),\n  message: z.string(),\n  /** Field-level problems, keyed by the path the client rendered. */\n  details: z.record(z.string(), z.array(z.string())).optional(),\n});\nexport type ApiError = z.infer<typeof apiErrorSchema>;\n\n/** Success envelope. `T` is the payload schema. */\nexport const successResponseSchema = <T extends z.ZodType>(data: T) =>\n  z.object({\n    success: z.literal(true),\n    data,\n    message: z.string().optional(),\n  });\n\nexport const errorResponseSchema = z.object({\n  success: z.literal(false),\n  error: apiErrorSchema,\n});\nexport type ErrorResponse = z.infer<typeof errorResponseSchema>;\n\n/**\n * Cursor-paginated list envelope.\n *\n * `nextCursor` is REQUIRED and is `null` at the end of the list. Omitting the\n * key is not the same thing and does not validate: a handler must decide\n * whether there is another page and say so, because \"the key is missing\" and\n * \"there are no more results\" are indistinguishable to a client that has to\n * choose between showing a Load more button and not showing one.\n *\n * An earlier version of this comment said absence and null were equivalent.\n * They never were; the schema has always required the key. Corrected\n * 2026-09-21, and pinned by a test.\n */\nexport const paginatedSchema = <T extends z.ZodType>(item: T) =>\n  z.object({\n    items: z.array(item),\n    nextCursor: z.string().nullable(),\n  });\n"]}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/responses/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,qBAAqB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAGH,mDAAmD;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAsB,IAAO,EAAE,EAAE,CACpE,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxB,IAAI;IACJ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,KAAK,EAAE,cAAc;CACtB,CAAC,CAAC;AAGH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAsB,IAAO,EAAE,EAAE,CAC9D,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC","sourcesContent":["/**\n * founder-schema — API response envelope\n *\n * Every Founder Circle endpoint answers in this shape. The clients read the\n * failure reason at `error.message`, so a handler must never return a bare\n * string body.\n *\n * @module founder-schema/responses/common\n */\n\nimport { z } from 'zod';\nimport { objectIdSchema } from '../common.js';\nimport { apiErrorCodeSchema } from '../errors.js';\nimport { validationIssueSchema } from '../validation.js';\n\n/**\n * Where the per-field problems of a 400 go.\n *\n * `issues` is EVERY problem, each with its path, built on the server by\n * `toValidationIssues`. Until 0.2.0 this was typed as a record of strings that\n * nothing ever sent, while the real 400s carried only the first issue's\n * message, so a client could not tell which field to mark.\n */\nexport const apiErrorDetailsSchema = z.object({\n  issues: z.array(validationIssueSchema).optional(),\n});\nexport type ApiErrorDetails = z.infer<typeof apiErrorDetailsSchema>;\n\n/**\n * `code` is one of `API_ERROR_CODE_VALUES`, and it is what a client acts on.\n * `message` is English, for logs and for a client that predates the code.\n */\nexport const apiErrorSchema = z.object({\n  code: apiErrorCodeSchema,\n  message: z.string(),\n  details: apiErrorDetailsSchema.optional(),\n});\nexport type ApiError = z.infer<typeof apiErrorSchema>;\n\n/** Success envelope. `T` is the payload schema. */\nexport const successResponseSchema = <T extends z.ZodType>(data: T) =>\n  z.object({\n    success: z.literal(true),\n    data,\n    message: z.string().optional(),\n  });\n\nexport const errorResponseSchema = z.object({\n  success: z.literal(false),\n  error: apiErrorSchema,\n});\nexport type ErrorResponse = z.infer<typeof errorResponseSchema>;\n\n/**\n * Cursor-paginated list envelope.\n *\n * `nextCursor` is REQUIRED and is `null` at the end of the list. Omitting the\n * key is not the same thing and does not validate: a handler must decide\n * whether there is another page and say so, because \"the key is missing\" and\n * \"there are no more results\" are indistinguishable to a client that has to\n * choose between showing a Load more button and not showing one.\n *\n * An earlier version of this comment said absence and null were equivalent.\n * They never were; the schema has always required the key. Corrected\n * 2026-09-21, and pinned by a test.\n */\nexport const paginatedSchema = <T extends z.ZodType>(item: T) =>\n  z.object({\n    items: z.array(item),\n    nextCursor: z.string().nullable(),\n  });\n\n/**\n * What a create, an edit or a delete answers: the id of the thing it touched.\n * A client that needs the whole item reads it, so a write never ships a second\n * projection of it that could drift from the read path's.\n */\nexport const idResponseSchema = z.object({ id: objectIdSchema });\nexport type IdResponse = z.infer<typeof idResponseSchema>;\n"]}

package/dist/responses/index.d.ts

@@ -3,5 +3,5 @@
  *
  * @module founder-schema/responses
  */
-export { type ApiError, apiErrorSchema, type ErrorResponse, errorResponseSchema, paginatedSchema, successResponseSchema, } from './common.js';
+export { type ApiError, type ApiErrorDetails, apiErrorDetailsSchema, apiErrorSchema, type ErrorResponse, errorResponseSchema, type IdResponse, idResponseSchema, paginatedSchema, successResponseSchema, } from './common.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/responses/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/responses/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,aAAa,EAClB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/responses/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,qBAAqB,EACrB,cAAc,EACd,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,UAAU,EACf,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/responses/index.js

@@ -3,5 +3,5 @@
  *
  * @module founder-schema/responses
  */
-export { apiErrorSchema, errorResponseSchema, paginatedSchema, successResponseSchema, } from './common.js';
+export { apiErrorDetailsSchema, apiErrorSchema, errorResponseSchema, idResponseSchema, paginatedSchema, successResponseSchema, } from './common.js';
 //# sourceMappingURL=index.js.map

package/dist/responses/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/responses/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,cAAc,EAEd,mBAAmB,EACnB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC","sourcesContent":["/**\n * founder-schema — response barrel\n *\n * @module founder-schema/responses\n */\n\nexport {\n  type ApiError,\n  apiErrorSchema,\n  type ErrorResponse,\n  errorResponseSchema,\n  paginatedSchema,\n  successResponseSchema,\n} from './common.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/responses/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,qBAAqB,EACrB,cAAc,EAEd,mBAAmB,EAEnB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC","sourcesContent":["/**\n * founder-schema — response barrel\n *\n * @module founder-schema/responses\n */\n\nexport {\n  type ApiError,\n  type ApiErrorDetails,\n  apiErrorDetailsSchema,\n  apiErrorSchema,\n  type ErrorResponse,\n  errorResponseSchema,\n  type IdResponse,\n  idResponseSchema,\n  paginatedSchema,\n  successResponseSchema,\n} from './common.js';\n"]}

package/dist/uploads.d.ts

@@ -0,0 +1,113 @@
+/**
+ * founder-schema — Uploads: the key a client carries, and asking for a slot
+ *
+ * Its own module so that both `feed` (a post's media) and `onboarding` (the
+ * avatar) can use the one key rule. It lived in `feed` until 0.2.0, and
+ * `onboarding` could not import it from there without a cycle (`feed` imports
+ * `onboarding` for the topic list), so the avatar key was a bare string and
+ * `'../../etc/passwd'` passed.
+ *
+ * Imports only the limits and the message keys.
+ *
+ * @module founder-schema/uploads
+ */
+import { z } from 'zod';
+/**
+ * ⚠ IMAGES ONLY, and that is a product decision rather than an oversight.
+ *
+ * The asymmetry was real and was raised: `feedVideoSchema` is in the read union
+ * and a card can render a video, while nothing could ever upload one. The user
+ * settled it on 2026-09-21: members upload images, and share video by putting a
+ * link in the post text, which the client renders inline. So the minter stays
+ * images-only by intent.
+ *
+ * `feedVideoSchema` is deliberately KEPT. Widening the write path later is
+ * additive; removing video from the read union once a client handles it is not.
+ * A test named for refusing a video key holds this visible, so whoever adds
+ * video uploads has to delete a test that says out loud why it exists.
+ */
+export declare const UPLOAD_KEY_EXTENSIONS: readonly ["jpg", "jpeg", "png", "webp", "gif"];
+export declare const uploadKeyExtensionSchema: z.ZodEnum<{
+    jpg: "jpg";
+    jpeg: "jpeg";
+    png: "png";
+    webp: "webp";
+    gif: "gif";
+}>;
+export type UploadKeyExtension = z.infer<typeof uploadKeyExtensionSchema>;
+/**
+ * The content type each extension is signed for, and the only types an
+ * attached object may turn out to have. The server signs the PUT with this
+ * type and refuses to attach an object whose stored type is anything else.
+ */
+export declare const UPLOAD_CONTENT_TYPES: {
+    readonly jpg: "image/jpeg";
+    readonly jpeg: "image/jpeg";
+    readonly png: "image/png";
+    readonly webp: "image/webp";
+    readonly gif: "image/gif";
+};
+export declare const UPLOAD_KEY_MAX_CHARS = 300;
+/**
+ * An attachment on the way IN is a KEY, never a URL. FORMAT, minted
+ * server-side and never by a client:
+ *
+ *     media/<userId>/<uuid>.<ext>
+ *
+ * Built from `UPLOAD_KEY_EXTENSIONS`, so the extension list exists once. The
+ * backend reads the owner segment with this same pattern.
+ *
+ * ⚠ THIS IS THE FIRST OF THREE CHECKS AND THE WEAKEST. It proves the key is
+ * well FORMED. It cannot prove the two things that actually matter:
+ *
+ *   1. OWNERSHIP. The `userId` segment is what makes "is this your object"
+ *      checkable, and the backend compares it against the authenticated caller.
+ *      A pattern happily accepts a well-formed key belonging to somebody else.
+ *   2. EXISTENCE. The backend reads the object before attaching it, so a key
+ *      for an object nobody uploaded cannot be committed.
+ */
+export declare const UPLOAD_KEY_PATTERN: RegExp;
+/**
+ * The length ceiling and the traversal refusal are redundant against the
+ * pattern, which is anchored and admits no dots outside the extension. They are
+ * kept on purpose: they are what still holds if the pattern is ever loosened.
+ */
+export declare const uploadKeySchema: z.ZodString;
+export type UploadKey = z.infer<typeof uploadKeySchema>;
+/**
+ * Asking for an upload slot: `POST /api/v1/uploads/presign`.
+ *
+ * The server chooses the key (so it carries the caller's id), the content type
+ * and the expiry; a client that could name its own key could aim it at
+ * someone else's folder.
+ *
+ * `contentLength` is the file's exact size in bytes, and it is SIGNED INTO the
+ * URL: storage refuses a PUT whose body is any other size. Until 0.2.0 nothing
+ * capped the size at upload, so a member could put 40 MB into the bucket and
+ * only learn at attach time that it was refused.
+ */
+export declare const uploadPresignBodySchema: z.ZodObject<{
+    extension: z.ZodEnum<{
+        jpg: "jpg";
+        jpeg: "jpeg";
+        png: "png";
+        webp: "webp";
+        gif: "gif";
+    }>;
+    contentLength: z.ZodNumber;
+}, z.core.$strip>;
+export type UploadPresignBody = z.infer<typeof uploadPresignBodySchema>;
+/**
+ * The upload slot. `headers` are part of the signature, not advice: send every
+ * one of them verbatim on the PUT, with a body of exactly `contentLength`
+ * bytes, or storage answers with a signature mismatch. `key` is what a create
+ * body then carries, exactly as given.
+ */
+export declare const uploadPresignResponseSchema: z.ZodObject<{
+    key: z.ZodString;
+    url: z.ZodURL;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    expiresIn: z.ZodNumber;
+}, z.core.$strip>;
+export type UploadPresignResponse = z.infer<typeof uploadPresignResponseSchema>;
+//# sourceMappingURL=uploads.d.ts.map

package/dist/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,gDAAiD,CAAC;AACpF,eAAO,MAAM,wBAAwB;;;;;;EAAgC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;CAMiC,CAAC;AAEnE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,QAE9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,aAMuD,CAAC;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;iBAGlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;iBAMtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}