@adminiumjs/manifest 0.3.0-rc.3 → 0.3.0

package/dist/refs.js

@@ -0,0 +1,70 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * The small shapes every block of a manifest reuses: a snake_case name, a
+ * label in several languages, a number that may come from the app's settings
+ * row, and the structural view of a table the cross-reference checks read.
+ *
+ * A module of its own so `schema.ts` and the blocks split out of it
+ * (`booking.ts`, `outbox.ts`, `public-access.ts`) import one definition
+ * without importing each other.
+ */
+import { z } from 'zod';
+/** A snake_case identifier: a table or column ref. */
+export const refSchema = z.string().regex(/^[a-z][a-z0-9_]*$/, 'must be a snake_case identifier');
+/** A BCP 47 tag, the way every label map in a manifest is keyed (`de-DE`). */
+export const bcp47TagSchema = z.string().regex(/^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$/, 'keyed by BCP 47 tag');
+/** A label in several languages. US English is the one every reader falls back to. */
+export const labelsSchema = z
+    .record(bcp47TagSchema, z.string().min(1).max(120))
+    .refine((labels) => labels['en-US'] !== undefined, { message: 'labels must include en-US' });
+/** A text that is either one string, or the same text in several languages. */
+export const textOrLabels = z.union([z.string().min(1).max(256), labelsSchema]);
+/** One column of the app's one-row settings table, read when the rule runs. */
+export const settingRefSchema = z.object({ table: refSchema, column: refSchema }).strict();
+/**
+ * A number the manifest states, or one the app's own settings row holds — so
+ * a venue can change its capacity without a new release. `{table, column}`
+ * reads the one row of that (one-row) table at write time.
+ */
+export const numberOrSetting = z.union([z.number().int().nonnegative(), settingRefSchema]);
+/** A value a rule compares a column with. */
+export const scalarSchema = z.union([z.string(), z.number(), z.boolean()]);
+/**
+ * Lookups over the manifest's tables, shared by every block's checks so each
+ * says "no such column" the same way.
+ */
+export function tableIndex(tables) {
+    const byRef = new Map(tables.map((t) => [t.ref, t]));
+    const column = (table, ref) => byRef.get(table)?.columns.find((c) => c.ref === ref);
+    return {
+        table: (ref) => byRef.get(ref),
+        column,
+        has: (table, ref) => column(table, ref) !== undefined,
+        /** The table's primary key column, when it declares one. */
+        pk: (table) => byRef.get(table)?.columns.find((c) => c.role === 'pk'),
+    };
+}
+/** Column types a total, a price or a count can be kept in. */
+export const NUMERIC_TYPES = ['int', 'bigint', 'decimal', 'money', 'float'];
+/**
+ * Whether `value` is one a column of this shape can hold: one of an enum's
+ * values, a boolean for a bool, a number for a number, any text for text.
+ */
+export function valueFits(column, value) {
+    switch (column.type) {
+        case 'enum':
+            return typeof value === 'string' && (column.enum ?? []).includes(value);
+        case 'bool':
+            return typeof value === 'boolean';
+        case 'int':
+        case 'bigint':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'decimal':
+        case 'money':
+        case 'float':
+            return typeof value === 'number';
+        default:
+            return typeof value === 'string';
+    }
+}
+//# sourceMappingURL=refs.js.map

package/dist/refs.js.map

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

