@anodb/core 0.7.1 → 0.8.0

package/dist/result-types.d.ts

@@ -0,0 +1,13 @@
+import type { KyselyPlugin, PluginTransformQueryArgs, PluginTransformResultArgs, QueryResult, RootOperationNode, UnknownRow } from 'kysely';
+import type { SchemaDefinition } from './types.js';
+type Converter = (row: Record<string, unknown>) => Record<string, unknown>;
+/** Builds the row converter for one query, or null when nothing needs converting. */
+export declare function resultConverter(schema: SchemaDefinition, node: RootOperationNode): Converter | null;
+export declare class TypedResultsPlugin implements KyselyPlugin {
+    #private;
+    readonly schema: SchemaDefinition;
+    constructor(schema: SchemaDefinition);
+    transformQuery(args: PluginTransformQueryArgs): RootOperationNode;
+    transformResult(args: PluginTransformResultArgs): Promise<QueryResult<UnknownRow>>;
+}
+export {};

package/dist/result-types.js

@@ -0,0 +1,157 @@
+const name = (n) => {
+    const node = n;
+    if (!node)
+        return undefined;
+    if (node.kind === 'IdentifierNode')
+        return node.name;
+    if (node.kind === 'SchemableIdentifierNode')
+        return name(node.identifier);
+    if (node.kind === 'TableNode')
+        return name(node.table);
+    if (node.kind === 'ColumnNode')
+        return name(node.column);
+    return undefined;
+};
+/** alias (or table name) → schema table, from FROM / JOIN / INTO / UPDATE targets. */
+function sources(schema, nodes) {
+    const out = new Map();
+    for (const raw of nodes) {
+        const n = raw;
+        if (!n)
+            continue;
+        if (n.kind === 'TableNode') {
+            const t = name(n);
+            if (t && t in schema)
+                out.set(t, t);
+        }
+        else if (n.kind === 'AliasNode' && n.node.kind === 'TableNode') {
+            const t = name(n.node);
+            const alias = name(n.alias);
+            if (t && alias && t in schema)
+                out.set(alias, t);
+        }
+    }
+    return out;
+}
+function columnTypes(schema, src, selections) {
+    const out = new Map();
+    const typeOf = (column, table) => {
+        if (table !== undefined) {
+            const t = src.get(table);
+            return t ? schema[t][column] : undefined;
+        }
+        const found = new Set();
+        for (const t of src.values()) {
+            const c = schema[t][column];
+            if (c)
+                found.add(c);
+        }
+        return found.size === 1 ? [...found][0] : undefined;
+    };
+    const allOf = (table) => {
+        const tables = table !== undefined ? [src.get(table)].filter((t) => !!t) : [...src.values()];
+        for (const t of tables)
+            for (const [c, type] of Object.entries(schema[t]))
+                out.set(c, type);
+    };
+    const ref = (n, as) => {
+        if (n.kind === 'ColumnNode') {
+            const c = name(n);
+            const type = typeOf(c);
+            if (type)
+                out.set(as ?? c, type);
+        }
+        else if (n.kind === 'ReferenceNode') {
+            const table = n.table ? name(n.table) : undefined;
+            const col = n.column;
+            if (col.kind === 'SelectAllNode') {
+                if (!as)
+                    allOf(table);
+                return;
+            }
+            const c = name(col);
+            const type = typeOf(c, table);
+            if (type)
+                out.set(as ?? c, type);
+        }
+        else if (n.kind === 'SelectAllNode' && !as) {
+            allOf();
+        }
+    };
+    for (const s of selections ?? []) {
+        const sel = (s.selection ?? s);
+        if (sel.kind === 'AliasNode') {
+            const inner = sel.node;
+            // Only plain column references keep their type through an alias.
+            out.delete(name(sel.alias));
+            ref(inner, name(sel.alias));
+        }
+        else
+            ref(sel);
+    }
+    return out;
+}
+/** Builds the row converter for one query, or null when nothing needs converting. */
+export function resultConverter(schema, node) {
+    const n = node;
+    let types;
+    if (n.kind === 'SelectQueryNode') {
+        const froms = n.from?.froms ?? [];
+        const joins = (n.joins ?? []).map((j) => j.table);
+        types = columnTypes(schema, sources(schema, [...froms, ...joins]), n.selections);
+    }
+    else if (n.kind === 'InsertQueryNode' || n.kind === 'UpdateQueryNode' || n.kind === 'DeleteQueryNode') {
+        const returning = n.returning;
+        if (!returning)
+            return null;
+        const targets = n.kind === 'InsertQueryNode' ? [n.into] : n.kind === 'UpdateQueryNode' ? [n.table] : (n.from?.froms ?? []);
+        types = columnTypes(schema, sources(schema, targets), returning.selections);
+    }
+    else
+        return null;
+    const convert = [...types].filter(([, t]) => t === 'boolean' || t === 'json');
+    if (convert.length === 0)
+        return null;
+    return (row) => {
+        const out = { ...row };
+        for (const [col, type] of convert) {
+            if (!(col in out))
+                continue;
+            const v = out[col];
+            if (type === 'boolean') {
+                if (typeof v === 'number')
+                    out[col] = v !== 0;
+            }
+            else if (typeof v === 'string') {
+                try {
+                    out[col] = JSON.parse(v);
+                }
+                catch {
+                    // leave non-JSON text as is
+                }
+            }
+        }
+        return out;
+    };
+}
+export class TypedResultsPlugin {
+    schema;
+    #pending = new WeakMap();
+    constructor(schema) {
+        this.schema = schema;
+    }
+    transformQuery(args) {
+        const conv = resultConverter(this.schema, args.node);
+        if (conv)
+            this.#pending.set(args.queryId, conv);
+        return args.node;
+    }
+    async transformResult(args) {
+        const conv = this.#pending.get(args.queryId);
+        if (!conv)
+            return args.result;
+        this.#pending.delete(args.queryId);
+        return { ...args.result, rows: args.result.rows.map((r) => conv(r)) };
+    }
+}
+//# sourceMappingURL=result-types.js.map

