@happyvertical/smrt-users 0.30.0

package/dist/models/CliAuthRequest.d.ts

@@ -0,0 +1,25 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * CLI auth request lifecycle states.
+ */
+export type CliAuthRequestStatus = 'pending' | 'approved' | 'expired';
+export declare class UsersCliAuthRequest extends SmrtObject {
+    /** Short, human-typeable code the user enters in the browser to approve the session. */
+    userCode: string;
+    /** SHA-256 hash of the long device code the CLI keeps secret. */
+    deviceCodeHash: string;
+    /** Lifecycle state — `pending` → `approved` | `expired`. */
+    status: CliAuthRequestStatus;
+    /** User id of the human who approved the request (set on approval). */
+    userId: string;
+    /** Tenant id captured from the approving session (set on approval). */
+    tenantId: string;
+    /** Session id minted on approval — handed to the CLI as its bearer token. */
+    sessionId: string;
+    /** When the pending request stops accepting approvals. */
+    expiresAt: Date;
+    /** When approval happened — null while the request is still pending. */
+    approvedAt: Date | null;
+}
+export { UsersCliAuthRequest as CliAuthRequest };
+//# sourceMappingURL=CliAuthRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CliAuthRequest.d.ts","sourceRoot":"","sources":["../../src/models/CliAuthRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAS,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtE,qBAMa,mBAAoB,SAAQ,UAAU;IACjD,wFAAwF;IAExF,QAAQ,SAAM;IAEd,iEAAiE;IAEjE,cAAc,SAAM;IAEpB,4DAA4D;IAE5D,MAAM,EAAE,oBAAoB,CAAa;IAEzC,uEAAuE;IAEvE,MAAM,SAAM;IAEZ,uEAAuE;IAEvE,QAAQ,SAAM;IAEd,6EAA6E;IAE7E,SAAS,SAAM;IAEf,0DAA0D;IAE1D,SAAS,OAAc;IAEvB,wEAAwE;IAExE,UAAU,EAAE,IAAI,GAAG,IAAI,CAAQ;CAChC;AAED,OAAO,EAAE,mBAAmB,IAAI,cAAc,EAAE,CAAC"}

package/dist/models/Group.d.ts

@@ -0,0 +1,34 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * Group represents a team or department within a tenant.
+ *
+ * Groups can have roles assigned to them via GroupRole.
+ * Users in a group inherit permissions from the group's roles.
+ *
+ * @example
+ * ```typescript
+ * const editorsGroup = await groups.create({
+ *   tenantId: tenant.id,
+ *   name: 'Editorial Team',
+ *   slug: 'editorial-team',
+ *   description: 'Content editors and writers'
+ * });
+ * await editorsGroup.save();
+ * ```
+ */
+export declare class Group extends SmrtObject {
+    /**
+     * Foreign key to Tenant
+     */
+    tenantId?: string;
+    /**
+     * Display name for the group
+     */
+    name: string;
+    /**
+     * Description of the group
+     */
+    description: string;
+    constructor(options?: any);
+}
+//# sourceMappingURL=Group.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../src/models/Group.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAOa,KAAM,SAAQ,UAAU;IACnC;;OAEG;IAEH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAM;gBAEb,OAAO,GAAE,GAAQ;CAO9B"}

package/dist/models/GroupMember.d.ts

@@ -0,0 +1,29 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * GroupMember is a join table linking Users to Groups.
+ *
+ * A user can belong to multiple groups within a tenant.
+ * Group membership grants additional permissions via GroupRole.
+ *
+ * @example
+ * ```typescript
+ * // Add user to a group
+ * const groupMember = await groupMembers.create({
+ *   groupId: editorsGroup.id,
+ *   userId: user.id
+ * });
+ * await groupMember.save();
+ * ```
+ */
+export declare class GroupMember extends SmrtObject {
+    /**
+     * Foreign key to Group
+     */
+    groupId?: string;
+    /**
+     * Foreign key to User
+     */
+    userId?: string;
+    constructor(options?: any);
+}
+//# sourceMappingURL=GroupMember.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GroupMember.d.ts","sourceRoot":"","sources":["../../src/models/GroupMember.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,qBAQa,WAAY,SAAQ,UAAU;IACzC;;OAEG;IAEH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IAEH,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEJ,OAAO,GAAE,GAAQ;CAK9B"}

