@warmio/contracts 3.0.9 → 3.0.10

package/dist/mcp/findings.d.ts.map

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

package/dist/mcp/findings.js

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+export const getFindingsMcpInputShape = {};
+export const getFindingsMcpInputSchema = z.object(getFindingsMcpInputShape).strict();
+export const FINDINGS_CONTRACT_VERSION = 1;
+export const FINDINGS_RECENT_DAYS = 30;
+export const FINDINGS_UPCOMING_DAYS = 14;
+export const FINDINGS_MAX_ITEMS = 100;
+export const FINDING_TYPES = [
+    'connection_repair',
+    'payment_due',
+    'upcoming_charge',
+    'unusual_charge',
+    'duplicate_charge',
+    'above_average_charge',
+    'fee_charged',
+    'low_cash',
+];
+export const FINDING_ACCOUNT_KINDS = [
+    'credit',
+    'depository',
+    'loan',
+    'investment',
+    'other',
+];
+export const FINDING_CANCEL_ACTION_TYPES = [
+    'cancel_subscription',
+    'manage_subscription',
+    'contact_support',
+];
+const dateSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, 'Expected YYYY-MM-DD date.');
+const dateTimeSchema = z.string().datetime({ offset: true });
+const idSchema = z.string().min(1).max(256);
+const signedAmountSchema = z.number().describe('Negative for money out, positive for money in.');
+const owedAmountSchema = z.number().describe('Amount owed, as a positive number.');
+export const findingAccountSchema = z
+    .object({
+    name: z.string().nullable(),
+    institution: z.string().nullable(),
+    mask: z.string().nullable(),
+    kind: z.enum(FINDING_ACCOUNT_KINDS),
+})
+    .strict();
+const linkSchema = z
+    .object({
+    label: z.string(),
+    url: z.string().url(),
+})
+    .strict();
+export const findingCancelOptionsSchema = z
+    .object({
+    actions: z.array(linkSchema.extend({ type: z.enum(FINDING_CANCEL_ACTION_TYPES) }).strict()),
+    billing_alternatives: z
+        .array(linkSchema)
+        .describe('App store billing pages. Each applies only if the user pays through that store.'),
+})
+    .strict();
+const baseFields = {
+    id: idSchema,
+    title: z.string(),
+    warm_url: z.string().url(),
+};
+const chargeFields = {
+    ...baseFields,
+    account: findingAccountSchema.nullable(),
+    currency: z.string(),
+};
+const recurringFields = {
+    ...chargeFields,
+    merchant: z.string(),
+    frequency: z.string().nullable(),
+    last_amount: signedAmountSchema.nullable(),
+    average_amount: signedAmountSchema.nullable(),
+    cancel: findingCancelOptionsSchema.nullable(),
+};
+const chargeEvidenceSchema = z
+    .object({
+    transaction_id: idSchema.nullable(),
+    date: dateSchema,
+    amount: signedAmountSchema,
+})
+    .strict();
+export const findingSchema = z.discriminatedUnion('type', [
+    z
+        .object({
+        ...baseFields,
+        type: z.literal('connection_repair'),
+        institution: z.string().nullable(),
+        since: dateSchema.nullable(),
+    })
+        .strict(),
+    z
+        .object({
+        ...chargeFields,
+        type: z.literal('payment_due'),
+        due_date: dateSchema.nullable(),
+        overdue: z.boolean(),
+        minimum_payment: owedAmountSchema.nullable(),
+        statement_balance: owedAmountSchema.nullable(),
+        apr_percentage: z.number().nullable(),
+    })
+        .strict(),
+    z
+        .object({
+        ...recurringFields,
+        type: z.literal('upcoming_charge'),
+        expected_date: dateSchema.describe('Date Warm expects the next charge, from the past pattern.'),
+    })
+        .strict(),
+    z
+        .object({
+        ...chargeFields,
+        type: z.literal('unusual_charge'),
+        reason: z.enum(['first_time_large', 'above_usual']),
+        transaction_id: idSchema.nullable(),
+        date: dateSchema.describe('Date the charge posted.'),
+        amount: signedAmountSchema,
+        usual_amount: signedAmountSchema.nullable(),
+        merchant: z.string().nullable(),
+        category: z.string().nullable(),
+    })
+        .strict(),
+    z
+        .object({
+        ...chargeFields,
+        type: z.literal('duplicate_charge'),
+        merchant: z.string().nullable(),
+        charges: z.array(chargeEvidenceSchema).min(2),
+    })
+        .strict(),
+    z
+        .object({
+        ...recurringFields,
+        type: z.literal('above_average_charge'),
+        last_date: dateSchema.nullable(),
+    })
+        .strict(),
+    z
+        .object({
+        ...chargeFields,
+        type: z.literal('fee_charged'),
+        transaction_id: idSchema,
+        date: dateSchema.describe('Date the fee posted.'),
+        amount: signedAmountSchema,
+        name: z.string(),
+        detailed_category: z.string().nullable(),
+    })
+        .strict(),
+    z
+        .object({
+        ...baseFields,
+        type: z.literal('low_cash'),
+        account: findingAccountSchema.nullable(),
+        currency: z.string(),
+        observed_on: dateSchema,
+        balance: signedAmountSchema.nullable(),
+        days_until_zero: z.number().nullable(),
+    })
+        .strict(),
+]);
+export const findingsResponseSchema = z
+    .object({
+    version: z.literal(FINDINGS_CONTRACT_VERSION),
+    generated_at: dateTimeSchema,
+    as_of: dateSchema.describe("Today's date in the user's time zone."),
+    time_zone: z.string(),
+    recent_days: z.literal(FINDINGS_RECENT_DAYS),
+    upcoming_days: z.literal(FINDINGS_UPCOMING_DAYS),
+    truncated: z.boolean(),
+    findings: z.array(findingSchema).max(FINDINGS_MAX_ITEMS),
+})
+    .strict();
+//# sourceMappingURL=findings.js.map

