@krantho/api 0.0.0-stage → 1.0.1

package/dist/handlers/version-retention.js

@@ -0,0 +1,40 @@
+import { requireRole } from '../permissions.js';
+import { validateRequestBody } from '../validators.js';
+/** GET /api/versions/stats — version count statistics */
+export const versionStats = async (_req, ctx) => {
+    if (!ctx.retentionAdapter) {
+        return { status: 501, body: { error: 'Version retention not available' } };
+    }
+    const stats = await ctx.retentionAdapter.countVersions();
+    return { status: 200, body: stats };
+};
+/** POST /api/versions/purge — purge old versions */
+export const versionPurge = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.retentionAdapter) {
+        return { status: 501, body: { error: 'Version retention not available' } };
+    }
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const payload = bodyCheck.body;
+    const keepVersions = typeof payload['keepVersions'] === 'number'
+        ? payload['keepVersions']
+        : ctx.config.content.versions.keep;
+    if (keepVersions < 1) {
+        return { status: 400, body: { error: 'keepVersions must be at least 1' } };
+    }
+    const results = await ctx.retentionAdapter.purgeVersions(keepVersions);
+    const totalPurged = results.reduce((sum, r) => sum + r.purged, 0);
+    return {
+        status: 200,
+        body: {
+            keepVersions,
+            totalPurged,
+            items: results,
+        },
+    };
+};
+//# sourceMappingURL=version-retention.js.map

package/dist/handlers/version-retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-retention.js","sourceRoot":"","sources":["../../src/handlers/version-retention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAe,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1D,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,EAAE,CAAA;IAC5E,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAA;IACxD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AACrC,CAAC,CAAA;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACzD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC7C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,EAAE,CAAA;IAC5E,CAAC;IAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IAEjD,MAAM,OAAO,GAAG,SAAS,CAAC,IAA+B,CAAA;IACzD,MAAM,YAAY,GAChB,OAAO,OAAO,CAAC,cAAc,CAAC,KAAK,QAAQ;QACzC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QACzB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAA;IAEtC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,EAAE,CAAA;IAC5E,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IACtE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAEjE,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE;YACJ,YAAY;YACZ,WAAW;YACX,KAAK,EAAE,OAAO;SACf;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/handlers/webhook-deliveries.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/webhooks/deliveries — list webhook delivery log */
+export declare const webhookDeliveries: ApiHandler;
+//# sourceMappingURL=webhook-deliveries.d.ts.map

package/dist/handlers/webhook-deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-deliveries.d.ts","sourceRoot":"","sources":["../../src/handlers/webhook-deliveries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,EAAE,UAuB/B,CAAA"}

package/dist/handlers/webhook-deliveries.js

@@ -0,0 +1,24 @@
+import { requireRole } from '../permissions.js';
+/** GET /api/webhooks/deliveries — list webhook delivery log */
+export const webhookDeliveries = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.webhookDeliveryAdapter) {
+        return { status: 200, body: { deliveries: [], total: 0 } };
+    }
+    const limit = req.query['limit'] ? Number.parseInt(req.query['limit'], 10) : 50;
+    const offset = req.query['offset'] ? Number.parseInt(req.query['offset'], 10) : 0;
+    const validStatuses = ['pending', 'delivered', 'failed'];
+    const rawStatus = req.query['status'];
+    const status = validStatuses.includes(rawStatus)
+        ? rawStatus
+        : undefined;
+    const result = await ctx.webhookDeliveryAdapter.listDeliveries({
+        limit,
+        offset,
+        status,
+    });
+    return { status: 200, body: result };
+};
+//# sourceMappingURL=webhook-deliveries.js.map

package/dist/handlers/webhook-deliveries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-deliveries.js","sourceRoot":"","sources":["../../src/handlers/webhook-deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC7C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAA;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/E,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACjF,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAA;IACjE,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,SAA2C,CAAC;QAChF,CAAC,CAAE,SAAgD;QACnD,CAAC,CAAC,SAAS,CAAA;IAEb,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,sBAAsB,CAAC,cAAc,CAAC;QAC7D,KAAK;QACL,MAAM;QACN,MAAM;KACP,CAAC,CAAA;IAEF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACtC,CAAC,CAAA"}

package/dist/handlers/webhook-retry.d.ts