package/dist/roles.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `roles[].limits` — what a role's `update` on one of the app's tables may
+ * write, when it may not write everything.
+ *
+ * A clinician moves a visit along and does nothing else to it:
+ *
+ * ```json
+ * "limits": {
+ *   "appointments": {
+ *     "writable": ["status"],
+ *     "writableValues": { "status": ["roomed", "with_clinician", "ready"] }
+ *   }
+ * }
+ * ```
+ *
+ * The names are the public-access entries' (`writable`, `writableValues`).
+ * A limit narrows the role's own `table:@<ref>:update`, so a role must grant
+ * that update (itself or through `cloneFrom`) for a limit on the table to
+ * mean anything. Roles add up: someone who also holds a role with a plain
+ * update on the table is not held to the limit. Creating rows is not limited.
+ */
+import { z } from 'zod';
+import { type ColumnShape, type ReferenceIssue, type TableIndex } from './refs.js';
+/** One table's limit. */
+export declare const roleLimitSchema: z.ZodObject<{
+    writable: z.ZodArray<z.ZodString>;
+    writableValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+}, z.core.$strict>;
+export type RoleLimit = z.infer<typeof roleLimitSchema>;
+/** Per table ref, the limit on the role's update there. */
+export declare const roleLimitsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    writable: z.ZodArray<z.ZodString>;
+    writableValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+}, z.core.$strict>>;
+/** What the checks read of a role. */
+export interface RoleShape {
+    key: string;
+    cloneFrom?: string | undefined;
+    permissions?: readonly string[] | undefined;
+    limits?: Readonly<Record<string, RoleLimit>> | undefined;
+}
+/** Every `limits` problem across the app's roles. */
+export declare function roleLimitIssues<C extends ColumnShape>(roles: readonly RoleShape[], index: TableIndex<C>): ReferenceIssue[];
+//# sourceMappingURL=roles.d.ts.map

package/dist/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../src/roles.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAsC,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvH,yBAAyB;AACzB,eAAO,MAAM,eAAe;;;kBAOjB,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB;;;mBAAuC,CAAC;AAErE,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5C,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;CAC1D;AAQD,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,cAAc,EAAE,CA4B1H"}

package/dist/roles.js

@@ -0,0 +1,75 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * `roles[].limits` — what a role's `update` on one of the app's tables may
+ * write, when it may not write everything.
+ *
+ * A clinician moves a visit along and does nothing else to it:
+ *
+ * ```json
+ * "limits": {
+ *   "appointments": {
+ *     "writable": ["status"],
+ *     "writableValues": { "status": ["roomed", "with_clinician", "ready"] }
+ *   }
+ * }
+ * ```
+ *
+ * The names are the public-access entries' (`writable`, `writableValues`).
+ * A limit narrows the role's own `table:@<ref>:update`, so a role must grant
+ * that update (itself or through `cloneFrom`) for a limit on the table to
+ * mean anything. Roles add up: someone who also holds a role with a plain
+ * update on the table is not held to the limit. Creating rows is not limited.
+ */
+import { z } from 'zod';
+import { refSchema, scalarSchema, valueFits } from './refs.js';
+/** One table's limit. */
+export const roleLimitSchema = z
+    .object({
+    /** The only columns the update may change. */
+    writable: z.array(refSchema).min(1),
+    /** For some of those columns, the only values it may set. */
+    writableValues: z.record(refSchema, z.array(scalarSchema).min(1).max(32)).optional(),
+})
+    .strict();
+/** Per table ref, the limit on the role's update there. */
+export const roleLimitsSchema = z.record(refSchema, roleLimitSchema);
+/** The grants a role ends up with: its own and the ones of the role it clones. */
+function grantsOf(role, roles) {
+    const from = role.cloneFrom === undefined ? undefined : roles.find((other) => other.key === role.cloneFrom);
+    return new Set([...(from?.permissions ?? []), ...(role.permissions ?? [])]);
+}
+/** Every `limits` problem across the app's roles. */
+export function roleLimitIssues(roles, index) {
+    const out = [];
+    roles.forEach((role, r) => {
+        const grants = grantsOf(role, roles);
+        for (const [ref, limit] of Object.entries(role.limits ?? {})) {
+            const at = (...rest) => ['roles', r, 'limits', ref, ...rest];
+            if (index.table(ref) === undefined) {
+                out.push({ path: at(), message: `"${ref}" is not a table of this app` });
+                continue;
+            }
+            if (!grants.has(`table:@${ref}:update`)) {
+                out.push({ path: at(), message: `the role does not grant table:@${ref}:update, so there is nothing to limit` });
+            }
+            const writable = new Set(limit.writable);
+            for (const column of limit.writable) {
+                if (index.column(ref, column) === undefined)
+                    out.push({ path: at('writable'), message: `"${ref}" has no column "${column}"` });
+            }
+            for (const [column, values] of Object.entries(limit.writableValues ?? {})) {
+                if (!writable.has(column))
+                    out.push({ path: at('writableValues', column), message: `"${column}" is not writable` });
+                const found = index.column(ref, column);
+                if (found === undefined)
+                    continue;
+                for (const value of values) {
+                    if (!valueFits(found, value))
+                        out.push({ path: at('writableValues', column), message: `${JSON.stringify(value)} is not a value of "${ref}.${column}"` });
+                }
+            }
+        }
+    });
+    return out;
+}
+//# sourceMappingURL=roles.js.map

