syntro-sdk 1.0.0

package/dist/index.js

@@ -0,0 +1,305 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Syntro: () => Syntro
+});
+module.exports = __toCommonJS(index_exports);
+var Syntro = class {
+  constructor(apiKey, config = {}) {
+    if (!apiKey) throw new Error("[Syntro] apiKey is required");
+    this.apiKey = apiKey;
+    this.baseUrl = (config.baseUrl ?? "https://api.syntro.run").replace(/\/$/, "");
+  }
+  // ─── Helpers ────────────────────────────────────────────────────────────────
+  get headers() {
+    return { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}` };
+  }
+  async post(path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return res.json();
+  }
+  async put(path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "PUT",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return res.json();
+  }
+  async patch(path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "PATCH",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return res.json();
+  }
+  async del(path) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    return res.json();
+  }
+  async get(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, String(v)));
+    const res = await fetch(url.toString(), { method: "GET", headers: this.headers });
+    return res.json();
+  }
+  // ─── Events ─────────────────────────────────────────────────────────────────
+  /**
+   * Track an event.
+   * @param type     - 'CUSTOM' | 'ERROR' | 'AUTH'
+   * @param name     - Short event key, e.g. 'cart_add'
+   * @param message  - Optional description
+   * @param metadata - Optional arbitrary JSON
+   * @param userId   - Optional ProjectUser ID
+   */
+  async event(type, name, message, metadata, userId) {
+    try {
+      return await this.post("/v1/events", { type, name, message, metadata, userId });
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Track an ERROR event.
+   * @example
+   * await syntro.sendError('checkout_failed', 'Error loading page', { code: 500 });
+   */
+  async sendError(name, message, metadata) {
+    return this.event("ERROR", name, message, metadata);
+  }
+  /** Get event statistics grouped by name (for analytics dashboard). */
+  async getStats(type) {
+    return this.get("/v1/events/stats", type ? { type } : {});
+  }
+  /** List raw events with pagination. */
+  async listEvents(options) {
+    return this.get("/v1/events", {
+      ...options?.type ? { type: options.type } : {},
+      ...options?.limit !== void 0 ? { limit: options.limit } : {},
+      ...options?.skip !== void 0 ? { skip: options.skip } : {}
+    });
+  }
+  // ─── Auth ────────────────────────────────────────────────────────────────────
+  /**
+   * Register a new end-user.
+   * @example
+   * const { user, token, error } = await syntro.register('john', 'john@email.com', 'pass123');
+   */
+  async register(username, email, password) {
+    try {
+      const res = await this.post(
+        "/v1/auth/register",
+        { username, email, password }
+      );
+      return res.error || res.message && !res.success ? { success: false, error: res.error ?? res.message } : res;
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Login with username + password.
+   * @example
+   * const { token, user, error } = await syntro.login('john', 'pass123');
+   */
+  async login(username, password) {
+    try {
+      const res = await this.post("/v1/auth/login", { username, password });
+      return res.error ? { success: false, error: res.error } : res;
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Login with email + password.
+   */
+  async loginWithEmail(email, password) {
+    try {
+      const res = await this.post("/v1/auth/login", { email, password });
+      return res.error ? { success: false, error: res.error } : res;
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Verify a JWT token and get the associated user.
+   * @example
+   * const { valid, user } = await syntro.verifyToken(token);
+   */
+  async verifyToken(token) {
+    try {
+      return await this.post("/v1/auth/verify", { token });
+    } catch (err) {
+      return { valid: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Get a ProjectUser by ID.
+   * @example
+   * const { user } = await syntro.getUser(userId);
+   */
+  async getUser(userId) {
+    try {
+      return await this.get(`/v1/auth/users/${userId}`);
+    } catch (err) {
+      return { error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Get a user's username by ID.
+   * @example
+   * const username = await syntro.getUsername(userId);
+   */
+  async getUsername(userId) {
+    const { user, error } = await this.getUser(userId);
+    if (error || !user) return null;
+    return user.username ?? null;
+  }
+  /**
+   * Get a user's email by ID.
+   * @example
+   * const email = await syntro.getUserEmail(userId);
+   */
+  async getUserEmail(userId) {
+    const { user, error } = await this.getUser(userId);
+    if (error || !user) return null;
+    return user.email ?? null;
+  }
+  /**
+   * Get a user's metadata by ID.
+   * @example
+   * const meta = await syntro.getMetadata(userId);
+   * console.log(meta?.plan, meta?.role);
+   */
+  async getMetadata(userId) {
+    const { user, error } = await this.getUser(userId);
+    if (error || !user) return null;
+    return user.metadata ?? {};
+  }
+  /**
+   * Merge-update a user's metadata. Existing keys are preserved.
+   * @example
+   * await syntro.updateMetadata(userId, { plan: 'pro', role: 'admin' });
+   */
+  async updateMetadata(userId, metadata) {
+    try {
+      return await this.patch(`/v1/auth/users/${userId}/metadata`, metadata);
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Update a user's username or fully replace their metadata.
+   * @example
+   * await syntro.updateUser(userId, { username: 'new_name' });
+   */
+  async updateUser(userId, data) {
+    try {
+      return await this.put(`/v1/auth/users/${userId}`, data);
+    } catch (err) {
+      return { error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Delete a ProjectUser permanently.
+   * @example
+   * const { success } = await syntro.deleteUser(userId);
+   */
+  async deleteUser(userId) {
+    try {
+      return await this.del(`/v1/auth/users/${userId}`);
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /** List users with pagination. */
+  async listUsers(options) {
+    return this.get("/v1/auth/users", {
+      ...options?.limit !== void 0 ? { limit: options.limit } : {},
+      ...options?.skip !== void 0 ? { skip: options.skip } : {}
+    });
+  }
+  // ─── Billing ─────────────────────────────────────────────────────────────────
+  /**
+   * Create a Stripe Checkout payment session.
+   * Returns a `url` to redirect the customer to.
+   *
+   * @param name         - Product/payment name
+   * @param amount       - Amount in cents (e.g. 999 = $9.99)
+   * @param options      - currency, successUrl, cancelUrl, customerEmail
+   *
+   * @example
+   * const { url, error } = await syntro.createPayment('Pro Plan', 999);
+   * if (url) window.location.href = url;
+   */
+  async createPayment(name, amount, options) {
+    try {
+      const res = await this.post("/v1/billing/create-payment", {
+        name,
+        amount,
+        currency: options?.currency ?? "usd",
+        successUrl: options?.successUrl,
+        cancelUrl: options?.cancelUrl,
+        customerEmail: options?.customerEmail
+      });
+      return res.error ? { error: res.error } : res;
+    } catch (err) {
+      return { error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /** List payment transactions. */
+  async listTransactions(options) {
+    return this.get("/v1/billing/transactions", {
+      ...options?.limit !== void 0 ? { limit: options.limit } : {},
+      ...options?.skip !== void 0 ? { skip: options.skip } : {},
+      ...options?.status ? { status: options.status } : {}
+    });
+  }
+  /**
+   * Verify if a customer has paid for a specific product or any product.
+   *
+   * @example
+   * const { paid, transaction } = await syntro.verifyPayment('customer@email.com');
+   * if (paid) console.log('Customer paid!', transaction.amount);
+   */
+  async verifyPayment(customerEmail, options) {
+    try {
+      return await this.get("/v1/billing/verify-payment", {
+        customerEmail,
+        ...options?.name ? { name: options.name } : {}
+      });
+    } catch (err) {
+      return { paid: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Syntro
+});

package/dist/index.mjs

@@ -0,0 +1,280 @@
+// src/index.ts
+var Syntro = class {
+  constructor(apiKey, config = {}) {
+    if (!apiKey) throw new Error("[Syntro] apiKey is required");
+    this.apiKey = apiKey;
+    this.baseUrl = (config.baseUrl ?? "https://api.syntro.run").replace(/\/$/, "");
+  }
+  // ─── Helpers ────────────────────────────────────────────────────────────────
+  get headers() {
+    return { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}` };
+  }
+  async post(path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return res.json();
+  }
+  async put(path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "PUT",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return res.json();
+  }
+  async patch(path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "PATCH",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return res.json();
+  }
+  async del(path) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    return res.json();
+  }
+  async get(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, String(v)));
+    const res = await fetch(url.toString(), { method: "GET", headers: this.headers });
+    return res.json();
+  }
+  // ─── Events ─────────────────────────────────────────────────────────────────
+  /**
+   * Track an event.
+   * @param type     - 'CUSTOM' | 'ERROR' | 'AUTH'
+   * @param name     - Short event key, e.g. 'cart_add'
+   * @param message  - Optional description
+   * @param metadata - Optional arbitrary JSON
+   * @param userId   - Optional ProjectUser ID
+   */
+  async event(type, name, message, metadata, userId) {
+    try {
+      return await this.post("/v1/events", { type, name, message, metadata, userId });
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Track an ERROR event.
+   * @example
+   * await syntro.sendError('checkout_failed', 'Error loading page', { code: 500 });
+   */
+  async sendError(name, message, metadata) {
+    return this.event("ERROR", name, message, metadata);
+  }
+  /** Get event statistics grouped by name (for analytics dashboard). */
+  async getStats(type) {
+    return this.get("/v1/events/stats", type ? { type } : {});
+  }
+  /** List raw events with pagination. */
+  async listEvents(options) {
+    return this.get("/v1/events", {
+      ...options?.type ? { type: options.type } : {},
+      ...options?.limit !== void 0 ? { limit: options.limit } : {},
+      ...options?.skip !== void 0 ? { skip: options.skip } : {}
+    });
+  }
+  // ─── Auth ────────────────────────────────────────────────────────────────────
+  /**
+   * Register a new end-user.
+   * @example
+   * const { user, token, error } = await syntro.register('john', 'john@email.com', 'pass123');
+   */
+  async register(username, email, password) {
+    try {
+      const res = await this.post(
+        "/v1/auth/register",
+        { username, email, password }
+      );
+      return res.error || res.message && !res.success ? { success: false, error: res.error ?? res.message } : res;
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Login with username + password.
+   * @example
+   * const { token, user, error } = await syntro.login('john', 'pass123');
+   */
+  async login(username, password) {
+    try {
+      const res = await this.post("/v1/auth/login", { username, password });
+      return res.error ? { success: false, error: res.error } : res;
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Login with email + password.
+   */
+  async loginWithEmail(email, password) {
+    try {
+      const res = await this.post("/v1/auth/login", { email, password });
+      return res.error ? { success: false, error: res.error } : res;
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Verify a JWT token and get the associated user.
+   * @example
+   * const { valid, user } = await syntro.verifyToken(token);
+   */
+  async verifyToken(token) {
+    try {
+      return await this.post("/v1/auth/verify", { token });
+    } catch (err) {
+      return { valid: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Get a ProjectUser by ID.
+   * @example
+   * const { user } = await syntro.getUser(userId);
+   */
+  async getUser(userId) {
+    try {
+      return await this.get(`/v1/auth/users/${userId}`);
+    } catch (err) {
+      return { error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Get a user's username by ID.
+   * @example
+   * const username = await syntro.getUsername(userId);
+   */
+  async getUsername(userId) {
+    const { user, error } = await this.getUser(userId);
+    if (error || !user) return null;
+    return user.username ?? null;
+  }
+  /**
+   * Get a user's email by ID.
+   * @example
+   * const email = await syntro.getUserEmail(userId);
+   */
+  async getUserEmail(userId) {
+    const { user, error } = await this.getUser(userId);
+    if (error || !user) return null;
+    return user.email ?? null;
+  }
+  /**
+   * Get a user's metadata by ID.
+   * @example
+   * const meta = await syntro.getMetadata(userId);
+   * console.log(meta?.plan, meta?.role);
+   */
+  async getMetadata(userId) {
+    const { user, error } = await this.getUser(userId);
+    if (error || !user) return null;
+    return user.metadata ?? {};
+  }
+  /**
+   * Merge-update a user's metadata. Existing keys are preserved.
+   * @example
+   * await syntro.updateMetadata(userId, { plan: 'pro', role: 'admin' });
+   */
+  async updateMetadata(userId, metadata) {
+    try {
+      return await this.patch(`/v1/auth/users/${userId}/metadata`, metadata);
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Update a user's username or fully replace their metadata.
+   * @example
+   * await syntro.updateUser(userId, { username: 'new_name' });
+   */
+  async updateUser(userId, data) {
+    try {
+      return await this.put(`/v1/auth/users/${userId}`, data);
+    } catch (err) {
+      return { error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /**
+   * Delete a ProjectUser permanently.
+   * @example
+   * const { success } = await syntro.deleteUser(userId);
+   */
+  async deleteUser(userId) {
+    try {
+      return await this.del(`/v1/auth/users/${userId}`);
+    } catch (err) {
+      return { success: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /** List users with pagination. */
+  async listUsers(options) {
+    return this.get("/v1/auth/users", {
+      ...options?.limit !== void 0 ? { limit: options.limit } : {},
+      ...options?.skip !== void 0 ? { skip: options.skip } : {}
+    });
+  }
+  // ─── Billing ─────────────────────────────────────────────────────────────────
+  /**
+   * Create a Stripe Checkout payment session.
+   * Returns a `url` to redirect the customer to.
+   *
+   * @param name         - Product/payment name
+   * @param amount       - Amount in cents (e.g. 999 = $9.99)
+   * @param options      - currency, successUrl, cancelUrl, customerEmail
+   *
+   * @example
+   * const { url, error } = await syntro.createPayment('Pro Plan', 999);
+   * if (url) window.location.href = url;
+   */
+  async createPayment(name, amount, options) {
+    try {
+      const res = await this.post("/v1/billing/create-payment", {
+        name,
+        amount,
+        currency: options?.currency ?? "usd",
+        successUrl: options?.successUrl,
+        cancelUrl: options?.cancelUrl,
+        customerEmail: options?.customerEmail
+      });
+      return res.error ? { error: res.error } : res;
+    } catch (err) {
+      return { error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+  /** List payment transactions. */
+  async listTransactions(options) {
+    return this.get("/v1/billing/transactions", {
+      ...options?.limit !== void 0 ? { limit: options.limit } : {},
+      ...options?.skip !== void 0 ? { skip: options.skip } : {},
+      ...options?.status ? { status: options.status } : {}
+    });
+  }
+  /**
+   * Verify if a customer has paid for a specific product or any product.
+   *
+   * @example
+   * const { paid, transaction } = await syntro.verifyPayment('customer@email.com');
+   * if (paid) console.log('Customer paid!', transaction.amount);
+   */
+  async verifyPayment(customerEmail, options) {
+    try {
+      return await this.get("/v1/billing/verify-payment", {
+        customerEmail,
+        ...options?.name ? { name: options.name } : {}
+      });
+    } catch (err) {
+      return { paid: false, error: err instanceof Error ? err.message : "Unknown error" };
+    }
+  }
+};
+export {
+  Syntro
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "syntro-sdk",
+  "version": "1.0.0",
+  "description": "Official JavaScript/TypeScript SDK for Syntro BaaS",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "node dist/index.cjs"
+  },
+  "keywords": ["syntro", "baas", "sdk", "analytics", "auth"],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "@types/node": "^22.14.0"
+  }
+}