@uveysservetoglu/kobil-core 1.0.0

package/README.md

@@ -0,0 +1,21 @@
+# @uveysservetoglu/kobil-core
+
+Shared foundation for the KOBIL SDK family (`@uveysservetoglu/kobil-payment`, `@uveysservetoglu/kobil-chat`, `@uveysservetoglu/kobil-sign`, …).
+
+You normally don't use this directly — the module packages depend on it. It provides:
+
+- **`DefaultTokenProvider`** — OAuth2 `client_credentials` token acquisition with in-memory
+  caching (single in-flight request, honours `expires_in`). Modes: `post` (form body,
+  default) or `basic` (HTTP Basic header).
+- **`KobilError`** — base error all module errors extend (`statusCode`, `responseBody`).
+- **`KobilServiceClient`** — HTTP base for typed clients (bearer + send + error wrapping,
+  JSON / arbitrary-body / binary-download helpers).
+- **`credentialsFromEnv`** — reads `KOBIL_TOKEN_ENDPOINT`, `KOBIL_CLIENT_ID`,
+  `KOBIL_CLIENT_SECRET`, `KOBIL_TOKEN_AUTH_MODE`.
+
+Works from both TypeScript and JavaScript (ships compiled JS + `.d.ts`). Requires Node 18+
+(global `fetch`).
+
+## License
+
+MIT

package/dist/credentials.d.ts

@@ -0,0 +1,23 @@
+/** How client credentials are presented to the OAuth2 token endpoint. */
+export type TokenAuthMode = "post" | "basic";
+/**
+ * OAuth2 credentials shared by every KOBIL SDK module. The token endpoint and
+ * client credentials are the same across modules, so configure them once.
+ */
+export interface KobilCredentials {
+    tokenEndpoint: string;
+    clientId: string;
+    clientSecret: string;
+    /** How credentials are sent to the token endpoint. Default: "post". */
+    tokenAuthMode?: TokenAuthMode;
+    /** Token cache lifetime (seconds) when the endpoint returns no `expires_in`. Default: 280. */
+    defaultTokenTtlSeconds?: number;
+    /** Safety margin (seconds) subtracted from token lifetime before refresh. Default: 20. */
+    tokenExpirySkewSeconds?: number;
+}
+/**
+ * Builds credentials from `KOBIL_*` environment variables, with optional overrides
+ * (undefined/empty override values are ignored so env still wins for those).
+ */
+export declare function credentialsFromEnv(overrides?: Partial<KobilCredentials>): KobilCredentials;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,8FAA8F;IAC9F,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0FAA0F;IAC1F,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CAc9F"}

