@yangsaiyam/helper 1.12.3 → 1.12.4

package/dist/job-applications/index.d.ts

@@ -0,0 +1,33 @@
+export declare const JOB_APPLICATION_STATUS: readonly [{
+    readonly key: 0;
+    readonly value: "Pending Review";
+    readonly i18nKey: "jobApplication.status.0";
+}, {
+    readonly key: 1;
+    readonly value: "Shortlisted";
+    readonly i18nKey: "jobApplication.status.1";
+}, {
+    readonly key: 2;
+    readonly value: "Interview";
+    readonly i18nKey: "jobApplication.status.2";
+}, {
+    readonly key: 3;
+    readonly value: "Offered";
+    readonly i18nKey: "jobApplication.status.3";
+}, {
+    readonly key: 4;
+    readonly value: "Hired";
+    readonly i18nKey: "jobApplication.status.4";
+}, {
+    readonly key: 5;
+    readonly value: "Rejected";
+    readonly i18nKey: "jobApplication.status.5";
+}, {
+    readonly key: 6;
+    readonly value: "Withdrawn";
+    readonly i18nKey: "jobApplication.status.6";
+}, {
+    readonly key: 7;
+    readonly value: "Ghosted";
+    readonly i18nKey: "jobApplication.status.7";
+}];

package/dist/job-applications/index.js

@@ -0,0 +1,10 @@
+export const JOB_APPLICATION_STATUS = [
+    { key: 0, value: "Pending Review", i18nKey: "jobApplication.status.0" },
+    { key: 1, value: "Shortlisted", i18nKey: "jobApplication.status.1" },
+    { key: 2, value: "Interview", i18nKey: "jobApplication.status.2" },
+    { key: 3, value: "Offered", i18nKey: "jobApplication.status.3" },
+    { key: 4, value: "Hired", i18nKey: "jobApplication.status.4" },
+    { key: 5, value: "Rejected", i18nKey: "jobApplication.status.5" },
+    { key: 6, value: "Withdrawn", i18nKey: "jobApplication.status.6" },
+    { key: 7, value: "Ghosted", i18nKey: "jobApplication.status.7" },
+];

package/dist/locale/index.d.ts

@@ -0,0 +1,9 @@
+export declare const LOCALE: readonly [{
+    readonly key: 1;
+    readonly value: "en";
+    readonly i18nKey: "locale.en";
+}, {
+    readonly key: 2;
+    readonly value: "zh";
+    readonly i18nKey: "locale.zh";
+}];

package/dist/locale/index.js

@@ -0,0 +1,4 @@
+export const LOCALE = [
+    { key: 1, value: "en", i18nKey: "locale.en" },
+    { key: 2, value: "zh", i18nKey: "locale.zh" },
+];

package/dist/roles/index.d.ts

