@contractspec/bundle.library 3.7.6 → 3.8.2

package/src/features/presentations.feature.ts

@@ -5,31 +5,31 @@ import type { FeatureModuleSpec } from '@contractspec/lib.contracts-spec/feature
  * Provides cross-platform rendering of contract-driven UI.
  */
 export const PresentationsFeature: FeatureModuleSpec = {
-  meta: {
-    key: 'contractspec.presentations',
-    version: '1.0.0',
-    title: 'Presentation Runtime',
-    description: 'Cross-platform rendering of contract-driven UI',
-    domain: 'platform',
-    owners: ['@platform.presentations'],
-    tags: ['presentations', 'ui', 'rendering', 'cross-platform'],
-    stability: 'beta',
-  },
-  operations: [
-    { key: 'presentation.render', version: '1.0.0' },
-    { key: 'presentation.transform', version: '1.0.0' },
-  ],
-  events: [
-    { key: 'presentation.rendered', version: '1.0.0' },
-    { key: 'presentation.transformed', version: '1.0.0' },
-  ],
-  presentations: [
-    { key: 'form.standard', version: '1.0.0' },
-    { key: 'list.standard', version: '1.0.0' },
-    { key: 'detail.standard', version: '1.0.0' },
-  ],
-  capabilities: {
-    provides: [{ key: 'contracts.presentations', version: '1.0.0' }],
-    requires: [],
-  },
+	meta: {
+		key: 'contractspec.presentations',
+		version: '1.0.0',
+		title: 'Presentation Runtime',
+		description: 'Cross-platform rendering of contract-driven UI',
+		domain: 'platform',
+		owners: ['@platform.presentations'],
+		tags: ['presentations', 'ui', 'rendering', 'cross-platform'],
+		stability: 'beta',
+	},
+	operations: [
+		{ key: 'presentation.render', version: '1.0.0' },
+		{ key: 'presentation.transform', version: '1.0.0' },
+	],
+	events: [
+		{ key: 'presentation.rendered', version: '1.0.0' },
+		{ key: 'presentation.transformed', version: '1.0.0' },
+	],
+	presentations: [
+		{ key: 'form.standard', version: '1.0.0' },
+		{ key: 'list.standard', version: '1.0.0' },
+		{ key: 'detail.standard', version: '1.0.0' },
+	],
+	capabilities: {
+		provides: [{ key: 'contracts.presentations', version: '1.0.0' }],
+		requires: [],
+	},
 };

package/src/features/registry.ts

@@ -1,5 +1,5 @@
-import { FeatureRegistry } from '@contractspec/lib.contracts-spec/features';
 import { AppConfigFeature } from '@contractspec/lib.contracts-spec/app-config';
+import { FeatureRegistry } from '@contractspec/lib.contracts-spec/features';
 import { DocsFeature } from './docs.feature';
 import { MCPFeature } from './mcp.feature';
 import { PresentationsFeature } from './presentations.feature';
@@ -9,17 +9,17 @@ import { PresentationsFeature } from './presentations.feature';
  * Registers all ContractSpec features without validation (ops/presentations not registered).
  */
 export function createContractSpecFeatureRegistry(): FeatureRegistry {
-  const features = new FeatureRegistry();
+	const features = new FeatureRegistry();
 
-  // Register ContractSpec-specific features
-  features.register(DocsFeature);
-  features.register(MCPFeature);
-  features.register(PresentationsFeature);
+	// Register ContractSpec-specific features
+	features.register(DocsFeature);
+	features.register(MCPFeature);
+	features.register(PresentationsFeature);
 
-  // Register lib.contracts features
-  features.register(AppConfigFeature);
+	// Register lib.contracts features
+	features.register(AppConfigFeature);
 
-  return features;
+	return features;
 }
 
 /** Singleton instance of the feature registry. */
