@openora/core 0.4.0

package/dist/pam/tag/service/tag.service.js

@@ -0,0 +1,167 @@
+import { makeNotFoundError, pageToOffset, alreadyInUseError, } from '@openora/core/server';
+import { and, asc, count, eq, inArray, isNull, notInArray } from 'drizzle-orm';
+import { player } from '@openora/core/pam/schema/profile';
+import { playerTag, tag } from '../schema/index.js';
+import { mapDbError } from '@openora/core/common/errors';
+import { toTag, toPlayerTagWithTag } from './tag-mappers.js';
+export const TagNotFoundError = makeNotFoundError('Tag');
+export const TagAlreadyInUseError = alreadyInUseError('Tag');
+export const TagAssignmentNotFoundError = makeNotFoundError('Tag Assignment');
+export class TagService {
+    drizzle;
+    event;
+    constructor(drizzle, event) {
+        this.drizzle = drizzle;
+        this.event = event;
+    }
+    // Keyed by auth `userId`, not the internal `player.id`. Users with no active tags are absent from the map.
+    async getActiveTagKeys(userIds) {
+        const result = new Map();
+        if (userIds.length === 0)
+            return result;
+        const rows = await this.drizzle.db
+            .select({ userId: player.userId, key: tag.key })
+            .from(player)
+            .innerJoin(playerTag, and(eq(playerTag.playerId, player.id), isNull(playerTag.removedAt)))
+            .innerJoin(tag, eq(tag.id, playerTag.tagId))
+            .where(inArray(player.userId, [...userIds]));
+        for (const row of rows) {
+            const keys = result.get(row.userId) ?? [];
+            keys.push(row.key);
+            result.set(row.userId, keys);
+        }
+        return result;
+    }
+    async _findTagByKeyOrThrow(tagKey, trx) {
+        const results = await trx.select().from(tag).where(eq(tag.key, tagKey)).limit(1);
+        if (!results.length) {
+            throw new TagNotFoundError(tagKey);
+        }
+        return toTag(results[0]);
+    }
+    async createTag(args) {
+        try {
+            const db = this.drizzle.db;
+            const [created] = await db.insert(tag).values(args).returning();
+            return toTag(created);
+        }
+        catch (e) {
+            mapDbError(e);
+        }
+    }
+    async deleteTag(args) {
+        try {
+            const db = this.drizzle.db;
+            await db.delete(tag).where(eq(tag.key, args.key));
+            return true;
+        }
+        catch (e) {
+            mapDbError(e);
+        }
+    }
+    async listPlayerTags(playerId, page, limit) {
+        const where = and(eq(playerTag.playerId, playerId), isNull(playerTag.removedAt));
+        const db = this.drizzle.db;
+        const [rows, [{ n }]] = await Promise.all([
+            db
+                .select({
+                pt: playerTag,
+                tagKey: tag.key,
+            })
+                .from(playerTag)
+                .innerJoin(tag, eq(playerTag.tagId, tag.id))
+                .where(where)
+                .limit(limit)
+                .offset(pageToOffset(page, limit)),
+            db.select({ n: count() }).from(playerTag).where(where),
+        ]);
+        return {
+            items: rows.map((r) => toPlayerTagWithTag(r.pt, r.tagKey)),
+            total: Number(n),
+            page,
+            limit,
+        };
+    }
+    async listAssignableTags(playerId) {
+        const db = this.drizzle.db;
+        const rows = await db
+            .select()
+            .from(tag)
+            .where(notInArray(tag.id, db
+            .select({ tagId: playerTag.tagId })
+            .from(playerTag)
+            .where(and(eq(playerTag.playerId, playerId), isNull(playerTag.removedAt)))))
+            .orderBy(asc(tag.key));
+        return rows.map(toTag);
+    }
+    async assignPlayerTag(args) {
+        try {
+            const { tagKey, ...restArgs } = args;
+            const db = this.drizzle.db;
+            const result = await db.transaction(async (trx) => {
+                const foundTag = await this._findTagByKeyOrThrow(tagKey, trx);
+                const [existing] = await trx
+                    .select()
+                    .from(playerTag)
+                    .where(and(eq(playerTag.tagId, foundTag.id), eq(playerTag.playerId, args.playerId), isNull(playerTag.removedAt)))
+                    .limit(1);
+                if (existing) {
+                    throw new TagAlreadyInUseError();
+                }
+                const [created] = await trx
+                    .insert(playerTag)
+                    .values({ ...restArgs, tagId: foundTag.id })
+                    .returning();
+                return toPlayerTagWithTag(created, foundTag.key);
+            });
+            void this.event.emit('tag.player.assigned', {
+                playerId: args.playerId,
+                tagKey: args.tagKey,
+                reason: args.assignReason,
+                actorId: args.assignActorUserId,
+            });
+            return result;
+        }
+        catch (e) {
+            mapDbError(e);
+        }
+    }
+    async removePlayerTag(args) {
+        try {
+            const db = this.drizzle.db;
+            const result = await db.transaction(async (trx) => {
+                const foundTag = await this._findTagByKeyOrThrow(args.tagKey, trx);
+                const [active] = await trx
+                    .select()
+                    .from(playerTag)
+                    .where(and(eq(playerTag.tagId, foundTag.id), eq(playerTag.playerId, args.playerId), isNull(playerTag.removedAt)))
+                    .limit(1);
+                if (!active) {
+                    throw new TagAssignmentNotFoundError(args.playerId);
+                }
+                const [updated] = await trx
+                    .update(playerTag)
+                    .set({
+                    removedAt: new Date(),
+                    removalReason: args.removalReason,
+                    removalActor: args.removalActor,
+                    removalActorUserId: args.removalActorUserId,
+                })
+                    .where(eq(playerTag.id, active.id))
+                    .returning();
+                return toPlayerTagWithTag(updated, foundTag.key);
+            });
+            void this.event.emit('tag.player.removed', {
+                playerId: args.playerId,
+                tagKey: args.tagKey,
+                reason: args.removalReason,
+                actorId: args.removalActorUserId,
+            });
+            return result;
+        }
+        catch (e) {
+            mapDbError(e);
+        }
+    }
+}
+//# sourceMappingURL=tag.service.js.map

