@skinramp/ts-sdk 0.0.3 → 0.0.5

package/README.md

@@ -16,6 +16,8 @@ bun add @skinramp/ts-sdk
 
 ## Usage
 
+### Create a Payment
+
 ```typescript
 import Skinramp from "@skinramp/ts-sdk";
 
@@ -28,6 +30,25 @@ const paymentId = await skinramp.payments.create({
 });
 ```
 
+### Verify Webhooks
+
+```typescript
+import { Webhook } from "@skinramp/ts-sdk";
+
+const webhook = new Webhook("whsec_...");
+
+// In your webhook handler
+const event = webhook.verify(rawBody, {
+  "webhook-id": req.headers["webhook-id"],
+  "webhook-timestamp": req.headers["webhook-timestamp"],
+  "webhook-signature": req.headers["webhook-signature"],
+});
+
+// event is typed as WebhookEvent<PaymentData>
+console.log(event.type); // "payment.paid"
+console.log(event.data); // { _id, amount, status, ... }
+```
+
 ## License
 
 MIT

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import * as convex_values0 from "convex/values";
+import { GenericId } from "convex/values";
 
 //#region src/client.d.ts
 
@@ -22,8 +22,80 @@ declare class Skinramp {
       amount: number;
       gameId?: "CS2" | "ROBLOX" | "RUST";
       metadata?: Record<string, string | number | boolean>;
-    }) => Promise<convex_values0.GenericId<"payments">>;
+    }) => Promise<GenericId<"payments">>;
+    get: (paymentId: string) => Promise<{
+      _creationTime: number;
+      _id: GenericId<"payments">;
+      amount: number;
+      billingAddress?: {
+        city?: string;
+        country?: string;
+        line1?: string;
+        line2?: string;
+        name?: string;
+        postalCode?: string;
+        state?: string;
+      };
+      cardInfo?: {
+        brand?: string;
+        last4?: string;
+      };
+      gameId: "CS2" | "ROBLOX" | "RUST";
+      merchantId: GenericId<"merchants">;
+      paidAt?: number;
+      status: "PENDING" | "PAID" | "FAILED" | "BLOCKED" | "DISPUTED" | "DISPUTE_WON" | "DISPUTE_LOST" | "REFUNDED";
+      userInfo?: {
+        email?: string;
+        name?: string;
+      };
+    }>;
+  };
+}
+//#endregion
+//#region src/webhook.d.ts
+declare class WebhookVerificationError extends Error {
+  constructor(message: string);
+}
+type WebhookEventType = "payment.created" | "payment.paid" | "payment.failed" | "payment.blocked" | "payment.disputed" | "payment.dispute_won" | "payment.dispute_lost" | "payment.refunded" | "payout.created";
+interface PaymentData {
+  _id: string;
+  _creationTime: number;
+  amount: number;
+  status: "PENDING" | "PAID" | "FAILED" | "BLOCKED" | "DISPUTED" | "DISPUTE_WON" | "DISPUTE_LOST" | "REFUNDED";
+  gameId: "CS2" | "ROBLOX" | "RUST";
+  merchantId: string;
+  paidAt?: number;
+  cardInfo?: {
+    brand?: string;
+    last4?: string;
   };
+  billingAddress?: {
+    name?: string;
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+  };
+  userInfo?: {
+    name?: string;
+    email?: string;
+  };
+}
+interface WebhookEvent<T = PaymentData> {
+  id: string;
+  type: WebhookEventType;
+  timestamp: string;
+  data: T;
+}
+declare class Webhook {
+  private static prefix;
+  private readonly key;
+  constructor(secret: string);
+  verify(payload: string, headers: Record<string, string>): WebhookEvent<PaymentData>;
+  private sign;
+  private verifyTimestamp;
 }
 //#endregion
-export { Skinramp, Skinramp as default };
+export { type PaymentData, Skinramp, Skinramp as default, Webhook, type WebhookEvent, type WebhookEventType, WebhookVerificationError };

