@dudousxd/nestjs-telescope-ui 1.0.0

package/dist/server/telescope-ui.controller.js

@@ -0,0 +1,105 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, extname, join, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { normalizeTelescopePath } from '@dudousxd/nestjs-telescope';
+import { Controller, Get, Header, Inject, NotFoundException, Param, StreamableFile, } from '@nestjs/common';
+import { TELESCOPE_UI_OPTIONS } from './telescope-ui.options.js';
+/** dist/server/telescope-ui.controller.js -> ../spa */
+function defaultAssetsDir() {
+    return fileURLToPath(new URL('../spa', import.meta.url));
+}
+const CONTENT_TYPES = {
+    '.js': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.json': 'application/json; charset=utf-8',
+    '.ico': 'image/x-icon',
+};
+/**
+ * The SPA is built once with a fixed Vite `base` of `/telescope/`, so every
+ * asset URL in the built index.html is hardcoded to that placeholder. When the
+ * dashboard is mounted under a custom path we rewrite those occurrences at serve
+ * time instead of rebuilding the bundle per-path. When the path is the default
+ * `'telescope'` the source and target strings are identical, so this is a no-op.
+ */
+function rewriteAssetBase(html, path) {
+    const injectedBase = `<script>window.__TELESCOPE_BASE__ = ${JSON.stringify(`/${path}`)};</script>`;
+    const rebased = html.split('/telescope/').join(`/${path}/`);
+    // Expose the runtime base before the bundle so the client can derive API URLs.
+    if (rebased.includes('</head>')) {
+        return rebased.replace('</head>', `${injectedBase}</head>`);
+    }
+    return `${injectedBase}${rebased}`;
+}
+let TelescopeUiController = class TelescopeUiController {
+    assetsDir;
+    path;
+    constructor(options) {
+        this.assetsDir = options.assetsDir ?? defaultAssetsDir();
+        this.path = normalizeTelescopePath(options.path);
+    }
+    // index.html references hash-named asset bundles. It MUST NOT be cached, or a
+    // browser keeps loading a stale bundle across deploys (the classic "one widget
+    // stuck loading / old labels after an upgrade"). The hashed assets below are
+    // immutable and cached forever instead.
+    index() {
+        const indexPath = join(this.assetsDir, 'index.html');
+        if (!existsSync(indexPath)) {
+            throw new NotFoundException('Telescope UI is not built. Run the package build.');
+        }
+        return rewriteAssetBase(readFileSync(indexPath, 'utf8'), this.path);
+    }
+    // Asset filenames are content-hashed by the build, so they're safe to cache
+    // forever — a new bundle gets a new filename referenced by the (uncached) index.
+    asset(file) {
+        // Trust assumption: assetsDir holds build-produced files (not user-writable).
+        // The basename + resolved-prefix checks below still prevent escaping assets/.
+        // basename strips any path components, defeating traversal (../, nested, encoded).
+        const safe = basename(file);
+        if (safe !== file)
+            throw new NotFoundException();
+        const root = resolve(this.assetsDir, 'assets');
+        const assetPath = resolve(root, safe);
+        if (!assetPath.startsWith(root + sep) || !existsSync(assetPath)) {
+            throw new NotFoundException();
+        }
+        const type = CONTENT_TYPES[extname(safe)] ?? 'application/octet-stream';
+        return new StreamableFile(readFileSync(assetPath), { type });
+    }
+};
+__decorate([
+    Get(),
+    Header('Content-Type', 'text/html; charset=utf-8'),
+    Header('Cache-Control', 'no-store, must-revalidate'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", String)
+], TelescopeUiController.prototype, "index", null);
+__decorate([
+    Get('assets/:file'),
+    Header('Cache-Control', 'public, max-age=31536000, immutable'),
+    __param(0, Param('file')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", StreamableFile)
+], TelescopeUiController.prototype, "asset", null);
+TelescopeUiController = __decorate([
+    Controller(),
+    __param(0, Inject(TELESCOPE_UI_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], TelescopeUiController);
+export { TelescopeUiController };
+//# sourceMappingURL=telescope-ui.controller.js.map

package/dist/server/telescope-ui.controller.js.map

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

package/dist/server/telescope-ui.module.d.ts

@@ -0,0 +1,6 @@
+import { type DynamicModule } from '@nestjs/common';
+import { type TelescopeUiModuleOptions } from './telescope-ui.options.js';
+export declare class TelescopeUiModule {
+    static forRoot(options?: TelescopeUiModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=telescope-ui.module.d.ts.map

package/dist/server/telescope-ui.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-ui.module.d.ts","sourceRoot":"","sources":["../../src/server/telescope-ui.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAEhG,qBACa,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,wBAA6B,GAAG,aAAa;CAQtE"}

package/dist/server/telescope-ui.module.js

@@ -0,0 +1,26 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var TelescopeUiModule_1;
+import { dynamicController, normalizeTelescopePath } from '@dudousxd/nestjs-telescope';
+import { Module } from '@nestjs/common';
+import { TelescopeUiController } from './telescope-ui.controller.js';
+import { TELESCOPE_UI_OPTIONS } from './telescope-ui.options.js';
+let TelescopeUiModule = TelescopeUiModule_1 = class TelescopeUiModule {
+    static forRoot(options = {}) {
+        const path = normalizeTelescopePath(options.path);
+        return {
+            module: TelescopeUiModule_1,
+            controllers: [dynamicController(TelescopeUiController, path)],
+            providers: [{ provide: TELESCOPE_UI_OPTIONS, useValue: options }],
+        };
+    }
+};
+TelescopeUiModule = TelescopeUiModule_1 = __decorate([
+    Module({})
+], TelescopeUiModule);
+export { TelescopeUiModule };
+//# sourceMappingURL=telescope-ui.module.js.map

package/dist/server/telescope-ui.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-ui.module.js","sourceRoot":"","sources":["../../src/server/telescope-ui.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAiC,MAAM,2BAA2B,CAAC;AAGzF,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B,MAAM,CAAC,OAAO,CAAC,UAAoC,EAAE;QACnD,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,WAAW,EAAE,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;YAC7D,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC;CACF,CAAA;AATY,iBAAiB;IAD7B,MAAM,CAAC,EAAE,CAAC;GACE,iBAAiB,CAS7B"}

package/dist/server/telescope-ui.options.d.ts

@@ -0,0 +1,12 @@
+export declare const TELESCOPE_UI_OPTIONS: unique symbol;
+export interface TelescopeUiModuleOptions {
+    /** Directory of the built SPA (index.html + assets/). Defaults to the bundled dist/spa. */
+    assetsDir?: string;
+    /**
+     * Mount path for the dashboard (no leading/trailing slash needed). Defaults to
+     * `'telescope'` — when unset the dashboard lives at `/telescope` exactly as
+     * before. Must match the core `TelescopeModule.forRoot({ path })`.
+     */
+    path?: string;
+}
+//# sourceMappingURL=telescope-ui.options.d.ts.map

package/dist/server/telescope-ui.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-ui.options.d.ts","sourceRoot":"","sources":["../../src/server/telescope-ui.options.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/server/telescope-ui.options.js

@@ -0,0 +1,2 @@
+export const TELESCOPE_UI_OPTIONS = Symbol('TELESCOPE_UI_OPTIONS');
+//# sourceMappingURL=telescope-ui.options.js.map

package/dist/server/telescope-ui.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-ui.options.js","sourceRoot":"","sources":["../../src/server/telescope-ui.options.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC"}