@raybase/core 0.0.2 → 0.3.3

package/dist/admin-boot.d.ts

@@ -0,0 +1,94 @@
+import type { RaybaseAdminRole } from "./admin-role.js";
+import type { RaybaseUser } from "./policies.js";
+import type { RaybaseConfig, RaybaseSchema } from "./schema.js";
+import type { RaybaseStorageConfig } from "./storage.js";
+export type AdminBootInput = {
+    config: RaybaseConfig;
+    schema: RaybaseSchema;
+    user: RaybaseUser;
+    local: boolean;
+    systemSchema?: RaybaseSchema;
+    storage?: RaybaseStorageConfig;
+    retrieval?: boolean;
+    search?: boolean;
+    notificationsEnabled?: boolean;
+    agentsEnabled?: boolean;
+    settings?: {
+        app: boolean;
+        user: boolean;
+    };
+};
+export type AdminColumnBoot = {
+    kind: string;
+    required: boolean;
+    primaryKey: boolean;
+    enumValues?: readonly string[];
+    references?: string | null;
+    auto?: string;
+    label: string;
+};
+export type AdminTableBoot = {
+    name: string;
+    label: string;
+    system: boolean;
+    columns: Record<string, AdminColumnBoot>;
+};
+export type AdminStorageBoot = {
+    buckets: Array<{
+        name: string;
+        label: string;
+        maxSizeBytes: number | null;
+        accept: string[];
+    }>;
+} | null;
+/** The admin's link into this app's front-channel SSO resource, if it has one. */
+export type AdminHandoffBoot = {
+    label: string;
+    href: string;
+} | null;
+export type AdminBoot = {
+    appName: string;
+    schema: Record<string, AdminTableBoot>;
+    storage: AdminStorageBoot;
+    handoff: AdminHandoffBoot;
+    user: RaybaseUser;
+    roles: string[];
+    operatorRoles: Array<{
+        value: string;
+        label: string;
+    }>;
+    local: boolean;
+    mcpEnabled: boolean;
+    retrievalEnabled: boolean;
+    searchEnabled: boolean;
+    notificationsEnabled: boolean;
+    webPushEnabled: boolean;
+    agentsEnabled: boolean;
+    settings: {
+        app: boolean;
+        user: boolean;
+    };
+};
+export type AdminDocsBoot = {
+    appName: string;
+    storage: AdminStorageBoot;
+    handoff: AdminHandoffBoot;
+    user: Pick<RaybaseUser, "id" | "email" | "name"> & {
+        operatorRole: RaybaseAdminRole | null;
+    };
+    local: boolean;
+    mcpEnabled: boolean;
+    retrievalEnabled: boolean;
+    searchEnabled: boolean;
+    notificationsEnabled: boolean;
+    webPushEnabled: boolean;
+    agentsEnabled: boolean;
+    settings: {
+        app: boolean;
+        user: boolean;
+    };
+};
+export declare function buildAdminBoot(input: AdminBootInput): AdminBoot;
+export declare function adminDocsBootFromAdminBoot(boot: AdminBoot): AdminDocsBoot;
+export declare function buildAdminDocsBoot(input: AdminBootInput): AdminDocsBoot;
+//# sourceMappingURL=admin-boot.d.ts.map

package/dist/admin-boot.d.ts.map

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

package/dist/admin-boot.js

