userplex 0.1.0 → 1.0.1

package/dist/index.d.mts

@@ -0,0 +1,78 @@
+/**
+ * Userplex - Simple Analytics SDK
+ *
+ * Just install and use. No complex setup required.
+ *
+ * @example
+ * ```ts
+ * import Userplex from 'userplex';
+ *
+ * const userplex = new Userplex('upx_your_api_key');
+ *
+ * // Track events
+ * await userplex.track('user123', 'button_clicked', { button: 'signup' });
+ *
+ * // Identify users
+ * await userplex.identify('user123', { email: 'user@example.com' });
+ *
+ * // Log conversations
+ * await userplex.logConversation({
+ *   messages: [
+ *     { role: 'user', content: 'Hello' },
+ *     { role: 'assistant', content: 'Hi there!' }
+ *   ]
+ * });
+ * ```
+ */
+interface ConversationMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+interface UserplexOptions {
+    /** Your Userplex instance URL (default: https://userplex.vercel.app) */
+    baseUrl?: string;
+    /** Request timeout in ms (default: 10000) */
+    timeout?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+declare class UserplexError extends Error {
+    statusCode?: number | undefined;
+    response?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: any | undefined);
+}
+declare class Userplex {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    private debug;
+    constructor(apiKey: string, options?: UserplexOptions);
+    /**
+     * Track an event
+     */
+    track(userId: string, event: string, properties?: Record<string, any>): Promise<any>;
+    /**
+     * Identify a user
+     */
+    identify(externalId: string, properties?: Record<string, any>): Promise<any>;
+    /**
+     * Log a conversation
+     */
+    logConversation(options: {
+        messages: ConversationMessage[];
+        userId?: string;
+        conversationId?: string;
+        conversationName?: string;
+    }): Promise<any>;
+    /**
+     * Batch track multiple events
+     */
+    trackBatch(events: Array<{
+        userId: string;
+        event: string;
+        properties?: Record<string, any>;
+    }>): Promise<any[]>;
+    private request;
+}
+
+export { type ConversationMessage, Userplex, UserplexError, type UserplexOptions, Userplex as default };

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Userplex - Simple Analytics SDK
+ *
+ * Just install and use. No complex setup required.
+ *
+ * @example
+ * ```ts
+ * import Userplex from 'userplex';
+ *
+ * const userplex = new Userplex('upx_your_api_key');
+ *
+ * // Track events
+ * await userplex.track('user123', 'button_clicked', { button: 'signup' });
+ *
+ * // Identify users
+ * await userplex.identify('user123', { email: 'user@example.com' });
+ *
+ * // Log conversations
+ * await userplex.logConversation({
+ *   messages: [
+ *     { role: 'user', content: 'Hello' },
+ *     { role: 'assistant', content: 'Hi there!' }
+ *   ]
+ * });
+ * ```
+ */
+interface ConversationMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+interface UserplexOptions {
+    /** Your Userplex instance URL (default: https://userplex.vercel.app) */
+    baseUrl?: string;
+    /** Request timeout in ms (default: 10000) */
+    timeout?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+declare class UserplexError extends Error {
+    statusCode?: number | undefined;
+    response?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: any | undefined);
+}
+declare class Userplex {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    private debug;
+    constructor(apiKey: string, options?: UserplexOptions);
+    /**
+     * Track an event
+     */
+    track(userId: string, event: string, properties?: Record<string, any>): Promise<any>;
+    /**
+     * Identify a user
+     */
+    identify(externalId: string, properties?: Record<string, any>): Promise<any>;
+    /**
+     * Log a conversation
+     */
+    logConversation(options: {
+        messages: ConversationMessage[];
+        userId?: string;
+        conversationId?: string;
+        conversationName?: string;
+    }): Promise<any>;
+    /**
+     * Batch track multiple events
+     */
+    trackBatch(events: Array<{
+        userId: string;
+        event: string;
+        properties?: Record<string, any>;
+    }>): Promise<any[]>;
+    private request;
+}
+
+export { type ConversationMessage, Userplex, UserplexError, type UserplexOptions, Userplex as default };

package/dist/index.js