package/dist/result-types.js.map

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

package/dist/schema.d.ts

@@ -1,8 +1,14 @@
-import type { ColumnType, SchemaDefinition, SqlValue, TableDefinition } from './types.js';
+import type { ColumnType, JsonColumn, SchemaDefinition, SqlValue, TableDefinition } from './types.js';
 export declare const RESERVED_COLUMNS: Set<string>;
 /** System cells. They travel in the change log like user cells. */
 export declare const SYS_DELETED = "$deleted";
 export declare const SYS_CREATED = "$createdAt";
+/**
+ * A `json` column with a TypeScript type for its value (reads return the parsed value):
+ *
+ *   defineSchema({ note: { meta: json<{ tags: string[] }>() } })
+ */
+export declare function json<T = unknown>(): JsonColumn<T>;
 /** Identity function that validates the schema and keeps literal types for inference. */
 export declare function defineSchema<const S extends SchemaDefinition>(schema: S): S;
 export declare function validateSchema(schema: SchemaDefinition): void;

package/dist/schema.js

@@ -4,6 +4,14 @@ const COLUMN_TYPES = new Set(['text', 'integer', 'real', 'boolean', 'json']);
 /** System cells. They travel in the change log like user cells. */
 export const SYS_DELETED = '$deleted';
 export const SYS_CREATED = '$createdAt';