package/dist/models/GroupRole.d.ts

@@ -0,0 +1,29 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * GroupRole is a join table linking Groups to Roles.
+ *
+ * Groups can have multiple roles assigned, and members of the group
+ * inherit the permissions from all assigned roles.
+ *
+ * @example
+ * ```typescript
+ * // Assign a role to a group
+ * const groupRole = await groupRoles.create({
+ *   groupId: editorsGroup.id,
+ *   roleId: editorRole.id
+ * });
+ * await groupRole.save();
+ * ```
+ */
+export declare class GroupRole extends SmrtObject {
+    /**
+     * Foreign key to Group
+     */
+    groupId?: string;
+    /**
+     * Foreign key to Role
+     */
+    roleId?: string;
+    constructor(options?: any);
+}
+//# sourceMappingURL=GroupRole.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GroupRole.d.ts","sourceRoot":"","sources":["../../src/models/GroupRole.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,qBAQa,SAAU,SAAQ,UAAU;IACvC;;OAEG;IAEH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IAEH,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEJ,OAAO,GAAE,GAAQ;CAK9B"}

package/dist/models/MagicLinkToken.d.ts

@@ -0,0 +1,22 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * Default magic link token expiry: 10 minutes in seconds
+ */
+export declare const DEFAULT_TOKEN_EXPIRY_SECONDS: number;
+export declare class UsersMagicLinkToken extends SmrtObject {
+    /** Unique nonce embedded in the signed JWT */
+    nonce: string;
+    /** Email address this token was generated for */
+    email: string;
+    /** Whether this token has been used */
+    used: boolean;
+    /** When this token expires */
+    expiresAt: Date;
+    constructor(options?: any);
+    /** Check if the token has expired */
+    isExpired(): boolean;
+    /** Check if the token is still valid (unused and not expired) */
+    isValid(): boolean;
+}
+export { UsersMagicLinkToken as MagicLinkToken };
+//# sourceMappingURL=MagicLinkToken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MagicLinkToken.d.ts","sourceRoot":"","sources":["../../src/models/MagicLinkToken.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAS,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,4BAA4B,QAAU,CAAC;AAEpD,qBAOa,mBAAoB,SAAQ,UAAU;IACjD,8CAA8C;IAE9C,KAAK,EAAE,MAAM,CAAM;IAEnB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAM;IAEnB,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAS;IAEtB,8BAA8B;IAC9B,SAAS,EAAE,IAAI,CAA8D;gBAEjE,OAAO,GAAE,GAAQ;IAa7B,qCAAqC;IACrC,SAAS,IAAI,OAAO;IAIpB,iEAAiE;IACjE,OAAO,IAAI,OAAO;CAGnB;AAED,OAAO,EAAE,mBAAmB,IAAI,cAAc,EAAE,CAAC"}

package/dist/models/Membership.d.ts

@@ -0,0 +1,48 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { Membership as MembershipContract } from '@happyvertical/smrt-types';
+import { MembershipStatus } from '../types/index.js';
+/**
+ * Membership represents a user's membership in a tenant with an assigned role.
+ *
+ * A user can have only one membership per tenant (UNIQUE userId + tenantId).
+ * The role determines the base permissions for the user in that tenant.
+ *
+ * @example
+ * ```typescript
+ * const membership = await memberships.create({
+ *   userId: user.id,
+ *   tenantId: tenant.id,
+ *   roleId: role.id,
+ *   status: MembershipStatus.ACTIVE
+ * });
+ * await membership.save();
+ * ```
+ */
+export declare class Membership extends SmrtObject implements MembershipContract {
+    /**
+     * Foreign key to User
+     */
+    userId?: string;
+    /**
+     * Foreign key to Tenant
+     */
+    tenantId?: string;
+    /**
+     * Foreign key to Role - determines base permissions
+     */
+    roleId?: string;
+    /**
+     * Membership status
+     */
+    status: MembershipStatus;
+    constructor(options?: any);
+    /**
+     * Check if membership is active
+     */
+    isActive(): boolean;
+    /**
+     * Check if membership is pending (invitation not yet accepted)
+     */
+    isPending(): boolean;
+}
+//# sourceMappingURL=Membership.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Membership.d.ts","sourceRoot":"","sources":["../../src/models/Membership.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAQa,UAAW,SAAQ,UAAW,YAAW,kBAAkB;IACtE;;OAEG;IAEH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IAEH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IAEH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IAEH,MAAM,EAAE,gBAAgB,CAA2B;gBAEvC,OAAO,GAAE,GAAQ;IAQ7B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}

