@genvoris/node 1.0.0

package/dist/index.mjs

@@ -0,0 +1,353 @@
+// src/errors.ts
+var GenvorisAPIError = class extends Error {
+  constructor(args) {
+    super(args.message ?? args.code);
+    this.name = "GenvorisAPIError";
+    this.status = args.status;
+    this.code = args.code;
+    this.requestId = args.requestId;
+  }
+};
+var GenvorisAuthError = class extends GenvorisAPIError {
+  constructor(args) {
+    super(args);
+    this.name = "GenvorisAuthError";
+  }
+};
+var GenvorisRateLimitError = class extends GenvorisAPIError {
+  constructor(args) {
+    super(args);
+    this.name = "GenvorisRateLimitError";
+    this.retryAfterSeconds = args.retryAfterSeconds ?? 60;
+  }
+};
+var GenvorisValidationError = class extends GenvorisAPIError {
+  constructor(args) {
+    super(args);
+    this.name = "GenvorisValidationError";
+    this.fieldErrors = args.fieldErrors ?? {};
+  }
+};
+
+// src/http.ts
+var RETRY_STATUSES = /* @__PURE__ */ new Set([429, 502, 503, 504]);
+var MAX_DELAY_MS = 8e3;
+var DEFAULT_BASE_URL = "https://genvoris.org/api/v1";
+var SDK_VERSION = "1.0.0";
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function request(config, path, opts = {}, attempt = 0) {
+  const { method = "GET", body, query } = opts;
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  let url = `${baseUrl}${path}`;
+  if (query) {
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(query)) {
+      if (v !== void 0 && v !== null) params.set(k, String(v));
+    }
+    const qs = params.toString();
+    if (qs) url += `?${qs}`;
+  }
+  const controller = new AbortController();
+  const timerId = setTimeout(
+    () => controller.abort(),
+    config.timeoutMs ?? 3e4
+  );
+  let res;
+  try {
+    res = await fetchFn(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": `genvoris-node/${SDK_VERSION}`,
+        ...config.defaultHeaders
+      },
+      body: body !== void 0 ? JSON.stringify(body) : void 0,
+      signal: controller.signal
+    });
+  } finally {
+    clearTimeout(timerId);
+  }
+  if (res.ok) {
+    if (res.status === 204) return void 0;
+    return res.json();
+  }
+  const requestId = res.headers.get("x-request-id") ?? void 0;
+  let errBody = {};
+  try {
+    errBody = await res.json();
+  } catch {
+  }
+  const code = errBody.error ?? "unknown_error";
+  const message = errBody.message ?? code;
+  if (RETRY_STATUSES.has(res.status)) {
+    const maxRetries = config.maxRetries ?? 3;
+    if (attempt < maxRetries) {
+      const base = Math.min(Math.pow(2, attempt) * 250, MAX_DELAY_MS);
+      const delay = Math.random() * base;
+      await sleep(delay);
+      return request(config, path, opts, attempt + 1);
+    }
+  }
+  const errorBase = { status: res.status, code, message, requestId };
+  if (res.status === 401 || res.status === 403) {
+    throw new GenvorisAuthError(errorBase);
+  }
+  if (res.status === 429) {
+    const retryAfter = res.headers.get("retry-after");
+    throw new GenvorisRateLimitError({
+      ...errorBase,
+      retryAfterSeconds: retryAfter ? Number(retryAfter) : 60
+    });
+  }
+  if (res.status === 400 || res.status === 422) {
+    throw new GenvorisValidationError({
+      ...errorBase,
+      fieldErrors: errBody.fieldErrors ?? {}
+    });
+  }
+  throw new GenvorisAPIError(errorBase);
+}
+
+// src/resources/customers.ts
+var CustomersResource = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /** Create or upsert an end-customer. */
+  create(params) {
+    return request(this.config, "/customers", {
+      method: "POST",
+      body: params
+    });
+  }
+  /** Retrieve a single customer by their Genvoris `id`. */
+  retrieve(id) {
+    return request(
+      this.config,
+      `/customers/${encodeURIComponent(id)}`
+    );
+  }
+  /** Update a customer's email, plan, status, or metadata. */
+  update(id, params) {
+    return request(
+      this.config,
+      `/customers/${encodeURIComponent(id)}`,
+      { method: "PATCH", body: params }
+    );
+  }
+  /** List customers with optional status filter and cursor pagination. */
+  list(params = {}) {
+    return request(this.config, "/customers", {
+      query: params
+    });
+  }
+  /** Soft-cancel a customer. Future try-ons return 402 `cancelled`. */
+  cancel(id) {
+    return request(
+      this.config,
+      `/customers/${encodeURIComponent(id)}`,
+      { method: "DELETE" }
+    );
+  }
+  /** Return the customer's current-period quota state and usage history. */
+  usage(id) {
+    return request(
+      this.config,
+      `/customers/${encodeURIComponent(id)}/usage`
+    );
+  }
+  /** List active widget sessions for this customer. */
+  sessions(id) {
+    return request(
+      this.config,
+      `/customers/${encodeURIComponent(id)}/sessions`
+    );
+  }
+};
+
+// src/resources/plans.ts
+var PlansResource = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /** List all plans. Pass `{ include_inactive: true }` to include disabled ones. */
+  list(params = {}) {
+    return request(this.config, "/plans", {
+      query: params
+    });
+  }
+  /** Create a new plan. Returns `201 Created`. */
+  create(params) {
+    return request(this.config, "/plans", {
+      method: "POST",
+      body: params
+    });
+  }
+  /** Retrieve a single plan. */
+  retrieve(id) {
+    return request(this.config, `/plans/${encodeURIComponent(id)}`);
+  }
+  /** Update any plan fields. */
+  update(id, params) {
+    return request(this.config, `/plans/${encodeURIComponent(id)}`, {
+      method: "PATCH",
+      body: params
+    });
+  }
+  /**
+   * Soft-disable a plan. Existing customers keep quota until cancelled or
+   * reassigned. The plan stops appearing in `list()` unless `include_inactive`
+   * is `true`.
+   */
+  archive(id) {
+    return request(this.config, `/plans/${encodeURIComponent(id)}`, {
+      method: "DELETE"
+    });
+  }
+};
+
+// src/resources/sessions.ts
+var SessionsResource = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Mint a short-lived widget session token for a customer.
+   *
+   * The token should be sent to your frontend and passed to the
+   * Genvoris widget — never exposed in client-side code directly.
+   */
+  mint({ customerId, ttlSeconds }) {
+    return request(
+      this.config,
+      `/customers/${encodeURIComponent(customerId)}/sessions`,
+      {
+        method: "POST",
+        body: ttlSeconds !== void 0 ? { expires_in: ttlSeconds } : void 0
+      }
+    );
+  }
+};
+
+// src/resources/webhooks.ts
+import { createHmac, timingSafeEqual } from "crypto";
+function hexToBytes(hex) {
+  if (hex.length % 2 !== 0) throw new Error("genvoris: invalid hex string");
+  const bytes = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < bytes.length; i++) {
+    bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+  }
+  return bytes;
+}
+var WebhooksResource = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /** List all webhook endpoints for your store. */
+  list() {
+    return request(this.config, "/webhooks");
+  }
+  /** Register a new webhook endpoint. */
+  create(params) {
+    return request(this.config, "/webhooks", {
+      method: "POST",
+      body: params
+    });
+  }
+  /** Send a synthetic `webhook.test` ping to the endpoint. */
+  test(id) {
+    return request(
+      this.config,
+      `/webhooks/${encodeURIComponent(id)}/test`,
+      { method: "POST" }
+    );
+  }
+  /** Delete a webhook endpoint. */
+  delete(id) {
+    return request(
+      this.config,
+      `/webhooks/${encodeURIComponent(id)}`,
+      { method: "DELETE" }
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Static helpers
+  // -------------------------------------------------------------------------
+  /**
+   * Verify the `X-Genvoris-Signature` header and return the parsed event.
+   *
+   * Throws if the signature is invalid, the timestamp is too old, or the
+   * header is malformed. Uses `crypto.timingSafeEqual` to prevent
+   * timing attacks.
+   *
+   * @example
+   * ```ts
+   * import { WebhooksResource } from '@genvoris/node';
+   *
+   * const event = WebhooksResource.verify({
+   *   payload: req.body,  // raw Buffer — do NOT parse JSON first
+   *   header: req.header('x-genvoris-signature') ?? '',
+   *   secret: process.env.GENVORIS_WEBHOOK_SECRET!,
+   * });
+   * ```
+   */
+  static verify({
+    payload,
+    header,
+    secret,
+    toleranceSeconds = 300
+  }) {
+    const raw = typeof payload === "string" ? payload : new TextDecoder().decode(payload);
+    const parts = {};
+    for (const part of header.split(",")) {
+      const eq = part.indexOf("=");
+      if (eq !== -1) parts[part.slice(0, eq).trim()] = part.slice(eq + 1).trim();
+    }
+    const { t, v1 } = parts;
+    if (!t || !v1) {
+      throw new Error("genvoris: invalid signature header \u2014 expected t=...,v1=...");
+    }
+    const ts = parseInt(t, 10);
+    if (!Number.isFinite(ts)) {
+      throw new Error("genvoris: invalid signature timestamp");
+    }
+    const age = Math.abs(Date.now() / 1e3 - ts);
+    if (age > toleranceSeconds) {
+      throw new Error(
+        `genvoris: signature timestamp too old (${Math.round(age)}s > ${toleranceSeconds}s tolerance)`
+      );
+    }
+    const expectedHex = createHmac("sha256", secret).update(`${ts}.${raw}`).digest("hex");
+    const a = hexToBytes(expectedHex);
+    const b = hexToBytes(v1);
+    if (a.length !== b.length || !timingSafeEqual(a, b)) {
+      throw new Error("genvoris: signature mismatch");
+    }
+    return JSON.parse(raw);
+  }
+};
+
+// src/index.ts
+var Genvoris = class {
+  constructor(config) {
+    if (!config?.apiKey) {
+      throw new Error("Genvoris: apiKey is required");
+    }
+    this.customers = new CustomersResource(config);
+    this.plans = new PlansResource(config);
+    this.sessions = new SessionsResource(config);
+    this.webhooks = new WebhooksResource(config);
+  }
+};
+export {
+  GenvorisAPIError,
+  GenvorisAuthError,
+  GenvorisRateLimitError,
+  GenvorisValidationError,
+  WebhooksResource,
+  Genvoris as default
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@genvoris/node",
+  "version": "1.0.0",
+  "description": "Official Node.js SDK for the Genvoris Virtual Try-On API",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "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",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "genvoris",
+    "virtual-try-on",
+    "vton",
+    "ecommerce",
+    "fashion",
+    "ai"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DevSajjadAli/genvoris-node"
+  },
+  "homepage": "https://docs.genvoris.org",
+  "bugs": {
+    "url": "https://github.com/DevSajjadAli/genvoris-node/issues",
+    "email": "support@genvoris.org"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5",
+    "tsup": "^8.0.2"
+  }
+}