ixc-orm 1.1.2 → 1.2.0

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/ixcclient.ts","../src/index.ts","../src/request.ts","../src/types.ts"],"version":"5.6.2"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ixc-orm",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",
@@ -28,13 +28,13 @@
     "url": "https://github.com/SousaFelipe/ixc-orm/issues"
   },
   "dependencies": {
-    "axios": "^1.7.5",
+    "axios": "^1.7.7",
     "dotenv": "^16.4.5"
   },
   "devDependencies": {
-    "@types/node": "^22.5.0",
-    "nodemon": "^3.1.4",
+    "@types/node": "^22.5.5",
+    "nodemon": "^3.1.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.5.4"
+    "typescript": "^5.6.2"
   }
 }

package/src/IXCClient.ts

@@ -1,184 +0,0 @@
-import { AxiosError } from 'axios';
-import { createAxiosInstance, createRequestPayload } from './request';
-import { IXCOperator, IXCOptions, IXCQuery, IXCResponse, IXCSortOrder } from './types';
-
-
-
-export default abstract class IXCClient {
-
-
-  protected table: string;
-  protected params: IXCQuery[];
-  protected options: IXCOptions;
-
-
-  /**
-   * 
-   * @param table O nome da tabela correspondente ao banco de dados do seu servidor IXC
-   * @see {@link https://wikiapiprovedor.ixcsoft.com.br/index.php}
-   */
-  constructor(table: string) {
-
-    this.table = table;
-    this.params = [];
-
-    this.options = {
-      page: 1,
-      rowsPerPage: 20,
-      sortName: 'id',
-      sortOrder: 'asc'
-    };
-  }
-
-
-  /**
-   * 
-   * @param whereClauses Um array de strings, no formato [coluna, operador, valor]
-   * Obs: se você passar um array no formato [coluna, valor] o operador será considerado como '='
-   * Operadores válidos: =, !=, >, <, >=, <=, LIKE
-   * @returns A própria instância
-   */
-  where(whereClauses: string[]) : IXCClient {
-
-    if (whereClauses.length > 3) {
-      throw new Error(
-        `> O array de cláusulas não pode conter mais de 3 elementos.`
-      );
-    }
-    
-    const [
-      alwaysColumn,
-      operatorOrValue,
-      valueOrUndefined
-    ] = whereClauses;
-
-    const availableOperators = Object.keys(IXCOperator);
-
-    if (whereClauses.length > 2 && !availableOperators.includes(operatorOrValue)) {
-      throw new Error(
-        `> O operador ${ operatorOrValue }, não faz parte dos operadores válidos: ${ availableOperators }.`
-      );
-    }
-
-    this.params.push({
-      TB: alwaysColumn,
-      OP: valueOrUndefined ? operatorOrValue : '=',
-      P: valueOrUndefined ? valueOrUndefined : operatorOrValue
-    });
-
-    return this;
-  }
-
-
-  /**
-   * 
-   * @param column A coluna que será usada para ordenar a busca
-   * @param order A ordem da busca ('asc'ou 'desc')
-   * @returns A própria instância
-   */
-  orderBy(column: string, order: keyof typeof IXCSortOrder) : IXCClient {
-    this.options.sortName = column;
-    this.options.sortOrder = order;
-    return this;
-  }
-
-
-  /**
-   * 
-   * @param pg O número da página que será solicitada ao IXC
-   * @param rows A quantidade de linhas (registros) por página
-   * @returns Promise<null | IXCResponse | AxiosError>
-   */
-  async get(pg?: number, rows?: number) : Promise<null | IXCResponse | AxiosError> {
-
-    const { page, rowsPerPage, ...rest } = this.options;
-
-    const opts = {
-      page: pg ?? page,
-      rowsPerPage: rows ?? rowsPerPage,
-      ...rest
-    };
-
-    const axios = createAxiosInstance('GET');
-    const payload = createRequestPayload(this.table, this.params, opts);
-    
-    try {
-      const response = await axios.get<IXCResponse>(this.table, payload);
-      return response.data;
-    }
-    catch (error: any) {
-      console.error(error);
-
-      if (error instanceof AxiosError) {
-        return error;
-      }
-
-      return null;
-    }
-    finally {
-      this.params = [];
-      this.options = {
-        page: 1,
-        rowsPerPage: 20,
-        sortName: 'id',
-        sortOrder: 'asc'
-      };
-    }
-  }
-
-
-  /**
-   * 
-   * @param body Um objeto no formado "chave: valor" contendo as informações do novo registro
-   * a ser inserido no banco de dados do seu servidor IXC
-   * @returns Promise<null | IXCResponse | AxiosError> 
-   */
-  async post(body?: { [key: string]: any }) : Promise<null | IXCResponse | AxiosError> {
-    const axios = createAxiosInstance('POST');
-    
-    try {
-      const response = await axios.post<IXCResponse>(this.table, { data: body });
-      return response.data;
-    }
-    catch (error: any) {
-      console.error(error);
-
-      if (error instanceof AxiosError) {
-        return error;
-      }
-
-      return null;
-    }
-    finally {
-      this.params = [];
-    }
-  }
-
-
-  /**
-   * 
-   * @param id O id do registro que será alterado
-   * @param body Um objeto no formado "chave : valor" contendo as colunas que serão alteradas
-   * @returns Promise<null | IXCResponse | AxiosError>
-   */
-  async put(id: number, body?: { [key: string]: any }) : Promise<null | IXCResponse | AxiosError> {
-    const axios = createAxiosInstance('PUT');
-
-    try {
-      const response = await axios.put<IXCResponse>(`${ this.table }/${ id }`, { data: body });
-      return response.data;
-    }
-    catch (error: any) {
-      console.error(error);
-
-      if (error instanceof AxiosError) {
-        return error;
-      }
-
-      return null;
-    }
-    finally {
-      this.params = [];
-    }
-  }
-}

