@spare-technologies/spare-api 1.0.0-beta.7

package/dist/crypto.js

@@ -0,0 +1,89 @@
+/**
+ * CryptoHelper — client-side signing utilities for the Spare SDK.
+ *
+ * Provides serializePayload() (canonical JSON) and signPayload() (ES256 detached JWS).
+ * Uses the Web Crypto API — no runtime dependencies, requires Node.js ≥ 18.
+ */
+export class CryptoHelper {
+    /**
+     * Serialize a request body to the canonical JSON string required for x-signature signing.
+     *
+     * Rules (must match server shared/utils/serialize-payload.ts exactly):
+     *   - Object keys sorted alphabetically, recursively
+     *   - null / undefined values omitted
+     *   - Top-level number primitives serialised with trailing zeros stripped after 5dp rounding
+     *     e.g. serializePayload(1000.00) → "1000", serializePayload(1000.5) → "1000.5"
+     *   - Numbers as object values remain as JSON numbers (standard JSON.stringify behaviour)
+     */
+    serializePayload(value) {
+        if (Array.isArray(value)) {
+            return JSON.stringify(value.map((item) => JSON.parse(this.serializePayload(item))));
+        }
+        if (value !== null && typeof value === 'object') {
+            const obj = value;
+            const sorted = Object.keys(obj)
+                .sort((a, b) => a.localeCompare(b))
+                .filter((k) => obj[k] !== null && obj[k] !== undefined)
+                .reduce((acc, k) => {
+                const v = obj[k];
+                acc[k] = typeof v === 'object' && v !== null ? JSON.parse(this.serializePayload(v)) : v;
+                return acc;
+            }, {});
+            return JSON.stringify(sorted);
+        }
+        if (typeof value === 'number') {
+            return Number.parseFloat(value.toFixed(5)).toString();
+        }
+        return JSON.stringify(value);
+    }
+    /**
+     * Sign a request body using ES256 (ECDSA P-256). Returns a detached JWS string
+     * suitable for the x-signature header.
+     *
+     * @param privateKeyPem - PKCS8 PEM private key ("-----BEGIN PRIVATE KEY-----...")
+     * @param body - The request body object to sign (same object passed to the API call)
+     * @returns Detached JWS: "base64url(header)..base64url(signature)"
+     *
+     * @example
+     * ```ts
+     * const xSignature = await client.crypto.signPayload(privateKeyPem, requestBody);
+     * await client.paymentRequests.create({ ...requestBody, xSignature });
+     * ```
+     */
+    async signPayload(privateKeyPem, body) {
+        if (body === null || body === undefined) {
+            throw new Error('signPayload: body must be a non-null object');
+        }
+        if (!privateKeyPem?.includes('BEGIN PRIVATE KEY')) {
+            throw new Error('Invalid private key PEM: missing PKCS8 header');
+        }
+        // Decode PKCS8 PEM → ArrayBuffer
+        const pemBody = privateKeyPem
+            .replace(/-----BEGIN PRIVATE KEY-----/, '')
+            .replace(/-----END PRIVATE KEY-----/, '')
+            .replace(/\s/g, '');
+        const keyBytes = Uint8Array.from(atob(pemBody), (c) => c.charCodeAt(0));
+        const cryptoKey = await globalThis.crypto.subtle.importKey('pkcs8', keyBytes, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['sign']);
+        // Canonical payload bytes
+        const serialised = this.serializePayload(body);
+        const payloadBytes = new TextEncoder().encode(serialised);
+        // JWS protected header: {"alg":"ES256"} → base64url
+        const headerJson = '{"alg":"ES256"}';
+        const headerB64 = this._toBase64Url(new TextEncoder().encode(headerJson));
+        const payloadB64 = this._toBase64Url(payloadBytes);
+        // JWS signing input: ASCII(base64url(header) || '.' || base64url(payload))
+        const signingInput = new TextEncoder().encode(`${headerB64}.${payloadB64}`);
+        // ECDSA P-256 produces raw R‖S (64 bytes) — correct JWS format per RFC 7518 §3.4
+        const sigBytes = await globalThis.crypto.subtle.sign({ name: 'ECDSA', hash: 'SHA-256' }, cryptoKey, signingInput);
+        const sigB64 = this._toBase64Url(new Uint8Array(sigBytes));
+        // Detached JWS: header..signature (empty payload segment)
+        return `${headerB64}..${sigB64}`;
+    }
+    _toBase64Url(bytes) {
+        return btoa(String.fromCharCode(...bytes))
+            .replace(/\+/g, '-')
+            .replace(/\//g, '_')
+            .replace(/=+$/, '');
+    }
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../crypto.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CryptoHelper — client-side signing utilities for the Spare SDK.\n *\n * Provides serializePayload() (canonical JSON) and signPayload() (ES256 detached JWS).\n * Uses the Web Crypto API — no runtime dependencies, requires Node.js ≥ 18.\n */\n\nexport class CryptoHelper {\n  /**\n   * Serialize a request body to the canonical JSON string required for x-signature signing.\n   *\n   * Rules (must match server shared/utils/serialize-payload.ts exactly):\n   *   - Object keys sorted alphabetically, recursively\n   *   - null / undefined values omitted\n   *   - Top-level number primitives serialised with trailing zeros stripped after 5dp rounding\n   *     e.g. serializePayload(1000.00) → \"1000\", serializePayload(1000.5) → \"1000.5\"\n   *   - Numbers as object values remain as JSON numbers (standard JSON.stringify behaviour)\n   */\n  serializePayload(value: unknown): string {\n    if (Array.isArray(value)) {\n      return JSON.stringify(\n        (value as unknown[]).map((item) => JSON.parse(this.serializePayload(item)))\n      );\n    }\n\n    if (value !== null && typeof value === 'object') {\n      const obj = value as Record<string, unknown>;\n      const sorted = Object.keys(obj)\n        .sort((a, b) => a.localeCompare(b))\n        .filter((k) => obj[k] !== null && obj[k] !== undefined)\n        .reduce<Record<string, unknown>>((acc, k) => {\n          const v = obj[k];\n          acc[k] = typeof v === 'object' && v !== null ? JSON.parse(this.serializePayload(v)) : v;\n          return acc;\n        }, {});\n      return JSON.stringify(sorted);\n    }\n\n    if (typeof value === 'number') {\n      return Number.parseFloat(value.toFixed(5)).toString();\n    }\n\n    return JSON.stringify(value);\n  }\n\n  /**\n   * Sign a request body using ES256 (ECDSA P-256). Returns a detached JWS string\n   * suitable for the x-signature header.\n   *\n   * @param privateKeyPem - PKCS8 PEM private key (\"-----BEGIN PRIVATE KEY-----...\")\n   * @param body - The request body object to sign (same object passed to the API call)\n   * @returns Detached JWS: \"base64url(header)..base64url(signature)\"\n   *\n   * @example\n   * ```ts\n   * const xSignature = await client.crypto.signPayload(privateKeyPem, requestBody);\n   * await client.paymentRequests.create({ ...requestBody, xSignature });\n   * ```\n   */\n  async signPayload(privateKeyPem: string, body: unknown): Promise<string> {\n    if (body === null || body === undefined) {\n      throw new Error('signPayload: body must be a non-null object');\n    }\n\n    if (!privateKeyPem?.includes('BEGIN PRIVATE KEY')) {\n      throw new Error('Invalid private key PEM: missing PKCS8 header');\n    }\n\n    // Decode PKCS8 PEM → ArrayBuffer\n    const pemBody = privateKeyPem\n      .replace(/-----BEGIN PRIVATE KEY-----/, '')\n      .replace(/-----END PRIVATE KEY-----/, '')\n      .replace(/\\s/g, '');\n    const keyBytes = Uint8Array.from(atob(pemBody), (c) => c.charCodeAt(0));\n\n    const cryptoKey = await globalThis.crypto.subtle.importKey(\n      'pkcs8',\n      keyBytes,\n      { name: 'ECDSA', namedCurve: 'P-256' },\n      false,\n      ['sign']\n    );\n\n    // Canonical payload bytes\n    const serialised = this.serializePayload(body);\n    const payloadBytes = new TextEncoder().encode(serialised);\n\n    // JWS protected header: {\"alg\":\"ES256\"} → base64url\n    const headerJson = '{\"alg\":\"ES256\"}';\n    const headerB64 = this._toBase64Url(new TextEncoder().encode(headerJson));\n    const payloadB64 = this._toBase64Url(payloadBytes);\n\n    // JWS signing input: ASCII(base64url(header) || '.' || base64url(payload))\n    const signingInput = new TextEncoder().encode(`${headerB64}.${payloadB64}`);\n\n    // ECDSA P-256 produces raw R‖S (64 bytes) — correct JWS format per RFC 7518 §3.4\n    const sigBytes = await globalThis.crypto.subtle.sign(\n      { name: 'ECDSA', hash: 'SHA-256' },\n      cryptoKey,\n      signingInput\n    );\n\n    const sigB64 = this._toBase64Url(new Uint8Array(sigBytes));\n\n    // Detached JWS: header..signature (empty payload segment)\n    return `${headerB64}..${sigB64}`;\n  }\n\n  private _toBase64Url(bytes: Uint8Array): string {\n    return btoa(String.fromCharCode(...bytes))\n      .replace(/\\+/g, '-')\n      .replace(/\\//g, '_')\n      .replace(/=+$/, '');\n  }\n}\n"]}

package/dist/environments.d.ts

@@ -0,0 +1,5 @@
+export declare const SpareApiEnvironment: {
+    readonly Sandbox: "https://api.sandbox.tryspare.ae";
+};
+export type SpareApiEnvironment = typeof SpareApiEnvironment.Sandbox;
+//# sourceMappingURL=environments.d.ts.map

package/dist/environments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../environments.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB;;CAEtB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,OAAO,CAAC"}

package/dist/environments.js

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+export const SpareApiEnvironment = {
+    Sandbox: "https://api.sandbox.tryspare.ae",
+};
+//# sourceMappingURL=environments.js.map

package/dist/environments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.js","sourceRoot":"","sources":["../environments.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,OAAO,EAAE,iCAAiC;CACpC,CAAC","sourcesContent":["// This file was auto-generated by Fern from our API Definition.\n\nexport const SpareApiEnvironment = {\n    Sandbox: \"https://api.sandbox.tryspare.ae\",\n} as const;\n\nexport type SpareApiEnvironment = typeof SpareApiEnvironment.Sandbox;\n"]}

package/dist/errors/SpareApiError.d.ts

@@ -0,0 +1,15 @@
+import type * as core from "../core/index.js";
+export declare class SpareApiError extends Error {
+    readonly statusCode?: number;
+    readonly body?: unknown;
+    readonly rawResponse?: core.RawResponse;
+    readonly cause?: unknown;
+    constructor({ message, statusCode, body, rawResponse, cause, }: {
+        message?: string;
+        statusCode?: number;
+        body?: unknown;
+        rawResponse?: core.RawResponse;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=SpareApiError.d.ts.map

package/dist/errors/SpareApiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpareApiError.d.ts","sourceRoot":"","sources":["../../errors/SpareApiError.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,IAAI,MAAM,kBAAkB,CAAC;AAG9C,qBAAa,aAAc,SAAQ,KAAK;IACpC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,IAAI,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAgB,WAAW,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC;IAC/C,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,EACR,OAAO,EACP,UAAU,EACV,IAAI,EACJ,WAAW,EACX,KAAK,GACR,EAAE;QACC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,WAAW,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC;QAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;KACnB;CAeJ"}

package/dist/errors/SpareApiError.js

@@ -0,0 +1,32 @@
+// This file was auto-generated by Fern from our API Definition.
+import { toJson } from "../core/json.js";
+export class SpareApiError extends Error {
+    constructor({ message, statusCode, body, rawResponse, cause, }) {
+        super(buildMessage({ message, statusCode, body }));
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+        this.statusCode = statusCode;
+        this.body = body;
+        this.rawResponse = rawResponse;
+        if (cause != null) {
+            this.cause = cause;
+        }
+    }
+}
+function buildMessage({ message, statusCode, body, }) {
+    const lines = [];
+    if (message != null) {
+        lines.push(message);
+    }
+    if (statusCode != null) {
+        lines.push(`Status code: ${statusCode.toString()}`);
+    }
+    if (body != null) {
+        lines.push(`Body: ${toJson(body, undefined, 2)}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=SpareApiError.js.map

package/dist/errors/SpareApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpareApiError.js","sourceRoot":"","sources":["../../errors/SpareApiError.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAGhE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,OAAO,aAAc,SAAQ,KAAK;IAMpC,YAAY,EACR,OAAO,EACP,UAAU,EACV,IAAI,EACJ,WAAW,EACX,KAAK,GAOR;QACG,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC;IACL,CAAC;CACJ;AAED,SAAS,YAAY,CAAC,EAClB,OAAO,EACP,UAAU,EACV,IAAI,GAKP;IACG,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["// This file was auto-generated by Fern from our API Definition.\n\nimport type * as core from \"../core/index.js\";\nimport { toJson } from \"../core/json.js\";\n\nexport class SpareApiError extends Error {\n    public readonly statusCode?: number;\n    public readonly body?: unknown;\n    public readonly rawResponse?: core.RawResponse;\n    public readonly cause?: unknown;\n\n    constructor({\n        message,\n        statusCode,\n        body,\n        rawResponse,\n        cause,\n    }: {\n        message?: string;\n        statusCode?: number;\n        body?: unknown;\n        rawResponse?: core.RawResponse;\n        cause?: unknown;\n    }) {\n        super(buildMessage({ message, statusCode, body }));\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (Error.captureStackTrace) {\n            Error.captureStackTrace(this, this.constructor);\n        }\n\n        this.name = this.constructor.name;\n        this.statusCode = statusCode;\n        this.body = body;\n        this.rawResponse = rawResponse;\n        if (cause != null) {\n            this.cause = cause;\n        }\n    }\n}\n\nfunction buildMessage({\n    message,\n    statusCode,\n    body,\n}: {\n    message: string | undefined;\n    statusCode: number | undefined;\n    body: unknown | undefined;\n}): string {\n    const lines: string[] = [];\n    if (message != null) {\n        lines.push(message);\n    }\n\n    if (statusCode != null) {\n        lines.push(`Status code: ${statusCode.toString()}`);\n    }\n\n    if (body != null) {\n        lines.push(`Body: ${toJson(body, undefined, 2)}`);\n    }\n\n    return lines.join(\"\\n\");\n}\n"]}

package/dist/errors/SpareApiTimeoutError.d.ts

@@ -0,0 +1,7 @@
+export declare class SpareApiTimeoutError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, opts?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=SpareApiTimeoutError.d.ts.map

package/dist/errors/SpareApiTimeoutError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpareApiTimeoutError.d.ts","sourceRoot":"","sources":["../../errors/SpareApiTimeoutError.ts"],"names":[],"mappings":"AAEA,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAY1D"}

package/dist/errors/SpareApiTimeoutError.js

@@ -0,0 +1,15 @@
+// This file was auto-generated by Fern from our API Definition.
+export class SpareApiTimeoutError extends Error {
+    constructor(message, opts) {
+        super(message);
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+        if (opts?.cause != null) {
+            this.cause = opts.cause;
+        }
+    }
+}
+//# sourceMappingURL=SpareApiTimeoutError.js.map

package/dist/errors/SpareApiTimeoutError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpareApiTimeoutError.js","sourceRoot":"","sources":["../../errors/SpareApiTimeoutError.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAG3C,YAAY,OAAe,EAAE,IAA0B;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,CAAC;IACL,CAAC;CACJ","sourcesContent":["// This file was auto-generated by Fern from our API Definition.\n\nexport class SpareApiTimeoutError extends Error {\n    public readonly cause?: unknown;\n\n    constructor(message: string, opts?: { cause?: unknown }) {\n        super(message);\n        Object.setPrototypeOf(this, new.target.prototype);\n        if (Error.captureStackTrace) {\n            Error.captureStackTrace(this, this.constructor);\n        }\n\n        this.name = this.constructor.name;\n        if (opts?.cause != null) {\n            this.cause = opts.cause;\n        }\n    }\n}\n"]}

package/dist/errors/handleNonStatusCodeError.d.ts

@@ -0,0 +1,3 @@
+import type * as core from "../core/index.js";
+export declare function handleNonStatusCodeError(error: core.Fetcher.Error, rawResponse: core.RawResponse, method: string, path: string): never;
+//# sourceMappingURL=handleNonStatusCodeError.d.ts.map

package/dist/errors/handleNonStatusCodeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleNonStatusCodeError.d.ts","sourceRoot":"","sources":["../../errors/handleNonStatusCodeError.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,IAAI,MAAM,kBAAkB,CAAC;AAG9C,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EACzB,WAAW,EAAE,IAAI,CAAC,WAAW,EAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACb,KAAK,CA6BP"}

package/dist/errors/handleNonStatusCodeError.js

@@ -0,0 +1,33 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "./index.js";
+export function handleNonStatusCodeError(error, rawResponse, method, path) {
+    switch (error.reason) {
+        case "non-json":
+            throw new errors.SpareApiError({
+                statusCode: error.statusCode,
+                body: error.rawBody,
+                rawResponse: rawResponse,
+            });
+        case "body-is-null":
+            throw new errors.SpareApiError({
+                statusCode: error.statusCode,
+                rawResponse: rawResponse,
+            });
+        case "timeout":
+            throw new errors.SpareApiTimeoutError(`Timeout exceeded when calling ${method} ${path}.`, {
+                cause: error.cause,
+            });
+        case "unknown":
+            throw new errors.SpareApiError({
+                message: error.errorMessage,
+                rawResponse: rawResponse,
+                cause: error.cause,
+            });
+        default:
+            throw new errors.SpareApiError({
+                message: "Unknown error",
+                rawResponse: rawResponse,
+            });
+    }
+}
+//# sourceMappingURL=handleNonStatusCodeError.js.map

package/dist/errors/handleNonStatusCodeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleNonStatusCodeError.js","sourceRoot":"","sources":["../../errors/handleNonStatusCodeError.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAGhE,OAAO,KAAK,MAAM,MAAM,YAAY,CAAC;AAErC,MAAM,UAAU,wBAAwB,CACpC,KAAyB,EACzB,WAA6B,EAC7B,MAAc,EACd,IAAY;IAEZ,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,UAAU;YACX,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC;gBAC3B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,IAAI,EAAE,KAAK,CAAC,OAAO;gBACnB,WAAW,EAAE,WAAW;aAC3B,CAAC,CAAC;QACP,KAAK,cAAc;YACf,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC;gBAC3B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,WAAW;aAC3B,CAAC,CAAC;QACP,KAAK,SAAS;YACV,MAAM,IAAI,MAAM,CAAC,oBAAoB,CAAC,iCAAiC,MAAM,IAAI,IAAI,GAAG,EAAE;gBACtF,KAAK,EAAE,KAAK,CAAC,KAAK;aACrB,CAAC,CAAC;QACP,KAAK,SAAS;YACV,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC;gBAC3B,OAAO,EAAE,KAAK,CAAC,YAAY;gBAC3B,WAAW,EAAE,WAAW;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;aACrB,CAAC,CAAC;QACP;YACI,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC;gBAC3B,OAAO,EAAE,eAAe;gBACxB,WAAW,EAAE,WAAW;aAC3B,CAAC,CAAC;IACX,CAAC;AACL,CAAC","sourcesContent":["// This file was auto-generated by Fern from our API Definition.\n\nimport type * as core from \"../core/index.js\";\nimport * as errors from \"./index.js\";\n\nexport function handleNonStatusCodeError(\n    error: core.Fetcher.Error,\n    rawResponse: core.RawResponse,\n    method: string,\n    path: string,\n): never {\n    switch (error.reason) {\n        case \"non-json\":\n            throw new errors.SpareApiError({\n                statusCode: error.statusCode,\n                body: error.rawBody,\n                rawResponse: rawResponse,\n            });\n        case \"body-is-null\":\n            throw new errors.SpareApiError({\n                statusCode: error.statusCode,\n                rawResponse: rawResponse,\n            });\n        case \"timeout\":\n            throw new errors.SpareApiTimeoutError(`Timeout exceeded when calling ${method} ${path}.`, {\n                cause: error.cause,\n            });\n        case \"unknown\":\n            throw new errors.SpareApiError({\n                message: error.errorMessage,\n                rawResponse: rawResponse,\n                cause: error.cause,\n            });\n        default:\n            throw new errors.SpareApiError({\n                message: \"Unknown error\",\n                rawResponse: rawResponse,\n            });\n    }\n}\n"]}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { SpareApiError } from "./SpareApiError.js";
+export { SpareApiTimeoutError } from "./SpareApiTimeoutError.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,3 @@
+export { SpareApiError } from "./SpareApiError.js";
+export { SpareApiTimeoutError } from "./SpareApiTimeoutError.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export { SpareApiError } from \"./SpareApiError.js\";\nexport { SpareApiTimeoutError } from \"./SpareApiTimeoutError.js\";\n"]}

package/dist/exports.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/exports.js";
+//# sourceMappingURL=exports.d.ts.map

package/dist/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../exports.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/exports.js

@@ -0,0 +1,2 @@
+export * from "./core/exports.js";
+//# sourceMappingURL=exports.js.map

package/dist/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../exports.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC","sourcesContent":["export * from \"./core/exports.js\";\n"]}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * as SpareApi from "./api/index.js";
+export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+export { SpareApiClient } from "./Client.js";
+export { SpareApiEnvironment } from "./environments.js";
+export { SpareApiError, SpareApiTimeoutError } from "./errors/index.js";
+export * from "./exports.js";
+export { Configuration } from './configuration.js';
+export { CryptoHelper } from './crypto.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxE,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * as SpareApi from "./api/index.js";
+export { SpareApiClient } from "./Client.js";
+export { SpareApiEnvironment } from "./environments.js";
+export { SpareApiError, SpareApiTimeoutError } from "./errors/index.js";
+export * from "./exports.js";
+export { Configuration } from './configuration.js';
+export { CryptoHelper } from './crypto.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxE,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export * as SpareApi from \"./api/index.js\";\nexport type { BaseClientOptions, BaseRequestOptions } from \"./BaseClient.js\";\nexport { SpareApiClient } from \"./Client.js\";\nexport { SpareApiEnvironment } from \"./environments.js\";\nexport { SpareApiError, SpareApiTimeoutError } from \"./errors/index.js\";\nexport * from \"./exports.js\";\n\nexport { Configuration } from './configuration.js';\n\nexport { CryptoHelper } from './crypto.js';\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@spare-technologies/spare-api",
+  "version": "1.0.0-beta.7",
+  "description": "Official TypeScript / Node.js SDK for the Spare Open Banking API",
+  "keywords": [
+    "spare",
+    "open-banking",
+    "sdk",
+    "mena",
+    "uae",
+    "ksa"
+  ],
+  "homepage": "https://docs.tryspare.com",
+  "bugs": {
+    "url": "https://github.com/spare-technologies/spare-api-ts/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/spare-technologies/spare-api-ts.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0"
+  }
+}