@c15t/backend 1.2.1 → 1.2.2-canary-20250514183211

package/.turbo/turbo-build.log

@@ -1,53 +1,54 @@
-
-> @c15t/backend@1.2.1 build /home/runner/work/c15t/c15t/packages/backend
-> rslib build
-
-  Rslib v0.6.2
-
-ready   built in 1.18 s (esm)
-ready   built in 1.18 s (cjs)
-start   generating declaration files... (cjs)
-start   generating declaration files... (esm)
-ready   declaration files generated in 12.2 s (cjs)
-ready   declaration files generated in 12.2 s (esm)
-
-  File (cjs)                                                  Size        
-  dist/pkgs/types/index.cjs                                   0.60 kB 
-  dist/pkgs/data-model/fields/index.cjs                       7.3 kB  
-  dist/pkgs/results/index.cjs                                 18.5 kB 
-  dist/contracts.cjs                                          30.6 kB 
-  dist/pkgs/db-adapters/adapters/memory-adapter/index.cjs     45.3 kB 
-  dist/router.cjs                                             48.3 kB 
-  dist/pkgs/db-adapters/adapters/prisma-adapter/index.cjs     48.4 kB 
-  dist/pkgs/db-adapters/adapters/drizzle-adapter/index.cjs    50.7 kB 
-  dist/pkgs/migrations/index.cjs                              52.3 kB 
-  dist/pkgs/db-adapters/adapters/kysely-adapter/index.cjs     56.3 kB 
-  dist/pkgs/data-model/schema/index.cjs                       64.0 kB 
-  dist/schema/index.cjs                                       64.5 kB 
-  dist/pkgs/data-model/index.cjs                              66.0 kB 
-  dist/pkgs/db-adapters/index.cjs                             90.8 kB 
-  dist/core.cjs                                               152.1 kB
-
-  Total: 795.7 kB
-
-  -----
-
-  File (esm)                                                 Size        
-  dist/pkgs/types/index.js                                   0.00 kB 
-  dist/pkgs/data-model/fields/index.js                       5.6 kB  
-  dist/pkgs/results/index.js                                 16.4 kB 
-  dist/contracts.js                                          30.2 kB 
-  dist/pkgs/db-adapters/adapters/memory-adapter/index.js     44.3 kB 
-  dist/pkgs/db-adapters/adapters/prisma-adapter/index.js     47.5 kB 
-  dist/router.js                                             48.4 kB 
-  dist/pkgs/db-adapters/adapters/drizzle-adapter/index.js    50.0 kB 
-  dist/pkgs/migrations/index.js                              50.7 kB 
-  dist/pkgs/db-adapters/adapters/kysely-adapter/index.js     55.3 kB 
-  dist/pkgs/data-model/schema/index.js                       60.9 kB 
-  dist/schema/index.js                                       61.2 kB 
-  dist/pkgs/data-model/index.js                              61.8 kB 
-  dist/pkgs/db-adapters/index.js                             89.6 kB 
-  dist/core.js                                               153.1 kB
-
-  Total: 774.9 kB
-
+
+
+> @c15t/backend@1.2.1 build /Users/christopherburns/glados/k/c15t/packages/backend
+> rslib build
+
+  Rslib v0.6.2
+
+ready   built in 0.23 s (esm)
+ready   built in 0.23 s (cjs)
+start   generating declaration files... (esm)
+start   generating declaration files... (cjs)
+ready   declaration files generated in 3.49 s (cjs)
+ready   declaration files generated in 3.51 s (esm)
+
+  File (esm)                                                 Size        
+  dist/pkgs/types/index.js                                   0.00 kB 
+  dist/pkgs/data-model/fields/index.js                       5.6 kB  
+  dist/pkgs/results/index.js                                 16.4 kB 
+  dist/contracts.js                                          30.2 kB 
+  dist/pkgs/db-adapters/adapters/memory-adapter/index.js     44.3 kB 
+  dist/pkgs/db-adapters/adapters/prisma-adapter/index.js     47.5 kB 
+  dist/router.js                                             48.4 kB 
+  dist/pkgs/db-adapters/adapters/drizzle-adapter/index.js    50.0 kB 
+  dist/pkgs/migrations/index.js                              50.7 kB 
+  dist/pkgs/db-adapters/adapters/kysely-adapter/index.js     55.3 kB 
+  dist/pkgs/data-model/schema/index.js                       60.9 kB 
+  dist/schema/index.js                                       61.2 kB 
+  dist/pkgs/data-model/index.js                              61.8 kB 
+  dist/pkgs/db-adapters/index.js                             89.6 kB 
+  dist/core.js                                               153.1 kB
+
+  Total: 774.9 kB
+
+  -----
+
+  File (cjs)                                                  Size        
+  dist/pkgs/types/index.cjs                                   0.60 kB 
+  dist/pkgs/data-model/fields/index.cjs                       7.3 kB  
+  dist/pkgs/results/index.cjs                                 18.5 kB 
+  dist/contracts.cjs                                          30.6 kB 
+  dist/pkgs/db-adapters/adapters/memory-adapter/index.cjs     45.3 kB 
+  dist/router.cjs                                             48.3 kB 
+  dist/pkgs/db-adapters/adapters/prisma-adapter/index.cjs     48.4 kB 
+  dist/pkgs/db-adapters/adapters/drizzle-adapter/index.cjs    50.7 kB 
+  dist/pkgs/migrations/index.cjs                              52.3 kB 
+  dist/pkgs/db-adapters/adapters/kysely-adapter/index.cjs     56.3 kB 
+  dist/pkgs/data-model/schema/index.cjs                       64.0 kB 
+  dist/schema/index.cjs                                       64.5 kB 
+  dist/pkgs/data-model/index.cjs                              66.0 kB 
+  dist/pkgs/db-adapters/index.cjs                             90.8 kB 
+  dist/core.cjs                                               152.1 kB
+
+  Total: 795.7 kB
+

