@heavybit/pendoadmin-shared-lib 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -6,4 +6,6 @@ export * from './config/index.js';
 export * from './messaging/index.js';
 export * from './database/index.js';
 export * from './express/index.js';
+export * from './rate-limit/index.js';
+export * from './scheduling/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -14,4 +14,8 @@ export * from './messaging/index.js';
 export * from './database/index.js';
 // Express middleware (for Express-based services)
 export * from './express/index.js';
+// Rate limiting
+export * from './rate-limit/index.js';
+// Scheduling
+export * from './scheduling/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,mBAAmB;AACnB,cAAc,mBAAmB,CAAC;AAElC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,WAAW;AACX,cAAc,qBAAqB,CAAC;AAEpC,kDAAkD;AAClD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,mBAAmB;AACnB,cAAc,mBAAmB,CAAC;AAElC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,WAAW;AACX,cAAc,qBAAqB,CAAC;AAEpC,kDAAkD;AAClD,cAAc,oBAAoB,CAAC;AAEnC,gBAAgB;AAChB,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,uBAAuB,CAAC"}

package/dist/rate-limit/create-rate-limiter.d.ts

@@ -0,0 +1,23 @@
+import { Request, Response, NextFunction } from "express";
+import { RateLimiterAbstract } from "rate-limiter-flexible";
+import type Redis from "ioredis";
+export interface RateLimitConfig {
+    /** Max requests per window (default: 100) */
+    maxRequests?: number;
+    /** Window duration in milliseconds (default: 60 000) */
+    windowMs?: number;
+    /** Redis key prefix — use unique per service to avoid collisions (default: "rl:service") */
+    keyPrefix?: string;
+    /** Optional Redis client — falls back to in-memory if omitted */
+    redisClient?: Redis | null;
+    /** Extract the rate-limit key from the request. Default: X-User-Id header → IP → "unknown" */
+    keyExtractor?: (req: Request) => string;
+}
+export interface RateLimitResult {
+    /** The rate-limiter instance (for advanced use) */
+    limiter: RateLimiterAbstract;
+    /** Express middleware */
+    middleware: (req: Request, res: Response, next: NextFunction) => Promise<void>;
+}
+export declare function createRateLimiter(cfg?: RateLimitConfig): RateLimitResult;
+//# sourceMappingURL=create-rate-limiter.d.ts.map

package/dist/rate-limit/create-rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-rate-limiter.d.ts","sourceRoot":"","sources":["../../src/rate-limit/create-rate-limiter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAuC,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAIjC,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,8FAA8F;IAC9F,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,yBAAyB;IACzB,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAID,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,eAAoB,GAAG,eAAe,CAmE5E"}

package/dist/rate-limit/create-rate-limiter.js

@@ -0,0 +1,60 @@
+// pendoadmin-shared-lib/src/rate-limit/create-rate-limiter.ts
+//
+// Factory that creates a dual-layer (Redis + memory fallback) rate limiter.
+// Available for any Express-based service.
+import { RateLimiterRedis, RateLimiterMemory } from "rate-limiter-flexible";
+// ─── Factory ────────────────────────────────────────────
+export function createRateLimiter(cfg = {}) {
+    const { maxRequests = 100, windowMs = 60_000, keyPrefix = "rl:service", redisClient = null, keyExtractor = defaultKeyExtractor, } = cfg;
+    const durationSecs = Math.max(1, Math.round(windowMs / 1000));
+    const memoryLimiter = new RateLimiterMemory({
+        keyPrefix,
+        points: maxRequests,
+        duration: durationSecs,
+    });
+    let limiter;
+    if (redisClient) {
+        limiter = new RateLimiterRedis({
+            storeClient: redisClient,
+            keyPrefix,
+            points: maxRequests,
+            duration: durationSecs,
+            blockDuration: 0,
+            insuranceLimiter: memoryLimiter,
+        });
+    }
+    else {
+        limiter = memoryLimiter;
+    }
+    // ─── Middleware ──────────────────────────────────────
+    async function middleware(req, res, next) {
+        try {
+            const key = keyExtractor(req);
+            const result = await limiter.consume(key);
+            res.setHeader("X-RateLimit-Limit", maxRequests);
+            res.setHeader("X-RateLimit-Remaining", result.remainingPoints);
+            res.setHeader("X-RateLimit-Reset", new Date(Date.now() + result.msBeforeNext).toISOString());
+            next();
+        }
+        catch (rejRes) {
+            // Non-rate-limit errors should not block traffic
+            if (typeof rejRes?.msBeforeNext !== "number") {
+                console.error(`[RateLimit:${keyPrefix}] Unexpected error:`, rejRes?.message || rejRes);
+                return next();
+            }
+            res.setHeader("X-RateLimit-Limit", maxRequests);
+            res.setHeader("X-RateLimit-Remaining", 0);
+            res.setHeader("Retry-After", Math.ceil(rejRes.msBeforeNext / 1000));
+            res.status(429).json({
+                success: false,
+                message: "Too many requests. Please try again later.",
+            });
+        }
+    }
+    return { limiter, middleware };
+}
+// ─── Defaults ───────────────────────────────────────────
+function defaultKeyExtractor(req) {
+    return req.headers["x-user-id"] || req.ip || "unknown";
+}
+//# sourceMappingURL=create-rate-limiter.js.map

