solidstep 0.3.4 → 0.4.0

package/utils/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../utils/cache.ts"],"names":[],"mappings":"AA+CA,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,MAAM,KAAG,CAAC,GAAG,IAe7C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,MAAM,SA0BhE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,SAU1C,CAAC;AAEF,eAAO,MAAM,aAAa,YAGzB,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,SAS1C,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../utils/cache.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,MAAM,KAAG,CAAC,GAAG,IAe7C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,MAAM,SA0BhE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,SAU1C,CAAC;AAEF,eAAO,MAAM,aAAa,YAGzB,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,SAS1C,CAAC"}

package/utils/cache.js

@@ -6,38 +6,27 @@ let tail;
 const moveToFront = (node) => {
     if (node === head)
         return;
-    // Detach
-    if (node.prev)
-        node.prev.next = node.next;
+    // node.prev is always defined here: node !== head guarantees a predecessor
+    node.prev.next = node.next;
     if (node.next)
         node.next.prev = node.prev;
     if (node === tail)
         tail = node.prev;
-    // Insert at head
+    // head is always defined here: there are ≥2 nodes when moveToFront is reached
     node.prev = undefined;
     node.next = head;
-    if (head)
-        head.prev = node;
+    head.prev = node;
     head = node;
-    if (!tail)
-        tail = node;
 };
