@proulr/bff-core 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proulr/bff-core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/index.ts

@@ -5,11 +5,17 @@ import { cors } from 'hono/cors';
 import type { SduiScreenBuilder, SduiScreenBuilderContext } from '@proulr/sdui-contract';
 import { createBffMetrics, isBffMetricsEnabled } from './bff-metrics';
 
+export type SduiActionHandler = (
+  ctx: SduiScreenBuilderContext,
+  body: Record<string, unknown>,
+) => Promise<Record<string, unknown>>;
+
 export type CreateSduiBffOptions = {
   name: string;
   port: number;
   bffId: string;
   screens: Record<string, SduiScreenBuilder>;
+  actions?: Record<string, SduiActionHandler>;
 };
 
 function buildContext(
@@ -107,13 +113,34 @@ export function createSduiBff(options: CreateSduiBffOptions) {
 
   app.post('/v1/actions/:actionId', async (c) => {
     const actionId = c.req.param('actionId');
-    const body = await c.req.json().catch(() => ({}));
-    return c.json({
-      ok: true,
-      action_id: actionId,
-      received: body,
-      message: 'Action endpoint stub — implement per domain in each BFF.',
-    });
+    const body = (await c.req.json().catch(() => ({}))) as Record<string, unknown>;
+    const handler = options.actions?.[actionId];
+
+    if (!handler) {
+      return c.json({
+        ok: false,
+        action_id: actionId,
+        error: 'action_not_found',
+        message: 'Action endpoint stub — register handler in BFF actions map.',
+      }, 404);
+    }
+
+    try {
+      const authToken = readAuthToken(c.req.header('Authorization'));
+      const result = await handler(buildContext({}, {}, authToken), body);
+      return c.json({ ok: true, action_id: actionId, ...result });
+    } catch (error) {
+      console.warn(`[${options.bffId}] action ${actionId} failed`, error);
+      return c.json(
+        {
+          ok: false,
+          action_id: actionId,
+          error: 'action_failed',
+          message: error instanceof Error ? error.message : 'action_failed',
+        },
+        500,
+      );
+    }
   });
 
   return {
@@ -128,3 +155,9 @@ export function createSduiBff(options: CreateSduiBffOptions) {
 
 export * from '@proulr/sdui-contract';
 export { createBffSupabaseClient, isBffSupabaseConfigured } from './bff-supabase-client';
+export {
+  buildNativeAdInsertionSeed,
+  insertRandomNativeAdSlots,
+  type InsertRandomNativeAdSlotsOptions,
+  type NativeAdSlotWire,
+} from './native-ad-slot-insertion';

package/src/native-ad-slot-insertion.ts

@@ -0,0 +1,90 @@
+export type NativeAdSlotWire = {
+  kind: 'ad';
+  id: string;
+  placement: string;
+};
+
+export type InsertRandomNativeAdSlotsOptions = {
+  placement: string;
+  seed: string;
+  minContentBeforeFirstAd?: number;
+  minGap?: number;
+  maxGap?: number;
+  maxAds?: number;
+  idPrefix?: string;
+};
+
+function hashSeed(seed: string): number {
+  let hash = 2166136261;
+  for (let index = 0; index < seed.length; index += 1) {
+    hash ^= seed.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return hash >>> 0;
+}
+
+function createSeededRandom(seed: number): () => number {
+  let state = seed || 1;
+  return () => {
+    state = (state + 0x6d2b79f5) | 0;
+    let t = Math.imul(state ^ (state >>> 15), 1 | state);
+    t ^= t + Math.imul(t ^ (t >>> 7), 61 | t);
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+  };
+}
+
+function randomInt(random: () => number, min: number, max: number): number {
+  if (max <= min) return min;
+  return min + Math.floor(random() * (max - min + 1));
+}
+
+export function buildNativeAdInsertionSeed(parts: string[]): string {
+  return parts.filter(Boolean).join(':');
+}
+
+export function insertRandomNativeAdSlots<T>(
+  items: T[],
+  options: InsertRandomNativeAdSlotsOptions,
+): Array<T | NativeAdSlotWire> {
+  const minContentBeforeFirstAd = options.minContentBeforeFirstAd ?? 2;
+  const minGap = options.minGap ?? 4;
+  const maxGap = options.maxGap ?? 8;
+  const maxAds = options.maxAds ?? Math.max(1, Math.floor(items.length / 12));
+  const idPrefix = options.idPrefix ?? options.placement;
+
+  if (!items.length || items.length < minContentBeforeFirstAd + 1) {
+    return [...items];
+  }
+
+  const random = createSeededRandom(hashSeed(options.seed));
+  const result: Array<T | NativeAdSlotWire> = [];
+  let sourceIndex = 0;
+  let adsInserted = 0;
+  let contentSinceLastAd = 0;
+  let nextAdAfter = randomInt(random, minGap, maxGap);
+
+  while (sourceIndex < items.length) {
+    const shouldInsertAd =
+      adsInserted < maxAds &&
+      contentSinceLastAd >= nextAdAfter &&
+      sourceIndex >= minContentBeforeFirstAd;
+
+    if (shouldInsertAd) {
+      result.push({
+        kind: 'ad',
+        id: `${idPrefix}-ad-${adsInserted}`,
+        placement: options.placement,
+      });
+      adsInserted += 1;
+      contentSinceLastAd = 0;
+      nextAdAfter = randomInt(random, minGap, maxGap);
+      continue;
+    }
+
+    result.push(items[sourceIndex]);
+    sourceIndex += 1;
+    contentSinceLastAd += 1;
+  }
+
+  return result;
+}