@@ -0,0 +1,139 @@
+import { getReferenceName } from "./schema.js";
+const labelAcronyms = new Map([
+    ["ai", "AI"],
+    ["api", "API"],
+    ["csv", "CSV"],
+    ["do", "DO"],
+    ["fts", "FTS"],
+    ["id", "ID"],
+    ["json", "JSON"],
+    ["mcp", "MCP"],
+    ["oauth", "OAuth"],
+    ["r2", "R2"],
+    ["sql", "SQL"],
+    ["url", "URL"]
+]);
+function humanizeIdentifier(value) {
+    const words = value.replace(/^_+/, "").split(/[^A-Za-z0-9]+/).filter(Boolean);
+    if (!words.length)
+        return value;
+    return words
+        .map((word) => {
+        const lower = word.toLowerCase();
+        const acronym = labelAcronyms.get(lower);
+        if (acronym)
+            return acronym;
+        return `${word.slice(0, 1).toUpperCase()}${word.slice(1)}`;
+    })
+        .join(" ");
+}
+function buildSchema(schemaInput, system) {
+    return Object.fromEntries(Object.entries(schemaInput.tables).map(([name, table]) => [
+        name,
+        {
+            name: table.name,
+            label: table.label ?? humanizeIdentifier(table.name),
+            system,
+            columns: Object.fromEntries(Object.entries(table.columns).map(([columnName, column]) => [
+                columnName,
+                {
+                    kind: column.kind,
+                    required: Boolean(column.required || column.primaryKey),
+                    primaryKey: Boolean(column.primaryKey),
+                    enumValues: column.enumValues,
+                    references: getReferenceName(column),
+                    auto: column.auto,
+                    label: column.label ?? columnName
+                }
+            ]))
+        }
+    ]));
+}
+function buildStorage(storage) {
+    return storage
+        ? {
+            buckets: Object.values(storage.buckets).map((bucket) => ({
+                name: bucket.name,
+                label: bucket.label ?? bucket.name,
+                maxSizeBytes: bucket.maxSizeBytes ?? null,
+                accept: bucket.accept ?? []
+            }))
+        }
+        : null;
+}
+// The rule handoff-consumer.ts's safeHandoffPath owns: one leading slash, no
+// backslash, no control character — a tab would let the URL parser read the
+// rest as a host.
+const handoffPathPattern = /^\/(?!\/)[^\\\x00-\x1f\x7f]*$/;
+function safeHandoffPath(value, fallback) {
+    return typeof value === "string" && handoffPathPattern.test(value) ? value : fallback;
+}
+function buildHandoff(config) {
+    if (config.handoff?.enabled !== true)
+        return null;
+    // The link points straight at the resource and lets its own handoff bounce
+    // mint the token. The generated Astro/EmDash template registers one sso
+    // resource (its CMS); switching between several should become an explicit UI
+    // instead of silently adding tabs.
+    const resource = config.handoff.resources?.find((candidate) => candidate.kind === "sso");
+    if (!resource?.id || !resource.origin)
+        return null;
+    try {
+        return { label: resource.label, href: new URL(safeHandoffPath(resource.returnTo, "/"), resource.origin).toString() };
+    }
+    catch {
+        return null;
+    }
+}
+export function buildAdminBoot(input) {
+    const schema = Object.fromEntries(Object.entries({
+        ...buildSchema(input.schema, false),
+        ...(input.systemSchema ? buildSchema(input.systemSchema, true) : {})
+    }));
+    return {
+        appName: input.config.appName,
+        schema,
+        storage: buildStorage(input.storage),
+        handoff: buildHandoff(input.config),
+        user: input.user,
+        roles: Array.from(new Set(["user", ...(input.config.roles ?? [])])),
+        operatorRoles: [
+            { value: "", label: "None" },
+            { value: "admin", label: "Admin" },
+            { value: "owner", label: "Owner" }
+        ],
+        local: input.local,
+        mcpEnabled: input.config.mcp?.enabled === true,
+        retrievalEnabled: input.retrieval === true,
+        searchEnabled: input.search === true,
+        notificationsEnabled: input.notificationsEnabled === true,
+        webPushEnabled: input.config.notifications?.webpush?.enabled === true,
+        agentsEnabled: input.agentsEnabled === true,
+        settings: input.settings ?? { app: false, user: false }
+    };
+}
+export function adminDocsBootFromAdminBoot(boot) {
+    return {
+        appName: boot.appName,
+        storage: boot.storage,
+        handoff: boot.handoff,
+        user: {
+            id: boot.user.id,
+            email: boot.user.email,
+            name: boot.user.name,
+            operatorRole: boot.user.operatorRole ?? null
+        },
+        local: boot.local,
+        mcpEnabled: boot.mcpEnabled,
+        retrievalEnabled: boot.retrievalEnabled,
+        searchEnabled: boot.searchEnabled,
+        notificationsEnabled: boot.notificationsEnabled,
+        webPushEnabled: boot.webPushEnabled,
+        agentsEnabled: boot.agentsEnabled,
+        settings: boot.settings
+    };
+}
+export function buildAdminDocsBoot(input) {
+    return adminDocsBootFromAdminBoot(buildAdminBoot(input));
+}
+//# sourceMappingURL=admin-boot.js.map

