founder-schema 0.11.0 → 0.13.0

package/dist/domains/membership/membership.d.ts

@@ -0,0 +1,240 @@
+/**
+ * founder-schema: membership and plans, as a member holds them (0.12.0)
+ *
+ *   GET /api/v1/plans           planCatalogSchema   (anyone: prices and what each includes)
+ *   GET /api/v1/me/membership   meMembershipSchema  (signed in: what I hold, what I have used)
+ *
+ * THE USER'S RULING (2026-10-11): looking is free; taking part needs a
+ * MEMBERSHIP, Rs 99 once, for life (the first 100 free with a coupon). On top,
+ * two PLANS: Premium (5 live products, 15 new people a month to message) and
+ * Business (unlimited products, 50 new people). Prices and plan contents come
+ * from the server, so a change needs no client release.
+ *
+ * A PLAN IS TIME, PREPAID, IN TWO BLOCKS: Business time first, then Premium
+ * time. Buying more APPENDS; buying Premium while on Business waits its turn;
+ * buying Business while on Premium is an upgrade that turns the Premium time
+ * left into Business for the difference (`domains/billing`). `blocks` says it
+ * as it stands, from now on.
+ *
+ * Money is integer PAISE everywhere in this package: never a float of rupees.
+ *
+ * @module founder-schema/domains/membership
+ */
+import { z } from 'zod';
+/**
+ * How someone came to hold a membership. ⚠ Stored: append only.
+ *
+ *   founding  the founding coupon (`FIRST100`): free for life, numbered
+ *   coupon    another free-membership coupon
+ *   paid      Rs 99, captured
+ *   granted   staff gave it (a partner, a press account), with a reason on record
+ */
+export declare const MEMBERSHIP_KIND_VALUES: readonly ["founding", "coupon", "paid", "granted"];
+export declare const membershipKindSchema: z.ZodEnum<{
+    founding: "founding";
+    coupon: "coupon";
+    paid: "paid";
+    granted: "granted";
+}>;
+export type MembershipKind = z.infer<typeof membershipKindSchema>;
+/** ⚠ Stored: append only. Highest last is NOT implied: compare with `PLAN_TIER_RANK`. */
+export declare const PLAN_TIER_VALUES: readonly ["premium", "business"];
+export declare const planTierSchema: z.ZodEnum<{
+    premium: "premium";
+    business: "business";
+}>;
+export type PlanTier = z.infer<typeof planTierSchema>;
+/** Which tier outranks which: Business above Premium. */
+export declare const PLAN_TIER_RANK: Readonly<Record<PlanTier, number>>;
+/** One payment buys a calendar month or a calendar year. ⚠ Stored: append only. */
+export declare const PLAN_PERIOD_VALUES: readonly ["month", "year"];
+export declare const planPeriodSchema: z.ZodEnum<{
+    month: "month";
+    year: "year";
+}>;
+export type PlanPeriod = z.infer<typeof planPeriodSchema>;
+/** Integer paise, never negative. Rs 399 is 39900. */
+export declare const paiseSchema: z.ZodNumber;
+export type Paise = z.infer<typeof paiseSchema>;
+/**
+ * What a standing or a plan allows that is COUNTED (the ability says whether;
+ * these say how many).
+ *
+ *   productsLive       products live at once; null is unlimited (the server
+ *                      still holds a safety ceiling, `PRODUCTS_LIVE_SAFETY_MAX`)
+ *   newPeoplePerMonth  conversations a month with people you do not know
+ */
+export declare const planLimitsSchema: z.ZodObject<{
+    productsLive: z.ZodNullable<z.ZodNumber>;
+    newPeoplePerMonth: z.ZodNumber;
+}, z.core.$strip>;
+export type PlanLimits = z.infer<typeof planLimitsSchema>;
+/** The membership: once, for life. */
+export declare const MEMBERSHIP_PRICE_PAISE = 9900;
+/** What a member with no plan may: 1 live product, no conversations with people they do not know. */
+export declare const MEMBER_LIMIT_VALUES: PlanLimits;
+/** Each plan's name, prices and limits. Exhaustive by type. */
+export declare const PLAN_SPECS: Readonly<Record<PlanTier, {
+    name: string;
+    prices: Readonly<Record<PlanPeriod, number>>;
+    limits: PlanLimits;
+}>>;
+/** Free founding memberships on the seeded `FIRST100` code. */
+export declare const FOUNDING_PLACES = 100;
+export declare const planOfferSchema: z.ZodObject<{
+    tier: z.ZodEnum<{
+        premium: "premium";
+        business: "business";
+    }>;
+    name: z.ZodString;
+    prices: z.ZodObject<{
+        month: z.ZodNumber;
+        year: z.ZodNumber;
+    }, z.core.$strip>;
+    limits: z.ZodObject<{
+        productsLive: z.ZodNullable<z.ZodNumber>;
+        newPeoplePerMonth: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PlanOffer = z.infer<typeof planOfferSchema>;
+export declare const planCatalogSchema: z.ZodObject<{
+    currency: z.ZodLiteral<"INR">;
+    membership: z.ZodObject<{
+        price: z.ZodNumber;
+        limits: z.ZodObject<{
+            productsLive: z.ZodNullable<z.ZodNumber>;
+            newPeoplePerMonth: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    plans: z.ZodArray<z.ZodObject<{
+        tier: z.ZodEnum<{
+            premium: "premium";
+            business: "business";
+        }>;
+        name: z.ZodString;
+        prices: z.ZodObject<{
+            month: z.ZodNumber;
+            year: z.ZodNumber;
+        }, z.core.$strip>;
+        limits: z.ZodObject<{
+            productsLive: z.ZodNullable<z.ZodNumber>;
+            newPeoplePerMonth: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    refundWindowDays: z.ZodNumber;
+    paymentsEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type PlanCatalog = z.infer<typeof planCatalogSchema>;
+export declare const membershipSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        founding: "founding";
+        coupon: "coupon";
+        paid: "paid";
+        granted: "granted";
+    }>;
+    since: z.ZodISODateTime;
+    foundingNumber: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type Membership = z.infer<typeof membershipSchema>;
+/** A stretch of one tier. Blocks never overlap and follow each other with no gap. */
+export declare const planBlockSchema: z.ZodObject<{
+    tier: z.ZodEnum<{
+        premium: "premium";
+        business: "business";
+    }>;
+    startsAt: z.ZodISODateTime;
+    endsAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type PlanBlock = z.infer<typeof planBlockSchema>;
+export declare const meMembershipSchema: z.ZodObject<{
+    standing: z.ZodEnum<{
+        viewer: "viewer";
+        member: "member";
+    }>;
+    membership: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            founding: "founding";
+            coupon: "coupon";
+            paid: "paid";
+            granted: "granted";
+        }>;
+        since: z.ZodISODateTime;
+        foundingNumber: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    through: z.ZodNullable<z.ZodEnum<{
+        staff: "staff";
+        membership: "membership";
+    }>>;
+    plan: z.ZodObject<{
+        tier: z.ZodNullable<z.ZodEnum<{
+            premium: "premium";
+            business: "business";
+        }>>;
+        blocks: z.ZodArray<z.ZodObject<{
+            tier: z.ZodEnum<{
+                premium: "premium";
+                business: "business";
+            }>;
+            startsAt: z.ZodISODateTime;
+            endsAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    limits: z.ZodObject<{
+        productsLive: z.ZodNullable<z.ZodNumber>;
+        newPeoplePerMonth: z.ZodNumber;
+    }, z.core.$strip>;
+    products: z.ZodObject<{
+        live: z.ZodNumber;
+        owned: z.ZodNumber;
+        counted: z.ZodNumber;
+    }, z.core.$strip>;
+    messages: z.ZodObject<{
+        used: z.ZodNumber;
+        resetsAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    billing: z.ZodNullable<z.ZodObject<{
+        stateCode: z.ZodEnum<{
+            "01": "01";
+            "02": "02";
+            "03": "03";
+            "04": "04";
+            "05": "05";
+            "06": "06";
+            "07": "07";
+            "08": "08";
+            "09": "09";
+            10: "10";
+            11: "11";
+            12: "12";
+            13: "13";
+            14: "14";
+            15: "15";
+            16: "16";
+            17: "17";
+            18: "18";
+            19: "19";
+            20: "20";
+            21: "21";
+            22: "22";
+            23: "23";
+            24: "24";
+            26: "26";
+            27: "27";
+            29: "29";
+            30: "30";
+            31: "31";
+            32: "32";
+            33: "33";
+            34: "34";
+            35: "35";
+            36: "36";
+            37: "37";
+            38: "38";
+        }>;
+        gstin: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        legalName: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MeMembership = z.infer<typeof meMembershipSchema>;
+//# sourceMappingURL=membership.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../../../src/domains/membership/membership.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,oDAAqD,CAAC;AACzF,eAAO,MAAM,oBAAoB;;;;;EAAiC,CAAC;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,kCAAmC,CAAC;AACjE,eAAO,MAAM,cAAc;;;EAA2B,CAAC;AACvD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,yDAAyD;AACzD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA+B,CAAC;AAE9F,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,4BAA6B,CAAC;AAC7D,eAAO,MAAM,gBAAgB;;;EAA6B,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,sDAAsD;AACtD,eAAO,MAAM,WAAW,aAAiC,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAW1D,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,EAAE,UAAsD,CAAC;AAEzF,+DAA+D;AAC/D,eAAO,MAAM,UAAU,EAAE,QAAQ,CAC/B,MAAM,CACJ,QAAQ,EACR;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CACnF,CAYF,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,eAAe,MAAM,CAAC;AAInC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;iBAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,gBAAgB;;;;;;;;;iBAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,qFAAqF;AACrF,eAAO,MAAM,eAAe;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/domains/membership/membership.js

@@ -0,0 +1,159 @@
+/**
+ * founder-schema: membership and plans, as a member holds them (0.12.0)
+ *
+ *   GET /api/v1/plans           planCatalogSchema   (anyone: prices and what each includes)
+ *   GET /api/v1/me/membership   meMembershipSchema  (signed in: what I hold, what I have used)
+ *
+ * THE USER'S RULING (2026-10-11): looking is free; taking part needs a
+ * MEMBERSHIP, Rs 99 once, for life (the first 100 free with a coupon). On top,
+ * two PLANS: Premium (5 live products, 15 new people a month to message) and
+ * Business (unlimited products, 50 new people). Prices and plan contents come
+ * from the server, so a change needs no client release.
+ *
+ * A PLAN IS TIME, PREPAID, IN TWO BLOCKS: Business time first, then Premium
+ * time. Buying more APPENDS; buying Premium while on Business waits its turn;
+ * buying Business while on Premium is an upgrade that turns the Premium time
+ * left into Business for the difference (`domains/billing`). `blocks` says it
+ * as it stands, from now on.
+ *
+ * Money is integer PAISE everywhere in this package: never a float of rupees.
+ *
+ * @module founder-schema/domains/membership
+ */
+import { z } from 'zod';
+import { standingSchema } from '../../access/standing.js';
+import { billingDetailsSchema } from '../billing/gst.js';
+/**
+ * How someone came to hold a membership. ⚠ Stored: append only.
+ *
+ *   founding  the founding coupon (`FIRST100`): free for life, numbered
+ *   coupon    another free-membership coupon
+ *   paid      Rs 99, captured
+ *   granted   staff gave it (a partner, a press account), with a reason on record
+ */
+export const MEMBERSHIP_KIND_VALUES = ['founding', 'coupon', 'paid', 'granted'];
+export const membershipKindSchema = z.enum(MEMBERSHIP_KIND_VALUES);
+/** ⚠ Stored: append only. Highest last is NOT implied: compare with `PLAN_TIER_RANK`. */
+export const PLAN_TIER_VALUES = ['premium', 'business'];
+export const planTierSchema = z.enum(PLAN_TIER_VALUES);
+/** Which tier outranks which: Business above Premium. */
+export const PLAN_TIER_RANK = { premium: 1, business: 2 };
+/** One payment buys a calendar month or a calendar year. ⚠ Stored: append only. */
+export const PLAN_PERIOD_VALUES = ['month', 'year'];
+export const planPeriodSchema = z.enum(PLAN_PERIOD_VALUES);
+/** Integer paise, never negative. Rs 399 is 39900. */
+export const paiseSchema = z.number().int().nonnegative();
+/**
+ * What a standing or a plan allows that is COUNTED (the ability says whether;
+ * these say how many).
+ *
+ *   productsLive       products live at once; null is unlimited (the server
+ *                      still holds a safety ceiling, `PRODUCTS_LIVE_SAFETY_MAX`)
+ *   newPeoplePerMonth  conversations a month with people you do not know
+ */
+export const planLimitsSchema = z.object({
+    productsLive: z.number().int().nonnegative().nullable(),
+    newPeoplePerMonth: z.number().int().nonnegative(),
+});
+// ─── The price list ──────────────────────────────────────────────────────────
+//
+// THE ONE PLACE a price or a plan's limit is written (0.12.0). The backend
+// prices and counts from these (`modules/plans/catalog.ts`), `GET /plans`
+// serves them, and the web's Terms of Service are written FROM them, so the
+// Terms can never state a price the server does not charge. A change here is
+// a schema release, then the backend, then the web. Integer PAISE, GST
+// included. hary's India-first prices (the user: "you decide, India first").
+/** The membership: once, for life. */
+export const MEMBERSHIP_PRICE_PAISE = 9_900;
+/** What a member with no plan may: 1 live product, no conversations with people they do not know. */
+export const MEMBER_LIMIT_VALUES = { productsLive: 1, newPeoplePerMonth: 0 };
+/** Each plan's name, prices and limits. Exhaustive by type. */
+export const PLAN_SPECS = {
+    premium: {
+        name: 'Premium',
+        prices: { month: 39_900, year: 399_900 },
+        limits: { productsLive: 5, newPeoplePerMonth: 15 },
+    },
+    business: {
+        name: 'Business',
+        prices: { month: 99_900, year: 999_900 },
+        limits: { productsLive: null, newPeoplePerMonth: 50 },
+    },
+};
+/** Free founding memberships on the seeded `FIRST100` code. */
+export const FOUNDING_PLACES = 100;
+// ─── GET /plans ──────────────────────────────────────────────────────────────
+export const planOfferSchema = z.object({
+    tier: planTierSchema,
+    /** "Premium", "Business": the server's word, so a rename needs no client release. */
+    name: z.string(),
+    /** GST included. */
+    prices: z.object({ month: paiseSchema, year: paiseSchema }),
+    limits: planLimitsSchema,
+});
+export const planCatalogSchema = z.object({
+    currency: z.literal('INR'),
+    membership: z.object({
+        /** Once, for life, GST included. */
+        price: paiseSchema,
+        limits: planLimitsSchema,
+    }),
+    /** Lowest first. */
+    plans: z.array(planOfferSchema),
+    /** Every purchase is refunded in full within this many days of paying. */
+    refundWindowDays: z.number().int().positive(),
+    /**
+     * Whether a payment can be taken here now. False when the gateway is not
+     * configured: a free coupon still works, a paid purchase answers
+     * `PAYMENTS_UNAVAILABLE`.
+     */
+    paymentsEnabled: z.boolean(),
+});
+// ─── GET /me/membership ──────────────────────────────────────────────────────
+export const membershipSchema = z.object({
+    kind: membershipKindSchema,
+    since: z.iso.datetime(),
+    /** "Founding member #N": set only for `founding`. */
+    foundingNumber: z.number().int().positive().nullable(),
+});
+/** A stretch of one tier. Blocks never overlap and follow each other with no gap. */
+export const planBlockSchema = z.object({
+    tier: planTierSchema,
+    startsAt: z.iso.datetime(),
+    endsAt: z.iso.datetime(),
+});
+export const meMembershipSchema = z.object({
+    standing: standingSchema,
+    /** Null for a viewer, and for staff who hold none (they take part through their role). */
+    membership: membershipSchema.nullable(),
+    /** Why they take part: their membership, or a staff role (staff are members). Null for a viewer. */
+    through: z.enum(['membership', 'staff']).nullable(),
+    plan: z.object({
+        /** The tier in force now; null with no plan. */
+        tier: planTierSchema.nullable(),
+        /** From now on, Business first, then Premium. Empty with no plan. */
+        blocks: z.array(planBlockSchema),
+    }),
+    limits: planLimitsSchema,
+    products: z.object({
+        /** Products they own that are live now. */
+        live: z.number().int().nonnegative(),
+        /** Products they own, paused ones included. */
+        owned: z.number().int().nonnegative(),
+        /**
+         * What adding another counts against (0.13.0): live ones and the ones
+         * they paused themselves, not those a plan's end paused. "Add a product"
+         * stops when this reaches `limits.productsLive`: pausing never makes room.
+         */
+        counted: z.number().int().nonnegative(),
+    }),
+    messages: z.object({
+        /** New people they started a conversation with this month (India time). */
+        used: z.number().int().nonnegative(),
+        /** When this month's count starts again. */
+        resetsAt: z.iso.datetime(),
+    }),
+    /** The billing details they last used, to prefill the next checkout; null before the first. */
+    billing: billingDetailsSchema.nullable(),
+});
+//# sourceMappingURL=membership.js.map

package/dist/domains/membership/membership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership.js","sourceRoot":"","sources":["../../../src/domains/membership/membership.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema: membership and plans, as a member holds them (0.12.0)\n *\n *   GET /api/v1/plans           planCatalogSchema   (anyone: prices and what each includes)\n *   GET /api/v1/me/membership   meMembershipSchema  (signed in: what I hold, what I have used)\n *\n * THE USER'S RULING (2026-10-11): looking is free; taking part needs a\n * MEMBERSHIP, Rs 99 once, for life (the first 100 free with a coupon). On top,\n * two PLANS: Premium (5 live products, 15 new people a month to message) and\n * Business (unlimited products, 50 new people). Prices and plan contents come\n * from the server, so a change needs no client release.\n *\n * A PLAN IS TIME, PREPAID, IN TWO BLOCKS: Business time first, then Premium\n * time. Buying more APPENDS; buying Premium while on Business waits its turn;\n * buying Business while on Premium is an upgrade that turns the Premium time\n * left into Business for the difference (`domains/billing`). `blocks` says it\n * as it stands, from now on.\n *\n * Money is integer PAISE everywhere in this package: never a float of rupees.\n *\n * @module founder-schema/domains/membership\n */\n\nimport { z } from 'zod';\nimport { standingSchema } from '../../access/standing.js';\nimport { billingDetailsSchema } from '../billing/gst.js';\n\n/**\n * How someone came to hold a membership. ⚠ Stored: append only.\n *\n *   founding  the founding coupon (`FIRST100`): free for life, numbered\n *   coupon    another free-membership coupon\n *   paid      Rs 99, captured\n *   granted   staff gave it (a partner, a press account), with a reason on record\n */\nexport const MEMBERSHIP_KIND_VALUES = ['founding', 'coupon', 'paid', 'granted'] as const;\nexport const membershipKindSchema = z.enum(MEMBERSHIP_KIND_VALUES);\nexport type MembershipKind = z.infer<typeof membershipKindSchema>;\n\n/** ⚠ Stored: append only. Highest last is NOT implied: compare with `PLAN_TIER_RANK`. */\nexport const PLAN_TIER_VALUES = ['premium', 'business'] as const;\nexport const planTierSchema = z.enum(PLAN_TIER_VALUES);\nexport type PlanTier = z.infer<typeof planTierSchema>;\n\n/** Which tier outranks which: Business above Premium. */\nexport const PLAN_TIER_RANK: Readonly<Record<PlanTier, number>> = { premium: 1, business: 2 };\n\n/** One payment buys a calendar month or a calendar year. ⚠ Stored: append only. */\nexport const PLAN_PERIOD_VALUES = ['month', 'year'] as const;\nexport const planPeriodSchema = z.enum(PLAN_PERIOD_VALUES);\nexport type PlanPeriod = z.infer<typeof planPeriodSchema>;\n\n/** Integer paise, never negative. Rs 399 is 39900. */\nexport const paiseSchema = z.number().int().nonnegative();\nexport type Paise = z.infer<typeof paiseSchema>;\n\n/**\n * What a standing or a plan allows that is COUNTED (the ability says whether;\n * these say how many).\n *\n *   productsLive       products live at once; null is unlimited (the server\n *                      still holds a safety ceiling, `PRODUCTS_LIVE_SAFETY_MAX`)\n *   newPeoplePerMonth  conversations a month with people you do not know\n */\nexport const planLimitsSchema = z.object({\n  productsLive: z.number().int().nonnegative().nullable(),\n  newPeoplePerMonth: z.number().int().nonnegative(),\n});\nexport type PlanLimits = z.infer<typeof planLimitsSchema>;\n\n// ─── The price list ──────────────────────────────────────────────────────────\n//\n// THE ONE PLACE a price or a plan's limit is written (0.12.0). The backend\n// prices and counts from these (`modules/plans/catalog.ts`), `GET /plans`\n// serves them, and the web's Terms of Service are written FROM them, so the\n// Terms can never state a price the server does not charge. A change here is\n// a schema release, then the backend, then the web. Integer PAISE, GST\n// included. hary's India-first prices (the user: \"you decide, India first\").\n\n/** The membership: once, for life. */\nexport const MEMBERSHIP_PRICE_PAISE = 9_900;\n\n/** What a member with no plan may: 1 live product, no conversations with people they do not know. */\nexport const MEMBER_LIMIT_VALUES: PlanLimits = { productsLive: 1, newPeoplePerMonth: 0 };\n\n/** Each plan's name, prices and limits. Exhaustive by type. */\nexport const PLAN_SPECS: Readonly<\n  Record<\n    PlanTier,\n    { name: string; prices: Readonly<Record<PlanPeriod, number>>; limits: PlanLimits }\n  >\n> = {\n  premium: {\n    name: 'Premium',\n    prices: { month: 39_900, year: 399_900 },\n    limits: { productsLive: 5, newPeoplePerMonth: 15 },\n  },\n  business: {\n    name: 'Business',\n    prices: { month: 99_900, year: 999_900 },\n    limits: { productsLive: null, newPeoplePerMonth: 50 },\n  },\n};\n\n/** Free founding memberships on the seeded `FIRST100` code. */\nexport const FOUNDING_PLACES = 100;\n\n// ─── GET /plans ──────────────────────────────────────────────────────────────\n\nexport const planOfferSchema = z.object({\n  tier: planTierSchema,\n  /** \"Premium\", \"Business\": the server's word, so a rename needs no client release. */\n  name: z.string(),\n  /** GST included. */\n  prices: z.object({ month: paiseSchema, year: paiseSchema }),\n  limits: planLimitsSchema,\n});\nexport type PlanOffer = z.infer<typeof planOfferSchema>;\n\nexport const planCatalogSchema = z.object({\n  currency: z.literal('INR'),\n  membership: z.object({\n    /** Once, for life, GST included. */\n    price: paiseSchema,\n    limits: planLimitsSchema,\n  }),\n  /** Lowest first. */\n  plans: z.array(planOfferSchema),\n  /** Every purchase is refunded in full within this many days of paying. */\n  refundWindowDays: z.number().int().positive(),\n  /**\n   * Whether a payment can be taken here now. False when the gateway is not\n   * configured: a free coupon still works, a paid purchase answers\n   * `PAYMENTS_UNAVAILABLE`.\n   */\n  paymentsEnabled: z.boolean(),\n});\nexport type PlanCatalog = z.infer<typeof planCatalogSchema>;\n\n// ─── GET /me/membership ──────────────────────────────────────────────────────\n\nexport const membershipSchema = z.object({\n  kind: membershipKindSchema,\n  since: z.iso.datetime(),\n  /** \"Founding member #N\": set only for `founding`. */\n  foundingNumber: z.number().int().positive().nullable(),\n});\nexport type Membership = z.infer<typeof membershipSchema>;\n\n/** A stretch of one tier. Blocks never overlap and follow each other with no gap. */\nexport const planBlockSchema = z.object({\n  tier: planTierSchema,\n  startsAt: z.iso.datetime(),\n  endsAt: z.iso.datetime(),\n});\nexport type PlanBlock = z.infer<typeof planBlockSchema>;\n\nexport const meMembershipSchema = z.object({\n  standing: standingSchema,\n  /** Null for a viewer, and for staff who hold none (they take part through their role). */\n  membership: membershipSchema.nullable(),\n  /** Why they take part: their membership, or a staff role (staff are members). Null for a viewer. */\n  through: z.enum(['membership', 'staff']).nullable(),\n  plan: z.object({\n    /** The tier in force now; null with no plan. */\n    tier: planTierSchema.nullable(),\n    /** From now on, Business first, then Premium. Empty with no plan. */\n    blocks: z.array(planBlockSchema),\n  }),\n  limits: planLimitsSchema,\n  products: z.object({\n    /** Products they own that are live now. */\n    live: z.number().int().nonnegative(),\n    /** Products they own, paused ones included. */\n    owned: z.number().int().nonnegative(),\n    /**\n     * What adding another counts against (0.13.0): live ones and the ones\n     * they paused themselves, not those a plan's end paused. \"Add a product\"\n     * stops when this reaches `limits.productsLive`: pausing never makes room.\n     */\n    counted: z.number().int().nonnegative(),\n  }),\n  messages: z.object({\n    /** New people they started a conversation with this month (India time). */\n    used: z.number().int().nonnegative(),\n    /** When this month's count starts again. */\n    resetsAt: z.iso.datetime(),\n  }),\n  /** The billing details they last used, to prefill the next checkout; null before the first. */\n  billing: billingDetailsSchema.nullable(),\n});\nexport type MeMembership = z.infer<typeof meMembershipSchema>;\n"]}

package/dist/domains/notifications/notifications.d.ts

@@ -48,12 +48,15 @@ import { z } from 'zod';
  *   community_invite         a community invited you (always delivered)
  *   community_announcement   a community you are in pinned an announcement for everyone
  *   community_suggestion_decided  your community suggestion was approved or declined (always delivered)
+ *   plan_ending              your plan ends in 7 days, then in 1 day (0.12.0, always delivered)
+ *   plan_ended               your plan ended; `paused` products were paused (0.12.0, always delivered)
+ *   payment_refunded         staff refunded one of your payments (0.12.0, always delivered)
  *
  * The three 0.8.0 kinds merge per target like the others. A reaction counts
  * once: changing it to another type is not a new event, and taking it back
  * does not take the event back.
  */
-export declare const NOTIFICATION_KIND_VALUES: readonly ["comment_on_post", "reply_to_comment", "product_invite", "product_invite_accepted", "product_review", "review_reply", "feedback_helpful", "tester_confirmed", "post_reaction", "comment_reaction", "repost", "community_join_request", "community_request_approved", "community_invite", "community_announcement", "community_suggestion_decided"];
+export declare const NOTIFICATION_KIND_VALUES: readonly ["comment_on_post", "reply_to_comment", "product_invite", "product_invite_accepted", "product_review", "review_reply", "feedback_helpful", "tester_confirmed", "post_reaction", "comment_reaction", "repost", "community_join_request", "community_request_approved", "community_invite", "community_announcement", "community_suggestion_decided", "plan_ending", "plan_ended", "payment_refunded"];
 export declare const notificationKindSchema: z.ZodEnum<{
     feedback_helpful: "feedback_helpful";
     tester_confirmed: "tester_confirmed";
@@ -71,6 +74,9 @@ export declare const notificationKindSchema: z.ZodEnum<{
     community_invite: "community_invite";
     community_announcement: "community_announcement";
     community_suggestion_decided: "community_suggestion_decided";
+    plan_ending: "plan_ending";
+    plan_ended: "plan_ended";
+    payment_refunded: "payment_refunded";
 }>;
 export type NotificationKind = z.infer<typeof notificationKindSchema>;
 /** The switches a member has, each covering one or more kinds. */
@@ -106,6 +112,9 @@ export declare const NOTIFICATION_PREFERENCE_OF: {
     readonly community_invite: null;
     readonly community_announcement: "communities";
     readonly community_suggestion_decided: null;
+    readonly plan_ending: null;
+    readonly plan_ended: null;
+    readonly payment_refunded: null;
 };
 /**
  * One row of the bell. Which of the optional targets are present depends on
@@ -127,6 +136,9 @@ export declare const NOTIFICATION_PREFERENCE_OF: {
  *   community_invite         community
  *   community_announcement   community, content (the pinned post or poll)
  *   community_suggestion_decided  suggestion, community (once approved)
+ *   plan_ending              plan (the tier, and when it ends)
+ *   plan_ended               plan (the tier that ended), paused (how many products)
+ *   payment_refunded         payment
  *
  * Any row about something inside a community also carries `community`
  * (0.9.0), whatever its kind. When the recipient leaves the community, is
@@ -155,6 +167,9 @@ export declare const notificationSchema: z.ZodObject<{
         community_invite: "community_invite";
         community_announcement: "community_announcement";
         community_suggestion_decided: "community_suggestion_decided";
+        plan_ending: "plan_ending";
+        plan_ended: "plan_ended";
+        payment_refunded: "payment_refunded";
     }>;
     actor: z.ZodNullable<z.ZodObject<{
         userId: z.ZodString;
@@ -201,6 +216,18 @@ export declare const notificationSchema: z.ZodObject<{
         }>;
         reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    plan: z.ZodOptional<z.ZodObject<{
+        tier: z.ZodEnum<{
+            premium: "premium";
+            business: "business";
+        }>;
+        endsAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    paused: z.ZodOptional<z.ZodNumber>;
+    payment: z.ZodOptional<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        title: z.ZodString;
+    }, z.core.$strip>>;
     role: z.ZodOptional<z.ZodEnum<{
         team: "team";
         cofounder: "cofounder";
@@ -240,6 +267,9 @@ export declare const notificationPageSchema: z.ZodObject<{
             community_invite: "community_invite";
             community_announcement: "community_announcement";
             community_suggestion_decided: "community_suggestion_decided";
+            plan_ending: "plan_ending";
+            plan_ended: "plan_ended";
+            payment_refunded: "payment_refunded";
         }>;
         actor: z.ZodNullable<z.ZodObject<{
             userId: z.ZodString;
@@ -286,6 +316,18 @@ export declare const notificationPageSchema: z.ZodObject<{
             }>;
             reason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        plan: z.ZodOptional<z.ZodObject<{
+            tier: z.ZodEnum<{
+                premium: "premium";
+                business: "business";
+            }>;
+            endsAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        paused: z.ZodOptional<z.ZodNumber>;
+        payment: z.ZodOptional<z.ZodObject<{
+            id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            title: z.ZodString;
+        }, z.core.$strip>>;
         role: z.ZodOptional<z.ZodEnum<{
             team: "team";
             cofounder: "cofounder";

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

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/domains/notifications/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,wBAAwB,8VAiB3B,CAAC;AACX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;EAAmC,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,kEAAkE;AAClE,eAAO,MAAM,8BAA8B,2GAQjC,CAAC;AACX,eAAO,MAAM,4BAA4B;;;;;;;;EAAyC,CAAC;AACnF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;CAiBqC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmD7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAsC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,iBAAiB;AACjB,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,wBAAwB;;iBAA+C,CAAC;AACrF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,+CAA+C;AAC/C,eAAO,MAAM,6BAA6B;;;;;;;;iBAWxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,kFAAkF;AAClF,eAAO,MAAM,uCAAuC;;;;;;;;iBAQlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAC"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/domains/notifications/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,wBAAwB,+YAoB3B,CAAC;AACX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;EAAmC,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,kEAAkE;AAClE,eAAO,MAAM,8BAA8B,2GAQjC,CAAC;AACX,eAAO,MAAM,4BAA4B;;;;;;;;EAAyC,CAAC;AACnF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;CAoBqC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyD7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAsC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,iBAAiB;AACjB,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,wBAAwB;;iBAA+C,CAAC;AACrF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,+CAA+C;AAC/C,eAAO,MAAM,6BAA6B;;;;;;;;iBAWxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,kFAAkF;AAClF,eAAO,MAAM,uCAAuC;;;;;;;;iBAQlD,CAAC;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAC"}

package/dist/domains/notifications/notifications.js

@@ -34,6 +34,7 @@ import { NOTIFICATION_EXCERPT_MAX } from '../../core/limits.js';
 import { paginatedSchema } from '../../core/responses.js';
 import { communityChipSchema } from '../communities/communities.js';
 import { contentKindSchema, reactionTypeSchema } from '../feed/feed.js';
+import { planTierSchema } from '../membership/membership.js';
 import { productChipSchema, productInvitableRoleSchema } from '../products/products.js';
 import { memberBylineSchema } from '../profile/founder-profile.js';
 /**
@@ -55,6 +56,9 @@ import { memberBylineSchema } from '../profile/founder-profile.js';
  *   community_invite         a community invited you (always delivered)
  *   community_announcement   a community you are in pinned an announcement for everyone
  *   community_suggestion_decided  your community suggestion was approved or declined (always delivered)
+ *   plan_ending              your plan ends in 7 days, then in 1 day (0.12.0, always delivered)
+ *   plan_ended               your plan ended; `paused` products were paused (0.12.0, always delivered)
+ *   payment_refunded         staff refunded one of your payments (0.12.0, always delivered)
  *
  * The three 0.8.0 kinds merge per target like the others. A reaction counts
  * once: changing it to another type is not a new event, and taking it back
@@ -77,6 +81,9 @@ export const NOTIFICATION_KIND_VALUES = [
     'community_invite',
     'community_announcement',
     'community_suggestion_decided',
+    'plan_ending',
+    'plan_ended',
+    'payment_refunded',
 ];
 export const notificationKindSchema = z.enum(NOTIFICATION_KIND_VALUES);
 /** The switches a member has, each covering one or more kinds. */
@@ -111,6 +118,9 @@ export const NOTIFICATION_PREFERENCE_OF = {
     community_invite: null,
     community_announcement: 'communities',
     community_suggestion_decided: null,
+    plan_ending: null,
+    plan_ended: null,
+    payment_refunded: null,
 };
 /**
  * One row of the bell. Which of the optional targets are present depends on
@@ -132,6 +142,9 @@ export const NOTIFICATION_PREFERENCE_OF = {
  *   community_invite         community
  *   community_announcement   community, content (the pinned post or poll)
  *   community_suggestion_decided  suggestion, community (once approved)
+ *   plan_ending              plan (the tier, and when it ends)
+ *   plan_ended               plan (the tier that ended), paused (how many products)
+ *   payment_refunded         payment
  *
  * Any row about something inside a community also carries `community`
  * (0.9.0), whatever its kind. When the recipient leaves the community, is
@@ -176,6 +189,12 @@ export const notificationSchema = z.object({
         reason: z.string().optional(),
     })
         .optional(),
+    /** For `plan_ending` and `plan_ended` (0.12.0): which tier, and when it ends or ended. */
+    plan: z.object({ tier: planTierSchema, endsAt: z.iso.datetime() }).optional(),
+    /** For `plan_ended` (0.12.0): products paused because the plan's live places went. */
+    paused: z.number().int().nonnegative().optional(),
+    /** For `payment_refunded` (0.12.0): which purchase, by its title. */
+    payment: z.object({ id: objectIdSchema, title: z.string() }).optional(),
     /** For `product_invite`: the role offered. */
     role: productInvitableRoleSchema.optional(),
     /** For the reaction kinds: the latest reaction, as it is now (0.8.0). */