@rezamirzapour/pod-sdk 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,902 @@
+import { RetryConfig, RequestOptions } from '@rezamirzapour/http';
+import { ILogger } from '@rezamirzapour/logger';
+
+interface HandshakeResponse {
+    keyId: string;
+    algorithm: string;
+    expires_in: number;
+}
+interface TokenResponse {
+    hasError: boolean;
+    access_token: string;
+    device_uid: string;
+    expires_in: number;
+    id_token: string;
+    refresh_token: string;
+    scope: string;
+    token_type: string;
+}
+interface VerifyResponse {
+    code: string;
+    device_uid: string;
+}
+interface SsoUserProfile {
+    id: number;
+    name: string;
+    firstName?: string;
+    lastName?: string;
+    username: string;
+    cellphoneNumber?: string;
+    email?: string;
+    roles?: string[];
+    [key: string]: any;
+}
+interface SendOtpOptions {
+    identityType?: string;
+    response_type?: string;
+    referrerType?: string;
+    linkDeliveryType?: string;
+    scope?: string;
+    redirect_uri?: string;
+}
+
+interface PodUrlsConfig {
+    accounts?: string;
+    apiPod?: string;
+    cms?: string;
+    podspace?: string;
+    podform?: string;
+    notification?: string;
+    iums?: string;
+    website?: string;
+}
+interface PodSdkConfig {
+    apiToken?: string;
+    clientId?: string;
+    clientSecret?: string;
+    privateKeyPem?: string;
+    urls?: PodUrlsConfig;
+    revalidate?: number | string;
+    timeout?: number;
+    retry?: boolean | RetryConfig;
+    logger?: ILogger;
+}
+interface PodResponse<T = any> {
+    hasError: boolean;
+    result?: T;
+    message?: string;
+    errorCode?: number;
+    referenceNumber?: string;
+    count?: number;
+    ott?: string;
+    [key: string]: any;
+}
+
+interface SsoServiceOptions {
+    baseUrl: string;
+    clientId: string;
+    clientSecret?: string;
+    apiToken?: string;
+    privateKeyPem?: string;
+    websiteUrl?: string;
+    revalidate?: number | string;
+}
+declare class SsoService {
+    private http;
+    private clientId;
+    private clientSecret;
+    private apiToken;
+    private privateKeyPem;
+    private websiteUrl;
+    private revalidate;
+    constructor(options: SsoServiceOptions);
+    /**
+     * Performs handshake with POD SSO to obtain a keyId for OTP signing.
+     */
+    handshake(deviceUid: string, ip: string): Promise<PodResponse<HandshakeResponse>>;
+    /**
+     * Sends an OTP SMS to the specified phone number.
+     */
+    sendOtpCode(keyId: string, phoneNumber: string, options?: SendOtpOptions): Promise<{
+        hasError: boolean;
+        authorization?: string;
+        identity?: string;
+        result?: any;
+        message?: string;
+    }>;
+    /**
+     * Verifies an OTP code received by SMS.
+     */
+    verifyOtpCode(authorization: string, phoneNumber: string, code: string, redirectUri?: string): Promise<PodResponse<VerifyResponse>>;
+    /**
+     * Exchanges authorization code for access & refresh tokens.
+     */
+    generateToken(code: string, redirectUri?: string): Promise<PodResponse<TokenResponse>>;
+    /**
+     * Refreshes an expired access token using a refresh token.
+     */
+    refreshToken(refreshToken: string): Promise<PodResponse<TokenResponse>>;
+    /**
+     * Fetches user profile from SSO using the access token.
+     */
+    getUserProfile(accessToken: string): Promise<PodResponse<SsoUserProfile>>;
+}
+
+interface SearchTimelineParamMetaQuery<T extends object = any> {
+    field?: string;
+    is?: string | number | boolean;
+    has?: string | number;
+    gt?: string | number;
+    gte?: string | number;
+    lt?: string | number;
+    lte?: string | number;
+    exist?: string | number | boolean;
+    not?: SearchTimelineParamMetaQuery<T>[];
+    true?: string | boolean;
+    false?: string | boolean;
+    or?: SearchTimelineParamMetaQuery<T>[];
+    and?: SearchTimelineParamMetaQuery<T>[];
+    [key: string]: any;
+}
+interface SearchTimelineByMetadataParam<T extends object = any> {
+    id?: number;
+    size?: number;
+    offset?: number;
+    entityName?: string;
+    metaQuery?: SearchTimelineParamMetaQuery<T>;
+    metadata?: Partial<T>;
+    enable?: boolean;
+    orderBy?: string;
+    tags?: string[];
+    [key: string]: any;
+}
+interface CustomPostItem<T = any> {
+    id: number;
+    version?: number;
+    timelineId?: number;
+    entityId: number;
+    forwardedId?: number;
+    numOfLikes?: number;
+    numOfDisLikes?: number;
+    numOfSaved?: number;
+    numOfShare?: number;
+    numOfFavorites?: number;
+    numOfComments?: number;
+    timestamp?: number;
+    enable?: boolean;
+    hide?: boolean;
+    replyPostConfirmation?: boolean;
+    name?: string;
+    content?: string;
+    metadata: T;
+    latitude?: number;
+    longitude?: number;
+    canComment?: boolean;
+    canLike?: boolean;
+    canRate?: boolean;
+    tags?: string[];
+    tagTrees?: string[];
+    data?: string;
+    categoryList?: any[];
+    pin?: boolean;
+    [key: string]: any;
+}
+interface SearchTimelineResultItem<T = any> {
+    type?: number;
+    item: CustomPostItem<T>;
+}
+interface SearchTimelineResponse<T = any> {
+    hasError: boolean;
+    messageId?: number;
+    referenceNumber?: string;
+    errorCode?: number;
+    count?: number;
+    ott?: string;
+    message?: string;
+    result: SearchTimelineResultItem<T>[];
+}
+interface GetCustomPostParams {
+    id?: number;
+    entityId?: number;
+    size?: number;
+    offset?: number;
+    businessId?: number;
+    activityInfo?: boolean;
+    categoryCode?: string;
+    tags?: any[];
+    tagTrees?: string[];
+    tagTreeCategory?: string;
+    uniqueId?: number;
+    [key: string]: any;
+}
+interface GetCustomPostResponse<T = any> {
+    hasError: boolean;
+    messageId?: number;
+    referenceNumber?: string;
+    errorCode?: number;
+    count?: number;
+    ott?: string;
+    message?: string;
+    result: CustomPostItem<T>[];
+}
+interface AddCustomPostParams<T = any> {
+    name: string;
+    content?: string;
+    lgContent?: string;
+    metadata: T;
+    canComment?: boolean;
+    canLike?: boolean;
+    canRate?: boolean;
+    enable?: boolean;
+    tags?: string[];
+    [key: string]: any;
+}
+interface UpdateCustomPostParams<T = any> extends Partial<AddCustomPostParams<T>> {
+    entityId: number;
+}
+interface AddCustomPostResponse<T = any> {
+    hasError: boolean;
+    messageId?: number;
+    referenceNumber?: string;
+    errorCode?: number;
+    count?: number;
+    ott?: string;
+    message?: string;
+    result?: {
+        id: number;
+        entityId: number;
+        metadata?: T;
+        [key: string]: any;
+    };
+}
+interface Metadata<DataType = any> {
+    objectInfo: {
+        type?: string;
+        detailedType?: string;
+        [key: string]: any;
+    };
+    data: DataType;
+    [key: string]: any;
+}
+interface CustomPostCrudConfig {
+    type?: string;
+    detailedType?: string;
+    name: string;
+    content?: string;
+}
+
+/**
+ * Generic Type-Safe CRUD Repository built on top of POD CustomPost service.
+ * Allows managing any arbitrary business entity (Articles, Products, Courses, etc.)
+ * with full typing and metadata binding.
+ */
+declare class CustomPostCrudService<DataType> {
+    private readonly service;
+    private readonly config;
+    constructor(service: CustomPostService, config: CustomPostCrudConfig);
+    protected buildMetadata(data: DataType): Metadata<DataType>;
+    /**
+     * Searches and retrieves all entities matching the query.
+     */
+    getAll(params?: SearchTimelineByMetadataParam<Metadata<DataType>>, options?: RequestOptions): Promise<SearchTimelineResponse<Metadata<DataType>>>;
+    /**
+     * Retrieves a single entity by its numerical ID.
+     */
+    getById(id: number, options?: RequestOptions): Promise<GetCustomPostResponse<Metadata<DataType>>>;
+    /**
+     * Creates a new entity.
+     */
+    create(data: DataType, options?: RequestOptions): Promise<AddCustomPostResponse<Metadata<DataType>>>;
+    /**
+     * Creates multiple entities in batch.
+     */
+    createMultiple(dataList: DataType[], options?: RequestOptions): Promise<AddCustomPostResponse<Metadata<DataType>>[]>;
+    /**
+     * Updates an existing entity by entityId.
+     */
+    update(entityId: number, data: DataType, enable?: boolean, options?: RequestOptions): Promise<AddCustomPostResponse<Metadata<DataType>>>;
+    /**
+     * Creates a post and automatically updates it by binding the generated entityId into the record data.
+     */
+    createAndBindEntityId(data: DataType, options?: RequestOptions): Promise<AddCustomPostResponse<Metadata<DataType>>>;
+    /**
+     * Archives (disables) an entity without deleting its history.
+     */
+    archive(entityId: number, data: DataType, options?: RequestOptions): Promise<AddCustomPostResponse<Metadata<DataType>>>;
+    /**
+     * Deletes an entity permanently.
+     */
+    delete(entityId: number, options?: RequestOptions): Promise<AddCustomPostResponse>;
+}
+
+interface CustomPostServiceOptions {
+    baseUrl: string;
+    apiToken: string;
+    revalidate?: number | string;
+}
+declare class CustomPostService {
+    private http;
+    private apiToken;
+    private revalidate;
+    constructor(options: CustomPostServiceOptions);
+    private safeParseJson;
+    /**
+     * Searches timeline entries by structured metadata query, returning typed items.
+     */
+    searchTimelineByMetadata<T extends object = any>(params: SearchTimelineByMetadataParam<T>, options?: RequestOptions): Promise<SearchTimelineResponse<T>>;
+    /**
+     * Retrieves custom posts list or a single post by entityId/id with typed metadata.
+     */
+    getCustomPost<T = any>(params: GetCustomPostParams, options?: RequestOptions): Promise<GetCustomPostResponse<T>>;
+    /**
+     * Creates a new custom post with strongly typed metadata.
+     */
+    addCustomPost<T = any>(params: AddCustomPostParams<T>, options?: RequestOptions): Promise<AddCustomPostResponse<T>>;
+    /**
+     * Creates multiple custom posts in bulk.
+     */
+    addCustomPostList<T = any>(items: AddCustomPostParams<T>[], options?: RequestOptions): Promise<AddCustomPostResponse<T>[]>;
+    /**
+     * Updates an existing custom post by its entityId with typed metadata.
+     */
+    updateCustomPost<T = any>(params: UpdateCustomPostParams<T>, options?: RequestOptions): Promise<AddCustomPostResponse<T>>;
+    /**
+     * Deletes a custom post by entityId.
+     */
+    deleteCustomPost(entityId: number, options?: RequestOptions): Promise<AddCustomPostResponse>;
+    /**
+     * Factory method to create a high-level Generic CRUD repository for any entity type.
+     */
+    createCrud<DataType>(config: CustomPostCrudConfig): CustomPostCrudService<DataType>;
+}
+
+interface PodspaceUploadResult {
+    hash: string;
+    name: string;
+    size: number;
+    extension: string;
+    created: number;
+    updated: number;
+    path: string;
+    isPublic: boolean;
+    [key: string]: any;
+}
+interface PodspaceUploadResponse {
+    hasError: boolean;
+    message?: string;
+    errorCode?: number;
+    result?: PodspaceUploadResult;
+}
+
+interface PodspaceServiceOptions {
+    baseUrl: string;
+    apiToken: string;
+}
+declare class PodspaceService {
+    private http;
+    private apiToken;
+    private baseUrl;
+    constructor(options: PodspaceServiceOptions);
+    /**
+     * Uploads a file (via FormData) to the POD Podspace storage.
+     */
+    uploadFile(formData: FormData, path?: string, isPublic?: boolean): Promise<PodspaceUploadResponse>;
+    /**
+     * Builds the public or private URL to download/view a file.
+     */
+    getFileUrl(hash: string, isPublic?: boolean): string;
+}
+
+interface PodFormItem {
+    id: number;
+    title?: string;
+    elements?: any[];
+    [key: string]: any;
+}
+interface PodFormResponse<T = any> {
+    hasError: boolean;
+    message?: string;
+    errorCode?: number;
+    result?: T;
+    referenceNumber?: string;
+}
+
+interface PodFormServiceOptions {
+    baseUrl: string;
+    apiToken: string;
+    revalidate?: number | string;
+}
+declare class PodFormService {
+    private http;
+    private apiToken;
+    private revalidate;
+    constructor(options: PodFormServiceOptions);
+    /**
+     * Submits responses/answers to a POD Form.
+     */
+    sendForm<T extends Record<string, any>>(formId: number, data: T): Promise<PodFormResponse>;
+    /**
+     * Retrieves a form and its questions by ID.
+     */
+    getPodformById(id: number, options?: RequestOptions): Promise<PodFormResponse<PodFormItem>>;
+}
+
+interface SendSmsParams {
+    content: string;
+    mobileNumbers: string[];
+}
+interface SendSmsResponse {
+    hasError: boolean;
+    message?: string;
+    errorCode?: number;
+    result?: any;
+    referenceNumber?: string;
+}
+
+interface NotificationServiceOptions {
+    baseUrl: string;
+    apiToken: string;
+}
+declare class NotificationService {
+    private http;
+    private apiToken;
+    constructor(options: NotificationServiceOptions);
+    /**
+     * Sends an SMS notification to one or multiple mobile numbers.
+     */
+    sendSms(params: SendSmsParams): Promise<SendSmsResponse>;
+}
+
+interface CommentItem {
+    id: number;
+    text?: string;
+    createDate?: number;
+    likeCount?: number;
+    dislikeCount?: number;
+    user?: any;
+    [key: string]: any;
+}
+interface GetCommentListParams {
+    subjectId: number | string;
+    offset?: number;
+    size?: number;
+    [key: string]: any;
+}
+interface AddCommentParams {
+    subjectId: number | string;
+    text: string;
+    repliedId?: number;
+    [key: string]: any;
+}
+interface LikeCommentParams {
+    commentId: number;
+    dislike?: boolean;
+}
+interface LikePostParams {
+    subjectId: number | string;
+    dislike?: boolean;
+}
+interface SocialResponse<T = any> {
+    hasError: boolean;
+    message?: string;
+    errorCode?: number;
+    result?: T;
+    count?: number;
+    ott?: string;
+}
+
+interface SocialServiceOptions {
+    baseUrl: string;
+    apiToken: string;
+    revalidate?: number | string;
+}
+declare class SocialService {
+    private http;
+    private apiToken;
+    private revalidate;
+    constructor(options: SocialServiceOptions);
+    /**
+     * Retrieves comments for a specific post or subject ID.
+     */
+    getCommentList(params: GetCommentListParams, options?: RequestOptions): Promise<SocialResponse<CommentItem[]>>;
+    /**
+     * Adds a new comment to a subject.
+     */
+    addComment(params: AddCommentParams): Promise<SocialResponse>;
+    /**
+     * Likes or dislikes a comment.
+     */
+    likeComment(params: LikeCommentParams): Promise<SocialResponse>;
+    /**
+     * Likes or dislikes a post.
+     */
+    likePost(params: LikePostParams): Promise<SocialResponse>;
+}
+
+interface GetContentParams {
+    offset?: number;
+    size?: number;
+    tagTrees?: string[];
+    operationTagTrees?: 'and' | 'or';
+    orderBy?: string[];
+    contentTypeUniqueId?: string;
+    contentUniqueId?: string;
+    entityIds?: string[] | number[];
+    entityId?: number;
+    postIds?: number[];
+    notPostIds?: number[];
+    fieldCode?: string[];
+    fieldValue?: (string | number)[];
+    operationFields?: string;
+    operationValues?: string;
+    showDetail?: boolean;
+    operationValuesArray?: ('is' | 'has' | 'startWith' | 'endWith' | 'lt' | 'lte' | 'gt' | 'gte' | 'exist')[];
+    excludeFieldCode?: string[];
+    excludeFieldValue?: string[];
+    operationExcludeValues?: string;
+    tags?: string[];
+    operationTags?: string;
+    operationValueTags?: string[];
+    orderTagTree?: string;
+    tagTreesCode?: string[];
+    operationTagTreesCode?: string;
+    operationValueTagTreesCode?: string;
+    name?: string;
+    operationName?: string;
+    creatorId?: number;
+    updaterId?: number;
+    publisherId?: number;
+    unPublisherId?: number;
+    fromCreateDate?: string;
+    toCreateDate?: string;
+    fromUpdateDate?: string;
+    toUpdateDate?: string;
+    fromPublisheDate?: string;
+    toPublisheDate?: string;
+    fromUnpublishDate?: string;
+    toUnpublishDate?: string;
+    relatedContentId?: number;
+    relatedProductId?: number;
+    fullName?: string;
+    internalNumber?: string;
+    jobTitle?: string;
+    department?: string;
+    deputy?: string;
+    [key: string]: any;
+}
+interface GetCategoriesParams {
+    parentId?: number;
+    id?: string;
+    parentCode?: string;
+    includeParent?: boolean;
+    excludeTree?: boolean;
+    levelCount?: number;
+    level?: number;
+    name?: string;
+    size?: number;
+    offset?: number;
+    siblingOrder?: string;
+    [key: string]: any;
+}
+interface GetContentByEntityIdParams {
+    entityId: number | string;
+    contentTypeUniqueId?: string;
+}
+interface Business {
+    id: number;
+    name: string;
+    image: string;
+    numOfProducts: number;
+    rate: {
+        rate: number;
+        rateCount: number;
+    };
+    ssoId: string | number;
+}
+interface Rate {
+    rate: number;
+    rateCount: number;
+}
+interface UserPostInfo {
+    postId: number;
+    liked: boolean;
+    disliked: boolean;
+    favorite: boolean;
+}
+interface SeoType {
+    keyword?: string[];
+    description?: string;
+}
+type MetaContent = {
+    code: number | string;
+    name: string;
+    primary: boolean;
+    order: number;
+    uiType: string;
+    valueTitles?: string;
+} & ({
+    value: string;
+    type: 'STRING_VALUE_TYPE';
+} | {
+    value: string;
+    type: 'IMAGE_TYPE';
+} | {
+    value: boolean;
+    type: 'CONTROLLED_VALUE_TYPE';
+} | {
+    value: number;
+    type: 'NUMBER_TYPE';
+} | {
+    value: any;
+    type: string;
+});
+interface TagtreesType {
+    id: number;
+    name: string;
+    code: string;
+    categoryName?: string;
+    siblingOrder?: number;
+    metadata?: {
+        content?: string;
+        created?: any;
+        parentModifier?: any;
+        updated?: any;
+        displayName?: string;
+        englishName?: string;
+        [key: string]: any;
+    };
+}
+interface CmsMetadata {
+    content_type_id: string;
+    content: MetaContent[];
+    content_related?: any[];
+    product_related?: any[];
+    seo?: SeoType;
+    created?: {
+        at: number;
+        user_name: string;
+        ssoId: number;
+    };
+    updated?: {
+        at: number;
+        user_name: string;
+        ssoId: number;
+    };
+    content_type_name?: string;
+    content_type_description?: string;
+    [key: string]: any;
+}
+interface ResultItem {
+    id: number;
+    version?: number;
+    timelineId?: number;
+    entityId: number;
+    forwardedId?: number;
+    numOfLikes?: number;
+    numOfDisLikes?: number;
+    numOfShare?: number;
+    numOfFavorites?: number;
+    numOfComments?: number;
+    timestamp?: number;
+    enable?: boolean;
+    hide?: boolean;
+    replyPostConfirmation?: boolean;
+    business?: Business;
+    rate?: Rate;
+    userPostInfo?: UserPostInfo;
+    metadata: CmsMetadata;
+    latitude?: number;
+    longitude?: number;
+    canComment?: boolean;
+    canLike?: boolean;
+    canRate?: boolean;
+    newRate?: number;
+    countSubjects?: number;
+    countRateSubjects?: number;
+    tags?: string[];
+    tagTrees?: TagtreesType[];
+    name?: string;
+    categoryList?: any[];
+    [key: string]: any;
+}
+interface Subject extends ResultItem {
+}
+interface FormattedSubject extends Subject {
+    formatted: Record<string | number, any>;
+    __normalized: Record<string | number, any>;
+}
+interface ResultItemWithFormatted<T extends Record<string, any>, P = {}> extends ResultItem {
+    formatted: T;
+    __normalized: P;
+}
+interface GetContentResponse {
+    referenceNumber?: string;
+    hasError: boolean;
+    errorCode?: number;
+    refId?: string;
+    message?: string | any[];
+    count?: number;
+    aggregations?: number;
+    result: ResultItem[];
+    product_related?: any[];
+    seo?: SeoType[];
+    metadata?: any[];
+    [key: string]: any;
+}
+interface FormattedGetContentResponse<T extends Record<string, any> = Record<string, any>, P = {}> extends Omit<GetContentResponse, 'result'> {
+    result: ResultItemWithFormatted<T, P>[];
+}
+interface GetCategoryResponse {
+    referenceNumber?: string;
+    hasError: boolean;
+    errorCode?: number;
+    refId?: string;
+    message?: string | any[];
+    count?: number;
+    aggregations?: number;
+    result: TagtreesType[];
+    metadata?: any[];
+    [key: string]: any;
+}
+interface TimelineSearchBody {
+    advance?: {
+        property?: string;
+        value?: string;
+        logicalOperator?: string;
+        operands?: TimelineSearchBody['advance'][];
+    };
+    size?: number;
+    offset?: number;
+    [key: string]: any;
+}
+interface TimelineResponse extends Omit<GetContentResponse, 'result'> {
+    result: any[];
+}
+interface AddContentParams {
+    contentTypeUniqueId: string;
+    body: {
+        name: string;
+        metaDescription?: string;
+        keyword?: string[];
+        contentDescription?: string;
+        tags?: string[];
+        tagTrees?: string[];
+        fieldCode?: string[];
+        fieldValue?: any[];
+        canRate?: boolean;
+        canLike?: boolean;
+        canComment?: boolean;
+        enable?: boolean;
+        isSearchable?: boolean;
+        [key: string]: any;
+    };
+}
+interface CmsRequestOptions {
+    normalizer?: (item: FormattedSubject) => Record<string, any>;
+    revalidate?: number | false;
+    cache?: RequestCache;
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+}
+
+declare class CmsDataFormatter {
+    private podspaceUrl;
+    constructor(podspaceUrl?: string);
+    generateImage(hash?: string, defaultSrc?: string): string;
+    formatContentItem(item: any, normalizer?: (item: FormattedSubject) => Record<string, any>): any;
+    formatGetContentResponse<T extends Record<string, any> = Record<string, any>, P = {}>(response: any, normalizer?: (item: FormattedSubject) => Record<string, any>): FormattedGetContentResponse<T, P>;
+}
+
+interface CmsServiceOptions {
+    baseUrl: string;
+    clientId: string;
+    apiToken?: string;
+    podspaceUrl?: string;
+    revalidate?: number | string;
+}
+declare class CmsService {
+    private http;
+    private formatter;
+    private clientId;
+    private apiToken;
+    private revalidate;
+    constructor(options: CmsServiceOptions);
+    private get commonHeaders();
+    private get managingHeaders();
+    /**
+     * Retrieves enabled published content from CMS, formatted with generic metadata type T and optional normalized type P.
+     */
+    getContent<T extends Record<string, any> = Record<string, any>, P = {}>(params?: GetContentParams, options?: CmsRequestOptions): Promise<FormattedGetContentResponse<T, P>>;
+    /**
+     * Retrieves content using managing credentials (Access-Token).
+     */
+    getContent2<T extends Record<string, any> = Record<string, any>, P = {}>(params?: GetContentParams, options?: CmsRequestOptions): Promise<FormattedGetContentResponse<T, P>>;
+    /**
+     * Retrieves unpublished/draft content (enable: false).
+     */
+    getUnpublishedContent<T extends Record<string, any> = Record<string, any>, P = {}>(params?: GetContentParams, options?: CmsRequestOptions): Promise<FormattedGetContentResponse<T, P>>;
+    /**
+     * Retrieves single content by entityId and optional contentTypeUniqueId.
+     */
+    getContentByEntityId<T extends Record<string, any> = Record<string, any>, P = {}>(params: GetContentByEntityIdParams, options?: CmsRequestOptions): Promise<FormattedGetContentResponse<T, P>>;
+    /**
+     * Retrieves tag/category tree.
+     */
+    getCategories(params?: GetCategoriesParams, options?: CmsRequestOptions): Promise<GetCategoryResponse>;
+    /**
+     * Retrieves details of a content type structure.
+     */
+    getContentTypeDetail(contentTypeUniqueId: string): Promise<any>;
+    /**
+     * Adds and publishes new content to CMS.
+     */
+    addContent<T extends Record<string, any> = Record<string, any>, P = {}>(params: AddContentParams, options?: CmsRequestOptions): Promise<FormattedGetContentResponse<T, P>>;
+    /**
+     * Edits and publishes existing content by entityId.
+     */
+    editContent<T extends Record<string, any> = Record<string, any>, P = {}>(entityId: number, params: AddContentParams, options?: CmsRequestOptions): Promise<FormattedGetContentResponse<T, P>>;
+    /**
+     * Performs advanced AI timeline search.
+     */
+    timelineSearch(query?: TimelineSearchBody): Promise<TimelineResponse>;
+}
+
+interface GetInfOfGraduatedByGraduateDateResponse {
+    [key: string]: any;
+}
+interface GetSessionClassInCurrentDayResponse {
+    [key: string]: any;
+}
+interface IumsResponse<T = any> {
+    content: string;
+    [key: string]: any;
+}
+
+interface IumsServiceOptions {
+    baseUrl: string;
+    clientId: string;
+    revalidate?: number | string;
+}
+declare class IumsService {
+    private http;
+    private clientId;
+    private revalidate;
+    constructor(options: IumsServiceOptions);
+    private generateIumsDataPayload;
+    private formatIumsResponse;
+    private request;
+    getInfOfGraduatedByGraduateDate(startDate?: string, endDate?: string, options?: RequestOptions): Promise<GetInfOfGraduatedByGraduateDateResponse>;
+    getSessionClassInCurrentDay(options?: RequestOptions): Promise<GetSessionClassInCurrentDayResponse>;
+    getDetailsOfTermExam(options?: RequestOptions): Promise<any>;
+    getStudentInformationByNumber(studentNumber: string | number, options?: RequestOptions): Promise<any>;
+    getStudentInformationByNationalCode(nationalCode: string | number, options?: RequestOptions): Promise<any>;
+}
+
+declare class PodSdk {
+    readonly sso: SsoService;
+    readonly customPost: CustomPostService;
+    readonly podspace: PodspaceService;
+    readonly podform: PodFormService;
+    readonly notification: NotificationService;
+    readonly social: SocialService;
+    readonly cms: CmsService;
+    readonly iums: IumsService;
+    constructor(config: PodSdkConfig);
+    /**
+     * Helper shortcut to instantiate a Generic CRUD repository for any entity type on POD CustomPost.
+     */
+    createCrud<DataType>(config: CustomPostCrudConfig): CustomPostCrudService<DataType>;
+}
+/**
+ * Factory function to create a new POD SDK instance.
+ */
+declare function createPodSdk(config: PodSdkConfig): PodSdk;
+
+/**
+ * Cryptographic and encoding utilities for POD Platform services.
+ * Uses standard Web Crypto API (supported natively in Node.js 18+, Browsers, and Edge).
+ */
+declare function encodeBase64(str: string): string;
+declare function generatePodSignatureHeader(keyId: string, privateKeyPem?: string): Promise<string>;
+
+export { type AddCommentParams, type AddContentParams, type AddCustomPostParams, type AddCustomPostResponse, type Business, CmsDataFormatter, type CmsMetadata, type CmsRequestOptions, CmsService, type CmsServiceOptions, type CommentItem, type CustomPostCrudConfig, CustomPostCrudService, type CustomPostItem, CustomPostService, type CustomPostServiceOptions, type FormattedGetContentResponse, type FormattedSubject, type GetCategoriesParams, type GetCategoryResponse, type GetCommentListParams, type GetContentByEntityIdParams, type GetContentParams, type GetContentResponse, type GetCustomPostParams, type GetCustomPostResponse, type GetInfOfGraduatedByGraduateDateResponse, type GetSessionClassInCurrentDayResponse, type HandshakeResponse, type IumsResponse, IumsService, type IumsServiceOptions, type LikeCommentParams, type LikePostParams, type MetaContent, type Metadata, NotificationService, type NotificationServiceOptions, type PodFormItem, type PodFormResponse, PodFormService, type PodFormServiceOptions, type PodResponse, PodSdk, type PodSdkConfig, type PodUrlsConfig, PodspaceService, type PodspaceServiceOptions, type PodspaceUploadResponse, type PodspaceUploadResult, type Rate, type ResultItem, type ResultItemWithFormatted, type SearchTimelineByMetadataParam, type SearchTimelineParamMetaQuery, type SearchTimelineResponse, type SearchTimelineResultItem, type SendOtpOptions, type SendSmsParams, type SendSmsResponse, type SeoType, type SocialResponse, SocialService, type SocialServiceOptions, SsoService, type SsoServiceOptions, type SsoUserProfile, type Subject, type TagtreesType, type TimelineResponse, type TimelineSearchBody, type TokenResponse, type UpdateCustomPostParams, type UserPostInfo, type VerifyResponse, createPodSdk, PodSdk as default, encodeBase64, generatePodSignatureHeader };