@saasicat/nest 1.0.0-rc.2 → 1.0.0-rc.21

package/dist/define-saasicat-DROBe-b1.d.ts

@@ -1,69 +0,0 @@
-import * as _nestjs_common from '@nestjs/common';
-import { ExecutionContext, DynamicModule } from '@nestjs/common';
-import { Reflector } from '@nestjs/core';
-import { SuperAdminProvisioningPort, SetupStatusResponse, SetupRequest, SetupResult, SetupConfirmMfaRequest, SetupConfirmMfaResponse } from '@saasicat/core';
-import { h as MfaService } from './admin-stats.service-TYiSUwIR.js';
-import { e as SaaSiCatModuleOptions } from './module-options-COSEb0VW.js';
-
-/**
- * Shared metadata key for endpoints that intentionally run without application
- * authentication. `Symbol.for` keeps the marker stable across package entries.
- */
-declare const SAASICAT_PUBLIC_ROUTE_KEY: unique symbol;
-/** Marks a SaaSiCat controller or handler as intentionally public. */
-declare const SaaSiCatPublicRoute: () => _nestjs_common.CustomDecorator<typeof SAASICAT_PUBLIC_ROUTE_KEY>;
-/** Returns whether the current endpoint is marked as a public SaaSiCat route. */
-declare function isSaaSiCatPublicRoute(reflector: Reflector, context: ExecutionContext): boolean;
-
-declare const SETUP_PROVISIONING_PORT_TOKEN: unique symbol;
-declare const SETUP_CONFIG_TOKEN: unique symbol;
-interface SetupConfig {
-    /** Env-var name of the setup token. Without the var set, setup is disabled. */
-    setupTokenEnvVar: string;
-    /** Authenticator issuer for the MFA enrollment in the wizard. */
-    mfaIssuer: string;
-}
-
-declare class SetupService {
-    private readonly users;
-    private readonly config;
-    private readonly mfa;
-    constructor(users: SuperAdminProvisioningPort, config: SetupConfig, mfa: MfaService);
-    status(): Promise<SetupStatusResponse>;
-    setup(req: SetupRequest): Promise<SetupResult>;
-    confirmMfa(req: SetupConfirmMfaRequest): Promise<SetupConfirmMfaResponse>;
-    private assertToken;
-    private assertNoSuperAdmin;
-}
-
-/**
- * Bundles the complete standard SaaSiCat backend stack into a single
- * `forRoot({...})` call. Reduces AppModule boilerplate and eliminates the
- * ordering trap.
- *
- * Quickstart path (Prisma + PostgreSQL on the canonical schema):
- *
- * ```ts
- * SaaSiCatModule.forRoot({
- *     planCatalog: loadPlanCatalogFromFile({ path: 'config/saas.yaml' }),
- *     controller: { guards: [JwtAuthGuard] },
- *     imports: [AuthModule],
- *     persistence: prismaPersistence({ client: PrismaService }), // @saasicat/adapter-prisma
- * })
- * ```
- *
- * Individual `adapters` entries stay supported (custom schema / other ORM)
- * and override bundle slices field by field.
- */
-declare class SaaSiCatModule {
-    static forRoot(options: SaaSiCatModuleOptions): DynamicModule;
-}
-
-/**
- * Typed identity helper for the high-level SaaSiCat configuration. It keeps
- * literal types and gives editors one place for completion without adding
- * runtime behavior.
- */
-declare function defineSaaSiCat<const T extends SaaSiCatModuleOptions>(options: T): T;
-
-export { SetupService as S, SAASICAT_PUBLIC_ROUTE_KEY as a, SETUP_CONFIG_TOKEN as b, SETUP_PROVISIONING_PORT_TOKEN as c, SaaSiCatModule as d, SaaSiCatPublicRoute as e, type SetupConfig as f, defineSaaSiCat as g, isSaaSiCatPublicRoute as i };

package/dist/define-saasicat-vGBCkFys.d.cts

