@shardworks/oculus-apparatus 0.1.128

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Sean Boots
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @shardworks/oculus-apparatus — The Oculus.
+ *
+ * Web dashboard apparatus for the guild. Serves pages contributed by plugins,
+ * exposes guild tools as REST endpoints, and provides a unified web interface.
+ */
+export { type OculusApi, type OculusConfig, type OculusKit, type PageContribution, type RouteContribution, } from './types.ts';
+export { createOculus } from './oculus.ts';
+import type { OculusConfig } from './types.ts';
+declare module '@shardworks/nexus-core' {
+    interface GuildConfig {
+        oculus?: OculusConfig;
+    }
+}
+declare const _default: import("@shardworks/nexus-core").Plugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,WAAW;QACnB,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB;CACF;;AAED,wBAA8B"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @shardworks/oculus-apparatus — The Oculus.
+ *
+ * Web dashboard apparatus for the guild. Serves pages contributed by plugins,
+ * exposes guild tools as REST endpoints, and provides a unified web interface.
+ */
+import { createOculus } from "./oculus.js";
+export {} from "./types.js";
+export { createOculus } from "./oculus.js";
+export default createOculus();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAMN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,eAAe,YAAY,EAAE,CAAC"}

package/dist/oculus.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The Oculus — web dashboard apparatus.
+ *
+ * Serves a web dashboard via Hono. Plugins contribute pages as static asset
+ * directories and custom API routes through kit contributions. Guild tools are
+ * automatically exposed as REST endpoints.
+ */
+import { z } from 'zod';
+import type { Plugin } from '@shardworks/nexus-core';
+export declare function toolNameToRoute(name: string): string;
+export declare function permissionToMethod(permission: string | undefined): 'GET' | 'POST' | 'DELETE';
+export declare function coerceParams(shape: Record<string, z.ZodTypeAny>, params: Record<string, string>): Record<string, unknown>;
+export declare function injectChrome(html: string, stylesheetPath: string, navHtml: string): string;
+export declare function createOculus(): Plugin;
+//# sourceMappingURL=oculus.d.ts.map

package/dist/oculus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oculus.d.ts","sourceRoot":"","sources":["../src/oculus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAA8C,MAAM,wBAAwB,CAAC;AAiCjG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAS5F;AAoBD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,EACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA4B1F;AAgED,wBAAgB,YAAY,IAAI,MAAM,CAsVrC"}

package/dist/oculus.js

