@runku/react 0.4.8

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Aldemi Tech
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,94 @@
+# `@runku/react`
+
+React and Next.js bindings for `@runku/client`. The package provides typed Function references,
+Realtime Query hooks, Mutation and Action hooks, file transfer helpers, and request-local server
+utilities with hydration.
+
+Install the exact frontend SDK pair together:
+
+```sh
+pnpm add @runku/react@0.4.8 @runku/client@0.4.8
+```
+
+Version 0.4.8 uses Public Protocol v1 and is compatible with the Runku 0.4.7 gateway. The published
+0.4.7 CLI predates runtime Function-reference generation; use references emitted by the current
+source CLI until a later coordinated distribution includes that codegen.
+
+## Generated Function references
+
+`runku build` writes two runtime/type pairs below `runku/_generated`:
+
+- `api.js` and `api.d.ts`: browser-safe public Functions. Functions with `auth: "service"` are
+  excluded.
+- `server.js` and `server.d.ts`: every externally callable public Function, including service-only
+  Functions. Keep imports from this module in server-only files.
+
+Internal Functions are callable only by trusted nested Function calls and are never emitted into
+either external tree. Function names separated by `.` or `/` become nested properties, so a
+Function named `tasks.list` is addressed as `api.tasks.list`. Authentication is part of the
+reference type; browser hooks reject an `auth: "service"` reference even if one is imported from
+the wrong module.
+
+```tsx
+"use client";
+
+import { useMutation, useQuery } from "@runku/react";
+import { api } from "../runku/_generated/api.js";
+
+export function Tasks() {
+  const tasks = useQuery(api.tasks.list, { board: "today" });
+  const createTask = useMutation(api.tasks.create);
+  // Arguments and results are inferred from the generated reference.
+  return null;
+}
+```
+
+## Provider and identity isolation
+
+Create one stable `RunkuClient`, then provide a non-secret `identityKey` that changes whenever the
+effective user, guest, or service identity changes. Changing it closes the old Realtime connection
+and drops the old cache.
+
+```tsx
+<RunkuProvider client={client} identityKey={session.user.id}>
+  {children}
+</RunkuProvider>
+```
+
+`useQuery` shares one Realtime subscription per canonical Function/arguments/target key. Its
+hydrated value is marked `isStale` until Realtime confirms the current state. `useMutation` keeps a
+stable Operation ID within the underlying client's retry cycle. `useAction` is never automatically
+retried. `useUploadFile` and `useDownloadFile` consume short-lived grants returned by storage
+Actions; the grant itself is authority and must not be logged or persisted.
+
+The provider supports the development effect replay performed by React Strict Mode. Cleanup closes
+the current Realtime transport; if React subscribes the same mounted store again, the provider opens
+a fresh transport while retaining only that identity's cached Query snapshots.
+
+## Next.js server usage
+
+Create the facade per request. It exposes every operation available to browser code plus
+`preloadQuery` and `dehydrate`.
+
+```tsx
+import "server-only";
+import { createRunkuReactServer } from "@runku/react/server";
+import { serverApi } from "../runku/_generated/server.js";
+
+const runku = createRunkuReactServer(serverClient, session.user.id);
+const result = await runku.preloadQuery(serverApi.tasks.list, { board: "today" });
+await runku.mutation(serverApi.tasks.create, { title: "Review" });
+await runku.action(serverApi.tasks.export, null);
+const state = runku.dehydrate();
+```
+
+Pass `state` through a `RunkuHydrationBoundary` surrounding `RunkuProvider`. Hydration uses Runku
+Wire Value v1 rather than JavaScript class instances, so timestamps, IDs, bytes, and 64-bit integers
+cross the React Server Component boundary losslessly.
+
+The server facade also delegates `uploadFile`, `downloadFile`, and `realtime`. Use Realtime only in
+a long-lived server process with an injected WebSocket factory, not as a request-scoped Server
+Component subscription. It does not make Action effects
+retry-safe: callers remain responsible for Action idempotency. The current SDK supports Runku
+Application File grants. Native S3 multipart operations and a generic object-storage presigner are
+not part of this package.

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from "react";
+import type { BrowserFunctionAuth, CallOptions, FileDownloadGrant, FileDownloadOptions, FileMetadata, FileUploadGrant, FileUploadOptions, FunctionReference, MutationOptions, RunkuClient, RunkuResult, RunkuValue } from "@runku/client";
+import { type RunkuDehydratedState } from "./shared.js";
+import { type QueryState } from "./store.js";
+export type { RunkuDehydratedState } from "./shared.js";
+export type { QueryState, QueryStatus } from "./store.js";
+export interface UseQueryResult<T extends RunkuValue> extends QueryState<T> {
+    readonly refetch: () => Promise<RunkuResult<T>>;
+}
+export interface OperationState<T extends RunkuValue> {
+    readonly status: "idle" | "pending" | "success" | "error";
+    readonly data: T | undefined;
+    readonly result: RunkuResult<T> | undefined;
+    readonly error: unknown;
+}
+export interface UseMutationResult<A extends RunkuValue, R extends RunkuValue> extends OperationState<R> {
+    readonly mutate: (argumentsValue: A, options?: MutationOptions) => Promise<RunkuResult<R>>;
+    readonly reset: () => void;
+}
+export interface UseActionResult<A extends RunkuValue, R extends RunkuValue> extends OperationState<R> {
+    readonly execute: (argumentsValue: A, options?: CallOptions) => Promise<RunkuResult<R>>;
+    readonly reset: () => void;
+}
+export interface RunkuHydrationBoundaryProps {
+    readonly state: RunkuDehydratedState;
+    readonly children: ReactNode;
+}
+export declare function RunkuHydrationBoundary({ state, children }: RunkuHydrationBoundaryProps): import("react/jsx-runtime").JSX.Element;
+export interface RunkuProviderProps {
+    readonly client: RunkuClient;
+    /** Stable, non-secret identity/cache partition such as a user ID or `anonymous`. */
+    readonly identityKey: string;
+    readonly children: ReactNode;
+}
+export declare function RunkuProvider({ client, identityKey, children }: RunkuProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useRunkuClient(): RunkuClient;
+export declare function useQuery<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"query", A, R, BrowserFunctionAuth>, argumentsValue: A, options?: CallOptions): UseQueryResult<R>;
+export declare function useMutation<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"mutation", A, R, BrowserFunctionAuth>): UseMutationResult<A, R>;
+export declare function useAction<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"action", A, R, BrowserFunctionAuth>): UseActionResult<A, R>;
+export declare function useUploadFile(): (grant: FileUploadGrant, body: BodyInit, options?: FileUploadOptions) => Promise<FileMetadata>;
+export declare function useDownloadFile(): (grant: FileDownloadGrant, options?: FileDownloadOptions) => Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,96 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, useSyncExternalStore, } from "react";
+import { queryKey, } from "./shared.js";
+import { RunkuStore, } from "./store.js";
+const StoreContext = createContext(null);
+const HydrationContext = createContext(null);
+export function RunkuHydrationBoundary({ state, children }) {
+    return _jsx(HydrationContext.Provider, { value: state, children: children });
+}
+export function RunkuProvider({ client, identityKey, children }) {
+    const hydration = useContext(HydrationContext);
+    const store = useMemo(() => new RunkuStore(client, identityKey, hydration), [client, identityKey, hydration]);
+    useEffect(() => () => store.close(), [store]);
+    return _jsx(StoreContext.Provider, { value: store, children: children });
+}
+export function useRunkuClient() {
+    return useStore().client;
+}
+export function useQuery(reference, argumentsValue, options = {}) {
+    const store = useStore();
+    const key = queryKey(reference, argumentsValue, options);
+    const stableArguments = useMemo(() => argumentsValue, [key]);
+    const stableOptions = useMemo(() => ({
+        ...(options.target === undefined ? {} : { target: options.target }),
+        ...(options.signal === undefined ? {} : { signal: options.signal }),
+    }), [options.target, options.signal]);
+    const subscribe = useCallback((listener) => store.listen(key, reference, stableArguments, stableOptions, listener), [store, key, reference, stableArguments, stableOptions]);
+    const getSnapshot = useCallback(() => store.entry(key).snapshot, [store, key]);
+    const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const refetch = useCallback(() => store.refetch(key, reference, stableArguments, stableOptions), [store, key, reference, stableArguments, stableOptions]);
+    return useMemo(() => ({ ...snapshot, refetch }), [snapshot, refetch]);
+}
+export function useMutation(reference) {
+    const client = useRunkuClient();
+    const [state, setState] = useState(idleState);
+    const mutate = useCallback(async (argumentsValue, options) => {
+        setState(pendingState);
+        try {
+            const result = await client.mutation(reference, argumentsValue, options);
+            setState({ status: "success", data: result.value, result, error: null });
+            return result;
+        }
+        catch (error) {
+            setState({ status: "error", data: undefined, result: undefined, error });
+            throw error;
+        }
+    }, [client, reference]);
+    const reset = useCallback(() => setState(idleState), []);
+    return { ...state, mutate, reset };
+}
+export function useAction(reference) {
+    const client = useRunkuClient();
+    const [state, setState] = useState(idleState);
+    const execute = useCallback(async (argumentsValue, options) => {
+        setState(pendingState);
+        try {
+            const result = await client.action(reference, argumentsValue, options);
+            setState({ status: "success", data: result.value, result, error: null });
+            return result;
+        }
+        catch (error) {
+            setState({ status: "error", data: undefined, result: undefined, error });
+            throw error;
+        }
+    }, [client, reference]);
+    const reset = useCallback(() => setState(idleState), []);
+    return { ...state, execute, reset };
+}
+export function useUploadFile() {
+    const client = useRunkuClient();
+    return useCallback((grant, body, options) => client.uploadFile(grant, body, options), [client]);
+}
+export function useDownloadFile() {
+    const client = useRunkuClient();
+    return useCallback((grant, options) => client.downloadFile(grant, options), [client]);
+}
+function useStore() {
+    const store = useContext(StoreContext);
+    if (store === null)
+        throw new Error("Runku hooks must be used inside RunkuProvider");
+    return store;
+}
+const idleState = Object.freeze({
+    status: "idle",
+    data: undefined,
+    result: undefined,
+    error: null,
+});
+const pendingState = Object.freeze({
+    status: "pending",
+    data: undefined,
+    result: undefined,
+    error: null,
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+import type { CallOptions, FileDownloadGrant, FileDownloadOptions, FileMetadata, FileUploadGrant, FileUploadOptions, FunctionReference, MutationOptions, RunkuClient, RunkuRealtimeClient, RunkuResult, RunkuValue, RealtimeClientOptions } from "@runku/client";
+import { type RunkuDehydratedState } from "./shared.js";
+export type { DehydratedQuery, RunkuDehydratedState } from "./shared.js";
+export interface RunkuReactServer {
+    readonly client: RunkuClient;
+    query<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"query", A, R>, argumentsValue: A, options?: CallOptions): Promise<RunkuResult<R>>;
+    preloadQuery<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"query", A, R>, argumentsValue: A, options?: CallOptions): Promise<RunkuResult<R>>;
+    mutation<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"mutation", A, R>, argumentsValue: A, options?: MutationOptions): Promise<RunkuResult<R>>;
+    action<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"action", A, R>, argumentsValue: A, options?: CallOptions): Promise<RunkuResult<R>>;
+    uploadFile(grant: FileUploadGrant, body: BodyInit, options?: FileUploadOptions): Promise<FileMetadata>;
+    downloadFile(grant: FileDownloadGrant, options?: FileDownloadOptions): Promise<Response>;
+    /** Opens Realtime for a long-lived server process; avoid request-scoped RSC subscriptions. */
+    realtime(options?: RealtimeClientOptions): RunkuRealtimeClient;
+    dehydrate(): RunkuDehydratedState;
+}
+/** Creates a request-local server facade. Never share it between identities or requests. */
+export declare function createRunkuReactServer(client: RunkuClient, identityKey: string): RunkuReactServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EAC9C,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC3C,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EACrD,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC3C,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EACjD,SAAS,EAAE,iBAAiB,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9C,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EAC/C,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,EAC5C,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACvG,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzF,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,CAAC;IAC/D,SAAS,IAAI,oBAAoB,CAAC;CACnC;AAED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAkCjG"}

