@effected/github 0.23.0 → 0.24.0

package/GitTag.js

@@ -1,4 +1,5 @@
 import { GitHubError } from "./GitHubError.js";
+import { unstubbed } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { Context, Effect, Layer, Option, Result, Schema, Stream } from "effect";
@@ -63,21 +64,19 @@ const versionFromTag = (tag) => {
 var GitTag = class GitTag extends Context.Service()("@effected/github/GitTag") {
 	/** The live service, built over a `GitHubClient`. */
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		create: overrides.create ?? (() => unstubbed("create")),
-		upsert: overrides.upsert ?? (() => unstubbed("upsert")),
-		delete: overrides.delete ?? (() => unstubbed("delete")),
-		list: overrides.list ?? (() => unstubbed("list")),
-		resolve: overrides.resolve ?? (() => unstubbed("resolve")),
-		latestSemver: overrides.latestSemver ?? (() => unstubbed("latestSemver"))
+		create: overrides.create ?? (() => dies("create")),
+		upsert: overrides.upsert ?? (() => dies("upsert")),
+		delete: overrides.delete ?? (() => dies("delete")),
+		list: overrides.list ?? (() => dies("list")),
+		resolve: overrides.resolve ?? (() => dies("resolve")),
+		latestSemver: overrides.latestSemver ?? (() => dies("latestSemver"))
 	});
 	/** {@link GitTag.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(GitTag, GitTag.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`GitTag.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("GitTag.makeTest");
 const shortTag = (tag) => tag.replace(/^refs\/tags\//, "").replace(/^tags\//, "");
 const rejectEmpty = (operation, tag) => {
 	const short = shortTag(tag).trim();

package/InstallationTokenStore.js

@@ -1,3 +1,4 @@
+import { unstubbed } from "./internal/unstubbed.js";
 import { Clock, Context, Duration, Effect, Layer, Option, Ref } from "effect";
 
 // src/InstallationTokenStore.ts
@@ -38,13 +39,14 @@ var InstallationTokenStore = class InstallationTokenStore extends Context.Servic
 			}));
 		})
 	})));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		get: overrides.get ?? (() => Effect.die(/* @__PURE__ */ new Error("InstallationTokenStore.makeTest: get() was called but not stubbed"))),
