@middlewr/contracts 0.0.13 → 0.0.15

package/src/analytics.schema.ts

@@ -1,5 +1,35 @@
 import { z } from 'zod';
 
+export const AnalyticsIntervalSchema = z.enum(['hour', 'day', 'week', 'month']);
+
+export const AnalyticsQuerySchema = z.object({
+    start_at: z.coerce.date(),
+    end_at: z.coerce.date(),
+    interval: AnalyticsIntervalSchema,
+});
+
+export const TimeSeriesPointSchema = z.object({
+    date: z.string(),
+    clicks: z.number().int(),
+    unique_visitors: z.number().int(),
+});
+
+export const CountByFieldSchema = z.object({
+    name: z.string(),
+    count: z.number().int(),
+});
+
+export const AnalyticsOutputSchema = z.object({
+    total_clicks: z.number().int(),
+    total_unique_visitors: z.number().int(),
+    timeseries: z.array(TimeSeriesPointSchema),
+    referrers: z.array(CountByFieldSchema),
+    devices: z.array(CountByFieldSchema),
+    countries: z.array(CountByFieldSchema),
+    browsers: z.array(CountByFieldSchema),
+    os: z.array(CountByFieldSchema),
+});
+
 export const LinkAnalyticsQuerySchema = z.object({
     link_id: z.string().uuid(),
     from: z.coerce.date(),

package/src/index.ts

@@ -2,6 +2,7 @@ import type { ContractRouterClient } from '@orpc/contract';
 import { oc } from '@orpc/contract';
 import { z } from 'zod';
 
+import { AnalyticsOutputSchema, AnalyticsQuerySchema } from './analytics.schema';
 import { ApiKeySchema, CreateApiKeyInputSchema, CreateApiKeyResponseSchema } from './api-keys.schema';
 import { BillingStatusSchema, CheckoutSessionSchema, CreateCheckoutInputSchema, CustomerPortalSchema } from './billing.schema';
 import {
@@ -42,6 +43,19 @@ export * from './tags.schema';
 export * from './users.schema';
 export * from './workspaces.schema';
 
+// Analytics contract
+export const analyticsContract = {
+    workspace: oc
+        .route({ method: 'GET', path: '/api/workspaces/{workspace_id}/analytics' })
+        .input(WorkspaceIdParamSchema.merge(AnalyticsQuerySchema))
+        .output(AnalyticsOutputSchema),
+
+    link: oc
+        .route({ method: 'GET', path: '/api/workspaces/{workspace_id}/links/{link_id}/analytics' })
+        .input(LinkIdParamSchema.merge(AnalyticsQuerySchema))
+        .output(AnalyticsOutputSchema),
+};
+
 // Users contract
 export const usersContract = {
     me: oc.route({ method: 'GET', path: '/api/users/me' }).output(z.object({ user: UserSchema })),
@@ -229,6 +243,7 @@ export const billingContract = {
 
 // Full contract
 export const contract = {
+    analytics: analyticsContract,
     users: usersContract,
     apiKeys: apiKeysContract,
     workspaces: workspacesContract,

package/src/workspaces.schema.ts

@@ -22,6 +22,7 @@ export const CreateWorkspaceInputSchema = z.object({
 
 export const UpdateWorkspaceInputSchema = z.object({
     name: z.string().min(1).max(100).optional(),
+    billing_email: z.string().email().nullish(),
 });
 
 export const TransferOwnershipInputSchema = z.object({