@happyvertical/smrt-types 0.51.31 → 0.51.33

package/dist/identity.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Cross-package identity & tenancy data contracts.
+ *
+ * These interfaces are the structural shape that the identity model classes
+ * expose to *other* packages:
+ *
+ * - `User`, `Tenant`, `Role`, `Membership` — runtime classes in
+ *   `@happyvertical/smrt-users`
+ *
+ * They live here — in the zero-runtime types leaf — so a package that needs only
+ * the *type* of an identity record never has to take a package dependency on the
+ * implementation package. Importing these upward (e.g. `smrt-tenancy` reaching
+ * into `smrt-users`) is what fabricated the peer-dependency cycle the leaf
+ * removes. The runtime classes `implements` these interfaces, so the contract
+ * stays honest (the class is checked to be a superset of the interface at
+ * compile time).
+ *
+ * Scope: these cover the persisted, cross-package-visible fields only — not the
+ * full class surface (methods, relationship accessors). Widen an interface when
+ * a genuine cross-package consumer needs more; the `implements` clause guarantees
+ * the class already provides it.
+ *
+ * @packageDocumentation
+ */
+import type { MembershipStatus, TenantStatus, UserStatus } from './user.js';
+/**
+ * Fields every persisted SMRT entity exposes — a subset of `SmrtObject`'s public
+ * surface. `id`/`slug` are `null`/`undefined` before the first persist, matching
+ * the base getters.
+ */
+export interface SmrtEntityFields {
+    /** UUID, assigned on first persist. */
+    id: string | null | undefined;
+    /** URL-safe slug, when the model maintains one. */
+    slug: string | null | undefined;
+    /** Creation timestamp; `null`/`undefined` before first persist. */
+    created_at: Date | null | undefined;
+    /** Last-update timestamp; `null`/`undefined` before first persist. */
+    updated_at: Date | null | undefined;
+}
+/** Auth identity record. Runtime class: `@happyvertical/smrt-users:User`. */
+export interface User extends SmrtEntityFields {
+    /** Plain-string reference to the owning `Profile` (not a DB foreign key). */
+    profileId: string;
+    /** Lower-cased email; globally unique. */
+    email: string;
+    status: UserStatus;
+    lastLoginAt: Date | null;
+}
+/** Hierarchical tenant. Runtime class: `@happyvertical/smrt-users:Tenant`. */
+export interface Tenant extends SmrtEntityFields {
+    name: string;
+    status: TenantStatus;
+    description: string;
+    parentTenantId?: string | null;
+    hierarchyLevel: number;
+    hierarchyPath: string;
+    cascadePermissions: boolean;
+    inheritPermissions: boolean;
+}
+/** RBAC role. Runtime class: `@happyvertical/smrt-users:Role`. */
+export interface Role extends SmrtEntityFields {
+    /** `null` → system role available to every tenant. */
+    tenantId?: string | null;
+    name: string;
+    description: string;
+    isSystem: boolean;
+    /**
+     * Opt-in hierarchical inheritance: when `true`, an ACTIVE membership holding
+     * this role also resolves permissions in descendant tenants where the user
+     * has no direct membership. Default `false` (authority is exact-tenant only).
+     */
+    inheritsToDescendants: boolean;
+}
+/** User↔Tenant↔Role junction. Runtime class: `@happyvertical/smrt-users:Membership`. */
+export interface Membership extends SmrtEntityFields {
+    userId?: string;
+    tenantId?: string;
+    roleId?: string;
+    status: MembershipStatus;
+}
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9B,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChC,mEAAmE;IACnE,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,sEAAsE;IACtE,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC;AAED,6EAA6E;AAC7E,MAAM,WAAW,IAAK,SAAQ,gBAAgB;IAC5C,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,MAAO,SAAQ,gBAAgB;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,kEAAkE;AAClE,MAAM,WAAW,IAAK,SAAQ,gBAAgB;IAC5C,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,wFAAwF;AACxF,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}