@@ -0,0 +1,61 @@
+export type CanonicalRole = "super-admin" | "admin" | "staff" | "hr" | "visitor" | "none";
+export type RoleValue = CanonicalRole | number;
+export type RoleInput = RoleValue | string;
+export declare const ROLE_MAP: Record<number, CanonicalRole>;
+export declare const ROLE: readonly [{
+    readonly key: 0;
+    readonly value: "super-admin";
+    readonly i18nKey: "users.roleSuperAdmin";
+}, {
+    readonly key: 1;
+    readonly value: "admin";
+    readonly i18nKey: "users.roleAdmin";
+}, {
+    readonly key: 2;
+    readonly value: "staff";
+    readonly i18nKey: "users.roleStaff";
+}, {
+    readonly key: 3;
+    readonly value: "hr";
+    readonly i18nKey: "users.roleHr";
+}, {
+    readonly key: 32766;
+    readonly value: "visitor";
+    readonly i18nKey: "users.roleVisitor";
+}, {
+    readonly key: 32767;
+    readonly value: "none";
+    readonly i18nKey: "users.roleNone";
+}];
+export declare function normalizeRole(role: RoleInput | undefined): CanonicalRole | undefined;
+export declare function roleLabelKey(role: RoleInput | undefined): string;
+export declare function roleToId(role: RoleInput | undefined): number | undefined;
+export declare const Permission: {
+    readonly ALLOWED_EMAILS_READ: "allowed-emails:read";
+    readonly ALLOWED_EMAILS_WRITE: "allowed-emails:write";
+    readonly USERS_READ: "users:read";
+    readonly USERS_WRITE: "users:write";
+    readonly USERS_DELETE: "users:delete";
+    readonly CAREERS_READ: "careers:read";
+    readonly CAREERS_WRITE: "careers:write";
+    readonly CAREERS_DELETE: "careers:delete";
+    readonly CONTACT_FORM_READ: "contact-form:read";
+    readonly CONTACT_FORM_DELETE: "contact-form:delete";
+    readonly JOB_APPLICATIONS_READ: "job-applications:read";
+    readonly OTP_ATTEMPTS_READ: "otp-attempts:read";
+    readonly OTP_ATTEMPTS_WRITE: "otp-attempts:write";
+    readonly TWO_FACTOR_AUTH_READ: "two-factor-auth:read";
+    readonly TWO_FACTOR_AUTH_WRITE: "two-factor-auth:write";
+    readonly VIEWS_READ: "views:read";
+    readonly LOGS_READ: "logs:read";
+    readonly UTM_RECORDS_READ: "utm-records:read";
+    readonly UTM_RECORDS_WRITE: "utm-records:write";
+    readonly ORIGIN_READ: "origin:read";
+    readonly ORIGIN_WRITE: "origin:write";
+    readonly ORIGIN_DELETE: "origin:delete";
+};
+export type Permission = (typeof Permission)[keyof typeof Permission];
+export declare const PERMISSION_I18N_KEY: Record<Permission, string>;
+export declare const ROLE_PERMISSIONS: Record<CanonicalRole, Permission[]>;
+export declare function hasPermission(role: RoleInput | undefined, permission: Permission): boolean;
+export declare function permissionLabelKey(permission: Permission): string;

package/dist/roles/index.js

