@cheqi/sdk 0.1.1

package/dist/utils.js

@@ -0,0 +1,54 @@
+import { createHash } from "node:crypto";
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+export function coalesceString(...values) {
+    for (const value of values) {
+        if (isNonEmptyString(value)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/** Basic email format check: local@domain with at least one dot in domain. */
+export function isValidEmail(value) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+}
+export function sha256Hex(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex");
+}
+export function toCamelCase(value) {
+    return value.replace(/[_-]([a-z])/g, (_, character) => character.toUpperCase());
+}
+export function normalizeValue(value) {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => normalizeValue(entry));
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    const normalized = {};
+    for (const [key, innerValue] of Object.entries(value)) {
+        if (innerValue === undefined || innerValue === null) {
+            continue;
+        }
+        normalized[toCamelCase(key)] = normalizeValue(innerValue);
+    }
+    return normalized;
+}
+export function serializeJson(value) {
+    return JSON.stringify(normalizeValue(value));
+}
+export function parseBase64Der(base64) {
+    return Buffer.from(base64, "base64");
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAG,MAAiB;IACjD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,SAAiB,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,KAAQ;IACxC,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QACD,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/validators.d.ts

@@ -0,0 +1,11 @@
+import type { AddressDTO, CompanyDTO } from "./types.js";
+import type { CreateStoreRequest } from "./models/generated/index.js";
+import { Company } from "./models/domain.js";
+export declare function getAddressValidationErrors(address?: Partial<AddressDTO> | {
+    streetName?: string;
+    cityName?: string;
+    postalZone?: string;
+    countryIsoCode?: string;
+}): string[];
+export declare function getCompanyValidationErrors(company?: Company | CompanyDTO | Record<string, any>): string[];
+export declare function getCreateStoreRequestValidationErrors(request?: CreateStoreRequest | Record<string, any>): string[];

package/dist/validators.js

@@ -0,0 +1,56 @@
+import { Company } from "./models/domain.js";
+import { isNonEmptyString, isValidEmail } from "./utils.js";
+export function getAddressValidationErrors(address) {
+    const errors = [];
+    if (!address) {
+        errors.push("address is required");
+        return errors;
+    }
+    if (!isNonEmptyString(address.streetName)) {
+        errors.push("streetName is required");
+    }
+    if (!isNonEmptyString(address.cityName)) {
+        errors.push("cityName is required");
+    }
+    if (!isNonEmptyString(address.postalZone)) {
+        errors.push("postalZone is required");
+    }
+    const countryIsoCode = address.countryIsoCode;
+    if (!isNonEmptyString(countryIsoCode)) {
+        errors.push("countryIsoCode is required");
+    }
+    else if (countryIsoCode.trim().length !== 2) {
+        errors.push("countryIsoCode must be a 2-letter ISO code");
+    }
+    return errors;
+}
+export function getCompanyValidationErrors(company) {
+    const errors = [];
+    if (!isNonEmptyString(company?.companyName)) {
+        errors.push("companyName is required");
+    }
+    const companyEmail = company?.companyEmail;
+    if (!isNonEmptyString(companyEmail)) {
+        errors.push("companyEmail is required");
+    }
+    else if (!isValidEmail(companyEmail)) {
+        errors.push("companyEmail must be a valid email address");
+    }
+    const address = company instanceof Company ? company.address : company?.addressDto;
+    for (const error of getAddressValidationErrors(address)) {
+        errors.push(`address.${error}`);
+    }
+    return errors;
+}
+export function getCreateStoreRequestValidationErrors(request) {
+    const errors = [];
+    if (!isNonEmptyString(request?.storeName)) {
+        errors.push("storeName is required");
+    }
+    const address = request?.addressDto ?? request?.address;
+    for (const error of getAddressValidationErrors(address)) {
+        errors.push(`address.${error}`);
+    }
+    return errors;
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,UAAU,0BAA0B,CAAC,OAAwH;IACjK,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC9C,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAoD;IAC7F,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,YAAY,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAE,OAAe,EAAE,UAAU,CAAC;IAC5F,KAAK,MAAM,KAAK,IAAI,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,OAAkD;IACtG,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAI,OAAe,EAAE,UAAU,IAAK,OAAe,EAAE,OAAO,CAAC;IAC1E,KAAK,MAAM,KAAK,IAAI,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/xml.d.ts

@@ -0,0 +1,2 @@
+export declare function canonicalizeXml(xml: string): string;
+export declare function canonicalizeAndHashXml(xml: string): string;

package/dist/xml.js

@@ -0,0 +1,11 @@
+import { sha256Hex } from "./utils.js";
+function stripFormattingWhitespace(xml) {
+    return xml.replace(/>\s+</g, "><").trim();
+}
+export function canonicalizeXml(xml) {
+    return stripFormattingWhitespace(xml);
+}
+export function canonicalizeAndHashXml(xml) {
+    return sha256Hex(canonicalizeXml(xml));
+}
+//# sourceMappingURL=xml.js.map

package/dist/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,SAAS,yBAAyB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,yBAAyB,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@cheqi/sdk",
+  "version": "0.1.1",
+  "description": "Cheqi TypeScript SDK for encrypted receipt and credit note processing",
+  "license": "MIT",
+  "author": "Cheqi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cheqi/cheqi-sdk.git",
+    "directory": "cheqi-sdk-javascript"
+  },
+  "bugs": {
+    "url": "https://github.com/cheqi/cheqi-sdk/issues"
+  },
+  "homepage": "https://cheqi.io",
+  "keywords": [
+    "cheqi",
+    "receipt",
+    "digital-receipt",
+    "credit-note",
+    "encryption",
+    "sdk"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./entity": {
+      "types": "./dist/entity/index.d.ts",
+      "default": "./dist/entity/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prebuild": "node ./scripts/clean-dist.mjs",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "npm run build && node --test test/sdk.test.js",
+    "typecheck": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3"
+  }
+}