appos 0.3.5-0 → 0.3.7-0

package/dist/exports/api/i18n.d.mts

@@ -1,34 +0,0 @@
-import { InitOptions, i18n, i18n as i18n$1 } from "i18next";
-
-//#region src/api/i18n.d.ts
-
-/**
- * i18n initialization options extending i18next's InitOptions.
- * Used for both server and client initialization.
- */
-interface I18nInitOptions extends InitOptions {}
-/**
- * Type-safe default options for i18n.
- * Apps should spread these and override as needed.
- */
-declare const defaultI18nOptions: {
-  readonly fallbackLng: "en";
-  readonly supportedLngs: readonly ["en"];
-  readonly defaultNS: "translation";
-  readonly ns: readonly ["translation"];
-  readonly interpolation: {
-    readonly escapeValue: false;
-  };
-  readonly react: {
-    readonly useSuspense: false;
-  };
-};
-/**
- * Initializes i18next for server-side with filesystem backend.
- *
- * @param opts - Initialization options for i18next.
- * @returns A promise that resolves to the initialized i18next instance.
- */
-declare function defineI18n(opts: I18nInitOptions): Promise<i18n>;
-//#endregion
-export { I18nInitOptions, defaultI18nOptions, defineI18n, type i18n$1 as i18n };

package/dist/exports/api/i18n.mjs

@@ -1,45 +0,0 @@
-import { LOCALES_DIR, PUBLIC_DIR } from "./constants.mjs";
-import { join } from "node:path";
-import { lstatSync, readdirSync, watch } from "node:fs";
-import { createInstance } from "i18next";
-import I18nextFsBackend from "i18next-fs-backend";
-import { initReactI18next } from "react-i18next";
-
-//#region src/api/i18n.ts
-/**
-* Type-safe default options for i18n.
-* Apps should spread these and override as needed.
-*/
-const defaultI18nOptions = {
-	fallbackLng: "en",
-	supportedLngs: ["en"],
-	defaultNS: "translation",
-	ns: ["translation"],
-	interpolation: { escapeValue: false },
-	react: { useSuspense: false }
-};
-/**
-* Initializes i18next for server-side with filesystem backend.
-*
-* @param opts - Initialization options for i18next.
-* @returns A promise that resolves to the initialized i18next instance.
-*/
-async function defineI18n(opts) {
-	const localesDir = join(PUBLIC_DIR, LOCALES_DIR);
-	const i18n$1 = createInstance();
-	if (process.env.NODE_ENV !== "production" && !process.env.VITEST && !process.env.CI) watch(localesDir, { recursive: true }, async (event, fn) => {
-		await i18n$1.reloadResources(opts.supportedLngs || []);
-	}).unref();
-	await i18n$1.use(I18nextFsBackend).use(initReactI18next).init({
-		...opts,
-		backend: { loadPath: `${localesDir}/{{lng}}/{{ns}}.json` },
-		initAsync: false,
-		preload: readdirSync(localesDir).filter((fileName) => {
-			return lstatSync(join(localesDir, fileName)).isDirectory();
-		})
-	});
-	return i18n$1;
-}
-
-//#endregion
-export { defaultI18nOptions, defineI18n };

package/dist/exports/api/instrumentation.d.mts

@@ -1,7 +0,0 @@
-export * from "@opentelemetry/api";
-
-//#region src/instrumentation.d.ts
-
-import * as import__opentelemetry_api from "@opentelemetry/api";
-//#endregion
-export { import__opentelemetry_api as instrumentation_d_exports };

package/dist/exports/api/instrumentation.mjs

@@ -1,40 +0,0 @@
-import { __reExport } from "./_virtual/rolldown_runtime.mjs";
-import { register } from "node:module";
-import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { PinoInstrumentation } from "@opentelemetry/instrumentation-pino";
-import { resourceFromAttributes } from "@opentelemetry/resources";
-import { NodeSDK } from "@opentelemetry/sdk-node";
-import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-node";
-import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
-
-export * from "@opentelemetry/api"
-
-//#region src/instrumentation.ts
-var instrumentation_exports = {};
-import * as import__opentelemetry_api from "@opentelemetry/api";
-__reExport(instrumentation_exports, import__opentelemetry_api);
-register("@opentelemetry/instrumentation/hook.mjs", import.meta.url);
-const service = {
-	name: process.env.APP_NAME || "appos",
-	version: process.env.APP_VERSION || "development"
-};
-new NodeSDK({
-	resource: resourceFromAttributes({
-		[ATTR_SERVICE_NAME]: service.name,
-		[ATTR_SERVICE_VERSION]: service.version
-	}),
-	spanProcessors: [new BatchSpanProcessor(new OTLPTraceExporter({
-		url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || "http://localhost:4318/v1/traces",
-		headers: process.env.OTEL_EXPORTER_OTLP_HEADERS ? JSON.parse(process.env.OTEL_EXPORTER_OTLP_HEADERS) : void 0
-	}))],
-	instrumentations: [getNodeAutoInstrumentations({
-		"@opentelemetry/instrumentation-fs": { enabled: false },
-		"@opentelemetry/instrumentation-dns": { enabled: false }
-	}), new PinoInstrumentation({ logHook: (_span, record) => {
-		record["service.name"] = service.name;
-	} })]
-}).start();
-
-//#endregion
-export { instrumentation_exports };

