@ubean/preset 0.2.2 → 0.3.0

package/dist/index.d.ts

@@ -1036,8 +1036,36 @@ declare function detectPreset(hints?: PresetDetectionHints): PresetDetectionResu
 declare function resolvePresetWithDetection(explicitPreset?: string, cwd?: string): PresetDetectionResult;
 declare function listDetectablePresets(): PresetDefinition[];
 //#endregion
+//#region src/cache-default.d.ts
+/**
+ * Production HTTP/ISR cache backend selection.
+ *
+ * Node-like runtimes persist to `.ubean/cache` so HIT survives process
+ * restart. Serverless/edge presets stay in-process memory — they must
+ * not pretend a local filesystem is shared across isolates.
+ *
+ * Explicit `{ store: 'memory' | 'fs' }` always wins over `auto`.
+ */
+type CacheStoreKind = 'memory' | 'fs' | 'auto';
+interface CacheStoreConfig {
+  store?: CacheStoreKind;
+  dir?: string;
+}
+interface ResolvedCacheStoreConfig {
+  store: 'memory' | 'fs';
+  dir?: string;
+}
+declare function isEphemeralCachePreset(presetName: string): boolean;
+/**
+ * Resolve the production cache backend for a build preset.
+ *
+ * Dev / `createUbeanApp` still treat `auto` as memory so tests and
+ * local servers do not write a cache directory unless asked.
+ */
+declare function resolveProductionCacheStore(presetName: string, explicit?: CacheStoreConfig): ResolvedCacheStoreConfig;
+//#endregion
 //#region src/index.d.ts
 declare function registerBuiltinPresets(): void;
 declare function resolvePresetByName(name: string): ResolvedPreset;
 //#endregion
-export { type AwsSamResource, type AwsSamTemplate, type BunfigConfig, CapabilityDiagnosisResult, CapabilityDiagnostic, CapabilityInfo, CapabilityName, CapabilityRequirement, CapabilitySet, DEV_REQUIREMENTS, type DenoConfig, NODE_CAPABILITIES, NODE_REQUIREMENTS, type NetlifyConfig, type Preset, type PresetBuildContext, type PresetDefinition, type PresetDetectionHints, type PresetDetectionResult, type PresetDevContext, type PresetHooks, type PresetMeta, type ResolvedPreset, RuntimeTarget, STANDARD_CAPABILITIES, type StaticWebAppConfig, type VercelConfig, WORKER_CAPABILITIES, type WranglerConfig, awsPreset, azurePreset, bunPreset, cloudflareDevPreset, cloudflarePreset, createCapabilitySet, definePreset, denoPreset, detectPreset, diagnoseCapabilities, generateAwsSamConfig, generateBunfigConfig, generateDenoConfig, generateNetlifyConfig, generateStaticWebAppConfig, generateVercelConfig, generateWranglerConfig, getPresetAliases, getPresetNames, getRegisteredPresets, listDetectablePresets, netlifyPreset, nodePreset, registerBuiltinPresets, registerPreset, requireCapability, resolvePreset, resolvePresetByName, resolvePresetWithDetection, serializeAwsSamConfig, serializeBunfigConfig, serializeDenoConfig, serializeNetlifyConfig, serializeStaticWebAppConfig, serializeVercelConfig, serializeWranglerToml, standardPreset, vercelEdgePreset, vercelPreset };
+export { type AwsSamResource, type AwsSamTemplate, type BunfigConfig, type CacheStoreConfig, type CacheStoreKind, CapabilityDiagnosisResult, CapabilityDiagnostic, CapabilityInfo, CapabilityName, CapabilityRequirement, CapabilitySet, DEV_REQUIREMENTS, type DenoConfig, NODE_CAPABILITIES, NODE_REQUIREMENTS, type NetlifyConfig, type Preset, type PresetBuildContext, type PresetDefinition, type PresetDetectionHints, type PresetDetectionResult, type PresetDevContext, type PresetHooks, type PresetMeta, type ResolvedCacheStoreConfig, type ResolvedPreset, RuntimeTarget, STANDARD_CAPABILITIES, type StaticWebAppConfig, type VercelConfig, WORKER_CAPABILITIES, type WranglerConfig, awsPreset, azurePreset, bunPreset, cloudflareDevPreset, cloudflarePreset, createCapabilitySet, definePreset, denoPreset, detectPreset, diagnoseCapabilities, generateAwsSamConfig, generateBunfigConfig, generateDenoConfig, generateNetlifyConfig, generateStaticWebAppConfig, generateVercelConfig, generateWranglerConfig, getPresetAliases, getPresetNames, getRegisteredPresets, isEphemeralCachePreset, listDetectablePresets, netlifyPreset, nodePreset, registerBuiltinPresets, registerPreset, requireCapability, resolvePreset, resolvePresetByName, resolvePresetWithDetection, resolveProductionCacheStore, serializeAwsSamConfig, serializeBunfigConfig, serializeDenoConfig, serializeNetlifyConfig, serializeStaticWebAppConfig, serializeVercelConfig, serializeWranglerToml, standardPreset, vercelEdgePreset, vercelPreset };

