@buenojs/bueno 0.8.5 → 0.8.7

package/dist/security/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Security Primitives
+ *
+ * Provides password hashing, JWT handling, CSRF protection,
+ * and authentication middleware using Bun's built-in capabilities.
+ */
+import type { Middleware } from "../middleware";
+export interface PasswordOptions {
+    algorithm?: "argon2id" | "bcrypt";
+    cost?: number;
+}
+export declare const Password: {
+    /**
+     * Hash a password using Bun's built-in password hashing
+     */
+    hash(password: string, options?: PasswordOptions): Promise<string>;
+    /**
+     * Verify a password against a hash
+     */
+    verify(password: string, hash: string): Promise<boolean>;
+    /**
+     * Check if a hash needs rehashing (e.g., algorithm upgrade)
+     */
+    needsRehash(hash: string, options?: PasswordOptions): boolean;
+};
+export interface JWTOptions {
+    expiresIn?: number | string;
+    issuer?: string;
+    audience?: string;
+}
+export interface JWTPayload {
+    [key: string]: unknown;
+    iat?: number;
+    exp?: number;
+    iss?: string;
+    aud?: string;
+}
+export declare class JWT {
+    private secret;
+    private options;
+    constructor(secret: string, options?: JWTOptions);
+    /**
+     * Sign a payload and create a JWT
+     */
+    sign(payload: JWTPayload): Promise<string>;
+    /**
+     * Verify and decode a JWT
+     */
+    verify(token: string): Promise<JWTPayload | null>;
+    /**
+     * Decode token without verification (for debugging)
+     */
+    decode(token: string): JWTPayload | null;
+    /**
+     * Parse expiry string to seconds
+     */
+    private parseExpiry;
+    /**
+     * Create JWT token manually
+     */
+    private createToken;
+    /**
+     * Decode and verify token
+     */
+    private decodeToken;
+    /**
+     * Decode token without verification
+     */
+    private decodeTokenUnsafe;
+    /**
+     * Sign data using HMAC-SHA256
+     */
+    private signData;
+    /**
+     * Base64URL encode
+     */
+    private base64UrlEncode;
+    /**
+     * Base64URL decode
+     */
+    private base64UrlDecode;
+}
+export declare const CSRF: {
+    /**
+     * Generate a CSRF token
+     */
+    generate(): string;
+    /**
+     * Get the secret for a token (for cookie-based validation)
+     */
+    getSecret(): string;
+    /**
+     * Verify a CSRF token against a secret
+     */
+    verify(token: string, secret: string): boolean;
+    /**
+     * Create CSRF middleware
+     */
+    middleware(): Middleware;
+};
+export interface AuthMiddlewareOptions {
+    jwt: JWT;
+    header?: string;
+    prefix?: string;
+    skipPaths?: string[];
+}
+/**
+ * Create authentication middleware
+ */
+export declare function createAuthMiddleware(options: AuthMiddlewareOptions): Middleware;
+export interface RBACOptions {
+    getUserRoles: (userId: string | number) => Promise<string[]>;
+}
+/**
+ * Create RBAC middleware
+ */
+export declare function createRBACMiddleware(options: RBACOptions): (roles: string[]) => Middleware;
+export interface APIKeyOptions {
+    validateKey: (apiKey: string) => Promise<boolean>;
+    header?: string;
+}
+/**
+ * Create API key authentication middleware
+ */
+export declare function createAPIKeyMiddleware(options: APIKeyOptions): Middleware;
+//# sourceMappingURL=index.d.ts.map

package/dist/security/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,MAAM,WAAW,eAAe;IAC/B,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,QAAQ;IACpB;;OAEG;mBACkB,MAAM,YAAY,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxE;;OAEG;qBACoB,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D;;OAEG;sBACe,MAAM,YAAY,eAAe,GAAG,OAAO;CAuB7D,CAAC;AAIF,MAAM,WAAW,UAAU;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,GAAG;IACf,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAa;gBAEhB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe;IAKpD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAgChD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmBvD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;YACW,WAAW;IAiBzB;;OAEG;YACW,WAAW;IAmBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;YACW,QAAQ;IAmBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,eAAe;CAMvB;AAID,eAAO,MAAM,IAAI;IAChB;;OAEG;gBACS,MAAM;IAIlB;;OAEG;iBACU,MAAM;IAInB;;OAEG;kBACW,MAAM,UAAU,MAAM,GAAG,OAAO;IAK9C;;OAEG;kBACW,UAAU;CAiBxB,CAAC;AAIF,MAAM,WAAW,qBAAqB;IACrC,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,qBAAqB,GAC5B,UAAU,CAwCZ;AAID,MAAM,WAAW,WAAW;IAC3B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,WAAW,GAClB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,UAAU,CAuBjC;AAID,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,CAkBzE"}

