@distyra/sdk 0.4.0 → 0.5.0

package/dist/generated.d.ts

@@ -34,7 +34,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/recurring detection) are returned as `null`/`false` and flagged 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; 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.
          */
         post: operations["enrichSingle"];
         delete?: never;
@@ -1041,6 +1041,16 @@ export interface operations {
                  * @example true
                  */
                 cache_only?: "true" | "false";
+                /**
+                 * @description When `true` and the request mints a brand-new (cold) merchant, block up to `wait_timeout_ms` for the background logo crawl to finish, then return the real logo instead of `logo_url: null`. No effect for already-known merchants (no new crawl fires). On timeout, returns the normal async response (which carries the low-quality favicon floor when one is available).
+                 * @example true
+                 */
+                wait_for_crawl?: "true" | "false";
+                /**
+                 * @description Upper bound in milliseconds for `wait_for_crawl` (default 8000, max 15000). Ignored unless `wait_for_crawl=true`.
+                 * @example 8000
+                 */
+                wait_timeout_ms?: string;
             };
             header?: never;
             path?: never;
@@ -1100,9 +1110,11 @@ export interface operations {
                      * @example {
                      *       "merchant": {
                      *         "name": "Albert Heijn",
-                     *         "parent": null,
+                     *         "parent": "Ahold Delhaize",
+                     *         "parent_catalog_id": 9001,
                      *         "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"
                      *         },
@@ -1127,7 +1139,6 @@ export interface operations {
                      *         "is_subscription": false,
                      *         "is_marketplace": false,
                      *         "facilitator": null,
-                     *         "is_recurring_candidate": false,
                      *         "transaction_type": "merchant_payment",
                      *         "is_transfer": false,
                      *         "is_bank_internal": false,
@@ -1149,8 +1160,7 @@ export interface operations {
                      *         "transaction_type": true,
                      *         "logos": false,
                      *         "location": false,
-                     *         "subscription_detection": false,
-                     *         "recurring_detection": false
+                     *         "subscription_detection": false
                      *       },
                      *       "livemode": true
                      *     }
@@ -1159,8 +1169,10 @@ export interface operations {
                         merchant: {
                             name: string | null;
                             parent: string | null;
+                            parent_catalog_id: number | null;
                             domain: string | null;
                             logo_url: string | null;
+                            logo_quality_score: number | null;
                             brand_colors: {
                                 [key: string]: unknown;
                             };
@@ -1185,10 +1197,10 @@ 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;
                             is_marketplace: boolean;
                             facilitator: string | null;
-                            is_recurring_candidate: boolean;
                             transaction_type: string | null;
                             is_transfer: boolean;
                             is_bank_internal: boolean;
@@ -1215,7 +1227,6 @@ export interface operations {
                             logos: boolean;
                             location: boolean;
                             subscription_detection: boolean;
-                            recurring_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. */
                         livemode: boolean;
@@ -1327,6 +1338,16 @@ export interface operations {
                  * @example true
                  */
                 cache_only?: "true" | "false";
+                /**
+                 * @description When `true` and the request mints a brand-new (cold) merchant, block up to `wait_timeout_ms` for the background logo crawl to finish, then return the real logo instead of `logo_url: null`. No effect for already-known merchants (no new crawl fires). On timeout, returns the normal async response (which carries the low-quality favicon floor when one is available).
+                 * @example true
+                 */
+                wait_for_crawl?: "true" | "false";
+                /**
+                 * @description Upper bound in milliseconds for `wait_for_crawl` (default 8000, max 15000). Ignored unless `wait_for_crawl=true`.
+                 * @example 8000
+                 */
+                wait_timeout_ms?: string;
             };
             header?: never;
             path?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@distyra/sdk",
-  "version": "0.4.0",
+  "version": "0.5.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",