package/dist/rate-limit/create-rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-rate-limiter.js","sourceRoot":"","sources":["../../src/rate-limit/create-rate-limiter.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,2CAA2C;AAG3C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAuB,MAAM,uBAAuB,CAAC;AAyBjG,2DAA2D;AAE3D,MAAM,UAAU,iBAAiB,CAAC,MAAuB,EAAE;IACzD,MAAM,EACJ,WAAW,GAAG,GAAG,EACjB,QAAQ,GAAG,MAAM,EACjB,SAAS,GAAG,YAAY,EACxB,WAAW,GAAG,IAAI,EAClB,YAAY,GAAG,mBAAmB,GACnC,GAAG,GAAG,CAAC;IAER,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC;IAE9D,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC;QAC1C,SAAS;QACT,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;IAEH,IAAI,OAA4B,CAAC;IAEjC,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,GAAG,IAAI,gBAAgB,CAAC;YAC7B,WAAW,EAAE,WAAW;YACxB,SAAS;YACT,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,YAAY;YACtB,aAAa,EAAE,CAAC;YAChB,gBAAgB,EAAE,aAAa;SAChC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,aAAa,CAAC;IAC1B,CAAC;IAED,wDAAwD;IAExD,KAAK,UAAU,UAAU,CACvB,GAAY,EACZ,GAAa,EACb,IAAkB;QAElB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAE1C,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;YAChD,GAAG,CAAC,SAAS,CAAC,uBAAuB,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;YAC/D,GAAG,CAAC,SAAS,CACX,mBAAmB,EACnB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CACzD,CAAC;YACF,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,MAAW,EAAE,CAAC;YACrB,iDAAiD;YACjD,IAAI,OAAO,MAAM,EAAE,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC7C,OAAO,CAAC,KAAK,CAAC,cAAc,SAAS,qBAAqB,EAAE,MAAM,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC;gBACvF,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;YAChD,GAAG,CAAC,SAAS,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;YAC1C,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;YACpE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,4CAA4C;aACtD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED,2DAA2D;AAE3D,SAAS,mBAAmB,CAAC,GAAY;IACvC,OAAQ,GAAG,CAAC,OAAO,CAAC,WAAW,CAAY,IAAI,GAAG,CAAC,EAAE,IAAI,SAAS,CAAC;AACrE,CAAC"}

package/dist/rate-limit/index.d.ts

@@ -0,0 +1,3 @@
+export { createRateLimiter } from "./create-rate-limiter.js";
+export type { RateLimitConfig, RateLimitResult } from "./create-rate-limiter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/rate-limit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rate-limit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/rate-limit/index.js

@@ -0,0 +1,2 @@
+export { createRateLimiter } from "./create-rate-limiter.js";
+//# sourceMappingURL=index.js.map

package/dist/rate-limit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rate-limit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/scheduling/event-driven-scheduler.d.ts

