@ultimabase/graphql 0.0.0-stage → 0.1.1

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAEN,eAAe,EAGf,WAAW,EACX,cAAc,EAEd,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EACX,MAAM,EACN,MAAM,EACN,YAAY,EACZ,WAAW,EACX,WAAW,EACX,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAI3C,wCAAwC;AACxC,MAAM,MAAM,WAAW,GACtB;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAA;AAEhE,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;KAAE,CAAA;CACpE,CAAA;AACD,qEAAqE;AACrE,eAAO,MAAM,EAAE,YAAa,OAAO,KAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAEzD,CAAA;AACF,MAAM,MAAM,IAAI,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AACtD,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAEtE,MAAM,MAAM,KAAK,GAAG;IACnB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACtB,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,MAAM,CAAA;CAC1C,CAAA;AAUD,qBAAa,QAAQ;;IAIpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC5C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,4EAA4E;IAC5E,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAC9D;IAEX,YAAY,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAWlE;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAI1B;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,GAAG,iBAAiB,CAEtE;IAED,KAAK,CACJ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,sBAAsB,GACjC,sBAAsB,CAExB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,GAAG,eAAe,CAEhE;CACD;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CACxB,CAAC,SAAS;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EAC7D,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,GAAG;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,CAQtE;AAED,eAAO,MAAM,WAAW,EAAE;IACzB,QAAQ,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,iBAAiB;CASlE,CAAA;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACX,iBAAiB,GAAG,eAAe,CAmBrC;AAED,+EAA+E;AAC/E,eAAO,MAAM,SAAS,aACX,QAAQ,SACX,MAAM,SACN,MAAM,KAEX,iBAAiB,GACjB,eAAe,GACf,WAAW,CAAC,cAAc,CAAC,iBAAiB,GAAG,eAAe,CAAC,CAGjE,CAAA"}

package/dist/registry.js

