biller-cli 0.1.0__py3-none-any.whl

biller_cli/templates/biller-user-layer/src/main/resources/application.properties

@@ -0,0 +1,88 @@
+server.port=${SERVER_PORT:8111}
+app.cors.allowed-origins=${CORS_ALLOWED_ORIGINS:http://localhost:3000}
+
+# Database
+spring.datasource.url=${DB_URL:jdbc:postgresql://localhost:5432/billerdb?currentSchema=billerdb}
+spring.datasource.username=${DB_USERNAME:postgres}
+spring.datasource.password=${DB_PASSWORD:postgres}
+spring.datasource.driver-class-name=org.postgresql.Driver
+spring.jpa.hibernate.ddl-auto=update
+spring.jpa.show-sql=true
+spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
+spring.sql.init.schema-locations=classpath:schema.sql
+spring.sql.init.mode=always
+spring.main.allow-bean-definition-overriding=true
+
+# BOU Connection
+bou.domain=${BOU_DOMAIN:http://localhost:8112}
+bou.billfetchrequest.url=/bbps/BillFetchRequest/1.0/urn:referenceId:
+bou.billpaymentrequest.url=/bbps/BillPaymentRequest/1.0/urn:referenceId:
+bou.billfetchresponse.url=/bbps/BillFetchResponse/1.0/urn:referenceId:
+bou.billpaymentresponse.url=/bbps/BillPaymentResponse/1.0/urn:referenceId:
+
+# BBPS
+bbps.ip=${BBPS_IP:http://localhost:8113}
+bbps.billfetchresponse.url=${bou.billfetchresponse.url}
+bbps.billpaymentresponse.url=${bou.billpaymentresponse.url}
+hbt.frequency=3
+
+# OU Identity — set PENDING until BBPS assigns your OU ID
+# Run 'biller activate' after receiving your OU ID from BBPS
+ou.id=${OU_ID:PENDING}
+
+# Certificate — never hardcode, never commit ousigner.p12
+bbps.cert.path=${BBPS_CERT_PATH:config/certificate/OU/ousigner.p12}
+bbps.cert.password=${BBPS_CERT_PASSWORD:changeit}
+bbps.sign-method=RSA_SHA256
+
+# Billing Provider
+billing.provider.type=${BILLING_PROVIDER_TYPE:postgres}
+billing.provider.date-format=yyyy-MM-ddx
+
+billing.provider.postgres.tables.bill-details=bill_details
+billing.provider.postgres.tables.payment-transactions=payment_transactions
+billing.provider.postgres.bill-columns.bill-id=bill_id
+billing.provider.postgres.bill-columns.customer-param-name=customer_param_name
+billing.provider.postgres.bill-columns.customer-param-type=customer_param_type
+billing.provider.postgres.bill-columns.customer-param-value=customer_param_value
+billing.provider.postgres.bill-columns.bill-amount=bill_amount
+billing.provider.postgres.bill-columns.bill-date=bill_date
+billing.provider.postgres.bill-columns.due-date=due_date
+billing.provider.postgres.bill-columns.bill-number=bill_number
+billing.provider.postgres.bill-columns.bill-period=bill_period
+billing.provider.postgres.bill-columns.bill-status=bill_status
+billing.provider.postgres.bill-columns.additional-info=additional_info
+billing.provider.postgres.bill-columns.created-at=created_at
+billing.provider.postgres.bill-columns.updated-at=updated_at
+billing.provider.postgres.payment-columns.bill-id=bill_id
+billing.provider.postgres.payment-columns.bbps-txn-ref=bbps_txn_ref
+billing.provider.postgres.payment-columns.amount-paid=amount_paid
+billing.provider.postgres.payment-columns.payment-mode=payment_mode
+
+billing.provider.csv.path=${CSV_PATH:}
+billing.provider.csv.payment-log-path=${CSV_PAYMENT_LOG_PATH:}
+billing.provider.csv.delimiter=,
+billing.provider.csv.columns.bill-id=bill_id
+billing.provider.csv.columns.customer-param-name=customer_param_name
+billing.provider.csv.columns.customer-param-type=customer_param_type
+billing.provider.csv.columns.customer-param-value=customer_param_value
+billing.provider.csv.columns.bill-amount=bill_amount
+billing.provider.csv.columns.bill-date=bill_date
+billing.provider.csv.columns.due-date=due_date
+billing.provider.csv.columns.bill-number=bill_number
+billing.provider.csv.columns.bill-period=bill_period
+billing.provider.csv.columns.bill-status=bill_status
+
+billing.provider.excel.path=${EXCEL_PATH:}
+billing.provider.excel.sheet-name=Sheet1
+billing.provider.excel.payment-log-path=${EXCEL_PAYMENT_LOG_PATH:}
+billing.provider.excel.columns.bill-id=bill_id
+billing.provider.excel.columns.customer-param-name=customer_param_name
+billing.provider.excel.columns.customer-param-type=customer_param_type
+billing.provider.excel.columns.customer-param-value=customer_param_value
+billing.provider.excel.columns.bill-amount=bill_amount
+billing.provider.excel.columns.bill-date=bill_date
+billing.provider.excel.columns.due-date=due_date
+billing.provider.excel.columns.bill-number=bill_number
+billing.provider.excel.columns.bill-period=bill_period
+billing.provider.excel.columns.bill-status=bill_status

biller_cli/templates/pom.xml

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.2.0</version>
+        <relativePath/>
+    </parent>
+
+    <groupId>com.bharatconnect.biller</groupId>
+    <artifactId>test-biller-integrator</artifactId>
+    <version>1.0.0</version>
+    <packaging>pom</packaging>
+
+    <modules>
+        <module>biller-user-layer</module>
+    </modules>
+
+    <properties>
+        <java.version>17</java.version>
+    </properties>
+    <repositories>
+        <repository>
+            <id>github</id>
+            <url>https://maven.pkg.github.com/Dhru227/biller-core</url>
+        </repository>
+    </repositories>
+
+</project>

biller_cli/utils/preflight.py

@@ -0,0 +1,151 @@
+import shutil, subprocess, sys
+from rich.console import Console
+from enum import Enum
+
+console = Console()
+
+class RuntimeMode(Enum):
+    DOCKER = "docker"
+    NATIVE = "native"
+    NONE   = "none"
+
+# ── Individual check functions ────────────────────────────────────────────────
+
+def _check_python() -> bool:
+    return sys.version_info >= (3, 10)
+
+def _check_git() -> bool:
+    return shutil.which("git") is not None
+
+def _check_java() -> bool:
+    if not shutil.which("java"):
+        return False
+    result = subprocess.run(["java", "-version"], capture_output=True, text=True)
+    output = result.stderr + result.stdout
+    for line in output.splitlines():
+        if "version" in line:
+            try:
+                version_str = line.split('"')[1]
+                major = int(version_str.split(".")[0])
+                if major == 1:           # legacy 1.8.x format
+                    major = int(version_str.split(".")[1])
+                return major >= 17
+            except (IndexError, ValueError):
+                return False
+    return False
+
+def _check_maven() -> bool:
+    return shutil.which("mvn") is not None
+
+def _check_docker_installed() -> bool:
+    return shutil.which("docker") is not None
+
+def _check_docker_daemon() -> bool:
+    if not _check_docker_installed():
+        return False
+    result = subprocess.run(["docker", "info"], capture_output=True)
+    return result.returncode == 0
+
+# ── Runtime detection ─────────────────────────────────────────────────────────
+
+def detect_runtime() -> RuntimeMode:
+    """
+    Returns the best available runtime:
+      docker  — Docker installed AND daemon running
+      native  — No Docker (or daemon down), but Java 17+ and Maven present
+      none    — Neither viable
+    """
+    if _check_docker_daemon():
+        return RuntimeMode.DOCKER
+    if _check_java() and _check_maven():
+        return RuntimeMode.NATIVE
+    return RuntimeMode.NONE
+
+# ── Pre-flight gate ───────────────────────────────────────────────────────────
+
+UNIVERSAL_CHECKS = [
+    {
+        "name": "Python >= 3.10",
+        "check": _check_python,
+        "fix": "Upgrade Python: https://python.org",
+    },
+    {
+        "name": "Git",
+        "check": _check_git,
+        "fix": "Install Git:  sudo apt-get install git",
+    },
+]
+
+NATIVE_CHECKS = [
+    {
+        "name": "Java 17+",
+        "check": _check_java,
+        "fix": "Install Java: sudo apt-get install openjdk-17-jdk\n"
+               "              Or: https://adoptium.net",
+    },
+    {
+        "name": "Maven",
+        "check": _check_maven,
+        "fix": "Install Maven: sudo apt-get install maven\n"
+               "               Or: https://maven.apache.org/install.html",
+    },
+]
+
+def run_preflight(require_runtime: bool = True) -> RuntimeMode:
+    """
+    Run all pre-flight checks. Returns the detected RuntimeMode.
+    Exits with a clear message if any universal check fails,
+    or if require_runtime=True and no runtime is viable.
+    """
+    # Universal checks — must always pass
+    failed = []
+    for item in UNIVERSAL_CHECKS:
+        try:
+            passed = item["check"]()
+        except Exception:
+            passed = False
+        if not passed:
+            failed.append(item)
+
+    if failed:
+        console.print("\n[red]Pre-flight failed:[/red]\n")
+        for item in failed:
+            console.print(f"  [red]✗[/red]  {item['name']}")
+            console.print(f"       → {item['fix']}\n")
+        raise SystemExit(1)
+
+    # Runtime detection
+    runtime = detect_runtime()
+
+    if runtime == RuntimeMode.DOCKER:
+        console.print("[dim]Runtime: Docker ✓[/dim]")
+
+    elif runtime == RuntimeMode.NATIVE:
+        console.print("[yellow]Docker not available — using native Maven mode.[/yellow]")
+        failed_native = []
+        for item in NATIVE_CHECKS:
+            try:
+                passed = item["check"]()
+            except Exception:
+                passed = False
+            if not passed:
+                failed_native.append(item)
+        if failed_native:
+            console.print("\n[red]Native mode also unavailable:[/red]\n")
+            for item in failed_native:
+                console.print(f"  [red]✗[/red]  {item['name']}")
+                console.print(f"       → {item['fix']}\n")
+            raise SystemExit(1)
+
+    elif runtime == RuntimeMode.NONE and require_runtime:
+        console.print("\n[red]No viable runtime found.[/red]")
+        console.print("biller-cli needs either:\n")
+        console.print("  [bold]Docker (recommended)[/bold]")
+        console.print("    sudo apt-get install docker.io")
+        console.print("    sudo systemctl start docker")
+        console.print("    sudo usermod -aG docker $USER  # then log out and back in\n")
+        console.print("  [bold]OR: Java 17+ and Maven[/bold]")
+        console.print("    sudo apt-get install openjdk-17-jdk maven\n")
+        raise SystemExit(1)
+
+    return runtime

biller_cli/utils/secrets.py

@@ -0,0 +1,37 @@
+from pathlib import Path
+from rich.console import Console
+
+console = Console()
+
+def write_env_file(project_dir: Path, secrets: dict):
+    """Write sensitive values to .env.biller. Never call yaml.dump on these."""
+    env_file = project_dir / ".env.biller"
+    lines = ["# Biller secrets — DO NOT COMMIT\n"]
+    for key, value in secrets.items():
+        lines.append(f"{key.upper()}={value}\n")
+    env_file.write_text("".join(lines))
+    _ensure_gitignore(project_dir)
+    console.print(f"[dim]Secrets → {env_file} (git-ignored)[/dim]")
+
+def read_env_file(project_dir: Path) -> dict:
+    """Reads secrets back for native mode injection."""
+    env_file = project_dir / ".env.biller"
+    if not env_file.exists():
+        return {}
+    result = {}
+    for line in env_file.read_text().splitlines():
+        if "=" in line and not line.startswith("#"):
+            k, v = line.split("=", 1)
+            result[k.lower()] = v
+    return result
+
+def _ensure_gitignore(project_dir: Path):
+    """Guarantees .env.biller is ignored in the user's generated repo."""
+    gitignore = project_dir / ".gitignore"
+    entry = ".env.biller"
+    if gitignore.exists():
+        if entry not in gitignore.read_text():
+            with gitignore.open("a") as f:
+                f.write(f"\n# Biller secrets — auto-added by biller-cli\n{entry}\n")
+    else:
+        gitignore.write_text(f"# Biller secrets\n{entry}\n")

biller_cli/utils/version_pin.py

@@ -0,0 +1,67 @@
+"""
+Shared utility for reading and writing the biller-core version pin.
+
+Used by both `biller-cli upgrade` and `biller-cli downgrade`.
+Updates two files atomically:
+  - biller.yaml  → core.version
+  - pom.xml      → properties/biller.core.version
+
+Uses an XML parser (not regex) so POM reformatting by IDEs or Maven
+does not silently break the update.
+"""
+
+import xml.etree.ElementTree as ET
+from pathlib import Path
+import yaml
+
+
+MAVEN_NS = "http://maven.apache.org/POM/4.0.0"
+
+
+def get_version_pin(project_dir: Path) -> str:
+    """Return the currently pinned biller-core version from biller.yaml."""
+    bp = project_dir / "biller.yaml"
+    if not bp.exists():
+        raise FileNotFoundError(f"biller.yaml not found in {project_dir}")
+    cfg = yaml.safe_load(bp.read_text())
+    version = cfg.get("core", {}).get("version")
+    if not version:
+        raise KeyError("core.version not found in biller.yaml")
+    return version
+
+
+def set_version_pin(project_dir: Path, version: str) -> None:
+    """
+    Write version to both biller.yaml and pom.xml.
+
+    Raises RuntimeError if biller.core.version property is missing from pom.xml —
+    this means the pom.xml was not scaffolded correctly and should not be silently fixed.
+    """
+    # 1. biller.yaml
+    bp = project_dir / "biller.yaml"
+    cfg = yaml.safe_load(bp.read_text())
+    if "core" not in cfg:
+        cfg["core"] = {}
+    cfg["core"]["version"] = version
+    bp.write_text(yaml.dump(cfg, default_flow_style=False, sort_keys=False))
+
+    # 2. pom.xml — use XML parser, never regex
+    pom_path = project_dir / "pom.xml"
+    if not pom_path.exists():
+        raise FileNotFoundError(f"pom.xml not found in {project_dir}")
+
+    ET.register_namespace("", MAVEN_NS)
+    tree = ET.parse(pom_path)
+    root = tree.getroot()
+    ns = {"m": MAVEN_NS}
+
+    prop = root.find(".//m:properties/m:biller.core.version", ns)
+    if prop is None:
+        raise RuntimeError(
+            "biller.core.version not found in pom.xml <properties>. "
+            "The pom.xml may not have been scaffolded by biller-cli init. "
+            "Add: <biller.core.version>VERSION</biller.core.version> under <properties>."
+        )
+
+    prop.text = version
+    tree.write(str(pom_path), xml_declaration=True, encoding="unicode")

biller_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: biller-cli
+Version: 0.1.0
+Requires-Python: >=3.10
+Requires-Dist: gitpython>=3.1
+Requires-Dist: packaging>=24.0
+Requires-Dist: psutil>=5.9
+Requires-Dist: pyyaml>=6
+Requires-Dist: requests>=2.31
+Requires-Dist: rich>=13
+Requires-Dist: typer[all]>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest-mock; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'

biller_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,33 @@
+biller_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+biller_cli/main.py,sha256=gFvdGyN_UlBy7Ht8WZWB6UobZnYB-JzS4CUihChO0ac,922
+biller_cli/ai/__init__.py,sha256=Ejvyx2lme4yg2xCVs5ET8D09CE5hcBxJinkmGJS46n0,14011
+biller_cli/ai/ingest.py,sha256=J-xZNq7Dc0n2HGI6kutg7AydN8NAMvoV5ORTNWko4x4,13760
+biller_cli/commands/down.py,sha256=sfU_YfLui5h0a1goOQbQHhNLezQ5mElp_gt6F6Vc3tc,3134
+biller_cli/commands/downgrade.py,sha256=lHXLDvoZTLVGni6rGcM6jqauyV0z_FtmaaNz7qim78Q,5581
+biller_cli/commands/init.py,sha256=LWW7oZrkV_qea1ZbeZKMGqYptJyjvIzm5CS1NNjamBw,8272
+biller_cli/commands/up.py,sha256=U_98YrILMGCGHPGuMd0K2h_G02GBiG1UUGLWBQXLuYA,5309
+biller_cli/commands/upgrade.py,sha256=cnv0Lq8ampvghkPb6u8KHDn1fs2OXS3WPHwGzcmHBqs,10561
+biller_cli/templates/pom.xml,sha256=Nyz1XFv9a88eOE2dTk1J8ILCnI5Vw0z1fynpTDNMgho,1001
+biller_cli/templates/biller-user-layer/pom.xml,sha256=ulmmNEb9_zGleI8b7sqxAQ8eldh-h1TQkFhQsPx9C4g,3777
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/ApplicationContext.java,sha256=nOL_aDmnyHul2slLqVDmfYvFucXeNfGSwEtj2wjeA3o,458
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/config/DatabaseConfig.java,sha256=wAeuqP0xxp9e7mQqyF1Dg_IfX1Jaajgn5T8z2fbe9CA,1452
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/config/WebCorsConfig.java,sha256=vpMit5img8pHIljuZVRhFl8q_dhWqyioPdZuWf6Bt1w,756
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/controller/BbpsRequestController.java,sha256=EbqzPzo6B6zDS3wK8aNCUf6Rsw8ZAW6fuDjqx54najA,4518
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/dao/impl/BillFetchDaoImpl.java,sha256=Nq9LFrCz0VW2EKftofdKLo76a_IuuPT8_C6hhxZHBqI,6346
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/dao/impl/BillPaymentDaoImpl.java,sha256=s7ciaoUVZyg5Sh6whOvkCU8mFJs2qczndGvRrozGNdI,4441
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/provider/BillingProviderConfig.java,sha256=ZIqxuBaX91ulr-Wn6ZTfc-oji5LsC-P2MBU6k5n1tmY,1728
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/provider/BillingProviderProperties.java,sha256=DKlUbUrBJ1siYjyU6egOhiO8EcLiiO7lLMbHSel_Wlw,2992
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/provider/impl/CsvBillingProvider.java,sha256=3Vrq298FjqLxk0tqdj6XXZR4wiUZeGfuC6rfQI5S7Zo,10813
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/provider/impl/ExcelBillingProvider.java,sha256=Mzm0DIFRn6nNGdddBR8AkMBCxtuACgbdR9woL0cp76o,11647
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/provider/impl/PostgresBillingProvider.java,sha256=CJmMmx-ot5WWV6SKSz49tpBs7cqL73aF7GtFABHc9rw,9930
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/service/impl/BillFetchServiceImpl.java,sha256=YCFoBqFxH7KqKucf4JgC3FRuF8ilxUrtZaAKBew9d5I,5682
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/service/impl/BillPaymentServiceImpl.java,sha256=jvqD35Zm8bpBE99oGdton_Gv06TXpnWxw4d6wRiAi_w,7388
+biller_cli/templates/biller-user-layer/src/main/java/bharat/connect/biller/service/impl/HeartbeatServiceImpl.java,sha256=38f2MXalCzaslKamp-Sc_sWTAiVXaZwLpvgAtvBhNuE,5755
+biller_cli/templates/biller-user-layer/src/main/resources/application.properties,sha256=NCarEJ8hCD-tMACPCkJM_BLNKak5tpHGnj3fVY5NVAs,4331
+biller_cli/utils/preflight.py,sha256=Bplsupr3jB_m6fIT7jY7vkyJJ0Z-hiAh5-cnK2pDyzI,5274
+biller_cli/utils/secrets.py,sha256=jPO_aEJ4ZBjXbzPK0lVkFUrTZ8t23fq1MUUXfXToEqE,1407
+biller_cli/utils/version_pin.py,sha256=8GJe56Hw-JmT8QdVKYfs4axZ74UIG8HYYJyVUF6bTew,2276
+biller_cli-0.1.0.dist-info/METADATA,sha256=0jDxZE1f8UD-LQ0DXrG6TcJnNPMwr0ulZ-vRqOeCqtI,492
+biller_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+biller_cli-0.1.0.dist-info/entry_points.txt,sha256=CkwW_8TCDaqkvl2_lxt12SxJ3AQjWfgudXVYVIeA9mM,51
+biller_cli-0.1.0.dist-info/RECORD,,

biller_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

biller_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+biller-cli = biller_cli.main:app