package/dist/credentials.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.credentialsFromEnv = credentialsFromEnv;
+/**
+ * Builds credentials from `KOBIL_*` environment variables, with optional overrides
+ * (undefined/empty override values are ignored so env still wins for those).
+ */
+function credentialsFromEnv(overrides = {}) {
+    const mode = process.env.KOBIL_TOKEN_AUTH_MODE?.toLowerCase();
+    const base = {
+        tokenEndpoint: process.env.KOBIL_TOKEN_ENDPOINT ?? "",
+        clientId: process.env.KOBIL_CLIENT_ID ?? "",
+        clientSecret: process.env.KOBIL_CLIENT_SECRET ?? "",
+        tokenAuthMode: mode === "basic" || mode === "client_secret_basic" ? "basic" : "post",
+    };
+    for (const [key, value] of Object.entries(overrides)) {
+        if (value !== undefined && value !== "") {
+            base[key] = value;
+        }
+    }
+    return base;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":";;AAuBA,gDAcC;AAlBD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,YAAuC,EAAE;IAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,WAAW,EAAE,CAAC;IAC9D,MAAM,IAAI,GAAqB;QAC7B,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE;QACrD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;QAC3C,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE;QACnD,aAAa,EAAE,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;KACrF,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAwC,EAAE,CAAC;QAC5F,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACvC,IAA2C,CAAC,GAAa,CAAC,GAAG,KAAK,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,16 @@
+export interface KobilErrorOptions {
+    statusCode?: number;
+    responseBody?: string;
+    cause?: unknown;
+}
+/**
+ * Base error for all KOBIL SDK modules. Module-specific errors
+ * (KobilPaymentError, KobilChatError, …) extend this, so callers can catch
+ * `KobilError` to handle any KOBIL failure uniformly.
+ */
+export declare class KobilError extends Error {
+    readonly statusCode?: number;
+    readonly responseBody?: string;
+    constructor(message: string, options?: KobilErrorOptions);
+}
+//# 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,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;CAO7D"}

package/dist/error.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KobilError = void 0;
+/**
+ * Base error for all KOBIL SDK modules. Module-specific errors
+ * (KobilPaymentError, KobilChatError, …) extend this, so callers can catch
+ * `KobilError` to handle any KOBIL failure uniformly.
+ */
+class KobilError extends Error {
+    statusCode;
+    responseBody;
+    constructor(message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = new.target.name;
+        this.statusCode = options.statusCode;
+        this.responseBody = options.responseBody;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.KobilError = KobilError;
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":";;;AAMA;;;;GAIG;AACH,MAAa,UAAW,SAAQ,KAAK;IAC1B,UAAU,CAAU;IACpB,YAAY,CAAU;IAE/B,YAAY,OAAe,EAAE,UAA6B,EAAE;QAC1D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAXD,gCAWC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { KobilError } from "./error";
+export type { KobilErrorOptions } from "./error";
+export { credentialsFromEnv } from "./credentials";
+export type { KobilCredentials, TokenAuthMode } from "./credentials";
+export { DefaultTokenProvider } from "./token-provider";
+export type { TokenProvider } from "./token-provider";
+export { KobilServiceClient } from "./service-client";
+//# 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,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KobilServiceClient = exports.DefaultTokenProvider = exports.credentialsFromEnv = exports.KobilError = void 0;
+var error_1 = require("./error");
+Object.defineProperty(exports, "KobilError", { enumerable: true, get: function () { return error_1.KobilError; } });
+var credentials_1 = require("./credentials");
+Object.defineProperty(exports, "credentialsFromEnv", { enumerable: true, get: function () { return credentials_1.credentialsFromEnv; } });
+var token_provider_1 = require("./token-provider");
+Object.defineProperty(exports, "DefaultTokenProvider", { enumerable: true, get: function () { return token_provider_1.DefaultTokenProvider; } });
+var service_client_1 = require("./service-client");
+Object.defineProperty(exports, "KobilServiceClient", { enumerable: true, get: function () { return service_client_1.KobilServiceClient; } });
+//# 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,iCAAqC;AAA5B,mGAAA,UAAU,OAAA;AAEnB,6CAAmD;AAA1C,iHAAA,kBAAkB,OAAA;AAE3B,mDAAwD;AAA/C,sHAAA,oBAAoB,OAAA;AAE7B,mDAAsD;AAA7C,oHAAA,kBAAkB,OAAA"}

package/dist/service-client.d.ts

@@ -0,0 +1,21 @@
+import { KobilError } from "./error";
+import { TokenProvider } from "./token-provider";
+/**
+ * Base class for typed KOBIL service clients. Attaches the shared bearer token,
+ * sends the request, and turns non-2xx/transport failures into an error (override
+ * {@link makeError} to produce a module-specific error type).
+ */
+export declare abstract class KobilServiceClient {
+    protected readonly tokens: TokenProvider;
+    protected constructor(tokens: TokenProvider);
+    /** Override to wrap failures in a module-specific error type. */
+    protected makeError(message: string, statusCode?: number, responseBody?: string, cause?: unknown): KobilError;
+    /** Sends a request with a JSON body (or none) and parses the JSON response. */
+    protected sendJson<T>(method: string, url: string, body?: unknown, signal?: AbortSignal): Promise<T>;
+    /** Sends a request with an arbitrary body (e.g. FormData) and parses the JSON response. */
+    protected send<T>(method: string, url: string, body: string | FormData, signal?: AbortSignal): Promise<T>;
+    /** Sends a request and returns the raw response bytes (e.g. a file download). */
+    protected sendForBytes(method: string, url: string, signal?: AbortSignal): Promise<Uint8Array>;
+    private request;
+}
+//# sourceMappingURL=service-client.d.ts.map

package/dist/service-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-client.d.ts","sourceRoot":"","sources":["../src/service-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;GAIG;AACH,8BAAsB,kBAAkB;IAChB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa;IAA9D,SAAS,aAAgC,MAAM,EAAE,aAAa;IAE9D,iEAAiE;IACjE,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU;IAI7G,+EAA+E;IAC/E,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAUpG,2FAA2F;IAC3F,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzG,iFAAiF;cACjE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;YAetF,OAAO;CAiCtB"}

package/dist/service-client.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KobilServiceClient = void 0;
+const error_1 = require("./error");
+/**
+ * Base class for typed KOBIL service clients. Attaches the shared bearer token,
+ * sends the request, and turns non-2xx/transport failures into an error (override
+ * {@link makeError} to produce a module-specific error type).
+ */
+class KobilServiceClient {
+    tokens;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    /** Override to wrap failures in a module-specific error type. */
+    makeError(message, statusCode, responseBody, cause) {
+        return new error_1.KobilError(message, { statusCode, responseBody, cause });
+    }
+    /** Sends a request with a JSON body (or none) and parses the JSON response. */
+    sendJson(method, url, body, signal) {
+        const headers = { accept: "application/json" };
+        let payload;
+        if (body !== undefined && body !== null) {
+            headers["content-type"] = "application/json";
+            payload = JSON.stringify(body);
+        }
+        return this.request(method, url, headers, payload, signal);
+    }
+    /** Sends a request with an arbitrary body (e.g. FormData) and parses the JSON response. */
+    send(method, url, body, signal) {
+        return this.request(method, url, { accept: "application/json" }, body, signal);
+    }
+    /** Sends a request and returns the raw response bytes (e.g. a file download). */
+    async sendForBytes(method, url, signal) {
+        const token = await this.tokens.getToken(signal);
+        let response;
+        try {
+            response = await fetch(url, { method, headers: { authorization: `Bearer ${token}` }, signal });
+        }
+        catch (cause) {
+            throw this.makeError(`An error occurred while calling ${method} ${url}.`, undefined, undefined, cause);
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => undefined);
+            throw this.makeError(`KOBIL API returned ${response.status} for ${method} ${url}.`, response.status, text);
+        }
+        return new Uint8Array(await response.arrayBuffer());
+    }
+    async request(method, url, headers, body, signal) {
+        const token = await this.tokens.getToken(signal);
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers: { ...headers, authorization: `Bearer ${token}` },
+                body,
+                signal,
+            });
+        }
+        catch (cause) {
+            throw this.makeError(`An error occurred while calling ${method} ${url}.`, undefined, undefined, cause);
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            throw this.makeError(`KOBIL API returned ${response.status} for ${method} ${url}.`, response.status, text);
+        }
+        if (!text) {
+            return {};
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (cause) {
+            throw this.makeError(`Failed to parse response from ${method} ${url}.`, response.status, text, cause);
+        }
+    }
+}
+exports.KobilServiceClient = KobilServiceClient;
+//# sourceMappingURL=service-client.js.map

