jiffoo-core-api-sdk 0.1.0

package/dist/cjs/errors.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreApiError = void 0;
+exports.isCoreApiError = isCoreApiError;
+class CoreApiError extends Error {
+    constructor(info) {
+        super(info.message);
+        this.name = 'CoreApiError';
+        this.status = info.status;
+        this.code = info.code;
+        this.details = info.details;
+        this.requestId = info.requestId ?? null;
+    }
+}
+exports.CoreApiError = CoreApiError;
+function isCoreApiError(error) {
+    return error instanceof CoreApiError;
+}

package/dist/cjs/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCoreOpenApiClient = exports.createCoreApiSdk = exports.isCoreApiError = exports.CoreApiError = void 0;
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "CoreApiError", { enumerable: true, get: function () { return errors_1.CoreApiError; } });
+Object.defineProperty(exports, "isCoreApiError", { enumerable: true, get: function () { return errors_1.isCoreApiError; } });
+var sdk_1 = require("./sdk");
+Object.defineProperty(exports, "createCoreApiSdk", { enumerable: true, get: function () { return sdk_1.createCoreApiSdk; } });
+var openapi_client_1 = require("./openapi-client");
+Object.defineProperty(exports, "createCoreOpenApiClient", { enumerable: true, get: function () { return openapi_client_1.createCoreOpenApiClient; } });

package/dist/cjs/openapi-client.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCoreOpenApiClient = createCoreOpenApiClient;
+const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
+async function resolveToken(token) {
+    if (typeof token === 'function')
+        return token();
+    return token;
+}
+async function resolveHeaders(headers) {
+    if (!headers)
+        return undefined;
+    if (typeof headers === 'function')
+        return headers();
+    return headers;
+}
+/**
+ * Typed OpenAPI client for Core API endpoints.
+ *
+ * This client is transport-only (returns raw `Response` semantics through openapi-fetch),
+ * while `createCoreApiSdk()` provides the envelope-unwrapping + error normalization layer.
+ */
+function createCoreOpenApiClient(options = {}) {
+    const baseUrl = options.baseUrl ?? '';
+    const fetchImpl = options.fetch ?? fetch;
+    const defaultCredentials = options.credentials ?? 'include';
+    return (0, openapi_fetch_1.default)({
+        baseUrl,
+        fetch: async (input, init = {}) => {
+            const mergedHeaders = new Headers(init.headers);
+            const extraHeaders = await resolveHeaders(options.headers);
+            if (extraHeaders) {
+                new Headers(extraHeaders).forEach((value, key) => mergedHeaders.set(key, value));
+            }
+            const token = await resolveToken(options.token);
+            if (token && !mergedHeaders.has('Authorization')) {
+                mergedHeaders.set('Authorization', `Bearer ${token}`);
+            }
+            return fetchImpl(input, {
+                ...init,
+                headers: mergedHeaders,
+                credentials: init.credentials ?? defaultCredentials,
+            });
+        },
+    });
+}

package/dist/cjs/openapi-types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/sdk.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCoreApiSdk = createCoreApiSdk;
+const errors_1 = require("./errors");
+const utils_1 = require("./utils");
+async function resolveToken(token) {
+    if (typeof token === 'function')
+        return token();
+    return token;
+}
+async function resolveHeaders(headers) {
+    if (!headers)
+        return undefined;
+    if (typeof headers === 'function')
+        return headers();
+    return headers;
+}
+function createCoreApiSdk(options = {}) {
+    const baseUrl = options.baseUrl ?? '';
+    const fetchImpl = options.fetch ?? fetch;
+    const credentials = options.credentials ?? 'include';
+    return {
+        async request(path, init = {}) {
+            const url = (0, utils_1.joinUrl)(baseUrl, path);
+            const mergedHeaders = new Headers(init.headers);
+            const extraHeaders = await resolveHeaders(options.headers);
+            if (extraHeaders) {
+                new Headers(extraHeaders).forEach((value, key) => mergedHeaders.set(key, value));
+            }
+            const token = await resolveToken(options.token);
+            if (token && !mergedHeaders.has('Authorization')) {
+                mergedHeaders.set('Authorization', `Bearer ${token}`);
+            }
+            const response = await fetchImpl(url, {
+                ...init,
+                headers: mergedHeaders,
+                credentials,
+            });
+            const requestId = (0, utils_1.getRequestId)(response.headers);
+            const contentType = response.headers.get('content-type');
+            if (!response.ok) {
+                if ((0, utils_1.isJsonContentType)(contentType)) {
+                    const json = (await response.json().catch(() => null));
+                    if (json?.success === false && json?.error?.code && json?.error?.message) {
+                        throw new errors_1.CoreApiError({
+                            status: response.status,
+                            code: json.error.code,
+                            message: json.error.message,
+                            details: json.error.details,
+                            requestId,
+                        });
+                    }
+                    throw new errors_1.CoreApiError({
+                        status: response.status,
+                        code: 'HTTP_ERROR',
+                        message: json?.message || json?.error || `HTTP ${response.status}`,
+                        details: json,
+                        requestId,
+                    });
+                }
+                const text = await response.text().catch(() => '');
+                throw new errors_1.CoreApiError({
+                    status: response.status,
+                    code: 'HTTP_ERROR',
+                    message: text || `HTTP ${response.status}`,
+                    details: text || undefined,
+                    requestId,
+                });
+            }
+            if (!(0, utils_1.isJsonContentType)(contentType)) {
+                // Some gateway endpoints intentionally return passthrough text/HTML/JS.
+                // We keep it as text to be safe.
+                return (await response.text());
+            }
+            const json = (await response.json());
+            if (json?.success === true)
+                return json.data;
+            if (json?.success === false && json?.error?.code) {
+                throw new errors_1.CoreApiError({
+                    status: response.status,
+                    code: json.error.code,
+                    message: json.error.message,
+                    details: json.error.details,
+                    requestId,
+                });
+            }
+            // If the endpoint returns raw JSON (non-envelope), return it directly.
+            return json;
+        },
+    };
+}

