@timothyrusso/effect-core 0.1.0

package/dist/react/register.d.ts

@@ -0,0 +1,30 @@
+import type { AnyAppError } from '../errors/appError.js';
+import type { UnexpectedError } from '../errors/unexpected.js';
+/**
+ * The app registers its runtime's services and its closed error union here, once, so
+ * `useEffectQuery` and `useEffectMutation` accept only `Effect<A, AppError, AppServices>` and
+ * type `error` as `AppError`:
+ *
+ * @example
+ * ```ts
+ * declare module '@timothyrusso/effect-core/react' {
+ *   interface Register {
+ *     services: AppServices;
+ *     error: AppError;
+ *   }
+ * }
+ * ```
+ */
+export interface Register {
+}
+/** The registered `AppServices`, or `never` until the app registers them. */
+export type RegisteredServices = Register extends {
+    readonly services: infer R;
+} ? R : never;
+/** The registered `AppError` union, or any app error until the app registers one. */
+export type RegisteredError = Register extends {
+    readonly error: infer E extends AnyAppError;
+} ? E : AnyAppError;
+/** The `error` a hook reports: the registered union, plus the `UnexpectedError` a defect becomes. */
+export type EffectHookError = RegisteredError | UnexpectedError;
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/react/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,QAAQ;CAAG;AAE5B,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7F,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG,QAAQ,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,WAAW,CAAA;CAAE,GAAG,CAAC,GAAG,WAAW,CAAC;AAEjH,qGAAqG;AACrG,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC"}

package/dist/react/register.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.js.map

package/dist/react/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/react/register.ts"],"names":[],"mappings":""}

package/dist/react/runAtBoundary.d.ts

@@ -0,0 +1,13 @@
+import { Effect } from 'effect';
+import { type LogContext } from '../logger/logger.js';
+import type { ProvidedRuntime } from './EffectRuntimeProvider.js';
+import type { RegisteredError, RegisteredServices } from './register.js';
+/**
+ * Runs a hook's Effect on the app runtime and settles the promise TanStack Query expects. A defect
+ * becomes an `UnexpectedError` with the defect as `cause`. Each failure is logged once: an
+ * `UnexpectedError` through `Logger.error`, a typed failure through `Logger.warn` with its tag.
+ * The promise rejects with the error itself, not a `FiberFailure`. Aborting `signal` interrupts
+ * the fiber.
+ */
+export declare function runAtBoundary<A>(runtime: ProvidedRuntime, effect: Effect.Effect<A, RegisteredError, RegisteredServices>, context: LogContext, signal?: AbortSignal): Promise<A>;
+//# sourceMappingURL=runAtBoundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runAtBoundary.d.ts","sourceRoot":"","sources":["../../src/react/runAtBoundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAgB,MAAM,QAAQ,CAAC;AAErD,OAAO,EAAE,KAAK,UAAU,EAAU,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,kBAAkB,CAAC,EAC7D,OAAO,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/react/runAtBoundary.js

@@ -0,0 +1,23 @@
+import { Cause, Effect, Exit, Option } from 'effect';
+import { UnexpectedError } from '../errors/unexpected.js';
+import { Logger } from '../logger/logger.js';
+/**
+ * Runs a hook's Effect on the app runtime and settles the promise TanStack Query expects. A defect
+ * becomes an `UnexpectedError` with the defect as `cause`. Each failure is logged once: an
+ * `UnexpectedError` through `Logger.error`, a typed failure through `Logger.warn` with its tag.
+ * The promise rejects with the error itself, not a `FiberFailure`. Aborting `signal` interrupts
+ * the fiber.
+ */
+export async function runAtBoundary(runtime, effect, context, signal) {
+    const program = effect.pipe(Effect.catchAllDefect(defect => Effect.fail(new UnexpectedError({ cause: defect }))), Effect.tapError(error => Effect.flatMap(Logger, logger => error instanceof UnexpectedError
+        ? logger.error(error, context)
+        : logger.warn(error._tag, { ...context, error }))));
+    const exit = await runtime.runPromiseExit(program, signal === undefined ? {} : { signal });
+    if (Exit.isSuccess(exit))
+        return exit.value;
+    const failure = Cause.failureOption(exit.cause);
+    if (Option.isSome(failure))
+        throw failure.value;
+    throw Cause.squash(exit.cause);
+}
+//# sourceMappingURL=runAtBoundary.js.map

