@fuzdev/fuz_app 0.29.0 → 0.31.0

package/dist/testing/auth_apps.js

@@ -14,6 +14,7 @@ import { fuz_auth_guard_resolver } from '../auth/route_guards.js';
 import { REQUEST_CONTEXT_KEY } from '../auth/request_context.js';
 import { CREDENTIAL_TYPE_KEY } from '../hono_context.js';
 import { create_stub_db } from './stubs.js';
+import { create_test_account, create_test_actor, create_test_permit } from './entities.js';
 /**
  * Create a mock request context with optional role permit.
  *
@@ -21,39 +22,9 @@ import { create_stub_db } from './stubs.js';
  * @returns a valid `RequestContext`
  */
 export const create_test_request_context = (role) => ({
-    account: {
-        id: 'acc_1',
-        username: 'testuser',
-        password_hash: 'hash',
-        created_at: new Date().toISOString(),
-        updated_at: new Date().toISOString(),
-        created_by: null,
-        updated_by: null,
-        email: null,
-        email_verified: false,
-    },
-    actor: {
-        id: 'act_1',
-        account_id: 'acc_1',
-        name: 'testuser',
-        created_at: new Date().toISOString(),
-        updated_at: null,
-        updated_by: null,
-    },
-    permits: role
-        ? [
-            {
-                id: 'perm_1',
-                actor_id: 'act_1',
-                role,
-                created_at: new Date().toISOString(),
-                expires_at: null,
-                revoked_at: null,
-                revoked_by: null,
-                granted_by: null,
-            },
-        ]
-        : [],
+    account: create_test_account({ id: 'acc_1', username: 'testuser' }),
+    actor: create_test_actor({ id: 'act_1', account_id: 'acc_1', name: 'testuser' }),
+    permits: role ? [create_test_permit({ id: 'perm_1', actor_id: 'act_1', role })] : [],
 });
 /**
  * Create a Hono test app from route specs with optional auth context.

package/dist/testing/db.d.ts

@@ -76,7 +76,7 @@ export declare const AUTH_INTEGRATION_TRUNCATE_TABLES: string[];
  *
  * When adding tables to `AUTH_MIGRATIONS`, add them here too.
  */
-export declare const AUTH_DROP_TABLES: readonly ["app_settings", "invite", "audit_log", "api_token", "auth_session", "permit", "actor", "account", "bootstrap_lock"];
+export declare const AUTH_DROP_TABLES: readonly ["app_settings", "invite", "audit_log", "api_token", "auth_session", "permit", "permit_offer", "actor", "account", "bootstrap_lock"];
 /**
  * Drop all auth tables and schema version tracking for a clean slate.
  *

package/dist/testing/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/db.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AA6B7B,OAAO,KAAK,EAAC,EAAE,EAAC,MAAM,aAAa,CAAC;AAKpC;;GAEG;AACH,eAAO,MAAM,KAAK,SAA4B,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,IAAI,CAGvD,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,KAAG,SAkB7E,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC7B,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EACtC,WAAW,MAAM,KACf,SA2DF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,UAOhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,UAAyC,CAAC;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,+HAUnB,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,IAAI,CAK3D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAC9B,WAAW,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,EACvC,iBAAiB,KAAK,CAAC,MAAM,CAAC,KAC5B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,IAAI,CAwBzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,KAAK,CAAC,SAAS,CAAC,KAAG,IAMnE,CAAC"}
+{"version":3,"file":"db.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/db.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AA6B7B,OAAO,KAAK,EAAC,EAAE,EAAC,MAAM,aAAa,CAAC;AAKpC;;GAEG;AACH,eAAO,MAAM,KAAK,SAA4B,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,IAAI,CAGvD,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,KAAG,SAkB7E,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC7B,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EACtC,WAAW,MAAM,KACf,SA2DF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,UAQhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,UAAyC,CAAC;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,+IAWnB,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,IAAI,CAK3D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAC9B,WAAW,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,EACvC,iBAAiB,KAAK,CAAC,MAAM,CAAC,KAC5B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,IAAI,CAwBzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,KAAK,CAAC,SAAS,CAAC,KAAG,IAMnE,CAAC"}

package/dist/testing/db.js

@@ -162,6 +162,7 @@ export const AUTH_TRUNCATE_TABLES = [
     'api_token',
     'auth_session',
     'permit',
+    'permit_offer',
     'actor',
     'account',
 ];
@@ -189,6 +190,7 @@ export const AUTH_DROP_TABLES = [
     'api_token',
     'auth_session',
     'permit',
+    'permit_offer',
     'actor',
     'account',
     'bootstrap_lock',

package/dist/testing/entities.d.ts

@@ -1,21 +1,43 @@
 import './assert_dev_env.js';
-/**
- * Shared test entity factories for `Account`, `Actor`, `Permit`, and `RequestContext`.
- *
- * Accepts `Partial<T>` overrides — callers set only what matters to their test.
- * Uses `create_test_*` names to avoid collisions with real `create_account_with_actor`
- * from `account_queries.ts`.
- *
- * @module
- */
 import type { Account, Actor, Permit } from '../auth/account_schema.js';
