@happyvertical/smrt-profiles 0.51.32 → 0.51.34

package/dist/models/OidcProfileEmailReservation.d.ts

@@ -0,0 +1,12 @@
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+export interface OidcProfileEmailReservationOptions extends SmrtObjectOptions {
+    emailKey?: string;
+    profileId?: string;
+}
+/** Private database arbiter for canonical OIDC email provisioning races. */
+export declare class OidcProfileEmailReservation extends SmrtObject {
+    profileId?: string;
+    emailKey: string;
+    constructor(options?: OidcProfileEmailReservationOptions);
+}
+//# sourceMappingURL=OidcProfileEmailReservation.d.ts.map

package/dist/models/OidcProfileEmailReservation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OidcProfileEmailReservation.d.ts","sourceRoot":"","sources":["../../src/models/OidcProfileEmailReservation.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,kCAAmC,SAAQ,iBAAiB;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4EAA4E;AAC5E,qBAMa,2BAA4B,SAAQ,UAAU;IAEzD,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,QAAQ,EAAE,MAAM,CAAM;gBAEV,OAAO,GAAE,kCAAuC;CAK7D"}

package/dist/models/Profile.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Profile model - Core entity representing any profile type
+ *
+ * Central table holding all primary entities with type, email, name, and description.
+ * Uses UUID primary key with relationships to ProfileType for classification.
+ */
+import type { Asset } from '@happyvertical/smrt-assets';
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { ApiKey, GenerateKeyResult } from './ApiKey';
+import type { AuditLog } from './AuditLog';
+import type { NostrIdentity } from './NostrIdentity';
+import type { OidcIdentity } from './OidcIdentity';
+import type { ProfileMetadata } from './ProfileMetadata';
+import type { ProfileRelationship } from './ProfileRelationship';
+export interface ProfileOptions extends SmrtObjectOptions {
+    typeId?: string;
+    email?: string;
+    name?: string;
+    description?: string;
+    tenantId?: string | null;
+}
+export declare class Profile extends SmrtObject {
+    tenantId: string | null;
+    typeId?: string;
+    email?: string;
+    /** Adapter-independent identity lookup key derived from email on save. */
+    emailKey: string | null;
+    name: string;
+    description?: string;
+    metadata: ProfileMetadata[];
+    relationshipsFrom: ProfileRelationship[];
+    relationshipsTo: ProfileRelationship[];
+    constructor(options?: ProfileOptions);
+    /** Keep the durable identity key derived from the public email field. */
+    save(): Promise<this>;
+    /**
+     * Get the profile type slug for this profile
+     *
+     * @returns The slug of the profile type
+     */
+    getTypeSlug(): Promise<string>;
+    /**
+     * Set the profile type by slug
+     *
+     * @param slug - The slug of the profile type
+     * @throws Error if profile type not found
+     */
+    setTypeBySlug(slug: string): Promise<void>;
+    /**
+     * Add metadata to this profile
+     *
+     * @param metafieldSlug - The slug of the metafield
+     * @param value - The value to set
+     */
+    addMetadata(metafieldSlug: string, value: unknown): Promise<void>;
+    /**
+     * Get all metadata for this profile as key-value object
+     *
+     * @returns Object with metafield slugs as keys
+     */
+    getMetadata(): Promise<Record<string, string>>;
+    /**
+     * Update multiple metadata values
+     *
+     * @param metadata - Object with metafield slugs as keys and values
+     */
+    updateMetadata(metadata: Record<string, unknown>): Promise<void>;
+    /**
+     * Remove metadata by metafield slug
+     *
+     * @param metafieldSlug - The slug of the metafield to remove
+     */
+    removeMetadata(metafieldSlug: string): Promise<void>;
+    private getProfileAssetCollection;
+    getAssets(relationship?: string): Promise<Asset[]>;
+    addAsset(asset: Asset, relationship?: string, sortOrder?: number): Promise<void>;
+    removeAsset(assetId: string, relationship?: string): Promise<void>;
+    /**
+     * Add a relationship to another profile
+     *
+     * @param toProfile - The target profile
+     * @param relationshipSlug - The type of relationship
+     * @param contextProfile - Optional context profile for tertiary relationships
+     */
+    addRelationship(toProfile: Profile, relationshipSlug: string, contextProfile?: Profile): Promise<void>;
+    /**
+     * Get all relationships for this profile
+     *
+     * @param options - Filter options (typeSlug, direction)
+     * @returns Array of ProfileRelationship instances
+     */
+    getRelationships(options?: {
+        typeSlug?: string;
+        direction?: 'from' | 'to' | 'all';
+    }): Promise<ProfileRelationship[]>;
+    /**
+     * Get related profiles
+     *
+     * @param relationshipSlug - Optional filter by relationship type slug
+     * @returns Array of related Profile instances
+     */
+    getRelatedProfiles(relationshipSlug?: string): Promise<Profile[]>;
+    /**
+     * Remove a relationship to another profile
+     *
+     * @param toProfile - The target profile
+     * @param relationshipSlug - The type of relationship to remove
+     */
+    removeRelationship(toProfile: Profile, relationshipSlug: string): Promise<void>;
+    /**
+     * AI-powered: Generate a professional bio for this profile
+     *
+     * Uses the `smrtProfiles.profile.generateBio` prompt registered via
+     * `@happyvertical/smrt-prompts`, allowing tenant- or instance-level
+     * overrides of the template, model, and parameters at runtime.
+     *
+     * @returns Generated bio text
+     */
+    generateBio(): Promise<string>;
+    /**
+     * AI-powered: Check if profile matches criteria
+     *
+     * @param criteria - Criteria to match against
+     * @returns True if matches criteria
+     */
+    matches(criteria: string): Promise<boolean>;
+    /**
+     * Find profiles by metadata key-value pair
+     *
+     * @param metafieldSlug - The metafield slug to search
+     * @param value - The value to match
+     * @returns Array of matching profiles
+     */
+    static findByMetadata(_metafieldSlug: string, _value: unknown): Promise<Profile[]>;
+    /**
+     * Find profiles by type slug
+     *
+     * @param typeSlug - The profile type slug
+     * @returns Array of matching profiles
+     */
+    static findByType(_typeSlug: string): Promise<Profile[]>;
+    /**
+     * Find related profiles for a given profile
+     *
+     * @param profileId - The profile UUID
+     * @param relationshipSlug - Optional filter by relationship type
+     * @returns Array of related profiles
+     */
+    static findRelated(_profileId: string, _relationshipSlug?: string): Promise<Profile[]>;
+    /**
+     * Search profiles by email
+     *
+     * @param email - The email to search for
+     * @returns Profile or null if not found
+     */
+    static searchByEmail(_email: string): Promise<Profile | null>;
+    /**
+     * Get all API keys for this profile
+     *
+     * @returns Array of API keys
+     */
+    getApiKeys(): Promise<ApiKey[]>;
+    /**
+     * Get active (non-revoked, non-expired) API keys for this profile
+     *
+     * @returns Array of active API keys
+     */
+    getActiveApiKeys(): Promise<ApiKey[]>;
+    /**
+     * Generate a new API key for this profile
+     *
+     * @param options - Key options (name, scopes, expiration)
+     * @returns The generated key (plaintext) and ApiKey record
+     */
+    generateApiKey(options: {
+        name: string;
+        scopes?: string[];
+        expiresAt?: Date | null;
+    }): Promise<GenerateKeyResult>;
+    /**
+     * Get all OIDC identities linked to this profile
+     *
+     * @returns Array of OIDC identity records
+     */
+    getOidcIdentities(): Promise<OidcIdentity[]>;
+    /**
+     * Reuse an existing exact OIDC identity for this unchanged Profile.
+     *
+     * @param oidcData - OIDC provider data
+     * @returns The linked OIDC identity record
+     * @deprecated New authentication links require owner-aware transactional
+     * provisioning. This compatibility helper may refresh a legacy Profile
+     * type, but refuses to create or rebind authority.
+     */
+    linkOidcIdentity(oidcData: {
+        provider: string;
+        issuer: string;
+        subject: string;
+        email?: string;
+    }): Promise<OidcIdentity>;
+    /**
+     * Get all Nostr identities linked to this profile
+     *
+     * @returns Array of Nostr identity records
+     */
+    getNostrIdentities(): Promise<NostrIdentity[]>;
+    /**
+     * Link a new Nostr identity to this profile
+     *
+     * @param nostrData - Nostr identity data (encrypted keypair)
+     * @returns The linked Nostr identity record
+     */
+    linkNostrIdentity(nostrData: {
+        pubkey: string;
+        encryptedPrivkey: string;
+        encryptionIv: string;
+        encryptionTag: string;
+        email: string;
+        nip05Username?: string;
+    }): Promise<NostrIdentity>;
+    /**
+     * Get audit logs for actions performed by this profile
+     *
+     * @param limit - Maximum number of logs to return
+     * @returns Array of audit log entries
+     */
+    getAuditLogs(limit?: number): Promise<AuditLog[]>;
+    /**
+     * Record an audit log entry for an action by this profile
+     *
+     * @param options - Audit log options
+     * @returns The created audit log entry
+     */
+    recordAction(options: {
+        action: string;
+        resourceType: string;
+        resourceId: string;
+        source?: 'web' | 'cli' | 'ci' | 'webhook' | 'mcp';
+        metadata?: Record<string, unknown>;
+        onBehalfOf?: Profile | null;
+    }): Promise<AuditLog>;
+}
+//# sourceMappingURL=Profile.d.ts.map

