@teardown/schemas 0.1.43 → 0.1.44

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@teardown/schemas",
-	"version": "0.1.43",
+	"version": "0.1.44",
 	"private": false,
 	"publishConfig": {
 		"access": "public"
@@ -82,6 +82,11 @@
 			"types": "./src/modules/events/index.ts",
 			"import": "./src/modules/events/index.ts",
 			"default": "./src/modules/events/index.ts"
+		},
+		"./headers": {
+			"types": "./src/modules/headers/index.ts",
+			"import": "./src/modules/headers/index.ts",
+			"default": "./src/modules/headers/index.ts"
 		}
 	},
 	"scripts": {
@@ -93,11 +98,11 @@
 	},
 	"dependencies": {
 		"@sinclair/typebox": "^0.34.41",
-		"@teardown/types": "0.1.43"
+		"@teardown/types": "0.1.44"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.8",
-		"@teardown/tsconfig": "0.1.43",
+		"@teardown/tsconfig": "0.1.44",
 		"typescript": "5.9.3"
 	},
 	"peerDependencies": {

package/src/modules/analytics/schemas.ts

@@ -108,6 +108,7 @@ export const ActiveBuildStatsSchema = Type.Object({
 	platform: Type.Union([Type.Literal("IOS"), Type.Literal("ANDROID")]),
 	session_count: Type.Integer({ minimum: 0 }),
 	device_count: Type.Integer({ minimum: 0 }),
+	user_count: Type.Integer({ minimum: 0 }),
 	status: Type.Optional(VersionBuildStatusSchema),
 });
 export type ActiveBuildStats = Static<typeof ActiveBuildStatsSchema>;
@@ -117,6 +118,7 @@ export const ActiveVersionStatsSchema = Type.Object({
 	version_name: Type.String(),
 	session_count: Type.Integer({ minimum: 0 }),
 	device_count: Type.Integer({ minimum: 0 }),
+	user_count: Type.Integer({ minimum: 0 }),
 	ios_count: Type.Integer({ minimum: 0 }),
 	android_count: Type.Integer({ minimum: 0 }),
 	version_status: Type.Optional(VersionBuildStatusSchema),

package/src/modules/headers/index.ts

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

package/src/modules/headers/schemas.ts

@@ -0,0 +1,77 @@
+import { type Static, Type } from "@sinclair/typebox";
+
+/**
+ * SDK Info schema
+ * Represents parsed SDK version header information
+ */
+export const SdkInfoSchema = Type.Object({
+	sdkName: Type.Union([Type.String(), Type.Null()]),
+	sdkVersion: Type.Union([Type.String(), Type.Null()]),
+});
+export type SdkInfo = Static<typeof SdkInfoSchema>;
+
+/**
+ * Identify headers schema
+ * Headers required for the identify endpoint
+ */
+export const IdentifyHeadersSchema = Type.Object({
+	orgId: Type.String({ error: "orgId is required" }),
+	projectId: Type.String({ error: "projectId is required" }),
+	environmentSlug: Type.String({ error: "environmentSlug is required" }),
+	deviceId: Type.String({ error: "deviceId is required" }),
+	sessionId: Type.Union([Type.String(), Type.Null()]),
+	sdk: SdkInfoSchema,
+});
+export type IdentifyHeaders = Static<typeof IdentifyHeadersSchema>;
+
+/**
+ * Events headers schema
+ * Headers required for the events endpoint
+ */
+export const EventsHeadersSchema = Type.Object({
+	orgId: Type.String({ error: "orgId is required" }),
+	projectId: Type.String({ error: "projectId is required" }),
+	environmentSlug: Type.String({ error: "environmentSlug is required" }),
+	deviceId: Type.Union([Type.String(), Type.Null()]),
+	sessionId: Type.Union([Type.String(), Type.Null()]),
+});
+export type EventsHeaders = Static<typeof EventsHeadersSchema>;
+
+/**
+ * Header error codes
+ */
+export const HeaderErrorCodeSchema = Type.Union([
+	Type.Literal("MISSING_DEVICE_ID"),
+	Type.Literal("MISSING_ENVIRONMENT_SLUG"),
+	Type.Literal("MISSING_ORG_ID"),
+	Type.Literal("MISSING_PROJECT_ID"),
+]);
+export type HeaderErrorCode = Static<typeof HeaderErrorCodeSchema>;
+
+/**
+ * Parses SDK version header in format "@package/name@version" or "name@version"
+ * @param sdkVersionHeader - The td-sdk-version header value (e.g., "@teardown/sdk@0.0.2")
+ * @returns Parsed SDK name and version, or nulls if not provided/parseable
+ */
+export function parseSdkVersionHeader(sdkVersionHeader: string | undefined): SdkInfo {
+	if (!sdkVersionHeader) {
+		return { sdkName: null, sdkVersion: null };
+	}
+
+	// Handle scoped packages like "@teardown/sdk@0.0.2"
+	// Find the last @ which separates name from version
+	const lastAtIndex = sdkVersionHeader.lastIndexOf("@");
+
+	// If no @ found or @ is at the start (just scoped name without version), return as-is
+	if (lastAtIndex <= 0) {
+		return { sdkName: sdkVersionHeader, sdkVersion: null };
+	}
+
+	const sdkName = sdkVersionHeader.slice(0, lastAtIndex);
+	const sdkVersion = sdkVersionHeader.slice(lastAtIndex + 1);
+
+	return {
+		sdkName: sdkName || null,
+		sdkVersion: sdkVersion || null,
+	};
+}

package/src/modules/identify/schemas.ts

@@ -139,7 +139,7 @@ export type PersonaInfo = UserInfo;
  */
 export const IdentifyRequestSchema = Type.Object({
 	device: DeviceInfoSchema,
-	persona: Type.Optional(UserInfoSchema),
+	user: Type.Optional(UserInfoSchema),
 });
 export type IdentifyRequest = Static<typeof IdentifyRequestSchema>;
 

package/src/modules/index.ts

@@ -3,6 +3,7 @@ export * from "./builds/schemas";
 export * from "./devices/schemas";
 export * from "./environment/schemas";
 export * from "./events/schemas";
+export * from "./headers/schemas";
 export * from "./identify/schemas";
 export * from "./me/schemas";
 export * from "./orgs/schemas";