@@ -30,15 +30,15 @@ let registryInstance: FeatureRegistry | null = null;
  * Creates the registry on first call, returns cached instance thereafter.
  */
 export function getContractSpecFeatureRegistry(): FeatureRegistry {
-  if (!registryInstance) {
-    registryInstance = createContractSpecFeatureRegistry();
-  }
-  return registryInstance;
+	if (!registryInstance) {
+		registryInstance = createContractSpecFeatureRegistry();
+	}
+	return registryInstance;
 }
 
 /**
  * Reset the feature registry singleton (for testing).
  */
 export function resetContractSpecFeatureRegistry(): void {
-  registryInstance = null;
+	registryInstance = null;
 }

package/src/index.ts

@@ -1,9 +1,9 @@
+export * from './components/docs';
 export * from './components/integrations';
+export * from './components/legal';
 export * from './components/shared';
 export * from './components/shell';
 export * from './components/templates';
-export * from './components/docs';
-export * from './components/legal';
 
 // App config and features
 export * from './config';

package/src/infrastructure/elysia/logger.ts

@@ -2,37 +2,37 @@ import { Logger, LogLevel } from '@contractspec/lib.logger';
 
 // Centralized logger configuration for the API
 export const createAppLogger = () =>
-  new Logger({
-    level:
-      process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
-    environment: process.env.NODE_ENV || 'development',
-    enableTracing: true,
-    enableTiming: true,
-    enableContext: true,
-    enableColors: process.env.NODE_ENV !== 'production',
-  });
+	new Logger({
+		level:
+			process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+		environment: process.env.NODE_ENV || 'development',
+		enableTracing: true,
+		enableTiming: true,
+		enableContext: true,
+		enableColors: process.env.NODE_ENV !== 'production',
+	});
 
 // Default logger instance for the application
 export const appLogger = createAppLogger();
 
 // Logger specifically for database operations
 export const dbLogger = new Logger({
-  level: process.env.NODE_ENV === 'production' ? LogLevel.WARN : LogLevel.DEBUG,
-  environment: process.env.NODE_ENV || 'development',
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: process.env.NODE_ENV !== 'production',
+	level: process.env.NODE_ENV === 'production' ? LogLevel.WARN : LogLevel.DEBUG,
+	environment: process.env.NODE_ENV || 'development',
+	enableTracing: true,
+	enableTiming: true,
+	enableContext: true,
+	enableColors: process.env.NODE_ENV !== 'production',
 });
 
 // Logger for authentication operations
 export const authLogger = new Logger({
-  level: LogLevel.INFO, // Always log auth events
-  environment: process.env.NODE_ENV || 'development',
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: process.env.NODE_ENV !== 'production',
+	level: LogLevel.INFO, // Always log auth events
+	environment: process.env.NODE_ENV || 'development',
+	enableTracing: true,
+	enableTiming: true,
+	enableContext: true,
+	enableColors: process.env.NODE_ENV !== 'production',
 });
 
 export { Logger, LogLevel };

package/src/libs/email/client.test.ts

