@shipfox/api-auth 9.1.0 → 9.3.0

package/.turbo/turbo-build.log

@@ -1,2 +1,2 @@
 $ shipfox-swc
-Successfully compiled: 52 files with swc (491.07ms)
+Successfully compiled: 62 files with swc (608.87ms)

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @shipfox/api-auth
 
+## 9.3.0
+
+### Minor Changes
+
+- 10cf63c: Add first-owner bootstrap and administrator grant management routes.
+
+### Patch Changes
+
+- c0046d3: Default low-level account creation to the environment-backed signup policy when no explicit policy is supplied.
+- Updated dependencies [10cf63c]
+- Updated dependencies [4425c6d]
+- Updated dependencies [7b6a409]
+  - @shipfox/api-auth-dto@9.3.0
+  - @shipfox/node-opentelemetry@0.6.3
+  - @shipfox/api-workspaces-dto@9.3.0
+  - @shipfox/api-auth-context@9.3.0
+  - @shipfox/api-email-challenges@1.1.5
+  - @shipfox/node-fastify@0.3.4
+  - @shipfox/node-mailer@0.2.4
+  - @shipfox/node-module@1.0.3
+
+## 9.2.0
+
+### Minor Changes
+
+- bd7c46b: Thread an optional signup policy through API Auth module composition in preparation for signup enforcement.
+- 456c884: Add Auth-owned local administrator grants and server-side role evaluation.
+- 36adf25: Guards password and external-identity account creation with the signup policy.
+- f31bee6: Adds the environment-variable signup policy and its Auth-prefixed configuration.
+- 63c0e5b: Adds the signup policy port and denial error to API Auth.
+
+### Patch Changes
+
+- b321700: Default the Auth module to its environment-backed signup policy when no custom policy is provided.
+- ad36e26: Return a bounded signup-not-allowed message from the password signup route.
+- Updated dependencies [456c884]
+  - @shipfox/api-auth-dto@9.2.0
+  - @shipfox/api-email-challenges@1.1.4
+  - @shipfox/api-workspaces-dto@9.2.0
+  - @shipfox/api-auth-context@9.2.0
+
 ## 9.1.0
 
 ### Patch Changes

package/README.md

@@ -63,10 +63,22 @@ Required environment:
 | `AUTH_REFRESH_ROTATION_GRACE_SECONDS` | `30` | Grace window for accepting a just-rotated refresh token during concurrent refreshes. |
 | `AUTH_REFRESH_COOKIE_NAME` | `shipfox_refresh_token` | HTTP cookie name for refresh sessions. |
 | `AUTH_PASSWORD_ENABLED` | `true` | Enables password and email-verification routes. Set to `false` when another module provides login. Server construction fails if no login method is available. |
+| `AUTH_SIGNUP_GATE_ENABLED` | `false` | Restricts new account creation to the configured signup email allowlist. Requires `AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS` or `AUTH_SIGNUP_ALLOWED_EMAILS` to be set. |
+| `AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS` | none | Comma-separated email domains allowed to create accounts, such as `shipfox.io,acme.com`. |
+| `AUTH_SIGNUP_ALLOWED_EMAILS` | none | Comma-separated exact email addresses allowed to create accounts. |
+| `AUTH_SIGNUP_NOT_ALLOWED_MESSAGE` | none | Description returned when the signup gate blocks an account. Defaults to "This Shipfox deployment does not accept new accounts right now." |
 | `CLIENT_BASE_URL` | `http://localhost:5173` | Base URL used in email verification and password reset links. |
+| `ADMIN_BOOTSTRAP_TOKEN` | none | Deployment secret accepted once to create the first administrator owner. Set it before bootstrap and remove or rotate it after successful bootstrap. |
 
 Email delivery uses the shared `@shipfox/node-mailer` configuration.
 
+The signup gate is off by default. When it is on, provide at least one non-empty
+entry in `AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS` or `AUTH_SIGNUP_ALLOWED_EMAILS`.
+Startup fails when both lists are empty. Values are trimmed and lowercased.
+The policy matches exact email addresses or exact domains. It does not match
+subdomains or wildcards. `createAuthModule` applies these settings by default;
+pass a `signupPolicy` to replace the environment-backed policy.
+
 When `AUTH_PASSWORD_ENABLED=false`, the module does not register signup, login, password-reset, password-change, or email-verification routes. Refresh, logout, and current-session routes stay available. Another module must contribute a login method before the API server starts.
 
 ## Security model
@@ -202,7 +214,7 @@ All routes are mounted under `/auth`.
 
 | Method | Path | Auth | Result |
 | --- | --- | --- | --- |
-| `POST` | `/signup` | none | Creates a user and sends an eight-digit email verification code. |
+| `POST` | `/signup` | none | Creates a user and sends an eight-digit email verification code. A denied new signup returns `403` with error code `signup-not-allowed` and the policy message. |
 | `POST` | `/verify-email/confirm` | none | Confirms a verification code, returns an access token, and sets the refresh cookie. |
 | `POST` | `/verify-email/resend` | none | Sends a new verification code when the account is eligible. |
 | `POST` | `/login` | none | Returns an access token and sets the refresh cookie. |
@@ -220,6 +232,19 @@ When password login is disabled, the password and email-verification rows in thi
 > [!IMPORTANT]
 > Refresh cookies are set with `secure: true`, `httpOnly: true`, and `sameSite: "lax"`. Local browser tests need HTTPS or a test path that handles secure cookies.
 
+### Administrator grants
+
+All routes are mounted under `/admin/v1/auth/admin-grants` and require an authenticated bearer token. Ownership is enforced in the core layer, not by route-level middleware.
+
+| Method | Path | Required role | Result |
+| --- | --- | --- | --- |
+| `POST` | `/bootstrap` | none (deployment token) | Claims the `admin-owner` role for the calling user using `ADMIN_BOOTSTRAP_TOKEN`. Fails with `409 bootstrap-closed` once an active owner exists. |
+| `GET` | `/` | `admin-owner` | Lists local administrator grants. |
+| `POST` | `/` | `admin-owner` | Grants a role to an active user. |
+| `DELETE` | `/:grantId` | `admin-owner` | Revokes a grant. Fails with `409 last-owner` when it would remove the final active owner. |
+
+`POST` and `DELETE` routes require an `Idempotency-Key` header; a repeated key replays the same result, and reusing a key with a different command returns `409 idempotency-key-reused`. Every mutation writes a redacted `administration.action.performed` outbox event.
+
 ### Rate limiting
 
 The public auth endpoints include an application-layer abuse baseline for open source installs:
@@ -229,6 +254,7 @@ The public auth endpoints include an application-layer abuse baseline for open s
 | `POST /auth/login` | 60 attempts per 5 minutes | 10 attempts per 15 minutes |
 | `POST /auth/password-reset` | 30 email-send attempts per hour | 3 email-send attempts per hour |
 | `POST /auth/verify-email/resend` | Shared with password reset | Shared with password reset |
+| `POST /admin/v1/auth/admin-grants/bootstrap` | 5 attempts per 15 minutes | n/a |
 
 Counters are stored in PostgreSQL as fixed windows in `auth_rate_limits`. IP addresses and email addresses are HMAC-SHA256 values before storage; raw identifiers are not persisted. The identifier key is derived from `AUTH_ROOT_KEY` separately from every token key.
 
@@ -244,7 +270,9 @@ application composition:
 ```ts
 import {createAuthModule} from '@shipfox/api-auth';
 
-const authModule = createAuthModule({workspaces});
+const authModule = createAuthModule({
+  workspaces,
+});
 ```
 
 It also exports lower-level pieces for tests and advanced integration:
@@ -256,6 +284,7 @@ It also exports lower-level pieces for tests and advanced integration:
 - `createLeaseTokenAuthMethod()`: the Fastify auth method for job lease tokens.
 - `issueRunnerSessionToken(claims)` / `verifyRunnerSessionToken(token)`: mint and verify runner session tokens.
 - `issueJobLeaseToken(claims)` / `verifyJobLeaseToken(token)`: mint and verify job lease tokens.
+- `createEnvironmentSignupPolicy()`: creates the environment-backed signup policy used by default. Pass `signupPolicy` to `createAuthModule` to replace it.
 - `getClientContext(request)`: reads the authenticated user context from a Fastify request.
 - `getAuthenticatedSessionContext(request)`: resolves an authenticated request to its user ID and active refresh-session ID.
 - `findUserByEmail({email})`: read-only lookup of the current owner of a normalized email; see below.
@@ -295,6 +324,14 @@ For OAuth providers, require a verified-email claim such as `email_verified`.
 session for any active, verified account. An unverified provider email could
 otherwise sign in as an existing password account with the same address.
 
+`provisionUser` uses the environment-backed signup policy by default. Pass an
+explicit `signupPolicy` only when the integration owns a replacement policy,
+such as Cloud's database-backed policy. The function checks for an existing
+user before it calls the policy, so existing users keep signing in even when
+their address is no longer allowed. For a new user, a denied policy throws
+`SignupNotAllowedError`. Call `createSessionForUser` only after provisioning
+succeeds.
+
 Add `authCookiePlugin` to the callback route group before calling a cookie
 helper. `getRefreshTokenCookie`, `setRefreshTokenCookie`, and
 `clearRefreshTokenCookie` use the configured cookie name and the `/auth` path.
@@ -367,12 +404,17 @@ The module creates tables with the `auth_` prefix:
 - `auth_refresh_tokens`
 - `auth_password_resets`
 - `auth_rate_limits`
+- `auth_admin_grants`
+- `auth_admin_command_results`
 
 Passwords use Argon2id. Password reset tokens and refresh tokens are opaque tokens stored as hashes. Email verification uses the shared email-challenges module.
 
 ## Behavior Notes
 
 - Signup sends an eight-digit verification code and returns the new user with its challenge ID.
+- Signup gating blocks account creation only. Existing users keep signing in, even when their address is not on the current allowlist.
+- A denied password signup returns `403` with error code `signup-not-allowed`. The policy message is capped at 500 characters.
+- Invitation signup validates the invitation and bypasses the signup policy. Invitations remain a separate authorization path.
 - Login only succeeds for active users with verified email addresses and a password hash.
 - Refresh tokens rotate on each refresh.
 - Password reset tokens and email challenge proofs are consumed once.

package/dist/config.d.ts

