stellar-drive 1.0.0

package/dist/entries/stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../src/entries/stores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAChF,6EAA6E;AAC7E,4EAA4E;AAC5E,gFAAgF;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,kDAAkD;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAChF,4EAA4E;AAC5E,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAChF,wDAAwD;AACxD,sEAAsE;AACtE,6EAA6E;AAC7E,+EAA+E;AAE/E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAElF,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAChF,2DAA2D;AAC3D,0EAA0E;AAC1E,2EAA2E;AAC3E,mCAAmC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAE7E,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/entries/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Types subpath barrel — `stellar-drive/types`
+ *
+ * Aggregates all public TypeScript type exports from the stellar-drive package
+ * into a single, convenient entry point. Consumers can import any type from
+ * this path without needing to know the internal module structure.
+ *
+ * No runtime code is emitted from this file — it contains only `export type`
+ * statements and will be fully erased during compilation.
+ */
+export type { SyncEngineConfig, TableConfig, InitEngineInput } from '../config';
+export type { DatabaseConfig, DatabaseVersionConfig, SchemaVersionResult } from '../database';
+export type { BatchOperation } from '../data';
+export type { AuthStateResult } from '../auth/resolveAuthState';
+export type { AppConfig } from '../runtime/runtimeConfig';
+export type { SyncOperationItem, OperationType, OfflineCredentials, OfflineSession, ConflictHistoryEntry, SyncStatus, AuthMode, SingleUserConfig, SingleUserGateType, SchemaDefinition, SchemaTableConfig, AuthConfig, FieldType } from '../types';
+export type { SyncError, RealtimeState } from '../stores/sync';
+export type { RemoteActionType } from '../stores/remoteChanges';
+export type { DiagnosticsSnapshot } from '../diagnostics';
+export type { Session } from '@supabase/supabase-js';
+export type { CRDTConfig, UserPresenceState } from '../crdt/types';
+export type { SQLGenerationOptions, TypeScriptGenerationOptions } from '../schema';
+//# sourceMappingURL=types.d.ts.map

package/dist/entries/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/entries/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAQhF,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAQ9F,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQ9C,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAOhE,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAe1D,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,SAAS,EACV,MAAM,UAAU,CAAC;AASlB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAOhE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAQ1D,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQrD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOnE,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC"}

package/dist/entries/types.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Types subpath barrel — `stellar-drive/types`
+ *
+ * Aggregates all public TypeScript type exports from the stellar-drive package
+ * into a single, convenient entry point. Consumers can import any type from
+ * this path without needing to know the internal module structure.
+ *
+ * No runtime code is emitted from this file — it contains only `export type`
+ * statements and will be fully erased during compilation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/entries/types.js.map

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

package/dist/entries/utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Utils subpath barrel — `stellar-drive/utils`
+ *
+ * Re-exports general-purpose utility functions, debug tooling, and the
+ * unified diagnostics API. These helpers are framework-agnostic and can
+ * be used anywhere in the application.
+ */
+export { generateId, now, calculateNewOrder, snakeToCamel, formatBytes } from '../utils';
+export { debug, isDebugMode, setDebugMode } from '../debug';
+export { getDiagnostics, getSyncDiagnostics, getRealtimeDiagnostics, getQueueDiagnostics, getConflictDiagnostics, getEngineDiagnostics, getNetworkDiagnostics, getErrorDiagnostics } from '../diagnostics';
+export { generateSupabaseSQL, inferColumnType, generateMigrationSQL, generateTypeScript } from '../schema';
+//# sourceMappingURL=utils.d.ts.map

package/dist/entries/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/entries/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAUzF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAS5D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,WAAW,CAAC"}