package/dist/models/Profile.d.ts.map

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

package/dist/models/ProfileAsset.d.ts

@@ -0,0 +1,18 @@
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import { SmrtObject } from '@happyvertical/smrt-core';
+export interface ProfileAssetOptions extends SmrtObjectOptions {
+    profileId?: string;
+    assetId?: string;
+    relationship?: string;
+    sortOrder?: number;
+    tenantId?: string | null;
+}
+export declare class ProfileAsset extends SmrtObject {
+    tenantId: string | null;
+    profileId: string;
+    assetId: string;
+    relationship: string;
+    sortOrder: number;
+    constructor(options?: ProfileAssetOptions);
+}
+//# sourceMappingURL=ProfileAsset.d.ts.map

package/dist/models/ProfileAsset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileAsset.d.ts","sourceRoot":"","sources":["../../src/models/ProfileAsset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAIL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAQa,YAAa,SAAQ,UAAU;IAE1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,SAAM;IAGf,OAAO,SAAM;IAGb,YAAY,SAAgB;IAG5B,SAAS,SAAK;gBAEF,OAAO,GAAE,mBAAwB;CAQ9C"}

package/dist/models/ProfileMetadata.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ProfileMetadata model - Stores metadata values for profiles
+ *
+ * Links profiles to metafield definitions with actual values.
+ * Uses UUID primary key with foreign keys to Profile and ProfileMetafield.
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+export interface ProfileMetadataOptions extends SmrtObjectOptions {
+    profileId?: string;
+    metafieldId?: string;
+    value?: string;
+    tenantId?: string | null;
+}
+export declare class ProfileMetadata extends SmrtObject {
+    tenantId: string | null;
+    profileId?: string;
+    metafieldId?: string;
+    value: string;
+    constructor(options?: ProfileMetadataOptions);
+    /**
+     * Validate this metadata value against the metafield's validation schema
+     *
+     * @returns True if valid, throws error if invalid
+     */
+    validate(): Promise<boolean>;
+    /**
+     * Get the metafield slug for this metadata
+     *
+     * @returns The slug of the metafield
+     */
+    getMetafieldSlug(): Promise<string>;
+}
+//# sourceMappingURL=ProfileMetadata.d.ts.map

