@fieldia/core 0.28.0 → 0.30.0

package/src/lib/record/memory-approvals.d.ts

@@ -0,0 +1,47 @@
+import type { ApprovalEntry, Approvals, ApprovalsRequest, DecideRequest, RecordVersion } from './data-source';
+import { type RecordId, type Values } from './values';
+/**
+ * The way a record is approved, as a memory source's `approvals` option works it out from the record: its levels in
+ * order — or all at once (`together`) — each with who may approve it there and whether any one of them or all must;
+ * whether it is sent for approval now (`asked`: a draft is not); why, in words; and what the record holds once every
+ * level approved it, or once one rejected it (its state moved on).
+ */
+export interface MemoryApprovalRoute {
+    levels: {
+        id: string;
+        name: string;
+        approvers: {
+            id?: RecordId;
+            name: string;
+        }[];
+        needs?: 'any' | 'all';
+    }[];
+    together?: boolean;
+    /** Sent for approval now: its levels are asked. Until then they wait for it, and the record "needs approval". */
+    asked: boolean;
+    why?: string;
+    /** Values the record takes once every level approved it: `{ state: 'purchase' }`. */
+    approved?: Values;
+    /** Values it takes once a level rejected it: `{ state: 'rejected' }`. */
+    rejected?: Values;
+}
+/** What the memory source's approvals work on: its options, its records, and a record's version moved on. */
+export interface MemoryApprovalsUse {
+    routes: Record<string, (values: Values, id: RecordId) => MemoryApprovalRoute | null | undefined> | undefined;
+    history: Record<string, ApprovalEntry[]> | undefined;
+    table(model: string): Record<string, Values>;
+    moved(model: string, id: RecordId, by: string): RecordVersion | undefined;
+    now(): string;
+}
+/**
+ * A memory source's approvals, as an approval engine keeps them: each decision kept, oldest first — a round of asking
+ * starting each time the record is sent for approval again (`requested`) — and where each level stands worked out from
+ * the route and the round: in turn unless the route says together; met by one approver, or by every one where it needs
+ * all; a rejection ending the round. A decision is refused where the level is not waiting, the person is none of its
+ * approvers or decided already, or a rejection says no reason; the last approval writes the route's `approved` values on
+ * the record, a rejection its `rejected` ones.
+ */
+export declare function memoryApprovals(use: MemoryApprovalsUse): {
+    approvals(request: ApprovalsRequest): Approvals;
+    decide(request: DecideRequest): Approvals;
+};

