admindb 1.2.1 → 2.1.0

package/dist/types/api.d.ts

@@ -0,0 +1,412 @@
+/**
+ * AdminDB — Strongly typed API request and response interfaces.
+ *
+ * Every REST API endpoint returns a standardized envelope:
+ * `{ success: true, data: T }` on success, or `{ success: false, error: string }` on failure.
+ */
+import type { ColumnInfo, ForeignKeyInfo, IndexInfo, SavedQuery, SchemaInfo, TableInfoData, TableListItem, WhereClause, RowFilters } from '../db/database';
+import type { DatabaseEntry } from '../db/manager';
+import type { ColumnDef, IndexDef } from '../sql/generator';
+import type { ColumnGeneratorConfig, ColumnPlan, GeneratorStrategyId, StrategyDescriptor, StrategyCategory } from '../data/index';
+export type { ColumnInfo, ForeignKeyInfo, IndexInfo, SavedQuery, SchemaInfo, TableInfoData, TableListItem, WhereClause, RowFilters, ColumnDef, IndexDef, ColumnGeneratorConfig, ColumnPlan, GeneratorStrategyId, StrategyDescriptor, StrategyCategory, };
+/** Successful API response container. */
+export interface ApiSuccessResponse<T = unknown> {
+    success: true;
+    data: T;
+}
+/** Error API response container. */
+export interface ApiErrorResponse<T = unknown> {
+    success: false;
+    error: string;
+    data?: T;
+}
+/** Discriminated union of all API responses. */
+export type ApiResponse<T = unknown> = ApiSuccessResponse<T> | ApiErrorResponse<T>;
+/** GET /api/tables */
+export type ListTablesResponseData = TableListItem[];
+export type ListTablesResponse = ApiResponse<ListTablesResponseData>;
+/** GET /api/tables/:table/info */
+export type TableInfoResponseData = TableInfoData;
+export type TableInfoResponse = ApiResponse<TableInfoResponseData>;
+/** GET /api/tables/:table/fk-options */
+export type FkOptionsResponseData = Record<string, {
+    value: unknown;
+    label: string;
+}[]>;
+export type FkOptionsResponse = ApiResponse<FkOptionsResponseData>;
+/** GET /api/tables/:table/rows */
+export interface GetRowsResponseData {
+    rows: Record<string, unknown>[];
+    count: number;
+    page: number;
+    limit: number;
+    filters: RowFilters;
+}
+export type GetRowsResponse = ApiResponse<GetRowsResponseData>;
+/** GET /api/tables/:table/row/:id */
+export type GetRowResponseData = Record<string, unknown>;
+export type GetRowResponse = ApiResponse<GetRowResponseData>;
+/** GET /api/tables/:table/rows/:id/references */
+export interface RowReferenceGroup {
+    table: string;
+    from: string;
+    to: string;
+    value: unknown;
+    count: number;
+    columns: string[];
+    rows: Record<string, unknown>[];
+}
+export interface GetRowReferencesResponseData {
+    references: RowReferenceGroup[];
+}
+export type GetRowReferencesResponse = ApiResponse<GetRowReferencesResponseData>;
+/** POST /api/tables/:table/rows */
+export interface InsertRowRequestBody {
+    values: Record<string, unknown>;
+}
+export interface InsertRowResponseData {
+    message: string;
+    rowId?: number | bigint;
+    sql: string;
+}
+export type InsertRowResponse = ApiResponse<InsertRowResponseData>;
+/** POST /api/tables/:table/rows/generate */
+export interface GenerateInsertRequestBody {
+    values: Record<string, unknown>;
+}
+export interface GenerateInsertResponseData {
+    sql: string;
+}
+export type GenerateInsertResponse = ApiResponse<GenerateInsertResponseData>;
+/** POST /api/tables/:table/rows/import */
+export interface ImportCsvRequestBody {
+    csv: string;
+}
+export interface ImportCsvResponseData {
+    message: string;
+    inserted?: number;
+    skipped?: number;
+}
+export type ImportCsvResponse = ApiResponse<ImportCsvResponseData>;
+/** PUT /api/tables/:table/row/:id */
+export interface UpdateRowRequestBody {
+    values: Record<string, unknown>;
+    nulls?: string[];
+}
+export interface UpdateRowResponseData {
+    message: string;
+    sql: string;
+}
+export type UpdateRowResponse = ApiResponse<UpdateRowResponseData>;
+/** PUT /api/tables/:table/row/:id/generate */
+export interface GenerateUpdateRequestBody {
+    values: Record<string, unknown>;
+    nulls?: string[];
+}
+export interface GenerateUpdateResponseData {
+    sql: string;
+}
+export type GenerateUpdateResponse = ApiResponse<GenerateUpdateResponseData>;
+/** DELETE /api/tables/:table/row/:id */
+export interface DeleteRowResponseData {
+    message: string;
+}
+export type DeleteRowResponse = ApiResponse<DeleteRowResponseData>;
+/** GET /api/tables/:table/row/:id/blob/:column/meta */
+export interface BlobMetaResponseData {
+    isNull: boolean;
+    mime?: string;
+    ext?: string;
+    isImage?: boolean;
+    isText?: boolean;
+    isPdf?: boolean;
+    isAudio?: boolean;
+    isVideo?: boolean;
+    size: number;
+    sizeFormatted: string;
+    hexDump?: {
+        lines: {
+            offset: string;
+            hex: string;
+            ascii: string;
+        }[];
+        totalBytes: number;
+        truncated: boolean;
+    };
+    textPreview?: string | null;
+}
+export type BlobMetaResponse = ApiResponse<BlobMetaResponseData>;
+/** PUT /api/tables/:table/row/:id/blob/:column */
+export interface UpdateBlobRequestBody {
+    data: string;
+    format?: 'base64' | 'hex' | 'text';
+}
+export interface UpdateBlobResponseData {
+    message: string;
+    size: number;
+}
+export type UpdateBlobResponse = ApiResponse<UpdateBlobResponseData>;
+/** GET /api/tables/:table/ddl */
+export interface TableDdlResponseData {
+    table: string;
+    ddl: string;
+}
+export type TableDdlResponse = ApiResponse<TableDdlResponseData>;
+/** POST /api/tables/:table/rows/bulk-impact */
+export interface BulkImpactRequestBody {
+    ids: (string | number)[];
+}
+export interface BulkImpactReference {
+    table: string;
+    from: string;
+    to: string;
+    count: number;
+}
+export interface BulkImpactResponseData {
+    selected: number;
+    references: BulkImpactReference[];
+    total: number;
+}
+export type BulkImpactResponse = ApiResponse<BulkImpactResponseData>;
+/** POST /api/tables/:table/rows/bulk-delete */
+export interface BulkDeleteRequestBody {
+    ids: (string | number)[];
+    confirmImpact?: boolean;
+}
+export interface BulkDeleteResponseData {
+    message: string;
+    deleted: number;
+}
+export type BulkDeleteResponse = ApiResponse<BulkDeleteResponseData>;
+/** POST /api/tables/:table/rows/bulk-export */
+export interface BulkExportRequestBody {
+    ids: (string | number)[];
+    format?: 'csv' | 'json';
+}
+export interface BulkExportResponseData {
+    format: string;
+    filename: string;
+    content: string;
+    rowCount: number;
+}
+export type BulkExportResponse = ApiResponse<BulkExportResponseData>;
+/** POST /api/tables/:table/rows/bulk-update */
+export interface BulkUpdateItem {
+    id: string | number;
+    values?: Record<string, unknown>;
+    nulls?: string[];
+}
+export interface BulkUpdateRequestBody {
+    updates: BulkUpdateItem[];
+}
+export interface BulkUpdateResponseData {
+    message: string;
+    updated: number;
+}
+export type BulkUpdateResponse = ApiResponse<BulkUpdateResponseData>;
+/** GET /api/tables/:table/seed/config */
+export interface SeedConfigResponseData {
+    table: string;
+    columns: ColumnGeneratorConfig[];
+    maxRows: number;
+}
+export type SeedConfigResponse = ApiResponse<SeedConfigResponseData>;
+/** POST /api/tables/:table/seed/generate */
+export interface SeedGenerateRequestBody {
+    count?: number;
+    plan?: Record<string, ColumnPlan>;
+}
+export interface SeedGenerateResponseData {
+    table: string;
+    count: number;
+    sql: string;
+    previewRows?: Record<string, unknown>[];
+    warnings: string[];
+}
+export type SeedGenerateResponse = ApiResponse<SeedGenerateResponseData>;
+/** POST /api/tables/:table/seed */
+export interface SeedInsertRequestBody {
+    count?: number;
+    plan?: Record<string, ColumnPlan>;
+    truncate?: boolean;
+}
+export interface SeedInsertResponseData {
+    message: string;
+    inserted: number;
+    skipped: number;
+    warnings: string[];
+    elapsedMs?: number;
+}
+export type SeedInsertResponse = ApiResponse<SeedInsertResponseData>;
+/** POST /api/tables */
+export interface CreateTableRequestBody {
+    name: string;
+    columns: ColumnDef[];
+}
+export interface CreateTableResponseData {
+    message: string;
+    sql: string;
+}
+export type CreateTableResponse = ApiResponse<CreateTableResponseData>;
+/** POST /api/tables/generate */
+export interface GenerateCreateTableRequestBody {
+    name: string;
+    columns: ColumnDef[];
+}
+export interface GenerateCreateTableResponseData {
+    sql: string;
+}
+export type GenerateCreateTableResponse = ApiResponse<GenerateCreateTableResponseData>;
+/** GET /api/tables/:table/schema */
+export type GetSchemaResponseData = SchemaInfo;
+export type GetSchemaResponse = ApiResponse<GetSchemaResponseData>;
+/** POST /api/tables/:table/rename */
+export interface RenameTableRequestBody {
+    name: string;
+}
+export interface RenameTableResponseData {
+    message: string;
+    sql: string;
+    table: string;
+}
+export type RenameTableResponse = ApiResponse<RenameTableResponseData>;
+/** POST /api/tables/:table/columns */
+export interface AddColumnRequestBody {
+    column: ColumnDef;
+}
+export interface AddColumnResponseData {
+    message: string;
+    sql: string;
+}
+export type AddColumnResponse = ApiResponse<AddColumnResponseData>;
+/** PUT /api/tables/:table/columns/:column */
+export interface RenameColumnRequestBody {
+    name: string;
+}
+export interface RenameColumnResponseData {
+    message: string;
+    sql: string;
+}
+export type RenameColumnResponse = ApiResponse<RenameColumnResponseData>;
+/** DELETE /api/tables/:table/columns/:column */
+export interface DropColumnResponseData {
+    message: string;
+    sql: string;
+}
+export type DropColumnResponse = ApiResponse<DropColumnResponseData>;
+/** DELETE /api/tables/:table */
+export interface DropTableResponseData {
+    message: string;
+    sql: string;
+}
+export type DropTableResponse = ApiResponse<DropTableResponseData>;
+/** POST /api/tables/:table/indexes */
+export interface CreateIndexRequestBody {
+    name?: string;
+    columns: string[];
+    unique?: boolean;
+}
+export interface CreateIndexResponseData {
+    message: string;
+    sql: string;
+}
+export type CreateIndexResponse = ApiResponse<CreateIndexResponseData>;
+/** DELETE /api/tables/:table/indexes/:index */
+export interface DropIndexResponseData {
+    message: string;
+    sql: string;
+}
+export type DropIndexResponse = ApiResponse<DropIndexResponseData>;
+/** POST /api/query request */
+export interface ExecuteQueryRequestBody {
+    sql: string;
+}
+/** Result when SQL is classified as COUNT */
+export interface QueryCountResult {
+    kind: 'count';
+    count: number;
+    message: string;
+}
+/** Result when SQL is classified as SELECT / READ */
+export interface QuerySelectResult {
+    kind: 'select';
+    columns: string[];
+    rows: Record<string, unknown>[];
+}
+/** Result when SQL is a write statement (INSERT, UPDATE, DELETE, DDL, Script) */
+export interface QueryWriteResult {
+    kind: 'write';
+    changes: number | null;
+    message: string;
+}
+/** Discriminated union of all query results */
+export type ExecuteQueryResponseData = QueryCountResult | QuerySelectResult | QueryWriteResult;
+export type ExecuteQueryResponse = ApiResponse<ExecuteQueryResponseData>;
+/** POST /api/query/export */
+export interface ExportQueryRequestBody {
+    sql: string;
+    format?: 'csv' | 'json';
+}
+/** GET /api/queries */
+export type ListSavedQueriesResponseData = SavedQuery[];
+export type ListSavedQueriesResponse = ApiResponse<ListSavedQueriesResponseData>;
+/** POST /api/queries */
+export interface SaveQueryRequestBody {
+    name: string;
+    sql: string;
+}
+export interface SaveQueryResponseData {
+    message: string;
+}
+export type SaveQueryResponse = ApiResponse<SaveQueryResponseData>;
+/** DELETE /api/queries/:id */
+export interface DeleteSavedQueryResponseData {
+    message: string;
+}
+export type DeleteSavedQueryResponse = ApiResponse<DeleteSavedQueryResponseData>;
+export interface DatabaseRow extends DatabaseEntry {
+    sizeLabel: string;
+    modifiedLabel: string;
+    tables: number;
+}
+/** GET /api/databases */
+export type ListDatabasesResponseData = DatabaseRow[];
+export type ListDatabasesResponse = ApiResponse<ListDatabasesResponseData>;
+/** POST /api/databases */
+export interface CreateDatabaseRequestBody {
+    name: string;
+}
+export interface CreateDatabaseResponseData {
+    id: string;
+    message: string;
+}
+export type CreateDatabaseResponse = ApiResponse<CreateDatabaseResponseData>;
+/** POST /api/databases/open */
+export interface OpenDatabaseRequestBody {
+    path: string;
+}
+export interface OpenDatabaseResponseData {
+    id: string;
+    message: string;
+}
+export type OpenDatabaseResponse = ApiResponse<OpenDatabaseResponseData>;
+/** DELETE /api/databases/:id */
+export interface DeleteDatabaseResponseData {
+    message: string;
+}
+export type DeleteDatabaseResponse = ApiResponse<DeleteDatabaseResponseData>;
+export interface FsEntry {
+    name: string;
+    path: string;
+    isDir: boolean;
+    isDb: boolean;
+    size: number;
+}
+/** GET /api/fs/list */
+export interface ListFsResponseData {
+    path: string;
+    name: string;
+    parent: string | null;
+    entries: FsEntry[];
+}
+export type ListFsResponse = ApiResponse<ListFsResponseData>;