package/dist/models/ProfileMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileMetadata.d.ts","sourceRoot":"","sources":["../../src/models/ProfileMetadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAOa,eAAgB,SAAQ,UAAU;IAE7C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAI/B,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,KAAK,EAAE,MAAM,CAAM;gBAEP,OAAO,GAAE,sBAA2B;IAQhD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAI1C"}

package/dist/models/ProfileMetafield.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ProfileMetafield model - Controlled vocabulary for metadata fields
+ *
+ * Defines allowed metadata keys with validation rules.
+ * Uses UUID primary key with unique slug for human-readable lookups.
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { ValidationSchema, ValidatorFunction } from '../types';
+export interface ProfileMetafieldOptions extends SmrtObjectOptions {
+    slug?: string;
+    name?: string;
+    description?: string;
+    validation?: ValidationSchema;
+    tenantId?: string | null;
+}
+/**
+ * Extend globalThis to include custom validators registry.
+ * Using globalThis ensures all module instances share the same validators,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtProfileMetafieldValidators: Map<string, ValidatorFunction> | undefined;
+}
+export declare class ProfileMetafield extends SmrtObject {
+    tenantId: string | null;
+    name: string;
+    description?: string;
+    validation?: ValidationSchema;
+    constructor(options?: ProfileMetafieldOptions);
+    /**
+     * Convenience method for slug-based lookup
+     *
+     * @param slug - The slug to search for
+     * @returns ProfileMetafield instance or null if not found
+     */
+    static getBySlug(_slug: string): Promise<ProfileMetafield | null>;
+    /**
+     * Register a custom validator function
+     *
+     * @param name - Name of the validator (used in validation.custom field)
+     * @param validator - The validator function
+     */
+    static registerValidator(name: string, validator: ValidatorFunction): void;
+    /**
+     * Get a registered custom validator
+     *
+     * @param name - Name of the validator
+     * @returns The validator function or undefined
+     */
+    static getValidator(name: string): ValidatorFunction | undefined;
+    /**
+     * Validate a value against this metafield's validation schema
+     *
+     * @param value - The value to validate
+     * @returns True if valid, throws ValidationError if invalid
+     */
+    validateValue(value: unknown): Promise<boolean>;
+}
+//# sourceMappingURL=ProfileMetafield.d.ts.map