@@ -1,4 +1,5 @@
 export declare const config: Readonly<{
+    ADMIN_BOOTSTRAP_TOKEN: string | undefined;
     AUTH_JWT_EXPIRES_IN: string;
     AUTH_JOB_LEASE_TOKEN_EXPIRES_IN: string;
     AUTH_RUNNER_SESSION_TOKEN_EXPIRES_IN: string;
@@ -6,6 +7,10 @@ export declare const config: Readonly<{
     AUTH_REFRESH_ROTATION_GRACE_SECONDS: number;
     AUTH_REFRESH_COOKIE_NAME: string;
     AUTH_PASSWORD_ENABLED: boolean;
+    AUTH_SIGNUP_GATE_ENABLED: boolean;
+    AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS: string;
+    AUTH_SIGNUP_ALLOWED_EMAILS: string;
+    AUTH_SIGNUP_NOT_ALLOWED_MESSAGE: string | undefined;
     CLIENT_BASE_URL: string;
 } & import("@shipfox/config").CleanedEnvAccessors>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;;;;;;;;;kDAiCjB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;kDAqDjB,CAAC"}

package/dist/config.js

@@ -1,5 +1,9 @@
 import { bool, createConfig, num, str } from '@shipfox/config';
 export const config = createConfig({
+    ADMIN_BOOTSTRAP_TOKEN: str({
+        desc: 'Deployment secret accepted once to create the first administrator owner. Set it before bootstrap and remove or rotate it after successful bootstrap.',
+        default: undefined
+    }),
     AUTH_JWT_EXPIRES_IN: str({
         desc: 'How long an access token stays valid. Accepts a duration string such as 15m, 1h, or 7d.',
         default: '15m'
@@ -28,10 +32,32 @@ export const config = createConfig({
         desc: 'Whether password login is available. Use true or false. Defaults to true. When false, password and email-verification routes are not registered, and server startup requires another module to contribute a login method.',
         default: true
     }),
+    AUTH_SIGNUP_GATE_ENABLED: bool({
+        desc: 'Whether new account creation is restricted to the configured signup email allowlist. Defaults to false, which allows every signup.',
+        default: false
+    }),
+    AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS: str({
+        desc: 'Comma-separated email domains allowed to create accounts, such as shipfox.io,acme.com. Required when AUTH_SIGNUP_GATE_ENABLED is true unless AUTH_SIGNUP_ALLOWED_EMAILS is set.',
+        default: ''
+    }),
+    AUTH_SIGNUP_ALLOWED_EMAILS: str({
+        desc: 'Comma-separated exact email addresses allowed to create accounts. Required when AUTH_SIGNUP_GATE_ENABLED is true unless AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS is set.',
+        default: ''
+    }),
+    AUTH_SIGNUP_NOT_ALLOWED_MESSAGE: str({
+        desc: 'Description returned when the signup gate blocks an account. Optional. The default is This Shipfox deployment does not accept new accounts right now.',
+        default: undefined
+    }),
     CLIENT_BASE_URL: str({
         desc: 'Base URL of the client app. Used to build links in emails such as password resets.',
         default: 'http://localhost:5173'
     })
 });
+if (config.AUTH_SIGNUP_GATE_ENABLED && !hasSignupAllowlistEntry(config.AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS) && !hasSignupAllowlistEntry(config.AUTH_SIGNUP_ALLOWED_EMAILS)) {
+    throw new Error('AUTH_SIGNUP_GATE_ENABLED requires AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS or AUTH_SIGNUP_ALLOWED_EMAILS to be set.');
+}
+function hasSignupAllowlistEntry(value) {
+    return value.split(',').some((entry)=>entry.trim().length > 0);
+}
 
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import {bool, createConfig, num, str} from '@shipfox/config';\n\nexport const config = createConfig({\n  AUTH_JWT_EXPIRES_IN: str({\n    desc: 'How long an access token stays valid. Accepts a duration string such as 15m, 1h, or 7d.',\n    default: '15m',\n  }),\n  AUTH_JOB_LEASE_TOKEN_EXPIRES_IN: str({\n    desc: 'How long a job lease token stays valid. Set it longer than the longest job (JOB_MAX_DURATION is 60 minutes) plus a safety margin.',\n    default: '90m',\n  }),\n  AUTH_RUNNER_SESSION_TOKEN_EXPIRES_IN: str({\n    desc: 'How long a runner session token stays valid. A revoked registration token can leave existing sessions usable until this lifetime ends.',\n    default: '1h',\n  }),\n  AUTH_REFRESH_TOKEN_EXPIRES_IN_DAYS: num({\n    desc: 'How many days a refresh token stays valid before the user must sign in again.',\n    default: 14,\n  }),\n  AUTH_REFRESH_ROTATION_GRACE_SECONDS: num({\n    desc: 'Window after a refresh token is rotated during which the now-rotated token is still accepted, so concurrent refreshes from parallel tabs do not log the user out. Reuse past this window is treated as a compromise and revokes the session.',\n    default: 30,\n  }),\n  AUTH_REFRESH_COOKIE_NAME: str({\n    desc: 'Name of the browser cookie that stores the refresh token.',\n    default: 'shipfox_refresh_token',\n  }),\n  AUTH_PASSWORD_ENABLED: bool({\n    desc: 'Whether password login is available. Use true or false. Defaults to true. When false, password and email-verification routes are not registered, and server startup requires another module to contribute a login method.',\n    default: true,\n  }),\n  CLIENT_BASE_URL: str({\n    desc: 'Base URL of the client app. Used to build links in emails such as password resets.',\n    default: 'http://localhost:5173',\n  }),\n});\n"],"names":["bool","createConfig","num","str","config","AUTH_JWT_EXPIRES_IN","desc","default","AUTH_JOB_LEASE_TOKEN_EXPIRES_IN","AUTH_RUNNER_SESSION_TOKEN_EXPIRES_IN","AUTH_REFRESH_TOKEN_EXPIRES_IN_DAYS","AUTH_REFRESH_ROTATION_GRACE_SECONDS","AUTH_REFRESH_COOKIE_NAME","AUTH_PASSWORD_ENABLED","CLIENT_BASE_URL"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,YAAY,EAAEC,GAAG,EAAEC,GAAG,QAAO,kBAAkB;AAE7D,OAAO,MAAMC,SAASH,aAAa;IACjCI,qBAAqBF,IAAI;QACvBG,MAAM;QACNC,SAAS;IACX;IACAC,iCAAiCL,IAAI;QACnCG,MAAM;QACNC,SAAS;IACX;IACAE,sCAAsCN,IAAI;QACxCG,MAAM;QACNC,SAAS;IACX;IACAG,oCAAoCR,IAAI;QACtCI,MAAM;QACNC,SAAS;IACX;IACAI,qCAAqCT,IAAI;QACvCI,MAAM;QACNC,SAAS;IACX;IACAK,0BAA0BT,IAAI;QAC5BG,MAAM;QACNC,SAAS;IACX;IACAM,uBAAuBb,KAAK;QAC1BM,MAAM;QACNC,SAAS;IACX;IACAO,iBAAiBX,IAAI;QACnBG,MAAM;QACNC,SAAS;IACX;AACF,GAAG"}
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import {bool, createConfig, num, str} from '@shipfox/config';\n\nexport const config = createConfig({\n  ADMIN_BOOTSTRAP_TOKEN: str({\n    desc: 'Deployment secret accepted once to create the first administrator owner. Set it before bootstrap and remove or rotate it after successful bootstrap.',\n    default: undefined,\n  }),\n  AUTH_JWT_EXPIRES_IN: str({\n    desc: 'How long an access token stays valid. Accepts a duration string such as 15m, 1h, or 7d.',\n    default: '15m',\n  }),\n  AUTH_JOB_LEASE_TOKEN_EXPIRES_IN: str({\n    desc: 'How long a job lease token stays valid. Set it longer than the longest job (JOB_MAX_DURATION is 60 minutes) plus a safety margin.',\n    default: '90m',\n  }),\n  AUTH_RUNNER_SESSION_TOKEN_EXPIRES_IN: str({\n    desc: 'How long a runner session token stays valid. A revoked registration token can leave existing sessions usable until this lifetime ends.',\n    default: '1h',\n  }),\n  AUTH_REFRESH_TOKEN_EXPIRES_IN_DAYS: num({\n    desc: 'How many days a refresh token stays valid before the user must sign in again.',\n    default: 14,\n  }),\n  AUTH_REFRESH_ROTATION_GRACE_SECONDS: num({\n    desc: 'Window after a refresh token is rotated during which the now-rotated token is still accepted, so concurrent refreshes from parallel tabs do not log the user out. Reuse past this window is treated as a compromise and revokes the session.',\n    default: 30,\n  }),\n  AUTH_REFRESH_COOKIE_NAME: str({\n    desc: 'Name of the browser cookie that stores the refresh token.',\n    default: 'shipfox_refresh_token',\n  }),\n  AUTH_PASSWORD_ENABLED: bool({\n    desc: 'Whether password login is available. Use true or false. Defaults to true. When false, password and email-verification routes are not registered, and server startup requires another module to contribute a login method.',\n    default: true,\n  }),\n  AUTH_SIGNUP_GATE_ENABLED: bool({\n    desc: 'Whether new account creation is restricted to the configured signup email allowlist. Defaults to false, which allows every signup.',\n    default: false,\n  }),\n  AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS: str({\n    desc: 'Comma-separated email domains allowed to create accounts, such as shipfox.io,acme.com. Required when AUTH_SIGNUP_GATE_ENABLED is true unless AUTH_SIGNUP_ALLOWED_EMAILS is set.',\n    default: '',\n  }),\n  AUTH_SIGNUP_ALLOWED_EMAILS: str({\n    desc: 'Comma-separated exact email addresses allowed to create accounts. Required when AUTH_SIGNUP_GATE_ENABLED is true unless AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS is set.',\n    default: '',\n  }),\n  AUTH_SIGNUP_NOT_ALLOWED_MESSAGE: str({\n    desc: 'Description returned when the signup gate blocks an account. Optional. The default is This Shipfox deployment does not accept new accounts right now.',\n    default: undefined,\n  }),\n  CLIENT_BASE_URL: str({\n    desc: 'Base URL of the client app. Used to build links in emails such as password resets.',\n    default: 'http://localhost:5173',\n  }),\n});\n\nif (\n  config.AUTH_SIGNUP_GATE_ENABLED &&\n  !hasSignupAllowlistEntry(config.AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS) &&\n  !hasSignupAllowlistEntry(config.AUTH_SIGNUP_ALLOWED_EMAILS)\n) {\n  throw new Error(\n    'AUTH_SIGNUP_GATE_ENABLED requires AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS or AUTH_SIGNUP_ALLOWED_EMAILS to be set.',\n  );\n}\n\nfunction hasSignupAllowlistEntry(value: string): boolean {\n  return value.split(',').some((entry) => entry.trim().length > 0);\n}\n"],"names":["bool","createConfig","num","str","config","ADMIN_BOOTSTRAP_TOKEN","desc","default","undefined","AUTH_JWT_EXPIRES_IN","AUTH_JOB_LEASE_TOKEN_EXPIRES_IN","AUTH_RUNNER_SESSION_TOKEN_EXPIRES_IN","AUTH_REFRESH_TOKEN_EXPIRES_IN_DAYS","AUTH_REFRESH_ROTATION_GRACE_SECONDS","AUTH_REFRESH_COOKIE_NAME","AUTH_PASSWORD_ENABLED","AUTH_SIGNUP_GATE_ENABLED","AUTH_SIGNUP_ALLOWED_EMAIL_DOMAINS","AUTH_SIGNUP_ALLOWED_EMAILS","AUTH_SIGNUP_NOT_ALLOWED_MESSAGE","CLIENT_BASE_URL","hasSignupAllowlistEntry","Error","value","split","some","entry","trim","length"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,YAAY,EAAEC,GAAG,EAAEC,GAAG,QAAO,kBAAkB;AAE7D,OAAO,MAAMC,SAASH,aAAa;IACjCI,uBAAuBF,IAAI;QACzBG,MAAM;QACNC,SAASC;IACX;IACAC,qBAAqBN,IAAI;QACvBG,MAAM;QACNC,SAAS;IACX;IACAG,iCAAiCP,IAAI;QACnCG,MAAM;QACNC,SAAS;IACX;IACAI,sCAAsCR,IAAI;QACxCG,MAAM;QACNC,SAAS;IACX;IACAK,oCAAoCV,IAAI;QACtCI,MAAM;QACNC,SAAS;IACX;IACAM,qCAAqCX,IAAI;QACvCI,MAAM;QACNC,SAAS;IACX;IACAO,0BAA0BX,IAAI;QAC5BG,MAAM;QACNC,SAAS;IACX;IACAQ,uBAAuBf,KAAK;QAC1BM,MAAM;QACNC,SAAS;IACX;IACAS,0BAA0BhB,KAAK;QAC7BM,MAAM;QACNC,SAAS;IACX;IACAU,mCAAmCd,IAAI;QACrCG,MAAM;QACNC,SAAS;IACX;IACAW,4BAA4Bf,IAAI;QAC9BG,MAAM;QACNC,SAAS;IACX;IACAY,iCAAiChB,IAAI;QACnCG,MAAM;QACNC,SAASC;IACX;IACAY,iBAAiBjB,IAAI;QACnBG,MAAM;QACNC,SAAS;IACX;AACF,GAAG;AAEH,IACEH,OAAOY,wBAAwB,IAC/B,CAACK,wBAAwBjB,OAAOa,iCAAiC,KACjE,CAACI,wBAAwBjB,OAAOc,0BAA0B,GAC1D;IACA,MAAM,IAAII,MACR;AAEJ;AAEA,SAASD,wBAAwBE,KAAa;IAC5C,OAAOA,MAAMC,KAAK,CAAC,KAAKC,IAAI,CAAC,CAACC,QAAUA,MAAMC,IAAI,GAAGC,MAAM,GAAG;AAChE"}

package/dist/core/admin-role-model.d.ts

@@ -0,0 +1,5 @@
+import type { AdminRole } from '@shipfox/api-auth-dto';
+export declare const ADMIN_ROLES: readonly AdminRole[];
+export declare function hasMinimumAdminRole(role: AdminRole, minimumRole: AdminRole): boolean;
+export declare function highestAdminRole(roles: readonly AdminRole[]): AdminRole | null;
+//# sourceMappingURL=admin-role-model.d.ts.map

package/dist/core/admin-role-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-role-model.d.ts","sourceRoot":"","sources":["../../src/core/admin-role-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAI3C,CAAC;AAQF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,GAAG,OAAO,CAEpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAM9E"}

package/dist/core/admin-role-model.js

@@ -0,0 +1,18 @@
+export const ADMIN_ROLES = [
+    'admin-observer',
+    'admin-operator',
+    'admin-owner'
+];
+const ADMIN_ROLE_RANK = {
+    'admin-observer': 1,
+    'admin-operator': 2,
+    'admin-owner': 3
+};
+export function hasMinimumAdminRole(role, minimumRole) {
+    return ADMIN_ROLE_RANK[role] >= ADMIN_ROLE_RANK[minimumRole];
+}
+export function highestAdminRole(roles) {
+    return roles.reduce((highest, role)=>highest === null || ADMIN_ROLE_RANK[role] > ADMIN_ROLE_RANK[highest] ? role : highest, null);
+}
+
+//# sourceMappingURL=admin-role-model.js.map

package/dist/core/admin-role-model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/admin-role-model.ts"],"sourcesContent":["import type {AdminRole} from '@shipfox/api-auth-dto';\n\nexport const ADMIN_ROLES: readonly AdminRole[] = [\n  'admin-observer',\n  'admin-operator',\n  'admin-owner',\n];\n\nconst ADMIN_ROLE_RANK: Record<AdminRole, number> = {\n  'admin-observer': 1,\n  'admin-operator': 2,\n  'admin-owner': 3,\n};\n\nexport function hasMinimumAdminRole(role: AdminRole, minimumRole: AdminRole): boolean {\n  return ADMIN_ROLE_RANK[role] >= ADMIN_ROLE_RANK[minimumRole];\n}\n\nexport function highestAdminRole(roles: readonly AdminRole[]): AdminRole | null {\n  return roles.reduce<AdminRole | null>(\n    (highest, role) =>\n      highest === null || ADMIN_ROLE_RANK[role] > ADMIN_ROLE_RANK[highest] ? role : highest,\n    null,\n  );\n}\n"],"names":["ADMIN_ROLES","ADMIN_ROLE_RANK","hasMinimumAdminRole","role","minimumRole","highestAdminRole","roles","reduce","highest"],"mappings":"AAEA,OAAO,MAAMA,cAAoC;IAC/C;IACA;IACA;CACD,CAAC;AAEF,MAAMC,kBAA6C;IACjD,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;AACjB;AAEA,OAAO,SAASC,oBAAoBC,IAAe,EAAEC,WAAsB;IACzE,OAAOH,eAAe,CAACE,KAAK,IAAIF,eAAe,CAACG,YAAY;AAC9D;AAEA,OAAO,SAASC,iBAAiBC,KAA2B;IAC1D,OAAOA,MAAMC,MAAM,CACjB,CAACC,SAASL,OACRK,YAAY,QAAQP,eAAe,CAACE,KAAK,GAAGF,eAAe,CAACO,QAAQ,GAAGL,OAAOK,SAChF;AAEJ"}

package/dist/core/admin-role.d.ts

@@ -0,0 +1,13 @@
+import type { AdminRole } from '@shipfox/api-auth-dto';
+export { ADMIN_ROLES, hasMinimumAdminRole, highestAdminRole } from './admin-role-model.js';
+export declare function getCurrentAdminRole(params: {
+    userId: string;
+}): Promise<AdminRole | null>;
+export declare function requireAdminRole(params: {
+    userId: string;
+    minimumRole: AdminRole;
+}): Promise<AdminRole>;
+export declare function revokeAdminGrant(params: {
+    grantId: string;
+}): Promise<import("./entities/admin-grant.js").AdminGrant | undefined>;
+//# sourceMappingURL=admin-role.d.ts.map

package/dist/core/admin-role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-role.d.ts","sourceRoot":"","sources":["../../src/core/admin-role.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAKrD,OAAO,EAAC,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AAEzF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAE7F;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,SAAS,CAAC;CACxB,GAAG,OAAO,CAAC,SAAS,CAAC,CAMrB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,uEAE/D"}

package/dist/core/admin-role.js

@@ -0,0 +1,21 @@
+import { findCurrentAdminRole, revokeAdminGrant as revokeAdminGrantInDb } from '#db/admin-grants.js';
+import { hasMinimumAdminRole } from './admin-role-model.js';
+import { AdminRoleRequiredError } from './errors.js';
+export { ADMIN_ROLES, hasMinimumAdminRole, highestAdminRole } from './admin-role-model.js';
+export async function getCurrentAdminRole(params) {
+    return await findCurrentAdminRole(params);
+}
+export async function requireAdminRole(params) {
+    const role = await getCurrentAdminRole({
+        userId: params.userId
+    });
+    if (!role || !hasMinimumAdminRole(role, params.minimumRole)) {
+        throw new AdminRoleRequiredError(params.minimumRole);
+    }
+    return role;
+}
+export async function revokeAdminGrant(params) {
+    return await revokeAdminGrantInDb(params);
+}
+
+//# sourceMappingURL=admin-role.js.map

package/dist/core/admin-role.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/admin-role.ts"],"sourcesContent":["import type {AdminRole} from '@shipfox/api-auth-dto';\nimport {findCurrentAdminRole, revokeAdminGrant as revokeAdminGrantInDb} from '#db/admin-grants.js';\nimport {hasMinimumAdminRole} from './admin-role-model.js';\nimport {AdminRoleRequiredError} from './errors.js';\n\nexport {ADMIN_ROLES, hasMinimumAdminRole, highestAdminRole} from './admin-role-model.js';\n\nexport async function getCurrentAdminRole(params: {userId: string}): Promise<AdminRole | null> {\n  return await findCurrentAdminRole(params);\n}\n\nexport async function requireAdminRole(params: {\n  userId: string;\n  minimumRole: AdminRole;\n}): Promise<AdminRole> {\n  const role = await getCurrentAdminRole({userId: params.userId});\n  if (!role || !hasMinimumAdminRole(role, params.minimumRole)) {\n    throw new AdminRoleRequiredError(params.minimumRole);\n  }\n  return role;\n}\n\nexport async function revokeAdminGrant(params: {grantId: string}) {\n  return await revokeAdminGrantInDb(params);\n}\n"],"names":["findCurrentAdminRole","revokeAdminGrant","revokeAdminGrantInDb","hasMinimumAdminRole","AdminRoleRequiredError","ADMIN_ROLES","highestAdminRole","getCurrentAdminRole","params","requireAdminRole","role","userId","minimumRole"],"mappings":"AACA,SAAQA,oBAAoB,EAAEC,oBAAoBC,oBAAoB,QAAO,sBAAsB;AACnG,SAAQC,mBAAmB,QAAO,wBAAwB;AAC1D,SAAQC,sBAAsB,QAAO,cAAc;AAEnD,SAAQC,WAAW,EAAEF,mBAAmB,EAAEG,gBAAgB,QAAO,wBAAwB;AAEzF,OAAO,eAAeC,oBAAoBC,MAAwB;IAChE,OAAO,MAAMR,qBAAqBQ;AACpC;AAEA,OAAO,eAAeC,iBAAiBD,MAGtC;IACC,MAAME,OAAO,MAAMH,oBAAoB;QAACI,QAAQH,OAAOG,MAAM;IAAA;IAC7D,IAAI,CAACD,QAAQ,CAACP,oBAAoBO,MAAMF,OAAOI,WAAW,GAAG;QAC3D,MAAM,IAAIR,uBAAuBI,OAAOI,WAAW;IACrD;IACA,OAAOF;AACT;AAEA,OAAO,eAAeT,iBAAiBO,MAAyB;IAC9D,OAAO,MAAMN,qBAAqBM;AACpC"}

package/dist/core/administration.d.ts

@@ -0,0 +1,27 @@
+import type { AdminRole } from '@shipfox/api-auth-dto';
+import type { AdminGrant } from './entities/admin-grant.js';
+import { AdminBootstrapClosedError, AdminGrantAlreadyExistsError, AdminGrantNotFoundError, AdminIdempotencyKeyReuseError, InvalidAdminBootstrapTokenError, LastAdminOwnerError, UserNotFoundError } from './errors.js';
+export declare function hashAdministrationValue(value: string): string;
+export declare function administrationCommandFingerprint(command: string, input: unknown): string;
+export interface AdministrationMutationContext {
+    actorId: string;
+    idempotencyKey: string;
+    correlationId: string;
+}
+export declare function bootstrapFirstAdminOwner(params: AdministrationMutationContext & {
+    bootstrapToken: string;
+}): Promise<AdminGrant>;
+export declare function listAdministratorGrants(params: {
+    actorId: string;
+}): Promise<AdminGrant[]>;
+export declare function grantAdministratorRole(params: AdministrationMutationContext & {
+    userId: string;
+    role: AdminRole;
+    reason: string;
+}): Promise<AdminGrant>;
+export declare function revokeAdministratorGrant(params: AdministrationMutationContext & {
+    grantId: string;
+    reason: string;
+}): Promise<AdminGrant>;
+export { AdminBootstrapClosedError, AdminGrantAlreadyExistsError, AdminGrantNotFoundError, AdminIdempotencyKeyReuseError, InvalidAdminBootstrapTokenError, LastAdminOwnerError, UserNotFoundError, };
+//# sourceMappingURL=administration.d.ts.map

package/dist/core/administration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"administration.d.ts","sourceRoot":"","sources":["../../src/core/administration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAUrD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,6BAA6B,EAC7B,+BAA+B,EAC/B,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAOrB,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAExF;AAkCD,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,6BAA6B,GAAG;IAAC,cAAc,EAAE,MAAM,CAAA;CAAC,GAC/D,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAG9F;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,6BAA6B,GAAG;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GACxF,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,6BAA6B,GAAG;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GACxE,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,6BAA6B,EAC7B,+BAA+B,EAC/B,mBAAmB,EACnB,iBAAiB,GAClB,CAAC"}

package/dist/core/administration.js

@@ -0,0 +1,122 @@
+import { createHash, timingSafeEqual } from 'node:crypto';
+import { createAdministrationActionEvent } from '@shipfox/api-common-dto';
+import { config } from '#config.js';
+import { bootstrapFirstAdminOwner as bootstrapFirstAdminOwnerInDb, grantAdminRoleWithAudit, listAdminGrants, revokeAdminGrantWithAudit } from '#db/admin-grants.js';
+import { requireAdminRole } from './admin-role.js';
+import { AdminBootstrapClosedError, AdminGrantAlreadyExistsError, AdminGrantNotFoundError, AdminIdempotencyKeyReuseError, InvalidAdminBootstrapTokenError, LastAdminOwnerError, UserNotFoundError } from './errors.js';
+const ADMIN_OWNER_ROLE = 'admin-owner';
+const BOOTSTRAP_COMMAND = 'auth.admin_grant.bootstrap';
+const GRANT_COMMAND = 'auth.admin_grant.grant';
+const REVOKE_COMMAND = 'auth.admin_grant.revoke';
+export function hashAdministrationValue(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+export function administrationCommandFingerprint(command, input) {
+    return hashAdministrationValue(`${command}:${JSON.stringify(input)}`);
+}
+function bootstrapTokenMatches(candidate, expected) {
+    if (!expected) return false;
+    const candidateHash = Buffer.from(hashAdministrationValue(candidate), 'hex');
+    const expectedHash = Buffer.from(hashAdministrationValue(expected), 'hex');
+    return timingSafeEqual(candidateHash, expectedHash);
+}
+function administrationEvent(params) {
+    return createAdministrationActionEvent({
+        actorId: params.actorId,
+        actorRole: params.actorRole,
+        requiredRole: ADMIN_OWNER_ROLE,
+        command: params.command,
+        targetType: params.targetType,
+        targetId: params.targetId,
+        reason: params.reason,
+        result: 'succeeded',
+        correlationId: params.correlationId,
+        idempotencyKeyFingerprint: params.idempotencyKeyFingerprint,
+        occurredAt: new Date().toISOString()
+    });
+}
+export async function bootstrapFirstAdminOwner(params) {
+    if (!bootstrapTokenMatches(params.bootstrapToken, config.ADMIN_BOOTSTRAP_TOKEN)) {
+        throw new InvalidAdminBootstrapTokenError();
+    }
+    return await bootstrapFirstAdminOwnerInDb({
+        userId: params.actorId,
+        actorId: params.actorId,
+        idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),
+        requestFingerprint: administrationCommandFingerprint(BOOTSTRAP_COMMAND, {
+            actorId: params.actorId
+        }),
+        event: administrationEvent({
+            actorId: params.actorId,
+            actorRole: ADMIN_OWNER_ROLE,
+            command: BOOTSTRAP_COMMAND,
+            targetType: 'user',
+            targetId: params.actorId,
+            reason: 'Initial administrator owner bootstrap',
+            correlationId: params.correlationId,
+            idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey)
+        })
+    });
+}
+export async function listAdministratorGrants(params) {
+    await requireAdminRole({
+        userId: params.actorId,
+        minimumRole: ADMIN_OWNER_ROLE
+    });
+    return await listAdminGrants();
+}
+export async function grantAdministratorRole(params) {
+    const actorRole = await requireAdminRole({
+        userId: params.actorId,
+        minimumRole: ADMIN_OWNER_ROLE
+    });
+    return await grantAdminRoleWithAudit({
+        userId: params.userId,
+        role: params.role,
+        actorId: params.actorId,
+        idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),
+        requestFingerprint: administrationCommandFingerprint(GRANT_COMMAND, {
+            userId: params.userId,
+            role: params.role,
+            reason: params.reason
+        }),
+        event: administrationEvent({
+            actorId: params.actorId,
+            actorRole,
+            command: GRANT_COMMAND,
+            targetType: 'user',
+            targetId: params.userId,
+            reason: params.reason,
+            correlationId: params.correlationId,
+            idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey)
+        })
+    });
+}
+export async function revokeAdministratorGrant(params) {
+    const actorRole = await requireAdminRole({
+        userId: params.actorId,
+        minimumRole: ADMIN_OWNER_ROLE
+    });
+    return await revokeAdminGrantWithAudit({
+        grantId: params.grantId,
+        actorId: params.actorId,
+        idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),
+        requestFingerprint: administrationCommandFingerprint(REVOKE_COMMAND, {
+            grantId: params.grantId,
+            reason: params.reason
+        }),
+        event: administrationEvent({
+            actorId: params.actorId,
+            actorRole,
+            command: REVOKE_COMMAND,
+            targetType: 'admin-grant',
+            targetId: params.grantId,
+            reason: params.reason,
+            correlationId: params.correlationId,
+            idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey)
+        })
+    });
+}
+export { AdminBootstrapClosedError, AdminGrantAlreadyExistsError, AdminGrantNotFoundError, AdminIdempotencyKeyReuseError, InvalidAdminBootstrapTokenError, LastAdminOwnerError, UserNotFoundError };
+
+//# sourceMappingURL=administration.js.map

