@eduardbar/drift 1.3.0 → 1.4.0

package/dist/saas/types.d.ts

@@ -0,0 +1,191 @@
+import type { DriftConfig, DriftReport } from '../types.js';
+export interface SaasPolicy {
+    freeUserThreshold: number;
+    maxRunsPerWorkspacePerMonth: number;
+    maxReposPerWorkspace: number;
+    retentionDays: number;
+    strictActorEnforcement: boolean;
+    maxWorkspacesPerOrganizationByPlan: Record<SaasPlan, number>;
+}
+export type SaasRole = 'owner' | 'member' | 'viewer';
+export type SaasPlan = 'free' | 'sponsor' | 'team' | 'business';
+export interface SaasUser {
+    id: string;
+    createdAt: string;
+    lastSeenAt: string;
+}
+export interface SaasOrganization {
+    id: string;
+    plan: SaasPlan;
+    createdAt: string;
+    lastSeenAt: string;
+    workspaceIds: string[];
+}
+export interface SaasWorkspace {
+    id: string;
+    organizationId: string;
+    createdAt: string;
+    lastSeenAt: string;
+    userIds: string[];
+    repoIds: string[];
+}
+export interface SaasRepo {
+    id: string;
+    organizationId: string;
+    workspaceId: string;
+    name: string;
+    createdAt: string;
+    lastSeenAt: string;
+}
+export interface SaasMembership {
+    id: string;
+    organizationId: string;
+    workspaceId: string;
+    userId: string;
+    role: SaasRole;
+    createdAt: string;
+    lastSeenAt: string;
+}
+export interface SaasPlanChange {
+    id: string;
+    organizationId: string;
+    fromPlan: SaasPlan;
+    toPlan: SaasPlan;
+    changedAt: string;
+    changedByUserId: string;
+    reason?: string;
+}
+export interface SaasSnapshot {
+    id: string;
+    createdAt: string;
+    scannedAt: string;
+    organizationId: string;
+    workspaceId: string;
+    userId: string;
+    role: SaasRole;
+    plan: SaasPlan;
+    repoId: string;
+    repoName: string;
+    targetPath: string;
+    totalScore: number;
+    totalIssues: number;
+    totalFiles: number;
+    summary: {
+        errors: number;
+        warnings: number;
+        infos: number;
+    };
+}
+export interface SaasStore {
+    version: number;
+    policy: SaasPolicy;
+    users: Record<string, SaasUser>;
+    organizations: Record<string, SaasOrganization>;
+    workspaces: Record<string, SaasWorkspace>;
+    memberships: Record<string, SaasMembership>;
+    repos: Record<string, SaasRepo>;
+    snapshots: SaasSnapshot[];
+    planChanges: SaasPlanChange[];
+}
+export type SaasOperation = 'snapshot:write' | 'snapshot:read' | 'summary:read' | 'billing:write' | 'billing:read';
+export interface SaasPermissionContext {
+    operation: SaasOperation;
+    organizationId: string;
+    workspaceId?: string;
+    actorUserId?: string;
+}
+export interface SaasPermissionResult {
+    actorRole?: SaasRole;
+    requiredRole: SaasRole;
+}
+export interface SaasEffectiveLimits {
+    plan: SaasPlan;
+    maxWorkspaces: number;
+    maxReposPerWorkspace: number;
+    maxRunsPerWorkspacePerMonth: number;
+    retentionDays: number;
+}
+export interface SaasOrganizationUsageSnapshot {
+    organizationId: string;
+    plan: SaasPlan;
+    capturedAt: string;
+    workspaceCount: number;
+    repoCount: number;
+    runCount: number;
+    runCountThisMonth: number;
+}
+export interface ChangeOrganizationPlanOptions {
+    organizationId: string;
+    actorUserId: string;
+    newPlan: SaasPlan;
+    reason?: string;
+    storeFile?: string;
+    policy?: SaasPolicyOverrides;
+}
+export interface SaasUsageQueryOptions {
+    organizationId: string;
+    month?: string;
+    storeFile?: string;
+    policy?: SaasPolicyOverrides;
+    actorUserId?: string;
+}
+export interface SaasPlanChangeQueryOptions {
+    organizationId: string;
+    storeFile?: string;
+    policy?: SaasPolicyOverrides;
+    actorUserId?: string;
+}
+export interface SaasSummary {
+    policy: SaasPolicy;
+    usersRegistered: number;
+    workspacesActive: number;
+    reposActive: number;
+    runsPerMonth: Record<string, number>;
+    totalSnapshots: number;
+    phase: 'free' | 'paid';
+    thresholdReached: boolean;
+    freeUsersRemaining: number;
+}
+export interface SaasPolicyOverrides {
+    freeUserThreshold?: number;
+    maxRunsPerWorkspacePerMonth?: number;
+    maxReposPerWorkspace?: number;
+    retentionDays?: number;
+    strictActorEnforcement?: boolean;
+    maxWorkspacesPerOrganizationByPlan?: Partial<Record<SaasPlan, number>>;
+}
+export interface SaasQueryOptions {
+    storeFile?: string;
+    policy?: SaasPolicyOverrides;
+    organizationId?: string;
+    workspaceId?: string;
+    actorUserId?: string;
+}
+export interface IngestOptions {
+    organizationId?: string;
+    workspaceId: string;
+    userId: string;
+    role?: SaasRole;
+    plan?: SaasPlan;
+    repoName?: string;
+    actorUserId?: string;
+    storeFile?: string;
+    policy?: SaasPolicyOverrides;
+}
+export interface ScopedIdentity {
+    organizationId: string;
+    workspaceId: string;
+    workspaceKey: string;
+    repoName: string;
+    repoId: string;
+}
+export interface IngestMutationContext {
+    store: SaasStore;
+    scoped: ScopedIdentity;
+    options: IngestOptions;
+    nowIso: string;
+    requestedPlan: SaasPlan;
+}
+export type SaasPolicyInput = SaasPolicyOverrides | DriftConfig['saas'] | undefined;
+export type DriftReportInput = DriftReport;
+//# sourceMappingURL=types.d.ts.map

