@distyra/sdk 0.3.0

package/dist/generated.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @distyra/sdk — TypeScript client for the Distyra Transaction Enrichment &
+ * SME Underwriting API.
+ *
+ * Two layers:
+ *
+ *   - `paths` — generated types from the OpenAPI snapshot in
+ *     apps/saas-api/openapi.json. Re-exported so callers can write their own
+ *     openapi-fetch client if they need non-default behavior.
+ *   - `createDistyraClient()` — opinionated factory that wires up bearer auth
+ *     and a default base URL, returning a typed openapi-fetch client.
+ *
+ * Consumers: the banking backend internally (shadow-mode and cutover paths,
+ * v2 plan §16.4 weeks 6–9) plus external API customers via the published
+ * `@distyra/sdk` npm package.
+ *
+ * Regenerate after any saas-api schema change:
+ *
+ *   1. `npm run snapshot -w @brightfield/saas-api`     — refresh openapi.json
+ *   2. `npm run build -w @distyra/sdk`                 — regen + compile
+ *
+ * The committed openapi.json snapshot makes SDK regen reproducible from git
+ * without a running server.
+ */
+import { type Client, type ClientOptions } from 'openapi-fetch';
+import type { paths } from './generated';
+export type { paths } from './generated';
+export type { components, operations } from './generated';
+/**
+ * Production base URL. Mirrors the OpenAPI `servers[0]` entry; kept in sync by
+ * hand because the SDK shouldn't have to parse the spec at runtime. The API and
+ * CDN stay on `.com`; only the Distyra website and customer portal use `.eu`.
+ */
+export declare const PRODUCTION_BASE_URL = "https://api.distyra.com";
+export interface DistyraClientOptions extends Omit<ClientOptions, 'baseUrl' | 'headers'> {
+    /** API key (`sk_…`). Required. */
+    apiKey: string;
+    /** Override the default production base URL — local dev, staging, etc. */
+    baseUrl?: string;
+    /** Extra headers merged on every request (rarely needed; useful for tracing). */
+    headers?: Record<string, string>;
+}
+/**
+ * Create a typed openapi-fetch client pre-bound to the Distyra API.
+ *
+ * Example:
+ *
+ *   const sdk = createDistyraClient({ apiKey: process.env.DISTYRA_KEY! });
+ *   const { data, error, response } = await sdk.POST('/v1/enrich', {
+ *     body: { descriptor: 'ALBERT HEIJN 1234 NL', amount: -23.45, currency: 'EUR' },
+ *   });
+ *
+ * `data` is fully typed against the EnrichResponse schema. `error` carries
+ * the standard `{ error, detail? }` envelope on 4xx/5xx.
+ */
+export declare function createDistyraClient(opts: DistyraClientOptions): Client<paths>;

package/dist/index.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * @distyra/sdk — TypeScript client for the Distyra Transaction Enrichment &
+ * SME Underwriting API.
+ *
+ * Two layers:
+ *
+ *   - `paths` — generated types from the OpenAPI snapshot in
+ *     apps/saas-api/openapi.json. Re-exported so callers can write their own
+ *     openapi-fetch client if they need non-default behavior.
+ *   - `createDistyraClient()` — opinionated factory that wires up bearer auth
+ *     and a default base URL, returning a typed openapi-fetch client.
+ *
+ * Consumers: the banking backend internally (shadow-mode and cutover paths,
+ * v2 plan §16.4 weeks 6–9) plus external API customers via the published
+ * `@distyra/sdk` npm package.
+ *
+ * Regenerate after any saas-api schema change:
+ *
+ *   1. `npm run snapshot -w @brightfield/saas-api`     — refresh openapi.json
+ *   2. `npm run build -w @distyra/sdk`                 — regen + compile
+ *
+ * The committed openapi.json snapshot makes SDK regen reproducible from git
+ * without a running server.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRODUCTION_BASE_URL = void 0;
+exports.createDistyraClient = createDistyraClient;
+const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
+/**
+ * Production base URL. Mirrors the OpenAPI `servers[0]` entry; kept in sync by
+ * hand because the SDK shouldn't have to parse the spec at runtime. The API and
+ * CDN stay on `.com`; only the Distyra website and customer portal use `.eu`.
+ */
+exports.PRODUCTION_BASE_URL = 'https://api.distyra.com';
+/**
+ * Create a typed openapi-fetch client pre-bound to the Distyra API.
+ *
+ * Example:
+ *
+ *   const sdk = createDistyraClient({ apiKey: process.env.DISTYRA_KEY! });
+ *   const { data, error, response } = await sdk.POST('/v1/enrich', {
+ *     body: { descriptor: 'ALBERT HEIJN 1234 NL', amount: -23.45, currency: 'EUR' },
+ *   });
+ *
+ * `data` is fully typed against the EnrichResponse schema. `error` carries
+ * the standard `{ error, detail? }` envelope on 4xx/5xx.
+ */
+function createDistyraClient(opts) {
+    const { apiKey, baseUrl = exports.PRODUCTION_BASE_URL, headers, ...rest } = opts;
+    if (!apiKey) {
+        throw new Error('createDistyraClient: apiKey is required');
+    }
+    return (0, openapi_fetch_1.default)({
+        baseUrl,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            ...(headers ?? {}),
+        },
+        ...rest,
+    });
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@distyra/sdk",
+  "version": "0.3.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",
+  "homepage": "https://distyra.com",
+  "keywords": [
+    "distyra",
+    "transaction enrichment",
+    "underwriting",
+    "open banking",
+    "psd2",
+    "openapi",
+    "typescript"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "generate": "openapi-typescript ../../apps/saas-api/openapi.json -o src/generated.ts",
+    "build": "npm run generate && tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "openapi-fetch": "^0.13.0"
+  },
+  "devDependencies": {
+    "openapi-typescript": "^7.5.0"
+  }
+}