@@ -0,0 +1,97 @@
+import { GraphQLBoolean, GraphQLEnumType, GraphQLFloat, GraphQLInt, GraphQLList, GraphQLNonNull, GraphQLString, } from 'graphql';
+import { DataTypes } from './data-types.js';
+import { upper } from './names.js';
+import { DateScalar, DateTime, DecimalScalar, JSONScalar } from './scalars.js';
+/** A kernel query's options: run as the request's caller (D-106). */
+export const as = (context) => ({
+    as: context.caller,
+});
+function memo(cache, name, build) {
+    const found = cache.get(name);
+    if (found !== undefined)
+        return found;
+    const built = build();
+    cache.set(name, built);
+    return built;
+}
+export class Registry {
+    #objects = new Map();
+    #inputs = new Map();
+    #enums = new Map();
+    entries;
+    settings;
+    /** The types functions and json fields give, shared by both (D-125). */
+    data;
+    /** A model's virtual fields, which the functions' outputs build (D-151). */
+    virtualFields = () => ({});
+    constructor(entries, settings) {
+        this.entries = entries;
+        this.settings = settings;
+        this.data = new DataTypes(entries.keys());
+        // Before any function's: a `defineEnum` keeps its own description.
+        for (const [model, { exposed }] of entries) {
+            for (const [field, shared] of Object.entries(exposed.enums)) {
+                const { name, values, description } = shared;
+                this.data.enum(name, values, `${model}.${field}`, description);
+            }
+        }
+    }
+    entry(model) {
+        const entry = this.entries.get(model);
+        if (entry === undefined)
+            throw new Error(`Unknown model ${model}.`);
+        return entry;
+    }
+    object(name, build) {
+        return memo(this.#objects, name, build);
+    }
+    input(name, build) {
+        return memo(this.#inputs, name, build);
+    }
+    enum(name, build) {
+        return memo(this.#enums, name, build);
+    }
+}
+/** Each field's `description` (D-150), on the fields of a type or an input. */
+export function described(entry, fields) {
+    for (const [field, description] of Object.entries(entry.exposed.descriptions)) {
+        const config = fields[field];
+        if (config !== undefined)
+            fields[field] = { ...config, description };
+    }
+    return fields;
+}
+export const scalarTypes = {
+    string: GraphQLString,
+    number: GraphQLFloat,
+    decimal: DecimalScalar,
+    boolean: GraphQLBoolean,
+    dateTime: DateTime,
+    date: DateScalar,
+    json: JSONScalar,
+};
+/**
+ * A scalar field's type; an enum's is `PostStatus`, built once, and a
+ * `defineEnum`'s its own name, one type for every field (D-150).
+ */
+export function scalarType(registry, model, field) {
+    if (field.integer === true)
+        return GraphQLInt;
+    if (field.type !== 'enum')
+        return scalarTypes[field.type];
+    const shared = registry.entry(model).exposed.enums[field.name];
+    if (shared !== undefined) {
+        const { name, values } = shared;
+        return registry.data.enum(name, values, `${model}.${field.name}`);
+    }
+    const name = `${model}${upper(field.name)}`;
+    return registry.enum(name, () => new GraphQLEnumType({
+        name,
+        values: Object.fromEntries((field.values ?? []).map((value) => [value, { value }])),
+    }));
+}
+/** A scalar field's value, read or written: a list's is `[Float!]` (D-127). */
+export const valueType = (registry, model, field) => {
+    const item = scalarType(registry, model, field);
+    return field.list ? new GraphQLList(new GraphQLNonNull(item)) : item;
+};

package/dist/reread.d.ts

@@ -0,0 +1,9 @@
+import type { GraphQLResolveInfo } from 'graphql';
+import type { ExposedOutput } from 'ultimabase';
+import type { Context, Registry } from './registry.ts';
+/** `run`'s value, its rows' relations read as the caller. */
+export declare function reread(registry: Registry, output: ExposedOutput, value: unknown, context: Context, info: GraphQLResolveInfo, call: {
+    readonly name: string;
+    readonly take: number;
+}): Promise<unknown>;
+//# sourceMappingURL=reread.d.ts.map

package/dist/reread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reread.d.ts","sourceRoot":"","sources":["../src/reread.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,KAAK,EAAQ,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAgB5D,6DAA6D;AAC7D,wBAAsB,MAAM,CAC3B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,OAAO,CAAC,CA+HlB"}

package/dist/reread.js

@@ -0,0 +1,116 @@
+// A function's output as the client reads it (D-109): its scalars as `run`
+// returned them, its rows' relations re-read by id as the caller, in one
+// query per model and only when a relation is selected.
+import { badInput, rowsOf, run } from '@ultimabase/http/internal';
+import { isMaster, objectType } from './outputs.js';
+import { as } from './registry.js';
+import { grouped, selectOf } from './select.js';
+const isRecord = (value) => typeof value === 'object' && value !== null;
+/** `run`'s value, its rows' relations read as the caller. */
+export async function reread(registry, output, value, context, info, call) {
+    const master = isMaster(context);
+    // The rows whose relations are read, which the row budget counts.
+    let counted = 0;
+    const pending = new Map();
+    // A list's items share their nodes: each selection is read once.
+    const relations = new Map();
+    const fields = new Map();
+    const relationsOf = (model, nodes) => {
+        const known = relations.get(nodes);
+        if (known !== undefined)
+            return known;
+        const type = objectType(registry, model);
+        const select = selectOf(registry, info, type, nodes, master);
+        // A virtual is computed when its row is read (D-151).
+        const { virtuals } = registry.entry(model).exposed;
+        const found = Object.fromEntries(Object.entries(select).filter(([name, read]) => read !== true || virtuals.some((virtual) => virtual.name === name)));
+        relations.set(nodes, found);
+        return found;
+    };
+    const fieldsOf = (nodes) => {
+        const known = fields.get(nodes);
+        if (known !== undefined)
+            return known;
+        const found = grouped(info, nodes);
+        fields.set(nodes, found);
+        return found;
+    };
+    const row = (model, item, nodes) => {
+        const select = relationsOf(model, nodes);
+        if (Object.keys(select).length === 0)
+            return item;
+        const copy = { ...item };
+        const { id } = copy;
+        if (typeof id !== 'string') {
+            throw new TypeError(`A ${model} was returned without its id.`);
+        }
+        const reading = pending.get(model) ?? {
+            select: {},
+            rows: new Map(),
+        };
+        pending.set(model, reading);
+        for (const [name, read] of Object.entries(select)) {
+            const known = reading.select[name];
+            if (known !== undefined &&
+                JSON.stringify(known) !== JSON.stringify(read)) {
+                throw badInput(`${model}.${name} is selected in two ways; select it the same way everywhere.`);
+            }
+            reading.select[name] = read;
+        }
+        reading.rows.set(id, [...(reading.rows.get(id) ?? []), copy]);
+        counted += 1;
+        return copy;
+    };
+    const one = (named, item, nodes) => {
+        if (!isRecord(item))
+            return item;
+        if (named.kind === 'model')
+            return row(named.name, item, nodes);
+        const copy = { ...item };
+        const selected = fieldsOf(nodes);
+        for (const [name, field] of named.type.fields) {
+            const below = selected.get(name);
+            if (below !== undefined) {
+                copy[name] = walk(field, Reflect.get(item, name), below);
+            }
+        }
+        return copy;
+    };
+    const walk = (at, item, nodes) => {
+        if (at.kind === 'schema')
+            return item;
+        if (at.form !== 'list' || !Array.isArray(item)) {
+            return one(at, item, nodes);
+        }
+        const before = counted;
+        const items = item.map((each) => one(at, each, nodes));
+        // The budget counts `take` rows in a list (D-109).
+        if (items.length > call.take && counted > before) {
+            throw new RangeError(`${call.name} returned ${items.length} rows; a list counts take (${call.take}) rows, so it holds no more under a selected relation.`);
+        }
+        return items;
+    };
+    const result = walk(output, value, info.fieldNodes);
+    for (const [model, { select, rows }] of pending) {
+        const entry = registry.entry(model);
+        const ids = [...rows.keys()];
+        const read = await run(() => entry.exposed.queries.findMany({
+            where: { id: { in: ids } },
+            take: ids.length,
+            select: { id: true, ...select },
+        }, as(context)));
+        const byId = new Map(rowsOf(read).map((found) => [found.id, found]));
+        for (const [id, copies] of rows) {
+            const found = byId.get(id);
+            for (const name of Object.keys(select)) {
+                // A row the caller cannot read has no relations (D-109).
+                const many = entry.model.fields.some((field) => field.name === name && field.kind === 'many');
+                const empty = many ? [] : null;
+                const relation = found === undefined ? empty : Reflect.get(found, name);
+                for (const copy of copies)
+                    copy[name] = relation;
+            }
+        }
+    }
+    return result;
+}

package/dist/rows.d.ts

@@ -0,0 +1,23 @@
+import type { ValidatedExecutionArgs } from 'graphql';
+import { GraphQLError } from 'graphql';
+import type { Entry, Registry } from './registry.ts';
+/**
+ * What a field reads: one row, a list of a model's rows, or a function's
+ * list, which counts `take` rows (D-109).
+ */
+export type Read = {
+    readonly kind: 'one';
+} | {
+    readonly kind: 'many';
+    readonly entry: Entry;
+} | {
+    readonly kind: 'list';
+    readonly size: number;
+};
+export type Limits = {
+    readonly maxRows: number;
+    readonly maxDepth: number;
+};
+/** The refusal of a document that may return more than `maxRows` rows. */
+export declare function rowBudget(registry: Registry, { maxRows, maxDepth }: Limits, functions: ReadonlyMap<string, ReadonlyMap<string, Read>>): (args: ValidatedExecutionArgs) => GraphQLError | undefined;
+//# sourceMappingURL=rows.d.ts.map

package/dist/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../src/rows.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGX,sBAAsB,EACtB,MAAM,SAAS,CAAA;AAChB,OAAO,EAGN,YAAY,EAEZ,MAAM,SAAS,CAAA;AAGhB,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEpD;;;GAGG;AACH,MAAM,MAAM,IAAI,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAoCnD,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5E,0EAA0E;AAC1E,wBAAgB,SAAS,CACxB,QAAQ,EAAE,QAAQ,EAClB,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,EAC7B,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GACvD,CAAC,IAAI,EAAE,sBAAsB,KAAK,YAAY,GAAG,SAAS,CAgF5D"}

package/dist/rows.js

@@ -0,0 +1,106 @@
+import { getArgumentValues, getNamedType, GraphQLError, isObjectType, } from 'graphql';
+import { grouped } from './select.js';
+const one = { kind: 'one' };
+/** Each a query or a write of its own, a count one more. */
+const maxRoots = 20;
+const responseKey = (node) => node.alias?.value ?? node.name.value;
+// `take` for none or a negative number; above `maxTake`, the list refuses.
+const sizeOf = (entry, asked) => typeof asked === 'number' && asked >= 0
+    ? Math.min(asked, entry.maxTake)
+    : entry.take;
+/** The reads of the root query, by field name. */
+function rootReads(registry) {
+    const reads = new Map();
+    for (const entry of registry.entries.values()) {
+        if (!entry.visible)
+            continue;
+        reads.set(entry.single, one);
+        reads.set(entry.list, { kind: 'many', entry });
+    }
+    return reads;
+}
+/** The relations an `orderBy` goes through, the deepest path's. */
+function sortDepth(orderBy) {
+    if (Array.isArray(orderBy))
+        return Math.max(0, ...orderBy.map(sortDepth));
+    if (typeof orderBy !== 'object' || orderBy === null)
+        return 0;
+    return Math.max(0, ...Object.values(orderBy).map((value) => typeof value === 'object' && value !== null ? 1 + sortDepth(value) : 0));
+}
+/** The refusal of a document that may return more than `maxRows` rows. */
+export function rowBudget(registry, { maxRows, maxDepth }, functions) {
+    const roots = rootReads(registry);
+    const list = registry.settings.pagination === 'list';
+    const readOf = (type, root, name) => {
+        const called = functions.get(type.name);
+        if (called?.has(name) === true)
+            return called.get(name);
+        if (root === 'mutation')
+            return one;
+        if (root === 'query')
+            return roots.get(name);
+        const entry = registry.entries.get(type.name);
+        const field = entry?.model.fields.find((f) => f.name === name);
+        if (field === undefined || field.kind === 'scalar')
+            return undefined;
+        if (field.kind === 'one')
+            return one;
+        return { kind: 'many', entry: registry.entry(field.target) };
+    };
+    return (args) => {
+        const info = {
+            fragments: args.fragmentDefinitions,
+            variableValues: args.variableValues,
+        };
+        let rows = 0;
+        let rootFields = 0;
+        let deepest = 0;
+        const walk = (type, nodes, times, root, level) => {
+            for (const fields of grouped(info, nodes, responseKey).values()) {
+                if (rows > maxRows)
+                    return;
+                const [node] = fields;
+                const field = type.getFields()[node.name.value];
+                if (field === undefined)
+                    continue;
+                const read = readOf(type, root, node.name.value);
+                let each = times;
+                if (read?.kind === 'many') {
+                    const asked = getArgumentValues(field, node, args.variableValues);
+                    const size = sizeOf(read.entry, list ? asked['take'] : (asked['last'] ?? asked['first']));
+                    // A count reads the rows it counts, however few the page returns.
+                    deepest = Math.max(deepest, level + sortDepth(asked['orderBy']));
+                    const counted = grouped(info, fields).has('totalCount');
+                    each *= counted ? Math.max(size, read.entry.take) : size;
+                    if (counted && root !== '')
+                        rootFields += 1;
+                }
+                else if (read?.kind === 'list')
+                    each *= read.size;
+                if (read !== undefined)
+                    rows += each;
+                if (root !== '')
+                    rootFields += 1;
+                const named = getNamedType(field.type);
+                if (isObjectType(named) && each > 0) {
+                    walk(named, fields, each, '', level + 1);
+                }
+            }
+        };
+        const { operation } = args;
+        const type = args.schema.getRootType(operation.operation);
+        // `validateExecutionArgs` refused an operation the schema has no root for.
+        if (type)
+            walk(type, [operation], 1, operation.operation, 1);
+        if (deepest > maxDepth) {
+            return new GraphQLError(`The document is nested ${deepest} levels deep, its orderBy included; the most is ${maxDepth}.`);
+        }
+        if (rootFields > maxRoots) {
+            return new GraphQLError(`The document asks for more than ${maxRoots} root fields, a totalCount counted as one more. Send several documents.`);
+        }
+        if (rows <= maxRows)
+            return undefined;
+        const fewer = list ? 'take' : 'first or last';
+        return new GraphQLError(`The document asks for more than ${maxRows.toLocaleString('en-US')} rows. Ask for fewer with ${fewer}.`);
+    };
+}

package/dist/scalars.d.ts

@@ -0,0 +1,13 @@
+import { GraphQLScalarType } from 'graphql';
+/** A date a client sent, which keeps its text for a function (D-109). */
+export declare class SentDate extends Date {
+    readonly sent: string;
+    constructor(sent: string);
+}
+export declare const DateTime: GraphQLScalarType<Date, string>;
+export declare const DecimalScalar: GraphQLScalarType<string, string>;
+export declare const DateScalar: GraphQLScalarType<string, string>;
+/** Dates back to their text: a validator reads what the client sent. */
+export declare function plain(value: unknown): unknown;
+export declare const JSONScalar: GraphQLScalarType<unknown, unknown>;
+//# sourceMappingURL=scalars.d.ts.map

package/dist/scalars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalars.d.ts","sourceRoot":"","sources":["../src/scalars.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,iBAAiB,EAAQ,MAAM,SAAS,CAAA;AAK/D,yEAAyE;AACzE,qBAAa,QAAS,SAAQ,IAAI;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,YAAY,IAAI,EAAE,MAAM,EAGvB;CACD;AAYD,eAAO,MAAM,QAAQ,EAAE,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAenD,CAAA;AAOF,eAAO,MAAM,aAAa,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAQzD,CAAA;AAOH,eAAO,MAAM,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAQtD,CAAA;AAEH,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO7C;AAkBD,eAAO,MAAM,UAAU,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAOxD,CAAA"}

package/dist/scalars.js

@@ -0,0 +1,88 @@
+import { GraphQLError, GraphQLScalarType, Kind } from 'graphql';
+const iso = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:\d{2})$/;
+/** A date a client sent, which keeps its text for a function (D-109). */
+export class SentDate extends Date {
+    sent;
+    constructor(sent) {
+        super(sent);
+        this.sent = sent;
+    }
+}
+function date(value) {
+    if (typeof value === 'string' && iso.test(value)) {
+        const parsed = new SentDate(value);
+        if (!Number.isNaN(parsed.getTime()))
+            return parsed;
+    }
+    throw new GraphQLError('A DateTime is an ISO 8601 string, such as 2026-01-31T12:00:00.000Z.');
+}
+export const DateTime = new GraphQLScalarType({
+    name: 'DateTime',
+    description: 'A date and time, as an ISO 8601 string.',
+    coerceOutputValue: (value) => {
+        if (value instanceof Date)
+            return value.toISOString();
+        // A function's schema output holds its dates as strings (D-109).
+        if (typeof value === 'string')
+            return date(value).toISOString();
+        throw new GraphQLError('A DateTime field returned no date.');
+    },
+    coerceInputValue: date,
+    coerceInputLiteral: (node) => date(node.kind === Kind.STRING ? node.value : undefined),
+});
+function decimal(value) {
+    if (typeof value === 'string')
+        return value;
+    throw new GraphQLError("A Decimal is a string, such as '12.50'.");
+}
+export const DecimalScalar = new GraphQLScalarType({
+    name: 'Decimal',
+    description: "An exact number, as a string such as '12.50'.",
+    coerceOutputValue: decimal,
+    coerceInputValue: decimal,
+    coerceInputLiteral: (node) => decimal(node.kind === Kind.STRING ? node.value : undefined),
+});
+function day(value) {
+    if (typeof value === 'string')
+        return value;
+    throw new GraphQLError("A Date is a day as a string, such as '2026-07-31'.");
+}
+export const DateScalar = new GraphQLScalarType({
+    name: 'Date',
+    description: "A day, as an ISO 8601 string such as '2026-07-31'.",
+    coerceOutputValue: day,
+    coerceInputValue: day,
+    coerceInputLiteral: (node) => day(node.kind === Kind.STRING ? node.value : undefined),
+});
+/** Dates back to their text: a validator reads what the client sent. */
+export function plain(value) {
+    if (value instanceof SentDate)
+        return value.sent;
+    if (Array.isArray(value))
+        return value.map(plain);
+    if (typeof value !== 'object' || value === null)
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, plain(item)]));
+}
+/** A literal as the plain value the kernel's JSON check accepts. */
+function literal(node) {
+    if (node.kind === Kind.OBJECT) {
+        return Object.fromEntries(node.fields.map((field) => [field.name.value, literal(field.value)]));
+    }
+    if (node.kind === Kind.LIST)
+        return node.values.map(literal);
+    if (node.kind === Kind.INT || node.kind === Kind.FLOAT) {
+        return Number(node.value);
+    }
+    if (node.kind === Kind.NULL)
+        return null;
+    // A string, a boolean or an enum's name.
+    return node.value;
+}
+export const JSONScalar = new GraphQLScalarType({
+    name: 'JSON',
+    description: 'Any JSON value.',
+    coerceOutputValue: (value) => value,
+    coerceInputValue: (value) => value,
+    coerceInputLiteral: literal,
+});

