canto-data 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Boueke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# canto-data
+
+[![npm version](https://img.shields.io/npm/v/canto-data.svg)](https://www.npmjs.com/package/canto-data)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![CI](https://github.com/pboueke/canto-data/actions/workflows/ci.yml/badge.svg)](https://github.com/pboueke/canto-data/actions/workflows/ci.yml)
+
+Data model library for [Canto](https://github.com/pboueke/canto), a private encrypted journaling app. Provides TypeScript types, runtime validation, schema versioning, migration infrastructure, and export format utilities for Canto journals.
+
+**MIT-licensed** with **zero dependencies** — use it to build tools that read, validate, or manipulate Canto journals without copyleft obligations.
+
+## Installation
+
+```bash
+npm install canto-data
+```
+
+## Quick Start
+
+```typescript
+import {
+  type JournalContent,
+  type Page,
+  SCHEMA_VERSION,
+  validateJournalContent,
+  ValidationError,
+  parseManifest,
+  migrateIfNeeded,
+} from 'canto-data';
+
+// Validate untrusted journal data
+try {
+  const journal = validateJournalContent(untrustedData);
+} catch (err) {
+  if (err instanceof ValidationError) {
+    console.error(`${err.field}: expected ${err.expected}, got ${err.received}`);
+  }
+}
+
+// Parse an export manifest
+const manifest = parseManifest(manifestJsonString);
+
+// Migrate data to latest schema
+const result = migrateIfNeeded(rawData, manifest.schemaVersion);
+```
+
+## Documentation
+
+See **[DATA.md](DATA.md)** for the full data model reference, export format specification, filesystem structure, and usage examples.
+
+## Development
+
+```bash
+git clone https://github.com/pboueke/canto-data.git
+cd canto-data
+npm install
+npm test            # run tests
+npm run test:ci     # run tests with 100% coverage enforcement
+npm run build       # compile to dist/
+```
+
+## Publishing
+
+See the [npm Publishing Setup](#npm-publishing-setup) section below.
+
+### npm Publishing Setup
+
+1. **npm account**: Create/login at [npmjs.com](https://www.npmjs.com/signup)
+2. **npm token**: Generate an automation token at npmjs.com > Access Tokens > Generate New Token (Automation)
+3. **GitHub secret**: Add the token as `NPM_TOKEN` in the repo's Settings > Secrets and variables > Actions
+4. **First publish**: Run `npm run build && npm publish` after `npm login`, or push v1.0.0 to main
+5. **Subsequent publishes**: Bump version in `package.json`, merge to `main` — GitHub Actions auto-publishes
+
+### Version bump
+
+```bash
+npm version patch   # 1.0.0 -> 1.0.1 (bug fix)
+npm version minor   # 1.0.0 -> 1.1.0 (new feature)
+npm version major   # 1.0.0 -> 2.0.0 (breaking change)
+git push && git push --tags
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/format.d.ts

@@ -0,0 +1,47 @@
+import type { Page } from './types';
+export interface ExportManifest {
+    /** Manifest format version (always 1). */
+    version: 1;
+    /** Canto journal schema version (semver). Absent in legacy exports (treated as "0.16.0"). */
+    schemaVersion?: string;
+    appVersion: string;
+    exportDate: string;
+    encrypted: boolean;
+    salt?: string;
+    kdfIterations?: number;
+    journalTitle: string;
+}
+export interface BuildManifestOptions {
+    appVersion: string;
+    encrypted: boolean;
+    journalTitle: string;
+    salt?: string;
+    kdfIterations?: number;
+}
+/** Create an ExportManifest with the current SCHEMA_VERSION. */
+export declare function buildExportManifest(opts: BuildManifestOptions): ExportManifest;
+/**
+ * Parse and validate a manifest JSON string.
+ * Legacy manifests (without schemaVersion) are treated as "0.16.0".
+ */
+export declare function parseManifest(json: string): ExportManifest;
+export interface AttachmentEntry {
+    /** Index into the flat attachments/ folder inside the ZIP */
+    zipFilename: string;
+    /** Original on-disk filename (for reading) */
+    diskPath: string;
+    /** Whether the on-disk file is password-encrypted */
+    isPasswordEncrypted: boolean;
+}
+/** Collect unique attachments from pages for export, building portable ZIP filenames. */
+export declare function collectAttachmentEntries(pages: Page[]): AttachmentEntry[];
+/**
+ * Rewrite attachment paths in pages to use portable ZIP filenames.
+ * Returns cloned pages with updated paths.
+ */
+export declare function rewriteAttachmentPaths(pages: Page[], pathMap: Map<string, string>): Page[];
+/** Serialize pages to a map of pageId → JSON string. */
+export declare function serializePages(pages: Page[]): Map<string, string>;
+/** Deserialize pages from a map of filename → JSON string. */
+export declare function deserializePages(entries: Map<string, string>): Page[];
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,SAAS,CAAC;AAShD,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC;IACX,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,cAAc,CAW9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA+C1D;AAMD,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,eAAe,EAAE,CAsBzE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,CAY1F;AAMD,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMjE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,CAOrE"}

package/dist/format.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExportManifest = buildExportManifest;
+exports.parseManifest = parseManifest;
+exports.collectAttachmentEntries = collectAttachmentEntries;
+exports.rewriteAttachmentPaths = rewriteAttachmentPaths;
+exports.serializePages = serializePages;
+exports.deserializePages = deserializePages;
+const version_1 = require("./version");
+const validation_1 = require("./validation");
+const validation_2 = require("./validation");
+/** Create an ExportManifest with the current SCHEMA_VERSION. */
+function buildExportManifest(opts) {
+    return {
+        version: 1,
+        schemaVersion: version_1.SCHEMA_VERSION,
+        appVersion: opts.appVersion,
+        exportDate: new Date().toISOString(),
+        encrypted: opts.encrypted,
+        journalTitle: opts.journalTitle,
+        ...(opts.salt ? { salt: opts.salt } : {}),
+        ...(opts.kdfIterations ? { kdfIterations: opts.kdfIterations } : {}),
+    };
+}
+/**
+ * Parse and validate a manifest JSON string.
+ * Legacy manifests (without schemaVersion) are treated as "0.16.0".
+ */
+function parseManifest(json) {
+    let raw;
+    try {
+        raw = JSON.parse(json);
+    }
+    catch {
+        throw new validation_1.ValidationError('manifest', 'valid JSON', 'parse error');
+    }
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new validation_1.ValidationError('manifest', 'object', typeof raw);
+    }
+    const o = raw;
+    if (o.version !== 1) {
+        throw new validation_1.ValidationError('manifest.version', '1', String(o.version));
+    }
+    if (typeof o.appVersion !== 'string') {
+        throw new validation_1.ValidationError('manifest.appVersion', 'string', typeof o.appVersion);
+    }
+    if (typeof o.exportDate !== 'string') {
+        throw new validation_1.ValidationError('manifest.exportDate', 'string', typeof o.exportDate);
+    }
+    if (typeof o.encrypted !== 'boolean') {
+        throw new validation_1.ValidationError('manifest.encrypted', 'boolean', typeof o.encrypted);
+    }
+    if (typeof o.journalTitle !== 'string') {
+        throw new validation_1.ValidationError('manifest.journalTitle', 'string', typeof o.journalTitle);
+    }
+    // Legacy manifests don't have schemaVersion — default to "0.16.0"
+    const schemaVersion = typeof o.schemaVersion === 'string' ? o.schemaVersion : '0.16.0';
+    return {
+        version: 1,
+        schemaVersion,
+        appVersion: o.appVersion,
+        exportDate: o.exportDate,
+        encrypted: o.encrypted,
+        journalTitle: o.journalTitle,
+        ...(typeof o.salt === 'string' ? { salt: o.salt } : {}),
+        ...(typeof o.kdfIterations === 'number' ? { kdfIterations: o.kdfIterations } : {}),
+    };
+}
+/** Collect unique attachments from pages for export, building portable ZIP filenames. */
+function collectAttachmentEntries(pages) {
+    const seen = new Set();
+    const entries = [];
+    for (const page of pages) {
+        const allAttachments = [...page.images, ...page.files].filter((a) => !a.deleted);
+        for (const att of allAttachments) {
+            if (!att.path || seen.has(att.path))
+                continue;
+            seen.add(att.path);
+            const parts = att.name.split('.');
+            const ext = parts.length > 1 ? parts.pop() : 'bin';
+            const zipFilename = `${att.type}-${att.id}.${ext}`;
+            entries.push({
+                zipFilename,
+                diskPath: att.path,
+                isPasswordEncrypted: att.encrypted,
+            });
+        }
+    }
+    return entries;
+}
+/**
+ * Rewrite attachment paths in pages to use portable ZIP filenames.
+ * Returns cloned pages with updated paths.
+ */
+function rewriteAttachmentPaths(pages, pathMap) {
+    return pages.map((page) => ({
+        ...page,
+        images: page.images.map((a) => ({
+            ...a,
+            path: pathMap.get(a.path) ?? a.path,
+        })),
+        files: page.files.map((a) => ({
+            ...a,
+            path: pathMap.get(a.path) ?? a.path,
+        })),
+    }));
+}
+// ---------------------------------------------------------------------------
+// Page serialization (pure, no I/O)
+// ---------------------------------------------------------------------------
+/** Serialize pages to a map of pageId → JSON string. */
+function serializePages(pages) {
+    const result = new Map();
+    for (const page of pages) {
+        result.set(page.id, JSON.stringify(page, null, 2));
+    }
+    return result;
+}
+/** Deserialize pages from a map of filename → JSON string. */
+function deserializePages(entries) {
+    const pages = [];
+    for (const [, json] of entries) {
+        const parsed = JSON.parse(json);
+        pages.push((0, validation_2.validatePage)(parsed));
+    }
+    return pages;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { GeoLocation, Comment, Attachment, Page, PagePreview, JournalSettings, Journal, JournalContent, Filter, SyncProvider, } from './types';
+export { DEFAULT_JOURNAL_SETTINGS, pageToPreview } from './types';
+export { SCHEMA_VERSION, compareVersions, needsMigration, isFutureVersion, isMajorUpgrade, } from './version';
+export { ValidationError, isGeoLocation, isComment, isAttachment, isPage, isJournal, isJournalContent, validateGeoLocation, validateComment, validateAttachment, validatePage, validateJournalSettings, validateJournal, validateJournalContent, } from './validation';
+export type { Migration, MigrationResult } from './migration';
+export { migrateIfNeeded } from './migration';
+export type { ExportManifest, AttachmentEntry, BuildManifestOptions } from './format';
+export { buildExportManifest, parseManifest, collectAttachmentEntries, rewriteAttachmentPaths, serializePages, deserializePages, } from './format';
+//# 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":"AACA,YAAY,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,IAAI,EACJ,WAAW,EACX,eAAe,EACf,OAAO,EACP,cAAc,EACd,MAAM,EACN,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGlE,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,aAAa,EACb,SAAS,EACT,YAAY,EACZ,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserializePages = exports.serializePages = exports.rewriteAttachmentPaths = exports.collectAttachmentEntries = exports.parseManifest = exports.buildExportManifest = exports.migrateIfNeeded = exports.validateJournalContent = exports.validateJournal = exports.validateJournalSettings = exports.validatePage = exports.validateAttachment = exports.validateComment = exports.validateGeoLocation = exports.isJournalContent = exports.isJournal = exports.isPage = exports.isAttachment = exports.isComment = exports.isGeoLocation = exports.ValidationError = exports.isMajorUpgrade = exports.isFutureVersion = exports.needsMigration = exports.compareVersions = exports.SCHEMA_VERSION = exports.pageToPreview = exports.DEFAULT_JOURNAL_SETTINGS = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "DEFAULT_JOURNAL_SETTINGS", { enumerable: true, get: function () { return types_1.DEFAULT_JOURNAL_SETTINGS; } });
+Object.defineProperty(exports, "pageToPreview", { enumerable: true, get: function () { return types_1.pageToPreview; } });
+// Version
+var version_1 = require("./version");
+Object.defineProperty(exports, "SCHEMA_VERSION", { enumerable: true, get: function () { return version_1.SCHEMA_VERSION; } });
+Object.defineProperty(exports, "compareVersions", { enumerable: true, get: function () { return version_1.compareVersions; } });
+Object.defineProperty(exports, "needsMigration", { enumerable: true, get: function () { return version_1.needsMigration; } });
+Object.defineProperty(exports, "isFutureVersion", { enumerable: true, get: function () { return version_1.isFutureVersion; } });
+Object.defineProperty(exports, "isMajorUpgrade", { enumerable: true, get: function () { return version_1.isMajorUpgrade; } });
+// Validation
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return validation_1.ValidationError; } });
+Object.defineProperty(exports, "isGeoLocation", { enumerable: true, get: function () { return validation_1.isGeoLocation; } });
+Object.defineProperty(exports, "isComment", { enumerable: true, get: function () { return validation_1.isComment; } });
+Object.defineProperty(exports, "isAttachment", { enumerable: true, get: function () { return validation_1.isAttachment; } });
+Object.defineProperty(exports, "isPage", { enumerable: true, get: function () { return validation_1.isPage; } });
+Object.defineProperty(exports, "isJournal", { enumerable: true, get: function () { return validation_1.isJournal; } });
+Object.defineProperty(exports, "isJournalContent", { enumerable: true, get: function () { return validation_1.isJournalContent; } });
+Object.defineProperty(exports, "validateGeoLocation", { enumerable: true, get: function () { return validation_1.validateGeoLocation; } });
+Object.defineProperty(exports, "validateComment", { enumerable: true, get: function () { return validation_1.validateComment; } });
+Object.defineProperty(exports, "validateAttachment", { enumerable: true, get: function () { return validation_1.validateAttachment; } });
+Object.defineProperty(exports, "validatePage", { enumerable: true, get: function () { return validation_1.validatePage; } });
+Object.defineProperty(exports, "validateJournalSettings", { enumerable: true, get: function () { return validation_1.validateJournalSettings; } });
+Object.defineProperty(exports, "validateJournal", { enumerable: true, get: function () { return validation_1.validateJournal; } });
+Object.defineProperty(exports, "validateJournalContent", { enumerable: true, get: function () { return validation_1.validateJournalContent; } });
+var migration_1 = require("./migration");
+Object.defineProperty(exports, "migrateIfNeeded", { enumerable: true, get: function () { return migration_1.migrateIfNeeded; } });
+var format_1 = require("./format");
+Object.defineProperty(exports, "buildExportManifest", { enumerable: true, get: function () { return format_1.buildExportManifest; } });
+Object.defineProperty(exports, "parseManifest", { enumerable: true, get: function () { return format_1.parseManifest; } });
+Object.defineProperty(exports, "collectAttachmentEntries", { enumerable: true, get: function () { return format_1.collectAttachmentEntries; } });
+Object.defineProperty(exports, "rewriteAttachmentPaths", { enumerable: true, get: function () { return format_1.rewriteAttachmentPaths; } });
+Object.defineProperty(exports, "serializePages", { enumerable: true, get: function () { return format_1.serializePages; } });
+Object.defineProperty(exports, "deserializePages", { enumerable: true, get: function () { return format_1.deserializePages; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAcA,iCAAkE;AAAzD,iHAAA,wBAAwB,OAAA;AAAE,sGAAA,aAAa,OAAA;AAEhD,UAAU;AACV,qCAMmB;AALjB,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,yGAAA,cAAc,OAAA;AAGhB,aAAa;AACb,2CAesB;AAdpB,6GAAA,eAAe,OAAA;AACf,2GAAA,aAAa,OAAA;AACb,uGAAA,SAAS,OAAA;AACT,0GAAA,YAAY,OAAA;AACZ,oGAAA,MAAM,OAAA;AACN,uGAAA,SAAS,OAAA;AACT,8GAAA,gBAAgB,OAAA;AAChB,iHAAA,mBAAmB,OAAA;AACnB,6GAAA,eAAe,OAAA;AACf,gHAAA,kBAAkB,OAAA;AAClB,0GAAA,YAAY,OAAA;AACZ,qHAAA,uBAAuB,OAAA;AACvB,6GAAA,eAAe,OAAA;AACf,oHAAA,sBAAsB,OAAA;AAKxB,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AAIxB,mCAOkB;AANhB,6GAAA,mBAAmB,OAAA;AACnB,uGAAA,aAAa,OAAA;AACb,kHAAA,wBAAwB,OAAA;AACxB,gHAAA,sBAAsB,OAAA;AACtB,wGAAA,cAAc,OAAA;AACd,0GAAA,gBAAgB,OAAA"}

package/dist/migration.d.ts

@@ -0,0 +1,21 @@
+export interface Migration {
+    from: string;
+    to: string;
+    description: string;
+    migrate(data: unknown): unknown;
+}
+export interface MigrationResult {
+    data: unknown;
+    migrated: boolean;
+    fromVersion: string;
+    toVersion: string;
+}
+/**
+ * Apply any needed migrations to bring data from `fromVersion` to SCHEMA_VERSION.
+ *
+ * - If `fromVersion` is undefined, treats data as "0.16.0" (legacy).
+ * - Migrations apply in sequence (0.16.0 → 0.17.0 → ...).
+ * - Throws if the data is from a future version (can't downgrade).
+ */
+export declare function migrateIfNeeded(data: unknown, fromVersion?: string): MigrationResult;
+//# sourceMappingURL=migration.d.ts.map

package/dist/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CA4CpF"}

package/dist/migration.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateIfNeeded = migrateIfNeeded;
+const version_1 = require("./version");
+const index_1 = require("./migrations/index");
+/**
+ * Apply any needed migrations to bring data from `fromVersion` to SCHEMA_VERSION.
+ *
+ * - If `fromVersion` is undefined, treats data as "0.16.0" (legacy).
+ * - Migrations apply in sequence (0.16.0 → 0.17.0 → ...).
+ * - Throws if the data is from a future version (can't downgrade).
+ */
+function migrateIfNeeded(data, fromVersion) {
+    const version = fromVersion ?? '0.16.0';
+    if ((0, version_1.isFutureVersion)(version)) {
+        throw new Error(`Cannot open data with schema version ${version} — ` +
+            `this app supports up to ${version_1.SCHEMA_VERSION}. Please update the app.`);
+    }
+    if ((0, version_1.compareVersions)(version, version_1.SCHEMA_VERSION) === 0) {
+        return { data, migrated: false, fromVersion: version, toVersion: version_1.SCHEMA_VERSION };
+    }
+    let current = version;
+    let result = data;
+    // Apply migrations in order
+    for (const migration of index_1.MIGRATIONS) {
+        if ((0, version_1.compareVersions)(current, migration.from) === 0) {
+            try {
+                result = migration.migrate(result);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new Error(`Migration ${migration.from} → ${migration.to} failed: ${msg}` +
+                    ` (${migration.description})`);
+            }
+            current = migration.to;
+        }
+        // Stop if we've reached the target
+        if ((0, version_1.compareVersions)(current, version_1.SCHEMA_VERSION) === 0)
+            break;
+    }
+    if ((0, version_1.compareVersions)(current, version_1.SCHEMA_VERSION) !== 0) {
+        throw new Error(`No migration path from ${version} to ${version_1.SCHEMA_VERSION}. ` +
+            `Reached ${current} but no further migrations available.`);
+    }
+    return { data: result, migrated: true, fromVersion: version, toVersion: version_1.SCHEMA_VERSION };
+}
+//# sourceMappingURL=migration.js.map

package/dist/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":";;AAwBA,0CA4CC;AApED,uCAA6E;AAC7E,8CAAgD;AAgBhD;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,IAAa,EAAE,WAAoB;IACjE,MAAM,OAAO,GAAG,WAAW,IAAI,QAAQ,CAAC;IAExC,IAAI,IAAA,yBAAe,EAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,wCAAwC,OAAO,KAAK;YAClD,2BAA2B,wBAAc,0BAA0B,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,IAAA,yBAAe,EAAC,OAAO,EAAE,wBAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,wBAAc,EAAE,CAAC;IACpF,CAAC;IAED,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,IAAI,MAAM,GAAG,IAAI,CAAC;IAElB,4BAA4B;IAC5B,KAAK,MAAM,SAAS,IAAI,kBAAU,EAAE,CAAC;QACnC,IAAI,IAAA,yBAAe,EAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,aAAa,SAAS,CAAC,IAAI,MAAM,SAAS,CAAC,EAAE,YAAY,GAAG,EAAE;oBAC5D,KAAK,SAAS,CAAC,WAAW,GAAG,CAChC,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;QACzB,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAA,yBAAe,EAAC,OAAO,EAAE,wBAAc,CAAC,KAAK,CAAC;YAAE,MAAM;IAC5D,CAAC;IAED,IAAI,IAAA,yBAAe,EAAC,OAAO,EAAE,wBAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,0BAA0B,OAAO,OAAO,wBAAc,IAAI;YACxD,WAAW,OAAO,uCAAuC,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,wBAAc,EAAE,CAAC;AAC3F,CAAC"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,6 @@
+import type { Migration } from '../migration';
+/**
+ * Registry of all schema migrations, ordered from oldest to newest.
+ */
+export declare const MIGRATIONS: Migration[];
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,EAAyB,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIGRATIONS = void 0;
+const v0_16_0_to_v0_17_0_1 = require("./v0_16_0_to_v0_17_0");
+/**
+ * Registry of all schema migrations, ordered from oldest to newest.
+ */
+exports.MIGRATIONS = [v0_16_0_to_v0_17_0_1.v0_16_0_to_v0_17_0];
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":";;;AACA,6DAA0D;AAE1D;;GAEG;AACU,QAAA,UAAU,GAAgB,CAAC,uCAAkB,CAAC,CAAC"}

package/dist/migrations/v0_16_0_to_v0_17_0.d.ts

@@ -0,0 +1,9 @@
+import type { Migration } from '../migration';
+/**
+ * Migration from schema v0.16.0 to v0.17.0.
+ *
+ * Removes the deprecated `showMarkdownPlaceholder` field from journal settings.
+ * This field was a dead toggle that had no effect on the UI.
+ */
+export declare const v0_16_0_to_v0_17_0: Migration;
+//# sourceMappingURL=v0_16_0_to_v0_17_0.d.ts.map

package/dist/migrations/v0_16_0_to_v0_17_0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v0_16_0_to_v0_17_0.d.ts","sourceRoot":"","sources":["../../src/migrations/v0_16_0_to_v0_17_0.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAahC,CAAC"}

package/dist/migrations/v0_16_0_to_v0_17_0.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.v0_16_0_to_v0_17_0 = void 0;
+/**
+ * Migration from schema v0.16.0 to v0.17.0.
+ *
+ * Removes the deprecated `showMarkdownPlaceholder` field from journal settings.
+ * This field was a dead toggle that had no effect on the UI.
+ */
+exports.v0_16_0_to_v0_17_0 = {
+    from: '0.16.0',
+    to: '0.17.0',
+    description: 'Remove deprecated showMarkdownPlaceholder setting',
+    migrate(data) {
+        if (data && typeof data === 'object' && 'settings' in data) {
+            const settings = data.settings;
+            if (settings && typeof settings === 'object' && 'showMarkdownPlaceholder' in settings) {
+                delete settings.showMarkdownPlaceholder;
+            }
+        }
+        return data;
+    },
+};
+//# sourceMappingURL=v0_16_0_to_v0_17_0.js.map

package/dist/migrations/v0_16_0_to_v0_17_0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v0_16_0_to_v0_17_0.js","sourceRoot":"","sources":["../../src/migrations/v0_16_0_to_v0_17_0.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACU,QAAA,kBAAkB,GAAc;IAC3C,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,mDAAmD;IAChE,OAAO,CAAC,IAAa;QACnB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YAC3D,MAAM,QAAQ,GAAI,IAAgC,CAAC,QAAQ,CAAC;YAC5D,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,yBAAyB,IAAI,QAAQ,EAAE,CAAC;gBACtF,OAAQ,QAAoC,CAAC,uBAAuB,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+export interface GeoLocation {
+    latitude: number;
+    longitude: number;
+    altitude?: number;
+    accuracy?: number;
+}
+export interface Comment {
+    id: string;
+    text: string;
+    date: string;
+}
+export interface Attachment {
+    id: string;
+    path: string;
+    name: string;
+    type: 'image' | 'file';
+    encrypted: boolean;
+    size?: number;
+    deleted: boolean;
+}
+export interface Page {
+    id: string;
+    text: string;
+    date: string;
+    thumbnail?: string;
+    location?: GeoLocation;
+    tags: string[];
+    files: Attachment[];
+    images: Attachment[];
+    comments: Comment[];
+    modified: number;
+    deleted: boolean;
+}
+export interface PagePreview {
+    id: string;
+    date: string;
+    previewText: string;
+    searchText: string;
+    tags: string[];
+    hasImage: boolean;
+    hasAttachment: boolean;
+    hasLocation: boolean;
+    hasComments: boolean;
+    firstImage?: string;
+    thumbnail?: string;
+}
+export type SyncProvider = 'gdrive';
+export interface JournalSettings {
+    use24h: boolean;
+    previewTags: boolean;
+    previewThumbnail: boolean;
+    previewIcons: boolean;
+    filterBar: boolean;
+    sort: 'ascending' | 'descending' | 'none';
+    autoLocation: boolean;
+    remoteSync: boolean;
+    syncProvider?: SyncProvider;
+    autoSync: boolean;
+    themeOverride?: string;
+}
+export interface Journal {
+    id: string;
+    title: string;
+    icon: string;
+    date: string;
+    secure: boolean;
+    salt: string;
+    biometric?: boolean;
+    kdfIterations?: number;
+    themeOverride?: string;
+}
+export interface JournalContent extends Journal {
+    pages: Page[];
+    settings: JournalSettings;
+    schemaVersion?: string;
+    /** @deprecated Use schemaVersion instead. Kept for backward compatibility. */
+    version: number;
+}
+export interface Filter {
+    query: string;
+    properties: {
+        tags: string[];
+        hasFile: boolean;
+        hasImage: boolean;
+        hasComments: boolean;
+        hasLocation: boolean;
+    };
+    dateStart?: string;
+    dateEnd?: string;
+}
+export declare const DEFAULT_JOURNAL_SETTINGS: JournalSettings;
+export declare function pageToPreview(page: Page): PagePreview;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_JOURNAL_SETTINGS = void 0;
+exports.pageToPreview = pageToPreview;
+exports.DEFAULT_JOURNAL_SETTINGS = {
+    use24h: false,
+    previewTags: true,
+    previewThumbnail: true,
+    previewIcons: true,
+    filterBar: true,
+    sort: 'descending',
+    autoLocation: false,
+    remoteSync: false,
+    autoSync: false,
+};
+function pageToPreview(page) {
+    const firstLine = page.text.split('\n').find((l) => l.trim().length > 0) ?? '';
+    const previewText = firstLine.substring(0, 120);
+    const firstNonEncryptedImage = page.images.find((img) => !img.encrypted && !img.deleted);
+    const searchText = page.text.toLowerCase() + ' ' + page.tags.join(' ').toLowerCase();
+    return {
+        id: page.id,
+        date: page.date,
+        previewText,
+        searchText,
+        tags: page.tags,
+        hasImage: page.images.length > 0,
+        hasAttachment: page.files.length > 0,
+        hasLocation: !!page.location,
+        hasComments: page.comments.length > 0,
+        firstImage: firstNonEncryptedImage?.path,
+        thumbnail: page.thumbnail,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAgHA,sCAqBC;AAjCY,QAAA,wBAAwB,GAAoB;IACvD,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,IAAI;IACjB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF,SAAgB,aAAa,CAAC,IAAU;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEhD,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEzF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAErF,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW;QACX,UAAU;QACV,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAChC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACpC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;QAC5B,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrC,UAAU,EAAE,sBAAsB,EAAE,IAAI;QACxC,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;AACJ,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,21 @@
+import type { GeoLocation, Comment, Attachment, Page, Journal, JournalContent, JournalSettings } from './types';
+export declare class ValidationError extends Error {
+    readonly field: string;
+    readonly expected: string;
+    readonly received: string;
+    constructor(field: string, expected: string, received: string);
+}
+export declare function isGeoLocation(v: unknown): v is GeoLocation;
+export declare function isComment(v: unknown): v is Comment;
+export declare function isAttachment(v: unknown): v is Attachment;
+export declare function isPage(v: unknown): v is Page;
+export declare function isJournal(v: unknown): v is Journal;
+export declare function isJournalContent(v: unknown): v is JournalContent;
+export declare function validateGeoLocation(v: unknown, path?: string): GeoLocation;
+export declare function validateComment(v: unknown, path?: string): Comment;
+export declare function validateAttachment(v: unknown, path?: string): Attachment;
+export declare function validatePage(v: unknown, path?: string): Page;
+export declare function validateJournalSettings(v: unknown, path?: string): JournalSettings;
+export declare function validateJournal(v: unknown, path?: string): Journal;
+export declare function validateJournalContent(v: unknown, path?: string): JournalContent;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,IAAI,EACJ,OAAO,EACP,cAAc,EACd,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,KAAK,EAAE,MAAM;aACb,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;gBAFhB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAKnC;AA4DD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAI1D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAIlD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAWxD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,IAAI,CAc5C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAUlD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAIhE;AAMD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAa,GAAG,WAAW,CAkB9E;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAY,GAAG,OAAO,CAOrE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAe,GAAG,UAAU,CAW9E;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAS,GAAG,IAAI,CAgC5D;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAa,GAAG,eAAe,CAiBtF;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAY,GAAG,OAAO,CAarE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAY,GAAG,cAAc,CAWnF"}

package/dist/validation.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+exports.isGeoLocation = isGeoLocation;
+exports.isComment = isComment;
+exports.isAttachment = isAttachment;
+exports.isPage = isPage;
+exports.isJournal = isJournal;
+exports.isJournalContent = isJournalContent;
+exports.validateGeoLocation = validateGeoLocation;
+exports.validateComment = validateComment;
+exports.validateAttachment = validateAttachment;
+exports.validatePage = validatePage;
+exports.validateJournalSettings = validateJournalSettings;
+exports.validateJournal = validateJournal;
+exports.validateJournalContent = validateJournalContent;
+class ValidationError extends Error {
+    constructor(field, expected, received) {
+        super(`Invalid field "${field}": expected ${expected}, got ${received}`);
+        this.field = field;
+        this.expected = expected;
+        this.received = received;
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function typeOf(v) {
+    if (v === null)
+        return 'null';
+    if (Array.isArray(v))
+        return 'array';
+    return typeof v;
+}
+function checkType(path, value, expected) {
+    const actual = typeOf(value);
+    if (actual !== expected) {
+        throw new ValidationError(path, expected, actual);
+    }
+}
+function checkOptionalType(path, value, expected) {
+    if (value !== undefined) {
+        checkType(path, value, expected);
+    }
+}
+function checkEnum(path, value, allowed) {
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new ValidationError(path, `one of ${JSON.stringify(allowed)}`, JSON.stringify(value));
+    }
+}
+function checkString(path, value) {
+    checkType(path, value, 'string');
+}
+function checkNumber(path, value) {
+    checkType(path, value, 'number');
+    if (!Number.isFinite(value)) {
+        throw new ValidationError(path, 'finite number', String(value));
+    }
+}
+function checkBoolean(path, value) {
+    checkType(path, value, 'boolean');
+}
+function checkArray(path, value) {
+    checkType(path, value, 'array');
+}
+function checkObject(path, value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new ValidationError(path, 'object', typeOf(value));
+    }
+}
+// ---------------------------------------------------------------------------
+// Type guards (boolean, no throw)
+// ---------------------------------------------------------------------------
+function isGeoLocation(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const o = v;
+    return typeof o.latitude === 'number' && typeof o.longitude === 'number';
+}
+function isComment(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const o = v;
+    return typeof o.id === 'string' && typeof o.text === 'string' && typeof o.date === 'string';
+}
+function isAttachment(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const o = v;
+    return (typeof o.id === 'string' &&
+        typeof o.path === 'string' &&
+        typeof o.name === 'string' &&
+        (o.type === 'image' || o.type === 'file') &&
+        typeof o.encrypted === 'boolean' &&
+        typeof o.deleted === 'boolean');
+}
+function isPage(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const o = v;
+    return (typeof o.id === 'string' &&
+        typeof o.text === 'string' &&
+        typeof o.date === 'string' &&
+        Array.isArray(o.tags) &&
+        Array.isArray(o.files) &&
+        Array.isArray(o.images) &&
+        Array.isArray(o.comments) &&
+        typeof o.modified === 'number' &&
+        typeof o.deleted === 'boolean');
+}
+function isJournal(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const o = v;
+    return (typeof o.id === 'string' &&
+        typeof o.title === 'string' &&
+        typeof o.icon === 'string' &&
+        typeof o.date === 'string' &&
+        typeof o.secure === 'boolean');
+}
+function isJournalContent(v) {
+    if (!isJournal(v))
+        return false;
+    const o = v;
+    return Array.isArray(o.pages) && typeof o.settings === 'object' && o.settings !== null;
+}
+// ---------------------------------------------------------------------------
+// Structural validators (throw ValidationError with field path)
+// ---------------------------------------------------------------------------
+function validateGeoLocation(v, path = 'location') {
+    checkObject(path, v);
+    const o = v;
+    checkNumber(`${path}.latitude`, o.latitude);
+    checkNumber(`${path}.longitude`, o.longitude);
+    if (o.latitude < -90 || o.latitude > 90) {
+        throw new ValidationError(`${path}.latitude`, 'number in range [-90, 90]', String(o.latitude));
+    }
+    if (o.longitude < -180 || o.longitude > 180) {
+        throw new ValidationError(`${path}.longitude`, 'number in range [-180, 180]', String(o.longitude));
+    }
+    checkOptionalType(`${path}.altitude`, o.altitude, 'number');
+    checkOptionalType(`${path}.accuracy`, o.accuracy, 'number');
+    return v;
+}
+function validateComment(v, path = 'comment') {
+    checkObject(path, v);
+    const o = v;
+    checkString(`${path}.id`, o.id);
+    checkString(`${path}.text`, o.text);
+    checkString(`${path}.date`, o.date);
+    return v;
+}
+function validateAttachment(v, path = 'attachment') {
+    checkObject(path, v);
+    const o = v;
+    checkString(`${path}.id`, o.id);
+    checkString(`${path}.path`, o.path);
+    checkString(`${path}.name`, o.name);
+    checkEnum(`${path}.type`, o.type, ['image', 'file']);
+    checkBoolean(`${path}.encrypted`, o.encrypted);
+    checkOptionalType(`${path}.size`, o.size, 'number');
+    checkBoolean(`${path}.deleted`, o.deleted);
+    return v;
+}
+function validatePage(v, path = 'page') {
+    checkObject(path, v);
+    const o = v;
+    checkString(`${path}.id`, o.id);
+    checkString(`${path}.text`, o.text);
+    checkString(`${path}.date`, o.date);
+    checkOptionalType(`${path}.thumbnail`, o.thumbnail, 'string');
+    if (o.location !== undefined && o.location !== null) {
+        validateGeoLocation(o.location, `${path}.location`);
+    }
+    checkArray(`${path}.tags`, o.tags);
+    for (let i = 0; i < o.tags.length; i++) {
+        checkString(`${path}.tags[${i}]`, o.tags[i]);
+        if (o.tags[i].trim() === '') {
+            throw new ValidationError(`${path}.tags[${i}]`, 'non-empty string', '""');
+        }
+    }
+    checkArray(`${path}.files`, o.files);
+    for (let i = 0; i < o.files.length; i++) {
+        validateAttachment(o.files[i], `${path}.files[${i}]`);
+    }
+    checkArray(`${path}.images`, o.images);
+    for (let i = 0; i < o.images.length; i++) {
+        validateAttachment(o.images[i], `${path}.images[${i}]`);
+    }
+    checkArray(`${path}.comments`, o.comments);
+    for (let i = 0; i < o.comments.length; i++) {
+        validateComment(o.comments[i], `${path}.comments[${i}]`);
+    }
+    checkNumber(`${path}.modified`, o.modified);
+    checkBoolean(`${path}.deleted`, o.deleted);
+    return v;
+}
+function validateJournalSettings(v, path = 'settings') {
+    checkObject(path, v);
+    const o = v;
+    checkBoolean(`${path}.use24h`, o.use24h);
+    checkBoolean(`${path}.previewTags`, o.previewTags);
+    checkBoolean(`${path}.previewThumbnail`, o.previewThumbnail);
+    checkBoolean(`${path}.previewIcons`, o.previewIcons);
+    checkBoolean(`${path}.filterBar`, o.filterBar);
+    checkEnum(`${path}.sort`, o.sort, ['ascending', 'descending', 'none']);
+    checkBoolean(`${path}.autoLocation`, o.autoLocation);
+    checkBoolean(`${path}.remoteSync`, o.remoteSync);
+    if (o.syncProvider !== undefined) {
+        checkEnum(`${path}.syncProvider`, o.syncProvider, ['gdrive']);
+    }
+    checkBoolean(`${path}.autoSync`, o.autoSync);
+    checkOptionalType(`${path}.themeOverride`, o.themeOverride, 'string');
+    return v;
+}
+function validateJournal(v, path = 'journal') {
+    checkObject(path, v);
+    const o = v;
+    checkString(`${path}.id`, o.id);
+    checkString(`${path}.title`, o.title);
+    checkString(`${path}.icon`, o.icon);
+    checkString(`${path}.date`, o.date);
+    checkBoolean(`${path}.secure`, o.secure);
+    checkOptionalType(`${path}.salt`, o.salt, 'string');
+    checkOptionalType(`${path}.biometric`, o.biometric, 'boolean');
+    checkOptionalType(`${path}.kdfIterations`, o.kdfIterations, 'number');
+    checkOptionalType(`${path}.themeOverride`, o.themeOverride, 'string');
+    return v;
+}
+function validateJournalContent(v, path = 'journal') {
+    validateJournal(v, path);
+    const o = v;
+    checkArray(`${path}.pages`, o.pages);
+    for (let i = 0; i < o.pages.length; i++) {
+        validatePage(o.pages[i], `${path}.pages[${i}]`);
+    }
+    validateJournalSettings(o.settings, `${path}.settings`);
+    // schemaVersion is optional for backward compat (legacy journals lack it)
+    checkOptionalType(`${path}.schemaVersion`, o.schemaVersion, 'string');
+    return v;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+/** Current Canto journal schema version (semver). */
+export declare const SCHEMA_VERSION = "0.17.0";
+/** Compare two semver strings. Returns -1 (a < b), 0 (equal), or 1 (a > b). */
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+/** True if `version` needs migration to reach SCHEMA_VERSION (strictly older). */
+export declare function needsMigration(version: string): boolean;
+/** True if `version` is newer than SCHEMA_VERSION (can't handle). */
+export declare function isFutureVersion(version: string): boolean;
+/** True if `version` requires a breaking migration (different major version). */
+export declare function isMajorUpgrade(from: string, to: string): boolean;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,eAAO,MAAM,cAAc,WAAW,CAAC;AAWvC,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAQhE;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAIhE"}

package/dist/version.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_VERSION = void 0;
+exports.compareVersions = compareVersions;
+exports.needsMigration = needsMigration;
+exports.isFutureVersion = isFutureVersion;
+exports.isMajorUpgrade = isMajorUpgrade;
+/** Current Canto journal schema version (semver). */
+exports.SCHEMA_VERSION = '0.17.0';
+/** Parse a semver string into [major, minor, patch]. Throws on invalid format. */
+function parseSemver(v) {
+    const parts = v.split('.').map(Number);
+    if (parts.length !== 3 || parts.some(isNaN)) {
+        throw new Error(`Invalid schema version: "${v}" (expected semver like "1.0.0")`);
+    }
+    return parts;
+}
+/** Compare two semver strings. Returns -1 (a < b), 0 (equal), or 1 (a > b). */
+function compareVersions(a, b) {
+    const [aMaj, aMin, aPat] = parseSemver(a);
+    const [bMaj, bMin, bPat] = parseSemver(b);
+    if (aMaj !== bMaj)
+        return aMaj < bMaj ? -1 : 1;
+    if (aMin !== bMin)
+        return aMin < bMin ? -1 : 1;
+    if (aPat !== bPat)
+        return aPat < bPat ? -1 : 1;
+    return 0;
+}
+/** True if `version` needs migration to reach SCHEMA_VERSION (strictly older). */
+function needsMigration(version) {
+    return compareVersions(version, exports.SCHEMA_VERSION) < 0;
+}
+/** True if `version` is newer than SCHEMA_VERSION (can't handle). */
+function isFutureVersion(version) {
+    return compareVersions(version, exports.SCHEMA_VERSION) > 0;
+}
+/** True if `version` requires a breaking migration (different major version). */
+function isMajorUpgrade(from, to) {
+    const [fromMaj] = parseSemver(from);
+    const [toMaj] = parseSemver(to);
+    return toMaj > fromMaj;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;;AAaA,0CAQC;AAGD,wCAEC;AAGD,0CAEC;AAGD,wCAIC;AAtCD,qDAAqD;AACxC,QAAA,cAAc,GAAG,QAAQ,CAAC;AAEvC,kFAAkF;AAClF,SAAS,WAAW,CAAC,CAAS;IAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,kCAAkC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAiC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,SAAgB,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAE1C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,kFAAkF;AAClF,SAAgB,cAAc,CAAC,OAAe;IAC5C,OAAO,eAAe,CAAC,OAAO,EAAE,sBAAc,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,qEAAqE;AACrE,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO,eAAe,CAAC,OAAO,EAAE,sBAAc,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,iFAAiF;AACjF,SAAgB,cAAc,CAAC,IAAY,EAAE,EAAU;IACrD,MAAM,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAChC,OAAO,KAAK,GAAG,OAAO,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "canto-data",
+  "version": "1.0.0",
+  "description": "Canto journal data model — types, validation, versioning, and format utilities",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    "./format": {
+      "types": "./dist/format.d.ts",
+      "default": "./dist/format.js"
+    },
+    "./version": {
+      "types": "./dist/version.d.ts",
+      "default": "./dist/version.js"
+    },
+    "./validation": {
+      "types": "./dist/validation.d.ts",
+      "default": "./dist/validation.js"
+    },
+    "./migration": {
+      "types": "./dist/migration.d.ts",
+      "default": "./dist/migration.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --coverage --ci",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "canto",
+    "journal",
+    "data-model",
+    "validation",
+    "schema"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pboueke/canto-data"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  }
+}