@rnsk/toolkits 0.0.11 → 0.0.12

package/dist/toolkits/razorpay/tools/index.js

@@ -0,0 +1,56 @@
+// @ts-nocheck
+import { createContact, getContact, getFundAccount, getSettlementRecon, getTransferReversals, listFundAccounts, listFundValidations, updateContact, } from './payouts.js';
+import { createCustomer, fetchAllCustomers, getCustomer, listCustomerTokens, updateCustomer, } from './customers.js';
+import { cancelInvoice, createInvoice, deleteInvoice, fetchAllInvoices, fetchInvoiceById, issueInvoice, sendInvoiceNotification, updateInvoice, } from './invoices.js';
+import { cancelPaymentLink, createItem, createPaymentLink, deleteItem, fetchAllPaymentLinks, fetchPaymentLink, getItem, listItems, notifyPaymentLink, updateItem, updatePaymentLink, } from './items-links.js';
+import { createOrder, fetchAllPayments, fetchAllRefundsForPayment, fetchOrderById, fetchOrders, fetchPaymentsByOrder, fetchRefunds, listDisputes, listPaymentDowntimes, updateOrder, } from './orders.js';
+export { createOrder, fetchOrders, fetchOrderById, updateOrder, fetchPaymentsByOrder, fetchAllPayments, fetchAllRefundsForPayment, fetchRefunds, listDisputes, listPaymentDowntimes, createCustomer, getCustomer, updateCustomer, fetchAllCustomers, listCustomerTokens, createInvoice, fetchAllInvoices, fetchInvoiceById, updateInvoice, deleteInvoice, issueInvoice, cancelInvoice, sendInvoiceNotification, createItem, getItem, listItems, updateItem, deleteItem, createPaymentLink, fetchPaymentLink, fetchAllPaymentLinks, updatePaymentLink, cancelPaymentLink, notifyPaymentLink, createContact, getContact, updateContact, getFundAccount, listFundAccounts, listFundValidations, getTransferReversals, getSettlementRecon, };
+const auth = 'razorpayCredentials';
+function entry(name, description, toolRef, scope) {
+    return { name, description, tool: toolRef, requiredAuth: auth, scope };
+}
+export const razorpayTools = [
+    entry('razorpayCreateAnOrder', 'Creates an order before collecting payment.', createOrder, 'write'),
+    entry('razorpayFetchOrders', 'Lists orders with filters and pagination.', fetchOrders, 'read'),
+    entry('razorpayFetchOrdersById', 'Reads one order by ID.', fetchOrderById, 'read'),
+    entry('razorpayUpdateOrder', 'Updates order metadata notes.', updateOrder, 'write'),
+    entry('razorpayFetchPaymentsByOrder', 'Lists all payment attempts for an order.', fetchPaymentsByOrder, 'read'),
+    entry('razorpayFetchAllPayments', 'Lists payments newest-first with filters.', fetchAllPayments, 'read'),
+    entry('razorpayFetchAllRefundsForAPayment', 'Lists refunds for one payment.', fetchAllRefundsForPayment, 'read'),
+    entry('razorpayFetchRefunds', 'Lists all refunds with filters.', fetchRefunds, 'read'),
+    entry('razorpayListDisputes', 'Lists chargebacks/fraud disputes.', listDisputes, 'read'),
+    entry('razorpayListPaymentDowntimes', 'Lists active payment-method downtimes.', listPaymentDowntimes, 'read'),
+    entry('razorpayCreateCustomer', 'Registers a customer for future transactions.', createCustomer, 'write'),
+    entry('razorpayGetCustomer', 'Reads one customer by ID.', getCustomer, 'read'),
+    entry('razorpayUpdateCustomer', 'Updates customer name/email/contact.', updateCustomer, 'write'),
+    entry('razorpayFetchAllCustomers', 'Lists customers with pagination.', fetchAllCustomers, 'read'),
+    entry('razorpayListCustomerTokens', 'Lists saved payment methods for a customer.', listCustomerTokens, 'read'),
+    entry('razorpayCreateInvoice', 'Creates a draft invoice with line items.', createInvoice, 'write'),
+    entry('razorpayFetchAllInvoices', 'Lists invoices with filters.', fetchAllInvoices, 'read'),
+    entry('razorpayFetchInvoiceById', 'Reads one invoice with full details.', fetchInvoiceById, 'read'),
+    entry('razorpayUpdateInvoice', 'Updates a draft invoice.', updateInvoice, 'write'),
+    entry('razorpayDeleteInvoice', 'Permanently deletes a draft invoice.', deleteInvoice, 'delete'),
+    entry('razorpayIssueAnInvoice', 'Issues a draft invoice to the customer.', issueInvoice, 'write'),
+    entry('razorpayCancelInvoice', 'Cancels an issued unpaid invoice.', cancelInvoice, 'write'),
+    entry('razorpaySendOrResendNotification', 'Sends invoice notification by email/SMS.', sendInvoiceNotification, 'write'),
+    entry('razorpayCreateItem', 'Creates a reusable invoicing item.', createItem, 'write'),
+    entry('razorpayGetItem', 'Reads one item by ID.', getItem, 'read'),
+    entry('razorpayListItems', 'Lists the item catalog with filters.', listItems, 'read'),
+    entry('razorpayUpdateItem', 'Updates item name/description/amount.', updateItem, 'write'),
+    entry('razorpayDeleteItem', 'Deletes an item unused by invoices.', deleteItem, 'delete'),
+    entry('razorpayCreatePaymentLink', 'Creates a shareable payment URL.', createPaymentLink, 'write'),
+    entry('razorpayFetchAPaymentLink', 'Reads one payment link by ID.', fetchPaymentLink, 'read'),
+    entry('razorpayFetchAllPaymentLinks', 'Lists payment links with filters.', fetchAllPaymentLinks, 'read'),
+    entry('razorpayUpdatePaymentLink', 'Updates link reference/expiry/settings.', updatePaymentLink, 'write'),
+    entry('razorpayCancelPaymentLink', 'Cancels an active payment link.', cancelPaymentLink, 'write'),
+    entry('razorpayNotifyPaymentLink', 'Sends link notification by SMS/email.', notifyPaymentLink, 'write'),
+    entry('razorpayCreateContact', 'Adds a RazorpayX payout contact.', createContact, 'write'),
+    entry('razorpayGetContact', 'Reads one payout contact.', getContact, 'read'),
+    entry('razorpayUpdateContact', 'Updates payout contact details.', updateContact, 'write'),
+    entry('razorpayGetFundAccount', 'Reads one payout destination.', getFundAccount, 'read'),
+    entry('razorpayListFundAccounts', 'Lists payout destinations with filters.', listFundAccounts, 'read'),
+    entry('razorpayListFundValidations', 'Lists bank-account validations.', listFundValidations, 'read'),
+    entry('razorpayGetTransferReversals', 'Lists Route transfer reversals.', getTransferReversals, 'read'),
+    entry('razorpayGetSettlementRecon', 'Fetches the settlement recon report.', getSettlementRecon, 'read'),
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/razorpay/tools/invoices.d.ts

@@ -0,0 +1,169 @@
+export declare const createInvoice: import("ai").Tool<{
+    lineItems: {
+        description?: string | undefined;
+        id?: string | undefined;
+        name?: string | undefined;
+        unit?: string | undefined;
+        amount?: number | undefined;
+        currency?: string | undefined;
+        quantity?: number | undefined;
+        unitAmount?: number | undefined;
+        itemId?: string | undefined;
+        taxId?: string | undefined;
+        taxRate?: number | undefined;
+        taxInclusive?: boolean | undefined;
+        hsnCode?: string | undefined;
+        sacCode?: string | undefined;
+    }[];
+    type?: string | undefined;
+    description?: string | undefined;
+    terms?: string | undefined;
+    notes?: Record<string, string> | undefined;
+    razorpayCredentials?: string | undefined;
+    amount?: number | undefined;
+    currency?: string | undefined;
+    receipt?: string | undefined;
+    partialPayment?: boolean | undefined;
+    orderId?: string | undefined;
+    paymentId?: string | undefined;
+    customerId?: string | undefined;
+    taxId?: string | undefined;
+    taxRate?: number | undefined;
+    comment?: string | undefined;
+    customer?: {
+        name: string;
+        email: string;
+        contact: string;
+        notes?: Record<string, string> | undefined;
+        gstin?: string | undefined;
+        billingAddress?: {
+            country?: string | undefined;
+            state?: string | undefined;
+            city?: string | undefined;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            zipcode?: string | undefined;
+        } | undefined;
+        shippingAddress?: {
+            country?: string | undefined;
+            state?: string | undefined;
+            city?: string | undefined;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            zipcode?: string | undefined;
+        } | undefined;
+    } | undefined;
+    expireBy?: number | undefined;
+    issuedAt?: number | undefined;
+    invoiceNumber?: string | undefined;
+    billingStart?: number | undefined;
+    billingEnd?: number | undefined;
+    smsNotify?: number | undefined;
+    emailNotify?: number | undefined;
+    groupTaxesDiscounts?: boolean | undefined;
+    viewLess?: boolean | undefined;
+    shortUrl?: boolean | undefined;
+    idempotencyKey?: string | undefined;
+}, any>;
+export declare const fetchAllInvoices: import("ai").Tool<{
+    type?: string | undefined;
+    count?: number | undefined;
+    from?: number | undefined;
+    to?: number | undefined;
+    razorpayCredentials?: string | undefined;
+    receipt?: string | undefined;
+    skip?: number | undefined;
+    paymentId?: string | undefined;
+    customerId?: string | undefined;
+}, any>;
+export declare const fetchInvoiceById: import("ai").Tool<{
+    invoiceId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const updateInvoice: import("ai").Tool<{
+    invoiceId: string;
+    type?: string | undefined;
+    date?: number | undefined;
+    description?: string | undefined;
+    terms?: string | undefined;
+    notes?: Record<string, string> | undefined;
+    razorpayCredentials?: string | undefined;
+    amount?: number | undefined;
+    currency?: string | undefined;
+    receipt?: string | undefined;
+    partialPayment?: boolean | undefined;
+    orderId?: string | undefined;
+    paymentId?: string | undefined;
+    customerId?: string | undefined;
+    taxId?: string | undefined;
+    taxRate?: number | undefined;
+    lineItems?: {
+        description?: string | undefined;
+        id?: string | undefined;
+        name?: string | undefined;
+        unit?: string | undefined;
+        amount?: number | undefined;
+        currency?: string | undefined;
+        quantity?: number | undefined;
+        unitAmount?: number | undefined;
+        itemId?: string | undefined;
+        taxId?: string | undefined;
+        taxRate?: number | undefined;
+        taxInclusive?: boolean | undefined;
+        hsnCode?: string | undefined;
+        sacCode?: string | undefined;
+    }[] | undefined;
+    comment?: string | undefined;
+    customer?: {
+        name: string;
+        email: string;
+        contact: string;
+        notes?: Record<string, string> | undefined;
+        gstin?: string | undefined;
+        billingAddress?: {
+            country?: string | undefined;
+            state?: string | undefined;
+            city?: string | undefined;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            zipcode?: string | undefined;
+        } | undefined;
+        shippingAddress?: {
+            country?: string | undefined;
+            state?: string | undefined;
+            city?: string | undefined;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            zipcode?: string | undefined;
+        } | undefined;
+    } | undefined;
+    expireBy?: number | undefined;
+    issuedAt?: number | undefined;
+    invoiceNumber?: string | undefined;
+    billingStart?: number | undefined;
+    billingEnd?: number | undefined;
+    smsNotify?: number | undefined;
+    emailNotify?: number | undefined;
+    groupTaxesDiscounts?: boolean | undefined;
+    viewLess?: boolean | undefined;
+    shortUrl?: boolean | undefined;
+    idempotencyKey?: string | undefined;
+}, any>;
+export declare const deleteInvoice: import("ai").Tool<{
+    invoiceId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const issueInvoice: import("ai").Tool<{
+    invoiceId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const cancelInvoice: import("ai").Tool<{
+    invoiceId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const sendInvoiceNotification: import("ai").Tool<{
+    medium: "email" | "sms";
+    invoiceId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+//# sourceMappingURL=invoices.d.ts.map

package/dist/toolkits/razorpay/tools/invoices.js

@@ -0,0 +1,143 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { paginationFields, razorpayCredentialsField, razorpayRequest, timeRangeFields, toSnakeCase } from './client.js';
+const addressInput = z.object({
+    line1: z.string().optional(),
+    line2: z.string().optional(),
+    city: z.string().optional(),
+    state: z.string().optional(),
+    zipcode: z.string().optional(),
+    country: z.string().optional(),
+}).describe('Billing/shipping address');
+const lineItemInput = (forUpdate) => z.object({
+    id: forUpdate ? z.string().optional().describe('Line-item ID (required to edit an existing item)') : z.string().optional(),
+    name: z.string().optional().describe('Item name'),
+    description: z.string().optional(),
+    amount: z.number().int().min(0).optional().describe('Amount in subunits (paise); 100000 = ₹1000'),
+    currency: z.string().optional().describe("ISO code, e.g. 'INR'"),
+    quantity: z.number().int().optional(),
+    unit: z.string().optional().describe("Unit, e.g. 'hours', 'pieces'"),
+    unitAmount: z.number().int().optional().describe('Unit price in subunits'),
+    itemId: z.string().optional().describe('Existing item entity ID (item_...)'),
+    taxId: z.string().optional().describe('Tax entity ID (tax_...)'),
+    taxRate: z.number().int().optional().describe('Basis points, e.g. 1800 = 18%'),
+    taxInclusive: z.boolean().optional(),
+    hsnCode: z.string().optional().describe('HSN code (goods)'),
+    sacCode: z.string().optional().describe('SAC code (services)'),
+}).describe(forUpdate ? 'Line items (include id to edit existing ones)' : 'Line items (at least one required)');
+const customerInput = z.object({
+    name: z.string().describe('Customer name'),
+    email: z.string().describe('Customer email'),
+    contact: z.string().describe('10-digit phone (India)'),
+    gstin: z.string().optional(),
+    notes: z.record(z.string()).optional(),
+    billingAddress: addressInput.optional(),
+    shippingAddress: addressInput.optional(),
+}).describe('Invoice recipient');
+const invoiceWriteFields = {
+    type: z.string().optional().describe("Type: 'invoice' or 'link'"),
+    description: z.string().optional(),
+    comment: z.string().optional(),
+    terms: z.string().optional().describe('Terms and conditions text'),
+    receipt: z.string().optional().describe('Internal reference (max 40 chars)'),
+    currency: z.string().optional().describe("ISO code, e.g. 'INR' (default INR)"),
+    amount: z.number().int().optional().describe('Total in subunits (else computed from line items)'),
+    customerId: z.string().optional().describe('Existing customer (cust_...); omit customer details when used'),
+    customer: customerInput.optional(),
+    orderId: z.string().optional().describe('Associated order (order_...)'),
+    paymentId: z.string().optional().describe('Pre-associated payment (pay_...)'),
+    expireBy: z.number().int().optional().describe('Expiry Unix time'),
+    issuedAt: z.number().int().optional().describe('Custom issue-date Unix time'),
+    invoiceNumber: z.string().optional().describe("Custom number, e.g. 'INV-2024-001'"),
+    billingStart: z.number().int().optional().describe('Billing-period start Unix time'),
+    billingEnd: z.number().int().optional().describe('Billing-period end Unix time'),
+    smsNotify: z.number().int().optional().describe('1 = send SMS, 0 = no'),
+    emailNotify: z.number().int().optional().describe('1 = send email, 0 = no'),
+    partialPayment: z.boolean().optional(),
+    groupTaxesDiscounts: z.boolean().optional(),
+    viewLess: z.boolean().optional().describe('Compact view'),
+    shortUrl: z.boolean().optional().describe('Return payment-page short URL'),
+    taxId: z.string().optional().describe('Invoice-level tax (tax_...)'),
+    taxRate: z.number().int().optional().describe('Invoice-level basis points'),
+    idempotencyKey: z.string().optional().describe('Dedupe key for safe retries'),
+    notes: z.record(z.string()).optional(),
+};
+export const createInvoice = tool({
+    description: 'Creates an invoice in draft state (update then issue when ready). Needs at least one line item; amount defaults to the line-item total.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        lineItems: z.array(lineItemInput(false)).min(1),
+        ...invoiceWriteFields,
+    }),
+    execute: async ({ razorpayCredentials, lineItems, ...rest }) => razorpayRequest(razorpayCredentials, '/invoices', {
+        method: 'POST',
+        body: toSnakeCase({ lineItems, ...rest }),
+    }, 'create invoice'),
+});
+export const fetchAllInvoices = tool({
+    description: 'Lists invoices with payment/customer/receipt/date filters and skip/count pagination.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        type: z.string().optional().describe("Entity filter, e.g. 'invoice'"),
+        paymentId: z.string().optional().describe('Filter by payment (pay_...)'),
+        customerId: z.string().optional().describe('Filter by customer (cust_...)'),
+        receipt: z.string().optional().describe('Filter by receipt number'),
+        ...timeRangeFields,
+        ...paginationFields,
+    }),
+    execute: async ({ razorpayCredentials, paymentId, customerId, ...query }) => razorpayRequest(razorpayCredentials, '/invoices', { query: { payment_id: paymentId, customer_id: customerId, ...query } }, 'fetch invoices'),
+});
+export const fetchInvoiceById = tool({
+    description: 'Reads one invoice (customer, line items, amounts, payment status).',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        invoiceId: z.string().describe("Invoice ID, e.g. 'inv_SMoSJ8FWjTVWn4'"),
+    }),
+    execute: async ({ razorpayCredentials, invoiceId }) => razorpayRequest(razorpayCredentials, `/invoices/${invoiceId}`, undefined, 'fetch invoice'),
+});
+export const updateInvoice = tool({
+    description: 'Updates a draft invoice (customer, line items — include item ids to edit, notes, dates). Draft state only.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        invoiceId: z.string().describe('Draft invoice ID to update'),
+        lineItems: z.array(lineItemInput(true)).optional(),
+        date: z.number().int().optional().describe('Invoice-date Unix time'),
+        ...invoiceWriteFields,
+    }),
+    execute: async ({ razorpayCredentials, invoiceId, lineItems, ...rest }) => razorpayRequest(razorpayCredentials, `/invoices/${invoiceId}`, { method: 'PATCH', body: toSnakeCase({ lineItems, ...rest }) }, 'update invoice'),
+});
+export const deleteInvoice = tool({
+    description: 'Permanently deletes a draft invoice. Issued/paid/cancelled invoices cannot be deleted (cancel instead).',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        invoiceId: z.string().describe('Draft invoice ID to delete'),
+    }),
+    execute: async ({ razorpayCredentials, invoiceId }) => razorpayRequest(razorpayCredentials, `/invoices/${invoiceId}`, { method: 'DELETE' }, 'delete invoice'),
+});
+export const issueInvoice = tool({
+    description: "Sends a draft invoice to the customer (status → issued). Draft state only.",
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        invoiceId: z.string().describe('Draft invoice ID to issue'),
+    }),
+    execute: async ({ razorpayCredentials, invoiceId }) => razorpayRequest(razorpayCredentials, `/invoices/${invoiceId}/issue`, { method: 'POST' }, 'issue invoice'),
+});
+export const cancelInvoice = tool({
+    description: "Cancels an issued (unpaid) invoice. Paid or already-cancelled invoices cannot be cancelled.",
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        invoiceId: z.string().describe("Issued invoice ID, e.g. 'inv_SMoRuyrkAjAttC'"),
+    }),
+    execute: async ({ razorpayCredentials, invoiceId }) => razorpayRequest(razorpayCredentials, `/invoices/${invoiceId}/cancel`, { method: 'POST' }, 'cancel invoice'),
+});
+export const sendInvoiceNotification = tool({
+    description: 'Sends or resends an invoice notification by email or SMS.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        invoiceId: z.string().describe('Invoice ID to notify about'),
+        medium: z.enum(['email', 'sms']).describe('Delivery channel'),
+    }),
+    execute: async ({ razorpayCredentials, invoiceId, medium }) => razorpayRequest(razorpayCredentials, `/invoices/${invoiceId}/notify_by/${medium}`, { method: 'POST' }, 'send invoice notification'),
+});
+//# sourceMappingURL=invoices.js.map

