@timothyrusso/effect-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Timothy Russo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# @timothyrusso/effect-core
+
+The shared Effect layer an app builds on: the error model, the Logger and Config services, the
+one app runtime, the SQLite interface and migration runner, the React boundary hooks and the
+jest helpers.
+
+```sh
+npm install @timothyrusso/effect-core effect @tanstack/react-query
+```
+
+Peer dependencies: `effect` 3.x, and for `/react` also `react` and `@tanstack/react-query` v5.
+The package has no native dependency: the app passes in `expo-constants` and `expo-sqlite`.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@timothyrusso/effect-core` | Errors, Logger, Config, runtime, SQLite (safe for Metro) |
+| `@timothyrusso/effect-core/react` | `EffectRuntimeProvider`, `useEffectQuery`, `useEffectMutation`, `useErrorMessage` |
+| `@timothyrusso/effect-core/testing` | Jest helpers; loads `node:sqlite`, so import it only from tests |
+
+### `@timothyrusso/effect-core`
+
+| Export | What it is |
+| --- | --- |
+| `AppErrorBase(tag, messageKey)` | Declares a `Data.TaggedError` class with a `messageKey` and an optional `cause` |
+| `UnexpectedError` | The error every defect becomes; `cause: unknown` |
+| `toAppError(cause, isKnown?)` | For the `catch` of `Effect.tryPromise`: wraps unknown values in `UnexpectedError` |
+| `isAppError(value)` | Shape check: a string `_tag` and `messageKey` |
+| `defineAppErrors<AppError>()` | Binds the closed union; `.assertExhaustiveMessageKeys(mapper)` fails to compile on a missing or unknown tag |
+| `resolveMessageKey(error, mapper)` | The key the mapper gives an error |
+| `Logger`, `ConsoleLogger`, `NoopLogger` | The logging Tag (`error(error, context)`, `warn`, `info`, `debug`) and two Layers |
+| `Clock` | Effect's clock, re-exported |
+| `makeConfig(schema)`, `ConfigError` | A `Config` Tag and a Live Layer decoding the app's `extra`; boot fails naming the field |
+| `makeAppRuntime(layer)`, `AppServicesOf` | The one `ManagedRuntime`: `boot`, `runPromise`, `runPromiseExit`, `runFork`, `dispose` |
+| `SqliteClient`, `SqliteDatabase`, `SqlError` | The connection Tag, shaped on expo-sqlite's async API, and its error |
+| `withSqlite(operation, query)`, `trySql` | Run a query as an Effect failing with `SqlError` |
+| `runMigrations(client, migrations)` | `{ version, up }` steps keyed by `PRAGMA user_version`, each in its own transaction |
+
+### `@timothyrusso/effect-core/react`
+
+| Export | What it is |
+| --- | --- |
+| `EffectRuntimeProvider` | Puts the app runtime in context, inside `QueryClientProvider` |
+| `useEffectQuery(options)` | `useQuery` with `queryFn` an `Effect<A, AppError, AppServices>`; interrupts on unmount or key change |
+| `useEffectMutation(options)` | `useMutation` with `mutationFn` returning an Effect; `onError` gets an `AppError` |
+| `useErrorMessage(error, mapper, t)` | The translated message for an error |
+| `Register` | The interface the app augments with its services and error union |
+
+A defect becomes an `UnexpectedError` with the defect as `cause`; each failure is logged once
+through `Logger` (`error` for an `UnexpectedError`, `warn` with the tag otherwise).
+
+### `@timothyrusso/effect-core/testing`
+
+| Export | What it is |
+| --- | --- |
+| `itEffect(name, effect, layer?)`, `runTest(effect, layer?)` | Run an Effect as a jest test, with `TestContext` |
+| `makeNodeSqliteLayer()`, `makeNodeSqliteDatabase()` | `SqliteClient` over an in-memory `node:sqlite` database |
+| `collectLogs()` | A `Logger` Layer recording into `entries` |
+| `advanceClock(duration)`, `TestClock`, `TestContext` | Move time in tests |
+
+## Wiring an app
+
+```ts
+// features/core/config
+import Constants from 'expo-constants';
+export const AppConfig = makeConfig(Schema.Struct({ apiUrl: Schema.String }));
+export const ConfigLive = AppConfig.layer(() => Constants.expoConfig?.extra);
+
+// features/core/runtime
+export const runtime = makeAppRuntime(Layer.mergeAll(ConsoleLogger, ConfigLive, SqliteLive));
+export type AppServices = AppServicesOf<typeof runtime>;
+
+declare module '@timothyrusso/effect-core/react' {
+  interface Register {
+    services: AppServices;
+    error: AppError;
+  }
+}
+```
+
+Render `<EffectRuntimeProvider runtime={runtime}>` inside the `QueryClientProvider`. Once
+`Register` is filled in, a facade passing an Effect that needs a service the runtime does not
+provide, or that fails with an error outside `AppError`, does not compile.
+
+The expo-sqlite Live Layer is one line in the app:
+
+```ts
+export const SqliteLive = Layer.effect(SqliteClient, Effect.promise(() => SQLite.openDatabaseAsync('app.db')));
+```

package/dist/config/makeConfig.d.ts

@@ -0,0 +1,43 @@
+import { Context, Layer, Schema } from 'effect';
+declare const ConfigError_base: import("../errors/appError.js").AppErrorClass<"ConfigError", "errors.config">;
+/**
+ * The app configuration failed to decode at boot. `field` is the dotted path of the first bad
+ * field (`api.baseUrl`); `message` lists every problem.
+ */
+export declare class ConfigError extends ConfigError_base<{
+    readonly field: string;
+    readonly message: string;
+}> {
+}
+/** The identifier of the app's config service in the runtime's context. */
+export interface AppConfig {
+    readonly _AppConfig: 'AppConfig';
+}
+/** What {@link makeConfig} returns. */
+export interface ConfigDefinition<A> {
+    /** The Tag use cases read the decoded config from: `const config = yield* Config.Config`. */
+    readonly Config: Context.Tag<AppConfig, A>;
+    /**
+     * The Live Layer. `readExtra` is called once, when the runtime boots; its result is decoded
+     * with the schema, and a missing or invalid field fails the boot with a {@link ConfigError}.
+     * An `undefined` result counts as an empty object, so the error still names the field.
+     */
+    readonly layer: (readExtra: () => unknown) => Layer.Layer<AppConfig, ConfigError>;
+    /** A Layer holding an already decoded value, for tests. */
+    readonly layerOf: (config: A) => Layer.Layer<AppConfig>;
+}
+/**
+ * Declares the app's config from a Schema. The kit has no native dependency, so the app passes
+ * where the values come from; in an Expo app that is the `extra` block of `app.config.ts`:
+ *
+ * @example
+ * ```ts
+ * import Constants from 'expo-constants';
+ *
+ * export const AppConfig = makeConfig(Schema.Struct({ apiUrl: Schema.String }));
+ * export const ConfigLive = AppConfig.layer(() => Constants.expoConfig?.extra);
+ * ```
+ */
+export declare function makeConfig<A, I>(schema: Schema.Schema<A, I, never>): ConfigDefinition<A>;
+export {};
+//# sourceMappingURL=makeConfig.d.ts.map

package/dist/config/makeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeConfig.d.ts","sourceRoot":"","sources":["../../src/config/makeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAe,MAAM,EAAE,MAAM,QAAQ,CAAC;;AAGrE;;;GAGG;AACH,qBAAa,WAAY,SAAQ,iBAA6C;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;AAEL,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;CAClC;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAClF,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;CACzD;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAgBxF"}

package/dist/config/makeConfig.js

@@ -0,0 +1,44 @@
+import { Context, Effect, Layer, ParseResult, Schema } from 'effect';
+import { AppErrorBase } from '../errors/appError.js';
+/**
+ * The app configuration failed to decode at boot. `field` is the dotted path of the first bad
+ * field (`api.baseUrl`); `message` lists every problem.
+ */
+export class ConfigError extends AppErrorBase('ConfigError', 'errors.config') {
+}
+function describe(error) {
+    const issues = ParseResult.ArrayFormatter.formatErrorSync(error);
+    const field = issues[0]?.path.map(String).join('.') ?? '';
+    const message = issues
+        .map(issue => {
+        const path = issue.path.map(String).join('.');
+        return path === '' ? issue.message : `${path}: ${issue.message}`;
+    })
+        .join('; ');
+    return new ConfigError({ field, message: `Invalid app config: ${message}`, cause: error });
+}
+/**
+ * Declares the app's config from a Schema. The kit has no native dependency, so the app passes
+ * where the values come from; in an Expo app that is the `extra` block of `app.config.ts`:
+ *
+ * @example
+ * ```ts
+ * import Constants from 'expo-constants';
+ *
+ * export const AppConfig = makeConfig(Schema.Struct({ apiUrl: Schema.String }));
+ * export const ConfigLive = AppConfig.layer(() => Constants.expoConfig?.extra);
+ * ```
+ */
+export function makeConfig(schema) {
+    const Config = Context.GenericTag('@timothyrusso/effect-core/Config');
+    const decode = Schema.decodeUnknown(schema, { errors: 'all' });
+    return {
+        Config,
+        layer: readExtra => Layer.effect(Config, Effect.try({
+            try: () => readExtra() ?? {},
+            catch: cause => new ConfigError({ field: '', message: 'Invalid app config: reading the source threw', cause }),
+        }).pipe(Effect.flatMap(extra => Effect.mapError(decode(extra), describe)))),
+        layerOf: config => Layer.succeed(Config, config),
+    };
+}
+//# sourceMappingURL=makeConfig.js.map

package/dist/config/makeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeConfig.js","sourceRoot":"","sources":["../../src/config/makeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,YAAY,CAAC,aAAa,EAAE,eAAe,CAG1E;CAAG;AAqBL,SAAS,QAAQ,CAAC,KAA6B;IAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM;SACnB,GAAG,CAAC,KAAK,CAAC,EAAE;QACX,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACnE,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,uBAAuB,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAO,MAAkC;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAe,kCAAkC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/D,OAAO;QACL,MAAM;QACN,KAAK,EAAE,SAAS,CAAC,EAAE,CACjB,KAAK,CAAC,MAAM,CACV,MAAM,EACN,MAAM,CAAC,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE;YAC5B,KAAK,EAAE,KAAK,CAAC,EAAE,CACb,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,8CAA8C,EAAE,KAAK,EAAE,CAAC;SACjG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAC3E;QACH,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/errors/appError.d.ts

@@ -0,0 +1,55 @@
+import { type Cause } from 'effect';
+/**
+ * The shape every app error shares: a `_tag` naming the class, a `messageKey` into the app's
+ * catalog, and an optional `cause` (the original exception, a parse error, a failed response).
+ * An app's closed `AppError` union is a union of classes declared with {@link AppErrorBase}.
+ */
+export interface AnyAppError {
+    readonly _tag: string;
+    readonly messageKey: string;
+    readonly cause?: unknown;
+}
+/** The fields a subclass declares, minus the ones {@link AppErrorBase} owns. */
+type AppErrorFields<A> = {
+    readonly [P in keyof A as P extends '_tag' | 'messageKey' ? never : P]: A[P];
+};
+/**
+ * Constructor arguments: the declared fields plus an optional `cause`. The argument itself is
+ * optional when every declared field is.
+ */
+export type AppErrorArgs<A> = Record<never, never> extends AppErrorFields<A> ? [args?: AppErrorFields<A> & {
+    readonly cause?: unknown;
+}] : [args: AppErrorFields<A> & {
+    readonly cause?: unknown;
+}];
+/** An instance of a class declared with {@link AppErrorBase}. */
+export type AppErrorInstance<Tag extends string, Key extends string, A> = Cause.YieldableError & {
+    readonly _tag: Tag;
+    readonly messageKey: Key;
+} & Readonly<A>;
+/**
+ * The class {@link AppErrorBase} returns. Extend it with the error's own fields as the type
+ * argument; `messageKey` is available on the class and on every instance.
+ */
+export interface AppErrorClass<Tag extends string, Key extends string> {
+    new <A extends Record<string, unknown> = Record<never, never>>(...args: AppErrorArgs<A>): AppErrorInstance<Tag, Key, A>;
+    readonly messageKey: Key;
+}
+/**
+ * Declares a `Data.TaggedError` class that carries a catalog `messageKey` and accepts an optional
+ * `cause`. Instances are yieldable in `Effect.gen`, compare structurally and are real `Error`s.
+ *
+ * @example
+ * ```ts
+ * export class TripNotFound extends AppErrorBase('TripNotFound', 'errors.tripNotFound')<{
+ *   readonly tripId: string;
+ * }> {}
+ *
+ * yield* new TripNotFound({ tripId, cause: response });
+ * ```
+ */
+export declare function AppErrorBase<const Tag extends string, const Key extends string>(tag: Tag, messageKey: Key): AppErrorClass<Tag, Key>;
+/** True for any value shaped like an app error: an object with a string `_tag` and `messageKey`. */
+export declare function isAppError(value: unknown): value is AnyAppError;
+export {};
+//# sourceMappingURL=appError.d.ts.map

package/dist/errors/appError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appError.d.ts","sourceRoot":"","sources":["../../src/errors/appError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAQ,MAAM,QAAQ,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,gFAAgF;AAChF,KAAK,cAAc,CAAC,CAAC,IAAI;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,YAAY,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE1G;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IACxB,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,GAC1C,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GACzD,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE/D,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAAC,IAAI,KAAK,CAAC,cAAc,GAAG;IAC/F,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;CAC1B,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEhB;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM;IACnE,KAAK,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAC3D,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,GAAG,SAAS,MAAM,EAC7E,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,GAAG,GACd,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAQzB;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAI/D"}

package/dist/errors/appError.js

@@ -0,0 +1,31 @@
+import { Data } from 'effect';
+/**
+ * Declares a `Data.TaggedError` class that carries a catalog `messageKey` and accepts an optional
+ * `cause`. Instances are yieldable in `Effect.gen`, compare structurally and are real `Error`s.
+ *
+ * @example
+ * ```ts
+ * export class TripNotFound extends AppErrorBase('TripNotFound', 'errors.tripNotFound')<{
+ *   readonly tripId: string;
+ * }> {}
+ *
+ * yield* new TripNotFound({ tripId, cause: response });
+ * ```
+ */
+export function AppErrorBase(tag, messageKey) {
+    class Base extends Data.TaggedError(tag) {
+        static messageKey = messageKey;
+        messageKey = messageKey;
+    }
+    // NOTE: Data.TaggedError's constructor is generic in the fields; this class keeps that
+    // signature and adds messageKey, which TypeScript cannot express on the class expression itself.
+    return Base;
+}
+/** True for any value shaped like an app error: an object with a string `_tag` and `messageKey`. */
+export function isAppError(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate._tag === 'string' && typeof candidate.messageKey === 'string';
+}
+//# sourceMappingURL=appError.js.map

package/dist/errors/appError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appError.js","sourceRoot":"","sources":["../../src/errors/appError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,IAAI,EAAE,MAAM,QAAQ,CAAC;AA0C1C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAQ,EACR,UAAe;IAEf,MAAM,IAAK,SAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAA+B;QACpE,MAAM,CAAU,UAAU,GAAG,UAAU,CAAC;QAC/B,UAAU,GAAG,UAAU,CAAC;;IAEnC,uFAAuF;IACvF,iGAAiG;IACjG,OAAO,IAA0C,CAAC;AACpD,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAmE,CAAC;IACtF,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ,CAAC;AACxF,CAAC"}

package/dist/errors/messageKeys.d.ts

@@ -0,0 +1,36 @@
+import type { AnyAppError } from './appError.js';
+import type { UnexpectedError } from './unexpected.js';
+/**
+ * One catalog key per error tag of `E`. Being a mapped type over the tags, a missing tag is a
+ * compile error and so is a tag that is not in the union.
+ */
+export type MessageKeyMapper<E extends AnyAppError, K extends string = string> = {
+    readonly [Tag in E['_tag']]: K;
+};
+/** What {@link defineAppErrors} returns: helpers bound to the app's closed error union. */
+export interface AppErrors<E extends AnyAppError> {
+    /**
+     * Returns `mapper` unchanged. Its only job is the type check: every tag of the union, plus
+     * `UnexpectedError`, has a key, and no other tag does.
+     */
+    assertExhaustiveMessageKeys<K extends string>(mapper: MessageKeyMapper<E | UnexpectedError, K>): MessageKeyMapper<E | UnexpectedError, K>;
+}
+/**
+ * Declares the app's closed error union once, in `features/core/error`.
+ *
+ * @example
+ * ```ts
+ * export type AppError = TripNotFound | SqlError | ConfigError | UnexpectedError;
+ * const appErrors = defineAppErrors<AppError>();
+ * export const errorTagToMessageKey = appErrors.assertExhaustiveMessageKeys({
+ *   TripNotFound: 'errors.tripNotFound',
+ *   SqlError: 'errors.storage',
+ *   ConfigError: 'errors.config',
+ *   UnexpectedError: 'errors.unexpected',
+ * });
+ * ```
+ */
+export declare function defineAppErrors<E extends AnyAppError>(): AppErrors<E>;
+/** The catalog key `mapper` gives `error`. */
+export declare function resolveMessageKey<E extends AnyAppError, K extends string>(error: E, mapper: MessageKeyMapper<E, K>): K;
+//# sourceMappingURL=messageKeys.d.ts.map

package/dist/errors/messageKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageKeys.d.ts","sourceRoot":"","sources":["../../src/errors/messageKeys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC/E,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;CAC/B,CAAC;AAEF,2FAA2F;AAC3F,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,WAAW;IAC9C;;;OAGG;IACH,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAC1C,MAAM,EAAE,gBAAgB,CAAC,CAAC,GAAG,eAAe,EAAE,CAAC,CAAC,GAC/C,gBAAgB,CAAC,CAAC,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAIrE;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM,EACvE,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,CAAC,CAGH"}

package/dist/errors/messageKeys.js

@@ -0,0 +1,26 @@
+/**
+ * Declares the app's closed error union once, in `features/core/error`.
+ *
+ * @example
+ * ```ts
+ * export type AppError = TripNotFound | SqlError | ConfigError | UnexpectedError;
+ * const appErrors = defineAppErrors<AppError>();
+ * export const errorTagToMessageKey = appErrors.assertExhaustiveMessageKeys({
+ *   TripNotFound: 'errors.tripNotFound',
+ *   SqlError: 'errors.storage',
+ *   ConfigError: 'errors.config',
+ *   UnexpectedError: 'errors.unexpected',
+ * });
+ * ```
+ */
+export function defineAppErrors() {
+    return {
+        assertExhaustiveMessageKeys: mapper => mapper,
+    };
+}
+/** The catalog key `mapper` gives `error`. */
+export function resolveMessageKey(error, mapper) {
+    const tag = error._tag;
+    return mapper[tag];
+}
+//# sourceMappingURL=messageKeys.js.map

package/dist/errors/messageKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageKeys.js","sourceRoot":"","sources":["../../src/errors/messageKeys.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,2BAA2B,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;KAC9C,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB,CAC/B,KAAQ,EACR,MAA8B;IAE9B,MAAM,GAAG,GAAc,KAAK,CAAC,IAAI,CAAC;IAClC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/errors/unexpected.d.ts

@@ -0,0 +1,26 @@
+import { type AnyAppError } from './appError.js';
+declare const UnexpectedError_base: import("./appError.js").AppErrorClass<"UnexpectedError", "errors.unexpected">;
+/**
+ * The one error that is not a domain failure: a defect, a thrown exception or a rejection nobody
+ * anticipated. The runtime boundary turns every defect into this, and `toAppError` wraps unknown
+ * values in it. `cause` holds the original value.
+ */
+export declare class UnexpectedError extends UnexpectedError_base<{
+    readonly cause: unknown;
+}> {
+}
+/**
+ * Turns an unknown thrown value into an app error, for the `catch` callback of
+ * `Effect.tryPromise` and `Effect.try`. An `UnexpectedError` passes through unchanged; anything
+ * else is wrapped as its `cause`. Pass `isKnown` to let the app's own errors through as they are.
+ *
+ * @example
+ * ```ts
+ * Effect.tryPromise({ try: () => api.trip(id), catch: toAppError });
+ * Effect.tryPromise({ try: () => repo.save(trip), catch: cause => toAppError(cause, isTripError) });
+ * ```
+ */
+export declare function toAppError(cause: unknown): UnexpectedError;
+export declare function toAppError<E extends AnyAppError>(cause: unknown, isKnown: (value: unknown) => value is E): E | UnexpectedError;
+export {};
+//# sourceMappingURL=unexpected.d.ts.map

package/dist/errors/unexpected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unexpected.d.ts","sourceRoot":"","sources":["../../src/errors/unexpected.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,eAAe,CAAC;;AAE/D;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,qBAAqD;IACxF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;AAEL;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAAC;AAC5D,wBAAgB,UAAU,CAAC,CAAC,SAAS,WAAW,EAC9C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACtC,CAAC,GAAG,eAAe,CAAC"}

package/dist/errors/unexpected.js

@@ -0,0 +1,16 @@
+import { AppErrorBase } from './appError.js';
+/**
+ * The one error that is not a domain failure: a defect, a thrown exception or a rejection nobody
+ * anticipated. The runtime boundary turns every defect into this, and `toAppError` wraps unknown
+ * values in it. `cause` holds the original value.
+ */
+export class UnexpectedError extends AppErrorBase('UnexpectedError', 'errors.unexpected') {
+}
+export function toAppError(cause, isKnown) {
+    if (cause instanceof UnexpectedError)
+        return cause;
+    if (isKnown?.(cause))
+        return cause;
+    return new UnexpectedError({ cause });
+}
+//# sourceMappingURL=unexpected.js.map

package/dist/errors/unexpected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unexpected.js","sourceRoot":"","sources":["../../src/errors/unexpected.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY,CAAC,iBAAiB,EAAE,mBAAmB,CAEtF;CAAG;AAkBL,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,OAAwC;IAExC,IAAI,KAAK,YAAY,eAAe;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,OAAO,EAAE,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @timothyrusso/effect-core. Shared Effect layer: AppError, Logger, Config, runtime, SqliteClient,
+ * React hooks (`/react`) and testing helpers (`/testing`).
+ */
+/** Effect's `Clock` service, re-exported so use cases read time through it and tests control it. */
+export { Clock } from 'effect';
+export { type AppConfig, type ConfigDefinition, ConfigError, makeConfig } from './config/makeConfig.js';
+export { type AnyAppError, type AppErrorArgs, AppErrorBase, type AppErrorClass, type AppErrorInstance, isAppError, } from './errors/appError.js';
+export { type AppErrors, defineAppErrors, type MessageKeyMapper, resolveMessageKey } from './errors/messageKeys.js';
+export { toAppError, UnexpectedError } from './errors/unexpected.js';
+export { ConsoleLogger, type LogContext, Logger, type LoggerService, NoopLogger } from './logger/logger.js';
+export { type AppRuntime, type AppServicesOf, makeAppRuntime, type RunOptions } from './runtime/makeAppRuntime.js';
+export { type Migration, type MigrationReport, runMigrations } from './sqlite/migrations.js';
+export { SqlError, SqliteClient, type SqliteDatabase, type SqlParams, type SqlRunResult, type SqlValue, trySql, withSqlite, } from './sqlite/sqliteClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oGAAoG;AACpG,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,SAAS,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACpH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACnH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,MAAM,EACN,UAAU,GACX,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @timothyrusso/effect-core. Shared Effect layer: AppError, Logger, Config, runtime, SqliteClient,
+ * React hooks (`/react`) and testing helpers (`/testing`).
+ */
+/** Effect's `Clock` service, re-exported so use cases read time through it and tests control it. */
+export { Clock } from 'effect';
+export { ConfigError, makeConfig } from './config/makeConfig.js';
+export { AppErrorBase, isAppError, } from './errors/appError.js';
+export { defineAppErrors, resolveMessageKey } from './errors/messageKeys.js';
+export { toAppError, UnexpectedError } from './errors/unexpected.js';
+export { ConsoleLogger, Logger, NoopLogger } from './logger/logger.js';
+export { makeAppRuntime } from './runtime/makeAppRuntime.js';
+export { runMigrations } from './sqlite/migrations.js';
+export { SqlError, SqliteClient, trySql, withSqlite, } from './sqlite/sqliteClient.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oGAAoG;AACpG,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAyC,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EAGL,YAAY,EAGZ,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkB,eAAe,EAAyB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACpH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAmB,MAAM,EAAsB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAuC,cAAc,EAAmB,MAAM,6BAA6B,CAAC;AACnH,OAAO,EAAwC,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EACL,QAAQ,EACR,YAAY,EAKZ,MAAM,EACN,UAAU,GACX,MAAM,0BAA0B,CAAC"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,25 @@
+import { Context, Effect, Layer } from 'effect';
+/** Structured data attached to a log line: a query key, an id, the operation that failed. */
+export type LogContext = Readonly<Record<string, unknown>>;
+/** The logging service. Every method returns an Effect that never fails. */
+export interface LoggerService {
+    /** An error worth reporting (a Sentry Layer sends these). */
+    readonly error: (error: unknown, context?: LogContext) => Effect.Effect<void>;
+    readonly warn: (message: string, context?: LogContext) => Effect.Effect<void>;
+    readonly info: (message: string, context?: LogContext) => Effect.Effect<void>;
+    readonly debug: (message: string, context?: LogContext) => Effect.Effect<void>;
+}
+declare const Logger_base: Context.TagClass<Logger, "@timothyrusso/effect-core/Logger", LoggerService>;
+/**
+ * The app's logger. Use cases do not log: the runtime boundary (`useEffectQuery`,
+ * `useEffectMutation`) logs each failure once. Apps provide {@link ConsoleLogger} in development
+ * and their own Layer (Sentry, for example) in release builds.
+ */
+export declare class Logger extends Logger_base {
+}
+/** Writes to the console, with the context as a second argument. */
+export declare const ConsoleLogger: Layer.Layer<Logger>;
+/** Discards everything. For tests that do not assert on logs, and for silent builds. */
+export declare const NoopLogger: Layer.Layer<Logger>;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,6FAA6F;AAC7F,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAChF;;AAED;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,WAAwE;CAAG;AAEvG,oEAAoE;AACpE,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAS5C,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAKzC,CAAC"}

package/dist/logger/logger.js

@@ -0,0 +1,27 @@
+import { Context, Effect, Layer } from 'effect';
+/**
+ * The app's logger. Use cases do not log: the runtime boundary (`useEffectQuery`,
+ * `useEffectMutation`) logs each failure once. Apps provide {@link ConsoleLogger} in development
+ * and their own Layer (Sentry, for example) in release builds.
+ */
+export class Logger extends Context.Tag('@timothyrusso/effect-core/Logger')() {
+}
+/** Writes to the console, with the context as a second argument. */
+export const ConsoleLogger = Layer.succeed(Logger, {
+    // biome-ignore lint/suspicious/noConsole: this Layer is the console sink
+    error: (error, context = {}) => Effect.sync(() => console.error(error, context)),
+    // biome-ignore lint/suspicious/noConsole: this Layer is the console sink
+    warn: (message, context = {}) => Effect.sync(() => console.warn(message, context)),
+    // biome-ignore lint/suspicious/noConsole: this Layer is the console sink
+    info: (message, context = {}) => Effect.sync(() => console.info(message, context)),
+    // biome-ignore lint/suspicious/noConsole: this Layer is the console sink
+    debug: (message, context = {}) => Effect.sync(() => console.debug(message, context)),
+});
+/** Discards everything. For tests that do not assert on logs, and for silent builds. */
+export const NoopLogger = Layer.succeed(Logger, {
+    error: () => Effect.void,
+    warn: () => Effect.void,
+    info: () => Effect.void,
+    debug: () => Effect.void,
+});
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAchD;;;;GAIG;AACH,MAAM,OAAO,MAAO,SAAQ,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,EAAyB;CAAG;AAEvG,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAwB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;IACtE,yEAAyE;IACzE,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAChF,yEAAyE;IACzE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClF,yEAAyE;IACzE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClF,yEAAyE;IACzE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CACrF,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,UAAU,GAAwB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;IACnE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;IACxB,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;IACvB,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;IACvB,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;CACzB,CAAC,CAAC"}

package/dist/react/EffectRuntimeProvider.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from 'react';
+import type { Logger } from '../logger/logger.js';
+import type { AppRuntime } from '../runtime/makeAppRuntime.js';
+import type { RegisteredServices } from './register.js';
+/**
+ * The runtime the hooks run through: it provides the registered services, and `Logger`, which the
+ * boundary logs failures with.
+ */
+export type ProvidedRuntime = AppRuntime<RegisteredServices | Logger, unknown>;
+/** Props of {@link EffectRuntimeProvider}. */
+export interface EffectRuntimeProviderProps {
+    readonly runtime: ProvidedRuntime;
+    readonly children?: ReactNode;
+}
+/**
+ * Makes the app runtime available to `useEffectQuery` and `useEffectMutation`. Render it once,
+ * inside the `QueryClientProvider`, with the runtime from `makeAppRuntime`.
+ */
+export declare function EffectRuntimeProvider({ runtime, children }: EffectRuntimeProviderProps): ReactNode;
+/** The runtime from the nearest {@link EffectRuntimeProvider}; throws outside one. */
+export declare function useAppRuntime(): ProvidedRuntime;
+//# sourceMappingURL=EffectRuntimeProvider.d.ts.map

package/dist/react/EffectRuntimeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectRuntimeProvider.d.ts","sourceRoot":"","sources":["../../src/react/EffectRuntimeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,kBAAkB,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;AAI/E,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,0BAA0B,GAAG,SAAS,CAElG;AAED,sFAAsF;AACtF,wBAAgB,aAAa,IAAI,eAAe,CAI/C"}

package/dist/react/EffectRuntimeProvider.js

@@ -0,0 +1,17 @@
+import { createContext, createElement, useContext } from 'react';
+const RuntimeContext = createContext(null);
+/**
+ * Makes the app runtime available to `useEffectQuery` and `useEffectMutation`. Render it once,
+ * inside the `QueryClientProvider`, with the runtime from `makeAppRuntime`.
+ */
+export function EffectRuntimeProvider({ runtime, children }) {
+    return createElement(RuntimeContext.Provider, { value: runtime }, children);
+}
+/** The runtime from the nearest {@link EffectRuntimeProvider}; throws outside one. */
+export function useAppRuntime() {
+    const runtime = useContext(RuntimeContext);
+    if (runtime === null)
+        throw new Error('useEffectQuery and useEffectMutation need an EffectRuntimeProvider');
+    return runtime;
+}
+//# sourceMappingURL=EffectRuntimeProvider.js.map

package/dist/react/EffectRuntimeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EffectRuntimeProvider.js","sourceRoot":"","sources":["../../src/react/EffectRuntimeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,OAAO,CAAC;AAWjF,MAAM,cAAc,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAC;AAQnE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAA8B;IACrF,OAAO,aAAa,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC5G,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @timothyrusso/effect-core/react. The runtime provider and the TanStack Query hooks that run
+ * Effects at the React boundary.
+ */
+export { EffectRuntimeProvider, type EffectRuntimeProviderProps, type ProvidedRuntime, } from './EffectRuntimeProvider.js';
+export type { EffectHookError, Register, RegisteredError, RegisteredServices } from './register.js';
+export { type UseEffectMutationOptions, useEffectMutation } from './useEffectMutation.js';
+export { type UseEffectQueryOptions, useEffectQuery } from './useEffectQuery.js';
+export { useErrorMessage } from './useErrorMessage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,KAAK,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,KAAK,qBAAqB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,9 @@
+/**
+ * @timothyrusso/effect-core/react. The runtime provider and the TanStack Query hooks that run
+ * Effects at the React boundary.
+ */
+export { EffectRuntimeProvider, } from './EffectRuntimeProvider.js';
+export { useEffectMutation } from './useEffectMutation.js';
+export { useEffectQuery } from './useEffectQuery.js';
+export { useErrorMessage } from './useErrorMessage.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,qBAAqB,GAGtB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAiC,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAA8B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}