@blyp/core 0.1.2

package/types/frameworks/client.d.ts

@@ -0,0 +1,160 @@
+/// <reference lib="dom" />
+
+import type {
+  BlypErrorCode,
+  BlypErrorCodeDefinition,
+  BlypErrorLike,
+  ErrorLogLevel,
+  ErrorLoggerLike,
+  ParseErrorOptions,
+  ParseableErrorPayload,
+} from '../../dist/index';
+
+export interface ClientLogPageContext {
+  hash?: string;
+  pathname?: string;
+  search?: string;
+  url?: string;
+  title?: string;
+  referrer?: string;
+}
+
+export interface ClientLogBrowserContext {
+  userAgent?: string;
+  language?: string;
+  platform?: string;
+}
+
+export interface ClientLogDeviceContext {
+  runtime?: 'expo' | 'browser';
+  network?: {
+    type?: string;
+    isConnected?: boolean;
+    isInternetReachable?: boolean;
+  };
+}
+
+export type ClientLogLevel =
+  | 'debug'
+  | 'info'
+  | 'warning'
+  | 'error'
+  | 'critical'
+  | 'success'
+  | 'table';
+
+export interface ClientLogEvent {
+  type: 'client_log';
+  source: 'client';
+  id: string;
+  level: ClientLogLevel;
+  message: string;
+  data?: unknown;
+  bindings?: Record<string, unknown>;
+  clientTimestamp: string;
+  page?: ClientLogPageContext;
+  browser?: ClientLogBrowserContext;
+  device?: ClientLogDeviceContext;
+  session?: {
+    pageId?: string;
+    sessionId?: string;
+  };
+  metadata?: Record<string, unknown>;
+}
+
+export type RemoteDeliveryRuntime = 'browser' | 'expo';
+
+export type RemoteDeliveryTransport = 'fetch' | 'beacon';
+
+export type RemoteDeliveryFailureReason =
+  | 'offline'
+  | 'network_error'
+  | 'response_status'
+  | 'invalid_endpoint'
+  | 'missing_transport'
+  | 'queue_overflow';
+
+export interface RemoteDeliverySuccessContext {
+  runtime: RemoteDeliveryRuntime;
+  event: ClientLogEvent;
+  attempt: number;
+  status?: number;
+  transport: RemoteDeliveryTransport;
+}
+
+export interface RemoteDeliveryRetryContext {
+  runtime: RemoteDeliveryRuntime;
+  event: ClientLogEvent;
+  attempt: number;
+  retriesRemaining: number;
+  nextRetryAt: string;
+  reason: 'offline' | 'network_error' | 'response_status';
+  status?: number;
+  error?: string;
+}
+
+export interface RemoteDeliveryFailureContext {
+  runtime: RemoteDeliveryRuntime;
+  event: ClientLogEvent;
+  attempt: number;
+  reason: RemoteDeliveryFailureReason;
+  status?: number;
+  error?: string;
+}
+
+export interface RemoteDeliveryDropContext {
+  runtime: RemoteDeliveryRuntime;
+  droppedEvent: ClientLogEvent;
+  replacementEvent: ClientLogEvent;
+  maxQueueSize: number;
+  reason: 'queue_overflow';
+}
+
+export interface RemoteDeliveryConfig {
+  maxRetries?: number;
+  retryDelayMs?: number;
+  maxQueueSize?: number;
+  warnOnFailure?: boolean;
+  onSuccess?: (ctx: RemoteDeliverySuccessContext) => void;
+  onRetry?: (ctx: RemoteDeliveryRetryContext) => void;
+  onFailure?: (ctx: RemoteDeliveryFailureContext) => void;
+  onDrop?: (ctx: RemoteDeliveryDropContext) => void;
+}
+
+export interface ClientLoggerConfig {
+  endpoint?: string;
+  headers?: Record<string, string>;
+  credentials?: RequestCredentials;
+  localConsole?: boolean;
+  remoteSync?: boolean;
+  metadata?: Record<string, unknown> | (() => Record<string, unknown>);
+  delivery?: RemoteDeliveryConfig;
+}
+
+export interface ClientLogger {
+  success: (message: unknown, ...args: unknown[]) => void;
+  critical: (message: unknown, ...args: unknown[]) => void;
+  warning: (message: unknown, ...args: unknown[]) => void;
+  info: (message: unknown, ...args: unknown[]) => void;
+  debug: (message: unknown, ...args: unknown[]) => void;
+  error: (message: unknown, ...args: unknown[]) => void;
+  warn: (message: unknown, ...args: unknown[]) => void;
+  table: (message: string, data?: unknown) => void;
+  child: (bindings: Record<string, unknown>) => ClientLogger;
+}
+
+export declare function createClientLogger(config?: ClientLoggerConfig): ClientLogger;
+export declare const logger: ClientLogger;
+export type {
+  ClientLogDeviceContext,
+};
+
+export type {
+  BlypErrorCode,
+  BlypErrorCodeDefinition,
+  BlypErrorLike,
+  ErrorLogLevel,
+  ErrorLoggerLike,
+  ParseErrorOptions,
+  ParseableErrorPayload,
+};

