@distyra/sdk 0.6.1 → 0.8.0

package/dist/generated.d.ts

@@ -51,7 +51,7 @@ export interface paths {
         put?: never;
         /**
          * Enrich a single transaction
-         * @description Single-transaction enrichment. Resolution flow: normalize, then cache, catalog match, classifier, and LLM fallback. Returns the full response shape with an `availability` block; fields not yet available (logos, location, subscription) are returned as `null`/`false` and flagged. `metadata.is_subscription` is a merchant-category hint, not per-transaction recurrence,as unavailable. Confidence values are uncalibrated similarity scores.
+         * @description Single-transaction enrichment. Resolution flow: normalize, then cache, catalog match, classifier, and LLM fallback. Returns the full response shape with an `availability` block. In that block `merchant_identity`, `transaction_type` and `logos` are constants meaning the feature has shipped, while `location` and `subscription_detection` report whether this request had the data the field needs. `metadata.is_subscription` is a merchant-category hint, not per-transaction recurrence, and is null when no merchant resolved. Confidence values are uncalibrated similarity scores.
          */
         post: operations["enrichSingle"];
         delete?: never;
@@ -99,7 +99,7 @@ export interface paths {
          *
          *     **Persistence.** Lender-side only. The features payload is retained for 7-day re-fetch (use GET /v1/underwrite/analyses/:id), then purged. Only billing metadata + the analysis row stay after purge.
          *
-         *     **Idempotency.** Two surfaces: (1) the standard `X-Idempotency-Key` 24h dedup, and (2) a 7-day `(org_id, applicant_id)` window — re-submitting the same applicant_id returns the original result + `billable=false`. After 7 days, treated as a fresh evaluation event.
+         *     **Idempotency.** Two surfaces: (1) the standard `Idempotency-Key` 24h dedup, and (2) a 7-day `(org_id, applicant_id)` window — re-submitting the same applicant_id returns the original result + `billable=false`. After 7 days, treated as a fresh evaluation event.
          *
          *     **EUR-only in v1.** Multi-currency submissions return 409 `conflict_currency_mix`.
          *
@@ -138,7 +138,7 @@ export interface paths {
          *
          *     **Limits.** 25MB per file. Up to 500 files per submission (raised 2026-05-20 to accommodate German Anlage-3 fan-out where banks emit one CAMT.053 per account per day; same-IBAN fragments consolidate to one logical account before the per-applicant MAX_ACCOUNTS=16 cap applies). 100MB total payload. MAX_TRANSACTIONS=5000 across all parsed accounts.
          *
-         *     **Idempotency.** Same as JSON-mode — 7-day `(org_id, applicant_id)` re-pull window returns the original analysis with `billable=false`. `X-Idempotency-Key` is honored for retry-safety.
+         *     **Idempotency.** Same as JSON-mode — 7-day `(org_id, applicant_id)` re-pull window returns the original analysis with `billable=false`. `Idempotency-Key` is honored for retry-safety.
          *
          *     Required scope: `underwriting:write`.
          */
@@ -1315,9 +1315,12 @@ export interface operations {
                      *         "domain": "ah.nl",
                      *         "logo_url": "https://cdn.distyra.com/saas/142/a3f2b9e7d4c1f8a0/v1/light.png?token=…&expires=…",
                      *         "logo_quality_score": 0.8,
-                     *         "brand_colors": {
-                     *           "primary": "#0FAEEF"
-                     *         },
+                     *         "brand_colors": [
+                     *           {
+                     *             "hex": "#0faeef",
+                     *             "source": "theme_color_meta"
+                     *           }
+                     *         ],
                      *         "catalog_id": 142,
                      *         "source": "catalog",
                      *         "confidence_bucket": "high",
@@ -1365,9 +1368,9 @@ export interface operations {
                      *       "availability": {
                      *         "merchant_identity": true,
                      *         "transaction_type": true,
-                     *         "logos": false,
+                     *         "logos": true,
                      *         "location": false,
-                     *         "subscription_detection": false
+                     *         "subscription_detection": true
                      *       },
                      *       "livemode": true
                      *     }
@@ -1381,8 +1384,11 @@ export interface operations {
                             logo_url: string | null;
                             logo_quality_score: number | null;
                             brand_colors: {
-                                [key: string]: unknown;
-                            };
+                                /** @description Lowercase 6-digit hex, leading #. */
+                                hex: string;
+                                /** @description theme_color_meta | msapplication_tile_meta | pixel_sample */
+                                source: string;
+                            }[];
                             catalog_id: number | null;
                             source: "catalog" | "crawl" | "fuzzy_match" | "llm_inferred" | null;
                             confidence_bucket: "high" | "medium" | "low" | null;
@@ -1404,14 +1410,17 @@ export interface operations {
                             country: string | null;
                         };
                         metadata: {
-                            /** @description Merchant-category hint: true when the resolved merchant predominantly bills on subscription (streaming, SaaS, telco, gym, insurance). This reflects the MERCHANT, not this transaction — a single charge at a subscription merchant may still be a one-off. True only for conservatively curated brands; false also means "not flagged / unknown". Per-account recurrence detection needs the transaction series and lives in the banking/iOS layer, not this stateless API. */
-                            is_subscription: boolean;
+                            /** @description Merchant-category hint: true when the resolved merchant predominantly bills on subscription (streaming, SaaS, telco, gym, insurance). This reflects the MERCHANT, not this transaction: a single charge at a subscription merchant may still be a one-off. True only for conservatively curated brands. NULL means no merchant resolved, so there was no catalog row to consult; false means a row resolved and is not on the curated list. Before 2026-07-16 the unresolved case also reported false, which asserted a negative we had no basis for. Per-account recurrence detection needs the transaction series and lives in the banking/iOS layer, not this stateless API. */
+                            is_subscription: boolean | null;
                             is_marketplace: boolean;
                             facilitator: string | null;
+                            /** @description bank_fee | internal_transfer | p2p_transfer | cash_withdrawal | cash_deposit | investment_transfer | salary | refund | direct_debit | standing_order | returned_dd | merchant_payment. "merchant_payment" is the ordinary-purchase verdict: the rule cascade found no non-merchant type AND a merchant or category resolved, so this is a normal payment to a business. NULL means genuinely undetermined (nothing resolved). Before 2026-07-16 ordinary purchases reported null at confidence 0, indistinguishable from "no idea", while the docs advertised a "merchant_payment" value that was not in the enum and could never be returned. */
                             transaction_type: string | null;
                             is_transfer: boolean;
                             is_bank_internal: boolean;
                             is_p2p: boolean;
+                            counterparty_role: string | null;
+                            statutory_kind: string | null;
                         };
                         confidence: {
                             merchant: number | null;
@@ -1442,11 +1451,17 @@ export interface operations {
                         /** @description Which stage resolved this transaction. 0 = not resolved (echo), 1 = cache hit, 2 = catalog match, 3 = reserved, 4 = LLM fallback. */
                         cache_tier: number;
                         processing_time_ms: number;
+                        /** @description Per-request summary: did THIS response yield each thing. Every entry is derivable from the payload, so it is a convenience layer, not new information. Changed in 0.8.0: merchant_identity/transaction_type/logos used to be build-time constants meaning "the feature has shipped", hardcoded true on every response, which contradicted the payload (merchant_identity:true beside merchant.name:null). They now report what you actually got. */
                         availability: {
+                            /** @description True when merchant.name is populated (a catalog hit or a Tier-4 proposal). */
                             merchant_identity: boolean;
+                            /** @description True when metadata.transaction_type is populated. Distinct from merchant_identity: a bank fee can be typed with no merchant identified. */
                             transaction_type: boolean;
+                            /** @description True when merchant.logo_url is populated on THIS response. */
                             logos: boolean;
+                            /** @description True when this descriptor yielded a city or country. */
                             location: boolean;
+                            /** @description True when a catalog row resolved, so its subscription flag was available to consult. Equivalently, metadata.is_subscription is not null. */
                             subscription_detection: boolean;
                         };
                         /** @description true when served to a live key; false when served to a test-mode (sk_test_) key. Test-mode responses run the full cascade but carry no billing or quota impact. */
@@ -7200,8 +7215,9 @@ export interface operations {
                         domain: string | null;
                         logo_url: string | null;
                         brand_colors: {
-                            [key: string]: unknown;
-                        };
+                            hex: string;
+                            source: string;
+                        }[];
                         industry: string | null;
                         subindustries: string[];
                         primary_mcc: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@distyra/sdk",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "TypeScript SDK for the Distyra Transaction Enrichment & SME Underwriting API. Generated from the committed OpenAPI spec; thin, typed wrapper around openapi-fetch.",
   "license": "MIT",
   "author": "Brightfield Software",