+import type { AuditLogEvent } from '../auth/audit_log_schema.js';
 import type { RequestContext } from '../auth/request_context.js';
+/** Override type for `create_test_account` — id-like fields accept plain `string`. */
+export type TestAccountOverrides = Partial<Omit<Account, 'id' | 'created_by' | 'updated_by'>> & {
+    id?: string;
+    created_by?: string | null;
+    updated_by?: string | null;
+};
 /** Create a test `Account` with sensible defaults. */
-export declare const create_test_account: (overrides?: Partial<Account>) => Account;
+export declare const create_test_account: (overrides?: TestAccountOverrides) => Account;
+/** Override type for `create_test_actor` — id-like fields accept plain `string`. */
+export type TestActorOverrides = Partial<Omit<Actor, 'id' | 'account_id' | 'updated_by'>> & {
+    id?: string;
+    account_id?: string;
+    updated_by?: string | null;
+};
 /** Create a test `Actor` with sensible defaults. */
-export declare const create_test_actor: (overrides?: Partial<Actor>) => Actor;
+export declare const create_test_actor: (overrides?: TestActorOverrides) => Actor;
+/** Override type for `create_test_permit` — id-like fields accept plain `string`. */
+export type TestPermitOverrides = Partial<Omit<Permit, 'id' | 'actor_id' | 'scope_id' | 'revoked_by' | 'granted_by' | 'source_offer_id'>> & {
+    id?: string;
+    actor_id?: string;
+    scope_id?: string | null;
+    revoked_by?: string | null;
+    granted_by?: string | null;
+    source_offer_id?: string | null;
+};
 /** Create a test `Permit` with sensible defaults. */
-export declare const create_test_permit: (overrides?: Partial<Permit>) => Permit;
+export declare const create_test_permit: (overrides?: TestPermitOverrides) => Permit;
 /** Create a test `RequestContext` with permits from partial overrides. */
-export declare const create_test_context: (permits?: Array<Partial<Permit>>) => RequestContext;
+export declare const create_test_context: (permits?: Array<TestPermitOverrides>) => RequestContext;
+/** Override type for `create_test_audit_event` — id-like fields accept plain `string`. */
+export type TestAuditEventOverrides = Partial<Omit<AuditLogEvent, 'id' | 'actor_id' | 'account_id' | 'target_account_id'>> & {
+    id?: string;
+    actor_id?: string | null;
+    account_id?: string | null;
+    target_account_id?: string | null;
+};
+/** Create a test `AuditLogEvent` with sensible defaults. */
+export declare const create_test_audit_event: (overrides?: TestAuditEventOverrides) => AuditLogEvent;
 //# sourceMappingURL=entities.d.ts.map

package/dist/testing/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/entities.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAC,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,4BAA4B,CAAC;AAE/D,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,GAAI,YAAY,OAAO,CAAC,OAAO,CAAC,KAAG,OAWjE,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,GAAI,YAAY,OAAO,CAAC,KAAK,CAAC,KAAG,KAQ7D,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,GAAI,YAAY,OAAO,CAAC,MAAM,CAAC,KAAG,MAU/D,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,GAAI,UAAS,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAQ,KAAG,cAI3E,CAAC"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/entities.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAgB7B,OAAO,KAAK,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAC,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,4BAA4B,CAAC;AAE/D,sFAAsF;AACtF,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GAAG;IAC/F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,GAAI,YAAY,oBAAoB,KAAG,OAWrE,CAAC;AAEH,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GAAG;IAC3F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,GAAI,YAAY,kBAAkB,KAAG,KAQjE,CAAC;AAEH,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACxC,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,iBAAiB,CAAC,CAC9F,GAAG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,GAAI,YAAY,mBAAmB,KAAG,MAanE,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,GAC/B,UAAS,KAAK,CAAC,mBAAmB,CAAQ,KACxC,cAID,CAAC;AAEH,0FAA0F;AAC1F,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC5C,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,UAAU,GAAG,YAAY,GAAG,mBAAmB,CAAC,CAC3E,GAAG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB,GAAI,YAAY,uBAAuB,KAAG,aAY5E,CAAC"}