package/dist/react/runAtBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAtBoundary.js","sourceRoot":"","sources":["../../src/react/runAtBoundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAmB,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI9D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAwB,EACxB,MAA6D,EAC7D,OAAmB,EACnB,MAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CACzB,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EACpF,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CACtB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAC9B,KAAK,YAAY,eAAe;QAC9B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC;QAC9B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CACnD,CACF,CACF,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3F,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,MAAM,OAAO,CAAC,KAAK,CAAC;IAChD,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/react/useEffectMutation.d.ts

@@ -0,0 +1,19 @@
+import { type UseMutationOptions, type UseMutationResult } from '@tanstack/react-query';
+import type { Effect } from 'effect';
+import type { EffectHookError, RegisteredError, RegisteredServices } from './register.js';
+/** `useMutation` options, with `mutationFn` returning an Effect instead of a promise. */
+export interface UseEffectMutationOptions<A, TVariables = void, TOnMutateResult = unknown> extends Omit<UseMutationOptions<A, EffectHookError, TVariables, TOnMutateResult>, 'mutationFn'> {
+    /** The use case to run for `variables`. It may need only the registered `AppServices`. */
+    readonly mutationFn: (variables: TVariables) => Effect.Effect<A, RegisteredError, RegisteredServices>;
+}
+/**
+ * `useMutation` for an Effect. Failures reach `error` and `onError` as an app error, a defect as
+ * an `UnexpectedError`, and each is logged once through `Logger`.
+ *
+ * @example
+ * ```ts
+ * const rename = useEffectMutation({ mutationFn: (name: string) => renameTrip(id, name) });
+ * ```
+ */
+export declare function useEffectMutation<A, TVariables = void, TOnMutateResult = unknown>(options: UseEffectMutationOptions<A, TVariables, TOnMutateResult>): UseMutationResult<A, EffectHookError, TVariables, TOnMutateResult>;
+//# sourceMappingURL=useEffectMutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEffectMutation.d.ts","sourceRoot":"","sources":["../../src/react/useEffectMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAe,MAAM,uBAAuB,CAAC;AACrG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAG1F,yFAAyF;AACzF,MAAM,WAAW,wBAAwB,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,eAAe,GAAG,OAAO,CACvF,SAAQ,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/F,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;CACvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,eAAe,GAAG,OAAO,EAC/E,OAAO,EAAE,wBAAwB,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,GAChE,iBAAiB,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,CAAC,CAOpE"}

package/dist/react/useEffectMutation.js

@@ -0,0 +1,21 @@
+import { useMutation } from '@tanstack/react-query';
+import { useAppRuntime } from './EffectRuntimeProvider.js';
+import { runAtBoundary } from './runAtBoundary.js';
+/**
+ * `useMutation` for an Effect. Failures reach `error` and `onError` as an app error, a defect as
+ * an `UnexpectedError`, and each is logged once through `Logger`.
+ *
+ * @example
+ * ```ts
+ * const rename = useEffectMutation({ mutationFn: (name: string) => renameTrip(id, name) });
+ * ```
+ */
+export function useEffectMutation(options) {
+    const runtime = useAppRuntime();
+    const { mutationFn, ...rest } = options;
+    return useMutation({
+        ...rest,
+        mutationFn: variables => runAtBoundary(runtime, mutationFn(variables), { mutationKey: rest.mutationKey }),
+    });
+}
+//# sourceMappingURL=useEffectMutation.js.map

package/dist/react/useEffectMutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEffectMutation.js","sourceRoot":"","sources":["../../src/react/useEffectMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAErG,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiE;IAEjE,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACxC,OAAO,WAAW,CAAkD;QAClE,GAAG,IAAI;QACP,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;KAC1G,CAAC,CAAC;AACL,CAAC"}