package/dist/toolkits/razorpay/tools/items-links.d.ts

@@ -0,0 +1,98 @@
+export declare const createItem: import("ai").Tool<{
+    name: string;
+    amount: number;
+    currency: string;
+    description?: string | undefined;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const getItem: import("ai").Tool<{
+    itemId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const listItems: import("ai").Tool<{
+    count?: number | undefined;
+    active?: boolean | undefined;
+    razorpayCredentials?: string | undefined;
+    fromTimestamp?: number | undefined;
+    toTimestamp?: number | undefined;
+    skip?: number | undefined;
+}, any>;
+export declare const updateItem: import("ai").Tool<{
+    itemId: string;
+    description?: string | undefined;
+    name?: string | undefined;
+    razorpayCredentials?: string | undefined;
+    amount?: number | undefined;
+}, any>;
+export declare const deleteItem: import("ai").Tool<{
+    itemId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const createPaymentLink: import("ai").Tool<{
+    description?: string | undefined;
+    notes?: Record<string, string> | undefined;
+    razorpayCredentials?: string | undefined;
+    amount?: number | undefined;
+    currency?: "INR" | "USD" | "EUR" | "GBP" | "AED" | "SGD" | undefined;
+    customer?: {
+        name?: string | undefined;
+        email?: string | undefined;
+        contact?: string | undefined;
+    } | undefined;
+    expireBy?: number | undefined;
+    notify?: {
+        email?: boolean | undefined;
+        sms?: boolean | undefined;
+    } | undefined;
+    reminderEnable?: boolean | undefined;
+    callbackUrl?: string | undefined;
+    callbackMethod?: string | undefined;
+    referenceId?: string | undefined;
+    acceptPartial?: boolean | undefined;
+}, any>;
+export declare const fetchPaymentLink: import("ai").Tool<{
+    plinkId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const fetchAllPaymentLinks: import("ai").Tool<{
+    count?: number | undefined;
+    from?: number | undefined;
+    to?: number | undefined;
+    razorpayCredentials?: string | undefined;
+    skip?: number | undefined;
+    paymentId?: string | undefined;
+    referenceId?: string | undefined;
+}, any>;
+export declare const updatePaymentLink: import("ai").Tool<{
+    plinkId: string;
+    description?: string | undefined;
+    notes?: Record<string, string> | undefined;
+    razorpayCredentials?: string | undefined;
+    amount?: number | undefined;
+    currency?: "INR" | "USD" | "EUR" | "GBP" | "AED" | "SGD" | undefined;
+    customer?: {
+        name?: string | undefined;
+        email?: string | undefined;
+        contact?: string | undefined;
+    } | undefined;
+    expireBy?: number | undefined;
+    notify?: {
+        email?: boolean | undefined;
+        sms?: boolean | undefined;
+    } | undefined;
+    reminderEnable?: boolean | undefined;
+    callbackUrl?: string | undefined;
+    callbackMethod?: string | undefined;
+    referenceId?: string | undefined;
+    acceptPartial?: boolean | undefined;
+}, any>;
+export declare const cancelPaymentLink: import("ai").Tool<{
+    plinkId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const notifyPaymentLink: import("ai").Tool<{
+    medium: "email" | "sms";
+    plinkId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+//# sourceMappingURL=items-links.d.ts.map

package/dist/toolkits/razorpay/tools/items-links.js

@@ -0,0 +1,131 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { paginationFields, razorpayCredentialsField, razorpayRequest, toSnakeCase } from './client.js';
+export const createItem = tool({
+    description: 'Creates a reusable product/service entry for invoicing (appears on invoices and receipts).',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        name: z.string().describe('Item name for invoices/receipts'),
+        amount: z.number().int().min(0).describe('Amount in subunits (paise); 10000 = ₹100'),
+        currency: z.string().length(3).describe("ISO code, e.g. 'INR', 'USD'"),
+        description: z.string().optional(),
+    }),
+    execute: async ({ razorpayCredentials, ...body }) => razorpayRequest(razorpayCredentials, '/items', { method: 'POST', body }, 'create item'),
+});
+export const getItem = tool({
+    description: 'Reads one item (name, amount, tax details, metadata).',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        itemId: z.string().describe("Item ID, e.g. 'item_JnQ2kRGq8Kbte3'"),
+    }),
+    execute: async ({ razorpayCredentials, itemId }) => razorpayRequest(razorpayCredentials, `/items/${itemId}`, undefined, 'get item'),
+});
+export const listItems = tool({
+    description: 'Lists the item catalog with active-status and date filters plus pagination.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        active: z.boolean().optional().describe('true = active only, false = inactive only'),
+        fromTimestamp: z.number().int().optional().describe('Items created on/after this Unix time'),
+        toTimestamp: z.number().int().optional().describe('Items created on/before this Unix time'),
+        ...paginationFields,
+    }),
+    execute: async ({ razorpayCredentials, fromTimestamp, toTimestamp, ...rest }) => razorpayRequest(razorpayCredentials, '/items', { query: { from: fromTimestamp, to: toTimestamp, ...rest } }, 'list items'),
+});
+export const updateItem = tool({
+    description: 'Updates item name/description/amount. Only provided fields change.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        itemId: z.string().describe('Item ID to update'),
+        name: z.string().optional(),
+        description: z.string().optional(),
+        amount: z.number().int().min(0).optional().describe('Amount in subunits (paise)'),
+    }),
+    execute: async ({ razorpayCredentials, itemId, ...body }) => razorpayRequest(razorpayCredentials, `/items/${itemId}`, { method: 'PATCH', body }, 'update item'),
+});
+export const deleteItem = tool({
+    description: 'Permanently deletes an item. Fails when the item is used by any invoice.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        itemId: z.string().describe('Item ID to delete'),
+    }),
+    execute: async ({ razorpayCredentials, itemId }) => razorpayRequest(razorpayCredentials, `/items/${itemId}`, { method: 'DELETE' }, 'delete item'),
+});
+const paymentLinkWriteFields = {
+    amount: z.number().int().min(100).optional().describe('Amount in subunits (paise); 100000 = ₹1000'),
+    currency: z.enum(['INR', 'USD', 'EUR', 'GBP', 'AED', 'SGD']).optional(),
+    description: z.string().optional().describe('Link purpose'),
+    customer: z.object({
+        name: z.string().optional(),
+        email: z.string().optional(),
+        contact: z.string().optional().describe('Phone in international format'),
+    }).optional(),
+    notify: z.object({
+        sms: z.boolean().optional(),
+        email: z.boolean().optional(),
+    }).optional(),
+    reminderEnable: z.boolean().optional(),
+    callbackUrl: z.string().optional().describe('Post-payment redirect URL'),
+    callbackMethod: z.string().optional().describe("Callback HTTP method: 'get' or 'post'"),
+    expireBy: z.number().int().optional().describe('Expiry Unix time (must be future)'),
+    referenceId: z.string().optional().describe('Internal reference, e.g. TS1234'),
+    acceptPartial: z.boolean().optional(),
+    notes: z.record(z.string()).optional().describe('Metadata (max 15 pairs, 256 chars each)'),
+};
+export const createPaymentLink = tool({
+    description: 'Creates a shareable payment URL (short_url) with customer, notification, expiry, and callback options.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        amount: z.number().int().min(100).describe('Amount in subunits (min 100)'),
+        currency: z.enum(['INR', 'USD', 'EUR', 'GBP', 'AED', 'SGD']),
+        ...paymentLinkWriteFields,
+    }),
+    execute: async ({ razorpayCredentials, ...body }) => razorpayRequest(razorpayCredentials, '/payment_links', { method: 'POST', body: toSnakeCase(body) }, 'create payment link'),
+});
+export const fetchPaymentLink = tool({
+    description: 'Reads one payment link (status, amounts, customer, callbacks).',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        plinkId: z.string().describe("Link ID, e.g. 'plink_FMbhpT6nqDjDei'"),
+    }),
+    execute: async ({ razorpayCredentials, plinkId }) => razorpayRequest(razorpayCredentials, `/payment_links/${plinkId}`, undefined, 'fetch payment link'),
+});
+export const fetchAllPaymentLinks = tool({
+    description: 'Lists payment links with payment/reference/date filters and skip/count pagination.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        paymentId: z.string().optional().describe('Filter by payment (pay_...)'),
+        referenceId: z.string().optional().describe('Filter by your reference'),
+        ...paginationFields,
+        from: z.number().int().optional().describe('Links created on/after this Unix time'),
+        to: z.number().int().optional().describe('Links created on/before this Unix time'),
+    }),
+    execute: async ({ razorpayCredentials, paymentId, referenceId, ...query }) => razorpayRequest(razorpayCredentials, '/payment_links', { query: { payment_id: paymentId, reference_id: referenceId, ...query } }, 'fetch payment links'),
+});
+export const updatePaymentLink = tool({
+    description: 'Updates link reference, expiry, partial-payment, notes, and reminders. Only provided fields change.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        plinkId: z.string().describe("Link ID starting with 'plink_'"),
+        ...paymentLinkWriteFields,
+    }),
+    execute: async ({ razorpayCredentials, plinkId, ...body }) => razorpayRequest(razorpayCredentials, `/payment_links/${plinkId}`, { method: 'PATCH', body: toSnakeCase(body) }, 'update payment link'),
+});
+export const cancelPaymentLink = tool({
+    description: 'Cancels an active link before expiry. Cancelled links cannot accept payments.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        plinkId: z.string().describe('Link ID to cancel'),
+    }),
+    execute: async ({ razorpayCredentials, plinkId }) => razorpayRequest(razorpayCredentials, `/payment_links/${plinkId}/cancel`, { method: 'POST' }, 'cancel payment link'),
+});
+export const notifyPaymentLink = tool({
+    description: 'Sends or resends the link notification by SMS or email.',
+    inputSchema: z.object({
+        razorpayCredentials: razorpayCredentialsField,
+        plinkId: z.string().describe('Link ID to notify about'),
+        medium: z.enum(['sms', 'email']).describe('Delivery channel'),
+    }),
+    execute: async ({ razorpayCredentials, plinkId, medium }) => razorpayRequest(razorpayCredentials, `/payment_links/${plinkId}/notify_by/${medium}`, { method: 'POST' }, 'notify payment link'),
+});
+//# sourceMappingURL=items-links.js.map