package/dist/roles.js.map

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

package/dist/sample.d.ts

@@ -0,0 +1,200 @@
+/**
+ * `adminium.sample/1` — an app's sample data, shipped in its package and named
+ * by the manifest's `sampleData.file`.
+ *
+ * Rows are written in the order the tables are listed, parents first, and
+ * removed in reverse. A value is a plain JSON value or one of these directives:
+ *
+ *   `{"@ref": "<label>"}`      the key of an earlier row with that `@label`
+ *   `{"@ago": "PT19M"}`        an ISO-8601 duration before now
+ *   `{"@day": -1, "@time": "09:30"}`   a wall time in the venue's own zone,
+ *                               days from today
+ *   `{"@day": 3}`              a date in the venue's own zone
+ *   `{"@t": {"en-US": "…"}}`   the adding person's language
+ *   `{"@asset": "<label>"}`    a file from `assets`, added to the Files library
+ *
+ * A `@day` may add `"@workdays": true`: its days count Monday to Friday, and
+ * day 0 on a weekend is the Monday after — so "today's" busy day is never a
+ * Saturday.
+ *
+ * A row may carry, beside its `@label`, one ROW directive: `@byClock`
+ * `{at, before, around, after}` merges one of three sets of columns into the
+ * row, by where its time `at` (a column of the row, or a `@day`/`@time`)
+ * falls against the adding moment — more than half an hour before, within
+ * half an hour, or later — so a sample day's statuses match the clock it is
+ * added at. A set with `"@skip": true` leaves the row out (a payment for a
+ * visit that has not happened yet).
+ *
+ * Pure: a format and its checks, no I/O. The server resolves the directives.
+ */
+import { z } from 'zod';
+import type { Manifest } from './schema.js';
+export declare const SAMPLE_FORMAT = "adminium.sample/1";
+/** A column's value: a plain value, a directive, or (for a json column) any object or array. */
+export declare const sampleValueSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodUnion<readonly [z.ZodObject<{
+    '@ref': z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    '@ago': z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    '@day': z.ZodNumber;
+    '@time': z.ZodString;
+    '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>, z.ZodObject<{
+    '@day': z.ZodNumber;
+    '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>, z.ZodObject<{
+    '@t': z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    '@asset': z.ZodString;
+}, z.core.$strict>]>, z.ZodArray<z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+export declare const sampleRowSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodUnion<readonly [z.ZodObject<{
+    '@ref': z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    '@ago': z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    '@day': z.ZodNumber;
+    '@time': z.ZodString;
+    '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>, z.ZodObject<{
+    '@day': z.ZodNumber;
+    '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>, z.ZodObject<{
+    '@t': z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    '@asset': z.ZodString;
+}, z.core.$strict>]>, z.ZodArray<z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+/** `@byClock`: a row's columns by where its time falls against the adding moment. */
+export declare const byClockSchema: z.ZodObject<{
+    at: z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        '@ref': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@ago': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@time': z.ZodString;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@t': z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@asset': z.ZodString;
+    }, z.core.$strict>]>]>;
+    before: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodUnion<readonly [z.ZodObject<{
+        '@ref': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@ago': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@time': z.ZodString;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@t': z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@asset': z.ZodString;
+    }, z.core.$strict>]>, z.ZodArray<z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+    around: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodUnion<readonly [z.ZodObject<{
+        '@ref': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@ago': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@time': z.ZodString;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@t': z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@asset': z.ZodString;
+    }, z.core.$strict>]>, z.ZodArray<z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+    after: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodUnion<readonly [z.ZodObject<{
+        '@ref': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@ago': z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@time': z.ZodString;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@day': z.ZodNumber;
+        '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@t': z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        '@asset': z.ZodString;
+    }, z.core.$strict>]>, z.ZodArray<z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+}, z.core.$strict>;
+export type ByClock = z.infer<typeof byClockSchema>;
+/** The keys of a row that are directives about the row, not columns. */
+export declare const ROW_DIRECTIVES: ReadonlySet<string>;
+export declare const sampleBundleSchema: z.ZodObject<{
+    format: z.ZodLiteral<"adminium.sample/1">;
+    app: z.ZodString;
+    assets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        file: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>>;
+    tables: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodUnion<readonly [z.ZodObject<{
+            '@ref': z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            '@ago': z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            '@day': z.ZodNumber;
+            '@time': z.ZodString;
+            '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>, z.ZodObject<{
+            '@day': z.ZodNumber;
+            '@workdays': z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>, z.ZodObject<{
+            '@t': z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            '@asset': z.ZodString;
+        }, z.core.$strict>]>, z.ZodArray<z.ZodUnknown>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SampleBundle = z.infer<typeof sampleBundleSchema>;
+export type SampleValue = z.infer<typeof sampleValueSchema>;
+/** A value's directive, when it is one. */
+export declare function sampleDirective(value: unknown): {
+    kind: 'ref';
+    label: string;
+} | {
+    kind: 'ago';
+    duration: string;
+} | {
+    kind: 'wall';
+    day: number;
+    time: string;
+    workdays: boolean;
+} | {
+    kind: 'date';
+    day: number;
+    workdays: boolean;
+} | {
+    kind: 't';
+    texts: Record<string, string>;
+} | {
+    kind: 'asset';
+    label: string;
+} | null;
+/** An ISO-8601 duration in milliseconds. */
+export declare function isoDurationMs(duration: string): number;
+export interface SampleIssue {
+    path: string;
+    message: string;
+}
+/**
+ * Everything wrong with a bundle for this manifest: a table it does not
+ * declare, a column the table does not have, a label used twice, a `@ref` to
+ * a row that comes later or not at all, an `@asset` it does not list.
+ */
+export declare function sampleBundleIssues(bundle: SampleBundle, manifest: Manifest): SampleIssue[];
+//# sourceMappingURL=sample.d.ts.map

package/dist/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../src/sample.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAwBjD,gGAAgG;AAChG,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;wFAAuF,CAAC;AAEtH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;yFAA0C,CAAC;AAKvE,qFAAqF;AACrF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQf,CAAC;AACZ,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEnF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAC1C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC,IAAI,CAcP;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,EAAE,CAqF1F"}

package/dist/sample.js

@@ -0,0 +1,208 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * `adminium.sample/1` — an app's sample data, shipped in its package and named
+ * by the manifest's `sampleData.file`.
+ *
+ * Rows are written in the order the tables are listed, parents first, and
+ * removed in reverse. A value is a plain JSON value or one of these directives:
+ *
+ *   `{"@ref": "<label>"}`      the key of an earlier row with that `@label`
+ *   `{"@ago": "PT19M"}`        an ISO-8601 duration before now
+ *   `{"@day": -1, "@time": "09:30"}`   a wall time in the venue's own zone,
+ *                               days from today
+ *   `{"@day": 3}`              a date in the venue's own zone
+ *   `{"@t": {"en-US": "…"}}`   the adding person's language
+ *   `{"@asset": "<label>"}`    a file from `assets`, added to the Files library
+ *
+ * A `@day` may add `"@workdays": true`: its days count Monday to Friday, and
+ * day 0 on a weekend is the Monday after — so "today's" busy day is never a
+ * Saturday.
+ *
+ * A row may carry, beside its `@label`, one ROW directive: `@byClock`
+ * `{at, before, around, after}` merges one of three sets of columns into the
+ * row, by where its time `at` (a column of the row, or a `@day`/`@time`)
+ * falls against the adding moment — more than half an hour before, within
+ * half an hour, or later — so a sample day's statuses match the clock it is
+ * added at. A set with `"@skip": true` leaves the row out (a payment for a
+ * visit that has not happened yet).
+ *
+ * Pure: a format and its checks, no I/O. The server resolves the directives.
+ */
+import { z } from 'zod';
+export const SAMPLE_FORMAT = 'adminium.sample/1';
+const label = z.string().regex(/^[A-Za-z0-9][A-Za-z0-9:._-]{0,95}$/, 'a label of letters, digits and : . _ -');
+/** `P[nW][nD][T[nH][nM][nS]]`, with at least one part. */
+const ISO_DURATION = /^P(?!$)(\d+W)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+(\.\d+)?S)?)?$/;
+const directive = z.union([
+    z.object({ '@ref': label }).strict(),
+    z.object({ '@ago': z.string().regex(ISO_DURATION, 'an ISO-8601 duration such as PT19M') }).strict(),
+    z
+        .object({
+        '@day': z.number().int().min(-366).max(366),
+        '@time': z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, 'a time such as 09:30'),
+        '@workdays': z.literal(true).optional(),
+    })
+        .strict(),
+    z.object({ '@day': z.number().int().min(-366).max(366), '@workdays': z.literal(true).optional() }).strict(),
+    z.object({ '@t': z.record(z.string().regex(/^[a-z]{2}(-[A-Z]{2})?$/), z.string()).refine((m) => Object.keys(m).length > 0) }).strict(),
+    z.object({ '@asset': label }).strict(),
+]);
+const plain = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+/** A column's value: a plain value, a directive, or (for a json column) any object or array. */
+export const sampleValueSchema = z.union([plain, directive, z.array(z.unknown()), z.record(z.string(), z.unknown())]);
+export const sampleRowSchema = z.record(z.string(), sampleValueSchema);
+/** One of `@byClock`'s three sets: columns to merge, or `"@skip": true` to leave the row out. */
+const clockBranchSchema = z.record(z.string(), sampleValueSchema);
+/** `@byClock`: a row's columns by where its time falls against the adding moment. */
+export const byClockSchema = z
+    .object({
+    /** A column of the row holding its time, or the time itself. */
+    at: z.union([z.string().min(1), directive]),
+    before: clockBranchSchema.optional(),
+    around: clockBranchSchema.optional(),
+    after: clockBranchSchema.optional(),
+})
+    .strict();
+/** The keys of a row that are directives about the row, not columns. */
+export const ROW_DIRECTIVES = new Set(['@label', '@byClock']);
+export const sampleBundleSchema = z
+    .object({
+    format: z.literal(SAMPLE_FORMAT),
+    app: z.string().min(1),
+    assets: z
+        .record(label, z.object({ file: z.string().regex(/^seeds\/[a-z0-9][a-z0-9._/-]*$/), sha256: z.string().regex(/^[a-f0-9]{64}$/) }).strict())
+        .default({}),
+    tables: z
+        .array(z.object({ ref: z.string().min(1), rows: z.array(sampleRowSchema).min(1).max(5000) }).strict())
+        .min(1),
+})
+    .strict();
+/** A value's directive, when it is one. */
+export function sampleDirective(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return null;
+    const record = value;
+    if (typeof record['@ref'] === 'string')
+        return { kind: 'ref', label: record['@ref'] };
+    if (typeof record['@ago'] === 'string')
+        return { kind: 'ago', duration: record['@ago'] };
+    if (typeof record['@day'] === 'number' && typeof record['@time'] === 'string') {
+        return { kind: 'wall', day: record['@day'], time: record['@time'], workdays: record['@workdays'] === true };
+    }
+    if (typeof record['@day'] === 'number')
+        return { kind: 'date', day: record['@day'], workdays: record['@workdays'] === true };
+    if (typeof record['@t'] === 'object' && record['@t'] !== null) {
+        return { kind: 't', texts: record['@t'] };
+    }
+    if (typeof record['@asset'] === 'string')
+        return { kind: 'asset', label: record['@asset'] };
+    return null;
+}
+/** An ISO-8601 duration in milliseconds. */
+export function isoDurationMs(duration) {
+    const match = ISO_DURATION.exec(duration);
+    if (match === null)
+        throw new Error(`"${duration}" is not an ISO-8601 duration`);
+    const n = (part) => (part === undefined ? 0 : Number.parseFloat(part));
+    const weeks = n(match[1]);
+    const days = n(match[2]);
+    const hours = n(match[4]);
+    const minutes = n(match[5]);
+    const seconds = n(match[6]);
+    return ((((weeks * 7 + days) * 24 + hours) * 60 + minutes) * 60 + seconds) * 1000;
+}
+/**
+ * Everything wrong with a bundle for this manifest: a table it does not
+ * declare, a column the table does not have, a label used twice, a `@ref` to
+ * a row that comes later or not at all, an `@asset` it does not list.
+ */
+export function sampleBundleIssues(bundle, manifest) {
+    const issues = [];
+    if (bundle.app !== manifest.key) {
+        issues.push({ path: 'app', message: `The bundle is for "${bundle.app}", not "${manifest.key}".` });
+    }
+    const declared = new Map((manifest.requiredSchema?.tables ?? []).map((table) => [table.ref, table]));
+    const seen = new Set();
+    for (const [t, table] of bundle.tables.entries()) {
+        const shape = declared.get(table.ref);
+        if (shape === undefined) {
+            issues.push({ path: `tables.${String(t)}.ref`, message: `"${table.ref}" is not a table this app declares.` });
+            continue;
+        }
+        const columns = new Set(shape.columns.map((column) => column.ref));
+        for (const [r, row] of table.rows.entries()) {
+            const at = `tables.${String(t)}.rows.${String(r)}`;
+            for (const [column, value] of Object.entries(row)) {
+                if (column === '@label') {
+                    if (typeof value !== 'string' || !label.safeParse(value).success) {
+                        issues.push({ path: `${at}.@label`, message: 'A label is letters, digits and : . _ -.' });
+                    }
+                    else if (seen.has(value)) {
+                        issues.push({ path: `${at}.@label`, message: `The label "${value}" is used twice.` });
+                    }
+                    continue;
+                }
+                if (column === '@byClock') {
+                    const clock = byClockSchema.safeParse(value);
+                    if (!clock.success) {
+                        issues.push({ path: `${at}.@byClock`, message: '@byClock names its time (`at`) and up to three sets: before, around, after.' });
+                        continue;
+                    }
+                    const when = clock.data.at;
+                    if (typeof when === 'string' && !(columns.has(when) && when in row)) {
+                        issues.push({ path: `${at}.@byClock.at`, message: `"${when}" is not a column this row sets.` });
+                    }
+                    else if (typeof when !== 'string' && sampleDirective(when)?.kind !== 'wall') {
+                        issues.push({ path: `${at}.@byClock.at`, message: 'The time is a column of the row or a `@day` with a `@time`.' });
+                    }
+                    for (const branch of ['before', 'around', 'after']) {
+                        for (const [name, part] of Object.entries(clock.data[branch] ?? {})) {
+                            if (name === '@skip') {
+                                if (part !== true)
+                                    issues.push({ path: `${at}.@byClock.${branch}.@skip`, message: '"@skip" is true, or absent.' });
+                                continue;
+                            }
+                            if (!columns.has(name))
+                                issues.push({ path: `${at}.@byClock.${branch}.${name}`, message: `"${table.ref}" has no column "${name}".` });
+                            const found = sampleDirective(part);
+                            if (found?.kind === 'ref' && !seen.has(found.label)) {
+                                issues.push({ path: `${at}.@byClock.${branch}.${name}`, message: `"${found.label}" is not an earlier row: a referenced row must come first.` });
+                            }
+                        }
+                    }
+                    continue;
+                }
+                if (!columns.has(column)) {
+                    issues.push({ path: `${at}.${column}`, message: `"${table.ref}" has no column "${column}".` });
+                    continue;
+                }
+                // An object that looks like a directive must BE one: a malformed
+                // `@ago` would otherwise be written into the column as JSON.
+                if (typeof value === 'object' &&
+                    value !== null &&
+                    !Array.isArray(value) &&
+                    Object.keys(value).some((key) => key.startsWith('@')) &&
+                    !directive.safeParse(value).success) {
+                    issues.push({ path: `${at}.${column}`, message: `"${column}" holds a directive that is not well formed.` });
+                    continue;
+                }
+                const found = sampleDirective(value);
+                if (found?.kind === 'ref' && !seen.has(found.label)) {
+                    issues.push({
+                        path: `${at}.${column}`,
+                        message: `"${found.label}" is not an earlier row: a referenced row must come first.`,
+                    });
+                }
+                if (found?.kind === 'asset' && bundle.assets[found.label] === undefined) {
+                    issues.push({ path: `${at}.${column}`, message: `"${found.label}" is not one of the bundle’s assets.` });
+                }
+            }
+            // Labelled AFTER its own values are checked: a row cannot refer to itself.
+            const own = row['@label'];
+            if (typeof own === 'string')
+                seen.add(own);
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=sample.js.map

package/dist/sample.js.map

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