@marinoscar/platform-api 0.1.0-next.3 → 0.1.0-next.5

package/dist/telemetry/testing/stub-ports.js.map

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

package/dist/testing/conformance-suite.d.ts

@@ -103,4 +103,47 @@ export interface ConformanceSuite<TOptions> {
     /** The tests to register, in order. Each receives the one report `check` produced. */
     cases(options: TOptions): ReadonlyArray<ConformanceCase>;
 }
+/**
+ * A suite that registers its own test tree instead of scanning once and
+ * asserting on a report. It exists for the invariants that have to boot the
+ * app (the AI kill switch, the RBAC matrix, secret egress, key policy, jobs
+ * server-only): they need runner lifecycle hooks (`beforeAll`, `afterAll`) and
+ * the runner's full matcher set, so they register through the globals of the
+ * runner they run under. Such a suite lives in a runner-specific entry (the
+ * Jest-only `@marinoscar/platform-api/ai/testing`), never in `src/testing`.
+ *
+ * Register one in {@link conformanceSuites}; `runPlatformConformance` calls
+ * `register` when the app enables it, and records it in the run summary like
+ * any other suite.
+ *
+ * @typeParam TOptions - what the app passes to configure the suite.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export interface ConformanceAppSuite<TOptions> {
+    /** Stable id, for example `'ai-kill-switch'`. The app's option key is its camelCase form. */
+    readonly id: string;
+    /** The `describe` title; part of every generated test's full name. */
+    readonly title: string;
+    /** One sentence: the invariant this enforces. */
+    readonly description: string;
+    /**
+     * Registers the suite's `describe` tree. Called once, at the top level of the
+     * app's spec file. Throws only on misconfiguration (a missing option).
+     */
+    register(api: ConformanceTestApi, context: ConformanceContext, options: TOptions): void;
+}
+/**
+ * An explicit, argued opt-out: `suites: { aiKillSwitch: { skip: 'reason' } }`.
+ * The reason is required (an empty one throws) and is printed in the run
+ * summary, so a skipped invariant stays visible in the test output.
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface ConformanceSkip {
+    /** Why this app does not run the suite; at least a few words, shown in the summary. */
+    skip: string;
+}
 //# sourceMappingURL=conformance-suite.d.ts.map

