@rawdash/connector-expensify 0.28.2

package/README.md

@@ -0,0 +1,140 @@
+<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
+
+# @rawdash/connector-expensify
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/connector-expensify)](https://www.npmjs.com/package/@rawdash/connector-expensify)
+[![license](https://img.shields.io/npm/l/@rawdash/connector-expensify)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+Sync Expensify expense reports, individual expenses, and daily category spend for finance-ops dashboards: reports pending, month-to-date spend, and spend by category.
+
+## Install
+
+```sh
+npm install @rawdash/connector-expensify
+```
+
+## Authentication
+
+Expensify API partner credentials (partnerUserID + partnerUserSecret). Both are sent in the credentials block of every Integration Server request over HTTPS.
+
+1. In the Expensify web app, open Settings → Account → API and generate a partnerUserID / partnerUserSecret credential pair.
+2. Set the partnerUserID as the `partnerName` config field.
+3. Store the partnerUserSecret as a secret and reference it from config as `partnerPassword: secret("EXPENSIFY_PARTNER_PASSWORD")`.
+
+## Configuration
+
+| Field             | Type   | Required | Description                                                                                                                                          |
+| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `partnerName`     | string | Yes      | The Expensify API partnerUserID. Generate a credential pair in the Expensify web app under Settings → Account → API, and use the partnerUserID here. |
+| `partnerPassword` | secret | Yes      | The Expensify API partnerUserSecret paired with the partnerUserID. Store it as a secret.                                                             |
+| `lookbackDays`    | number | No       | How many calendar days of reports (by submit/created date) to fetch on a full sync. Defaults to 180.                                                 |
+| `resources`       | array  | No       | Which Expensify resources to sync. Omit to sync all of them.                                                                                         |
+
+## Resources
+
+- **`expensify_report`** _(entity)_ - Expense reports with total, currency, workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, ...), submitter, and submit/approve timestamps.
+  - Endpoint: `POST /ExpensifyIntegrations (combinedReportData)`
+  - `reportName`: Report title.
+  - `total` _(cents)_: Report total in the smallest currency unit.
+  - `currency`: ISO currency code of the report.
+  - `status`: Workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, CLOSED, ...), uppercased.
+  - `submitterEmail`: Email of the report submitter.
+  - `submittedDate`: Submission timestamp, if any.
+  - `approvedDate`: Approval timestamp, if any.
+  - `policyName`: Expense policy the report is under.
+  - `expenseCount`: Number of expenses on the report.
+- **`expensify_expense`** _(event)_ - Individual expenses (one event per transaction) timestamped at the expense creation date, carrying merchant, amount, currency, category, and parent report.
+  - Endpoint: `POST /ExpensifyIntegrations (combinedReportData)`
+  - Derived from the transactionList of every report in the lookback window and rewritten on every sync, so resyncs are idempotent.
+  - `expenseId`: Expensify transaction id.
+  - `reportId`: Parent report id.
+  - `merchant`: Merchant name.
+  - `amount` _(cents)_: Expense amount in the smallest currency unit.
+  - `currency`: ISO currency code of the expense.
+  - `category`: Expense category, if categorized.
+  - `created`: Expense creation date (YYYY-MM-DD).
+  - `comment`: Free-text comment on the expense.
+  - `reimbursable`: Whether the expense is reimbursable.
+- **`expensify_category_spend`** _(metric)_ - Daily expense spend bucketed by category and currency: the summed expense amount per (creation day, category, currency).
+  - Endpoint: `POST /ExpensifyIntegrations (combinedReportData)`
+  - Unit: cents
+  - Granularity: day
+  - Dimensions: `date`, `category`, `currency`
+  - Measures: `expenseCount`
+  - Aggregated in the connector from the same combinedReportData export used for reports and expenses. The metric value is the summed amount (smallest currency unit) for the bucket.
+
+## Example
+
+```ts
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const expensify = {
+  name: 'expensify',
+  connectorId: 'expensify',
+  config: {
+    partnerName: 'your_partnerUserID',
+    partnerPassword: secret('EXPENSIFY_PARTNER_PASSWORD'),
+    lookbackDays: 180,
+  },
+};
+
+export default defineConfig({
+  connectors: [expensify],
+  dashboards: {
+    finance: defineDashboard({
+      widgets: {
+        spend_mtd: {
+          kind: 'stat',
+          title: 'Spend (30d)',
+          window: '30d',
+          metric: defineMetric({
+            connector: expensify,
+            shape: 'metric',
+            name: 'expensify_category_spend',
+            field: 'value',
+            fn: 'sum',
+          }),
+        },
+        daily_spend: {
+          kind: 'timeseries',
+          title: 'Daily spend',
+          window: '90d',
+          metric: defineMetric({
+            connector: expensify,
+            shape: 'metric',
+            name: 'expensify_category_spend',
+            field: 'value',
+            fn: 'sum',
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Rate limits
+
+Expensify does not publish a fixed per-credential request rate limit. The connector issues at most two requests per sync (a report-export generate call followed by a download call) and relies on the shared HTTP client to honor 429 responses with backoff.
+
+## Limitations
+
+- Reports and expenses are fetched over a rolling lookback window (lookbackDays) and rewritten on every sync, so reports and expenses older than the window age out of storage. Category-spend metric history outside the window is preserved across incremental syncs.
+- Amounts are reported in the smallest unit of each expense currency (e.g. cents for USD), matching the Expensify Integration Server output.
+- The connector reads report data via the combinedReportData export (reports plus their transaction lists). Line-item receipt images and audit-log detail are out of scope.
+- Category-spend is bucketed per (created day, category, currency); expenses without a category are grouped under "Uncategorized".
+
+## Links
+
+- [Rawdash docs](https://rawdash.dev/docs/connectors)
+- [Expensify API docs](https://integrations.expensify.com/Integration-Server/doc/)
+- [GitHub](https://github.com/rawdash/rawdash)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,443 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    partnerName: z.ZodString;
+    partnerPassword: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    lookbackDays: z.ZodOptional<z.ZodNumber>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        reports: "reports";
+        expenses: "expenses";
+        expense_categories: "expense_categories";
+    }>>>;
+}, z.core.$strip>;
+declare const doc: ConnectorDoc;
+type ExpensifyResource = 'reports' | 'expenses' | 'expense_categories';
+interface ExpensifySettings {
+    partnerName: string;
+    lookbackDays?: number;
+    resources?: readonly ExpensifyResource[];
+}
+declare const expensifyCredentials: {
+    partnerPassword: {
+        description: string;
+        auth: "required";
+    };
+};
+type ExpensifyCredentials = typeof expensifyCredentials;
+declare const expensifyResources: {
+    readonly expensify_report: {
+        readonly shape: "entity";
+        readonly description: "Expense reports with total, currency, workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, ...), submitter, and submit/approve timestamps.";
+        readonly endpoint: "POST /ExpensifyIntegrations (combinedReportData)";
+        readonly filterable: [];
+        readonly fields: [{
+            readonly name: "reportName";
+            readonly description: "Report title.";
+        }, {
+            readonly name: "total";
+            readonly description: "Report total in the smallest currency unit.";
+            readonly unit: "cents";
+        }, {
+            readonly name: "currency";
+            readonly description: "ISO currency code of the report.";
+        }, {
+            readonly name: "status";
+            readonly description: "Workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, CLOSED, ...), uppercased.";
+        }, {
+            readonly name: "submitterEmail";
+            readonly description: "Email of the report submitter.";
+        }, {
+            readonly name: "submittedDate";
+            readonly description: "Submission timestamp, if any.";
+        }, {
+            readonly name: "approvedDate";
+            readonly description: "Approval timestamp, if any.";
+        }, {
+            readonly name: "policyName";
+            readonly description: "Expense policy the report is under.";
+        }, {
+            readonly name: "expenseCount";
+            readonly description: "Number of expenses on the report.";
+        }];
+        readonly responses: {
+            readonly reports: z.ZodArray<z.ZodObject<{
+                reportID: z.ZodString;
+                reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    transactionID: z.ZodString;
+                    merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    amount: z.ZodNumber;
+                    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    created: z.ZodString;
+                    comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                }, z.core.$strip>>>>;
+            }, z.core.$strip>>;
+        };
+    };
+    readonly expensify_expense: {
+        readonly shape: "event";
+        readonly description: "Individual expenses (one event per transaction) timestamped at the expense creation date, carrying merchant, amount, currency, category, and parent report.";
+        readonly endpoint: "POST /ExpensifyIntegrations (combinedReportData)";
+        readonly notes: "Derived from the transactionList of every report in the lookback window and rewritten on every sync, so resyncs are idempotent.";
+        readonly filterable: [];
+        readonly fields: [{
+            readonly name: "expenseId";
+            readonly description: "Expensify transaction id.";
+        }, {
+            readonly name: "reportId";
+            readonly description: "Parent report id.";
+        }, {
+            readonly name: "merchant";
+            readonly description: "Merchant name.";
+        }, {
+            readonly name: "amount";
+            readonly description: "Expense amount in the smallest currency unit.";
+            readonly unit: "cents";
+        }, {
+            readonly name: "currency";
+            readonly description: "ISO currency code of the expense.";
+        }, {
+            readonly name: "category";
+            readonly description: "Expense category, if categorized.";
+        }, {
+            readonly name: "created";
+            readonly description: "Expense creation date (YYYY-MM-DD).";
+        }, {
+            readonly name: "comment";
+            readonly description: "Free-text comment on the expense.";
+        }, {
+            readonly name: "reimbursable";
+            readonly description: "Whether the expense is reimbursable.";
+        }];
+        readonly responses: {
+            readonly expenses: z.ZodArray<z.ZodObject<{
+                reportID: z.ZodString;
+                reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    transactionID: z.ZodString;
+                    merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    amount: z.ZodNumber;
+                    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    created: z.ZodString;
+                    comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                }, z.core.$strip>>>>;
+            }, z.core.$strip>>;
+        };
+    };
+    readonly expensify_category_spend: {
+        readonly shape: "metric";
+        readonly description: "Daily expense spend bucketed by category and currency: the summed expense amount per (creation day, category, currency).";
+        readonly endpoint: "POST /ExpensifyIntegrations (combinedReportData)";
+        readonly unit: "cents";
+        readonly granularity: "day";
+        readonly notes: "Aggregated in the connector from the same combinedReportData export used for reports and expenses. The metric value is the summed amount (smallest currency unit) for the bucket.";
+        readonly dimensions: [{
+            readonly name: "date";
+            readonly description: "Expense creation day (YYYY-MM-DD).";
+        }, {
+            readonly name: "category";
+            readonly description: "Expense category, or \"Uncategorized\" when absent.";
+        }, {
+            readonly name: "currency";
+            readonly description: "ISO currency code the amount is denominated in.";
+        }];
+        readonly measures: [{
+            readonly name: "expenseCount";
+            readonly description: "Number of expenses aggregated into the bucket.";
+        }];
+        readonly responses: {
+            readonly expense_categories: z.ZodArray<z.ZodObject<{
+                reportID: z.ZodString;
+                reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                    transactionID: z.ZodString;
+                    merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    amount: z.ZodNumber;
+                    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    created: z.ZodString;
+                    comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                }, z.core.$strip>>>>;
+            }, z.core.$strip>>;
+        };
+    };
+};
+declare const id = "expensify";
+declare class ExpensifyConnector extends BaseConnector<ExpensifySettings, ExpensifyCredentials> {
+    static readonly id = "expensify";
+    static readonly resources: {
+        readonly expensify_report: {
+            readonly shape: "entity";
+            readonly description: "Expense reports with total, currency, workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, ...), submitter, and submit/approve timestamps.";
+            readonly endpoint: "POST /ExpensifyIntegrations (combinedReportData)";
+            readonly filterable: [];
+            readonly fields: [{
+                readonly name: "reportName";
+                readonly description: "Report title.";
+            }, {
+                readonly name: "total";
+                readonly description: "Report total in the smallest currency unit.";
+                readonly unit: "cents";
+            }, {
+                readonly name: "currency";
+                readonly description: "ISO currency code of the report.";
+            }, {
+                readonly name: "status";
+                readonly description: "Workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, CLOSED, ...), uppercased.";
+            }, {
+                readonly name: "submitterEmail";
+                readonly description: "Email of the report submitter.";
+            }, {
+                readonly name: "submittedDate";
+                readonly description: "Submission timestamp, if any.";
+            }, {
+                readonly name: "approvedDate";
+                readonly description: "Approval timestamp, if any.";
+            }, {
+                readonly name: "policyName";
+                readonly description: "Expense policy the report is under.";
+            }, {
+                readonly name: "expenseCount";
+                readonly description: "Number of expenses on the report.";
+            }];
+            readonly responses: {
+                readonly reports: z.ZodArray<z.ZodObject<{
+                    reportID: z.ZodString;
+                    reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                        transactionID: z.ZodString;
+                        merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        amount: z.ZodNumber;
+                        currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        created: z.ZodString;
+                        comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    }, z.core.$strip>>>>;
+                }, z.core.$strip>>;
+            };
+        };
+        readonly expensify_expense: {
+            readonly shape: "event";
+            readonly description: "Individual expenses (one event per transaction) timestamped at the expense creation date, carrying merchant, amount, currency, category, and parent report.";
+            readonly endpoint: "POST /ExpensifyIntegrations (combinedReportData)";
+            readonly notes: "Derived from the transactionList of every report in the lookback window and rewritten on every sync, so resyncs are idempotent.";
+            readonly filterable: [];
+            readonly fields: [{
+                readonly name: "expenseId";
+                readonly description: "Expensify transaction id.";
+            }, {
+                readonly name: "reportId";
+                readonly description: "Parent report id.";
+            }, {
+                readonly name: "merchant";
+                readonly description: "Merchant name.";
+            }, {
+                readonly name: "amount";
+                readonly description: "Expense amount in the smallest currency unit.";
+                readonly unit: "cents";
+            }, {
+                readonly name: "currency";
+                readonly description: "ISO currency code of the expense.";
+            }, {
+                readonly name: "category";
+                readonly description: "Expense category, if categorized.";
+            }, {
+                readonly name: "created";
+                readonly description: "Expense creation date (YYYY-MM-DD).";
+            }, {
+                readonly name: "comment";
+                readonly description: "Free-text comment on the expense.";
+            }, {
+                readonly name: "reimbursable";
+                readonly description: "Whether the expense is reimbursable.";
+            }];
+            readonly responses: {
+                readonly expenses: z.ZodArray<z.ZodObject<{
+                    reportID: z.ZodString;
+                    reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                        transactionID: z.ZodString;
+                        merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        amount: z.ZodNumber;
+                        currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        created: z.ZodString;
+                        comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    }, z.core.$strip>>>>;
+                }, z.core.$strip>>;
+            };
+        };
+        readonly expensify_category_spend: {
+            readonly shape: "metric";
+            readonly description: "Daily expense spend bucketed by category and currency: the summed expense amount per (creation day, category, currency).";
+            readonly endpoint: "POST /ExpensifyIntegrations (combinedReportData)";
+            readonly unit: "cents";
+            readonly granularity: "day";
+            readonly notes: "Aggregated in the connector from the same combinedReportData export used for reports and expenses. The metric value is the summed amount (smallest currency unit) for the bucket.";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Expense creation day (YYYY-MM-DD).";
+            }, {
+                readonly name: "category";
+                readonly description: "Expense category, or \"Uncategorized\" when absent.";
+            }, {
+                readonly name: "currency";
+                readonly description: "ISO currency code the amount is denominated in.";
+            }];
+            readonly measures: [{
+                readonly name: "expenseCount";
+                readonly description: "Number of expenses aggregated into the bucket.";
+            }];
+            readonly responses: {
+                readonly expense_categories: z.ZodArray<z.ZodObject<{
+                    reportID: z.ZodString;
+                    reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                        transactionID: z.ZodString;
+                        merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        amount: z.ZodNumber;
+                        currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        created: z.ZodString;
+                        comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                    }, z.core.$strip>>>>;
+                }, z.core.$strip>>;
+            };
+        };
+    };
+    static readonly schemas: {
+        readonly reports: z.ZodArray<z.ZodObject<{
+            reportID: z.ZodString;
+            reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                transactionID: z.ZodString;
+                merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                amount: z.ZodNumber;
+                currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                created: z.ZodString;
+                comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            }, z.core.$strip>>>>;
+        }, z.core.$strip>>;
+    } & {
+        readonly expenses: z.ZodArray<z.ZodObject<{
+            reportID: z.ZodString;
+            reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                transactionID: z.ZodString;
+                merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                amount: z.ZodNumber;
+                currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                created: z.ZodString;
+                comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            }, z.core.$strip>>>>;
+        }, z.core.$strip>>;
+    } & {
+        readonly expense_categories: z.ZodArray<z.ZodObject<{
+            reportID: z.ZodString;
+            reportName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            submitterEmail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            submittedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            approvedDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            policyName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            transactionList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                transactionID: z.ZodString;
+                merchant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                amount: z.ZodNumber;
+                currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                created: z.ZodString;
+                comment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                reimbursable: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            }, z.core.$strip>>>>;
+        }, z.core.$strip>>;
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    static create(input: unknown, ctx?: ConnectorContext): ExpensifyConnector;
+    readonly id = "expensify";
+    readonly credentials: {
+        partnerPassword: {
+            description: string;
+            auth: "required";
+        };
+    };
+    private buildHeaders;
+    private credentialsBlock;
+    private postJob;
+    private fetchCombinedReportData;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { ExpensifyConnector, type ExpensifySettings, configFields, ExpensifyConnector as default, doc, id, expensifyResources 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)`;
+}
+
+// src/expensify.ts
+import {
+  BaseConnector,
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  metricSample,
+  schemasFromResources
+} from "@rawdash/core";
+import { z } from "zod";
+var configFields = defineConfigFields(
+  z.object({
+    partnerName: z.string().min(1).meta({
+      label: "Partner user ID",
+      description: "The Expensify API partnerUserID. Generate a credential pair in the Expensify web app under Settings \u2192 Account \u2192 API, and use the partnerUserID here.",
+      placeholder: "your_partnerUserID"
+    }),
+    partnerPassword: z.object({ $secret: z.string() }).meta({
+      label: "Partner user secret",
+      description: "The Expensify API partnerUserSecret paired with the partnerUserID. Store it as a secret.",
+      placeholder: "xxxxxxxxxxxxxxxx",
+      secret: true
+    }),
+    lookbackDays: z.number().int().positive().optional().meta({
+      label: "Lookback days (full sync)",
+      description: "How many calendar days of reports (by submit/created date) to fetch on a full sync. Defaults to 180.",
+      placeholder: "180"
+    }),
+    resources: z.array(z.enum(["reports", "expenses", "expense_categories"])).nonempty().optional().meta({
+      label: "Resources",
+      description: "Which Expensify resources to sync. Omit to sync all of them."
+    })
+  })
+);
+var doc = defineConnectorDoc({
+  displayName: "Expensify",
+  category: "finance",
+  brandColor: "#03D47C",
+  tagline: "Sync Expensify expense reports, individual expenses, and daily category spend for finance-ops dashboards: reports pending, month-to-date spend, and spend by category.",
+  vendor: {
+    name: "Expensify",
+    domain: "expensify.com",
+    apiDocs: "https://integrations.expensify.com/Integration-Server/doc/",
+    website: "https://www.expensify.com"
+  },
+  auth: {
+    summary: "Expensify API partner credentials (partnerUserID + partnerUserSecret). Both are sent in the credentials block of every Integration Server request over HTTPS.",
+    setup: [
+      "In the Expensify web app, open Settings \u2192 Account \u2192 API and generate a partnerUserID / partnerUserSecret credential pair.",
+      "Set the partnerUserID as the `partnerName` config field.",
+      'Store the partnerUserSecret as a secret and reference it from config as `partnerPassword: secret("EXPENSIFY_PARTNER_PASSWORD")`.'
+    ]
+  },
+  rateLimit: "Expensify does not publish a fixed per-credential request rate limit. The connector issues at most two requests per sync (a report-export generate call followed by a download call) and relies on the shared HTTP client to honor 429 responses with backoff.",
+  limitations: [
+    "Reports and expenses are fetched over a rolling lookback window (lookbackDays) and rewritten on every sync, so reports and expenses older than the window age out of storage. Category-spend metric history outside the window is preserved across incremental syncs.",
+    "Amounts are reported in the smallest unit of each expense currency (e.g. cents for USD), matching the Expensify Integration Server output.",
+    "The connector reads report data via the combinedReportData export (reports plus their transaction lists). Line-item receipt images and audit-log detail are out of scope.",
+    'Category-spend is bucketed per (created day, category, currency); expenses without a category are grouped under "Uncategorized".'
+  ]
+});
+var expensifyCredentials = {
+  partnerPassword: {
+    description: "Expensify API partnerUserSecret",
+    auth: "required"
+  }
+};
+var ENDPOINT = "https://integrations.expensify.com/Integration-Server/ExpensifyIntegrations";
+var MS_PER_DAY = 24 * 60 * 60 * 1e3;
+var DEFAULT_LOOKBACK_DAYS = 180;
+var INCREMENTAL_LOOKBACK_DAYS = 30;
+var REPORT_ENTITY = "expensify_report";
+var EXPENSE_EVENT = "expensify_expense";
+var CATEGORY_METRIC = "expensify_category_spend";
+var ALL_RESOURCES = [
+  "reports",
+  "expenses",
+  "expense_categories"
+];
+var dateString = z.string().regex(/^(19|20)\d{2}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/);
+var isoTimestampString = z.string().regex(
+  /^\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}(?::\d{2})?(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?)?$/
+);
+var expenseSchema = z.object({
+  transactionID: z.string().min(1),
+  merchant: z.string().nullish(),
+  amount: z.number(),
+  currency: z.string().nullish(),
+  category: z.string().nullish(),
+  created: dateString,
+  comment: z.string().nullish(),
+  reimbursable: z.boolean().nullish()
+});
+var reportSchema = z.object({
+  reportID: z.string().min(1),
+  reportName: z.string().nullish(),
+  total: z.number().nullish(),
+  currency: z.string().nullish(),
+  status: z.string().nullish(),
+  submitterEmail: z.string().nullish(),
+  submittedDate: isoTimestampString.nullish(),
+  approvedDate: isoTimestampString.nullish(),
+  policyName: z.string().nullish(),
+  transactionList: z.array(expenseSchema).nullish()
+});
+var combinedReportSchema = z.array(reportSchema);
+var expensifyResources = defineResources({
+  [REPORT_ENTITY]: {
+    shape: "entity",
+    description: "Expense reports with total, currency, workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, ...), submitter, and submit/approve timestamps.",
+    endpoint: "POST /ExpensifyIntegrations (combinedReportData)",
+    filterable: [],
+    fields: [
+      { name: "reportName", description: "Report title." },
+      {
+        name: "total",
+        description: "Report total in the smallest currency unit.",
+        unit: "cents"
+      },
+      { name: "currency", description: "ISO currency code of the report." },
+      {
+        name: "status",
+        description: "Workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, CLOSED, ...), uppercased."
+      },
+      { name: "submitterEmail", description: "Email of the report submitter." },
+      { name: "submittedDate", description: "Submission timestamp, if any." },
+      { name: "approvedDate", description: "Approval timestamp, if any." },
+      {
+        name: "policyName",
+        description: "Expense policy the report is under."
+      },
+      {
+        name: "expenseCount",
+        description: "Number of expenses on the report."
+      }
+    ],
+    responses: { reports: combinedReportSchema }
+  },
+  [EXPENSE_EVENT]: {
+    shape: "event",
+    description: "Individual expenses (one event per transaction) timestamped at the expense creation date, carrying merchant, amount, currency, category, and parent report.",
+    endpoint: "POST /ExpensifyIntegrations (combinedReportData)",
+    notes: "Derived from the transactionList of every report in the lookback window and rewritten on every sync, so resyncs are idempotent.",
+    filterable: [],
+    fields: [
+      { name: "expenseId", description: "Expensify transaction id." },
+      { name: "reportId", description: "Parent report id." },
+      { name: "merchant", description: "Merchant name." },
+      {
+        name: "amount",
+        description: "Expense amount in the smallest currency unit.",
+        unit: "cents"
+      },
+      { name: "currency", description: "ISO currency code of the expense." },
+      { name: "category", description: "Expense category, if categorized." },
+      { name: "created", description: "Expense creation date (YYYY-MM-DD)." },
+      { name: "comment", description: "Free-text comment on the expense." },
+      {
+        name: "reimbursable",
+        description: "Whether the expense is reimbursable."
+      }
+    ],
+    responses: { expenses: combinedReportSchema }
+  },
+  [CATEGORY_METRIC]: {
+    shape: "metric",
+    description: "Daily expense spend bucketed by category and currency: the summed expense amount per (creation day, category, currency).",
+    endpoint: "POST /ExpensifyIntegrations (combinedReportData)",
+    unit: "cents",
+    granularity: "day",
+    notes: "Aggregated in the connector from the same combinedReportData export used for reports and expenses. The metric value is the summed amount (smallest currency unit) for the bucket.",
+    dimensions: [
+      {
+        name: "date",
+        description: "Expense creation day (YYYY-MM-DD)."
+      },
+      {
+        name: "category",
+        description: 'Expense category, or "Uncategorized" when absent.'
+      },
+      {
+        name: "currency",
+        description: "ISO currency code the amount is denominated in."
+      }
+    ],
+    measures: [
+      {
+        name: "expenseCount",
+        description: "Number of expenses aggregated into the bucket."
+      }
+    ],
+    responses: { expense_categories: combinedReportSchema }
+  }
+});
+function pad2(n) {
+  return String(n).padStart(2, "0");
+}
+function toIsoDate(ms) {
+  const d = new Date(ms);
+  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+}
+function startOfUtcDay(ms) {
+  return Math.floor(ms / MS_PER_DAY) * MS_PER_DAY;
+}
+function isoDateToMs(date) {
+  const [y, m, d] = date.slice(0, 10).split("-").map(Number);
+  if (y === void 0 || m === void 0 || d === void 0 || !Number.isFinite(y) || !Number.isFinite(m) || !Number.isFinite(d)) {
+    return NaN;
+  }
+  return Date.UTC(y, m - 1, d);
+}
+function parseTimestamp(value) {
+  if (!value) {
+    return null;
+  }
+  const direct = Date.parse(value.replace(" ", "T"));
+  if (Number.isFinite(direct)) {
+    return direct;
+  }
+  const dayMs = isoDateToMs(value);
+  return Number.isFinite(dayMs) ? dayMs : null;
+}
+function getReportWindow(options, lookbackDays, now = Date.now()) {
+  const today = startOfUtcDay(now);
+  if (options.mode === "latest") {
+    return {
+      from: toIsoDate(today - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY),
+      to: toIsoDate(today)
+    };
+  }
+  if (options.since) {
+    const sinceMs = new Date(options.since).getTime();
+    if (Number.isFinite(sinceMs)) {
+      const requested = Math.max(
+        1,
+        Math.ceil((today - startOfUtcDay(sinceMs)) / MS_PER_DAY) + 1
+      );
+      const capped = Math.min(requested, lookbackDays);
+      return {
+        from: toIsoDate(today - (capped - 1) * MS_PER_DAY),
+        to: toIsoDate(today)
+      };
+    }
+  }
+  return {
+    from: toIsoDate(today - (lookbackDays - 1) * MS_PER_DAY),
+    to: toIsoDate(today)
+  };
+}
+function reportToEntity(report) {
+  const updatedAt = parseTimestamp(report.approvedDate) ?? parseTimestamp(report.submittedDate) ?? 0;
+  const attributes = {
+    reportName: report.reportName ?? null,
+    total: report.total ?? null,
+    currency: report.currency ?? null,
+    status: report.status ? report.status.toUpperCase() : null,
+    submitterEmail: report.submitterEmail ?? null,
+    submittedDate: report.submittedDate ?? null,
+    approvedDate: report.approvedDate ?? null,
+    policyName: report.policyName ?? null,
+    expenseCount: report.transactionList?.length ?? 0
+  };
+  return {
+    type: REPORT_ENTITY,
+    id: report.reportID,
+    attributes,
+    updated_at: updatedAt
+  };
+}
+function reportToExpenseEvents(report) {
+  return (report.transactionList ?? []).map((expense) => {
+    const ts = isoDateToMs(expense.created);
+    const attributes = {
+      expenseId: expense.transactionID,
+      reportId: report.reportID,
+      merchant: expense.merchant ?? null,
+      amount: expense.amount,
+      currency: expense.currency ?? report.currency ?? null,
+      category: expense.category ?? null,
+      created: expense.created,
+      comment: expense.comment ?? null,
+      reimbursable: expense.reimbursable ?? null
+    };
+    return {
+      name: EXPENSE_EVENT,
+      start_ts: Number.isFinite(ts) ? ts : 0,
+      end_ts: null,
+      attributes
+    };
+  });
+}
+function categoryBuckets(reports) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const report of reports) {
+    for (const expense of report.transactionList ?? []) {
+      const date = expense.created;
+      const category = expense.category ?? "Uncategorized";
+      const currency = expense.currency ?? report.currency ?? "USD";
+      const key = `${date}\0${category}\0${currency}`;
+      let bucket = byKey.get(key);
+      if (!bucket) {
+        bucket = { date, category, currency, total: 0, count: 0 };
+        byKey.set(key, bucket);
+      }
+      bucket.total += expense.amount;
+      bucket.count += 1;
+    }
+  }
+  return Array.from(byKey.values()).sort(
+    (a, b) => a.date < b.date ? -1 : a.date > b.date ? 1 : 0
+  );
+}
+function categoryBucketToMetricSample(bucket) {
+  const ts = isoDateToMs(bucket.date);
+  return metricSample(expensifyResources, CATEGORY_METRIC, {
+    ts: Number.isFinite(ts) ? ts : 0,
+    value: bucket.total,
+    attributes: {
+      date: bucket.date,
+      category: bucket.category,
+      currency: bucket.currency,
+      expenseCount: bucket.count
+    }
+  });
+}
+function parseReportArray(body) {
+  let candidate = body;
+  if (typeof body === "string") {
+    const trimmed = body.trim();
+    if (!trimmed.startsWith("[")) {
+      return null;
+    }
+    try {
+      candidate = JSON.parse(trimmed);
+    } catch {
+      return null;
+    }
+  }
+  if (!Array.isArray(candidate)) {
+    return null;
+  }
+  return combinedReportSchema.parse(candidate);
+}
+function expensifyErrorMessage(body) {
+  if (body && typeof body === "object" && !Array.isArray(body) && "responseCode" in body) {
+    const record = body;
+    const code = typeof record.responseCode === "number" ? record.responseCode : null;
+    if (code !== null && code >= 200 && code < 300) {
+      return null;
+    }
+    const message = typeof record.responseMessage === "string" ? record.responseMessage : "unknown error";
+    return `Expensify Integration Server error ${code ?? "unknown"}: ${message}`;
+  }
+  return null;
+}
+function extractFileName(body) {
+  if (typeof body !== "string") {
+    return null;
+  }
+  const trimmed = body.trim();
+  return trimmed.length > 0 && !trimmed.startsWith("[") && !trimmed.startsWith("{") ? trimmed : null;
+}
+var COMBINED_REPORT_TEMPLATE = `[<#list reports as report><#if report_index != 0>,</#if>{"reportID":"\${report.reportID}","reportName":"\${(report.reportName)!''}","total":\${(report.total)!0},"currency":"\${(report.currency)!''}","status":"\${(report.status)!''}","submitterEmail":"\${(report.submitterEmail)!''}","submittedDate":"\${(report.submitted)!''}","approvedDate":"\${(report.approved)!''}","policyName":"\${(report.policyName)!''}","transactionList":[<#list report.transactionList as expense><#if expense_index != 0>,</#if>{"transactionID":"\${expense.transactionID}","merchant":"\${(expense.merchant)!''}","amount":\${(expense.amount)!0},"currency":"\${(expense.currency)!''}","category":"\${(expense.category)!''}","created":"\${expense.created}","comment":"\${(expense.comment)!''}","reimbursable":\${(expense.reimbursable)?c}}</#list>]}</#list>]`;
+var id = "expensify";
+var ExpensifyConnector = class _ExpensifyConnector extends BaseConnector {
+  static id = id;
+  static resources = expensifyResources;
+  static schemas = schemasFromResources(expensifyResources);
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _ExpensifyConnector(
+      {
+        partnerName: parsed.partnerName,
+        lookbackDays: parsed.lookbackDays,
+        resources: parsed.resources
+      },
+      { partnerPassword: parsed.partnerPassword },
+      ctx
+    );
+  }
+  id = id;
+  credentials = expensifyCredentials;
+  buildHeaders() {
+    return {
+      "Content-Type": "application/x-www-form-urlencoded",
+      "User-Agent": connectorUserAgent("expensify")
+    };
+  }
+  credentialsBlock() {
+    return {
+      partnerUserID: this.settings.partnerName,
+      partnerUserSecret: this.creds.partnerPassword
+    };
+  }
+  async postJob(requestJobDescription, resource, template, signal) {
+    const form = new URLSearchParams({
+      requestJobDescription: JSON.stringify(requestJobDescription)
+    });
+    if (template !== void 0) {
+      form.set("template", template);
+    }
+    const res = await this.post(ENDPOINT, {
+      resource,
+      headers: this.buildHeaders(),
+      body: form.toString(),
+      signal
+    });
+    return res.body;
+  }
+  async fetchCombinedReportData(window, signal) {
+    const generated = await this.postJob(
+      {
+        type: "file",
+        credentials: this.credentialsBlock(),
+        onReceive: { immediateResponse: ["returnRandomFileName"] },
+        inputSettings: {
+          type: "combinedReportData",
+          filters: { startDate: window.from, endDate: window.to }
+        },
+        outputSettings: { fileExtension: "json" }
+      },
+      "reports_generate",
+      COMBINED_REPORT_TEMPLATE,
+      signal
+    );
+    const generatedError = expensifyErrorMessage(generated);
+    if (generatedError) {
+      throw new Error(generatedError);
+    }
+    const inline = parseReportArray(generated);
+    if (inline) {
+      return inline;
+    }
+    const fileName = extractFileName(generated);
+    if (!fileName) {
+      throw new Error(
+        "Expensify: report-export generate call returned neither report data nor a file name."
+      );
+    }
+    const downloaded = await this.postJob(
+      {
+        type: "download",
+        credentials: this.credentialsBlock(),
+        fileName,
+        fileSystem: "integrationServer"
+      },
+      "reports_download",
+      void 0,
+      signal
+    );
+    const downloadedError = expensifyErrorMessage(downloaded);
+    if (downloadedError) {
+      throw new Error(downloadedError);
+    }
+    const data = parseReportArray(downloaded);
+    if (!data) {
+      throw new Error(
+        `Expensify: download of report file "${fileName}" did not return report data.`
+      );
+    }
+    return data;
+  }
+  async sync(options, storage, signal) {
+    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;
+    const window = getReportWindow(options, lookbackDays);
+    const active = new Set(
+      this.settings.resources ?? ALL_RESOURCES
+    );
+    const reports = await this.fetchCombinedReportData(window, signal);
+    if (active.has("reports")) {
+      const entities = reports.map(reportToEntity);
+      await storage.entities(entities, { types: [REPORT_ENTITY] });
+    }
+    if (active.has("expenses")) {
+      const events = reports.flatMap(reportToExpenseEvents);
+      await storage.events(events, { names: [EXPENSE_EVENT] });
+    }
+    if (active.has("expense_categories")) {
+      const buckets = categoryBuckets(reports);
+      const samples = buckets.map(categoryBucketToMetricSample);
+      const fromMs = isoDateToMs(window.from);
+      const toMs = isoDateToMs(window.to);
+      const times = samples.map((s) => s.ts);
+      const replaceWindow = Number.isFinite(fromMs) && Number.isFinite(toMs) ? {
+        start: Math.min(fromMs, ...times),
+        end: Math.max(toMs + MS_PER_DAY - 1, ...times)
+      } : void 0;
+      await storage.metrics(samples, {
+        names: [CATEGORY_METRIC],
+        ...replaceWindow ? { replaceWindow } : {}
+      });
+    }
+    return { done: true };
+  }
+};
+
+// src/index.ts
+var index_default = ExpensifyConnector;
+export {
+  ExpensifyConnector,
+  configFields,
+  index_default as default,
+  doc,
+  id,
+  expensifyResources 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/expensify.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 { connectorUserAgent } from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\n  type ConnectorContext,\n  type ConnectorDoc,\n  type CredentialsSchema,\n  type Entity,\n  type Event,\n  type JSONValue,\n  type MetricSample,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n  defineConnectorDoc,\n  defineResources,\n  metricSample,\n  schemasFromResources,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\nexport const configFields = defineConfigFields(\n  z.object({\n    partnerName: z.string().min(1).meta({\n      label: 'Partner user ID',\n      description:\n        'The Expensify API partnerUserID. Generate a credential pair in the Expensify web app under Settings → Account → API, and use the partnerUserID here.',\n      placeholder: 'your_partnerUserID',\n    }),\n    partnerPassword: z.object({ $secret: z.string() }).meta({\n      label: 'Partner user secret',\n      description:\n        'The Expensify API partnerUserSecret paired with the partnerUserID. Store it as a secret.',\n      placeholder: 'xxxxxxxxxxxxxxxx',\n      secret: true,\n    }),\n    lookbackDays: z.number().int().positive().optional().meta({\n      label: 'Lookback days (full sync)',\n      description:\n        'How many calendar days of reports (by submit/created date) to fetch on a full sync. Defaults to 180.',\n      placeholder: '180',\n    }),\n    resources: z\n      .array(z.enum(['reports', 'expenses', 'expense_categories']))\n      .nonempty()\n      .optional()\n      .meta({\n        label: 'Resources',\n        description:\n          'Which Expensify resources to sync. Omit to sync all of them.',\n      }),\n  }),\n);\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n  displayName: 'Expensify',\n  category: 'finance',\n  brandColor: '#03D47C',\n  tagline:\n    'Sync Expensify expense reports, individual expenses, and daily category spend for finance-ops dashboards: reports pending, month-to-date spend, and spend by category.',\n  vendor: {\n    name: 'Expensify',\n    domain: 'expensify.com',\n    apiDocs: 'https://integrations.expensify.com/Integration-Server/doc/',\n    website: 'https://www.expensify.com',\n  },\n  auth: {\n    summary:\n      'Expensify API partner credentials (partnerUserID + partnerUserSecret). Both are sent in the credentials block of every Integration Server request over HTTPS.',\n    setup: [\n      'In the Expensify web app, open Settings → Account → API and generate a partnerUserID / partnerUserSecret credential pair.',\n      'Set the partnerUserID as the `partnerName` config field.',\n      'Store the partnerUserSecret as a secret and reference it from config as `partnerPassword: secret(\"EXPENSIFY_PARTNER_PASSWORD\")`.',\n    ],\n  },\n  rateLimit:\n    'Expensify does not publish a fixed per-credential request rate limit. The connector issues at most two requests per sync (a report-export generate call followed by a download call) and relies on the shared HTTP client to honor 429 responses with backoff.',\n  limitations: [\n    'Reports and expenses are fetched over a rolling lookback window (lookbackDays) and rewritten on every sync, so reports and expenses older than the window age out of storage. Category-spend metric history outside the window is preserved across incremental syncs.',\n    'Amounts are reported in the smallest unit of each expense currency (e.g. cents for USD), matching the Expensify Integration Server output.',\n    'The connector reads report data via the combinedReportData export (reports plus their transaction lists). Line-item receipt images and audit-log detail are out of scope.',\n    'Category-spend is bucketed per (created day, category, currency); expenses without a category are grouped under \"Uncategorized\".',\n  ],\n});\n\nexport type ExpensifyResource = 'reports' | 'expenses' | 'expense_categories';\n\nexport interface ExpensifySettings {\n  partnerName: string;\n  lookbackDays?: number;\n  resources?: readonly ExpensifyResource[];\n}\n\nconst expensifyCredentials = {\n  partnerPassword: {\n    description: 'Expensify API partnerUserSecret',\n    auth: 'required' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype ExpensifyCredentials = typeof expensifyCredentials;\n\nconst ENDPOINT =\n  'https://integrations.expensify.com/Integration-Server/ExpensifyIntegrations';\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\nconst DEFAULT_LOOKBACK_DAYS = 180;\nconst INCREMENTAL_LOOKBACK_DAYS = 30;\n\nconst REPORT_ENTITY = 'expensify_report';\nconst EXPENSE_EVENT = 'expensify_expense';\nconst CATEGORY_METRIC = 'expensify_category_spend';\n\nconst ALL_RESOURCES: readonly ExpensifyResource[] = [\n  'reports',\n  'expenses',\n  'expense_categories',\n];\n\nconst dateString = z\n  .string()\n  .regex(/^(19|20)\\d{2}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$/);\n\nconst isoTimestampString = z\n  .string()\n  .regex(\n    /^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2})?(?:\\.\\d+)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$/,\n  );\n\nconst expenseSchema = z.object({\n  transactionID: z.string().min(1),\n  merchant: z.string().nullish(),\n  amount: z.number(),\n  currency: z.string().nullish(),\n  category: z.string().nullish(),\n  created: dateString,\n  comment: z.string().nullish(),\n  reimbursable: z.boolean().nullish(),\n});\n\nconst reportSchema = z.object({\n  reportID: z.string().min(1),\n  reportName: z.string().nullish(),\n  total: z.number().nullish(),\n  currency: z.string().nullish(),\n  status: z.string().nullish(),\n  submitterEmail: z.string().nullish(),\n  submittedDate: isoTimestampString.nullish(),\n  approvedDate: isoTimestampString.nullish(),\n  policyName: z.string().nullish(),\n  transactionList: z.array(expenseSchema).nullish(),\n});\n\nconst combinedReportSchema = z.array(reportSchema);\n\nexport type ExpensifyReport = z.infer<typeof reportSchema>;\nexport type ExpensifyExpense = z.infer<typeof expenseSchema>;\n\nexport const expensifyResources = defineResources({\n  [REPORT_ENTITY]: {\n    shape: 'entity',\n    description:\n      'Expense reports with total, currency, workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, ...), submitter, and submit/approve timestamps.',\n    endpoint: 'POST /ExpensifyIntegrations (combinedReportData)',\n    filterable: [],\n    fields: [\n      { name: 'reportName', description: 'Report title.' },\n      {\n        name: 'total',\n        description: 'Report total in the smallest currency unit.',\n        unit: 'cents',\n      },\n      { name: 'currency', description: 'ISO currency code of the report.' },\n      {\n        name: 'status',\n        description:\n          'Workflow status (OPEN, SUBMITTED, APPROVED, REIMBURSED, CLOSED, ...), uppercased.',\n      },\n      { name: 'submitterEmail', description: 'Email of the report submitter.' },\n      { name: 'submittedDate', description: 'Submission timestamp, if any.' },\n      { name: 'approvedDate', description: 'Approval timestamp, if any.' },\n      {\n        name: 'policyName',\n        description: 'Expense policy the report is under.',\n      },\n      {\n        name: 'expenseCount',\n        description: 'Number of expenses on the report.',\n      },\n    ],\n    responses: { reports: combinedReportSchema },\n  },\n  [EXPENSE_EVENT]: {\n    shape: 'event',\n    description:\n      'Individual expenses (one event per transaction) timestamped at the expense creation date, carrying merchant, amount, currency, category, and parent report.',\n    endpoint: 'POST /ExpensifyIntegrations (combinedReportData)',\n    notes:\n      'Derived from the transactionList of every report in the lookback window and rewritten on every sync, so resyncs are idempotent.',\n    filterable: [],\n    fields: [\n      { name: 'expenseId', description: 'Expensify transaction id.' },\n      { name: 'reportId', description: 'Parent report id.' },\n      { name: 'merchant', description: 'Merchant name.' },\n      {\n        name: 'amount',\n        description: 'Expense amount in the smallest currency unit.',\n        unit: 'cents',\n      },\n      { name: 'currency', description: 'ISO currency code of the expense.' },\n      { name: 'category', description: 'Expense category, if categorized.' },\n      { name: 'created', description: 'Expense creation date (YYYY-MM-DD).' },\n      { name: 'comment', description: 'Free-text comment on the expense.' },\n      {\n        name: 'reimbursable',\n        description: 'Whether the expense is reimbursable.',\n      },\n    ],\n    responses: { expenses: combinedReportSchema },\n  },\n  [CATEGORY_METRIC]: {\n    shape: 'metric',\n    description:\n      'Daily expense spend bucketed by category and currency: the summed expense amount per (creation day, category, currency).',\n    endpoint: 'POST /ExpensifyIntegrations (combinedReportData)',\n    unit: 'cents',\n    granularity: 'day',\n    notes:\n      'Aggregated in the connector from the same combinedReportData export used for reports and expenses. The metric value is the summed amount (smallest currency unit) for the bucket.',\n    dimensions: [\n      {\n        name: 'date',\n        description: 'Expense creation day (YYYY-MM-DD).',\n      },\n      {\n        name: 'category',\n        description: 'Expense category, or \"Uncategorized\" when absent.',\n      },\n      {\n        name: 'currency',\n        description: 'ISO currency code the amount is denominated in.',\n      },\n    ],\n    measures: [\n      {\n        name: 'expenseCount',\n        description: 'Number of expenses aggregated into the bucket.',\n      },\n    ],\n    responses: { expense_categories: combinedReportSchema },\n  },\n});\n\ninterface DateWindow {\n  from: string;\n  to: string;\n}\n\nfunction pad2(n: number): string {\n  return String(n).padStart(2, '0');\n}\n\nfunction toIsoDate(ms: number): string {\n  const d = new Date(ms);\n  return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;\n}\n\nfunction startOfUtcDay(ms: number): number {\n  return Math.floor(ms / MS_PER_DAY) * MS_PER_DAY;\n}\n\nfunction isoDateToMs(date: string): number {\n  const [y, m, d] = date.slice(0, 10).split('-').map(Number);\n  if (\n    y === undefined ||\n    m === undefined ||\n    d === undefined ||\n    !Number.isFinite(y) ||\n    !Number.isFinite(m) ||\n    !Number.isFinite(d)\n  ) {\n    return NaN;\n  }\n  return Date.UTC(y, m - 1, d);\n}\n\nfunction parseTimestamp(value: string | null | undefined): number | null {\n  if (!value) {\n    return null;\n  }\n  const direct = Date.parse(value.replace(' ', 'T'));\n  if (Number.isFinite(direct)) {\n    return direct;\n  }\n  const dayMs = isoDateToMs(value);\n  return Number.isFinite(dayMs) ? dayMs : null;\n}\n\nexport function getReportWindow(\n  options: SyncOptions,\n  lookbackDays: number,\n  now: number = Date.now(),\n): DateWindow {\n  const today = startOfUtcDay(now);\n  if (options.mode === 'latest') {\n    return {\n      from: toIsoDate(today - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY),\n      to: toIsoDate(today),\n    };\n  }\n  if (options.since) {\n    const sinceMs = new Date(options.since).getTime();\n    if (Number.isFinite(sinceMs)) {\n      const requested = Math.max(\n        1,\n        Math.ceil((today - startOfUtcDay(sinceMs)) / MS_PER_DAY) + 1,\n      );\n      const capped = Math.min(requested, lookbackDays);\n      return {\n        from: toIsoDate(today - (capped - 1) * MS_PER_DAY),\n        to: toIsoDate(today),\n      };\n    }\n  }\n  return {\n    from: toIsoDate(today - (lookbackDays - 1) * MS_PER_DAY),\n    to: toIsoDate(today),\n  };\n}\n\nexport function reportToEntity(report: ExpensifyReport): Entity {\n  const updatedAt =\n    parseTimestamp(report.approvedDate) ??\n    parseTimestamp(report.submittedDate) ??\n    0;\n  const attributes: Record<string, JSONValue> = {\n    reportName: report.reportName ?? null,\n    total: report.total ?? null,\n    currency: report.currency ?? null,\n    status: report.status ? report.status.toUpperCase() : null,\n    submitterEmail: report.submitterEmail ?? null,\n    submittedDate: report.submittedDate ?? null,\n    approvedDate: report.approvedDate ?? null,\n    policyName: report.policyName ?? null,\n    expenseCount: report.transactionList?.length ?? 0,\n  };\n  return {\n    type: REPORT_ENTITY,\n    id: report.reportID,\n    attributes,\n    updated_at: updatedAt,\n  };\n}\n\nexport function reportToExpenseEvents(report: ExpensifyReport): Event[] {\n  return (report.transactionList ?? []).map((expense) => {\n    const ts = isoDateToMs(expense.created);\n    const attributes: Record<string, JSONValue> = {\n      expenseId: expense.transactionID,\n      reportId: report.reportID,\n      merchant: expense.merchant ?? null,\n      amount: expense.amount,\n      currency: expense.currency ?? report.currency ?? null,\n      category: expense.category ?? null,\n      created: expense.created,\n      comment: expense.comment ?? null,\n      reimbursable: expense.reimbursable ?? null,\n    };\n    return {\n      name: EXPENSE_EVENT,\n      start_ts: Number.isFinite(ts) ? ts : 0,\n      end_ts: null,\n      attributes,\n    };\n  });\n}\n\ninterface CategoryBucket {\n  date: string;\n  category: string;\n  currency: string;\n  total: number;\n  count: number;\n}\n\nexport function categoryBuckets(reports: ExpensifyReport[]): CategoryBucket[] {\n  const byKey = new Map<string, CategoryBucket>();\n  for (const report of reports) {\n    for (const expense of report.transactionList ?? []) {\n      const date = expense.created;\n      const category = expense.category ?? 'Uncategorized';\n      const currency = expense.currency ?? report.currency ?? 'USD';\n      const key = `${date}\u0000${category}\u0000${currency}`;\n      let bucket = byKey.get(key);\n      if (!bucket) {\n        bucket = { date, category, currency, total: 0, count: 0 };\n        byKey.set(key, bucket);\n      }\n      bucket.total += expense.amount;\n      bucket.count += 1;\n    }\n  }\n  return Array.from(byKey.values()).sort((a, b) =>\n    a.date < b.date ? -1 : a.date > b.date ? 1 : 0,\n  );\n}\n\nexport function categoryBucketToMetricSample(\n  bucket: CategoryBucket,\n): MetricSample {\n  const ts = isoDateToMs(bucket.date);\n  return metricSample(expensifyResources, CATEGORY_METRIC, {\n    ts: Number.isFinite(ts) ? ts : 0,\n    value: bucket.total,\n    attributes: {\n      date: bucket.date,\n      category: bucket.category,\n      currency: bucket.currency,\n      expenseCount: bucket.count,\n    },\n  });\n}\n\nfunction parseReportArray(body: unknown): ExpensifyReport[] | null {\n  let candidate: unknown = body;\n  if (typeof body === 'string') {\n    const trimmed = body.trim();\n    if (!trimmed.startsWith('[')) {\n      return null;\n    }\n    try {\n      candidate = JSON.parse(trimmed);\n    } catch {\n      return null;\n    }\n  }\n  if (!Array.isArray(candidate)) {\n    return null;\n  }\n  return combinedReportSchema.parse(candidate);\n}\n\nfunction expensifyErrorMessage(body: unknown): string | null {\n  if (\n    body &&\n    typeof body === 'object' &&\n    !Array.isArray(body) &&\n    'responseCode' in body\n  ) {\n    const record = body as {\n      responseCode?: unknown;\n      responseMessage?: unknown;\n    };\n    const code =\n      typeof record.responseCode === 'number' ? record.responseCode : null;\n    if (code !== null && code >= 200 && code < 300) {\n      return null;\n    }\n    const message =\n      typeof record.responseMessage === 'string'\n        ? record.responseMessage\n        : 'unknown error';\n    return `Expensify Integration Server error ${code ?? 'unknown'}: ${message}`;\n  }\n  return null;\n}\n\nfunction extractFileName(body: unknown): string | null {\n  if (typeof body !== 'string') {\n    return null;\n  }\n  const trimmed = body.trim();\n  return trimmed.length > 0 &&\n    !trimmed.startsWith('[') &&\n    !trimmed.startsWith('{')\n    ? trimmed\n    : null;\n}\n\nconst COMBINED_REPORT_TEMPLATE =\n  '[<#list reports as report><#if report_index != 0>,</#if>' +\n  '{\"reportID\":\"${report.reportID}\",\"reportName\":\"${(report.reportName)!\\'\\'}\",' +\n  '\"total\":${(report.total)!0},\"currency\":\"${(report.currency)!\\'\\'}\",' +\n  '\"status\":\"${(report.status)!\\'\\'}\",\"submitterEmail\":\"${(report.submitterEmail)!\\'\\'}\",' +\n  '\"submittedDate\":\"${(report.submitted)!\\'\\'}\",\"approvedDate\":\"${(report.approved)!\\'\\'}\",' +\n  '\"policyName\":\"${(report.policyName)!\\'\\'}\",\"transactionList\":[' +\n  '<#list report.transactionList as expense><#if expense_index != 0>,</#if>' +\n  '{\"transactionID\":\"${expense.transactionID}\",\"merchant\":\"${(expense.merchant)!\\'\\'}\",' +\n  '\"amount\":${(expense.amount)!0},\"currency\":\"${(expense.currency)!\\'\\'}\",' +\n  '\"category\":\"${(expense.category)!\\'\\'}\",\"created\":\"${expense.created}\",' +\n  '\"comment\":\"${(expense.comment)!\\'\\'}\",\"reimbursable\":${(expense.reimbursable)?c}}' +\n  '</#list>]}</#list>]';\n\nexport const id = 'expensify';\n\nexport class ExpensifyConnector extends BaseConnector<\n  ExpensifySettings,\n  ExpensifyCredentials\n> {\n  static readonly id = id;\n\n  static readonly resources = expensifyResources;\n\n  static readonly schemas = schemasFromResources(expensifyResources);\n\n  static create(input: unknown, ctx?: ConnectorContext): ExpensifyConnector {\n    const parsed = configFields.parse(input);\n    return new ExpensifyConnector(\n      {\n        partnerName: parsed.partnerName,\n        lookbackDays: parsed.lookbackDays,\n        resources: parsed.resources,\n      },\n      { partnerPassword: parsed.partnerPassword },\n      ctx,\n    );\n  }\n\n  readonly id = id;\n  override readonly credentials = expensifyCredentials;\n\n  private buildHeaders(): Record<string, string> {\n    return {\n      'Content-Type': 'application/x-www-form-urlencoded',\n      'User-Agent': connectorUserAgent('expensify'),\n    };\n  }\n\n  private credentialsBlock(): {\n    partnerUserID: string;\n    partnerUserSecret: string;\n  } {\n    return {\n      partnerUserID: this.settings.partnerName,\n      partnerUserSecret: this.creds.partnerPassword,\n    };\n  }\n\n  private async postJob(\n    requestJobDescription: Record<string, unknown>,\n    resource: string,\n    template: string | undefined,\n    signal?: AbortSignal,\n  ): Promise<unknown> {\n    const form = new URLSearchParams({\n      requestJobDescription: JSON.stringify(requestJobDescription),\n    });\n    if (template !== undefined) {\n      form.set('template', template);\n    }\n    const res = await this.post<unknown>(ENDPOINT, {\n      resource,\n      headers: this.buildHeaders(),\n      body: form.toString(),\n      signal,\n    });\n    return res.body;\n  }\n\n  private async fetchCombinedReportData(\n    window: DateWindow,\n    signal?: AbortSignal,\n  ): Promise<ExpensifyReport[]> {\n    const generated = await this.postJob(\n      {\n        type: 'file',\n        credentials: this.credentialsBlock(),\n        onReceive: { immediateResponse: ['returnRandomFileName'] },\n        inputSettings: {\n          type: 'combinedReportData',\n          filters: { startDate: window.from, endDate: window.to },\n        },\n        outputSettings: { fileExtension: 'json' },\n      },\n      'reports_generate',\n      COMBINED_REPORT_TEMPLATE,\n      signal,\n    );\n    const generatedError = expensifyErrorMessage(generated);\n    if (generatedError) {\n      throw new Error(generatedError);\n    }\n    const inline = parseReportArray(generated);\n    if (inline) {\n      return inline;\n    }\n    const fileName = extractFileName(generated);\n    if (!fileName) {\n      throw new Error(\n        'Expensify: report-export generate call returned neither report data nor a file name.',\n      );\n    }\n    const downloaded = await this.postJob(\n      {\n        type: 'download',\n        credentials: this.credentialsBlock(),\n        fileName,\n        fileSystem: 'integrationServer',\n      },\n      'reports_download',\n      undefined,\n      signal,\n    );\n    const downloadedError = expensifyErrorMessage(downloaded);\n    if (downloadedError) {\n      throw new Error(downloadedError);\n    }\n    const data = parseReportArray(downloaded);\n    if (!data) {\n      throw new Error(\n        `Expensify: download of report file \"${fileName}\" did not return report data.`,\n      );\n    }\n    return data;\n  }\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;\n    const window = getReportWindow(options, lookbackDays);\n    const active = new Set<ExpensifyResource>(\n      this.settings.resources ?? ALL_RESOURCES,\n    );\n\n    const reports = await this.fetchCombinedReportData(window, signal);\n\n    if (active.has('reports')) {\n      const entities = reports.map(reportToEntity);\n      await storage.entities(entities, { types: [REPORT_ENTITY] });\n    }\n\n    if (active.has('expenses')) {\n      const events = reports.flatMap(reportToExpenseEvents);\n      await storage.events(events, { names: [EXPENSE_EVENT] });\n    }\n\n    if (active.has('expense_categories')) {\n      const buckets = categoryBuckets(reports);\n      const samples = buckets.map(categoryBucketToMetricSample);\n      const fromMs = isoDateToMs(window.from);\n      const toMs = isoDateToMs(window.to);\n      const times = samples.map((s) => s.ts);\n      const replaceWindow =\n        Number.isFinite(fromMs) && Number.isFinite(toMs)\n          ? {\n              start: Math.min(fromMs, ...times),\n              end: Math.max(toMs + MS_PER_DAY - 1, ...times),\n            }\n          : undefined;\n      await storage.metrics(samples, {\n        names: [CATEGORY_METRIC],\n        ...(replaceWindow ? { replaceWindow } : {}),\n      });\n    }\n\n    return { done: true };\n  }\n}\n","import { ExpensifyConnector } from './expensify';\n\nexport {\n  configFields,\n  doc,\n  ExpensifyConnector,\n  expensifyResources as resources,\n  id,\n} from './expensify';\nexport type { ExpensifySettings } from './expensify';\nexport default ExpensifyConnector;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rawdash/connector-expensify",
+  "version": "0.28.2",
+  "description": "Rawdash connector for Expensify — expense reports, expenses, and category spend",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/expensify"
+  },
+  "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"
+  }
+}