package/dist/schema.d.ts

@@ -0,0 +1,17 @@
+import type { GraphQLFieldConfig, GraphQLNamedType } from 'graphql';
+import { GraphQLSchema } from 'graphql';
+import type { Args, Context, Registry } from './registry.ts';
+import type { RootField } from './functions.ts';
+type Fields = {
+    [field: string]: GraphQLFieldConfig<unknown, Context, Args>;
+};
+/** Refuses two root fields of one name, naming both owners. */
+export declare function schemaOf(registry: Registry, called: {
+    readonly fields: readonly RootField[];
+    readonly owners: ReadonlyMap<string, string>;
+    readonly named: (name: string) => GraphQLNamedType | undefined;
+    /** The live models' subscriptions, named as their queries (D-154). */
+    readonly subscriptions: Fields;
+}): GraphQLSchema;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AACnE,OAAO,EAIN,aAAa,EACb,MAAM,SAAS,CAAA;AAIhB,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAS,QAAQ,EAAE,MAAM,eAAe,CAAA;AAInE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG/C,KAAK,MAAM,GAAG;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;CAAE,CAAA;AAwF7E,+DAA+D;AAC/D,wBAAgB,QAAQ,CACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE;IACP,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAA;IAC9D,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC9B,GACC,aAAa,CAsEf"}

