@kard-financial/sdk 4.5.0 → 4.7.0

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@kard-financial/sdk",
-        "X-Fern-SDK-Version": "4.5.0",
-        "User-Agent": "@kard-financial/sdk/4.5.0",
+        "X-Fern-SDK-Version": "4.7.0",
+        "User-Agent": "@kard-financial/sdk/4.7.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/commons/errors/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./ConflictError.js";
 export * from "./DoesNotExistError.js";
+export * from "./ForbiddenError.js";
 export * from "./InternalServerError.js";
 export * from "./InvalidRequest.js";
 export * from "./UnauthorizedError.js";

package/dist/cjs/api/resources/commons/errors/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ConflictError.js"), exports);
 __exportStar(require("./DoesNotExistError.js"), exports);
+__exportStar(require("./ForbiddenError.js"), exports);
 __exportStar(require("./InternalServerError.js"), exports);
 __exportStar(require("./InvalidRequest.js"), exports);
 __exportStar(require("./UnauthorizedError.js"), exports);

package/dist/cjs/api/resources/commons/types/NotificationType.d.ts

@@ -9,5 +9,6 @@ export declare const NotificationType: {
     readonly Location: "location";
     readonly UserOffer: "userOffer";
     readonly AuditUpdate: "auditUpdate";
+    readonly FileProcessingResult: "fileProcessingResult";
 };
 export type NotificationType = (typeof NotificationType)[keyof typeof NotificationType];

package/dist/cjs/api/resources/commons/types/NotificationType.js

@@ -13,4 +13,5 @@ exports.NotificationType = {
     Location: "location",
     UserOffer: "userOffer",
     AuditUpdate: "auditUpdate",
+    FileProcessingResult: "fileProcessingResult",
 };

package/dist/cjs/api/resources/files/index.d.ts

@@ -1,3 +1,2 @@
 export * from "./client/index.js";
-export * from "./errors/index.js";
 export * from "./types/index.js";

package/dist/cjs/api/resources/files/index.js

@@ -15,5 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/index.js"), exports);
-__exportStar(require("./errors/index.js"), exports);
 __exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/resources/index.d.ts

@@ -5,7 +5,6 @@ export * from "./commons/errors/index.js";
 export * as commons from "./commons/index.js";
 export * from "./commons/types/index.js";
 export * from "./files/client/requests/index.js";
-export * from "./files/errors/index.js";
 export * as files from "./files/index.js";
 export * from "./files/types/index.js";
 export * as notifications from "./notifications/index.js";

package/dist/cjs/api/resources/index.js

@@ -44,7 +44,6 @@ __exportStar(require("./commons/errors/index.js"), exports);
 exports.commons = __importStar(require("./commons/index.js"));
 __exportStar(require("./commons/types/index.js"), exports);
 __exportStar(require("./files/client/requests/index.js"), exports);
-__exportStar(require("./files/errors/index.js"), exports);
 exports.files = __importStar(require("./files/index.js"));
 __exportStar(require("./files/types/index.js"), exports);
 exports.notifications = __importStar(require("./notifications/index.js"));

package/dist/cjs/api/resources/notifications/types/FileResultData.d.ts

@@ -0,0 +1,6 @@
+import type * as KardApi from "../../../index.js";
+export interface FileResultData {
+    /** The internal ID of the notification */
+    id: string;
+    attributes: KardApi.FileMetadataAttribute;
+}

package/dist/cjs/api/resources/notifications/types/FileResultData.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/notifications/types/NotificationDataUnion.d.ts

@@ -1,5 +1,5 @@
 import type * as KardApi from "../../../index.js";
