@teardown/schemas 0.1.0

package/dist/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./primitives";
+export * from "./responses";
+export * from "./type-checks";

package/dist/common/index.js

@@ -0,0 +1,3 @@
+export * from "./primitives";
+export * from "./responses";
+export * from "./type-checks";

package/dist/common/primitives.d.ts

@@ -0,0 +1,11 @@
+import { type Static } from "elysia";
+export declare const UUIDSchema: import("@sinclair/typebox").TString;
+export declare const SlugSchema: import("@sinclair/typebox").TString;
+export declare const URLSchema: import("@sinclair/typebox").TString;
+export declare const TimestampSchema: import("@sinclair/typebox").TString;
+export type UUID = Static<typeof UUIDSchema>;
+export type Slug = Static<typeof SlugSchema>;
+export type URL = Static<typeof URLSchema>;
+export type Timestamp = Static<typeof TimestampSchema>;
+export declare const EmailSchema: import("@sinclair/typebox").TTransform<import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TLiteral<"">, import("@sinclair/typebox").TUndefined]>>, string | undefined>;
+export type Email = Static<typeof EmailSchema>;

package/dist/common/primitives.js

@@ -0,0 +1,9 @@
+import { Type } from "@sinclair/typebox";
+import { t } from "elysia";
+export const UUIDSchema = t.String({ format: "uuid", error: "Invalid UUID" });
+export const SlugSchema = t.String({ pattern: "^[a-z0-9]+(?:-[a-z0-9]+)*$", error: "Invalid slug" });
+export const URLSchema = t.String({ format: "uri", error: "Invalid URL" });
+export const TimestampSchema = t.String({ format: "date-time", error: "Invalid timestamp" });
+export const EmailSchema = Type.Transform(Type.Optional(Type.Union([Type.String({ format: "email", error: "Invalid email address" }), Type.Literal(""), t.Undefined()])))
+    .Decode((value) => (value === "" ? undefined : value))
+    .Encode((value) => value ?? "");

package/dist/common/responses.d.ts

@@ -0,0 +1,27 @@
+import { type Static, type TSchema } from "elysia";
+export declare const SuccessResponseSchema: <T extends TSchema>(dataSchema: T) => import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: T;
+}>;
+export declare const ErrorResponseSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<false>;
+    error: import("@sinclair/typebox").TObject<{
+        message: import("@sinclair/typebox").TString;
+        code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+}>;
+export type SuccessResponse<T> = {
+    success: true;
+    data: T;
+};
+export type ErrorResponse = Static<typeof ErrorResponseSchema>;
+export declare const RequestResponseSchema: <Success extends TSchema>(successSchema: Success) => import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: Success;
+}>, import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<false>;
+    error: import("@sinclair/typebox").TObject<{
+        message: import("@sinclair/typebox").TString;
+        code: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+}>]>;

package/dist/common/responses.js

@@ -0,0 +1,13 @@
+import { t } from "elysia";
+export const SuccessResponseSchema = (dataSchema) => t.Object({
+    success: t.Literal(true),
+    data: dataSchema,
+});
+export const ErrorResponseSchema = t.Object({
+    success: t.Literal(false),
+    error: t.Object({
+        message: t.String(),
+        code: t.Optional(t.String()),
+    }),
+});
+export const RequestResponseSchema = (successSchema) => t.Union([SuccessResponseSchema(successSchema), ErrorResponseSchema]);

package/dist/common/type-checks.d.ts

