hazo_admin 0.5.0 → 0.6.1

package/CHANGE_LOG.md

@@ -1,5 +1,19 @@
 # hazo_admin Changelog
 
+## [0.6.0] - 2026-06-19
+
+### Added
+- **`createIssueStoreFromConnect(adapter)`** — PostgREST-native `IssueStore` implementation that uses `createCrudService` + `adapter.claimRows` instead of raw SQL. Enables the issue store to operate over PostgREST without a direct DB connection.
+  - Capability sniff: if the adapter exposes a `.raw()` method (direct-DB adapter), delegates to the existing `createIssueStore` transparently.
+  - `createOrBumpIssue`: atomic CAS bump via `claimRows`; falls back to `crud.insert` on no-match.
+  - `listIssues`: uses `crud.query()` builder with `.where()` / `.order()` / `.limit()` / `.offset()`.
+  - `getIssue`: `crud.findById`.
+  - `transitionStatus` / `setAssignee` / `resolveIssue`: `crud.updateById` with the same legal-transition guard as `createIssueStore`.
+  - `archiveClosedOlderThan`: batch `claimRows` with `status: closed` + `resolved_at: { lte: cutoff }`.
+  - Lazily imports `hazo_connect/server` (avoids loading the full hazo_connect stack for raw adapters in test environments).
+  - Exported from `hazo_admin`, `hazo_admin/issues`.
+  - 20 new Jest tests in `src/issues/__tests__/store_connect.test.ts`.
+
 ## [0.5.0] - 2026-06-19
 
 ### Added

package/README.md