package/dist/service-client.js.map

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

package/dist/token-provider.d.ts

@@ -0,0 +1,19 @@
+import { KobilCredentials } from "./credentials";
+/** Provides (and caches) OAuth2 access tokens shared across KOBIL SDK modules. */
+export interface TokenProvider {
+    getToken(signal?: AbortSignal): Promise<string>;
+}
+/**
+ * Acquires OAuth2 tokens via the `client_credentials` grant — using either the form
+ * body (`post`) or an HTTP Basic header (`basic`) — and caches them in memory until
+ * shortly before they expire. A single in-flight request is shared to avoid stampedes.
+ */
+export declare class DefaultTokenProvider implements TokenProvider {
+    private readonly credentials;
+    private cache?;
+    private inflight?;
+    constructor(credentials: KobilCredentials);
+    getToken(signal?: AbortSignal): Promise<string>;
+    private request;
+}
+//# sourceMappingURL=token-provider.d.ts.map

package/dist/token-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-provider.d.ts","sourceRoot":"","sources":["../src/token-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAOD;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IAI5C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAHxC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAkB;gBAEN,WAAW,EAAE,gBAAgB;IAEpD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YAavC,OAAO;CAqDtB"}

package/dist/token-provider.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultTokenProvider = void 0;
+const error_1 = require("./error");
+/**
+ * Acquires OAuth2 tokens via the `client_credentials` grant — using either the form
+ * body (`post`) or an HTTP Basic header (`basic`) — and caches them in memory until
+ * shortly before they expire. A single in-flight request is shared to avoid stampedes.
+ */
+class DefaultTokenProvider {
+    credentials;
+    cache;
+    inflight;
+    constructor(credentials) {
+        this.credentials = credentials;
+    }
+    async getToken(signal) {
+        if (this.cache && this.cache.expiresAt > Date.now()) {
+            return this.cache.token;
+        }
+        if (this.inflight) {
+            return this.inflight;
+        }
+        this.inflight = this.request(signal).finally(() => {
+            this.inflight = undefined;
+        });
+        return this.inflight;
+    }
+    async request(signal) {
+        const c = this.credentials;
+        if (!c.tokenEndpoint)
+            throw new error_1.KobilError("credentials.tokenEndpoint is required.");
+        if (!c.clientId)
+            throw new error_1.KobilError("credentials.clientId is required.");
+        if (!c.clientSecret)
+            throw new error_1.KobilError("credentials.clientSecret is required.");
+        const body = new URLSearchParams({ grant_type: "client_credentials" });
+        const headers = {
+            "content-type": "application/x-www-form-urlencoded",
+        };
+        if ((c.tokenAuthMode ?? "post") === "basic") {
+            const basic = Buffer.from(`${c.clientId}:${c.clientSecret}`).toString("base64");
+            headers["authorization"] = `Basic ${basic}`;
+        }
+        else {
+            body.set("client_id", c.clientId);
+            body.set("client_secret", c.clientSecret);
+        }
+        let response;
+        try {
+            response = await fetch(c.tokenEndpoint, { method: "POST", headers, body, signal });
+        }
+        catch (cause) {
+            throw new error_1.KobilError("An error occurred while acquiring an access token.", { cause });
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            throw new error_1.KobilError(`Token endpoint returned ${response.status}.`, {
+                statusCode: response.status,
+                responseBody: text,
+            });
+        }
+        let json;
+        try {
+            json = JSON.parse(text);
+        }
+        catch (cause) {
+            throw new error_1.KobilError("Token endpoint returned invalid JSON.", { cause, responseBody: text });
+        }
+        const token = json.access_token;
+        if (!token) {
+            throw new error_1.KobilError("Token endpoint response did not contain an access_token.", {
+                responseBody: text,
+            });
+        }
+        const ttlSeconds = (json.expires_in ?? c.defaultTokenTtlSeconds ?? 280) - (c.tokenExpirySkewSeconds ?? 20);
+        this.cache = { token, expiresAt: Date.now() + Math.max(1, ttlSeconds) * 1000 };
+        return token;
+    }
+}
+exports.DefaultTokenProvider = DefaultTokenProvider;
+//# sourceMappingURL=token-provider.js.map

package/dist/token-provider.js.map

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

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@uveysservetoglu/kobil-core",
+  "version": "1.0.0",
+  "description": "Shared foundation for the KOBIL SDK family: OAuth token acquisition/caching (post & basic), a common error type, and an HTTP base for typed clients.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "kobil",
+    "sdk",
+    "oauth2",
+    "core"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uveysservetoglu/kobil-sdks"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}