@@ -0,0 +1,33 @@
+import { EventEmitter } from "events";
+export interface SchedulerOptions {
+    /** Human-readable name for logging (default: "scheduler") */
+    name?: string;
+    /** Safety-net fallback interval in ms (default: 60 000) */
+    fallbackIntervalMs?: number;
+    /** The work function to execute on each trigger */
+    work: () => Promise<void> | void;
+    /** Logger (default: console) */
+    logger?: Pick<Console, "debug" | "info" | "error">;
+}
+export declare class EventDrivenScheduler extends EventEmitter {
+    private readonly name;
+    private readonly fallbackMs;
+    private readonly work;
+    private readonly logger;
+    private timer;
+    private running;
+    constructor(options: SchedulerOptions);
+    /** Start the safety-net interval. Does not run work immediately. */
+    start(): void;
+    /** Stop the scheduler and cancel the safety-net interval. */
+    stop(): void;
+    /**
+     * Trigger work immediately (event-driven).
+     * De-duplicates: if work is already running, the call is silently skipped.
+     */
+    trigger(): Promise<void>;
+    /** Whether the scheduler is currently executing its work function. */
+    get isRunning(): boolean;
+    private execute;
+}
+//# sourceMappingURL=event-driven-scheduler.d.ts.map

package/dist/scheduling/event-driven-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-driven-scheduler.d.ts","sourceRoot":"","sources":["../../src/scheduling/event-driven-scheduler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjC,gCAAgC;IAChC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AAID,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAEnE,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,gBAAgB;IAQrC,oEAAoE;IACpE,KAAK,IAAI,IAAI;IAMb,6DAA6D;IAC7D,IAAI,IAAI,IAAI;IAQZ;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,sEAAsE;IACtE,IAAI,SAAS,IAAI,OAAO,CAEvB;YAIa,OAAO;CAgBtB"}

package/dist/scheduling/event-driven-scheduler.js

@@ -0,0 +1,67 @@
+// pendoadmin-shared-lib/src/scheduling/event-driven-scheduler.ts
+//
+// Replaces naive setInterval polling with an event-driven pattern
+// that still has a safety-net fallback interval.
+import { EventEmitter } from "events";
+// ─── Scheduler ──────────────────────────────────────────
+export class EventDrivenScheduler extends EventEmitter {
+    name;
+    fallbackMs;
+    work;
+    logger;
+    timer = null;
+    running = false;
+    constructor(options) {
+        super();
+        this.name = options.name ?? "scheduler";
+        this.fallbackMs = options.fallbackIntervalMs ?? 60_000;
+        this.work = options.work;
+        this.logger = options.logger ?? console;
+    }
+    /** Start the safety-net interval. Does not run work immediately. */
+    start() {
+        if (this.timer)
+            return;
+        this.logger.info(`[${this.name}] Started (fallback every ${this.fallbackMs}ms)`);
+        this.timer = setInterval(() => void this.execute(), this.fallbackMs);
+    }
+    /** Stop the scheduler and cancel the safety-net interval. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+            this.logger.info(`[${this.name}] Stopped`);
+        }
+    }
+    /**
+     * Trigger work immediately (event-driven).
+     * De-duplicates: if work is already running, the call is silently skipped.
+     */
+    async trigger() {
+        return this.execute();
+    }
+    /** Whether the scheduler is currently executing its work function. */
+    get isRunning() {
+        return this.running;
+    }
+    // ─── Internal ─────────────────────────────────────
+    async execute() {
+        if (this.running) {
+            this.logger.debug(`[${this.name}] Skipped — already running`);
+            return;
+        }
+        this.running = true;
+        try {
+            await this.work();
+            this.emit("done");
+        }
+        catch (err) {
+            this.logger.error(`[${this.name}] Error: ${err.message}`);
+            this.emit("error", err);
+        }
+        finally {
+            this.running = false;
+        }
+    }
+}
+//# sourceMappingURL=event-driven-scheduler.js.map

package/dist/scheduling/event-driven-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-driven-scheduler.js","sourceRoot":"","sources":["../../src/scheduling/event-driven-scheduler.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,kEAAkE;AAClE,iDAAiD;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAetC,2DAA2D;AAE3D,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACnC,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,IAAI,CAA6B;IACjC,MAAM,CAA4C;IAE3D,KAAK,GAA0C,IAAI,CAAC;IACpD,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,OAAyB;QACnC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,kBAAkB,IAAI,MAAM,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IAC1C,CAAC;IAED,oEAAoE;IACpE,KAAK;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,6BAA6B,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC;QACjF,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;IAED,6DAA6D;IAC7D,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,sEAAsE;IACtE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,qDAAqD;IAE7C,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,6BAA6B,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;CACF"}

package/dist/scheduling/index.d.ts

@@ -0,0 +1,3 @@
+export { EventDrivenScheduler } from "./event-driven-scheduler.js";
+export type { SchedulerOptions } from "./event-driven-scheduler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scheduling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/scheduling/index.js