package/types/frameworks/elysia.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/elysia';

package/types/frameworks/expo.d.ts

@@ -0,0 +1,50 @@
+import type {
+  ClientLogBrowserContext,
+  ClientLogDeviceContext,
+  ClientLogEvent,
+  ClientLogLevel,
+  ClientLogPageContext,
+  RemoteDeliveryConfig,
+  RemoteDeliveryDropContext,
+  RemoteDeliveryFailureContext,
+  RemoteDeliveryFailureReason,
+  RemoteDeliveryRetryContext,
+  RemoteDeliverySuccessContext,
+} from './client';
+
+export interface ExpoLoggerConfig {
+  endpoint: string;
+  headers?: Record<string, string>;
+  localConsole?: boolean;
+  remoteSync?: boolean;
+  metadata?: Record<string, unknown> | (() => Record<string, unknown>);
+  delivery?: RemoteDeliveryConfig;
+}
+
+export interface ExpoLogger {
+  success: (message: unknown, ...args: unknown[]) => void;
+  critical: (message: unknown, ...args: unknown[]) => void;
+  warning: (message: unknown, ...args: unknown[]) => void;
+  info: (message: unknown, ...args: unknown[]) => void;
+  debug: (message: unknown, ...args: unknown[]) => void;
+  error: (message: unknown, ...args: unknown[]) => void;
+  warn: (message: unknown, ...args: unknown[]) => void;
+  table: (message: string, data?: unknown) => void;
+  child: (bindings: Record<string, unknown>) => ExpoLogger;
+}
+
+export declare function createExpoLogger(config: ExpoLoggerConfig): ExpoLogger;
+
+export type {
+  ClientLogBrowserContext,
+  ClientLogDeviceContext,
+  ClientLogEvent,
+  ClientLogLevel,
+  ClientLogPageContext,
+  RemoteDeliveryConfig,
+  RemoteDeliveryDropContext,
+  RemoteDeliveryFailureContext,
+  RemoteDeliveryFailureReason,
+  RemoteDeliveryRetryContext,
+  RemoteDeliverySuccessContext,
+};

package/types/frameworks/express.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/express';

package/types/frameworks/fastify.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/fastify';

package/types/frameworks/hono.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/hono';

package/types/frameworks/nestjs.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/nestjs';

package/types/frameworks/nextjs.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/nextjs';

package/types/frameworks/standalone.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/standalone';

package/types/frameworks/sveltekit.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/sveltekit';

package/types/frameworks/tanstack-start.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/frameworks/tanstack-start';

package/types/frameworks/workers.d.ts

