@nomalism-com/api 1.3.34 → 1.3.37

package/dist/lib/apiError.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Where the failure happened in the axios lifecycle.
+ *
+ * - `response` — the server replied with a non-2xx status (HTTP / application layer).
+ * - `request`  — the request was sent but no response came back (network, timeout, CORS, offline).
+ * - `setup`    — the request was never sent (bad config, invalid URL, serialization error).
+ * - `unknown`  — the thrown value was not an axios error at all.
+ */
+export type ApiErrorKind = 'response' | 'request' | 'setup' | 'unknown';
+export interface IApiErrorFields {
+    kind: ApiErrorKind;
+    message: string;
+    status?: number;
+    code?: string;
+    method?: string;
+    url?: string;
+    data?: unknown;
+}
+/**
+ * A compact, log-friendly error that replaces axios's huge error object.
+ *
+ * Only small primitives are kept as enumerable fields, so `console.log(err)`,
+ * `JSON.stringify(err)` and `err.stack` stay short. The original axios error is
+ * preserved on a non-enumerable Symbol slot, reachable via `err.raw` for deep
+ * debugging, but never dumped when the error is logged.
+ */
+export declare class ApiError extends Error {
+    readonly kind: ApiErrorKind;
+    /** HTTP status code, when the server responded. */
+    readonly status?: number;
+    /** Axios error code, e.g. 'ECONNABORTED', 'ERR_NETWORK', 'ERR_BAD_REQUEST'. */
+    readonly code?: string;
+    /** HTTP method of the failed request, uppercased. */
+    readonly method?: string;
+    /** Request URL (baseURL + path) of the failed request. */
+    readonly url?: string;
+    /** The server-provided error payload (response body), when present. */
+    readonly data?: unknown;
+    constructor(fields: IApiErrorFields, cause?: unknown);
+    /**
+     * The original underlying error (e.g. the raw AxiosError) for deep debugging.
+     * Lives on a non-enumerable Symbol slot, so it is never printed by loggers.
+     */
+    get raw(): unknown;
+    /** Controls what `JSON.stringify(err)` and most loggers emit — kept compact. */
+    toJSON(): IApiErrorFields;
+}
+/** Type guard for the simplified error. */
+export declare function isApiError(error: unknown): error is ApiError;
+/**
+ * Convert ANY thrown value into a compact {@link ApiError}.
+ *
+ * This is the single, DRY place that understands axios's four failure modes,
+ * so individual modules never have to inspect `error.response` / `error.request`
+ * themselves.
+ */
+export declare function parseApiError(error: unknown): ApiError;

package/dist/main.d.ts

@@ -1,4 +1,5 @@
 import { AxiosInstance } from 'axios';
+import WebSocketClass from './modules/view/webSocket';
 import BankDataClass from './modules/user/bankData';
 import ClientClass from './modules/user/clients';
 import ClientTypeClass from './modules/user/clientType';
@@ -22,7 +23,6 @@ import FileClass from './modules/stock/file';
 import GoogleSheetsClass from './modules/integration/googleSheets';
 import LanguageClass from './modules/user/language';
 import LocationClass from './modules/stock/location';
-import LogoutClass from './modules/user/logout';
 import MultimediaClass from './modules/documentManagement/multimedia';
 import ObservationClass from './modules/integration/observation';
 import ObservationTypeClass from './modules/integration/observationType';
@@ -39,6 +39,7 @@ import SegmentsAreaClass from './modules/user/segmentsArea';
 import SessionsClass from './modules/user/sessions';
 import ShippingsClass from './modules/user/shippings';
 import StoreOperatorClass from './modules/user/storeOperator';
+import SystemModuleClass from './modules/user/systemModule';
 import SwiftClass from './modules/user/swift';
 import TypeOfLocationClass from './modules/stock/typeOfLocation';
 import UnitOfMeasureClass from './modules/stock/unitOfMeasure';
