@sincpro/mobile 0.4.4 → 1.0.0

package/dist/domain/webview/events.d.ts

@@ -1,5 +1,5 @@
-import { DomainEvent } from "../../domain/event_sourcing";
-export declare class WebViewMessageReceivedEvent extends DomainEvent {
+import { IntegrationEvent } from "../../domain/events/integration_event";
+export declare class WebViewMessageReceivedEvent extends IntegrationEvent {
     static readonly name = "common.webview.v1.message_received";
     static readonly label = "Procesando datos de la web";
     static readonly requiresNetwork = false;

package/dist/domain/webview/events.js

@@ -1,5 +1,5 @@
-import { DomainEvent } from "../../domain/event_sourcing";
-export class WebViewMessageReceivedEvent extends DomainEvent {
+import { IntegrationEvent } from "../../domain/events/integration_event";
+export class WebViewMessageReceivedEvent extends IntegrationEvent {
     static name = "common.webview.v1.message_received";
     static label = "Procesando datos de la web";
     static requiresNetwork = false;

package/dist/entrypoints/db/migrations.js

@@ -155,16 +155,16 @@ async function createSpansQueueTable() {
     ON ${DATABASE_TABLES.SPANS_QUEUE}(trace_id);
   `);
 }
+function migration(name, migrationFn) {
+    return { name, tables: [name], migrationFn };
+}
 const MIGRATIONS = [
-    { name: DATABASE_TABLES.SETTINGS, migrationFn: createSettingsTable },
-    { name: DATABASE_TABLES.EVENT_QUEUE, migrationFn: createEventQueueTable },
-    { name: DATABASE_TABLES.DEAD_LETTER_QUEUE, migrationFn: createDeadLetterQueueTable },
-    { name: DATABASE_TABLES.DOMAIN_EVENTS, migrationFn: createDomainEventsTable },
-    {
-        name: DATABASE_TABLES.DOMAIN_EVENTS_DEAD_LETTER,
-        migrationFn: createDomainEventsDeadLetterTable,
-    },
-    { name: DATABASE_TABLES.TELEMETRY_QUEUE, migrationFn: createTelemetryQueueTable },
-    { name: DATABASE_TABLES.SPANS_QUEUE, migrationFn: createSpansQueueTable },
+    migration(DATABASE_TABLES.SETTINGS, createSettingsTable),
+    migration(DATABASE_TABLES.EVENT_QUEUE, createEventQueueTable),
+    migration(DATABASE_TABLES.DEAD_LETTER_QUEUE, createDeadLetterQueueTable),
+    migration(DATABASE_TABLES.DOMAIN_EVENTS, createDomainEventsTable),
+    migration(DATABASE_TABLES.DOMAIN_EVENTS_DEAD_LETTER, createDomainEventsDeadLetterTable),
+    migration(DATABASE_TABLES.TELEMETRY_QUEUE, createTelemetryQueueTable),
+    migration(DATABASE_TABLES.SPANS_QUEUE, createSpansQueueTable),
 ];
 export default MIGRATIONS;

package/dist/entrypoints/queue/QueueProcessor.d.ts

@@ -1,4 +1,4 @@
-import type { Subscriber } from "../../domain/event_sourcing";
+import type { Subscriber } from "../../event_driven";
 export interface SyncResult {
     changed: boolean;
     added: number;

package/dist/entrypoints/queue/activateDomain.subscriber.d.ts

@@ -1,5 +1,5 @@
-import { DomainEvent, Subscriber } from "../../domain/event_sourcing";
-import { ActivateDomainEvent, DeactivateDomainEvent } from "../../domain/events";
+import { ActivateDomainEvent, DeactivateDomainEvent, DomainEvent } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 export declare class ActivateDomainSubscriber extends Subscriber {
     readonly requiresAuth = false;
     listen: (typeof ActivateDomainEvent | typeof DeactivateDomainEvent)[];

package/dist/entrypoints/queue/activateDomain.subscriber.js

@@ -1,5 +1,5 @@
-import { Subscriber } from "../../domain/event_sourcing";
-import { ActivateDomainEvent, DeactivateDomainEvent } from "../../domain/events";
+import { ActivateDomainEvent, DeactivateDomainEvent, } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 import { orchestrator } from "../../framework/orchestrator";
 export class ActivateDomainSubscriber extends Subscriber {
     requiresAuth = false;

package/dist/entrypoints/queue/newAppSettings.handler.d.ts

@@ -1,5 +1,5 @@
-import { DomainEvent, Subscriber } from "../../domain/event_sourcing";
-import { NewAppSettingsEvent } from "../../domain/events";
+import { DomainEvent, NewAppSettingsEvent } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 export declare class NewAppSettingsSubscriber extends Subscriber {
     listen: (typeof NewAppSettingsEvent)[];
     getEvent(event: DomainEvent): NewAppSettingsEvent;

package/dist/entrypoints/queue/newAppSettings.handler.js

@@ -1,6 +1,6 @@
 import { SettingsRepository } from "../../adapters/repositories/setting.repository";
-import { Subscriber } from "../../domain/event_sourcing";
 import { NewAppSettingsEvent } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 import { loggerUseCases } from "../../infrastructure/logger";
 export class NewAppSettingsSubscriber extends Subscriber {
     listen = [NewAppSettingsEvent];

package/dist/entrypoints/queue/printImage.subscriber.d.ts

@@ -1,5 +1,5 @@
-import { Subscriber } from "../../domain/event_sourcing";
 import { PrintImageRequestedEvent } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 export declare class PrintImageSubscriber extends Subscriber {
     readonly requiresAuth = false;
     listen: (typeof PrintImageRequestedEvent)[];

package/dist/entrypoints/queue/printImage.subscriber.js

@@ -1,5 +1,5 @@
-import { Subscriber } from "../../domain/event_sourcing";
 import { PrintImageRequestedEvent } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 import { DomainValidationError } from "../../exceptions";
 import { printerService } from "../../services/printer.service";
 export class PrintImageSubscriber extends Subscriber {
@@ -8,7 +8,7 @@ export class PrintImageSubscriber extends Subscriber {
     async process(event) {
         const printed = await printerService.printImageBase64(event.imageBase64);
         if (!printed) {
-            throw new DomainValidationError("Print failed — printer not connected or timed out");
+            throw new DomainValidationError("No se pudo imprimir");
         }
     }
 }

package/dist/entrypoints/queue/processWebViewMessage.subscriber.d.ts

@@ -1,5 +1,5 @@
-import { Subscriber } from "../../domain/event_sourcing";
 import { WebViewMessageReceivedEvent } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 export declare class ProcessWebViewMessageSubscriber extends Subscriber {
     readonly requiresAuth = false;
     listen: (typeof WebViewMessageReceivedEvent)[];

package/dist/entrypoints/queue/processWebViewMessage.subscriber.js

@@ -1,5 +1,5 @@
-import { Subscriber } from "../../domain/event_sourcing";
 import { PrintImageRequestedEvent, WebViewMessageReceivedEvent, } from "../../domain/events";
+import { Subscriber } from "../../event_driven";
 import { DomainValidationError } from "../../exceptions";
 import { EventBus } from "../../infrastructure/workers";
 import { webViewService } from "../../services/webview.service";

package/dist/entrypoints/ui/AppShell.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "nativewind/jsx-runtime";
 import { DefaultTheme as NavDefaultTheme, NavigationContainer, } from "@react-navigation/native";
 import { createApp } from "../../framework/createApp";
-import { ToastHost } from "../../infrastructure/ui/ToastHost";
+import { DeviceNotices } from "../../ui/activity";
 import { setBranding } from "@sincpro/mobile-ui";
 import { ToastProvider } from "@sincpro/mobile-ui/Feedback";
 import { setActiveTheme, themeToVars, useTheme, } from "@sincpro/mobile-ui/theme";
@@ -114,6 +114,6 @@ export function createAppShell(config) {
             const Splash = config.splashComponent;
             return Splash ? (_jsx(Splash, {})) : (_jsx(View, { style: { flex: 1, backgroundColor: activeTheme.bg.page } }));
         }
-        return (_jsx(GestureHandlerRootView, { style: { flex: 1 }, children: _jsx(View, { className: "flex-1", style: themeStyle, children: _jsx(SafeAreaProvider, { initialMetrics: initialWindowMetrics, children: _jsx(SafeAreaView, { edges: ["top"], style: { flex: 1 }, children: _jsx(KeyboardProvider, { children: _jsx(CommonProvider, { darkTheme: config.darkTheme, lightTheme: config.theme, children: _jsxs(ToastProvider, { position: "top", children: [withProviders(providers, _jsx(DomainSwitcherProvider, { apps: apps, initialDomain: config.activeDomain, children: _jsx(NavigationContainer, { theme: navTheme, children: _jsx(ActiveDomainApp, {}) }) })), _jsx(ToastHost, {})] }) }) }) }) }) }) }));
+        return (_jsx(GestureHandlerRootView, { style: { flex: 1 }, children: _jsx(View, { className: "flex-1", style: themeStyle, children: _jsx(SafeAreaProvider, { initialMetrics: initialWindowMetrics, children: _jsx(SafeAreaView, { edges: ["top"], style: { flex: 1 }, children: _jsx(KeyboardProvider, { children: _jsx(CommonProvider, { darkTheme: config.darkTheme, lightTheme: config.theme, children: _jsxs(ToastProvider, { position: "top", children: [withProviders(providers, _jsx(DomainSwitcherProvider, { apps: apps, initialDomain: config.activeDomain, children: _jsx(NavigationContainer, { theme: navTheme, children: _jsx(ActiveDomainApp, {}) }) })), _jsx(DeviceNotices, {})] }) }) }) }) }) }) }));
     };
 }

package/dist/entrypoints/ui/common_provider.d.ts

@@ -4,22 +4,10 @@ export interface TimezoneLocale {
     timezone: string;
     locale: string;
 }
-interface Activity {
-    id: string;
-    label: string;
-    type: "queue" | "cron";
-    status: "running" | "failed";
-    error?: string;
-    startedAt: number;
-}
 interface ICommonContext {
     debugMode: boolean;
     debugModeLoaded: boolean;
     toggleDebugMode: () => Promise<void>;
-    currentActivity?: Activity;
-    lastError?: Activity;
-    isProcessing: boolean;
-    dismiss: () => void;
     hasGeoPermission: boolean;
     geoIsLoading: boolean;
     geoError: string | null;

package/dist/entrypoints/ui/common_provider.js

@@ -1,33 +1,24 @@
 import { jsx as _jsx } from "nativewind/jsx-runtime";
 import { GeoAdapter } from "../../adapters/Geo.adapter";
 import { SettingsRepository } from "../../adapters/repositories/setting.repository";
-import { QueueEndEvent, QueueStartEvent } from "../../domain/events";
-import logger, { loggerUseCases } from "../../infrastructure/logger";
-import { UIEventBus } from "../../infrastructure/ui/UIEventBus";
+import logger from "../../infrastructure/logger";
 import { DEFAULT_DARK_THEME, DEFAULT_THEME, setActiveTheme } from "@sincpro/mobile-ui/theme";
-import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
 import { Appearance, AppState } from "react-native";
 const DEBUG_MODE_SETTING_KEY = "app.debug_mode";
 const TIMEZONE_SETTING_KEY = "app.timezone";
 const LOCALE_SETTING_KEY = "app.locale";
 const COLOR_SCHEME_SETTING_KEY = "app.color_scheme";
-const QUEUE_MIN_VISIBLE_MS = 1200;
 const CommonContext = createContext(null);
 export function CommonProvider({ children, lightTheme, darkTheme }) {
     const [debugMode, setDebugMode] = useState(false);
     const [debugModeLoaded, setDebugModeLoaded] = useState(false);
-    const [currentActivity, setCurrentActivity] = useState(undefined);
-    const [cronTasks, setCronTasks] = useState(new Map());
-    const [lastError, setLastError] = useState(undefined);
-    const [dismissed, setDismissed] = useState(false);
     const [hasGeoPermission, setHasGeoPermission] = useState(false);
     const [geoIsLoading, setGeoIsLoading] = useState(false);
     const [geoError, setGeoError] = useState(null);
     const [locale, setLocale] = useState(null);
     const [timezone, setTimezone] = useState(null);
     const [colorScheme, setColorSchemeState] = useState("system");
-    const errorTimeoutRef = useRef(null);
-    const queueClearTimeoutRef = useRef(null);
     useEffect(() => {
         async function loadDebugMode() {
             const value = await SettingsRepository.getSettingByName(DEBUG_MODE_SETTING_KEY);
@@ -41,14 +32,6 @@ export function CommonProvider({ children, lightTheme, darkTheme }) {
         await SettingsRepository.saveOneSetting(DEBUG_MODE_SETTING_KEY, newValue);
         setDebugMode(newValue);
     }, [debugMode]);
-    const dismiss = useCallback(() => {
-        setDismissed(true);
-        setLastError(undefined);
-        if (errorTimeoutRef.current) {
-            clearTimeout(errorTimeoutRef.current);
-            errorTimeoutRef.current = null;
-        }
-    }, []);
     const checkGeoPermission = useCallback(async () => {
         setGeoIsLoading(true);
         setGeoError(null);
@@ -144,118 +127,10 @@ export function CommonProvider({ children, lightTheme, darkTheme }) {
         }
         loadTimezoneAndLocale();
     }, []);
-    useEffect(() => {
-        loggerUseCases.debug("[CommonProvider] Setting up UIEventBus listeners");
-        function handleQueueStart(payload) {
-            if (!payload || typeof payload !== "object")
-                return;
-            const { event, label } = payload;
-            if (!label)
-                return;
-            setCurrentActivity({
-                id: event,
-                label,
-                type: "queue",
-                status: "running",
-                startedAt: Date.now(),
-            });
-            setDismissed(false);
-        }
-        function handleQueueEnd(payload) {
-            if (!payload || typeof payload !== "object")
-                return;
-            const { event, success = true, error } = payload;
-            setCurrentActivity((current) => {
-                if (current?.id !== event)
-                    return current;
-                if (!success) {
-                    const failedActivity = { ...current, status: "failed", error };
-                    setLastError(failedActivity);
-                    if (errorTimeoutRef.current)
-                        clearTimeout(errorTimeoutRef.current);
-                    errorTimeoutRef.current = setTimeout(() => {
-                        setLastError(undefined);
-                        errorTimeoutRef.current = null;
-                    }, 10000);
-                    return undefined;
-                }
-                // Éxito: mantener visible un mínimo para que la cola sea perceptible
-                // aunque el evento se procese al instante.
-                const remaining = QUEUE_MIN_VISIBLE_MS - (Date.now() - current.startedAt);
-                if (remaining > 0) {
-                    if (queueClearTimeoutRef.current)
-                        clearTimeout(queueClearTimeoutRef.current);
-                    queueClearTimeoutRef.current = setTimeout(() => {
-                        setCurrentActivity((c) => (c?.id === event ? undefined : c));
-                        queueClearTimeoutRef.current = null;
-                    }, remaining);
-                    return current;
-                }
-                return undefined;
-            });
-        }
-        function handleCronStart(payload) {
-            if (!payload || typeof payload !== "object" || !("task" in payload))
-                return;
-            const { task, label } = payload;
-            setCronTasks((prev) => {
-                const next = new Map(prev);
-                next.set(task, {
-                    id: task,
-                    label: label ?? task,
-                    type: "cron",
-                    status: "running",
-                    startedAt: Date.now(),
-                });
-                return next;
-            });
-        }
-        function handleCronEnd(payload) {
-            if (!payload || typeof payload !== "object" || !("task" in payload))
-                return;
-            const { task } = payload;
-            setCronTasks((prev) => {
-                const next = new Map(prev);
-                next.delete(task);
-                return next;
-            });
-        }
-        const unsubscribers = [
-            UIEventBus.on(QueueStartEvent.name, handleQueueStart),
-            UIEventBus.on(QueueEndEvent.name, handleQueueEnd),
-            UIEventBus.on("CRON_START", handleCronStart),
-            UIEventBus.on("CRON_END", handleCronEnd),
-        ];
-        return () => {
-            loggerUseCases.debug("[CommonProvider] Cleaning up UIEventBus listeners");
-            unsubscribers.forEach((unsub) => unsub());
-            if (errorTimeoutRef.current)
-                clearTimeout(errorTimeoutRef.current);
-            if (queueClearTimeoutRef.current)
-                clearTimeout(queueClearTimeoutRef.current);
-        };
-    }, []);
-    const displayActivity = useMemo(() => {
-        if (currentActivity)
-            return currentActivity;
-        const firstCron = cronTasks.values().next().value;
-        if (firstCron)
-            return firstCron;
-        return undefined;
-    }, [currentActivity, cronTasks]);
-    const isProcessing = useMemo(() => {
-        if (dismissed)
-            return false;
-        return !!(currentActivity || cronTasks.size > 0 || lastError);
-    }, [currentActivity, cronTasks, lastError, dismissed]);
     const value = useMemo(() => ({
         debugMode,
         debugModeLoaded,
         toggleDebugMode,
-        currentActivity: displayActivity,
-        lastError,
-        isProcessing,
-        dismiss,
         hasGeoPermission,
         geoIsLoading,
         geoError,
@@ -270,10 +145,6 @@ export function CommonProvider({ children, lightTheme, darkTheme }) {
         debugMode,
         debugModeLoaded,
         toggleDebugMode,
-        displayActivity,
-        lastError,
-        isProcessing,
-        dismiss,
         hasGeoPermission,
         geoIsLoading,
         geoError,

package/dist/event_driven/index.d.ts

@@ -0,0 +1 @@
+export { Subscriber } from "../event_driven/subscriber";

package/dist/event_driven/index.js

@@ -0,0 +1 @@
+export { Subscriber } from "../event_driven/subscriber";

package/dist/{domain/event_sourcing/event_handler.d.ts → event_driven/subscriber.d.ts}

@@ -1,4 +1,4 @@
-import { DomainEvent } from "../../domain/event_sourcing/domain_event";
+import { DomainEvent } from "../domain/events/domain_event";
 export declare abstract class Subscriber {
     abstract listen: (typeof DomainEvent)[];
     readonly requiresAuth: boolean;

package/dist/exceptions.d.ts

@@ -16,6 +16,27 @@ export declare class DomainBackendError extends DomainException {
 export declare class DomainAppError extends DomainException {
     constructor(message: string);
 }
+export declare class StaleAggregate extends DomainException {
+    constructor(message: string);
+}
+export declare class ChecksFailed extends DomainValidationError {
+    readonly failures: {
+        rule: string;
+        message: string;
+        path: string[];
+    }[];
+    constructor(failures: {
+        rule: string;
+        message: string;
+        path: string[];
+    }[]);
+}
+export declare class RepeatableFailure extends DomainException {
+    constructor(message: string);
+}
+export declare class RejectedFailure extends DomainException {
+    constructor(message: string);
+}
 export declare const ValidationError: (message: string) => never;
 export declare const UserError: (message: string) => never;
 export declare const BackendError: (message: string) => never;

package/dist/exceptions.js

@@ -34,6 +34,36 @@ export class DomainAppError extends DomainException {
         this.name = "AppError";
     }
 }
+export class StaleAggregate extends DomainException {
+    constructor(message) {
+        super(message);
+        this.name = "StaleAggregate";
+    }
+}
+export class ChecksFailed extends DomainValidationError {
+    failures;
+    constructor(failures) {
+        super(failures
+            .map((failure) => failure.path.length > 0
+            ? `${failure.path.join(".")}: ${failure.message}`
+            : failure.message)
+            .join("; "));
+        this.failures = failures;
+        this.name = "ChecksFailed";
+    }
+}
+export class RepeatableFailure extends DomainException {
+    constructor(message) {
+        super(message);
+        this.name = "RepeatableFailure";
+    }
+}
+export class RejectedFailure extends DomainException {
+    constructor(message) {
+        super(message);
+        this.name = "RejectedFailure";
+    }
+}
 export const ValidationError = (message) => {
     // setTimeout(() => {
     //   throw new DomainValidationError(message);

package/dist/framework/base_module.d.ts

@@ -1,5 +1,5 @@
 import type { IMigration } from "../domain/database";
-import type { Subscriber } from "../domain/event_sourcing";
+import type { Subscriber } from "../event_driven";
 import type { CronWorker } from "../infrastructure/workers";
 import { DomainModule } from "./domain_module";
 export declare class BaseModule extends DomainModule {

package/dist/framework/createApp.d.ts

@@ -10,10 +10,10 @@ export interface AppConfig {
      */
     telemetry?: TelemetryConfig;
     /**
-     * Override display options for any cron by taskName.
-     * Useful for showing/hiding toasts on internal crons (CHECK_NETWORK, TELEMETRY_FLUSH, etc.).
+     * Override options for any cron by taskName.
+     * `ui` marks the cron for the activity toast. Silence is the default.
      * @example
-     * crons: { CHECK_NETWORK: { showToast: true, label: "Verificando conexión" } }
+     * crons: { CHECK_NETWORK: { ui: true, label: "Verificando conexión" } }
      */
     crons?: Record<string, Partial<CronWorkerOpts>>;
 }

package/dist/framework/domain_module.d.ts

@@ -1,5 +1,5 @@
 import type { IMigration } from "../domain/database";
-import type { Subscriber } from "../domain/event_sourcing";
+import type { Subscriber } from "../event_driven";
 import type { CronWorker } from "../infrastructure/workers";
 export declare abstract class DomainModule {
     abstract readonly key: string;

package/dist/framework/kernel.d.ts

@@ -1,5 +1,5 @@
 import type { IMigration } from "../domain/database";
-import type { Subscriber } from "../domain/event_sourcing";
+import type { Subscriber } from "../event_driven";
 import type { CronWorker, CronWorkerOpts } from "../infrastructure/workers";
 import type { DomainModule } from "./domain_module";
 export declare class Kernel {

package/dist/framework/kernel.js

@@ -1,6 +1,8 @@
+import { applyMigrationStep, migrationsNewerThanApp, pendingMigrations, resetPlan, } from "../domain/database/migration_plan";
 import { repos } from "../entrypoints/db/repositories";
 import { DBCursor } from "../infrastructure/database";
 import { initializeRepositoryFacade } from "../infrastructure/database/mapped";
+import { appliedMigrationNames, forgetMigrations, markMigrationApplied, } from "../infrastructure/database/schema";
 import logger, { loggerRepositories } from "../infrastructure/logger";
 export class Kernel {
     modules;
@@ -45,9 +47,16 @@ export class Kernel {
         }
     }
     async runMigrations() {
-        for (const { name, migrationFn } of this.migrations()) {
-            logger.info(`Running migration: ${name}`);
-            await migrationFn();
+        const applied = await appliedMigrationNames();
+        const migrations = this.migrations();
+        const newer = migrationsNewerThanApp(applied, migrations.map((migration) => migration.name));
+        if (newer.length > 0) {
+            throw new Error(`the database is newer than this app: ${newer.join(", ")}`);
+        }
+        for (const migration of pendingMigrations(migrations, applied)) {
+            logger.info(`Running migration: ${migration.name}`);
+            await applyMigrationStep(migration, (work) => DBCursor.transaction(work), markMigrationApplied);
+            applied.add(migration.name);
         }
     }
     async bootstrap() {
@@ -57,12 +66,12 @@ export class Kernel {
     }
     async restartDatabase() {
         loggerRepositories.warn("Restarting database");
-        const persisted = this.persistedTables();
-        const tablesToDrop = this.migrations().filter((migration) => !persisted.includes(migration.name));
-        for (const { name } of tablesToDrop) {
-            loggerRepositories.info(`Dropping table: ${name}`);
-            await DBCursor.execAsync(`DROP TABLE IF EXISTS ${name}`);
+        const plan = resetPlan(this.migrations(), this.persistedTables());
+        for (const table of plan.drop) {
+            loggerRepositories.info(`Dropping table: ${table}`);
+            await DBCursor.execAsync(`DROP TABLE IF EXISTS ${table}`);
         }
+        await forgetMigrations(plan.forget);
         await this.runMigrations();
     }
 }

package/dist/infrastructure/database/connector.d.ts

@@ -3,6 +3,8 @@ export declare const DB_NAME = "distribution.db";
 export declare function getDatabase(): Promise<SQLiteDatabase>;
 export declare function getDatabaseSync(): SQLiteDatabase;
 export declare const DBCursor: {
+    inTransaction(): boolean;
+    transaction<T>(work: () => Promise<T>): Promise<T>;
     mutateDatabase(query: string, ...params: SQLiteVariadicBindParams): Promise<SQLiteRunResult>;
     getFirstAsync<T>(query: string, ...params: SQLiteVariadicBindParams): Promise<T | null>;
     getAllAsync<T>(query: string, ...params: SQLiteVariadicBindParams): Promise<T[]>;

package/dist/infrastructure/database/connector.js

@@ -3,6 +3,7 @@ import { Mutex } from "async-mutex";
 import { openDatabaseAsync, openDatabaseSync, } from "expo-sqlite";
 export const DB_NAME = "distribution.db";
 let dbInstance = null;
+let currentTx = null;
 const dbLock = new Mutex();
 // Telemetry/queue tables are excluded from query logging: logging their
 // mutations would feed the log pipeline its own writes — and a failing
@@ -45,12 +46,33 @@ export function getDatabaseSync() {
     return dbInstance;
 }
 async function withDB(fn) {
+    if (currentTx)
+        return fn(currentTx);
     return dbLock.runExclusive(async () => fn(await getDatabase()));
 }
 function withDBSync(fn) {
     return fn(getDatabaseSync());
 }
 export const DBCursor = {
+    inTransaction() {
+        return currentTx !== null;
+    },
+    async transaction(work) {
+        return dbLock.runExclusive(async () => {
+            const db = await getDatabase();
+            let result;
+            await db.withTransactionAsync(async () => {
+                currentTx = db;
+                try {
+                    result = await work();
+                }
+                finally {
+                    currentTx = null;
+                }
+            });
+            return result;
+        });
+    },
     async mutateDatabase(query, ...params) {
         const safeQuery = `${query.trim()};`;
         return withDB(async (db) => {

package/dist/infrastructure/database/index.d.ts

@@ -1,2 +1,3 @@
 export { DB_NAME, DBCursor } from "./connector";
 export { mapped, resolveEntity } from "./mapped";
+export { addColumnIfMissing, addColumnIfMissingSync } from "./schema";

package/dist/infrastructure/database/index.js

@@ -1,2 +1,3 @@
 export { DB_NAME, DBCursor } from "./connector";
 export { mapped, resolveEntity } from "./mapped";
+export { addColumnIfMissing, addColumnIfMissingSync } from "./schema";

package/dist/infrastructure/database/schema.d.ts

@@ -0,0 +1,9 @@
+export declare function assertSqlIdentifier(name: string): void;
+export declare function addColumnStatement(table: string, column: string, definition: string): string;
+export declare function tableColumns(table: string): Promise<string[]>;
+export declare function tableColumnsSync(table: string): string[];
+export declare function addColumnIfMissing(table: string, column: string, definition: string): Promise<void>;
+export declare function addColumnIfMissingSync(table: string, column: string, definition: string): void;
+export declare function appliedMigrationNames(): Promise<Set<string>>;
+export declare function markMigrationApplied(name: string): Promise<void>;
+export declare function forgetMigrations(names: readonly string[]): Promise<void>;