@nimee/api-clients 1.1.98 → 1.1.103

package/dist/src/endUser.d.ts

@@ -45,4 +45,22 @@ export declare class EndUserClient {
         sellerId: string;
         customerId?: string;
     }): Promise<import("axios").AxiosResponse<any, any>>;
+    saveSavedCard(params: {
+        endUserId: string;
+        jwt: string;
+        marketplaceId: string;
+        sellerId: string;
+        buyerKey: string;
+        buyerCardMask?: string;
+        buyerCardExp?: string;
+        buyerName?: string;
+    }): Promise<any>;
+    clearSavedCard(params: {
+        endUserId: string;
+        jwt: string;
+        marketplaceId: string;
+        sellerId: string;
+        buyerCardMask?: string;
+        buyerCardExp?: string;
+    }): Promise<any>;
 }

package/dist/src/endUser.js

@@ -91,6 +91,29 @@ class EndUserClient {
             return axios_1.default.put(`${endUserUrl}/updateExternalPurchaseToken/${marketplaceId}/${sellerId}/${endUserId}`, { token, customerId }, { headers: { jwt } });
         });
     }
+    // Stores the card as the customer's card on file. Writes the display fields AND the token in one update,
+    // so the card shown to the customer can never drift from the one a SAVED_CARD checkout charges — which is
+    // what happens if only the token is written (see updateExternalPurchaseToken).
+    saveSavedCard(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { endUserId, jwt, marketplaceId, sellerId, buyerKey, buyerCardMask, buyerCardExp, buyerName } = params;
+            const response = yield axios_1.default.post(`${endUserUrl}/saved-card/${marketplaceId}/${sellerId}/${endUserId}`, { buyerKey, buyerCardMask, buyerCardExp, buyerName }, { headers: { jwt } });
+            return response === null || response === void 0 ? void 0 : response.data;
+        });
+    }
+    // Clears the card-on-file DISPLAY slot (endUser.savedCard) only — externalPurchaseToken is deliberately
+    // untouched (live season-ticket billing charges that slot). mask/exp narrow the clear to that exact card,
+    // so the user service atomically no-ops when the slot already holds a different (newer) card.
+    clearSavedCard(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { endUserId, jwt, marketplaceId, sellerId, buyerCardMask, buyerCardExp } = params;
+            const response = yield axios_1.default.delete(`${endUserUrl}/saved-card/${marketplaceId}/${sellerId}/${endUserId}`, {
+                headers: { jwt },
+                params: { buyerCardMask, buyerCardExp },
+            });
+            return response === null || response === void 0 ? void 0 : response.data;
+        });
+    }
 }
 exports.EndUserClient = EndUserClient;
 //# sourceMappingURL=endUser.js.map

package/dist/src/endUser.js.map

@@ -1 +1 @@
-{"version":3,"file":"endUser.js","sourceRoot":"","sources":["../../src/endUser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"endUser.js","sourceRoot":"","sources":["../../src/endUser.ts"],"names":[],"mappings":"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"}

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.103",
   "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.41",
     "@typescript-eslint/eslint-plugin": "^5.18.0",
     "@typescript-eslint/eslint-plugin-tslint": "^5.18.0",
     "@typescript-eslint/parser": "^5.18.0",
@@ -38,7 +38,7 @@
   "dependencies": {
     "@nimee/error-handler": "0.0.14",
     "@nimee/logger": "^1.0.27",
-    "@nimee/shared-types": "^1.0.207",
+    "@nimee/shared-types": "^1.0.317",
     "axios": "1.2.1"
   }
 }

package/src/endUser.ts

@@ -89,4 +89,44 @@ export class EndUserClient {
       { headers: { jwt } }
     );
   }
+  // Stores the card as the customer's card on file. Writes the display fields AND the token in one update,
+  // so the card shown to the customer can never drift from the one a SAVED_CARD checkout charges — which is
+  // what happens if only the token is written (see updateExternalPurchaseToken).
+  async saveSavedCard(params: {
+    endUserId: string;
+    jwt: string;
+    marketplaceId: string;
+    sellerId: string;
+    buyerKey: string;
+    buyerCardMask?: string;
+    buyerCardExp?: string;
+    buyerName?: string;
+  }) {
+    const { endUserId, jwt, marketplaceId, sellerId, buyerKey, buyerCardMask, buyerCardExp, buyerName } = params;
+    const response = await axios.post(
+      `${endUserUrl}/saved-card/${marketplaceId}/${sellerId}/${endUserId}`,
+      { buyerKey, buyerCardMask, buyerCardExp, buyerName },
+      { headers: { jwt } }
+    );
+    return response?.data;
+  }
+
+  // Clears the card-on-file DISPLAY slot (endUser.savedCard) only — externalPurchaseToken is deliberately
+  // untouched (live season-ticket billing charges that slot). mask/exp narrow the clear to that exact card,
+  // so the user service atomically no-ops when the slot already holds a different (newer) card.
+  async clearSavedCard(params: {
+    endUserId: string;
+    jwt: string;
+    marketplaceId: string;
+    sellerId: string;
+    buyerCardMask?: string;
+    buyerCardExp?: string;
+  }) {
+    const { endUserId, jwt, marketplaceId, sellerId, buyerCardMask, buyerCardExp } = params;
+    const response = await axios.delete(`${endUserUrl}/saved-card/${marketplaceId}/${sellerId}/${endUserId}`, {
+      headers: { jwt },
+      params: { buyerCardMask, buyerCardExp },
+    });
+    return response?.data;
+  }
 }

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;
+  }
+}