package/dist/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/utils.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinUrl = joinUrl;
+exports.isJsonContentType = isJsonContentType;
+exports.getRequestId = getRequestId;
+function joinUrl(baseUrl, path) {
+    if (!baseUrl)
+        return path;
+    if (!path)
+        return baseUrl;
+    const baseEndsWithSlash = baseUrl.endsWith('/');
+    const pathStartsWithSlash = path.startsWith('/');
+    if (baseEndsWithSlash && pathStartsWithSlash)
+        return `${baseUrl}${path.slice(1)}`;
+    if (!baseEndsWithSlash && !pathStartsWithSlash)
+        return `${baseUrl}/${path}`;
+    return `${baseUrl}${path}`;
+}
+function isJsonContentType(contentType) {
+    if (!contentType)
+        return false;
+    return contentType.includes('application/json') || contentType.includes('+json');
+}
+function getRequestId(headers) {
+    return headers.get('x-request-id') ?? headers.get('x-requestid');
+}

package/dist/esm/errors.js

@@ -0,0 +1,13 @@
+export class CoreApiError extends Error {
+    constructor(info) {
+        super(info.message);
+        this.name = 'CoreApiError';
+        this.status = info.status;
+        this.code = info.code;
+        this.details = info.details;
+        this.requestId = info.requestId ?? null;
+    }
+}
+export function isCoreApiError(error) {
+    return error instanceof CoreApiError;
+}

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export { CoreApiError, isCoreApiError, } from './errors';
+export { createCoreApiSdk, } from './sdk';
+export { createCoreOpenApiClient, } from './openapi-client';

package/dist/esm/openapi-client.js

@@ -0,0 +1,43 @@
+import createClient from 'openapi-fetch';
+async function resolveToken(token) {
+    if (typeof token === 'function')
+        return token();
+    return token;
+}
+async function resolveHeaders(headers) {
+    if (!headers)
+        return undefined;
+    if (typeof headers === 'function')
+        return headers();
+    return headers;
+}
+/**
+ * Typed OpenAPI client for Core API endpoints.
+ *
+ * This client is transport-only (returns raw `Response` semantics through openapi-fetch),
+ * while `createCoreApiSdk()` provides the envelope-unwrapping + error normalization layer.
+ */
+export function createCoreOpenApiClient(options = {}) {
+    const baseUrl = options.baseUrl ?? '';
+    const fetchImpl = options.fetch ?? fetch;
+    const defaultCredentials = options.credentials ?? 'include';
+    return createClient({
+        baseUrl,
+        fetch: async (input, init = {}) => {
+            const mergedHeaders = new Headers(init.headers);
+            const extraHeaders = await resolveHeaders(options.headers);
+            if (extraHeaders) {
+                new Headers(extraHeaders).forEach((value, key) => mergedHeaders.set(key, value));
+            }
+            const token = await resolveToken(options.token);
+            if (token && !mergedHeaders.has('Authorization')) {
+                mergedHeaders.set('Authorization', `Bearer ${token}`);
+            }
+            return fetchImpl(input, {
+                ...init,
+                headers: mergedHeaders,
+                credentials: init.credentials ?? defaultCredentials,
+            });
+        },
+    });
+}

package/dist/esm/openapi-types.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/dist/esm/sdk.js

