nestjs-tenant-shield 0.1.0

package/dist/decorators/tenant-context.decorator.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenantContext = TenantContext;
+const tenant_context_storage_1 = require("../context/tenant-context.storage");
+/**
+ * ─────────────────────────────────────────────────────────────
+ * @TenantContext() — 백그라운드 큐 작업용 tenant 컨텍스트 복원 데코레이터.
+ *
+ * ⚠️ v0.2 정식 출시 예정. v0.1 스켈레톤만 존재.
+ *
+ * 동작:
+ *   BullMQ/Bull의 @Process 핸들러에 붙이면, job payload에서 tenant ID를
+ *   꺼내 AsyncLocalStorage.run()으로 컨텍스트를 만든 채 핸들러를 실행.
+ *
+ *   결과적으로 HTTP 요청과 동일한 보호망(@RequireTenant, Subscriber 등)이
+ *   백그라운드 작업에서도 그대로 동작합니다.
+ *
+ * ─────────────────────────────────────────────────────────────
+ *
+ * [예시]
+ *
+ *   @Processor('reports')
+ *   export class ReportProcessor {
+ *     @Process('monthly')
+ *     @TenantContext()                                 // job.data.tenantId 자동 추출
+ *     async generateMonthlyReport(job: Job) { ... }
+ *
+ *     @Process('quarterly')
+ *     @TenantContext({ extractFrom: j => j.data.orgId })  // 커스텀 추출
+ *     async generateQuarterly(job: Job) { ... }
+ *   }
+ *
+ * ─────────────────────────────────────────────────────────────
+ */
+function TenantContext(options = {}) {
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        // 추출 함수 — 미지정 시 job.data.tenantId 기본 사용.
+        const extract = options.extractFrom ?? ((job) => job?.data?.tenantId);
+        descriptor.value = async function (...args) {
+            // BullMQ는 핸들러 첫 번째 인자로 Job 객체를 넘깁니다.
+            const job = args[0];
+            const tenantId = extract(job);
+            if (!tenantId) {
+                // 추출 실패 — payload 구조를 점검하라는 명확한 에러로.
+                throw new Error('@TenantContext: job payload에서 tenant ID를 추출하지 못했습니다. extractFrom 옵션을 확인하세요.');
+            }
+            // 컨텍스트를 새로 만들어서 원본 핸들러 실행.
+            return tenant_context_storage_1.tenantContextStorage.run({ tenantId, isSystemAction: false }, () => originalMethod.apply(this, args));
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=tenant-context.decorator.js.map

package/dist/decorators/tenant-context.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-context.decorator.js","sourceRoot":"","sources":["../../src/decorators/tenant-context.decorator.ts"],"names":[],"mappings":";;AAiCA,sCAgCC;AAhED,8EAAyE;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,aAAa,CAAC,UAAgC,EAAE;IAC9D,OAAO,UACL,OAAY,EACZ,YAA6B,EAC7B,UAA8B;QAE9B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,yCAAyC;QACzC,MAAM,OAAO,GACX,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,QAAkB,CAAC,CAAC;QAEvE,UAAU,CAAC,KAAK,GAAG,KAAK,WAAsB,GAAG,IAAe;YAC9D,qCAAqC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAE9B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,qCAAqC;gBACrC,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;YACJ,CAAC;YAED,2BAA2B;YAC3B,OAAO,6CAAoB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CACxE,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CACjC,CAAC;QACJ,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/errors/cross-tenant-access.error.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 한 tenant가 다른 tenant의 데이터에 접근을 시도했을 때 throw 되는 에러.
+ *
+ * 이 에러가 나면 그 자체로 보안 사고 신호입니다.
+ * 정상 흐름에서는 절대 발생하지 않아야 합니다 (Subscriber가 자동 WHERE를 주입하므로).
+ *
+ * 발생 가능 시나리오:
+ *  - 어딘가에서 escape hatch(raw SQL, getManager 직접 사용)로 우회한 경우
+ *  - Subscriber가 등록되지 않은 entity를 사용한 경우
+ *  - 캐시 키 분리가 안 된 상태에서 다른 tenant 데이터가 응답된 경우
+ *
+ * 처리 권장:
+ *  - 즉시 알림 (Slack, Sentry, PagerDuty 등)
+ *  - 해당 요청 ID, 사용자, IP 함께 기록
+ *  - 코드 리뷰로 우회 경로 점검
+ */
+export declare class CrossTenantAccessError extends Error {
+    readonly currentTenant: string;
+    readonly attemptedTenant: string;
+    readonly entityName?: string | undefined;
+    /**
+     * @param message         - 에러 메시지
+     * @param currentTenant   - 현재 요청의 tenant ID
+     * @param attemptedTenant - 접근 시도한 데이터의 tenant ID
+     * @param entityName      - 해당 entity 클래스 이름 (선택)
+     */
+    constructor(message: string, currentTenant: string, attemptedTenant: string, entityName?: string | undefined);
+}
+//# sourceMappingURL=cross-tenant-access.error.d.ts.map

package/dist/errors/cross-tenant-access.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-tenant-access.error.d.ts","sourceRoot":"","sources":["../../src/errors/cross-tenant-access.error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAS7B,aAAa,EAAE,MAAM;aACrB,eAAe,EAAE,MAAM;aACvB,UAAU,CAAC,EAAE,MAAM;IAVrC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACC,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,YAAA;CAMtC"}

package/dist/errors/cross-tenant-access.error.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrossTenantAccessError = void 0;
+/**
+ * 한 tenant가 다른 tenant의 데이터에 접근을 시도했을 때 throw 되는 에러.
+ *
+ * 이 에러가 나면 그 자체로 보안 사고 신호입니다.
+ * 정상 흐름에서는 절대 발생하지 않아야 합니다 (Subscriber가 자동 WHERE를 주입하므로).
+ *
+ * 발생 가능 시나리오:
+ *  - 어딘가에서 escape hatch(raw SQL, getManager 직접 사용)로 우회한 경우
+ *  - Subscriber가 등록되지 않은 entity를 사용한 경우
+ *  - 캐시 키 분리가 안 된 상태에서 다른 tenant 데이터가 응답된 경우
+ *
+ * 처리 권장:
+ *  - 즉시 알림 (Slack, Sentry, PagerDuty 등)
+ *  - 해당 요청 ID, 사용자, IP 함께 기록
+ *  - 코드 리뷰로 우회 경로 점검
+ */
+class CrossTenantAccessError extends Error {
+    /**
+     * @param message         - 에러 메시지
+     * @param currentTenant   - 현재 요청의 tenant ID
+     * @param attemptedTenant - 접근 시도한 데이터의 tenant ID
+     * @param entityName      - 해당 entity 클래스 이름 (선택)
+     */
+    constructor(message, currentTenant, attemptedTenant, entityName) {
+        super(message);
+        this.currentTenant = currentTenant;
+        this.attemptedTenant = attemptedTenant;
+        this.entityName = entityName;
+        this.name = 'CrossTenantAccessError';
+        Object.setPrototypeOf(this, CrossTenantAccessError.prototype);
+    }
+}
+exports.CrossTenantAccessError = CrossTenantAccessError;
+//# sourceMappingURL=cross-tenant-access.error.js.map

package/dist/errors/cross-tenant-access.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-tenant-access.error.js","sourceRoot":"","sources":["../../src/errors/cross-tenant-access.error.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAC/C;;;;;OAKG;IACH,YACE,OAAe,EACC,aAAqB,EACrB,eAAuB,EACvB,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,kBAAa,GAAb,aAAa,CAAQ;QACrB,oBAAe,GAAf,eAAe,CAAQ;QACvB,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAjBD,wDAiBC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 라이브러리가 throw할 수 있는 모든 에러 타입을 한 곳에서 export.
+ *
+ * 사용자는 catch 블록에서 instanceof로 분기할 수 있습니다:
+ *   if (e instanceof CrossTenantAccessError) { ... }
+ */
+export * from './missing-tenant-context.error';
+export * from './cross-tenant-access.error';
+export * from './invalid-tenant-source.error';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 라이브러리가 throw할 수 있는 모든 에러 타입을 한 곳에서 export.
+ *
+ * 사용자는 catch 블록에서 instanceof로 분기할 수 있습니다:
+ *   if (e instanceof CrossTenantAccessError) { ... }
+ */
+__exportStar(require("./missing-tenant-context.error"), exports);
+__exportStar(require("./cross-tenant-access.error"), exports);
+__exportStar(require("./invalid-tenant-source.error"), exports);
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,iEAA+C;AAC/C,8DAA4C;AAC5C,gEAA8C"}

package/dist/errors/invalid-tenant-source.error.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TenantShieldModule.forRoot() 설정이 잘못됐을 때 throw 되는 에러.
+ *
+ * 예시 케이스:
+ *  - tenantSource: 'custom' 인데 customResolver가 없음
+ *  - tenantSource: 'subdomain' 인데 subdomainPattern이 없음
+ *  - strategy: 'schema' (v0.1에서는 미지원)
+ *
+ * 이 에러는 앱 부팅 단계(@Module 초기화)에서 발생해
+ * 잘못된 설정의 앱이 트래픽을 받기 전에 즉시 실패하도록 합니다.
+ */
+export declare class InvalidTenantSourceError extends Error {
+    readonly source: string;
+    /**
+     * @param message - 사용자에게 어떤 설정이 잘못됐는지 알려주는 메시지
+     * @param source  - 문제가 발생한 source 타입 (header/jwt/...)
+     */
+    constructor(message: string, source: string);
+}
+//# sourceMappingURL=invalid-tenant-source.error.d.ts.map

package/dist/errors/invalid-tenant-source.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-tenant-source.error.d.ts","sourceRoot":"","sources":["../../src/errors/invalid-tenant-source.error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;aAO/B,MAAM,EAAE,MAAM;IANhC;;;OAGG;gBAED,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM;CAMjC"}

package/dist/errors/invalid-tenant-source.error.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidTenantSourceError = void 0;
+/**
+ * TenantShieldModule.forRoot() 설정이 잘못됐을 때 throw 되는 에러.
+ *
+ * 예시 케이스:
+ *  - tenantSource: 'custom' 인데 customResolver가 없음
+ *  - tenantSource: 'subdomain' 인데 subdomainPattern이 없음
+ *  - strategy: 'schema' (v0.1에서는 미지원)
+ *
+ * 이 에러는 앱 부팅 단계(@Module 초기화)에서 발생해
+ * 잘못된 설정의 앱이 트래픽을 받기 전에 즉시 실패하도록 합니다.
+ */
+class InvalidTenantSourceError extends Error {
+    /**
+     * @param message - 사용자에게 어떤 설정이 잘못됐는지 알려주는 메시지
+     * @param source  - 문제가 발생한 source 타입 (header/jwt/...)
+     */
+    constructor(message, source) {
+        super(message);
+        this.source = source;
+        this.name = 'InvalidTenantSourceError';
+        Object.setPrototypeOf(this, InvalidTenantSourceError.prototype);
+    }
+}
+exports.InvalidTenantSourceError = InvalidTenantSourceError;
+//# sourceMappingURL=invalid-tenant-source.error.js.map

package/dist/errors/invalid-tenant-source.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-tenant-source.error.js","sourceRoot":"","sources":["../../src/errors/invalid-tenant-source.error.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,MAAa,wBAAyB,SAAQ,KAAK;IACjD;;;OAGG;IACH,YACE,OAAe,EACC,MAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAbD,4DAaC"}

package/dist/errors/missing-tenant-context.error.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tenant 컨텍스트가 설정되지 않은 상태에서
+ * @RequireTenant()가 적용된 메서드를 호출했을 때 throw 되는 에러.
+ *
+ * 발생 원인:
+ *  1) 미들웨어가 동작하지 않은 경로 (정적 파일, public 라우트 등)
+ *  2) 백그라운드 작업에서 컨텍스트 전파 누락
+ *  3) 테스트 코드에서 runWithTenant() 누락
+ *
+ * 처리 권장:
+ *  - NestJS Exception Filter에서 잡아 401 또는 500으로 응답
+ *  - 로그에 source(어디서 추출 시도했는지) 기록해 디버깅 시간 단축
+ */
+export declare class MissingTenantContextError extends Error {
+    readonly source: string;
+    /**
+     * @param message - 에러 메시지 (한국어/영어 자유)
+     * @param source  - tenant 추출을 시도한 위치 (header/jwt/subdomain/custom)
+     */
+    constructor(message: string, source: string);
+}
+//# sourceMappingURL=missing-tenant-context.error.d.ts.map

