feat: polish envelopes (#2090)

## Description

The rest of the owl

packages/ee/server-only/limits/client.ts

@@ -1,6 +1,6 @@
 import { NEXT_PUBLIC_WEBAPP_URL } from '@documenso/lib/constants/app';
 
-import { FREE_PLAN_LIMITS } from './constants';
+import { DEFAULT_MINIMUM_ENVELOPE_ITEM_COUNT, FREE_PLAN_LIMITS } from './constants';
 import type { TLimitsResponseSchema } from './schema';
 import { ZLimitsResponseSchema } from './schema';
 
@@ -29,6 +29,7 @@ export const getLimits = async ({ headers, teamId }: GetLimitsOptions) => {
       return {
         quota: FREE_PLAN_LIMITS,
         remaining: FREE_PLAN_LIMITS,
+        maximumEnvelopeItemCount: DEFAULT_MINIMUM_ENVELOPE_ITEM_COUNT,
       } satisfies TLimitsResponseSchema;
     });
 };

packages/ee/server-only/limits/constants.ts

@@ -23,3 +23,8 @@ export const SELFHOSTED_PLAN_LIMITS: TLimitsSchema = {
   recipients: Infinity,
   directTemplates: Infinity,
 };
+
+/**
+ * Used as an initial value for the frontend before values are loaded from the server.
+ */
+export const DEFAULT_MINIMUM_ENVELOPE_ITEM_COUNT = 5;

packages/ee/server-only/limits/provider/client.tsx

@@ -3,7 +3,7 @@ import { createContext, useCallback, useContext, useEffect, useState } from 'rea
 import { isDeepEqual } from 'remeda';
 
 import { getLimits } from '../client';
-import { FREE_PLAN_LIMITS } from '../constants';
+import { DEFAULT_MINIMUM_ENVELOPE_ITEM_COUNT, FREE_PLAN_LIMITS } from '../constants';
 import type { TLimitsResponseSchema } from '../schema';
 
 export type LimitsContextValue = TLimitsResponseSchema & { refreshLimits: () => Promise<void> };
@@ -30,6 +30,7 @@ export const LimitsProvider = ({
   initialValue = {
     quota: FREE_PLAN_LIMITS,
     remaining: FREE_PLAN_LIMITS,
+    maximumEnvelopeItemCount: DEFAULT_MINIMUM_ENVELOPE_ITEM_COUNT,
   },
   teamId,
   children,

packages/ee/server-only/limits/schema.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
 
+import { DEFAULT_MINIMUM_ENVELOPE_ITEM_COUNT } from './constants';
+
 // Not proud of the below but it's a way to deal with Infinity when returning JSON.
 export const ZLimitsSchema = z.object({
   documents: z
@@ -21,6 +23,7 @@ export type TLimitsSchema = z.infer<typeof ZLimitsSchema>;
 export const ZLimitsResponseSchema = z.object({
   quota: ZLimitsSchema,
   remaining: ZLimitsSchema,
+  maximumEnvelopeItemCount: z.number().optional().default(DEFAULT_MINIMUM_ENVELOPE_ITEM_COUNT),
 });
 
 export type TLimitsResponseSchema = z.infer<typeof ZLimitsResponseSchema>;

packages/ee/server-only/limits/server.ts

@@ -23,13 +23,6 @@ export const getServerLimits = async ({
   userId,
   teamId,
 }: GetServerLimitsOptions): Promise<TLimitsResponseSchema> => {
-  if (!IS_BILLING_ENABLED()) {
-    return {
-      quota: SELFHOSTED_PLAN_LIMITS,
-      remaining: SELFHOSTED_PLAN_LIMITS,
-    };
-  }
-
   const organisation = await prisma.organisation.findFirst({
     where: {
       teams: {
@@ -57,12 +50,22 @@ export const getServerLimits = async ({
   const remaining = structuredClone(FREE_PLAN_LIMITS);
 
   const subscription = organisation.subscription;
+  const maximumEnvelopeItemCount = organisation.organisationClaim.envelopeItemCount;
+
+  if (!IS_BILLING_ENABLED()) {
+    return {
+      quota: SELFHOSTED_PLAN_LIMITS,
+      remaining: SELFHOSTED_PLAN_LIMITS,
+      maximumEnvelopeItemCount,
+    };
+  }
 
   // Bypass all limits even if plan expired for ENTERPRISE.
   if (organisation.organisationClaimId === INTERNAL_CLAIM_ID.ENTERPRISE) {
     return {
       quota: PAID_PLAN_LIMITS,
       remaining: PAID_PLAN_LIMITS,
+      maximumEnvelopeItemCount,
     };
   }
 
@@ -71,6 +74,7 @@ export const getServerLimits = async ({
     return {
       quota: INACTIVE_PLAN_LIMITS,
       remaining: INACTIVE_PLAN_LIMITS,
+      maximumEnvelopeItemCount,
     };
   }
 
@@ -80,6 +84,7 @@ export const getServerLimits = async ({
     return {
       quota: PAID_PLAN_LIMITS,
       remaining: PAID_PLAN_LIMITS,
+      maximumEnvelopeItemCount,
     };
   }
 
@@ -117,5 +122,6 @@ export const getServerLimits = async ({
   return {
     quota,
     remaining,
+    maximumEnvelopeItemCount,
   };
 };