package/.turbo/turbo-fmt.log

@@ -0,0 +1,7 @@
+
+
+> @c15t/backend@1.0.5 fmt /Users/christopherburns/glados/k/c15t/packages/backend
+> pnpm biome format --write . && pnpm biome check --formatter-enabled=false --linter-enabled=false --organize-imports-enabled=true --write
+
+Formatted 163 files in 31ms. No fixes applied.
+Checked 163 files in 13ms. No fixes applied.

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @c15t/backend
 
+## 1.2.2-canary-20250514183211
+
+### Patch Changes
+
+- f64f000: feat: added @c15t/nextjs, @c15t/translations for better integration, server-side translations & fetching of consent banner
+- Updated dependencies [f64f000]
+  - @c15t/translations@1.2.2-canary-20250514183211
+
 ## 1.2.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c15t/backend",
-  "version": "1.2.1",
+  "version": "1.2.2-canary-20250514183211",
   "license": "GPL-3.0-only",
   "type": "module",
   "exports": {
@@ -99,7 +99,8 @@
     "kysely": "^0.27.6",
     "neverthrow": "^8.2.0",
     "superjson": "^2.2.2",
-    "zod": "^3.24.2"
+    "zod": "^3.24.2",
+    "@c15t/translations": "1.2.2-canary-20250514183211"
   },
   "devDependencies": {
     "@electric-sql/pglite": "0.2.17",

package/src/contracts/consent/show-banner.contract.test.ts

@@ -1,3 +1,4 @@
+import { baseTranslations } from '@c15t/translations';
 import { describe, expect, it } from 'vitest';
 
 // import { createContractTests } from '~/testing/contract-testing';
@@ -34,6 +35,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: 'DE',
 						regionCode: null,
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				const result = validateOutput(validOutput);
@@ -75,6 +80,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 							countryCode: 'US',
 							regionCode: null,
 						},
+						translations: {
+							translations: baseTranslations.en,
+							language: 'en',
+						},
 					};
 
 					const result = validateOutput(output);
@@ -93,6 +102,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: 'US',
 						regionCode: null,
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				const result = validateOutput(output);
@@ -112,6 +125,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: null,
 						regionCode: null,
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				const result = validateOutput(output);
@@ -129,6 +146,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: 'DE',
 						regionCode: 'BY',
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				const result = validateOutput(output);
@@ -146,6 +167,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: 123, // Invalid type
 						regionCode: null,
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				// Need to use type assertion to bypass TypeScript
@@ -166,6 +191,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: 'DE',
 						regionCode: null,
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				const falseOutput = {
@@ -178,6 +207,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: 'US',
 						regionCode: null,
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				expect(validateOutput(trueOutput)?.success).toBe(true);
@@ -195,6 +228,10 @@ describe('Show Consent Banner Contract Custom Tests', () => {
 						countryCode: 'DE',
 						regionCode: null,
 					},
+					translations: {
+						translations: baseTranslations.en,
+						language: 'en',
+					},
 				};
 
 				// Need to use type assertion to bypass TypeScript

package/src/contracts/consent/show-banner.contract.ts

@@ -1,8 +1,30 @@
 import { oc } from '@orpc/contract';
 import { z } from 'zod';
-
 import { JurisdictionInfoSchema } from '../shared/jurisdiction.schema';
 
+const TitleDescriptionSchema = z.object({
+	title: z.string(),
+	description: z.string(),
+});
+
+const TranslationsSchema = z.object({
+	common: z.object({
+		acceptAll: z.string(),
+		rejectAll: z.string(),
+		customize: z.string(),
+		save: z.string(),
+	}),
+	cookieBanner: TitleDescriptionSchema,
+	consentManagerDialog: TitleDescriptionSchema,
+	consentTypes: z.object({
+		experience: TitleDescriptionSchema,
+		functionality: TitleDescriptionSchema,
+		marketing: TitleDescriptionSchema,
+		measurement: TitleDescriptionSchema,
+		necessary: TitleDescriptionSchema,
+	}),
+});
+
 export const showConsentBannerContract = oc
 	.route({
 		method: 'GET',
@@ -41,5 +63,9 @@ Use this endpoint to implement geo-targeted consent banners and ensure complianc
 				countryCode: z.string().nullable(),
 				regionCode: z.string().nullable(),
 			}),
+			translations: z.object({
+				language: z.string(),
+				translations: TranslationsSchema,
+			}),
 		})
 	);