@@ -104,6 +105,7 @@ import ThemeClass from './modules/user/theme';
 import DashboardClass from './modules/stock/dashboard';
 import ChatRapidMessageClass from './modules/stock/chatRapidMessage';
 import SideMenuClass from './modules/ui/sideMenu';
+import SidemenuHighlightClass from './modules/ui/sidemenuHighlight';
 import ErrorLogClass from './modules/view/errorLog';
 import AdminPanelClass from './modules/view/adminPanel';
 import DocumentLineRmClass from './modules/supply/documentLineRm';
@@ -124,6 +126,9 @@ import DocumentHeaderSurveyClass from './modules/supply/documentHeaderSurvey';
 import DocumentHeaderSubscriberClass from './modules/supply/documentHeaderSubscriber';
 import GoogleCalendarClass from './modules/stock/googleCalendar';
 import SaftClass from './modules/supply/saft';
+import ProductLocationClass from './modules/stock/productLocation';
+import TimeSheetClass from './modules/user/timeSheet';
+import CatalogoClass from './modules/document/CAT';
 export * as BankData from './modules/user/bankData';
 export * as Client from './modules/user/clients';
 export * as ClientType from './modules/user/clientType';
@@ -139,7 +144,6 @@ export * as File from './modules/stock/file';
 export * as GoogleSheets from './modules/integration/googleSheets';
 export * as Language from './modules/user/language';
 export * as Location from './modules/stock/location';
-export * as Logout from './modules/user/logout';
 export * as Multimedia from './modules/documentManagement/multimedia';
 export * as Observation from './modules/integration/observation';
 export * as ObservationType from './modules/integration/observationType';
@@ -156,6 +160,7 @@ export * as SegmentsArea from './modules/user/segmentsArea';
 export * as Sessions from './modules/user/sessions';
 export * as Shippings from './modules/user/shippings';
 export * as StoreOperator from './modules/user/storeOperator';
+export * as SystemModule from './modules/user/systemModule';
 export * as Swift from './modules/user/swift';
 export * as TypeOfLocation from './modules/stock/typeOfLocation';
 export * as UnitOfMeasure from './modules/stock/unitOfMeasure';
@@ -221,6 +226,7 @@ export * as Theme from './modules/user/theme';
 export * as Dashboard from './modules/stock/dashboard';
 export * as ChatRapidMessage from './modules/stock/chatRapidMessage';
 export * as SideMenu from './modules/ui/sideMenu';
+export * as SidemenuHighlight from './modules/ui/sidemenuHighlight';
 export * as ErrorLog from './modules/view/errorLog';
 export * as AdminPanel from './modules/view/adminPanel';
 export * as DocumentLineRm from './modules/supply/documentLineRm';
@@ -241,6 +247,9 @@ export * as DocumentHeaderSurvey from './modules/supply/documentHeaderSurvey';
 export * as DocumentHeaderSubscriber from './modules/supply/documentHeaderSubscriber';
 export * as GoogleCalendar from './modules/stock/googleCalendar';
 export * as Saft from './modules/supply/saft';