package/dist/testing/conformance-suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance-suite.d.ts","sourceRoot":"","sources":["../../src/testing/conformance-suite.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7C,0BAA0B;IAC1B,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,wEAAwE;IACxE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK;QAC3B,qCAAqC;QACrC,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,yCAAyC;QACzC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,wCAAwC;QACxC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;KAChC,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,0GAA0G;IAC1G,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAChD,oEAAoE;IACpE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ;IACxC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,GAAG,iBAAiB,CAAC;IACzE,sFAAsF;IACtF,KAAK,CAAC,OAAO,EAAE,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;CAC1D"}
+{"version":3,"file":"conformance-suite.d.ts","sourceRoot":"","sources":["../../src/testing/conformance-suite.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7C,0BAA0B;IAC1B,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,wEAAwE;IACxE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK;QAC3B,qCAAqC;QACrC,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,yCAAyC;QACzC,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,wCAAwC;QACxC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;KAChC,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,0GAA0G;IAC1G,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAChD,oEAAoE;IACpE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ;IACxC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,GAAG,iBAAiB,CAAC;IACzE,sFAAsF;IACtF,KAAK,CAAC,OAAO,EAAE,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;CACzF;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/testing/conformance-suites.d.ts

@@ -1,4 +1,4 @@
-import type { ConformanceSuite } from './conformance-suite';
+import type { ConformanceAppSuite, ConformanceSuite } from './conformance-suite';
 /**
  * Every conformance suite `runPlatformConformance` can run, keyed by suite id.
  *
@@ -10,5 +10,5 @@ import type { ConformanceSuite } from './conformance-suite';
  * @extensionPoint registry
  * @stability experimental
  */
-export declare const conformanceSuites: import("../core/index").Registry<ConformanceSuite<any>>;
+export declare const conformanceSuites: import("../core/index").Registry<ConformanceSuite<any> | ConformanceAppSuite<any>>;
 //# sourceMappingURL=conformance-suites.d.ts.map

package/dist/testing/conformance-suites.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance-suites.d.ts","sourceRoot":"","sources":["../../src/testing/conformance-suites.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D;;;;;;;;;;GAUG;AAGH,eAAO,MAAM,iBAAiB,yDAI5B,CAAC"}
+{"version":3,"file":"conformance-suites.d.ts","sourceRoot":"","sources":["../../src/testing/conformance-suites.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIjF;;;;;;;;;;GAUG;AAGH,eAAO,MAAM,iBAAiB,oFAI5B,CAAC"}

package/dist/testing/conformance-suites.js.map

@@ -1 +1 @@
-{"version":3,"file":"conformance-suites.js","sourceRoot":"","sources":["../../src/testing/conformance-suites.ts"],"names":[],"mappings":";;;AAAA,yCAA+C;AAG/C,kEAAkE;AAClE,8DAA8D;AAE9D;;;;;;;;;;GAUG;AACH,gFAAgF;AAChF,gFAAgF;AACnE,QAAA,iBAAiB,GAAG,IAAA,sBAAc,EAAwB;IACrE,IAAI,EAAE,6BAA6B;IACnC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE;IACzB,KAAK,EAAE,cAAc;CACtB,CAAC,CAAC;AAEH,yBAAiB,CAAC,QAAQ,CAAC,wCAAoB,CAAC,CAAC;AACjD,yBAAiB,CAAC,QAAQ,CAAC,oCAAkB,CAAC,CAAC"}
+{"version":3,"file":"conformance-suites.js","sourceRoot":"","sources":["../../src/testing/conformance-suites.ts"],"names":[],"mappings":";;;AAAA,yCAA+C;AAG/C,kEAAkE;AAClE,8DAA8D;AAE9D;;;;;;;;;;GAUG;AACH,gFAAgF;AAChF,gFAAgF;AACnE,QAAA,iBAAiB,GAAG,IAAA,sBAAc,EAAmD;IAChG,IAAI,EAAE,6BAA6B;IACnC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE;IACzB,KAAK,EAAE,cAAc;CACtB,CAAC,CAAC;AAEH,yBAAiB,CAAC,QAAQ,CAAC,wCAAoB,CAAC,CAAC;AACjD,yBAAiB,CAAC,QAAQ,CAAC,oCAAkB,CAAC,CAAC"}

package/dist/testing/index.d.ts

@@ -1,7 +1,10 @@
-export { runPlatformConformance } from './run-platform-conformance';
-export type { PlatformConformanceOptions, PlatformConformanceSuiteOptions } from './run-platform-conformance';
+import type { CronEnqueueOnlyOptions } from './suites/cron-enqueue-only';
+import type { UserOwnedDataOptions } from './suites/user-owned-data';
+export { formatConformanceSummary, runPlatformConformance } from './run-platform-conformance';
+export type { ConformanceSummaryEntry, PlatformConformanceOptions } from './run-platform-conformance';
 export { conformanceSuites } from './conformance-suites';
-export type { ConformanceCase, ConformanceContext, ConformanceFinding, ConformanceReport, ConformanceSuite, ConformanceTestApi, } from './conformance-suite';
+export { resolveConformanceTestApi } from './test-api';
+export type { ConformanceAppSuite, ConformanceCase, ConformanceContext, ConformanceFinding, ConformanceReport, ConformanceSkip, ConformanceSuite, ConformanceTestApi, } from './conformance-suite';
 export { cronEnqueueOnlySuite } from './suites/cron-enqueue-only';
 export type { CronEnqueueOnlyOptions } from './suites/cron-enqueue-only';
 export { createTestPlatformHost, InMemoryAuditSink, InMemorySystemSettingsStore, TEST_PERMISSIONS_HEADER, TEST_REQUIRED_PERMISSIONS_KEY, } from './host/index';
@@ -9,4 +12,29 @@ export { userOwnedDataSuite } from './suites/user-owned-data';
 export type { UserOwnedDataOptions } from './suites/user-owned-data';
 export { effectiveOnDelete, parsePrismaSchema, readSchemaDatamodel, readSchemaText } from './prisma-schema';
 export type { DatamodelField, DatamodelModel, DatamodelRelation } from './prisma-schema';
+/**
+ * The suites {@link runPlatformConformance} can run, by option key: each
+ * entry is the suite's options (the app passes them, or `{ skip: 'reason' }`
+ * to opt out; see {@link PlatformConformanceOptions.suites}). 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;
+ *   }
+ * }
+ * ```
+ *
+ * @stability experimental
+ */
+export interface PlatformConformanceSuiteOptions {
+    /** The `cron-enqueue-only` suite: its options, or `{ skip: 'reason' }` to opt out. */
+    cronEnqueueOnly?: CronEnqueueOnlyOptions;
+    /** The `user-owned-data` suite: its options, or `{ skip: 'reason' }` to opt out. */
+    userOwnedData?: UserOwnedDataOptions;
+}
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIzE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5G,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,YAAY,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIzE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5G,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,+BAA+B;IAC9C,sFAAsF;IACtF,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,oFAAoF;IACpF,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC"}

package/dist/testing/index.js

@@ -5,11 +5,14 @@
 // 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;
+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.resolveConformanceTestApi = exports.conformanceSuites = exports.runPlatformConformance = exports.formatConformanceSummary = void 0;
 var run_platform_conformance_1 = require("./run-platform-conformance");
+Object.defineProperty(exports, "formatConformanceSummary", { enumerable: true, get: function () { return run_platform_conformance_1.formatConformanceSummary; } });
 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 test_api_1 = require("./test-api");
+Object.defineProperty(exports, "resolveConformanceTestApi", { enumerable: true, get: function () { return test_api_1.resolveConformanceTestApi; } });
 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

package/dist/testing/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";AAAA,0FAA0F;AAC1F,EAAE;AACF,6EAA6E;AAC7E,kEAAkE;AAClE,oCAAoC;;;AAKpC,uEAA8F;AAArF,oIAAA,wBAAwB,OAAA;AAAE,kIAAA,sBAAsB,OAAA;AAEzD,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,uCAAuD;AAA9C,qHAAA,yBAAyB,OAAA;AAWlC,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/run-platform-conformance.d.ts

@@ -1,30 +1,5 @@
-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;
-}
+import type { ConformanceSkip, ConformanceTestApi } from './conformance-suite';
+import type { PlatformConformanceSuiteOptions } from './index';
 /**
  * What an app passes to {@link runPlatformConformance}.
  *
@@ -35,15 +10,24 @@ 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`).
+     * One entry per suite. Pass the suite's options to run it, or
+     * `{ skip: 'reason' }` to opt out: the reason is required (an empty one, or
+     * `false`, throws) and is printed in the run summary, so the opt-out stays
+     * visible. 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;
+    suites: {
+        [K in keyof PlatformConformanceSuiteOptions]?: Exclude<PlatformConformanceSuiteOptions[K], false> | ConformanceSkip;
+    };
     /** Defaults to the globals `describe`/`it`/`expect` (Jest, or Vitest with `globals: true`). */
     testApi?: ConformanceTestApi;
+    /**
+     * Where the summary table of suites run and skipped goes. Default: standard
+     * output, unless `testApi` is injected (then nothing is printed).
+     */
+    summaryOutput?: (table: string) => void;
 }
 /**
  * Registers one `describe` block per enabled conformance suite. Call it at the
@@ -56,7 +40,7 @@ export interface PlatformConformanceOptions {
  *
  * @example
  * ```ts
- * // apps/api/test/jobs/cron-enqueue-only.spec.ts
+ * // apps/api/test/conformance.spec.ts
  * runPlatformConformance({
  *   sourceRoots: [join(__dirname, '..', '..', 'src')],
  *   suites: { cronEnqueueOnly: { exempt: EXEMPT, minCronFiles: 8 } },
@@ -67,4 +51,27 @@ export interface PlatformConformanceOptions {
  * @stability experimental
  */
 export declare function runPlatformConformance(options: PlatformConformanceOptions): void;
+/**
+ * One row of the run summary.
+ *
+ * @stability experimental
+ */
+export interface ConformanceSummaryEntry {
+    /** The suite id. */
+    id: string;
+    /** `run` when the app enabled it, `skipped` when it opted out with a reason. */
+    status: 'run' | 'skipped';
+    /** The app's reason, for a skipped suite. */
+    reason?: string;
+}
+/**
+ * The summary table `runPlatformConformance` prints: every suite the app
+ * enabled or opted out of, and why it was skipped.
+ *
+ * @param entries - one per suite, in the order the app listed them.
+ * @returns a plain-text table, one line per suite under a header.
+ *
+ * @stability experimental
+ */
+export declare function formatConformanceSummary(entries: readonly ConformanceSummaryEntry[]): string;
 //# sourceMappingURL=run-platform-conformance.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"run-platform-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/run-platform-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEf,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAK/D;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,wHAAwH;IACxH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;;;;;OAQG;IACH,MAAM,EAAE;SACL,CAAC,IAAI,MAAM,+BAA+B,CAAC,CAAC,EAAE,OAAO,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,eAAe;KACpH,CAAC;IACF,+FAA+F;IAC/F,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAkBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CA8EhF;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,GAAG,MAAM,CAO5F"}

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runPlatformConformance = runPlatformConformance;
+exports.formatConformanceSummary = formatConformanceSummary;
 const conformance_suites_1 = require("./conformance-suites");
 /** `cronEnqueueOnly` for `cron-enqueue-only`: how the app spells a suite id. */
 function optionKeyOf(id) {
@@ -25,7 +26,7 @@ function globalTestApi() {
  *
  * @example
  * ```ts
- * // apps/api/test/jobs/cron-enqueue-only.spec.ts
+ * // apps/api/test/conformance.spec.ts
  * runPlatformConformance({
  *   sourceRoots: [join(__dirname, '..', '..', 'src')],
  *   suites: { cronEnqueueOnly: { exempt: EXEMPT, minCronFiles: 8 } },
@@ -49,16 +50,30 @@ function runPlatformConformance(options) {
         throw new Error('runPlatformConformance: sourceRoots is empty, so there is nothing to scan.');
     }
     const api = options.testApi ?? globalTestApi();
+    const summary = [];
     for (const [key, suiteOptions] of requested) {
         const suite = byOptionKey.get(key);
         if (suiteOptions === undefined)
             continue;
         if (suiteOptions === false) {
+            throw new Error(`runPlatformConformance: suite "${suite.id}" is switched off with \`false\`. An opt-out needs a reason: \`${key}: { skip: 'why this app does not run it' }\`.`);
+        }
+        if (isSkip(suiteOptions)) {
+            const reason = typeof suiteOptions.skip === 'string' ? suiteOptions.skip.trim() : '';
+            if (reason === '') {
+                throw new Error(`runPlatformConformance: suite "${suite.id}" is skipped without a reason. Pass \`${key}: { skip: 'why this app does not run it' }\`.`);
+            }
+            summary.push({ id: suite.id, status: 'skipped', reason });
             api.describe(suite.title, () => {
-                api.it(`${suite.id}: disabled by the app`, () => undefined);
+                api.it(`${suite.id}: skipped by the app (${reason})`, () => undefined);
             });
             continue;
         }
+        summary.push({ id: suite.id, status: 'run' });
+        if (isAppSuite(suite)) {
+            suite.register(api, { sourceRoots: options.sourceRoots }, suiteOptions);
+            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.
@@ -73,5 +88,39 @@ function runPlatformConformance(options) {
             }
         });
     }
