shabaaspay-mcp-server 1.0.1

package/dist/tools/response-helpers.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validationErrorResponse = validationErrorResponse;
+exports.toolErrorResponse = toolErrorResponse;
+function baseErrorResponse(summary, environment, warnings, raw) {
+    const requestId = `req_${Date.now()}`;
+    return {
+        success: false,
+        timestamp: new Date().toISOString(),
+        data: null,
+        metadata: {
+            requestId,
+            processingTime: 0,
+            environment,
+        },
+        insights: {
+            status: 'error',
+            canProceed: false,
+            nextActions: [],
+            warnings,
+        },
+        summary,
+        ...(raw ? { raw } : {}),
+    };
+}
+function validationErrorResponse(errors, environment) {
+    const summary = `Validation failed: ${errors.join(', ')}`;
+    return baseErrorResponse(summary, environment, ['validation_error']);
+}
+function toolErrorResponse(message, environment, raw) {
+    return baseErrorResponse(message, environment, undefined, raw);
+}

package/dist/types/index.d.ts

@@ -0,0 +1,184 @@
+import { z } from 'zod';
+export interface StandardResponse<T = any> {
+    success: boolean;
+    timestamp: string;
+    data: T;
+    metadata: {
+        requestId: string;
+        processingTime: number;
+        environment: 'sandbox' | 'production';
+    };
+    insights: {
+        status: string;
+        canProceed: boolean;
+        nextActions: string[];
+        warnings?: string[];
+        business?: {
+            product: 'PayTo';
+            meaning: string;
+            readiness: {
+                canInitiatePayment: boolean;
+                reason: string;
+            };
+            limits: {
+                maximumAmount?: number;
+                currency: 'AUD';
+            };
+            cadence: {
+                frequency?: string;
+                numberOfTransactionsPermitted?: number;
+            };
+            timing: {
+                createdAt?: string;
+                endDate?: string;
+                createdDaysAgo?: number;
+                expiresInDays?: number;
+                isExpiringSoon?: boolean;
+            };
+            payerControls: string[];
+            reconciliationNotes: string[];
+            operationalChecks: string[];
+            recommendedCustomerCopy?: string;
+            riskFlags: string[];
+            references: Array<{
+                title: string;
+                url: string;
+            }>;
+        };
+    };
+    summary: string;
+    raw?: any;
+}
+export declare const PaymentAgreementSchema: z.ZodObject<{
+    payment_agreement_id: z.ZodString;
+    status: z.ZodString;
+    end_date: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    maximum_amount: z.ZodOptional<z.ZodString>;
+    extented_status: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    payment_agreement_id: string;
+    end_date?: string | undefined;
+    created_at?: string | undefined;
+    maximum_amount?: string | undefined;
+    extented_status?: string | undefined;
+}, {
+    status: string;
+    payment_agreement_id: string;
+    end_date?: string | undefined;
+    created_at?: string | undefined;
+    maximum_amount?: string | undefined;
+    extented_status?: string | undefined;
+}>;
+export type PaymentAgreement = z.infer<typeof PaymentAgreementSchema>;
+export declare const PaymentInitiationSchema: z.ZodObject<{
+    payment_initiation_id: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    payment_agreement_id: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    payment_initiation_id: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    payment_agreement_id: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    payment_initiation_id: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    payment_agreement_id: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type PaymentInitiation = z.infer<typeof PaymentInitiationSchema>;
+export interface ApiResponse<T = any> {
+    message: string;
+    data: T;
+    error_code?: string;
+}
+export declare const GetPaymentAgreementInputSchema: z.ZodObject<{
+    payment_agreement_id: z.ZodString;
+    enrich: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    include_raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    payment_agreement_id: string;
+    enrich: boolean;
+    include_raw: boolean;
+}, {
+    payment_agreement_id: string;
+    enrich?: boolean | undefined;
+    include_raw?: boolean | undefined;
+}>;
+export declare const CreatePaymentAgreementInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    maximum_amount: z.ZodString;
+    frequency: z.ZodString;
+    number_of_transactions_permitted: z.ZodNumber;
+    pay_id: z.ZodString;
+    idempotency_key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    maximum_amount: string;
+    name: string;
+    frequency: string;
+    number_of_transactions_permitted: number;
+    pay_id: string;
+    idempotency_key: string;
+}, {
+    type: string;
+    maximum_amount: string;
+    name: string;
+    frequency: string;
+    number_of_transactions_permitted: number;
+    pay_id: string;
+    idempotency_key: string;
+}>;
+export declare const InitiatePaymentInputSchema: z.ZodObject<{
+    payment_agreement_id: z.ZodString;
+    amount: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, string | number, string | number>;
+    description: z.ZodOptional<z.ZodString>;
+    enrich: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    include_raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    idempotency_key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    payment_agreement_id: string;
+    amount: string | number;
+    enrich: boolean;
+    include_raw: boolean;
+    idempotency_key: string;
+    description?: string | undefined;
+}, {
+    payment_agreement_id: string;
+    amount: string | number;
+    idempotency_key: string;
+    enrich?: boolean | undefined;
+    include_raw?: boolean | undefined;
+    description?: string | undefined;
+}>;
+export declare const GetPaymentInitiationInputSchema: z.ZodObject<{
+    payment_initiation_id: z.ZodString;
+    enrich: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    include_raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    payment_initiation_id: string;
+    enrich: boolean;
+    include_raw: boolean;
+}, {
+    payment_initiation_id: string;
+    enrich?: boolean | undefined;
+    include_raw?: boolean | undefined;
+}>;
+export declare const GetAuthTokenInputSchema: z.ZodObject<{
+    include_token_in_response: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    include_token_in_response: boolean;
+}, {
+    include_token_in_response?: boolean | undefined;
+}>;
+export interface RateLimitInfo {
+    limit: number;
+    remaining: number;
+    reset: number;
+}