@@ -0,0 +1,132 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// index.ts
+var UserplexError = class extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "UserplexError";
+  }
+};
+var Userplex = class {
+  constructor(apiKey, options = {}) {
+    if (!apiKey) {
+      throw new Error("Userplex: API key is required");
+    }
+    if (!apiKey.startsWith("upx_")) {
+      throw new Error('Userplex: API key must start with "upx_"');
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = (options.baseUrl || "https://userplex.vercel.app").replace(/\/$/, "");
+    this.timeout = options.timeout || 1e4;
+    this.debug = options.debug || false;
+  }
+  /**
+   * Track an event
+   */
+  async track(userId, event, properties) {
+    if (!userId || !event) {
+      throw new Error("userId and event are required");
+    }
+    return this.request("/api/events", {
+      userId,
+      event,
+      properties: properties || {}
+    });
+  }
+  /**
+   * Identify a user
+   */
+  async identify(externalId, properties) {
+    if (!externalId) {
+      throw new Error("externalId is required");
+    }
+    return this.request("/api/identify", {
+      externalId,
+      ...properties
+    }, {
+      "x-api-key": this.apiKey
+      // identify endpoint uses this header too
+    });
+  }
+  /**
+   * Log a conversation
+   */
+  async logConversation(options) {
+    if (!options.messages || options.messages.length === 0) {
+      throw new Error("messages array is required and cannot be empty");
+    }
+    return this.request("/api/conversations", {
+      externalUserId: options.userId,
+      conversationId: options.conversationId,
+      conversationName: options.conversationName,
+      messages: options.messages
+    });
+  }
+  /**
+   * Batch track multiple events
+   */
+  async trackBatch(events) {
+    if (!events || events.length === 0) {
+      throw new Error("events array is required and cannot be empty");
+    }
+    const promises = events.map((e) => this.track(e.userId, e.event, e.properties));
+    return Promise.all(promises);
+  }
+  async request(endpoint, data, additionalHeaders) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    if (this.debug) {
+      console.log(`[Userplex] POST ${url}`, JSON.stringify(data, null, 2));
+    }
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.apiKey}`,
+          ...additionalHeaders
+        },
+        body: JSON.stringify(data),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const responseData = await response.json();
+      if (this.debug) {
+        console.log(`[Userplex] Response:`, JSON.stringify(responseData, null, 2));
+      }
+      if (!response.ok) {
+        throw new UserplexError(
+          responseData.error || `Request failed with status ${response.status}`,
+          response.status,
+          responseData
+        );
+      }
+      return responseData;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        throw new UserplexError("Request timeout", 408);
+      }
+      if (error instanceof UserplexError) {
+        throw error;
+      }
+      throw new UserplexError(
+        error.message || "An unexpected error occurred",
+        void 0,
+        error
+      );
+    }
+  }
+};
+var index_default = Userplex;
+
+exports.Userplex = Userplex;
+exports.UserplexError = UserplexError;
+exports.default = index_default;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Userplex - Simple Analytics SDK\n * \n * Just install and use. No complex setup required.\n * \n * @example\n * ```ts\n * import Userplex from 'userplex';\n * \n * const userplex = new Userplex('upx_your_api_key');\n * \n * // Track events\n * await userplex.track('user123', 'button_clicked', { button: 'signup' });\n * \n * // Identify users\n * await userplex.identify('user123', { email: 'user@example.com' });\n * \n * // Log conversations\n * await userplex.logConversation({\n *   messages: [\n *     { role: 'user', content: 'Hello' },\n *     { role: 'assistant', content: 'Hi there!' }\n *   ]\n * });\n * ```\n */\n\nexport interface ConversationMessage {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n}\n\nexport interface UserplexOptions {\n  /** Your Userplex instance URL (default: https://userplex.vercel.app) */\n  baseUrl?: string;\n  /** Request timeout in ms (default: 10000) */\n  timeout?: number;\n  /** Enable debug logging (default: false) */\n  debug?: boolean;\n}\n\nexport class UserplexError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public response?: any\n  ) {\n    super(message);\n    this.name = 'UserplexError';\n  }\n}\n\nclass Userplex {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n  private debug: boolean;\n\n  constructor(apiKey: string, options: UserplexOptions = {}) {\n    if (!apiKey) {\n      throw new Error('Userplex: API key is required');\n    }\n    if (!apiKey.startsWith('upx_')) {\n      throw new Error('Userplex: API key must start with \"upx_\"');\n    }\n\n    this.apiKey = apiKey;\n    this.baseUrl = (options.baseUrl || 'https://userplex.vercel.app').replace(/\\/$/, '');\n    this.timeout = options.timeout || 10000;\n    this.debug = options.debug || false;\n  }\n\n  /**\n   * Track an event\n   */\n  async track(userId: string, event: string, properties?: Record<string, any>) {\n    if (!userId || !event) {\n      throw new Error('userId and event are required');\n    }\n\n    return this.request('/api/events', {\n      userId,\n      event,\n      properties: properties || {}\n    });\n  }\n\n  /**\n   * Identify a user\n   */\n  async identify(externalId: string, properties?: Record<string, any>) {\n    if (!externalId) {\n      throw new Error('externalId is required');\n    }\n\n    return this.request('/api/identify', {\n      externalId,\n      ...properties\n    }, {\n      'x-api-key': this.apiKey // identify endpoint uses this header too\n    });\n  }\n\n  /**\n   * Log a conversation\n   */\n  async logConversation(options: {\n    messages: ConversationMessage[];\n    userId?: string;\n    conversationId?: string;\n    conversationName?: string;\n  }) {\n    if (!options.messages || options.messages.length === 0) {\n      throw new Error('messages array is required and cannot be empty');\n    }\n\n    return this.request('/api/conversations', {\n      externalUserId: options.userId,\n      conversationId: options.conversationId,\n      conversationName: options.conversationName,\n      messages: options.messages\n    });\n  }\n\n  /**\n   * Batch track multiple events\n   */\n  async trackBatch(events: Array<{\n    userId: string;\n    event: string;\n    properties?: Record<string, any>;\n  }>) {\n    if (!events || events.length === 0) {\n      throw new Error('events array is required and cannot be empty');\n    }\n\n    const promises = events.map(e => this.track(e.userId, e.event, e.properties));\n    return Promise.all(promises);\n  }\n\n  private async request(endpoint: string, data: any, additionalHeaders?: Record<string, string>) {\n    const url = `${this.baseUrl}${endpoint}`;\n    \n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    if (this.debug) {\n      console.log(`[Userplex] POST ${url}`, JSON.stringify(data, null, 2));\n    }\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'Authorization': `Bearer ${this.apiKey}`,\n          ...additionalHeaders\n        },\n        body: JSON.stringify(data),\n        signal: controller.signal\n      });\n\n      clearTimeout(timeoutId);\n\n      const responseData = await response.json() as any;\n\n      if (this.debug) {\n        console.log(`[Userplex] Response:`, JSON.stringify(responseData, null, 2));\n      }\n\n      if (!response.ok) {\n        throw new UserplexError(\n          responseData.error || `Request failed with status ${response.status}`,\n          response.status,\n          responseData\n        );\n      }\n\n      return responseData;\n    } catch (error: any) {\n      clearTimeout(timeoutId);\n\n      if (error.name === 'AbortError') {\n        throw new UserplexError('Request timeout', 408);\n      }\n\n      if (error instanceof UserplexError) {\n        throw error;\n      }\n\n      throw new UserplexError(\n        error.message || 'An unexpected error occurred',\n        undefined,\n        error\n      );\n    }\n  }\n}\n\nexport default Userplex;\n\n// For environments that need it separate\nexport { Userplex };\n"]}

package/dist/index.mjs

@@ -0,0 +1,126 @@
+// index.ts
+var UserplexError = class extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "UserplexError";
+  }
+};
+var Userplex = class {
+  constructor(apiKey, options = {}) {
+    if (!apiKey) {
+      throw new Error("Userplex: API key is required");
+    }
+    if (!apiKey.startsWith("upx_")) {
+      throw new Error('Userplex: API key must start with "upx_"');
+    }
+    this.apiKey = apiKey;
+    this.baseUrl = (options.baseUrl || "https://userplex.vercel.app").replace(/\/$/, "");
+    this.timeout = options.timeout || 1e4;
+    this.debug = options.debug || false;
+  }
+  /**
+   * Track an event
+   */
+  async track(userId, event, properties) {
+    if (!userId || !event) {
+      throw new Error("userId and event are required");
+    }
+    return this.request("/api/events", {
+      userId,
+      event,
+      properties: properties || {}
+    });
+  }
+  /**
+   * Identify a user
+   */
+  async identify(externalId, properties) {
+    if (!externalId) {
+      throw new Error("externalId is required");
+    }
+    return this.request("/api/identify", {
+      externalId,
+      ...properties
+    }, {
+      "x-api-key": this.apiKey
+      // identify endpoint uses this header too
+    });
+  }
+  /**
+   * Log a conversation
+   */
+  async logConversation(options) {
+    if (!options.messages || options.messages.length === 0) {
+      throw new Error("messages array is required and cannot be empty");
+    }
+    return this.request("/api/conversations", {
+      externalUserId: options.userId,
+      conversationId: options.conversationId,
+      conversationName: options.conversationName,
+      messages: options.messages
+    });
+  }
+  /**
+   * Batch track multiple events
+   */
+  async trackBatch(events) {
+    if (!events || events.length === 0) {
+      throw new Error("events array is required and cannot be empty");
+    }
+    const promises = events.map((e) => this.track(e.userId, e.event, e.properties));
+    return Promise.all(promises);
+  }
+  async request(endpoint, data, additionalHeaders) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    if (this.debug) {
+      console.log(`[Userplex] POST ${url}`, JSON.stringify(data, null, 2));
+    }
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.apiKey}`,
+          ...additionalHeaders
+        },
+        body: JSON.stringify(data),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      const responseData = await response.json();
+      if (this.debug) {
+        console.log(`[Userplex] Response:`, JSON.stringify(responseData, null, 2));
+      }
+      if (!response.ok) {
+        throw new UserplexError(
+          responseData.error || `Request failed with status ${response.status}`,
+          response.status,
+          responseData
+        );
+      }
+      return responseData;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        throw new UserplexError("Request timeout", 408);
+      }
+      if (error instanceof UserplexError) {
+        throw error;
+      }
+      throw new UserplexError(
+        error.message || "An unexpected error occurred",
+        void 0,
+        error
+      );
+    }
+  }
+};
+var index_default = Userplex;
+
+export { Userplex, UserplexError, index_default as default };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Userplex - Simple Analytics SDK\n * \n * Just install and use. No complex setup required.\n * \n * @example\n * ```ts\n * import Userplex from 'userplex';\n * \n * const userplex = new Userplex('upx_your_api_key');\n * \n * // Track events\n * await userplex.track('user123', 'button_clicked', { button: 'signup' });\n * \n * // Identify users\n * await userplex.identify('user123', { email: 'user@example.com' });\n * \n * // Log conversations\n * await userplex.logConversation({\n *   messages: [\n *     { role: 'user', content: 'Hello' },\n *     { role: 'assistant', content: 'Hi there!' }\n *   ]\n * });\n * ```\n */\n\nexport interface ConversationMessage {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n}\n\nexport interface UserplexOptions {\n  /** Your Userplex instance URL (default: https://userplex.vercel.app) */\n  baseUrl?: string;\n  /** Request timeout in ms (default: 10000) */\n  timeout?: number;\n  /** Enable debug logging (default: false) */\n  debug?: boolean;\n}\n\nexport class UserplexError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public response?: any\n  ) {\n    super(message);\n    this.name = 'UserplexError';\n  }\n}\n\nclass Userplex {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n  private debug: boolean;\n\n  constructor(apiKey: string, options: UserplexOptions = {}) {\n    if (!apiKey) {\n      throw new Error('Userplex: API key is required');\n    }\n    if (!apiKey.startsWith('upx_')) {\n      throw new Error('Userplex: API key must start with \"upx_\"');\n    }\n\n    this.apiKey = apiKey;\n    this.baseUrl = (options.baseUrl || 'https://userplex.vercel.app').replace(/\\/$/, '');\n    this.timeout = options.timeout || 10000;\n    this.debug = options.debug || false;\n  }\n\n  /**\n   * Track an event\n   */\n  async track(userId: string, event: string, properties?: Record<string, any>) {\n    if (!userId || !event) {\n      throw new Error('userId and event are required');\n    }\n\n    return this.request('/api/events', {\n      userId,\n      event,\n      properties: properties || {}\n    });\n  }\n\n  /**\n   * Identify a user\n   */\n  async identify(externalId: string, properties?: Record<string, any>) {\n    if (!externalId) {\n      throw new Error('externalId is required');\n    }\n\n    return this.request('/api/identify', {\n      externalId,\n      ...properties\n    }, {\n      'x-api-key': this.apiKey // identify endpoint uses this header too\n    });\n  }\n\n  /**\n   * Log a conversation\n   */\n  async logConversation(options: {\n    messages: ConversationMessage[];\n    userId?: string;\n    conversationId?: string;\n    conversationName?: string;\n  }) {\n    if (!options.messages || options.messages.length === 0) {\n      throw new Error('messages array is required and cannot be empty');\n    }\n\n    return this.request('/api/conversations', {\n      externalUserId: options.userId,\n      conversationId: options.conversationId,\n      conversationName: options.conversationName,\n      messages: options.messages\n    });\n  }\n\n  /**\n   * Batch track multiple events\n   */\n  async trackBatch(events: Array<{\n    userId: string;\n    event: string;\n    properties?: Record<string, any>;\n  }>) {\n    if (!events || events.length === 0) {\n      throw new Error('events array is required and cannot be empty');\n    }\n\n    const promises = events.map(e => this.track(e.userId, e.event, e.properties));\n    return Promise.all(promises);\n  }\n\n  private async request(endpoint: string, data: any, additionalHeaders?: Record<string, string>) {\n    const url = `${this.baseUrl}${endpoint}`;\n    \n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    if (this.debug) {\n      console.log(`[Userplex] POST ${url}`, JSON.stringify(data, null, 2));\n    }\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'Authorization': `Bearer ${this.apiKey}`,\n          ...additionalHeaders\n        },\n        body: JSON.stringify(data),\n        signal: controller.signal\n      });\n\n      clearTimeout(timeoutId);\n\n      const responseData = await response.json() as any;\n\n      if (this.debug) {\n        console.log(`[Userplex] Response:`, JSON.stringify(responseData, null, 2));\n      }\n\n      if (!response.ok) {\n        throw new UserplexError(\n          responseData.error || `Request failed with status ${response.status}`,\n          response.status,\n          responseData\n        );\n      }\n\n      return responseData;\n    } catch (error: any) {\n      clearTimeout(timeoutId);\n\n      if (error.name === 'AbortError') {\n        throw new UserplexError('Request timeout', 408);\n      }\n\n      if (error instanceof UserplexError) {\n        throw error;\n      }\n\n      throw new UserplexError(\n        error.message || 'An unexpected error occurred',\n        undefined,\n        error\n      );\n    }\n  }\n}\n\nexport default Userplex;\n\n// For environments that need it separate\nexport { Userplex };\n"]}