package/dist/errors/missing-tenant-context.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-tenant-context.error.d.ts","sourceRoot":"","sources":["../../src/errors/missing-tenant-context.error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aAOhC,MAAM,EAAE,MAAM;IANhC;;;OAGG;gBAED,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM;CASjC"}

package/dist/errors/missing-tenant-context.error.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingTenantContextError = void 0;
+/**
+ * Tenant 컨텍스트가 설정되지 않은 상태에서
+ * @RequireTenant()가 적용된 메서드를 호출했을 때 throw 되는 에러.
+ *
+ * 발생 원인:
+ *  1) 미들웨어가 동작하지 않은 경로 (정적 파일, public 라우트 등)
+ *  2) 백그라운드 작업에서 컨텍스트 전파 누락
+ *  3) 테스트 코드에서 runWithTenant() 누락
+ *
+ * 처리 권장:
+ *  - NestJS Exception Filter에서 잡아 401 또는 500으로 응답
+ *  - 로그에 source(어디서 추출 시도했는지) 기록해 디버깅 시간 단축
+ */
+class MissingTenantContextError extends Error {
+    /**
+     * @param message - 에러 메시지 (한국어/영어 자유)
+     * @param source  - tenant 추출을 시도한 위치 (header/jwt/subdomain/custom)
+     */
+    constructor(message, source) {
+        super(message);
+        this.source = source;
+        // V8 엔진(Node.js) 스택 트레이스에서 이 클래스 이름이 정확히 보이도록 설정.
+        // 이게 없으면 인스턴스 검사가 깨질 수 있고, 디버깅 시 스택이 어색하게 찍힘.
+        this.name = 'MissingTenantContextError';
+        Object.setPrototypeOf(this, MissingTenantContextError.prototype);
+    }
+}
+exports.MissingTenantContextError = MissingTenantContextError;
+//# sourceMappingURL=missing-tenant-context.error.js.map