-		set: overrides.set ?? (() => Effect.die(/* @__PURE__ */ new Error("InstallationTokenStore.makeTest: set() was called but not stubbed")))
+		get: overrides.get ?? (() => dies("get")),
+		set: overrides.set ?? (() => dies("set"))
 	});
 	/** {@link InstallationTokenStore.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(InstallationTokenStore, InstallationTokenStore.makeTest(overrides));
 };
+const dies = unstubbed("InstallationTokenStore.makeTest");
 
 export { InstallationTokenStore };

package/PullRequest.js

@@ -1,5 +1,6 @@
 import { GitHubError } from "./GitHubError.js";
 import { GraphQLDocument } from "./GraphQL.js";
+import { unstubbed } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { fileOf } from "./GitHubCommit.js";
@@ -110,26 +111,24 @@ const GRAPHQL_MERGE_METHOD = {
 var PullRequest = class PullRequest extends Context.Service()("@effected/github/PullRequest") {
 	/** The live service, built over a `GitHubClient`. */
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		get: overrides.get ?? (() => unstubbed("get")),
-		list: overrides.list ?? (() => unstubbed("list")),
-		listFiles: overrides.listFiles ?? (() => unstubbed("listFiles")),
-		listAssociatedWithCommit: overrides.listAssociatedWithCommit ?? (() => unstubbed("listAssociatedWithCommit")),
-		create: overrides.create ?? (() => unstubbed("create")),
-		update: overrides.update ?? (() => unstubbed("update")),
-		upsert: overrides.upsert ?? (() => unstubbed("upsert")),
-		merge: overrides.merge ?? (() => unstubbed("merge")),
-		addLabels: overrides.addLabels ?? (() => unstubbed("addLabels")),
-		requestReviewers: overrides.requestReviewers ?? (() => unstubbed("requestReviewers")),
-		setAutoMerge: overrides.setAutoMerge ?? (() => unstubbed("setAutoMerge"))
+		get: overrides.get ?? (() => dies("get")),
+		list: overrides.list ?? (() => dies("list")),
+		listFiles: overrides.listFiles ?? (() => dies("listFiles")),
+		listAssociatedWithCommit: overrides.listAssociatedWithCommit ?? (() => dies("listAssociatedWithCommit")),
+		create: overrides.create ?? (() => dies("create")),
+		update: overrides.update ?? (() => dies("update")),
+		upsert: overrides.upsert ?? (() => dies("upsert")),
+		merge: overrides.merge ?? (() => dies("merge")),
+		addLabels: overrides.addLabels ?? (() => dies("addLabels")),
+		requestReviewers: overrides.requestReviewers ?? (() => dies("requestReviewers")),
+		setAutoMerge: overrides.setAutoMerge ?? (() => dies("setAutoMerge"))
 	});
 	/** {@link PullRequest.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(PullRequest, PullRequest.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`PullRequest.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("PullRequest.makeTest");
 const project = (raw) => Effect.try({
 	try: () => PullRequestInfo.make({
 		number: raw.number,

package/PullRequestComment.js

@@ -1,3 +1,4 @@
+import { unstubbed } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { numericId } from "./internal/ids.js";
@@ -66,19 +67,17 @@ var CommentRecord = class extends Schema.Class("CommentRecord")({
 var PullRequestComment = class PullRequestComment extends Context.Service()("@effected/github/PullRequestComment") {
 	/** The live service, built over a `GitHubClient`. */
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		create: overrides.create ?? (() => unstubbed("create")),
-		upsert: overrides.upsert ?? (() => unstubbed("upsert")),
-		find: overrides.find ?? (() => unstubbed("find")),
-		delete: overrides.delete ?? (() => unstubbed("delete"))
+		create: overrides.create ?? (() => dies("create")),
+		upsert: overrides.upsert ?? (() => dies("upsert")),
+		find: overrides.find ?? (() => dies("find")),
+		delete: overrides.delete ?? (() => dies("delete"))
 	});
 	/** {@link PullRequestComment.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(PullRequestComment, PullRequestComment.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`PullRequestComment.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("PullRequestComment.makeTest");
 const recordOf = (raw) => CommentRecord.make({
 	id: numericId(raw.id),
 	body: raw.body ?? "",

package/RepositorySecret.js

@@ -1,4 +1,5 @@
 import { GitHubError } from "./GitHubError.js";
+import { unstubbed } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { encryptSecret } from "./internal/crypto.js";
@@ -70,21 +71,19 @@ var RepositorySecret = class RepositorySecret extends Context.Service()("@effect
 	* further down throws at import time with a clean typecheck.
 	*/
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		set: overrides.set ?? (() => unstubbed("set")),
-		list: overrides.list ?? (() => unstubbed("list")),
-		delete: overrides.delete ?? (() => unstubbed("delete")),
-		setForEnvironment: overrides.setForEnvironment ?? (() => unstubbed("setForEnvironment")),
-		listForEnvironment: overrides.listForEnvironment ?? (() => unstubbed("listForEnvironment")),
-		deleteForEnvironment: overrides.deleteForEnvironment ?? (() => unstubbed("deleteForEnvironment"))
+		set: overrides.set ?? (() => dies("set")),
+		list: overrides.list ?? (() => dies("list")),
+		delete: overrides.delete ?? (() => dies("delete")),
+		setForEnvironment: overrides.setForEnvironment ?? (() => dies("setForEnvironment")),
+		listForEnvironment: overrides.listForEnvironment ?? (() => dies("listForEnvironment")),
+		deleteForEnvironment: overrides.deleteForEnvironment ?? (() => dies("deleteForEnvironment"))
 	});
 	/** {@link RepositorySecret.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(RepositorySecret, RepositorySecret.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`RepositorySecret.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("RepositorySecret.makeTest");
 /**
 * Seal a value, turning a malformed public key into a typed failure.
 *

package/RepositorySecurity.js

@@ -1,3 +1,4 @@
+import { unstubbed } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { Context, Effect, Layer } from "effect";
@@ -56,21 +57,19 @@ var RepositorySecurity = class RepositorySecurity extends Context.Service()("@ef
 	* further down throws at import time with a clean typecheck.
 	*/
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		vulnerabilityAlerts: overrides.vulnerabilityAlerts ?? (() => unstubbed("vulnerabilityAlerts")),
-		setVulnerabilityAlerts: overrides.setVulnerabilityAlerts ?? (() => unstubbed("setVulnerabilityAlerts")),
-		automatedSecurityFixes: overrides.automatedSecurityFixes ?? (() => unstubbed("automatedSecurityFixes")),
-		setAutomatedSecurityFixes: overrides.setAutomatedSecurityFixes ?? (() => unstubbed("setAutomatedSecurityFixes")),
-		privateVulnerabilityReporting: overrides.privateVulnerabilityReporting ?? (() => unstubbed("privateVulnerabilityReporting")),
-		setPrivateVulnerabilityReporting: overrides.setPrivateVulnerabilityReporting ?? (() => unstubbed("setPrivateVulnerabilityReporting"))
+		vulnerabilityAlerts: overrides.vulnerabilityAlerts ?? (() => dies("vulnerabilityAlerts")),
+		setVulnerabilityAlerts: overrides.setVulnerabilityAlerts ?? (() => dies("setVulnerabilityAlerts")),
+		automatedSecurityFixes: overrides.automatedSecurityFixes ?? (() => dies("automatedSecurityFixes")),
+		setAutomatedSecurityFixes: overrides.setAutomatedSecurityFixes ?? (() => dies("setAutomatedSecurityFixes")),
+		privateVulnerabilityReporting: overrides.privateVulnerabilityReporting ?? (() => dies("privateVulnerabilityReporting")),
+		setPrivateVulnerabilityReporting: overrides.setPrivateVulnerabilityReporting ?? (() => dies("setPrivateVulnerabilityReporting"))
 	});
 	/** {@link RepositorySecurity.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(RepositorySecurity, RepositorySecurity.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`RepositorySecurity.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("RepositorySecurity.makeTest");
 const make = (client) => {
 	return {
 		vulnerabilityAlerts: Effect.fn("RepositorySecurity.vulnerabilityAlerts")(function* () {

package/RepositoryVariable.js

@@ -1,3 +1,4 @@
+import { unstubbed } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { Context, Effect, Layer } from "effect";
@@ -40,21 +41,19 @@ var RepositoryVariable = class RepositoryVariable extends Context.Service()("@ef
 	* further down throws at import time with a clean typecheck.
 	*/
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		set: overrides.set ?? (() => unstubbed("set")),
-		list: overrides.list ?? (() => unstubbed("list")),
-		delete: overrides.delete ?? (() => unstubbed("delete")),
-		setForEnvironment: overrides.setForEnvironment ?? (() => unstubbed("setForEnvironment")),
-		listForEnvironment: overrides.listForEnvironment ?? (() => unstubbed("listForEnvironment")),
-		deleteForEnvironment: overrides.deleteForEnvironment ?? (() => unstubbed("deleteForEnvironment"))
+		set: overrides.set ?? (() => dies("set")),
+		list: overrides.list ?? (() => dies("list")),
+		delete: overrides.delete ?? (() => dies("delete")),
+		setForEnvironment: overrides.setForEnvironment ?? (() => dies("setForEnvironment")),
+		listForEnvironment: overrides.listForEnvironment ?? (() => dies("listForEnvironment")),
+		deleteForEnvironment: overrides.deleteForEnvironment ?? (() => dies("deleteForEnvironment"))
 	});
 	/** {@link RepositoryVariable.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(RepositoryVariable, RepositoryVariable.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`RepositoryVariable.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("RepositoryVariable.makeTest");
 const make = (client) => {
 	/**
 	* Does this variable already exist? One by-name read, not a listing.

package/Ruleset.js

@@ -1,4 +1,5 @@
 import { GitHubError } from "./GitHubError.js";
+import { unstubbed } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { Context, Effect, Layer } from "effect";
@@ -52,20 +53,18 @@ var Ruleset = class Ruleset extends Context.Service()("@effected/github/Ruleset"
 	* further down throws at import time with a clean typecheck.
 	*/
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		upsert: overrides.upsert ?? (() => unstubbed("upsert")),
-		list: overrides.list ?? (() => unstubbed("list")),
-		delete: overrides.delete ?? (() => unstubbed("delete")),
-		teamId: overrides.teamId ?? (() => unstubbed("teamId")),
-		roleId: overrides.roleId ?? (() => unstubbed("roleId"))
+		upsert: overrides.upsert ?? (() => dies("upsert")),
+		list: overrides.list ?? (() => dies("list")),
+		delete: overrides.delete ?? (() => dies("delete")),
+		teamId: overrides.teamId ?? (() => dies("teamId")),
+		roleId: overrides.roleId ?? (() => dies("roleId"))
 	});
 	/** {@link Ruleset.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(Ruleset, Ruleset.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`Ruleset.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("Ruleset.makeTest");
 /** An inherited ruleset belongs to the organization and is not this repository's to write. */
 const isOwnedByRepository = (ruleset) => ruleset.source_type !== "Organization";
 const make = (client) => {

package/WorkflowDispatch.js

@@ -1,4 +1,5 @@
 import { GitHubError } from "./GitHubError.js";
+import { unstubbed, unstubbedRead } from "./internal/unstubbed.js";
 import { GitHubClient } from "./GitHubClient.js";
 import { Repo } from "./Repo.js";
 import { numericId } from "./internal/ids.js";
@@ -75,21 +76,20 @@ const DEFAULT_TIMEOUT = Duration.minutes(5);
 var WorkflowDispatch = class WorkflowDispatch extends Context.Service()("@effected/github/WorkflowDispatch") {
 	/** The live service, built over a `GitHubClient`. */
 	static layer = Layer.effect(this, Effect.map(GitHubClient, (client) => make(client)));
-	/** An in-memory double; unstubbed members die naming themselves. */
+	/** An in-memory double; an unstubbed member dies when run, naming itself. */
 	static makeTest = (overrides = {}) => ({
-		dispatch: overrides.dispatch ?? (() => unstubbed("dispatch")),
-		dispatchWithRun: overrides.dispatchWithRun ?? (() => unstubbed("dispatchWithRun")),
-		runStatus: overrides.runStatus ?? (() => unstubbed("runStatus")),
-		cancelRun: overrides.cancelRun ?? (() => unstubbed("cancelRun")),
-		list: overrides.list ?? Effect.sync(() => unstubbed("list")),
-		dispatchAndWait: overrides.dispatchAndWait ?? (() => unstubbed("dispatchAndWait"))
+		dispatch: overrides.dispatch ?? (() => dies("dispatch")),
+		dispatchWithRun: overrides.dispatchWithRun ?? (() => dies("dispatchWithRun")),
+		runStatus: overrides.runStatus ?? (() => dies("runStatus")),
+		cancelRun: overrides.cancelRun ?? (() => dies("cancelRun")),
+		list: overrides.list ?? unread("list"),
+		dispatchAndWait: overrides.dispatchAndWait ?? (() => dies("dispatchAndWait"))
 	});
 	/** {@link WorkflowDispatch.makeTest} behind a `Layer`. */
 	static layerTest = (overrides = {}) => Layer.succeed(WorkflowDispatch, WorkflowDispatch.makeTest(overrides));
 };
-const unstubbed = (member) => {
-	throw new Error(`WorkflowDispatch.makeTest: ${member}() was called but not stubbed — pass an override.`);
-};
+const dies = unstubbed("WorkflowDispatch.makeTest");
+const unread = unstubbedRead("WorkflowDispatch.makeTest");
 const statusOf = (raw) => WorkflowRunStatus.make({
 	id: numericId(raw.id),
 	status: raw.status ?? "unknown",

package/index.d.ts

@@ -174,11 +174,12 @@ interface ActionsOidcVerifyOptions {
  *
  * @public
  */
-export declare const ActionsOidc: {
+export declare class ActionsOidc {
+  private constructor();
   /** The Actions OIDC issuer, `https://token.actions.githubusercontent.com`. */
-  readonly issuer: "https://token.actions.githubusercontent.com";
+  static readonly issuer: "https://token.actions.githubusercontent.com";
   /** Verify a runner-issued OIDC token: signature against GitHub's JWKS, iss, aud, exp/nbf, then typed claims. */
-  readonly verify: (token: string, options: ActionsOidcVerifyOptions) => Effect.Effect<ActionsOidcClaims, JwtError, JwksResolver>;
+  static readonly verify: (token: string, options: ActionsOidcVerifyOptions) => Effect.Effect<ActionsOidcClaims, JwtError, JwksResolver>;
   /**
    * A valid claims payload for tests, overridable field by field.
    *
@@ -189,8 +190,8 @@ export declare const ActionsOidc: {
    * {@link ActionsOidc.issuer}; `aud` is a placeholder to override with the
    * audience under test.
    */
-  readonly testClaims: (overrides?: Readonly<Record<string, unknown>>) => Record<string, unknown>;
-};
+  static readonly testClaims: (overrides?: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+}
 /**
  * Why a GitHub call failed, as a value you can branch on.
  *
@@ -864,7 +865,7 @@ interface RecordedCall {
 }
 /**
  * A raw HTTP failure recorded for {@link GitHubClient.layerFixture}, made by
- * {@link (GitHubFixtures:variable).failure}.
+ * {@link (GitHubFixtures:class).failure}.
  *
  * @remarks
  * Branded, so a fixture's data payload that happens to have a `status` and a
@@ -894,7 +895,8 @@ export declare class RawFailure {
  *
  * @public
  */
-export declare const GitHubFixtures: {
+export declare class GitHubFixtures {
+  private constructor();
   /**
    * A raw failure: what GitHub answered, classified at call time by the same
    * classifier the live client uses.
@@ -924,12 +926,12 @@ export declare const GitHubFixtures: {
    * });
    * ```
    */
-  readonly failure: (response: {
+  static readonly failure: (response: {
     readonly status: number;
     readonly headers?: Readonly<Record<string, string>> | undefined;
     readonly body?: unknown;
   }) => RawFailure;
-};
+}
 /**
  * A recorded response table for {@link GitHubClient.layerFixture}.
  *
@@ -944,7 +946,7 @@ export interface GitHubFixtures {
    * is how a suite stubs a 404 (or a rate-limit, or a 422) deliberately,
    * rather than relying on a route's absence to produce one — absence is a
    * wiring mistake and {@link (GitHubFixtures:interface).unstubbed} treats it as
-   * such. A {@link RawFailure} from {@link (GitHubFixtures:variable).failure}
+   * such. A {@link RawFailure} from {@link (GitHubFixtures:class).failure}
    * fails it too, classified from GitHub's raw response.
    *
    * A value of `undefined` counts as unstubbed, so stub a route that answers
@@ -1088,7 +1090,7 @@ export declare class GitHubClient extends GitHubClient_base {
    *
    * **It records every call it serves, including one that fails.** A call
    * answered by a recorded `GitHubError` or a
-   * {@link (GitHubFixtures:variable).failure} is recorded before it fails, so
+   * {@link (GitHubFixtures:class).failure} is recorded before it fails, so
    * one fixture both records the calls and classifies a raw failure the way
    * the live client would; there is no need to classify by hand inside a
    * {@link GitHubClient.layerTest} handler.
@@ -1249,7 +1251,7 @@ declare const ArtifactMetadata_base: Context.ServiceClass<ArtifactMetadata, "@ef
 export declare class ArtifactMetadata extends ArtifactMetadata_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<ArtifactMetadata, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<ArtifactMetadataShape>) => ArtifactMetadataShape;
   /** {@link ArtifactMetadata.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<ArtifactMetadataShape>) => Layer.Layer<ArtifactMetadata>;
@@ -1317,7 +1319,7 @@ declare const Attestation_base: Context.ServiceClass<Attestation, "@effected/git
 export declare class Attestation extends Attestation_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<Attestation, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<AttestationShape>) => AttestationShape;
   /** {@link Attestation.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<AttestationShape>) => Layer.Layer<Attestation>;
@@ -1510,7 +1512,7 @@ declare const AuthenticatedApp_base: Context.ServiceClass<AuthenticatedApp, "@ef
 export declare class AuthenticatedApp extends AuthenticatedApp_base {
   /** The live service, built over an App-JWT `GitHubClient`. */
   static readonly layer: Layer.Layer<AuthenticatedApp, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<AuthenticatedAppShape>) => AuthenticatedAppShape;
   /** {@link AuthenticatedApp.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<AuthenticatedAppShape>) => Layer.Layer<AuthenticatedApp>;
@@ -1915,7 +1917,7 @@ declare const CheckRun_base: Context.ServiceClass<CheckRun, "@effected/github/Ch
 export declare class CheckRun extends CheckRun_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<CheckRun, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<CheckRunShape>) => CheckRunShape;
   /** {@link CheckRun.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<CheckRunShape>) => Layer.Layer<CheckRun>;
@@ -2003,7 +2005,7 @@ export declare class CodeScanning extends CodeScanning_base {
    * with a clean typecheck.
    */
   static readonly layer: Layer.Layer<CodeScanning, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<CodeScanningShape>) => CodeScanningShape;
   /** {@link CodeScanning.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<CodeScanningShape>) => Layer.Layer<CodeScanning>;
@@ -2080,7 +2082,7 @@ export declare class DeploymentEnvironment extends DeploymentEnvironment_base {
    * further down throws at import time with a clean typecheck.
    */
   static readonly layer: Layer.Layer<DeploymentEnvironment, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<DeploymentEnvironmentShape>) => DeploymentEnvironmentShape;
   /** {@link DeploymentEnvironment.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<DeploymentEnvironmentShape>) => Layer.Layer<DeploymentEnvironment>;
@@ -2192,7 +2194,7 @@ export declare class GitBranch extends GitBranch_base {
    * layer is built.
    */
   static readonly layer: Layer.Layer<GitBranch, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitBranchShape>) => GitBranchShape;
   /** {@link GitBranch.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitBranchShape>) => Layer.Layer<GitBranch>;
@@ -2328,7 +2330,7 @@ declare const GitCommit_base: Context.ServiceClass<GitCommit, "@effected/github/
 export declare class GitCommit extends GitCommit_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<GitCommit, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitCommitShape>) => GitCommitShape;
   /** {@link GitCommit.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitCommitShape>) => Layer.Layer<GitCommit>;
@@ -2372,7 +2374,7 @@ declare const InstallationTokenStore_base: Context.ServiceClass<InstallationToke
 export declare class InstallationTokenStore extends InstallationTokenStore_base {
   /** An in-process store over a `Ref`, expiring entries against `Clock`. */
   static readonly layerMemory: Layer.Layer<InstallationTokenStore>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<InstallationTokenStoreShape>) => InstallationTokenStoreShape;
   /** {@link InstallationTokenStore.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<InstallationTokenStoreShape>) => Layer.Layer<InstallationTokenStore>;
@@ -2875,7 +2877,7 @@ export declare class GitHubApp extends GitHubApp_base {
    * ```
    */
   static readonly cachedClientLayer: (request: CachedTokenRequest, options?: GitHubAppOptions) => Layer.Layer<GitHubClient, GitHubAppError, GitHubApp | InstallationTokenStore>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitHubAppShape>) => GitHubAppShape;
   /** {@link GitHubApp.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitHubAppShape>) => Layer.Layer<GitHubApp>;
@@ -3077,7 +3079,7 @@ declare const GitHubCommit_base: Context.ServiceClass<GitHubCommit, "@effected/g
 export declare class GitHubCommit extends GitHubCommit_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<GitHubCommit, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitHubCommitShape>) => GitHubCommitShape;
   /** {@link GitHubCommit.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitHubCommitShape>) => Layer.Layer<GitHubCommit>;
@@ -3137,7 +3139,7 @@ declare const GitHubContent_base: Context.ServiceClass<GitHubContent, "@effected
 export declare class GitHubContent extends GitHubContent_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<GitHubContent, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitHubContentShape>) => GitHubContentShape;
   /** {@link GitHubContent.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitHubContentShape>) => Layer.Layer<GitHubContent>;
@@ -3233,7 +3235,7 @@ declare const PullRequestComment_base: Context.ServiceClass<PullRequestComment,
 export declare class PullRequestComment extends PullRequestComment_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<PullRequestComment, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<PullRequestCommentShape>) => PullRequestCommentShape;
   /** {@link PullRequestComment.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<PullRequestCommentShape>) => Layer.Layer<PullRequestComment>;
@@ -3390,7 +3392,7 @@ declare const GitHubIssue_base: Context.ServiceClass<GitHubIssue, "@effected/git
 export declare class GitHubIssue extends GitHubIssue_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<GitHubIssue, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitHubIssueShape>) => GitHubIssueShape;
   /** {@link GitHubIssue.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitHubIssueShape>) => Layer.Layer<GitHubIssue>;
@@ -3510,7 +3512,7 @@ declare const GitHubRelease_base: Context.ServiceClass<GitHubRelease, "@effected
 export declare class GitHubRelease extends GitHubRelease_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<GitHubRelease, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitHubReleaseShape>) => GitHubReleaseShape;
   /** {@link GitHubRelease.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitHubReleaseShape>) => Layer.Layer<GitHubRelease>;
@@ -3750,7 +3752,7 @@ declare const GitHubRepository_base: Context.ServiceClass<GitHubRepository, "@ef
 export declare class GitHubRepository extends GitHubRepository_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<GitHubRepository, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitHubRepositoryShape>) => GitHubRepositoryShape;
   /** {@link GitHubRepository.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitHubRepositoryShape>) => Layer.Layer<GitHubRepository>;
@@ -3880,7 +3882,7 @@ declare const GitTag_base: Context.ServiceClass<GitTag, "@effected/github/GitTag
 export declare class GitTag extends GitTag_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<GitTag, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<GitTagShape>) => GitTagShape;
   /** {@link GitTag.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<GitTagShape>) => Layer.Layer<GitTag>;
@@ -4079,7 +4081,7 @@ declare const PullRequest_base: Context.ServiceClass<PullRequest, "@effected/git
 export declare class PullRequest extends PullRequest_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<PullRequest, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<PullRequestShape>) => PullRequestShape;
   /** {@link PullRequest.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<PullRequestShape>) => Layer.Layer<PullRequest>;
@@ -4175,7 +4177,7 @@ export declare class RepositorySecret extends RepositorySecret_base {
    * further down throws at import time with a clean typecheck.
    */
   static readonly layer: Layer.Layer<RepositorySecret, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<RepositorySecretShape>) => RepositorySecretShape;
   /** {@link RepositorySecret.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<RepositorySecretShape>) => Layer.Layer<RepositorySecret>;
@@ -4255,7 +4257,7 @@ export declare class RepositorySecurity extends RepositorySecurity_base {
    * further down throws at import time with a clean typecheck.
    */
   static readonly layer: Layer.Layer<RepositorySecurity, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<RepositorySecurityShape>) => RepositorySecurityShape;
   /** {@link RepositorySecurity.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<RepositorySecurityShape>) => Layer.Layer<RepositorySecurity>;
@@ -4360,7 +4362,7 @@ export declare class RepositoryVariable extends RepositoryVariable_base {
    * further down throws at import time with a clean typecheck.
    */
   static readonly layer: Layer.Layer<RepositoryVariable, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<RepositoryVariableShape>) => RepositoryVariableShape;
   /** {@link RepositoryVariable.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<RepositoryVariableShape>) => Layer.Layer<RepositoryVariable>;
@@ -4490,7 +4492,7 @@ export declare class Ruleset extends Ruleset_base {
    * further down throws at import time with a clean typecheck.
    */
   static readonly layer: Layer.Layer<Ruleset, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<RulesetShape>) => RulesetShape;
   /** {@link Ruleset.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<RulesetShape>) => Layer.Layer<Ruleset>;
@@ -4801,7 +4803,7 @@ declare const WorkflowDispatch_base: Context.ServiceClass<WorkflowDispatch, "@ef
 export declare class WorkflowDispatch extends WorkflowDispatch_base {
   /** The live service, built over a `GitHubClient`. */
   static readonly layer: Layer.Layer<WorkflowDispatch, never, GitHubClient>;