@@ -0,0 +1,88 @@
+import { CoreApiError } from './errors';
+import { getRequestId, isJsonContentType, joinUrl } from './utils';
+async function resolveToken(token) {
+    if (typeof token === 'function')
+        return token();
+    return token;
+}
+async function resolveHeaders(headers) {
+    if (!headers)
+        return undefined;
+    if (typeof headers === 'function')
+        return headers();
+    return headers;
+}
+export function createCoreApiSdk(options = {}) {
+    const baseUrl = options.baseUrl ?? '';
+    const fetchImpl = options.fetch ?? fetch;
+    const credentials = options.credentials ?? 'include';
+    return {
+        async request(path, init = {}) {
+            const url = joinUrl(baseUrl, path);
+            const mergedHeaders = new Headers(init.headers);
+            const extraHeaders = await resolveHeaders(options.headers);
+            if (extraHeaders) {
+                new Headers(extraHeaders).forEach((value, key) => mergedHeaders.set(key, value));
+            }
+            const token = await resolveToken(options.token);
+            if (token && !mergedHeaders.has('Authorization')) {
+                mergedHeaders.set('Authorization', `Bearer ${token}`);
+            }
+            const response = await fetchImpl(url, {
+                ...init,
+                headers: mergedHeaders,
+                credentials,
+            });
+            const requestId = getRequestId(response.headers);
+            const contentType = response.headers.get('content-type');
+            if (!response.ok) {
+                if (isJsonContentType(contentType)) {
+                    const json = (await response.json().catch(() => null));
+                    if (json?.success === false && json?.error?.code && json?.error?.message) {
+                        throw new CoreApiError({
+                            status: response.status,
+                            code: json.error.code,
+                            message: json.error.message,
+                            details: json.error.details,
+                            requestId,
+                        });
+                    }
+                    throw new CoreApiError({
+                        status: response.status,
+                        code: 'HTTP_ERROR',
+                        message: json?.message || json?.error || `HTTP ${response.status}`,
+                        details: json,
+                        requestId,
+                    });
+                }
+                const text = await response.text().catch(() => '');
+                throw new CoreApiError({
+                    status: response.status,
+                    code: 'HTTP_ERROR',
+                    message: text || `HTTP ${response.status}`,
+                    details: text || undefined,
+                    requestId,
+                });
+            }
+            if (!isJsonContentType(contentType)) {
+                // Some gateway endpoints intentionally return passthrough text/HTML/JS.
+                // We keep it as text to be safe.
+                return (await response.text());
+            }
+            const json = (await response.json());
+            if (json?.success === true)
+                return json.data;
+            if (json?.success === false && json?.error?.code) {
+                throw new CoreApiError({
+                    status: response.status,
+                    code: json.error.code,
+                    message: json.error.message,
+                    details: json.error.details,
+                    requestId,
+                });
+            }
+            // If the endpoint returns raw JSON (non-envelope), return it directly.
+            return json;
+        },
+    };
+}

package/dist/esm/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/utils.js

@@ -0,0 +1,21 @@
+export function joinUrl(baseUrl, path) {
+    if (!baseUrl)
+        return path;
+    if (!path)
+        return baseUrl;
+    const baseEndsWithSlash = baseUrl.endsWith('/');
+    const pathStartsWithSlash = path.startsWith('/');
+    if (baseEndsWithSlash && pathStartsWithSlash)
+        return `${baseUrl}${path.slice(1)}`;
+    if (!baseEndsWithSlash && !pathStartsWithSlash)
+        return `${baseUrl}/${path}`;
+    return `${baseUrl}${path}`;
+}
+export function isJsonContentType(contentType) {
+    if (!contentType)
+        return false;
+    return contentType.includes('application/json') || contentType.includes('+json');
+}
+export function getRequestId(headers) {
+    return headers.get('x-request-id') ?? headers.get('x-requestid');
+}

package/dist/types/errors.d.ts

@@ -0,0 +1,16 @@
+export type CoreApiErrorInfo = {
+    status: number;
+    code: string;
+    message: string;
+    details?: unknown;
+    requestId?: string | null;
+};
+export declare class CoreApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: unknown;
+    readonly requestId?: string | null;
+    constructor(info: CoreApiErrorInfo);
+}
+export declare function isCoreApiError(error: unknown): error is CoreApiError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEvB,IAAI,EAAE,gBAAgB;CAQnC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export { CoreApiError, isCoreApiError, type CoreApiErrorInfo, } from './errors';
+export type { CoreApiErrorEnvelope, CoreApiSuccessEnvelope, CoreApiEnvelope, } from './types';
+export { createCoreApiSdk, type CoreApiSdk, type CoreApiSdkOptions, type CoreApiTokenProvider, } from './sdk';
+export { createCoreOpenApiClient, type CoreOpenApiClientOptions, } from './openapi-client';
+export type { paths, components, operations } from './openapi-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/openapi-client.d.ts

@@ -0,0 +1,11 @@
+import type { paths } from './openapi-types';
+import type { CoreApiSdkOptions } from './sdk';
+export type CoreOpenApiClientOptions = CoreApiSdkOptions;
+/**
+ * Typed OpenAPI client for Core API endpoints.
+ *
+ * This client is transport-only (returns raw `Response` semantics through openapi-fetch),
+ * while `createCoreApiSdk()` provides the envelope-unwrapping + error normalization layer.
+ */
+export declare function createCoreOpenApiClient(options?: CoreOpenApiClientOptions): import("openapi-fetch").Client<paths, `${string}/${string}`>;
+//# sourceMappingURL=openapi-client.d.ts.map

package/dist/types/openapi-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-client.d.ts","sourceRoot":"","sources":["../../src/openapi-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,OAAO,CAAC;AAErE,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAezD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,gEA0B7E"}