@weaveprotocol/core 0.1.0

package/dist/query/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * @module query/types
+ * A query is plain data: an object you could write by hand, send over a wire,
+ * or have an agent produce. No parser, no language — filters borrow Mongo's
+ * operators, relationships borrow the `include` map that Prisma, Mongoose and
+ * Rails all use, and anything that serialises keeps working the day a daemon
+ * answers queries instead of the tab.
+ */
+import type { NodeRecord } from '../node/types.js';
+/** Predicates on one field. Absent operators do not constrain. */
+export interface Operators {
+    readonly $eq?: unknown;
+    /** True for a missing field too — the one everybody gets wrong */
+    readonly $ne?: unknown;
+    readonly $gt?: number | string;
+    readonly $gte?: number | string;
+    readonly $lt?: number | string;
+    readonly $lte?: number | string;
+    readonly $in?: ReadonlyArray<unknown>;
+    readonly $nin?: ReadonlyArray<unknown>;
+    readonly $exists?: boolean;
+    /** Case-insensitive substring of a text field, or an element of a list. Not search. */
+    readonly $contains?: unknown;
+}
+/**
+ * Field predicates, all of which must hold.
+ *
+ * A bare name is a field of the record's body — `done`, `address.city`. A
+ * name starting with `@` is about the record itself: `@key`, `@author`,
+ * `@root`, `@createdBy`, `@createdAt`, `@updatedAt`, `@seq`.
+ */
+export type Filter = {
+    readonly [field: string]: unknown;
+} & {
+    readonly $and?: ReadonlyArray<Filter>;
+    readonly $or?: ReadonlyArray<Filter>;
+    readonly $not?: Filter;
+};
+/**
+ * A collection, by name or by a reference that also carries its records'
+ * type: a definition whose schema is a validator (a Zod object), a standard
+ * one from `@weaveprotocol/core/schemas`, or a {@link Typed} name. Before a query
+ * runs, every reference becomes its name — the query stays plain data.
+ */
+export type CollectionRef = string | {
+    readonly name: string;
+};
+/**
+ * A collection name that carries its records' type, for collections whose
+ * schema is plain JSON Schema: `const todos: Typed<Todo> = { name: 'app.todo' }`.
+ * The type is a promise you make, not something checked when reading.
+ */
+export interface Typed<T> {
+    readonly name: string;
+    readonly '~body'?: T;
+}
+/** A validator's output type, when it declares one (Standard Schema) */
+type OutputOf<S> = S extends {
+    readonly '~standard': {
+        readonly types?: infer Types;
+    };
+} ? NonNullable<Types> extends {
+    readonly output: infer O;
+} ? O : unknown : unknown;
+/**
+ * The body type of a collection reference: declared with {@link Typed}, or
+ * the output of its definition's validator. `unknown` for a bare name.
+ */
+export type BodyOf<C> = C extends {
+    readonly '~body'?: infer T;
+} ? (unknown extends T ? FromSchema<C> : T) : FromSchema<C>;
+type FromSchema<C> = C extends {
+    readonly schema: infer S;
+} ? OutputOf<S> : unknown;
+/**
+ * What an `include` map finds for each record, typed from the query. A map
+ * only known as "some includes" (a query built at run time) gives the loose
+ * {@link AnyIncluded}.
+ */
+export type IncludedOf<I> = [I] extends [undefined] ? {} : string extends keyof NonNullable<I> ? AnyIncluded : {
+    readonly [K in keyof NonNullable<I>]: NonNullable<I>[K] extends {
+        readonly count: true;
+    } ? number : ReadonlyArray<QueryRecord<BodyOf<NonNullable<I>[K] extends {
+        readonly from?: infer F;
+    } ? F : never>, IncludedOf<NonNullable<I>[K] extends {
+        readonly include?: infer J;
+    } ? J : undefined>>>;
+};
+/** What to pull in alongside each record, by following links. */
+export interface Include {
+    /** The link role: 'about', 'replyTo' */
+    readonly rel: string;
+    /** Only records in this collection — by name, or a reference that carries its type */
+    readonly from?: CollectionRef;
+    /** `in` (default): records linking *to* this one. `out`: records this one links to. */
+    readonly direction?: 'in' | 'out';
+    readonly where?: Filter;
+    readonly include?: Readonly<Record<string, Include>>;
+    readonly limit?: number;
+    /** Just the number of them — the usual thing for reactions and votes */
+    readonly count?: boolean;
+}
+export type SortDirection = 'asc' | 'desc';
+export interface Query {
+    /** By name, or a reference that carries its records' type (see {@link CollectionRef}) */
+    readonly collection: CollectionRef;
+    readonly where?: Filter;
+    readonly include?: Readonly<Record<string, Include>>;
+    /** Fields to sort by, in order: `{ done: 'asc', '@createdAt': 'desc' }`. Ties always break on the key. */
+    readonly sort?: Readonly<Record<string, SortDirection>>;
+    readonly limit?: number;
+    /** From the previous page's `cursor` */
+    readonly cursor?: string;
+}
+/** What an untyped query's `include` finds */
+export type AnyIncluded = Readonly<Record<string, ReadonlyArray<QueryRecord> | number>>;
+/**
+ * A record a query found. Queries only return records this device can read,
+ * so `body` is never null here.
+ */
+export interface QueryRecord<T = unknown, I = AnyIncluded> extends Omit<NodeRecord<T>, 'body'> {
+    readonly body: T;
+    /** What each `include` found: records, or a number when it asked for a count. Empty without `include`. */
+    readonly included: I;
+}
+export interface QueryResult<T = unknown, I = AnyIncluded> {
+    readonly records: ReadonlyArray<QueryRecord<T, I>>;
+    /** Pass back as `cursor` for the next page; null when there is none */
+    readonly cursor: string | null;
+}
+/** The result a query gives, typed from the query itself */
+export type ResultOf<Q extends Query> = QueryResult<BodyOf<Q['collection']>, Q extends {
+    readonly include: infer I;
+} ? IncludedOf<I> : 'include' extends keyof Q ? AnyIncluded : {}>;
+/** The name a collection reference stands for */
+export declare const nameOf: (ref: CollectionRef) => string;
+/**
+ * The query as plain data: every collection reference replaced by its name.
+ * What runs, what is sent to an agent, and what is compared, is this.
+ * Anything malformed is passed through untouched, for the checker to explain.
+ */
+export declare function plainQuery(query: Query): Query;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/query/types.d.ts.map

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

