@uityu/uityu-shared 1.0.0

package/README.md

@@ -0,0 +1,45 @@
+**Edit a file, create a new file, and clone from Bitbucket in under 2 minutes**
+
+When you're done, you can delete the content in this README and update the file with details for others getting started with your repository.
+
+*We recommend that you open this README in another tab as you perform the tasks below. You can [watch our video](https://youtu.be/0ocf7u76WSo) for a full demo of all the steps in this tutorial. Open the video in a new tab to avoid leaving Bitbucket.*
+
+---
+
+## Edit a file
+
+You’ll start by editing this README file to learn how to edit a file in Bitbucket.
+
+1. Click **Source** on the left side.
+2. Click the README.md link from the list of files.
+3. Click the **Edit** button.
+4. Delete the following text: *Delete this line to make a change to the README from Bitbucket.*
+5. After making your change, click **Commit** and then **Commit** again in the dialog. The commit page will open and you’ll see the change you just made.
+6. Go back to the **Source** page.
+
+---
+
+## Create a file
+
+Next, you’ll add a new file to this repository.
+
+1. Click the **New file** button at the top of the **Source** page.
+2. Give the file a filename of **contributors.txt**.
+3. Enter your name in the empty file space.
+4. Click **Commit** and then **Commit** again in the dialog.
+5. Go back to the **Source** page.
+
+Before you move on, go ahead and explore the repository. You've already seen the **Source** page, but check out the **Commits**, **Branches**, and **Settings** pages.
+
+---
+
+## Clone a repository
+
+Use these steps to clone from SourceTree, our client for using the repository command-line free. Cloning allows you to work on your files locally. If you don't yet have SourceTree, [download and install first](https://www.sourcetreeapp.com/). If you prefer to clone from the command line, see [Clone a repository](https://confluence.atlassian.com/x/4whODQ).
+
+1. You’ll see the clone button under the **Source** heading. Click that button.
+2. Now click **Check out in SourceTree**. You may need to create a SourceTree account or log in.
+3. When you see the **Clone New** dialog in SourceTree, update the destination path and name if you’d like to and then click **Clone**.
+4. Open the directory you just created to see your repository’s files.
+
+Now that you're more familiar with your Bitbucket repository, go ahead and add a new file locally. You can [push your change back to Bitbucket with SourceTree](https://confluence.atlassian.com/x/iqyBMg), or you can [add, commit,](https://confluence.atlassian.com/x/8QhODQ) and [push from the command line](https://confluence.atlassian.com/x/NQ0zDQ).

package/dist/errores/app-error.d.ts

@@ -0,0 +1,7 @@
+import type { ErrorCode } from "./error-codes";
+export declare class AppError extends Error {
+    code: ErrorCode;
+    status: number;
+    errors: Record<string, string>;
+    constructor(code: ErrorCode, message?: string, status?: number, errors?: Record<string, string>);
+}

package/dist/errores/app-error.js

@@ -0,0 +1,12 @@
+export class AppError extends Error {
+    code;
+    status;
+    errors;
+    constructor(code, message, status = 400, errors = {}) {
+        super(message ?? code);
+        this.code = code;
+        this.status = status;
+        this.errors = errors;
+        this.name = "AppError";
+    }
+}

package/dist/errores/error-codes.d.ts

@@ -0,0 +1,9 @@
+export declare const ErrorCode: {
+    readonly VALIDATION: "validation";
+    readonly UNAUTHORIZED: "unauthorized";
+    readonly FORBIDDEN: "forbidden";
+    readonly NOT_FOUND: "not-found";
+    readonly CONFLICT: "conflict";
+    readonly INTERNAL: "internal";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];

package/dist/errores/error-codes.js

@@ -0,0 +1,8 @@
+export const ErrorCode = {
+    VALIDATION: "validation",
+    UNAUTHORIZED: "unauthorized",
+    FORBIDDEN: "forbidden",
+    NOT_FOUND: "not-found",
+    CONFLICT: "conflict",
+    INTERNAL: "internal",
+};

package/dist/errors/app-error.d.ts

@@ -0,0 +1,6 @@
+export declare class AppError extends Error {
+    code: string;
+    status: number;
+    errors: Record<string, string>;
+    constructor(code: string, message?: string, status?: number, errors?: Record<string, string>);
+}

package/dist/errors/app-error.factory.d.ts

@@ -0,0 +1,63 @@
+import { AppError } from "./app-error";
+export type AppErrorFactoryOptions = {
+    message?: string;
+    status?: number;
+    errors?: Record<string, string>;
+};
+export declare const AppErrorFactory: {
+    authRequired: (options?: AppErrorFactoryOptions) => AppError;
+    badRequest: (options?: AppErrorFactoryOptions) => AppError;
+    channelExists: (options?: AppErrorFactoryOptions) => AppError;
+    channelNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    config: (field?: string, options?: AppErrorFactoryOptions) => AppError;
+    conflict: (options?: AppErrorFactoryOptions) => AppError;
+    courierDocumentTaken: (options?: AppErrorFactoryOptions) => AppError;
+    courierNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    courierPhoneTaken: (options?: AppErrorFactoryOptions) => AppError;
+    customerNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    forbidden: (options?: AppErrorFactoryOptions) => AppError;
+    invalidJson: (options?: AppErrorFactoryOptions) => AppError;
+    invalidReport: (options?: AppErrorFactoryOptions) => AppError;
+    invalidState: (options?: AppErrorFactoryOptions) => AppError;
+    inviteRevoked: (options?: AppErrorFactoryOptions) => AppError;
+    loginStrategiesMissing: (options?: AppErrorFactoryOptions) => AppError;
+    loginUnsupportedProvider: (provider?: string, options?: AppErrorFactoryOptions) => AppError;
+    noItems: (options?: AppErrorFactoryOptions) => AppError;
+    notFound: (options?: AppErrorFactoryOptions) => AppError;
+    notificationNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    parameterExists: (options?: AppErrorFactoryOptions) => AppError;
+    parameterNotFound: (field?: string, options?: AppErrorFactoryOptions) => AppError;
+    productExists: (options?: AppErrorFactoryOptions) => AppError;
+    productNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    serviceExists: (options?: AppErrorFactoryOptions) => AppError;
+    serviceNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    sunatApiError: (options?: AppErrorFactoryOptions) => AppError;
+    sunatAuthError: (options?: AppErrorFactoryOptions) => AppError;
+    sunatAuthFailed: (message?: string, options?: AppErrorFactoryOptions) => AppError;
+    sunatAuthInvalidResponse: (options?: AppErrorFactoryOptions) => AppError;
+    sunatAuthTimeout: (options?: AppErrorFactoryOptions) => AppError;
+    sunatSettingsNotConfigured: (options?: AppErrorFactoryOptions) => AppError;
+    sunatSettingsNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    sunatTimeout: (options?: AppErrorFactoryOptions) => AppError;
+    systemNavItemNotFound: (itemId?: string, options?: AppErrorFactoryOptions) => AppError;
+    tenantContextConflict: (options?: AppErrorFactoryOptions) => AppError;
+    tenantContextRequired: (options?: AppErrorFactoryOptions) => AppError;
+    tenantContextUnavailable: (options?: AppErrorFactoryOptions) => AppError;
+    tenantForbidden: (options?: AppErrorFactoryOptions) => AppError;
+    tenantMemberAlreadyExists: (options?: AppErrorFactoryOptions) => AppError;
+    tenantMemberNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    tenantMismatch: (options?: AppErrorFactoryOptions) => AppError;
+    tenantNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    tenantRoleImmutable: (options?: AppErrorFactoryOptions) => AppError;
+    tenantRoleNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    tenantSeatsExceeded: (options?: AppErrorFactoryOptions) => AppError;
+    tenantSlugInUse: (options?: AppErrorFactoryOptions) => AppError;
+    ubigeoExists: (options?: AppErrorFactoryOptions) => AppError;
+    ubigeoNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    unauthorized: (options?: AppErrorFactoryOptions) => AppError;
+    userExists: (options?: AppErrorFactoryOptions) => AppError;
+    userInactive: (options?: AppErrorFactoryOptions) => AppError;
+    userNotFound: (options?: AppErrorFactoryOptions) => AppError;
+    validation: (field?: string, options?: AppErrorFactoryOptions) => AppError;
+    internal: (options?: AppErrorFactoryOptions) => AppError;
+};

package/dist/errors/app-error.factory.js

@@ -0,0 +1,65 @@
+import { AppError } from "./app-error";
+import { ErrorCode } from "./error-codes";
+const DEFAULT_ERRORS = {};
+function buildError(code, defaultMessage, defaultStatus, options) {
+    return new AppError(code, options?.message ?? defaultMessage, options?.status ?? defaultStatus, options?.errors ?? DEFAULT_ERRORS);
+}
+export const AppErrorFactory = {
+    authRequired: (options) => buildError(ErrorCode.AUTH_REQUIRED, "El idToken de Google es requerido", 401, options),
+    badRequest: (options) => buildError(ErrorCode.BAD_REQUEST, "Faltan parámetros", 400, options),
+    channelExists: (options) => buildError(ErrorCode.CHANNEL_EXISTS, "El canal ya existe", 409, options),
+    channelNotFound: (options) => buildError(ErrorCode.CHANNEL_NOT_FOUND, "Canal no encontrado", 404, options),
+    config: (field, options) => buildError(ErrorCode.CONFIG, field ? `Falta ${field} para la integración SUNAT` : "Falta un campo para la integración SUNAT", 500, options),
+    conflict: (options) => buildError(ErrorCode.CONFLICT, "El teléfono ya existe", 409, options),
+    courierDocumentTaken: (options) => buildError(ErrorCode.COURIER_DOCUMENT_TAKEN, "El documento ya existe", 409, options),
+    courierNotFound: (options) => buildError(ErrorCode.COURIER_NOT_FOUND, "Courier not found", 404, options),
+    courierPhoneTaken: (options) => buildError(ErrorCode.COURIER_PHONE_TAKEN, "El teléfono ya existe", 409, options),
+    customerNotFound: (options) => buildError(ErrorCode.CUSTOMER_NOT_FOUND, "Cliente no encontrado", 404, options),
+    forbidden: (options) => buildError(ErrorCode.FORBIDDEN, "Actor no autorizado", 403, options),
+    invalidJson: (options) => buildError(ErrorCode.INVALID_JSON, "Body debe ser JSON", 400, options),
+    invalidReport: (options) => buildError(ErrorCode.INVALID_REPORT, "El archivo ZIP está vacío", 409, options),
+    invalidState: (options) => buildError(ErrorCode.INVALID_STATE, "No se pudo resolver tenantId/recipientUid desde Firestore", 500, options),
+    inviteRevoked: (options) => buildError(ErrorCode.INVITE_REVOKED, "La invitación fue revocada", 409, options),
+    loginStrategiesMissing: (options) => buildError(ErrorCode.LOGIN_STRATEGIES_MISSING, "No hay estrategias de autenticación configuradas", 500, options),
+    loginUnsupportedProvider: (provider, options) => buildError(ErrorCode.LOGIN_UNSUPPORTED_PROVIDER, provider
+        ? `Proveedor de login no soportado: ${provider}`
+        : "Proveedor de login no soportado", 400, options),
+    noItems: (options) => buildError(ErrorCode.NO_ITEMS, "La orden debe tener al menos un item", 400, options),
+    notFound: (options) => buildError(ErrorCode.NOT_FOUND, "User not found", 404, options),
+    notificationNotFound: (options) => buildError(ErrorCode.NOTIFICATION_NOT_FOUND, "Notificación no encontrada", 404, options),
+    parameterExists: (options) => buildError(ErrorCode.PARAMETER_EXISTS, "El código de parámetro ya existe", 409, options),
+    parameterNotFound: (field, options) => buildError(ErrorCode.PARAMETER_NOT_FOUND, field ? `El parámetro ${field} es inválido` : "El parámetro es inválido", 400, options),
+    productExists: (options) => buildError(ErrorCode.PRODUCT_EXISTS, "El SKU ya existe", 409, options),
+    productNotFound: (options) => buildError(ErrorCode.PRODUCT_NOT_FOUND, "Producto no encontrado", 404, options),
+    serviceExists: (options) => buildError(ErrorCode.SERVICE_EXISTS, "El servicio ya existe", 409, options),
+    serviceNotFound: (options) => buildError(ErrorCode.SERVICE_NOT_FOUND, "Servicio no encontrado", 404, options),
+    sunatApiError: (options) => buildError(ErrorCode.SUNAT_API_ERROR, "Error inesperado en API de SIRE Compras", 502, options),
+    sunatAuthError: (options) => buildError(ErrorCode.SUNAT_AUTH_ERROR, "Error inesperado al obtener token SUNAT", 502, options),
+    sunatAuthFailed: (message, options) => buildError(ErrorCode.SUNAT_AUTH_FAILED, message ?? "Error de autenticación SUNAT", 500, options),
+    sunatAuthInvalidResponse: (options) => buildError(ErrorCode.SUNAT_AUTH_INVALID_RESPONSE, "SUNAT retornó un formato de token inválido", 502, options),
+    sunatAuthTimeout: (options) => buildError(ErrorCode.SUNAT_AUTH_TIMEOUT, "Tiempo de espera agotado al obtener token SUNAT", 504, options),
+    sunatSettingsNotConfigured: (options) => buildError(ErrorCode.SUNAT_SETTINGS_NOT_CONFIGURED, "Configura las credenciales SUNAT", 404, options),
+    sunatSettingsNotFound: (options) => buildError(ErrorCode.SUNAT_SETTINGS_NOT_FOUND, "Configura las credenciales SUNAT", 404, options),
+    sunatTimeout: (options) => buildError(ErrorCode.SUNAT_TIMEOUT, "Tiempo de espera agotado en API de SIRE Compras", 504, options),
+    systemNavItemNotFound: (itemId, options) => buildError(ErrorCode.SYSTEM_NAV_ITEM_NOT_FOUND, itemId ? `Item de navegación no encontrado: ${itemId}` : "Item de navegación no encontrado", 404, options),
+    tenantContextConflict: (options) => buildError(ErrorCode.TENANT_CONTEXT_CONFLICT, "El contexto del tenant no es válido", 400, options),
+    tenantContextRequired: (options) => buildError(ErrorCode.TENANT_CONTEXT_REQUIRED, "Falta el contexto de empresa", 403, options),
+    tenantContextUnavailable: (options) => buildError(ErrorCode.TENANT_CONTEXT_UNAVAILABLE, "No se pudo resolver el contexto del tenant", 500, options),
+    tenantForbidden: (options) => buildError(ErrorCode.TENANT_FORBIDDEN, "No tienes acceso a esta empresa", 403, options),
+    tenantMemberAlreadyExists: (options) => buildError(ErrorCode.TENANT_MEMBER_ALREADY_EXISTS, "El usuario ya es miembro de la empresa", 409, options),
+    tenantMemberNotFound: (options) => buildError(ErrorCode.TENANT_MEMBER_NOT_FOUND, "Miembro no encontrado", 404, options),
+    tenantMismatch: (options) => buildError(ErrorCode.TENANT_MISMATCH, "El archivo descargado no corresponde al RUC del tenant", 409, options),
+    tenantNotFound: (options) => buildError(ErrorCode.TENANT_NOT_FOUND, "Empresa no encontrada", 404, options),
+    tenantRoleImmutable: (options) => buildError(ErrorCode.TENANT_ROLE_IMMUTABLE, "Los roles del sistema no pueden desactivarse", 409, options),
+    tenantRoleNotFound: (options) => buildError(ErrorCode.TENANT_ROLE_NOT_FOUND, "El rol indicado no existe", 404, options),
+    tenantSeatsExceeded: (options) => buildError(ErrorCode.TENANT_SEATS_EXCEEDED, "Capacidad de asientos excedida", 409, options),
+    tenantSlugInUse: (options) => buildError(ErrorCode.TENANT_SLUG_IN_USE, "El slug ya está en uso", 409, options),
+    ubigeoExists: (options) => buildError(ErrorCode.UBIGEO_EXISTS, "El código ubigeo ya está registrado", 409, options),
+    ubigeoNotFound: (options) => buildError(ErrorCode.UBIGEO_NOT_FOUND, "Ubigeo no encontrado", 404, options),
+    unauthorized: (options) => buildError(ErrorCode.UNAUTHORIZED, "Usuario no autorizado", 401, options),
+    userExists: (options) => buildError(ErrorCode.USER_EXISTS, "El correo ya está registrado", 409, options),
+    userInactive: (options) => buildError(ErrorCode.USER_INACTIVE, "Usuario inactivo", 403, options),
+    userNotFound: (options) => buildError(ErrorCode.USER_NOT_FOUND, "Usuario no encontrado", 404, options),
+    validation: (field, options) => buildError(ErrorCode.VALIDATION, field ? `${field} inválido` : "metadata inválido", 400, options),
+    internal: (options) => buildError(ErrorCode.INTERNAL, "internal error", 500, options),
+};

package/dist/errors/app-error.js

@@ -0,0 +1,12 @@
+export class AppError extends Error {
+    code;
+    status;
+    errors;
+    constructor(code, message, status = 400, errors = {}) {
+        super(message ?? code);
+        this.code = code;
+        this.status = status;
+        this.errors = errors;
+        this.name = "AppError";
+    }
+}

package/dist/errors/error-codes.d.ts

@@ -0,0 +1,58 @@
+export declare const ErrorCode: {
+    readonly AUTH_REQUIRED: "AUTH_REQUIRED";
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly CHANNEL_EXISTS: "CHANNEL_EXISTS";
+    readonly CHANNEL_NOT_FOUND: "CHANNEL_NOT_FOUND";
+    readonly CONFIG: "CONFIG";
+    readonly CONFLICT: "CONFLICT";
+    readonly COURIER_DOCUMENT_TAKEN: "COURIER_DOCUMENT_TAKEN";
+    readonly COURIER_NOT_FOUND: "COURIER_NOT_FOUND";
+    readonly COURIER_PHONE_TAKEN: "COURIER_PHONE_TAKEN";
+    readonly CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly INVALID_JSON: "INVALID_JSON";
+    readonly INVALID_REPORT: "INVALID_REPORT";
+    readonly INVALID_STATE: "INVALID_STATE";
+    readonly INVITE_REVOKED: "INVITE_REVOKED";
+    readonly LOGIN_STRATEGIES_MISSING: "LOGIN_STRATEGIES_MISSING";
+    readonly LOGIN_UNSUPPORTED_PROVIDER: "LOGIN_UNSUPPORTED_PROVIDER";
+    readonly NO_ITEMS: "NO_ITEMS";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly NOTIFICATION_NOT_FOUND: "NOTIFICATION_NOT_FOUND";
+    readonly PARAMETER_EXISTS: "PARAMETER_EXISTS";
+    readonly PARAMETER_NOT_FOUND: "PARAMETER_NOT_FOUND";
+    readonly PRODUCT_EXISTS: "PRODUCT_EXISTS";
+    readonly PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND";
+    readonly SERVICE_EXISTS: "SERVICE_EXISTS";
+    readonly SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND";
+    readonly SUNAT_API_ERROR: "SUNAT_API_ERROR";
+    readonly SUNAT_AUTH_ERROR: "SUNAT_AUTH_ERROR";
+    readonly SUNAT_AUTH_FAILED: "SUNAT_AUTH_FAILED";
+    readonly SUNAT_AUTH_INVALID_RESPONSE: "SUNAT_AUTH_INVALID_RESPONSE";
+    readonly SUNAT_AUTH_TIMEOUT: "SUNAT_AUTH_TIMEOUT";
+    readonly SUNAT_SETTINGS_NOT_CONFIGURED: "SUNAT_SETTINGS_NOT_CONFIGURED";
+    readonly SUNAT_SETTINGS_NOT_FOUND: "SUNAT_SETTINGS_NOT_FOUND";
+    readonly SUNAT_TIMEOUT: "SUNAT_TIMEOUT";
+    readonly SYSTEM_NAV_ITEM_NOT_FOUND: "SYSTEM_NAV_ITEM_NOT_FOUND";
+    readonly TENANT_CONTEXT_CONFLICT: "TENANT_CONTEXT_CONFLICT";
+    readonly TENANT_CONTEXT_REQUIRED: "TENANT_CONTEXT_REQUIRED";
+    readonly TENANT_CONTEXT_UNAVAILABLE: "TENANT_CONTEXT_UNAVAILABLE";
+    readonly TENANT_FORBIDDEN: "TENANT_FORBIDDEN";
+    readonly TENANT_MEMBER_ALREADY_EXISTS: "TENANT_MEMBER_ALREADY_EXISTS";
+    readonly TENANT_MEMBER_NOT_FOUND: "TENANT_MEMBER_NOT_FOUND";
+    readonly TENANT_MISMATCH: "TENANT_MISMATCH";
+    readonly TENANT_NOT_FOUND: "TENANT_NOT_FOUND";
+    readonly TENANT_ROLE_IMMUTABLE: "TENANT_ROLE_IMMUTABLE";
+    readonly TENANT_ROLE_NOT_FOUND: "TENANT_ROLE_NOT_FOUND";
+    readonly TENANT_SEATS_EXCEEDED: "TENANT_SEATS_EXCEEDED";
+    readonly TENANT_SLUG_IN_USE: "TENANT_SLUG_IN_USE";
+    readonly UBIGEO_EXISTS: "UBIGEO_EXISTS";
+    readonly UBIGEO_NOT_FOUND: "UBIGEO_NOT_FOUND";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly USER_EXISTS: "USER_EXISTS";
+    readonly USER_INACTIVE: "USER_INACTIVE";
+    readonly USER_NOT_FOUND: "USER_NOT_FOUND";
+    readonly VALIDATION: "VALIDATION";
+    readonly INTERNAL: "INTERNAL";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];

package/dist/errors/error-codes.js

@@ -0,0 +1,57 @@
+export const ErrorCode = {
+    AUTH_REQUIRED: "AUTH_REQUIRED",
+    BAD_REQUEST: "BAD_REQUEST",
+    CHANNEL_EXISTS: "CHANNEL_EXISTS",
+    CHANNEL_NOT_FOUND: "CHANNEL_NOT_FOUND",
+    CONFIG: "CONFIG",
+    CONFLICT: "CONFLICT",
+    COURIER_DOCUMENT_TAKEN: "COURIER_DOCUMENT_TAKEN",
+    COURIER_NOT_FOUND: "COURIER_NOT_FOUND",
+    COURIER_PHONE_TAKEN: "COURIER_PHONE_TAKEN",
+    CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND",
+    FORBIDDEN: "FORBIDDEN",
+    INVALID_JSON: "INVALID_JSON",
+    INVALID_REPORT: "INVALID_REPORT",
+    INVALID_STATE: "INVALID_STATE",
+    INVITE_REVOKED: "INVITE_REVOKED",
+    LOGIN_STRATEGIES_MISSING: "LOGIN_STRATEGIES_MISSING",
+    LOGIN_UNSUPPORTED_PROVIDER: "LOGIN_UNSUPPORTED_PROVIDER",
+    NO_ITEMS: "NO_ITEMS",
+    NOT_FOUND: "NOT_FOUND",
+    NOTIFICATION_NOT_FOUND: "NOTIFICATION_NOT_FOUND",
+    PARAMETER_EXISTS: "PARAMETER_EXISTS",
+    PARAMETER_NOT_FOUND: "PARAMETER_NOT_FOUND",
+    PRODUCT_EXISTS: "PRODUCT_EXISTS",
+    PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND",
+    SERVICE_EXISTS: "SERVICE_EXISTS",
+    SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND",
+    SUNAT_API_ERROR: "SUNAT_API_ERROR",
+    SUNAT_AUTH_ERROR: "SUNAT_AUTH_ERROR",
+    SUNAT_AUTH_FAILED: "SUNAT_AUTH_FAILED",
+    SUNAT_AUTH_INVALID_RESPONSE: "SUNAT_AUTH_INVALID_RESPONSE",
+    SUNAT_AUTH_TIMEOUT: "SUNAT_AUTH_TIMEOUT",
+    SUNAT_SETTINGS_NOT_CONFIGURED: "SUNAT_SETTINGS_NOT_CONFIGURED",
+    SUNAT_SETTINGS_NOT_FOUND: "SUNAT_SETTINGS_NOT_FOUND",
+    SUNAT_TIMEOUT: "SUNAT_TIMEOUT",
+    SYSTEM_NAV_ITEM_NOT_FOUND: "SYSTEM_NAV_ITEM_NOT_FOUND",
+    TENANT_CONTEXT_CONFLICT: "TENANT_CONTEXT_CONFLICT",
+    TENANT_CONTEXT_REQUIRED: "TENANT_CONTEXT_REQUIRED",
+    TENANT_CONTEXT_UNAVAILABLE: "TENANT_CONTEXT_UNAVAILABLE",
+    TENANT_FORBIDDEN: "TENANT_FORBIDDEN",
+    TENANT_MEMBER_ALREADY_EXISTS: "TENANT_MEMBER_ALREADY_EXISTS",
+    TENANT_MEMBER_NOT_FOUND: "TENANT_MEMBER_NOT_FOUND",
+    TENANT_MISMATCH: "TENANT_MISMATCH",
+    TENANT_NOT_FOUND: "TENANT_NOT_FOUND",
+    TENANT_ROLE_IMMUTABLE: "TENANT_ROLE_IMMUTABLE",
+    TENANT_ROLE_NOT_FOUND: "TENANT_ROLE_NOT_FOUND",
+    TENANT_SEATS_EXCEEDED: "TENANT_SEATS_EXCEEDED",
+    TENANT_SLUG_IN_USE: "TENANT_SLUG_IN_USE",
+    UBIGEO_EXISTS: "UBIGEO_EXISTS",
+    UBIGEO_NOT_FOUND: "UBIGEO_NOT_FOUND",
+    UNAUTHORIZED: "UNAUTHORIZED",
+    USER_EXISTS: "USER_EXISTS",
+    USER_INACTIVE: "USER_INACTIVE",
+    USER_NOT_FOUND: "USER_NOT_FOUND",
+    VALIDATION: "VALIDATION",
+    INTERNAL: "INTERNAL",
+};

package/dist/http/error-mapper.d.ts

@@ -0,0 +1,10 @@
+export type ApiErrorResponse = {
+    code: string;
+    message: string;
+    errors?: Record<string, string>;
+    traceId?: string;
+};
+export declare function toApiError(err: unknown, traceId?: string): {
+    status: number;
+    body: ApiErrorResponse;
+};

package/dist/http/error-mapper.js

@@ -0,0 +1,19 @@
+import { AppError } from "../errors/app-error";
+import { ErrorCode } from "../errors/error-codes";
+export function toApiError(err, traceId) {
+    if (err instanceof AppError) {
+        return {
+            status: err.status,
+            body: {
+                code: err.code,
+                message: err.message,
+                errors: err.errors,
+                traceId,
+            },
+        };
+    }
+    return {
+        status: 500,
+        body: { code: ErrorCode.INTERNAL, message: "internal error", traceId },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./errors/error-codes";
+export * from "./errors/app-error";
+export * from "./errors/app-error.factory";
+export * from "./http/error-mapper";
+export * from "./search/search-index";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./errors/error-codes";
+export * from "./errors/app-error";
+export * from "./errors/app-error.factory";
+export * from "./http/error-mapper";
+export * from "./search/search-index";

package/dist/search/search-index.d.ts

@@ -0,0 +1,6 @@
+export type SearchIndex<T = unknown> = Record<string, T>;
+export declare function createEmptySearchIndex<T = unknown>(): SearchIndex<T>;
+export declare function normalizeSearchText(value: string): string;
+export declare function buildSearchPrefixes(tokens: string[], maxLength?: number): string[];
+export declare function toSearchPrefix(query: string): string;
+export declare function normalizePhoneDigits(value: string): string;

package/dist/search/search-index.js

@@ -0,0 +1,39 @@
+const DEFAULT_MAX_PREFIX_LENGTH = 30;
+export function createEmptySearchIndex() {
+    return {};
+}
+export function normalizeSearchText(value) {
+    const normalized = (value ?? "")
+        .normalize("NFD")
+        .replaceAll(/\p{Diacritic}/gu, "")
+        .replaceAll(/["'`,.:;!?(){}]/g, " ")
+        .replaceAll(/[-_]/g, " ")
+        .toLowerCase();
+    return normalized.replaceAll(/\s+/g, " ").trim();
+}
+export function buildSearchPrefixes(tokens, maxLength = DEFAULT_MAX_PREFIX_LENGTH) {
+    const prefixSet = new Set();
+    for (const token of tokens) {
+        const safeToken = token.slice(0, maxLength);
+        if (!safeToken) {
+            continue;
+        }
+        addPrefixes(prefixSet, safeToken);
+        const segments = safeToken.split(/\s+/g).filter(Boolean);
+        for (const segment of segments) {
+            addPrefixes(prefixSet, segment.slice(0, maxLength));
+        }
+    }
+    return Array.from(prefixSet);
+}
+function addPrefixes(prefixSet, value) {
+    for (let index = 1; index <= value.length; index += 1) {
+        prefixSet.add(value.slice(0, index));
+    }
+}
+export function toSearchPrefix(query) {
+    return normalizeSearchText(query).slice(0, DEFAULT_MAX_PREFIX_LENGTH);
+}
+export function normalizePhoneDigits(value) {
+    return (value ?? "").replaceAll(/\D+/g, "");
+}

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@uityu/uityu-shared",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}

package/src/errors/app-error.factory.ts

@@ -0,0 +1,184 @@
+import { AppError } from "./app-error";
+import { ErrorCode } from "./error-codes";
+
+export type AppErrorFactoryOptions = {
+  message?: string;
+  status?: number;
+  errors?: Record<string, string>;
+};
+
+const DEFAULT_ERRORS: Record<string, string> = {};
+
+function buildError(
+  code: ErrorCode,
+  defaultMessage: string,
+  defaultStatus: number,
+  options?: AppErrorFactoryOptions,
+): AppError {
+  return new AppError(
+    code,
+    options?.message ?? defaultMessage,
+    options?.status ?? defaultStatus,
+    options?.errors ?? DEFAULT_ERRORS,
+  );
+}
+
+export const AppErrorFactory = {
+  authRequired: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.AUTH_REQUIRED, "El idToken de Google es requerido", 401, options),
+  badRequest: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.BAD_REQUEST, "Faltan parámetros", 400, options),
+  channelExists: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.CHANNEL_EXISTS, "El canal ya existe", 409, options),
+  channelNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.CHANNEL_NOT_FOUND, "Canal no encontrado", 404, options),
+  config: (field?: string, options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.CONFIG,
+      field ? `Falta ${field} para la integración SUNAT` : "Falta un campo para la integración SUNAT",
+      500,
+      options,
+    ),
+  conflict: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.CONFLICT, "El teléfono ya existe", 409, options),
+  courierDocumentTaken: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.COURIER_DOCUMENT_TAKEN, "El documento ya existe", 409, options),
+  courierNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.COURIER_NOT_FOUND, "Courier not found", 404, options),
+  courierPhoneTaken: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.COURIER_PHONE_TAKEN, "El teléfono ya existe", 409, options),
+  customerNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.CUSTOMER_NOT_FOUND, "Cliente no encontrado", 404, options),
+  forbidden: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.FORBIDDEN, "Actor no autorizado", 403, options),
+  invalidJson: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.INVALID_JSON, "Body debe ser JSON", 400, options),
+  invalidReport: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.INVALID_REPORT, "El archivo ZIP está vacío", 409, options),
+  invalidState: (options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.INVALID_STATE,
+      "No se pudo resolver tenantId/recipientUid desde Firestore",
+      500,
+      options,
+    ),
+  inviteRevoked: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.INVITE_REVOKED, "La invitación fue revocada", 409, options),
+  loginStrategiesMissing: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.LOGIN_STRATEGIES_MISSING, "No hay estrategias de autenticación configuradas", 500, options),
+  loginUnsupportedProvider: (provider?: string, options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.LOGIN_UNSUPPORTED_PROVIDER,
+      provider
+        ? `Proveedor de login no soportado: ${provider}`
+        : "Proveedor de login no soportado",
+      400,
+      options,
+    ),
+  noItems: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.NO_ITEMS, "La orden debe tener al menos un item", 400, options),
+  notFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.NOT_FOUND, "User not found", 404, options),
+  notificationNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.NOTIFICATION_NOT_FOUND, "Notificación no encontrada", 404, options),
+  parameterExists: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.PARAMETER_EXISTS, "El código de parámetro ya existe", 409, options),
+  parameterNotFound: (field?: string, options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.PARAMETER_NOT_FOUND,
+      field ? `El parámetro ${field} es inválido` : "El parámetro es inválido",
+      400,
+      options,
+    ),
+  productExists: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.PRODUCT_EXISTS, "El SKU ya existe", 409, options),
+  productNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.PRODUCT_NOT_FOUND, "Producto no encontrado", 404, options),
+  serviceExists: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SERVICE_EXISTS, "El servicio ya existe", 409, options),
+  serviceNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SERVICE_NOT_FOUND, "Servicio no encontrado", 404, options),
+  sunatApiError: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SUNAT_API_ERROR, "Error inesperado en API de SIRE Compras", 502, options),
+  sunatAuthError: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SUNAT_AUTH_ERROR, "Error inesperado al obtener token SUNAT", 502, options),
+  sunatAuthFailed: (message?: string, options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SUNAT_AUTH_FAILED, message ?? "Error de autenticación SUNAT", 500, options),
+  sunatAuthInvalidResponse: (options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.SUNAT_AUTH_INVALID_RESPONSE,
+      "SUNAT retornó un formato de token inválido",
+      502,
+      options,
+    ),
+  sunatAuthTimeout: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SUNAT_AUTH_TIMEOUT, "Tiempo de espera agotado al obtener token SUNAT", 504, options),
+  sunatSettingsNotConfigured: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SUNAT_SETTINGS_NOT_CONFIGURED, "Configura las credenciales SUNAT", 404, options),
+  sunatSettingsNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SUNAT_SETTINGS_NOT_FOUND, "Configura las credenciales SUNAT", 404, options),
+  sunatTimeout: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.SUNAT_TIMEOUT, "Tiempo de espera agotado en API de SIRE Compras", 504, options),
+  systemNavItemNotFound: (itemId?: string, options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.SYSTEM_NAV_ITEM_NOT_FOUND,
+      itemId ? `Item de navegación no encontrado: ${itemId}` : "Item de navegación no encontrado",
+      404,
+      options,
+    ),
+  tenantContextConflict: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_CONTEXT_CONFLICT, "El contexto del tenant no es válido", 400, options),
+  tenantContextRequired: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_CONTEXT_REQUIRED, "Falta el contexto de empresa", 403, options),
+  tenantContextUnavailable: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_CONTEXT_UNAVAILABLE, "No se pudo resolver el contexto del tenant", 500, options),
+  tenantForbidden: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_FORBIDDEN, "No tienes acceso a esta empresa", 403, options),
+  tenantMemberAlreadyExists: (options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.TENANT_MEMBER_ALREADY_EXISTS,
+      "El usuario ya es miembro de la empresa",
+      409,
+      options,
+    ),
+  tenantMemberNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_MEMBER_NOT_FOUND, "Miembro no encontrado", 404, options),
+  tenantMismatch: (options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.TENANT_MISMATCH,
+      "El archivo descargado no corresponde al RUC del tenant",
+      409,
+      options,
+    ),
+  tenantNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_NOT_FOUND, "Empresa no encontrada", 404, options),
+  tenantRoleImmutable: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_ROLE_IMMUTABLE, "Los roles del sistema no pueden desactivarse", 409, options),
+  tenantRoleNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_ROLE_NOT_FOUND, "El rol indicado no existe", 404, options),
+  tenantSeatsExceeded: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_SEATS_EXCEEDED, "Capacidad de asientos excedida", 409, options),
+  tenantSlugInUse: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.TENANT_SLUG_IN_USE, "El slug ya está en uso", 409, options),
+  ubigeoExists: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.UBIGEO_EXISTS, "El código ubigeo ya está registrado", 409, options),
+  ubigeoNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.UBIGEO_NOT_FOUND, "Ubigeo no encontrado", 404, options),
+  unauthorized: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.UNAUTHORIZED, "Usuario no autorizado", 401, options),
+  userExists: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.USER_EXISTS, "El correo ya está registrado", 409, options),
+  userInactive: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.USER_INACTIVE, "Usuario inactivo", 403, options),
+  userNotFound: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.USER_NOT_FOUND, "Usuario no encontrado", 404, options),
+  validation: (field?: string, options?: AppErrorFactoryOptions) =>
+    buildError(
+      ErrorCode.VALIDATION,
+      field ? `${field} inválido` : "metadata inválido",
+      400,
+      options,
+    ),
+  internal: (options?: AppErrorFactoryOptions) =>
+    buildError(ErrorCode.INTERNAL, "internal error", 500, options),
+};

