proofio-sdk 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,217 @@
+/**
+ * TypeScript Types für Proofio SDK
+ *
+ * Alle API Response Types basierend auf der tatsächlichen API-Struktur
+ */
+/**
+ * Generic API Response
+ */
+export interface Response<T> {
+    data: T;
+    status: number;
+    headers: Record<string, string>;
+}
+/**
+ * Request Options
+ */
+export interface RequestOptions {
+    queryParams?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+}
+/**
+ * Pagination Options
+ */
+export interface PaginationOptions {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Review Filter Options
+ */
+export interface ReviewFilterOptions extends PaginationOptions {
+    minRating?: number;
+    maxRating?: number;
+    sentiment?: 'positive' | 'neutral' | 'negative';
+    language?: string;
+    sourceId?: string;
+    since?: string;
+}
+/**
+ * Review
+ */
+export interface Review {
+    id: string;
+    projectId: string;
+    sourceId: string;
+    rating: number;
+    text?: string;
+    title?: string;
+    authorName?: string;
+    authorAvatar?: string;
+    language?: string;
+    date: string;
+    sentiment?: 'positive' | 'neutral' | 'negative';
+    verified?: boolean;
+    source?: {
+        name: string;
+        type: string;
+    };
+}
+/**
+ * Rating Distribution
+ */
+export interface RatingDistribution {
+    1: number;
+    2: number;
+    3: number;
+    4: number;
+    5: number;
+}
+/**
+ * Sentiment Distribution
+ */
+export interface SentimentDistribution {
+    positive: number;
+    neutral: number;
+    negative: number;
+}
+/**
+ * Source Breakdown Item
+ */
+export interface SourceBreakdownItem {
+    id: string;
+    total: number;
+    averageRating: number;
+    type?: string;
+    name?: string;
+}
+/**
+ * Trend Data Point
+ */
+export interface TrendDataPoint {
+    date: string;
+    count: number;
+    avgRating: number;
+}
+/**
+ * Top Topic
+ */
+export interface TopTopic {
+    word: string;
+    count: number;
+}
+/**
+ * Insight Summary (from aggregations endpoint)
+ */
+export interface InsightSummary {
+    totalReviews: number;
+    averageRating: number;
+    ratingDistribution: RatingDistribution;
+    sentimentDistribution: SentimentDistribution;
+    sources: SourceBreakdownItem[];
+    aiSummary?: {
+        summary: string;
+        generatedAt: string;
+        reviewCount: number;
+    };
+}
+/**
+ * Insight Trends (from dashboard aggregations)
+ */
+export interface InsightTrends {
+    totalReviews: number;
+    averageRating: number;
+    ratingDistribution: RatingDistribution;
+    sentimentDistribution: SentimentDistribution;
+    thisWeekCount: number;
+    thisWeekChange: number;
+    positivePercentage: number;
+    reviewVolume: {
+        last7Days: number;
+        last30Days: number;
+        last90Days: number;
+        total: number;
+    };
+    sourceBreakdown: Record<string, {
+        count: number;
+        avgRating: number;
+        sentiment: SentimentDistribution;
+    }>;
+    sourcesMap: Record<string, {
+        name: string;
+        type: string;
+    }>;
+    trendOverTime: TrendDataPoint[];
+    topTopics: TopTopic[];
+    keyTakeaways: string[];
+    recentChanges: Array<{
+        type: string;
+        message: string;
+        date: string;
+    }>;
+    lastSync: string | null;
+}
+/**
+ * Competitor Comparison
+ */
+export interface CompetitorComparison {
+    summary: string;
+    strengths: string[];
+    weaknesses: string[];
+    opportunities: string[];
+    threats: string[];
+    keyDifferences: Array<{
+        aspect: string;
+        yourProduct: string;
+        competitor: string;
+    }>;
+    recommendations: string[];
+    generatedAt: string;
+    reviewCount: {
+        yourProduct: number;
+        competitor: number;
+    };
+}
+/**
+ * Widget Stats
+ */
+export interface WidgetStats {
+    totalReviews: number;
+    averageRating: number;
+    platforms: number;
+}
+/**
+ * Widget Settings
+ */
+export interface WidgetSettings {
+    language: 'de' | 'en';
+    theme: 'light' | 'dark';
+    showAiBadge: boolean;
+    showBranding: boolean;
+}
+/**
+ * Widget Data
+ */
+export interface WidgetData {
+    stats: WidgetStats;
+    settings: WidgetSettings;
+}
+/**
+ * Widget Config Options
+ */
+export interface WidgetConfigOptions {
+    language?: 'de' | 'en';
+    theme?: 'light' | 'dark';
+    showAiBadge?: boolean;
+    showBranding?: boolean;
+}
+/**
+ * API Error Response
+ */
+export interface ApiError {
+    error: string;
+    message?: string;
+    code?: string;
+    requestId?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Proofio Error Handling
+ *
+ * Normalized error class for all SDK errors
+ */
+export interface ProofioErrorData {
+    message: string;
+    status: number;
+    code: string;
+    requestId?: string;
+    retryAfter?: number;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+}
+export declare class ProofioError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId?: string;
+    readonly retryAfter?: number;
+    readonly rateLimitRemaining?: number;
+    readonly rateLimitReset?: number;
+    constructor(data: ProofioErrorData);
+    /**
+     * Check if error is retryable
+     */
+    isRetryable(): boolean;
+    /**
+     * Convert to JSON (sanitized, no sensitive data)
+     */
+    toJSON(): Record<string, any>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnC,SAAgB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3C,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAA;gBAE3B,IAAI,EAAE,gBAAgB;IAgBlC;;OAEG;IACH,WAAW,IAAI,OAAO;IAStB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAY9B"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "proofio-sdk",
+  "version": "1.0.0",
+  "description": "Official Proofio JavaScript/TypeScript SDK",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "proofio",
+    "reviews",
+    "api",
+    "sdk",
+    "typescript",
+    "javascript"
+  ],
+  "author": "Proofio",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rimraf": "^6.1.2",
+    "typescript": "^5.3.0"
+  }
+}