@iebh/tera-fy 2.3.10 → 2.3.12

package/dist/lib/syncro/entities.js

@@ -1,212 +0,0 @@
-/* eslint-disable jsdoc/reject-function-type, no-unused-vars */
-// @ts-expect-error TODO: Remove when reflib gets declaration file
-import Reflib from '@iebh/reflib';
-import { v4 as uuid4 } from 'uuid';
-import { nanoid } from 'nanoid';
-/**
-* Entities we support Syncro paths for, each should correspond directly with a Firebase/Firestore collection name
-*
-* @type {Object} An object lookup of entities
-*
-* @property {String} singular The singular noun for the item
-* @property {Function} initState Function called to initialize state when Firestore has no existing document. Called as `({HYPERDRIVE:PostgresSql, supabasey:BoundSupabaseyFunction, id:String, relation?:string})` and expected to return the initial data object state
-* @property {Function} flushState Function called to flush state from Firebase to Postgres. Called the same as `initState` + `{state:Object}`
-*/
-const syncroConfig = {
-    institutes: {
-        singular: 'institute',
-        async initState({ HYPERDRIVE, id }) {
-            let rows = await HYPERDRIVE `
-				SELECT data
-				FROM institutes
-				WHERE id = ${id}
-				LIMIT 1
-			`;
-            if (rows.length > 0) {
-                return rows[0].data; // institute is valid and already exists
-            }
-            else {
-                throw new Error(`Syncro institute "${id}" not found`);
-            }
-        },
-        flushState({ HYPERDRIVE, state, id }) {
-            return HYPERDRIVE `
-				SELECT syncro_merge_data(
-					table_name => 'institutes',
-					entity_id => ${id}::UUID,
-					new_data => ${HYPERDRIVE.json(state)}::JSONB
-				)
-			`;
-        },
-    }, // }}}
-    projects: {
-        singular: 'project',
-        async initState({ HYPERDRIVE, supabasey, id }) {
-            let rows = await HYPERDRIVE `
-				SELECT data
-				FROM projects
-				WHERE id = ${id}
-				LIMIT 1
-			`;
-            if (rows.length == 0)
-                throw new Error(`Syncro project "${id}" not found`);
-            const data = rows[0].data;
-            // MIGRATION - Move data.temp{} into Supabase files + add pointer to filename {{{
-            if (data.temp // Project contains temp subkey
-                && Object.values(data.temp).some((t) => typeof t == 'object') // Some of the temp keys are objects
-            ) {
-                console.log('[MIGRATION] tera-fy project v1 -> v2', data.temp);
-                const tempObject = data.temp;
-                await Promise.all(Object.entries(data.temp)
-                    .filter(([, branch]) => typeof branch == 'object')
-                    .map(([toolKey]) => {
-                    console.log(`[MIGRATION] Converting data.temp[${toolKey}]...`);
-                    const toolName = toolKey.split('-')[0];
-                    const fileName = `data-${toolName}-${nanoid()}.json`;
-                    console.log('[MIGRATION] Creating filename:', fileName);
-                    return Promise.resolve()
-                        .then(() => supabasey((supabase) => supabase // Split data.temp[toolKey] -> file {{{
-                        .storage
-                        .from('projects')
-                        .upload(`${id}/${fileName}`, new File([
-                        new Blob([
-                            JSON.stringify(tempObject[toolKey], null, '\t'),
-                        ], {
-                            type: 'application/json',
-                        }),
-                    ], fileName, {
-                        type: 'application/json',
-                    }), {
-                        cacheControl: '3600',
-                        upsert: true,
-                    }))) // }}}
-                        .then(() => tempObject[toolKey] = fileName) // Replace data.temp[toolKey] with new filename
-                        .catch(e => {
-                        console.warn('[MIGRATION] Failed to create file', fileName, '-', e);
-                        throw e;
-                    });
-                }));
-            } // }}}
-            return data;
-        },
-        flushState({ HYPERDRIVE, state, fsId }) {
-            return HYPERDRIVE `
-				SELECT syncro_merge_data(
-					table_name => 'projects',
-					entity_id => ${fsId}::UUID,
-					new_data => ${HYPERDRIVE.json(state)}::JSONB
-				)
-			`;
-        },
-    }, // }}}
-    project_libraries: {
-        singular: 'project library',
-        async initState({ id, relation, supabasey }) {
-            if (!relation || !/_\*$/.test(relation))
-                throw new Error('Project library relation missing, path should resemble "project_library::${PROJECT}::${LIBRARY_FILE_ID}_*"');
-            const fileId = relation.replace(/_\*$/, '');
-            const files = await supabasey((supabase) => supabase
-                .storage
-                .from('projects')
-                .list(id));
-            const file = files?.find((f) => f.id == fileId);
-            if (!file)
-                return Promise.reject(`Invalid file ID "${fileId}"`);
-            const blob = await supabasey((supabase) => supabase
-                .storage
-                .from('projects')
-                .download(`${id}/${file.name}`));
-            if (!blob)
-                throw new Error('Failed to download file blob');
-            const refs = await Reflib.uploadFile({
-                file: new File([blob], file.name.replace(/^.*[/\\]/, '')),
-            });
-            return Object.fromEntries(refs // Transform Reflib Ref array into a keyed UUID object
-                .map((ref) => [
-                uuid4(), // TODO: This should really be using V5 with some-kind of namespacing but I can't get my head around the documentation - MC 2025-02-21
-                ref, // The actual ref payload
-            ]));
-        },
-        flushState() {
-            throw new Error('Flushing project_libraries::* namespace is not yet supported');
-        },
-    }, // }}}
-    project_namespaces: {
-        singular: 'project namespace',
-        async initState() {
-            throw new Error('Updating project_namespaces is not yet supported');
-        },
-        async flushState() {
-            throw new Error('Updating project_namespaces is not yet supported');
-        },
-    }, // }}}
-    test: {
-        singular: 'test',
-        async initState({ HYPERDRIVE, id }) {
-            let rows = await HYPERDRIVE `
-				SELECT data
-				FROM test
-				WHERE id = ${id}
-				LIMIT 1
-			`;
-            if (rows.length > 0) {
-                return rows[0].data; // User is valid and already exists
-            }
-            else {
-                throw new Error(`Syncro test "${id}" not found`);
-            }
-        },
-        flushState({ HYPERDRIVE, state, fsId }) {
-            return HYPERDRIVE `
-				SELECT syncro_merge_data(
-					table_name => 'test',
-					entity_id => ${fsId}::UUID,
-					new_data => ${HYPERDRIVE.json(state)}::JSONB
-				)
-			`;
-        },
-    }, // }}}
-    users: {
-        singular: 'user',
-        async initState({ HYPERDRIVE, id }) {
-            let rows = await HYPERDRIVE `
-				SELECT data
-				FROM users
-				WHERE id = ${id}
-				LIMIT 1
-			`;
-            if (rows.length > 0)
-                return rows[0].data; // User is valid and already exists
-            // User row doesn't already exist - this shouldn't happen if the user has correctly gone through the onboarding process
-            // but... *shrugs*, who knows
-            let newUser = await HYPERDRIVE `
-				INSERT INTO users
-				(
-					id,
-					data
-				)
-				VALUES (
-					${id},
-					${HYPERDRIVE.json({
-                id,
-                credits: 1000,
-            })}::JSONB
-				)
-			`;
-            if (!newUser?.length)
-                throw new Error(`Failed to create new user "${id}"`);
-            return newUser[0].data; // Return back the data that eventually got created - allowing for database triggers, default field values etc.
-        },
-        flushState({ HYPERDRIVE, state, fsId }) {
-            return HYPERDRIVE `
-				SELECT syncro_merge_data(
-					table_name => 'users',
-					entity_id => ${fsId}::UUID,
-					new_data => ${HYPERDRIVE.json(state)}::JSONB
-				)
-			`;
-        },
-    }, // }}}
-};
-export default syncroConfig;
-//# sourceMappingURL=entities.js.map