@@ -0,0 +1,466 @@
+/**
+ * The Oculus — web dashboard apparatus.
+ *
+ * Serves a web dashboard via Hono. Plugins contribute pages as static asset
+ * directories and custom API routes through kit contributions. Guild tools are
+ * automatically exposed as REST endpoints.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { Hono } from 'hono';
+import { serve } from '@hono/node-server';
+import { z } from 'zod';
+import { guild } from '@shardworks/nexus-core';
+// ── MIME types ────────────────────────────────────────────────────────
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.map': 'application/json',
+};
+function getMimeType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return MIME_TYPES[ext] ?? 'application/octet-stream';
+}
+// ── Tool→REST mapping helpers ─────────────────────────────────────────
+export function toolNameToRoute(name) {
+    const idx = name.indexOf('-');
+    if (idx === -1)
+        return `/api/${name}`;
+    return `/api/${name.slice(0, idx)}/${name.slice(idx + 1)}`;
+}
+export function permissionToMethod(permission) {
+    if (permission === undefined)
+        return 'GET';
+    const level = permission.includes(':')
+        ? permission.slice(permission.lastIndexOf(':') + 1)
+        : permission;
+    if (level === 'read')
+        return 'GET';
+    if (level === 'write' || level === 'admin')
+        return 'POST';
+    if (level === 'delete')
+        return 'DELETE';
+    return 'POST';
+}
+// ── Query param coercion ──────────────────────────────────────────────
+function isNumberSchema(schema) {
+    let inner = schema;
+    if (inner instanceof z.ZodOptional)
+        inner = inner.unwrap();
+    if (inner instanceof z.ZodDefault)
+        inner = inner.unwrap();
+    if (inner instanceof z.ZodOptional)
+        inner = inner.unwrap();
+    return inner instanceof z.ZodNumber;
+}
+function isBooleanSchema(schema) {
+    let inner = schema;
+    if (inner instanceof z.ZodOptional)
+        inner = inner.unwrap();
+    if (inner instanceof z.ZodDefault)
+        inner = inner.unwrap();
+    if (inner instanceof z.ZodOptional)
+        inner = inner.unwrap();
+    return inner instanceof z.ZodBoolean;
+}
+export function coerceParams(shape, params) {
+    const result = { ...params };
+    for (const [key, schema] of Object.entries(shape)) {
+        const value = result[key];
+        if (typeof value !== 'string')
+            continue;
+        if (isNumberSchema(schema)) {
+            result[key] = Number(value);
+        }
+        else if (isBooleanSchema(schema)) {
+            result[key] = value === 'true';
+        }
+    }
+    return result;
+}
+// ── Chrome injection ─────────────────────────────────────────────────
+export function injectChrome(html, stylesheetPath, navHtml) {
+    // Check for </head> case-insensitively
+    const headCloseMatch = html.match(/<\/head>/i);
+    const bodyOpenMatch = html.match(/<body[^>]*>/i);
+    // If neither tag present, return unmodified
+    if (!headCloseMatch && !bodyOpenMatch)
+        return html;
+    let result = html;
+    // Insert stylesheet link before </head>
+    if (headCloseMatch && headCloseMatch.index !== undefined) {
+        const idx = headCloseMatch.index;
+        result =
+            result.slice(0, idx) +
+                `<link rel="stylesheet" href="${stylesheetPath}">` +
+                result.slice(idx);
+    }
+    // Insert nav after <body...>
+    // Need to recalculate position after potential head insertion
+    const bodyMatch = result.match(/<body[^>]*>/i);
+    if (bodyMatch && bodyMatch.index !== undefined) {
+        const idx = bodyMatch.index + bodyMatch[0].length;
+        result = result.slice(0, idx) + navHtml + result.slice(idx);
+    }
+    return result;
+}
+function buildNavHtml(pages) {
+    const pageLinks = pages
+        .map((p) => `<a href="/pages/${p.id}/">${p.title}</a>`)
+        .join('\n  ');
+    return `<nav id="oculus-nav">
+  <a href="/">Guild</a>
+  ${pageLinks}
+</nav>`;
+}
+function zodTypeToJsonType(zodType) {
+    if (zodType instanceof z.ZodString)
+        return 'string';
+    if (zodType instanceof z.ZodNumber)
+        return 'number';
+    if (zodType instanceof z.ZodBoolean)
+        return 'boolean';
+    if (zodType instanceof z.ZodArray)
+        return 'array';
+    if (zodType instanceof z.ZodObject)
+        return 'object';
+    if (zodType instanceof z.ZodEnum)
+        return 'string';
+    if (zodType instanceof z.ZodLiteral)
+        return typeof zodType._def.values[0];
+    if (zodType instanceof z.ZodUnion)
+        return 'union';
+    if (zodType instanceof z.ZodNullable)
+        return zodTypeToJsonType(zodType.unwrap());
+    return 'unknown';
+}
+function extractSingleParam(zodType) {
+    let isOptional = false;
+    let inner = zodType;
+    if (inner instanceof z.ZodOptional) {
+        isOptional = true;
+        inner = inner.unwrap();
+    }
+    if (inner instanceof z.ZodDefault) {
+        isOptional = true;
+        inner = inner.unwrap();
+    }
+    return {
+        type: zodTypeToJsonType(inner),
+        description: inner.description ?? null,
+        optional: isOptional,
+    };
+}
+function extractParams(schema) {
+    const shape = schema.shape;
+    const result = {};
+    for (const [key, zodType] of Object.entries(shape)) {
+        result[key] = extractSingleParam(zodType);
+    }
+    return result;
+}
+// ── Apparatus factory ─────────────────────────────────────────────────
+export function createOculus() {
+    let serverPort = 7470;
+    let server = null;
+    const api = {
+        port() {
+            return serverPort;
+        },
+    };
+    return {
+        apparatus: {
+            requires: ['tools'],
+            consumes: ['pages', 'routes'],
+            provides: api,
+            async start(ctx) {
+                const g = guild();
+                const oculusConfig = g.guildConfig().oculus ?? {};
+                const port = oculusConfig.port ?? 7470;
+                const app = new Hono();
+                // Track registered pages and custom route paths
+                const pages = [];
+                const customRoutePaths = new Set();
+                const mappedToolRoutes = new Set();
+                // ── Custom route registration helper ─────────────────────────
+                function registerCustomRoute(route, pluginId) {
+                    if (!route.path.startsWith('/api/')) {
+                        console.warn(`[oculus] Custom route "${route.path}" from "${pluginId}" must start with /api/ — skipped`);
+                        return;
+                    }
+                    const method = route.method.toLowerCase();
+                    app[method](route.path, route.handler);
+                    customRoutePaths.add(route.path);
+                }
+                // ── Page serving helper ───────────────────────────────────────
+                function resolveDirForPackage(packageName, dir) {
+                    return path.join(g.home, 'node_modules', packageName, dir);
+                }
+                function registerPage(page, resolvedDir) {
+                    pages.push({ ...page });
+                    app.get(`/pages/${page.id}/*`, async (c) => {
+                        const requestPath = c.req.path;
+                        const prefix = `/pages/${page.id}/`;
+                        const filePath = requestPath.slice(prefix.length) || 'index.html';
+                        // Prevent directory traversal
+                        if (filePath.includes('..')) {
+                            return c.text('Not found', 404);
+                        }
+                        const absolutePath = path.join(resolvedDir, filePath);
+                        // Ensure file is within resolved dir
+                        if (!absolutePath.startsWith(resolvedDir)) {
+                            return c.text('Not found', 404);
+                        }
+                        try {
+                            const content = fs.readFileSync(absolutePath);
+                            const mimeType = getMimeType(absolutePath);
+                            // Only inject chrome for the root index.html
+                            const isIndexHtml = filePath === 'index.html' || filePath === '';
+                            if (isIndexHtml && mimeType.startsWith('text/html')) {
+                                const html = content.toString('utf-8');
+                                const navHtml = buildNavHtml(pages);
+                                const injected = injectChrome(html, '/static/style.css', navHtml);
+                                return new Response(injected, {
+                                    headers: { 'Content-Type': 'text/html; charset=utf-8' },
+                                });
+                            }
+                            return new Response(content, {
+                                headers: { 'Content-Type': mimeType },
+                            });
+                        }
+                        catch {
+                            return c.text('Not found', 404);
+                        }
+                    });
+                }
+                // ── Tool route registration helper ───────────────────────────
+                function registerToolRoute(toolDef, instrumentarium) {
+                    const routePath = toolNameToRoute(toolDef.name);
+                    const method = permissionToMethod(toolDef.permission);
+                    if (mappedToolRoutes.has(routePath))
+                        return;
+                    if (customRoutePaths.has(routePath)) {
+                        console.warn(`[oculus] Tool route ${method} ${routePath} conflicts with custom route from plugin — skipped`);
+                        return;
+                    }
+                    void instrumentarium; // suppress unused warning
+                    const shape = toolDef.params.shape;
+                    if (method === 'GET') {
+                        app.get(routePath, async (c) => {
+                            try {
+                                const rawQuery = c.req.query();
+                                const coerced = coerceParams(shape, rawQuery);
+                                const validated = toolDef.params.parse(coerced);
+                                const result = await toolDef.handler(validated);
+                                return c.json(result);
+                            }
+                            catch (err) {
+                                if (err instanceof z.ZodError) {
+                                    return c.json({ error: err.message, details: err.issues }, 400);
+                                }
+                                const message = err instanceof Error ? err.message : String(err);
+                                return c.json({ error: message }, 500);
+                            }
+                        });
+                    }
+                    else if (method === 'DELETE') {
+                        app.delete(routePath, async (c) => {
+                            try {
+                                const body = await c.req.json();
+                                const validated = toolDef.params.parse(body);
+                                const result = await toolDef.handler(validated);
+                                return c.json(result);
+                            }
+                            catch (err) {
+                                if (err instanceof z.ZodError) {
+                                    return c.json({ error: err.message, details: err.issues }, 400);
+                                }
+                                const message = err instanceof Error ? err.message : String(err);
+                                return c.json({ error: message }, 500);
+                            }
+                        });
+                    }
+                    else {
+                        app.post(routePath, async (c) => {
+                            try {
+                                const body = await c.req.json();
+                                const validated = toolDef.params.parse(body);
+                                const result = await toolDef.handler(validated);
+                                return c.json(result);
+                            }
+                            catch (err) {
+                                if (err instanceof z.ZodError) {
+                                    return c.json({ error: err.message, details: err.issues }, 400);
+                                }
+                                const message = err instanceof Error ? err.message : String(err);
+                                return c.json({ error: message }, 500);
+                            }
+                        });
+                    }
+                    mappedToolRoutes.add(routePath);
+                }
+                // ── Scan contributions from a kit ────────────────────────────
+                function scanKit(kit) {
+                    const oculusKit = kit.kit;
+                    if (oculusKit.routes) {
+                        for (const route of oculusKit.routes) {
+                            registerCustomRoute(route, kit.id);
+                        }
+                    }
+                    if (oculusKit.pages) {
+                        for (const page of oculusKit.pages) {
+                            const resolvedDir = resolveDirForPackage(kit.packageName, page.dir);
+                            registerPage(page, resolvedDir);
+                        }
+                    }
+                }
+                function scanApparatus(apparatus) {
+                    if (!apparatus.apparatus.supportKit)
+                        return;
+                    const oculusKit = apparatus.apparatus.supportKit;
+                    if (oculusKit.routes) {
+                        for (const route of oculusKit.routes) {
+                            registerCustomRoute(route, apparatus.id);
+                        }
+                    }
+                    if (oculusKit.pages) {
+                        for (const page of oculusKit.pages) {
+                            const resolvedDir = resolveDirForPackage(apparatus.packageName, page.dir);
+                            registerPage(page, resolvedDir);
+                        }
+                    }
+                }
+                // ── Scan existing kits and apparatuses ───────────────────────
+                for (const kit of g.kits()) {
+                    scanKit(kit);
+                }
+                for (const apparatus of g.apparatuses()) {
+                    scanApparatus(apparatus);
+                }
+                // ── Register custom routes first ─────────────────────────────
+                // (already done in scanKit/scanApparatus above)
+                // ── Register tool routes ─────────────────────────────────────
+                const instrumentarium = g.apparatus('tools');
+                const allTools = instrumentarium.list();
+                const patronTools = allTools.filter((r) => !r.definition.callableBy || r.definition.callableBy.includes('patron'));
+                for (const resolved of patronTools) {
+                    registerToolRoute(resolved.definition, instrumentarium);
+                }
+                // ── GET /api/_tools ──────────────────────────────────────────
+                app.get('/api/_tools', (c) => {
+                    const tools = instrumentarium.list().filter((r) => !r.definition.callableBy || r.definition.callableBy.includes('patron'));
+                    const entries = tools.map((r) => ({
+                        name: r.definition.name,
+                        route: toolNameToRoute(r.definition.name),
+                        method: permissionToMethod(r.definition.permission),
+                        description: r.definition.description,
+                        params: extractParams(r.definition.params),
+                    }));
+                    return c.json(entries);
+                });
+                // ── Static assets ────────────────────────────────────────────
+                const staticDir = path.join(import.meta.dirname, 'static');
+                app.get('/static/*', (c) => {
+                    const requestPath = c.req.path;
+                    const filePath = requestPath.slice('/static/'.length);
+                    if (filePath.includes('..')) {
+                        return c.text('Not found', 404);
+                    }
+                    const absolutePath = path.join(staticDir, filePath);
+                    try {
+                        const content = fs.readFileSync(absolutePath);
+                        const mimeType = getMimeType(absolutePath);
+                        return new Response(content, {
+                            headers: { 'Content-Type': mimeType },
+                        });
+                    }
+                    catch {
+                        return c.text('Not found', 404);
+                    }
+                });
+                // ── Home page ────────────────────────────────────────────────
+                app.get('/', (c) => {
+                    const guildName = g.guildConfig().name;
+                    const navHtml = buildNavHtml(pages);
+                    const pageLinks = pages.length > 0
+                        ? pages
+                            .map((p) => `<li><a href="/pages/${p.id}/">${p.title}</a></li>`)
+                            .join('\n        ')
+                        : '<li class="empty-state">No pages registered.</li>';
+                    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${guildName} — Guild Dashboard</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body>
+${navHtml}
+<main style="padding: 24px;">
+  <h1>${guildName}</h1>
+  <div class="card">
+    <h2>Pages</h2>
+    <ul>
+        ${pageLinks}
+    </ul>
+  </div>
+</main>
+</body>
+</html>`;
+                    return c.html(html);
+                });
+                // ── Late-arriving plugins ─────────────────────────────────────
+                ctx.on('plugin:initialized', (plugin) => {
+                    const loaded = plugin;
+                    if ('apparatus' in loaded) {
+                        scanApparatus(loaded);
+                    }
+                    else if ('kit' in loaded) {
+                        scanKit(loaded);
+                    }
+                    // Check for new patron-callable tools
+                    const currentTools = instrumentarium.list().filter((r) => !r.definition.callableBy || r.definition.callableBy.includes('patron'));
+                    for (const resolved of currentTools) {
+                        registerToolRoute(resolved.definition, instrumentarium);
+                    }
+                });
+                // ── Start HTTP server ─────────────────────────────────────────
+                await new Promise((resolve, reject) => {
+                    server = serve({ fetch: app.fetch, port }, () => {
+                        serverPort = port;
+                        console.log(`[oculus] Listening on http://localhost:${port}`);
+                        resolve();
+                    });
+                    server.on('error', reject);
+                });
+            },
+            async stop() {
+                if (server) {
+                    await new Promise((resolve, reject) => {
+                        server.close((err) => {
+                            if (err)
+                                reject(err);
+                            else
+                                resolve();
+                        });
+                    });
+                    server = null;
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=oculus.js.map

package/dist/oculus.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+import type { Context } from 'hono';
+/** A page contributed by a plugin kit or apparatus supportKit. */
+export interface PageContribution {
+    /** Unique page ID — becomes the URL segment: /pages/{id}/ */
+    id: string;
+    /** Human-readable title used in navigation. */
+    title: string;
+    /**
+     * Path to the directory containing the page's static assets,
+     * relative to the contributing package's root in node_modules.
+     * Must contain an index.html entry point.
+     */
+    dir: string;
+}
+/** A custom route contributed by a plugin kit or apparatus supportKit. */
+export interface RouteContribution {
+    /** HTTP method (uppercase): 'GET', 'POST', 'DELETE', etc. */
+    method: string;
+    /** Hono path pattern. Must begin with /api/. */
+    path: string;
+    /** Hono handler function. */
+    handler: (c: Context) => Response | Promise<Response>;
+}
+/** Kit contribution interface — consumed by the Oculus. */
+export interface OculusKit {
+    pages?: PageContribution[];
+    routes?: RouteContribution[];
+}
+/** The Oculus configuration from guild.json under 'oculus'. */
+export interface OculusConfig {
+    /** Port to listen on. Default: 7470. */
+    port?: number;
+}
+/** The Oculus's public API, exposed via provides. */
+export interface OculusApi {
+    /** The port the server is listening on. */
+    port(): number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvD;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,IAAI,IAAI,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@shardworks/oculus-apparatus",
+  "version": "0.1.128",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shardworks/nexus",
+    "directory": "packages/plugins/oculus"
+  },
+  "description": "The Oculus — web dashboard apparatus for the guild",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.13.7",
+    "hono": "^4.7.11",
+    "zod": "4.3.6",
+    "@shardworks/nexus-core": "0.1.128",
+    "@shardworks/tools-apparatus": "0.1.128"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --disable-warning=ExperimentalWarning --experimental-transform-types --test 'src/**/*.test.ts'",
+    "typecheck": "tsc --noEmit"
+  }
+}