lemon-core 4.3.0 → 5.0.0

package/dist/extended/cores/commons.js

@@ -1,185 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.$T = exports.onlyDefined = void 0;
-exports.parseListParam = parseListParam;
-exports.parsePaginateParam = parsePaginateParam;
-const helpers_1 = require("../../helpers/");
-const engine_1 = require("../../engine/");
-/** local copy of legacy `$T.B` — keep decoupled: L1 `$T.B` semantics differ across version lines (4.2.x returns boolean). */
-const _B = (val, def = 0) => {
-    if (val === null || val === undefined)
-        return def;
-    if (typeof val === 'boolean')
-        return val ? 1 : 0;
-    if (typeof val === 'string' && ['y', 'yes', 't', 'true'].includes(val.toLowerCase()))
-        return 1;
-    return engine_1.$U.N(val, def) && 1;
-};
+exports.onlyDefined = exports.parsePaginateParam = exports.parseListParam = exports.$T = void 0;
 /**
- * extract only the defined attribute.
- * ex) `{ a:1, b: undefined }` -> `{ a:1 }`
+ * `commons.ts`
+ * - common tools to export.
+ *
+ * @author      Steve <steve@lemoncloud.io>
+ * @date        2022-11-01 optimized w/ `commons`
+ * @date        2024-06-24 optimized `parseListParam()`
+ * @date        2025-01-03 optimized `parseListParam()` w/ `offset`
+ * @date        2025-05-25 optimized `$T.N()` + `parsePaginateParam()` w/ `noLimit` option
+ * @date        2025-07-31 optimized `$T.B()` for boolean conversion.
+ * @date        2026-02-09 optimized `$T.F()` to keep the original function.
+ * @date        2026-04-10 optimized `types` to fix ts warning.
+ * @date        2026-10-28 v5 B3: re-exports only — each name has one definition below `extended/cores`.
+ *
+ * @copyright   (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
+ * @origin      `@lemoncloud/lemon-templates-api/cores`
  */