@@ -0,0 +1,58 @@
+import type { Insert, Tables, Update } from "@teardown/types";
+/**
+ * Forces TypeScript to error if T is not `true`.
+ * Wrap assertion types with this to ensure compile-time validation.
+ *
+ * @example
+ * ```ts
+ * type _Check = AssertTrue<AssertSchemaCompatibleWithRow<Project, "projects">>;
+ * ```
+ */
+export type AssertTrue<T extends true> = T;
+/**
+ * Type-level assertion that ensures SchemaType is compatible with DbType.
+ * This will cause a TypeScript error if SchemaType cannot be assigned to DbType.
+ *
+ * @example
+ * ```ts
+ * type _Check = AssertTrue<AssertCompatible<Project, Tables<"projects">["Row"]>>;
+ * ```
+ */
+export type AssertCompatible<SchemaType, DbType> = SchemaType extends DbType ? DbType extends SchemaType ? true : never : never;
+/**
+ * Type-level assertion that ensures SchemaType can be assigned to DbType.
+ * This is less strict than AssertCompatible - it only checks one-way assignment.
+ *
+ * @example
+ * ```ts
+ * type _Check = AssertAssignable<CreateProject, Insert<"projects">>;
+ * ```
+ */
+export type AssertAssignable<SchemaType, DbType> = SchemaType extends DbType ? true : never;
+/**
+ * Helper to check if a schema type is compatible with a database Row type
+ *
+ * @example
+ * ```ts
+ * export type _CheckProjectRow = AssertSchemaCompatibleWithRow<Project, "projects">;
+ * ```
+ */
+export type AssertSchemaCompatibleWithRow<SchemaType, TableName extends keyof Tables> = AssertCompatible<SchemaType, Tables[TableName]["Row"]>;
+/**
+ * Helper to check if a create schema type is compatible with a database Insert type
+ *
+ * @example
+ * ```ts
+ * type _CheckCreateProject = AssertSchemaCompatibleWithInsert<CreateProject, "projects">;
+ * ```
+ */
+export type AssertSchemaCompatibleWithInsert<SchemaType, TableName extends keyof Tables> = AssertAssignable<SchemaType, Insert<TableName>>;
+/**
+ * Helper to check if an update schema type is compatible with a database Update type
+ *
+ * @example
+ * ```ts
+ * type _CheckUpdateProject = AssertSchemaCompatibleWithUpdate<UpdateProject, "projects">;
+ * ```
+ */
+export type AssertSchemaCompatibleWithUpdate<SchemaType, TableName extends keyof Tables> = AssertAssignable<SchemaType, Update<TableName>>;

package/dist/common/type-checks.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./common";
+export * from "./modules/analytics";
+export * from "./modules/builds";
+export * from "./modules/devices";
+export * from "./modules/environment";
+export * from "./modules/events";
+export * from "./modules/identify";
+export * from "./modules/me";
+export * from "./modules/orgs";
+export * from "./modules/personas";
+export * from "./modules/projects";
+export * from "./modules/sessions";
+export * from "./modules/versions";

package/dist/index.js

@@ -0,0 +1,14 @@
+// Module schemas
+export * from "./common";
+export * from "./modules/analytics";
+export * from "./modules/builds";
+export * from "./modules/devices";
+export * from "./modules/environment";
+export * from "./modules/events";
+export * from "./modules/identify";
+export * from "./modules/me";
+export * from "./modules/orgs";
+export * from "./modules/personas";
+export * from "./modules/projects";
+export * from "./modules/sessions";
+export * from "./modules/versions";

package/dist/modules/analytics/index.d.ts

@@ -0,0 +1 @@
+export * from "./schemas";

package/dist/modules/analytics/index.js

@@ -0,0 +1 @@
+export * from "./schemas";

package/dist/modules/analytics/schemas.d.ts