package/src/lib/record/memory-approvals.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryApprovals = memoryApprovals;
+const data_source_1 = require("./data-source");
+const values_1 = require("./values");
+/** The same person: by their ids where both have one, else by their names. */
+const same = (approver, person) => !!person && (approver.id !== undefined && person.id !== null && person.id !== undefined ? String(approver.id) === String(person.id) : !!person.name && approver.name === person.name);
+/**
+ * A memory source's approvals, as an approval engine keeps them: each decision kept, oldest first — a round of asking
+ * starting each time the record is sent for approval again (`requested`) — and where each level stands worked out from
+ * the route and the round: in turn unless the route says together; met by one approver, or by every one where it needs
+ * all; a rejection ending the round. A decision is refused where the level is not waiting, the person is none of its
+ * approvers or decided already, or a rejection says no reason; the last approval writes the route's `approved` values on
+ * the record, a rejection its `rejected` ones.
+ */
+function memoryApprovals(use) {
+    const histories = (0, values_1.structuredCopy)(use.history ?? {});
+    /** Whether each record was sent for approval when last asked: sent again since, a round starts. */
+    const sent = new Map();
+    function routed(model, id, person) {
+        const values = use.table(model)[String(id)];
+        if (!values)
+            throw new Error(`No ${model} record with id ${id}`);
+        const route = use.routes?.[model]?.((0, values_1.structuredCopy)(values), id) ?? null;
+        const key = `${model}:${id}`;
+        const history = (histories[key] ??= []);
+        if (!route?.levels.length)
+            return { levels: [], history: (0, values_1.structuredCopy)(history) };
+        if (route.asked && sent.get(key) === false)
+            history.push({ decision: 'requested', by: person?.name || 'Someone', at: use.now() });
+        sent.set(key, route.asked);
+        const round = history.slice(history.map((entry) => entry.decision).lastIndexOf('requested') + 1);
+        const ended = round.some((entry) => entry.decision === 'rejected');
+        let before = true;
+        const levels = route.levels.map((level) => {
+            const approvers = level.approvers.map((approver) => {
+                const said = round.find((entry) => entry.level === level.id && entry.by === approver.name && entry.decision !== 'requested');
+                return { ...approver, ...(said ? { decision: said.decision, at: said.at } : {}) };
+            });
+            const needs = level.needs ?? 'any';
+            const approved = needs === 'all' ? approvers.every((one) => one.decision === 'approved') : approvers.some((one) => one.decision === 'approved');
+            const state = approvers.some((one) => one.decision === 'rejected') ? 'rejected' : approved ? 'approved' : route.asked && !ended && (route.together || before) ? 'waiting' : 'later';
+            if (state !== 'approved')
+                before = false;
+            return { id: level.id, name: level.name, approvers, needs, state };
+        });
+        const mine = levels.filter((level) => level.state === 'waiting' && level.approvers.some((one) => !one.decision && same(one, person))).map((level) => level.id);
+        return { levels, ...(route.together ? { together: true } : {}), history: (0, values_1.structuredCopy)(history), mine, ...(route.why ? { why: route.why } : {}) };
+    }
+    return {
+        approvals: (request) => routed(request.model, request.recordId, request.user),
+        decide(request) {
+            const { model, recordId } = request;
+            const now = routed(model, recordId, request.user);
+            const level = now.levels.find((one) => one.id === request.level);
+            if (!level || level.state !== 'waiting')
+                throw (0, data_source_1.saveRefused)({ kind: 'rule', message: `${level?.name ?? request.level} is not waiting for a decision` });
+            const approver = level.approvers.find((one) => same(one, request.user));
+            if (!approver || approver.decision)
+                throw (0, data_source_1.saveRefused)({ kind: 'rule', message: `${request.user?.name || 'This person'} may not decide for ${level.name} now` });
+            const reason = request.reason?.trim();
+            if (request.decision === 'rejected' && !reason)
+                throw (0, data_source_1.saveRefused)({ kind: 'rule', message: 'A rejection says why' });
+            (histories[`${model}:${recordId}`] ??= []).push({ decision: request.decision, level: level.id, by: approver.name, at: use.now(), ...(reason ? { reason } : {}) });
+            const after = routed(model, recordId, request.user);
+            const asked = after.levels.filter((one) => one.state !== 'skipped');
+            const route = use.routes?.[model]?.((0, values_1.structuredCopy)(use.table(model)[String(recordId)]), recordId);
+            // The last approval moves the record on, as a rejection does: its state, as the route says.
+            const ending = asked.some((one) => one.state === 'rejected') ? route?.rejected : asked.length && asked.every((one) => one.state === 'approved') ? route?.approved : undefined;
+            if (!ending)
+                return after;
+            Object.assign(use.table(model)[String(recordId)], (0, values_1.structuredCopy)(ending));
+            use.moved(model, recordId, approver.name);
+            return routed(model, recordId, request.user);
+        },
+    };
+}
+//# sourceMappingURL=memory-approvals.js.map

package/src/lib/record/memory-approvals.js.map

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

package/src/lib/record/memory-approvals.mjs