package/dist/react/useEffectQuery.d.ts

@@ -0,0 +1,20 @@
+import { type QueryKey, type UseQueryOptions, type UseQueryResult } from '@tanstack/react-query';
+import type { Effect } from 'effect';
+import type { EffectHookError, RegisteredError, RegisteredServices } from './register.js';
+/** `useQuery` options, with `queryFn` an Effect instead of a function returning a promise. */
+export interface UseEffectQueryOptions<A, TData = A, TQueryKey extends QueryKey = QueryKey> extends Omit<UseQueryOptions<A, EffectHookError, TData, TQueryKey>, 'queryFn'> {
+    /** The use case to run. It may need only the registered `AppServices`. */
+    readonly queryFn: Effect.Effect<A, RegisteredError, RegisteredServices>;
+}
+/**
+ * `useQuery` for an Effect. The Effect runs on the app runtime; a typed failure is `error` with
+ * its own `_tag`, a defect is an `UnexpectedError` with the defect as `cause`, and each failure is
+ * logged once through `Logger`. Unmounting or changing the key interrupts the running fiber.
+ *
+ * @example
+ * ```ts
+ * const trip = useEffectQuery({ queryKey: ['trip', id], queryFn: getTrip(id) });
+ * ```
+ */
+export declare function useEffectQuery<A, TData = A, TQueryKey extends QueryKey = QueryKey>(options: UseEffectQueryOptions<A, TData, TQueryKey>): UseQueryResult<TData, EffectHookError>;
+//# sourceMappingURL=useEffectQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEffectQuery.d.ts","sourceRoot":"","sources":["../../src/react/useEffectQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAY,MAAM,uBAAuB,CAAC;AAC3G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAG1F,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,SAAS,SAAS,QAAQ,GAAG,QAAQ,CACxF,SAAQ,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC;IAC9E,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;CACzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,SAAS,SAAS,QAAQ,GAAG,QAAQ,EAChF,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,GAClD,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,CAOxC"}

package/dist/react/useEffectQuery.js

@@ -0,0 +1,22 @@
+import { useQuery } from '@tanstack/react-query';
+import { useAppRuntime } from './EffectRuntimeProvider.js';
+import { runAtBoundary } from './runAtBoundary.js';
+/**
+ * `useQuery` for an Effect. The Effect runs on the app runtime; a typed failure is `error` with
+ * its own `_tag`, a defect is an `UnexpectedError` with the defect as `cause`, and each failure is
+ * logged once through `Logger`. Unmounting or changing the key interrupts the running fiber.
+ *
+ * @example
+ * ```ts
+ * const trip = useEffectQuery({ queryKey: ['trip', id], queryFn: getTrip(id) });
+ * ```
+ */
+export function useEffectQuery(options) {
+    const runtime = useAppRuntime();
+    const { queryFn: effect, ...rest } = options;
+    return useQuery({
+        ...rest,
+        queryFn: ({ queryKey, signal }) => runAtBoundary(runtime, effect, { queryKey }, signal),
+    });
+}
+//# sourceMappingURL=useEffectQuery.js.map

package/dist/react/useEffectQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEffectQuery.js","sourceRoot":"","sources":["../../src/react/useEffectQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4D,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE3G,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAmD;IAEnD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC7C,OAAO,QAAQ,CAAuC;QACpD,GAAG,IAAI;QACP,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC;KACxF,CAAC,CAAC;AACL,CAAC"}

package/dist/react/useErrorMessage.d.ts

@@ -0,0 +1,13 @@
+import type { AnyAppError } from '../errors/appError.js';
+import { type MessageKeyMapper } from '../errors/messageKeys.js';
+/**
+ * The translated message for `error`, or `undefined` when there is none: looks the tag up in the
+ * app's exhaustive `mapper` and passes the key to `t`.
+ *
+ * @example
+ * ```ts
+ * const message = useErrorMessage(trip.error, errorTagToMessageKey, t);
+ * ```
+ */
+export declare function useErrorMessage<E extends AnyAppError, K extends string>(error: E | null | undefined, mapper: MessageKeyMapper<E, K>, t: (key: K) => string): string | undefined;
+//# sourceMappingURL=useErrorMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useErrorMessage.d.ts","sourceRoot":"","sources":["../../src/react/useErrorMessage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,KAAK,gBAAgB,EAAqB,MAAM,0BAA0B,CAAC;AAEpF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM,EACrE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3B,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC9B,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GACpB,MAAM,GAAG,SAAS,CAEpB"}

