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

package/dist/shared/types.d.ts

@@ -0,0 +1,194 @@
+import { AlternateDateValue, CalendarSystemConfig } from './calendarSystems';
+export type CertificateStatus = "pending_approval" | "issued" | "revoked" | "expired";
+export type ESignProviderType = "none" | "docusign" | "webhook";
+export type ESignEnvelopeStatus = "not_sent" | "sent" | "delivered" | "completed" | "declined" | "voided";
+export interface DocuSignProviderConfig {
+    enabled: boolean;
+    provider: ESignProviderType;
+    baseUrl: string;
+    accountId: string;
+    integrationKey?: string;
+    emailSubjectPrefix?: string;
+}
+export interface CertificateSignatory {
+    name: string;
+    title: string;
+    role?: string;
+    email?: string;
+    routingOrder?: number;
+    signatureImageUrl?: string;
+    signedAt?: string;
+}
+export interface CertificateWitness {
+    fullName: string;
+    documentIdMasked?: string;
+    role?: string;
+    email?: string;
+    routingOrder?: number;
+    signedAt?: string;
+}
+export interface CertificateCustomFieldDef {
+    key: string;
+    label: string;
+    required?: boolean;
+}
+export interface CertificateTemplate {
+    id?: number | string;
+    documentId: string;
+    name: string;
+    slug: string;
+    description?: string;
+    serialPrefix: string;
+    defaultValidityDays?: number | null;
+    requiresWitnesses: boolean;
+    minWitnesses: number;
+    requiresApproval: boolean;
+    esignEnabled?: boolean;
+    esignProvider?: ESignProviderType;
+    organizationName: string;
+    organizationSubheader?: string;
+    headerText?: string;
+    titleText: string;
+    bodyTemplate: string;
+    footerText?: string;
+    defaultSignatories: CertificateSignatory[];
+    customFieldsSchema?: CertificateCustomFieldDef[];
+    secondaryCalendars?: CalendarSystemConfig[];
+    accentColor?: string;
+    active: boolean;
+}
+export interface CertificateRecord {
+    id?: number | string;
+    documentId: string;
+    serialNumber: string;
+    templateDocumentId: string;
+    templateSlug: string;
+    templateName: string;
+    status: CertificateStatus;
+    recipientFullName: string;
+    recipientChosenName?: string;
+    recipientEmail?: string;
+    recipientPhone?: string;
+    recipientNationality?: string;
+    nationalIdMasked?: string;
+    nationalIdHash?: string;
+    issuedAt: string;
+    expiresAt?: string | null;
+    revokedAt?: string | null;
+    revocationReason?: string | null;
+    signatories: CertificateSignatory[];
+    witnesses: CertificateWitness[];
+    customData?: Record<string, string>;
+    secondaryDates?: Record<string, AlternateDateValue>;
+    canonicalPayloadHash: string;
+    cryptographicSignature: string;
+    publicKeyFingerprint: string;
+    verificationToken?: string;
+    esignProvider?: ESignProviderType;
+    esignEnvelopeId?: string;
+    esignEnvelopeStatus?: ESignEnvelopeStatus;
+    esignCompletedAt?: string | null;
+    linkedBookingCode?: string;
+    notes?: string;
+}
+export interface CertificateIssueInput {
+    templateDocumentId?: string;
+    templateSlug?: string;
+    recipientFullName: string;
+    recipientChosenName?: string;
+    recipientEmail?: string;
+    recipientPhone?: string;
+    recipientNationality?: string;
+    nationalIdRaw?: string;
+    issuedAt?: string;
+    expiresAt?: string | null;
+    signatories?: CertificateSignatory[];
+    witnesses?: Array<{
+        fullName: string;
+        documentIdRaw?: string;
+        documentIdMasked?: string;
+        role?: string;
+        email?: string;
+        routingOrder?: number;
+        signedAt?: string;
+    }>;
+    customData?: Record<string, string>;
+    linkedBookingCode?: string;
+    notes?: string;
+    autoApprove?: boolean;
+    sendViaESign?: boolean;
+    locale?: string;
+}
+export interface CanonicalCertificatePayload {
+    version: "1.0";
+    serialNumber: string;
+    templateSlug: string;
+    organizationName: string;
+    recipientFullName: string;
+    recipientChosenName: string;
+    nationalIdHash: string;
+    issuedAt: string;
+    expiresAt: string;
+    signatories: Array<{
+        name: string;
+        title: string;
+    }>;
+    witnesses: Array<{
+        fullName: string;
+        role: string;
+    }>;
+}
+export interface CertificateVerificationResult {
+    valid: boolean;
+    cryptographicallyVerified: boolean;
+    status: CertificateStatus;
+    serialNumber: string;
+    templateSlug: string;
+    templateName: string;
+    organizationName: string;
+    recipientNameDisplay: string;
+    recipientChosenName?: string;
+    nationalIdMasked?: string;
+    nationalIdMatches?: boolean;
+    issuedAt: string;
+    expiresAt?: string | null;
+    revokedAt?: string | null;
+    revocationReason?: string | null;
+    secondaryDates?: Record<string, AlternateDateValue>;
+    signatories: CertificateSignatory[];
+    witnesses: Array<{
+        fullName: string;
+        role?: string;
+    }>;
+    canonicalPayloadHash: string;
+    cryptographicSignature: string;
+    publicKeyFingerprint: string;
+    publicKeyPem: string;
+    esignProvider?: ESignProviderType;
+    esignEnvelopeId?: string;
+    esignEnvelopeStatus?: ESignEnvelopeStatus;
+    esignCompletedAt?: string | null;
+    isUnmasked: boolean;
+    verifiedAt: string;
+}
+export interface CertificatesPluginSettings {
+    organizationName: string;
+    organizationSubheader: string;
+    verificationBaseUrl: string;
+    defaultTimezone: string;
+    defaultLocale: string;
+    maskPublicRecipientName: boolean;
+    allowPublicApplications: boolean;
+    publicKeyPem: string;
+    publicKeyFingerprint: string;
+    secondaryCalendars: CalendarSystemConfig[];
+    esign: DocuSignProviderConfig;
+    defaultTemplates?: Array<Omit<CertificateTemplate, "documentId">>;
+}
+export interface CertificateStats {
+    total: number;
+    issued: number;
+    pending_approval: number;
+    revoked: number;
+    expired: number;
+}