+// Only called when cacheMap.size > MAX_CACHE_ENTRIES, so tail and tail.prev are always defined.
 const removeTail = () => {
-    if (!tail)
-        return;
     cacheMap.delete(tail.key);
-    if (tail.prev) {
-        tail.prev.next = undefined;
-        tail = tail.prev;
-    }
-    else {
-        // Only one node
-        head = tail = undefined;
-    }
+    tail.prev.next = undefined;
+    tail = tail.prev;
 };
 export const getCache = (key) => {
     const entry = cacheMap.get(key);
-    if (!entry || !entry.expiresAt)
+    if (!entry)
         return null;
     if (entry.expiresAt && entry.expiresAt < performance.now()) {
         cacheMap.delete(key);

package/utils/components/form.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A server action function created by the `'use server'` directive.
+ * Has a `.url` property pointing to the `/_server` endpoint.
+ */
+export type ServerActionFn = {
+    (...args: any[]): any;
+    url?: string;
+};
+export type FormProps = {
+    /** Server action or wrapped formAction from useActionState */
+    action: ServerActionFn | ((formData: FormData) => void);
+    /** Form content */
+    children?: any;
+    /** Additional HTML form attributes are spread onto the <form> element */
+    [key: string]: any;
+};
+/**
+ * Enhanced `<form>` component that submits via server actions.
+ *
+ * - Intercepts form submission and calls the server action with `FormData`
+ * - Provides `FormStatusContext` for nested `useFormStatus()` calls
+ * - Supports progressive enhancement: when JS is disabled, the form
+ *   submits natively to the server action URL (if the action has one)
+ * - Supports `formAction` overrides on submitter elements (buttons)
+ *
+ * Rendered with Solid's isomorphic `Dynamic`, so it server-renders and hydrates
+ * correctly (no client-only primitives are evaluated on the server).
+ *
+ * @example
+ * ```tsx
+ * import { Form } from 'solidstep/form';
+ * import { createInvoice } from './actions';
+ *
+ * export default function Page() {
+ *   return (
+ *     <Form action={createInvoice}>
+ *       <input name="amount" />
+ *       <button type="submit">Create</button>
+ *     </Form>
+ *   );
+ * }
+ * ```
+ */
+declare const Form: (props: FormProps) => import("solid-js").JSX.Element;
+export { Form };
+export default Form;
+//# sourceMappingURL=form.d.ts.map

package/utils/components/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../../utils/components/form.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,8DAA8D;IAC9D,MAAM,EAAE,cAAc,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC;IACxD,mBAAmB;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,yEAAyE;IACzE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,IAAI,GAAI,OAAO,SAAS,mCA0E7B,CAAC;AAEF,OAAO,EAAE,IAAI,EAAE,CAAC;AAChB,eAAe,IAAI,CAAC"}

package/utils/components/form.js

@@ -0,0 +1,95 @@
+import { createComponent, createSignal, splitProps, mergeProps } from 'solid-js';
+import { Dynamic } from 'solid-js/web';
+import { FormStatusContext, } from '../hooks/form-status';
+/**
+ * Enhanced `<form>` component that submits via server actions.
+ *
+ * - Intercepts form submission and calls the server action with `FormData`
+ * - Provides `FormStatusContext` for nested `useFormStatus()` calls
+ * - Supports progressive enhancement: when JS is disabled, the form
+ *   submits natively to the server action URL (if the action has one)
+ * - Supports `formAction` overrides on submitter elements (buttons)
+ *
+ * Rendered with Solid's isomorphic `Dynamic`, so it server-renders and hydrates
+ * correctly (no client-only primitives are evaluated on the server).
+ *
+ * @example
+ * ```tsx
+ * import { Form } from 'solidstep/form';
+ * import { createInvoice } from './actions';
+ *
+ * export default function Page() {
+ *   return (
+ *     <Form action={createInvoice}>
+ *       <input name="amount" />
+ *       <button type="submit">Create</button>
+ *     </Form>
+ *   );
+ * }
+ * ```
+ */
+const Form = (props) => {
+    const [local, others] = splitProps(props, ['action', 'children']);
+    const [pending, setPending] = createSignal(false);
+    const [formData, setFormData] = createSignal(null);
+    const actionUrl = () => {
+        const action = local.action;
+        if (typeof action === 'function' && 'url' in action) {
+            return action.url || null;
+        }
+        return null;
+    };
+    const contextValue = {
+        pending,
+        data: formData,
+        method: () => 'POST',
+        action: actionUrl,
+    };
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        const form = e.currentTarget;
+        const submitter = e.submitter;
+        const data = new FormData(form, submitter);
+        // Check for formAction override on submitter element
+        let action = local.action;
+        if (submitter && '__serverAction' in submitter) {
+            action = submitter.__serverAction;
+        }
+        setFormData(data);
+        setPending(true);
+        try {
+            await action(data);
+        }
+        catch (error) {
+            console.error('Form action error:', error);
+        }
+        finally {
+            setPending(false);
+            setFormData(null);
+        }
+    };
+    // `Dynamic` renders a real <form> on both server and client. The `onSubmit`
+    // handler is attached only on the client (ignored during SSR); `method` and
+    // `action` are emitted as attributes for the no-JS progressive-enhancement
+    // fallback. Remaining props (class, id, data-*, ...) are spread through.
+    const formProps = mergeProps({
+        component: 'form',
+        method: 'POST',
+        onSubmit: handleSubmit,
+        get action() {
+            return actionUrl() ?? undefined;
+        },
+    }, others, {
+        get children() {
+            return local.children;
+        },
+    });
+    return createComponent(FormStatusContext.Provider, {
+        value: contextValue,
+        get children() {
+            return createComponent(Dynamic, formProps);
+        },
+    });
+};
+export { Form };
+export default Form;

package/utils/csp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csp.d.ts","sourceRoot":"","sources":["../../utils/csp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,KAAK,aAAa,GACZ,aAAa,GACb,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,UAAU,GACV,aAAa,GACb,WAAW,GACX,YAAY,GACZ,WAAW,GACX,iBAAiB,GACjB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,cAAc,CAAC;AAErB,KAAK,MAAM,GACL,QAAQ,GACR,QAAQ,GACR,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,OAAO,GACP,OAAO,GACP,aAAa,GACb,KAAK,GACL,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEb,KAAK,YAAY,GAAG;IAChB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C,CAAC;AAEF,KAAK,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAG7C,QAAA,MAAM,eAAe,GAAI,MAAM,aAAa,EAAE,SAAS,MAAM,EAAE,KAAG,YAGhE,CAAC;AAEH,QAAA,MAAM,SAAS,GAAI,WAAW,YAAY,EAAE,QAAQ,MAAM,KAAG,YAG3D,CAAC;AAEH,QAAA,MAAM,YAAY,GAAI,WAAW,YAAY,EAAE,QAAQ,MAAM,KAAG,YAG9D,CAAC;AAEH,QAAA,MAAM,UAAU,GAAI,WAAW,YAAY,EAAE,SAAS,MAAM,EAAE,KAAG,YAG/D,CAAC;AAGH,QAAA,MAAM,YAAY,GAAI,QAAQ,SAAS,EAAE,WAAW,YAAY,KAAG,SAQlE,CAAC;AAEF,QAAA,MAAM,eAAe,GACjB,QAAQ,SAAS,EACjB,MAAM,aAAa,EACnB,SAAS,CAAC,SAAS,EAAE,YAAY,KAAK,YAAY,KACnD,SAMF,CAAC;AAEF,QAAA,MAAM,eAAe,GAAI,QAAQ,SAAS,EAAE,MAAM,aAAa,KAAG,SACzB,CAAC;AAE1C,QAAA,MAAM,YAAY,GAAI,QAAQ,SAAS,EAAE,MAAM,aAAa,KAAG,YAAY,GAAG,SACvC,CAAC;AAaxC,QAAA,MAAM,aAAa,GAAI,GAAG,UAAU,SAAS,EAAE,KAAG,SAejD,CAAC;AAGF,QAAA,MAAM,kBAAkB,GAAI,WAAW,YAAY,KAAG,MACA,CAAC;AAEvD,QAAA,MAAM,eAAe,GAAI,QAAQ,SAAS,KAAG,MACA,CAAC;AAE9C,QAAA,MAAM,cAAc,GAAI,cAAc,MAAM,KAAG,YAAY,GAAG,IAM7D,CAAC;AAEF,QAAA,MAAM,WAAW,GAAI,WAAW,MAAM,KAAG,SASxC,CAAC;AAGF,QAAA,MAAM,kBAAkB,QAAO,SAM9B,CAAC;AAEF,QAAA,MAAM,gBAAgB,QAAO,SAY5B,CAAC;AAGF,QAAA,MAAM,sBAAsB,GAAI,QAAQ,SAAS,KAAG,SAMnD,CAAC;AAEF,QAAA,MAAM,qBAAqB,GAAI,QAAQ,SAAS,KAAG,SAG9C,CAAC;AAGN,QAAA,MAAM,OAAO,GAAI,QAAQ,SAAS,EAAE,QAAQ,MAAM,KAAG,SAQpD,CAAC;AAEF,QAAA,MAAM,eAAe,GAAI,QAAQ,SAAS,KAAG,SAM5C,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,QAAQ,SAAS,EAAE,gBAAc,KAAG,SAGvD,CAAC;AAEN,QAAA,MAAM,SAAS,GAAI,QAAQ,SAAS,EAAE,OAAO,MAAM,EAAE,aAAY,aAAa,EAAgC,KAAG,SAWhH,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,QAAQ,SAAS,EAAE,MAAM,MAAM,EAAE,YAAW,QAAQ,GAAG,QAAQ,GAAG,QAAmB,EAAE,YAAW,aAA4B,KAAG,SAGlJ,CAAC;AAGF,QAAA,MAAM,kBAAkB,GAAI,QAAQ,SAAS,EAAE,MAAM,aAAa,KAAG,OAC9B,CAAC;AAExC,QAAA,MAAM,SAAS,GAAI,QAAQ,SAAS,EAAE,MAAM,aAAa,EAAE,QAAQ,MAAM,KAAG,OAG3E,CAAC;AAEF,QAAA,MAAM,sBAAsB,GAAI,QAAQ,SAAS,KAAG,aAAa,EAKhE,CAAC;AAGF,OAAO,EAEH,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,SAAS,EAEd,eAAe,EACf,SAAS,EACT,YAAY,EACZ,UAAU,EAEV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,EAEb,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,cAAc,EAEd,kBAAkB,EAClB,gBAAgB,EAEhB,sBAAsB,EACtB,qBAAqB,EAErB,OAAO,EACP,eAAe,EACf,cAAc,EACd,SAAS,EACT,QAAQ,EAER,kBAAkB,EAClB,SAAS,EACT,sBAAsB,GACzB,CAAC"}
+{"version":3,"file":"csp.d.ts","sourceRoot":"","sources":["../../utils/csp.ts"],"names":[],"mappings":"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"}

package/utils/csp.js

@@ -61,8 +61,6 @@ const serializeDirective = (directive) => `${directive.name} ${directive.sources
 const serializePolicy = (policy) => policy.map(serializeDirective).join('; ');
 const parseDirective = (directiveStr) => {
     const parts = directiveStr.trim().split(/\s+/);
-    if (parts.length < 1)
-        return null;
     const [name, ...sources] = parts;
     return createDirective(name, sources);
 };

package/utils/hooks/action-state.d.ts

@@ -1,3 +1,21 @@
-declare const useActionState: () => readonly [import("solid-js").Accessor<boolean>, (callback: () => void | Promise<void>) => void];
+import { type Accessor } from 'solid-js';
+export type UseActionStateReturn<T> = [
+    state: Accessor<T>,
+    formAction: (formData: FormData) => void,
+    pending: Accessor<boolean>,
+    error: Accessor<Error | null>
+];
+/**
+ * Wraps a server action for use with `<Form>`.
+ *
+ * The server action receives `(prevState, formData)` and returns the new state.
+ * The returned `formAction` can be passed directly to `<Form action={formAction}>`.
+ *
+ * @param action - Server action: `(prevState: T, formData: FormData) => Promise<T>`
+ * @param initialState - Initial state value before any submission.
+ * @returns `[state, formAction, pending, error]`
+ */
+declare const useActionState: <T>(action: (prevState: T, formData: FormData) => Promise<T>, initialState: T) => UseActionStateReturn<T>;
+export { useActionState };
 export default useActionState;
 //# sourceMappingURL=action-state.d.ts.map

package/utils/hooks/action-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-state.d.ts","sourceRoot":"","sources":["../../../utils/hooks/action-state.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,cAAc,mEAIF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,UAU3C,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"action-state.d.ts","sourceRoot":"","sources":["../../../utils/hooks/action-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IAClC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClB,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI;IACxC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF;;;;;;;;;GASG;AACH,QAAA,MAAM,cAAc,GAAI,CAAC,EACrB,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EACxD,cAAc,CAAC,KAChB,oBAAoB,CAAC,CAAC,CAqBxB,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,eAAe,cAAc,CAAC"}

package/utils/hooks/action-state.js

@@ -1,13 +1,33 @@
 import { createSignal } from 'solid-js';
-const useActionState = () => {
+/**
+ * Wraps a server action for use with `<Form>`.
+ *
+ * The server action receives `(prevState, formData)` and returns the new state.
+ * The returned `formAction` can be passed directly to `<Form action={formAction}>`.
+ *
+ * @param action - Server action: `(prevState: T, formData: FormData) => Promise<T>`
+ * @param initialState - Initial state value before any submission.
+ * @returns `[state, formAction, pending, error]`
+ */
+const useActionState = (action, initialState) => {
+    const [state, setState] = createSignal(initialState);
     const [isPending, setIsPending] = createSignal(false);
-    const startTransition = (callback) => {
+    const [error, setError] = createSignal(null);
+    const formAction = (formData) => {
         setIsPending(true);
-        Promise.resolve(callback())
+        setError(null);
+        Promise.resolve(action(state(), formData))
+            .then((result) => {
+            setState(() => result);
+        })
+            .catch((err) => {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        })
             .finally(() => {
             setIsPending(false);
         });
     };
-    return [isPending, startTransition];
+    return [state, formAction, isPending, error];
 };
+export { useActionState };
 export default useActionState;

package/utils/hooks/form-status.d.ts

@@ -0,0 +1,12 @@
+import { type Accessor } from 'solid-js';
+export type FormStatusContextValue = {
+    pending: Accessor<boolean>;
+    data: Accessor<FormData | null>;
+    method: Accessor<string>;
+    action: Accessor<string | null>;
+};
+export declare const FormStatusContext: import("solid-js").Context<FormStatusContextValue | undefined>;
+declare const useFormStatus: () => FormStatusContextValue;
+export { useFormStatus };
+export default useFormStatus;
+//# sourceMappingURL=form-status.d.ts.map

package/utils/hooks/form-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-status.d.ts","sourceRoot":"","sources":["../../../utils/hooks/form-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpE,MAAM,MAAM,sBAAsB,GAAG;IACjC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,gEAA0C,CAAC;AAEzE,QAAA,MAAM,aAAa,QAAO,sBAWzB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,eAAe,aAAa,CAAC"}

package/utils/hooks/form-status.js

@@ -0,0 +1,16 @@
+import { createContext, useContext } from 'solid-js';
+export const FormStatusContext = createContext();
+const useFormStatus = () => {
+    const ctx = useContext(FormStatusContext);
+    if (!ctx) {
+        return {
+            pending: () => false,
+            data: () => null,
+            method: () => 'GET',
+            action: () => null,
+        };
+    }
+    return ctx;
+};
+export { useFormStatus };
+export default useFormStatus;

package/utils/instrumentation-noop.d.ts

@@ -0,0 +1,3 @@
+declare const _default: {};
+export default _default;
+//# sourceMappingURL=instrumentation-noop.d.ts.map

package/utils/instrumentation-noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation-noop.d.ts","sourceRoot":"","sources":["../../utils/instrumentation-noop.ts"],"names":[],"mappings":";AAEA,wBAAkB"}

package/utils/instrumentation-noop.js

@@ -0,0 +1,3 @@
+// utils/instrumentation-noop.ts
+// Empty module used when user doesn't have an instrumentation file
+export default {};

package/utils/instrumentation.d.ts

@@ -0,0 +1,94 @@
+export interface RequestContext {
+    /** The matched route path pattern (e.g., "/posts/[id]") */
+    routePath: string;
+    /** The actual URL pathname (e.g., "/posts/123") */
+    pathname: string;
+    /** Type of route being handled */
+    routeType: 'page' | 'api' | 'static' | 'not-found' | 'error' | 'server-action' | 'unknown';
+    /** Route parameters extracted from the path */
+    params: Record<string, string | string[]>;
+    /** URL search parameters */
+    searchParams: Record<string, string>;
+    /** High-resolution timestamp when request started */
+    startTime: number;
+    /** Custom metadata attached to the request */
+    metadata: Record<string, unknown>;
+    /** Unix timestamp (milliseconds) when request started */
+    startTimeEpoch: number;
+}
+export interface ResponseContext extends RequestContext {
+    /** HTTP status code */
+    statusCode: number;
+    /** Duration in milliseconds since request started */
+    duration: number;
+}
+export interface ServerInfo {
+    /** Full server URL (e.g., "http://localhost:3001") */
+    url: string;
+    /** Port number */
+    port: number;
+    /** Host (e.g., "localhost" or "0.0.0.0") */
+    host: string;
+    /** Current environment */
+    env: 'development' | 'production';
+}
+/** Called once during server startup. Errors will prevent server from starting. */
+export type RegisterFn = () => void | Promise<void>;
+/** Called before each request is processed */
+export type OnRequestFn = (request: Request, context: RequestContext) => void | Promise<void>;
+/** Called when response is ready but before streaming starts */
+export type OnResponseStartFn = (request: Request, response: Response, context: ResponseContext) => void | Promise<void>;
+/** Called after response stream is complete */
+export type OnResponseEndFn = (request: Request, context: ResponseContext) => void | Promise<void>;
+/** Called when server is fully ready and listening */
+export type OnServerReadyFn = (server: ServerInfo) => void | Promise<void>;
+/** Called when server is shutting down */
+export type OnShutdownFn = () => void | Promise<void>;
+/** Called when an error occurs during request processing */
+export type OnRequestErrorFn = (error: Error, context: RequestContext) => void | Promise<void>;
+export interface InstrumentationModule {
+    register?: RegisterFn;
+    onRequest?: OnRequestFn;
+    onResponseStart?: OnResponseStartFn;
+    onResponseEnd?: OnResponseEndFn;
+    onServerReady?: OnServerReadyFn;
+    onShutdown?: OnShutdownFn;
+    onRequestError?: OnRequestErrorFn;
+}
+/**
+ * Define instrumentation with full type safety.
+ *
+ * @example
+ * ```ts
+ * // instrumentation.ts
+ * import { defineInstrumentation } from './utils/instrumentation';
+ *
+ * export default defineInstrumentation({
+ *   async register() {
+ *     // Initialize telemetry
+ *   },
+ *   async onRequest(request, context) {
+ *     console.log(`${request.method} ${context.pathname}`);
+ *   },
+ * });
+ * ```
+ */
+export declare function defineInstrumentation(config: InstrumentationModule): InstrumentationModule;
+/**
+ * Load the user's instrumentation module.
+ * Called once during server startup.
+ */
+export declare function loadInstrumentation(): Promise<InstrumentationModule | null>;
+/**
+ * Get the loaded instrumentation module.
+ * Returns null if not loaded or no instrumentation file exists.
+ */
+export declare function getInstrumentation(): InstrumentationModule | null;
+/**
+ * Safely execute a hook, catching and logging any errors.
+ * Used for request/response hooks where we don't want to fail the request.
+ */
+export declare function safeExecuteHook<T extends (...args: any[]) => any>(hookName: string, hook: T | undefined, ...args: Parameters<T>): Promise<void>;
+export declare function createRequestContext(request: Request, overrides?: Partial<RequestContext>): RequestContext;
+export declare function createResponseContext(requestContext: RequestContext, statusCode: number): ResponseContext;
+//# sourceMappingURL=instrumentation.d.ts.map

package/utils/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../utils/instrumentation.ts"],"names":[],"mappings":"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"}

package/utils/instrumentation.js

@@ -0,0 +1,132 @@
+// utils/instrumentation.ts
+// Instrumentation types, helpers, and loader for SolidStep telemetry
+// Instrumentation types, helpers, and loader for SolidStep telemetry
+// ============================================
+// Helper for Type-Safe Definition
+// ============================================
+/**
+ * Define instrumentation with full type safety.
+ *
+ * @example
+ * ```ts
+ * // instrumentation.ts
+ * import { defineInstrumentation } from './utils/instrumentation';
+ *
+ * export default defineInstrumentation({
+ *   async register() {
+ *     // Initialize telemetry
+ *   },
+ *   async onRequest(request, context) {
+ *     console.log(`${request.method} ${context.pathname}`);
+ *   },
+ * });
+ * ```
+ */
+export function defineInstrumentation(config) {
+    return config;
+}
+// ============================================
+// Internal State & Loader
+// ============================================
+let instrumentationModule = null;
+let initPromise = null;
+let initError = null;
+/**
+ * Load the user's instrumentation module.
+ * Called once during server startup.
+ */
+export async function loadInstrumentation() {
+    if (initPromise) {
+        return initPromise;
+    }
+    initPromise = (async () => {
+        try {
+            // This import is resolved at build time via alias
+            // @ts-expect-error - resolved at build time by Vite alias
+            const module = await import('instrumentation');
+            // Support both default export and named exports
+            if (module.default && typeof module.default === 'object') {
+                instrumentationModule = module.default;
+            }
+            else {
+                // Named exports
+                instrumentationModule = {
+                    register: module.register,
+                    onRequest: module.onRequest,
+                    onResponseStart: module.onResponseStart,
+                    onResponseEnd: module.onResponseEnd,
+                    onServerReady: module.onServerReady,
+                    onShutdown: module.onShutdown,
+                    onRequestError: module.onRequestError,
+                };
+            }
+            return instrumentationModule;
+        }
+        catch (e) {
+            // Check if it's a "module not found" error (no instrumentation file)
+            if (e.code === 'ERR_MODULE_NOT_FOUND' ||
+                e.message?.includes('Cannot find module')) {
+                return null;
+            }
+            // Re-throw other errors (syntax errors, etc.)
+            initError = e;
+            throw e;
+        }
+    })();
+    try {
+        return await initPromise;
+    }
+    catch (e) {
+        if (initError)
+            throw initError;
+        throw e;
+    }
+}
+/**
+ * Get the loaded instrumentation module.
+ * Returns null if not loaded or no instrumentation file exists.
+ */
+export function getInstrumentation() {
+    return instrumentationModule;
+}
+// ============================================
+// Safe Hook Executors (for request lifecycle)
+// ============================================
+/**
+ * Safely execute a hook, catching and logging any errors.
+ * Used for request/response hooks where we don't want to fail the request.
+ */
+export async function safeExecuteHook(hookName, hook, ...args) {
+    if (!hook)
+        return;
+    try {
+        await hook(...args);
+    }
+    catch (error) {
+        console.error(`[instrumentation] Error in ${hookName} hook:`, error);
+    }
+}
+// ============================================
+// Request Context Builder
+// ============================================
+export function createRequestContext(request, overrides = {}) {
+    const url = new URL(request.url);
+    return {
+        routePath: 'unknown',
+        pathname: url.pathname,
+        routeType: 'unknown',
+        params: {},
+        searchParams: Object.fromEntries(url.searchParams),
+        startTime: performance.now(),
+        metadata: {},
+        startTimeEpoch: Date.now(),
+        ...overrides,
+    };
+}
+export function createResponseContext(requestContext, statusCode) {
+    return {
+        ...requestContext,
+        statusCode,
+        duration: performance.now() - requestContext.startTime,
+    };
+}

package/utils/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../utils/loader.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D,KAAK,aAAa,GAAG;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,UAAU,aAAa;uBAE9C,OAAO;;;;;QAoB1C,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAA;CAAE,GAC7F,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,GACtE,KAAK,CAAC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../utils/loader.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D,KAAK,aAAa,GAAG;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,UAAU,aAAa;uBAE9C,OAAO;;;;;QAe1C,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAA;CAAE,GAC7F,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,GACtE,KAAK,CAAC"}

package/utils/loader.js

@@ -2,17 +2,11 @@ import { isServer } from 'solid-js/web';
 export const defineLoader = (loader, options) => {
     if (isServer) {
         const fn = async (request) => {
-            try {
-                const loaderData = await loader(request);
-                return {
-                    data: loaderData,
-                    type: options?.type || 'sequential',
-                };
-            }
-            catch (error) {
-                console.error('Error in loader:', error);
-                throw error; // Re-throw to allow error handling upstream
-            }
+            const loaderData = await loader(request);
+            return {
+                data: loaderData,
+                type: options?.type || 'sequential',
+            };
         };
         return {
             loader: fn,

package/utils/middleware.d.ts

@@ -0,0 +1,43 @@
+import { type H3Event } from 'vinxi/http';
+/**
+ * Runs before the matched route handler. Return a `Response` (or call
+ * `event.respondWith(...)`) to short-circuit the chain — later middleware and
+ * the route handler are skipped.
+ */
+export type MiddlewareRequestHandler = (event: H3Event) => void | Response | Promise<void | Response>;
+/**
+ * Runs after the route handler, before the response is sent. Receives the
+ * resolved response body so it can be inspected or mutated. Cannot short-circuit.
+ */
+export type MiddlewareResponseHandler = (event: H3Event, response: {
+    body?: unknown;
+}) => void | Promise<void>;
+/** A single middleware unit. Either hook is optional. */
+export type Middleware = {
+    onRequest?: MiddlewareRequestHandler;
+    onBeforeResponse?: MiddlewareResponseHandler;
+};
+/**
+ * Compose an ordered array of middleware into a single Vinxi middleware object.
+ *
+ * `onRequest` hooks run in array order and stop as soon as one returns a
+ * `Response` or marks the event handled. `onBeforeResponse` hooks always all
+ * run, in array order.
+ *
+ * @example
+ * ```ts
+ * // app/middleware.ts
+ * import { defineMiddleware } from 'solidstep/utils/middleware';
+ *
+ * export default defineMiddleware([
+ *   authMiddleware,
+ *   corsMiddleware,
+ *   csrfMiddleware,
+ * ]);
+ * ```
+ */
+export declare const defineMiddleware: (middlewares: Middleware[]) => {
+    onRequest?: import("vinxi/http")._RequestMiddleware | import("vinxi/http")._RequestMiddleware[] | undefined;
+    onBeforeResponse?: import("vinxi/http")._ResponseMiddleware | import("vinxi/http")._ResponseMiddleware[] | undefined;
+};
+//# sourceMappingURL=middleware.d.ts.map

package/utils/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../utils/middleware.ts"],"names":[],"mappings":"AAOA,OAAO,EAA6C,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACnC,KAAK,EAAE,OAAO,KACb,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KAC3B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG;IACrB,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAChD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,GAAI,aAAa,UAAU,EAAE;;;CAmBpD,CAAC"}