package/dist/pam/tag/service/tag.service.js.map

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

package/dist/react/client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Framework-agnostic typed client factory for the OSS platform.
+ *
+ * Wraps `@orpc/openapi-client` against a contract the CALLER supplies. The
+ * platform is headless and modular: each consumer (or each `@openora/<domain>/react`
+ * package) composes exactly the contract slices its edition enables and passes
+ * it here - the SDK never aggregates domains itself (the no-core-to-domain
+ * boundary). Returns a client whose method-and-argument types are inferred from
+ * each route's Zod input/output schemas - no manual `client.get` strings.
+ *
+ * ```ts
+ * import { createClient } from '@openora/core/react';
+ * import { composeContract } from '../contracts/orpc/index.js';
+ * import { gamingContract } from '@openora/core/casino/contracts/gaming';
+ *
+ * const contract = composeContract({ gaming: gamingContract });
+ * const client = createClient(contract, { baseUrl: 'http://localhost:3001' });
+ * const games = await client.gaming.listGames();
+ * ```
+ *
+ * Cookies are forwarded by default (`credentials: 'include'`), matching the
+ * platform's cookie-based auth. Override `fetch` to customize.
+ */
+import type { AnyContractRouter, ContractRouterClient } from '@orpc/contract';
+import type { JsonifiedClient } from '@orpc/openapi-client';
+export type OssClient<TContract extends AnyContractRouter> = JsonifiedClient<ContractRouterClient<TContract>>;
+export type CreateClientOptions = {
+    /** Base URL of the API (eg `http://localhost:3001`). No trailing slash. */
+    baseUrl: string;
+    /** Extra headers applied to every request. May return a Promise. */
+    headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** Override `fetch`. Default forwards cookies via `credentials: 'include'`. */
+    fetch?: typeof globalThis.fetch;
+};
+export declare function createClient<TContract extends AnyContractRouter>(contract: TContract, options: CreateClientOptions): OssClient<TContract>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/react/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,MAAM,MAAM,SAAS,CAAC,SAAS,SAAS,iBAAiB,IAAI,eAAe,CAC1E,oBAAoB,CAAC,SAAS,CAAC,CAChC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,CAAC;AAKF,wBAAgB,YAAY,CAAC,SAAS,SAAS,iBAAiB,EAC9D,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,mBAAmB,GAC3B,SAAS,CAAC,SAAS,CAAC,CAQtB"}

