@haverstack/core 0.1.0

package/dist/stack.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Stack — Core Stack Class
+ * -------------------------------------------------------
+ * The Stack class is the primary interface for apps. It sits
+ * on top of a StackAdapter and adds:
+ *
+ *  - ID generation
+ *  - Type definition and schema hashing
+ *  - Content validation on write
+ *  - Migration registry and auto-migration on read
+ *  - Version snapshotting on update
+ *  - Soft and hard delete
+ *
+ * Apps should never talk to a StackAdapter directly.
+ */
+import type { ValidationError } from './validate.js';
+import type { StackRecord, StackType, TypeSchema, TypeId, StackAdapter, StackQuery, QueryResult, Association, Permission, Migration, RecordVersion, AdapterCapabilities } from './types.js';
+export type CreateRecordOptions = {
+    parentId?: string;
+    entityId?: string;
+    appId?: string;
+    permissions?: Permission[];
+    associations?: Association[];
+};
+export type GetRecordOptions = {
+    /** If false, return the raw stored record without auto-migrating. Default: true */
+    migrate?: boolean;
+};
+export type DeleteRecordOptions = {
+    /** If true, permanently remove the record and all its history. Default: false */
+    hard?: boolean;
+};
+export type DefineTypeOptions = {
+    migratesFrom?: TypeId;
+};
+export declare class StackValidationError extends Error {
+    readonly errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}
+export declare class StackMigrationError extends Error {
+    constructor(message: string);
+}
+export declare class Stack {
+    private readonly adapter;
+    readonly ownerEntityId: string | null;
+    readonly timezone: string;
+    private readonly migrations;
+    private constructor();
+    /**
+     * Create a Stack instance. Reads ownerEntityId and timezone from the
+     * adapter's config — the adapter is the single source of truth for
+     * stack-level configuration.
+     */
+    static create(adapter: StackAdapter): Promise<Stack>;
+    get capabilities(): AdapterCapabilities;
+    /**
+     * Define and persist a new Type. Computes the schemaHash automatically.
+     * Should be called at app startup before creating any records of this type.
+     */
+    defineType(id: TypeId, name: string, schema: TypeSchema, opts?: DefineTypeOptions): Promise<StackType>;
+    getType(id: TypeId): Promise<StackType | null>;
+    listTypes(): Promise<StackType[]>;
+    /**
+     * Check whether a record's type is compatible with a required schema.
+     * Useful for duck-typed consumption across types.
+     */
+    typeIsCompatible(typeId: TypeId, requiredSchema: TypeSchema): Promise<boolean>;
+    /**
+     * Register a migration function between two adjacent Type versions.
+     * Call at app startup after defineType(). The library composes
+     * adjacent migrations into chains automatically.
+     *
+     * Migrations run in-memory — they do not write to the adapter unless
+     * you call migrateAll() explicitly.
+     */
+    registerMigration(migration: Migration): void;
+    /**
+     * Find and compose a migration path from one TypeId to another.
+     * Returns null if no path exists.
+     */
+    private resolveMigrationPath;
+    /**
+     * Find the latest registered version of a type family.
+     * Follows the migration chain from the given typeId to the end.
+     */
+    private latestTypeId;
+    /**
+     * Eagerly migrate all records of a type family to the latest version,
+     * committing the results to disk immediately.
+     *
+     * Normally migration is lazy — records are migrated in memory on read
+     * and written back only when next updated. Call migrateAll() when you
+     * want to commit all pending migrations in one deliberate pass, for
+     * example before a deployment or after a major schema change.
+     *
+     * Previous content is preserved in version history before each write.
+     */
+    migrateAll(baseTypeId: string): Promise<{
+        migrated: number;
+    }>;
+    /**
+     * Create a new record. Validates content against the type's schema.
+     */
+    create<T extends Record<string, unknown> = Record<string, unknown>>(typeId: TypeId, content: T, opts?: CreateRecordOptions): Promise<StackRecord & {
+        content: T;
+    }>;
+    /**
+     * Get a record by ID.
+     *
+     * If the record is on an older type version and a migration path is
+     * registered, the content is migrated in memory and returned at the
+     * latest type version — but nothing is written to disk. Migration is
+     * only persisted when the record is next updated via update().
+     *
+     * Pass { migrate: false } to get the raw stored record without migration.
+     */
+    get(id: string, opts?: GetRecordOptions): Promise<StackRecord | null>;
+    /**
+     * Update a record's content. Accepts a partial content object — only the
+     * fields provided are changed. Omitted fields retain their current values.
+     *
+     * To remove an optional field, set it explicitly to null:
+     *   stack.update(id, { title: null })  // removes 'title' from content
+     *
+     * If the record is on an older type version, its content is migrated
+     * in memory first, then the patch is applied. The updated record is
+     * written at the latest type version — this is when lazy migration
+     * is committed to disk.
+     *
+     * Validates the merged result against the type's schema. Saves the
+     * previous state to version history before updating.
+     *
+     * For association or permission changes, use associate(), dissociate(),
+     * and setPermissions() instead.
+     */
+    update(id: string, content: Record<string, unknown | null>): Promise<StackRecord>;
+    /**
+     * Add an association to a record.
+     * If the association already exists (same kind, label, and payload), this is a no-op.
+     */
+    associate(id: string, association: Association): Promise<void>;
+    /**
+     * Remove an association from a record.
+     * Matched by kind, label, and payload. No-op if not found.
+     */
+    dissociate(id: string, association: Association): Promise<void>;
+    /**
+     * Replace all permissions on a record.
+     * Pass an empty array to make the record private (the default).
+     */
+    setPermissions(id: string, permissions: Permission[]): Promise<void>;
+    /**
+     * Soft-delete a record (default) or hard-delete it permanently.
+     * Soft-deleted records are excluded from queries unless includeDeleted is set.
+     * Hard-deleted records and all their version history are permanently removed.
+     */
+    delete(id: string, opts?: DeleteRecordOptions): Promise<void>;
+    /**
+     * Query records. See StackQuery for filter, sort, and pagination options.
+     */
+    query(query?: StackQuery): Promise<QueryResult>;
+    getVersions(id: string): Promise<RecordVersion[]>;
+    getVersion(id: string, version: number): Promise<RecordVersion | null>;
+    /**
+     * Restore a record to a previous version by creating a new version
+     * with the old content. Never rewrites history.
+     */
+    restoreVersion(id: string, version: number): Promise<StackRecord>;
+    putAttachment(data: Uint8Array, mimeType: string): Promise<string>;
+    getAttachment(fileId: string): Promise<Uint8Array>;
+    /**
+     * Flush any pending writes to the underlying storage.
+     * For adapters that write immediately (SQLite, JSON), this is a no-op.
+     * For the API adapter, this commits the offline write queue to the server.
+     * Safe to call at any time — always resolves, never rejects on its own.
+     */
+    flush(): Promise<void>;
+    /**
+     * Release any resources held by the adapter (connections, file handles, timers).
+     * Call this when the stack is no longer needed — especially important for the
+     * API adapter, which holds an open connection and retry timers.
+     * Safe to call even if the adapter has no resources to release.
+     */
+    close(): Promise<void>;
+    private saveVersion;
+}
+//# sourceMappingURL=stack.d.ts.map