package/package.json

@@ -1,138 +1,35 @@
 {
   "name": "userplex",
-  "version": "0.1.0",
-  "description": "The official TypeScript library for the Userplex API",
-  "author": "Userplex <>",
-  "types": "./index.d.ts",
-  "main": "./index.js",
-  "type": "commonjs",
-  "repository": "github:dqnamo/userplex-typescript",
-  "license": "Apache-2.0",
-  "packageManager": "yarn@1.22.22",
+  "version": "1.0.1",
+  "description": "Simple analytics SDK for Userplex - Track events, identify users, and log conversations",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
   "files": [
-    "**/*"
+    "dist",
+    "README.md"
   ],
-  "private": false,
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
-    "test": "./scripts/test",
-    "build": "./scripts/build",
-    "format": "./scripts/format",
-    "tsn": "ts-node -r tsconfig-paths/register",
-    "lint": "./scripts/lint",
-    "fix": "./scripts/format"
+    "build": "tsup index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup index.ts --format cjs,esm --dts --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "events",
+    "userplex",
+    "observability",
+    "llm",
+    "simple"
+  ],
+  "author": "Userplex",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.0"
   },
-  "dependencies": {},
-  "exports": {
-    ".": {
-      "require": {
-        "types": "./index.d.ts",
-        "default": "./index.js"
-      },
-      "types": "./index.d.mts",
-      "default": "./index.mjs"
-    },
-    "./api-promise": {
-      "import": "./api-promise.mjs",
-      "require": "./api-promise.js"
-    },
-    "./api-promise.js": {
-      "default": "./api-promise.js"
-    },
-    "./api-promise.mjs": {
-      "default": "./api-promise.mjs"
-    },
-    "./client": {
-      "import": "./client.mjs",
-      "require": "./client.js"
-    },
-    "./client.js": {
-      "default": "./client.js"
-    },
-    "./client.mjs": {
-      "default": "./client.mjs"
-    },
-    "./core/*.mjs": {
-      "default": "./core/*.mjs"
-    },
-    "./core/*.js": {
-      "default": "./core/*.js"
-    },
-    "./core/*": {
-      "import": "./core/*.mjs",
-      "require": "./core/*.js"
-    },
-    "./error": {
-      "import": "./error.mjs",
-      "require": "./error.js"
-    },
-    "./error.js": {
-      "default": "./error.js"
-    },
-    "./error.mjs": {
-      "default": "./error.mjs"
-    },
-    "./index": {
-      "import": "./index.mjs",
-      "require": "./index.js"
-    },
-    "./index.js": {
-      "default": "./index.js"
-    },
-    "./index.mjs": {
-      "default": "./index.mjs"
-    },
-    "./resource": {
-      "import": "./resource.mjs",
-      "require": "./resource.js"
-    },
-    "./resource.js": {
-      "default": "./resource.js"
-    },
-    "./resource.mjs": {
-      "default": "./resource.mjs"
-    },
-    "./resources/*.mjs": {
-      "default": "./resources/*.mjs"
-    },
-    "./resources/*.js": {
-      "default": "./resources/*.js"
-    },
-    "./resources/*": {
-      "import": "./resources/*.mjs",
-      "require": "./resources/*.js"
-    },
-    "./resources": {
-      "import": "./resources.mjs",
-      "require": "./resources.js"
-    },
-    "./resources.js": {
-      "default": "./resources.js"
-    },
-    "./resources.mjs": {
-      "default": "./resources.mjs"
-    },
-    "./uploads": {
-      "import": "./uploads.mjs",
-      "require": "./uploads.js"
-    },
-    "./uploads.js": {
-      "default": "./uploads.js"
-    },
-    "./uploads.mjs": {
-      "default": "./uploads.mjs"
-    },
-    "./version": {
-      "import": "./version.mjs",
-      "require": "./version.js"
-    },
-    "./version.js": {
-      "default": "./version.js"
-    },
-    "./version.mjs": {
-      "default": "./version.mjs"
-    }
+  "engines": {
+    "node": ">=14.0.0"
   }
 }