package/src/errors/app-error.ts

@@ -0,0 +1,11 @@
+export class AppError extends Error {
+  constructor(
+    public code: string,
+    message?: string,
+    public status = 400,
+    public errors: Record<string, string> = {},
+  ) {
+    super(message ?? code);
+    this.name = "AppError";
+  }
+}

package/src/errors/error-codes.ts

@@ -0,0 +1,59 @@
+export const ErrorCode = {
+  AUTH_REQUIRED: "AUTH_REQUIRED",
+  BAD_REQUEST: "BAD_REQUEST",
+  CHANNEL_EXISTS: "CHANNEL_EXISTS",
+  CHANNEL_NOT_FOUND: "CHANNEL_NOT_FOUND",
+  CONFIG: "CONFIG",
+  CONFLICT: "CONFLICT",
+  COURIER_DOCUMENT_TAKEN: "COURIER_DOCUMENT_TAKEN",
+  COURIER_NOT_FOUND: "COURIER_NOT_FOUND",
+  COURIER_PHONE_TAKEN: "COURIER_PHONE_TAKEN",
+  CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND",
+  FORBIDDEN: "FORBIDDEN",
+  INVALID_JSON: "INVALID_JSON",
+  INVALID_REPORT: "INVALID_REPORT",
+  INVALID_STATE: "INVALID_STATE",
+  INVITE_REVOKED: "INVITE_REVOKED",
+  LOGIN_STRATEGIES_MISSING: "LOGIN_STRATEGIES_MISSING",
+  LOGIN_UNSUPPORTED_PROVIDER: "LOGIN_UNSUPPORTED_PROVIDER",
+  NO_ITEMS: "NO_ITEMS",
+  NOT_FOUND: "NOT_FOUND",
+  NOTIFICATION_NOT_FOUND: "NOTIFICATION_NOT_FOUND",
+  PARAMETER_EXISTS: "PARAMETER_EXISTS",
+  PARAMETER_NOT_FOUND: "PARAMETER_NOT_FOUND",
+  PRODUCT_EXISTS: "PRODUCT_EXISTS",
+  PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND",
+  SERVICE_EXISTS: "SERVICE_EXISTS",
+  SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND",
+  SUNAT_API_ERROR: "SUNAT_API_ERROR",
+  SUNAT_AUTH_ERROR: "SUNAT_AUTH_ERROR",
+  SUNAT_AUTH_FAILED: "SUNAT_AUTH_FAILED",
+  SUNAT_AUTH_INVALID_RESPONSE: "SUNAT_AUTH_INVALID_RESPONSE",
+  SUNAT_AUTH_TIMEOUT: "SUNAT_AUTH_TIMEOUT",
+  SUNAT_SETTINGS_NOT_CONFIGURED: "SUNAT_SETTINGS_NOT_CONFIGURED",
+  SUNAT_SETTINGS_NOT_FOUND: "SUNAT_SETTINGS_NOT_FOUND",
+  SUNAT_TIMEOUT: "SUNAT_TIMEOUT",
+  SYSTEM_NAV_ITEM_NOT_FOUND: "SYSTEM_NAV_ITEM_NOT_FOUND",
+  TENANT_CONTEXT_CONFLICT: "TENANT_CONTEXT_CONFLICT",
+  TENANT_CONTEXT_REQUIRED: "TENANT_CONTEXT_REQUIRED",
+  TENANT_CONTEXT_UNAVAILABLE: "TENANT_CONTEXT_UNAVAILABLE",
+  TENANT_FORBIDDEN: "TENANT_FORBIDDEN",
+  TENANT_MEMBER_ALREADY_EXISTS: "TENANT_MEMBER_ALREADY_EXISTS",
+  TENANT_MEMBER_NOT_FOUND: "TENANT_MEMBER_NOT_FOUND",
+  TENANT_MISMATCH: "TENANT_MISMATCH",
+  TENANT_NOT_FOUND: "TENANT_NOT_FOUND",
+  TENANT_ROLE_IMMUTABLE: "TENANT_ROLE_IMMUTABLE",
+  TENANT_ROLE_NOT_FOUND: "TENANT_ROLE_NOT_FOUND",
+  TENANT_SEATS_EXCEEDED: "TENANT_SEATS_EXCEEDED",
+  TENANT_SLUG_IN_USE: "TENANT_SLUG_IN_USE",
+  UBIGEO_EXISTS: "UBIGEO_EXISTS",
+  UBIGEO_NOT_FOUND: "UBIGEO_NOT_FOUND",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  USER_EXISTS: "USER_EXISTS",
+  USER_INACTIVE: "USER_INACTIVE",
+  USER_NOT_FOUND: "USER_NOT_FOUND",
+  VALIDATION: "VALIDATION",
+  INTERNAL: "INTERNAL",
+} as const;
+
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];

