@rhinosaas/rebillia-mcp-server 1.0.2

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/**
+ * Rebillia MCP Server
+ * Model Context Protocol server for Rebillia API integration
+ */
+import "dotenv/config";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import RebilliaClient from "./client.js";
+import { registerResources } from "./resources/api-docs.js";
+import { executeTool, getToolDefinitions } from "./tools/index.js";
+// ============================================================================
+// Environment Configuration
+// ============================================================================
+const REBILLIA_API_KEY = process.env.REBILLIA_API_KEY;
+if (!REBILLIA_API_KEY) {
+    throw new Error("REBILLIA_API_KEY environment variable is required");
+}
+const REBILLIA_API_URL = process.env.REBILLIA_API_URL || "https://api.rebillia.com/v1";
+// ============================================================================
+// Initialize Rebillia Client
+// ============================================================================
+const rebilliaClient = new RebilliaClient(REBILLIA_API_KEY, REBILLIA_API_URL);
+// ============================================================================
+// Initialize MCP Server
+// ============================================================================
+const server = new Server({
+    name: "rebillia-mcp-server",
+    version: "1.0",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// ============================================================================
+// Resources (rebillia://docs/* – overview, models, subscription-statuses, charge-types)
+// ============================================================================
+registerResources(server);
+// ============================================================================
+// Handle tools/list
+// ============================================================================
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: getToolDefinitions(),
+    };
+});
+// ============================================================================
+// Handle tools/call
+// ============================================================================
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        const result = await executeTool(name, args, rebilliaClient);
+        if (result) {
+            return result;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Unknown tool: ${name}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// ============================================================================
+// Start Server
+// ============================================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Rebillia MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":""}

package/dist/prompts/index.js

@@ -0,0 +1,3 @@
+export {};
+// Prompt implementations
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";AAAA,yBAAyB"}

package/dist/resources/api-docs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Rebillia API documentation resources for MCP.
+ * All docs are self-contained; do not fetch external URLs (e.g. apiguide.rebillia.com).
+ * Backend reference: RebilliaServer PublicAPI
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare const RESOURCE_URI_PREFIX = "rebillia://api/";
+export declare const DOCS_URI_PREFIX = "rebillia://docs/";
+export interface ApiResource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    text: string;
+}
+/** Doc keys supported by get_api_docs tool */
+export declare const DOC_KEYS: readonly ["overview", "models", "subscription-statuses", "charge-types"];
+export type DocKey = (typeof DOC_KEYS)[number];
+/** Get documentation markdown by key (for get_api_docs tool). Returns null if key unknown. */
+export declare function getDocContent(doc: DocKey): string | null;
+/**
+ * Register the 4 API documentation resources with the MCP server.
+ * Call this with the server instance only (no client needed).
+ * Resources appear in MCP Inspector Resources tab under rebillia://docs/*
+ */
+export declare function registerResources(server: Server): void;
+export declare const apiResources: ApiResource[];
+//# sourceMappingURL=api-docs.d.ts.map

package/dist/resources/api-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs.d.ts","sourceRoot":"","sources":["../../src/resources/api-docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMxE,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAmOD,8CAA8C;AAC9C,eAAO,MAAM,QAAQ,0EAA2E,CAAC;AACjG,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYtD;AAMD,eAAO,MAAM,YAAY,EAAE,WAAW,EA6DrC,CAAC"}

package/dist/resources/api-docs.js