-export type NotificationDataUnion = KardApi.NotificationDataUnion.EarnedRewardApproved | KardApi.NotificationDataUnion.EarnedRewardSettled | KardApi.NotificationDataUnion.ValidTransaction | KardApi.NotificationDataUnion.FailedTransaction | KardApi.NotificationDataUnion.Clawback | KardApi.NotificationDataUnion.Offer | KardApi.NotificationDataUnion.Merchant | KardApi.NotificationDataUnion.Location | KardApi.NotificationDataUnion.UserOffer | KardApi.NotificationDataUnion.AuditUpdate;
+export type NotificationDataUnion = KardApi.NotificationDataUnion.EarnedRewardApproved | KardApi.NotificationDataUnion.EarnedRewardSettled | KardApi.NotificationDataUnion.ValidTransaction | KardApi.NotificationDataUnion.FailedTransaction | KardApi.NotificationDataUnion.Clawback | KardApi.NotificationDataUnion.Offer | KardApi.NotificationDataUnion.Merchant | KardApi.NotificationDataUnion.Location | KardApi.NotificationDataUnion.UserOffer | KardApi.NotificationDataUnion.AuditUpdate | KardApi.NotificationDataUnion.FileProcessingResult;
 export declare namespace NotificationDataUnion {
     interface EarnedRewardApproved extends KardApi.EarnedRewardApprovedData {
         type: "earnedRewardApproved";
@@ -31,4 +31,7 @@ export declare namespace NotificationDataUnion {
     interface AuditUpdate extends KardApi.AuditUpdateData {
         type: "auditUpdate";
     }
+    interface FileProcessingResult extends KardApi.FileResultData {
+        type: "fileProcessingResult";
+    }
 }

package/dist/cjs/api/resources/notifications/types/NotificationPayload.d.ts

@@ -436,8 +436,23 @@ import type * as KardApi from "../../../index.js";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "fileProcessingResult",
+ *             id: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
+ *             attributes: {
+ *                 fileName: "incomingTxns_2026-06-23.jsonl",
+ *                 lastModified: "2026-06-23T12:00:00Z",
+ *                 sentAt: "2026-06-23T12:05:00Z",
+ *                 downloadUrl: "https://example.com/processed/incomingTxns_2026-06-23.csv"
+ *             }
+ *         }
+ *     }
  */
 export interface NotificationPayload {
     data: KardApi.NotificationDataUnion;
     meta?: KardApi.NotificationMetadata;
+    errors?: KardApi.ErrorObject[];
 }

package/dist/cjs/api/resources/notifications/types/index.d.ts

@@ -19,6 +19,7 @@ export * from "./EarnedRewardSettledData.js";
 export * from "./FailedTransactionAttributes.js";
 export * from "./FailedTransactionData.js";
 export * from "./FailedTransactionRelationships.js";
+export * from "./FileResultData.js";
 export * from "./LocationAddress.js";
 export * from "./LocationCoordinates.js";
 export * from "./LocationStatus.js";

package/dist/cjs/api/resources/notifications/types/index.js

@@ -35,6 +35,7 @@ __exportStar(require("./EarnedRewardSettledData.js"), exports);
 __exportStar(require("./FailedTransactionAttributes.js"), exports);
 __exportStar(require("./FailedTransactionData.js"), exports);
 __exportStar(require("./FailedTransactionRelationships.js"), exports);
+__exportStar(require("./FileResultData.js"), exports);
 __exportStar(require("./LocationAddress.js"), exports);
 __exportStar(require("./LocationCoordinates.js"), exports);
 __exportStar(require("./LocationStatus.js"), exports);

package/dist/cjs/api/resources/transactions/client/Client.d.ts