package/dist/models/MembershipOverride.d.ts

@@ -0,0 +1,50 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { OverrideEffect } from '../types/index.js';
+/**
+ * MembershipOverride allows granting or denying specific permissions
+ * to a user beyond what their role and groups provide.
+ *
+ * Overrides are applied after role and group permissions are resolved.
+ * DENY overrides take precedence over GRANT overrides.
+ *
+ * @example
+ * ```typescript
+ * // Grant a specific permission to a user
+ * const override = await membershipOverrides.create({
+ *   membershipId: membership.id,
+ *   permissionId: specialPermission.id,
+ *   effect: OverrideEffect.GRANT
+ * });
+ *
+ * // Deny a permission (even if role grants it)
+ * const deny = await membershipOverrides.create({
+ *   membershipId: membership.id,
+ *   permissionId: dangerousPermission.id,
+ *   effect: OverrideEffect.DENY
+ * });
+ * ```
+ */
+export declare class MembershipOverride extends SmrtObject {
+    /**
+     * Foreign key to Membership
+     */
+    membershipId?: string;
+    /**
+     * Foreign key to Permission
+     */
+    permissionId?: string;
+    /**
+     * Effect of the override: grant or deny
+     */
+    effect: OverrideEffect;
+    constructor(options?: any);
+    /**
+     * Check if this override grants the permission
+     */
+    isGrant(): boolean;
+    /**
+     * Check if this override denies the permission
+     */
+    isDeny(): boolean;
+}
+//# sourceMappingURL=MembershipOverride.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MembershipOverride.d.ts","sourceRoot":"","sources":["../../src/models/MembershipOverride.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAQa,kBAAmB,SAAQ,UAAU;IAChD;;OAEG;IAEH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IAEH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IAEH,MAAM,EAAE,cAAc,CAAwB;gBAElC,OAAO,GAAE,GAAQ;IAS7B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,MAAM,IAAI,OAAO;CAGlB"}

package/dist/models/Permission.d.ts