@@ -0,0 +1,170 @@
+export const ROLE_MAP = {
+    0: "super-admin",
+    1: "admin",
+    2: "staff",
+    3: "hr",
+    32766: "visitor",
+    32767: "none",
+};
+export const ROLE = [
+    { key: 0, value: "super-admin", i18nKey: "users.roleSuperAdmin" },
+    { key: 1, value: "admin", i18nKey: "users.roleAdmin" },
+    { key: 2, value: "staff", i18nKey: "users.roleStaff" },
+    { key: 3, value: "hr", i18nKey: "users.roleHr" },
+    { key: 32766, value: "visitor", i18nKey: "users.roleVisitor" },
+    { key: 32767, value: "none", i18nKey: "users.roleNone" },
+];
+export function normalizeRole(role) {
+    if (typeof role === "number") {
+        return ROLE_MAP[role];
+    }
+    switch (role) {
+        case "super-admin":
+            return "super-admin";
+        case "admin":
+            return "admin";
+        case "staff":
+            return "staff";
+        case "hr":
+            return "hr";
+        case "visitor":
+            return "visitor";
+        case "none":
+            return "none";
+        default:
+            return undefined;
+    }
+}
+export function roleLabelKey(role) {
+    switch (normalizeRole(role)) {
+        case "super-admin":
+            return "users.roleSuperAdmin";
+        case "admin":
+            return "users.roleAdmin";
+        case "hr":
+            return "users.roleHr";
+        case "staff":
+            return "users.roleStaff";
+        case "visitor":
+            return "users.roleVisitor";
+        case "none":
+            return "users.roleNone";
+        default:
+            return "users.roleStaff";
+    }
+}
+export function roleToId(role) {
+    const normalizedRole = normalizeRole(role);
+    return ROLE.find((option) => option.value === normalizedRole)?.key;
+}
+export const Permission = {
+    ALLOWED_EMAILS_READ: "allowed-emails:read",
+    ALLOWED_EMAILS_WRITE: "allowed-emails:write",
+    USERS_READ: "users:read",
+    USERS_WRITE: "users:write",
+    USERS_DELETE: "users:delete",
+    CAREERS_READ: "careers:read",
+    CAREERS_WRITE: "careers:write",
+    CAREERS_DELETE: "careers:delete",
+    CONTACT_FORM_READ: "contact-form:read",
+    CONTACT_FORM_DELETE: "contact-form:delete",
+    JOB_APPLICATIONS_READ: "job-applications:read",
+    OTP_ATTEMPTS_READ: "otp-attempts:read",
+    OTP_ATTEMPTS_WRITE: "otp-attempts:write",
+    TWO_FACTOR_AUTH_READ: "two-factor-auth:read",
+    TWO_FACTOR_AUTH_WRITE: "two-factor-auth:write",
+    VIEWS_READ: "views:read",
+    LOGS_READ: "logs:read",
+    UTM_RECORDS_READ: "utm-records:read",
+    UTM_RECORDS_WRITE: "utm-records:write",
+    ORIGIN_READ: "origin:read",
+    ORIGIN_WRITE: "origin:write",
+    ORIGIN_DELETE: "origin:delete",
+};
+export const PERMISSION_I18N_KEY = {
+    [Permission.ALLOWED_EMAILS_READ]: "permissions.allowedEmailsRead",
+    [Permission.ALLOWED_EMAILS_WRITE]: "permissions.allowedEmailsWrite",
+    [Permission.USERS_READ]: "permissions.usersRead",
+    [Permission.USERS_WRITE]: "permissions.usersWrite",
+    [Permission.USERS_DELETE]: "permissions.usersDelete",
+    [Permission.CAREERS_READ]: "permissions.careersRead",
+    [Permission.CAREERS_WRITE]: "permissions.careersWrite",
+    [Permission.CAREERS_DELETE]: "permissions.careersDelete",
+    [Permission.CONTACT_FORM_READ]: "permissions.contactFormRead",
+    [Permission.CONTACT_FORM_DELETE]: "permissions.contactFormDelete",
+    [Permission.JOB_APPLICATIONS_READ]: "permissions.jobApplicationsRead",
+    [Permission.OTP_ATTEMPTS_READ]: "permissions.otpAttemptsRead",
+    [Permission.OTP_ATTEMPTS_WRITE]: "permissions.otpAttemptsWrite",
+    [Permission.TWO_FACTOR_AUTH_READ]: "permissions.twoFactorAuthRead",
+    [Permission.TWO_FACTOR_AUTH_WRITE]: "permissions.twoFactorAuthWrite",
+    [Permission.VIEWS_READ]: "permissions.viewsRead",
+    [Permission.LOGS_READ]: "permissions.logsRead",
+    [Permission.UTM_RECORDS_READ]: "permissions.utmRecordsRead",
+    [Permission.UTM_RECORDS_WRITE]: "permissions.utmRecordsWrite",
+    [Permission.ORIGIN_READ]: "permissions.originRead",
+    [Permission.ORIGIN_WRITE]: "permissions.originWrite",
+    [Permission.ORIGIN_DELETE]: "permissions.originDelete",
+};
+export const ROLE_PERMISSIONS = {
+    "super-admin": [
+        Permission.ALLOWED_EMAILS_READ,
+        Permission.ALLOWED_EMAILS_WRITE,
+        Permission.USERS_READ,
+        Permission.USERS_WRITE,
+        Permission.USERS_DELETE,
+        Permission.CAREERS_READ,
+        Permission.CAREERS_WRITE,
+        Permission.CAREERS_DELETE,
+        Permission.CONTACT_FORM_READ,
+        Permission.CONTACT_FORM_DELETE,
+        Permission.JOB_APPLICATIONS_READ,
+        Permission.OTP_ATTEMPTS_READ,
+        Permission.OTP_ATTEMPTS_WRITE,
+        Permission.TWO_FACTOR_AUTH_READ,
+        Permission.TWO_FACTOR_AUTH_WRITE,
+        Permission.VIEWS_READ,
+        Permission.LOGS_READ,
+        Permission.UTM_RECORDS_READ,
+        Permission.UTM_RECORDS_WRITE,
+        Permission.ORIGIN_READ,
+        Permission.ORIGIN_WRITE,
+        Permission.ORIGIN_DELETE,
+    ],
+    admin: [
+        Permission.ALLOWED_EMAILS_READ,
+        Permission.ALLOWED_EMAILS_WRITE,
+        Permission.USERS_READ,
+        Permission.CAREERS_READ,
+        Permission.CAREERS_WRITE,
+        Permission.CAREERS_DELETE,
+        Permission.CONTACT_FORM_READ,
+        Permission.CONTACT_FORM_DELETE,
+        Permission.JOB_APPLICATIONS_READ,
+        Permission.VIEWS_READ,
+        Permission.LOGS_READ,
+        Permission.UTM_RECORDS_READ,
+        Permission.UTM_RECORDS_WRITE,
+        Permission.ORIGIN_READ,
+        Permission.ORIGIN_WRITE,
+        Permission.ORIGIN_DELETE,
+    ],
+    hr: [
+        Permission.CAREERS_READ,
+        Permission.CAREERS_WRITE,
+        Permission.CAREERS_DELETE,
+        Permission.JOB_APPLICATIONS_READ,
+    ],
+    staff: [Permission.CONTACT_FORM_READ],
+    visitor: [],
+    none: [],
+};
+export function hasPermission(role, permission) {
+    const normalizedRole = normalizeRole(role);
+    if (!normalizedRole) {
+        return false;
+    }
+    return ROLE_PERMISSIONS[normalizedRole].includes(permission);
+}
+export function permissionLabelKey(permission) {
+    return PERMISSION_I18N_KEY[permission];
+}

