This library serves as a unified multiplatform abstraction layer for dispatching and delivering fiscal receipts in the Superkassa ecosystem.

Rather than hardcoding platform-specific APIs or protocol logic into the core business applications, this library decouples delivery orchestration from concrete transport channels:

1. Core Independence: The domain and application layers only rely on DeliveryRequest and DeliveryService.
2. Pluggable Architecture: Concrete delivery implementations (e.g., HTTP APIs, Android Bluetooth printing, SMTP/SMS gateway integrations) are built on top of the DeliveryAdapter interface and passed dynamically at runtime.
3. Multiplatform Compatibility: Written in pure Kotlin, it is fully compatible with Kotlin JVM (Server), Kotlin JS (Web), and Kotlin Native/Android runtimes.

Add the dependency to your shared commonMain source set inside build.gradle.kts:

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                implementation("io.github.texport:superkassa-delivery:1.2.0")
            }
        }
    }
}

Add the dependency to your build.gradle.kts for single-platform JVM applications:

dependencies {
    implementation("io.github.texport:superkassa-delivery-jvm:1.2.0")
}

Or for Maven (pom.xml):

<dependency>
    <groupId>io.github.texport</groupId>
    <artifactId>superkassa-delivery-jvm</artifactId>
    <version>1.2.0</version>
</dependency>

You can integrate this library directly into your iOS project using Xcode's Swift Package Manager:

1. In Xcode, select File ➔ Add Package Dependencies...
2. Enter the repository URL: https://github.com/texport/superkassa-delivery.git
3. Set the version rules to Up to Next Major starting with 1.2.0.

import io.github.texport.superkassa.delivery.application.service.DeliveryService
import io.github.texport.superkassa.delivery.domain.model.DeliveryChannel
import io.github.texport.superkassa.delivery.domain.model.DeliveryRequest

// Initialize service with channel adapters
val deliveryService = DeliveryService(listOf(emailAdapter, telegramAdapter))

val request = DeliveryRequest(
    cashboxId = "cashbox-1",
    documentId = "doc-1",
    channel = DeliveryChannel.EMAIL,
    destination = "client@example.com",
    payloadUrl = "https://example.com/receipts/123"
)

val result = deliveryService.deliver(request)
if (result.ok) {
    println("Delivered successfully")
} else {
    println("Failed to deliver: ${result.message}")
}

Данная библиотека является унифицированным мультиплатформенным слоем абстракции для отправки и доставки фискальных чеков в экосистеме Superkassa.

Вместо того чтобы жестко привязывать бизнес-логику к конкретным API платформ или протоколам, библиотека изолирует процесс оркестрации доставки:

1. Независимость ядра: Доменный и прикладной слои приложения взаимодействуют исключительно с сущностями DeliveryRequest и сервисом DeliveryService.
2. Расширяемая архитектура (Pluggable): Конкретные интеграции (HTTP-клиенты, печать через Bluetooth на Android, шлюзы почты/SMS) реализуют интерфейс DeliveryAdapter и подключаются динамически в рантайме.
3. Кроссплатформенность: Библиотека написана на чистом Kotlin, совместима с JVM (серверные приложения), JS (веб-клиенты) и Native/Android средами выполнения.

Добавьте зависимость в ваш общий набор исходников commonMain в build.gradle.kts:

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                implementation("io.github.texport:superkassa-delivery:1.2.0")
            }
        }
    }
}

Добавьте зависимость в build.gradle.kts вашего JVM-проекта:

dependencies {
    implementation("io.github.texport:superkassa-delivery-jvm:1.2.0")
}

Или для Maven (pom.xml):

<dependency>
    <groupId>io.github.texport</groupId>
    <artifactId>superkassa-delivery-jvm</artifactId>
    <version>1.2.0</version>
</dependency>

Вы можете подключить библиотеку непосредственно в iOS приложение с помощью Swift Package Manager в Xcode:

1. Выберите в Xcode: File ➔ Add Package Dependencies...
2. Введите URL репозитория: https://github.com/texport/superkassa-delivery.git
3. Установите правило версии Up to Next Major начиная с 1.2.0.

import io.github.texport.superkassa.delivery.application.service.DeliveryService
import io.github.texport.superkassa.delivery.domain.model.DeliveryChannel
import io.github.texport.superkassa.delivery.domain.model.DeliveryRequest

// Инициализация сервиса со списком адаптеров
val deliveryService = DeliveryService(listOf(emailAdapter, telegramAdapter))

val request = DeliveryRequest(
    cashboxId = "cashbox-1",
    documentId = "doc-1",
    channel = DeliveryChannel.EMAIL,
    destination = "client@example.com",
    payloadUrl = "https://example.com/receipts/123"
)

val result = deliveryService.deliver(request)
if (result.ok) {
    println("Успешно доставлено")
} else {
    println("Ошибка доставки: ${result.message}")
}

This project is licensed under the Apache License 2.0. See LICENSE for details.

Этот проект распространяется под лицензией Apache License 2.0. Подробности см. в файле LICENSE.