@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.3

package/dist/testing/index.js

@@ -0,0 +1,32 @@
+"use strict";
+// `@marinoscar/platform-api/testing`: the conformance harness. Documented in ./README.md.
+//
+// Peer-free on purpose: nothing under src/testing imports Jest or Vitest, so
+// one harness serves the Jest API and the Vitest web and CLI apps
+// (test/testing/peer-free.spec.ts).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSchemaText = exports.readSchemaDatamodel = exports.parsePrismaSchema = exports.effectiveOnDelete = exports.userOwnedDataSuite = exports.TEST_REQUIRED_PERMISSIONS_KEY = exports.TEST_PERMISSIONS_HEADER = exports.InMemorySystemSettingsStore = exports.InMemoryAuditSink = exports.createTestPlatformHost = exports.cronEnqueueOnlySuite = exports.conformanceSuites = exports.runPlatformConformance = void 0;
+var run_platform_conformance_1 = require("./run-platform-conformance");
+Object.defineProperty(exports, "runPlatformConformance", { enumerable: true, get: function () { return run_platform_conformance_1.runPlatformConformance; } });
+var conformance_suites_1 = require("./conformance-suites");
+Object.defineProperty(exports, "conformanceSuites", { enumerable: true, get: function () { return conformance_suites_1.conformanceSuites; } });
+var cron_enqueue_only_1 = require("./suites/cron-enqueue-only");
+Object.defineProperty(exports, "cronEnqueueOnlySuite", { enumerable: true, get: function () { return cron_enqueue_only_1.cronEnqueueOnlySuite; } });
+// Test doubles for the host ports (issue #696): a header-driven platform host
+// and in-memory audit and settings ports, for PACKAGE tests only.
+var index_1 = require("./host/index");
+Object.defineProperty(exports, "createTestPlatformHost", { enumerable: true, get: function () { return index_1.createTestPlatformHost; } });
+Object.defineProperty(exports, "InMemoryAuditSink", { enumerable: true, get: function () { return index_1.InMemoryAuditSink; } });
+Object.defineProperty(exports, "InMemorySystemSettingsStore", { enumerable: true, get: function () { return index_1.InMemorySystemSettingsStore; } });
+Object.defineProperty(exports, "TEST_PERMISSIONS_HEADER", { enumerable: true, get: function () { return index_1.TEST_PERMISSIONS_HEADER; } });
+Object.defineProperty(exports, "TEST_REQUIRED_PERMISSIONS_KEY", { enumerable: true, get: function () { return index_1.TEST_REQUIRED_PERMISSIONS_KEY; } });
+// The `user-owned-data` suite (issue #699; origin #688) and the small Prisma
+// schema reader behind it (models, fields, relations, onDelete).
+var user_owned_data_1 = require("./suites/user-owned-data");
+Object.defineProperty(exports, "userOwnedDataSuite", { enumerable: true, get: function () { return user_owned_data_1.userOwnedDataSuite; } });
+var prisma_schema_1 = require("./prisma-schema");
+Object.defineProperty(exports, "effectiveOnDelete", { enumerable: true, get: function () { return prisma_schema_1.effectiveOnDelete; } });
+Object.defineProperty(exports, "parsePrismaSchema", { enumerable: true, get: function () { return prisma_schema_1.parsePrismaSchema; } });
+Object.defineProperty(exports, "readSchemaDatamodel", { enumerable: true, get: function () { return prisma_schema_1.readSchemaDatamodel; } });
+Object.defineProperty(exports, "readSchemaText", { enumerable: true, get: function () { return prisma_schema_1.readSchemaText; } });
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";AAAA,0FAA0F;AAC1F,EAAE;AACF,6EAA6E;AAC7E,kEAAkE;AAClE,oCAAoC;;;AAEpC,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAE/B,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAS1B,gEAAkE;AAAzD,yHAAA,oBAAoB,OAAA;AAG7B,8EAA8E;AAC9E,kEAAkE;AAClE,sCAMsB;AALpB,+GAAA,sBAAsB,OAAA;AACtB,0GAAA,iBAAiB,OAAA;AACjB,oHAAA,2BAA2B,OAAA;AAC3B,gHAAA,uBAAuB,OAAA;AACvB,sHAAA,6BAA6B,OAAA;AAG/B,6EAA6E;AAC7E,iEAAiE;AACjE,4DAA8D;AAArD,qHAAA,kBAAkB,OAAA;AAE3B,iDAA4G;AAAnG,kHAAA,iBAAiB,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAAE,+GAAA,cAAc,OAAA"}