package/dist/roles/index.test.d.ts

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

package/dist/roles/index.test.js

@@ -0,0 +1,80 @@
+import assert from "node:assert/strict";
+import { PERMISSION_I18N_KEY, Permission, ROLE, ROLE_PERMISSIONS, hasPermission, normalizeRole, permissionLabelKey, roleLabelKey, roleToId, } from "./index.js";
+assert.equal(normalizeRole(0), "super-admin");
+assert.equal(normalizeRole("admin"), "admin");
+assert.equal(normalizeRole(2), "staff");
+assert.equal(normalizeRole("hr"), "hr");
+assert.equal(normalizeRole(32766), "visitor");
+assert.equal(normalizeRole("none"), "none");
+assert.equal(normalizeRole("unknown"), undefined);
+assert.equal(normalizeRole(undefined), undefined);
+assert.equal(roleToId("super-admin"), 0);
+assert.equal(roleToId("admin"), 1);
+assert.equal(roleToId("staff"), 2);
+assert.equal(roleToId("hr"), 3);
+assert.equal(roleToId("visitor"), 32766);
+assert.equal(roleToId("none"), 32767);
+assert.equal(roleToId("unknown"), undefined);
+assert.equal(roleLabelKey(0), "users.roleSuperAdmin");
+assert.equal(roleLabelKey("admin"), "users.roleAdmin");
+assert.equal(roleLabelKey(2), "users.roleStaff");
+assert.equal(roleLabelKey("hr"), "users.roleHr");
+assert.equal(roleLabelKey("visitor"), "users.roleVisitor");
+assert.equal(roleLabelKey("none"), "users.roleNone");
+assert.equal(roleLabelKey(undefined), "users.roleStaff");
+assert.deepEqual(ROLE[0], {
+    key: 0,
+    value: "super-admin",
+    i18nKey: "users.roleSuperAdmin",
+});
+assert.equal(ROLE[3]?.i18nKey, "users.roleHr");
+assert.deepEqual(ROLE[4], {
+    key: 32766,
+    value: "visitor",
+    i18nKey: "users.roleVisitor",
+});
+assert.deepEqual(ROLE[5], {
+    key: 32767,
+    value: "none",
+    i18nKey: "users.roleNone",
+});
+assert.equal(PERMISSION_I18N_KEY[Permission.ALLOWED_EMAILS_READ], "permissions.allowedEmailsRead");
+assert.equal(permissionLabelKey(Permission.CONTACT_FORM_DELETE), "permissions.contactFormDelete");
+assert.equal(permissionLabelKey(Permission.OTP_ATTEMPTS_READ), "permissions.otpAttemptsRead");
+assert.equal(permissionLabelKey(Permission.TWO_FACTOR_AUTH_WRITE), "permissions.twoFactorAuthWrite");
+assert.equal(permissionLabelKey(Permission.VIEWS_READ), "permissions.viewsRead");
+assert.equal(permissionLabelKey(Permission.LOGS_READ), "permissions.logsRead");
+assert.equal(permissionLabelKey(Permission.UTM_RECORDS_READ), "permissions.utmRecordsRead");
+assert.equal(permissionLabelKey(Permission.UTM_RECORDS_WRITE), "permissions.utmRecordsWrite");
+assert.equal(permissionLabelKey(Permission.ORIGIN_READ), "permissions.originRead");
+assert.equal(permissionLabelKey(Permission.ORIGIN_WRITE), "permissions.originWrite");
+assert.equal(permissionLabelKey(Permission.ORIGIN_DELETE), "permissions.originDelete");
+assert.ok(ROLE_PERMISSIONS["super-admin"].includes(Permission.USERS_DELETE));
+assert.ok(ROLE_PERMISSIONS["super-admin"].includes(Permission.OTP_ATTEMPTS_READ));
+assert.ok(ROLE_PERMISSIONS["super-admin"].includes(Permission.TWO_FACTOR_AUTH_WRITE));
+assert.ok(ROLE_PERMISSIONS["super-admin"].includes(Permission.VIEWS_READ));
+assert.ok(ROLE_PERMISSIONS["super-admin"].includes(Permission.LOGS_READ));
+assert.ok(ROLE_PERMISSIONS["super-admin"].includes(Permission.UTM_RECORDS_WRITE));
+assert.ok(ROLE_PERMISSIONS["super-admin"].includes(Permission.ORIGIN_DELETE));
+assert.ok(ROLE_PERMISSIONS.admin.includes(Permission.CONTACT_FORM_DELETE));
+assert.ok(ROLE_PERMISSIONS.admin.includes(Permission.VIEWS_READ));
+assert.ok(ROLE_PERMISSIONS.admin.includes(Permission.LOGS_READ));
+assert.ok(ROLE_PERMISSIONS.admin.includes(Permission.UTM_RECORDS_WRITE));
+assert.ok(ROLE_PERMISSIONS.admin.includes(Permission.ORIGIN_DELETE));
+assert.equal(ROLE_PERMISSIONS.admin.includes(Permission.USERS_WRITE), false);
+assert.ok(ROLE_PERMISSIONS.hr.includes(Permission.JOB_APPLICATIONS_READ));
+assert.deepEqual(ROLE_PERMISSIONS.staff, [Permission.CONTACT_FORM_READ]);
+assert.deepEqual(ROLE_PERMISSIONS.visitor, []);
+assert.deepEqual(ROLE_PERMISSIONS.none, []);
+assert.equal(hasPermission("super-admin", Permission.USERS_WRITE), true);
+assert.equal(hasPermission("super-admin", Permission.OTP_ATTEMPTS_WRITE), true);
+assert.equal(hasPermission(1, Permission.USERS_WRITE), false);
+assert.equal(hasPermission("hr", Permission.CAREERS_WRITE), true);
+assert.equal(hasPermission("staff", Permission.CAREERS_WRITE), false);
+assert.equal(hasPermission("staff", Permission.CONTACT_FORM_READ), true);
+assert.equal(hasPermission("admin", Permission.VIEWS_READ), true);
+assert.equal(hasPermission("admin", Permission.UTM_RECORDS_WRITE), true);
+assert.equal(hasPermission("admin", Permission.ORIGIN_DELETE), true);
+assert.equal(hasPermission("visitor", Permission.VIEWS_READ), false);
+assert.equal(hasPermission(32767, Permission.LOGS_READ), false);
+assert.equal(hasPermission(undefined, Permission.CAREERS_READ), false);

