@agentshouse/mdmodel 0.1.0-alpha.9 → 0.1.0-c0d316445d94f

package/dist/condition.d.ts

@@ -0,0 +1,149 @@
+import { type ValueFacts } from './definition.js';
+import type { Document, VerifiedModel } from './types.js';
+export type ConditionValue = string | number | boolean | {
+    readonly owner: true;
+};
+export type ConditionTest = {
+    readonly all: readonly ConditionTest[];
+} | {
+    readonly any: readonly ConditionTest[];
+} | {
+    readonly not: ConditionTest;
+} | ({
+    readonly path: string;
+} & ({
+    readonly eq: ConditionValue;
+} | {
+    readonly in: readonly ConditionValue[];
+} | {
+    readonly exists: boolean;
+} | {
+    readonly contains: ConditionValue;
+} | {
+    readonly gt: number | string;
+} | {
+    readonly gte: number | string;
+} | {
+    readonly lt: number | string;
+} | {
+    readonly lte: number | string;
+} | {
+    readonly prefix: string;
+}));
+export type ConditionScope = {
+    readonly type: string;
+} | {
+    readonly folder: string;
+} | {
+    readonly document: string;
+};
+type DocumentEventBase = {
+    readonly on: 'documents';
+    readonly scope: ConditionScope;
+    readonly by?: ConditionTest;
+};
+export type DocumentCondition = (DocumentEventBase & {
+    readonly mode: 'starts_matching';
+    readonly new_documents: boolean;
+    readonly match: ConditionTest;
+}) | (DocumentEventBase & {
+    readonly mode: 'field_changes';
+    readonly field: string;
+    readonly from?: readonly ConditionValue[] | 'new';
+    readonly to?: readonly ConditionValue[] | 'deleted';
+    readonly match?: ConditionTest;
+});
+export type ItemCondition = {
+    readonly on: 'items';
+    readonly source?: string;
+    readonly address?: string;
+    readonly match?: ConditionTest;
+};
+export type CronCondition = {
+    readonly on: 'clock';
+    readonly cron: string;
+    readonly time_zone: string;
+};
+export type DateCondition = {
+    readonly on: 'clock';
+    readonly scope: {
+        readonly type: string;
+    };
+    readonly date: string;
+    readonly days: number;
+    readonly at: string;
+    readonly time_zone: string;
+    readonly match?: ConditionTest;
+};
+export type Condition = DocumentCondition | ItemCondition | CronCondition | DateCondition;
+export type FactKind = 'string' | 'number' | 'boolean' | 'date' | 'time' | 'enum' | 'reference';
+type Scalar = string | number | boolean;
+export type Fact = {
+    readonly kind: FactKind;
+    readonly value: Scalar;
+    readonly member?: string;
+} | {
+    readonly kind: 'prose';
+} | {
+    readonly kind: 'null';
+} | {
+    readonly kind: 'unreadable';
+} | {
+    readonly kind: 'list';
+    readonly items: readonly Fact[];
+} | {
+    readonly kind: 'object';
+    readonly fields: Readonly<Record<string, Fact>>;
+};
+export type DocumentFacts = {
+    readonly id: string;
+    readonly path: string;
+    readonly type: string | null;
+    readonly fields: Readonly<Record<string, Fact>>;
+    readonly sections: readonly string[];
+};
+export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client'];
+export type WriteDoor = (typeof WRITE_DOORS)[number];
+export type Actor = {
+    readonly user?: string;
+    readonly site?: string;
+    readonly door?: WriteDoor;
+};
+export type DocumentEvent = {
+    readonly before: DocumentFacts | null;
+    readonly after: DocumentFacts | null;
+    readonly changed: readonly string[];
+    readonly by: Actor;
+};
+export type ItemFacts = {
+    readonly delivery: string;
+    readonly source: string | null;
+    readonly address: string | null;
+    readonly has_attachment: boolean;
+    readonly provider: string | null;
+    readonly container: string | null;
+    readonly author: string | null;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly json: {
+        readonly value: unknown;
+    } | null;
+};
+export type Resolved = {
+    readonly id: string;
+    readonly member?: string;
+};
+type Truth = boolean | undefined;
+export declare function factKind(facts: ValueFacts): FactKind | null;
+export declare function facts(document: Document, at: {
+    readonly id: string;
+    readonly path: string;
+}, model: VerifiedModel, resolve: (target: string) => Resolved | undefined): DocumentFacts;
+export declare function prosePaths(facts: DocumentFacts): string[];
+export declare function dated(value: unknown): value is string;
+export declare function instant(value: unknown): bigint | undefined;
+export declare function pointed(value: unknown, pointer: string): unknown;
+export declare function holds(test: ConditionTest, document: DocumentFacts, owner: string): Truth;
+export declare function fires(condition: DocumentCondition, event: DocumentEvent, owner: string): boolean;
+export declare function itemFires(condition: ItemCondition, item: ItemFacts, owner: string): boolean;
+export {};
+//# sourceMappingURL=condition.d.ts.map

