@getstrata/core 0.5.12 → 0.5.14

package/README.md

@@ -3,7 +3,7 @@
 Stable **Strata** framework surface for application modules.
 
 **Source:** `src/framework/public-api.ts` (monorepo)  
-**Repository:** [EyK-26/strata](https://github.com/EyK-26/strata) — directory `packages/strata-core`
+**Repository:** [EyK-26/strata](https://github.com/EyK-26/strata), directory `packages/strata-core`
 
 WorkHub is the reference application built on Strata; import the framework from this package in your own modules.
 
@@ -15,21 +15,31 @@ Set `DATABASE_URL` before importing (connection is created lazily on first query
 process.env.DATABASE_URL ??= "postgresql://postgres:postgres@localhost:5432/myapp";
 
 import {
+  AdminResourceRegistry,
   BaseRepository,
   EtaViewEngine,
   FormRequest,
   Policy,
+  formatAdminValue,
   mailer,
   storage,
   withErrorHandling,
 } from "@getstrata/core";
 ```
 
-**Dependency:** `eta` is bundled as a direct dependency of `@getstrata/core` — apps do not need to list it separately. The database driver is your app's choice — WorkHub and getstrata use **Bun's built-in `Bun.sql`** client; bind it with `bindDatabaseConnection()`.
+**Dependency:** `eta` is bundled as a direct dependency of `@getstrata/core`. Apps do not need to list it separately. The database driver is your app's choice. WorkHub and getstrata use **Bun's built-in `Bun.sql`** client; bind it with `bindDatabaseConnection()`.
 
-`orderBy` accepts explicit `{ column, direction }` objects or Laravel-style shorthand `{ published_at: "desc" }`.
+`orderBy` accepts explicit `{ column, direction }` objects or column shorthand such as `{ published_at: "desc" }`.
 
-## Build & verify (monorepo root)
+## Admin and queue helpers
+
+Exports for admin dashboards and queue recovery:
+
+- `AdminResourceRegistry`, `formatAdminValue`: read-only resource browsers
+- `createFailedJobService`, `FailedJobService.delete()`: failed job persistence and cleanup
+- `runQueueJob`, `jobRegistry`: dispatch retried jobs from admin UIs
+
+## Build and verify (monorepo root)
 
 ```bash
 bun run build:framework
@@ -41,9 +51,9 @@ bun run verify:framework   # build + public API tests
 Package name: **`@getstrata/core`** (npm org [`@getstrata`](https://www.npmjs.com/org/getstrata)).
 
 1. Add `NPM_TOKEN` to GitHub repository secrets.
-2. Tag a release: `git tag v0.2.0 && git push origin v0.2.0`
+2. Tag a release: `git tag v0.5.13 && git push origin v0.5.13`
 3. [Release workflow](../../.github/workflows/release.yml) builds and runs `npm publish --access public`.
 
-Previously published as `@eyk-workhub/framework@0.1.0` — deprecated in favor of this package.
+Previously published as `@eyk-workhub/framework@0.1.0`, deprecated in favor of this package.
 
 See [docs/PACKAGING.md](../../docs/PACKAGING.md) for boundaries and future extraction.

package/dist/bootstrap/httpKernel.d.ts

@@ -1,5 +1,4 @@
-import type { Policy } from "../core/auth/policy";
-import { type Middleware, type RouteHandler } from "../core/http/middleware";
+import { type Middleware, type Policy, type RouteHandler } from "@getstrata/core";
 import type { AppDependencies } from "./contracts";
 type MiddlewareGroupName = "api" | "authenticated" | "web";
 declare class HttpKernel {

package/dist/core/admin/formatValue.d.ts

@@ -0,0 +1,3 @@
+import type { AdminColumnType } from "./types.ts";
+declare function formatAdminValue(value: unknown, type?: AdminColumnType): string;
+export { formatAdminValue };

package/dist/core/admin/index.d.ts

@@ -0,0 +1,3 @@
+export { formatAdminValue } from "./formatValue.ts";
+export { AdminResourceRegistry } from "./registry.ts";
+export type { AdminColumn, AdminColumnType, AdminResource, AdminResourceDefinition, AdminResourceHandlers, } from "./types.ts";

package/dist/core/admin/registry.d.ts

@@ -0,0 +1,11 @@
+import type { AdminResource, AdminResourceDefinition } from "./types.ts";
+declare class AdminResourceRegistry {
+    private readonly resources;
+    constructor();
+    register<TEntity extends object>(resource: AdminResource<TEntity>): void;
+    get(name: string): AdminResource<object> | undefined;
+    list(): AdminResourceDefinition[];
+    all(): AdminResource<object>[];
+    clear(): void;
+}
+export { AdminResourceRegistry };

package/dist/core/admin/types.d.ts

@@ -0,0 +1,24 @@
+import type { PaginatedResult } from "../pagination/index.ts";
+type AdminColumnType = "text" | "number" | "boolean" | "datetime" | "code";
+interface AdminColumn {
+    key: string;
+    label: string;
+    type?: AdminColumnType;
+}
+interface AdminResourceHandlers<TEntity extends object> {
+    paginate(options: {
+        page: number;
+        perPage: number;
+    }): Promise<PaginatedResult<TEntity>>;
+    findById?(id: number): Promise<TEntity | null>;
+}
+interface AdminResourceDefinition {
+    name: string;
+    label: string;
+    labelPlural: string;
+    columns: AdminColumn[];
+}
+interface AdminResource<TEntity extends object> extends AdminResourceDefinition {
+    handlers: AdminResourceHandlers<TEntity>;
+}
+export type { AdminColumn, AdminColumnType, AdminResource, AdminResourceDefinition, AdminResourceHandlers, };

package/dist/core/mail/markdownMailable.d.ts

@@ -1,5 +1,4 @@
-import type { MailMessage } from "./mailer.ts";
-import type { Mailer } from "./mailer.ts";
+import type { Mailer, MailMessage } from "./mailer.ts";
 import { type MarkdownMailLayoutOptions } from "./markdownMail.ts";
 interface MarkdownMailableInput {
     to: string;

package/dist/core/notifications/notification.d.ts

@@ -1,6 +1,6 @@
 import type { DatabaseNotificationPayload, MailNotificationMessage, NotificationChannelName } from "./types.ts";
 declare abstract class Notification<TNotifiable = unknown> {
-    abstract via(notifiable: TNotifiable): NotificationChannelName[];
+    via(_notifiable: TNotifiable): NotificationChannelName[];
     toMail(_notifiable: TNotifiable): MailNotificationMessage | null;
     toDatabase(_notifiable: TNotifiable): DatabaseNotificationPayload | null;
 }

package/dist/core/queue/failedJobService.d.ts

@@ -10,6 +10,7 @@ declare class FailedJobService {
     }): Promise<FailedJobRecord>;
     listRecent(limit?: number): Promise<FailedJobRecord[]>;
     retry(id: number): Promise<FailedJobRecord>;
+    delete(id: number): Promise<void>;
     flush(): Promise<number>;
 }
 export default FailedJobService;

package/dist/core/queue/publicQueue.d.ts

@@ -2,6 +2,7 @@ import FailedJobRepository from "./failedJobRepository.ts";
 import FailedJobService from "./failedJobService.ts";
 import type { Job, Queue } from "./index.ts";
 import { jobRegistry } from "./jobRegistry.ts";
+import { runQueueJob } from "./jobRunner.ts";
 import { QueueWorker, RedisQueue } from "./redisQueue.ts";
 import { ResilientQueue } from "./resilientQueue.ts";
 declare function createFailedJobService(): FailedJobService;
@@ -12,4 +13,4 @@ declare function createProductionQueue(driver: "sync" | "async" | "redis", optio
     registerJobs?: () => void;
 }): Queue;
 declare function createQueueWorker(redisUrl: string, failedJobs?: FailedJobService): QueueWorker;
-export { createFailedJobService, createProductionQueue, createQueueWorker, createTrackedJob, FailedJobRepository, FailedJobService, jobRegistry, QueueWorker, RedisQueue, ResilientQueue, };
+export { createFailedJobService, createProductionQueue, createQueueWorker, createTrackedJob, FailedJobRepository, FailedJobService, jobRegistry, QueueWorker, RedisQueue, ResilientQueue, runQueueJob, };

package/dist/core/storage/storage.d.ts

@@ -12,8 +12,9 @@ interface S3StorageConfig {
     endpoint?: string;
 }
 declare class LocalStorageDriver implements StorageDriver {
-    private readonly rootDirectory;
-    constructor(rootDirectory: string);
+    private readonly rootDirectory?;
+    constructor(rootDirectory?: string | undefined);
+    private resolveRootDirectory;
     private resolvePath;
     put(path: string, contents: string | Uint8Array): Promise<string>;
     get(path: string): Promise<Uint8Array | null>;
@@ -37,5 +38,7 @@ declare function resolveS3Config(): S3StorageConfig;
 declare function createS3Client(config?: S3StorageConfig): S3Client;
 declare function createStorageDriver(): StorageDriver;
 declare function storage(): StorageManager;
+/** Test hook: drop the process-wide storage singleton (e.g. after changing STORAGE_PATH). */
+declare function resetDefaultStorage(): void;
 export type { S3StorageConfig, StorageDriver };
-export { createS3Client, createStorageDriver, LocalStorageDriver, resolveS3Config, S3StorageDriver, StorageManager, storage, };
+export { createS3Client, createStorageDriver, LocalStorageDriver, resetDefaultStorage, resolveS3Config, S3StorageDriver, StorageManager, storage, };

package/dist/entries/queue/createAppQueue.js

@@ -2773,6 +2773,12 @@ class FailedJobService {
     await this.repository.deleteById(id);
     return failedJob;
   }
+  async delete(id) {
+    const deleted = await this.repository.deleteById(id);
+    if (!deleted) {
+      throw new Error(`Failed job ${id} not found.`);
+    }
+  }
   async flush() {
     const jobs = await this.repository.findAll();
     let deleted = 0;
@@ -2786,9 +2792,6 @@ class FailedJobService {
 }
 var failedJobService_default = FailedJobService;
 
-// ../../src/core/queue/redisQueue.ts
-var {RedisClient } = globalThis.Bun;
-
 // ../../src/config/queue.ts
 var queueConfig = {
   driver: process.env.QUEUE_DRIVER === "redis" || process.env.QUEUE_DRIVER === "async" || process.env.QUEUE_DRIVER === "sync" ? process.env.QUEUE_DRIVER : DEFAULT_QUEUE_DRIVER,
@@ -2827,6 +2830,7 @@ async function runQueueJob(envelope, failedJobs) {
 }
 
 // ../../src/core/queue/redisQueue.ts
+var {RedisClient } = globalThis.Bun;
 var QUEUE_LIST_KEY = "workhub:queue:default";
 var QUEUE_HIGH_KEY = "workhub:queue:high";
 var QUEUE_LOW_KEY = "workhub:queue:low";

package/dist/entries/queue/failedJobService.js

@@ -24,6 +24,12 @@ class FailedJobService {
     await this.repository.deleteById(id);
     return failedJob;
   }
+  async delete(id) {
+    const deleted = await this.repository.deleteById(id);
+    if (!deleted) {
+      throw new Error(`Failed job ${id} not found.`);
+    }
+  }
   async flush() {
     const jobs = await this.repository.findAll();
     let deleted = 0;

package/dist/entries/queue/publicQueue.js

@@ -2375,6 +2375,12 @@ class FailedJobService {
     await this.repository.deleteById(id);
     return failedJob;
   }
+  async delete(id) {
+    const deleted = await this.repository.deleteById(id);
+    if (!deleted) {
+      throw new Error(`Failed job ${id} not found.`);
+    }
+  }
   async flush() {
     const jobs = await this.repository.findAll();
     let deleted = 0;
@@ -2416,9 +2422,6 @@ class JobRegistry {
 }
 var jobRegistry = new JobRegistry;
 
-// ../../src/core/queue/redisQueue.ts
-var {RedisClient } = globalThis.Bun;
-
 // ../../src/bootstrap/config.ts
 var CORE_QUEUE_TOKEN = "core.queue";
 var CORE_POLICY_GATE_TOKEN = "core.policyGate";
@@ -2464,6 +2467,7 @@ async function runQueueJob(envelope, failedJobs) {
 }
 
 // ../../src/core/queue/redisQueue.ts
+var {RedisClient } = globalThis.Bun;
 var QUEUE_LIST_KEY = "workhub:queue:default";
 var QUEUE_HIGH_KEY = "workhub:queue:high";
 var QUEUE_LOW_KEY = "workhub:queue:low";
@@ -2637,6 +2641,7 @@ function createQueueWorker(redisUrl, failedJobs = createFailedJobService()) {
   return new QueueWorker(redisUrl, failedJobs);
 }
 export {
+  runQueueJob,
   jobRegistry,
   createTrackedJob,
   createQueueWorker,

package/dist/entries/queue/queueMetrics.js

@@ -2783,6 +2783,12 @@ class FailedJobService {
     await this.repository.deleteById(id);
     return failedJob;
   }
+  async delete(id) {
+    const deleted = await this.repository.deleteById(id);
+    if (!deleted) {
+      throw new Error(`Failed job ${id} not found.`);
+    }
+  }
   async flush() {
     const jobs = await this.repository.findAll();
     let deleted = 0;
@@ -2796,9 +2802,6 @@ class FailedJobService {
 }
 var failedJobService_default = FailedJobService;
 
-// ../../src/core/queue/redisQueue.ts
-var {RedisClient } = globalThis.Bun;
-
 // ../../src/core/queue/jobRunner.ts
 async function runQueueJob(envelope, failedJobs) {
   const job = jobRegistry.create(envelope.name);
@@ -2830,6 +2833,7 @@ async function runQueueJob(envelope, failedJobs) {
 }
 
 // ../../src/core/queue/redisQueue.ts
+var {RedisClient } = globalThis.Bun;
 var QUEUE_LIST_KEY = "workhub:queue:default";
 var QUEUE_HIGH_KEY = "workhub:queue:high";
 var QUEUE_LOW_KEY = "workhub:queue:low";

package/dist/entries/storage/storage.js

@@ -9,8 +9,11 @@ class LocalStorageDriver {
   constructor(rootDirectory) {
     this.rootDirectory = rootDirectory;
   }
+  resolveRootDirectory() {
+    return this.rootDirectory ?? process.env.STORAGE_PATH ?? "storage";
+  }
   resolvePath(path) {
-    return join(this.rootDirectory, path.replace(/^\/+/, ""));
+    return join(this.resolveRootDirectory(), path.replace(/^\/+/, ""));
   }
   async put(path, contents) {
     const absolutePath = this.resolvePath(path);
@@ -106,15 +109,22 @@ function createStorageDriver() {
   if (driver === "s3") {
     return new S3StorageDriver(createS3Client());
   }
-  return new LocalStorageDriver(process.env.STORAGE_PATH ?? "storage");
+  return new LocalStorageDriver;
 }
-var defaultStorage = new StorageManager(createStorageDriver());
+var defaultStorage = { current: null };
 function storage() {
-  return defaultStorage;
+  if (!defaultStorage.current) {
+    defaultStorage.current = new StorageManager(createStorageDriver());
+  }
+  return defaultStorage.current;
+}
+function resetDefaultStorage() {
+  defaultStorage.current = null;
 }
 export {
   storage,
   resolveS3Config,
+  resetDefaultStorage,
   createStorageDriver,
   createS3Client,
   StorageManager,

package/dist/framework/public-api.d.ts

@@ -5,9 +5,12 @@
 export { resolveApplicationAuth, resolveApplicationCache, resolveApplicationConfig, resolveApplicationDependencies, resolveApplicationLogger, resolveApplicationPolicyGate, resolveApplicationQueue, setActiveApplicationContext, } from "../bootstrap/applicationRegistry.ts";
 export type { ServiceProvider } from "../bootstrap/contracts.ts";
 export { ConfigStore, resolveService, ServiceContainer, } from "../bootstrap/contracts.ts";
+export type { AdminColumn, AdminColumnType, AdminResource, AdminResourceDefinition, AdminResourceHandlers, } from "../core/admin/index.ts";
+export { AdminResourceRegistry, formatAdminValue, } from "../core/admin/index.ts";
 export type { AbilityChecker } from "../core/auth/abilityChecker.ts";
 export type { AuthUser } from "../core/auth/authContext.ts";
 export { currentAuthUser, runWithAuthUser } from "../core/auth/authContext.ts";
+export { createMembershipMiddleware } from "../core/auth/membershipMiddleware.ts";
 export { Policy, PolicyGate } from "../core/auth/policy.ts";
 export { default as CacheRepository } from "../core/cache/repository.ts";
 export { CACHE_TAGS } from "../core/cache/tags.ts";
@@ -38,16 +41,20 @@ export { EventBus } from "../core/events/eventBus.ts";
 export { auth, cache, config, events, log, mail, policyGate, queue, storage, } from "../core/facades/index.ts";
 export { createBodySizeLimitMiddleware } from "../core/http/bodySizeLimitMiddleware.ts";
 export { readBunRequestCookie, readRequestCookie } from "../core/http/cookies.ts";
+export { createCorsMiddleware } from "../core/http/corsMiddleware.ts";
 export { createCsrfMiddleware } from "../core/http/csrfMiddleware.ts";
 export { createCsrfProtection } from "../core/http/csrfProtection.ts";
 export { createCsrfTokenCookie, readSubmittedCsrfToken, readSubmittedCsrfTokenFromBody, resolveCsrfToken, resolveCsrfTokenForRequest, verifyCsrfToken, } from "../core/http/csrfToken.ts";
 export { assertIfMatch, etagFromResource, isEtagEnabled, } from "../core/http/etag.ts";
+export { createFlashMiddleware } from "../core/http/flashMiddleware.ts";
 export { FormRequest } from "../core/http/formRequest.ts";
-export { applyMiddlewareToRoutes, composeMiddleware, createAuthMiddleware, createAuthorizeMiddleware, createdResponse, createRequireAuthMiddleware, jsonResponse, noContentResponse, paginatedResponse, parsePaginationQuery, securedBindRouteModel, securedBindRouteModelByKey, withErrorHandling, withMiddleware, } from "../core/http/index.ts";
+export { applyMiddlewareToRoutes, composeMiddleware, createAuthMiddleware, createAuthorizeMiddleware, createdResponse, createRequireAuthMiddleware, jsonResponse, noContentResponse, paginatedResponse, parsePaginationQuery, requestIdMiddleware, securedBindRouteModel, securedBindRouteModelByKey, withErrorHandling, withMiddleware, } from "../core/http/index.ts";
 export { createLoginThrottleMiddleware } from "../core/http/loginThrottleMiddleware.ts";
 export { createMemoryThrottleMiddleware } from "../core/http/memoryThrottleMiddleware.ts";
 export { createMetricsMiddleware, normalizeMetricPath } from "../core/http/metricsMiddleware.ts";
 export type { Middleware, RouteHandler } from "../core/http/middleware.ts";
+export { createRequireAbilityMiddleware } from "../core/http/requireAbilityMiddleware.ts";
+export { createRequireGlobalAdminMiddleware } from "../core/http/requireGlobalAdminMiddleware.ts";
 export { createRequireWebAuthMiddleware } from "../core/http/requireWebAuthMiddleware.ts";
 export { serializeDate, toPaginatedResourceCollection, toResourceCollection, } from "../core/http/resources.ts";
 export type { RouteRequest } from "../core/http/route.ts";
@@ -55,24 +62,28 @@ export { createSecurityHeadersMiddleware } from "../core/http/securityHeadersMid
 export { createThrottleMiddleware } from "../core/http/throttleMiddleware.ts";
 export { WebFormRequest } from "../core/http/webFormRequest.ts";
 export { installGracefulShutdownSignals, registerShutdownHandler, runGracefulShutdown, } from "../core/lifecycle/gracefulShutdown.ts";
+export { createRequestLoggingMiddleware } from "../core/logging/requestLoggingMiddleware.ts";
 export type { MailDriver, MailMessage } from "../core/mail/mailer.ts";
 export { buildSmtpPayload, LogMailDriver, Mailer, mailer, } from "../core/mail/mailer.ts";
 export type { MarkdownMailLayoutOptions, RenderedMarkdownMail } from "../core/mail/markdownMail.ts";
 export { markdownToHtml, renderMarkdownMail, stripMarkdown, wrapMarkdownMailLayout, } from "../core/mail/markdownMail.ts";
 export type { MarkdownMailableInput } from "../core/mail/markdownMailable.ts";
 export { buildMarkdownMailMessage, sendMarkdownMail } from "../core/mail/markdownMailable.ts";
-export type { DatabaseNotificationPayload, DatabaseNotificationStore, MailNotificationMessage, Notifiable, NotificationChannelName, } from "../core/notifications/index.ts";
-export { createNotificationDispatcher, Notification, NotificationDispatcher, } from "../core/notifications/index.ts";
 export type { MetricLabels } from "../core/metrics/prometheus.ts";
 export { PrometheusRegistry, prometheusRegistry } from "../core/metrics/prometheus.ts";
+export type { DatabaseNotificationPayload, DatabaseNotificationStore, MailNotificationMessage, Notifiable, NotificationChannelName, } from "../core/notifications/index.ts";
+export { createNotificationDispatcher, Notification, NotificationDispatcher, } from "../core/notifications/index.ts";
 export type { CursorPaginatedResult, PaginatedResult, PaginationMeta, } from "../core/pagination/index.ts";
 export type { Queue, QueuePriority } from "../core/queue/index.ts";
 export { AsyncQueue, createQueue, Job, SyncQueue } from "../core/queue/index.ts";
-export { createFailedJobService, createProductionQueue, createQueueWorker, createTrackedJob, FailedJobRepository, FailedJobService, jobRegistry, QueueWorker, RedisQueue, ResilientQueue, } from "../core/queue/publicQueue.ts";
+export { createFailedJobService, createProductionQueue, createQueueWorker, createTrackedJob, FailedJobRepository, FailedJobService, jobRegistry, QueueWorker, RedisQueue, ResilientQueue, runQueueJob, } from "../core/queue/publicQueue.ts";
 export type { ScheduledTask } from "../core/scheduler/schedule.ts";
 export { appSchedule, runDueScheduledTasks, Schedule } from "../core/scheduler/schedule.ts";
+export { isPublicReadsEnabled } from "../core/security/publicReads.ts";
 export type { StorageDriver } from "../core/storage/storage.ts";
-export { LocalStorageDriver, StorageManager } from "../core/storage/storage.ts";
+export { LocalStorageDriver, resetDefaultStorage, StorageManager, } from "../core/storage/storage.ts";
+export { createTenantMiddleware } from "../core/tenant/tenantMiddleware.ts";
+export { createTracingMiddleware } from "../core/tracing/tracingMiddleware.ts";
 export type { ValidationRule, ValidationSchema } from "../core/validation/rules.ts";
 export { emailRule, maxLength, minLength, required, stringRule, validateObject, } from "../core/validation/rules.ts";
 export { DEFAULT_VIEWS_DIRECTORY, EtaViewEngine, htmlResponse, isHtmxRequest, resolveWebLayoutData, } from "../core/view/index.ts";