package/src/http/error-mapper.ts

@@ -0,0 +1,31 @@
+import { AppError } from "../errors/app-error";
+import { ErrorCode } from "../errors/error-codes";
+
+export type ApiErrorResponse = {
+  code: string;
+  message: string;
+  errors?: Record<string, string>;
+  traceId?: string;
+};
+
+export function toApiError(
+  err: unknown,
+  traceId?: string,
+): { status: number; body: ApiErrorResponse } {
+  if (err instanceof AppError) {
+    return {
+      status: err.status,
+      body: {
+        code: err.code,
+        message: err.message,
+        errors: err.errors,
+        traceId,
+      },
+    };
+  }
+
+  return {
+    status: 500,
+    body: { code: ErrorCode.INTERNAL, message: "internal error", traceId },
+  };
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from "./errors/error-codes";
+export * from "./errors/app-error";
+export * from "./errors/app-error.factory";
+export * from "./http/error-mapper";
+export * from "./search/search-index";

package/src/search/search-index.ts

@@ -0,0 +1,52 @@
+export type SearchIndex<T = unknown> = Record<string, T>;
+
+const DEFAULT_MAX_PREFIX_LENGTH = 30;
+
+export function createEmptySearchIndex<T = unknown>(): SearchIndex<T> {
+	return {};
+}
+
+export function normalizeSearchText(value: string): string {
+	const normalized = (value ?? "")
+		.normalize("NFD")
+		.replaceAll(/\p{Diacritic}/gu, "")
+		.replaceAll(/["'`,.:;!?(){}]/g, " ")
+		.replaceAll(/[-_]/g, " ")
+		.toLowerCase();
+	return normalized.replaceAll(/\s+/g, " ").trim();
+}
+
+export function buildSearchPrefixes(
+	tokens: string[],
+	maxLength: number = DEFAULT_MAX_PREFIX_LENGTH,
+): string[] {
+	const prefixSet = new Set<string>();
+	for (const token of tokens) {
+		const safeToken = token.slice(0, maxLength);
+		if (!safeToken) {
+			continue;
+		}
+
+		addPrefixes(prefixSet, safeToken);
+
+		const segments = safeToken.split(/\s+/g).filter(Boolean);
+		for (const segment of segments) {
+			addPrefixes(prefixSet, segment.slice(0, maxLength));
+		}
+	}
+	return Array.from(prefixSet);
+}
+
+function addPrefixes(prefixSet: Set<string>, value: string): void {
+	for (let index = 1; index <= value.length; index += 1) {
+		prefixSet.add(value.slice(0, index));
+	}
+}
+
+export function toSearchPrefix(query: string): string {
+	return normalizeSearchText(query).slice(0, DEFAULT_MAX_PREFIX_LENGTH);
+}
+
+export function normalizePhoneDigits(value: string): string {
+	return (value ?? "").replaceAll(/\D+/g, "");
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "outDir": "dist",
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "Bundler",
+    "declaration": true,
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}