@@ -1,69 +0,0 @@
-import * as _nestjs_common from '@nestjs/common';
-import { ExecutionContext, DynamicModule } from '@nestjs/common';
-import { Reflector } from '@nestjs/core';
-import { SuperAdminProvisioningPort, SetupStatusResponse, SetupRequest, SetupResult, SetupConfirmMfaRequest, SetupConfirmMfaResponse } from '@saasicat/core';
-import { h as MfaService } from './admin-stats.service-DfKupywR.cjs';
-import { e as SaaSiCatModuleOptions } from './module-options-BG3MzQva.cjs';
-
-/**
- * Shared metadata key for endpoints that intentionally run without application
- * authentication. `Symbol.for` keeps the marker stable across package entries.
- */
-declare const SAASICAT_PUBLIC_ROUTE_KEY: unique symbol;
-/** Marks a SaaSiCat controller or handler as intentionally public. */
-declare const SaaSiCatPublicRoute: () => _nestjs_common.CustomDecorator<typeof SAASICAT_PUBLIC_ROUTE_KEY>;
-/** Returns whether the current endpoint is marked as a public SaaSiCat route. */
-declare function isSaaSiCatPublicRoute(reflector: Reflector, context: ExecutionContext): boolean;
-
-declare const SETUP_PROVISIONING_PORT_TOKEN: unique symbol;
-declare const SETUP_CONFIG_TOKEN: unique symbol;
-interface SetupConfig {
-    /** Env-var name of the setup token. Without the var set, setup is disabled. */
-    setupTokenEnvVar: string;
-    /** Authenticator issuer for the MFA enrollment in the wizard. */
-    mfaIssuer: string;
-}
-
-declare class SetupService {
-    private readonly users;
-    private readonly config;
-    private readonly mfa;
-    constructor(users: SuperAdminProvisioningPort, config: SetupConfig, mfa: MfaService);
-    status(): Promise<SetupStatusResponse>;
-    setup(req: SetupRequest): Promise<SetupResult>;
-    confirmMfa(req: SetupConfirmMfaRequest): Promise<SetupConfirmMfaResponse>;
-    private assertToken;
-    private assertNoSuperAdmin;
-}
-
-/**
- * Bundles the complete standard SaaSiCat backend stack into a single
- * `forRoot({...})` call. Reduces AppModule boilerplate and eliminates the
- * ordering trap.
- *
- * Quickstart path (Prisma + PostgreSQL on the canonical schema):
- *
- * ```ts
- * SaaSiCatModule.forRoot({
- *     planCatalog: loadPlanCatalogFromFile({ path: 'config/saas.yaml' }),
- *     controller: { guards: [JwtAuthGuard] },
- *     imports: [AuthModule],
- *     persistence: prismaPersistence({ client: PrismaService }), // @saasicat/adapter-prisma
- * })
- * ```
- *
- * Individual `adapters` entries stay supported (custom schema / other ORM)
- * and override bundle slices field by field.
- */
-declare class SaaSiCatModule {
-    static forRoot(options: SaaSiCatModuleOptions): DynamicModule;
-}
-
-/**
- * Typed identity helper for the high-level SaaSiCat configuration. It keeps
- * literal types and gives editors one place for completion without adding
- * runtime behavior.
- */
-declare function defineSaaSiCat<const T extends SaaSiCatModuleOptions>(options: T): T;
-
-export { SetupService as S, SAASICAT_PUBLIC_ROUTE_KEY as a, SETUP_CONFIG_TOKEN as b, SETUP_PROVISIONING_PORT_TOKEN as c, SaaSiCatModule as d, SaaSiCatPublicRoute as e, type SetupConfig as f, defineSaaSiCat as g, isSaaSiCatPublicRoute as i };

package/dist/promo.service-BJbKAmw3.d.cts