@@ -0,0 +1,239 @@
+import { type Static } from "elysia";
+/**
+ * Version adoption schema
+ */
+export declare const VersionAdoptionPointSchema: import("@sinclair/typebox").TObject<{
+    date: import("@sinclair/typebox").TString;
+    versions: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber>;
+}>;
+export type VersionAdoptionPoint = Static<typeof VersionAdoptionPointSchema>;
+export declare const VersionAdoptionResponseSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        date: import("@sinclair/typebox").TString;
+        versions: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber>;
+    }>>;
+}>;
+export type VersionAdoptionResponse = Static<typeof VersionAdoptionResponseSchema>;
+/**
+ * Active sessions trend schema
+ */
+export declare const ActiveSessionsPointSchema: import("@sinclair/typebox").TObject<{
+    date: import("@sinclair/typebox").TString;
+    count: import("@sinclair/typebox").TInteger;
+}>;
+export type ActiveSessionsPoint = Static<typeof ActiveSessionsPointSchema>;
+export declare const ActiveSessionsTrendResponseSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        date: import("@sinclair/typebox").TString;
+        count: import("@sinclair/typebox").TInteger;
+    }>>;
+}>;
+export type ActiveSessionsTrendResponse = Static<typeof ActiveSessionsTrendResponseSchema>;
+/**
+ * Active users schema (with platform breakdown)
+ */
+export declare const ActiveUsersSchema: import("@sinclair/typebox").TObject<{
+    total: import("@sinclair/typebox").TInteger;
+    ios: import("@sinclair/typebox").TInteger;
+    android: import("@sinclair/typebox").TInteger;
+    trend: import("@sinclair/typebox").TNumber;
+}>;
+export type ActiveUsers = Static<typeof ActiveUsersSchema>;
+export declare const ActiveUsersResponseSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: import("@sinclair/typebox").TObject<{
+        total: import("@sinclair/typebox").TInteger;
+        ios: import("@sinclair/typebox").TInteger;
+        android: import("@sinclair/typebox").TInteger;
+        trend: import("@sinclair/typebox").TNumber;
+    }>;
+}>;
+export type ActiveUsersResponse = Static<typeof ActiveUsersResponseSchema>;
+/**
+ * Active users query params schema
+ */
+export declare const ActiveUsersQuerySchema: import("@sinclair/typebox").TObject<{
+    start_date: import("@sinclair/typebox").TString;
+    end_date: import("@sinclair/typebox").TString;
+}>;
+export type ActiveUsersQuery = Static<typeof ActiveUsersQuerySchema>;
+/**
+ * Build adoption schema (with platform breakdown)
+ */
+export declare const BuildStatsSchema: import("@sinclair/typebox").TObject<{
+    total: import("@sinclair/typebox").TInteger;
+    ios: import("@sinclair/typebox").TInteger;
+    android: import("@sinclair/typebox").TInteger;
+}>;
+export type BuildStats = Static<typeof BuildStatsSchema>;
+export declare const BuildAdoptionPointSchema: import("@sinclair/typebox").TObject<{
+    date: import("@sinclair/typebox").TString;
+    builds: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+        total: import("@sinclair/typebox").TInteger;
+        ios: import("@sinclair/typebox").TInteger;
+        android: import("@sinclair/typebox").TInteger;
+    }>>;
+}>;
+export type BuildAdoptionPoint = Static<typeof BuildAdoptionPointSchema>;
+export declare const BuildAdoptionResponseSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        date: import("@sinclair/typebox").TString;
+        builds: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+            total: import("@sinclair/typebox").TInteger;
+            ios: import("@sinclair/typebox").TInteger;
+            android: import("@sinclair/typebox").TInteger;
+        }>>;
+    }>>;
+}>;
+export type BuildAdoptionResponse = Static<typeof BuildAdoptionResponseSchema>;
+/**
+ * Date range query params schema (shared)
+ */
+export declare const DateRangeQuerySchema: import("@sinclair/typebox").TObject<{
+    start_date: import("@sinclair/typebox").TString;
+    end_date: import("@sinclair/typebox").TString;
+}>;
+export type DateRangeQuery = Static<typeof DateRangeQuerySchema>;
+/**
+ * Active versions/builds query params schema (with optional search)
+ */
+export declare const ActiveVersionsQuerySchema: import("@sinclair/typebox").TObject<{
+    start_date: import("@sinclair/typebox").TString;
+    end_date: import("@sinclair/typebox").TString;
+    search: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type ActiveVersionsQuery = Static<typeof ActiveVersionsQuerySchema>;
+/**
+ * Active versions & builds analytics schema
+ * Aggregated session counts by version and build for a date range
+ */
+export declare const ActiveBuildStatsSchema: import("@sinclair/typebox").TObject<{
+    build_id: import("@sinclair/typebox").TString;
+    build_number: import("@sinclair/typebox").TInteger;
+    platform: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"IOS">, import("@sinclair/typebox").TLiteral<"ANDROID">]>;
+    session_count: import("@sinclair/typebox").TInteger;
+    device_count: import("@sinclair/typebox").TInteger;
+}>;
+export type ActiveBuildStats = Static<typeof ActiveBuildStatsSchema>;
+export declare const ActiveVersionStatsSchema: import("@sinclair/typebox").TObject<{
+    version_id: import("@sinclair/typebox").TString;
+    version_name: import("@sinclair/typebox").TString;
+    session_count: import("@sinclair/typebox").TInteger;
+    device_count: import("@sinclair/typebox").TInteger;
+    ios_count: import("@sinclair/typebox").TInteger;
+    android_count: import("@sinclair/typebox").TInteger;
+    builds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        build_id: import("@sinclair/typebox").TString;
+        build_number: import("@sinclair/typebox").TInteger;
+        platform: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"IOS">, import("@sinclair/typebox").TLiteral<"ANDROID">]>;
+        session_count: import("@sinclair/typebox").TInteger;
+        device_count: import("@sinclair/typebox").TInteger;
+    }>>;
+}>;
+export type ActiveVersionStats = Static<typeof ActiveVersionStatsSchema>;
+export declare const ActiveVersionsBuildsSchema: import("@sinclair/typebox").TObject<{
+    versions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        version_id: import("@sinclair/typebox").TString;
+        version_name: import("@sinclair/typebox").TString;
+        session_count: import("@sinclair/typebox").TInteger;
+        device_count: import("@sinclair/typebox").TInteger;
+        ios_count: import("@sinclair/typebox").TInteger;
+        android_count: import("@sinclair/typebox").TInteger;
+        builds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            build_id: import("@sinclair/typebox").TString;
+            build_number: import("@sinclair/typebox").TInteger;
+            platform: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"IOS">, import("@sinclair/typebox").TLiteral<"ANDROID">]>;
+            session_count: import("@sinclair/typebox").TInteger;
+            device_count: import("@sinclair/typebox").TInteger;
+        }>>;
+    }>>;
+}>;
+export type ActiveVersionsBuilds = Static<typeof ActiveVersionsBuildsSchema>;
+export declare const ActiveVersionsBuildsResponseSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: import("@sinclair/typebox").TObject<{
+        versions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            version_id: import("@sinclair/typebox").TString;
+            version_name: import("@sinclair/typebox").TString;
+            session_count: import("@sinclair/typebox").TInteger;
+            device_count: import("@sinclair/typebox").TInteger;
+            ios_count: import("@sinclair/typebox").TInteger;
+            android_count: import("@sinclair/typebox").TInteger;
+            builds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                build_id: import("@sinclair/typebox").TString;
+                build_number: import("@sinclair/typebox").TInteger;
+                platform: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"IOS">, import("@sinclair/typebox").TLiteral<"ANDROID">]>;
+                session_count: import("@sinclair/typebox").TInteger;
+                device_count: import("@sinclair/typebox").TInteger;
+            }>>;
+        }>>;
+    }>;
+}>;
+export type ActiveVersionsBuildsResponse = Static<typeof ActiveVersionsBuildsResponseSchema>;
+/**
+ * Session with user/device data for build sessions endpoint
+ */
+export declare const SessionDeviceSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    device_name: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    device_brand: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+}>;
+export type SessionDevice = Static<typeof SessionDeviceSchema>;
+export declare const SessionUserSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    user_id: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    email: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    name: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+}>;
+export type SessionUser = Static<typeof SessionUserSchema>;
+export declare const SessionWithUserSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    started_at: import("@sinclair/typebox").TString;
+    os_version: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    device: import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        device_name: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        device_brand: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    }>;
+    user: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        user_id: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        email: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        name: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    }>, import("@sinclair/typebox").TNull]>;
+}>;
+export type SessionWithUser = Static<typeof SessionWithUserSchema>;
+export declare const BuildSessionsQuerySchema: import("@sinclair/typebox").TObject<{
+    start_date: import("@sinclair/typebox").TString;
+    end_date: import("@sinclair/typebox").TString;
+    cursor: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    search: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type BuildSessionsQuery = Static<typeof BuildSessionsQuerySchema>;
+export declare const BuildSessionsResponseSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TLiteral<true>;
+    data: import("@sinclair/typebox").TObject<{
+        sessions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            id: import("@sinclair/typebox").TString;
+            started_at: import("@sinclair/typebox").TString;
+            os_version: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            device: import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TString;
+                device_name: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                device_brand: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            }>;
+            user: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TString;
+                user_id: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                email: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+                name: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+            }>, import("@sinclair/typebox").TNull]>;
+        }>>;
+        next_cursor: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    }>;
+}>;
+export type BuildSessionsResponse = Static<typeof BuildSessionsResponseSchema>;