@@ -0,0 +1,79 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * Parsed permission slug components
+ */
+export interface ParsedPermissionSlug {
+    /** Resource part (e.g., 'articles' from 'articles.create') */
+    resource: string;
+    /** Action part (e.g., 'create' from 'articles.create') */
+    action: string;
+    /** Whether the slug follows the valid 'resource.action' pattern */
+    isValid: boolean;
+}
+/**
+ * Parse a permission slug into its resource and action components.
+ * Valid format: 'resource.action' (e.g., 'articles.create')
+ *
+ * @param slug - The permission slug to parse
+ * @returns Parsed components with validation status
+ */
+export declare function parsePermissionSlug(slug: string): ParsedPermissionSlug;
+/**
+ * Validate that a permission slug follows the 'resource.action' pattern.
+ *
+ * @param slug - The slug to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidPermissionSlug(slug: string): boolean;
+/**
+ * Permission represents a named capability in the system.
+ *
+ * Permissions are defined by the application and assigned to roles.
+ * Permission slugs follow the pattern: resource.action (e.g., 'articles.create')
+ *
+ * @example
+ * ```typescript
+ * const permission = await permissions.create({
+ *   slug: 'articles.create',
+ *   name: 'Create Articles',
+ *   description: 'Allows creating new articles',
+ *   category: 'articles'
+ * });
+ * await permission.save();
+ * ```
+ */
+export declare class Permission extends SmrtObject {
+    /**
+     * Display name for the permission
+     */
+    name: string;
+    /**
+     * Description of what this permission allows
+     */
+    description: string;
+    /**
+     * Category for grouping in UI (e.g., 'articles', 'users', 'settings')
+     */
+    category: string;
+    constructor(options?: any);
+    /**
+     * Parse the permission slug into resource and action components.
+     * @returns Parsed slug with resource, action, and validation status
+     */
+    parseSlug(): ParsedPermissionSlug;
+    /**
+     * Get the resource part of the permission slug
+     * e.g., 'articles.create' -> 'articles'
+     */
+    getResource(): string;
+    /**
+     * Get the action part of the permission slug
+     * e.g., 'articles.create' -> 'create'
+     */
+    getAction(): string;
+    /**
+     * Check if the permission slug is valid (follows 'resource.action' pattern)
+     */
+    isValidSlug(): boolean;
+}
+//# sourceMappingURL=Permission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Permission.d.ts","sourceRoot":"","sources":["../../src/models/Permission.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CActE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAOa,UAAW,SAAQ,UAAU;IACxC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAM;IAEzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAM;gBAEV,OAAO,GAAE,GAAQ;IAQ7B;;;OAGG;IACH,SAAS,IAAI,oBAAoB;IAIjC;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}

package/dist/models/Role.d.ts

@@ -0,0 +1,67 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { Role as RoleContract } from '@happyvertical/smrt-types';
+/**
+ * Role represents a permission template that can be assigned to users.
+ *
+ * Roles can be:
+ * - System roles (tenantId = null): Available to all tenants, cannot be modified
+ * - Custom roles (tenantId set): Specific to a tenant, can be customized
+ *
+ * @example
+ * ```typescript
+ * // System role (tenantId = null)
+ * const adminRole = await roles.create({
+ *   slug: 'admin',
+ *   name: 'Administrator',
+ *   isSystem: true
+ * });
+ *
+ * // Custom tenant role
+ * const editorRole = await roles.create({
+ *   tenantId: tenant.id,
+ *   slug: 'editor',
+ *   name: 'Editor',
+ *   description: 'Can edit content'
+ * });
+ * ```
+ */
+export declare class Role extends SmrtObject implements RoleContract {
+    /**
+     * Foreign key to Tenant
+     * null = system role available to all tenants
+     */
+    tenantId?: string | null;
+    /**
+     * Display name for the role
+     */
+    name: string;
+    /**
+     * Description of the role
+     */
+    description: string;
+    /**
+     * Whether this is a system role (cannot be deleted)
+     */
+    isSystem: boolean;
+    constructor(options?: any);
+    /**
+     * Check if this is a system-wide role
+     */
+    isSystemRole(): boolean;
+    /**
+     * Check if this is a tenant-specific role
+     */
+    isTenantRole(): boolean;
+    /**
+     * Check if this role can be deleted.
+     * System roles (isSystem = true) cannot be deleted.
+     * @returns true if the role can be deleted
+     */
+    canDelete(): boolean;
+    /**
+     * Delete guard - prevents deletion of system roles.
+     * Override the delete method to check isSystem flag first.
+     */
+    delete(): Promise<void>;
+}
+//# sourceMappingURL=Role.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Role.d.ts","sourceRoot":"","sources":["../../src/models/Role.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAOa,IAAK,SAAQ,UAAW,YAAW,YAAY;IAC1D;;;OAGG;IAEH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAM;IAEzB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAS;gBAEd,OAAO,GAAE,GAAQ;IAS7B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ9B"}

package/dist/models/RolePermission.d.ts