package/dist/models/ProfileMetafield.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileMetafield.d.ts","sourceRoot":"","sources":["../../src/models/ProfileMetafield.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEpE,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,gCAAgC,EAChC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC9B,SAAS,CAAC;CACf;AAeD,qBAOa,gBAAiB,SAAQ,UAAU;IAE9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAK/B,IAAI,EAAE,MAAM,CAAM;IAElB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,UAAU,CAAC,EAAE,gBAAgB,CAAC;gBAElB,OAAO,GAAE,uBAA4B;IAQjD;;;;;OAKG;WACU,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKvE;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAI1E;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhE;;;;;OAKG;IACG,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAqFtD"}

package/dist/models/ProfileRelationship.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ProfileRelationship model - Connects two profiles with a relationship type
+ *
+ * Represents directional or reciprocal relationships between profiles.
+ * Uses UUID primary key with foreign keys to profiles and relationship type.
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { ProfileRelationshipTerm } from './ProfileRelationshipTerm';
+export interface ProfileRelationshipOptions extends SmrtObjectOptions {
+    fromProfileId?: string;
+    toProfileId?: string;
+    typeId?: string;
+    contextProfileId?: string;
+    tenantId?: string | null;
+}
+export declare class ProfileRelationship extends SmrtObject {
+    tenantId: string | null;
+    fromProfileId?: string;
+    toProfileId?: string;
+    typeId?: string;
+    contextProfileId?: string;
+    terms: ProfileRelationshipTerm[];
+    constructor(options?: ProfileRelationshipOptions);
+    /**
+     * Get the relationship type slug
+     *
+     * @returns The slug of the relationship type
+     */
+    getTypeSlug(): Promise<string>;
+    /**
+     * Add a term (time period) to this relationship
+     *
+     * @param startedAt - Start date of the term
+     * @param endedAt - Optional end date of the term
+     */
+    addTerm(startedAt: Date, endedAt?: Date): Promise<void>;
+    /**
+     * End the current active term
+     *
+     * @param endedAt - End date for the term
+     */
+    endCurrentTerm(endedAt: Date): Promise<void>;
+    /**
+     * Get all terms for this relationship
+     *
+     * @returns Array of ProfileRelationshipTerm instances
+     */
+    getTerms(): Promise<ProfileRelationshipTerm[]>;
+    /**
+     * Get the active term (no end date)
+     *
+     * @returns Current term or null if none active
+     */
+    getActiveTerm(): Promise<ProfileRelationshipTerm | null>;
+}
+//# sourceMappingURL=ProfileRelationship.d.ts.map

package/dist/models/ProfileRelationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileRelationship.d.ts","sourceRoot":"","sources":["../../src/models/ProfileRelationship.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAOa,mBAAoB,SAAQ,UAAU;IAEjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAI/B,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAI1B,KAAK,EAAE,uBAAuB,EAAE,CAAM;gBAE1B,OAAO,GAAE,0BAA+B;IAWpD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpC;;;;;OAKG;IACG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7D;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAYpD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CAW/D"}