@@ -0,0 +1,115 @@
+export interface HttpRequestLog {
+  type: 'http_request' | 'http_error';
+  method: string;
+  url: string;
+  path: string;
+  statusCode: number;
+  responseTime: number;
+  timestamp: string;
+  ip?: string;
+  userAgent?: string;
+  referrer?: string;
+  requestId?: string;
+  error?: string;
+  stack?: string;
+  code?: string;
+  why?: string;
+  fix?: string;
+  link?: string;
+  details?: unknown;
+  [key: string]: unknown;
+}
+
+export interface WorkersLoggerConfig {
+  env?: Record<string, unknown>;
+  customProps?: (request: Request) => Record<string, unknown>;
+}
+
+export interface WorkersEmitOptions {
+  response?: Response | { status: number };
+  status?: number;
+  error?: unknown;
+}
+
+export type StructuredLogLevel =
+  | 'debug'
+  | 'info'
+  | 'warn'
+  | 'warning'
+  | 'error'
+  | 'success'
+  | 'critical'
+  | 'table';
+
+export interface StructuredLogError {
+  message: string;
+  code?: string | number;
+  type?: string;
+  stack?: string;
+  why?: string;
+  fix?: string;
+  link?: string;
+  details?: Record<string, unknown>;
+  cause?: unknown;
+}
+
+export interface StructuredLogEvent {
+  level: StructuredLogLevel;
+  message: string;
+  timestamp: string;
+  data?: unknown;
+}
+
+export interface StructuredLogPayload {
+  groupId: string;
+  timestamp: string;
+  level: StructuredLogLevel;
+  method?: string;
+  path?: string;
+  status?: number;
+  duration?: number;
+  events?: StructuredLogEvent[];
+  error?: StructuredLogError;
+  [key: string]: unknown;
+}
+
+export interface StructuredLogEmitOptions {
+  response?: Response | { status: number };
+  status?: number;
+  error?: unknown;
+  level?: StructuredLogLevel;
+  message?: string;
+}
+
+export interface StructuredLog {
+  set(fields: Record<string, unknown>): StructuredLog;
+  debug(message: unknown, ...args: unknown[]): StructuredLog;
+  info(message: unknown, ...args: unknown[]): StructuredLog;
+  warn(message: unknown, ...args: unknown[]): StructuredLog;
+  warning(message: unknown, ...args: unknown[]): StructuredLog;
+  error(message: unknown, ...args: unknown[]): StructuredLog;
+  success(message: unknown, ...args: unknown[]): StructuredLog;
+  critical(message: unknown, ...args: unknown[]): StructuredLog;
+  table(message: string, data?: unknown): StructuredLog;
+  emit(options?: StructuredLogEmitOptions): StructuredLogPayload;
+}
+
+export interface WorkersRequestLogger {
+  set(fields: Record<string, unknown>): WorkersRequestLogger;
+  emit(options?: WorkersEmitOptions): HttpRequestLog;
+  debug(message: unknown, ...args: unknown[]): void;
+  info(message: unknown, ...args: unknown[]): void;
+  warn(message: unknown, ...args: unknown[]): void;
+  warning(message: unknown, ...args: unknown[]): void;
+  error(message: unknown, ...args: unknown[]): void;
+  success(message: unknown, ...args: unknown[]): void;
+  critical(message: unknown, ...args: unknown[]): void;
+  table(message: string, data?: unknown): void;
+  createStructuredLog(
+    groupId: string,
+    initial?: Record<string, unknown>
+  ): StructuredLog;
+}
+
+export declare function initWorkersLogger(config?: WorkersLoggerConfig): void;
+export declare function createWorkersLogger(request: Request): WorkersRequestLogger;

package/types/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/index';

package/types/workers.d.ts

@@ -0,0 +1,13 @@
+export { createWorkersLogger, initWorkersLogger } from './frameworks/workers';
+export type {
+  HttpRequestLog,
+  StructuredLog,
+  StructuredLogEmitOptions,
+  StructuredLogError,
+  StructuredLogEvent,
+  StructuredLogLevel,
+  StructuredLogPayload,
+  WorkersEmitOptions,
+  WorkersLoggerConfig,
+  WorkersRequestLogger,
+} from './frameworks/workers';