@@ -233,6 +233,40 @@ export declare class TransactionsClient {
      */
     createAudits(organizationId: KardApi.OrganizationId, userId: string, request: KardApi.CreateAuditRequestBody, requestOptions?: TransactionsClient.RequestOptions): core.HttpResponsePromise<KardApi.CreateAuditResponseBody>;
     private __createAudits;
+    /**
+     * Generates up to 10 presigned PUT URLs for uploading JSONL transaction files (up to 5GB each) directly
+     * to storage. Each URL is valid for 15 minutes. Use the returned URL to upload the file via an HTTP PUT request with the
+     * binary file content as the body. If a URL expires before the upload completes, you must request a new one.
+     * Files can be uploaded as plain JSONL or as a gzip-compressed file.
+     * Only `coreTransaction` type is supported for bulk file uploads.
+     * <b>Required scopes:</b> `transaction:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.CreateFileUploadRequestBody} request
+     * @param {TransactionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.ForbiddenError}
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InvalidRequest}
+     * @throws {@link KardApi.InternalServerError}
+     *
+     * @example
+     *     await client.transactions.createBulkTransactionsUploadUrl("organization-123", {
+     *         data: [{
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_12345.jsonl"
+     *                 }
+     *             }, {
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_67890.jsonl"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBulkTransactionsUploadUrl(organizationId: KardApi.OrganizationId, request: KardApi.CreateFileUploadRequestBody, requestOptions?: TransactionsClient.RequestOptions): core.HttpResponsePromise<KardApi.CreateFileUploadUrlResponse>;
+    private __createBulkTransactionsUploadUrl;
     /**
      * Retrieve rewarded transaction history for a specific user. Returns only SETTLED transactions within the last 12 months.
      * <br/>

package/dist/cjs/api/resources/transactions/client/Client.js

@@ -471,6 +471,103 @@ class TransactionsClient {
             }
         });
     }
+    /**
+     * Generates up to 10 presigned PUT URLs for uploading JSONL transaction files (up to 5GB each) directly
+     * to storage. Each URL is valid for 15 minutes. Use the returned URL to upload the file via an HTTP PUT request with the
+     * binary file content as the body. If a URL expires before the upload completes, you must request a new one.
+     * Files can be uploaded as plain JSONL or as a gzip-compressed file.
+     * Only `coreTransaction` type is supported for bulk file uploads.
+     * <b>Required scopes:</b> `transaction:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.CreateFileUploadRequestBody} request
+     * @param {TransactionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.ForbiddenError}
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InvalidRequest}
+     * @throws {@link KardApi.InternalServerError}
+     *
+     * @example
+     *     await client.transactions.createBulkTransactionsUploadUrl("organization-123", {
+     *         data: [{
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_12345.jsonl"
+     *                 }
+     *             }, {
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_67890.jsonl"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBulkTransactionsUploadUrl(organizationId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createBulkTransactionsUploadUrl(organizationId, request, requestOptions));
+    }
+    __createBulkTransactionsUploadUrl(organizationId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.KardApiEnvironment.Production, `/v2/issuers/${core.url.encodePathParam(organizationId)}/transactions/upload`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new KardApi.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new KardApi.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 400:
+                        throw new KardApi.InvalidRequest(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new KardApi.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.KardApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.KardApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.KardApiError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.KardApiTimeoutError("Timeout exceeded when calling POST /v2/issuers/{organizationId}/transactions/upload.");
+                case "unknown":
+                    throw new errors.KardApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Retrieve rewarded transaction history for a specific user. Returns only SETTLED transactions within the last 12 months.
      * <br/>

package/dist/cjs/api/resources/transactions/types/CreateFileUploadAttributes.d.ts

@@ -0,0 +1,4 @@
+export interface CreateFileUploadAttributes {
+    /** Name of the file to upload, including extension (e.g. "transaction_12345.jsonl") */
+    filename: string;
+}

package/dist/cjs/api/resources/transactions/types/CreateFileUploadAttributes.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/transactions/types/CreateFileUploadData.d.ts

@@ -0,0 +1,5 @@
+import type * as KardApi from "../../../index.js";
+export interface CreateFileUploadData {
+    type: "incomingTransactionsFile";
+    attributes: KardApi.CreateFileUploadAttributes;
+}

package/dist/cjs/api/resources/transactions/types/CreateFileUploadData.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/transactions/types/CreateFileUploadRequestBody.d.ts

@@ -0,0 +1,5 @@
+import type * as KardApi from "../../../index.js";
+export interface CreateFileUploadRequestBody {
+    /** List of file upload requests (1–10 items per request). */
+    data: KardApi.CreateFileUploadData[];
+}

package/dist/cjs/api/resources/transactions/types/CreateFileUploadRequestBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/transactions/types/CreateFileUploadUrlResponse.d.ts

@@ -0,0 +1,25 @@
+import type * as KardApi from "../../../index.js";
+/**
+ * @example
+ *     {
+ *         data: [{
+ *                 type: "incomingTransactionsFile",
+ *                 id: "2NxKz7TYmqVH8UrjGP1xK3hF2gs",
+ *                 attributes: {
+ *                     url: "https://s3.amazonaws.com/bucket/key1?X-Amz-Algorithm=...",
+ *                     expiresIn: 900
+ *                 }
+ *             }, {
+ *                 type: "incomingTransactionsFile",
+ *                 id: "3PqLa8UZnrWI9VskHQ2yL4iG3ht",
+ *                 attributes: {
+ *                     url: "https://s3.amazonaws.com/bucket/key2?X-Amz-Algorithm=...",
+ *                     expiresIn: 900
+ *                 }
+ *             }]
+ *     }
+ */
+export interface CreateFileUploadUrlResponse {
+    /** List of created file upload sessions. */
+    data: KardApi.FileUploadUrlData[];
+}