@@ -0,0 +1,317 @@
+/**
+ * Rebillia API documentation resources for MCP.
+ * All docs are self-contained; do not fetch external URLs (e.g. apiguide.rebillia.com).
+ * Backend reference: RebilliaServer PublicAPI
+ */
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+export const RESOURCE_URI_PREFIX = "rebillia://api/";
+export const DOCS_URI_PREFIX = "rebillia://docs/";
+/** Four API documentation resources (rebillia://docs/*) for MCP Inspector Resources tab */
+const docResources = [
+    {
+        uri: `${DOCS_URI_PREFIX}overview`,
+        name: "Overview documentation",
+        description: "Rebillia API overview – read this first. Base URLs, authentication, pagination, date format, amount handling. Main entry point for Rebillia API docs.",
+        mimeType: "text/markdown",
+        text: `# Rebillia Public API – Overview documentation
+
+**This is the Rebillia API overview.** All reference material is in these MCP resources (rebillia://docs/*). Do not fetch external URLs; use \`resources/read\` with the URIs below. The rest of this document and the other docs contain everything needed.
+
+## Base URLs
+
+| Environment | Base URL |
+|-------------|----------|
+| Production | \`https://api.rebillia.com/v1\` |
+| Sandbox | \`https://sandboxapi.rebillia.com/v1\` |
+
+Override with \`REBILLIA_API_URL\` (include \`/v1\`).
+
+## Authentication
+
+- **Header:** \`X-AUTH-TOKEN\` (required) – your Rebillia API key
+- **Content-Type:** \`application/json\` for request bodies
+- Missing or invalid key returns \`401 Unauthorized\`
+
+## Pagination
+
+List endpoints return a paginated shape:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`currentPageNumber\` | number | Current page (1-based) |
+| \`itemsPerPage\` | number | Page size |
+| \`totalItems\` | number | Total count |
+| \`totalPages\` | number | Total pages |
+| \`data\` | array | Items for the page |
+
+**Common query params:** \`pageNo\` (default 1), \`itemPerPage\` (default 25, max 250).
+
+## Date / time format
+
+- Use **ISO 8601** when the API expects a datetime (e.g. \`newDateTime\` for bill runs): \`YYYY-MM-DDTHH:MM:SS\` or with timezone \`YYYY-MM-DDTHH:MM:SSZ\`.
+- Date-only fields often use \`YYYY-MM-DD\` (e.g. \`effectiveStartDate\`, \`dateDue\`).
+
+## Amount handling
+
+- **Invoice charge / transaction amounts:** Many endpoints use amounts in **cents** (e.g. \`5500\` = $55.00). Check per endpoint.
+- **Refund (transactions):** \`amount\` in **cents** (e.g. \`250\` = $2.50).
+- **Invoice detail line items (create):** \`amount\` as **dollar string** (e.g. \`"20.00"\`) or number in cents (converted to dollars by the tool).
+- **Shipping:** \`orderAmount\` in company currency units; \`weight\` per company metrics (oz, kg, etc.).
+
+## Other documentation resources
+
+**Do not fetch external URLs.** Use only these MCP resources. Read them via MCP \`resources/read\` with the URI:
+
+| Resource | URI | Contents |
+|----------|-----|----------|
+| **Overview** (this doc) | \`rebillia://docs/overview\` | Base URLs, auth, pagination, dates, amounts |
+| Data models | \`rebillia://docs/models\` | Domain model hierarchy and relationships |
+| Subscription statuses | \`rebillia://docs/subscription-statuses\` | active, paused, archived, requestPayment |
+| Charge types | \`rebillia://docs/charge-types\` | chargeType, chargeModel, billingPeriod, billingTiming |
+`,
+    },
+    {
+        uri: `${DOCS_URI_PREFIX}models`,
+        name: "rebillia-data-models",
+        description: "Domain model hierarchy and relationships",
+        mimeType: "text/markdown",
+        text: `# Rebillia – Domain model hierarchy and relationships
+
+High-level domain model for the Rebillia Public API (aligned with RebilliaServer entities and normalizers).
+
+## Company-scoped entities
+
+- **Company** – Tenant; all data is scoped by company (via API key).
+- **Company currency** – Currency used by the company (linked to Gbl currency); has conversion rate, fixed rate; can be default.
+- **Company gateway** – Payment gateway configuration (Stripe, etc.); has credentials (setting), display name, card types.
+- **Company integration** – Integration instance (e.g. BigCommerce, Shopify, Avalara, SMTP) per company; has section/type (ecommerce, tax, shipping, etc.).
+- **Company filter** – Saved filter (display name, section, rules) for list views (invoices, subscriptions, customers, etc.).
+
+## Core billing hierarchy
+
+\`\`\`
+Company
+  ├── Customers
+  │     ├── Address book (billing/shipping)
+  │     ├── Payment methods (customer payment method)
+  │     ├── Invoices (customer-scoped)
+  │     └── Subscriptions
+  ├── Products
+  │     └── Product rate plans
+  │           └── Product rate plan charges (chargeType, chargeModel, tiers)
+  ├── Subscriptions (customer + company currency + optional gateway)
+  │     ├── Rate plans (product rate plan, charges, quantity)
+  │     └── Rate plan charges (quantity, tier, billing period)
+  ├── Invoices (customer, currency, gateway; line items, transactions)
+  │     └── Transactions (payment/refund/void)
+  ├── Bill runs (scheduled runs; target date/time)
+  ├── Currencies (company currencies; default)
+  └── Gateways (company gateways; test connection)
+\`\`\`
+
+## Key relationships
+
+- **Subscription** → Customer, Company currency, optional Company gateway, optional payment method; contains **Rate plans** (product rate plan ref + rate plan charges).
+- **Invoice** → Customer, Company currency/gateway; has **Detail** (line items) and **Transactions**.
+- **Transaction** → Invoice (or standalone); amount, status, payment type (e.g. thirdPartyPaymentProvider).
+- **Product rate plan** → Product; has **Product rate plan charges** (charge type, model, billing period, tiers).
+- **Filter** → Section (e.g. subscriptions, invoices, customers); **Rules** (attribute, operator, setting values).
+`,
+    },
+    {
+        uri: `${DOCS_URI_PREFIX}subscription-statuses`,
+        name: "rebillia-subscription-statuses",
+        description: "Status guide (active, paused, archived, requestPayment)",
+        mimeType: "text/markdown",
+        text: `# Rebillia – Subscription statuses
+
+Subscription status values used by the Rebillia Public API (Subscription entity / SubscriptionValidator).
+
+## Status values
+
+| Status | Value | Description |
+|--------|--------|-------------|
+| **Active** | \`active\` | Subscription is active; billing and charges apply per schedule. |
+| **Paused** | \`paused\` | Subscription is paused; billing suspended until resumed. |
+| **Archived** | \`archived\` | Subscription is ended/archived; no longer active. |
+| **Request payment** | \`requestPayment\` | Payment is requested (e.g. awaiting payment). |
+
+## Usage
+
+- **List/filter:** Use \`status\` query param (e.g. \`GET /subscriptions?status=active\`).
+- **Update status:** \`PUT /subscriptions/{id}\` or dedicated status endpoint with body \`{ "status": "archived" }\` (or \`active\`, \`paused\`, \`requestPayment\` as allowed by the API).
+- **Create:** New subscriptions are typically created in \`active\` or as per API rules.
+
+## Allowed transitions
+
+- Check RebilliaServer \`SubscriptionValidator\` and subscription service for allowed status transitions (e.g. \`active\` → \`paused\`, \`active\` → \`archived\`, \`requestPayment\` → \`active\`).
+`,
+    },
+    {
+        uri: `${DOCS_URI_PREFIX}charge-types`,
+        name: "rebillia-charge-types",
+        description: "Charge type reference (chargeType, chargeModel, billingPeriod, billingTiming enums)",
+        mimeType: "text/markdown",
+        text: `# Rebillia – Charge type reference
+
+Enums for rate plan charges and product rate plan charges (RebilliaServer PublicAPI / entity constants).
+
+## chargeType
+
+| Value | Description |
+|-------|-------------|
+| \`oneTime\` | One-time charge |
+| \`recurring\` | Recurring charge (billing period applies) |
+| \`usage\` | Usage-based charge |
+
+## chargeModel
+
+| Value | Description |
+|-------|-------------|
+| \`flatFee\` | Flat fee pricing |
+| \`perUnit\` | Per-unit pricing |
+| \`tiered\` | Tiered pricing (charge tiers) |
+| \`volume\` | Volume pricing |
+| \`overage\` | Overage pricing |
+
+## billingPeriod
+
+Used for recurring charges (e.g. \`recurring\` chargeType).
+
+| Value | Description |
+|-------|-------------|
+| \`day\` | Daily |
+| \`week\` | Weekly |
+| \`month\` | Monthly |
+| \`quarter\` | Quarterly |
+| \`year\` | Yearly |
+
+## billingTiming
+
+| Value | Description |
+|-------|-------------|
+| \`inAdvance\` | Billed in advance of the period |
+| \`inArrears\` | Billed in arrears (after the period) |
+
+## Typical usage
+
+- **Create rate plan charge:** \`chargeType\`, \`chargeModel\`, \`billCycleType\`, \`category\`, \`chargeTier\` (array), \`taxable\`, \`weight\`, \`endDateCondition\`; for recurring, \`billingPeriod\` and \`billingTiming\` (and alignment) apply.
+- **Subscription rate plan charges:** Inherit from product rate plan charge; quantity and overrides per subscription.
+`,
+    },
+];
+/** List shape for MCP resources/list */
+function getDocResourcesList() {
+    return docResources.map(({ uri, name, description, mimeType }) => ({
+        uri,
+        name,
+        description,
+        mimeType,
+    }));
+}
+/** Read one resource by URI; returns MCP contents or null */
+function getDocResourceContent(uri) {
+    const resource = docResources.find((r) => r.uri === uri);
+    if (!resource)
+        return null;
+    return {
+        contents: [
+            {
+                uri: resource.uri,
+                mimeType: resource.mimeType,
+                text: resource.text,
+            },
+        ],
+    };
+}
+/** Doc keys supported by get_api_docs tool */
+export const DOC_KEYS = ["overview", "models", "subscription-statuses", "charge-types"];
+/** Get documentation markdown by key (for get_api_docs tool). Returns null if key unknown. */
+export function getDocContent(doc) {
+    const uri = `${DOCS_URI_PREFIX}${doc}`;
+    const resource = docResources.find((r) => r.uri === uri);
+    return resource ? resource.text : null;
+}
+/**
+ * Register the 4 API documentation resources with the MCP server.
+ * Call this with the server instance only (no client needed).
+ * Resources appear in MCP Inspector Resources tab under rebillia://docs/*
+ */
+export function registerResources(server) {
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return { resources: getDocResourcesList() };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const result = getDocResourceContent(request.params.uri);
+        if (!result) {
+            throw new Error(`Resource not found: ${request.params.uri}`);
+        }
+        return result;
+    });
+}
+// ============================================================================
+// Legacy api resources (rebillia://api/*) – kept for backward compatibility
+// ============================================================================
+export const apiResources = [
+    {
+        uri: `${RESOURCE_URI_PREFIX}overview`,
+        name: "Rebillia API Overview",
+        description: "Introduction to the Rebillia Public API and where to find the full reference",
+        mimeType: "text/markdown",
+        text: `# Rebillia Public API – Overview
+
+The **Rebillia Public API** lets you manage customers, subscriptions, invoices, payments, and related billing data.
+
+## Documentation
+
+Use the MCP resources (rebillia://docs/overview, models, subscription-statuses, charge-types). Do not fetch external sites.
+
+## Base URL
+
+- Production: \`https://api.rebillia.com/v1\`
+- Override with \`REBILLIA_API_URL\` if using another environment.
+
+## Authentication
+
+All requests use the **X-AUTH-TOKEN** header with your API key.
+
+## Pagination
+
+List endpoints return: \`currentPageNumber\`, \`itemsPerPage\`, \`totalItems\`, \`totalPages\`, \`data\`.
+Common query params: \`pageNo\` (default 1), \`itemPerPage\` (default 25, max 250).
+`,
+    },
+    {
+        uri: `${RESOURCE_URI_PREFIX}authentication`,
+        name: "Authentication",
+        description: "How to authenticate requests to the Rebillia Public API",
+        mimeType: "text/markdown",
+        text: `# Rebillia API – Authentication
+
+- **Header:** \`X-AUTH-TOKEN\` (required)
+- **Content-Type:** \`application/json\` for request bodies
+`,
+    },
+    {
+        uri: `${RESOURCE_URI_PREFIX}customers`,
+        name: "Customers API",
+        description: "List, get, and create customers",
+        mimeType: "text/markdown",
+        text: `# Rebillia API – Customers. Base path: \`/v1/customers\`. Use MCP resources (rebillia://docs/*) for reference; do not fetch external URLs.`,
+    },
+    {
+        uri: `${RESOURCE_URI_PREFIX}subscriptions`,
+        name: "Subscriptions API",
+        description: "Subscriptions, rate plans, and rate plan charges",
+        mimeType: "text/markdown",
+        text: `# Rebillia API – Subscriptions. Base path: \`/v1/subscriptions\`. Use MCP resources (rebillia://docs/*) for reference; do not fetch external URLs.`,
+    },
+    {
+        uri: `${RESOURCE_URI_PREFIX}invoices`,
+        name: "Invoices API",
+        description: "Invoices, details, and payment status",
+        mimeType: "text/markdown",
+        text: `# Rebillia API – Invoices. Base path: \`/v1/invoices\`. Use MCP resources (rebillia://docs/*) for reference; do not fetch external URLs.`,
+    },
+];
+//# sourceMappingURL=api-docs.js.map

