Connect SDK

@mdbase-dev/connect is the browser and native-shell SDK for applications that operate on one user-approved local or hosted mdbase collection. The application asks for exact operations. Connect selects the route and the collection authority checks the current grant.

Choose the first result you need

SDK surfaces

Application structure

Create one MdbaseConnect manager at the application boundary. Pair it with one MdbaseBrowserLocation at the browser application boundary. Resolve its active connection, then pass that MdbaseConnection into feature code. The location helper owns bookmark selection and OAuth return cleanup; the manager owns saved authorizations. A bound connection never changes collections underneath a repository, and feature code written against MdbaseCollectionClient can also run against the developer sandbox or another conforming transport.

A downloaded HTML file supplies distribution: "portable" in its inline manifest. The same manager then uses short-code approval and session-only credentials. See the portable HTML application guide.

import type { MdbaseCollectionClient } from "@mdbase-dev/connect";

export async function listOpenTasks(client: MdbaseCollectionClient<Task>) {
  return client.queryAll({
    types: ["task"],
    where: 'status == "open"',
    order_by: [{ field: "due", direction: "asc" }]
  });
}

Package map