-  /** An in-memory double; unstubbed members die naming themselves. */
+  /** An in-memory double; an unstubbed member dies when run, naming itself. */
   static readonly makeTest: (overrides?: Partial<WorkflowDispatchShape>) => WorkflowDispatchShape;
   /** {@link WorkflowDispatch.makeTest} behind a `Layer`. */
   static readonly layerTest: (overrides?: Partial<WorkflowDispatchShape>) => Layer.Layer<WorkflowDispatch>;

package/internal/unstubbed.js

@@ -0,0 +1,25 @@
+import { Effect } from "effect";
+
+// src/internal/unstubbed.ts
+/**
+* The die-on-call members of `<double>.makeTest`: `dies("get")` is an `Effect`
+* that defects naming `get()` when run. Each package double binds its own name
+* once, then lists its members. `advice` replaces the default "pass a
+* `<member>` override" tail for a double with a better remedy to name.
+*
+* @internal
+*/
+const unstubbed = (double, advice) => (member) => Effect.die(/* @__PURE__ */ new Error(`${double}: ${member}() was called but not stubbed — ${advice ?? `pass a \`${member}\` override.`}`));
+/**
+* The die-on-read members of `<double>.makeTest`: a **value** member (an
+* `Effect` the shape holds rather than a function returning one) has no call
+* to defer to, so `unread("settings")` is the `Effect` the double holds in its
+* place, and it defects naming `settings` when run. Dying while BUILDING the
+* double would fail every test that provides it rather than the ones that
+* read the member.
+*
+* @internal
+*/
+const unstubbedRead = (double) => (member) => Effect.die(/* @__PURE__ */ new Error(`${double}: ${member} was read but not stubbed — pass a \`${member}\` override.`));
+
+export { unstubbed, unstubbedRead };