+/**
+ * A `json` column with a TypeScript type for its value (reads return the parsed value):
+ *
+ *   defineSchema({ note: { meta: json<{ tags: string[] }>() } })
+ */
+export function json() {
+    return 'json';
+}
 /** Identity function that validates the schema and keeps literal types for inference. */
 export function defineSchema(schema) {
     validateSchema(schema);

package/dist/schema.js.map

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

package/dist/types.d.ts

@@ -15,6 +15,11 @@ export interface SqliteDriver {
     close(): void;
 }
 export type ColumnType = 'text' | 'integer' | 'real' | 'boolean' | 'json';
+declare const JSON_TYPE: unique symbol;
+/** A `json` column with a TypeScript type for its value: `json<{ tags: string[] }>()`. */
+export type JsonColumn<T> = 'json' & {
+    readonly [JSON_TYPE]?: T;
+};
 export type TableDefinition = Readonly<Record<string, ColumnType>>;
 export type SchemaDefinition = Readonly<Record<string, TableDefinition>>;
 /** Overall sync state reported by `db.status`. */
@@ -43,3 +48,4 @@ export interface EventTemplate {
 }
 /** Freshness of data fetched from the network. */
 export type FetchStatus = 'synced' | 'stale' | 'unavailable';
+export {};

package/dist/ui.d.ts

@@ -0,0 +1,161 @@
+import { type ReactNode } from 'react';
+import type { Role } from './membership.js';
+import type { Device, Invitation, JoinRequest, Member } from './sharing.js';
+import type { SpaceInfo } from './db.js';
+/** The parts of AnoDB these components use. */
+export interface SharingDB {
+    readonly appId: string;
+    readonly pubkey: string;
+    onChange(fn: () => void): () => void;
+    spaces(): SpaceInfo[];
+    members(space: string): Member[];
+    roleIn(space: string): Role | undefined;
+    setRole(space: string, who: string, role: Exclude<Role, 'owner'>): Promise<void>;
+    removeMember(space: string, who: string): Promise<void>;
+    createInviteLink(space: string, opts?: {
+        role?: Exclude<Role, 'owner'>;
+        expiresInMs?: number;
+    }): Promise<string>;
+    requestJoin(link: string, name?: string): Promise<void>;
+    joinRequests(): JoinRequest[];
+    approveJoinRequest(id: string): Promise<void>;
+    rejectJoinRequest(id: string): void;
+    invitations(): Invitation[];
+    acceptInvitation(space: string): Promise<void>;
+    declineInvitation(space: string): void;
+    devices(): Device[];
+    startPairing(): Promise<{
+        uri: string;
+        code: string;
+        done: Promise<void>;
+    }>;
+    parsePairing(uri: string): {
+        device: string;
+        code: string;
+        approve(name?: string): Promise<void>;
+    };
+    revokeDevice(device: string): Promise<void>;
+    close(): Promise<void>;
+}
+export type Lang = 'en' | 'ja';
+declare const en: {
+    addDevice: string;
+    addDeviceHint: string;
+    pairingLink: string;
+    check: string;
+    compare: string;
+    deviceName: string;
+    approve: string;
+    cancel: string;
+    approved: string;
+    newDevice: string;
+    newDeviceHint: string;
+    showQr: string;
+    scanWithOther: string;
+    waiting: string;
+    copy: string;
+    copied: string;
+    devices: string;
+    thisDevice: string;
+    revoked: string;
+    revoke: string;
+    confirmRevoke: string;
+    invite: string;
+    role: string;
+    createLink: string;
+    linkHint: string;
+    requests: string;
+    none: string;
+    approveRequest: string;
+    reject: string;
+    cannotInvite: string;
+    join: string;
+    inviteLink: string;
+    yourName: string;
+    requestJoin: string;
+    requested: string;
+    joined: string;
+    invitations: string;
+    accept: string;
+    decline: string;
+    members: string;
+    you: string;
+    remove: string;
+    confirmRemove: string;
+    invalidLink: string;
+};
+export type Labels = typeof en;
+interface CommonProps {
+    /** UI language; defaults to the browser's language (Japanese or English). */
+    lang?: Lang;
+    /** Override any text. */
+    labels?: Partial<Labels>;
+    className?: string;
+}
+/**
+ * Re-read state that has no change event of its own (members, requests, devices…): on every
+ * database change and once a second. Re-renders only when the value changes.
+ */
+export declare function useLive<T>(read: (db: SharingDB) => T, deps?: readonly unknown[]): T;
+/** Wrap an `anodb://` link into an https URL of this app, so phones open it from a QR code. */
+export declare function toAppLink(uri: string, base?: string): string;
+/** Accepts an `anodb://…` link or an app link (`…#anodb=…`) and returns the `anodb://` link. */
+export declare function parseAppLink(text: string): string | null;
+/** An `anodb://<kind>` link this page was opened with (`#anodb=…`), and a way to clear it. */
+export declare function useIncomingLink(kind: 'pair' | 'join'): [string | null, () => void];
+/** QR code as SVG (dark modules use `currentColor`). */
+export declare function QRCode(props: {
+    value: string;
+    size?: number;
+    className?: string;
+    title?: string;
+}): import("react").JSX.Element;
+export interface PairDeviceProps extends CommonProps {
+    /** Which parts to show. Default both. */
+    mode?: 'both' | 'approve' | 'new-device';
+    /** After this device was added to another identity. Default: close the database and reload the page. */
+    onPaired?: () => void;
+    /** Base URL for links and QR codes (default: this page). */
+    linkBase?: string;
+}
+/**
+ * Add a device to your identity. On the existing device: scan or paste the new device's link,
+ * compare the code, approve. On the new device: show the QR code and wait.
+ */
+export declare function PairDevice(props: PairDeviceProps): import("react").JSX.Element;
+/** Your devices, with a revoke button for each other device. */
+export declare function DeviceList(props: CommonProps): import("react").JSX.Element;
+export interface InviteLinkProps extends CommonProps {
+    space: string;
+    /** Link lifetime. Default 24 h. */
+    expiresInMs?: number;
+    /** Show join requests below the link. Default true. */
+    showRequests?: boolean;
+    linkBase?: string;
+}
+/** One-time invite link (with QR code) for a space, and the join requests waiting for approval. */
+export declare function InviteLink(props: InviteLinkProps): import("react").JSX.Element;
+/** Join requests for one space (or all spaces) with approve / reject. */
+export declare function JoinRequests(props: CommonProps & {
+    space?: string;
+}): import("react").JSX.Element;
+export interface JoinSpaceProps extends CommonProps {
+    /** Called with the space id once you are a member. */
+    onJoined?: (space: string) => void;
+    /** Pre-filled name shown to the admin. */
+    defaultName?: string;
+}
+/** Join with an invite link (pasted or opened via QR), and accept invitations sent to your npub. */
+export declare function JoinSpace(props: JoinSpaceProps): import("react").JSX.Element;
+/** Invitations sent to your npub (`db.invite(space, npub, role)`), with accept / decline. */
+export declare function Invitations(props: CommonProps & {
+    onJoined?: (space: string) => void;
+}): import("react").JSX.Element | null;
+export interface MembersProps extends CommonProps {
+    space: string;
+    /** Display name for a member (default: shortened npub, or "you"). */
+    nameOf?: (member: Member) => ReactNode;
+}
+/** Members of a space. Owners and admins can change roles and remove members. */
+export declare function Members(props: MembersProps): import("react").JSX.Element;
+export {};