@vicacha-devs/strapi-plugin-certificates 0.0.0-stage → 1.0.0

package/dist/server/src/services/issuanceHelpers.d.ts

@@ -0,0 +1,47 @@
+import { CanonicalCertificatePayload, CertificateRecord, CertificateSignatory, CertificateStats, CertificateTemplate, CertificateVerificationResult, CertificateWitness, CertificatesPluginSettings } from '../../../shared';
+export declare function checkRateLimit(key: string, maxRequests?: number, windowMs?: number): boolean;
+export declare function normalizeSignatories(raw: unknown): CertificateSignatory[];
+export declare function normalizeWitnesses(raw: unknown): CertificateWitness[];
+export declare function normalizeTemplateRecord(doc: Record<string, unknown>): CertificateTemplate;
+export declare function normalizeCertificateRecord(doc: Record<string, unknown>, includePrivate?: boolean): CertificateRecord;
+export declare function buildCanonicalPayload(params: {
+    serialNumber: string;
+    templateSlug: string;
+    organizationName: string;
+    recipientFullName: string;
+    recipientChosenName?: string;
+    nationalIdHash?: string;
+    issuedAt: string;
+    expiresAt?: string | null;
+    signatories: CertificateSignatory[];
+    witnesses: CertificateWitness[];
+}): CanonicalCertificatePayload;
+export declare function evaluateCertificateVerification(params: {
+    cert: CertificateRecord;
+    template: CertificateTemplate | null;
+    settings: CertificatesPluginSettings;
+    options?: {
+        token?: string;
+        nationalId?: string;
+    };
+}): CertificateVerificationResult;
+export declare function renderPrintableFromRecord(params: {
+    cert: CertificateRecord;
+    template: CertificateTemplate | null;
+    settings: CertificatesPluginSettings;
+    options?: {
+        token?: string;
+        isAdmin?: boolean;
+    };
+}): {
+    html: string;
+    serialNumber: string;
+};
+export declare function filterAndComputeCertificateStats(allRecords: CertificateRecord[], filters?: {
+    status?: string;
+    templateSlug?: string;
+    search?: string;
+}): {
+    records: CertificateRecord[];
+    stats: CertificateStats;
+};

package/dist/server/src/services/settings.d.ts

@@ -0,0 +1,17 @@
+import { Core } from '@strapi/strapi';
+import { CalendarSystemConfig, CertificatesPluginSettings, DocuSignProviderConfig, Ed25519KeyPairMaterial } from '../../../shared';
+export declare const DEFAULT_SECONDARY_CALENDARS: CalendarSystemConfig[];
+export declare const DEFAULT_ESIGN_CONFIG: DocuSignProviderConfig;
+export declare const DEFAULT_SETTINGS: Omit<CertificatesPluginSettings, "publicKeyPem" | "publicKeyFingerprint">;
+declare const _default: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => {
+    getSigningKeyPair(): Promise<Ed25519KeyPairMaterial>;
+    rotateKeyPair(): Promise<{
+        publicKeyPem: string;
+        publicKeyFingerprint: string;
+    }>;
+    getSettings(): Promise<CertificatesPluginSettings>;
+    updateSettings(partial: Partial<CertificatesPluginSettings>): Promise<CertificatesPluginSettings>;
+};
+export default _default;

package/dist/server/src/services/urlHelpers.d.ts

@@ -0,0 +1,2 @@
+/** Removes trailing "/" characters in a single linear pass (no regex backtracking). */
+export declare function stripTrailingSlashes(value: string): string;

package/dist/shared/calendarSystems.d.ts

@@ -0,0 +1,3 @@
+import { SUPPORTED_INTL_CALENDARS, applyDayOffset, extractCalendarParts, formatDateInCalendarSystem, getRegisteredCalendarFormatters, registerCalendarSystemFormatter, resolveOccurrenceAlternateDates, unregisterCalendarSystemFormatter, AlternateDateValue, CalendarSystemConfig, CalendarSystemFormatterFn } from '../../strapi-plugin-calendar/shared/index.ts';
+export { SUPPORTED_INTL_CALENDARS, applyDayOffset, extractCalendarParts, formatDateInCalendarSystem, getRegisteredCalendarFormatters, registerCalendarSystemFormatter, resolveOccurrenceAlternateDates, unregisterCalendarSystemFormatter, type AlternateDateValue, type CalendarSystemConfig, type CalendarSystemFormatterFn, };
+export declare function formatSecondaryCalendars(date: Date, systems: CalendarSystemConfig[], locale?: string): Record<string, AlternateDateValue>;

package/dist/shared/cryptoEngine.d.ts

@@ -0,0 +1,27 @@
+import { CanonicalCertificatePayload } from './types';
+export interface Ed25519KeyPairMaterial {
+    publicKeyPem: string;
+    privateKeyPem: string;
+    fingerprint: string;
+}
+export declare function computePublicKeyFingerprint(publicKeyPem: string): string;
+export declare function generateEd25519KeyPair(): Ed25519KeyPairMaterial;
+export declare function sanitizeSerialPrefix(prefix?: string): string;
+export declare function generateSerialNumber(prefix?: string, year?: number): string;
+export declare function generateVerificationToken(): string;
+export declare function normalizeNationalId(rawId?: string): string;
+export declare function maskNationalId(rawId?: string): string;
+export declare function hashNationalId(rawId: string, serialNumber: string): string;
+export declare function verifyNationalIdHash(rawId: string, serialNumber: string, expectedHash?: string): boolean;
+export declare function maskRecipientName(fullName: string): string;
+export declare function serializeCanonicalPayload(payload: CanonicalCertificatePayload): string;
+export declare function computeCanonicalPayloadHash(payload: CanonicalCertificatePayload): string;
+export declare function signCanonicalPayload(payload: CanonicalCertificatePayload, privateKeyPem: string): {
+    canonicalJson: string;
+    payloadHash: string;
+    signature: string;
+};
+export declare function verifyCanonicalPayloadSignature(payload: CanonicalCertificatePayload, signatureBase64Url: string, publicKeyPem: string): boolean;
+export declare function verifyTokenConstantTime(providedToken?: string, expectedToken?: string): boolean;
+export declare function computeDocuSignWebhookHmac(rawPayload: string, webhookSecret: string): string;
+export declare function verifyDocuSignWebhookHmac(rawPayload: string, signatureHeaderBase64?: string, webhookSecret?: string): boolean;

package/dist/shared/documentRenderer.d.ts

@@ -0,0 +1,12 @@
+import { CertificateRecord, CertificateTemplate } from './types';
+export declare function escapeHtml(input: unknown): string;
+export declare function sanitizeHexColor(input?: string, fallback?: string): string;
+export declare function interpolateBodyTemplate(templateText: string, variables: Record<string, string>): string;
+export declare function renderVerificationMatrixSvg(seedText: string, accentColor?: string): string;
+export declare function renderPrintableCertificateHtml(params: {
+    certificate: CertificateRecord;
+    template: CertificateTemplate;
+    verificationUrl: string;
+}): string;
+export declare function escapeCsvCell(value: unknown): string;
+export declare function exportCertificatesToCsv(records: CertificateRecord[]): string;