bisonbase 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,113 @@
-# Temporary Holding Version
+# bisonbase
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript and React client for [bisonbase](../README.md). Users sign in with their bisonbase
+account; the app declares typed tables and reads and writes them without writing SQL.
+
+> **Status: early.** Only per-user databases (`createUserDb`) exist so far: each signed-in user
+> gets their own SQLite file in `apps/<appId>/` in their account. Shared app databases come later.
+
+```tsx
+import { BisonBase, type RowOf } from 'bisonbase'
+import { AuthElement } from 'bisonbase/react'
+
+// A UUID that identifies the app; make one with crypto.randomUUID() and keep it.
+const bb = new BisonBase('f1487da1-14ff-4998-a2c4-90b6353fe8c3', 'My Todo App', {
+  url: 'https://bisonbase.example.com', // default: /bb on the page's origin
+})
+
+const todos = bb.createUserDb('todos').createTable('todos', {
+  content: 'text',
+  done: ['boolean', false], // [type, default]
+})
+type Todo = RowOf<typeof todos> // { id: number; content: string; done: boolean }
+
+function App() {
+  const myTodos = todos.useSelect({ orderBy: 'id' }) // [] until signed in and loaded
+  return <>
+    <AuthElement />
+    {myTodos.map((t) => <p key={t.id}>{t.content}</p>)}
+    <button onClick={() => todos.insert({ content: 'New' })}>Add</button>
+  </>
+}
+```
+
+[examples/ts/react-todo](../examples/ts/react-todo) is a complete app.
+
+## Tables
+
+`createTable(name, columns)` declares a table. Every table also gets `id`, an integer primary key.
+
+| Column spec | TypeScript type | Stored as |
+|---|---|---|
+| `"text"` | `string` | `TEXT` |
+| `"integer"` | `number` (safe integer) | `INTEGER` |
+| `"real"` | `number` | `REAL` |
+| `"boolean"` | `boolean` | `BOOLEAN` (0/1) |
+| `"blob"` | `Uint8Array` | `BLOB` |
+| `"json"` | `Json` | `JSON` (text) |
+| `"text?"` etc. | `string \| null` | nullable |
+| `["text", "x"]` | `string` | with a default |
+
+Nullable columns and columns with a default may be left out of `insert`.
+
+When a signed-in user first touches a database, the library creates it and its tables, and
+adds columns that are new in the code (a new non-nullable column needs a default). It never
+changes a column's type, drops a column or deletes data: if the database doesn't match the
+code in one of those ways, operations fail with a `SchemaError` that says what's different.
+
+## Reading and writing
+
+```ts
+await todos.select({ where: { done: false }, orderBy: ['done', 'id desc'], limit: 20 })
+await todos.select({ where: { id: { $gte: 10, $lt: 20 }, content: { $in: ['a', 'b'] } } })
+await todos.insert({ content: 'a' })               // returns the row, with id and defaults
+await todos.insert([{ content: 'b' }, { content: 'c' }]) // one transaction
+await todos.update(3, { done: true })               // by id; returns the number changed
+await todos.update({ done: true }, { content: 'x' }) // by where; {} means every row
+await todos.delete({ done: true })
+```
+
+`where` matches when every listed column matches; `null` matches NULL. Operators are `$ne`,
+`$lt`, `$lte`, `$gt`, `$gte` and `$in`.
+
+Raw SQL works on per-user databases, with interpolated values sent as parameters:
+
+```ts
+const [{ n }] = await todos.db.sql`SELECT count(*) AS n FROM todos WHERE done = ${false}`
+```
+
+## React
+
+Import `bisonbase/react` once (importing `AuthElement` or `useAuth` does it).
+
+- `table.useSelect(options?)`: the matching rows, kept up to date. Empty while signed out or
+  loading. Components using the same options share one query.
+- `table.useSelectState(options?)`: `{ rows, loading, error }`.
+- `useAuth()`: `{ status: 'signed-out' | 'pending' | 'signed-in', error? }`.
+- `<AuthElement />`: a sign-in button, or a sign-out button once signed in. Unstyled; target
+  `.bb-auth`, `.bb-auth-error`.
+
+Queries are fetched again after any write through the library to the same table, and when the
+window regains focus. Changes made elsewhere (another device) show up on focus; the server
+doesn't push changes yet.
+
+Outside React, `table.liveQuery(options)` returns the same shared query, with `subscribe` and
+`getSnapshot`.
+
+## Signing in
+
+`bb.signIn()` sends the browser to bisonbase ("Sign in with bisonbase", OAuth 2.1 with PKCE). When
+it comes back, the constructor takes the code out of the address bar and trades it for a token,
+which is kept in `localStorage`. `bb.signOut()` forgets and revokes it. `bb.auth` and
+`bb.onAuthChange(fn)` give the state outside React.
+
+In scripts and tests, pass a token instead: `new BisonBase(id, name, { url, token })`.
+
+## Develop
+
+```sh
+npm install
+npm run typecheck   # includes the type tests in test/types.test.ts
+npm test            # unit tests, plus end-to-end tests if ../node has been built
+npm run build       # dist/
+```

