founder-schema 0.10.0 → 0.12.0

package/dist/domains/members/members.d.ts

@@ -56,9 +56,9 @@ export declare const memberDirectoryQuerySchema: z.ZodObject<{
         suspended: "suspended";
     }>>, unknown>;
     role: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
+        moderator: "moderator";
         superadmin: "superadmin";
         manager: "manager";
-        moderator: "moderator";
         support_agent: "support_agent";
     }>>, unknown>;
 }, z.core.$strip>;
@@ -76,9 +76,9 @@ export declare const memberSummarySchema: z.ZodObject<{
         suspended: "suspended";
     }>;
     roles: z.ZodArray<z.ZodEnum<{
+        moderator: "moderator";
         superadmin: "superadmin";
         manager: "manager";
-        moderator: "moderator";
         support_agent: "support_agent";
     }>>;
     joinedAt: z.ZodISODateTime;
@@ -97,9 +97,9 @@ export declare const memberDirectoryPageSchema: z.ZodObject<{
             suspended: "suspended";
         }>;
         roles: z.ZodArray<z.ZodEnum<{
+            moderator: "moderator";
             superadmin: "superadmin";
             manager: "manager";
-            moderator: "moderator";
             support_agent: "support_agent";
         }>>;
         joinedAt: z.ZodISODateTime;
@@ -130,9 +130,9 @@ export declare const memberDetailSchema: z.ZodObject<{
         suspended: "suspended";
     }>;
     roles: z.ZodArray<z.ZodEnum<{
+        moderator: "moderator";
         superadmin: "superadmin";
         manager: "manager";
-        moderator: "moderator";
         support_agent: "support_agent";
     }>>;
     joinedAt: z.ZodISODateTime;
