@luckystack/core 0.6.6 → 0.7.0

package/dist/pageRouteValidation-sJJCX-YV.d.ts

@@ -0,0 +1,270 @@
+import { Socket } from 'socket.io-client';
+
+declare function sleep(ms: number): Promise<void>;
+
+interface NotifyParam {
+    key: string;
+    value: string | number | boolean;
+}
+interface NotifyInput {
+    key: string;
+    params?: NotifyParam[];
+}
+interface Notifier {
+    success: (input: NotifyInput) => void;
+    error: (input: NotifyInput) => void;
+    info: (input: NotifyInput) => void;
+    warning: (input: NotifyInput) => void;
+}
+declare const registerNotifier: (notifier: Notifier) => void;
+declare const getNotifier: () => Notifier;
+declare const notify: Notifier;
+
+declare let socket: Socket | null;
+declare const setSocket: (next: Socket | null) => void;
+declare const incrementResponseIndex: () => number;
+declare const waitForSocket: () => Promise<Socket | null>;
+
+/** Why a queued item was dropped (handed to its `onDrop` callback). */
+type QueueDropReason = 'expired' | 'queue-full';
+interface ApiQueueItem {
+    id: string;
+    key: string;
+    run: (socketInstance: Socket) => void;
+    createdAt: number;
+    /**
+     * Per-request override of `projectConfig.offlineQueue.dropPolicy`. See
+     * `SyncQueueItem.dropPolicy` for details.
+     */
+    dropPolicy?: 'drop-oldest' | 'drop-newest' | 'reject';
+    /**
+     * Optional callback invoked when THIS item is dropped (evicted for age or
+     * because the queue was full / rejected) instead of ever running (SYNC-09).
+     * The transport wires this to settle the pending `syncRequest`/`apiRequest`
+     * promise with an error envelope, so an evicted offline request resolves
+     * rather than hanging forever. Invoked at most once; failures are swallowed.
+     */
+    onDrop?: (reason: QueueDropReason) => void;
+}
+interface SyncQueueItem {
+    id: string;
+    key: string;
+    run: (socketInstance: Socket) => void;
+    createdAt: number;
+    /**
+     * Per-request override of `projectConfig.offlineQueue.dropPolicy`. Lets a
+     * specific sync ("editor cursor move") pick `'drop-oldest'` while the app
+     * default stays `'reject'` for safer sends. When omitted, falls back to
+     * the global config.
+     */
+    dropPolicy?: 'drop-oldest' | 'drop-newest' | 'reject';
+    /** See {@link ApiQueueItem.onDrop} (SYNC-09). */
+    onDrop?: (reason: QueueDropReason) => void;
+}
+declare const isOnline: () => boolean;
+declare const enqueueApiRequest: (item: ApiQueueItem) => boolean;
+declare const enqueueSyncRequest: (item: SyncQueueItem) => boolean;
+declare const removeApiQueueItem: (id: string) => void;
+declare const removeSyncQueueItem: (id: string) => void;
+declare const removeApiQueueItemsByKey: (key: string) => void;
+declare const flushApiQueue: (canRun: () => boolean, socketInstance: Socket) => void;
+declare const flushSyncQueue: (canRun: () => boolean, socketInstance: Socket) => void;
+declare const getApiQueueSize: () => number;
+declare const getSyncQueueSize: () => number;
+
+interface ErrorParam {
+    key: string;
+    value: string | number | boolean;
+}
+interface ErrorResponseInput {
+    status?: unknown;
+    errorCode?: unknown;
+    errorParams?: unknown;
+    httpStatus?: unknown;
+}
+interface NormalizedErrorResponse {
+    status: 'error';
+    message: string;
+    errorCode: string;
+    errorParams?: ErrorParam[];
+    httpStatus?: number;
+}
+declare const INVALID_ERROR_RESPONSE_CODE = "error.invalidResponse";
+declare const isErrorParamArray: (value: unknown) => value is ErrorParam[];
+declare const normalizeErrorResponseCore: ({ response, fallbackHttpStatus, fallbackErrorCode, resolveMessage, }: {
+    response: ErrorResponseInput;
+    fallbackHttpStatus?: number;
+    fallbackErrorCode?: string;
+    resolveMessage?: (args: {
+        errorCode: string;
+        errorParams?: ErrorParam[];
+    }) => string;
+}) => NormalizedErrorResponse;
+declare const defaultHttpStatusForResponse: ({ status, explicitHttpStatus, fallbackErrorStatus, }: {
+    status: "success" | "error";
+    explicitHttpStatus?: number;
+    fallbackErrorStatus?: number;
+}) => number;
+
+/**
+ * Fetch (or return the cached) CSRF token for the active session. Returns
+ * null in token mode or when no session exists. Callers should attach the
+ * returned value as the `X-CSRF-Token` request header.
+ */
+declare const getCsrfToken: () => Promise<string | null>;
+/** Drop the cached token. Call this on logout or when a 403 csrfMismatch is seen. */
+declare const clearCsrfToken: () => void;
+/**
+ * Drop-in replacement for `fetch` that automatically attaches the framework's
+ * `X-CSRF-Token` and `X-Request-Id` headers to state-changing requests in
+ * cookie mode. Use this for any project-side HTTP call that hits a
+ * LuckyStack `/api/*`, `/sync/*`, or `/auth/api/*` endpoint.
+ *
+ * Behavior:
+ *   - GET / OPTIONS / HEAD: passes through without CSRF (read-only).
+ *   - Token mode: passes through without CSRF (immune by design).
+ *   - Cookie mode + state-changing method: lazily fetches `/auth/csrf` once,
+ *     caches, attaches as `x-csrf-token`. On a 403 `auth.csrfMismatch`
+ *     response, clears the cache and retries once.
+ *   - `credentials: 'include'` is forced unless the caller overrode it.
+ *
+ * @example
+ *   import { httpFetch } from '@luckystack/core/client';
+ *   const res = await httpFetch('/api/system/myRoute/v1', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ ... }),
+ *   });
+ */
+declare const httpFetch: typeof fetch;
+
+interface ServiceRouteParseSuccess {
+    status: 'success';
+    normalizedRouteName: string;
+    service: string;
+    routeName: string;
+}
+interface ServiceRouteParseError {
+    status: 'error';
+    reason: string;
+}
+type ServiceRouteParseResult = ServiceRouteParseSuccess | ServiceRouteParseError;
+interface TransportRouteParseSuccess {
+    status: 'success';
+    normalizedFullName: string;
+    version: string;
+    serviceRoute: ServiceRouteParseSuccess;
+}
+interface TransportRouteParseError {
+    status: 'error';
+    reason: string;
+}
+type TransportRouteParseResult = TransportRouteParseSuccess | TransportRouteParseError;
+declare const parseServiceRouteName: (value: string) => ServiceRouteParseResult;
+declare const parseTransportRouteName: ({ value, prefix, }: {
+    value: string;
+    prefix: "api" | "sync";
+}) => TransportRouteParseResult;
+
+declare const socketEventNames: {
+    readonly apiRequest: "apiRequest";
+    readonly apiCancel: "apiCancel";
+    readonly sync: "sync";
+    readonly syncCancel: "syncCancel";
+    readonly joinRoom: "joinRoom";
+    readonly leaveRoom: "leaveRoom";
+    readonly getJoinedRooms: "getJoinedRooms";
+    readonly updateLocation: "updateLocation";
+    readonly updateSession: "updateSession";
+    readonly sessionReplaced: "sessionReplaced";
+    readonly logout: "logout";
+    readonly intentionalDisconnect: "intentionalDisconnect";
+    readonly intentionalReconnect: "intentionalReconnect";
+    readonly activity: "activity";
+    readonly userAfk: "userAfk";
+    readonly userBack: "userBack";
+    readonly userLeft: "userLeft";
+    readonly connect: "connect";
+    readonly disconnect: "disconnect";
+    readonly reconnectAttempt: "reconnect_attempt";
+    readonly connectError: "connect_error";
+    readonly apiResponsePrefix: "apiResponse-";
+    readonly apiStreamPrefix: "apiStream-";
+    readonly syncResponsePrefix: "sync-";
+    readonly syncProgressPrefix: "sync-progress-";
+    readonly joinRoomResponsePrefix: "joinRoom-";
+    readonly leaveRoomResponsePrefix: "leaveRoom-";
+    readonly getJoinedRoomsResponsePrefix: "getJoinedRooms-";
+};
+declare const buildApiResponseEventName: (responseIndex: number | string) => string;
+declare const buildApiStreamEventName: (responseIndex: number | string) => string;
+declare const buildSyncResponseEventName: (responseIndex: number | string) => string;
+declare const buildSyncProgressEventName: (responseIndex: number | string) => string;
+declare const buildJoinRoomResponseEventName: (responseIndex: number | string) => string;
+declare const buildLeaveRoomResponseEventName: (responseIndex: number | string) => string;
+declare const buildGetJoinedRoomsResponseEventName: (responseIndex: number | string) => string;
+
+type SOCKETSTATUS = "CONNECTED" | "DISCONNECTED" | "AFK" | "RECONNECTING" | "STARTUP";
+interface statusContent {
+    status: SOCKETSTATUS;
+    reconnectAttempt?: number;
+    endTime?: number;
+}
+
+type LoggerContext = Record<string, unknown>;
+interface Logger {
+    debug: (message: string, context?: LoggerContext) => void;
+    info: (message: string, context?: LoggerContext) => void;
+    warn: (message: string, context?: LoggerContext) => void;
+    error: (message: string, error?: unknown, context?: LoggerContext) => void;
+}
+declare const createDevLogger: () => Logger;
+declare const registerLogger: (logger: Logger) => void;
+declare const getLogger: () => Logger;
+declare const isLoggerRegistered: () => boolean;
+declare const resetLoggerForTests: () => void;
+
+type HttpMethodLiteral = 'GET' | 'POST' | 'PUT' | 'DELETE';
+type ApiMethodMap = Record<string, Record<string, Record<string, HttpMethodLiteral>>>;
+declare const registerApiMethodMap: (map: ApiMethodMap) => void;
+declare const getRegisteredApiMethod: (pagePath: string, apiName: string, version: string) => HttpMethodLiteral | undefined;
+declare const isApiMethodMapRegistered: () => boolean;
+
+interface PageRouteRules {
+    /**
+     * Single-character prefix that marks a folder as **invisible-parent** for
+     * page routing. Default: `'_'`.
+     */
+    privateFolderPrefix: string;
+    /**
+     * Folder names that are reserved for framework-internal use and may NEVER
+     * host a `page.tsx`, nested or otherwise. Scaffold + page-discovery emit
+     * a hard error when a page is placed inside one.
+     */
+    scaffoldIgnoredFolders: readonly string[];
+}
+declare const DEFAULT_PAGE_ROUTE_RULES: PageRouteRules;
+interface PagePathValidationResult {
+    /** `true` when the page file produces a routeable URL. */
+    valid: boolean;
+    /** Computed URL when `valid`. Always begins with `/`. `/` for root page. */
+    route?: string;
+    /** Human-readable explanation when `!valid`. */
+    reason?: string;
+}
+/**
+ * Validate a `page.tsx` file path relative to `src/`. Accepts both
+ * forward and back slashes, with or without a leading `./` or `/`.
+ * The filename **must** be `page.tsx` (or `page.jsx`); other filenames
+ * return `valid: false`.
+ *
+ * Examples (defaults):
+ *   admin/page.tsx              -> { valid: true, route: '/admin' }
+ *   _housing/renting/page.tsx   -> { valid: true, route: '/renting' }
+ *   _housing/page.tsx           -> { valid: false, reason: 'no URL segment left after stripping underscore folders' }
+ *   _api/something/page.tsx     -> { valid: false, reason: 'page.tsx cannot live inside reserved folder _api' }
+ *   page.tsx                    -> { valid: true, route: '/' }
+ *   some/route.tsx              -> { valid: false, reason: 'not a page file (expected page.tsx)' }
+ */
+declare const validatePagePath: (srcRelativePath: string, rules?: PageRouteRules) => PagePathValidationResult;
+
+export { type QueueDropReason as $, type ApiMethodMap as A, normalizeErrorResponseCore as B, notify as C, DEFAULT_PAGE_ROUTE_RULES as D, parseServiceRouteName as E, registerApiMethodMap as F, registerLogger as G, type HttpMethodLiteral as H, registerNotifier as I, removeApiQueueItem as J, removeApiQueueItemsByKey as K, type Logger as L, removeSyncQueueItem as M, type Notifier as N, setSocket as O, type PagePathValidationResult as P, sleep as Q, socket as R, type SOCKETSTATUS as S, socketEventNames as T, type statusContent as U, validatePagePath as V, waitForSocket as W, type ErrorParam as X, type ErrorResponseInput as Y, type NormalizedErrorResponse as Z, INVALID_ERROR_RESPONSE_CODE as _, type LoggerContext as a, type ServiceRouteParseError as a0, type ServiceRouteParseResult as a1, type ServiceRouteParseSuccess as a2, type TransportRouteParseError as a3, type TransportRouteParseResult as a4, type TransportRouteParseSuccess as a5, createDevLogger as a6, defaultHttpStatusForResponse as a7, isErrorParamArray as a8, isLoggerRegistered as a9, parseTransportRouteName as aa, resetLoggerForTests as ab, type NotifyInput as b, type NotifyParam as c, type PageRouteRules as d, buildApiResponseEventName as e, buildApiStreamEventName as f, buildGetJoinedRoomsResponseEventName as g, buildJoinRoomResponseEventName as h, buildLeaveRoomResponseEventName as i, buildSyncProgressEventName as j, buildSyncResponseEventName as k, clearCsrfToken as l, enqueueApiRequest as m, enqueueSyncRequest as n, flushApiQueue as o, flushSyncQueue as p, getApiQueueSize as q, getCsrfToken as r, getLogger as s, getNotifier as t, getRegisteredApiMethod as u, getSyncQueueSize as v, httpFetch as w, incrementResponseIndex as x, isApiMethodMapRegistered as y, isOnline as z };