@@ -0,0 +1,2 @@
+export { EventDrivenScheduler } from "./event-driven-scheduler.js";
+//# sourceMappingURL=index.js.map

package/dist/scheduling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/socket/create-socket-server.d.ts

@@ -0,0 +1,30 @@
+import { Server as HttpServer } from "http";
+import { Server, ServerOptions, Socket } from "socket.io";
+export interface SocketServerOptions {
+    /** Room prefix used to namespace broadcasts (default: "company") */
+    roomPrefix?: string;
+    /** CORS origin list (default: ["*"]) */
+    corsOrigins?: string[];
+    /** Additional Socket.IO server options */
+    serverOptions?: Partial<ServerOptions>;
+    /** Logger — any object with debug / info / warn / error (default: console) */
+    logger?: Pick<Console, "debug" | "info" | "warn" | "error">;
+    /**
+     * Authenticate the incoming socket.
+     * Return truthy to allow, falsy or throw to reject.
+     * The decoded user should be attached to `socket.data.user`.
+     */
+    authenticate?: (socket: Socket) => Promise<boolean>;
+}
+export interface SocketEmitters {
+    /** Raw Socket.IO server instance */
+    io: Server;
+    /** Send to a specific room */
+    emitToRoom: (room: string, event: string, data: unknown) => void;
+    /** Send to a company-scoped room (roomPrefix:companyId) */
+    emitToCompany: (companyId: string | number, event: string, data: unknown) => void;
+    /** Broadcast to all connected clients */
+    emitGlobal: (event: string, data: unknown) => void;
+}
+export declare function createSocketServer(httpServer: HttpServer, options?: SocketServerOptions): SocketEmitters;
+//# sourceMappingURL=create-socket-server.d.ts.map

package/dist/socket/create-socket-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-socket-server.d.ts","sourceRoot":"","sources":["../../src/socket/create-socket-server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAI1D,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC5D;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACjE,2DAA2D;IAC3D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAClF,yCAAyC;IACzC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAID,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,mBAAwB,GAChC,cAAc,CAoEhB"}

package/dist/socket/create-socket-server.js

@@ -0,0 +1,59 @@
+// pendoadmin-shared-lib/src/socket/create-socket-server.ts
+//
+// Factory that creates a Socket.IO server with company-scoped rooms,
+// authentication, and convenience emitters.
+import { Server } from "socket.io";
+// ─── Factory ────────────────────────────────────────────
+export function createSocketServer(httpServer, options = {}) {
+    const { roomPrefix = "company", corsOrigins = ["*"], serverOptions = {}, logger = console, authenticate, } = options;
+    const io = new Server(httpServer, {
+        cors: { origin: corsOrigins, credentials: true },
+        ...serverOptions,
+    });
+    // ─── Authentication middleware ───────────────────────
+    if (authenticate) {
+        io.use(async (socket, next) => {
+            try {
+                const ok = await authenticate(socket);
+                if (!ok)
+                    return next(new Error("Authentication failed"));
+                next();
+            }
+            catch (err) {
+                logger.warn(`[Socket] Auth rejected: ${err.message}`);
+                next(new Error("Authentication failed"));
+            }
+        });
+    }
+    // ─── Connection lifecycle ───────────────────────────
+    io.on("connection", (socket) => {
+        const userId = socket.data?.user?.id ?? socket.id;
+        logger.debug(`[Socket] Connected: ${userId}`);
+        // Auto-join the company room when the client provides a companyId
+        socket.on("join:company", (companyId) => {
+            const room = `${roomPrefix}:${companyId}`;
+            socket.join(room);
+            logger.debug(`[Socket] ${userId} joined ${room}`);
+        });
+        socket.on("leave:company", (companyId) => {
+            const room = `${roomPrefix}:${companyId}`;
+            socket.leave(room);
+            logger.debug(`[Socket] ${userId} left ${room}`);
+        });
+        socket.on("disconnect", (reason) => {
+            logger.debug(`[Socket] Disconnected: ${userId} (${reason})`);
+        });
+    });
+    // ─── Emitter helpers ────────────────────────────────
+    function emitToRoom(room, event, data) {
+        io.to(room).emit(event, data);
+    }
+    function emitToCompany(companyId, event, data) {
+        emitToRoom(`${roomPrefix}:${companyId}`, event, data);
+    }
+    function emitGlobal(event, data) {
+        io.emit(event, data);
+    }
+    return { io, emitToRoom, emitToCompany, emitGlobal };
+}
+//# sourceMappingURL=create-socket-server.js.map