package/dist/exports/api/logger.d.mts

@@ -1,21 +0,0 @@
-import pino, { LoggerOptions } from "pino";
-
-//#region src/api/logger.d.ts
-
-/**
- * Extended logger options with OpenTelemetry support.
- */
-interface DefineLoggerOptions extends LoggerOptions {}
-/**
- * The logger instance type.
- */
-type Logger = Awaited<ReturnType<typeof defineLogger>>;
-/**
- * Define the logger instance.
- *
- * @param opts - The options.
- * @returns The logger.
- */
-declare function defineLogger(opts: DefineLoggerOptions): Promise<pino.Logger<never, boolean>>;
-//#endregion
-export { DefineLoggerOptions, Logger, defineLogger };

package/dist/exports/api/logger.mjs

@@ -1,26 +0,0 @@
-import pino from "pino";
-import pinoPretty from "pino-pretty";
-
-//#region src/api/logger.ts
-/**
-* Define the logger instance.
-*
-* @param opts - The options.
-* @returns The logger.
-*/
-async function defineLogger(opts) {
-	const transports = [];
-	const commonOpts = {
-		level: opts.level || "info",
-		redact: opts.redact || [],
-		...transports.length > 0 && { transport: transports.length === 1 ? transports[0] : { targets: transports } }
-	};
-	try {
-		return pino(commonOpts, process.env.NODE_ENV !== "production" && !process.env.VITEST ? pinoPretty() : void 0);
-	} catch (_) {
-		return pino(commonOpts);
-	}
-}
-
-//#endregion
-export { defineLogger };

package/dist/exports/api/mailer.d.mts

@@ -1,70 +0,0 @@
-import Mail from "nodemailer/lib/mailer/index.ts";
-import { JSX } from "react";
-
-//#region src/api/mailer.d.ts
-
-/**
- * The mailer type.
- */
-type Mailer = ReturnType<typeof defineMailer>;
-/**
- * The mailer payload type with React component.
- */
-type MailerPayloadReact = Omit<Mail.Options, "from" | "html" | "text"> & {
-  /**
-   * The email address to send the email from.
-   */
-  from?: string;
-  /**
-   * The React component to render as the email body.
-   */
-  react: JSX.Element;
-};
-/**
- * The mailer payload type with direct HTML and text.
- */
-type MailerPayloadHtml = Omit<Mail.Options, "from"> & {
-  /**
-   * The email address to send the email from.
-   */
-  from?: string;
-  /**
-   * The HTML content of the email.
-   */
-  html: string;
-  /**
-   * The plain text content of the email.
-   */
-  text: string;
-};
-/**
- * The mailer payload type - supports either React component or direct HTML+text.
- */
-type MailerPayload = MailerPayloadReact | MailerPayloadHtml;
-/**
- * Define the options for the mailer.
- */
-interface DefineMailerOptions {
-  /**
-   * The default email address to use as the sender.
-   */
-  from: string;
-  /**
-   * The SMTP URL to use for sending emails.
-   */
-  smtpUrl: string;
-}
-/**
- * Define the mailer.
- *
- * @param env - The environment variables.
- * @returns The mailer.
- */
-declare function defineMailer({
-  from,
-  smtpUrl
-}: DefineMailerOptions): {
-  send(payload: MailerPayload): Promise<void>;
-};
-//#endregion
-export { DefineMailerOptions, Mailer, MailerPayload, MailerPayloadHtml, MailerPayloadReact, defineMailer };

package/dist/exports/api/mailer.mjs

@@ -1,37 +0,0 @@
-import { render } from "@react-email/render";
-import { createTransport } from "nodemailer";
-
-//#region src/api/mailer.ts
-/**
-* Define the mailer.
-*
-* @param env - The environment variables.
-* @returns The mailer.
-*/
-function defineMailer({ from, smtpUrl }) {
-	const mailer = createTransport({ url: smtpUrl });
-	return { async send(payload) {
-		let html;
-		let text;
-		let mailOptions;
-		if ("react" in payload) {
-			[html, text] = await Promise.all([render(payload.react), render(payload.react, { plainText: true })]);
-			const { react: _, ...rest } = payload;
-			mailOptions = rest;
-		} else {
-			html = payload.html;
-			text = payload.text;
-			const { html: _, text: __, ...rest } = payload;
-			mailOptions = rest;
-		}
-		await mailer.sendMail({
-			from: payload.from || from,
-			...mailOptions,
-			html,
-			text
-		});
-	} };
-}
-
-//#endregion
-export { defineMailer };

