ztechno_core 0.0.105 → 0.0.108

package/lib/mollie/types/mollie_types.d.ts

@@ -0,0 +1,187 @@
+export type ZCustomer = {
+  id?: number;
+  mollie_customer_id?: string;
+  email: string;
+  name: string;
+  company?: string | null;
+  phone?: string | null;
+  /** VAT number for B2B invoices (Dutch law requirement) */
+  btw_nummer?: string | null;
+  address_line1?: string | null;
+  address_line2?: string | null;
+  postal_code?: string | null;
+  city?: string | null;
+  country?: string | null;
+  locale?: string | null;
+  metadata?: any;
+  created_at?: string | Date;
+  updated_at?: string | Date;
+};
+export type ZInvoiceItemType = 'service' | 'subsidy';
+export type ZInvoiceItem = {
+  id?: number;
+  invoice_id: number;
+  item_type?: ZInvoiceItemType;
+  description: string;
+  quantity: number;
+  unit_price: number;
+  vat_rate: number;
+  total_ex_vat: number;
+  total_inc_vat: number;
+  sort_order?: number;
+};
+export type CreateInvoiceInput = {
+  customer_id: number;
+  description?: string;
+  currency?: string;
+  payment_terms?: string;
+  due_date?: string;
+  items: (Pick<ZInvoiceItem, 'description' | 'quantity' | 'unit_price' | 'vat_rate'> & {
+    sort_order?: number;
+    item_type?: ZInvoiceItemType;
+  })[];
+  metadata?: any;
+};
+export type CreateInvoiceOverrides = {
+  status?: ZInvoiceStatus;
+  paid_at?: string | null;
+  amount_paid?: number | null;
+  subscription_id?: number | null;
+  subscription_period_start?: string | null;
+  subscription_period_end?: string | null;
+  issuePayToken?: boolean;
+  mollie_payment_id?: string | null;
+  checkout_url?: string | null;
+};
+export type ZInvoiceStatus = 'draft' | 'pending' | 'paid' | 'failed' | 'canceled' | 'expired' | 'refunded';
+export type ZInvoice = {
+  id?: number;
+  invoice_number: string;
+  customer_id: number;
+  subscription_id?: number | null;
+  subscription_period_start?: string | null;
+  subscription_period_end?: string | null;
+  mollie_customer_id?: string | null;
+  mollie_payment_id?: string | null;
+  pay_token_hash?: string | null;
+  pay_token_expires_at?: string | null;
+  pay_token_finalized_at?: string | null;
+  status: ZInvoiceStatus;
+  amount_due: number;
+  amount_paid: number;
+  currency: string;
+  description?: string | null;
+  payment_terms?: string | null;
+  due_date?: string | null;
+  issued_at?: string | null;
+  paid_at?: string | null;
+  checkout_url?: string | null;
+  metadata?: any;
+  created_at?: string | Date;
+  updated_at?: string | Date;
+};
+export type ZInvoicePaymentStatus =
+  | 'open'
+  | 'pending'
+  | 'authorized'
+  | 'paid'
+  | 'canceled'
+  | 'expired'
+  | 'failed'
+  | 'refunded';
+export type ZInvoicePayment = {
+  id?: number;
+  invoice_id: number;
+  mollie_payment_id: string;
+  status: ZInvoicePaymentStatus;
+  sequence_type?: 'oneoff' | 'first' | 'recurring' | null;
+  mollie_subscription_id?: string | null;
+  method?: string | null;
+  amount: number;
+  currency: string;
+  checkout_url?: string | null;
+  paid_at?: string | null;
+  expires_at?: string | null;
+  mandate_id?: string | null;
+  created_at?: string | Date;
+  updated_at?: string | Date;
+};
+export type ZSubscriptionItem = {
+  id?: number;
+  subscription_id: number;
+  description: string;
+  quantity: number;
+  unit_price: number;
+  vat_rate: number;
+  total_ex_vat: number;
+  total_inc_vat: number;
+  sort_order?: number;
+};
+export type CreateSubscriptionInput = {
+  customer_id: number;
+  interval: string;
+  description?: string;
+  currency?: string;
+  items: (Pick<ZSubscriptionItem, 'description' | 'quantity' | 'unit_price' | 'vat_rate'> & {
+    sort_order?: number;
+  })[];
+  metadata?: any;
+};
+export type ZSubscriptionStatus = 'setup_pending' | 'pending' | 'active' | 'canceled' | 'suspended' | 'completed';
+export type ZSubscription = {
+  id?: number;
+  customer_id: number;
+  mollie_customer_id?: string | null;
+  mollie_subscription_id?: string | null;
+  status: ZSubscriptionStatus;
+  interval: string;
+  description?: string | null;
+  amount: number;
+  currency: string;
+  mandate_id?: string | null;
+  next_payment_date?: string | null;
+  canceled_at?: string | null;
+  metadata?: any;
+  created_at?: string | Date;
+  updated_at?: string | Date;
+};
+export type ZIssuedPayToken = {
+  token: string;
+  expiresAt: string;
+  payUrl: string;
+};
+export type ZPayResolveResult =
+  | {
+      action: 'redirect';
+      checkoutUrl: string;
+      invoice: ZInvoice;
+    }
+  | {
+      action: 'paid';
+      invoice: ZInvoice;
+    };
+export type RecoveryStats = {
+  dryRun: boolean;
+  startedAt: string;
+  durationMs: number;
+  customers: {
+    recovered: number;
+    skipped: number;
+  };
+  subscriptions: {
+    recovered: number;
+  };
+  invoices: {
+    recovered: number;
+    skippedExisting: number;
+  };
+  payments: {
+    recovered: number;
+    skippedNoCustomer: number;
+  };
+  errors: {
+    entity: string;
+    mollieId: string;
+    error: string;
+  }[];
+};

