@zensoftbr/zenerpclient 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+# @zensoftbr/zenerpclient
+
+Este projeto visa desenvolver um software cliente inovador, projetado para integrar-se perfeitamente com o sistema de gestão Zen Erp. Nosso objetivo é oferecer uma solução que não apenas melhore a eficiência operacional, mas também enriqueça a experiência dos desenvolvedores através de funcionalidades intuitivas e personalizadas. Ideal para desenvolvedores que desejam explorar novas possibilidades e criar soluções impactantes no ecossistema Zen Erp.
+
+## Instalação
+
+```bash
+npm install @zensoftbr/zenerpclient
+```
+
+## jsconfig.json
+
+Pode ser necessário configurar o arquivo `jsconfig.json` para que o intellisense do VS Code funcione corretamente.
+
+```json
+{
+  "compilerOptions": {
+    "module": "NodeNext"
+  }
+}
+```
+
+## Importação
+
+Os componentes devem ser importados individualmente, possibilitando a realização de tree-shaking no projeto.
+
+```js
+import { connect } from "@zensoftbr/zenerpclient";
+import { PersonService } from "@zensoftbr/zenerpclient/api/catalog/person/PersonService";
+
+const z = await connect("tenant", "user", "password", {
+  locale: "pt-BR",
+  timeZone: "America/Sao_Paulo",
+});
+
+const personService = new PersonService(z);
+const person = await personService.personReadById(1001);
+```
+
+Também é possível importar o bundle completo em uma variável e utilizar esta variável para acessar os componentes.
+
+```js
+import * as Z from "@zensoftbr/zenerpclient";
+
+const z = await Z.connect("tenant", "user", "password", {
+  locale: "pt-BR",
+  timeZone: "America/Sao_Paulo",
+});
+
+const personService = new Z.api.catalog.person.PersonService(z);
+const person = await personService.personReadById(1001);
+```
+
+> **Atenção**
+> Independentemente do formato utilizado, procure manter um padrão de uso no projeto para facilitar manutenções no código.
+
+## Conexão
+
+### Inicializando e conectando um cliente
+
+```js
+import { connect } from "@zensoftbr/zenerpclient";
+
+const z = await connect("tenant", "user", "password", {
+  locale: "pt-BR",
+  timeZone: "America/Sao_Paulo",
+});
+
+```
+
+### Criando um cliente a partir de um token
+
+```js
+import { createFromToken } from "@zensoftbr/zenerpclient";
+
+const z = createFromToken("tenant", "token");
+```
+
+## Métodos `fetch` (z.web)
+
+Coleção de métodos otimizados para interação direta com endpoints via solicitações fetch.
+
+### Fetch de blob
+
+```js
+const blob = await z.web.fetchBlob("/catalog/category");
+```
+
+### Fetch de json
+
+```js
+const json = await z.web.fetchJson("/catalog/category");
+```
+
+### Fetch de texto
+
+```js
+const text = await z.web.fetchText("/catalog/category");
+```
+
+### Fetch de response
+
+```js
+const response = await z.web.fetch("/catalog/category");
+```
+
+### Fetch de response com validação de status 
+
+Este método lança um erro se o status for >= 300
+
+```js
+const response = await z.web.fetchOk("/catalog/category");
+```
+
+### Tratamento de response
+
+Este método lança um erro se o status for >= 300
+
+```js
+const response = await z.web.fetch("/catalog/category");
+await z.web.handleResponse(response);
+```
+
+## Encapsulamento de API (z.api)
+
+Coleção de objetos que representam a estrutura da API e podem ser utilizados para acessar a API de forma mais simplificada e orientada a objetos.
+
+### Chamando métodos da API
+
+As classes de serviços devem ser instanciadas com uma instância do cliente como argumento do construtor.
+
+```js
+import { CatalogService } from "@zensoftbr/zenerpclient/api/catalog/CatalogService";
+
+const catalogService = new CatalogService(z);
+```
+
+```js
+import { CatalogService } from "@zensoftbr/zenerpclient/api/catalog/CatalogService";
+import { Category } from "@zensoftbr/zenerpclient/api/catalog/Category";
+
+const catalogService = new CatalogService(z);
+
+let category = new Category();
+category.code = "TOOLS";
+category.description = "Tools";
+
+category = await catalogService.categoryCreate(category);
+```
+
+```js
+import { SaleService } from "@zensoftbr/zenerpclient/api/sale/SaleService";
+
+const saleService = SaleService(z);
+
+let sale;
+
+sale = await saleService.saleOpPrepare(1001);
+sale = await saleService.saleOpApprove(1001);
+```
+
+## Internacionalização (z.i18n)
+
+Conjunto avançado de funções especializadas na tradução de textos e na formatação de datas, horas e números de acordo com a nacionalidade e localização do operador.
+
+### Traduzindo chaves de recursos
+
+```js
+const i18n = await z.i18n; // primeira chamada retorna uma promise, próximas chamadas retornam um objeto
+
+i18n.getResource("@@:/@word/yes"); // retorna "Sim" para "pt-BR", "Yes" para "en-US"
+i18n.format("@@:/catalog/category/error/notFound", "ACESSORIOS"); // retorna "Categoria ACESSORIOS não encontrada" para "pt-BR"
+```
+
+### Formatando dados
+
+```js
+i18n.formatDate("2024-01-31"); // retorna "31/01/2024" para "pt-BR"
+i18n.formatDate(new Date("2024-01-31")); // retorna "31/01/2024" para "pt-BR"
+i18n.formatNumber(1000.12345, { digits: 2 }); // retorna "1.000,12" para "pt-BR"
+i18n.formatNumber(1000.12345, { minDigits: 2, maxDigits: 4 }); // retorna "1.000,1234" para "pt-BR"
+```

