founder-schema 0.19.0 → 0.21.0

package/dist/discover.js

@@ -1,68 +0,0 @@
-/**
- * founder-schema — Discover search and filters
- *
- * Search is by name; the filters are industry, skill, startup stage and
- * location. The community surface the Discover tab will grow later is not
- * modelled yet.
- *
- * @module founder-schema/discover
- */
-import { z } from 'zod';
-import { industrySchema, optionalTrimmedString, paginationQuerySchema, skillSchema, startupStageSchema, } from './common.js';
-import { founderCardSchema } from './founder-profile.js';
-import { DISCOVER_FILTER_VALUES_MAX, DISCOVER_TEXT_MAX } from './limits.js';
-import { paginatedSchema } from './responses/common.js';
-/**
- * Accepts a repeated query param (`?skill=growth&skill=sales`) or a single
- * value, and always produces an array.
- *
- * Express gives `string` for one occurrence and `string[]` for several, so
- * without this the same URL shape parses two different ways.
- */
-const multiValue = (inner) => z.preprocess((value) => {
-    if (value === undefined || value === null)
-        return undefined;
-    return Array.isArray(value) ? value : [value];
-}, z.array(inner).max(DISCOVER_FILTER_VALUES_MAX).optional());
-/**
- * Every free-text filter here is `optionalTrimmedString`, so an EMPTY one is
- * treated as "not provided" rather than as a validation failure.
- *
- * A search box the member has just cleared sends `?q=`, and a select they reset
- * sends `?city=`. Refusing those turns an ordinary interaction into a 400 with
- * nothing useful to show for it: the member asked for fewer filters, not for an
- * error. This is the one place the create-body rule and the patch-body rule
- * agree, because a query has nothing to erase.
- */
-export const discoverQuerySchema = paginationQuerySchema.extend({
-    /** Free-text name search. Matched against display name and username. */
-    q: optionalTrimmedString(DISCOVER_TEXT_MAX),
-    industry: multiValue(industrySchema),
-    skill: multiValue(skillSchema),
-    stage: multiValue(startupStageSchema),
-    city: optionalTrimmedString(DISCOVER_TEXT_MAX),
-    country: optionalTrimmedString(DISCOVER_TEXT_MAX),
-});
-/** A page of founder cards, most recently updated first. */
-export const discoverPageSchema = paginatedSchema(founderCardSchema);
-/** One filter option and how many listed founders match it. */
-const facetOption = (value) => z.object({ value, count: z.number().int().nonnegative() });
-/**
- * The filter options the Discover drawer offers, with counts. The VALUES come
- * from the enums here, so the options cannot disagree with what the query
- * accepts.
- *
- * ⚠ NO LABELS. The value IS the translation key (`industries.<value>`,
- * `stages.<value>`, `skills.<value>`), and a client words it in the member's
- * language. Until 0.2.0 the server also sent an English `label` per option,
- * built by capitalising the value ("Ai ml"), which no client read and which
- * would have been wrong in Hindi if one had. Cities are member-typed place
- * names, so their value is shown as it is.
- */
-export const discoverFacetsSchema = z.object({
-    industries: z.array(facetOption(industrySchema)),
-    skills: z.array(facetOption(skillSchema)),
-    stages: z.array(facetOption(startupStageSchema)),
-    cities: z.array(facetOption(z.string())),
-});
-//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAsB,KAAQ,EAAE,EAAE,CACnD,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAC9D,wEAAwE;IACxE,CAAC,EAAE,qBAAqB,CAAC,iBAAiB,CAAC;IAC3C,QAAQ,EAAE,UAAU,CAAC,cAAc,CAAC;IACpC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC;IAC9B,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC;IACrC,IAAI,EAAE,qBAAqB,CAAC,iBAAiB,CAAC;IAC9C,OAAO,EAAE,qBAAqB,CAAC,iBAAiB,CAAC;CAClD,CAAC,CAAC;AAIH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAC;AAGrE,+DAA+D;AAC/D,MAAM,WAAW,GAAG,CAAsB,KAAQ,EAAE,EAAE,CACpD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC,CAAC,CAAC","sourcesContent":["/**\n * founder-schema — Discover search and filters\n *\n * Search is by name; the filters are industry, skill, startup stage and\n * location. The community surface the Discover tab will grow later is not\n * modelled yet.\n *\n * @module founder-schema/discover\n */\n\nimport { z } from 'zod';\nimport {\n  industrySchema,\n  optionalTrimmedString,\n  paginationQuerySchema,\n  skillSchema,\n  startupStageSchema,\n} from './common.js';\nimport { founderCardSchema } from './founder-profile.js';\nimport { DISCOVER_FILTER_VALUES_MAX, DISCOVER_TEXT_MAX } from './limits.js';\nimport { paginatedSchema } from './responses/common.js';\n\n/**\n * Accepts a repeated query param (`?skill=growth&skill=sales`) or a single\n * value, and always produces an array.\n *\n * Express gives `string` for one occurrence and `string[]` for several, so\n * without this the same URL shape parses two different ways.\n */\nconst multiValue = <T extends z.ZodType>(inner: T) =>\n  z.preprocess((value) => {\n    if (value === undefined || value === null) return undefined;\n    return Array.isArray(value) ? value : [value];\n  }, z.array(inner).max(DISCOVER_FILTER_VALUES_MAX).optional());\n\n/**\n * Every free-text filter here is `optionalTrimmedString`, so an EMPTY one is\n * treated as \"not provided\" rather than as a validation failure.\n *\n * A search box the member has just cleared sends `?q=`, and a select they reset\n * sends `?city=`. Refusing those turns an ordinary interaction into a 400 with\n * nothing useful to show for it: the member asked for fewer filters, not for an\n * error. This is the one place the create-body rule and the patch-body rule\n * agree, because a query has nothing to erase.\n */\nexport const discoverQuerySchema = paginationQuerySchema.extend({\n  /** Free-text name search. Matched against display name and username. */\n  q: optionalTrimmedString(DISCOVER_TEXT_MAX),\n  industry: multiValue(industrySchema),\n  skill: multiValue(skillSchema),\n  stage: multiValue(startupStageSchema),\n  city: optionalTrimmedString(DISCOVER_TEXT_MAX),\n  country: optionalTrimmedString(DISCOVER_TEXT_MAX),\n});\nexport type DiscoverQuery = z.infer<typeof discoverQuerySchema>;\nexport type DiscoverQueryInput = z.input<typeof discoverQuerySchema>;\n\n/** A page of founder cards, most recently updated first. */\nexport const discoverPageSchema = paginatedSchema(founderCardSchema);\nexport type DiscoverPage = z.infer<typeof discoverPageSchema>;\n\n/** One filter option and how many listed founders match it. */\nconst facetOption = <T extends z.ZodType>(value: T) =>\n  z.object({ value, count: z.number().int().nonnegative() });\n\n/**\n * The filter options the Discover drawer offers, with counts. The VALUES come\n * from the enums here, so the options cannot disagree with what the query\n * accepts.\n *\n * ⚠ NO LABELS. The value IS the translation key (`industries.<value>`,\n * `stages.<value>`, `skills.<value>`), and a client words it in the member's\n * language. Until 0.2.0 the server also sent an English `label` per option,\n * built by capitalising the value (\"Ai ml\"), which no client read and which\n * would have been wrong in Hindi if one had. Cities are member-typed place\n * names, so their value is shown as it is.\n */\nexport const discoverFacetsSchema = z.object({\n  industries: z.array(facetOption(industrySchema)),\n  skills: z.array(facetOption(skillSchema)),\n  stages: z.array(facetOption(startupStageSchema)),\n  cities: z.array(facetOption(z.string())),\n});\nexport type DiscoverFacets = z.infer<typeof discoverFacetsSchema>;\n"]}

