@gravito/satellite-invoice 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @gravito/satellite-invoice
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/atlas@1.0.1
+  - @gravito/core@1.0.0
+  - @gravito/enterprise@1.0.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { ServiceProvider, Container } from '@gravito/core';
+
+declare class InvoiceServiceProvider extends ServiceProvider {
+    register(container: Container): void;
+    boot(): void;
+}
+
+export { InvoiceServiceProvider };

package/dist/index.js

@@ -0,0 +1,177 @@
+// src/index.ts
+import { ServiceProvider } from "@gravito/core";
+
+// src/Application/UseCases/IssueInvoice.ts
+import { UseCase } from "@gravito/enterprise";
+
+// src/Domain/Entities/Invoice.ts
+import { Entity } from "@gravito/enterprise";
+var Invoice = class _Invoice extends Entity {
+  _props;
+  constructor(props, id) {
+    super(id || crypto.randomUUID());
+    this._props = props;
+  }
+  get orderId() {
+    return this._props.orderId;
+  }
+  get invoiceNumber() {
+    return this._props.invoiceNumber;
+  }
+  get amount() {
+    return this._props.amount;
+  }
+  get status() {
+    return this._props.status;
+  }
+  static create(props, id) {
+    return new _Invoice(
+      {
+        ...props,
+        status: props.status || "ISSUED",
+        createdAt: props.createdAt || /* @__PURE__ */ new Date()
+      },
+      id
+    );
+  }
+  unpack() {
+    return { ...this._props };
+  }
+  cancel() {
+    this._props.status = "CANCELLED";
+  }
+};
+
+// src/Application/UseCases/IssueInvoice.ts
+var IssueInvoice = class extends UseCase {
+  constructor(repository) {
+    super();
+    this.repository = repository;
+  }
+  async execute(input) {
+    const existing = await this.repository.findByOrderId(input.orderId);
+    if (existing) {
+      return existing;
+    }
+    const randomNum = Math.floor(1e7 + Math.random() * 9e7);
+    const invoiceNumber = `GX-${randomNum}`;
+    const tax = Math.round(input.amount * 0.05);
+    const invoice = Invoice.create({
+      orderId: input.orderId,
+      invoiceNumber,
+      amount: input.amount,
+      tax,
+      status: "ISSUED",
+      buyerIdentifier: input.buyerIdentifier,
+      carrierId: input.carrierId
+    });
+    await this.repository.save(invoice);
+    return invoice;
+  }
+};
+
+// src/Infrastructure/Persistence/AtlasInvoiceRepository.ts
+import { Model } from "@gravito/atlas";
+var InvoiceModel = class extends Model {
+  static table = "invoices";
+};
+var AtlasInvoiceRepository = class {
+  async save(invoice) {
+    const data = {
+      id: invoice.id,
+      ...invoice.unpack()
+    };
+    const existing = await InvoiceModel.find(invoice.id);
+    if (existing) {
+      await InvoiceModel.query().where("id", invoice.id).update(data);
+    } else {
+      await InvoiceModel.query().insert(data);
+    }
+  }
+  async findById(id) {
+    const row = await InvoiceModel.find(id);
+    return row ? Invoice.create(row.props, row.props.id) : null;
+  }
+  async findByOrderId(orderId) {
+    const row = await InvoiceModel.query().where("order_id", orderId).first();
+    return row ? Invoice.create(row.props, row.props.id) : null;
+  }
+  async findAll() {
+    const rows = await InvoiceModel.all();
+    return rows.map((row) => Invoice.create(row.props, row.props.id));
+  }
+};
+
+// src/Interface/Http/Controllers/AdminInvoiceController.ts
+var AdminInvoiceController = class {
+  constructor(core) {
+    this.core = core;
+  }
+  async index(ctx) {
+    const repo = this.core.container.make("invoice.repository");
+    const invoices = await repo.findAll();
+    return ctx.json(
+      invoices.map((inv) => ({
+        id: inv.id,
+        ...inv.unpack()
+      }))
+    );
+  }
+  async store(ctx) {
+    const body = await ctx.req.json();
+    const useCase = this.core.container.make("invoice.usecase.issue");
+    const invoice = await useCase.execute(body);
+    return ctx.json({
+      success: true,
+      data: {
+        id: invoice.id,
+        number: invoice.invoiceNumber
+      }
+    });
+  }
+};
+
+// src/index.ts
+var InvoiceServiceProvider = class extends ServiceProvider {
+  register(container) {
+    container.singleton("invoice.repository", () => new AtlasInvoiceRepository());
+    container.bind(
+      "invoice.usecase.issue",
+      () => new IssueInvoice(container.make("invoice.repository"))
+    );
+    container.singleton("invoice.controller.admin", () => new AdminInvoiceController(this.core));
+  }
+  boot() {
+    const core = this.core;
+    if (!core) {
+      return;
+    }
+    core.logger.info("\u{1F9FE} Invoice Satellite is ready");
+    const controller = core.container.make("invoice.controller.admin");
+    core.router.prefix("/api/admin/v1/invoices").group((router) => {
+      router.get("/", (ctx) => controller.index(ctx));
+      router.post("/", (ctx) => controller.store(ctx));
+    });
+    core.hooks.addAction(
+      "order:paid",
+      async (payload) => {
+        core.logger.info(`[Invoice] Triggering auto-issuance for order: ${payload.orderId}`);
+        const issueUseCase = core.container.make("invoice.usecase.issue");
+        try {
+          const invoice = await issueUseCase.execute({
+            orderId: payload.orderId,
+            amount: payload.amount,
+            buyerIdentifier: payload.buyer?.identifier,
+            carrierId: payload.buyer?.carrierId
+          });
+          core.logger.info(`[Invoice] Automatically issued: ${invoice.invoiceNumber}`);
+        } catch (error) {
+          core.logger.error(`[Invoice] Auto-issue failed: ${error.message}`);
+        }
+      }
+    );
+  }
+};
+export {
+  InvoiceServiceProvider
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@gravito/satellite-invoice",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --external @gravito/enterprise --external @gravito/atlas --external @gravito/core",
+    "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck"
+  },
+  "dependencies": {
+    "@gravito/enterprise": "workspace:*",
+    "@gravito/atlas": "workspace:*",
+    "@gravito/core": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.3"
+  },
+  "module": "dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "satellites/invoice"
+  }
+}

