@nimee/api-clients 1.1.98 → 1.1.99

package/dist/src/index.d.ts

@@ -13,3 +13,4 @@ export { CrmClient } from "./crm";
 export { AnalyticsClient, UtmData } from "./analytics";
 export { ScannerSessionClient } from "./scannerSession";
 export { VoucherSourceClient } from "./voucherSource";
+export { InvoiceClient } from "./invoice";

package/dist/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VoucherSourceClient = exports.ScannerSessionClient = exports.AnalyticsClient = exports.CrmClient = exports.EndUserSeasonTicketClient = exports.SegmentClient = exports.EndUserClient = exports.MarketplaceClient = exports.PaymentClient = exports.EventOrderClient = exports.AccountClient = exports.UserEventClient = exports.TicketClient = exports.EventClient = exports.UserClient = void 0;
+exports.InvoiceClient = exports.VoucherSourceClient = exports.ScannerSessionClient = exports.AnalyticsClient = exports.CrmClient = exports.EndUserSeasonTicketClient = exports.SegmentClient = exports.EndUserClient = exports.MarketplaceClient = exports.PaymentClient = exports.EventOrderClient = exports.AccountClient = exports.UserEventClient = exports.TicketClient = exports.EventClient = exports.UserClient = void 0;
 var user_1 = require("./user");
 Object.defineProperty(exports, "UserClient", { enumerable: true, get: function () { return user_1.UserClient; } });
 var event_1 = require("./event");
@@ -31,4 +31,6 @@ var scannerSession_1 = require("./scannerSession");
 Object.defineProperty(exports, "ScannerSessionClient", { enumerable: true, get: function () { return scannerSession_1.ScannerSessionClient; } });
 var voucherSource_1 = require("./voucherSource");
 Object.defineProperty(exports, "VoucherSourceClient", { enumerable: true, get: function () { return voucherSource_1.VoucherSourceClient; } });
+var invoice_1 = require("./invoice");
+Object.defineProperty(exports, "InvoiceClient", { enumerable: true, get: function () { return invoice_1.InvoiceClient; } });
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AAA3B,kGAAA,UAAU,OAAA;AACnB,iCAAsC;AAA7B,oGAAA,WAAW,OAAA;AACpB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AACxB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA;AACzB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAC1B,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,6DAAkE;AAAzD,gIAAA,yBAAyB,OAAA;AAClC,6BAAkC;AAAzB,gGAAA,SAAS,OAAA;AAClB,yCAAuD;AAA9C,4GAAA,eAAe,OAAA;AACxB,mDAAwD;AAA/C,sHAAA,oBAAoB,OAAA;AAE7B,iDAAsD;AAA7C,oHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AAA3B,kGAAA,UAAU,OAAA;AACnB,iCAAsC;AAA7B,oGAAA,WAAW,OAAA;AACpB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AACxB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA;AACzB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAC1B,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,6DAAkE;AAAzD,gIAAA,yBAAyB,OAAA;AAClC,6BAAkC;AAAzB,gGAAA,SAAS,OAAA;AAClB,yCAAuD;AAA9C,4GAAA,eAAe,OAAA;AACxB,mDAAwD;AAA/C,sHAAA,oBAAoB,OAAA;AAE7B,iDAAsD;AAA7C,oHAAA,mBAAmB,OAAA;AAE5B,qCAA0C;AAAjC,wGAAA,aAAa,OAAA"}

package/dist/src/invoice.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Client for the invoices microservice (Nimi self-issued fiscal documents).
+ * doc/create and doc/cancel are internal-only routes gated to the fixed
+ * JWT_ADMIN service token - always call them with jwt: process.env.JWT_ADMIN.
+ */
+export declare class InvoiceClient {
+    /** Create a fiscal document (invoice / receipt / credit note). Idempotent on body.sanity_string. */
+    createDoc(params: {
+        jwt: string;
+        body: Record<string, unknown>;
+    }): Promise<any>;
+    /** Cancel a document by issuing a reversing credit note. */
+    cancelDoc(params: {
+        jwt: string;
+        body: {
+            sellerId: string;
+            doctype: string;
+            docnum: number;
+            reason?: string;
+        };
+    }): Promise<any>;
+}

package/dist/src/invoice.js

@@ -0,0 +1,50 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoiceClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const error_handler_1 = require("@nimee/error-handler");
+const port = process.env.INVOICES_PORT || "3009"; // default keeps IS_LOCAL dev working without env setup
+const basePath = process.env.IS_LOCAL === "true" ? `http://127.0.0.1:${port}` : "http://invoices";
+/**
+ * Client for the invoices microservice (Nimi self-issued fiscal documents).
+ * doc/create and doc/cancel are internal-only routes gated to the fixed
+ * JWT_ADMIN service token - always call them with jwt: process.env.JWT_ADMIN.
+ */
+class InvoiceClient {
+    /** Create a fiscal document (invoice / receipt / credit note). Idempotent on body.sanity_string. */
+    createDoc(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { jwt, body } = params;
+            if (!jwt || !body) {
+                throw new error_handler_1.CustomError("params_missing_invoice_create_doc", 400, "jwt and body are required");
+            }
+            const response = yield axios_1.default.post(`${basePath}/invoices-internal/doc/create`, body, { headers: { jwt } });
+            return response === null || response === void 0 ? void 0 : response.data;
+        });
+    }
+    /** Cancel a document by issuing a reversing credit note. */
+    cancelDoc(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { jwt, body } = params;
+            if (!jwt || !body) {
+                throw new error_handler_1.CustomError("params_missing_invoice_cancel_doc", 400, "jwt and body are required");
+            }
+            const response = yield axios_1.default.post(`${basePath}/invoices-internal/doc/cancel`, body, { headers: { jwt } });
+            return response === null || response === void 0 ? void 0 : response.data;
+        });
+    }
+}
+exports.InvoiceClient = InvoiceClient;
+//# sourceMappingURL=invoice.js.map