package/dist/socket/create-socket-server.js.map

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

package/dist/socket/index.d.ts

@@ -0,0 +1,5 @@
+export { createSocketServer, } from "./create-socket-server.js";
+export type { SocketServerOptions, SocketEmitters, } from "./create-socket-server.js";
+export { BaseSocketGateway, } from "./nestjs-socket.module.js";
+export type { NestSocketOptions, } from "./nestjs-socket.module.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/socket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/socket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}

package/dist/socket/index.js

@@ -0,0 +1,3 @@
+export { createSocketServer, } from "./create-socket-server.js";
+export { BaseSocketGateway, } from "./nestjs-socket.module.js";
+//# sourceMappingURL=index.js.map

package/dist/socket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/socket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EACL,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}

package/dist/socket/nestjs-socket.module.d.ts

@@ -0,0 +1,20 @@
+import { OnGatewayConnection, OnGatewayDisconnect } from "@nestjs/websockets";
+import { Server, Socket } from "socket.io";
+export interface NestSocketOptions {
+    /** Room prefix used to namespace broadcasts (default: "company") */
+    roomPrefix?: string;
+    /** Logger — any object with debug / info / warn / error (default: console) */
+    logger?: Pick<Console, "debug" | "info" | "warn" | "error">;
+}
+export declare abstract class BaseSocketGateway implements OnGatewayConnection, OnGatewayDisconnect {
+    server: Server;
+    protected readonly roomPrefix: string;
+    protected readonly logger: Pick<Console, "debug" | "info" | "warn" | "error">;
+    constructor(options?: NestSocketOptions);
+    handleConnection(client: Socket): void;
+    handleDisconnect(client: Socket): void;
+    emitToRoom(room: string, event: string, data: unknown): void;
+    emitToCompany(companyId: string | number, event: string, data: unknown): void;
+    emitGlobal(event: string, data: unknown): void;
+}
+//# sourceMappingURL=nestjs-socket.module.d.ts.map

package/dist/socket/nestjs-socket.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-socket.module.d.ts","sourceRoot":"","sources":["../../src/socket/nestjs-socket.module.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAI3C,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC7D;AAID,8BACsB,iBACpB,YAAW,mBAAmB,EAAE,mBAAmB;IAGnD,MAAM,EAAG,MAAM,CAAC;IAEhB,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;gBAElE,OAAO,GAAE,iBAAsB;IAO3C,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBtC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOtC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAI7E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;CAG/C"}

package/dist/socket/nestjs-socket.module.js

@@ -0,0 +1,64 @@
+// pendoadmin-shared-lib/src/socket/nestjs-socket.module.ts
+//
+// Abstract base gateway for NestJS microservices that use Socket.IO.
+// Provides room management and typed emit helpers.
+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);
+};
+import { WebSocketGateway, WebSocketServer, } from "@nestjs/websockets";
+import { Server } from "socket.io";
+// ─── Base Gateway ───────────────────────────────────────
+let BaseSocketGateway = class BaseSocketGateway {
+    server;
+    roomPrefix;
+    logger;
+    constructor(options = {}) {
+        this.roomPrefix = options.roomPrefix ?? "company";
+        this.logger = options.logger ?? console;
+    }
+    // ─── Lifecycle ────────────────────────────────────
+    handleConnection(client) {
+        const userId = client.data?.user?.id ?? client.id;
+        this.logger.debug(`[WS] Connected: ${userId}`);
+        client.on("join:company", (companyId) => {
+            const room = `${this.roomPrefix}:${companyId}`;
+            client.join(room);
+            this.logger.debug(`[WS] ${userId} joined ${room}`);
+        });
+        client.on("leave:company", (companyId) => {
+            const room = `${this.roomPrefix}:${companyId}`;
+            client.leave(room);
+            this.logger.debug(`[WS] ${userId} left ${room}`);
+        });
+    }
+    handleDisconnect(client) {
+        const userId = client.data?.user?.id ?? client.id;
+        this.logger.debug(`[WS] Disconnected: ${userId}`);
+    }
+    // ─── Emit helpers ─────────────────────────────────
+    emitToRoom(room, event, data) {
+        this.server.to(room).emit(event, data);
+    }
+    emitToCompany(companyId, event, data) {
+        this.emitToRoom(`${this.roomPrefix}:${companyId}`, event, data);
+    }
+    emitGlobal(event, data) {
+        this.server.emit(event, data);
+    }
+};
+__decorate([
+    WebSocketServer(),
+    __metadata("design:type", Server)
+], BaseSocketGateway.prototype, "server", void 0);
+BaseSocketGateway = __decorate([
+    WebSocketGateway({ cors: { origin: "*" } }),
+    __metadata("design:paramtypes", [Object])
+], BaseSocketGateway);
+export { BaseSocketGateway };
+//# sourceMappingURL=nestjs-socket.module.js.map

