founder-schema 0.5.0 → 0.7.0

package/dist/domains/contributions/contributions.d.ts

@@ -0,0 +1,165 @@
+/**
+ * founder-schema — Contribution: the help a member gives, recognised
+ *
+ * The score counts HELP GIVEN, and only what OTHER members recognise:
+ *
+ *   feedback_helpful  a product's team marks your comment "this helped"     +10
+ *   tester_confirmed  a product's team confirms you tested their product    +15
+ *   review_helpful    another member finds your review helpful               +2
+ *                     (at most `REVIEW_HELPFUL_POINTS_MAX` per review)
+ *
+ * `review_written` is still listed so older rows and clients parse, but it is
+ * NEVER awarded (0.7.0): writing a review is your own act, and the score
+ * counts only what others recognise. A review earns through Helpful votes.
+ *
+ * Nothing a member does for their OWN product counts, and nothing their own
+ * product receives, so the score cannot be bought with a popular product.
+ *
+ * Against farming: one member can earn at most `CONTRIBUTION_PAIR_POINTS_MAX`
+ * points from any ONE other member over 30 days, so two founders cannot trade
+ * Helpful marks into a high score.
+ *
+ * EVERY POINT IS A ROW (the ledger), so a score can be explained ("how did I
+ * earn this?"), checked and re-tuned. A point stands while what earned it
+ * stands: unmarking, withdrawing a vote, deleting the review or comment, or
+ * staff removing it takes the point back. An hourly job recounts every score
+ * from the ledger, so a total can never drift for long.
+ *
+ * Routes (all signed in):
+ *   GET /api/v1/contributions/me            paginationQuerySchema -> contributionPageSchema
+ *   GET /api/v1/contributions/leaderboard   -> contributionLeaderboardSchema
+ *
+ * The score itself is on the profile and the card (`contributionSummarySchema`).
+ *
+ * @module founder-schema/domains/contributions
+ */
+import { z } from 'zod';
+/** ⚠ Stored per ledger row: append only. */
+export declare const CONTRIBUTION_KIND_VALUES: readonly ["feedback_helpful", "tester_confirmed", "review_helpful", "review_written"];
+export declare const contributionKindSchema: z.ZodEnum<{
+    feedback_helpful: "feedback_helpful";
+    tester_confirmed: "tester_confirmed";
+    review_helpful: "review_helpful";
+    review_written: "review_written";
+}>;
+/**
+ * The kinds that are actually awarded (0.7.0): every kind but `review_written`,
+ * which is never awarded any more. "How points are earned" lists these.
+ */
+export declare const CONTRIBUTION_AWARDED_KIND_VALUES: ("feedback_helpful" | "tester_confirmed" | "review_helpful")[];
+export type ContributionKind = z.infer<typeof contributionKindSchema>;
+/**
+ * Points per kind. Exhaustive by type. Changing a number changes FUTURE rows;
+ * the hourly recount sums what each row was actually awarded.
+ */
+export declare const CONTRIBUTION_POINTS: {
+    readonly feedback_helpful: 10;
+    readonly tester_confirmed: 15;
+    readonly review_helpful: 2;
+    readonly review_written: 3;
+};
+/** One line of "how I earned my points". */
+export declare const contributionEntrySchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    kind: z.ZodEnum<{
+        feedback_helpful: "feedback_helpful";
+        tester_confirmed: "tester_confirmed";
+        review_helpful: "review_helpful";
+        review_written: "review_written";
+    }>;
+    points: z.ZodNumber;
+    actor: z.ZodNullable<z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    product: z.ZodOptional<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        slug: z.ZodString;
+        name: z.ZodString;
+        logoUrl: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>>;
+    content: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            post: "post";
+            poll: "poll";
+        }>;
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    }, z.core.$strip>>;
+    commentId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    reviewId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type ContributionEntry = z.infer<typeof contributionEntrySchema>;
+export declare const contributionPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        kind: z.ZodEnum<{
+            feedback_helpful: "feedback_helpful";
+            tester_confirmed: "tester_confirmed";
+            review_helpful: "review_helpful";
+            review_written: "review_written";
+        }>;
+        points: z.ZodNumber;
+        actor: z.ZodNullable<z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        product: z.ZodOptional<z.ZodObject<{
+            id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            slug: z.ZodString;
+            name: z.ZodString;
+            logoUrl: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strip>>;
+        content: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                post: "post";
+                poll: "poll";
+            }>;
+            id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        }, z.core.$strip>>;
+        commentId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        reviewId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ContributionPage = z.infer<typeof contributionPageSchema>;
+/** One row of the top helpers of the last `CONTRIBUTION_RECENT_DAYS` days. */
+export declare const contributionLeaderEntrySchema: z.ZodObject<{
+    rank: z.ZodNumber;
+    member: z.ZodObject<{
+        userId: z.ZodString;
+        username: z.ZodString;
+        displayName: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        headline: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    points: z.ZodNumber;
+}, z.core.$strip>;
+export type ContributionLeaderEntry = z.infer<typeof contributionLeaderEntrySchema>;
+/**
+ * Top helpers, best first, at most `CONTRIBUTION_LEADERBOARD_SIZE`. Recomputed
+ * hourly; `computedAt` says when (null before the first run).
+ */
+export declare const contributionLeaderboardSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        rank: z.ZodNumber;
+        member: z.ZodObject<{
+            userId: z.ZodString;
+            username: z.ZodString;
+            displayName: z.ZodString;
+            avatarUrl: z.ZodOptional<z.ZodURL>;
+            headline: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        points: z.ZodNumber;
+    }, z.core.$strip>>;
+    computedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+export type ContributionLeaderboard = z.infer<typeof contributionLeaderboardSchema>;
+//# sourceMappingURL=contributions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contributions.d.ts","sourceRoot":"","sources":["../../../src/domains/contributions/contributions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,uFAK3B,CAAC;AACX,eAAO,MAAM,sBAAsB;;;;;EAAmC,CAAC;AACvE;;;GAGG;AACH,eAAO,MAAM,gCAAgC,gEAG5C,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;CAKqB,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA2C,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B;;;;;;;;;;iBAKxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;iBAGxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/domains/contributions/contributions.js

@@ -0,0 +1,103 @@
+/**
+ * founder-schema — Contribution: the help a member gives, recognised
+ *
+ * The score counts HELP GIVEN, and only what OTHER members recognise:
+ *
+ *   feedback_helpful  a product's team marks your comment "this helped"     +10
+ *   tester_confirmed  a product's team confirms you tested their product    +15
+ *   review_helpful    another member finds your review helpful               +2
+ *                     (at most `REVIEW_HELPFUL_POINTS_MAX` per review)
+ *
+ * `review_written` is still listed so older rows and clients parse, but it is
+ * NEVER awarded (0.7.0): writing a review is your own act, and the score
+ * counts only what others recognise. A review earns through Helpful votes.
+ *
+ * Nothing a member does for their OWN product counts, and nothing their own
+ * product receives, so the score cannot be bought with a popular product.
+ *
+ * Against farming: one member can earn at most `CONTRIBUTION_PAIR_POINTS_MAX`
+ * points from any ONE other member over 30 days, so two founders cannot trade
+ * Helpful marks into a high score.
+ *
+ * EVERY POINT IS A ROW (the ledger), so a score can be explained ("how did I
+ * earn this?"), checked and re-tuned. A point stands while what earned it
+ * stands: unmarking, withdrawing a vote, deleting the review or comment, or
+ * staff removing it takes the point back. An hourly job recounts every score
+ * from the ledger, so a total can never drift for long.
+ *
+ * Routes (all signed in):
+ *   GET /api/v1/contributions/me            paginationQuerySchema -> contributionPageSchema
+ *   GET /api/v1/contributions/leaderboard   -> contributionLeaderboardSchema
+ *
+ * The score itself is on the profile and the card (`contributionSummarySchema`).
+ *
+ * @module founder-schema/domains/contributions
+ */
+import { z } from 'zod';
+import { objectIdSchema } from '../../core/common.js';
+import { paginatedSchema } from '../../core/responses.js';
+import { contentKindSchema } from '../feed/feed.js';
+import { productChipSchema } from '../products/products.js';
+import { memberBylineSchema } from '../profile/founder-profile.js';
+/** ⚠ Stored per ledger row: append only. */
+export const CONTRIBUTION_KIND_VALUES = [
+    'feedback_helpful',
+    'tester_confirmed',
+    'review_helpful',
+    'review_written',
+];
+export const contributionKindSchema = z.enum(CONTRIBUTION_KIND_VALUES);
+/**
+ * The kinds that are actually awarded (0.7.0): every kind but `review_written`,
+ * which is never awarded any more. "How points are earned" lists these.
+ */
+export const CONTRIBUTION_AWARDED_KIND_VALUES = CONTRIBUTION_KIND_VALUES.filter((k) => k !== 'review_written');
+/**
+ * Points per kind. Exhaustive by type. Changing a number changes FUTURE rows;
+ * the hourly recount sums what each row was actually awarded.
+ */
+export const CONTRIBUTION_POINTS = {
+    feedback_helpful: 10,
+    tester_confirmed: 15,
+    review_helpful: 2,
+    review_written: 3,
+};
+/** One line of "how I earned my points". */
+export const contributionEntrySchema = z.object({
+    id: objectIdSchema,
+    kind: contributionKindSchema,
+    /** What it was actually awarded: below the kind's points when a cap applied. */
+    points: z.number().int().positive(),
+    /**
+     * Who recognised it; null for a deleted account, and for `review_helpful`
+     * (a Helpful vote is anonymous: the review shows only a count).
+     */
+    actor: memberBylineSchema.nullable(),
+    /** The product it was about, while it exists. */
+    product: productChipSchema.optional(),
+    /**
+     * What earned it, so the row opens it: the post or poll and the comment for
+     * `feedback_helpful`, the review for `review_helpful`.
+     */
+    content: z.object({ kind: contentKindSchema, id: objectIdSchema }).optional(),
+    commentId: objectIdSchema.optional(),
+    reviewId: objectIdSchema.optional(),
+    createdAt: z.iso.datetime(),
+});
+export const contributionPageSchema = paginatedSchema(contributionEntrySchema);
+/** One row of the top helpers of the last `CONTRIBUTION_RECENT_DAYS` days. */
+export const contributionLeaderEntrySchema = z.object({
+    rank: z.number().int().positive(),
+    member: memberBylineSchema,
+    /** Points earned in the window. */
+    points: z.number().int().positive(),
+});
+/**
+ * Top helpers, best first, at most `CONTRIBUTION_LEADERBOARD_SIZE`. Recomputed
+ * hourly; `computedAt` says when (null before the first run).
+ */
+export const contributionLeaderboardSchema = z.object({
+    items: z.array(contributionLeaderEntrySchema),
+    computedAt: z.iso.datetime().nullable(),
+});
+//# sourceMappingURL=contributions.js.map

package/dist/domains/contributions/contributions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributions.js","sourceRoot":"","sources":["../../../src/domains/contributions/contributions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,kBAAkB;IAClB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AACX,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AACvE;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,wBAAwB,CAAC,MAAM,CAC7E,CAAC,CAAC,EAA6E,EAAE,CAC/E,CAAC,KAAK,gBAAgB,CACzB,CAAC;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,CAAC;CACkC,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,sBAAsB;IAC5B,gFAAgF;IAChF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC;;;OAGG;IACH,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACpC,iDAAiD;IACjD,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACrC;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7E,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC,uBAAuB,CAAC,CAAC;AAG/E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,kBAAkB;IAC1B,mCAAmC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC","sourcesContent":["/**\n * founder-schema — Contribution: the help a member gives, recognised\n *\n * The score counts HELP GIVEN, and only what OTHER members recognise:\n *\n *   feedback_helpful  a product's team marks your comment \"this helped\"     +10\n *   tester_confirmed  a product's team confirms you tested their product    +15\n *   review_helpful    another member finds your review helpful               +2\n *                     (at most `REVIEW_HELPFUL_POINTS_MAX` per review)\n *\n * `review_written` is still listed so older rows and clients parse, but it is\n * NEVER awarded (0.7.0): writing a review is your own act, and the score\n * counts only what others recognise. A review earns through Helpful votes.\n *\n * Nothing a member does for their OWN product counts, and nothing their own\n * product receives, so the score cannot be bought with a popular product.\n *\n * Against farming: one member can earn at most `CONTRIBUTION_PAIR_POINTS_MAX`\n * points from any ONE other member over 30 days, so two founders cannot trade\n * Helpful marks into a high score.\n *\n * EVERY POINT IS A ROW (the ledger), so a score can be explained (\"how did I\n * earn this?\"), checked and re-tuned. A point stands while what earned it\n * stands: unmarking, withdrawing a vote, deleting the review or comment, or\n * staff removing it takes the point back. An hourly job recounts every score\n * from the ledger, so a total can never drift for long.\n *\n * Routes (all signed in):\n *   GET /api/v1/contributions/me            paginationQuerySchema -> contributionPageSchema\n *   GET /api/v1/contributions/leaderboard   -> contributionLeaderboardSchema\n *\n * The score itself is on the profile and the card (`contributionSummarySchema`).\n *\n * @module founder-schema/domains/contributions\n */\n\nimport { z } from 'zod';\nimport { objectIdSchema } from '../../core/common.js';\nimport { paginatedSchema } from '../../core/responses.js';\nimport { contentKindSchema } from '../feed/feed.js';\nimport { productChipSchema } from '../products/products.js';\nimport { memberBylineSchema } from '../profile/founder-profile.js';\n\n/** ⚠ Stored per ledger row: append only. */\nexport const CONTRIBUTION_KIND_VALUES = [\n  'feedback_helpful',\n  'tester_confirmed',\n  'review_helpful',\n  'review_written',\n] as const;\nexport const contributionKindSchema = z.enum(CONTRIBUTION_KIND_VALUES);\n/**\n * The kinds that are actually awarded (0.7.0): every kind but `review_written`,\n * which is never awarded any more. \"How points are earned\" lists these.\n */\nexport const CONTRIBUTION_AWARDED_KIND_VALUES = CONTRIBUTION_KIND_VALUES.filter(\n  (k): k is Exclude<(typeof CONTRIBUTION_KIND_VALUES)[number], 'review_written'> =>\n    k !== 'review_written',\n);\nexport type ContributionKind = z.infer<typeof contributionKindSchema>;\n\n/**\n * Points per kind. Exhaustive by type. Changing a number changes FUTURE rows;\n * the hourly recount sums what each row was actually awarded.\n */\nexport const CONTRIBUTION_POINTS = {\n  feedback_helpful: 10,\n  tester_confirmed: 15,\n  review_helpful: 2,\n  review_written: 3,\n} as const satisfies Record<ContributionKind, number>;\n\n/** One line of \"how I earned my points\". */\nexport const contributionEntrySchema = z.object({\n  id: objectIdSchema,\n  kind: contributionKindSchema,\n  /** What it was actually awarded: below the kind's points when a cap applied. */\n  points: z.number().int().positive(),\n  /**\n   * Who recognised it; null for a deleted account, and for `review_helpful`\n   * (a Helpful vote is anonymous: the review shows only a count).\n   */\n  actor: memberBylineSchema.nullable(),\n  /** The product it was about, while it exists. */\n  product: productChipSchema.optional(),\n  /**\n   * What earned it, so the row opens it: the post or poll and the comment for\n   * `feedback_helpful`, the review for `review_helpful`.\n   */\n  content: z.object({ kind: contentKindSchema, id: objectIdSchema }).optional(),\n  commentId: objectIdSchema.optional(),\n  reviewId: objectIdSchema.optional(),\n  createdAt: z.iso.datetime(),\n});\nexport type ContributionEntry = z.infer<typeof contributionEntrySchema>;\n\nexport const contributionPageSchema = paginatedSchema(contributionEntrySchema);\nexport type ContributionPage = z.infer<typeof contributionPageSchema>;\n\n/** One row of the top helpers of the last `CONTRIBUTION_RECENT_DAYS` days. */\nexport const contributionLeaderEntrySchema = z.object({\n  rank: z.number().int().positive(),\n  member: memberBylineSchema,\n  /** Points earned in the window. */\n  points: z.number().int().positive(),\n});\nexport type ContributionLeaderEntry = z.infer<typeof contributionLeaderEntrySchema>;\n\n/**\n * Top helpers, best first, at most `CONTRIBUTION_LEADERBOARD_SIZE`. Recomputed\n * hourly; `computedAt` says when (null before the first run).\n */\nexport const contributionLeaderboardSchema = z.object({\n  items: z.array(contributionLeaderEntrySchema),\n  computedAt: z.iso.datetime().nullable(),\n});\nexport type ContributionLeaderboard = z.infer<typeof contributionLeaderboardSchema>;\n"]}

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

@@ -87,9 +87,14 @@ export declare const discoverPageSchema: z.ZodObject<{
             country: z.ZodString;
         }, z.core.$strip>>;
         displayName: z.ZodString;
+        userId: z.ZodString;
         username: z.ZodString;
         avatarUrl: z.ZodOptional<z.ZodURL>;
         headline: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;
+        contribution: z.ZodObject<{
+            score: z.ZodNumber;
+            helpedCount: z.ZodNumber;
+        }, z.core.$strip>;
         venture: z.ZodOptional<z.ZodObject<{
             name: z.ZodString;
             tagline: z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>;

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

@@ -1 +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"}
+{"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;AAiBxB;;;;;;;;;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

@@ -8,22 +8,12 @@
  * @module founder-schema/domains/discover
  */
 import { z } from 'zod';
-import { industrySchema, optionalTrimmedString, paginationQuerySchema, skillSchema, startupStageSchema, } from '../../core/common.js';
+import { industrySchema, multiValueQuery, 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());
+/** A Discover multi-select (`?skill=a&skill=b`): see `multiValueQuery`. */
+const multiValue = (inner) => multiValueQuery(inner, DISCOVER_FILTER_VALUES_MAX);
 /**
  * Every free-text filter here is `optionalTrimmedString`, so an EMPTY one is
  * treated as "not provided" rather than as a validation failure.

package/dist/domains/discover/discover.js.map

@@ -1 +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"]}
+{"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,eAAe,EACf,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,2EAA2E;AAC3E,MAAM,UAAU,GAAG,CAAsB,KAAQ,EAAE,EAAE,CACnD,eAAe,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;AAErD;;;;;;;;;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  multiValueQuery,\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/** A Discover multi-select (`?skill=a&skill=b`): see `multiValueQuery`. */\nconst multiValue = <T extends z.ZodType>(inner: T) =>\n  multiValueQuery(inner, DISCOVER_FILTER_VALUES_MAX);\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"]}