package/dist/entries/utils.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Utils subpath barrel — `stellar-drive/utils`
+ *
+ * Re-exports general-purpose utility functions, debug tooling, and the
+ * unified diagnostics API. These helpers are framework-agnostic and can
+ * be used anywhere in the application.
+ */
+// =============================================================================
+//  General Utilities
+// =============================================================================
+// Pure helper functions for common operations:
+// - `generateId` — produces a unique identifier (UUID v4 or similar).
+// - `now` — returns the current ISO 8601 timestamp string.
+// - `calculateNewOrder` — computes a fractional order value for reorderable
+//   lists (inserts between two adjacent items without reindexing).
+// - `snakeToCamel` — converts a `snake_case` string to `camelCase`.
+// - `formatBytes` — formats a byte count into a human-readable string.
+export { generateId, now, calculateNewOrder, snakeToCamel, formatBytes } from '../utils';
+// =============================================================================
+//  Debug Utilities
+// =============================================================================
+// Development-time logging and debug mode management:
+// - `debug` — conditional logger that only outputs when debug mode is active.
+// - `isDebugMode` — returns whether debug mode is currently enabled.
+// - `setDebugMode` — enables or disables debug mode at runtime.
+export { debug, isDebugMode, setDebugMode } from '../debug';
+// =============================================================================
+//  Diagnostics
+// =============================================================================
+// Unified diagnostics API for inspecting sync engine internal state:
+// - `getDiagnostics` — returns a comprehensive JSON snapshot of all engine state.
+// - Sub-category functions for lightweight access to specific sections.
+export { getDiagnostics, getSyncDiagnostics, getRealtimeDiagnostics, getQueueDiagnostics, getConflictDiagnostics, getEngineDiagnostics, getNetworkDiagnostics, getErrorDiagnostics } from '../diagnostics';
+// =============================================================================
+//  SQL Generation
+// =============================================================================
+// Generate complete Supabase SQL from a declarative schema definition:
+// - `generateSupabaseSQL` — produces CREATE TABLE, RLS, triggers, indexes.
+// - `inferColumnType` — maps field names to SQL types via naming conventions.
+// - `generateMigrationSQL` — diffs two schemas and produces ALTER statements.
+export { generateSupabaseSQL, inferColumnType, generateMigrationSQL, generateTypeScript } from '../schema';
+//# sourceMappingURL=utils.js.map

package/dist/entries/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/entries/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAChF,+CAA+C;AAC/C,sEAAsE;AACtE,2DAA2D;AAC3D,4EAA4E;AAC5E,mEAAmE;AACnE,oEAAoE;AACpE,uEAAuE;AAEvE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,sDAAsD;AACtD,8EAA8E;AAC9E,qEAAqE;AACrE,gEAAgE;AAEhE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5D,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAChF,qEAAqE;AACrE,kFAAkF;AAClF,wEAAwE;AAExE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAChF,uEAAuE;AACvE,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAE9E,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,WAAW,CAAC"}

package/dist/entries/vite.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Vite subpath barrel — `stellar-drive/vite`
+ *
+ * Provides the Vite plugin for building and configuring the service worker
+ * required by stellar-drive's PWA functionality. This entry point is intended
+ * for use in `vite.config.ts` only — it runs at build time, not in the browser.
+ *
+ * Usage:
+ * ```ts
+ * // vite.config.ts
+ * import { stellarPWA } from 'stellar-drive/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [stellarPWA({ /* SWConfig options *\/ })]
+ * });
+ * ```
+ */
+export { stellarPWA } from '../sw/build/vite-plugin.js';
+export type { SWConfig, SchemaConfig } from '../sw/build/vite-plugin.js';
+//# sourceMappingURL=vite.d.ts.map

package/dist/entries/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/entries/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/entries/vite.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Vite subpath barrel — `stellar-drive/vite`
+ *
+ * Provides the Vite plugin for building and configuring the service worker
+ * required by stellar-drive's PWA functionality. This entry point is intended
+ * for use in `vite.config.ts` only — it runs at build time, not in the browser.
+ *
+ * Usage:
+ * ```ts
+ * // vite.config.ts
+ * import { stellarPWA } from 'stellar-drive/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [stellarPWA({ /* SWConfig options *\/ })]
+ * });
+ * ```
+ */
+// =============================================================================
+//  Stellar PWA Vite Plugin
+// =============================================================================
+// - `stellarPWA` — Vite plugin factory that generates and injects a service
+//   worker with precaching, runtime caching strategies, and offline support.
+// - `SWConfig` — configuration interface for customizing cache strategies,
+//   precache globs, network-first vs cache-first routes, and SW behaviour.
+export { stellarPWA } from '../sw/build/vite-plugin.js';
+//# sourceMappingURL=vite.js.map

