chore(tg-bot): LicenseChain API response normalization helper

Author: VoxHash

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,21 @@
+## Summary
+
+<!-- What changed (commands, client, DB). -->
+
+## Related issue
+
+Closes #____
+
+## API alignment
+
+- [ ] Uses `POST /v1/licenses/verify` with body field `key`.
+- [ ] List/aggregate commands do not expose other users’ licenses.
+
+## Vendored API helper
+
+- [ ] If editing `src/client/licensechainApiNormalize.js`: apply the same change to `LicenseChain-Discord-Bot` and update `api/src/contracts/bot-license-contracts.ts` + tests if shapes change.
+
+## Verification
+
+- [ ] Smoke test: `/validate` and `/list` against staging API.
+- [ ] CI / tests green.

src/client/LicenseChainClient.js

@@ -4,6 +4,7 @@
 
 const axios = require('axios');
 const crypto = require('crypto');
+const { normalizeAxiosError, normalizeVerifyPayload } = require('./licensechainApiNormalize');
 
 class LicenseChainClient {
   constructor(config) {
@@ -66,9 +67,9 @@ class LicenseChainClient {
     try {
       // Use verify endpoint to get license info
       const response = await this.client.post('/v1/licenses/verify', { key: licenseKey });
-      return response.data;
+      return normalizeVerifyPayload(response.data);
     } catch (error) {
-      throw new Error(`Failed to get license: ${error.response?.data?.message || error.message}`);
+      throw normalizeAxiosError(error, 'Failed to get license');
     }
   }
 

src/client/licensechainApiNormalize.js

@@ -0,0 +1,66 @@
+/**
+ * Vendored copy — keep in sync with:
+ * - LicenseChain-Discord-Bot/src/client/licensechainApiNormalize.js (identical)
+ * - api/src/contracts/bot-license-contracts.ts
+ */
+
+function parseAxiosLikeError(err) {
+  const status = err?.response?.status ?? null;
+  const data = err?.response?.data;
+  let message =
+    (typeof data === 'object' && data !== null && typeof data.message === 'string' && data.message) ||
+    (typeof data === 'object' && data !== null && typeof data.error === 'string' && data.error) ||
+    err?.message ||
+    'Request failed';
+  const code =
+    typeof data === 'object' && data !== null && typeof data.code === 'string' ? data.code : undefined;
+  return { httpStatus: status, message: String(message), body: data ?? null, code };
+}
+
+class LicenseChainApiError extends Error {
+  constructor(context, parsed) {
+    super(`${context}: ${parsed.message}`);
+    this.name = 'LicenseChainApiError';
+    this.context = context;
+    this.httpStatus = parsed.httpStatus;
+    this.apiBody = parsed.body;
+    this.apiCode = parsed.code;
+  }
+}
+
+function normalizeAxiosError(err, context) {
+  const parsed = parseAxiosLikeError(err);
+  return new LicenseChainApiError(context, parsed);
+}
+
+function normalizeVerifyPayload(data) {
+  if (!data || typeof data !== 'object') {
+    return { valid: false, reason: 'invalid_api_payload' };
+  }
+  const o = data;
+  return {
+    ...o,
+    valid: Boolean(o.valid),
+    reason: typeof o.reason === 'string' ? o.reason : o.reason != null ? String(o.reason) : undefined,
+    status: typeof o.status === 'string' ? o.status : o.status != null ? String(o.status) : undefined,
+    expiresAt:
+      typeof o.expiresAt === 'string'
+        ? o.expiresAt
+        : o.expiresAt instanceof Date
+          ? o.expiresAt.toISOString()
+          : o.expiresAt === null
+            ? null
+            : o.expiresAt,
+    email: typeof o.email === 'string' ? o.email : o.email,
+    verificationType: typeof o.verificationType === 'string' ? o.verificationType : o.verificationType,
+    error: typeof o.error === 'string' ? o.error : o.error,
+    hardwareId: typeof o.hardwareId === 'string' ? o.hardwareId : o.hardwareId,
+  };
+}
+
+module.exports = {
+  LicenseChainApiError,
+  parseAxiosLikeError,
+  normalizeAxiosError,
+  normalizeVerifyPayload,
+};