package/dist/testing/entities.js

@@ -27,11 +27,14 @@ export const create_test_permit = (overrides) => ({
     id: 'permit-test',
     actor_id: 'actor-test',
     role: 'admin',
+    scope_id: null,
     created_at: '2024-01-01T00:00:00Z',
     expires_at: null,
     revoked_at: null,
     revoked_by: null,
+    revoked_reason: null,
     granted_by: null,
+    source_offer_id: null,
     ...overrides,
 });
 /** Create a test `RequestContext` with permits from partial overrides. */
@@ -40,3 +43,17 @@ export const create_test_context = (permits = [{}]) => ({
     actor: create_test_actor(),
     permits: permits.map((p) => create_test_permit(p)),
 });
+/** Create a test `AuditLogEvent` with sensible defaults. */
+export const create_test_audit_event = (overrides) => ({
+    id: 'evt-test',
+    seq: 1,
+    event_type: 'login',
+    outcome: 'success',
+    actor_id: 'actor-test',
+    account_id: 'acct-test',
+    target_account_id: null,
+    ip: '127.0.0.1',
+    created_at: '2024-01-01T00:00:00Z',
+    metadata: null,
+    ...overrides,
+});

package/dist/testing/integration.d.ts

@@ -3,6 +3,7 @@ import type { SessionOptions } from '../auth/session_cookie.js';
 import type { AppServerContext, AppServerOptions } from '../server/app_server.js';
 import type { RouteSpec } from '../http/route_spec.js';
 import { type DbFactory } from './db.js';
+import type { RpcEndpointSpec } from '../http/surface.js';
 /**
  * Configuration for `describe_standard_integration_tests`.
  */
@@ -18,6 +19,15 @@ export interface StandardIntegrationTestOptions {
      * Pass consumer factories (e.g. `[pglite_factory, pg_factory]`) to also test against PostgreSQL.
      */
     db_factories?: Array<DbFactory>;
+    /**
+     * RPC endpoint specs — required. This suite dispatches
+     * `account_verify`, `account_session_*`, and `account_token_*` via
+     * `rpc_call` (the `/api/account/verify` REST route is a status-only
+     * nginx shim with no payload). Hard-fails via
+     * `require_rpc_endpoint_path` on setup so consumer projects see a
+     * clear setup error instead of confusing test failures.
+     */
+    rpc_endpoints: Array<RpcEndpointSpec>;
 }
 /**
  * Standard integration test suite for fuz_app auth routes.

package/dist/testing/integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/integration.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAsB7B,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAIN,KAAK,SAAS,EACd,MAAM,SAAS,CAAC;AAgBjB;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC9C,4CAA4C;IAC5C,eAAe,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,wDAAwD;IACxD,kBAAkB,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IAChE,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CACpB,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,iBAAiB,GAAG,oBAAoB,CAAC,CAC5E,CAAC;IACF;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;CAChC;AAeD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mCAAmC,GAC/C,SAAS,8BAA8B,KACrC,IAm/CF,CAAC"}
+{"version":3,"file":"integration.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/integration.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAsB7B,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAIN,KAAK,SAAS,EACd,MAAM,SAAS,CAAC;AAsBjB,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAYxD;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC9C,4CAA4C;IAC5C,eAAe,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,wDAAwD;IACxD,kBAAkB,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IAChE,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CACpB,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,iBAAiB,GAAG,oBAAoB,CAAC,CAC5E,CAAC;IACF;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC;;;;;;;OAOG;IACH,aAAa,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;CACtC;AAeD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mCAAmC,GAC/C,SAAS,8BAA8B,KACrC,IAm3CF,CAAC"}