@@ -0,0 +1,11 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * POST /api/webhooks/deliveries/:id/retry — put a failed delivery back in the
+ * queue with one attempt left, held back from the periodic sweep, and send it
+ * again at once, signed afresh, to
+ * the configured webhook with its URL. Answers 202 with the delivery as
+ * re-queued (pending); the attempt's outcome is recorded on the delivery:
+ * delivered, or failed again.
+ */
+export declare const webhookRetry: ApiHandler;
+//# sourceMappingURL=webhook-retry.d.ts.map

package/dist/handlers/webhook-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-retry.d.ts","sourceRoot":"","sources":["../../src/handlers/webhook-retry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAc,UAAU,EAA8B,MAAM,aAAa,CAAA;AAsDrF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,UAgB1B,CAAA"}

package/dist/handlers/webhook-retry.js

@@ -0,0 +1,69 @@
+import { MAX_WEBHOOK_ATTEMPTS, } from '@krantho/persistence';
+import { requireRole } from '../permissions.js';
+import { requireParam } from '../validators.js';
+import { redeliverWebhook } from '../webhooks.js';
+function refuse(status, error) {
+    return { status, body: { error } };
+}
+/** The delivery id from the path: a positive whole number */
+function deliveryId(params) {
+    const result = requireParam(params, 'id');
+    if (!result.isValid)
+        return result.response;
+    const id = Number(result.value);
+    return Number.isInteger(id) && id > 0 ? id : refuse(400, 'Invalid delivery id');
+}
+/**
+ * How long a retried delivery stays out of the periodic retry sweep: the
+ * immediate send records its outcome long before, so the sweep sends it
+ * only when that send never recorded one (the process stopped mid-send),
+ * and never a second time alongside it
+ */
+const RETRY_HOLD_MS = 60 * 60 * 1000;
+function isFailed(delivery) {
+    return delivery.deliveredAt === null && delivery.attempts >= MAX_WEBHOOK_ATTEMPTS;
+}
+/** What a retry sends where, or why the delivery cannot be retried */
+function retryOf(delivery, ctx) {
+    if (!delivery)
+        return refuse(404, 'No webhook delivery has this id');
+    if (!isFailed(delivery))
+        return refuse(409, 'Only a failed delivery can be retried');
+    const hook = ctx.webhooks?.find((candidate) => candidate.url === delivery.url);
+    return hook ? { delivery, hook } : refuse(409, 'No configured webhook has this URL any more');
+}
+/** Send it again in the background; the delivery's row records how it went */
+function sendAgain(ctx, deliveries, { delivery, hook }) {
+    const attempt = redeliverWebhook(hook, delivery, deliveries).catch((err) => {
+        console.warn(`[webhook] Retry of delivery ${delivery.id} could not be recorded:`, err);
+    });
+    ctx.waitUntil?.(attempt);
+}
+/**
+ * POST /api/webhooks/deliveries/:id/retry — put a failed delivery back in the
+ * queue with one attempt left, held back from the periodic sweep, and send it
+ * again at once, signed afresh, to
+ * the configured webhook with its URL. Answers 202 with the delivery as
+ * re-queued (pending); the attempt's outcome is recorded on the delivery:
+ * delivered, or failed again.
+ */
+export const webhookRetry = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    const id = deliveryId(req.params);
+    if (typeof id !== 'number')
+        return id;
+    const deliveries = ctx.webhookDeliveryAdapter;
+    if (!deliveries)
+        return refuse(404, 'Webhook deliveries are not logged');
+    const retry = retryOf(await deliveries.getDelivery(id), ctx);
+    if ('status' in retry)
+        return retry;
+    const delivery = await deliveries.requeueDelivery(id, new Date(Date.now() + RETRY_HOLD_MS));
+    if (!delivery)
+        return refuse(409, 'Only a failed delivery can be retried');
+    sendAgain(ctx, deliveries, retry);
+    return { status: 202, body: { delivery } };
+};
+//# sourceMappingURL=webhook-retry.js.map

package/dist/handlers/webhook-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-retry.js","sourceRoot":"","sources":["../../src/handlers/webhook-retry.ts"],"names":[],"mappings":"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"}

package/dist/head.d.ts

@@ -0,0 +1,9 @@
+import type { ApiRequest, ApiResponse } from './types.js';
+/**
+ * Answer a HEAD request the way GET answers it, without the body (RFC 9110,
+ * section 9.3.2): the GET route runs, and its status, headers and cookies are
+ * kept. The content type the body would have been served with is kept too,
+ * since the response no longer carries the body that decides it.
+ */
+export declare function answerHead(req: ApiRequest, handle: (req: ApiRequest) => Promise<ApiResponse>): Promise<ApiResponse>;
+//# sourceMappingURL=head.d.ts.map

