@lark-apaas/dataloom 0.1.1-alpha.0

package/README.md

@@ -0,0 +1,3 @@
+# @lark-apaas/dataloom
+
+Dataloom client SDK for @lark-apaas (storage + service). Migrated from @data-loom/js.

package/lib/DataloomClient.d.ts

@@ -0,0 +1,31 @@
+import RateLimiter from './RateLimiter';
+import DataloomService from './service';
+import { StorageClient } from './storage';
+import type { Fetch, SupabaseClientOptions } from './utils/types';
+/**
+ * Dataloom Client.
+ *
+ * An isomorphic Javascript client for interacting with Dataloom service and storage.
+ */
+export default class DataloomClient {
+    protected supabaseUrl: string;
+    protected supabaseKey: string;
+    protected workspaceId: string;
+    service: DataloomService;
+    storage: StorageClient;
+    protected storageUrl: string;
+    protected fetch?: Fetch;
+    protected rateLimiter?: RateLimiter;
+    protected onRequestError: (error: any) => void;
+    protected headers: Record<string, string>;
+    /**
+     * Create a new client for use in the browser.
+     * @param supabaseUrl The unique Dataloom URL which is supplied when you create a new project.
+     * @param supabaseKey The unique Dataloom Key which is supplied when you create a new project.
+     * @param workspaceId The unique workspace id which is supplied when you create a new workspace.
+     * @param options.global.fetch A custom fetch implementation.
+     * @param options.global.headers Any additional headers to send with each network request.
+     */
+    constructor(supabaseUrl: string, supabaseKey: string, workspaceId: string, options?: SupabaseClientOptions);
+}
+//# sourceMappingURL=DataloomClient.d.ts.map

package/lib/DataloomClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataloomClient.d.ts","sourceRoot":"","sources":["../src/DataloomClient.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,eAAe,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI1C,OAAO,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IAoB/B,SAAS,CAAC,WAAW,EAAE,MAAM;IAC7B,SAAS,CAAC,WAAW,EAAE,MAAM;IAC7B,SAAS,CAAC,WAAW,EAAE,MAAM;IArB/B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;IAEvB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACxB,SAAS,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACpC,SAAS,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAE/C,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C;;;;;;;OAOG;gBAES,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,qBAAqB;CAoDlC"}

package/lib/DataloomClient.js

@@ -0,0 +1,39 @@
+import RateLimiter from "./RateLimiter.js";
+import service from "./service/index.js";
+import { StorageClient } from "./storage/index.js";
+import { DEFAULT_GLOBAL_OPTIONS } from "./utils/constants.js";
+import { fetchWithAuth } from "./utils/fetch.js";
+import { applySettingDefaults, stripTrailingSlash } from "./utils/helpers.js";
+class DataloomClient {
+    constructor(supabaseUrl, supabaseKey, workspaceId, options){
+        this.supabaseUrl = supabaseUrl;
+        this.supabaseKey = supabaseKey;
+        this.workspaceId = workspaceId;
+        const _supabaseUrl = stripTrailingSlash(supabaseUrl);
+        this.storageUrl = `${_supabaseUrl}/storage`;
+        const DEFAULTS = {
+            global: DEFAULT_GLOBAL_OPTIONS
+        };
+        const settings = applySettingDefaults(options ?? {}, DEFAULTS);
+        this.headers = settings.global.headers ?? {};
+        this.onRequestError = (error)=>{
+            if (settings.global.onError) settings.global.onError(error, this);
+        };
+        if (settings.global.requestRateLimit && settings.global.requestRateLimit > 0) this.rateLimiter = new RateLimiter(settings.global.requestRateLimit);
+        this.fetch = fetchWithAuth(supabaseKey, this.rateLimiter, settings.global.fetch);
+        this.service = new service({
+            headers: this.headers,
+            fetch: this.fetch,
+            logger: settings.global.enableDataloomLog,
+            brandName: settings.global.brandName,
+            appId: settings.global.appId,
+            onRequestError: this.onRequestError
+        });
+        this.storage = new StorageClient(this.storageUrl, this.headers, this.fetch, {
+            enableLogger: settings.global.enableDataloomLog,
+            onRequestError: this.onRequestError,
+            appId: settings.global.appId
+        });
+    }
+}
+export { DataloomClient as default };