package/lib/mollie/types/mollie_types.js

@@ -0,0 +1,3 @@
+'use strict';
+// ============================== // Customers
+Object.defineProperty(exports, '__esModule', { value: true });

package/lib/mollie/util/subscription_utils.d.ts

@@ -0,0 +1,8 @@
+export type SubscriptionIntervalUnit = 'day' | 'week' | 'month';
+export type ParsedSubscriptionInterval = {
+  count: number;
+  unit: SubscriptionIntervalUnit;
+};
+export declare function parseSubscriptionInterval(input: string): ParsedSubscriptionInterval;
+export declare function addSubscriptionInterval(date: Date, interval: ParsedSubscriptionInterval): Date;
+export declare function formatDateOnly(date: Date): string;

package/lib/mollie/util/subscription_utils.js

@@ -0,0 +1,37 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.formatDateOnly = exports.addSubscriptionInterval = exports.parseSubscriptionInterval = void 0;
+const pad = (value) => (value < 10 ? `0${value}` : String(value));
+function parseSubscriptionInterval(input) {
+  const normalized = String(input || '')
+    .trim()
+    .toLowerCase();
+  const match = normalized.match(/^(\d+)\s*(day|days|week|weeks|month|months)$/);
+  if (!match) {
+    throw new Error(`Invalid interval "${input}". Expected "N days", "N weeks" or "N months".`);
+  }
+  const count = Number(match[1]);
+  if (!Number.isFinite(count) || count <= 0) {
+    throw new Error(`Invalid interval count "${match[1]}".`);
+  }
+  const unitRaw = match[2];
+  const unit = unitRaw.startsWith('day') ? 'day' : unitRaw.startsWith('week') ? 'week' : 'month';
+  return { count, unit };
+}
+exports.parseSubscriptionInterval = parseSubscriptionInterval;
+function addSubscriptionInterval(date, interval) {
+  const out = new Date(date.getTime());
+  if (interval.unit === 'day') {
+    out.setUTCDate(out.getUTCDate() + interval.count);
+  } else if (interval.unit === 'week') {
+    out.setUTCDate(out.getUTCDate() + interval.count * 7);
+  } else {
+    out.setUTCMonth(out.getUTCMonth() + interval.count);
+  }
+  return out;
+}
+exports.addSubscriptionInterval = addSubscriptionInterval;
+function formatDateOnly(date) {
+  return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())}`;
+}
+exports.formatDateOnly = formatDateOnly;

package/lib/schema/MySQLSchemaExtractor.d.ts

@@ -1,4 +1,4 @@
-import { ZSQLService } from '../sql_service';
+import { ZSQLService } from '../core/sql_service';
 import type {
   DatabaseSchema,
   EventDefinition,

package/lib/schema/MySQLSchemaImporter.d.ts

@@ -1,4 +1,4 @@
-import { ZSQLService } from '../sql_service';
+import { ZSQLService } from '../core/sql_service';
 import type { DatabaseSchema, SchemaImportOptions, SchemaImportResult } from './types';
 /**
  * MySQL Schema Importer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ztechno_core",
-  "version": "0.0.105",
+  "version": "0.0.108",
   "description": "Core files for ztechno framework",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -38,11 +38,13 @@
     "typescript": "^4.9.3"
   },
   "dependencies": {
+    "@mollie/api-client": "^4.4.0",
     "@types/express": "^5.0.0",
     "dom-parser": "^1.1.5",
     "dotenv": "^17.3.1",
     "mysql": "^2.18.1",
     "nodemailer": "^6.8.0",
+    "pdfkit": "^0.17.2",
     "translate": "^1.4.1"
   }
 }