package/dist/errors/missing-tenant-context.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-tenant-context.error.js","sourceRoot":"","sources":["../../src/errors/missing-tenant-context.error.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,MAAa,yBAA0B,SAAQ,KAAK;IAClD;;;OAGG;IACH,YACE,OAAe,EACC,MAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAQ;QAI9B,kDAAkD;QAClD,8CAA8C;QAC9C,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;CACF;AAhBD,8DAgBC"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ─────────────────────────────────────────────────────────────
+ * nestjs-tenant-shield의 public 진입점.
+ *
+ * 라이브러리 사용자는 항상 이 경로에서 import 합니다:
+ *
+ *   import {
+ *     TenantShieldModule,
+ *     RequireTenant,
+ *     SystemAction,
+ *     Cacheable,
+ *     getCurrentTenantId,
+ *     runWithTenant,
+ *     MissingTenantContextError,
+ *     CrossTenantAccessError,
+ *   } from 'nestjs-tenant-shield';
+ *
+ * 내부 구현 디테일(폴더 구조 등)은 사용자에게 노출하지 않습니다.
+ * 모든 외부 API는 여기서만 export 됨.
+ * ─────────────────────────────────────────────────────────────
+ */
+export * from './tenant-shield.module';
+export * from './decorators';
+export * from './context';
+export * from './middleware';
+export { TenantShieldOptions, TenantShieldAsyncOptions, TenantSource, TenantStrategy, } from './interfaces/tenant-shield-options.interface';
+export { RequireTenantOptions } from './interfaces/require-tenant-options.interface';
+export { CacheableOptions } from './interfaces/cacheable-options.interface';
+export { TenantContextOptions } from './interfaces/tenant-context-options.interface';
+export { TenantContext as TenantContextState } from './interfaces/tenant-context.interface';
+export * from './errors';
+export * from './cache';
+export * from './typeorm';
+export * from './constants';
+export * from './testing';
+//# 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;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,cAAc,wBAAwB,CAAC;AAGvC,cAAc,cAAc,CAAC;AAG7B,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,OAAO,EACN,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,cAAc,GACd,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG5F,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * ─────────────────────────────────────────────────────────────
+ * nestjs-tenant-shield의 public 진입점.
+ *
+ * 라이브러리 사용자는 항상 이 경로에서 import 합니다:
+ *
+ *   import {
+ *     TenantShieldModule,
+ *     RequireTenant,
+ *     SystemAction,
+ *     Cacheable,
+ *     getCurrentTenantId,
+ *     runWithTenant,
+ *     MissingTenantContextError,
+ *     CrossTenantAccessError,
+ *   } from 'nestjs-tenant-shield';
+ *
+ * 내부 구현 디테일(폴더 구조 등)은 사용자에게 노출하지 않습니다.
+ * 모든 외부 API는 여기서만 export 됨.
+ * ─────────────────────────────────────────────────────────────
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// 메인 모듈
+__exportStar(require("./tenant-shield.module"), exports);
+// 데코레이터
+__exportStar(require("./decorators"), exports);
+// 컨텍스트 헬퍼 (getCurrentTenantId, runWithTenant 등)
+__exportStar(require("./context"), exports);
+// 미들웨어 (사용자가 수동 설정하고 싶을 때 직접 가져갈 수 있게 노출)
+__exportStar(require("./middleware"), exports);
+// 에러
+__exportStar(require("./errors"), exports);
+// 캐시 (사용자가 커스텀 백엔드 구현 시 인터페이스 필요)
+__exportStar(require("./cache"), exports);
+// TypeORM 통합 (raw SQL 헬퍼 등)
+__exportStar(require("./typeorm"), exports);
+// 상수 (DI 토큰)
+__exportStar(require("./constants"), exports);
+// 테스트 헬퍼 (runWithTenant 등은 context에서도 export 되지만, expectCurrentTenant 등 테스트 전용 유틸 포함)
+__exportStar(require("./testing"), exports);
+//# 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;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,yDAAuC;AAEvC,QAAQ;AACR,+CAA6B;AAE7B,gDAAgD;AAChD,4CAA0B;AAE1B,0CAA0C;AAC1C,+CAA6B;AAc7B,KAAK;AACL,2CAAyB;AAEzB,kCAAkC;AAClC,0CAAwB;AAExB,4BAA4B;AAC5B,4CAA0B;AAE1B,aAAa;AACb,8CAA4B;AAE5B,sFAAsF;AACtF,4CAA0B"}

