@happyvertical/smrt-users 0.37.1 → 0.37.3

package/dist/manifest.json

@@ -1,9 +1,125 @@
 {
   "version": "1.0.0",
-  "timestamp": 1782792550042,
+  "timestamp": 1782936269710,
   "packageName": "@happyvertical/smrt-users",
-  "packageVersion": "0.37.1",
+  "packageVersion": "0.37.3",
   "objects": {
+    "@happyvertical/smrt-users:AccessRequestCollection": {
+      "name": "accessrequestcollection",
+      "className": "AccessRequestCollection",
+      "qualifiedName": "@happyvertical/smrt-users:AccessRequestCollection",
+      "collection": "accessrequests",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/users/src/collections/AccessRequestCollection.ts",
+      "packageName": "@happyvertical/smrt-users",
+      "fields": {},
+      "methods": {
+        "findByEmail": {
+          "name": "findByEmail",
+          "async": true,
+          "parameters": [
+            {
+              "name": "email",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<AccessRequest[]>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "findOpenByEmail": {
+          "name": "findOpenByEmail",
+          "async": true,
+          "parameters": [
+            {
+              "name": "email",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<AccessRequest | null>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "findByStatus": {
+          "name": "findByStatus",
+          "async": true,
+          "parameters": [
+            {
+              "name": "status",
+              "type": "AccessRequestStatus",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<AccessRequest[]>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "findOpen": {
+          "name": "findOpen",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<AccessRequest[]>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "access_requests"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "AccessRequest",
+      "exportName": "AccessRequestCollection",
+      "collectionExportName": "AccessRequestCollectionCollection",
+      "schema": {
+        "tableName": "access_requests",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"access_requests\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          }
+        },
+        "indexes": [
+          {
+            "name": "access_requests_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "access_requests_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "c7691cc2"
+      }
+    },
     "@happyvertical/smrt-users:UsersCliAuthRequestCollection": {
       "name": "userscliauthrequestcollection",
       "className": "UsersCliAuthRequestCollection",
@@ -2547,6 +2663,309 @@
         "version": "539fdcc8"
       }
     },
+    "@happyvertical/smrt-users:AccessRequest": {
+      "name": "accessrequest",
+      "className": "AccessRequest",
+      "qualifiedName": "@happyvertical/smrt-users:AccessRequest",
+      "collection": "accessrequests",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/users/src/models/AccessRequest.ts",
+      "packageName": "@happyvertical/smrt-users",
+      "fields": {
+        "email": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true,
+            "indexed": true
+          }
+        },
+        "name": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "status": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "indexed": true
+          }
+        },
+        "source": {
+          "type": "text",
+          "required": false,
+          "default": "",
+          "_meta": {
+            "indexed": true
+          }
+        },
+        "requestContext": {
+          "type": "text",
+          "required": false,
+          "default": "{}"
+        },
+        "note": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "requestedAt": {
+          "type": "datetime",
+          "required": false
+        },
+        "decidedAt": {
+          "type": "datetime",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "decidedBy": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "resultingUserId": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "tenantHint": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        }
+      },
+      "methods": {
+        "getRequestContext": {
+          "name": "getRequestContext",
+          "async": false,
+          "parameters": [],
+          "returnType": "Record<string>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setRequestContext": {
+          "name": "setRequestContext",
+          "async": false,
+          "parameters": [
+            {
+              "name": "value",
+              "type": "Record<string>",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getTenantHint": {
+          "name": "getTenantHint",
+          "async": false,
+          "parameters": [],
+          "returnType": "Record<string> | null",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setTenantHint": {
+          "name": "setTenantHint",
+          "async": false,
+          "parameters": [
+            {
+              "name": "value",
+              "type": "Record<string> | null",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "isOpen": {
+          "name": "isOpen",
+          "async": false,
+          "parameters": [],
+          "returnType": "boolean",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "isApproved": {
+          "name": "isApproved",
+          "async": false,
+          "parameters": [],
+          "returnType": "boolean",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "isTerminal": {
+          "name": "isTerminal",
+          "async": false,
+          "parameters": [],
+          "returnType": "boolean",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "access_requests",
+        "conflictColumns": [
+          "id"
+        ],
+        "api": {
+          "include": []
+        },
+        "mcp": {
+          "include": []
+        },
+        "cli": {
+          "include": []
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "AccessRequest",
+      "collectionExportName": "AccessRequestCollection",
+      "validationRules": [
+        {
+          "field": "email",
+          "rule": "required",
+          "fieldType": "text"
+        }
+      ],
+      "schema": {
+        "tableName": "access_requests",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"access_requests\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"email\" TEXT NOT NULL DEFAULT '',\n  \"name\" TEXT,\n  \"status\" TEXT,\n  \"source\" TEXT DEFAULT '',\n  \"request_context\" TEXT DEFAULT '{}',\n  \"note\" TEXT,\n  \"requested_at\" TIMESTAMP,\n  \"decided_at\" TIMESTAMP,\n  \"decided_by\" TEXT,\n  \"resulting_user_id\" TEXT,\n  \"tenant_hint\" TEXT\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "email": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "name": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "status": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "source": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": ""
+          },
+          "request_context": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": "{}"
+          },
+          "note": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "requested_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "decided_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "decided_by": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "resulting_user_id": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "tenant_hint": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "access_requests_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "access_requests_id_idx",
+            "columns": [
+              "id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "access_requests_email_idx",
+            "columns": [
+              "email"
+            ]
+          },
+          {
+            "name": "access_requests_status_idx",
+            "columns": [
+              "status"
+            ]
+          },
+          {
+            "name": "access_requests_source_idx",
+            "columns": [
+              "source"
+            ]
+          }
+        ],
+        "version": "f396996f"
+      }
+    },
     "@happyvertical/smrt-users:UsersCliAuthRequest": {
       "name": "userscliauthrequest",
       "className": "UsersCliAuthRequest",

package/dist/models/AccessRequest.d.ts

@@ -0,0 +1,131 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { AccessRequestStatus } from '../types/index.js';
+/**
+ * Options accepted by the {@link AccessRequest} constructor / collection
+ * `create`. `requestContext` and `tenantHint` are stored as JSON *strings* —
+ * use {@link AccessRequest.setRequestContext} / {@link AccessRequest.setTenantHint}
+ * (or pass pre-serialized strings) rather than raw objects.
+ */
+export interface AccessRequestOptions {
+    email?: string;
+    name?: string | null;
+    status?: AccessRequestStatus;
+    source?: string;
+    requestContext?: string;
+    note?: string | null;
+    requestedAt?: Date;
+    decidedAt?: Date | null;
+    decidedBy?: string | null;
+    resultingUserId?: string | null;
+    tenantHint?: string | null;
+    [key: string]: unknown;
+}
+/**
+ * A prospective user's request for access, captured before they become a
+ * {@link User}.
+ *
+ * @example
+ * ```typescript
+ * // Public, unauthenticated path (app adds rate-limiting):
+ * const request = await service.createAccessRequest({
+ *   email: 'Jane@Example.com',
+ *   name: 'Jane Doe',
+ *   source: 'www',
+ *   context: { company: 'Acme', intendedUse: 'evaluation' },
+ * });
+ * // request.email === 'jane@example.com', request.status === 'requested'
+ * ```
+ */
+export declare class AccessRequest extends SmrtObject {
+    /**
+     * Requester's email address. Required, normalized to lowercase, and indexed
+     * for lookup + open-request dedup. NOT unique: the same email may accumulate
+     * multiple requests over time (e.g. an old GRADUATED record plus a new
+     * REQUESTED one); dedup is enforced on *open* requests by the service.
+     */
+    email: string;
+    /**
+     * Requester's display name, if supplied on the form.
+     */
+    name: string | null;
+    /**
+     * Lifecycle status. Indexed so the operator triage queue can filter by status
+     * efficiently.
+     */
+    status: AccessRequestStatus;
+    /**
+     * Where the request came from, e.g. `www`, `sdk`. Indexed for per-source
+     * filtering in the operator queue.
+     */
+    source: string;
+    /**
+     * Free-form JSON metadata captured with the request (intended use, company,
+     * message, referrer, etc.), stored as a JSON string.
+     *
+     * NOT named `context`: {@link SmrtObject} reserves the `context` field for
+     * slug scoping, so this mirrors smrt-chat's `sessionContext` convention. Use
+     * {@link getRequestContext} / {@link setRequestContext} for typed access.
+     */
+    requestContext: string;
+    /**
+     * Operator note / decision reason (set on approve / decline / cancel).
+     */
+    note: string | null;
+    /**
+     * When the request was submitted. Defaults to creation time.
+     */
+    requestedAt: Date;
+    /**
+     * When an operator decided the request (approve / decline / cancel /
+     * graduate). Null while still `REQUESTED`.
+     */
+    decidedAt: Date | null;
+    /**
+     * User id of the operator who decided the request. Null while still pending.
+     */
+    decidedBy: string | null;
+    /**
+     * Id of the `User` produced (or linked) when the request graduated. Null
+     * until graduation.
+     */
+    resultingUserId: string | null;
+    /**
+     * Optional JSON hint about the org/tenant the requester wants, stored as a
+     * JSON string (null when absent). Advisory only — the operator decides the
+     * actual tenant at graduation time. Use {@link getTenantHint} /
+     * {@link setTenantHint} for typed access.
+     */
+    tenantHint: string | null;
+    constructor(options?: AccessRequestOptions);
+    /**
+     * Parse {@link requestContext} into an object. Returns `{}` on missing or
+     * malformed JSON (graceful — never throws).
+     */
+    getRequestContext(): Record<string, unknown>;
+    /**
+     * Serialize and store {@link requestContext} from an object.
+     */
+    setRequestContext(value: Record<string, unknown>): void;
+    /**
+     * Parse {@link tenantHint} into an object, or `null` when unset / malformed.
+     */
+    getTenantHint(): Record<string, unknown> | null;
+    /**
+     * Serialize and store {@link tenantHint} from an object (or clear with null).
+     */
+    setTenantHint(value: Record<string, unknown> | null): void;
+    /**
+     * Whether the request is still open (awaiting a decision).
+     */
+    isOpen(): boolean;
+    /**
+     * Whether the request has been approved (and not yet graduated).
+     */
+    isApproved(): boolean;
+    /**
+     * Whether the request reached a terminal state (declined, graduated, or
+     * canceled) and can no longer transition.
+     */
+    isTerminal(): boolean;
+}
+//# sourceMappingURL=AccessRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AccessRequest.d.ts","sourceRoot":"","sources":["../../src/models/AccessRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAS,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAca,aAAc,SAAQ,UAAU;IAC3C;;;;;OAKG;IAEH,KAAK,EAAE,MAAM,CAAM;IAEnB;;OAEG;IAEH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE3B;;;OAGG;IAEH,MAAM,EAAE,mBAAmB,CAAiC;IAE5D;;;OAGG;IAEH,MAAM,EAAE,MAAM,CAAM;IAEpB;;;;;;;OAOG;IAEH,cAAc,EAAE,MAAM,CAAQ;IAE9B;;OAEG;IAEH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE3B;;OAEG;IAEH,WAAW,EAAE,IAAI,CAAc;IAE/B;;;OAGG;IAEH,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE9B;;OAEG;IAEH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEhC;;;OAGG;IAEH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtC;;;;;OAKG;IAEH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAErB,OAAO,GAAE,oBAAyB;IAkB9C;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAW5C;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAY/C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;;OAGG;IACH,UAAU,IAAI,OAAO;CAOtB"}

package/dist/models/index.d.ts

@@ -2,6 +2,7 @@
  * Model exports for smrt-users
  * @packageDocumentation
  */
+export { AccessRequest, type AccessRequestOptions } from './AccessRequest.js';
 export { CliAuthRequest, type CliAuthRequestStatus, UsersCliAuthRequest, } from './CliAuthRequest.js';
 export { Group } from './Group.js';
 export { GroupMember } from './GroupMember.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,UAAU,EACV,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,UAAU,EACV,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}