package/dist/testing/prisma-schema.d.ts

@@ -0,0 +1,99 @@
+/**
+ * A relation's arguments, as written in `@relation(...)`.
+ *
+ * @stability experimental
+ */
+export interface DatamodelRelation {
+    /** The relation name, when one is given (`@relation("Name", ...)` or `name: "Name"`). */
+    readonly name?: string;
+    /** Foreign key fields on this side; empty on the back-relation side. */
+    readonly fields: readonly string[];
+    /** The referenced fields on the other model. */
+    readonly references: readonly string[];
+    /** The `onDelete` written in the schema, if any. See {@link effectiveOnDelete}. */
+    readonly onDelete?: string;
+}
+/**
+ * One field of a parsed model.
+ *
+ * @stability experimental
+ */
+export interface DatamodelField {
+    /** The field name. */
+    readonly name: string;
+    /** The type name without `?` or `[]`: `String`, `User`, `Role`... */
+    readonly type: string;
+    /** Whether the type ends in `[]`. */
+    readonly isList: boolean;
+    /** Whether the type ends in `?`. */
+    readonly isOptional: boolean;
+    /** Present when the field has a `@relation(...)` attribute. */
+    readonly relation?: DatamodelRelation;
+}
+/**
+ * One parsed model.
+ *
+ * @stability experimental
+ */
+export interface DatamodelModel {
+    /** The model name. */
+    readonly name: string;
+    /** Its fields, in schema order. */
+    readonly fields: readonly DatamodelField[];
+}
+/** Removes a `//` comment (including `///` doc comments), ignoring `//` inside a string literal. */
+export declare function stripLineComment(line: string): string;
+/**
+ * Parses the models of a Prisma schema.
+ *
+ * @param source - the schema text (one file, or several joined).
+ * @returns the models in schema order; enums, views, generators and datasources are skipped.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * parsePrismaSchema('model Note {\n  id String @id\n}').map((m) => m.name); // ['Note']
+ * ```
+ */
+export declare function parsePrismaSchema(source: string): DatamodelModel[];
+/**
+ * The text of a schema: one file, or every `*.prisma` file of a folder in
+ * name order (the order Prisma loads them, which is the order of the
+ * generated client's models).
+ *
+ * @param path - a `schema.prisma` file or a folder of `*.prisma` files.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * const text = readSchemaText(join(__dirname, '..', '..', 'prisma', 'schema'));
+ * ```
+ */
+export declare function readSchemaText(path: string): string;
+/**
+ * The models of the schema at `path` (a file or a folder).
+ *
+ * @param path - see {@link readSchemaText}.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * const models = readSchemaDatamodel(join(__dirname, '..', '..', 'prisma', 'schema'));
+ * ```
+ */
+export declare function readSchemaDatamodel(path: string): DatamodelModel[];
+/**
+ * The referential action Postgres actually applies: the one written, or
+ * Prisma's default (`SetNull` for an optional relation, `Restrict` for a
+ * required one).
+ *
+ * @param field - a relation field.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * effectiveOnDelete({ name: 'user', type: 'User', isList: false, isOptional: true, relation: { fields: ['userId'], references: ['id'] } }); // 'SetNull'
+ * ```
+ */
+export declare function effectiveOnDelete(field: DatamodelField): string;
+//# sourceMappingURL=prisma-schema.d.ts.map

package/dist/testing/prisma-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-schema.d.ts","sourceRoot":"","sources":["../../src/testing/prisma-schema.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAarD;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAyClE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAElE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE/D"}

