@uveysservetoglu/kobil-payment 1.0.0

package/README.md

@@ -0,0 +1,80 @@
+# @uveysservetoglu/kobil-payment
+
+KOBIL Pay (mpay-merchant) client for Node.js / TypeScript, with automatic OAuth token
+management and typed models.
+
+```bash
+npm install @uveysservetoglu/kobil-payment
+```
+
+## Quick start
+
+OAuth credentials (`tokenEndpoint`, `clientId`, `clientSecret`) are shared across KOBIL
+modules and read from `KOBIL_*` env vars if you don't pass them. `merchantId` defaults to
+`clientId`.
+
+```ts
+import { PaymentClient, paymentGroup } from "@uveysservetoglu/kobil-payment";
+
+const payment = new PaymentClient({
+  // credentials (or via KOBIL_TOKEN_ENDPOINT / KOBIL_CLIENT_ID / KOBIL_CLIENT_SECRET):
+  tokenEndpoint: process.env.KOBIL_TOKEN_ENDPOINT!,
+  clientId: process.env.KOBIL_CLIENT_ID!,
+  clientSecret: process.env.KOBIL_CLIENT_SECRET!,
+  // payment-specific:
+  paymentBaseUrl: "https://pay.cloud.kobil.com/mpay-merchant/create/transaction",
+  merchantName: "ISPARK",
+  defaultCurrency: "TRY",
+  defaultMerchantCallback: "https://yourapi.com/payment-callback",
+});
+```
+
+> **Amounts** are in the smallest currency unit (`1300` = 13.00 TRY). **Timeouts** in minutes.
+
+## The six operations
+
+```ts
+// 1. Regular payment (immediate charge)
+const res = await payment.createTransaction({
+  userId,
+  amount: 1300,
+  paymentContent: paymentGroup(["Service Amount", "10.0 TL"], ["Tax Amount", "3.0 TL"]),
+});
+// res.transactionId ; parsePaymentStatus(res) === "new"
+
+// 2. Pre-authorization (hold funds)
+const pre = await payment.createPreAuthTransaction({ userId, amount: 1300 });
+// pre.nextAction holds the post-auth handle
+
+// 3. Post-authorization (settle final amount)
+await payment.postAuth({ transactionId: pre.transactionId!, amount: 40 });
+
+// 4. Status
+const status = await payment.getStatus({ transactionId });
+
+// 5. Cancel (void)
+await payment.cancel({ transactionId, userId, cancellationMessage: "Iptal" });
+
+// 6. Refund (partial or full)
+await payment.refund({ transactionId, userId, amount: 5555, currency: "USD" });
+```
+
+JavaScript usage is identical (`const { PaymentClient } = require("@uveysservetoglu/kobil-payment")`).
+
+## Errors
+
+All operations throw `KobilPaymentError` (extends `KobilError`) with `statusCode` and
+`responseBody` when available.
+
+```ts
+import { KobilPaymentError } from "@uveysservetoglu/kobil-payment";
+try {
+  await payment.createTransaction({ userId, amount: 1300 });
+} catch (e) {
+  if (e instanceof KobilPaymentError) console.error(e.statusCode, e.responseBody);
+}
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,46 @@
+import { KobilCredentials, KobilError, KobilServiceClient, TokenProvider } from "@uveysservetoglu/kobil-core";
+import { CancelInput, CreateTransactionInput, PostAuthInput, RefundInput, StatusInput, TransactionResult } from "./types";
+export interface PaymentClientOptions extends Partial<KobilCredentials> {
+    /** Base transaction URL; `/postauth`, `/status`, `/void`, `/refund` are derived from it. */
+    paymentBaseUrl: string;
+    /** Merchant id. Optional: defaults to `clientId`. */
+    merchantId?: string;
+    /** Must match `merchantId`; defaults to it. */
+    merchantServiceUuid?: string;
+    merchantName: string;
+    tenantId?: string;
+    /** Default ISO currency code. Default: "TRY". */
+    defaultCurrency?: string;
+    defaultMerchantCallback?: string;
+    /** Default transaction timeout in minutes. Default: 59. */
+    defaultTransactionTimeoutMinutes?: number;
+    /** Wire protocol version. Default: 1. */
+    version?: number;
+    /** Reuse a shared token provider (e.g. across modules). If omitted, one is created from credentials/env. */
+    tokenProvider?: TokenProvider;
+}
+/** Client for the KOBIL Pay (mpay-merchant) API. */
+export declare class PaymentClient extends KobilServiceClient {
+    private readonly baseUrl;
+    private readonly clientId;
+    private readonly merchantName;
+    private readonly merchantIdOption?;
+    private readonly merchantServiceUuidOption?;
+    private readonly tenantId?;
+    private readonly defaultCurrency;
+    private readonly defaultMerchantCallback?;
+    private readonly defaultTimeout;
+    private readonly version;
+    constructor(options: PaymentClientOptions);
+    protected makeError(message: string, statusCode?: number, responseBody?: string, cause?: unknown): KobilError;
+    createTransaction(input: CreateTransactionInput, signal?: AbortSignal): Promise<TransactionResult>;
+    createPreAuthTransaction(input: CreateTransactionInput, signal?: AbortSignal): Promise<TransactionResult>;
+    private createInternal;
+    postAuth(input: PostAuthInput, signal?: AbortSignal): Promise<TransactionResult>;
+    getStatus(input: StatusInput, signal?: AbortSignal): Promise<TransactionResult>;
+    cancel(input: CancelInput, signal?: AbortSignal): Promise<TransactionResult>;
+    refund(input: RefundInput, signal?: AbortSignal): Promise<TransactionResult>;
+    private merchantId;
+    private merchantServiceUuid;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,aAAa,EAEd,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,oBAAqB,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IACrE,4FAA4F;IAC5F,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,2DAA2D;IAC3D,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,oDAAoD;AACpD,qBAAa,aAAc,SAAQ,kBAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAS;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,oBAAoB;cA0BtB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU;IAItH,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIlG,wBAAwB,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzG,OAAO,CAAC,cAAc;IAoBtB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAYhF,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS/E,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgB5E,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoB5E,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,mBAAmB;CAK5B"}

package/dist/client.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentClient = void 0;
+const crypto_1 = require("crypto");
+const kobil_core_1 = require("@uveysservetoglu/kobil-core");
+const error_1 = require("./error");
+/** Client for the KOBIL Pay (mpay-merchant) API. */
+class PaymentClient extends kobil_core_1.KobilServiceClient {
+    baseUrl;
+    clientId;
+    merchantName;
+    merchantIdOption;
+    merchantServiceUuidOption;
+    tenantId;
+    defaultCurrency;
+    defaultMerchantCallback;
+    defaultTimeout;
+    version;
+    constructor(options) {
+        const credentials = (0, kobil_core_1.credentialsFromEnv)({
+            tokenEndpoint: options.tokenEndpoint,
+            clientId: options.clientId,
+            clientSecret: options.clientSecret,
+            tokenAuthMode: options.tokenAuthMode,
+            defaultTokenTtlSeconds: options.defaultTokenTtlSeconds,
+            tokenExpirySkewSeconds: options.tokenExpirySkewSeconds,
+        });
+        super(options.tokenProvider ?? new kobil_core_1.DefaultTokenProvider(credentials));
+        if (!options.paymentBaseUrl)
+            throw new kobil_core_1.KobilError("paymentBaseUrl is required.");
+        if (!options.merchantName)
+            throw new kobil_core_1.KobilError("merchantName is required.");
+        this.baseUrl = options.paymentBaseUrl.replace(/\/+$/, "");
+        this.clientId = credentials.clientId;
+        this.merchantName = options.merchantName;
+        this.merchantIdOption = options.merchantId;
+        this.merchantServiceUuidOption = options.merchantServiceUuid;
+        this.tenantId = options.tenantId;
+        this.defaultCurrency = options.defaultCurrency ?? "TRY";
+        this.defaultMerchantCallback = options.defaultMerchantCallback;
+        this.defaultTimeout = options.defaultTransactionTimeoutMinutes ?? 59;
+        this.version = options.version ?? 1;
+    }
+    makeError(message, statusCode, responseBody, cause) {
+        return new error_1.KobilPaymentError(message, { statusCode, responseBody, cause });
+    }
+    createTransaction(input, signal) {
+        return this.createInternal(input, false, signal);
+    }
+    createPreAuthTransaction(input, signal) {
+        return this.createInternal(input, true, signal);
+    }
+    createInternal(input, preAuth, signal) {
+        if (!input.userId)
+            throw new error_1.KobilPaymentError("userId cannot be empty.");
+        const body = {
+            version: this.version,
+            idempotencyId: input.idempotencyId ?? (0, crypto_1.randomUUID)(),
+            userId: input.userId,
+            merchantId: this.merchantId(),
+            merchantServiceUUID: this.merchantServiceUuid(),
+            merchantName: this.merchantName,
+            merchantCallback: input.merchantCallback ?? this.defaultMerchantCallback,
+            transactionTimeout: input.transactionTimeoutMinutes ?? this.defaultTimeout,
+            tenantId: this.tenantId,
+            amount: input.amount,
+            currency: (input.currency ?? this.defaultCurrency).toUpperCase(),
+            paymentContent: input.paymentContent,
+        };
+        if (preAuth)
+            body.paymentTenantType = "preAuth";
+        return this.sendJson("POST", this.baseUrl, prune(body), signal);
+    }
+    postAuth(input, signal) {
+        if (!input.transactionId)
+            throw new error_1.KobilPaymentError("transactionId cannot be empty.");
+        const query = new URLSearchParams({
+            id: input.transactionId,
+            idempotencyId: input.idempotencyId ?? (0, crypto_1.randomUUID)(),
+            amount: String(input.amount),
+        });
+        const callback = input.merchantCallback ?? this.defaultMerchantCallback;
+        if (callback)
+            query.set("merchantCallback", callback);
+        return this.sendJson("GET", `${this.baseUrl}/postauth?${query.toString()}`, undefined, signal);
+    }
+    getStatus(input, signal) {
+        if (!input.transactionId)
+            throw new error_1.KobilPaymentError("transactionId cannot be empty.");
+        return this.sendJson("POST", `${this.baseUrl}/status`, prune({
+            merchantId: this.merchantId(),
+            merchantCallback: input.merchantCallback ?? this.defaultMerchantCallback,
+            transactionId: input.transactionId,
+        }), signal);
+    }
+    cancel(input, signal) {
+        if (!input.transactionId)
+            throw new error_1.KobilPaymentError("transactionId cannot be empty.");
+        if (!input.userId)
+            throw new error_1.KobilPaymentError("userId cannot be empty.");
+        return this.sendJson("POST", `${this.baseUrl}/void`, prune({
+            version: this.version,
+            userId: input.userId,
+            idempotencyId: input.idempotencyId ?? (0, crypto_1.randomUUID)(),
+            merchantServiceUUID: this.merchantServiceUuid(),
+            merchantCallback: input.merchantCallback ?? this.defaultMerchantCallback,
+            transactionTimeout: input.transactionTimeoutMinutes ?? this.defaultTimeout,
+            merchantId: this.merchantId(),
+            paymentTransactionId: input.transactionId,
+            cancellationMessage: input.cancellationMessage,
+        }), signal);
+    }
+    refund(input, signal) {
+        if (!input.transactionId)
+            throw new error_1.KobilPaymentError("transactionId cannot be empty.");
+        if (!input.userId)
+            throw new error_1.KobilPaymentError("userId cannot be empty.");
+        const serviceUuid = this.merchantServiceUuid();
+        return this.sendJson("POST", `${this.baseUrl}/refund`, prune({
+            version: this.version,
+            userId: input.userId,
+            idempotencyId: input.idempotencyId ?? (0, crypto_1.randomUUID)(),
+            merchantServiceUUID: serviceUuid,
+            merchantCallback: input.merchantCallback ?? this.defaultMerchantCallback,
+            transactionTimeout: input.transactionTimeoutMinutes ?? this.defaultTimeout,
+            merchantId: this.merchantId(),
+            merchantUserId: input.userId,
+            paymentTransactionId: input.transactionId,
+            amount: input.amount,
+            currency: (input.currency ?? this.defaultCurrency).toUpperCase(),
+            merchantServiceProviderId: serviceUuid,
+        }), signal);
+    }
+    merchantId() {
+        return this.merchantIdOption && this.merchantIdOption.length > 0 ? this.merchantIdOption : this.clientId;
+    }
+    merchantServiceUuid() {
+        return this.merchantServiceUuidOption && this.merchantServiceUuidOption.length > 0
+            ? this.merchantServiceUuidOption
+            : this.merchantId();
+    }
+}
+exports.PaymentClient = PaymentClient;
+/** Removes undefined/null properties so optional fields are omitted from the JSON body. */
+function prune(obj) {
+    const out = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined && value !== null)
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/content.d.ts

@@ -0,0 +1,9 @@
+import { PaymentContent } from "./types";
+/**
+ * Builds a single group of key/value lines.
+ * @example paymentGroup(["Service Amount", "10.0 TL"], ["Tax Amount", "3.0 TL"])
+ */
+export declare function paymentGroup(...items: [string, unknown][]): PaymentContent;
+/** Builds multiple groups of key/value lines. */
+export declare function paymentGroups(...groups: [string, unknown][][]): PaymentContent;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,cAAc,CAE1E;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,cAAc,CAE9E"}

package/dist/content.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paymentGroup = paymentGroup;
+exports.paymentGroups = paymentGroups;
+/**
+ * Builds a single group of key/value lines.
+ * @example paymentGroup(["Service Amount", "10.0 TL"], ["Tax Amount", "3.0 TL"])
+ */
+function paymentGroup(...items) {
+    return [items.map(([key, value]) => ({ key, value }))];
+}
+/** Builds multiple groups of key/value lines. */
+function paymentGroups(...groups) {
+    return groups.map((group) => group.map(([key, value]) => ({ key, value })));
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":";;AAMA,oCAEC;AAGD,sCAEC;AAXD;;;GAGG;AACH,SAAgB,YAAY,CAAC,GAAG,KAA0B;IACxD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,iDAAiD;AACjD,SAAgB,aAAa,CAAC,GAAG,MAA6B;IAC5D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,5 @@
+import { KobilError } from "@uveysservetoglu/kobil-core";
+/** Thrown when a payment operation fails. */
+export declare class KobilPaymentError extends KobilError {
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,6CAA6C;AAC7C,qBAAa,iBAAkB,SAAQ,UAAU;CAAG"}

package/dist/error.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KobilPaymentError = void 0;
+const kobil_core_1 = require("@uveysservetoglu/kobil-core");
+/** Thrown when a payment operation fails. */
+class KobilPaymentError extends kobil_core_1.KobilError {
+}
+exports.KobilPaymentError = KobilPaymentError;
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":";;;AAAA,4DAAyD;AAEzD,6CAA6C;AAC7C,MAAa,iBAAkB,SAAQ,uBAAU;CAAG;AAApD,8CAAoD"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { PaymentClient } from "./client";
+export type { PaymentClientOptions } from "./client";
+export { KobilPaymentError } from "./error";
+export { paymentGroup, paymentGroups } from "./content";
+export { parsePaymentStatus } from "./types";
+export type { CreateTransactionInput, PostAuthInput, StatusInput, CancelInput, RefundInput, TransactionResult, PaymentContent, PaymentContentItem, PaymentStatus, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePaymentStatus = exports.paymentGroups = exports.paymentGroup = exports.KobilPaymentError = exports.PaymentClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "PaymentClient", { enumerable: true, get: function () { return client_1.PaymentClient; } });
+var error_1 = require("./error");
+Object.defineProperty(exports, "KobilPaymentError", { enumerable: true, get: function () { return error_1.KobilPaymentError; } });
+var content_1 = require("./content");
+Object.defineProperty(exports, "paymentGroup", { enumerable: true, get: function () { return content_1.paymentGroup; } });
+Object.defineProperty(exports, "paymentGroups", { enumerable: true, get: function () { return content_1.paymentGroups; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "parsePaymentStatus", { enumerable: true, get: function () { return types_1.parsePaymentStatus; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAC1B,qCAAwD;AAA/C,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA;AACpC,iCAA6C;AAApC,2GAAA,kBAAkB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+/** A single key/value line shown to the payer. */
+export interface PaymentContentItem {
+    key: string;
+    value: unknown;
+}
+/** Payment content is a list of groups, each group a list of key/value lines. */
+export type PaymentContent = PaymentContentItem[][];
+export interface CreateTransactionInput {
+    userId: string;
+    /** Amount in the smallest currency unit (e.g. 1300 = 13.00 TRY). */
+    amount: number;
+    currency?: string;
+    merchantCallback?: string;
+    transactionTimeoutMinutes?: number;
+    idempotencyId?: string;
+    paymentContent?: PaymentContent;
+}
+export interface PostAuthInput {
+    transactionId: string;
+    /** Final amount to settle, in the smallest currency unit. */
+    amount: number;
+    merchantCallback?: string;
+    idempotencyId?: string;
+}
+export interface StatusInput {
+    transactionId: string;
+    merchantCallback?: string;
+}
+export interface CancelInput {
+    transactionId: string;
+    userId: string;
+    cancellationMessage?: string;
+    merchantCallback?: string;
+    transactionTimeoutMinutes?: number;
+    idempotencyId?: string;
+}
+export interface RefundInput {
+    transactionId: string;
+    userId: string;
+    /** Amount to refund, in the smallest currency unit. */
+    amount: number;
+    currency?: string;
+    cancellationMessage?: string;
+    merchantCallback?: string;
+    transactionTimeoutMinutes?: number;
+    idempotencyId?: string;
+}
+export interface TransactionResult {
+    transactionId?: string;
+    operationId?: string;
+    status?: string;
+    message?: string;
+    /** Present on pre-auth: URL/handle to continue with post-auth. */
+    nextAction?: string;
+    transactionStatus?: string;
+    transactionMessage?: string;
+    gateway?: string;
+    [key: string]: unknown;
+}
+export type PaymentStatus = "new" | "processing" | "processing_3d_secure" | "processing_digital" | "finished" | "cancelled" | "closed" | "timeout" | "error" | "void" | "refund" | "unknown";
+/** Returns the strongly-typed status, preferring `transactionStatus` then `status`. */
+export declare function parsePaymentStatus(result: TransactionResult): PaymentStatus;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,kBAAkB,EAAE,EAAE,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,YAAY,GACZ,sBAAsB,GACtB,oBAAoB,GACpB,UAAU,GACV,WAAW,GACX,QAAQ,GACR,SAAS,GACT,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAO3E"}

package/dist/types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePaymentStatus = parsePaymentStatus;
+/** Returns the strongly-typed status, preferring `transactionStatus` then `status`. */
+function parsePaymentStatus(result) {
+    const known = [
+        "new", "processing", "processing_3d_secure", "processing_digital",
+        "finished", "cancelled", "closed", "timeout", "error", "void", "refund",
+    ];
+    const raw = (result.transactionStatus ?? result.status ?? "").toLowerCase();
+    return known.includes(raw) ? raw : "unknown";
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;AAkFA,gDAOC;AARD,uFAAuF;AACvF,SAAgB,kBAAkB,CAAC,MAAyB;IAC1D,MAAM,KAAK,GAAoB;QAC7B,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,oBAAoB;QACjE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ;KACxE,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5E,OAAQ,KAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@uveysservetoglu/kobil-payment",
+  "version": "1.0.0",
+  "description": "KOBIL Pay (mpay-merchant) client for Node.js: create/pre-auth/post-auth, status, cancel and refund transactions with automatic OAuth token management.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "kobil",
+    "payment",
+    "mpay",
+    "oauth2"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uveysservetoglu/kobil-sdks"
+  },
+  "dependencies": {
+    "@uveysservetoglu/kobil-core": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}