package/dist/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAWzD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,GAChD,OAAO,CAAC,WAAW,CAAC,CAQtB"}

package/dist/head.js

@@ -0,0 +1,28 @@
+/** The content type a response body is served with when the handler names none */
+function defaultContentType(body) {
+    if (body === null || body === undefined)
+        return undefined;
+    if (body instanceof ReadableStream || body instanceof Uint8Array)
+        return 'application/octet-stream';
+    if (typeof body === 'string')
+        return 'text/plain';
+    return 'application/json';
+}
+/**
+ * Answer a HEAD request the way GET answers it, without the body (RFC 9110,
+ * section 9.3.2): the GET route runs, and its status, headers and cookies are
+ * kept. The content type the body would have been served with is kept too,
+ * since the response no longer carries the body that decides it.
+ */
+export async function answerHead(req, handle) {
+    const response = await handle({ ...req, method: 'GET' });
+    const headers = { ...response.headers };
+    const named = Object.keys(headers).some((key) => key.toLowerCase() === 'content-type');
+    const contentType = named ? undefined : defaultContentType(response.body);
+    if (contentType)
+        headers['content-type'] = contentType;
+    if (response.body instanceof ReadableStream)
+        await response.body.cancel();
+    return { ...response, headers, body: null };
+}
+//# sourceMappingURL=head.js.map

package/dist/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,SAAS,kBAAkB,CAAC,IAAa;IACvC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzD,IAAI,IAAI,YAAY,cAAc,IAAI,IAAI,YAAY,UAAU;QAC9D,OAAO,0BAA0B,CAAA;IACnC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAA;IACjD,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAe,EACf,MAAiD;IAEjD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IACxD,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAA;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,CAAA;IACtF,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACzE,IAAI,WAAW;QAAE,OAAO,CAAC,cAAc,CAAC,GAAG,WAAW,CAAA;IACtD,IAAI,QAAQ,CAAC,IAAI,YAAY,cAAc;QAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IACzE,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAC7C,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,34 @@
+/** Data passed to before-save hooks */
+export interface BeforeSaveContext {
+    collection: string;
+    slug: string;
+    fields: Record<string, unknown>;
+    metadata: Record<string, Record<string, unknown>>;
+    body: string;
+    isNew: boolean;
+}
+/** Data passed to after-mutation hooks */
+export interface AfterMutationContext {
+    collection: string;
+    slug: string;
+}
+/** Lifecycle hooks for content operations */
+export interface ContentHooks {
+    /** Fires before content is created or updated. Can modify fields, metadata and body. Throw to abort. */
+    beforeSave?: ((ctx: BeforeSaveContext) => Promise<BeforeSaveContext | void>) | undefined;
+    /** Fires after content is created */
+    afterCreate?: ((ctx: AfterMutationContext) => Promise<void>) | undefined;
+    /** Fires after content is updated */
+    afterUpdate?: ((ctx: AfterMutationContext) => Promise<void>) | undefined;
+    /** Fires after content status changes to published */
+    afterPublish?: ((ctx: AfterMutationContext) => Promise<void>) | undefined;
+    /** Fires before content is deleted. Throw to abort. */
+    beforeDelete?: ((ctx: AfterMutationContext) => Promise<void>) | undefined;
+    /** Fires after content is deleted */
+    afterDelete?: ((ctx: AfterMutationContext) => Promise<void>) | undefined;
+}
+/** Execute a before-save hook, returning possibly modified context */
+export declare function runBeforeSave(hooks: ContentHooks | undefined, ctx: BeforeSaveContext): Promise<BeforeSaveContext>;
+/** Execute an after-mutation hook (fire and forget on error) */
+export declare function runAfterHook(fn: ((ctx: AfterMutationContext) => Promise<void>) | undefined, ctx: AfterMutationContext): Promise<void>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,wGAAwG;IACxG,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IACxF,qCAAqC;IACrC,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IACxE,qCAAqC;IACrC,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IACxE,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IACzE,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IACzE,qCAAqC;IACrC,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;CACzE;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAI5B;AAED,gEAAgE;AAChE,wBAAsB,YAAY,CAChC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EAC9D,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/hooks.js