+    // The summary is printed at registration time, not registered as a test: a
+    // test would change the case list of every suite the app runs. A test API
+    // the caller injects (a recording fake) prints nothing unless `summaryOutput`
+    // says where.
+    if (summary.length > 0) {
+        const table = formatConformanceSummary(summary);
+        if (options.summaryOutput)
+            options.summaryOutput(table);
+        else if (options.testApi === undefined)
+            process.stdout.write(`\n${table}\n`);
+    }
+}
+/**
+ * The summary table `runPlatformConformance` prints: every suite the app
+ * enabled or opted out of, and why it was skipped.
+ *
+ * @param entries - one per suite, in the order the app listed them.
+ * @returns a plain-text table, one line per suite under a header.
+ *
+ * @stability experimental
+ */
+function formatConformanceSummary(entries) {
+    const width = Math.max('suite'.length, ...entries.map((entry) => entry.id.length));
+    const lines = entries.map((entry) => `${entry.id.padEnd(width)}  ${entry.status === 'run' ? 'run' : `skipped: ${entry.reason ?? ''}`}`);
+    const ran = entries.filter((entry) => entry.status === 'run').length;
+    return [`${'suite'.padEnd(width)}  status`, ...lines, `${ran} run, ${entries.length - ran} skipped`].join('\n');
+}
+/** An app suite registers its own tree; a scan suite has `check` and `cases`. */
+function isAppSuite(suite) {
+    return typeof suite.register === 'function';
+}
+/** An opt-out is an object with a `skip` key (a suite's own options never name one). */
+function isSkip(value) {
+    return typeof value === 'object' && value !== null && 'skip' in value;
 }
 //# sourceMappingURL=run-platform-conformance.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"run-platform-conformance.js","sourceRoot":"","sources":["../../src/testing/run-platform-conformance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-platform-conformance.js","sourceRoot":"","sources":["../../src/testing/run-platform-conformance.ts"],"names":[],"mappings":";;AAgFA,wDA8EC;AAyBD,4DAOC;AAvLD,6DAAyD;AAoCzD,gFAAgF;AAChF,SAAS,WAAW,CAAC,EAAU;IAC7B,OAAO,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,sEAAsE;AACtE,SAAS,aAAa;IACpB,MAAM,CAAC,GAAG,UAAoD,CAAC;IAC/D,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACrG,MAAM,IAAI,KAAK,CACb,gIAAgI,CACjI,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,sBAAsB,CAAC,OAAmC;IACxE,sCAAiB,CAAC,MAAM,EAAE,CAAC;IAE3B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,sCAAiB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACrG,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAA6B,CAAC;IAE7E,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,sDAAsD,GAAG,oBAAoB,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,IAAI;gBAC7H,iJAAiJ,CACpJ,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;IAC/C,MAAM,OAAO,GAA8B,EAAE,CAAC;IAE9C,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAEpC,IAAI,YAAY,KAAK,SAAS;YAAE,SAAS;QAEzC,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,CAAC,EAAE,kEAAkE,GAAG,+CAA+C,CAC/J,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,CAAC,EAAE,yCAAyC,GAAG,+CAA+C,CACtI,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1D,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE;gBAC7B,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,yBAAyB,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAE9C,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QAED,4EAA4E;QAC5E,0EAA0E;QAC1E,qCAAqC;QACrC,IAAI,MAAqC,CAAC;QAC1C,MAAM,IAAI,GAAG,GAAsB,EAAE;YACnC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;YAC3E,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE;YAC7B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,0EAA0E;IAC1E,8EAA8E;IAC9E,cAAc;IACd,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,aAAa;YAAE,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACnD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAgBD;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CAAC,OAA2C;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CACvB,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,CAC7G,CAAC;IACF,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;IACrE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,KAAK,EAAE,GAAG,GAAG,SAAS,OAAO,CAAC,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClH,CAAC;AAED,iFAAiF;AACjF,SAAS,UAAU,CAAC,KAA+D;IACjF,OAAO,OAAQ,KAAsC,CAAC,QAAQ,KAAK,UAAU,CAAC;AAChF,CAAC;AAED,wFAAwF;AACxF,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;AACxE,CAAC"}

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