@@ -1,112 +0,0 @@
-import { PromoCodeRepository, PromoCodeRedemptionRepository, PromoCodeValidationLogRepository, FirstTimeCustomerCheck, PromoSubscriptionLookup, PromoRevenueDeductionAggregator, TransactionRunner, PlanCatalog, CreatePromoCodeData, PromoCodeRecord, UpdatePromoCodeData, PromoCodeFilter, PromoCodeRedemptionListItem, BillingCycle, PromoPreviewInvalidReason, PromoCodeRedemptionRecord, TransactionContext } from '@saasicat/core';
-
-declare const CODE_MIN_LENGTH = 4;
-declare const CODE_MAX_LENGTH = 32;
-declare const CODE_PATTERN: RegExp;
-type PreviewReason = PromoPreviewInvalidReason;
-type PreviewInvalid = {
-    valid: false;
-    reason: PreviewReason;
-};
-interface PreviewValid {
-    valid: true;
-    code: string;
-    label: string;
-    discount: {
-        valueType: PromoCodeRecord['valueType'];
-        value: string;
-        durationType: PromoCodeRecord['durationType'];
-        durationValue: number | null;
-    };
-    price: {
-        originalGross: string;
-        discountGross: string;
-        discountedGross: string;
-        includedVat: string;
-        nextRegularAmountGross: string;
-        regularStartsAt: string | null;
-    };
-}
-type PreviewResult = PreviewValid | PreviewInvalid;
-interface PreviewInput {
-    code: string;
-    planId: string;
-    billingCycle: BillingCycle;
-    /** For the firstTimeCustomersOnly check. */
-    email?: string;
-    ipHash?: string;
-    sessionId?: string;
-}
-interface RedeemInput {
-    code: string;
-    subscriptionId: string;
-    tenantId: string;
-    /** For the firstTimeCustomersOnly check in the final redeem path. */
-    email?: string;
-}
-interface PromoServiceConfig {
-    /** Plans that are not discountable (e.g. 'ENTERPRISE'). */
-    nonRedeemablePlans?: readonly string[];
-}
-interface PromoCodeStats {
-    code: PromoCodeRecord;
-    validations: number;
-    redemptions: {
-        active: number;
-        total: number;
-        reversed: number;
-        expired: number;
-    };
-    /** Decimal-as-string ('0.00' if no aggregator is available). */
-    revenueDeductionGross: string;
-}
-declare class PromoCodesService {
-    private readonly promoRepo;
-    private readonly redemptionRepo;
-    private readonly validationLogRepo;
-    private readonly firstTimeCheck;
-    private readonly subscriptionLookup;
-    private readonly revenueAggregator;
-    private readonly transactionRunner;
-    private readonly planCatalog;
-    private readonly config;
-    constructor(promoRepo: PromoCodeRepository, redemptionRepo: PromoCodeRedemptionRepository, validationLogRepo: PromoCodeValidationLogRepository, firstTimeCheck: FirstTimeCustomerCheck, subscriptionLookup: PromoSubscriptionLookup, revenueAggregator: PromoRevenueDeductionAggregator, transactionRunner: TransactionRunner, planCatalog: PlanCatalog, config: PromoServiceConfig);
-    create(input: CreatePromoCodeData): Promise<PromoCodeRecord>;
-    update(id: string, input: UpdatePromoCodeData): Promise<PromoCodeRecord>;
-    softDelete(id: string): Promise<void>;
-    findAll(filter?: PromoCodeFilter): Promise<PromoCodeRecord[]>;
-    findOne(id: string): Promise<PromoCodeRecord>;
-    stats(id: string): Promise<PromoCodeStats>;
-    listRedemptions(promoCodeId: string): Promise<PromoCodeRedemptionListItem[]>;
-    preview(input: PreviewInput): Promise<PreviewResult>;
-    /**
-     * Wraps `redeemInTransaction` in its own transaction-runner call —
-     * the default path when the caller has no external tx context
-     * (e.g. POST /billing/promo/redeem as a stand-alone endpoint).
-     */
-    redeem(input: RedeemInput): Promise<PromoCodeRedemptionRecord>;
-    /**
-     * Redeems a promo code within an EXTERNAL transaction — the caller
-     * (typically `TenantSubscriptionWritePort.applyOnboardingSelection`)
-     * already has `prisma.$transaction(...)` open and passes the `tx`
-     * context through. This lands plan change, add-on insert, and redemption
-     * insert in a single DB transaction (P10.1.1).
-     */
-    redeemInTransaction(input: RedeemInput, tx: TransactionContext): Promise<PromoCodeRedemptionRecord>;
-    reverse(subscriptionId: string): Promise<PromoCodeRedemptionRecord | null>;
-    private checkEligibility;
-    private checkFirstTimeCustomer;
-    /**
-     * Lazy expiry: sets codes whose validUntil has passed to EXPIRED.
-     * Called before every find/preview — defense-in-depth alongside the cron.
-     */
-    private lazyExpire;
-    /**
-     * Lowest applicable plan price. With a whitelist it takes the minimum
-     * from the whitelist, otherwise across all marketed plans of the catalog
-     * (except non-redeemable).
-     */
-    private lowestApplicablePlanGross;
-}
-
-export { CODE_MAX_LENGTH as C, type PromoServiceConfig as P, type RedeemInput as R, CODE_MIN_LENGTH as a, CODE_PATTERN as b, type PreviewInput as c, type PreviewInvalid as d, type PreviewReason as e, type PreviewResult as f, type PreviewValid as g, type PromoCodeStats as h, PromoCodesService as i };

package/dist/promo.service-BJbKAmw3.d.ts