@@ -0,0 +1,19 @@
+/** Execute a before-save hook, returning possibly modified context */
+export async function runBeforeSave(hooks, ctx) {
+    if (!hooks?.beforeSave)
+        return ctx;
+    const result = await hooks.beforeSave(ctx);
+    return result ?? ctx;
+}
+/** Execute an after-mutation hook (fire and forget on error) */
+export async function runAfterHook(fn, ctx) {
+    if (!fn)
+        return;
+    try {
+        await fn(ctx);
+    }
+    catch (err) {
+        console.warn(`[hooks] Hook failed for ${ctx.collection}/${ctx.slug}:`, err);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAgCA,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA+B,EAC/B,GAAsB;IAEtB,IAAI,CAAC,KAAK,EAAE,UAAU;QAAE,OAAO,GAAG,CAAA;IAClC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IAC1C,OAAO,MAAM,IAAI,GAAG,CAAA;AACtB,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAA8D,EAC9D,GAAyB;IAEzB,IAAI,CAAC,EAAE;QAAE,OAAM;IACf,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;IACf,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAA;IAC7E,CAAC;AACH,CAAC"}

package/dist/image-cache.d.ts

@@ -0,0 +1,47 @@
+import type { MediaSection } from '@krantho/config';
+/** Cache limits, as the configuration tree declares them */
+export type ImageCacheSettings = MediaSection['image']['cache'];
+/** Cached image variant */
+export interface CachedVariant {
+    bytes: Buffer;
+    contentType: string;
+    etag: string;
+}
+/**
+ * In-memory LRU cache with memory-aware eviction for image variants.
+ *
+ * Eviction triggers:
+ * - Entry count exceeds maxEntries
+ * - Total memory exceeds maxMemoryBytes
+ * - Entry idle time exceeds TTI
+ *
+ * When evicting, removes the least-recently-accessed entry first.
+ *
+ * Keys follow the pattern `{mediaId}/{preset}/{format}`.
+ * Supports prefix-based invalidation for clearing all variants of a source image.
+ */
+export declare class ImageCache {
+    private readonly cache;
+    private readonly maxEntries;
+    private readonly maxMemoryBytes;
+    private readonly ttiMs;
+    private totalBytes;
+    private cleanupTimer;
+    constructor(settings: ImageCacheSettings);
+    /** Get a cached variant. Returns undefined on miss or expired entry. */
+    get(key: string): CachedVariant | undefined;
+    /** Store a variant in the cache. Evicts entries if at capacity (count or memory). */
+    set(key: string, value: CachedVariant): void;
+    /** Invalidate all cached variants for a media item (prefix match). */
+    invalidateSource(mediaId: string): void;
+    /** Current number of cached entries */
+    get size(): number;
+    /** Total memory used by cached image bytes */
+    get memoryBytes(): number;
+    /** Stop the cleanup timer (for tests / shutdown) */
+    dispose(): void;
+    private removeEntry;
+    private evictLeastRecentlyUsed;
+    private evictExpired;
+}
+//# sourceMappingURL=image-cache.d.ts.map

package/dist/image-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-cache.d.ts","sourceRoot":"","sources":["../src/image-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAA;AAE/D,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb;AAQD;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,YAAY,CAA4C;gBAEpD,QAAQ,EAAE,kBAAkB;IAUxC,wEAAwE;IACxE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAc3C,qFAAqF;IACrF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAqB5C,sEAAsE;IACtE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUvC,uCAAuC;IACvC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8CAA8C;IAC9C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,oDAAoD;IACpD,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,YAAY;CAQrB"}

package/dist/image-cache.js

@@ -0,0 +1,112 @@
+/**
+ * In-memory LRU cache with memory-aware eviction for image variants.
+ *
+ * Eviction triggers:
+ * - Entry count exceeds maxEntries
+ * - Total memory exceeds maxMemoryBytes
+ * - Entry idle time exceeds TTI
+ *
+ * When evicting, removes the least-recently-accessed entry first.
+ *
+ * Keys follow the pattern `{mediaId}/{preset}/{format}`.
+ * Supports prefix-based invalidation for clearing all variants of a source image.
+ */
+export class ImageCache {
+    cache = new Map();
+    maxEntries;
+    maxMemoryBytes;
+    ttiMs;
+    totalBytes = 0;
+    cleanupTimer;
+    constructor(settings) {
+        this.maxEntries = settings.maxEntries;
+        this.maxMemoryBytes = settings.maxMb * 1024 * 1024;
+        this.ttiMs = settings.ttiSec * 1000;
+        // Periodic cleanup every 5 minutes
+        this.cleanupTimer = setInterval(() => this.evictExpired(), 5 * 60 * 1000);
+        if (this.cleanupTimer.unref)
+            this.cleanupTimer.unref();
+    }
+    /** Get a cached variant. Returns undefined on miss or expired entry. */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        const now = Date.now();
+        if (now - entry.lastAccess > this.ttiMs) {
+            this.removeEntry(key, entry);
+            return undefined;
+        }
+        entry.lastAccess = now;
+        return entry.value;
+    }
+    /** Store a variant in the cache. Evicts entries if at capacity (count or memory). */
+    set(key, value) {
+        const sizeBytes = value.bytes.byteLength;
+        // Remove existing entry if updating
+        const existing = this.cache.get(key);
+        if (existing) {
+            this.totalBytes -= existing.sizeBytes;
+        }
+        // Evict until within limits
+        while (this.cache.size >= this.maxEntries ||
+            (this.totalBytes + sizeBytes > this.maxMemoryBytes && this.cache.size > 0)) {
+            this.evictLeastRecentlyUsed();
+        }
+        this.cache.set(key, { value, sizeBytes, lastAccess: Date.now() });
+        this.totalBytes += sizeBytes;
+    }
+    /** Invalidate all cached variants for a media item (prefix match). */
+    invalidateSource(mediaId) {
+        const prefix = `${mediaId}/`;
+        for (const [key, entry] of this.cache) {
+            if (key.startsWith(prefix)) {
+                this.totalBytes -= entry.sizeBytes;
+                this.cache.delete(key);
+            }
+        }
+    }
+    /** Current number of cached entries */
+    get size() {
+        return this.cache.size;
+    }
+    /** Total memory used by cached image bytes */
+    get memoryBytes() {
+        return this.totalBytes;
+    }
+    /** Stop the cleanup timer (for tests / shutdown) */
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    removeEntry(key, entry) {
+        this.totalBytes -= entry.sizeBytes;
+        this.cache.delete(key);
+    }
+    evictLeastRecentlyUsed() {
+        let oldestKey;
+        let oldestEntry;
+        let oldestTime = Number.POSITIVE_INFINITY;
+        for (const [key, entry] of this.cache) {
+            if (entry.lastAccess < oldestTime) {
+                oldestTime = entry.lastAccess;
+                oldestKey = key;
+                oldestEntry = entry;
+            }
+        }
+        if (oldestKey && oldestEntry) {
+            this.removeEntry(oldestKey, oldestEntry);
+        }
+    }
+    evictExpired() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache) {
+            if (now - entry.lastAccess > this.ttiMs) {
+                this.removeEntry(key, entry);
+            }
+        }
+    }
+}
+//# sourceMappingURL=image-cache.js.map

