jiffoo-theme-api-sdk 0.1.0

package/dist/cjs/auth.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBrowserTokenProvider = createBrowserTokenProvider;
+function getCookie(name) {
+    if (typeof document === 'undefined')
+        return null;
+    const value = `; ${document.cookie}`;
+    const parts = value.split(`; ${name}=`);
+    if (parts.length === 2)
+        return parts.pop()?.split(';').shift() || null;
+    return null;
+}
+/**
+ * Browser token provider for theme apps.
+ * Priority: localStorage -> cookie
+ */
+function createBrowserTokenProvider(key = 'auth_token') {
+    return () => {
+        if (typeof window === 'undefined')
+            return null;
+        const local = window.localStorage.getItem(key);
+        if (local)
+            return local;
+        return getCookie(key);
+    };
+}

package/dist/cjs/client.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createThemeApiClient = createThemeApiClient;
+const jiffoo_core_api_sdk_1 = require("jiffoo-core-api-sdk");
+const utils_1 = require("./utils");
+function toCoreTokenProvider(token) {
+    return token;
+}
+function buildRequestInit(options) {
+    const method = options?.method || 'GET';
+    const headers = new Headers(options?.headers);
+    const init = { method, headers };
+    if (options?.body !== undefined) {
+        if ((0, utils_1.shouldUseJsonBody)(options.body)) {
+            if (!headers.has('Content-Type')) {
+                headers.set('Content-Type', 'application/json');
+            }
+            init.body = JSON.stringify(options.body);
+        }
+        else {
+            init.body = options.body;
+        }
+    }
+    return init;
+}
+function createThemeApiClient(options = {}) {
+    const apiPrefix = (0, utils_1.normalizePrefix)(options.apiPrefix ?? '/api');
+    const sdk = (0, jiffoo_core_api_sdk_1.createCoreApiSdk)({
+        baseUrl: options.baseUrl ?? '',
+        token: toCoreTokenProvider(options.token),
+        credentials: options.credentials ?? 'include',
+        fetch: options.fetch,
+        headers: options.headers,
+    });
+    const openapi = (0, jiffoo_core_api_sdk_1.createCoreOpenApiClient)({
+        baseUrl: options.baseUrl ?? '',
+        token: toCoreTokenProvider(options.token),
+        credentials: options.credentials ?? 'include',
+        fetch: options.fetch,
+        headers: options.headers,
+    });
+    async function request(path, optionsIn) {
+        const resolvedPath = (0, utils_1.resolveApiPath)(apiPrefix, path);
+        const pathWithQuery = (0, utils_1.buildPathWithQuery)(resolvedPath, optionsIn?.query);
+        return sdk.request(pathWithQuery, buildRequestInit(optionsIn));
+    }
+    return {
+        request,
+        openapi,
+        auth: {
+            login: (payload) => request('/auth/login', { method: 'POST', body: payload }),
+            register: (payload) => request('/auth/register', { method: 'POST', body: payload }),
+            me: () => request('/auth/me'),
+            refresh: (payload) => request('/auth/refresh', { method: 'POST', body: payload }),
+            logout: () => request('/auth/logout', { method: 'POST' }),
+            changePassword: (payload) => request('/auth/change-password', { method: 'POST', body: payload }),
+        },
+        account: {
+            getProfile: () => request('/account/profile'),
+            updateProfile: (payload) => request('/account/profile', { method: 'PUT', body: payload }),
+            uploadAvatar: (formData) => request('/account/avatar', { method: 'POST', body: formData }),
+        },
+        products: {
+            list: (query) => request('/products', { query }),
+            detail: (id, query) => request(`/products/${id}`, { query }),
+            categories: (query) => request('/products/categories', { query }),
+            search: (query) => request('/products/search', { query }),
+        },
+        cart: {
+            get: () => request('/cart'),
+            add: (payload) => request('/cart/items', { method: 'POST', body: payload }),
+            updateItem: (itemId, payload) => request(`/cart/items/${itemId}`, { method: 'PUT', body: payload }),
+            removeItem: (itemId) => request(`/cart/items/${itemId}`, { method: 'DELETE' }),
+            clear: () => request('/cart', { method: 'DELETE' }),
+        },
+        orders: {
+            list: (query) => request('/orders', { query }),
+            detail: (id) => request(`/orders/${id}`),
+            create: (payload) => request('/orders', { method: 'POST', body: payload }),
+            cancel: (id, payload) => request(`/orders/${id}/cancel`, { method: 'POST', body: payload }),
+        },
+        payments: {
+            availableMethods: () => request('/payments/available-methods'),
+            createSession: (payload) => request('/payments/create-session', { method: 'POST', body: payload }),
+            verifySession: (sessionId) => request(`/payments/verify/${sessionId}`),
+        },
+        store: {
+            context: (query) => request('/store/context', { query }),
+        },
+        themes: {
+            active: (query) => request('/themes/active', { query }),
+            installed: (query) => request('/themes/installed', { query }),
+        },
+        plugins: {
+            invoke: (slug, pluginPath, optionsInvoke) => {
+                const safePath = pluginPath.startsWith('/') ? pluginPath : `/${pluginPath}`;
+                const path = `/extensions/plugin/${slug}/api${safePath}`;
+                const query = {
+                    ...(optionsInvoke?.query || {}),
+                    ...(optionsInvoke?.installation ? { installation: optionsInvoke.installation } : {}),
+                    ...(optionsInvoke?.installationId ? { installationId: optionsInvoke.installationId } : {}),
+                };
+                return request(path, {
+                    method: optionsInvoke?.method || 'GET',
+                    query,
+                    body: optionsInvoke?.body,
+                    headers: optionsInvoke?.headers,
+                });
+            },
+        },
+    };
+}