package/dist/admin-boot.js.map

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

package/dist/admin-docs-content.d.ts

@@ -0,0 +1,95 @@
+export type AdminDocCapability = "storage" | "mcpEnabled" | "searchEnabled" | "retrievalEnabled" | "notificationsEnabled" | "agentsEnabled" | "settings.app" | "settings.user";
+export type AdminDocRequirement = AdminDocCapability | {
+    all: AdminDocCapability[];
+} | {
+    any: AdminDocCapability[];
+};
+export type AdminDocBlock = {
+    kind: "heading";
+    level: 2 | 3;
+    text: string;
+} | {
+    kind: "paragraph";
+    text: string;
+} | {
+    kind: "list";
+    items: string[];
+};
+export type AdminDocPage = {
+    slug: string[];
+    title: string;
+    description: string;
+    category: string;
+    required?: AdminDocRequirement;
+    tags?: string[];
+    body: AdminDocBlock[];
+};
+export type AdminDocsBoot = {
+    appName: string;
+    storage: {
+        buckets: Array<{
+            name: string;
+            label: string;
+            maxSizeBytes: number | null;
+            accept: string[];
+        }>;
+    } | null;
+    user: {
+        id: string;
+        email: string;
+        name: string;
+        operatorRole: string | null;
+    };
+    local: boolean;
+    agentsEnabled?: boolean;
+    mcpEnabled?: boolean;
+    retrievalEnabled?: boolean;
+    searchEnabled?: boolean;
+    notificationsEnabled?: boolean;
+    settings?: {
+        app?: boolean;
+        user?: boolean;
+    };
+};
+export type AdminDocLookupResult = {
+    kind: "page";
+    page: AdminDocPage;
+} | {
+    kind: "disabled";
+    page: AdminDocPage;
+    missing: string[];
+} | {
+    kind: "notFound";
+};
+export type AdminDocSearchResult = {
+    page: AdminDocPage;
+    excerpt: string;
+};
+export type AdminDocMarkdownResult = {
+    kind: "markdown";
+    page: AdminDocPage;
+    markdown: string;
+} | {
+    kind: "disabled";
+    page: AdminDocPage;
+    missing: string[];
+} | {
+    kind: "notFound";
+};
+export declare const adminDocPages: AdminDocPage[];
+export declare function docPath(page: Pick<AdminDocPage, "slug">): string;
+export declare function docMarkdownPath(page: Pick<AdminDocPage, "slug">): string;
+export declare function slugKey(slug: string[]): string;
+export declare function capabilityEnabled(boot: AdminDocsBoot, capability: AdminDocCapability): boolean;
+export declare function requirementEnabled(boot: AdminDocsBoot, requirement: AdminDocRequirement | undefined): boolean;
+export declare function pageEnabled(boot: AdminDocsBoot, page: AdminDocPage): boolean;
+export declare function enabledAdminDocPages(boot: AdminDocsBoot): AdminDocPage[];
+export declare function capabilityLabel(capability: AdminDocCapability): string;
+export declare function missingRequirementLabels(boot: AdminDocsBoot, requirement: AdminDocRequirement | undefined): string[];
+export declare function findAdminDocPage(slug: string[]): AdminDocPage | undefined;
+export declare function resolveAdminDocPage(boot: AdminDocsBoot, slug: string[]): AdminDocLookupResult;
+export declare function adminDocSlugFromMarkdownPath(pathname: string): string[] | null;
+export declare function renderAdminDocMarkdown(page: AdminDocPage): string;
+export declare function resolveAdminDocMarkdown(boot: AdminDocsBoot, pathname: string): AdminDocMarkdownResult;
+export declare function searchAdminDocs(boot: AdminDocsBoot, query: string): AdminDocSearchResult[];
+//# sourceMappingURL=admin-docs-content.d.ts.map

package/dist/admin-docs-content.d.ts.map

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