@zeevolabs/landlink-admin

@zeevolabs/landlink-admin

Optional admin panel extension for Landlink. Provides server-side utilities to build a config editing interface with pluggable storage.

Installation

pnpm add @zeevolabs/landlink-admin

Usage

1. Choose a store adapter

The admin requires a ConfigStore implementation. Pick one that fits your deployment:

2. Create API route handlers

// app/api/admin/config/route.ts
import { createAdminHandler } from "@zeevolabs/landlink-admin";
import { createVercelBlobStore } from "@zeevolabs/landlink-store-vercel-blob";
import { registry } from "../../../../landlink.config";

const handler = createAdminHandler({
  store: createVercelBlobStore(),
  password: process.env.LANDLINK_ADMIN_PASSWORD,
  registry,
});

export const GET = handler.GET;
export const PUT = handler.PUT;

3. Implement a custom store (optional)

import type { ConfigStore } from "@zeevolabs/landlink-admin";

const myStore: ConfigStore = {
  async get() {
    // return config object or null
  },
  async put(config) {
    // persist config object
  },
};

API

createAdminHandler(options)

Returns { GET, PUT } request handlers compatible with Next.js App Router route handlers.

Options:

checkPassword(request, password)

Compares the x-admin-password request header against the provided password. Returns { ok: boolean }.

zodToFields(schema)

Introspects a Zod schema and returns an array of FieldDescriptor objects describing the fields — useful for auto-generating admin forms.

ConfigStore (interface)

interface ConfigStore {
  get(): Promise<Record<string, unknown> | null>;
  put(config: Record<string, unknown>): Promise<void>;
}

Environment variables