@lepresk/momo-api 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +224 -0
  2. package/dist/MomoApi.d.ts +30 -0
  3. package/dist/MomoApi.d.ts.map +1 -0
  4. package/dist/MomoApi.js +53 -0
  5. package/dist/MomoApi.js.map +1 -0
  6. package/dist/exceptions/MomoException.d.ts +21 -0
  7. package/dist/exceptions/MomoException.d.ts.map +1 -0
  8. package/dist/exceptions/MomoException.js +66 -0
  9. package/dist/exceptions/MomoException.js.map +1 -0
  10. package/dist/index.d.ts +16 -0
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +55 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/models/AccountBalance.d.ts +9 -0
  15. package/dist/models/AccountBalance.d.ts.map +1 -0
  16. package/dist/models/AccountBalance.js +22 -0
  17. package/dist/models/AccountBalance.js.map +1 -0
  18. package/dist/models/ApiToken.d.ts +16 -0
  19. package/dist/models/ApiToken.d.ts.map +1 -0
  20. package/dist/models/ApiToken.js +27 -0
  21. package/dist/models/ApiToken.js.map +1 -0
  22. package/dist/models/Config.d.ts +19 -0
  23. package/dist/models/Config.d.ts.map +1 -0
  24. package/dist/models/Config.js +31 -0
  25. package/dist/models/Config.js.map +1 -0
  26. package/dist/models/PaymentRequest.d.ts +12 -0
  27. package/dist/models/PaymentRequest.d.ts.map +1 -0
  28. package/dist/models/PaymentRequest.js +37 -0
  29. package/dist/models/PaymentRequest.js.map +1 -0
  30. package/dist/models/RefundRequest.d.ts +12 -0
  31. package/dist/models/RefundRequest.d.ts.map +1 -0
  32. package/dist/models/RefundRequest.js +34 -0
  33. package/dist/models/RefundRequest.js.map +1 -0
  34. package/dist/models/Transaction.d.ts +19 -0
  35. package/dist/models/Transaction.d.ts.map +1 -0
  36. package/dist/models/Transaction.js +52 -0
  37. package/dist/models/Transaction.js.map +1 -0
  38. package/dist/models/TransferRequest.d.ts +12 -0
  39. package/dist/models/TransferRequest.d.ts.map +1 -0
  40. package/dist/models/TransferRequest.js +37 -0
  41. package/dist/models/TransferRequest.js.map +1 -0
  42. package/dist/products/CollectionApi.d.ts +19 -0
  43. package/dist/products/CollectionApi.d.ts.map +1 -0
  44. package/dist/products/CollectionApi.js +97 -0
  45. package/dist/products/CollectionApi.js.map +1 -0
  46. package/dist/products/DisbursementApi.d.ts +24 -0
  47. package/dist/products/DisbursementApi.d.ts.map +1 -0
  48. package/dist/products/DisbursementApi.js +166 -0
  49. package/dist/products/DisbursementApi.js.map +1 -0
  50. package/dist/products/SandboxApi.d.ts +10 -0
  51. package/dist/products/SandboxApi.d.ts.map +1 -0
  52. package/dist/products/SandboxApi.js +60 -0
  53. package/dist/products/SandboxApi.js.map +1 -0
  54. package/dist/support/uuid.d.ts +2 -0
  55. package/dist/support/uuid.d.ts.map +1 -0
  56. package/dist/support/uuid.js +8 -0
  57. package/dist/support/uuid.js.map +1 -0
  58. package/package.json +38 -0
