@owlmeans/client-planning 0.1.18-rc.9 → 0.1.18

package/build/lifecycle/types.d.ts

@@ -0,0 +1,27 @@
+/** One captured authenticated generation; cancellation does not undo a server write. */
+export interface PlanningOperation {
+    key: string;
+    signal: AbortSignal;
+    active: () => boolean;
+    check: () => void;
+    wait: <T>(pending: Promise<T>) => Promise<T>;
+    cancel: (reason?: Error) => void;
+    release: () => void;
+}
+/** Shared cancellation and the boundary between local mirror mutations and clearing. */
+export interface PlanningClientLifecycle {
+    key: () => string;
+    capture: (expected?: string) => PlanningOperation;
+    run: <T>(work: (operation: PlanningOperation) => Promise<T>) => Promise<T>;
+    /** Local store operations only: never hold this queue over an RPC or a socket opener. */
+    mutate: <T>(operation: PlanningOperation, work: () => Promise<T>) => Promise<T>;
+    drain: () => Promise<void>;
+    onInvalidate: (listener: () => void | Promise<void>) => () => void;
+    close: () => Promise<void>;
+}
+export interface PlanningClientLifecycleOptions {
+    scopeKey?: () => string | undefined;
+    /** Runs in the mutation queue after admitted old writes have drained. */
+    clear?: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/lifecycle/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,OAAO,CAAA;IACrB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,MAAM,CAAA;IACjB,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,iBAAiB,CAAA;IACjD,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAC1E,yFAAyF;IACzF,MAAM,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAC/E,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAA;IAClE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IACnC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B"}

package/build/lifecycle/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/lifecycle/types.js.map

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

package/build/lifecycle.d.ts

@@ -0,0 +1,3 @@
+import type { PlanningClientLifecycle, PlanningClientLifecycleOptions } from './lifecycle/types.js';
+export declare const makePlanningClientLifecycle: (opts?: PlanningClientLifecycleOptions) => PlanningClientLifecycle;
+//# sourceMappingURL=lifecycle.d.ts.map

package/build/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,8BAA8B,EAAqB,MAAM,sBAAsB,CAAA;AAItH,eAAO,MAAM,2BAA2B,UAAU,8BAA8B,KAAQ,uBAoHvF,CAAA"}

package/build/lifecycle.js

@@ -0,0 +1,157 @@
+import { logger } from '@owlmeans/log';
+import { PlanningError } from '@owlmeans/planning';
+const log = logger('client-planning');
+export const makePlanningClientLifecycle = (opts = {}) => {
+    let identity = opts.scopeKey?.() ?? '';
+    let epoch = 0;
+    let tail = Promise.resolve();
+    let closing = null;
+    let blocked = false;
+    let failed = false;
+    let empty = false;
+    let admissions = 0;
+    const operations = new Set();
+    const listeners = new Set();
+    const changed = () => new PlanningError('client:scope-changed');
+    const cancel = () => {
+        for (const controller of operations)
+            controller.abort(changed());
+        operations.clear();
+    };
+    const invalidate = (explicit = true) => {
+        // Changing a credential cannot recover a failed clear. Only an awaited explicit retry can.
+        if (!explicit && failed) {
+            epoch++;
+            cancel();
+            return Promise.resolve();
+        }
+        if (explicit && closing != null && blocked)
+            return closing;
+        // An explicit close rejects admission. A newly observed identity already names the new
+        // credential: its RPCs may start, but its local writes queue behind this generation's clear.
+        blocked = explicit || blocked;
+        epoch++;
+        cancel();
+        const admitted = admissions;
+        const previous = closing;
+        let resolve;
+        let reject;
+        const attempt = new Promise((yes, no) => { resolve = yes; reject = no; });
+        closing = attempt;
+        // Reserve clearing before invalidation listeners can start work. Each observed identity
+        // change reserves its own clear, including changes while an earlier close is still draining.
+        const clearing = tail.then(async () => { await opts.clear?.(); }).catch(error => {
+            blocked = true;
+            failed = true;
+            cancel();
+            throw error;
+        });
+        tail = clearing.catch(() => { });
+        const stopping = [...listeners].map(async (listener) => { await listener(); });
+        void Promise.all([clearing, ...stopping, ...(previous != null ? [previous] : [])]).then(() => {
+            if (closing === attempt) {
+                blocked = false;
+                failed = false;
+                closing = null;
+                empty = admissions === admitted;
+            }
+            resolve();
+        }, error => {
+            if (closing === attempt) {
+                blocked = true;
+                failed = true;
+                closing = null;
+                cancel();
+            }
+            reject(error);
+        });
+        // key() can invalidate without an awaiting caller; still observe and report cleanup failures.
+        void attempt.catch(error => log.error('Planning scope cleanup failed', error));
+        return attempt;
+    };
+    const key = () => {
+        const current = opts.scopeKey?.() ?? '';
+        if (current !== identity) {
+            identity = current;
+            // An awaited close already drained and emptied this generation. Adopt the next credential
+            // synchronously when no request/feed was admitted since, without a redundant invalidation.
+            if (empty && closing == null && !blocked && !failed)
+                epoch++;
+            else
+                void invalidate(false);
+        }
+        return `${epoch}:${identity}`;
+    };
+    const capture = (expected) => {
+        const captured = key();
+        if (blocked)
+            throw changed();
+        if (expected != null && expected !== captured)
+            throw changed();
+        empty = false;
+        admissions++;
+        const controller = new AbortController();
+        operations.add(controller);
+        const active = () => key() === captured && !blocked && !controller.signal.aborted;
+        const check = () => {
+            if (key() !== captured || blocked)
+                throw changed();
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+        };
+        const wait = async (pending) => {
+            let abort;
+            try {
+                // Observe even an already-cancelled operation's pending promise; a late RPC rejection
+                // must never become unhandled after its caller has left this generation.
+                const cancelled = new Promise((_, reject) => {
+                    abort = () => reject(controller.signal.reason ?? changed());
+                    controller.signal.addEventListener('abort', abort, { once: true });
+                    if (!active())
+                        abort();
+                });
+                const result = await Promise.race([pending, cancelled]);
+                check();
+                return result;
+            }
+            catch (error) {
+                check();
+                throw error;
+            }
+            finally {
+                if (abort != null)
+                    controller.signal.removeEventListener('abort', abort);
+            }
+        };
+        return { key: captured, signal: controller.signal, active, check, wait,
+            cancel: reason => { controller.abort(reason ?? changed()); }, release: () => { operations.delete(controller); } };
+    };
+    return {
+        key, capture,
+        run: async (work) => {
+            const operation = capture();
+            try {
+                const result = await work(operation);
+                operation.check();
+                return result;
+            }
+            finally {
+                operation.release();
+            }
+        },
+        mutate: async (operation, work) => {
+            const writing = tail.then(async () => {
+                operation.check();
+                const result = await work();
+                operation.check();
+                return result;
+            });
+            tail = writing.then(() => { }, () => { });
+            return await writing;
+        },
+        drain: async () => { await tail; },
+        onInvalidate: listener => { listeners.add(listener); return () => { listeners.delete(listener); }; },
+        close: async () => { identity = opts.scopeKey?.() ?? ''; await invalidate(); },
+    };
+};
+//# sourceMappingURL=lifecycle.js.map

package/build/lifecycle.js.map

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

package/build/resource-feed.d.ts

@@ -0,0 +1,5 @@
+import type { BasicConfig, BasicContext } from '@owlmeans/context';
+import type { PlanningFeed, PlanningResourceFeedOptions } from './types.js';
+/** Refresh separate resources into the stock stores; a stopped/changed-tenant feed cannot publish. */
+export declare const makePlanningResourceFeed: <C extends BasicConfig, T extends BasicContext<C>>(context: T, opts?: PlanningResourceFeedOptions) => PlanningFeed;
+//# sourceMappingURL=resource-feed.d.ts.map

package/build/resource-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-feed.d.ts","sourceRoot":"","sources":["../src/resource-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIlE,OAAO,KAAK,EAAyB,YAAY,EAAqB,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAErH,sGAAsG;AACtG,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC9E,CAAC,SAAQ,2BAA2B,KAC5C,YAqEF,CAAA"}

package/build/resource-feed.js

@@ -0,0 +1,97 @@
+import { mentionHelper, PLANNING_SERVICE } from '@owlmeans/planning';
+import { planningContextOf } from './helper.js';
+/** Refresh separate resources into the stock stores; a stopped/changed-tenant feed cannot publish. */
+export const makePlanningResourceFeed = (context, opts = {}) => {
+    const stores = planningContextOf(context).stores();
+    if (stores == null)
+        throw new SyntaxError('Planning feed needs appendPlanningStores(context)');
+    const service = context.service(PLANNING_SERVICE);
+    const { lifecycle } = service;
+    const operation = lifecycle.capture();
+    const active = () => !stopped && operation.active();
+    const facade = service.for(opts.scope);
+    const state = { connected: false, seeded: false, error: null };
+    let stopped = false;
+    let pending;
+    let timer;
+    const refresh = async () => {
+        if (!active())
+            return;
+        if (pending != null)
+            return await pending;
+        pending = (async () => {
+            try {
+                for (const name of ['assignees', 'teams', 'comments', 'mentions']) {
+                    const query = opts[name];
+                    if (query == null)
+                        continue;
+                    const store = stores[name];
+                    const { page: _page, size: _size, sort: _sort, ids, nickname, authentication, ...where } = query;
+                    const matches = { ...where, ...(ids != null ? { id: { $in: ids } } : {}),
+                        ...(name === 'assignees' && where.retired === false ? { retired: { $ne: true } } : {}),
+                        ...(nickname != null ? { nicknameKey: mentionHelper.nicknameKey(nickname) } : {}),
+                        ...(authentication != null ? { 'authentication.provider': authentication.provider, 'authentication.externalId': authentication.externalId } : {}),
+                        ...(opts.scope?.entityId != null ? { entityId: opts.scope.entityId } : {}) };
+                    // Capture prior versions before the request: a local mutation/new row arriving while
+                    // the seed is in flight must survive an older snapshot's absence.
+                    const snapshot = (await operation.wait(store.list(matches, { size: 0 }))).items;
+                    operation.check();
+                    const rows = await operation.wait(facade[name].list(query));
+                    if (!active())
+                        return;
+                    const named = new Set(rows.items.map(row => row.id));
+                    await lifecycle.mutate(operation, async () => {
+                        if (!(query.size != null && query.size > 0)) {
+                            for (const row of snapshot)
+                                if (!named.has(row.id)) {
+                                    const current = await store.load(row.id);
+                                    if (current?.version === row.version)
+                                        await store.delete(row.id);
+                                }
+                        }
+                        for (const row of rows.items) {
+                            const previous = await store.load(row.id);
+                            if (previous == null || previous.version <= row.version)
+                                await store.save(row);
+                        }
+                    });
+                }
+                if (active())
+                    Object.assign(state, { seeded: true, error: null });
+            }
+            catch (error) {
+                if (active())
+                    state.error = error;
+            }
+            if (active())
+                opts.onChange?.({ ...state });
+        })();
+        try {
+            await pending;
+        }
+        finally {
+            pending = undefined;
+        }
+    };
+    const ready = refresh().then(() => {
+        if (active() && (opts.refresh ?? 5000) > 0)
+            timer = setInterval(() => { void refresh(); }, opts.refresh ?? 5000);
+    });
+    let unregister;
+    const feed = {
+        get connected() { return state.connected; }, get seeded() { return state.seeded; }, get error() { return state.error; },
+        ready, refresh,
+        stop: async () => {
+            stopped = true;
+            operation.cancel();
+            unregister?.();
+            if (timer != null)
+                clearInterval(timer);
+            await lifecycle.drain();
+            operation.release();
+        },
+    };
+    unregister = service.registerFeed(feed);
+    return feed;
+};
+//# sourceMappingURL=resource-feed.js.map

package/build/resource-feed.js.map

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

package/build/resources.d.ts

@@ -0,0 +1,6 @@
+import type { BasicContext, BasicConfig } from '@owlmeans/context';
+import type { PlanningProtocols, PlanningResourceFacade } from '@owlmeans/planning';
+import type { RemoteFacadeOptions } from './types.js';
+/** The same auxiliary facade in browsers and Node clients, with versioned stock state mirrors. */
+export declare const makeRemoteResourceFacade: <C extends BasicConfig, T extends BasicContext<C>>(context: T, protocols: PlanningProtocols, opts: RemoteFacadeOptions) => PlanningResourceFacade;
+//# sourceMappingURL=resources.d.ts.map

package/build/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,KAAK,EAAsE,iBAAiB,EAA2B,sBAAsB,EAAyC,MAAM,oBAAoB,CAAA;AACvN,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAIrD,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC9E,CAAC,aAAa,iBAAiB,QAAQ,mBAAmB,KAClE,sBAyEF,CAAA"}

package/build/resources.js

@@ -0,0 +1,93 @@
+import { planningReplyHelper, PlanningUnsupported, WorkcardNotFound } from '@owlmeans/planning';
+import { makePlanningClientLifecycle } from './lifecycle.js';
+/** The same auxiliary facade in browsers and Node clients, with versioned stock state mirrors. */
+export const makeRemoteResourceFacade = (context, protocols, opts) => {
+    const lifecycle = opts.lifecycle ?? makePlanningClientLifecycle({ scopeKey: opts.scopeKey });
+    const tree = (name) => {
+        const value = protocols[name];
+        if (value == null)
+            throw new PlanningUnsupported(`client:${name}`);
+        return value;
+    };
+    const mirror = async (name, row) => {
+        const store = opts.stores?.()?.[name];
+        if (store == null || row.id == null)
+            return;
+        const known = await store.load(row.id);
+        if (known == null || known.version <= row.version)
+            await store.save(row);
+    };
+    const get = async (name, id) => lifecycle.run(async (operation) => {
+        const row = planningReplyHelper.hydrate(await operation.wait(context.entrypoint(tree(name).get).call({ params: { id }, timeout: opts.timeout, signal: operation.signal })));
+        await lifecycle.mutate(operation, async () => await mirror(name, row));
+        return row;
+    });
+    const load = async (name, id) => {
+        try {
+            return await get(name, id);
+        }
+        catch (error) {
+            if (error instanceof WorkcardNotFound)
+                return null;
+            throw error;
+        }
+    };
+    const list = async (name, query) => lifecycle.run(async (operation) => {
+        const rows = planningReplyHelper.hydrate(await operation.wait(context.entrypoint(tree(name).list).call({ query: { query: JSON.stringify(query ?? {}) }, timeout: opts.timeout, signal: operation.signal })));
+        return rows;
+    });
+    const write = async (name, body) => lifecycle.run(async (operation) => {
+        const answer = planningReplyHelper.hydrate(await operation.wait(context.entrypoint(tree(name).write).call({ body, timeout: opts.timeout, signal: operation.signal })));
+        await lifecycle.mutate(operation, async () => {
+            if (answer != null && !Array.isArray(answer))
+                await mirror(name, answer);
+            if (name === 'mentions' && Array.isArray(answer))
+                for (const row of answer)
+                    if (typeof row !== 'string')
+                        await mirror(name, row);
+            if (body.action === 'remove' && body.id != null)
+                await opts.stores?.()?.[name].delete(body.id);
+        });
+        return answer;
+    });
+    return {
+        assignees: {
+            get: async (id) => await get('assignees', id),
+            load: async (id) => await load('assignees', id),
+            list: async (query) => await list('assignees', query),
+            create: async (draft) => await write('assignees', { action: 'create', draft }),
+            update: async (id, draft, options) => await write('assignees', { action: 'update', id, draft, ...options }),
+            retire: async (id, options) => await write('assignees', { action: 'retire', id, ...options }),
+        },
+        teams: {
+            get: async (id) => await get('teams', id),
+            load: async (id) => await load('teams', id),
+            list: async (query) => await list('teams', query),
+            create: async (draft) => await write('teams', { action: 'create', draft }),
+            update: async (id, draft, options) => await write('teams', { action: 'update', id, draft, ...options }),
+            remove: async (id, options) => { await write('teams', { action: 'remove', id, ...options }); },
+            members: async (id) => await write('teams', { action: 'members', id }),
+            projects: async (id) => await write('teams', { action: 'projects', id }),
+            assignees: async (id) => await write('teams', { action: 'assignees', id }),
+            addMember: async (id, assignee) => { await write('teams', { action: 'addMember', id, assignee }); },
+            removeMember: async (id, assignee) => { await write('teams', { action: 'removeMember', id, assignee }); },
+            attach: async (id, project) => { await write('teams', { action: 'attach', id, project }); },
+            detach: async (id, project) => { await write('teams', { action: 'detach', id, project }); },
+        },
+        comments: {
+            get: async (id) => await get('comments', id),
+            load: async (id) => await load('comments', id),
+            list: async (query) => await list('comments', query),
+            create: async (draft) => await write('comments', { action: 'create', draft }),
+            update: async (id, draft, options) => await write('comments', { action: 'update', id, draft, ...options }),
+            remove: async (id, options) => { await write('comments', { action: 'remove', id, ...options }); },
+        },
+        mentions: {
+            get: async (id) => await get('mentions', id),
+            load: async (id) => await load('mentions', id),
+            list: async (query) => await list('mentions', query),
+            rebuild: async (id) => await write('mentions', { action: 'rebuild', id }),
+        },
+    };
+};
+//# sourceMappingURL=resources.js.map

package/build/resources.js.map

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

package/build/stores.d.ts

@@ -1,7 +1,7 @@
 import type { BasicConfig, BasicContext } from '@owlmeans/context';
 import type { Relationship, Workcard } from '@owlmeans/planning';
 import type { Criteria } from '@owlmeans/resource';
-import type { StateResourceAppend } from '@owlmeans/state';
+import { type StateResourceAppend } from '@owlmeans/state';
 import type { PlanningStoreAliases, PlanningStores, SyncOptions, WithPlanningStores } from './types.js';
 /**
  * Register the planning state mirror: ONE card store for every kind, a link store and a commit
@@ -12,17 +12,10 @@ import type { PlanningStoreAliases, PlanningStores, SyncOptions, WithPlanningSto
  * homes the moment its kind is read wrong. Idempotent, like every `append*`.
  */
 export declare const appendPlanningStores: <C extends BasicConfig, T extends BasicContext<C>>(context: T, aliases?: Partial<PlanningStoreAliases>) => T & WithPlanningStores & StateResourceAppend;
-/** The stores `appendPlanningStores` registered, or `null` on a context that has none. */
+/** @deprecated compat:factory-refactor — use `planningContextOf(context).stores()` */
 export declare const planningStoresOf: (context: BasicContext<any>) => PlanningStores | null;
-/**
- * Make the store agree with an authoritative list WITHIN a scope: every card given is written
- * (unless the store holds a newer fold of it), and every card matching `where` that the list does
- * not name is dropped. Cards outside `where` are left alone — which is why this, and never
- * `replace()`, is how a list reaches the one shared card store.
- *
- * Unchanged cards are not rewritten, so a periodic re-seed wakes no subscriber.
- */
+/** @deprecated compat:factory-refactor — use `syncHelper.syncCards(…)` */
 export declare const syncCards: (store: PlanningStores['cards'], items: Workcard[], where?: Criteria<Workcard>, opts?: SyncOptions) => Promise<void>;
-/** {@link syncCards} for the link store. */
+/** @deprecated compat:factory-refactor — use `syncHelper.syncLinks(…)` */
 export declare const syncLinks: (store: PlanningStores['links'], items: Relationship[], where?: Criteria<Relationship>, opts?: SyncOptions) => Promise<void>;
 //# sourceMappingURL=stores.d.ts.map

package/build/stores.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGvG;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC1E,CAAC,YAAY,OAAO,CAAC,oBAAoB,CAAC,KAClD,CAAC,GAAG,kBAAkB,GAAG,mBAgB3B,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,YAAa,YAAY,CAAC,GAAG,CAAC,KAAG,cAAc,GAAG,IAI9E,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,UACb,cAAc,CAAC,OAAO,CAAC,SAAS,QAAQ,EAAE,UAAU,QAAQ,CAAC,QAAQ,CAAC,SAAS,WAAW,KAChG,OAAO,CAAC,IAAI,CAKd,CAAA;AAED,4CAA4C;AAC5C,eAAO,MAAM,SAAS,UACb,cAAc,CAAC,OAAO,CAAC,SAAS,YAAY,EAAE,UAAU,QAAQ,CAAC,YAAY,CAAC,SAAS,WAAW,KACxG,OAAO,CAAC,IAAI,CAKd,CAAA"}
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAI/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEvG;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC1E,CAAC,YAAY,OAAO,CAAC,oBAAoB,CAAC,KAClD,CAAC,GAAG,kBAAkB,GAAG,mBAkB3B,CAAA;AAGD,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,YAAa,YAAY,CAAC,GAAG,CAAC,KAAG,cAAc,GAAG,IAA2C,CAAA;AAE1H,0EAA0E;AAC1E,eAAO,MAAM,SAAS,UACb,cAAc,CAAC,OAAO,CAAC,SAAS,QAAQ,EAAE,UAAU,QAAQ,CAAC,QAAQ,CAAC,SAAS,WAAW,KAChG,OAAO,CAAC,IAAI,CAA0D,CAAA;AAEzE,0EAA0E;AAC1E,eAAO,MAAM,SAAS,UACb,cAAc,CAAC,OAAO,CAAC,SAAS,YAAY,EAAE,UAAU,QAAQ,CAAC,YAAY,CAAC,SAAS,WAAW,KACxG,OAAO,CAAC,IAAI,CAA0D,CAAA"}

package/build/stores.js

@@ -1,6 +1,7 @@
 import { appendStateResource } from '@owlmeans/state';
 import { DEFAULT_STORE_ALIASES } from './consts.js';
-import { idsOf, putCard, putLink } from './utils/record.js';
+import { planningContextOf } from './helper.js';
+import { syncHelper } from './sync.js';
 /**
  * Register the planning state mirror: ONE card store for every kind, a link store and a commit
  * store, and `context.planningStores()`.
@@ -14,48 +15,23 @@ export const appendPlanningStores = (context, aliases) => {
     let ctx = appendStateResource(context, names.cards);
     ctx = appendStateResource(ctx, names.links);
     ctx = appendStateResource(ctx, names.commits);
+    for (const name of [names.assignees, names.teams, names.comments, names.mentions])
+        ctx = appendStateResource(ctx, name);
     const result = ctx;
     if (result.planningStores == null) {
         result.planningStores = () => ({
             cards: result.getStateResource(names.cards),
+            assignees: result.getStateResource(names.assignees), teams: result.getStateResource(names.teams), comments: result.getStateResource(names.comments), mentions: result.getStateResource(names.mentions),
             links: result.getStateResource(names.links),
             commits: result.getStateResource(names.commits),
         });
     }
     return result;
 };
-/** The stores `appendPlanningStores` registered, or `null` on a context that has none. */
-export const planningStoresOf = (context) => {
-    const ctx = context;
-    return typeof ctx.planningStores === 'function' ? ctx.planningStores() : null;
-};
-/**
- * Make the store agree with an authoritative list WITHIN a scope: every card given is written
- * (unless the store holds a newer fold of it), and every card matching `where` that the list does
- * not name is dropped. Cards outside `where` are left alone — which is why this, and never
- * `replace()`, is how a list reaches the one shared card store.
- *
- * Unchanged cards are not rewritten, so a periodic re-seed wakes no subscriber.
- */
-export const syncCards = async (store, items, where, opts) => {
-    await dropUnnamed(store, idsOf(items), where, opts);
-    for (const item of items) {
-        await putCard(store, item);
-    }
-};
-/** {@link syncCards} for the link store. */
-export const syncLinks = async (store, items, where, opts) => {
-    await dropUnnamed(store, idsOf(items), where, opts);
-    for (const item of items) {
-        await putLink(store, item);
-    }
-};
-const dropUnnamed = async (store, named, where, opts) => {
-    const keep = new Set([...named, ...(opts?.keep ?? [])]);
-    const scoped = await store.list(where);
-    const stale = idsOf(scoped.items).filter(id => !keep.has(id));
-    if (stale.length > 0) {
-        await store.purge({ id: { $in: stale } });
-    }
-};
+/** @deprecated compat:factory-refactor — use `planningContextOf(context).stores()` */
+export const planningStoresOf = (context) => planningContextOf(context).stores();
+/** @deprecated compat:factory-refactor — use `syncHelper.syncCards(…)` */
+export const syncCards = async (store, items, where, opts) => await syncHelper.syncCards(store, items, where, opts);
+/** @deprecated compat:factory-refactor — use `syncHelper.syncLinks(…)` */
+export const syncLinks = async (store, items, where, opts) => await syncHelper.syncLinks(store, items, where, opts);
 //# sourceMappingURL=stores.js.map

package/build/stores.js.map

@@ -1 +1 @@
-{"version":3,"file":"stores.js","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAA4B,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAGtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAAU,EAAE,OAAuC,EACL,EAAE;IAChD,MAAM,KAAK,GAAyB,EAAE,GAAG,qBAAqB,EAAE,GAAG,OAAO,EAAE,CAAA;IAC5E,IAAI,GAAG,GAAG,mBAAmB,CAAiB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACnE,GAAG,GAAG,mBAAmB,CAA8B,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACxE,GAAG,GAAG,mBAAmB,CAAgB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAE5D,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC;QAAE,GAAG,GAAG,mBAAmB,CAAC,GAAG,EAAE,IAAW,CAAC,CAAA;IAC9H,MAAM,MAAM,GAAG,GAAmD,CAAA;IAClE,IAAI,MAAM,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;QAClC,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC,CAAC;YAC7B,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC;YAC3C,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;YACtM,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC;YAC3C,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC;SAChD,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAGD,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAA0B,EAAyB,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAA;AAE1H,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,KAA8B,EAAE,KAAiB,EAAE,KAA0B,EAAE,IAAkB,EAClF,EAAE,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;AAEzE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,KAA8B,EAAE,KAAqB,EAAE,KAA8B,EAAE,IAAkB,EAC1F,EAAE,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA"}

package/build/sync/types.d.ts

@@ -0,0 +1,18 @@
+import type { Relationship, Workcard } from '@owlmeans/planning';
+import type { Criteria } from '@owlmeans/resource';
+import type { PlanningStores, SyncOptions } from '../types.js';
+/** An authoritative list made true in one mirror store — within a scope, never beyond it. */
+export interface SyncHelper {
+    /**
+     * Make the store agree with an authoritative list WITHIN a scope: every card given is written
+     * (unless the store holds a newer fold of it), and every card matching `where` that the list does
+     * not name is dropped. Cards outside `where` are left alone — which is why this, and never
+     * `replace()`, is how a list reaches the one shared card store.
+     *
+     * Unchanged cards are not rewritten, so a periodic re-seed wakes no subscriber.
+     */
+    syncCards: (store: PlanningStores['cards'], items: Workcard[], where?: Criteria<Workcard>, opts?: SyncOptions) => Promise<void>;
+    /** {@link SyncHelper.syncCards} for the link store. */
+    syncLinks: (store: PlanningStores['links'], items: Relationship[], where?: Criteria<Relationship>, opts?: SyncOptions) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/sync/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9D,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACzB;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/H,uDAAuD;IACvD,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACxI"}

package/build/sync/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/sync/types.js.map

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

package/build/sync.d.ts

@@ -0,0 +1,4 @@
+import type { SyncHelper } from './sync/types.js';
+export declare const createSyncHelper: () => SyncHelper;
+export declare const syncHelper: SyncHelper;
+//# sourceMappingURL=sync.d.ts.map

package/build/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAIjD,eAAO,MAAM,gBAAgB,QAAO,UA+BnC,CAAA;AAED,eAAO,MAAM,UAAU,YAAqB,CAAA"}