package/dist/entries/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/entries/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview Main entry point — `stellar-drive`
+ *
+ * This is the primary barrel export for the stellar-drive package. It
+ * re-exports the **full** public API surface, covering:
+ *
+ * - **Engine Configuration & Lifecycle** — initialize, start, and run the
+ *   offline-first sync engine.
+ * - **Database Access** — get a handle to the IndexedDB instance or reset it.
+ * - **Generic CRUD & Query** — create, read, update, delete, batch write,
+ *   increment, and query data in the local database.
+ * - **Authentication** — Single-user PIN/password gate auth, device
+ *   verification, login guards, and session management.
+ * - **Reactive Stores** — Svelte-compatible stores for sync status, network
+ *   state, remote changes, and auth state.
+ * - **Realtime Events** — lifecycle hooks for sync completion and realtime
+ *   data updates.
+ * - **Runtime Configuration** — read and write app-level config at runtime.
+ * - **Debug & Utilities** — logging, ID generation, ordering, and string
+ *   conversion helpers.
+ * - **Svelte Actions** — DOM-level directives for remote-change animations.
+ * - **Type Definitions** — all public TypeScript types and interfaces.
+ * - **Supabase Client** — direct access to the Supabase client for advanced
+ *   or custom queries.
+ * - **Supabase Validation** — server-side credential and schema validation.
+ *
+ * For tree-shaking or smaller bundle sizes, prefer the subpath entry points
+ * (e.g. `stellar-drive/auth`, `stellar-drive/stores`)
+ * which expose focused subsets of this API.
+ */
+export { initEngine } from './config';
+export type { SyncEngineConfig, TableConfig, InitEngineInput } from './config';
+export { getDb, resetDatabase } from './database';
+export type { DatabaseConfig, DatabaseVersionConfig } from './database';
+export { SYSTEM_INDEXES, computeSchemaVersion } from './database';
+export type { SchemaVersionResult } from './database';
+export { startSyncEngine, runFullSync } from './engine';
+export { onSyncComplete } from './engine';
+export { engineCreate, engineUpdate, engineDelete, engineBatchWrite, engineIncrement } from './data';
+export type { BatchOperation } from './data';
+export { engineGet, engineGetAll, engineQuery, engineQueryRange, engineGetOrCreate } from './data';
+export { queryAll, queryOne, reorderEntity, prependOrder } from './data';
+export { signOut, resendConfirmationEmail, getUserProfile, updateProfile, verifyOtp, getValidSession } from './supabase/auth';
+export { resolveAuthState } from './auth/resolveAuthState';
+export type { AuthStateResult } from './auth/resolveAuthState';
+export { resetLoginGuard } from './auth/loginGuard';
+export { isSingleUserSetUp, getSingleUserInfo, setupSingleUser, unlockSingleUser, lockSingleUser, changeSingleUserGate, updateSingleUserProfile, resetSingleUser, completeSingleUserSetup, completeDeviceVerification, pollDeviceVerification, padPin, changeSingleUserEmail, completeSingleUserEmailChange, fetchRemoteGateConfig, linkSingleUserDevice, resetSingleUserRemote } from './auth/singleUser';
+export { resolveFirstName, resolveUserId, resolveAvatarInitial } from './auth/displayUtils';
+export { isDeviceTrusted, trustCurrentDevice, trustPendingDevice, getTrustedDevices, removeTrustedDevice, maskEmail, sendDeviceVerification, getCurrentDeviceId, getDeviceLabel } from './auth/deviceVerification';
+export { syncStatusStore } from './stores/sync';
+export type { SyncError, RealtimeState } from './stores/sync';
+export { remoteChangesStore } from './stores/remoteChanges';
+export type { RemoteActionType } from './stores/remoteChanges';
+export { isOnline } from './stores/network';
+export { authState, isAuthenticated, userDisplayInfo } from './stores/authState';
+export { createCollectionStore, createDetailStore } from './stores/factories';
+export type { CollectionStore, CollectionStoreConfig, DetailStore, DetailStoreConfig } from './stores/factories';
+export { onRealtimeDataUpdate } from './realtime';
+export { supabase } from './supabase/client';
+export { initConfig, getConfig, setConfig } from './runtime/runtimeConfig';
+export type { AppConfig } from './runtime/runtimeConfig';
+export { debug, isDebugMode, setDebugMode } from './debug';
+export { generateId, now, calculateNewOrder, snakeToCamel, formatBytes } from './utils';
+export { getDiagnostics, getSyncDiagnostics, getRealtimeDiagnostics, getQueueDiagnostics, getConflictDiagnostics, getEngineDiagnostics, getNetworkDiagnostics, getErrorDiagnostics } from './diagnostics';
+export type { DiagnosticsSnapshot } from './diagnostics';
+export { remoteChangeAnimation, trackEditing, triggerLocalAnimation } from './actions/remoteChange';
+export { isDemoMode, setDemoMode, seedDemoData, cleanupDemoDatabase, getDemoConfig } from './demo';
+export type { DemoConfig } from './demo';
+export type { SyncOperationItem, OperationType, OfflineCredentials, OfflineSession, ConflictHistoryEntry, SyncStatus, AuthMode, SingleUserConfig, SingleUserGateType, TrustedDevice, SchemaDefinition, SchemaTableConfig, AuthConfig, FieldType } from './types';
+export { generateSupabaseSQL, inferColumnType, generateMigrationSQL, generateTypeScript } from './schema';
+export type { SQLGenerationOptions, TypeScriptGenerationOptions } from './schema';
+export type { Session } from '@supabase/supabase-js';
+export { validateSupabaseCredentials, validateSchema } from './supabase/validate';
+export { isCRDTEnabled } from './crdt/config';
+export type { CRDTConfig } from './crdt/types';
+export type { UserPresenceState } from './crdt/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,234 @@
+/**
+ * @fileoverview Main entry point — `stellar-drive`
+ *
+ * This is the primary barrel export for the stellar-drive package. It
+ * re-exports the **full** public API surface, covering:
+ *
+ * - **Engine Configuration & Lifecycle** — initialize, start, and run the
+ *   offline-first sync engine.
+ * - **Database Access** — get a handle to the IndexedDB instance or reset it.
+ * - **Generic CRUD & Query** — create, read, update, delete, batch write,
+ *   increment, and query data in the local database.
+ * - **Authentication** — Single-user PIN/password gate auth, device
+ *   verification, login guards, and session management.
+ * - **Reactive Stores** — Svelte-compatible stores for sync status, network
+ *   state, remote changes, and auth state.
+ * - **Realtime Events** — lifecycle hooks for sync completion and realtime
+ *   data updates.
+ * - **Runtime Configuration** — read and write app-level config at runtime.
+ * - **Debug & Utilities** — logging, ID generation, ordering, and string
+ *   conversion helpers.
+ * - **Svelte Actions** — DOM-level directives for remote-change animations.
+ * - **Type Definitions** — all public TypeScript types and interfaces.
+ * - **Supabase Client** — direct access to the Supabase client for advanced
+ *   or custom queries.
+ * - **Supabase Validation** — server-side credential and schema validation.
+ *
+ * For tree-shaking or smaller bundle sizes, prefer the subpath entry points
+ * (e.g. `stellar-drive/auth`, `stellar-drive/stores`)
+ * which expose focused subsets of this API.
+ */
+// =============================================================================
+//  Engine Configuration
+// =============================================================================
+// `initEngine` bootstraps the sync engine with the provided configuration
+// (Supabase credentials, table definitions, conflict strategies, etc.).
+// `SyncEngineConfig` and `TableConfig` describe the configuration shape.
+export { initEngine } from './config';
+// =============================================================================
+//  Database Access
+// =============================================================================
+// Direct access to the underlying IndexedDB database:
+// - `getDb` — returns a typed handle to the open database instance.
+// - `resetDatabase` — deletes and re-creates the local database (destructive).
+export { getDb, resetDatabase } from './database';
+export { SYSTEM_INDEXES, computeSchemaVersion } from './database';
+// =============================================================================
+//  Engine Lifecycle
+// =============================================================================
+// Controls for the sync engine's runtime lifecycle:
+// - `startSyncEngine` — begins periodic background sync and realtime
+//   subscription after the engine has been initialized.
+// - `runFullSync` — triggers an immediate full sync cycle (push + pull).
+// - `onSyncComplete` — registers a callback that fires after each successful
+//   sync cycle (useful for refreshing UI or derived data).
+export { startSyncEngine, runFullSync } from './engine';
+export { onSyncComplete } from './engine';
+// =============================================================================
+//  Generic CRUD Operations
+// =============================================================================
+// Framework-agnostic data mutation functions that write to IndexedDB and queue
+// changes for the next sync cycle:
+// - `engineCreate` — inserts a new entity.
+// - `engineUpdate` — patches an existing entity.
+// - `engineDelete` — marks an entity as deleted (soft-delete for sync).
+// - `engineBatchWrite` — applies multiple operations atomically.
+// - `engineIncrement` — atomically increments a numeric field.
+export { engineCreate, engineUpdate, engineDelete, engineBatchWrite, engineIncrement } from './data';
+// =============================================================================
+//  Generic Query Operations
+// =============================================================================
+// Read-only data access functions that query the local IndexedDB:
+// - `engineGet` — retrieves a single entity by primary key.
+// - `engineGetAll` — retrieves all entities in a table.
+// - `engineQuery` — retrieves entities matching a key-value filter.
+// - `engineQueryRange` — retrieves entities within an IDB key range.
+// - `engineGetOrCreate` — retrieves an entity or creates it with defaults.
+export { engineGet, engineGetAll, engineQuery, engineQueryRange, engineGetOrCreate } from './data';
+// =============================================================================
+//  Query & Repository Helpers
+// =============================================================================
+// Convenience wrappers that eliminate repetitive query and repository patterns:
+// - `queryAll` — fetches all non-deleted records, sorted by order.
+// - `queryOne` — fetches a single non-deleted record by ID.
+// - `reorderEntity` — updates just the order field on any entity.
+// - `prependOrder` — computes the next prepend-order value.
+export { queryAll, queryOne, reorderEntity, prependOrder } from './data';
+// =============================================================================
+//  Supabase Auth — Core Authentication Utilities
+// =============================================================================
+// Sign-out with full teardown, session management, profile CRUD, email
+// confirmation resend, OTP verification, and session validation.
+export { signOut, resendConfirmationEmail, getUserProfile, updateProfile, verifyOtp, getValidSession } from './supabase/auth';
+// =============================================================================
+//  Auth State Resolution
+// =============================================================================
+// Determines the user's authentication state during app initialization.
+// Returns an `AuthStateResult` describing whether the user is authenticated,
+// anonymous, has an expired session, or needs setup.
+export { resolveAuthState } from './auth/resolveAuthState';
+// =============================================================================
+//  Login Guard
+// =============================================================================
+// Prevents duplicate login attempts by maintaining a transient lock.
+// `resetLoginGuard` clears the lock (e.g. after a failed attempt).
+export { resetLoginGuard } from './auth/loginGuard';
+// =============================================================================
+//  Single-User Auth (PIN/Password Gate)
+// =============================================================================
+// Full lifecycle for single-user (kiosk/personal device) authentication:
+// setup, lock/unlock, profile management, device linking, and remote config.
+export { isSingleUserSetUp, getSingleUserInfo, setupSingleUser, unlockSingleUser, lockSingleUser, changeSingleUserGate, updateSingleUserProfile, resetSingleUser, completeSingleUserSetup, completeDeviceVerification, pollDeviceVerification, padPin, changeSingleUserEmail, completeSingleUserEmailChange, fetchRemoteGateConfig, linkSingleUserDevice, resetSingleUserRemote } from './auth/singleUser';
+// =============================================================================
+//  Auth Display Utilities
+// =============================================================================
+// Pure helper functions that resolve user-facing display values from the auth
+// state. Each handles the full fallback chain across online (Supabase session)
+// and offline (cached credential) modes.
+export { resolveFirstName, resolveUserId, resolveAvatarInitial } from './auth/displayUtils';
+// =============================================================================
+//  Device Verification
+// =============================================================================
+// Trust management for multi-device single-user setups:
+// - `isDeviceTrusted` / `trustCurrentDevice` / `trustPendingDevice` — manage
+//   the trust status of the current or a pending device.
+// - `getTrustedDevices` / `removeTrustedDevice` — list and revoke trusted devices.
+// - `maskEmail` — partially masks an email for display during verification.
+// - `sendDeviceVerification` — initiates the device verification email flow.
+// - `getCurrentDeviceId` / `getDeviceLabel` — device identification helpers.
+export { isDeviceTrusted, trustCurrentDevice, trustPendingDevice, getTrustedDevices, removeTrustedDevice, maskEmail, sendDeviceVerification, getCurrentDeviceId, getDeviceLabel } from './auth/deviceVerification';
+// =============================================================================
+//  Reactive Stores
+// =============================================================================
+// Svelte-compatible stores providing real-time observability into the engine:
+// - `syncStatusStore` — sync lifecycle state, pending count, errors, realtime state.
+// - `remoteChangesStore` — incoming remote changes and deferred-change tracking.
+// - `isOnline` — boolean reflecting browser online/offline status.
+// - `authState` / `isAuthenticated` / `userDisplayInfo` — auth state stores.
+export { syncStatusStore } from './stores/sync';
+export { remoteChangesStore } from './stores/remoteChanges';
+export { isOnline } from './stores/network';
+export { authState, isAuthenticated, userDisplayInfo } from './stores/authState';
+// =============================================================================
+//  Store Factories
+// =============================================================================
+// Generic factory functions for creating reactive stores with built-in loading
+// state and sync-complete auto-refresh.
+export { createCollectionStore, createDetailStore } from './stores/factories';
+// =============================================================================
+//  Realtime Event Subscriptions
+// =============================================================================
+// Callback registration for app-specific event hooks. `onRealtimeDataUpdate`
+// fires when a realtime payload is received and applied to the local database,
+// allowing the app to react to cross-device changes.
+export { onRealtimeDataUpdate } from './realtime';
+// =============================================================================
+//  Supabase Client (Advanced / Custom Queries)
+// =============================================================================
+// Direct access to the initialized Supabase client instance. Use this for
+// queries or operations not covered by the generic CRUD layer (e.g. RPC calls,
+// storage operations, or custom PostgREST filters).
+export { supabase } from './supabase/client';
+// =============================================================================
+//  Runtime Configuration
+// =============================================================================
+// Application-level configuration store:
+// - `initConfig` — initializes with defaults on app boot.
+// - `getConfig` — reads the current configuration snapshot.
+// - `setConfig` — merges partial updates into the active configuration.
+export { initConfig, getConfig, setConfig } from './runtime/runtimeConfig';
+// =============================================================================
+//  Debug Utilities
+// =============================================================================
+// Development-time logging and debug mode management:
+// - `debug` — conditional logger (only outputs when debug mode is active).
+// - `isDebugMode` / `setDebugMode` — query and toggle debug mode at runtime.
+export { debug, isDebugMode, setDebugMode } from './debug';
+// =============================================================================
+//  General Utilities
+// =============================================================================
+// Pure helper functions:
+// - `generateId` — produces a unique identifier.
+// - `now` — returns the current ISO 8601 timestamp.
+// - `calculateNewOrder` — computes fractional order for reorderable lists.
+// - `snakeToCamel` — converts `snake_case` to `camelCase`.
+export { generateId, now, calculateNewOrder, snakeToCamel, formatBytes } from './utils';
+// =============================================================================
+//  Diagnostics
+// =============================================================================
+// Unified diagnostics API for inspecting sync engine internal state.
+// `getDiagnostics()` returns a comprehensive JSON snapshot; sub-category
+// functions provide lightweight access to specific sections.
+export { getDiagnostics, getSyncDiagnostics, getRealtimeDiagnostics, getQueueDiagnostics, getConflictDiagnostics, getEngineDiagnostics, getNetworkDiagnostics, getErrorDiagnostics } from './diagnostics';
+// =============================================================================
+//  Svelte Actions
+// =============================================================================
+// DOM-level `use:action` directives for remote-change visual feedback:
+// - `remoteChangeAnimation` — applies a highlight/pulse when a remote update arrives.
+// - `trackEditing` — marks an element as actively being edited.
+// - `triggerLocalAnimation` — manually fires the animation for local feedback.
+export { remoteChangeAnimation, trackEditing, triggerLocalAnimation } from './actions/remoteChange';
+// =============================================================================
+//  Demo Mode
+// =============================================================================
+// Demo mode provides a completely isolated sandbox for consumer apps:
+// - `isDemoMode` — checks whether the app is running in demo mode.
+// - `setDemoMode` — activates or deactivates demo mode (requires page reload).
+// - `seedDemoData` — seeds the demo database with mock data (idempotent).
+// - `cleanupDemoDatabase` — deletes the demo database entirely.
+// - `DemoConfig` — configuration interface for demo mode.
+export { isDemoMode, setDemoMode, seedDemoData, cleanupDemoDatabase, getDemoConfig } from './demo';
+// =============================================================================
+//  SQL Generation
+// =============================================================================
+// Generate complete Supabase SQL from a declarative schema definition.
+// These are also available via `stellar-drive/utils`.
+export { generateSupabaseSQL, inferColumnType, generateMigrationSQL, generateTypeScript } from './schema';
+// =============================================================================
+//  Supabase Credential Validation (Server-Side)
+// =============================================================================
+// Server-side utilities for validating Supabase credentials and database
+// schema during initial app setup flows:
+// - `validateSupabaseCredentials` — tests that the provided URL and anon key
+//   can successfully connect to a Supabase project.
+// - `validateSchema` — verifies that the required database tables and columns
+//   exist in the connected Supabase project.
+export { validateSupabaseCredentials, validateSchema } from './supabase/validate';
+// =============================================================================
+//  CRDT Collaborative Editing
+// =============================================================================
+// Optional CRDT subsystem for real-time collaborative document editing.
+// Only functional when `crdt` config is provided to `initEngine()`.
+// For tree-shaking, prefer the subpath: `stellar-drive/crdt`.
+export { isCRDTEnabled } from './crdt/config';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAChF,0EAA0E;AAC1E,wEAAwE;AACxE,yEAAyE;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,sDAAsD;AACtD,oEAAoE;AACpE,+EAA+E;AAE/E,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlE,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAChF,oDAAoD;AACpD,qEAAqE;AACrE,wDAAwD;AACxD,yEAAyE;AACzE,6EAA6E;AAC7E,2DAA2D;AAE3D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAChF,+EAA+E;AAC/E,mCAAmC;AACnC,2CAA2C;AAC3C,iDAAiD;AACjD,wEAAwE;AACxE,iEAAiE;AACjE,+DAA+D;AAE/D,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,QAAQ,CAAC;AAGhB,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAChF,kEAAkE;AAClE,4DAA4D;AAC5D,wDAAwD;AACxD,oEAAoE;AACpE,qEAAqE;AACrE,2EAA2E;AAE3E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEnG,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAChF,gFAAgF;AAChF,mEAAmE;AACnE,4DAA4D;AAC5D,kEAAkE;AAClE,4DAA4D;AAE5D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzE,gFAAgF;AAChF,iDAAiD;AACjD,gFAAgF;AAChF,uEAAuE;AACvE,iEAAiE;AAEjE,OAAO,EACL,OAAO,EACP,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,SAAS,EACT,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAChF,wEAAwE;AACxE,6EAA6E;AAC7E,qDAAqD;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAChF,qEAAqE;AACrE,mEAAmE;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAChF,yEAAyE;AACzE,6EAA6E;AAE7E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,MAAM,EACN,qBAAqB,EACrB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,yCAAyC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE5F,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAChF,wDAAwD;AACxD,6EAA6E;AAC7E,yDAAyD;AACzD,mFAAmF;AACnF,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAE7E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,8EAA8E;AAC9E,qFAAqF;AACrF,iFAAiF;AACjF,mEAAmE;AACnE,6EAA6E;AAE7E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEjF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,+EAA+E;AAC/E,wCAAwC;AAExC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQ9E,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,qDAAqD;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAChF,0EAA0E;AAC1E,+EAA+E;AAC/E,oDAAoD;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAChF,yCAAyC;AACzC,0DAA0D;AAC1D,4DAA4D;AAC5D,wEAAwE;AAExE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAG3E,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,sDAAsD;AACtD,2EAA2E;AAC3E,6EAA6E;AAE7E,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3D,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAChF,yBAAyB;AACzB,iDAAiD;AACjD,oDAAoD;AACpD,2EAA2E;AAC3E,2DAA2D;AAE3D,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExF,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAChF,qEAAqE;AACrE,yEAAyE;AACzE,6DAA6D;AAE7D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAGvB,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAChF,uEAAuE;AACvE,sFAAsF;AACtF,gEAAgE;AAChE,+EAA+E;AAE/E,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpG,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAChF,sEAAsE;AACtE,mEAAmE;AACnE,+EAA+E;AAC/E,0EAA0E;AAC1E,gEAAgE;AAChE,0DAA0D;AAE1D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AA0BnG,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAChF,uEAAuE;AACvE,sDAAsD;AAEtD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAWlB,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAChF,yEAAyE;AACzE,yCAAyC;AACzC,6EAA6E;AAC7E,oDAAoD;AACpD,8EAA8E;AAC9E,6CAA6C;AAE7C,OAAO,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAElF,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAChF,wEAAwE;AACxE,oEAAoE;AACpE,8DAA8D;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/kit/auth.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Auth hydration helper for the root layout component.
+ *
+ * This module bridges the gap between SvelteKit's server-side load data and
+ * the client-side reactive auth store (`authState`). When the root layout
+ * receives auth-related data from a load function, this helper inspects the
+ * `authMode` discriminator and calls the corresponding `authState.set*()`
+ * setter so that every downstream component gets reactive access to the
+ * current authentication state without needing to know the hydration details.
+ *
+ * @module kit/auth
+ *
+ * @example
+ * ```svelte
+ * <!-- +layout.svelte -->
+ * <script lang="ts">
+ *   import { hydrateAuthState } from 'stellar-drive/kit/auth';
+ *   let { data } = $props();
+ *   $effect(() => { hydrateAuthState(data); });
+ * </script>
+ * ```
+ *
+ * @see {@link authState} for the reactive store being hydrated
+ * @see {@link resolveAuthState} in `auth/resolveAuthState.ts` for how auth
+ *      state is determined on the server/load side
+ */
+import type { AuthMode, OfflineCredentials } from '../types.js';
+import type { Session } from '@supabase/supabase-js';
+/**
+ * Shape of the layout data expected by `hydrateAuthState`.
+ *
+ * This interface mirrors the return type of the root layout load function,
+ * containing the three fields needed to fully reconstruct auth state on the
+ * client side.
+ */
+export interface AuthLayoutData {
+    /**
+     * Discriminator indicating which authentication strategy is active.
+     * - `'supabase'` — cloud-hosted auth via Supabase
+     * - `'offline'`  — local/offline credentials (single-user mode)
+     * - `'none'`     — no active authentication
+     */
+    authMode: AuthMode;
+    /**
+     * The Supabase session object, present only when `authMode === 'supabase'`.
+     * Contains the access token, refresh token, and user metadata.
+     */
+    session: Session | null;
+    /**
+     * The offline profile credentials, present only when `authMode === 'offline'`.
+     * Contains locally-stored user identity information for single-user setups.
+     */
+    offlineProfile: OfflineCredentials | null;
+}
+/**
+ * Reads layout load data (`{ authMode, session, offlineProfile }`) and calls
+ * the appropriate `authState.set*()` method to hydrate the client-side
+ * reactive auth store.
+ *
+ * The function acts as a switchboard: it inspects `authMode` and delegates to
+ * the matching setter on the `authState` store. This keeps the root layout
+ * component free of branching logic and ensures a single source of truth for
+ * how layout data maps to reactive state.
+ *
+ * Call this from a Svelte 5 `$effect()` in your root `+layout.svelte` so it
+ * re-runs whenever the layout data changes (e.g. after a login or logout):
+ *
+ * @param layoutData - The auth-related subset of root layout load data.
+ *
+ * @example
+ * ```ts
+ * // In +layout.svelte
+ * $effect(() => { hydrateAuthState(data); });
+ * ```
+ *
+ * @see {@link AuthLayoutData} for the expected shape of `layoutData`
+ * @see {@link authState} for the store methods being invoked
+ */
+export declare function hydrateAuthState(layoutData: AuthLayoutData): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/kit/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/kit/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMrD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAgBjE"}