package/dist/react/useErrorMessage.js

@@ -0,0 +1,15 @@
+import { useMemo } from 'react';
+import { resolveMessageKey } from '../errors/messageKeys.js';
+/**
+ * The translated message for `error`, or `undefined` when there is none: looks the tag up in the
+ * app's exhaustive `mapper` and passes the key to `t`.
+ *
+ * @example
+ * ```ts
+ * const message = useErrorMessage(trip.error, errorTagToMessageKey, t);
+ * ```
+ */
+export function useErrorMessage(error, mapper, t) {
+    return useMemo(() => (error ? t(resolveMessageKey(error, mapper)) : undefined), [error, mapper, t]);
+}
+//# sourceMappingURL=useErrorMessage.js.map

package/dist/react/useErrorMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useErrorMessage.js","sourceRoot":"","sources":["../../src/react/useErrorMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAyB,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEpF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,KAA2B,EAC3B,MAA8B,EAC9B,CAAqB;IAErB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC"}

package/dist/runtime/makeAppRuntime.d.ts

@@ -0,0 +1,38 @@
+import { Effect, Exit, type Fiber, type Layer } from 'effect';
+/** Options every `run*` method takes: an `AbortSignal` interrupts the fiber when it aborts. */
+export interface RunOptions {
+    readonly signal?: AbortSignal;
+}
+/**
+ * The app's single runtime, built from the Layer that provides `AppServices`. `R` is what it
+ * provides and `ER` how building it can fail (a `ConfigError`, for example). Running an
+ * Effect that needs a service outside `R` is a compile error.
+ */
+export interface AppRuntime<R, ER = never> {
+    /** Builds the Layer now instead of on first use, and rejects with its error if it fails. */
+    readonly boot: () => Promise<void>;
+    /** Runs an Effect; rejects with a `FiberFailure` carrying the cause, as `Effect.runPromise`. */
+    readonly runPromise: <A, E>(effect: Effect.Effect<A, E, R>, options?: RunOptions) => Promise<A>;
+    /** Runs an Effect and resolves with its `Exit`, never rejecting. */
+    readonly runPromiseExit: <A, E>(effect: Effect.Effect<A, E, R>, options?: RunOptions) => Promise<Exit.Exit<A, E | ER>>;
+    /** Starts an Effect on a new fiber and returns the fiber. */
+    readonly runFork: <A, E>(effect: Effect.Effect<A, E, R>) => Fiber.RuntimeFiber<A, E | ER>;
+    /** Releases every resource the Layer acquired. */
+    readonly dispose: () => Promise<void>;
+}
+/**
+ * The services an {@link AppRuntime} provides: `type AppServices = AppServicesOf<typeof runtime>`.
+ */
+export type AppServicesOf<T> = T extends AppRuntime<infer R, infer _ER> ? R : never;
+/**
+ * Builds the app's one runtime (a `ManagedRuntime`) from the Layer of every service. Create it
+ * once, in `features/core/runtime`, and hand it to `EffectRuntimeProvider`.
+ *
+ * @example
+ * ```ts
+ * export const runtime = makeAppRuntime(Layer.mergeAll(ConsoleLogger, ConfigLive, TripsLive));
+ * export type AppServices = AppServicesOf<typeof runtime>;
+ * ```
+ */
+export declare function makeAppRuntime<R, ER>(layer: Layer.Layer<R, ER, never>): AppRuntime<R, ER>;
+//# sourceMappingURL=makeAppRuntime.d.ts.map

package/dist/runtime/makeAppRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeAppRuntime.d.ts","sourceRoot":"","sources":["../../src/runtime/makeAppRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAkB,MAAM,QAAQ,CAAC;AAErF,+FAA+F;AAC/F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK;IACvC,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAChG,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,UAAU,KACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1F,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEpF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAYzF"}