package/README.publish.md

@@ -0,0 +1,32 @@
+* Change project version in `package.json`
+
+* Commit the project
+
+```bash
+git stage *
+git commit -m "v1.0.0"
+```
+
+* Create an annotated tag
+
+```bash
+git tag -a v1.0.0 -m "v1.0.0"
+```
+
+* Push
+
+```bash
+git push
+```
+
+* Push tag to remote
+
+```bash
+git push origin --tags -f
+```
+
+* Publish the project
+
+```bash
+npm publish
+```

package/README.tips.md

@@ -0,0 +1,3 @@
+https://github.com/microsoft/TypeScript/issues/56412
+
+https://thesametech.com/how-to-build-typescript-project

package/dist/cjs/Client.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connect = exports.createFromToken = exports.Client = void 0;
+const I18n_js_1 = require("./I18n.js");
+const Web_js_1 = __importDefault(require("./Web.js"));
+class Client {
+    #tenant;
+    #token;
+    #jwt;
+    #debug = false;
+    #i18n;
+    #web;
+    constructor(tenant, token) {
+        this.#tenant = tenant;
+        this.#token = token;
+        this.#jwt = jwt(token);
+    }
+    async close() {
+        // this.fetch();
+    }
+    async fetch(input, init) {
+        const _input = `${this.#tenant}${input}`;
+        const _init = init ?? {};
+        // Add authorization header
+        const authorization = `Bearer ${this.#token}`;
+        if (_init.headers instanceof Headers) {
+            _init.headers.append("Authorization", authorization);
+        }
+        else if (Array.isArray(_init.headers)) {
+            _init.headers.push(["Authorization", authorization]);
+        }
+        else if (_init.headers) {
+            _init.headers.Authorization = authorization;
+        }
+        else {
+            _init.headers = { Authorization: authorization };
+        }
+        if (this.#debug) {
+            console.debug(`${_init.method ?? "GET"} ${input}`);
+        }
+        return fetch(_input, _init);
+    }
+    // get api() {
+    //   if (!this.#api)
+    //     this.#api = new Api(this);
+    //   return this.#api;
+    // }
+    get i18n() {
+        if (!this.#i18n)
+            this.#i18n = (async () => {
+                return (0, I18n_js_1.createI18n)(this);
+            })();
+        return this.#i18n;
+    }
+    get jti() {
+        return this.#jwt.jti;
+    }
+    get jwt() {
+        return this.#token;
+    }
+    get language() {
+        return this.#jwt.locale;
+    }
+    get timeZone() {
+        return this.#jwt.timeZone;
+    }
+    get user() {
+        return this.#jwt.sub;
+    }
+    get web() {
+        if (!this.#web)
+            this.#web = new Web_js_1.default(this);
+        return this.#web;
+    }
+}
+exports.Client = Client;
+function createFromToken(host, token, options) {
+    if (!host)
+        throw new Error("Missing argument: host");
+    if (!token)
+        throw new Error("Missing argument: token");
+    // Tenant
+    if (!host.toLowerCase().startsWith("http"))
+        host = `https://${host}.zenerp.app.br:8443`;
+    return new Client(host, token);
+}
+exports.createFromToken = createFromToken;
+async function connect(host, user, password, properties) {
+    if (!host)
+        throw new Error("Missing argument: host");
+    if (!user)
+        throw new Error("Missing argument: user");
+    // Tenant
+    if (!host.toLowerCase().startsWith("http"))
+        host = `https://${host}.zenerp.app.br:8443`;
+    const response = await fetch(`${host}/system/security/tokenOpRequest`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+        },
+        body: JSON.stringify({
+            email: user,
+            password,
+            properties,
+        }),
+    });
+    if (!response.ok) {
+        const o = await response.json();
+        // throw new ZenError(o.message, o.stackTrace);
+        const error = new Error(o.message);
+        error.stackTrace = o.stackTrace;
+        throw error;
+    }
+    const token = await response.text();
+    return createFromToken(host, token);
+}
+exports.connect = connect;
+function jwt(token) {
+    var base64Url = token.split(".")[1];
+    var base64 = base64Url.replace(/-/g, "+").replace(/_/g, "/");
+    var jsonPayload = decodeURIComponent(globalThis.atob(base64).split("").map(function (c) {
+        return `%${(`00${c.charCodeAt(0).toString(16)}`).slice(-2)}`;
+    }).join(""));
+    return JSON.parse(jsonPayload);
+}
+//# sourceMappingURL=Client.js.map