package/dist/modules/analytics/schemas.js

@@ -0,0 +1,136 @@
+import { t } from "elysia";
+/**
+ * Version adoption schema
+ */
+export const VersionAdoptionPointSchema = t.Object({
+    date: t.String(), // YYYY-MM-DD
+    versions: t.Record(t.String(), t.Number()), // version -> count
+});
+export const VersionAdoptionResponseSchema = t.Object({
+    success: t.Literal(true),
+    data: t.Array(VersionAdoptionPointSchema),
+});
+/**
+ * Active sessions trend schema
+ */
+export const ActiveSessionsPointSchema = t.Object({
+    date: t.String(), // YYYY-MM-DD
+    count: t.Integer({ minimum: 0 }),
+});
+export const ActiveSessionsTrendResponseSchema = t.Object({
+    success: t.Literal(true),
+    data: t.Array(ActiveSessionsPointSchema),
+});
+/**
+ * Active users schema (with platform breakdown)
+ */
+export const ActiveUsersSchema = t.Object({
+    total: t.Integer({ minimum: 0 }),
+    ios: t.Integer({ minimum: 0 }),
+    android: t.Integer({ minimum: 0 }),
+    trend: t.Number(), // percentage change vs previous period
+});
+export const ActiveUsersResponseSchema = t.Object({
+    success: t.Literal(true),
+    data: ActiveUsersSchema,
+});
+/**
+ * Active users query params schema
+ */
+export const ActiveUsersQuerySchema = t.Object({
+    start_date: t.String({ format: "date-time" }),
+    end_date: t.String({ format: "date-time" }),
+});
+/**
+ * Build adoption schema (with platform breakdown)
+ */
+export const BuildStatsSchema = t.Object({
+    total: t.Integer({ minimum: 0 }),
+    ios: t.Integer({ minimum: 0 }),
+    android: t.Integer({ minimum: 0 }),
+});
+export const BuildAdoptionPointSchema = t.Object({
+    date: t.String(), // YYYY-MM-DD
+    builds: t.Record(t.String(), BuildStatsSchema), // build_number -> stats
+});
+export const BuildAdoptionResponseSchema = t.Object({
+    success: t.Literal(true),
+    data: t.Array(BuildAdoptionPointSchema),
+});
+/**
+ * Date range query params schema (shared)
+ */
+export const DateRangeQuerySchema = t.Object({
+    start_date: t.String({ format: "date-time" }),
+    end_date: t.String({ format: "date-time" }),
+});
+/**
+ * Active versions/builds query params schema (with optional search)
+ */
+export const ActiveVersionsQuerySchema = t.Object({
+    start_date: t.String({ format: "date-time" }),
+    end_date: t.String({ format: "date-time" }),
+    search: t.Optional(t.String()),
+});
+/**
+ * Active versions & builds analytics schema
+ * Aggregated session counts by version and build for a date range
+ */
+export const ActiveBuildStatsSchema = t.Object({
+    build_id: t.String(),
+    build_number: t.Integer({ minimum: 0 }),
+    platform: t.Union([t.Literal("IOS"), t.Literal("ANDROID")]),
+    session_count: t.Integer({ minimum: 0 }),
+    device_count: t.Integer({ minimum: 0 }),
+});
+export const ActiveVersionStatsSchema = t.Object({
+    version_id: t.String(),
+    version_name: t.String(),
+    session_count: t.Integer({ minimum: 0 }),
+    device_count: t.Integer({ minimum: 0 }),
+    ios_count: t.Integer({ minimum: 0 }),
+    android_count: t.Integer({ minimum: 0 }),
+    builds: t.Array(ActiveBuildStatsSchema),
+});
+export const ActiveVersionsBuildsSchema = t.Object({
+    versions: t.Array(ActiveVersionStatsSchema),
+});
+export const ActiveVersionsBuildsResponseSchema = t.Object({
+    success: t.Literal(true),
+    data: ActiveVersionsBuildsSchema,
+});
+/**
+ * Session with user/device data for build sessions endpoint
+ */
+export const SessionDeviceSchema = t.Object({
+    id: t.String(),
+    device_name: t.Union([t.String(), t.Null()]),
+    device_brand: t.Union([t.String(), t.Null()]),
+});
+export const SessionUserSchema = t.Object({
+    id: t.String(),
+    user_id: t.Union([t.String(), t.Null()]),
+    email: t.Union([t.String(), t.Null()]),
+    name: t.Union([t.String(), t.Null()]),
+});
+export const SessionWithUserSchema = t.Object({
+    id: t.String(),
+    started_at: t.String(),
+    os_version: t.Union([t.String(), t.Null()]),
+    device: SessionDeviceSchema,
+    user: t.Union([SessionUserSchema, t.Null()]),
+});
+export const BuildSessionsQuerySchema = t.Object({
+    start_date: t.String({ format: "date-time" }),
+    end_date: t.String({ format: "date-time" }),
+    cursor: t.Optional(t.String()),
+    limit: t.Optional(t.String({ default: "20" })),
+    search: t.Optional(t.String()),
+});
+export const BuildSessionsResponseSchema = t.Object({
+    success: t.Literal(true),
+    data: t.Object({
+        sessions: t.Array(SessionWithUserSchema),
+        next_cursor: t.Union([t.String(), t.Null()]),
+    }),
+});

package/dist/modules/builds/index.d.ts

@@ -0,0 +1 @@
+export * from "./schemas";

package/dist/modules/builds/index.js

@@ -0,0 +1 @@
+export * from "./schemas";