@happyvertical/smrt-users 0.57.2 → 0.57.3

package/dist/member-register/index.d.ts

@@ -0,0 +1,3 @@
+export * from './models.js';
+export * from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/member-register/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/member-register/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/member-register/models.d.ts

@@ -0,0 +1,103 @@
+/** Tenant-scoped legal member-register records. */
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+export type LegalMemberKind = 'individual' | 'organisation';
+export type LegalMemberStatus = 'active' | 'suspended' | 'resigned' | 'ceased';
+export type MemberReferenceKind = 'share' | 'dues' | 'subscription' | 'agreement' | 'ledger';
+/** A tenant-configured legal class; it has no authority or entitlement effect. */
+export declare class MemberClass extends SmrtObject {
+    tenantId: string;
+    key: string;
+    name: string;
+    description: string;
+    /** Host-defined policy hints only; the register does not interpret law. */
+    policyMetadata: Record<string, unknown> | null;
+}
+/** The legal register entry, deliberately separate from RBAC Membership. */
+export declare class LegalMember extends SmrtObject {
+    tenantId: string;
+    memberClassId: string;
+    kind: LegalMemberKind;
+    displayName: string;
+    /** Optional login identity. Its tenant authority is intentionally irrelevant. */
+    userId: string | null;
+    /** Optional person or organisation profile; an external party needs neither. */
+    profileId: string | null;
+    /** A host-owned external-party key, not an inferred identity. */
+    externalPartyRef: string | null;
+    joinedOn: string;
+    leftOn: string | null;
+    status: LegalMemberStatus;
+}
+/** Append-only effective history; current status never erases it. */
+export declare class LegalMemberStatusHistory extends SmrtObject {
+    tenantId: string;
+    memberId: string;
+    status: LegalMemberStatus;
+    effectiveOn: string;
+    /** Stable correction order for entries sharing an effective date. */
+    sequence: number;
+    reason: string;
+    actorRef: string | null;
+    /** History is corrected by appending another effective entry, never rewriting it. */
+    save(): Promise<this>;
+    delete(): Promise<void>;
+}
+/** A link to authoritative share/dues/subscription/agreement/ledger evidence. */
+export declare class LegalMemberReference extends SmrtObject {
+    tenantId: string;
+    memberId: string;
+    kind: MemberReferenceKind;
+    /** Qualified external model name or host namespace, e.g. @happyvertical/smrt-ledgers:JournalEntry. */
+    sourceType: string;
+    sourceId: string;
+    /** Whether a caller supplied authoritative evidence; no balance is duplicated here. */
+    authoritative: boolean;
+    /** The date on which this evidence may first support a record-date decision. */
+    effectiveFrom: string;
+    effectiveTo: string | null;
+    /** Original evidence withdrawn by this append-only dated record. */
+    revokesId: string | null;
+    save(): Promise<this>;
+    delete(): Promise<void>;
+}
+/** A dated register of board/officer appointments; it does not implement elections. */
+export declare class MemberOfficerAppointment extends SmrtObject {
+    tenantId: string;
+    memberId: string;
+    role: string;
+    effectiveFrom: string;
+    effectiveTo: string | null;
+    /** Host-defined authority descriptors; this is not an RBAC grant. */
+    authority: Record<string, unknown> | null;
+}
+export declare class MemberEligibilitySnapshot extends SmrtObject {
+    tenantId: string;
+    memberId: string;
+    recordDate: string;
+    eligible: boolean;
+    reason: string;
+    /** Preserves inputs, including unavailable evidence, for a neutral export. */
+    evidence: Record<string, unknown> | null;
+    /** Record-date evidence is immutable; a later request creates a new snapshot. */
+    save(): Promise<this>;
+    delete(): Promise<void>;
+}
+export declare class MemberClassCollection extends SmrtCollection<MemberClass> {
+    static readonly _itemClass: typeof MemberClass;
+}
+export declare class LegalMemberCollection extends SmrtCollection<LegalMember> {
+    static readonly _itemClass: typeof LegalMember;
+}
+export declare class LegalMemberStatusHistoryCollection extends SmrtCollection<LegalMemberStatusHistory> {
+    static readonly _itemClass: typeof LegalMemberStatusHistory;
+}
+export declare class LegalMemberReferenceCollection extends SmrtCollection<LegalMemberReference> {
+    static readonly _itemClass: typeof LegalMemberReference;
+}
+export declare class MemberOfficerAppointmentCollection extends SmrtCollection<MemberOfficerAppointment> {
+    static readonly _itemClass: typeof MemberOfficerAppointment;
+}
+export declare class MemberEligibilitySnapshotCollection extends SmrtCollection<MemberEligibilitySnapshot> {
+    static readonly _itemClass: typeof MemberEligibilitySnapshot;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/member-register/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/member-register/models.ts"],"names":[],"mappings":"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"}

package/dist/member-register/service.d.ts

@@ -0,0 +1,79 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type LegalMember, type LegalMemberKind, type LegalMemberReference, type LegalMemberStatus, type MemberClass, type MemberOfficerAppointment, type MemberReferenceKind } from './models.js';
+export type IsoDate = string;
+export declare class MemberRegisterError extends Error {
+    readonly code: 'MEMBER_REGISTER_INVALID' | 'MEMBER_REGISTER_NOT_FOUND' | 'MEMBER_REGISTER_TENANT_MISMATCH';
+    constructor(code: 'MEMBER_REGISTER_INVALID' | 'MEMBER_REGISTER_NOT_FOUND' | 'MEMBER_REGISTER_TENANT_MISMATCH', message: string);
+}
+export interface MemberRegisterActor {
+    tenantId: string;
+    actorRef?: string;
+}
+export interface EligibilityPolicy {
+    memberClassKeys?: readonly string[];
+    statuses?: readonly LegalMemberStatus[];
+    requireAuthoritativeKinds?: readonly MemberReferenceKind[];
+}
+export interface EligibilityRow {
+    memberId: string;
+    displayName: string;
+    memberClassKey: string;
+    recordDate: IsoDate;
+    eligible: boolean;
+    reason: string;
+    evidence: Record<string, unknown>;
+}
+/** Trusted, tenant-scoped register writer. Hosts authorize the actor before construction. */
+export declare class MemberRegisterService {
+    private readonly db;
+    private readonly actor;
+    private readonly transactionBound?;
+    private static readonly transactionToken;
+    constructor(db: DatabaseInterface, actor: MemberRegisterActor, transactionBound?: symbol | undefined);
+    private transaction;
+    private scope;
+    private member;
+    private assertReferenceKind;
+    addClass(input: {
+        key: string;
+        name: string;
+        description?: string;
+        policyMetadata?: Record<string, unknown> | null;
+    }): Promise<MemberClass>;
+    enroll(input: {
+        memberClassId: string;
+        kind: LegalMemberKind;
+        displayName: string;
+        joinedOn: IsoDate;
+        userId?: string | null;
+        profileId?: string | null;
+        externalPartyRef?: string | null;
+    }): Promise<LegalMember>;
+    setStatus(memberId: string, input: {
+        status: LegalMemberStatus;
+        effectiveOn: IsoDate;
+        reason?: string;
+    }): Promise<LegalMember>;
+    addReference(memberId: string, input: {
+        kind: MemberReferenceKind;
+        sourceType: string;
+        sourceId: string;
+        authoritative?: boolean;
+        effectiveFrom: IsoDate;
+        effectiveTo?: IsoDate | null;
+    }): Promise<LegalMemberReference>;
+    /** Append a dated withdrawal without changing past evidence or snapshots. */
+    revokeReference(referenceId: string, input: {
+        effectiveOn: IsoDate;
+    }): Promise<LegalMemberReference>;
+    appoint(memberId: string, input: {
+        role: string;
+        effectiveFrom: IsoDate;
+        effectiveTo?: IsoDate | null;
+        authority?: Record<string, unknown> | null;
+    }): Promise<MemberOfficerAppointment>;
+    asOf(recordDate: IsoDate, policy?: EligibilityPolicy): Promise<EligibilityRow[]>;
+    static exportJson(rows: readonly EligibilityRow[]): string;
+    static exportCsv(rows: readonly EligibilityRow[]): string;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/member-register/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/member-register/service.ts"],"names":[],"mappings":"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"}