@boltstore/utils 0.5.0

package/dist/schema.js

@@ -0,0 +1,209 @@
+// ── JSON Schema Exports ──
+// Standard JSON Schema representations of all Boltstore types.
+// Enables code generation for any language with JSON Schema tooling.
+export const RecordSchema = {
+    $id: "https://boltstore.dev/schemas/record.json",
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    title: "Record",
+    type: "object",
+    properties: {
+        id: { type: "string", description: "Unique record ID" },
+        collectionId: { type: "string", description: "Parent collection ID" },
+        collectionName: { type: "string", description: "Parent collection name" },
+        created: { type: "string", format: "date-time" },
+        updated: { type: "string", format: "date-time" },
+    },
+    required: ["id", "collectionId", "collectionName", "created", "updated"],
+    additionalProperties: true,
+};
+export const CollectionSchema = {
+    $id: "https://boltstore.dev/schemas/collection.json",
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    title: "Collection",
+    type: "object",
+    properties: {
+        id: { type: "string" },
+        name: { type: "string", minLength: 1, maxLength: 64 },
+        fields: {
+            type: "array",
+            items: { $ref: "#/$defs/FieldSchema" },
+        },
+        rls: { $ref: "#/$defs/RlsPolicy" },
+        sync: { $ref: "#/$defs/SyncConfig" },
+        system: { type: "boolean" },
+        created: { type: "string", format: "date-time" },
+        updated: { type: "string", format: "date-time" },
+    },
+    required: ["id", "name", "fields", "created", "updated"],
+    $defs: {
+        FieldSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                type: {
+                    type: "string",
+                    enum: ["text", "number", "bool", "date", "json", "file", "relation", "email", "url", "select"],
+                },
+                required: { type: "boolean" },
+                unique: { type: "boolean" },
+                default: {},
+                values: { type: "array", items: { type: "string" } },
+                maxLength: { type: "integer" },
+                min: { type: "number" },
+                max: { type: "number" },
+                pattern: { type: "string" },
+                relationCollection: { type: "string" },
+                cascadeDelete: { type: "boolean" },
+                maxSize: { type: "integer" },
+                mimeTypes: { type: "array", items: { type: "string" } },
+                index: { type: "boolean" },
+            },
+            required: ["name", "type"],
+        },
+        RlsPolicy: {
+            type: "object",
+            properties: {
+                select: { type: "string" },
+                insert: { type: "string" },
+                update: { type: "string" },
+                delete: { type: "string" },
+            },
+        },
+        SyncConfig: {
+            type: "object",
+            properties: {
+                strategy: {
+                    type: "string",
+                    enum: ["server-wins", "last-write-wins", "client-wins", "custom"],
+                },
+                fields: {
+                    type: "object",
+                    additionalProperties: {
+                        type: "string",
+                        enum: ["server-wins", "last-write-wins", "client-wins", "custom"],
+                    },
+                },
+            },
+            required: ["strategy"],
+        },
+    },
+};
+export const UserSchema = {
+    $id: "https://boltstore.dev/schemas/user.json",
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    title: "User",
+    type: "object",
+    properties: {
+        id: { type: "string" },
+        email: { type: "string", format: "email" },
+        emailVerified: { type: "boolean" },
+        role: { type: "string", enum: ["admin", "editor", "viewer"] },
+        avatar: { type: "string", format: "uri" },
+        created: { type: "string", format: "date-time" },
+        updated: { type: "string", format: "date-time" },
+    },
+    required: ["id", "email", "emailVerified", "role", "created", "updated"],
+};
+export const JwtPayloadSchema = {
+    $id: "https://boltstore.dev/schemas/jwt-payload.json",
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    title: "JWT Payload",
+    type: "object",
+    properties: {
+        sub: { type: "string" },
+        iss: { type: "string", const: "boltstore" },
+        aud: { type: "string" },
+        iat: { type: "integer" },
+        exp: { type: "integer" },
+        role: { type: "string", enum: ["admin", "editor", "viewer"] },
+        email: { type: "string", format: "email" },
+        application: { type: "string" },
+        type: { type: "string", enum: ["access", "refresh"] },
+        jti: { type: "string" },
+    },
+    required: ["sub", "iss", "aud", "iat", "exp", "role", "application", "type", "jti"],
+};
+export const ApiResponseSchema = {
+    $id: "https://boltstore.dev/schemas/api-response.json",
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    title: "API Response",
+    type: "object",
+    properties: {
+        success: { type: "boolean" },
+        data: {},
+        error: {
+            type: "object",
+            properties: {
+                code: { type: "string" },
+                message: { type: "string" },
+                details: { type: "object" },
+            },
+            required: ["code", "message"],
+        },
+        meta: {
+            type: "object",
+            properties: {
+                page: { type: "integer" },
+                perPage: { type: "integer" },
+                totalItems: { type: "integer" },
+                totalPages: { type: "integer" },
+            },
+        },
+    },
+    required: ["success"],
+};
+export const ErrorCodesSchema = {
+    $id: "https://boltstore.dev/schemas/error-codes.json",
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    title: "Error Codes",
+    type: "object",
+    properties: {
+        code: {
+            type: "string",
+            enum: [
+                "unauthorized",
+                "forbidden",
+                "token_expired",
+                "invalid_token",
+                "invalid_credentials",
+                "email_not_verified",
+                "email_already_exists",
+                "collection_not_found",
+                "record_not_found",
+                "validation_error",
+                "duplicate_entry",
+                "rls_forbidden",
+                "rls_no_policy",
+                "file_too_large",
+                "invalid_file_type",
+                "file_not_found",
+                "storage_error",
+                "rate_limited",
+                "internal_error",
+                "not_implemented",
+                "service_unavailable",
+                "sync_conflict",
+                "sync_rejected",
+                "sync_clock_skew",
+                "application_not_found",
+                "application_limit_reached",
+                "backup_failed",
+                "backup_not_found",
+                "restore_failed",
+            ],
+        },
+        message: { type: "string" },
+        details: { type: "object" },
+    },
+    required: ["code", "message"],
+};
+// ── All schemas registry ──
+export const allSchemas = {
+    record: RecordSchema,
+    collection: CollectionSchema,
+    user: UserSchema,
+    jwtPayload: JwtPayloadSchema,
+    apiResponse: ApiResponseSchema,
+    errorCodes: ErrorCodesSchema,
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/storage-types.d.ts

@@ -0,0 +1,117 @@
+export interface FileInfo {
+    /** Storage key / path */
+    key: string;
+    /** Original filename */
+    filename: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    mimeType: string;
+    /** Application ID */
+    applicationId: string;
+    /** Collection name */
+    collection: string;
+    /** Record ID */
+    recordId: string;
+    /** ISO 8601 upload timestamp */
+    uploadedAt: string;
+    /** Uploader user ID */
+    uploadedBy?: string;
+    /** Uploader type (admin, user, api) */
+    uploaderType?: string;
+    /** Uploader display name */
+    uploaderName?: string;
+    /** Folder path / ID */
+    folder?: string;
+    /** Visibility (public, private, shared) */
+    visibility?: string;
+    /** Content hash (SHA-256) for deduplication */
+    checksum?: string;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+}
+export interface PutOptions {
+    /** Override MIME type detection */
+    contentType?: string;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+    /** Override filename (default: original) */
+    filename?: string;
+}
+export interface SignedUrlOptions {
+    /** Expiry in seconds (default: 3600 = 1 hour) */
+    expiry?: number;
+    /** Override content-disposition for download */
+    download?: boolean;
+    /** Force a specific filename in Content-Disposition */
+    filename?: string;
+}
+export interface MultipartUploadInit {
+    uploadId: string;
+    key: string;
+    /** Part size in bytes */
+    partSize: number;
+    /** Total number of parts */
+    totalParts: number;
+}
+export interface MultipartUploadPart {
+    partNumber: number;
+    /** ETag from the upload response */
+    etag: string;
+}
+export interface MultipartUploadComplete {
+    uploadId: string;
+    key: string;
+    parts: MultipartUploadPart[];
+}
+export type StorageProvider = "local" | "s3";
+export interface StorageConfig {
+    /** Which provider to use */
+    provider: StorageProvider;
+    /** Base path for local storage (default: data/uploads/) */
+    localBasePath?: string;
+    /** S3 configuration */
+    s3?: S3Config;
+}
+export interface S3Config {
+    /** S3 bucket name */
+    bucket: string;
+    /** AWS region */
+    region: string;
+    /** Access key ID */
+    accessKeyId: string;
+    /** Secret access key */
+    secretAccessKey: string;
+    /** Custom endpoint for S3-compatible services */
+    endpoint?: string;
+    /** Force path-style URLs (required for many S3-compatible providers) */
+    forcePathStyle?: boolean;
+    /** Upload in parts above this size (bytes, default: 5MB) */
+    multipartThreshold?: number;
+}
+export interface UploadRequest {
+    /** File data (for server-side uploads) */
+    file?: File | Blob;
+    /** URL to fetch the file from (for URL-based uploads) */
+    url?: string;
+    /** Target application */
+    applicationId: string;
+    /** Target collection */
+    collection: string;
+    /** Target record */
+    recordId: string;
+    /** Field name on the record */
+    field: string;
+    options?: PutOptions;
+}
+export interface UploadResponse {
+    /** Storage key for retrieval */
+    key: string;
+    /** Public or signed URL to access the file */
+    url: string;
+    /** Signed URL for direct access (e.g. S3 presigned) */
+    signedUrl?: string;
+    /** File metadata */
+    file: FileInfo;
+}
+//# sourceMappingURL=storage-types.d.ts.map

package/dist/storage-types.d.ts.map

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

package/dist/storage-types.js

@@ -0,0 +1,4 @@
+// ── File Storage Types ──
+// Shared between server storage engine and client SDK.
+export {};
+//# sourceMappingURL=storage-types.js.map

package/dist/storage-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-types.js","sourceRoot":"","sources":["../src/storage-types.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,uDAAuD"}

package/dist/sync-types.d.ts

@@ -0,0 +1,136 @@
+import type { SyncStrategy } from "./types";
+/**
+ * A Lamport logical clock — monotonically increasing counter.
+ * Each node (client or server) increments its clock on every event.
+ * Higher clock = "happened after" in causal ordering.
+ */
+export interface LamportClock {
+    /** Current clock value */
+    counter: number;
+    /** Node identifier */
+    nodeId: string;
+}
+/**
+ * A version vector tracks the latest clock value seen from each node.
+ * Used to determine which changes are new when syncing.
+ *
+ * @example
+ * { "server": 10, "client-A": 5, "client-B": 3 }
+ */
+export type VersionVector = Record<string, number>;
+export interface ChangeLogEntry {
+    /** Unique change ID */
+    id: string;
+    /** The record that changed */
+    rowId: string;
+    /** Collection/table name */
+    collection: string;
+    /** Field that changed (null for row-level operations like delete) */
+    field?: string;
+    /** Previous value */
+    oldValue?: unknown;
+    /** New value */
+    newValue?: unknown;
+    /** Lamport clock value when change was made */
+    clock: number;
+    /** Node that made the change */
+    clientId: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Operation type */
+    operation: "insert" | "update" | "delete";
+}
+export interface FieldChange {
+    /** Field name */
+    field: string;
+    /** The new value */
+    value: unknown;
+    /** Lamport clock for this field change */
+    clock: number;
+    /** Node that last changed this field */
+    clientId: string;
+}
+export interface MergeInput {
+    /** The current server-side row */
+    serverRow: Record<string, FieldChange>;
+    /** The incoming client-side changes */
+    clientChanges: Record<string, FieldChange>;
+    /** Collection-level sync strategy */
+    strategy: SyncStrategy;
+    /** Per-field strategy overrides */
+    fieldStrategies?: Record<string, SyncStrategy>;
+}
+export interface MergeResult {
+    /** The merged row (winning values) */
+    merged: Record<string, unknown>;
+    /** Fields accepted from client changes */
+    accepted: string[];
+    /** Fields rejected (server values kept) */
+    rejected: string[];
+    /** Per-field rejection reasons */
+    rejectReasons?: Record<string, string>;
+}
+export type SyncMessageType = "sync_start" | "sync_pull" | "sync_push" | "sync_ack" | "sync_error" | "catchup";
+export interface SyncStartMessage {
+    type: "sync_start";
+    /** Client's last known version vector */
+    lastSeen: VersionVector;
+    /** Client's current Lamport clock */
+    clock: number;
+}
+export interface SyncPullResponse {
+    type: "sync_pull";
+    /** Changes since client's lastSeen */
+    changes: ChangeLogEntry[];
+    /** Current server clock */
+    serverClock: number;
+    /** Has more changes to send? */
+    hasMore: boolean;
+}
+export interface SyncPushRequest {
+    type: "sync_push";
+    /** Pending local changes to push */
+    changes: Array<{
+        rowId: string;
+        collection: string;
+        operation: "insert" | "update" | "delete";
+        fields: Record<string, FieldChange>;
+    }>;
+}
+export interface SyncPushResponse {
+    type: "sync_ack";
+    /** Accepted change IDs */
+    accepted: string[];
+    /** Rejected changes with reasons */
+    rejected: Array<{
+        rowId: string;
+        reason: string;
+        code: string;
+    }>;
+}
+export interface SyncErrorMessage {
+    type: "sync_error";
+    code: string;
+    message: string;
+}
+export interface CatchupMessage {
+    type: "catchup";
+    /** Replay changes since this timestamp */
+    since: string;
+}
+export interface ClientSyncState {
+    /** Local Lamport clock */
+    clock: LamportClock;
+    /** Known version vector */
+    versionVector: VersionVector;
+    /** Pending changes not yet pushed */
+    pendingChanges: ChangeLogEntry[];
+    /** Is a sync in progress? */
+    syncing: boolean;
+    /** Last successful sync timestamp */
+    lastSyncAt?: string;
+    /** Number of consecutive sync failures */
+    consecutiveFailures: number;
+}
+export type SyncConnectionState = "disconnected" | "connecting" | "connected" | "syncing" | "error";
+//# sourceMappingURL=sync-types.d.ts.map

package/dist/sync-types.d.ts.map

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

package/dist/sync-types.js

@@ -0,0 +1,4 @@
+// ── Offline Sync Types ──
+// Shared between server sync engine and client SDK.
+export {};
+//# sourceMappingURL=sync-types.js.map

package/dist/sync-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-types.js","sourceRoot":"","sources":["../src/sync-types.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,oDAAoD"}

package/dist/types.d.ts

@@ -0,0 +1,164 @@
+export type FieldType = "text" | "number" | "bool" | "date" | "json" | "file" | "relation" | "email" | "url" | "select";
+export interface FieldSchema {
+    name: string;
+    type: FieldType;
+    required?: boolean;
+    unique?: boolean;
+    default?: unknown;
+    /** Options for 'select' fields */
+    values?: string[];
+    /** Max length for 'text' fields */
+    maxLength?: number;
+    /** Min value for 'number' fields, min length for 'text' fields */
+    min?: number;
+    /** Max value for 'number' fields */
+    max?: number;
+    /** Regex pattern for 'text' fields */
+    pattern?: string;
+    /** For 'relation' fields: target collection name */
+    relationCollection?: string;
+    /** For 'relation' fields: cascade delete? */
+    cascadeDelete?: boolean;
+    /** For 'file' fields: max file size in bytes */
+    maxSize?: number;
+    /** For 'file' fields: allowed MIME types */
+    mimeTypes?: string[];
+    /** Index this field? */
+    index?: boolean;
+    /** Foreign key constraint: referenced table and column */
+    foreignKey?: {
+        table: string;
+        column: string;
+        onDelete?: "CASCADE" | "SET NULL" | "RESTRICT" | "NO ACTION";
+    };
+}
+export interface RlsPolicy {
+    /** SQL-like condition appended to SELECT WHERE clause */
+    select?: string;
+    /** SQL-like condition checked before INSERT */
+    insert?: string;
+    /** SQL-like condition appended to UPDATE WHERE clause */
+    update?: string;
+    /** SQL-like condition appended to DELETE WHERE clause */
+    delete?: string;
+}
+export interface CollectionSchema {
+    id: string;
+    name: string;
+    fields: FieldSchema[];
+    rls?: RlsPolicy;
+    sync?: SyncConfig;
+    /** System fields added automatically */
+    system?: boolean;
+    created: string;
+    updated: string;
+}
+export type SyncStrategy = "server-wins" | "last-write-wins" | "client-wins" | "custom";
+export interface SyncConfig {
+    /** Default strategy for this collection */
+    strategy: SyncStrategy;
+    /** Per-field strategy overrides */
+    fields?: Record<string, SyncStrategy>;
+}
+export interface RecordData {
+    id: string;
+    collectionId: string;
+    collectionName: string;
+    /** Dynamic field data */
+    [key: string]: unknown;
+    created: string;
+    updated: string;
+}
+export type UserRole = string;
+export interface BoltstoreUser {
+    id: string;
+    email: string;
+    emailVerified: boolean;
+    role: UserRole;
+    avatar?: string;
+    created: string;
+    updated: string;
+}
+export interface BoltstoreApplication {
+    id: string;
+    name: string;
+    description?: string;
+    /** Per-application database file path */
+    dbFile: string;
+    created: string;
+    updated: string;
+}
+export type ApiKeyScope = "read-only" | "read-write" | "admin";
+export interface ApiKeyRecord {
+    id: string;
+    name: string;
+    /** SHA-256 hash of the key */
+    keyHash: string;
+    /** The key prefix for identification (bs_xxxx...) */
+    prefix: string;
+    scope: ApiKeyScope;
+    applicationId: string;
+    created: string;
+    expiresAt?: string;
+    lastUsedAt?: string;
+}
+export interface PaginationParams {
+    page?: number;
+    perPage?: number;
+    sort?: string;
+    filter?: string;
+    expand?: string;
+    search?: string;
+}
+export interface PaginatedResponse<T> {
+    page: number;
+    perPage: number;
+    totalItems: number;
+    totalPages: number;
+    items: T[];
+}
+export type BatchOperation = {
+    method: "POST";
+    collection: string;
+    data: Record<string, unknown>;
+} | {
+    method: "PATCH";
+    collection: string;
+    id: string;
+    data: Record<string, unknown>;
+} | {
+    method: "DELETE";
+    collection: string;
+    id: string;
+};
+export interface BatchRequest {
+    operations: BatchOperation[];
+    /** Execute in a single transaction? */
+    transactional?: boolean;
+}
+export interface BatchResult {
+    success: boolean;
+    results: Array<{
+        operation: BatchOperation;
+        status: number;
+        data?: RecordData;
+        error?: string;
+    }>;
+}
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: ApiError;
+    meta?: {
+        page?: number;
+        perPage?: number;
+        totalItems?: number;
+        totalPages?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map