pi-spi-sdk 0.1.2 → 0.2.0

package/dist/qrcode/index.d.cts

@@ -0,0 +1,68 @@
+declare const PISPI_AMBER_LOGO_DATA_URL: string;
+declare const PISPI_QRCODE_LOGO_DATA_URL: string;
+declare const DEFAULT_PISPI_LOGO_DATA_URL: string;
+
+type QrType = 'STATIC' | 'DYNAMIC';
+interface QrPayloadInput {
+    alias: string;
+    countryCode: string;
+    qrType: QrType;
+    referenceLabel: string;
+    amount?: number | string;
+}
+interface AdditionalDataOverrides {
+    merchantChannel?: string;
+    purposeOfTransaction?: string;
+    /**
+     * Free form additional data embedded inside template 62 (id => value)
+     * Keys must be 2-digit strings according to EMV specification.
+     */
+    custom?: Record<string, string>;
+}
+interface QrPayloadOptions {
+    /**
+     * Override default Additional Data tags.
+     */
+    additionalData?: AdditionalDataOverrides;
+}
+interface QrPayloadResult {
+    payload: string;
+}
+interface QrValidationResult {
+    valid: boolean;
+    errors: string[];
+    data?: QrPayloadInput;
+}
+interface QrCodeSvgOptions {
+    size?: number;
+    margin?: number;
+    logoDataUrl?: string;
+    logoSizeRatio?: number;
+    logoPaddingRatio?: number;
+    logoBackgroundColor?: string;
+    logoBorderRadiusRatio?: number;
+    dotColor?: string;
+    backgroundColor?: string;
+}
+/**
+ * Génère la payload EMV conforme PI-SPI pour un QR Code.
+ */
+declare function createQrPayload(input: QrPayloadInput, options?: QrPayloadOptions): QrPayloadResult;
+declare function computeCrc16(input: string): string;
+declare function buildPayloadString(params: QrPayloadInput, options?: QrPayloadOptions): string;
+declare function generateQrCodeSvg(input: QrPayloadInput, options?: QrCodeSvgOptions): Promise<string>;
+declare const QRCode: {
+    createQrPayload: typeof createQrPayload;
+    buildPayloadString: typeof buildPayloadString;
+    computeCrc16: typeof computeCrc16;
+    generateQrCodeSvg: typeof generateQrCodeSvg;
+    isValidPispiQrPayload: typeof isValidPispiQrPayload;
+    payload: typeof buildPayloadString;
+    svg: typeof generateQrCodeSvg;
+    validate: typeof isValidPispiQrPayload;
+    raw: typeof createQrPayload;
+};
+
+declare function isValidPispiQrPayload(value: string): QrValidationResult;
+
+export { type AdditionalDataOverrides, DEFAULT_PISPI_LOGO_DATA_URL, PISPI_AMBER_LOGO_DATA_URL, PISPI_QRCODE_LOGO_DATA_URL, QRCode, type QrCodeSvgOptions, type QrPayloadInput, type QrPayloadOptions, type QrPayloadResult, type QrType, type QrValidationResult, buildPayloadString, computeCrc16, createQrPayload, QRCode as default, generateQrCodeSvg, isValidPispiQrPayload };

package/dist/qrcode/index.d.ts

@@ -0,0 +1,68 @@
+declare const PISPI_AMBER_LOGO_DATA_URL: string;
+declare const PISPI_QRCODE_LOGO_DATA_URL: string;
+declare const DEFAULT_PISPI_LOGO_DATA_URL: string;
+
+type QrType = 'STATIC' | 'DYNAMIC';
+interface QrPayloadInput {
+    alias: string;
+    countryCode: string;
+    qrType: QrType;
+    referenceLabel: string;
+    amount?: number | string;
+}
+interface AdditionalDataOverrides {
+    merchantChannel?: string;
+    purposeOfTransaction?: string;
+    /**
+     * Free form additional data embedded inside template 62 (id => value)
+     * Keys must be 2-digit strings according to EMV specification.
+     */
+    custom?: Record<string, string>;
+}
+interface QrPayloadOptions {
+    /**
+     * Override default Additional Data tags.
+     */
+    additionalData?: AdditionalDataOverrides;
+}
+interface QrPayloadResult {
+    payload: string;
+}
+interface QrValidationResult {
+    valid: boolean;
+    errors: string[];
+    data?: QrPayloadInput;
+}
+interface QrCodeSvgOptions {
+    size?: number;
+    margin?: number;
+    logoDataUrl?: string;
+    logoSizeRatio?: number;
+    logoPaddingRatio?: number;
+    logoBackgroundColor?: string;
+    logoBorderRadiusRatio?: number;
+    dotColor?: string;
+    backgroundColor?: string;
+}
+/**
+ * Génère la payload EMV conforme PI-SPI pour un QR Code.
+ */
+declare function createQrPayload(input: QrPayloadInput, options?: QrPayloadOptions): QrPayloadResult;
+declare function computeCrc16(input: string): string;
+declare function buildPayloadString(params: QrPayloadInput, options?: QrPayloadOptions): string;
+declare function generateQrCodeSvg(input: QrPayloadInput, options?: QrCodeSvgOptions): Promise<string>;
+declare const QRCode: {
+    createQrPayload: typeof createQrPayload;
+    buildPayloadString: typeof buildPayloadString;
+    computeCrc16: typeof computeCrc16;
+    generateQrCodeSvg: typeof generateQrCodeSvg;
+    isValidPispiQrPayload: typeof isValidPispiQrPayload;
+    payload: typeof buildPayloadString;
+    svg: typeof generateQrCodeSvg;
+    validate: typeof isValidPispiQrPayload;
+    raw: typeof createQrPayload;
+};
+
+declare function isValidPispiQrPayload(value: string): QrValidationResult;
+
+export { type AdditionalDataOverrides, DEFAULT_PISPI_LOGO_DATA_URL, PISPI_AMBER_LOGO_DATA_URL, PISPI_QRCODE_LOGO_DATA_URL, QRCode, type QrCodeSvgOptions, type QrPayloadInput, type QrPayloadOptions, type QrPayloadResult, type QrType, type QrValidationResult, buildPayloadString, computeCrc16, createQrPayload, QRCode as default, generateQrCodeSvg, isValidPispiQrPayload };