@@ -157,16 +157,41 @@ export declare const memberDetailSchema: z.ZodObject<{
     viewer: z.ZodObject<{
         canSuspend: z.ZodBoolean;
         grantableRoles: z.ZodArray<z.ZodEnum<{
+            moderator: "moderator";
             superadmin: "superadmin";
             manager: "manager";
-            moderator: "moderator";
             support_agent: "support_agent";
         }>>;
         canResetMpin: z.ZodBoolean;
         grantableCapabilities: z.ZodArray<z.ZodEnum<{
             create_communities: "create_communities";
         }>>;
+        canGrantMembership: z.ZodBoolean;
+        canRevokeMembership: z.ZodBoolean;
+        canReadPayments: z.ZodBoolean;
+        canReadMembership: z.ZodBoolean;
     }, z.core.$strip>;
+    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>>;
+    plan: z.ZodNullable<z.ZodObject<{
+        tier: z.ZodEnum<{
+            premium: "premium";
+            business: "business";
+        }>;
+        endsAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
     capabilities: z.ZodArray<z.ZodEnum<{
         create_communities: "create_communities";
     }>>;

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

@@ -1 +1 @@
-{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/domains/members/members.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,kCAAmC,CAAC;AACrE,eAAO,MAAM,kBAAkB;;;EAA+B,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,sCAAsC;AACtC,eAAO,MAAM,kBAAkB;;iBAAyC,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;iBAKrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF,gCAAgC;AAChC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAa9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBAAuC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB;;;;;;;iBAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,qCAAqC;AACrC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4B7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,sFAAsF;AACtF,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/domains/members/members.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,kCAAmC,CAAC;AACrE,eAAO,MAAM,kBAAkB;;;EAA+B,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,sCAAsC;AACtC,eAAO,MAAM,kBAAkB;;iBAAyC,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;iBAKrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF,gCAAgC;AAChC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAa9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBAAuC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB;;;;;;;iBAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,qCAAqC;AACrC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiD7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,sFAAsF;AACtF,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/domains/members/members.js

@@ -32,9 +32,11 @@
 import { z } from 'zod';
 import { capabilitySchema } from '../../access/capabilities.js';
 import { platformRoleSchema } from '../../access/roles.js';
+import { standingSchema } from '../../access/standing.js';
 import { emptyStringToUndefined, objectIdSchema, optionalTrimmedString, paginationQuerySchema, usernameSchema, } from '../../core/common.js';
 import { MEMBER_SEARCH_MAX, SUSPENSION_REASON_MAX, SUSPENSION_REASON_MIN, } from '../../core/limits.js';
 import { paginatedSchema } from '../../core/responses.js';
+import { membershipSchema, planTierSchema } from '../membership/membership.js';
 /** What staff can see an account's state as. A deleted account is not listed. */
 export const MEMBER_STATUS_VALUES = ['active', 'suspended'];
 export const memberStatusSchema = z.enum(MEMBER_STATUS_VALUES);
@@ -98,7 +100,28 @@ export const memberDetailSchema = memberSummarySchema.extend({
         canResetMpin: z.boolean(),
         /** Capabilities the asker may grant or revoke on this member (never their own) (0.9.0). */
         grantableCapabilities: z.array(capabilitySchema),
+        /** May give them a membership (0.12.0): they hold none, and the asker may, and it is not themselves. */
+        canGrantMembership: z.boolean(),
+        /**
+         * May take their membership away (0.12.0): founding, coupon or granted
+         * (a paid one is refunded instead), and the asker may, and not their own.
+         */
+        canRevokeMembership: z.boolean(),
+        /** May list their payments (0.12.0): support, managers, superadmin. */
+        canReadPayments: z.boolean(),
+        /**
+         * May see their membership and plan (0.12.0): support, managers,
+         * superadmin. Moderators may not: `membership` and `plan` come null to
+         * them, which is not "not a member".
+         */
+        canReadMembership: z.boolean(),
     }),
+    /** Whether they take part (0.12.0). Staff always do. */
+    standing: standingSchema,
+    /** Their membership (0.12.0), or null (a viewer, staff holding none, or an asker who may not see it). */
+    membership: membershipSchema.nullable(),
+    /** The plan in force now and when all their plan time ends (0.12.0), or null (none, or not the asker's to see). */
+    plan: z.object({ tier: planTierSchema, endsAt: z.iso.datetime() }).nullable(),
     /** The capabilities they hold (0.9.0), e.g. `create_communities`. */
     capabilities: z.array(capabilitySchema),
     /** Whether they have set an MPIN. Only meaningful for staff. */

package/dist/domains/members/members.js.map

@@ -1 +1 @@
-{"version":3,"file":"members.js","sourceRoot":"","sources":["../../../src/domains/members/members.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema: the staff member directory\n *\n *   GET    /api/v1/members                        ?q&status&role&limit&cursor\n *   GET    /api/v1/members/:memberId              one member, as staff see them\n *   POST   /api/v1/members/:memberId/suspension   { reason }  suspend\n *   DELETE /api/v1/members/:memberId/suspension               lift it\n *\n * Every staff role has a Members tab: a moderator looks up who wrote\n * something, a support agent finds the person who wrote in, a manager decides\n * on a suspension. What each sees is the server's call, per field: a\n * moderator gets no email (`email: null`), because finding a member's\n * address is support's job, not moderation's.\n *\n * A SUSPENDED member cannot use the product at all, on any device, from the\n * next request on (every call answers `ACCOUNT_SUSPENDED`); their posts stay\n * up unless moderated separately, and a staff role they were acting in is\n * switched off. Lifting it restores everything else.\n *\n * SEARCH (`q`) finds people by the start of their name or handle among listed\n * founders, or by their exact email among everyone (only for a role that may\n * see emails: a moderator's email search finds nothing). It returns up to\n * `limit` matches in one page (type more to narrow), not a pageable list. Who may suspend whom is the access policy's: never\n * yourself, never a superadmin, and a manager never a fellow manager.\n *\n * Each detail carries a `viewer` block of what the asking staff member may do\n * to THIS member, worked out by the server, so the screen shows only the\n * buttons that will work.\n *\n * @module founder-schema/domains/members\n */\n\nimport { z } from 'zod';\nimport { capabilitySchema } from '../../access/capabilities.js';\nimport { platformRoleSchema } from '../../access/roles.js';\nimport {\n  emptyStringToUndefined,\n  objectIdSchema,\n  optionalTrimmedString,\n  paginationQuerySchema,\n  usernameSchema,\n} from '../../core/common.js';\nimport {\n  MEMBER_SEARCH_MAX,\n  SUSPENSION_REASON_MAX,\n  SUSPENSION_REASON_MIN,\n} from '../../core/limits.js';\nimport { paginatedSchema } from '../../core/responses.js';\n\n/** What staff can see an account's state as. A deleted account is not listed. */\nexport const MEMBER_STATUS_VALUES = ['active', 'suspended'] as const;\nexport const memberStatusSchema = z.enum(MEMBER_STATUS_VALUES);\nexport type MemberStatus = z.infer<typeof memberStatusSchema>;\n\n/** `:memberId` in the paths above. */\nexport const memberParamsSchema = z.object({ memberId: objectIdSchema });\nexport type MemberParams = z.infer<typeof memberParamsSchema>;\n\n/**\n * The directory's query. `q` is a name or handle prefix, or a whole email\n * address (anything with an `@` is matched as an email, exactly). An emptied\n * box is \"no search\", not an error.\n */\nexport const memberDirectoryQuerySchema = paginationQuerySchema.extend({\n  q: optionalTrimmedString(MEMBER_SEARCH_MAX),\n  status: z.preprocess(emptyStringToUndefined, memberStatusSchema.optional()),\n  /** Only people holding this staff role. */\n  role: z.preprocess(emptyStringToUndefined, platformRoleSchema.optional()),\n});\nexport type MemberDirectoryQuery = z.infer<typeof memberDirectoryQuerySchema>;\nexport type MemberDirectoryQueryInput = z.input<typeof memberDirectoryQuerySchema>;\n\n/** One row of the directory. */\nexport const memberSummarySchema = z.object({\n  id: objectIdSchema,\n  displayName: z.string(),\n  /** Null when they have no founder profile (never finished onboarding). */\n  username: usernameSchema.nullable(),\n  avatarUrl: z.url().nullable(),\n  /** Null when the asking role may not see it. */\n  email: z.string().nullable(),\n  status: memberStatusSchema,\n  /** Staff roles held, highest first. Empty for an ordinary member. */\n  roles: z.array(platformRoleSchema),\n  joinedAt: z.iso.datetime(),\n  lastActiveAt: z.iso.datetime().nullable(),\n});\nexport type MemberSummary = z.infer<typeof memberSummarySchema>;\n\nexport const memberDirectoryPageSchema = paginatedSchema(memberSummarySchema);\nexport type MemberDirectoryPage = z.infer<typeof memberDirectoryPageSchema>;\n\n/** A suspension in force. */\nexport const suspensionSchema = z.object({\n  since: z.iso.datetime(),\n  reason: z.string(),\n  /** Who suspended them, by name at the time. */\n  by: z.object({ id: objectIdSchema, displayName: z.string() }).nullable(),\n});\nexport type Suspension = z.infer<typeof suspensionSchema>;\n\n/** One member, as staff see them. */\nexport const memberDetailSchema = memberSummarySchema.extend({\n  headline: z.string().nullable(),\n  /** Their city, as declared on their profile. */\n  city: z.string().nullable(),\n  counts: z.object({\n    posts: z.number().int().min(0),\n    polls: z.number().int().min(0),\n    comments: z.number().int().min(0),\n    /** Reports filed about their posts, polls and comments that are still up. */\n    reportsAgainst: z.number().int().min(0),\n    /** Tickets they have raised. */\n    tickets: z.number().int().min(0),\n  }),\n  suspension: suspensionSchema.nullable(),\n  /** What the asking staff member may do to this member. */\n  viewer: z.object({\n    canSuspend: z.boolean(),\n    /** Roles the asker may grant or revoke on this member (never their own). */\n    grantableRoles: z.array(platformRoleSchema),\n    /** May clear this member's forgotten MPIN (superadmin, someone else). */\n    canResetMpin: z.boolean(),\n    /** Capabilities the asker may grant or revoke on this member (never their own) (0.9.0). */\n    grantableCapabilities: z.array(capabilitySchema),\n  }),\n  /** The capabilities they hold (0.9.0), e.g. `create_communities`. */\n  capabilities: z.array(capabilitySchema),\n  /** Whether they have set an MPIN. Only meaningful for staff. */\n  mpinSet: z.boolean(),\n});\nexport type MemberDetail = z.infer<typeof memberDetailSchema>;\n\n/** `POST /members/:memberId/suspension`. The reason is on record in the audit log. */\nexport const suspendMemberBodySchema = z.object({\n  reason: z.string().trim().min(SUSPENSION_REASON_MIN).max(SUSPENSION_REASON_MAX),\n});\nexport type SuspendMemberBody = z.infer<typeof suspendMemberBodySchema>;\n"]}
+{"version":3,"file":"members.js","sourceRoot":"","sources":["../../../src/domains/members/members.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * founder-schema: the staff member directory\n *\n *   GET    /api/v1/members                        ?q&status&role&limit&cursor\n *   GET    /api/v1/members/:memberId              one member, as staff see them\n *   POST   /api/v1/members/:memberId/suspension   { reason }  suspend\n *   DELETE /api/v1/members/:memberId/suspension               lift it\n *\n * Every staff role has a Members tab: a moderator looks up who wrote\n * something, a support agent finds the person who wrote in, a manager decides\n * on a suspension. What each sees is the server's call, per field: a\n * moderator gets no email (`email: null`), because finding a member's\n * address is support's job, not moderation's.\n *\n * A SUSPENDED member cannot use the product at all, on any device, from the\n * next request on (every call answers `ACCOUNT_SUSPENDED`); their posts stay\n * up unless moderated separately, and a staff role they were acting in is\n * switched off. Lifting it restores everything else.\n *\n * SEARCH (`q`) finds people by the start of their name or handle among listed\n * founders, or by their exact email among everyone (only for a role that may\n * see emails: a moderator's email search finds nothing). It returns up to\n * `limit` matches in one page (type more to narrow), not a pageable list. Who may suspend whom is the access policy's: never\n * yourself, never a superadmin, and a manager never a fellow manager.\n *\n * Each detail carries a `viewer` block of what the asking staff member may do\n * to THIS member, worked out by the server, so the screen shows only the\n * buttons that will work.\n *\n * @module founder-schema/domains/members\n */\n\nimport { z } from 'zod';\nimport { capabilitySchema } from '../../access/capabilities.js';\nimport { platformRoleSchema } from '../../access/roles.js';\nimport { standingSchema } from '../../access/standing.js';\nimport {\n  emptyStringToUndefined,\n  objectIdSchema,\n  optionalTrimmedString,\n  paginationQuerySchema,\n  usernameSchema,\n} from '../../core/common.js';\nimport {\n  MEMBER_SEARCH_MAX,\n  SUSPENSION_REASON_MAX,\n  SUSPENSION_REASON_MIN,\n} from '../../core/limits.js';\nimport { paginatedSchema } from '../../core/responses.js';\nimport { membershipSchema, planTierSchema } from '../membership/membership.js';\n\n/** What staff can see an account's state as. A deleted account is not listed. */\nexport const MEMBER_STATUS_VALUES = ['active', 'suspended'] as const;\nexport const memberStatusSchema = z.enum(MEMBER_STATUS_VALUES);\nexport type MemberStatus = z.infer<typeof memberStatusSchema>;\n\n/** `:memberId` in the paths above. */\nexport const memberParamsSchema = z.object({ memberId: objectIdSchema });\nexport type MemberParams = z.infer<typeof memberParamsSchema>;\n\n/**\n * The directory's query. `q` is a name or handle prefix, or a whole email\n * address (anything with an `@` is matched as an email, exactly). An emptied\n * box is \"no search\", not an error.\n */\nexport const memberDirectoryQuerySchema = paginationQuerySchema.extend({\n  q: optionalTrimmedString(MEMBER_SEARCH_MAX),\n  status: z.preprocess(emptyStringToUndefined, memberStatusSchema.optional()),\n  /** Only people holding this staff role. */\n  role: z.preprocess(emptyStringToUndefined, platformRoleSchema.optional()),\n});\nexport type MemberDirectoryQuery = z.infer<typeof memberDirectoryQuerySchema>;\nexport type MemberDirectoryQueryInput = z.input<typeof memberDirectoryQuerySchema>;\n\n/** One row of the directory. */\nexport const memberSummarySchema = z.object({\n  id: objectIdSchema,\n  displayName: z.string(),\n  /** Null when they have no founder profile (never finished onboarding). */\n  username: usernameSchema.nullable(),\n  avatarUrl: z.url().nullable(),\n  /** Null when the asking role may not see it. */\n  email: z.string().nullable(),\n  status: memberStatusSchema,\n  /** Staff roles held, highest first. Empty for an ordinary member. */\n  roles: z.array(platformRoleSchema),\n  joinedAt: z.iso.datetime(),\n  lastActiveAt: z.iso.datetime().nullable(),\n});\nexport type MemberSummary = z.infer<typeof memberSummarySchema>;\n\nexport const memberDirectoryPageSchema = paginatedSchema(memberSummarySchema);\nexport type MemberDirectoryPage = z.infer<typeof memberDirectoryPageSchema>;\n\n/** A suspension in force. */\nexport const suspensionSchema = z.object({\n  since: z.iso.datetime(),\n  reason: z.string(),\n  /** Who suspended them, by name at the time. */\n  by: z.object({ id: objectIdSchema, displayName: z.string() }).nullable(),\n});\nexport type Suspension = z.infer<typeof suspensionSchema>;\n\n/** One member, as staff see them. */\nexport const memberDetailSchema = memberSummarySchema.extend({\n  headline: z.string().nullable(),\n  /** Their city, as declared on their profile. */\n  city: z.string().nullable(),\n  counts: z.object({\n    posts: z.number().int().min(0),\n    polls: z.number().int().min(0),\n    comments: z.number().int().min(0),\n    /** Reports filed about their posts, polls and comments that are still up. */\n    reportsAgainst: z.number().int().min(0),\n    /** Tickets they have raised. */\n    tickets: z.number().int().min(0),\n  }),\n  suspension: suspensionSchema.nullable(),\n  /** What the asking staff member may do to this member. */\n  viewer: z.object({\n    canSuspend: z.boolean(),\n    /** Roles the asker may grant or revoke on this member (never their own). */\n    grantableRoles: z.array(platformRoleSchema),\n    /** May clear this member's forgotten MPIN (superadmin, someone else). */\n    canResetMpin: z.boolean(),\n    /** Capabilities the asker may grant or revoke on this member (never their own) (0.9.0). */\n    grantableCapabilities: z.array(capabilitySchema),\n    /** May give them a membership (0.12.0): they hold none, and the asker may, and it is not themselves. */\n    canGrantMembership: z.boolean(),\n    /**\n     * May take their membership away (0.12.0): founding, coupon or granted\n     * (a paid one is refunded instead), and the asker may, and not their own.\n     */\n    canRevokeMembership: z.boolean(),\n    /** May list their payments (0.12.0): support, managers, superadmin. */\n    canReadPayments: z.boolean(),\n    /**\n     * May see their membership and plan (0.12.0): support, managers,\n     * superadmin. Moderators may not: `membership` and `plan` come null to\n     * them, which is not \"not a member\".\n     */\n    canReadMembership: z.boolean(),\n  }),\n  /** Whether they take part (0.12.0). Staff always do. */\n  standing: standingSchema,\n  /** Their membership (0.12.0), or null (a viewer, staff holding none, or an asker who may not see it). */\n  membership: membershipSchema.nullable(),\n  /** The plan in force now and when all their plan time ends (0.12.0), or null (none, or not the asker's to see). */\n  plan: z.object({ tier: planTierSchema, endsAt: z.iso.datetime() }).nullable(),\n  /** The capabilities they hold (0.9.0), e.g. `create_communities`. */\n  capabilities: z.array(capabilitySchema),\n  /** Whether they have set an MPIN. Only meaningful for staff. */\n  mpinSet: z.boolean(),\n});\nexport type MemberDetail = z.infer<typeof memberDetailSchema>;\n\n/** `POST /members/:memberId/suspension`. The reason is on record in the audit log. */\nexport const suspendMemberBodySchema = z.object({\n  reason: z.string().trim().min(SUSPENSION_REASON_MIN).max(SUSPENSION_REASON_MAX),\n});\nexport type SuspendMemberBody = z.infer<typeof suspendMemberBodySchema>;\n"]}

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

@@ -0,0 +1,239 @@
+/**
+ * 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;
+    }, 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2B7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/domains/membership/membership.js

@@ -0,0 +1,153 @@
+/**
+ * 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(),
+    }),
+    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  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"]}