package/lib/RateLimiter.d.ts

@@ -0,0 +1,15 @@
+/**
+ *  rate limiter that allows a given number of requests within a predefined time window.
+ */
+declare class RateLimiter {
+    static readonly WINDOW_SIZE = 5000;
+    maxRequests: number;
+    private windowSizeMs;
+    private requestCount;
+    private windowStart;
+    constructor(maxRequests: number);
+    checkAndResetWindow(): boolean;
+    canRequest(): boolean;
+}
+export default RateLimiter;
+//# sourceMappingURL=RateLimiter.d.ts.map

package/lib/RateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../src/RateLimiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,WAAW;IACf,MAAM,CAAC,QAAQ,CAAC,WAAW,QAAQ;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAO/B,mBAAmB;IAYnB,UAAU;CASX;AAED,eAAe,WAAW,CAAC"}

package/lib/RateLimiter.js

@@ -0,0 +1,31 @@
+class RateLimiter {
+    static{
+        this.WINDOW_SIZE = 5000;
+    }
+    constructor(maxRequests){
+        this.maxRequests = maxRequests;
+        this.windowSizeMs = RateLimiter.WINDOW_SIZE;
+        this.requestCount = 0;
+        this.windowStart = Date.now();
+    }
+    checkAndResetWindow() {
+        const now = Date.now();
+        const windowElapsed = now - this.windowStart;
+        if (windowElapsed >= this.windowSizeMs) {
+            this.requestCount = 0;
+            this.windowStart = now;
+            return true;
+        }
+        return false;
+    }
+    canRequest() {
+        this.checkAndResetWindow();
+        if (this.requestCount < this.maxRequests) {
+            this.requestCount++;
+            return true;
+        }
+        return false;
+    }
+}
+const src_RateLimiter = RateLimiter;
+export { src_RateLimiter as default };

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+import DataloomClient from './DataloomClient';
+import type { SupabaseClientOptions } from './utils/types';
+export { default as DataloomClient } from './DataloomClient';
+export type { SupabaseClientOptions } from './utils/types';
+/**
+ * Creates a new Dataloom Client.
+ */
+export declare const createClient: (dataloomUrl: string, dataloomKey: string, workspaceId: string, options?: SupabaseClientOptions) => DataloomClient;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,UAAU,qBAAqB,KAC9B,cAEF,CAAC"}

package/lib/index.js

@@ -0,0 +1,3 @@
+import DataloomClient from "./DataloomClient.js";
+const createClient = (dataloomUrl, dataloomKey, workspaceId, options)=>new DataloomClient(dataloomUrl, dataloomKey, workspaceId, options);
+export { DataloomClient, createClient };

package/lib/service/index.d.ts