package/dist/cjs/api/resources/transactions/types/CreateFileUploadUrlResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/transactions/types/FileUploadUrlAttributes.d.ts

@@ -0,0 +1,9 @@
+export interface FileUploadUrlAttributes {
+    /**
+     * Presigned PUT URL for uploading the file directly to storage.
+     * Use HTTP PUT with binary body. Expires after 15 minutes.
+     */
+    url: string;
+    /** Time in seconds until the presigned URL expires (900) */
+    expiresIn: number;
+}

package/dist/cjs/api/resources/transactions/types/FileUploadUrlAttributes.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/transactions/types/FileUploadUrlData.d.ts

@@ -0,0 +1,7 @@
+import type * as KardApi from "../../../index.js";
+export interface FileUploadUrlData {
+    type: "incomingTransactionsFile";
+    /** Upload session ID for traceability */
+    id: string;
+    attributes: KardApi.FileUploadUrlAttributes;
+}

package/dist/cjs/api/resources/transactions/types/FileUploadUrlData.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/transactions/types/index.d.ts

@@ -12,7 +12,13 @@ export * from "./CreateAuditRequestBody.js";
 export * from "./CreateAuditRequestDataUnion.js";
 export * from "./CreateAuditResponseBody.js";
 export * from "./CreateAuditResponseDataUnion.js";
+export * from "./CreateFileUploadAttributes.js";
+export * from "./CreateFileUploadData.js";
+export * from "./CreateFileUploadRequestBody.js";
+export * from "./CreateFileUploadUrlResponse.js";
 export * from "./DirectionType.js";
+export * from "./FileUploadUrlAttributes.js";
+export * from "./FileUploadUrlData.js";
 export * from "./FinancialInstitutionName.js";
 export * from "./FraudulentTransactionAttributes.js";
 export * from "./FraudulentTransactionData.js";

package/dist/cjs/api/resources/transactions/types/index.js

@@ -28,7 +28,13 @@ __exportStar(require("./CreateAuditRequestBody.js"), exports);
 __exportStar(require("./CreateAuditRequestDataUnion.js"), exports);
 __exportStar(require("./CreateAuditResponseBody.js"), exports);
 __exportStar(require("./CreateAuditResponseDataUnion.js"), exports);
+__exportStar(require("./CreateFileUploadAttributes.js"), exports);
+__exportStar(require("./CreateFileUploadData.js"), exports);
+__exportStar(require("./CreateFileUploadRequestBody.js"), exports);
+__exportStar(require("./CreateFileUploadUrlResponse.js"), exports);
 __exportStar(require("./DirectionType.js"), exports);