@@ -5,103 +5,103 @@ import { beforeEach, describe, expect, it } from 'bun:test';
 import { __internal, getEmailConfig, sendEmail } from './client';
 
 const ENV_KEYS = [
-  'SCALEWAY_ACCESS_KEY',
-  'SCALEWAY_SECRET_KEY',
-  'SCALEWAY_PROJECT_ID',
-  'SCALEWAY_ACCESS_KEY_QUEUE',
-  'SCALEWAY_SECRET_KEY_QUEUE',
-  'SCALEWAY_REGION',
-  'SCALEWAY_EMAIL_FROM_EMAIL',
-  'SCALEWAY_EMAIL_FROM_NAME',
-  'SCALEWAY_EMAIL_TEAM_EMAIL',
-  'SCALEWAY_EMAIL_TEAM_NAME',
+	'SCALEWAY_ACCESS_KEY',
+	'SCALEWAY_SECRET_KEY',
+	'SCALEWAY_PROJECT_ID',
+	'SCALEWAY_ACCESS_KEY_QUEUE',
+	'SCALEWAY_SECRET_KEY_QUEUE',
+	'SCALEWAY_REGION',
+	'SCALEWAY_EMAIL_FROM_EMAIL',
+	'SCALEWAY_EMAIL_FROM_NAME',
+	'SCALEWAY_EMAIL_TEAM_EMAIL',
+	'SCALEWAY_EMAIL_TEAM_NAME',
 ];
 
 const clearEnv = () => {
-  ENV_KEYS.forEach((key) => {
-    // eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- Pragmatic use for environment cleanup in tests
-    delete process.env[key];
-  });
+	ENV_KEYS.forEach((key) => {
+		// eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- Pragmatic use for environment cleanup in tests
+		delete process.env[key];
+	});
 };
 
 const setEnv = (values: Partial<Record<string, string>>) => {
-  Object.entries(values).forEach(([key, value]) => {
-    process.env[key] = value;
-  });
+	Object.entries(values).forEach(([key, value]) => {
+		process.env[key] = value;
+	});
 };
 
 describe('email client config', () => {
-  beforeEach(() => {
-    __internal.resetCaches();
-    clearEnv();
-  });
+	beforeEach(() => {
+		__internal.resetCaches();
+		clearEnv();
+	});
 
-  it('returns a failure result when credentials are missing', () => {
-    const result = getEmailConfig();
-    expect(result.ok).toBeFalse();
-    expect(result.config).toBeUndefined();
-  });
+	it('returns a failure result when credentials are missing', () => {
+		const result = getEmailConfig();
+		expect(result.ok).toBeFalse();
+		expect(result.config).toBeUndefined();
+	});
 
-  it('prefers Scaleway env variables for config and region mapping', () => {
-    setEnv({
-      SCALEWAY_ACCESS_KEY: 'access',
-      SCALEWAY_SECRET_KEY: 'secret',
-      SCALEWAY_PROJECT_ID: 'project-123',
-      SCALEWAY_EMAIL_FROM_EMAIL: 'from@example.com',
-      SCALEWAY_EMAIL_FROM_NAME: 'From Name',
-      SCALEWAY_EMAIL_TEAM_EMAIL: 'team@example.com',
-      SCALEWAY_EMAIL_TEAM_NAME: 'Team Name',
-    });
+	it('prefers Scaleway env variables for config and region mapping', () => {
+		setEnv({
+			SCALEWAY_ACCESS_KEY: 'access',
+			SCALEWAY_SECRET_KEY: 'secret',
+			SCALEWAY_PROJECT_ID: 'project-123',
+			SCALEWAY_EMAIL_FROM_EMAIL: 'from@example.com',
+			SCALEWAY_EMAIL_FROM_NAME: 'From Name',
+			SCALEWAY_EMAIL_TEAM_EMAIL: 'team@example.com',
+			SCALEWAY_EMAIL_TEAM_NAME: 'Team Name',
+		});
 
-    const result = getEmailConfig();
-    expect(result.ok).toBeTrue();
-    expect(result.config?.accessKey).toBe('access');
-    expect(result.config?.secretKey).toBe('secret');
-    expect(result.config?.projectId).toBe('project-123');
-    expect(result.config?.region).toBe('fr-par');
-    expect(result.config?.from.email).toBe('from@example.com');
-    expect(result.config?.from.name).toBe('From Name');
-    expect(result.config?.teamInbox.email).toBe('team@example.com');
-    expect(result.config?.teamInbox.name).toBe('Team Name');
-  });
+		const result = getEmailConfig();
+		expect(result.ok).toBeTrue();
+		expect(result.config?.accessKey).toBe('access');
+		expect(result.config?.secretKey).toBe('secret');
+		expect(result.config?.projectId).toBe('project-123');
+		expect(result.config?.region).toBe('fr-par');
+		expect(result.config?.from.email).toBe('from@example.com');
+		expect(result.config?.from.name).toBe('From Name');
+		expect(result.config?.teamInbox.email).toBe('team@example.com');
+		expect(result.config?.teamInbox.name).toBe('Team Name');
+	});
 
-  it('uses provided API factory to send email with reply-to header', async () => {
-    setEnv({
-      SCALEWAY_ACCESS_KEY: 'access',
-      SCALEWAY_SECRET_KEY: 'secret',
-      SCALEWAY_PROJECT_ID: 'project-123',
-    });
+	it('uses provided API factory to send email with reply-to header', async () => {
+		setEnv({
+			SCALEWAY_ACCESS_KEY: 'access',
+			SCALEWAY_SECRET_KEY: 'secret',
+			SCALEWAY_PROJECT_ID: 'project-123',
+		});
 
-    let captured: unknown = null;
+		let captured: unknown = null;
 
-    __internal.setClient({
-      async createEmail(request: unknown) {
-        captured = request;
-        return { emails: [] };
-      },
-    });
+		__internal.setClient({
+			async createEmail(request: unknown) {
+				captured = request;
+				return { emails: [] };
+			},
+		});
 
-    const config = getEmailConfig().config!;
+		const config = getEmailConfig().config!;
 
-    const response = await sendEmail(config, {
-      to: [{ email: 'user@example.com' }],
-      subject: 'Subject',
-      text: 'Plain text',
-      html: '<p>html</p>',
-      replyTo: 'reply@example.com',
-      context: 'test',
-    });
+		const response = await sendEmail(config, {
+			to: [{ email: 'user@example.com' }],
+			subject: 'Subject',
+			text: 'Plain text',
+			html: '<p>html</p>',
+			replyTo: 'reply@example.com',
+			context: 'test',
+		});
 
-    expect(response.success).toBeTrue();
-    const createEmailRequest = captured as Record<string, unknown>;
-    expect(createEmailRequest.region).toBe(config.region);
-    expect(createEmailRequest.projectId).toBe(config.projectId);
-    expect(createEmailRequest.from).toStrictEqual(config.from);
-    expect(createEmailRequest.to).toStrictEqual([
-      { email: 'user@example.com' },
-    ]);
-    expect(createEmailRequest.additionalHeaders).toStrictEqual([
-      { key: 'Reply-To', value: 'reply@example.com' },
-    ]);
-  });
+		expect(response.success).toBeTrue();
+		const createEmailRequest = captured as Record<string, unknown>;
+		expect(createEmailRequest.region).toBe(config.region);
+		expect(createEmailRequest.projectId).toBe(config.projectId);
+		expect(createEmailRequest.from).toStrictEqual(config.from);
+		expect(createEmailRequest.to).toStrictEqual([
+			{ email: 'user@example.com' },
+		]);
+		expect(createEmailRequest.additionalHeaders).toStrictEqual([
+			{ key: 'Reply-To', value: 'reply@example.com' },
+		]);
+	});
 });