-const onlyDefined = (N) => N && typeof N === 'object'
-    ? Object.entries(N).reduce((N, [k, v]) => {
-        if (v !== undefined)
-            N[k] = v;
-        return N;
-    }, {})
-    : null;
-exports.onlyDefined = onlyDefined;
-/**
- * list param parser
- * @param param
- */
-function parseListParam(param, $def) {
-    return (0, exports.onlyDefined)({
-        sort: param?.sort !== undefined ? helpers_1.$T.S2(param?.sort, '') : '',
-        limit: helpers_1.$T.N(param?.limit, $def?.limit ?? 10),
-    });
-}
-/**
- * paginate param parser
- */
-function parsePaginateParam(param, 
-/** default value or conditions */
-options) {
-    const limit = options?.limit;
-    const page = options?.page ?? 0;
-    const res = (0, exports.onlyDefined)({
-        ...parseListParam(param, { limit }),
-        page: helpers_1.$T.N(param?.page, page),
-        offset: param?.offset !== undefined ? helpers_1.$T.N(param?.offset, 0) : undefined,
-    });
-    const noLimit = options?.noLimit ?? res.limit == -1;
-    const MAX_LIMIT = exports.$T.N(engine_1.$U.env('MAX_LIMIT', '2000'));
-    if (MAX_LIMIT <= 0)
-        throw new Error(`@env.MAX_LIMIT[${MAX_LIMIT}] (number) is invalid!`);
-    //WARN! - limit the max result to 2000.
-    if (!noLimit) {
-        const limit = exports.$T.N(res?.limit ?? 0, 0);
-        const page = exports.$T.N(res?.page ?? 0, 0);
-        const maxPage = limit > 0 ? Math.floor(Math.min(limit * page, MAX_LIMIT) / limit) : MAX_LIMIT;
-        res.page = Math.min(page, maxPage);
-    }
-    else {
-        res.limit = MAX_LIMIT;
-        res.page = 0;
-    }
-    //* returns.
-    return res;
-}
-/**
- * common tools for transformer.
- * - extends the original `$T` in lemon-core.
- */
-exports.$T = {
-    ...helpers_1.$T,
-    /** clear white-spaces and trim */
-    S2: (v, def) => helpers_1.$T.S2(v, def, ' ').trim(),
-    /** array string with clear white-spaces and trim */
-    SS: (v) => (v && Array.isArray(v) ? v : helpers_1.$T.SS(v)).map(v => helpers_1.$T.S2(v, '', ' ').trim()),
-    /** remove duplicates from string array using reduce */
-    US: (arr) => arr?.reduce((acc, v) => {
-        if (!acc.includes(v))
-            acc.push(v);
-        return acc;
-    }, []) ?? [],
-    /** convert to `boolean`. */
-    B: (v, def) => typeof v === 'boolean'
-        ? v
-        : typeof v === 'number' || typeof v === 'string'
-            ? Boolean(exports.$T.BN(v, typeof def === 'boolean' ? (def ? 1 : 0) : def))
-            : Boolean(def),
-    /** convert to boolean style number. */
-    BN: (v, def) => (v === undefined ? def : _B(v, def)),
-    /** convert to `number` */
-    N: (v, def = 0) => typeof v === 'boolean' ? (v ? 1 : 0) : typeof v === 'number' || typeof v === 'string' ? helpers_1.$T.N(v, def) : def,
-    // /** convert to `float` w/ fixed(3) */
-    // F: (n: number, def?: number) => _T.F3(n, def),
-    /** cleanup if in undefined */
-    clear: (N) => Object.entries(N).reduce((N, [k, v]) => {
-        if (v !== undefined)
-            N[k] = v;
-        return N;
-    }, {}),
-    /** null to string */
-    nul2str: (v) => {
-        if (v === undefined)
-            return undefined;
-        return helpers_1.$T.S(v ?? '');
-    },
-    /**
-     * find key in LUT table.
-     */
-    asLut: (key, $map, options) => {
-        const $opts = typeof options === 'string' ? { name: options } : options;
-        const name = $opts?.name ?? 'name';
-        const throwable = $opts?.throwable ?? true;
-        const _def = $opts?.default ?? null;
-        const errScope = $opts?.errScope ?? `asLut(${name ?? ''})`;
-        //* check of empty.
-        if (key === undefined)
-            return undefined;
-        if (key === null)
-            return _def;
-        //* check if key is defined.
-        if (typeof $map[key] === 'undefined') {
-            //* lookup by value.
-            const foundEntry = Object.entries($map).find(([k, v]) => v === key);
-            if (foundEntry)
-                return foundEntry[0];
-            //! throw or default
-            if (!throwable)
-                return _def;
-            if (errScope)
-                throw new Error(`.${name}[${key}] is invalid key - ${errScope}`);
-            throw new Error(`.${name}[${key}] is invalid!`);
-        }
-        return key;
-    },
-    /**
-     * pack as meta in general-type.
-     */
-    asMeta: (body, options) => {
-        const errScope = options?.errScope ?? '';
-        if (!body)
-            return {};
-        if (typeof body !== 'object')
-            throw new Error(`@body (object) is required ${errScope}`.trim());
-        const isVal = (v) => typeof v === 'number' || typeof v === 'string';
-        const res = Object.entries(body).reduce((R, [k, v]) => {
-            if (isVal(v))
-                R[k] = v;
-            else if (v && Array.isArray(v))
-                R[k] = v.filter(v => isVal(v));
-            return R;
-        }, {});
-        return res;
-    },
-    /**
-     * reduce aggregation from ES6
-     * NOTE - 이거 반드시 최신꺼로 업데이트 필요함 @steve/250212
-     */
-    reduceAggr: ($aggr) => Object.keys($aggr).reduce((M, key) => {
-        const N = $aggr[key];
-        if (key == 'doc_count' && typeof N == 'number') {
-            M['doc_count'] = { total: N };
-            return M;
-        }
-        M[key] = Object.keys(N).reduce((M, x) => {
-            const Y = N[x];
-            if (x == 'doc_count')
-                M['total'] = exports.$T.N(Y, 0);
-            if (x == 'buckets' && Array.isArray(Y))
-                return Y.reduce((M, N) => {
-                    if (typeof N?.key === 'string' && typeof N?.doc_count === 'number') {
-                        M[N?.key] = N.doc_count;
-                    }
-                    return M;
-                }, M);
-            return M;
-        }, {});
-        return M;
-    }, {}),
-};
+//* v5 B3: the single `$T` (32 members) lives in `helpers/helpers.ts`; re-exported to keep the L2 barrel and deep path.
+var helpers_1 = require("../../helpers/");
+Object.defineProperty(exports, "$T", { enumerable: true, get: function () { return helpers_1.$T; } });
+//* v5 B3: the parsers were verbatim copies of the `helpers/helpers.ts` ones; re-exported for the same reason.
+var helpers_2 = require("../../helpers/");
+Object.defineProperty(exports, "parseListParam", { enumerable: true, get: function () { return helpers_2.parseListParam; } });
+Object.defineProperty(exports, "parsePaginateParam", { enumerable: true, get: function () { return helpers_2.parsePaginateParam; } });
+//* v5 B3: the copy was text-identical to the test-helper one (the root already used that); re-exported.
+var test_helper_1 = require("../../common/test-helper");
+Object.defineProperty(exports, "onlyDefined", { enumerable: true, get: function () { return test_helper_1.onlyDefined; } });
 //# sourceMappingURL=commons.js.map