package/dist/cjs/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBrowserTokenProvider = exports.createThemeApiClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "createThemeApiClient", { enumerable: true, get: function () { return client_1.createThemeApiClient; } });
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "createBrowserTokenProvider", { enumerable: true, get: function () { return auth_1.createBrowserTokenProvider; } });

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,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePath = normalizePath;
+exports.normalizePrefix = normalizePrefix;
+exports.buildPathWithQuery = buildPathWithQuery;
+exports.resolveApiPath = resolveApiPath;
+exports.shouldUseJsonBody = shouldUseJsonBody;
+function normalizePath(path) {
+    if (!path)
+        return '/';
+    return path.startsWith('/') ? path : `/${path}`;
+}
+function normalizePrefix(prefix) {
+    if (!prefix)
+        return '';
+    const withLeading = prefix.startsWith('/') ? prefix : `/${prefix}`;
+    return withLeading.endsWith('/') ? withLeading.slice(0, -1) : withLeading;
+}
+function buildPathWithQuery(path, query) {
+    if (!query || Object.keys(query).length === 0)
+        return path;
+    const params = new URLSearchParams();
+    for (const [key, raw] of Object.entries(query)) {
+        if (raw === undefined || raw === null)
+            continue;
+        if (Array.isArray(raw)) {
+            for (const item of raw) {
+                if (item !== undefined && item !== null)
+                    params.append(key, String(item));
+            }
+            continue;
+        }
+        params.append(key, String(raw));
+    }
+    const queryString = params.toString();
+    if (!queryString)
+        return path;
+    return `${path}${path.includes('?') ? '&' : '?'}${queryString}`;
+}
+function resolveApiPath(apiPrefix, path) {
+    if (/^https?:\/\//.test(path))
+        return path;
+    const normalizedPath = normalizePath(path);
+    if (!apiPrefix)
+        return normalizedPath;
+    if (normalizedPath.startsWith(`${apiPrefix}/`) || normalizedPath === apiPrefix) {
+        return normalizedPath;
+    }
+    return `${apiPrefix}${normalizedPath}`;
+}
+function shouldUseJsonBody(body) {
+    if (body === undefined || body === null)
+        return false;
+    if (typeof FormData !== 'undefined' && body instanceof FormData)
+        return false;
+    if (typeof URLSearchParams !== 'undefined' && body instanceof URLSearchParams)
+        return false;
+    return true;
+}

package/dist/esm/auth.js

@@ -0,0 +1,23 @@
+function getCookie(name) {
+    if (typeof document === 'undefined')
+        return null;
+    const value = `; ${document.cookie}`;
+    const parts = value.split(`; ${name}=`);
+    if (parts.length === 2)
+        return parts.pop()?.split(';').shift() || null;
+    return null;
+}
+/**
+ * Browser token provider for theme apps.
+ * Priority: localStorage -> cookie
+ */
+export function createBrowserTokenProvider(key = 'auth_token') {
+    return () => {
+        if (typeof window === 'undefined')
+            return null;
+        const local = window.localStorage.getItem(key);
+        if (local)
+            return local;
+        return getCookie(key);
+    };
+}

package/dist/esm/client.js

@@ -0,0 +1,109 @@
+import { createCoreApiSdk, createCoreOpenApiClient, } from 'jiffoo-core-api-sdk';
+import { buildPathWithQuery, normalizePrefix, resolveApiPath, shouldUseJsonBody } from './utils';
+function toCoreTokenProvider(token) {
+    return token;
+}
+function buildRequestInit(options) {
+    const method = options?.method || 'GET';
+    const headers = new Headers(options?.headers);
+    const init = { method, headers };
+    if (options?.body !== undefined) {
+        if (shouldUseJsonBody(options.body)) {
+            if (!headers.has('Content-Type')) {
+                headers.set('Content-Type', 'application/json');
+            }
+            init.body = JSON.stringify(options.body);
+        }
+        else {
+            init.body = options.body;
+        }
+    }
+    return init;
+}
+export function createThemeApiClient(options = {}) {
+    const apiPrefix = normalizePrefix(options.apiPrefix ?? '/api');
+    const sdk = createCoreApiSdk({
+        baseUrl: options.baseUrl ?? '',
+        token: toCoreTokenProvider(options.token),
+        credentials: options.credentials ?? 'include',
+        fetch: options.fetch,
+        headers: options.headers,
+    });
+    const openapi = createCoreOpenApiClient({
+        baseUrl: options.baseUrl ?? '',
+        token: toCoreTokenProvider(options.token),
+        credentials: options.credentials ?? 'include',
+        fetch: options.fetch,
+        headers: options.headers,
+    });
+    async function request(path, optionsIn) {
+        const resolvedPath = resolveApiPath(apiPrefix, path);
+        const pathWithQuery = buildPathWithQuery(resolvedPath, optionsIn?.query);
+        return sdk.request(pathWithQuery, buildRequestInit(optionsIn));
+    }
+    return {
+        request,
+        openapi,
+        auth: {
+            login: (payload) => request('/auth/login', { method: 'POST', body: payload }),
+            register: (payload) => request('/auth/register', { method: 'POST', body: payload }),
+            me: () => request('/auth/me'),
+            refresh: (payload) => request('/auth/refresh', { method: 'POST', body: payload }),
+            logout: () => request('/auth/logout', { method: 'POST' }),
+            changePassword: (payload) => request('/auth/change-password', { method: 'POST', body: payload }),
+        },
+        account: {
+            getProfile: () => request('/account/profile'),
+            updateProfile: (payload) => request('/account/profile', { method: 'PUT', body: payload }),
+            uploadAvatar: (formData) => request('/account/avatar', { method: 'POST', body: formData }),
+        },
+        products: {
+            list: (query) => request('/products', { query }),
+            detail: (id, query) => request(`/products/${id}`, { query }),
+            categories: (query) => request('/products/categories', { query }),
+            search: (query) => request('/products/search', { query }),
+        },
+        cart: {
+            get: () => request('/cart'),
+            add: (payload) => request('/cart/items', { method: 'POST', body: payload }),
+            updateItem: (itemId, payload) => request(`/cart/items/${itemId}`, { method: 'PUT', body: payload }),
+            removeItem: (itemId) => request(`/cart/items/${itemId}`, { method: 'DELETE' }),
+            clear: () => request('/cart', { method: 'DELETE' }),
+        },
+        orders: {
+            list: (query) => request('/orders', { query }),
+            detail: (id) => request(`/orders/${id}`),
+            create: (payload) => request('/orders', { method: 'POST', body: payload }),
+            cancel: (id, payload) => request(`/orders/${id}/cancel`, { method: 'POST', body: payload }),
+        },
+        payments: {
+            availableMethods: () => request('/payments/available-methods'),
+            createSession: (payload) => request('/payments/create-session', { method: 'POST', body: payload }),
+            verifySession: (sessionId) => request(`/payments/verify/${sessionId}`),
+        },
+        store: {
+            context: (query) => request('/store/context', { query }),
+        },
+        themes: {
+            active: (query) => request('/themes/active', { query }),
+            installed: (query) => request('/themes/installed', { query }),
+        },
+        plugins: {
+            invoke: (slug, pluginPath, optionsInvoke) => {
+                const safePath = pluginPath.startsWith('/') ? pluginPath : `/${pluginPath}`;
+                const path = `/extensions/plugin/${slug}/api${safePath}`;
+                const query = {
+                    ...(optionsInvoke?.query || {}),
+                    ...(optionsInvoke?.installation ? { installation: optionsInvoke.installation } : {}),
+                    ...(optionsInvoke?.installationId ? { installationId: optionsInvoke.installationId } : {}),
+                };
+                return request(path, {
+                    method: optionsInvoke?.method || 'GET',
+                    query,
+                    body: optionsInvoke?.body,
+                    headers: optionsInvoke?.headers,
+                });
+            },
+        },
+    };
+}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { createThemeApiClient } from './client';
+export { createBrowserTokenProvider } from './auth';

package/dist/esm/types.js

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

package/dist/esm/utils.js

@@ -0,0 +1,52 @@
+export function normalizePath(path) {
+    if (!path)
+        return '/';
+    return path.startsWith('/') ? path : `/${path}`;
+}
+export function normalizePrefix(prefix) {
+    if (!prefix)
+        return '';
+    const withLeading = prefix.startsWith('/') ? prefix : `/${prefix}`;
+    return withLeading.endsWith('/') ? withLeading.slice(0, -1) : withLeading;
+}
+export function buildPathWithQuery(path, query) {
+    if (!query || Object.keys(query).length === 0)
+        return path;
+    const params = new URLSearchParams();
+    for (const [key, raw] of Object.entries(query)) {
+        if (raw === undefined || raw === null)
+            continue;
+        if (Array.isArray(raw)) {
+            for (const item of raw) {
+                if (item !== undefined && item !== null)
+                    params.append(key, String(item));
+            }
+            continue;
+        }
+        params.append(key, String(raw));
+    }
+    const queryString = params.toString();
+    if (!queryString)
+        return path;
+    return `${path}${path.includes('?') ? '&' : '?'}${queryString}`;
+}
+export function resolveApiPath(apiPrefix, path) {
+    if (/^https?:\/\//.test(path))
+        return path;
+    const normalizedPath = normalizePath(path);
+    if (!apiPrefix)
+        return normalizedPath;
+    if (normalizedPath.startsWith(`${apiPrefix}/`) || normalizedPath === apiPrefix) {
+        return normalizedPath;
+    }
+    return `${apiPrefix}${normalizedPath}`;
+}
+export function shouldUseJsonBody(body) {
+    if (body === undefined || body === null)
+        return false;
+    if (typeof FormData !== 'undefined' && body instanceof FormData)
+        return false;
+    if (typeof URLSearchParams !== 'undefined' && body instanceof URLSearchParams)
+        return false;
+    return true;
+}

package/dist/types/auth.d.ts

@@ -0,0 +1,6 @@
+import type { ThemeApiTokenProvider } from './types';
+/**
+ * Browser token provider for theme apps.
+ * Priority: localStorage -> cookie
+ */
+export declare function createBrowserTokenProvider(key?: string): ThemeApiTokenProvider;

package/dist/types/client.d.ts

@@ -0,0 +1,82 @@
+import { createCoreOpenApiClient } from 'jiffoo-core-api-sdk';
+import type { ThemeApiClientOptions, RequestOptions, PluginInvokeOptions } from './types';
+type CoreOpenApiClient = ReturnType<typeof createCoreOpenApiClient>;
+export type ThemeApiClient = {
+    request<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    openapi: CoreOpenApiClient;
+    auth: {
+        login<T = unknown>(payload: unknown): Promise<T>;
+        register<T = unknown>(payload: unknown): Promise<T>;
+        me<T = unknown>(): Promise<T>;
+        refresh<T = unknown>(payload: {
+            refresh_token: string;
+        }): Promise<T>;
+        logout<T = unknown>(): Promise<T>;
+        changePassword<T = unknown>(payload: {
+            currentPassword: string;
+            newPassword: string;
+        }): Promise<T>;
+    };
+    account: {
+        getProfile<T = unknown>(): Promise<T>;
+        updateProfile<T = unknown>(payload: Record<string, unknown>): Promise<T>;
+        uploadAvatar<T = unknown>(formData: FormData): Promise<T>;
+    };
+    products: {
+        list<T = unknown>(query?: Record<string, unknown>): Promise<T>;
+        detail<T = unknown>(id: string, query?: Record<string, unknown>): Promise<T>;
+        categories<T = unknown>(query?: Record<string, unknown>): Promise<T>;
+        search<T = unknown>(query: {
+            q: string;
+            page?: number;
+            limit?: number;
+            locale?: string;
+        }): Promise<T>;
+    };
+    cart: {
+        get<T = unknown>(): Promise<T>;
+        add<T = unknown>(payload: {
+            productId: string;
+            quantity: number;
+            variantId?: string;
+        }): Promise<T>;
+        updateItem<T = unknown>(itemId: string, payload: {
+            quantity: number;
+        }): Promise<T>;
+        removeItem<T = unknown>(itemId: string): Promise<T>;
+        clear<T = unknown>(): Promise<T>;
+    };
+    orders: {
+        list<T = unknown>(query?: Record<string, unknown>): Promise<T>;
+        detail<T = unknown>(id: string): Promise<T>;
+        create<T = unknown>(payload: unknown): Promise<T>;
+        cancel<T = unknown>(id: string, payload: {
+            cancelReason: string;
+        }): Promise<T>;
+    };
+    payments: {
+        availableMethods<T = unknown>(): Promise<T>;
+        createSession<T = unknown>(payload: unknown): Promise<T>;
+        verifySession<T = unknown>(sessionId: string): Promise<T>;
+    };
+    store: {
+        context<T = unknown>(query?: {
+            domain?: string;
+            slug?: string;
+        }): Promise<T>;
+    };
+    themes: {
+        active<T = unknown>(query?: {
+            target?: 'shop' | 'admin';
+        }): Promise<T>;
+        installed<T = unknown>(query?: {
+            page?: number;
+            limit?: number;
+        }): Promise<T>;
+    };
+    plugins: {
+        invoke<T = unknown>(slug: string, pluginPath: string, options?: PluginInvokeOptions): Promise<T>;
+    };
+};
+export declare function createThemeApiClient(options?: ThemeApiClientOptions): ThemeApiClient;
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { createThemeApiClient, type ThemeApiClient } from './client';
+export { createBrowserTokenProvider } from './auth';
+export type { PageResult, ThemeApiClientOptions, ThemeApiTokenProvider, RequestOptions, PluginInvokeOptions, } from './types';

package/dist/types/types.d.ts

@@ -0,0 +1,47 @@
+export type PageResult<T> = {
+    items: T[];
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+};
+export type ThemeApiTokenProvider = string | null | undefined | (() => string | null | undefined | Promise<string | null | undefined>);
+export type ThemeApiClientOptions = {
+    /**
+     * Core API base URL.
+     * Default: '' (browser-relative)
+     */
+    baseUrl?: string;
+    /**
+     * API prefix that is prepended to endpoint paths.
+     * Default: '/api'
+     */
+    apiPrefix?: string;
+    /**
+     * JWT token or provider.
+     */
+    token?: ThemeApiTokenProvider;
+    /**
+     * Fetch credentials mode.
+     * Default: 'include'
+     */
+    credentials?: RequestCredentials;
+    /**
+     * Custom fetch implementation for SSR/tests.
+     */
+    fetch?: typeof fetch;
+    /**
+     * Extra headers hook.
+     */
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+};
+export type RequestOptions = {
+    query?: Record<string, unknown>;
+    body?: unknown;
+    headers?: HeadersInit;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+};
+export type PluginInvokeOptions = RequestOptions & {
+    installation?: string;
+    installationId?: string;
+};

package/dist/types/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizePath(path: string): string;
+export declare function normalizePrefix(prefix: string): string;
+export declare function buildPathWithQuery(path: string, query?: Record<string, unknown>): string;
+export declare function resolveApiPath(apiPrefix: string, path: string): string;
+export declare function shouldUseJsonBody(body: unknown): boolean;

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "jiffoo-theme-api-sdk",
+  "version": "0.1.0",
+  "description": "Theme-facing SDK for Jiffoo Mall Core API",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "pnpm --filter jiffoo-core-api-sdk build",
+    "build": "pnpm run build:esm && pnpm run build:cjs && pnpm run build:types",
+    "pretype-check": "pnpm --filter jiffoo-core-api-sdk build",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "dev": "tsc -p tsconfig.esm.json --watch",
+    "clean": "rimraf dist",
+    "type-check": "tsc -p tsconfig.esm.json --noEmit"
+  },
+  "keywords": [
+    "jiffoo",
+    "theme",
+    "sdk",
+    "core-api"
+  ],
+  "author": "Jiffoo Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "jiffoo-core-api-sdk": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3"
+  }
+}