package/dist/core/administration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/administration.ts"],"sourcesContent":["import {createHash, timingSafeEqual} from 'node:crypto';\nimport type {AdminRole} from '@shipfox/api-auth-dto';\nimport {createAdministrationActionEvent} from '@shipfox/api-common-dto';\nimport {config} from '#config.js';\nimport {\n  bootstrapFirstAdminOwner as bootstrapFirstAdminOwnerInDb,\n  grantAdminRoleWithAudit,\n  listAdminGrants,\n  revokeAdminGrantWithAudit,\n} from '#db/admin-grants.js';\nimport {requireAdminRole} from './admin-role.js';\nimport type {AdminGrant} from './entities/admin-grant.js';\nimport {\n  AdminBootstrapClosedError,\n  AdminGrantAlreadyExistsError,\n  AdminGrantNotFoundError,\n  AdminIdempotencyKeyReuseError,\n  InvalidAdminBootstrapTokenError,\n  LastAdminOwnerError,\n  UserNotFoundError,\n} from './errors.js';\n\nconst ADMIN_OWNER_ROLE: AdminRole = 'admin-owner';\nconst BOOTSTRAP_COMMAND = 'auth.admin_grant.bootstrap';\nconst GRANT_COMMAND = 'auth.admin_grant.grant';\nconst REVOKE_COMMAND = 'auth.admin_grant.revoke';\n\nexport function hashAdministrationValue(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n\nexport function administrationCommandFingerprint(command: string, input: unknown): string {\n  return hashAdministrationValue(`${command}:${JSON.stringify(input)}`);\n}\n\nfunction bootstrapTokenMatches(candidate: string, expected: string | undefined): boolean {\n  if (!expected) return false;\n  const candidateHash = Buffer.from(hashAdministrationValue(candidate), 'hex');\n  const expectedHash = Buffer.from(hashAdministrationValue(expected), 'hex');\n  return timingSafeEqual(candidateHash, expectedHash);\n}\n\nfunction administrationEvent(params: {\n  actorId: string;\n  actorRole: AdminRole;\n  command: string;\n  targetType: string;\n  targetId: string;\n  reason: string;\n  correlationId: string;\n  idempotencyKeyFingerprint: string;\n}) {\n  return createAdministrationActionEvent({\n    actorId: params.actorId,\n    actorRole: params.actorRole,\n    requiredRole: ADMIN_OWNER_ROLE,\n    command: params.command,\n    targetType: params.targetType,\n    targetId: params.targetId,\n    reason: params.reason,\n    result: 'succeeded',\n    correlationId: params.correlationId,\n    idempotencyKeyFingerprint: params.idempotencyKeyFingerprint,\n    occurredAt: new Date().toISOString(),\n  });\n}\n\nexport interface AdministrationMutationContext {\n  actorId: string;\n  idempotencyKey: string;\n  correlationId: string;\n}\n\nexport async function bootstrapFirstAdminOwner(\n  params: AdministrationMutationContext & {bootstrapToken: string},\n): Promise<AdminGrant> {\n  if (!bootstrapTokenMatches(params.bootstrapToken, config.ADMIN_BOOTSTRAP_TOKEN)) {\n    throw new InvalidAdminBootstrapTokenError();\n  }\n\n  return await bootstrapFirstAdminOwnerInDb({\n    userId: params.actorId,\n    actorId: params.actorId,\n    idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),\n    requestFingerprint: administrationCommandFingerprint(BOOTSTRAP_COMMAND, {\n      actorId: params.actorId,\n    }),\n    event: administrationEvent({\n      actorId: params.actorId,\n      actorRole: ADMIN_OWNER_ROLE,\n      command: BOOTSTRAP_COMMAND,\n      targetType: 'user',\n      targetId: params.actorId,\n      reason: 'Initial administrator owner bootstrap',\n      correlationId: params.correlationId,\n      idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),\n    }),\n  });\n}\n\nexport async function listAdministratorGrants(params: {actorId: string}): Promise<AdminGrant[]> {\n  await requireAdminRole({userId: params.actorId, minimumRole: ADMIN_OWNER_ROLE});\n  return await listAdminGrants();\n}\n\nexport async function grantAdministratorRole(\n  params: AdministrationMutationContext & {userId: string; role: AdminRole; reason: string},\n): Promise<AdminGrant> {\n  const actorRole = await requireAdminRole({\n    userId: params.actorId,\n    minimumRole: ADMIN_OWNER_ROLE,\n  });\n  return await grantAdminRoleWithAudit({\n    userId: params.userId,\n    role: params.role,\n    actorId: params.actorId,\n    idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),\n    requestFingerprint: administrationCommandFingerprint(GRANT_COMMAND, {\n      userId: params.userId,\n      role: params.role,\n      reason: params.reason,\n    }),\n    event: administrationEvent({\n      actorId: params.actorId,\n      actorRole,\n      command: GRANT_COMMAND,\n      targetType: 'user',\n      targetId: params.userId,\n      reason: params.reason,\n      correlationId: params.correlationId,\n      idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),\n    }),\n  });\n}\n\nexport async function revokeAdministratorGrant(\n  params: AdministrationMutationContext & {grantId: string; reason: string},\n): Promise<AdminGrant> {\n  const actorRole = await requireAdminRole({\n    userId: params.actorId,\n    minimumRole: ADMIN_OWNER_ROLE,\n  });\n  return await revokeAdminGrantWithAudit({\n    grantId: params.grantId,\n    actorId: params.actorId,\n    idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),\n    requestFingerprint: administrationCommandFingerprint(REVOKE_COMMAND, {\n      grantId: params.grantId,\n      reason: params.reason,\n    }),\n    event: administrationEvent({\n      actorId: params.actorId,\n      actorRole,\n      command: REVOKE_COMMAND,\n      targetType: 'admin-grant',\n      targetId: params.grantId,\n      reason: params.reason,\n      correlationId: params.correlationId,\n      idempotencyKeyFingerprint: hashAdministrationValue(params.idempotencyKey),\n    }),\n  });\n}\n\nexport {\n  AdminBootstrapClosedError,\n  AdminGrantAlreadyExistsError,\n  AdminGrantNotFoundError,\n  AdminIdempotencyKeyReuseError,\n  InvalidAdminBootstrapTokenError,\n  LastAdminOwnerError,\n  UserNotFoundError,\n};\n"],"names":["createHash","timingSafeEqual","createAdministrationActionEvent","config","bootstrapFirstAdminOwner","bootstrapFirstAdminOwnerInDb","grantAdminRoleWithAudit","listAdminGrants","revokeAdminGrantWithAudit","requireAdminRole","AdminBootstrapClosedError","AdminGrantAlreadyExistsError","AdminGrantNotFoundError","AdminIdempotencyKeyReuseError","InvalidAdminBootstrapTokenError","LastAdminOwnerError","UserNotFoundError","ADMIN_OWNER_ROLE","BOOTSTRAP_COMMAND","GRANT_COMMAND","REVOKE_COMMAND","hashAdministrationValue","value","update","digest","administrationCommandFingerprint","command","input","JSON","stringify","bootstrapTokenMatches","candidate","expected","candidateHash","Buffer","from","expectedHash","administrationEvent","params","actorId","actorRole","requiredRole","targetType","targetId","reason","result","correlationId","idempotencyKeyFingerprint","occurredAt","Date","toISOString","bootstrapToken","ADMIN_BOOTSTRAP_TOKEN","userId","idempotencyKey","requestFingerprint","event","listAdministratorGrants","minimumRole","grantAdministratorRole","role","revokeAdministratorGrant","grantId"],"mappings":"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"}