package/dist/ssg/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Static Site Generation (SSG) Module
+ *
+ * Provides markdown-to-HTML conversion with frontmatter support,
+ * template system, and static site generation capabilities.
+ */
+import { Router } from "../router";
+export interface Frontmatter {
+    title?: string;
+    description?: string;
+    layout?: string;
+    date?: string;
+    slug?: string;
+    [key: string]: unknown;
+}
+export interface Page {
+    path: string;
+    content: string;
+    html: string;
+    frontmatter: Frontmatter;
+    raw: string;
+}
+export interface SSGConfig {
+    contentDir: string;
+    outputDir: string;
+    publicDir?: string;
+    layoutsDir?: string;
+    defaultLayout?: string;
+    baseUrl?: string;
+    minify?: boolean;
+}
+export interface LayoutContext {
+    title?: string;
+    description?: string;
+    content: string;
+    page: Page;
+    site: SiteConfig;
+    [key: string]: unknown;
+}
+export interface SiteConfig {
+    title: string;
+    description: string;
+    baseUrl: string;
+    [key: string]: unknown;
+}
+declare function parseFrontmatter(content: string): {
+    frontmatter: Frontmatter;
+    body: string;
+};
+declare function parseMarkdown(markdown: string): string;
+export declare class SSG {
+    private config;
+    private pages;
+    private layouts;
+    private siteConfig;
+    private router;
+    constructor(config: SSGConfig, siteConfig?: Partial<SiteConfig>);
+    private registerDefaultLayouts;
+    registerLayout(name: string, render: (ctx: LayoutContext) => string): void;
+    loadContent(): Promise<void>;
+    private scanDirectory;
+    private processFile;
+    renderPage(page: Page): string;
+    build(): Promise<void>;
+    private copyPublicDir;
+    createRouter(): Router;
+    serve(port?: number): Promise<void>;
+    getPages(): Page[];
+    getPage(path: string): Page | undefined;
+}
+export declare function createSSG(config: SSGConfig, siteConfig?: Partial<SiteConfig>): SSG;
+export { parseMarkdown, parseFrontmatter };
+//# sourceMappingURL=index.d.ts.map

