@tiun/types 0.4.0 → 0.10.0

package/README.md

@@ -55,7 +55,7 @@ tiun.checkout({ productId: 'prod_123' });
 
 ## Auto-generated
 
-This package is auto-generated from `src/sdk/types.ts`.
+The published `index.d.ts` is generated from `packages/types/src/index.ts` (the hand-written source of truth) via `npm run generate:types`.
 
 ## License
 

package/index.d.ts

@@ -6,7 +6,7 @@
  * These types are for the global `tiun` object exposed by the tiun script.
  * Load the script, then use tiun.* with full TypeScript support.
  *
- * @generated from src/sdk/types.ts - Do not edit directly.
+ * @generated from packages/types/src/index.ts - Do not edit directly.
  * Run `npm run generate:types` to regenerate.
  */
 
@@ -16,6 +16,9 @@
 
 export type ContentType = 'active' | 'inactive' | 'paused';
 export type MediaType = 'text' | 'audio' | 'video';
+export type SupportedLanguage = 'en' | 'de' | 'fr';
+/** 'auto' follows the visitor's OS setting (prefers-color-scheme). */
+export type Appearance = 'light' | 'dark' | 'auto';
 export type TiunEventType =
   | 'ready'
   | 'paywallShow'
@@ -38,19 +41,28 @@ export interface TiunConfig {
   snippetId?: string;
 
   /**
-   * Language for the snippet UI.
+   * Language for the snippet UI. Case-insensitive ('en', 'EN', 'De' all work).
+   * Falls back to 'en' if an unsupported value is provided.
    * @default 'en'
    */
-  language?: string;
+  language?: SupportedLanguage;
 
   /**
    * UI tone/style.
    * - 'formal': More professional tone
    * - 'informal': More casual/friendly tone
-   * @default 'formal'
+   * @default 'informal'
    */
   tone?: 'formal' | 'informal';
 
+  /**
+   * Color theme for the snippet UI. Case-insensitive. 'auto' follows the
+   * visitor's OS setting and re-themes live when it changes.
+   * Change it later with `tiun.setAppearance()`.
+   * @default 'light'
+   */
+  appearance?: Appearance;
+
   /**
    * Enable debug logging to console.
    * @default false
@@ -211,6 +223,12 @@ export interface TiunSDK {
    */
   setContent(options: ContentOptions): Promise<void>;
 
+  /**
+   * Switch the snippet's color theme at runtime, e.g. when your site's theme
+   * toggle flips. Safe to call before the snippet is ready.
+   */
+  setAppearance(appearance: Appearance): void;
+
   /**
    * Open the OTP login modal for returning subscribers.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiun/types",
-  "version": "0.4.0",
+  "version": "0.10.0",
   "description": "TypeScript type definitions for tiun SDK (for script tag users)",
   "types": "./index.d.ts",
   "files": [
@@ -8,6 +8,9 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "node ../../scripts/generate-types.mjs"
+  },
   "keywords": [
     "tiun",
     "types",
@@ -19,7 +22,7 @@
     "type": "git",
     "url": "https://github.com/tiun-app/tiun-snippet"
   },
-  "homepage": "https://tiun.io",
+  "homepage": "https://docs.tiun.io",
   "license": "MIT",
   "publishConfig": {
     "access": "public"