package/src/libs/email/client.ts

@@ -1,22 +1,22 @@
+import { Logger } from '@contractspec/lib.logger';
 import { createClient, Temv1alpha1 } from '@scaleway/sdk';
 import type { Region } from '@scaleway/sdk-client';
-import { Logger } from '@contractspec/lib.logger';
 import type {
-  EmailAddress,
-  EmailConfigResult,
-  EmailSendOutcome,
-  EmailServiceConfig,
-  SendEmailRequest,
+	EmailAddress,
+	EmailConfigResult,
+	EmailSendOutcome,
+	EmailServiceConfig,
+	SendEmailRequest,
 } from './types';
 
 const DEFAULT_FROM: EmailAddress = {
-  email: 'noreply@transactional.contractspec.io',
-  name: 'ContractSpec',
+	email: 'noreply@transactional.contractspec.io',
+	name: 'ContractSpec',
 };
 
 const DEFAULT_TEAM_INBOX: EmailAddress = {
-  email: 'contact@contractspec.io',
-  name: 'ContractSpec Team',
+	email: 'contact@contractspec.io',
+	name: 'ContractSpec Team',
 };
 
 const DEFAULT_REGION: Region = 'fr-par';
@@ -26,121 +26,121 @@ type EmailApi = Pick<Temv1alpha1.API, 'createEmail'>;
 let cachedConfig: EmailServiceConfig | null = null;
 let cachedClient: EmailApi | null = null;
 let apiFactory: (client: ReturnType<typeof createClient>) => EmailApi = (
-  client
+	client
 ) => new Temv1alpha1.API(client);
 
 const mapRegion = (value?: string | null): Region => {
-  const normalized = value?.trim().toLowerCase();
-  if (normalized === 'par' || normalized === 'fr-par') return 'fr-par';
-  if (normalized === 'ams' || normalized === 'nl-ams') return 'nl-ams';
-  if (normalized === 'waw' || normalized === 'pl-waw') return 'pl-waw';
-  return DEFAULT_REGION;
+	const normalized = value?.trim().toLowerCase();
+	if (normalized === 'par' || normalized === 'fr-par') return 'fr-par';
+	if (normalized === 'ams' || normalized === 'nl-ams') return 'nl-ams';
+	if (normalized === 'waw' || normalized === 'pl-waw') return 'pl-waw';
+	return DEFAULT_REGION;
 };
 
 export const getEmailConfig = (): EmailConfigResult => {
-  if (cachedConfig) {
-    return { ok: true, config: cachedConfig };
-  }
-
-  const accessKey =
-    process.env.SCALEWAY_ACCESS_KEY || process.env.SCALEWAY_ACCESS_KEY_QUEUE;
-  const secretKey =
-    process.env.SCALEWAY_SECRET_KEY || process.env.SCALEWAY_SECRET_KEY_QUEUE;
-  const projectId = process.env.SCALEWAY_PROJECT_ID;
-
-  if (!accessKey || !secretKey || !projectId) {
-    return {
-      ok: false,
-      errorMessage:
-        'Email service is not configured. Please contact us directly at contact@contractspec.io.',
-    };
-  }
-
-  const region = mapRegion(process.env.SCALEWAY_REGION);
-
-  cachedConfig = {
-    accessKey,
-    secretKey,
-    projectId,
-    region,
-    defaultZone: `${region}-1`,
-    from: {
-      email: process.env.SCALEWAY_EMAIL_FROM_EMAIL ?? DEFAULT_FROM.email,
-      name: process.env.SCALEWAY_EMAIL_FROM_NAME ?? DEFAULT_FROM.name,
-    },
-    teamInbox: {
-      email: process.env.SCALEWAY_EMAIL_TEAM_EMAIL ?? DEFAULT_TEAM_INBOX.email,
-      name: process.env.SCALEWAY_EMAIL_TEAM_NAME ?? DEFAULT_TEAM_INBOX.name,
-    },
-  };
-
-  return { ok: true, config: cachedConfig };
+	if (cachedConfig) {
+		return { ok: true, config: cachedConfig };
+	}
+
+	const accessKey =
+		process.env.SCALEWAY_ACCESS_KEY || process.env.SCALEWAY_ACCESS_KEY_QUEUE;
+	const secretKey =
+		process.env.SCALEWAY_SECRET_KEY || process.env.SCALEWAY_SECRET_KEY_QUEUE;
+	const projectId = process.env.SCALEWAY_PROJECT_ID;
+
+	if (!accessKey || !secretKey || !projectId) {
+		return {
+			ok: false,
+			errorMessage:
+				'Email service is not configured. Please contact us directly at contact@contractspec.io.',
+		};
+	}
+
+	const region = mapRegion(process.env.SCALEWAY_REGION);
+
+	cachedConfig = {
+		accessKey,
+		secretKey,
+		projectId,
+		region,
+		defaultZone: `${region}-1`,
+		from: {
+			email: process.env.SCALEWAY_EMAIL_FROM_EMAIL ?? DEFAULT_FROM.email,
+			name: process.env.SCALEWAY_EMAIL_FROM_NAME ?? DEFAULT_FROM.name,
+		},
+		teamInbox: {
+			email: process.env.SCALEWAY_EMAIL_TEAM_EMAIL ?? DEFAULT_TEAM_INBOX.email,
+			name: process.env.SCALEWAY_EMAIL_TEAM_NAME ?? DEFAULT_TEAM_INBOX.name,
+		},
+	};
+
+	return { ok: true, config: cachedConfig };
 };
 
 const getTemClient = (config: EmailServiceConfig): EmailApi => {
-  if (cachedClient) {
-    return cachedClient;
-  }
-
-  const client = createClient({
-    accessKey: config.accessKey,
-    secretKey: config.secretKey,
-    defaultProjectId: config.projectId,
-    defaultRegion: config.region,
-    defaultZone: config.defaultZone,
-  });
-
-  cachedClient = apiFactory(client);
-  return cachedClient;
+	if (cachedClient) {
+		return cachedClient;
+	}
+
+	const client = createClient({
+		accessKey: config.accessKey,
+		secretKey: config.secretKey,
+		defaultProjectId: config.projectId,
+		defaultRegion: config.region,
+		defaultZone: config.defaultZone,
+	});
+
+	cachedClient = apiFactory(client);
+	return cachedClient;
 };
 
 export const sendEmail = async (
-  config: EmailServiceConfig,
-  request: SendEmailRequest
+	config: EmailServiceConfig,
+	request: SendEmailRequest
 ): Promise<EmailSendOutcome> => {
-  try {
-    const client = getTemClient(config);
-
-    await client.createEmail({
-      region: config.region,
-      projectId: config.projectId,
-      from: config.from,
-      to: request.to,
-      subject: request.subject,
-      text: request.text,
-      html: request.html || request.text,
-      additionalHeaders: request.replyTo
-        ? [{ key: 'Reply-To', value: request.replyTo }]
-        : undefined,
-    });
-
-    return { success: true };
-  } catch (error) {
-    new Logger().error('scaleway_tem_email_send_failed', {
-      context: request.context ?? 'email',
-      error: error instanceof Error ? error.message : error,
-    });
-    return {
-      success: false,
-      error,
-      errorMessage: 'Failed to send email via Scaleway.',
-    };
-  }
+	try {
+		const client = getTemClient(config);
+
+		await client.createEmail({
+			region: config.region,
+			projectId: config.projectId,
+			from: config.from,
+			to: request.to,
+			subject: request.subject,
+			text: request.text,
+			html: request.html || request.text,
+			additionalHeaders: request.replyTo
+				? [{ key: 'Reply-To', value: request.replyTo }]
+				: undefined,
+		});
+
+		return { success: true };
+	} catch (error) {
+		new Logger().error('scaleway_tem_email_send_failed', {
+			context: request.context ?? 'email',
+			error: error instanceof Error ? error.message : error,
+		});
+		return {
+			success: false,
+			error,
+			errorMessage: 'Failed to send email via Scaleway.',
+		};
+	}
 };
 
 export const __internal = {
-  resetCaches() {
-    cachedClient = null;
-    cachedConfig = null;
-    apiFactory = (client: ReturnType<typeof createClient>) =>
-      new Temv1alpha1.API(client);
-  },
-  setApiFactory(
-    factory: (client: ReturnType<typeof createClient>) => EmailApi
-  ) {
-    apiFactory = factory;
-  },
-  setClient(client: EmailApi) {
-    cachedClient = client;
-  },
+	resetCaches() {
+		cachedClient = null;
+		cachedConfig = null;
+		apiFactory = (client: ReturnType<typeof createClient>) =>
+			new Temv1alpha1.API(client);
+	},
+	setApiFactory(
+		factory: (client: ReturnType<typeof createClient>) => EmailApi
+	) {
+		apiFactory = factory;
+	},
+	setClient(client: EmailApi) {
+		cachedClient = client;
+	},
 };