package/dist/runtime/makeAppRuntime.js

@@ -0,0 +1,26 @@
+import { Cause, Effect, Exit, ManagedRuntime } from 'effect';
+/**
+ * Builds the app's one runtime (a `ManagedRuntime`) from the Layer of every service. Create it
+ * once, in `features/core/runtime`, and hand it to `EffectRuntimeProvider`.
+ *
+ * @example
+ * ```ts
+ * export const runtime = makeAppRuntime(Layer.mergeAll(ConsoleLogger, ConfigLive, TripsLive));
+ * export type AppServices = AppServicesOf<typeof runtime>;
+ * ```
+ */
+export function makeAppRuntime(layer) {
+    const managed = ManagedRuntime.make(layer);
+    return {
+        boot: async () => {
+            const exit = await managed.runPromiseExit(Effect.void);
+            if (Exit.isFailure(exit))
+                throw Cause.squash(exit.cause);
+        },
+        runPromise: (effect, options) => managed.runPromise(effect, options),
+        runPromiseExit: (effect, options) => managed.runPromiseExit(effect, options),
+        runFork: effect => managed.runFork(effect),
+        dispose: () => managed.dispose(),
+    };
+}
+//# sourceMappingURL=makeAppRuntime.js.map

package/dist/runtime/makeAppRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeAppRuntime.js","sourceRoot":"","sources":["../../src/runtime/makeAppRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAA0B,cAAc,EAAE,MAAM,QAAQ,CAAC;AAiCrF;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAQ,KAAgC;IACpE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvD,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;QACD,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;QACpE,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;QAC5E,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;AACJ,CAAC"}

package/dist/sqlite/migrations.d.ts

@@ -0,0 +1,33 @@
+import { Effect } from 'effect';
+import { type SqlError, type SqliteDatabase } from './sqliteClient.js';
+/**
+ * One schema step. `version` is a positive integer; `up` is SQL for `execAsync` or a function
+ * that runs its statements on the transaction it receives.
+ */
+export interface Migration {
+    readonly version: number;
+    readonly up: string | ((txn: SqliteDatabase) => Promise<void>);
+}
+/** What {@link runMigrations} did: the version before and after, and each version it applied. */
+export interface MigrationReport {
+    readonly from: number;
+    readonly to: number;
+    readonly applied: readonly number[];
+}
+/**
+ * Brings the database to the highest version in `migrations`, keyed by `PRAGMA user_version`.
+ * Each pending migration runs, in version order, in its own exclusive transaction together with
+ * the `user_version` bump, so a failing step rolls back entirely and leaves `user_version` at the
+ * last step that succeeded. Running it again is a no-op. A duplicate or non-integer version is a
+ * defect.
+ *
+ * @example
+ * ```ts
+ * yield* runMigrations(db, [
+ *   { version: 1, up: 'CREATE TABLE trips (id TEXT PRIMARY KEY, name TEXT NOT NULL);' },
+ *   { version: 2, up: 'ALTER TABLE trips ADD COLUMN starts_at TEXT;' },
+ * ]);
+ * ```
+ */
+export declare function runMigrations(client: SqliteDatabase, migrations: readonly Migration[]): Effect.Effect<MigrationReport, SqlError>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/sqlite/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/sqlite/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAU,MAAM,mBAAmB,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAChE;AAED,iGAAiG;AACjG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAgBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,SAAS,SAAS,EAAE,GAC/B,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,QAAQ,CAAC,CAmB1C"}

package/dist/sqlite/migrations.js

