@warp-drive-mirror/core 5.9.0-alpha.2 → 5.9.0-alpha.21

package/declarations/types/runtime.d.ts

@@ -1,14 +1,55 @@
-import type { LOG_CONFIG } from "@warp-drive-mirror/build-config/-private/utils/logging";
+import * as LOGGING from "@warp-drive-mirror/build-config/debugging";
+//#region src/types/runtime.d.ts
+/**
+ * the shape of the runtime-configurable debug logging flags, see
+ * {@link @warp-drive-mirror/core!build-config/debugging | the debugging flags}
+ */
+type LOG_CONFIG_KEY = keyof typeof LOGGING;
+type LOG_CONFIG = { [key in LOG_CONFIG_KEY]: boolean; };
 declare const RuntimeConfig: {
-	debug: Partial<LOG_CONFIG>;
+  /**
+   * the currently active logging configuration, see
+   * {@link @warp-drive-mirror/core!build-config/debugging | the debugging flags}
+   */
+  debug: Partial<LOG_CONFIG>;
+  /**
+   * whether requests should be treated as being served by Mirage,
+   * see {@link setIsMaybeMirage}
+   */
+  mirage?: boolean;
 };
-export declare function getRuntimeConfig(): typeof RuntimeConfig;
-/**
-* Upserts the specified logging configuration into the runtime
-* config.
-*
-* globalThis.setWarpDriveLogging({ LOG_CACHE: true } });
-*
-*/
-export declare function setLogging(config: Partial<LOG_CONFIG>): void;
-export {};
+/**
+ * Returns the current WarpDrive runtime configuration.
+ *
+ * @example
+ * ```ts
+ * const { debug, mirage } = getRuntimeConfig();
+ * ```
+ */
+declare function getRuntimeConfig(): typeof RuntimeConfig;
+/**
+ * Upserts the specified logging configuration into the runtime
+ * config.
+ *
+ * globalThis.setWarpDriveLogging({ LOG_CACHE: true } });
+ *
+ */
+declare function setLogging(config: Partial<LOG_CONFIG>): void;
+/**
+ * Explicitly declares whether requests may be served by Mirage (or another
+ * Pretender-based fetch mock) instead of a native `fetch` implementation.
+ *
+ * The `Fetch` request handler otherwise infers this via a heuristic (the
+ * presence of `window.server.pretender`, or `window.fetch` appearing to be
+ * patched), which can be wrong in either direction: some Mirage setups don't
+ * expose `window.server`, while some unrelated tools (APM agents, browser
+ * extensions) also patch `fetch`. Call this to override that heuristic:
+ * `true` to force Mirage-compatible behavior on, `false` to force it off.
+ *
+ * globalThis.setWarpDriveIsMaybeMirage(true);
+ *
+ */
+declare function setIsMaybeMirage(value: boolean): void;
+//#endregion
+export { getRuntimeConfig, setIsMaybeMirage, setLogging };
+//# sourceMappingURL=runtime.d.ts.map

package/declarations/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../src/types/runtime.ts"],"mappings":";;;;;;KASK,8BAA8B;KAC9B,gBAAgB,OAAO;cAEtB;;;;;EAKJ,OAAO,QAAQ;;;;;EAKf;;;;;;;;;;iBA6Bc,2BAA2B;;;;;;;;iBAW3B,WAAW,QAAQ,QAAQ;;;;;;;;;;;;;;;iBAmB3B,iBAAiB"}

package/declarations/types/schema/concepts.d.ts

@@ -1,23 +1,2 @@
-import type { ResourceKey } from "../identifier.js";
-import type { ObjectValue, Value } from "../json/raw.js";
-import type { OpaqueRecordInstance } from "../record.js";
-import type { Type } from "../symbols.js";
-export type Transformation<
-	T extends Value = Value,
-	PT = unknown
-> = {
-	serialize(value: PT, options: ObjectValue | null, record: OpaqueRecordInstance): T;
-	hydrate(value: T | undefined, options: ObjectValue | null, record: OpaqueRecordInstance): PT;
-	defaultValue?(options: ObjectValue | null, identifier: ResourceKey): T;
-	[Type]: string;
-};
-export type Derivation<
-	R = unknown,
-	T = unknown,
-	FM extends ObjectValue | null = ObjectValue | null
-> = {
-	[Type]: string;
-} & ((record: R, options: FM, prop: string) => T);
-export type HashFn<T extends object = object> = {
-	[Type]: string;
-} & ((data: T, options: ObjectValue | null, prop: string | null) => string);
+import { n as HashFn, r as Transformation, t as Derivation } from "../../concepts-CFfLCQr6.js";
+export { Derivation, HashFn, Transformation };