package/dist/schema.js

@@ -0,0 +1,130 @@
+// The schema (D-107): for each visible model, `post(where)` and `posts(...)`,
+// each read in one kernel query as its caller, and its mutations.
+import { connection, rowsOf, run } from '@ultimabase/http/internal';
+import { GraphQLList, GraphQLNonNull, GraphQLObjectType, GraphQLSchema, } from 'graphql';
+import { objectOf, uniqueInput, uniqueWhere } from './inputs.js';
+import { connectionType, isMaster, listArgs, objectType } from './outputs.js';
+import { listRead, whereOf } from './pages.js';
+import { as } from './registry.js';
+import { rowNodes, selectOf } from './select.js';
+import { mutationFields } from './mutations.js';
+import { Refused } from 'ultimabase';
+function rootFields(registry, entry) {
+    const name = entry.model.name;
+    const type = objectType(registry, name);
+    const { queries } = entry.exposed;
+    const list = registry.settings.pagination === 'list'
+        ? new GraphQLNonNull(new GraphQLList(new GraphQLNonNull(type)))
+        : new GraphQLNonNull(connectionType(registry, `${name}Connection`, name));
+    return {
+        [entry.single]: {
+            type,
+            args: {
+                where: { type: new GraphQLNonNull(uniqueInput(registry, name)) },
+            },
+            resolve: async (_, args, context, info) => {
+                const where = uniqueWhere(registry, name, objectOf(args['where']));
+                const select = selectOf(registry, info, type, info.fieldNodes, isMaster(context));
+                return run(() => queries.findUnique({ where, select }, as(context)));
+            },
+        },
+        [entry.list]: {
+            type: list,
+            args: listArgs(registry, name),
+            resolve: async (_, args, context, info) => {
+                const master = isMaster(context);
+                const { read, page } = listRead(registry, entry, args, master);
+                const select = selectOf(registry, info, type, rowNodes(registry, info), master);
+                const rows = await run(() => queries.findMany({ ...read, select }, as(context)));
+                if (page === undefined)
+                    return rows;
+                let counted;
+                return {
+                    ...connection(rowsOf(rows), page, (row) => row),
+                    // Called by the default resolver, so counted only when selected,
+                    // and once however many aliases ask.
+                    totalCount: async () => {
+                        counted ??= run(() => queries.count(whereOf(registry, name, args), as(context)));
+                        return counted;
+                    },
+                };
+            },
+        },
+    };
+}
+const taken = (name, owner) => new Refused(`${owner}: the type ${name} is a generated type's name.`);
+/** The models' types, a json field's among them, built once to name them. */
+function generatedTypes(fields, mutations, typeOwners) {
+    try {
+        return new GraphQLSchema({
+            query: new GraphQLObjectType({ name: 'Query', fields: { ...fields } }),
+            mutation: new GraphQLObjectType({
+                name: 'Mutation',
+                fields: { ...mutations },
+            }),
+        }).getTypeMap();
+    }
+    catch (error) {
+        // A json field's type named like a model's, as `PostStatus`.
+        const name = /multiple types named "(\w+)"/.exec(String(error))?.[1];
+        const owner = name === undefined ? undefined : typeOwners.get(name);
+        if (name === undefined || owner === undefined)
+            throw error;
+        throw taken(name, owner);
+    }
+}
+/** Refuses two root fields of one name, naming both owners. */
+export function schemaOf(registry, called) {
+    const { fields: functions, owners: typeOwners, named, subscriptions } = called;
+    const roots = {
+        query: new Map(),
+        mutation: new Map(),
+    };
+    const fields = {};
+    const mutations = {};
+    const add = (into, owners, owner, hint, added) => {
+        for (const [name, field] of Object.entries(added)) {
+            const other = owners.get(name);
+            if (other !== undefined) {
+                throw new Refused(`${owner}: the root field ${name} is ${other}'s; set .with({ graphql: { ${hint} } }).`);
+            }
+            owners.set(name, owner);
+            into[name] = field;
+        }
+    };
+    for (const entry of registry.entries.values()) {
+        if (!entry.visible)
+            continue;
+        const owner = entry.model.name;
+        add(mutations, roots.mutation, owner, 'plural', mutationFields(registry, entry));
+        add(fields, roots.query, owner, 'plural', rootFields(registry, entry));
+    }
+    // The models' types, which no function's or field's type may be named like.
+    const generated = generatedTypes(fields, mutations, typeOwners);
+    for (const [name, owner] of typeOwners) {
+        if (name in generated && generated[name] !== named(name)) {
+            throw taken(name, owner);
+        }
+    }
+    for (const { query, name, owner, field } of functions) {
+        const [into, owners] = query
+            ? [fields, roots.query]
+            : [mutations, roots.mutation];
+        add(into, owners, owner, 'name', { [name]: field });
+    }
+    if (Object.keys(fields).length === 0) {
+        throw new Refused('graphqlPlugin: no query to expose; each model has .with({ graphql: false }) and no function is a query.');
+    }
+    return new GraphQLSchema({
+        query: new GraphQLObjectType({ name: 'Query', fields }),
+        mutation: Object.keys(mutations).length === 0
+            ? undefined
+            : new GraphQLObjectType({ name: 'Mutation', fields: mutations }),
+        subscription: Object.keys(subscriptions).length === 0
+            ? undefined
+            : new GraphQLObjectType({
+                name: 'Subscription',
+                fields: subscriptions,
+            }),
+    });
+}