@@ -0,0 +1,75 @@
+import { saveRefused } from './data-source.mjs';
+import { structuredCopy } from './values.mjs';
+/** The same person: by their ids where both have one, else by their names. */
+const same = (approver, person) => !!person && (approver.id !== undefined && person.id !== null && person.id !== undefined ? String(approver.id) === String(person.id) : !!person.name && approver.name === person.name);
+/**
+ * A memory source's approvals, as an approval engine keeps them: each decision kept, oldest first — a round of asking
+ * starting each time the record is sent for approval again (`requested`) — and where each level stands worked out from
+ * the route and the round: in turn unless the route says together; met by one approver, or by every one where it needs
+ * all; a rejection ending the round. A decision is refused where the level is not waiting, the person is none of its
+ * approvers or decided already, or a rejection says no reason; the last approval writes the route's `approved` values on
+ * the record, a rejection its `rejected` ones.
+ */
+export function memoryApprovals(use) {
+    const histories = structuredCopy(use.history ?? {});
+    /** Whether each record was sent for approval when last asked: sent again since, a round starts. */
+    const sent = new Map();
+    function routed(model, id, person) {
+        const values = use.table(model)[String(id)];
+        if (!values)
+            throw new Error(`No ${model} record with id ${id}`);
+        const route = use.routes?.[model]?.(structuredCopy(values), id) ?? null;
+        const key = `${model}:${id}`;
+        const history = (histories[key] ??= []);
+        if (!route?.levels.length)
+            return { levels: [], history: structuredCopy(history) };
+        if (route.asked && sent.get(key) === false)
+            history.push({ decision: 'requested', by: person?.name || 'Someone', at: use.now() });
+        sent.set(key, route.asked);
+        const round = history.slice(history.map((entry) => entry.decision).lastIndexOf('requested') + 1);
+        const ended = round.some((entry) => entry.decision === 'rejected');
+        let before = true;
+        const levels = route.levels.map((level) => {
+            const approvers = level.approvers.map((approver) => {
+                const said = round.find((entry) => entry.level === level.id && entry.by === approver.name && entry.decision !== 'requested');
+                return { ...approver, ...(said ? { decision: said.decision, at: said.at } : {}) };
+            });
+            const needs = level.needs ?? 'any';
+            const approved = needs === 'all' ? approvers.every((one) => one.decision === 'approved') : approvers.some((one) => one.decision === 'approved');
+            const state = approvers.some((one) => one.decision === 'rejected') ? 'rejected' : approved ? 'approved' : route.asked && !ended && (route.together || before) ? 'waiting' : 'later';
+            if (state !== 'approved')
+                before = false;
+            return { id: level.id, name: level.name, approvers, needs, state };
+        });
+        const mine = levels.filter((level) => level.state === 'waiting' && level.approvers.some((one) => !one.decision && same(one, person))).map((level) => level.id);
+        return { levels, ...(route.together ? { together: true } : {}), history: structuredCopy(history), mine, ...(route.why ? { why: route.why } : {}) };
+    }
+    return {
+        approvals: (request) => routed(request.model, request.recordId, request.user),
+        decide(request) {
+            const { model, recordId } = request;
+            const now = routed(model, recordId, request.user);
+            const level = now.levels.find((one) => one.id === request.level);
+            if (!level || level.state !== 'waiting')
+                throw saveRefused({ kind: 'rule', message: `${level?.name ?? request.level} is not waiting for a decision` });
+            const approver = level.approvers.find((one) => same(one, request.user));
+            if (!approver || approver.decision)
+                throw saveRefused({ kind: 'rule', message: `${request.user?.name || 'This person'} may not decide for ${level.name} now` });
+            const reason = request.reason?.trim();
+            if (request.decision === 'rejected' && !reason)
+                throw saveRefused({ kind: 'rule', message: 'A rejection says why' });
+            (histories[`${model}:${recordId}`] ??= []).push({ decision: request.decision, level: level.id, by: approver.name, at: use.now(), ...(reason ? { reason } : {}) });
+            const after = routed(model, recordId, request.user);
+            const asked = after.levels.filter((one) => one.state !== 'skipped');
+            const route = use.routes?.[model]?.(structuredCopy(use.table(model)[String(recordId)]), recordId);
+            // The last approval moves the record on, as a rejection does: its state, as the route says.
+            const ending = asked.some((one) => one.state === 'rejected') ? route?.rejected : asked.length && asked.every((one) => one.state === 'approved') ? route?.approved : undefined;
+            if (!ending)
+                return after;
+            Object.assign(use.table(model)[String(recordId)], structuredCopy(ending));
+            use.moved(model, recordId, approver.name);
+            return routed(model, recordId, request.user);
+        },
+    };
+}
+//# sourceMappingURL=memory-approvals.mjs.map

package/src/lib/record/memory-approvals.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-approvals.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/memory-approvals.ts"],"names":[],"mappings":"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"}

package/src/lib/record/memory-assist.d.mts