@@ -1,112 +0,0 @@
-import { PromoCodeRepository, PromoCodeRedemptionRepository, PromoCodeValidationLogRepository, FirstTimeCustomerCheck, PromoSubscriptionLookup, PromoRevenueDeductionAggregator, TransactionRunner, PlanCatalog, CreatePromoCodeData, PromoCodeRecord, UpdatePromoCodeData, PromoCodeFilter, PromoCodeRedemptionListItem, BillingCycle, PromoPreviewInvalidReason, PromoCodeRedemptionRecord, TransactionContext } from '@saasicat/core';
-
-declare const CODE_MIN_LENGTH = 4;
-declare const CODE_MAX_LENGTH = 32;
-declare const CODE_PATTERN: RegExp;
-type PreviewReason = PromoPreviewInvalidReason;
-type PreviewInvalid = {
-    valid: false;
-    reason: PreviewReason;
-};
-interface PreviewValid {
-    valid: true;
-    code: string;
-    label: string;
-    discount: {
-        valueType: PromoCodeRecord['valueType'];
-        value: string;
-        durationType: PromoCodeRecord['durationType'];
-        durationValue: number | null;
-    };
-    price: {
-        originalGross: string;
-        discountGross: string;
-        discountedGross: string;
-        includedVat: string;
-        nextRegularAmountGross: string;
-        regularStartsAt: string | null;
-    };
-}
-type PreviewResult = PreviewValid | PreviewInvalid;
-interface PreviewInput {
-    code: string;
-    planId: string;
-    billingCycle: BillingCycle;
-    /** For the firstTimeCustomersOnly check. */
-    email?: string;
-    ipHash?: string;
-    sessionId?: string;
-}
-interface RedeemInput {
-    code: string;
-    subscriptionId: string;
-    tenantId: string;
-    /** For the firstTimeCustomersOnly check in the final redeem path. */
-    email?: string;
-}
-interface PromoServiceConfig {
-    /** Plans that are not discountable (e.g. 'ENTERPRISE'). */
-    nonRedeemablePlans?: readonly string[];
-}
-interface PromoCodeStats {
-    code: PromoCodeRecord;
-    validations: number;
-    redemptions: {
-        active: number;
-        total: number;
-        reversed: number;
-        expired: number;
-    };
-    /** Decimal-as-string ('0.00' if no aggregator is available). */
-    revenueDeductionGross: string;
-}
-declare class PromoCodesService {
-    private readonly promoRepo;
-    private readonly redemptionRepo;
-    private readonly validationLogRepo;
-    private readonly firstTimeCheck;
-    private readonly subscriptionLookup;
-    private readonly revenueAggregator;
-    private readonly transactionRunner;
-    private readonly planCatalog;
-    private readonly config;
-    constructor(promoRepo: PromoCodeRepository, redemptionRepo: PromoCodeRedemptionRepository, validationLogRepo: PromoCodeValidationLogRepository, firstTimeCheck: FirstTimeCustomerCheck, subscriptionLookup: PromoSubscriptionLookup, revenueAggregator: PromoRevenueDeductionAggregator, transactionRunner: TransactionRunner, planCatalog: PlanCatalog, config: PromoServiceConfig);
-    create(input: CreatePromoCodeData): Promise<PromoCodeRecord>;
-    update(id: string, input: UpdatePromoCodeData): Promise<PromoCodeRecord>;
-    softDelete(id: string): Promise<void>;
-    findAll(filter?: PromoCodeFilter): Promise<PromoCodeRecord[]>;
-    findOne(id: string): Promise<PromoCodeRecord>;
-    stats(id: string): Promise<PromoCodeStats>;
-    listRedemptions(promoCodeId: string): Promise<PromoCodeRedemptionListItem[]>;
-    preview(input: PreviewInput): Promise<PreviewResult>;
-    /**
-     * Wraps `redeemInTransaction` in its own transaction-runner call —
-     * the default path when the caller has no external tx context
-     * (e.g. POST /billing/promo/redeem as a stand-alone endpoint).
-     */
-    redeem(input: RedeemInput): Promise<PromoCodeRedemptionRecord>;
-    /**
-     * Redeems a promo code within an EXTERNAL transaction — the caller
-     * (typically `TenantSubscriptionWritePort.applyOnboardingSelection`)
-     * already has `prisma.$transaction(...)` open and passes the `tx`
-     * context through. This lands plan change, add-on insert, and redemption
-     * insert in a single DB transaction (P10.1.1).
-     */
-    redeemInTransaction(input: RedeemInput, tx: TransactionContext): Promise<PromoCodeRedemptionRecord>;
-    reverse(subscriptionId: string): Promise<PromoCodeRedemptionRecord | null>;
-    private checkEligibility;
-    private checkFirstTimeCustomer;
-    /**
-     * Lazy expiry: sets codes whose validUntil has passed to EXPIRED.
-     * Called before every find/preview — defense-in-depth alongside the cron.
-     */
-    private lazyExpire;
-    /**
-     * Lowest applicable plan price. With a whitelist it takes the minimum
-     * from the whitelist, otherwise across all marketed plans of the catalog
-     * (except non-redeemable).
-     */
-    private lowestApplicablePlanGross;
-}
-
-export { CODE_MAX_LENGTH as C, type PromoServiceConfig as P, type RedeemInput as R, CODE_MIN_LENGTH as a, CODE_PATTERN as b, type PreviewInput as c, type PreviewInvalid as d, type PreviewReason as e, type PreviewResult as f, type PreviewValid as g, type PromoCodeStats as h, PromoCodesService as i };