@gesagro/jaspion-sdk 1.0.11 → 2.0.1

package/README.md

@@ -1,7 +1,66 @@
+# @gesagro/jaspion-sdk
+
+SDK para o Jaspion.
+
+O SDK é agnóstico de transporte: ele não faz requisições HTTP diretamente.
+Em vez disso, você fornece uma implementação de `HttpClient`, que pode ser
+construída sobre qualquer biblioteca HTTP.
+
+## Instalação
+
 ```bash
-npm version x.x.x
+npm install @gesagro/jaspion-sdk
 ```
 
-```bash
-npm publish
+## Uso com axios
+
+### 1. Implemente o `HttpClient`
+
+O contrato é simples: receber um `HttpRequest` e devolver um `HttpResponse`.
+
+```ts
+import axios, { type AxiosInstance } from 'axios'
+import type { HttpClient, HttpRequest, HttpResponse } from '@gesagro/jaspion-sdk'
+
+export class AxiosHttpClient implements HttpClient {
+  constructor(private readonly instance: AxiosInstance) {}
+
+  async request<T>({
+    method,
+    path,
+    body,
+    headers,
+  }: HttpRequest): Promise<HttpResponse<T>> {
+    const response = await this.instance.request<T>({
+      method,
+      url: path,
+      data: body,
+      headers,
+    })
+
+    return {
+      status: response.status,
+      data: response.data,
+    }
+  }
+}
+```
+
+### 2. Instancie o `Jaspion`
+
+A `baseURL` e a autenticação ficam na instância do axios, mantendo o SDK
+focado apenas nos recursos da API.
+
+```ts
+import axios from 'axios'
+import { Jaspion } from '@gesagro/jaspion-sdk'
+import { AxiosHttpClient } from './axios-http-client'
+
+const instance = axios.create({
+  baseURL: 'https://api.jaspion.com',
+})
+
+const jaspion = new Jaspion({
+  http: new AxiosHttpClient(instance),
+})
 ```

package/dist/index.d.mts

@@ -1,9 +1,16 @@
-declare class HttpClient {
-    private readonly baseUrl;
-    private headers;
-    constructor(baseUrl: string);
-    setHeader(key: string, value: string): void;
-    post(path: string, body: unknown): Promise<void>;
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface HttpRequest {
+    method: HttpMethod;
+    path: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+interface HttpResponse<T = unknown> {
+    status: number;
+    data: T;
+}
+interface HttpClient {
+    request<T = unknown>(request: HttpRequest): Promise<HttpResponse<T>>;
 }
 
 interface CsvReport {
@@ -341,6 +348,26 @@ declare class FarrowingCollectionForm extends Report implements PdfReport {
     pdf(input: FarrowingCollectionFormInput): Promise<void>;
 }
 
+interface FarrowingForecastInput {
+    farmId: string;
+    dateRange: {
+        start: string;
+        end: string;
+    };
+    calendarType: CalendarType;
+    parity: number | null;
+    locationId: string | null;
+    pen: string | null;
+}
+declare class FarrowingForecast extends Report implements PdfReport, CsvReport {
+    readonly template = "@pig-master/farrowing-forecast";
+    fileName: string;
+    pdf(input: FarrowingForecastInput): Promise<void>;
+    csv(input: FarrowingForecastInput): Promise<void>;
+    private getResources;
+    private getParameters;
+}
+
 interface FarrowingListInput {
     farmId: string;
     calendarType: CalendarType;
@@ -724,6 +751,7 @@ declare class FemaleSwineRecord extends Report implements PdfReport {
 
 interface FemaleSwineSalePlanningListInput {
     farmId: string;
+    query: string | null;
     dateRange: {
         start: string;
         end: string;
@@ -963,6 +991,29 @@ declare class MaternityPigletTransferCollectionForm extends Report implements Pd
     pdf(input: MaternityPigletTransferCollectionFormInput): Promise<void>;
 }
 
+interface MaternityPigletTransferListInput {
+    dateRange: {
+        start: string;
+        end: string;
+    } | null;
+    calendarType: CalendarType;
+    donorId: string | null;
+    donorParity: number | null;
+    donorContext: MaternityContext | null;
+    recipientId: string | null;
+    recipientParity: number | null;
+    recipientContext: MaternityContext | null;
+    farmId: string;
+}
+declare class MaternityPigletTransferList extends Report implements PdfReport, CsvReport {
+    readonly template = "@pig-master/maternity-piglet-transfer-list";
+    fileName: string;
+    pdf(input: MaternityPigletTransferListInput): Promise<void>;
+    csv(input: MaternityPigletTransferListInput): Promise<void>;
+    private getResources;
+    private getParameters;
+}
+
 type FemaleSwineArrivalReproductiveStatus = 'virgin' | 'pregnant' | 'empty';
 
 type MatingContext = 'first' | 'normal' | 'estrus-return' | 'post-reproductive-failure';
@@ -1321,6 +1372,28 @@ declare class WeaningCollectionForm extends Report implements PdfReport {
     pdf(input: WeaningCollectionFormInput): Promise<void>;
 }
 
+interface WeaningForecastInput {
+    farmId: string;
+    weaningDate: string;
+    calendarType: CalendarType;
+    parity: number | null;
+    locationId: string | null;
+    pen: string | null;
+    lactationLengthRange: {
+        start: number;
+        end: number;
+    } | null;
+    orderBy: OrderBy<'earTag' | 'lactatingLength' | 'parity' | 'locationName' | 'createdAt'>;
+}
+declare class WeaningForecast extends Report implements PdfReport, CsvReport {
+    readonly template = "@pig-master/weaning-forecast";
+    fileName: string;
+    pdf(input: WeaningForecastInput): Promise<void>;
+    csv(input: WeaningForecastInput): Promise<void>;
+    private getResources;
+    private getParameters;
+}
+
 interface WeaningListInput {
     farmId: string;
     dateRange: {
@@ -1421,15 +1494,18 @@ declare class PigMaster {
     readonly maternityPigletDeathList: MaternityPigletDeathList;
     readonly weaningList: WeaningList;
     readonly farrowingList: FarrowingList;
+    readonly maternityPigletTransferList: MaternityPigletTransferList;
+    readonly weaningForecast: WeaningForecast;
+    readonly farrowingForecast: FarrowingForecast;
     constructor(http: HttpClient);
 }
 
-declare class JaspionClient {
-    private readonly http;
+interface JaspionConfig {
+    http: HttpClient;
+}
+declare class Jaspion {
     readonly pigMaster: PigMaster;
-    constructor(http: HttpClient);
-    setAccessToken(token: string): void;
+    constructor({ http }: JaspionConfig);
 }
-declare function jaspion(baseUrl: string): JaspionClient;
 
-export { jaspion };
+export { type HttpClient, type HttpMethod, type HttpRequest, type HttpResponse, Jaspion, type JaspionConfig };

package/dist/index.d.ts

@@ -1,9 +1,16 @@
-declare class HttpClient {
-    private readonly baseUrl;
-    private headers;
-    constructor(baseUrl: string);
-    setHeader(key: string, value: string): void;
-    post(path: string, body: unknown): Promise<void>;
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface HttpRequest {
+    method: HttpMethod;
+    path: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+interface HttpResponse<T = unknown> {
+    status: number;
+    data: T;
+}
+interface HttpClient {
+    request<T = unknown>(request: HttpRequest): Promise<HttpResponse<T>>;
 }
 
 interface CsvReport {
@@ -341,6 +348,26 @@ declare class FarrowingCollectionForm extends Report implements PdfReport {
     pdf(input: FarrowingCollectionFormInput): Promise<void>;
 }
 
+interface FarrowingForecastInput {
+    farmId: string;
+    dateRange: {
+        start: string;
+        end: string;
+    };
+    calendarType: CalendarType;
+    parity: number | null;
+    locationId: string | null;
+    pen: string | null;
+}
+declare class FarrowingForecast extends Report implements PdfReport, CsvReport {
+    readonly template = "@pig-master/farrowing-forecast";
+    fileName: string;
+    pdf(input: FarrowingForecastInput): Promise<void>;
+    csv(input: FarrowingForecastInput): Promise<void>;
+    private getResources;
+    private getParameters;
+}
+
 interface FarrowingListInput {
     farmId: string;
     calendarType: CalendarType;
@@ -724,6 +751,7 @@ declare class FemaleSwineRecord extends Report implements PdfReport {
 
 interface FemaleSwineSalePlanningListInput {
     farmId: string;
+    query: string | null;
     dateRange: {
         start: string;
         end: string;
@@ -963,6 +991,29 @@ declare class MaternityPigletTransferCollectionForm extends Report implements Pd
     pdf(input: MaternityPigletTransferCollectionFormInput): Promise<void>;
 }
 
+interface MaternityPigletTransferListInput {
+    dateRange: {
+        start: string;
+        end: string;
+    } | null;
+    calendarType: CalendarType;
+    donorId: string | null;
+    donorParity: number | null;
+    donorContext: MaternityContext | null;
+    recipientId: string | null;
+    recipientParity: number | null;
+    recipientContext: MaternityContext | null;
+    farmId: string;
+}
+declare class MaternityPigletTransferList extends Report implements PdfReport, CsvReport {
+    readonly template = "@pig-master/maternity-piglet-transfer-list";
+    fileName: string;
+    pdf(input: MaternityPigletTransferListInput): Promise<void>;
+    csv(input: MaternityPigletTransferListInput): Promise<void>;
+    private getResources;
+    private getParameters;
+}
+
 type FemaleSwineArrivalReproductiveStatus = 'virgin' | 'pregnant' | 'empty';
 
 type MatingContext = 'first' | 'normal' | 'estrus-return' | 'post-reproductive-failure';
@@ -1321,6 +1372,28 @@ declare class WeaningCollectionForm extends Report implements PdfReport {
     pdf(input: WeaningCollectionFormInput): Promise<void>;
 }
 
+interface WeaningForecastInput {
+    farmId: string;
+    weaningDate: string;
+    calendarType: CalendarType;
+    parity: number | null;
+    locationId: string | null;
+    pen: string | null;
+    lactationLengthRange: {
+        start: number;
+        end: number;
+    } | null;
+    orderBy: OrderBy<'earTag' | 'lactatingLength' | 'parity' | 'locationName' | 'createdAt'>;
+}
+declare class WeaningForecast extends Report implements PdfReport, CsvReport {
+    readonly template = "@pig-master/weaning-forecast";
+    fileName: string;
+    pdf(input: WeaningForecastInput): Promise<void>;
+    csv(input: WeaningForecastInput): Promise<void>;
+    private getResources;
+    private getParameters;
+}
+
 interface WeaningListInput {
     farmId: string;
     dateRange: {
@@ -1421,15 +1494,18 @@ declare class PigMaster {
     readonly maternityPigletDeathList: MaternityPigletDeathList;
     readonly weaningList: WeaningList;
     readonly farrowingList: FarrowingList;
+    readonly maternityPigletTransferList: MaternityPigletTransferList;
+    readonly weaningForecast: WeaningForecast;
+    readonly farrowingForecast: FarrowingForecast;
     constructor(http: HttpClient);
 }
 
-declare class JaspionClient {
-    private readonly http;
+interface JaspionConfig {
+    http: HttpClient;
+}
+declare class Jaspion {
     readonly pigMaster: PigMaster;
-    constructor(http: HttpClient);
-    setAccessToken(token: string): void;
+    constructor({ http }: JaspionConfig);
 }
-declare function jaspion(baseUrl: string): JaspionClient;
 
-export { jaspion };
+export { type HttpClient, type HttpMethod, type HttpRequest, type HttpResponse, Jaspion, type JaspionConfig };