@@ -0,0 +1,53 @@
+import type { RewriteRequest } from './data-source.mjs';
+import type { MemoryAssist } from './memory-data-source.mjs';
+import type { Values } from './values.mjs';
+/**
+ * A stand-in for an app's AI, for demos and tests: no model, no keys, nothing sent anywhere — words read by their
+ * patterns, the same every time. `createMemoryDataSource({ assist: assistStandIn() })` answers AI help with it:
+ *
+ * - **suggest**: an e-mail signature or a message read line by line — a person's name (two to four words with
+ *   capitals), a job title and a company (by the words they hold: "Director", "Ltd", "Traders"), e-mails, phones (a
+ *   mobile by its "M:" or "Mobile"), a website, a street, a city and a country (the country among the records a link
+ *   can point to), a tax id — each given to the field whose name or label says it holds one; a choice by an option's
+ *   words in the text, a number by the words of its label beside it ("3 bedrooms"); a table's lines as the person
+ *   found (a name with an e-mail, a phone or a job), or as lines of "2 x Dental chair @ 4,500". Text files are read;
+ *   any other file is said not to be.
+ * - **rewrite**: a draft from a template of the app's (`drafts`, by `model.field`), else a short reply that greets the
+ *   person the record names; polish puts capitals and full stops in, writes out "u", "pls", "asap" and the like, and
+ *   tidies the spaces.
+ * - **searchToFilter**: "villas in New Cairo under 15M" — a choice's options and a link's records by their names
+ *   (singular or plural, the longest first), a number by "under", "over", "between … and …", "3+" and the words of a
+ *   field's label or unit beside it ("3 bedrooms", "200 m²"), else the first amount; "15M", "2.5 million", "800k".
+ *
+ * Every answer says so in its `why`: "Stand-in AI, no model: …". An app answers with its own model instead.
+ */
+export interface StandInOptions {
+    /** A draft's words, by the text field's `model.field` (or `pageId.field`), from the record: a template of the app's. */
+    drafts?: Record<string, (values: Values, request: RewriteRequest) => string>;
+}
+/** A number as people write it in a search or a message: "15M", "2.5 million", "800k", "15,000,000", "1.5". */
+export declare function standInNumber(digits: string, unit?: string): number | null;
+/** What a signature or a message holds, as a stand-in reads it. */
+export interface StandInFound {
+    person?: string;
+    title?: string;
+    company?: string;
+    emails: string[];
+    phones: string[];
+    mobile?: string;
+    website?: string;
+    street?: string;
+    city?: string;
+    /** The last part of an address: a country's name, looked for among the records later. */
+    place?: string;
+    tax?: string;
+}
+/** A signature or a message, read line by line by its patterns. */
+export declare function readSignature(text: string): StandInFound;
+/** Words made clearer, the same every time: what it did, in words. */
+export declare function polishText(text: string): {
+    text: string;
+    did: string[];
+};
+/** The stand-in's AI help, for a memory source's `assist`: see above. */
+export declare function assistStandIn(options?: StandInOptions): Required<MemoryAssist>;

package/src/lib/record/memory-assist.d.ts

@@ -0,0 +1,53 @@
+import type { RewriteRequest } from './data-source';
+import type { MemoryAssist } from './memory-data-source';
+import type { Values } from './values';
+/**
+ * A stand-in for an app's AI, for demos and tests: no model, no keys, nothing sent anywhere — words read by their
+ * patterns, the same every time. `createMemoryDataSource({ assist: assistStandIn() })` answers AI help with it:
+ *
+ * - **suggest**: an e-mail signature or a message read line by line — a person's name (two to four words with
+ *   capitals), a job title and a company (by the words they hold: "Director", "Ltd", "Traders"), e-mails, phones (a
+ *   mobile by its "M:" or "Mobile"), a website, a street, a city and a country (the country among the records a link
+ *   can point to), a tax id — each given to the field whose name or label says it holds one; a choice by an option's
+ *   words in the text, a number by the words of its label beside it ("3 bedrooms"); a table's lines as the person
+ *   found (a name with an e-mail, a phone or a job), or as lines of "2 x Dental chair @ 4,500". Text files are read;
+ *   any other file is said not to be.
+ * - **rewrite**: a draft from a template of the app's (`drafts`, by `model.field`), else a short reply that greets the
+ *   person the record names; polish puts capitals and full stops in, writes out "u", "pls", "asap" and the like, and
+ *   tidies the spaces.
+ * - **searchToFilter**: "villas in New Cairo under 15M" — a choice's options and a link's records by their names
+ *   (singular or plural, the longest first), a number by "under", "over", "between … and …", "3+" and the words of a
+ *   field's label or unit beside it ("3 bedrooms", "200 m²"), else the first amount; "15M", "2.5 million", "800k".
+ *
+ * Every answer says so in its `why`: "Stand-in AI, no model: …". An app answers with its own model instead.
+ */
+export interface StandInOptions {
+    /** A draft's words, by the text field's `model.field` (or `pageId.field`), from the record: a template of the app's. */
+    drafts?: Record<string, (values: Values, request: RewriteRequest) => string>;
+}
+/** A number as people write it in a search or a message: "15M", "2.5 million", "800k", "15,000,000", "1.5". */
+export declare function standInNumber(digits: string, unit?: string): number | null;
+/** What a signature or a message holds, as a stand-in reads it. */
+export interface StandInFound {
+    person?: string;
+    title?: string;
+    company?: string;
+    emails: string[];
+    phones: string[];
+    mobile?: string;
+    website?: string;
+    street?: string;
+    city?: string;
+    /** The last part of an address: a country's name, looked for among the records later. */
+    place?: string;
+    tax?: string;
+}
+/** A signature or a message, read line by line by its patterns. */
+export declare function readSignature(text: string): StandInFound;
+/** Words made clearer, the same every time: what it did, in words. */
+export declare function polishText(text: string): {
+    text: string;
+    did: string[];
+};
+/** The stand-in's AI help, for a memory source's `assist`: see above. */
+export declare function assistStandIn(options?: StandInOptions): Required<MemoryAssist>;