@voyantjs/hono 0.76.0 → 0.77.0

package/dist/document-download.d.ts

@@ -0,0 +1,30 @@
+export interface DocumentDownloadEnvelope {
+    url: string;
+    expiresAt: string | null;
+    filename: string | null;
+}
+export type DocumentDownloadResolution = {
+    status: "ready";
+    download: DocumentDownloadEnvelope;
+} | {
+    status: "resolver_not_configured";
+} | {
+    status: "not_available";
+};
+export type DocumentDownloadResolverResult = string | {
+    url: string;
+    expiresAt?: string | null;
+    filename?: string | null;
+} | null | undefined;
+export type DocumentDownloadResolver<TBindings = unknown> = (bindings: TBindings, storageKey: string) => Promise<DocumentDownloadResolverResult> | DocumentDownloadResolverResult;
+export interface StoredDocumentReference {
+    storageKey?: string | null;
+    metadata?: unknown;
+    filename?: string | null;
+    name?: string | null;
+}
+export declare function resolveStoredDocumentDownload<TBindings = unknown>(reference: StoredDocumentReference, options: {
+    bindings: TBindings;
+    resolveDocumentDownloadUrl?: DocumentDownloadResolver<TBindings>;
+}): Promise<DocumentDownloadResolution>;
+//# sourceMappingURL=document-download.d.ts.map

package/dist/document-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-download.d.ts","sourceRoot":"","sources":["../src/document-download.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,yBAAyB,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,CAAA;AAE/B,MAAM,MAAM,8BAA8B,GACtC,MAAM,GACN;IACE,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,GACD,IAAI,GACJ,SAAS,CAAA;AAEb,MAAM,MAAM,wBAAwB,CAAC,SAAS,GAAG,OAAO,IAAI,CAC1D,QAAQ,EAAE,SAAS,EACnB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,8BAA8B,CAAC,GAAG,8BAA8B,CAAA;AAE7E,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAwGD,wBAAsB,6BAA6B,CAAC,SAAS,GAAG,OAAO,EACrE,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE;IACP,QAAQ,EAAE,SAAS,CAAA;IACnB,0BAA0B,CAAC,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAA;CACjE,GACA,OAAO,CAAC,0BAA0B,CAAC,CA2BrC"}

package/dist/document-download.js