package/dist/models/ProfileRelationshipTerm.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ProfileRelationshipTerm model - Temporal data for relationships
+ *
+ * Defines the duration or terms of a specific relationship.
+ * Uses UUID primary key with foreign key to ProfileRelationship.
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+export interface ProfileRelationshipTermOptions extends SmrtObjectOptions {
+    relationshipId?: string;
+    startedAt?: Date;
+    endedAt?: Date;
+}
+export declare class ProfileRelationshipTerm extends SmrtObject {
+    relationshipId?: string;
+    startedAt: Date;
+    endedAt?: Date;
+    constructor(options?: ProfileRelationshipTermOptions);
+    /**
+     * Check if this term is currently active
+     *
+     * @returns True if active (no end date or end date in future)
+     */
+    isActive(): boolean;
+    /**
+     * End this term
+     *
+     * @param endedAt - End date for the term (defaults to now)
+     */
+    end(endedAt?: Date): Promise<void>;
+    /**
+     * Get the duration of this term in days
+     *
+     * @returns Duration in days
+     */
+    getDurationDays(): number;
+}
+//# sourceMappingURL=ProfileRelationshipTerm.d.ts.map

package/dist/models/ProfileRelationshipTerm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileRelationshipTerm.d.ts","sourceRoot":"","sources":["../../src/models/ProfileRelationshipTerm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,8BAA+B,SAAQ,iBAAiB;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,qBAMa,uBAAwB,SAAQ,UAAU;IAGrD,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,SAAS,EAAE,IAAI,CAAc;IAE7B,OAAO,CAAC,EAAE,IAAI,CAAC;gBAEH,OAAO,GAAE,8BAAmC;IAQxD;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAKnB;;;;OAIG;IACG,GAAG,CAAC,OAAO,GAAE,IAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;;;OAIG;IACH,eAAe,IAAI,MAAM;CAK1B"}

package/dist/models/ProfileRelationshipType.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ProfileRelationshipType model - Lookup table for relationship types
+ *
+ * Defines the kinds of relationships that can exist between profiles.
+ * Uses UUID primary key with unique slug for human-readable lookups.
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { ReciprocalHandler } from '../types';
+export interface ProfileRelationshipTypeOptions extends SmrtObjectOptions {
+    slug?: string;
+    name?: string;
+    reciprocal?: boolean;
+}
+/**
+ * Extend globalThis to include reciprocal handlers registry.
+ * Using globalThis ensures all module instances share the same handlers,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtProfileRelationshipHandlers: Map<string, ReciprocalHandler> | undefined;
+    var __smrtProfileRelationshipHandlersInitialized: boolean | undefined;
+}
+export declare class ProfileRelationshipType extends SmrtObject {
+    name: string;
+    reciprocal: boolean;
+    constructor(options?: ProfileRelationshipTypeOptions);
+    /**
+     * Convenience method for slug-based lookup
+     *
+     * @param slug - The slug to search for
+     * @returns ProfileRelationshipType instance or null if not found
+     */
+    static getBySlug(_slug: string): Promise<ProfileRelationshipType | null>;
+    /**
+     * Register a custom reciprocal handler for a relationship type
+     *
+     * @param slug - The relationship type slug
+     * @param handler - The handler function to execute when creating reciprocal relationship
+     */
+    static registerReciprocalHandler(slug: string, handler: ReciprocalHandler): void;
+    /**
+     * Get the reciprocal handler for a relationship type
+     *
+     * @param slug - The relationship type slug
+     * @returns The handler function or undefined
+     */
+    static getReciprocalHandler(slug: string): ReciprocalHandler | undefined;
+    /**
+     * Check if a relationship type is reciprocal
+     *
+     * @param slug - The relationship type slug
+     * @returns True if reciprocal, false otherwise
+     */
+    static isReciprocal(slug: string): Promise<boolean>;
+}
+//# sourceMappingURL=ProfileRelationshipType.d.ts.map

package/dist/models/ProfileRelationshipType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileRelationshipType.d.ts","sourceRoot":"","sources":["../../src/models/ProfileRelationshipType.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,8BAA+B,SAAQ,iBAAiB;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,iCAAiC,EACjC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC9B,SAAS,CAAC;IAEd,IAAI,4CAA4C,EAAE,OAAO,GAAG,SAAS,CAAC;CACvE;AAiDD,qBAMa,uBAAwB,SAAQ,UAAU;IAIrD,IAAI,EAAE,MAAM,CAAM;IAElB,UAAU,EAAE,OAAO,CAAQ;gBAEf,OAAO,GAAE,8BAAmC;IAMxD;;;;;OAKG;WACU,SAAS,CACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAK1C;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GACzB,IAAI;IAIP;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIxE;;;;;OAKG;WACU,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAI1D"}