package/src/Application/UseCases/IssueInvoice.ts

@@ -0,0 +1,43 @@
+import { UseCase } from '@gravito/enterprise'
+import type { IInvoiceRepository } from '../../Domain/Contracts/IInvoiceRepository'
+import { Invoice } from '../../Domain/Entities/Invoice'
+
+export interface IssueInvoiceInput {
+  orderId: string
+  amount: number
+  buyerIdentifier?: string
+  carrierId?: string
+}
+
+export class IssueInvoice extends UseCase<IssueInvoiceInput, Invoice> {
+  constructor(private repository: IInvoiceRepository) {
+    super()
+  }
+
+  async execute(input: IssueInvoiceInput): Promise<Invoice> {
+    // 檢查是否已開立過
+    const existing = await this.repository.findByOrderId(input.orderId)
+    if (existing) {
+      return existing
+    }
+
+    // 模擬發票號碼產生器
+    const randomNum = Math.floor(10000000 + Math.random() * 90000000)
+    const invoiceNumber = `GX-${randomNum}`
+
+    const tax = Math.round(input.amount * 0.05)
+
+    const invoice = Invoice.create({
+      orderId: input.orderId,
+      invoiceNumber,
+      amount: input.amount,
+      tax,
+      status: 'ISSUED',
+      buyerIdentifier: input.buyerIdentifier,
+      carrierId: input.carrierId,
+    })
+
+    await this.repository.save(invoice)
+    return invoice
+  }
+}

package/src/Domain/Contracts/IInvoiceRepository.ts

@@ -0,0 +1,8 @@
+import type { Invoice } from '../Entities/Invoice'
+
+export interface IInvoiceRepository {
+  save(invoice: Invoice): Promise<void>
+  findById(id: string): Promise<Invoice | null>
+  findByOrderId(orderId: string): Promise<Invoice | null>
+  findAll(): Promise<Invoice[]>
+}

package/src/Domain/Entities/Invoice.ts

@@ -0,0 +1,53 @@
+import { Entity } from '@gravito/enterprise'
+
+export interface InvoiceProps {
+  orderId: string
+  invoiceNumber: string
+  amount: number
+  tax: number
+  status: 'ISSUED' | 'CANCELLED' | 'RETURNED'
+  buyerIdentifier?: string
+  carrierId?: string
+  createdAt?: Date
+}
+
+export class Invoice extends Entity<string> {
+  private _props: InvoiceProps
+
+  private constructor(props: InvoiceProps, id?: string) {
+    super(id || crypto.randomUUID())
+    this._props = props
+  }
+
+  get orderId() {
+    return this._props.orderId
+  }
+  get invoiceNumber() {
+    return this._props.invoiceNumber
+  }
+  get amount() {
+    return this._props.amount
+  }
+  get status() {
+    return this._props.status
+  }
+
+  static create(props: InvoiceProps, id?: string) {
+    return new Invoice(
+      {
+        ...props,
+        status: props.status || 'ISSUED',
+        createdAt: props.createdAt || new Date(),
+      },
+      id
+    )
+  }
+
+  unpack(): InvoiceProps {
+    return { ...this._props }
+  }
+
+  cancel() {
+    this._props.status = 'CANCELLED'
+  }
+}

package/src/Infrastructure/Persistence/AtlasInvoiceRepository.ts