@@ -0,0 +1,49 @@
+import { Effect } from 'effect';
+import { trySql } from './sqliteClient.js';
+function validate(migrations) {
+    const seen = new Set();
+    for (const migration of migrations) {
+        if (!Number.isInteger(migration.version) || migration.version < 1) {
+            return Effect.dieMessage(`Migration version ${migration.version} is not a positive integer`);
+        }
+        if (seen.has(migration.version)) {
+            return Effect.dieMessage(`Migration version ${migration.version} is declared twice`);
+        }
+        seen.add(migration.version);
+    }
+    return Effect.succeed([...migrations].sort((a, b) => a.version - b.version));
+}
+/**
+ * Brings the database to the highest version in `migrations`, keyed by `PRAGMA user_version`.
+ * Each pending migration runs, in version order, in its own exclusive transaction together with
+ * the `user_version` bump, so a failing step rolls back entirely and leaves `user_version` at the
+ * last step that succeeded. Running it again is a no-op. A duplicate or non-integer version is a
+ * defect.
+ *
+ * @example
+ * ```ts
+ * yield* runMigrations(db, [
+ *   { version: 1, up: 'CREATE TABLE trips (id TEXT PRIMARY KEY, name TEXT NOT NULL);' },
+ *   { version: 2, up: 'ALTER TABLE trips ADD COLUMN starts_at TEXT;' },
+ * ]);
+ * ```
+ */
+export function runMigrations(client, migrations) {
+    return Effect.gen(function* () {
+        const ordered = yield* validate(migrations);
+        const row = yield* trySql('read user_version', () => client.getFirstAsync('PRAGMA user_version'));
+        const from = row?.user_version ?? 0;
+        const pending = ordered.filter(migration => migration.version > from);
+        for (const migration of pending) {
+            yield* trySql(`migration ${migration.version}`, () => client.withExclusiveTransactionAsync(async (txn) => {
+                if (typeof migration.up === 'string')
+                    await txn.execAsync(migration.up);
+                else
+                    await migration.up(txn);
+                await txn.execAsync(`PRAGMA user_version = ${migration.version}`);
+            }));
+        }
+        return { from, to: pending.at(-1)?.version ?? from, applied: pending.map(migration => migration.version) };
+    });
+}
+//# sourceMappingURL=migrations.js.map

package/dist/sqlite/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/sqlite/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAsC,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAkB/E,SAAS,QAAQ,CAAC,UAAgC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YAClE,OAAO,MAAM,CAAC,UAAU,CAAC,qBAAqB,SAAS,CAAC,OAAO,4BAA4B,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,UAAU,CAAC,qBAAqB,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAsB,EACtB,UAAgC;IAEhC,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAClD,MAAM,CAAC,aAAa,CAA2B,qBAAqB,CAAC,CACtE,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,EAAE,YAAY,IAAI,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACtE,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,SAAS,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CACnD,MAAM,CAAC,6BAA6B,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;gBAC/C,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ;oBAAE,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;;oBACnE,MAAM,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,GAAG,CAAC,SAAS,CAAC,yBAAyB,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7G,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/sqlite/sqliteClient.d.ts