package/src/index.ts

@@ -1,37 +0,0 @@
-import path from 'path';
-import dotenv from 'dotenv';
-
-import IXCClient from './IXCClient';
-
-import {
-  IXCOperator,
-  IXCOptions,
-  IXCQuery,
-  IXCRequest,
-  IXCRequestMethods,
-  IXCResponse,
-  IXCSortOrder
-} from './types';
-
-
-
-const env = dotenv.config({
-  path: path.join(__dirname, `../.env`)
-});
-
-if (env.error) {
-  console.error(env.error);
-  process.exit(-1);
-}
-
-
-export {
-  IXCClient,
-  IXCOperator,
-  IXCOptions,
-  IXCQuery,
-  IXCRequest,
-  IXCRequestMethods,
-  IXCResponse,
-  IXCSortOrder
-};

package/src/request.ts

@@ -1,77 +0,0 @@
-import axios, { AxiosInstance, AxiosRequestConfig } from 'axios';
-import { IXCOptions, IXCQuery, IXCRequest, IXCRequestMethods } from './types';
-
-
-/**
- * 
- * @param method GET | POST | PUT
- * @returns A instância de um objeto do tipo AxiosInstance, pré-configurado com os cabeçalhos necessários
- */
-export function createAxiosInstance(method: keyof typeof IXCRequestMethods = 'GET') : AxiosInstance {
-
-  const host = process.env.IXC_HOST;
-  const token = process.env.IXC_TOKEN;
-
-  return axios.create({
-    method: method,
-    baseURL: host ?? 'http://127.0.0.1/webservice/v1',
-    headers: {
-      'ixcsoft': (method === 'GET') ? 'listar' : '',
-      'Content-Type': 'application/json',
-      'Authorization': `Basic ${ Buffer.from(token ?? '').toString('base64') }`
-    }
-  });
-}
-
-
-/**
- * 
- * @param table Nome da tabela do IXC onde será feita a busca, atualização, inserção ou remoção
- * @param params Parâmetros da busca (desconciderado quando a ação é a de inserir novos registros)
- * @param options Parâmetros de formatação dos dados da responsta (página, ítens por página e ordenação)
- * @returns 
- */
-export function createRequestPayload(
-  table: string,
-  params: IXCQuery | IXCQuery[],
-  options?: IXCOptions
-) : AxiosRequestConfig<IXCRequest> {
-
-  const page = options?.page ?? 1;
-  const rowsPerPage = options?.rowsPerPage ?? 20;
-  const sortName = options?.sortName ?? 'id';
-  const sortOrder = options?.sortOrder ?? 'asc';
-
-  if (Array.isArray(params)) {
-    let grid_param: object[] = [];
-
-    params.forEach(p => {
-      grid_param.push({
-        TB: `${table}.${p.TB}`,
-        OP: p.OP || '=',
-        P: p.P
-      });
-    });
-
-    return { data: {
-      qtype: table,
-      query: '',
-      oper: '',
-      page: page,
-      rp: rowsPerPage,
-      sortname: `${table}.${sortName}`,
-      sortorder: sortOrder,
-      grid_param: JSON.stringify(grid_param)
-    }};
-  }
-
-  return { data: {
-    qtype: `${table}.${params.TB}`,
-    query: params.P,
-    oper: params.OP || '=',
-    page: page,
-    rp: rowsPerPage,
-    sortname: `${table}.${sortName}`,
-    sortorder: sortOrder
-  }};
-}

package/src/types.ts

@@ -1,61 +0,0 @@
-
-
-
-export const IXCOperator = {
-  '=':    '=',
-  '>':    '>',
-  '<':    '<',
-  '>=':   '>=',
-  '<=':   '<=',
-  '!=':   '!=',
-  'LIKE': 'L'
-}
-
-export const IXCSortOrder = {
-  asc: 'asc',
-  desc: 'desc'
-}
-
-export const IXCRequestMethods = {
-  GET: 'GET',
-  POST: 'POST',
-  PUT: 'PUT',
-  DELETE: 'DELETE'
-}
-
-
-export interface IXCOptions {
-  page: number,
-  rowsPerPage?: number,
-  sortName?: string,
-  sortOrder?: keyof typeof IXCSortOrder
-}
-
-
-export interface IXCQuery {
-  TB: string,
-  OP?: string,
-  P: string
-}
-
-
-export interface IXCRequest {
-  qtype: string,
-  query: string,
-  oper: string,
-  page: number,
-  rp: number,
-  sortname: string,
-  sortorder: string,
-  grid_param?: string
-}
-
-
-export interface IXCResponse {
-  error?: boolean | object,
-  message?: string | null,
-  id?: string | number,
-  page: number | string,
-  total: number,
-  registros: Array<{ [key: string]: any }>
-}