package/dist/errors.d.ts

@@ -1,85 +0,0 @@
-/**
- * founder-schema — Every error code the API answers with
- *
- * THE CODE IS WHAT A CLIENT ACTS ON; the `message` beside it is English for
- * logs and for a client too old to know the code. A client words each code in
- * the member's language, and a test on the web side asserts every value here
- * has a message in every locale it ships.
- *
- * Before 0.2.0 the backend kept this list to itself, and every domain refusal
- * (a closed poll, a reply to a reply, the edit window) went out as
- * `VALIDATION_ERROR` with an English sentence, so the only way for a client to
- * tell them apart was to match on the wording.
- *
- * WHEN TO USE WHICH:
- *   - A request that does not match its schema: `VALIDATION_ERROR`, with every
- *     problem in `error.details.issues`.
- *   - A well-formed request the current STATE of things refuses: its own code
- *     below. These carry no issues; the code says it all.
- *
- * ⚠ Append freely; remove deliberately. A code removed here that an older
- * server still sends fails the client's parse of the error envelope.
- *
- * @module founder-schema/errors
- */
-import { z } from 'zod';
-/**
- * As a tuple, the way `GENDER_VALUES` is, so a consumer can iterate it (a
- * translation-coverage test does exactly that) and TypeScript keeps the union.
- */
-export declare const API_ERROR_CODE_VALUES: readonly ["INTERNAL_ERROR", "VALIDATION_ERROR", "NOT_FOUND", "CONFLICT", "RATE_LIMITED", "SERVICE_UNAVAILABLE", "UNAUTHORIZED", "INVALID_TOKEN", "TOKEN_EXPIRED", "SESSION_INVALIDATED", "FORBIDDEN", "ONBOARDING_INCOMPLETE", "ALREADY_ONBOARDED", "UNDER_AGE", "UPLOAD_NOT_ATTACHABLE", "UPLOAD_TOO_LARGE", "UPLOAD_WRONG_TYPE", "EDIT_WINDOW_CLOSED", "POLL_NOT_EDITABLE", "POLL_CLOSED", "POLL_CHOICE_INVALID", "REPLY_TOO_DEEP", "CANNOT_REPORT_OWN", "CHAT_WITH_SELF"];
-export declare const apiErrorCodeSchema: 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";
-}>;
-export type ApiErrorCode = z.infer<typeof apiErrorCodeSchema>;
-/** The same codes by name: `API_ERROR_CODE.POLL_CLOSED`. */
-export declare const API_ERROR_CODE: {
-    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";
-};
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,8cA4DxB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;EAAgC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,4DAA4D;AAC5D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAA0B,CAAC"}

