@teardown/schemas 0.1.0

package/dist/modules/versions/schemas.js

@@ -0,0 +1,155 @@
+import { VersionBuildStatusEnum } from "@teardown/types";
+import { t } from "elysia";
+/**
+ * Version status enum matching database
+ */
+export const VersionBuildStatusSchema = t.Enum(VersionBuildStatusEnum);
+/**
+ * Parse and validate a VersionBuildStatusEnum value
+ * Uses a switch statement to ensure type safety and runtime validation
+ * @param value - The value to parse
+ * @returns The validated VersionBuildStatusEnum value
+ * @throws Error if the value is not a valid VersionBuildStatusEnum
+ */
+export function parseVersionStatusEnum(value) {
+    switch (value) {
+        case VersionBuildStatusEnum.SUPPORTED:
+            return VersionBuildStatusEnum.SUPPORTED;
+        case VersionBuildStatusEnum.UPDATE_AVAILABLE:
+            return VersionBuildStatusEnum.UPDATE_AVAILABLE;
+        case VersionBuildStatusEnum.UPDATE_RECOMMENDED:
+        case VersionBuildStatusEnum.UPDATE_REQUIRED:
+            return VersionBuildStatusEnum.UPDATE_REQUIRED;
+        default:
+            throw new Error(`Invalid VersionBuildStatusEnum value: ${value}. Expected one of: ${Object.values(VersionBuildStatusEnum).join(", ")}`);
+    }
+}
+/**
+ * Base version schema
+ * Represents project_versions table structure
+ */
+export const VersionSchema = t.Object({
+    id: t.String({ format: "uuid" }),
+    project_id: t.String({ format: "uuid" }),
+    name: t.String(),
+    major: t.Number(), // Matches type number, not integer constraint (db type numeric)
+    minor: t.Number(),
+    patch: t.Number(),
+    status: VersionBuildStatusSchema, // SUPPORTED, UPDATE_AVAILABLE, UPDATE_RECOMMENDED, UPDATE_REQUIRED - controls if version is active
+    created_at: t.String(),
+    updated_at: t.String(),
+});
+/**
+ * Version params schema
+ */
+export const VersionParamsSchema = t.Object({
+    version_id: t.String({ format: "uuid" }),
+});
+/**
+ * Search versions query schema
+ * Supports pagination, search, and sorting
+ */
+export const SearchVersionsQuerySchema = t.Object({
+    project_id: t.String({ format: "uuid" }),
+    page: t.Numeric({ minimum: 1, default: 1 }),
+    limit: t.Numeric({ minimum: 1, maximum: 100, default: 20 }),
+    search: t.Optional(t.String()),
+    sort_by: t.Union([
+        t.Literal("created_at"),
+        t.Literal("updated_at"),
+        t.Literal("name"),
+        t.Literal("major"),
+        t.Literal("minor"),
+        t.Literal("patch"),
+    ], { default: "created_at" }),
+    sort_order: t.Union([t.Literal("asc"), t.Literal("desc")], { default: "desc" }),
+});
+/**
+ * Search versions query schema without project_id (injected from headers)
+ */
+export const SearchVersionsQueryParamsSchema = t.Omit(SearchVersionsQuerySchema, ["project_id"]);
+/**
+ * Versions by IDs request schema
+ */
+export const VersionsByIdsSchema = t.Object({
+    version_ids: t.Array(t.String({ format: "uuid" }), { minItems: 1, maxItems: 100 }),
+});
+/**
+ * Paginated versions response schema
+ */
+export const VersionsResponseSchema = t.Object({
+    versions: t.Array(VersionSchema),
+    pagination: t.Object({
+        page: t.Integer({ minimum: 1 }),
+        limit: t.Integer({ minimum: 1 }),
+        total: t.Integer({ minimum: 0 }),
+        total_pages: t.Integer({ minimum: 0 }),
+    }),
+});
+/**
+ * Single version response schema
+ */
+export const VersionResponseSchema = t.Object({
+    success: t.Literal(true),
+    data: VersionSchema,
+});
+/**
+ * Version error response schema
+ * Discriminated union by error code
+ */
+export const VersionErrorSchema = t.Union([
+    t.Object({
+        code: t.Literal("VERSION_NOT_FOUND"),
+        message: t.String(),
+    }),
+    t.Object({
+        code: t.Literal("PROJECT_NOT_FOUND"),
+        message: t.String(),
+    }),
+    t.Object({
+        code: t.Literal("FORBIDDEN"),
+        message: t.String(),
+    }),
+    t.Object({
+        code: t.Literal("FETCH_FAILED"),
+        message: t.String(),
+    }),
+    t.Object({
+        code: t.Literal("INVALID_PARAMS"),
+        message: t.String(),
+    }),
+]);
+/**
+ * Version error response wrapper
+ */
+export const VersionErrorResponseSchema = t.Object({
+    success: t.Literal(false),
+    error: VersionErrorSchema,
+});
+/**
+ * Version request response schema
+ */
+export const VersionRequestResponseSchema = t.Union([VersionResponseSchema, VersionErrorResponseSchema]);
+/**
+ * Update version status request body schema
+ */
+export const UpdateVersionStatusBodySchema = t.Object({
+    status: VersionBuildStatusSchema,
+});
+/**
+ * Add UPDATE_FAILED error code for update operations
+ */
+export const VersionErrorSchemaWithUpdate = t.Union([
+    VersionErrorSchema,
+    t.Object({
+        code: t.Literal("UPDATE_FAILED"),
+        message: t.String(),
+    }),
+]);
+/**
+ * Version error response wrapper with update error
+ */
+export const VersionErrorResponseWithUpdateSchema = t.Object({
+    success: t.Literal(false),
+    error: VersionErrorSchemaWithUpdate,
+});

