@adminiumjs/manifest 0.3.0-rc.3 → 0.3.0

package/dist/outbox.js

@@ -0,0 +1,355 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * `outbox` and `emailTemplates` — the emails an app sends, declared with the
+ * app and versioned with it.
+ *
+ * The app's own table IS the outbox: every email is a row in it, queued by
+ * whatever wants it sent (a producer below, the desk's "Send now", an
+ * operator), then sent by Adminium, which records `sent`, `failed` or
+ * `skipped` on the row. So the table is the log a person reads, and a row of
+ * a kind already there for the same source is what stops a second send.
+ *
+ * Producers queue rows by themselves: when a row is created, when a column
+ * changes to a value, or a lead time before a timestamp (a reminder at the
+ * time each patient chose).
+ *
+ * Templates are stored with the app as their owner. An operator who edits
+ * one keeps the edit across the app's updates.
+ */
+import { z } from 'zod';
+import { bcp47TagSchema, refSchema, scalarSchema, settingRefSchema, textOrLabels, valueFits, } from './refs.js';
+/** The statuses an outbox table's status column must offer. */
+export const OUTBOX_STATUSES = ['queued', 'sent', 'failed', 'skipped'];
+/** One condition on a row: equal to a value, one of several, or empty (or not). */
+const conditionSchema = z
+    .object({
+    column: refSchema,
+    eq: scalarSchema.optional(),
+    in: z.array(scalarSchema).min(1).max(32).optional(),
+    isNull: z.boolean().optional(),
+})
+    .strict()
+    .refine((c) => [c.eq, c.in, c.isNull].filter((part) => part !== undefined).length === 1, {
+    message: 'a condition says one of eq, in or isNull',
+});
+const producerBase = {
+    /** The kind of row it queues (a key of `outbox.kinds`). */
+    kind: z.string().min(1).max(40),
+    /** The outbox column that links the queued row to the row that produced it. */
+    link: refSchema,
+    /** Paused while the settings row's `enabled` column is false. */
+    gate: z.literal('enabled').optional(),
+    /** Skipped for a recipient whose `recipient.optIn` column is false. */
+    optIn: z.literal(true).optional(),
+};
+const producerSchema = z.union([
+    z
+        .object({ ...producerBase, onCreate: z.object({ table: refSchema, where: conditionSchema.optional() }).strict() })
+        .strict(),
+    z
+        .object({
+        ...producerBase,
+        onChange: z
+            .object({
+            table: refSchema,
+            column: refSchema,
+            to: z.union([scalarSchema, z.array(scalarSchema).min(1).max(16)]),
+            where: conditionSchema.optional(),
+        })
+            .strict(),
+    })
+        .strict(),
+    z
+        .object({
+        ...producerBase,
+        before: z
+            .object({
+            table: refSchema,
+            /** The moment the email leads: a timestamptz. */
+            at: refSchema,
+            /** How many hours before: read through one link, with a settings fallback. */
+            lead: z
+                .object({
+                via: refSchema,
+                table: refSchema,
+                column: refSchema,
+                fallback: settingRefSchema.optional(),
+                /** The largest lead anyone may choose, in hours — how far ahead Adminium looks. */
+                max: z.number().int().min(1).max(24 * 14),
+            })
+                .strict(),
+            where: conditionSchema.optional(),
+        })
+            .strict(),
+    })
+        .strict(),
+]);
+const recipientSchema = z
+    .object({
+    /** The outbox column pointing at the person, and their table's columns. */
+    via: refSchema,
+    table: refSchema,
+    email: refSchema,
+    name: refSchema.optional(),
+    language: refSchema.optional(),
+    /** A bool the person sets: false means no reminders. */
+    optIn: refSchema.optional(),
+    /**
+     * Where the address comes from when `via` is empty — a first visit made
+     * by someone not yet on file carries their details on the row itself.
+     */
+    fallback: z
+        .object({ via: refSchema, email: refSchema, name: refSchema.optional(), language: refSchema.optional() })
+        .strict()
+        .optional(),
+})
+    .strict();
+export const outboxSchema = z
+    .object({
+    table: refSchema,
+    columns: z
+        .object({
+        kind: refSchema,
+        status: refSchema,
+        to: refSchema,
+        language: refSchema.optional(),
+        due: refSchema.optional(),
+        sentAt: refSchema.optional(),
+        error: refSchema.optional(),
+    })
+        .strict(),
+    /**
+     * The outbox's foreign keys, by the name a template reads them under:
+     * `{appointment: 'appointment_id'}` gives a template `appointment.*`.
+     */
+    links: z.record(z.string().regex(/^[a-z][a-z_]*$/, 'a link name is snake_case'), refSchema).optional(),
+    recipient: recipientSchema,
+    /**
+     * The app's one-row settings table, read as `practice.*` by every template;
+     * `name` is the column its emails are signed with (the sign-in code's too),
+     * and `phone` the number Adminium's own notices give a person to ring —
+     * the one sent to an old address after a change of email.
+     */
+    settings: z
+        .object({ table: refSchema, enabled: refSchema.optional(), name: refSchema.optional(), phone: refSchema.optional() })
+        .strict()
+        .optional(),
+    /**
+     * Where a template's links lead on the app's guest side: `manage_url` and
+     * `booking_url`, as paths under its address (default: its front page).
+     */
+    pages: z
+        .object({
+        manage: z.string().regex(/^\/[A-Za-z0-9/_-]{0,119}$/, 'a path on the guest side, e.g. /my-visits').optional(),
+        booking: z.string().regex(/^\/[A-Za-z0-9/_-]{0,119}$/, 'a path on the guest side, e.g. /').optional(),
+    })
+        .strict()
+        .optional(),
+    /** Each value of the kind column, and the template it is sent with. */
+    kinds: z.record(z.string().min(1).max(40), z.string().min(1).max(80)),
+    producers: z.array(producerSchema).max(16).optional(),
+})
+    .strict();
+/**
+ * One block of a template, in the shape the template store keeps. The `html`
+ * block is refused: its variables are not escaped, and a manifest's template
+ * renders values a stranger typed (a name on a first visit).
+ */
+const emailBlockSchema = z
+    .object({
+    block: z
+        .string()
+        .regex(/^email\.[a-z][a-z0-9-]*$/, 'an email block kind, e.g. email.text')
+        .refine((kind) => kind !== 'email.html', { message: 'an app template may not use the html block' }),
+    id: z.string().min(1).max(60).optional(),
+    label: z.string().min(1).max(120).optional(),
+    data: z.record(z.string(), z.unknown()).optional(),
+})
+    .strict();
+const emailContentSchema = z
+    .object({
+    subject: z.string().min(1).max(200),
+    preheader: z.string().min(1).max(200).optional(),
+    blocks: z.array(emailBlockSchema).min(1).max(40),
+    footer: z.string().min(1).max(1000).optional(),
+})
+    .strict();
+export const emailTemplateSchema = z
+    .object({
+    /** `<app key>-<name>`: an app names only its own templates. */
+    key: z.string().regex(/^[a-z][a-z0-9-]{1,79}$/, 'a template key is kebab-case'),
+    name: textOrLabels,
+    /** The variables it reads, for the editor's list. */
+    vars: z.array(z.string().regex(/^[a-z_]+(\.[a-z_]+)*$/, 'a variable such as patient.name')).max(60).optional(),
+    /** The template in each language it ships, US English always among them. */
+    locales: z
+        .record(bcp47TagSchema, emailContentSchema)
+        .refine((locales) => locales['en-US'] !== undefined, { message: 'a template includes en-US' }),
+})
+    .strict();
+/** Everything in `outbox` and `emailTemplates` that names something undeclared, or does not fit. */
+export function outboxIssues(m, index) {
+    const out = [];
+    const templates = new Set();
+    (m.emailTemplates ?? []).forEach((template, i) => {
+        if (!template.key.startsWith(`${m.key}-`)) {
+            out.push({ path: ['emailTemplates', i, 'key'], message: `an app's template key starts with "${m.key}-"` });
+        }
+        if (templates.has(template.key))
+            out.push({ path: ['emailTemplates', i, 'key'], message: `"${template.key}" is declared twice` });
+        templates.add(template.key);
+    });
+    const box = m.outbox;
+    if (box === undefined) {
+        if (templates.size > 0)
+            out.push({ path: ['emailTemplates'], message: 'templates are sent through an outbox, and this app declares none' });
+        return out;
+    }
+    const at = (...rest) => ['outbox', ...rest];
+    if (index.table(box.table) === undefined) {
+        out.push({ path: at('table'), message: `"${box.table}" is not a table of this app` });
+        return out;
+    }
+    const col = (table, ref, types, path, what) => {
+        if (index.table(table) === undefined) {
+            out.push({ path, message: `"${table}" is not a table of this app` });
+            return undefined;
+        }
+        const found = index.column(table, ref);
+        if (found === undefined)
+            out.push({ path, message: `"${table}" has no column "${ref}"` });
+        else if (types !== null && !types.includes(found.type))
+            out.push({ path, message: `"${table}.${ref}" must be ${what}` });
+        else
+            return found;
+        return undefined;
+    };
+    const fk = (table, ref, target, path) => {
+        const found = col(table, ref, ['fk'], path, 'a foreign key');
+        if (found !== undefined && target !== undefined && found.references !== target) {
+            out.push({ path, message: `"${table}.${ref}" does not point at "${target}"` });
+        }
+        if (found !== undefined && found.nullable !== true && table === box.table) {
+            out.push({ path, message: `"${table}.${ref}" must be nullable: not every email is about one` });
+        }
+        return found;
+    };
+    const condition = (table, cond, path) => {
+        if (cond === undefined)
+            return;
+        const found = col(table, cond.column, null, [...path, 'column'], '');
+        const values = cond.eq !== undefined ? [cond.eq] : (cond.in ?? []);
+        if (found !== undefined)
+            for (const value of values) {
+                if (!valueFits(found, value))
+                    out.push({ path, message: `${JSON.stringify(value)} is not a value of "${table}.${cond.column}"` });
+            }
+        if (found !== undefined && cond.isNull !== undefined && found.nullable !== true) {
+            out.push({ path, message: `"${table}.${cond.column}" is never empty` });
+        }
+    };
+    const kind = col(box.table, box.columns.kind, ['enum'], at('columns', 'kind'), 'an enum of the kinds');
+    const status = col(box.table, box.columns.status, ['enum'], at('columns', 'status'), `an enum of ${OUTBOX_STATUSES.join(', ')}`);
+    if (status !== undefined) {
+        const missing = OUTBOX_STATUSES.filter((value) => !(status.enum ?? []).includes(value));
+        if (missing.length > 0)
+            out.push({ path: at('columns', 'status'), message: `"${box.table}.${status.ref}" lacks ${missing.join(', ')}` });
+    }
+    col(box.table, box.columns.to, ['text'], at('columns', 'to'), 'a text column');
+    if (box.columns.language !== undefined)
+        col(box.table, box.columns.language, ['text'], at('columns', 'language'), 'a text column');
+    if (box.columns.due !== undefined)
+        col(box.table, box.columns.due, ['timestamptz'], at('columns', 'due'), 'a timestamptz');
+    if (box.columns.sentAt !== undefined)
+        col(box.table, box.columns.sentAt, ['timestamptz'], at('columns', 'sentAt'), 'a timestamptz');
+    if (box.columns.error !== undefined)
+        col(box.table, box.columns.error, ['text'], at('columns', 'error'), 'a text column');
+    const linkTargets = new Map();
+    for (const [name, ref] of Object.entries(box.links ?? {})) {
+        linkTargets.set(ref, fk(box.table, ref, undefined, at('links', name))?.references);
+    }
+    const r = box.recipient;
+    fk(box.table, r.via, r.table, at('recipient', 'via'));
+    col(r.table, r.email, ['text'], at('recipient', 'email'), 'a text column');
+    if (r.name !== undefined)
+        col(r.table, r.name, ['text'], at('recipient', 'name'), 'a text column');
+    if (r.language !== undefined)
+        col(r.table, r.language, ['text'], at('recipient', 'language'), 'a text column');
+    if (r.optIn !== undefined)
+        col(r.table, r.optIn, ['bool'], at('recipient', 'optIn'), 'a bool');
+    if (r.fallback !== undefined) {
+        const via = fk(box.table, r.fallback.via, undefined, at('recipient', 'fallback', 'via'));
+        const holder = via?.references;
+        if (holder !== undefined) {
+            col(holder, r.fallback.email, ['text'], at('recipient', 'fallback', 'email'), 'a text column');
+            if (r.fallback.name !== undefined)
+                col(holder, r.fallback.name, ['text'], at('recipient', 'fallback', 'name'), 'a text column');
+            if (r.fallback.language !== undefined)
+                col(holder, r.fallback.language, ['text'], at('recipient', 'fallback', 'language'), 'a text column');
+        }
+    }
+    if (box.settings !== undefined && index.table(box.settings.table) === undefined) {
+        out.push({ path: at('settings', 'table'), message: `"${box.settings.table}" is not a table of this app` });
+    }
+    else if (box.settings !== undefined) {
+        if (box.settings.enabled !== undefined)
+            col(box.settings.table, box.settings.enabled, ['bool'], at('settings', 'enabled'), 'a bool');
+        if (box.settings.name !== undefined)
+            col(box.settings.table, box.settings.name, ['text'], at('settings', 'name'), 'a text column');
+        if (box.settings.phone !== undefined)
+            col(box.settings.table, box.settings.phone, ['text'], at('settings', 'phone'), 'a text column');
+    }
+    for (const [value, template] of Object.entries(box.kinds)) {
+        if (kind !== undefined && !(kind.enum ?? []).includes(value)) {
+            out.push({ path: at('kinds', value), message: `"${value}" is not a value of "${box.table}.${kind.ref}"` });
+        }
+        if (!templates.has(template))
+            out.push({ path: at('kinds', value), message: `"${template}" is not one of the app's emailTemplates` });
+    }
+    (box.producers ?? []).forEach((producer, p) => {
+        const here = (...rest) => at('producers', p, ...rest);
+        if (box.kinds[producer.kind] === undefined)
+            out.push({ path: here('kind'), message: `"${producer.kind}" is not one of the outbox's kinds` });
+        if (producer.gate === 'enabled' && box.settings?.enabled === undefined) {
+            out.push({ path: here('gate'), message: 'the outbox names no settings column to be gated by' });
+        }
+        if (producer.optIn === true && r.optIn === undefined) {
+            out.push({ path: here('optIn'), message: 'the recipient names no opt-in column' });
+        }
+        const source = 'onCreate' in producer ? producer.onCreate : 'onChange' in producer ? producer.onChange : producer.before;
+        if (index.table(source.table) === undefined) {
+            out.push({ path: here(), message: `"${source.table}" is not a table of this app` });
+            return;
+        }
+        if (!linkTargets.has(producer.link)) {
+            out.push({ path: here('link'), message: `"${producer.link}" is not one of the outbox's links` });
+        }
+        else if (linkTargets.get(producer.link) !== undefined && linkTargets.get(producer.link) !== source.table) {
+            out.push({ path: here('link'), message: `"${box.table}.${producer.link}" does not point at "${source.table}"` });
+        }
+        condition(source.table, source.where, here('where'));
+        if ('onChange' in producer) {
+            const change = producer.onChange;
+            const watched = col(change.table, change.column, null, here('onChange', 'column'), '');
+            if (watched !== undefined)
+                for (const value of Array.isArray(change.to) ? change.to : [change.to]) {
+                    if (!valueFits(watched, value))
+                        out.push({ path: here('onChange', 'to'), message: `${JSON.stringify(value)} is not a value of "${change.table}.${change.column}"` });
+                }
+        }
+        if ('before' in producer) {
+            const before = producer.before;
+            col(before.table, before.at, ['timestamptz'], here('before', 'at'), 'a timestamptz');
+            fk(before.table, before.lead.via, before.lead.table, here('before', 'lead', 'via'));
+            col(before.lead.table, before.lead.column, ['int', 'bigint'], here('before', 'lead', 'column'), 'an int');
+            if (before.lead.fallback !== undefined) {
+                col(before.lead.fallback.table, before.lead.fallback.column, ['int', 'bigint'], here('before', 'lead', 'fallback'), 'an int');
+            }
+            if (box.columns.due === undefined) {
+                out.push({ path: here('before'), message: 'a reminder records the moment it leads in the outbox\'s due column, and none is named' });
+            }
+        }
+    });
+    return out;
+}
+//# sourceMappingURL=outbox.js.map