package/CHANGELOG.md

@@ -1,11 +0,0 @@
-# Changelog
-
-## 0.1.0 (2025-10-02)
-
-Full Changelog: [v0.0.1...v0.1.0](https://github.com/dqnamo/userplex-typescript/compare/v0.0.1...v0.1.0)
-
-### Chores
-
-* configure new SDK language ([f3c807a](https://github.com/dqnamo/userplex-typescript/commit/f3c807a917db5485335200b72abbee05ff7959bb))
-* update SDK settings ([8e2dc80](https://github.com/dqnamo/userplex-typescript/commit/8e2dc80741576245befe8234860080e85429ce48))
-* update SDK settings ([4487b12](https://github.com/dqnamo/userplex-typescript/commit/4487b122622e1dce5caa4a364aa5c88097816bbf))

package/api-promise.d.mts

@@ -1,2 +0,0 @@
-export * from "./core/api-promise.mjs";
-//# sourceMappingURL=api-promise.d.mts.map

package/api-promise.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-promise.d.mts","sourceRoot":"","sources":["src/api-promise.ts"],"names":[],"mappings":""}

package/api-promise.d.ts

@@ -1,2 +0,0 @@
-export * from "./core/api-promise.js";
-//# sourceMappingURL=api-promise.d.ts.map

package/api-promise.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-promise.d.ts","sourceRoot":"","sources":["src/api-promise.ts"],"names":[],"mappings":""}

package/api-promise.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("./internal/tslib.js");
-/** @deprecated Import from ./core/api-promise instead */
-tslib_1.__exportStar(require("./core/api-promise.js"), exports);
-//# sourceMappingURL=api-promise.js.map

package/api-promise.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-promise.js","sourceRoot":"","sources":["src/api-promise.ts"],"names":[],"mappings":";;;AAAA,yDAAyD;AACzD,gEAAmC"}

package/api-promise.mjs

@@ -1,2 +0,0 @@
-export * from "./core/api-promise.mjs";
-//# sourceMappingURL=api-promise.mjs.map

package/api-promise.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-promise.mjs","sourceRoot":"","sources":["src/api-promise.ts"],"names":[],"mappings":""}