package/dist/interfaces/cacheable-options.interface.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @Cacheable() 데코레이터에 넘기는 옵션.
+ *
+ * 메서드 결과를 캐시에 저장하고, 동일한 인자로 호출하면 캐시된 값을 즉시 반환.
+ * tenant 단위 캐시 분리는 이 라이브러리의 핵심 차별점.
+ */
+export interface CacheableOptions {
+    /**
+     * 캐시 유효 시간 (초 단위). 필수.
+     *
+     * 예: 300 → 5분 동안 동일한 결과를 캐시에서 반환.
+     * TTL이 지나면 자동으로 메서드를 다시 실행하고 결과를 갱신.
+     */
+    ttl: number;
+    /**
+     * 캐시 키에 tenant ID prefix를 자동으로 붙일지 여부 (기본 false).
+     *
+     * true로 설정 시:
+     *   캐시 키 = `${tenantId}:${className}.${methodName}:${args}`
+     *
+     * → 동일한 메서드를 A학원과 B학원이 호출해도 캐시가 섞이지 않음.
+     *
+     * 멀티테넌시 환경에서는 거의 항상 true가 정답.
+     * false로 두는 경우는 전 tenant 공통 데이터(공지사항 등)일 때만.
+     */
+    tenantScoped?: boolean;
+    /**
+     * 커스텀 캐시 키 생성 함수.
+     *
+     * 미지정 시: 메서드 이름 + 인자 JSON 직렬화로 자동 생성.
+     *
+     * 인자가 복잡한 객체이거나 일부 필드만 키에 반영하고 싶을 때 사용.
+     * 예: keyGenerator: (args) => `student:${args[0].id}`
+     */
+    keyGenerator?: (args: unknown[]) => string;
+}
+//# sourceMappingURL=cacheable-options.interface.d.ts.map

