@bernierllc/email-sender-manager 1.0.1

package/dist/types.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Sender configuration model
+ */
+export interface SenderConfiguration {
+    id: string;
+    name: string;
+    description?: string;
+    fromEmail: string;
+    fromName: string;
+    replyToEmail?: string;
+    replyToName?: string;
+    provider: string;
+    providerSenderId?: string;
+    providerMetadata?: Record<string, unknown>;
+    isVerified: boolean;
+    verificationStatus: 'pending' | 'verified' | 'failed' | 'expired';
+    lastVerifiedAt?: Date;
+    verificationError?: string;
+    isDefault: boolean;
+    isActive: boolean;
+    priority: number;
+    allowedDomains?: string[];
+    domain: string;
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: string;
+    lastModifiedBy: string;
+}
+/**
+ * Request to create a new sender
+ */
+export interface CreateSenderRequest {
+    name: string;
+    description?: string;
+    fromEmail: string;
+    fromName: string;
+    replyToEmail?: string;
+    replyToName?: string;
+    provider: string;
+    providerSenderId?: string;
+    providerMetadata?: Record<string, unknown>;
+    allowedDomains?: string[];
+    priority?: number;
+    createdBy: string;
+}
+/**
+ * Request to update an existing sender
+ */
+export interface UpdateSenderRequest {
+    name?: string;
+    description?: string;
+    fromName?: string;
+    replyToEmail?: string;
+    replyToName?: string;
+    providerSenderId?: string;
+    providerMetadata?: Record<string, unknown>;
+    isVerified?: boolean;
+    verificationStatus?: 'pending' | 'verified' | 'failed' | 'expired';
+    lastVerifiedAt?: Date;
+    verificationError?: string;
+    isDefault?: boolean;
+    isActive?: boolean;
+    priority?: number;
+    allowedDomains?: string[];
+    lastModifiedBy: string;
+}
+/**
+ * Options for listing senders
+ */
+export interface ListSendersOptions {
+    provider?: string;
+    isActive?: boolean;
+    isVerified?: boolean;
+    domain?: string;
+    offset?: number;
+    limit?: number;
+    orderBy?: 'priority' | 'createdAt' | 'name';
+    orderDirection?: 'asc' | 'desc';
+}
+/**
+ * Paginated result
+ */
+export interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * Validation warning
+ */
+export interface ValidationWarning {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * Provider validation result
+ */
+export interface ProviderValidationResult {
+    isVerified: boolean;
+    verificationStatus: string;
+    lastChecked: Date;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Sender validation result
+ */
+export interface SenderValidationResult {
+    isValid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    providerValidation?: ProviderValidationResult;
+}
+/**
+ * Verification result
+ */
+export interface VerificationResult {
+    success: boolean;
+    isVerified: boolean;
+    verificationStatus: string;
+    message?: string;
+    error?: string;
+}
+/**
+ * Selection options for choosing a sender
+ */
+export interface SelectionOptions {
+    strategy?: 'priority' | 'domain_match' | 'round_robin';
+    allowUnverified?: boolean;
+    provider?: string;
+    excludeIds?: string[];
+}
+/**
+ * Domain matching rule
+ */
+export interface DomainMatchingRule {
+    pattern: string;
+    priority: number;
+    allowSubdomains: boolean;
+    allowParentDomains: boolean;
+}
+/**
+ * Bootstrap configuration
+ */
+export interface BootstrapConfig {
+    enabled: boolean;
+    createTables: boolean;
+    seedDefaultSenders: boolean;
+    defaultSenders: Omit<CreateSenderRequest, 'createdBy'>[];
+    environment: 'development' | 'staging' | 'production';
+}
+/**
+ * Selection configuration
+ */
+export interface SelectionConfig {
+    strategy: 'priority' | 'domain_match' | 'round_robin' | 'custom';
+    fallbackToDefault: boolean;
+    domainMatchingRules: DomainMatchingRule[];
+}
+/**
+ * Validation configuration
+ */
+export interface ValidationConfig {
+    requireVerification: boolean;
+    allowUnverifiedSenders: boolean;
+    validateDomainOwnership: boolean;
+}
+/**
+ * Database adapter interface
+ */
+export interface DatabaseAdapter {
+    execute(query: string, params?: unknown[]): Promise<void>;
+    query<T = unknown>(query: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T = unknown>(query: string, params?: unknown[]): Promise<T | null>;
+    transaction<T>(callback: (adapter: DatabaseAdapter) => Promise<T>): Promise<T>;
+}
+/**
+ * Provider sender information
+ */
+export interface ProviderSender {
+    id: string;
+    email: string;
+    name: string;
+    isVerified: boolean;
+    verificationStatus: string;
+    domain: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Provider plugin interface
+ */
+export interface SenderProviderPlugin {
+    readonly providerId: string;
+    readonly name: string;
+    validateSender(email: string): Promise<ProviderValidationResult>;
+    getVerifiedSenders(): Promise<ProviderSender[]>;
+    syncSender(sender: SenderConfiguration): Promise<SyncResult>;
+    getCapabilities(): string[];
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    success: boolean;
+    senderId: string;
+    synced: boolean;
+    message?: string;
+    error?: string;
+}
+/**
+ * Bootstrap result
+ */
+export interface BootstrapResult {
+    success: boolean;
+    tablesCreated: boolean;
+    seedersRun: number;
+    message: string;
+    errors?: string[];
+}
+/**
+ * Cleanup result
+ */
+export interface CleanupResult {
+    success: boolean;
+    deletedCount: number;
+    message: string;
+}
+/**
+ * Sender manager configuration
+ */
+export interface SenderManagerConfig {
+    database: DatabaseAdapter;
+    providers?: SenderProviderPlugin[];
+    bootstrap?: Partial<BootstrapConfig>;
+    validation?: Partial<ValidationConfig>;
+    selection?: Partial<SelectionConfig>;
+    systemUser?: string;
+}
+/**
+ * Route conflict information
+ */
+export interface RouteConflict {
+    path: string;
+    conflictingRoutes: string[];
+    reason: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;EAME"}

package/dist/utils/domain-utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Extract domain from email address
+ */
+export declare function extractDomain(email: string): string;
+/**
+ * Check if a domain matches a pattern (supports wildcards)
+ */
+export declare function isDomainMatch(domain: string, pattern: string): boolean;
+/**
+ * Validate email format
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Get parent domain (e.g., app.example.com -> example.com)
+ */
+export declare function getParentDomain(domain: string): string | null;
+/**
+ * Check if domain is a subdomain of another
+ */
+export declare function isSubdomainOf(subdomain: string, parentDomain: string): boolean;
+//# sourceMappingURL=domain-utils.d.ts.map

package/dist/utils/domain-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-utils.d.ts","sourceRoot":"","sources":["../../src/utils/domain-utils.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAsBtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAE9E"}

package/dist/utils/domain-utils.js

@@ -0,0 +1,65 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+/**
+ * Extract domain from email address
+ */
+export function extractDomain(email) {
+    const match = email.match(/^.+@(.+)$/);
+    if (!match || !match[1]) {
+        throw new Error(`Invalid email format: ${email}`);
+    }
+    return match[1].toLowerCase();
+}
+/**
+ * Check if a domain matches a pattern (supports wildcards)
+ */
+export function isDomainMatch(domain, pattern) {
+    const normalizedDomain = domain.toLowerCase();
+    const normalizedPattern = pattern.toLowerCase();
+    // Support glob patterns
+    if (normalizedPattern.includes('*')) {
+        const regexPattern = normalizedPattern
+            .replace(/\./g, '\\.')
+            .replace(/\*/g, '.*');
+        return new RegExp(`^${regexPattern}$`).test(normalizedDomain);
+    }
+    // Exact match
+    if (normalizedDomain === normalizedPattern)
+        return true;
+    // Subdomain match (e.g., app.example.com matches example.com)
+    if (normalizedDomain.endsWith(`.${normalizedPattern}`))
+        return true;
+    // Parent domain match (e.g., example.com matches app.example.com)
+    if (normalizedPattern.endsWith(`.${normalizedDomain}`))
+        return true;
+    return false;
+}
+/**
+ * Validate email format
+ */
+export function isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+/**
+ * Get parent domain (e.g., app.example.com -> example.com)
+ */
+export function getParentDomain(domain) {
+    const parts = domain.split('.');
+    if (parts.length <= 2) {
+        return null; // Already at top-level domain
+    }
+    return parts.slice(1).join('.');
+}
+/**
+ * Check if domain is a subdomain of another
+ */
+export function isSubdomainOf(subdomain, parentDomain) {
+    return subdomain.toLowerCase().endsWith(`.${parentDomain.toLowerCase()}`);
+}
+//# sourceMappingURL=domain-utils.js.map

package/dist/utils/domain-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-utils.js","sourceRoot":"","sources":["../../src/utils/domain-utils.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAe;IAC3D,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEhD,wBAAwB;IACxB,IAAI,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,iBAAiB;aACnC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;aACrB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACxB,OAAO,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAED,cAAc;IACd,IAAI,gBAAgB,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAExD,8DAA8D;IAC9D,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpE,kEAAkE;IAClE,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,CAAC,8BAA8B;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,YAAoB;IACnE,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/utils/validation-utils.d.ts

@@ -0,0 +1,23 @@
+import type { CreateSenderRequest, ValidationError, ValidationWarning } from '../types.js';
+/**
+ * Validate a create sender request
+ */
+export declare function validateCreateSenderRequest(request: CreateSenderRequest): {
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+};
+/**
+ * Validate domain matches allowed domains
+ */
+export declare function validateDomainAllowed(email: string, allowedDomains?: string[]): {
+    allowed: boolean;
+    reason?: string;
+};
+/**
+ * Validate sender configuration before save
+ */
+export declare function validateSenderConfiguration(fromEmail: string, allowedDomains?: string[]): {
+    valid: boolean;
+    errors: ValidationError[];
+};
+//# sourceMappingURL=validation-utils.d.ts.map

package/dist/utils/validation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-utils.d.ts","sourceRoot":"","sources":["../../src/utils/validation-utils.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG3F;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,GAC3B;IAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAgG9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBvC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAqB/C"}

package/dist/utils/validation-utils.js

@@ -0,0 +1,148 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+import { isValidEmail, extractDomain } from './domain-utils.js';
+/**
+ * Validate a create sender request
+ */
+export function validateCreateSenderRequest(request) {
+    const errors = [];
+    const warnings = [];
+    // Required fields
+    if (!request.name || request.name.trim().length === 0) {
+        errors.push({
+            field: 'name',
+            message: 'Sender name is required',
+            code: 'REQUIRED_FIELD',
+        });
+    }
+    if (!request.fromEmail || request.fromEmail.trim().length === 0) {
+        errors.push({
+            field: 'fromEmail',
+            message: 'From email is required',
+            code: 'REQUIRED_FIELD',
+        });
+    }
+    else if (!isValidEmail(request.fromEmail)) {
+        errors.push({
+            field: 'fromEmail',
+            message: 'Invalid email format',
+            code: 'INVALID_FORMAT',
+        });
+    }
+    if (!request.fromName || request.fromName.trim().length === 0) {
+        errors.push({
+            field: 'fromName',
+            message: 'From name is required',
+            code: 'REQUIRED_FIELD',
+        });
+    }
+    if (!request.provider || request.provider.trim().length === 0) {
+        errors.push({
+            field: 'provider',
+            message: 'Provider is required',
+            code: 'REQUIRED_FIELD',
+        });
+    }
+    if (!request.createdBy || request.createdBy.trim().length === 0) {
+        errors.push({
+            field: 'createdBy',
+            message: 'Created by is required',
+            code: 'REQUIRED_FIELD',
+        });
+    }
+    // Optional fields validation
+    if (request.replyToEmail && !isValidEmail(request.replyToEmail)) {
+        errors.push({
+            field: 'replyToEmail',
+            message: 'Invalid reply-to email format',
+            code: 'INVALID_FORMAT',
+        });
+    }
+    // Priority validation
+    if (request.priority !== undefined && (request.priority < 0 || !Number.isInteger(request.priority))) {
+        errors.push({
+            field: 'priority',
+            message: 'Priority must be a non-negative integer',
+            code: 'INVALID_VALUE',
+        });
+    }
+    // Allowed domains validation
+    if (request.allowedDomains) {
+        if (!Array.isArray(request.allowedDomains)) {
+            errors.push({
+                field: 'allowedDomains',
+                message: 'Allowed domains must be an array',
+                code: 'INVALID_TYPE',
+            });
+        }
+        else if (request.allowedDomains.length === 0) {
+            warnings.push({
+                field: 'allowedDomains',
+                message: 'Empty allowed domains array - sender can send from any domain',
+                code: 'EMPTY_ARRAY',
+            });
+        }
+    }
+    // Warning if no reply-to email
+    if (!request.replyToEmail && request.fromEmail) {
+        warnings.push({
+            field: 'replyToEmail',
+            message: 'No reply-to email specified - replies will go to from email',
+            code: 'MISSING_OPTIONAL',
+        });
+    }
+    return { errors, warnings };
+}
+/**
+ * Validate domain matches allowed domains
+ */
+export function validateDomainAllowed(email, allowedDomains) {
+    if (!allowedDomains || allowedDomains.length === 0) {
+        return { allowed: true }; // No restrictions
+    }
+    try {
+        const domain = extractDomain(email);
+        const isAllowed = allowedDomains.some((allowed) => domain === allowed.toLowerCase() || domain.endsWith(`.${allowed.toLowerCase()}`));
+        if (!isAllowed) {
+            return {
+                allowed: false,
+                reason: `Domain ${domain} is not in allowed domains list: ${allowedDomains.join(', ')}`,
+            };
+        }
+        return { allowed: true };
+    }
+    catch (error) {
+        return {
+            allowed: false,
+            reason: `Invalid email format: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        };
+    }
+}
+/**
+ * Validate sender configuration before save
+ */
+export function validateSenderConfiguration(fromEmail, allowedDomains) {
+    const errors = [];
+    if (!isValidEmail(fromEmail)) {
+        errors.push({
+            field: 'fromEmail',
+            message: 'Invalid email format',
+            code: 'INVALID_FORMAT',
+        });
+    }
+    const domainCheck = validateDomainAllowed(fromEmail, allowedDomains);
+    if (!domainCheck.allowed) {
+        errors.push({
+            field: 'fromEmail',
+            message: domainCheck.reason || 'Domain not allowed',
+            code: 'DOMAIN_NOT_ALLOWED',
+        });
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validation-utils.js.map

package/dist/utils/validation-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-utils.js","sourceRoot":"","sources":["../../src/utils/validation-utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@bernierllc/email-sender-manager",
+  "version": "1.0.1",
+  "description": "Database-backed email sender configuration management with provider verification integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules\" jest --no-cache",
+    "test:watch": "NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules\" jest --watch",
+    "test:coverage": "NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules\" jest --coverage --no-cache",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "email",
+    "sender",
+    "configuration",
+    "database",
+    "verification",
+    "sendgrid",
+    "mailgun",
+    "email-management"
+  ],
+  "author": "Bernier LLC",
+  "license": "UNLICENSED",
+  "dependencies": {},
+  "devDependencies": {
+    "@jest/globals": "^29.5.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^18.15.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.42.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.0.5",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  }
+}