package/dist/errors.js

@@ -1,89 +0,0 @@
-/**
- * founder-schema — Every error code the API answers with
- *
- * THE CODE IS WHAT A CLIENT ACTS ON; the `message` beside it is English for
- * logs and for a client too old to know the code. A client words each code in
- * the member's language, and a test on the web side asserts every value here
- * has a message in every locale it ships.
- *
- * Before 0.2.0 the backend kept this list to itself, and every domain refusal
- * (a closed poll, a reply to a reply, the edit window) went out as
- * `VALIDATION_ERROR` with an English sentence, so the only way for a client to
- * tell them apart was to match on the wording.
- *
- * WHEN TO USE WHICH:
- *   - A request that does not match its schema: `VALIDATION_ERROR`, with every
- *     problem in `error.details.issues`.
- *   - A well-formed request the current STATE of things refuses: its own code
- *     below. These carry no issues; the code says it all.
- *
- * ⚠ Append freely; remove deliberately. A code removed here that an older
- * server still sends fails the client's parse of the error envelope.
- *
- * @module founder-schema/errors
- */
-import { z } from 'zod';
-/**
- * As a tuple, the way `GENDER_VALUES` is, so a consumer can iterate it (a
- * translation-coverage test does exactly that) and TypeScript keeps the union.
- */
-export const API_ERROR_CODE_VALUES = [
-    // ── Anything ──
-    /** A bug or an outage on our side. The message says nothing more on purpose. */
-    'INTERNAL_ERROR',
-    /** The request did not match its schema. `details.issues` says where. */
-    'VALIDATION_ERROR',
-    /** No such thing, or not one you may see. Deliberately the same answer. */
-    'NOT_FOUND',
-    /** Two writes raced for something unique; retrying usually succeeds. */
-    'CONFLICT',
-    /** Too many requests from this member or address. Wait, then retry. */
-    'RATE_LIMITED',
-    /** Something we depend on (the chat server) is down or not switched on. */
-    'SERVICE_UNAVAILABLE',
-    // ── Who you are ──
-    /** No credential at all. */
-    'UNAUTHORIZED',
-    /** A credential that is not ours, or not readable. */
-    'INVALID_TOKEN',
-    /** A credential that was ours and has expired. Refresh and retry. */
-    'TOKEN_EXPIRED',
-    /** Signed out everywhere, or the account changed. Sign in again. */
-    'SESSION_INVALIDATED',
-    /** Signed in, and not allowed to do this. */
-    'FORBIDDEN',
-    // ── Onboarding ──
-    /** Finish onboarding first. The client routes here instead of showing an error. */
-    'ONBOARDING_INCOMPLETE',
-    /** Onboarding is already finished; there is nothing to save or finish again. */
-    'ALREADY_ONBOARDED',
-    /** Under `MIN_AGE_YEARS`. Refused at the draft and again at finish. */
-    'UNDER_AGE',
-    // ── Uploads, at the moment one is attached ──
-    /** Not an upload of yours, or nothing was ever uploaded under that key. */
-    'UPLOAD_NOT_ATTACHABLE',
-    /** Larger than `UPLOAD_MAX_BYTES`. */
-    'UPLOAD_TOO_LARGE',
-    /** Not one of the image types this product accepts, or not an image at all. */
-    'UPLOAD_WRONG_TYPE',
-    // ── The feed ──
-    /** The post is older than `EDIT_WINDOW_MS`. */
-    'EDIT_WINDOW_CLOSED',
-    /** A poll is never editable: people have already voted on it. */
-    'POLL_NOT_EDITABLE',
-    /** The poll has closed, by the server's clock. */
-    'POLL_CLOSED',
-    /** No option, several on a single-choice poll, or an option that does not exist. */
-    'POLL_CHOICE_INVALID',
-    /** A reply to a reply. One level of nesting only. */
-    'REPLY_TOO_DEEP',
-    /** Reporting your own post, poll or comment. */
-    'CANNOT_REPORT_OWN',
-    // ── Chat ──
-    /** Opening a conversation with yourself. */
-    'CHAT_WITH_SELF',
-];
-export const apiErrorCodeSchema = z.enum(API_ERROR_CODE_VALUES);
-/** The same codes by name: `API_ERROR_CODE.POLL_CLOSED`. */
-export const API_ERROR_CODE = apiErrorCodeSchema.enum;
-//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB;IACjB,gFAAgF;IAChF,gBAAgB;IAChB,yEAAyE;IACzE,kBAAkB;IAClB,2EAA2E;IAC3E,WAAW;IACX,wEAAwE;IACxE,UAAU;IACV,uEAAuE;IACvE,cAAc;IACd,2EAA2E;IAC3E,qBAAqB;IAErB,oBAAoB;IACpB,4BAA4B;IAC5B,cAAc;IACd,sDAAsD;IACtD,eAAe;IACf,qEAAqE;IACrE,eAAe;IACf,oEAAoE;IACpE,qBAAqB;IACrB,6CAA6C;IAC7C,WAAW;IAEX,mBAAmB;IACnB,mFAAmF;IACnF,uBAAuB;IACvB,gFAAgF;IAChF,mBAAmB;IACnB,uEAAuE;IACvE,WAAW;IAEX,+CAA+C;IAC/C,2EAA2E;IAC3E,uBAAuB;IACvB,sCAAsC;IACtC,kBAAkB;IAClB,+EAA+E;IAC/E,mBAAmB;IAEnB,iBAAiB;IACjB,+CAA+C;IAC/C,oBAAoB;IACpB,iEAAiE;IACjE,mBAAmB;IACnB,kDAAkD;IAClD,aAAa;IACb,oFAAoF;IACpF,qBAAqB;IACrB,qDAAqD;IACrD,gBAAgB;IAChB,gDAAgD;IAChD,mBAAmB;IAEnB,aAAa;IACb,4CAA4C;IAC5C,gBAAgB;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAGhE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC","sourcesContent":["/**\n * founder-schema — Every error code the API answers with\n *\n * THE CODE IS WHAT A CLIENT ACTS ON; the `message` beside it is English for\n * logs and for a client too old to know the code. A client words each code in\n * the member's language, and a test on the web side asserts every value here\n * has a message in every locale it ships.\n *\n * Before 0.2.0 the backend kept this list to itself, and every domain refusal\n * (a closed poll, a reply to a reply, the edit window) went out as\n * `VALIDATION_ERROR` with an English sentence, so the only way for a client to\n * tell them apart was to match on the wording.\n *\n * WHEN TO USE WHICH:\n *   - A request that does not match its schema: `VALIDATION_ERROR`, with every\n *     problem in `error.details.issues`.\n *   - A well-formed request the current STATE of things refuses: its own code\n *     below. These carry no issues; the code says it all.\n *\n * ⚠ Append freely; remove deliberately. A code removed here that an older\n * server still sends fails the client's parse of the error envelope.\n *\n * @module founder-schema/errors\n */\n\nimport { z } from 'zod';\n\n/**\n * As a tuple, the way `GENDER_VALUES` is, so a consumer can iterate it (a\n * translation-coverage test does exactly that) and TypeScript keeps the union.\n */\nexport const API_ERROR_CODE_VALUES = [\n  // ── Anything ──\n  /** A bug or an outage on our side. The message says nothing more on purpose. */\n  'INTERNAL_ERROR',\n  /** The request did not match its schema. `details.issues` says where. */\n  'VALIDATION_ERROR',\n  /** No such thing, or not one you may see. Deliberately the same answer. */\n  'NOT_FOUND',\n  /** Two writes raced for something unique; retrying usually succeeds. */\n  'CONFLICT',\n  /** Too many requests from this member or address. Wait, then retry. */\n  'RATE_LIMITED',\n  /** Something we depend on (the chat server) is down or not switched on. */\n  'SERVICE_UNAVAILABLE',\n\n  // ── Who you are ──\n  /** No credential at all. */\n  'UNAUTHORIZED',\n  /** A credential that is not ours, or not readable. */\n  'INVALID_TOKEN',\n  /** A credential that was ours and has expired. Refresh and retry. */\n  'TOKEN_EXPIRED',\n  /** Signed out everywhere, or the account changed. Sign in again. */\n  'SESSION_INVALIDATED',\n  /** Signed in, and not allowed to do this. */\n  'FORBIDDEN',\n\n  // ── Onboarding ──\n  /** Finish onboarding first. The client routes here instead of showing an error. */\n  'ONBOARDING_INCOMPLETE',\n  /** Onboarding is already finished; there is nothing to save or finish again. */\n  'ALREADY_ONBOARDED',\n  /** Under `MIN_AGE_YEARS`. Refused at the draft and again at finish. */\n  'UNDER_AGE',\n\n  // ── Uploads, at the moment one is attached ──\n  /** Not an upload of yours, or nothing was ever uploaded under that key. */\n  'UPLOAD_NOT_ATTACHABLE',\n  /** Larger than `UPLOAD_MAX_BYTES`. */\n  'UPLOAD_TOO_LARGE',\n  /** Not one of the image types this product accepts, or not an image at all. */\n  'UPLOAD_WRONG_TYPE',\n\n  // ── The feed ──\n  /** The post is older than `EDIT_WINDOW_MS`. */\n  'EDIT_WINDOW_CLOSED',\n  /** A poll is never editable: people have already voted on it. */\n  'POLL_NOT_EDITABLE',\n  /** The poll has closed, by the server's clock. */\n  'POLL_CLOSED',\n  /** No option, several on a single-choice poll, or an option that does not exist. */\n  'POLL_CHOICE_INVALID',\n  /** A reply to a reply. One level of nesting only. */\n  'REPLY_TOO_DEEP',\n  /** Reporting your own post, poll or comment. */\n  'CANNOT_REPORT_OWN',\n\n  // ── Chat ──\n  /** Opening a conversation with yourself. */\n  'CHAT_WITH_SELF',\n] as const;\n\nexport const apiErrorCodeSchema = z.enum(API_ERROR_CODE_VALUES);\nexport type ApiErrorCode = z.infer<typeof apiErrorCodeSchema>;\n\n/** The same codes by name: `API_ERROR_CODE.POLL_CLOSED`. */\nexport const API_ERROR_CODE = apiErrorCodeSchema.enum;\n"]}