package/dist/socket/nestjs-socket.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-socket.module.js","sourceRoot":"","sources":["../../src/socket/nestjs-socket.module.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,qEAAqE;AACrE,mDAAmD;;;;;;;;;;AAEnD,OAAO,EACL,gBAAgB,EAGhB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAU,MAAM,WAAW,CAAC;AAW3C,2DAA2D;AAGpD,IAAe,iBAAiB,GAAhC,MAAe,iBAAiB;IAIrC,MAAM,CAAU;IAEG,UAAU,CAAS;IACnB,MAAM,CAAqD;IAE9E,YAAY,UAA6B,EAAE;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IAC1C,CAAC;IAED,qDAAqD;IAErD,gBAAgB,CAAC,MAAc;QAC7B,MAAM,MAAM,GAAI,MAAc,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAE/C,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,SAA0B,EAAE,EAAE;YACvD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,MAAM,WAAW,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,SAA0B,EAAE,EAAE;YACxD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,EAAE,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,MAAM,SAAS,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,MAAc;QAC7B,MAAM,MAAM,GAAI,MAAc,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,qDAAqD;IAErD,UAAU,CAAC,IAAY,EAAE,KAAa,EAAE,IAAa;QACnD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,aAAa,CAAC,SAA0B,EAAE,KAAa,EAAE,IAAa;QACpE,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,IAAa;QACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;CACF,CAAA;AA/CC;IADC,eAAe,EAAE;8BACT,MAAM;iDAAC;AAJI,iBAAiB;IADtC,gBAAgB,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;;GACtB,iBAAiB,CAmDtC"}

package/dist/tenant/drizzle-tenant.d.ts

@@ -0,0 +1,25 @@
+import { SQL } from "drizzle-orm";
+import type { Request, Response, NextFunction } from "express";
+export interface TenantWhereHelper {
+    /** Standalone tenant filter — e.g. db.select().where(tw.where) */
+    where: SQL;
+    /** Combine tenant filter with additional conditions */
+    and: (...conditions: SQL[]) => SQL;
+}
+/**
+ * Create a reusable WHERE helper scoped to a single company.
+ *
+ * @param companyIdColumn - The Drizzle column reference (e.g. `users.companyId`)
+ * @param companyId       - The company / tenant ID value
+ */
+export declare function createTenantWhere(companyIdColumn: any, companyId: string | number): TenantWhereHelper;
+/**
+ * Express middleware that extracts companyId from `req.user` (set by
+ * auth middleware) and attaches a `tenantWhere` helper to the request.
+ *
+ * Usage:
+ *   app.use(tenantMiddleware(schema.users.companyId));
+ *   // Then in handlers: req.tenantWhere.where or req.tenantWhere.and(...)
+ */
+export declare function tenantMiddleware(companyIdColumn: any): (req: Request, _res: Response, next: NextFunction) => void;
+//# sourceMappingURL=drizzle-tenant.d.ts.map

package/dist/tenant/drizzle-tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-tenant.d.ts","sourceRoot":"","sources":["../../src/tenant/drizzle-tenant.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,GAAG,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI/D,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,KAAK,EAAE,GAAG,CAAC;IACX,uDAAuD;IACvD,GAAG,EAAE,CAAC,GAAG,UAAU,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,GAAG,EACpB,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,iBAAiB,CAOnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,GAAG,IAC3C,KAAK,OAAO,EAAE,MAAM,QAAQ,EAAE,MAAM,YAAY,UAOzD"}

package/dist/tenant/drizzle-tenant.js