package/dist/image-cache.js.map

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

package/dist/image-dimensions.d.ts

@@ -0,0 +1,12 @@
+/** Detected image dimensions */
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Detect image dimensions from a buffer by reading format-specific headers.
+ * No external dependencies — reads binary headers directly.
+ * Returns null if the format is unrecognized or the buffer is too short.
+ */
+export declare function detectDimensions(data: Uint8Array): ImageDimensions | null;
+//# sourceMappingURL=image-dimensions.d.ts.map

package/dist/image-dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-dimensions.d.ts","sourceRoot":"","sources":["../src/image-dimensions.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI,CAgBzE"}

package/dist/image-dimensions.js

@@ -0,0 +1,129 @@
+/**
+ * Detect image dimensions from a buffer by reading format-specific headers.
+ * No external dependencies — reads binary headers directly.
+ * Returns null if the format is unrecognized or the buffer is too short.
+ */
+export function detectDimensions(data) {
+    if (data.length < 8)
+        return null;
+    // PNG: 8-byte signature + IHDR chunk
+    if (isPng(data))
+        return parsePng(data);
+    // JPEG: scan for SOF marker
+    if (isJpeg(data))
+        return parseJpeg(data);
+    // GIF: logical screen descriptor
+    if (isGif(data))
+        return parseGif(data);
+    // WebP: RIFF container
+    if (isWebP(data))
+        return parseWebP(data);
+    return null;
+}
+function isPng(d) {
+    return d[0] === 0x89 && d[1] === 0x50 && d[2] === 0x4e && d[3] === 0x47;
+}
+function isJpeg(d) {
+    return d[0] === 0xff && d[1] === 0xd8;
+}
+function isGif(d) {
+    return d[0] === 0x47 && d[1] === 0x49 && d[2] === 0x46;
+}
+function isWebP(d) {
+    return (d[0] === 0x52 &&
+        d[1] === 0x49 &&
+        d[2] === 0x46 &&
+        d[3] === 0x46 &&
+        d[8] === 0x57 &&
+        d[9] === 0x45 &&
+        d[10] === 0x42 &&
+        d[11] === 0x50);
+}
+function parsePng(d) {
+    // IHDR starts at offset 16: 4 bytes width, 4 bytes height (big-endian)
+    if (d.length < 24)
+        return null;
+    const view = new DataView(d.buffer, d.byteOffset, d.byteLength);
+    const width = view.getUint32(16);
+    const height = view.getUint32(20);
+    return { width, height };
+}
+function parseJpeg(d) {
+    // Scan for SOF0 (0xFFC0) or SOF2 (0xFFC2) marker
+    let offset = 2;
+    const view = new DataView(d.buffer, d.byteOffset, d.byteLength);
+    while (offset < d.length - 8) {
+        if (d[offset] !== 0xff) {
+            offset++;
+            continue;
+        }
+        const marker = d[offset + 1];
+        if (marker === undefined)
+            break;
+        // SOF0 or SOF2 — contains dimensions
+        if (marker === 0xc0 || marker === 0xc2) {
+            // Skip marker (2) + length (2) + precision (1) = offset+5 for height
+            const height = view.getUint16(offset + 5);
+            const width = view.getUint16(offset + 7);
+            return { width, height };
+        }
+        // Skip this marker segment
+        if (marker === 0xd8 || marker === 0xd9) {
+            // SOI or EOI — no length field
+            offset += 2;
+        }
+        else {
+            const segmentLength = view.getUint16(offset + 2);
+            offset += 2 + segmentLength;
+        }
+    }
+    return null;
+}
+function parseGif(d) {
+    // Logical screen descriptor at offset 6: width (LE 16), height (LE 16)
+    if (d.length < 10)
+        return null;
+    const view = new DataView(d.buffer, d.byteOffset, d.byteLength);
+    const width = view.getUint16(6, true);
+    const height = view.getUint16(8, true);
+    return { width, height };
+}
+function parseWebP(d) {
+    if (d.length < 30)
+        return null;
+    // VP8 (lossy): starts at offset 12 with 'VP8 '
+    if (d[12] === 0x56 && d[13] === 0x50 && d[14] === 0x38 && d[15] === 0x20) {
+        // Frame header at offset 26: width (LE 16), height (LE 16)
+        // Width and height are 14-bit values in the first 4 bytes of the frame
+        if (d.length < 30)
+            return null;
+        const view = new DataView(d.buffer, d.byteOffset, d.byteLength);
+        const width = view.getUint16(26, true) & 0x3fff;
+        const height = view.getUint16(28, true) & 0x3fff;
+        return { width, height };
+    }
+    // VP8L (lossless): starts at offset 12 with 'VP8L'
+    if (d[12] === 0x56 && d[13] === 0x50 && d[14] === 0x38 && d[15] === 0x4c) {
+        // Dimensions encoded in 4 bytes at offset 21
+        if (d.length < 25)
+            return null;
+        const b0 = d[21];
+        const b1 = d[22];
+        const b2 = d[23];
+        const b3 = d[24];
+        const width = 1 + (((b1 & 0x3f) << 8) | b0);
+        const height = 1 + (((b3 & 0x0f) << 10) | (b2 << 2) | ((b1 >> 6) & 0x03));
+        return { width, height };
+    }
+    // VP8X (extended): starts at offset 12 with 'VP8X'
+    if (d[12] === 0x56 && d[13] === 0x50 && d[14] === 0x38 && d[15] === 0x58) {
+        if (d.length < 30)
+            return null;
+        // Canvas width at offset 24 (3 bytes LE + 1), height at offset 27 (3 bytes LE + 1)
+        const width = 1 + (d[24] | (d[25] << 8) | (d[26] << 16));
+        const height = 1 + (d[27] | (d[28] << 8) | (d[29] << 16));
+        return { width, height };
+    }
+    return null;
+}
+//# sourceMappingURL=image-dimensions.js.map

package/dist/image-dimensions.js.map

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