package/dist/extended/cores/commons.js.map

@@ -1 +1 @@
-{"version":3,"file":"commons.js","sourceRoot":"","sources":["../../../src/extended/cores/commons.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commons.js","sourceRoot":"","sources":["../../../src/extended/cores/commons.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,uHAAuH;AACvH,0CAAoC;AAA3B,6FAAA,EAAE,OAAA;AACX,8GAA8G;AAC9G,0CAAoE;AAA3D,yGAAA,cAAc,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAC3C,wGAAwG;AACxG,wDAAuD;AAA9C,0GAAA,WAAW,OAAA"}

package/dist/extended/cores/types.d.ts

@@ -4,233 +4,11 @@
  *
  * @author      Steve <steve@lemoncloud.io>
  * @date        2022-06-21 optimized w/ `abstract-services`
- * @date        2022-06-28 added `Codable` interface for general types.
- * @date        2023-01-18 optimized with `lemon-core@3.2.4`
- * @date        2023-02-15 optimized with `lemon-core@3.2.5`
  * @date        2024-11-14 optimized `IdentityToken`.
+ * @date        2026-10-28 v5 B3: re-export only — the single definition lives in `helpers/types.ts`.
  *
  * @copyright   (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
  * @origin      `@lemoncloud/lemon-templates-api/cores`
  */
-import { NextIdentity, CoreModel, View, Body } from 'lemon-model';
-export type { CoreModel, View, Body };
-/** type: `IdentityTokenSite` */
-export interface IdentityTokenSite {
-    /** site-code (ex: kwonsun) */
-    code?: string;
-    /** name of site (ex: 권선) */
-    name?: string;
-}
-/** type: `IdentityTokenUser` */
-export interface IdentityTokenUser {
-    /** name of user (ex: 홍길동) */
-    name?: string;
-    /** nick of user (ex: 홍사마) */
-    nick?: string;
-    /** (optional) login-id of user */
-    login?: string;
-    /** (optional) email of user */
-    email?: string;
-}
-/** type: `IdentityTokenGroup` */
-export interface IdentityTokenGroup {
-    /** site-code (ex: kwonsun) */
-    code?: string;
-    /** name of site (ex: 권선) */
-    name?: string;
-}
-/**
- * type: `IdentityToken` (named as `session`)
- * - 계정토큰(= JWT(IdentityToken))으로, `/refresh`시 AWS Key와 함께 발급됨 (기본, 1일동안 유효함)
- * - `backend-api`에서 조직/그룹/사용자에 맞게 재설정됨!
- * - 세션토큰 검사는 `proxy.getCurrentSession()` 이용하기
- */
-export interface IdentityToken<T = any, U extends IdentityTokenUser = IdentityTokenUser, S extends IdentityTokenSite = IdentityTokenSite, G extends IdentityTokenGroup = IdentityTokenGroup> extends NextIdentity<T> {
-    /**
-     * cloud-id (= id in `AWS ACCOUNT_NO`)
-     * - `#` 일경우, 무시됨.
-     * - aws 계정 수준의 cloud-id
-     */
-    cid: string;
-    /**
-     * site-id (= id in `SiteModel(사이트)`)
-     * - `#` 일경우, 특정 site에 엮이지 않음 (무시됨)
-     * - `0000` 일경우, 기본 site 정보로 환경설정에 따름
-     * - 메인 `backend-api` (see `.iss`)에서 관리되는 `site-model`의 id
-     *
-     * @see SiteModel
-     */
-    sid: string;
-    /**
-     * group-id (= id in `GroupModel(그룹)`)
-     * - `group`은 `user`를 물리적 구분으로 나눠서 생각해볼때 이용가능함.
-     *
-     * @see GroupModel
-     */
-    gid: string;
-    /**
-     * user-id (= id in `UserModel(유저)`)
-     * - 메인 `backend-api` (see `.iss`)에서 관리되는 `user-model`의 id.
-     *
-     * @see UserModel
-     */
-    uid: string;
-    /**
-     * auth-id (= id in `AuthModel(인정정보)`)
-     * - 메인 `backend-api` (see `.iss`)에서 관리되는 `auth-model`의 id.
-     * - 인증 정보를 통해서, 로그인의 추가 상세 정보를 알 수 있음.
-     *
-     * @see AuthModel
-     */
-    aid: string;
-    /**
-     * (optional) delegator-id (= 위임된 게스트 User ID)
-     * - **중계서버(`backend-api`)에서만 유효한 필드.** 다른 시스템(socials 등)은 이 필드를 신뢰하지 말 것.
-     * - 소셜 로그인 세션에서 원본 디바이스 게스트 User ID를 가리킴 (= `AuthModel.linkUserId`).
-     * - 채팅(개인 채팅방) 도메인은 본 신원이 아닌 `did`를 채택하여 게스트의 데이터를 그대로 이용함.
-     * - 게스트 세션이거나 위임이 없을 때는 `undefined`.
-     */
-    did?: string;
-    /**
-     * list of roles  (like `user`, `admin`, `super`)
-     */
-    roles: string[];
-    /**
-     * (optional) internal `identity-id` (= delegated identity)
-     * - `.identityId` 는 aws cognito 인증을 통해서, 현재 인증된 `identity-id`를 알 수 있음
-     * - 다만, `delegated`된 경우에는 위임된 id 가 들어감.
-     *
-     * @deprecated 삭제될 예정! @241114
-     */
-    iid?: string;
-    /**
-     * service-name of issuer
-     * ex) `lemon-backend-api`
-     */
-    iss?: string;
-    /** Site Info */
-    Site: S;
-    /** User Info */
-    User: U;
-    /** (optional) Group Info */
-    Group?: G;
-}
-/**
- * type `ListResult`
- */
-export interface ListResult<T, R = any> {
-    /**
-     * total searched count
-     */
-    total?: number;
-    /**
-     * max items count in the page
-     */
-    limit?: number;
-    /**
-     * current page number.
-     */
-    page?: number;
-    /**
-     * (optional) time took in sec
-     */
-    took?: number;
-    /**
-     * items searched
-     */
-    list: T[];
-    /**
-     * (optional) aggr list
-     */
-    aggr?: R | R[];
-}
-export interface AggrResult {
-    [key: string]: {
-        [key: string]: number;
-    };
-}
-export interface AggrKeyCount {
-    /** name of key(or bucket name) */
-    key: string;
-    /** number of count */
-    val: number;
-}
-/**
- * type `PaginatedListResult`
- */
-export interface PaginatedListResult<T, R = string> extends ListResult<T, R> {
-    /**
-     * current page
-     */
-    page: number;
-}
-/**
- * type `ListParam`
- */
-export interface ListParam {
-    /**
-     * max items count to be fetched
-     */
-    limit?: number;
-    /**
-     * (optional) sorting order
-     *  - 'asc': older first
-     *  - 'desc': newer first
-     *  - string: extended sorting features
-     */
-    sort?: 'asc' | 'desc' | string;
-}
-/**
- * type `PaginateParam`
- */
-export interface PaginateParam extends ListParam {
-    /**
-     * page # to fetch (0-indexed)
-     */
-    page?: number;
-    /**
-     * (optional) offset # from start.
-     */
-    offset?: number;
-    /**
-     * (optional) flag to filter by uid
-     */
-    uid?: string;
-    /**
-     * (optional) flag to filter by sid (only for admin role)
-     */
-    sid?: string;
-}
-/**
- * type `BulkUpdateBody`
- */
-export interface BulkUpdateBody<T> extends BulkBody<T> {
-    /**
-     * list bulk update model with id
-     */
-    list: T[];
-}
-/**
- * body data for bulk
- */
-export interface BulkBody<T> {
-    list: T[];
-}
-/**
- * list of the selected model-id
- */
-export interface BodyList<T extends {
-    id: string;
-} = {
-    id: string;
-}> {
-    list: T[];
-}
-/**
- * type `BulkItemsResult`
- */
-export interface BulkItemsResult {
-    success: number;
-    failed: number;
-    failedItems: any[];
-}
+export * from '../../helpers/types';
+export type { CoreModel, View, Body } from 'lemon-model';

package/dist/extended/cores/types.js

@@ -1,3 +1,31 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * `types.ts`
+ * - common types used in `/cores`
+ *
+ * @author      Steve <steve@lemoncloud.io>
+ * @date        2022-06-21 optimized w/ `abstract-services`
+ * @date        2024-11-14 optimized `IdentityToken`.
+ * @date        2026-10-28 v5 B3: re-export only — the single definition lives in `helpers/types.ts`.
+ *
+ * @copyright   (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
+ * @origin      `@lemoncloud/lemon-templates-api/cores`
+ */
+//* v5 B3: keeps the deep path `dist/extended/cores/types` and the L2 barrel names; one definition (`helpers/types.ts`).
+__exportStar(require("../../helpers/types"), exports);
 //# sourceMappingURL=types.js.map

package/dist/extended/cores/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extended/cores/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extended/cores/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,wHAAwH;AACxH,sDAAoC"}

package/dist/helpers/helpers.d.ts

@@ -8,6 +8,7 @@
  * @date        2021-12-21 protocol support `//self` url.
  * @date        2021-12-23 optimize types of $protocol.
  * @date        2022-03-17 addition text processing. (S2, P)
+ * @date        2026-10-28 v5 B3: single `$T` (L1/L2 merged), single `parseListParam`/`parsePaginateParam`.
  *
  * @copyright (C) 2021 LemonCloud Co Ltd. - All Rights Reserved.
  */
@@ -45,13 +46,17 @@ export declare const $T: {
      */
     S: <T extends string = string>(val: any, def?: string) => T;
     /**
-     * as string w/o white-space.
+     * clear white-spaces and trim.
      */
-    S2: <T extends string = string>(val: any, def?: string, delim?: string) => T;
+    S2: <T extends string = string>(v?: any, def?: string) => T;
     /**
-     * transform to string[]
+     * array string with clear white-spaces and trim
      */
-    SS: <T extends string = string>(val: any, def?: T[]) => T[];
+    SS: <T extends string = string>(v?: any) => T[];
+    /**
+     * remove duplicates from string array using reduce
+     */
+    US: <T extends string = string>(arr: T[]) => T[];
     /**
      * text to Plain text (remove html tag)
      */
@@ -59,7 +64,7 @@ export declare const $T: {
     /**
      * transform to number(integer).
      */
-    N: (v?: boolean | number | string, def?: number) => number;
+    N: (v: boolean | number | string | unknown, def?: number) => number;
     /**
      * number array
      */