automerge-repo auth spec

100%

automerge-repo auth spec

✓ Published0🌍 Public

Last edited Mar 31, 2023

Created on Feb 28, 2023

This example shows the authentication and sharing workflow for Automerge Repo, a local-first collaboration framework, using the `@localfirst/auth` library. It demonstrates how to configure a `LocalFirstAuthProvider` with user and device credentials, create and join shares, invite members and devices, and manage document permissions. The code uses TypeScript APIs like `createUser`, `createDevice`, `inviteMember`, and `addDocuments`, with invitations relying on seeds, usage limits, and expiration timestamps. The documentation is rendered as a pseudocode specification, not a live visualization, but it concretely maps each method call to its parameters and return values.

AI-generated description

Similar vizzes

Loading thumbnail…

automerge-auth strawman

This example outlines a strawman architecture for **automerge-auth**, a proposed successor to the `localfirst/auth` library, by defining key TypeScript classes and workflows in a markdown document. It shows how a `Group` class unifies users, devices, and subgroups into a single transitive membership model, while a `Connection` class provides point-to-point encrypted channels and an `AuthProvider` integrates with `automerge-repo` via network and storage adapters. The sketch maps desirable features like untrusted sync servers and flexible sharing against existing lf/auth patterns, using diagrams and pseudocode from the gist.

HHerbCaudill

80% match

Loading thumbnail…

draft readme for automerge repo

This example visualizes the architecture of a proposed Automerge repository API through a plain-text code listing. It shows the core data flow and plugin interfaces for storage, networking, and middleware, using TypeScript and Automerge’s CRDT library. The rendering relies on the raw code blocks themselves, highlighting API method signatures like `AutomergeRepo.createRepo`, `wrappedDoc.addListener`, and `storage.appendChange`. The visualization maps the conceptual layers of the API, from public document operations to internal plugin contracts, without any graphical charts.

HHerbCaudill

73% match

Loading thumbnail…

automerge-repo message types

This visualization maps the evolving message-type definitions of the `automerge-repo` library, contrasting proposed types like `SyncMessage`, `EphemeralMessage`, and `AuthMessage` with existing adapter-specific payloads. It shows how fields such as `peerId`, `channelId`, and `broadcast` are repurposed inconsistently across `NetworkAdapter`, `DocSynchronizer`, and `EphemeralData` classes. The diagram highlights the `channelId` encoding scheme (`m/` for ephemeral, `a/` for auth) and flags redundant or unused patterns like `DocHandleMessagePayload`. The source is a single TypeScript gist by HerbCaudill, presented as raw code excerpts.

HHerbCaudill

63% match

Loading thumbnail…

Resources for getting started with local-first software development

This visualization presents a curated resource guide for local-first software development, sourced from a GitHub gist. It shows a linear reading flow, beginning with foundational background material and progressing to hands-on tutorials. The React-based layout uses Automerge and Automerge Repo as the core libraries, with descriptions that highlight CRDT merge scenarios and a browser-synced counter app. The guide’s structure and linked resources are presented as a static, annotated list, emphasizing the path from conceptual videos to practical code examples.

HHerbCaudill

60% match

Loading thumbnail…

auth@next notes

This visualization maps the hierarchical and membership structure of an authentication system, showing how entities like teams, roles, users, and devices nest and connect. It uses a force-directed graph layout, likely via D3's `forceSimulation`, to position nodes by their relationships, with links drawn as curved paths. The data comes from TypeScript type definitions that model each entity with an `id`, `name`, keyset, and optional `members` array, revealing the recursive, tree-like organization of permissions. The rendering emphasizes the flow of access rights from high-level groups down to leaf agents and devices.

HHerbCaudill

55% match

Loading thumbnail…

Gist 619560

This visualization loads a map using Polymaps and merges it with a local fork via a shell script. The code demonstrates a version-control workflow rather than a graphical output, as it logs git commands piping the `mbostock/master` branch into the local tree. The primary rendering relies on Polymaps’ tile-based mapping, while the surrounding repository management shows how to integrate external contributions. The example pairs a geographic data display with a practical Git merge, highlighting maintenance of a live mapping project through `git remote`, `fetch`, and `merge` operations.

Mmbostock

52% match

Loading thumbnail…

lf-auth-notes

This interactive visualization demonstrates how cryptographic keys and team membership are managed in a decentralized graph, where each node is an encrypted lockbox containing keys accessible only to designated devices or roles. It shows the flow of authority from the group’s founder through admin roles to individual members, with mutual removals resolved by seniority. Built on the CRDX library, the graph uses asymmetric encryption for each node, and the visualization renders the key graph and lockbox relationships using custom SVG rendering. The code highlights the concrete APIs for graph traversal and cryptographic operations, such as key derivation and signature verification, as seen in the invitation and lockbox logic. Data is sourced from the embedded gist’s markdown and assets.

HHerbCaudill

52% match

Loading thumbnail…

The Gist to Clone All Gists

This example demonstrates a practical workflow for backing up or synchronizing a GitHub user’s public gists. It first clones every gist from a specified GitHub account over SSH, using a paginated API fetch to retrieve the list of gists and the Node.js `https` module to authenticate via an OAuth token. It then shows a complementary bash script that iterates through local directories, committing any changes with an empty message and pushing them back to their remote origins. The visualization highlights the interplay between the GitHub REST API and command-line Git operations for batch repository management.

Mmbostock

52% match