@@ -234,6 +234,23 @@ import { createJobQueue } from 'hazo_jobs';
 registerIssueArchiveJob(jobQueue, { getHazoConnect, archiveAfterMonths: 3 });
 ```
 
+### `createIssueStoreFromConnect(adapter)` — PostgREST-native store (v0.6.0)
+
+Use this factory when the consuming app connects via a PostgREST adapter (no direct SQL access). It builds the same `IssueStore` interface using `createCrudService` + `adapter.claimRows` so no raw SQL is issued.
+
+```ts
+import { createIssueStoreFromConnect } from 'hazo_admin';
+
+// In your route handler or service bootstrap:
+const store = await createIssueStoreFromConnect(adapter);
+// store implements the full IssueStore interface
+const { issue, isNew } = await store.createOrBumpIssue({ ... });
+```
+
+**Capability sniff:** if the adapter exposes a `.raw()` method (i.e. it is a direct-DB adapter), `createIssueStoreFromConnect` transparently delegates to `createIssueStore` instead. This lets callers use a single factory regardless of adapter type.
+
+**Async:** returns a `Promise<IssueStore>` (lazy `hazo_connect/server` import on the CRUD path).
+
 ---
 
 ## v0.2.0 Breaking changes
@@ -258,7 +275,7 @@ Consumers of this endpoint (e.g. `EnvMigrationPanel`) must read the `role` field
 
 | Import path | Contents | Server-safe |
 |---|---|---|
-| `hazo_admin` | `adminGate`, `withAdminGate`, `HAZO_ADMIN_PERMISSIONS`, `AdminGateResult`, `createIssueStore`, `registerIssueType`, `getIssueType`, `listIssueTypes`, `loadIssueRoutingConfig`, `registerIssueArchiveJob`, `ADMIN_ISSUE_ARCHIVE_JOB_TYPE` | Server only |
+| `hazo_admin` | `adminGate`, `withAdminGate`, `HAZO_ADMIN_PERMISSIONS`, `AdminGateResult`, `createIssueStore`, `createIssueStoreFromConnect`, `registerIssueType`, `getIssueType`, `listIssueTypes`, `loadIssueRoutingConfig`, `registerIssueArchiveJob`, `ADMIN_ISSUE_ARCHIVE_JOB_TYPE` | Server only |
 | `hazo_admin/client` | `HAZO_ADMIN_PERMISSIONS`, `registerIssueCardRenderer`, `getIssueCardRenderer`, `listIssueCardRenderers`, `DefaultIssueCard`, types | Yes |
 | `hazo_admin/api` | `createAdminPresetRoutes` | Server only |
 | `hazo_admin/jobs` | `ENV_MIGRATE_JOB_TYPE`, `envMigrateJobHandler` | Server only (no React) |

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { adminGate, withAdminGate } from './lib/admin_gate.server.js';
 export type { AdminGateResult } from './lib/admin_gate.server.js';
 export { HAZO_ADMIN_PERMISSIONS } from './index.client.js';
-export { createIssueStore, registerIssueType, getIssueType, listIssueTypes, loadIssueRoutingConfig, getRecipientStrategy, issueArchiveJobHandler, registerIssueArchiveJob, ADMIN_ISSUE_ARCHIVE_JOB_TYPE, } from './issues/index.js';
+export { createIssueStore, createIssueStoreFromConnect, registerIssueType, getIssueType, listIssueTypes, loadIssueRoutingConfig, getRecipientStrategy, issueArchiveJobHandler, registerIssueArchiveJob, ADMIN_ISSUE_ARCHIVE_JOB_TYPE, } from './issues/index.js';
 export type { IssueRecord, IssueStore, CreateIssueInput, IssueTypeDef, IssueActionDef, IssueActionCtx, IssueActionResult, RecipientResult, NotifyPayload, IssueRoutingConfig, RecipientStrategy, } from './issues/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
 export { adminGate, withAdminGate } from './lib/admin_gate.server.js';
 export { HAZO_ADMIN_PERMISSIONS } from './index.client.js';
-export { createIssueStore, registerIssueType, getIssueType, listIssueTypes, loadIssueRoutingConfig, getRecipientStrategy, issueArchiveJobHandler, registerIssueArchiveJob, ADMIN_ISSUE_ARCHIVE_JOB_TYPE, } from './issues/index.js';
+export { createIssueStore, createIssueStoreFromConnect, registerIssueType, getIssueType, listIssueTypes, loadIssueRoutingConfig, getRecipientStrategy, issueArchiveJobHandler, registerIssueArchiveJob, ADMIN_ISSUE_ARCHIVE_JOB_TYPE, } from './issues/index.js';

package/dist/issues/index.d.ts

@@ -1,4 +1,4 @@
-export { createIssueStore } from './store.js';
+export { createIssueStore, createIssueStoreFromConnect } from './store.js';
 export type { IssueRecord, IssueStore, CreateIssueInput } from './store.js';
 export { registerIssueType, getIssueType, listIssueTypes } from './registry.js';
 export type { IssueTypeDef, IssueActionDef, IssueActionCtx, IssueActionResult, RecipientResult, NotifyPayload, } from './registry.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/issues/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChF,YAAY,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/issues/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC3E,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChF,YAAY,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC"}

package/dist/issues/index.js

@@ -1,4 +1,4 @@
-export { createIssueStore } from './store.js';
+export { createIssueStore, createIssueStoreFromConnect } from './store.js';
 export { registerIssueType, getIssueType, listIssueTypes } from './registry.js';
 export { loadIssueRoutingConfig, getRecipientStrategy } from './routing.js';
 export { issueArchiveJobHandler, registerIssueArchiveJob, ADMIN_ISSUE_ARCHIVE_JOB_TYPE, } from './archive_handler.js';

package/dist/issues/store.d.ts

@@ -57,5 +57,16 @@ export interface IssueStore {
     }): Promise<IssueRecord>;
     archiveClosedOlderThan(cutoffDate: Date): Promise<number>;
 }
+export declare function toIssueRecord(raw: Record<string, unknown>): IssueRecord;
 export declare function createIssueStore(adapter: any): IssueStore;
+/**
+ * PostgREST-native implementation of IssueStore.
+ * Uses createCrudService + adapter.claimRows so no raw SQL is issued.
+ * Falls back to createIssueStore when the adapter exposes a raw() method
+ * (i.e. it is a direct-DB adapter that already handles SQL).
+ *
+ * Returns a Promise because it lazily imports hazo_connect/server on the
+ * CRUD path (avoiding loading the full hazo_connect stack for raw adapters).
+ */
+export declare function createIssueStoreFromConnect(adapter: any): Promise<IssueStore>;
 //# sourceMappingURL=store.d.ts.map

package/dist/issues/store.d.ts.map

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

package/dist/issues/store.js

@@ -2,7 +2,7 @@ import 'server-only';
 import { createLogger } from 'hazo_core';
 const log = createLogger('hazo_admin:issues');
 const TABLE = 'hazo_admin_issues';
-function toIssueRecord(raw) {
+export function toIssueRecord(raw) {
     return {
         id: raw.id,
         scope_id: raw.scope_id,
@@ -225,3 +225,177 @@ export function createIssueStore(adapter) {
         archiveClosedOlderThan,
     };
 }
+/**
+ * PostgREST-native implementation of IssueStore.
+ * Uses createCrudService + adapter.claimRows so no raw SQL is issued.
+ * Falls back to createIssueStore when the adapter exposes a raw() method
+ * (i.e. it is a direct-DB adapter that already handles SQL).
+ *
+ * Returns a Promise because it lazily imports hazo_connect/server on the
+ * CRUD path (avoiding loading the full hazo_connect stack for raw adapters).
+ */
+export async function createIssueStoreFromConnect(adapter) {
+    // Capability sniff: direct-DB adapters have a raw() method — use the raw store.
+    if (typeof adapter.raw === 'function') {
+        return createIssueStore(adapter);
+    }
+    // Lazy import to avoid pulling hazo_connect into server-only environments
+    // that don't have it installed (e.g., direct-SQL test adapters).
+    const { createCrudService } = await import('hazo_connect/server');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const crud = createCrudService(adapter, TABLE);
+    function now() {
+        return new Date().toISOString();
+    }
+    async function createOrBumpIssue(input) {
+        log.debug('createIssueStoreFromConnect:createOrBumpIssue', { dedupe_key: input.dedupe_key });
+        // Atomically bump an existing open issue via claimRows.
+        const bumped = await adapter.claimRows({
+            table: TABLE,
+            where: {
+                dedupe_key: input.dedupe_key,
+                status: { in: ['new', 'wip'] },
+            },
+            set: {
+                occurrence_count: { increment: 1 },
+                last_seen_at: { $now: true },
+                updated_at: { $now: true },
+            },
+            returning: ['*'],
+        });
+        if (bumped && bumped.length > 0) {
+            return { issue: toIssueRecord(bumped[0]), isNew: false };
+        }
+        // No open issue found — insert a new one.
+        const ts = now();
+        const inserted = await crud.insert({
+            scope_id: input.scope_id,
+            type: input.type,
+            status: 'new',
+            subject_user_id: input.subject_user_id,
+            assigned_to: null,
+            recipient_scope_id: input.recipient_scope_id ?? null,
+            title: input.title,
+            summary: input.summary,
+            payload: input.payload,
+            dedupe_key: input.dedupe_key,
+            occurrence_count: 1,
+            first_seen_at: ts,
+            last_seen_at: ts,
+            resolution: null,
+            resolution_role_id: null,
+            resolution_reason: null,
+            resolved_by: null,
+            resolved_at: null,
+            created_at: ts,
+            updated_at: ts,
+        });
+        const row = Array.isArray(inserted) ? inserted[0] : inserted;
+        if (!row)
+            throw new Error('hazo_admin:issues — INSERT returned no row');
+        return { issue: toIssueRecord(row), isNew: true };
+    }
+    async function listIssues(opts) {
+        const { adminScopeIds, isGlobalAdmin = false, status, assignedTo, type, limit = 50, offset = 0, } = opts;
+        if (!isGlobalAdmin && (!adminScopeIds || adminScopeIds.length === 0)) {
+            return [];
+        }
+        const qb = crud.query();
+        if (!isGlobalAdmin && adminScopeIds && adminScopeIds.length > 0) {
+            qb.where('scope_id', 'in', adminScopeIds);
+        }
+        if (status !== undefined) {
+            const statuses = Array.isArray(status) ? status : [status];
+            qb.where('status', 'in', statuses);
+        }
+        if (assignedTo !== undefined) {
+            if (assignedTo === null) {
+                qb.where('assigned_to', 'is', null);
+            }
+            else {
+                qb.where('assigned_to', 'eq', assignedTo);
+            }
+        }
+        if (type !== undefined) {
+            qb.where('type', 'eq', type);
+        }
+        qb.order('last_seen_at', 'desc').limit(limit).offset(offset);
+        const rows = await qb.execute('GET');
+        return (Array.isArray(rows) ? rows : []).map((r) => toIssueRecord(r));
+    }
+    async function getIssue(id) {
+        const row = await crud.findById(id);
+        if (!row)
+            return null;
+        return toIssueRecord(row);
+    }
+    async function transitionStatus(id, status, actorUserId) {
+        const issue = await getIssue(id);
+        if (!issue)
+            throw new Error(`hazo_admin:issues — issue ${id} not found`);
+        assertTransition(issue.status, status);
+        const ts = now();
+        const patch = { status, updated_at: ts };
+        if (status === 'wip' && issue.assigned_to === null) {
+            patch.assigned_to = actorUserId;
+        }
+        const updated = await crud.updateById(id, patch);
+        const row = Array.isArray(updated) ? updated[0] : updated;
+        if (!row)
+            throw new Error(`hazo_admin:issues — UPDATE returned no row for ${id}`);
+        return toIssueRecord(row);
+    }
+    async function setAssignee(id, userId) {
+        const ts = now();
+        const updated = await crud.updateById(id, { assigned_to: userId, updated_at: ts });
+        const row = Array.isArray(updated) ? updated[0] : updated;
+        if (!row)
+            throw new Error(`hazo_admin:issues — issue ${id} not found`);
+        return toIssueRecord(row);
+    }
+    async function resolveIssue(id, opts) {
+        const ts = now();
+        const updated = await crud.updateById(id, {
+            status: 'closed',
+            resolution: opts.resolution,
+            resolution_role_id: opts.role_id ?? null,
+            resolution_reason: opts.reason ?? null,
+            resolved_by: opts.resolved_by,
+            resolved_at: ts,
+            updated_at: ts,
+        });
+        const row = Array.isArray(updated) ? updated[0] : updated;
+        if (!row)
+            throw new Error(`hazo_admin:issues — issue ${id} not found`);
+        return toIssueRecord(row);
+    }
+    async function archiveClosedOlderThan(cutoffDate) {
+        const cutoff = cutoffDate.toISOString();
+        log.debug('createIssueStoreFromConnect:archiveClosedOlderThan', { cutoff });
+        const archived = await adapter.claimRows({
+            table: TABLE,
+            where: {
+                status: 'closed',
+                resolved_at: { lte: cutoff },
+            },
+            set: {
+                status: 'archived',
+                updated_at: { $now: true },
+            },
+            returning: ['id'],
+            limit: 1000,
+        });
+        const count = (archived ?? []).length;
+        log.debug('createIssueStoreFromConnect:archiveClosedOlderThan — archived', { count });
+        return count;
+    }
+    return {
+        createOrBumpIssue,
+        listIssues,
+        getIssue,
+        transitionStatus,
+        setAssignee,
+        resolveIssue,
+        archiveClosedOlderThan,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_admin",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Standard site-admin package — auth-gated admin shell + panel kit + drop-in /admin preset",
   "type": "module",
   "module": "./dist/index.js",
@@ -52,15 +52,15 @@
   },
   "peerDependencies": {
     "hazo_core": "^1.2.0",
-    "hazo_ui": "^4.0.0",
+    "hazo_ui": "^4.4.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "next": "^14.0.0 || ^16.0.0",
-    "hazo_auth": "^10.2.0 || ^10.3.0",
+    "hazo_auth": "^10.4.1",
     "hazo_logs": "^2.0.2",
     "hazo_debug": "^3.1.1",
     "hazo_connect": "^3.7.0",
-    "hazo_config": "^2.1.7",
+    "hazo_config": "^2.3.0",
     "hazo_api": "^2.3.1",
     "hazo_files": "^3.0.0",
     "hazo_jobs": "^0.12.0",
@@ -70,7 +70,7 @@
     "hazo_secure": "^1.2.0",
     "hazo_blog": "^0.2.0",
     "hazo_testing": "^0.3.1",
-    "hazo_notify": "^6.1.0",
+    "hazo_notify": "^6.1.4",
     "lucide-react": "^0.553.0"
   },
   "peerDependenciesMeta": {
@@ -131,8 +131,8 @@
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "hazo_core": "^1.2.0",
-    "hazo_ui": "^4.3.1",
-    "hazo_auth": "^10.3.0",
+    "hazo_ui": "^4.4.0",
+    "hazo_auth": "^10.4.1",
     "hazo_testing": "^0.3.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",