package/dist/core/auth.d.ts

@@ -1,14 +1,18 @@
+import { type AdminRole } from '@shipfox/api-auth-dto';
 import { type WorkspacesInterModuleClient } from '@shipfox/api-workspaces-dto/inter-module';
 import type { User } from './entities/user.js';
 import { AuthDependencyUnavailableError, EmailNotVerifiedError, InvalidCredentialsError, UserNotFoundError } from './errors.js';
+import type { SignupPolicy } from './ports.js';
 export interface SignupParams {
     email: string;
     password: string;
     name?: string | undefined;
+    signupPolicy?: SignupPolicy | undefined;
 }
 export interface ProvisionUserParams {
     email: string;
     name?: string | null | undefined;
+    signupPolicy?: SignupPolicy | undefined;
 }
 /**
  * Creates a verified, password-less user for an external identity provider.
@@ -53,6 +57,7 @@ export interface LoginResult {
     token: string;
     refreshToken: string;
     user: User;
+    adminRole: AdminRole | null;
 }
 export declare function login(params: LoginParams): Promise<LoginResult>;
 export interface CreateSessionForUserParams {
@@ -64,6 +69,7 @@ export interface CreateSessionForUserResult {
     token: string;
     refreshToken: string;
     user: User;
+    adminRole: AdminRole | null;
 }
 export type CreateSessionForUserError = AuthDependencyUnavailableError | EmailNotVerifiedError | InvalidCredentialsError | UserNotFoundError;
 export declare function createSessionForUser(params: CreateSessionForUserParams): Promise<CreateSessionForUserResult>;
@@ -72,6 +78,7 @@ export interface RefreshAccessTokenResult {
     /** Undefined on a grace-window hit: keep the existing cookie instead of rotating it. */
     refreshToken: string | undefined;
     user: User;
+    adminRole: AdminRole | null;
 }
 export declare function refreshAccessToken(params: {
     refreshToken: string;
@@ -81,6 +88,7 @@ export interface ConfirmEmailVerificationResult {
     token: string;
     refreshToken: string;
     user: User;
+    adminRole: AdminRole | null;
 }
 export interface ResendEmailVerificationResult {
     nextResendAvailableAt: Date;
@@ -103,6 +111,7 @@ export interface ConfirmPasswordResetResult {
     token: string;
     refreshToken: string;
     user: User;
+    adminRole: AdminRole | null;
 }
 export declare function confirmPasswordReset(params: {
     token: string;

package/dist/core/auth.d.ts.map

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