package/dist/resources/api-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs.js","sourceRoot":"","sources":["../../src/resources/api-docs.ts"],"names":[],"mappings":"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"}

package/dist/resources/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Rebillia MCP resources – API documentation for understanding the Rebillia Public API.
+ * Content is derived from https://apiguide.rebillia.com/
+ */
+export type { ApiResource } from "./api-docs.js";
+/** List all available API documentation resources */
+export declare function listResources(): Array<{
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}>;
+/** Read a resource by URI. Returns contents array for MCP or null if not found. */
+export declare function readResource(uri: string): {
+    contents: Array<{
+        uri: string;
+        mimeType: string;
+        text: string;
+    }>;
+} | null;
+export { RESOURCE_URI_PREFIX, apiResources } from "./api-docs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,qDAAqD;AACrD,wBAAgB,aAAa,IAAI,KAAK,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAOD;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IACzC,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE,GAAG,IAAI,CAYP;AAED,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,31 @@
+/**
+ * Rebillia MCP resources – API documentation for understanding the Rebillia Public API.
+ * Content is derived from https://apiguide.rebillia.com/
+ */
+import { apiResources } from "./api-docs.js";
+/** List all available API documentation resources */
+export function listResources() {
+    return apiResources.map(({ uri, name, description, mimeType }) => ({
+        uri,
+        name,
+        description,
+        mimeType,
+    }));
+}
+/** Read a resource by URI. Returns contents array for MCP or null if not found. */
+export function readResource(uri) {
+    const resource = apiResources.find((r) => r.uri === uri);
+    if (!resource)
+        return null;
+    return {
+        contents: [
+            {
+                uri: resource.uri,
+                mimeType: resource.mimeType,
+                text: resource.text,
+            },
+        ],
+    };
+}
+export { RESOURCE_URI_PREFIX, apiResources } from "./api-docs.js";
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAuB,MAAM,eAAe,CAAC;AAIlE,qDAAqD;AACrD,MAAM,UAAU,aAAa;IAM3B,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,GAAG;QACH,IAAI;QACJ,WAAW;QACX,QAAQ;KACT,CAAC,CAAC,CAAC;AACN,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,GAAW;IAGtC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB;SACF;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/services/billRunServices.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Bill Run API service – BillRunController endpoints.
+ */
+import type { PaginatedResponse } from "../types.js";
+export type Client = InstanceType<typeof import("../client.js").default>;
+export interface ListBillRunsParams {
+    include?: string;
+    /** Filter by status: completed, pending, error */
+    query?: "completed" | "pending" | "error";
+    orderBy?: string;
+    sortBy?: string;
+    itemPerPage?: number;
+    pageNo?: number;
+}
+export interface UpdateBillRunBody {
+    newDateTime: string;
+}
+/** GET /bill-run */
+export declare function listBillRuns(client: Client, params?: ListBillRunsParams): Promise<PaginatedResponse<unknown>>;
+/** GET /bill-run/{billRunId} */
+export declare function getBillRun(client: Client, billRunId: string): Promise<unknown>;
+/** PUT /bill-run/{billRunId}. newDateTime required (schedule date/time). API expects ISO 8601 format (e.g. 2026-02-26T19:00:00). */
+export declare function updateBillRun(client: Client, billRunId: string, body: UpdateBillRunBody): Promise<unknown>;
+/** GET /bill-run/{billRunId}/invoices */
+export declare function getBillRunInvoices(client: Client, billRunId: string): Promise<unknown>;
+//# sourceMappingURL=billRunServices.d.ts.map