package/dist/server.js

@@ -0,0 +1,35 @@
+import { dehydrateResult, queryKey, } from "./shared.js";
+/** Creates a request-local server facade. Never share it between identities or requests. */
+export function createRunkuReactServer(client, identityKey) {
+    if (identityKey.length === 0)
+        throw new TypeError("identityKey must not be empty");
+    const queries = new Map();
+    const pending = new Map();
+    const preloadQuery = async (reference, argumentsValue, options = {}) => {
+        const key = queryKey(reference, argumentsValue, options);
+        let promise = pending.get(key);
+        if (promise === undefined) {
+            promise = client.query(reference, argumentsValue, options);
+            pending.set(key, promise);
+        }
+        const result = await promise;
+        queries.set(key, dehydrateResult(key, reference, argumentsValue, options, result));
+        return result;
+    };
+    return {
+        client,
+        query: (reference, argumentsValue, options) => client.query(reference, argumentsValue, options),
+        preloadQuery,
+        mutation: (reference, argumentsValue, options) => client.mutation(reference, argumentsValue, options),
+        action: (reference, argumentsValue, options) => client.action(reference, argumentsValue, options),
+        uploadFile: (grant, body, options) => client.uploadFile(grant, body, options),
+        downloadFile: (grant, options) => client.downloadFile(grant, options),
+        realtime: (options) => client.realtime(options),
+        dehydrate: () => Object.freeze({
+            version: 1,
+            identityKey,
+            queries: Object.freeze([...queries.values()]),
+        }),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,eAAe,EACf,QAAQ,GAET,MAAM,aAAa,CAAC;AAiCrB,4FAA4F;AAC5F,MAAM,UAAU,sBAAsB,CAAC,MAAmB,EAAE,WAAmB;IAC7E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmD,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4C,CAAC;IACpE,MAAM,YAAY,GAAG,KAAK,EACxB,SAA2C,EAC3C,cAAiB,EACjB,OAAO,GAAgB,EAAE,EACA,EAAE;QAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAwC,CAAC;QACtE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAsD,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACnF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,OAAO;QACL,MAAM;QACN,KAAK,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC;QAC/F,YAAY;QACZ,QAAQ,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC;QACrG,MAAM,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC;QACjG,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;QAC7E,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC;QACrE,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC/C,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7B,OAAO,EAAE,CAAC;YACV,WAAW;YACX,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;SAC9C,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/shared.d.ts

@@ -0,0 +1,22 @@
+import { type CallOptions, type CodeTarget, type FunctionReference, type RunkuResult, type RunkuValue } from "@runku/client";
+export interface DehydratedQuery {
+    readonly key: string;
+    readonly target: CodeTarget | null;
+    readonly functionName: string;
+    readonly arguments: unknown;
+    readonly result: {
+        readonly requestId: string;
+        readonly releaseId: string;
+        readonly value: unknown;
+        readonly snapshotSequence: string | null;
+    };
+}
+export interface RunkuDehydratedState {
+    readonly version: 1;
+    readonly identityKey: string;
+    readonly queries: readonly DehydratedQuery[];
+}
+export declare function queryKey<A extends RunkuValue, R extends RunkuValue>(reference: FunctionReference<"query", A, R>, argumentsValue: A, options?: CallOptions): string;
+export declare function dehydrateResult<A extends RunkuValue, T extends RunkuValue>(key: string, reference: FunctionReference<"query", A, T>, argumentsValue: A, options: CallOptions, result: RunkuResult<T>): DehydratedQuery;
+export declare function hydrateValue(entry: DehydratedQuery): RunkuValue;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;CAC9C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EACjE,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC3C,cAAc,EAAE,CAAC,EACjB,OAAO,GAAE,WAAgB,GACxB,MAAM,CAMR;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EACxE,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC3C,cAAc,EAAE,CAAC,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,eAAe,CAcjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAE/D"}

package/dist/shared.js

@@ -0,0 +1,28 @@
+import { decodeValue, encodeValue, } from "@runku/client";
+export function queryKey(reference, argumentsValue, options = {}) {
+    return JSON.stringify([
+        options.target ?? null,
+        reference.name,
+        encodeValue(argumentsValue),
+    ]);
+}
+export function dehydrateResult(key, reference, argumentsValue, options, result) {
+    if (result.metadata.kind !== "query")
+        throw new TypeError("Only query results can be dehydrated");
+    return Object.freeze({
+        key,
+        target: options.target ?? null,
+        functionName: reference.name,
+        arguments: encodeValue(argumentsValue),
+        result: Object.freeze({
+            requestId: result.requestId,
+            releaseId: result.releaseId,
+            value: encodeValue(result.value),
+            snapshotSequence: result.metadata.snapshotSequence?.toString() ?? null,
+        }),
+    });
+}
+export function hydrateValue(entry) {
+    return decodeValue(entry.result.value);
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,GAMZ,MAAM,eAAe,CAAC;AAqBvB,MAAM,UAAU,QAAQ,CACtB,SAA2C,EAC3C,cAAiB,EACjB,OAAO,GAAgB,EAAE;IAEzB,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,CAAC,MAAM,IAAI,IAAI;QACtB,SAAS,CAAC,IAAI;QACd,WAAW,CAAC,cAAc,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,SAA2C,EAC3C,cAAiB,EACjB,OAAoB,EACpB,MAAsB;IAEtB,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAClG,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG;QACH,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,YAAY,EAAE,SAAS,CAAC,IAAI;QAC5B,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC;QACtC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;YAChC,gBAAgB,EAAE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,EAAE,IAAI,IAAI;SACvE,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAsB;IACjD,OAAO,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,31 @@
+import type { BrowserFunctionAuth, CallOptions, FunctionReference, RunkuClient, RunkuError, RunkuRealtimeSubscription, RunkuResult, RunkuValue } from "@runku/client";
+import { type RunkuDehydratedState } from "./shared.js";
+export type QueryStatus = "pending" | "success" | "error";
+export interface QueryState<T extends RunkuValue> {
+    readonly status: QueryStatus;
+    readonly data: T | undefined;
+    readonly error: RunkuError | null;
+    readonly releaseId: string | null;
+    readonly snapshotSequence: bigint | null;
+    readonly isStale: boolean;
+}
+interface QueryEntry<T extends RunkuValue = RunkuValue> {
+    snapshot: QueryState<T>;
+    listeners: Set<() => void>;
+    subscription: RunkuRealtimeSubscription<T> | null;
+}
+/** Internal query store. It is emitted for package tests but is not a public package export. */
+export declare class RunkuStore {
+    #private;
+    readonly client: RunkuClient;
+    readonly entries: Map<string, QueryEntry<RunkuValue>>;
+    constructor(client: RunkuClient, identityKey: string, state: RunkuDehydratedState | null);
+    entry(key: string): QueryEntry;
+    listen<A extends RunkuValue, R extends RunkuValue>(key: string, reference: FunctionReference<"query", A, R, BrowserFunctionAuth>, argumentsValue: A, options: CallOptions, listener: () => void): () => void;
+    refetch<A extends RunkuValue, R extends RunkuValue>(key: string, reference: FunctionReference<"query", A, R, BrowserFunctionAuth>, argumentsValue: A, options: CallOptions): Promise<RunkuResult<R>>;
+    close(): void;
+    private realtime;
+    private emit;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,UAAU,EAEV,yBAAyB,EACzB,WAAW,EACX,UAAU,EACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,UAAU;IAC9C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,UAAU,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IACpD,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B,YAAY,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACnD;AAYD,gGAAgG;AAChG,qBAAa,UAAU;;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,sCAAiC;IAGjD,YAAY,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,EA2BvF;IAED,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAY7B;IAED,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EAC/C,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,EAChE,cAAc,EAAE,CAAC,EACjB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAqCZ;IAEK,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,EACtD,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,EAChE,cAAc,EAAE,CAAC,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAczB;IAED,KAAK,IAAI,IAAI,CAQZ;IAED,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;CAGb"}

package/dist/store.js

@@ -0,0 +1,131 @@
+import { hydrateValue, } from "./shared.js";
+const PENDING = Object.freeze({
+    status: "pending",
+    data: undefined,
+    error: null,
+    releaseId: null,
+    snapshotSequence: null,
+    isStale: false,
+});
+const MAX_CACHED_QUERIES = 500;
+/** Internal query store. It is emitted for package tests but is not a public package export. */
+export class RunkuStore {
+    client;
+    entries = new Map();
+    #realtime = null;
+    constructor(client, identityKey, state) {
+        this.client = client;
+        if (identityKey.length === 0)
+            throw new TypeError("identityKey must not be empty");
+        if (state !== null) {
+            if (state.version !== 1 || state.identityKey !== identityKey) {
+                throw new TypeError("Runku hydration state does not match the active identity");
+            }
+            if (state.queries.length > MAX_CACHED_QUERIES) {
+                throw new TypeError("Runku hydration state exceeds the query cache limit");
+            }
+            for (const query of state.queries) {
+                this.entries.set(query.key, {
+                    snapshot: Object.freeze({
+                        status: "success",
+                        data: hydrateValue(query),
+                        error: null,
+                        releaseId: query.result.releaseId,
+                        snapshotSequence: query.result.snapshotSequence === null
+                            ? null
+                            : BigInt(query.result.snapshotSequence),
+                        isStale: true,
+                    }),
+                    listeners: new Set(),
+                    subscription: null,
+                });
+            }
+        }
+    }
+    entry(key) {
+        let entry = this.entries.get(key);
+        if (entry === undefined) {
+            if (this.entries.size >= MAX_CACHED_QUERIES) {
+                const evictable = [...this.entries].find(([, candidate]) => candidate.listeners.size === 0);
+                if (evictable === undefined)
+                    throw new Error("Runku query cache limit reached");
+                this.entries.delete(evictable[0]);
+            }
+            entry = { snapshot: PENDING, listeners: new Set(), subscription: null };
+            this.entries.set(key, entry);
+        }
+        return entry;
+    }
+    listen(key, reference, argumentsValue, options, listener) {
+        const entry = this.entry(key);
+        entry.listeners.add(listener);
+        if (entry.subscription === null) {
+            entry.subscription = this.realtime().subscribe(reference, argumentsValue, {
+                ...options,
+                onValue: (state) => {
+                    entry.snapshot = Object.freeze({
+                        status: "success",
+                        data: state.value,
+                        error: null,
+                        releaseId: state.releaseId,
+                        snapshotSequence: state.snapshotSequence,
+                        isStale: false,
+                    });
+                    this.emit(entry);
+                },
+                onError: (error) => {
+                    entry.snapshot = Object.freeze({
+                        ...entry.snapshot,
+                        status: "error",
+                        error,
+                        isStale: true,
+                    });
+                    this.emit(entry);
+                },
+            });
+            void entry.subscription.ready.catch(() => undefined);
+        }
+        return () => {
+            entry.listeners.delete(listener);
+            if (entry.listeners.size === 0 && entry.subscription !== null) {
+                const subscription = entry.subscription;
+                entry.subscription = null;
+                void subscription.unsubscribe();
+            }
+        };
+    }
+    async refetch(key, reference, argumentsValue, options) {
+        const result = await this.client.query(reference, argumentsValue, options);
+        const entry = this.entry(key);
+        if (result.metadata.kind !== "query")
+            throw new TypeError("Runku returned non-query metadata");
+        entry.snapshot = Object.freeze({
+            status: "success",
+            data: result.value,
+            error: null,
+            releaseId: result.releaseId,
+            snapshotSequence: result.metadata.snapshotSequence,
+            isStale: false,
+        });
+        this.emit(entry);
+        return result;
+    }
+    close() {
+        const realtime = this.#realtime;
+        this.#realtime = null;
+        realtime?.close();
+        for (const entry of this.entries.values()) {
+            entry.subscription = null;
+            entry.listeners.clear();
+        }
+    }
+    realtime() {
+        this.#realtime ??= this.client.realtime();
+        return this.#realtime;
+    }
+    emit(entry) {
+        for (const listener of entry.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,YAAY,GAEb,MAAM,aAAa,CAAC;AAmBrB,MAAM,OAAO,GAA2B,MAAM,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,IAAI;IACX,SAAS,EAAE,IAAI;IACf,gBAAgB,EAAE,IAAI;IACtB,OAAO,EAAE,KAAK;CACf,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,gGAAgG;AAChG,MAAM,OAAO,UAAU;IACZ,MAAM,CAAc;IACpB,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACjD,SAAS,GAA+B,IAAI,CAAC;IAE7C,YAAY,MAAmB,EAAE,WAAmB,EAAE,KAAkC;QACtF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QACnF,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;gBAC7D,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;gBAC9C,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;YAC7E,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;wBACtB,MAAM,EAAE,SAAS;wBACjB,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC;wBACzB,KAAK,EAAE,IAAI;wBACX,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;wBACjC,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,gBAAgB,KAAK,IAAI;4BACtD,CAAC,CAAC,IAAI;4BACN,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC;wBACzC,OAAO,EAAE,IAAI;qBACd,CAAC;oBACF,SAAS,EAAE,IAAI,GAAG,EAAE;oBACpB,YAAY,EAAE,IAAI;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAW;QACf,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,kBAAkB,EAAE,CAAC;gBAC5C,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;gBAC5F,IAAI,SAAS,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBAChF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,CAAC;YACD,KAAK,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACxE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CACJ,GAAW,EACX,SAAgE,EAChE,cAAiB,EACjB,OAAoB,EACpB,QAAoB;QAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAChC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE;gBACxE,GAAG,OAAO;gBACV,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBACjB,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;wBAC7B,MAAM,EAAE,SAAS;wBACjB,IAAI,EAAE,KAAK,CAAC,KAAK;wBACjB,KAAK,EAAE,IAAI;wBACX,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;wBACxC,OAAO,EAAE,KAAK;qBACf,CAAC,CAAC;oBACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,CAAC;gBACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBACjB,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;wBAC7B,GAAG,KAAK,CAAC,QAAQ;wBACjB,MAAM,EAAE,OAAO;wBACf,KAAK;wBACL,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;oBACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,CAAC;aACF,CAAC,CAAC;YACH,KAAK,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC9D,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;gBACxC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC1B,KAAK,YAAY,CAAC,WAAW,EAAE,CAAC;YAClC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,GAAW,EACX,SAAgE,EAChE,cAAiB,EACjB,OAAoB;QAEpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;YAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC/F,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,MAAM,CAAC,KAAK;YAClB,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,gBAAgB,EAAE,MAAM,CAAC,QAAQ,CAAC,gBAAgB;YAClD,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;YAC1B,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,IAAI,CAAC,KAAiB;QAC5B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;IACrD,CAAC;CACF"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@runku/react",
+  "version": "0.4.8",
+  "description": "React and Next.js bindings for the Runku TypeScript client",
+  "type": "module",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/aldemi-tech/runku/tree/main/packages/react#readme",
+  "bugs": {
+    "url": "https://github.com/aldemi-tech/runku/issues"
+  },
+  "keywords": ["runku", "react", "nextjs", "typescript", "realtime"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aldemi-tech/runku.git",
+    "directory": "packages/react"
+  },
+  "sideEffects": false,
+  "files": ["dist", "README.md", "LICENSE"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "engines": { "node": ">=20" },
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" },
+  "peerDependencies": {
+    "@runku/client": "0.4.8",
+    "react": ">=18.3.0 <20"
+  },
+  "devDependencies": {
+    "@runku/client": "workspace:*",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "typescript": "7.0.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.check.json",
+    "lint": "tsc -p tsconfig.check.json",
+    "test": "pnpm build && node --test tests/*.test.mjs",
+    "check": "pnpm typecheck && pnpm lint && pnpm test"
+  }
+}