package/dist/types/api.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * AdminDB — Strongly typed API request and response interfaces.
+ *
+ * Every REST API endpoint returns a standardized envelope:
+ * `{ success: true, data: T }` on success, or `{ success: false, error: string }` on failure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/utils/colors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Lightweight ANSI color utility with zero runtime dependencies.
+ *
+ * Supports detection of terminal color capabilities via `process.stdout.isTTY`,
+ * `FORCE_COLOR`, `NO_COLOR`, and CI environments.
+ */
+export declare function supportsColor(): boolean;
+export declare const c: {
+    reset: (str: unknown) => string;
+    bold: (str: unknown) => string;
+    dim: (str: unknown) => string;
+    italic: (str: unknown) => string;
+    underline: (str: unknown) => string;
+    inverse: (str: unknown) => string;
+    black: (str: unknown) => string;
+    red: (str: unknown) => string;
+    green: (str: unknown) => string;
+    yellow: (str: unknown) => string;
+    blue: (str: unknown) => string;
+    magenta: (str: unknown) => string;
+    cyan: (str: unknown) => string;
+    white: (str: unknown) => string;
+    gray: (str: unknown) => string;
+    brightRed: (str: unknown) => string;
+    brightGreen: (str: unknown) => string;
+    brightYellow: (str: unknown) => string;
+    brightBlue: (str: unknown) => string;
+    brightMagenta: (str: unknown) => string;
+    brightCyan: (str: unknown) => string;
+    brightWhite: (str: unknown) => string;
+    bgBlack: (str: unknown) => string;
+    bgRed: (str: unknown) => string;
+    bgGreen: (str: unknown) => string;
+    bgYellow: (str: unknown) => string;
+    bgBlue: (str: unknown) => string;
+    bgMagenta: (str: unknown) => string;
+    bgCyan: (str: unknown) => string;
+    bgWhite: (str: unknown) => string;
+    bgGray: (str: unknown) => string;
+};