package/dist/react/client.js

@@ -0,0 +1,35 @@
+/**
+ * Framework-agnostic typed client factory for the OSS platform.
+ *
+ * Wraps `@orpc/openapi-client` against a contract the CALLER supplies. The
+ * platform is headless and modular: each consumer (or each `@openora/<domain>/react`
+ * package) composes exactly the contract slices its edition enables and passes
+ * it here - the SDK never aggregates domains itself (the no-core-to-domain
+ * boundary). Returns a client whose method-and-argument types are inferred from
+ * each route's Zod input/output schemas - no manual `client.get` strings.
+ *
+ * ```ts
+ * import { createClient } from '@openora/core/react';
+ * import { composeContract } from '../contracts/orpc/index.js';
+ * import { gamingContract } from '@openora/core/casino/contracts/gaming';
+ *
+ * const contract = composeContract({ gaming: gamingContract });
+ * const client = createClient(contract, { baseUrl: 'http://localhost:3001' });
+ * const games = await client.gaming.listGames();
+ * ```
+ *
+ * Cookies are forwarded by default (`credentials: 'include'`), matching the
+ * platform's cookie-based auth. Override `fetch` to customize.
+ */
+import { createORPCClient } from '@orpc/client';
+import { OpenAPILink } from '@orpc/openapi-client/fetch';
+const defaultFetch = (request, init) => globalThis.fetch(request, { ...init, credentials: 'include' });
+export function createClient(contract, options) {
+    const link = new OpenAPILink(contract, {
+        url: options.baseUrl,
+        fetch: options.fetch ?? defaultFetch,
+        ...(options.headers ? { headers: options.headers } : {}),
+    });
+    return createORPCClient(link);
+}
+//# sourceMappingURL=client.js.map

package/dist/react/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/react/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAezD,MAAM,YAAY,GAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAC9D,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;AAEjE,MAAM,UAAU,YAAY,CAC1B,QAAmB,EACnB,OAA4B;IAE5B,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE;QACrC,GAAG,EAAE,OAAO,CAAC,OAAO;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY;QACpC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC,IAAI,CAAyB,CAAC;AACxD,CAAC"}