@@ -0,0 +1,102 @@
+function getMetadataRecord(metadata) {
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+        return null;
+    }
+    return metadata;
+}
+function maybeString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function maybeUrl(value) {
+    const candidate = maybeString(value);
+    return candidate && /^https?:\/\//i.test(candidate) ? candidate : null;
+}
+function maybeIsoString(value) {
+    return maybeString(value);
+}
+function filenameFromStorageKey(storageKey) {
+    const normalized = maybeString(storageKey);
+    if (!normalized) {
+        return null;
+    }
+    return normalized.split("/").filter(Boolean).at(-1) ?? null;
+}
+function getReferenceFilename(reference) {
+    const record = getMetadataRecord(reference.metadata);
+    return (maybeString(reference.filename) ??
+        maybeString(reference.name) ??
+        maybeString(record?.filename) ??
+        maybeString(record?.fileName) ??
+        maybeString(record?.name) ??
+        maybeString(record?.originalName) ??
+        filenameFromStorageKey(reference.storageKey));
+}
+function getMetadataExpiresAt(metadata) {
+    const record = getMetadataRecord(metadata);
+    return maybeIsoString(record?.expiresAt) ?? maybeIsoString(record?.expires_at);
+}
+function getFallbackDownload(reference) {
+    const record = getMetadataRecord(reference.metadata);
+    if (!record) {
+        return null;
+    }
+    const url = maybeUrl(record.url) ?? maybeUrl(record.downloadUrl);
+    if (!url) {
+        return null;
+    }
+    return {
+        url,
+        expiresAt: getMetadataExpiresAt(record),
+        filename: getReferenceFilename(reference),
+    };
+}
+function normalizeResolverDownload(value, reference) {
+    if (typeof value === "string") {
+        const url = maybeUrl(value);
+        if (!url) {
+            return null;
+        }
+        return {
+            url,
+            expiresAt: getMetadataExpiresAt(reference.metadata),
+            filename: getReferenceFilename(reference),
+        };
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const url = maybeUrl(value.url);
+    if (!url) {
+        return null;
+    }
+    return {
+        url,
+        expiresAt: value.expiresAt === undefined
+            ? getMetadataExpiresAt(reference.metadata)
+            : maybeIsoString(value.expiresAt),
+        filename: maybeString(value.filename) ?? getReferenceFilename(reference),
+    };
+}
+export async function resolveStoredDocumentDownload(reference, options) {
+    let needsResolver = false;
+    if (reference.storageKey) {
+        if (!options.resolveDocumentDownloadUrl) {
+            needsResolver = true;
+        }
+        else {
+            const resolved = await options.resolveDocumentDownloadUrl(options.bindings, reference.storageKey);
+            const download = normalizeResolverDownload(resolved, reference);
+            if (download) {
+                return { status: "ready", download };
+            }
+        }
+    }
+    const fallback = getFallbackDownload(reference);
+    if (fallback) {
+        return { status: "ready", download: fallback };
+    }
+    if (needsResolver) {
+        return { status: "resolver_not_configured" };
+    }
+    return { status: "not_available" };
+}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export type { VoyantPermission } from "@voyantjs/core";
 export { createApp } from "./app.js";
 export type { SessionAuthContext } from "./auth/index.js";
 export { extractBearerToken, generateNumericCode, randomBytesHex, requireUserId, sha256Base64Url, sha256Hex, unsignCookie, verifySession, } from "./auth/index.js";
+export type { DocumentDownloadEnvelope, DocumentDownloadResolution, DocumentDownloadResolver, DocumentDownloadResolverResult, StoredDocumentReference, } from "./document-download.js";
+export { resolveStoredDocumentDownload } from "./document-download.js";
 export { consoleLoggerProvider, cors, DEFAULT_IDEMPOTENCY_TTL_MS, db, errorBoundary, handleApiError, type IdempotencyKeyOptions, idempotencyKey, LIVE_LIMITS, logger, purgeExpiredIdempotencyKeys, rateLimit, requestId, requireActor, requireAuth, requirePermission, } from "./middleware/index.js";
 export type { HonoExtension, HonoModule } from "./module.js";
 export type { ExpandedHonoBundles, ExpandedHonoPlugins, HonoBundle, HonoPlugin, } from "./plugin.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,qBAAqB,EACrB,IAAI,EACJ,0BAA0B,EAC1B,EAAE,EACF,aAAa,EACb,cAAc,EACd,KAAK,qBAAqB,EAC1B,cAAc,EACd,WAAW,EACX,MAAM,EACN,2BAA2B,EAC3B,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC5D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EACL,qBAAqB,EACrB,IAAI,EACJ,0BAA0B,EAC1B,EAAE,EACF,aAAa,EACb,cAAc,EACd,KAAK,qBAAqB,EAC1B,cAAc,EACd,WAAW,EACX,MAAM,EACN,2BAA2B,EAC3B,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC5D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { createApp } from "./app.js";
 export { extractBearerToken, generateNumericCode, randomBytesHex, requireUserId, sha256Base64Url, sha256Hex, unsignCookie, verifySession, } from "./auth/index.js";
+export { resolveStoredDocumentDownload } from "./document-download.js";
 export { consoleLoggerProvider, cors, DEFAULT_IDEMPOTENCY_TTL_MS, db, errorBoundary, handleApiError, idempotencyKey, LIVE_LIMITS, logger, purgeExpiredIdempotencyKeys, rateLimit, requestId, requireActor, requireAuth, requirePermission, } from "./middleware/index.js";
 export { defineHonoBundle, defineHonoPlugin, expandHonoBundles, expandHonoPlugins, } from "./plugin.js";
 export { createPublicCapabilityToken, extractPublicCapabilityToken, serializePublicCapabilityCookie, verifyPublicCapabilityToken, } from "./public-capability.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/hono",
-  "version": "0.76.0",
+  "version": "0.77.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -24,6 +24,11 @@
       "import": "./dist/plugin.js",
       "default": "./dist/plugin.js"
     },
+    "./document-download": {
+      "types": "./dist/document-download.d.ts",
+      "import": "./dist/document-download.js",
+      "default": "./dist/document-download.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "import": "./dist/types.js",
@@ -94,18 +99,18 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.76.0",
-    "@voyantjs/db": "0.76.0",
-    "@voyantjs/types": "0.76.0",
-    "@voyantjs/utils": "0.76.0",
-    "@voyantjs/workflows": "0.76.0"
+    "@voyantjs/core": "0.77.0",
+    "@voyantjs/db": "0.77.0",
+    "@voyantjs/types": "0.77.0",
+    "@voyantjs/utils": "0.77.0",
+    "@voyantjs/workflows": "0.77.0"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260426.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "@voyantjs/voyant-typescript-config": "0.1.0",
-    "@voyantjs/workflows-orchestrator": "0.76.0"
+    "@voyantjs/workflows-orchestrator": "0.77.0"
   },
   "files": [
     "dist"