package/dist/ssg/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssg/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,SAAS;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAkBD,iBAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACb,CAqCA;AA6FD,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsI/C;AAED,qBAAa,GAAG;IACf,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAA0D;IACzE,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IAa/D,OAAO,CAAC,sBAAsB;IAiE9B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,IAAI;IAIpE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBpB,aAAa;YAYb,WAAW;IAiCzB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAyBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA4Bd,aAAa;IAqB3B,YAAY,IAAI,MAAM;IAyBhB,KAAK,CAAC,IAAI,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BvC,QAAQ,IAAI,IAAI,EAAE;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;CAGvC;AAED,wBAAgB,SAAS,CACxB,MAAM,EAAE,SAAS,EACjB,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAC9B,GAAG,CAEL;AAED,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Storage Layer
+ *
+ * Unified interface over Bun.s3 for S3-compatible storage with local filesystem fallback.
+ * Uses Bun 1.3+ native S3 client for cloud storage.
+ */
+export interface StorageConfig {
+    driver?: "s3" | "local";
+    bucket?: string;
+    region?: string;
+    endpoint?: string;
+    localPath?: string;
+}
+export interface UploadOptions {
+    key: string;
+    body: string | Buffer | ArrayBuffer | Blob | File;
+    contentType?: string;
+}
+export interface DownloadOptions {
+    key: string;
+}
+export interface PresignedURLOptions {
+    key: string;
+    expiresIn?: number;
+    method?: "GET" | "PUT";
+}
+export interface FileInfo {
+    key: string;
+    size: number;
+    lastModified?: Date;
+}
+export interface ListOptions {
+    prefix?: string;
+}
+export interface ListResult {
+    files: FileInfo[];
+    directories: string[];
+}
+export declare class Storage {
+    private driver;
+    private s3Storage;
+    private localStorage;
+    private _isConnected;
+    constructor(config?: StorageConfig);
+    connect(): Promise<void>;
+    get isConnected(): boolean;
+    getDriver(): "s3" | "local";
+    upload(options: UploadOptions): Promise<{
+        key: string;
+    }>;
+    download(options: DownloadOptions): Promise<Blob>;
+    downloadText(key: string): Promise<string>;
+    downloadBuffer(key: string): Promise<ArrayBuffer>;
+    stream(key: string): Promise<ReadableStream<Uint8Array>>;
+    delete(key: string): Promise<void>;
+    deleteMany(keys: string[]): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    info(key: string): Promise<FileInfo | null>;
+    copy(sourceKey: string, destKey: string): Promise<void>;
+    move(sourceKey: string, destKey: string): Promise<void>;
+    list(options?: ListOptions): Promise<ListResult>;
+    getPresignedUrl(options: PresignedURLOptions): string;
+    getPublicUrl(key: string): string;
+    uploadFile(localPath: string, key: string): Promise<{
+        key: string;
+    }>;
+}
+export interface SecretOptions {
+    service: string;
+    name: string;
+}
+export interface SetSecretOptions extends SecretOptions {
+    value: string;
+    allowUnrestrictedAccess?: boolean;
+}
+export declare const Secrets: {
+    /**
+     * Get a secret from OS credential storage
+     */
+    get(options: SecretOptions): Promise<string | null>;
+    /**
+     * Store a secret in OS credential storage
+     */
+    set(options: SetSecretOptions): Promise<void>;
+    /**
+     * Delete a secret from OS credential storage
+     */
+    delete(options: SecretOptions): Promise<void>;
+    /**
+     * Get a secret or throw if not found
+     */
+    getOrThrow(options: SecretOptions): Promise<string>;
+    /**
+     * Get a secret or use a default value
+     */
+    getOrDefault(options: SecretOptions, defaultValue: string): Promise<string>;
+};
+export declare function createStorage(config?: StorageConfig): Storage;
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,aAAa;IAC7B,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AA8MD,qBAAa,OAAO;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,GAAE,aAAkB;IAUhC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,SAAS,IAAI,IAAI,GAAG,OAAO;IAIrB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAUxD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKjD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAKxD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAU3C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAUtD,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAOrD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAU3B,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAS1E;AAID,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,eAAO,MAAM,OAAO;IACnB;;OAEG;iBACgB,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzD;;OAEG;iBACgB,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;OAEG;oBACmB,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;OAEG;wBACuB,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzD;;OAEG;0BAEO,aAAa,gBACR,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;CAIlB,CAAC;AAIF,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAE7D"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,376 @@
+/**
+ * OpenTelemetry OTLP Trace Exporter
+ *
+ * Provides distributed tracing with OpenTelemetry Protocol (OTLP) export.
+ * Part of Layer 7 (Testing & Observability) implementation.
+ */
+/**
+ * Span kind enumeration
+ */
+export type SpanKind = "server" | "client" | "producer" | "consumer" | "internal";
+/**
+ * Span status code
+ */
+export type StatusCode = "ok" | "error" | "unset";
+/**
+ * Event attached to a span
+ */
+export interface SpanEvent {
+    /** Event name */
+    name: string;
+    /** Event timestamp in nanoseconds */
+    timestamp: number;
+    /** Event attributes */
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Span status
+ */
+export interface SpanStatus {
+    /** Status code */
+    code: StatusCode;
+    /** Optional status message */
+    message?: string;
+}
+/**
+ * Span represents a unit of work in distributed tracing
+ */
+export interface Span {
+    /** Unique trace identifier (32 hex characters) */
+    traceId: string;
+    /** Unique span identifier (16 hex characters) */
+    spanId: string;
+    /** Parent span identifier if this is a child span */
+    parentSpanId?: string;
+    /** Span name (operation name) */
+    name: string;
+    /** Span kind */
+    kind: SpanKind;
+    /** Start time in nanoseconds */
+    startTime: number;
+    /** End time in nanoseconds */
+    endTime?: number;
+    /** Duration in nanoseconds */
+    duration?: number;
+    /** Span attributes */
+    attributes: Record<string, string | number | boolean>;
+    /** Events recorded during the span */
+    events: SpanEvent[];
+    /** Span status */
+    status: SpanStatus;
+    /** Whether the span has ended */
+    ended: boolean;
+}
+/**
+ * Options for starting a new span
+ */
+export interface SpanOptions {
+    /** Span kind */
+    kind?: SpanKind;
+    /** Parent span (if any) */
+    parent?: Span;
+    /** Initial attributes */
+    attributes?: Record<string, string | number | boolean>;
+    /** Links to other spans */
+    links?: Array<{
+        traceId: string;
+        spanId: string;
+        attributes?: Record<string, string | number | boolean>;
+    }>;
+    /** Start time in nanoseconds (defaults to current time) */
+    startTime?: number;
+}
+/**
+ * OTLP Exporter options
+ */
+export interface OTLPExporterOptions {
+    /** OTLP endpoint URL (e.g., http://localhost:4318/v1/traces) */
+    endpoint: string;
+    /** Additional headers to send with requests */
+    headers?: Record<string, string>;
+    /** Export interval in milliseconds (default: 5000) */
+    exportInterval?: number;
+    /** Maximum batch size before forcing export (default: 100) */
+    maxBatchSize?: number;
+    /** Maximum retry attempts on failure (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in milliseconds (default: 1000) */
+    retryDelay?: number;
+    /** Timeout for export requests in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Sampler type
+ */
+export type SamplerType = "always" | "never" | "probabilistic";
+/**
+ * Tracer options
+ */
+export interface TracerOptions {
+    /** OTLP exporter instance */
+    exporter?: OTLPExporter;
+    /** Sampling strategy (default: "always") */
+    sampler?: SamplerType;
+    /** Probability for probabilistic sampling (0.0 to 1.0) */
+    probability?: number;
+    /** Service name for resource attributes */
+    serviceName?: string;
+    /** Additional resource attributes */
+    resourceAttributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Trace context for propagation
+ */
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    traceFlags: number;
+    traceState?: string;
+}
+/**
+ * Generate a random trace ID (32 hex characters / 16 bytes)
+ */
+export declare function generateTraceId(): string;
+/**
+ * Generate a random span ID (16 hex characters / 8 bytes)
+ */
+export declare function generateSpanId(): string;
+/**
+ * Get current time in nanoseconds using Bun.nanoseconds()
+ */
+export declare function nowNanoseconds(): number;
+/**
+ * OTLP HTTP Trace Exporter
+ *
+ * Exports traces to an OTLP-compatible endpoint using HTTP/JSON.
+ */
+export declare class OTLPExporter {
+    private endpoint;
+    private headers;
+    private exportInterval;
+    private maxBatchSize;
+    private maxRetries;
+    private retryDelay;
+    private timeout;
+    private pendingSpans;
+    private exportTimer;
+    private isShuttingDown;
+    private serviceName;
+    private resourceAttributes;
+    constructor(options: OTLPExporterOptions);
+    /**
+     * Set service name for resource attributes
+     */
+    setServiceName(name: string): void;
+    /**
+     * Set resource attributes
+     */
+    setResourceAttributes(attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Start periodic export
+     */
+    start(): void;
+    /**
+     * Stop periodic export
+     */
+    stop(): void;
+    /**
+     * Add a span to the pending batch
+     */
+    addSpan(span: Span): void;
+    /**
+     * Export spans to OTLP endpoint
+     */
+    export(spans: Span[]): Promise<boolean>;
+    /**
+     * Flush all pending spans
+     */
+    flush(): Promise<void>;
+    /**
+     * Close the exporter and flush remaining spans
+     */
+    close(): Promise<void>;
+    /**
+     * Build OTLP export request from spans
+     */
+    private buildExportRequest;
+    /**
+     * Delay helper
+     */
+    private delay;
+}
+/**
+ * Tracer creates and manages spans for distributed tracing
+ */
+export declare class Tracer {
+    private serviceName;
+    private exporter?;
+    private sampler;
+    private probability;
+    private resourceAttributes;
+    private currentSpan;
+    private spanStack;
+    constructor(options?: TracerOptions);
+    /**
+     * Check if a span should be sampled
+     */
+    private shouldSample;
+    /**
+     * Start a new span
+     */
+    startSpan(name: string, options?: SpanOptions): Span;
+    /**
+     * End a span
+     */
+    endSpan(span: Span, endTime?: number): void;
+    /**
+     * Get the current active span
+     */
+    getCurrentSpan(): Span | null;
+    /**
+     * Run a function within span context
+     */
+    withSpan<T>(name: string, fn: (span: Span) => T | Promise<T>, options?: SpanOptions): Promise<T>;
+    /**
+     * Add an event to a span
+     */
+    addEvent(span: Span, name: string, attributes?: Record<string, string | number | boolean>): void;
+    /**
+     * Set an attribute on a span
+     */
+    setAttribute(span: Span, key: string, value: string | number | boolean): void;
+    /**
+     * Set multiple attributes on a span
+     */
+    setAttributes(span: Span, attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Set span status
+     */
+    setStatus(span: Span, code: StatusCode, message?: string): void;
+    /**
+     * Record an error on a span
+     */
+    setError(span: Span, error: Error): void;
+    /**
+     * Update span name
+     */
+    updateName(span: Span, name: string): void;
+    /**
+     * Inject trace context into a carrier (for W3C TraceContext propagation)
+     */
+    injectContext(carrier: Record<string, string>, span?: Span): void;
+    /**
+     * Extract trace context from a carrier (for W3C TraceContext propagation)
+     */
+    extractContext(carrier: Record<string, string>): TraceContext | null;
+    /**
+     * Create a child span from extracted context
+     */
+    startSpanFromContext(name: string, context: TraceContext, options?: SpanOptions): Span;
+    /**
+     * Flush pending spans
+     */
+    flush(): Promise<void>;
+    /**
+     * Close the tracer
+     */
+    close(): Promise<void>;
+    /**
+     * Create a no-op span (not sampled)
+     */
+    private createNoopSpan;
+}
+/**
+ * Create a configured tracer
+ */
+export declare function createTracer(serviceName: string, options?: Omit<TracerOptions, "serviceName">): Tracer;
+/**
+ * Request context for middleware
+ */
+interface RequestContext {
+    method: string;
+    path: string;
+    url: URL;
+    headers: Record<string, string>;
+    getHeader: (name: string) => string | undefined;
+    setHeader: (name: string, value: string) => void;
+    status?: number;
+}
+/**
+ * Response context for middleware
+ */
+interface ResponseContext {
+    status: number;
+    headers?: Record<string, string>;
+}
+/**
+ * Create middleware for automatic HTTP tracing
+ */
+export declare function traceMiddleware(tracer: Tracer): (ctx: RequestContext, next: () => Promise<ResponseContext>) => Promise<ResponseContext>;
+/**
+ * Database interface for tracing
+ */
+interface TracedDatabase {
+    query?: (sql: string, params?: unknown[]) => Promise<unknown>;
+    execute?: (sql: string, params?: unknown[]) => Promise<unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Wrap database with tracing
+ */
+export declare function traceDatabase(tracer: Tracer, db: TracedDatabase, system?: string): TracedDatabase;
+/**
+ * Options for traced fetch
+ */
+interface TracedFetchOptions extends RequestInit {
+    /** Span to use as parent */
+    parentSpan?: Span;
+    /** Additional attributes to add to span */
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Create a traced fetch function
+ */
+export declare function createTracedFetch(tracer: Tracer): (url: string | URL, options?: TracedFetchOptions) => Promise<Response>;
+/**
+ * Span builder for fluent API
+ */
+export declare class SpanBuilder {
+    private span;
+    private tracer;
+    constructor(tracer: Tracer, name: string, options?: SpanOptions);
+    /**
+     * Set an attribute
+     */
+    setAttribute(key: string, value: string | number | boolean): this;
+    /**
+     * Set multiple attributes
+     */
+    setAttributes(attributes: Record<string, string | number | boolean>): this;
+    /**
+     * Add an event
+     */
+    addEvent(name: string, attributes?: Record<string, string | number | boolean>): this;
+    /**
+     * Set status
+     */
+    setStatus(code: StatusCode, message?: string): this;
+    /**
+     * Record error
+     */
+    setError(error: Error): this;
+    /**
+     * End the span
+     */
+    end(): Span;
+    /**
+     * Get the underlying span
+     */
+    getSpan(): Span;
+}
+/**
+ * Create a span builder
+ */
+export declare function span(tracer: Tracer, name: string, options?: SpanOptions): SpanBuilder;
+export {};
+//# sourceMappingURL=index.d.ts.map