package/dist/types/index.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetAuthTokenInputSchema = exports.GetPaymentInitiationInputSchema = exports.InitiatePaymentInputSchema = exports.CreatePaymentAgreementInputSchema = exports.GetPaymentAgreementInputSchema = exports.PaymentInitiationSchema = exports.PaymentAgreementSchema = void 0;
+const zod_1 = require("zod");
+// Payment Agreement Types
+exports.PaymentAgreementSchema = zod_1.z.object({
+    payment_agreement_id: zod_1.z.string(),
+    status: zod_1.z.string(),
+    end_date: zod_1.z.string().optional(),
+    created_at: zod_1.z.string().optional(),
+    maximum_amount: zod_1.z.string().optional(),
+    extented_status: zod_1.z.string().optional(),
+});
+// Payment Initiation Types
+exports.PaymentInitiationSchema = zod_1.z.object({
+    payment_initiation_id: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    amount: zod_1.z.string().optional(),
+    created_at: zod_1.z.string().optional(),
+    payment_agreement_id: zod_1.z.string().optional(),
+}).passthrough();
+// Tool input schemas
+exports.GetPaymentAgreementInputSchema = zod_1.z.object({
+    payment_agreement_id: zod_1.z.string()
+        .describe('The payment agreement ID to retrieve'),
+    enrich: zod_1.z.boolean()
+        .optional()
+        .default(true)
+        .describe('If true include business enrichment such as readiness, customer copy, operational checks and references'),
+    include_raw: zod_1.z.boolean()
+        .optional()
+        .default(false)
+        .describe('Include raw API response for debugging'),
+});
+exports.CreatePaymentAgreementInputSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Payment agreement name'),
+    type: zod_1.z.string().describe('Payment agreement type, example email'),
+    maximum_amount: zod_1.z.string().describe('Maximum amount, example 10 or 10.00'),
+    frequency: zod_1.z.string().describe('Frequency, example WEEK'),
+    number_of_transactions_permitted: zod_1.z.number().describe('Number of transactions permitted, example 1'),
+    pay_id: zod_1.z.string().describe('PayID that will be charged, example sample@shabaas.com'),
+    idempotency_key: zod_1.z.string().min(8).describe('Required idempotency key for write operations'),
+});
+exports.InitiatePaymentInputSchema = zod_1.z.object({
+    payment_agreement_id: zod_1.z.string()
+        .describe('The payment agreement ID to charge'),
+    amount: zod_1.z.union([zod_1.z.string(), zod_1.z.number()])
+        .refine(val => Number(val) > 0, 'Amount must be greater than zero')
+        .describe('Amount to charge. Use a number (e.g. 50.00) or numeric string.'),
+    description: zod_1.z.string()
+        .optional()
+        .describe('Payment description'),
+    enrich: zod_1.z.boolean()
+        .optional()
+        .default(true)
+        .describe('If true include PayTo context such as readiness, next actions, and reconciliation tips'),
+    include_raw: zod_1.z.boolean()
+        .optional()
+        .default(false)
+        .describe('Include raw API response for debugging'),
+    idempotency_key: zod_1.z.string().min(8).describe('Required idempotency key for write operations'),
+});
+// Payment initiation inputs
+exports.GetPaymentInitiationInputSchema = zod_1.z.object({
+    payment_initiation_id: zod_1.z.string()
+        .describe('The payment initiation ID to retrieve'),
+    enrich: zod_1.z.boolean()
+        .optional()
+        .default(true)
+        .describe('If true include PayTo context such as readiness, next actions, and reconciliation tips'),
+    include_raw: zod_1.z.boolean()
+        .optional()
+        .default(false)
+        .describe('Include raw API response for debugging'),
+});
+// Auth inputs
+exports.GetAuthTokenInputSchema = zod_1.z.object({
+    include_token_in_response: zod_1.z.boolean().optional().default(false)
+        .describe('If true, include the raw token string in the response data'),
+});

package/dist/worker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cloudflare Worker for ShaBaas Pay MCP Server
+ * Proxies requests to ShaBaas API with authentication and rate limiting
+ */
+interface Env {
+    SHABAAS_ENVIRONMENT: string;
+    ALLOWED_ORIGINS: string;
+    AUTH_TOKEN_MAX_AGE_MINUTES?: string;
+    POLICY_TABLE_JSON?: string;
+    [key: string]: string | undefined;
+}
+declare const _default: {
+    fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
+};
+export default _default;