@@ -0,0 +1,63 @@
+import { Context, Effect } from 'effect';
+/** A value SQLite can bind: the same set expo-sqlite accepts. */
+export type SqlValue = string | number | null | boolean | Uint8Array | ArrayBuffer;
+/** Positional (`?`) or named (`$name`) parameters. */
+export type SqlParams = SqlValue[] | Record<string, SqlValue>;
+/** What a write reports. */
+export interface SqlRunResult {
+    readonly lastInsertRowId: number;
+    readonly changes: number;
+}
+/**
+ * The slice of expo-sqlite's async `SQLiteDatabase` API the kit relies on. An expo-sqlite
+ * database satisfies it as it is, so the app's Live Layer is one line:
+ *
+ * @example
+ * ```ts
+ * export const SqliteLive = Layer.effect(
+ *   SqliteClient,
+ *   Effect.promise(() => SQLite.openDatabaseAsync('app.db')),
+ * );
+ * ```
+ */
+export interface SqliteDatabase {
+    /** Runs one or more statements without parameters (DDL, pragmas). */
+    execAsync(source: string): Promise<void>;
+    /** Runs a write. */
+    runAsync(source: string, params?: SqlParams): Promise<SqlRunResult>;
+    /** Every row of a query. */
+    getAllAsync<T>(source: string, params?: SqlParams): Promise<T[]>;
+    /** The first row of a query, or `null`. */
+    getFirstAsync<T>(source: string, params?: SqlParams): Promise<T | null>;
+    /** Runs `task` in a transaction; other queries on the connection may interleave. */
+    withTransactionAsync(task: () => Promise<void>): Promise<void>;
+    /** Runs `task` in an exclusive transaction; use `txn` for every statement inside it. */
+    withExclusiveTransactionAsync(task: (txn: SqliteDatabase) => Promise<void>): Promise<void>;
+}
+declare const SqliteClient_base: Context.TagClass<SqliteClient, "@timothyrusso/effect-core/SqliteClient", SqliteDatabase>;
+/**
+ * The app's database connection. The kit ships the interface and the Node test Layer
+ * (`makeNodeSqliteLayer` in `/testing`); the expo-sqlite Live Layer lives in the app.
+ */
+export declare class SqliteClient extends SqliteClient_base {
+}
+declare const SqlError_base: import("../errors/appError.js").AppErrorClass<"SqlError", "errors.sql">;
+/** A statement or a transaction failed. `cause` is the driver's error. */
+export declare class SqlError extends SqlError_base<{
+    readonly message: string;
+}> {
+}
+/**
+ * Runs `query` against the connection in the context, failing with a {@link SqlError} when its
+ * promise rejects. `operation` names the call in the error message.
+ *
+ * @example
+ * ```ts
+ * const trips = withSqlite('list trips', db => db.getAllAsync<TripRow>('SELECT * FROM trips'));
+ * ```
+ */
+export declare function withSqlite<A>(operation: string, query: (db: SqliteDatabase) => Promise<A>): Effect.Effect<A, SqlError, SqliteClient>;
+/** `Effect.tryPromise` with the rejection mapped to a {@link SqlError}. */
+export declare function trySql<A>(operation: string, run: () => Promise<A>): Effect.Effect<A, SqlError>;
+export {};
+//# sourceMappingURL=sqliteClient.d.ts.map

package/dist/sqlite/sqliteClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteClient.d.ts","sourceRoot":"","sources":["../../src/sqlite/sqliteClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGzC,iEAAiE;AACjE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnF,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAE9D,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,oBAAoB;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpE,4BAA4B;IAC5B,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,2CAA2C;IAC3C,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACxE,oFAAoF;IACpF,oBAAoB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,wFAAwF;IACxF,6BAA6B,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,iBAG/B;CAAG;;AAEN,0EAA0E;AAC1E,qBAAa,QAAS,SAAQ,cAAuC;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;CAAG;AASrG;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAE1C;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAK9F"}

package/dist/sqlite/sqliteClient.js

@@ -0,0 +1,37 @@
+import { Context, Effect } from 'effect';
+import { AppErrorBase } from '../errors/appError.js';
+/**
+ * The app's database connection. The kit ships the interface and the Node test Layer
+ * (`makeNodeSqliteLayer` in `/testing`); the expo-sqlite Live Layer lives in the app.
+ */
+export class SqliteClient extends Context.Tag('@timothyrusso/effect-core/SqliteClient')() {
+}
+/** A statement or a transaction failed. `cause` is the driver's error. */
+export class SqlError extends AppErrorBase('SqlError', 'errors.sql') {
+}
+function messageOf(cause) {
+    if (typeof cause === 'object' && cause !== null && 'message' in cause && typeof cause.message === 'string') {
+        return cause.message;
+    }
+    return String(cause);
+}
+/**
+ * Runs `query` against the connection in the context, failing with a {@link SqlError} when its
+ * promise rejects. `operation` names the call in the error message.
+ *
+ * @example
+ * ```ts
+ * const trips = withSqlite('list trips', db => db.getAllAsync<TripRow>('SELECT * FROM trips'));
+ * ```
+ */
+export function withSqlite(operation, query) {
+    return Effect.flatMap(SqliteClient, db => trySql(operation, () => query(db)));
+}
+/** `Effect.tryPromise` with the rejection mapped to a {@link SqlError}. */
+export function trySql(operation, run) {
+    return Effect.tryPromise({
+        try: run,
+        catch: cause => new SqlError({ message: `${operation}: ${messageOf(cause)}`, cause }),
+    });
+}
+//# sourceMappingURL=sqliteClient.js.map