package/dist/query/types.js

@@ -0,0 +1,22 @@
+/** The name a collection reference stands for */
+export const nameOf = (ref) => (typeof ref === 'object' && ref !== null && typeof ref.name === 'string' ? ref.name : ref);
+/**
+ * The query as plain data: every collection reference replaced by its name.
+ * What runs, what is sent to an agent, and what is compared, is this.
+ * Anything malformed is passed through untouched, for the checker to explain.
+ */
+export function plainQuery(query) {
+    const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+    const includes = (map) => isObject(map)
+        ? Object.fromEntries(Object.entries(map).map(([name, inc]) => [
+            name,
+            isObject(inc)
+                ? { ...inc, ...(inc.from !== undefined ? { from: nameOf(inc.from) } : {}), ...(inc.include !== undefined ? { include: includes(inc.include) } : {}) }
+                : inc,
+        ]))
+        : map;
+    if (!isObject(query))
+        return query;
+    return { ...query, collection: nameOf(query.collection), ...(query.include !== undefined ? { include: includes(query.include) } : {}) };
+}
+//# sourceMappingURL=types.js.map

package/dist/query/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAmJA,iDAAiD;AACjD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAkB,EAAU,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,GAAc,CAAC,CAAC;AAE7J;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAgC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACxH,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAW,EAAE,CACzC,QAAQ,CAAC,GAAG,CAAC;QACX,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI;YACJ,QAAQ,CAAC,GAAG,CAAC;gBACX,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBACtK,CAAC,CAAC,GAAG;SACR,CAAC,CACH;QACH,CAAC,CAAC,GAAG,CAAC;IACV,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9J,CAAC"}

package/dist/react/context.d.ts

