@saasicat/nest 0.2.0

package/dist/discovery.scanner-CUYLKlYT.d.cts

@@ -0,0 +1,59 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { DiscoveryService, MetadataScanner, Reflector } from '@nestjs/core';
+import { DiscoverySnapshot } from '@saasicat/types';
+
+/**
+ * App identity that the scanner carries into the snapshot. The consumer
+ * provides this during module setup so that the snapshot carries a unique
+ * `app.key` + `app.version`.
+ */
+interface DiscoveryAppInfo {
+    key: string;
+    version: string;
+}
+/**
+ * DI token for the app identity. The consumer binds this via
+ * `DiscoveryModule.forRoot({ app: { key, version } })`.
+ */
+declare const DISCOVERY_APP_INFO_TOKEN: unique symbol;
+/**
+ * DI token for an optional snapshot persistence path. Written by the
+ * DiscoveryScanner at boot — consumers (e.g. CI gates, Preflight CLIs) can
+ * read the JSON file without running a full module boot themselves.
+ */
+declare const DISCOVERY_SNAPSHOT_PATH_TOKEN: unique symbol;
+declare class DiscoveryScanner implements OnApplicationBootstrap {
+    private readonly discoveryService;
+    private readonly metadataScanner;
+    private readonly reflector;
+    private readonly appInfo;
+    private readonly snapshotPath;
+    private readonly logger;
+    private snapshot;
+    constructor(discoveryService: DiscoveryService, metadataScanner: MetadataScanner, reflector: Reflector, appInfo?: DiscoveryAppInfo, snapshotPath?: string | null);
+    onApplicationBootstrap(): void;
+    private persistSnapshot;
+    /**
+     * Returns the boot-time snapshot. Before `onApplicationBootstrap` (e.g. in
+     * tests) the snapshot is built lazily.
+     */
+    getSnapshot(): DiscoverySnapshot;
+    /**
+     * Forces a re-scan (SuperAdmin "re-run discovery" or tests with
+     * dynamically registered providers). `scannedAt` is set anew and the
+     * snapshot — as at boot — is persisted to disk so that the last scan
+     * actually performed is preserved.
+     */
+    rebuildSnapshot(): DiscoverySnapshot;
+    private buildSnapshot;
+    private registerCapability;
+    private registerQuota;
+}
+/**
+ * Canonical hash over the business snapshot data — without `scannedAt` and
+ * `app.version`, so that the same code produces the same hash on re-boot.
+ * Pattern from SPEC.md Q2 (Q2: "Stable manifestHash across boot restarts").
+ */
+declare function computeSnapshotHash(snapshot: Omit<DiscoverySnapshot, 'hash'>): string;
+
+export { type DiscoveryAppInfo as D, DISCOVERY_APP_INFO_TOKEN as a, DISCOVERY_SNAPSHOT_PATH_TOKEN as b, DiscoveryScanner as c, computeSnapshotHash as d };

package/dist/discovery.scanner-CUYLKlYT.d.ts

@@ -0,0 +1,59 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { DiscoveryService, MetadataScanner, Reflector } from '@nestjs/core';
+import { DiscoverySnapshot } from '@saasicat/types';
+
+/**
+ * App identity that the scanner carries into the snapshot. The consumer
+ * provides this during module setup so that the snapshot carries a unique
+ * `app.key` + `app.version`.
+ */
+interface DiscoveryAppInfo {
+    key: string;
+    version: string;
+}
+/**
+ * DI token for the app identity. The consumer binds this via
+ * `DiscoveryModule.forRoot({ app: { key, version } })`.
+ */
+declare const DISCOVERY_APP_INFO_TOKEN: unique symbol;
+/**
+ * DI token for an optional snapshot persistence path. Written by the
+ * DiscoveryScanner at boot — consumers (e.g. CI gates, Preflight CLIs) can
+ * read the JSON file without running a full module boot themselves.
+ */
+declare const DISCOVERY_SNAPSHOT_PATH_TOKEN: unique symbol;
+declare class DiscoveryScanner implements OnApplicationBootstrap {
+    private readonly discoveryService;
+    private readonly metadataScanner;
+    private readonly reflector;
+    private readonly appInfo;
+    private readonly snapshotPath;
+    private readonly logger;
+    private snapshot;
+    constructor(discoveryService: DiscoveryService, metadataScanner: MetadataScanner, reflector: Reflector, appInfo?: DiscoveryAppInfo, snapshotPath?: string | null);
+    onApplicationBootstrap(): void;
+    private persistSnapshot;
+    /**
+     * Returns the boot-time snapshot. Before `onApplicationBootstrap` (e.g. in
+     * tests) the snapshot is built lazily.
+     */
+    getSnapshot(): DiscoverySnapshot;
+    /**
+     * Forces a re-scan (SuperAdmin "re-run discovery" or tests with
+     * dynamically registered providers). `scannedAt` is set anew and the
+     * snapshot — as at boot — is persisted to disk so that the last scan
+     * actually performed is preserved.
+     */
+    rebuildSnapshot(): DiscoverySnapshot;
+    private buildSnapshot;
+    private registerCapability;
+    private registerQuota;
+}
+/**
+ * Canonical hash over the business snapshot data — without `scannedAt` and
+ * `app.version`, so that the same code produces the same hash on re-boot.
+ * Pattern from SPEC.md Q2 (Q2: "Stable manifestHash across boot restarts").
+ */
+declare function computeSnapshotHash(snapshot: Omit<DiscoverySnapshot, 'hash'>): string;
+
+export { type DiscoveryAppInfo as D, DISCOVERY_APP_INFO_TOKEN as a, DISCOVERY_SNAPSHOT_PATH_TOKEN as b, DiscoveryScanner as c, computeSnapshotHash as d };