package/dist/index.js

@@ -1538,6 +1538,56 @@ function listDetectablePresets() {
 	];
 }
 //#endregion
+//#region src/cache-default.ts
+const DEFAULT_FS_DIR = ".ubean/cache";
+/** Preset names / aliases whose filesystem is ephemeral or not shared. */
+const EPHEMERAL_CACHE_PRESETS = /* @__PURE__ */ new Set([
+	"cloudflare",
+	"cloudflare-pages",
+	"cloudflare-module",
+	"cf",
+	"wrangler",
+	"workers",
+	"cloudflare-dev",
+	"cf-dev",
+	"wrangler-dev",
+	"vercel",
+	"vercel-serverless",
+	"vercel-node",
+	"vercel-edge",
+	"vercel-edge-function",
+	"netlify",
+	"netlify-functions",
+	"netlify-node",
+	"aws",
+	"azure"
+]);
+function isEphemeralCachePreset(presetName) {
+	return EPHEMERAL_CACHE_PRESETS.has(presetName);
+}
+/**
+* Resolve the production cache backend for a build preset.
+*
+* Dev / `createUbeanApp` still treat `auto` as memory so tests and
+* local servers do not write a cache directory unless asked.
+*/
+function resolveProductionCacheStore(presetName, explicit) {
+	const store = explicit?.store ?? "auto";
+	if (store === "fs") return {
+		store: "fs",
+		dir: explicit?.dir || DEFAULT_FS_DIR
+	};
+	if (store === "memory") return explicit?.dir ? {
+		store: "memory",
+		dir: explicit.dir
+	} : { store: "memory" };
+	if (isEphemeralCachePreset(presetName)) return { store: "memory" };
+	return {
+		store: "fs",
+		dir: explicit?.dir || DEFAULT_FS_DIR
+	};
+}
+//#endregion
 //#region src/index.ts
 const builtinPresets = [
 	standardPreset,
@@ -1580,4 +1630,4 @@ function resolvePresetByName(name) {
 	};
 }
 //#endregion
-export { DEV_REQUIREMENTS, NODE_CAPABILITIES, NODE_REQUIREMENTS, STANDARD_CAPABILITIES, WORKER_CAPABILITIES, awsPreset, azurePreset, bunPreset, cloudflareDevPreset, cloudflarePreset, createCapabilitySet, definePreset, denoPreset, detectPreset, diagnoseCapabilities, generateAwsSamConfig, generateBunfigConfig, generateDenoConfig, generateNetlifyConfig, generateStaticWebAppConfig, generateVercelConfig, generateWranglerConfig, getPresetAliases, getPresetNames, getRegisteredPresets, listDetectablePresets, netlifyPreset, nodePreset, registerBuiltinPresets, registerPreset, requireCapability, resolvePreset, resolvePresetByName, resolvePresetWithDetection, serializeAwsSamConfig, serializeBunfigConfig, serializeDenoConfig, serializeNetlifyConfig, serializeStaticWebAppConfig, serializeVercelConfig, serializeWranglerToml, standardPreset, vercelEdgePreset, vercelPreset };
+export { DEV_REQUIREMENTS, NODE_CAPABILITIES, NODE_REQUIREMENTS, STANDARD_CAPABILITIES, WORKER_CAPABILITIES, awsPreset, azurePreset, bunPreset, cloudflareDevPreset, cloudflarePreset, createCapabilitySet, definePreset, denoPreset, detectPreset, diagnoseCapabilities, generateAwsSamConfig, generateBunfigConfig, generateDenoConfig, generateNetlifyConfig, generateStaticWebAppConfig, generateVercelConfig, generateWranglerConfig, getPresetAliases, getPresetNames, getRegisteredPresets, isEphemeralCachePreset, listDetectablePresets, netlifyPreset, nodePreset, registerBuiltinPresets, registerPreset, requireCapability, resolvePreset, resolvePresetByName, resolvePresetWithDetection, resolveProductionCacheStore, serializeAwsSamConfig, serializeBunfigConfig, serializeDenoConfig, serializeNetlifyConfig, serializeStaticWebAppConfig, serializeVercelConfig, serializeWranglerToml, standardPreset, vercelEdgePreset, vercelPreset };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/preset",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Deployment presets for ubean (standard, node, cloudflare, vercel, netlify, bun, deno)",
   "files": [
     "dist"