@@ -0,0 +1,81 @@
+import { type ReactElement, type ReactNode } from 'react';
+import type { AuthState, WeaveAuth, WeaveSession } from '../session/auth.js';
+import type { ConnectionState, WeaveConnection } from '../session/connection.js';
+import type { P2PNode } from '../node/types.js';
+export type WeaveProviderProps = {
+    readonly children?: ReactNode;
+} & (
+/** The account itself, signed in on this site — an account home */
+{
+    readonly auth: WeaveAuth;
+    readonly connection?: undefined;
+    readonly node?: undefined;
+}
+/** An app acting for an account through its home — `createWeaveConnection` */
+ | {
+    readonly connection: WeaveConnection;
+    readonly auth?: undefined;
+    readonly node?: undefined;
+}
+/** A node you started yourself */
+ | {
+    readonly node: P2PNode;
+    readonly auth?: undefined;
+    readonly connection?: undefined;
+});
+/**
+ * Makes Weave available to every component below it, so they ask for what
+ * they need — `useNode()`, `useQuery(space, …)` — instead of having it passed
+ * down.
+ *
+ * ```tsx
+ * <WeaveProvider connection={connection}>   // an app, through an account home
+ * <WeaveProvider auth={auth}>               // the home itself
+ * ```
+ */
+export declare function WeaveProvider(props: WeaveProviderProps): ReactElement;
+/** The sign-in flow from the nearest `WeaveProvider`, and its state — or nulls, for an app that connects instead. */
+export declare function useWeave(): {
+    auth: WeaveAuth | null;
+    state: AuthState | null;
+    session: WeaveSession | null;
+};
+/**
+ * The sign-in flow and its state, for screens that manage the account —
+ * `auth.signOut()`, `auth.addPasskey()`, `state.entry`.
+ * @throws Outside a `WeaveProvider` given `auth`
+ */
+export declare function useAuth(): {
+    auth: WeaveAuth;
+    state: AuthState;
+};
+/**
+ * Who is signed in: the account, its identity, and its node.
+ * @throws Outside a `WeaveProvider` given `auth`, or before sign-in
+ */
+export declare function useSession(): WeaveSession;
+/**
+ * An app's connection to its account home, and its state — for the connect
+ * button, and for "access ran out, connect again".
+ * @throws Outside a `WeaveProvider` given `connection`
+ */
+export declare function useConnection(): {
+    connection: WeaveConnection;
+    state: ConnectionState;
+};
+/**
+ * The account this page acts for — signed in here, or connected through a
+ * home: its identity (what `root` and `createdBy` on a record name) and name.
+ * @throws Before sign-in or connecting
+ */
+export declare function useAccount(): {
+    did: string;
+    name: string;
+};
+/**
+ * The node acting for the account. For components that only appear once
+ * someone is in.
+ * @throws Outside a `WeaveProvider`, or before sign-in or connecting
+ */
+export declare function useNode(): P2PNode;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/react/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6E,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACrI,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA4BhD,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;AACnE,mEAAmE;AACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE;AAC1F,8EAA8E;GAC5E;IAAE,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE;AAChG,kCAAkC;GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;CAAE,CACzF,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAOrE;AAED,qHAAqH;AACrH,wBAAgB,QAAQ,IAAI;IAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAI5G;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAI/D;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAIzC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI;IAAE,UAAU,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CASvF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAW1D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAIjC"}

package/dist/react/context.js