package/dist/models/ProfileType.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ProfileType model - Lookup table defining profile types
+ *
+ * Represents the nature of a profile (e.g., 'human', 'org', 'robot').
+ * Uses UUID primary key with unique slug for human-readable lookups.
+ */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+export interface ProfileTypeOptions extends SmrtObjectOptions {
+    slug?: string;
+    name?: string;
+    description?: string;
+    tenantId?: string | null;
+}
+export declare class ProfileType extends SmrtObject {
+    tenantId: string | null;
+    name: string;
+    description?: string;
+    constructor(options?: ProfileTypeOptions);
+    /**
+     * Convenience method for slug-based lookup
+     *
+     * @param slug - The slug to search for
+     * @returns ProfileType instance or null if not found
+     */
+    static getBySlug(_slug: string): Promise<ProfileType | null>;
+}
+//# sourceMappingURL=ProfileType.d.ts.map

package/dist/models/ProfileType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileType.d.ts","sourceRoot":"","sources":["../../src/models/ProfileType.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAOa,WAAY,SAAQ,UAAU;IAEzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAK/B,IAAI,EAAE,MAAM,CAAM;IAElB,WAAW,CAAC,EAAE,MAAM,CAAC;gBAET,OAAO,GAAE,kBAAuB;IAO5C;;;;;OAKG;WACU,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;CAInE"}

package/dist/models/ProfileTypes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Profile subclasses for STI (Single Table Inheritance)
+ *
+ * These classes inherit from Profile and automatically use the shared
+ * profiles table with _meta_type discriminator.
+ */
+import { Profile, type ProfileOptions } from './Profile';
+/**
+ * Person profile type
+ *
+ * Represents individual people/users.
+ */
+export declare class Person extends Profile {
+    constructor(options?: ProfileOptions);
+}
+/**
+ * Organization profile type
+ *
+ * Represents companies, groups, institutions, and other organizational entities.
+ */
+export declare class Organization extends Profile {
+    constructor(options?: ProfileOptions);
+}
+/**
+ * Bot profile type
+ *
+ * Represents automated agents, bots, and AI entities.
+ */
+export declare class Bot extends Profile {
+    constructor(options?: ProfileOptions);
+}
+//# sourceMappingURL=ProfileTypes.d.ts.map

package/dist/models/ProfileTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileTypes.d.ts","sourceRoot":"","sources":["../../src/models/ProfileTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEzD;;;;GAIG;AACH,qBAGa,MAAO,SAAQ,OAAO;gBACrB,OAAO,GAAE,cAAmB;CAIzC;AAED;;;;GAIG;AACH,qBAGa,YAAa,SAAQ,OAAO;gBAC3B,OAAO,GAAE,cAAmB;CAIzC;AAED;;;;GAIG;AACH,qBAGa,GAAI,SAAQ,OAAO;gBAClB,OAAO,GAAE,cAAmB;CAIzC"}

package/dist/models/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SMRT model exports for profiles package
+ */
+export { ApiKey, type ApiKeyOptions, type GenerateKeyResult } from './ApiKey';
+export { AuditLog, type AuditLogOptions, type AuditSource } from './AuditLog';
+export { type GenerateTokenResult, MagicLinkToken, type MagicLinkTokenOptions, } from './MagicLinkToken';
+export { NostrIdentity, type NostrIdentityOptions } from './NostrIdentity';
+export { OidcIdentity, type OidcIdentityOptions } from './OidcIdentity';
+export { OidcProfileEmailReservation, type OidcProfileEmailReservationOptions, } from './OidcProfileEmailReservation';
+export { Profile } from './Profile';
+export { ProfileMetadata } from './ProfileMetadata';
+export { ProfileMetafield } from './ProfileMetafield';
+export { ProfileRelationship } from './ProfileRelationship';
+export { ProfileRelationshipTerm } from './ProfileRelationshipTerm';
+export { ProfileRelationshipType } from './ProfileRelationshipType';
+export { ProfileType } from './ProfileType';
+export { Bot, Organization, Person } from './ProfileTypes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EACL,KAAK,mBAAmB,EACxB,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EACL,2BAA2B,EAC3B,KAAK,kCAAkC,GACxC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}