package/src/handlers/consent/show-banner.handler.test.ts

@@ -1,3 +1,4 @@
+import { baseTranslations } from '@c15t/translations';
 import { describe, expect, it, vi } from 'vitest';
 import { JurisdictionMessages } from '~/contracts/shared/jurisdiction.schema';
 import { showConsentBanner } from './show-banner.handler';
@@ -125,6 +126,47 @@ describe('Show Consent Banner Handler', () => {
 		});
 	});
 
+	describe('Translation handling', () => {
+		it('returns default translations when no language is detected', async () => {
+			//@ts-expect-error
+			const result = await showConsentBanner(
+				createMockContext({ 'cf-ipcountry': 'DE' })
+			);
+
+			expect(result.translations).toEqual({
+				translations: baseTranslations.en,
+				language: 'en',
+			});
+		});
+
+		it('returns translations for detected language', async () => {
+			//@ts-expect-error
+			const result = await showConsentBanner(
+				createMockContext({ 'cf-ipcountry': 'DE', 'accept-language': 'de-DE' })
+			);
+
+			expect(result.translations).toEqual({
+				translations: baseTranslations.de,
+				language: 'de',
+			});
+		});
+
+		it('returns default translations when language is not supported', async () => {
+			//@ts-expect-error
+			const result = await showConsentBanner(
+				createMockContext({
+					'cf-ipcountry': 'DE',
+					'accept-language': 'foobar',
+				})
+			);
+
+			expect(result.translations).toEqual({
+				translations: baseTranslations.en,
+				language: 'en',
+			});
+		});
+	});
+
 	describe('Response format', () => {
 		it('returns properly structured response', async () => {
 			//@ts-expect-error
@@ -142,6 +184,10 @@ describe('Show Consent Banner Handler', () => {
 					countryCode: 'DE',
 					regionCode: null,
 				},
+				translations: {
+					translations: baseTranslations.en,
+					language: 'en',
+				},
 			});
 		});
 	});

package/src/handlers/consent/show-banner.handler.ts

@@ -1,3 +1,4 @@
+import { baseTranslations } from '@c15t/translations';
 import { ORPCError } from '@orpc/server';
 import { os } from '~/contracts';
 import {
@@ -6,6 +7,34 @@ import {
 } from '~/contracts/shared/jurisdiction.schema';
 import type { C15TContext } from '~/types';
 
+type SupportedLanguage = keyof typeof baseTranslations;
+
+/**
+ * Extracts the preferred language from Accept-Language header
+ * Falls back to 'en' if no supported language is found
+ */
+function getPreferredLanguage(
+	acceptLanguage: string | null
+): SupportedLanguage {
+	if (!acceptLanguage) {
+		return 'en';
+	}
+
+	// Get the primary language code
+	const primaryLang = acceptLanguage
+		.split(',')[0]
+		?.split(';')[0]
+		?.split('-')[0]
+		?.toLowerCase();
+
+	// Check if it's a supported language
+	if (primaryLang && primaryLang in baseTranslations) {
+		return primaryLang as SupportedLanguage;
+	}
+
+	return 'en';
+}
+
 /**
  * Handler for the show consent banner endpoint
  * Determines if a user should see a consent banner based on their location
@@ -45,13 +74,15 @@ export const showConsentBanner = os.consent.showBanner.handler(
 			normalizeHeader(headers.get('x-vercel-ip-country-region')) ??
 			normalizeHeader(headers.get('x-region-code'));
 
-		// If no location headers found, throw error
+		// Get preferred language from Accept-Language header
+		const acceptLanguage = normalizeHeader(headers.get('accept-language'));
+		const preferredLanguage = getPreferredLanguage(acceptLanguage);
 
 		// Determine jurisdiction based on country
 		const { showConsentBanner, jurisdictionCode, message } =
 			checkJurisdiction(countryCode);
 
-		// Return properly structured response
+		// Return properly structured response with translations
 		return {
 			showConsentBanner,
 			jurisdiction: {
@@ -59,6 +90,10 @@ export const showConsentBanner = os.consent.showBanner.handler(
 				message,
 			},
 			location: { countryCode, regionCode },
+			translations: {
+				translations: baseTranslations[preferredLanguage],
+				language: preferredLanguage,
+			},
 		};
 	}
 );