@mmzaini/starling-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mahdi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# Starling TypeScript SDK
+
+Unofficial typed client for the Starling Bank Public API. Supports Node.js 22+, ESM and CommonJS.
+
+```sh
+npm install @mmzaini/starling-sdk
+```
+
+```ts
+import { StarlingClient, StarlingEnvironment } from "@mmzaini/starling-sdk";
+
+const client = new StarlingClient({
+  accessToken: process.env.STARLING_ACCESS_TOKEN,
+  environment: StarlingEnvironment.Sandbox,
+});
+
+const { accounts } = await client.accounts.list();
+const account = accounts?.[0];
+if (!account?.accountUid) throw new Error("No account available");
+const balance = await client.accounts.getBalance({ accountUid: account.accountUid });
+console.log(balance.effectiveBalance);
+```
+
+Sandbox is the default. Choose `StarlingEnvironment.Production` explicitly for a personal token or live application.
+
+Omit `accessToken` to read `STARLING_ACCESS_TOKEN`, or pass a supplier such as
+`accessToken: () => tokenStore.accessToken` for tokens managed by your application.
+The SDK runs on the server; use the separate React package to display data in a browser.
+
+## Pagination and errors
+
+```typescript
+import { iterateFeed, StarlingError } from "@mmzaini/starling-sdk";
+
+if (!account.defaultCategory) throw new Error("No default category available");
+try {
+  for await (const item of iterateFeed(client, {
+    accountUid: account.accountUid,
+    categoryUid: account.defaultCategory,
+    minTransactionTimestamp: "2026-01-01T00:00:00Z",
+    maxTransactionTimestamp: "2026-02-01T00:00:00Z",
+  })) {
+    console.log(item.feedItemUid);
+  }
+} catch (error) {
+  if (error instanceof StarlingError) console.error(error.statusCode);
+  else throw error;
+}
+```
+
+Reads default to two retries; writes are sent once. `timeoutInSeconds` defaults to
+60 and covers retries and buffered responses. Pass `abortSignal` per request to
+cancel. Inspect `StarlingError.statusCode`, `.body` and `.rawResponse` for failures;
+avoid logging credentials or entire banking responses.
+
+```typescript
+const response = await client.accounts.list().withRawResponse();
+console.log(response.rawResponse.status);
+```
+
+## Authentication and signing
+
+Use `StarlingOAuth` for code exchange and refresh. Refresh rotates both tokens;
+persist them together. Production OAuth needs a client certificate. Signed API
+operations use an optional `signing: { keyId, privateKey }` client option with a
+registered RSA API key. These are separate credentials.
+
+- [Authentication](https://github.com/MMZaini/starling-sdk/blob/main/docs/authentication.md)
+- [Signing and webhook verification](https://github.com/MMZaini/starling-sdk/blob/main/docs/signing-and-webhooks.md)
+- [Endpoint map](https://github.com/MMZaini/starling-sdk/blob/main/docs/naming-map.md)
+- [Amounts, files and API behavior](https://github.com/MMZaini/starling-sdk/blob/main/docs/api-gotchas.md)
+
+Types and enum values are available through the `Starling` namespace. CommonJS is
+also supported: `const { StarlingClient } = require("@mmzaini/starling-sdk")`.
+
+Generated from Starling's OpenAPI spec with Fern. [Source and maintenance](https://github.com/MMZaini/starling-sdk).

package/dist/attachments.d.cts

@@ -0,0 +1,3 @@
+import type { WithRawResponse } from "./generated/core/fetcher/index.cjs";
+/** Read the UUID from a 200 JSON body or an empty 202 response's Location header. */
+export declare function getUploadedAttachmentUid(upload: WithRawResponse<string | null | undefined>): string;

package/dist/attachments.d.ts

@@ -0,0 +1,3 @@
+import type { WithRawResponse } from "./generated/core/fetcher/index.js";
+/** Read the UUID from a 200 JSON body or an empty 202 response's Location header. */
+export declare function getUploadedAttachmentUid(upload: WithRawResponse<string | null | undefined>): string;

package/dist/auth/oauth.d.cts

@@ -0,0 +1,59 @@
+import { StarlingEnvironment } from "../generated/environments.cjs";
+export interface OAuthTokens {
+    accessToken: string;
+    refreshToken: string;
+    tokenType: "Bearer";
+    expiresIn: number;
+    expiresAt: Date;
+    scope: string;
+}
+export declare class OAuthError extends Error {
+    readonly code: string;
+    readonly statusCode?: number | undefined;
+    constructor(code: string, statusCode?: number | undefined);
+}
+export interface OAuthTlsOptions {
+    cert: string | Buffer;
+    key: string | Buffer;
+    ca?: string | Buffer;
+    passphrase?: string;
+}
+export interface OAuthRequest {
+    url: string;
+    body: string;
+    headers: Record<string, string>;
+    signal: AbortSignal;
+}
+export type OAuthTransport = (request: OAuthRequest) => Promise<{
+    status: number;
+    body: unknown;
+}>;
+export interface StarlingOAuthOptions {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    environment?: StarlingEnvironment;
+    tls?: OAuthTlsOptions;
+    /** Supply a certificate-capable transport when TLS is managed externally. */
+    transport?: OAuthTransport;
+    /** Override for a proxy or a local HTTPS test server. */
+    tokenUrl?: string;
+    timeoutInSeconds?: number;
+}
+export declare function createOAuthState(): string;
+export declare function validateOAuthState(expected: string, received: string | undefined | null): boolean;
+/** Explicit OAuth helpers. Applications own token persistence and callback sessions. */
+export declare class StarlingOAuth {
+    #private;
+    constructor(options: StarlingOAuthOptions);
+    getAuthorizationUrl({ state, scopes }: {
+        state: string;
+        scopes?: string[];
+    }): string;
+    exchangeCode(code: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<OAuthTokens>;
+    refreshToken(refreshToken: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<OAuthTokens>;
+}

package/dist/auth/oauth.d.ts

@@ -0,0 +1,59 @@
+import { StarlingEnvironment } from "../generated/environments.js";
+export interface OAuthTokens {
+    accessToken: string;
+    refreshToken: string;
+    tokenType: "Bearer";
+    expiresIn: number;
+    expiresAt: Date;
+    scope: string;
+}
+export declare class OAuthError extends Error {
+    readonly code: string;
+    readonly statusCode?: number | undefined;
+    constructor(code: string, statusCode?: number | undefined);
+}
+export interface OAuthTlsOptions {
+    cert: string | Buffer;
+    key: string | Buffer;
+    ca?: string | Buffer;
+    passphrase?: string;
+}
+export interface OAuthRequest {
+    url: string;
+    body: string;
+    headers: Record<string, string>;
+    signal: AbortSignal;
+}
+export type OAuthTransport = (request: OAuthRequest) => Promise<{
+    status: number;
+    body: unknown;
+}>;
+export interface StarlingOAuthOptions {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    environment?: StarlingEnvironment;
+    tls?: OAuthTlsOptions;
+    /** Supply a certificate-capable transport when TLS is managed externally. */
+    transport?: OAuthTransport;
+    /** Override for a proxy or a local HTTPS test server. */
+    tokenUrl?: string;
+    timeoutInSeconds?: number;
+}
+export declare function createOAuthState(): string;
+export declare function validateOAuthState(expected: string, received: string | undefined | null): boolean;
+/** Explicit OAuth helpers. Applications own token persistence and callback sessions. */
+export declare class StarlingOAuth {
+    #private;
+    constructor(options: StarlingOAuthOptions);
+    getAuthorizationUrl({ state, scopes }: {
+        state: string;
+        scopes?: string[];
+    }): string;
+    exchangeCode(code: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<OAuthTokens>;
+    refreshToken(refreshToken: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<OAuthTokens>;
+}

package/dist/auth/signing.d.cts

@@ -0,0 +1,27 @@
+import { KeyObject } from "node:crypto";
+export declare class SigningError extends Error {
+    constructor(message: string);
+}
+export interface SigningOptions {
+    /** UUID of the API key registered in the matching Starling environment. */
+    keyId: string;
+    privateKey: string | Buffer | KeyObject;
+    passphrase?: string;
+}
+/** RSA-SHA512 signing of the exact bytes sent to Starling. */
+export declare class RequestSigner {
+    #private;
+    constructor(options: SigningOptions);
+    signHeaders({ method, url, body, authorization }: {
+        method: string;
+        url: string | URL;
+        body?: Uint8Array | null;
+        authorization: string;
+    }): {
+        Authorization: string;
+        Date: string;
+        Digest: string;
+    };
+}
+/** Verify X-Hook-Signature against the unchanged body of a V2 webhook. */
+export declare function verifyWebhookSignature(body: Uint8Array, signature: string | null | undefined, publicKey: string | Buffer | KeyObject): boolean;

package/dist/auth/signing.d.ts

@@ -0,0 +1,27 @@
+import { KeyObject } from "node:crypto";
+export declare class SigningError extends Error {
+    constructor(message: string);
+}
+export interface SigningOptions {
+    /** UUID of the API key registered in the matching Starling environment. */
+    keyId: string;
+    privateKey: string | Buffer | KeyObject;
+    passphrase?: string;
+}
+/** RSA-SHA512 signing of the exact bytes sent to Starling. */
+export declare class RequestSigner {
+    #private;
+    constructor(options: SigningOptions);
+    signHeaders({ method, url, body, authorization }: {
+        method: string;
+        url: string | URL;
+        body?: Uint8Array | null;
+        authorization: string;
+    }): {
+        Authorization: string;
+        Date: string;
+        Digest: string;
+    };
+}
+/** Verify X-Hook-Signature against the unchanged body of a V2 webhook. */
+export declare function verifyWebhookSignature(body: Uint8Array, signature: string | null | undefined, publicKey: string | Buffer | KeyObject): boolean;

package/dist/client.d.cts

@@ -0,0 +1,15 @@
+import { StarlingClient as GeneratedClient } from "./generated/Client.cjs";
+import type { BaseClientOptions } from "./generated/BaseClient.cjs";
+import { StarlingEnvironment } from "./generated/environments.cjs";
+import { type SigningOptions } from "./auth/signing.cjs";
+export interface StarlingClientOptions extends Omit<BaseClientOptions, "auth" | "fetcher" | "baseUrl" | "environment" | "stream"> {
+    environment?: StarlingEnvironment;
+    /** HTTPS origin for a proxy. It must not contain a path, credentials or query. */
+    baseUrl?: string;
+    signing?: SigningOptions;
+}
+/** Generated resources with request signing, redirect protection and amount checks. */
+export declare class StarlingClient extends GeneratedClient {
+    readonly baseUrl: string;
+    constructor(options?: StarlingClientOptions);
+}

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import { StarlingClient as GeneratedClient } from "./generated/Client.js";
+import type { BaseClientOptions } from "./generated/BaseClient.js";
+import { StarlingEnvironment } from "./generated/environments.js";
+import { type SigningOptions } from "./auth/signing.js";
+export interface StarlingClientOptions extends Omit<BaseClientOptions, "auth" | "fetcher" | "baseUrl" | "environment" | "stream"> {
+    environment?: StarlingEnvironment;
+    /** HTTPS origin for a proxy. It must not contain a path, credentials or query. */
+    baseUrl?: string;
+    signing?: SigningOptions;
+}
+/** Generated resources with request signing, redirect protection and amount checks. */
+export declare class StarlingClient extends GeneratedClient {
+    readonly baseUrl: string;
+    constructor(options?: StarlingClientOptions);
+}

package/dist/generated/BaseClient.d.cts

@@ -0,0 +1,55 @@
+import { BearerAuthProvider } from "./auth/BearerAuthProvider.cjs";
+import * as core from "./core/index.cjs";
+import type * as environments from "./environments.cjs";
+export type AuthOption = false | core.AuthProvider["getAuthRequest"] | core.AuthProvider | BearerAuthProvider.AuthOptions;
+export type BaseClientOptions = {
+    environment?: core.Supplier<environments.StarlingEnvironment | string>;
+    /** Specify a custom URL to connect the client to. */
+    baseUrl?: core.Supplier<string>;
+    /** Additional headers to include in requests. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** The default maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The default number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
+    fetch?: typeof fetch;
+    fetcher?: core.FetchFunction;
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+    /** Default options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+    /** Override auth. Pass false to disable, a function returning auth headers, an AuthProvider, or auth options. */
+    auth?: AuthOption;
+} & BearerAuthProvider.AuthOptions;
+export interface BaseRequestOptions {
+    /** The maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** A hook to abort the request. */
+    abortSignal?: AbortSignal;
+    /** Additional query string parameters to include in the request. */
+    queryParams?: Record<string, unknown>;
+    /** A dictionary containing additional parameters to spread into the request's body. */
+    additionalBodyParameters?: Record<string, unknown>;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** Options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+}
+export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+    authProvider?: core.AuthProvider;
+};
+export type NormalizedClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions> = NormalizedClientOptions<T> & {
+    authProvider: core.AuthProvider;
+};
+export declare function normalizeClientOptions<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptions<T>;
+export declare function normalizeClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptionsWithAuth<T>;

package/dist/generated/BaseClient.d.ts

@@ -0,0 +1,55 @@
+import { BearerAuthProvider } from "./auth/BearerAuthProvider.js";
+import * as core from "./core/index.js";
+import type * as environments from "./environments.js";
+export type AuthOption = false | core.AuthProvider["getAuthRequest"] | core.AuthProvider | BearerAuthProvider.AuthOptions;
+export type BaseClientOptions = {
+    environment?: core.Supplier<environments.StarlingEnvironment | string>;
+    /** Specify a custom URL to connect the client to. */
+    baseUrl?: core.Supplier<string>;
+    /** Additional headers to include in requests. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** The default maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The default number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
+    fetch?: typeof fetch;
+    fetcher?: core.FetchFunction;
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+    /** Default options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+    /** Override auth. Pass false to disable, a function returning auth headers, an AuthProvider, or auth options. */
+    auth?: AuthOption;
+} & BearerAuthProvider.AuthOptions;
+export interface BaseRequestOptions {
+    /** The maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** A hook to abort the request. */
+    abortSignal?: AbortSignal;
+    /** Additional query string parameters to include in the request. */
+    queryParams?: Record<string, unknown>;
+    /** A dictionary containing additional parameters to spread into the request's body. */
+    additionalBodyParameters?: Record<string, unknown>;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** Options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+}
+export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+    authProvider?: core.AuthProvider;
+};
+export type NormalizedClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions> = NormalizedClientOptions<T> & {
+    authProvider: core.AuthProvider;
+};
+export declare function normalizeClientOptions<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptions<T>;
+export declare function normalizeClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptionsWithAuth<T>;

package/dist/generated/Client.d.cts

@@ -0,0 +1,77 @@
+import { AccountHolderClient } from "./api/resources/accountHolder/client/Client.cjs";
+import { AccountsClient } from "./api/resources/accounts/client/Client.cjs";
+import { AddressesClient } from "./api/resources/addresses/client/Client.cjs";
+import { BusinessClient } from "./api/resources/business/client/Client.cjs";
+import { CardsClient } from "./api/resources/cards/client/Client.cjs";
+import { DirectDebitsClient } from "./api/resources/directDebits/client/Client.cjs";
+import { FeedClient } from "./api/resources/feed/client/Client.cjs";
+import { IdentityClient } from "./api/resources/identity/client/Client.cjs";
+import { IndividualClient } from "./api/resources/individual/client/Client.cjs";
+import { JointAccountClient } from "./api/resources/jointAccount/client/Client.cjs";
+import { PayeesClient } from "./api/resources/payees/client/Client.cjs";
+import { PaymentsClient } from "./api/resources/payments/client/Client.cjs";
+import { ProfileImageClient } from "./api/resources/profileImage/client/Client.cjs";
+import { RoundUpClient } from "./api/resources/roundUp/client/Client.cjs";
+import { SavingsGoalsClient } from "./api/resources/savingsGoals/client/Client.cjs";
+import { SettleUpClient } from "./api/resources/settleUp/client/Client.cjs";
+import { SoleTraderClient } from "./api/resources/soleTrader/client/Client.cjs";
+import { SpacesClient } from "./api/resources/spaces/client/Client.cjs";
+import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.cjs";
+import { type NormalizedClientOptionsWithAuth } from "./BaseClient.cjs";
+import * as core from "./core/index.cjs";
+export declare namespace StarlingClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class StarlingClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<StarlingClient.Options>;
+    protected _accounts: AccountsClient | undefined;
+    protected _business: BusinessClient | undefined;
+    protected _individual: IndividualClient | undefined;
+    protected _jointAccount: JointAccountClient | undefined;
+    protected _soleTrader: SoleTraderClient | undefined;
+    protected _accountHolder: AccountHolderClient | undefined;
+    protected _profileImage: ProfileImageClient | undefined;
+    protected _addresses: AddressesClient | undefined;
+    protected _cards: CardsClient | undefined;
+    protected _directDebits: DirectDebitsClient | undefined;
+    protected _feed: FeedClient | undefined;
+    protected _roundUp: RoundUpClient | undefined;
+    protected _identity: IdentityClient | undefined;
+    protected _payments: PaymentsClient | undefined;
+    protected _payees: PayeesClient | undefined;
+    protected _savingsGoals: SavingsGoalsClient | undefined;
+    protected _settleUp: SettleUpClient | undefined;
+    protected _spaces: SpacesClient | undefined;
+    constructor(options?: StarlingClient.Options);
+    get accounts(): AccountsClient;
+    get business(): BusinessClient;
+    get individual(): IndividualClient;
+    get jointAccount(): JointAccountClient;
+    get soleTrader(): SoleTraderClient;
+    get accountHolder(): AccountHolderClient;
+    get profileImage(): ProfileImageClient;
+    get addresses(): AddressesClient;
+    get cards(): CardsClient;
+    get directDebits(): DirectDebitsClient;
+    get feed(): FeedClient;
+    get roundUp(): RoundUpClient;
+    get identity(): IdentityClient;
+    get payments(): PaymentsClient;
+    get payees(): PayeesClient;
+    get savingsGoals(): SavingsGoalsClient;
+    get settleUp(): SettleUpClient;
+    get spaces(): SpacesClient;
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input: Request | string | URL, init?: RequestInit, requestOptions?: core.PassthroughRequest.RequestOptions): Promise<Response>;
+}

package/dist/generated/Client.d.ts

@@ -0,0 +1,77 @@
+import { AccountHolderClient } from "./api/resources/accountHolder/client/Client.js";
+import { AccountsClient } from "./api/resources/accounts/client/Client.js";
+import { AddressesClient } from "./api/resources/addresses/client/Client.js";
+import { BusinessClient } from "./api/resources/business/client/Client.js";
+import { CardsClient } from "./api/resources/cards/client/Client.js";
+import { DirectDebitsClient } from "./api/resources/directDebits/client/Client.js";
+import { FeedClient } from "./api/resources/feed/client/Client.js";
+import { IdentityClient } from "./api/resources/identity/client/Client.js";
+import { IndividualClient } from "./api/resources/individual/client/Client.js";
+import { JointAccountClient } from "./api/resources/jointAccount/client/Client.js";
+import { PayeesClient } from "./api/resources/payees/client/Client.js";
+import { PaymentsClient } from "./api/resources/payments/client/Client.js";
+import { ProfileImageClient } from "./api/resources/profileImage/client/Client.js";
+import { RoundUpClient } from "./api/resources/roundUp/client/Client.js";
+import { SavingsGoalsClient } from "./api/resources/savingsGoals/client/Client.js";
+import { SettleUpClient } from "./api/resources/settleUp/client/Client.js";
+import { SoleTraderClient } from "./api/resources/soleTrader/client/Client.js";
+import { SpacesClient } from "./api/resources/spaces/client/Client.js";
+import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
+import * as core from "./core/index.js";
+export declare namespace StarlingClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class StarlingClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<StarlingClient.Options>;
+    protected _accounts: AccountsClient | undefined;
+    protected _business: BusinessClient | undefined;
+    protected _individual: IndividualClient | undefined;
+    protected _jointAccount: JointAccountClient | undefined;
+    protected _soleTrader: SoleTraderClient | undefined;
+    protected _accountHolder: AccountHolderClient | undefined;
+    protected _profileImage: ProfileImageClient | undefined;
+    protected _addresses: AddressesClient | undefined;
+    protected _cards: CardsClient | undefined;
+    protected _directDebits: DirectDebitsClient | undefined;
+    protected _feed: FeedClient | undefined;
+    protected _roundUp: RoundUpClient | undefined;
+    protected _identity: IdentityClient | undefined;
+    protected _payments: PaymentsClient | undefined;
+    protected _payees: PayeesClient | undefined;
+    protected _savingsGoals: SavingsGoalsClient | undefined;
+    protected _settleUp: SettleUpClient | undefined;
+    protected _spaces: SpacesClient | undefined;
+    constructor(options?: StarlingClient.Options);
+    get accounts(): AccountsClient;
+    get business(): BusinessClient;
+    get individual(): IndividualClient;
+    get jointAccount(): JointAccountClient;
+    get soleTrader(): SoleTraderClient;
+    get accountHolder(): AccountHolderClient;
+    get profileImage(): ProfileImageClient;
+    get addresses(): AddressesClient;
+    get cards(): CardsClient;
+    get directDebits(): DirectDebitsClient;
+    get feed(): FeedClient;
+    get roundUp(): RoundUpClient;
+    get identity(): IdentityClient;
+    get payments(): PaymentsClient;
+    get payees(): PayeesClient;
+    get savingsGoals(): SavingsGoalsClient;
+    get settleUp(): SettleUpClient;
+    get spaces(): SpacesClient;
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input: Request | string | URL, init?: RequestInit, requestOptions?: core.PassthroughRequest.RequestOptions): Promise<Response>;
+}

package/dist/generated/api/index.d.cts

@@ -0,0 +1,2 @@
+export * from "./resources/index.cjs";
+export * from "./types/index.cjs";

package/dist/generated/api/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./resources/index.js";
+export * from "./types/index.js";

package/dist/generated/api/resources/accountHolder/client/Client.d.cts

@@ -0,0 +1,43 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.cjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.cjs";
+import * as core from "../../../../core/index.cjs";
+import type * as Starling from "../../../index.cjs";
+export declare namespace AccountHolderClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AccountHolderClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AccountHolderClient.Options>;
+    constructor(options?: AccountHolderClient.Options);
+    /**
+     *
+     *
+     * Required scopes (any): customer:read, account-holder-type:read.
+     *
+     * @param {AccountHolderClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link errors.StarlingError}
+     * @throws {@link errors.StarlingTimeoutError}
+     *
+     * @example
+     *     await client.accountHolder.get()
+     */
+    get(requestOptions?: AccountHolderClient.RequestOptions): core.HttpResponsePromise<Starling.AccountHolder>;
+    private __get;
+    /**
+     *
+     *
+     * Required scopes (any): account-holder-name:read.
+     *
+     * @param {AccountHolderClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link errors.StarlingError}
+     * @throws {@link errors.StarlingTimeoutError}
+     *
+     * @example
+     *     await client.accountHolder.getName()
+     */
+    getName(requestOptions?: AccountHolderClient.RequestOptions): core.HttpResponsePromise<Starling.AccountHolderName>;
+    private __getName;
+}