package/dist/utils/colors.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Lightweight ANSI color utility with zero runtime dependencies.
+ *
+ * Supports detection of terminal color capabilities via `process.stdout.isTTY`,
+ * `FORCE_COLOR`, `NO_COLOR`, and CI environments.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.c = void 0;
+exports.supportsColor = supportsColor;
+function supportsColor() {
+    if (process.env.NO_COLOR || process.env.NODE_DISABLE_COLORS)
+        return false;
+    if (process.env.FORCE_COLOR && process.env.FORCE_COLOR !== '0')
+        return true;
+    if (process.env.TERM === 'dumb')
+        return false;
+    if (process.env.CI)
+        return true;
+    return Boolean(process.stdout && process.stdout.isTTY);
+}
+const wrap = (open, close) => (str) => {
+    const text = String(str ?? '');
+    if (!supportsColor() || !text)
+        return text;
+    return `${open}${text}${close}`;
+};
+exports.c = {
+    reset: wrap('\x1b[0m', '\x1b[0m'),
+    bold: wrap('\x1b[1m', '\x1b[22m'),
+    dim: wrap('\x1b[2m', '\x1b[22m'),
+    italic: wrap('\x1b[3m', '\x1b[23m'),
+    underline: wrap('\x1b[4m', '\x1b[24m'),
+    inverse: wrap('\x1b[7m', '\x1b[27m'),
+    // Foreground colors
+    black: wrap('\x1b[30m', '\x1b[39m'),
+    red: wrap('\x1b[31m', '\x1b[39m'),
+    green: wrap('\x1b[32m', '\x1b[39m'),
+    yellow: wrap('\x1b[33m', '\x1b[39m'),
+    blue: wrap('\x1b[34m', '\x1b[39m'),
+    magenta: wrap('\x1b[35m', '\x1b[39m'),
+    cyan: wrap('\x1b[36m', '\x1b[39m'),
+    white: wrap('\x1b[37m', '\x1b[39m'),
+    gray: wrap('\x1b[90m', '\x1b[39m'),
+    // Bright foregrounds
+    brightRed: wrap('\x1b[91m', '\x1b[39m'),
+    brightGreen: wrap('\x1b[92m', '\x1b[39m'),
+    brightYellow: wrap('\x1b[93m', '\x1b[39m'),
+    brightBlue: wrap('\x1b[94m', '\x1b[39m'),
+    brightMagenta: wrap('\x1b[95m', '\x1b[39m'),
+    brightCyan: wrap('\x1b[96m', '\x1b[39m'),
+    brightWhite: wrap('\x1b[97m', '\x1b[39m'),
+    // Background colors
+    bgBlack: wrap('\x1b[40m', '\x1b[49m'),
+    bgRed: wrap('\x1b[41m', '\x1b[49m'),
+    bgGreen: wrap('\x1b[42m', '\x1b[49m'),
+    bgYellow: wrap('\x1b[43m', '\x1b[49m'),
+    bgBlue: wrap('\x1b[44m', '\x1b[49m'),
+    bgMagenta: wrap('\x1b[45m', '\x1b[49m'),
+    bgCyan: wrap('\x1b[46m', '\x1b[49m'),
+    bgWhite: wrap('\x1b[47m', '\x1b[49m'),
+    bgGray: wrap('\x1b[100m', '\x1b[49m'),
+};
+//# sourceMappingURL=colors.js.map

