@synoikia/core 0.16.0 → 0.17.1

package/dist/testing/compliance/config.d.ts

@@ -0,0 +1,19 @@
+import type { ViteUserConfig } from 'vitest/config';
+/** The shipped compliance suite: the feature files of core's rules for plugins. */
+export declare const SUITE_DIR: string;
+export interface ComplianceOptions {
+    /** The plugin package directory, holding `manifest.json`, the built entry and `test/compliance.yaml`. */
+    pluginDir: string;
+    /** The plugin's own feature files, relative to `pluginDir`. */
+    features?: string[];
+    /** Step files for the plugin's own feature files, relative to `pluginDir`. */
+    steps?: string[];
+}
+declare module 'vitest' {
+    interface ProvidedContext {
+        synoikiaPluginDir: string;
+        synoikiaFeatureFiles: number;
+    }
+}
+/** The vitest config that runs the compliance suite and the plugin's own feature files, and prints core's verdict. */
+export declare function complianceConfig(opts: ComplianceOptions): ViteUserConfig;

package/dist/testing/compliance/config.js

@@ -0,0 +1,50 @@
+import { globSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { quickpickle } from 'quickpickle';
+import { VerdictReporter } from './verdict.js';
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+/** The shipped compliance suite: the feature files of core's rules for plugins. */
+export const SUITE_DIR = path.join(HERE, 'suite');
+const STEPS = path.join(HERE, `steps${path.extname(fileURLToPath(import.meta.url))}`);
+/** The vitest config that runs the compliance suite and the plugin's own feature files, and prints core's verdict. */
+export function complianceConfig(opts) {
+    const pluginDir = path.resolve(opts.pluginDir);
+    const features = opts.features ?? ['features/**/*.feature'];
+    const files = [
+        ...globSync('*.feature', { cwd: SUITE_DIR }),
+        ...globSync(features, { cwd: pluginDir, exclude: (f) => f === 'node_modules' }),
+    ];
+    return {
+        plugins: [quickpickle({ todoTags: ['@todo', '@wip', '@backlog'], stepTimeout: 60_000 })],
+        test: {
+            reporters: ['default', new VerdictReporter(pluginDir, SUITE_DIR)],
+            projects: [
+                {
+                    extends: true,
+                    test: {
+                        name: 'compliance',
+                        root: pluginDir,
+                        include: [path.join(SUITE_DIR, '*.feature'), ...features],
+                        // Only feature files: the repo's own include of test files would run them in this process too.
+                        exclude: ['**/*.test.ts', '**/*.spec.ts'],
+                        setupFiles: [STEPS, ...(opts.steps ?? []).map((s) => path.resolve(pluginDir, s))],
+                        provide: { synoikiaPluginDir: pluginDir, synoikiaFeatureFiles: files.length },
+                        // Vitest runs the suite's own modules, so the fake module the profile names loads like a test file.
+                        server: { deps: { inline: [/@synoikia[\\/]core[\\/]dist[\\/]testing[\\/]compliance/] } },
+                        // One process runs the feature files one after another, so the plugin boots once for the run.
+                        isolate: false,
+                        fileParallelism: false,
+                        // Its own group, after the plugin's other projects: vitest needs one for a project of one worker.
+                        sequence: { groupOrder: 1 },
+                        // isolated-vm requires --no-node-snapshot on Node >= 20.
+                        execArgv: ['--no-node-snapshot'],
+                        testTimeout: 120_000,
+                        hookTimeout: 120_000,
+                    },
+                },
+            ],
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/testing/compliance/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/testing/compliance/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,mFAAmF;AACnF,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;AAkBtF,sHAAsH;AACtH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG;QACZ,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;QAC5C,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,cAAc,EAAE,CAAC;KAChF,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACxF,IAAI,EAAE;YACJ,SAAS,EAAE,CAAC,SAAS,EAAE,IAAI,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjE,QAAQ,EAAE;gBACR;oBACE,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,QAAQ,CAAC;wBACzD,+FAA+F;wBAC/F,OAAO,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;wBACzC,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;wBACjF,OAAO,EAAE,EAAE,iBAAiB,EAAE,SAAS,EAAE,oBAAoB,EAAE,KAAK,CAAC,MAAM,EAAE;wBAC7E,oGAAoG;wBACpG,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,wDAAwD,CAAC,EAAE,EAAE;wBACxF,8FAA8F;wBAC9F,OAAO,EAAE,KAAK;wBACd,eAAe,EAAE,KAAK;wBACtB,kGAAkG;wBAClG,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE;wBAC3B,yDAAyD;wBACzD,QAAQ,EAAE,CAAC,oBAAoB,CAAC;wBAChC,WAAW,EAAE,OAAO;wBACpB,WAAW,EAAE,OAAO;qBACrB;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/testing/compliance/index.d.ts

@@ -0,0 +1,5 @@
+export { complianceConfig, SUITE_DIR } from './config.js';
+export type { ComplianceOptions } from './config.js';
+export type { ComplianceCall, ComplianceFake, ComplianceProfile } from './profile.js';
+export { complianceSubject } from './run.js';
+export type { ComplianceSubject } from './run.js';

package/dist/testing/compliance/index.js

@@ -0,0 +1,3 @@
+export { complianceConfig, SUITE_DIR } from './config.js';
+export { complianceSubject } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/compliance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/compliance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/testing/compliance/profile.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+/** `test/compliance.yaml` of a plugin: what the compliance suite needs to check it against core's rules. */
+declare const Call: z.ZodObject<{
+    fn: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+    key: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const ProfileSchema: z.ZodObject<{
+    fake: z.ZodOptional<z.ZodString>;
+    connection: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    reads: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        fn: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+        key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    writes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        fn: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+        key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    rejects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        fn: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strict>>>;
+    locks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        fn: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+        key: z.ZodOptional<z.ZodString>;
+        confirm: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    secrets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        fn: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+        key: z.ZodOptional<z.ZodString>;
+        values: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    connectionTest: z.ZodOptional<z.ZodObject<{
+        wrong: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>>;
+    calls: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        fn: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodUnknown>>;
+        key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ComplianceProfile = z.infer<typeof ProfileSchema>;
+export type ComplianceCall = z.infer<typeof Call>;
+/** What the module named by `fake` starts: the fake upstream, with `url` and any other `${fake.<name>}` values. */
+export interface ComplianceFake {
+    url: string;
+    close(): unknown;
+    reset?(): unknown;
+    [name: string]: unknown;
+}
+export declare const PROFILE_FILE: string;
+/** Reads the profile, starts its fake upstream and puts the fake's values in place of each `${fake.<name>}`. */
+export declare function loadProfile(pluginDir: string): Promise<{
+    profile: ComplianceProfile;
+    fake?: ComplianceFake;
+}>;
+export {};

package/dist/testing/compliance/profile.js

@@ -0,0 +1,58 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { parse } from 'yaml';
+import { z } from 'zod';
+/** `test/compliance.yaml` of a plugin: what the compliance suite needs to check it against core's rules. */
+const Call = z.strictObject({ fn: z.string(), args: z.array(z.unknown()).default([]), key: z.string().optional() });
+const ProfileSchema = z.strictObject({
+    fake: z.string().optional(),
+    connection: z.record(z.string(), z.unknown()),
+    reads: z.array(Call).default([]),
+    writes: z.array(Call).default([]),
+    rejects: z.array(Call.omit({ key: true })).default([]),
+    locks: z.record(z.string(), Call.extend({ confirm: z.string(), target: z.string().optional() })).default({}),
+    secrets: z.array(Call.extend({ values: z.array(z.string()) })).default([]),
+    connectionTest: z.strictObject({ wrong: z.record(z.string(), z.unknown()) }).optional(),
+    calls: z.record(z.string(), Call).default({}),
+});
+export const PROFILE_FILE = path.join('test', 'compliance.yaml');
+/** Reads the profile, starts its fake upstream and puts the fake's values in place of each `${fake.<name>}`. */
+export async function loadProfile(pluginDir) {
+    const file = path.join(pluginDir, PROFILE_FILE);
+    const parsed = ProfileSchema.safeParse(parse(readFileSync(file, 'utf8')));
+    if (!parsed.success)
+        throw new Error(`${PROFILE_FILE}: ${z.prettifyError(parsed.error)}`);
+    const fake = parsed.data.fake ? await startFake(pluginDir, parsed.data.fake) : undefined;
+    return { profile: fill(parsed.data, fake ?? { url: '', close: () => undefined }), fake };
+}
+async function startFake(pluginDir, module) {
+    const mod = (await import(pathToFileURL(path.resolve(pluginDir, module)).href));
+    const start = mod.start ?? mod.default?.start;
+    if (!start)
+        throw new Error(`${module} exports no start()`);
+    const fake = await start();
+    if (typeof fake?.url !== 'string')
+        throw new Error(`${module}: start() returned no url`);
+    return fake;
+}
+const PLACEHOLDER = /\$\{fake\.([A-Za-z0-9_]+)\}/g;
+function fill(value, fake) {
+    if (typeof value === 'string') {
+        const whole = /^\$\{fake\.([A-Za-z0-9_]+)\}$/.exec(value);
+        if (whole)
+            return valueOf(fake, whole[1]);
+        return value.replace(PLACEHOLDER, (_m, name) => String(valueOf(fake, name)));
+    }
+    if (Array.isArray(value))
+        return value.map((v) => fill(v, fake));
+    if (value && typeof value === 'object')
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, fill(v, fake)]));
+    return value;
+}
+function valueOf(fake, name) {
+    if (!(name in fake))
+        throw new Error(`${PROFILE_FILE}: the fake has no value "${name}"`);
+    return fake[name];
+}
+//# sourceMappingURL=profile.js.map

package/dist/testing/compliance/profile.js.map

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

package/dist/testing/compliance/run.d.ts

@@ -0,0 +1,19 @@
+import type { PluginHarness } from '../index.js';
+import type { ComplianceFake, ComplianceProfile } from './profile.js';
+/** The plugin under test in a compliance run: its profile, its fake and core's harness. */
+export interface ComplianceSubject {
+    pluginDir: string;
+    profile: ComplianceProfile;
+    fake?: ComplianceFake;
+    harness: PluginHarness;
+}
+/** What the feature files of one run share, kept on `globalThis` because the steps load once for each file. */
+export interface ComplianceRun {
+    ended: number;
+    subject(): Promise<ComplianceSubject>;
+    stop(): Promise<void>;
+}
+export declare const currentRun: () => ComplianceRun | undefined;
+export declare const startRun: (run: ComplianceRun) => ComplianceRun;
+/** The plugin under test, for the step files of a plugin's own feature files. */
+export declare function complianceSubject(): Promise<ComplianceSubject>;

package/dist/testing/compliance/run.js

@@ -0,0 +1,12 @@
+const RUN = Symbol.for('synoikia.compliance.run');
+const holder = globalThis;
+export const currentRun = () => holder[RUN];
+export const startRun = (run) => (holder[RUN] ??= run);
+/** The plugin under test, for the step files of a plugin's own feature files. */
+export function complianceSubject() {
+    const run = currentRun();
+    if (!run)
+        throw new Error('complianceSubject() works only in a run of complianceConfig()');
+    return run.subject();
+}
+//# sourceMappingURL=run.js.map

package/dist/testing/compliance/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/testing/compliance/run.ts"],"names":[],"mappings":"AAkBA,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAClD,MAAM,MAAM,GAAG,UAAuC,CAAC;AAEvD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAkB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;AAEtE,iFAAiF;AACjF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAC3F,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;AACvB,CAAC"}

package/dist/testing/compliance/steps.d.ts

@@ -0,0 +1 @@
+export {};