package/dist/routes/index.d.ts

@@ -0,0 +1,80 @@
+export type RouteKey = "home" | "about" | "career" | "careerDetail" | "careerApply" | "careerAssessment" | "contact" | "services" | "servicesAdvertisingPlatform" | "servicesMcnBusiness" | "servicesSoftwareDevelopment";
+export type RouteMapping = {
+    key: RouteKey;
+    path: string;
+    path_name: string;
+    path_key: string;
+    i18nKey: string;
+};
+export declare const ROUTES: readonly [{
+    readonly key: "home";
+    readonly path: "/[locale]";
+    readonly path_name: "/";
+    readonly path_key: "/";
+    readonly i18nKey: "routes.home";
+}, {
+    readonly key: "about";
+    readonly path: "/[locale]/about";
+    readonly path_name: "/about";
+    readonly path_key: "/about";
+    readonly i18nKey: "routes.about";
+}, {
+    readonly key: "career";
+    readonly path: "/[locale]/career";
+    readonly path_name: "/career";
+    readonly path_key: "/career";
+    readonly i18nKey: "routes.career";
+}, {
+    readonly key: "careerDetail";
+    readonly path: "/[locale]/career/[id]";
+    readonly path_name: "/career/[id]";
+    readonly path_key: "/career/[id]";
+    readonly i18nKey: "routes.careerDetail";
+}, {
+    readonly key: "careerApply";
+    readonly path: "/[locale]/career/[id]/apply";
+    readonly path_name: "/career/[id]/apply";
+    readonly path_key: "/career/[id]/apply";
+    readonly i18nKey: "routes.careerApply";
+}, {
+    readonly key: "careerAssessment";
+    readonly path: "/[locale]/career/[id]/apply/assessment";
+    readonly path_name: "/career/[id]/apply/assessment";
+    readonly path_key: "/career/[id]/apply/assessment";
+    readonly i18nKey: "routes.careerAssessment";
+}, {
+    readonly key: "contact";
+    readonly path: "/[locale]/contact";
+    readonly path_name: "/contact";
+    readonly path_key: "/contact";
+    readonly i18nKey: "routes.contact";
+}, {
+    readonly key: "services";
+    readonly path: "/[locale]/services";
+    readonly path_name: "/services";
+    readonly path_key: "/services";
+    readonly i18nKey: "routes.services";
+}, {
+    readonly key: "servicesAdvertisingPlatform";
+    readonly path: "/[locale]/services/advertising-platform";
+    readonly path_name: "/services/advertising-platform";
+    readonly path_key: "/services/advertising-platform";
+    readonly i18nKey: "routes.servicesAdvertisingPlatform";
+}, {
+    readonly key: "servicesMcnBusiness";
+    readonly path: "/[locale]/services/mcn-business";
+    readonly path_name: "/services/mcn-business";
+    readonly path_key: "/services/mcn-business";
+    readonly i18nKey: "routes.servicesMcnBusiness";
+}, {
+    readonly key: "servicesSoftwareDevelopment";
+    readonly path: "/[locale]/services/software-development";
+    readonly path_name: "/services/software-development";
+    readonly path_key: "/services/software-development";
+    readonly i18nKey: "routes.servicesSoftwareDevelopment";
+}];
+export declare const ROUTE: Record<RouteKey, string>;
+export declare function routeLabelKey(route: RouteKey): string;
+export declare function routePathKey(route: RouteKey): string;
+export declare function buildRoutePathName(route: RouteKey, params?: Partial<Record<"id", string | number>>): string;
+export declare function buildLocalizedRoute(route: RouteKey, locale: string, params?: Partial<Record<"id", string | number>>): string;