package/dist/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"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"}

package/dist/{util.d.ts → utils/common.d.ts}

@@ -1,8 +1,8 @@
-/** Small shared helpers used across the server. */
 export declare function errorMessage(err: unknown): string;
 /**
  * True when `p` is equal to `root` or lives inside it (both treated as
  * absolute). Used to sandbox the filesystem file-browser to an allowed folder.
+ * Resolves symlinks and rejects null-byte injections.
  */
 export declare function isPathWithinRoot(root: string, p: string): boolean;
 /** Operators understood by the structured (type-aware) filter conditions. */
@@ -36,11 +36,15 @@ export declare function normalizeCell(value: unknown): unknown;
 /** Normalize every cell in a row. */
 export declare function normalizeRow(row: Record<string, unknown>): Record<string, unknown>;
 /**
- * Coerce a raw form value into a value suitable for SQLite binding.
+ * Coerce a raw form value into a value suitable for SQLite or Postgres binding.
  * - empty string / null / undefined  → null ("not set")
  * - `0` stays valid
- * - BOOLEAN → 1/0
- * - INTEGER/REAL → number when numeric
- * - BLOB → Buffer (0x-hex or raw text)
+ * - BOOLEAN → 1/0 (SQLite) or boolean (PostgreSQL)
+ * - INTEGER/REAL/BIGINT/NUMERIC → number when numeric
+ * - BLOB / BYTEA → Buffer (0x-hex, \x-hex, or raw text)
  */
-export declare function coerceFormValue(raw: unknown, columnType: string): unknown;
+export declare function coerceFormValue(raw: unknown, columnType: string, dialect?: 'sqlite' | 'postgres'): unknown;
+/** Format byte size to human readable string (e.g. 1.2 MB). */
+export declare function formatBytes(bytes: number): string;
+/** Truncate a string with an ellipsis if it exceeds maxLength. */
+export declare function truncate(str: string, maxLength: number): string;