package/dist/exports/api/middleware/request-logger.d.mts

@@ -1,24 +0,0 @@
-import "../logger.mjs";
-import { RequestHandler } from "ultimate-express";
-
-//#region src/api/middleware/request-logger.d.ts
-
-/**
- * Metadata about the HTTP request.
- */
-interface RequestMetadata {
-  /**
-   * Client's IP address from X-Forwarded-For or RemoteAddr.
-   */
-  ipAddress: string;
-  /**
-   * Client's User-Agent header.
-   */
-  userAgent: string;
-  /**
-   * Client IP's country from CF-IPCountry header.
-   */
-  country: string;
-}
-//#endregion
-export { RequestMetadata };

package/dist/exports/api/middleware.d.mts

@@ -1,39 +0,0 @@
-import { AppContainer } from "./container.mjs";
-import { Express, RequestHandler } from "ultimate-express";
-
-//#region src/api/middleware.d.ts
-interface Middleware {
-  name: string | null;
-  handler: (container: AppContainer) => RequestHandler;
-}
-/**
- * Defines a user middleware loaded from api/middleware/ directory.
- *
- * Use numeric prefixes (000_, 001_, etc.) to control load order.
- *
- * @example
- * // api/middleware/000_custom-auth.ts
- * export default defineMiddleware({
- *   handler: (container) => (req, res, next) => {
- *     // Custom logic using container
- *     next();
- *   },
- * });
- */
-declare function defineMiddleware(config: {
-  name?: string;
-  handler: (container: AppContainer) => RequestHandler;
-}): Middleware;
-/**
- * Loads user middleware from a directory and registers them with the app.
- *
- * Middleware files are loaded in alphabetical order by filename.
- * Use numeric prefixes (000_, 001_, etc.) to control the load order.
- *
- * @param middlewareDir - The directory containing middleware files
- * @param container - The application container
- * @param app - The Express application instance
- */
-declare function loadMiddleware(middlewareDir: string, container: AppContainer, app: Express): Promise<void>;
-//#endregion
-export { Middleware, defineMiddleware, loadMiddleware };

package/dist/exports/api/middleware.mjs

@@ -1,73 +0,0 @@
-import { FILE_EXT } from "./constants.mjs";
-import { basename } from "node:path";
-import fs, { glob } from "node:fs/promises";
-import { camelCase } from "es-toolkit";
-
-//#region src/api/middleware.ts
-/**
-* Defines a user middleware loaded from api/middleware/ directory.
-*
-* Use numeric prefixes (000_, 001_, etc.) to control load order.
-*
-* @example
-* // api/middleware/000_custom-auth.ts
-* export default defineMiddleware({
-*   handler: (container) => (req, res, next) => {
-*     // Custom logic using container
-*     next();
-*   },
-* });
-*/
-function defineMiddleware(config) {
-	return {
-		name: config.name ?? null,
-		handler: config.handler
-	};
-}
-/**
-* Extracts middleware name from filename, removing numeric prefix.
-* "000_custom-auth.ts" -> "customAuth"
-*/
-function getMiddlewareName(filename) {
-	return camelCase(basename(filename, ".ts").replace(/^\d+_/, ""));
-}
-/**
-* Loads user middleware from a directory and registers them with the app.
-*
-* Middleware files are loaded in alphabetical order by filename.
-* Use numeric prefixes (000_, 001_, etc.) to control the load order.
-*
-* @param middlewareDir - The directory containing middleware files
-* @param container - The application container
-* @param app - The Express application instance
-*/
-async function loadMiddleware(middlewareDir, container, app) {
-	try {
-		await fs.access(middlewareDir);
-	} catch {
-		return;
-	}
-	const files = [];
-	for await (const file of glob(`${middlewareDir}/**/*.${FILE_EXT}`)) if (!file.endsWith(".test.ts") && !file.endsWith(".spec.ts") && !file.endsWith(".test.js") && !file.endsWith(".spec.js")) files.push(file);
-	files.sort((a, b) => basename(a).localeCompare(basename(b)));
-	for (const file of files) try {
-		const middleware = (await import(file)).default;
-		if (middleware && typeof middleware.handler === "function") {
-			const name = middleware.name ?? getMiddlewareName(file);
-			container.logger.debug({
-				name,
-				file
-			}, "Loading user middleware");
-			app.use(middleware.handler(container));
-		} else container.logger.warn({ file }, "Middleware file missing default export with handler function");
-	} catch (err) {
-		container.logger.error({
-			file,
-			error: err instanceof Error ? err.message : err
-		}, "Failed to load middleware");
-		throw err;
-	}
-}
-
-//#endregion
-export { defineMiddleware, loadMiddleware };