package/dist/auth.d.ts

@@ -0,0 +1,16 @@
+export interface AuthConfig {
+    server: string;
+    appId: string;
+    appName: string;
+    scope: string;
+}
+/** Send the browser to bisonbase to sign in. */
+export declare function startSignIn(cfg: AuthConfig): Promise<void>;
+/**
+ * If bisonbase just sent the browser back here, take the response out of the address bar
+ * (synchronously, before the app renders) and return a promise for the token.
+ */
+export declare function takeSignInResponse(server: string): Promise<string> | null;
+/** Revoke a token on the server. Failures are ignored: the token is forgotten locally anyway. */
+export declare function revoke(server: string, token: string): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAOD,gDAAgD;AAChD,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAUzE;AAqBD,iGAAiG;AACjG,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}

package/dist/auth.js

@@ -0,0 +1,75 @@
+// "Sign in with bisonbase": the OAuth 2.1 authorization code flow with PKCE, in the browser.
+const base64url = (bytes) => btoa(String.fromCharCode(...bytes)).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+const randomString = () => base64url(crypto.getRandomValues(new Uint8Array(32)));
+const sha256 = async (s) => base64url(new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(s))));
+const FLOW_KEY = 'bisonbase:sign-in';
+// An app is identified by its origin, and bisonbase sends the user back to the current page.
+const clientId = () => location.origin;
+const redirectUri = () => location.origin + location.pathname;
+/** Send the browser to bisonbase to sign in. */
+export async function startSignIn(cfg) {
+    const flow = {
+        state: randomString(),
+        verifier: randomString(),
+        server: cfg.server,
+        back: location.pathname + location.search + location.hash,
+    };
+    sessionStorage.setItem(FLOW_KEY, JSON.stringify(flow));
+    const params = new URLSearchParams({
+        response_type: 'code',
+        client_id: clientId(),
+        redirect_uri: redirectUri(),
+        scope: cfg.scope,
+        state: flow.state,
+        code_challenge: await sha256(flow.verifier),
+        code_challenge_method: 'S256',
+        app_id: cfg.appId,
+        app_name: cfg.appName,
+    });
+    location.assign(`${cfg.server}/oauth/authorize?${params}`);
+}
+/**
+ * If bisonbase just sent the browser back here, take the response out of the address bar
+ * (synchronously, before the app renders) and return a promise for the token.
+ */
+export function takeSignInResponse(server) {
+    if (typeof location === 'undefined' || typeof sessionStorage === 'undefined')
+        return null;
+    const params = new URLSearchParams(location.search);
+    const saved = sessionStorage.getItem(FLOW_KEY);
+    if (!saved || !params.has('state'))
+        return null;
+    const flow = JSON.parse(saved);
+    if (flow.server !== server || params.get('state') !== flow.state)
+        return null;
+    sessionStorage.removeItem(FLOW_KEY);
+    history.replaceState(history.state, '', flow.back); // drop ?code=... from the address bar
+    return exchange(server, flow, params);
+}
+async function exchange(server, flow, params) {
+    if (params.get('iss') !== server)
+        throw new Error("Sign-in failed: the response didn't come from the expected server.");
+    if (params.get('error') === 'access_denied')
+        throw new Error('Sign-in was cancelled.');
+    if (params.has('error'))
+        throw new Error(`Sign-in failed: ${params.get('error_description') ?? params.get('error')}`);
+    const res = await fetch(`${server}/oauth/token`, {
+        method: 'POST',
+        body: new URLSearchParams({
+            grant_type: 'authorization_code',
+            code: params.get('code') ?? '',
+            client_id: clientId(),
+            redirect_uri: redirectUri(),
+            code_verifier: flow.verifier,
+        }),
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok)
+        throw new Error(`Sign-in failed: ${json.error_description ?? json.error ?? res.statusText}`);
+    return json.access_token;
+}
+/** Revoke a token on the server. Failures are ignored: the token is forgotten locally anyway. */
+export async function revoke(server, token) {
+    await fetch(`${server}/oauth/revoke`, { method: 'POST', body: new URLSearchParams({ token }) }).catch(() => { });
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,149 @@
+import { SchemaError } from './schema.ts';
+import type { Columns, InsertFor, RowFor, SelectOptions, UpdateFor, Where, Wire } from './types.ts';
+export interface BisonBaseOptions {
+    /** The bisonbase server. Default: `/bb` on the current origin. */
+    url?: string;
+    /**
+     * Use this token instead of signing in through the browser, e.g. a personal token in a
+     * script or test. It isn't stored.
+     */
+    token?: string;
+}
+export type AuthState = 
+/** `error` says why, when signing in failed or the token stopped working. */
+{
+    status: 'signed-out';
+    error?: string;
+}
+/** Finishing a sign-in (trading the code from the redirect for a token). */
+ | {
+    status: 'pending';
+} | {
+    status: 'signed-in';
+};
+/** An error response from the bisonbase API. */
+export declare class ApiError extends Error {
+    name: string;
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+/** An operation needed the user to be signed in. */
+export declare class NotSignedInError extends Error {
+    name: string;
+    constructor();
+}
+export interface QueryResult {
+    columns: string[];
+    rows: Wire[][];
+    truncated: boolean;
+    changes: number;
+    last_insert_rowid: number;
+}
+/** The state of a live query, as `useSelectState` returns it. */
+export interface QueryState<R> {
+    /** Empty while signed out or before the first load. Kept (stale) while reloading or after an error. */
+    rows: readonly R[];
+    /** True until the first load finishes (only while signed in or signing in). */
+    loading: boolean;
+    error: Error | null;
+}
+/** The connection to a bisonbase server for one app. Make one per page. */
+export declare class BisonBase {
+    #private;
+    /** The instance `<AuthElement />` and other React helpers use. */
+    static instance: BisonBase | null;
+    readonly appId: string;
+    readonly appName: string;
+    /** The server's origin, e.g. `https://example.com/bb`, without a trailing slash. */
+    readonly url: string;
+    /**
+     * @param appId A UUID that identifies the app and never changes; the app's files live in
+     *   `apps/<appId>/` in each user's account. Make one with `crypto.randomUUID()`.
+     * @param appName The name shown to users when they sign in and in their file browser.
+     */
+    constructor(appId: string, appName: string, options?: BisonBaseOptions);
+    /** Whether the user is signed in. */
+    get auth(): AuthState;
+    /** Call `listener` whenever `auth` changes. Returns a function that stops listening. */
+    onAuthChange(listener: () => void): () => void;
+    /** Send the browser to the server to sign in; it comes back to the current page. */
+    signIn(): Promise<void>;
+    /** Forget the token here and revoke it on the server. */
+    signOut(): Promise<void>;
+    /**
+     * A database that each user gets their own copy of, stored as `apps/<appId>/<name>.db`
+     * in their account. Only that user can read or change it.
+     */
+    createUserDb(name: string): UserDb;
+}
+/** A query whose rows are kept up to date while something is subscribed to it. */
+export declare class LiveQuery<R> {
+    #private;
+    readonly table: Table<any>;
+    constructor(bb: BisonBase, run: () => Promise<R[]>, table: Table<any>, dispose: () => void);
+    /** For `useSyncExternalStore`. */
+    subscribe: (listener: () => void) => (() => void);
+    /** For `useSyncExternalStore`. Returns the same object until something changes. */
+    getSnapshot: () => QueryState<R>;
+}
+/** A database each signed-in user has their own copy of. Make one with `bb.createUserDb`. */
+export declare class UserDb {
+    #private;
+    readonly bb: BisonBase;
+    readonly name: string;
+    /** Path within the user's files, e.g. `apps/<appId>/todos.db`. */
+    readonly path: string;
+    /**
+     * Declare a table. It's created, or new columns are added, the first time it's used after
+     * signing in. Every table also has an `id` integer primary key.
+     *
+     * ```ts
+     * const todos = db.createTable("todos", { content: "text", done: ["boolean", false] })
+     * ```
+     */
+    createTable<const C extends Columns>(name: string, columns: C): Table<C>;
+    /**
+     * Run raw SQL against this database, returning rows as objects. Values interpolated into
+     * the template are sent as bound parameters. Booleans come back as 0/1 and JSON as text.
+     *
+     * ```ts
+     * const rows = await db.sql`SELECT count(*) AS n FROM todos WHERE done = ${false}`
+     * ```
+     */
+    sql(strings: TemplateStringsArray, ...values: unknown[]): Promise<Record<string, Wire>[]>;
+}
+/** A table in a database. Make one with `db.createTable`. */
+export declare class Table<C extends Columns> {
+    #private;
+    readonly db: UserDb;
+    get name(): string;
+    /** Fetch rows once. For rows that stay up to date in a component, use `useSelect`. */
+    select(options?: SelectOptions<RowFor<C>>): Promise<RowFor<C>[]>;
+    /** Insert a row and return it as stored (with its `id` and defaults). */
+    insert(row: InsertFor<C>): Promise<RowFor<C>>;
+    /** Insert several rows in one transaction. */
+    insert(rows: readonly InsertFor<C>[]): Promise<RowFor<C>[]>;
+    /**
+     * Change the rows matching `where` (or the row with that id). Returns how many changed.
+     * Pass `{}` to change every row.
+     */
+    update(where: Where<RowFor<C>> | number, changes: UpdateFor<C>): Promise<number>;
+    /** Delete the rows matching `where` (or the row with that id). Returns how many were deleted. Pass `{}` to delete every row. */
+    delete(where: Where<RowFor<C>> | number): Promise<number>;
+    /** The live query for these options, shared with every other user of the same options. */
+    liveQuery(options?: SelectOptions<RowFor<C>>): LiveQuery<RowFor<C>>;
+    /**
+     * React hook: the rows matching `options`, kept up to date. Empty while signed out or
+     * loading. Needs `import "bisonbase/react"` somewhere in the app.
+     */
+    useSelect(options?: SelectOptions<RowFor<C>>): readonly RowFor<C>[];
+    /** React hook: like `useSelect`, plus whether it's loading and the last error. */
+    useSelectState(options?: SelectOptions<RowFor<C>>): QueryState<RowFor<C>>;
+}
+export { SchemaError };
+/** The row type of a table: `type Todo = RowOf<typeof todos>`. */
+export type RowOf<T> = T extends Table<infer C> ? RowFor<C> : never;
+/** What a table's `insert` takes. */
+export type InsertOf<T> = T extends Table<infer C> ? InsertFor<C> : never;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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