shopeasy-sdk 1.0.2 → 1.0.3

package/dist/index.d.cts

@@ -19,6 +19,13 @@ interface Wallet {
     createdAt: Date;
     updatedAt: Date;
 }
+interface CreateWalletArgs {
+    userId: string;
+    apiKey?: string;
+    gatewayProvider?: GatewayProvider;
+    gatewayConfig?: Record<string, unknown>;
+    isActive?: boolean;
+}
 interface UpdateWalletArgs {
     userId: string;
     data: {
@@ -59,6 +66,7 @@ interface ConfigDraftSetArgs {
     guildId: string;
     data: ConfigUpdateArgs["data"];
 }
+type paymentProvider = "mercadoPago" | "pixManual";
 type ActionPermission = "manage_products" | "manage_carts" | "manage_config" | "view_orders" | "process_payments" | "manager_payments" | "manage_roles" | "manager_bot" | "full_access";
 type RolePermissionsMap = Record<string, ActionPermission[]>;
 interface Config {
@@ -88,6 +96,7 @@ interface Config {
     updatedAt: Date;
     guild?: Guild$1;
 }
+type ConfigDraft = Partial<Omit<Config, "id">> | null;
 interface ConfigUpdateArgs {
     guildId: string;
     data: Omit<Partial<Config>, "id" | "guildId">;
@@ -154,6 +163,9 @@ interface PlanStatus {
     expireAt?: Date;
     daysUntilExpire?: number;
 }
+interface MarkAlertBody {
+    daysUntilExpire: number;
+}
 interface MarkAlertResponse {
     success: boolean;
     message: string;
@@ -173,15 +185,6 @@ interface ProductGetByReference {
     reference: string;
     guildId: string;
 }
-interface SaleProduct$1 {
-    id: string;
-    saleId: string;
-    productid: string;
-    guildId: string;
-    valueTotal: number;
-    quantiy: number;
-    product?: Product;
-}
 interface GenerateProductArgs {
     guildId: string;
     productId: string;
@@ -220,7 +223,7 @@ interface Product {
     coupon?: boolean;
     colorHex?: string | null;
     guild?: Guild | null;
-    sales?: SaleProduct$1[];
+    sales?: SaleProduct[];
     catalogs?: string[];
 }
 interface ProduductDraftSetArgs {
@@ -243,6 +246,7 @@ interface ProductUpdateArgs {
     id: string;
     data: Omit<Partial<Product>, "id" | "reference">;
 }
+type ProductDraft = Partial<Omit<Product, "id" | "reference">> | null;
 
 interface Guild {
     id: string;
@@ -283,6 +287,7 @@ interface CustomerUpdateArgs {
     id: string;
     data: Omit<Partial<Customer>, "id" | "userId" | "guildId">;
 }
+type CustomerDraft = Partial<Omit<Customer, "id" | "userId" | "guildId">> | null;
 
 interface SaleCreateArgs {
     userId: string;
@@ -361,6 +366,17 @@ interface PaymentConfig {
     walletApiKey?: string;
     chavePixchavePixStaticQrCode: boolean;
 }
+interface CreatePaymentConfigArgs {
+    guildId: string;
+    provider?: PaymentProvider;
+    mercadoPagoToken?: string;
+    efiBankToken?: string;
+    chavePix?: string;
+    chavePixType?: "CPF" | "EMAIL" | "ALEATORIA" | "NUMERO";
+    chavePixName?: string;
+    chavePixCity?: string;
+    chavePixchavePixStaticQrCode: boolean;
+}
 interface UpdatePaymentConfigArgs {
     guildId: string;
     data: {
@@ -424,6 +440,7 @@ interface Image {
     expiresIn: number;
 }
 type imageCreate = Omit<Image, "id">;
+type ImageUpdate = Omit<Image, "id" | "guildId">;
 
 type CouponStatus = "ACTIVED" | "DEACTIVATED" | "EXPIRED";
 interface Coupon {
@@ -463,6 +480,7 @@ interface CouponUpdateArgs {
     id: string;
     data: Omit<Partial<Coupon>, "id" | "reference">;
 }
+type CouponDraft = Partial<Omit<Coupon, "id" | "reference">> | null;
 
 type CatalogStatus = "ACTIVED" | "DEACTIVATED" | "BANNED";
 interface CatalogProduct {
@@ -503,6 +521,7 @@ interface CatalogUpdateArgs {
     id: string;
     data: Omit<Partial<Catalog>, "id" | "reference" | "guild" | "products">;
 }
+type CatalogDraft = Partial<Omit<Catalog, "id" | "reference" | "guild" | "products">> | null;
 interface CatalogDraftSetArgs {
     id: string;
     userId: string;
@@ -591,6 +610,190 @@ interface CartGetArgs {
     guildId: string;
 }
 
+/**
+ * Tipos de chave PIX aceitos pela A-TOS
+ */
+type AtosPixKeyType = "TELEF" | "EMAIL" | "CNPJ" | "CPF" | "CHAVE";
+/**
+ * Recipient types:
+ * 0 → divide lucro (não altera valor)
+ * 1 → comissão percentual (antes dos sócios)
+ * 2 → soma no valor cobrado (taxas / upsell)
+ */
+type AtosRecipientType = 0 | 1 | 2;
+/**
+ * Type 2 → valor fixo que SOMA ao valor cobrado
+ */
+interface AtosRecipientType2 {
+    id: string;
+    type: 2;
+    amount: number;
+    percentage?: never;
+}
+/**
+ * Type 1 → comissão percentual (antes dos sócios)
+ */
+interface AtosRecipientType1 {
+    id: string;
+    type: 1;
+    percentage: number;
+    amount?: never;
+}
+/**
+ * Type 0 → divisão de lucro entre sócios / owner
+ */
+interface AtosRecipientType0 {
+    id: string;
+    type: 0;
+    percentage: number;
+    amount?: never;
+}
+/**
+ * Union final de recipients (INPUT)
+ */
+type AtosRecipient = AtosRecipientType0 | AtosRecipientType1 | AtosRecipientType2;
+interface AtosCreatePixPaymentInput {
+    amount: number;
+    fee_to_customer?: boolean;
+    shop: {
+        /** ID lógico do servidor / loja */
+        id: string;
+        /** Nome do servidor / loja */
+        name: string;
+        /** Wallet / owner que receberá o saldo */
+        owner_id: string;
+    };
+    items: {
+        id: string;
+        name: string;
+        quantity: number;
+    }[];
+    customer: {
+        id: string;
+        name: string;
+    };
+    seller: {
+        /** CPF ou CNPJ do titular da API Key */
+        national_registration: string;
+        national_registration_name: string;
+    };
+    recipients?: AtosRecipient[];
+    overwrite_webhook_url?: string;
+}
+interface AtosCreatePixPaymentResponse {
+    id: string;
+    amount: number;
+    status: string;
+    qr_code?: string;
+    qr_code_image_url?: string;
+}
+/**
+ * Recipient retornado pelo gateway
+ */
+interface AtosRecipientResponse {
+    id: string;
+    type: AtosRecipientType;
+    percentage: number | null;
+    amount: number;
+    available_at: string | null;
+}
+/**
+ * Shop retornado
+ */
+interface AtosShopResponse {
+    id: string;
+    name: string;
+    owner_id: string;
+    created_at: string | null;
+}
+/**
+ * Item retornado
+ */
+interface AtosItemResponse {
+    id: string;
+    name: string;
+    quantity: number;
+}
+/**
+ * Customer retornado
+ */
+interface AtosCustomerResponse {
+    id: string;
+    name: string;
+    cpf: string | null;
+    email: string | null;
+    ip: string | null;
+}
+interface AtosCreatePixPaymentFullResponse {
+    id: string;
+    shop: AtosShopResponse;
+    status: "pending" | "paid" | "expired" | "refunded";
+    amount: number;
+    recipients: AtosRecipientResponse[];
+    items: AtosItemResponse[];
+    customer: AtosCustomerResponse;
+    /** Código PIX (copia e cola) */
+    data: string;
+    payer: unknown | null;
+    /** Data de expiração do PIX */
+    expire_at: string;
+    created_at: string;
+    infraction: unknown | null;
+    end2end_id: string | null;
+    receipt_file_url: string | null;
+    custom_message: string | null;
+    withdrawn: boolean;
+    withdraw_id: string | null;
+    kyc_validated: boolean;
+    /** Identificador interno do gateway */
+    identifier: string;
+}
+interface AtosRefundResponse {
+    success?: boolean;
+    status?: string;
+}
+interface AtosWithdrawInput {
+    /** Wallet / owner que está sacando */
+    withdraw_user_id: string;
+    pixKey: string;
+    pixKeyType: AtosPixKeyType;
+    baasPostbackUrl: string;
+}
+interface AtosWithdrawResponse {
+    id: string;
+    status: string;
+}
+interface AtosBalanceResponse {
+    balance: number;
+}
+
+interface Bot {
+    id: string;
+    hostingId: string | null;
+    status: "AVAILABLE" | "IN_USE" | "GRACE";
+    currentPlanId: string | null;
+    deployedAt: string | null;
+    lastUsedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BotStatus {
+    running: boolean;
+    restarted?: boolean;
+    status: string;
+    usage: {
+        cpu: string;
+        ram: string;
+        network: string;
+        storage: string;
+    };
+}
+interface BotDeploy {
+    message: string;
+    bot: Bot;
+    hostingId: string;
+}
+
 declare function cartWillExpire(cart: Cart): Promise<void>;
 declare function cartAntiFakeVerify(configs: Config, member: GuildMember): boolean;
 declare function cartVerifyPermission(cart: Cart, member: GuildMember, configs: Config): boolean;
@@ -751,7 +954,7 @@ declare class ShopEasySdk {
         create(args: SaleCreateArgs): Promise<Sale>;
         getById(id: string): Promise<Sale | null>;
         getAllByGuild(guildId: string): Promise<Sale[]>;
-        saleProductGet(id: string): Promise<SaleProduct$1 | null>;
+        saleProductGet(id: string): Promise<SaleProduct | null>;
         delete(id: string): Promise<void>;
     };
     tokens: {
@@ -771,3 +974,4 @@ declare class ShopEasySdk {
 }
 
 export { ShopEasySdk, cartAntiFakeVerify, cartCalculeTotal, cartVerifyAproved, cartVerifyPermission, cartWillExpire, formatDecimalToNumber, formatNumberToDecimal, formatPrice, formatRelativeTime, hasPermission, pixUtils };
+export type { ActionPermission, AtosBalanceResponse, AtosCreatePixPaymentFullResponse, AtosCreatePixPaymentInput, AtosCreatePixPaymentResponse, AtosCustomerResponse, AtosItemResponse, AtosPixKeyType, AtosRecipient, AtosRecipientResponse, AtosRecipientType, AtosRecipientType0, AtosRecipientType1, AtosRecipientType2, AtosRefundResponse, AtosShopResponse, AtosWithdrawInput, AtosWithdrawResponse, Bot, BotDeploy, BotStatus, Cart, CartDraft, CartDraftProduct, CartGetArgs, CartProduct, CartStatus, CartUpdateArgs, Catalog, CatalogCreateArgs, CatalogDraft, CatalogDraftGetArgs, CatalogDraftSetArgs, CatalogProduct, CatalogStatus, CatalogUpdateArgs, CheckExpirationsResponse, Config, ConfigDraft, ConfigDraftGetArgs, ConfigDraftSetArgs, ConfigUpdateArgs, Coupon, CouponCreateArgs, CouponDraft, CouponDraftGetArgs, CouponDraftSetArgs, CouponStatus, CouponUpdateArgs, CreateCartArgs, CreateCartProduct, CreatePaymentConfigArgs, CreateWalletArgs, Customer, CustomerCreateArgs, CustomerDraft, CustomerDraftGetArgs, CustomerDraftSetArgs, CustomerUpdateArgs, EfiPixCreateResponse, ExpiredPlansResponse, ExpiringPlan, GatewayProvider, GenerateProductArgs, Image, ImageUpdate, MarkAlertBody, MarkAlertResponse, Order, OrderCreate, OrderCustomer, OrderPayment, OrderProduct, PaymentConfig, PaymentProvider, Plan, PlanNeedingAlert, PlanStatus, PlanSubscriptionCreateArgs, PlanType, PlansNeedingAlertResponse, Product, ProductCreateArgs, ProductDraft, ProductGetByReference, ProductId, ProductMode, ProductStatus, ProductStockPushArgs, ProductUpdateArgs, ProduductDraftGetArgs, ProduductDraftSetArgs, RolePermissionsMap, Sale, SaleCreateArgs, SaleProduct, SaleProductCreateArgs, StockMode, Token, TokenUpdateArgs, UpdateCartData, UpdatePaymentConfigArgs, UpdateWalletArgs, Wallet, imageCreate, paymentProvider };

package/dist/index.d.mts

@@ -19,6 +19,13 @@ interface Wallet {
     createdAt: Date;
     updatedAt: Date;
 }
+interface CreateWalletArgs {
+    userId: string;
+    apiKey?: string;
+    gatewayProvider?: GatewayProvider;
+    gatewayConfig?: Record<string, unknown>;
+    isActive?: boolean;
+}
 interface UpdateWalletArgs {
     userId: string;
     data: {
@@ -59,6 +66,7 @@ interface ConfigDraftSetArgs {
     guildId: string;
     data: ConfigUpdateArgs["data"];
 }
+type paymentProvider = "mercadoPago" | "pixManual";
 type ActionPermission = "manage_products" | "manage_carts" | "manage_config" | "view_orders" | "process_payments" | "manager_payments" | "manage_roles" | "manager_bot" | "full_access";
 type RolePermissionsMap = Record<string, ActionPermission[]>;
 interface Config {
@@ -88,6 +96,7 @@ interface Config {
     updatedAt: Date;
     guild?: Guild$1;
 }
+type ConfigDraft = Partial<Omit<Config, "id">> | null;
 interface ConfigUpdateArgs {
     guildId: string;
     data: Omit<Partial<Config>, "id" | "guildId">;
@@ -154,6 +163,9 @@ interface PlanStatus {
     expireAt?: Date;
     daysUntilExpire?: number;
 }
+interface MarkAlertBody {
+    daysUntilExpire: number;
+}
 interface MarkAlertResponse {
     success: boolean;
     message: string;
@@ -173,15 +185,6 @@ interface ProductGetByReference {
     reference: string;
     guildId: string;
 }
-interface SaleProduct$1 {
-    id: string;
-    saleId: string;
-    productid: string;
-    guildId: string;
-    valueTotal: number;
-    quantiy: number;
-    product?: Product;
-}
 interface GenerateProductArgs {
     guildId: string;
     productId: string;
@@ -220,7 +223,7 @@ interface Product {
     coupon?: boolean;
     colorHex?: string | null;
     guild?: Guild | null;
-    sales?: SaleProduct$1[];
+    sales?: SaleProduct[];
     catalogs?: string[];
 }
 interface ProduductDraftSetArgs {
@@ -243,6 +246,7 @@ interface ProductUpdateArgs {
     id: string;
     data: Omit<Partial<Product>, "id" | "reference">;
 }
+type ProductDraft = Partial<Omit<Product, "id" | "reference">> | null;
 
 interface Guild {
     id: string;
@@ -283,6 +287,7 @@ interface CustomerUpdateArgs {
     id: string;
     data: Omit<Partial<Customer>, "id" | "userId" | "guildId">;
 }
+type CustomerDraft = Partial<Omit<Customer, "id" | "userId" | "guildId">> | null;
 
 interface SaleCreateArgs {
     userId: string;
@@ -361,6 +366,17 @@ interface PaymentConfig {
     walletApiKey?: string;
     chavePixchavePixStaticQrCode: boolean;
 }
+interface CreatePaymentConfigArgs {
+    guildId: string;
+    provider?: PaymentProvider;
+    mercadoPagoToken?: string;
+    efiBankToken?: string;
+    chavePix?: string;
+    chavePixType?: "CPF" | "EMAIL" | "ALEATORIA" | "NUMERO";
+    chavePixName?: string;
+    chavePixCity?: string;
+    chavePixchavePixStaticQrCode: boolean;
+}
 interface UpdatePaymentConfigArgs {
     guildId: string;
     data: {
@@ -424,6 +440,7 @@ interface Image {
     expiresIn: number;
 }
 type imageCreate = Omit<Image, "id">;
+type ImageUpdate = Omit<Image, "id" | "guildId">;
 
 type CouponStatus = "ACTIVED" | "DEACTIVATED" | "EXPIRED";
 interface Coupon {
@@ -463,6 +480,7 @@ interface CouponUpdateArgs {
     id: string;
     data: Omit<Partial<Coupon>, "id" | "reference">;
 }
+type CouponDraft = Partial<Omit<Coupon, "id" | "reference">> | null;
 
 type CatalogStatus = "ACTIVED" | "DEACTIVATED" | "BANNED";
 interface CatalogProduct {
@@ -503,6 +521,7 @@ interface CatalogUpdateArgs {
     id: string;
     data: Omit<Partial<Catalog>, "id" | "reference" | "guild" | "products">;
 }
+type CatalogDraft = Partial<Omit<Catalog, "id" | "reference" | "guild" | "products">> | null;
 interface CatalogDraftSetArgs {
     id: string;
     userId: string;
@@ -591,6 +610,190 @@ interface CartGetArgs {
     guildId: string;
 }
 
+/**
+ * Tipos de chave PIX aceitos pela A-TOS
+ */
+type AtosPixKeyType = "TELEF" | "EMAIL" | "CNPJ" | "CPF" | "CHAVE";
+/**
+ * Recipient types:
+ * 0 → divide lucro (não altera valor)
+ * 1 → comissão percentual (antes dos sócios)
+ * 2 → soma no valor cobrado (taxas / upsell)
+ */
+type AtosRecipientType = 0 | 1 | 2;
+/**
+ * Type 2 → valor fixo que SOMA ao valor cobrado
+ */
+interface AtosRecipientType2 {
+    id: string;
+    type: 2;
+    amount: number;
+    percentage?: never;
+}
+/**
+ * Type 1 → comissão percentual (antes dos sócios)
+ */
+interface AtosRecipientType1 {
+    id: string;
+    type: 1;
+    percentage: number;
+    amount?: never;
+}
+/**
+ * Type 0 → divisão de lucro entre sócios / owner
+ */
+interface AtosRecipientType0 {
+    id: string;
+    type: 0;
+    percentage: number;
+    amount?: never;
+}
+/**
+ * Union final de recipients (INPUT)
+ */
+type AtosRecipient = AtosRecipientType0 | AtosRecipientType1 | AtosRecipientType2;
+interface AtosCreatePixPaymentInput {
+    amount: number;
+    fee_to_customer?: boolean;
+    shop: {
+        /** ID lógico do servidor / loja */
+        id: string;
+        /** Nome do servidor / loja */
+        name: string;
+        /** Wallet / owner que receberá o saldo */
+        owner_id: string;
+    };
+    items: {
+        id: string;
+        name: string;
+        quantity: number;
+    }[];
+    customer: {
+        id: string;
+        name: string;
+    };
+    seller: {
+        /** CPF ou CNPJ do titular da API Key */
+        national_registration: string;
+        national_registration_name: string;
+    };
+    recipients?: AtosRecipient[];
+    overwrite_webhook_url?: string;
+}
+interface AtosCreatePixPaymentResponse {
+    id: string;
+    amount: number;
+    status: string;
+    qr_code?: string;
+    qr_code_image_url?: string;
+}
+/**
+ * Recipient retornado pelo gateway
+ */
+interface AtosRecipientResponse {
+    id: string;
+    type: AtosRecipientType;
+    percentage: number | null;
+    amount: number;
+    available_at: string | null;
+}
+/**
+ * Shop retornado
+ */
+interface AtosShopResponse {
+    id: string;
+    name: string;
+    owner_id: string;
+    created_at: string | null;
+}
+/**
+ * Item retornado
+ */
+interface AtosItemResponse {
+    id: string;
+    name: string;
+    quantity: number;
+}
+/**
+ * Customer retornado
+ */
+interface AtosCustomerResponse {
+    id: string;
+    name: string;
+    cpf: string | null;
+    email: string | null;
+    ip: string | null;
+}
+interface AtosCreatePixPaymentFullResponse {
+    id: string;
+    shop: AtosShopResponse;
+    status: "pending" | "paid" | "expired" | "refunded";
+    amount: number;
+    recipients: AtosRecipientResponse[];
+    items: AtosItemResponse[];
+    customer: AtosCustomerResponse;
+    /** Código PIX (copia e cola) */
+    data: string;
+    payer: unknown | null;
+    /** Data de expiração do PIX */
+    expire_at: string;
+    created_at: string;
+    infraction: unknown | null;
+    end2end_id: string | null;
+    receipt_file_url: string | null;
+    custom_message: string | null;
+    withdrawn: boolean;
+    withdraw_id: string | null;
+    kyc_validated: boolean;
+    /** Identificador interno do gateway */
+    identifier: string;
+}
+interface AtosRefundResponse {
+    success?: boolean;
+    status?: string;
+}
+interface AtosWithdrawInput {
+    /** Wallet / owner que está sacando */
+    withdraw_user_id: string;
+    pixKey: string;
+    pixKeyType: AtosPixKeyType;
+    baasPostbackUrl: string;
+}
+interface AtosWithdrawResponse {
+    id: string;
+    status: string;
+}
+interface AtosBalanceResponse {
+    balance: number;
+}
+
+interface Bot {
+    id: string;
+    hostingId: string | null;
+    status: "AVAILABLE" | "IN_USE" | "GRACE";
+    currentPlanId: string | null;
+    deployedAt: string | null;
+    lastUsedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BotStatus {
+    running: boolean;
+    restarted?: boolean;
+    status: string;
+    usage: {
+        cpu: string;
+        ram: string;
+        network: string;
+        storage: string;
+    };
+}
+interface BotDeploy {
+    message: string;
+    bot: Bot;
+    hostingId: string;
+}
+
 declare function cartWillExpire(cart: Cart): Promise<void>;
 declare function cartAntiFakeVerify(configs: Config, member: GuildMember): boolean;
 declare function cartVerifyPermission(cart: Cart, member: GuildMember, configs: Config): boolean;
@@ -751,7 +954,7 @@ declare class ShopEasySdk {
         create(args: SaleCreateArgs): Promise<Sale>;
         getById(id: string): Promise<Sale | null>;
         getAllByGuild(guildId: string): Promise<Sale[]>;
-        saleProductGet(id: string): Promise<SaleProduct$1 | null>;
+        saleProductGet(id: string): Promise<SaleProduct | null>;
         delete(id: string): Promise<void>;
     };
     tokens: {
@@ -771,3 +974,4 @@ declare class ShopEasySdk {
 }
 
 export { ShopEasySdk, cartAntiFakeVerify, cartCalculeTotal, cartVerifyAproved, cartVerifyPermission, cartWillExpire, formatDecimalToNumber, formatNumberToDecimal, formatPrice, formatRelativeTime, hasPermission, pixUtils };
+export type { ActionPermission, AtosBalanceResponse, AtosCreatePixPaymentFullResponse, AtosCreatePixPaymentInput, AtosCreatePixPaymentResponse, AtosCustomerResponse, AtosItemResponse, AtosPixKeyType, AtosRecipient, AtosRecipientResponse, AtosRecipientType, AtosRecipientType0, AtosRecipientType1, AtosRecipientType2, AtosRefundResponse, AtosShopResponse, AtosWithdrawInput, AtosWithdrawResponse, Bot, BotDeploy, BotStatus, Cart, CartDraft, CartDraftProduct, CartGetArgs, CartProduct, CartStatus, CartUpdateArgs, Catalog, CatalogCreateArgs, CatalogDraft, CatalogDraftGetArgs, CatalogDraftSetArgs, CatalogProduct, CatalogStatus, CatalogUpdateArgs, CheckExpirationsResponse, Config, ConfigDraft, ConfigDraftGetArgs, ConfigDraftSetArgs, ConfigUpdateArgs, Coupon, CouponCreateArgs, CouponDraft, CouponDraftGetArgs, CouponDraftSetArgs, CouponStatus, CouponUpdateArgs, CreateCartArgs, CreateCartProduct, CreatePaymentConfigArgs, CreateWalletArgs, Customer, CustomerCreateArgs, CustomerDraft, CustomerDraftGetArgs, CustomerDraftSetArgs, CustomerUpdateArgs, EfiPixCreateResponse, ExpiredPlansResponse, ExpiringPlan, GatewayProvider, GenerateProductArgs, Image, ImageUpdate, MarkAlertBody, MarkAlertResponse, Order, OrderCreate, OrderCustomer, OrderPayment, OrderProduct, PaymentConfig, PaymentProvider, Plan, PlanNeedingAlert, PlanStatus, PlanSubscriptionCreateArgs, PlanType, PlansNeedingAlertResponse, Product, ProductCreateArgs, ProductDraft, ProductGetByReference, ProductId, ProductMode, ProductStatus, ProductStockPushArgs, ProductUpdateArgs, ProduductDraftGetArgs, ProduductDraftSetArgs, RolePermissionsMap, Sale, SaleCreateArgs, SaleProduct, SaleProductCreateArgs, StockMode, Token, TokenUpdateArgs, UpdateCartData, UpdatePaymentConfigArgs, UpdateWalletArgs, Wallet, imageCreate, paymentProvider };

package/dist/index.d.ts

@@ -19,6 +19,13 @@ interface Wallet {
     createdAt: Date;
     updatedAt: Date;
 }
+interface CreateWalletArgs {
+    userId: string;
+    apiKey?: string;
+    gatewayProvider?: GatewayProvider;
+    gatewayConfig?: Record<string, unknown>;
+    isActive?: boolean;
+}
 interface UpdateWalletArgs {
     userId: string;
     data: {
@@ -59,6 +66,7 @@ interface ConfigDraftSetArgs {
     guildId: string;
     data: ConfigUpdateArgs["data"];
 }
+type paymentProvider = "mercadoPago" | "pixManual";
 type ActionPermission = "manage_products" | "manage_carts" | "manage_config" | "view_orders" | "process_payments" | "manager_payments" | "manage_roles" | "manager_bot" | "full_access";
 type RolePermissionsMap = Record<string, ActionPermission[]>;
 interface Config {
@@ -88,6 +96,7 @@ interface Config {
     updatedAt: Date;
     guild?: Guild$1;
 }
+type ConfigDraft = Partial<Omit<Config, "id">> | null;
 interface ConfigUpdateArgs {
     guildId: string;
     data: Omit<Partial<Config>, "id" | "guildId">;
@@ -154,6 +163,9 @@ interface PlanStatus {
     expireAt?: Date;
     daysUntilExpire?: number;
 }
+interface MarkAlertBody {
+    daysUntilExpire: number;
+}
 interface MarkAlertResponse {
     success: boolean;
     message: string;
@@ -173,15 +185,6 @@ interface ProductGetByReference {
     reference: string;
     guildId: string;
 }
-interface SaleProduct$1 {
-    id: string;
-    saleId: string;
-    productid: string;
-    guildId: string;
-    valueTotal: number;
-    quantiy: number;
-    product?: Product;
-}
 interface GenerateProductArgs {
     guildId: string;
     productId: string;
@@ -220,7 +223,7 @@ interface Product {
     coupon?: boolean;
     colorHex?: string | null;
     guild?: Guild | null;
-    sales?: SaleProduct$1[];
+    sales?: SaleProduct[];
     catalogs?: string[];
 }
 interface ProduductDraftSetArgs {
@@ -243,6 +246,7 @@ interface ProductUpdateArgs {
     id: string;
     data: Omit<Partial<Product>, "id" | "reference">;
 }
+type ProductDraft = Partial<Omit<Product, "id" | "reference">> | null;
 
 interface Guild {
     id: string;
@@ -283,6 +287,7 @@ interface CustomerUpdateArgs {
     id: string;
     data: Omit<Partial<Customer>, "id" | "userId" | "guildId">;
 }
+type CustomerDraft = Partial<Omit<Customer, "id" | "userId" | "guildId">> | null;
 
 interface SaleCreateArgs {
     userId: string;
@@ -361,6 +366,17 @@ interface PaymentConfig {
     walletApiKey?: string;
     chavePixchavePixStaticQrCode: boolean;
 }
+interface CreatePaymentConfigArgs {
+    guildId: string;
+    provider?: PaymentProvider;
+    mercadoPagoToken?: string;
+    efiBankToken?: string;
+    chavePix?: string;
+    chavePixType?: "CPF" | "EMAIL" | "ALEATORIA" | "NUMERO";
+    chavePixName?: string;
+    chavePixCity?: string;
+    chavePixchavePixStaticQrCode: boolean;
+}
 interface UpdatePaymentConfigArgs {
     guildId: string;
     data: {
@@ -424,6 +440,7 @@ interface Image {
     expiresIn: number;
 }
 type imageCreate = Omit<Image, "id">;
+type ImageUpdate = Omit<Image, "id" | "guildId">;
 
 type CouponStatus = "ACTIVED" | "DEACTIVATED" | "EXPIRED";
 interface Coupon {
@@ -463,6 +480,7 @@ interface CouponUpdateArgs {
     id: string;
     data: Omit<Partial<Coupon>, "id" | "reference">;
 }
+type CouponDraft = Partial<Omit<Coupon, "id" | "reference">> | null;
 
 type CatalogStatus = "ACTIVED" | "DEACTIVATED" | "BANNED";
 interface CatalogProduct {
@@ -503,6 +521,7 @@ interface CatalogUpdateArgs {
     id: string;
     data: Omit<Partial<Catalog>, "id" | "reference" | "guild" | "products">;
 }
+type CatalogDraft = Partial<Omit<Catalog, "id" | "reference" | "guild" | "products">> | null;
 interface CatalogDraftSetArgs {
     id: string;
     userId: string;
@@ -591,6 +610,190 @@ interface CartGetArgs {
     guildId: string;
 }
 
+/**
+ * Tipos de chave PIX aceitos pela A-TOS
+ */
+type AtosPixKeyType = "TELEF" | "EMAIL" | "CNPJ" | "CPF" | "CHAVE";
+/**
+ * Recipient types:
+ * 0 → divide lucro (não altera valor)
+ * 1 → comissão percentual (antes dos sócios)
+ * 2 → soma no valor cobrado (taxas / upsell)
+ */
+type AtosRecipientType = 0 | 1 | 2;
+/**
+ * Type 2 → valor fixo que SOMA ao valor cobrado
+ */
+interface AtosRecipientType2 {
+    id: string;
+    type: 2;
+    amount: number;
+    percentage?: never;
+}
+/**
+ * Type 1 → comissão percentual (antes dos sócios)
+ */
+interface AtosRecipientType1 {
+    id: string;
+    type: 1;
+    percentage: number;
+    amount?: never;
+}
+/**
+ * Type 0 → divisão de lucro entre sócios / owner
+ */
+interface AtosRecipientType0 {
+    id: string;
+    type: 0;
+    percentage: number;
+    amount?: never;
+}
+/**
+ * Union final de recipients (INPUT)
+ */
+type AtosRecipient = AtosRecipientType0 | AtosRecipientType1 | AtosRecipientType2;
+interface AtosCreatePixPaymentInput {
+    amount: number;
+    fee_to_customer?: boolean;
+    shop: {
+        /** ID lógico do servidor / loja */
+        id: string;
+        /** Nome do servidor / loja */
+        name: string;
+        /** Wallet / owner que receberá o saldo */
+        owner_id: string;
+    };
+    items: {
+        id: string;
+        name: string;
+        quantity: number;
+    }[];
+    customer: {
+        id: string;
+        name: string;
+    };
+    seller: {
+        /** CPF ou CNPJ do titular da API Key */
+        national_registration: string;
+        national_registration_name: string;
+    };
+    recipients?: AtosRecipient[];
+    overwrite_webhook_url?: string;
+}
+interface AtosCreatePixPaymentResponse {
+    id: string;
+    amount: number;
+    status: string;
+    qr_code?: string;
+    qr_code_image_url?: string;
+}
+/**
+ * Recipient retornado pelo gateway
+ */
+interface AtosRecipientResponse {
+    id: string;
+    type: AtosRecipientType;
+    percentage: number | null;
+    amount: number;
+    available_at: string | null;
+}
+/**
+ * Shop retornado
+ */
+interface AtosShopResponse {
+    id: string;
+    name: string;
+    owner_id: string;
+    created_at: string | null;
+}
+/**
+ * Item retornado
+ */
+interface AtosItemResponse {
+    id: string;
+    name: string;
+    quantity: number;
+}
+/**
+ * Customer retornado
+ */
+interface AtosCustomerResponse {
+    id: string;
+    name: string;
+    cpf: string | null;
+    email: string | null;
+    ip: string | null;
+}
+interface AtosCreatePixPaymentFullResponse {
+    id: string;
+    shop: AtosShopResponse;
+    status: "pending" | "paid" | "expired" | "refunded";
+    amount: number;
+    recipients: AtosRecipientResponse[];
+    items: AtosItemResponse[];
+    customer: AtosCustomerResponse;
+    /** Código PIX (copia e cola) */
+    data: string;
+    payer: unknown | null;
+    /** Data de expiração do PIX */
+    expire_at: string;
+    created_at: string;
+    infraction: unknown | null;
+    end2end_id: string | null;
+    receipt_file_url: string | null;
+    custom_message: string | null;
+    withdrawn: boolean;
+    withdraw_id: string | null;
+    kyc_validated: boolean;
+    /** Identificador interno do gateway */
+    identifier: string;
+}
+interface AtosRefundResponse {
+    success?: boolean;
+    status?: string;
+}
+interface AtosWithdrawInput {
+    /** Wallet / owner que está sacando */
+    withdraw_user_id: string;
+    pixKey: string;
+    pixKeyType: AtosPixKeyType;
+    baasPostbackUrl: string;
+}
+interface AtosWithdrawResponse {
+    id: string;
+    status: string;
+}
+interface AtosBalanceResponse {
+    balance: number;
+}
+
+interface Bot {
+    id: string;
+    hostingId: string | null;
+    status: "AVAILABLE" | "IN_USE" | "GRACE";
+    currentPlanId: string | null;
+    deployedAt: string | null;
+    lastUsedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BotStatus {
+    running: boolean;
+    restarted?: boolean;
+    status: string;
+    usage: {
+        cpu: string;
+        ram: string;
+        network: string;
+        storage: string;
+    };
+}
+interface BotDeploy {
+    message: string;
+    bot: Bot;
+    hostingId: string;
+}
+
 declare function cartWillExpire(cart: Cart): Promise<void>;
 declare function cartAntiFakeVerify(configs: Config, member: GuildMember): boolean;
 declare function cartVerifyPermission(cart: Cart, member: GuildMember, configs: Config): boolean;
@@ -751,7 +954,7 @@ declare class ShopEasySdk {
         create(args: SaleCreateArgs): Promise<Sale>;
         getById(id: string): Promise<Sale | null>;
         getAllByGuild(guildId: string): Promise<Sale[]>;
-        saleProductGet(id: string): Promise<SaleProduct$1 | null>;
+        saleProductGet(id: string): Promise<SaleProduct | null>;
         delete(id: string): Promise<void>;
     };
     tokens: {
@@ -771,3 +974,4 @@ declare class ShopEasySdk {
 }
 
 export { ShopEasySdk, cartAntiFakeVerify, cartCalculeTotal, cartVerifyAproved, cartVerifyPermission, cartWillExpire, formatDecimalToNumber, formatNumberToDecimal, formatPrice, formatRelativeTime, hasPermission, pixUtils };
+export type { ActionPermission, AtosBalanceResponse, AtosCreatePixPaymentFullResponse, AtosCreatePixPaymentInput, AtosCreatePixPaymentResponse, AtosCustomerResponse, AtosItemResponse, AtosPixKeyType, AtosRecipient, AtosRecipientResponse, AtosRecipientType, AtosRecipientType0, AtosRecipientType1, AtosRecipientType2, AtosRefundResponse, AtosShopResponse, AtosWithdrawInput, AtosWithdrawResponse, Bot, BotDeploy, BotStatus, Cart, CartDraft, CartDraftProduct, CartGetArgs, CartProduct, CartStatus, CartUpdateArgs, Catalog, CatalogCreateArgs, CatalogDraft, CatalogDraftGetArgs, CatalogDraftSetArgs, CatalogProduct, CatalogStatus, CatalogUpdateArgs, CheckExpirationsResponse, Config, ConfigDraft, ConfigDraftGetArgs, ConfigDraftSetArgs, ConfigUpdateArgs, Coupon, CouponCreateArgs, CouponDraft, CouponDraftGetArgs, CouponDraftSetArgs, CouponStatus, CouponUpdateArgs, CreateCartArgs, CreateCartProduct, CreatePaymentConfigArgs, CreateWalletArgs, Customer, CustomerCreateArgs, CustomerDraft, CustomerDraftGetArgs, CustomerDraftSetArgs, CustomerUpdateArgs, EfiPixCreateResponse, ExpiredPlansResponse, ExpiringPlan, GatewayProvider, GenerateProductArgs, Image, ImageUpdate, MarkAlertBody, MarkAlertResponse, Order, OrderCreate, OrderCustomer, OrderPayment, OrderProduct, PaymentConfig, PaymentProvider, Plan, PlanNeedingAlert, PlanStatus, PlanSubscriptionCreateArgs, PlanType, PlansNeedingAlertResponse, Product, ProductCreateArgs, ProductDraft, ProductGetByReference, ProductId, ProductMode, ProductStatus, ProductStockPushArgs, ProductUpdateArgs, ProduductDraftGetArgs, ProduductDraftSetArgs, RolePermissionsMap, Sale, SaleCreateArgs, SaleProduct, SaleProductCreateArgs, StockMode, Token, TokenUpdateArgs, UpdateCartData, UpdatePaymentConfigArgs, UpdateWalletArgs, Wallet, imageCreate, paymentProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shopeasy-sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "SDK oficial para integração com a API ShopEasy",
   "license": "ISC",
   "author": "jeanbrnd",