package/dist/cjs/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../../src/Client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/I18n.js

@@ -0,0 +1,263 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createI18n = exports.I18n = void 0;
+const luxon_1 = require("luxon");
+// import { HttpError } from "./errors";
+class I18n {
+    #locale;
+    #timeZone;
+    #resources;
+    constructor(locale, timeZone, resources) {
+        this.#locale = locale;
+        this.#timeZone = timeZone;
+        this.#resources = resources;
+    }
+    get locale() {
+        return this.#locale;
+    }
+    get timeZone() {
+        return this.#timeZone;
+    }
+    /**
+     *
+     * @param {string} key
+     * @param {string} defaultValue
+     * @returns
+     */
+    getResource(key, defaultValue) {
+        if (!key) {
+            return null;
+        }
+        const _key = key.startsWith("@@:") ? key.substring(3) : key;
+        const _defaultValue = defaultValue ?? _key;
+        const result = this.#resources[_key];
+        if (!result) {
+            return _defaultValue;
+        }
+        return result;
+    }
+    /**
+     *
+     * @param {string} key
+     * @param  {...any} args
+     * @returns string
+     */
+    format(key, ...args) {
+        const format = this.getResource(key);
+        if (!format)
+            return "";
+        const touched = [];
+        const result = format.replace(/\{(\d+)\}/g, (m, n) => {
+            touched[n] = true;
+            if (n < args.length)
+                return args[n];
+            return m;
+        });
+        const extra = [];
+        for (let index = 0; index < args.length; index++) {
+            if (!touched[index])
+                extra.push(args[index]);
+        }
+        return result + (extra.length ? ` [${extra.join(", ")}]` : "");
+    }
+    /**
+     *
+     * @param {number} number
+     * @param {string} currencyCode
+     * @returns string
+     */
+    formatCurrency(number, currencyCode = null) {
+        if (number == null)
+            return null;
+        try {
+            const result = new Intl.NumberFormat(this.#locale, {
+                style: "currency",
+                currency: currencyCode ?? this.getResource("/@system/default/currency"),
+            }).format(number);
+            // Replace &nbsp; with space
+            return result.replace(String.fromCharCode(160), " ");
+        }
+        catch {
+            return number.toString();
+        }
+    }
+    /**
+     * @param {string | Date} date
+     * @returns string
+     */
+    formatDate(date) {
+        if (date == null)
+            return null;
+        try {
+            let _date;
+            if (date instanceof Date) {
+                _date = luxon_1.DateTime.fromJSDate(date).setLocale(this.#locale);
+            }
+            else {
+                _date = luxon_1.DateTime.fromISO(date).setLocale(this.#locale);
+            }
+            return _date.startOf("day").toLocaleString({
+                year: "2-digit", month: "numeric", day: "numeric",
+            });
+        }
+        catch (error) {
+            return date;
+        }
+    }
+    /**
+     *
+     * @param {string | Date} date
+     * @returns
+     */
+    formatDateTime(date) {
+        if (date == null)
+            return null;
+        try {
+            let _date;
+            if (date instanceof Date) {
+                _date = luxon_1.DateTime.fromJSDate(date).setLocale(this.#locale);
+            }
+            else {
+                _date = luxon_1.DateTime.fromISO(date).setLocale(this.#locale);
+            }
+            return _date.toLocaleString({
+                year: "2-digit", month: "numeric", day: "numeric", hour: "numeric", minute: "numeric", second: "numeric",
+            });
+        }
+        catch {
+            return date;
+        }
+    }
+    /**
+     *
+     * @param {number} number
+     * @param {any} args
+     * @returns string
+     */
+    formatNumber(number, args) {
+        if (number == null)
+            return null;
+        try {
+            const result = new Intl.NumberFormat(args?.locale ?? this.#locale, {
+                style: "decimal",
+                minimumFractionDigits: args?.digits ?? args?.minDigits ?? 0,
+                maximumFractionDigits: args?.digits ?? args?.maxDigits ?? 20,
+            }).format(number);
+            return result || number.toString();
+        }
+        catch {
+            return number.toString();
+        }
+    }
+    /**
+     *
+     * @param {number} number
+     * @returns string
+     */
+    formatQuantity(number, args) {
+        return this.formatNumber(number, args);
+    }
+    /**
+     *
+     * @param {string} time
+     * @returns  string
+     */
+    formatTime(time) {
+        if (time == null)
+            return null;
+        try {
+            let _date;
+            if (time instanceof Date) {
+                _date = luxon_1.DateTime.fromJSDate(time).setLocale(this.#locale);
+            }
+            else {
+                _date = luxon_1.DateTime.fromISO(time).setLocale(this.#locale);
+            }
+            return _date.toLocaleString(luxon_1.DateTime.TIME_24_WITH_SECONDS);
+        }
+        catch {
+            return time;
+        }
+    }
+    /**
+     *
+     * @param {number} number
+     * @returns string
+     */
+    formatUnitValue(number) {
+        return this.formatNumber(number, { minDigits: 2, maxDigits: 8 });
+    }
+    /**
+     *
+     * @param {number} number
+     * @returns string
+     */
+    formatValue(number) {
+        return this.formatNumber(number, { digits: 2 });
+    }
+    /**
+     *
+     * @param {number} number
+     * @returns string
+     */
+    formatWeight(number) {
+        return this.formatNumber(number, { minDigits: 3, maxDigits: 6 });
+    }
+    /**
+     *
+     * @param {Node} node
+     */
+    localizeNode(node) {
+        // Localize element attribute values
+        if (node instanceof HTMLElement) {
+            Array.from(node.attributes).forEach((attr) => {
+                const tmp = attr.value.replace(/@@:([\\/@\\.\\-\\+\\#\w]+)/g, (_, b) => this.getResource(b));
+                if (tmp !== attr.value) {
+                    node.setAttribute(attr.name, tmp);
+                }
+            });
+        }
+        // Check it element is a template tag
+        const _node = node instanceof HTMLTemplateElement ? node.content : node;
+        for (const child of _node.childNodes) {
+            if (!child.hasChildNodes() && child.textContent) {
+                const tmp = child.textContent.replace(/@@:([\\/@\\.\\-\\+\\#\w]+)/g, (_, b) => this.getResource(b));
+                if (tmp !== child.textContent) {
+                    child.textContent = tmp;
+                }
+            }
+            if (_node.hasChildNodes()) {
+                this.localizeNode(child);
+            }
+        }
+    }
+    /**
+     *
+     * @param {Node} node
+     */
+    observeNode(node) {
+        this.localizeNode(node);
+        const observer = new MutationObserver((mutations) => {
+            mutations.forEach((mutation) => {
+                if (mutation.type === "childList") {
+                    for (const _node of mutation.addedNodes) {
+                        this.localizeNode(_node);
+                    }
+                }
+            });
+        });
+        observer.observe(node, {
+            attributes: true,
+            childList: true,
+            characterData: true,
+            subtree: true,
+        });
+    }
+}
+exports.I18n = I18n;
+async function createI18n(zenClient) {
+    const resources = await zenClient.web.fetchJson("/system/resources");
+    return new I18n(zenClient.language, zenClient.timeZone, resources);
+}
+exports.createI18n = createI18n;
+//# sourceMappingURL=I18n.js.map

package/dist/cjs/I18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18n.js","sourceRoot":"","sources":["../../src/I18n.ts"],"names":[],"mappings":"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"}

package/dist/cjs/Web.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class Web {
+    #zenClient;
+    constructor(zenClient) {
+        this.#zenClient = zenClient;
+    }
+    async fetch(input, init) {
+        return this.#zenClient.fetch(input, init);
+    }
+    async fetchBlob(input, init) {
+        const response = await this.#zenClient.fetch(input, init);
+        await this.handleResponse(response);
+        return response.blob();
+    }
+    async fetchJson(input, init) {
+        const response = await this.#zenClient.fetch(input, init);
+        await this.handleResponse(response);
+        const text = await response.text();
+        return text == null || text === "" ? null : JSON.parse(text);
+    }
+    async fetchJsonRequired(input, init) {
+        const result = await this.fetchJson(input, init);
+        if (result == null) {
+            throw new Error(`Not found: ${input}`);
+        }
+        return result;
+    }
+    async fetchOk(input, init) {
+        const response = await this.#zenClient.fetch(input, init);
+        await this.handleResponse(response);
+        return response;
+    }
+    async fetchText(input, init) {
+        const response = await this.#zenClient.fetch(input, init);
+        await this.handleResponse(response);
+        return response.text();
+    }
+    async handleResponse(response) {
+        if (!response.ok) {
+            const text = await response.text();
+            let error = null;
+            try {
+                const json = JSON.parse(text);
+                error = new Error(json.message ?? text);
+            }
+            catch (_) {
+                error = new Error(`${response.status} ${text}`);
+            }
+            throw error;
+        }
+    }
+}
+exports.default = Web;
+//# sourceMappingURL=Web.js.map

package/dist/cjs/Web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Web.js","sourceRoot":"","sources":["../../src/Web.ts"],"names":[],"mappings":";;AAEA,MAAqB,GAAG;IAEtB,UAAU,CAAS;IAEnB,YAAY,SAAiB;QAC3B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAwC,EAAE,IAAkB;QACtE,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAwC,EAAE,IAAkB;QAC1E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAwC,EAAE,IAAkB;QAC1E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,KAAwC,EAAE,IAAkB;QAClF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAwC,EAAE,IAAkB;QACxE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAwC,EAAE,IAAkB;QAC1E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAkB;QACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,KAAK,GAAQ,IAAI,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9B,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CAEF;AA3DD,sBA2DC"}