package/dist/{projectConfig-XL5VB76A.js → projectConfig-DBLSQ3NY.js}

@@ -4,7 +4,7 @@ import {
   getProjectName,
   isProjectConfigRegistered,
   registerProjectConfig
-} from "./chunk-LU3IPFTR.js";
+} from "./chunk-LTCDQU5Z.js";
 export {
   DEFAULT_PROJECT_CONFIG,
   getProjectConfig,
@@ -12,4 +12,4 @@ export {
   isProjectConfigRegistered,
   registerProjectConfig
 };
-//# sourceMappingURL=projectConfig-XL5VB76A.js.map
+//# sourceMappingURL=projectConfig-DBLSQ3NY.js.map

package/dist/{sentrySetup-4NTWLN2A.js → sentrySetup-MF6JSVWA.js}

@@ -4,8 +4,8 @@ import {
   initSharedSentry,
   setSentryUser,
   startSpan
-} from "./chunk-3AWP2YEA.js";
-import "./chunk-LU3IPFTR.js";
+} from "./chunk-J3UOWYT4.js";
+import "./chunk-LTCDQU5Z.js";
 export {
   captureException,
   captureMessage,
@@ -13,4 +13,4 @@ export {
   setSentryUser,
   startSpan
 };
-//# sourceMappingURL=sentrySetup-4NTWLN2A.js.map
+//# sourceMappingURL=sentrySetup-MF6JSVWA.js.map

package/dist/sentrySetup-MF6JSVWA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{pageRouteValidation-gqktrJci.d.ts → sessionTypes-Dzen_rPK.d.ts}

@@ -1,7 +1,3 @@
-import { Socket } from 'socket.io-client';
-
-declare function sleep(ms: number): Promise<void>;
-
 type DeepPartial<T> = {
     [K in keyof T]?: T[K] extends object | undefined ? DeepPartial<NonNullable<T[K]>> : T[K];
 };
@@ -734,214 +730,33 @@ declare const getProjectConfig: () => ProjectConfig;
 declare const getProjectName: () => string;
 declare const isProjectConfigRegistered: () => boolean;
 
-interface NotifyParam {
-    key: string;
-    value: string | number | boolean;
-}
-interface NotifyInput {
-    key: string;
-    params?: NotifyParam[];
-}
-interface Notifier {
-    success: (input: NotifyInput) => void;
-    error: (input: NotifyInput) => void;
-    info: (input: NotifyInput) => void;
-    warning: (input: NotifyInput) => void;
-}
-declare const registerNotifier: (notifier: Notifier) => void;
-declare const getNotifier: () => Notifier;
-declare const notify: Notifier;
-
-declare let socket: Socket | null;
-declare const setSocket: (next: Socket | null) => void;
-declare const incrementResponseIndex: () => number;
-declare const waitForSocket: () => Promise<Socket | null>;
-
-/** Why a queued item was dropped (handed to its `onDrop` callback). */
-type QueueDropReason = 'expired' | 'queue-full';
-interface ApiQueueItem {
-    id: string;
-    key: string;
-    run: (socketInstance: Socket) => void;
-    createdAt: number;
-    /**
-     * Per-request override of `projectConfig.offlineQueue.dropPolicy`. See
-     * `SyncQueueItem.dropPolicy` for details.
-     */
-    dropPolicy?: 'drop-oldest' | 'drop-newest' | 'reject';
-    /**
-     * Optional callback invoked when THIS item is dropped (evicted for age or
-     * because the queue was full / rejected) instead of ever running (SYNC-09).
-     * The transport wires this to settle the pending `syncRequest`/`apiRequest`
-     * promise with an error envelope, so an evicted offline request resolves
-     * rather than hanging forever. Invoked at most once; failures are swallowed.
-     */
-    onDrop?: (reason: QueueDropReason) => void;
-}
-interface SyncQueueItem {
-    id: string;
-    key: string;
-    run: (socketInstance: Socket) => void;
-    createdAt: number;
-    /**
-     * Per-request override of `projectConfig.offlineQueue.dropPolicy`. Lets a
-     * specific sync ("editor cursor move") pick `'drop-oldest'` while the app
-     * default stays `'reject'` for safer sends. When omitted, falls back to
-     * the global config.
-     */
-    dropPolicy?: 'drop-oldest' | 'drop-newest' | 'reject';
-    /** See {@link ApiQueueItem.onDrop} (SYNC-09). */
-    onDrop?: (reason: QueueDropReason) => void;
-}
-declare const isOnline: () => boolean;
-declare const enqueueApiRequest: (item: ApiQueueItem) => boolean;
-declare const enqueueSyncRequest: (item: SyncQueueItem) => boolean;
-declare const removeApiQueueItem: (id: string) => void;
-declare const removeSyncQueueItem: (id: string) => void;
-declare const removeApiQueueItemsByKey: (key: string) => void;
-declare const flushApiQueue: (canRun: () => boolean, socketInstance: Socket) => void;
-declare const flushSyncQueue: (canRun: () => boolean, socketInstance: Socket) => void;
-declare const getApiQueueSize: () => number;
-declare const getSyncQueueSize: () => number;
-
-interface ErrorParam {
-    key: string;
-    value: string | number | boolean;
-}
-interface ErrorResponseInput {
-    status?: unknown;
-    errorCode?: unknown;
-    errorParams?: unknown;
-    httpStatus?: unknown;
-}
-interface NormalizedErrorResponse {
-    status: 'error';
-    message: string;
-    errorCode: string;
-    errorParams?: ErrorParam[];
-    httpStatus?: number;
-}
-declare const INVALID_ERROR_RESPONSE_CODE = "error.invalidResponse";
-declare const isErrorParamArray: (value: unknown) => value is ErrorParam[];
-declare const normalizeErrorResponseCore: ({ response, fallbackHttpStatus, fallbackErrorCode, resolveMessage, }: {
-    response: ErrorResponseInput;
-    fallbackHttpStatus?: number;
-    fallbackErrorCode?: string;
-    resolveMessage?: (args: {
-        errorCode: string;
-        errorParams?: ErrorParam[];
-    }) => string;
-}) => NormalizedErrorResponse;
-declare const defaultHttpStatusForResponse: ({ status, explicitHttpStatus, fallbackErrorStatus, }: {
-    status: "success" | "error";
-    explicitHttpStatus?: number;
-    fallbackErrorStatus?: number;
-}) => number;
-
 /**
- * Fetch (or return the cached) CSRF token for the active session. Returns
- * null in token mode or when no session exists. Callers should attach the
- * returned value as the `X-CSRF-Token` request header.
- */
-declare const getCsrfToken: () => Promise<string | null>;
-/** Drop the cached token. Call this on logout or when a 403 csrfMismatch is seen. */
-declare const clearCsrfToken: () => void;
-/**
- * Drop-in replacement for `fetch` that automatically attaches the framework's
- * `X-CSRF-Token` and `X-Request-Id` headers to state-changing requests in
- * cookie mode. Use this for any project-side HTTP call that hits a
- * LuckyStack `/api/*`, `/sync/*`, or `/auth/api/*` endpoint.
+ * What `T` becomes after `JSON.stringify` → `JSON.parse`, at the type level.
+ *
+ * The mirror of what the codegen does to route OUTPUTS. Use it wherever you
+ * hand-write a type for something that CROSSES THE WIRE — the client never
+ * receives your server type, it receives JSON, and JSON has no `Date`:
  *
- * Behavior:
- *   - GET / OPTIONS / HEAD: passes through without CSRF (read-only).
- *   - Token mode: passes through without CSRF (immune by design).
- *   - Cookie mode + state-changing method: lazily fetches `/auth/csrf` once,
- *     caches, attaches as `x-csrf-token`. On a 403 `auth.csrfMismatch`
- *     response, clears the cache and retries once.
- *   - `credentials: 'include'` is forced unless the caller overrode it.
+ *   type ClientUser = Jsonify<User>;   // createdAt: string, not Date
  *
- * @example
- *   import { httpFetch } from '@luckystack/core/client';
- *   const res = await httpFetch('/api/system/myRoute/v1', {
- *     method: 'POST',
- *     body: JSON.stringify({ ... }),
- *   });
+ * Without it a type says `Date`, the client gets `"2026-07-15T15:20:15.553Z"`,
+ * and `user.createdAt.getTime()` compiles and then throws at runtime.
+ *
+ * Deliberately SHALLOW — one level of properties, descending only into arrays.
+ * A fully recursive object mapper does not survive contact with Prisma's
+ * self-referential `JsonValue`. Already-JSON-stable values are therefore an
+ * identity boundary: do not recursively rebuild what JSON already represents.
+ * The NON-DISTRIBUTIVE tuple guard is load-bearing — it recognizes the complete
+ * `JsonValue` union before the Date branch distributes `Date | null` into
+ * `string | null`.
  */
-declare const httpFetch: typeof fetch;
-
-interface ServiceRouteParseSuccess {
-    status: 'success';
-    normalizedRouteName: string;
-    service: string;
-    routeName: string;
-}
-interface ServiceRouteParseError {
-    status: 'error';
-    reason: string;
-}
-type ServiceRouteParseResult = ServiceRouteParseSuccess | ServiceRouteParseError;
-interface TransportRouteParseSuccess {
-    status: 'success';
-    normalizedFullName: string;
-    version: string;
-    serviceRoute: ServiceRouteParseSuccess;
-}
-interface TransportRouteParseError {
-    status: 'error';
-    reason: string;
-}
-type TransportRouteParseResult = TransportRouteParseSuccess | TransportRouteParseError;
-declare const parseServiceRouteName: (value: string) => ServiceRouteParseResult;
-declare const parseTransportRouteName: ({ value, prefix, }: {
-    value: string;
-    prefix: "api" | "sync";
-}) => TransportRouteParseResult;
-
-declare const socketEventNames: {
-    readonly apiRequest: "apiRequest";
-    readonly apiCancel: "apiCancel";
-    readonly sync: "sync";
-    readonly syncCancel: "syncCancel";
-    readonly joinRoom: "joinRoom";
-    readonly leaveRoom: "leaveRoom";
-    readonly getJoinedRooms: "getJoinedRooms";
-    readonly updateLocation: "updateLocation";
-    readonly updateSession: "updateSession";
-    readonly sessionReplaced: "sessionReplaced";
-    readonly logout: "logout";
-    readonly intentionalDisconnect: "intentionalDisconnect";
-    readonly intentionalReconnect: "intentionalReconnect";
-    readonly activity: "activity";
-    readonly userAfk: "userAfk";
-    readonly userBack: "userBack";
-    readonly userLeft: "userLeft";
-    readonly connect: "connect";
-    readonly disconnect: "disconnect";
-    readonly reconnectAttempt: "reconnect_attempt";
-    readonly connectError: "connect_error";
-    readonly apiResponsePrefix: "apiResponse-";
-    readonly apiStreamPrefix: "apiStream-";
-    readonly syncResponsePrefix: "sync-";
-    readonly syncProgressPrefix: "sync-progress-";
-    readonly joinRoomResponsePrefix: "joinRoom-";
-    readonly leaveRoomResponsePrefix: "leaveRoom-";
-    readonly getJoinedRoomsResponsePrefix: "getJoinedRooms-";
+type JsonStableValue = string | number | boolean | null | JsonStableValue[] | {
+    [key: string]: JsonStableValue | undefined;
+};
+type JsonifyValue<TValue> = [TValue] extends [JsonStableValue] ? TValue : TValue extends Date ? string : TValue extends readonly (infer TElement)[] ? JsonifyValue<TElement>[] : TValue;
+type Jsonify<T> = {
+    [TKey in keyof T]: JsonifyValue<T[TKey]>;
 };
-declare const buildApiResponseEventName: (responseIndex: number | string) => string;
-declare const buildApiStreamEventName: (responseIndex: number | string) => string;
-declare const buildSyncResponseEventName: (responseIndex: number | string) => string;
-declare const buildSyncProgressEventName: (responseIndex: number | string) => string;
-declare const buildJoinRoomResponseEventName: (responseIndex: number | string) => string;
-declare const buildLeaveRoomResponseEventName: (responseIndex: number | string) => string;
-declare const buildGetJoinedRoomsResponseEventName: (responseIndex: number | string) => string;
-
-type SOCKETSTATUS = "CONNECTED" | "DISCONNECTED" | "AFK" | "RECONNECTING" | "STARTUP";
-interface statusContent {
-    status: SOCKETSTATUS;
-    reconnectAttempt?: number;
-    endTime?: number;
-}
-
 interface SessionLocation {
     pathName: string;
     searchParams?: Record<string, string>;
@@ -994,61 +809,4 @@ interface AuthProps {
     }[];
 }
 
-type LoggerContext = Record<string, unknown>;
-interface Logger {
-    debug: (message: string, context?: LoggerContext) => void;
-    info: (message: string, context?: LoggerContext) => void;
-    warn: (message: string, context?: LoggerContext) => void;
-    error: (message: string, error?: unknown, context?: LoggerContext) => void;
-}
-declare const createDevLogger: () => Logger;
-declare const registerLogger: (logger: Logger) => void;
-declare const getLogger: () => Logger;
-declare const isLoggerRegistered: () => boolean;
-declare const resetLoggerForTests: () => void;
-
-type HttpMethodLiteral = 'GET' | 'POST' | 'PUT' | 'DELETE';
-type ApiMethodMap = Record<string, Record<string, Record<string, HttpMethodLiteral>>>;
-declare const registerApiMethodMap: (map: ApiMethodMap) => void;
-declare const getRegisteredApiMethod: (pagePath: string, apiName: string, version: string) => HttpMethodLiteral | undefined;
-declare const isApiMethodMapRegistered: () => boolean;
-
-interface PageRouteRules {
-    /**
-     * Single-character prefix that marks a folder as **invisible-parent** for
-     * page routing. Default: `'_'`.
-     */
-    privateFolderPrefix: string;
-    /**
-     * Folder names that are reserved for framework-internal use and may NEVER
-     * host a `page.tsx`, nested or otherwise. Scaffold + page-discovery emit
-     * a hard error when a page is placed inside one.
-     */
-    scaffoldIgnoredFolders: readonly string[];
-}
-declare const DEFAULT_PAGE_ROUTE_RULES: PageRouteRules;
-interface PagePathValidationResult {
-    /** `true` when the page file produces a routeable URL. */
-    valid: boolean;
-    /** Computed URL when `valid`. Always begins with `/`. `/` for root page. */
-    route?: string;
-    /** Human-readable explanation when `!valid`. */
-    reason?: string;
-}
-/**
- * Validate a `page.tsx` file path relative to `src/`. Accepts both
- * forward and back slashes, with or without a leading `./` or `/`.
- * The filename **must** be `page.tsx` (or `page.jsx`); other filenames
- * return `valid: false`.
- *
- * Examples (defaults):
- *   admin/page.tsx              -> { valid: true, route: '/admin' }
- *   _housing/renting/page.tsx   -> { valid: true, route: '/renting' }
- *   _housing/page.tsx           -> { valid: false, reason: 'no URL segment left after stripping underscore folders' }
- *   _api/something/page.tsx     -> { valid: false, reason: 'page.tsx cannot live inside reserved folder _api' }
- *   page.tsx                    -> { valid: true, route: '/' }
- *   some/route.tsx              -> { valid: false, reason: 'not a page file (expected page.tsx)' }
- */
-declare const validatePagePath: (srcRelativePath: string, rules?: PageRouteRules) => PagePathValidationResult;
-
-export { setSocket as $, type ApiMethodMap as A, type BaseSessionLayout as B, getProjectConfig as C, DEFAULT_PAGE_ROUTE_RULES as D, getRegisteredApiMethod as E, getSyncQueueSize as F, httpFetch as G, type HttpMethodLiteral as H, incrementResponseIndex as I, isApiMethodMapRegistered as J, isOnline as K, type Logger as L, isProjectConfigRegistered as M, type Notifier as N, normalizeErrorResponseCore as O, type PagePathValidationResult as P, notify as Q, type RateLimitingConfig as R, type SOCKETSTATUS as S, parseServiceRouteName as T, registerApiMethodMap as U, registerLogger as V, registerNotifier as W, registerProjectConfig as X, removeApiQueueItem as Y, removeApiQueueItemsByKey as Z, removeSyncQueueItem as _, type AppConfig as a, sleep as a0, socket as a1, socketEventNames as a2, type statusContent as a3, validatePagePath as a4, waitForSocket as a5, type ErrorParam as a6, type ErrorResponseInput as a7, type NormalizedErrorResponse as a8, type HealthHashConfig as a9, type TransportRouteParseResult as aA, type TransportRouteParseSuccess as aB, type ValidationConfig as aC, createDevLogger as aD, deepMerge as aE, defaultHttpStatusForResponse as aF, getProjectName as aG, isErrorParamArray as aH, isLoggerRegistered as aI, isPlainObject as aJ, parseTransportRouteName as aK, resetLoggerForTests as aL, type DeepPartial as aa, type ApiConfig as ab, type AuthConfig as ac, type AuthRateLimitConfig as ad, type CorsConfig as ae, DEFAULT_PROJECT_CONFIG as af, type DevConfig as ag, type HttpConfig as ah, type HttpStreamConfig as ai, INVALID_ERROR_RESPONSE_CODE as aj, type OfflineQueueConfig as ak, type PasswordPolicyConfig as al, type PathsConfig as am, type ProjectConfigInput as an, type QueueDropReason as ao, type RateLimitIdentity as ap, type RateLimitIdentityParams as aq, type SecurityHeadersConfig as ar, type ServiceRouteParseError as as, type ServiceRouteParseResult as at, type ServiceRouteParseSuccess as au, type SocketConfig as av, type SyncConfig as aw, type SyncFlushPressureConfig as ax, type SyncStreamThrottleConfig as ay, type TransportRouteParseError as az, type AuthProps as b, type LoggerContext as c, type LoggingConfig as d, type NotifyInput as e, type NotifyParam as f, type PageRouteRules as g, type ProjectConfig as h, type SessionConfig as i, type SessionLocation as j, buildApiResponseEventName as k, buildApiStreamEventName as l, buildGetJoinedRoomsResponseEventName as m, buildJoinRoomResponseEventName as n, buildLeaveRoomResponseEventName as o, buildSyncProgressEventName as p, buildSyncResponseEventName as q, clearCsrfToken as r, enqueueApiRequest as s, enqueueSyncRequest as t, flushApiQueue as u, flushSyncQueue as v, getApiQueueSize as w, getCsrfToken as x, getLogger as y, getNotifier as z };
+export { type AppConfig as A, type BaseSessionLayout as B, type CorsConfig as C, type DeepPartial as D, type HealthHashConfig as H, type Jsonify as J, type LoggingConfig as L, type OfflineQueueConfig as O, type ProjectConfig as P, type RateLimitingConfig as R, type SessionConfig as S, type ValidationConfig as V, type AuthProps as a, type SessionLocation as b, type ApiConfig as c, type AuthConfig as d, type AuthRateLimitConfig as e, DEFAULT_PROJECT_CONFIG as f, getProjectConfig as g, type DevConfig as h, isProjectConfigRegistered as i, type HttpConfig as j, type HttpStreamConfig as k, type PasswordPolicyConfig as l, type PathsConfig as m, type ProjectConfigInput as n, type RateLimitIdentity as o, type RateLimitIdentityParams as p, type SecurityHeadersConfig as q, registerProjectConfig as r, type SocketConfig as s, type SyncConfig as t, type SyncFlushPressureConfig as u, type SyncStreamThrottleConfig as v, deepMerge as w, getProjectName as x, isPlainObject as y };