@@ -0,0 +1,35 @@
+// pendoadmin-shared-lib/src/tenant/drizzle-tenant.ts
+//
+// Drizzle ORM helper that builds reusable tenant WHERE clauses.
+import { eq, and } from "drizzle-orm";
+/**
+ * Create a reusable WHERE helper scoped to a single company.
+ *
+ * @param companyIdColumn - The Drizzle column reference (e.g. `users.companyId`)
+ * @param companyId       - The company / tenant ID value
+ */
+export function createTenantWhere(companyIdColumn, companyId) {
+    const tenantFilter = eq(companyIdColumn, companyId);
+    return {
+        where: tenantFilter,
+        and: (...conditions) => and(tenantFilter, ...conditions),
+    };
+}
+/**
+ * Express middleware that extracts companyId from `req.user` (set by
+ * auth middleware) and attaches a `tenantWhere` helper to the request.
+ *
+ * Usage:
+ *   app.use(tenantMiddleware(schema.users.companyId));
+ *   // Then in handlers: req.tenantWhere.where or req.tenantWhere.and(...)
+ */
+export function tenantMiddleware(companyIdColumn) {
+    return (req, _res, next) => {
+        const companyId = req.user?.company_id;
+        if (companyId) {
+            req.tenantWhere = createTenantWhere(companyIdColumn, companyId);
+        }
+        next();
+    };
+}
+//# sourceMappingURL=drizzle-tenant.js.map

package/dist/tenant/drizzle-tenant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-tenant.js","sourceRoot":"","sources":["../../src/tenant/drizzle-tenant.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,gEAAgE;AAEhE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAO,MAAM,aAAa,CAAC;AAY3C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,eAAoB,EACpB,SAA0B;IAE1B,MAAM,YAAY,GAAG,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAEpD,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,GAAG,EAAE,CAAC,GAAG,UAAiB,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,UAAU,CAAE;KACjE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,eAAoB;IACnD,OAAO,CAAC,GAAY,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE;QAC1D,MAAM,SAAS,GAAI,GAAW,CAAC,IAAI,EAAE,UAAU,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACb,GAAW,CAAC,WAAW,GAAG,iBAAiB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/dist/tenant/index.d.ts

@@ -0,0 +1,7 @@
+export { scopedKnex } from "./knex-tenant.js";
+export type { ScopedKnexOptions } from "./knex-tenant.js";
+export { createTenantWhere, tenantMiddleware } from "./drizzle-tenant.js";
+export type { TenantWhereHelper } from "./drizzle-tenant.js";
+export { createTenantAccessControl, knexFeatureResolver, knexCompanyActiveChecker, getFeaturesForPlan, provisionCompanyPlan, clearFeatureCache, invalidateCompanyFeatureCache, DEFAULT_PLANS, } from "./tenant-access-control.js";
+export type { Feature, SubscriptionPlan, TenantAccessControlConfig, } from "./tenant-access-control.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tenant/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tenant/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,EAC7B,aAAa,GACd,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,OAAO,EACP,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC"}

package/dist/tenant/index.js

@@ -0,0 +1,7 @@
+// Knex tenant scoping
+export { scopedKnex } from "./knex-tenant.js";
+// Drizzle tenant scoping
+export { createTenantWhere, tenantMiddleware } from "./drizzle-tenant.js";
+// Tenant access control (feature gating)
+export { createTenantAccessControl, knexFeatureResolver, knexCompanyActiveChecker, getFeaturesForPlan, provisionCompanyPlan, clearFeatureCache, invalidateCompanyFeatureCache, DEFAULT_PLANS, } from "./tenant-access-control.js";
+//# sourceMappingURL=index.js.map

package/dist/tenant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tenant/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG1E,yCAAyC;AACzC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,EAC7B,aAAa,GACd,MAAM,4BAA4B,CAAC"}

package/dist/tenant/knex-tenant.d.ts

@@ -0,0 +1,13 @@
+import type { Knex } from "knex";
+export interface ScopedKnexOptions {
+    /** Column name for tenant isolation (default: "company_id") */
+    tenantColumn?: string;
+    /** Tables to exclude from automatic scoping */
+    excludeTables?: string[];
+}
+/**
+ * Returns a Proxy around `knex` that intercepts table calls and
+ * injects `.where(tenantColumn, companyId)`.
+ */
+export declare function scopedKnex(knex: Knex, companyId: string | number, options?: ScopedKnexOptions): Knex;
+//# sourceMappingURL=knex-tenant.d.ts.map

package/dist/tenant/knex-tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-tenant.d.ts","sourceRoot":"","sources":["../../src/tenant/knex-tenant.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,IAAI,CAoCN"}