@ripwords/myinvois-client 0.0.7 → 0.0.9

package/dist/index.js

@@ -1,4 +1,36 @@
 
+//#region src/utils/getBaseUrl.ts
+const getBaseUrl = (environment) => {
+	return environment === "sandbox" ? "https://preprod-api.myinvois.hasil.gov.my" : "https://api.myinvois.hasil.gov.my";
+};
+
+//#endregion
+//#region src/api/platform/taxpayerLogin.ts
+const taxpayerLogin = async (client) => {
+	const { clientId, clientSecret, baseUrl, debug } = client;
+	try {
+		const response = await fetch(`${baseUrl}/connect/token`, {
+			method: "POST",
+			headers: { "Content-Type": "application/x-www-form-urlencoded" },
+			body: new URLSearchParams({
+				grant_type: "client_credentials",
+				client_id: clientId,
+				client_secret: clientSecret,
+				scope: "InvoicingAPI"
+			})
+		});
+		const tokenResponse = await response.json();
+		return {
+			token: tokenResponse.access_token,
+			tokenExpiration: new Date(Date.now() + tokenResponse.expires_in * 1e3)
+		};
+	} catch (error) {
+		if (debug) console.error(error);
+		throw error;
+	}
+};
+
+//#endregion
 //#region src/utils/MyInvoisClient.ts
 var MyInvoisClient = class {
 	baseUrl;
@@ -10,28 +42,18 @@ var MyInvoisClient = class {
 	constructor(clientId, clientSecret, environment, debug = false) {
 		this.clientId = clientId;
 		this.clientSecret = clientSecret;
+		this.baseUrl = getBaseUrl(environment);
 		this.debug = debug;
-		if (environment === "sandbox") this.baseUrl = "https://preprod-api.myinvois.hasil.gov.my";
-		else this.baseUrl = "https://api.myinvois.hasil.gov.my";
 	}
 	async refreshToken() {
-		try {
-			const response = await fetch(`${this.baseUrl}/connect/token`, {
-				method: "POST",
-				headers: { "Content-Type": "application/x-www-form-urlencoded" },
-				body: new URLSearchParams({
-					grant_type: "client_credentials",
-					client_id: this.clientId,
-					client_secret: this.clientSecret,
-					scope: "InvoicingAPI"
-				})
-			});
-			const tokenResponse = await response.json();
-			this.token = tokenResponse.access_token;
-			this.tokenExpiration = new Date(Date.now() + tokenResponse.expires_in * 1e3);
-		} catch (error) {
-			if (this.debug) console.error(error);
-		}
+		const tokenResponse = await taxpayerLogin({
+			clientId: this.clientId,
+			clientSecret: this.clientSecret,
+			baseUrl: this.baseUrl,
+			debug: this.debug
+		});
+		this.token = tokenResponse.token;
+		this.tokenExpiration = tokenResponse.tokenExpiration;
 	}
 	async getToken() {
 		if (!this.tokenExpiration || this.tokenExpiration < new Date()) {
@@ -55,7 +77,7 @@ var MyInvoisClient = class {
 	*
 	* @param tin
 	* @param nric
-	* @returns
+	* @returns true if the TIN is valid, false otherwise
 	*/
 	async verifyTin(tin, nric) {
 		try {

package/package.json

@@ -1,31 +1,33 @@
 {
   "name": "@ripwords/myinvois-client",
-  "version": "0.0.7",
+  "version": "0.0.9",
+  "description": "MyInvois client",
+  "scripts": {
+    "build": "bun run clean && rolldown -c rolldown.config.ts",
+    "release": "bun run build && npm publish --access public",
+    "clean": "rimraf dist",
+    "lint": "oxlint",
+    "test": "vitest"
+  },
   "main": "dist/index.js",
   "module": "src/index.ts",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "import": "./dist/index.js",
+    "require": "./dist/index.cjs"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "dotenv": "^16.5.0",
     "oxlint": "^0.16.6",
     "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
     "rolldown": "^1.0.0-beta.7",
-    "rolldown-plugin-dts": "^0.7.0",
+    "rolldown-plugin-dts": "^0.7.13",
     "vitest": "^3.1.1"
   },
-  "exports": {
-    "import": "./dist/index.js",
-    "require": "./dist/index.cjs"
-  },
   "peerDependencies": {
-    "typescript": "^5"
-  },
-  "description": "MyInvois client",
-  "scripts": {
-    "build": "rolldown -c rolldown.config.ts",
-    "release": "bun run build && npm publish --access public && git push --follow-tags",
-    "lint": "oxlint",
-    "test": "vitest"
-  },
-  "type": "module",
-  "types": "dist/index.d.ts"
+    "typescript": "^5.8.3"
+  }
 }

package/rolldown.config.ts

@@ -4,7 +4,11 @@ import { dts } from 'rolldown-plugin-dts'
 export default defineConfig([
   {
     input: 'src/index.ts',
-    plugins: [dts()],
+    plugins: [
+      dts({
+        isolatedDeclaration: true,
+      }),
+    ],
     output: {
       dir: 'dist',
     },

package/src/api/platform/taxpayerLogin.ts

@@ -0,0 +1,28 @@
+import type { ClientCredentials, TokenResponse } from 'src/types'
+
+export const taxpayerLogin = async (client: ClientCredentials) => {
+  const { clientId, clientSecret, baseUrl, debug } = client
+  try {
+    const response = await fetch(`${baseUrl}/connect/token`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/x-www-form-urlencoded',
+      },
+      body: new URLSearchParams({
+        grant_type: 'client_credentials',
+        client_id: clientId,
+        client_secret: clientSecret,
+        scope: 'InvoicingAPI',
+      }),
+    })
+
+    const tokenResponse: TokenResponse = await response.json()
+    return {
+      token: tokenResponse.access_token,
+      tokenExpiration: new Date(Date.now() + tokenResponse.expires_in * 1000),
+    }
+  } catch (error) {
+    if (debug) console.error(error)
+    throw error
+  }
+}

package/src/types/index.d.ts

@@ -9,3 +9,15 @@ export type * from './currencies.d.ts'
 export type * from './state-codes.d.ts'
 export type * from './e-invoice.d.ts'
 export type * from './msic-codes.d.ts'
+
+export interface TokenResponse {
+  access_token: string
+  expires_in: number
+}
+
+export interface ClientCredentials {
+  clientId: string
+  clientSecret: string
+  baseUrl: string
+  debug?: boolean
+}

package/src/types/unit/1X.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Unit type codes starting with '1'.
+ */
+export type UnitTypeCode_1X = '10' | '11' | '13' | '14' | '15' | '1I'
+
+/**
+ * Enum representing unit type codes starting with '1'.
+ */
+export enum UnitTypeCodeEnum_1X {
+  Group = '10',
+  Outfit = '11',
+  Ration = '13',
+  Shot = '14',
+  StickMilitary = '15',
+  FixedRate = '1I',
+}

package/src/types/unit/2X.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Unit type codes starting with '2'.
+ */
+export type UnitTypeCode_2X =
+  | '20'
+  | '21'
+  | '22'
+  | '23'
+  | '24'
+  | '25'
+  | '27'
+  | '28'
+  | '2A'
+  | '2B'
+  | '2C'
+  | '2G'
+  | '2H'
+  | '2I'
+  | '2J'
+  | '2K'
+  | '2L'
+  | '2M'
+  | '2N'
+  | '2P'
+  | '2Q'
+  | '2R'
+  | '2U'
+  | '2X'
+  | '2Y'
+  | '2Z'
+
+/**
+ * Enum representing unit type codes starting with '2'.
+ */
+export enum UnitTypeCodeEnum_2X {
+  TwentyFootContainer = '20',
+  FortyFootContainer = '21',
+  DecilitrePerGram = '22',
+  GramPerCubicCentimetre = '23',
+  TheoreticalPound = '24',
+  GramPerSquareCentimetre = '25',
+  TheoreticalTon = '27',
+  KilogramPerSquareMetre = '28',
+  RadianPerSecond = '2A',
+  RadianPerSecondSquared = '2B',
+  Roentgen = '2C',
+  VoltAC = '2G',
+  VoltDC = '2H',
+  BritishThermalUnitInternationalTablePerHour = '2I',
+  CubicCentimetrePerSecond = '2J',
+  CubicFootPerHour = '2K',
+  CubicFootPerMinute = '2L',
+  CentimetrePerSecond = '2M',
+  Decibel = '2N',
+  Kilobyte = '2P',
+  Kilobecquerel = '2Q',
+  Kilocurie = '2R',
+  Megagram = '2U',
+  MetrePerMinute = '2X',
+  Milliroentgen = '2Y',
+  Millivolt = '2Z',
+}

package/src/types/unit/3X.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Unit type codes starting with '3'.
+ */
+export type UnitTypeCode_3X = '33' | '34' | '35' | '37' | '38' | '3B' | '3C'
+
+/**
+ * Enum representing unit type codes starting with '3'.
+ */
+export enum UnitTypeCodeEnum_3X {
+  KilopascalSquareMetrePerGram = '33',
+  KilopascalPerMillimetre = '34',
+  MillilitrePerSquareCentimetreSecond = '35',
+  OuncePerSquareFoot = '37',
+  OuncePerSquareFootPer0_01inch = '38',
+  Megajoule = '3B',
+  Manmonth = '3C',
+}

package/src/types/unit/4X.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Unit type codes starting with '4'.
+ */
+export type UnitTypeCode_4X =
+  | '40'
+  | '41'
+  | '4C'
+  | '4G'
+  | '4H'
+  | '4K'
+  | '4L'
+  | '4M'
+  | '4N'
+  | '4O'
+  | '4P'
+  | '4Q'
+  | '4R'
+  | '4T'
+  | '4U'
+  | '4W'
+  | '4X'
+
+/**
+ * Enum representing unit type codes starting with '4'.
+ */
+export enum UnitTypeCodeEnum_4X {
+  MillilitrePerSecond = '40',
+  MillilitrePerMinute = '41',
+  Centistokes = '4C',
+  Microlitre = '4G',
+  MicrometreMicron = '4H',
+  Milliampere = '4K',
+  Megabyte = '4L',
+  MilligramPerHour = '4M',
+  Megabecquerel = '4N',
+  Microfarad = '4O',
+  NewtonPerMetre = '4P',
+  OunceInch = '4Q',
+  OunceFoot = '4R',
+  Picofarad = '4T',
+  PoundPerHour = '4U',
+  TonUSPerHour = '4W',
+  KilolitrePerHour = '4X',
+}

package/src/types/unit/5X.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Unit type codes starting with '5'.
+ */
+export type UnitTypeCode_5X =
+  | '56'
+  | '57'
+  | '58'
+  | '59'
+  | '5A'
+  | '5B'
+  | '5E'
+  | '5J'
+
+/**
+ * Enum representing unit type codes starting with '5'.
+ */
+export enum UnitTypeCodeEnum_5X {
+  Sitas = '56',
+  Mesh = '57',
+  NetKilogram = '58',
+  PartPerMillion = '59',
+  BarrelUSPerMinute = '5A',
+  Batch = '5B',
+  MMSCFDay = '5E',
+  HydraulicHorsePower = '5J',
+}

package/src/types/unit/6X.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Unit type codes starting with '6'.
+ */
+export type UnitTypeCode_6X = '60' | '61'
+
+/**
+ * Enum representing unit type codes starting with '6'.
+ */
+export enum UnitTypeCodeEnum_6X {
+  PercentWeight = '60',
+  PartPerBillionUS = '61',
+}

package/src/types/unit/7X.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Unit type codes starting with '7'.
+ */
+export type UnitTypeCode_7X = '74' | '77'
+
+/**
+ * Enum representing unit type codes starting with '7'.
+ */
+export enum UnitTypeCodeEnum_7X {
+  Millipascal = '74',
+  MilliInch = '77',
+}

package/src/types/unit/8X.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Unit type codes starting with '8'.
+ */
+export type UnitTypeCode_8X = '80' | '81' | '85' | '87' | '89'
+
+/**
+ * Enum representing unit type codes starting with '8'.
+ */
+export enum UnitTypeCodeEnum_8X {
+  PoundPerSquareInchAbsolute = '80',
+  Henry = '81',
+  FootPoundForce = '85',
+  PoundPerCubicFoot = '87',
+  Poise = '89',
+}

package/src/types/unit/9X.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit type codes starting with '9'.
+ */
+export type UnitTypeCode_9X = '91'
+
+/**
+ * Enum representing unit type codes starting with '9'.
+ */
+export enum UnitTypeCodeEnum_9X {
+  Stokes = '91',
+}

package/src/types/unit/AX.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Unit type codes starting with 'A'.
+ */
+export type UnitTypeCode_AX =
+  | 'A10'
+  | 'A11'
+  | 'A12'
+  | 'A13'
+  | 'A14'
+  | 'A15'
+  | 'A16'
+  | 'A17'
+  | 'A18'
+  | 'A19'
+  | 'A2'
+  | 'A20'
+  | 'A21'
+  | 'A22'
+  | 'A23'
+  | 'A24'
+  | 'A26'
+  | 'A27'
+  | 'A28'
+  | 'A29'
+  | 'A3'
+  | 'A30'
+  | 'A31'
+  | 'A32'
+  | 'A33'
+  | 'A34'
+  | 'A35'
+  | 'A36'
+  | 'A37'
+  | 'A38'
+  | 'A39'
+  | 'A4'
+  | 'A40'
+  | 'A41'
+  | 'A42'
+  | 'A43'
+  | 'A44'
+  | 'A45'
+  | 'A47'
+  | 'A48'
+  | 'A49'
+  | 'A5'
+  | 'A53'
+  | 'A54'
+  | 'A55'
+  | 'A56'
+  | 'A59'
+  | 'A6'
+  | 'A68'
+  | 'A69'
+  | 'A7'
+  | 'A70'
+  | 'A71'
+  | 'A73'
+  | 'A74'
+  | 'A75'
+  | 'A76'
+  | 'A8'
+  | 'A84'
+  | 'A85'
+  | 'A86'
+  | 'A87'
+  | 'A88'
+  | 'A89'
+  | 'A9'
+  | 'A90'
+  | 'A91'
+  | 'A93'
+  | 'A94'
+  | 'A95'
+  | 'A96'
+  | 'A97'
+  | 'A98'
+  | 'A99'
+  | 'AA'
+  | 'AB'
+  | 'ACR'
+  | 'ACT'
+  | 'AD'
+  | 'AE'
+  | 'AH'
+  | 'AI'
+  | 'AK'
+  | 'AL'
+  | 'AMH'
+  | 'AMP'
+  | 'ANN'
+  | 'APZ'
+  | 'AQ'
+  | 'AS'
+  | 'ASM'
+  | 'ASU'
+  | 'ATM'
+  | 'AWG'
+  | 'AY'
+  | 'AZ'
+
+/**
+ * Enum representing unit type codes starting with 'A'.
+ */
+export enum UnitTypeCodeEnum_AX {
+  AmpereSquareMetrePerJouleSecond = 'A10',
+  Angstrom = 'A11',
+  AstronomicalUnit = 'A12',
+  Attojoule = 'A13',
+  Barn = 'A14',
+  BarnPerElectronvolt = 'A15',
+  BarnPerSteradianElectronvolt = 'A16',
+  BarnPerSteradian = 'A17',
+  BecquerelPerKilogram = 'A18',
+  BecquerelPerCubicMetre = 'A19',
+  AmperePerCentimetre = 'A2',
+  BritishThermalUnitInternationalTablePerSecondSquareFootDegreeRankine = 'A20',
+  BritishThermalUnitInternationalTablePerPoundDegreeRankine = 'A21',
+  BritishThermalUnitInternationalTablePerSecondFootDegreeRankine = 'A22',
+  BritishThermalUnitInternationalTablePerHourSquareFootDegreeRankine = 'A23',
+  CandelaPerSquareMetre = 'A24',
+  CoulombMetre = 'A26',
+  CoulombMetreSquaredPerVolt = 'A27',
+  CoulombPerCubicCentimetre = 'A28',
+  CoulombPerCubicMetre = 'A29',
+  AmperePerMillimetre = 'A3',
+  CoulombPerCubicMillimetre = 'A30',
+  CoulombPerKilogramSecond = 'A31',
+  CoulombPerMole = 'A32',
+  CoulombPerSquareCentimetre = 'A33',
+  CoulombPerSquareMetre = 'A34',
+  CoulombPerSquareMillimetre = 'A35',
+  CubicCentimetrePerMole = 'A36',
+  CubicDecimetrePerMole = 'A37',
+  CubicMetrePerCoulomb = 'A38',
+  CubicMetrePerKilogram = 'A39',
+  AmperePerSquareCentimetre = 'A4',
+  CubicMetrePerMole = 'A40',
+  AmperePerSquareMetre = 'A41',
+  CuriePerKilogram = 'A42',
+  DeadweightTonnage = 'A43',
+  Decalitre = 'A44',
+  Decametre = 'A45',
+  Decitex = 'A47',
+  DegreeRankine = 'A48',
+  Denier = 'A49',
+  AmpereSquareMetre = 'A5',
+  Electronvolt = 'A53',
+  ElectronvoltPerMetre = 'A54',
+  ElectronvoltSquareMetre = 'A55',
+  ElectronvoltSquareMetrePerKilogram = 'A56',
+  _8PartCloudCover = 'A59', // Enum member names cannot start with a number
+  AmperePerSquareMetreKelvinSquared = 'A6',
+  Exajoule = 'A68',
+  FaradPerMetre = 'A69',
+  AmperePerSquareMillimetre = 'A7',
+  Femtojoule = 'A70',
+  Femtometre = 'A71',
+  FootPerSecondSquared = 'A73',
+  FootPoundForcePerSecond = 'A74',
+  FreightTon = 'A75',
+  Gal = 'A76',
+  AmpereSecond = 'A8',
+  GigacoulombPerCubicMetre = 'A84',
+  Gigaelectronvolt = 'A85',
+  Gigahertz = 'A86',
+  Gigaohm = 'A87',
+  GigaohmMetre = 'A88',
+  Gigapascal = 'A89',
+  Rate = 'A9',
+  Gigawatt = 'A90',
+  Gon = 'A91',
+  GramPerCubicMetre = 'A93',
+  GramPerMole = 'A94',
+  Gray = 'A95',
+  GrayPerSecond = 'A96',
+  Hectopascal = 'A97',
+  HenryPerMetre = 'A98',
+  Bit = 'A99',
+  Ball = 'AA',
+  BulkPack = 'AB',
+  Acre = 'ACR',
+  Activity = 'ACT',
+  Byte = 'AD',
+  AmperePerMetre = 'AE',
+  AdditionalMinute = 'AH',
+  AverageMinutePerCall = 'AI',
+  Fathom = 'AK',
+  AccessLine = 'AL',
+  AmpereHour = 'AMH',
+  Ampere = 'AMP',
+  Year = 'ANN',
+  TroyOunceOrApothecaryOunce = 'APZ',
+  AntiHemophilicFactorAHFUnit = 'AQ',
+  Assortment = 'AS',
+  AlcoholicStrengthByMass = 'ASM',
+  AlcoholicStrengthByVolume = 'ASU',
+  StandardAtmosphere = 'ATM',
+  AmericanWireGauge = 'AWG',
+  Assembly = 'AY',
+  BritishThermalUnitInternationalTablePerPound = 'AZ',
+}