package/dist/index.mjs

@@ -1 +1 @@
-import{ConvexHttpClient as e}from"convex/browser";import{anyApi as t}from"convex/server";import"convex/values";const n=t;var r=class{convexHttp;apiKey;constructor(t,n=`https://sync.skinramp.com`){if(!t)throw Error(`API key is required`);this.apiKey=t,this.convexHttp=new e(n)}payments={create:async e=>{if(!this.apiKey)throw Error(`API key is required`);return await this.convexHttp.mutation(n.payments.createPayment,{apiKey:this.apiKey,amount:e.amount,gameId:e.gameId,metadata:e.metadata})}}};export{r as Skinramp,r as default};
+import{ConvexHttpClient as e}from"convex/browser";import"convex/values";import{anyApi as t}from"convex/server";import*as n from"@stablelib/base64";import*as r from"fast-sha256";const i=t;var a=class{convexHttp;apiKey;constructor(t,n=`https://sync.skinramp.com`){if(!t)throw Error(`API key is required`);this.apiKey=t,this.convexHttp=new e(n)}payments={create:async e=>{if(!this.apiKey)throw Error(`API key is required`);return await this.convexHttp.mutation(i.payments.createPayment,{apiKey:this.apiKey,amount:e.amount,gameId:e.gameId,metadata:e.metadata})},get:async e=>{if(!this.apiKey)throw Error(`API key is required`);return await this.convexHttp.query(i.payments.getPrivatePayment,{apiKey:this.apiKey,paymentId:e})}}},o=class extends Error{constructor(e){super(e),this.name=`WebhookVerificationError`}};function s(e,t){if(e.byteLength!==t.byteLength)return!1;let n=e instanceof DataView?e:new DataView(ArrayBuffer.isView(e)?e.buffer:e),r=t instanceof DataView?t:new DataView(ArrayBuffer.isView(t)?t.buffer:t),i=n.byteLength,a=0;for(let e=0;e<i;e++)a|=n.getUint8(e)^r.getUint8(e);return a===0}var c=class e{static prefix=`whsec_`;key;constructor(t){if(!t)throw Error(`Secret can't be empty.`);t.startsWith(e.prefix)&&(t=t.substring(e.prefix.length)),this.key=n.decode(t)}verify(e,t){let n={};for(let e of Object.keys(t))n[e.toLowerCase()]=t[e];let r=n[`webhook-id`],i=n[`webhook-signature`],a=n[`webhook-timestamp`];if(!i||!r||!a)throw new o(`Missing required headers`);let c=this.verifyTimestamp(a),l=this.sign(r,c,e),u=i.split(` `),d=new TextEncoder;for(let t of u){let[n,r]=t.split(`,`);if(n===`v1`&&s(d.encode(r),d.encode(l)))return JSON.parse(e)}throw new o(`No matching signature found`)}sign(e,t,i){let a=new TextEncoder,o=Math.floor(t.getTime()/1e3),s=a.encode(`${e}.${o}.${i}`);return n.encode(r.hmac(this.key,s))}verifyTimestamp(e){let t=Math.floor(Date.now()/1e3),n=parseInt(e,10);if(isNaN(n))throw new o(`Invalid timestamp header`);if(t-n>300)throw new o(`Message timestamp too old`);if(n>t+300)throw new o(`Message timestamp too new`);return new Date(n*1e3)}};export{a as Skinramp,a as default,c as Webhook,o as WebhookVerificationError};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skinramp/ts-sdk",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Skinramp TypeScript SDK",
   "license": "MIT",
   "homepage": "https://skinramp.com",
@@ -32,6 +32,8 @@
     "vitest": "^4.0.16"
   },
   "dependencies": {
-    "convex": "^1.31.2"
+    "@stablelib/base64": "^2.0.0",
+    "convex": "^1.31.2",
+    "fast-sha256": "^1.3.0"
   }
 }