package/dist/src/invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.js","sourceRoot":"","sources":["../../src/invoice.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,kDAA0B;AAC1B,wDAAmD;AAEnD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,CAAC,CAAC,uDAAuD;AACzG,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;AAElG;;;;GAIG;AACH,MAAa,aAAa;IACxB,oGAAoG;IAC9F,SAAS,CAAC,MAAsD;;YACpE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;YAC7B,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,2BAAW,CAAC,mCAAmC,EAAE,GAAG,EAAE,2BAA2B,CAAC,CAAC;YAC/F,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,+BAA+B,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAC1G,OAAO,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,CAAC;QACxB,CAAC;KAAA;IAED,4DAA4D;IACtD,SAAS,CAAC,MAAqG;;YACnH,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;YAC7B,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,2BAAW,CAAC,mCAAmC,EAAE,GAAG,EAAE,2BAA2B,CAAC,CAAC;YAC/F,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,+BAA+B,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAC1G,OAAO,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,CAAC;QACxB,CAAC;KAAA;CACF;AApBD,sCAoBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimee/api-clients",
-  "version": "1.1.98",
+  "version": "1.1.99",
   "description": "communication http for each ms",
   "main": "dist/src/index.js",
   "author": "dan goldberg",
@@ -14,12 +14,12 @@
     "prettier-format": "prettier --config .prettierrc 'src/**/*.ts' --write",
     "incVersionAndPublish": "npm run test:deploy && npm version patch && npm run publish-it && npm run i-all-workspaces",
     "publish-it": "npm run build && npm publish --scope=nimee --access public",
-    "i-all-workspaces": "version=${npm_package_version} npm i @nimee/api-clients@$version  --workspace=@nimee/event --workspace=@nimee/user-event --workspace=@nimee/send-notification --workspace=@nimee/user  --workspace=@nimee/payment --workspace=@nimee/analytics --workspace=@nimee/crm",
+    "i-all-workspaces": "version=${npm_package_version} npm i @nimee/api-clients@$version  --workspace=@nimee/event --workspace=@nimee/user-event --workspace=@nimee/send-notification --workspace=@nimee/user  --workspace=@nimee/payment --workspace=@nimee/analytics --workspace=@nimee/crm --workspace=@nimee/invoices",
     "test": "jest --detectOpenHandles --watch",
     "test:deploy": "jest --ci --coverage"
   },
   "devDependencies": {
-    "@nimee/tests": "^0.0.39",
+    "@nimee/tests": "^0.0.40",
     "@typescript-eslint/eslint-plugin": "^5.18.0",
     "@typescript-eslint/eslint-plugin-tslint": "^5.18.0",
     "@typescript-eslint/parser": "^5.18.0",

package/src/index.ts

@@ -14,3 +14,5 @@ export { AnalyticsClient, UtmData } from "./analytics";
 export { ScannerSessionClient } from "./scannerSession";
 
 export { VoucherSourceClient } from "./voucherSource";
+
+export { InvoiceClient } from "./invoice";

package/src/invoice.ts

@@ -0,0 +1,32 @@
+import axios from "axios";
+import { CustomError } from "@nimee/error-handler";
+
+const port = process.env.INVOICES_PORT || "3009"; // default keeps IS_LOCAL dev working without env setup
+const basePath = process.env.IS_LOCAL === "true" ? `http://127.0.0.1:${port}` : "http://invoices";
+
+/**
+ * Client for the invoices microservice (Nimi self-issued fiscal documents).
+ * doc/create and doc/cancel are internal-only routes gated to the fixed
+ * JWT_ADMIN service token - always call them with jwt: process.env.JWT_ADMIN.
+ */
+export class InvoiceClient {
+  /** Create a fiscal document (invoice / receipt / credit note). Idempotent on body.sanity_string. */
+  async createDoc(params: { jwt: string; body: Record<string, unknown> }) {
+    const { jwt, body } = params;
+    if (!jwt || !body) {
+      throw new CustomError("params_missing_invoice_create_doc", 400, "jwt and body are required");
+    }
+    const response = await axios.post(`${basePath}/invoices-internal/doc/create`, body, { headers: { jwt } });
+    return response?.data;
+  }
+
+  /** Cancel a document by issuing a reversing credit note. */
+  async cancelDoc(params: { jwt: string; body: { sellerId: string; doctype: string; docnum: number; reason?: string } }) {
+    const { jwt, body } = params;
+    if (!jwt || !body) {
+      throw new CustomError("params_missing_invoice_cancel_doc", 400, "jwt and body are required");
+    }
+    const response = await axios.post(`${basePath}/invoices-internal/doc/cancel`, body, { headers: { jwt } });
+    return response?.data;
+  }
+}