@drkmttr/adhere 0.7.1 → 0.8.0

package/presets/effect/basics/fn-for-named-effects.md

@@ -1,19 +0,0 @@
----
-description: A named function that returns an Effect must be defined with Effect.fn so the call site is traced. An Effect held in a constant, such as `const program = Effect.gen(...)`, is not a function and is not in scope.
----
-
-```ts must
-const processUser = Effect.fn("processUser")(function* (userId: string) {
-  yield* Effect.logInfo(`Processing user ${userId}`);
-  const user = yield* getUser(userId);
-  return yield* processData(user);
-});
-```
-
-```ts never
-const loadUser = (id: string) =>
-  Effect.gen(function* () {
-    const repo = yield* UserRepo;
-    return yield* repo.find(id);
-  });
-```

package/presets/effect/data/decode-json-with-schema.md

@@ -1,18 +0,0 @@
----
-description: JSON crossing a boundary must be decoded with Schema.fromJsonString, never with JSON.parse followed by a cast.
----
-
-```ts must
-const MoveFromJson = Schema.fromJsonString(Move);
-
-const program = Effect.gen(function* () {
-  const jsonString = '{"from":{"row":"A","column":"1"},"to":{"row":"B","column":"2"}}';
-  const move = yield* Schema.decodeUnknownEffect(MoveFromJson)(jsonString);
-  const json = yield* Schema.encodeEffect(MoveFromJson)(move);
-  return json;
-});
-```
-
-```ts never
-const settings = JSON.parse(text) as Settings;
-```

package/presets/effect/errors/domain-errors-are-tagged.md

@@ -1,19 +0,0 @@
----
-description: A domain failure must be a Schema.TaggedError with its own tag, never a bare Error or a plain object.
----
-
-```ts must
-class ValidationError extends Schema.TaggedError<ValidationError>()("ValidationError", {
-  field: Schema.String,
-  message: Schema.String,
-}) {}
-
-class NotFoundError extends Schema.TaggedError<NotFoundError>()("NotFoundError", {
-  resource: Schema.String,
-  id: Schema.String,
-}) {}
-```
-
-```ts never
-return yield* Effect.fail(new Error("Card declined"));
-```

package/presets/effect/platform/os-access-through-platform-services.md

@@ -1,26 +0,0 @@
----
-description: File, path, process, terminal, and HTTP access must go through Effect's platform services (FileSystem, Path, ChildProcess, Terminal, HttpClient, KeyValueStore), acquired with yield*, never through node: builtins, Bun globals, or fetch. The Bun implementations must be provided once at the entry point with BunServices.layer.
----
-
-```ts must
-import { Effect, FileSystem, Path } from "effect";
-import { HttpClient, HttpClientResponse } from "effect/unstable/http";
-import { BunRuntime, BunServices } from "@effect/platform-bun";
-
-const program = Effect.gen(function* () {
-  const fs = yield* FileSystem.FileSystem;
-  const path = yield* Path.Path;
-  const config = yield* fs.readFileString(path.join(path.resolve(), "config.json"));
-  const response = yield* HttpClient.get("https://api.example.com/users");
-  const users = yield* HttpClientResponse.schemaBodyJson(Users)(response);
-  return { config, users };
-});
-
-program.pipe(Effect.provide(BunServices.layer), BunRuntime.runMain);
-```
-
-```ts never
-import { readFileSync } from "node:fs";
-
-const settings = readFileSync("settings.json", "utf8");
-```

package/presets/effect/services/methods-have-no-requirements.md

@@ -1,20 +0,0 @@
----
-description: Service method signatures must have no requirements. Dependencies must be acquired inside the layer, never declared on the method.
----
-
-```ts must
-class Database extends Context.Service<
-  Database,
-  {
-    readonly query: (sql: string) => Effect.Effect<unknown[]>;
-    readonly execute: (sql: string) => Effect.Effect<void>;
-  }
->()("@app/Database") {}
-```
-
-```ts never
-class Orders extends Context.Service<
-  Orders,
-  { readonly save: (order: Order) => Effect.Effect<void, SaveError, Database> }
->()("@app/Orders") {}
-```

package/presets/effect/services/provide-at-entry.md

@@ -1,23 +0,0 @@
----
-description: Layers must be provided once at the program entry. A module that is not an entry point must never call Effect.provide.
----
-
-```ts must
-const appLayer = userServiceLayer.pipe(
-  Layer.provideMerge(databaseLayer),
-  Layer.provideMerge(loggerLayer),
-  Layer.provideMerge(configLayer),
-);
-
-const program = Effect.gen(function* () {
-  const users = yield* UserService;
-  yield* users.getUser();
-});
-
-const main = program.pipe(Effect.provide(appLayer));
-```
-
-```ts never
-export const getUser = (id: string) =>
-  UserRepo.find(id).pipe(Effect.provide(UserRepo.layer));
-```

package/presets/effect/testing/test-random.md

@@ -1,22 +0,0 @@
----
-description: A test that depends on randomness must control it with a fixed seed through Random.withSeed, never with Math.random or an unseeded Random.
----
-
-```ts must
-const program = Effect.gen(function* () {
-  const value1 = yield* Random.next;
-  const value2 = yield* Random.next;
-  return [value1, value2];
-});
-
-await Effect.runPromise(
-  Effect.all([program.pipe(Random.withSeed("my-seed")), program.pipe(Random.withSeed("my-seed"))]),
-); // => [[0.018368576514773527, 0.4010840628128671], [0.018368576514773527, 0.4010840628128671]]
-```
-
-```ts never
-it("creates unique ids", () => {
-  const id = Math.random().toString(36).slice(2);
-  expect(id).toHaveLength(11);
-});
-```