package/dist/lib/syncro/entities.js.map

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

package/dist/lib/syncro/keyed (Rhino's conflicted copy 2026-05-10).js

@@ -1,287 +0,0 @@
-import { chunk } from 'lodash-es';
-import { doc as FirestoreDocRef, getDoc as FirestoreGetDoc } from 'firebase/firestore';
-import Syncro from './syncro.js';
-import SyncroEntities from './entities.js';
-/**
-* @class SyncroKeyed
-* TERA Isomorphic SyncroKeyed class
-* Collate a single (potentially very large) single Syncro object by splitting it across multiple Syncros
-* This makes the assumption that the Syncro content is a large object collection of objects - a keyed map collection
-* The original impetus is to allow TERA citation libraries to be held in a Syncro object and flushed back to Supabase when editing has completed
-*/
-export default class SyncroKeyed extends Syncro {
-    /**
-    * Config used by this instance to configure behaviour
-    *
-    * @type {Object}
-    * @property {Number} maxKeys The maximum number of keys a member can contain before needing to add a member
-    */
-    keyedConfig = {
-        maxKeys: 2,
-    };
-    /**
-    * Various storage about keyed path
-    */
-    keyedPath = {
-        getKey(path, index) {
-            return path + '_' + index;
-        },
-    };
-    /**
-    * Member Syncros which form part of this meta Syncro
-    *
-    * @type {Array<Syncro>}
-    */
-    members = [];
-    /**
-    * Instance constructor
-    *
-    * @param {String} path Mount path for the Syncro. Should be in the form `${ENTITY}::${ID}(::${RELATION})?_*` (must contain a '*' operator)
-    * @param {Object} [options] Additional instance setters (mutates instance directly)
-    */
-    constructor(path, options) {
-        super(path, options);
-        if (!/\*/.test(path))
-            throw new Error('SyncroKeyed paths must contain at least one asterisk as an object pagination indicator');
-        const { prefix, suffix } = /^(?<prefix>.+)\*(?<suffix>.*)$/.exec(path).groups;
-        this.keyedPath.getKey = (path, index) => `${prefix}${index}${suffix}`;
-    }
-    /**
-    * Destroy all Syncro members
-    *
-    * @returns {Promise} A promise which resolves when the operation has completed
-    */
-    async destroy() {
-        this.debug('Destroy!');
-        await Promise.all(this.members.map(member => member.destroy()));
-        this.members = [];
-        return []; // Return empty array cast to never[] to satisfy signature
-    }
-    /**
-    * Mount this SyncroKeyed instance
-    * i.e. Fetch all members and mount them locally creating a Proxy
-    *
-    * @returns {Promise<Syncro>} A promise which resolves as this SyncroKeyed instance when completed
-    */
-    mount() {
-        // Cast the result to the expected interface
-        const { entity, id, relation, fsCollection, fsId } = Syncro.pathSplit(this.path, { allowAsterisk: true });
-        return Promise.resolve()
-            .then(() => new Promise(resolve => {
-            this.members = []; // Reset member list
-            const seekMember = async (index) => {
-                const memberId = fsId.replace('*', '' + index);
-                this.debug('Seek keyedMember', fsCollection, '#', memberId);
-                const docRef = FirestoreDocRef(Syncro.firestore, fsCollection, memberId);
-                const doc = await FirestoreGetDoc(docRef);
-                if (doc.exists()) { // Found a matching entry
-                    // Expand member lookup with the new member by its numeric index
-                    await this.keyedMembersExpand(index);
-                    // Queue up next member fetcher
-                    setTimeout(() => seekMember(index + 1));
-                }
-                else { // Likely reached end of possible members
-                    resolve();
-                }
-            };
-            seekMember(0); // Look for first member
-        }))
-            .then(async () => {
-            if (this.members.length > 0)
-                return;
-            // Create at least one member in the registry
-            await this.keyedMembersExpand(0);
-            this.debug('Populate initial SyncroKeyed state');
-            // Extract base data + add document and return new hook
-            const entityKey = entity;
-            if (!SyncroEntities[entityKey])
-                throw new Error(`Unknown Sync entity "${entity}"`);
-            // Go fetch the initial state object
-            const state = await SyncroEntities[entityKey].initState({
-                supabasey: Syncro.supabasey,
-                id, relation,
-            });
-            await this.keyedAssign(state);
-        })
-            .then(() => {
-            const reactive = this.getReactive(this.proxy());
-            // Assuming this.value should hold the reactive proxy
-            // If this.value is inherited and has a specific type, this might need adjustment
-            this.value = reactive.doc;
-        })
-            .then(() => this);
-    }
-    /**
-    * Return a Proxy which will map setter/getter actions to their correct member
-    *
-    * @returns {Proxy} A proxy of all combined members
-    */
-    proxy() {
-        return new Proxy(this, {
-            // Return the full list of keys
-            ownKeys(target) {
-                return target.members.flatMap(m => Object.keys(m.value || {}));
-            },
-            // Return if we have a lookup key
-            has(target, prop) {
-                // Ensure m.value exists before checking property
-                return target.members.some(m => m.value && prop in m.value);
-            },
-            // Scope through members until we get a hit on the key
-            get(target, prop) {
-                const targetMember = target.members.find(m => m.value && prop in m.value);
-                // Access value via targetMember.value if found
-                return targetMember ? targetMember.value[prop] : undefined;
-            },
-            // Set the member key if one already exists, otherwise overflow onto the next member
-            set(target, prop, value) {
-                const targetMember = target.members.find(m => m.value && prop in m.value);
-                if (targetMember && targetMember.value) {
-                    targetMember.value[prop] = value;
-                }
-                else {
-                    // Assuming keyedSet handles adding the value appropriately
-                    target.keyedSet(prop, value); // Cast prop to string if keyedSet expects string
-                }
-                return true; // Proxy set must return boolean
-            },
-            // Remove a key
-            deleteProperty(target, prop) {
-                const targetMember = target.members.find(m => m.value && prop in m.value);
-                if (targetMember && targetMember.value) {
-                    delete targetMember.value[prop];
-                    return true; // Indicate success
-                }
-                return false; // Indicate key not found or failure
-            },
-        });
-    }
-    /**
-    * Flush all member states
-    *
-    * @param {Object} [options] Additional options to mutate behaviour
-    * @param {Boolean} [options.destroy=false] Instruct the server to also dispose of the Syncro state
-    *
-    * @returns {Promise} A promise which resolves when the operation has completed
-    */
-    async flush(options) {
-        const settings = {
-            destroy: false,
-            ...options,
-        };
-        await Promise.all(this.members.map(member => member.flush({
-            destroy: settings.destroy,
-        })));
-        if (settings.destroy)
-            await this.destroy();
-        return; // Return void to match signature
-    }
-    /**
-    * Set a given key against the next available member
-    * This will either pick the next available member with keys below `config.maxKeys` or extend the member array and append to it
-    *
-    * @param {String} key The key to set
-    * @param {*} value The value to set
-    *
-    * @returns {Promise<*>} A promise which resolves when the operation has completed with the set value
-    */
-    async keyedSet(key, value) {
-        const candidateMember = this.members.find(m => m.value && Object.keys(m.value).length < this.keyedConfig.maxKeys);
-        if (candidateMember?.value) {
-            candidateMember.value[key] = value;
-            return value;
-        }
-        else { // No candidate - need to expand then set
-            // Extend members
-            await this.keyedMembersExpand(); // Call without index to append
-            // Get the newly added member
-            // eslint-disable-next-line unicorn/prefer-at
-            const newMember = this.members[this.members.length - 1];
-            if (!newMember || !newMember.value) {
-                throw new Error('Failed to expand members or new member has no value object');
-            }
-            // Sanity check (check the new member's value)
-            if (Object.keys(newMember.value).length >= this.keyedConfig.maxKeys) {
-                throw new Error(`Need to append key "${key}" but newly added member (offset #${this.members.length - 1}) has size of ${Object.keys(newMember.value).length}, exceeding maxKeys ${this.keyedConfig.maxKeys}`);
-            }
-            newMember.value[key] = value;
-            return value;
-        }
-    }
-    /**
-    * Assign an entire in-memory object to members
-    * This can be thought of as the optimized equivalent of Object.assign()
-    * Use this when merging large objects as it can make optimizations
-    *
-    * @param {Object} state The value to merge
-    */
-    async keyedAssign(state) {
-        // Can we assume we have a blank state - this speeds up existing key checks significantly
-        // Ensure members[0] and its value exist
-        const isBlank = this.members.length === 1 && this.members[0]?.value && Object.keys(this.members[0].value).length === 0;
-        if (isBlank) {
-            const chunks = chunk(Object.entries(state), this.keyedConfig.maxKeys)
-                .map(chunk => Object.fromEntries(chunk));
-            await Promise.all(chunks.map(async (chunk, chunkIndex) => {
-                this.debug(`Assign chunk #${chunkIndex} content`, { chunk });
-                // Create chunk document if its missing
-                if (!this.members[chunkIndex])
-                    await this.keyedMembersExpand(chunkIndex);
-                // Ensure the member exists and has setFirestoreState method
-                const member = this.members[chunkIndex];
-                if (member && typeof member.setFirestoreState === 'function') {
-                    // Populate its state - Cast to any temporarily if setFirestoreState is not public/recognized
-                    await member.setFirestoreState(chunk, { method: 'set' });
-                }
-                else {
-                    console.warn(`Member at index ${chunkIndex} is missing or does not have setFirestoreState`);
-                }
-            }));
-        }
-        else { // Non-blank - call keyedSet() on each key of state, merging slowly
-            // Replace Array.fromAsync with a standard loop
-            for (const [key, val] of Object.entries(state)) {
-                await this.keyedSet(key, val);
-            }
-        }
-    }
-    /**
-    * Extend the member pool by one member
-    *
-    * @param {Number} [index] The index to use when expanding, if omitted the next index offset is used
-    * @returns {Promise} A promise which resolves when the operation has completed
-    */
-    async keyedMembersExpand(index) {
-        index = index ?? this.members.length; // Use provided index or next available slot
-        if (this.members[index]) {
-            // If member already exists (e.g., during initial seek), just ensure it's mounted.
-            // If it was called intentionally with an existing index, maybe log a warning or skip.
-            this.debug(`keyedMembersExpand called for existing index ${index}, ensuring mounted.`);
-            if (!this.members[index].value) { // If it exists but isn't mounted somehow
-                await this.members[index].mount({ initialState: {} });
-            }
-            return; // Exit if member already exists
-        }
-        const syncroPath = this.keyedPath.getKey(this.path, index);
-        // Pass empty options object {} or specify allowAsterisk: false if needed
-        const { fsCollection, fsId } = Syncro.pathSplit(syncroPath, {});
-        this.debug('Expand SyncroKeyed size to index=', index);
-        // Create a new Syncro member, inheriteing some details from this parent item
-        const syncro = new Syncro(`${fsCollection}::${fsId}`, {
-            debug: this.debug,
-            getReactive: this.getReactive,
-        });
-        // Wait for mount to complete
-        await syncro.mount({
-            initialState: {}, // Force initial state to empty object so we don't get stuck in a loop
-        });
-        // Insert at the correct index if specified, otherwise push
-        if (index < this.members.length) {
-            this.members.splice(index, 0, syncro);
-        }
-        else {
-            this.members.push(syncro);
-        }
-    }
-}
-//# sourceMappingURL=keyed.js.map

package/dist/lib/syncro/keyed.d.ts

@@ -1,95 +0,0 @@
-import Syncro from './syncro.js';
-interface FlushOptions {
-    destroy?: boolean;
-}
-/**
-* @class SyncroKeyed
-* TERA Isomorphic SyncroKeyed class
-* Collate a single (potentially very large) single Syncro object by splitting it across multiple Syncros
-* This makes the assumption that the Syncro content is a large object collection of objects - a keyed map collection
-* The original impetus is to allow TERA citation libraries to be held in a Syncro object and flushed back to Supabase when editing has completed
-*/
-export default class SyncroKeyed extends Syncro {
-    /**
-    * Config used by this instance to configure behaviour
-    *
-    * @type {Object}
-    * @property {Number} maxKeys The maximum number of keys a member can contain before needing to add a member
-    */
-    keyedConfig: {
-        maxKeys: number;
-    };
-    /**
-    * Various storage about keyed path
-    */
-    keyedPath: {
-        getKey(path: string, index: number): string;
-    };
-    /**
-    * Member Syncros which form part of this meta Syncro
-    *
-    * @type {Array<Syncro>}
-    */
-    members: Syncro[];
-    /**
-    * Instance constructor
-    *
-    * @param {String} path Mount path for the Syncro. Should be in the form `${ENTITY}::${ID}(::${RELATION})?_*` (must contain a '*' operator)
-    * @param {Object} [options] Additional instance setters (mutates instance directly)
-    */
-    constructor(path: string, options?: Record<string, any>);
-    /**
-    * Destroy all Syncro members
-    *
-    * @returns {Promise} A promise which resolves when the operation has completed
-    */
-    destroy(): Promise<never[]>;
-    /**
-    * Mount this SyncroKeyed instance
-    * i.e. Fetch all members and mount them locally creating a Proxy
-    *
-    * @returns {Promise<Syncro>} A promise which resolves as this SyncroKeyed instance when completed
-    */
-    mount(): Promise<Syncro>;
-    /**
-    * Return a Proxy which will map setter/getter actions to their correct member
-    *
-    * @returns {Proxy} A proxy of all combined members
-    */
-    proxy(): Record<string | symbol, any>;
-    /**
-    * Flush all member states
-    *
-    * @param {Object} [options] Additional options to mutate behaviour
-    * @param {Boolean} [options.destroy=false] Instruct the server to also dispose of the Syncro state
-    *
-    * @returns {Promise} A promise which resolves when the operation has completed
-    */
-    flush(options?: FlushOptions): Promise<void>;
-    /**
-    * Set a given key against the next available member
-    * This will either pick the next available member with keys below `config.maxKeys` or extend the member array and append to it
-    *
-    * @param {String} key The key to set
-    * @param {*} value The value to set
-    *
-    * @returns {Promise<*>} A promise which resolves when the operation has completed with the set value
-    */
-    keyedSet(key: string, value: any): Promise<any>;
-    /**
-    * Assign an entire in-memory object to members
-    * This can be thought of as the optimized equivalent of Object.assign()
-    * Use this when merging large objects as it can make optimizations
-    *
-    * @param {Object} state The value to merge
-    */
-    keyedAssign(state: Record<string, any>): Promise<void>;
-    /**
-    * Extend the member pool by one member
-    *
-    * @param {Number} [index] The index to use when expanding, if omitted the next index offset is used
-    * @returns {Promise} A promise which resolves when the operation has completed
-    */
-    keyedMembersExpand(index?: number): Promise<void>;
-}
-export {};