onboardme-sdk 0.0.1

package/src/v2/types.ts

@@ -0,0 +1,53 @@
+// v2 schema types for the SDK renderer (Architecture v2 — Phase F).
+//
+// Mirrors the API validator at apps/api/src/services/flow-validator.service.ts
+// and the dashboard editor at apps/dashboard/src/components/flow-editor/types.ts.
+// Three places need to agree on this shape — the API rejects malformed configs
+// at publish time, the dashboard guides the PM to valid edits, and the SDK
+// renders only what these types describe.
+
+export type V2StepType   = 'tooltip' | 'modal' | 'highlight'
+export type V2Placement  = 'top' | 'bottom' | 'left' | 'right' | 'center'
+export type V2ActionType = 'next' | 'skip' | 'complete'
+
+export interface V2Action {
+  type:  V2ActionType
+  label: string
+}
+
+export interface V2Position {
+  selector:  string
+  placement: V2Placement
+}
+
+export interface V2Step {
+  id:          string
+  title:       string
+  description: string
+  type:        V2StepType
+  position:    V2Position
+  action:      V2Action
+}
+
+export interface V2FlowConfig {
+  steps: V2Step[]
+}
+
+// Detector: a flow is v2 if its first step has a v2-shaped `position` object
+// AND a v2-shaped `action` object. Legacy flows have neither — they use
+// `body`, `targetSelector`, `primaryCta`. This is structural (not a version
+// flag) so flows generated by Phase D are recognised regardless of their
+// id/version metadata.
+export function isV2FlowConfig(config: unknown): config is V2FlowConfig {
+  if (!config || typeof config !== 'object') return false
+  const c = config as { steps?: unknown }
+  if (!Array.isArray(c.steps) || c.steps.length === 0) return false
+  const first = c.steps[0] as Record<string, unknown> | null
+  if (!first) return false
+  const position = first.position as Record<string, unknown> | undefined
+  const action   = first.action   as Record<string, unknown> | undefined
+  if (!position || typeof position.selector !== 'string') return false
+  if (typeof position.placement !== 'string') return false
+  if (!action || typeof action.type !== 'string' || typeof action.label !== 'string') return false
+  return true
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "noEmit": true,
+    "paths": {
+      "@onboardme/types": ["../types/src/index.ts"]
+    }
+  },
+  "include": ["src/**/*", "vite.config.ts"]
+}

package/vite.config.ts

@@ -0,0 +1,28 @@
+import { defineConfig } from 'vitest/config';
+import { resolve } from 'path';
+
+export default defineConfig({
+  resolve: {
+    alias: {
+      '@onboardme/types': resolve(__dirname, '../types/src/index.ts'),
+    },
+  },
+  build: {
+    lib: {
+      entry: resolve(__dirname, 'src/browser.ts'),
+      name: 'OnboardMe',
+      fileName: 'sdk',
+      formats: ['iife'],
+    },
+    outDir: 'dist',
+    minify: true,
+    rollupOptions: {
+      output: {
+        entryFileNames: 'sdk.iife.js',
+      },
+    },
+  },
+  test: {
+    environment: 'node',
+  },
+});

package/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'jsdom',
+  },
+});