@fast-white-cat/integration-ksef-direct 0.1.0

package/dist/modules/integration_ksef_direct/workers/check-ksef-document-status.js

@@ -0,0 +1,103 @@
+import { createModuleQueue } from "@open-mercato/queue";
+const metadata = {
+  queue: "ksef_direct_check",
+  id: "ksef-direct-check",
+  concurrency: 5
+};
+async function handler(job, ctx) {
+  const payload = job.payload;
+  const em = ctx.resolve("em")?.fork();
+  if (!em) return;
+  const { KsefDirectDocument } = await import("../data/entities.js");
+  const doc = await em.findOne(KsefDirectDocument, {
+    id: payload.documentId,
+    organizationId: payload.organizationId,
+    tenantId: payload.tenantId
+  });
+  if (!doc || doc.status !== "sending") {
+    return;
+  }
+  if (!doc.ksefProcessingReferenceNumber) {
+    doc.status = "failed";
+    doc.errorMessage = "Missing KSeF processing reference number";
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    return;
+  }
+  const credentialsService = ctx.resolve("integrationCredentialsService");
+  const rawCreds = credentialsService ? await credentialsService.resolve("integration_ksef_direct", {
+    tenantId: payload.tenantId,
+    organizationId: payload.organizationId
+  }) : null;
+  const { KsefDirectCredentialsSchema } = await import("../data/validators.js");
+  const credsParsed = KsefDirectCredentialsSchema.safeParse(rawCreds);
+  if (!credsParsed.success) {
+    doc.status = "failed";
+    doc.errorMessage = "KSeF Direct credentials not configured";
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    return;
+  }
+  const credentials = {
+    ksefToken: credsParsed.data.ksef_token,
+    nip: credsParsed.data.nip,
+    environment: credsParsed.data.environment,
+    tenantId: payload.tenantId
+  };
+  const { checkInvoiceStatus } = await import("../lib/ksefClient.js");
+  const { emitKsefDirectEvent } = await import("../events.js");
+  let result;
+  try {
+    result = await checkInvoiceStatus(credentials, doc.ksefProcessingReferenceNumber);
+  } catch (err) {
+    throw err;
+  }
+  if (result.processingCode === 200) {
+    doc.status = "sent";
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    await emitKsefDirectEvent("ksef_direct.document.sent", {
+      documentId: doc.id,
+      ksefReferenceNumber: doc.ksefReferenceNumber ?? void 0,
+      organizationId: payload.organizationId,
+      tenantId: payload.tenantId
+    });
+  } else if (result.processingCode === 100) {
+    if (payload.attempt >= 10) {
+      doc.status = "failed";
+      doc.errorMessage = "Timeout: KSeF did not confirm the document within 10 minutes";
+      doc.updatedAt = /* @__PURE__ */ new Date();
+      await em.flush();
+      await emitKsefDirectEvent("ksef_direct.document.failed", {
+        documentId: doc.id,
+        errorMessage: doc.errorMessage,
+        organizationId: payload.organizationId,
+        tenantId: payload.tenantId
+      });
+    } else {
+      const checkQueue = createModuleQueue("ksef_direct_check");
+      await checkQueue.enqueue(
+        { ...payload, attempt: payload.attempt + 1 },
+        { delayMs: 6e4 }
+      );
+    }
+  } else {
+    const errorMessage = result.errorDescription ?? `KSeF processing error: code ${result.processingCode}`;
+    doc.status = "failed";
+    doc.errorMessage = errorMessage;
+    doc.ksefReferenceNumber = null;
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    await emitKsefDirectEvent("ksef_direct.document.failed", {
+      documentId: doc.id,
+      errorMessage,
+      organizationId: payload.organizationId,
+      tenantId: payload.tenantId
+    });
+  }
+}
+export {
+  handler as default,
+  metadata
+};
+//# sourceMappingURL=check-ksef-document-status.js.map

