@pxlabz/tracey-react 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,188 @@
+export interface TraceyConfig {
+    apiKey: string;
+    baseUrl?: string;
+    debug?: boolean;
+}
+export interface TraceyUser {
+    id: string;
+    email?: string;
+    name?: string;
+    phone?: string;
+    role?: string;
+    company?: string;
+    title?: string;
+    avatar?: string;
+    traits?: Record<string, unknown>;
+    /** HMAC-SHA256 hash for identity verification. Computed server-side using the workspace's identity verification secret. */
+    userHash?: string;
+}
+export interface TraceyTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    borderRadius?: string | number;
+    fontFamily?: string;
+}
+export type Position = "top-left" | "top-right" | "bottom-left" | "bottom-right" | {
+    x: number;
+    y: number;
+} | string;
+export type FeedbackType = "bug" | "feature_request" | "general";
+export type FeedbackStatus = "new" | "under_review" | "planned" | "in_progress" | "completed" | "rejected";
+export type FeedbackCategory = string;
+export interface Feedback {
+    title: string;
+    description?: string;
+    type: FeedbackType;
+    category?: FeedbackCategory;
+    tags?: string[];
+    screenshot?: string;
+}
+export interface FeedbackResponse {
+    id: number;
+    title: string;
+    description: string | null;
+    type: FeedbackType;
+    status: string;
+    category: string | null;
+    tags: string[] | null;
+    createdAt: string;
+}
+export interface MyFeedbackItem {
+    id: number;
+    title: string;
+    description: string | null;
+    type: string;
+    status: string;
+    category: string | null;
+    tags: string[] | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+}
+export interface SurveyQuestion {
+    questionKey: string;
+    type: "nps" | "rating" | "single_choice" | "long_text";
+    title: string;
+    description?: string | null;
+    required: boolean;
+    position: number;
+    config: Record<string, unknown>;
+}
+export interface SurveyLogicRule {
+    sourceQuestionKey: string | null;
+    operator: "eq" | "neq" | "gte" | "lte" | "in" | "answered" | "not_answered";
+    value?: unknown;
+    action: "go_to_question" | "end_survey";
+    nextQuestionKey: string | null;
+    priority: number;
+}
+export interface Survey {
+    id: number;
+    name: string;
+    format: "nps" | "rating" | "single_choice" | "open_text" | "mixed";
+    status: "draft" | "active" | "paused" | "archived";
+    priority: number;
+    questions: SurveyQuestion[];
+    logicRules: SurveyLogicRule[];
+}
+export type SurveyAnswerInput = {
+    questionKey: string;
+    type: "nps" | "rating";
+    valueNumber: number;
+} | {
+    questionKey: string;
+    type: "single_choice" | "long_text";
+    valueText: string;
+};
+export interface SurveyResponseResult {
+    success: boolean;
+    responseId: number;
+}
+export interface AnnouncementSlide {
+    id: number;
+    order: number;
+    title: string | null;
+    body: string | null;
+    imageUrl: string | null;
+    videoUrl: string | null;
+    ctaText: string | null;
+    ctaUrl: string | null;
+}
+export interface Announcement {
+    id: number;
+    title: string;
+    status: "draft" | "scheduled" | "published" | "archived";
+    displayType: "modal" | "banner" | "toast";
+    publishAt: string | null;
+    expiresAt: string | null;
+    slides: AnnouncementSlide[];
+    viewed?: boolean;
+    ctaClicked?: boolean;
+}
+export interface TraceyEvents {
+    "feedback:submitted": {
+        feedback: FeedbackResponse;
+    };
+    "feedback:error": {
+        error: Error;
+    };
+    "feedback:rate-limited": {
+        retryAfterMs: number;
+    };
+    "survey:shown": {
+        survey: Survey;
+    };
+    "survey:submitted": {
+        surveyId: number;
+        response: SurveyResponseResult;
+    };
+    "survey:dismissed": {
+        surveyId: number;
+    };
+    "survey:error": {
+        error: Error;
+        surveyId?: number;
+    };
+    "announcement:viewed": {
+        announcement: Announcement;
+    };
+    "announcement:dismissed": {
+        announcement: Announcement;
+    };
+    "announcement:cta-clicked": {
+        announcement: Announcement;
+        slideIndex: number;
+    };
+    "unread-count-changed": {
+        count: number;
+        previousCount: number;
+    };
+    "user:identified": {
+        user: TraceyUser;
+    };
+    error: {
+        error: Error;
+        context?: string;
+    };
+}
+export interface ApiError {
+    message: string;
+    code?: string;
+}
+export interface TraceyContextValue {
+    config: TraceyConfig;
+    user: TraceyUser | null;
+    isIdentified: boolean;
+    isLoading: boolean;
+    error: Error | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,94 @@
+{
+	"name": "@pxlabz/tracey-react",
+	"version": "0.0.1",
+	"description": "React SDK for Tracey feedback widgets and announcements",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
+		"./headless": {
+			"types": "./dist/headless.d.ts",
+			"import": "./dist/headless.js",
+			"require": "./dist/headless.cjs"
+		},
+		"./styles.css": "./dist/styles.css"
+	},
+	"files": [
+		"dist"
+	],
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"sideEffects": [
+		"**/*.css"
+	],
+	"scripts": {
+		"dev": "vite build --watch",
+		"build": "vite build && tsc --emitDeclarationOnly",
+		"test": "vitest run",
+		"type-check": "tsc --noEmit",
+		"lint": "eslint .",
+		"publish:dry-run": "npm publish --dry-run",
+		"storybook": "storybook dev -p 6006",
+		"storybook:build": "storybook build"
+	},
+	"peerDependencies": {
+		"react": "^18.0.0 || ^19.0.0",
+		"react-dom": "^18.0.0 || ^19.0.0",
+		"html2canvas": "^1.4.0"
+	},
+	"peerDependenciesMeta": {
+		"html2canvas": {
+			"optional": true
+		}
+	},
+	"dependencies": {
+		"clsx": "^2.1.1",
+		"tailwind-merge": "^3.4.0"
+	},
+	"devDependencies": {
+		"@microsoft/api-extractor": "^7.50.1",
+		"@storybook/addon-essentials": "^8.5.0",
+		"@storybook/addon-interactions": "^8.5.0",
+		"@storybook/addon-links": "^8.5.0",
+		"@storybook/blocks": "^8.5.0",
+		"@storybook/react": "^8.5.0",
+		"@storybook/react-vite": "^8.5.0",
+		"@storybook/test": "^8.5.0",
+		"@tailwindcss/vite": "^4.0.6",
+		"@testing-library/jest-dom": "^6.9.1",
+		"@testing-library/react": "^16.2.0",
+		"@types/react": "^19.2.0",
+		"@types/react-dom": "^19.2.0",
+		"@vitejs/plugin-react": "^5.0.4",
+		"eslint": "^9.0.0",
+		"jsdom": "^27.0.0",
+		"react": "^19.2.0",
+		"react-dom": "^19.2.0",
+		"storybook": "^8.5.0",
+		"tailwindcss": "^4.0.6",
+		"typescript": "^5.7.2",
+		"vite": "^6.0.0",
+		"vite-plugin-dts": "^4.5.0",
+		"vitest": "^3.0.5"
+	},
+	"keywords": [
+		"react",
+		"feedback",
+		"widget",
+		"announcements",
+		"tracey"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/project-tracey/tracey.git"
+	}
+}