package/dist/outbox.js.map

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

package/dist/page-calendar.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A calendar page's columns: `config.calendar` on a `page-calendar` page.
+ *
+ * Left to itself Adminium plots a calendar by the first date of the table it
+ * reads and titles it with the table's display column — on a table of
+ * appointments that also keeps a first visit's date of birth, every visit
+ * landed on a birthday. An app says which columns instead:
+ *
+ * ```json
+ * "config": { "calendar": { "start": "starts_at", "title": "patient_id.name", "category": "visit_type_id" } }
+ * ```
+ *
+ *  - `start` (required) and `end`: a `date` or `timestamptz` column of the
+ *    page's table;
+ *  - `title`: a column of the page's table, or `<fk column>.<column>` — a
+ *    column of the table that foreign key points at (the patient's name);
+ *  - `category`: a column of the page's table, what the rows are coloured and
+ *    filtered by.
+ *
+ * Every name is the app's own (a column ref), checked here against
+ * `requiredSchema`, so an app's CI refuses a typo long before an install.
+ * Without it, a table with a booking rule is plotted by the booking's `start`.
+ */
+import { z } from 'zod';
+import { type ColumnShape, type ReferenceIssue, type TableIndex } from './refs.js';
+export declare const pageCalendarSchema: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type PageCalendar = z.infer<typeof pageCalendarSchema>;
+/** What the check reads of a page. */
+interface PageShape {
+    template: string;
+    bindings?: Readonly<Record<string, string>> | undefined;
+    config?: Readonly<Record<string, unknown>> | undefined;
+}
+/** Every problem with the pages' `config.calendar`, against the app's own tables. */
+export declare function pageCalendarIssues<C extends ColumnShape>(pages: readonly PageShape[], index: TableIndex<C>): ReferenceIssue[];
+export {};
+//# sourceMappingURL=page-calendar.d.ts.map

package/dist/page-calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-calendar.d.ts","sourceRoot":"","sources":["../src/page-calendar.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAK9F,eAAO,MAAM,kBAAkB;;;;;kBAOpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,sCAAsC;AACtC,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACxD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACxD;AAQD,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,cAAc,EAAE,CA0C7H"}

package/dist/page-calendar.js

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * A calendar page's columns: `config.calendar` on a `page-calendar` page.
+ *
+ * Left to itself Adminium plots a calendar by the first date of the table it
+ * reads and titles it with the table's display column — on a table of
+ * appointments that also keeps a first visit's date of birth, every visit
+ * landed on a birthday. An app says which columns instead:
+ *
+ * ```json
+ * "config": { "calendar": { "start": "starts_at", "title": "patient_id.name", "category": "visit_type_id" } }
+ * ```
+ *
+ *  - `start` (required) and `end`: a `date` or `timestamptz` column of the
+ *    page's table;
+ *  - `title`: a column of the page's table, or `<fk column>.<column>` — a
+ *    column of the table that foreign key points at (the patient's name);
+ *  - `category`: a column of the page's table, what the rows are coloured and
+ *    filtered by.
+ *
+ * Every name is the app's own (a column ref), checked here against
+ * `requiredSchema`, so an app's CI refuses a typo long before an install.
+ * Without it, a table with a booking rule is plotted by the booking's `start`.
+ */
+import { z } from 'zod';
+import { refSchema } from './refs.js';
+/** `patient_id.name`: a column of the table a foreign key points at. */
+const titleSchema = z.string().regex(/^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)?$/, 'a column, or <fk column>.<column>');
+export const pageCalendarSchema = z
+    .object({
+    start: refSchema,
+    end: refSchema.optional(),
+    title: titleSchema.optional(),
+    category: refSchema.optional(),
+})
+    .strict();
+const DATE_TYPES = ['date', 'timestamptz'];
+/** The table a page reads: its one binding, or the one keyed `rows`. */
+function pageTable(page) {
+    const entries = Object.values(page.bindings ?? {});
+    return entries.length === 1 ? entries[0] : page.bindings?.['rows'];
+}
+/** Every problem with the pages' `config.calendar`, against the app's own tables. */
+export function pageCalendarIssues(pages, index) {
+    const out = [];
+    pages.forEach((page, p) => {
+        const raw = page.config?.['calendar'];
+        if (raw === undefined)
+            return;
+        const at = (...rest) => ['pages', p, 'config', 'calendar', ...rest];
+        const parsed = pageCalendarSchema.safeParse(raw);
+        if (!parsed.success) {
+            for (const issue of parsed.error.issues)
+                out.push({ path: at(...issue.path.map((key) => (typeof key === 'symbol' ? String(key) : key))), message: issue.message });
+            return;
+        }
+        if (page.template !== 'page-calendar') {
+            out.push({ path: at(), message: `only a page-calendar plots by named columns, not a ${page.template}` });
+            return;
+        }
+        const table = pageTable(page);
+        if (table === undefined || index.table(table) === undefined) {
+            out.push({ path: at(), message: 'a calendar names its columns on a page bound to a table of the app' });
+            return;
+        }
+        const calendar = parsed.data;
+        for (const key of ['start', 'end']) {
+            const name = calendar[key];
+            if (name === undefined)
+                continue;
+            const column = index.column(table, name);
+            if (column === undefined)
+                out.push({ path: at(key), message: `"${table}" has no column "${name}"` });
+            else if (!DATE_TYPES.includes(column.type))
+                out.push({ path: at(key), message: `"${table}.${name}" is not a date or a timestamptz` });
+        }
+        if (calendar.category !== undefined && !index.has(table, calendar.category)) {
+            out.push({ path: at('category'), message: `"${table}" has no column "${calendar.category}"` });
+        }
+        if (calendar.title !== undefined) {
+            const [own, through] = calendar.title.split('.');
+            const column = index.column(table, own);
+            if (column === undefined)
+                out.push({ path: at('title'), message: `"${table}" has no column "${own}"` });
+            else if (through !== undefined) {
+                if (column.type !== 'fk' || column.references === undefined)
+                    out.push({ path: at('title'), message: `"${table}.${own}" is not a foreign key` });
+                else if (!index.has(column.references, through))
+                    out.push({ path: at('title'), message: `"${column.references}" has no column "${through}"` });
+            }
+        }
+    });
+    return out;
+}
+//# sourceMappingURL=page-calendar.js.map

package/dist/page-calendar.js.map

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

package/dist/plan-context.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Planning an APP install with what the server knows about this connection:
+ * the app's prefix, the tables it already recorded here, what other apps
+ * record here, and the operator's answers for the tables whose names are taken.
+ *
+ * ─── Why a context at all ───────────────────────────────────────────────────
+ *
+ * Without one, a table either exists (reuse) or does not (create), and that
+ * was the whole plan. It could not tell the app's own table from an earlier
+ * install apart from another app's table of the same name, could not offer
+ * to rename a stranger's table out of the way, and could not give an app its
+ * own prefix. Each table is now CLASSIFIED first, then given an ACTION:
+ *
+ *   new           the real name is free                     → create
+ *   own-leftover  this app recorded it (an earlier install) → reuse (default)
+ *   shared        another app recorded it under the SAME shape (`menu@1`)
+ *                                                            → share (default)
+ *   taken         it exists and nothing records it as this app's
+ *                                                            → the operator chooses
+ *
+ * For a taken table the operator chooses: REUSE it (offered only when it is
+ * not another app's in disguise and every change it needs is safe), RENAME the
+ * existing table out of the way (only when no other install records it), or
+ * give the whole app a DIFFERENT PREFIX (always offered, and it applies to
+ * every table at once). Until each taken table has an answer, the plan is not
+ * installable and says which table is waiting.
+ *
+ * ─── Edits ─────────────────────────────────────────────────────────────────
+ *
+ * A reused table may need changes before the app can write to it. Only changes
+ * that cannot lose data are ever offered: adding a missing column (nullable),
+ * widening a type along a fixed list (a longer varchar, varchar to text, int
+ * to bigint, a wider enum column), giving an int key the identity it lacks, and
+ * adding enum values. Anything else is refused on this screen, by name.
+ *
+ * Pure, like the planner it extends: no I/O. The server gathers the context.
+ */
+import type { InstallPlan, PlanContext, SchemaModelView } from './plan-model.js';
+import type { Manifest } from './schema.js';
+export type { ContextTableAction as TableAction, InstallTablePlan, PlanContext, PlanEdit, TableChoice, TableClass, TableOffer, } from './plan-model.js';
+/** The longest identifier each engine accepts, in bytes. SQLite has none; the portable 63 holds. */
+export declare const IDENTIFIER_LIMIT: Readonly<Record<PlanContext['dialect'], number>>;
+/** `adminium_roles.slug` is 40 characters. */
+export declare const ROLE_SLUG_LIMIT = 40;
+/**
+ * The context half of `planInstall`. Called by it when a context is given;
+ * the returned plan keeps every field older callers read (`create`, `reuse`,
+ * `references`, `problems`) and adds `tables` and `names`.
+ */
+export declare function planWithContext(manifest: Manifest, model: SchemaModelView, context: PlanContext): InstallPlan;
+//# sourceMappingURL=plan-context.d.ts.map

package/dist/plan-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-context.d.ts","sourceRoot":"","sources":["../src/plan-context.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAEV,WAAW,EAEX,WAAW,EAEX,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,QAAQ,EAAiC,MAAM,aAAa,CAAC;AAE3E,YAAY,EACV,kBAAkB,IAAI,WAAW,EACjC,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAI7E,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,eAAe,KAAK,CAAC;AAuDlC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,WAAW,GACnB,WAAW,CA0Qb"}