@@ -0,0 +1,95 @@
+import { createContext, createElement, useContext, useEffect, useSyncExternalStore } from 'react';
+const WeaveContext = createContext({ auth: null, connection: null, node: null });
+const nothing = () => null;
+const never = () => () => { };
+/** Follows a flow's or a connection's state, and starts it; null when there is none. */
+function useStore(store) {
+    useEffect(() => {
+        void store?.start();
+    }, [store]);
+    return useSyncExternalStore(store ? store.subscribe : never, store ? store.getState : nothing, store ? store.getState : nothing);
+}
+/**
+ * Makes Weave available to every component below it, so they ask for what
+ * they need — `useNode()`, `useQuery(space, …)` — instead of having it passed
+ * down.
+ *
+ * ```tsx
+ * <WeaveProvider connection={connection}>   // an app, through an account home
+ * <WeaveProvider auth={auth}>               // the home itself
+ * ```
+ */
+export function WeaveProvider(props) {
+    const auth = props.auth ?? null;
+    const connection = props.connection ?? null;
+    const authState = useStore(auth);
+    const connectionState = useStore(connection);
+    const node = props.node ?? authState?.session?.node ?? (connectionState?.status === 'ready' ? connectionState.node : null);
+    return createElement(WeaveContext.Provider, { value: { auth, connection, node } }, props.children);
+}
+/** The sign-in flow from the nearest `WeaveProvider`, and its state — or nulls, for an app that connects instead. */
+export function useWeave() {
+    const { auth } = useContext(WeaveContext);
+    const state = useSyncExternalStore(auth ? auth.subscribe : never, auth ? auth.getState : nothing, auth ? auth.getState : nothing);
+    return { auth, state, session: state?.session ?? null };
+}
+/**
+ * The sign-in flow and its state, for screens that manage the account —
+ * `auth.signOut()`, `auth.addPasskey()`, `state.entry`.
+ * @throws Outside a `WeaveProvider` given `auth`
+ */
+export function useAuth() {
+    const { auth, state } = useWeave();
+    if (!auth || !state)
+        throw new Error('useAuth needs a WeaveProvider with an auth flow above it.');
+    return { auth, state };
+}
+/**
+ * Who is signed in: the account, its identity, and its node.
+ * @throws Outside a `WeaveProvider` given `auth`, or before sign-in
+ */
+export function useSession() {
+    const { session } = useWeave();
+    if (!session)
+        throw new Error('useSession needs someone signed in.');
+    return session;
+}
+/**
+ * An app's connection to its account home, and its state — for the connect
+ * button, and for "access ran out, connect again".
+ * @throws Outside a `WeaveProvider` given `connection`
+ */
+export function useConnection() {
+    const { connection } = useContext(WeaveContext);
+    const state = useSyncExternalStore(connection ? connection.subscribe : never, connection ? connection.getState : nothing, connection ? connection.getState : nothing);
+    if (!connection || !state)
+        throw new Error('useConnection needs a WeaveProvider with a connection above it.');
+    return { connection, state };
+}
+/**
+ * The account this page acts for — signed in here, or connected through a
+ * home: its identity (what `root` and `createdBy` on a record name) and name.
+ * @throws Before sign-in or connecting
+ */
+export function useAccount() {
+    const { auth, connection } = useContext(WeaveContext);
+    const authState = useSyncExternalStore(auth ? auth.subscribe : never, auth ? auth.getState : nothing, auth ? auth.getState : nothing);
+    const connectionState = useSyncExternalStore(connection ? connection.subscribe : never, connection ? connection.getState : nothing, connection ? connection.getState : nothing);
+    if (authState?.session)
+        return { did: authState.session.did, name: authState.session.account.name };
+    if (connectionState?.grant)
+        return { did: connectionState.grant.did, name: connectionState.grant.name };
+    throw new Error('useAccount needs someone signed in or connected.');
+}
+/**
+ * The node acting for the account. For components that only appear once
+ * someone is in.
+ * @throws Outside a `WeaveProvider`, or before sign-in or connecting
+ */
+export function useNode() {
+    const { node } = useContext(WeaveContext);
+    if (!node)
+        throw new Error('useNode needs a signed-in or connected WeaveProvider above it.');
+    return node;
+}
+//# sourceMappingURL=context.js.map

package/dist/react/context.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module react
+ * React bindings: follow the sign-in flow, draw it, and keep what you read from
+ * a space live as records sync in.
+ *
+ * ```tsx
+ * const auth = createWeaveAuth({ network: { relays } });
+ *
+ * function Root() {
+ *   return <WeaveProvider auth={auth}><App /></WeaveProvider>;
+ * }
+ *
+ * function App() {
+ *   const { state } = useWeave();
+ *   if (state?.stage !== 'ready') return <WeaveAuth auth={auth} />;
+ *   return <Todos space={…} />;
+ * }
+ *
+ * function Todos({ space }) {
+ *   const { result } = useQuery(space, { collection: 'app.todo.item', sort: { '@createdAt': 'asc' } });
+ *   const node = useNode();   // to write: node.records.put(space, 'app.todo.item', { text })
+ *   …
+ * }
+ * ```
+ *
+ * `react` is a peer dependency: this entry point is the only part of the
+ * protocol that imports it.
+ */
+export { WeaveProvider, useWeave, useAuth, useSession, useConnection, useAccount, useNode } from './context.js';
+export type { WeaveProviderProps } from './context.js';
+export { useWeaveAuth } from './use-weave-auth.js';
+export { WeaveAuth } from './weave-auth.js';
+export type { WeaveAuthProps } from './weave-auth.js';
+export { useLive } from './use-live.js';
+export { useQuery } from './use-query.js';
+export type { QueryState } from './use-query.js';
+export { useSpaces } from './use-spaces.js';
+export type { SpacesState } from './use-spaces.js';
+export { useOpenSpace, useRecord, useLinked, useCollections, useProfiles, useAccess, useSpaceStatus, useCan } from './use-space.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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChH,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,36 @@
+/**
+ * @module react
+ * React bindings: follow the sign-in flow, draw it, and keep what you read from
+ * a space live as records sync in.
+ *
+ * ```tsx
+ * const auth = createWeaveAuth({ network: { relays } });
+ *
+ * function Root() {
+ *   return <WeaveProvider auth={auth}><App /></WeaveProvider>;
+ * }
+ *
+ * function App() {
+ *   const { state } = useWeave();
+ *   if (state?.stage !== 'ready') return <WeaveAuth auth={auth} />;
+ *   return <Todos space={…} />;
+ * }
+ *
+ * function Todos({ space }) {
+ *   const { result } = useQuery(space, { collection: 'app.todo.item', sort: { '@createdAt': 'asc' } });
+ *   const node = useNode();   // to write: node.records.put(space, 'app.todo.item', { text })
+ *   …
+ * }
+ * ```
+ *
+ * `react` is a peer dependency: this entry point is the only part of the
+ * protocol that imports it.
+ */
+export { WeaveProvider, useWeave, useAuth, useSession, useConnection, useAccount, useNode } from './context.js';
+export { useWeaveAuth } from './use-weave-auth.js';
+export { WeaveAuth } from './weave-auth.js';
+export { useLive } from './use-live.js';
+export { useQuery } from './use-query.js';
+export { useSpaces } from './use-spaces.js';
+export { useOpenSpace, useRecord, useLinked, useCollections, useProfiles, useAccess, useSpaceStatus, useCan } from './use-space.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEhH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/react/use-live.d.ts

