@rebasepro/server-core 0.6.1 → 0.7.0

package/dist/storage/types.d.ts

@@ -1,103 +0,0 @@
-/**
- * Storage configuration and types for Rebase backend
- */
-import { UploadFileProps, UploadFileResult, DownloadConfig, StorageListResult } from "@rebasepro/types";
-/**
- * Local filesystem storage configuration
- */
-export interface LocalStorageConfig {
-    type: "local";
-    /** Base directory for file storage (e.g., './uploads') */
-    basePath: string;
-    /** Maximum file size in bytes (default: 50MB) */
-    maxFileSize?: number;
-    /** Allowed MIME types (if not set, all types allowed) */
-    allowedMimeTypes?: string[];
-    /** Base URL for generating download URLs (default: auto-detected from request) */
-    baseUrl?: string;
-}
-/**
- * S3-compatible storage configuration (works with AWS S3 and MinIO)
- */
-export interface S3StorageConfig {
-    type: "s3";
-    /** S3 bucket name */
-    bucket: string;
-    /** AWS region (e.g., 'us-east-1') */
-    region?: string;
-    /** Custom endpoint URL (required for MinIO, Cloudflare R2, Hetzner Object Storage) */
-    endpoint?: string;
-    /** AWS access key ID */
-    accessKeyId: string;
-    /** AWS secret access key */
-    secretAccessKey: string;
-    /** Use path-style URLs (required for MinIO) */
-    forcePathStyle?: boolean;
-    /** Maximum file size in bytes (default: 50MB) */
-    maxFileSize?: number;
-    /** Allowed MIME types (if not set, all types allowed) */
-    allowedMimeTypes?: string[];
-    /** URL expiration time in seconds for signed URLs (default: 3600) */
-    signedUrlExpiration?: number;
-}
-/**
- * Storage configuration — local filesystem or S3-compatible.
- *
- * **Built-in providers:**
- * - `local` — Zero-config filesystem storage. Great for dev and single-server deployments (Hetzner, bare metal).
- * - `s3` — Any S3-compatible provider. AWS S3, Cloudflare R2, MinIO, Hetzner Object Storage,
- *           Backblaze B2, DigitalOcean Spaces, and even GCS (via its S3-compatible interoperability API).
- *
- * **Custom providers:**
- * For cloud-native storage (GCS, Azure Blob, etc.), implement the `StorageController`
- * interface and pass the instance directly to the `storage` config.
- */
-export type BackendStorageConfig = LocalStorageConfig | S3StorageConfig;
-/**
- * Storage controller interface for backend implementations
- */
-export interface StorageController {
-    /**
-     * Upload an object
-     */
-    putObject(props: UploadFileProps): Promise<UploadFileResult>;
-    /**
-     * Get a download URL (signed URL equivalent) for an object
-     */
-    getSignedUrl(key: string, bucket?: string): Promise<DownloadConfig>;
-    /**
-     * Get object as a File
-     */
-    getObject(key: string, bucket?: string): Promise<File | null>;
-    /**
-     * Delete an object
-     */
-    deleteObject(key: string, bucket?: string): Promise<void>;
-    /**
-     * List objects in a prefix
-     */
-    listObjects(prefix: string, options?: {
-        bucket?: string;
-        maxResults?: number;
-        pageToken?: string;
-    }): Promise<StorageListResult>;
-    /**
-     * Get the storage provider identifier.
-     *
-     * Built-in values are `'local'` and `'s3'`. Custom implementations
-     * should return their own identifier (e.g. `'gcs'`, `'azure'`).
-     */
-    getType(): string;
-}
-/**
- * Default maximum file size (50MB)
- */
-export declare const DEFAULT_MAX_FILE_SIZE: number;
-/**
- * Common image MIME types
- */
-export declare const IMAGE_MIME_TYPES: string[];
-/**
- * Common document MIME types
- */
-export declare const DOCUMENT_MIME_TYPES: string[];

package/dist/types/index.d.ts

@@ -1,11 +0,0 @@
-import { Entity, FetchCollectionProps, FetchEntityProps } from "@rebasepro/types";
-export interface ListenCollectionRequest<M extends Record<string, unknown> = Record<string, unknown>> extends FetchCollectionProps<M> {
-    subscriptionId: string;
-    onUpdate: (entities: Entity<M>[]) => void;
-    onError?: (error: Error) => void;
-}
-export interface ListenEntityRequest<M extends Record<string, unknown> = Record<string, unknown>> extends FetchEntityProps<M> {
-    subscriptionId: string;
-    onUpdate: (entity: Entity<M> | null) => void;
-    onError?: (error: Error) => void;
-}

package/dist/utils/dev-port.d.ts