@@ -0,0 +1,10 @@
1
+ export declare class SandboxApi {
2
+ private readonly subscriptionKey;
3
+ private readonly baseUrl;
4
+ constructor(subscriptionKey: string, baseUrl: string);
5
+ private handleResponse;
6
+ createApiUser(apiUser: string, callbackHost: string): Promise<string>;
7
+ getApiUser(apiUser: string): Promise<object>;
8
+ createApiKey(apiUser: string): Promise<string>;
9
+ }
10
+ //# sourceMappingURL=SandboxApi.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SandboxApi.d.ts","sourceRoot":"","sources":["../../src/products/SandboxApi.ts"],"names":[],"mappings":"AAEA,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;gBAEpB,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;YAKtC,cAAc;IAatB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBrE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW5C,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAWrD"}
@@ -0,0 +1,60 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SandboxApi = void 0;
4
+ const MomoException_js_1 = require("../exceptions/MomoException.js");
5
+ class SandboxApi {
6
+ subscriptionKey;
7
+ baseUrl;
8
+ constructor(subscriptionKey, baseUrl) {
9
+ this.subscriptionKey = subscriptionKey;
10
+ this.baseUrl = baseUrl;
11
+ }
12
+ async handleResponse(response) {
13
+ if (!response.ok) {
14
+ const text = await response.text().catch(() => '');
15
+ throw (0, MomoException_js_1.createException)(response.status, text || undefined);
16
+ }
17
+ const text = await response.text();
18
+ if (!text) {
19
+ return {};
20
+ }
21
+ return JSON.parse(text);
22
+ }
23
+ async createApiUser(apiUser, callbackHost) {
24
+ const response = await fetch(`${this.baseUrl}/v1_0/apiuser`, {
25
+ method: 'POST',
26
+ headers: {
27
+ 'Ocp-Apim-Subscription-Key': this.subscriptionKey,
28
+ 'X-Reference-Id': apiUser,
29
+ 'Content-Type': 'application/json',
30
+ },
31
+ body: JSON.stringify({ providerCallbackHost: callbackHost }),
32
+ });
33
+ if (!response.ok) {
34
+ const text = await response.text().catch(() => '');
35
+ throw (0, MomoException_js_1.createException)(response.status, text || undefined);
36
+ }
37
+ return apiUser;
38
+ }
39
+ async getApiUser(apiUser) {
40
+ const response = await fetch(`${this.baseUrl}/v1_0/apiuser/${apiUser}`, {
41
+ method: 'GET',
42
+ headers: {
43
+ 'Ocp-Apim-Subscription-Key': this.subscriptionKey,
44
+ },
45
+ });
46
+ return this.handleResponse(response);
47
+ }
48
+ async createApiKey(apiUser) {
49
+ const response = await fetch(`${this.baseUrl}/v1_0/apiuser/${apiUser}/apikey`, {
50
+ method: 'POST',
51
+ headers: {
52
+ 'Ocp-Apim-Subscription-Key': this.subscriptionKey,
53
+ },
54
+ });
55
+ const data = await this.handleResponse(response);
56
+ return data['apiKey'];
57
+ }
58
+ }
59
+ exports.SandboxApi = SandboxApi;
60
+ //# sourceMappingURL=SandboxApi.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SandboxApi.js","sourceRoot":"","sources":["../../src/products/SandboxApi.ts"],"names":[],"mappings":";;;AAAA,qEAAgE;AAEhE,MAAa,UAAU;IACJ,eAAe,CAAQ;IACvB,OAAO,CAAQ;IAEhC,YAAY,eAAuB,EAAE,OAAe;QAClD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAA;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAI,QAAkB;QAChD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YAClD,MAAM,IAAA,kCAAe,EAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAO,CAAA;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,YAAoB;QACvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,eAAe,EAAE;YAC3D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,2BAA2B,EAAE,IAAI,CAAC,eAAe;gBACjD,gBAAgB,EAAE,OAAO;gBACzB,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC;SAC7D,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YAClD,MAAM,IAAA,kCAAe,EAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC,CAAA;QAC3D,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,iBAAiB,OAAO,EAAE,EAAE;YACtE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,2BAA2B,EAAE,IAAI,CAAC,eAAe;aAClD;SACF,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,cAAc,CAAS,QAAQ,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,iBAAiB,OAAO,SAAS,EAAE;YAC7E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,2BAA2B,EAAE,IAAI,CAAC,eAAe;aAClD;SACF,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAA0B,QAAQ,CAAC,CAAA;QACzE,OAAO,IAAI,CAAC,QAAQ,CAAW,CAAA;IACjC,CAAC;CACF;AA/DD,gCA+DC"}
@@ -0,0 +1,2 @@
1
+ export declare function generateUUID(): string;
2
+ //# sourceMappingURL=uuid.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/support/uuid.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,IAAI,MAAM,CAErC"}
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.generateUUID = generateUUID;
4
+ const crypto_1 = require("crypto");
5
+ function generateUUID() {
6
+ return (0, crypto_1.randomUUID)();
7
+ }
8
+ //# sourceMappingURL=uuid.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/support/uuid.ts"],"names":[],"mappings":";;AAEA,oCAEC;AAJD,mCAAmC;AAEnC,SAAgB,YAAY;IAC1B,OAAO,IAAA,mBAAU,GAAE,CAAA;AACrB,CAAC"}
package/package.json ADDED
@@ -0,0 +1,38 @@
1
+ {
2
+ "name": "@lepresk/momo-api",
3
+ "version": "1.0.0",
4
+ "description": "MTN Mobile Money API client for Node.js — collections, disbursements and remittances",
5
+ "author": "lepresk <lepresk@gmail.com>",
6
+ "license": "MIT",
7
+ "main": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "files": [
10
+ "dist"
11
+ ],
12
+ "engines": {
13
+ "node": ">=18.0.0"
14
+ },
15
+ "keywords": [
16
+ "mtn",
17
+ "momo",
18
+ "mobile-money",
19
+ "africa",
20
+ "fintech",
21
+ "api-client"
22
+ ],
23
+ "repository": {
24
+ "type": "git",
25
+ "url": "https://github.com/lepresk/momo-api-node.git"
26
+ },
27
+ "devDependencies": {
28
+ "@types/node": "^25.3.2",
29
+ "tsx": "^4.21.0",
30
+ "typescript": "^5.9.3",
31
+ "vitest": "^4.0.18"
32
+ },
33
+ "scripts": {
34
+ "build": "tsc",
35
+ "test": "vitest run",
36
+ "dev": "tsx src/index.ts"
37
+ }
38
+ }