package/dist/select.d.ts

@@ -0,0 +1,24 @@
+import type { FieldNode, GraphQLObjectType, GraphQLResolveInfo, SelectionSetNode } from 'graphql';
+import type { Args, Registry } from './registry.ts';
+export type Info = Pick<GraphQLResolveInfo, 'fragments' | 'variableValues'>;
+/** A field's name, or its alias: the key of its value in the response. */
+export type Key = (node: FieldNode) => string;
+/** Fields under one key, the first of them included. */
+export type Fields = readonly [FieldNode, ...FieldNode[]];
+/** A field or an operation: what selects fields. */
+export type Selecting = {
+    readonly selectionSet?: SelectionSetNode | undefined;
+};
+/** The fields under some nodes, by name, through fragments and directives. */
+export declare function grouped(info: Info, nodes: readonly Selecting[], key?: Key): ReadonlyMap<string, Fields>;
+/** Under a connection, the nodes its edges select. */
+export declare function nodesOf(info: Info, nodes: readonly FieldNode[]): FieldNode[];
+/** What a root list selects of its rows: under `edges { node }`. */
+export declare function rowNodes(registry: Registry, info: GraphQLResolveInfo): readonly FieldNode[];
+/** The kernel's `select` for what a query asks of a model's rows. */
+export declare function selectOf(registry: Registry, info: Info, type: GraphQLObjectType, nodes: readonly FieldNode[], master: boolean): Args;
+/** `context.select(info)`, for a field that returns a model or a list of one. */
+export declare function selectFor(registry: Registry, master: boolean): (info: GraphQLResolveInfo) => Args & {
+    readonly id: true;
+};
+//# sourceMappingURL=select.d.ts.map

package/dist/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAchB,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEnD,MAAM,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAAA;AAC3E,0EAA0E;AAC1E,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAA;AAC7C,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAA;AACzD,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;CAAE,CAAA;AA6ChF,8EAA8E;AAC9E,wBAAgB,OAAO,CACtB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,GAAG,GAAE,GAAY,GACf,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAK7B;AAwBD,sDAAsD;AACtD,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAG5E;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,kBAAkB,GACtB,SAAS,SAAS,EAAE,CAItB;AAqBD,qEAAqE;AACrE,wBAAgB,QAAQ,CACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,MAAM,EAAE,OAAO,GACb,IAAI,CA2DN;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CACxB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,GACb,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,CAa5D"}