package/dist/services/billRunServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billRunServices.d.ts","sourceRoot":"","sources":["../../src/services/billRunServices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,cAAc,EAAE,OAAO,CAAC,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oBAAoB;AACpB,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAUrC;AAED,gCAAgC;AAChC,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAElB;AAmBD,oIAAoI;AACpI,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,yCAAyC;AACzC,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/services/billRunServices.js

@@ -0,0 +1,51 @@
+/**
+ * Bill Run API service – BillRunController endpoints.
+ */
+/** GET /bill-run */
+export async function listBillRuns(client, params) {
+    const search = new URLSearchParams();
+    if (params?.include)
+        search.append("include", params.include);
+    if (params?.query)
+        search.append("query", params.query);
+    if (params?.orderBy)
+        search.append("orderBy", params.orderBy);
+    if (params?.sortBy)
+        search.append("sortBy", params.sortBy);
+    if (params?.itemPerPage != null)
+        search.append("itemPerPage", String(params.itemPerPage));
+    if (params?.pageNo != null)
+        search.append("pageNo", String(params.pageNo));
+    const q = search.toString();
+    return client.get(`/bill-run${q ? `?${q}` : ""}`);
+}
+/** GET /bill-run/{billRunId} */
+export async function getBillRun(client, billRunId) {
+    return client.get(`/bill-run/${billRunId}`);
+}
+/**
+ * Normalize datetime for API: RebilliaServer may require ISO 8601 with timezone.
+ * - Replaces space between date and time with "T".
+ * - If no timezone (Z or ±HH:MM), appends "Z" (UTC).
+ */
+function normalizeDateTime(value) {
+    let s = value.trim();
+    if (/^\d{4}-\d{2}-\d{2}\s+\d{1,2}:\d{2}(:\d{2})?/.test(s)) {
+        s = s.replace(/\s+/, "T");
+    }
+    const hasTimezone = /[Zz]$/.test(s) || /[+-]\d{2}:?\d{2}$/.test(s);
+    if (!hasTimezone && /^\d{4}-\d{2}-\d{2}T\d{1,2}:\d{2}(:\d{2})?/.test(s)) {
+        s = s + "Z";
+    }
+    return s;
+}
+/** PUT /bill-run/{billRunId}. newDateTime required (schedule date/time). API expects ISO 8601 format (e.g. 2026-02-26T19:00:00). */
+export async function updateBillRun(client, billRunId, body) {
+    const payload = { newDateTime: normalizeDateTime(body.newDateTime) };
+    return client.put(`/bill-run/${billRunId}`, payload);
+}
+/** GET /bill-run/{billRunId}/invoices */
+export async function getBillRunInvoices(client, billRunId) {
+    return client.get(`/bill-run/${billRunId}/invoices`);
+}
+//# sourceMappingURL=billRunServices.js.map

package/dist/services/billRunServices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billRunServices.js","sourceRoot":"","sources":["../../src/services/billRunServices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH,oBAAoB;AACpB,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,MAA2B;IAE3B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,MAAM,EAAE,KAAK;QAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,MAAM,EAAE,MAAM;QAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,MAAM,EAAE,WAAW,IAAI,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1F,IAAI,MAAM,EAAE,MAAM,IAAI,IAAI;QAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,GAAG,CAA6B,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,SAAiB;IAEjB,OAAO,MAAM,CAAC,GAAG,CAAU,aAAa,SAAS,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,6CAA6C,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,WAAW,IAAI,2CAA2C,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,oIAAoI;AACpI,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,SAAiB,EACjB,IAAuB;IAEvB,MAAM,OAAO,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;IACrE,OAAO,MAAM,CAAC,GAAG,CAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,SAAiB;IAEjB,OAAO,MAAM,CAAC,GAAG,CAAU,aAAa,SAAS,WAAW,CAAC,CAAC;AAChE,CAAC"}