+__exportStar(require("./FileUploadUrlAttributes.js"), exports);
+__exportStar(require("./FileUploadUrlData.js"), exports);
 __exportStar(require("./FinancialInstitutionName.js"), exports);
 __exportStar(require("./FraudulentTransactionAttributes.js"), exports);
 __exportStar(require("./FraudulentTransactionData.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.5.0";
+export declare const SDK_VERSION = "4.7.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "4.5.0";
+exports.SDK_VERSION = "4.7.0";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@kard-financial/sdk",
-        "X-Fern-SDK-Version": "4.5.0",
-        "User-Agent": "@kard-financial/sdk/4.5.0",
+        "X-Fern-SDK-Version": "4.7.0",
+        "User-Agent": "@kard-financial/sdk/4.7.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/commons/errors/index.d.mts

@@ -1,5 +1,6 @@
 export * from "./ConflictError.mjs";
 export * from "./DoesNotExistError.mjs";
+export * from "./ForbiddenError.mjs";
 export * from "./InternalServerError.mjs";
 export * from "./InvalidRequest.mjs";
 export * from "./UnauthorizedError.mjs";

package/dist/esm/api/resources/commons/errors/index.mjs

@@ -1,5 +1,6 @@
 export * from "./ConflictError.mjs";
 export * from "./DoesNotExistError.mjs";
+export * from "./ForbiddenError.mjs";
 export * from "./InternalServerError.mjs";
 export * from "./InvalidRequest.mjs";
 export * from "./UnauthorizedError.mjs";

package/dist/esm/api/resources/commons/types/NotificationType.d.mts

@@ -9,5 +9,6 @@ export declare const NotificationType: {
     readonly Location: "location";
     readonly UserOffer: "userOffer";
     readonly AuditUpdate: "auditUpdate";
+    readonly FileProcessingResult: "fileProcessingResult";
 };
 export type NotificationType = (typeof NotificationType)[keyof typeof NotificationType];

package/dist/esm/api/resources/commons/types/NotificationType.mjs

@@ -10,4 +10,5 @@ export const NotificationType = {
     Location: "location",
     UserOffer: "userOffer",
     AuditUpdate: "auditUpdate",
+    FileProcessingResult: "fileProcessingResult",
 };

package/dist/esm/api/resources/files/index.d.mts

@@ -1,3 +1,2 @@
 export * from "./client/index.mjs";
-export * from "./errors/index.mjs";
 export * from "./types/index.mjs";

package/dist/esm/api/resources/files/index.mjs

@@ -1,3 +1,2 @@
 export * from "./client/index.mjs";
-export * from "./errors/index.mjs";
 export * from "./types/index.mjs";

package/dist/esm/api/resources/index.d.mts

@@ -5,7 +5,6 @@ export * from "./commons/errors/index.mjs";
 export * as commons from "./commons/index.mjs";
 export * from "./commons/types/index.mjs";
 export * from "./files/client/requests/index.mjs";
-export * from "./files/errors/index.mjs";
 export * as files from "./files/index.mjs";
 export * from "./files/types/index.mjs";
 export * as notifications from "./notifications/index.mjs";

package/dist/esm/api/resources/index.mjs

@@ -5,7 +5,6 @@ export * from "./commons/errors/index.mjs";
 export * as commons from "./commons/index.mjs";
 export * from "./commons/types/index.mjs";
 export * from "./files/client/requests/index.mjs";
-export * from "./files/errors/index.mjs";
 export * as files from "./files/index.mjs";
 export * from "./files/types/index.mjs";
 export * as notifications from "./notifications/index.mjs";

package/dist/esm/api/resources/notifications/types/FileResultData.d.mts

@@ -0,0 +1,6 @@
+import type * as KardApi from "../../../index.mjs";
+export interface FileResultData {
+    /** The internal ID of the notification */
+    id: string;
+    attributes: KardApi.FileMetadataAttribute;
+}

package/dist/esm/api/resources/notifications/types/FileResultData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/notifications/types/NotificationDataUnion.d.mts

@@ -1,5 +1,5 @@
 import type * as KardApi from "../../../index.mjs";
-export type NotificationDataUnion = KardApi.NotificationDataUnion.EarnedRewardApproved | KardApi.NotificationDataUnion.EarnedRewardSettled | KardApi.NotificationDataUnion.ValidTransaction | KardApi.NotificationDataUnion.FailedTransaction | KardApi.NotificationDataUnion.Clawback | KardApi.NotificationDataUnion.Offer | KardApi.NotificationDataUnion.Merchant | KardApi.NotificationDataUnion.Location | KardApi.NotificationDataUnion.UserOffer | KardApi.NotificationDataUnion.AuditUpdate;
+export type NotificationDataUnion = KardApi.NotificationDataUnion.EarnedRewardApproved | KardApi.NotificationDataUnion.EarnedRewardSettled | KardApi.NotificationDataUnion.ValidTransaction | KardApi.NotificationDataUnion.FailedTransaction | KardApi.NotificationDataUnion.Clawback | KardApi.NotificationDataUnion.Offer | KardApi.NotificationDataUnion.Merchant | KardApi.NotificationDataUnion.Location | KardApi.NotificationDataUnion.UserOffer | KardApi.NotificationDataUnion.AuditUpdate | KardApi.NotificationDataUnion.FileProcessingResult;
 export declare namespace NotificationDataUnion {
     interface EarnedRewardApproved extends KardApi.EarnedRewardApprovedData {
         type: "earnedRewardApproved";
@@ -31,4 +31,7 @@ export declare namespace NotificationDataUnion {
     interface AuditUpdate extends KardApi.AuditUpdateData {
         type: "auditUpdate";
     }
+    interface FileProcessingResult extends KardApi.FileResultData {
+        type: "fileProcessingResult";
+    }
 }

package/dist/esm/api/resources/notifications/types/NotificationPayload.d.mts

@@ -436,8 +436,23 @@ import type * as KardApi from "../../../index.mjs";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "fileProcessingResult",
+ *             id: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
+ *             attributes: {
+ *                 fileName: "incomingTxns_2026-06-23.jsonl",
+ *                 lastModified: "2026-06-23T12:00:00Z",
+ *                 sentAt: "2026-06-23T12:05:00Z",
+ *                 downloadUrl: "https://example.com/processed/incomingTxns_2026-06-23.csv"
+ *             }
+ *         }
+ *     }
  */
 export interface NotificationPayload {
     data: KardApi.NotificationDataUnion;
     meta?: KardApi.NotificationMetadata;
+    errors?: KardApi.ErrorObject[];
 }

package/dist/esm/api/resources/notifications/types/index.d.mts

@@ -19,6 +19,7 @@ export * from "./EarnedRewardSettledData.mjs";
 export * from "./FailedTransactionAttributes.mjs";
 export * from "./FailedTransactionData.mjs";
 export * from "./FailedTransactionRelationships.mjs";
+export * from "./FileResultData.mjs";
 export * from "./LocationAddress.mjs";
 export * from "./LocationCoordinates.mjs";
 export * from "./LocationStatus.mjs";

package/dist/esm/api/resources/notifications/types/index.mjs

@@ -19,6 +19,7 @@ export * from "./EarnedRewardSettledData.mjs";
 export * from "./FailedTransactionAttributes.mjs";
 export * from "./FailedTransactionData.mjs";
 export * from "./FailedTransactionRelationships.mjs";
+export * from "./FileResultData.mjs";
 export * from "./LocationAddress.mjs";
 export * from "./LocationCoordinates.mjs";
 export * from "./LocationStatus.mjs";

package/dist/esm/api/resources/transactions/client/Client.d.mts

@@ -233,6 +233,40 @@ export declare class TransactionsClient {
      */
     createAudits(organizationId: KardApi.OrganizationId, userId: string, request: KardApi.CreateAuditRequestBody, requestOptions?: TransactionsClient.RequestOptions): core.HttpResponsePromise<KardApi.CreateAuditResponseBody>;
     private __createAudits;
+    /**
+     * Generates up to 10 presigned PUT URLs for uploading JSONL transaction files (up to 5GB each) directly
+     * to storage. Each URL is valid for 15 minutes. Use the returned URL to upload the file via an HTTP PUT request with the
+     * binary file content as the body. If a URL expires before the upload completes, you must request a new one.
+     * Files can be uploaded as plain JSONL or as a gzip-compressed file.
+     * Only `coreTransaction` type is supported for bulk file uploads.
+     * <b>Required scopes:</b> `transaction:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.CreateFileUploadRequestBody} request
+     * @param {TransactionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.ForbiddenError}
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InvalidRequest}
+     * @throws {@link KardApi.InternalServerError}
+     *
+     * @example
+     *     await client.transactions.createBulkTransactionsUploadUrl("organization-123", {
+     *         data: [{
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_12345.jsonl"
+     *                 }
+     *             }, {
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_67890.jsonl"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBulkTransactionsUploadUrl(organizationId: KardApi.OrganizationId, request: KardApi.CreateFileUploadRequestBody, requestOptions?: TransactionsClient.RequestOptions): core.HttpResponsePromise<KardApi.CreateFileUploadUrlResponse>;
+    private __createBulkTransactionsUploadUrl;
     /**
      * Retrieve rewarded transaction history for a specific user. Returns only SETTLED transactions within the last 12 months.
      * <br/>

package/dist/esm/api/resources/transactions/client/Client.mjs

@@ -435,6 +435,103 @@ export class TransactionsClient {
             }
         });
     }
+    /**
+     * Generates up to 10 presigned PUT URLs for uploading JSONL transaction files (up to 5GB each) directly
+     * to storage. Each URL is valid for 15 minutes. Use the returned URL to upload the file via an HTTP PUT request with the
+     * binary file content as the body. If a URL expires before the upload completes, you must request a new one.
+     * Files can be uploaded as plain JSONL or as a gzip-compressed file.
+     * Only `coreTransaction` type is supported for bulk file uploads.
+     * <b>Required scopes:</b> `transaction:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.CreateFileUploadRequestBody} request
+     * @param {TransactionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.ForbiddenError}
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InvalidRequest}
+     * @throws {@link KardApi.InternalServerError}
+     *
+     * @example
+     *     await client.transactions.createBulkTransactionsUploadUrl("organization-123", {
+     *         data: [{
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_12345.jsonl"
+     *                 }
+     *             }, {
+     *                 type: "incomingTransactionsFile",
+     *                 attributes: {
+     *                     filename: "transaction_67890.jsonl"
+     *                 }
+     *             }]
+     *     })
+     */
+    createBulkTransactionsUploadUrl(organizationId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createBulkTransactionsUploadUrl(organizationId, request, requestOptions));
+    }
+    __createBulkTransactionsUploadUrl(organizationId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.KardApiEnvironment.Production, `/v2/issuers/${core.url.encodePathParam(organizationId)}/transactions/upload`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new KardApi.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new KardApi.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 400:
+                        throw new KardApi.InvalidRequest(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new KardApi.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.KardApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.KardApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.KardApiError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.KardApiTimeoutError("Timeout exceeded when calling POST /v2/issuers/{organizationId}/transactions/upload.");
+                case "unknown":
+                    throw new errors.KardApiError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Retrieve rewarded transaction history for a specific user. Returns only SETTLED transactions within the last 12 months.
      * <br/>

package/dist/esm/api/resources/transactions/types/CreateFileUploadAttributes.d.mts

@@ -0,0 +1,4 @@
+export interface CreateFileUploadAttributes {
+    /** Name of the file to upload, including extension (e.g. "transaction_12345.jsonl") */
+    filename: string;
+}

package/dist/esm/api/resources/transactions/types/CreateFileUploadAttributes.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/transactions/types/CreateFileUploadData.d.mts

@@ -0,0 +1,5 @@
+import type * as KardApi from "../../../index.mjs";
+export interface CreateFileUploadData {
+    type: "incomingTransactionsFile";
+    attributes: KardApi.CreateFileUploadAttributes;
+}

package/dist/esm/api/resources/transactions/types/CreateFileUploadData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/transactions/types/CreateFileUploadRequestBody.d.mts

@@ -0,0 +1,5 @@
+import type * as KardApi from "../../../index.mjs";
+export interface CreateFileUploadRequestBody {
+    /** List of file upload requests (1–10 items per request). */
+    data: KardApi.CreateFileUploadData[];
+}

package/dist/esm/api/resources/transactions/types/CreateFileUploadRequestBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/transactions/types/CreateFileUploadUrlResponse.d.mts

@@ -0,0 +1,25 @@
+import type * as KardApi from "../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         data: [{
+ *                 type: "incomingTransactionsFile",
+ *                 id: "2NxKz7TYmqVH8UrjGP1xK3hF2gs",
+ *                 attributes: {
+ *                     url: "https://s3.amazonaws.com/bucket/key1?X-Amz-Algorithm=...",
+ *                     expiresIn: 900
+ *                 }
+ *             }, {
+ *                 type: "incomingTransactionsFile",
+ *                 id: "3PqLa8UZnrWI9VskHQ2yL4iG3ht",
+ *                 attributes: {
+ *                     url: "https://s3.amazonaws.com/bucket/key2?X-Amz-Algorithm=...",
+ *                     expiresIn: 900
+ *                 }
+ *             }]
+ *     }
+ */
+export interface CreateFileUploadUrlResponse {
+    /** List of created file upload sessions. */
+    data: KardApi.FileUploadUrlData[];
+}

package/dist/esm/api/resources/transactions/types/CreateFileUploadUrlResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/transactions/types/FileUploadUrlAttributes.d.mts

@@ -0,0 +1,9 @@
+export interface FileUploadUrlAttributes {
+    /**
+     * Presigned PUT URL for uploading the file directly to storage.
+     * Use HTTP PUT with binary body. Expires after 15 minutes.
+     */
+    url: string;
+    /** Time in seconds until the presigned URL expires (900) */
+    expiresIn: number;
+}

package/dist/esm/api/resources/transactions/types/FileUploadUrlAttributes.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/transactions/types/FileUploadUrlData.d.mts

@@ -0,0 +1,7 @@
+import type * as KardApi from "../../../index.mjs";
+export interface FileUploadUrlData {
+    type: "incomingTransactionsFile";
+    /** Upload session ID for traceability */
+    id: string;
+    attributes: KardApi.FileUploadUrlAttributes;
+}

package/dist/esm/api/resources/transactions/types/FileUploadUrlData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/transactions/types/index.d.mts

@@ -12,7 +12,13 @@ export * from "./CreateAuditRequestBody.mjs";
 export * from "./CreateAuditRequestDataUnion.mjs";
 export * from "./CreateAuditResponseBody.mjs";
 export * from "./CreateAuditResponseDataUnion.mjs";
+export * from "./CreateFileUploadAttributes.mjs";
+export * from "./CreateFileUploadData.mjs";
+export * from "./CreateFileUploadRequestBody.mjs";
+export * from "./CreateFileUploadUrlResponse.mjs";
 export * from "./DirectionType.mjs";
+export * from "./FileUploadUrlAttributes.mjs";
+export * from "./FileUploadUrlData.mjs";
 export * from "./FinancialInstitutionName.mjs";
 export * from "./FraudulentTransactionAttributes.mjs";
 export * from "./FraudulentTransactionData.mjs";

package/dist/esm/api/resources/transactions/types/index.mjs

@@ -12,7 +12,13 @@ export * from "./CreateAuditRequestBody.mjs";
 export * from "./CreateAuditRequestDataUnion.mjs";
 export * from "./CreateAuditResponseBody.mjs";
 export * from "./CreateAuditResponseDataUnion.mjs";
+export * from "./CreateFileUploadAttributes.mjs";
+export * from "./CreateFileUploadData.mjs";
+export * from "./CreateFileUploadRequestBody.mjs";
+export * from "./CreateFileUploadUrlResponse.mjs";
 export * from "./DirectionType.mjs";
+export * from "./FileUploadUrlAttributes.mjs";
+export * from "./FileUploadUrlData.mjs";
 export * from "./FinancialInstitutionName.mjs";
 export * from "./FraudulentTransactionAttributes.mjs";
 export * from "./FraudulentTransactionData.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.5.0";
+export declare const SDK_VERSION = "4.7.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.5.0";
+export const SDK_VERSION = "4.7.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kard-financial/sdk",
-    "version": "4.5.0",
+    "version": "4.7.0",
     "private": false,
     "repository": "github:KardFinancial/kard-node-sdk",
     "type": "commonjs",

package/reference.md

@@ -724,6 +724,94 @@ await client.transactions.createAudits("organization-123", "user-123", {
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.transactions.<a href="/src/api/resources/transactions/client/Client.ts">createBulkTransactionsUploadUrl</a>(organizationId, { ...params }) -> KardApi.CreateFileUploadUrlResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Generates up to 10 presigned PUT URLs for uploading JSONL transaction files (up to 5GB each) directly
+to storage. Each URL is valid for 15 minutes. Use the returned URL to upload the file via an HTTP PUT request with the
+binary file content as the body. If a URL expires before the upload completes, you must request a new one.
+Files can be uploaded as plain JSONL or as a gzip-compressed file.
+Only `coreTransaction` type is supported for bulk file uploads.
+<b>Required scopes:</b> `transaction:write`
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.transactions.createBulkTransactionsUploadUrl("organization-123", {
+    data: [{
+            type: "incomingTransactionsFile",
+            attributes: {
+                filename: "transaction_12345.jsonl"
+            }
+        }, {
+            type: "incomingTransactionsFile",
+            attributes: {
+                filename: "transaction_67890.jsonl"
+            }
+        }]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**organizationId:** `KardApi.OrganizationId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `KardApi.CreateFileUploadRequestBody` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `TransactionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

package/dist/cjs/api/resources/files/errors/index.d.ts

@@ -1 +0,0 @@
-export * from "./ForbiddenError.js";

package/dist/cjs/api/resources/files/errors/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./ForbiddenError.js"), exports);

package/dist/esm/api/resources/files/errors/index.d.mts

@@ -1 +0,0 @@
-export * from "./ForbiddenError.mjs";

package/dist/esm/api/resources/files/errors/index.mjs

@@ -1 +0,0 @@
-export * from "./ForbiddenError.mjs";