@neo-edi/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,289 @@
+import { ListCustomersParams, EdiCustomer, CreateCustomerRequest, UpdateCustomerRequest, RegisterPartnerCustomerRequest, PartnerCustomerRegistrationResult, ListMappingTemplatesParams, EdiMappingTemplate, CreateMappingTemplateRequest, UpdateMappingTemplateRequest, CsvHeaderMappingCollection, CsvDataTransformationConfig, IngestCsvResult, DryRunResult } from '@neo-edi/types';
+export { Address, ApiResponse, CreateCustomerRequest, CreateMappingTemplateRequest, CreatePartnerRequest, CsvDataTransformationConfig, CsvHeaderMappingCollection, CsvHeaderMappingConfig, CsvHeaderTableEntry, DryRunResult, Edi852DeliverySummary, Edi852Header, Edi852HeaderFilter, Edi852Item, Edi852Location, Edi852Status, EdiCustomer, EdiMappingTemplate, EdiPartner, EdiPartnerCustomer, IngestCsvResult, ListCustomersParams, ListMappingTemplatesParams, PaginatedResponse, PartnerCustomerRegistrationResult, RegisterPartnerCustomerRequest, UpdateCustomerRequest, UpdateMappingTemplateRequest, UpdatePartnerRequest } from '@neo-edi/types';
+
+/**
+ * Base HTTP client for the SDK
+ */
+interface HttpClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface RequestOptions {
+    method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+    path: string;
+    body?: unknown;
+    query?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+}
+declare class HttpClient {
+    private baseUrl;
+    private apiKey;
+    private timeout;
+    private defaultHeaders;
+    constructor(config: HttpClientConfig);
+    request<T>(options: RequestOptions): Promise<T>;
+    private buildUrl;
+    private parseResponse;
+    get<T>(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}
+
+/**
+ * Customers resource
+ */
+
+declare class CustomersResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all customers
+     */
+    list(params?: ListCustomersParams): Promise<EdiCustomer[]>;
+    /**
+     * Get a customer by ID
+     */
+    get(customerId: string): Promise<EdiCustomer>;
+    /**
+     * Create a new customer
+     */
+    create(data: CreateCustomerRequest): Promise<EdiCustomer>;
+    /**
+     * Update a customer
+     */
+    update(customerId: string, data: UpdateCustomerRequest): Promise<EdiCustomer>;
+    /**
+     * Delete a customer
+     */
+    delete(customerId: string): Promise<void>;
+}
+
+/**
+ * Partner-Customers resource
+ */
+
+declare class PartnerCustomersResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Register customer-partner relationships
+     * Creates or activates relationships between a customer and multiple trading partners
+     */
+    register(data: RegisterPartnerCustomerRequest): Promise<PartnerCustomerRegistrationResult>;
+}
+
+/**
+ * Mapping Templates resource
+ */
+
+declare class MappingTemplatesResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List all mapping templates
+     */
+    list(params?: ListMappingTemplatesParams): Promise<EdiMappingTemplate[]>;
+    /**
+     * Get a mapping template by ID
+     */
+    get(templateId: string): Promise<EdiMappingTemplate>;
+    /**
+     * Create a new mapping template
+     */
+    create(data: CreateMappingTemplateRequest): Promise<EdiMappingTemplate>;
+    /**
+     * Update a mapping template
+     */
+    update(templateId: string, data: UpdateMappingTemplateRequest): Promise<EdiMappingTemplate>;
+    /**
+     * Delete a mapping template
+     */
+    delete(templateId: string): Promise<void>;
+}
+
+/**
+ * Ingest resource for CSV data ingestion
+ */
+
+interface UploadCsvOptions {
+    partnerId: string;
+    mappingConfig: CsvHeaderMappingCollection;
+    transformationConfig?: CsvDataTransformationConfig;
+}
+/**
+ * File input type for CSV upload
+ * In browser: File or Blob
+ * In Node.js: Use `new Blob([buffer])` to convert Buffer to Blob
+ */
+type CsvFileInput = File | Blob;
+declare class IngestResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Upload a CSV file for ingestion
+     *
+     * @example Browser
+     * ```typescript
+     * const input = document.querySelector('input[type="file"]');
+     * const file = input.files[0];
+     * await client.ingest.uploadCsv(file, options);
+     * ```
+     *
+     * @example Node.js
+     * ```typescript
+     * import { readFileSync } from 'fs';
+     * const buffer = readFileSync('data.csv');
+     * const blob = new Blob([buffer], { type: 'text/csv' });
+     * await client.ingest.uploadCsv(blob, options);
+     * ```
+     */
+    uploadCsv(file: CsvFileInput, options: UploadCsvOptions): Promise<IngestCsvResult>;
+    /**
+     * Perform a dry run of CSV ingestion (validation only)
+     */
+    dryRun(file: CsvFileInput, options: UploadCsvOptions): Promise<DryRunResult>;
+}
+
+/**
+ * GraphQL resource for flexible queries
+ */
+
+interface GraphQLRequestOptions {
+    operationName?: string;
+}
+declare class GraphQLResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Execute a GraphQL query
+     */
+    query<T>(query: string, variables?: Record<string, unknown>, options?: GraphQLRequestOptions): Promise<T>;
+    /**
+     * Execute a GraphQL mutation
+     */
+    mutate<T>(mutation: string, variables?: Record<string, unknown>, options?: GraphQLRequestOptions): Promise<T>;
+}
+/**
+ * Pre-built GraphQL queries for common operations
+ */
+declare const Queries: {
+    /**
+     * Get EDI 852 headers with filtering
+     */
+    GET_EDI_852_HEADERS: string;
+    /**
+     * Get a single EDI 852 header by ID with locations
+     */
+    GET_EDI_852_HEADER_BY_ID: string;
+    /**
+     * Get trading partner execution summaries
+     */
+    GET_EXECUTION_SUMMARIES: string;
+};
+
+/**
+ * Neo-EDI SDK Client
+ */
+
+interface NeoEdiClientConfig {
+    /**
+     * Base URL of the Neo-EDI API
+     * @example "https://api.neo-edi.com"
+     */
+    baseUrl: string;
+    /**
+     * API key for authentication
+     * @example "nedk_live_xxxxxxxxxxxx"
+     */
+    apiKey: string;
+    /**
+     * Request timeout in milliseconds (default: 30000)
+     */
+    timeout?: number;
+    /**
+     * Additional headers to send with every request
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Neo-EDI SDK Client
+ *
+ * @example
+ * ```typescript
+ * const client = new NeoEdiClient({
+ *   baseUrl: "https://api.neo-edi.com",
+ *   apiKey: "nedk_live_xxxxxxxxxxxx"
+ * });
+ *
+ * // List customers
+ * const customers = await client.customers.list({ isActive: true });
+ *
+ * // Create a customer
+ * const customer = await client.customers.create({
+ *   customerId: "ACME-001",
+ *   customerName: "Acme Corporation"
+ * });
+ *
+ * // Upload CSV data
+ * const result = await client.ingest.uploadCsv(file, {
+ *   partnerId: "PARTNER-001",
+ *   mappingConfig: { ... }
+ * });
+ *
+ * // Run GraphQL query
+ * const data = await client.graphql.query(
+ *   `query { edi852Headers { id reportDate } }`
+ * );
+ * ```
+ */
+declare class NeoEdiClient {
+    private http;
+    /**
+     * Customer management operations
+     */
+    readonly customers: CustomersResource;
+    /**
+     * Partner-Customer relationship operations
+     */
+    readonly partnerCustomers: PartnerCustomersResource;
+    /**
+     * Mapping template operations
+     */
+    readonly mappingTemplates: MappingTemplatesResource;
+    /**
+     * CSV data ingestion operations
+     */
+    readonly ingest: IngestResource;
+    /**
+     * GraphQL query operations
+     */
+    readonly graphql: GraphQLResource;
+    constructor(config: NeoEdiClientConfig);
+}
+
+/**
+ * SDK error types
+ */
+declare class NeoEdiError extends Error {
+    readonly code?: string | undefined;
+    readonly statusCode?: number | undefined;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code?: string | undefined, statusCode?: number | undefined, details?: Record<string, unknown> | undefined);
+}
+declare class NeoEdiApiError extends NeoEdiError {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number, code?: string, details?: Record<string, unknown>);
+}
+declare class NeoEdiNetworkError extends NeoEdiError {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+declare class NeoEdiValidationError extends NeoEdiError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+
+export { type CsvFileInput, NeoEdiApiError, NeoEdiClient, type NeoEdiClientConfig, NeoEdiError, NeoEdiNetworkError, NeoEdiValidationError, Queries, type UploadCsvOptions };