package/dist/toolkits/razorpay/tools/orders.d.ts

@@ -0,0 +1,63 @@
+export declare const createOrder: import("ai").Tool<{
+    amount: number;
+    currency: string;
+    notes?: Record<string, string> | undefined;
+    razorpayCredentials?: string | undefined;
+    receipt?: string | undefined;
+    partialPayment?: boolean | undefined;
+}, any>;
+export declare const fetchOrders: import("ai").Tool<{
+    count?: number | undefined;
+    razorpayCredentials?: string | undefined;
+    receipt?: string | undefined;
+    authorized?: number | undefined;
+    fromTimestamp?: number | undefined;
+    toTimestamp?: number | undefined;
+    skip?: number | undefined;
+}, any>;
+export declare const fetchOrderById: import("ai").Tool<{
+    orderId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const updateOrder: import("ai").Tool<{
+    orderId: string;
+    notes?: Record<string, string> | undefined;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const fetchPaymentsByOrder: import("ai").Tool<{
+    orderId: string;
+    razorpayCredentials?: string | undefined;
+}, any>;
+export declare const fetchAllPayments: import("ai").Tool<{
+    count?: number | undefined;
+    from?: number | undefined;
+    to?: number | undefined;
+    razorpayCredentials?: string | undefined;
+    skip?: number | undefined;
+}, any>;
+export declare const fetchAllRefundsForPayment: import("ai").Tool<{
+    paymentId: string;
+    count?: number | undefined;
+    razorpayCredentials?: string | undefined;
+    fromTimestamp?: number | undefined;
+    toTimestamp?: number | undefined;
+    skip?: number | undefined;
+}, any>;
+export declare const fetchRefunds: import("ai").Tool<{
+    count?: number | undefined;
+    razorpayCredentials?: string | undefined;
+    fromTimestamp?: number | undefined;
+    toTimestamp?: number | undefined;
+    skip?: number | undefined;
+}, any>;
+export declare const listDisputes: import("ai").Tool<{
+    count?: number | undefined;
+    from?: number | undefined;
+    to?: number | undefined;
+    razorpayCredentials?: string | undefined;
+    skip?: number | undefined;
+}, any>;
+export declare const listPaymentDowntimes: import("ai").Tool<{
+    razorpayCredentials?: string | undefined;
+}, any>;
+//# sourceMappingURL=orders.d.ts.map