package/dist/saas/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/saas.d.ts

@@ -1,219 +1,9 @@
-import type { DriftReport, DriftConfig } from './types.js';
-export interface SaasPolicy {
-    freeUserThreshold: number;
-    maxRunsPerWorkspacePerMonth: number;
-    maxReposPerWorkspace: number;
-    retentionDays: number;
-    strictActorEnforcement: boolean;
-    maxWorkspacesPerOrganizationByPlan: Record<SaasPlan, number>;
-}
-export type SaasRole = 'owner' | 'member' | 'viewer';
-export type SaasPlan = 'free' | 'sponsor' | 'team' | 'business';
-export interface SaasUser {
-    id: string;
-    createdAt: string;
-    lastSeenAt: string;
-}
-export interface SaasOrganization {
-    id: string;
-    plan: SaasPlan;
-    createdAt: string;
-    lastSeenAt: string;
-    workspaceIds: string[];
-}
-export interface SaasWorkspace {
-    id: string;
-    organizationId: string;
-    createdAt: string;
-    lastSeenAt: string;
-    userIds: string[];
-    repoIds: string[];
-}
-export interface SaasRepo {
-    id: string;
-    organizationId: string;
-    workspaceId: string;
-    name: string;
-    createdAt: string;
-    lastSeenAt: string;
-}
-export interface SaasMembership {
-    id: string;
-    organizationId: string;
-    workspaceId: string;
-    userId: string;
-    role: SaasRole;
-    createdAt: string;
-    lastSeenAt: string;
-}
-export interface SaasPlanChange {
-    id: string;
-    organizationId: string;
-    fromPlan: SaasPlan;
-    toPlan: SaasPlan;
-    changedAt: string;
-    changedByUserId: string;
-    reason?: string;
-}
-export interface SaasSnapshot {
-    id: string;
-    createdAt: string;
-    scannedAt: string;
-    organizationId: string;
-    workspaceId: string;
-    userId: string;
-    role: SaasRole;
-    plan: SaasPlan;
-    repoId: string;
-    repoName: string;
-    targetPath: string;
-    totalScore: number;
-    totalIssues: number;
-    totalFiles: number;
-    summary: {
-        errors: number;
-        warnings: number;
-        infos: number;
-    };
-}
-export interface SaasStore {
-    version: number;
-    policy: SaasPolicy;
-    users: Record<string, SaasUser>;
-    organizations: Record<string, SaasOrganization>;
-    workspaces: Record<string, SaasWorkspace>;
-    memberships: Record<string, SaasMembership>;
-    repos: Record<string, SaasRepo>;
-    snapshots: SaasSnapshot[];
-    planChanges: SaasPlanChange[];
-}
-export type SaasOperation = 'snapshot:write' | 'snapshot:read' | 'summary:read' | 'billing:write' | 'billing:read';
-export interface SaasPermissionContext {
-    operation: SaasOperation;
-    organizationId: string;
-    workspaceId?: string;
-    actorUserId?: string;
-}
-export interface SaasPermissionResult {
-    actorRole?: SaasRole;
-    requiredRole: SaasRole;
-}
-export interface SaasEffectiveLimits {
-    plan: SaasPlan;
-    maxWorkspaces: number;
-    maxReposPerWorkspace: number;
-    maxRunsPerWorkspacePerMonth: number;
-    retentionDays: number;
-}
-export interface SaasOrganizationUsageSnapshot {
-    organizationId: string;
-    plan: SaasPlan;
-    capturedAt: string;
-    workspaceCount: number;
-    repoCount: number;
-    runCount: number;
-    runCountThisMonth: number;
-}
-export interface ChangeOrganizationPlanOptions {
-    organizationId: string;
-    actorUserId: string;
-    newPlan: SaasPlan;
-    reason?: string;
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-}
-export interface SaasUsageQueryOptions {
-    organizationId: string;
-    month?: string;
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-    actorUserId?: string;
-}
-export interface SaasPlanChangeQueryOptions {
-    organizationId: string;
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-    actorUserId?: string;
-}
-export interface SaasSummary {
-    policy: SaasPolicy;
-    usersRegistered: number;
-    workspacesActive: number;
-    reposActive: number;
-    runsPerMonth: Record<string, number>;
-    totalSnapshots: number;
-    phase: 'free' | 'paid';
-    thresholdReached: boolean;
-    freeUsersRemaining: number;
-}
-export interface SaasPolicyOverrides {
-    freeUserThreshold?: number;
-    maxRunsPerWorkspacePerMonth?: number;
-    maxReposPerWorkspace?: number;
-    retentionDays?: number;
-    strictActorEnforcement?: boolean;
-    maxWorkspacesPerOrganizationByPlan?: Partial<Record<SaasPlan, number>>;
-}
-export interface SaasQueryOptions {
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-    organizationId?: string;
-    workspaceId?: string;
-    actorUserId?: string;
-}
-export interface IngestOptions {
-    organizationId?: string;
-    workspaceId: string;
-    userId: string;
-    role?: SaasRole;
-    plan?: SaasPlan;
-    repoName?: string;
-    actorUserId?: string;
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-}
-export declare class SaasPermissionError extends Error {
-    readonly code = "SAAS_PERMISSION_DENIED";
-    readonly operation: SaasOperation;
-    readonly organizationId: string;
-    readonly workspaceId?: string;
-    readonly actorUserId?: string;
-    readonly requiredRole: SaasRole;
-    readonly actorRole?: SaasRole;
-    constructor(context: SaasPermissionContext, requiredRole: SaasRole, actorRole?: SaasRole);
-}
-export declare class SaasActorRequiredError extends Error {
-    readonly code = "SAAS_ACTOR_REQUIRED";
-    readonly operation: SaasOperation;
-    readonly organizationId: string;
-    readonly workspaceId?: string;
-    constructor(context: SaasPermissionContext);
-}
-export declare const DEFAULT_SAAS_POLICY: SaasPolicy;
-export declare function resolveSaasPolicy(policy?: SaasPolicyOverrides | DriftConfig['saas']): SaasPolicy;
-export declare function defaultSaasStorePath(root?: string): string;
-export declare function getRequiredRoleForOperation(operation: SaasOperation): SaasRole;
-export declare function assertSaasPermission(context: SaasPermissionContext & {
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-}): SaasPermissionResult;
-export declare function getSaasEffectiveLimits(input: {
-    plan: SaasPlan;
-    policy?: SaasPolicyOverrides;
-}): SaasEffectiveLimits;
-export declare function getOrganizationEffectiveLimits(options: {
-    organizationId: string;
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-}): SaasEffectiveLimits;
-export declare function changeOrganizationPlan(options: ChangeOrganizationPlanOptions): SaasPlanChange;
-export declare function listOrganizationPlanChanges(options: SaasPlanChangeQueryOptions): SaasPlanChange[];
-export declare function getOrganizationUsageSnapshot(options: SaasUsageQueryOptions): SaasOrganizationUsageSnapshot;
-export declare function ingestSnapshotFromReport(report: DriftReport, options: IngestOptions): SaasSnapshot;
-export declare function listSaasSnapshots(options?: SaasQueryOptions): SaasSnapshot[];
-export declare function getSaasSummary(options?: SaasQueryOptions): SaasSummary;
-export declare function generateSaasDashboardHtml(options?: {
-    storeFile?: string;
-    policy?: SaasPolicyOverrides;
-}): string;
+export { DEFAULT_SAAS_POLICY } from './saas/constants.js';
+export { SaasActorRequiredError, SaasPermissionError } from './saas/errors.js';
+export { resolveSaasPolicy, } from './saas/helpers.js';
+export { defaultSaasStorePath, getRequiredRoleForOperation, assertSaasPermission, getSaasEffectiveLimits, getOrganizationEffectiveLimits, } from './saas/store.js';
+export { ingestSnapshotFromReport } from './saas/ingest.js';
+export { changeOrganizationPlan, listOrganizationPlanChanges, getOrganizationUsageSnapshot, } from './saas/organization.js';
+export { listSaasSnapshots, getSaasSummary, generateSaasDashboardHtml, } from './saas/dashboard.js';
+export type { SaasUser, SaasOrganization, SaasWorkspace, SaasRepo, SaasMembership, SaasRole, SaasPlan, SaasPolicy, SaasPolicyOverrides, SaasStore, SaasSummary, SaasSnapshot, SaasQueryOptions, IngestOptions, SaasPlanChange, SaasOperation, SaasPermissionContext, SaasPermissionResult, SaasEffectiveLimits, SaasOrganizationUsageSnapshot, ChangeOrganizationPlanOptions, SaasUsageQueryOptions, SaasPlanChangeQueryOptions, } from './saas/types.js';
 //# sourceMappingURL=saas.d.ts.map