@@ -1,35 +0,0 @@
-/**
- * Dev-mode port resolution utilities.
- *
- * Provides a `listen` wrapper that automatically retries the next port when
- * the requested one is already in use, and writes the resolved port to a
- * well-known temp file so the CLI / frontend can discover it.
- *
- * Port affinity: when a port file already exists (e.g. after a tsx watch
- * restart), the saved port is tried FIRST so the backend stays on the same
- * port the frontend was configured with.
- *
- * This module is dev-only and should never run in production.
- */
-import type { Server } from "http";
-/** Filename written next to the project `.env` so the CLI can read it. */
-export declare const DEV_PORT_FILENAME = ".rebase-dev-port";
-/**
- * Try to `listen` on `startPort`. If the port is busy (`EADDRINUSE`), increment
- * and retry up to `maxAttempts` times.
- *
- * When a port file already exists (written by a previous run), the saved port
- * is tried first to maintain port affinity across tsx watch restarts.
- *
- * Resolves with the port that was actually bound.
- */
-export declare function listenWithPortRetry(server: Server, startPort: number, options?: {
-    host?: string;
-    maxAttempts?: number;
-    /** Absolute path to write the resolved port file into.  Defaults to `process.cwd()`. */
-    portFileDir?: string;
-}): Promise<number>;
-/**
- * Clean up the dev port file and state file (call on graceful shutdown).
- */
-export declare function cleanupDevPortFile(dir: string): void;

package/dist/utils/logger.d.ts

@@ -1,31 +0,0 @@
-/**
- * Structured Logger for Rebase Backend
- *
- * Outputs JSON lines when `NODE_ENV=production`, human-readable prefixed
- * lines otherwise.  Designed to work with Google Cloud Logging severity levels.
- *
- * Usage:
- *   import { logger } from "./utils/logger";
- *   logger.info("Server started", { port: 3001 });
- *   logger.error("Request failed", { path: "/api/test", error: err });
- */
-export type LogLevel = "debug" | "info" | "warn" | "error";
-export interface LogEntry {
-    severity: string;
-    message: string;
-    timestamp: string;
-    [key: string]: unknown;
-}
-export interface Logger {
-    debug(message: string, data?: Record<string, unknown>): void;
-    info(message: string, data?: Record<string, unknown>): void;
-    warn(message: string, data?: Record<string, unknown>): void;
-    error(message: string, data?: Record<string, unknown>): void;
-    child(defaultFields: Record<string, unknown>): Logger;
-}
-/**
- * Singleton logger instance.
- * In production: emits JSON lines with `severity`, `message`, `timestamp`.
- * In development: emits human-readable prefixed lines.
- */
-export declare const logger: Logger;

package/dist/utils/logging.d.ts

@@ -1,9 +0,0 @@
-/**
- * Configure console log levels based on environment variable
- * Call this early in your application to set up proper logging levels
- */
-export declare function configureLogLevel(logLevel?: string): void;
-/**
- * Reset console methods to their original state
- */
-export declare function resetConsole(): void;

package/dist/utils/request-id.d.ts

@@ -1,4 +0,0 @@
-import type { MiddlewareHandler } from "hono";
-import type { HonoEnv } from "../api/types";
-export declare const REQUEST_ID_HEADER = "X-Request-ID";
-export declare function requestId(): MiddlewareHandler<HonoEnv>;

package/dist/utils/request-logger.d.ts

@@ -1,19 +0,0 @@
-/**
- * Structured HTTP request logging middleware for Hono.
- *
- * Logs every request with method, path, status code, latency, and
- * content-length. In production, outputs JSON for Cloud Logging; in
- * development, emits a coloured one-liner.
- *
- * @example
- * ```ts
- * import { requestLogger } from "@rebasepro/server-core";
- * app.use("/*", requestLogger());
- * ```
- */
-import type { MiddlewareHandler } from "hono";
-export interface RequestLoggerOptions {
-    /** Paths to skip logging (e.g. "/health"). Supports exact match. */
-    skip?: string[];
-}
-export declare function requestLogger(options?: RequestLoggerOptions): MiddlewareHandler;

package/dist/utils/sql.d.ts

@@ -1,27 +0,0 @@
-import { SQL } from "drizzle-orm";
-/**
- * Returns a SQL chunk calling `auth.uid()` — the current user's ID.
- * This is a Supabase-style helper function created in the `auth` schema
- * that reads `app.user_id` set per-transaction by `withAuth()`.
- *
- * @example
- * sql`${table.user_id} = ${authUid()}`
- */
-export declare const authUid: () => SQL;
-/**
- * Returns a SQL chunk calling `auth.roles()` — the current user's roles
- * as a comma-separated string.
- * Reads `app.user_roles` set per-transaction by `withAuth()`.
- *
- * @example
- * sql`auth.roles() ~ 'admin'`
- */
-export declare const authRoles: () => SQL;
-/**
- * Returns a SQL chunk calling `auth.jwt()` — the full JWT claims as JSONB.
- * Reads `app.jwt` set per-transaction by `withAuth()`.
- *
- * @example
- * sql`auth.jwt()->>'sub'`
- */
-export declare const authJwt: () => SQL;