package/dist/interfaces/cacheable-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheable-options.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/cacheable-options.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CAC5C"}

package/dist/interfaces/cacheable-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cacheable-options.interface.js.map

package/dist/interfaces/cacheable-options.interface.js.map

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

package/dist/interfaces/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * interfaces 폴더의 모든 public 타입을 한 곳에서 re-export 하는 배럴 파일.
+ *
+ * 이렇게 해두면 라이브러리 외부에서:
+ *   import { TenantShieldOptions } from 'nestjs-tenant-shield';
+ * 처럼 깔끔하게 import 할 수 있습니다.
+ */
+export * from './tenant-shield-options.interface';
+export * from './require-tenant-options.interface';
+export * from './cacheable-options.interface';
+export * from './tenant-context-options.interface';
+export * from './tenant-context.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4BAA4B,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * interfaces 폴더의 모든 public 타입을 한 곳에서 re-export 하는 배럴 파일.
+ *
+ * 이렇게 해두면 라이브러리 외부에서:
+ *   import { TenantShieldOptions } from 'nestjs-tenant-shield';
+ * 처럼 깔끔하게 import 할 수 있습니다.
+ */
+__exportStar(require("./tenant-shield-options.interface"), exports);
+__exportStar(require("./require-tenant-options.interface"), exports);
+__exportStar(require("./cacheable-options.interface"), exports);
+__exportStar(require("./tenant-context-options.interface"), exports);
+// TenantContext는 데코레이터와 이름이 충돌하므로 public 진입점에서는 별칭으로 export.
+__exportStar(require("./tenant-context.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,oEAAkD;AAClD,qEAAmD;AACnD,gEAA8C;AAC9C,qEAAmD;AACnD,6DAA6D;AAC7D,6DAA2C"}

package/dist/interfaces/require-tenant-options.interface.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @RequireTenant() 데코레이터에 넘기는 옵션.
+ *
+ * 대부분의 경우 옵션 없이 그냥 @RequireTenant() 형태로 사용하면 됩니다.
+ * 옵션은 forRoot의 전역 설정을 메서드 단위로 오버라이드하고 싶을 때만 사용.
+ */
+export interface RequireTenantOptions {
+    /**
+     * 이 메서드에 한해 tenant 없이 실행을 허용할지.
+     *
+     * forRoot.allowSystemActions와 무관하게 메서드별 허용 가능.
+     * 다만 권장하지 않음 — 가능하면 @SystemAction()을 사용하세요.
+     */
+    allowSystem?: boolean;
+    /**
+     * Strict mode 메서드별 오버라이드.
+     * 미지정 시 forRoot의 strictMode 따름.
+     *
+     * 예: 마이그레이션 중인 특정 메서드만 임시로 strict를 끄고 싶을 때.
+     */
+    strictMode?: boolean;
+}
+//# sourceMappingURL=require-tenant-options.interface.d.ts.map

package/dist/interfaces/require-tenant-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-tenant-options.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/require-tenant-options.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/interfaces/require-tenant-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=require-tenant-options.interface.js.map

package/dist/interfaces/require-tenant-options.interface.js.map

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

package/dist/interfaces/tenant-context-options.interface.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @TenantContext() 데코레이터 옵션 (v0.2 — 큐 통합).
+ *
+ * BullMQ/Bull 같은 백그라운드 큐 워커에서 job을 처리할 때,
+ * job payload에 들어있는 tenant ID로 AsyncLocalStorage 컨텍스트를
+ * 자동 설정해주는 데코레이터입니다.
+ */
+export interface TenantContextOptions {
+    /**
+     * 큐 페이로드에서 tenant ID를 추출하는 함수.
+     *
+     * 미지정 시 기본값: job.data.tenantId
+     *
+     * payload 구조가 다르면 명시:
+     *   extractFrom: (job) => job.data.organizationId
+     */
+    extractFrom?: (job: unknown) => string;
+}
+//# sourceMappingURL=tenant-context-options.interface.d.ts.map

package/dist/interfaces/tenant-context-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-context-options.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/tenant-context-options.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;CACxC"}

package/dist/interfaces/tenant-context-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tenant-context-options.interface.js.map

package/dist/interfaces/tenant-context-options.interface.js.map

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

package/dist/interfaces/tenant-context.interface.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AsyncLocalStorage에 저장되는 컨텍스트의 형태.
+ *
+ * 요청 하나당 하나의 TenantContext가 생성되고,
+ * 비동기 호출 체인 끝까지 동일한 인스턴스가 공유됩니다.
+ *
+ * 비유: 손님 한 명에게 발급되는 일회용 출입 카드.
+ *      어느 부서를 거치든 카드의 정보(어느 회사 손님인지)는 유지됨.
+ */
+export interface TenantContext {
+    /**
+     * 현재 요청의 tenant ID.
+     * null이면 시스템 작업 또는 컨텍스트 미설정 상태.
+     */
+    tenantId: string | null;
+    /**
+     * 이 요청이 명시적으로 "시스템 작업"으로 표시됐는지.
+     *
+     * true: @SystemAction()이 적용된 경로 또는 runWithoutTenant()로 진입.
+     *       tenantId가 null이어도 strict mode가 throw하지 않음.
+     *
+     * 일반 요청에서는 false 또는 undefined.
+     */
+    isSystemAction?: boolean;
+}
+//# sourceMappingURL=tenant-context.interface.d.ts.map

package/dist/interfaces/tenant-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-context.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/tenant-context.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/interfaces/tenant-context.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tenant-context.interface.js.map

package/dist/interfaces/tenant-context.interface.js.map

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