@@ -22,6 +22,13 @@ export interface CronEnqueueOnlyOptions {
     exempt: ReadonlyArray<{
         /** The exempt file, relative to its source root, with `/` separators. */
         file: string;
+        /**
+         * The source root the file lives under (absolute). Optional: without it, a
+         * file at that relative path under ANY root is exempt. Pin it when several
+         * roots are scanned (a packaged slice's `tasks/` next to the app's), so the
+         * exemption names exactly one file.
+         */
+        root?: string;
         /** Why the work must not be a job; more than 40 characters. */
         why: string;
     }>;

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

@@ -1 +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"}
+{"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;;;;;WAKG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,+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;AAgKD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,CAAC,sBAAsB,CAMzE,CAAC"}

package/dist/testing/suites/cron-enqueue-only.js

@@ -18,7 +18,7 @@
 // so a decorator OPTIONS object is read as the body and reported as queueing
 // nothing. That fails loudly, never silently; no cron in the base uses options.
 //
-// The scan was moved here UNCHANGED from apps/api/test/jobs/cron-enqueue-only.spec.ts:
+// The scan was moved here UNCHANGED from apps/api/test/conformance.spec.ts:
 // same markers, same enqueue pattern, same brace matching. What the app keeps
 // is DATA: its exemption list (each one argued) and its vacuity minimum.
 // =============================================================================
@@ -97,7 +97,7 @@ function check(context, options) {
         throw new Error('cron-enqueue-only: minCronFiles must be a positive integer, or the scan could pass vacuously.');
     }
     const markers = [...WORK_MARKERS, ...(options.extraWorkMarkers ?? [])];
-    const exemptFiles = new Set(options.exempt.map((entry) => entry.file));
+    const isExempt = (file) => options.exempt.some((entry) => entry.root === undefined ? entry.file === file.rel : (0, node_path_1.resolve)(entry.root, entry.file) === (0, node_path_1.resolve)(file.path));
     const files = context.sourceRoots
         .flatMap((root) => {
         let found;
@@ -113,7 +113,7 @@ function check(context, options) {
         .filter((file) => file.source.includes('@Cron('));
     const findings = [];
     for (const file of files) {
-        if (exemptFiles.has(file.rel))
+        if (isExempt(file))
             continue;
         for (const body of cronBodies(file.source)) {
             if (!ENQUEUES.test(body)) {
@@ -128,7 +128,11 @@ function check(context, options) {
     }
     return {
         scanned: { cronFiles: files.length },
-        scannedFiles: { cronFiles: files.map((file) => file.rel) },
+        scannedFiles: {
+            cronFiles: files.map((file) => file.rel),
+            // Absolute paths, for an exemption pinned to its root.
+            cronPaths: files.map((file) => (0, node_path_1.resolve)(file.path)),
+        },
         findings,
     };
 }
@@ -148,7 +152,10 @@ function cases(options) {
             run: (report, expect) => {
                 // The exemption is only real if the file is: a stale entry would
                 // silently exempt nothing while looking like it exempted something.
-                expect(report.scannedFiles.cronFiles).toContain(entry.file);
+                if (entry.root === undefined)
+                    expect(report.scannedFiles.cronFiles).toContain(entry.file);
+                else
+                    expect(report.scannedFiles.cronPaths).toContain((0, node_path_1.resolve)(entry.root, entry.file));
                 expect(entry.why.length).toBeGreaterThanOrEqual(41);
             },
         })),

package/dist/testing/suites/cron-enqueue-only.js.map

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

package/dist/testing/suites/user-owned-data.d.ts

@@ -9,7 +9,7 @@ import { type DatamodelModel } from '../prisma-schema';
  * const options: UserOwnedDataOptions = {
  *   schemaPath: join(__dirname, '..', '..', 'prisma', 'schema'),
  *   policies: userOwnedModelRegistry.list(),
- *   rawSqlAllowlist: [{ file: 'health/indicators/database.indicator.ts', why: 'Health probe: SELECT 1.' }],
+ *   rawSqlAllowlist: [{ file: 'health/database.indicator.ts', why: 'Health probe: SELECT 1.' }],
  *   registerIn: 'src/app-registrations/user-owned-models.ts',
  * };
  * ```

package/dist/testing/test-api.d.ts

@@ -0,0 +1,15 @@
+import type { ConformanceTestApi } from './conformance-suite';
+/**
+ * The test API a kit registers its tests on: the one the caller injected, else
+ * the runner's own globals (`describe`, `it`, `expect` of Jest, or of Vitest
+ * with `globals: true`).
+ *
+ * @param kit - the kit's name, for the error message (`describeDoctorCheckConformance`).
+ * @param testApi - an injected API (a recording fake in a package test); omitted, the globals are used.
+ * @returns the API to register on.
+ * @throws Error when no API was injected and the runner has no global `describe`, `it` and `expect`.
+ *
+ * @stability experimental
+ */
+export declare function resolveConformanceTestApi(kit: string, testApi?: ConformanceTestApi): ConformanceTestApi;
+//# sourceMappingURL=test-api.d.ts.map

package/dist/testing/test-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-api.d.ts","sourceRoot":"","sources":["../../src/testing/test-api.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAOvG"}

package/dist/testing/test-api.js

@@ -0,0 +1,29 @@
+"use strict";
+// The runner's globals as a ConformanceTestApi (PP-14.26). Shared by every
+// extension-author kit (`describeDoctorCheckConformance`,
+// `describeJobHandlerConformance`): they take an optional `testApi` and fall
+// back to the runner they run under. Imports no test runner.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConformanceTestApi = resolveConformanceTestApi;
+/**
+ * The test API a kit registers its tests on: the one the caller injected, else
+ * the runner's own globals (`describe`, `it`, `expect` of Jest, or of Vitest
+ * with `globals: true`).
+ *
+ * @param kit - the kit's name, for the error message (`describeDoctorCheckConformance`).
+ * @param testApi - an injected API (a recording fake in a package test); omitted, the globals are used.
+ * @returns the API to register on.
+ * @throws Error when no API was injected and the runner has no global `describe`, `it` and `expect`.
+ *
+ * @stability experimental
+ */
+function resolveConformanceTestApi(kit, testApi) {
+    if (testApi)
+        return testApi;
+    const g = globalThis;
+    if (typeof g.describe !== 'function' || typeof g.it !== 'function' || typeof g.expect !== 'function') {
+        throw new Error(`${kit}: 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 };
+}
+//# sourceMappingURL=test-api.js.map

package/dist/testing/test-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-api.js","sourceRoot":"","sources":["../../src/testing/test-api.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,0DAA0D;AAC1D,6EAA6E;AAC7E,6DAA6D;;AAgB7D,8DAOC;AAnBD;;;;;;;;;;;GAWG;AACH,SAAgB,yBAAyB,CAAC,GAAW,EAAE,OAA4B;IACjF,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,CAAC,GAAG,UAAoD,CAAC;IAC/D,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACrG,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,8GAA8G,CAAC,CAAC;IACxI,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9D,CAAC"}

package/dist/user-data/composed-schema.d.ts

@@ -0,0 +1,28 @@
+import type { PurgeDatamodel } from './purge/purge-planner';
+/**
+ * The composed schema folder: the first `prisma/schema` found walking up from
+ * `fromDir`.
+ *
+ * @param fromDir - where to start (an app passes `__dirname`).
+ * @returns the folder's absolute path.
+ * @throws Error when none exists within a few levels.
+ *
+ * @stability experimental
+ */
+export declare function findComposedSchemaPath(fromDir: string): string;
+/**
+ * The `datamodel` option for `UserDataModule.forRoot`: parses the composed
+ * schema folder found above `fromDir`, once, when the plan is first computed.
+ *
+ * @param fromDir - where to start looking (an app passes `__dirname`).
+ * @returns a function for `UserDataModuleOptions.datamodel`.
+ *
+ * @stability experimental
+ * @extensionPoint option
+ * @example
+ * ```ts
+ * UserDataModule.forRoot({ imports: [UserDataHostModule], datamodel: composedSchemaDatamodel(__dirname) });
+ * ```
+ */
+export declare function composedSchemaDatamodel(fromDir: string): () => PurgeDatamodel;
+//# sourceMappingURL=composed-schema.d.ts.map

package/dist/user-data/composed-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed-schema.d.ts","sourceRoot":"","sources":["../../src/user-data/composed-schema.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,cAAc,CAE7E"}