package/package.json

@@ -1,6 +1,115 @@
 {
   "name": "@vicacha-devs/strapi-plugin-certificates",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.1.0",
+  "description": "Generic Strapi v5 Official Certificates, Cryptographic Ed25519 Signing, Printable Credentials & QR Verification Plugin powered by @vicacha-devs/strapi-plugin-calendar",
+  "keywords": [
+    "calendar",
+    "certificates",
+    "credentials",
+    "digital-signature",
+    "ed25519",
+    "shahada",
+    "strapi",
+    "strapi-plugin",
+    "strapi-v5",
+    "verification"
+  ],
+  "homepage": "https://github.com/Vicacha-Devs/strapi-v5-extensions/tree/main/packages/strapi-plugin-certificates#readme",
+  "bugs": {
+    "url": "https://github.com/Vicacha-Devs/strapi-v5-extensions/issues"
+  },
+  "license": "MIT",
+  "author": "Vicacha Devs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vicacha-Devs/strapi-v5-extensions.git",
+    "directory": "packages/strapi-plugin-certificates"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    "./strapi-admin": {
+      "types": "./dist/admin/src/index.d.ts",
+      "source": "./admin/src/index.ts",
+      "import": "./dist/admin/index.mjs",
+      "require": "./dist/admin/index.js",
+      "default": "./dist/admin/index.mjs"
+    },
+    "./strapi-server": {
+      "types": "./dist/server/src/index.d.ts",
+      "source": "./server/src/index.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "source": "./shared/index.ts",
+      "import": "./dist/shared/index.mjs",
+      "require": "./dist/shared/index.js",
+      "default": "./dist/shared/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@strapi/design-system": "2.2.0",
+    "@strapi/icons": "2.2.0",
+    "react-intl": "8.1.3",
+    "@vicacha-devs/strapi-plugin-calendar": "1.1.1"
+  },
+  "devDependencies": {
+    "@strapi/sdk-plugin": "6.1.1",
+    "@strapi/strapi": "5.39.0",
+    "@strapi/typescript-utils": "5.39.0",
+    "@types/node": "22.10.2",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-router-dom": "6.30.3",
+    "styled-components": "6.3.11",
+    "typescript": "5.9.3",
+    "vitest": "4.1.0",
+    "@vicacha-devs/eslint-config": "1.0.0",
+    "@vicacha-devs/plugin-shared": "1.0.0",
+    "@vicacha-devs/typescript-config": "1.0.0"
+  },
+  "peerDependencies": {
+    "@strapi/sdk-plugin": "^5.0.0 || ^6.0.0",
+    "@strapi/strapi": "^5.0.0",
+    "@vicacha-devs/strapi-plugin-calendar": "^1.1.1",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "react-router-dom": "^6.0.0",
+    "styled-components": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=20.16.0",
+    "pnpm": ">=10.0.0"
+  },
+  "strapi": {
+    "kind": "plugin",
+    "name": "certificates",
+    "displayName": "Certificates & Signing",
+    "description": "Generic Strapi v5 Official Certificates, Ed25519 Cryptographic Signing & Public Verification"
+  },
+  "scripts": {
+    "build": "strapi-plugin build && node ../../scripts/ensure-esm-dist.ts",
+    "clean": "rm -rf dist",
+    "test": "node --import ./tests/register-ts-resolver.ts --test tests/*.test.ts",
+    "test:ts": "npm run test:ts:front && npm run test:ts:back",
+    "test:ts:back": "tsc --noEmit -p server/tsconfig.json",
+    "test:ts:front": "tsc --noEmit -p admin/tsconfig.json",
+    "test:vitest": "vitest run",
+    "test:watch": "vitest",
+    "verify": "strapi-plugin verify",
+    "watch": "strapi-plugin watch",
+    "watch:link": "strapi-plugin watch:link"
+  }
 }