@@ -0,0 +1,29 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * RolePermission is a join table linking Roles to Permissions.
+ *
+ * This enables many-to-many relationship between roles and permissions.
+ * A role can have multiple permissions, and a permission can belong to multiple roles.
+ *
+ * @example
+ * ```typescript
+ * // Assign a permission to a role
+ * const rolePermission = await rolePermissions.create({
+ *   roleId: adminRole.id,
+ *   permissionId: createArticlePermission.id
+ * });
+ * await rolePermission.save();
+ * ```
+ */
+export declare class RolePermission extends SmrtObject {
+    /**
+     * Foreign key to Role
+     */
+    roleId?: string;
+    /**
+     * Foreign key to Permission
+     */
+    permissionId?: string;
+    constructor(options?: any);
+}
+//# sourceMappingURL=RolePermission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RolePermission.d.ts","sourceRoot":"","sources":["../../src/models/RolePermission.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,qBAQa,cAAe,SAAQ,UAAU;IAC5C;;OAEG;IAEH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IAEH,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEV,OAAO,GAAE,GAAQ;CAM9B"}

package/dist/models/Session.d.ts

@@ -0,0 +1,105 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { SessionStatus } from '../types/index.js';
+/**
+ * Default session TTL: 7 days in seconds
+ */
+export declare const DEFAULT_SESSION_TTL: number;
+/**
+ * Generate a cryptographically secure session ID
+ */
+export declare function generateSessionId(): string;
+/**
+ * Session represents an authenticated user session.
+ *
+ * Sessions are stored server-side and linked to users.
+ * A session ID is stored in a cookie and used to look up the session.
+ *
+ * @example
+ * ```typescript
+ * const session = await sessions.create({
+ *   userId: user.id,
+ *   tenantId: tenant.id,
+ *   expiresAt: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
+ *   userAgent: request.headers.get('user-agent'),
+ *   ipAddress: getClientAddress(event)
+ * });
+ * await session.save();
+ * ```
+ */
+export declare class Session extends SmrtObject {
+    /**
+     * User who owns this session
+     */
+    userId: string;
+    /**
+     * Tenant context for this session (for multi-tenant apps)
+     * Null means no tenant context selected
+     */
+    tenantId: string | null;
+    /**
+     * Session status
+     */
+    status: SessionStatus;
+    /**
+     * Session expiration time
+     */
+    expiresAt: Date;
+    /**
+     * User agent string from the browser
+     */
+    userAgent: string;
+    /**
+     * IP address of the client
+     */
+    ipAddress: string;
+    /**
+     * Last activity timestamp (updated on each request)
+     */
+    lastAccessedAt: Date;
+    /**
+     * Custom session data (JSON serializable)
+     */
+    data: Record<string, unknown>;
+    constructor(options?: any);
+    /**
+     * Check if the session is currently valid (active and not expired)
+     */
+    isValid(): boolean;
+    /**
+     * Check if the session has expired
+     */
+    isExpired(): boolean;
+    /**
+     * Check if the session was revoked
+     */
+    isRevoked(): boolean;
+    /**
+     * Update the last accessed timestamp
+     */
+    touch(): void;
+    /**
+     * Extend the session expiration by the given TTL (in seconds)
+     */
+    extend(ttlSeconds?: number): void;
+    /**
+     * Revoke the session
+     */
+    revoke(): void;
+    /**
+     * Set the tenant context for this session
+     */
+    setTenant(tenantId: string | null): void;
+    /**
+     * Get or set custom session data
+     */
+    getData<T>(key: string): T | undefined;
+    /**
+     * Set custom session data
+     */
+    setData(key: string, value: unknown): void;
+    /**
+     * Remove custom session data
+     */
+    removeData(key: string): void;
+}
+//# sourceMappingURL=Session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/models/Session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAmB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAMa,OAAQ,SAAQ,UAAU;IACrC;;OAEG;IAEH,MAAM,EAAE,MAAM,CAAM;IAEpB;;;OAGG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IAEH,MAAM,EAAE,aAAa,CAAwB;IAE7C;;OAEG;IACH,SAAS,EAAE,IAAI,CAAc;IAE7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,cAAc,EAAE,IAAI,CAAc;IAElC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;gBAEvB,OAAO,GAAE,GAAQ;IAsB7B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,CAAC,UAAU,GAAE,MAA4B,GAAG,IAAI;IAKtD;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIxC;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAItC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1C;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG9B"}