package/dist/stack.d.ts.map

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

package/dist/stack.js

@@ -0,0 +1,429 @@
+/**
+ * Stack — Core Stack Class
+ * -------------------------------------------------------
+ * The Stack class is the primary interface for apps. It sits
+ * on top of a StackAdapter and adds:
+ *
+ *  - ID generation
+ *  - Type definition and schema hashing
+ *  - Content validation on write
+ *  - Migration registry and auto-migration on read
+ *  - Version snapshotting on update
+ *  - Soft and hard delete
+ *
+ * Apps should never talk to a StackAdapter directly.
+ */
+import { generateId } from './id.js';
+import { hashSchema, isCompatible, parseTypeId } from './schema.js';
+import { validateContent } from './validate.js';
+export class StackValidationError extends Error {
+    errors;
+    constructor(errors) {
+        super(`Content validation failed:\n` + errors.map((e) => `  ${e.path}: ${e.message}`).join('\n'));
+        this.errors = errors;
+        this.name = 'StackValidationError';
+    }
+}
+export class StackMigrationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StackMigrationError';
+    }
+}
+// -------------------------------------------------------
+// Stack class
+// -------------------------------------------------------
+export class Stack {
+    adapter;
+    ownerEntityId;
+    timezone;
+    migrations = new Map();
+    constructor(adapter, ownerEntityId, timezone) {
+        this.adapter = adapter;
+        this.ownerEntityId = ownerEntityId;
+        this.timezone = timezone;
+    }
+    /**
+     * Create a Stack instance. Reads ownerEntityId and timezone from the
+     * adapter's config — the adapter is the single source of truth for
+     * stack-level configuration.
+     */
+    static async create(adapter) {
+        const entityId = await adapter.getConfig('entity_id');
+        const timezone = (await adapter.getConfig('timezone')) ?? 'UTC';
+        return new Stack(adapter, entityId, timezone);
+    }
+    get capabilities() {
+        return this.adapter.capabilities;
+    }
+    // -------------------------------------------------------
+    // Types
+    // -------------------------------------------------------
+    /**
+     * Define and persist a new Type. Computes the schemaHash automatically.
+     * Should be called at app startup before creating any records of this type.
+     */
+    async defineType(id, name, schema, opts = {}) {
+        const parsed = parseTypeId(id);
+        if (!parsed) {
+            throw new Error(`Invalid TypeId format: "${id}". Expected "namespace/name@version", e.g. "com.example.myapp/note@1".`);
+        }
+        const schemaHash = await hashSchema(schema);
+        const type = {
+            id,
+            baseId: parsed.baseId,
+            version: parsed.version,
+            name,
+            schema,
+            schemaHash,
+            createdAt: new Date(),
+            ...(opts.migratesFrom && { migratesFrom: opts.migratesFrom }),
+        };
+        await this.adapter.saveType(type);
+        return type;
+    }
+    async getType(id) {
+        return this.adapter.getType(id);
+    }
+    async listTypes() {
+        return this.adapter.listTypes();
+    }
+    /**
+     * Check whether a record's type is compatible with a required schema.
+     * Useful for duck-typed consumption across types.
+     */
+    async typeIsCompatible(typeId, requiredSchema) {
+        const type = await this.adapter.getType(typeId);
+        if (!type)
+            return false;
+        return isCompatible(type.schema, requiredSchema);
+    }
+    // -------------------------------------------------------
+    // Migration registry
+    // -------------------------------------------------------
+    /**
+     * Register a migration function between two adjacent Type versions.
+     * Call at app startup after defineType(). The library composes
+     * adjacent migrations into chains automatically.
+     *
+     * Migrations run in-memory — they do not write to the adapter unless
+     * you call migrateAll() explicitly.
+     */
+    registerMigration(migration) {
+        if (this.migrations.has(migration.from)) {
+            throw new StackMigrationError(`A migration from "${migration.from}" is already registered.`);
+        }
+        this.migrations.set(migration.from, migration);
+    }
+    /**
+     * Find and compose a migration path from one TypeId to another.
+     * Returns null if no path exists.
+     */
+    resolveMigrationPath(fromId, toId) {
+        if (fromId === toId)
+            return (content) => content;
+        const fns = [];
+        let current = fromId;
+        while (current !== toId) {
+            const migration = this.migrations.get(current);
+            if (!migration)
+                return null;
+            fns.push(migration.migrate);
+            current = migration.to;
+        }
+        return (content) => fns.reduce((c, fn) => fn(c), content);
+    }
+    /**
+     * Find the latest registered version of a type family.
+     * Follows the migration chain from the given typeId to the end.
+     */
+    latestTypeId(fromId) {
+        let current = fromId;
+        while (this.migrations.has(current)) {
+            current = this.migrations.get(current).to;
+        }
+        return current;
+    }
+    /**
+     * Eagerly migrate all records of a type family to the latest version,
+     * committing the results to disk immediately.
+     *
+     * Normally migration is lazy — records are migrated in memory on read
+     * and written back only when next updated. Call migrateAll() when you
+     * want to commit all pending migrations in one deliberate pass, for
+     * example before a deployment or after a major schema change.
+     *
+     * Previous content is preserved in version history before each write.
+     */
+    async migrateAll(baseTypeId) {
+        const types = await this.adapter.listTypes();
+        const familyTypeIds = types.filter((t) => t.baseId === baseTypeId).map((t) => t.id);
+        if (familyTypeIds.length === 0) {
+            throw new StackMigrationError(`migrateAll: no registered types found for baseTypeId "${baseTypeId}"`);
+        }
+        let migrated = 0;
+        for (const typeId of familyTypeIds) {
+            const latestId = this.latestTypeId(typeId);
+            if (typeId === latestId)
+                continue;
+            const migrateFn = this.resolveMigrationPath(typeId, latestId);
+            if (!migrateFn)
+                continue;
+            let cursor;
+            do {
+                const result = await this.adapter.queryRecords({
+                    filter: { typeId },
+                    limit: 100,
+                    cursor,
+                });
+                for (const record of result.records) {
+                    await this.saveVersion(record);
+                    const migratedContent = migrateFn(record.content);
+                    await this.adapter.updateRecord(record.id, {
+                        typeId: latestId,
+                        content: migratedContent,
+                        updatedAt: new Date(),
+                        version: record.version + 1,
+                    });
+                    migrated++;
+                }
+                cursor = result.cursor ?? undefined;
+            } while (cursor);
+        }
+        return { migrated };
+    }
+    // -------------------------------------------------------
+    // Records
+    // -------------------------------------------------------
+    /**
+     * Create a new record. Validates content against the type's schema.
+     */
+    async create(typeId, content, opts = {}) {
+        const type = await this.adapter.getType(typeId);
+        if (!type) {
+            throw new Error(`Unknown type: "${typeId}". Call defineType() first.`);
+        }
+        const errors = validateContent(content, type.schema);
+        if (errors.length > 0) {
+            throw new StackValidationError(errors);
+        }
+        const now = new Date();
+        const record = {
+            id: generateId(),
+            typeId,
+            createdAt: now,
+            updatedAt: now,
+            content,
+            version: 1,
+            ...(opts.parentId && { parentId: opts.parentId }),
+            ...(opts.entityId
+                ? { entityId: opts.entityId }
+                : this.ownerEntityId && { entityId: this.ownerEntityId }),
+            ...(opts.appId && { appId: opts.appId }),
+            ...(opts.permissions?.length && { permissions: opts.permissions }),
+            ...(opts.associations?.length && { associations: opts.associations }),
+        };
+        return this.adapter.createRecord(record);
+    }
+    /**
+     * Get a record by ID.
+     *
+     * If the record is on an older type version and a migration path is
+     * registered, the content is migrated in memory and returned at the
+     * latest type version — but nothing is written to disk. Migration is
+     * only persisted when the record is next updated via update().
+     *
+     * Pass { migrate: false } to get the raw stored record without migration.
+     */
+    async get(id, opts = {}) {
+        const record = await this.adapter.getRecord(id);
+        if (!record)
+            return null;
+        const shouldMigrate = opts.migrate !== false;
+        if (!shouldMigrate)
+            return record;
+        const latestId = this.latestTypeId(record.typeId);
+        if (latestId === record.typeId)
+            return record;
+        const migrateFn = this.resolveMigrationPath(record.typeId, latestId);
+        if (!migrateFn) {
+            console.warn(`[Stack] No migration path from "${record.typeId}" to "${latestId}" for record "${id}". ` +
+                `Returning raw record. Register migrations with stack.registerMigration().`);
+            return record;
+        }
+        return {
+            ...record,
+            typeId: latestId,
+            content: migrateFn(record.content),
+        };
+    }
+    /**
+     * Update a record's content. Accepts a partial content object — only the
+     * fields provided are changed. Omitted fields retain their current values.
+     *
+     * To remove an optional field, set it explicitly to null:
+     *   stack.update(id, { title: null })  // removes 'title' from content
+     *
+     * If the record is on an older type version, its content is migrated
+     * in memory first, then the patch is applied. The updated record is
+     * written at the latest type version — this is when lazy migration
+     * is committed to disk.
+     *
+     * Validates the merged result against the type's schema. Saves the
+     * previous state to version history before updating.
+     *
+     * For association or permission changes, use associate(), dissociate(),
+     * and setPermissions() instead.
+     */
+    async update(id, content) {
+        const existing = await this.adapter.getRecord(id);
+        if (!existing) {
+            throw new Error(`Record not found: "${id}"`);
+        }
+        // Resolve the latest type version and migrate existing content
+        // in memory before applying the patch. This is when lazy migration
+        // from get() gets committed to disk.
+        const latestTypeId = this.latestTypeId(existing.typeId);
+        const migrateFn = this.resolveMigrationPath(existing.typeId, latestTypeId);
+        const existingContent = migrateFn ? migrateFn(existing.content) : existing.content;
+        const type = await this.adapter.getType(latestTypeId);
+        if (!type) {
+            throw new Error(`Unknown type: "${latestTypeId}"`);
+        }
+        // Shallow merge: start with (migrated) existing content, apply changes.
+        // null values mean "delete this field" (RFC 7396 / JSON Merge Patch).
+        const merged = { ...existingContent };
+        for (const [key, value] of Object.entries(content)) {
+            if (value === null) {
+                delete merged[key];
+            }
+            else {
+                merged[key] = value;
+            }
+        }
+        const errors = validateContent(merged, type.schema);
+        if (errors.length > 0) {
+            throw new StackValidationError(errors);
+        }
+        // Snapshot the raw stored state before overwriting
+        await this.saveVersion(existing);
+        return this.adapter.updateRecord(id, {
+            typeId: latestTypeId,
+            content: merged,
+            updatedAt: new Date(),
+            version: existing.version + 1,
+        });
+    }
+    /**
+     * Add an association to a record.
+     * If the association already exists (same kind, label, and payload), this is a no-op.
+     */
+    async associate(id, association) {
+        return this.adapter.associate(id, association);
+    }
+    /**
+     * Remove an association from a record.
+     * Matched by kind, label, and payload. No-op if not found.
+     */
+    async dissociate(id, association) {
+        return this.adapter.dissociate(id, association);
+    }
+    /**
+     * Replace all permissions on a record.
+     * Pass an empty array to make the record private (the default).
+     */
+    async setPermissions(id, permissions) {
+        const existing = await this.adapter.getRecord(id);
+        if (!existing) {
+            throw new Error(`Record not found: "${id}"`);
+        }
+        await this.adapter.updateRecord(id, { permissions });
+    }
+    /**
+     * Soft-delete a record (default) or hard-delete it permanently.
+     * Soft-deleted records are excluded from queries unless includeDeleted is set.
+     * Hard-deleted records and all their version history are permanently removed.
+     */
+    async delete(id, opts = {}) {
+        return this.adapter.deleteRecord(id, opts);
+    }
+    /**
+     * Query records. See StackQuery for filter, sort, and pagination options.
+     */
+    async query(query = {}) {
+        return this.adapter.queryRecords(query);
+    }
+    // -------------------------------------------------------
+    // Versions
+    // -------------------------------------------------------
+    async getVersions(id) {
+        return this.adapter.getVersions(id);
+    }
+    async getVersion(id, version) {
+        return this.adapter.getVersion(id, version);
+    }
+    /**
+     * Restore a record to a previous version by creating a new version
+     * with the old content. Never rewrites history.
+     */
+    async restoreVersion(id, version) {
+        const existing = await this.adapter.getRecord(id);
+        if (!existing) {
+            throw new Error(`Record not found: "${id}"`);
+        }
+        const target = await this.adapter.getVersion(id, version);
+        if (!target) {
+            throw new Error(`Version ${version} not found for record "${id}"`);
+        }
+        // Snapshot current state before restoring
+        await this.saveVersion(existing);
+        return this.adapter.updateRecord(id, {
+            content: target.content,
+            updatedAt: new Date(),
+            version: existing.version + 1,
+        });
+    }
+    // -------------------------------------------------------
+    // Attachments
+    // -------------------------------------------------------
+    async putAttachment(data, mimeType) {
+        return this.adapter.putAttachment(data, mimeType);
+    }
+    async getAttachment(fileId) {
+        return this.adapter.getAttachment(fileId);
+    }
+    // -------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------
+    /**
+     * Flush any pending writes to the underlying storage.
+     * For adapters that write immediately (SQLite, JSON), this is a no-op.
+     * For the API adapter, this commits the offline write queue to the server.
+     * Safe to call at any time — always resolves, never rejects on its own.
+     */
+    async flush() {
+        await this.adapter.flush?.();
+    }
+    /**
+     * Release any resources held by the adapter (connections, file handles, timers).
+     * Call this when the stack is no longer needed — especially important for the
+     * API adapter, which holds an open connection and retry timers.
+     * Safe to call even if the adapter has no resources to release.
+     */
+    async close() {
+        await this.adapter.close?.();
+    }
+    // -------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------
+    async saveVersion(record) {
+        const version = {
+            version: record.version,
+            content: record.content,
+            updatedAt: record.updatedAt,
+            ...(record.entityId && { entityId: record.entityId }),
+        };
+        await this.adapter.saveVersion(record.id, version);
+    }
+}
+//# sourceMappingURL=stack.js.map

package/dist/stack.js.map

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