package/dist/testing/prisma-schema.js

@@ -0,0 +1,175 @@
+"use strict";
+// =============================================================================
+// A minimal reader for a Prisma schema's models and relations (#688, moved to
+// the testing slice by #699)
+// =============================================================================
+//
+// WHY PARSE THE FILE: the `userOwnedData` suite needs each relation's foreign
+// key fields and `onDelete`. Prisma 7's generated client still exports
+// `Prisma.dmmf.datamodel`, but its relation fields carry only `name`, `kind`,
+// `type` and `relationName`: no `relationFromFields`, no `relationOnDelete`.
+// The schema file is the only place they are written down. Parsing it also
+// keeps this package free of any generated client and of `@prisma/internals`.
+//
+// Deliberately small: models, their fields, and `@relation(...)` arguments.
+// Enums, views, generators, datasources and block attributes (`@@...`) are
+// skipped. `extend model` blocks are not read (the app's composed schema has
+// none). The package's spec pins what it understands; the reference app's
+// apps/api/test/prisma/schema-datamodel.spec.ts proves it agrees with the
+// generated client on the real schema.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripLineComment = stripLineComment;
+exports.parsePrismaSchema = parsePrismaSchema;
+exports.readSchemaText = readSchemaText;
+exports.readSchemaDatamodel = readSchemaDatamodel;
+exports.effectiveOnDelete = effectiveOnDelete;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** Removes a `//` comment (including `///` doc comments), ignoring `//` inside a string literal. */
+function stripLineComment(line) {
+    let inString = false;
+    for (let i = 0; i < line.length; i += 1) {
+        const ch = line[i];
+        if (ch === '\\' && inString) {
+            i += 1;
+        }
+        else if (ch === '"') {
+            inString = !inString;
+        }
+        else if (!inString && ch === '/' && line[i + 1] === '/') {
+            return line.slice(0, i);
+        }
+    }
+    return line;
+}
+function listArgument(args, key) {
+    const match = new RegExp(`\\b${key}\\s*:\\s*\\[([^\\]]*)\\]`).exec(args);
+    if (!match)
+        return [];
+    return match[1]
+        .split(',')
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+function parseRelation(attributes) {
+    const match = /@relation\(([^)]*)\)/.exec(attributes);
+    if (!match) {
+        return /@relation\b/.test(attributes) ? { fields: [], references: [] } : undefined;
+    }
+    const args = match[1];
+    const named = /\bname\s*:\s*"([^"]*)"/.exec(args) ?? /^\s*"([^"]*)"/.exec(args);
+    const onDelete = /\bonDelete\s*:\s*(\w+)/.exec(args);
+    return {
+        ...(named ? { name: named[1] } : {}),
+        fields: listArgument(args, 'fields'),
+        references: listArgument(args, 'references'),
+        ...(onDelete ? { onDelete: onDelete[1] } : {}),
+    };
+}
+/**
+ * Parses the models of a Prisma schema.
+ *
+ * @param source - the schema text (one file, or several joined).
+ * @returns the models in schema order; enums, views, generators and datasources are skipped.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * parsePrismaSchema('model Note {\n  id String @id\n}').map((m) => m.name); // ['Note']
+ * ```
+ */
+function parsePrismaSchema(source) {
+    const models = [];
+    let current;
+    let otherBlock = false;
+    for (const raw of source.split(/\r?\n/)) {
+        const line = stripLineComment(raw).trim();
+        if (line === '')
+            continue;
+        if (current === undefined && !otherBlock) {
+            const model = /^model\s+(\w+)\s*\{$/.exec(line);
+            if (model) {
+                current = { name: model[1], fields: [] };
+            }
+            else if (/^\w+\s+\w+\s*\{$/.test(line)) {
+                otherBlock = true; // enum, view, type, generator, datasource
+            }
+            continue;
+        }
+        if (line === '}') {
+            if (current)
+                models.push(current);
+            current = undefined;
+            otherBlock = false;
+            continue;
+        }
+        if (otherBlock || current === undefined || line.startsWith('@@'))
+            continue;
+        const field = /^(\w+)\s+(\w+)(\[\])?(\?)?(.*)$/.exec(line);
+        if (!field)
+            continue;
+        const relation = parseRelation(field[5]);
+        current.fields.push({
+            name: field[1],
+            type: field[2],
+            isList: field[3] === '[]',
+            isOptional: field[4] === '?',
+            ...(relation ? { relation } : {}),
+        });
+    }
+    return models;
+}
+/**
+ * The text of a schema: one file, or every `*.prisma` file of a folder in
+ * name order (the order Prisma loads them, which is the order of the
+ * generated client's models).
+ *
+ * @param path - a `schema.prisma` file or a folder of `*.prisma` files.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * const text = readSchemaText(join(__dirname, '..', '..', 'prisma', 'schema'));
+ * ```
+ */
+function readSchemaText(path) {
+    if (!(0, node_fs_1.statSync)(path).isDirectory())
+        return (0, node_fs_1.readFileSync)(path, 'utf8');
+    return (0, node_fs_1.readdirSync)(path)
+        .filter((name) => name.endsWith('.prisma'))
+        .sort()
+        .map((name) => (0, node_fs_1.readFileSync)((0, node_path_1.join)(path, name), 'utf8'))
+        .join('\n');
+}
+/**
+ * The models of the schema at `path` (a file or a folder).
+ *
+ * @param path - see {@link readSchemaText}.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * const models = readSchemaDatamodel(join(__dirname, '..', '..', 'prisma', 'schema'));
+ * ```
+ */
+function readSchemaDatamodel(path) {
+    return parsePrismaSchema(readSchemaText(path));
+}
+/**
+ * The referential action Postgres actually applies: the one written, or
+ * Prisma's default (`SetNull` for an optional relation, `Restrict` for a
+ * required one).
+ *
+ * @param field - a relation field.
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * effectiveOnDelete({ name: 'user', type: 'User', isList: false, isOptional: true, relation: { fields: ['userId'], references: ['id'] } }); // 'SetNull'
+ * ```
+ */
+function effectiveOnDelete(field) {
+    return field.relation?.onDelete ?? (field.isOptional ? 'SetNull' : 'Restrict');
+}
+//# sourceMappingURL=prisma-schema.js.map

package/dist/testing/prisma-schema.js.map

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

package/dist/testing/run-platform-conformance.d.ts

@@ -0,0 +1,70 @@
+import type { ConformanceTestApi } from './conformance-suite';
+import type { CronEnqueueOnlyOptions } from './suites/cron-enqueue-only';
+import type { UserOwnedDataOptions } from './suites/user-owned-data';
+/**
+ * The suites {@link runPlatformConformance} can run, by option key: each
+ * entry is the suite's options, or `false` to opt out. An interface so a slice
+ * that ships a suite adds its key by module augmentation (the telemetry slice's
+ * `telemetry`, declared in `@marinoscar/platform-api/telemetry/testing`) and
+ * the runner is not edited.
+ *
+ * @example
+ * ```ts
+ * declare module '@marinoscar/platform-api/testing' {
+ *   interface PlatformConformanceSuiteOptions {
+ *     myFeature?: MyFeatureOptions | false;
+ *   }
+ * }
+ * ```
+ *
+ * @stability experimental
+ */
+export interface PlatformConformanceSuiteOptions {
+    /** The `cron-enqueue-only` suite: its options, or `false` to opt out. */
+    cronEnqueueOnly?: CronEnqueueOnlyOptions | false;
+    /** The `user-owned-data` suite: its options, or `false` to opt out. */
+    userOwnedData?: UserOwnedDataOptions | false;
+}
+/**
+ * What an app passes to {@link runPlatformConformance}.
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface PlatformConformanceOptions {
+    /** Absolute directories holding the app's non-test TypeScript sources, for example `[join(__dirname, '../../src')]`. */
+    sourceRoots: readonly string[];
+    /**
+     * One entry per suite. Pass the suite's options to run it, or `false` to
+     * opt out (the opt-out stays visible in the test output). A suite left out
+     * does not run; an unknown key throws, so a typo cannot disable a check.
+     * A suite that ships with a slice is registered by importing that slice's
+     * testing entry (the telemetry suite: `@marinoscar/platform-api/telemetry/testing`).
+     */
+    suites: PlatformConformanceSuiteOptions;
+    /** Defaults to the globals `describe`/`it`/`expect` (Jest, or Vitest with `globals: true`). */
+    testApi?: ConformanceTestApi;
+}
+/**
+ * Registers one `describe` block per enabled conformance suite. Call it at the
+ * top level of a spec file; the app keeps its own data (exemptions, minimums)
+ * and the package owns the scan.
+ *
+ * @param options - see {@link PlatformConformanceOptions}.
+ * @throws Error `unknown conformance suite` when `options.suites` names a suite that is not registered.
+ * @throws Error when no test API is available, or `sourceRoots` is empty.
+ *
+ * @example
+ * ```ts
+ * // apps/api/test/jobs/cron-enqueue-only.spec.ts
+ * runPlatformConformance({
+ *   sourceRoots: [join(__dirname, '..', '..', 'src')],
+ *   suites: { cronEnqueueOnly: { exempt: EXEMPT, minCronFiles: 8 } },
+ * });
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export declare function runPlatformConformance(options: PlatformConformanceOptions): void;
+//# sourceMappingURL=run-platform-conformance.d.ts.map

package/dist/testing/run-platform-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-platform-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/run-platform-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,+BAA+B;IAC9C,yEAAyE;IACzE,eAAe,CAAC,EAAE,sBAAsB,GAAG,KAAK,CAAC;IACjD,uEAAuE;IACvE,aAAa,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,wHAAwH;IACxH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;;OAMG;IACH,MAAM,EAAE,+BAA+B,CAAC;IACxC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAkBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CA+ChF"}

package/dist/testing/run-platform-conformance.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPlatformConformance = runPlatformConformance;
+const conformance_suites_1 = require("./conformance-suites");
+/** `cronEnqueueOnly` for `cron-enqueue-only`: how the app spells a suite id. */
+function optionKeyOf(id) {
+    return id.replace(/-([a-z0-9])/g, (_match, char) => char.toUpperCase());
+}
+/** The runner's own globals, or a clear error when there are none. */
+function globalTestApi() {
+    const g = globalThis;
+    if (typeof g.describe !== 'function' || typeof g.it !== 'function' || typeof g.expect !== 'function') {
+        throw new Error('runPlatformConformance: no global describe/it/expect. Run it under Jest, under Vitest with `globals: true`, or pass `testApi`.');
+    }
+    return { describe: g.describe, it: g.it, expect: g.expect };
+}
+/**
+ * Registers one `describe` block per enabled conformance suite. Call it at the
+ * top level of a spec file; the app keeps its own data (exemptions, minimums)
+ * and the package owns the scan.
+ *
+ * @param options - see {@link PlatformConformanceOptions}.
+ * @throws Error `unknown conformance suite` when `options.suites` names a suite that is not registered.
+ * @throws Error when no test API is available, or `sourceRoots` is empty.
+ *
+ * @example
+ * ```ts
+ * // apps/api/test/jobs/cron-enqueue-only.spec.ts
+ * runPlatformConformance({
+ *   sourceRoots: [join(__dirname, '..', '..', 'src')],
+ *   suites: { cronEnqueueOnly: { exempt: EXEMPT, minCronFiles: 8 } },
+ * });
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+function runPlatformConformance(options) {
+    conformance_suites_1.conformanceSuites.freeze();
+    const byOptionKey = new Map(conformance_suites_1.conformanceSuites.list().map((suite) => [optionKeyOf(suite.id), suite]));
+    const requested = Object.entries(options.suites);
+    for (const [key] of requested) {
+        if (!byOptionKey.has(key)) {
+            throw new Error(`runPlatformConformance: unknown conformance suite "${key}". Known suites: ${[...byOptionKey.keys()].join(', ') || '(none)'}. ` +
+                "A suite that ships with a slice registers when the slice's testing entry is imported (telemetry: '@marinoscar/platform-api/telemetry/testing').");
+        }
+    }
+    if (options.sourceRoots.length === 0) {
+        throw new Error('runPlatformConformance: sourceRoots is empty, so there is nothing to scan.');
+    }
+    const api = options.testApi ?? globalTestApi();
+    for (const [key, suiteOptions] of requested) {
+        const suite = byOptionKey.get(key);
+        if (suiteOptions === undefined)
+            continue;
+        if (suiteOptions === false) {
+            api.describe(suite.title, () => {
+                api.it(`${suite.id}: disabled by the app`, () => undefined);
+            });
+            continue;
+        }
+        // One scan per suite, on first use: the scan runs inside the first test, so
+        // a misconfiguration fails that test with its message instead of breaking
+        // collection of the whole spec file.
+        let report;
+        const scan = () => {
+            report ??= suite.check({ sourceRoots: options.sourceRoots }, suiteOptions);
+            return report;
+        };
+        api.describe(suite.title, () => {
+            for (const testCase of suite.cases(suiteOptions)) {
+                api.it(testCase.name, () => testCase.run(scan(), api.expect));
+            }
+        });
+    }
+}
+//# sourceMappingURL=run-platform-conformance.js.map

package/dist/testing/run-platform-conformance.js.map

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

package/dist/testing/suites/cron-enqueue-only.d.ts

@@ -0,0 +1,46 @@
+import type { ConformanceSuite } from '../conformance-suite';
+/**
+ * How an app configures the cron suite.
+ *
+ * @example
+ * ```ts
+ * const options: CronEnqueueOnlyOptions = {
+ *   exempt: [{ file: 'jobs/tasks/job-stuck-reset.task.ts', why: 'The lease reaper recovers abandoned jobs; recovery cannot depend on the queue it recovers.' }],
+ *   minCronFiles: 8,
+ * };
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface CronEnqueueOnlyOptions {
+    /**
+     * Files allowed to work inline, as paths relative to the source root that
+     * contains them (`/` separators). Each needs a written reason of more than 40
+     * characters; the suite fails when an exempt file holds no `@Cron`.
+     */
+    exempt: ReadonlyArray<{
+        /** The exempt file, relative to its source root, with `/` separators. */
+        file: string;
+        /** Why the work must not be a job; more than 40 characters. */
+        why: string;
+    }>;
+    /** Vacuity guard: at least this many files with a `@Cron` must be found. */
+    minCronFiles: number;
+    /** Extra markers an app adds for its own work helpers. Additive only; the platform markers always apply. */
+    extraWorkMarkers?: ReadonlyArray<{
+        /** Matches a cron body that does the work itself. */
+        pattern: RegExp;
+        /** What the match is, completing `a @Cron body containing ...`. */
+        what: string;
+    }>;
+}
+/**
+ * The suite behind `runPlatformConformance({ suites: { cronEnqueueOnly } })`:
+ * every `@Cron` body enqueues a job and contains no marker of inline work.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const cronEnqueueOnlySuite: ConformanceSuite<CronEnqueueOnlyOptions>;
+//# sourceMappingURL=cron-enqueue-only.d.ts.map

package/dist/testing/suites/cron-enqueue-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-enqueue-only.d.ts","sourceRoot":"","sources":["../../../src/testing/suites/cron-enqueue-only.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAKV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,MAAM,EAAE,aAAa,CAAC;QACpB,yEAAyE;QACzE,IAAI,EAAE,MAAM,CAAC;QACb,+DAA+D;QAC/D,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,gBAAgB,CAAC,EAAE,aAAa,CAAC;QAC/B,qDAAqD;QACrD,OAAO,EAAE,MAAM,CAAC;QAChB,mEAAmE;QACnE,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAwJD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,CAAC,sBAAsB,CAMzE,CAAC"}