package/dist/condition.d.ts.map

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

package/dist/condition.js

@@ -0,0 +1,497 @@
+import { ARRAY_INDEX, escapePointer, fieldFacts, itemFacts, memberFacts, pointerSegments, } from './definition.js';
+import { target } from './paths.js';
+import { isRecord } from './yaml.js';
+export const WRITE_DOORS = ['browser', 'agent', 'client'];
+const PROSE = { kind: 'prose' };
+const NULL = { kind: 'null' };
+const UNREADABLE = { kind: 'unreadable' };
+const UNREAD = { present: undefined, values: [undefined], items: [undefined] };
+const NO_ITEM = { present: false, values: [], items: [] };
+const DATE = /^\d{4}-\d{2}-\d{2}$/u;
+const DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2}):(\d{2})(?:\.(\d+))?(?:[Zz]|([+-])(\d{2}):(\d{2}))$/u;
+export function factKind(facts) {
+    if (facts.reference !== undefined)
+        return 'reference';
+    if (facts.values !== undefined)
+        return 'enum';
+    if (facts.type === 'number' || facts.type === 'integer')
+        return 'number';
+    if (facts.type === 'boolean')
+        return 'boolean';
+    if (facts.type !== 'string')
+        return null;
+    if (facts.format === 'date')
+        return 'date';
+    if (facts.format === 'date-time')
+        return 'time';
+    return 'string';
+}
+function fits(kind, facts, value) {
+    if (!scalar(value))
+        return false;
+    if (kind === 'enum')
+        return (facts.values ?? []).includes(value);
+    if (kind === 'number')
+        return typeof value === 'number';
+    if (kind === 'boolean')
+        return typeof value === 'boolean';
+    if (typeof value !== 'string')
+        return false;
+    if (kind === 'date')
+        return dated(value);
+    if (kind === 'time')
+        return instant(value) !== undefined;
+    return true;
+}
+function factOf(value, declared, place) {
+    if (value === null)
+        return NULL;
+    if (Array.isArray(value)) {
+        if (declared?.type !== undefined && declared.type !== 'array')
+            return UNREADABLE;
+        return {
+            kind: 'list',
+            items: value.map((item, index) => factOf(item, declared === undefined ? undefined : itemFacts(declared, index), place)),
+        };
+    }
+    if (plain(value)) {
+        if (declared?.type !== undefined && declared.type !== 'object')
+            return UNREADABLE;
+        const fields = Object.create(null);
+        for (const [key, held] of Object.entries(value))
+            fields[key] = factOf(held, declared === undefined ? undefined : memberFacts(declared, key), place);
+        return { kind: 'object', fields };
+    }
+    if (declared?.type === 'array' || declared?.type === 'object')
+        return UNREADABLE;
+    const kind = declared === undefined || declared.prose ? null : factKind(declared);
+    if (kind === null)
+        return PROSE;
+    if (!fits(kind, declared, value))
+        return UNREADABLE;
+    if (kind !== 'reference')
+        return { kind, value };
+    const reached = target(place.path, value);
+    const resolved = reached === null ? undefined : place.resolve(reached);
+    if (resolved === undefined)
+        return UNREADABLE;
+    return resolved.member === undefined
+        ? { kind, value: resolved.id }
+        : { kind, value: resolved.id, member: resolved.member };
+}
+export function facts(document, at, model, resolve) {
+    const type = document.type ?? null;
+    const definition = type !== null && Object.hasOwn(model.types, type) ? model.types[type] : null;
+    const fields = Object.create(null);
+    const place = { path: at.path, resolve };
+    for (const [name, value] of Object.entries(document.fields)) {
+        const declared = definition === null ? undefined : fieldFacts(definition, name);
+        if (declared !== undefined)
+            fields[name] = factOf(value, declared, place);
+    }
+    return {
+        id: at.id,
+        path: `/${at.path}`,
+        type,
+        fields,
+        sections: Object.keys(document.sections).sort(),
+    };
+}
+function rootOf(facts, prefix) {
+    return { pointer: prefix, fact: { kind: 'object', fields: facts.fields } };
+}
+export function prosePaths(facts) {
+    const paths = facts.sections.map((heading) => `/sections/${heading}`);
+    const visit = ({ pointer, fact }) => {
+        if (fact.kind === 'prose')
+            paths.push(pointer);
+        if (fact.kind === 'list')
+            fact.items.forEach((item, index) => visit({ pointer: `${pointer}/${index}`, fact: item }));
+        if (fact.kind === 'object')
+            for (const [key, held] of Object.entries(fact.fields))
+                visit({ pointer: `${pointer}/${escapePointer(key)}`, fact: held });
+    };
+    visit(rootOf(facts, '/fields'));
+    return paths.sort();
+}
+function walked(start, pointer) {
+    let reached = [start];
+    let several = false;
+    let missing = false;
+    const each = (from, next) => from.flatMap((one) => {
+        const found = next(one);
+        if (found === null)
+            missing = true;
+        return found ?? [];
+    });
+    for (const token of pointerSegments(pointer)) {
+        const step = ({ pointer: at, fact }) => {
+            if (fact.kind === 'unreadable')
+                return [{ pointer: at, fact }];
+            if (fact.kind === 'object')
+                return Object.hasOwn(fact.fields, token)
+                    ? [{ pointer: `${at}/${escapePointer(token)}`, fact: fact.fields[token] }]
+                    : null;
+            if (fact.kind !== 'list')
+                return null;
+            if (ARRAY_INDEX.test(token)) {
+                const item = fact.items[Number(token)];
+                return item === undefined ? null : [{ pointer: `${at}/${token}`, fact: item }];
+            }
+            several = true;
+            return each(fact.items.map((item, index) => ({ pointer: `${at}/${index}`, fact: item })), step);
+        };
+        reached = each(reached, step);
+    }
+    return { reached, several, missing };
+}
+function expand(fact) {
+    return fact.kind === 'list' ? fact.items.flatMap(expand) : [fact];
+}
+function fieldHeld(fact) {
+    if (fact.kind === 'unreadable')
+        return undefined;
+    if (fact.kind === 'null')
+        return { kind: 'null' };
+    return 'value' in fact ? { kind: fact.kind, value: fact.value } : { kind: 'prose' };
+}
+function memberHeld(fact) {
+    if (fact.kind === 'unreadable')
+        return undefined;
+    return fact.kind === 'reference' && fact.member !== undefined
+        ? { kind: 'member', value: fact.member }
+        : null;
+}
+function single(held) {
+    return { present: true, values: [held], items: null };
+}
+function documentRead({ reached, several, missing }, held) {
+    if (reached.length === 0)
+        return missing ? undefined : NO_ITEM;
+    const facts = reached.map(({ fact }) => fact);
+    const kept = (all) => all.map(held).filter((value) => value !== null);
+    const unknown = missing ? [undefined] : [];
+    const values = kept(facts.filter((fact) => fact.kind !== 'list'));
+    const listed = several || facts.some((fact) => fact.kind === 'list');
+    const present = facts.some((fact) => fact.kind === 'list') || values.some(Boolean);
+    return {
+        present: present ? true : values.length > 0 ? undefined : false,
+        values: [...values, ...unknown],
+        items: listed ? [...kept(facts.flatMap(expand)), ...unknown] : null,
+    };
+}
+function readDocument(facts, path) {
+    if (path === '/path')
+        return single({ kind: 'path', value: facts.path });
+    if (path === '/type')
+        return facts.type === null ? undefined : single({ kind: 'string', value: facts.type });
+    if (path.startsWith('/sections/'))
+        return facts.sections.includes(path.slice('/sections/'.length))
+            ? single({ kind: 'prose' })
+            : undefined;
+    if (path.startsWith('/fields/'))
+        return documentRead(walked(rootOf(facts, '/fields'), path.slice('/fields'.length)), fieldHeld);
+    if (path.startsWith('/members/'))
+        return documentRead(walked(rootOf(facts, '/members'), path.slice('/members'.length)), memberHeld);
+    return undefined;
+}
+function readActor(actor, path) {
+    const value = path === '/user'
+        ? actor.user
+        : path === '/site'
+            ? actor.site
+            : path === '/door'
+                ? actor.door
+                : undefined;
+    return value === undefined ? undefined : single({ kind: 'actor', value });
+}
+function plain(value) {
+    if (!isRecord(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+export function dated(value) {
+    return (typeof value === 'string' && DATE.test(value) && instant(`${value}T00:00:00Z`) !== undefined);
+}
+export function instant(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const parts = DATE_TIME.exec(value);
+    if (parts === null)
+        return undefined;
+    const [year, month, day, hour, minute, second, offsetHours, offsetMinutes] = [
+        1, 2, 3, 4, 5, 6, 9, 10,
+    ].map((at) => Number(parts[at] ?? 0));
+    const at = new Date(0);
+    at.setUTCFullYear(year, month - 1, day);
+    at.setUTCHours(hour, minute, second);
+    if (at.getUTCFullYear() !== year ||
+        at.getUTCMonth() !== month - 1 ||
+        at.getUTCDate() !== day ||
+        at.getUTCHours() !== hour ||
+        at.getUTCMinutes() !== minute ||
+        offsetHours > 23 ||
+        offsetMinutes > 59)
+        return undefined;
+    const offset = (parts[8] === '-' ? -1 : 1) * (offsetHours * 60 + offsetMinutes);
+    const fraction = (parts[7] ?? '').padEnd(9, '0').slice(0, 9);
+    return (BigInt(at.getTime()) - BigInt(offset) * 60000n) * 1000000n + BigInt(fraction);
+}
+export function pointed(value, pointer) {
+    if (pointer === '')
+        return value;
+    let reached = value;
+    for (const part of pointer.slice(1).split('/')) {
+        const token = part.replaceAll('~1', '/').replaceAll('~0', '~');
+        if (Array.isArray(reached)) {
+            if (!ARRAY_INDEX.test(token))
+                return undefined;
+            reached = reached[Number(token)];
+        }
+        else if (plain(reached) && Object.hasOwn(reached, token)) {
+            reached = reached[token];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return reached;
+}
+function scalar(value) {
+    return (typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value)));
+}
+function jsonHeld(value) {
+    if (typeof value === 'string')
+        return {
+            kind: dated(value) ? 'date' : instant(value) === undefined ? 'string' : 'time',
+            value,
+        };
+    if (typeof value === 'boolean')
+        return { kind: 'boolean', value };
+    return { kind: 'number', value };
+}
+function jsonRead(value) {
+    if (value === undefined)
+        return undefined;
+    if (scalar(value))
+        return single(jsonHeld(value));
+    if (!Array.isArray(value))
+        return single({ kind: 'prose' });
+    return { present: true, values: [], items: value.filter(scalar).map(jsonHeld), loose: true };
+}
+function readItem(item, path) {
+    if (path.startsWith('/json/')) {
+        if (item.json === null)
+            return UNREAD;
+        return jsonRead(pointed(item.json.value, path.slice('/json'.length)));
+    }
+    if (path.startsWith('/headers/')) {
+        const name = path.slice('/headers/'.length);
+        return Object.hasOwn(item.headers, name)
+            ? single({ kind: 'string', value: item.headers[name] })
+            : undefined;
+    }
+    if (path === '/has_attachment')
+        return single({ kind: 'boolean', value: item.has_attachment });
+    const value = path === '/delivery'
+        ? item.delivery
+        : path === '/source'
+            ? item.source
+            : path === '/provider'
+                ? item.provider
+                : path === '/container'
+                    ? item.container
+                    : path === '/author'
+                        ? item.author
+                        : null;
+    return value === null ? undefined : single({ kind: 'string', value });
+}
+function wanted(value, owner) {
+    return isRecord(value) && value.owner === true ? owner : value;
+}
+function equal(held, value, owner) {
+    if (!('value' in held))
+        return undefined;
+    const expected = wanted(value, owner);
+    if (typeof expected !== typeof held.value)
+        return undefined;
+    if (held.kind !== 'time')
+        return expected === held.value;
+    const left = instant(held.value);
+    const right = instant(expected);
+    return left === undefined || right === undefined ? undefined : left === right;
+}
+function sign(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function ordered(held, value, compare) {
+    if (!('value' in held))
+        return undefined;
+    if (held.kind === 'number') {
+        if (typeof value !== 'number' || typeof held.value !== 'number')
+            return undefined;
+        return compare(Math.sign(held.value - value));
+    }
+    if (held.kind === 'date') {
+        if (!dated(value) || !dated(held.value))
+            return undefined;
+        return compare(sign(held.value, value));
+    }
+    if (held.kind !== 'time')
+        return undefined;
+    const at = instant(held.value);
+    const wanted = instant(value);
+    if (at === undefined || wanted === undefined)
+        return undefined;
+    return compare(sign(at, wanted));
+}
+function anyOf(truths) {
+    if (truths.some((truth) => truth === true))
+        return true;
+    return truths.some((truth) => truth === undefined) ? undefined : false;
+}
+function allOf(truths) {
+    if (truths.some((truth) => truth === false))
+        return false;
+    return truths.some((truth) => truth === undefined) ? undefined : true;
+}
+function compared(test, held, owner) {
+    if ('eq' in test)
+        return equal(held, test.eq, owner);
+    if ('in' in test)
+        return anyOf(test.in.map((value) => equal(held, value, owner)));
+    if ('prefix' in test) {
+        if (!('value' in held) || typeof held.value !== 'string')
+            return undefined;
+        if (held.kind === 'number' || held.kind === 'reference' || held.kind === 'member')
+            return undefined;
+        return held.value.startsWith(test.prefix);
+    }
+    if ('gt' in test)
+        return ordered(held, test.gt, (sign) => sign > 0);
+    if ('gte' in test)
+        return ordered(held, test.gte, (sign) => sign >= 0);
+    if ('lt' in test)
+        return ordered(held, test.lt, (sign) => sign < 0);
+    return ordered(held, test.lte, (sign) => sign <= 0);
+}
+function leaf(test, read, owner) {
+    if ('exists' in test) {
+        const present = read === undefined ? false : read.present;
+        return present === undefined ? undefined : present === test.exists;
+    }
+    if (read === undefined)
+        return undefined;
+    if ('contains' in test) {
+        if (read.items === null)
+            return undefined;
+        const truths = read.items.map((item) => item === undefined ? undefined : equal(item, test.contains, owner));
+        return read.loose === true && !truths.includes(true) ? false : anyOf(truths);
+    }
+    if (read.values.length === 0)
+        return read === NO_ITEM ? false : undefined;
+    return anyOf(read.values.map((value) => (value === undefined ? undefined : compared(test, value, owner))));
+}
+function evaluated(test, read, owner) {
+    if ('all' in test)
+        return allOf(test.all.map((part) => evaluated(part, read, owner)));
+    if ('any' in test)
+        return anyOf(test.any.map((part) => evaluated(part, read, owner)));
+    if ('not' in test) {
+        const truth = evaluated(test.not, read, owner);
+        return truth === undefined ? undefined : !truth;
+    }
+    return leaf(test, read(test.path), owner);
+}
+export function holds(test, document, owner) {
+    return evaluated(test, (path) => readDocument(document, path), owner);
+}
+function inScope(scope, document) {
+    if (document === null)
+        return false;
+    if ('type' in scope)
+        return document.type === scope.type;
+    if ('document' in scope)
+        return document.id === scope.document;
+    return scope.folder === '/' || document.path.startsWith(`${scope.folder}/`);
+}
+function matched(condition, test, document, owner) {
+    if (!inScope(condition.scope, document))
+        return false;
+    return test === undefined || holds(test, document, owner) === true;
+}
+function reachedAt(document, field) {
+    if (document === null)
+        return [];
+    if (field.startsWith('/sections/'))
+        return document.sections.includes(field.slice('/sections/'.length))
+            ? [{ pointer: field, fact: PROSE }]
+            : [];
+    if (!field.startsWith('/fields/'))
+        return [];
+    return walked(rootOf(document, '/fields'), field.slice('/fields'.length)).reached;
+}
+function valueOf(fact) {
+    if (fact.kind === 'list')
+        return { kind: fact.kind, items: fact.items.map(valueOf) };
+    if (fact.kind === 'object')
+        return {
+            kind: fact.kind,
+            fields: Object.keys(fact.fields)
+                .sort()
+                .map((key) => [key, valueOf(fact.fields[key])]),
+        };
+    return 'value' in fact ? { kind: fact.kind, value: fact.value } : fact;
+}
+function signature(reached) {
+    return JSON.stringify(reached.map(({ fact }) => valueOf(fact)));
+}
+function among(values, document, field, owner) {
+    return holds({ path: field, in: values }, document, owner) === true;
+}
+function fieldChanged(condition, event, owner) {
+    const { field, from, to } = condition;
+    const before = reachedAt(event.before, field);
+    const after = reachedAt(event.after, field);
+    const pointers = [field, ...[...before, ...after].map(({ pointer }) => pointer)];
+    const prose = event.changed.some((changed) => pointers.some((pointer) => changed === pointer || changed.startsWith(`${pointer}/`)));
+    if (from === undefined && to === undefined && prose)
+        return true;
+    if (before.length === 0 && after.length === 0)
+        return false;
+    if (event.before !== null && event.after !== null && signature(before) === signature(after))
+        return false;
+    if (from === 'new'
+        ? event.before !== null
+        : from !== undefined && (event.before === null || !among(from, event.before, field, owner)))
+        return false;
+    if (to === 'deleted'
+        ? event.after !== null
+        : to !== undefined && (event.after === null || !among(to, event.after, field, owner)))
+        return false;
+    return true;
+}
+export function fires(condition, event, owner) {
+    if (condition.by !== undefined &&
+        evaluated(condition.by, (path) => readActor(event.by, path), owner) !== true)
+        return false;
+    if (condition.mode === 'starts_matching') {
+        if (event.before === null && !condition.new_documents)
+            return false;
+        return (matched(condition, condition.match, event.after, owner) &&
+            !matched(condition, condition.match, event.before, owner));
+    }
+    const side = event.after ?? event.before;
+    return matched(condition, condition.match, side, owner) && fieldChanged(condition, event, owner);
+}
+export function itemFires(condition, item, owner) {
+    if (condition.source !== undefined && item.source !== condition.source)
+        return false;
+    if (condition.address !== undefined && item.address !== condition.address)
+        return false;
+    return (condition.match === undefined ||
+        evaluated(condition.match, (path) => readItem(item, path), owner) === true);
+}