@@ -0,0 +1,9 @@
+import { default as SessionService } from './services/session-service';
+import { default as UserService } from './services/user-service';
+import type { DataloomServiceOptions } from './utils/types';
+export default class DataloomService {
+    user: UserService;
+    session: SessionService;
+    constructor(options: DataloomServiceOptions);
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;gBAEZ,OAAO,EAAE,sBAAsB;CAK5C"}

package/lib/service/index.js

@@ -0,0 +1,11 @@
+import session_service from "./services/session-service/index.js";
+import user_service from "./services/user-service/index.js";
+import { isBrowser } from "./utils/helpers.js";
+class DataloomService {
+    constructor(options){
+        const baseUrl = isBrowser() ? window.location.origin : '';
+        this.user = new user_service(baseUrl, options);
+        this.session = new session_service(baseUrl, options);
+    }
+}
+export { DataloomService as default };

package/lib/service/services/DataloomServiceBase.d.ts

@@ -0,0 +1,17 @@
+import { type DataloomServiceOptions, type DataloomServiceResponse, type ExtraInfo, type Fetch, type FetchOptions, type OnRequestErrorType, ServiceName } from '../utils/types';
+export default abstract class DataloomServiceBase {
+    protected baseUrl: string;
+    protected headers: {
+        [key: string]: string;
+    };
+    protected fetch: Fetch;
+    protected logger: boolean;
+    protected serviceName: ServiceName;
+    protected brandId: string;
+    protected bizSource: string;
+    protected appId: string;
+    protected onRequestError?: (error: OnRequestErrorType) => void;
+    constructor(baseUrl: string, options: DataloomServiceOptions);
+    fetchData<T>(url: string, options: FetchOptions, extras?: ExtraInfo): Promise<DataloomServiceResponse<T>>;
+}
+//# sourceMappingURL=DataloomServiceBase.d.ts.map

package/lib/service/services/DataloomServiceBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataloomServiceBase.d.ts","sourceRoot":"","sources":["../../../src/service/services/DataloomServiceBase.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,mBAAmB;IAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7C,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IACvB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;IACnC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;gBAEnD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB;IAoBtD,SAAS,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;CAuIvC"}

package/lib/service/services/DataloomServiceBase.js

@@ -0,0 +1,126 @@
+import { getCookieByName, serializeSessionBrandId } from "../utils/helpers.js";
+import { logRequest, logResponse } from "../utils/logger.js";
+import { traceIdGenerator } from "../utils/trace-id.js";
+import { ServiceName } from "../utils/types.js";
+class DataloomServiceBase {
+    constructor(baseUrl, options){
+        this.baseUrl = baseUrl;
+        this.headers = {
+            ...options.headers,
+            'X-Suda-Csrf-Token': getCookieByName('suda-csrf-token')
+        };
+        this.logger = options.logger ?? false;
+        this.serviceName = ServiceName.DEFAULT;
+        this.brandId = serializeSessionBrandId(options.brandName);
+        this.bizSource = options.brandName;
+        this.appId = options.appId;
+        this.onRequestError = options.onRequestError;
+        if (options.fetch) this.fetch = options.fetch;
+        else this.fetch = fetch;
+    }
+    async fetchData(url, options, extras) {
+        const fetchUrl = `${this.baseUrl.toString()}${url}`;
+        let traceId = -1;
+        if (this.logger) {
+            traceId = traceIdGenerator.next();
+            logRequest({
+                traceId,
+                url: fetchUrl,
+                method: options.method,
+                body: options.body
+            }, extras?.psmName);
+        }
+        try {
+            const res = await this.fetch(fetchUrl, {
+                method: options.method,
+                mode: 'cors',
+                redirect: 'manual',
+                credentials: 'include',
+                headers: this.headers,
+                body: JSON.stringify(options.body)
+            });
+            let error = null;
+            let data = null;
+            let status = res.status;
+            let statusText = res.statusText;
+            if (res.ok) {
+                const body = await res.text();
+                const parsedBody = JSON.parse(body);
+                if (parsedBody.status_code && parsedBody.error_msg) {
+                    data = null;
+                    error = {
+                        code: parsedBody.status_code || res.status,
+                        details: '',
+                        hint: '',
+                        message: parsedBody.error_msg || body
+                    };
+                } else {
+                    data = parsedBody.data;
+                    error = null;
+                }
+            } else {
+                const body = await res.text();
+                const parsedBody = JSON.parse(body);
+                try {
+                    error = 429 === res.status ? {
+                        code: 429,
+                        message: 'Too many requests received within 5 seconds.',
+                        details: '',
+                        hint: 'Retry after 5 seconds.'
+                    } : {
+                        code: parsedBody.status_code || res.status,
+                        message: parsedBody.error_msg || body,
+                        details: '',
+                        hint: ''
+                    };
+                } catch (_e) {
+                    error = {
+                        code: parsedBody.status_code || res.status,
+                        message: parsedBody.error_msg || body,
+                        details: '',
+                        hint: ''
+                    };
+                    data = null;
+                    status = 500;
+                    statusText = 'Dataloom Internal Error';
+                }
+            }
+            const serviceResponse = {
+                data,
+                error,
+                status,
+                statusText
+            };
+            if (error) this.onRequestError?.({
+                ...error,
+                status,
+                statusText
+            });
+            if (this.logger) logResponse(traceId, serviceResponse, extras?.psmName);
+            return serviceResponse;
+        } catch (e) {
+            const internalError = {
+                error: {
+                    code: 500,
+                    message: e?.message,
+                    details: '',
+                    hint: ''
+                },
+                status: 500,
+                statusText: 'Dataloom Internal Error'
+            };
+            this.onRequestError?.({
+                ...internalError.error,
+                status: internalError.status,
+                statusText: internalError.statusText
+            });
+            const serviceResponse = {
+                data: null,
+                ...internalError
+            };
+            if (this.logger) logResponse(traceId, serviceResponse, extras?.psmName);
+            return serviceResponse;
+        }
+    }
+}
+export { DataloomServiceBase as default };

package/lib/service/services/session-service/index.d.ts

@@ -0,0 +1,45 @@
+import type { DataloomServiceResponse } from '../../utils/types';
+import { ServiceName } from '../../utils/types';
+import DataloomServiceBase from '../DataloomServiceBase';
+import type { SignInRedirectionOptions, UserInfoResponse } from './types';
+export default class SessionService extends DataloomServiceBase {
+    serviceName: ServiceName;
+    /**
+     * Redirect to login page within app runtime environment.
+     */
+    redirectToLogin(options?: SignInRedirectionOptions): DataloomServiceResponse<'success'>;
+    /**
+     * Sign out current user session.
+     */
+    signOut(): Promise<DataloomServiceResponse<null>>;
+    /**
+     * Get current page URL with biz_source parameter
+     */
+    getUrlWithBizSource(): string;
+    /**
+     * Gets the current user information if there is an existing session.
+     */
+    getUserInfo(): Promise<DataloomServiceResponse<UserInfoResponse>>;
+    /**
+     * Navigate to user profile page within app runtime environment.
+     */
+    navigateToUserProfile(options?: {
+        newTab?: boolean;
+    }): {
+        data: null;
+        error: {
+            code: number;
+            message: string;
+            hint: string;
+            details: string;
+        };
+        status: number;
+        statusText: string;
+    } | {
+        data: string;
+        error: null;
+        status: number;
+        statusText: string;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/service/services/session-service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/service/services/session-service/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,mBAAmB,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAGV,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAcjB,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,mBAAmB;IACpD,WAAW,cAA8B;IAElD;;OAEG;IACH,eAAe,CACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAAC,SAAS,CAAC;IAiCrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAoBvD;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAa7B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAkDvE;;OAEG;IACH,qBAAqB,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;;;;;;;;;;;CA0BrD"}

package/lib/service/services/session-service/index.js

@@ -0,0 +1,111 @@
+import { isBrowser } from "../../utils/helpers.js";
+import { ServiceName } from "../../utils/types.js";
+import DataloomServiceBase from "../DataloomServiceBase.js";
+const browserEnvError = {
+    data: null,
+    error: {
+        code: 400,
+        message: 'Incompatible runtime environment',
+        hint: 'Please check if the current environment is browser.',
+        details: 'This method can only be invoked in browser environment.'
+    },
+    status: 400,
+    statusText: 'Bad Request'
+};
+class SessionService extends DataloomServiceBase {
+    redirectToLogin(options) {
+        if (!isBrowser()) {
+            console.log('[Dataloom][SessionService.RedirectToLogin] dataloom.service.session.redirectToLogin can only be invoked in browser environment.');
+            return browserEnvError;
+        }
+        const { returnUrl, newTab = false } = options ?? {};
+        const encodedRedirectUrl = encodeURIComponent(decodeURIComponent(returnUrl || window.location.href));
+        const isSparkFaasPath = window.location.pathname.startsWith('/spark');
+        const baseLoginUrl = isSparkFaasPath ? `/spark/faas/${this.appId}/runtime/page/login` : `/app/${this.appId}/runtime/page/login`;
+        const loginPageUrl = `${baseLoginUrl}?biz_source=${this.bizSource}&redirect_uri=${encodedRedirectUrl}`;
+        if (newTab) window.open(loginPageUrl, '_blank');
+        else window.location.href = loginPageUrl;
+        return {
+            data: 'success',
+            error: null,
+            status: 200,
+            statusText: 'OK'
+        };
+    }
+    async signOut() {
+        if (!isBrowser()) {
+            console.log('[Dataloom][SessionService.SignOut] dataloom.service.session.signOut can only be invoked in browser environment.');
+            return browserEnvError;
+        }
+        const location = this.getUrlWithBizSource();
+        return this.fetchData('/af/runtime/api/v1/account/logout', {
+            method: 'POST',
+            body: {
+                appID: this.appId,
+                redirectURI: location
+            }
+        });
+    }
+    getUrlWithBizSource() {
+        if (!isBrowser()) {
+            console.log('[Dataloom][SessionService.GetUrlWithBizSource] dataloom.service.session.getUrlWithBizSource can only be invoked in browser environment.');
+            return '';
+        }
+        const currentUrl = new URL(window.location.href);
+        currentUrl.searchParams.set('biz_source', this.bizSource);
+        return currentUrl.toString();
+    }
+    async getUserInfo() {
+        if (!isBrowser()) {
+            console.log('[Dataloom][SessionService.GetUserInfo] dataloom.service.session.getUserInfo can only be invoked in browser environment.');
+            return Promise.resolve(browserEnvError);
+        }
+        const url = `/app/${this.appId}/__runtime__/api/v1/account/login/user`;
+        const urlObj = new URL(globalThis.location.href);
+        const pathSegments = urlObj.hostname.split('.');
+        const tenantDomainName = pathSegments[0] ?? '';
+        const response = await this.fetchData(url, {
+            method: 'POST',
+            body: {
+                appID: this.appId,
+                tenantDomainName
+            }
+        });
+        const userInfoResponse = {
+            data: {
+                user_info: {
+                    user_id: response.data?.userInfo?.userID,
+                    name: response.data?.userInfo?.name,
+                    avatar: response.data?.userInfo?.avatar,
+                    email: response.data?.userInfo?.email,
+                    phone_number: response.data?.userInfo?.desensitizedPhoneNumber
+                }
+            },
+            error: null,
+            status: response.status,
+            statusText: response.statusText
+        };
+        return userInfoResponse;
+    }
+    navigateToUserProfile(options) {
+        if (!isBrowser()) {
+            console.log('[Dataloom][SessionService.NavigateToUserProfile] dataloom.service.session.navigateToUserProfile can only be invoked in browser environment.');
+            return browserEnvError;
+        }
+        const { newTab = false } = options ?? {};
+        const encodedReturnUrl = encodeURIComponent(window.location.href);
+        const profilePageUrl = `/suda/user?brand=${this.brandId}&returnUrl=${encodedReturnUrl}&appId=${this.appId}`;
+        if (newTab) window.open(profilePageUrl, '_blank');
+        else window.location.href = profilePageUrl;
+        return {
+            data: 'success',
+            error: null,
+            status: 200,
+            statusText: 'OK'
+        };
+    }
+    constructor(...args){
+        super(...args), this.serviceName = ServiceName.SessionService;
+    }
+}
+export { SessionService as default };

package/lib/service/services/session-service/types.d.ts

@@ -0,0 +1,34 @@
+export interface I18n {
+    language_code: number;
+    text: string;
+}
+export type I18ns = I18n[];
+export interface Avatar {
+    source?: string;
+    image?: {
+        large?: string;
+    };
+    color?: string;
+}
+export interface SignInRedirectionOptions {
+    /**
+     * The URL to redirect to after a successful login. Defaults to the current URL.
+     */
+    returnUrl?: string;
+    /**
+     * Whether to open the login page in a new tab. Defaults to `false`.
+     */
+    newTab?: boolean;
+}
+export interface UserBaseInfo {
+    user_id?: number;
+    name?: I18ns;
+    avatar?: Avatar;
+    email?: string;
+    phone_number?: string;
+    tenant_name?: string;
+}
+export interface UserInfoResponse {
+    user_info?: UserBaseInfo;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/service/services/session-service/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/service/services/session-service/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;AAE3B,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B"}

package/lib/service/services/types.d.ts

@@ -0,0 +1,12 @@
+export declare enum AccountStatus {
+    Unspecified = 0,
+    Inactive = 1,// 未激活
+    Active = 2,// 已激活
+    Disabled = 3,// 停用
+    Terminated = 4
+}
+export declare enum UserStatus {
+    active = 1,// 正常
+    inactive = 2
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/service/services/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/service/services/types.ts"],"names":[],"mappings":"AACA,oBAAY,aAAa;IACvB,WAAW,IAAI;IACf,QAAQ,IAAI,CAAE,MAAM;IACpB,MAAM,IAAI,CAAE,MAAM;IAClB,QAAQ,IAAI,CAAE,KAAK;IACnB,UAAU,IAAI;CACf;AAGD,oBAAY,UAAU;IACpB,MAAM,IAAI,CAAE,KAAK;IACjB,QAAQ,IAAI;CACb"}

package/lib/service/services/types.js

@@ -0,0 +1,14 @@
+var types_AccountStatus = /*#__PURE__*/ function(AccountStatus) {
+    AccountStatus[AccountStatus["Unspecified"] = 0] = "Unspecified";
+    AccountStatus[AccountStatus["Inactive"] = 1] = "Inactive";
+    AccountStatus[AccountStatus["Active"] = 2] = "Active";
+    AccountStatus[AccountStatus["Disabled"] = 3] = "Disabled";
+    AccountStatus[AccountStatus["Terminated"] = 4] = "Terminated";
+    return AccountStatus;
+}({});
+var types_UserStatus = /*#__PURE__*/ function(UserStatus) {
+    UserStatus[UserStatus["active"] = 1] = "active";
+    UserStatus[UserStatus["inactive"] = 2] = "inactive";
+    return UserStatus;
+}({});
+export { types_AccountStatus as AccountStatus, types_UserStatus as UserStatus };

package/lib/service/services/user-service/index.d.ts

@@ -0,0 +1,9 @@
+import { type DataloomServiceResponse, ServiceName } from '../../utils/types';
+import DataloomServiceBase from '../DataloomServiceBase';
+import type { SearchParams, UserResponse } from './types';
+export default class UserService extends DataloomServiceBase {
+    serviceName: ServiceName;
+    search(params: SearchParams): Promise<DataloomServiceResponse<UserResponse>>;
+    getByIds(ids: string[] | number[]): Promise<DataloomServiceResponse<UserResponse>>;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/service/services/user-service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/service/services/user-service/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,uBAAuB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,mBAAmB,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAEV,YAAY,EAEZ,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,mBAAmB;IACjD,WAAW,cAA2B;IAEzC,MAAM,CACV,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAqC3C,QAAQ,CACZ,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GACvB,OAAO,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;CAkClD"}

package/lib/service/services/user-service/index.js

@@ -0,0 +1,60 @@
+import { convertUserStatus, retrieveNameFromI18n } from "../../utils/helpers.js";
+import { ServiceName } from "../../utils/types.js";
+import DataloomServiceBase from "../DataloomServiceBase.js";
+class UserService extends DataloomServiceBase {
+    async search(params) {
+        const { name, pageSize } = params;
+        const res = await this.fetchData(`/app/${this.appId}/__runtime__/api/v1/account/search_user`, {
+            method: 'POST',
+            body: {
+                query: name,
+                page_size: pageSize
+            }
+        }, {
+            psmName: 'UserService.Search'
+        });
+        if (res.error) return res;
+        return {
+            ...res,
+            data: {
+                user_list: res.data?.userList?.map((item)=>({
+                        avatar: item.avatar ?? '',
+                        email: item.email ?? '',
+                        name: retrieveNameFromI18n(item.name) ?? '',
+                        status: convertUserStatus(item.userStatus),
+                        user_id: item.userID ?? ''
+                    })) ?? []
+            }
+        };
+    }
+    async getByIds(ids) {
+        const res = await this.fetchData(`/app/${this.appId}/__runtime__/api/v1/account/list_users`, {
+            method: 'POST',
+            body: {
+                userIDList: ids
+            }
+        }, {
+            psmName: 'UserService.GetByIds'
+        });
+        if (res.error) return res;
+        return {
+            ...res,
+            data: {
+                user_list: ids.map((id)=>{
+                    const item = res.data?.userInfoMap?.[id];
+                    return {
+                        avatar: item?.avatar?.image?.large ?? '',
+                        email: item?.email ?? '',
+                        name: retrieveNameFromI18n(item?.name) ?? '',
+                        status: convertUserStatus(item?.userStatus),
+                        user_id: item?.userID ? String(item.userID) : ''
+                    };
+                })
+            }
+        };
+    }
+    constructor(...args){
+        super(...args), this.serviceName = ServiceName.UserService;
+    }
+}
+export { UserService as default };