founder-schema 0.3.0 → 0.4.0

package/dist/domains/discover/discover.d.ts

@@ -0,0 +1,245 @@
+/**
+ * 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/domains/discover
+ */
+import { z } from 'zod';
+/**
+ * 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 declare const discoverQuerySchema: z.ZodObject<{
+    limit: z.ZodPreprocess<z.ZodDefault<z.ZodCoercedNumber<unknown>>, unknown>;
+    cursor: z.ZodOptional<z.ZodString>;
+    q: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    industry: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        agritech: "agritech";
+        ai_ml: "ai_ml";
+        b2b_saas: "b2b_saas";
+        consumer: "consumer";
+        climate: "climate";
+        d2c: "d2c";
+        deeptech: "deeptech";
+        edtech: "edtech";
+        fintech: "fintech";
+        gaming: "gaming";
+        healthtech: "healthtech";
+        logistics: "logistics";
+        manufacturing: "manufacturing";
+        marketplace: "marketplace";
+        media: "media";
+        mobility: "mobility";
+        proptech: "proptech";
+        robotics: "robotics";
+        services: "services";
+        space: "space";
+        other: "other";
+    }>>>, unknown>;
+    skill: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        engineering: "engineering";
+        product: "product";
+        design: "design";
+        data: "data";
+        growth: "growth";
+        sales: "sales";
+        marketing: "marketing";
+        operations: "operations";
+        finance: "finance";
+        legal: "legal";
+        hr_people: "hr_people";
+        supply_chain: "supply_chain";
+        research: "research";
+        fundraising: "fundraising";
+        community: "community";
+    }>>>, unknown>;
+    stage: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        idea: "idea";
+        validation: "validation";
+        mvp: "mvp";
+        pre_seed: "pre_seed";
+        seed: "seed";
+        series_a_plus: "series_a_plus";
+        profitable: "profitable";
+        exited: "exited";
+    }>>>, unknown>;
+    city: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+    country: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+}, z.core.$strip>;
+export type DiscoverQuery = z.infer<typeof discoverQuerySchema>;
+export type DiscoverQueryInput = z.input<typeof discoverQuerySchema>;
+/** A page of founder cards, most recently updated first. */
+export declare const discoverPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        location: z.ZodOptional<z.ZodObject<{
+            city: z.ZodString;
+            state: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+            country: z.ZodString;
+        }, z.core.$strip>>;
+        displayName: z.ZodString;
+        username: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+        venture: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            tagline: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+            website: z.ZodOptional<z.ZodURL>;
+            industry: z.ZodEnum<{
+                agritech: "agritech";
+                ai_ml: "ai_ml";
+                b2b_saas: "b2b_saas";
+                consumer: "consumer";
+                climate: "climate";
+                d2c: "d2c";
+                deeptech: "deeptech";
+                edtech: "edtech";
+                fintech: "fintech";
+                gaming: "gaming";
+                healthtech: "healthtech";
+                logistics: "logistics";
+                manufacturing: "manufacturing";
+                marketplace: "marketplace";
+                media: "media";
+                mobility: "mobility";
+                proptech: "proptech";
+                robotics: "robotics";
+                services: "services";
+                space: "space";
+                other: "other";
+            }>;
+            stage: z.ZodEnum<{
+                idea: "idea";
+                validation: "validation";
+                mvp: "mvp";
+                pre_seed: "pre_seed";
+                seed: "seed";
+                series_a_plus: "series_a_plus";
+                profitable: "profitable";
+                exited: "exited";
+            }>;
+            teamSize: z.ZodOptional<z.ZodNumber>;
+            foundedYear: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        skills: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            engineering: "engineering";
+            product: "product";
+            design: "design";
+            data: "data";
+            growth: "growth";
+            sales: "sales";
+            marketing: "marketing";
+            operations: "operations";
+            finance: "finance";
+            legal: "legal";
+            hr_people: "hr_people";
+            supply_chain: "supply_chain";
+            research: "research";
+            fundraising: "fundraising";
+            community: "community";
+        }>>>;
+        goals: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            find_cofounder: "find_cofounder";
+            find_investors: "find_investors";
+            find_customers: "find_customers";
+            hiring: "hiring";
+            partnerships: "partnerships";
+            mentorship: "mentorship";
+            grow_network: "grow_network";
+            business_ideas: "business_ideas";
+            market_insights: "market_insights";
+            learn_startup: "learn_startup";
+            start_company: "start_company";
+        }>>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type DiscoverPage = z.infer<typeof discoverPageSchema>;
+/**
+ * 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 declare const discoverFacetsSchema: z.ZodObject<{
+    industries: z.ZodArray<z.ZodObject<{
+        value: z.ZodEnum<{
+            agritech: "agritech";
+            ai_ml: "ai_ml";
+            b2b_saas: "b2b_saas";
+            consumer: "consumer";
+            climate: "climate";
+            d2c: "d2c";
+            deeptech: "deeptech";
+            edtech: "edtech";
+            fintech: "fintech";
+            gaming: "gaming";
+            healthtech: "healthtech";
+            logistics: "logistics";
+            manufacturing: "manufacturing";
+            marketplace: "marketplace";
+            media: "media";
+            mobility: "mobility";
+            proptech: "proptech";
+            robotics: "robotics";
+            services: "services";
+            space: "space";
+            other: "other";
+        }>;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    skills: z.ZodArray<z.ZodObject<{
+        value: z.ZodEnum<{
+            engineering: "engineering";
+            product: "product";
+            design: "design";
+            data: "data";
+            growth: "growth";
+            sales: "sales";
+            marketing: "marketing";
+            operations: "operations";
+            finance: "finance";
+            legal: "legal";
+            hr_people: "hr_people";
+            supply_chain: "supply_chain";
+            research: "research";
+            fundraising: "fundraising";
+            community: "community";
+        }>;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    stages: z.ZodArray<z.ZodObject<{
+        value: z.ZodEnum<{
+            idea: "idea";
+            validation: "validation";
+            mvp: "mvp";
+            pre_seed: "pre_seed";
+            seed: "seed";
+            series_a_plus: "series_a_plus";
+            profitable: "profitable";
+            exited: "exited";
+        }>;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    cities: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DiscoverFacets = z.infer<typeof discoverFacetsSchema>;
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/domains/discover/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAqC,CAAC;AACrE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/domains/discover/discover.js

@@ -0,0 +1,68 @@
+/**
+ * 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/domains/discover
+ */
+import { z } from 'zod';
+import { industrySchema, optionalTrimmedString, paginationQuerySchema, skillSchema, startupStageSchema, } from '../../core/common.js';
+import { DISCOVER_FILTER_VALUES_MAX, DISCOVER_TEXT_MAX } from '../../core/limits.js';
+import { paginatedSchema } from '../../core/responses.js';
+import { founderCardSchema } from '../profile/founder-profile.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/domains/discover/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../src/domains/discover/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,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;;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/domains/discover\n */\n\nimport { z } from 'zod';\nimport {\n  industrySchema,\n  optionalTrimmedString,\n  paginationQuerySchema,\n  skillSchema,\n  startupStageSchema,\n} from '../../core/common.js';\nimport { DISCOVER_FILTER_VALUES_MAX, DISCOVER_TEXT_MAX } from '../../core/limits.js';\nimport { paginatedSchema } from '../../core/responses.js';\nimport { founderCardSchema } from '../profile/founder-profile.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"]}