package/dist/sqlite/sqliteClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteClient.js","sourceRoot":"","sources":["../../src/sqlite/sqliteClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAyCrD;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,EAGpF;CAAG;AAEN,0EAA0E;AAC1E,MAAM,OAAO,QAAS,SAAQ,YAAY,CAAC,UAAU,EAAE,YAAY,CAA+B;CAAG;AAErG,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3G,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,SAAiB,EACjB,KAAyC;IAEzC,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,MAAM,CAAI,SAAiB,EAAE,GAAqB;IAChE,OAAO,MAAM,CAAC,UAAU,CAAC;QACvB,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,SAAS,KAAK,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/testing/clock.d.ts

@@ -0,0 +1,16 @@
+import { type Duration, type Effect } from 'effect';
+/**
+ * Moves the `TestClock` that {@link runTest} and {@link itEffect} install forward by `duration`,
+ * running every sleep and schedule that falls due. Fork the Effect that waits first, then advance.
+ *
+ * @example
+ * ```ts
+ * itEffect('expires the cache after an hour', Effect.gen(function* () {
+ *   const fiber = yield* Effect.fork(expireAfter(Duration.hours(1)));
+ *   yield* advanceClock(Duration.hours(1));
+ *   expect(yield* Fiber.join(fiber)).toBe('expired');
+ * }));
+ * ```
+ */
+export declare function advanceClock(duration: Duration.DurationInput): Effect.Effect<void>;
+//# sourceMappingURL=clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/testing/clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAa,MAAM,QAAQ,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAElF"}

package/dist/testing/clock.js

@@ -0,0 +1,18 @@
+import { TestClock } from 'effect';
+/**
+ * Moves the `TestClock` that {@link runTest} and {@link itEffect} install forward by `duration`,
+ * running every sleep and schedule that falls due. Fork the Effect that waits first, then advance.
+ *
+ * @example
+ * ```ts
+ * itEffect('expires the cache after an hour', Effect.gen(function* () {
+ *   const fiber = yield* Effect.fork(expireAfter(Duration.hours(1)));
+ *   yield* advanceClock(Duration.hours(1));
+ *   expect(yield* Fiber.join(fiber)).toBe('expired');
+ * }));
+ * ```
+ */
+export function advanceClock(duration) {
+    return TestClock.adjust(duration);
+}
+//# sourceMappingURL=clock.js.map

package/dist/testing/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/testing/clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgC;IAC3D,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/testing/collectLogs.d.ts

@@ -0,0 +1,32 @@
+import { Layer } from 'effect';
+import { type LogContext, Logger } from '../logger/logger.js';
+/** One call a collecting logger received. */
+export interface LogEntry {
+    readonly level: 'error' | 'warn' | 'info' | 'debug';
+    /** The message, or for `error` the error's `_tag` (or its string form). */
+    readonly message: string;
+    /** The value passed to `error`; `undefined` for the other levels. */
+    readonly error: unknown;
+    readonly context: LogContext;
+}
+/** What {@link collectLogs} returns. */
+export interface CollectedLogs {
+    /** A `Logger` Layer that records every call into `entries`. */
+    readonly layer: Layer.Layer<Logger>;
+    /** Every call so far, oldest first. */
+    readonly entries: readonly LogEntry[];
+    /** Empties `entries`. */
+    clear(): void;
+}
+/**
+ * A `Logger` that records instead of printing, to assert what the boundary logged.
+ *
+ * @example
+ * ```ts
+ * const logs = collectLogs();
+ * const runtime = makeAppRuntime(Layer.merge(logs.layer, TripsTestLayer));
+ * expect(logs.entries).toHaveLength(1);
+ * ```
+ */
+export declare function collectLogs(): CollectedLogs;
+//# sourceMappingURL=collectLogs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collectLogs.d.ts","sourceRoot":"","sources":["../../src/testing/collectLogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE9D,6CAA6C;AAC7C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpD,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,yBAAyB;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAiB3C"}