+export * as ProductLocation from './modules/stock/productLocation';
+export * as TimeSheet from './modules/user/timeSheet';
+export * as Catalogo from './modules/document/CAT';
 export type IEnvironment = 'production' | 'uat' | 'development' | 'localhost';
 type IService = 'stock' | 'users' | 'integration' | 'documents' | 'view' | 'print' | 'tickets' | 'llm';
 export interface IOptions {
@@ -258,6 +267,7 @@ export declare class API {
     processEnvironment: IEnvironment;
     client: AxiosInstance;
     services: Record<IService, string>;
+    WebSocket: WebSocketClass;
     BankData: BankDataClass;
     Client: ClientClass;
     ClientType: ClientTypeClass;
@@ -281,7 +291,6 @@ export declare class API {
     GoogleSheets: GoogleSheetsClass;
     Language: LanguageClass;
     Location: LocationClass;
-    Logout: LogoutClass;
     Multimedia: MultimediaClass;
     Observation: ObservationClass;
     ObservationType: ObservationTypeClass;
@@ -298,6 +307,7 @@ export declare class API {
     Sessions: SessionsClass;
     Shippings: ShippingsClass;
     StoreOperator: StoreOperatorClass;
+    SystemModule: SystemModuleClass;
     Swift: SwiftClass;
     TypeOfLocation: TypeOfLocationClass;
     UnitOfMeasure: UnitOfMeasureClass;
@@ -363,6 +373,7 @@ export declare class API {
     Dashboard: DashboardClass;
     ChatRapidMessage: ChatRapidMessageClass;
     SideMenu: SideMenuClass;
+    SidemenuHighlight: SidemenuHighlightClass;
     ErrorLog: ErrorLogClass;
     AdminPanel: AdminPanelClass;
     DocumentLineRm: DocumentLineRmClass;
@@ -383,6 +394,9 @@ export declare class API {
     DocumentHeaderSurvey: DocumentHeaderSurveyClass;
     DocumentHeaderSubscriber: DocumentHeaderSubscriberClass;
     GoogleCalendar: GoogleCalendarClass;
+    ProductLocation: ProductLocationClass;
+    TimeSheet: TimeSheetClass;
+    Catalogo: CatalogoClass;
     private defaultHeaders;
     constructor({ processEnvironment, services, gatewayUrl, apikey, tokenBearer }: IOptions);
 }

package/dist/modules/document/CAT.d.ts

@@ -0,0 +1,8 @@
+import Nomalism from '@nomalism-com/types';
+import { IModuleConstructor } from '../../main';
+export default class Repository implements Nomalism.Catalogo.IRepository {
+    route: string;
+    private api;
+    constructor({ api, route }: IModuleConstructor);
+    create(data: Nomalism.Catalogo.ICreateRequest): Promise<void>;
+}

package/dist/modules/document/materialEntrance.d.ts

@@ -8,7 +8,7 @@ export default class Repository implements Nomalism.MaterialEntrance.IApi {
     findUnfinishedPickings({ id, }: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.MaterialEntrance.IUnfinishedPickingsResponse[]>;
     finalizarEntradaMaterial(data: Nomalism.MaterialEntrance.IFinalizarEntradaDeMaterialRequest): Promise<Nomalism.MaterialEntrance.IFinalizarEntradaDeMaterialResponse>;
     undoEntradaMaterial(data: Nomalism.MaterialEntrance.IUndoEntradaDeMaterialRequest): Promise<void>;
-    findDoneById({ id, }: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.SavedEmPicking.ISavedEmPickingData | null>;
+    findDoneById({ id, }: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.MaterialEntrance.IFindDoneByIdResponse[]>;
     printLabelToPdfUrl({ product_id }: Nomalism.MaterialEntrance.IPrintLabelParamsRequest, { quantity, ef_name, pc_document_number, prison, note, availableStock, }: Nomalism.MaterialEntrance.IPrintLabelQueryRequest, token: string): string;
-    printBulkLabelToPdfUrl({ groupLabel, saved_em_picking_ids, token, }: Nomalism.MaterialEntrance.IPrintBulkLabelRequest): string;
+    printBulkLabelToPdfUrl({ groupLabel, stockOrders, notOk, clientOrders, saved_em_picking_ids, token, }: Nomalism.MaterialEntrance.IPrintBulkLabelRequest): string;
 }

package/dist/modules/documentManagement/multimedia.d.ts

@@ -7,4 +7,5 @@ export default class Repository implements Nomalism.Multimedia.IApi {
     constructor({ api, route }: IModuleConstructor);
     getUrl(multimediaId: string, download?: boolean): string;
     create(multipartFormData: any, headers?: RawAxiosRequestHeaders): Promise<Nomalism.Multimedia.Entity>;
+    update(id: string, multipartFormData: any, headers?: RawAxiosRequestHeaders): Promise<void>;
 }

package/dist/modules/llm/llm.d.ts

@@ -7,4 +7,5 @@ export default class Repository implements Nomalism.LLM.IRepository {
     prompt(data: Nomalism.LLM.IPromptRequest, { onChunk, onDone, onError }: Nomalism.LLM.IPromptResponse): Nomalism.LLM.IPromptAbortController;
     translate(body: Nomalism.LLM.ITranslateRequest): Promise<string>;
     identifyLanguage(body: Nomalism.LLM.IIdentifyLanguageRequest): Promise<string>;
+    identifyAndTranslate(body: Nomalism.LLM.ITranslateRequest): Promise<Nomalism.LLM.IIdentifyAndTranslateResponse>;
 }

package/dist/modules/stock/mobilePrint.d.ts

@@ -0,0 +1,8 @@
+import Nomalism from '@nomalism-com/types';
+import { IModuleConstructor } from '../../main';
+export default class Repository implements Nomalism.MobilePrint.IRepository {
+    route: string;
+    private api;
+    constructor({ api, route }: IModuleConstructor);
+    printLocationsPdf(data: string[]): Promise<void>;
+}

package/dist/modules/stock/productLocation.d.ts

@@ -0,0 +1,8 @@
+import Nomalism from '@nomalism-com/types';
+import { IModuleConstructor } from '../../main';
+export default class Repository implements Nomalism.ProductLocation.IRepository {
+    route: string;
+    private api;
+    constructor({ api, route }: IModuleConstructor);
+    findMany(): Promise<Nomalism.ProductLocation.IProductLocation[]>;
+}

package/dist/modules/supply/currentAccount.d.ts

@@ -7,7 +7,8 @@ export default class Repository implements Nomalism.CurrentAccount.IRepository {
     findCurrentAccountByOwnerId(params: Nomalism.shared.IFindByOwnerIdRequest): Promise<Nomalism.CurrentAccount.IFindCurrentAccountByOwnerIdResponse[]>;
     findBalanceByOwnerId(params: Nomalism.shared.IFindByOwnerIdRequest): Promise<number>;
     exportCurrentAccount(params: Nomalism.CurrentAccount.IExportCurrentAccountRequest): Promise<Nomalism.CurrentAccount.IFindCurrentAccountByOwnerIdResponse[]>;
-    findClientUnpaidCredit(params: Nomalism.shared.IFindByOwnerIdRequest): Promise<Nomalism.CurrentAccount.IUnpaidDocumentResponse[]>;
-    findClientUnpaidDebit(params: Nomalism.shared.IFindByOwnerIdRequest): Promise<Nomalism.CurrentAccount.IUnpaidDocumentResponse[]>;
+    findClientUnpaidCredit(params: Nomalism.shared.IFindByOwnerIdRequest): Promise<Nomalism.CurrentAccount.IDocumentResponse[]>;
+    findClientOverpaidCredit(params: Nomalism.shared.IFindByOwnerIdRequest): Promise<Nomalism.CurrentAccount.IDocumentResponse[]>;
+    findClientUnpaidDebit(params: Nomalism.shared.IFindByOwnerIdRequest): Promise<Nomalism.CurrentAccount.IDocumentResponse[]>;
     getExportCurrentAccountUrl({ owner_id, start_date, end_date, output, token, }: Nomalism.CurrentAccount.IExportCurrentAccountRequest): string;
 }

package/dist/modules/supply/documentHeader.d.ts

@@ -15,7 +15,6 @@ export default class Repository implements Nomalism.DocumentHeader.IRepository {
     deleteOne(selector: Nomalism.shared.IFindByIdRequest): Promise<void>;
     getActions(selector: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.DocumentHeader.IGetActionsResponse[]>;
     transferClientOwnership(data: Nomalism.DocumentHeader.ITransferOwnershipRequest): Promise<void>;
-    updateManyWithPersona(data: Nomalism.DocumentHeader.IUpdateManyWithPersona): Promise<void>;
     sendClientNotification({ id }: Nomalism.shared.IFindByIdRequest, data: Nomalism.DocumentHeader.ISendClientNotificationRequest): Promise<void>;
     markUnsentClientNotification({ id }: Nomalism.shared.IFindByIdRequest): Promise<void>;
     documentPdf({ id }: Nomalism.shared.IFindByIdRequest): Promise<string>;
@@ -23,6 +22,6 @@ export default class Repository implements Nomalism.DocumentHeader.IRepository {
     documentThermalPrint({ id }: Nomalism.shared.IFindByIdRequest): Promise<string>;
     documentList({ id, }: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.DocumentHeader.IDocumentListResponse[]>;
     findStartDocumentHeaderSiblings({ id, }: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.DocumentHeader.IFindStartDocumentHeaderSiblingsResponse>;
-    createSiteProposal(data: Nomalism.shared.IBrokerTopicPayload[typeof Nomalism.shared.IBrokerTopic.create_site_proposal]): Promise<Nomalism.ProjectInfo.ICreateResponse>;
+    createSiteProposal(data: Nomalism.shared.IBrokerTopicPayload[Nomalism.shared.IBrokerTopic.create_site_proposal]): Promise<Nomalism.ProjectInfo.ICreateResponse>;
     findCountByOwnerIds(data: Nomalism.DocumentHeader.IFindCountByOwnersIdsRequest): Promise<Nomalism.DocumentHeader.IFindCountByOwnersIdsResponse[]>;
 }

package/dist/modules/ui/sidemenuHighlight.d.ts

@@ -0,0 +1,10 @@
+import Nomalism from '@nomalism-com/types';
+import { IModuleConstructor } from '../../main';
+export default class Repository implements Nomalism.SidemenuHighlight.IRepository {
+    route: string;
+    private api;
+    constructor({ api, route }: IModuleConstructor);
+    find(): Promise<Nomalism.SidemenuHighlight.IFindResponseItem[]>;
+    findByStoreOperatorId(selector: Nomalism.SidemenuHighlight.IFindByStoreOperatorIdRequest): Promise<Nomalism.SidemenuHighlight.IFindByStoreOperatorIdResponse>;
+    setStoreOperatorHighlights(body: Nomalism.SidemenuHighlight.ISetStoreOperatorHighlightsRequest): Promise<void>;
+}

package/dist/modules/user/chatSubscriber.d.ts

@@ -5,9 +5,11 @@ export default class Repository implements Nomalism.ChatSubscriber.IRepository {
     private api;
     constructor({ api, route }: IModuleConstructor);
     findDocumentHeaderSubscribers(params: Nomalism.ChatSubscriber.IFindDocumentHeaderSubscribersRequest): Promise<Nomalism.ChatSubscriber.IEntityWithPersona[]>;
+    findDocumentHeaderSubscribersByLanguage(params: Nomalism.ChatSubscriber.IFindDocumentHeaderSubscribersByLanguageRequest): Promise<string[]>;
     findSubscribedDocumentHeaders(params: Nomalism.ChatSubscriber.IFindSubscribedDocumentHeadersRequest): Promise<Nomalism.ChatSubscriber.IEntityWithPersonaAndSubscriptions>;
     findById({ id, }: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.ChatSubscriber.IEntityWithPersonaAndSubscriptions>;
     createOrUpdate(data: Nomalism.ChatSubscriber.ICreateOrUpdateRequest): Promise<string>;
     deleteOne({ id }: Nomalism.shared.IFindByIdRequest): Promise<void>;
     deleteByDocumentHeader({ id }: Nomalism.shared.IFindByIdRequest): Promise<void>;
+    publicAuthenticate({ id }: Nomalism.shared.IFindByIdRequest): Promise<string | null>;
 }

package/dist/modules/user/sessions.d.ts

@@ -5,4 +5,5 @@ export default class Repository implements Nomalism.Sessions.IRepository {
     private api;
     constructor({ api, route }: IModuleConstructor);
     create(body: Nomalism.Sessions.ICreateRequest): Promise<Nomalism.Sessions.ICreateResponse>;
+    logout(): Promise<void>;
 }

package/dist/modules/user/systemModule.d.ts

@@ -0,0 +1,10 @@
+import Nomalism from '@nomalism-com/types';
+import { IModuleConstructor } from '../../main';
+export default class Repository implements Nomalism.SystemModule.IRepository {
+    route: string;
+    private api;
+    constructor({ api, route }: IModuleConstructor);
+    find(): Promise<Nomalism.SystemModule.IFindResponseItem[]>;
+    findByStoreOperatorId(selector: Nomalism.SystemModule.IFindByStoreOperatorIdRequest): Promise<Nomalism.SystemModule.IFindByStoreOperatorIdResponse>;
+    setStoreOperatorModules(body: Nomalism.SystemModule.ISetStoreOperatorModulesRequest): Promise<void>;
+}

package/dist/modules/user/timeSheet.d.ts

@@ -0,0 +1,12 @@
+import Nomalism from '@nomalism-com/types';
+import { IModuleConstructor } from '../../main';
+export default class TimesheetRepository implements Nomalism.TimeSheet.IApi {
+    route: string;
+    private api;
+    constructor({ api, route }: IModuleConstructor);
+    find(params?: Nomalism.TimeSheet.IFindRequest): Promise<Nomalism.TimeSheet.Entity[]>;
+    findById(selector: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.TimeSheet.Entity | null>;
+    create(body: Nomalism.TimeSheet.ICreateRequest): Promise<Nomalism.TimeSheet.Entity>;
+    update(selector: Nomalism.shared.IFindByIdRequest, body: Nomalism.TimeSheet.IUpdateRequest): Promise<Nomalism.TimeSheet.Entity | null>;
+    deleteOne(selector: Nomalism.shared.IFindByIdRequest): Promise<Nomalism.TimeSheet.Entity | null>;
+}

package/dist/modules/view/webSocket.d.ts

@@ -0,0 +1,7 @@
+import type Nomalism from '@nomalism-com/types';
+import type { IModuleConstructor } from '../../main';
+export default class Service implements Nomalism.WebSocket.IClient {
+    route: string;
+    constructor({ route }: IModuleConstructor);
+    openSocket<T extends Nomalism.WebSocket.IEvent>({ token, channel, onEvent, onOpen, onReconnect, onClose, onAuthUnverified, }: Nomalism.WebSocket.SocketOptions<T>): Nomalism.WebSocket.SocketHandle;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomalism-com/api",
   "description": "A nomalism API package for performing HTTP requests on API endpoints",
-  "version": "1.3.34",
+  "version": "1.3.37",
   "author": "Nomalism <it.nomalism@gmail.com> (https://https://nomalism.com/)",
   "license": "UNLICENSED",
   "type": "module",
@@ -23,19 +23,19 @@
     "prepack": "npm run lint && npm run build"
   },
   "dependencies": {
-    "@nomalism-com/types": "^1.3.37",
-    "axios": "^1.16.0"
+    "@nomalism-com/types": "^1.3.39",
+    "axios": "^1.17.0"
   },
   "devDependencies": {
-    "@swc/core": "^1.15.33",
-    "@types/node": "^24.12.4",
-    "@typescript-eslint/eslint-plugin": "^8.59.3",
-    "@typescript-eslint/parser": "^8.59.3",
+    "@swc/core": "^1.15.41",
+    "@types/node": "^24.13.2",
+    "@typescript-eslint/eslint-plugin": "^8.61.0",
+    "@typescript-eslint/parser": "^8.61.0",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "eslint-plugin-prettier": "^5.5.5",
-    "prettier": "^3.8.3",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-prettier": "^5.5.6",
+    "prettier": "^3.8.4",
     "tsup": "^8.5.1"
   },
   "repository": {

package/dist/modules/user/logout.d.ts

@@ -1,7 +0,0 @@
-import { IModuleConstructor } from '../../main';
-export default class Repository {
-    route: string;
-    private api;
-    constructor({ api, route }: IModuleConstructor);
-    logout(): Promise<void>;
-}