@@ -0,0 +1,38 @@
+import { Model } from '@gravito/atlas'
+import type { IInvoiceRepository } from '../../Domain/Contracts/IInvoiceRepository'
+import { Invoice } from '../../Domain/Entities/Invoice'
+
+class InvoiceModel extends Model {
+  static override table = 'invoices'
+}
+
+export class AtlasInvoiceRepository implements IInvoiceRepository {
+  async save(invoice: Invoice): Promise<void> {
+    const data = {
+      id: invoice.id,
+      ...invoice.unpack(),
+    }
+
+    const existing = await InvoiceModel.find(invoice.id)
+    if (existing) {
+      await (InvoiceModel.query() as any).where('id', invoice.id).update(data)
+    } else {
+      await (InvoiceModel.query() as any).insert(data)
+    }
+  }
+
+  async findById(id: string): Promise<Invoice | null> {
+    const row = await InvoiceModel.find(id)
+    return row ? Invoice.create((row as any).props, (row as any).props.id) : null
+  }
+
+  async findByOrderId(orderId: string): Promise<Invoice | null> {
+    const row = await (InvoiceModel.query() as any).where('order_id', orderId).first()
+    return row ? Invoice.create(row.props, row.props.id) : null
+  }
+
+  async findAll(): Promise<Invoice[]> {
+    const rows = await InvoiceModel.all()
+    return rows.map((row) => Invoice.create((row as any).props, (row as any).props.id))
+  }
+}

package/src/Interface/Http/Controllers/AdminInvoiceController.ts

@@ -0,0 +1,32 @@
+import type { PlanetCore } from '@gravito/core'
+import type { IssueInvoice } from '../../../Application/UseCases/IssueInvoice'
+import type { Invoice } from '../../../Domain/Entities/Invoice'
+
+export class AdminInvoiceController {
+  constructor(private core: PlanetCore) {}
+
+  async index(ctx: any) {
+    // 獲取所有發票清單
+    const repo = this.core.container.make('invoice.repository') as any
+    const invoices = await repo.findAll()
+    return ctx.json(
+      invoices.map((inv: Invoice) => ({
+        id: inv.id,
+        ...inv.unpack(),
+      }))
+    )
+  }
+
+  async store(ctx: any) {
+    const body = await ctx.req.json()
+    const useCase = this.core.container.make<IssueInvoice>('invoice.usecase.issue')
+    const invoice = await useCase.execute(body)
+    return ctx.json({
+      success: true,
+      data: {
+        id: invoice.id,
+        number: invoice.invoiceNumber,
+      },
+    })
+  }
+}

package/src/index.ts

@@ -0,0 +1,56 @@
+import { type Container, ServiceProvider } from '@gravito/core'
+import { IssueInvoice } from './Application/UseCases/IssueInvoice'
+import { AtlasInvoiceRepository } from './Infrastructure/Persistence/AtlasInvoiceRepository'
+import { AdminInvoiceController } from './Interface/Http/Controllers/AdminInvoiceController'
+
+export class InvoiceServiceProvider extends ServiceProvider {
+  register(container: Container): void {
+    container.singleton('invoice.repository', () => new AtlasInvoiceRepository())
+    container.bind(
+      'invoice.usecase.issue',
+      () => new IssueInvoice(container.make('invoice.repository'))
+    )
+    container.singleton('invoice.controller.admin', () => new AdminInvoiceController(this.core!))
+  }
+
+  override boot(): void {
+    const core = this.core
+    if (!core) {
+      return
+    }
+
+    core.logger.info('🧾 Invoice Satellite is ready')
+
+    const controller = core.container.make<AdminInvoiceController>('invoice.controller.admin')
+
+    // 註冊管理路由
+    core.router.prefix('/api/admin/v1/invoices').group((router) => {
+      router.get('/', (ctx) => controller.index(ctx))
+      router.post('/', (ctx) => controller.store(ctx))
+    })
+
+    /**
+     * 自動化 Hook: 支付成功後自動開票
+     */
+    core.hooks.addAction(
+      'order:paid',
+      async (payload: { orderId: string; amount: number; buyer?: any }) => {
+        core.logger.info(`[Invoice] Triggering auto-issuance for order: ${payload.orderId}`)
+
+        const issueUseCase = core.container.make<IssueInvoice>('invoice.usecase.issue')
+
+        try {
+          const invoice = await issueUseCase.execute({
+            orderId: payload.orderId,
+            amount: payload.amount,
+            buyerIdentifier: payload.buyer?.identifier,
+            carrierId: payload.buyer?.carrierId,
+          })
+          core.logger.info(`[Invoice] Automatically issued: ${invoice.invoiceNumber}`)
+        } catch (error: any) {
+          core.logger.error(`[Invoice] Auto-issue failed: ${error.message}`)
+        }
+      }
+    )
+  }
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "baseUrl": ".",
+        "paths": {
+            "@gravito/core": [
+                "../../packages/core/src/index.ts"
+            ],
+            "@gravito/*": [
+                "../../packages/*/src/index.ts"
+            ]
+        },
+        "types": [
+            "bun-types"
+        ]
+    },
+    "include": [
+        "src/**/*"
+    ]
+}