package/package.json

@@ -0,0 +1,106 @@
+{
+	"name": "@teardown/schemas",
+	"version": "0.1.0",
+	"private": false,
+	"publishConfig": {
+		"access": "public"
+	},
+	"type": "module",
+	"files": ["dist/**/*"],
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		},
+		"./common": {
+			"types": "./dist/common/index.d.ts",
+			"import": "./dist/common/index.js",
+			"default": "./dist/common/index.js"
+		},
+		"./devices": {
+			"types": "./dist/modules/devices/index.d.ts",
+			"import": "./dist/modules/devices/index.js",
+			"default": "./dist/modules/devices/index.js"
+		},
+		"./environment": {
+			"types": "./dist/modules/environment/index.d.ts",
+			"import": "./dist/modules/environment/index.js",
+			"default": "./dist/modules/environment/index.js"
+		},
+		"./identify": {
+			"types": "./dist/modules/identify/index.d.ts",
+			"import": "./dist/modules/identify/index.js",
+			"default": "./dist/modules/identify/index.js"
+		},
+		"./me": {
+			"types": "./dist/modules/me/index.d.ts",
+			"import": "./dist/modules/me/index.js",
+			"default": "./dist/modules/me/index.js"
+		},
+		"./orgs": {
+			"types": "./dist/modules/orgs/index.d.ts",
+			"import": "./dist/modules/orgs/index.js",
+			"default": "./dist/modules/orgs/index.js"
+		},
+		"./personas": {
+			"types": "./dist/modules/personas/index.d.ts",
+			"import": "./dist/modules/personas/index.js",
+			"default": "./dist/modules/personas/index.js"
+		},
+		"./projects": {
+			"types": "./dist/modules/projects/index.d.ts",
+			"import": "./dist/modules/projects/index.js",
+			"default": "./dist/modules/projects/index.js"
+		},
+		"./sessions": {
+			"types": "./dist/modules/sessions/index.d.ts",
+			"import": "./dist/modules/sessions/index.js",
+			"default": "./dist/modules/sessions/index.js"
+		},
+		"./versions": {
+			"types": "./dist/modules/versions/index.d.ts",
+			"import": "./dist/modules/versions/index.js",
+			"default": "./dist/modules/versions/index.js"
+		},
+		"./builds": {
+			"types": "./dist/modules/builds/index.d.ts",
+			"import": "./dist/modules/builds/index.js",
+			"default": "./dist/modules/builds/index.js"
+		},
+		"./analytics": {
+			"types": "./dist/modules/analytics/index.d.ts",
+			"import": "./dist/modules/analytics/index.js",
+			"default": "./dist/modules/analytics/index.js"
+		},
+		"./events": {
+			"types": "./dist/modules/events/index.d.ts",
+			"import": "./dist/modules/events/index.js",
+			"default": "./dist/modules/events/index.js"
+		}
+	},
+	"scripts": {
+		"dev": "bun x tsc --project ./tsconfig.json --watch",
+		"build": "bun x tsc --project ./tsconfig.json",
+		"typecheck": "bun x tsc --noEmit --project ./tsconfig.json",
+		"lint": "bun x biome lint .",
+		"fmt": "bun x biome format --write .",
+		"check": "bun x biome check .",
+		"prepublishOnly": "bun x turbo run build"
+	},
+	"dependencies": {
+		"@teardown/types": "0.0.2",
+		"elysia": "1.4.16"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.7",
+		"@teardown/tsconfig": "1.0.0",
+		"typescript": "^5.9.3"
+	},
+	"peerDependencies": {
+		"typescript": "^5.9.3"
+	}
+}