package/dist/react/context/api-client.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from 'react';
+export type QueryValue = string | number | boolean | undefined | null;
+export type QueryParams = Record<string, QueryValue>;
+export type OssApiClient = {
+    baseUrl: string;
+    get: <T = unknown>(path: string, query?: QueryParams) => Promise<T>;
+    post: <T = unknown>(path: string, body?: unknown) => Promise<T>;
+    patch: <T = unknown>(path: string, body?: unknown) => Promise<T>;
+    delete: <T = unknown>(path: string) => Promise<T>;
+};
+export type OssApiClientConfig = {
+    baseUrl: string;
+};
+export declare function ApiClientProvider({ client, children, }: {
+    client: OssApiClient | OssApiClientConfig;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useApiClient(): OssApiClient;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/react/context/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../src/react/context/api-client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAqDF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAC1C,QAAQ,EAAE,SAAS,CAAC;CACrB,+BAGA;AAED,wBAAgB,YAAY,IAAI,YAAY,CAI3C"}

package/dist/react/context/api-client.js

@@ -0,0 +1,63 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+const ApiClientContext = createContext(null);
+function buildQueryString(query) {
+    if (!query)
+        return '';
+    const entries = Object.entries(query).filter(([, v]) => v !== undefined && v !== null && v !== '');
+    if (entries.length === 0)
+        return '';
+    const params = new URLSearchParams();
+    for (const [k, v] of entries)
+        params.set(k, String(v));
+    return `?${params.toString()}`;
+}
+function buildClient(config) {
+    if ('get' in config && 'post' in config && 'patch' in config)
+        return config;
+    const baseUrl = config.baseUrl;
+    const send = async (method, path, body) => {
+        const init = { method, credentials: 'include' };
+        if (body !== undefined) {
+            init.headers = { 'content-type': 'application/json' };
+            init.body = JSON.stringify(body);
+        }
+        const res = await fetch(`${baseUrl}${path}`, init);
+        if (!res.ok) {
+            // Surface the server's error message (eg the lockout notice) when present. Consumers
+            // needing structured status/data use the typed oRPC client (createClient), not this.
+            let message = `${method} ${path} -> ${res.status}`;
+            try {
+                const errorBody = (await res.json());
+                if (errorBody?.message)
+                    message = errorBody.message;
+            }
+            catch {
+                /* non-JSON */
+            }
+            throw new Error(message);
+        }
+        if (res.status === 204)
+            return undefined;
+        return (await res.json());
+    };
+    return {
+        baseUrl,
+        get: (path, query) => send('GET', `${path}${buildQueryString(query)}`),
+        post: (path, body) => send('POST', path, body),
+        patch: (path, body) => send('PATCH', path, body),
+        delete: (path) => send('DELETE', path),
+    };
+}
+export function ApiClientProvider({ client, children, }) {
+    const value = useMemo(() => buildClient(client), [client]);
+    return _jsx(ApiClientContext.Provider, { value: value, children: children });
+}
+export function useApiClient() {
+    const ctx = useContext(ApiClientContext);
+    if (!ctx)
+        throw new Error('useApiClient must be used within ApiClientProvider');
+    return ctx;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/react/context/api-client.js.map

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

package/dist/react/context/realtime-client.d.ts

@@ -0,0 +1,18 @@
+import { type ReactNode } from 'react';
+export type RealtimeClientStatus = 'idle' | 'connecting' | 'open' | 'closed';
+export type RealtimeSubscribeHandlers<T> = {
+    onMessage: (event: T) => void;
+    onStatus?: (status: RealtimeClientStatus) => void;
+};
+export type RealtimeClientAdapter = {
+    /** Returns an unsubscribe fn the caller MUST invoke on teardown. */
+    subscribe<T>(channel: string, handlers: RealtimeSubscribeHandlers<T>): () => void;
+    close?(): void;
+};
+export declare function RealtimeClientProvider({ adapter, children, }: {
+    adapter: RealtimeClientAdapter;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Returns null when no provider is mounted; the chat hook falls back to built-in SSE. */
+export declare function useOptionalRealtimeClient(): RealtimeClientAdapter | null;
+//# sourceMappingURL=realtime-client.d.ts.map

package/dist/react/context/realtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-client.d.ts","sourceRoot":"","sources":["../../../src/react/context/realtime-client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAM7E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7E,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IACzC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAE9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,oEAAoE;IACpE,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAGlF,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB,CAAC;AAIF,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,SAAS,CAAC;CACrB,+BAKA;AAED,0FAA0F;AAC1F,wBAAgB,yBAAyB,IAAI,qBAAqB,GAAG,IAAI,CAExE"}

package/dist/react/context/realtime-client.js

@@ -0,0 +1,13 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect } from 'react';
+const RealtimeClientContext = createContext(null);
+export function RealtimeClientProvider({ adapter, children, }) {
+    useEffect(() => () => adapter.close?.(), [adapter]);
+    return (_jsx(RealtimeClientContext.Provider, { value: adapter, children: children }));
+}
+/** Returns null when no provider is mounted; the chat hook falls back to built-in SSE. */
+export function useOptionalRealtimeClient() {
+    return useContext(RealtimeClientContext);
+}
+//# sourceMappingURL=realtime-client.js.map

package/dist/react/context/realtime-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-client.js","sourceRoot":"","sources":["../../../src/react/context/realtime-client.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAsB7E,MAAM,qBAAqB,GAAG,aAAa,CAA+B,IAAI,CAAC,CAAC;AAEhF,MAAM,UAAU,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,GAIT;IACC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YAAG,QAAQ,GAAkC,CAC5F,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB;IACvC,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC"}

package/dist/react/hooks/use-event-stream.d.ts

@@ -0,0 +1,22 @@
+export type EventStreamStatus = 'idle' | 'connecting' | 'open' | 'closed';
+export type UseEventStreamOptions<T> = {
+    /** When false, the stream is not opened (and an open one is torn down). */
+    enabled?: boolean;
+    /** Called for each event as it arrives, before state updates. */
+    onEvent?: (event: T) => void;
+};
+export type UseEventStreamResult<T> = {
+    last: T | null;
+    status: EventStreamStatus;
+};
+/**
+ * Generic client-side real-time transport. Consumes any async-iterable source
+ * (eg an oRPC event iterator served as SSE: `client.x.stream(undefined, { signal })`).
+ *
+ * Owns an AbortController per active subscription, loops `for await` over the
+ * iterable, calls `onEvent` and tracks the latest value + connection status,
+ * and aborts on unmount or when `enabled` flips false. Re-subscribes when
+ * `subscribe` identity changes, so memoize it at the call site.
+ */
+export declare function useEventStream<T>(subscribe: (signal: AbortSignal) => Promise<AsyncIterable<T>>, options?: UseEventStreamOptions<T>): UseEventStreamResult<T>;
+//# sourceMappingURL=use-event-stream.d.ts.map

package/dist/react/hooks/use-event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-stream.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-event-stream.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAC7D,OAAO,GAAE,qBAAqB,CAAC,CAAC,CAAM,GACrC,oBAAoB,CAAC,CAAC,CAAC,CA8CzB"}

package/dist/react/hooks/use-event-stream.js

@@ -0,0 +1,58 @@
+'use client';
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Generic client-side real-time transport. Consumes any async-iterable source
+ * (eg an oRPC event iterator served as SSE: `client.x.stream(undefined, { signal })`).
+ *
+ * Owns an AbortController per active subscription, loops `for await` over the
+ * iterable, calls `onEvent` and tracks the latest value + connection status,
+ * and aborts on unmount or when `enabled` flips false. Re-subscribes when
+ * `subscribe` identity changes, so memoize it at the call site.
+ */
+export function useEventStream(subscribe, options = {}) {
+    const { enabled = true, onEvent } = options;
+    const [last, setLast] = useState(null);
+    const [status, setStatus] = useState('idle');
+    // Keep the latest onEvent without forcing a re-subscribe each render.
+    const onEventRef = useRef(onEvent);
+    onEventRef.current = onEvent;
+    useEffect(() => {
+        if (!enabled) {
+            setStatus('idle');
+            return;
+        }
+        const controller = new AbortController();
+        let cancelled = false;
+        setStatus('connecting');
+        (async () => {
+            try {
+                const iterable = await subscribe(controller.signal);
+                if (cancelled)
+                    return;
+                setStatus('open');
+                for await (const event of iterable) {
+                    if (cancelled)
+                        break;
+                    onEventRef.current?.(event);
+                    setLast(event);
+                }
+            }
+            catch (err) {
+                // An AbortError on unmount/disable is expected teardown - swallow it.
+                if (!cancelled && err?.name !== 'AbortError') {
+                    // Stream closed; status is updated in finally.
+                }
+            }
+            finally {
+                if (!cancelled)
+                    setStatus('closed');
+            }
+        })();
+        return () => {
+            cancelled = true;
+            controller.abort();
+        };
+    }, [subscribe, enabled]);
+    return { last, status };
+}
+//# sourceMappingURL=use-event-stream.js.map

package/dist/react/hooks/use-event-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-stream.js","sourceRoot":"","sources":["../../../src/react/hooks/use-event-stream.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAgBpD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,SAA6D,EAC7D,UAAoC,EAAE;IAEtC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAoB,MAAM,CAAC,CAAC;IAEhE,sEAAsE;IACtE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,SAAS,CAAC,YAAY,CAAC,CAAC;QAExB,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAI,SAAS;oBAAE,OAAO;gBACtB,SAAS,CAAC,MAAM,CAAC,CAAC;gBAClB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;oBACnC,IAAI,SAAS;wBAAE,MAAM;oBACrB,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;oBAC5B,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,sEAAsE;gBACtE,IAAI,CAAC,SAAS,IAAK,GAAa,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;oBACxD,+CAA+C;gBACjD,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS;oBAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC"}

package/dist/react/hooks/use-orpc-client.d.ts

@@ -0,0 +1,5 @@
+import type { AnyContractRouter } from '@orpc/contract';
+import { type OssClient } from '../client.js';
+/** Returns a typed oRPC client memoized per `baseUrl` + `contract` - pass the slice your domain needs. */
+export declare function useOrpcClient<TContract extends AnyContractRouter>(contract: TContract): OssClient<TContract>;
+//# sourceMappingURL=use-orpc-client.d.ts.map

package/dist/react/hooks/use-orpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-orpc-client.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-orpc-client.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5D,0GAA0G;AAC1G,wBAAgB,aAAa,CAAC,SAAS,SAAS,iBAAiB,EAC/D,QAAQ,EAAE,SAAS,GAClB,SAAS,CAAC,SAAS,CAAC,CAGtB"}

package/dist/react/hooks/use-orpc-client.js

@@ -0,0 +1,10 @@
+'use client';
+import { useMemo } from 'react';
+import { useApiClient } from '../context/api-client.js';
+import { createClient } from '../client.js';
+/** Returns a typed oRPC client memoized per `baseUrl` + `contract` - pass the slice your domain needs. */
+export function useOrpcClient(contract) {
+    const { baseUrl } = useApiClient();
+    return useMemo(() => createClient(contract, { baseUrl }), [baseUrl, contract]);
+}
+//# sourceMappingURL=use-orpc-client.js.map

package/dist/react/hooks/use-orpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-orpc-client.js","sourceRoot":"","sources":["../../../src/react/hooks/use-orpc-client.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAkB,MAAM,cAAc,CAAC;AAE5D,0GAA0G;AAC1G,MAAM,UAAU,aAAa,CAC3B,QAAmB;IAEnB,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;IACnC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/react/hooks/use-orpc-query.d.ts

@@ -0,0 +1,6 @@
+import type { AnyContractRouter } from '@orpc/contract';
+/**
+ * Contract-generic react-query utils (queryOptions/mutationOptions/key) over the typed oRPC client.
+ * */
+export declare function useOrpcQueryUtils<TContract extends AnyContractRouter>(contract: TContract): import("@orpc/tanstack-query").RouterUtils<import("@orpc/openapi-client").JsonifiedClient<import("@orpc/contract").ContractRouterClient<TContract, Record<never, never>>>>;
+//# sourceMappingURL=use-orpc-query.d.ts.map

package/dist/react/hooks/use-orpc-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-orpc-query.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-orpc-query.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;KAEK;AACL,wBAAgB,iBAAiB,CAAC,SAAS,SAAS,iBAAiB,EAAE,QAAQ,EAAE,SAAS,8KAGzF"}

package/dist/react/hooks/use-orpc-query.js

@@ -0,0 +1,11 @@
+import { useMemo } from 'react';
+import { createTanstackQueryUtils } from '@orpc/tanstack-query';
+import { useOrpcClient } from './use-orpc-client.js';
+/**
+ * Contract-generic react-query utils (queryOptions/mutationOptions/key) over the typed oRPC client.
+ * */
+export function useOrpcQueryUtils(contract) {
+    const client = useOrpcClient(contract);
+    return useMemo(() => createTanstackQueryUtils(client), [client]);
+}
+//# sourceMappingURL=use-orpc-query.js.map

package/dist/react/hooks/use-orpc-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-orpc-query.js","sourceRoot":"","sources":["../../../src/react/hooks/use-orpc-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;KAEK;AACL,MAAM,UAAU,iBAAiB,CAAsC,QAAmB;IACxF,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/react/hooks/use-paginated-list.d.ts

@@ -0,0 +1,19 @@
+export type PaginatedListState<T> = {
+    items: T[];
+    total: number;
+    page: number;
+    setPage: (page: number) => void;
+    search: string;
+    setSearch: (search: string) => void;
+    isLoading: boolean;
+    totalPages: number;
+};
+export declare function usePaginatedList<T>(opts: {
+    queryKey: unknown[];
+    queryFn: (page: number, search: string) => Promise<{
+        items: T[];
+        total: number;
+    }>;
+    pageSize?: number;
+}): PaginatedListState<T>;
+//# sourceMappingURL=use-paginated-list.d.ts.map

package/dist/react/hooks/use-paginated-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paginated-list.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-paginated-list.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE;IACxC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,kBAAkB,CAAC,CAAC,CAAC,CA4BxB"}

package/dist/react/hooks/use-paginated-list.js

@@ -0,0 +1,30 @@
+'use client';
+import { useState } from 'react';
+import { useQuery, keepPreviousData } from '@tanstack/react-query';
+const DEFAULT_PAGE_SIZE = 20;
+export function usePaginatedList(opts) {
+    const { queryKey, queryFn, pageSize = DEFAULT_PAGE_SIZE } = opts;
+    const [page, setPage] = useState(1);
+    const [search, setSearch] = useState('');
+    const { data, isLoading } = useQuery({
+        queryKey: [...queryKey, { page, search }],
+        queryFn: () => queryFn(page, search),
+        placeholderData: keepPreviousData,
+    });
+    const total = data?.total ?? 0;
+    function handleSetSearch(s) {
+        setSearch(s);
+        setPage(1);
+    }
+    return {
+        items: data?.items ?? [],
+        total,
+        page,
+        setPage,
+        search,
+        setSearch: handleSetSearch,
+        isLoading,
+        totalPages: Math.max(1, Math.ceil(total / pageSize)),
+    };
+}
+//# sourceMappingURL=use-paginated-list.js.map

package/dist/react/hooks/use-paginated-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paginated-list.js","sourceRoot":"","sources":["../../../src/react/hooks/use-paginated-list.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAa7B,MAAM,UAAU,gBAAgB,CAAI,IAInC;IACC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACjE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEzC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;QACnC,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACzC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QACpC,eAAe,EAAE,gBAAgB;KAClC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;IAE/B,SAAS,eAAe,CAAC,CAAS;QAChC,SAAS,CAAC,CAAC,CAAC,CAAC;QACb,OAAO,CAAC,CAAC,CAAC,CAAC;IACb,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;QACxB,KAAK;QACL,IAAI;QACJ,OAAO;QACP,MAAM;QACN,SAAS,EAAE,eAAe;QAC1B,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,8 @@
+export { createClient, type OssClient, type CreateClientOptions } from './client.js';
+export { ApiClientProvider, useApiClient } from './context/api-client.js';
+export { useOrpcClient } from './hooks/use-orpc-client.js';
+export { useOrpcQueryUtils } from './hooks/use-orpc-query.js';
+export { usePaginatedList, type PaginatedListState } from './hooks/use-paginated-list.js';
+export { useEventStream, type EventStreamStatus, type UseEventStreamOptions, type UseEventStreamResult, } from './hooks/use-event-stream.js';
+export { RealtimeClientProvider, useOptionalRealtimeClient, type RealtimeClientAdapter, type RealtimeClientStatus, type RealtimeSubscribeHandlers, } from './context/realtime-client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,8 @@
+export { createClient } from './client.js';
+export { ApiClientProvider, useApiClient } from './context/api-client.js';
+export { useOrpcClient } from './hooks/use-orpc-client.js';
+export { useOrpcQueryUtils } from './hooks/use-orpc-query.js';
+export { usePaginatedList } from './hooks/use-paginated-list.js';
+export { useEventStream, } from './hooks/use-event-stream.js';
+export { RealtimeClientProvider, useOptionalRealtimeClient, } from './context/realtime-client.js';
+//# sourceMappingURL=index.js.map