package/dist/routes/index.js

@@ -0,0 +1,106 @@
+export const ROUTES = [
+    {
+        key: "home",
+        path: "/[locale]",
+        path_name: "/",
+        path_key: "/",
+        i18nKey: "routes.home",
+    },
+    {
+        key: "about",
+        path: "/[locale]/about",
+        path_name: "/about",
+        path_key: "/about",
+        i18nKey: "routes.about",
+    },
+    {
+        key: "career",
+        path: "/[locale]/career",
+        path_name: "/career",
+        path_key: "/career",
+        i18nKey: "routes.career",
+    },
+    {
+        key: "careerDetail",
+        path: "/[locale]/career/[id]",
+        path_name: "/career/[id]",
+        path_key: "/career/[id]",
+        i18nKey: "routes.careerDetail",
+    },
+    {
+        key: "careerApply",
+        path: "/[locale]/career/[id]/apply",
+        path_name: "/career/[id]/apply",
+        path_key: "/career/[id]/apply",
+        i18nKey: "routes.careerApply",
+    },
+    {
+        key: "careerAssessment",
+        path: "/[locale]/career/[id]/apply/assessment",
+        path_name: "/career/[id]/apply/assessment",
+        path_key: "/career/[id]/apply/assessment",
+        i18nKey: "routes.careerAssessment",
+    },
+    {
+        key: "contact",
+        path: "/[locale]/contact",
+        path_name: "/contact",
+        path_key: "/contact",
+        i18nKey: "routes.contact",
+    },
+    {
+        key: "services",
+        path: "/[locale]/services",
+        path_name: "/services",
+        path_key: "/services",
+        i18nKey: "routes.services",
+    },
+    {
+        key: "servicesAdvertisingPlatform",
+        path: "/[locale]/services/advertising-platform",
+        path_name: "/services/advertising-platform",
+        path_key: "/services/advertising-platform",
+        i18nKey: "routes.servicesAdvertisingPlatform",
+    },
+    {
+        key: "servicesMcnBusiness",
+        path: "/[locale]/services/mcn-business",
+        path_name: "/services/mcn-business",
+        path_key: "/services/mcn-business",
+        i18nKey: "routes.servicesMcnBusiness",
+    },
+    {
+        key: "servicesSoftwareDevelopment",
+        path: "/[locale]/services/software-development",
+        path_name: "/services/software-development",
+        path_key: "/services/software-development",
+        i18nKey: "routes.servicesSoftwareDevelopment",
+    },
+];
+export const ROUTE = Object.fromEntries(ROUTES.map((route) => [route.key, route.path]));
+export function routeLabelKey(route) {
+    return ROUTES.find((item) => item.key === route)?.i18nKey ?? "routes.home";
+}
+export function routePathKey(route) {
+    return ROUTES.find((item) => item.key === route)?.path_key ?? "/";
+}
+export function buildRoutePathName(route, params = {}) {
+    let pathName = ROUTES.find((item) => item.key === route)?.path_name ?? "/";
+    if (pathName.includes("[id]")) {
+        if (params.id === undefined || params.id === null) {
+            throw new Error(`Route "${route}" requires an id parameter.`);
+        }
+        pathName = pathName.replace("[id]", encodeURIComponent(String(params.id)));
+    }
+    return pathName;
+}
+export function buildLocalizedRoute(route, locale, params = {}) {
+    let path = ROUTE[route].replace("[locale]", encodeURIComponent(locale));
+    if (path.includes("[id]")) {
+        if (params.id === undefined || params.id === null) {
+            throw new Error(`Route "${route}" requires an id parameter.`);
+        }
+        path = path.replace("[id]", encodeURIComponent(String(params.id)));
+    }
+    return path;
+}