@@ -0,0 +1,16 @@
+import type { P2PNode } from '../node/types.js';
+/**
+ * Loads something from a space, and loads it again whenever that space's
+ * records or connection change — locally or by sync. One load at a time; a
+ * change during a load triggers one more, never a queue of stale ones.
+ *
+ * The named hooks (`useRecord`, `useCollections`, …) cover the usual reads;
+ * this is for anything else.
+ *
+ * @param spaceId The space to follow
+ * @param load What to read, given the node
+ * @param deps When these change, start over
+ * @returns The latest value, or undefined until the first load finishes
+ */
+export declare function useLive<T>(spaceId: string, load: (node: P2PNode) => Promise<T>, deps: ReadonlyArray<unknown>): T | undefined;
+//# sourceMappingURL=use-live.d.ts.map

package/dist/react/use-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-live.d.ts","sourceRoot":"","sources":["../../src/react/use-live.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAqC5H"}

package/dist/react/use-live.js

@@ -0,0 +1,55 @@
+import { useEffect, useState } from 'react';
+import { useNode } from './context.js';
+/**
+ * Loads something from a space, and loads it again whenever that space's
+ * records or connection change — locally or by sync. One load at a time; a
+ * change during a load triggers one more, never a queue of stale ones.
+ *
+ * The named hooks (`useRecord`, `useCollections`, …) cover the usual reads;
+ * this is for anything else.
+ *
+ * @param spaceId The space to follow
+ * @param load What to read, given the node
+ * @param deps When these change, start over
+ * @returns The latest value, or undefined until the first load finishes
+ */
+export function useLive(spaceId, load, deps) {
+    const node = useNode();
+    const [value, setValue] = useState(undefined);
+    useEffect(() => {
+        let stopped = false;
+        let running = false;
+        let again = false;
+        const run = async () => {
+            if (running) {
+                again = true;
+                return;
+            }
+            running = true;
+            do {
+                again = false;
+                try {
+                    const next = await load(node);
+                    if (!stopped)
+                        setValue(next);
+                }
+                catch (error) {
+                    console.warn('useLive:', error);
+                }
+            } while (again && !stopped);
+            running = false;
+        };
+        void run();
+        const unsubscribe = node.subscribe((event) => {
+            if ('space' in event && event.space === spaceId)
+                void run();
+        });
+        return () => {
+            stopped = true;
+            unsubscribe();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [node, spaceId, ...deps]);
+    return value;
+}
+//# sourceMappingURL=use-live.js.map

package/dist/react/use-live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-live.js","sourceRoot":"","sources":["../../src/react/use-live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAI,OAAe,EAAE,IAAmC,EAAE,IAA4B;IAC3G,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,SAAS,CAAC,CAAC;IAE7D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;YACrB,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,GAAG,IAAI,CAAC;gBACb,OAAO;YACT,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,GAAG,CAAC;gBACF,KAAK,GAAG,KAAK,CAAC;gBACd,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC9B,IAAI,CAAC,OAAO;wBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,EAAE;YAC5B,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;QACF,KAAK,GAAG,EAAE,CAAC;QACX,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO;gBAAE,KAAK,GAAG,EAAE,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,IAAI,CAAC;YACf,WAAW,EAAE,CAAC;QAChB,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAE7B,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,17 @@
+import { type Query, type ResultOf } from '../query/types.js';
+export interface QueryState<R> {
+    /** The latest result, or null until the first one arrives */
+    readonly result: R | null;
+    /** Why the query failed — usually a malformed query, saying what to fix */
+    readonly error: Error | null;
+}
+/**
+ * Runs a query and keeps it current as records change, locally or by sync.
+ * The query is plain data, compared by value, so writing it inline is fine.
+ * Name the collection by its definition and the result comes back typed.
+ *
+ * @param spaceId The space to query
+ * @param query What to find
+ */
+export declare function useQuery<const Q extends Query>(spaceId: string, query: Q): QueryState<ResultOf<Q>>;
+//# sourceMappingURL=use-query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-query.d.ts","sourceRoot":"","sources":["../../src/react/use-query.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG1E,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAiBlG"}

package/dist/react/use-query.js

@@ -0,0 +1,23 @@
+import { useEffect, useState } from 'react';
+import { plainQuery } from '../query/types.js';
+import { useNode } from './context.js';
+/**
+ * Runs a query and keeps it current as records change, locally or by sync.
+ * The query is plain data, compared by value, so writing it inline is fine.
+ * Name the collection by its definition and the result comes back typed.
+ *
+ * @param spaceId The space to query
+ * @param query What to find
+ */
+export function useQuery(spaceId, query) {
+    const node = useNode();
+    const [state, setState] = useState({ result: null, error: null });
+    // Compared by its plain form: a definition's validator is not data.
+    const key = JSON.stringify(plainQuery(query));
+    useEffect(() => {
+        setState({ result: null, error: null });
+        return node.records.watch(spaceId, JSON.parse(key), (result) => setState({ result: result, error: null }), (error) => setState((previous) => ({ result: previous.result, error })));
+    }, [node, spaceId, key]);
+    return state;
+}
+//# sourceMappingURL=use-query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-query.js","sourceRoot":"","sources":["../../src/react/use-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,UAAU,EAA6B,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AASvC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAwB,OAAe,EAAE,KAAQ;IACvE,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA0B,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,oEAAoE;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9C,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CACvB,OAAO,EACP,IAAI,CAAC,KAAK,CAAC,GAAG,CAAU,EACxB,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACpE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CACxE,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEzB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/react/use-space.d.ts

@@ -0,0 +1,29 @@
+import type { NodeCollection, NodeRecord, SpaceAccess, SpaceProfile, SpaceStatus } from '../node/types.js';
+/**
+ * Keeps a space syncing while the component is on screen. Reading or writing
+ * opens a space anyway; this is for a view that should hear from peers even
+ * before it asks for anything.
+ */
+export declare function useOpenSpace(spaceId: string): void;
+/** A record's current version: undefined while loading, null when there is none. */
+export declare function useRecord<T = unknown>(spaceId: string, key: string): NodeRecord<T> | null | undefined;
+/** The records whose current version points at this one — optionally in one role, or one collection. */
+export declare function useLinked<T = unknown>(spaceId: string, key: string, options?: {
+    rel?: string;
+    collection?: string;
+}): ReadonlyArray<NodeRecord<T>> | undefined;
+/** What the space holds: its kinds of things, with their schemas and counts. */
+export declare function useCollections(spaceId: string): ReadonlyArray<NodeCollection>;
+/** Who is who in the space: the name each person gave. */
+export declare function useProfiles(spaceId: string): ReadonlyArray<SpaceProfile>;
+/** Who holds what in the space — its roles, members and invites, and your own role. */
+export declare function useAccess(spaceId: string): SpaceAccess | undefined;
+/** Connection, peers, and how many records peers sent that failed checks. */
+export declare function useSpaceStatus(spaceId: string): SpaceStatus | undefined;
+/**
+ * Whether this account may `create` in a collection (`target` = its name), or
+ * `edit` / `delete` a record (`target` = its key). False until known — for
+ * hiding a button rather than showing an error.
+ */
+export declare function useCan(spaceId: string, action: 'create' | 'edit' | 'delete', target: string): boolean;
+//# sourceMappingURL=use-space.d.ts.map

package/dist/react/use-space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-space.d.ts","sourceRoot":"","sources":["../../src/react/use-space.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI3G;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMlD;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAErG;AAED,wGAAwG;AACxG,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAE1C;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAE7E;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAExE;AAED,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAElE;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAErG"}