MerchantId - MerchantId

MerchantId adalah facade tingkat atas yang menyatukan beberapa provider di balik satu registry. Setiap provider (GopayProvider, ShopeeProvider) diimplementasikan sebagai MerchantProvider dan didaftarkan dengan id unik.

createMerchantId

function createMerchantId(config?: MerchantIdConfig): MerchantId;

Membuat registry kosong (atau terisi bila config.providers diberikan). Setara dengan new MerchantId(config).

import { createMerchantId } from "merchantid";

const hub = createMerchantId();

MerchantIdConfig

interface MerchantIdConfig {
  providers?: RegisteredMerchantProvider[];
  defaultProviderId?: string;
}

interface RegisteredMerchantProvider {
  provider: MerchantProvider;
  makeDefault?: boolean;
}

Metode

Metode	Kembalian	Kegunaan
`register(provider, options?)`	`void`	Daftarkan provider; `{ makeDefault: true }` menjadikannya default
`unregister(providerId)`	`boolean`	Cabut provider; `true` bila ada yang dicabut
`get(providerId)`	`MerchantProvider \| undefined`	Ambil provider berdasarkan id
`require(providerId)`	`MerchantProvider`	Seperti `get`, tetapi melempar `ConfigError` bila tidak ada
`has(providerId)`	`boolean`	Cek keberadaan
`list()`	`MerchantIdProviderSummary[]`	Ringkasan semua provider terdaftar
`getDefault()`	`MerchantProvider \| undefined`	Provider default aktif
`requireDefault()`	`MerchantProvider`	Default aktif atau melempar `ConfigError`
`setDefault(providerId)`	`void`	Set provider default; melempar bila id tak dikenal
`get defaultProviderId`	`string \| undefined`	Id provider default aktif

MerchantIdProviderSummary

interface MerchantIdProviderSummary {
  id: string;
  isDefault: boolean;
  authenticated: boolean;
}

Dikembalikan oleh list(). authenticated memanggil getter struktural tiap provider (bukan pemeriksaan liveness jaringan).

Contoh

import { createMerchantId } from "merchantid";
import { GopayProvider } from "merchantid";
import { ShopeeProvider } from "merchantid";

const hub = createMerchantId();
hub.register(new GopayProvider(), { makeDefault: true });
hub.register(new ShopeeProvider());

const gopay = hub.require("gopay");
const active = hub.requireDefault();

for (const p of hub.list()) {
  console.log(p.id, p.isDefault, p.authenticated);
}

Lihat Multi provider untuk pola registry dan kontrak MerchantProvider.

⌘I