@rawdash/connector-bill 0.28.2

package/README.md

@@ -0,0 +1,156 @@
+<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
+
+# @rawdash/connector-bill
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/connector-bill)](https://www.npmjs.com/package/@rawdash/connector-bill)
+[![license](https://img.shields.io/npm/l/@rawdash/connector-bill)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+Sync accounts-payable bills, vendors, and vendor payments from BILL (Bill.com) for AP aging, bills-pending, and vendor-spend dashboards.
+
+## Install
+
+```sh
+npm install @rawdash/connector-bill
+```
+
+## Authentication
+
+Session-based sign in against the BILL v3 API. The connector signs in with a developer key, username, password, and organization ID to obtain a session, then reuses it for the rest of the sync.
+
+1. Request a BILL developer key from the BILL Developer portal and note the key value.
+2. Create or choose a BILL user with access to the organization you want to sync.
+3. Find the organization ID for that organization (visible in the app URL or via the List Organizations API).
+4. Store the developer key and the user password as rawdash secrets and reference them from the connector config as `devKey: secret("BILL_DEV_KEY")` and `password: secret("BILL_PASSWORD")`.
+
+## Configuration
+
+| Field       | Type   | Required | Description                                                                                                         |
+| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------- |
+| `devKey`    | secret | Yes      | BILL developer key that authorizes API access for your app. Find it in the BILL Developer portal under your app.    |
+| `username`  | string | Yes      | Email address of the BILL user the API signs in as. This user must have access to the organization you are syncing. |
+| `password`  | secret | Yes      | Password for the BILL user. Stored as a secret.                                                                     |
+| `orgId`     | string | Yes      | BILL organization ID to sync. Find it in the BILL app URL or via the List Organizations API.                        |
+| `resources` | array  | No       | Which BILL resources to sync. Omit to sync all of them (bills, vendors, payments).                                  |
+
+## Resources
+
+- **`bill_vendor`** _(entity)_ - Vendors (suppliers) with name, contact details, account number, and archived state.
+  - Endpoint: `GET /v3/vendors`
+  - Incremental syncs filter on updatedTime and sort ascending so resumable pages stay ordered.
+  - `name`: Vendor display name.
+  - `email`: Vendor contact email, if set.
+  - `accountNumber`: Your account number with the vendor, if set.
+  - `phone`: Vendor phone number, if set.
+  - `archived`: Whether the vendor has been archived.
+  - `billCurrency`: Default bill currency for the vendor (ISO code).
+  - `createdAt`: When the vendor was created (Unix ms).
+- **`bill_bill`** _(entity)_ - Accounts-payable bills with vendor, invoice number, invoice and due dates, amount, and payment status.
+  - Endpoint: `GET /v3/bills`
+  - Amounts are in the bill currency major units (e.g. dollars). Incremental syncs filter on updatedTime so status transitions are re-fetched.
+  - `vendorId`: Vendor the bill is owed to.
+  - `invoiceNumber`: Vendor invoice number, if set.
+  - `invoiceDate`: Invoice date (Unix ms), if set.
+  - `dueDate`: Payment due date (Unix ms), if set.
+  - `amount`: Bill total in the bill currency major units.
+  - `paymentStatus`: Payment status (UNPAID, PARTIALLY_PAID, PAID, ...).
+  - `approvalStatus`: Approval status (UNASSIGNED, APPROVED, ...), if set.
+  - `archived`: Whether the bill has been archived.
+  - `createdAt`: When the bill was created (Unix ms).
+- **`bill_payment`** _(event)_ - Vendor payments (money sent to vendors), one event per payment timestamped at its process date.
+  - Endpoint: `GET /v3/payments`
+  - `id`: BILL payment id.
+  - `vendorId`: Vendor paid, if set.
+  - `billId`: Bill the payment applies to, if set.
+  - `amount`: Payment amount in the payment currency major units.
+  - `status`: Payment status (SCHEDULED, PAID, CANCELED).
+  - `description`: Payment description, if set.
+  - `processDate`: Scheduled or actual process date (Unix ms), if set.
+
+## Example
+
+```ts
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const bill = {
+  name: 'bill',
+  connectorId: 'bill',
+  config: {
+    devKey: secret('BILL_DEV_KEY'),
+    username: 'api-user@example.com',
+    password: secret('BILL_PASSWORD'),
+    orgId: '00801ABCDEFGHIJKLMNO',
+    resources: ['bills', 'vendors', 'payments'],
+  },
+};
+
+export default defineConfig({
+  connectors: [bill],
+  dashboards: {
+    payables: defineDashboard({
+      widgets: {
+        bills_pending: {
+          kind: 'stat',
+          title: 'Bills pending',
+          metric: defineMetric({
+            connector: bill,
+            shape: 'entity',
+            entityType: 'bill_bill',
+            fn: 'count',
+            filter: [{ field: 'paymentStatus', op: 'eq', value: 'UNPAID' }],
+          }),
+        },
+        ap_balance: {
+          kind: 'stat',
+          title: 'AP balance (unpaid)',
+          metric: defineMetric({
+            connector: bill,
+            shape: 'entity',
+            entityType: 'bill_bill',
+            field: 'amount',
+            fn: 'sum',
+            filter: [{ field: 'paymentStatus', op: 'eq', value: 'UNPAID' }],
+          }),
+        },
+        payments_30d: {
+          kind: 'timeseries',
+          title: 'Vendor payments (30d)',
+          window: '30d',
+          metric: defineMetric({
+            connector: bill,
+            shape: 'event',
+            name: 'bill_payment',
+            field: 'amount',
+            fn: 'sum',
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Rate limits
+
+BILL does not publish standard rate-limit response headers; the shared HTTP client retries 429 responses with exponential backoff. Sessions expire after 35 minutes of inactivity and are transparently re-established on a 401.
+
+## Limitations
+
+- Monetary amounts are stored in major currency units (e.g. dollars), matching the BILL API, not in the smallest unit.
+- Incremental syncs filter on updatedTime, so status transitions (a bill moving from UNPAID to PAID) are picked up on the next run.
+- The set of synced resources is controlled by the `resources` config field; omit it to sync all of them.
+- Bill line items and approval workflow detail are out of scope; only the header-level bill, its vendor, and vendor payments are synced.
+
+## Links
+
+- [Rawdash docs](https://rawdash.dev/docs/connectors)
+- [Bill.com API docs](https://developer.bill.com/docs/home)
+- [GitHub](https://github.com/rawdash/rawdash)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,464 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    devKey: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    username: z.ZodString;
+    password: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    orgId: z.ZodString;
+    resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        bills: "bills";
+        vendors: "vendors";
+        payments: "payments";
+    }>>>;
+}, z.core.$strip>;
+declare const doc: ConnectorDoc;
+type BillResource = 'bills' | 'vendors' | 'payments';
+interface BillSettings {
+    orgId: string;
+    resources?: readonly BillResource[];
+}
+declare const billCredentials: {
+    devKey: {
+        description: string;
+        auth: "required";
+    };
+    username: {
+        description: string;
+        auth: "required";
+    };
+    password: {
+        description: string;
+        auth: "required";
+    };
+};
+type BillCredentials = typeof billCredentials;
+declare const billResources: {
+    readonly bill_vendor: {
+        readonly shape: "entity";
+        readonly filterable: [{
+            readonly field: "archived";
+            readonly ops: ["eq"];
+            readonly values: ["true", "false"];
+        }];
+        readonly description: "Vendors (suppliers) with name, contact details, account number, and archived state.";
+        readonly endpoint: "GET /v3/vendors";
+        readonly notes: "Incremental syncs filter on updatedTime and sort ascending so resumable pages stay ordered.";
+        readonly fields: [{
+            readonly name: "name";
+            readonly description: "Vendor display name.";
+        }, {
+            readonly name: "email";
+            readonly description: "Vendor contact email, if set.";
+        }, {
+            readonly name: "accountNumber";
+            readonly description: "Your account number with the vendor, if set.";
+        }, {
+            readonly name: "phone";
+            readonly description: "Vendor phone number, if set.";
+        }, {
+            readonly name: "archived";
+            readonly description: "Whether the vendor has been archived.";
+        }, {
+            readonly name: "billCurrency";
+            readonly description: "Default bill currency for the vendor (ISO code).";
+        }, {
+            readonly name: "createdAt";
+            readonly description: "When the vendor was created (Unix ms).";
+        }];
+        readonly responses: {
+            readonly login: z.ZodObject<{
+                sessionId: z.ZodString;
+                organizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                userId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>;
+            readonly vendors: z.ZodObject<{
+                results: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    accountNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    billCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>;
+        };
+    };
+    readonly bill_bill: {
+        readonly shape: "entity";
+        readonly filterable: [{
+            readonly field: "paymentStatus";
+            readonly ops: ["eq"];
+            readonly values: ["UNPAID", "PARTIALLY_PAID", "PAID", "SCHEDULED", "PARTIALLY_SCHEDULED"];
+        }];
+        readonly description: "Accounts-payable bills with vendor, invoice number, invoice and due dates, amount, and payment status.";
+        readonly endpoint: "GET /v3/bills";
+        readonly notes: "Amounts are in the bill currency major units (e.g. dollars). Incremental syncs filter on updatedTime so status transitions are re-fetched.";
+        readonly fields: [{
+            readonly name: "vendorId";
+            readonly description: "Vendor the bill is owed to.";
+        }, {
+            readonly name: "invoiceNumber";
+            readonly description: "Vendor invoice number, if set.";
+        }, {
+            readonly name: "invoiceDate";
+            readonly description: "Invoice date (Unix ms), if set.";
+        }, {
+            readonly name: "dueDate";
+            readonly description: "Payment due date (Unix ms), if set.";
+        }, {
+            readonly name: "amount";
+            readonly description: "Bill total in the bill currency major units.";
+        }, {
+            readonly name: "paymentStatus";
+            readonly description: "Payment status (UNPAID, PARTIALLY_PAID, PAID, ...).";
+        }, {
+            readonly name: "approvalStatus";
+            readonly description: "Approval status (UNASSIGNED, APPROVED, ...), if set.";
+        }, {
+            readonly name: "archived";
+            readonly description: "Whether the bill has been archived.";
+        }, {
+            readonly name: "createdAt";
+            readonly description: "When the bill was created (Unix ms).";
+        }];
+        readonly responses: {
+            readonly bills: z.ZodObject<{
+                results: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    vendorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    invoice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        invoiceNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        invoiceDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>;
+                    paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    approvalStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>;
+        };
+    };
+    readonly bill_payment: {
+        readonly shape: "event";
+        readonly filterable: [{
+            readonly field: "status";
+            readonly ops: ["eq"];
+            readonly values: ["SCHEDULED", "PAID", "CANCELED"];
+        }];
+        readonly description: "Vendor payments (money sent to vendors), one event per payment timestamped at its process date.";
+        readonly endpoint: "GET /v3/payments";
+        readonly fields: [{
+            readonly name: "id";
+            readonly description: "BILL payment id.";
+        }, {
+            readonly name: "vendorId";
+            readonly description: "Vendor paid, if set.";
+        }, {
+            readonly name: "billId";
+            readonly description: "Bill the payment applies to, if set.";
+        }, {
+            readonly name: "amount";
+            readonly description: "Payment amount in the payment currency major units.";
+        }, {
+            readonly name: "status";
+            readonly description: "Payment status (SCHEDULED, PAID, CANCELED).";
+        }, {
+            readonly name: "description";
+            readonly description: "Payment description, if set.";
+        }, {
+            readonly name: "processDate";
+            readonly description: "Scheduled or actual process date (Unix ms), if set.";
+        }];
+        readonly responses: {
+            readonly payments: z.ZodObject<{
+                results: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    vendorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    billId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    processDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>;
+                nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>;
+        };
+    };
+};
+declare const id = "bill";
+declare class BillConnector extends BaseConnector<BillSettings, BillCredentials> {
+    static readonly id = "bill";
+    static readonly resources: {
+        readonly bill_vendor: {
+            readonly shape: "entity";
+            readonly filterable: [{
+                readonly field: "archived";
+                readonly ops: ["eq"];
+                readonly values: ["true", "false"];
+            }];
+            readonly description: "Vendors (suppliers) with name, contact details, account number, and archived state.";
+            readonly endpoint: "GET /v3/vendors";
+            readonly notes: "Incremental syncs filter on updatedTime and sort ascending so resumable pages stay ordered.";
+            readonly fields: [{
+                readonly name: "name";
+                readonly description: "Vendor display name.";
+            }, {
+                readonly name: "email";
+                readonly description: "Vendor contact email, if set.";
+            }, {
+                readonly name: "accountNumber";
+                readonly description: "Your account number with the vendor, if set.";
+            }, {
+                readonly name: "phone";
+                readonly description: "Vendor phone number, if set.";
+            }, {
+                readonly name: "archived";
+                readonly description: "Whether the vendor has been archived.";
+            }, {
+                readonly name: "billCurrency";
+                readonly description: "Default bill currency for the vendor (ISO code).";
+            }, {
+                readonly name: "createdAt";
+                readonly description: "When the vendor was created (Unix ms).";
+            }];
+            readonly responses: {
+                readonly login: z.ZodObject<{
+                    sessionId: z.ZodString;
+                    organizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    userId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>;
+                readonly vendors: z.ZodObject<{
+                    results: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        accountNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                        billCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly bill_bill: {
+            readonly shape: "entity";
+            readonly filterable: [{
+                readonly field: "paymentStatus";
+                readonly ops: ["eq"];
+                readonly values: ["UNPAID", "PARTIALLY_PAID", "PAID", "SCHEDULED", "PARTIALLY_SCHEDULED"];
+            }];
+            readonly description: "Accounts-payable bills with vendor, invoice number, invoice and due dates, amount, and payment status.";
+            readonly endpoint: "GET /v3/bills";
+            readonly notes: "Amounts are in the bill currency major units (e.g. dollars). Incremental syncs filter on updatedTime so status transitions are re-fetched.";
+            readonly fields: [{
+                readonly name: "vendorId";
+                readonly description: "Vendor the bill is owed to.";
+            }, {
+                readonly name: "invoiceNumber";
+                readonly description: "Vendor invoice number, if set.";
+            }, {
+                readonly name: "invoiceDate";
+                readonly description: "Invoice date (Unix ms), if set.";
+            }, {
+                readonly name: "dueDate";
+                readonly description: "Payment due date (Unix ms), if set.";
+            }, {
+                readonly name: "amount";
+                readonly description: "Bill total in the bill currency major units.";
+            }, {
+                readonly name: "paymentStatus";
+                readonly description: "Payment status (UNPAID, PARTIALLY_PAID, PAID, ...).";
+            }, {
+                readonly name: "approvalStatus";
+                readonly description: "Approval status (UNASSIGNED, APPROVED, ...), if set.";
+            }, {
+                readonly name: "archived";
+                readonly description: "Whether the bill has been archived.";
+            }, {
+                readonly name: "createdAt";
+                readonly description: "When the bill was created (Unix ms).";
+            }];
+            readonly responses: {
+                readonly bills: z.ZodObject<{
+                    results: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        vendorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        invoice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                            invoiceNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                            invoiceDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        }, z.core.$strip>>>;
+                        paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        approvalStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                        createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly bill_payment: {
+            readonly shape: "event";
+            readonly filterable: [{
+                readonly field: "status";
+                readonly ops: ["eq"];
+                readonly values: ["SCHEDULED", "PAID", "CANCELED"];
+            }];
+            readonly description: "Vendor payments (money sent to vendors), one event per payment timestamped at its process date.";
+            readonly endpoint: "GET /v3/payments";
+            readonly fields: [{
+                readonly name: "id";
+                readonly description: "BILL payment id.";
+            }, {
+                readonly name: "vendorId";
+                readonly description: "Vendor paid, if set.";
+            }, {
+                readonly name: "billId";
+                readonly description: "Bill the payment applies to, if set.";
+            }, {
+                readonly name: "amount";
+                readonly description: "Payment amount in the payment currency major units.";
+            }, {
+                readonly name: "status";
+                readonly description: "Payment status (SCHEDULED, PAID, CANCELED).";
+            }, {
+                readonly name: "description";
+                readonly description: "Payment description, if set.";
+            }, {
+                readonly name: "processDate";
+                readonly description: "Scheduled or actual process date (Unix ms), if set.";
+            }];
+            readonly responses: {
+                readonly payments: z.ZodObject<{
+                    results: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        vendorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        billId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        processDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>;
+            };
+        };
+    };
+    static readonly schemas: {
+        readonly login: z.ZodObject<{
+            sessionId: z.ZodString;
+            organizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            userId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        readonly vendors: z.ZodObject<{
+            results: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                accountNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                billCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    } & {
+        readonly bills: z.ZodObject<{
+            results: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                vendorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                invoice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    invoiceNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    invoiceDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+                paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                approvalStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    } & {
+        readonly payments: z.ZodObject<{
+            results: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                vendorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                billId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                processDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                createdTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                updatedTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            nextPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            prevPage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    static create(input: unknown, ctx?: ConnectorContext): BillConnector;
+    readonly id = "bill";
+    readonly credentials: {
+        devKey: {
+            description: string;
+            auth: "required";
+        };
+        username: {
+            description: string;
+            auth: "required";
+        };
+        password: {
+            description: string;
+            auth: "required";
+        };
+    };
+    private sessionId;
+    private baseHeaders;
+    private refreshSession;
+    private getSession;
+    private apiGet;
+    private buildListUrl;
+    private fetchPage;
+    private writeVendors;
+    private writeBills;
+    private writePayments;
+    private writePhase;
+    private clearScopeOnFirstPage;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { BillConnector, type BillResource, type BillSettings, configFields, BillConnector as default, doc, id, billResources as resources };

package/dist/index.js

@@ -0,0 +1,514 @@
+// ../../connector-shared/dist/index.js
+var HTTP_CLIENT_VERSION = "0.0.0";
+var DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+function connectorUserAgent(connectorId) {
+  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+}
+function parseEpoch(value, unit) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (unit === "iso") {
+    if (typeof value !== "string") {
+      return null;
+    }
+    const ms = new Date(value).getTime();
+    return Number.isFinite(ms) ? ms : null;
+  }
+  if (typeof value === "string" && value.trim() === "") {
+    return null;
+  }
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n)) {
+    return null;
+  }
+  const result = unit === "s" ? n * 1e3 : n;
+  return Number.isFinite(result) ? result : null;
+}
+
+// src/bill.ts
+import {
+  BaseConnector,
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  makeChunkedCursorGuard,
+  paginateChunked,
+  schemasFromResources,
+  selectActivePhases
+} from "@rawdash/core";
+import { z } from "zod";
+var configFields = defineConfigFields(
+  z.object({
+    devKey: z.object({ $secret: z.string().min(1) }).meta({
+      label: "Developer key",
+      description: "BILL developer key that authorizes API access for your app. Find it in the BILL Developer portal under your app.",
+      placeholder: "BILL_DEV_KEY",
+      secret: true
+    }),
+    username: z.string().min(1).meta({
+      label: "Username",
+      description: "Email address of the BILL user the API signs in as. This user must have access to the organization you are syncing.",
+      placeholder: "api-user@example.com"
+    }),
+    password: z.object({ $secret: z.string().min(1) }).meta({
+      label: "Password",
+      description: "Password for the BILL user. Stored as a secret.",
+      placeholder: "BILL_PASSWORD",
+      secret: true
+    }),
+    orgId: z.string().min(1).meta({
+      label: "Organization ID",
+      description: "BILL organization ID to sync. Find it in the BILL app URL or via the List Organizations API.",
+      placeholder: "00801ABCDEFGHIJKLMNO"
+    }),
+    resources: z.array(z.enum(["bills", "vendors", "payments"])).nonempty().optional().meta({
+      label: "Resources",
+      description: "Which BILL resources to sync. Omit to sync all of them (bills, vendors, payments)."
+    })
+  })
+);
+var doc = defineConnectorDoc({
+  displayName: "Bill.com",
+  category: "finance",
+  brandColor: "#005DAA",
+  tagline: "Sync accounts-payable bills, vendors, and vendor payments from BILL (Bill.com) for AP aging, bills-pending, and vendor-spend dashboards.",
+  vendor: {
+    name: "Bill.com",
+    domain: "bill.com",
+    apiDocs: "https://developer.bill.com/docs/home",
+    website: "https://www.bill.com"
+  },
+  auth: {
+    summary: "Session-based sign in against the BILL v3 API. The connector signs in with a developer key, username, password, and organization ID to obtain a session, then reuses it for the rest of the sync.",
+    setup: [
+      "Request a BILL developer key from the BILL Developer portal and note the key value.",
+      "Create or choose a BILL user with access to the organization you want to sync.",
+      "Find the organization ID for that organization (visible in the app URL or via the List Organizations API).",
+      'Store the developer key and the user password as rawdash secrets and reference them from the connector config as `devKey: secret("BILL_DEV_KEY")` and `password: secret("BILL_PASSWORD")`.'
+    ]
+  },
+  rateLimit: "BILL does not publish standard rate-limit response headers; the shared HTTP client retries 429 responses with exponential backoff. Sessions expire after 35 minutes of inactivity and are transparently re-established on a 401.",
+  limitations: [
+    "Monetary amounts are stored in major currency units (e.g. dollars), matching the BILL API, not in the smallest unit.",
+    "Incremental syncs filter on updatedTime, so status transitions (a bill moving from UNPAID to PAID) are picked up on the next run.",
+    "The set of synced resources is controlled by the `resources` config field; omit it to sync all of them.",
+    "Bill line items and approval workflow detail are out of scope; only the header-level bill, its vendor, and vendor payments are synced."
+  ]
+});
+var billCredentials = {
+  devKey: {
+    description: "BILL developer key",
+    auth: "required"
+  },
+  username: {
+    description: "BILL user email",
+    auth: "required"
+  },
+  password: {
+    description: "BILL user password",
+    auth: "required"
+  }
+};
+var API_BASE = "https://gateway.prod.bill.com/connect/v3";
+var PAGE_SIZE = 100;
+var PHASE_ORDER = ["vendors", "bills", "payments"];
+var isBillSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);
+var VENDOR_ENTITY = "bill_vendor";
+var BILL_ENTITY = "bill_bill";
+var PAYMENT_EVENT = "bill_payment";
+var ENDPOINT_BY_PHASE = {
+  vendors: "vendors",
+  bills: "bills",
+  payments: "payments"
+};
+function isAuthError(err) {
+  return err instanceof Error && err.kind === "auth";
+}
+var idString = z.string().min(1);
+var loginSchema = z.object({
+  sessionId: idString,
+  organizationId: z.string().nullish(),
+  userId: z.string().nullish()
+});
+var vendorSchema = z.object({
+  id: idString,
+  name: z.string().nullish(),
+  email: z.string().nullish(),
+  accountNumber: z.string().nullish(),
+  phone: z.string().nullish(),
+  archived: z.boolean().nullish(),
+  billCurrency: z.string().nullish(),
+  createdTime: z.string().nullish(),
+  updatedTime: z.string().nullish()
+});
+var billSchema = z.object({
+  id: idString,
+  vendorId: z.string().nullish(),
+  amount: z.number().nullish(),
+  dueDate: z.string().nullish(),
+  invoice: z.object({
+    invoiceNumber: z.string().nullish(),
+    invoiceDate: z.string().nullish()
+  }).nullish(),
+  paymentStatus: z.string().nullish(),
+  approvalStatus: z.string().nullish(),
+  archived: z.boolean().nullish(),
+  createdTime: z.string().nullish(),
+  updatedTime: z.string().nullish()
+});
+var paymentSchema = z.object({
+  id: idString,
+  vendorId: z.string().nullish(),
+  billId: z.string().nullish(),
+  amount: z.number().nullish(),
+  processDate: z.string().nullish(),
+  status: z.string().nullish(),
+  description: z.string().nullish(),
+  createdTime: z.string().nullish(),
+  updatedTime: z.string().nullish()
+});
+var listResponseSchema = (item) => z.object({
+  results: z.array(item),
+  nextPage: z.string().nullish(),
+  prevPage: z.string().nullish()
+});
+var vendorsListSchema = listResponseSchema(vendorSchema);
+var billsListSchema = listResponseSchema(billSchema);
+var paymentsListSchema = listResponseSchema(paymentSchema);
+var billResources = defineResources({
+  [VENDOR_ENTITY]: {
+    shape: "entity",
+    filterable: [{ field: "archived", ops: ["eq"], values: ["true", "false"] }],
+    description: "Vendors (suppliers) with name, contact details, account number, and archived state.",
+    endpoint: "GET /v3/vendors",
+    notes: "Incremental syncs filter on updatedTime and sort ascending so resumable pages stay ordered.",
+    fields: [
+      { name: "name", description: "Vendor display name." },
+      { name: "email", description: "Vendor contact email, if set." },
+      {
+        name: "accountNumber",
+        description: "Your account number with the vendor, if set."
+      },
+      { name: "phone", description: "Vendor phone number, if set." },
+      {
+        name: "archived",
+        description: "Whether the vendor has been archived."
+      },
+      {
+        name: "billCurrency",
+        description: "Default bill currency for the vendor (ISO code)."
+      },
+      {
+        name: "createdAt",
+        description: "When the vendor was created (Unix ms)."
+      }
+    ],
+    responses: {
+      login: loginSchema,
+      vendors: vendorsListSchema
+    }
+  },
+  [BILL_ENTITY]: {
+    shape: "entity",
+    filterable: [
+      {
+        field: "paymentStatus",
+        ops: ["eq"],
+        values: [
+          "UNPAID",
+          "PARTIALLY_PAID",
+          "PAID",
+          "SCHEDULED",
+          "PARTIALLY_SCHEDULED"
+        ]
+      }
+    ],
+    description: "Accounts-payable bills with vendor, invoice number, invoice and due dates, amount, and payment status.",
+    endpoint: "GET /v3/bills",
+    notes: "Amounts are in the bill currency major units (e.g. dollars). Incremental syncs filter on updatedTime so status transitions are re-fetched.",
+    fields: [
+      { name: "vendorId", description: "Vendor the bill is owed to." },
+      { name: "invoiceNumber", description: "Vendor invoice number, if set." },
+      {
+        name: "invoiceDate",
+        description: "Invoice date (Unix ms), if set."
+      },
+      { name: "dueDate", description: "Payment due date (Unix ms), if set." },
+      {
+        name: "amount",
+        description: "Bill total in the bill currency major units."
+      },
+      {
+        name: "paymentStatus",
+        description: "Payment status (UNPAID, PARTIALLY_PAID, PAID, ...)."
+      },
+      {
+        name: "approvalStatus",
+        description: "Approval status (UNASSIGNED, APPROVED, ...), if set."
+      },
+      { name: "archived", description: "Whether the bill has been archived." },
+      {
+        name: "createdAt",
+        description: "When the bill was created (Unix ms)."
+      }
+    ],
+    responses: { bills: billsListSchema }
+  },
+  [PAYMENT_EVENT]: {
+    shape: "event",
+    filterable: [
+      {
+        field: "status",
+        ops: ["eq"],
+        values: ["SCHEDULED", "PAID", "CANCELED"]
+      }
+    ],
+    description: "Vendor payments (money sent to vendors), one event per payment timestamped at its process date.",
+    endpoint: "GET /v3/payments",
+    fields: [
+      { name: "id", description: "BILL payment id." },
+      { name: "vendorId", description: "Vendor paid, if set." },
+      { name: "billId", description: "Bill the payment applies to, if set." },
+      {
+        name: "amount",
+        description: "Payment amount in the payment currency major units."
+      },
+      {
+        name: "status",
+        description: "Payment status (SCHEDULED, PAID, CANCELED)."
+      },
+      { name: "description", description: "Payment description, if set." },
+      {
+        name: "processDate",
+        description: "Scheduled or actual process date (Unix ms), if set."
+      }
+    ],
+    responses: { payments: paymentsListSchema }
+  }
+});
+var id = "bill";
+var BillConnector = class _BillConnector extends BaseConnector {
+  static id = id;
+  static resources = billResources;
+  static schemas = schemasFromResources(billResources);
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _BillConnector(
+      { orgId: parsed.orgId, resources: parsed.resources },
+      {
+        devKey: parsed.devKey,
+        username: parsed.username,
+        password: parsed.password
+      },
+      ctx
+    );
+  }
+  id = id;
+  credentials = billCredentials;
+  sessionId = null;
+  baseHeaders() {
+    return {
+      Accept: "application/json",
+      "Content-Type": "application/json",
+      "User-Agent": connectorUserAgent("bill")
+    };
+  }
+  async refreshSession(signal) {
+    const res = await this.post(`${API_BASE}/login`, {
+      resource: "login",
+      headers: this.baseHeaders(),
+      body: JSON.stringify({
+        username: this.creds.username,
+        password: this.creds.password,
+        organizationId: this.settings.orgId,
+        devKey: this.creds.devKey
+      }),
+      signal
+    });
+    const sessionId = res.body.sessionId;
+    if (!sessionId) {
+      throw new Error("BILL login did not return a sessionId");
+    }
+    this.sessionId = sessionId;
+    return sessionId;
+  }
+  async getSession(signal) {
+    if (this.sessionId) {
+      return this.sessionId;
+    }
+    return this.refreshSession(signal);
+  }
+  async apiGet(url, resource, signal, retried = false) {
+    const sessionId = await this.getSession(signal);
+    try {
+      return await this.get(url, {
+        resource,
+        headers: {
+          ...this.baseHeaders(),
+          sessionId,
+          devKey: this.creds.devKey
+        },
+        signal
+      });
+    } catch (err) {
+      if (!retried && isAuthError(err)) {
+        this.sessionId = null;
+        return this.apiGet(url, resource, signal, true);
+      }
+      throw err;
+    }
+  }
+  buildListUrl(phase, page, options) {
+    const url = new URL(`${API_BASE}/${ENDPOINT_BY_PHASE[phase]}`);
+    url.searchParams.set("max", String(PAGE_SIZE));
+    if (page) {
+      url.searchParams.set("page", page);
+      return url.toString();
+    }
+    url.searchParams.set("sort", "updatedTime:asc");
+    if (options.since) {
+      const iso = new Date(options.since).toISOString();
+      url.searchParams.set("filters", `updatedTime:gte:"${iso}"`);
+    }
+    return url.toString();
+  }
+  async fetchPage(phase, page, options, signal) {
+    const url = this.buildListUrl(phase, page, options);
+    const res = await this.apiGet(
+      url,
+      phase,
+      signal
+    );
+    const results = res.body.results ?? [];
+    const nextPage = res.body.nextPage ?? null;
+    const next = nextPage && results.length > 0 ? nextPage : null;
+    return { items: results, next };
+  }
+  async writeVendors(storage, items) {
+    for (const v of items) {
+      const createdMs = parseEpoch(v.createdTime ?? null, "iso");
+      const updatedMs = parseEpoch(v.updatedTime ?? null, "iso");
+      await storage.entity({
+        type: VENDOR_ENTITY,
+        id: v.id,
+        attributes: {
+          name: v.name ?? null,
+          email: v.email ?? null,
+          accountNumber: v.accountNumber ?? null,
+          phone: v.phone ?? null,
+          archived: v.archived ?? false,
+          billCurrency: v.billCurrency ?? null,
+          createdAt: createdMs
+        },
+        updated_at: updatedMs ?? createdMs ?? 0
+      });
+    }
+  }
+  async writeBills(storage, items) {
+    for (const b of items) {
+      const createdMs = parseEpoch(b.createdTime ?? null, "iso");
+      const updatedMs = parseEpoch(b.updatedTime ?? null, "iso");
+      await storage.entity({
+        type: BILL_ENTITY,
+        id: b.id,
+        attributes: {
+          vendorId: b.vendorId ?? null,
+          invoiceNumber: b.invoice?.invoiceNumber ?? null,
+          invoiceDate: parseEpoch(b.invoice?.invoiceDate ?? null, "iso"),
+          dueDate: parseEpoch(b.dueDate ?? null, "iso"),
+          amount: b.amount ?? null,
+          paymentStatus: b.paymentStatus ?? null,
+          approvalStatus: b.approvalStatus ?? null,
+          archived: b.archived ?? false,
+          createdAt: createdMs
+        },
+        updated_at: updatedMs ?? createdMs ?? 0
+      });
+    }
+  }
+  async writePayments(storage, items) {
+    for (const p of items) {
+      const createdMs = parseEpoch(p.createdTime ?? null, "iso");
+      const processMs = parseEpoch(p.processDate ?? null, "iso");
+      const ts = processMs ?? createdMs;
+      if (ts === null) {
+        continue;
+      }
+      await storage.event({
+        name: PAYMENT_EVENT,
+        start_ts: ts,
+        end_ts: null,
+        attributes: {
+          id: p.id,
+          vendorId: p.vendorId ?? null,
+          billId: p.billId ?? null,
+          amount: p.amount ?? null,
+          status: p.status ?? null,
+          description: p.description ?? null,
+          processDate: processMs
+        }
+      });
+    }
+  }
+  async writePhase(storage, phase, items) {
+    switch (phase) {
+      case "vendors":
+        return this.writeVendors(storage, items);
+      case "bills":
+        return this.writeBills(storage, items);
+      case "payments":
+        return this.writePayments(storage, items);
+    }
+  }
+  async clearScopeOnFirstPage(storage, phase, isFull) {
+    if (!isFull) {
+      return;
+    }
+    switch (phase) {
+      case "vendors":
+        await storage.entities([], { types: [VENDOR_ENTITY] });
+        return;
+      case "bills":
+        await storage.entities([], { types: [BILL_ENTITY] });
+        return;
+      case "payments":
+        await storage.events([], { names: [PAYMENT_EVENT] });
+        return;
+    }
+  }
+  async sync(options, storage, signal) {
+    const cursor = isBillSyncCursor(options.cursor) ? options.cursor : void 0;
+    const isFull = options.mode === "full";
+    const phases = selectActivePhases(
+      (r) => r,
+      PHASE_ORDER,
+      this.settings.resources
+    );
+    return paginateChunked({
+      phases,
+      cursor,
+      signal,
+      logger: this.logger,
+      fetchPage: (phase, page, sig) => this.fetchPage(phase, page, options, sig),
+      writeBatch: async (phase, items, page) => {
+        if (page === null) {
+          await this.clearScopeOnFirstPage(storage, phase, isFull);
+        }
+        await this.writePhase(storage, phase, items);
+      }
+    });
+  }
+};
+
+// src/index.ts
+var index_default = BillConnector;
+export {
+  BillConnector,
+  configFields,
+  index_default as default,
+  doc,
+  id,
+  billResources as resources
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../connector-shared/src/errors.ts","../../../connector-shared/src/retry.ts","../../../connector-shared/src/version.ts","../../../connector-shared/src/request.ts","../../../connector-shared/src/rate-limit.ts","../../../connector-shared/src/map-concurrent.ts","../../../connector-shared/src/sanitize.ts","../../../connector-shared/src/epoch.ts","../../../connector-shared/src/pagination.ts","../../../connector-shared/src/logger.ts","../src/bill.ts","../src/index.ts"],"sourcesContent":["import type { HttpResponse } from './types';\n\nexport type HttpErrorKind =\n  | 'transient'\n  | 'rate_limit'\n  | 'auth'\n  | 'upstream_bug'\n  | 'client_bug';\n\nexport abstract class HttpClientError extends Error {\n  abstract readonly kind: HttpErrorKind;\n  readonly response?: HttpResponse;\n\n  constructor(message: string, response?: HttpResponse) {\n    super(message);\n    this.name = new.target.name;\n    this.response = response;\n  }\n}\n\nexport class TransientError extends HttpClientError {\n  readonly kind = 'transient' as const;\n}\n\nexport class RateLimitError extends HttpClientError {\n  readonly kind = 'rate_limit' as const;\n  readonly retryAfter?: Date;\n\n  constructor(message: string, response?: HttpResponse, retryAfter?: Date) {\n    super(message, response);\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class AuthError extends HttpClientError {\n  readonly kind = 'auth' as const;\n}\n\nexport class UpstreamBugError extends HttpClientError {\n  readonly kind = 'upstream_bug' as const;\n}\n\nexport class ClientBugError extends HttpClientError {\n  readonly kind = 'client_bug' as const;\n}\n\nexport function classifyStatus(status: number): HttpErrorKind {\n  if (status === 429) {\n    return 'rate_limit';\n  }\n  if (status === 401 || status === 403) {\n    return 'auth';\n  }\n  if (status === 408) {\n    return 'transient';\n  }\n  if (status >= 500) {\n    return 'upstream_bug';\n  }\n  if (status >= 400) {\n    return 'client_bug';\n  }\n  return 'client_bug';\n}\n\nexport function errorForStatus(\n  message: string,\n  response: HttpResponse,\n  retryAfter?: Date,\n): HttpClientError {\n  const kind = classifyStatus(response.status);\n  switch (kind) {\n    case 'rate_limit':\n      return new RateLimitError(message, response, retryAfter);\n    case 'auth':\n      return new AuthError(message, response);\n    case 'transient':\n      return new TransientError(message, response);\n    case 'upstream_bug':\n      return new UpstreamBugError(message, response);\n    case 'client_bug':\n      return new ClientBugError(message, response);\n  }\n}\n","import { HttpClientError, RateLimitError, TransientError } from './errors';\n\nexport interface RetryPolicy {\n  maxAttempts?: number;\n  initialDelayMs?: number;\n  maxDelayMs?: number;\n  retryOn?: (status: number | null, err?: Error) => boolean;\n}\n\nexport const defaultRetryOn = (status: number | null, err?: Error): boolean => {\n  if (err instanceof RateLimitError) {\n    return true;\n  }\n  if (err instanceof TransientError) {\n    return true;\n  }\n  if (status === null) {\n    return err instanceof Error && !(err instanceof HttpClientError);\n  }\n  if (status === 408 || status === 429) {\n    return true;\n  }\n  if (status >= 500) {\n    return true;\n  }\n  return false;\n};\n\nexport function backoffDelayMs(\n  attempt: number,\n  policy: Required<Pick<RetryPolicy, 'initialDelayMs' | 'maxDelayMs'>>,\n): number {\n  const base = policy.initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, policy.maxDelayMs);\n}\n\nexport function parseRetryAfter(\n  headerValue: string | null,\n  now: Date = new Date(),\n): Date | undefined {\n  if (!headerValue) {\n    return undefined;\n  }\n  const trimmed = headerValue.trim();\n  if (/^\\d+$/.test(trimmed)) {\n    return new Date(now.getTime() + Number(trimmed) * 1000);\n  }\n  const parsed = Date.parse(trimmed);\n  if (Number.isNaN(parsed)) {\n    return undefined;\n  }\n  return new Date(parsed);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  if (signal?.aborted) {\n    return Promise.reject(signal.reason ?? new Error('Aborted'));\n  }\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal!.reason ?? new Error('Aborted'));\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n","export const HTTP_CLIENT_VERSION = '0.0.0';\n\nexport const DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n\nexport function connectorUserAgent(connectorId: string): string {\n  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n}\n","import {\n  AuthError,\n  ClientBugError,\n  HttpClientError,\n  RateLimitError,\n  TransientError,\n  UpstreamBugError,\n  errorForStatus,\n} from './errors';\nimport { defaultRetryOn, parseRetryAfter, sleep } from './retry';\nimport type { FetchLike, HttpMethod, HttpRequest, HttpResponse } from './types';\nimport { DEFAULT_USER_AGENT } from './version';\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY_MS = 1000;\nconst DEFAULT_MAX_DELAY_MS = 60_000;\nconst OBSERVER_TIMEOUT_MS = 250;\n\nexport interface RequestObservation {\n  url: string;\n  method: HttpMethod;\n  status: number;\n  resource: string;\n  requestId: string;\n  body: unknown;\n}\n\nexport type RequestObserver = (\n  event: RequestObservation,\n) => void | Promise<void>;\n\nexport interface RequestOptions {\n  fetch?: FetchLike;\n  observer?: RequestObserver;\n  resource: string;\n  requestId?: string;\n}\n\nasync function notifyObserver(\n  observer: RequestObserver,\n  event: RequestObservation,\n): Promise<void> {\n  let result: void | Promise<void>;\n  try {\n    result = observer(event);\n  } catch (err) {\n    console.warn('[connector-shared] request observer threw:', err);\n    return;\n  }\n  if (!(result instanceof Promise)) {\n    return;\n  }\n  const guarded = result.catch((err) => {\n    console.warn('[connector-shared] request observer rejected:', err);\n  });\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timer = setTimeout(resolve, OBSERVER_TIMEOUT_MS);\n  });\n  try {\n    await Promise.race([guarded, timeout]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n\nfunction newRequestId(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) {\n    return c.randomUUID();\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction mergeHeaders(\n  defaults: Record<string, string>,\n  overrides: Record<string, string> | undefined,\n): Record<string, string> {\n  const merged: Record<string, string> = {};\n  for (const [k, v] of Object.entries(defaults)) {\n    merged[k.toLowerCase()] = v;\n  }\n  if (overrides) {\n    for (const [k, v] of Object.entries(overrides)) {\n      merged[k.toLowerCase()] = v;\n    }\n  }\n  return merged;\n}\n\nfunction linkTimeoutSignal(\n  parent: AbortSignal | undefined,\n  timeoutMs: number,\n): { signal: AbortSignal; cancel: () => void } {\n  const controller = new AbortController();\n  const onParentAbort = () => {\n    controller.abort(parent?.reason);\n  };\n  if (parent) {\n    if (parent.aborted) {\n      controller.abort(parent.reason);\n    } else {\n      parent.addEventListener('abort', onParentAbort, { once: true });\n    }\n  }\n  const timer = setTimeout(() => {\n    controller.abort(new Error(`Request timed out after ${timeoutMs}ms`));\n  }, timeoutMs);\n  return {\n    signal: controller.signal,\n    cancel: () => {\n      clearTimeout(timer);\n      if (parent) {\n        parent.removeEventListener('abort', onParentAbort);\n      }\n    },\n  };\n}\n\nasync function readBody(\n  res: Response,\n  parseJson: boolean,\n  binary: boolean,\n): Promise<unknown> {\n  if (res.status === 204 || res.status === 205) {\n    return null;\n  }\n  if (binary) {\n    return new Uint8Array(await res.arrayBuffer());\n  }\n  const contentType = res.headers.get('content-type') ?? '';\n  if (parseJson && contentType.includes('application/json')) {\n    const text = await res.text();\n    if (text.length === 0) {\n      return null;\n    }\n    return JSON.parse(text);\n  }\n  return res.text();\n}\n\nexport async function request<T = unknown>(\n  req: HttpRequest,\n  options: RequestOptions,\n): Promise<HttpResponse<T>> {\n  const fetchImpl: FetchLike = options.fetch ?? (globalThis.fetch as FetchLike);\n  const retry = req.retry ?? {};\n  const maxAttempts = retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n  const initialDelayMs = retry.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;\n  const maxDelayMs = retry.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;\n  const retryOn = retry.retryOn ?? defaultRetryOn;\n  const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const parseJson = req.parseJson ?? true;\n  const binary = req.binary ?? false;\n\n  const headers = mergeHeaders(\n    {\n      'User-Agent': DEFAULT_USER_AGENT,\n      Accept: 'application/json',\n    },\n    req.headers,\n  );\n\n  let lastErr: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    req.signal?.throwIfAborted();\n\n    const { signal, cancel } = linkTimeoutSignal(req.signal, timeoutMs);\n    let res: Response;\n    try {\n      res = await fetchImpl(req.url, {\n        method: req.method ?? 'GET',\n        headers,\n        body: req.body as RequestInit['body'],\n        signal,\n      });\n    } catch (err) {\n      cancel();\n      if (req.signal?.aborted) {\n        throw req.signal.reason ?? err;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      lastErr = error;\n      if (attempt < maxAttempts - 1 && retryOn(null, error)) {\n        const delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n        await sleep(delay, req.signal);\n        continue;\n      }\n      throw new TransientError(error.message);\n    }\n    cancel();\n\n    const body = await readBody(res, parseJson, binary);\n    const httpResponse: HttpResponse<T> = {\n      status: res.status,\n      headers: res.headers,\n      body: body as T,\n    };\n    if (req.rateLimit) {\n      const state = req.rateLimit.parse(res.headers);\n      if (state) {\n        httpResponse.rateLimitState = state;\n      }\n    }\n\n    if (options.observer) {\n      await notifyObserver(options.observer, {\n        url: req.url,\n        method: req.method ?? 'GET',\n        status: res.status,\n        resource: options.resource,\n        requestId: options.requestId ?? newRequestId(),\n        body,\n      });\n    }\n\n    if (res.ok) {\n      return httpResponse;\n    }\n\n    const retryAfter = parseRetryAfter(res.headers.get('retry-after'));\n    const message = `HTTP ${res.status} ${res.statusText} for ${req.method ?? 'GET'} ${req.url}`;\n    const err = errorForStatus(message, httpResponse, retryAfter);\n\n    if (\n      attempt < maxAttempts - 1 &&\n      retryOn(res.status, err) &&\n      !(err instanceof AuthError) &&\n      !(err instanceof ClientBugError)\n    ) {\n      lastErr = err;\n      let delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n      if (err instanceof RateLimitError && retryAfter) {\n        const wait = retryAfter.getTime() - Date.now();\n        if (wait > 0) {\n          delay = Math.min(wait, maxDelayMs);\n        }\n      }\n      await sleep(delay, req.signal);\n      continue;\n    }\n\n    throw err;\n  }\n\n  throw lastErr ?? new UpstreamBugError('Exhausted retry attempts');\n}\n\nfunction computeDelay(\n  attempt: number,\n  initialDelayMs: number,\n  maxDelayMs: number,\n): number {\n  const base = initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, maxDelayMs);\n}\n\nexport { HttpClientError };\n","export interface RateLimitState {\n  remaining: number;\n  resetAt: Date;\n}\n\nexport interface RateLimitPolicy {\n  parse(headers: Headers): RateLimitState | null;\n}\n\nexport interface StandardRateLimitPolicyConfig {\n  remainingHeader: string;\n  resetHeader: string;\n  resetUnit: 's' | 'ms';\n  resetFallbackMs?: number;\n}\n\nexport function standardRateLimitPolicy(\n  config: StandardRateLimitPolicyConfig,\n): RateLimitPolicy {\n  const { remainingHeader, resetHeader, resetUnit, resetFallbackMs } = config;\n  const multiplier = resetUnit === 's' ? 1000 : 1;\n  return {\n    parse(h) {\n      const remainingRaw = h.get(remainingHeader);\n      if (remainingRaw === null || remainingRaw.trim() === '') {\n        return null;\n      }\n      const remaining = Number(remainingRaw);\n      if (!Number.isFinite(remaining)) {\n        return null;\n      }\n      const resetRaw = h.get(resetHeader);\n      if (resetRaw === null) {\n        if (resetFallbackMs === undefined) {\n          return null;\n        }\n        return {\n          remaining,\n          resetAt: new Date(Date.now() + resetFallbackMs),\n        };\n      }\n      if (resetRaw.trim() === '') {\n        return null;\n      }\n      const reset = Number(resetRaw);\n      if (!Number.isFinite(reset) || reset < 0) {\n        return null;\n      }\n      const resetMs = reset * multiplier;\n      if (!Number.isFinite(resetMs)) {\n        return null;\n      }\n      return { remaining, resetAt: new Date(resetMs) };\n    },\n  };\n}\n","export async function mapWithConcurrency<T, R>(\n  items: readonly T[],\n  concurrency: number,\n  fn: (item: T, index: number) => Promise<R>,\n): Promise<R[]> {\n  const results = new Array<R>(items.length);\n  if (items.length === 0) {\n    return results;\n  }\n  const normalized = Number.isFinite(concurrency) ? Math.floor(concurrency) : 1;\n  const limit = Math.max(1, Math.min(normalized, items.length));\n  let next = 0;\n  let failed = false;\n\n  async function worker(): Promise<void> {\n    while (!failed) {\n      const i = next++;\n      if (i >= items.length) {\n        return;\n      }\n      try {\n        results[i] = await fn(items[i]!, i);\n      } catch (err) {\n        failed = true;\n        throw err;\n      }\n    }\n  }\n\n  const workers: Promise<void>[] = [];\n  for (let w = 0; w < limit; w++) {\n    workers.push(worker());\n  }\n  await Promise.all(workers);\n  return results;\n}\n","export interface SanitizeAllowedUrlOptions {\n  url: string | null;\n  host: string;\n  pathname: string;\n  protocol?: 'https:' | 'http:';\n}\n\nexport function sanitizeAllowedUrl(\n  options: SanitizeAllowedUrlOptions,\n): string | null {\n  const { url, host, pathname, protocol = 'https:' } = options;\n  if (url === null) {\n    return null;\n  }\n  try {\n    const u = new URL(url);\n    if (u.protocol !== protocol || u.host !== host || u.pathname !== pathname) {\n      return null;\n    }\n    return u.toString();\n  } catch {\n    return null;\n  }\n}\n","export type EpochUnit = 'ms' | 's' | 'iso';\n\nexport function parseEpoch(\n  value: number | string | null | undefined,\n  unit: EpochUnit,\n): number | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  if (unit === 'iso') {\n    if (typeof value !== 'string') {\n      return null;\n    }\n    const ms = new Date(value).getTime();\n    return Number.isFinite(ms) ? ms : null;\n  }\n  if (typeof value === 'string' && value.trim() === '') {\n    return null;\n  }\n  const n = typeof value === 'number' ? value : Number(value);\n  if (!Number.isFinite(n)) {\n    return null;\n  }\n  const result = unit === 's' ? n * 1000 : n;\n  return Number.isFinite(result) ? result : null;\n}\n","import { request } from './request';\nimport type { HttpRequest } from './types';\n\nexport function parseLinkHeader(header: string | null): Record<string, string> {\n  if (!header) {\n    return {};\n  }\n  const result: Record<string, string> = {};\n  for (const part of header.split(',')) {\n    const match = part.match(/<([^>]+)>\\s*;\\s*rel=\"([^\"]+)\"/);\n    if (match) {\n      result[match[2]!] = match[1]!;\n    }\n  }\n  return result;\n}\n\nexport async function* paginateLink<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => T[],\n  options: { resource: string },\n): AsyncIterable<T> {\n  let next: string | null = initial.url;\n  while (next) {\n    const res: Awaited<ReturnType<typeof request>> = await request(\n      {\n        ...initial,\n        url: next,\n      },\n      { resource: options.resource },\n    );\n    for (const item of parse(res.body)) {\n      yield item;\n    }\n    const links = parseLinkHeader(res.headers.get('link'));\n    next = links['next'] ?? null;\n  }\n}\n\nexport async function* paginateCursor<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; nextCursor: string | null },\n  buildNext: (req: HttpRequest, cursor: string) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let req: HttpRequest = initial;\n  while (true) {\n    const res = await request(req, { resource: options.resource });\n    const { items, nextCursor } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!nextCursor) {\n      return;\n    }\n    req = buildNext(req, nextCursor);\n  }\n}\n\nexport async function* paginatePage<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; hasMore: boolean },\n  buildPage: (req: HttpRequest, page: number) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let page = 1;\n  while (true) {\n    const req = page === 1 ? initial : buildPage(initial, page);\n    const res = await request(req, { resource: options.resource });\n    const { items, hasMore } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!hasMore || items.length === 0) {\n      return;\n    }\n    page++;\n  }\n}\n","export type LogFields = Record<string, unknown>;\n\nexport interface ConnectorLogger {\n  info(event: string, fields?: LogFields): void;\n  warn(event: string, fields?: LogFields): void;\n}\n\nexport interface ConnectorLoggerOptions {\n  scope: string;\n}\n\nconst MAX_VALUE_LEN = 120;\n\nfunction truncate(s: string, max = MAX_VALUE_LEN): string {\n  if (s.length <= max) {\n    return s;\n  }\n  return `${s.slice(0, max - 1)}…`;\n}\n\nfunction formatValue(value: unknown): string {\n  if (value === null) {\n    return 'null';\n  }\n  if (value === undefined) {\n    return '';\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'string') {\n    const t = truncate(value);\n    if (/[\\s\"=]/.test(t)) {\n      return JSON.stringify(t);\n    }\n    return t;\n  }\n  if (typeof value === 'bigint') {\n    return value.toString();\n  }\n  let json: string | undefined;\n  try {\n    json = JSON.stringify(value);\n  } catch {\n    json = undefined;\n  }\n  return truncate(json ?? String(value));\n}\n\nexport function formatLogFields(fields?: LogFields): string {\n  if (!fields) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const [k, v] of Object.entries(fields)) {\n    if (v === undefined) {\n      continue;\n    }\n    parts.push(`${k}=${formatValue(v)}`);\n  }\n  return parts.length > 0 ? ` ${parts.join(' ')}` : '';\n}\n\nexport function formatLogLine(\n  scope: string,\n  event: string,\n  fields?: LogFields,\n): string {\n  return `[${scope}] ${event}${formatLogFields(fields)}`;\n}\n\nexport function createDefaultConnectorLogger(\n  opts: ConnectorLoggerOptions,\n): ConnectorLogger {\n  return {\n    info(event, fields) {\n      console.info(formatLogLine(opts.scope, event, fields));\n    },\n    warn(event, fields) {\n      console.warn(formatLogLine(opts.scope, event, fields));\n    },\n  };\n}\n\nconst NOOP_LOGGER: ConnectorLogger = {\n  info() {},\n  warn() {},\n};\n\nexport function noopConnectorLogger(): ConnectorLogger {\n  return NOOP_LOGGER;\n}\n","import {\n  type HttpResponse,\n  connectorUserAgent,\n  parseEpoch,\n} from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\n  type ChunkedSyncCursor,\n  type ConnectorContext,\n  type ConnectorDoc,\n  type CredentialsSchema,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n  defineConnectorDoc,\n  defineResources,\n  makeChunkedCursorGuard,\n  paginateChunked,\n  schemasFromResources,\n  selectActivePhases,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\nexport const configFields = defineConfigFields(\n  z.object({\n    devKey: z.object({ $secret: z.string().min(1) }).meta({\n      label: 'Developer key',\n      description:\n        'BILL developer key that authorizes API access for your app. Find it in the BILL Developer portal under your app.',\n      placeholder: 'BILL_DEV_KEY',\n      secret: true,\n    }),\n    username: z.string().min(1).meta({\n      label: 'Username',\n      description:\n        'Email address of the BILL user the API signs in as. This user must have access to the organization you are syncing.',\n      placeholder: 'api-user@example.com',\n    }),\n    password: z.object({ $secret: z.string().min(1) }).meta({\n      label: 'Password',\n      description: 'Password for the BILL user. Stored as a secret.',\n      placeholder: 'BILL_PASSWORD',\n      secret: true,\n    }),\n    orgId: z.string().min(1).meta({\n      label: 'Organization ID',\n      description:\n        'BILL organization ID to sync. Find it in the BILL app URL or via the List Organizations API.',\n      placeholder: '00801ABCDEFGHIJKLMNO',\n    }),\n    resources: z\n      .array(z.enum(['bills', 'vendors', 'payments']))\n      .nonempty()\n      .optional()\n      .meta({\n        label: 'Resources',\n        description:\n          'Which BILL resources to sync. Omit to sync all of them (bills, vendors, payments).',\n      }),\n  }),\n);\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n  displayName: 'Bill.com',\n  category: 'finance',\n  brandColor: '#005DAA',\n  tagline:\n    'Sync accounts-payable bills, vendors, and vendor payments from BILL (Bill.com) for AP aging, bills-pending, and vendor-spend dashboards.',\n  vendor: {\n    name: 'Bill.com',\n    domain: 'bill.com',\n    apiDocs: 'https://developer.bill.com/docs/home',\n    website: 'https://www.bill.com',\n  },\n  auth: {\n    summary:\n      'Session-based sign in against the BILL v3 API. The connector signs in with a developer key, username, password, and organization ID to obtain a session, then reuses it for the rest of the sync.',\n    setup: [\n      'Request a BILL developer key from the BILL Developer portal and note the key value.',\n      'Create or choose a BILL user with access to the organization you want to sync.',\n      'Find the organization ID for that organization (visible in the app URL or via the List Organizations API).',\n      'Store the developer key and the user password as rawdash secrets and reference them from the connector config as `devKey: secret(\"BILL_DEV_KEY\")` and `password: secret(\"BILL_PASSWORD\")`.',\n    ],\n  },\n  rateLimit:\n    'BILL does not publish standard rate-limit response headers; the shared HTTP client retries 429 responses with exponential backoff. Sessions expire after 35 minutes of inactivity and are transparently re-established on a 401.',\n  limitations: [\n    'Monetary amounts are stored in major currency units (e.g. dollars), matching the BILL API, not in the smallest unit.',\n    'Incremental syncs filter on updatedTime, so status transitions (a bill moving from UNPAID to PAID) are picked up on the next run.',\n    'The set of synced resources is controlled by the `resources` config field; omit it to sync all of them.',\n    'Bill line items and approval workflow detail are out of scope; only the header-level bill, its vendor, and vendor payments are synced.',\n  ],\n});\n\nexport type BillResource = 'bills' | 'vendors' | 'payments';\n\nexport interface BillSettings {\n  orgId: string;\n  resources?: readonly BillResource[];\n}\n\nconst billCredentials = {\n  devKey: {\n    description: 'BILL developer key',\n    auth: 'required' as const,\n  },\n  username: {\n    description: 'BILL user email',\n    auth: 'required' as const,\n  },\n  password: {\n    description: 'BILL user password',\n    auth: 'required' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype BillCredentials = typeof billCredentials;\n\nconst API_BASE = 'https://gateway.prod.bill.com/connect/v3';\nconst PAGE_SIZE = 100;\n\nconst PHASE_ORDER = ['vendors', 'bills', 'payments'] as const;\n\ntype BillPhase = (typeof PHASE_ORDER)[number];\n\ntype BillSyncCursor = ChunkedSyncCursor<BillPhase, string>;\n\nconst isBillSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);\n\nconst VENDOR_ENTITY = 'bill_vendor';\nconst BILL_ENTITY = 'bill_bill';\nconst PAYMENT_EVENT = 'bill_payment';\n\nconst ENDPOINT_BY_PHASE: Record<BillPhase, string> = {\n  vendors: 'vendors',\n  bills: 'bills',\n  payments: 'payments',\n};\n\nfunction isAuthError(err: unknown): boolean {\n  return err instanceof Error && (err as { kind?: unknown }).kind === 'auth';\n}\n\nconst idString = z.string().min(1);\n\nconst loginSchema = z.object({\n  sessionId: idString,\n  organizationId: z.string().nullish(),\n  userId: z.string().nullish(),\n});\n\nconst vendorSchema = z.object({\n  id: idString,\n  name: z.string().nullish(),\n  email: z.string().nullish(),\n  accountNumber: z.string().nullish(),\n  phone: z.string().nullish(),\n  archived: z.boolean().nullish(),\n  billCurrency: z.string().nullish(),\n  createdTime: z.string().nullish(),\n  updatedTime: z.string().nullish(),\n});\n\nconst billSchema = z.object({\n  id: idString,\n  vendorId: z.string().nullish(),\n  amount: z.number().nullish(),\n  dueDate: z.string().nullish(),\n  invoice: z\n    .object({\n      invoiceNumber: z.string().nullish(),\n      invoiceDate: z.string().nullish(),\n    })\n    .nullish(),\n  paymentStatus: z.string().nullish(),\n  approvalStatus: z.string().nullish(),\n  archived: z.boolean().nullish(),\n  createdTime: z.string().nullish(),\n  updatedTime: z.string().nullish(),\n});\n\nconst paymentSchema = z.object({\n  id: idString,\n  vendorId: z.string().nullish(),\n  billId: z.string().nullish(),\n  amount: z.number().nullish(),\n  processDate: z.string().nullish(),\n  status: z.string().nullish(),\n  description: z.string().nullish(),\n  createdTime: z.string().nullish(),\n  updatedTime: z.string().nullish(),\n});\n\nconst listResponseSchema = <T extends z.ZodTypeAny>(item: T) =>\n  z.object({\n    results: z.array(item),\n    nextPage: z.string().nullish(),\n    prevPage: z.string().nullish(),\n  });\n\nconst vendorsListSchema = listResponseSchema(vendorSchema);\nconst billsListSchema = listResponseSchema(billSchema);\nconst paymentsListSchema = listResponseSchema(paymentSchema);\n\nexport const billResources = defineResources({\n  [VENDOR_ENTITY]: {\n    shape: 'entity',\n    filterable: [{ field: 'archived', ops: ['eq'], values: ['true', 'false'] }],\n    description:\n      'Vendors (suppliers) with name, contact details, account number, and archived state.',\n    endpoint: 'GET /v3/vendors',\n    notes:\n      'Incremental syncs filter on updatedTime and sort ascending so resumable pages stay ordered.',\n    fields: [\n      { name: 'name', description: 'Vendor display name.' },\n      { name: 'email', description: 'Vendor contact email, if set.' },\n      {\n        name: 'accountNumber',\n        description: 'Your account number with the vendor, if set.',\n      },\n      { name: 'phone', description: 'Vendor phone number, if set.' },\n      {\n        name: 'archived',\n        description: 'Whether the vendor has been archived.',\n      },\n      {\n        name: 'billCurrency',\n        description: 'Default bill currency for the vendor (ISO code).',\n      },\n      {\n        name: 'createdAt',\n        description: 'When the vendor was created (Unix ms).',\n      },\n    ],\n    responses: {\n      login: loginSchema,\n      vendors: vendorsListSchema,\n    },\n  },\n  [BILL_ENTITY]: {\n    shape: 'entity',\n    filterable: [\n      {\n        field: 'paymentStatus',\n        ops: ['eq'],\n        values: [\n          'UNPAID',\n          'PARTIALLY_PAID',\n          'PAID',\n          'SCHEDULED',\n          'PARTIALLY_SCHEDULED',\n        ],\n      },\n    ],\n    description:\n      'Accounts-payable bills with vendor, invoice number, invoice and due dates, amount, and payment status.',\n    endpoint: 'GET /v3/bills',\n    notes:\n      'Amounts are in the bill currency major units (e.g. dollars). Incremental syncs filter on updatedTime so status transitions are re-fetched.',\n    fields: [\n      { name: 'vendorId', description: 'Vendor the bill is owed to.' },\n      { name: 'invoiceNumber', description: 'Vendor invoice number, if set.' },\n      {\n        name: 'invoiceDate',\n        description: 'Invoice date (Unix ms), if set.',\n      },\n      { name: 'dueDate', description: 'Payment due date (Unix ms), if set.' },\n      {\n        name: 'amount',\n        description: 'Bill total in the bill currency major units.',\n      },\n      {\n        name: 'paymentStatus',\n        description: 'Payment status (UNPAID, PARTIALLY_PAID, PAID, ...).',\n      },\n      {\n        name: 'approvalStatus',\n        description: 'Approval status (UNASSIGNED, APPROVED, ...), if set.',\n      },\n      { name: 'archived', description: 'Whether the bill has been archived.' },\n      {\n        name: 'createdAt',\n        description: 'When the bill was created (Unix ms).',\n      },\n    ],\n    responses: { bills: billsListSchema },\n  },\n  [PAYMENT_EVENT]: {\n    shape: 'event',\n    filterable: [\n      {\n        field: 'status',\n        ops: ['eq'],\n        values: ['SCHEDULED', 'PAID', 'CANCELED'],\n      },\n    ],\n    description:\n      'Vendor payments (money sent to vendors), one event per payment timestamped at its process date.',\n    endpoint: 'GET /v3/payments',\n    fields: [\n      { name: 'id', description: 'BILL payment id.' },\n      { name: 'vendorId', description: 'Vendor paid, if set.' },\n      { name: 'billId', description: 'Bill the payment applies to, if set.' },\n      {\n        name: 'amount',\n        description: 'Payment amount in the payment currency major units.',\n      },\n      {\n        name: 'status',\n        description: 'Payment status (SCHEDULED, PAID, CANCELED).',\n      },\n      { name: 'description', description: 'Payment description, if set.' },\n      {\n        name: 'processDate',\n        description: 'Scheduled or actual process date (Unix ms), if set.',\n      },\n    ],\n    responses: { payments: paymentsListSchema },\n  },\n});\n\nexport const id = 'bill';\n\ntype BillLogin = z.infer<typeof loginSchema>;\ntype BillVendor = z.infer<typeof vendorSchema>;\ntype BillBill = z.infer<typeof billSchema>;\ntype BillPayment = z.infer<typeof paymentSchema>;\n\ninterface BillListResponse<T> {\n  results: T[];\n  nextPage?: string | null;\n  prevPage?: string | null;\n}\n\nexport class BillConnector extends BaseConnector<\n  BillSettings,\n  BillCredentials\n> {\n  static readonly id = id;\n\n  static readonly resources = billResources;\n\n  static readonly schemas = schemasFromResources(billResources);\n\n  static create(input: unknown, ctx?: ConnectorContext): BillConnector {\n    const parsed = configFields.parse(input);\n    return new BillConnector(\n      { orgId: parsed.orgId, resources: parsed.resources },\n      {\n        devKey: parsed.devKey,\n        username: parsed.username,\n        password: parsed.password,\n      },\n      ctx,\n    );\n  }\n\n  readonly id = id;\n  override readonly credentials = billCredentials;\n\n  private sessionId: string | null = null;\n\n  private baseHeaders(): Record<string, string> {\n    return {\n      Accept: 'application/json',\n      'Content-Type': 'application/json',\n      'User-Agent': connectorUserAgent('bill'),\n    };\n  }\n\n  private async refreshSession(signal?: AbortSignal): Promise<string> {\n    const res = await this.post<BillLogin>(`${API_BASE}/login`, {\n      resource: 'login',\n      headers: this.baseHeaders(),\n      body: JSON.stringify({\n        username: this.creds.username,\n        password: this.creds.password,\n        organizationId: this.settings.orgId,\n        devKey: this.creds.devKey,\n      }),\n      signal,\n    });\n    const sessionId = res.body.sessionId;\n    if (!sessionId) {\n      throw new Error('BILL login did not return a sessionId');\n    }\n    this.sessionId = sessionId;\n    return sessionId;\n  }\n\n  private async getSession(signal?: AbortSignal): Promise<string> {\n    if (this.sessionId) {\n      return this.sessionId;\n    }\n    return this.refreshSession(signal);\n  }\n\n  private async apiGet<T>(\n    url: string,\n    resource: string,\n    signal?: AbortSignal,\n    retried = false,\n  ): Promise<HttpResponse<T>> {\n    const sessionId = await this.getSession(signal);\n    try {\n      return await this.get<T>(url, {\n        resource,\n        headers: {\n          ...this.baseHeaders(),\n          sessionId,\n          devKey: this.creds.devKey,\n        },\n        signal,\n      });\n    } catch (err) {\n      if (!retried && isAuthError(err)) {\n        this.sessionId = null;\n        return this.apiGet<T>(url, resource, signal, true);\n      }\n      throw err;\n    }\n  }\n\n  private buildListUrl(\n    phase: BillPhase,\n    page: string | null,\n    options: SyncOptions,\n  ): string {\n    const url = new URL(`${API_BASE}/${ENDPOINT_BY_PHASE[phase]}`);\n    url.searchParams.set('max', String(PAGE_SIZE));\n    if (page) {\n      url.searchParams.set('page', page);\n      return url.toString();\n    }\n    url.searchParams.set('sort', 'updatedTime:asc');\n    if (options.since) {\n      const iso = new Date(options.since).toISOString();\n      url.searchParams.set('filters', `updatedTime:gte:\"${iso}\"`);\n    }\n    return url.toString();\n  }\n\n  private async fetchPage(\n    phase: BillPhase,\n    page: string | null,\n    options: SyncOptions,\n    signal: AbortSignal | undefined,\n  ): Promise<{ items: unknown[]; next: string | null }> {\n    const url = this.buildListUrl(phase, page, options);\n    const res = await this.apiGet<BillListResponse<{ id: string }>>(\n      url,\n      phase,\n      signal,\n    );\n    const results = res.body.results ?? [];\n    const nextPage = res.body.nextPage ?? null;\n    const next = nextPage && results.length > 0 ? nextPage : null;\n    return { items: results, next };\n  }\n\n  private async writeVendors(\n    storage: StorageHandle,\n    items: BillVendor[],\n  ): Promise<void> {\n    for (const v of items) {\n      const createdMs = parseEpoch(v.createdTime ?? null, 'iso');\n      const updatedMs = parseEpoch(v.updatedTime ?? null, 'iso');\n      await storage.entity({\n        type: VENDOR_ENTITY,\n        id: v.id,\n        attributes: {\n          name: v.name ?? null,\n          email: v.email ?? null,\n          accountNumber: v.accountNumber ?? null,\n          phone: v.phone ?? null,\n          archived: v.archived ?? false,\n          billCurrency: v.billCurrency ?? null,\n          createdAt: createdMs,\n        },\n        updated_at: updatedMs ?? createdMs ?? 0,\n      });\n    }\n  }\n\n  private async writeBills(\n    storage: StorageHandle,\n    items: BillBill[],\n  ): Promise<void> {\n    for (const b of items) {\n      const createdMs = parseEpoch(b.createdTime ?? null, 'iso');\n      const updatedMs = parseEpoch(b.updatedTime ?? null, 'iso');\n      await storage.entity({\n        type: BILL_ENTITY,\n        id: b.id,\n        attributes: {\n          vendorId: b.vendorId ?? null,\n          invoiceNumber: b.invoice?.invoiceNumber ?? null,\n          invoiceDate: parseEpoch(b.invoice?.invoiceDate ?? null, 'iso'),\n          dueDate: parseEpoch(b.dueDate ?? null, 'iso'),\n          amount: b.amount ?? null,\n          paymentStatus: b.paymentStatus ?? null,\n          approvalStatus: b.approvalStatus ?? null,\n          archived: b.archived ?? false,\n          createdAt: createdMs,\n        },\n        updated_at: updatedMs ?? createdMs ?? 0,\n      });\n    }\n  }\n\n  private async writePayments(\n    storage: StorageHandle,\n    items: BillPayment[],\n  ): Promise<void> {\n    for (const p of items) {\n      const createdMs = parseEpoch(p.createdTime ?? null, 'iso');\n      const processMs = parseEpoch(p.processDate ?? null, 'iso');\n      const ts = processMs ?? createdMs;\n      if (ts === null) {\n        continue;\n      }\n      await storage.event({\n        name: PAYMENT_EVENT,\n        start_ts: ts,\n        end_ts: null,\n        attributes: {\n          id: p.id,\n          vendorId: p.vendorId ?? null,\n          billId: p.billId ?? null,\n          amount: p.amount ?? null,\n          status: p.status ?? null,\n          description: p.description ?? null,\n          processDate: processMs,\n        },\n      });\n    }\n  }\n\n  private async writePhase(\n    storage: StorageHandle,\n    phase: BillPhase,\n    items: unknown[],\n  ): Promise<void> {\n    switch (phase) {\n      case 'vendors':\n        return this.writeVendors(storage, items as BillVendor[]);\n      case 'bills':\n        return this.writeBills(storage, items as BillBill[]);\n      case 'payments':\n        return this.writePayments(storage, items as BillPayment[]);\n    }\n  }\n\n  private async clearScopeOnFirstPage(\n    storage: StorageHandle,\n    phase: BillPhase,\n    isFull: boolean,\n  ): Promise<void> {\n    if (!isFull) {\n      return;\n    }\n    switch (phase) {\n      case 'vendors':\n        await storage.entities([], { types: [VENDOR_ENTITY] });\n        return;\n      case 'bills':\n        await storage.entities([], { types: [BILL_ENTITY] });\n        return;\n      case 'payments':\n        await storage.events([], { names: [PAYMENT_EVENT] });\n        return;\n    }\n  }\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const cursor: BillSyncCursor | undefined = isBillSyncCursor(options.cursor)\n      ? options.cursor\n      : undefined;\n    const isFull = options.mode === 'full';\n\n    const phases = selectActivePhases<BillResource, BillPhase>(\n      (r) => r,\n      PHASE_ORDER,\n      this.settings.resources,\n    );\n\n    return paginateChunked<BillPhase, string>({\n      phases,\n      cursor,\n      signal,\n      logger: this.logger,\n      fetchPage: (phase, page, sig) =>\n        this.fetchPage(phase, page, options, sig),\n      writeBatch: async (phase, items, page) => {\n        if (page === null) {\n          await this.clearScopeOnFirstPage(storage, phase, isFull);\n        }\n        await this.writePhase(storage, phase, items);\n      },\n    });\n  }\n}\n","import { BillConnector } from './bill';\n\nexport {\n  configFields,\n  doc,\n  id,\n  billResources as resources,\n  BillConnector,\n} from './bill';\nexport type { BillResource, BillSettings } from './bill';\nexport default BillConnector;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rawdash/connector-bill",
+  "version": "0.28.2",
+  "description": "Rawdash connector for BILL (Bill.com) — accounts payable bills, vendors, and payments",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/bill"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "@rawdash/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@rawdash/core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@rawdash/connector-shared": "workspace:*",
+    "@rawdash/connector-test-utils": "workspace:*",
+    "fast-check": "^4.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.4"
+  }
+}