package/dist/routes/index.test.d.ts

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

package/dist/routes/index.test.js

@@ -0,0 +1,92 @@
+import assert from "node:assert/strict";
+import { ROUTE, ROUTES, buildRoutePathName, buildLocalizedRoute, routeLabelKey, routePathKey, } from "./index.js";
+assert.deepEqual(ROUTES, [
+    {
+        key: "home",
+        path: "/[locale]",
+        path_name: "/",
+        path_key: "/",
+        i18nKey: "routes.home",
+    },
+    {
+        key: "about",
+        path: "/[locale]/about",
+        path_name: "/about",
+        path_key: "/about",
+        i18nKey: "routes.about",
+    },
+    {
+        key: "career",
+        path: "/[locale]/career",
+        path_name: "/career",
+        path_key: "/career",
+        i18nKey: "routes.career",
+    },
+    {
+        key: "careerDetail",
+        path: "/[locale]/career/[id]",
+        path_name: "/career/[id]",
+        path_key: "/career/[id]",
+        i18nKey: "routes.careerDetail",
+    },
+    {
+        key: "careerApply",
+        path: "/[locale]/career/[id]/apply",
+        path_name: "/career/[id]/apply",
+        path_key: "/career/[id]/apply",
+        i18nKey: "routes.careerApply",
+    },
+    {
+        key: "careerAssessment",
+        path: "/[locale]/career/[id]/apply/assessment",
+        path_name: "/career/[id]/apply/assessment",
+        path_key: "/career/[id]/apply/assessment",
+        i18nKey: "routes.careerAssessment",
+    },
+    {
+        key: "contact",
+        path: "/[locale]/contact",
+        path_name: "/contact",
+        path_key: "/contact",
+        i18nKey: "routes.contact",
+    },
+    {
+        key: "services",
+        path: "/[locale]/services",
+        path_name: "/services",
+        path_key: "/services",
+        i18nKey: "routes.services",
+    },
+    {
+        key: "servicesAdvertisingPlatform",
+        path: "/[locale]/services/advertising-platform",
+        path_name: "/services/advertising-platform",
+        path_key: "/services/advertising-platform",
+        i18nKey: "routes.servicesAdvertisingPlatform",
+    },
+    {
+        key: "servicesMcnBusiness",
+        path: "/[locale]/services/mcn-business",
+        path_name: "/services/mcn-business",
+        path_key: "/services/mcn-business",
+        i18nKey: "routes.servicesMcnBusiness",
+    },
+    {
+        key: "servicesSoftwareDevelopment",
+        path: "/[locale]/services/software-development",
+        path_name: "/services/software-development",
+        path_key: "/services/software-development",
+        i18nKey: "routes.servicesSoftwareDevelopment",
+    },
+]);
+assert.equal(ROUTE.home, "/[locale]");
+assert.equal(ROUTE.careerAssessment, "/[locale]/career/[id]/apply/assessment");
+assert.equal(buildLocalizedRoute("careerApply", "en", { id: "frontend-engineer" }), "/en/career/frontend-engineer/apply");
+assert.equal(buildLocalizedRoute("servicesMcnBusiness", "zh"), "/zh/services/mcn-business");
+assert.equal(buildRoutePathName("careerApply", { id: "frontend-engineer" }), "/career/frontend-engineer/apply");
+assert.equal(routePathKey("home"), "/");
+assert.equal(routePathKey("careerApply"), "/career/[id]/apply");
+assert.throws(() => buildLocalizedRoute("careerDetail", "en"), {
+    message: 'Route "careerDetail" requires an id parameter.',
+});
+assert.equal(routeLabelKey("servicesSoftwareDevelopment"), "routes.servicesSoftwareDevelopment");

package/dist/shared/helpers.d.ts

@@ -0,0 +1,5 @@
+import type { MappingOption } from "./types.js";
+export declare function getOptionByKey<T extends MappingOption>(options: readonly T[], key?: number | null): T | undefined;
+export declare function getLabelByKey<T extends MappingOption>(options: readonly T[], key?: number | null, fallback?: string): string;
+export declare function getI18nKeyByKey<T extends MappingOption>(options: readonly T[], key?: number | null, fallback?: string): string;
+export declare function toRecord<T extends MappingOption>(options: readonly T[]): Record<number, string>;