package/dist/modules/integration_ksef_direct/workers/check-ksef-document-status.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/integration_ksef_direct/workers/check-ksef-document-status.ts"],
+  "sourcesContent": ["import type { QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport { createModuleQueue } from '@open-mercato/queue'\n\nexport const metadata: WorkerMeta = {\n  queue: 'ksef_direct_check',\n  id: 'ksef-direct-check',\n  concurrency: 5,\n}\n\ntype HandlerContext = { resolve: <T = unknown>(name: string) => T }\n\ntype CheckJobPayload = {\n  documentId: string\n  organizationId: string\n  tenantId: string\n  attempt: number\n}\n\nexport default async function handler(\n  job: QueuedJob<CheckJobPayload>,\n  ctx: HandlerContext,\n): Promise<void> {\n  const payload = job.payload\n  const em = (ctx.resolve('em') as { fork: () => unknown })?.fork() as any\n  if (!em) return\n\n  const { KsefDirectDocument } = await import('../data/entities')\n  const doc = await em.findOne(KsefDirectDocument, {\n    id: payload.documentId,\n    organizationId: payload.organizationId,\n    tenantId: payload.tenantId,\n  })\n\n  if (!doc || doc.status !== 'sending') {\n    return\n  }\n\n  if (!doc.ksefProcessingReferenceNumber) {\n    doc.status = 'failed'\n    doc.errorMessage = 'Missing KSeF processing reference number'\n    doc.updatedAt = new Date()\n    await em.flush()\n    return\n  }\n\n  const credentialsService = ctx.resolve('integrationCredentialsService') as any\n  const rawCreds = credentialsService\n    ? await credentialsService.resolve('integration_ksef_direct', {\n        tenantId: payload.tenantId,\n        organizationId: payload.organizationId,\n      })\n    : null\n\n  const { KsefDirectCredentialsSchema } = await import('../data/validators')\n  const credsParsed = KsefDirectCredentialsSchema.safeParse(rawCreds)\n  if (!credsParsed.success) {\n    doc.status = 'failed'\n    doc.errorMessage = 'KSeF Direct credentials not configured'\n    doc.updatedAt = new Date()\n    await em.flush()\n    return\n  }\n\n  const credentials = {\n    ksefToken: credsParsed.data.ksef_token,\n    nip: credsParsed.data.nip,\n    environment: credsParsed.data.environment,\n    tenantId: payload.tenantId,\n  }\n\n  const { checkInvoiceStatus } = await import('../lib/ksefClient')\n  const { emitKsefDirectEvent } = await import('../events')\n\n  let result: { processingCode: number; ksefReferenceNumber?: string; errorDescription?: string }\n  try {\n    result = await checkInvoiceStatus(credentials, doc.ksefProcessingReferenceNumber)\n  } catch (err) {\n    // Re-throw transient errors so BullMQ retries; do not permanently fail the document\n    throw err\n  }\n\n  if (result.processingCode === 200) {\n    doc.status = 'sent'\n    doc.updatedAt = new Date()\n    await em.flush()\n\n    await emitKsefDirectEvent('ksef_direct.document.sent', {\n      documentId: doc.id,\n      ksefReferenceNumber: doc.ksefReferenceNumber ?? undefined,\n      organizationId: payload.organizationId,\n      tenantId: payload.tenantId,\n    })\n  } else if (result.processingCode === 100) {\n    if (payload.attempt >= 10) {\n      doc.status = 'failed'\n      doc.errorMessage = 'Timeout: KSeF did not confirm the document within 10 minutes'\n      doc.updatedAt = new Date()\n      await em.flush()\n\n      await emitKsefDirectEvent('ksef_direct.document.failed', {\n        documentId: doc.id,\n        errorMessage: doc.errorMessage,\n        organizationId: payload.organizationId,\n        tenantId: payload.tenantId,\n      })\n    } else {\n      const checkQueue = createModuleQueue<CheckJobPayload>('ksef_direct_check')\n      await checkQueue.enqueue(\n        { ...payload, attempt: payload.attempt + 1 },\n        { delayMs: 60_000 },\n      )\n    }\n  } else {\n    const errorMessage = result.errorDescription\n      ?? `KSeF processing error: code ${result.processingCode}`\n    doc.status = 'failed'\n    doc.errorMessage = errorMessage\n    doc.ksefReferenceNumber = null\n    doc.updatedAt = new Date()\n    await em.flush()\n\n    await emitKsefDirectEvent('ksef_direct.document.failed', {\n      documentId: doc.id,\n      errorMessage,\n      organizationId: payload.organizationId,\n      tenantId: payload.tenantId,\n    })\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/integration_ksef_direct/workers/send-ksef-document.js

@@ -0,0 +1,104 @@
+import { createModuleQueue } from "@open-mercato/queue";
+const metadata = {
+  queue: "ksef_direct_send",
+  id: "ksef-direct-send",
+  concurrency: 5
+};
+async function handler(job, ctx) {
+  const payload = job.payload;
+  const em = ctx.resolve("em")?.fork();
+  if (!em) return;
+  const { KsefDirectDocument } = await import("../data/entities.js");
+  const doc = await em.findOne(KsefDirectDocument, {
+    id: payload.documentId,
+    organizationId: payload.organizationId,
+    tenantId: payload.tenantId
+  });
+  if (!doc || doc.status !== "queued") {
+    return;
+  }
+  if (!doc.sellerName?.trim()) {
+    doc.status = "failed";
+    doc.errorMessage = "Seller name is required to send the document to KSeF";
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    const { emitKsefDirectEvent } = await import("../events.js");
+    await emitKsefDirectEvent("ksef_direct.document.failed", {
+      documentId: doc.id,
+      errorMessage: doc.errorMessage,
+      organizationId: payload.organizationId,
+      tenantId: payload.tenantId
+    });
+    return;
+  }
+  const credentialsService = ctx.resolve("integrationCredentialsService");
+  const rawCreds = credentialsService ? await credentialsService.resolve("integration_ksef_direct", {
+    tenantId: payload.tenantId,
+    organizationId: payload.organizationId
+  }) : null;
+  const { KsefDirectCredentialsSchema } = await import("../data/validators.js");
+  const credsParsed = KsefDirectCredentialsSchema.safeParse(rawCreds);
+  if (!credsParsed.success) {
+    doc.status = "failed";
+    doc.errorMessage = "KSeF Direct credentials not configured";
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    const { emitKsefDirectEvent } = await import("../events.js");
+    await emitKsefDirectEvent("ksef_direct.document.failed", {
+      documentId: doc.id,
+      errorMessage: doc.errorMessage,
+      organizationId: payload.organizationId,
+      tenantId: payload.tenantId
+    });
+    return;
+  }
+  const creds = credsParsed.data;
+  const credentials = {
+    ksefToken: creds.ksef_token,
+    nip: creds.nip,
+    environment: creds.environment,
+    tenantId: payload.tenantId
+  };
+  try {
+    const { fetchInvoicePublicKey, prepareInvoicePayload } = await import("../lib/ksefCrypto.js");
+    const { generateFa2Xml } = await import("../lib/ksefFa2Xml.js");
+    const { sendInvoice } = await import("../lib/ksefClient.js");
+    const xml = generateFa2Xml(doc, {
+      sellerName: doc.sellerName,
+      sellerAddressL1: doc.sellerAddressL1 ?? void 0,
+      sellerCity: doc.sellerCity ?? void 0,
+      sellerCountry: doc.sellerCountry ?? void 0
+    });
+    const { publicKeyPem, publicKeyId } = await fetchInvoicePublicKey(credentials.environment);
+    const invoicePayload = prepareInvoicePayload(xml, publicKeyPem);
+    const { sessionReferenceNumber, invoiceReferenceNumber } = await sendInvoice(credentials, { ...invoicePayload, publicKeyId });
+    doc.status = "sending";
+    doc.ksefProcessingReferenceNumber = sessionReferenceNumber;
+    doc.ksefReferenceNumber = invoiceReferenceNumber;
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    const checkQueue = createModuleQueue("ksef_direct_check");
+    await checkQueue.enqueue(
+      { documentId: doc.id, organizationId: payload.organizationId, tenantId: payload.tenantId, attempt: 1 },
+      { delayMs: 3e4 }
+    );
+  } catch (err) {
+    const errorMessage = err instanceof Error ? err.message : "Unknown error during KSeF document send";
+    doc.status = "failed";
+    doc.errorMessage = errorMessage;
+    doc.updatedAt = /* @__PURE__ */ new Date();
+    await em.flush();
+    const { emitKsefDirectEvent } = await import("../events.js");
+    await emitKsefDirectEvent("ksef_direct.document.failed", {
+      documentId: doc.id,
+      errorMessage,
+      organizationId: payload.organizationId,
+      tenantId: payload.tenantId
+    });
+  }
+}
+export {
+  handler as default,
+  metadata
+};
+//# sourceMappingURL=send-ksef-document.js.map

package/dist/modules/integration_ksef_direct/workers/send-ksef-document.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/integration_ksef_direct/workers/send-ksef-document.ts"],
+  "sourcesContent": ["import type { QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport { createModuleQueue } from '@open-mercato/queue'\n\nexport const metadata: WorkerMeta = {\n  queue: 'ksef_direct_send',\n  id: 'ksef-direct-send',\n  concurrency: 5,\n}\n\ntype HandlerContext = { resolve: <T = unknown>(name: string) => T }\n\ntype SendJobPayload = {\n  documentId: string\n  organizationId: string\n  tenantId: string\n}\n\ntype CheckJobPayload = {\n  documentId: string\n  organizationId: string\n  tenantId: string\n  attempt: number\n}\n\nexport default async function handler(\n  job: QueuedJob<SendJobPayload>,\n  ctx: HandlerContext,\n): Promise<void> {\n  const payload = job.payload\n  const em = (ctx.resolve('em') as { fork: () => unknown })?.fork() as any\n  if (!em) return\n\n  const { KsefDirectDocument } = await import('../data/entities')\n  const doc = await em.findOne(KsefDirectDocument, {\n    id: payload.documentId,\n    organizationId: payload.organizationId,\n    tenantId: payload.tenantId,\n  })\n\n  if (!doc || doc.status !== 'queued') {\n    return\n  }\n\n  if (!doc.sellerName?.trim()) {\n    doc.status = 'failed'\n    doc.errorMessage = 'Seller name is required to send the document to KSeF'\n    doc.updatedAt = new Date()\n    await em.flush()\n\n    const { emitKsefDirectEvent } = await import('../events')\n    await emitKsefDirectEvent('ksef_direct.document.failed', {\n      documentId: doc.id,\n      errorMessage: doc.errorMessage,\n      organizationId: payload.organizationId,\n      tenantId: payload.tenantId,\n    })\n    return\n  }\n\n  const credentialsService = ctx.resolve('integrationCredentialsService') as any\n  const rawCreds = credentialsService\n    ? await credentialsService.resolve('integration_ksef_direct', {\n        tenantId: payload.tenantId,\n        organizationId: payload.organizationId,\n      })\n    : null\n\n  const { KsefDirectCredentialsSchema } = await import('../data/validators')\n  const credsParsed = KsefDirectCredentialsSchema.safeParse(rawCreds)\n\n  if (!credsParsed.success) {\n    doc.status = 'failed'\n    doc.errorMessage = 'KSeF Direct credentials not configured'\n    doc.updatedAt = new Date()\n    await em.flush()\n\n    const { emitKsefDirectEvent } = await import('../events')\n    await emitKsefDirectEvent('ksef_direct.document.failed', {\n      documentId: doc.id,\n      errorMessage: doc.errorMessage,\n      organizationId: payload.organizationId,\n      tenantId: payload.tenantId,\n    })\n    return\n  }\n\n  const creds = credsParsed.data\n  const credentials = {\n    ksefToken: creds.ksef_token,\n    nip: creds.nip,\n    environment: creds.environment,\n    tenantId: payload.tenantId,\n  }\n\n  try {\n    const { fetchInvoicePublicKey, prepareInvoicePayload } = await import('../lib/ksefCrypto')\n    const { generateFa2Xml } = await import('../lib/ksefFa2Xml')\n    const { sendInvoice } = await import('../lib/ksefClient')\n\n    const xml = generateFa2Xml(doc, {\n      sellerName: doc.sellerName,\n      sellerAddressL1: doc.sellerAddressL1 ?? undefined,\n      sellerCity: doc.sellerCity ?? undefined,\n      sellerCountry: doc.sellerCountry ?? undefined,\n    })\n\n    const { publicKeyPem, publicKeyId } = await fetchInvoicePublicKey(credentials.environment)\n    const invoicePayload = prepareInvoicePayload(xml, publicKeyPem)\n    const { sessionReferenceNumber, invoiceReferenceNumber } = await sendInvoice(credentials, { ...invoicePayload, publicKeyId })\n\n    doc.status = 'sending'\n    doc.ksefProcessingReferenceNumber = sessionReferenceNumber\n    doc.ksefReferenceNumber = invoiceReferenceNumber\n    doc.updatedAt = new Date()\n    await em.flush()\n\n    const checkQueue = createModuleQueue<CheckJobPayload>('ksef_direct_check')\n    await checkQueue.enqueue(\n      { documentId: doc.id, organizationId: payload.organizationId, tenantId: payload.tenantId, attempt: 1 },\n      { delayMs: 30_000 },\n    )\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : 'Unknown error during KSeF document send'\n    doc.status = 'failed'\n    doc.errorMessage = errorMessage\n    doc.updatedAt = new Date()\n    await em.flush()\n\n    const { emitKsefDirectEvent } = await import('../events')\n    await emitKsefDirectEvent('ksef_direct.document.failed', {\n      documentId: doc.id,\n      errorMessage,\n      organizationId: payload.organizationId,\n      tenantId: payload.tenantId,\n    })\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/integration_ksef_direct/workers/sync-received-documents.js

@@ -0,0 +1,137 @@
+const metadata = {
+  queue: "ksef_direct_receive",
+  id: "ksef-direct-receive",
+  concurrency: 3
+};
+async function handler(job, ctx) {
+  const payload = job.payload;
+  const em = ctx.resolve("em")?.fork();
+  if (!em) return;
+  const credentialsService = ctx.resolve("integrationCredentialsService");
+  const rawCreds = credentialsService ? await credentialsService.resolve("integration_ksef_direct", {
+    tenantId: payload.tenantId,
+    organizationId: payload.organizationId
+  }) : null;
+  const { KsefDirectCredentialsSchema } = await import("../data/validators.js");
+  const credsParsed = KsefDirectCredentialsSchema.safeParse(rawCreds);
+  if (!credsParsed.success) return;
+  const credentials = {
+    ksefToken: credsParsed.data.ksef_token,
+    nip: credsParsed.data.nip,
+    environment: credsParsed.data.environment,
+    tenantId: payload.tenantId
+  };
+  const { queryReceivedInvoices, downloadInvoiceFromUrl } = await import("../lib/ksefClient.js");
+  const { KsefDirectReceivedDocument } = await import("../data/entities.js");
+  const { parseReceivedInvoiceXml } = await import("../lib/ksefXmlParser.js");
+  const { emitKsefDirectEvent } = await import("../events.js");
+  const result = await queryReceivedInvoices(credentials, {
+    dateFrom: payload.dateFrom,
+    dateTo: payload.dateTo
+  });
+  const collectedRefs = [];
+  for (const summary of result.items) {
+    collectedRefs.push(summary.ksefReferenceNumber);
+    const existing = await em.findOne(KsefDirectReceivedDocument, {
+      organizationId: payload.organizationId,
+      ksefReferenceNumber: summary.ksefReferenceNumber
+    });
+    if (!existing) {
+      const record = em.create(KsefDirectReceivedDocument, {
+        organizationId: payload.organizationId,
+        tenantId: payload.tenantId,
+        ksefReferenceNumber: summary.ksefReferenceNumber,
+        sellerNip: summary.sellerNip,
+        sellerName: summary.sellerName,
+        issueDate: summary.issueDate,
+        grossAmount: summary.grossAmount,
+        netAmount: summary.netAmount,
+        vatAmount: summary.vatAmount,
+        currency: summary.currency,
+        invoiceNumber: summary.invoiceNumber,
+        upoDownloadUrl: summary.upoDownloadUrl,
+        invoiceDownloadUrl: summary.invoiceDownloadUrl,
+        status: "pending_download"
+      });
+      em.persist(record);
+    } else {
+      if (summary.upoDownloadUrl) existing.upoDownloadUrl = summary.upoDownloadUrl;
+      if (summary.invoiceDownloadUrl) existing.invoiceDownloadUrl = summary.invoiceDownloadUrl;
+      if (existing.status === "failed") {
+        existing.status = "pending_download";
+        existing.errorMessage = null;
+        existing.updatedAt = /* @__PURE__ */ new Date();
+      }
+    }
+  }
+  await em.flush();
+  if (collectedRefs.length === 0) {
+    await emitKsefDirectEvent("ksef_direct.received_document.synced", {
+      organizationId: payload.organizationId,
+      tenantId: payload.tenantId,
+      syncedCount: 0,
+      failedCount: 0,
+      dateFrom: payload.dateFrom,
+      dateTo: payload.dateTo
+    });
+    return;
+  }
+  const pendingRecords = await em.find(KsefDirectReceivedDocument, {
+    organizationId: payload.organizationId,
+    tenantId: payload.tenantId,
+    status: "pending_download",
+    ksefReferenceNumber: { $in: collectedRefs }
+  });
+  let syncedCount = 0;
+  let failedCount = 0;
+  for (const record of pendingRecords) {
+    try {
+      const downloadUrl = record.invoiceDownloadUrl ?? record.upoDownloadUrl;
+      if (!downloadUrl) {
+        throw new Error("No download URL available for this invoice");
+      }
+      const rawXml = await downloadInvoiceFromUrl(downloadUrl);
+      const parsed = parseReceivedInvoiceXml(rawXml);
+      record.rawXml = rawXml;
+      if (parsed.invoiceNumber) record.invoiceNumber = parsed.invoiceNumber;
+      if (parsed.sellerNip) record.sellerNip = parsed.sellerNip;
+      if (parsed.sellerName) record.sellerName = parsed.sellerName;
+      if (parsed.issueDate) record.issueDate = parsed.issueDate;
+      if (parsed.currency) record.currency = parsed.currency;
+      if (parsed.netAmount) record.netAmount = parsed.netAmount;
+      if (parsed.vatAmount) record.vatAmount = parsed.vatAmount;
+      if (parsed.grossAmount) record.grossAmount = parsed.grossAmount;
+      record.status = "downloaded";
+      record.syncedAt = /* @__PURE__ */ new Date();
+      record.updatedAt = /* @__PURE__ */ new Date();
+      await em.flush();
+      syncedCount++;
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : "Unknown error during XML download";
+      record.status = "failed";
+      record.errorMessage = errorMessage;
+      record.updatedAt = /* @__PURE__ */ new Date();
+      await em.flush();
+      failedCount++;
+      await emitKsefDirectEvent("ksef_direct.received_document.failed", {
+        organizationId: payload.organizationId,
+        tenantId: payload.tenantId,
+        ksefReferenceNumber: record.ksefReferenceNumber,
+        errorMessage
+      });
+    }
+  }
+  await emitKsefDirectEvent("ksef_direct.received_document.synced", {
+    organizationId: payload.organizationId,
+    tenantId: payload.tenantId,
+    syncedCount,
+    failedCount,
+    dateFrom: payload.dateFrom,
+    dateTo: payload.dateTo
+  });
+}
+export {
+  handler as default,
+  metadata
+};
+//# sourceMappingURL=sync-received-documents.js.map

package/dist/modules/integration_ksef_direct/workers/sync-received-documents.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/integration_ksef_direct/workers/sync-received-documents.ts"],
+  "sourcesContent": ["import type { QueuedJob, WorkerMeta } from '@open-mercato/queue'\n\nexport const metadata: WorkerMeta = {\n  queue: 'ksef_direct_receive',\n  id: 'ksef-direct-receive',\n  concurrency: 3,\n}\n\ntype HandlerContext = { resolve: <T = unknown>(name: string) => T }\n\nexport type SyncReceivedDocumentsPayload = {\n  organizationId: string\n  tenantId: string\n  dateFrom: string\n  dateTo: string\n}\n\nexport default async function handler(\n  job: QueuedJob<SyncReceivedDocumentsPayload>,\n  ctx: HandlerContext,\n): Promise<void> {\n  const payload = job.payload\n\n  const em = (ctx.resolve('em') as { fork: () => unknown })?.fork() as any\n  if (!em) return\n\n  const credentialsService = ctx.resolve('integrationCredentialsService') as any\n  const rawCreds = credentialsService\n    ? await credentialsService.resolve('integration_ksef_direct', {\n        tenantId: payload.tenantId,\n        organizationId: payload.organizationId,\n      })\n    : null\n  const { KsefDirectCredentialsSchema } = await import('../data/validators')\n  const credsParsed = KsefDirectCredentialsSchema.safeParse(rawCreds)\n  if (!credsParsed.success) return\n\n  const credentials = {\n    ksefToken: credsParsed.data.ksef_token,\n    nip: credsParsed.data.nip,\n    environment: credsParsed.data.environment,\n    tenantId: payload.tenantId,\n  }\n\n  const { queryReceivedInvoices, downloadInvoiceFromUrl } = await import('../lib/ksefClient')\n  const { KsefDirectReceivedDocument } = await import('../data/entities')\n  const { parseReceivedInvoiceXml } = await import('../lib/ksefXmlParser')\n  const { emitKsefDirectEvent } = await import('../events')\n\n  // Phase 1: enumerate all received invoices for the date range and upsert summaries\n  const result = await queryReceivedInvoices(credentials, {\n    dateFrom: payload.dateFrom,\n    dateTo: payload.dateTo,\n  })\n\n  const collectedRefs: string[] = []\n\n  for (const summary of result.items) {\n    collectedRefs.push(summary.ksefReferenceNumber)\n\n    const existing = await em.findOne(KsefDirectReceivedDocument, {\n      organizationId: payload.organizationId,\n      ksefReferenceNumber: summary.ksefReferenceNumber,\n    })\n\n    if (!existing) {\n      const record = em.create(KsefDirectReceivedDocument, {\n        organizationId: payload.organizationId,\n        tenantId: payload.tenantId,\n        ksefReferenceNumber: summary.ksefReferenceNumber,\n        sellerNip: summary.sellerNip,\n        sellerName: summary.sellerName,\n        issueDate: summary.issueDate,\n        grossAmount: summary.grossAmount,\n        netAmount: summary.netAmount,\n        vatAmount: summary.vatAmount,\n        currency: summary.currency,\n        invoiceNumber: summary.invoiceNumber,\n        upoDownloadUrl: summary.upoDownloadUrl,\n        invoiceDownloadUrl: summary.invoiceDownloadUrl,\n        status: 'pending_download',\n      })\n      em.persist(record)\n    } else {\n      // Keep URL fields fresh in case they changed (pre-signed URLs rotate)\n      if (summary.upoDownloadUrl) existing.upoDownloadUrl = summary.upoDownloadUrl\n      if (summary.invoiceDownloadUrl) existing.invoiceDownloadUrl = summary.invoiceDownloadUrl\n      if (existing.status === 'failed') {\n        existing.status = 'pending_download'\n        existing.errorMessage = null\n        existing.updatedAt = new Date()\n      }\n    }\n  }\n\n  await em.flush()\n\n  if (collectedRefs.length === 0) {\n    await emitKsefDirectEvent('ksef_direct.received_document.synced', {\n      organizationId: payload.organizationId,\n      tenantId: payload.tenantId,\n      syncedCount: 0,\n      failedCount: 0,\n      dateFrom: payload.dateFrom,\n      dateTo: payload.dateTo,\n    })\n    return\n  }\n\n  // Phase 2: download XML content for all pending records using stored URLs\n  const pendingRecords = await em.find(KsefDirectReceivedDocument, {\n    organizationId: payload.organizationId,\n    tenantId: payload.tenantId,\n    status: 'pending_download',\n    ksefReferenceNumber: { $in: collectedRefs },\n  })\n\n  let syncedCount = 0\n  let failedCount = 0\n\n  for (const record of pendingRecords) {\n    try {\n      const downloadUrl = record.invoiceDownloadUrl ?? record.upoDownloadUrl\n      if (!downloadUrl) {\n        throw new Error('No download URL available for this invoice')\n      }\n\n      const rawXml = await downloadInvoiceFromUrl(downloadUrl)\n      const parsed = parseReceivedInvoiceXml(rawXml)\n\n      record.rawXml = rawXml\n      // Only override metadata fields with parsed values when non-null (prefer KSeF API metadata)\n      if (parsed.invoiceNumber) record.invoiceNumber = parsed.invoiceNumber\n      if (parsed.sellerNip) record.sellerNip = parsed.sellerNip\n      if (parsed.sellerName) record.sellerName = parsed.sellerName\n      if (parsed.issueDate) record.issueDate = parsed.issueDate\n      if (parsed.currency) record.currency = parsed.currency\n      if (parsed.netAmount) record.netAmount = parsed.netAmount\n      if (parsed.vatAmount) record.vatAmount = parsed.vatAmount\n      if (parsed.grossAmount) record.grossAmount = parsed.grossAmount\n      record.status = 'downloaded'\n      record.syncedAt = new Date()\n      record.updatedAt = new Date()\n      await em.flush()\n      syncedCount++\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : 'Unknown error during XML download'\n      record.status = 'failed'\n      record.errorMessage = errorMessage\n      record.updatedAt = new Date()\n      await em.flush()\n      failedCount++\n\n      await emitKsefDirectEvent('ksef_direct.received_document.failed', {\n        organizationId: payload.organizationId,\n        tenantId: payload.tenantId,\n        ksefReferenceNumber: record.ksefReferenceNumber,\n        errorMessage,\n      })\n    }\n  }\n\n  await emitKsefDirectEvent('ksef_direct.received_document.synced', {\n    organizationId: payload.organizationId,\n    tenantId: payload.tenantId,\n    syncedCount,\n    failedCount,\n    dateFrom: payload.dateFrom,\n    dateTo: payload.dateTo,\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/types/declarations.d.js

@@ -0,0 +1 @@
+//# sourceMappingURL=declarations.d.js.map

package/dist/types/declarations.d.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@fast-white-cat/integration-ksef-direct",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "node build.mjs",
+    "watch": "node watch.mjs",
+    "test": "jest --config jest.config.cjs",
+    "typecheck": "node scripts/typecheck.mjs"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*.ts": {
+      "types": "./src/*.ts",
+      "default": "./dist/*.js"
+    },
+    "./*.tsx": {
+      "types": "./src/*.tsx",
+      "default": "./dist/*.js"
+    },
+    "./*.json": "./src/*.json",
+    "./*": {
+      "types": [
+        "./src/*.ts",
+        "./src/*.tsx"
+      ],
+      "default": "./dist/*.js"
+    },
+    "./*/*.json": "./src/*/*.json",
+    "./*/*": {
+      "types": [
+        "./src/*/*.ts",
+        "./src/*/*.tsx"
+      ],
+      "default": "./dist/*/*.js"
+    },
+    "./*/*/*.json": "./src/*/*/*.json",
+    "./*/*/*": {
+      "types": [
+        "./src/*/*/*.ts",
+        "./src/*/*/*.tsx"
+      ],
+      "default": "./dist/*/*/*. js"
+    },
+    "./*/*/*/*.json": "./src/*/*/*/*.json",
+    "./*/*/*/*": {
+      "types": [
+        "./src/*/*/*/*.ts",
+        "./src/*/*/*/*.tsx"
+      ],
+      "default": "./dist/*/*/*.js"
+    }
+  },
+  "peerDependencies": {
+    "@mikro-orm/migrations": "^6.5.9",
+    "@open-mercato/queue": ">=0.6.2 <0.7.0",
+    "@open-mercato/shared": ">=0.6.2 <0.7.0",
+    "@open-mercato/ui": ">=0.6.2 <0.7.0",
+    "@tanstack/react-table": "^8.0.0",
+    "awilix": "^10.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@mikro-orm/decorators": "^7.1.1",
+    "@mikro-orm/migrations": "^7.1.1",
+    "@open-mercato/queue": "0.6.2",
+    "@open-mercato/shared": "0.6.2",
+    "@open-mercato/ui": "0.6.2",
+    "@tanstack/react-table": "^8.21.3",
+    "@types/jest": "^30.0.0",
+    "awilix": "^13.0.3",
+    "esbuild": "^0.25.0",
+    "glob": "^13.0.6",
+    "jest": "^30.2.0",
+    "lucide-react": "^1.16.0",
+    "next": "^16.2.6",
+    "react": "19.2.1",
+    "react-dom": "19.2.1",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3",
+    "zod": "^3.25.76"
+  },
+  "open-mercato": {
+    "displayName": "KSeF Direct Integration",
+    "ejectable": true,
+    "testedCoreRange": ">=0.6.2 <0.7.0",
+    "upgradeNotesUrl": "https://github.com/FastWhiteCat/openmercato-module-ksef/releases"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './modules/integration_ksef_direct/index'

package/src/modules/integration_ksef_direct/__tests__/invoiceNumberFormat.test.ts

@@ -0,0 +1,42 @@
+import { generateKsefInvoiceNumber } from '../lib/invoiceNumberFormat'
+
+describe('generateKsefInvoiceNumber', () => {
+  it('returns a string in the format FV/{yyyy}/{mm}/{8 chars}', () => {
+    const result = generateKsefInvoiceNumber()
+    expect(typeof result).toBe('string')
+    expect(result).toMatch(/^FV\/\d{4}\/\d{2}\/[0-9A-Z]{8}$/)
+  })
+
+  it('uses the current year in the generated number', () => {
+    const result = generateKsefInvoiceNumber()
+    const year = new Date().getFullYear().toString()
+    expect(result.startsWith(`FV/${year}/`)).toBe(true)
+  })
+
+  it('uses the current month (zero-padded) in the generated number', () => {
+    const result = generateKsefInvoiceNumber()
+    const month = String(new Date().getMonth() + 1).padStart(2, '0')
+    const parts = result.split('/')
+    expect(parts[2]).toBe(month)
+  })
+
+  it('generates an 8-character alphanumeric suffix using only uppercase letters and digits', () => {
+    const result = generateKsefInvoiceNumber()
+    const suffix = result.split('/')[3]!
+    expect(suffix).toHaveLength(8)
+    expect(suffix).toMatch(/^[0-9A-Z]+$/)
+  })
+
+  it('generates unique values on successive calls', () => {
+    const results = new Set(Array.from({ length: 20 }, () => generateKsefInvoiceNumber()))
+    // With 36^8 ≈ 2.8 trillion combinations, collision in 20 draws is astronomically unlikely
+    expect(results.size).toBe(20)
+  })
+
+  it('always produces exactly 4 parts when split by "/"', () => {
+    const result = generateKsefInvoiceNumber()
+    const parts = result.split('/')
+    expect(parts).toHaveLength(4)
+    expect(parts[0]).toBe('FV')
+  })
+})