package/dist/mcp/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../../src/mcp/findings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAE1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAwB,CAAC;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,MAAM,EAAE,CAAC;AAErF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,mBAAmB;IACnB,aAAa;IACb,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;IAClB,sBAAsB;IACtB,aAAa;IACb,UAAU;CACF,CAAC;AAGX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ;IACR,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,OAAO;CACC,CAAC;AACX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,qBAAqB;IACrB,qBAAqB;IACrB,iBAAiB;CACT,CAAC;AAEX,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAsB,EAAE,2BAA2B,CAAC,CAAC;AACzF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5C,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC,CAAC;AACjG,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CACtB,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3F,oBAAoB,EAAE,CAAC;SACpB,KAAK,CAAC,UAAU,CAAC;SACjB,QAAQ,CAAC,iFAAiF,CAAC;CAC/F,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,GAAG;IACjB,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,GAAG,UAAU;IACb,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB,GAAG,YAAY;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC1C,cAAc,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,0BAA0B,CAAC,QAAQ,EAAE;CAC9C,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,cAAc,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,kBAAkB;CAC3B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACxD,CAAC;SACE,MAAM,CAAC;QACN,GAAG,UAAU;QACb,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE;KAC7B,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,YAAY;QACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAC9B,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE;QAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,eAAe,EAAE,gBAAgB,CAAC,QAAQ,EAAE;QAC5C,iBAAiB,EAAE,gBAAgB,CAAC,QAAQ,EAAE;QAC9C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,eAAe;QAClB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAClC,aAAa,EAAE,UAAU,CAAC,QAAQ,CAChC,2DAA2D,CAC5D;KACF,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,YAAY;QACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;QACnD,cAAc,EAAE,QAAQ,CAAC,QAAQ,EAAE;QACnC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACpD,MAAM,EAAE,kBAAkB;QAC1B,YAAY,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,YAAY;QACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAC9C,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,eAAe;QAClB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;QACvC,SAAS,EAAE,UAAU,CAAC,QAAQ,EAAE;KACjC,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,YAAY;QACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;QAC9B,cAAc,EAAE,QAAQ;QACxB,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACjD,MAAM,EAAE,kBAAkB;QAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACzC,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,UAAU;QACb,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE;QACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QACtC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACvC,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC;IAC7C,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAC5C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC;CACzD,CAAC;KACD,MAAM,EAAE,CAAC"}