@henrylabs-interview/payment-processor 0.2.10 → 0.2.12

package/README.md

@@ -56,7 +56,7 @@ Operations may:
 ## Initialize (Backend)
 
 ```ts
-import { PaymentProcessor } from 'henry-labs/take-home';
+import { PaymentProcessor } from '@henrylabs-interview/payment-processor';
 
 const processor = new PaymentProcessor({
 	apiKey: ...,
@@ -109,7 +109,7 @@ The SDK provides an optional embeddable checkout UI for collecting card details
 ## Initialize Embedded Checkout
 
 ```ts
-import { EmbeddedCheckout } from 'henry-labs/take-home';
+import { EmbeddedCheckout } from '@henrylabs-interview/payment-processor';
 
 const embedded = new EmbeddedCheckout({
 	checkoutId: 'chk_123',
@@ -121,7 +121,7 @@ const embedded = new EmbeddedCheckout({
 ## Render Embedded Checkout
 
 ```ts
-embedded.render('checkout-container', (paymentToken) => {
+embedded.render('#checkout-container', (paymentToken) => {
 	console.log('Received payment token:', paymentToken);
 
 	// Send token to backend for confirmation

package/dist/resources/checkout.d.ts

@@ -1,5 +1,6 @@
 type CheckoutCreateResponse = CheckoutCreateSuccessDeferred | CheckoutCreateSuccessImmediate | CheckoutCreateFailure;
 interface CheckoutCreateGeneric {
+    _reqId: string;
     status: 'success' | 'failure';
     code: number;
     message: string;
@@ -42,6 +43,7 @@ interface CheckoutConfirmParamsRawCard extends CheckoutConfirmParamsGeneric {
 }
 type CheckoutConfirmResponse = CheckoutConfirmSuccessDeferred | CheckoutConfirmSuccessImmediate | CheckoutConfirmFailure;
 interface CheckoutConfirmGeneric {
+    _reqId: string;
     status: 'success' | 'failure';
     code: number;
     message: string;

package/dist/resources/checkout.js

@@ -1,5 +1,5 @@
 import { readHistory, writeHistory } from '../utils/store';
-import { generateTimeBasedID, hashToString, signPayload } from '../utils/crypto';
+import { generateTimeBasedID, genReqId, hashToString, signPayload } from '../utils/crypto';
 import { INTERNAL_WEBHOOKS } from './webhooks';
 import { sleep } from '../utils/async';
 import { isValidCardNumber, isValidExpiry } from '../utils/card';
@@ -67,6 +67,7 @@ export class Checkout {
     validateCreate(params) {
         if (params.amount <= 0) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '500-error',
                 code: 500,
@@ -75,6 +76,7 @@ export class Checkout {
         }
         if (params.currency === 'JPY') {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '501-not-supported',
                 code: 501,
@@ -84,6 +86,7 @@ export class Checkout {
         // Simulated random internal failure
         if (Math.random() > 0.85) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '500-error',
                 code: 500,
@@ -96,6 +99,7 @@ export class Checkout {
         const resCase = this.determineResponseCase(params.amount, duplicateCount);
         if (resCase === 'failure-retry') {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '503-retry',
                 code: 503,
@@ -104,6 +108,7 @@ export class Checkout {
         }
         if (resCase === 'failure-fraud') {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '502-fraud',
                 code: 502,
@@ -113,6 +118,7 @@ export class Checkout {
         const checkoutId = await this.createCheckoutRecord(hashId);
         if (resCase === 'success-deferred') {
             return {
+                _reqId: genReqId(),
                 status: 'success',
                 substatus: '202-deferred',
                 code: 202,
@@ -120,6 +126,7 @@ export class Checkout {
             };
         }
         return {
+            _reqId: genReqId(),
             status: 'success',
             substatus: '201-immediate',
             code: 201,
@@ -142,10 +149,10 @@ export class Checkout {
         setTimeout(async () => {
             // Deferred flow resolves later
             if (response.status === 'success' && response.substatus === '202-deferred') {
-                const isSuccess = Math.random() > 0.35;
-                if (isSuccess) {
+                if (Math.random() > 0.2) {
                     const checkoutId = await this.createCheckoutRecord(hashId);
                     this.sendWebhookResponse('checkout.create', {
+                        _reqId: response._reqId,
                         status: 'success',
                         substatus: '201-immediate',
                         code: 201,
@@ -156,8 +163,18 @@ export class Checkout {
                         },
                     });
                 }
+                else if (Math.random() > 0.05) {
+                    this.sendWebhookResponse('checkout.create', {
+                        _reqId: response._reqId,
+                        status: 'failure',
+                        substatus: '503-retry',
+                        code: 503,
+                        message: 'Server error, please retry the request',
+                    });
+                }
                 else {
                     this.sendWebhookResponse('checkout.create', {
+                        _reqId: response._reqId,
                         status: 'failure',
                         substatus: '502-fraud',
                         code: 502,
@@ -182,6 +199,7 @@ export class Checkout {
     async validateConfirm(params) {
         if (`${params.checkoutId}`.length !== 20 || !`${params.checkoutId}`.startsWith('cki_')) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '500-error',
                 code: 500,
@@ -190,6 +208,7 @@ export class Checkout {
         }
         if (!INTERNAL_CHECKOUTS[`${params.checkoutId}`]) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '503-retry',
                 code: 504,
@@ -199,6 +218,7 @@ export class Checkout {
         if (params.type === 'embedded') {
             if (params.data.paymentToken.length !== 20 || !params.data.paymentToken.startsWith('pmt_')) {
                 return {
+                    _reqId: genReqId(),
                     status: 'failure',
                     substatus: '500-error',
                     code: 500,
@@ -210,6 +230,7 @@ export class Checkout {
             const paymentToken = `pmt_${await generateTimeBasedID('payment-token')}`;
             if (params.data.paymentToken !== paymentToken) {
                 return {
+                    _reqId: genReqId(),
                     status: 'failure',
                     substatus: '503-retry',
                     code: 503,
@@ -221,25 +242,28 @@ export class Checkout {
             const { number, expMonth, expYear, cvc } = params.data;
             if (!isValidCardNumber(number)) {
                 return {
+                    _reqId: genReqId(),
                     status: 'failure',
-                    substatus: '502-fraud',
-                    code: 502,
+                    substatus: '500-error',
+                    code: 500,
                     message: 'Invalid card number',
                 };
             }
             if (!isValidExpiry(expMonth, expYear)) {
                 return {
+                    _reqId: genReqId(),
                     status: 'failure',
-                    substatus: '503-retry',
-                    code: 503,
+                    substatus: '500-error',
+                    code: 500,
                     message: 'Card expired',
                 };
             }
             if (!/^\d{3,4}$/.test(cvc)) {
                 return {
+                    _reqId: genReqId(),
                     status: 'failure',
-                    substatus: '502-fraud',
-                    code: 502,
+                    substatus: '500-error',
+                    code: 500,
                     message: 'Invalid CVC',
                 };
             }
@@ -248,8 +272,9 @@ export class Checkout {
     }
     async processConfirmDecision(params) {
         const decision = Math.random();
-        if (decision > 0.85) {
+        if (decision > 0.95) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '502-fraud',
                 code: 502,
@@ -258,6 +283,7 @@ export class Checkout {
         }
         if (decision > 0.65) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '503-retry',
                 code: 503,
@@ -266,6 +292,7 @@ export class Checkout {
         }
         if (decision > 0.35) {
             return {
+                _reqId: genReqId(),
                 status: 'success',
                 substatus: '202-deferred',
                 code: 202,
@@ -278,6 +305,7 @@ export class Checkout {
         const { historyRecordId } = INTERNAL_CHECKOUTS[`${checkoutId}`] ?? {};
         if (!historyRecordId) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '500-error',
                 code: 500,
@@ -288,6 +316,7 @@ export class Checkout {
         const record = history.find((v) => v.id === historyRecordId);
         if (!record) {
             return {
+                _reqId: genReqId(),
                 status: 'failure',
                 substatus: '500-error',
                 code: 500,
@@ -302,6 +331,7 @@ export class Checkout {
                 customerId: record.customerId,
             })));
         return {
+            _reqId: genReqId(),
             status: 'success',
             substatus: '201-immediate',
             code: 201,
@@ -318,14 +348,23 @@ export class Checkout {
         const webhookDelay = Math.random() * 3000;
         setTimeout(() => {
             if (response.status === 'success' && response.substatus === '202-deferred') {
-                const isSuccess = Math.random() > 0.35;
-                if (isSuccess) {
+                if (Math.random() > 0.2) {
                     this.buildInstantConfirmSuccess(params.checkoutId).then((finalResponse) => {
                         this.sendWebhookResponse('checkout.confirm', finalResponse);
                     });
                 }
+                else if (Math.random() > 0.05) {
+                    this.sendWebhookResponse('checkout.confirm', {
+                        _reqId: response._reqId,
+                        status: 'failure',
+                        substatus: '503-retry',
+                        code: 503,
+                        message: 'Server error, please retry the request',
+                    });
+                }
                 else {
                     this.sendWebhookResponse('checkout.confirm', {
+                        _reqId: response._reqId,
                         status: 'failure',
                         substatus: '502-fraud',
                         code: 502,
@@ -343,7 +382,7 @@ export class Checkout {
         let immediateWeight = 65;
         let deferredWeight = 20;
         let retryWeight = 10;
-        let fraudWeight = 5;
+        let fraudWeight = 0;
         // --- Adjust based on repeated attempts ---
         immediateWeight -= sameRecords * 10;
         deferredWeight += sameRecords * 5;
@@ -351,16 +390,16 @@ export class Checkout {
         fraudWeight += sameRecords * 5;
         // --- Adjust based on amount ---
         if (amount > 1000) {
-            deferredWeight += 10;
-            retryWeight += 5;
+            deferredWeight += sameRecords * 5;
+            retryWeight += sameRecords * 5;
         }
         if (amount > 5000) {
-            immediateWeight -= 10;
-            retryWeight += 10;
-            fraudWeight += 10;
+            immediateWeight -= sameRecords * 5;
+            retryWeight += sameRecords * 5;
+            fraudWeight += sameRecords * 5;
         }
         if (amount > 10000) {
-            fraudWeight += 20;
+            fraudWeight += sameRecords * 5;
         }
         // Ensure no negative weights
         immediateWeight = Math.max(0, immediateWeight);
@@ -388,7 +427,7 @@ export class Checkout {
         const matchingTypes = ['checkout', baseType, eventType];
         const hooks = INTERNAL_WEBHOOKS.filter((w) => matchingTypes.includes(w.event));
         const event = {
-            id: crypto.randomUUID(),
+            uid: `_${genReqId()}_`,
             type: eventType,
             createdAt: Date.now(),
             data: response,

package/dist/resources/webhooks.d.ts

@@ -1,6 +1,6 @@
 export type EventType = 'checkout' | 'checkout.create' | 'checkout.create.success' | 'checkout.create.failure' | 'checkout.confirm' | 'checkout.confirm.success' | 'checkout.confirm.failure';
 export interface WebhookEvent {
-    id: string;
+    uid: string;
     type: EventType;
     createdAt: number;
     data: Record<string, any>;

package/dist/utils/crypto.d.ts

@@ -2,3 +2,4 @@ export declare function generateID(length?: number): number;
 export declare function generateTimeBasedID(extra?: string): Promise<string>;
 export declare function hashToString(input: string): Promise<string>;
 export declare function signPayload(payload: string, secret: string): string;
+export declare function genReqId(): string;

package/dist/utils/crypto.js

@@ -23,3 +23,6 @@ export async function hashToString(input) {
 export function signPayload(payload, secret) {
     return crypto.createHmac('sha256', secret).update(payload).digest('hex');
 }
+export function genReqId() {
+    return crypto.randomUUID().split('-')[0] ?? '';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@henrylabs-interview/payment-processor",
-	"version": "0.2.10",
+	"version": "0.2.12",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",